@heretyc/subagent-mcp 2.6.0 → 2.6.1

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/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.1",
+  "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);