@powerhousedao/ph-clint-cli 0.1.0-dev.7 → 0.1.0-dev.71

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

@@ -2,27 +2,28 @@
  * `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.
  *   5. Write the spec + emit the generated tree via `generateProject`.
- *   6. (Split layout) run `ph init` in `{name}-app/` unless `--skip-ph-init`.
+ *   6. (Split layout) run `ph init` in `{name}-app/`.
  *   7. Run `pnpm install` in generated sub-projects unless `--skip-install`.
  *   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';
-import { isDirEmptyEnough } from '../codegen/write.js';
-import { runPhInit, runPnpmInstall } from '../codegen/scaffold.js';
+import { isDirEmptyEnough } from '@powerhousedao/ph-clint-dev/codegen/write';
+import { runPostGenActions } from '@powerhousedao/ph-clint-dev/codegen/actions';
+import { ensureSpecDocument } from '../spec/ensure-document.js';
 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.'),
@@ -39,47 +40,64 @@ const inputSchema = z.object({
         .boolean()
         .default(false)
         .describe('Enable the tick-based routine loop'),
-    force: z
+    enableObservability: z
         .boolean()
         .default(false)
-        .describe('Overwrite files if the target directory is not empty'),
-    skipPhInit: z
+        .describe('Wire @powerhousedao/ph-clint-observability into the generated CLI. ' +
+        'The generated CLI will ask its end-user for telemetry consent on first run.'),
+    force: z
         .boolean()
         .default(false)
-        .describe('Do not run `ph init` in the app folder after scaffolding'),
+        .describe('Overwrite files if the target directory is not empty'),
     skipInstall: z
         .boolean()
         .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: `${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.' }],
+        }
+        : { enabled: false };
     const candidate = {
         name,
         scope,
         description: input.description ?? '',
         features: {
-            powerhouse: { enabled: input.enablePowerhouse },
-            mastra: { enabled: input.enableMastra },
+            powerhouse: input.enablePowerhouse ? 'Connect' : 'Disabled',
+            mastra,
             routine: { enabled: routine },
         },
     };
