@powerhousedao/ph-clint-cli 0.0.1

package/dist/spec/from-document.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Convert a `powerhouse/ph-clint-project` document's global state into a
+ * `ClintProjectSpec` that the code generator consumes.
+ *
+ * The document state is deliberately more permissive than the codegen spec:
+ * `name` is nullable in the state (so empty documents are creatable), but the
+ * generator requires a valid package name. Callers handle the `null` result
+ * (typically by skipping the regen until the user sets a name).
+ */
+import type { PhClintProjectGlobalState } from '@powerhousedao/ph-clint-app/document-models/ph-clint-project';
+import { type ClintProjectSpec } from './types.js';
+/**
+ * Build a `ClintProjectSpec` from the document state.
+ *
+ * Returns `null` if the document has no valid package name yet — callers
+ * should wait for the user to populate it before triggering codegen.
+ */
+export declare function specFromDocumentState(state: PhClintProjectGlobalState, meta?: {
+    documentId?: string;
+    documentType?: string;
+}): ClintProjectSpec | null;

package/dist/spec/from-document.js

@@ -0,0 +1,18 @@
+import { clintProjectSpecSchema, } from './types.js';
+/**
+ * Build a `ClintProjectSpec` from the document state.
+ *
+ * Returns `null` if the document has no valid package name yet — callers
+ * should wait for the user to populate it before triggering codegen.
+ */
+export function specFromDocumentState(state, meta) {
+    if (!state.name)
+        return null;
+    const parsed = clintProjectSpecSchema.safeParse({
+        ...state,
+        scope: state.scope ?? undefined,
+        documentId: meta?.documentId,
+        documentType: meta?.documentType,
+    });
+    return parsed.success ? parsed.data : null;
+}

package/dist/spec/types.d.ts

@@ -0,0 +1 @@
+export { POWERHOUSE_LEVELS, powerhouseLevelSchema, type PowerhouseLevel, phAtLeast, agentModelSchema, type AgentModel, agentProfileSchema, type AgentProfile, powerhousePackageSchema, type PowerhousePackage, externalSkillSchema, type ExternalSkill, clintProjectSpecSchema, type ClintProjectSpec, type ClintProjectSpecInput, getPackageName, getBinName, getCliFolderName, getAppFolderName, getAllDocumentTypes, getAppPackageName, getAppDirName, getDocumentTypeSlug, getDocumentTypeModuleName, isDocTypeGlob, docTypeGlobToRegex, } from '@powerhousedao/ph-clint-dev/spec';

package/dist/spec/types.js

@@ -0,0 +1 @@
+export { POWERHOUSE_LEVELS, powerhouseLevelSchema, phAtLeast, agentModelSchema, agentProfileSchema, powerhousePackageSchema, externalSkillSchema, clintProjectSpecSchema, getPackageName, getBinName, getCliFolderName, getAppFolderName, getAllDocumentTypes, getAppPackageName, getAppDirName, getDocumentTypeSlug, getDocumentTypeModuleName, isDocTypeGlob, docTypeGlobToRegex, } from '@powerhousedao/ph-clint-dev/spec';

package/dist/triggers/publish-trigger.d.ts

