@powerhousedao/vetra 6.0.2-staging.9 → 6.1.0-dev.0

package/dist/codegen/index.js

@@ -0,0 +1,793 @@
+import { d as appModuleDocumentType, f as reducer, p as actions, r as utils } from "../utils-BRx88WW3.js";
+import { t as createAppModuleDocument } from "../ph-factories-B6PSPkPQ.js";
+import { d as documentEditorDocumentType, f as reducer$1, p as actions$1, r as utils$1 } from "../utils-CnZc-0E4.js";
+import { t as createDocumentEditorDocument } from "../ph-factories-CJXfT_Z1.js";
+import { d as processorModuleDocumentType, f as reducer$2, p as actions$2, r as utils$2 } from "../utils-Byjf33qt.js";
+import { t as createProcessorModuleDocument } from "../ph-factories-B0_E6LY6.js";
+import { d as subgraphModuleDocumentType, f as reducer$3, p as actions$3, r as utils$3 } from "../utils-CWO5kDus.js";
+import { n as createSubgraphModuleDocument } from "../ph-factories-Bn_HTUfT.js";
+import { documentModelDocumentModelModule } from "document-model";
+import { PROCESSOR_APPS } from "@powerhousedao/shared/processors";
+import { generateId as generateId$1 } from "@powerhousedao/shared/document-model";
+import { getAppMetadata, getEditorMetadata, getOrCreateDirectory, getProcessorMetadata, getSubgraphMetadata, loadDocumentModelInDir } from "@powerhousedao/codegen/utils";
+import { readdirSync } from "node:fs";
+import { generateApp, generateDocumentModel, generateEditor, generateProcessor, generateSubgraph } from "@powerhousedao/codegen";
+import { camelCase, kebabCase } from "change-case";
+import { baseLoadFromFile, baseSaveToFile } from "document-model/node";
+import { mkdir, readdir, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+//#region codegen/extract.ts
+/**
+* Inverse of the `generate*` functions in `@powerhousedao/codegen`.
+*
+* `generate*` reads source-of-truth documents and writes code into the project.
+* `extract*` reads the project's existing code/files and produces the
+* `powerhouse/*` documents that would have produced that code. Intended as a
+* one-shot migration step toward the documents-as-source-of-truth model: run
+* extraction, save the documents into `specs/`, and from then on regenerate
+* from the specs.
+*/
+const isDefined = (v) => v != null;
+function extractEditorDocuments(project) {
+	const { directory: editorsDir } = getOrCreateDirectory(project, "editors");
+	return editorsDir.getDirectories().map((dir) => getEditorMetadata(project, dir.getBaseName())).filter(isDefined).filter(({ documentTypes }) => !documentTypes.includes("powerhouse/document-drive")).map(({ name, documentTypes }) => {
+		const doc = createDocumentEditorDocument({ global: {
+			name,
+			documentTypes: documentTypes.map((documentType) => ({
+				id: generateId$1(),
+				documentType
+			})),
+			status: "CONFIRMED"
+		} });
+		doc.header.name = name;
+		return doc;
+	});
+}
+function extractAppDocuments(project) {
+	const { directory: editorsDir } = getOrCreateDirectory(project, "editors");
+	return editorsDir.getDirectories().map((dir) => getAppMetadata(project, dir.getBaseName())).filter(isDefined).map(({ name, allowedDocumentTypes, isDragAndDropEnabled }) => {
+		const doc = createAppModuleDocument({ global: {
+			name,
+			status: "CONFIRMED",
+			allowedDocumentTypes: allowedDocumentTypes.length > 0 ? allowedDocumentTypes : null,
+			isDragAndDropEnabled: isDragAndDropEnabled ?? true
+		} });
+		doc.header.name = name;
+		return doc;
+	});
+}
+function extractProcessorDocuments(project) {
+	const { directory: processorsDir } = getOrCreateDirectory(project, "processors");
+	return processorsDir.getDirectories().map((dir) => getProcessorMetadata(project, dir.getBaseName())).map(({ processorName, processorApps, processorType, documentTypes }) => {
+		const doc = createProcessorModuleDocument({ global: {
+			name: processorName,
+			type: processorType === "relationalDb" ? "relational" : processorType,
+			documentTypes: documentTypes.map((documentType) => ({
+				id: generateId$1(),
+				documentType
+			})),
+			status: "CONFIRMED",
+			processorApps: [...processorApps]
+		} });
+		doc.header.name = processorName;
+		return doc;
+	});
+}
+function extractSubgraphDocuments(project) {
+	const { directory: subgraphsDir } = getOrCreateDirectory(project, "subgraphs");
+	return subgraphsDir.getDirectories().map((dir) => getSubgraphMetadata(project, dir.getBaseName()).subgraphName).filter(isDefined).map((name) => {
+		const doc = createSubgraphModuleDocument({ global: {
+			name,
+			status: "CONFIRMED"
+		} });
+		doc.header.name = name;
+		return doc;
+	});
+}
+function extractDocumentModelDocuments(project) {
+	const { directory: documentModelsDir } = getOrCreateDirectory(project, "document-models");
+	return readdirSync(documentModelsDir.getPath(), { withFileTypes: true }).map(loadDocumentModelInDir).filter(isDefined).map(buildDocumentModelDocument);
+}
+function buildDocumentModelDocument(globalState) {
+	const state = documentModelDocumentModelModule.utils.createState({ global: globalState });
+	const doc = documentModelDocumentModelModule.utils.createDocument(state);
+	doc.header.name = globalState.name;
+	return doc;
+}
+function extractAllDocuments(project) {
+	return {
+		documentModels: extractDocumentModelDocuments(project),
+		editors: extractEditorDocuments(project),
+		apps: extractAppDocuments(project),
+		processors: extractProcessorDocuments(project),
+		subgraphs: extractSubgraphDocuments(project)
+	};
+}
+//#endregion
+//#region codegen/generate-from-document.ts
+/**
+* Document-driven codegen wrappers. Each function takes a `PHDocument` of the
+* matching vetra type and dispatches to the generic generate* in
+* `@powerhousedao/codegen`. The state→args translation is lifted verbatim from
+* `packages/vetra/processors/codegen/document-handlers/generators/*-generator.ts`
+* so the agent-driven path and the reactor-driven path produce identical
+* output.
+*
+* Callers are responsible for `await project.save()` after one or more
+* `generate*FromDocument` calls — leaving it out here lets a CLI batch
+* multiple specs into a single save.
+*/
+async function generateDocumentModelFromDocument(doc, project) {
+	await generateDocumentModel(doc.state.global, project);
+}
+async function generateEditorFromDocument(doc, project) {
+	const state = doc.state.global;
+	const documentTypes = state.documentTypes.map((dt) => dt.documentType);
+	await generateEditor({
+		editorName: state.name,
+		documentTypes,
+		editorId: kebabCase(state.name)
+	}, project);
+}
+async function generateProcessorFromDocument(doc, project) {
+	const state = doc.state.global;
+	let processorType;
+	if (state.type === "analytics") processorType = "analytics";
+	else if (state.type === "relational") processorType = "relationalDb";
+	else throw new Error(`Unsupported processor type: "${state.type}"`);
+	const documentTypes = state.documentTypes.map((dt) => dt.documentType);
+	const processorApps = state.processorApps;
+	if (!isProcessorApps(processorApps)) throw new Error(`Unsupported processor apps: ${processorApps.join(", ")}`);
+	await generateProcessor({
+		processorName: state.name,
+		processorType,
+		documentTypes,
+		processorApps
+	}, project);
+}
+async function generateSubgraphFromDocument(doc, project) {
+	await generateSubgraph(doc.state.global.name, project);
+}
+async function generateAppFromDocument(doc, project) {
+	const state = doc.state.global;
+	await generateApp({
+		appName: state.name,
+		appId: kebabCase(state.name),
+		allowedDocumentTypes: state.allowedDocumentTypes ?? [],
+		isDragAndDropEnabled: state.isDragAndDropEnabled
+	}, project);
+}
+function isProcessorApps(input) {
+	if (input.length === 0) return false;
+	if (new Set(input).size !== input.length) return false;
+	if (!input.every((i) => PROCESSOR_APPS.includes(i))) return false;
+	return true;
+}
+//#endregion
+//#region document-models/app-module/app-module.json
+var app_module_default = {
+	id: "powerhouse/app",
+	name: "App Module",
+	author: {
+		"name": "Powerhouse",
+		"website": "https://powerhouse.inc"
+	},
+	extension: ".app",
+	description: "Declares a custom Drive App (a drive-level UI surface) shipped by a Vetra Reactor Package. Use one App Module document per drive app: configure which document types it handles, whether it accepts drag-and-drop, and mark it CONFIRMED to trigger codegen of the corresponding app scaffold under `apps/`.",
+	specifications: [{
+		"state": {
+			"local": {
+				"schema": "",
+				"examples": [],
+				"initialValue": ""
+			},
+			"global": {
+				"schema": "\"\"\"\nConfiguration for a Drive App contributed by the package. Drive apps render a\ncustom view at the drive level (instead of, or alongside, the document file\ntree) and can opt into which document types they accept.\n\"\"\"\ntype AppModuleState {\n  \"\"\"Display name of the drive app. Also used as the source for the generated folder name under `apps/`.\"\"\"\n  name: String!\n  \"\"\"Lifecycle status. While DRAFT the app definition is editable and codegen is skipped; switching to CONFIRMED triggers app scaffold generation.\"\"\"\n  status: StatusType!\n  \"\"\"Document type ids this app handles. `null` means the app accepts any document type; an empty list means it accepts none.\"\"\"\n  allowedDocumentTypes: [String!]\n  \"\"\"Whether the app surface accepts dropped files from the user. Defaults to true.\"\"\"\n  isDragAndDropEnabled: Boolean!\n}\n\n\"\"\"\nLifecycle status of a module definition.\n- DRAFT: still being edited; codegen does not run.\n- CONFIRMED: locked in; codegen produces the corresponding scaffold.\n\"\"\"\nenum StatusType {\n  DRAFT\n  CONFIRMED\n}",
+				"examples": [],
+				"initialValue": "{\n  \"name\": \"\",\n  \"status\": \"DRAFT\",\n  \"allowedDocumentTypes\": null,\n  \"isDragAndDropEnabled\": true\n}"
+			}
+		},
+		"modules": [{
+			"id": "d274599a-ceb5-4f2b-8651-b25787306734",
+			"name": "base_operations",
+			"description": "Set the app's identity, lifecycle status, and the document types it handles.",
+			"operations": [
+				{
+					"id": "f2ba2ddc-8527-4162-93bd-e045e9932013",
+					"name": "SET_APP_NAME",
+					"description": "Set the display name of the drive app. Also determines the generated folder name under `apps/`.",
+					"schema": "input SetAppNameInput {\n  name: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "c842efa4-154c-4fd9-9d12-42bec51af4e9",
+					"name": "SET_APP_STATUS",
+					"description": "Move the app between DRAFT and CONFIRMED. Codegen only runs once the status is CONFIRMED.",
+					"schema": "input SetAppStatusInput {\n  status: StatusType!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "7376f168-695f-4aef-94d0-6e381666358c",
+					"name": "ADD_DOCUMENT_TYPE",
+					"description": "Append a document type id to the list of types this app handles. Initializes the list if it was `null` (accept-any).",
+					"schema": "input AddDocumentTypeInput {\n  documentType: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "310e4e5b-3f14-4e9a-8e09-5583c7698a65",
+					"name": "REMOVE_DOCUMENT_TYPE",
+					"description": "Remove a document type id from the handled list. No-op if the type is not present.",
+					"schema": "input RemoveDocumentTypeInput {\n  documentType: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "b365727a-7df3-48f0-a4f8-02362f02ad1d",
+					"name": "SET_DOCUMENT_TYPES",
+					"description": "Replace the entire allowed-document-types list in one call. Pass an empty list to accept none.",
+					"schema": "input SetDocumentTypesInput {\n  documentTypes: [String!]!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				}
+			]
+		}, {
+			"id": "270faa10-92e9-40d0-b128-2de32704bcb5",
+			"name": "dnd_operations",
+			"description": "Toggle drag-and-drop file handling for the app surface.",
+			"operations": [{
+				"id": "077b1ab8-cb32-4b4e-a1fa-76178188c6a1",
+				"name": "SET_DRAG_AND_DROP_ENABLED",
+				"description": "Enable or disable drag-and-drop file handling on the app surface.",
+				"schema": "input SetDragAndDropEnabledInput {\n  enabled: Boolean!\n}",
+				"template": "",
+				"reducer": "",
+				"errors": [],
+				"examples": [],
+				"scope": "global"
+			}]
+		}],
+		"version": 1,
+		"changeLog": []
+	}]
+};
+//#endregion
+//#region document-models/document-editor/document-editor.json
+var document_editor_default = {
+	id: "powerhouse/document-editor",
+	name: "Document Editor",
+	author: {
+		"name": "Powerhouse",
+		"website": "https://powerhouse.inc"
+	},
+	extension: ".editor",
+	description: "Declares a document editor (a React UI for editing instances of one or more document models) shipped by a Vetra Reactor Package. Create one Document Editor document per editor, list the document types it can edit, then mark it CONFIRMED to trigger codegen of the editor scaffold under `editors/`. The boilerplate it produces is what you then customize.",
+	specifications: [{
+		"state": {
+			"local": {
+				"schema": "",
+				"examples": [],
+				"initialValue": ""
+			},
+			"global": {
+				"schema": "\"\"\"\nConfiguration for a document editor contributed by the package. The editor is\nregistered against every document type listed in `documentTypes`; Connect picks\nthe first matching editor when opening a document.\n\"\"\"\ntype DocumentEditorState {\n  \"\"\"Display name of the editor. Also determines the generated folder name under `editors/`.\"\"\"\n  name: String!\n  \"\"\"Document types this editor can edit. Each entry has a stable id so it can be removed individually.\"\"\"\n  documentTypes: [DocumentTypeItem!]!\n  \"\"\"Lifecycle status. While DRAFT the editor definition is editable and codegen is skipped; switching to CONFIRMED triggers scaffold generation.\"\"\"\n  status: StatusType!\n}\n\n\"\"\"A document type id (e.g. 'powerhouse/document-drive') attached to the editor with a stable entry id.\"\"\"\ntype DocumentTypeItem {\n  \"\"\"Stable identifier for the entry; used to remove it.\"\"\"\n  id: OID!\n  \"\"\"Document type id this editor handles (e.g. 'my-org/invoice').\"\"\"\n  documentType: String!\n}\n\n\"\"\"\nLifecycle status of a module definition.\n- DRAFT: still being edited; codegen does not run.\n- CONFIRMED: locked in; codegen produces the corresponding scaffold.\n\"\"\"\nenum StatusType {\n  DRAFT\n  CONFIRMED\n}",
+				"examples": [],
+				"initialValue": "{\n  \"name\": \"\",\n  \"documentTypes\": [],\n  \"status\": \"DRAFT\"\n}"
+			}
+		},
+		"modules": [{
+			"id": "73f6d103-47cb-4074-a736-a3eaf5d079bf",
+			"name": "base_operations",
+			"description": "Set the editor's identity, lifecycle status, and the document types it handles.",
+			"operations": [
+				{
+					"id": "50a16f00-d25a-4c97-9632-4ce3b951a402",
+					"name": "SET_EDITOR_NAME",
+					"description": "Set the display name of the editor. Also determines the generated folder name under `editors/`.",
+					"schema": "input SetEditorNameInput {\n  name: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "acee4272-f29e-4a19-aaf9-bae2cb6652ab",
+					"name": "ADD_DOCUMENT_TYPE",
+					"description": "Register a document type this editor can edit. Caller supplies a stable id so the entry can be removed later.",
+					"schema": "input AddDocumentTypeInput {\n  id: OID!\n  documentType: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "6c549776-0fc3-4632-a6c7-8721fa6ee41c",
+					"name": "REMOVE_DOCUMENT_TYPE",
+					"description": "Remove a registered document type entry by its id.",
+					"schema": "input RemoveDocumentTypeInput {\n  id: OID!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "e9aa7f08-553b-452f-a494-126ace6b15f7",
+					"name": "SET_EDITOR_STATUS",
+					"description": "Move the editor between DRAFT and CONFIRMED. Codegen only runs once the status is CONFIRMED — leaving it DRAFT means no editor files are produced.",
+					"schema": "input SetEditorStatusInput {\n  status: StatusType!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				}
+			]
+		}],
+		"version": 1,
+		"changeLog": []
+	}]
+};
+//#endregion
+//#region document-models/processor-module/processor-module.json
+var processor_module_default = {
+	id: "powerhouse/processor",
+	name: "Processor Module",
+	author: {
+		"name": "Powerhouse",
+		"website": "https://powerhouse.inc"
+	},
+	extension: ".processor",
+	description: "Declares a processor (a server-side function that reacts to document operations to build read models, send notifications, sync to external systems, etc.) shipped by a Vetra Reactor Package. Create one Processor Module document per processor: pick the processor type, list the document types it subscribes to, attach it to any drive apps that should run it, and mark it CONFIRMED to trigger codegen of the processor scaffold under `processors/`.",
+	specifications: [{
+		"state": {
+			"local": {
+				"schema": "",
+				"examples": [],
+				"initialValue": ""
+			},
+			"global": {
+				"schema": "\"\"\"\nConfiguration for a processor contributed by the package. A processor receives\noperations from documents of matching types and runs server-side logic (e.g.\nbuilding a read model, indexing, syncing to an external system).\n\"\"\"\ntype ProcessorModuleState {\n  \"\"\"Display name of the processor. Also determines the generated folder name under `processors/`.\"\"\"\n  name: String!\n  \"\"\"Processor implementation kind (e.g. 'read-model', 'relational-db'). Determines which scaffold codegen emits.\"\"\"\n  type: String!\n  \"\"\"Document types this processor subscribes to. Each entry has a stable id so it can be removed individually.\"\"\"\n  documentTypes: [DocumentTypeItem!]!\n  \"\"\"Lifecycle status. While DRAFT the processor definition is editable and codegen is skipped; switching to CONFIRMED triggers scaffold generation.\"\"\"\n  status: StatusType!\n  \"\"\"Drive-app names this processor is attached to. The processor runs in the context of each listed app.\"\"\"\n  processorApps: [String!]!\n}\n\n\"\"\"A document type id (e.g. 'my-org/invoice') attached to the processor with a stable entry id.\"\"\"\ntype DocumentTypeItem {\n  \"\"\"Stable identifier for the entry; used to remove it.\"\"\"\n  id: OID!\n  \"\"\"Document type id this processor subscribes to.\"\"\"\n  documentType: String!\n}\n\n\"\"\"\nLifecycle status of a module definition.\n- DRAFT: still being edited; codegen does not run.\n- CONFIRMED: locked in; codegen produces the corresponding scaffold.\n\"\"\"\nenum StatusType {\n  DRAFT\n  CONFIRMED\n}",
+				"examples": [],
+				"initialValue": "{\n  \"name\": \"\",\n  \"type\": \"\",\n  \"documentTypes\": [],\n  \"status\": \"DRAFT\",\n \"processorApps\": []\n}"
+			}
+		},
+		"modules": [{
+			"id": "91ad39c1-4e8b-4127-b3c8-e835b85e6360",
+			"name": "base_operations",
+			"description": "Set the processor's identity, kind, lifecycle status, subscribed document types, and attached drive apps.",
+			"operations": [
+				{
+					"id": "6f3a5c90-39f2-4302-a073-6195a71c5054",
+					"name": "SET_PROCESSOR_NAME",
+					"description": "Set the display name of the processor. Also determines the generated folder name under `processors/`.",
+					"schema": "input SetProcessorNameInput {\n  name: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "b8f28bb4-c6ae-40e6-86fa-29ef14ff8667",
+					"name": "SET_PROCESSOR_TYPE",
+					"description": "Set the processor implementation kind (e.g. 'read-model', 'relational-db'). Determines which scaffold codegen emits.",
+					"schema": "input SetProcessorTypeInput {\n  type: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "fbbd7a71-c495-4efc-b8f6-1e57798dbbb4",
+					"name": "ADD_DOCUMENT_TYPE",
+					"description": "Subscribe the processor to a document type. Caller supplies a stable id so the entry can be removed later.",
+					"schema": "input AddDocumentTypeInput {\n  id: OID!\n  documentType: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "544d413f-423c-4d97-9570-84a19bffeab9",
+					"name": "REMOVE_DOCUMENT_TYPE",
+					"description": "Unsubscribe the processor from a document type by removing its entry id.",
+					"schema": "input RemoveDocumentTypeInput {\n  id: OID!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "df5eb500-7308-498c-9b80-028878ee198b",
+					"name": "ADD_PROCESSOR_APP",
+					"description": "Attach the processor to a drive app by name. The processor will run in the context of that app.",
+					"schema": "input AddProcessorAppInput {\n  processorApp: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "07e4168f-1a7b-41ef-953d-219028be7bb9",
+					"name": "REMOVE_PROCESSOR_APP",
+					"description": "Detach the processor from a drive app by name. No-op if the app is not currently attached.",
+					"schema": "input RemoveProcessorAppInput {\n  processorApp: String!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				},
+				{
+					"id": "7b6706eb-5e25-4d64-829a-e3a251380fd1",
+					"name": "SET_PROCESSOR_STATUS",
+					"description": "Move the processor between DRAFT and CONFIRMED. Codegen only runs once the status is CONFIRMED.",
+					"schema": "input SetProcessorStatusInput {\n  status: StatusType!\n}",
+					"template": "",
+					"reducer": "",
+					"errors": [],
+					"examples": [],
+					"scope": "global"
+				}
+			]
+		}],
+		"version": 1,
+		"changeLog": []
+	}]
+};
+//#endregion
+//#region document-models/subgraph-module/subgraph-module.json
+var subgraph_module_default = {
+	id: "powerhouse/subgraph",
+	name: "Subgraph Module",
+	author: {
+		"name": "Powerhouse",
+		"website": "https://powerhouse.inc"
+	},
+	extension: ".subgraph",
+	description: "Declares a GraphQL subgraph (a slice of the Switchboard API contributed by the package) shipped by a Vetra Reactor Package. Create one Subgraph Module document per subgraph, then mark it CONFIRMED to trigger codegen of the subgraph scaffold under `subgraphs/` — the resolvers and schema you flesh out there are stitched into the Switchboard graph at runtime.",
+	specifications: [{
+		"state": {
+			"local": {
+				"schema": "",
+				"examples": [],
+				"initialValue": ""
+			},
+			"global": {
+				"schema": "\"\"\"\nConfiguration for a GraphQL subgraph contributed by the package. The subgraph\nis served by Switchboard and stitched into the unified Powerhouse API.\n\"\"\"\ntype SubgraphModuleState {\n  \"\"\"Display name of the subgraph. Also determines the generated folder name under `subgraphs/` and the route segment Switchboard mounts it at.\"\"\"\n  name: String!\n  \"\"\"Lifecycle status. While DRAFT the subgraph definition is editable and codegen is skipped; switching to CONFIRMED triggers scaffold generation.\"\"\"\n  status: StatusType!\n}\n\n\"\"\"\nLifecycle status of a module definition.\n- DRAFT: still being edited; codegen does not run.\n- CONFIRMED: locked in; codegen produces the corresponding scaffold.\n\"\"\"\nenum StatusType {\n  DRAFT\n  CONFIRMED\n}",
+				"examples": [],
+				"initialValue": "{\n  \"name\": \"\",\n  \"status\": \"DRAFT\"\n}"
+			}
+		},
+		"modules": [{
+			"id": "8af5bda9-6fc7-4427-bfed-1d32d76a552f",
+			"name": "base_operations",
+			"description": "Set the subgraph's identity and lifecycle status.",
+			"operations": [{
+				"id": "d7cd6b6b-01ea-42c8-97e2-288e04b50b42",
+				"name": "SET_SUBGRAPH_NAME",
+				"description": "Set the display name of the subgraph. Also determines the generated folder under `subgraphs/` and the route segment Switchboard mounts it at.",
+				"schema": "input SetSubgraphNameInput {\n  name: String!\n}",
+				"template": "",
+				"reducer": "",
+				"errors": [],
+				"examples": [],
+				"scope": "global"
+			}, {
+				"id": "5a20e641-dc36-428e-8924-ecb07f3f1b94",
+				"name": "SET_SUBGRAPH_STATUS",
+				"description": "Move the subgraph between DRAFT and CONFIRMED. Codegen only runs once the status is CONFIRMED.",
+				"schema": "input SetSubgraphStatusInput {\n  status: StatusType!\n}",
+				"template": "",
+				"reducer": "",
+				"errors": [],
+				"examples": [],
+				"scope": "global"
+			}]
+		}],
+		"version": 1,
+		"changeLog": []
+	}]
+};
+//#endregion
+//#region codegen/specs.ts
+const SPECS_DIRNAME = "specs";
+const documentModelDocumentType = "powerhouse/document-model";
+const SPECS = {
+	[documentModelDocumentType]: {
+		documentType: documentModelDocumentType,
+		subdir: "document-models",
+		reducer: documentModelDocumentModelModule.reducer,
+		utils: documentModelDocumentModelModule.utils,
+		actions: documentModelDocumentModelModule.actions,
+		createDocument: documentModelDocumentModelModule.utils.createDocument,
+		jsonSpec: documentModelDocumentModelModule.documentModel.global
+	},
+	[documentEditorDocumentType]: {
+		documentType: documentEditorDocumentType,
+		subdir: "editors",
+		reducer: reducer$1,
+		utils: utils$1,
+		actions: actions$1,
+		createDocument: createDocumentEditorDocument,
+		jsonSpec: document_editor_default
+	},
+	[processorModuleDocumentType]: {
+		documentType: processorModuleDocumentType,
+		subdir: "processors",
+		reducer: reducer$2,
+		utils: utils$2,
+		actions: actions$2,
+		createDocument: createProcessorModuleDocument,
+		jsonSpec: processor_module_default
+	},
+	[subgraphModuleDocumentType]: {
+		documentType: subgraphModuleDocumentType,
+		subdir: "subgraphs",
+		reducer: reducer$3,
+		utils: utils$3,
+		actions: actions$3,
+		createDocument: createSubgraphModuleDocument,
+		jsonSpec: subgraph_module_default
+	},
+	[appModuleDocumentType]: {
+		documentType: appModuleDocumentType,
+		subdir: "apps",
+		reducer,
+		utils,
+		actions,
+		createDocument: createAppModuleDocument,
+		jsonSpec: app_module_default
+	}
+};
+function getSpecEntry(documentType) {
+	const entry = SPECS[documentType];
+	if (!entry) throw new Error(`No spec handler registered for "${documentType}"`);
+	return entry;
+}
+function listSpecDocumentTypes() {
+	return Object.keys(SPECS);
+}
+/** Returns the directory that holds specs for a given document type. */
+function specDir(projectDir, documentType) {
+	return join(projectDir, SPECS_DIRNAME, getSpecEntry(documentType).subdir);
+}
+/**
+* Deterministic path for a doc-type + display name.
+* Format: `<projectDir>/<specsDir>/<subdir>/<kebab-name>.<ext>.phd`.
+*/
+function specPath(projectDir, documentType, name) {
+	const entry = getSpecEntry(documentType);
+	const baseName = kebabCase(name);
+	const ext = stripLeadingDot(entry.utils.fileExtension);
+	return join(specDir(projectDir, documentType), `${baseName}.${ext}.phd`);
+}
+function stripLeadingDot(ext) {
+	return ext.startsWith(".") ? ext.slice(1) : ext;
+}
+/** Saves a document into `<projectDir>/specs/<subdir>/<kebab-name>.<ext>.phd`. */
+async function saveSpec(doc, projectDir) {
+	const entry = getSpecEntry(doc.header.documentType);
+	const dir = specDir(projectDir, doc.header.documentType);
+	await mkdir(dir, { recursive: true });
+	const name = kebabCase(doc.header.name || "untitled");
+	return baseSaveToFile(doc, dir, stripLeadingDot(entry.utils.fileExtension), name);
+}
+//#endregion
+//#region codegen/spec-api.ts
+/** Mirrors reactor-mcp `getDocumentModels`. */
+function getDocumentModels() {
+	return listSpecDocumentTypes().map((documentType) => {
+		const { jsonSpec } = getSpecEntry(documentType);
+		return {
+			name: jsonSpec.name,
+			type: jsonSpec.id,
+			description: jsonSpec.description ?? "",
+			extension: jsonSpec.extension ?? "",
+			authorName: jsonSpec.author?.name ?? "",
+			authorWebsite: jsonSpec.author?.website ?? ""
+		};
+	});
+}
+/** Mirrors reactor-mcp `getDocumentModelSchema`. Returns the full
+*  `DocumentModelGlobalState` (schema + operations + errors), same payload
+*  shape reactor-mcp serves. */
+function getDocumentModelSchema(documentType) {
+	return getSpecEntry(documentType).jsonSpec;
+}
+/** Mirrors reactor-mcp `getDocument`. Path = file location on disk. */
+async function getDocument(path) {
+	const subdir = pathSubdir(path);
+	const hint = subdir ? listSpecDocumentTypes().find((t) => getSpecEntry(t).subdir === subdir) : void 0;
+	const order = hint ? [hint, ...listSpecDocumentTypes().filter((t) => t !== hint)] : listSpecDocumentTypes();
+	let lastError;
+	for (const documentType of order) {
+		const { reducer } = getSpecEntry(documentType);
+		try {
+			return await baseLoadFromFile(path, reducer);
+		} catch (err) {
+			lastError = err;
+		}
+	}
+	throw new Error(`Failed to load spec at "${path}": no registered reducer accepted it. Last error: ${String(lastError)}`);
+}
+/** Mirrors reactor-mcp `getDocuments`. `parentId` is the project directory
+*  containing `specs/`. */
+async function getDocuments(projectDir, opts = {}) {
+	const documentTypes = opts.documentType ? [opts.documentType] : listSpecDocumentTypes();
+	const results = [];
+	for (const documentType of documentTypes) {
+		const dir = specDir(projectDir, documentType);
+		if (!await stat(dir).then((s) => s.isDirectory(), () => false)) continue;
+		const entries = await readdir(dir);
+		for (const entry of entries) {
+			if (!entry.endsWith(".phd")) continue;
+			results.push(await getDocument(join(dir, entry)));
+		}
+	}
+	return results;
+}
+/** Mirrors reactor-mcp `createDocument`. Returns an in-memory document; the
+*  caller persists with `saveSpec`. */
+function createDocument(documentType, opts = {}) {
+	const doc = getSpecEntry(documentType).createDocument(opts.initialState);
+	if (opts.name) doc.header.name = opts.name;
+	return doc;
+}
+/** Mirrors reactor-mcp `addActions`. Validates every action up front against
+*  the document model's latest specification, then applies them in order via
+*  the reducer. If any action is invalid, throws an aggregated error and
+*  leaves `doc` untouched. */
+function addActions(doc, actions) {
+	const entry = getSpecEntry(doc.header.documentType);
+	const built = validateAndBuildActions(entry, actions);
+	let current = doc;
+	for (let i = 0; i < built.length; i++) {
+		const action = built[i];
+		current = entry.reducer(current, action);
+		const scope = action.scope ?? "global";
+		const ops = current.operations[scope];
+		const last = ops?.[ops.length - 1];
+		if (last?.error) throw formatValidationError([{
+			index: i,
+			type: actions[i].type ?? "<missing>",
+			errors: [`Reducer error: ${last.error}`]
+		}]);
+	}
+	return current;
+}
+/** Validate a list of actions without applying them. Returns one entry per
+*  invalid action with all of its problems aggregated. Used by `addActions`
+*  and exposed for callers that want a dry-run check. */
+function validateActions(documentType, actions) {
+	const entry = getSpecEntry(documentType);
+	const failures = [];
+	for (let i = 0; i < actions.length; i++) {
+		const errors = collectActionErrors(entry, actions[i]);
+		if (errors.length > 0) failures.push({
+			index: i,
+			type: actions[i].type ?? "<missing>",
+			errors
+		});
+	}
+	return failures;
+}
+/** Run validateActions across the batch and, on success, materialize the
+*  built Action objects. On any failure throws with every action's errors
+*  aggregated — the caller never sees a partial apply. */
+function validateAndBuildActions(entry, actions) {
+	const built = [];
+	const failures = [];
+	for (let i = 0; i < actions.length; i++) {
+		const item = actions[i];
+		const errors = collectActionErrors(entry, item);
+		if (errors.length > 0) {
+			failures.push({
+				index: i,
+				type: item.type ?? "<missing>",
+				errors
+			});
+			continue;
+		}
+		built.push(buildAction(entry.actions, item));
+	}
+	if (failures.length > 0) throw formatValidationError(failures);
+	return built;
+}
+function collectActionErrors(entry, item) {
+	const errors = [];
+	if (typeof item.type !== "string" || item.type.length === 0) {
+		errors.push("Missing `type` field");
+		return errors;
+	}
+	const specs = entry.jsonSpec.specifications;
+	if (!specs || specs.length === 0) {
+		errors.push("Document model has no specifications");
+		return errors;
+	}
+	const latest = specs[specs.length - 1];
+	let operation;
+	for (const module of latest.modules ?? []) {
+		const found = (module.operations ?? []).find((op) => op.name === item.type);
+		if (found) {
+			operation = found;
+			break;
+		}
+	}
+	if (!operation) errors.push(`Operation "${item.type}" is not defined in any module of the document model`);
+	const creatorName = camelCase(item.type);
+	const creator = entry.actions[creatorName];
+	if (!creator) errors.push(`No action creator found.`);
+	else try {
+		creator(item.input);
+	} catch (err) {
+		errors.push(`Input validation error: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	if (operation?.scope && item.scope && item.scope !== operation.scope) errors.push(`Scope "${item.scope}" does not match operation scope "${operation.scope}"`);
+	return errors;
+}
+function formatValidationError(failures) {
+	const lines = failures.map((f) => `  [${f.index}] ${f.type}: ${f.errors.join("; ")}`);
+	const header = failures.length === 1 ? "1 action failed validation:" : `${failures.length} actions failed validation:`;
+	const err = new Error([header, ...lines].join("\n"));
+	err.failures = failures;
+	return err;
+}
+function buildAction(actionsModule, item) {
+	const creatorName = camelCase(item.type);
+	const creator = actionsModule[creatorName];
+	if (!creator) throw new Error(`No action creator found for "${item.type}" (looked up as "${creatorName}")`);
+	const action = creator(item.input);
+	if (item.scope) action.scope = item.scope;
+	return action;
+}
+/** Mirrors reactor-mcp `deleteDocument`. Removes the spec file from disk. */
+async function deleteDocument(path) {
+	try {
+		await rm(path);
+		return { success: true };
+	} catch {
+		return { success: false };
+	}
+}
+async function addActionsAndSave(path, projectDir, actions) {
+	const next = addActions(await getDocument(path), actions);
+	return {
+		doc: next,
+		savedPath: await saveSpec(next, projectDir)
+	};
+}
+function pathSubdir(filePath) {
+	const parts = filePath.split(/[/\\]/);
+	const i = parts.lastIndexOf(SPECS_DIRNAME);
+	if (i < 0 || i + 1 >= parts.length) return void 0;
+	return parts[i + 1];
+}
+//#endregion
+export { SPECS_DIRNAME, addActions, addActionsAndSave, createDocument, deleteDocument, extractAllDocuments, extractAppDocuments, extractDocumentModelDocuments, extractEditorDocuments, extractProcessorDocuments, extractSubgraphDocuments, generateAppFromDocument, generateDocumentModelFromDocument, generateEditorFromDocument, generateProcessorFromDocument, generateSubgraphFromDocument, getDocument, getDocumentModelSchema, getDocumentModels, getDocuments, getSpecEntry, listSpecDocumentTypes, saveSpec, specDir, specPath, stripLeadingDot, validateActions };
+
+//# sourceMappingURL=index.js.map