@powerhousedao/ph-clint-cli 0.0.1

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

@@ -0,0 +1,193 @@
+/**
+ * `ph-clint clint-project-init` — the project bootstrap wizard.
+ *
+ * Behavior:
+ *   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/`.
+ *   7. Run `pnpm install` in generated sub-projects unless `--skip-install`.
+ *   8. Print next-steps guidance.
+ */
+import path from 'node:path';
+import { defineCommand } from '../framework.js';
+import { z } from 'zod';
+import { clintProjectSpecSchema, } from '../spec/types.js';
+import { generateProject } from '../codegen/index.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 project name)'),
+    name: z
+        .string()
+        .describe('Project name — bare, or `@scope/name`. Lowercase letters, digits, hyphens.'),
+    description: z.string().optional().describe('Short project description'),
+    enablePowerhouse: z
+        .boolean()
+        .default(false)
+        .describe('Enable Powerhouse reactor (requires split layout)'),
+    enableMastra: z
+        .boolean()
+        .default(false)
+        .describe('Enable Mastra AI agent stack'),
+    enableRoutine: z
+        .boolean()
+        .default(false)
+        .describe('Enable the tick-based routine loop'),
+    enableObservability: z
+        .boolean()
+        .default(false)
+        .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('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 }. 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) {
+        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`);
+    }
+    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,
+            models: [{ id: 'anthropic/claude-sonnet-4-5' }],
+            profiles: [{ id: 'base', title: 'Base', content: 'You are a helpful assistant.' }],
+            mainAgent: {
+                id: `${baseName}-agent`,
+                name: `${baseName.charAt(0).toUpperCase()}${baseName.slice(1).replace(/-(\w)/g, (_, c) => ' ' + c.toUpperCase())} Agent`,
+                description: null,
+                image: null,
+                modelId: 'anthropic/claude-sonnet-4-5',
+                profileIds: ['base'],
+                skills: [],
+                toolPatterns: [],
+            },
+            subAgents: [],
+        }
+        : { enabled: false };
+    const candidate = {
+        name,
+        scope,
+        description: input.description ?? '',
+        features: {
+            powerhouse: input.enablePowerhouse ? 'Connect' : 'Disabled',
+            mastra,
+            routine: { enabled: routine },
+        },
+    };
+    if (input.enableObservability) {
+        candidate.deployment = { observabilityEnabled: true };
+    }
+    return clintProjectSpecSchema.parse(candidate);
+}
+export const init = defineCommand({
+    id: 'clint-project-init',
+    description: 'Initialize a new ph-clint project in the target directory',
+    inputSchema,
+    prompt: {
+        promptForDefaults: true,
+        promptOptional: ['description'],
+    },
+    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) {
+                return {
+                    text: `Error: ${targetDir} is not empty. Re-run with --force to initialize anyway,\n` +
+                        'or choose a different --dir.',
+                };
+            }
+        }
+        const spec = buildSpec(input);
+        const result = await generateProject({
+            targetDir,
+            spec,
+            mode: 'create',
+            allowNonEmpty: input.force,
+        });
+        stdout(`Generated ${result.files.length} files in ${targetDir}\n`);
+        // 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`);
+                }
+            }
+            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`);
+            }
+        }
+        // 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.skipInstall) {
+                next.push('  pnpm install');
+            }
+            next.push('  pnpm dev');
+        }
+        else {
+            next.push(`  cd ${relDir}`);
+            if (input.skipInstall)
+                next.push('  pnpm install');
+            next.push('  pnpm dev');
+        }
+        next.push('');
+        next.push('Edit the project spec and run `ph-clint clint-project-regen` to regenerate.');
+        return {
+            text: next.join('\n'),
+            data: { targetDir, spec, fileCount: result.files.length },
+        };
+    },
+});

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

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+export declare const clintProjectPublish: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    tag: z.ZodEnum<{
+        dev: "dev";
+        staging: "staging";
+        production: "production";
+    }>;
+    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;
+}, {
+    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-publish.js

@@ -0,0 +1,73 @@
+import path from 'node:path';
+import { defineCommand } from '../framework.js';
+import { z } from 'zod';
+import { resolvePublishPlan, buildPackages, publishPackages, } from '@powerhousedao/ph-clint-dev/publish';
+const inputSchema = z.object({
+    tag: z.enum(['dev', 'staging', 'production']).describe('Release channel'),
+    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) {
+    const lines = [];
+    const distTag = plan.tag === 'production' ? 'latest' : plan.tag;
+    lines.push(`Publish plan:`);
+    lines.push(`  Group:    ${plan.groupName}`);
+    lines.push(`  Version:  ${plan.version}`);
+    lines.push(`  Tag:      ${distTag}`);
+    lines.push(`  Registry: ${plan.registry}`);
+    lines.push(`  Packages:`);
+    for (const pkg of plan.packages) {
+        lines.push(`    - ${pkg.name}`);
+    }
+    return lines.join('\n');
+}
+export const clintProjectPublish = defineCommand({
+    id: 'clint-project-publish',
+    description: 'Publish project packages to npm',
+    inputSchema,
+    execute: async (input, { workdir, stdout }) => {
+        const dir = path.resolve(input.dir ?? workdir);
+        const logLines = [];
+        const log = (msg) => {
+            logLines.push(msg);
+            stdout(msg + '\n');
+        };
+        // 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: configFile,
+            skipGitCheck: input.dryRun || input.skipGitCheck,
+            log,
+        });
+        // 2. Show preview
+        stdout(formatPlanPreview(plan) + '\n');
+        // 3. Build
+        if (!input.skipBuild) {
+            await buildPackages(plan, { verbose: input.verbose, log });
+        }
+        // 4. Publish (or dry-run)
+        const result = await publishPackages(plan, {
+            dryRun: input.dryRun,
+            verbose: input.verbose,
+            log,
+        });
+        if (result.success) {
+            return {
+                text: result.dryRun
+                    ? `Dry run complete — ${plan.packages.length} packages validated at ${result.version}.`
+                    : `Published ${result.published.length} packages at ${result.version}.`,
+                data: result,
+            };
+        }
+        else {
+            return {
+                text: `Publish failed. Published: ${result.published.length}, Failed: ${result.failed.length}.`,
+                data: result,
+            };
+        }
+    },
+});

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

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+export declare const regen: import("@powerhousedao/ph-clint").Command<z.ZodObject<{
+    dir: z.ZodOptional<z.ZodString>;
+    force: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, {
+    text: string;
+    data?: undefined;
+} | {
+    text: string;
+    data: {
+        mode: "create" | "update";
+        files: string[];
+        skipped: string[];
+        deleted: string[];
+        migrated: boolean;
+        warnings: string[];
+    };
+}, {
+    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

@@ -0,0 +1,92 @@
+/**
+ * `ph-clint clint-project-regen` — reconcile an existing project against its persisted
+ * spec. Equivalent to running the generator in update mode.
+ *
+ * Run inside a project directory (or pass `--dir`). If the spec has flipped
+ * `features.powerhouse.enabled` since the last run, the flat → split
+ * migration fires first.
+ */
+import path from 'node:path';
+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()
+        .optional()
+        .describe('Project directory (defaults to the current directory)'),
+    force: z
+        .boolean()
+        .default(false)
+        .describe('Overwrite user-edited managed files and bypass the git-dirty guard'),
+});
+export const regen = defineCommand({
+    id: 'clint-project-regen',
+    description: 'Regenerate project files from the persisted spec',
+    inputSchema,
+    execute: async (input, { workdir, stdout, log, runProcess, reactor: getReactor, folders }) => {
+        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 warnings = [];
+        const result = await generateProject({
+            targetDir,
+            spec,
+            mode: 'update',
+            force: input.force,
+            onWarn: (m) => warnings.push(m),
+        });
+        const lines = [];
+        if (result.migrated)
+            lines.push('Migrated layout: flat → split.');
+        lines.push(`Wrote ${result.files.length} file(s); skipped ${result.skipped.length}; deleted ${result.deleted.length}.`);
+        for (const w of warnings) {
+            if (log)
+                log.warn(w);
+            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: {
+                mode: result.mode,
+                files: result.files.map((f) => f.relativePath),
+                skipped: result.skipped.map((f) => f.relativePath),
+                deleted: result.deleted.map((f) => f.relativePath),
+                migrated: result.migrated,
+                warnings,
+            },
+        };
+    },
+});