@powerhousedao/ph-clint-cli 0.1.0-dev.47 → 0.1.0-dev.48

package/dist/codegen/actions.d.ts

@@ -9,6 +9,10 @@ export type PostGenAction = {
 } | {
     kind: 'app-install';
     dir: string;
+} | {
+    kind: 'app-ph-install';
+    appDir: string;
+    packages: string[];
 } | {
     kind: 'app-build';
     dir: string;

package/dist/codegen/actions.js

@@ -9,12 +9,14 @@
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import { getAppPackageName } from '../spec/types.js';
 // ---------------------------------------------------------------------------
 // Fixed execution order — index defines precedence
 // ---------------------------------------------------------------------------
 const ACTION_ORDER = [
     'ph-init',
     'app-install',
+    'app-ph-install',
     'app-build',
     'cli-install',
     'cli-build',
@@ -28,11 +30,12 @@ function actionIndex(kind) {
 // ---------------------------------------------------------------------------
 /** Returns true if `downstream` depends on `upstream` succeeding. */
 function dependsOn(downstream, upstream) {
-    // ph-init → app-install → app-build → cli-install → cli-build
+    // ph-init → app-install → app-ph-install → app-build → cli-install → cli-build
     // skills-sync is independent of the build chain
     const chain = [
         'ph-init',
         'app-install',
+        'app-ph-install',
         'app-build',
         'cli-install',
         'cli-build',
@@ -57,6 +60,29 @@ async function fileExists(filePath) {
         return false;
     }
 }
+/** External packages that have document types (not the app package). */
+function getExternalPackages(spec) {
+    const appPkg = getAppPackageName(spec);
+    return spec.packages.filter((p) => p.packageName !== appPkg && p.documentTypes.length > 0);
+}
+/**
+ * Returns package names from `extPkgs` that are not yet registered in
+ * the app's `powerhouse.config.json`.
+ */
+async function getMissingPhPackages(appDir, extPkgs) {
+    try {
+        const raw = await fs.readFile(path.join(appDir, 'powerhouse.config.json'), 'utf8');
+        const config = JSON.parse(raw);
+        const registered = new Set((config.packages ?? []).map((p) => p.packageName));
+        return extPkgs
+            .map((p) => p.packageName)
+            .filter((name) => !registered.has(name));
+    }
+    catch {
+        // No config file yet (pre-init) — all packages are missing
+        return extPkgs.map((p) => p.packageName);
+    }
+}
 // ---------------------------------------------------------------------------
 // collectPostGenActions
 // ---------------------------------------------------------------------------
@@ -133,6 +159,16 @@ export async function collectPostGenActions(result, spec) {
             }
         }
     }
+    // Check if external packages need registering in the app
+    const extPkgs = split && result.appDir ? getExternalPackages(spec) : [];
+    if (split && result.appDir && extPkgs.length > 0) {
+        const missing = await getMissingPhPackages(result.appDir, extPkgs);
+        if (missing.length > 0) {
+            if (!earliest || actionIndex(earliest) > actionIndex('app-ph-install')) {
+                earliest = 'app-ph-install';
+            }
+        }
+    }
     // Build the action list from earliest onward
     const actions = [];
     if (earliest && split && result.appDir) {
@@ -148,6 +184,12 @@ export async function collectPostGenActions(result, spec) {
         if (ei <= actionIndex('app-install')) {
             actions.push({ kind: 'app-install', dir: result.appDir });
         }
+        if (ei <= actionIndex('app-ph-install') && extPkgs.length > 0) {
+            const missing = await getMissingPhPackages(result.appDir, extPkgs);
+            if (missing.length > 0) {
+                actions.push({ kind: 'app-ph-install', appDir: result.appDir, packages: missing });
+            }
+        }
         if (ei <= actionIndex('app-build')) {
             // Add install if not already in the list and node_modules is missing
             if (!actions.some(a => a.kind === 'app-install') &&
@@ -202,6 +244,8 @@ function actionLabel(action) {
             return `Initialize reactor package (${path.basename(action.appDir)})`;
         case 'app-install':
             return `Install dependencies (${path.basename(action.dir)})`;
+        case 'app-ph-install':
+            return `Register external packages (${action.packages.join(', ')})`;
         case 'app-build':
             return `Build (${path.basename(action.dir)})`;
         case 'cli-install':
@@ -224,7 +268,9 @@ export async function runPostGenActions(actions, ctx) {
     const effective = actions.filter((a) => {
         if (skip.has(a.kind))
             return false;
-        // If app-install is skipped, also skip app-build
+        // If app-install is skipped, also skip app-ph-install and app-build
+        if (a.kind === 'app-ph-install' && skip.has('app-install'))
+            return false;
         if (a.kind === 'app-build' && skip.has('app-install'))
             return false;
         // If cli-install is skipped, also skip cli-build
@@ -332,6 +378,15 @@ async function executeAction(action, ctx) {
             }
             return result.exitCode === 0;
         }
+        case 'app-ph-install': {
+            const { runPhInstallPackages } = await import('./scaffold.js');
+            return runPhInstallPackages({
+                appDir: action.appDir,
+                packages: action.packages,
+                log: (msg) => ctx.log(`      ${msg}`),
+                runProcess: ctx.runProcess,
+            });
+        }
         case 'app-install':
         case 'cli-install': {
             if (ctx.runProcess) {

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

@@ -4,6 +4,11 @@
  * specific regions on subsequent runs (delta mode — future phase).
  */
 import { getAppPackageName, phAtLeast } from '../../spec/types.js';
+/** External packages that have document types (not the app package). */
+function getExternalPackages(spec) {
+    const appPkg = getAppPackageName(spec);
+    return spec.packages.filter((p) => p.packageName !== appPkg && p.documentTypes.length > 0);
+}
 export function buildCliTs(spec) {
     const { mastra, routine, powerhouse } = spec.features;
     const ph = powerhouse;
@@ -29,6 +34,11 @@ export function buildCliTs(spec) {
     lines.push(`import { configSchema, secretsSchema } from './framework.js';`);
     if (phAtLeast(ph, 'Reactor')) {
         lines.push(`import { documentModels } from '${getAppPackageName(spec)}';`);
+        const extPkgs = getExternalPackages(spec);
+        for (let i = 0; i < extPkgs.length; i++) {
+            const alias = extPkgs.length === 1 ? 'extModels' : `extModels${i}`;
+            lines.push(`import { documentModels as ${alias} } from '${extPkgs[i].packageName}';`);
+        }
     }
     if (mastra.enabled) {
         lines.push(`import { createAgent } from './agents/agent.js';`);
@@ -131,7 +141,14 @@ export function buildCliTs(spec) {
         lines.push('cli.configureReactor({');
         lines.push('  create: (ctx) =>');
         lines.push('    buildDefaultReactor(ctx, {');
-        lines.push('      documentModels,');
+        const extPkgs = getExternalPackages(spec);
+        if (extPkgs.length === 0) {
+            lines.push('      documentModels,');
+        }
+        else {
+            const aliases = extPkgs.map((_, i) => extPkgs.length === 1 ? 'extModels' : `extModels${i}`);
+            lines.push(`      documentModels: [...documentModels, ${aliases.map(a => `...${a}`).join(', ')}],`);
+        }
         lines.push(`      drive: { name: '${spec.name}' },`);
         lines.push('    }),');
         lines.push(`  switchboard: { enabled: ${String(phAtLeast(ph, 'Switchboard'))} },`);

package/dist/codegen/scaffold.d.ts

@@ -44,6 +44,16 @@ export declare function patchAppPackageName(appDir: string, spec: {
     name: string;
     scope?: string;
 }, log?: (msg: string) => void): Promise<boolean>;
+/**
+ * Run `ph install <packages> --local --pnpm` in the app directory to register
+ * external packages in `powerhouse.config.json`.
+ */
+export declare function runPhInstallPackages(options: {
+    appDir: string;
+    packages: string[];
+    log?: (msg: string) => void;
+    runProcess?: RunProcess;
+}): Promise<boolean>;
 export interface PnpmInstallOptions {
     /** Directories to run `pnpm install` in, in order. */
     dirs: string[];

package/dist/codegen/scaffold.js

@@ -119,6 +119,33 @@ export async function patchAppPackageName(appDir, spec, log) {
 async function patchScopedName(options, _appFolder, log) {
     await patchAppPackageName(options.appDir, options.spec, log);
 }
+/**
+ * Run `ph install <packages> --local --pnpm` in the app directory to register
+ * external packages in `powerhouse.config.json`.
+ */
+export async function runPhInstallPackages(options) {
+    const { appDir, packages, log = () => { }, runProcess } = options;
+    const binName = 'ph';
+    if (!(await hasCommandOnPath(binName))) {
+        log(`Skipping — \`${binName}\` is not on PATH.`);
+        return false;
+    }
+    const args = ['install', ...packages, '--local', '--pnpm'];
+    log(`Running \`${binName} install ${packages.join(' ')} --local\` in ${path.basename(appDir)} …`);
+    if (runProcess) {
+        const result = await runProcess(`${binName} ${args.join(' ')}`, {
+            cwd: appDir,
+            timeout: 300_000,
+        });
+        return result.success;
+    }
+    const { runCommand } = await import('./exec.js');
+    const result = await runCommand(binName, args, {
+        cwd: appDir,
+        stdio: 'inherit',
+    });
+    return result.exitCode === 0;
+}
 export async function runPnpmInstall(options) {
     const log = options.log ?? (() => { });
     const binName = options.binName ?? 'pnpm';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.47",
+  "version": "0.1.0-dev.48",
   "publishConfig": {
     "access": "public"
   },
@@ -29,9 +29,9 @@
     "@mastra/core": "^1.22.0",
     "@mastra/libsql": "^1.7.4",
     "@mastra/memory": "^1.13.1",
-    "@powerhousedao/ph-clint": "^0.1.0-dev.47",
-    "@powerhousedao/ph-clint-app": "^0.1.0-dev.47",
-    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.47",
+    "@powerhousedao/ph-clint": "^0.1.0-dev.48",
+    "@powerhousedao/ph-clint-app": "^0.1.0-dev.48",
+    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.48",
     "@powerhousedao/reactor": "6.0.0-dev.170",
     "@powerhousedao/reactor-api": "6.0.0-dev.170",
     "@powerhousedao/shared": "6.0.0-dev.170",