+    if (input.enableObservability) {
+        candidate.deployment = { observabilityEnabled: true };
+    }
     return clintProjectSpecSchema.parse(candidate);
 }
 export const init = defineCommand({
@@ -90,8 +108,9 @@ export const init = defineCommand({
         promptForDefaults: true,
         promptOptional: ['description'],
     },
-    execute: async (input, { workdir, stdout }) => {
-        const targetDir = path.resolve(workdir, input.dir ?? '.');
+    execute: async (input, { workdir, stdout, reactor: getReactor, folders, runProcess }) => {
+        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,44 +128,41 @@ export const init = defineCommand({
             allowNonEmpty: input.force,
         });
         stdout(`Generated ${result.files.length} files in ${targetDir}\n`);
-        const split = spec.features.powerhouse.enabled;
-        // Reactor package scaffolding (split layout only).
-        if (split && result.appDir && !input.skipPhInit) {
-            const phResult = await runPhInit({
-                targetDir,
-                appDir: result.appDir,
-                spec,
-                log: (msg) => stdout(msg + '\n'),
-            });
-            if (!phResult.ran) {
-                stdout(`Note: \`ph init\` did not run — ${phResult.reason ?? 'see above'}.\n`);
-            }
-        }
-        // Dependency installation.
-        if (!input.skipInstall) {
-            const dirs = [];
-            if (split) {
-                if (result.appDir)
-                    dirs.push(result.appDir);
-                dirs.push(result.cliDir);
+        // Create spec document in personal drive (if reactor available)
+        if (getReactor && folders) {
+            try {
+                const reactor = await getReactor();
+                if (reactor) {
+                    const { docId } = await ensureSpecDocument({
+                        spec, targetDir, reactor, folders,
+                    });
+                    stdout(`Created spec document ${docId} in Clint Folders/specs/${spec.name}\n`);
+                }
             }
-            else {
-                dirs.push(targetDir);
+            catch (err) {
+                // Non-fatal — trigger will pick it up on next startup
+                stdout(`Note: could not create spec document — ${err instanceof Error ? err.message : String(err)}\n`);
             }
-            await runPnpmInstall({
-                dirs,
-                log: (msg) => stdout(msg + '\n'),
-            });
         }
+        // Run post-generation actions (ph-init, install, build, skills-sync).
+        // Only skip cli-install — in split layout, ph-init handles app install
+        // internally, and app-build must still run so the CLI can link to it.
+        const skip = new Set();
+        if (input.skipInstall) {
+            skip.add('cli-install');
+        }
+        await runPostGenActions(result.pendingActions, {
+            log: (msg) => stdout(msg + '\n'),
+            runProcess,
+            skip,
+        });
+        const split = spec.features.powerhouse !== 'Disabled';
         const next = [];
         next.push('');
         next.push('Next steps:');
         const relDir = path.relative(workdir, targetDir) || '.';
         if (split) {
             next.push(`  cd ${relDir}`);
-            if (input.skipPhInit) {
-                next.push(`  cd ${spec.name}-app && ph init . && cd ..`);
-            }
             if (input.skipInstall) {
                 next.push('  pnpm install');
             }

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

@@ -8,8 +8,71 @@ 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;
     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 [{
+    readonly version: 1;
+    readonly reducer: import("document-model").Reducer<import("@powerhousedao/ph-clint-app").PhClintProjectPHState>;
+    readonly actions: {
+        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;
+        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;
+        setAgentId: (input: import("@powerhousedao/ph-clint-app").SetAgentIdInput) => import("@powerhousedao/ph-clint-app").SetAgentIdAction;
+        setAgentName: (input: import("@powerhousedao/ph-clint-app").SetAgentNameInput) => import("@powerhousedao/ph-clint-app").SetAgentNameAction;
+        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;
+        setDefaultModel: (input: import("@powerhousedao/ph-clint-app").SetDefaultModelInput) => import("@powerhousedao/ph-clint-app").SetDefaultModelAction;
+        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;
+        setAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetAgentDescriptionAction;
+        setAgentImage: (input: import("@powerhousedao/ph-clint-app").SetAgentImageInput) => import("@powerhousedao/ph-clint-app").SetAgentImageAction;
+        clearAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearAgentImageAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        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;
+        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-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,66 @@ 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: {
+        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;
+        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;
+        setAgentId: (input: import("@powerhousedao/ph-clint-app").SetAgentIdInput) => import("@powerhousedao/ph-clint-app").SetAgentIdAction;
+        setAgentName: (input: import("@powerhousedao/ph-clint-app").SetAgentNameInput) => import("@powerhousedao/ph-clint-app").SetAgentNameAction;
+        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;
+        setDefaultModel: (input: import("@powerhousedao/ph-clint-app").SetDefaultModelInput) => import("@powerhousedao/ph-clint-app").SetDefaultModelAction;
+        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;
+        setAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetAgentDescriptionAction;
+        setAgentImage: (input: import("@powerhousedao/ph-clint-app").SetAgentImageInput) => import("@powerhousedao/ph-clint-app").SetAgentImageAction;
+        clearAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearAgentImageAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        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;
+        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,72 @@
+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: {
+        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;
+        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;
+        setAgentId: (input: import("@powerhousedao/ph-clint-app").SetAgentIdInput) => import("@powerhousedao/ph-clint-app").SetAgentIdAction;
+        setAgentName: (input: import("@powerhousedao/ph-clint-app").SetAgentNameInput) => import("@powerhousedao/ph-clint-app").SetAgentNameAction;
+        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;
+        setDefaultModel: (input: import("@powerhousedao/ph-clint-app").SetDefaultModelInput) => import("@powerhousedao/ph-clint-app").SetDefaultModelAction;
+        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;
+        setAgentDescription: (input: import("@powerhousedao/ph-clint-app").SetAgentDescriptionInput) => import("@powerhousedao/ph-clint-app").SetAgentDescriptionAction;
+        setAgentImage: (input: import("@powerhousedao/ph-clint-app").SetAgentImageInput) => import("@powerhousedao/ph-clint-app").SetAgentImageAction;
+        clearAgentImage: (input: import("@powerhousedao/ph-clint-app").ClearAgentImageInput) => import("@powerhousedao/ph-clint-app").ClearAgentImageAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app").SetEnableChatInput) => import("@powerhousedao/ph-clint-app").SetEnableChatAction;
+        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;
+        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,
+        };
+    },
+});