ph-cmd 6.0.0-dev.2 → 6.0.0-dev.200

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { assertNodeVersion, captureCliError, initCliTelemetry, phCliCommandNames } from "@powerhousedao/shared/clis";
+//#region src/cli.ts
+/**
+* ph-cli and ph-cmd are loaded lazily so that the node version is checked before
+* any code is parsed to avoid errors on startup due to unsupported dependencies.
+*/
+async function runPhCliCommand(phCliCommand) {
+	const { executePhCliCommand } = await import("./ph-cli-1NIlwpsP.mjs");
+	return await executePhCliCommand(phCliCommand);
+}
+async function runPhCmdCommand(args) {
+	const { run } = await import("./run-BJIj5jSO.mjs");
+	return await run(args);
+}
+async function main() {
+	assertNodeVersion();
+	await initCliTelemetry({
+		cliName: "ph-cmd",
+		release: "6.0.0-dev.200"
+	});
+	const args = process.argv.slice(2);
+	const command = args[0];
+	if (command === "connect" && !args.some((arg) => [
+		"studio",
+		"build",
+		"preview"
+	].includes(arg)) && !args.some((arg) => ["--help", "-h"].includes(arg))) {
+		await runPhCliCommand("connect");
+		process.exit(0);
+	}
+	if (phCliCommandNames.includes(command)) {
+		await runPhCliCommand(command);
+		process.exit(0);
+	}
+	await runPhCmdCommand(args);
+	process.exit(0);
+}
+await main().catch(async (error) => {
+	const isDebug = process.argv.slice(2).includes("--debug");
+	await captureCliError(error);
+	if (isDebug) throw error;
+	if (error instanceof Error) {
+		console.error(error.message);
+		process.exit(1);
+	} else throw error;
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport {\n  assertNodeVersion,\n  captureCliError,\n  initCliTelemetry,\n  phCliCommandNames,\n} from \"@powerhousedao/shared/clis\";\n\n// Injected at build time by tsdown (see tsdown.config.ts `define`).\ndeclare const CLI_VERSION: string;\n\n/**\n * ph-cli and ph-cmd are loaded lazily so that the node version is checked before\n * any code is parsed to avoid errors on startup due to unsupported dependencies.\n */\n\nasync function runPhCliCommand(phCliCommand: string) {\n  const { executePhCliCommand } = await import(\"./ph-cli.js\");\n  return await executePhCliCommand(phCliCommand);\n}\nasync function runPhCmdCommand(args: string[]) {\n  const { run } = await import(\"./run.js\");\n  return await run(args);\n}\n\nasync function main() {\n  assertNodeVersion();\n  // Opt-out telemetry; asked once on first interactive run. No-op under\n  // PH_NO_TELEMETRY / DO_NOT_TRACK / CI.\n  await initCliTelemetry({ cliName: \"ph-cmd\", release: CLI_VERSION });\n  const args = process.argv.slice(2);\n  const command = args[0];\n\n  // handle the special case where running `connect` with no positional argument\n  // defaults to `connect studio`\n  if (\n    command === \"connect\" &&\n    !args.some((arg) => [\"studio\", \"build\", \"preview\"].includes(arg)) &&\n    // do not default to `connect studio` when help is present, instead show general help\n    // for the `connect` command\n    !args.some((arg) => [\"--help\", \"-h\"].includes(arg))\n  ) {\n    await runPhCliCommand(\"connect\");\n    process.exit(0);\n  }\n\n  // forward command to the local ph-cli installation if it exists\n  if (phCliCommandNames.includes(command)) {\n    await runPhCliCommand(command);\n    process.exit(0);\n  }\n\n  await runPhCmdCommand(args);\n  process.exit(0);\n}\n\nawait main().catch(async (error) => {\n  const isDebug = process.argv.slice(2).includes(\"--debug\");\n  // No-op when telemetry is disabled; flushes before we exit otherwise.\n  await captureCliError(error);\n  if (isDebug) {\n    throw error;\n  }\n  if (error instanceof Error) {\n    console.error(error.message);\n    process.exit(1);\n  } else {\n    throw error;\n  }\n});\n"],"mappings":";;;;;;;AAgBA,eAAe,gBAAgB,cAAsB;CACnD,MAAM,EAAE,wBAAwB,MAAM,OAAO;AAC7C,QAAO,MAAM,oBAAoB,aAAa;;AAEhD,eAAe,gBAAgB,MAAgB;CAC7C,MAAM,EAAE,QAAQ,MAAM,OAAO;AAC7B,QAAO,MAAM,IAAI,KAAK;;AAGxB,eAAe,OAAO;AACpB,oBAAmB;AAGnB,OAAM,iBAAiB;EAAE,SAAS;EAAU,SAAA;EAAsB,CAAC;CACnE,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE;CAClC,MAAM,UAAU,KAAK;AAIrB,KACE,YAAY,aACZ,CAAC,KAAK,MAAM,QAAQ;EAAC;EAAU;EAAS;EAAU,CAAC,SAAS,IAAI,CAAC,IAGjE,CAAC,KAAK,MAAM,QAAQ,CAAC,UAAU,KAAK,CAAC,SAAS,IAAI,CAAC,EACnD;AACA,QAAM,gBAAgB,UAAU;AAChC,UAAQ,KAAK,EAAE;;AAIjB,KAAI,kBAAkB,SAAS,QAAQ,EAAE;AACvC,QAAM,gBAAgB,QAAQ;AAC9B,UAAQ,KAAK,EAAE;;AAGjB,OAAM,gBAAgB,KAAK;AAC3B,SAAQ,KAAK,EAAE;;AAGjB,MAAM,MAAM,CAAC,MAAM,OAAO,UAAU;CAClC,MAAM,UAAU,QAAQ,KAAK,MAAM,EAAE,CAAC,SAAS,UAAU;AAEzD,OAAM,gBAAgB,MAAM;AAC5B,KAAI,QACF,OAAM;AAER,KAAI,iBAAiB,OAAO;AAC1B,UAAQ,MAAM,MAAM,QAAQ;AAC5B,UAAQ,KAAK,EAAE;OAEf,OAAM;EAER"}

package/dist/generate-commands-docs.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/generate-commands-docs.mjs

