holycodex 0.11.2 → 0.11.3

package/README.md

@@ -11,6 +11,8 @@ Use `holycodex --help` for commands, autonomy options, routing plans, and servic
 
 On a fresh installation, omitting autonomy flags seeds Codex Approve for me semantics: `approval_policy = "on-request"`, `approvals_reviewer = "auto_review"`, and `sandbox_mode = "workspace-write"`. On an existing installation, omitting autonomy flags preserves the complete current permission selection. `--no-codex-autonomous`, `--codex-autonomous`, and `--dangerous-codex-autonomous` explicitly replace that selection with their documented modes. HolyCodex never generates `default_permissions` or selects a named permission profile.
 
-Install also attempts to add or enable the official `codex-security@openai-curated` plugin through structured Codex CLI commands. If no global Codex CLI is available, HolyCodex can use the active Bun executable or a supported npm/pnpm package runner. External availability failures are non-fatal and reported in human and JSON results. Cleanup leaves this independent official plugin installed. Build Web Apps remains separately managed by Codex.
+Install also attempts to add or enable the official `codex-security@openai-curated` and `computer-use@openai-bundled` plugins through structured Codex CLI commands. If no global Codex CLI is available, HolyCodex can use the active Bun executable or a supported npm/pnpm package runner. External availability failures are non-fatal and reported in human and JSON results. Cleanup leaves these independent official plugins installed. Build Web Apps remains separately managed by Codex.
+
+Human-readable installs show each step as it completes. Use `-v` or `--verbose` for launcher, backup, plan, and plugin-state details; `--json` remains progress-free and machine-readable.
 
 Repository, documentation, license, and security notices: https://github.com/davidbasilefilho/holycodex

package/dist/cli.js

@@ -4080,7 +4080,7 @@ function superRefine(fn, params) {
 }
 //#endregion
 //#region packages/cli/src/catalog.ts
