@powerhousedao/ph-cli 6.2.3-dev.3 → 6.2.3-dev.30

package/dist/cli.mjs

@@ -1,9 +1,9 @@
 #!/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]="ab6e0f84-63f5-57ba-a18e-7091ccbf13c6")}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]="3ab9cfff-6f9c-57a2-a989-3a29e9435207")}catch(e){}}();
 import { initCliTelemetry } from "@powerhousedao/shared/clis/telemetry";
 import { assertNodeVersion } from "@powerhousedao/shared/clis/utils";
-import { boolean, command, flag, multioption, oneOf, option, optional, run, string, subcommands } from "cmd-ts";
+import { boolean, command, flag, multioption, oneOf, option, optional, positional, run, string, subcommands } from "cmd-ts";
 import { AGENTS, accessTokenArgs, buildArgs, connectBuildArgs, connectConfigArgs, connectPreviewArgs, connectStudioArgs, debugArgs, initArgs, inspectArgs, installArgs, listArgs, loginArgs, migrateArgs, phCliHelpCommands, publishArgs, registryLoginArgs, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs } from "@powerhousedao/shared/clis/args";
 import { DEFAULT_EXPIRY_SECONDS } from "@powerhousedao/shared/clis/constants";
 import { Directory, File } from "cmd-ts/dist/cjs/batteries/fs.js";
@@ -15,15 +15,18 @@ import { createInterface } from "node:readline/promises";
 import { bold, yellow } from "colorette";
 //#region src/get-version.ts
 function getVersion() {
-	return "6.2.3-dev.3";
+	return "6.2.3-dev.30";
 }
 //#endregion
 //#region src/utils/constants.ts
 const PH_CLI_DESCRIPTION = "The Powerhouse CLI (ph-cli) is a command-line interface tool that provides essential commands for managing Powerhouse projects. The tool and it's commands are fundamental for creating, building, and running Document Models as a builder in studio mode.";
+//#endregion
+//#region src/commands/ph-cli-help.ts
+const version$1 = getVersion();
 const phCliHelp = subcommands({
 	name: "ph-cli",
 	description: PH_CLI_DESCRIPTION,
-	version: getVersion(),
+	version: version$1,
 	cmds: phCliHelpCommands
 });
 //#endregion