@@ -0,0 +1,41 @@
+import { a as setupGlobals, i as update, n as use, o as init, r as useLocal, t as ph } from "./ph-CzQLX9vM.mjs";
+import { writeCliDocsMarkdownFile } from "@powerhousedao/codegen/file-builders";
+//#region src/generate-commands-docs.ts
+const commands = [
+	{
+		name: "init",
+		command: init
+	},
+	{
+		name: "use",
+		command: use
+	},
+	{
+		name: "update",
+		command: update
+	},
+	{
+		name: "setup-globals",
+		command: setupGlobals
+	},
+	{
+		name: "use-local",
+		command: useLocal
+	}
+];
+const cliDescription = ph.description ?? "";
+async function main() {
+	await writeCliDocsMarkdownFile({
+		filePath: "COMMANDS.md",
+		docsTitle: `PH-CMD CLI Commands (6.0.0-dev.200)`,
+		docsIntroduction: "This document provides detailed information about the available commands in the PH-CMD CLI. The CLI is published as `ph-cmd` and is invoked with the `ph` command.",
+		cliDescription,
+		entries: commands
+	});
+	process.exit(0);
+}
+await main();
+//#endregion
+export {};
+
+//# sourceMappingURL=generate-commands-docs.mjs.map

package/dist/generate-commands-docs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-commands-docs.mjs","names":[],"sources":["../src/generate-commands-docs.ts"],"sourcesContent":["import { writeCliDocsMarkdownFile } from \"@powerhousedao/codegen/file-builders\";\nimport { init } from \"./commands/init.js\";\nimport { ph } from \"./commands/ph.js\";\nimport { setupGlobals } from \"./commands/setup-globals.js\";\nimport { update } from \"./commands/update.js\";\nimport { useLocal } from \"./commands/use-local.js\";\nimport { use } from \"./commands/use.js\";\n\nconst commands = [\n  { name: \"init\", command: init },\n  { name: \"use\", command: use },\n  { name: \"update\", command: update },\n  { name: \"setup-globals\", command: setupGlobals },\n  { name: \"use-local\", command: useLocal },\n];\n\nconst cliDescription = ph.description ?? \"\";\ndeclare const CLI_VERSION: string;\n\nasync function main() {\n  await writeCliDocsMarkdownFile({\n    filePath: \"COMMANDS.md\",\n    docsTitle: `PH-CMD CLI Commands (${CLI_VERSION})`,\n    docsIntroduction:\n      \"This document provides detailed information about the available commands in the PH-CMD CLI. The CLI is published as `ph-cmd` and is invoked with the `ph` command.\",\n    cliDescription,\n    entries: commands,\n  });\n  process.exit(0);\n}\n\nawait main();\n"],"mappings":";;;AAQA,MAAM,WAAW;CACf;EAAE,MAAM;EAAQ,SAAS;EAAM;CAC/B;EAAE,MAAM;EAAO,SAAS;EAAK;CAC7B;EAAE,MAAM;EAAU,SAAS;EAAQ;CACnC;EAAE,MAAM;EAAiB,SAAS;EAAc;CAChD;EAAE,MAAM;EAAa,SAAS;EAAU;CACzC;AAED,MAAM,iBAAiB,GAAG,eAAe;AAGzC,eAAe,OAAO;AACpB,OAAM,yBAAyB;EAC7B,UAAU;EACV,WAAW;EACX,kBACE;EACF;EACA,SAAS;EACV,CAAC;AACF,SAAQ,KAAK,EAAE;;AAGjB,MAAM,MAAM"}

package/dist/ph-CzQLX9vM.mjs

