@heretyc/subagent-mcp 2.6.0 → 2.6.2

package/dist/ruleset-scaffold.js

@@ -1,2 +1,2 @@
 // GENERATED by scripts/gen-ruleset-scaffold.mjs from src/advanced-ruleset.py — DO NOT EDIT.
-export const RULESET_SCAFFOLD = "#!/usr/bin/env python3\r\n\"\"\"advanced-ruleset.py — final-authority model-routing override hook for subagent-mcp.\r\n\r\n(a) PERFORMANCE WARNING: this script runs synchronously inside EVERY launch_agent\r\n    call. Slow rules slow every agent launch. Keep rules lean and low-latency —\r\n    no network calls, no heavy imports at module top. This is YOUR responsibility;\r\n    you have been warned.\r\n\r\n(b) OUTPUT CONTRACT (routing mode): print to stdout ONE JSON array — the modified\r\n    candidate list (reorder / filter / replace allowed). Template:\r\n    [\r\n      {\"provider\": \"claude\", \"model\": \"sonnet\",  \"effort\": \"high\",  \"rank\": 1},\r\n      {\"provider\": \"codex\",  \"model\": \"gpt-5.5\", \"effort\": \"xhigh\", \"rank\": 2}\r\n    ]\r\n    Valid providers: claude, codex. Valid models: haiku, sonnet, opus, opus-4-8 (claude);\r\n    gpt-5.5 (codex). Valid efforts: haiku -> \"none\" only; sonnet -> low|medium|high|xhigh|max;\r\n    opus/opus-4-8 -> those plus ultracode; gpt-5.5 -> low|medium|high|xhigh.\r\n    \"rank\" on output is ignored. An EMPTY array vetoes the launch. Anything else\r\n    invalid fails the launch hard — the server validates strictly.\r\n\r\n(c) INPUT CONTRACT (routing mode, invoked as: <python> advanced-ruleset.py route):\r\n    stdin receives one JSON object:\r\n    { \"candidates\": [ {\"provider\",\"model\",\"effort\",\"rank\"} ... ],   # rank 1..N best->worst\r\n      \"context\": { \"task_category\": str, \"cwd\": str,\r\n                   \"selection_mode\": \"auto\"|\"provider\"|\"provider_model\"|\"explicit\",\r\n                   \"provider\": str|None, \"model\": str|None, \"effort\": str|None } }\r\n    OS environment variables are visible natively (os.environ).\r\n\r\nENV-CHECK MODE (no arguments): prints {\"ready\": true|false, \"load-rules\": true|false}.\r\nRuns once per MCP server process. load-rules false => ruleset silently disabled\r\nfor the rest of the process. Set LOAD_RULES = True below to activate.\r\n\"\"\"\r\nimport json\r\nimport sys\r\n\r\nLOAD_RULES = False\r\n\r\n# --- Requirements stub (scaffold itself is stdlib-only) ----------------------\r\n# List third-party distributions your rules import, e.g.:\r\n# REQUIREMENTS = [\"requests\", \"pyyaml\"]\r\n# Install with:  <python> -m pip install <name> ...\r\nREQUIREMENTS = []\r\n\r\ndef missing_requirements():\r\n    \"\"\"pip-check helper: returns the REQUIREMENTS entries not importable here.\"\"\"\r\n    import importlib.util\r\n    return [r for r in REQUIREMENTS\r\n            if importlib.util.find_spec(r.replace(\"-\", \"_\")) is None]\r\n\r\ndef env_check():\r\n    missing = missing_requirements()\r\n    json.dump({\"ready\": not missing, \"load-rules\": bool(LOAD_RULES)}, sys.stdout)\r\n\r\ndef apply_rules(candidates, context):\r\n    \"\"\"YOUR RULES HERE. Default: passthrough (returns the list unchanged).\"\"\"\r\n    return candidates\r\n\r\ndef route():\r\n    payload = json.load(sys.stdin)\r\n    out = apply_rules(payload.get(\"candidates\", []), payload.get(\"context\", {}))\r\n    json.dump(out, sys.stdout)\r\n\r\nif __name__ == \"__main__\":\r\n    if len(sys.argv) > 1 and sys.argv[1] == \"route\":\r\n        route()\r\n    else:\r\n        env_check()\r\n";
+export const RULESET_SCAFFOLD = "#!/usr/bin/env python3\n\"\"\"advanced-ruleset.py — final-authority model-routing override hook for subagent-mcp.\n\n(a) PERFORMANCE WARNING: this script runs synchronously inside EVERY launch_agent\n    call. Slow rules slow every agent launch. Keep rules lean and low-latency —\n    no network calls, no heavy imports at module top. This is YOUR responsibility;\n    you have been warned.\n\n(b) OUTPUT CONTRACT (routing mode): print to stdout ONE JSON array — the modified\n    candidate list (reorder / filter / replace allowed). Template:\n    [\n      {\"provider\": \"claude\", \"model\": \"sonnet\",  \"effort\": \"high\",  \"rank\": 1},\n      {\"provider\": \"codex\",  \"model\": \"gpt-5.5\", \"effort\": \"xhigh\", \"rank\": 2}\n    ]\n    Valid providers: claude, codex. Valid models: haiku, sonnet, opus, opus-4-8 (claude);\n    gpt-5.5 (codex). Valid efforts: haiku -> \"none\" only; sonnet -> low|medium|high|xhigh|max;\n    opus/opus-4-8 -> those plus ultracode; gpt-5.5 -> low|medium|high|xhigh.\n    \"rank\" on output is ignored. An EMPTY array vetoes the launch. Anything else\n    invalid fails the launch hard — the server validates strictly.\n\n(c) INPUT CONTRACT (routing mode, invoked as: <python> advanced-ruleset.py route):\n    stdin receives one JSON object:\n    { \"candidates\": [ {\"provider\",\"model\",\"effort\",\"rank\"} ... ],   # rank 1..N best->worst\n      \"context\": { \"task_category\": str, \"cwd\": str,\n                   \"selection_mode\": \"auto\"|\"provider\"|\"provider_model\"|\"explicit\",\n                   \"provider\": str|None, \"model\": str|None, \"effort\": str|None } }\n    OS environment variables are visible natively (os.environ).\n\nENV-CHECK MODE (no arguments): prints {\"ready\": true|false, \"load-rules\": true|false}.\nRuns once per MCP server process. load-rules false => ruleset silently disabled\nfor the rest of the process. Set LOAD_RULES = True below to activate.\n\"\"\"\nimport json\nimport sys\n\nLOAD_RULES = False\n\n# --- Requirements stub (scaffold itself is stdlib-only) ----------------------\n# List third-party distributions your rules import, e.g.:\n# REQUIREMENTS = [\"requests\", \"pyyaml\"]\n# Install with:  <python> -m pip install <name> ...\nREQUIREMENTS = []\n\ndef missing_requirements():\n    \"\"\"pip-check helper: returns the REQUIREMENTS entries not importable here.\"\"\"\n    import importlib.util\n    return [r for r in REQUIREMENTS\n            if importlib.util.find_spec(r.replace(\"-\", \"_\")) is None]\n\ndef env_check():\n    missing = missing_requirements()\n    json.dump({\"ready\": not missing, \"load-rules\": bool(LOAD_RULES)}, sys.stdout)\n\ndef apply_rules(candidates, context):\n    \"\"\"YOUR RULES HERE. Default: passthrough (returns the list unchanged).\"\"\"\n    return candidates\n\ndef route():\n    payload = json.load(sys.stdin)\n    out = apply_rules(payload.get(\"candidates\", []), payload.get(\"context\", {}))\n    json.dump(out, sys.stdout)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) > 1 and sys.argv[1] == \"route\":\n        route()\n    else:\n        env_check()\n";

