@powerhousedao/ph-clint-cli 0.1.0-dev.50 → 0.1.0-dev.52

package/dist/codegen/actions.d.ts

@@ -30,7 +30,7 @@ export type PostGenAction = {
 export type PostGenActionKind = PostGenAction['kind'];
 export interface PostGenActionContext {
     log: (msg: string) => void;
-    runProcess?: (command: string, opts?: Omit<ProcessRunOptions, 'onOutput'>) => Promise<{
+    runProcess: (command: string, opts?: Omit<ProcessRunOptions, 'onOutput'>) => Promise<{
         success: boolean;
         output: string;
     }>;

package/dist/codegen/actions.js

@@ -389,20 +389,11 @@ async function executeAction(action, ctx) {
         }
         case 'app-install':
         case 'cli-install': {
-            if (ctx.runProcess) {
-                const result = await ctx.runProcess('pnpm install', {
-                    cwd: action.dir,
-                    timeout: 300_000,
-                });
-                return result.success;
-            }
-            // Fallback: direct spawn
-            const { runCommand } = await import('./exec.js');
-            const result = await runCommand('pnpm', ['install'], {
+            const result = await ctx.runProcess('pnpm install', {
                 cwd: action.dir,
-                stdio: 'inherit',
+                timeout: 300_000,
             });
-            return result.exitCode === 0;
+            return result.success;
         }
         case 'app-build':
         case 'cli-build': {
@@ -420,20 +411,11 @@ async function executeAction(action, ctx) {
     }
 }
 async function runBuild(dir, ctx) {
-    if (ctx.runProcess) {
-        const result = await ctx.runProcess('pnpm build', {
-            cwd: dir,
-            timeout: 120_000,
-        });
-        return result.success;
-    }
-    // Fallback: direct spawn
-    const { runCommand } = await import('./exec.js');
-    const result = await runCommand('pnpm', ['build'], {
+    const result = await ctx.runProcess('pnpm build', {
         cwd: dir,
-        stdio: 'inherit',
+        timeout: 120_000,
     });
-    return result.exitCode === 0;
+    return result.success;
 }
 function formatDuration(ms) {
     if (ms < 1000)

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

@@ -7,7 +7,7 @@
  * own reactor package). External packages' document types are imported from
  * their own npm packages, not from the app barrel.
  */
-import { getAppPackageName, getDocumentTypeSlug, phAtLeast, } from '../../spec/types.js';
+import { getAppPackageName, getDocumentTypeSlug, isDocTypeGlob, phAtLeast, } from '../../spec/types.js';
 export function buildAppIndexTs(spec) {
     if (!phAtLeast(spec.features.powerhouse, 'Reactor'))
         return null;
@@ -16,12 +16,22 @@ export function buildAppIndexTs(spec) {
     const docTypes = appEntry?.documentTypes ?? [];
     if (docTypes.length === 0)
         return null;
+    const hasGlobs = docTypes.some(isDocTypeGlob);
+    const explicits = docTypes.filter((dt) => !isDocTypeGlob(dt));
     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 docTypes) {
+    if (hasGlobs) {
+        // Glob patterns can't enumerate slugs at codegen time — re-export
+        // from the Powerhouse-generated barrel which already re-exports all
+        // document models in the package.
+        lines.push("export * from './document-models/index.js';");
+    }
+    // Explicit entries still get per-slug re-exports (they may point at
+    // models not yet in the generated barrel during bootstrapping).
+    for (const docType of explicits) {
         const slug = getDocumentTypeSlug(docType);
         lines.push(`export * from './document-models/${slug}/index.js';`);
     }

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

@@ -1,13 +1,19 @@
 /**
  * Builds `src/framework.gen.ts` — the fully machine-owned half of the
  * typed-binding split. Regenerated on every `init` and `update`; holds the
- * `defineRegistry([...] as const)` call that describes which document models
+ * `defineRegistry([...])` call that describes which document models
  * are bound into `framework.ts`'s typed factories.
  *
  * 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.
  *
+ * Document type entries may be explicit IDs (`powerhouse/ph-clint-project`)
+ * or glob patterns (`*​/*`, `powerhouse/*`, `acme/doc-*`).  Explicit IDs
+ * produce static named imports; glob patterns import the package's
+ * `documentModels` array and filter at runtime so newly-added document
+ * models are picked up without a codegen re-run.
+ *
  * 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 document types are declared,

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

@@ -1,13 +1,19 @@
 /**
  * Builds `src/framework.gen.ts` — the fully machine-owned half of the
  * typed-binding split. Regenerated on every `init` and `update`; holds the
- * `defineRegistry([...] as const)` call that describes which document models
+ * `defineRegistry([...])` call that describes which document models
  * are bound into `framework.ts`'s typed factories.
  *
  * 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.
  *
+ * Document type entries may be explicit IDs (`powerhouse/ph-clint-project`)
+ * or glob patterns (`*​/*`, `powerhouse/*`, `acme/doc-*`).  Explicit IDs
+ * produce static named imports; glob patterns import the package's
+ * `documentModels` array and filter at runtime so newly-added document
+ * models are picked up without a codegen re-run.
+ *
  * 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 document types are declared,
@@ -15,28 +21,44 @@
  * `import { registry } from './framework.gen.js'` keeps resolving across
  * regens.
  */
-import { getAppPackageName, getDocumentTypeModuleName, getDocumentTypeSlug, phAtLeast, } from '../../spec/types.js';
+import { docTypeGlobToRegex, getAppPackageName, getDocumentTypeModuleName, getDocumentTypeSlug, isDocTypeGlob, phAtLeast, } from '../../spec/types.js';
 export function buildFrameworkGenTs(spec) {
     if (!phAtLeast(spec.features.powerhouse, 'Reactor'))
         return null;
     const appPkg = getAppPackageName(spec);
-    // Collect all (docType, moduleName, importFrom) tuples across packages.
-    // App-package modules are imported from the app barrel which re-exports
-    // bare PascalCase names. External packages use the per-slug deep subpath
-    // (`<pkg>/document-models/<slug>`) so TypeScript can resolve internal
-    // types (e.g. PHState) from stable import paths for declaration emit.
+    // Collect entries across packages. Each package may contribute both
+    // explicit named imports and glob-based runtime filters.
     const entries = [];
+    let globCounter = 0;
     for (const pkg of spec.packages) {
         const isApp = pkg.packageName === appPkg;
-        for (const docType of pkg.documentTypes) {
+        // Collect glob patterns for this package (may be multiple).
+        const globs = pkg.documentTypes.filter(isDocTypeGlob);
+        const explicits = pkg.documentTypes.filter((dt) => !isDocTypeGlob(dt));
+        for (const docType of explicits) {
             const slug = getDocumentTypeSlug(docType);
             entries.push({
-                docType,
+                kind: 'explicit',
                 name: getDocumentTypeModuleName(docType),
                 importFrom: isApp ? appPkg : `${pkg.packageName}/document-models/${slug}`,
             });
         }
+        if (globs.length > 0) {
+            // Merge all globs for this package into a single regex alternation.
+            const combined = globs.length === 1
+                ? docTypeGlobToRegex(globs[0])
+                : globs.map((g) => `(?:${docTypeGlobToRegex(g)})`).join('|');
+            const alias = globCounter === 0 ? 'globModels' : `globModels${globCounter}`;
+            globCounter++;
+            entries.push({
+                kind: 'glob',
+                modelsAlias: alias,
+                importFrom: isApp ? appPkg : pkg.packageName,
+                regexSource: combined,
+            });
+        }
     }
+    const hasGlobs = entries.some((e) => e.kind === 'glob');
     const lines = [];
     lines.push('/**');
     lines.push(' * THIS FILE IS GENERATED BY ph-clint-cli. DO NOT EDIT.');
@@ -46,8 +68,14 @@ export function buildFrameworkGenTs(spec) {
     lines.push(' * this file will be overwritten.');
     lines.push(' */');
     lines.push(`import { defineRegistry } from '@powerhousedao/ph-clint';`);
+    // Emit imports — named imports for explicit entries, documentModels for globs.
     for (const e of entries) {
-        lines.push(`import { ${e.name} } from '${e.importFrom}';`);
+        if (e.kind === 'explicit') {
+            lines.push(`import { ${e.name} } from '${e.importFrom}';`);
+        }
+        else {
+            lines.push(`import { documentModels as ${e.modelsAlias} } from '${e.importFrom}';`);
+        }
     }
     lines.push('');
     lines.push('/**');
@@ -57,13 +85,29 @@ export function buildFrameworkGenTs(spec) {
     if (entries.length === 0) {
         lines.push('export const registry = defineRegistry([] as const);');
     }
-    else {
+    else if (!hasGlobs) {
+        // Pure explicit — use `as const` for full type inference.
         lines.push('export const registry = defineRegistry([');
         for (const e of entries) {
-            lines.push(`  ${e.name},`);
+            if (e.kind === 'explicit') {
+                lines.push(`  ${e.name},`);
+            }
         }
         lines.push('] as const);');
     }
+    else {
+        // Mix of explicit + glob — runtime filter loses `as const` inference.
+        lines.push('export const registry = defineRegistry([');
+        for (const e of entries) {
+            if (e.kind === 'explicit') {
+                lines.push(`  ${e.name},`);
+            }
+            else {
+                lines.push(`  ...${e.modelsAlias}.filter((m) => /${e.regexSource}/.test(m.documentModel.global.id)),`);
+            }
+        }
+        lines.push(']);');
+    }
     lines.push('');
     lines.push('export type Registry = typeof registry;');
     return lines.join('\n') + '\n';

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

@@ -49,4 +49,3 @@ export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTscon
 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';

package/dist/codegen/builders/index.js

@@ -82,4 +82,3 @@ export { buildCliPackageJson, buildCliTs, buildConfigTs, buildMainTs, buildTscon
 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';

package/dist/codegen/exec.d.ts

@@ -1,20 +1,2 @@
-export interface RunCommandOptions {
-    cwd: string;
-    /** Override stdio; default `'inherit'`. Pass `'ignore'` for tests. */
-    stdio?: 'inherit' | 'ignore';
-    /** Extra env vars (merged with process.env). */
-    env?: Record<string, string>;
-}
-export interface RunCommandResult {
-    command: string;
-    args: string[];
-    cwd: string;
-    exitCode: number;
-}
-/**
- * Run `command args` in `cwd`, forwarding stdio by default. Resolves to
- * the exit code. Does NOT throw on non-zero — callers decide how to react.
- */
-export declare function runCommand(command: string, args: string[], options: RunCommandOptions): Promise<RunCommandResult>;
 /** Returns true if `command` is on PATH. */
 export declare function hasCommandOnPath(command: string): Promise<boolean>;

package/dist/codegen/exec.js

@@ -1,34 +1,7 @@
 /**
  * Small helpers for invoking external commands during code generation.
- *
- * We deliberately keep this separate from `ph-clint`'s process manager:
- * here we need synchronous-feeling prompt-forwarding (stdio inherited) so
- * the user can respond to interactive prompts from `ph init` or from a
- * package manager.
  */
 import { spawn } from 'node:child_process';
-/**
- * Run `command args` in `cwd`, forwarding stdio by default. Resolves to
- * the exit code. Does NOT throw on non-zero — callers decide how to react.
- */
-export async function runCommand(command, args, options) {
-    return new Promise((resolve, reject) => {
-        const child = spawn(command, args, {
-            cwd: options.cwd,
-            stdio: options.stdio ?? 'inherit',
-            env: options.env ? { ...process.env, ...options.env } : process.env,
-        });
-        child.once('error', reject);
-        child.once('close', (code) => {
-            resolve({
-                command,
-                args,
-                cwd: options.cwd,
-                exitCode: code ?? 0,
-            });
-        });
-    });
-}
 /** Returns true if `command` is on PATH. */
 export async function hasCommandOnPath(command) {
     return new Promise((resolve) => {

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, getProfileFileBuilders, buildReadme, buildRootPackageJson, buildPublishConfigJs, buildAppIndexTs, } from './builders/index.js';
+import { CLI_FILE_BUILDERS, getProfileFileBuilders, buildReadme, buildRootPackageJson, buildPublishConfigJs, } from './builders/index.js';
 import { collectPostGenActions, } from './actions.js';
 import { readGeneratedState, writeGeneratedState, generatedStateFromSpec, } from './generated.js';
 import { patchAppPackageName } from './scaffold.js';
@@ -135,17 +135,6 @@ function planFiles(spec, targetDir) {
             absolutePath: appReadme,
             content: buildAppReadmeContent(spec),
         });
-        // Top-level barrel for the reactor package — lets impl code import from
-        // `{name}-app` instead of drilling into `document-models/<slug>/v1/gen`.
-        const appIndex = buildAppIndexTs(spec);
-        if (appIndex !== null) {
-            const appIndexAbs = path.join(appDir, 'index.ts');
-            planned.push({
-                relativePath: path.relative(targetDir, appIndexAbs),
-                absolutePath: appIndexAbs,
-                content: appIndex,
-            });
-        }
     }
     return { planned, cliDir, appDir };
 }

package/dist/codegen/scaffold.d.ts

@@ -7,6 +7,7 @@ type RunProcess = (command: string, opts?: Omit<ProcessRunOptions, 'onOutput'>)
     success: boolean;
     output: string;
 }>;
+export type { RunProcess };
 export interface PhInitOptions {
     /** Absolute path to the project root. */
     targetDir: string;
@@ -17,8 +18,8 @@ export interface PhInitOptions {
     log?: (msg: string) => void;
     /** Override `ph` binary name (for tests). */
     binName?: string;
-    /** Subprocess runner — uses CommandContext.runProcess when available. */
-    runProcess?: RunProcess;
+    /** Subprocess runner — matches CommandContext.runProcess. */
+    runProcess: RunProcess;
     /** Explicit Powerhouse version to pin `ph init` to (tag or semver). */
     phVersion?: string;
 }
@@ -52,7 +53,7 @@ export declare function runPhInstallPackages(options: {
     appDir: string;
     packages: string[];
     log?: (msg: string) => void;
-    runProcess?: RunProcess;
+    runProcess: RunProcess;
 }): Promise<boolean>;
 export interface PnpmInstallOptions {
     /** Directories to run `pnpm install` in, in order. */
@@ -60,8 +61,8 @@ export interface PnpmInstallOptions {
     log?: (msg: string) => void;
     /** Override `pnpm` binary name (for tests). */
     binName?: string;
-    /** Subprocess runner — uses CommandContext.runProcess when available. */
-    runProcess?: RunProcess;
+    /** Subprocess runner — matches CommandContext.runProcess. */
+    runProcess: RunProcess;
 }
 export interface PnpmInstallResult {
     ran: string[];
@@ -69,4 +70,3 @@ export interface PnpmInstallResult {
     reason?: string;
 }
 export declare function runPnpmInstall(options: PnpmInstallOptions): Promise<PnpmInstallResult>;
-export {};

package/dist/codegen/scaffold.js

@@ -60,30 +60,17 @@ export async function runPhInit(options) {
     await fs.rm(options.appDir, { recursive: true, force: true });
     const args = ['init', appFolder, ...versionArgs, '--pnpm'];
     log(`Running \`${binName} init ${appFolder}\` (version: ${phVersion ?? 'auto'}) in ${options.targetDir} …`);
-    const run = options.runProcess;
-    if (run) {
-        const result = await run(`${binName} ${args.join(' ')}`, {
-            cwd: options.targetDir,
-            timeout: 300_000, // ph init + pnpm install can be slow
-        });
-        const exitCode = result.success ? 0 : 1;
-        if (!result.success) {
-            log(`\`${binName} init\` failed. ` +
-                'You can re-run it manually after resolving the issue.');
-        }
-        // Patch scoped name
-        await patchScopedName(options, appFolder, log);
-        return { ran: true, exitCode };
-    }
-    // Fallback: direct spawn with stdio inherit (for backward compat / tests without context)
-    const { runCommand } = await import('./exec.js');
-    const result = await runCommand(binName, args, { cwd: options.targetDir, stdio: 'inherit' });
-    if (result.exitCode !== 0) {
-        log(`\`${binName} init\` exited with code ${result.exitCode}. ` +
+    const result = await options.runProcess(`${binName} ${args.join(' ')}`, {
+        cwd: options.targetDir,
+        timeout: 300_000,
+    });
+    const exitCode = result.success ? 0 : 1;
+    if (!result.success) {
+        log(`\`${binName} init\` failed. ` +
             'You can re-run it manually after resolving the issue.');
     }
     await patchScopedName(options, appFolder, log);
-    return { ran: true, exitCode: result.exitCode };
+    return { ran: true, exitCode };
 }
 /**
  * Patch the app `package.json` name to the scoped form (`@scope/name-app`).
@@ -132,19 +119,11 @@ export async function runPhInstallPackages(options) {
     }
     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, {
+    const result = await runProcess(`${binName} ${args.join(' ')}`, {
         cwd: appDir,
-        stdio: 'inherit',
+        timeout: 300_000,
     });
-    return result.exitCode === 0;
+    return result.success;
 }
 export async function runPnpmInstall(options) {
     const log = options.log ?? (() => { });
@@ -157,27 +136,13 @@ export async function runPnpmInstall(options) {
     const ran = [];
     for (const dir of options.dirs) {
         log(`Running \`${binName} install\` in ${dir} …`);
-        const run = options.runProcess;
-        if (run) {
-            const result = await run(`${binName} install`, {
-                cwd: dir,
-                timeout: 300_000,
-            });
-            if (!result.success) {
-                log(`\`${binName} install\` failed in ${dir}. ` +
-                    'Retry manually once the underlying issue is resolved.');
-            }
-        }
-        else {
-            const { runCommand } = await import('./exec.js');
-            const result = await runCommand(binName, ['install'], {
-                cwd: dir,
-                stdio: 'inherit',
-            });
-            if (result.exitCode !== 0) {
-                log(`\`${binName} install\` exited with code ${result.exitCode} in ${dir}. ` +
-                    'Retry manually once the underlying issue is resolved.');
-            }
+        const result = await options.runProcess(`${binName} install`, {
+            cwd: dir,
+            timeout: 300_000,
+        });
+        if (!result.success) {
+            log(`\`${binName} install\` failed in ${dir}. ` +
+                'Retry manually once the underlying issue is resolved.');
         }
         ran.push(dir);
     }

package/dist/commands/clint-project-build.d.ts

@@ -4,4 +4,9 @@ export declare const build: import("@powerhousedao/ph-clint").Command<z.ZodObjec
     verbose: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>, {
     text: string;
-}, Record<string, unknown>>;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [import("document-model").DocumentModelModule<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>]>>;

package/dist/commands/clint-project-build.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { defineCommand } from '@powerhousedao/ph-clint';
+import { defineCommand } from '../framework.js';
 import { z } from 'zod';
 import { detectLayout } from '@powerhousedao/ph-clint-dev';
 const inputSchema = z.object({

package/dist/commands/clint-project-init.d.ts

@@ -78,5 +78,10 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
         };
         fileCount: number;
     };
-}, Record<string, unknown>>;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [import("document-model").DocumentModelModule<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>]>>;
 export {};

package/dist/commands/clint-project-init.js

@@ -12,7 +12,7 @@
  *   8. Print next-steps guidance.
  */
 import path from 'node:path';
-import { defineCommand } from '@powerhousedao/ph-clint';
+import { defineCommand } from '../framework.js';
 import { z } from 'zod';
 import { clintProjectSpecSchema, } from '../spec/types.js';
 import { generateProject } from '../codegen/index.js';
@@ -49,29 +49,33 @@ const inputSchema = z.object({
         .default(false)
         .describe('Do not run `pnpm install` after scaffolding'),
 });
-/** Parse `@scope/name` into { scope, name }. */
+/** Parse `@scope/name` into { scope, name }. Auto-appends `-cli` if missing. */
 function splitPackageName(raw) {
     const match = /^@([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/.exec(raw);
-    if (match)
-        return { scope: `@${match[1]}`, name: match[2] };
+    if (match) {
+        const name = match[2].endsWith('-cli') ? match[2] : `${match[2]}-cli`;
+        return { scope: `@${match[1]}`, name };
+    }
     if (raw.startsWith('@')) {
         throw new Error(`invalid package name "${raw}" — expected "@scope/name" with lowercase letters, digits, hyphens`);
     }
     if (!/^[a-z0-9][a-z0-9-]*$/.test(raw)) {
         throw new Error(`invalid project name "${raw}" — expected lowercase letters, digits, hyphens`);
     }
-    return { name: raw };
+    const name = raw.endsWith('-cli') ? raw : `${raw}-cli`;
+    return { name };
 }
 export function buildSpec(input) {
     const { scope, name } = splitPackageName(input.name);
     // Routine is forced on when Mastra is on — the REPL-only path works, but
     // the agent routine loop is what most users actually want.
     const routine = input.enableRoutine || input.enableMastra;
+    const baseName = name.replace(/-cli$/, '');
     const mastra = input.enableMastra
         ? {
             enabled: true,
-            agentId: `${name}-agent`,
-            agentName: `${name.charAt(0).toUpperCase()}${name.slice(1).replace(/-(\w)/g, (_, c) => ' ' + c.toUpperCase())} Agent`,
+            agentId: `${baseName}-agent`,
+            agentName: `${baseName.charAt(0).toUpperCase()}${baseName.slice(1).replace(/-(\w)/g, (_, c) => ' ' + c.toUpperCase())} Agent`,
             models: [{ id: 'anthropic/claude-sonnet-4-5', isDefault: true }],
             profiles: [{ id: 'base', title: 'Base', content: 'You are a helpful assistant.' }],
         }

package/dist/commands/clint-project-publish.d.ts

@@ -13,4 +13,9 @@ export declare const clintProjectPublish: import("@powerhousedao/ph-clint").Comm
 }, z.core.$strip>, {
     text: string;
     data: import("@powerhousedao/ph-clint-dev/publish").PublishResult;
-}, Record<string, unknown>>;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [import("document-model").DocumentModelModule<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>]>>;

package/dist/commands/clint-project-publish.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { defineCommand } from '@powerhousedao/ph-clint';
+import { defineCommand } from '../framework.js';
 import { z } from 'zod';
 import { resolvePublishPlan, buildPackages, publishPackages, } from '@powerhousedao/ph-clint-dev/publish';
 const inputSchema = z.object({

package/dist/commands/clint-project-regen.d.ts

@@ -15,4 +15,9 @@ export declare const regen: import("@powerhousedao/ph-clint").Command<z.ZodObjec
         migrated: boolean;
         warnings: string[];
     };
-}, Record<string, unknown>>;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [import("document-model").DocumentModelModule<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>]>>;

package/dist/commands/clint-project-regen.js

@@ -7,7 +7,7 @@
  * migration fires first.
  */
 import path from 'node:path';
-import { defineCommand } from '@powerhousedao/ph-clint';
+import { defineCommand } from '../framework.js';
 import { z } from 'zod';
 import { readProjectSpec } from '../spec/file.js';
 import { generateProject } from '../codegen/index.js';

package/dist/commands/clint-skills-sync.d.ts

@@ -7,4 +7,9 @@ export declare const skillsSync: import("@powerhousedao/ph-clint").Command<z.Zod
 } | {
     text: string;
     data: import("../skills/sync.js").SyncResult;
-}, Record<string, unknown>>;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [import("document-model").DocumentModelModule<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>]>>;

package/dist/commands/clint-skills-sync.js

@@ -4,7 +4,7 @@
  * longer referenced, and updates `.skills-manifest.json`.
  */
 import path from 'node:path';
-import { defineCommand } from '@powerhousedao/ph-clint';
+import { defineCommand } from '../framework.js';
 import { z } from 'zod';
 import { readProjectSpec } from '../spec/file.js';
 import { syncExternalSkills } from '../skills/sync.js';

package/dist/framework.d.ts

@@ -36,7 +36,7 @@ export declare const defineCommand: <TInput extends z.ZodType, TOutput = unknown
     devServicePort: number;
     phVersion: string;
     apiKey?: string | undefined;
-}>, defineTrigger: <TState = Record<string, unknown>>(options: import("@powerhousedao/ph-clint").TriggerOptions<TState, {
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [import("document-model").DocumentModelModule<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>]>>, defineTrigger: <TState = Record<string, unknown>>(options: import("@powerhousedao/ph-clint").TriggerOptions<TState, {
     model: string;
     devServicePort: number;
     phVersion: string;

package/dist/spec/types.d.ts

@@ -143,3 +143,22 @@ export declare function getDocumentTypeSlug(documentType: string): string;
  * it needs both for the import and the `defineRegistry` entry.
  */
 export declare function getDocumentTypeModuleName(documentType: string): string;
+/**
+ * Returns true when a documentType entry contains glob wildcards (`*`).
+ * Glob entries like `*​/*`, `powerhouse/*`, or `powerhouse/doc-*` are spec
+ * shorthand meaning "all matching document types from this package" and
+ * must be resolved at runtime rather than emitted as static imports.
+ */
+export declare function isDocTypeGlob(documentType: string): boolean;
+/**
+ * Convert a documentType glob pattern to a regex source string suitable
+ * for embedding in a `/pattern/` literal.  Each `*` matches any non-`/`
+ * characters. Forward slashes are escaped so the output is safe inside
+ * `/.../`.
+ *
+ * Examples:
+ *   `*​/*`            → `^[^\/]*\/[^\/]*$`   (any org, any name)
+ *   `powerhouse/*`   → `^powerhouse\/[^\/]*$`
+ *   `powerhouse/doc-*` → `^powerhouse\/doc-[^\/]*$`
+ */
+export declare function docTypeGlobToRegex(pattern: string): string;

package/dist/spec/types.js

@@ -182,3 +182,28 @@ export function getDocumentTypeModuleName(documentType) {
         .map((s) => s[0].toUpperCase() + s.slice(1))
         .join('');
 }
+/**
+ * Returns true when a documentType entry contains glob wildcards (`*`).
+ * Glob entries like `*​/*`, `powerhouse/*`, or `powerhouse/doc-*` are spec
+ * shorthand meaning "all matching document types from this package" and
+ * must be resolved at runtime rather than emitted as static imports.
+ */
+export function isDocTypeGlob(documentType) {
+    return documentType.includes('*');
+}
+/**
+ * Convert a documentType glob pattern to a regex source string suitable
+ * for embedding in a `/pattern/` literal.  Each `*` matches any non-`/`
+ * characters. Forward slashes are escaped so the output is safe inside
+ * `/.../`.
+ *
+ * Examples:
+ *   `*​/*`            → `^[^\/]*\/[^\/]*$`   (any org, any name)
+ *   `powerhouse/*`   → `^powerhouse\/[^\/]*$`
+ *   `powerhouse/doc-*` → `^powerhouse\/doc-[^\/]*$`
+ */
+export function docTypeGlobToRegex(pattern) {
+    const escaped = pattern.replace(/[.+?^${}()|[\]\\\/]/g, '\\$&');
+    const withWildcards = escaped.replace(/\*/g, '[^\\/]*');
+    return `^${withWildcards}$`;
+}

package/dist/triggers/publish-trigger.js

@@ -18,7 +18,6 @@
  *      b. Runs `ph-clint clint-project-publish --tag <tag>`.
  *      c. Dispatches SET_PUBLISH_STATUS({ id, status: "Succeeded"|"Failed" }).
  */
-import { spawn } from 'node:child_process';
 import path from 'node:path';
 import { scanProjects, getProjectMapping } from '@powerhousedao/ph-clint';
 import { setPublishStatus } from '@powerhousedao/ph-clint-app';
@@ -27,37 +26,6 @@ import { specFromDocumentState } from '../spec/from-document.js';
 import { clintProject } from '../services/clint-project.js';
 const DOCUMENT_TYPE = 'powerhouse/ph-clint-project';
 const TAG = '[publish]';
-/** Run a shell command and return stdout. Rejects on non-zero exit. */
-function exec(cmd, args, cwd, onLog) {
-    return new Promise((resolve, reject) => {
-        const proc = spawn(cmd, args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] });
-        const out = [];
-        const err = [];
-        proc.stdout?.on('data', (d) => {
-            const s = d.toString();
-            out.push(s);
-            if (onLog)
-                for (const line of s.split('\n'))
-                    if (line.trim())
-                        onLog(line.trim());
-        });
-        proc.stderr?.on('data', (d) => {
-            const s = d.toString();
-            err.push(s);
-            if (onLog)
-                for (const line of s.split('\n'))
-                    if (line.trim())
-                        onLog(line.trim());
-        });
-        proc.on('error', reject);
-        proc.on('close', (code) => {
-            if (code === 0)
-                resolve(out.join(''));
-            else
-                reject(new Error(`${cmd} ${args.join(' ')} exited ${code}\n${err.join('')}`));
-        });
-    });
-}
 /** Map document model PublishTag values to CLI --tag values. */
 export function tagToCli(tag) {
     switch (tag) {
@@ -107,6 +75,7 @@ export const publishTrigger = createDocumentChangeTrigger({
                 continue;
             }
             log?.info(`${TAG} found pending ${record.tag} publish for doc ${doc.header.id} (id=${record.id}, version=${record.version})`);
+            const { runProcess, stdout } = ctx.context;
             return {
                 type: 'function',
                 params: {
@@ -122,25 +91,20 @@ export const publishTrigger = createDocumentChangeTrigger({
                             setPublishStatus({ id: record.id, status: 'InProgress' }),
                         ]);
                         // Install dependencies in the generated project before publishing.
-                        log?.info(`${TAG} running pnpm install in ${workdir}`);
-                        try {
-                            await exec('pnpm', ['install'], workdir, (msg) => log?.debug(`${TAG} [install] ${msg}`));
-                        }
-                        catch (installErr) {
-                            log?.error(`${TAG} pnpm install failed: ${installErr instanceof Error ? installErr.message : String(installErr)}`);
+                        stdout(`${TAG} running pnpm install in ${workdir}\n`);
+                        const installResult = await runProcess('pnpm install', {
+                            cwd: workdir,
+                            timeout: 300_000,
+                        });
+                        if (!installResult.success) {
+                            log?.error(`${TAG} pnpm install failed in ${workdir}`);
                         }
                         // Run the publish command.
                         let success = false;
                         try {
-                            log?.info(`${TAG} invoking clint-project-publish --tag ${cliTag}`);
+                            stdout(`${TAG} invoking clint-project-publish --tag ${cliTag}\n`);
                             const { clintProjectPublish } = await import('../commands/clint-project-publish.js');
-                            const result = await clintProjectPublish.execute({ tag: cliTag, dryRun: false, skipBuild: false, skipGitCheck: true, verbose: false }, 
-                            // @ts-expect-error — minimal context; publish uses workdir + stdout.
-                            {
-                                workdir,
-                                stdout: (msg) => log?.info(`${TAG} ${msg}`),
-                                log,
-                            });
+                            const result = await clintProjectPublish.execute({ tag: cliTag, dryRun: false, skipBuild: false, skipGitCheck: true, verbose: false }, ctx.commandContext);
                             success = !result.text.includes('failed');
                         }
                         catch (err) {
@@ -148,7 +112,7 @@ export const publishTrigger = createDocumentChangeTrigger({
                         }
                         // Update status.
                         const finalStatus = success ? 'Succeeded' : 'Failed';
-                        log?.info(`${TAG} marking record ${record.id} as ${finalStatus}`);
+                        stdout(`${TAG} marking record ${record.id} as ${finalStatus}\n`);
                         await reactor.client.execute(doc.header.id, 'main', [
                             setPublishStatus({
                                 id: record.id,

package/dist/triggers/spec-change.js

@@ -187,8 +187,10 @@ export const specChangeTrigger = createDocumentChangeTrigger({
                     log.warn(`${TAG} ${w}`);
             }
             // Run post-generation actions (ph-init, install, build, skills-sync).
+            // Route through ctx.context.stdout so output flows through
+            // routine.onOutput → service log buffer → ServicePanel.
             await runPostGenActions(result.pendingActions, {
-                log: (msg) => log?.info(`${TAG} ${msg}`),
+                log: (msg) => ctx.context.stdout(`${TAG} ${msg}\n`),
                 runProcess: ctx.context.runProcess,
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/ph-clint-cli",
-  "version": "0.1.0-dev.50",
+  "version": "0.1.0-dev.52",
   "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.50",
-    "@powerhousedao/ph-clint-app": "^0.1.0-dev.50",
-    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.50",
+    "@powerhousedao/ph-clint": "^0.1.0-dev.52",
+    "@powerhousedao/ph-clint-app": "^0.1.0-dev.52",
+    "@powerhousedao/ph-clint-dev": "^0.1.0-dev.52",
     "@powerhousedao/reactor": "6.0.0-dev.170",
     "@powerhousedao/reactor-api": "6.0.0-dev.170",
     "@powerhousedao/shared": "6.0.0-dev.170",