@powerhousedao/ph-cli 6.2.3-dev.4 → 6.2.3-dev.41

package/dist/cli.mjs

@@ -1,29 +1,34 @@
 #!/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]="adfc754d-b98f-5eb1-9873-7e473fff27c0")}catch(e){}}();
+import { n as skipInstallArgs } from "./install-added-dependencies-DVSbzler.mjs";
 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, extendType, 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";
-import path from "path";
+import fs from "node:fs";
+import path from "node:path";
+import path$1 from "path";
+import { execSync } from "node:child_process";
 import { PROCESSOR_APPS } from "@powerhousedao/shared/processors";
-import { execSync } from "child_process";
-import { execSync as execSync$1 } from "node:child_process";
+import { execSync as execSync$1 } from "child_process";
 import { createInterface } from "node:readline/promises";
 import { bold, yellow } from "colorette";
 //#region src/get-version.ts
 function getVersion() {
-	return "6.2.3-dev.4";
+	return "6.2.3-dev.41";
 }
 //#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 +86,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 +106,25 @@ 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 piece takes the package's version: an
+entry in pieces/index.ts that declares version fails the build. 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-Dk9HoX9_.mjs");
 			await runBuild(args);
 		} catch (error) {
 			console.error(error);
@@ -113,13 +132,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,49 +146,51 @@ 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-f3K1qPWd.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):
   ph connect build                                    Build with the current source config.
   ph connect build <key> <value>                      Build with a positional override applied (e.g. ph connect build connect.renown.url https://renown.staging).
   ph connect build --<field> <value>                  Build with a per-field flag override (e.g. --renown-url https://renown.staging).
-  ph connect build --json '{"…":"…"}'                Build with a bulk override.
+  ph connect build --json '{"app":{"workflowsEnabled":true}}'
+                                                      Build with a bulk override. The payload is the connect.* block
+                                                      without the "connect" wrapper; unknown keys are rejected.
 
 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-2dTdDm81.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).
@@ -179,18 +198,28 @@ Modes (mutually exclusive — positional, --get, --json, and field flags cannot
   ph connect config --get <dotted.path>   Same as positional <key> (kept for backward compat).
   ph connect config <key> <value>         Set a single field and dual-write to source + dist (positional).
   ph connect config --<field> <value>     Set a single field via per-field flag (e.g. --renown-url https://renown.id).
-  ph connect config --json '{"…":"…"}'   Bulk-set multiple fields and dual-write.
+  ph connect config --json '{"renown":{"url":"…"}}'
+                                          Bulk-set multiple fields and dual-write. The payload is the connect.*
+                                          block without the "connect" wrapper; unknown keys are rejected.
 
 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-DGfPEeP8.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,12 +233,40 @@ 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);
 	}
 });
 //#endregion
+//#region src/utils/fs-args.ts
+const ExistingPath = extendType(string, {
+	displayName: "path",
+	description: "An existing path",
+	from(str) {
+		const resolved = path.resolve(str);
+		if (!fs.existsSync(resolved)) return Promise.reject(/* @__PURE__ */ new Error("Path doesn't exist"));
+		return Promise.resolve(resolved);
+	}
+});
+/** A directory, or the directory of a given file. */
+const Directory = extendType(ExistingPath, {
+	displayName: "dir",
+	description: "A path to a directory or a file within a directory",
+	from(resolved) {
+		return Promise.resolve(fs.statSync(resolved).isDirectory() ? resolved : path.dirname(resolved));
+	}
+});
+/** An existing file. */
+const File = extendType(ExistingPath, {
+	displayName: "file",
+	description: "A file in the file system",
+	from(resolved) {
+		if (!fs.statSync(resolved).isFile()) return Promise.reject(/* @__PURE__ */ new Error("Provided path is not a file"));
+		return Promise.resolve(resolved);
+	}
+});
+//#endregion
 //#region src/utils/comma-separated.ts
 /** Splits comma-separated values so `-t "a,b"` means the same as `-t a -t b`
 * instead of yielding the single value `"a,b"`, which matches nothing. */
@@ -267,7 +324,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 +360,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 +407,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);
 	}