@@ -81,7 +84,7 @@ Notes:
 	handler: async (args) => {
 		if (args.debug) console.log(args);
 		const { generateAccessToken, parseExpiry, formatExpiry } = await import("@renown/sdk/node");
-		const { getRenown } = await import("./auth-BNkN6kS9.mjs");
+		const { getRenown } = await import("./auth-CNhbN5UM.mjs");
 		const renown = await getRenown();
 		let expiresIn = DEFAULT_EXPIRY_SECONDS;
 		if (args.expiry) expiresIn = parseExpiry(args.expiry);
@@ -101,11 +104,23 @@ Notes:
 //#region src/commands/build.ts
 const build$1 = command({
 	name: "build",
+	description: `
+Build a Powerhouse package for publishing: a browser bundle and a node bundle of its
+document models, editors, subgraphs and processors, type declarations, and its stylesheet.
+
+Pieces under pieces/ are built too, each into its own self-contained module under
+dist/node/pieces/<name>, with a descriptor.json and package.json written beside it and
+the piece listed in dist/powerhouse.manifest.json. A package that ships only pieces is an
+ordinary package: it carries the same boilerplate, and every step above runs for it too.
+
+tsc runs first. If it reports type errors the build asks whether to go ahead, and stops
+where it can't ask. --ignore-type-errors builds without asking; a package built that way
+can load and still fail at runtime, so don't publish it.`,
 	args: buildArgs,
 	handler: async (args) => {
 		if (args.debug) console.log(args);
 		try {
-			const { runBuild } = await import("./build-C-A5-ipO.mjs");
+			const { runBuild } = await import("./build-BolXfpNU.mjs");
 			await runBuild(args);
 		} catch (error) {
 			console.error(error);
@@ -113,13 +128,11 @@ const build$1 = command({
 		}
 	}
 });
-const connect = subcommands({
-	name: "connect",
-	description: `Powerhouse Connect commands. Use with \`studio\`, \`build\`, \`preview\`, or \`config\`. Defaults to \`studio\` if not specified.`,
-	cmds: {
-		studio: command({
-			name: "studio",
-			description: `The studio command starts the Connect Studio, a development environment for building
+//#endregion
+//#region src/commands/connect.ts
+const studio = command({
+	name: "studio",
+	description: `The studio command starts the Connect Studio, a development environment for building
 and testing Powerhouse applications. It provides a visual interface for working with
 your project.
 
@@ -129,16 +142,16 @@ This command:
 3. Allows you to interact with your project components
 4. Supports various configuration options for customization
 `,
-			args: connectStudioArgs,
-			handler: async (args) => {
-				if (args.debug) console.log(args);
-				const { runConnectStudio } = await import("./connect-studio-BIQzyq5B.mjs");
-				await runConnectStudio(args);
-			}
-		}),
-		build: command({
-			name: "build",
-			description: `The Connect build command creates a production build with the project's local and
+	args: connectStudioArgs,
+	handler: async (args) => {
+		if (args.debug) console.log(args);
+		const { runConnectStudio } = await import("./connect-studio-r_ikfhOR.mjs");
+		await runConnectStudio(args);
+	}
+});
+const build = command({
+	name: "build",
+	description: `The Connect build command creates a production build with the project's local and
 external packages included.
 
 Runtime-config overrides (all combinable — last wins on collision):
@@ -149,29 +162,29 @@ Runtime-config overrides (all combinable — last wins on collision):
 
 Build has no read mode; passing only <key> without <value> errors out (use \`ph connect config <key>\` to read).
 `,
-			args: connectBuildArgs,
-			handler: async (args) => {
-				if (args.debug) console.log(args);
-				const { runConnectBuild } = await import("./connect-build-WL4axo4z.mjs");
-				await runConnectBuild(args);
-				process.exit(0);
-			}
-		}),
-		preview: command({
-			name: "preview",
-			description: `The Connect preview command previews a built Connect project.
+	args: connectBuildArgs,
+	handler: async (args) => {
+		if (args.debug) console.log(args);
+		const { runConnectBuild } = await import("./connect-build-BVDpTJnS.mjs");
+		await runConnectBuild(args);
+		process.exit(0);
+	}
+});
+const preview = command({
+	name: "preview",
+	description: `The Connect preview command previews a built Connect project.
 NOTE: You must run \`ph connect build\` first
 `,
-			args: connectPreviewArgs,
-			handler: async (args) => {
-				if (args.debug) console.log(args);
-				const { runConnectPreview } = await import("./connect-preview-D7ypzFDc.mjs");
-				await runConnectPreview(args);
-			}
-		}),
-		config: command({
-			name: "config",
-			description: `Read or update Connect's runtime configuration (powerhouse.config.json).
+	args: connectPreviewArgs,
+	handler: async (args) => {
+		if (args.debug) console.log(args);
+		const { runConnectPreview } = await import("./connect-preview-CzDqR-JN.mjs");
+		await runConnectPreview(args);
+	}
+});
+const config = command({
+	name: "config",
+	description: `Read or update Connect's runtime configuration (powerhouse.config.json).
 
 Modes (mutually exclusive — positional, --get, --json, and field flags cannot be combined):
   ph connect config                       List the effective connect.* block (defaults < source).
@@ -185,12 +198,20 @@ Writes go to:
   - <project>/powerhouse.config.json (source — picked up by the next build)
   - <dist-dir>/powerhouse.config.json (if it exists — the currently-served SPA picks it up on refresh)
 `,
-			args: connectConfigArgs,
-			handler: async (args) => {
-				const { runConnectConfig } = await import("./connect-config-BWGiW3IB.mjs");
-				await runConnectConfig(args);
-			}
-		})
+	args: connectConfigArgs,
+	handler: async (args) => {
+		const { runConnectConfig } = await import("./connect-config-C70IXUh6.mjs");
+		await runConnectConfig(args);
+	}
+});
+const connect = subcommands({
+	name: "connect",
+	description: `Powerhouse Connect commands. Use with \`studio\`, \`build\`, \`preview\`, or \`config\`. Defaults to \`studio\` if not specified.`,
+	cmds: {
+		studio,
+		build,
+		preview,
+		config
 	}
 });
 //#endregion
@@ -204,7 +225,7 @@ const generateAllCmd = command({
 		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-DrT4ZxHX.mjs");
+		const { startGenerateAll } = await import("./generate-all-CIwP-3aa.mjs");
 		await startGenerateAll(args, process.cwd());
 		process.exit(0);
 	}
@@ -267,7 +288,7 @@ const generateAppCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateApp } = await import("./generate-app-DNNqA-H3.mjs");
+		const { startGenerateApp } = await import("./generate-app-BTs1u-9l.mjs");
 		await startGenerateApp(args, process.cwd());
 		process.exit(0);
 	}
@@ -303,7 +324,7 @@ const generateDocumentModelCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateDocumentModel } = await import("./generate-document-model-BJXyODfm.mjs");
+		const { startGenerateDocumentModel } = await import("./generate-document-model-DhDQ_06X.mjs");
 		await startGenerateDocumentModel(args, process.cwd());
 		process.exit(0);
 	}
@@ -350,7 +371,7 @@ const generateEditorCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateEditor } = await import("./generate-editor-BejvaVVT.mjs");
+		const { startGenerateEditor } = await import("./generate-editor-CW7Do69u.mjs");
 		await startGenerateEditor(args, process.cwd());
 		process.exit(0);
 	}
@@ -383,6 +404,136 @@ const generateMigrationFileCmd = command({
 		process.exit(0);
 	}
 });