package/dist/setup.js

@@ -16,7 +16,7 @@
 //   - Every config file is backed up before its first edit.
 //   - Failures never abort the run: they are collected and reported at the end
 //     with a copy-paste repair prompt the user can hand to Claude/Codex.
-import { existsSync, readFileSync, writeFileSync, copyFileSync, } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, copyFileSync, mkdirSync, } from "node:fs";
 import { homedir } from "node:os";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -104,17 +104,14 @@ export function reconcileClaudeJson(cj, serverPath) {
     const cur = servers["subagent-mcp"];
     if (cur) {
         const args = cur.args;
-        const exact = cur.command === "node" &&
-            Array.isArray(args) &&
-            args.length === 1 &&
-            args[0] === serverPath;
+        const exact = cur.command === "subagent-mcp" && Array.isArray(args) && args.length === 0;
         if (exact)
             return { changed: false, status: "ok" };
     }
     servers["subagent-mcp"] = {
         type: "stdio",
-        command: "node",
-        args: [serverPath],
+        command: "subagent-mcp",
+        args: [],
         env: {},
     };
     return { changed: true, status: cur ? "repaired" : "added" };
@@ -144,7 +141,7 @@ export function reconcileCodexToml(toml, serverPath) {
             status: "added",
         };
     }
-    if (m[0].includes(`args = ["${serverPath}"]`)) {
+    if (m[0].includes(`command = "node"`) && m[0].includes(`args = ["${serverPath}"]`)) {
         return { toml, changed: false, status: "ok" };
     }
     return {
@@ -242,26 +239,60 @@ function backup(file) {
     }
 }
 function runCmd(cmd, cmdArgs) {
+    return runCmdCapture(cmd, cmdArgs).ok;
+}
+function quoteWinShellArg(arg) {
+    if (!/[ \t"]/.test(arg))
+        return arg;
+    return `"${arg.replace(/"/g, '\\"')}"`;
+}
+function quoteWinShellExe(exe) {
+    return `"${exe.replace(/"/g, '\\"')}"`;
+}
+function runCmdCapture(cmd, cmdArgs) {
     console.log(`  $ ${cmd} ${cmdArgs.join(" ")}`);
     if (DRY_RUN) {
         console.log("    (dry-run: skipped)");
-        return true;
+        return { ok: true, stdout: "" };
     }
     try {
-        if (process.platform === "win32") {
-            // npm-installed CLIs are .cmd shims execFileSync can't spawn directly.
-            const line = [cmd, ...cmdArgs.map((a) => (/\s/.test(a) ? `"${a}"` : a))].join(" ");
-            execSync(line, { stdio: "pipe" });
-        }
-        else {
-            execFileSync(cmd, cmdArgs, { stdio: "pipe" });
-        }
-        return true;
+        const exe = findOnPath(cmd) ?? cmd;
+        const isWinCmdShim = process.platform === "win32" && /\.(?:cmd|bat)$/i.test(exe);
+        const stdout = isWinCmdShim
+            ? execSync([quoteWinShellExe(exe), ...cmdArgs.map(quoteWinShellArg)].join(" "), { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] })
+            : execFileSync(exe, cmdArgs, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+        return { ok: true, stdout };
     }
     catch {
-        return false;
+        return { ok: false, stdout: "" };
     }
 }
+export function claudeAddArgs() {
+    return ["mcp", "add", "subagent-mcp", "subagent-mcp", "-s", "user"];
+}
+export function claudeRemoveArgs() {
+    return ["mcp", "remove", "subagent-mcp", "-s", "user"];
+}
+export function codexAddArgs(serverPath) {
+    return ["mcp", "add", "subagent-mcp", "--", "node", serverPath];
+}
+export function codexRemoveArgs() {
+    return ["mcp", "remove", "subagent-mcp"];
+}
+function claudeRegisteredViaCli() {
+    const get = runCmdCapture("claude", ["mcp", "get", "subagent-mcp"]);
+    if (get.ok && get.stdout.includes("subagent-mcp"))
+        return true;
+    const list = runCmdCapture("claude", ["mcp", "list"]);
+    return list.ok && list.stdout.includes("subagent-mcp");
+}
+function codexRegisteredViaCli() {
+    const get = runCmdCapture("codex", ["mcp", "get", "subagent-mcp"]);
+    if (get.ok && get.stdout.includes("subagent-mcp"))
+        return true;
+    const list = runCmdCapture("codex", ["mcp", "list"]);
+    return list.ok && list.stdout.includes("subagent-mcp");
+}
 const issues = [];
 function repairPromptFor(vendor, problem) {
     const p = serverPaths();
@@ -269,7 +300,7 @@ function repairPromptFor(vendor, problem) {
         return (`subagent-mcp setup hit a problem on my machine: ${problem}. ` +
             `The install root is "${fwd(INSTALL_ROOT)}". Please repair my Claude Code wiring: ` +
             `(1) register a user-scope MCP server named "subagent-mcp" running ` +
-            `[node "${p.server}"] (use 'claude mcp add --scope user' or edit the mcpServers ` +
+            `the global bin shim "subagent-mcp" (use 'claude mcp add subagent-mcp subagent-mcp -s user' or edit the mcpServers ` +
             `key in ~/.claude.json), and (2) ensure ~/.claude/settings.json has a ` +
             `hooks.UserPromptSubmit entry {type:"command", command:"node", args:["${p.claudeHook}"]}. ` +
             `Back up any file before editing it.`);
@@ -308,20 +339,27 @@ function wireClaude() {
         const probe = JSON.parse(JSON.stringify(cj));
         const { status } = reconcileClaudeJson(probe, p.server);
         if (status === "ok") {
-            describe("ok", "MCP server (user scope)");
+            let registered = claudeRegisteredViaCli();
+            if (!registered) {
+                runCmd("claude", claudeAddArgs());
+                registered = claudeRegisteredViaCli();
+            }
+            if (registered)
+                describe("ok", "MCP server (user scope)");
+            else
+                fail("claude", "MCP server file shape is correct, but 'claude mcp add' failed to register it with the CLI");
         }
         else {
             if (status === "repaired") {
                 console.log("  MCP server registration points at a stale path — re-registering.");
-                runCmd("claude", ["mcp", "remove", "-s", "user", "subagent-mcp"]);
+                runCmd("claude", claudeRemoveArgs());
             }
-            const cliOk = runCmd("claude", [
-                "mcp", "add", "--scope", "user", "subagent-mcp", "--", "node", p.server,
-            ]);
+            const cliOk = runCmd("claude", claudeAddArgs());
+            const cliVerified = cliOk && claudeRegisteredViaCli();
             // Read back; if the CLI failed or didn't take, write the entry directly.
             const after = readJson(cjFile, {});
             const verify = reconcileClaudeJson(after, p.server);
-            if (verify.status !== "ok" && !DRY_RUN) {
+            if (!cliVerified && verify.status !== "ok" && !DRY_RUN) {
                 if (!cliOk)
                     console.log("  'claude mcp add' failed — writing ~/.claude.json directly.");
                 backup(cjFile);
@@ -359,7 +397,14 @@ function wireCodex() {
         const cfg = join(codexDir, "config.toml");
         const toml = existsSync(cfg) ? readFileSync(cfg, "utf8") : "";
         const r = reconcileCodexToml(toml, p.server);
-        if (r.changed && !DRY_RUN) {
+        if (r.status === "repaired") {
+            console.log("  MCP server registration points at a stale path — re-registering.");
+            runCmd("codex", codexRemoveArgs());
+        }
+        const cliOk = r.status === "ok" && codexRegisteredViaCli() ? true : runCmd("codex", codexAddArgs(p.server));
+        if (!cliOk && r.changed && !DRY_RUN) {
+            console.log("  'codex mcp add' failed — writing ~/.codex/config.toml directly.");
+            mkdirSync(codexDir, { recursive: true });
             backup(cfg);
             writeFileSync(cfg, r.toml);
         }
@@ -377,6 +422,7 @@ function wireCodex() {
         const hookCmd = `node "${p.codexHook}"`;
         const { changed, statuses } = reconcileCodexHooks(h, hookCmd);
         if (changed && !DRY_RUN) {
+            mkdirSync(codexDir, { recursive: true });
             backup(hfile);
             writeFileSync(hfile, JSON.stringify(h, null, 2));
         }
@@ -392,7 +438,7 @@ function wireCodex() {
         fail("codex", `could not write hooks.json: ${e.message}`);
     }
 }
-export function verifyWiring(root = INSTALL_ROOT) {
+export function verifyWiring(root = INSTALL_ROOT, repair = false) {
     const p = serverPaths(root);
     const results = [];
     const home = homedir();
@@ -403,7 +449,29 @@ export function verifyWiring(root = INSTALL_ROOT) {
         detail: missing.length === 0 ? `all present under ${fwd(root)}` : `missing: ${missing.join(", ")}`,
     });
     const hasClaude = findOnPath("claude") !== null;
+    const hasClaudeConfig = existsSync(join(home, ".claude.json"));
     if (hasClaude) {
+        const sj = readJson(join(home, ".claude", "settings.json"), {});
+        let registered = claudeRegisteredViaCli();
+        let repaired = false;
+        if (!registered && repair) {
+            runCmd("claude", claudeAddArgs());
+            repaired = true;
+            registered = claudeRegisteredViaCli();
+        }
+        const hk = reconcileClaudeSettings(JSON.parse(JSON.stringify(sj)), p.claudeHook);
+        results.push({
+            label: "claude: MCP server (user scope)",
+            ok: registered,
+            detail: registered ? (repaired ? "repaired" : "registered") : "not registered; CLI repair failed",
+        });
+        results.push({
+            label: "claude: UserPromptSubmit hook",
+            ok: hk.status === "ok",
+            detail: hk.status === "ok" ? "wired" : `${hk.status === "repaired" ? "stale path" : "not wired"} - run: subagent-mcp setup`,
+        });
+    }
+    else if (hasClaudeConfig) {
         const cj = readJson(join(home, ".claude.json"), {});
         const sj = readJson(join(home, ".claude", "settings.json"), {});
         const srv = reconcileClaudeJson(JSON.parse(JSON.stringify(cj)), p.server);
@@ -411,34 +479,48 @@ export function verifyWiring(root = INSTALL_ROOT) {
         results.push({
             label: "claude: MCP server (user scope)",
             ok: srv.status === "ok",
-            detail: srv.status === "ok" ? "registered" : `${srv.status === "repaired" ? "stale path" : "not registered"} — run: subagent-mcp setup`,
+            detail: srv.status === "ok" ? "registered (file fallback)" : "not registered; claude CLI not on PATH",
         });
         results.push({
             label: "claude: UserPromptSubmit hook",
             ok: hk.status === "ok",
-            detail: hk.status === "ok" ? "wired" : `${hk.status === "repaired" ? "stale path" : "not wired"} — run: subagent-mcp setup`,
+            detail: hk.status === "ok" ? "wired" : `${hk.status === "repaired" ? "stale path" : "not wired"} - run: subagent-mcp setup`,
         });
     }
-    const hasCodex = findOnPath("codex") !== null || existsSync(join(home, ".codex"));
+    const hasCodexCli = findOnPath("codex") !== null;
+    const hasCodex = hasCodexCli || existsSync(join(home, ".codex"));
     if (hasCodex) {
         const cfg = join(home, ".codex", "config.toml");
         const toml = existsSync(cfg) ? readFileSync(cfg, "utf8") : "";
         const tomlR = reconcileCodexToml(toml, p.server);
         const hj = readJson(join(home, ".codex", "hooks.json"), { hooks: {} });
         const hkR = reconcileCodexHooks(hj, `node "${p.codexHook}"`);
+        let registered = false;
+        let repaired = false;
+        if (hasCodexCli) {
+            registered = codexRegisteredViaCli();
+            if (!registered && repair) {
+                runCmd("codex", codexAddArgs(p.server));
+                repaired = true;
+                registered = codexRegisteredViaCli();
+            }
+        }
+        else {
+            registered = tomlR.status === "ok";
+        }
         results.push({
             label: "codex: config.toml MCP server block",
-            ok: tomlR.status === "ok",
-            detail: tomlR.status === "ok" ? "registered" : `${tomlR.status === "repaired" ? "stale path" : "not registered"} — run: subagent-mcp setup`,
+            ok: registered,
+            detail: registered ? (repaired ? "repaired" : "registered") : "not registered; CLI repair failed",
         });
         const allOk = Object.values(hkR.statuses).every((s) => s === "ok");
         results.push({
             label: "codex: SessionStart + UserPromptSubmit hooks",
             ok: allOk,
-            detail: allOk ? "wired (trust via /hooks in Codex)" : "incomplete — run: subagent-mcp setup",
+            detail: allOk ? "wired (trust via /hooks in Codex)" : "incomplete - run: subagent-mcp setup",
         });
     }
-    if (!hasClaude && !hasCodex) {
+    if (!hasClaude && !hasClaudeConfig && !hasCodex) {
         results.push({
             label: "vendors",
             ok: false,
@@ -483,7 +565,7 @@ export async function runSetup() {
     // Read-back verification: report what is ACTUALLY on disk now.
     if (!DRY_RUN) {
         console.log("\n--- Verification (read-back) ---");
-        for (const r of verifyWiring()) {
+        for (const r of verifyWiring(INSTALL_ROOT, false)) {
             console.log(`  ${r.ok ? "PASS" : "FAIL"}  ${r.label} — ${r.detail}`);
         }
     }

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@heretyc/subagent-mcp",
-  "version": "2.6.0",
-  "description": "MCP server that launches and manages local Claude Code and Codex CLI sub-agents as child processes (no direct Anthropic/OpenAI API).",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "subagent-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "directives",
-    "scripts/postinstall.mjs",
-    "LICENSE",
-    "NOTICE",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "node scripts/gen-ruleset-scaffold.mjs && tsc && node scripts/copy-provider.mjs",
-    "start": "node dist/index.js",
-    "postinstall": "node scripts/postinstall.mjs",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm test",
-    "test": "node test/effort.test.mjs && node test/platform.test.mjs && node test/wait.test.mjs && node test/status.test.mjs && node test/output.test.mjs && node test/stream.test.mjs && node test/routing.test.mjs && node test/deadlock.test.mjs && node test/handler-validation.test.mjs && node test/index-handler.test.mjs && node test/ruleset.test.mjs && node test/ruleset-exec.test.mjs && node test/ruleset-handler.test.mjs && node test/failover.test.mjs && node test/orchestration-marker.test.mjs && node test/orchestration-hook-core.test.mjs && node test/orchestration-adapters.test.mjs && node test/orchestration-directives.test.mjs && node test/setup-repair.test.mjs && node scripts/validate_provider.mjs && node scripts/validate_seed_sites.mjs && node scripts/validate_routing_audit.mjs && node test/seed-sites.test.mjs && node test/mcp-compliance.test.mjs"
-  },
-  "author": "Lexi Blackburn",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Heretyc/subagent-mcp.git"
-  },
-  "homepage": "https://github.com/Heretyc/subagent-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/Heretyc/subagent-mcp/issues"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.0.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "registry": "https://npm.pkg.github.com",
-    "access": "public"
-  }
-}
+{
+  "name": "@heretyc/subagent-mcp",
+  "version": "2.6.2",
+  "description": "MCP server that launches and manages local Claude Code and Codex CLI sub-agents as child processes (no direct Anthropic/OpenAI API).",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "subagent-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "directives",
+    "scripts/postinstall.mjs",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node scripts/gen-ruleset-scaffold.mjs && tsc && node scripts/copy-provider.mjs",
+    "start": "node dist/index.js",
+    "postinstall": "node scripts/postinstall.mjs",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm test",
+    "test": "node test/effort.test.mjs && node test/platform.test.mjs && node test/wait.test.mjs && node test/status.test.mjs && node test/output.test.mjs && node test/stream.test.mjs && node test/routing.test.mjs && node test/deadlock.test.mjs && node test/handler-validation.test.mjs && node test/index-handler.test.mjs && node test/ruleset.test.mjs && node test/ruleset-exec.test.mjs && node test/ruleset-handler.test.mjs && node test/failover.test.mjs && node test/orchestration-marker.test.mjs && node test/orchestration-hook-core.test.mjs && node test/orchestration-adapters.test.mjs && node test/orchestration-directives.test.mjs && node test/setup-repair.test.mjs && node scripts/validate_provider.mjs && node scripts/validate_seed_sites.mjs && node scripts/validate_routing_audit.mjs && node test/seed-sites.test.mjs && node test/mcp-compliance.test.mjs"
+  },
+  "author": "Lexi Blackburn",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Heretyc/subagent-mcp.git"
+  },
+  "homepage": "https://github.com/Heretyc/subagent-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/Heretyc/subagent-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com",
+    "access": "public"
+  }
+}

package/scripts/postinstall.mjs

@@ -1,102 +1,102 @@
-#!/usr/bin/env node
-// Postinstall banner for subagent-mcp.
-//
-// `npm install -g @heretyc/subagent-mcp` ships only the MCP server + hook
-// assets; it does NOT wire them into Claude Code / Codex. Without feedback the
-// user has no idea an addon landed, let alone that a second step is required.
-// This prints a clear "what installed / what to run next / how to verify"
-// banner so the install is self-explanatory.
-//
-// Rules:
-//   - NEVER fail the install. Any error is swallowed; always exit 0.
-//   - Only speak for a real end-user install. In the dev checkout (src/ present)
-//     stay silent so `npm install` during development isn't noisy.
-//   - Print only — do not mutate vendor config. Wiring is the explicit,
-//     reversible `subagent-mcp setup` step.
-
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join, dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { execSync } from "node:child_process";
-
-try {
-  // Install root: scripts/postinstall.mjs -> scripts/ -> <root>
-  const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-
-  // Dev checkout? (src/ only exists in the repo, never in the shipped tarball.)
-  // Stay silent there — the maintainer doesn't need the end-user banner.
-  if (existsSync(join(ROOT, "src"))) process.exit(0);
-
-  let version = "";
-  try {
-    version = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8")).version || "";
-  } catch { /* version is cosmetic */ }
-
-  // Best-effort vendor detection so the banner can say what WILL be wired.
-  // Pure read-only; failures just fall back to "not detected".
-  function has(cmd) {
-    try {
-      execSync(process.platform === "win32" ? `where ${cmd}` : `command -v ${cmd}`, {
-        stdio: "ignore",
-      });
-      return true;
-    } catch {
-      return false;
-    }
-  }
-  const hasClaude = has("claude");
-  const hasCodex = has("codex") || existsSync(join(homedir(), ".codex"));
-
-  const L = [];
-  const line = (s = "") => L.push(s);
-  const bar = "============================================================";
-
-  line();
-  line(bar);
-  line(`  subagent-mcp installed${version ? `  (v${version})` : ""}`);
-  line(bar);
-  line();
-  line("  This is an MCP ADDON for Claude Code CLI and Codex CLI.");
-  line("  It is NOT active yet — one command wires it in.");
-  line();
-  line("  FINISH SETUP  (auto-detects vendors, wires all present):");
-  line();
-  line("      subagent-mcp setup");
-  line();
-  line("  That registers the MCP server AND installs the per-turn");
-  line("  orchestration-mode hooks for every vendor it finds.");
-  line();
-
-  // Detected vendors — concrete, so the user knows what setup will touch.
-  if (hasClaude || hasCodex) {
-    line("  Detected on this machine:");
-    if (hasClaude) line("    - Claude Code CLI  (will get MCP server + UserPromptSubmit hook)");
-    if (hasCodex) line("    - Codex CLI        (will get MCP server + SessionStart/UserPromptSubmit hooks)");
-  } else {
-    line("  No Claude Code or Codex CLI detected yet. Install one,");
-    line("  then run:  subagent-mcp setup");
-  }
-  line();
-
-  line("  AFTER setup — confirm it took effect:");
-  if (hasClaude || !hasCodex) {
-    line("    - Claude Code: restart the session, run /mcp");
-    line("        -> 'subagent-mcp' shows Connected.");
-  }
-  if (hasCodex || !hasClaude) {
-    line("    - Codex CLI:   restart the session, run /hooks");
-    line("        -> TRUST the new subagent-mcp hook.");
-  }
-  line();
-  line("  Preview without changes:   subagent-mcp setup --dry-run");
-  line("  Health check any time:     subagent-mcp doctor");
-  line("  Docs:  https://github.com/Heretyc/subagent-mcp#readme");
-  line(bar);
-  line();
-
-  process.stdout.write(L.join("\n") + "\n");
-} catch {
-  // Never let a banner failure break the install.
-}
-process.exit(0);
+#!/usr/bin/env node
+// Postinstall banner for subagent-mcp.
+//
+// `npm install -g @heretyc/subagent-mcp` ships only the MCP server + hook
+// assets; it does NOT wire them into Claude Code / Codex. Without feedback the
+// user has no idea an addon landed, let alone that a second step is required.
+// This prints a clear "what installed / what to run next / how to verify"
+// banner so the install is self-explanatory.
+//
+// Rules:
+//   - NEVER fail the install. Any error is swallowed; always exit 0.
+//   - Only speak for a real end-user install. In the dev checkout (src/ present)
+//     stay silent so `npm install` during development isn't noisy.
+//   - Print only — do not mutate vendor config. Wiring is the explicit,
+//     reversible `subagent-mcp setup` step.
+
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+try {
+  // Install root: scripts/postinstall.mjs -> scripts/ -> <root>
+  const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+  // Dev checkout? (src/ only exists in the repo, never in the shipped tarball.)
+  // Stay silent there — the maintainer doesn't need the end-user banner.
+  if (existsSync(join(ROOT, "src"))) process.exit(0);
+
+  let version = "";
+  try {
+    version = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8")).version || "";
+  } catch { /* version is cosmetic */ }
+
+  // Best-effort vendor detection so the banner can say what WILL be wired.
+  // Pure read-only; failures just fall back to "not detected".
+  function has(cmd) {
+    try {
+      execSync(process.platform === "win32" ? `where ${cmd}` : `command -v ${cmd}`, {
+        stdio: "ignore",
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  const hasClaude = has("claude");
+  const hasCodex = has("codex") || existsSync(join(homedir(), ".codex"));
+
+  const L = [];
+  const line = (s = "") => L.push(s);
+  const bar = "============================================================";
+
+  line();
+  line(bar);
+  line(`  subagent-mcp installed${version ? `  (v${version})` : ""}`);
+  line(bar);
+  line();
+  line("  This is an MCP ADDON for Claude Code CLI and Codex CLI.");
+  line("  It is NOT active yet — one command wires it in.");
+  line();
+  line("  FINISH SETUP  (auto-detects vendors, wires all present):");
+  line();
+  line("      subagent-mcp setup");
+  line();
+  line("  That registers the MCP server AND installs the per-turn");
+  line("  orchestration-mode hooks for every vendor it finds.");
+  line();
+
+  // Detected vendors — concrete, so the user knows what setup will touch.
+  if (hasClaude || hasCodex) {
+    line("  Detected on this machine:");
+    if (hasClaude) line("    - Claude Code CLI  (will get MCP server + UserPromptSubmit hook)");
+    if (hasCodex) line("    - Codex CLI        (will get MCP server + SessionStart/UserPromptSubmit hooks)");
+  } else {
+    line("  No Claude Code or Codex CLI detected yet. Install one,");
+    line("  then run:  subagent-mcp setup");
+  }
+  line();
+
+  line("  AFTER setup — confirm it took effect:");
+  if (hasClaude || !hasCodex) {
+    line("    - Claude Code: restart the session, run /mcp");
+    line("        -> 'subagent-mcp' shows Connected.");
+  }
+  if (hasCodex || !hasClaude) {
+    line("    - Codex CLI:   restart the session, run /hooks");
+    line("        -> TRUST the new subagent-mcp hook.");
+  }
+  line();
+  line("  Preview without changes:   subagent-mcp setup --dry-run");
+  line("  Health check any time:     subagent-mcp doctor");
+  line("  Docs:  https://github.com/Heretyc/subagent-mcp#readme");
+  line(bar);
+  line();
+
+  process.stdout.write(L.join("\n") + "\n");
+} catch {
+  // Never let a banner failure break the install.
+}
+process.exit(0);