@powerhousedao/ph-clint-cli 0.1.0-dev.4 → 0.1.0-dev.40

package/dist/codegen/builders/app-index-ts.js

@@ -3,29 +3,25 @@
  * reactor package. Impl code imports from `'{name}-app'` instead of drilling
  * into `'{name}-app/document-models/<slug>/v1/gen/...'`.
  *
- * Each entry re-exports a document-model subfolder's `index.ts`, which in
- * turn re-exports the module object (`PhClintProject`, ...), action creators,
- * document/state types, and type guards. Fully machine-owned: regen on every
- * run.
- *
- * Powerhouse's own codegen might emit its own `index.ts` (as is the case for
- * ph-clint-app today, which has manifest/editors/processors re-exports). When
- * that exists, leave it alone — users hand-merge. Our codegen only emits when
- * the file is absent or was emitted by a previous ph-clint-cli run (hash
- * matches the ledger).
+ * Only re-exports document types belonging to the app package (the project's
+ * own reactor package). External packages' document types are imported from
+ * their own npm packages, not from the app barrel.
  */
-import { getDocumentTypeSlug, } from '../../spec/types.js';
+import { getAppPackageName, getDocumentTypeSlug, phAtLeast, } from '../../spec/types.js';
 export function buildAppIndexTs(spec) {
-    if (!spec.features.powerhouse.enabled)
+    if (!phAtLeast(spec.features.powerhouse, 'Reactor'))
         return null;
-    if (spec.documentTypes.length === 0)
+    const appPkg = getAppPackageName(spec);
+    const appEntry = spec.packages.find((p) => p.packageName === appPkg);
+    const docTypes = appEntry?.documentTypes ?? [];
+    if (docTypes.length === 0)
         return null;
     const lines = [];
     lines.push('// THIS FILE IS GENERATED BY ph-clint-cli.');
     lines.push('// Re-exports every registered document model from a single top-level');
     lines.push('// entry so impl code can `import { ... } from \'{name}-app\'`.');
     lines.push('');
-    for (const docType of spec.documentTypes) {
+    for (const docType of docTypes) {
         const slug = getDocumentTypeSlug(docType);
         lines.push(`export * from './document-models/${slug}/index.js';`);
     }

package/dist/codegen/builders/cli-package-json.js

@@ -4,13 +4,44 @@
  * When `features.powerhouse.enabled`, this file lives at
  * `{root}/{name}-cli/package.json`. Otherwise at `{root}/package.json`.
  */
-import { getBinName, getPackageName, } from '../../spec/types.js';
-/** Pinned version range for peer ph-clint packages emitted into generated projects. */
-const PH_CLINT_VERSION = '^0.1.0';
+import { getAppDirName, getAppPackageName, getBinName, getPackageName, phAtLeast, } from '../../spec/types.js';
+import { CLI_VERSION } from '../../config.js';
+/**
+ * Derive a semver range from the running ph-clint-cli version that respects
+ * the dev / staging / production channel boundary. This is the version range
+ * emitted into *scaffolded* projects' package.json for @powerhousedao/ph-clint
+ * and @powerhousedao/ph-clint-dev dependencies.
+ *
+ * CLI_VERSION is the version of ph-clint-cli itself (read from its own
+ * package.json at startup). Since all framework packages share a lockstep
+ * version, this is also the correct base for the dependency range.
+ *
+ * Examples:
+ *   "0.1.0"            → "^0.1.0"            (production — stable only)
+ *   "0.1.0-staging.2"  → "^0.1.0-staging.0"  (staging + stable)
+ *   "0.1.0-dev.4"      → "^0.1.0-dev.0"      (dev + staging + stable)
+ *
+ * This works because semver orders prereleases alphabetically:
+ * dev.N < staging.N < release. A caret range starting at dev.0 naturally
+ * upgrades through staging to production.
+ */
+function phClintRange(version) {
+    const match = /^(\d+\.\d+\.\d+)(?:-([a-z]+)\.\d+)?/.exec(version);
+    if (!match)
+        return `^${version}`;
+    const base = match[1];
+    const channel = match[2]; // "dev", "staging", or undefined
+    // For prerelease channels, pin exact version. Caret ranges like ^0.1.0-dev.0
+    // resolve to `latest` dist-tag (0.1.0-dev.0) instead of the highest match,
+    // causing "export not found" errors when the scaffolding CLI is newer.
+    return channel ? version : `^${base}`;
+}
+/** Version range for @powerhousedao/ph-clint{,-dev} deps in scaffolded projects. */
+const PH_CLINT_VERSION = phClintRange(CLI_VERSION);
 const POWERHOUSE_VERSION = '6.0.0-dev.170';
 export function buildCliPackageJson(spec) {
     const { mastra, powerhouse } = spec.features;
-    const pkgName = powerhouse.enabled
+    const pkgName = phAtLeast(powerhouse, 'Reactor')
         ? `${getPackageName(spec)}-cli`
         : getPackageName(spec);
     const bin = getBinName(spec);
@@ -21,18 +52,32 @@ export function buildCliPackageJson(spec) {
     if (mastra.enabled) {
         dependencies['@mastra/core'] = '^1.22.0';
         dependencies['@mastra/libsql'] = '^1.7.4';
+        dependencies['@mastra/mcp'] = '^1.4.1';
         dependencies['@mastra/memory'] = '^1.13.1';
     }
-    if (powerhouse.enabled) {
-        dependencies[`${spec.name}-app`] = `file:../${spec.name}-app`;
+    if (phAtLeast(powerhouse, 'Reactor')) {
+        const appPkg = getAppPackageName(spec);
+        const appDir = getAppDirName(spec);
+        dependencies[appPkg] = `file:../${appDir}`;
         dependencies['@powerhousedao/reactor'] = POWERHOUSE_VERSION;
         dependencies['@powerhousedao/reactor-api'] = POWERHOUSE_VERSION;
         dependencies['@powerhousedao/shared'] = POWERHOUSE_VERSION;
         dependencies['document-model'] = POWERHOUSE_VERSION;
+        // External reactor packages (non-app) as versioned dependencies.
+        // Compare bare names (without scope) so that a spec entry with
+        // packageName "foo-app" still matches the scoped "@scope/foo-app".
+        const appBare = appPkg.replace(/^@[^/]+\//, '');
+        for (const pkg of spec.packages) {
+            const pkgBare = pkg.packageName.replace(/^@[^/]+\//, '');
+            if (pkgBare === appBare)
+                continue;
+            dependencies[pkg.packageName] = 'latest';
+        }
     }
     const scripts = {
         'build:skills': 'tsx scripts/build-skills.ts',
-        build: 'pnpm build:skills && tsc',
+        'build:manifest': 'build-manifest',
+        build: 'pnpm build:skills && tsc && pnpm build:manifest',
         dev: 'tsx src/main.ts',
         start: 'node dist/main.js',
         test: "NODE_OPTIONS='--experimental-vm-modules' jest --detectOpenHandles",
@@ -43,15 +88,26 @@ export function buildCliPackageJson(spec) {
         scripts['mastra:build'] = 'mastra build';
         scripts['mastra:start'] = 'mastra start';
     }
+    // Single-layout: publish scripts live in the CLI package.json (which IS the
+    // root). Split-layout gets these from root-package-json.ts instead.
+    if (!phAtLeast(powerhouse, 'Reactor')) {
+        scripts['publish:dev'] = 'ph-publish dev -c ./publish.config.js';
+        scripts['publish:staging'] = 'ph-publish staging -c ./publish.config.js';
+        scripts['publish:production'] = 'ph-publish production -c ./publish.config.js';
+    }
+    if (spec.deployment.serviceAnnouncement) {
+        scripts['test-service-registry'] = 'json-post-registry --withAuth';
+    }
     const pkg = {
         name: pkgName,
         version: spec.version,
-        private: true,
+        publishConfig: { access: 'public' },
         type: 'module',
     };
     if (spec.description)
         pkg.description = spec.description;
     pkg.bin = { [bin]: './dist/main.js' };
+    pkg.files = ['dist'];
     pkg.scripts = scripts;
     pkg.dependencies = dependencies;
     pkg.devDependencies = {
@@ -62,6 +118,7 @@ export function buildCliPackageJson(spec) {
         'ts-jest': '^29.4.6',
         tsx: '^4.19.0',
         typescript: '^6.0.2',
+        'typescript-eslint': '^8.33.0',
     };
     pkg.engines = { node: '>=22.13.0' };
     return JSON.stringify(pkg, null, 2) + '\n';

package/dist/codegen/builders/cli-ts.js

@@ -1,5 +1,12 @@
+/**
+ * Builds `src/cli.ts` — the defineCli() call with feature blocks guarded by
+ * `@clint:begin`/`@clint:end` markers so the code generator can patch
+ * specific regions on subsequent runs (delta mode — future phase).
+ */
+import { getAppPackageName, phAtLeast } from '../../spec/types.js';
 export function buildCliTs(spec) {
     const { mastra, routine, powerhouse } = spec.features;
+    const ph = powerhouse;
     const lines = [];
     lines.push('/**');
     lines.push(' * CLI definition.');
@@ -8,34 +15,33 @@ export function buildCliTs(spec) {
     lines.push(' * markers are rewritten by ph-clint when the project spec changes.');
     lines.push(' * Everything outside the markers is user-editable and preserved.');
     lines.push(' */');
-    if (powerhouse.enabled) {
-        lines.push(`import path from 'node:path';`);
-        lines.push(`import { fileURLToPath } from 'node:url';`);
-        lines.push(`import { defineCli, buildDefaultReactor } from '@powerhousedao/ph-clint';`);
-    }
-    else {
-        lines.push(`import { defineCli } from '@powerhousedao/ph-clint';`);
+    const needsRoot = phAtLeast(ph, 'Reactor') || mastra.enabled;
+    lines.push('// @clint:begin imports');
+    const phClintImports = ['defineCli'];
+    if (phAtLeast(ph, 'Reactor'))
+        phClintImports.push('buildDefaultReactor');
+    if (spec.deployment.serviceAnnouncement)
+        phClintImports.push('jsonPostAnnounce');
+    lines.push(`import { ${phClintImports.join(', ')} } from '@powerhousedao/ph-clint';`);
+    if (needsRoot) {
+        lines.push("import path from 'node:path';");
     }
-    lines.push(`import { CLI_NAME, CLI_VERSION } from './config.js';`);
+    lines.push(`import { CLI_NAME, CLI_VERSION${needsRoot ? ', CLI_ROOT' : ''} } from './config.js';`);
     lines.push(`import { configSchema, secretsSchema } from './framework.js';`);
-    lines.push('');
-    lines.push('// @clint:begin imports');
-    if (powerhouse.enabled) {
-        lines.push(`import { documentModels } from '${spec.name}-app';`);
+    if (phAtLeast(ph, 'Reactor')) {
+        lines.push(`import { documentModels } from '${getAppPackageName(spec)}';`);
     }
     if (mastra.enabled) {
         lines.push(`import { createAgent } from './agents/agent.js';`);
     }
     lines.push('// @clint:end imports');
     lines.push('');
-    if (powerhouse.enabled) {
-        lines.push(`const __dirname = path.dirname(fileURLToPath(import.meta.url));`);
-        lines.push(`const appDir = path.resolve(__dirname, '../../${spec.name}-app');`);
-        lines.push('');
-    }
     lines.push('export const cli = defineCli({');
     lines.push('  name: CLI_NAME,');
     lines.push('  version: CLI_VERSION,');
+    if (phAtLeast(ph, 'Reactor')) {
+        lines.push('  root: CLI_ROOT,');
+    }
     lines.push('  description: `${CLI_NAME} v${CLI_VERSION}`,');
     lines.push('  configSchema,');
     lines.push('  secretsSchema,');
@@ -59,8 +65,34 @@ export function buildCliTs(spec) {
     lines.push('');
     lines.push('  // @clint:begin prompts');
     lines.push('  prompts: {');
-    lines.push('    sources: [],');
-    lines.push('    agents: {},');
+    if (mastra.enabled) {
+        lines.push("    artifacts: [path.join(CLI_ROOT, 'gen', 'skills'), path.join(CLI_ROOT, 'dist', 'gen', 'skills')],");
+    }
+    else {
+        lines.push('    artifacts: [],');
+    }
+    if (mastra.enabled && mastra.agentId) {
+        lines.push('    agents: {');
+        lines.push(`      '${mastra.agentId}': {`);
+        if (mastra.profiles.length > 0) {
+            lines.push(`        name: '${mastra.profiles[0].id}',`);
+            lines.push('        sections: [');
+            for (const p of mastra.profiles) {
+                lines.push(`          '${p.id}.md',`);
+            }
+            lines.push('        ],');
+        }
+        else {
+            lines.push("        name: 'AgentBase',");
+            lines.push("        sections: ['AgentBase.md'],");
+        }
+        lines.push('        skills: [],');
+        lines.push('      },');
+        lines.push('    },');
+    }
+    else {
+        lines.push('    agents: {},');
+    }
     lines.push('    skills: {},');
     lines.push('  },');
     lines.push('  // @clint:end prompts');
@@ -69,6 +101,15 @@ export function buildCliTs(spec) {
     lines.push('  events: {},');
     lines.push('  // @clint:end events');
     lines.push('');
+    lines.push('  // @clint:begin serviceAnnouncement');
+    if (spec.deployment.serviceAnnouncement) {
+        lines.push('  serviceAnnouncement: {');
+        lines.push('    enabled: true,');
+        lines.push('    announce: (payload, ctx) => jsonPostAnnounce(payload, ctx),');
+        lines.push('  },');
+    }
+    lines.push('  // @clint:end serviceAnnouncement');
+    lines.push('');
     lines.push('  // @clint:begin interactive');
     lines.push('  interactive: {');
     lines.push(`    welcome: ({ workdir }) =>`);
@@ -77,10 +118,10 @@ export function buildCliTs(spec) {
     lines.push('        `Workdir: ${workdir}`,');
     lines.push("        '',");
     if (mastra.enabled) {
-        lines.push("        'Type a message to talk to the agent, or /help for commands.',");
+        lines.push("        'Type a message to talk to the agent, or / for commands.',");
     }
     else {
-        lines.push("        'Type /help for commands.',");
+        lines.push("        'Type / for commands or /cli-docs for help.',");
     }
     lines.push("      ].join('\\n'),");
     lines.push('  },');
@@ -88,15 +129,15 @@ export function buildCliTs(spec) {
     lines.push('});');
     lines.push('');
     lines.push('// @clint:begin reactor');
-    if (powerhouse.enabled) {
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push('cli.configureReactor({');
         lines.push('  create: (ctx) =>');
         lines.push('    buildDefaultReactor(ctx, {');
         lines.push('      documentModels,');
         lines.push(`      drive: { name: '${spec.name}' },`);
         lines.push('    }),');
-        lines.push(`  switchboard: { enabled: ${String(powerhouse.switchboard)} },`);
-        lines.push(`  connect: { enabled: ${String(powerhouse.connect)}, workdir: appDir },`);
+        lines.push(`  switchboard: { enabled: ${String(phAtLeast(ph, 'Switchboard'))} },`);
+        lines.push(`  connect: { enabled: ${String(phAtLeast(ph, 'Connect'))} },`);
         lines.push('});');
     }
     lines.push('// @clint:end reactor');

package/dist/codegen/builders/config-ts.js

@@ -1,21 +1,17 @@
-/**
- * Builds `src/config.ts` — CLI identity constants (name, version, project
- * root path). The Zod `configSchema` / `secretsSchema` are emitted by
- * `buildFrameworkTs` into `src/framework.ts` (user-owned, init-only) so users
- * can extend them without fighting the generator.
- */
-import { getBinName, } from '../../spec/types.js';
 export function buildConfigTs(spec) {
-    const cliName = getBinName(spec);
+    const hasCustomBin = !!spec.bin;
     const lines = [];
-    lines.push(`import path from 'node:path';`);
-    lines.push(`import { fileURLToPath } from 'node:url';`);
+    lines.push(`import { readPackageInfo } from '@powerhousedao/ph-clint';`);
     lines.push('');
-    lines.push('/** CLI name — used for config resolution, env var prefixing, and .ph/ paths. */');
-    lines.push(`export const CLI_NAME = '${cliName}';`);
-    lines.push(`export const CLI_VERSION = '${spec.version}';`);
+    lines.push('const pkg = readPackageInfo(import.meta.url);');
     lines.push('');
-    lines.push('/** Project root — resolved from this file location. */');
-    lines.push('export const PROJECT_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), \'..\');');
+    lines.push('export const CLI_ROOT = pkg.root;');
+    if (hasCustomBin) {
+        lines.push(`export const CLI_NAME = '${spec.bin}';`);
+    }
+    else {
+        lines.push(`export const CLI_NAME = pkg.name.replace(/-cli$/, '');`);
+    }
+    lines.push('export const CLI_VERSION = pkg.version;');
     return lines.join('\n') + '\n';
 }

package/dist/codegen/builders/demo-agent-ts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Builds `src/agents/demo-agent.ts` — a deterministic echo agent fallback.
+ *
+ * Generated when `features.mastra.enabled` with full agent config so the real
+ * agent factory can fall back to demo mode when no API key is configured.
+ */
+import { type ClintProjectSpec } from '../../spec/types.js';
+export declare function buildDemoAgentTs(spec: ClintProjectSpec): string | null;

package/dist/codegen/builders/demo-agent-ts.js

@@ -0,0 +1,44 @@
+export function buildDemoAgentTs(spec) {
+    const { mastra } = spec.features;
+    // Only needed alongside the real agent (which imports it)
+    if (!mastra.enabled || !mastra.agentId || mastra.models.length === 0)
+        return null;
+    const agentId = mastra.agentId;
+    return [
+        "import type { AgentProvider, StreamChunk } from '@powerhousedao/ph-clint';",
+        '',
+        '/**',
+        ' * Demo agent — deterministic echo responses without an API key.',
+        ' *',
+        ' * Echoes user prompts with conversation tracking per thread.',
+        ' */',
+        'export function createDemoAgent(): AgentProvider {',
+        '  const conversations = new Map<string, string[]>();',
+        '',
+        '  return {',
+        `    id: '${agentId}',`,
+        '    async *stream(prompt, opts) {',
+        "      const threadId = opts?.threadId ?? 'default';",
+        '      if (!conversations.has(threadId)) {',
+        '        conversations.set(threadId, []);',
+        '      }',
+        '      const history = conversations.get(threadId)!;',
+        '      history.push(prompt);',
+        '',
+        '      const turnCount = history.length;',
+        '      if (turnCount > 1) {',
+        '        yield {',
+        "          type: 'text-delta',",
+        '          text: `I understand you\'re continuing our conversation (turn ${turnCount}). `,',
+        '        } satisfies StreamChunk;',
+        '      }',
+        '      yield {',
+        "        type: 'text-delta',",
+        '        text: `You said: "${prompt}". I\'m the demo agent — set an API key for real LLM responses.`,',
+        '      } satisfies StreamChunk;',
+        '    },',
+        '  };',
+        '}',
+        '',
+    ].join('\n');
+}

package/dist/codegen/builders/eslint-config-js.d.ts

@@ -1,4 +1,4 @@
 /**
- * Builds `eslint.config.js` for the CLI — placeholder flat config.
+ * Builds `eslint.config.js` for the CLI — minimal TypeScript-ESLint config.
  */
 export declare function buildEslintConfigJs(): string;

package/dist/codegen/builders/eslint-config-js.js

@@ -1,12 +1,15 @@
 /**
- * Builds `eslint.config.js` for the CLI — placeholder flat config.
+ * Builds `eslint.config.js` for the CLI — minimal TypeScript-ESLint config.
  */
 export function buildEslintConfigJs() {
     return [
         '// @clint:begin eslint',
-        '// Placeholder ESLint flat config — replaced by codegen when the',
-        "// project's lint stack is configured.",
-        'export default [];',
+        "import tseslint from 'typescript-eslint';",
+        '',
+        'export default tseslint.config(',
+        '  tseslint.configs.recommended,',
+        "  { ignores: ['dist/', 'gen/', 'coverage/'] },",
+        ');',
         '// @clint:end eslint',
         '',
     ].join('\n');

package/dist/codegen/builders/framework-gen-ts.d.ts

@@ -4,14 +4,13 @@
  * `defineRegistry([...] as const)` call that describes which document models
  * are bound into `framework.ts`'s typed factories.
  *
- * Kept deliberately small: this file exports only `registry` and the
- * `Registry` type. The `createTypes` call lives in `framework.ts` (the
- * user-owned half) so `configSchema` edits stay local and we avoid an import
- * cycle between the two files.
+ * Iterates all packages' document types. The app package's modules are
+ * imported from the local `{name}-app` package; external packages' modules
+ * are imported from their npm package name.
  *
  * Emitted only when Powerhouse is enabled — flat-layout impls have no
  * reactor package to import modules from and bind `createTypes` directly in
- * `framework.ts`. When Powerhouse is on but no `documentTypes` are declared,
+ * `framework.ts`. When Powerhouse is on but no document types are declared,
  * we still emit this file with an empty `defineRegistry([])` so impl code's
  * `import { registry } from './framework.gen.js'` keeps resolving across
  * regens.

package/dist/codegen/builders/framework-gen-ts.js

@@ -4,31 +4,34 @@
  * `defineRegistry([...] as const)` call that describes which document models
  * are bound into `framework.ts`'s typed factories.
  *
- * Kept deliberately small: this file exports only `registry` and the
- * `Registry` type. The `createTypes` call lives in `framework.ts` (the
- * user-owned half) so `configSchema` edits stay local and we avoid an import
- * cycle between the two files.
+ * Iterates all packages' document types. The app package's modules are
+ * imported from the local `{name}-app` package; external packages' modules
+ * are imported from their npm package name.
  *
  * Emitted only when Powerhouse is enabled — flat-layout impls have no
  * reactor package to import modules from and bind `createTypes` directly in
- * `framework.ts`. When Powerhouse is on but no `documentTypes` are declared,
+ * `framework.ts`. When Powerhouse is on but no document types are declared,
  * we still emit this file with an empty `defineRegistry([])` so impl code's
  * `import { registry } from './framework.gen.js'` keeps resolving across
  * regens.
  */
-import { getDocumentTypeModuleName, } from '../../spec/types.js';
-/** Local package name of the reactor package for this project. */
-function appPackageName(spec) {
-    return `${spec.name}-app`;
-}
+import { getAppPackageName, getDocumentTypeModuleName, phAtLeast, } from '../../spec/types.js';
 export function buildFrameworkGenTs(spec) {
-    if (!spec.features.powerhouse.enabled)
+    if (!phAtLeast(spec.features.powerhouse, 'Reactor'))
         return null;
-    const pkg = appPackageName(spec);
-    const entries = spec.documentTypes.map((docType) => ({
-        docType,
-        name: getDocumentTypeModuleName(docType),
-    }));
+    const appPkg = getAppPackageName(spec);
+    // Collect all (docType, moduleName, importFrom) tuples across packages.
+    const entries = [];
+    for (const pkg of spec.packages) {
+        const importFrom = pkg.packageName === appPkg ? appPkg : pkg.packageName;
+        for (const docType of pkg.documentTypes) {
+            entries.push({
+                docType,
+                name: getDocumentTypeModuleName(docType),
+                importFrom,
+            });
+        }
+    }
     const lines = [];
     lines.push('/**');
     lines.push(' * THIS FILE IS GENERATED BY ph-clint-cli. DO NOT EDIT.');
@@ -39,12 +42,12 @@ export function buildFrameworkGenTs(spec) {
     lines.push(' */');
     lines.push(`import { defineRegistry } from '@powerhousedao/ph-clint';`);
     for (const e of entries) {
-        lines.push(`import { ${e.name} } from '${pkg}';`);
+        lines.push(`import { ${e.name} } from '${e.importFrom}';`);
     }
     lines.push('');
     lines.push('/**');
     lines.push(' * Typed document registry derived from the reactor package\'s document models.');
-    lines.push(' * Regenerated whenever the spec\'s `documentTypes` list changes.');
+    lines.push(' * Regenerated whenever the spec\'s packages or document types change.');
     lines.push(' */');
     if (entries.length === 0) {
         lines.push('export const registry = defineRegistry([] as const);');

package/dist/codegen/builders/framework-ts.js

@@ -1,6 +1,26 @@
+/**
+ * Builds `src/framework.ts` — the user-owned half of the typed-binding split.
+ *
+ * Emitted **only on create**. Once the file exists, codegen never overwrites
+ * it: users are expected to extend `configSchema` and `secretsSchema` here,
+ * and those edits must survive regens.
+ *
+ * Behavior differs by layout:
+ *
+ * - **Powerhouse enabled** — this file declares `configSchema`/`secretsSchema`
+ *   and re-exports `registry`, `defineCommand`, `defineTrigger`,
+ *   `defineService`, and `createDocumentChangeTrigger` from the companion
+ *   `framework.gen.ts`. Adding a document type to the spec regenerates
+ *   `framework.gen.ts`; this file keeps resolving its re-exports unchanged.
+ *
+ * - **Powerhouse disabled** — no reactor package exists to register modules
+ *   against, so this file binds `createTypes({ configSchema })` directly and
+ *   exports the typed factories from here. No `framework.gen.ts` is emitted.
+ */
+import { phAtLeast } from '../../spec/types.js';
 export function buildFrameworkTs(spec) {
     const { mastra, powerhouse } = spec.features;
-    const hasGen = powerhouse.enabled;
+    const hasGen = phAtLeast(powerhouse, 'Reactor');
     const lines = [];
     lines.push('/**');
     lines.push(' * Per-CLI typed framework binding.');
@@ -22,24 +42,30 @@ export function buildFrameworkTs(spec) {
     }
     lines.push('');
     lines.push('export const configSchema = z.object({');
+    lines.push('  // @clint:begin framework-config');
     if (mastra.enabled) {
-        lines.push("  model: z.string().default('anthropic/claude-haiku-4-5').describe('LLM model to use'),");
+        const defaultModel = mastra.models.find(m => m.isDefault)?.id ?? 'anthropic/claude-sonnet-4-5';
+        lines.push(`  model: z.string().default('${defaultModel}').describe('LLM model to use'),`, `  agentLogging: z.boolean().default(false).describe('Enable agent conversation logging'),`);
     }
-    // Ports are derived from CLI name by resolveReactorDefaults() — no config fields needed.
-    // Override via switchboard.port / connect.port in configureReactor() if required.
-    lines.push('  // Add your own config fields here — this file survives regens.');
+    lines.push('  // @clint:end framework-config');
     lines.push('});');
     lines.push('');
     lines.push('export const secretsSchema = z.object({');
+    lines.push('  // @clint:begin framework-secrets');
     if (mastra.enabled) {
-        lines.push("  apiKey: z.string().optional().describe('LLM API key'),");
+        const providers = [...new Set(mastra.models.map(m => m.id.split(/[:/]/)[0]))];
+        for (const provider of providers) {
+            const field = `${provider}ApiKey`;
+            lines.push(`  ${field}: z.string().optional().describe('${provider} API key'),`);
+        }
     }
+    lines.push('  // @clint:end framework-secrets');
     lines.push('});');
     lines.push('');
     lines.push('export type Config = z.infer<typeof configSchema> &');
     lines.push('  z.infer<typeof secretsSchema>;');
     lines.push('');
-    lines.push('const fullConfigSchema = configSchema.merge(secretsSchema);');
+    lines.push('const fullConfigSchema = configSchema.extend(secretsSchema.shape);');
     lines.push('');
     if (hasGen) {
         lines.push('export const {');

package/dist/codegen/builders/index.d.ts

@@ -17,8 +17,11 @@ import { buildMastraIndexTs } from './mastra-index-ts.js';
 import { buildBuildSkillsScript } from './build-skills-ts.js';
 import { buildAgentBaseMd } from './agent-base-md.js';
 import { buildAgentTs } from './agent-ts.js';
+import { buildDemoAgentTs } from './demo-agent-ts.js';
 import { buildFrameworkGenTs } from './framework-gen-ts.js';
 import { buildFrameworkTs } from './framework-ts.js';
+import { buildManifestJson } from './manifest-json.js';
+import { buildSmokeTestTs } from './smoke-test-ts.js';
 import { type ClintProjectSpec } from '../../spec/types.js';
 /**
  * A spec-driven file builder. Returns `null` from `build` to indicate the
@@ -36,8 +39,14 @@ export interface FileBuilder {
      */
     initOnly?: boolean;
 }
+/**
+ * Generate dynamic file builders for agent profile markdown files.
+ * One file per profile in `prompts/agent-profiles/{id}.md`.
+ */
+export declare function getProfileFileBuilders(spec: ClintProjectSpec): FileBuilder[];
 export declare const CLI_FILE_BUILDERS: FileBuilder[];
-export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildFrameworkGenTs, buildFrameworkTs, };
+export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildDemoAgentTs, buildFrameworkGenTs, buildFrameworkTs, buildManifestJson, buildSmokeTestTs, };
 export { buildRootPackageJson } from './root-package-json.js';
+export { buildPublishConfigJs } from './publish-config-js.js';
 export { buildReadme } from './readme-md.js';
 export { buildAppIndexTs } from './app-index-ts.js';