@powerhousedao/ph-cli 6.0.2-staging.9 → 6.1.0-staging.0

package/README.md

@@ -97,51 +97,53 @@ ph connect --config-file ./my-config.js
 
 ### `ph generate`
 
-Generate code from document models with various options. This command supports multiple generation types including editors, processors, subgraphs, and import scripts.
+`ph generate` is a router; pass a subcommand to generate a specific
+module type. See `ph generate <subcommand> --help` for the full option
+list per subcommand.
 
-#### Options:
+#### Subcommands:
+
+- `document-model` (alias `doc`) — generate from a `.phd`/`.json` spec
+- `editor` — generate a document editor
+- `app` — generate a drive app
+- `processor` — generate a reactor processor
+- `subgraph` — generate a GraphQL subgraph
+- `migration-file` — generate migrations for a relational-db processor
+- `all` — re-generate every module in the project
+
+Most subcommands share these options:
 
-- `-i, --interactive`: Run the command in interactive mode
-- `--editors <type>`: Path to the editors directory
-- `-e, --editor <type>`: Editor Name
-- `--file <path>`: File path to document model
-- `--processors <type>`: Path to the processors directory
-- `-p, --processor <type>`: Processor Name
-- `--processor-type <type>`: Processor Type (relationalDb/analytics)
-- `-s, --subgraph <type>`: Subgraph Name
-- `--document-models <type>`: Path to the document models directory
-- `--document-types <type>`: Supported document types by the editor
-- `-is, --import-script <type>`: Import Script Name
-- `-sf, --skip-format`: Skip formatting the generated code
-- `-w, --watch`: Watch the generated code
-- `-d, --drive-editor <name>`: Generate a drive editor with the specified name
+- `-d, --document <path>`: Path to a document-model spec (`.phd` or `.json`)
+- `--dir <dir>`: Existing module directory to re-generate
+- `-a, --all`: Re-generate every existing module of this type
+- `-x, --extract`: (document-model only) Write a `powerhouse/document-model` spec for each existing model into `specs/document-models/`
 
 #### Examples:
 
 ```bash
-# Generate code from a specific file
-ph generate path/to/model.json
+# Generate a document model from a spec file
+ph generate document-model --document path/to/model.phd
 
-# Generate in interactive mode
-ph generate -i
+# Re-generate all existing document models in the project
+ph generate document-model --all
 
-# Generate a drive editor
-ph generate --drive-editor myEditor
+# Generate an editor for a given document type
+ph generate editor --name myEditor --document-type powerhouse/todo
 
-# Generate an editor with specific document types
-ph generate --editor myEditor --document-types "type1,type2"
+# Generate a drive app
+ph generate app --name myApp
 
 # Generate a processor
-ph generate --processor myProcessor --processor-type relationalDb
+ph generate processor --name myProcessor --processor-type relationalDb
 
 # Generate a subgraph
-ph generate --subgraph mySubgraph --file path/to/model.json
+ph generate subgraph --name mySubgraph
 
-# Generate an import script
-ph generate --import-script myImportScript
+# Generate migration files for a relational-db processor
+ph generate migration-file --processor myProcessor
 
-# Watch mode for continuous generation
-ph generate --watch
+# Re-generate everything in the project
+ph generate all
 ```
 
 ### `ph install` (or `ph add`, `ph i`)

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="91bfc73b-b8bb-5fb3-9600-c96d09217bb4")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a2e67adb-542b-5e92-bbfc-4656437ba4d7")}catch(e){}}();
 import { initCliTelemetry } from "@powerhousedao/shared/clis/telemetry";
 import { assertNodeVersion } from "@powerhousedao/shared/clis/utils";
 import { array, boolean, command, flag, multioption, oneOf, option, optional, run, string, subcommands } from "cmd-ts";
@@ -12,9 +12,10 @@ import { PROCESSOR_APPS } from "@powerhousedao/shared/processors";
 import { execSync } from "child_process";
 import { execSync as execSync$1 } from "node:child_process";
 import { createInterface } from "node:readline/promises";
+import { bold, yellow } from "colorette";
 //#region src/get-version.ts
 function getVersion() {
-	return "6.0.2-staging.9";
+	return "6.1.0-staging.0";
 }
 //#endregion
 //#region src/utils/constants.ts
