@powerhousedao/codegen 6.0.0-dev.190 → 6.0.0-dev.192

package/dist/{templates-BbNsigQX.mjs → file-builders-BkbVW0kT.mjs}

@@ -1,5 +1,19 @@
-import { getActionInputName, getActionInputTypeNames, getActionType, getActionTypeName } from "./src/name-builders/index.mjs";
+import { DocumentModelGlobalStateSchema, ManifestSchema } from "@powerhousedao/shared/document-model";
 import { camelCase, capitalCase, constantCase, kebabCase, pascalCase } from "change-case";
+import path, { join } from "path";
+import { capitalize, concat, filter, find, flatMap, forEach, fromEntries, isIncludedIn, isNonNullish, isString, isTruthy, last, map, merge, pipe, prop, sort, subtract, unique, uniqueBy, when } from "remeda";
+import { IndentationText, Project, SyntaxKind, VariableDeclarationKind, ts } from "ts-morph";
+import arg from "arg";
+import { readdirSync, statSync } from "fs";
+import { loadJsonFile, loadJsonFileSync } from "load-json-file";
+import { VERSIONED_DEPENDENCIES, VERSIONED_DEV_DEPENDENCIES, directoryExists, fileExists, makeVersionedDependencies, spawnAsync, writeFileEnsuringDir } from "@powerhousedao/shared/clis";
+import { format } from "prettier";
+import fs, { copyFile, mkdir, readdir, writeFile } from "node:fs/promises";
+import { stripVTControlCharacters } from "node:util";
+import path$1, { join as join$1, relative } from "node:path";
+import { generate } from "@graphql-codegen/cli";
+import { generatorTypeDefs, validationSchema } from "@powerhousedao/document-engineering/graphql";
+import { writeJsonFile } from "write-json-file";
 function isEOL(c) {
 	return c === 10 || c === 13;
 }