@@ -0,0 +1,416 @@
+import { HOME_DIR, PH_BIN, PH_GLOBAL_DIR_NAME, POWERHOUSE_GLOBAL_DIR, debugArgs, getPhCmdVersionInfo, getTagFromVersion, handleMutuallyExclusiveOptions, initArgs, logVersionUpdate, parsePackageManager, parsePackageVersion, parseTag, phCliHelpCommands, runCmd, runUseLocal } from "@powerhousedao/shared/clis";
+import { boolean, command, flag, oneOf, option, optional, positional, string, subcommands } from "cmd-ts";
+import { execSync } from "node:child_process";
+import { resolveCommand } from "package-manager-detector";
+import { createProject } from "@powerhousedao/codegen";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import path from "path";
+import { ALL_POWERHOUSE_DEPENDENCIES } from "@powerhousedao/shared/constants";
+import chalk from "chalk";
+import { detect } from "package-manager-detector/detect";
+import { readPackage } from "read-pkg";
+import { writePackage } from "write-package";
+import { clean, valid } from "semver";
+//#region src/commands/init.ts
+/**
+* Delegates `ph init` to the appropriate version of `@powerhousedao/ph-cli`.
+* This ensures the init logic (boilerplate, codegen) always matches the
+* ph-cli version being installed in the new project.
+*/
+const init = command({
+	name: "init",
+	description: "Initialize a new project",
+	args: initArgs,
+	handler: (args) => {
+		if (args.debug) console.log({ args });
+		handleMutuallyExclusiveOptions({
+			tag: args.tag,
+			version: args.version,
+			dev: args.dev,
+			staging: args.staging
+		}, "versioning strategy");
+		handleMutuallyExclusiveOptions({
+			npm: args.npm,
+			pnpm: args.pnpm,
+			yarn: args.yarn,
+			bun: args.bun,
+			packageManager: args.packageManager
+		}, "package manager");
+		const phCliVersion = args.version ?? parseTag(args);
+		const pm = parsePackageManager(args) ?? "npm";
+		const forwardedArgs = process.argv.slice(3);
+		const resolved = resolveCommand(pm, "execute", [
+			`@powerhousedao/ph-cli@${phCliVersion}`,
+			"init",
+			...forwardedArgs
+		]);
+		if (!resolved) throw new Error(`Could not resolve execute command for package manager "${pm}".`);
+		const { command: cmd, args: cmdArgs } = resolved;
+		const fullCmd = `${cmd} ${cmdArgs.join(" ")}`;
+		if (args.debug) console.log(">>> Delegating to ph-cli:", fullCmd);
+		execSync(fullCmd, { stdio: "inherit" });
+		process.exit(0);
+	}
+});
+//#endregion
+//#region src/utils/constants.ts
+const PH_BIN_PATH = process.argv[1];
+const PH_GLOBAL_PACKAGE_NAME = "ph-global";
+const packageManagers = {
+	bun: {
+		installCommand: "bun add {{dependency}}",
+		execCommand: `bun ${PH_BIN} {{arguments}}`,
+		execScript: `bun {{arguments}}`,
+		lockfile: "bun.lock",
+		globalPathRegexp: /[\\/].bun[\\/]/,
+		updateCommand: "bun update {{dependency}}",
+		buildAffected: "bun run build:affected",
+		workspaceOption: "",
+		installDepsCommand: "bun install"
+	},
+	pnpm: {
+		installCommand: "pnpm add {{dependency}}",
+		execCommand: `pnpm exec ${PH_BIN} {{arguments}}`,
+		execScript: `pnpm {{arguments}}`,
+		lockfile: "pnpm-lock.yaml",
+		globalPathRegexp: /[\\/]pnpm[\\/]/,
+		updateCommand: "pnpm update {{dependency}}",
+		buildAffected: "pnpm run build:affected",
+		workspaceOption: "--workspace-root",
+		installDepsCommand: "pnpm install"
+	},
+	yarn: {
+		installCommand: "yarn add {{dependency}}",
+		execCommand: `yarn ${PH_BIN} {{arguments}}`,
+		execScript: `yarn {{arguments}}`,
+		lockfile: "yarn.lock",
+		globalPathRegexp: /[\\/]yarn[\\/]/,
+		updateCommand: "yarn upgrade {{dependency}}",
+		buildAffected: "yarn run build:affected",
+		workspaceOption: "-W",
+		installDepsCommand: "yarn install"
+	},
+	npm: {
+		installCommand: "npm install {{dependency}}",
+		execCommand: `npx ${PH_BIN} {{arguments}}`,
+		execScript: `npm run {{arguments}}`,
+		lockfile: "package-lock.json",
+		updateCommand: "npm update {{dependency}} --save",
+		buildAffected: "npm run build:affected",
+		workspaceOption: "",
+		installDepsCommand: "npm install"
+	}
+};
+//#endregion
+//#region src/utils/package-manager.ts
+function getPackageManagerFromPath(dir) {
+	const lowerCasePath = dir.toLowerCase();
+	if (packageManagers.bun.globalPathRegexp.test(lowerCasePath)) return "bun";
+	else if (packageManagers.pnpm.globalPathRegexp.test(lowerCasePath)) return "pnpm";
+	else if (packageManagers.yarn.globalPathRegexp.test(lowerCasePath)) return "yarn";
+	return "npm";
+}
+//#endregion
+//#region src/utils/create-global-project.ts
+const createGlobalProject = async (projectName, options = {}) => {
+	if (existsSync(POWERHOUSE_GLOBAL_DIR)) {
+		const packageJsonPath = path.join(POWERHOUSE_GLOBAL_DIR, "package.json");
+		if (existsSync(packageJsonPath)) try {
+			const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+			if (packageJson.name?.startsWith(".")) {
+				console.log("📦 Fixing invalid package name in global project...");
+				packageJson.name = PH_GLOBAL_PACKAGE_NAME;
+				writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+			}
+		} catch {}
+		console.log(`📦 Using global project: ${POWERHOUSE_GLOBAL_DIR}`);
+		return;
+	}
+	console.log("📦 Initializing global project...");
+	process.chdir(HOME_DIR);
+	try {
+		await createProject({
+			name: PH_GLOBAL_DIR_NAME,
+			tag: parseTag(options),
+			packageManager: parsePackageManager(options) ?? getPackageManagerFromPath(PH_BIN_PATH)
+		});
+		const packageJsonPath = path.join(POWERHOUSE_GLOBAL_DIR, "package.json");
+		const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+		packageJson.name = PH_GLOBAL_PACKAGE_NAME;
+		writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+		console.log(`🚀 Global project initialized successfully: ${POWERHOUSE_GLOBAL_DIR}`);
+	} catch (error) {
+		console.error("❌ Failed to initialize the global project", error);
+	}
+};
+//#endregion
+//#region src/commands/setup-globals.ts
+const setupGlobals = command({
+	name: "setup-globals",
+	description: "Initialize a new global project",
+	args: initArgs,
+	handler: async (args) => {
+		const { namePositional, nameOption, debug, ...options } = args;
+		if (debug) console.log({ args });
+		await createGlobalProject(namePositional ?? nameOption, options);
+		process.exit(0);
+	}
+});
+//#endregion
+//#region src/commands/update.ts
+const update = command({
+	name: "update",
+	description: "Update your powerhouse dependencies to their latest tagged version",
+	args: {
+		skipInstall: flag({
+			type: optional(boolean),
+			long: "skip-install",
+			short: "s",
+			description: "Skip running `install` with your package manager"
+		}),
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { skipInstall, debug } = args;
+		if (debug) console.log({ args });
+		console.log(`\n▶️ Updating Powerhouse dependencies...\n`);
+		const packageJson = await readPackage();
+		if (packageJson.dependencies) {
+			for (const [name, version] of Object.entries(packageJson.dependencies)) if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag: getTagFromVersion(version)
+				});
+				packageJson.dependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version,
+					newVersion
+				});
+			}
+		}
+		if (packageJson.devDependencies) {
+			for (const [name, version] of Object.entries(packageJson.devDependencies)) if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag: getTagFromVersion(version)
+				});
+				packageJson.devDependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version,
+					newVersion
+				});
+			}
+		}
+		if (packageJson.optionalDependencies) {
+			for (const [name, version] of Object.entries(packageJson.optionalDependencies)) if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag: getTagFromVersion(version)
+				});
+				packageJson.optionalDependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version,
+					newVersion
+				});
+			}
+		}
+		if (packageJson.peerDependencies) {
+			for (const [name, version] of Object.entries(packageJson.peerDependencies)) if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag: getTagFromVersion(version)
+				});
+				packageJson.peerDependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version,
+					newVersion
+				});
+			}
+		}
+		await writePackage(packageJson);
+		console.log(chalk.green(`\n✅ Project updated successfully\n`));
+		if (skipInstall) return;
+		const packageManager = await detect();
+		if (!packageManager) throw new Error(`❌ Failed to detect your package manager. Run install manually.`);
+		console.log(`▶️ Installing updated dependencies with \`${packageManager.agent}\`\n`);
+		runCmd(`${packageManager.agent} install`);
+		process.exit(0);
+	}
+});
+//#endregion
+//#region src/commands/use-local.ts
+const useLocal = command({
+	name: "use-local",
+	description: "Use your local `powerhouse` monorepo dependencies the current project.",
+	args: {
+		monorepoPathPositional: positional({
+			type: optional(string),
+			displayName: "monorepo path",
+			description: "Path to your local powerhouse monorepo relative to this project"
+		}),
+		monorepoPathOption: option({
+			type: optional(string),
+			long: "path",
+			short: "p",
+			description: "Path to your local powerhouse monorepo relative to this project"
+		}),
+		skipInstall: flag({
+			type: optional(boolean),
+			long: "skip-install",
+			short: "s",
+			description: "Skip running `install` with `pnpm`"
+		}),
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { monorepoPathPositional, monorepoPathOption, skipInstall, debug } = args;
+		if (debug) console.log({ args });
+		const monorepoPath = monorepoPathPositional ?? monorepoPathOption;
+		if (!monorepoPath) throw new Error("❌ Please provide the path to your local powerhouse monorepo.");
+		await runUseLocal(monorepoPath, skipInstall);
+		process.exit(0);
+	}
+});
+//#endregion
+//#region src/commands/use.ts
+const use = command({
+	name: "use",
+	description: "Specify the release version of Powerhouse dependencies to use.",
+	args: {
+		tagPositional: positional({
+			type: optional(oneOf([
+				"latest",
+				"staging",
+				"dev"
+			])),
+			displayName: "tag",
+			description: `Specify the release tag to use for your project. Can be one of: "latest", "staging", or "dev".`
+		}),
+		tagOption: option({
+			type: optional(oneOf([
+				"latest",
+				"staging",
+				"dev"
+			])),
+			long: "tag",
+			short: "t",
+			description: `Specify the release tag to use for your project. Can be one of: "latest", "staging", or "dev".`
+		}),
+		version: option({
+			type: optional(string),
+			long: "version",
+			short: "v",
+			description: "Specify the exact semver release version to use for your project."
+		}),
+		skipInstall: flag({
+			type: optional(boolean),
+			long: "skip-install",
+			short: "s",
+			description: "Skip running `install` with your package manager"
+		}),
+		...debugArgs
+	},
+	handler: async (args) => {
+		const { tagPositional, tagOption, version, skipInstall, debug } = args;
+		if (debug) console.log({ args });
+		const tag = tagPositional ?? tagOption;
+		handleMutuallyExclusiveOptions({
+			tag,
+			version
+		}, "versioning strategy");
+		if (!tag && !version) throw new Error("Please specify either a release tag or a version to use.");
+		if (version && !valid(clean(version))) throw new Error(`❌ Invalid version: ${chalk.bold(version)}`);
+		console.log(`▶️ Updating project to use ${chalk.bold(version ?? tag)}...\n`);
+		const packageJson = await readPackage();
+		if (packageJson.dependencies) {
+			for (const [name, existingVersion] of Object.entries(packageJson.dependencies)) if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag,
+					version
+				});
+				packageJson.dependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version: existingVersion,
+					newVersion
+				});
+			}
+		}
+		if (packageJson.devDependencies) {
+			for (const [name, existingVersion] of Object.entries(packageJson.devDependencies)) if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag,
+					version
+				});
+				packageJson.devDependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version: existingVersion,
+					newVersion
+				});
+			}
+		}
+		if (packageJson.optionalDependencies) {
+			for (const [name, existingVersion] of Object.entries(packageJson.optionalDependencies)) if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag,
+					version
+				});
+				packageJson.optionalDependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version: existingVersion,
+					newVersion
+				});
+			}
+		}
+		if (packageJson.peerDependencies) {
+			for (const [name, existingVersion] of Object.entries(packageJson.peerDependencies)) if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {
+				const newVersion = await parsePackageVersion({
+					name,
+					tag,
+					version
+				});
+				packageJson.peerDependencies[name] = newVersion;
+				logVersionUpdate({
+					name,
+					version: existingVersion,
+					newVersion
+				});
+			}
+		}
+		await writePackage(packageJson);
+		console.log(chalk.green(`\n✅ Project updated to use ${chalk.bold(version ?? tag)}\n`));
+		if (!skipInstall) {
+			const packageManager = await detect();
+			if (!packageManager) throw new Error(`❌ Failed to detect your package manager. Run install manually.`);
+			console.log(`▶️ Installing updated dependencies with \`${packageManager.agent}\`\n`);
+			runCmd(`${packageManager.agent} install`);
+		}
+		process.exit(0);
+	}
+});
+const ph = subcommands({
+	name: "ph",
+	version: await getPhCmdVersionInfo("6.0.0-dev.200"),
+	description: "The Powerhouse CLI (ph-cmd) is a command-line interface tool that provides essential commands for managing Powerhouse projects.\nThe tool and it's commands are fundamental for creating, building, and running Document Models as a builder in studio mode.",
+	cmds: {
+		init,
+		use,
+		update,
+		"setup-globals": setupGlobals,
+		"use-local": useLocal,
+		...phCliHelpCommands
+	}
+});
+//#endregion
+export { setupGlobals as a, update as i, use as n, init as o, useLocal as r, ph as t };
+
+//# sourceMappingURL=ph-CzQLX9vM.mjs.map