@@ -167,10 +168,14 @@ NOTE: You must run \`ph connect build\` first
 const generateAllCmd = command({
 	name: "all",
 	description: "Re-generate all modules in the current project",
-	args: {},
-	handler: async () => {
-		const { startGenerateAll } = await import("./generate-all-Cj8zjFhN.mjs");
-		await startGenerateAll(process.cwd());
+	args: { extract: flag({
+		long: "extract",
+		short: "x",
+		description: "Instead of generating code, write a spec for every module into specs/ (one-shot migration to documents-as-source-of-truth)"
+	}) },
+	handler: async (args) => {
+		const { startGenerateAll } = await import("./generate-all-WiQQo-Nz.mjs");
+		await startGenerateAll(args, process.cwd());
 		process.exit(0);
 	}
 });
@@ -192,10 +197,15 @@ const generateAppCmd = command({
 			short: "t",
 			description: "The document types allowed by the new app"
 		}),
+		document: option({
+			type: optional(File),
+			long: "document",
+			short: "d",
+			description: "Path to a powerhouse/app spec file (.phd or .json) to drive codegen"
+		}),
 		dir: option({
 			type: optional(Directory),
 			long: "dir",
-			short: "d",
 			description: "Name of the directory of an existing app to re-generate"
 		}),
 		disableDragAndDrop: flag({
@@ -210,10 +220,15 @@ const generateAppCmd = command({
 			short: "a",
 			description: "Re-generate all existing apps in the current project"
 		}),
+		extract: flag({
+			long: "extract",
+			short: "x",
+			description: "Write a powerhouse/app spec for each existing drive app into specs/apps/"
+		}),
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateApp } = await import("./generate-app-KE0rbE-b.mjs");
+		const { startGenerateApp } = await import("./generate-app-DdmOt6ID.mjs");
 		await startGenerateApp(args, process.cwd());
 		process.exit(0);
 	}
@@ -225,16 +240,15 @@ const generateDocumentModelCmd = command({
 	aliases: ["doc"],
 	description: "Generate a document model",
 	args: {
-		file: option({
+		document: option({
 			type: optional(File),
-			long: "file",
-			short: "f",
-			description: "Path to the file to generate the document model from"
+			long: "document",
+			short: "d",
+			description: "Path to a document model spec (.phd or .json) to generate from"
 		}),
 		dir: option({
 			type: optional(Directory),
 			long: "dir",
-			short: "d",
 			description: "Name of the directory of an existing document model to re-generate"
 		}),
 		all: flag({
@@ -242,10 +256,15 @@ const generateDocumentModelCmd = command({
 			short: "a",
 			description: "Re-generate all existing document models in the current project"
 		}),
+		extract: flag({
+			long: "extract",
+			short: "x",
+			description: "Write a powerhouse/document-model spec for each existing document model into specs/document-models/"
+		}),
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateDocumentModel } = await import("./generate-document-model-Cut44i6D.mjs");
+		const { startGenerateDocumentModel } = await import("./generate-document-model-DQ5PVeIH.mjs");
 		await startGenerateDocumentModel(args, process.cwd());
 		process.exit(0);
 	}
@@ -268,10 +287,15 @@ const generateEditorCmd = command({
 			short: "t",
 			description: "The document type for the new editor"
 		}),
+		document: option({
+			type: optional(File),
+			long: "document",
+			short: "d",
+			description: "Path to a powerhouse/document-editor spec file (.phd or .json) to drive codegen"
+		}),
 		dir: option({
 			type: optional(Directory),
 			long: "dir",
-			short: "d",
 			description: "Name of the directory of an existing editor to re-generate"
 		}),
 		all: flag({
@@ -279,10 +303,15 @@ const generateEditorCmd = command({
 			short: "a",
 			description: "Re-generate all existing editors in the current project"
 		}),
+		extract: flag({
+			long: "extract",
+			short: "x",
+			description: "Write a powerhouse/document-editor spec for each existing editor into specs/editors/"
+		}),
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateEditor } = await import("./generate-editor-DmSzWm3W.mjs");
+		const { startGenerateEditor } = await import("./generate-editor-DtzVAs6x.mjs");
 		await startGenerateEditor(args, process.cwd());
 		process.exit(0);
 	}
@@ -353,10 +382,15 @@ const generateProcessorCmd = command({
 			defaultValue: () => ["switchboard", "connect"],
 			defaultValueIsSerializable: true
 		}),
+		document: option({
+			type: optional(File),
+			long: "document",
+			short: "d",
+			description: "Path to a powerhouse/processor spec file (.phd or .json) to drive codegen"
+		}),
 		dir: option({
 			type: optional(Directory),
 			long: "dir",
-			short: "d",
 			description: "Name of the directory of an existing processor to re-generate"
 		}),
 		all: flag({
@@ -364,10 +398,15 @@ const generateProcessorCmd = command({
 			short: "a",
 			description: "Re-generate all existing processors in the current project"
 		}),
+		extract: flag({
+			long: "extract",
+			short: "x",
+			description: "Write a powerhouse/processor spec for each existing processor into specs/processors/"
+		}),
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateProcessor } = await import("./generate-processor-B-fChg4W.mjs");
+		const { startGenerateProcessor } = await import("./generate-processor-FGtN6BVY.mjs");
 		await startGenerateProcessor(args, process.cwd());
 		process.exit(0);
 	}
@@ -384,10 +423,15 @@ const generateSubgraphCmd = command({
 			short: "n",
 			description: "The name of the subgraph to generate"
 		}),
+		document: option({
+			type: optional(File),
+			long: "document",
+			short: "d",
+			description: "Path to a powerhouse/subgraph spec file (.phd or .json) to drive codegen"
+		}),
 		dir: option({
 			type: optional(Directory),
 			long: "dir",
-			short: "d",
 			description: "Name of the directory of an existing subgraph to re-generate"
 		}),
 		all: flag({
@@ -395,10 +439,15 @@ const generateSubgraphCmd = command({
 			short: "a",
 			description: "Re-generate all existing subgraphs in the current project"
 		}),
+		extract: flag({
+			long: "extract",
+			short: "x",
+			description: "Write a powerhouse/subgraph spec for each existing subgraph into specs/subgraphs/"
+		}),
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateSubgraph } = await import("./generate-subgraph-C6dWIQzP.mjs");
+		const { startGenerateSubgraph } = await import("./generate-subgraph-BrzmW_sj.mjs");
 		await startGenerateSubgraph(args, process.cwd());
 		process.exit(0);
 	}
@@ -878,8 +927,16 @@ This command:
 	args: switchboardArgs,
 	handler: async (args) => {
 		if (args.debug) console.log(args);
-		const { basePath, dbPath, migrate, migrateStatus } = args;
+		const { basePath, dbPath, migrate, migrateStatus, reset, yes } = args;
 		if (basePath) process.env.BASE_PATH = basePath;
+		if (reset) {
+			const { resetSwitchboardDatabase } = await import("./switchboard-reset-1YcJEVqc.mjs");
+			await resetSwitchboardDatabase({
+				dbPath,
+				yes
+			});
+			process.exit(0);
+		}
 		if (migrate || migrateStatus) {
 			const { runSwitchboardMigrations } = await import("./switchboard-migrate-BumRp7rC.mjs");
 			await runSwitchboardMigrations({
@@ -888,7 +945,7 @@ This command:
 			});
 			process.exit(0);
 		}
-		const { startSwitchboard } = await import("./switchboard-GTBlxiJZ.mjs");
+		const { startSwitchboard } = await import("./switchboard-ChH1PMaE.mjs");
 		const { defaultDriveUrl, renown } = await startSwitchboard(args);
 		console.log("   ➜  Switchboard:", defaultDriveUrl);
 		if (renown) console.log("   ➜  Identity:", renown.did);
@@ -1065,7 +1122,7 @@ This command:
 		args: vetraArgs,
 		handler: async (args) => {
 			if (args.debug) console.log(args);
-			const { startVetra } = await import("./vetra-BUcRFup0.mjs");
+			const { startVetra } = await import("./vetra-yCsUKy_u.mjs");
 			await startVetra(args);
 		}
 	}),
@@ -1091,6 +1148,48 @@ const phCli = subcommands({
 	cmds: phCliCommands
 });
 //#endregion
+//#region src/utils/db-error-hint.ts
+const UNRECOVERABLE_DB_PATTERNS = [
+	/Database migration failed:/i,
+	/Migration .* failed/i,
+	/relation "[^"]+" already exists/i,
+	/column "[^"]+" does not exist/i,
+	/schema "reactor" does not exist/i,
+	/Unsupported PGLite data dir/i,
+	/PG_VERSION/i
+];
+function collectMessages(err) {
+	const messages = [];
+	let current = err;
+	const seen = /* @__PURE__ */ new Set();
+	while (current && !seen.has(current)) {
+		seen.add(current);
+		if (current instanceof Error) {
+			messages.push(current.message);
+			current = current.cause;
+		} else {
+			messages.push(String(current));
+			break;
+		}
+	}
+	return messages;
+}
+function isUnrecoverableDbError(err) {
+	return collectMessages(err).some((msg) => UNRECOVERABLE_DB_PATTERNS.some((re) => re.test(msg)));
+}
+function printDbRecoveryHint(err) {
+	const offending = collectMessages(err).find((msg) => UNRECOVERABLE_DB_PATTERNS.some((re) => re.test(msg)));
+	console.error("");
+	console.error(yellow(bold("Switchboard hit an unrecoverable database error.")));
+	if (offending) console.error(yellow(`  ${offending}`));
+	console.error("");
+	console.error(yellow("If this is a local PGlite store, you can reset it with:"));
+	console.error(yellow("  ph switchboard --reset"));
+	console.error(yellow("This is destructive: it wipes the local .ph/reactor-storage and .ph/read-storage directories."));
+	console.error(yellow("For Postgres-backed deployments (PH_REACTOR_DATABASE_URL / DATABASE_URL), reset the database manually instead."));
+	console.error("");
+}
+//#endregion
 //#region src/cli.ts
 let sentryClient = void 0;
 const COMMANDS_WITH_SUBCOMMANDS = new Set(["connect", "vetra"]);
@@ -1137,6 +1236,7 @@ await main().catch(async (error) => {
 	if (isDebug) throw error;
 	if (error instanceof Error) {
 		console.error(error.message);
+		if (isUnrecoverableDbError(error)) printDbRecoveryHint(error);
 		process.exit(1);
 	} else throw error;
 });
@@ -1144,4 +1244,4 @@ await main().catch(async (error) => {
 export {};
 
 //# sourceMappingURL=cli.mjs.map
-//# debugId=91bfc73b-b8bb-5fb3-9600-c96d09217bb4
+//# debugId=a2e67adb-542b-5e92-bbfc-4656437ba4d7