@powerhousedao/ph-clint-cli 0.1.0-dev.3 → 0.1.0-dev.30

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

@@ -4,47 +4,50 @@
  * `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.');
     lines.push(' *');
-    lines.push(' * Regenerated on every `ph-clint regen` and on every spec-change');
+    lines.push(' * Regenerated on every `ph-clint clint-project-regen` and on every spec-change');
     lines.push(' * tick. Put custom bindings in `framework.ts`, not here — edits to');
     lines.push(' * this file will be overwritten.');
     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,10 @@ 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 { type ClintProjectSpec } from '../../spec/types.js';
 /**
  * A spec-driven file builder. Returns `null` from `build` to indicate the
@@ -36,8 +38,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, };
 export { buildRootPackageJson } from './root-package-json.js';
+export { buildPublishConfigTs } from './publish-config-ts.js';
 export { buildReadme } from './readme-md.js';
 export { buildAppIndexTs } from './app-index-ts.js';

package/dist/codegen/builders/index.js

@@ -17,9 +17,25 @@ 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';
+/**
+ * Generate dynamic file builders for agent profile markdown files.
+ * One file per profile in `prompts/agent-profiles/{id}.md`.
+ */
+export function getProfileFileBuilders(spec) {
+    const { mastra } = spec.features;
+    if (!mastra.enabled || mastra.profiles.length === 0)
+        return [];
+    return mastra.profiles.map((profile) => ({
+        relativePath: `prompts/agent-profiles/${profile.id}.md`,
+        build: () => profile.content + '\n',
+    }));
+}
 export const CLI_FILE_BUILDERS = [
+    { relativePath: 'powerhouse.manifest.json', build: buildManifestJson },
     { relativePath: 'package.json', build: buildCliPackageJson },
     { relativePath: 'tsconfig.json', build: () => buildTsconfigJson() },
     { relativePath: 'jest.config.js', build: () => buildJestConfigJs() },
@@ -28,17 +44,24 @@ export const CLI_FILE_BUILDERS = [
     { relativePath: 'src/main.ts', build: () => buildMainTs() },
     { relativePath: 'src/cli.ts', build: buildCliTs },
     { relativePath: 'src/config.ts', build: buildConfigTs },
-    // User-owned; init-only. Holds `configSchema` + `secretsSchema` edits.
-    { relativePath: 'src/framework.ts', build: buildFrameworkTs, initOnly: true },
+    // User-owned outside markers; generated config/secrets inside markers.
+    { relativePath: 'src/framework.ts', build: buildFrameworkTs },
     // Machine-owned; regenerated on every run. Null when no document types.
     { relativePath: 'src/framework.gen.ts', build: buildFrameworkGenTs },
     { relativePath: 'src/mastra/index.ts', build: buildMastraIndexTs },
     { relativePath: 'scripts/build-skills.ts', build: () => buildBuildSkillsScript() },
-    { relativePath: 'prompts/agent-profiles/AgentBase.md', build: buildAgentBaseMd },
+    {
+        relativePath: 'prompts/agent-profiles/AgentBase.md',
+        build: (spec) => (spec.features.mastra.profiles.length > 0 ? null : buildAgentBaseMd(spec)),
+    },
     {
         relativePath: 'src/agents/agent.ts',
         build: (spec) => (spec.features.mastra.enabled ? buildAgentTs(spec) : null),
     },
+    {
+        relativePath: 'src/agents/demo-agent.ts',
+        build: buildDemoAgentTs,
+    },
     // Gitkeep placeholders so directories are tracked in git when otherwise empty.
     { relativePath: 'src/commands/.gitkeep', build: () => '' },
     { relativePath: 'src/services/.gitkeep', build: () => '' },
@@ -54,7 +77,8 @@ export const CLI_FILE_BUILDERS = [
     { relativePath: 'prompts/skills-ext/.gitkeep', build: () => '' },
     { relativePath: 'tests/.gitkeep', build: () => '' },
 ];
-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, };
 export { buildRootPackageJson } from './root-package-json.js';
+export { buildPublishConfigTs } from './publish-config-ts.js';
 export { buildReadme } from './readme-md.js';
 export { buildAppIndexTs } from './app-index-ts.js';

package/dist/codegen/builders/manifest-json.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds `powerhouse.manifest.json` — a machine-readable manifest describing
+ * the CLI project's capabilities for service discovery and deployment.
+ */
+import { type ClintProjectSpec } from '../../spec/types.js';
+export declare function buildManifestJson(spec: ClintProjectSpec): string;

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

@@ -0,0 +1,31 @@
+/**
+ * Builds `powerhouse.manifest.json` — a machine-readable manifest describing
+ * the CLI project's capabilities for service discovery and deployment.
+ */
+import { getBinName, getAppPackageName, phAtLeast, } from '../../spec/types.js';
+export function buildManifestJson(spec) {
+    const { mastra, powerhouse } = spec.features;
+    const agent = mastra.enabled
+        ? {
+            id: mastra.agentId ?? spec.name,
+            name: mastra.agentName ?? spec.name,
+            description: mastra.agentDescription ?? null,
+            image: mastra.agentImage ?? null,
+            models: mastra.models.map((m) => ({ id: m.id, default: m.isDefault })),
+        }
+        : false;
+    const ph = phAtLeast(powerhouse, 'Reactor')
+        ? {
+            support: powerhouse,
+            package: getAppPackageName(spec),
+        }
+        : false;
+    const manifest = {
+        type: 'clint-project',
+        features: { agent, powerhouse: ph },
+        serviceCommand: getBinName(spec),
+        serviceAnnouncement: spec.deployment.serviceAnnouncement,
+        supportedResources: spec.deployment.supportedResources,
+    };
+    return JSON.stringify(manifest, null, 2) + '\n';
+}

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

@@ -3,6 +3,9 @@
  *
  * When Mastra is off, emit a no-op placeholder so the directory still exists
  * and `mastra dev` fails predictably rather than importing partial code.
+ *
+ * When Mastra is on with full agent config, bootstrap the CLI and re-export
+ * the configured Mastra Agent via `cli.bootstrap()`.
  */
 import { type ClintProjectSpec } from '../../spec/types.js';
 export declare function buildMastraIndexTs(spec: ClintProjectSpec): string;

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

@@ -1,28 +1,70 @@
+/**
+ * Derive the `{PROVIDER}_API_KEY` env var name from a provider prefix
+ * (e.g. `anthropic` → `ANTHROPIC_API_KEY`).
+ */
+function getApiKeyEnvVar(provider) {
+    return `${provider.toUpperCase()}_API_KEY`;
+}
 export function buildMastraIndexTs(spec) {
     const { mastra } = spec.features;
     if (!mastra.enabled) {
         return [
+            '// @clint:begin mastra-index',
             '/**',
             ' * Mastra Studio entry point — placeholder. Enable the `mastra` feature to',
             ' * populate this file. Until then `mastra:*` scripts are effectively no-ops.',
             ' */',
-            '// @clint:begin mastra-index',
             'export {};',
             '// @clint:end mastra-index',
             '',
         ].join('\n');
     }
-    // When Mastra is enabled but we still emit the demo `AgentProvider` shim
-    // (not a real `@mastra/core` Agent), there is no `mastra` export yet —
-    // `mastra dev` will surface a helpful message once you wire a real Agent.
+    // Full agent config available — emit bootstrap-based Mastra instance
+    if (mastra.agentId && mastra.models.length > 0) {
+        const providers = [...new Set(mastra.models.map(m => m.id.split(/[:/]/)[0]))];
+        const lines = [
+            '// @clint:begin mastra-index',
+            '/**',
+            ' * Mastra Studio entry point for `mastra dev` / `mastra build` / `mastra start`.',
+            ' *',
+            ' * Bootstraps the CLI to get the configured agent, then exports a Mastra',
+            ' * instance for Studio integration.',
+            ' */',
+            "import { Mastra } from '@mastra/core/mastra';",
+            "import type { Agent } from '@mastra/core/agent';",
+            "import path from 'node:path';",
+            "import { cli } from '../cli.js';",
+            "import { CLI_ROOT } from '../config.js';",
+            '',
+            "// Under `mastra dev`, CLI_ROOT points to .mastra/ (bundler output).",
+            '// The actual project root is its parent.',
+            "const projectRoot = path.basename(CLI_ROOT) === '.mastra'",
+            '  ? path.dirname(CLI_ROOT)',
+            '  : CLI_ROOT;',
+            '',
+            'const rt = await cli.bootstrap({ workdir: projectRoot });',
+            '',
+        ];
+        // API key env bridge for Studio
+        lines.push(`// Workaround: Mastra Studio checks process.env for API keys directly.`, `// Bridge the ph-clint resolved keys so Studio's provider detection works.`);
+        for (const provider of providers) {
+            const field = `${provider}ApiKey`;
+            const envVar = getApiKeyEnvVar(provider);
+            lines.push(`{`, `  const key = rt.config.${field} as string | undefined;`, `  if (key && !process.env.${envVar}) process.env.${envVar} = key;`, `}`);
+        }
+        lines.push('');
+        lines.push('const mastraAgent = await rt.mastraAgent as Agent | undefined;', '', 'export const mastra = new Mastra({', '  agents: mastraAgent ? { [mastraAgent.id]: mastraAgent } : {},', '});', '// @clint:end mastra-index', '');
+        return lines.join('\n');
+    }
+    // Mastra enabled but no full agent config yet — placeholder
     return [
+        '// @clint:begin mastra-index',
         '/**',
         ' * Mastra Studio entry point for `mastra dev` / `mastra build` / `mastra start`.',
         ' *',
         " * Re-export a configured `@mastra/core` Mastra instance from here once you",
         " * replace the demo createAgent shim with a real Mastra Agent.",
         ' */',
-        '// @clint:begin mastra-index',
         'export {};',
         '// @clint:end mastra-index',
         '',

package/dist/codegen/builders/publish-config-ts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds the root `publish.config.ts` for split-layout projects.
+ * Defines a single lockstep group containing both the app and cli packages.
+ */
+import { type ClintProjectSpec } from '../../spec/types.js';
+export declare function buildPublishConfigTs(spec: ClintProjectSpec): string;

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

@@ -0,0 +1,21 @@
+export function buildPublishConfigTs(spec) {
+    const app = `${spec.name}-app`;
+    const cli = `${spec.name}-cli`;
+    // The publish pipeline appends the prerelease suffix (e.g. -dev.0), so we
+    // only store the base semver (M.m.p) here.
+    const baseVersion = spec.version.replace(/-.*$/, '');
+    return `// Publish config — loaded by ph-clint's publish pipeline.
+// definePublishConfig is an identity function; a plain export is equivalent.
+export default {
+  groups: {
+    '${spec.name}': {
+      version: '${baseVersion}',
+      packages: [
+        { path: '${app}', category: 'app' },
+        { path: '${cli}', category: 'cli' },
+      ],
+    },
+  },
+};
+`;
+}

package/dist/codegen/builders/readme-md.js

@@ -1,9 +1,10 @@
 /**
  * Builds the project README for a freshly-generated ph-clint project.
  */
-import { getPackageName, } from '../../spec/types.js';
+import { getPackageName, phAtLeast, } from '../../spec/types.js';
 export function buildReadme(spec) {
     const { mastra, routine, powerhouse } = spec.features;
+    const ph = powerhouse;
     const title = getPackageName(spec);
     const lines = [];
     lines.push(`# ${title}`);
@@ -19,10 +20,10 @@ export function buildReadme(spec) {
     lines.push('');
     lines.push('## Enabled features');
     lines.push('');
-    lines.push(`- **Powerhouse**: ${powerhouse.enabled ? 'on' : 'off'}`);
-    if (powerhouse.enabled) {
-        lines.push(`  - Switchboard: ${powerhouse.switchboard ? 'on' : 'off'}`);
-        lines.push(`  - Connect: ${powerhouse.connect ? 'on' : 'off'}`);
+    lines.push(`- **Powerhouse**: ${ph !== 'Disabled' ? `on (${ph})` : 'off'}`);
+    if (phAtLeast(ph, 'Reactor')) {
+        lines.push(`  - Switchboard: ${phAtLeast(ph, 'Switchboard') ? 'on' : 'off'}`);
+        lines.push(`  - Connect: ${phAtLeast(ph, 'Connect') ? 'on' : 'off'}`);
     }
     lines.push(`- **Mastra agent**: ${mastra.enabled ? 'on' : 'off'}`);
     lines.push(`- **Routine loop**: ${routine.enabled ? 'on' : 'off'}`);
@@ -30,9 +31,9 @@ export function buildReadme(spec) {
     lines.push('## Regenerate');
     lines.push('');
     lines.push('Toggle features or update metadata in `.ph/ph-clint-cli/project-spec.json`,');
-    lines.push('then re-run `ph-clint` to regenerate.');
+    lines.push('then re-run `ph-clint clint-project-regen` to regenerate.');
     lines.push('');
-    if (powerhouse.enabled) {
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push('## Split layout');
         lines.push('');
         lines.push(`This project is split into \`${spec.name}-cli/\` (the CLI) and \`${spec.name}-app/\` (the Powerhouse reactor package).`);

package/dist/codegen/builders/root-package-json.d.ts

@@ -2,6 +2,9 @@
  * Builds the *root* `package.json` for split-layout projects (Powerhouse
  * enabled). A plain passthrough — deliberately no pnpm workspaces because
  * they interfere with `{name}-app`'s own `pnpm build`.
+ *
+ * Uses `pnpm --prefix <dir>` for all orchestration scripts — no cwd mutation.
+ * Build order: app first, then cli (cli depends on app via `file:` dep).
  */
 import { type ClintProjectSpec } from '../../spec/types.js';
 export declare function buildRootPackageJson(spec: ClintProjectSpec): string;

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

@@ -2,26 +2,39 @@
  * Builds the *root* `package.json` for split-layout projects (Powerhouse
  * enabled). A plain passthrough — deliberately no pnpm workspaces because
  * they interfere with `{name}-app`'s own `pnpm build`.
+ *
+ * Uses `pnpm --prefix <dir>` for all orchestration scripts — no cwd mutation.
+ * Build order: app first, then cli (cli depends on app via `file:` dep).
  */
-import { getPackageName, } from '../../spec/types.js';
+import { getPackageName, phAtLeast, } from '../../spec/types.js';
 export function buildRootPackageJson(spec) {
     const cli = `${spec.name}-cli`;
     const app = `${spec.name}-app`;
+    const prefix = (dir, cmd) => `pnpm --prefix ${dir} ${cmd}`;
+    const both = (cmd) => `${prefix(app, cmd)} && ${prefix(cli, cmd)}`;
+    const connectEnabled = phAtLeast(spec.features.powerhouse, 'Connect');
+    const buildScript = connectEnabled
+        ? `${prefix(app, 'build')} && ${prefix(app, 'connect:build')} && ${prefix(cli, 'build')}`
+        : both('build');
+    const scripts = {
+        install: both('install'),
+        build: buildScript,
+        test: both('test'),
+        dev: prefix(cli, 'dev'),
+        start: prefix(cli, 'start'),
+        lint: prefix(cli, 'lint'),
+        'app:dev': prefix(app, 'dev'),
+        'cli:dev': prefix(cli, 'dev'),
+        'publish:dev': `${prefix(cli, 'exec ph-publish')} dev -c ./publish.config.ts`,
+        'publish:staging': `${prefix(cli, 'exec ph-publish')} staging -c ./publish.config.ts`,
+        'publish:production': `${prefix(cli, 'exec ph-publish')} production -c ./publish.config.ts`,
+    };
     const pkg = {
         name: getPackageName(spec),
         version: spec.version,
         private: true,
         ...(spec.description ? { description: spec.description } : {}),
-        scripts: {
-            install: `cd ${app} && pnpm install && cd ../${cli} && pnpm install`,
-            build: `cd ${app} && pnpm build && cd ../${cli} && pnpm build`,
-            dev: `cd ${cli} && pnpm dev`,
-            start: `cd ${cli} && pnpm start`,
-            test: `cd ${app} && pnpm test && cd ../${cli} && pnpm test`,
-            lint: `cd ${cli} && pnpm lint`,
-            'app:dev': `cd ${app} && pnpm dev`,
-            'cli:dev': `cd ${cli} && pnpm dev`,
-        },
+        scripts,
     };
     return JSON.stringify(pkg, null, 2) + '\n';
 }

package/dist/codegen/index.js

@@ -35,7 +35,7 @@ import { hashContent, hashFile, readHashes, writeHashes, } from './hashes.js';
 import { hasMarkers, spliceMarkerRegions } from './markers.js';
 import { writeFileEnsuringDir, isDirEmptyEnough } from './write.js';
 import { migrateFlatToSplit } from './migrate/flat-to-split.js';
-import { CLI_FILE_BUILDERS, buildReadme, buildRootPackageJson, buildAppIndexTs, } from './builders/index.js';
+import { CLI_FILE_BUILDERS, getProfileFileBuilders, buildReadme, buildRootPackageJson, buildPublishConfigTs, buildAppIndexTs, } from './builders/index.js';
 /**
  * Generate / reconcile a project at `targetDir` from the given spec.
  */
@@ -50,8 +50,8 @@ export async function generateProject(options) {
     let migrated = false;
     if (resolvedMode === 'update' &&
         existingSpec &&
-        !existingSpec.features.powerhouse.enabled &&
-        spec.features.powerhouse.enabled) {
+        existingSpec.features.powerhouse === 'Disabled' &&
+        spec.features.powerhouse !== 'Disabled') {
         await migrateFlatToSplit({
             targetDir,
             spec,
@@ -75,11 +75,12 @@ function resolveMode(requested, specExists) {
 }
 /** Build the list of files the new spec would emit, with their content. */
 function planFiles(spec, targetDir) {
-    const split = spec.features.powerhouse.enabled;
+    const split = spec.features.powerhouse !== 'Disabled';
     const cliDir = split ? path.join(targetDir, getCliFolderName(spec)) : targetDir;
     const appDir = split ? path.join(targetDir, getAppFolderName(spec)) : null;
     const planned = [];
-    for (const builder of CLI_FILE_BUILDERS) {
+    const allBuilders = [...CLI_FILE_BUILDERS, ...getProfileFileBuilders(spec)];
+    for (const builder of allBuilders) {
         const content = builder.build(spec);
         if (content === null)
             continue;
@@ -106,6 +107,12 @@ function planFiles(spec, targetDir) {
             absolutePath: rootPkg,
             content: buildRootPackageJson(spec),
         });
+        const publishConfig = path.join(targetDir, 'publish.config.ts');
+        planned.push({
+            relativePath: 'publish.config.ts',
+            absolutePath: publishConfig,
+            content: buildPublishConfigTs(spec),
+        });
         const appGitkeep = path.join(appDir, '.gitkeep');
         planned.push({
             relativePath: path.relative(targetDir, appGitkeep),
@@ -195,13 +202,20 @@ async function runUpdate(options, warn, migrated) {
     for (const p of planned) {
         if (p.initOnly) {
             // User-owned files (e.g. `src/framework.ts` with its `configSchema`)
-            // are emitted only on create. In update mode we never overwrite them
-            // and never re-create them if missing — the user may have deliberately
-            // deleted or inlined them. Keep whatever hash the previous run stored
-            // so the deletion pass (step 2) still considers them "ours".
-            const stored = previous[p.relativePath];
-            if (stored !== undefined)
-                next[p.relativePath] = stored;
+            // are emitted only on create. In update mode we never overwrite them —
+            // but we DO create them if they don't yet exist on disk (e.g. first
+            // spec-change trigger run where no explicit `init` was run before).
+            const onDisk = await hashFile(p.absolutePath);
+            if (onDisk === null && p.content) {
+                await writeFileEnsuringDir(p.absolutePath, p.content);
+                next[p.relativePath] = hashContent(p.content);
+                files.push({ absolutePath: p.absolutePath, relativePath: p.relativePath });
+            }
+            else {
+                const stored = previous[p.relativePath];
+                if (stored !== undefined)
+                    next[p.relativePath] = stored;
+            }
             continue;
         }
         const existing = await hashFile(p.absolutePath);

package/dist/codegen/scaffold.d.ts

@@ -1,4 +1,12 @@
 import type { ClintProjectSpec } from '../spec/types.js';
+import type { ProcessRunOptions } from '@powerhousedao/ph-clint';
+/**
+ * Signature for the subprocess runner — matches CommandContext.runProcess.
+ */
+type RunProcess = (command: string, opts?: Omit<ProcessRunOptions, 'onOutput'>) => Promise<{
+    success: boolean;
+    output: string;
+}>;
 export interface PhInitOptions {
     /** Absolute path to the project root. */
     targetDir: string;
@@ -9,14 +17,22 @@ export interface PhInitOptions {
     log?: (msg: string) => void;
     /** Override `ph` binary name (for tests). */
     binName?: string;
-    /** Stdio passthrough (tests pass 'ignore'). */
-    stdio?: 'inherit' | 'ignore';
+    /** Subprocess runner — uses CommandContext.runProcess when available. */
+    runProcess?: RunProcess;
+    /** Explicit Powerhouse version to pin `ph init` to (tag or semver). */
+    phVersion?: string;
 }
 export interface PhInitResult {
     ran: boolean;
     exitCode?: number;
     reason?: string;
 }
+/**
+ * Detect the installed `ph` CLI version by parsing `ph --version` output.
+ * Returns the version string (e.g. '6.0.0-dev.194') or undefined if
+ * detection fails.
+ */
+export declare function getPhVersion(binName: string): string | undefined;
 export declare function runPhInit(options: PhInitOptions): Promise<PhInitResult>;
 export interface PnpmInstallOptions {
     /** Directories to run `pnpm install` in, in order. */
@@ -24,7 +40,8 @@ export interface PnpmInstallOptions {
     log?: (msg: string) => void;
     /** Override `pnpm` binary name (for tests). */
     binName?: string;
-    stdio?: 'inherit' | 'ignore';
+    /** Subprocess runner — uses CommandContext.runProcess when available. */
+    runProcess?: RunProcess;
 }
 export interface PnpmInstallResult {
     ran: string[];
@@ -32,3 +49,4 @@ export interface PnpmInstallResult {
     reason?: string;
 }
 export declare function runPnpmInstall(options: PnpmInstallOptions): Promise<PnpmInstallResult>;
+export {};