+//#endregion
+//#region src/commands/generate-piece-action.ts
+const generatePieceActionCmd = command({
+	name: "piece-action",
+	description: "Generate an action inside an existing piece",
+	args: {
+		namePositional: positional({
+			type: optional(string),
+			displayName: "name",
+			description: "The name of the action, e.g. get-record"
+		}),
+		name: option({
+			type: optional(string),
+			long: "name",
+			short: "n",
+			description: "The name of the action to generate"
+		}),
+		piece: option({
+			type: optional(string),
+			long: "piece",
+			short: "p",
+			description: "The piece directory under pieces/ to add the action to. Optional when the project ships exactly one piece."
+		}),
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { startGeneratePieceAction } = await import("./generate-piece-action-Byk-BmYt.mjs");
+		await startGeneratePieceAction(args, process.cwd());
+		process.exit(0);
+	}
+});
+//#endregion
+//#region src/commands/generate-piece-trigger.ts
+const generatePieceTriggerCmd = command({
+	name: "piece-trigger",
+	description: "Generate a trigger inside an existing piece",
+	args: {
+		namePositional: positional({
+			type: optional(string),
+			displayName: "name",
+			description: "The name of the trigger, e.g. new-record"
+		}),
+		name: option({
+			type: optional(string),
+			long: "name",
+			short: "n",
+			description: "The name of the trigger to generate"
+		}),
+		piece: option({
+			type: optional(string),
+			long: "piece",
+			short: "p",
+			description: "The piece directory under pieces/ to add the trigger to. Optional when the project ships exactly one piece."
+		}),
+		strategy: option({
+			type: oneOf(["polling", "webhook"]),
+			long: "strategy",
+			description: "How the trigger fires: polled on a schedule, or delivered to a webhook",
+			defaultValue: () => "polling",
+			defaultValueIsSerializable: true
+		}),
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { startGeneratePieceTrigger } = await import("./generate-piece-trigger-CmPqKZej.mjs");
+		await startGeneratePieceTrigger(args, process.cwd());
+		process.exit(0);
+	}
+});
+//#endregion
+//#region src/commands/generate-piece.ts
+const generatePieceCmd = command({
+	name: "piece",
+	description: "Generate a piece: a connector whose actions and triggers a workflow can call",
+	args: {
+		namePositional: positional({
+			type: optional(string),
+			displayName: "name",
+			description: "The name of the piece to generate. Its directory is the kebab-case of this."
+		}),
+		name: option({
+			type: optional(string),
+			long: "name",
+			short: "n",
+			description: "The name of the piece to generate"
+		}),
+		id: option({
+			type: optional(string),
+			long: "id",
+			description: "The piece id a workflow block type names, e.g. @acme/piece-crm. Defaults to one derived from the package name."
+		}),
+		pieceVersion: option({
+			type: optional(string),
+			long: "piece-version",
+			description: "The version the pieces list declares. Defaults to the package version when the piece is named after the package, else 1.0.0."
+		}),
+		auth: option({
+			type: oneOf([
+				"none",
+				"secret",
+				"custom"
+			]),
+			long: "auth",
+			description: "The kind of connection the piece asks for",
+			defaultValue: () => "custom",
+			defaultValueIsSerializable: true
+		}),
+		description: option({
+			type: optional(string),
+			long: "description",
+			description: "One line describing what the piece connects to"
+		}),
+		dir: option({
+			type: optional(Directory),
+			long: "dir",
+			description: "Name of the directory of an existing piece to re-register"
+		}),
+		all: flag({
+			long: "all",
+			short: "a",
+			description: "Re-register every piece in pieces/: refresh the pieces list and the manifest, and prune what is gone"
+		}),
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { startGeneratePiece } = await import("./generate-piece-BHBXK1_P.mjs");
+		await startGeneratePiece(args, process.cwd());
+		process.exit(0);
+	}
+});
 const generateProcessorCmd = command({
 	name: "processor",
 	description: "Generate a processor",
@@ -446,7 +597,7 @@ const generateProcessorCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateProcessor } = await import("./generate-processor-_WOx-mMe.mjs");
+		const { startGenerateProcessor } = await import("./generate-processor-FprZJIKD.mjs");
 		await startGenerateProcessor(args, process.cwd());
 		process.exit(0);
 	}
