@powerhousedao/ph-clint-cli 0.1.0-dev.8 → 0.1.0-dev.80

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({
@@ -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.js');
         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-project-regen.d.ts

@@ -15,4 +15,80 @@ 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 [{
+    readonly version: 1;
+    readonly reducer: import("document-model").Reducer<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly actions: {
+        setAgentModel: (input: import("@powerhousedao/ph-clint-app").SetAgentModelInput) => import("@powerhousedao/ph-clint-app").SetAgentModelAction;
+        addAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").AddAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").AddAgentProfileRefAction;
+        removeAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefAction;
+        reorderAgentProfileRefs: (input: import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsInput) => import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsAction;
+        addAgentSkill: (input: import("@powerhousedao/ph-clint-app").AddAgentSkillInput) => import("@powerhousedao/ph-clint-app").AddAgentSkillAction;
+        removeAgentSkill: (input: import("@powerhousedao/ph-clint-app").RemoveAgentSkillInput) => import("@powerhousedao/ph-clint-app").RemoveAgentSkillAction;
+        addAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").AddAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").AddAgentToolPatternAction;
+        removeAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternAction;
+        addSubAgent: (input: import("@powerhousedao/ph-clint-app").AddSubAgentInput) => import("@powerhousedao/ph-clint-app").AddSubAgentAction;
+        removeSubAgent: (input: import("@powerhousedao/ph-clint-app").RemoveSubAgentInput) => import("@powerhousedao/ph-clint-app").RemoveSubAgentAction;
+        setSubAgentName: (input: import("@powerhousedao/ph-clint-app").SetSubAgentNameInput) => import("@powerhousedao/ph-clint-app").SetSubAgentNameAction;
+        setSubAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionAction;
+        setMainAgentName: (input: import("@powerhousedao/ph-clint-app").SetMainAgentNameInput) => import("@powerhousedao/ph-clint-app").SetMainAgentNameAction;
+        setMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionAction;
+        clearMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionAction;
+        setMainAgentImage: (input: import("@powerhousedao/ph-clint-app").SetMainAgentImageInput) => import("@powerhousedao/ph-clint-app").SetMainAgentImageAction;
+        clearMainAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentImageAction;
+        addProfile: (input: import("@powerhousedao/ph-clint-app").AddProfileInput) => import("@powerhousedao/ph-clint-app").AddProfileAction;
+        updateProfile: (input: import("@powerhousedao/ph-clint-app").UpdateProfileInput) => import("@powerhousedao/ph-clint-app").UpdateProfileAction;
+        removeProfile: (input: import("@powerhousedao/ph-clint-app").RemoveProfileInput) => import("@powerhousedao/ph-clint-app").RemoveProfileAction;
+        reorderProfiles: (input: import("@powerhousedao/ph-clint-app").ReorderProfilesInput) => import("@powerhousedao/ph-clint-app").ReorderProfilesAction;
+        addModel: (input: import("@powerhousedao/ph-clint-app").AddModelInput) => import("@powerhousedao/ph-clint-app").AddModelAction;
+        removeModel: (input: import("@powerhousedao/ph-clint-app").RemoveModelInput) => import("@powerhousedao/ph-clint-app").RemoveModelAction;
+        enableMastra: (input: import("@powerhousedao/ph-clint-app").EnableMastraInput) => import("@powerhousedao/ph-clint-app").EnableMastraAction;
+        disableMastra: (input: import("@powerhousedao/ph-clint-app").DisableMastraInput) => import("@powerhousedao/ph-clint-app").DisableMastraAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        addSupportedResource: (input: import("@powerhousedao/ph-clint-app").AddSupportedResourceInput) => import("@powerhousedao/ph-clint-app").AddSupportedResourceAction;
+        removeSupportedResource: (input: import("@powerhousedao/ph-clint-app").RemoveSupportedResourceInput) => import("@powerhousedao/ph-clint-app").RemoveSupportedResourceAction;
+        setProxyEnabled: (input: import("@powerhousedao/ph-clint-app").SetProxyEnabledInput) => import("@powerhousedao/ph-clint-app").SetProxyEnabledAction;
+        setObservabilityEnabled: (input: import("@powerhousedao/ph-clint-app").SetObservabilityEnabledInput) => import("@powerhousedao/ph-clint-app").SetObservabilityEnabledAction;
+        importSpec: (input: import("@powerhousedao/ph-clint-app").ImportSpecInput) => import("@powerhousedao/ph-clint-app").ImportSpecAction;
+        bumpVersion: (input: import("@powerhousedao/ph-clint-app").BumpVersionInput) => import("@powerhousedao/ph-clint-app").BumpVersionAction;
+        publishDev: (input: import("@powerhousedao/ph-clint-app").PublishDevInput) => import("@powerhousedao/ph-clint-app").PublishDevAction;
+        publishStaging: (input: import("@powerhousedao/ph-clint-app").PublishStagingInput) => import("@powerhousedao/ph-clint-app").PublishStagingAction;
+        publishProduction: (input: import("@powerhousedao/ph-clint-app").PublishProductionInput) => import("@powerhousedao/ph-clint-app").PublishProductionAction;
+        setPublishStatus: (input: import("@powerhousedao/ph-clint-app").SetPublishStatusInput) => import("@powerhousedao/ph-clint-app").SetPublishStatusAction;
+        addExternalSkill: (input: import("@powerhousedao/ph-clint-app").AddExternalSkillInput) => import("@powerhousedao/ph-clint-app").AddExternalSkillAction;
+        removeExternalSkill: (input: import("@powerhousedao/ph-clint-app").RemoveExternalSkillInput) => import("@powerhousedao/ph-clint-app").RemoveExternalSkillAction;
+        setExternalSkillName: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillNameInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillNameAction;
+        setExternalSkillGithubUrl: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlAction;
+        addPowerhousePackage: (input: import("@powerhousedao/ph-clint-app").AddPowerhousePackageInput) => import("@powerhousedao/ph-clint-app").AddPowerhousePackageAction;
+        removePowerhousePackage: (input: import("@powerhousedao/ph-clint-app").RemovePowerhousePackageInput) => import("@powerhousedao/ph-clint-app").RemovePowerhousePackageAction;
+        addPackageDocumentType: (input: import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeAction;
+        removePackageDocumentType: (input: import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeAction;
+        setPackageVersion: (input: import("@powerhousedao/ph-clint-app").SetPackageVersionInput) => import("@powerhousedao/ph-clint-app").SetPackageVersionAction;
+        enableRoutine: (input: import("@powerhousedao/ph-clint-app").EnableRoutineInput) => import("@powerhousedao/ph-clint-app").EnableRoutineAction;
+        disableRoutine: (input: import("@powerhousedao/ph-clint-app").DisableRoutineInput) => import("@powerhousedao/ph-clint-app").DisableRoutineAction;
+        setPowerhouseLevel: (input: import("@powerhousedao/ph-clint-app").SetPowerhouseLevelInput) => import("@powerhousedao/ph-clint-app").SetPowerhouseLevelAction;
+        setDescription: (input: import("@powerhousedao/ph-clint-app").SetDescriptionInput) => import("@powerhousedao/ph-clint-app").SetDescriptionAction;
+        setVersion: (input: import("@powerhousedao/ph-clint-app").SetVersionInput) => import("@powerhousedao/ph-clint-app").SetVersionAction;
+        setPackageIdentifier: (input: import("@powerhousedao/ph-clint-app").SetPackageIdentifierInput) => import("@powerhousedao/ph-clint-app").SetPackageIdentifierAction;
+        setName: (name: string | {
+            name: string;
+        }) => import("document-model").SetNameAction;
+        setPreferredEditor: (input: string | null | {
+            preferredEditor: string | null;
+        }) => import("document-model").SetPreferredEditorAction;
+        undo: (count?: number, scope?: string) => import("document-model").UndoAction;
+        redo: (count?: number, scope?: string) => import("document-model").RedoAction;
+        prune: (start?: number, end?: number, scope?: string) => import("document-model").SchemaPruneAction;
+        loadState: <TState extends import("document-model").PHBaseState = import("document-model").PHBaseState>(state: TState & {
+            name: string;
+        }, operations: number) => import("document-model").LoadStateAction;
+        noop: (scope?: string) => import("document-model").NOOPAction;
+    };
+    readonly utils: import("document-model").DocumentModelUtils<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly documentModel: import("document-model").DocumentModelPHState;
+}]>>;

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

@@ -7,10 +7,12 @@
  * 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';
+import { runPostGenActions } from '@powerhousedao/ph-clint-dev/codegen/actions';
+import { ensureSpecDocument } from '../spec/ensure-document.js';
 const inputSchema = z.object({
     dir: z
         .string()
@@ -25,7 +27,7 @@ export const regen = defineCommand({
     id: 'clint-project-regen',
     description: 'Regenerate project files from the persisted spec',
     inputSchema,
-    execute: async (input, { workdir, stdout, log }) => {
+    execute: async (input, { workdir, stdout, log, runProcess, reactor: getReactor, folders }) => {
         const targetDir = path.resolve(workdir, input.dir ?? '.');
         const spec = await readProjectSpec(targetDir);
         if (!spec) {
@@ -52,7 +54,29 @@ export const regen = defineCommand({
             else
                 stdout('warning: ' + w + '\n');
         }
+        // Ensure spec document exists in drive (recover if deleted)
+        if (getReactor && folders) {
+            try {
+                const reactor = await getReactor();
+                if (reactor) {
+                    const { docId, created } = await ensureSpecDocument({
+                        spec, targetDir, reactor, folders,
+                    });
+                    if (created) {
+                        lines.push(`Created spec document ${docId} in Clint Folders/specs/${spec.name}`);
+                    }
+                }
+            }
+            catch (err) {
+                log?.warn(`Could not ensure spec document: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
         stdout(lines.join('\n') + '\n');
+        // Run post-generation actions (install, build, skills-sync).
+        await runPostGenActions(result.pendingActions, {
+            log: (msg) => stdout(msg + '\n'),
+            runProcess,
+        });
         return {
             text: lines.join('\n'),
             data: {

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

@@ -0,0 +1,86 @@
+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("@powerhousedao/ph-clint-dev/skills/sync").SyncResult;
+}, {
+    model: string;
+    devServicePort: number;
+    phVersion: string;
+    apiKey?: string | undefined;
+}, import("@powerhousedao/ph-clint").InferRegistry<readonly [{
+    readonly version: 1;
+    readonly reducer: import("document-model").Reducer<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly actions: {
+        setAgentModel: (input: import("@powerhousedao/ph-clint-app").SetAgentModelInput) => import("@powerhousedao/ph-clint-app").SetAgentModelAction;
+        addAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").AddAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").AddAgentProfileRefAction;
+        removeAgentProfileRef: (input: import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefInput) => import("@powerhousedao/ph-clint-app").RemoveAgentProfileRefAction;
+        reorderAgentProfileRefs: (input: import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsInput) => import("@powerhousedao/ph-clint-app").ReorderAgentProfileRefsAction;
+        addAgentSkill: (input: import("@powerhousedao/ph-clint-app").AddAgentSkillInput) => import("@powerhousedao/ph-clint-app").AddAgentSkillAction;
+        removeAgentSkill: (input: import("@powerhousedao/ph-clint-app").RemoveAgentSkillInput) => import("@powerhousedao/ph-clint-app").RemoveAgentSkillAction;
+        addAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").AddAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").AddAgentToolPatternAction;
+        removeAgentToolPattern: (input: import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternInput) => import("@powerhousedao/ph-clint-app").RemoveAgentToolPatternAction;
+        addSubAgent: (input: import("@powerhousedao/ph-clint-app").AddSubAgentInput) => import("@powerhousedao/ph-clint-app").AddSubAgentAction;
+        removeSubAgent: (input: import("@powerhousedao/ph-clint-app").RemoveSubAgentInput) => import("@powerhousedao/ph-clint-app").RemoveSubAgentAction;
+        setSubAgentName: (input: import("@powerhousedao/ph-clint-app").SetSubAgentNameInput) => import("@powerhousedao/ph-clint-app").SetSubAgentNameAction;
+        setSubAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetSubAgentDescriptionAction;
+        setMainAgentName: (input: import("@powerhousedao/ph-clint-app").SetMainAgentNameInput) => import("@powerhousedao/ph-clint-app").SetMainAgentNameAction;
+        setMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetMainAgentDescriptionAction;
+        clearMainAgentDescription: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentDescriptionAction;
+        setMainAgentImage: (input: import("@powerhousedao/ph-clint-app").SetMainAgentImageInput) => import("@powerhousedao/ph-clint-app").SetMainAgentImageAction;
+        clearMainAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearMainAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearMainAgentImageAction;
+        addProfile: (input: import("@powerhousedao/ph-clint-app").AddProfileInput) => import("@powerhousedao/ph-clint-app").AddProfileAction;
+        updateProfile: (input: import("@powerhousedao/ph-clint-app").UpdateProfileInput) => import("@powerhousedao/ph-clint-app").UpdateProfileAction;
+        removeProfile: (input: import("@powerhousedao/ph-clint-app").RemoveProfileInput) => import("@powerhousedao/ph-clint-app").RemoveProfileAction;
+        reorderProfiles: (input: import("@powerhousedao/ph-clint-app").ReorderProfilesInput) => import("@powerhousedao/ph-clint-app").ReorderProfilesAction;
+        addModel: (input: import("@powerhousedao/ph-clint-app").AddModelInput) => import("@powerhousedao/ph-clint-app").AddModelAction;
+        removeModel: (input: import("@powerhousedao/ph-clint-app").RemoveModelInput) => import("@powerhousedao/ph-clint-app").RemoveModelAction;
+        enableMastra: (input: import("@powerhousedao/ph-clint-app").EnableMastraInput) => import("@powerhousedao/ph-clint-app").EnableMastraAction;
+        disableMastra: (input: import("@powerhousedao/ph-clint-app").DisableMastraInput) => import("@powerhousedao/ph-clint-app").DisableMastraAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        addSupportedResource: (input: import("@powerhousedao/ph-clint-app").AddSupportedResourceInput) => import("@powerhousedao/ph-clint-app").AddSupportedResourceAction;
+        removeSupportedResource: (input: import("@powerhousedao/ph-clint-app").RemoveSupportedResourceInput) => import("@powerhousedao/ph-clint-app").RemoveSupportedResourceAction;
+        setProxyEnabled: (input: import("@powerhousedao/ph-clint-app").SetProxyEnabledInput) => import("@powerhousedao/ph-clint-app").SetProxyEnabledAction;
+        setObservabilityEnabled: (input: import("@powerhousedao/ph-clint-app").SetObservabilityEnabledInput) => import("@powerhousedao/ph-clint-app").SetObservabilityEnabledAction;
+        importSpec: (input: import("@powerhousedao/ph-clint-app").ImportSpecInput) => import("@powerhousedao/ph-clint-app").ImportSpecAction;
+        bumpVersion: (input: import("@powerhousedao/ph-clint-app").BumpVersionInput) => import("@powerhousedao/ph-clint-app").BumpVersionAction;
+        publishDev: (input: import("@powerhousedao/ph-clint-app").PublishDevInput) => import("@powerhousedao/ph-clint-app").PublishDevAction;
+        publishStaging: (input: import("@powerhousedao/ph-clint-app").PublishStagingInput) => import("@powerhousedao/ph-clint-app").PublishStagingAction;
+        publishProduction: (input: import("@powerhousedao/ph-clint-app").PublishProductionInput) => import("@powerhousedao/ph-clint-app").PublishProductionAction;
+        setPublishStatus: (input: import("@powerhousedao/ph-clint-app").SetPublishStatusInput) => import("@powerhousedao/ph-clint-app").SetPublishStatusAction;
+        addExternalSkill: (input: import("@powerhousedao/ph-clint-app").AddExternalSkillInput) => import("@powerhousedao/ph-clint-app").AddExternalSkillAction;
+        removeExternalSkill: (input: import("@powerhousedao/ph-clint-app").RemoveExternalSkillInput) => import("@powerhousedao/ph-clint-app").RemoveExternalSkillAction;
+        setExternalSkillName: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillNameInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillNameAction;
+        setExternalSkillGithubUrl: (input: import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlInput) => import("@powerhousedao/ph-clint-app").SetExternalSkillGithubUrlAction;
+        addPowerhousePackage: (input: import("@powerhousedao/ph-clint-app").AddPowerhousePackageInput) => import("@powerhousedao/ph-clint-app").AddPowerhousePackageAction;
+        removePowerhousePackage: (input: import("@powerhousedao/ph-clint-app").RemovePowerhousePackageInput) => import("@powerhousedao/ph-clint-app").RemovePowerhousePackageAction;
+        addPackageDocumentType: (input: import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").AddPackageDocumentTypeAction;
+        removePackageDocumentType: (input: import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app").RemovePackageDocumentTypeAction;
+        setPackageVersion: (input: import("@powerhousedao/ph-clint-app").SetPackageVersionInput) => import("@powerhousedao/ph-clint-app").SetPackageVersionAction;
+        enableRoutine: (input: import("@powerhousedao/ph-clint-app").EnableRoutineInput) => import("@powerhousedao/ph-clint-app").EnableRoutineAction;
+        disableRoutine: (input: import("@powerhousedao/ph-clint-app").DisableRoutineInput) => import("@powerhousedao/ph-clint-app").DisableRoutineAction;
+        setPowerhouseLevel: (input: import("@powerhousedao/ph-clint-app").SetPowerhouseLevelInput) => import("@powerhousedao/ph-clint-app").SetPowerhouseLevelAction;
+        setDescription: (input: import("@powerhousedao/ph-clint-app").SetDescriptionInput) => import("@powerhousedao/ph-clint-app").SetDescriptionAction;
+        setVersion: (input: import("@powerhousedao/ph-clint-app").SetVersionInput) => import("@powerhousedao/ph-clint-app").SetVersionAction;
+        setPackageIdentifier: (input: import("@powerhousedao/ph-clint-app").SetPackageIdentifierInput) => import("@powerhousedao/ph-clint-app").SetPackageIdentifierAction;
+        setName: (name: string | {
+            name: string;
+        }) => import("document-model").SetNameAction;
+        setPreferredEditor: (input: string | null | {
+            preferredEditor: string | null;
+        }) => import("document-model").SetPreferredEditorAction;
+        undo: (count?: number, scope?: string) => import("document-model").UndoAction;
+        redo: (count?: number, scope?: string) => import("document-model").RedoAction;
+        prune: (start?: number, end?: number, scope?: string) => import("document-model").SchemaPruneAction;
+        loadState: <TState extends import("document-model").PHBaseState = import("document-model").PHBaseState>(state: TState & {
+            name: string;
+        }, operations: number) => import("document-model").LoadStateAction;
+        noop: (scope?: string) => import("document-model").NOOPAction;
+    };
+    readonly utils: import("document-model").DocumentModelUtils<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly documentModel: import("document-model").DocumentModelPHState;
+}]>>;

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 '../framework.js';
+import { z } from 'zod';
+import { readProjectSpec } from '../spec/file.js';
+import { syncExternalSkills } from '@powerhousedao/ph-clint-dev/skills/sync';
+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,
+        };
+    },
+});