package/dist/ph-CzQLX9vM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ph-CzQLX9vM.mjs","names":[],"sources":["../src/commands/init.ts","../src/utils/constants.ts","../src/utils/package-manager.ts","../src/utils/create-global-project.ts","../src/commands/setup-globals.ts","../src/commands/update.ts","../src/commands/use-local.ts","../src/commands/use.ts","../src/commands/ph.ts"],"sourcesContent":["import {\n  handleMutuallyExclusiveOptions,\n  initArgs,\n  parsePackageManager,\n  parseTag,\n} from \"@powerhousedao/shared/clis\";\nimport { command } from \"cmd-ts\";\nimport { execSync } from \"node:child_process\";\nimport { resolveCommand } from \"package-manager-detector\";\n\n/**\n * Delegates `ph init` to the appropriate version of `@powerhousedao/ph-cli`.\n * This ensures the init logic (boilerplate, codegen) always matches the\n * ph-cli version being installed in the new project.\n */\nexport const init = command({\n  name: \"init\",\n  description: \"Initialize a new project\",\n  args: initArgs,\n  handler: (args) => {\n    if (args.debug) {\n      console.log({ args });\n    }\n\n    handleMutuallyExclusiveOptions(\n      {\n        tag: args.tag,\n        version: args.version,\n        dev: args.dev,\n        staging: args.staging,\n      },\n      \"versioning strategy\",\n    );\n\n    handleMutuallyExclusiveOptions(\n      {\n        npm: args.npm,\n        pnpm: args.pnpm,\n        yarn: args.yarn,\n        bun: args.bun,\n        packageManager: args.packageManager,\n      },\n      \"package manager\",\n    );\n\n    const phCliVersion = args.version ?? parseTag(args);\n    const pm = parsePackageManager(args) ?? \"npm\";\n\n    // Forward original args as-is to ph-cli\n    const forwardedArgs = process.argv.slice(3);\n    const phCliPackage = `@powerhousedao/ph-cli@${phCliVersion}`;\n    const resolved = resolveCommand(pm, \"execute\", [\n      phCliPackage,\n      \"init\",\n      ...forwardedArgs,\n    ]);\n\n    if (!resolved) {\n      throw new Error(\n        `Could not resolve execute command for package manager \"${pm}\".`,\n      );\n    }\n\n    const { command: cmd, args: cmdArgs } = resolved;\n    const fullCmd = `${cmd} ${cmdArgs.join(\" \")}`;\n\n    if (args.debug) {\n      console.log(\">>> Delegating to ph-cli:\", fullCmd);\n    }\n\n    execSync(fullCmd, { stdio: \"inherit\" });\n    process.exit(0);\n  },\n});\n","import { PH_BIN } from \"@powerhousedao/shared/clis\";\n\nexport const PH_BIN_PATH = process.argv[1];\nexport const PH_CLI_COMMANDS = [\n  \"init\",\n  \"dev\",\n  \"connect\",\n  \"generate\",\n  \"reactor\",\n  \"switchboard\",\n  \"help\",\n  \"install\",\n  \"add\",\n  \"i\",\n  \"remove\",\n  \"uninstall\",\n  \"service\",\n  \"list\",\n  \"inspect\",\n  \"version\",\n  \"login\",\n  \"logout\",\n];\nexport const PH_GLOBAL_PACKAGE_NAME = \"ph-global\";\n\nexport const packageManagers = {\n  bun: {\n    installCommand: \"bun add {{dependency}}\",\n    execCommand: `bun ${PH_BIN} {{arguments}}`,\n    execScript: `bun {{arguments}}`,\n    lockfile: \"bun.lock\",\n    globalPathRegexp: /[\\\\/].bun[\\\\/]/,\n    updateCommand: \"bun update {{dependency}}\",\n    buildAffected: \"bun run build:affected\",\n    workspaceOption: \"\",\n    installDepsCommand: \"bun install\",\n  },\n  pnpm: {\n    installCommand: \"pnpm add {{dependency}}\",\n    execCommand: `pnpm exec ${PH_BIN} {{arguments}}`,\n    execScript: `pnpm {{arguments}}`,\n    lockfile: \"pnpm-lock.yaml\",\n    globalPathRegexp: /[\\\\/]pnpm[\\\\/]/,\n    updateCommand: \"pnpm update {{dependency}}\",\n    buildAffected: \"pnpm run build:affected\",\n    workspaceOption: \"--workspace-root\",\n    installDepsCommand: \"pnpm install\",\n  },\n  yarn: {\n    installCommand: \"yarn add {{dependency}}\",\n    execCommand: `yarn ${PH_BIN} {{arguments}}`,\n    execScript: `yarn {{arguments}}`,\n    lockfile: \"yarn.lock\",\n    globalPathRegexp: /[\\\\/]yarn[\\\\/]/,\n    updateCommand: \"yarn upgrade {{dependency}}\",\n    buildAffected: \"yarn run build:affected\",\n    workspaceOption: \"-W\",\n    installDepsCommand: \"yarn install\",\n  },\n  npm: {\n    installCommand: \"npm install {{dependency}}\",\n    execCommand: `npx ${PH_BIN} {{arguments}}`,\n    execScript: `npm run {{arguments}}`,\n    lockfile: \"package-lock.json\",\n    updateCommand: \"npm update {{dependency}} --save\",\n    buildAffected: \"npm run build:affected\",\n    workspaceOption: \"\",\n    installDepsCommand: \"npm install\",\n  },\n} as const;\n","import {\n  POWERHOUSE_CONFIG_FILE,\n  POWERHOUSE_GLOBAL_DIR,\n} from \"@powerhousedao/shared/clis\";\nimport { execSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport path, { dirname } from \"node:path\";\nimport { packageManagers } from \"./constants.js\";\nimport { createGlobalProject } from \"./create-global-project.js\";\nimport type { PackageManager, PathValidation, ProjectInfo } from \"./types.js\";\n\nexport function defaultPathValidation() {\n  return true;\n}\n\nexport function isPowerhouseProject(dir: string) {\n  const powerhouseConfigPath = path.join(dir, POWERHOUSE_CONFIG_FILE);\n\n  return existsSync(powerhouseConfigPath);\n}\n\nexport function findNodeProjectRoot(\n  dir: string,\n  pathValidation: PathValidation = defaultPathValidation,\n) {\n  const packageJsonPath = path.join(dir, \"package.json\");\n\n  if (existsSync(packageJsonPath) && pathValidation(dir)) {\n    return dir;\n  }\n\n  const parentDir = dirname(dir);\n\n  if (parentDir === dir) {\n    return null;\n  }\n\n  return findNodeProjectRoot(parentDir, pathValidation);\n}\n\nexport function getPackageManagerFromPath(dir: string): PackageManager {\n  const lowerCasePath = dir.toLowerCase();\n\n  if (packageManagers.bun.globalPathRegexp.test(lowerCasePath)) {\n    return \"bun\";\n  } else if (packageManagers.pnpm.globalPathRegexp.test(lowerCasePath)) {\n    return \"pnpm\";\n  } else if (packageManagers.yarn.globalPathRegexp.test(lowerCasePath)) {\n    return \"yarn\";\n  }\n\n  return \"npm\";\n}\n\nexport function getPackageManagerFromLockfile(dir: string): PackageManager {\n  if (existsSync(path.join(dir, packageManagers.pnpm.lockfile))) {\n    return \"pnpm\";\n  } else if (existsSync(path.join(dir, packageManagers.yarn.lockfile))) {\n    return \"yarn\";\n  } else if (existsSync(path.join(dir, packageManagers.bun.lockfile))) {\n    return \"bun\";\n  }\n\n  return \"npm\";\n}\n\nexport async function getProjectInfo(\n  debug?: boolean,\n  generateGlobalProject = true,\n): Promise<ProjectInfo> {\n  const currentPath = process.cwd();\n\n  if (debug) {\n    console.log(\">>> currentPath:\", currentPath);\n  }\n\n  const projectPath = findNodeProjectRoot(currentPath, isPowerhouseProject);\n\n  if (!projectPath) {\n    let available = existsSync(POWERHOUSE_GLOBAL_DIR);\n\n    if (generateGlobalProject) {\n      await createGlobalProject();\n      available = true;\n    }\n\n    return {\n      available,\n      isGlobal: true,\n      path: POWERHOUSE_GLOBAL_DIR,\n    };\n  }\n\n  return {\n    isGlobal: false,\n    available: true,\n    path: projectPath,\n  };\n}\n\nexport function forwardPHCommand(\n  packageManager: PackageManager,\n  projectPath: string,\n  args: string,\n  debug?: boolean,\n  captureOutput = false,\n) {\n  const manager = packageManagers[packageManager];\n  const command = manager.execCommand;\n  const execCommand = command.replace(\"{{arguments}}\", args);\n\n  const commandOptions = { cwd: projectPath };\n\n  if (debug) {\n    console.log(\">>> execCommand:\", execCommand);\n    console.log(\">>> commandOptions:\", commandOptions);\n    console.log(\">>> projectPath:\", projectPath);\n    console.log(\">>> packageManager:\", packageManager);\n  }\n\n  if (captureOutput) {\n    // Capture output and return it\n    try {\n      return execSync(execCommand, {\n        stdio: \"pipe\",\n        encoding: \"utf8\",\n        ...commandOptions,\n      });\n    } catch (error) {\n      throw new Error(\n        `Failed to execute command: ${execCommand}\\nError: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  } else {\n    // Original behavior - pipe directly to stdout/stderr\n    execSync(execCommand, {\n      stdio: \"inherit\",\n      ...commandOptions,\n    });\n    return \"\";\n  }\n}\n\n/**\n * Recursively searches for a specific file by traversing up the directory tree.\n * Starting from the given path, it checks each parent directory until it finds\n * the target file or reaches the root directory.\n *\n * @param startPath - The absolute path of the directory to start searching from\n * @param targetFile - The name of the file to search for (e.g., 'package.json', 'pnpm-workspace.yaml')\n * @returns The absolute path of the directory containing the target file, or null if not found\n *\n * @example\n * // Find the workspace root directory\n * const workspaceRoot = findContainerDirectory('/path/to/project/src', 'pnpm-workspace.yaml');\n *\n * // Find the nearest package.json\n * const packageDir = findContainerDirectory('/path/to/project/src/components', 'package.json');\n */\nexport const findContainerDirectory = (\n  startPath: string,\n  targetFile: string,\n): string | null => {\n  const filePath = path.join(startPath, targetFile);\n\n  if (existsSync(filePath)) {\n    return startPath;\n  }\n\n  const parentDir = path.dirname(startPath);\n\n  //reached the root directory and haven't found the file\n  if (parentDir === startPath) {\n    return null;\n  }\n\n  return findContainerDirectory(parentDir, targetFile);\n};\n","import { createProject } from \"@powerhousedao/codegen\";\nimport {\n  HOME_DIR,\n  PH_GLOBAL_DIR_NAME,\n  POWERHOUSE_GLOBAL_DIR,\n  parsePackageManager,\n  parseTag,\n} from \"@powerhousedao/shared/clis\";\nimport { existsSync, readFileSync, writeFileSync } from \"fs\";\nimport path from \"path\";\nimport { PH_BIN_PATH, PH_GLOBAL_PACKAGE_NAME } from \"./constants.js\";\nimport { getPackageManagerFromPath } from \"./package-manager.js\";\nimport type { GlobalProjectOptions } from \"./types.js\";\n\nexport const createGlobalProject = async (\n  projectName?: string,\n  options: GlobalProjectOptions = {},\n) => {\n  // check if the global project already exists\n  const globalProjectExists = existsSync(POWERHOUSE_GLOBAL_DIR);\n\n  if (globalProjectExists) {\n    // Fix existing installations with invalid \".ph\" package name\n    const packageJsonPath = path.join(POWERHOUSE_GLOBAL_DIR, \"package.json\");\n    if (existsSync(packageJsonPath)) {\n      try {\n        const packageJson = JSON.parse(\n          readFileSync(packageJsonPath, \"utf-8\"),\n        ) as { name?: string };\n        if (packageJson.name?.startsWith(\".\")) {\n          console.log(\"📦 Fixing invalid package name in global project...\");\n          packageJson.name = PH_GLOBAL_PACKAGE_NAME;\n          writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));\n        }\n      } catch {\n        // Ignore errors reading/writing package.json\n      }\n    }\n    console.log(`📦 Using global project: ${POWERHOUSE_GLOBAL_DIR}`);\n    return;\n  }\n\n  console.log(\"📦 Initializing global project...\");\n  process.chdir(HOME_DIR);\n\n  try {\n    await createProject({\n      name: PH_GLOBAL_DIR_NAME,\n      tag: parseTag(options),\n      packageManager:\n        parsePackageManager(options) ?? getPackageManagerFromPath(PH_BIN_PATH),\n    });\n\n    // Fix the package.json name - \".ph\" is invalid for npm/vite\n    // The directory name can be \".ph\" but the package name must be valid\n    const packageJsonPath = path.join(POWERHOUSE_GLOBAL_DIR, \"package.json\");\n    const packageJson = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n      name?: string;\n    };\n    packageJson.name = PH_GLOBAL_PACKAGE_NAME;\n    writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));\n\n    console.log(\n      `🚀 Global project initialized successfully: ${POWERHOUSE_GLOBAL_DIR}`,\n    );\n  } catch (error) {\n    console.error(\"❌ Failed to initialize the global project\", error);\n  }\n};\n","import { initArgs } from \"@powerhousedao/shared/clis\";\nimport { command } from \"cmd-ts\";\nimport { createGlobalProject } from \"../utils/create-global-project.js\";\n\nexport const setupGlobals = command({\n  name: \"setup-globals\",\n  description: \"Initialize a new global project\",\n  args: initArgs,\n  handler: async (args) => {\n    const { namePositional, nameOption, debug, ...options } = args;\n    if (debug) {\n      console.log({ args });\n    }\n    const name = namePositional ?? nameOption;\n    await createGlobalProject(name, options);\n    process.exit(0);\n  },\n});\n","import {\n  debugArgs,\n  getTagFromVersion,\n  logVersionUpdate,\n  parsePackageVersion,\n  runCmd,\n} from \"@powerhousedao/shared/clis\";\nimport { ALL_POWERHOUSE_DEPENDENCIES } from \"@powerhousedao/shared/constants\";\nimport chalk from \"chalk\";\nimport { boolean, command, flag, optional } from \"cmd-ts\";\nimport { detect } from \"package-manager-detector/detect\";\nimport { readPackage } from \"read-pkg\";\nimport { writePackage } from \"write-package\";\n\nexport const update = command({\n  name: \"update\",\n  description:\n    \"Update your powerhouse dependencies to their latest tagged version\",\n  args: {\n    skipInstall: flag({\n      type: optional(boolean),\n      long: \"skip-install\",\n      short: \"s\",\n      description: \"Skip running `install` with your package manager\",\n    }),\n    ...debugArgs,\n  },\n  handler: async (args) => {\n    const { skipInstall, debug } = args;\n    if (debug) {\n      console.log({ args });\n    }\n    console.log(`\\n▶️ Updating Powerhouse dependencies...\\n`);\n    const packageJson = await readPackage();\n\n    if (packageJson.dependencies) {\n      for (const [name, version] of Object.entries(packageJson.dependencies)) {\n        if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const tag = getTagFromVersion(version);\n          const newVersion = await parsePackageVersion({ name, tag });\n          packageJson.dependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    if (packageJson.devDependencies) {\n      for (const [name, version] of Object.entries(\n        packageJson.devDependencies,\n      )) {\n        if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const tag = getTagFromVersion(version);\n          const newVersion = await parsePackageVersion({ name, tag });\n          packageJson.devDependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    if (packageJson.optionalDependencies) {\n      for (const [name, version] of Object.entries(\n        packageJson.optionalDependencies,\n      )) {\n        if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const tag = getTagFromVersion(version);\n          const newVersion = await parsePackageVersion({ name, tag });\n          packageJson.optionalDependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    if (packageJson.peerDependencies) {\n      for (const [name, version] of Object.entries(\n        packageJson.peerDependencies,\n      )) {\n        if (version && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const tag = getTagFromVersion(version);\n          const newVersion = await parsePackageVersion({ name, tag });\n          packageJson.peerDependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    await writePackage(packageJson);\n\n    console.log(chalk.green(`\\n✅ Project updated successfully\\n`));\n\n    if (skipInstall) return;\n\n    const packageManager = await detect();\n\n    if (!packageManager) {\n      throw new Error(\n        `❌ Failed to detect your package manager. Run install manually.`,\n      );\n    }\n    console.log(\n      `▶️ Installing updated dependencies with \\`${packageManager.agent}\\`\\n`,\n    );\n    runCmd(`${packageManager.agent} install`);\n    process.exit(0);\n  },\n});\n","import { debugArgs, runUseLocal } from \"@powerhousedao/shared/clis\";\nimport {\n  boolean,\n  command,\n  flag,\n  option,\n  optional,\n  positional,\n  string,\n} from \"cmd-ts\";\n\nexport const useLocal = command({\n  name: \"use-local\",\n  description:\n    \"Use your local `powerhouse` monorepo dependencies the current project.\",\n  args: {\n    monorepoPathPositional: positional({\n      type: optional(string),\n      displayName: \"monorepo path\",\n      description:\n        \"Path to your local powerhouse monorepo relative to this project\",\n    }),\n    monorepoPathOption: option({\n      type: optional(string),\n      long: \"path\",\n      short: \"p\",\n      description:\n        \"Path to your local powerhouse monorepo relative to this project\",\n    }),\n    skipInstall: flag({\n      type: optional(boolean),\n      long: \"skip-install\",\n      short: \"s\",\n      description: \"Skip running `install` with `pnpm`\",\n    }),\n    ...debugArgs,\n  },\n  handler: async (args) => {\n    const { monorepoPathPositional, monorepoPathOption, skipInstall, debug } =\n      args;\n    if (debug) {\n      console.log({ args });\n    }\n    const monorepoPath = monorepoPathPositional ?? monorepoPathOption;\n\n    if (!monorepoPath) {\n      throw new Error(\n        \"❌ Please provide the path to your local powerhouse monorepo.\",\n      );\n    }\n\n    await runUseLocal(monorepoPath, skipInstall);\n    process.exit(0);\n  },\n});\n","import {\n  debugArgs,\n  handleMutuallyExclusiveOptions,\n  logVersionUpdate,\n  parsePackageVersion,\n  runCmd,\n} from \"@powerhousedao/shared/clis\";\nimport { ALL_POWERHOUSE_DEPENDENCIES } from \"@powerhousedao/shared/constants\";\nimport chalk from \"chalk\";\nimport {\n  boolean,\n  command,\n  flag,\n  oneOf,\n  option,\n  optional,\n  positional,\n  run,\n  string,\n} from \"cmd-ts\";\nimport { detect } from \"package-manager-detector/detect\";\nimport { readPackage } from \"read-pkg\";\nimport { clean, valid } from \"semver\";\nimport { writePackage } from \"write-package\";\n\nexport const use = command({\n  name: \"use\",\n  description: \"Specify the release version of Powerhouse dependencies to use.\",\n  args: {\n    tagPositional: positional({\n      type: optional(oneOf([\"latest\", \"staging\", \"dev\"])),\n      displayName: \"tag\",\n      description: `Specify the release tag to use for your project. Can be one of: \"latest\", \"staging\", or \"dev\".`,\n    }),\n    tagOption: option({\n      type: optional(oneOf([\"latest\", \"staging\", \"dev\"])),\n      long: \"tag\",\n      short: \"t\",\n      description: `Specify the release tag to use for your project. Can be one of: \"latest\", \"staging\", or \"dev\".`,\n    }),\n    version: option({\n      type: optional(string),\n      long: \"version\",\n      short: \"v\",\n      description:\n        \"Specify the exact semver release version to use for your project.\",\n    }),\n    skipInstall: flag({\n      type: optional(boolean),\n      long: \"skip-install\",\n      short: \"s\",\n      description: \"Skip running `install` with your package manager\",\n    }),\n    ...debugArgs,\n  },\n  handler: async (args) => {\n    const { tagPositional, tagOption, version, skipInstall, debug } = args;\n    if (debug) {\n      console.log({ args });\n    }\n    const tag = tagPositional ?? tagOption;\n    handleMutuallyExclusiveOptions({ tag, version }, \"versioning strategy\");\n\n    if (!tag && !version) {\n      throw new Error(\n        \"Please specify either a release tag or a version to use.\",\n      );\n    }\n\n    if (version && !valid(clean(version))) {\n      throw new Error(`❌ Invalid version: ${chalk.bold(version)}`);\n    }\n\n    console.log(\n      `▶️ Updating project to use ${chalk.bold(version ?? tag)}...\\n`,\n    );\n\n    const packageJson = await readPackage();\n\n    if (packageJson.dependencies) {\n      for (const [name, existingVersion] of Object.entries(\n        packageJson.dependencies,\n      )) {\n        if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const newVersion = await parsePackageVersion({ name, tag, version });\n          packageJson.dependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version: existingVersion,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    if (packageJson.devDependencies) {\n      for (const [name, existingVersion] of Object.entries(\n        packageJson.devDependencies,\n      )) {\n        if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const newVersion = await parsePackageVersion({ name, tag, version });\n          packageJson.devDependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version: existingVersion,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    if (packageJson.optionalDependencies) {\n      for (const [name, existingVersion] of Object.entries(\n        packageJson.optionalDependencies,\n      )) {\n        if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const newVersion = await parsePackageVersion({ name, tag, version });\n          packageJson.optionalDependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version: existingVersion,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    if (packageJson.peerDependencies) {\n      for (const [name, existingVersion] of Object.entries(\n        packageJson.peerDependencies,\n      )) {\n        if (existingVersion && ALL_POWERHOUSE_DEPENDENCIES.includes(name)) {\n          const newVersion = await parsePackageVersion({ name, tag, version });\n          packageJson.peerDependencies[name] = newVersion;\n          logVersionUpdate({\n            name,\n            version: existingVersion,\n            newVersion,\n          });\n        }\n      }\n    }\n\n    await writePackage(packageJson);\n\n    console.log(\n      chalk.green(\n        `\\n✅ Project updated to use ${chalk.bold(version ?? tag)}\\n`,\n      ),\n    );\n\n    if (!skipInstall) {\n      const packageManager = await detect();\n      if (!packageManager) {\n        throw new Error(\n          `❌ Failed to detect your package manager. Run install manually.`,\n        );\n      }\n      console.log(\n        `▶️ Installing updated dependencies with \\`${packageManager.agent}\\`\\n`,\n      );\n      runCmd(`${packageManager.agent} install`);\n    }\n\n    process.exit(0);\n  },\n});\n\nexport async function runUse(args: string[]) {\n  await run(use, args);\n}\n","import {\n  getPhCmdVersionInfo,\n  phCliHelpCommands,\n} from \"@powerhousedao/shared/clis\";\nimport { subcommands } from \"cmd-ts\";\nimport { init } from \"./init.js\";\nimport { setupGlobals } from \"./setup-globals.js\";\nimport { update } from \"./update.js\";\nimport { useLocal } from \"./use-local.js\";\nimport { use } from \"./use.js\";\n\ndeclare const CLI_VERSION: string;\nconst phCmdVersionInfo = await getPhCmdVersionInfo(CLI_VERSION);\nexport const ph = subcommands({\n  name: \"ph\",\n  version: phCmdVersionInfo,\n  description:\n    \"The Powerhouse CLI (ph-cmd) is a command-line interface tool that provides essential commands for managing Powerhouse projects.\\nThe tool and it's commands are fundamental for creating, building, and running Document Models as a builder in studio mode.\",\n  cmds: {\n    init,\n    use,\n    update,\n    \"setup-globals\": setupGlobals,\n    \"use-local\": useLocal,\n    ...phCliHelpCommands,\n  },\n});\n"],"mappings":"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"}

