holycodex 0.7.4 → 0.8.0

package/THIRD-PARTY-NOTICES.md

@@ -9,3 +9,5 @@ The caveman communication concept is adapted from [juliusbrussee/caveman](https:
 HolyCodex agent routing and orchestration instructions adapt bounded-role, task-ownership, non-overlapping-write, session-reuse, and verification-planning concepts from [alvinunreal/oh-my-opencode-slim](https://github.com/alvinunreal/oh-my-opencode-slim) at commit `7bc7b56856ee693812d87d68615757d4d1c2e218`, principally `src/agents/{orchestrator,explorer,librarian,fixer}.ts`, `src/skills/verification-planning/SKILL.md`, and `docs/background-orchestration.md`. OpenCode runtime APIs, hooks, council, ACP, companion, and background-session mechanics were not copied. Upstream material is MIT licensed; its license is preserved in `packages/plugin/plugin/LICENSE-OH-MY-OPENCODE-SLIM-MIT.txt`.
 
 The bundled LSP runtime at `packages/plugin/plugin/runtime/lsp.js` is derived from `code-yeongyu/oh-my-openagent`'s `lsp-tools-mcp`. Copyright (c) 2026 Yeongyu Kim; used under the MIT License preserved at `packages/plugin/plugin/runtime/LICENSE-LSP-MIT.txt`.
+
+The `codexslimedit` package and HolyCodex integration adapt compact-read and line-range edit behavior from [ASidorenkoCode/openslimedit](https://github.com/ASidorenkoCode/openslimedit) at commit `d5014929d6f66729b887df74a65ed6d22c3b522b`. Copyright (c) 2026 Artur; used under the MIT License preserved in both published packages. OpenCode hook APIs and token-saving claims were not copied.

package/dist/cli.js

@@ -1,8 +1,8 @@
 import process$1 from "node:process";
+import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { access, copyFile, cp, lstat, mkdir, readFile, readdir, readlink, rename, rm, stat, writeFile } from "node:fs/promises";
 import { homedir, tmpdir } from "node:os";
 import { dirname, join } from "node:path";
-import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { Buffer } from "node:buffer";
 import { pluginRoot } from "@holycodex/plugin";
@@ -3924,8 +3924,170 @@ function superRefine(fn, params) {
 	return /* @__PURE__ */ _superRefine(fn, params);
 }
 //#endregion
+//#region packages/mcp-stdio-core/src/process.ts
+var TRUNCATED_MARKER = "\n... diagnostic output truncated ...\n";
+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], {
+			...input.cwd === void 0 ? {} : { cwd: input.cwd },
+			...input.env === void 0 ? {} : { env: input.env },
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			windowsHide: true,
+			detached: input.platform !== "win32"
+		});
+		let stdout = {
+			head: "",
+			tail: "",
+			truncated: false
+		};
+		let stderr = {
+			head: "",
+			tail: "",
+			truncated: false
+		};
+		let timedOut = false;
+		let matched = false;
+		let settled = false;
+		let forceKillTimeout;
+		const finish = (exitCode, error) => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timeout);
+			if (forceKillTimeout !== void 0) clearTimeout(forceKillTimeout);
+			resolve({
+				exitCode,
+				stdout: outputText(stdout),
+				stderr: outputText(stderr),
+				timedOut,
+				matched,
+				outputTruncated: stdout.truncated || stderr.truncated,
+				...error === void 0 ? {} : { error }
+			});
+		};
+		const terminate = () => {
+			if (forceKillTimeout !== void 0) return;
+			runtime.kill(child, input.platform, "SIGTERM");
+			forceKillTimeout = setTimeout(() => {
+				runtime.kill(child, input.platform, "SIGKILL");
+			}, runtime.terminationGraceMs);
+			forceKillTimeout.unref();
+		};
+		const inspectMatch = () => {
+			if (matched || input.matchOutput === void 0) return;
+			if (input.matchOutput(`${outputText(stdout)}\n${outputText(stderr)}`)) {
+				matched = true;
+				terminate();
+			}
+		};
+		child.stdout.on("data", (chunk) => {
+			stdout = appendOutput(stdout, chunk.toString(), input.maxOutputChars);
+			inspectMatch();
+		});
+		child.stderr.on("data", (chunk) => {
+			stderr = appendOutput(stderr, chunk.toString(), input.maxOutputChars);
+			inspectMatch();
+		});
+		child.once("error", (error) => finish(null, error.message));
+		child.once("close", (code) => finish(code));
+		const timeout = setTimeout(() => {
+			timedOut = true;
+			terminate();
+		}, input.timeoutMs);
+		timeout.unref();
+		if (input.stdin === void 0) child.stdin.end();
+		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
+})) {
+	if (platform === "win32" && child.pid !== void 0) {
+		const result = runTaskkill("taskkill", [
+			"/pid",
+			String(child.pid),
+			"/f",
+			"/t"
+		]);
+		if (result.error === void 0 && result.status === 0) return;
+	}
+	if (platform !== "win32" && child.pid !== void 0) try {
+		process.kill(-child.pid, signal);
+		return;
+	} catch {}
+	try {
+		child.kill(signal);
+	} catch {}
+}
+function appendOutput(state, chunk, limit) {
+	const safeLimit = Math.max(1, limit);
+	const headLimit = Math.ceil(safeLimit / 2);
+	const tailLimit = Math.floor(safeLimit / 2);
+	if (!state.truncated && state.head.length + chunk.length <= safeLimit) return {
+		...state,
+		head: state.head + chunk
+	};
+	const combined = state.truncated ? chunk : state.head + chunk;
+	return {
+		head: state.truncated ? state.head : combined.slice(0, headLimit),
+		tail: `${state.tail}${combined.slice(state.truncated ? 0 : headLimit)}`.slice(-tailLimit),
+		truncated: true
+	};
+}
+function outputText(state) {
+	return state.truncated ? `${state.head}${TRUNCATED_MARKER}${state.tail}` : state.head;
+}
+//#endregion
+//#region packages/cli/src/package-runner.ts
+var PACKAGE_INSTALL_TIMEOUT_MS = 12e4;
+var PACKAGE_INSTALL_OUTPUT_LIMIT = 4e3;
+/** Detects whether Bun or npm invoked HolyCodex. */
+function detectPackageRunner(env = process.env) {
+	const executable = (env.npm_execpath ?? "").split(/[\\/]/).at(-1)?.toLowerCase().replace(/\.exe$/, "");
+	const userAgent = env.npm_config_user_agent?.trim().split(/[\s/]/, 1)[0]?.toLowerCase();
+	return executable === "bun" || userAgent === "bun" ? "bun" : "npm";
+}
+/** Builds the runner-specific codexslimedit invocation. */
+function codexSlimEditInvocation(input) {
+	const args = [input.packageVersion.includes("-dev.") ? "codexslimedit@dev" : "codexslimedit@latest", ...input.includeVersion ? ["--version"] : []];
+	return input.packageRunner === "bun" ? {
+		command: "bunx",
+		args
+	} : {
+		command: input.platform === "win32" ? "npx.cmd" : "npx",
+		args: ["--yes", ...args]
+	};
+}
+/** Pre-resolves codexslimedit through the invoking package runner. */
+async function installCodexSlimEdit(input, env = process.env) {
+	if (env.NODE_ENV === "test" && env.HOLYCODEX_TEST_SKIP_PACKAGE_RESOLUTION === "1") return;
+	const invocation = codexSlimEditInvocation({
+		...input,
+		includeVersion: true
+	});
+	const result = await runManagedProcess({
+		...invocation,
+		platform: input.platform,
+		timeoutMs: PACKAGE_INSTALL_TIMEOUT_MS,
+		maxOutputChars: PACKAGE_INSTALL_OUTPUT_LIMIT
+	});
+	if (result.exitCode === 0 && !result.timedOut) return;
+	const detail = result.error ?? (result.stderr.trim() || result.stdout.trim() || "unknown package error");
+	throw new Error(`Could not install codexslimedit with ${invocation.command}: ${detail}. Check package registry and network access, then retry HolyCodex installation.`);
+}
+//#endregion
 //#region packages/cli/src/catalog.ts