-var VERSION = "0.11.2";
+var VERSION = "0.11.3";
 var SKILLS = [
 	"ast-grep",
 	"babysit-ci",
@@ -4588,7 +4588,8 @@ var INSTALL_FLAGS = /* @__PURE__ */ new Set([
 	"--fast",
 	"--fast-all",
 	"--no-fast",
-	"--json"
+	"--json",
+	"--verbose"
 ]);
 var SHARED_FLAGS = /* @__PURE__ */ new Set(["--json"]);
 /** Strictly parses command-specific HolyCodex CLI arguments. */
@@ -4611,6 +4612,12 @@ function parseCliArguments(args) {
 	const values = /* @__PURE__ */ new Map();
 	for (let index = 1; index < args.length; index += 1) {
 		const token = args[index];
+		if (token === "-v") {
+			if (!allowed.has("--verbose")) throw new Error(`Option -v is not valid for ${command}.`);
+			if (values.has("--verbose")) throw new Error("Repeated option: --verbose");
+			values.set("--verbose", true);
+			continue;
+		}
 		if (token === void 0 || !token.startsWith("--")) throw new Error(`Unexpected positional argument: ${token ?? ""}`);
 		const separator = token.indexOf("=");
 		const name = separator < 0 ? token : token.slice(0, separator);
@@ -4660,7 +4667,8 @@ function parseCliArguments(args) {
 		plan: plan.data,
 		...maxValue === void 0 ? {} : { maxSubagents: Number(maxValue) },
 		autonomy,
-		fast
+		fast,
+		verbose: values.has("--verbose")
 	};
 }
 function base(action) {
@@ -4669,7 +4677,8 @@ function base(action) {
 		json: false,
 		plan: DEFAULT_PLAN,
 		autonomy: { requested: false },
-		fast: "standard"
+		fast: "standard",
+		verbose: false
 	};
 }
 //#endregion
@@ -5743,8 +5752,14 @@ function deduplicate(candidates) {
 }
 //#endregion
 //#region packages/cli/src/codex-security.ts
-var CODEX_SECURITY_PLUGIN = "codex-security@openai-curated";
-var CODEX_SECURITY_MARKETPLACE = "openai-curated";
+var CODEX_SECURITY_PLUGIN = {
+	id: "codex-security@openai-curated",
+	marketplace: "openai-curated"
+};
+var COMPUTER_USE_PLUGIN = {
+	id: "computer-use@openai-bundled",
+	marketplace: "openai-bundled"
+};
 var CODEX_PLUGIN_OPERATIONAL_TIMEOUT_MS = 15e3;
 var CODEX_PACKAGE_BOOTSTRAP_TIMEOUT_MS = 12e4;
 var MAX_CODEX_CATALOG_DIAGNOSTIC_CHARS = 256 * 1024;
@@ -5785,6 +5800,14 @@ var FATAL_POLICY_CODES = /* @__PURE__ */ new Set([
 ]);
 /** Installs or enables the official Codex Security plugin without failing HolyCodex installation. */
 async function installCodexSecurity(runProcess = runManagedProcess, platform = process.platform, env = process.env, options = {}) {
+	return installOfficialPlugin(CODEX_SECURITY_PLUGIN, runProcess, platform, env, options);
+}
+/** Installs or enables the official Computer Use plugin without failing HolyCodex installation. */
+async function installComputerUse(runProcess = runManagedProcess, platform = process.platform, env = process.env, options = {}) {
+	return installOfficialPlugin(COMPUTER_USE_PLUGIN, runProcess, platform, env, options);
+}
+/** Installs or enables one official Codex plugin through a verified catalog entry. */
+async function installOfficialPlugin(plugin, runProcess = runManagedProcess, platform = process.platform, env = process.env, options = {}) {
 	const runtimeFacts = options.runtimeFacts ?? (runProcess === runManagedProcess ? defaultCodexLauncherRuntimeFacts(platform) : void 0);
 	const candidates = createCodexLauncherCandidates({
 		...options.injected === void 0 ? {} : { injected: options.injected },
@@ -5804,7 +5827,7 @@ async function installCodexSecurity(runProcess = runManagedProcess, platform = p
 			continue;
 		}
 		if (installedOutcome.kind === "fatal") return skipped(installedOutcome.reason, attemptedLaunchers);
-		const installedPlugin = findPlugin(installedOutcome.catalog);
+		const installedPlugin = findPlugin(installedOutcome.catalog, plugin.id);
 		if (installedPlugin?.installed === true && installedPlugin.enabled === true) return {
 			status: "already-installed",
 			launcherSource: launcher.source
@@ -5822,7 +5845,7 @@ async function installCodexSecurity(runProcess = runManagedProcess, platform = p
 				continue;
 			}
 			if (catalogOutcome.kind === "fatal") return skipped(catalogOutcome.reason, attemptedLaunchers);
-			if (findPlugin(catalogOutcome.catalog) === void 0) {
+			if (findPlugin(catalogOutcome.catalog, plugin.id) === void 0) {
 				const marketplaceOutcome = inspectMarketplaceResult(await runCodexPlugin(runProcess, launcher, [
 					"plugin",
 					"marketplace",
@@ -5834,14 +5857,14 @@ async function installCodexSecurity(runProcess = runManagedProcess, platform = p
 					continue;
 				}
 				if (marketplaceOutcome.kind === "fatal") return skipped(marketplaceOutcome.reason, attemptedLaunchers);
-				fallbackReasons.push(marketplaceOutcome.marketplaces.includes(CODEX_SECURITY_MARKETPLACE) ? "plugin-not-offered" : "marketplace-unavailable");
+				fallbackReasons.push(marketplaceOutcome.marketplaces.includes(plugin.marketplace) ? "plugin-not-offered" : "marketplace-unavailable");
 				continue;
 			}
 		}
 		const addOutcome = inspectAddResult(await runCodexPlugin(runProcess, launcher, [
 			"plugin",
 			"add",
-			CODEX_SECURITY_PLUGIN,
+			plugin.id,
 			"--json"
 		], platform, env, "add"), launcher);
 		if (addOutcome.kind === "fallback") {
@@ -5859,7 +5882,7 @@ async function installCodexSecurity(runProcess = runManagedProcess, platform = p
 			continue;
 		}
 		if (verification.kind === "fatal") return skipped(verification.reason, attemptedLaunchers);
-		const verifiedPlugin = findPlugin(verification.catalog);
+		const verifiedPlugin = findPlugin(verification.catalog, plugin.id);
 		if (verifiedPlugin?.installed !== true || verifiedPlugin.enabled !== true) {
 			fallbackReasons.push("verification-failed");
 			continue;
@@ -5946,8 +5969,8 @@ function inspectMarketplaceResult(result, launcher) {
 		marketplaces
 	};
 }
-function findPlugin(catalog) {
-	return catalog.plugins.find(({ id }) => id === CODEX_SECURITY_PLUGIN);
+function findPlugin(catalog, pluginId) {
+	return catalog.plugins.find(({ id }) => id === pluginId);
 }
 function classifyFailure(result, launcher) {
 	if (result.error !== void 0) {
@@ -6313,10 +6336,13 @@ function assertGitBashReady(platform, resolution) {
 }
 /** Provides install. */
 async function install(options, runtime = defaultRuntime) {
+	notify(options, "prerequisites", "Checking prerequisites", "running");
 	assertGitBashReady(runtime.platform, runtime.gitBash());
+	notify(options, "prerequisites", "Checking prerequisites", "complete");
 	const plan = options.plan ?? "plus";
 	const target = paths();
 	const root = backupRoot();
+	notify(options, "backup", "Backing up existing installation", "running");
 	const configBackup = await backup(target.config, root);
 	const cacheBackup = await backup(target.marketplaceCache, root);
 	const agentsBackup = await backup(target.agents, root);
@@ -6326,10 +6352,14 @@ async function install(options, runtime = defaultRuntime) {
 		agentsBackup,
 		...await Promise.all(target.legacy.map((path) => backup(path, root)))
 	].filter((path) => path !== void 0);
+	notify(options, "backup", "Backing up existing installation", "complete", `${backups.length} saved`);
+	notify(options, "configuration", "Preparing configuration", "running");
 	const existingConfig = await readText(target.config);
 	const previousPlan = readManagedPlan(existingConfig);
 	const fastMode = options.fast ?? "standard";
 	const config = installConfig(existingConfig, options.autonomy, runtime.platform, plan, options.maxSubagents, fastMode);
+	notify(options, "configuration", "Preparing configuration", "complete", plan);
+	notify(options, "staging", "Staging plugin and agent files", "running");
 	const existingAgentPreferences = await readAgentPreferences(target.agents, previousPlan);
 	const staging = await mkdtemp(join(tmpdir(), "holycodex-stage-"));
 	const stagedCache = join(staging, "cache");
@@ -6339,10 +6369,15 @@ async function install(options, runtime = defaultRuntime) {
 	await cp(join(pluginRoot, "agents"), stagedAgents, { recursive: true });
 	await writeInstalledAgents(stagedAgents, runtime.platform, plan, fastMode);
 	await preserveAgentPreferences(stagedAgents, existingAgentPreferences, plan, fastMode);
+	notify(options, "staging", "Staging plugin and agent files", "complete");
+	notify(options, "validation", "Validating staged installation", "running");
 	await validateStaging(stagedCache, stagedAgents);
+	notify(options, "validation", "Validating staged installation", "complete");
 	const removedLegacy = [];
 	let codexSecurity;
+	let computerUse;
 	try {
+		notify(options, "managed-files", "Installing managed files", "running");
 		await atomicWrite(target.config, config);
 		await rm(target.cache, {
 			recursive: true,
@@ -6360,8 +6395,16 @@ async function install(options, runtime = defaultRuntime) {
 			await rm(path, { recursive: true });
 			removedLegacy.push(path);
 		}
+		notify(options, "managed-files", "Installing managed files", "complete");
+		notify(options, "codex-security", "Installing Codex Security", "running");
 		codexSecurity = await installCodexSecurity(runtime.runProcess, runtime.platform, process.env);
+		notify(options, "codex-security", "Installing Codex Security", "complete", pluginProgressDetail(codexSecurity));
+		notify(options, "computer-use", "Installing Computer Use", "running");
+		computerUse = await installComputerUse(runtime.runProcess, runtime.platform, process.env);
+		notify(options, "computer-use", "Installing Computer Use", "complete", pluginProgressDetail(computerUse));
+		notify(options, "cleanup", "Removing obsolete caches", "running");
 		await removeObsoleteVersionCaches(target.cacheRoot);
+		notify(options, "cleanup", "Removing obsolete caches", "complete");
 	} catch (error) {
 		await restoreTarget(target.config, configBackup);
 		await restoreTarget(target.marketplaceCache, cacheBackup);
@@ -6385,9 +6428,22 @@ async function install(options, runtime = defaultRuntime) {
 		backups,
 		plan,
 		codexSecurity,
+		computerUse,
 		...options.maxSubagents === void 0 ? {} : { maxSubagents: options.maxSubagents }
 	};
 }
+function notify(options, step, label, status, detail) {
+	options.onProgress?.({
+		step,
+		label,
+		status,
+		...detail === void 0 ? {} : { detail }
+	});
+}
+function pluginProgressDetail(result) {
+	if (result.status === "skipped") return `skipped: ${result.reason}`;
+	return result.launcherSource === void 0 ? result.status : `${result.status} via ${result.launcherSource}`;
+}
 async function validateStaging(cache, agents) {
 	const required = [
 		join(cache, ".codex-plugin", "plugin.json"),
@@ -6408,7 +6464,7 @@ async function restoreTarget(target, source) {
 }
 async function removeObsoleteVersionCaches(cacheRoot) {
 	if (!await exists(cacheRoot)) return;
-	for (const entry of await readdir(cacheRoot)) if (entry !== "0.11.2") await rm(join(cacheRoot, entry), {
+	for (const entry of await readdir(cacheRoot)) if (entry !== "0.11.3") await rm(join(cacheRoot, entry), {
 		recursive: true,
 		force: true
 	});
@@ -6577,17 +6633,21 @@ function renderHelp(version, color) {
 	const title = paint(color, `${BOLD}${CYAN}`, `HolyCodex ${version}`);
 	const section = (text) => paint(color, BOLD, text);
 	const muted = (text) => paint(color, DIM, text);
-	return `${title}\n${muted("Lean Codex toolkit installer and doctor")}\n\n${section("USAGE")}\n  holycodex <command> [options]\n\n${section("COMMANDS")}\n  install                         Install or update HolyCodex\n  cleanup                         Remove HolyCodex-owned state\n  doctor                          Diagnose installation and runtime\n\n${section("OPTIONS")}\n  --plan <plan>                   Model routing plan for install: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --max-subagents <count>          Override concurrent direct subagents for install\n  --fast                          Use Fast for generated subagents only\n  --fast-all                      Use Fast for Root and generated subagents\n  --no-fast                       Use Standard for Root and generated subagents\n  -h, --help                      Show help\n  -v, --version                   Show version\n  --no-tui                        Accepted; commands remain noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  --json                          Print machine-readable output\n`;
+	return `${title}\n${muted("Lean Codex toolkit installer and doctor")}\n\n${section("USAGE")}\n  holycodex <command> [options]\n\n${section("COMMANDS")}\n  install                         Install or update HolyCodex\n  cleanup                         Remove HolyCodex-owned state\n  doctor                          Diagnose installation and runtime\n\n${section("OPTIONS")}\n  --plan <plan>                   Model routing plan for install: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --max-subagents <count>          Override concurrent direct subagents for install\n  --fast                          Use Fast for generated subagents only\n  --fast-all                      Use Fast for Root and generated subagents\n  --no-fast                       Use Standard for Root and generated subagents\n  -h, --help                      Show help\n  -v, --version                   Show version\n  --no-tui                        Accepted; commands remain noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  install --verbose              Show detailed install steps
+  --json                          Print machine-readable output\n`;
 }
 /** Renders install-specific model plan and option help. */
 function renderInstallHelp(version, color) {
 	const title = paint(color, `${BOLD}${CYAN}`, `HolyCodex ${version}`);
 	const section = (text) => paint(color, BOLD, text);
-	return `${title}\n\n${section("Usage:")}\n  holycodex install [options]\n\n${section("Options:")}\n  --plan <plan>                   Model routing plan: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --max-subagents <count>          Override concurrent direct subagents\n  --fast                          Use Fast for generated subagents only\n  --fast-all                      Use Fast for Root and generated subagents\n  --no-fast                       Use Standard for Root and generated subagents\n  --json                          Print machine-readable output\n  --no-tui                        Accepted; install remains noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  -h, --help                      Show help\n\nPlans provide increasing expected model usage and capability. Fast flags are mutually exclusive.\n\n${section("Examples:")}\n  bunx holycodex install\n  bunx holycodex install --plan go\n  bunx holycodex install --plan plus-low --fast\n  bunx holycodex install --plan plus-high\n  bunx holycodex install --plan pro-5x --fast-all\n  bunx holycodex install --plan pro-20x --no-fast\n`;
+	return `${title}\n\n${section("Usage:")}\n  holycodex install [options]\n\n${section("Options:")}\n  --plan <plan>                   Model routing plan: ${PLAN_HELP}\n                                   Default: ${DEFAULT_PLAN}\n  --max-subagents <count>          Override concurrent direct subagents\n  --fast                          Use Fast for generated subagents only\n  --fast-all                      Use Fast for Root and generated subagents\n  --no-fast                       Use Standard for Root and generated subagents\n  -v, --verbose                   Show detailed install steps
+  --json                          Print machine-readable output\n  --no-tui                        Accepted; install remains noninteractive\n  --codex-autonomous              Never ask; keep workspace sandbox\n  --no-codex-autonomous           Safe interactive defaults\n  --dangerous-codex-autonomous    Never ask; disable filesystem sandbox\n  -h, --help                      Show help\n\nPlans provide increasing expected model usage and capability. Fast flags are mutually exclusive.\n\n${section("Examples:")}\n  bunx holycodex install\n  bunx holycodex install --plan go\n  bunx holycodex install --plan plus-low --fast\n  bunx holycodex install --plan plus-high\n  bunx holycodex install --plan pro-5x --fast-all\n  bunx holycodex install --plan pro-20x --no-fast\n`;
 }
 /** Renders error. */
 function renderError(message, color) {
-	return `${paint(color, `${BOLD}${RED}`, "✗ ERROR")}  ${message}\n  ${paint(color, DIM, "Run holycodex --help for usage.")}\n`;
+	const label = paint(color, `${BOLD}${RED}`, "✗ ERROR");
+	const hint = paint(color, DIM, "Run holycodex --help for usage.");
+	return `${color ? "\r\x1B[2K" : ""}${label}  ${message}\n  ${hint}\n`;
 }
 /** Renders doctor. */
 function renderDoctor(result, color) {
@@ -6603,14 +6663,17 @@ function renderRunResult(result, color) {
 	const action = result.action === "install" ? "Updated" : "Removed";
 	const empty = result.action === "install" ? "changes" : "removal";
 	const backup = result.backups.length === 0 ? "" : `\n  Existing HolyCodex files were backed up before ${result.action === "install" ? "replacement" : "cleanup"}.`;
-	return `${title}\n  ${result.changed.length === 0 ? `No HolyCodex-managed files needed ${empty}.` : `${action} HolyCodex configuration, plugin files, and agent profiles.`}${backup}${renderCodexSecurity(result)}\n`;
+	return `${title}\n  ${result.changed.length === 0 ? `No HolyCodex-managed files needed ${empty}.` : `${action} HolyCodex configuration, plugin files, and agent profiles.`}${backup}${renderOfficialPlugins(result)}\n`;
+}
+function renderOfficialPlugins(result) {
+	return [renderOfficialPlugin("Codex Security", result.codexSecurity), renderOfficialPlugin("Computer Use", result.computerUse)].join("");
 }
-function renderCodexSecurity(result) {
-	if (result.codexSecurity === void 0) return "";
-	if (result.codexSecurity.status === "installed") return "\n  Installed official Codex Security plugin.";
-	if (result.codexSecurity.status === "enabled") return "\n  Enabled existing official Codex Security plugin.";
-	if (result.codexSecurity.status === "already-installed") return "\n  Official Codex Security plugin is already installed and enabled.";
-	return `\n  Skipped official Codex Security plugin: ${CODEX_SECURITY_SKIP_MESSAGES[result.codexSecurity.reason]}`;
+function renderOfficialPlugin(name, plugin) {
+	if (plugin === void 0) return "";
+	if (plugin.status === "installed") return `\n  Installed official ${name} plugin.`;
+	if (plugin.status === "enabled") return `\n  Enabled existing official ${name} plugin.`;
+	if (plugin.status === "already-installed") return `\n  Official ${name} plugin is already installed and enabled.`;
+	return `\n  Skipped official ${name} plugin: ${CODEX_SECURITY_SKIP_MESSAGES[plugin.reason]}`;
 }
 var CODEX_SECURITY_SKIP_MESSAGES = {
 	"codex-unavailable": "no usable Codex launcher was found.",
@@ -6626,6 +6689,13 @@ var CODEX_SECURITY_SKIP_MESSAGES = {
 	unsupported: "the available Codex launchers do not support plugin installation.",
 	"download-failed": "the latest Codex package could not be downloaded."
 };
+/** Renders one concise installation progress transition. */
+function renderInstallProgress(event, color, isTTY, verbose) {
+	const detail = verbose && event.detail !== void 0 ? `  ${paint(color, DIM, event.detail)}` : "";
+	if (event.status === "running") return isTTY ? `\r${paint(color, CYAN, "●")} ${event.label}` : "";
+	const line = `${paint(color, GREEN, "✓")} ${event.label}${detail}`;
+	return isTTY ? `\r\u001B[2K${line}\n` : `  ${line}\n`;
+}
 /** Renders notice. */
 function renderNotice(kind, message, color) {
 	return `${paint(color, kind === "warning" ? RED : YELLOW, `! ${kind === "warning" ? "WARNING" : "NOTICE"}`)}  ${message}\n`;
@@ -6649,6 +6719,8 @@ async function main() {
 		fast: parsed.fast,
 		json: parsed.json,
 		plan: parsed.plan,
+		verbose: parsed.verbose,
+		...parsed.command === "install" && !parsed.json ? { onProgress: (event) => process$1.stdout.write(renderInstallProgress(event, stdoutColor, process$1.stdout.isTTY === true, parsed.verbose)) } : {},
 		...parsed.maxSubagents === void 0 ? {} : { maxSubagents: parsed.maxSubagents }
 	};
 	if (parsed.command === "doctor") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "Lean Codex-only agent toolkit installer and doctor",
   "keywords": [
     "agents",
@@ -39,7 +39,7 @@
     "prepack": "vp run --workspace-root build"
   },
   "dependencies": {
-    "@holycodex/plugin": "0.11.2",
+    "@holycodex/plugin": "0.11.3",
     "zod": "^4.4.3"
   },
   "engines": {