@@ -0,0 +1,81 @@
+/** Map document model PublishTag values to CLI --tag values. */
+export declare function tagToCli(tag: string): 'dev' | 'staging' | 'production' | null;
+export declare const publishTrigger: import("@powerhousedao/ph-clint").Trigger<{
+    pending: number;
+}, {
+    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/triggers/publish-trigger.js

@@ -0,0 +1,137 @@
+/**
+ * `publish-trigger` — watches ALL `powerhouse/ph-clint-project` documents for
+ * publish records with `Pending` status and invokes the publish pipeline.
+ *
+ * Unlike `spec-change`, this trigger does NOT convert to a `ClintProjectSpec`.
+ * It reads `publishHistory` directly from the document state, since publish
+ * records are a doc-model concern (not a codegen input).
+ *
+ * Uses the multi-doc path (no `documentId`), scanning all matching documents
+ * on each poll. For each document with a pending publish record, it uses the
+ * project mapping to resolve the on-disk project directory.
+ *
+ * Flow:
+ *   1. On document change, scans `publishHistory` for records with status
+ *      `"Pending"`.
+ *   2. For each pending record, returns a work item that:
+ *      a. Dispatches SET_PUBLISH_STATUS({ id, status: "InProgress" }).
+ *      b. Runs `ph-clint clint-project-publish --tag <tag>`.
+ *      c. Dispatches SET_PUBLISH_STATUS({ id, status: "Succeeded"|"Failed" }).
+ */
+import path from 'node:path';
+import { scanProjects, getProjectMapping } from '@powerhousedao/ph-clint';
+import { setPublishStatus } from '@powerhousedao/ph-clint-app';
+import { createDocumentChangeTrigger } from '../framework.js';
+import { specFromDocumentState } from '../spec/from-document.js';
+import { clintProject } from '../services/clint-project.js';
+const DOCUMENT_TYPE = 'powerhouse/ph-clint-project';
+const TAG = '[publish]';
+/** Map document model PublishTag values to CLI --tag values. */
+export function tagToCli(tag) {
+    switch (tag) {
+        case 'Dev':
+            return 'dev';
+        case 'Staging':
+            return 'staging';
+        case 'Production':
+            return 'production';
+        default:
+            return null;
+    }
+}
+export const publishTrigger = createDocumentChangeTrigger({
+    id: 'publish-trigger',
+    documentType: DOCUMENT_TYPE,
+    // No documentId → watches ALL ph-clint-project docs
+    // Don't fire on startup — only react to new pending records.
+    initialReconcile: false,
+    async onChange(docs, ctx) {
+        const log = ctx.context.log;
+        const folders = ctx.context.folders;
+        // Build the mapping to resolve on-disk project directories
+        const scanner = clintProject.projectScanner;
+        const scanResults = scanner
+            ? scanProjects(ctx.context.workdir, scanner)
+            : [];
+        const mapping = await getProjectMapping(scanResults, folders);
+        for (const doc of docs) {
+            const publishHistory = doc.state.global.publishHistory ?? [];
+            const pending = publishHistory.filter((r) => r.status === 'Pending');
+            if (pending.length === 0)
+                continue;
+            // Resolve the on-disk target directory for this document
+            const spec = specFromDocumentState(doc.state.global, {
+                documentId: doc.header.id,
+                documentType: doc.header.documentType,
+            });
+            const entry = mapping.find((m) => m.documentId === doc.header.id);
+            const workdir = entry?.path
+                ?? (spec ? path.join(ctx.context.workdir, spec.name) : ctx.context.workdir);
+            // Process the first pending record (one per tick to avoid races).
+            const record = pending[0];
+            const cliTag = tagToCli(record.tag);
+            if (!cliTag) {
+                log?.warn(`${TAG} unknown publish tag "${record.tag}" for record ${record.id}`);
+                continue;
+            }
+            log?.info(`${TAG} found pending ${record.tag} publish for doc ${doc.header.id} (id=${record.id}, version=${record.version})`);
+            const { runProcess, stdout } = ctx.context;
+            return {
+                type: 'function',
+                params: {
+                    fn: async () => {
+                        const reactor = await ctx.reactor();
+                        if (!reactor) {
+                            log?.error(`${TAG} reactor not available, cannot update publish status`);
+                            return;
+                        }
+                        // Mark as InProgress.
+                        log?.info(`${TAG} marking record ${record.id} as InProgress`);
+                        await reactor.client.execute(doc.header.id, 'main', [
+                            setPublishStatus({ id: record.id, status: 'InProgress' }),
+                        ]);
+                        // Install dependencies in the generated project before publishing.
+                        // CI=true suppresses pnpm 11's interactive build-script approval
+                        // prompt; --no-frozen-lockfile overrides CI's default so a regen
+                        // that added new deps doesn't fail with ERR_PNPM_OUTDATED_LOCKFILE.
+                        stdout(`${TAG} running pnpm install in ${workdir}\n`);
+                        const installResult = await runProcess('pnpm install --no-frozen-lockfile', {
+                            cwd: workdir,
+                            timeout: 300_000,
+                            env: { CI: 'true' },
+                        });
+                        if (!installResult.success) {
+                            log?.error(`${TAG} pnpm install failed in ${workdir}`);
+                        }
+                        // Run the publish command.
+                        let success = false;
+                        try {
+                            stdout(`${TAG} invoking clint-project-publish --tag ${cliTag}\n`);
+                            const { clintProjectPublish } = await import('../commands/clint-project-publish.js');
+                            const result = await clintProjectPublish.execute({ tag: cliTag, dir: workdir, dryRun: false, skipBuild: false, skipGitCheck: true, verbose: false }, ctx.commandContext);
+                            success = !result.text.includes('failed');
+                        }
+                        catch (err) {
+                            log?.error(`${TAG} publish failed: ${err instanceof Error ? err.message : String(err)}`);
+                        }
+                        // Update status.
+                        const finalStatus = success ? 'Succeeded' : 'Failed';
+                        stdout(`${TAG} marking record ${record.id} as ${finalStatus}\n`);
+                        await reactor.client.execute(doc.header.id, 'main', [
+                            setPublishStatus({
+                                id: record.id,
+                                status: finalStatus,
+                            }),
+                        ]);
+                    },
+                },
+                callbacks: {
+                    onFailure: (err) => {
+                        log?.error(`${TAG} publish trigger failed: ${err.message}`);
+                    },
+                },
+            };
+        }
+        return null;
+    },
+});

package/dist/triggers/spec-change.d.ts

@@ -0,0 +1,85 @@
+import type { ImportSpecInput } from '@powerhousedao/ph-clint-app/document-models/ph-clint-project';
+import type { ClintProjectSpec } from '../spec/types.js';
+/** Stable hash of a ClintProjectSpec (sha256 of canonical-key JSON).
+ *  Excludes documentId/documentType — they don't affect codegen output. */
+export declare function hashSpec(spec: ClintProjectSpec): string;
+export declare function specToImportInput(spec: ClintProjectSpec): ImportSpecInput;
+export declare const specChangeTrigger: import("@powerhousedao/ph-clint").Trigger<{
+    pending: number;
+}, {
+    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/document-models/ph-clint-project").PhClintProjectPHState>;
+    readonly actions: {
+        setAgentModel: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetAgentModelInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetAgentModelAction;
+        addAgentProfileRef: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddAgentProfileRefInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddAgentProfileRefAction;
+        removeAgentProfileRef: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveAgentProfileRefInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveAgentProfileRefAction;
+        reorderAgentProfileRefs: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ReorderAgentProfileRefsInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ReorderAgentProfileRefsAction;
+        addAgentSkill: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddAgentSkillInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddAgentSkillAction;
+        removeAgentSkill: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveAgentSkillInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveAgentSkillAction;
+        addAgentToolPattern: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddAgentToolPatternInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddAgentToolPatternAction;
+        removeAgentToolPattern: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveAgentToolPatternInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveAgentToolPatternAction;
+        addSubAgent: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddSubAgentInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddSubAgentAction;
+        removeSubAgent: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveSubAgentInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveSubAgentAction;
+        setSubAgentName: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetSubAgentNameInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetSubAgentNameAction;
+        setSubAgentDescription: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetSubAgentDescriptionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetSubAgentDescriptionAction;
+        setMainAgentName: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetMainAgentNameInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetMainAgentNameAction;
+        setMainAgentDescription: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetMainAgentDescriptionAction;
+        clearMainAgentDescription: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ClearMainAgentDescriptionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ClearMainAgentDescriptionAction;
+        setMainAgentImage: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetMainAgentImageInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetMainAgentImageAction;
+        clearMainAgentImage: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ClearMainAgentImageInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ClearMainAgentImageAction;
+        addProfile: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddProfileInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddProfileAction;
+        updateProfile: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").UpdateProfileInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").UpdateProfileAction;
+        removeProfile: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveProfileInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveProfileAction;
+        reorderProfiles: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ReorderProfilesInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ReorderProfilesAction;
+        addModel: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddModelInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddModelAction;
+        removeModel: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveModelInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveModelAction;
+        enableMastra: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").EnableMastraInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").EnableMastraAction;
+        disableMastra: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").DisableMastraInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").DisableMastraAction;
+        setEnableChat: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetEnableChatInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetEnableChatAction;
+        addSupportedResource: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddSupportedResourceInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddSupportedResourceAction;
+        removeSupportedResource: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveSupportedResourceInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveSupportedResourceAction;
+        setProxyEnabled: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetProxyEnabledInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetProxyEnabledAction;
+        setObservabilityEnabled: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetObservabilityEnabledInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetObservabilityEnabledAction;
+        importSpec: (input: ImportSpecInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").ImportSpecAction;
+        bumpVersion: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").BumpVersionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").BumpVersionAction;
+        publishDev: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PublishDevInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PublishDevAction;
+        publishStaging: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PublishStagingInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PublishStagingAction;
+        publishProduction: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PublishProductionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PublishProductionAction;
+        setPublishStatus: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPublishStatusInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPublishStatusAction;
+        addExternalSkill: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddExternalSkillInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddExternalSkillAction;
+        removeExternalSkill: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveExternalSkillInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemoveExternalSkillAction;
+        setExternalSkillName: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetExternalSkillNameInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetExternalSkillNameAction;
+        setExternalSkillGithubUrl: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetExternalSkillGithubUrlInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetExternalSkillGithubUrlAction;
+        addPowerhousePackage: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddPowerhousePackageInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddPowerhousePackageAction;
+        removePowerhousePackage: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemovePowerhousePackageInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemovePowerhousePackageAction;
+        addPackageDocumentType: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddPackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").AddPackageDocumentTypeAction;
+        removePackageDocumentType: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemovePackageDocumentTypeInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").RemovePackageDocumentTypeAction;
+        setPackageVersion: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPackageVersionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPackageVersionAction;
+        enableRoutine: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").EnableRoutineInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").EnableRoutineAction;
+        disableRoutine: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").DisableRoutineInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").DisableRoutineAction;
+        setPowerhouseLevel: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPowerhouseLevelInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPowerhouseLevelAction;
+        setDescription: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetDescriptionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetDescriptionAction;
+        setVersion: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetVersionInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetVersionAction;
+        setPackageIdentifier: (input: import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").SetPackageIdentifierInput) => import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").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/document-models/ph-clint-project").PhClintProjectPHState>;
+    readonly documentModel: import("document-model").DocumentModelPHState;
+}]>>;