@@ -302,7 +316,7 @@ const int = {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/@jsr+std__yaml@1.0.12/node_modules/@jsr/std__yaml/_type/map.js
-const map = {
+const map$1 = {
 	tag: "tag:yaml.org,2002:map",
 	resolve() {
 		return true;
@@ -314,7 +328,7 @@ const map = {
 };
 //#endregion
 //#region ../../node_modules/.pnpm/@jsr+std__yaml@1.0.12/node_modules/@jsr/std__yaml/_type/merge.js
-const merge = {
+const merge$1 = {
 	tag: "tag:yaml.org,2002:merge",
 	kind: "scalar",
 	resolve: (data) => data === "<<" || data === null,
@@ -525,7 +539,7 @@ function createSchema({ explicitTypes = [], implicitTypes = [], include }) {
 */ const FAILSAFE_SCHEMA = createSchema({ explicitTypes: [
 	str,
 	seq,
-	map
+	map$1
 ] });
 /**
 * Standard YAML's JSON schema.
@@ -554,7 +568,7 @@ function createSchema({ explicitTypes = [], implicitTypes = [], include }) {
 		pairs,
 		set
 	],
-	implicitTypes: [timestamp, merge],
+	implicitTypes: [timestamp, merge$1],
 	include: CORE_SCHEMA
 });
 /***
@@ -1720,7 +1734,7 @@ var TemplateClass = class TemplateClass extends String {
 const html = tag("html");
 const css = tag("css");
 const js = tag("js");
-const ts = tag("ts");
+const ts$1 = tag("ts");
 tag("jsx");
 const tsx = tag("tsx");
 const json = tag("json", JSON.parse);
@@ -2079,10 +2093,9 @@ export function NavigationBreadcrumbs() {
 `.raw;
 //#endregion
 //#region src/templates/app/config.ts
-const appConfigFileTemplate = (v) => ts`
+const appConfigFileTemplate = (v) => ts$1`
 import type { PHAppConfig } from "@powerhousedao/reactor-browser";
 
-/** Editor config for the <%= pascalCaseAppName %> */
 export const editorConfig: PHAppConfig = {
   isDragAndDropEnabled: ${v.isDragAndDropEnabledString},
   allowedDocumentTypes: ${v.allowedDocumentTypesString}
@@ -2091,6 +2104,10 @@ export const editorConfig: PHAppConfig = {
 //#endregion
 //#region src/templates/app/editor.ts
 const appEditorFileTemplate = () => tsx`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import { useSetPHAppConfig } from "@powerhousedao/reactor-browser";
 import type { EditorProps } from "document-model";
 import { DriveExplorer } from "./components/DriveExplorer.js";
@@ -2941,24 +2958,53 @@ exec ph switchboard --port \${PORT:-3000}
 `;
 //#endregion
 //#region src/templates/boilerplate/document-models/document-models.ts
-const documentModelsTemplate = ts`
+const documentModelsTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { DocumentModelModule } from "document-model";
 
-export const documentModels: DocumentModelModule[] = [];
+export const documentModels: DocumentModelModule<any>[] = [];
 `.raw;
 //#endregion
 //#region src/templates/boilerplate/document-models/index.ts
-const documentModelsIndexTemplate = "";
+const documentModelsIndexTemplate = `
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+`;
+//#endregion
+//#region src/templates/boilerplate/document-models/upgrade-manifests.ts
+const upgradeManifestsTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+import type { UpgradeManifest } from "document-model";
+
+export const upgradeManifests: UpgradeManifest<readonly number[]>[] = [];
+`.raw;
 //#endregion
 //#region src/templates/boilerplate/editors/editors.ts
-const editorsTemplate = ts`
+const editorsTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { EditorModule } from "document-model";
 
 export const editors: EditorModule[] = [];
 `.raw;
 //#endregion
 //#region src/templates/boilerplate/editors/index.ts
-const editorsIndexTemplate = "";
+const editorsIndexTemplate = `
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+`;
 //#endregion
 //#region src/templates/boilerplate/eslint.config.js.ts
 const eslintConfigTemplate = js`
@@ -3507,14 +3553,18 @@ function _taggedTemplateLiteral(e, t) {
 //#endregion
 //#region src/templates/boilerplate/index.html.ts
 var _templateObject$1;
-const indexHtmlTemplate = html(_templateObject$1 || (_templateObject$1 = _taggedTemplateLiteral(["<!DOCTYPE html>\n  <html lang=\"en\">\n    <head>\n      <meta charset=\"UTF-8\" />\n      <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n      <meta\n        name=\"description\"\n        content=\"Connect is a hub for your most important documents and processes, translated into software. Easily capture data in a structured way with dedicated business process packages. Collaborate on shared documents with ease while using your preferred storage solution (decentralized, centralized, or local).\"\n      />\n      <title>Powerhouse Connect</title>\n      <link rel=\"icon\" href=\"/icon.ico\" />\n      <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n      <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n      <link\n        href=\"https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap\"\n        rel=\"stylesheet\"\n      />\n    </head>\n    <body>\n      <div id=\"root\"></div>\n      <link href=\"/style.css\" rel=\"stylesheet\" />\n      <script type=\"module\" src=\"/main.tsx\"><\/script>\n    </body>\n  </html> "]))).raw;
+const indexHtmlTemplate = html(_templateObject$1 || (_templateObject$1 = _taggedTemplateLiteral(["<!doctype html>\n  <html lang=\"en\">\n    <head>\n      <meta charset=\"UTF-8\" />\n      <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n      <meta\n        name=\"description\"\n        content=\"Connect is a hub for your most important documents and processes, translated into software. Easily capture data in a structured way with dedicated business process packages. Collaborate on shared documents with ease while using your preferred storage solution (decentralized, centralized, or local).\"\n      />\n      <title>Powerhouse Connect</title>\n      <link rel=\"icon\" href=\"/icon.ico\" />\n      <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n      <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n      <link\n        href=\"https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap\"\n        rel=\"stylesheet\"\n      />\n    </head>\n    <body>\n      <div id=\"root\"></div>\n      <link href=\"/style.css\" rel=\"stylesheet\" />\n      <script type=\"module\" src=\"/main.tsx\"><\/script>\n    </body>\n  </html> "]))).raw;
 //#endregion
 //#region src/templates/boilerplate/index.html.legacy.ts
 var _templateObject;
 const legacyIndexHtmlTemplate = html(_templateObject || (_templateObject = _taggedTemplateLiteral(["\n  <!DOCTYPE html>\n  <html lang=\"en\">\n    <head>\n      <meta charset=\"UTF-8\" />\n      <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n      <meta\n        name=\"description\"\n        content=\"Connect is a hub for your most important documents and processes, translated into software. Easily capture data in a structured way with dedicated business process packages. Collaborate on shared documents with ease while using your preferred storage solution (decentralized, centralized, or local).\"\n      />\n      <title>Powerhouse Connect</title>\n      <link rel=\"icon\" href=\"/icon.ico\" />\n      <link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" />\n      <link rel=\"preconnect\" href=\"https://fonts.gstatic.com\" crossorigin />\n      <link\n        href=\"https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap\"\n        rel=\"stylesheet\"\n      />\n      <style>\n        @import \"tailwindcss\";\n        @import \"@powerhousedao/design-system/style.css\";\n        @import \"@powerhousedao/document-engineering/style.css\";\n        @source \"./node_modules/@powerhousedao/connect\";\n      </style>\n    </head>\n    <body>\n      <div id=\"root\"></div>\n      <script type=\"module\">\n        // initializes Connect on '<div id=\"root\"></div>'\n        import \"@powerhousedao/connect/main.js\";\n      <\/script>\n    </body>\n  </html>\n"]))).raw;
 //#endregion
 //#region src/templates/boilerplate/index.ts
-const indexTsTemplate = ts`
+const indexTsTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { Manifest } from "document-model";
 import manifestJson from "./powerhouse.manifest.json" with { type: "json" };
 export { documentModels } from "./document-models/document-models.js";
@@ -4191,6 +4241,10 @@ For more information on this, and how to apply and follow the GNU AGPL, see
 //#endregion
 //#region src/templates/boilerplate/main.tsx.ts
 const mainTsxTemplate = tsx`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import { startConnect } from "@powerhousedao/connect";
 import * as localPackage from "./index.js";
 
@@ -4288,8 +4342,6 @@ const dependenciesTemplate = (versionedDependencies) => json`
 `.raw;
 const devDependenciesTemplate = (versionedDevDependencies) => json`
   ${versionedDevDependencies.join(",\n")},
-  "@electric-sql/pglite": "0.3.15",
-  "@electric-sql/pglite-tools": "0.2.20",
   "@eslint/js": "^9.38.0",
   "@tailwindcss/cli": "^4.1.18",
   "@types/node": "^24.9.2",
@@ -4303,7 +4355,6 @@ const devDependenciesTemplate = (versionedDevDependencies) => json`
   "tailwindcss": "^4.1.16",
   "typescript": "^5.9.3",
   "typescript-eslint": "^8.46.2",
-  "vite": "8.0.2",
   "vitest": "4.1.1",
   "@vitejs/plugin-react": "6.0.1",
   "vite-tsconfig-paths": "6.1.1"
@@ -4649,7 +4700,12 @@ const styleTemplate = css`
 `.raw;
 //#endregion
 //#region src/templates/boilerplate/subgraphs/index.ts
-const subgraphsIndexTemplate = "";
+const subgraphsIndexTemplate = `
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+`;
 //#endregion
 //#region src/templates/boilerplate/tsconfig.json.ts
 const tsconfigPathsTemplate = json`
@@ -4703,29 +4759,8 @@ const tsConfigTemplate = json`
 }
 `.raw;
 //#endregion
-//#region src/templates/boilerplate/vite.config.ts.ts
-const viteConfigTemplate = ts`
-import { getConnectBaseViteConfig } from "@powerhousedao/builder-tools";
-import { defineConfig, mergeConfig, type UserConfig } from "vite";
-
-export default defineConfig(({ mode }) => {
-  const baseConnectViteConfig = getConnectBaseViteConfig({
-    mode,
-    dirname: import.meta.dirname,
-  });
-
-  const additionalViteConfig: UserConfig = {
-    // add your own vite config here
-  };
-
-  const config = mergeConfig(baseConnectViteConfig, additionalViteConfig);
-
-  return config;
-});
-`;
-//#endregion
 //#region src/templates/boilerplate/vitest.config.ts.ts
-const vitestConfigTemplate = ts`
+const vitestConfigTemplate = ts$1`
 import { defineConfig } from "vitest/config";
 import react from "@vitejs/plugin-react";
 import tsconfigPaths from "vite-tsconfig-paths";
@@ -4892,6 +4927,10 @@ export default function Editor() {
 //#endregion
 //#region src/templates/document-editor/module.ts
 const documentEditorModuleFileTemplate = (v) => tsx`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { EditorModule } from "document-model";
 import { lazy } from "react";
 
@@ -4921,12 +4960,16 @@ function buildModuleActionsSpreadExport(modules, camelCaseDocumentType) {
 	return `
 export const actions = { ...baseActions, ${buildModuleActionsNames(modules, camelCaseDocumentType).map((n) => `...${n}`).join(",\n")} }`;
 }
-const documentModelRootActionsFileTemplate = (v) => ts`
+const documentModelRootActionsFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import { baseActions } from "document-model";
-${buildModuleActionsImports(v.modules, v.camelCaseDocumentType)}
+${buildModuleActionsImports(v.specification.modules, v.camelCaseDocumentType)}
 
 /** Actions for the ${v.pascalCaseDocumentType} document model */
-${buildModuleActionsSpreadExport(v.modules, v.camelCaseDocumentType)}
+${buildModuleActionsSpreadExport(v.specification.modules, v.camelCaseDocumentType)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/actions.ts
@@ -4951,16 +4994,24 @@ function makeModuleActionTypesUnion(modules, pascalCaseDocumentType) {
 function makeDocumentActionType(modules, pascalCaseDocumentType) {
 	return `export type ${pascalCaseDocumentType}Action = ${makeModuleActionTypesUnion(modules, pascalCaseDocumentType)};`;
 }
-const documentModelGenActionsFileTemplate = (v) => ts`
-${makeModuleActionsTypeImports(v.modules, v.pascalCaseDocumentType)}
+const documentModelGenActionsFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+${makeModuleActionsTypeImports(v.specification.modules, v.pascalCaseDocumentType)}
 
-${makeModuleActionsTypeExports(v.modules)}
+${makeModuleActionsTypeExports(v.specification.modules)}
 
-${makeDocumentActionType(v.modules, v.pascalCaseDocumentType)}
+${makeDocumentActionType(v.specification.modules, v.pascalCaseDocumentType)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/controller.ts
-const documentModelGenControllerFileTemplate = (v) => ts`
+const documentModelGenControllerFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import { PHDocumentController } from "document-model";
 import { ${v.pascalCaseDocumentType} } from "../module.js";
 import type { ${v.actionTypeName}, ${v.phStateName} } from "./types.js";
@@ -4981,12 +5032,20 @@ function buildModuleCreatorsExport(module, camelCaseDocumentType) {
 function buildCreatorsExports(modules, camelCaseDocumentType) {
 	return modules.flatMap((module) => buildModuleCreatorsExport(module, camelCaseDocumentType)).join("\n");
 }
-const documentModelGenCreatorsFileTemplate = (v) => ts`
-${buildCreatorsExports(v.modules, v.camelCaseDocumentType)}
+const documentModelGenCreatorsFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+${buildCreatorsExports(v.specification.modules, v.camelCaseDocumentType)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/document-schema.ts
-const documentModelDocumentSchemaFileTemplate = (v) => ts`
+const documentModelDocumentSchemaFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import {
   BaseDocumentHeaderSchema,
   BaseDocumentStateSchema,
@@ -5042,8 +5101,12 @@ export function ${v.assertIsPhDocumentOfTypeFunctionName}(
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/document-type.ts
-const documentModelDocumentTypeTemplate = (v) => ts`
-export const ${v.documentTypeVariableName} = "${v.documentTypeId}";
+const documentModelDocumentTypeTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+export const ${v.documentTypeVariableName} = "${v.documentModelState.id}";
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/index.ts
@@ -5053,7 +5116,11 @@ function buildModuleOperationsExports(module) {
 function buildModulesOperationsExports(modules) {
 	return modules.map(buildModuleOperationsExports).join("\n");
 }
-const documentModelGenIndexFileTemplate = (v) => ts`
+const documentModelGenIndexFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 export * from './actions.js';
 export * from './document-model.js';
 export * from './types.js';
@@ -5071,113 +5138,221 @@ export * from "./controller.js";
 export * from "./schema/index.js";
 export * from "./document-type.js";
 export * from "./document-schema.js";
-${buildModulesOperationsExports(v.modules)}
+${buildModulesOperationsExports(v.specification.modules)}
 `.raw;
 //#endregion
+//#region src/name-builders/get-action-names.ts
+function getActionTypeName(operation) {
+	if (!operation.name) return;
+	return `${pascalCase(operation.name)}Action`;
+}
+function getActionInputName(operation) {
+	if (!operation.name) return;
+	if (!operationHasInput(operation)) return;
+	return `${pascalCase(operation.name)}Input`;
+}
+function getActionType(operation) {
+	if (!operation.name) return;
+	return constantCase(operation.name);
+}
+function getActionInputTypeNames(args) {
+	return args.module.operations.map(getActionInputName).join(",\n");
+}
+//#endregion
+//#region src/name-builders/get-variable-names.ts
+function getEditorVariableNames({ documentModelDocumentTypeName }) {
+	return {
+		documentModelDocumentTypeName,
+		documentVariableName: camelCase(documentModelDocumentTypeName),
+		useSelectedDocumentHookName: `useSelected${documentModelDocumentTypeName}`,
+		documentNameVariableName: `${documentModelDocumentTypeName}Name`,
+		dispatchFunctionName: "dispatch",
+		onClickEditHandlerName: `onClickEdit${documentModelDocumentTypeName}Name`,
+		onCancelEditHandlerName: `onClickCancelEdit${documentModelDocumentTypeName}Name`,
+		setNameActionName: "setName",
+		isEditingVariableName: "isEditing",
+		setIsEditingFunctionName: "setIsEditing",
+		onSubmitSetNameFunctionName: `onSubmitSet${documentModelDocumentTypeName}Name`
+	};
+}
+function getDocumentModelDirName(documentModelState, existingDirName) {
+	if (existingDirName) return existingDirName;
+	return kebabCase(documentModelState.name);
+}
+function getLatestDocumentModelSpec({ specifications }) {
+	return specifications[specifications.length - 1];
+}
+function getDocumentModelSpecByVersionNumber({ specifications }, version) {
+	const specificationByIndex = specifications[version];
+	const specificationByNumber = specifications.find((spec) => spec.version === version);
+	if (!specificationByNumber) {
+		console.error(`Specification with version number ${version} does not exist in the document model specifications array`);
+		return specificationByIndex;
+	}
+	if (specificationByIndex.version !== specificationByNumber.version) {
+		console.error(`Specification with version ${version} does not match specifications array at index ${version}`);
+		return specificationByIndex;
+	}
+	return specificationByNumber;
+}
+function getLatestDocumentModelSpecVersionNumber(documentModelState) {
+	return getLatestDocumentModelSpec(documentModelState).version;
+}
+function getDocumentModelVariableNames(documentModelName) {
+	const kebabCaseDocumentType = kebabCase(documentModelName);
+	const pascalCaseDocumentType = pascalCase(documentModelName);
+	const camelCaseDocumentType = camelCase(documentModelName);
+	const documentTypeVariableName = `${camelCaseDocumentType}DocumentType`;
+	const stateName = `${pascalCaseDocumentType}State`;
+	const globalStateName = `${pascalCaseDocumentType}GlobalState`;
+	const localStateName = `${pascalCaseDocumentType}LocalState`;
+	const phStateName = `${pascalCaseDocumentType}PHState`;
+	const phDocumentTypeName = `${pascalCaseDocumentType}Document`;
+	const actionTypeName = `${pascalCaseDocumentType}Action`;
+	const actionsTypeName = `${actionTypeName}s`;
+	const actionsName = camelCase(actionsTypeName);
+	return {
+		kebabCaseDocumentType,
+		pascalCaseDocumentType,
+		camelCaseDocumentType,
+		documentTypeVariableName,
+		upgradeManifestName: `${camelCaseDocumentType}UpgradeManifest`,
+		stateName,
+		globalStateName,
+		localStateName,
+		phStateName,
+		phDocumentTypeName,
+		actionTypeName,
+		actionsTypeName,
+		actionsName,
+		stateSchemaName: `${stateName}Schema`,
+		phDocumentSchemaName: `${phDocumentTypeName}Schema`,
+		isPhStateOfTypeFunctionName: `is${stateName}`,
+		assertIsPhStateOfTypeFunctionName: `assertIs${stateName}`,
+		isPhDocumentOfTypeFunctionName: `is${phDocumentTypeName}`,
+		assertIsPhDocumentOfTypeFunctionName: `assertIs${phDocumentTypeName}`,
+		useByIdHookName: `use${phDocumentTypeName}ById`,
+		useSelectedHookName: `useSelected${phDocumentTypeName}`,
+		useInSelectedDriveHookName: `use${phDocumentTypeName}sInSelectedDrive`,
+		useInSelectedFolderHookName: `use${phDocumentTypeName}sInSelectedFolder`
+	};
+}
+//#endregion
 //#region src/templates/document-model/gen/modules/actions.ts
-function getActionTypeExport(action) {
-	const baseActionTypeName = action.hasAttachment ? "ActionWithAttachment" : "Action";
-	const actionTypeName = getActionTypeName(action);
-	const actionInputName = getActionInputName(action) ?? `"{}"`;
-	return ts`export type ${actionTypeName} = ${baseActionTypeName} & { type: "${getActionType(action)}"; input: ${actionInputName} };`.raw;
+function getActionTypeExport(operation) {
+	const baseActionTypeName = operationHasAttachment(operation) ? "ActionWithAttachment" : "Action";
+	const actionTypeName = getActionTypeName(operation);
+	const actionInputName = getActionInputName(operation) ?? `"{}"`;
+	return ts$1`export type ${actionTypeName} = ${baseActionTypeName} & { type: "${getActionType(operation)}"; input: ${actionInputName} };`.raw;
 }
-function getActionTypeExports(actions) {
-	return actions.map(getActionTypeExport).join("\n");
+function getActionTypeExports(args) {
+	return args.module.operations.map(getActionTypeExport).join("\n");
 }
-function getModuleExportType(actions, pascalCaseDocumentName, pascalCaseModuleName) {
-	return ts`export type ${pascalCaseDocumentName}${pascalCaseModuleName}Action = ${actions.map(getActionTypeName).join(" |\n")};`.raw;
+function getModuleExportType(args) {
+	const { pascalCaseDocumentType, module } = args;
+	const actionTypeNames = module.operations.map(getActionTypeName).join(" |\n");
+	return ts$1`export type ${pascalCaseDocumentType}${pascalCase(module.name)}Action = ${actionTypeNames};`.raw;
 }
-function getDocumentModelActionTypeImportNames(actions) {
+function getDocumentModelActionTypeImportNames(args) {
 	const actionTypeImports = ["Action"];
-	if (actions.some((a) => a.hasAttachment)) actionTypeImports.push("ActionWithAttachment");
+	if (args.module.operations.some((a) => operationHasAttachment(a))) actionTypeImports.push("ActionWithAttachment");
 	return actionTypeImports.join(",\n");
 }
-const documentModelOperationModuleActionsFileTemplate = (v) => ts`
-import type { ${getDocumentModelActionTypeImportNames(v.actions)} } from 'document-model';
+const documentModelOperationModuleActionsFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+import type { ${getDocumentModelActionTypeImportNames(v)} } from 'document-model';
 import type {
-  ${getActionInputTypeNames(v.actions)}
+  ${getActionInputTypeNames(v)}
 } from '../types.js';
 
-${getActionTypeExports(v.actions)}
+${getActionTypeExports(v)}
 
-${getModuleExportType(v.actions, v.pascalCaseDocumentType, v.pascalCaseModuleName)}
+${getModuleExportType(v)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/modules/creators.ts
-function makeDocumentModelTypeImports(actions) {
+function makeDocumentModelTypeImports(args) {
 	const actionTypeImports = ["createAction"];
-	if (actions.some((a) => a.hasAttachment)) actionTypeImports.push("AttachmentInput");
+	if (args.module.operations.some((a) => operationHasAttachment(a))) actionTypeImports.push("AttachmentInput");
 	return actionTypeImports.join(",\n");
 }
 function makeActionInputSchemaName(action) {
-	if (!action.hasInput) return;
+	if (!action.name || !action.schema) return;
 	return `${pascalCase(action.name)}InputSchema`;
 }
 function makeActionInputTypeName(action) {
-	if (!action.hasInput) return;
+	if (!action.name || !action.schema) return;
 	return `${pascalCase(action.name)}Input`;
 }
 function makeActionTypeName(action) {
+	if (!action.name || !action.schema) return;
 	return `${pascalCase(action.name)}Action`;
 }
-function makeActionInputSchemaImports(actions) {
-	return actions.map(makeActionInputSchemaName).filter(Boolean).join(",\n");
-}
-function makeActionInputTypeImports(actions) {
-	return actions.map(makeActionInputTypeName).filter(Boolean).join(",\n");
-}
-function makeActionTypeImports(actions) {
-	return actions.map(makeActionTypeName).join(",\n");
-}
-function makeActionCreatorWithInput(actionWithInput) {
-	if (!actionWithInput.hasInput) return;
-	const camelCaseActionName = camelCase(actionWithInput.name);
-	const constantCaseActionName = constantCase(actionWithInput.name);
-	const actionTypeName = makeActionTypeName(actionWithInput);
-	const inputSchemaName = makeActionInputSchemaName(actionWithInput);
-	const inputTypeName = makeActionInputTypeName(actionWithInput);
-	const argsArray = [actionWithInput.isEmptyInput ? `input: ${inputTypeName} = {}` : `input: ${inputTypeName}`];
-	if (actionWithInput.hasAttachment) argsArray.push(`attachments: AttachmentInput[]`);
-	return ts`
+function makeActionInputSchemaImports(args) {
+	return args.module.operations.map(makeActionInputSchemaName).filter(Boolean).join(",\n");
+}
+function makeActionInputTypeImports(args) {
+	return args.module.operations.map(makeActionInputTypeName).filter(Boolean).join(",\n");
+}
+function makeActionTypeImports(args) {
+	return args.module.operations.map(makeActionTypeName).join(",\n");
+}
+function makeActionCreatorWithInput(operation) {
+	if (!operation.name || !operation.schema) return;
+	const camelCaseActionName = camelCase(operation.name);
+	const constantCaseActionName = constantCase(operation.name);
+	const actionTypeName = makeActionTypeName(operation);
+	const inputSchemaName = makeActionInputSchemaName(operation);
+	const inputTypeName = makeActionInputTypeName(operation);
+	const hasAttachment = operationHasAttachment(operation);
+	const argsArray = [operationHasEmptyInput(operation) ? `input: ${inputTypeName} = {}` : `input: ${inputTypeName}`];
+	if (hasAttachment) argsArray.push(`attachments: AttachmentInput[]`);
+	return ts$1`
   export const ${camelCaseActionName} = (${argsArray.join(", ")}) =>
     createAction<${actionTypeName}>(
       "${constantCaseActionName}",
       {...input},
-      ${actionWithInput.hasAttachment ? "attachments" : "undefined"},
+      ${hasAttachment ? "attachments" : "undefined"},
       ${inputSchemaName},
-      "${actionWithInput.scope}"
+      "${operation.scope}"
     );`.raw;
 }
-function makeActionCreatorWithoutInput(actionWithoutInput) {
-	if (actionWithoutInput.hasInput) return;
-	const camelCaseActionName = camelCase(actionWithoutInput.name);
-	const constantCaseActionName = constantCase(actionWithoutInput.name);
-	return ts`
+function makeActionCreatorWithoutInput(operation) {
+	if (!operation.name || !operation.schema) return;
+	const camelCaseActionName = camelCase(operation.name);
+	const constantCaseActionName = constantCase(operation.name);
+	return ts$1`
    export const ${camelCaseActionName} = () =>
-    createAction<${makeActionTypeName(actionWithoutInput)}>("${constantCaseActionName}");`.raw;
+    createAction<${makeActionTypeName(operation)}>("${constantCaseActionName}");`.raw;
 }
-function makeCreatorsForActionsWithInput(actions) {
-	return actions.filter((a) => a.hasInput).map(makeActionCreatorWithInput).join("\n\n");
+function makeCreatorsForActionsWithInput(args) {
+	return args.module.operations.filter((a) => isTruthy(a.schema)).map(makeActionCreatorWithInput).join("\n\n");
 }
-function makeActionCreatorsWithoutInput(actions) {
-	return actions.filter((a) => !a.hasInput).map(makeActionCreatorWithoutInput).join("\n\n");
+function makeActionCreatorsWithoutInput(args) {
+	return args.module.operations.filter((a) => !isTruthy(a.schema)).map(makeActionCreatorWithoutInput).join("\n\n");
 }
-const documentModelOperationsModuleCreatorsFileTemplate = (v) => ts`
-
-import { ${makeDocumentModelTypeImports(v.actions)} } from "document-model";
+const documentModelOperationsModuleCreatorsFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
+import { ${makeDocumentModelTypeImports(v)} } from "document-model";
 import {
-${makeActionInputSchemaImports(v.actions)}
+${makeActionInputSchemaImports(v)}
 } from '../schema/zod.js';
 import type {
-${makeActionInputTypeImports(v.actions)}
+${makeActionInputTypeImports(v)}
 } from '../types.js';
 import type {
-${makeActionTypeImports(v.actions)}
+${makeActionTypeImports(v)}
 } from './actions.js';
 
-${makeCreatorsForActionsWithInput(v.actions)}
+${makeCreatorsForActionsWithInput(v)}
 
-${makeActionCreatorsWithoutInput(v.actions)}
+${makeActionCreatorsWithoutInput(v)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/modules/error.ts
@@ -5189,12 +5364,12 @@ function getErrorNames(errors) {
 	return errors.map(getErrorName).filter((name) => name !== void 0);
 }
 function getErrorCodeType(errors) {
-	return ts`export type ErrorCode = ${getErrorNames(errors).map((name) => `"${name}"`).join(" |\n")};`.raw;
+	return ts$1`export type ErrorCode = ${getErrorNames(errors).map((name) => `"${name}"`).join(" |\n")};`.raw;
 }
 function errorClassTemplate(error) {
 	const errorName = getErrorName(error);
 	if (!errorName) return;
-	return ts`
+	return ts$1`
     export class ${errorName} extends Error implements ReducerError {
       errorCode = "${errorName}" as ErrorCode;
       constructor(message = "${errorName}") {
@@ -5206,13 +5381,14 @@ function errorClassTemplate(error) {
 function getErrorClassImplementations(errors) {
 	return errors.map((error) => errorClassTemplate(error)).filter(Boolean).join("\n\n");
 }
-function getErrorsImplementations(errors) {
+function getErrorsImplementations(args) {
+	const errors = flatMap(args.module.operations, (o) => prop(o, "errors"));
 	if (!errors.length) return "";
 	const deduplicatedErrors = errors.reduce((acc, error) => {
 		if (!acc.some((e) => getErrorName(e) === getErrorName(error))) acc.push(error);
 		return acc;
 	}, new Array());
-	return ts`
+	return ts$1`
     ${getErrorCodeType(deduplicatedErrors)}
 
     export interface ReducerError {
@@ -5222,74 +5398,82 @@ function getErrorsImplementations(errors) {
     ${getErrorClassImplementations(deduplicatedErrors)}
   `.raw;
 }
-function getActionErrorsExport(action) {
-	const errors = action.errors;
+function getActionErrorsExport(operation) {
+	if (!operation.name) return;
+	const errors = operation.errors;
 	if (errors.length === 0) return;
-	return ts`
-    ${pascalCase(action.name)}: { ${getErrorNames(errors).filter(Boolean).join(",\n")} }
+	return ts$1`
+    ${pascalCase(operation.name)}: { ${getErrorNames(errors).filter(Boolean).join(",\n")} }
   `.raw;
 }
-function getErrorsExport(actions) {
-	return ts`
-  export const errors = { ${actions.map(getActionErrorsExport).filter(Boolean).join(",\n")} };
+function getErrorsExport(args) {
+	return ts$1`
+  export const errors = { ${args.module.operations.map(getActionErrorsExport).filter(Boolean).join(",\n")} };
   `.raw;
 }
-const documentModelOperationsModuleErrorFileTemplate = (v) => ts`
-  ${getErrorsImplementations(v.errors)}
-  ${getErrorsExport(v.actions)}
+const documentModelOperationsModuleErrorFileTemplate = (v) => ts$1`
+  ${getErrorsImplementations(v)}
+  ${getErrorsExport(v)}
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/modules/operations.ts
 function getActionTypeNames(actions) {
 	return actions.map(getActionTypeName);
 }
-function getActionTypeImports(actions) {
-	return getActionTypeNames(actions).join(",\n");
+function getActionTypeImports(args) {
+	return getActionTypeNames(args.module.operations).join(",\n");
 }
 function getOperationsInterfaceName(pascalCaseDocumentType, module) {
 	return `${pascalCaseDocumentType}${pascalCase(module.name)}Operations`;
 }
 function getActionOperationFieldName(action) {
+	if (!action.name) return;
 	return `${camelCase(action.name)}Operation`;
 }
 function getActionOperationStateTypeName(action, pascalCaseDocumentType) {
-	if (!action.state) return `${pascalCaseDocumentType}State`;
-	return `${pascalCaseDocumentType}_${pascalCase(action.state)}_State`;
+	if (!action.scope) return `${pascalCaseDocumentType}State`;
+	return `${pascalCaseDocumentType}${pascalCase(action.scope)}State`;
 }
-function getActionOperationStateTypeImports(actions, pascalCaseDocumentType) {
-	const stateTypeNames = actions.map((action) => getActionOperationStateTypeName(action, pascalCaseDocumentType));
+function getActionOperationStateTypeImports(args) {
+	const stateTypeNames = args.module.operations.map((action) => getActionOperationStateTypeName(action, args.pascalCaseDocumentType));
 	return Array.from(new Set(stateTypeNames)).join(",\n");
 }
 function getActionOperationFunction(action, pascalCaseDocumentType) {
-	return ts`
+	return ts$1`
   (state: ${getActionOperationStateTypeName(action, pascalCaseDocumentType)}, action: ${getActionTypeName(action)}, dispatch?: SignalDispatch) => void
 `.raw;
 }
 function getOperationsInterfaceField(action, pascalCaseDocumentType) {
-	return ts`
+	return ts$1`
     ${getActionOperationFieldName(action)}: ${getActionOperationFunction(action, pascalCaseDocumentType)}
   `.raw;
 }
-function getOperationsInterfaceFields(actions, pascalCaseDocumentType) {
-	return actions.map((action) => getOperationsInterfaceField(action, pascalCaseDocumentType)).join(",");
+function getOperationsInterfaceFields(args) {
+	return args.module.operations.map((action) => getOperationsInterfaceField(action, args.pascalCaseDocumentType)).join(",");
 }
-const documentModelOperationsModuleOperationsFileTemplate = (v) => ts`
+const documentModelOperationsModuleOperationsFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import { type SignalDispatch } from 'document-model';
 import type {
-  ${getActionTypeImports(v.actions)}
+  ${getActionTypeImports(v)}
 } from './actions.js';
 import type {
-  ${getActionOperationStateTypeImports(v.actions, v.pascalCaseDocumentType)}
+  ${getActionOperationStateTypeImports(v)}
 } from "../types.js";
 
 export interface ${getOperationsInterfaceName(v.pascalCaseDocumentType, v.module)} {
-    ${getOperationsInterfaceFields(v.actions, v.pascalCaseDocumentType)}
+    ${getOperationsInterfaceFields(v)}
   }
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/ph-factories.ts
-const documentModelPhFactoriesFileTemplate = (v) => ts`
+const documentModelPhFactoriesFileTemplate = (v) => ts$1`
 /**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
  * Factory methods for creating ${v.phDocumentTypeName} instances
  */
 import type {
@@ -5408,10 +5592,10 @@ function makeModulesOperationsImports(modules, camelCaseDocumentType) {
 function makeOperationInputSchemaInvocation(operation) {
 	const operationInputSchema = makeOperationInputSchema(operation);
 	const constantCaseOperationName = makeConstantCaseOperationName(operation);
-	if (operation.schema === null) return ts`
+	if (operation.schema === null) return ts$1`
   if (Object.keys(action.input).length > 0) throw new Error("Expected empty input for action ${constantCaseOperationName}");
 `.raw;
-	return ts`${operationInputSchema}().parse(action.input);`.raw;
+	return ts$1`${operationInputSchema}().parse(action.input);`.raw;
 }
 function makeOperationsObjectName(module, camelCaseDocumentType) {
 	return `${camelCaseDocumentType}${pascalCase(module.name)}Operations`;
@@ -5420,12 +5604,12 @@ function makeOperationName(operation) {
 	return `${makeCamelCaseOperationName(operation)}Operation`;
 }
 function makeOperationInvocation(module, operation, camelCaseDocumentType) {
-	return ts`
+	return ts$1`
   ${makeOperationsObjectName(module, camelCaseDocumentType)}.${makeOperationName(operation)}((state as any)[action.scope], action as any, dispatch);
   `.raw;
 }
 function makeModuleOperationCaseStatement(module, camelCaseDocumentType) {
-	return module.operations.map((operation) => ts`
+	return module.operations.map((operation) => ts$1`
       case "${makeConstantCaseOperationName(operation)}": {
         ${makeOperationInputSchemaInvocation(operation)}
         ${makeOperationInvocation(module, operation, camelCaseDocumentType)}
@@ -5436,16 +5620,16 @@ function makeModuleOperationCaseStatement(module, camelCaseDocumentType) {
 function makeModuleOperationsCaseStatements(modules, camelCaseDocumentType) {
 	return modules.map((module) => makeModuleOperationCaseStatement(module, camelCaseDocumentType).join("\n")).join("\n");
 }
-const documentModelGenReducerFileTemplate = (v) => ts`
+const documentModelGenReducerFileTemplate = (v) => ts$1`
 /* eslint-disable @typescript-eslint/no-unsafe-member-access */
 /* eslint-disable @typescript-eslint/no-unsafe-argument */
 import type { Reducer, StateReducer } from "document-model";
 import { isDocumentAction, createReducer } from "document-model";
-import type { ${v.phStateName} } from "${v.versionedDocumentModelPackageImportPath}";
+import type { ${v.phStateName} } from "${v.versionImportPath}";
 
-${makeModulesOperationsImports(v.modules, v.camelCaseDocumentType)}
+${makeModulesOperationsImports(v.specification.modules, v.camelCaseDocumentType)}
 
-${makeOperationInputSchemaImports(v.modules)}
+${makeOperationInputSchemaImports(v.specification.modules)}
 
 const stateReducer: StateReducer<${v.phStateName}> =
     (state, action, dispatch) => {
@@ -5453,7 +5637,7 @@ const stateReducer: StateReducer<${v.phStateName}> =
             return state;
         }
         switch (action.type) {
-       ${makeModuleOperationsCaseStatements(v.modules, v.camelCaseDocumentType)}
+       ${makeModuleOperationsCaseStatements(v.specification.modules, v.camelCaseDocumentType)}
             default:
                 return state;
         }
@@ -5463,7 +5647,11 @@ export const reducer: Reducer<${v.phStateName}> = createReducer(stateReducer);
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/schema/index.ts
-const documentModelSchemaIndexTemplate = ts`
+const documentModelSchemaIndexTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 export * from "./types.js";
 export * from "./zod.js";
 `.raw;
@@ -5477,7 +5665,11 @@ function buildLocalStateTypeImport(hasLocalSchema, localStateName) {
 	if (!hasLocalSchema) return "";
 	return localStateName;
 }
-const documentModelGenTypesTemplate = (v) => ts`
+const documentModelGenTypesTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { PHDocument, PHBaseState } from 'document-model';
 import type { ${v.actionTypeName} } from './actions.js';
 import type {
@@ -5505,7 +5697,11 @@ export type {
 `.raw;
 //#endregion
 //#region src/templates/document-model/gen/utils.ts
-const documentModelGenUtilsTemplate = (v) => ts`
+const documentModelGenUtilsTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type {
     DocumentModelUtils,
 } from "document-model";
@@ -5530,7 +5726,7 @@ export const initialGlobalState: ${v.globalStateName} = ${v.initialGlobalState};
 export const initialLocalState: ${v.localStateName} = ${v.initialLocalState};
 
 export const utils: DocumentModelUtils<${v.phStateName}> = {
-    fileExtension: "${v.fileExtension}",
+    fileExtension: "${v.documentModelState.extension}",
     createState(state) {
         return { ...defaultBaseState(), global: { ...initialGlobalState, ...state?.global }, local: { ...initialLocalState, ...state?.local } };
     },
@@ -5569,8 +5765,11 @@ export const utils: DocumentModelUtils<${v.phStateName}> = {
 `.raw;
 //#endregion
 //#region src/templates/document-model/hooks.ts
-const documentModelHooksFileTemplate = (v) => ts`
-
+const documentModelHooksFileTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { DocumentDispatch } from "@powerhousedao/reactor-browser";
 import {
   useDocumentById,
@@ -5581,7 +5780,7 @@ import {
 import type {
   ${v.actionTypeName},
   ${v.phDocumentTypeName},
-} from "${v.versionedDocumentModelPackageImportPath}";
+} from "${v.versionImportPath}";
 import { 
   ${v.assertIsPhDocumentOfTypeFunctionName},
   ${v.isPhDocumentOfTypeFunctionName} 
@@ -5621,17 +5820,26 @@ export function ${v.useInSelectedFolderHookName}() {
 `.raw;
 //#endregion
 //#region src/templates/document-model/index.ts
-const documentModelIndexTemplate = ts`
+const documentModelIndexTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 export * from "./gen/index.js";
 export * from "./src/index.js";
 export * from "./hooks.js";
+export * from "./module.js";
 export { actions } from "./actions.js";
 export { utils } from "./utils.js";
 `.raw;
 //#endregion
 //#region src/templates/document-model/module.ts
 function documentModelModuleFileTemplate({ phStateName, pascalCaseDocumentType, version }) {
-	return ts`
+	return ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
   import type { DocumentModelModule } from "document-model";
   import { createState, defaultBaseState } from "document-model";
   import type { ${phStateName} } from "./gen/types.js";
@@ -5652,17 +5860,21 @@ function documentModelModuleFileTemplate({ phStateName, pascalCaseDocumentType,
 }
 //#endregion
 //#region src/templates/document-model/src/index.ts
-const documentModelSrcIndexFileTemplate = ts`
+const documentModelSrcIndexFileTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 export * from "./utils.js";
 `.raw;
 //#endregion
 //#region src/templates/document-model/src/utils.ts
-const documentModelSrcUtilsTemplate = ts`
+const documentModelSrcUtilsTemplate = ts$1`
 export {};
 `.raw;
 //#endregion
 //#region src/templates/document-model/tests/document-model.test.ts
-const documentModelTestFileTemplate = (v) => ts`
+const documentModelTestFileTemplate = (v) => ts$1`
 /**
  * This is a scaffold file meant for customization:
  * - change it by adding new tests or modifying the existing ones
@@ -5682,7 +5894,7 @@ import {
   ${v.assertIsPhDocumentOfTypeFunctionName},
   ${v.isPhStateOfTypeFunctionName},
   ${v.assertIsPhStateOfTypeFunctionName},
-} from "${v.versionedDocumentModelPackageImportPath}";
+} from "${v.versionImportPath}";
 import { ZodError } from "zod";
 
 describe("${v.pascalCaseDocumentType} Document Model", () => {
@@ -5786,19 +5998,20 @@ describe("${v.pascalCaseDocumentType} Document Model", () => {
 function makeModuleOperationsTypeName(module) {
 	return `${pascalCase(module.name)}Operations`;
 }
-function makeCamelCaseActionNamesForImport(actions) {
-	return actions.map((a) => camelCase(a.name));
+function makeCamelCaseOperationNamesForImport(operations) {
+	return pipe(operations, map(prop("name")), filter(isString), map((n) => camelCase(n)));
 }
-function makeActionInputSchemasForImport(actions) {
-	return actions.map((a) => `${pascalCase(a.name)}InputSchema`);
+function makeOperationInputSchemasForImport(operations) {
+	return pipe(operations, map(prop("name")), filter(isString), map((n) => `${pascalCase(n)}InputSchema`));
 }
-function makeTestCaseForAction(action, isPhDocumentOfTypeFunctionName) {
-	const camelCaseActionName = camelCase(action.name);
-	const pascalCaseActionName = pascalCase(action.name);
-	const constantCaseActionName = constantCase(action.name);
+function makeTestCaseForOperation(operation, isPhDocumentOfTypeFunctionName) {
+	if (operation.name === null) throw new Error(`Operation is missing name.`);
+	const camelCaseActionName = camelCase(operation.name);
+	const pascalCaseActionName = pascalCase(operation.name);
+	const constantCaseActionName = constantCase(operation.name);
 	const actionInputSchemaName = `${pascalCaseActionName}InputSchema`;
-	const scope = action.scope;
-	return ts`
+	const scope = operation.scope;
+	return ts$1`
   it('should handle ${camelCaseActionName} operation', () => {
         const document = utils.createDocument();
         const input = generateMock(
@@ -5820,28 +6033,28 @@ function makeTestCaseForAction(action, isPhDocumentOfTypeFunctionName) {
     });
   `.raw;
 }
-function makeActionImportNames(v) {
-	const actionNames = makeCamelCaseActionNamesForImport(v.actions);
-	const inputSchemaNames = makeActionInputSchemasForImport(v.actions);
+function makeOperationImportNames(v) {
+	const operationNames = makeCamelCaseOperationNamesForImport(v.module.operations);
+	const inputSchemaNames = makeOperationInputSchemasForImport(v.module.operations);
 	return [
 		"reducer",
 		"utils",
 		v.isPhDocumentOfTypeFunctionName,
-		...actionNames,
+		...operationNames,
 		...inputSchemaNames
 	];
 }
-function makeActionsImports(v) {
-	return ts`
+function makeOperationsImports(v) {
+	return ts$1`
   import {
-    ${makeActionImportNames(v).join("\n")}
-  } from "${v.versionedDocumentModelPackageImportPath}";
+    ${makeOperationImportNames(v).join("\n")}
+  } from "${v.versionImportPath}";
   `.raw;
 }
-function makeTestCasesForActions(actions, isPhDocumentOfTypeFunctionName) {
-	return actions.map((action) => makeTestCaseForAction(action, isPhDocumentOfTypeFunctionName)).join("\n\n");
+function makeTestCasesForOperations(operations, isPhDocumentOfTypeFunctionName) {
+	return operations.map((operation) => makeTestCaseForOperation(operation, isPhDocumentOfTypeFunctionName)).join("\n\n");
 }
-const documentModelOperationsModuleTestFileTemplate = (v) => ts`
+const documentModelOperationsModuleTestFileTemplate = (v) => ts$1`
 /**
  * This is a scaffold file meant for customization:
  * - change it by adding new tests or modifying the existing ones
@@ -5853,23 +6066,27 @@ import {
   reducer,
   utils,
   ${v.isPhDocumentOfTypeFunctionName},
-  ${makeCamelCaseActionNamesForImport(v.actions)},
-  ${makeActionInputSchemasForImport(v.actions)},
-} from "${v.versionedDocumentModelPackageImportPath}";
+  ${makeCamelCaseOperationNamesForImport(v.module.operations)},
+  ${makeOperationInputSchemasForImport(v.module.operations)},
+} from "${v.versionImportPath}";
 
 describe("${makeModuleOperationsTypeName(v.module)}", () => {
-  ${makeTestCasesForActions(v.actions, v.isPhDocumentOfTypeFunctionName)}
+  ${makeTestCasesForOperations(v.module.operations, v.isPhDocumentOfTypeFunctionName)}
 });
 
 `.raw;
 //#endregion
 //#region src/templates/document-model/upgrades/upgrade-manifest.ts
-const upgradeManifestTemplate = (v) => ts`
+const upgradeManifestTemplate = (v) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
   import type { UpgradeManifest } from "document-model";
   import { latestVersion, supportedVersions } from "./versions.js";
 
   export const ${v.upgradeManifestName}: UpgradeManifest<typeof supportedVersions> = {
-    documentType: "${v.documentModelId}",
+    documentType: "${v.documentModelState.id}",
     latestVersion,
     supportedVersions,
     upgrades: {},
@@ -5877,13 +6094,13 @@ const upgradeManifestTemplate = (v) => ts`
   `.raw;
 //#endregion
 //#region src/templates/document-model/upgrades/upgrade-transition.ts
-const upgradeTransitionTemplate = (v) => ts`
+const upgradeTransitionTemplate = (v) => ts$1`
 import type { Action, PHDocument, UpgradeTransition } from "document-model";
-import type { ${v.phStateName} as StateV${v.previousVersion} } from "${v.documentModelPackageImportPath}/v${v.previousVersion}";
-import type { ${v.phStateName} as StateV${v.version} } from "${v.documentModelPackageImportPath}/v${v.version}";
+import type { ${v.phStateName} as StateV${v.version - 1} } from "${v.documentModelImportPath}/v${v.version - 1}";
+import type { ${v.phStateName} as StateV${v.version} } from "${v.documentModelImportPath}/v${v.version}";
 
 function upgradeReducer(
-  document: PHDocument<StateV${v.previousVersion}>,
+  document: PHDocument<StateV${v.version - 1}>,
   action: Action,
 ): PHDocument<StateV${v.version}> {
   return {
@@ -5899,7 +6116,11 @@ export const v${v.version}: UpgradeTransition = {
 `.raw;
 //#endregion
 //#region src/templates/document-model/utils.ts
-const documentModelUtilsTemplate = ({ phStateName, pascalCaseDocumentType }) => ts`
+const documentModelUtilsTemplate = ({ phStateName, pascalCaseDocumentType }) => ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { DocumentModelUtils } from "document-model";
 import type { ${phStateName} } from "./gen/types.js";
 import { utils as genUtils } from "./gen/utils.js";
@@ -5916,7 +6137,7 @@ function getDocumentType(documentTypes) {
 }
 //#endregion
 //#region src/templates/processors/analytics/factory.ts
-const analyticsFactoryTemplate = (v) => ts`
+const analyticsFactoryTemplate = (v) => ts$1`
 import type { 
   ProcessorApp,
   ProcessorFactoryBuilder,
@@ -5942,13 +6163,17 @@ export const ${v.camelCaseName}FactoryBuilder: ProcessorFactoryBuilder = (module
 `.raw;
 //#endregion
 //#region src/templates/processors/analytics/index.ts
-const analyticsIndexTemplate = ts`
+const analyticsIndexTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 export * from "./factory.js";
 export * from "./processor.js";
 `.raw;
 //#endregion
 //#region src/templates/processors/analytics/processor.ts
-const analyticsProcessorTemplate = (v) => ts`
+const analyticsProcessorTemplate = (v) => ts$1`
 import type { AnalyticsSeriesInput, AnalyticsPath, IAnalyticsStore } from "@powerhousedao/analytics-engine-core";
 import type { OperationWithContext, IProcessor } from "@powerhousedao/reactor-browser";
 
@@ -5980,19 +6205,22 @@ export class ${v.pascalCaseName} implements IProcessor {
 `.raw;
 //#endregion
 //#region src/templates/processors/factory-builders.ts
-const factoryBuildersTemplate = ts`
+const factoryBuildersTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 import type { ProcessorFactoryBuilder } from "@powerhousedao/reactor";
 
 export const processorFactoryBuilders: ProcessorFactoryBuilder[] = [];
 `.raw;
 //#endregion
 //#region src/templates/processors/factory.ts
-const processorsFactoryTemplate = ts`
+const processorsFactoryTemplate = ts$1`
 /**
- * This file aggregates all processor factories
- * Auto-generated by codegen - DO NOT EDIT MANUALLY
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
  */
-
 import type {
   IProcessorHostModule,
   ProcessorRecord,
@@ -6027,17 +6255,16 @@ export const processorFactory = async (module: IProcessorHostModule) => {
 `.raw;
 //#endregion
 //#region src/templates/processors/index.ts
-const processorsIndexTemplate = ts`
+const processorsIndexTemplate = ts$1`
 /**
- * Processor exports
+ * WARNING: DO NOT EDIT
  * This file is auto-generated and updated by codegen
  */
-
 export { processorFactory } from "./factory.js";
 `.raw;
 //#endregion
 //#region src/templates/processors/relational-db/factory.ts
-const relationalDbFactoryTemplate = (v) => ts`
+const relationalDbFactoryTemplate = (v) => ts$1`
 import type { 
   IProcessorHostModule,
   ProcessorApp,
@@ -6077,13 +6304,17 @@ export const ${v.camelCaseName}FactoryBuilder: ProcessorFactoryBuilder = (module
 `.raw;
 //#endregion
 //#region src/templates/processors/relational-db/index.ts
-const relationalDbIndexTemplate = ts`
+const relationalDbIndexTemplate = ts$1`
+/**
+ * WARNING: DO NOT EDIT
+ * This file is auto-generated and updated by codegen
+ */
 export * from "./factory.js";
 export * from "./processor.js";
 `.raw;
 //#endregion
 //#region src/templates/processors/relational-db/migrations.ts
-const relationalDbMigrationsTemplate = () => ts`
+const relationalDbMigrationsTemplate = () => ts$1`
 import type { IRelationalDb } from "@powerhousedao/reactor-browser"
 
 export async function up(db: IRelationalDb<any>): Promise<void> {
@@ -6107,7 +6338,7 @@ export async function down(db: IRelationalDb<any>): Promise<void> {
 //#endregion
 //#region src/templates/processors/relational-db/processor.ts
 const defaultNamespaceComment = "// Default namespace: `${this.name}_${driveId.replaceAll(\"-\", \"_\")}`";
-const relationalDbProcessorTemplate = (v) => ts`
+const relationalDbProcessorTemplate = (v) => ts$1`
 import { RelationalDbProcessor } from "@powerhousedao/reactor-browser";
 import type { OperationWithContext } from "document-model";
 import { up } from "./migrations.js";
@@ -6134,7 +6365,7 @@ export class ${v.pascalCaseName} extends RelationalDbProcessor<DB> {
 `.raw;
 //#endregion
 //#region src/templates/processors/relational-db/schema.ts
-const relationalDbSchemaTemplate = () => ts`
+const relationalDbSchemaTemplate = () => ts$1`
 export interface Todo {
   status: boolean | null;
   task: string;
@@ -6146,7 +6377,7 @@ export interface DB {
 `.raw;
 //#endregion
 //#region src/templates/subgraphs/index-file.ts
-const subgraphIndexFileTemplate = (v) => ts`
+const subgraphIndexFileTemplate = (v) => ts$1`
 import { BaseSubgraph } from "@powerhousedao/reactor-api";
 import type { DocumentNode } from "graphql";
 import { schema } from "./schema.js";
@@ -6163,7 +6394,7 @@ export class ${v.pascalCaseName}Subgraph extends BaseSubgraph {
 `.raw;
 //#endregion
 //#region src/templates/subgraphs/lib-file.ts
-const subgraphLibFileTemplate = () => ts`
+const subgraphLibFileTemplate = () => ts$1`
 /**
  * This is a scaffold file meant for customization.
  * Delete the file and run the code generator again to have it reset
@@ -6171,7 +6402,7 @@ const subgraphLibFileTemplate = () => ts`
 `.raw;
 //#endregion
 //#region src/templates/subgraphs/custom-schema.ts
-const customSubgraphSchemaTemplate = (v) => ts`
+const customSubgraphSchemaTemplate = (v) => ts$1`
 import { gql } from "graphql-tag";
 import type { DocumentNode } from "graphql";
 
@@ -6191,7 +6422,7 @@ type Query {
 `.raw;
 //#endregion
 //#region src/templates/subgraphs/custom-resolvers.ts
-const customSubgraphResolversTemplate = (v) => ts`
+const customSubgraphResolversTemplate = (v) => ts$1`
 import { type ISubgraph } from "@powerhousedao/reactor-api";
 
 export const getResolvers = (subgraph: ISubgraph): Record<string, unknown> => {
@@ -6210,178 +6441,1886 @@ export const getResolvers = (subgraph: ISubgraph): Record<string, unknown> => {
 };
 `.raw;
 //#endregion
-//#region src/templates/subgraphs/document-model-schema.ts
-const documentModelSubgraphSchemaTemplate = (v) => {
-	const mutationFields = v.modules.flatMap((module) => module.operations.map((op) => `    ${v.pascalCaseDocumentType}_${camel$1(op.name)}(driveId:String, docId:PHID, input:${v.pascalCaseDocumentType}_${pascal$1(op.name)}Input): Int`)).join("\n");
-	const moduleSchemas = v.modules.map((module) => {
-		return `${`\n"""\nModule: ${pascal$1(module.name)}\n"""`}\n${module.operations.map((op) => op.schema).join("\n")}`;
-	}).join("\n");
-	return `import { gql } from "graphql-tag";
-import type { DocumentNode } from "graphql";
-
-export const schema: DocumentNode = gql\`
-"""
-Queries: ${v.pascalCaseDocumentType} Document
-"""
-
-type ${v.pascalCaseDocumentType}Queries {
-    getDocument(docId: PHID!, driveId: PHID): ${v.pascalCaseDocumentType}
-    getDocuments(driveId: String): [${v.pascalCaseDocumentType}!]
+//#region src/utils/cli.ts
+const configSpec = {
+	"--document-models": String,
+	"--editors": String,
+	"--interactive": Boolean,
+	"--skip-format": Boolean,
+	"--watch": Boolean,
+	"-i": "--interactive",
+	"-sf": "--skip-format",
+	"-w": "--watch"
+};
+function parseArgs(argv, spec) {
+	return arg(spec, {
+		permissive: true,
+		argv
+	});
 }
-
-type Query {
-    ${v.pascalCaseDocumentType}: ${v.pascalCaseDocumentType}Queries
+function parseConfig(argv) {
+	const config = {};
+	const args = parseArgs(argv, configSpec);
+	if ("--document-models" in args) config.documentModelsDir = args["--document-models"];
+	if ("--editors" in args) config.editorsDir = args["--editors"];
+	if ("--skip-format" in args) config.skipFormat = true;
+	if ("--interactive" in args) config.interactive = true;
+	if ("--watch" in args) config.watch = true;
+	return config;
 }
-
-"""
-Mutations: ${v.pascalCaseDocumentType}
-"""
-type Mutation {
-
-    ${v.pascalCaseDocumentType}_createDocument(name:String!, driveId:String): String
-
-${mutationFields}
+//#endregion
+//#region src/utils/constants.ts
+/** Document model metadata for the `powerhouse/document-model` document type.
+*
+* Assumed to always be present during codegen.
+*/
+const documentModelDocumentTypeMetadata = {
+	documentModelId: "powerhouse/document-model",
+	documentModelDocumentTypeName: "DocumentModelDocument",
+	documentModelDirName: "document-model",
+	documentModelImportPath: "document-model"
+};
+//#endregion
+//#region src/utils/document-type-metadata.ts
+/** Gets the document model metadata for the --document-type argument
+* passed to the `generate --editor` and `generate --app` commands.
+*/
+function getDocumentTypeMetadata({ project, documentModelId }) {
+	const { directory: documentModelsDir } = getOrCreateDirectory(project, "document-models");
+	const documentModelVariableNames = pipe(readdirSync(documentModelsDir.getPath(), { withFileTypes: true }), filter((dirent) => dirent.isDirectory()), map((dir) => join(dir.parentPath, `${dir.name}/${dir.name}.json`)), filter((srcPath) => statSync(srcPath, { throwIfNoEntry: false })?.isFile() ?? false), map((srcPath) => loadJsonFileSync(srcPath)), filter((stateFile) => DocumentModelGlobalStateSchema().safeParse(stateFile).success === true), find((state) => state.id === documentModelId), prop("name"), when(isString, (name) => getDocumentModelVariableNames(name)));
+	if (!documentModelVariableNames) throw new Error(`Failed to get document type metadata for document type: ${documentModelId}.`);
+	const { kebabCaseDocumentType, phDocumentTypeName } = documentModelVariableNames;
+	return {
+		documentModelId,
+		documentModelDocumentTypeName: phDocumentTypeName,
+		documentModelDirName: kebabCaseDocumentType,
+		documentModelImportPath: join("document-models", kebabCaseDocumentType)
+	};
 }
-
-${moduleSchemas}
-\`
-`;
+//#endregion
+//#region src/utils/format-with-prettier.ts
+/** Formats the text of a ts-morph source file with prettier before writing the text to memory */
+async function formatSourceFileWithPrettier(sourceFile) {
+	sourceFile.organizeImports();
+	const formattedText = await formatSafe(sourceFile.getFullText());
+	sourceFile.replaceWithText(formattedText);
+}
+async function formatSafe(sourceText, parser = "typescript") {
+	try {
+		return await format(sourceText, { parser });
+	} catch (error) {
+		console.error(error);
+		return sourceText;
+	}
+}
+async function runPrettier() {
+	await spawnAsync("npx", [
+		"prettier",
+		"--write",
+		"."
+	]);
+}
+//#endregion
+//#region src/utils/source-files.ts
+/** Gets a SourceFile by name in a ts-morph Project, or creates a new one
+* if none with that path exists.
+*/
+function getOrCreateSourceFile(project, filePath) {
+	const dirName = path.dirname(filePath);
+	if (!project.getDirectory(dirName)) project.createDirectory(dirName);
+	const sourceFile = project.getSourceFile(filePath);
+	if (!sourceFile) return {
+		alreadyExists: false,
+		sourceFile: project.createSourceFile(filePath, "", { overwrite: true })
+	};
+	return {
+		alreadyExists: true,
+		sourceFile
+	};
+}
+/** Gets a Directory by name in a ts-morph Project, or creates a new one
+* if none with that path exists.
+*/
+function getOrCreateDirectory(project, dirPath) {
+	const directory = project.getDirectory(dirPath);
+	if (!directory) return {
+		alreadyExists: false,
+		directory: project.createDirectory(dirPath)
+	};
+	return {
+		alreadyExists: true,
+		directory
+	};
+}
+/** Ensures that the directories at the given paths exist within the
+* ts-morph Project
+*/
+async function ensureDirectoriesExist(project, ...pathsToEnsure) {
+	for (const dirPath of pathsToEnsure) if (!project.getDirectory(dirPath)) await project.createDirectory(dirPath).save();
+}
+function getPreviousVersionSourceFile(args) {
+	const { project, version, filePath } = args;
+	const previousVersion = version - 1;
+	if (previousVersion < 1) return;
+	const previousVersionFilePath = filePath.replace(`/v${version}/`, `/v${previousVersion}/`);
+	return project.getSourceFile(previousVersionFilePath);
+}
+//#endregion
+//#region src/utils/syntax-builders.ts
+/** Builds a ts-morph ObjectLiteralExpression from a ts/js object
+* Useful for substituting the value of a runtime object in templates
+*/
+function buildObjectLiteral(inputObject, sourceFile) {
+	const propertyAssignments = [];
+	for (const [key, value] of Object.entries(inputObject)) {
+		const propertyAssignment = buildPropertyAssignment(key, value);
+		propertyAssignments.push(propertyAssignment);
+	}
+	const objectLiteral = ts.factory.createObjectLiteralExpression(propertyAssignments, true);
+	return buildNodePrinter(sourceFile)(objectLiteral);
+}
+function buildFalse() {
+	return ts.factory.createFalse();
+}
+function buildTrue() {
+	return ts.factory.createTrue();
+}
+function buildBoolean(value) {
+	return value ? buildTrue() : buildFalse();
+}
+function buildNull() {
+	return ts.factory.createNull();
+}
+function buildUndefined() {
+	return ts.factory.createIdentifier("undefined");
+}
+function buildNumericLiteral(value) {
+	return ts.factory.createNumericLiteral(value);
+}
+function buildStringLiteral(value) {
+	return ts.factory.createStringLiteral(value);
+}
+function buildArrayLiteral(elements) {
+	return ts.factory.createArrayLiteralExpression(elements, true);
+}
+function valueToExpression(value) {
+	if (value === null) return buildNull();
+	if (value === void 0) return buildUndefined();
+	if (typeof value === "boolean") return buildBoolean(value);
+	if (typeof value === "string") return buildStringLiteral(value);
+	if (typeof value === "number") return buildNumericLiteral(value);
+	if (Array.isArray(value)) return buildArrayLiteral(value.map((item) => valueToExpression(item)));
+	if (typeof value === "object") return ts.factory.createObjectLiteralExpression(Object.entries(value).map(([key, v]) => {
+		const name = ts.factory.createIdentifier(key);
+		return ts.factory.createPropertyAssignment(name, valueToExpression(v));
+	}), true);
+	throw new Error("Invalid value passed: ", value);
+}
+function buildPropertyAssignment(name, value) {
+	const nameIdentifier = ts.factory.createIdentifier(name);
+	const valueExpression = valueToExpression(value);
+	return ts.factory.createPropertyAssignment(nameIdentifier, valueExpression);
+}
+function buildNodePrinter(sourceFile) {
+	const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+	return (node) => printer.printNode(ts.EmitHint.Unspecified, node, sourceFile.compilerNode);
+}
+//#endregion
+//#region src/utils/syntax-getters.ts
+/** Returns a ts-morph ObjectLiteralExpression from a variable statement
+* if the type matches
+*/
+function getObjectLiteral(statement) {
+	return statement?.getDeclarations().at(0)?.getInitializerIfKind(SyntaxKind.ObjectLiteralExpression);
+}
+/** Returns the value of a property in a ts-morph ObjectLiteralExpression of type T if it exists */
+function getObjectProperty(object, propertyName, propertyType) {
+	return object?.getProperty(propertyName)?.asKind(SyntaxKind.PropertyAssignment)?.getChildren().find((child) => child.getKind() === propertyType)?.asKindOrThrow(propertyType);
+}
+function getVariableDeclarationByTypeName(sourceFile, typeName) {
+	return sourceFile.getVariableDeclaration((declaration) => {
+		if ((declaration.getTypeNode()?.getText() ?? "").includes(typeName)) return true;
+		return declaration.getType().getText().includes(typeName);
+	});
+}
+//#endregion
+//#region src/utils/ts-morph-project.ts
+const DEFAULT_PROJECT_OPTIONS = {
+	skipAddingFilesFromTsConfig: true,
+	skipLoadingLibFiles: true,
+	manipulationSettings: {
+		useTrailingCommas: true,
+		indentationText: IndentationText.TwoSpaces,
+		indentMultiLineObjectLiteralBeginningOnBlankLine: true
+	}
 };
-function pascal$1(name) {
-	return name.split(/[-_\s]+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("");
-}
-function camel$1(name) {
-	const p = pascal$1(name);
-	return p.charAt(0).toLowerCase() + p.slice(1);
-}
-//#endregion
-//#region src/templates/subgraphs/document-model-resolvers.ts
-const documentModelSubgraphResolversTemplate = (v) => {
-	const inputTypeImports = v.modules.flatMap((m) => m.operations.map((o) => `${pascal(o.name)}Input`)).join(",\n  ");
-	const operationMutations = v.modules.flatMap((module) => module.operations.map((op) => `        ${v.pascalCaseDocumentType}_${camel(op.name)}: async (_: unknown, args: { docId: string, input: ${pascal(op.name)}Input}) => {
-            const { docId, input } = args;
-            const doc = await reactorClient.get<${v.pascalCaseDocumentType}Document>(docId);
-            if(!doc) {
-              throw new Error("Document not found");
-            }
-
-            await reactorClient.execute(
-                docId,
-                "main",
-                [actions.${camel(op.name)}(input)]
-            );
-
-            return true;
-        },
-`)).join("\n");
-	return `import type { BaseSubgraph } from "@powerhousedao/reactor-api";
-import { addFile } from "@powerhousedao/shared/document-drive";
-import { setName } from "document-model";
-import {
-  actions,
-  ${v.documentTypeVariableName},
-} from "${v.documentModelDir}";
-import type {
-  ${v.phDocumentTypeName},
-  ${inputTypeImports}
-} from "${v.documentModelDir}";
-
-export const getResolvers = (subgraph: BaseSubgraph): Record<string, unknown> => {
-  const reactorClient = subgraph.reactorClient;
-
-  return ({
-    Query: {
-      ${v.pascalCaseDocumentType}: async () => {
-        return {
-          getDocument: async (args: { docId: string, driveId: string }) => {
-            const { docId, driveId } = args;
-
-            if(!docId) {
-              throw new Error("Document id is required");
-            }
-
-            if(driveId) {
-              const children = await reactorClient.getChildren(driveId);
-              const childIds = children.results.map(d => d.header.id);
-              if(!childIds.includes(docId)) {
-                throw new Error(\`Document with id \${docId} is not part of \${driveId}\`);
-              }
-            }
-
-            const doc = await reactorClient.get<${v.phDocumentTypeName}>(docId);
-            return {
-              driveId: driveId,
-              ...doc,
-              ...doc.header,
-              created: doc.header.createdAtUtcIso,
-              lastModified: doc.header.lastModifiedAtUtcIso,
-              state: doc.state.global,
-              stateJSON: doc.state.global,
-              revision: doc.header?.revision?.global ?? 0,
-            };
-          },
-          getDocuments: async (args: { driveId?: string }) => {
-            const { driveId } = args;
-            const result = await reactorClient.find({ type: ${v.documentTypeVariableName}, ...(driveId ? { parentId: driveId } : {}) });
-            return result.results.map((_doc) => {
-              const doc = _doc as ${v.phDocumentTypeName};
-              return {
-                driveId: driveId,
-                ...doc,
-                ...doc.header,
-                created: doc.header.createdAtUtcIso,
-                lastModified: doc.header.lastModifiedAtUtcIso,
-                state: doc.state.global,
-                stateJSON: doc.state.global,
-                revision: doc.header?.revision?.global ?? 0,
-              };
-            });
-          },
-        };
-      },
-    },
-    Mutation: {
-      ${v.pascalCaseDocumentType}_createDocument: async (_: unknown, args: { name: string, driveId?: string }) => {
-        const { driveId, name } = args;
-        const document = await reactorClient.createEmpty(${v.documentTypeVariableName});
-
-        if(driveId) {
-          await reactorClient.execute(
-            driveId,
-            "main",
-            [addFile({
-              name,
-              id: document.header.id,
-              documentType: ${v.documentTypeVariableName},
-            })],
-          );
-        }
-
-        if(name) {
-          await reactorClient.execute(
-            document.header.id,
-            "main",
-            [setName(name)],
-          );
-        }
-
-        return document.header.id;
-      },
-
-${operationMutations}
-    },
-  });
+/** Returns the minimal typescript config for use in ts-morph file generation */
+function getDefaultProjectOptions(tsConfigFilePath) {
+	return {
+		...DEFAULT_PROJECT_OPTIONS,
+		tsConfigFilePath
+	};
+}
+/** Instantiates a ts-morph Project using the default typescript config and nearest tsconfig.json file */
+function buildTsMorphProject(projectDir) {
+	process.chdir(projectDir);
+	return new Project({
+		tsConfigFilePath: path.join(projectDir, "tsconfig.json"),
+		skipFileDependencyResolution: true
+	});
+}
+//#endregion
+//#region src/utils/unsafe-utils.ts
+function getInitialStates(scopeState) {
+	const { global, local } = scopeState;
+	const scopes = {
+		global,
+		local
+	};
+	Object.entries(scopes).forEach(([scope, state]) => {
+		if (!isEmptyStateSchema(state.schema) && state.initialValue === "") throw new Error(`${scope.charAt(0).toLocaleUpperCase() + scope.slice(1)} scope has a defined schema but is missing an initial value.`);
+	});
+	return {
+		initialGlobalState: handleEmptyState(global.initialValue),
+		initialLocalState: handleEmptyState(local.initialValue)
+	};
+}
+function isEmptyStateSchema(schema) {
+	return schema === "" || !schema.includes("{");
+}
+function handleEmptyState(state) {
+	return state === "" ? "{}" : state;
+}
+//#endregion
+//#region src/utils/validation.ts
+/**
+* Validates that a DocumentModelGlobalState has all required properties for successful code generation.
+*
+* @param documentModelState - The DocumentModelGlobalState to validate
+* @returns Validation result with isValid flag and error messages
+*/
+function validateDocumentModelState(documentModelState) {
+	const errors = [];
+	if (!documentModelState.id || typeof documentModelState.id !== "string" || documentModelState.id.trim() === "") errors.push("Property \"id\" is required and must be a non-empty string");
+	if (!documentModelState.name || typeof documentModelState.name !== "string" || documentModelState.name.trim() === "") errors.push("Property \"name\" is required and must be a non-empty string");
+	if (typeof documentModelState.extension !== "string") errors.push("Property \"extension\" must be a string");
+	if (!Array.isArray(documentModelState.specifications) || documentModelState.specifications.length === 0) {
+		errors.push("Property \"specifications\" is required and must be a non-empty array");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	const latestSpec = documentModelState.specifications[documentModelState.specifications.length - 1];
+	if (!latestSpec) {
+		errors.push("Latest specification is missing or invalid");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	if (!latestSpec.state) {
+		errors.push("Latest specification must have a \"state\" property");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	if (!latestSpec.state.global) errors.push("Latest specification state must have a \"global\" property");
+	else {
+		const globalState = latestSpec.state.global;
+		if (typeof globalState.schema !== "string") errors.push("Global state \"schema\" must be a string");
+		if (typeof globalState.initialValue !== "string") errors.push("Global state \"initialValue\" must be a string");
+		if (globalState.schema && globalState.schema.trim() !== "" && globalState.schema.includes("{") && (!globalState.initialValue || globalState.initialValue.trim() === "")) errors.push("Global state has a defined schema but is missing an initial value");
+	}
+	if (!latestSpec.state.local) errors.push("Latest specification state must have a \"local\" property");
+	else {
+		const localState = latestSpec.state.local;
+		if (typeof localState.schema !== "string") errors.push("Local state \"schema\" must be a string");
+		if (typeof localState.initialValue !== "string") errors.push("Local state \"initialValue\" must be a string");
+		if (localState.schema && localState.schema.trim() !== "" && localState.schema.includes("{") && (!localState.initialValue || localState.initialValue.trim() === "")) errors.push("Local state has a defined schema but is missing an initial value");
+	}
+	if (!Array.isArray(latestSpec.modules)) errors.push("Latest specification must have a \"modules\" array");
+	else {
+		if (latestSpec.modules.length === 0) errors.push("Latest specification must have at least one module defined");
+		latestSpec.modules.forEach((module, moduleIndex) => {
+			if (!module.name || typeof module.name !== "string" || module.name.trim() === "") errors.push(`Module at index ${moduleIndex} must have a non-empty "name" property`);
+			if (!Array.isArray(module.operations)) errors.push(`Module "${module.name || `at index ${moduleIndex}`}" must have an "operations" array`);
+			else {
+				if (module.operations.length === 0) errors.push(`Module "${module.name || `at index ${moduleIndex}`}" must have at least one operation defined`);
+				module.operations.forEach((operation, operationIndex) => {
+					const operationId = operation.name || `at index ${operationIndex}`;
+					const moduleId = module.name || `at index ${moduleIndex}`;
+					if (!operation.name || typeof operation.name !== "string" || operation.name.trim() === "") errors.push(`Operation ${operationId} in module "${moduleId}" must have a non-empty "name" property`);
+					if (operation.schema !== null && typeof operation.schema !== "string") errors.push(`Operation "${operationId}" in module "${moduleId}" must have a "schema" that is either null or a string`);
+					if (operation.scope !== void 0 && typeof operation.scope !== "string") errors.push(`Operation "${operationId}" in module "${moduleId}" must have a "scope" that is a string if provided`);
+					if (!Array.isArray(operation.errors)) errors.push(`Operation "${operationId}" in module "${moduleId}" must have an "errors" array`);
+				});
+			}
+		});
+	}
+	return {
+		isValid: errors.length === 0,
+		errors
+	};
+}
+//#endregion
+//#region src/file-builders/editor-common.ts
+/** Generates the `module.ts` file for a document editor or app */
+function makeEditorModuleFile({ project, editorDirPath, editorName, documentModelId, editorId, legacyMultipleDocumentTypes }) {
+	if (documentModelId && !!legacyMultipleDocumentTypes) throw new Error("Cannot specify both documentModelId and legacyMultipleDocumentTypes");
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(editorDirPath, "module.ts"));
+	sourceFile.replaceWithText("");
+	const template = documentEditorModuleFileTemplate({
+		editorName,
+		editorId,
+		pascalCaseEditorName: pascalCase(editorName),
+		documentTypes: documentModelId ? `["${documentModelId}"]` : JSON.stringify(legacyMultipleDocumentTypes)
+	});
+	sourceFile.replaceWithText(template);
+}
+async function makeEditorsFile(args) {
+	const { project, editorsDirPath } = args;
+	const sourceFile = project.createSourceFile(path.join(editorsDirPath, "editors.ts"), editorsTemplate, { overwrite: true });
+	const editorsArray = sourceFile.getVariableDeclarationOrThrow("editors").getFirstDescendantByKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+	pipe(project.getDirectoryOrThrow(editorsDirPath).getDescendantSourceFiles(), filter((sourceFile) => sourceFile.getBaseName() === "module.ts"), uniqueBy((sourceFile) => sourceFile.getFilePath()), map((sourceFile) => getVariableDeclarationByTypeName(sourceFile, "EditorModule")), filter(isTruthy), map((variableDeclaration) => ({
+		name: variableDeclaration.getName(),
+		editorDir: variableDeclaration.getSourceFile().getDirectory().getBaseName()
+	})), map(({ name, editorDir }) => ({
+		name,
+		namedImports: [name],
+		moduleSpecifier: `./${path.join(editorDir, "module.js")}`
+	})), forEach(({ name, namedImports, moduleSpecifier }) => {
+		sourceFile.addImportDeclaration({
+			namedImports,
+			moduleSpecifier
+		});
+		editorsArray.addElement(name);
+	}));
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeEditorsIndexFile(args) {
+	const { project, editorsDirPath } = args;
+	const sourceFile = project.createSourceFile(path.join(editorsDirPath, "index.ts"), "", { overwrite: true });
+	pipe(project.getDirectoryOrThrow(editorsDirPath).getDescendantSourceFiles(), filter((sourceFile) => sourceFile.getBaseName() === "module.ts"), uniqueBy((sourceFile) => sourceFile.getFilePath()), map((sourceFile) => getVariableDeclarationByTypeName(sourceFile, "EditorModule")), filter(isTruthy), map((variableDeclaration) => ({
+		name: variableDeclaration.getName(),
+		editorDir: variableDeclaration.getSourceFile().getDirectory().getBaseName()
+	})), map(({ name, editorDir }) => ({
+		namedExports: [name],
+		moduleSpecifier: `./${path.join(editorDir, "module.js")}`
+	})), forEach(({ namedExports, moduleSpecifier }) => {
+		sourceFile.addExportDeclaration({
+			namedExports,
+			moduleSpecifier
+		});
+	}));
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/app.ts
+/** Generates a app with the configs for `allowedDocumentModelIds` and `isDragAndDropEnabled` */
+async function tsMorphGenerateApp({ project, editorDir, editorName, editorId, allowedDocumentModelIds, isDragAndDropEnabled }) {
+	const { directory: editorsDir } = getOrCreateDirectory(project, "editors");
+	const editorsDirPath = editorsDir.getPath();
+	const { directory: documentModelsDir } = getOrCreateDirectory(project, "document-models");
+	const documentModelsDirPath = documentModelsDir.getPath();
+	const editorDirPath = path.join(editorsDirPath, editorDir);
+	const projectDir = editorsDir.getParentOrThrow().getPath();
+	const editorComponentsDirPath = path.join(editorDirPath, "components");
+	await ensureDirectoriesExist(project, documentModelsDirPath, editorsDirPath, editorDirPath, editorComponentsDirPath);
+	await makeNavigationBreadcrumbsFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeCreateDocumentFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeEmptyStateFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeFoldersFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeFolderTreeFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeFilesFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeDriveExplorerFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeDriveContentsFile({
+		project,
+		editorComponentsDirPath
+	});
+	await makeAppComponent({
+		project,
+		editorDirPath
+	});
+	await makeAppConfigFile({
+		project,
+		allowedDocumentModelIds,
+		isDragAndDropEnabled,
+		editorDirPath
+	});
+	makeEditorModuleFile({
+		project,
+		editorName,
+		editorId,
+		editorDirPath,
+		documentModelId: "powerhouse/document-drive"
+	});
+	await makeEditorsFile({
+		project,
+		editorsDirPath
+	});
+	await makeEditorsIndexFile({
+		project,
+		editorsDirPath
+	});
+	await createOrUpdateManifest({ apps: [{
+		name: editorName,
+		id: editorId,
+		documentTypes: ["powerhousedao/document-drive"]
+	}] }, projectDir);
+}
+async function makeAppComponent({ project, editorDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorDirPath, "editor.tsx"));
+	if (alreadyExists) {
+		const editorFunction = sourceFile.getFunction("Editor");
+		if (editorFunction) {
+			if (!editorFunction.isDefaultExport()) editorFunction.setIsDefaultExport(true);
+			return;
+		}
+	}
+	const template = appEditorFileTemplate();
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeAppConfigFile({ project, editorDirPath, allowedDocumentModelIds, isDragAndDropEnabled }) {
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(editorDirPath, "config.ts"));
+	const allowedDocumentTypesString = JSON.stringify(allowedDocumentModelIds);
+	const template = appConfigFileTemplate({
+		isDragAndDropEnabledString: isDragAndDropEnabled ? "true" : "false",
+		allowedDocumentTypesString
+	});
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDriveContentsFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "DriveContents.tsx"));
+	if (alreadyExists) return;
+	const template = appDriveContentsFileTemplate();
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeNavigationBreadcrumbsFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "NavigationBreadcrumbs.tsx"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(driveExplorerNavigationBreadcrumbsFileTemplate());
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeFoldersFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "Folders.tsx"));
+	if (alreadyExists) return;
+	const template = appFoldersFileTemplate();
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeFilesFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "Files.tsx"));
+	if (alreadyExists) return;
+	const template = appFilesFileTemplate();
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDriveExplorerFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "DriveExplorer.tsx"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(driveExplorerFileTemplate);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeFolderTreeFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "FolderTree.tsx"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(folderTreeFileTemplate);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeEmptyStateFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "EmptyState.tsx"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(emptyStateFileTemplate);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeCreateDocumentFile({ project, editorComponentsDirPath }) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorComponentsDirPath, "CreateDocument.tsx"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(createDocumentFileTemplate);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/boilerplate/generated-project-files.ts
+async function writeGeneratedProjectRootFiles(projectDir) {
+	await writeFileEnsuringDir(join(projectDir, "tsconfig.json"), await formatSafe(tsConfigTemplate, "json"));
+	await writeFileEnsuringDir(join(projectDir, "index.html"), await formatSafe(indexHtmlTemplate, "html"));
+	await writeFileEnsuringDir(join(projectDir, "main.tsx"), await formatSafe(mainTsxTemplate));
+	await writeFileEnsuringDir(join(projectDir, "eslint.config.js"), await formatSafe(eslintConfigTemplate));
+	await writeFileEnsuringDir(join(projectDir, "index.ts"), await formatSafe(indexTsTemplate));
+	await writeFileEnsuringDir(join(projectDir, "style.css"), await formatSafe(styleTemplate, "css"));
+	await writeFileEnsuringDir(join(projectDir, "vitest.config.ts"), await formatSafe(vitestConfigTemplate));
+}
+async function writeGeneratedDocumentModelsFiles(projectDir) {
+	await writeFileEnsuringDir(join(projectDir, "document-models/document-models.ts"), await formatSafe(documentModelsTemplate));
+	await writeFileEnsuringDir(join(projectDir, "document-models/index.ts"), await formatSafe(documentModelsIndexTemplate));
+	await writeFileEnsuringDir(join(projectDir, "document-models/upgrade-manifests.ts"), await formatSafe(upgradeManifestsTemplate));
+}
+async function writeGeneratedEditorsFiles(projectDir) {
+	await writeFileEnsuringDir(join(projectDir, "editors/editors.ts"), await formatSafe(editorsTemplate));
+	await writeFileEnsuringDir(join(projectDir, "editors/index.ts"), await formatSafe(editorsIndexTemplate));
+}
+async function writeGeneratedProcessorsFiles(projectDir) {
+	await writeFileEnsuringDir(join(projectDir, "processors/factory.ts"), await formatSafe(processorsFactoryTemplate));
+	await writeFileEnsuringDir(join(projectDir, "processors/index.ts"), await formatSafe(processorsIndexTemplate));
+	await writeFileEnsuringDir(join(projectDir, "processors/connect.ts"), await formatSafe(factoryBuildersTemplate));
+	await writeFileEnsuringDir(join(projectDir, "processors/switchboard.ts"), await formatSafe(factoryBuildersTemplate));
+	await writeFileEnsuringDir(join(projectDir, "processors/index.ts"), await formatSafe(processorsIndexTemplate));
+}
+async function writeGeneratedSubgraphsFiles(projectDir) {
+	await writeFileEnsuringDir(join(projectDir, "subgraphs/index.ts"), await formatSafe(subgraphsIndexTemplate));
+}
+async function writeModuleFiles(projectDir = process.cwd()) {
+	await writeGeneratedDocumentModelsFiles(projectDir);
+	await writeGeneratedEditorsFiles(projectDir);
+	await writeGeneratedProcessorsFiles(projectDir);
+	await writeGeneratedSubgraphsFiles(projectDir);
+}
+async function writeAiConfigFiles(projectDir = process.cwd()) {
+	await writeFileEnsuringDir(join(projectDir, "CLAUDE.md"), agentsTemplate);
+	await writeFileEnsuringDir(join(projectDir, "AGENTS.md"), agentsTemplate);
+	await writeFileEnsuringDir(join(projectDir, ".mcp.json"), mcpTemplate);
+	await writeFileEnsuringDir(join(projectDir, ".gemini/settings.json"), geminiSettingsTemplate);
+	await writeFileEnsuringDir(join(projectDir, ".cursor/mcp.json"), cursorMcpTemplate);
+	await writeFileEnsuringDir(join(projectDir, ".claude/settings.local.json"), claudeSettingsLocalTemplate);
+}
+async function writeProjectRootFiles(args, projectDir = process.cwd()) {
+	const { name, tag, version, remoteDrive } = args;
+	await writeFileEnsuringDir("LICENSE", licenseTemplate);
+	await writeFileEnsuringDir("README.md", readmeTemplate);
+	await writeFileEnsuringDir(".npmrc", npmrcTemplate);
+	const packageJson = await buildBoilerplatePackageJson({
+		name,
+		tag,
+		version
+	});
+	await createOrUpdateManifest({ name }, projectDir);
+	await writeFileEnsuringDir("powerhouse.config.json", await buildPowerhouseConfigTemplate({
+		tag,
+		version,
+		remoteDrive
+	}));
+	await writeFileEnsuringDir("package.json", packageJson);
+}
+async function writeCIFiles(projectDir = process.cwd()) {
+	await writeFileEnsuringDir(join(projectDir, ".github/workflows/sync-and-publish.yml"), syncAndPublishWorkflowTemplate);
+	await writeFileEnsuringDir(join(projectDir, "Dockerfile"), dockerfileTemplate);
+	await writeFileEnsuringDir(join(projectDir, "docker/nginx.conf"), nginxConfTemplate);
+	await writeFileEnsuringDir(join(projectDir, "docker/connect-entrypoint.sh"), connectEntrypointTemplate);
+	await writeFileEnsuringDir(join(projectDir, "docker/switchboard-entrypoint.sh"), switchboardEntrypointTemplate);
+}
+async function writeAllGeneratedProjectFiles(projectDir = process.cwd()) {
+	await writeGeneratedProjectRootFiles(projectDir);
+	await writeModuleFiles(projectDir);
+	await writeAiConfigFiles(projectDir);
+	await writeCIFiles(projectDir);
+}
+//#endregion
+//#region src/file-builders/boilerplate/package.json.ts
+async function buildBoilerplatePackageJson(args) {
+	const { name, tag, version, workspace } = args;
+	return packageJsonTemplate(name, await makeVersionedDependencies({
+		names: VERSIONED_DEPENDENCIES,
+		tag,
+		version
+	}), await makeVersionedDependencies({
+		names: VERSIONED_DEV_DEPENDENCIES,
+		tag,
+		version
+	}));
+}
+//#endregion
+//#region src/file-builders/clis/generate-cli-docs.ts
+function getCommandHelpInfo(entry) {
+	return {
+		name: entry.name,
+		description: entry.command.description ?? "",
+		helpTopics: entry.command.helpTopics?.() ?? []
+	};
+}
+function getCommandsHelpInfo(entries) {
+	return entries.map(getCommandHelpInfo);
+}
+function makeCliDocsFromHelp(args) {
+	const { cliDescription, docsIntroduction, docsTitle, entries } = args;
+	return stripVTControlCharacters(docsFromCliHelpTemplate({
+		cliDescription,
+		docsIntroduction,
+		docsTitle,
+		commandsHelpInfo: getCommandsHelpInfo(entries)
+	}));
+}
+async function writeCliDocsMarkdownFile(args) {
+	const { filePath, ...restArgs } = args;
+	await writeFile(filePath, makeCliDocsFromHelp(restArgs), { encoding: "utf-8" });
+}
+//#endregion
+//#region src/file-builders/constants.ts
+const exportPaths = [
+	"document-models",
+	"editors",
+	"subgraphs",
+	"processors"
+];
+const rootExportPaths = { ".": {
+	types: "./dist/index.d.ts",
+	browser: "./dist/browser/index.js",
+	node: "./dist/node/index.mjs"
+} };
+const nonStandardExportPaths = {
+	"./manifest": "./dist/powerhouse.manifest.json",
+	"./style.css": "./dist/style.css"
 };
-`;
+const packageScripts = {
+	"test:watch": "vitest",
+	lint: "eslint --config eslint.config.js --cache",
+	"lint:fix": "npm run lint -- --fix",
+	tsc: "tsc",
+	"tsc:watch": "tsc --watch",
+	generate: "ph-cli generate",
+	connect: "ph-cli connect",
+	build: "ph-cli build",
+	reactor: "ph-cli reactor",
+	service: "ph-cli service",
+	vetra: "ph-cli vetra",
+	"service-startup": "bash ./node_modules/@powerhousedao/ph-cli/dist/scripts/service-startup.sh",
+	"service-unstartup": "bash ./node_modules/@powerhousedao/ph-cli/dist/scripts/service-unstartup.sh"
+};
+const externalDependencies = {
+	"@powerhousedao/document-engineering": "1.40.1",
+	graphql: "^16.10.0",
+	"graphql-tag": "^2.12.6",
+	zod: "^4.3.5",
+	react: "^19.2.3",
+	"react-dom": "^19.2.3"
+};
+const externalDevDependencies = {
+	"@eslint/js": "^9.38.0",
+	"@tailwindcss/cli": "^4.1.18",
+	"@types/node": "^24.9.2",
+	"@types/react": "^19.2.3",
+	eslint: "^9.38.0",
+	"eslint-plugin-react": "^7.37.5",
+	"eslint-plugin-react-hooks": "^7.0.1",
+	"eslint-config-prettier": "^10.1.8",
+	"eslint-plugin-prettier": "^5.5.4",
+	globals: "^16.4.0",
+	tailwindcss: "^4.1.16",
+	typescript: "^5.9.3",
+	"typescript-eslint": "^8.46.2",
+	vitest: "4.1.1",
+	"@vitejs/plugin-react": "6.0.1",
+	"vite-tsconfig-paths": "6.1.1"
 };
-function pascal(name) {
-	return name.split(/[-_\s]+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join("");
+const defaultManifest = {
+	name: "",
+	description: "",
+	category: "",
+	publisher: {
+		name: "",
+		url: ""
+	},
+	documentModels: [],
+	editors: [],
+	apps: [],
+	subgraphs: [],
+	processors: []
+};
+//#endregion
+//#region src/file-builders/document-editor.ts
+/** Generates a document editor for the given `documentModelId` (also called `documentType`) */
+async function tsMorphGenerateDocumentEditor({ project, editorDir, editorName, editorId, documentModelId }) {
+	const { directory: documentModelsDir } = getOrCreateDirectory(project, "document-models");
+	const documentModelsDirPath = documentModelsDir.getPath();
+	const { directory: editorsDir } = getOrCreateDirectory(project, "editors");
+	const editorsDirPath = editorsDir.getPath();
+	const projectDir = editorsDir.getParentOrThrow().getPath();
+	const editorDirPath = path.join(editorsDirPath, editorDir);
+	await ensureDirectoriesExist(project, documentModelsDirPath, editorsDirPath, editorDirPath, path.join(editorDirPath, "components"));
+	const documentTypeMetadata = getDocumentTypeMetadata({
+		project,
+		documentModelId
+	});
+	const editorVariableNames = getEditorVariableNames(documentTypeMetadata);
+	await makeEditorComponent({
+		project,
+		editorDirPath,
+		...documentTypeMetadata,
+		...editorVariableNames
+	});
+	makeEditorModuleFile({
+		project,
+		editorName,
+		editorId,
+		documentModelId,
+		editorDirPath
+	});
+	await makeEditorsFile({
+		project,
+		editorsDirPath
+	});
+	await makeEditorsIndexFile({
+		project,
+		editorsDirPath
+	});
+	await createOrUpdateManifest({ editors: [{
+		name: editorName,
+		id: editorId,
+		documentTypes: [documentTypeMetadata.documentModelId]
+	}] }, projectDir);
+}
+async function makeEditorComponent(args) {
+	const { project, editorDirPath } = args;
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(editorDirPath, "editor.tsx"));
+	if (alreadyExists) {
+		const functionDeclaration = sourceFile.getFunction("Editor");
+		if (functionDeclaration) {
+			if (!functionDeclaration.isDefaultExport()) functionDeclaration.setIsDefaultExport(true);
+			return;
+		}
+	}
+	const template = documentEditorEditorFileTemplate(args);
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/codegen/graphql.ts
+const scalars = {
+	Unknown: "unknown",
+	DateTime: "string",
+	Attachment: "string",
+	Address: "`${string}:0x${string}`",
+	...generatorTypeDefs
+};
+const scalarsValidation = {
+	Unknown: "z.unknown()",
+	DateTime: "z.string().datetime()",
+	Attachment: "z.string()",
+	Address: "z.custom<`${string}:0x${string}`>((val) => /^[a-zA-Z0-9]+:0x[a-fA-F0-9]{40}$/.test(val as string))",
+	...validationSchema
+};
+const avoidOptionals = {
+	field: true,
+	inputValue: false
+};
+const maybeValue = "T | null | undefined";
+const typescriptConfig = {
+	avoidOptionals,
+	scalars,
+	strictScalars: true,
+	enumsAsTypes: true,
+	skipTypename: true,
+	maybeValue
+};
+const validationSchemaConfig = {
+	avoidOptionals,
+	scalars,
+	strictScalars: true,
+	enumsAsTypes: true,
+	skipTypename: true,
+	importFrom: `./types.js`,
+	schema: "zodv4",
+	useTypeImports: true,
+	scalarSchemas: scalarsValidation,
+	directives: { equals: { value: ["regex", "/^$1$/"] } },
+	withObjectType: true,
+	maybeValue
+};
+function buildSchemasForModules(modules) {
+	const schemaStrings = [];
+	for (const module of modules) {
+		schemaStrings.push(`# ${module.name}`);
+		const operationsSchemas = module.operations.map((operation) => operation.schema).filter((schema) => schema !== null);
+		schemaStrings.push(...operationsSchemas);
+	}
+	return schemaStrings;
+}
+function buildGraphqlDocumentStringForSpecification(specification) {
+	const customScalarSchemas = Object.keys(scalars).map((k) => `scalar ${k}`).join("\n");
+	const stateSchemas = Object.values(specification.state).map((state) => state.schema);
+	const moduleSchemas = buildSchemasForModules(specification.modules);
+	return [
+		customScalarSchemas,
+		...stateSchemas,
+		...moduleSchemas
+	];
+}
+async function formatContentWithPrettier(path, content) {
+	return await format(content, { parser: "typescript" });
+}
+async function generateTypesAndZodSchemasFromGraphql(args) {
+	const { schemaDirPath, schema } = args;
+	await generate({
+		overwrite: true,
+		watch: false,
+		hooks: { beforeOneFileWrite: formatContentWithPrettier },
+		generates: {
+			[`${schemaDirPath}/types.ts`]: {
+				schema,
+				config: typescriptConfig,
+				plugins: [{ typescript: typescriptConfig }]
+			},
+			[`${schemaDirPath}/zod.ts`]: {
+				schema,
+				config: validationSchemaConfig,
+				plugins: [{ add: { content: "/* eslint-disable @typescript-eslint/no-empty-object-type */" } }, { "graphql-codegen-typescript-validation-schema": validationSchemaConfig }]
+			}
+		}
+	}, true);
+}
+async function generateDocumentModelZodSchemas(args) {
+	const { specification, schemaDirPath, versionDirPath } = args;
+	const schema = buildGraphqlDocumentStringForSpecification(specification).filter(Boolean).join("\n\n");
+	await generateTypesAndZodSchemasFromGraphql({
+		schemaDirPath,
+		schema
+	});
+	await fs.writeFile(path$1.join(versionDirPath, "schema.graphql"), schema);
+}
+//#endregion
+//#region src/file-builders/document-model/gen-dir.ts
+async function makeDocumentModelGenDirOperationModulesFiles(fileMakerArgs) {
+	for (const module of fileMakerArgs.specification.modules) await makeGenDirOperationModuleFiles({
+		...fileMakerArgs,
+		module
+	});
+}
+async function makeGenDirOperationModuleFiles(fileMakerArgs) {
+	await makeOperationModuleGenActionsFile(fileMakerArgs);
+	await makeOperationModuleGenCreatorsFile(fileMakerArgs);
+	await makeOperationModuleGenOperationsFile(fileMakerArgs);
+	await makeOperationModuleGenErrorFile(fileMakerArgs);
+}
+async function makeDocumentModelGenUtilsFile(args) {
+	const template = documentModelGenUtilsTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "utils.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelDocumentTypeFile(args) {
+	const template = documentModelDocumentTypeTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "document-type.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelSchemaIndexFile(args) {
+	const template = documentModelSchemaIndexTemplate;
+	const { project, schemaDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(schemaDirPath, "index.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenTypesFile(args) {
+	const template = documentModelGenTypesTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "types.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenDocumentModelFile(args) {
+	const { project, genDirPath, documentModelState } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "document-model.ts"));
+	sourceFile.replaceWithText("");
+	sourceFile.addImportDeclaration({
+		namedImports: ["DocumentModelGlobalState"],
+		moduleSpecifier: "document-model",
+		isTypeOnly: true
+	});
+	const documentModelStateString = buildObjectLiteral(documentModelState, sourceFile);
+	sourceFile.addVariableStatement({
+		declarationKind: VariableDeclarationKind.Const,
+		isExported: true,
+		declarations: [{
+			name: "documentModel",
+			type: "DocumentModelGlobalState",
+			initializer: documentModelStateString
+		}]
+	});
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenDocumentSchemaFile(args) {
+	const template = documentModelDocumentSchemaFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "document-schema.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenCreatorsFile(args) {
+	const template = documentModelGenCreatorsFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "creators.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenPhFactoriesFile(args) {
+	const template = documentModelPhFactoriesFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "ph-factories.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenControllerFile(args) {
+	const template = documentModelGenControllerFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "controller.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenIndexFile(args) {
+	const template = documentModelGenIndexFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "index.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenActionsFile(args) {
+	const template = documentModelGenActionsFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "actions.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelGenReducerFile(args) {
+	const template = documentModelGenReducerFileTemplate(args);
+	const { project, genDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(genDirPath, "reducer.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeOperationModuleGenActionsFile(args) {
+	const { module } = args;
+	const kebabCaseModuleName = kebabCase(module.name);
+	const template = documentModelOperationModuleActionsFileTemplate(args);
+	const { project, genDirPath } = args;
+	const dirPath = path.join(genDirPath, kebabCaseModuleName);
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(dirPath, "actions.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeOperationModuleGenCreatorsFile(args) {
+	const { module } = args;
+	const kebabCaseModuleName = kebabCase(module.name);
+	const template = documentModelOperationsModuleCreatorsFileTemplate(args);
+	const { project, genDirPath } = args;
+	const dirPath = path.join(genDirPath, kebabCaseModuleName);
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(dirPath, "creators.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeOperationModuleGenOperationsFile(args) {
+	const { module } = args;
+	const kebabCaseModuleName = kebabCase(module.name);
+	const template = documentModelOperationsModuleOperationsFileTemplate(args);
+	const { project, genDirPath } = args;
+	const dirPath = path.join(genDirPath, kebabCaseModuleName);
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(dirPath, "operations.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeOperationModuleGenErrorFile(args) {
+	const { module } = args;
+	const kebabCaseModuleName = kebabCase(module.name);
+	const template = documentModelOperationsModuleErrorFileTemplate(args);
+	const { project, genDirPath } = args;
+	const dirPath = path.join(genDirPath, kebabCaseModuleName);
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(dirPath, "error.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/document-model/root-dir.ts
+async function makeDocumentModelVersionIndexFile(args) {
+	const template = documentModelIndexTemplate;
+	const { project, versionDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(versionDirPath, "index.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelUtilsFile(args) {
+	const template = documentModelUtilsTemplate(args);
+	const { project, versionDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(versionDirPath, "utils.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelRootActionsFile(args) {
+	const template = documentModelRootActionsFileTemplate(args);
+	const { project, versionDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(versionDirPath, "actions.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelHooksFile(args) {
+	const template = documentModelHooksFileTemplate(args);
+	const { project, versionDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(versionDirPath, "hooks.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelModuleFile(args) {
+	const { project, versionDirPath } = args;
+	const template = documentModelModuleFileTemplate(args);
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(versionDirPath, "module.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/document-model/src-dir.ts
+async function makeReducerOperationHandlersForModules(fileMakerArgs) {
+	const { specification } = fileMakerArgs;
+	for (const module of specification.modules) await makeReducerOperationHandlerForModule({
+		...fileMakerArgs,
+		module
+	});
+}
+async function makeReducerOperationHandlerForModule({ project, module, version, srcDirPath, versionImportPath, pascalCaseDocumentType, camelCaseDocumentType }) {
+	const kebabCaseModuleName = kebabCase(module.name);
+	const pascalCaseModuleName = pascalCase(module.name);
+	const filePath = path.join(srcDirPath, "reducers", `${kebabCaseModuleName}.ts`);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, filePath);
+	if (!alreadyExists) {
+		const previousVersionFile = getPreviousVersionSourceFile({
+			project,
+			version,
+			filePath
+		});
+		if (previousVersionFile) sourceFile.replaceWithText(previousVersionFile.getText());
+	}
+	const operationsInterfaceTypeName = `${pascalCaseDocumentType}${pascalCaseModuleName}Operations`;
+	const operationsInterfaceVariableName = `${camelCaseDocumentType}${pascalCaseModuleName}Operations`;
+	const existingOperationsInterfaceTypeImport = sourceFile.getImportDeclaration((importDeclaration) => !!importDeclaration.getNamedImports().find((importSpecifier) => importSpecifier.getName() === operationsInterfaceTypeName));
+	if (existingOperationsInterfaceTypeImport) existingOperationsInterfaceTypeImport.remove();
+	const operationsInterfaceTypeProperties = sourceFile.addImportDeclaration({
+		namedImports: [operationsInterfaceTypeName],
+		moduleSpecifier: versionImportPath,
+		isTypeOnly: true
+	}).getNamedImports().find((value) => value.getName() === operationsInterfaceTypeName)?.getNameNode().getType().getProperties().map((symbol) => symbol.getName());
+	if (!operationsInterfaceTypeProperties) throw new Error("Failed to create operation handler object");
+	let operationsInterfaceVariableStatement = sourceFile.getVariableStatement(operationsInterfaceVariableName);
+	if (!operationsInterfaceVariableStatement) operationsInterfaceVariableStatement = sourceFile.addVariableStatement({
+		declarationKind: VariableDeclarationKind.Const,
+		isExported: true,
+		declarations: [{
+			name: operationsInterfaceVariableName,
+			type: operationsInterfaceTypeName,
+			initializer: "{}"
+		}]
+	});
+	const operationsInterfaceObject = getObjectLiteral(operationsInterfaceVariableStatement);
+	if (!operationsInterfaceObject) throw new Error("Failed to build reducer object");
+	const operationsByMethodName = /* @__PURE__ */ new Map();
+	for (const operation of module.operations) if (operation.name) {
+		const methodName = `${camelCase(operation.name)}Operation`;
+		operationsByMethodName.set(methodName, operation);
+	}
+	for (const name of operationsInterfaceTypeProperties) {
+		if (operationsInterfaceObject.getProperty(name)) continue;
+		const reducerCode = operationsByMethodName.get(name)?.reducer?.trim();
+		operationsInterfaceObject.addMethod({
+			name,
+			parameters: [{ name: "state" }, { name: "action" }],
+			statements: reducerCode ? [reducerCode] : [`// TODO: implement ${name} reducer`, ts$1`throw new Error("Reducer for '${name}' not implemented.")`.raw]
+		});
+	}
+	addErrorImportsForModule(sourceFile, module);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelSrcIndexFile({ project, ...variableNames }) {
+	const template = documentModelSrcIndexFileTemplate;
+	const { srcDirPath } = variableNames;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(srcDirPath, "index.ts"));
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelSrcUtilsFile({ project, srcDirPath, version }) {
+	const template = documentModelSrcUtilsTemplate;
+	const filePath = path.join(srcDirPath, "utils.ts");
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, filePath);
+	if (!alreadyExists) {
+		const previousVersionSourceFile = getPreviousVersionSourceFile({
+			project,
+			version,
+			filePath
+		});
+		if (previousVersionSourceFile) sourceFile.replaceWithText(previousVersionSourceFile.getText());
+		else sourceFile.replaceWithText(template);
+	}
+	await formatSourceFileWithPrettier(sourceFile);
+}
+function addErrorImportsForModule(sourceFile, module) {
+	const allErrors = [];
+	for (const operation of module.operations) if (Array.isArray(operation.errors)) {
+		for (const error of operation.errors) if (error.name && !allErrors.find((e) => e.name === error.name)) allErrors.push({ name: error.name });
+	}
+	if (allErrors.length === 0) return;
+	const sourceFileContent = sourceFile.getFullText();
+	const usedErrors = [];
+	for (const error of allErrors) if (new RegExp(`\\b${error.name}\\b`, "g").test(sourceFileContent)) usedErrors.push(error.name);
+	if (usedErrors.length === 0) return;
+	const errorImportPath = `../../gen/${kebabCase(module.name)}/error.js`;
+	const existingErrorImport = sourceFile.getImportDeclarations().find((importDecl) => importDecl.getModuleSpecifierValue() === errorImportPath);
+	if (existingErrorImport) {
+		const existingNamedImports = existingErrorImport.getNamedImports().map((namedImport) => namedImport.getName());
+		const newErrorsToImport = usedErrors.filter((errorName) => !existingNamedImports.includes(errorName));
+		if (newErrorsToImport.length > 0) existingErrorImport.addNamedImports(newErrorsToImport);
+	} else sourceFile.addImportDeclaration({
+		namedImports: usedErrors,
+		moduleSpecifier: errorImportPath
+	});
+}
+//#endregion
+//#region src/file-builders/document-model/tests-dir.ts
+async function makeDocumentModelModulesOperationTestFiles(fileMakerArgs) {
+	for (const module of fileMakerArgs.specification.modules) await makeOperationModuleTestFile({
+		...fileMakerArgs,
+		module
+	});
+}
+async function makeOperationModuleTestFile(args) {
+	const { project, module, version, versionImportPath, testsDirPath, isPhDocumentOfTypeFunctionName } = args;
+	const kebabCaseModuleName = kebabCase(module.name);
+	const moduleOperationsTypeName = `${pascalCase(module.name)}Operations`;
+	const filePath = path.join(testsDirPath, `${kebabCaseModuleName}.test.ts`);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, filePath);
+	if (!alreadyExists) {
+		const previousVersionSourceFile = getPreviousVersionSourceFile({
+			project,
+			version,
+			filePath
+		});
+		if (previousVersionSourceFile) sourceFile.replaceWithText(previousVersionSourceFile.getText());
+		else sourceFile.replaceWithText(ts$1`
+        import { generateMock } from "document-model";
+        import { describe, expect, it } from "vitest";
+
+        describe("${moduleOperationsTypeName}", () => {
+
+        });
+        `.raw);
+	}
+	const importNames = makeOperationImportNames(args);
+	const namedImports = importNames.map((name) => ({ name }));
+	let actionsImportDeclaration = sourceFile.getImportDeclarations().filter((i) => !i.isTypeOnly()).find((importDeclaration) => importDeclaration.getModuleSpecifier().getText().includes(versionImportPath));
+	if (!actionsImportDeclaration) actionsImportDeclaration = sourceFile.addImportDeclaration({
+		namedImports,
+		moduleSpecifier: versionImportPath
+	});
+	else {
+		actionsImportDeclaration.setModuleSpecifier(versionImportPath);
+		const existingNamedImports = actionsImportDeclaration.getNamedImports().map((value) => value.getName());
+		for (const name of importNames) if (!existingNamedImports.includes(name)) actionsImportDeclaration.addNamedImport(name);
+	}
+	const describeCall = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).find((call) => {
+		const expressionText = call.getExpression().getText();
+		const firstArg = call.getArguments()[0];
+		return expressionText === "describe" && pascalCase(firstArg.getText()).includes(moduleOperationsTypeName);
+	});
+	if (!describeCall) {
+		console.error(`Test file at path ${filePath} has no describe block for ${moduleOperationsTypeName}`);
+		return;
+	}
+	const describeCallBody = describeCall.getArguments()[1].asKindOrThrow(SyntaxKind.ArrowFunction);
+	const testCaseNames = describeCall.getDescendantsOfKind(SyntaxKind.CallExpression).filter((call) => {
+		const expressionText = call.getExpression().getText();
+		return expressionText === "it" || expressionText === "test";
+	}).map((c) => c.getArguments()[0].getText());
+	const testCasesToAdd = pipe(module.operations, filter((o) => !isIncludedIn(camelCase(o.name ?? ""), testCaseNames)), map((o) => makeTestCaseForOperation(o, isPhDocumentOfTypeFunctionName)));
+	describeCallBody.addStatements(testCasesToAdd);
+	const GENERATE_MOCK_NAME = "generateMock";
+	const GENERATE_MOCK_MODULE_SPECIFIER = "@powerhousedao/codegen";
+	const generateMockImport = sourceFile.getImportDeclaration((i) => i.getNamedImports().some((v) => v.getText().includes(GENERATE_MOCK_NAME)));
+	if (sourceFile.getText().includes(GENERATE_MOCK_NAME) && !generateMockImport) sourceFile.addImportDeclaration({
+		namedImports: [GENERATE_MOCK_NAME],
+		moduleSpecifier: GENERATE_MOCK_MODULE_SPECIFIER
+	});
+	sourceFile.fixUnusedIdentifiers();
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelTestFile(args) {
+	const { project, testsDirPath } = args;
+	const template = documentModelTestFileTemplate(args);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(testsDirPath, "document-model.test.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/document-model/upgrades-dir.ts
+async function makeUpgradeFile(args) {
+	const { project, version, upgradesDirPath } = args;
+	if (version < 2) return;
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(upgradesDirPath, `v${version}.ts`));
+	if (alreadyExists) return;
+	const template = upgradeTransitionTemplate(args);
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function createOrUpdateUpgradeManifestFile(args) {
+	const { project, versions, upgradesDirPath } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(upgradesDirPath, "upgrade-manifest.ts"));
+	const template = upgradeManifestTemplate(args);
+	sourceFile.replaceWithText(template);
+	const upgradeTransitionImports = buildUpgradeTransitionImports(versions);
+	sourceFile.addImportDeclarations(upgradeTransitionImports);
+	const upgradeManifestStatement = getVariableDeclarationByTypeName(sourceFile, "UpgradeManifest")?.getVariableStatementOrThrow();
+	const upgradesProperty = getObjectLiteral(upgradeManifestStatement)?.getProperty("upgrades");
+	const upgrades = buildUpgrades(versions);
+	upgradesProperty?.replaceWithText(upgrades);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+function buildUpgrades(specVersions) {
+	const upgradeStrings = [];
+	for (const version of specVersions) {
+		if (version < 2) continue;
+		upgradeStrings.push(`v${version}`);
+	}
+	return `upgrades: { ${upgradeStrings.join(",\n")} }`;
+}
+function buildUpgradeTransitionImports(specVersions) {
+	const imports = [];
+	for (const version of specVersions) {
+		if (version < 2) continue;
+		const namedImports = [`v${version}`];
+		const moduleSpecifier = `./v${version}.js`;
+		imports.push({
+			namedImports,
+			moduleSpecifier
+		});
+	}
+	return imports;
+}
+async function createOrUpdateVersionConstantsFile({ versions, latestVersion, project, upgradesDirPath }) {
+	const SUPPORTED_VERSIONS = "supportedVersions";
+	const LATEST_VERSION = "latestVersion";
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(upgradesDirPath, "versions.ts"));
+	sourceFile.replaceWithText("");
+	const latestVersionIndex = versions.indexOf(latestVersion);
+	const versionInitializer = `[${versions.join(", ")}] as const;`;
+	const latestInitializer = `${SUPPORTED_VERSIONS}[${latestVersionIndex}];`;
+	sourceFile.addVariableStatement({
+		declarationKind: VariableDeclarationKind.Const,
+		isExported: true,
+		declarations: [{
+			name: SUPPORTED_VERSIONS,
+			initializer: versionInitializer
+		}]
+	});
+	sourceFile.addVariableStatement({
+		declarationKind: VariableDeclarationKind.Const,
+		isExported: true,
+		declarations: [{
+			name: LATEST_VERSION,
+			initializer: latestInitializer
+		}]
+	});
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeUpgradesIndexFile({ project, upgradesDirPath, versions, upgradeManifestName }) {
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(upgradesDirPath, "index.ts"));
+	sourceFile.replaceWithText("");
+	const upgradeReducerExports = makeUpgradeReducerExports(versions);
+	sourceFile.addExportDeclarations([
+		{
+			namedExports: [upgradeManifestName],
+			moduleSpecifier: "./upgrade-manifest.js"
+		},
+		{
+			namedExports: ["supportedVersions", "latestVersion"],
+			moduleSpecifier: "./versions.js"
+		},
+		...upgradeReducerExports
+	]);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+function makeUpgradeReducerExports(specVersions) {
+	const exports = [];
+	for (const version of specVersions) {
+		if (version < 2) continue;
+		const namedExports = [`v${version}`];
+		const moduleSpecifier = `./v${version}.js`;
+		exports.push({
+			namedExports,
+			moduleSpecifier
+		});
+	}
+	return exports;
+}
+//#endregion
+//#region src/file-builders/document-model/document-model.ts
+/** Generates a document model from the given `documentModelState`
+*
+* for each `specification` in the `documentModelState`
+*/
+async function tsMorphGenerateDocumentModel(documentModelState, project) {
+	const { name, id, specifications } = documentModelState;
+	const { directory: documentModelsDir } = getOrCreateDirectory(project, "document-models");
+	const documentModelsDirPath = documentModelsDir.getPath();
+	const projectDir = documentModelsDir.getParentOrThrow().getPath();
+	const documentModelDirName = kebabCase(name);
+	const documentModelDirPath = join$1(documentModelsDirPath, documentModelDirName);
+	const documentModelImportPath = join$1("document-models", documentModelDirName);
+	const upgradesDirPath = join$1(documentModelDirPath, "upgrades");
+	const documentModelVariableNames = getDocumentModelVariableNames(name);
+	await ensureDirectoriesExist(project, documentModelsDirPath, documentModelDirPath, upgradesDirPath);
+	const versions = pipe(specifications, map(prop("version")), unique(), sort(subtract));
+	if (versions.length !== specifications.length) throw new Error("Document model specifications array is misconfigured. Length does not match with spec versions.");
+	const latestVersion = Math.max(...versions);
+	if (prop(last(specifications), "version") !== latestVersion) throw new Error("Document model has incorrect version at the latest version index");
+	await writeDocumentModelStateJsonFile({
+		documentModelState,
+		documentModelDirName,
+		documentModelDirPath
+	});
+	for (const specification of specifications) {
+		const { version } = specification;
+		const versionDirName = `v${version}`;
+		const versionDirPath = join$1(documentModelDirPath, versionDirName);
+		const versionImportPath = join$1(documentModelImportPath, versionDirName);
+		const srcDirPath = join$1(versionDirPath, "src");
+		const testsDirPath = join$1(versionDirPath, "tests");
+		const genDirPath = join$1(versionDirPath, "gen");
+		const schemaDirPath = join$1(genDirPath, "schema");
+		const { initialGlobalState, initialLocalState } = getInitialStates(specification.state);
+		const hasLocalSchema = specification.state.local.schema !== "";
+		const fileMakerArgs = {
+			...documentModelVariableNames,
+			project,
+			documentModelState,
+			version,
+			versions,
+			latestVersion,
+			specification,
+			initialGlobalState,
+			initialLocalState,
+			hasLocalSchema,
+			projectDir,
+			documentModelsDirPath,
+			documentModelDirPath,
+			documentModelDirName,
+			documentModelImportPath,
+			versionDirPath,
+			versionDirName,
+			versionImportPath,
+			genDirPath,
+			schemaDirPath,
+			srcDirPath,
+			testsDirPath,
+			upgradesDirPath
+		};
+		await generateDocumentModelZodSchemas(fileMakerArgs);
+		await makeDocumentModelVersionIndexFile(fileMakerArgs);
+		await makeDocumentModelRootActionsFile(fileMakerArgs);
+		await makeDocumentModelUtilsFile(fileMakerArgs);
+		await makeDocumentModelHooksFile(fileMakerArgs);
+		await makeDocumentModelModuleFile(fileMakerArgs);
+		await makeDocumentModelSchemaIndexFile(fileMakerArgs);
+		await makeDocumentModelGenUtilsFile(fileMakerArgs);
+		await makeDocumentModelGenTypesFile(fileMakerArgs);
+		await makeDocumentModelGenCreatorsFile(fileMakerArgs);
+		await makeDocumentModelGenActionsFile(fileMakerArgs);
+		await makeDocumentModelGenDocumentSchemaFile(fileMakerArgs);
+		await makeDocumentModelGenReducerFile(fileMakerArgs);
+		await makeDocumentModelDocumentTypeFile(fileMakerArgs);
+		await makeDocumentModelGenIndexFile(fileMakerArgs);
+		await makeDocumentModelGenDocumentModelFile(fileMakerArgs);
+		await makeDocumentModelGenPhFactoriesFile(fileMakerArgs);
+		await makeDocumentModelGenControllerFile(fileMakerArgs);
+		await makeDocumentModelGenDirOperationModulesFiles(fileMakerArgs);
+		await makeDocumentModelSrcIndexFile(fileMakerArgs);
+		await makeDocumentModelSrcUtilsFile(fileMakerArgs);
+		await makeReducerOperationHandlersForModules(fileMakerArgs);
+		await makeDocumentModelTestFile(fileMakerArgs);
+		await makeDocumentModelModulesOperationTestFiles(fileMakerArgs);
+		await persistCustomFilesFromPreviousVersion(fileMakerArgs);
+		await makeUpgradeFile(fileMakerArgs);
+		await createOrUpdateUpgradeManifestFile(fileMakerArgs);
+	}
+	await createOrUpdateVersionConstantsFile({
+		project,
+		versions,
+		latestVersion,
+		upgradesDirPath
+	});
+	await makeUpgradesIndexFile({
+		...documentModelVariableNames,
+		project,
+		versions,
+		upgradesDirPath
+	});
+	await makeDocumentModelIndexFile({
+		project,
+		documentModelDirPath,
+		latestVersion
+	});
+	await makeDocumentModelsFile({
+		project,
+		documentModelsDirPath
+	});
+	await makeDocumentModelsIndexFile({
+		project,
+		documentModelsDirPath
+	});
+	await makeUpgradeManifestsFile({
+		project,
+		documentModelsDirPath
+	});
+	await createOrUpdateManifest({ documentModels: [{
+		name,
+		id
+	}] }, projectDir);
+}
+async function makeUpgradeManifestsFile(args) {
+	const { project, documentModelsDirPath } = args;
+	const sourceFile = project.createSourceFile(join$1(documentModelsDirPath, "upgrade-manifests.ts"), upgradeManifestsTemplate, { overwrite: true });
+	const upgradeManifestsArray = sourceFile.getVariableDeclarationOrThrow("upgradeManifests").getFirstDescendantByKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+	pipe(project.getSourceFiles(), filter((sourceFile) => sourceFile.getBaseName() === "upgrade-manifest.ts"), map((sourceFile) => getVariableDeclarationByTypeName(sourceFile, "UpgradeManifest")), filter(isTruthy), map((variableDeclaration) => ({
+		name: variableDeclaration.getName(),
+		documentModelDir: variableDeclaration.getSourceFile().getDirectory().getParentOrThrow().getBaseName()
+	})), uniqueBy(prop("name")), map(({ name, documentModelDir }) => ({
+		name,
+		namedImports: [name],
+		moduleSpecifier: join$1("document-models", documentModelDir, "upgrades")
+	})), forEach(({ name, namedImports, moduleSpecifier }) => {
+		sourceFile.addImportDeclaration({
+			namedImports,
+			moduleSpecifier
+		});
+		upgradeManifestsArray.addElement(name);
+	}));
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelsFile(args) {
+	const { project, documentModelsDirPath } = args;
+	const sourceFile = project.createSourceFile(join$1(documentModelsDirPath, "document-models.ts"), documentModelsTemplate, { overwrite: true });
+	const documentModelsArray = sourceFile.getVariableDeclarationOrThrow("documentModels").getFirstDescendantByKindOrThrow(SyntaxKind.ArrayLiteralExpression);
+	pipe(project.getDirectoryOrThrow(documentModelsDirPath).getDescendantSourceFiles(), filter((sourceFile) => sourceFile.getBaseName() === "module.ts"), uniqueBy((sourceFile) => sourceFile.getFilePath()), map((sourceFile) => getVariableDeclarationByTypeName(sourceFile, "DocumentModel")), filter(isTruthy), map((variableDeclaration) => ({
+		name: variableDeclaration.getName(),
+		directory: variableDeclaration.getSourceFile().getDirectory()
+	})), map(({ name, directory }) => ({
+		name,
+		version: directory.getBaseName(),
+		documentModelDir: directory.getParentOrThrow().getBaseName()
+	})), filter(({ version }) => /^v\d+$/.test(version)), map(({ name, version, documentModelDir }) => ({
+		name: `${name}${capitalize(version)}`,
+		namedImports: [`${name} as ${name}${capitalize(version)}`],
+		moduleSpecifier: join$1("document-models", documentModelDir, version)
+	})), forEach(({ name, namedImports, moduleSpecifier }) => {
+		sourceFile.addImportDeclaration({
+			namedImports,
+			moduleSpecifier
+		});
+		documentModelsArray.addElement(name);
+	}));
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeDocumentModelsIndexFile(args) {
+	const { project, documentModelsDirPath } = args;
+	const sourceFile = project.createSourceFile(join$1(documentModelsDirPath, "index.ts"), "", { overwrite: true });
+	pipe(project.getDirectoryOrThrow(documentModelsDirPath).getDescendantSourceFiles(), filter((sourceFile) => sourceFile.getBaseName() === "module.ts"), uniqueBy((sourceFile) => sourceFile.getFilePath()), map((sourceFile) => getVariableDeclarationByTypeName(sourceFile, "DocumentModel")), filter(isTruthy), map((variableDeclaration) => ({
+		name: variableDeclaration.getName(),
+		directory: variableDeclaration.getSourceFile().getDirectory()
+	})), map(({ name, directory }) => ({
+		name,
+		version: directory.getBaseName(),
+		documentModelDir: directory.getParentOrThrow().getBaseName()
+	})), filter(({ version }) => /^v\d+$/.test(version)), map(({ name, version, documentModelDir }) => ({
+		namedExports: [`${name} as ${name}${capitalize(version)}`],
+		moduleSpecifier: `./${documentModelDir}/${version}/module.js`
+	})), forEach(({ namedExports, moduleSpecifier }) => {
+		sourceFile.addExportDeclaration({
+			namedExports,
+			moduleSpecifier
+		});
+	}));
+	await formatSourceFileWithPrettier(sourceFile);
+}
+/** Writes a json file derived from a `documentModelState` */
+async function writeDocumentModelStateJsonFile({ documentModelState, documentModelDirName, documentModelDirPath }) {
+	await writeFile(join$1(documentModelDirPath, `${documentModelDirName}.json`), JSON.stringify(documentModelState, null, 2));
+}
+async function makeDocumentModelIndexFile(args) {
+	const { project, documentModelDirPath, latestVersion } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, join$1(documentModelDirPath, "index.ts"));
+	sourceFile.replaceWithText("");
+	sourceFile.addExportDeclarations([{ moduleSpecifier: `./v${latestVersion}/index.js` }, { moduleSpecifier: `./upgrades/index.js` }]);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function persistCustomFilesFromPreviousVersion(args) {
+	const { version, documentModelDirPath } = args;
+	const previousVersion = version - 1;
+	if (previousVersion <= 1) return;
+	const currentVersionDirName = `v${version}`;
+	const previousVersionDirName = `v${previousVersion}`;
+	if (currentVersionDirName === previousVersionDirName) return;
+	const previousVersionDirPath = join$1(documentModelDirPath, previousVersionDirName);
+	const currentVersionDirPath = join$1(documentModelDirPath, currentVersionDirName);
+	if (!await directoryExists(previousVersionDirPath)) return;
+	const previousVersionFiles = (await readdir(previousVersionDirPath, {
+		withFileTypes: true,
+		recursive: true
+	})).filter((dirEnt) => dirEnt.isFile()).map(({ name, parentPath }) => ({
+		name,
+		parentPath,
+		relativePath: relative(previousVersionDirPath, parentPath)
+	}));
+	for (const { name, relativePath } of previousVersionFiles) {
+		const filePathInCurrentVersionDir = join$1(currentVersionDirPath, relativePath, name);
+		const filePathInPreviousVersionDir = join$1(previousVersionDirPath, relativePath, name);
+		const existsInPreviousVersionDir = await fileExists(filePathInPreviousVersionDir);
+		const existsInCurrentVersionDir = await fileExists(filePathInCurrentVersionDir);
+		if (existsInPreviousVersionDir && !existsInCurrentVersionDir) {
+			console.log(`Persisting file "${join$1(relativePath, name)}" from previous version directory.`);
+			await mkdir(join$1(currentVersionDirPath, relativePath), { recursive: true });
+			await copyFile(filePathInPreviousVersionDir, filePathInCurrentVersionDir);
+		}
+	}
+}
+//#endregion
+//#region src/file-builders/document-model/utils.ts
+function operationHasInput(operation) {
+	return isNonNullish(operation.schema);
+}
+function operationHasEmptyInput(operation) {
+	return operation.schema?.includes("_empty") && !operation.schema.replace(/_empty:\s*Boolean/, "").match(/\w+:\s*\w+/);
+}
+function operationHasAttachment(operation) {
+	return operation.schema?.includes(": Attachment");
+}
+//#endregion
+//#region src/file-builders/index-files.ts
+/**
+* Makes a index.ts file for the modules file which exports the modules as individual exports instead of an array of named exports.
+*/
+function makeModulesIndexFile({ project, modulesDirPath, modules }) {
+	const indexSourceFilePath = path$1.join(modulesDirPath, "index.ts");
+	let indexSourceFile = project.getSourceFile(indexSourceFilePath);
+	if (!indexSourceFile) indexSourceFile = project.createSourceFile(indexSourceFilePath, "");
+	else indexSourceFile.replaceWithText("");
+	indexSourceFile.addExportDeclarations(modules.map(({ versionedName, unversionedName, moduleSpecifier }) => ({
+		namedExports: [versionedName ? `${unversionedName} as ${versionedName}` : unversionedName],
+		moduleSpecifier
+	})));
+}
+//#endregion
+//#region src/file-builders/manifest.ts
+async function getOrCreateManifestFile(manifestPath) {
+	if (!await fileExists(manifestPath)) await writeJsonFile(manifestPath, defaultManifest);
+	const manifestFile = await loadJsonFile(manifestPath);
+	return ManifestSchema.parse(manifestFile);
+}
+function makeUpdatedModulesList(oldModules = [], newModules = []) {
+	return pipe(concat(oldModules, newModules), uniqueBy(prop("id")));
+}
+function makeUpdatedConfig(oldConfig = [], newConfig = []) {
+	return pipe(oldConfig, filter(({ name }) => !isIncludedIn(name, map(newConfig, prop("name")))), concat(newConfig), uniqueBy(prop("name")));
+}
+async function createOrUpdateManifest(manifestData, projectDir) {
+	const manifestPath = join(projectDir, "powerhouse.manifest.json");
+	const existingManifest = await getOrCreateManifestFile(manifestPath);
+	const updatedManifest = {
+		...existingManifest,
+		...manifestData,
+		publisher: merge(existingManifest.publisher, manifestData.publisher),
+		documentModels: makeUpdatedModulesList(existingManifest.documentModels, manifestData.documentModels),
+		editors: makeUpdatedModulesList(existingManifest.editors, manifestData.editors),
+		apps: makeUpdatedModulesList(existingManifest.apps, manifestData.apps),
+		processors: makeUpdatedModulesList(existingManifest.processors, manifestData.processors),
+		subgraphs: makeUpdatedModulesList(existingManifest.subgraphs, manifestData.subgraphs),
+		config: makeUpdatedConfig(existingManifest.config, manifestData.config)
+	};
+	await writeJsonFile(manifestPath, updatedManifest);
+	return updatedManifest;
+}
+//#endregion
+//#region src/file-builders/package-json.ts
+function makePackageJsonExports() {
+	const standardExportPaths = fromEntries(flatMap(exportPaths, (p) => makePackageJsonExport(p)));
+	return {
+		...rootExportPaths,
+		...standardExportPaths,
+		...nonStandardExportPaths
+	};
+}
+function makePackageJsonExport(exportPath) {
+	return [[`./${exportPath}`, {
+		types: `./${exportPath}/dist/index.d.ts`,
+		browser: `./${exportPath}/dist/browser/index.js`,
+		node: `./${exportPath}/dist/node/index.mjs`
+	}], [`./${exportPath}/*`, {
+		types: `./${exportPath}/dist/*/index.d.ts`,
+		browser: `./${exportPath}/dist/browser/*/index.js`,
+		node: `./${exportPath}/dist/node/*/index.mjs`
+	}]];
+}
+//#endregion
+//#region src/file-builders/processors/analytics.ts
+async function tsMorphGenerateAnalyticsProcessor(args) {
+	const { project, documentTypes, pascalCaseName, dirPath, camelCaseName } = args;
+	await makeIndexFile$1({
+		project,
+		pascalCaseName,
+		dirPath
+	});
+	await makeProcessorFile$1({
+		project,
+		pascalCaseName,
+		dirPath
+	});
+	await makeFactoryFile$1({
+		project,
+		pascalCaseName,
+		camelCaseName,
+		dirPath,
+		documentTypes
+	});
+}
+async function makeIndexFile$1(v) {
+	const template = analyticsIndexTemplate;
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "index.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeProcessorFile$1(v) {
+	const template = analyticsProcessorTemplate(v);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "processor.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeFactoryFile$1(v) {
+	const template = analyticsFactoryTemplate(v);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "factory.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/processors/relational-db.ts
+async function tsMorphGenerateRelationalDbProcessor(args) {
+	const { project, documentTypes, camelCaseName, pascalCaseName, dirPath } = args;
+	await makeIndexFile({
+		project,
+		pascalCaseName,
+		dirPath
+	});
+	await makeProcessorFile({
+		project,
+		pascalCaseName,
+		dirPath
+	});
+	await makeFactoryFile({
+		project,
+		pascalCaseName,
+		camelCaseName,
+		dirPath,
+		documentTypes
+	});
+	await makeMigrationsFile({
+		project,
+		dirPath
+	});
+	await makeSchemaFile({
+		project,
+		dirPath
+	});
+}
+async function makeIndexFile(v) {
+	const template = relationalDbIndexTemplate;
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "index.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeProcessorFile(v) {
+	const template = relationalDbProcessorTemplate(v);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "processor.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeFactoryFile(v) {
+	const template = relationalDbFactoryTemplate(v);
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "factory.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeSchemaFile(v) {
+	const template = relationalDbSchemaTemplate();
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "schema.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeMigrationsFile(v) {
+	const template = relationalDbMigrationsTemplate();
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(v.project, path.join(v.dirPath, "migrations.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(template);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+//#endregion
+//#region src/file-builders/processors/processor.ts
+async function tsMorphGenerateProcessor(args) {
+	const { project, processorName, documentTypes, processorType, processorApps } = args;
+	const kebabCaseName = kebabCase(processorName);
+	const camelCaseName = camelCase(processorName);
+	const pascalCaseName = pascalCase(processorName);
+	const { directory: processorsDir } = getOrCreateDirectory(project, "processors");
+	const projectDir = processorsDir.getParentOrThrow().getPath();
+	const processorsDirPath = processorsDir.getPath();
+	const dirPath = path.join(processorsDirPath, kebabCaseName);
+	await ensureDirectoriesExist(project, processorsDirPath, dirPath);
+	if (processorType === "analytics") await tsMorphGenerateAnalyticsProcessor({
+		processorName,
+		documentTypes,
+		camelCaseName,
+		dirPath,
+		kebabCaseName,
+		pascalCaseName,
+		processorsDirPath,
+		project
+	});
+	else await tsMorphGenerateRelationalDbProcessor({
+		processorName,
+		documentTypes,
+		camelCaseName,
+		dirPath,
+		kebabCaseName,
+		pascalCaseName,
+		processorsDirPath,
+		project
+	});
+	for (const processorApp of processorApps) await updateFactoryBuildersFile({
+		processorsDirPath,
+		processorApp,
+		project,
+		camelCaseName,
+		kebabCaseName
+	});
+	await createOrUpdateManifest({ processors: [{
+		name: processorName,
+		id: kebabCaseName
+	}] }, projectDir);
+}
+async function updateFactoryBuildersFile(v) {
+	const { project, processorsDirPath, processorApp, camelCaseName, kebabCaseName } = v;
+	const template = factoryBuildersTemplate;
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(processorsDirPath, `${processorApp}.ts`));
+	if (!alreadyExists) sourceFile.replaceWithText(template);
+	const name = `${camelCaseName}FactoryBuilder`;
+	const moduleSpecifier = path.join("processors", kebabCaseName);
+	const factoriesArrayName = "processorFactoryBuilders";
+	let factoryBuildersArray = getFactoryBuildersArray(sourceFile, factoriesArrayName);
+	if (!factoryBuildersArray) {
+		sourceFile.replaceWithText(template);
+		factoryBuildersArray = getFactoryBuildersArray(sourceFile, factoriesArrayName);
+	}
+	if (!factoryBuildersArray) throw new Error(`Could not get factory builders array in file ${processorApp}.ts`);
+	if (!sourceFile.getImportDeclarations().flatMap((importDeclaration) => importDeclaration.getNamedImports().map((n) => n.getText())).find((n) => n === name)) sourceFile.addImportDeclaration({
+		namedImports: [name],
+		moduleSpecifier
+	});
+	if (!factoryBuildersArray.getElements().map((e) => e.getText()).includes(name)) factoryBuildersArray.addElement(name);
+	await formatSourceFileWithPrettier(sourceFile);
+}
+function getFactoryBuildersArray(sourceFile, name) {
+	return sourceFile.getDescendantsOfKind(ts.SyntaxKind.VariableStatement).flatMap((d) => d.getDescendantsOfKind(ts.SyntaxKind.VariableDeclaration)).find((d) => d.getName() === name)?.getDescendantsOfKind(ts.SyntaxKind.ArrayLiteralExpression).at(0);
+}
+//#endregion
+//#region src/file-builders/subgraphs.ts
+async function tsMorphGenerateSubgraph(args) {
+	const { subgraphName, project } = args;
+	const kebabCaseName = kebabCase(subgraphName);
+	const pascalCaseName = pascalCase(subgraphName);
+	const camelCaseName = camelCase(subgraphName);
+	const { directory: subgraphsDir } = getOrCreateDirectory(project, "subgraphs");
+	const subgraphsDirPath = subgraphsDir.getPath();
+	const projectDir = subgraphsDir.getParentOrThrow().getPath();
+	const subgraphDir = path.join(subgraphsDirPath, kebabCaseName);
+	await ensureDirectoriesExist(project, subgraphsDirPath, subgraphDir);
+	await makeBaseSubgraphIndexFile(project, subgraphDir, {
+		pascalCaseName,
+		kebabCaseName
+	});
+	await makeBaseSubgraphLibFile(project, subgraphDir);
+	await makeCustomSubgraphFiles(project, subgraphDir, {
+		pascalCaseName,
+		camelCaseName
+	});
+	await makeSubgraphsIndexFile({
+		project,
+		subgraphsDir: subgraphsDirPath
+	});
+	await createOrUpdateManifest({ subgraphs: [{
+		name: subgraphName,
+		id: kebabCaseName
+	}] }, projectDir);
+}
+async function makeBaseSubgraphIndexFile(project, dirPath, v) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(dirPath, "index.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(subgraphIndexFileTemplate(v));
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeBaseSubgraphLibFile(project, dirPath) {
+	const { alreadyExists, sourceFile } = getOrCreateSourceFile(project, path.join(dirPath, "lib.ts"));
+	if (alreadyExists) return;
+	sourceFile.replaceWithText(subgraphLibFileTemplate());
+	await formatSourceFileWithPrettier(sourceFile);
+}
+async function makeCustomSubgraphFiles(project, dirPath, v) {
+	const schema = getOrCreateSourceFile(project, path.join(dirPath, "schema.ts"));
+	if (!schema.alreadyExists) schema.sourceFile.replaceWithText(customSubgraphSchemaTemplate(v));
+	const resolvers = getOrCreateSourceFile(project, path.join(dirPath, "resolvers.ts"));
+	if (!resolvers.alreadyExists) {
+		resolvers.sourceFile.replaceWithText(customSubgraphResolversTemplate(v));
+		await formatSourceFileWithPrettier(resolvers.sourceFile);
+	}
 }
-function camel(name) {
-	const p = pascal(name);
-	return p.charAt(0).toLowerCase() + p.slice(1);
+async function makeSubgraphsIndexFile(args) {
+	const { project, subgraphsDir } = args;
+	const { sourceFile } = getOrCreateSourceFile(project, path.join(subgraphsDir, "index.ts"));
+	const existingExportNames = pipe(sourceFile.getExportDeclarations(), map((exportDeclaration) => exportDeclaration.getNamespaceExport()?.getName()), filter(isTruthy));
+	const exportDeclarations = pipe(project.getDirectoryOrThrow(subgraphsDir).getDescendantSourceFiles(), filter((sourceFile) => sourceFile.getBaseName() === "index.ts"), uniqueBy((sourceFile) => sourceFile.getFilePath()), map((sourceFile) => sourceFile.getClasses().find((c) => c.getBaseClass()?.getText().includes("BaseSubgraph"))), filter(isTruthy), map((classDeclaration) => ({
+		name: classDeclaration.getNameOrThrow(),
+		subgraphDir: classDeclaration.getSourceFile().getDirectory().getBaseName()
+	})), filter(({ name }) => !existingExportNames.includes(name)), map(({ name, subgraphDir }) => ({
+		namespaceExport: name,
+		moduleSpecifier: `./${subgraphDir}/index.js`
+	})));
+	sourceFile.addExportDeclarations(exportDeclarations);
+	await formatSourceFileWithPrettier(sourceFile);
 }
 //#endregion
-export { tsConfigTemplate as $, documentModelHooksFileTemplate as A, claudeSettingsLocalTemplate as At, getModuleExportType as B, appDriveContentsFileTemplate as Bt, makeActionsImports as C, documentModelsIndexTemplate as Ct, documentModelSrcIndexFileTemplate as D, dockerfileTemplate as Dt, documentModelSrcUtilsTemplate as E, nginxConfTemplate as Et, documentModelPhFactoriesFileTemplate as F, folderTreeFileTemplate as Ft, documentModelGenControllerFileTemplate as G, documentModelDocumentTypeTemplate as H, ts as Ht, documentModelOperationsModuleOperationsFileTemplate as I, appFoldersFileTemplate as It, documentEditorModuleFileTemplate as J, documentModelGenActionsFileTemplate as K, documentModelOperationsModuleErrorFileTemplate as L, appFilesFileTemplate as Lt, documentModelGenTypesTemplate as M, appEditorFileTemplate as Mt, documentModelSchemaIndexTemplate as N, appConfigFileTemplate as Nt, documentModelModuleFileTemplate as O, connectEntrypointTemplate as Ot, documentModelGenReducerFileTemplate as P, driveExplorerNavigationBreadcrumbsFileTemplate as Pt, viteConfigTemplate as Q, documentModelOperationsModuleCreatorsFileTemplate as R, emptyStateFileTemplate as Rt, makeActionImportNames as S, editorsTemplate as St, documentModelTestFileTemplate as T, switchboardEntrypointTemplate as Tt, documentModelDocumentSchemaFileTemplate as U, documentModelGenIndexFileTemplate as V, createDocumentFileTemplate as Vt, documentModelGenCreatorsFileTemplate as W, docsFromCliHelpTemplate as X, documentEditorEditorFileTemplate as Y, vitestConfigTemplate as Z, analyticsFactoryTemplate as _, gitIgnoreTemplate as _t, subgraphLibFileTemplate as a, buildPowerhouseConfigTemplate as at, upgradeManifestTemplate as b, eslintConfigTemplate as bt, relationalDbProcessorTemplate as c, exportsTemplate as ct, relationalDbFactoryTemplate as d, mcpTemplate as dt, tsconfigPathsTemplate as et, processorsIndexTemplate as f, mainTsxTemplate as ft, analyticsIndexTemplate as g, indexHtmlTemplate as gt, analyticsProcessorTemplate as h, legacyIndexHtmlTemplate as ht, customSubgraphSchemaTemplate as i, ManifestTemplate as it, documentModelGenUtilsTemplate as j, agentsTemplate as jt, documentModelIndexTemplate as k, cursorMcpTemplate as kt, relationalDbMigrationsTemplate as l, packageJsonTemplate as lt, factoryBuildersTemplate as m, indexTsTemplate as mt, documentModelSubgraphSchemaTemplate as n, styleTemplate as nt, subgraphIndexFileTemplate as o, packageJsonExportsTemplate as ot, processorsFactoryTemplate as p, licenseTemplate as pt, documentModelRootActionsFileTemplate as q, customSubgraphResolversTemplate as r, readmeTemplate as rt, relationalDbSchemaTemplate as s, packageJsonScriptsTemplate as st, documentModelSubgraphResolversTemplate as t, subgraphsIndexTemplate as tt, relationalDbIndexTemplate as u, npmrcTemplate as ut, documentModelUtilsTemplate as v, syncAndPublishWorkflowTemplate as vt, makeTestCaseForAction as w, documentModelsTemplate as wt, documentModelOperationsModuleTestFileTemplate as x, editorsIndexTemplate as xt, upgradeTransitionTemplate as y, geminiSettingsTemplate as yt, documentModelOperationModuleActionsFileTemplate as z, driveExplorerFileTemplate as zt };
+export { ensureDirectoriesExist as $, folderTreeFileTemplate as $n, getLatestDocumentModelSpec as $t, writeAllGeneratedProjectFiles as A, licenseTemplate as An, makeOperationImportNames as At, makeEditorModuleFile as B, upgradeManifestsTemplate as Bn, documentModelGenTypesTemplate as Bt, rootExportPaths as C, packageJsonExportsTemplate as Cn, analyticsProcessorTemplate as Ct, writeCliDocsMarkdownFile as D, npmrcTemplate as Dn, upgradeTransitionTemplate as Dt, makeCliDocsFromHelp as E, packageJsonTemplate as En, documentModelUtilsTemplate as Et, writeGeneratedProjectRootFiles as F, syncAndPublishWorkflowTemplate as Fn, documentModelSrcIndexFileTemplate as Ft, DEFAULT_PROJECT_OPTIONS as G, dockerfileTemplate as Gn, documentModelOperationsModuleErrorFileTemplate as Gt, makeEditorsIndexFile as H, documentModelsTemplate as Hn, documentModelGenReducerFileTemplate as Ht, writeGeneratedSubgraphsFiles as I, geminiSettingsTemplate as In, documentModelModuleFileTemplate as It, getObjectLiteral as J, claudeSettingsLocalTemplate as Jn, getModuleExportType as Jt, buildTsMorphProject as K, connectEntrypointTemplate as Kn, documentModelOperationsModuleCreatorsFileTemplate as Kt, writeModuleFiles as L, eslintConfigTemplate as Ln, documentModelIndexTemplate as Lt, writeGeneratedDocumentModelsFiles as M, legacyIndexHtmlTemplate as Mn, makeTestCaseForOperation as Mt, writeGeneratedEditorsFiles as N, indexHtmlTemplate as Nn, documentModelTestFileTemplate as Nt, buildBoilerplatePackageJson as O, mcpTemplate as On, upgradeManifestTemplate as Ot, writeGeneratedProcessorsFiles as P, gitIgnoreTemplate as Pn, documentModelSrcUtilsTemplate as Pt, buildStringLiteral as Q, driveExplorerNavigationBreadcrumbsFileTemplate as Qn, getEditorVariableNames as Qt, writeProjectRootFiles as R, editorsIndexTemplate as Rn, documentModelHooksFileTemplate as Rt, packageScripts as S, buildPowerhouseConfigTemplate as Sn, factoryBuildersTemplate as St, getCommandsHelpInfo as T, exportsTemplate as Tn, analyticsFactoryTemplate as Tt, validateDocumentModelState as U, switchboardEntrypointTemplate as Un, documentModelPhFactoriesFileTemplate as Ut, makeEditorsFile as V, documentModelsIndexTemplate as Vn, documentModelSchemaIndexTemplate as Vt, getInitialStates as W, nginxConfTemplate as Wn, documentModelOperationsModuleOperationsFileTemplate as Wt, getVariableDeclarationByTypeName as X, appEditorFileTemplate as Xn, getDocumentModelSpecByVersionNumber as Xt, getObjectProperty as Y, agentsTemplate as Yn, getDocumentModelDirName as Yt, buildObjectLiteral as Z, appConfigFileTemplate as Zn, getDocumentModelVariableNames as Zt, defaultManifest as _, tsconfigPathsTemplate as _n, relationalDbMigrationsTemplate as _t, createOrUpdateManifest as a, documentModelGenIndexFileTemplate as an, createDocumentFileTemplate as ar, runPrettier as at, externalDevDependencies as b, readmeTemplate as bn, processorsIndexTemplate as bt, operationHasAttachment as c, documentModelGenCreatorsFileTemplate as cn, configSpec as ct, tsMorphGenerateDocumentModel as d, documentModelRootActionsFileTemplate as dn, customSubgraphResolversTemplate as dt, getLatestDocumentModelSpecVersionNumber as en, appFoldersFileTemplate as er, getOrCreateDirectory as et, generateDocumentModelZodSchemas as f, documentEditorModuleFileTemplate as fn, customSubgraphSchemaTemplate as ft, tsMorphGenerateDocumentEditor as g, tsConfigTemplate as gn, relationalDbProcessorTemplate as gt, scalarsValidation as h, vitestConfigTemplate as hn, relationalDbSchemaTemplate as ht, makePackageJsonExports as i, getActionTypeName as in, appDriveContentsFileTemplate as ir, formatSourceFileWithPrettier as it, writeCIFiles as j, indexTsTemplate as jn, makeOperationsImports as jt, writeAiConfigFiles as k, mainTsxTemplate as kn, documentModelOperationsModuleTestFileTemplate as kt, operationHasEmptyInput as l, documentModelGenControllerFileTemplate as ln, parseArgs as lt, scalars as m, docsFromCliHelpTemplate as mn, subgraphIndexFileTemplate as mt, tsMorphGenerateSubgraph as n, getActionInputTypeNames as nn, emptyStateFileTemplate as nr, getPreviousVersionSourceFile as nt, getOrCreateManifestFile as o, documentModelDocumentTypeTemplate as on, getDocumentTypeMetadata as ot, generateTypesAndZodSchemasFromGraphql as p, documentEditorEditorFileTemplate as pn, subgraphLibFileTemplate as pt, getDefaultProjectOptions as q, cursorMcpTemplate as qn, documentModelOperationModuleActionsFileTemplate as qt, tsMorphGenerateProcessor as r, getActionType as rn, driveExplorerFileTemplate as rr, formatSafe as rt, makeModulesIndexFile as s, documentModelDocumentSchemaFileTemplate as sn, documentModelDocumentTypeMetadata as st, makeSubgraphsIndexFile as t, getActionInputName as tn, appFilesFileTemplate as tr, getOrCreateSourceFile as tt, operationHasInput as u, documentModelGenActionsFileTemplate as un, parseConfig as ut, exportPaths as v, subgraphsIndexTemplate as vn, relationalDbIndexTemplate as vt, getCommandHelpInfo as w, packageJsonScriptsTemplate as wn, analyticsIndexTemplate as wt, nonStandardExportPaths as x, ManifestTemplate as xn, processorsFactoryTemplate as xt, externalDependencies as y, styleTemplate as yn, relationalDbFactoryTemplate as yt, tsMorphGenerateApp as z, editorsTemplate as zn, documentModelGenUtilsTemplate as zt };
 
-//# sourceMappingURL=templates-BbNsigQX.mjs.map
+//# sourceMappingURL=file-builders-BkbVW0kT.mjs.map