@powerhousedao/ph-clint-cli 0.1.0-dev.15 → 0.1.0-dev.17

package/dist/cli.js

@@ -19,7 +19,9 @@ 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 appDir = path.resolve(CLI_ROOT, '../ph-clint-app');
@@ -34,13 +36,13 @@ export const cli = defineCli({
     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: {

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,7 +4,7 @@
  * 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';
+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
@@ -41,7 +41,7 @@ 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);
@@ -54,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',
@@ -77,12 +85,13 @@ export function buildCliPackageJson(spec) {
     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', 'prompts'];
     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,7 +15,7 @@ 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) {
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push(`import path from 'node:path';`);
         lines.push(`import { existsSync } from 'node:fs';`);
         lines.push(`import { defineCli, buildDefaultReactor } from '@powerhousedao/ph-clint';`);
@@ -16,22 +23,22 @@ export function buildCliTs(spec) {
     else {
         lines.push(`import { defineCli } from '@powerhousedao/ph-clint';`);
     }
-    lines.push(`import { CLI_NAME, CLI_VERSION${powerhouse.enabled ? ', CLI_ROOT' : ''} } 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) {
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push(`const appDir = path.resolve(CLI_ROOT, '../${spec.name}-app');`);
         lines.push('');
-        if (powerhouse.connect) {
+        if (phAtLeast(ph, 'Connect')) {
             lines.push('function resolveConnectAssets(dir: string): string | undefined {');
             lines.push("  const assetsDir = path.join(dir, 'dist', 'connect');");
             lines.push("  return existsSync(path.join(assetsDir, 'index.html')) ? assetsDir : undefined;");
@@ -78,7 +85,7 @@ export function buildCliTs(spec) {
     lines.push('  // @clint:begin interactive');
     lines.push('  interactive: {');
     const ctxArgs = [];
-    if (powerhouse.enabled && (powerhouse.switchboard || powerhouse.connect)) {
+    if (phAtLeast(ph, 'Switchboard')) {
         ctxArgs.push('config');
     }
     ctxArgs.push('workdir');
@@ -86,10 +93,10 @@ export function buildCliTs(spec) {
     lines.push('      [');
     lines.push('        `${CLI_NAME} v${CLI_VERSION}`,');
     lines.push('        `Workdir: ${workdir}`,');
-    if (powerhouse.enabled && powerhouse.switchboard) {
+    if (phAtLeast(ph, 'Switchboard')) {
         lines.push('        `Switchboard: http://localhost:${config.switchboardPort}`,');
     }
-    if (powerhouse.enabled && powerhouse.connect) {
+    if (phAtLeast(ph, 'Connect')) {
         lines.push('        `Connect:     http://localhost:${config.connectPort}`,');
     }
     lines.push("        '',");
@@ -105,15 +112,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)} },`);
-        if (powerhouse.connect) {
+        lines.push(`  switchboard: { enabled: ${String(phAtLeast(ph, 'Switchboard'))} },`);
+        if (phAtLeast(ph, 'Connect')) {
             lines.push(`  connect: { enabled: true, workdir: appDir, assetsDir: resolveConnectAssets(appDir) },`);
         }
         else {

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

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

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

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

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

@@ -1,6 +1,26 @@
+/**
+ * Builds `src/framework.ts` — the user-owned half of the typed-binding split.
+ *
+ * Emitted **only on create**. Once the file exists, codegen never overwrites
+ * it: users are expected to extend `configSchema` and `secretsSchema` here,
+ * and those edits must survive regens.
+ *
+ * Behavior differs by layout:
+ *
+ * - **Powerhouse enabled** — this file declares `configSchema`/`secretsSchema`
+ *   and re-exports `registry`, `defineCommand`, `defineTrigger`,
+ *   `defineService`, and `createDocumentChangeTrigger` from the companion
+ *   `framework.gen.ts`. Adding a document type to the spec regenerates
+ *   `framework.gen.ts`; this file keeps resolving its re-exports unchanged.
+ *
+ * - **Powerhouse disabled** — no reactor package exists to register modules
+ *   against, so this file binds `createTypes({ configSchema })` directly and
+ *   exports the typed factories from here. No `framework.gen.ts` is emitted.
+ */
+import { phAtLeast } from '../../spec/types.js';
 export function buildFrameworkTs(spec) {
     const { mastra, powerhouse } = spec.features;
-    const hasGen = powerhouse.enabled;
+    const hasGen = phAtLeast(powerhouse, 'Reactor');
     const lines = [];
     lines.push('/**');
     lines.push(' * Per-CLI typed framework binding.');

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

@@ -1,18 +1,21 @@
 export function buildPublishConfigTs(spec) {
     const app = `${spec.name}-app`;
     const cli = `${spec.name}-cli`;
-    return `import { definePublishConfig } from '@powerhousedao/ph-clint-dev/publish';
-
-export default definePublishConfig({
+    // 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: '${spec.version}',
+      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'}`);
@@ -32,7 +33,7 @@ export function buildReadme(spec) {
     lines.push('Toggle features or update metadata in `.ph/ph-clint-cli/project-spec.json`,');
     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.js

@@ -6,13 +6,13 @@
  * 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 = spec.features.powerhouse.enabled && spec.features.powerhouse.connect;
+    const connectEnabled = phAtLeast(spec.features.powerhouse, 'Connect');
     const buildScript = connectEnabled
         ? `${prefix(app, 'build')} && ${prefix(app, 'connect:build')} && ${prefix(cli, 'build')}`
         : both('build');

package/dist/codegen/index.js

@@ -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,7 +75,7 @@ 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 = [];
@@ -201,13 +201,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.js

@@ -31,6 +31,27 @@ export async function runPhInit(options) {
     if (result.exitCode !== 0) {
         log(`\`${binName} init\` exited with code ${result.exitCode}. ` +
             'You can re-run it manually after resolving the issue.');
+        return { ran: true, exitCode: result.exitCode };
+    }
+    // ph init creates an unscoped package name. If the spec has a scope, patch
+    // the app's package.json to use the scoped name so `file:` deps and publish
+    // both resolve correctly.
+    if (options.spec.scope) {
+        const appPkgJsonPath = path.join(options.appDir, 'package.json');
+        try {
+            const raw = await fs.readFile(appPkgJsonPath, 'utf8');
+            const pkg = JSON.parse(raw);
+            const scopedName = `@${options.spec.scope}/${appFolder}`;
+            if (pkg.name !== scopedName) {
+                pkg.name = scopedName;
+                pkg.publishConfig = { access: 'public' };
+                await fs.writeFile(appPkgJsonPath, JSON.stringify(pkg, null, 2) + '\n');
+                log(`Patched app package name to ${scopedName}`);
+            }
+        }
+        catch (err) {
+            log(`Warning: could not patch app package name: ${err instanceof Error ? err.message : String(err)}`);
+        }
     }
     return { ran: true, exitCode: result.exitCode };
 }

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

@@ -35,11 +35,7 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
             version: string;
             description: string;
             features: {
-                powerhouse: {
-                    enabled: boolean;
-                    switchboard: boolean;
-                    connect: boolean;
-                };
+                powerhouse: "Disabled" | "Reactor" | "Switchboard" | "Connect";
                 mastra: {
                     enabled: boolean;
                 };
@@ -47,7 +43,16 @@ export declare const init: import("@powerhousedao/ph-clint").Command<z.ZodObject
                     enabled: boolean;
                 };
             };
-            documentTypes: string[];
+            packages: {
+                id: string;
+                packageName: string;
+                documentTypes: string[];
+            }[];
+            externalSkills: {
+                id: string;
+                name: string;
+                githubUrl: string;
+            }[];
             scope?: string | undefined;
             bin?: string | undefined;
         };

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

@@ -2,7 +2,7 @@
  * `ph-clint clint-project-init` — the project bootstrap wizard.
  *
  * Behavior:
- *   1. Resolve target dir (positional `dir`, defaults to cwd).
+ *   1. Resolve target dir (positional `dir`, defaults to the project name).
  *   2. Assert it is empty (or `--force`).
  *   3. Collect project identity + feature toggles (prompt for missing).
  *   4. Assemble a ClintProjectSpec and validate with Zod.
@@ -22,7 +22,7 @@ const inputSchema = z.object({
     dir: z
         .string()
         .optional()
-        .describe('Target directory (defaults to the current directory)'),
+        .describe('Target directory (defaults to the project name)'),
     name: z
         .string()
         .describe('Project name — bare, or `@scope/name`. Lowercase letters, digits, hyphens.'),
@@ -75,7 +75,7 @@ export function buildSpec(input) {
         scope,
         description: input.description ?? '',
         features: {
-            powerhouse: { enabled: input.enablePowerhouse },
+            powerhouse: input.enablePowerhouse ? 'Connect' : 'Disabled',
             mastra: { enabled: input.enableMastra },
             routine: { enabled: routine },
         },
@@ -91,7 +91,8 @@ export const init = defineCommand({
         promptOptional: ['description'],
     },
     execute: async (input, { workdir, stdout }) => {
-        const targetDir = path.resolve(workdir, input.dir ?? '.');
+        const { name: bareName } = splitPackageName(input.name);
+        const targetDir = path.resolve(workdir, input.dir ?? bareName);
         if (!input.force) {
             const empty = await isDirEmptyEnough(targetDir);
             if (!empty) {
@@ -109,7 +110,7 @@ export const init = defineCommand({
             allowNonEmpty: input.force,
         });
         stdout(`Generated ${result.files.length} files in ${targetDir}\n`);
-        const split = spec.features.powerhouse.enabled;
+        const split = spec.features.powerhouse !== 'Disabled';
         // Reactor package scaffolding (split layout only).
         if (split && result.appDir && !input.skipPhInit) {
             const phResult = await runPhInit({

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

@@ -8,6 +8,7 @@ export declare const clintProjectPublish: import("@powerhousedao/ph-clint").Comm
     dir: z.ZodOptional<z.ZodString>;
     dryRun: z.ZodDefault<z.ZodBoolean>;
     skipBuild: z.ZodDefault<z.ZodBoolean>;
+    skipGitCheck: z.ZodDefault<z.ZodBoolean>;
     verbose: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>, {
     text: string;

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

@@ -7,6 +7,7 @@ const inputSchema = z.object({
     dir: z.string().optional().describe('Project root directory'),
     dryRun: z.boolean().default(false).describe('Preview without publishing'),
     skipBuild: z.boolean().default(false),
+    skipGitCheck: z.boolean().default(false).describe('Skip git working tree check'),
     verbose: z.boolean().default(false),
 });
 function formatPlanPreview(plan) {
@@ -34,11 +35,12 @@ export const clintProjectPublish = defineCommand({
             logLines.push(msg);
             stdout(msg + '\n');
         };
-        // 1. Resolve plan
+        // 1. Resolve plan — discover config from the target dir, not process.cwd().
+        const configFile = path.join(dir, 'publish.config.ts');
         const plan = await resolvePublishPlan({
             tag: input.tag,
-            configPath: undefined, // auto-discover from dir
-            skipGitCheck: input.dryRun,
+            configPath: configFile,
+            skipGitCheck: input.dryRun || input.skipGitCheck,
             log,
         });
         // 2. Show preview

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

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export declare const skillsSync: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, {
+    text: string;
+    data?: undefined;
+} | {
+    text: string;
+    data: import("../skills/sync.js").SyncResult;
+}, Record<string, unknown>>;