package/dist/triggers/spec-change.js

@@ -0,0 +1,224 @@
+/**
+ * `spec-change` trigger — watches ALL `powerhouse/ph-clint-project` documents
+ * and, when any change, re-runs the code generator for each affected project.
+ *
+ * Flow:
+ *   1. `createDocumentChangeTrigger` (from ph-clint) owns the subscription,
+ *      event coalescing, doc loading, and type narrowing. No `documentId` is
+ *      set, so it loads ALL matching documents on each poll.
+ *   2. `getProjectMapping()` merges an on-disk scan (via the clint-project
+ *      service's projectScanner) with personal-drive folder entries to
+ *      correlate each document to an on-disk project directory.
+ *   3. For each document, `specFromDocumentState()` builds a spec, hashes it,
+ *      and compares against `.ph/ph-clint-cli/.last-spec-hash`. If unchanged,
+ *      skips. Otherwise regenerates at the mapped target directory.
+ */
+import crypto from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { scanProjects, getProjectMapping } from '@powerhousedao/ph-clint';
+import { createDocumentChangeTrigger } from '../framework.js';
+import { generateProject } from '../codegen/index.js';
+import { runPostGenActions } from '@powerhousedao/ph-clint-dev/codegen/actions';
+import { specFromDocumentState } from '../spec/from-document.js';
+import { readProjectSpec, writeProjectSpec } from '../spec/file.js';
+import { ensureSpecDocument } from '../spec/ensure-document.js';
+import { clintProject } from '../services/clint-project.js';
+const DOCUMENT_TYPE = 'powerhouse/ph-clint-project';
+const HASH_DIR = path.join('.ph', 'ph-clint-cli');
+const HASH_FILE = '.last-spec-hash';
+const TAG = '[spec-change]';
+function getHashPath(targetDir) {
+    return path.join(targetDir, HASH_DIR, HASH_FILE);
+}
+function isEnoent(err) {
+    return (!!err &&
+        typeof err === 'object' &&
+        'code' in err &&
+        err.code === 'ENOENT');
+}
+async function readLastSpecHash(targetDir) {
+    try {
+        return (await fs.readFile(getHashPath(targetDir), 'utf8')).trim() || null;
+    }
+    catch (err) {
+        if (isEnoent(err))
+            return null;
+        throw err;
+    }
+}
+async function writeLastSpecHash(targetDir, hash) {
+    const file = getHashPath(targetDir);
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, hash + '\n', 'utf8');
+}
+/** Stable hash of a ClintProjectSpec (sha256 of canonical-key JSON).
+ *  Excludes documentId/documentType — they don't affect codegen output. */
+export function hashSpec(spec) {
+    const { documentId, documentType, ...codegenRelevant } = spec;
+    return crypto
+        .createHash('sha256')
+        .update(canonicalJson(codegenRelevant), 'utf8')
+        .digest('hex');
+}
+function canonicalJson(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return '[' + value.map(canonicalJson).join(',') + ']';
+    }
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    return ('{' +
+        keys
+            .map((k) => JSON.stringify(k) + ':' + canonicalJson(obj[k]))
+            .join(',') +
+        '}');
+}
+export function specToImportInput(spec) {
+    const main = spec.features.mastra.mainAgent;
+    return {
+        name: spec.name,
+        scope: spec.scope ?? null,
+        version: spec.version,
+        description: spec.description,
+        powerhouse: spec.features.powerhouse,
+        mastraEnabled: spec.features.mastra.enabled,
+        routineEnabled: spec.features.routine.enabled,
+        mainAgent: main
+            ? {
+                id: main.id,
+                name: main.name,
+                description: main.description,
+                attachment: main.image,
+                modelId: main.modelId,
+                profileIds: [...main.profileIds],
+                skills: [...main.skills],
+                toolPatterns: [...main.toolPatterns],
+            }
+            : null,
+        subAgents: spec.features.mastra.subAgents.map((s) => ({
+            id: s.id,
+            name: s.name,
+            description: s.description,
+            modelId: s.modelId,
+            profileIds: [...s.profileIds],
+            skills: [...s.skills],
+            toolPatterns: [...s.toolPatterns],
+        })),
+        models: spec.features.mastra.models.map((m) => ({
+            id: m.id,
+        })),
+        profiles: spec.features.mastra.profiles.map((p) => ({
+            id: p.id,
+            title: p.title,
+            content: p.content,
+        })),
+        packages: spec.packages.map((p) => ({
+            id: p.id,
+            packageName: p.packageName,
+            documentTypes: p.documentTypes,
+        })),
+        externalSkills: spec.externalSkills.map((s) => ({
+            id: s.id,
+            name: s.name,
+            githubUrl: s.githubUrl,
+        })),
+        enableChat: spec.features.mastra.common.enableChat,
+        proxyEnabled: spec.deployment.proxyEnabled,
+        observabilityEnabled: spec.deployment.observabilityEnabled,
+        supportedResources: spec.deployment.supportedResources,
+    };
+}
+export const specChangeTrigger = createDocumentChangeTrigger({
+    id: 'spec-change',
+    documentType: DOCUMENT_TYPE,
+    // No documentId → watches ALL ph-clint-project docs
+    callOnEmpty: true, // bootstrap from disk when no documents exist yet
+    async onChange(docs, ctx) {
+        const log = ctx.context.log;
+        const folders = ctx.context.folders;
+        // Build the mapping: on-disk projects + personal drive documents
+        const scanner = clintProject.projectScanner;
+        const scanResults = scanner
+            ? scanProjects(ctx.context.workdir, scanner)
+            : [];
+        const mapping = await getProjectMapping(scanResults, folders);
+        // Auto-create spec documents for unlinked or orphaned projects
+        const reactor = await ctx.reactor();
+        if (reactor && folders) {
+            for (const entry of mapping) {
+                if (!entry.path)
+                    continue;
+                const existingSpec = await readProjectSpec(entry.path);
+                if (!existingSpec)
+                    continue;
+                try {
+                    const { docId, created } = await ensureSpecDocument({
+                        spec: existingSpec,
+                        targetDir: entry.path,
+                        reactor,
+                        folders,
+                    });
+                    if (created) {
+                        log?.info(`${TAG} linked project ${entry.name} to document ${docId}`);
+                    }
+                }
+                catch (err) {
+                    log?.warn(`${TAG} could not ensure spec document for ${entry.name}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        for (const doc of docs) {
+            const spec = specFromDocumentState(doc.state.global, {
+                documentId: doc.header.id,
+                documentType: doc.header.documentType,
+            });
+            if (!spec) {
+                log?.debug(`${TAG} document ${doc.header.id} state did not validate against ClintProjectSpec, skipping`);
+                continue;
+            }
+            // Find target directory from mapping
+            const entry = mapping.find((m) => m.documentId === doc.header.id);
+            const targetDir = entry?.path ?? path.join(ctx.context.workdir, spec.name);
+            // Per-project hash comparison
+            const nextHash = hashSpec(spec);
+            const prevHash = await readLastSpecHash(targetDir);
+            if (nextHash === prevHash) {
+                log?.debug(`${TAG} spec for ${spec.name} unchanged (hash=${nextHash.slice(0, 12)}…), skipping`);
+                continue;
+            }
+            log?.debug(`${TAG} spec for ${spec.name} changed: ${prevHash ? prevHash.slice(0, 12) + '…' : '<none>'} → ${nextHash.slice(0, 12)}…`);
+            log?.info(`${TAG} regenerating ${spec.name} at ${targetDir} (doc=${doc.header.id})`);
+            const t0 = Date.now();
+            const warnings = [];
+            const result = await generateProject({
+                targetDir,
+                spec,
+                mode: 'update',
+                force: true,
+                onWarn: (m) => warnings.push(m),
+            });
+            // Write spec JSON with documentId
+            await writeProjectSpec(targetDir, spec);
+            await writeLastSpecHash(targetDir, nextHash);
+            const elapsed = Date.now() - t0;
+            if (log) {
+                if (result.migrated)
+                    log.info(`${TAG} migrated flat → split layout`);
+                log.info(`${TAG} regenerated ${spec.name} in ${elapsed}ms: ${result.files.length} written, ${result.skipped.length} skipped, ${result.deleted.length} deleted`);
+                for (const w of warnings)
+                    log.warn(`${TAG} ${w}`);
+            }
+            // Run post-generation actions (ph-init, install, build, skills-sync).
+            // Route through ctx.context.stdout so output flows through
+            // routine.onOutput → service log buffer → ServicePanel.
+            await runPostGenActions(result.pendingActions, {
+                log: (msg) => ctx.context.stdout(`${TAG} ${msg}\n`),
+                runProcess: ctx.context.runProcess,
+            });
+        }
+        // Work done inline, no additional work item needed
+        return null;
+    },
+});