@powerhousedao/ph-cli 6.1.0 → 6.2.0-dev.0

package/dist/cli-connect-override-DHpuwyEn.mjs

@@ -0,0 +1,274 @@
+
+!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]="07c21629-f10b-55aa-b4d0-374f2dbfb053")}catch(e){}}();
+import { deepMerge, phConnectRuntimeConfigSchema } from "@powerhousedao/shared/connect";
+import AjvNs from "ajv";
+import { isPlainObject, stringToPath } from "remeda";
+//#region src/utils/connect-config-validation.ts
+const validateConnect = new (AjvNs.default ?? AjvNs)({
+	allErrors: true,
+	strict: false
+}).compile(phConnectRuntimeConfigSchema);
+/**
+* Parse the CLI-supplied value. Tries JSON first so `true`, `42`, `"a"`,
+* `null`, `[1,2]` coerce; falls back to the raw string for unquoted text.
+*
+* Examples:
+*   "true"  -> true (boolean)
+*   "42"    -> 42 (number)
+*   '"x"'   -> "x" (string, quoted)
+*   "x"     -> "x" (string, bare)
+*   "[1,2]" -> [1, 2] (array)
+*/
+function parseCliValue(raw) {
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return raw;
+	}
+}
+/**
+* Strip the optional leading "connect." prefix so callers can pass either
+* "connect.renown.url" or "renown.url" interchangeably.
+*/
+function normalizeKey(key) {
+	return key.startsWith("connect.") ? key.slice(8) : key;
+}
+function formatErrors(errors) {
+	if (!errors || errors.length === 0) return "unknown validation error";
+	return errors.map((e) => {
+		return `  ${e.instancePath || "(root)"} ${e.message ?? ""}`.trim();
+	}).join("\n");
+}
+/**
+* Validate a single `<key> <value>` pair. Returns the parsed connect-partial
+* that, when deep-merged into the existing config, applies the change.
+*
+* Throws on:
+*   - Empty key
+*   - Path that doesn't exist in the schema
+*   - Value whose type doesn't match the schema at the leaf path
+*/
+function validateConnectKeyValue(key, rawValue) {
+	const normalized = normalizeKey(key);
+	if (!normalized) throw new Error("ph connect config: key cannot be empty. Pass a dotted path inside connect.* (e.g. connect.renown.url).");
+	const parsed = parseCliValue(rawValue);
+	const stub = stringToPath(normalized).reduceRight((acc, key) => ({ [String(key)]: acc }), parsed);
+	if (!validateConnect(stub)) throw new Error(`ph connect config: validation failed for key="${normalized}" value=${JSON.stringify(parsed)} (parsed as ${typeof parsed}):\n${formatErrors(validateConnect.errors)}`);
+	return stub;
+}
+/**
+* Validate a `--json` bulk override. Returns the parsed partial.
+*
+* `packageRegistryUrl` is a top-level runtime field (not part of the
+* `connect.*` schema). If present in the payload, it is extracted before
+* validation so the connect-only blob can be checked against the schema,
+* then re-attached on the returned object so the caller can route it.
+*/
+function validateConnectPatch(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		throw new Error(`ph connect config --json: invalid JSON (${msg}). Expected a partial connect.* blob, e.g. --json '{"renown":{"url":"..."}}'.`, { cause: e });
+	}
+	if (!isPlainObject(parsed)) throw new Error(`ph connect config --json: payload must be a JSON object, got ${typeof parsed}.`);
+	const top = parsed;
+	const hasPackageRegistryUrl = Object.prototype.hasOwnProperty.call(top, "packageRegistryUrl");
+	const packageRegistryUrl = top.packageRegistryUrl;
+	const connectOnly = { ...top };
+	delete connectOnly.packageRegistryUrl;
+	if (!validateConnect(connectOnly)) throw new Error(`ph connect config --json: validation failed:\n${formatErrors(validateConnect.errors)}`);
+	return hasPackageRegistryUrl ? {
+		...connectOnly,
+		packageRegistryUrl
+	} : connectOnly;
+}
+//#endregion
+//#region src/utils/parse-default-drives.ts
+/**
+* Comma-separated URL string → array of `{url, name: null, icon: null}`
+* entries suitable for `connect.drives.defaultDrives`. Used by ph-cli's
+* CLI-override builders and by `ph vetra` when forwarding the local
+* switchboard's drive URLs into the runtime config.
+*/
+const parseDefaultDrivesUrl = (v) => v.split(",").map((s) => s.trim()).filter(Boolean).map((url) => ({
+	url,
+	name: null,
+	icon: null
+}));
+//#endregion
+//#region src/utils/cli-connect-override.ts
+/**
+* Parse the `--json` payload (if any). Throws on malformed JSON or on a
+* non-object root with a clear, command-line-visible error.
+*/
+function parseJsonOverride(raw) {
+	if (raw === void 0 || raw === "") return {};
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		throw new Error(`--json: invalid JSON (${msg}). Expected a partial 'connect.*' blob, e.g. --json '{"renown":{"url":"..."}}'.`, { cause: e });
+	}
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`--json: payload must be a JSON object, got ${typeof parsed}.`);
+	return parsed;
+}
+function setIfDefined(target, key, value) {
+	if (value !== void 0) target[key] = value;
+}
+/**
+* Detect whether the user literally typed `--<longName>` on the command
+* line. Used to gate the 4 commonArgs flags through `cliConnectOverride` —
+* those flags have cmd-ts defaults, so their parsed value is always
+* defined, and a naive merge would silently clobber source values with the
+* default on every build.
+*
+* Handles both `--flag value` and `--flag=value` forms.
+*/
+function wasFlagExplicitlyPassed(longName) {
+	const dashed = `--${longName}`;
+	return process.argv.some((arg) => arg === dashed || arg.startsWith(`${dashed}=`));
+}
+/**
+* Build a `connect.*` partial from the 19 field flags. Only includes paths
+* the user explicitly set (undefined values are excluded).
+*
+* Single source of truth for the flag → JSON-path mapping; consumed by both
+* `ph connect build` and `ph connect config`.
+*/
+function buildConnectFlagPatch(args) {
+	const out = {};
+	const app = {};
+	setIfDefined(app, "basePath", args.basePath);
+	setIfDefined(app, "logLevel", args.logLevel);
+	if (Object.keys(app).length > 0) out.app = app;
+	const renown = {};
+	setIfDefined(renown, "url", args.renownUrl);
+	setIfDefined(renown, "networkId", args.renownNetworkId);
+	setIfDefined(renown, "chainId", args.renownChainId);
+	if (Object.keys(renown).length > 0) out.renown = renown;
+	const packages = {};
+	setIfDefined(packages, "externalEnabled", args.externalPackages);
+	if (Object.keys(packages).length > 0) out.packages = packages;
+	const branding = {};
+	setIfDefined(branding, "appName", args.appName);
+	if (args.homeBackground !== void 0) branding.homeBackground = args.homeBackground === "" ? null : args.homeBackground;
+	if (Object.keys(branding).length > 0) out.branding = branding;
+	const sentry = {};
+	if (args.sentryDsn !== void 0) sentry.dsn = args.sentryDsn === "" ? null : args.sentryDsn;
+	setIfDefined(sentry, "env", args.sentryEnv);
+	setIfDefined(sentry, "tracing", args.sentryTracingEnabled);
+	if (Object.keys(sentry).length > 0) out.sentry = sentry;
+	const drives = {};
+	setIfDefined(drives, "allowAddDrive", args.allowAddDrive);
+	setIfDefined(drives, "preserveStrategy", args.drivesPreserveStrategy);
+	if (args.defaultDrivesUrl !== void 0 && args.defaultDrivesUrl !== "") drives.defaultDrives = parseDefaultDrivesUrl(args.defaultDrivesUrl);
+	const remote = {};
+	setIfDefined(remote, "enabled", args.remoteDrivesEnabled);
+	setIfDefined(remote, "allowAdd", args.remoteDrivesAllowAdd);
+	setIfDefined(remote, "allowDelete", args.remoteDrivesAllowDelete);
+	const local = {};
+	setIfDefined(local, "enabled", args.localDrivesEnabled);
+	setIfDefined(local, "allowAdd", args.localDrivesAllowAdd);
+	setIfDefined(local, "allowDelete", args.localDrivesAllowDelete);
+	const sections = {};
+	if (Object.keys(remote).length > 0) sections.remote = remote;
+	if (Object.keys(local).length > 0) sections.local = local;
+	if (Object.keys(sections).length > 0) drives.sections = sections;
+	if (Object.keys(drives).length > 0) out.drives = drives;
+	return out;
+}
+/**
+* Combine `--json` and the individual flag values into the two override
+* inputs `ph connect build` forwards to the Vite plugin:
+*
+*   - `connectOverride`: a partial `connect.*` patch (deep-merged at the top
+*     of the runtime-config precedence ladder).
+*   - `packageRegistryUrl`: a separate top-level override; mirrors the
+*     source-config top-level field (the SPA reads it directly).
+*
+* `--packages-registry` and `--json` containing a top-level
+* `packageRegistryUrl` both flow into `packageRegistryUrl`; the flag wins on
+* collision. Returns `undefined` for whichever override was not supplied.
+*
+* The 4 commonArgs flags (`--base`, `--log-level`, `--default-drives-url`,
+* `--drive-preserve-strategy`) are gated through `wasFlagExplicitlyPassed`
+* because they carry cmd-ts defaults that would otherwise leak into the
+* override on every build.
+*/
+function buildCliConnectOverride(args) {
+	const fromJson = parseJsonOverride(args.json);
+	const fromFlags = buildConnectFlagPatch({
+		renownUrl: args.renownUrl,
+		renownNetworkId: args.renownNetworkId,
+		renownChainId: args.renownChainId,
+		allowAddDrive: args.allowAddDrive,
+		externalPackages: args.externalPackages,
+		remoteDrivesEnabled: args.remoteDrivesEnabled,
+		remoteDrivesAllowAdd: args.remoteDrivesAllowAdd,
+		remoteDrivesAllowDelete: args.remoteDrivesAllowDelete,
+		localDrivesEnabled: args.localDrivesEnabled,
+		localDrivesAllowAdd: args.localDrivesAllowAdd,
+		localDrivesAllowDelete: args.localDrivesAllowDelete,
+		appName: args.appName,
+		homeBackground: args.homeBackground,
+		sentryDsn: args.sentryDsn,
+		sentryEnv: args.sentryEnv,
+		sentryTracingEnabled: args.sentryTracingEnabled,
+		basePath: wasFlagExplicitlyPassed("base") ? args.connectBasePath : void 0,
+		logLevel: wasFlagExplicitlyPassed("log-level") ? args.logLevel : void 0,
+		defaultDrivesUrl: wasFlagExplicitlyPassed("default-drives-url") ? args.defaultDrivesUrl : void 0,
+		drivesPreserveStrategy: wasFlagExplicitlyPassed("drive-preserve-strategy") ? args.drivesPreserveStrategy : void 0
+	});
+	let positionalRegistry;
+	let fromPositional = {};
+	if (args.keyPositional !== void 0 && args.valuePositional !== void 0) {
+		const normalized = normalizeKey(args.keyPositional);
+		if (!normalized) throw new Error("ph connect build: positional <key> cannot be empty. Pass a dotted path inside connect.* (e.g. connect.renown.url).");
+		if (normalized === "packageRegistryUrl") {
+			const parsed = parseCliValue(args.valuePositional);
+			if (typeof parsed !== "string") throw new Error(`ph connect build: positional packageRegistryUrl must be a string (got ${typeof parsed}).`);
+			positionalRegistry = parsed;
+		} else fromPositional = validateConnectKeyValue(normalized, args.valuePositional);
+	}
+	const jsonRegistry = typeof fromJson.packageRegistryUrl === "string" ? fromJson.packageRegistryUrl : void 0;
+	const packageRegistryUrl = positionalRegistry ?? args.packagesRegistry ?? jsonRegistry;
+	const jsonConnect = { ...fromJson };
+	delete jsonConnect.packageRegistryUrl;
+	const hasJsonConnect = Object.keys(jsonConnect).length > 0;
+	const hasFlags = Object.keys(fromFlags).length > 0;
+	const hasPositional = Object.keys(fromPositional).length > 0;
+	return {
+		connectOverride: !hasJsonConnect && !hasFlags && !hasPositional ? void 0 : deepMerge(deepMerge(jsonConnect, fromFlags), fromPositional),
+		packageRegistryUrl
+	};
+}
+/**
+* Parallel of `buildCliConnectOverride` for `ph connect studio` / `ph vetra`.
+* Studio only exposes the 4 commonArgs flags (`--base`, `--log-level`,
+* `--default-drives-url`, `--drive-preserve-strategy`); each is gated through
+* `wasFlagExplicitlyPassed` so cmd-ts defaults don't leak into the override.
+*
+* `callerOverride` is supplied by wrappers around studio (notably `ph vetra`,
+* which sets default drives + preserveStrategy directly) and deep-merges on
+* top of the user-flag override, so caller choices stick even when the user
+* didn't type the corresponding flag.
+*/
+function buildStudioConnectOverride(args, callerOverride) {
+	const flagOverride = buildConnectFlagPatch({
+		basePath: wasFlagExplicitlyPassed("base") ? args.connectBasePath : void 0,
+		logLevel: wasFlagExplicitlyPassed("log-level") ? args.logLevel : void 0,
+		defaultDrivesUrl: wasFlagExplicitlyPassed("default-drives-url") ? args.defaultDrivesUrl : void 0,
+		drivesPreserveStrategy: wasFlagExplicitlyPassed("drive-preserve-strategy") ? args.drivesPreserveStrategy : void 0
+	});
+	if (!(Object.keys(flagOverride).length > 0)) return callerOverride;
+	if (callerOverride === void 0) return flagOverride;
+	return deepMerge(flagOverride, callerOverride);
+}
+//#endregion
+export { parseDefaultDrivesUrl as a, validateConnectKeyValue as c, wasFlagExplicitlyPassed as i, validateConnectPatch as l, buildConnectFlagPatch as n, normalizeKey as o, buildStudioConnectOverride as r, parseCliValue as s, buildCliConnectOverride as t };
+
+//# sourceMappingURL=cli-connect-override-DHpuwyEn.mjs.map
+//# debugId=07c21629-f10b-55aa-b4d0-374f2dbfb053