package/dist/ph-cli-1NIlwpsP.mjs

@@ -0,0 +1,23 @@
+import { getPowerhouseProjectInfo } from "@powerhousedao/shared/clis";
+import { execSync } from "node:child_process";
+import { resolveCommand } from "package-manager-detector";
+//#region src/ph-cli.ts
+async function executePhCliCommand(phCliCommand) {
+	const forwardedArgs = process.argv.slice(3);
+	const { projectPath, packageManager } = await getPowerhouseProjectInfo();
+	const resolveExecuteLocalCommandResult = resolveCommand(packageManager, "execute-local", [
+		"ph-cli",
+		phCliCommand,
+		...forwardedArgs
+	]);
+	if (!resolveExecuteLocalCommandResult) throw new Error(`Command ${phCliCommand} is not executable by package manager ${packageManager}. Either install "@powerhousedao/ph-cli" in your local package, or run \`ph setup-globals\` to globally install the "@powerhousedao/ph-cli" package.`);
+	const { command, args } = resolveExecuteLocalCommandResult;
+	execSync(`${command} ${args.join(" ")}`, {
+		stdio: "inherit",
+		cwd: projectPath
+	});
+}
+//#endregion
+export { executePhCliCommand };
+
+//# sourceMappingURL=ph-cli-1NIlwpsP.mjs.map

