@powerhousedao/ph-clint-cli 0.1.0-dev.2 → 0.1.0-dev.21

package/dist/cli.js

@@ -6,10 +6,8 @@
  * rewritten by ph-clint-cli's generator when the project spec changes.
  * Everything outside the markers is user-editable and preserved.
  */
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { defineCli, buildDefaultReactor } from '@powerhousedao/ph-clint';
-import { CLI_NAME, CLI_VERSION } from './config.js';
+import { CLI_NAME, CLI_VERSION, CLI_ROOT } from './config.js';
 import { configSchema, secretsSchema } from './framework.js';
 // @clint:begin imports
 import { documentModels } from '@powerhousedao/ph-clint-app';
@@ -19,29 +17,29 @@ import { regen } from './commands/clint-project-regen.js';
 import { build } from './commands/clint-project-build.js';
 import { clintProjectPublish } from './commands/clint-project-publish.js';
 import { clintProject } from './services/clint-project.js';
+import { skillsSync } from './commands/clint-skills-sync.js';
 import { specChangeTrigger } from './triggers/spec-change.js';
+import { publishTrigger } from './triggers/publish-trigger.js';
 // @clint:end imports
-// Connect (ph connect) must run inside the Reactor Package (ph-clint-app).
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const appDir = path.resolve(__dirname, '../../ph-clint-app');
 export const cli = defineCli({
     name: CLI_NAME,
     version: CLI_VERSION,
+    root: CLI_ROOT,
     description: `${CLI_NAME} v${CLI_VERSION} — scaffold and maintain ph-clint implementation projects`,
     configSchema,
     secretsSchema,
     // @clint:begin commands
-    commands: [init, regen, build, clintProjectPublish],
+    commands: [init, regen, build, clintProjectPublish, skillsSync],
     // @clint:end commands
     // @clint:begin services
     services: [clintProject],
     // @clint:end services
     // @clint:begin triggers
-    triggers: [specChangeTrigger],
+    triggers: [specChangeTrigger, publishTrigger],
     // @clint:end triggers
     // @clint:begin prompts
     prompts: {
-        sources: [],
+        artifacts: [],
         agents: {},
         skills: {},
     },
@@ -74,7 +72,7 @@ cli.configureReactor({
         subscriptions: { documentTypes: ['powerhouse/ph-clint-project'] },
     }),
     switchboard: { enabled: true },
-    connect: { enabled: true, workdir: appDir },
+    connect: { enabled: true },
 });
 // @clint:end reactor
 // @clint:begin mastra

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

@@ -3,16 +3,9 @@
  * 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 { type ClintProjectSpec } from '../../spec/types.js';
 export declare function buildAppIndexTs(spec: ClintProjectSpec): string | null;

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);
@@ -23,12 +54,20 @@ export function buildCliPackageJson(spec) {
         dependencies['@mastra/libsql'] = '^1.7.4';
         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.
+        for (const pkg of spec.packages) {
+            if (pkg.packageName !== appPkg) {
+                dependencies[pkg.packageName] = 'latest';
+            }
+        }
     }
     const scripts = {
         'build:skills': 'tsx scripts/build-skills.ts',
@@ -43,16 +82,16 @@ export function buildCliPackageJson(spec) {
         scripts['mastra:build'] = 'mastra build';
         scripts['mastra:start'] = 'mastra start';
     }
-    scripts['publish:npm'] = 'pnpm build && pnpm publish --no-git-checks';
     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 = {

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,30 @@ 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';`);
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push(`import { defineCli, buildDefaultReactor } from '@powerhousedao/ph-clint';`);
     }
     else {
         lines.push(`import { defineCli } from '@powerhousedao/ph-clint';`);
     }
-    lines.push(`import { CLI_NAME, CLI_VERSION } from './config.js';`);
+    lines.push(`import { CLI_NAME, CLI_VERSION${phAtLeast(ph, 'Reactor') ? ', 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,7 +62,7 @@ export function buildCliTs(spec) {
     lines.push('');
     lines.push('  // @clint:begin prompts');
     lines.push('  prompts: {');
-    lines.push('    sources: [],');
+    lines.push('    artifacts: [],');
     lines.push('    agents: {},');
     lines.push('    skills: {},');
     lines.push('  },');
@@ -88,15 +91,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/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,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.');

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

@@ -39,5 +39,6 @@ export interface FileBuilder {
 export declare const CLI_FILE_BUILDERS: FileBuilder[];
 export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildFrameworkGenTs, buildFrameworkTs, };
 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

@@ -56,5 +56,6 @@ export const CLI_FILE_BUILDERS = [
 ];
 export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTsconfigJson, buildJestConfigJs, buildEslintConfigJs, buildGitignore, buildMastraIndexTs, buildBuildSkillsScript, buildAgentBaseMd, buildAgentTs, buildFrameworkGenTs, buildFrameworkTs, };
 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/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';
 }