package/dist/cli-connect-override-DHpuwyEn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-connect-override-DHpuwyEn.mjs","sources":["../src/utils/connect-config-validation.ts","../src/utils/parse-default-drives.ts","../src/utils/cli-connect-override.ts"],"sourcesContent":["// Ajv-backed validation for `ph connect config` writes.\n//\n// Two entry points:\n//\n//   - validateConnectKeyValue(key, value)\n//     For the `<key> <value>` form. Sets the value at the dotted path inside a\n//     stub connect block, then validates the result against the runtime schema.\n//     Catches both invalid paths (key doesn't map to a real field) and invalid\n//     types (e.g. `connect.renown.chainId \"abc\"` — schema says number).\n//\n//   - validateConnectPatch(patch)\n//     For the `--json` form. Validates the whole patch as a partial connect.*\n//     blob. Same schema, but we only check the keys actually present in the\n//     patch (additional keys still fail per `additionalProperties: false`).\n//\n// Both return a typed `connect.*` partial on success or throw with a multi-\n// line, actionable message on failure.\n\nimport { phConnectRuntimeConfigSchema } from \"@powerhousedao/shared/connect\";\nimport type { PHConnectRuntimeConfig } from \"@powerhousedao/shared/clis\";\nimport AjvNs from \"ajv\";\nimport { isPlainObject, stringToPath } from \"remeda\";\n\ntype PlainObject = Record<string, unknown>;\ntype ConnectPartial = Partial<PHConnectRuntimeConfig>;\n\n// Ajv ships as CJS — under NodeNext ESM the default lands on `.default` while\n// types still point at the class on the namespace. Normalize the constructor.\ntype AjvCtor = new (opts?: Record<string, unknown>) => {\n  compile: (schema: unknown) => AjvValidate;\n};\ntype AjvError = { instancePath?: string; message?: string };\ntype AjvValidate = ((data: unknown) => boolean) & {\n  errors?: AjvError[] | null;\n};\n\nconst Ajv = ((AjvNs as unknown as { default?: AjvCtor }).default ??\n  (AjvNs as unknown as AjvCtor)) as AjvCtor;\n\nconst ajv = new Ajv({ allErrors: true, strict: false });\nconst validateConnect: AjvValidate = ajv.compile(phConnectRuntimeConfigSchema);\n\n/**\n * Parse the CLI-supplied value. Tries JSON first so `true`, `42`, `\"a\"`,\n * `null`, `[1,2]` coerce; falls back to the raw string for unquoted text.\n *\n * Examples:\n *   \"true\"  -> true (boolean)\n *   \"42\"    -> 42 (number)\n *   '\"x\"'   -> \"x\" (string, quoted)\n *   \"x\"     -> \"x\" (string, bare)\n *   \"[1,2]\" -> [1, 2] (array)\n */\nexport function parseCliValue(raw: string): unknown {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return raw;\n  }\n}\n\n/**\n * Strip the optional leading \"connect.\" prefix so callers can pass either\n * \"connect.renown.url\" or \"renown.url\" interchangeably.\n */\nexport function normalizeKey(key: string): string {\n  return key.startsWith(\"connect.\") ? key.slice(\"connect.\".length) : key;\n}\n\nfunction formatErrors(errors: AjvError[] | null | undefined): string {\n  if (!errors || errors.length === 0) return \"unknown validation error\";\n  return errors\n    .map((e) => {\n      const path = e.instancePath || \"(root)\";\n      return `  ${path} ${e.message ?? \"\"}`.trim();\n    })\n    .join(\"\\n\");\n}\n\n/**\n * Validate a single `<key> <value>` pair. Returns the parsed connect-partial\n * that, when deep-merged into the existing config, applies the change.\n *\n * Throws on:\n *   - Empty key\n *   - Path that doesn't exist in the schema\n *   - Value whose type doesn't match the schema at the leaf path\n */\nexport function validateConnectKeyValue(\n  key: string,\n  rawValue: string,\n): ConnectPartial {\n  const normalized = normalizeKey(key);\n  if (!normalized) {\n    throw new Error(\n      \"ph connect config: key cannot be empty. Pass a dotted path inside connect.* (e.g. connect.renown.url).\",\n    );\n  }\n  const parsed = parseCliValue(rawValue);\n  // Build a nested-stub object from the dotted path so Ajv can validate\n  // the value's shape against the schema (e.g. \"renown.url\" + parsed →\n  // { renown: { url: parsed } }). Remeda's `setPath` requires the path\n  // to exist; this is the sparse-creation case, so we fold the parts.\n  const stub = stringToPath(normalized).reduceRight<unknown>(\n    (acc, key) => ({ [String(key)]: acc }),\n    parsed,\n  ) as PlainObject;\n  if (!validateConnect(stub)) {\n    throw new Error(\n      `ph connect config: validation failed for key=\"${normalized}\" value=${JSON.stringify(parsed)} (parsed as ${typeof parsed}):\\n${formatErrors(validateConnect.errors)}`,\n    );\n  }\n  return stub;\n}\n\n/**\n * Validate a `--json` bulk override. Returns the parsed partial.\n *\n * `packageRegistryUrl` is a top-level runtime field (not part of the\n * `connect.*` schema). If present in the payload, it is extracted before\n * validation so the connect-only blob can be checked against the schema,\n * then re-attached on the returned object so the caller can route it.\n */\nexport function validateConnectPatch(raw: string): ConnectPartial & {\n  packageRegistryUrl?: unknown;\n} {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(\n      `ph connect config --json: invalid JSON (${msg}). Expected a partial connect.* blob, e.g. --json '{\"renown\":{\"url\":\"...\"}}'.`,\n      { cause: e },\n    );\n  }\n  if (!isPlainObject(parsed)) {\n    throw new Error(\n      `ph connect config --json: payload must be a JSON object, got ${typeof parsed}.`,\n    );\n  }\n  // Extract `packageRegistryUrl` (top-level field, not in the connect schema)\n  // before validating, so a payload like `{\"packageRegistryUrl\":\"…\"}` doesn't\n  // fail the `additionalProperties: false` check on the connect schema.\n  const top = parsed as PlainObject;\n  const hasPackageRegistryUrl = Object.prototype.hasOwnProperty.call(\n    top,\n    \"packageRegistryUrl\",\n  );\n  const packageRegistryUrl = top.packageRegistryUrl;\n  const connectOnly: PlainObject = { ...top };\n  delete connectOnly.packageRegistryUrl;\n  if (!validateConnect(connectOnly)) {\n    throw new Error(\n      `ph connect config --json: validation failed:\\n${formatErrors(validateConnect.errors)}`,\n    );\n  }\n  return hasPackageRegistryUrl\n    ? ({ ...connectOnly, packageRegistryUrl } as ConnectPartial & {\n        packageRegistryUrl?: unknown;\n      })\n    : (connectOnly as ConnectPartial);\n}\n","/**\n * Comma-separated URL string → array of `{url, name: null, icon: null}`\n * entries suitable for `connect.drives.defaultDrives`. Used by ph-cli's\n * CLI-override builders and by `ph vetra` when forwarding the local\n * switchboard's drive URLs into the runtime config.\n */\nexport const parseDefaultDrivesUrl = (\n  v: string,\n): Array<{ url: string; name: null; icon: null }> =>\n  v\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter(Boolean)\n    .map((url) => ({ url, name: null, icon: null }));\n","// Builds a `connectOverride` partial from CLI flags. Shared by:\n//\n//   - `ph connect build` — uses `buildCliConnectOverride` to produce the\n//     `cliConnectOverride` patch the Vite plugin applies at the top of the\n//     precedence ladder:\n//\n//       DEFAULT_CONNECT_CONFIG  <  env-var seeds  <  source connect.*  <  --json  <  individual --flag\n//\n//   - `ph connect config` — uses `buildConnectFlagPatch` (the per-field\n//     partial builder) to translate flag-set values into the patch that\n//     gets dual-written to source + dist `powerhouse.config.json`.\n//\n// `--json` parses as a partial `connect.*` blob and merges in first; then any\n// individual --flag values merge on top, so a flag beats a conflicting --json\n// value.\n\nimport type { PHConnectRuntimeConfig } from \"@powerhousedao/shared/clis\";\nimport { deepMerge } from \"@powerhousedao/shared/connect\";\nimport type { ConnectBuildArgs, ConnectStudioArgs } from \"../types.js\";\nimport {\n  normalizeKey,\n  parseCliValue,\n  validateConnectKeyValue,\n} from \"./connect-config-validation.js\";\nimport { parseDefaultDrivesUrl } from \"./parse-default-drives.js\";\n\ntype PlainObject = Record<string, unknown>;\n\n/**\n * Structural input shape consumed by `buildConnectFlagPatch`. Every property\n * is strict-optional — `undefined` means \"user did not pass this flag\" and\n * the path is excluded from the patch.\n *\n * Callers with cmd-ts-typed args where some flags have built-in defaults\n * (e.g. the 4 commonArgs flags `--base` / `--log-level` /\n * `--default-drives-url` / `--drive-preserve-strategy`) must filter through\n * `wasFlagExplicitlyPassed` BEFORE building this input — otherwise default\n * values like `\"info\"` will silently clobber source `powerhouse.config.json`\n * values.\n */\nexport type ConnectFlagInput = {\n  // Strict-optional flags from connectRuntimeOverrideArgs (excluding\n  // `packagesRegistry`, which is a top-level runtime field — see\n  // `buildCliConnectOverride`).\n  json?: string | undefined;\n  renownUrl?: string | undefined;\n  renownNetworkId?: string | undefined;\n  renownChainId?: number | undefined;\n  allowAddDrive?: boolean | undefined;\n  externalPackages?: boolean | undefined;\n  remoteDrivesEnabled?: boolean | undefined;\n  remoteDrivesAllowAdd?: boolean | undefined;\n  remoteDrivesAllowDelete?: boolean | undefined;\n  localDrivesEnabled?: boolean | undefined;\n  localDrivesAllowAdd?: boolean | undefined;\n  localDrivesAllowDelete?: boolean | undefined;\n  appName?: string | undefined;\n  homeBackground?: string | undefined;\n  sentryDsn?: string | undefined;\n  sentryEnv?: string | undefined;\n  sentryTracingEnabled?: boolean | undefined;\n  // commonArgs flags. Callers must apply `wasFlagExplicitlyPassed`\n  // filtering (see above).\n  basePath?: string | undefined;\n  logLevel?: string | undefined;\n  defaultDrivesUrl?: string | undefined;\n  drivesPreserveStrategy?: string | undefined;\n};\n\n/**\n * Parse the `--json` payload (if any). Throws on malformed JSON or on a\n * non-object root with a clear, command-line-visible error.\n */\nfunction parseJsonOverride(raw: string | undefined): PlainObject {\n  if (raw === undefined || raw === \"\") return {};\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(\n      `--json: invalid JSON (${msg}). Expected a partial 'connect.*' blob, e.g. --json '{\"renown\":{\"url\":\"...\"}}'.`,\n      { cause: e },\n    );\n  }\n  if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n    throw new Error(\n      `--json: payload must be a JSON object, got ${typeof parsed}.`,\n    );\n  }\n  return parsed as PlainObject;\n}\n\n/**\n * Re-exported for `runConnectConfig` so the same JSON validation runs for\n * both `build --json` and `config --json`.\n */\nexport function parseConnectJsonArg(raw: string | undefined): PlainObject {\n  return parseJsonOverride(raw);\n}\n\nfunction setIfDefined<V>(\n  target: PlainObject,\n  key: string,\n  value: V | undefined,\n): void {\n  if (value !== undefined) target[key] = value;\n}\n\n/**\n * Detect whether the user literally typed `--<longName>` on the command\n * line. Used to gate the 4 commonArgs flags through `cliConnectOverride` —\n * those flags have cmd-ts defaults, so their parsed value is always\n * defined, and a naive merge would silently clobber source values with the\n * default on every build.\n *\n * Handles both `--flag value` and `--flag=value` forms.\n */\nexport function wasFlagExplicitlyPassed(longName: string): boolean {\n  const dashed = `--${longName}`;\n  return process.argv.some(\n    (arg) => arg === dashed || arg.startsWith(`${dashed}=`),\n  );\n}\n\n/**\n * Build a `connect.*` partial from the 19 field flags. Only includes paths\n * the user explicitly set (undefined values are excluded).\n *\n * Single source of truth for the flag → JSON-path mapping; consumed by both\n * `ph connect build` and `ph connect config`.\n */\nexport function buildConnectFlagPatch(args: ConnectFlagInput): PlainObject {\n  const out: PlainObject = {};\n\n  const app: PlainObject = {};\n  setIfDefined(app, \"basePath\", args.basePath);\n  setIfDefined(app, \"logLevel\", args.logLevel);\n  if (Object.keys(app).length > 0) out.app = app;\n\n  const renown: PlainObject = {};\n  setIfDefined(renown, \"url\", args.renownUrl);\n  setIfDefined(renown, \"networkId\", args.renownNetworkId);\n  setIfDefined(renown, \"chainId\", args.renownChainId);\n  if (Object.keys(renown).length > 0) out.renown = renown;\n\n  const packages: PlainObject = {};\n  setIfDefined(packages, \"externalEnabled\", args.externalPackages);\n  if (Object.keys(packages).length > 0) out.packages = packages;\n\n  // --home-background: empty string is the explicit \"set null\" form\n  // (cmd-ts can't pass `null` directly through a string option).\n  const branding: PlainObject = {};\n  setIfDefined(branding, \"appName\", args.appName);\n  if (args.homeBackground !== undefined) {\n    branding.homeBackground =\n      args.homeBackground === \"\" ? null : args.homeBackground;\n  }\n  if (Object.keys(branding).length > 0) out.branding = branding;\n\n  // --sentry-dsn: empty string is the explicit \"set null\" form (disables\n  // Sentry). Same pattern as --home-background.\n  const sentry: PlainObject = {};\n  if (args.sentryDsn !== undefined) {\n    sentry.dsn = args.sentryDsn === \"\" ? null : args.sentryDsn;\n  }\n  setIfDefined(sentry, \"env\", args.sentryEnv);\n  setIfDefined(sentry, \"tracing\", args.sentryTracingEnabled);\n  if (Object.keys(sentry).length > 0) out.sentry = sentry;\n\n  const drives: PlainObject = {};\n  setIfDefined(drives, \"allowAddDrive\", args.allowAddDrive);\n  setIfDefined(drives, \"preserveStrategy\", args.drivesPreserveStrategy);\n  if (args.defaultDrivesUrl !== undefined && args.defaultDrivesUrl !== \"\") {\n    drives.defaultDrives = parseDefaultDrivesUrl(args.defaultDrivesUrl);\n  }\n\n  const remote: PlainObject = {};\n  setIfDefined(remote, \"enabled\", args.remoteDrivesEnabled);\n  setIfDefined(remote, \"allowAdd\", args.remoteDrivesAllowAdd);\n  setIfDefined(remote, \"allowDelete\", args.remoteDrivesAllowDelete);\n\n  const local: PlainObject = {};\n  setIfDefined(local, \"enabled\", args.localDrivesEnabled);\n  setIfDefined(local, \"allowAdd\", args.localDrivesAllowAdd);\n  setIfDefined(local, \"allowDelete\", args.localDrivesAllowDelete);\n\n  const sections: PlainObject = {};\n  if (Object.keys(remote).length > 0) sections.remote = remote;\n  if (Object.keys(local).length > 0) sections.local = local;\n  if (Object.keys(sections).length > 0) drives.sections = sections;\n  if (Object.keys(drives).length > 0) out.drives = drives;\n\n  return out;\n}\n\n/**\n * Combine `--json` and the individual flag values into the two override\n * inputs `ph connect build` forwards to the Vite plugin:\n *\n *   - `connectOverride`: a partial `connect.*` patch (deep-merged at the top\n *     of the runtime-config precedence ladder).\n *   - `packageRegistryUrl`: a separate top-level override; mirrors the\n *     source-config top-level field (the SPA reads it directly).\n *\n * `--packages-registry` and `--json` containing a top-level\n * `packageRegistryUrl` both flow into `packageRegistryUrl`; the flag wins on\n * collision. Returns `undefined` for whichever override was not supplied.\n *\n * The 4 commonArgs flags (`--base`, `--log-level`, `--default-drives-url`,\n * `--drive-preserve-strategy`) are gated through `wasFlagExplicitlyPassed`\n * because they carry cmd-ts defaults that would otherwise leak into the\n * override on every build.\n */\nexport function buildCliConnectOverride(args: ConnectBuildArgs): {\n  connectOverride: PHConnectRuntimeConfig | undefined;\n  packageRegistryUrl: string | undefined;\n} {\n  const fromJson = parseJsonOverride(args.json);\n\n  const input: ConnectFlagInput = {\n    renownUrl: args.renownUrl,\n    renownNetworkId: args.renownNetworkId,\n    renownChainId: args.renownChainId,\n    allowAddDrive: args.allowAddDrive,\n    externalPackages: args.externalPackages,\n    remoteDrivesEnabled: args.remoteDrivesEnabled,\n    remoteDrivesAllowAdd: args.remoteDrivesAllowAdd,\n    remoteDrivesAllowDelete: args.remoteDrivesAllowDelete,\n    localDrivesEnabled: args.localDrivesEnabled,\n    localDrivesAllowAdd: args.localDrivesAllowAdd,\n    localDrivesAllowDelete: args.localDrivesAllowDelete,\n    appName: args.appName,\n    homeBackground: args.homeBackground,\n    sentryDsn: args.sentryDsn,\n    sentryEnv: args.sentryEnv,\n    sentryTracingEnabled: args.sentryTracingEnabled,\n    // commonArgs flags — only forward when the user explicitly passed them.\n    basePath: wasFlagExplicitlyPassed(\"base\")\n      ? args.connectBasePath\n      : undefined,\n    logLevel: wasFlagExplicitlyPassed(\"log-level\") ? args.logLevel : undefined,\n    defaultDrivesUrl: wasFlagExplicitlyPassed(\"default-drives-url\")\n      ? args.defaultDrivesUrl\n      : undefined,\n    drivesPreserveStrategy: wasFlagExplicitlyPassed(\"drive-preserve-strategy\")\n      ? args.drivesPreserveStrategy\n      : undefined,\n  };\n\n  const fromFlags = buildConnectFlagPatch(input);\n\n  // Positional `<key> <value>` override (only set when both are present;\n  // `runConnectBuild` rejects the 1-positional case up front because build\n  // has no read mode). Layered on top of --json + flags so a positional\n  // override wins on collision — matches the user's literal command line.\n  let positionalRegistry: string | undefined;\n  let fromPositional: PlainObject = {};\n  if (args.keyPositional !== undefined && args.valuePositional !== undefined) {\n    const normalized = normalizeKey(args.keyPositional);\n    if (!normalized) {\n      throw new Error(\n        \"ph connect build: positional <key> cannot be empty. Pass a dotted path inside connect.* (e.g. connect.renown.url).\",\n      );\n    }\n    if (normalized === \"packageRegistryUrl\") {\n      const parsed = parseCliValue(args.valuePositional);\n      if (typeof parsed !== \"string\") {\n        throw new Error(\n          `ph connect build: positional packageRegistryUrl must be a string (got ${typeof parsed}).`,\n        );\n      }\n      positionalRegistry = parsed;\n    } else {\n      fromPositional = validateConnectKeyValue(\n        normalized,\n        args.valuePositional,\n      );\n    }\n  }\n\n  // Top-level `packageRegistryUrl` can come from --json (top-level),\n  // --packages-registry flag, or positional `packageRegistryUrl <value>`.\n  // Precedence (highest → lowest): positional > flag > --json.\n  const jsonRegistry =\n    typeof fromJson.packageRegistryUrl === \"string\"\n      ? (fromJson.packageRegistryUrl as string)\n      : undefined;\n  const packageRegistryUrl =\n    positionalRegistry ?? args.packagesRegistry ?? jsonRegistry;\n  // Strip the top-level field from the JSON patch before deep-merging into\n  // the connect partial — it isn't a `connect.*` field.\n  const jsonConnect = { ...fromJson };\n  delete jsonConnect.packageRegistryUrl;\n\n  const hasJsonConnect = Object.keys(jsonConnect).length > 0;\n  const hasFlags = Object.keys(fromFlags).length > 0;\n  const hasPositional = Object.keys(fromPositional).length > 0;\n  const connectOverride =\n    !hasJsonConnect && !hasFlags && !hasPositional\n      ? undefined\n      : deepMerge(\n          deepMerge(\n            jsonConnect as PHConnectRuntimeConfig,\n            fromFlags as PHConnectRuntimeConfig,\n          ),\n          fromPositional as PHConnectRuntimeConfig,\n        );\n\n  return { connectOverride, packageRegistryUrl };\n}\n\n/**\n * Parallel of `buildCliConnectOverride` for `ph connect studio` / `ph vetra`.\n * Studio only exposes the 4 commonArgs flags (`--base`, `--log-level`,\n * `--default-drives-url`, `--drive-preserve-strategy`); each is gated through\n * `wasFlagExplicitlyPassed` so cmd-ts defaults don't leak into the override.\n *\n * `callerOverride` is supplied by wrappers around studio (notably `ph vetra`,\n * which sets default drives + preserveStrategy directly) and deep-merges on\n * top of the user-flag override, so caller choices stick even when the user\n * didn't type the corresponding flag.\n */\nexport function buildStudioConnectOverride(\n  args: ConnectStudioArgs,\n  callerOverride: PHConnectRuntimeConfig | undefined,\n): PHConnectRuntimeConfig | undefined {\n  const flagOverride = buildConnectFlagPatch({\n    basePath: wasFlagExplicitlyPassed(\"base\")\n      ? args.connectBasePath\n      : undefined,\n    logLevel: wasFlagExplicitlyPassed(\"log-level\") ? args.logLevel : undefined,\n    defaultDrivesUrl: wasFlagExplicitlyPassed(\"default-drives-url\")\n      ? args.defaultDrivesUrl\n      : undefined,\n    drivesPreserveStrategy: wasFlagExplicitlyPassed(\"drive-preserve-strategy\")\n      ? args.drivesPreserveStrategy\n      : undefined,\n  }) as PHConnectRuntimeConfig;\n\n  const hasFlag = Object.keys(flagOverride).length > 0;\n  if (!hasFlag) return callerOverride;\n  if (callerOverride === undefined) return flagOverride;\n  return deepMerge(flagOverride, callerOverride);\n}\n"],"names":[],"mappings":"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","debug_id":"07c21629-f10b-55aa-b4d0-374f2dbfb053"}