package/dist/ph-cli-1NIlwpsP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ph-cli-1NIlwpsP.mjs","names":[],"sources":["../src/ph-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { getPowerhouseProjectInfo } from \"@powerhousedao/shared/clis\";\nimport { execSync } from \"node:child_process\";\nimport { resolveCommand } from \"package-manager-detector\";\n\nexport async function executePhCliCommand(phCliCommand: string) {\n  const forwardedArgs = process.argv.slice(3);\n  const { projectPath, packageManager } = await getPowerhouseProjectInfo();\n  const resolveExecuteLocalCommandResult = resolveCommand(\n    packageManager,\n    \"execute-local\",\n    [\"ph-cli\", phCliCommand, ...forwardedArgs],\n  );\n  if (!resolveExecuteLocalCommandResult) {\n    throw new Error(\n      `Command ${phCliCommand} is not executable by package manager ${packageManager}. Either install \"@powerhousedao/ph-cli\" in your local package, or run \\`ph setup-globals\\` to globally install the \"@powerhousedao/ph-cli\" package.`,\n    );\n  }\n  const { command, args } = resolveExecuteLocalCommandResult;\n  const cmd = `${command} ${args.join(\" \")}`;\n  execSync(cmd, { stdio: \"inherit\", cwd: projectPath });\n}\n"],"mappings":";;;;AAKA,eAAsB,oBAAoB,cAAsB;CAC9D,MAAM,gBAAgB,QAAQ,KAAK,MAAM,EAAE;CAC3C,MAAM,EAAE,aAAa,mBAAmB,MAAM,0BAA0B;CACxE,MAAM,mCAAmC,eACvC,gBACA,iBACA;EAAC;EAAU;EAAc,GAAG;EAAc,CAC3C;AACD,KAAI,CAAC,iCACH,OAAM,IAAI,MACR,WAAW,aAAa,wCAAwC,eAAe,sJAChF;CAEH,MAAM,EAAE,SAAS,SAAS;AAE1B,UADY,GAAG,QAAQ,GAAG,KAAK,KAAK,IAAI,IAC1B;EAAE,OAAO;EAAW,KAAK;EAAa,CAAC"}

package/dist/run-BJIj5jSO.mjs

@@ -0,0 +1,10 @@
+import { t as ph } from "./ph-CzQLX9vM.mjs";
+import { run as run$1 } from "cmd-ts";
+//#region src/run.ts
+async function run(args) {
+	return await run$1(ph, args);
+}
+//#endregion
+export { run };
+
+//# sourceMappingURL=run-BJIj5jSO.mjs.map

package/dist/run-BJIj5jSO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-BJIj5jSO.mjs","names":["runCmdTs"],"sources":["../src/run.ts"],"sourcesContent":["import { run as runCmdTs } from \"cmd-ts\";\nimport { ph } from \"./commands/ph.js\";\n\nexport async function run(args: string[]) {\n  return await runCmdTs(ph, args);\n}\n"],"mappings":";;;AAGA,eAAsB,IAAI,MAAgB;AACxC,QAAO,MAAMA,MAAS,IAAI,KAAK"}