@powerhousedao/ph-clint-cli 0.1.0-dev.9 → 0.1.0-dev.90

package/dist/spec/from-document.js

@@ -5,26 +5,14 @@ import { clintProjectSpecSchema, } from './types.js';
  * 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) {
+export function specFromDocumentState(state, meta) {
     if (!state.name)
         return null;
-    // `documentTypes` is a forward-compatible field — older `ph-clint-project`
-    // document states don't declare it yet. Pull through if present, otherwise
-    // leave it to the schema default (`[]`). Codegen treats the empty list as
-    // "no registry entries" and emits an empty `defineRegistry([...])`.
-    const documentTypes = state.documentTypes ?? undefined;
     const parsed = clintProjectSpecSchema.safeParse({
-        name: state.name,
+        ...state,
         scope: state.scope ?? undefined,
-        version: state.version,
-        description: state.description,
-        bin: state.bin ?? undefined,
-        features: {
-            powerhouse: { ...state.features.powerhouse },
-            mastra: { ...state.features.mastra },
-            routine: { ...state.features.routine },
-        },
-        ...(Array.isArray(documentTypes) ? { documentTypes } : {}),
+        documentId: meta?.documentId,
+        documentType: meta?.documentType,
     });
     return parsed.success ? parsed.data : null;
 }

package/dist/spec/types.d.ts

@@ -1,62 +1 @@
-/**
- * ClintProjectSpec — the in-memory shape that describes a ph-clint
- * implementation project. Persisted at
- * `{impl-project}/.ph/ph-clint-cli/project-spec.json` and consumed by
- * the code generator (src/codegen/).
- *
- * Intentionally minimal. Richer structure (services, skills, agents,
- * triggers, document-models) gets added in later phases as each
- * generator step actually needs it.
- */
-import { z } from 'zod';
-export declare const clintProjectSpecSchema: z.ZodObject<{
-    name: z.ZodString;
-    scope: z.ZodOptional<z.ZodString>;
-    version: z.ZodDefault<z.ZodString>;
-    description: z.ZodDefault<z.ZodString>;
-    bin: z.ZodOptional<z.ZodString>;
-    features: z.ZodDefault<z.ZodObject<{
-        powerhouse: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-            switchboard: z.ZodDefault<z.ZodBoolean>;
-            connect: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-        mastra: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-        routine: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-    documentTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type ClintProjectSpec = z.infer<typeof clintProjectSpecSchema>;
-export type ClintProjectSpecInput = z.input<typeof clintProjectSpecSchema>;
-/** npm package name (e.g. `@scope/foo` or `foo`). */
-export declare function getPackageName(spec: ClintProjectSpec): string;
-/** bin name (defaults to the bare project name). */
-export declare function getBinName(spec: ClintProjectSpec): string;
-/**
- * Name of the CLI sub-folder when the project is split (Powerhouse enabled).
- * For flat projects this is irrelevant — callers use the project root directly.
- */
-export declare function getCliFolderName(spec: ClintProjectSpec): string;
-/**
- * Name of the reactor-package sub-folder when the project is split.
- */
-export declare function getAppFolderName(spec: ClintProjectSpec): string;
-/**
- * Folder slug for a documentType ID. The slug is the portion after the last
- * `/` (e.g. `powerhouse/ph-clint-project` → `ph-clint-project`). Matches the
- * convention used by Powerhouse's reactor-package codegen — each document
- * model lives at `document-models/<slug>/`.
- */
-export declare function getDocumentTypeSlug(documentType: string): string;
-/**
- * PascalCase export name for a documentType ID. Powerhouse's module
- * generator exports each module as `PascalCase(<slug>)` (e.g.
- * `powerhouse/ph-clint-project` → `PhClintProject`). The top-level reactor
- * package re-exports these names, so this helper gives codegen the string
- * it needs both for the import and the `defineRegistry` entry.
- */
-export declare function getDocumentTypeModuleName(documentType: string): string;
+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

@@ -1,112 +1 @@
-/**
- * ClintProjectSpec — the in-memory shape that describes a ph-clint
- * implementation project. Persisted at
- * `{impl-project}/.ph/ph-clint-cli/project-spec.json` and consumed by
- * the code generator (src/codegen/).
- *
- * Intentionally minimal. Richer structure (services, skills, agents,
- * triggers, document-models) gets added in later phases as each
- * generator step actually needs it.
- */
-import { z } from 'zod';
-const powerhouseFeatureSchema = z.object({
-    enabled: z.boolean().default(false),
-    switchboard: z.boolean().default(true),
-    connect: z.boolean().default(true),
-});
-const mastraFeatureSchema = z.object({
-    enabled: z.boolean().default(false),
-});
-const routineFeatureSchema = z.object({
-    enabled: z.boolean().default(false),
-});
-// Zod 4 does not cascade `.default({})` through nested object schemas — a
-// missing outer key fills in `{}`, but nested keys with their own `.default`
-// are not re-defaulted unless the object itself re-parses. We spell out full
-// defaults here so `clintProjectSpecSchema.parse({ name: 'x' })` yields a
-// fully-populated feature tree.
-const DEFAULT_POWERHOUSE = {
-    enabled: false,
-    switchboard: true,
-    connect: true,
-};
-const DEFAULT_MASTRA = { enabled: false };
-const DEFAULT_ROUTINE = { enabled: false };
-export const clintProjectSpecSchema = z.object({
-    name: z
-        .string()
-        .regex(/^[a-z0-9][a-z0-9-]*$/, 'lowercase letters, digits, hyphens only'),
-    scope: z
-        .string()
-        .regex(/^[a-z0-9][a-z0-9-]*$/, 'lowercase letters, digits, hyphens only')
-        .optional(),
-    version: z.string().default('0.1.0'),
-    description: z.string().default(''),
-    bin: z.string().optional(),
-    features: z
-        .object({
-        powerhouse: powerhouseFeatureSchema.default(DEFAULT_POWERHOUSE),
-        mastra: mastraFeatureSchema.default(DEFAULT_MASTRA),
-        routine: routineFeatureSchema.default(DEFAULT_ROUTINE),
-    })
-        .default({
-        powerhouse: DEFAULT_POWERHOUSE,
-        mastra: DEFAULT_MASTRA,
-        routine: DEFAULT_ROUTINE,
-    }),
-    /**
-     * Document types registered with this CLI — full documentType ID strings
-     * (e.g. `powerhouse/ph-clint-project`). Drives codegen of `src/framework.gen.ts`,
-     * which emits a typed `defineRegistry([...] as const)` call so impl code
-     * gets narrowed `reactor.client.get(id, 'my-type')` access. Empty on
-     * fresh projects — populated as document models are added to the reactor
-     * package.
-     */
-    documentTypes: z.array(z.string()).default([]),
-});
-/** npm package name (e.g. `@scope/foo` or `foo`). */
-export function getPackageName(spec) {
-    return spec.scope ? `@${spec.scope}/${spec.name}` : spec.name;
-}
-/** bin name (defaults to the bare project name). */
-export function getBinName(spec) {
-    return spec.bin ?? spec.name;
-}
-/**
- * Name of the CLI sub-folder when the project is split (Powerhouse enabled).
- * For flat projects this is irrelevant — callers use the project root directly.
- */
-export function getCliFolderName(spec) {
-    return `${spec.name}-cli`;
-}
-/**
- * Name of the reactor-package sub-folder when the project is split.
- */
-export function getAppFolderName(spec) {
-    return `${spec.name}-app`;
-}
-/**
- * Folder slug for a documentType ID. The slug is the portion after the last
- * `/` (e.g. `powerhouse/ph-clint-project` → `ph-clint-project`). Matches the
- * convention used by Powerhouse's reactor-package codegen — each document
- * model lives at `document-models/<slug>/`.
- */
-export function getDocumentTypeSlug(documentType) {
-    const lastSlash = documentType.lastIndexOf('/');
-    return lastSlash >= 0 ? documentType.slice(lastSlash + 1) : documentType;
-}
-/**
- * PascalCase export name for a documentType ID. Powerhouse's module
- * generator exports each module as `PascalCase(<slug>)` (e.g.
- * `powerhouse/ph-clint-project` → `PhClintProject`). The top-level reactor
- * package re-exports these names, so this helper gives codegen the string
- * it needs both for the import and the `defineRegistry` entry.
- */
-export function getDocumentTypeModuleName(documentType) {
-    const slug = getDocumentTypeSlug(documentType);
-    return slug
-        .split(/[-_]/)
-        .filter((s) => s.length > 0)
-        .map((s) => s[0].toUpperCase() + s.slice(1))
-        .join('');
-}
+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

@@ -1,35 +1,77 @@
+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). */
+/** 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;
-    projectDocumentId?: string | undefined;
     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 reducer: import("document-model").Reducer<import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PhClintProjectPHState>;
     readonly actions: {
-        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;
-        enablePowerhouse: (input: import("@powerhousedao/ph-clint-app").EnablePowerhouseInput) => import("@powerhousedao/ph-clint-app").EnablePowerhouseAction;
-        setPowerhouseSwitchboard: (input: import("@powerhousedao/ph-clint-app").SetPowerhouseSwitchboardInput) => import("@powerhousedao/ph-clint-app").SetPowerhouseSwitchboardAction;
-        setPowerhouseConnect: (input: import("@powerhousedao/ph-clint-app").SetPowerhouseConnectInput) => import("@powerhousedao/ph-clint-app").SetPowerhouseConnectAction;
-        setPackageName: (input: import("@powerhousedao/ph-clint-app").SetPackageNameInput) => import("@powerhousedao/ph-clint-app").SetPackageNameAction;
-        clearBin: (input: import("@powerhousedao/ph-clint-app").ClearBinInput) => import("@powerhousedao/ph-clint-app").ClearBinAction;
-        setBin: (input: import("@powerhousedao/ph-clint-app").SetBinInput) => import("@powerhousedao/ph-clint-app").SetBinAction;
-        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;
-        clearScope: (input: import("@powerhousedao/ph-clint-app").ClearScopeInput) => import("@powerhousedao/ph-clint-app").ClearScopeAction;
-        setScope: (input: import("@powerhousedao/ph-clint-app").SetScopeInput) => import("@powerhousedao/ph-clint-app").SetScopeAction;
+        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;
@@ -38,6 +80,6 @@ export declare const specChangeTrigger: import("@powerhousedao/ph-clint").Trigge
         }, 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 utils: import("document-model").DocumentModelUtils<import("@powerhousedao/ph-clint-app/document-models/ph-clint-project").PhClintProjectPHState>;
     readonly documentModel: import("document-model").DocumentModelPHState;
 }]>>;