holycodex 0.7.0 → 0.7.1-dev.29607507877.1

package/dist/cli.js

@@ -7,7 +7,7 @@ import { existsSync } from "node:fs";
 import { pluginRoot } from "@holycodex/plugin";
 import { Buffer } from "node:buffer";
 //#region packages/cli/src/catalog.ts
-var VERSION = "0.7.0";
+var VERSION = "0.7.1-dev.29607507877.1";
 var SKILLS = [
 	"ast-grep",
 	"caveman",
@@ -77,6 +77,7 @@ var GENERATED_RUNTIMES = [
 	"rules.js"
 ];
 var WINDOWS_SHELL_POLICY = "On native Windows, before the first shell action, inspect callable and deferred tools until `mcp__git_bash__run` is resolved. Use it for every shell command, including Git, Bash, POSIX, package, build, test, and script commands. If unavailable, stop and report the blocker. Never fall back to PowerShell or cmd.";
+/** Provides effective mcp servers. */
 function effectiveMcpServers(platform) {
 	return {
 		...platform === "win32" ? { git_bash: {
@@ -96,6 +97,7 @@ function effectiveMcpServers(platform) {
 		}
 	};
 }
+/** Reads and validates d package runtimes. */
 function requiredPackageRuntimes(platform) {
 	return platform === "win32" ? GENERATED_RUNTIMES : GENERATED_RUNTIMES.filter((file) => file !== "git-bash.js");
 }
@@ -105,6 +107,7 @@ var GIT_BASH_ENV_KEY = "HOLYCODEX_GIT_BASH_PATH";
 var PROGRAM_FILES = "C:\\Program Files\\Git\\bin\\bash.exe";
 var PROGRAM_FILES_X86 = "C:\\Program Files (x86)\\Git\\bin\\bash.exe";
 var INVALID_LAUNCHERS = ["\\windows\\system32\\", "\\microsoft\\windowsapps\\"];
+/** Resolves git bash. */
 function resolveGitBash(input) {
 	if (input.platform !== "win32") return {
 		found: true,
@@ -153,6 +156,7 @@ function resolveGitBash(input) {
 	}
 	return missing(checkedPaths);
 }
+/** Resolves git bash for current process. */
 function resolveGitBashForCurrentProcess(input = {}) {
 	return resolveGitBash({
 		platform: input.platform ?? process.platform,
@@ -185,6 +189,7 @@ var defaultManagedProcessRuntime = {
 	terminationGraceMs: 2e3,
 	kill: killProcessTree
 };
+/** Runs managed process. */
 async function runManagedProcess(input, runtime = defaultManagedProcessRuntime) {
 	return await new Promise((resolve) => {
 		const child = spawn(input.command, [...input.args], {
@@ -261,6 +266,7 @@ async function runManagedProcess(input, runtime = defaultManagedProcessRuntime)
 		else child.stdin.end(input.stdin);
 	});
 }
+/** Terminates process tree. */
 function killProcessTree(child, platform, signal = "SIGTERM", runTaskkill = (command, args) => spawnSync(command, [...args], {
 	stdio: "ignore",
 	windowsHide: true
@@ -303,6 +309,7 @@ function outputText(state) {
 //#endregion
 //#region packages/cli/src/toml.ts
 var TOML_TABLE = /^[ \t]*(?:\[[^\]\r\n]+\]|\[\[[^\]\r\n]+\]\])[ \t]*(?:#.*)?$/m;
+/** Reads a root TOML string value. */
 function rootTomlString(input, key) {
 	const table = TOML_TABLE.exec(input);
 	const root = table === null ? input : input.slice(0, table.index);
@@ -316,9 +323,11 @@ function rootTomlString(input, key) {
 		return;
 	}
 }
+/** Reads a root TOML string array. */
 function rootTomlStringArray(input, key) {
 	return parseRootTomlStringArray(input, key)?.items;
 }
+/** Reads the source text of a root TOML string array. */
 function rootTomlStringArraySource(input, key) {
 	return parseRootTomlStringArray(input, key)?.source;
 }
@@ -473,6 +482,7 @@ function autonomy(config) {
 	if (approval === "never" && sandbox === "danger-full-access") return "dangerous";
 	return "unknown";
 }
+/** Runs HolyCodex installation and environment health checks. */
 async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex"), runtime = defaultRuntime$1) {
 	const checks = [];
 	const pluginRoot = join(home, "plugins", "cache", "holycodex", "holycodex", VERSION);
@@ -500,12 +510,12 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 	for (const name of requiredMcps) {
 		const configured = servers?.[name];
 		const expected = expectedMcps[name];
-		checks.push(configured === void 0 ? check(`mcp-${name}`, "error", "missing-required-mcp", `${name} is not configured.`, "Reinstall HolyCodex.") : !mcpConfigMatches(configured, expected) ? check(`mcp-${name}`, "error", "invalid-required-mcp-config", `${name} configuration is stale or contains unsupported settings.`, "Reinstall HolyCodex.") : check(`mcp-${name}`, "ok", "required-mcp-ready", `${name} is configured locally.`));
+		checks.push(configured === void 0 || expected === void 0 ? check(`mcp-${name}`, "error", "missing-required-mcp", `${name} is not configured.`, "Reinstall HolyCodex.") : !mcpConfigMatches(configured, expected) ? check(`mcp-${name}`, "error", "invalid-required-mcp-config", `${name} configuration is stale or contains unsupported settings.`, "Reinstall HolyCodex.") : check(`mcp-${name}`, "ok", "required-mcp-ready", `${name} is configured locally.`));
 	}
 	const gitBashConfig = servers?.git_bash;
 	if (runtime.platform === "win32" && gitBashConfig !== void 0) {
 		const expected = effectiveMcpServers("win32").git_bash;
-		checks.push(mcpConfigMatches(gitBashConfig, expected) ? check("mcp-git_bash-config", "ok", "git-bash-mcp-config-ready", "Git Bash MCP exposes only run through the supported allowlist.") : check("mcp-git_bash-config", "error", "invalid-git-bash-mcp-config", "Git Bash MCP command or enabled_tools configuration is stale.", "Reinstall HolyCodex."));
+		checks.push(expected !== void 0 && mcpConfigMatches(gitBashConfig, expected) ? check("mcp-git_bash-config", "ok", "git-bash-mcp-config-ready", "Git Bash MCP exposes only run through the supported allowlist.") : check("mcp-git_bash-config", "error", "invalid-git-bash-mcp-config", "Git Bash MCP command or enabled_tools configuration is stale.", "Reinstall HolyCodex."));
 	} else if (runtime.platform !== "win32" && gitBashConfig !== void 0) checks.push(check("mcp-git_bash-config", "error", "unexpected-git-bash-mcp", "Git Bash MCP must not be installed on non-Windows platforms.", "Reinstall HolyCodex for this platform."));
 	const context7 = servers?.context7;
 	const expectedContext7 = effectiveMcpServers(runtime.platform).context7;
@@ -518,7 +528,7 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 	if (context7 === void 0) checks.push(check("context7-config", "error", "missing-context7", "Context7 is not configured.", "Reinstall HolyCodex."));
 	else if (typeof context7.url === "string") checks.push(check("context7-config", "error", "obsolete-context7-remote", "Context7 still uses a hosted URL.", "Reinstall to use local bunx Context7."));
 	else if (obsoleteAuth) checks.push(check("context7-config", "error", "obsolete-context7-auth", "Context7 contains obsolete authentication settings.", "Remove auth settings and reinstall."));
-	else if (!mcpConfigMatches(context7, expectedContext7)) checks.push(check("context7-config", "error", "invalid-context7-config", "Context7 launch configuration is stale or contains unsupported settings.", "Repair .mcp.json or reinstall."));
+	else if (expectedContext7 === void 0 || !mcpConfigMatches(context7, expectedContext7)) checks.push(check("context7-config", "error", "invalid-context7-config", "Context7 launch configuration is stale or contains unsupported settings.", "Repair .mcp.json or reinstall."));
 	else checks.push(check("context7-config", "ok", "local-context7-config", "Local no-auth Context7 is configured."));
 	const bun = await runtime.command("bun", ["--version"]);
 	const bunx = await runtime.command("bunx", ["--version"]);
@@ -589,6 +599,7 @@ var OLD_NAMESPACES = [
 	"hooks.state.\"omo@lazycodex",
 	"hooks.state.\"omo@code-yeongyu-codex-plugins"
 ];
+/** Removes managed. */
 function removeManaged(input) {
 	const escapedStart = START.replaceAll(">", "\\>");
 	const escapedEnd = END.replaceAll("<", "\\<");
@@ -599,6 +610,7 @@ function removeManaged(input) {
 		return tableKey === void 0 ? "" : `${Buffer.from(tableKey, "base64").toString("utf8")}\n`;
 	}).trim();
 }
+/** Removes legacy omo. */
 function removeLegacyOmo(input) {
 	return input.split(/(?=^\s*\[)/m).filter((section) => {
 		const header = /^\s*\[([^\]]+)]/.exec(section)?.[1];
@@ -662,6 +674,7 @@ function mergedStatusLine(original) {
 	if (!items.includes("context-remaining")) items.push("context-remaining");
 	return `[${items.map((item) => JSON.stringify(item)).join(", ")}]`;
 }
+/** Installs config. */
 function installConfig(input, mode, _platform) {
 	const base = preserveManagedRootPreferences(input, removeLegacyOmo(removeManaged(input)));
 	const firstTable = base.search(/^\s*\[/m);
@@ -695,6 +708,7 @@ function installConfig(input, mode, _platform) {
 }
 //#endregion
 //#region packages/cli/src/files.ts
+/** Provides exists. */
 async function exists(path) {
 	try {
 		await stat(path);
@@ -704,6 +718,7 @@ async function exists(path) {
 		throw error;
 	}
 }
+/** Provides backup. */
 async function backup(path, root) {
 	if (!await exists(path)) return void 0;
 	const target = join(root, path.replace(/^([A-Za-z]:)?[\\/]+/, "").replaceAll(":", ""));
@@ -724,12 +739,14 @@ async function copyBackup(source, target) {
 	await mkdir(target, { recursive: true });
 	for (const entry of await readdir(source)) await copyBackup(join(source, entry), join(target, entry));
 }
+/** Provides atomic write. */
 async function atomicWrite(path, content) {
 	await mkdir(dirname(path), { recursive: true });
 	const temporary = `${path}.${process.pid}.tmp`;
 	await writeFile(temporary, content, "utf8");
 	await rename(temporary, path);
 }
+/** Reads text. */
 async function readText(path) {
 	return await exists(path) ? readFile(path, "utf8") : "";
 }
@@ -759,10 +776,12 @@ function paths(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")) {
 function backupRoot() {
 	return join(tmpdir(), "holycodex-backups", (/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-"));
 }
+/** Validates git bash ready. */
 function assertGitBashReady(platform, resolution) {
 	if (platform !== "win32") return;
 	if (!resolution.found) throw new Error(resolution.installHint);
 }
+/** Provides install. */
 async function install(options, runtime = defaultRuntime) {
 	assertGitBashReady(runtime.platform, runtime.gitBash());
 	const target = paths();
@@ -846,6 +865,7 @@ async function writePlatformAgents(root, platform) {
 		await atomicWrite(path, (await readText(path)).replace(`${WINDOWS_SHELL_POLICY}\r\n\r\n`, "").replace(`${WINDOWS_SHELL_POLICY}\n\n`, ""));
 	}));
 }
+/** Provides cleanup. */
 async function cleanup(_options) {
 	const target = paths();
 	const root = backupRoot();
@@ -893,18 +913,22 @@ var DIM = "\x1B[2m";
 function paint(enabled, code, text) {
 	return enabled ? `${code}${text}${RESET}` : text;
 }
+/** Checks whether terminal color output is supported. */
 function supportsColor(isTTY, noColor) {
 	return isTTY === true && noColor === void 0;
 }
+/** Renders help. */
 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  -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`;
 }
+/** Renders error. */
 function renderError(message, color) {
 	return `${paint(color, `${BOLD}${RED}`, "✗ ERROR")}  ${message}\n  ${paint(color, DIM, "Run holycodex --help for usage.")}\n`;
 }
+/** Renders doctor. */
 function renderDoctor(result, color) {
 	return `${result.healthy ? paint(color, GREEN, "✓ HolyCodex doctor: healthy") : paint(color, RED, "✗ HolyCodex doctor: issues found")}\n${result.checks.map((item) => {
 		const label = item.status.toUpperCase().padEnd(7);
@@ -912,9 +936,11 @@ function renderDoctor(result, color) {
 		return item.fix === void 0 ? line : `${line}\n           ${paint(color, DIM, `Fix: ${item.fix}`)}`;
 	}).join("\n")}\n`;
 }
+/** Renders run result. */
 function renderRunResult(result, color) {
 	return `${paint(color, GREEN, `✓ HolyCodex ${result.action} complete`)}\n  Changed: ${result.changed.length}\n  Backups: ${result.backups.length}\n`;
 }
+/** Renders notice. */
 function renderNotice(kind, message, color) {
 	return `${paint(color, kind === "warning" ? RED : YELLOW, `! ${kind === "warning" ? "WARNING" : "NOTICE"}`)}  ${message}\n`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.7.0",
+  "version": "0.7.1-dev.29607507877.1",
   "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.7.0"
+    "@holycodex/plugin": "0.7.1-dev.29607507877.1"
   },
   "engines": {
     "node": ">=20"