@@ -487,7 +638,7 @@ const generateSubgraphCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateSubgraph } = await import("./generate-subgraph-BsHUstpl.mjs");
+		const { startGenerateSubgraph } = await import("./generate-subgraph-DNwL9vDs.mjs");
 		await startGenerateSubgraph(args, process.cwd());
 		process.exit(0);
 	}
@@ -504,6 +655,9 @@ const generate = subcommands({
 		app: generateAppCmd,
 		processor: generateProcessorCmd,
 		subgraph: generateSubgraphCmd,
+		piece: generatePieceCmd,
+		"piece-action": generatePieceActionCmd,
+		"piece-trigger": generatePieceTriggerCmd,
 		"migration-file": generateMigrationFileCmd
 	}
 });
@@ -515,7 +669,7 @@ const init = command({
 	args: initArgs,
 	handler: async (args) => {
 		if (args.debug) console.log({ args });
-		const { startInit } = await import("./init-BZP6gvYd.mjs");
+		const { startInit } = await import("./init-CIEMyAug.mjs");
 		await startInit(args);
 		process.exit(0);
 	}
@@ -538,7 +692,7 @@ This command:
 	args: inspectArgs,
 	handler: async (args) => {
 		if (args.debug) console.log(args);
-		const { startInspect } = await import("./inspect-DXjbQEV_.mjs");
+		const { startInspect } = await import("./inspect-BpCB0TPo.mjs");
 		startInspect(args);
 		process.exit(0);
 	}
@@ -617,7 +771,7 @@ Resolution order for the registry URL:
 				throw error;
 			}
 		}
