@powerhousedao/ph-clint-cli 0.1.0-dev.14 → 0.1.0-dev.16

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 { 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,11 +23,11 @@ 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) {
+    if (phAtLeast(ph, 'Reactor')) {
         lines.push(`import { documentModels } from '${spec.name}-app';`);
     }
     if (mastra.enabled) {
@@ -28,10 +35,10 @@ export function buildCliTs(spec) {
     }
     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/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 = [];

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) {
@@ -38,7 +39,7 @@ export const clintProjectPublish = defineCommand({
         const plan = await resolvePublishPlan({
             tag: input.tag,
             configPath: undefined, // auto-discover from dir
-            skipGitCheck: input.dryRun,
+            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>>;

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

@@ -0,0 +1,56 @@
+/**
+ * `ph-clint clint-skills-sync` — reconcile external skills on disk to match
+ * the project spec.  Clones missing skills from GitHub, removes skills no
+ * longer referenced, and updates `.skills-manifest.json`.
+ */
+import path from 'node:path';
+import { defineCommand } from '@powerhousedao/ph-clint';
+import { z } from 'zod';
+import { readProjectSpec } from '../spec/file.js';
+import { syncExternalSkills } from '../skills/sync.js';
+const inputSchema = z.object({
+    dir: z
+        .string()
+        .optional()
+        .describe('Project directory (defaults to the current directory)'),
+});
+export const skillsSync = defineCommand({
+    id: 'clint-skills-sync',
+    description: 'Synchronise external skills from the project spec',
+    inputSchema,
+    execute: async (input, { workdir, stdout, log }) => {
+        const targetDir = path.resolve(workdir, input.dir ?? '.');
+        const spec = await readProjectSpec(targetDir);
+        if (!spec) {
+            return {
+                text: `Error: no spec found at ${targetDir}/.ph/ph-clint-cli/project-spec.json.\n` +
+                    'Run `ph-clint clint-project-init` first to scaffold a new project.',
+            };
+        }
+        const result = await syncExternalSkills({
+            targetDir,
+            desired: spec.externalSkills,
+            log: (msg) => {
+                if (log)
+                    log.info(msg);
+                else
+                    stdout(msg + '\n');
+            },
+        });
+        const lines = [];
+        if (result.added.length > 0) {
+            lines.push(`Added: ${result.added.join(', ')}`);
+        }
+        if (result.removed.length > 0) {
+            lines.push(`Removed: ${result.removed.join(', ')}`);
+        }
+        if (result.added.length === 0 && result.removed.length === 0) {
+            lines.push('External skills are up to date.');
+        }
+        stdout(lines.join('\n') + '\n');
+        return {
+            text: lines.join('\n'),
+            data: result,
+        };
+    },
+});