package/dist/cli.mjs

@@ -1,10 +1,10 @@
 #!/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]="d5bdee00-0bc7-551b-9930-8d2d40d45723")}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]="3cb30f37-19c2-5c02-ad5c-b75e789bcc1a")}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";
-import { AGENTS, accessTokenArgs, buildArgs, connectBuildArgs, connectPreviewArgs, connectStudioArgs, debugArgs, initArgs, inspectArgs, installArgs, listArgs, loginArgs, migrateArgs, phCliHelpCommands, publishArgs, registryLoginArgs, switchboardArgs, uninstallArgs, unpublishArgs, vetraArgs } from "@powerhousedao/shared/clis/args";
+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";
@@ -15,7 +15,7 @@ import { createInterface } from "node:readline/promises";
 import { bold, yellow } from "colorette";
 //#region src/get-version.ts
 function getVersion() {
-	return "6.1.0";
+	return "6.2.0-dev.0";
 }
 //#endregion
 //#region src/utils/constants.ts
@@ -115,7 +115,7 @@ const build$1 = command({
 });
 const connect = subcommands({
 	name: "connect",
-	description: `Powerhouse Connect commands. Use with \`studio\`, \`build\` or \`preview\`. Defaults to \`studio\` if not specified.`,
+	description: `Powerhouse Connect commands. Use with \`studio\`, \`build\`, \`preview\`, or \`config\`. Defaults to \`studio\` if not specified.`,
 	cmds: {
 		studio: command({
 			name: "studio",
@@ -132,19 +132,27 @@ This command:
 			args: connectStudioArgs,
 			handler: async (args) => {
 				if (args.debug) console.log(args);
-				const { runConnectStudio } = await import("./connect-studio-DySbZFEc.mjs");
+				const { runConnectStudio } = await import("./connect-studio-YDVQ49D6.mjs");
 				await runConnectStudio(args);
 			}
 		}),
 		build: command({
 			name: "build",
 			description: `The Connect build command creates a production build with the project's local and
-external packages included
+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.
+
+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-DA5QOP5h.mjs");
+				const { runConnectBuild } = await import("./connect-build-DDWHr6nw.mjs");
 				await runConnectBuild(args);
 				process.exit(0);
 			}
@@ -157,9 +165,31 @@ 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-DQnzviwA.mjs");
+				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).
+
+Modes (mutually exclusive — positional, --get, --json, and field flags cannot be combined):
+  ph connect config                       List the effective connect.* block (defaults < source).
+  ph connect config <key>                 Get the value at the dotted path (e.g. ph connect config connect.renown.url).
+  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.
+
+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-DQcIDdtP.mjs");
+				await runConnectConfig(args);
+			}
 		})
 	}
 });
@@ -174,7 +204,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-WiQQo-Nz.mjs");
+		const { startGenerateAll } = await import("./generate-all-DrT4ZxHX.mjs");
 		await startGenerateAll(args, process.cwd());
 		process.exit(0);
 	}
@@ -228,7 +258,7 @@ const generateAppCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateApp } = await import("./generate-app-DdmOt6ID.mjs");
+		const { startGenerateApp } = await import("./generate-app-DNNqA-H3.mjs");
 		await startGenerateApp(args, process.cwd());
 		process.exit(0);
 	}
@@ -264,7 +294,7 @@ const generateDocumentModelCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateDocumentModel } = await import("./generate-document-model-DQ5PVeIH.mjs");
+		const { startGenerateDocumentModel } = await import("./generate-document-model-BJXyODfm.mjs");
 		await startGenerateDocumentModel(args, process.cwd());
 		process.exit(0);
 	}
@@ -311,7 +341,7 @@ const generateEditorCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateEditor } = await import("./generate-editor-DtzVAs6x.mjs");
+		const { startGenerateEditor } = await import("./generate-editor-BejvaVVT.mjs");
 		await startGenerateEditor(args, process.cwd());
 		process.exit(0);
 	}
@@ -406,7 +436,7 @@ const generateProcessorCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateProcessor } = await import("./generate-processor-FGtN6BVY.mjs");
+		const { startGenerateProcessor } = await import("./generate-processor-_WOx-mMe.mjs");
 		await startGenerateProcessor(args, process.cwd());
 		process.exit(0);
 	}
@@ -447,7 +477,7 @@ const generateSubgraphCmd = command({
 		...debugArgs
 	},
 	handler: async (args) => {
-		const { startGenerateSubgraph } = await import("./generate-subgraph-BrzmW_sj.mjs");
+		const { startGenerateSubgraph } = await import("./generate-subgraph-BsHUstpl.mjs");
 		await startGenerateSubgraph(args, process.cwd());
 		process.exit(0);
 	}
@@ -475,7 +505,7 @@ const init = command({
 	args: initArgs,
 	handler: async (args) => {
 		if (args.debug) console.log({ args });
-		const { startInit } = await import("./init-Cu3_NRHL.mjs");
+		const { startInit } = await import("./init-D3toc_qO.mjs");
 		await startInit(args);
 		process.exit(0);
 	}
@@ -498,7 +528,7 @@ This command:
 	args: inspectArgs,
 	handler: async (args) => {
 		if (args.debug) console.log(args);
-		const { startInspect } = await import("./inspect-BwuBW_zW.mjs");
+		const { startInspect } = await import("./inspect-CKdafPbC.mjs");
 		startInspect(args);
 		process.exit(0);
 	}
@@ -577,10 +607,10 @@ Resolution order for the registry URL:
 				throw error;
 			}
 		}
-		const { updateConfigFile, updateStylesFile } = await import("./utils-C6581aex.mjs");
+		const { updateConfigFile, updateStylesFile } = await import("./utils-DPGwKNam.mjs");
 		try {
 			console.log("⚙️ Updating powerhouse config file...");
-			updateConfigFile(dependenciesWithVersions, projectPath, "install", args.local ? "local" : "registry", registryUrl);
+			updateConfigFile(dependenciesWithVersions, projectPath, "install", args.local ? "local" : "registry", registryUrl, args.registry !== void 0);
 			console.log("Config file updated successfully 🎉");
 		} catch (error) {
 			console.error("❌ Failed to update config file");
@@ -755,7 +785,7 @@ const migrate = command({
 	description: "Run migrations",
 	handler: async (args) => {
 		if (args.debug) console.log(args);
-		const { startMigrate } = await import("./migrate-CfgiCNQo.mjs");
+		const { startMigrate } = await import("./migrate-BJQvY88v.mjs");
 		await startMigrate(args);
 		process.exit(0);
 	}
@@ -803,7 +833,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-CNH84uo4.mjs");
+		const { mintRegistryAuthToken } = await import("./registry-auth-DxEWCJu2.mjs");
 		const registryUrl = resolveRegistryUrl({
 			registry: args.registry,
 			projectPath
@@ -893,7 +923,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-CNH84uo4.mjs"),
+			import("./registry-auth-DxEWCJu2.mjs"),
 			import("@renown/sdk/node")
 		]);
 		const registryUrl = resolveRegistryUrl({
@@ -930,7 +960,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-1YcJEVqc.mjs");
+			const { resetSwitchboardDatabase } = await import("./switchboard-reset-BcQXlcVf.mjs");
 			await resetSwitchboardDatabase({
 				dbPath,
 				yes
@@ -938,14 +968,14 @@ This command:
 			process.exit(0);
 		}
 		if (migrate || migrateStatus) {
-			const { runSwitchboardMigrations } = await import("./switchboard-migrate-BumRp7rC.mjs");
+			const { runSwitchboardMigrations } = await import("./switchboard-migrate-NQ7LHWSi.mjs");
 			await runSwitchboardMigrations({
 				dbPath,
 				statusOnly: migrateStatus
 			});
 			process.exit(0);
 		}
-		const { startSwitchboard } = await import("./switchboard-ChH1PMaE.mjs");
+		const { startSwitchboard } = await import("./switchboard-iRFugh8I.mjs");
 		const { defaultDriveUrl, renown } = await startSwitchboard(args);
 		console.log("   ➜  Switchboard:", defaultDriveUrl);
 		if (renown) console.log("   ➜  Identity:", renown.did);
@@ -991,7 +1021,7 @@ This command:
 			console.error("❌ Failed to uninstall dependencies");
 			throw error;
 		}
-		const { removeStylesImports, updateConfigFile } = await import("./utils-C6581aex.mjs");
+		const { removeStylesImports, updateConfigFile } = await import("./utils-DPGwKNam.mjs");
 		try {
 			console.log("⚙️ Updating powerhouse config file...");
 			updateConfigFile(dependenciesWithVersions, projectPath, "uninstall");
@@ -1122,7 +1152,7 @@ This command:
 		args: vetraArgs,
 		handler: async (args) => {
 			if (args.debug) console.log(args);
-			const { startVetra } = await import("./vetra-BgmlqLmN.mjs");
+			const { startVetra } = await import("./vetra-DjsGCr0t.mjs");
 			await startVetra(args);
 		}
 	}),
@@ -1222,7 +1252,8 @@ async function main() {
 	if (command === "connect" && ![
 		"studio",
 		"build",
-		"preview"
+		"preview",
+		"config"
 	].includes(args[1]) && !isHelp) await run(cli, [
 		"connect",
 		"studio",
@@ -1244,4 +1275,4 @@ await main().catch(async (error) => {
 export {};
 
 //# sourceMappingURL=cli.mjs.map
-//# debugId=d5bdee00-0bc7-551b-9930-8d2d40d45723
+//# debugId=3cb30f37-19c2-5c02-ad5c-b75e789bcc1a