-		const { updateConfigFile, updateStylesFile } = await import("./utils-BzwczAW-.mjs");
+		const { updateConfigFile, updateStylesFile } = await import("./utils-C3c5YG6v.mjs");
 		try {
 			console.log("⚙️ Updating powerhouse config file...");
 			updateConfigFile(dependenciesWithVersions, projectPath, "install", args.local ? "local" : "registry", registryUrl, args.registry !== void 0);
@@ -691,7 +845,7 @@ This command:
 	args: loginArgs,
 	handler: async (args) => {
 		if (args.debug) console.log(args);
-		const { getRenown } = await import("./auth-BNkN6kS9.mjs");
+		const { getRenown } = await import("./auth-CNhbN5UM.mjs");
 		const renown = await getRenown(args.renownUrl);
 		if (args.showDid) {
 			console.log(renown.did);
@@ -760,7 +914,7 @@ This command:
 	}
 });
 async function handleLogout() {
-	const { getRenown } = await import("./auth-BNkN6kS9.mjs");
+	const { getRenown } = await import("./auth-CNhbN5UM.mjs");
 	const renown = await getRenown();
 	if (!renown.user) {
 		console.log("Not currently authenticated.");
@@ -794,7 +948,7 @@ const migrate = command({
 	description: "Run migrations",
 	handler: async (args) => {
 		if (args.debug) console.log(args);
-		const { startMigrate } = await import("./migrate-jGKfE02L.mjs");
+		const { startMigrate } = await import("./migrate-ORExpVlJ.mjs");
 		await startMigrate(args);
 		process.exit(0);
 	}
@@ -842,7 +996,7 @@ This command:
 		const { projectPath } = await getPowerhouseProjectInfo();
 		if (!projectPath) throw new Error("Could not find project path.");
 		const { checkNpmAuth, npmPublish, resolveRegistryUrl } = await import("@powerhousedao/shared/registry");
-		const { mintRegistryAuthToken } = await import("./registry-auth-DxEWCJu2.mjs");
+		const { mintRegistryAuthToken } = await import("./registry-auth-Bm5AR-fB.mjs");
 		const registryUrl = resolveRegistryUrl({
 			registry: args.registry,
 			projectPath
@@ -932,7 +1086,7 @@ Usage:
 		const projectPath = (await getPowerhouseProjectInfo().catch(() => null))?.projectPath ?? process.cwd();
 		const [{ resolveRegistryUrl, writeRegistryAuthToken }, { mintRegistryAuthToken }, { parseExpiry, formatExpiry }] = await Promise.all([
 			import("@powerhousedao/shared/registry"),
-			import("./registry-auth-DxEWCJu2.mjs"),
+			import("./registry-auth-Bm5AR-fB.mjs"),
 			import("@renown/sdk/node")
 		]);
 		const registryUrl = resolveRegistryUrl({
@@ -969,7 +1123,7 @@ This command:
 		const { basePath, dbPath, migrate, migrateStatus, reset, yes } = args;
 		if (basePath) process.env.BASE_PATH = basePath;
 		if (reset) {
-			const { resetSwitchboardDatabase } = await import("./switchboard-reset-BcQXlcVf.mjs");
+			const { resetSwitchboardDatabase } = await import("./switchboard-reset-Ctegiqdm.mjs");
 			await resetSwitchboardDatabase({
 				dbPath,
 				yes
@@ -977,14 +1131,14 @@ This command:
 			process.exit(0);
 		}
 		if (migrate || migrateStatus) {
-			const { runSwitchboardMigrations } = await import("./switchboard-migrate-NQ7LHWSi.mjs");
+			const { runSwitchboardMigrations } = await import("./switchboard-migrate-7JQZM7-5.mjs");
 			await runSwitchboardMigrations({
 				dbPath,
 				statusOnly: migrateStatus
 			});
 			process.exit(0);
 		}
-		const { startSwitchboard } = await import("./switchboard-iRFugh8I.mjs");
+		const { startSwitchboard } = await import("./switchboard-C5AOMSKA.mjs");
 		const { defaultDriveUrl, renown } = await startSwitchboard(args);
 		console.log("   ➜  Switchboard:", defaultDriveUrl);
 		if (renown) console.log("   ➜  Identity:", renown.did);
@@ -1021,7 +1175,8 @@ This command:
 		});
 		try {
 			console.log("Uninstalling dependencies 📦 ...");
-			execSync$1(await getPowerhouseProjectUninstallCommand(packageManager, args.dependencies), {
+			const uninstallCommand = await getPowerhouseProjectUninstallCommand(packageManager, args.dependencies);
+			execSync$1(uninstallCommand, {
 				stdio: "inherit",
 				cwd: projectPath
 			});
@@ -1030,7 +1185,7 @@ This command:
 			console.error("❌ Failed to uninstall dependencies");
 			throw error;
 		}
-		const { removeStylesImports, updateConfigFile } = await import("./utils-BzwczAW-.mjs");
+		const { removeStylesImports, updateConfigFile } = await import("./utils-C3c5YG6v.mjs");
 		try {
 			console.log("⚙️ Updating powerhouse config file...");
 			updateConfigFile(dependenciesWithVersions, projectPath, "uninstall");
@@ -1157,11 +1312,20 @@ This command:
 1. Starts a Vetra Switchboard with a "Vetra" drive for document storage
 2. Optionally connects to remote drives instead of creating a local drive
 3. Starts Connect Studio pointing to the Switchboard for user interaction (unless disabled)
-4. Enables real-time updates, collaboration, and code generation`,
+4. Enables real-time updates, collaboration, and code generation
+
+Default drives:
+Connect's default drives resolve to the Vetra drive (and the preview drive
+when using --watch), plus any drives configured under
+connect.drives.defaultDrives in powerhouse.config.json - de-duplicated by
+URL, so configuring project drives does not cost you the Vetra drive.
+An explicit --default-drives-url is appended to that list (de-duplicated);
+it never replaces the Vetra drive.
+`,
 		args: vetraArgs,
 		handler: async (args) => {
 			if (args.debug) console.log(args);
-			const { startVetra } = await import("./vetra-DkF6EJMY.mjs");
+			const { startVetra } = await import("./vetra-DhhT9bQB.mjs");
 			await startVetra(args);
 		}
 	}),
@@ -1180,10 +1344,13 @@ This command:
 	install,
 	uninstall
 };
+//#endregion
+//#region src/commands/ph-cli.ts
+const version = getVersion();
 const phCli = subcommands({
 	name: "ph-cli",
 	description: PH_CLI_DESCRIPTION,
-	version: getVersion(),
+	version,
 	cmds: phCliCommands
 });
 //#endregion
@@ -1231,7 +1398,7 @@ function printDbRecoveryHint(err) {
 //#endregion
 //#region src/cli.ts
 let sentryClient = void 0;
-const COMMANDS_WITH_SUBCOMMANDS = new Set(["connect", "vetra"]);
+const COMMANDS_WITH_SUBCOMMANDS = /* @__PURE__ */ new Set(["connect", "vetra"]);
 function detectPackageManager() {
 	const ua = process.env.npm_config_user_agent;
 	if (!ua) return void 0;
@@ -1263,12 +1430,14 @@ async function main() {
 		"build",
 		"preview",
 		"config"
-	].includes(args[1]) && !isHelp) await run(cli, [
-		"connect",
-		"studio",
-		...restArgs
-	]);
-	else await run(cli, args);
+	].includes(args[1]) && !isHelp) {
+		const argsWithDefaultConnectSubCommand = [
+			"connect",
+			"studio",
+			...restArgs
+		];
+		await run(cli, argsWithDefaultConnectSubCommand);
+	} else await run(cli, args);
 }
 await main().catch(async (error) => {
 	const isDebug = process.argv.slice(2).includes("--debug");
@@ -1284,4 +1453,4 @@ await main().catch(async (error) => {
 export {};
 
 //# sourceMappingURL=cli.mjs.map
-//# debugId=ab6e0f84-63f5-57ba-a18e-7091ccbf13c6
+//# debugId=3ab9cfff-6f9c-57a2-a989-3a29e9435207