nodebench-mcp 3.1.0 → 3.1.2

package/README.md

@@ -1,4 +1,4 @@
-# NodeBench MCP
+# NodeBench MCP
 
 [![npm version](https://img.shields.io/npm/v/nodebench-mcp.svg)](https://www.npmjs.com/package/nodebench-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/nodebench-mcp.svg)](https://www.npmjs.com/package/nodebench-mcp)
@@ -25,10 +25,10 @@ claude mcp add nodebench-admin -- npx -y nodebench-mcp-admin
 
 ### What's New
 
-- **v3 default surface** — the default preset is now a workflow-first facade instead of a tool warehouse.
-- **Admin-only runtime gates** — dashboards and the observability watchdog no longer start on the default hot path. Use `--admin`, `--dashboards`, or `--watchdog` explicitly.
-- **Faster health path** — `--health` now loads only the active preset instead of eagerly loading every domain.
-- **Power and admin presets** — heavier research and operator lanes are still available, but no longer define the front door.
+- **v3 default surface** - the default preset is now a workflow-first facade instead of a tool warehouse.
+- **Admin-only runtime gates** - dashboards and the observability watchdog no longer start on the default hot path. Use `--admin`, `--dashboards`, or `--watchdog` explicitly.
+- **Faster health path** - `--health` now loads only the active preset instead of eagerly loading every domain.
+- **Separate install lanes** - `nodebench-mcp-power` and `nodebench-mcp-admin` are now published companion packages, while `--preset power` and `--preset admin` remain compatible paths on the core package.
 
 > **New here?** Read **[AGENT_LOGIC.md](./AGENT_LOGIC.md)** for the complete guide to how NodeBench thinks.
 
@@ -101,13 +101,13 @@ Production companion spec: [`docs/architecture/UNIFIED_WEB_MCP_PRODUCTION_SPEC.m
 
 NodeBench is now a workflow-first MCP. The default install proves one concrete job quickly, and the heavier surfaces are still available when you explicitly ask for them.
 
-### Presets
+### Install Lanes And Presets
 
-| Preset | Surface | What it is for |
+| Entry | Surface | What it is for |
 |---|---|---|
-| `default` | `9` visible tools | Workflow-first lane: `investigate`, `compare`, `track`, `summarize`, `search`, `report`, `ask_context`, `discover_tools`, `load_toolset` |
-| `power` | expanded workflow surface | Founder, recon, packets, and web-heavy workflows without admin runtime |
-| `admin` | operator surface | Profiling, observability, dashboards, eval, and debug-oriented lanes |
+| `nodebench-mcp` | `9` visible tools | Workflow-first lane: `investigate`, `compare`, `track`, `summarize`, `search`, `report`, `ask_context`, `discover_tools`, `load_toolset` |
+| `nodebench-mcp-power` | expanded workflow surface | Founder, recon, packets, and web-heavy workflows without admin runtime |
+| `nodebench-mcp-admin` | operator surface | Profiling, observability, dashboards, eval, and debug-oriented lanes |
 | `core` | full methodology lane | Verification, eval, learning, recon, execution trace, and mission harness |
 | `founder` | compatibility preset | Legacy founder-facing pack kept for existing setups |
 | `full` | all loaded domains | Maximum coverage when you explicitly want the warehouse |
@@ -121,10 +121,16 @@ ASK -> CHECK -> WRITE -> SAVE
 The default preset is optimized for that loop. It does not start local dashboards or the observability watchdog unless you pass admin flags explicitly.
 
 ```bash
-# Claude Code
+# Claude Code core lane
 claude mcp add nodebench -- npx -y nodebench-mcp
 
-# Windsurf / Cursor — add --preset to args in your MCP config when you want more than the default workflow surface
+# Claude Code power lane
+claude mcp add nodebench-power -- npx -y nodebench-mcp-power
+
+# Claude Code admin lane
+claude mcp add nodebench-admin -- npx -y nodebench-mcp-admin
+
+# Windsurf / Cursor - add --preset to args only when you want a compatibility preset on the core package
 ```
 
 ---
@@ -135,6 +141,8 @@ claude mcp add nodebench -- npx -y nodebench-mcp
 
 ```bash
 claude mcp add nodebench -- npx -y nodebench-mcp
+claude mcp add nodebench-power -- npx -y nodebench-mcp-power
+claude mcp add nodebench-admin -- npx -y nodebench-mcp-admin
 ```
 
 Or add to `~/.claude/settings.json` or `.mcp.json` in your project root:
@@ -172,9 +180,9 @@ Add to `.windsurf/mcp.json` (or Settings > MCP > View raw config):
 ```json
 {
   "mcpServers": {
-    "nodebench": {
+    "nodebench-power": {
       "command": "npx",
-      "args": ["-y", "nodebench-mcp", "--preset", "power"]
+      "args": ["-y", "nodebench-mcp-power"]
     }
   }
 }
@@ -182,7 +190,13 @@ Add to `.windsurf/mcp.json` (or Settings > MCP > View raw config):
 
 ### Other MCP Clients
 
-Any MCP-compatible client works. Point `command` to `npx`, `args` to `["-y", "nodebench-mcp"]`. Add `"--preset", "<name>"` to the args array for presets.
+Any MCP-compatible client works. Point `command` to `npx` and choose the package that matches the lane you want:
+
+- `["-y", "nodebench-mcp"]` for the tiny default workflow lane
+- `["-y", "nodebench-mcp-power"]` for the expanded founder/research lane
+- `["-y", "nodebench-mcp-admin"]` for the operator lane
+
+Add `"--preset", "<name>"` only when you want a compatibility preset on the core package.
 
 ### First Prompts to Try
 
@@ -232,17 +246,17 @@ Set these as environment variables, or add them to the `env` block in your MCP c
 
 ---
 
-## Progressive Discovery — How Optional Toolsets Stay Off the Hot Path
+## Progressive Discovery — How Optional Toolsets Stay Off the Hot Path
 
 The default preset exposes `9` tools. Everything else stays off the hot path until you deliberately load a specific toolset.
 
 ### How it works
 
 ```
-1. discover_tools("your task description")    → ranked results from the full registry
-2. load_toolset("ui_ux_dive")                 → a specific toolset activates in your session
-3. Use the newly loaded tools directly        → no proxy, native binding
-4. Keep the default surface small             → only load what the workflow needs
+1. discover_tools("your task description")    → ranked results from the full registry
+2. load_toolset("ui_ux_dive")                 → a specific toolset activates in your session
+3. Use the newly loaded tools directly        → no proxy, native binding
+4. Keep the default surface small             → only load what the workflow needs
 ```
 
 ### Multi-modal search engine
@@ -253,7 +267,7 @@ The default preset exposes `9` tools. Everything else stays off the hot path unt
 |---|---|
 | Keyword + TF-IDF | Exact matching, rare tags score higher |
 | Fuzzy (Levenshtein) | Tolerates typos |
-| Semantic (synonyms) | 30 word families — "check" finds "verify", "validate" |
+| Semantic (synonyms) | 30 word families — "check" finds "verify", "validate" |
 | N-gram + Bigram | Partial words and phrases |
 | Dense (TF-IDF cosine) | Vector-like ranking |
 | Embedding (neural) | Agent-as-a-Graph bipartite search |
@@ -284,7 +298,7 @@ Track actions, paths, and state across sessions. Important-change review surface
 
 ### Artifact Packets
 
-Every analysis produces a shareable artifact — decision memos, delegation briefs, investigation reports. The output is the distribution.
+Every analysis produces a shareable artifact — decision memos, delegation briefs, investigation reports. The output is the distribution.
 
 ### Founder Tools
 
@@ -292,7 +306,7 @@ Weekly reset, pre-delegation briefing, company tracking, important-change review
 
 ### Knowledge Compounding
 
-`record_learning` + `search_all_knowledge` — findings persist across sessions. By session 9, the agent finds 2+ relevant prior findings before writing a single line of code.
+`record_learning` + `search_all_knowledge` — findings persist across sessions. By session 9, the agent finds 2+ relevant prior findings before writing a single line of code.
 
 ---
 
@@ -332,7 +346,7 @@ npx nodebench-mcp --toolsets deep_sim,recon,learning
 # Exclude heavy toolsets
 npx nodebench-mcp --exclude vision,ui_capture,parallel
 
-# Dynamic loading — start minimal, load on demand
+# Dynamic loading — start minimal, load on demand
 npx nodebench-mcp --dynamic
 
 # Smart preset recommendation based on your project
@@ -348,7 +362,7 @@ npx nodebench-mcp --list-presets
 npx nodebench-mcp --help
 ```
 
-### TOON Format — Token Savings
+### TOON Format — Token Savings
 
 TOON (Token-Oriented Object Notation) is on by default. Every tool response is TOON-encoded for ~40% fewer tokens vs JSON. Disable with `--no-toon`.
 
@@ -361,7 +375,7 @@ NodeBench MCP runs locally on your machine.
 - All persistent data stored in `~/.nodebench/` (SQLite). No data sent to external servers unless you provide API keys and use tools that call external APIs.
 - Analytics data never leaves your machine.
 - The `local_file` toolset can read files anywhere your Node.js process has permission. Use the `default` preset to keep local-file tools off the hot path.
-- All API keys read from environment variables — never hardcoded or logged.
+- All API keys read from environment variables — never hardcoded or logged.
 - All database queries use parameterized statements.
 
 ---
@@ -391,22 +405,24 @@ Then use absolute path:
 
 ## Troubleshooting
 
-**"No search provider available"** — Set `GEMINI_API_KEY`, `OPENAI_API_KEY`, or `PERPLEXITY_API_KEY`
+**"No search provider available"** — Set `GEMINI_API_KEY`, `OPENAI_API_KEY`, or `PERPLEXITY_API_KEY`
 
-**"GitHub API error 403"** — Set `GITHUB_TOKEN` for higher rate limits
+**"GitHub API error 403"** — Set `GITHUB_TOKEN` for higher rate limits
 
-**"Cannot find module"** — Run `npm run build` in the mcp-local directory
+**"Cannot find module"** — Run `npm run build` in the mcp-local directory
 
-**MCP not connecting** — Check path is absolute, run `claude --mcp-debug`, ensure Node.js >= 18
+**MCP not connecting** — Check path is absolute, run `claude --mcp-debug`, ensure Node.js >= 18
 
-**Windsurf not finding tools** — Verify `~/.codeium/windsurf/mcp_config.json` has correct JSON structure
+**Windsurf not finding tools** — Verify `~/.codeium/windsurf/mcp_config.json` has correct JSON structure
 
-**Cursor tools not loading** — Ensure `.cursor/mcp.json` exists in project root. Use `--preset cursor` to stay within the tool cap. Restart Cursor after config changes.
+**Cursor tools not loading** — Ensure `.cursor/mcp.json` exists in project root. Use `--preset cursor` to stay within the tool cap. Restart Cursor after config changes.
 
-**Dynamic loading not working** — Claude Code and GitHub Copilot support native dynamic loading. For Windsurf/Cursor, prefer `--preset cursor` or `--preset power` if your client does not refresh tools reliably after `load_toolset`.
+**Dynamic loading not working** — Claude Code and GitHub Copilot support native dynamic loading. For Windsurf/Cursor, prefer `--preset cursor` or `--preset power` if your client does not refresh tools reliably after `load_toolset`.
 
 ---
 
 ## License
 
 MIT
+
+

package/dist/index.js

@@ -527,9 +527,9 @@ if (healthFlag) {
     const warn = `${Y}WARN${X}`;
     const fail = `${R}FAIL${X}`;
     const lines = [];
-    lines.push(`${B}NodeBench MCP v${NODEBENCH_VERSION} — Health Check${X}`);
+    lines.push(`${B}${DISPLAY_NAME} v${NODEBENCH_VERSION} - Health Check${X}`);
     lines.push("");
-    // 1. Tool count + preset — load only the active preset for a fast health path
+    // 1. Tool count + preset - load only the active preset for a fast health path
     const activePreset = requestedPreset;
     const presetToolsets = PRESETS[activePreset];
     if (presetToolsets) {
@@ -609,7 +609,7 @@ if (healthFlag) {
         ["tesseract.js", "OCR text extraction"],
         ["pdf-parse", "PDF parsing"],
         ["mammoth", "DOCX parsing"],
-        ["xlsx", "Spreadsheet parsing"],
+        ["read-excel-file", "Spreadsheet parsing"],
     ];
     for (const [pkg, desc] of pkgChecks) {
         const installed = _isInstalled(pkg);
@@ -694,7 +694,7 @@ if (statusFlag) {
     const Database = (await import("better-sqlite3")).default;
     const db = new Database(dbPath, { readonly: true });
     const lines = [];
-    lines.push(`${B}NodeBench MCP — System Status${X}`);
+    lines.push(`${B}${DISPLAY_NAME} - System Status${X}`);
     lines.push("");
     // Uptime info from DB (last tool call as proxy for when server was active)
     try {
@@ -726,7 +726,7 @@ if (statusFlag) {
         // Error trend
         const errPrevHour = db.prepare(`SELECT COUNT(*) as cnt FROM tool_call_log WHERE result_status='error' AND created_at > datetime('now', '-2 hours') AND created_at <= datetime('now', '-1 hour')`).get();
         const direction = errors1h.cnt > errPrevHour.cnt ? `${R}increasing${X}` : errors1h.cnt < errPrevHour.cnt ? `${G}decreasing${X}` : `${G}stable${X}`;
-        lines.push(`${C}Error Trend${X}  ${direction} (${errPrevHour.cnt} prev hour → ${errors1h.cnt} this hour)`);
+        lines.push(`${C}Error Trend${X}  ${direction} (${errPrevHour.cnt} prev hour -> ${errors1h.cnt} this hour)`);
         // Active verification cycles
         const activeCycles = db.prepare(`SELECT COUNT(*) as cnt FROM verification_cycles WHERE status IN ('active', 'in_progress')`).get();
         if (activeCycles.cnt > 0) {
@@ -761,7 +761,7 @@ if (diagnoseFlag) {
     const Database = (await import("better-sqlite3")).default;
     const db = new Database(dbPath);
     const lines = [];
-    lines.push(`${B}NodeBench MCP — Diagnose & Heal${X}`);
+    lines.push(`${B}${DISPLAY_NAME} - Diagnose & Heal${X}`);
     lines.push("");
     let issueCount = 0;
     let healedCount = 0;
@@ -966,7 +966,7 @@ if (syncConfigsFlag) {
         return { action: hadExisting ? "updated" : "created", path: filePath };
     }
     const lines = [];
-    lines.push(`${B}NodeBench MCP — Sync IDE Configs${X}`);
+    lines.push(`${B}${DISPLAY_NAME} - Sync IDE Configs${X}`);
     lines.push("");
     const results = [];
     // 1. Claude Code: ~/.claude/claude_desktop_config.json
@@ -1394,10 +1394,10 @@ if (subCmd === "call") {
     const D = USE_COLOR ? "\x1b[2m" : "";
     const X = USE_COLOR ? "\x1b[0m" : "";
     if (!toolName) {
-        console.log(`\n  ${B}Usage:${X} npx nodebench-mcp call <tool_name> [json_args]\n`);
-        console.log(`  ${D}Example:${X} npx nodebench-mcp call founder_deep_context_gather '{"packetType":"weekly_reset"}'`);
-        console.log(`  ${D}Example:${X} npx nodebench-mcp call discover_tools '{"query":"founder"}'`);
-        console.log(`  ${D}Example:${X} npx nodebench-mcp call save_session_note '{"note":"test"}'\n`);
+        console.log(`\n  ${B}Usage:${X} ${NPX_COMMAND} call <tool_name> [json_args]\n`);
+        console.log(`  ${D}Example:${X} ${NPX_COMMAND} call founder_deep_context_gather '{"packetType":"weekly_reset"}'`);
+        console.log(`  ${D}Example:${X} ${NPX_COMMAND} call discover_tools '{"query":"founder"}'`);
+        console.log(`  ${D}Example:${X} ${NPX_COMMAND} call save_session_note '{"note":"test"}'\n`);
         process.exit(0);
     }
     // Find tool in all toolsets — meta/discovery tools are created later,
@@ -1409,7 +1409,7 @@ if (subCmd === "call") {
     const tool = allCallable.find(t => t.name === toolName);
     if (!tool) {
         console.log(`\n  ${R}Tool not found:${X} ${toolName}`);
-        console.log(`  ${D}Run: npx nodebench-mcp discover ${toolName}${X}\n`);
+        console.log(`  ${D}Run: ${NPX_COMMAND} discover ${toolName}${X}\n`);
         process.exit(1);
     }
     let parsedArgs;
@@ -1449,22 +1449,22 @@ if (subCmd === "setup") {
     const X = USE_COLOR ? "\x1b[0m" : "";
     const lines = [];
     lines.push("");
-    lines.push(`  ${B}NodeBench MCP — Quick Setup${X}`);
+    lines.push(`  ${B}${DISPLAY_NAME} - Quick Setup${X}`);
     lines.push("");
     lines.push(`  ${G}1.${X} ${B}Claude Code${X}`);
-    lines.push(`     claude mcp add nodebench -- npx -y nodebench-mcp`);
+    lines.push(`     claude mcp add ${SERVER_KEY} -- ${NPX_Y_COMMAND}`);
     lines.push("");
     lines.push(`  ${G}2.${X} ${B}Cursor${X}  ${D}(.cursor/mcp.json)${X}`);
-    lines.push(`     { "mcpServers": { "nodebench": { "command": "npx", "args": ["-y", "nodebench-mcp"] } } }`);
+    lines.push(`     { "mcpServers": { "${SERVER_KEY}": { "command": "npx", "args": ["-y", "${NODEBENCH_NPX_PACKAGE}"] } } }`);
     lines.push("");
     lines.push(`  ${G}3.${X} ${B}Windsurf${X}  ${D}(.windsurf/mcp.json)${X}`);
-    lines.push(`     { "mcpServers": { "nodebench": { "command": "npx", "args": ["-y", "nodebench-mcp"] } } }`);
+    lines.push(`     { "mcpServers": { "${SERVER_KEY}": { "command": "npx", "args": ["-y", "${NODEBENCH_NPX_PACKAGE}"] } } }`);
     lines.push("");
-    lines.push(`  ${C}Verify:${X}  npx nodebench-mcp call discover_tools '{"query":"founder"}'`);
+    lines.push(`  ${C}Verify:${X}  ${NPX_COMMAND} call discover_tools '{"query":"founder"}'`);
     lines.push(`  ${C}Dashboard:${X}  https://www.nodebenchai.com/founder`);
     lines.push(`  ${C}Agent setup:${X}  https://www.nodebenchai.com/agent-setup.txt`);
     lines.push("");
-    lines.push(`  ${Y}Presets:${X}  --preset default (core workflow) | --preset power | --preset admin`);
+    lines.push(`  ${Y}Compatibility presets on core package:${X}  --preset default | --preset power | --preset admin`);
     lines.push(`  ${Y}Founder tools:${X}  founder_deep_context_gather, founder_packet_validate, founder_packet_diff`);
     lines.push("");
     console.log(lines.join("\n"));