-var VERSION = "0.7.4";
+var VERSION = "0.8.0";
 var SKILLS = [
 	"ast-grep",
 	"caveman",
@@ -4057,7 +4219,7 @@ var MODEL_ROUTING_PLANS = ModelRoutingPlansSchema.parse({
 			}
 		},
 		usage: {
-			maxThreads: 1,
+			maxThreads: 2,
 			maxDepth: 1
 		}
 	},
@@ -4286,19 +4448,26 @@ var MANAGED_ROOT_MODEL_HISTORY_BY_PLAN = {
 	"pro-20x": managedPlanRootModels("pro-20x")
 };
 var GENERATED_RUNTIMES = [
+	"agent-capacity.js",
 	"bootstrap.js",
 	"core-instructions.js",
 	"detect-lsp.js",
 	"git-bash.js",
 	"git-bash-resolver.js",
 	"LICENSE-LSP-MIT.txt",
+	"LICENSE-OPENSLIMEDIT-MIT.txt",
 	"lsp.js",
 	"mcp-stdio-core.js",
 	"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) {
+function effectiveMcpServers(platform, packageRunner = "bun") {
+	const codexSlimEdit = codexSlimEditInvocation({
+		packageRunner,
+		platform,
+		packageVersion: VERSION
+	});
 	return {
 		...platform === "win32" ? { git_bash: {
 			command: "node",
@@ -4311,6 +4480,10 @@ function effectiveMcpServers(platform) {
 			args: ["runtime/lsp.js", "mcp"],
 			cwd: "."
 		},
+		codexslimedit: {
+			...codexSlimEdit,
+			enabled_tools: ["read_file", "apply_patch"]
+		},
 		context7: {
 			command: "bunx",
 			args: ["@upstash/context7-mcp"]
@@ -4403,130 +4576,6 @@ function missing(checkedPaths) {
 	};
 }
 //#endregion
-//#region packages/mcp-stdio-core/src/process.ts
-var TRUNCATED_MARKER = "\n... diagnostic output truncated ...\n";
-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], {
-			...input.cwd === void 0 ? {} : { cwd: input.cwd },
-			...input.env === void 0 ? {} : { env: input.env },
-			stdio: [
-				"pipe",
-				"pipe",
-				"pipe"
-			],
-			windowsHide: true,
-			detached: input.platform !== "win32"
-		});
-		let stdout = {
-			head: "",
-			tail: "",
-			truncated: false
-		};
-		let stderr = {
-			head: "",
-			tail: "",
-			truncated: false
-		};
-		let timedOut = false;
-		let matched = false;
-		let settled = false;
-		let forceKillTimeout;
-		const finish = (exitCode, error) => {
-			if (settled) return;
-			settled = true;
-			clearTimeout(timeout);
-			if (forceKillTimeout !== void 0) clearTimeout(forceKillTimeout);
-			resolve({
-				exitCode,
-				stdout: outputText(stdout),
-				stderr: outputText(stderr),
-				timedOut,
-				matched,
-				outputTruncated: stdout.truncated || stderr.truncated,
-				...error === void 0 ? {} : { error }
-			});
-		};
-		const terminate = () => {
-			if (forceKillTimeout !== void 0) return;
-			runtime.kill(child, input.platform, "SIGTERM");
-			forceKillTimeout = setTimeout(() => {
-				runtime.kill(child, input.platform, "SIGKILL");
-			}, runtime.terminationGraceMs);
-			forceKillTimeout.unref();
-		};
-		const inspectMatch = () => {
-			if (matched || input.matchOutput === void 0) return;
-			if (input.matchOutput(`${outputText(stdout)}\n${outputText(stderr)}`)) {
-				matched = true;
-				terminate();
-			}
-		};
-		child.stdout.on("data", (chunk) => {
-			stdout = appendOutput(stdout, chunk.toString(), input.maxOutputChars);
-			inspectMatch();
-		});
-		child.stderr.on("data", (chunk) => {
-			stderr = appendOutput(stderr, chunk.toString(), input.maxOutputChars);
-			inspectMatch();
-		});
-		child.once("error", (error) => finish(null, error.message));
-		child.once("close", (code) => finish(code));
-		const timeout = setTimeout(() => {
-			timedOut = true;
-			terminate();
-		}, input.timeoutMs);
-		timeout.unref();
-		if (input.stdin === void 0) child.stdin.end();
-		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
-})) {
-	if (platform === "win32" && child.pid !== void 0) {
-		const result = runTaskkill("taskkill", [
-			"/pid",
-			String(child.pid),
-			"/f",
-			"/t"
-		]);
-		if (result.error === void 0 && result.status === 0) return;
-	}
-	if (platform !== "win32" && child.pid !== void 0) try {
-		process.kill(-child.pid, signal);
-		return;
-	} catch {}
-	try {
-		child.kill(signal);
-	} catch {}
-}
-function appendOutput(state, chunk, limit) {
-	const safeLimit = Math.max(1, limit);
-	const headLimit = Math.ceil(safeLimit / 2);
-	const tailLimit = Math.floor(safeLimit / 2);
-	if (!state.truncated && state.head.length + chunk.length <= safeLimit) return {
-		...state,
-		head: state.head + chunk
-	};
-	const combined = state.truncated ? chunk : state.head + chunk;
-	return {
-		head: state.truncated ? state.head : combined.slice(0, headLimit),
-		tail: `${state.tail}${combined.slice(state.truncated ? 0 : headLimit)}`.slice(-tailLimit),
-		truncated: true
-	};
-}
-function outputText(state) {
-	return state.truncated ? `${state.head}${TRUNCATED_MARKER}${state.tail}` : state.head;
-}
-//#endregion
 //#region packages/cli/src/toml.ts
 var TOML_TABLE = /^[ \t]*(?:\[[^\]\r\n]+\]|\[\[[^\]\r\n]+\]\])[ \t]*(?:#.*)?$/m;
 /** Reads a root TOML string value. */
@@ -4773,6 +4822,7 @@ function installConfig(input, mode, _platform, plan = DEFAULT_PLAN) {
 	let configured = `${`${START}\n${PLAN_PREFIX}${plan}\n${originalRoot ? `${ORIGINAL_ROOT}${Buffer.from(originalRoot).toString("base64")}\n` : ""}${model}${effort}${verbosity}${preservedRoot ? `${preservedRoot}\n` : ""}approval_policy = "${approval}"\nsandbox_mode = "${sandbox}"\nstatus_line = ${mergedStatusLine(controlled[3])}\n${END}`}${tables ? `\n\n${tables}` : ""}`;
 	configured = injectTableKey(configured, "features", "default_mode_request_user_input", "true");
 	configured = injectTableKey(configured, "features", "multi_agent", "true");
+	configured = injectTableKey(configured, "features", "multi_agent_v2", "true");
 	const usage = MODEL_ROUTING_PLANS[plan].usage;
 	configured = injectTableKey(configured, "agents", "max_threads", String(usage.maxThreads));
 	configured = injectTableKey(configured, "agents", "max_depth", String(usage.maxDepth));
@@ -4829,7 +4879,10 @@ async function startContext7(platform) {
 }
 var defaultRuntime$1 = {
 	platform: process.platform,
-	command: (name, args) => runCommand(name, args, process.platform),
+	command: (name, args) => process.env.NODE_ENV === "test" && process.env.HOLYCODEX_TEST_SKIP_PACKAGE_RESOLUTION === "1" && args.some((argument) => argument.startsWith("codexslimedit@")) ? Promise.resolve({
+		ok: true,
+		output: "package resolution skipped in tests"
+	}) : runCommand(name, args, process.platform),
 	context7: () => startContext7(process.platform),
 	gitBash: resolveGitBashForCurrentProcess
 };
@@ -4908,6 +4961,12 @@ async function doctor(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")
 		const expected = expectedMcps[name];
 		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 codexSlimEdit = servers?.codexslimedit;
+	const codexSlimEditConfig = ["bun", "npm"].map((runner) => effectiveMcpServers(runtime.platform, runner).codexslimedit).find((expected) => {
+		return expected !== void 0 && codexSlimEdit !== void 0 && mcpConfigMatches(codexSlimEdit, expected);
+	});
+	const codexSlimEditStarted = codexSlimEditConfig === void 0 ? void 0 : await runtime.command(codexSlimEditConfig.command, [...codexSlimEditConfig.args, "--version"]);
+	checks.push(codexSlimEdit === void 0 ? check("mcp-codexslimedit", "error", "missing-codexslimedit", "codexslimedit is not configured.", "Reinstall HolyCodex.") : codexSlimEditStarted?.ok === true ? check("mcp-codexslimedit", "ok", "codexslimedit-ready", "codexslimedit is configured through npm or Bun.") : codexSlimEditConfig === void 0 ? check("mcp-codexslimedit", "error", "invalid-codexslimedit-config", "codexslimedit configuration is stale or uses an unsupported runner.", "Reinstall HolyCodex.") : check("mcp-codexslimedit", "error", "codexslimedit-unavailable", `codexslimedit could not start: ${codexSlimEditStarted?.output || "unknown runner error"}`, "Check the configured package runner and network access, then reinstall HolyCodex."));
 	const gitBashConfig = servers?.git_bash;
 	if (runtime.platform === "win32" && gitBashConfig !== void 0) {
 		const expected = effectiveMcpServers("win32").git_bash;
@@ -5019,7 +5078,13 @@ async function readText(path) {
 //#region packages/cli/src/install.ts
 var defaultRuntime = {
 	platform: process.platform,
-	gitBash: resolveGitBashForCurrentProcess
+	gitBash: resolveGitBashForCurrentProcess,
+	packageRunner: detectPackageRunner(),
+	installCodexSlimEdit: async (packageRunner) => installCodexSlimEdit({
+		packageRunner,
+		packageVersion: VERSION,
+		platform: process.platform
+	})
 };
 function paths(home = process.env.CODEX_HOME ?? join(homedir(), ".codex")) {
 	const marketplaceCache = join(home, "plugins", "cache", "holycodex");
@@ -5049,6 +5114,7 @@ function assertGitBashReady(platform, resolution) {
 /** Provides install. */
 async function install(options, runtime = defaultRuntime) {
 	assertGitBashReady(runtime.platform, runtime.gitBash());
+	await runtime.installCodexSlimEdit(runtime.packageRunner);
 	const plan = options.plan ?? "plus";
 	const target = paths();
 	const root = backupRoot();
@@ -5068,7 +5134,7 @@ async function install(options, runtime = defaultRuntime) {
 	});
 	await mkdir(dirname(target.cache), { recursive: true });
 	await cp(pluginRoot, target.cache, { recursive: true });
-	await writePlatformPlugin(target.cache, runtime.platform, plan);
+	await writePlatformPlugin(target.cache, runtime.platform, plan, runtime.packageRunner);
 	const existingAgentPreferences = await readAgentPreferences(target.agents, previousPlan);
 	await rm(target.agents, {
 		recursive: true,
@@ -5123,8 +5189,8 @@ async function preserveAgentPreferences(root, preferences) {
 function replaceTomlString(input, key, value) {
 	return input.replace(new RegExp(`^${key}\\s*=.*$`, "m"), `${key} = ${JSON.stringify(value)}`);
 }
-async function writePlatformPlugin(root, platform, plan) {
-	await atomicWrite(join(root, ".mcp.json"), `${JSON.stringify({ mcpServers: effectiveMcpServers(platform) }, null, 2)}\n`);
+async function writePlatformPlugin(root, platform, plan, packageRunner) {
+	await atomicWrite(join(root, ".mcp.json"), `${JSON.stringify({ mcpServers: effectiveMcpServers(platform, packageRunner) }, null, 2)}\n`);
 	await writeInstalledAgents(join(root, "agents"), platform, plan);
 }
 async function writeInstalledAgents(root, platform, plan) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holycodex",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "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.4",
+    "@holycodex/plugin": "0.8.0",
     "zod": "^4.4.3"
   },
   "engines": {