Use and adapt ai-p1
Use and adapt ai-p1: An agency workspace connecting client work, sales, delivery, collaboration, finance, and AI-assisted workflows.
Use the documented interfaces and source layout for ai-p1. The sections below retain the README’s examples and configuration details.
Common commands
| Command | Purpose |
|---|---|
npm run build | Build workspaces that expose a build command |
npm run test | Run workspace test commands |
npm run typecheck | Type-check participating workspaces |
npm run licenses:check | Validate the separate dependency-license inventory |
npm run licenses:project:check | Validate Qentrah licensing, package guards, and asset boundaries |
npm run publication:check | Run the strict release gate; expected to fail until legal approval is recorded |
npm run docs:codebase-map | Regenerate the interface inventory |
npm run docs:codebase-map:check | Confirm the committed interface inventory is current |
npm run brand:assets | Generate Qentrah-branded runtime assets from the canonical brand owner |
npm run assets:public | Generate neutral placeholders for non-brand public media |
Focused Workspace verification:
npm --workspace @qentrah/workspace run typecheck
npm --workspace @qentrah/workspace run test:agency-readiness
npm --workspace @qentrah/workspace run check:convex-runtimeLocal development
Requirements
- Node.js 22 or later
- npm
- Service credentials for the application surface being run
Install the workspace from the repository root:
npm ciCopy only the relevant committed environment examples and provide local values. Do not commit .env files, credentials, production identifiers, or customer data. See setup and configuration for the current environment contract.
Start a product surface:
npm run dev:ws # Workspace web app and Convex development runtime
npm run dev:workspace:desktop # Workspace desktop development shell
npm run dev:marketing # Marketing site on port 3005
npm run dev:mobile # Expo mobile development server
npm run dev:zapier # Zapier integration development serverapps/partners is a retained static surface rather than an executable npm workspace.
Commands in the root manifest
The captured package.json declares the following scripts. Run them from the directory containing that manifest.
| Command | Script |
|---|---|
npm run build | npm run build --workspaces --if-present |
npm run test | npm run test --workspaces --if-present |
npm run typecheck | npm run typecheck --workspaces --if-present |
Troubleshoot a local change
- Reproduce the smallest example from the quick-start guide.
- Compare required configuration and dependency versions with the README.
- Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.
Source and help
Source captured: 2026-10-11