@@ -377,12 +434,140 @@ const generateMigrationFileCmd = command({
 	handler: async ({ migrationFile, schemaFile }) => {
 		const { generateDBSchema } = await import("@powerhousedao/codegen");
 		await generateDBSchema({
-			migrationFile: path.join(process.cwd(), migrationFile),
-			schemaFile: schemaFile ? path.join(process.cwd(), schemaFile) : void 0
+			migrationFile: path$1.join(process.cwd(), migrationFile),
+			schemaFile: schemaFile ? path$1.join(process.cwd(), schemaFile) : void 0
 		});
 		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."
+		}),
+		...skipInstallArgs,
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { startGeneratePieceAction } = await import("./generate-piece-action-C5WTHsqu.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
+		}),
+		...skipInstallArgs,
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { startGeneratePieceTrigger } = await import("./generate-piece-trigger-DR10CPOG.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, the pieceName a workflow step holds, e.g. @acme/piece-crm. Defaults to one derived from the package name."
+		}),
+		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"
+		}),
+		...skipInstallArgs,
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { startGeneratePiece } = await import("./generate-piece-QTt-ddt2.mjs");
+		await startGeneratePiece(args, process.cwd());
+		process.exit(0);
+	}
+});
 const generateProcessorCmd = command({
 	name: "processor",
 	description: "Generate a processor",
@@ -443,10 +628,11 @@ const generateProcessorCmd = command({
 			short: "x",
 			description: "Write a powerhouse/processor spec for each existing processor into specs/processors/"
 		}),
+		...skipInstallArgs,
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateProcessor } = await import("./generate-processor-_WOx-mMe.mjs");
+		const { startGenerateProcessor } = await import("./generate-processor-DBtTkgo5.mjs");
 		await startGenerateProcessor(args, process.cwd());
 		process.exit(0);
 	}
@@ -484,10 +670,11 @@ const generateSubgraphCmd = command({
 			short: "x",
 			description: "Write a powerhouse/subgraph spec for each existing subgraph into specs/subgraphs/"
 		}),
+		...skipInstallArgs,
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateSubgraph } = await import("./generate-subgraph-BsHUstpl.mjs");
+		const { startGenerateSubgraph } = await import("./generate-subgraph-Dm27O59o.mjs");
 		await startGenerateSubgraph(args, process.cwd());
 		process.exit(0);
 	}
@@ -504,6 +691,9 @@ const generate = subcommands({
 		app: generateAppCmd,
 		processor: generateProcessorCmd,
 		subgraph: generateSubgraphCmd,
+		piece: generatePieceCmd,
+		"piece-action": generatePieceActionCmd,
+		"piece-trigger": generatePieceTriggerCmd,
 		"migration-file": generateMigrationFileCmd
 	}
 });
@@ -515,7 +705,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 +728,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);
 	}
@@ -607,7 +797,7 @@ Resolution order for the registry URL:
 				if (scopeRegistryArgs.length > 0) console.log(`Installing dependencies 📦 (routing ${Array.from(scopes).join(", ")} → ${registryUrl})...`);
 				else console.log("Installing dependencies 📦...");
 				console.log(`> ${installCommand}`);
-				execSync(installCommand, {
+				execSync$1(installCommand, {
 					stdio: "inherit",
 					cwd: projectPath
 				});
@@ -617,7 +807,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 +881,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 +950,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 +984,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-DK4HK7Dn.mjs");
 		await startMigrate(args);
 		process.exit(0);
 	}
@@ -842,7 +1032,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 +1122,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 +1159,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-CX_Lzw3O.mjs");
 			await resetSwitchboardDatabase({
 				dbPath,
 				yes
@@ -977,14 +1167,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-nHCI3pha.mjs");
 		const { defaultDriveUrl, renown } = await startSwitchboard(args);
 		console.log("   ➜  Switchboard:", defaultDriveUrl);
 		if (renown) console.log("   ➜  Identity:", renown.did);
@@ -1021,7 +1211,8 @@ This command:
 		});
 		try {
 			console.log("Uninstalling dependencies 📦 ...");
-			execSync$1(await getPowerhouseProjectUninstallCommand(packageManager, args.dependencies), {
+			const uninstallCommand = await getPowerhouseProjectUninstallCommand(packageManager, args.dependencies);
+			execSync(uninstallCommand, {
 				stdio: "inherit",
 				cwd: projectPath
 			});
@@ -1030,7 +1221,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 +1348,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-CQSUBUvg.mjs");
 			await startVetra(args);
 		}
 	}),
@@ -1180,10 +1380,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 +1434,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 +1466,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 +1489,4 @@ await main().catch(async (error) => {
 export {};
 
 //# sourceMappingURL=cli.mjs.map
-//# debugId=ab6e0f84-63f5-57ba-a18e-7091ccbf13c6
+//# debugId=adfc754d-b98f-5eb1-9873-7e473fff27c0