@monoes/monomindcli 2.11.0 → 2.11.2

package/.claude/commands/coordination/agent-spawn.md

@@ -32,7 +32,7 @@ npx monomind agent spawn --type coder --name bot-1
 npx monomind agent spawn --type researcher --task "Research React 19 concurrent features"
 
 # Spawn with specific provider and model
-npx monomind agent spawn --type architect --provider anthropic --model claude-sonnet-4-6
+npx monomind agent spawn --type architect --provider anthropic --model claude-sonnet-5
 
 # Spawn with auto tools and timeout
 npx monomind agent spawn --type coder --auto-tools --timeout 300

package/.claude/commands/mastermind/review.md

@@ -1,4 +1,4 @@
-<!-- Mastermind review domain — code review, security audit, content and strategy review. Default mode: auto. -->
+<!-- Mastermind review domain — code review, security audit, content and strategy review. Trigger on "review this session's work," "full review of this session," or "review this worktree" — add --tillend for exhaustive find-fix-verify looping. Default mode: auto. -->
 
 **First — extract repeat flags:** Follow the REPEAT PREAMBLE from `mastermind-repeat/SKILL.md`. Extracts `--repeat`, `--tillend`, `--maxruns`, `--wait`, `--rep`, `--loop` from `$ARGUMENTS` before all other parsing. If `is_continuation = true`, skip the empty-prompt check and intake below.
 

package/.claude/helpers/statusline.cjs

@@ -209,9 +209,14 @@ function getGitInfo() {
 
 // Normalise a model ID string to a short display name
 function modelLabel(id) {
-  if (id.includes('opus'))   return 'Opus 4.6';
-  if (id.includes('sonnet')) return 'Sonnet 4.6';
-  if (id.includes('haiku'))  return 'Haiku 4.5';
+  // Derive the version from the id (claude-sonnet-5 -> "Sonnet 5", claude-opus-4-6 -> "Opus 4.6")
+  // instead of assuming every sonnet/opus id is one fixed release.
+  const m = id.match(/(fable|opus|sonnet|haiku)(?:-(\d+)(?:-(\d{1,2}))?(?!\d))?/);
+  if (m) {
+    const family = m[1][0].toUpperCase() + m[1].slice(1);
+    if (!m[2]) return family;
+    return family + ' ' + (m[3] ? m[2] + '.' + m[3] : m[2]);
+  }
   return id.split('-').slice(1, 3).join(' ');
 }
 
@@ -302,7 +307,7 @@ function getModelName() {
   const claudeModel = process.env.CLAUDE_CODE_MODEL;
   if (claudeModel) return modelLabel(claudeModel);
 
-  return 'Sonnet 4.6'; // known current default rather than the generic "Claude Code"
+  return 'Sonnet 5'; // known current default rather than the generic "Claude Code"
 }
 
 // Get learning stats from memory database (pure stat calls)

package/.claude/helpers/token-tracker.cjs

@@ -14,9 +14,10 @@ const path = require('path');
 const WEB_SEARCH_COST = 0.01;
 
 const FALLBACK_PRICING = {
+  'claude-fable-5-1': { in: 10e-6, out: 50e-6, cw: 12.5e-6, cr: 0.25e-6, fast: 1 },
   'claude-opus-5':    { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6,  fast: 6 },
   'claude-opus-4-7':  { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6,  fast: 6 },
-  'claude-sonnet-5':  { in: 3e-6, out: 15e-6, cw: 3.75e-6, cr: 0.3e-6,  fast: 1 },
+  'claude-sonnet-5':  { in: 2e-6, out: 10e-6, cw: 2.5e-6, cr: 0.2e-6,  fast: 1 },
   'claude-opus-4-6':  { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6,  fast: 6 },
   'claude-opus-4-5':  { in: 5e-6, out: 25e-6, cw: 6.25e-6, cr: 0.5e-6,  fast: 1 },
   'claude-opus-4-1':  { in: 15e-6, out: 75e-6, cw: 18.75e-6, cr: 1.5e-6, fast: 1 },
@@ -36,6 +37,7 @@ const FALLBACK_PRICING = {
 };
 
 const SHORT_MODEL_NAMES = {
+  'claude-fable-5-1': 'Fable 5.1',
   'claude-opus-5': 'Opus 5',
   'claude-opus-4-7': 'Opus 4.7',
   'claude-sonnet-5': 'Sonnet 5',
@@ -62,7 +64,8 @@ const SHORT_MODEL_NAMES = {
 // carry this map; this file previously lacked it entirely, so a caller
 // using a bare "--model sonnet"/"haiku"/"opus" string went unpriced here
 // even though every sibling table would have resolved it.
-var MODEL_ALIAS = { haiku: 'claude-haiku-4-5', sonnet: 'claude-sonnet-4-6', opus: 'claude-opus-4-6' };
+// sonnet -> claude-sonnet-5 = DEFAULT_CLAUDE_MODEL (src/orgrt/vercel-providers.ts); .cjs can't import TS.
+var MODEL_ALIAS = { haiku: 'claude-haiku-4-5-20251001', sonnet: 'claude-sonnet-5', opus: 'claude-opus-5', fable: 'claude-fable-5-1' };
 
 function getCanonical(model) {
   var stripped = model.replace(/@.*$/, '').replace(/-\d{8}$/, '');

package/.claude/skills/mastermind-adapters/SKILL.md

@@ -33,9 +33,10 @@ If `caller` is not "command", load brain context following mastermind-protocol/S
 | Type | Label | Source | Notes |
 |------|-------|--------|-------|
 | `claude-local` | Claude (local CLI) | built-in | Uses `claude` CLI |
-| `claude-opus-4-7` | Claude Opus 4.7 | built-in | High capability |
-| `claude-sonnet-4-6` | Claude Sonnet 4.6 | built-in | Balanced (default) |
-| `claude-haiku-4-5` | Claude Haiku 4.5 | built-in | Fast, low cost |
+| `claude-fable-5-1` | Claude Fable 5.1 | built-in | Most capable, highest cost |
+| `claude-opus-5` | Claude Opus 5 | built-in | High capability |
+| `claude-sonnet-5` | Claude Sonnet 5 | built-in | Balanced (default — the org runtime default, `DEFAULT_CLAUDE_MODEL`) |
+| `claude-haiku-4-5-20251001` | Claude Haiku 4.5 | built-in | Fast, low cost |
 | `gemini-local` | Gemini (local) | built-in | Uses `gemini` CLI |
 | `codex-local` | Codex (local) | built-in | Uses `codex` CLI |
 | `cursor` | Cursor | built-in | Uses Cursor agent |
@@ -54,7 +55,7 @@ orgFile=".monomind/orgs/${org_name}.json"
 adaptersFile=".monomind/orgs/${org_name}-adapters.json"
 if [ ! -f "$adaptersFile" ]; then
   # Bootstrap from org config adapter_config if present
-  defaultModel=$(jq -r '.run_config.ceo_adapter // "claude-sonnet-4-6"' "$orgFile")
+  defaultModel=$(jq -r '.run_config.ceo_adapter // "claude-sonnet-5"' "$orgFile")
   cat > "$adaptersFile" <<EOF
 {
   "org": "${org_name}",
@@ -81,7 +82,7 @@ echo "────────────────────────
 printf "%-22s %-28s %-10s %-8s %s\n" "TYPE" "LABEL" "SOURCE" "MODELS" "STATUS"
 echo "──────────────────────────────────────────────────────"
 
-defaultAdap=$(jq -r '.default_adapter // "claude-sonnet-4-6"' "$adaptersFile")
+defaultAdap=$(jq -r '.default_adapter // "claude-sonnet-5"' "$adaptersFile")
 
 jq -r --arg def "$defaultAdap" '
   (.adapters // [])[] |

package/.claude/skills/mastermind-agents/SKILL.md

@@ -94,20 +94,21 @@ Add a new role to the org. Prompt the user for:
 ADAPTER / MODEL
 ───────────────
 Available Claude models:
-  1. claude-sonnet-4-6    → balanced capability + speed (Recommended)
-  2. claude-opus-4-7      → highest capability, slower
-  3. claude-haiku-4-5     → fastest, lowest cost
+  1. claude-sonnet-5            → balanced capability + speed (Recommended)
+  2. claude-opus-5              → high capability, slower
+  3. claude-fable-5-1           → most capable, highest cost
+  4. claude-haiku-4-5-20251001  → fastest, lowest cost
 
 Enter choice [1]:
 ```
 
-Set `adapter_config.model` from selection. Default: `claude-sonnet-4-6`.
+Set `adapter_config.model` from selection. Default: `claude-sonnet-5` (the org runtime default, `DEFAULT_CLAUDE_MODEL`).
 
 Append to `.monomind/orgs/<org_name>.json` roles array using jq:
 
 ```bash
-# model from adapter picker (default: claude-sonnet-4-6)
-adapter_model="${selected_model:-claude-sonnet-4-6}"
+# model from adapter picker (default: claude-sonnet-5)
+adapter_model="${selected_model:-claude-sonnet-5}"
 
 tmp="${orgFile}.tmp"
 jq --arg id "$agent_id" \

package/.claude/skills/mastermind-createorg/SKILL.md

@@ -83,11 +83,30 @@ Skip `ui.icon` whenever there isn't a clean match — an unmatched or omitted `i
 
 ---
 
-## Step 2.4 — Optional Per-Role Settings
+## Step 2.4 — Per-Role Model and Optional Settings
 
-For any role that needs non-default behavior, set (all optional — omit to inherit defaults):
+**`adapter_config.model` — REQUIRED on every role.** Always write an explicit model; never leave a role to inherit a runtime default. A role without one silently moves to whatever model a later release makes the default, and the Step 4 MODELS table can't show what the role will really run on.
+
+- If the user named or clearly implied a model for a role ("the researcher should use Opus" → `"claude-opus-5"`), use it.
+- Otherwise set the **latest model for that role's runtime/vendor**:
+  - Claude runtime (the default — no `provider`/`runtime`, or `provider.kind` `subscription` / `api-key`): **`"claude-sonnet-5"`** — the org runtime default, `DEFAULT_CLAUDE_MODEL` in `orgrt/vercel-providers.ts`.
+  - Any other runtime or vendor: use the value the runtime itself falls back to, read from the installed CLI package rather than from memory — `VENDOR_DEFAULTS[vendor]` (when the role has `provider.vendor`) or the `runtime` switch in `resolveModel()` (`orgrt/session.ts`), and `VERCEL_PROVIDERS[vendor].defaultModel` (`orgrt/vercel-providers.ts`). Source files live under `packages/@monomind/cli/src/orgrt/` in the source repository; in an installed package read `dist/src/orgrt/session.js` and `dist/src/orgrt/vercel-providers.js`. At this release those resolve to:
+
+    | Runtime / vendor | Latest model |
+    |------------------|--------------|
+    | `claude` (default), vendor `anthropic` | `claude-sonnet-5` |
+    | `codex` | `gpt-5.6-terra` |
+    | `antigravity` | `gemini-3.6-flash-high` |
+    | `kimicode` | `kimi-code/k3` |
+    | `opencode` (no vendor) | `glm-5.2` |
+    | `vercel` (no vendor), vendor `openai` | `gpt-5.5` |
+    | vendor `glm` / `google` / `xai` / `deepseek` | `glm-5.2` / `gemini-3.1-pro` / `grok-4.5` / `deepseek-chat` |
+
+    If the source you read disagrees with this table, the source wins. For vendor `openai-compatible` there is no default (it is `''`) — ask the user for the model id.
+- A role may deliberately run a different current model than its runtime's latest when that fits the role (e.g. `claude-opus-5` or `claude-fable-5-1` for a planner, `claude-haiku-4-5-20251001` for a checklist-style reviewer, as the `org create` templates do) — still an explicit value, and still a model from the current family, never a superseded id.
+
+For any role that needs non-default behavior, also set (all optional — omit to inherit defaults):
 
-- `adapter_config.model`: a model id (e.g. `"claude-opus-5"`, `"glm-5.2"`, `"gpt-5.6-terra"`) — default depends on runtime/vendor (see `resolveModel()` in `orgrt/session.ts`); explicit value always wins
 - `provider`: `{ kind, vendor?, apiKeyEnv?, baseUrl?, authTokenEnv? }` — default `subscription` (local Claude Code login). `kind` is one of:
   - `"subscription"` (default) — Claude Pro/Max via `claude login`
   - `"api-key"` — Anthropic API key
@@ -100,7 +119,7 @@ For any role that needs non-default behavior, set (all optional — omit to inhe
   - `webAllow: ["*"]` (or specific domains) for a role that does WebSearch/WebFetch as part of its job — an empty/unset `webAllow` silently blocks the exact task you just assigned it.
   - `autoApproveTools: [...]` — tool/action names this role may use without pausing for a human approval, even though they're normally on the sensitive-actions list (`Bash`, `WebFetch`, `WebSearch`, `org_complete`). **Mandatory, not optional, for any org with a `schedule` set** (an unattended/scheduled org): a role that pauses on `WebSearch` or `org_complete` waiting for a human who isn't there to click approve will deadlock forever on every scheduled run, repeatedly re-asking through both `ask_human` and `org_gate` with nothing to show for it. Grant every tool a scheduled org's roles routinely need — including `org_complete` for the boss role — rather than leaving the default human-approval gate in place for automation that's supposed to run with nobody watching.
 
-Do not invent values for these — only populate a field the user actually specified or clearly implied (e.g. "the researcher should use Opus" → that role's `adapter_config.model`).
+Apart from `adapter_config.model` (always set, per above), do not invent values for these — only populate `provider`, `runtime`, or `policy` when the user actually specified or clearly implied it, or when a role's responsibilities require it (the `webAllow`/`autoApproveTools` cases above).
 
 ---
 
@@ -127,7 +146,8 @@ Produce an org config object matching `OrgDefSchema` exactly:
       "title": "<display title>",
       "type": "boss | specialist | <domain synonym>",
       "reports_to": "<role id, or null for the single boss>",
-      "responsibilities": ["<3-6 specific duties — this text becomes part of the agent's role briefing>"]
+      "responsibilities": ["<3-6 specific duties — this text becomes part of the agent's role briefing>"],
+      "adapter_config": { "model": "<explicit model from Step 2.4, e.g. claude-sonnet-5>" }
     }
   ]
 }
@@ -135,7 +155,7 @@ Produce an org config object matching `OrgDefSchema` exactly:
 
 `status` starts `"stopped"` regardless of whether `schedule` is set — the org does not run until `monomind org run <name>` (one-shot) or `monomind org serve` (picks up any org whose `schedule` is set) is invoked.
 
-Only include `adapter_config`, `provider`, `policy`, or `ui` on a role when Step 2.3/2.4 populated them for it — leave them out entirely rather than writing empty objects.
+Every role carries `adapter_config.model` (Step 2.4). Only include `provider`, `policy`, or `ui` on a role when Step 2.3/2.4 populated them for it — leave them out entirely rather than writing empty objects.
 
 ---
 
@@ -153,14 +173,14 @@ MODELS  ← review this first
 ────────────────────────────────────────────────────
   ROLE                MODEL
   ──────────────────  ────────────────────────────
-  boss                claude-opus-5
-  content-writer       (runtime default)
-  content-reviewer     (runtime default)
+  boss                claude-sonnet-5
+  content-writer      claude-sonnet-5
+  content-reviewer    claude-sonnet-5
 
-  Only roles with an explicit adapter_config.model show a value; "(runtime
-  default)" roles inherit whatever resolveModel() picks for their
-  runtime/vendor at run time. To pin a role to a specific model, say so now
-  (e.g. "put content-writer on glm-5.2").
+  Every role shows the explicit adapter_config.model that will be saved —
+  the latest model for its runtime unless you asked for another. To put a
+  role on a different model, say so now (e.g. "put content-writer on
+  claude-opus-5").
 
 ROLES  (N roles — exactly one boss, every reports_to resolves to a real role id)
 ─────
@@ -237,6 +257,13 @@ else
   fi
   echo "✓ Structural checks passed (upgrade monomind for full schema validation)"
 fi
+
+# Every agent role must pin its model explicitly (Step 2.4).
+missing_model=$(jq -r '[.roles[] | select(.kind != "endpoint" and ((.adapter_config.model // "") == "")) | .id] | join(", ")' "$orgJson")
+if [ -n "$missing_model" ]; then
+  echo "ERROR: roles without an explicit adapter_config.model: ${missing_model} — set the latest model for their runtime (Step 2.4) and re-save."
+  exit 1
+fi
 ```
 
 ---
@@ -280,9 +307,9 @@ If `schedule` was set, also print:
 In **auto** mode (where Step 4's plan/model confirmation was skipped), always also print the models table so the user still sees — after the fact — what each role will run on, even though nothing blocked on it:
 ```
   Models:
-    boss                claude-opus-5
-    content-writer       (runtime default)
-    content-reviewer     (runtime default)
+    boss                claude-sonnet-5
+    content-writer      claude-sonnet-5
+    content-reviewer    claude-sonnet-5
   Adjust with: /mastermind:org-settings, or edit .monomind/orgs/<org_name>.json directly
 ```
 In **confirm** mode this table was already shown and accepted in Step 4 — do not repeat it here.

package/.claude/skills/mastermind-env/SKILL.md

@@ -55,7 +55,7 @@ echo ""
 # LLM / Adapter config
 echo "LLM PROVIDER"
 echo "────────────"
-ceo_model=$(jq -r '.run_config.ceo_adapter // "claude-sonnet-4-6"' "$orgFile")
+ceo_model=$(jq -r '.run_config.ceo_adapter // "claude-sonnet-5"' "$orgFile")
 echo "  CEO adapter model:  $ceo_model"
 jq -r '(.roles // [])[] | "  \(.id): \(.adapter_config.model // "inherited from CEO")"' "$orgFile" 2>/dev/null
 echo ""

package/.claude/skills/mastermind-invite-landing/SKILL.md

@@ -148,7 +148,7 @@ esac
 modelId="${model}"
 if [ -z "$modelId" ]; then
   case "$adapterType" in
-    claude-local)   modelId="claude-sonnet-4-6" ;;
+    claude-local)   modelId="claude-sonnet-5" ;;
     gemini-local)   modelId="gemini-2.0-flash" ;;
     codex-local)    modelId="gpt-4o" ;;
     cursor)         modelId="cursor-default" ;;

package/.claude/skills/mastermind-new-agent/SKILL.md

@@ -19,7 +19,7 @@ This skill is invoked by `mastermind:new-agent` or directly via `/mastermind:new
 - `agent_id`: unique slug for the new agent (required for create; auto-generated if omitted)
 - `title`: display title for the agent (required for create)
 - `adapter_type`: claude-local | gemini-local | codex-local | cursor | opencode | hermes | http | acpx (default: claude-local)
-- `model`: model identifier (e.g. claude-sonnet-4-6, claude-opus-4-7, gemini-2.0-flash)
+- `model`: model identifier (e.g. claude-sonnet-5, claude-opus-5, gemini-2.0-flash)
 - `max_tokens`: max tokens per run (default: 8192)
 - `reports_to`: parent agent id in the hierarchy (null = top-level)
 - `governance`: auto | board | strict (default: inherit from org)
@@ -36,7 +36,7 @@ This skill is invoked by `mastermind:new-agent` or directly via `/mastermind:new
 
 | Type | Description | Default Model |
 |------|-------------|---------------|
-| `claude-local` | Claude via Anthropic API | claude-sonnet-4-6 |
+| `claude-local` | Claude via Anthropic API | claude-sonnet-5 |
 | `gemini-local` | Gemini via Google API | gemini-2.0-flash |
 | `codex-local` | OpenAI Codex | gpt-4o |
 | `cursor` | Cursor IDE agent | cursor-default |
@@ -71,7 +71,7 @@ echo "AVAILABLE ADAPTERS"
 echo "────────────────────────────────────────────────────────"
 cat <<'ADAPTERS'
   claude-local    Claude via Anthropic API   (recommended)
-    Models: claude-sonnet-4-6, claude-opus-4-7, claude-haiku-4-5
+    Models: claude-sonnet-5, claude-opus-5, claude-fable-5-1, claude-haiku-4-5-20251001
   gemini-local    Gemini via Google AI
     Models: gemini-2.0-flash, gemini-1.5-pro
   codex-local     OpenAI Codex
@@ -108,7 +108,7 @@ modelId="${model}"
 # Default model per adapter
 if [ -z "$modelId" ]; then
   case "$adapterType" in
-    claude-local)  modelId="claude-sonnet-4-6" ;;
+    claude-local)  modelId="claude-sonnet-5" ;;
     gemini-local)  modelId="gemini-2.0-flash" ;;
     codex-local)   modelId="gpt-4o" ;;
     cursor)        modelId="cursor-default" ;;
@@ -149,7 +149,7 @@ adapterType="${adapter_type:-claude-local}"
 modelId="${model}"
 if [ -z "$modelId" ]; then
   case "$adapterType" in
-    claude-local)  modelId="claude-sonnet-4-6" ;;
+    claude-local)  modelId="claude-sonnet-5" ;;
     gemini-local)  modelId="gemini-2.0-flash" ;;
     codex-local)   modelId="gpt-4o" ;;
     cursor)        modelId="cursor-default" ;;

package/.claude/skills/mastermind-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mastermind-review
-description: Mastermind review domain — code review, content review, strategy review, security audit. Spawns a Review Manager coordinating a mesh of specialist reviewers for multi-angle assessment.
+description: Mastermind review domain — code review, content review, strategy review, security audit. Use for "review this session's work," "full review of this session," or "review this worktree" — add --tillend to loop find-fix-verify rounds until a round finds nothing left to fix, not just once. Spawns a Review Manager coordinating a mesh of specialist reviewers for multi-angle assessment.
 type: domain-skill
 default_mode: auto
 ---

package/.claude/skills/monomind/browse.md

@@ -652,7 +652,7 @@ AGENT_BROWSER_CONTENT_BOUNDARIES=1   # LLM-safe output delimiters
 AGENT_BROWSER_HEADED=1               # visible browser (debugging)
 AGENT_BROWSER_STREAM_PORT=9223       # fixed WebSocket stream port
 # No API key needed — monomind browse is built-in
-AI_GATEWAY_MODEL=anthropic/claude-sonnet-4-6
+AI_GATEWAY_MODEL=anthropic/claude-sonnet-5
 ```
 
 ---

package/bin/cli.js

@@ -16,10 +16,22 @@ import { randomUUID } from 'crypto';
 // Previously any `monomind` invocation with redirected stdin (CI pipes, xargs,
 // editor integrations) silently flipped into MCP server mode and accepted
 // JSON-RPC tools/call — privilege escalation by environment.
+//
+// Only the *bare* invocation (`mcp` or `mcp start`, no further args) takes
+// this fast path — which is also exactly what real MCP clients (Claude
+// Desktop, etc.) actually spawn. Any additional argument defers to the full
+// CLI (dist/src/index.js) instead. This fast path is a raw stdio JSON-RPC
+// loop that does not implement --help, --transport/-t, --port/-p, --daemon,
+// --force, or --tools at all — it used to swallow them silently and always
+// behave the same way regardless of what was passed, including printing
+// nothing for `mcp start --help` and starting a real server instead
+// (release 2.11.1 QA repro). The full CLI's `mcp start` command (mcp.ts)
+// is the only implementation of any of those flags.
 const cliArgs = process.argv.slice(2);
-const isExplicitMCP = cliArgs.length >= 1 && cliArgs[0] === 'mcp' && (cliArgs.length === 1 || cliArgs[1] === 'start');
+const isBareMCPInvocation =
+  cliArgs.length === 1 ? cliArgs[0] === 'mcp' : cliArgs.length === 2 && cliArgs[0] === 'mcp' && cliArgs[1] === 'start';
 const allowAutoDetect = process.env.MONOMIND_MCP_AUTODETECT === '1';
-const isMCPMode = !process.stdin.isTTY && (isExplicitMCP || (allowAutoDetect && process.argv.length === 2));
+const isMCPMode = !process.stdin.isTTY && (isBareMCPInvocation || (allowAutoDetect && process.argv.length === 2));
 
 if (isMCPMode) {
   // Run MCP server mode
@@ -50,6 +62,52 @@ if (isMCPMode) {
     );
   }
 
+  // Mirror the PID-file mechanism `mcp status`/`mcp health` read from a
+  // separate process (see MCPServerManager.writePidFile()/getStatus() in
+  // mcp-server.ts). Without this, this fast path was invisible to `mcp
+  // status`: it never goes through MCPServerManager.start(), so no PID file
+  // was ever written and status/health always reported "not running" even
+  // while a live stdio server was up (confirmed via `ps` at the same instant
+  // — release 2.11.1 QA repro). Same path/format/flags as
+  // MCPServerManager.writePidFile(): O_CREAT|O_EXCL so a pre-existing path
+  // (including a symlinked one) is never followed, with a stale-PID-file
+  // replace fallback on EEXIST.
+  try {
+    const { mkdirSync, writeFileSync, unlinkSync } = await import('fs');
+    const { homedir } = await import('os');
+    const { join: pathJoin } = await import('path');
+    const stateDir = pathJoin(homedir(), '.monomind');
+    mkdirSync(stateDir, { recursive: true, mode: 0o700 });
+    const pidFilePath = pathJoin(stateDir, 'mcp.pid');
+    try {
+      writeFileSync(pidFilePath, String(process.pid), { flag: 'wx', mode: 0o600 });
+    } catch (e) {
+      if (e && e.code === 'EEXIST') {
+        unlinkSync(pidFilePath);
+        writeFileSync(pidFilePath, String(process.pid), { flag: 'wx', mode: 0o600 });
+      } else {
+        throw e;
+      }
+    }
+    // 'exit' handlers must finish synchronously, so this uses unlinkSync
+    // rather than the fs.promises API used elsewhere in this file.
+    process.on('exit', () => {
+      try {
+        unlinkSync(pidFilePath);
+      } catch {
+        /* already gone, or never successfully written */
+      }
+    });
+  } catch (e) {
+    // Best-effort: `mcp status` falling back to "not running" is far better
+    // than refusing to start the server over a PID-file write error.
+    if (process.env.MONOMIND_LOG_LEVEL === 'debug') {
+      console.error(
+        `[${new Date().toISOString()}] WARN [monomind-mcp] (${sessionId}) could not write PID file: ${e && e.message ? e.message : e}`
+      );
+    }
+  }
+
   // Top-level safety nets — without these, an unhandled async error in a tool
   // handler crashes the process with no observable cleanup.
   process.on('uncaughtException', (err) => {

package/dist/src/capabilities/cap-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cap-code.d.ts","sourceRoot":"","sources":["../../../src/capabilities/cap-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,gBAsB5B,CAAC"}
+{"version":3,"file":"cap-code.d.ts","sourceRoot":"","sources":["../../../src/capabilities/cap-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,YAAY,CAAC;AAcpB,eAAO,MAAM,cAAc,EAAE,gBAuE5B,CAAC"}

package/dist/src/capabilities/cap-code.js

@@ -1,16 +1,78 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Root directory to search under, captured from activate(). The
+ * CapabilityModule.search() signature takes only (query, limit) — no
+ * rootDir — so it has to be stashed somewhere between activate() and
+ * search() the same way cap-documents.ts stashes its in-memory index.
+ */
+let codeRootDir = '';
+function getMonographDbPath(rootDir) {
+    return path.join(rootDir, '.monomind', 'monograph.db');
+}
 export const codeCapability = {
     name: 'code',
     detect(scan) {
         return scan.capabilities.code.confidence;
     },
-    async activate(_rootDir) {
-        // monolean: no-op — existing init/monograph handles code projects
-        // This module exists so the manager can track code as a capability
+    async activate(rootDir) {
+        // monolean: no separate index of our own — code content is indexed by
+        // the existing monograph knowledge graph. search() below queries that
+        // graph directly, so activate() only needs to remember where it lives.
+        codeRootDir = rootDir;
     },
     async index(_files) {
         // monolean: existing monograph handles code indexing
         return { indexed: 0, skipped: 0, errors: [] };
     },
+    /**
+     * Delegates to monograph's FTS index rather than re-scanning files.
+     *
+     * Previously this method did not exist at all: CapabilityManager.search()
+     * only calls `module.search()` when a module defines one (it's optional
+     * on CapabilityModule), so the `code` capability silently contributed
+     * zero results to every top-level `monomind search` — including
+     * `--type code`, which is documented as a supported value — even though
+     * `monomind monograph search` found the exact same symbol via the same
+     * database.
+     */
+    async search(query, limit = 20) {
+        if (!codeRootDir)
+            return [];
+        const dbPath = getMonographDbPath(codeRootDir);
+        if (!fs.existsSync(dbPath))
+            return [];
+        try {
+            const { openDb, closeDb, ftsSearch } = await import('@monoes/monograph');
+            const db = openDb(dbPath);
+            try {
+                const rows = ftsSearch(db, query, limit);
+                return rows
+                    .filter((r) => r.filePath)
+                    .map((r) => ({
+                    path: r.filePath,
+                    // FTS5 rank is <= 0, more negative = better match; flip the sign
+                    // so higher score = better, matching CapabilityManager.search()'s
+                    // sort order across capabilities.
+                    score: -r.rank,
+                    snippet: r.startLine && r.startLine > 0
+                        ? `${r.label} ${r.name} (line ${r.startLine})`
+                        : `${r.label} ${r.name}`,
+                    type: 'code',
+                    metadata: { label: r.label, startLine: r.startLine, endLine: r.endLine },
+                }))
+                    .slice(0, limit);
+            }
+            finally {
+                closeDb(db);
+            }
+        }
+        catch {
+            // monograph unavailable or the DB is unreadable — the code capability
+            // just contributes no results rather than failing the whole search.
+            return [];
+        }
+    },
     async healthChecks() {
         // monolean: delegates to existing doctor checks when cap/code is active
         // The doctor command checks isActive('code') to decide which checks to run

package/dist/src/capabilities/cap-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"cap-code.js","sourceRoot":"","sources":["../../../src/capabilities/cap-code.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,MAAM;IAEZ,MAAM,CAAC,IAAmB;QACxB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,kEAAkE;QAClE,mEAAmE;IACrE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,qDAAqD;QACrD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,wEAAwE;QACxE,2EAA2E;QAC3E,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}
+{"version":3,"file":"cap-code.js","sourceRoot":"","sources":["../../../src/capabilities/cap-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B;;;;;GAKG;AACH,IAAI,WAAW,GAAG,EAAE,CAAC;AAErB,SAAS,kBAAkB,CAAC,OAAe;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,IAAI,EAAE,MAAM;IAEZ,MAAM,CAAC,IAAmB;QACxB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,sEAAsE;QACtE,sEAAsE;QACtE,uEAAuE;QACvE,WAAW,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,qDAAqD;QACrD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QACpC,IAAI,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACzE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBACzC,OAAO,IAAI;qBACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;qBACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACX,IAAI,EAAE,CAAC,CAAC,QAAkB;oBAC1B,iEAAiE;oBACjE,kEAAkE;oBAClE,kCAAkC;oBAClC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;oBACd,OAAO,EACL,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC;wBAC5B,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,SAAS,GAAG;wBAC9C,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE;oBAC5B,IAAI,EAAE,MAAe;oBACrB,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;iBACzE,CAAC,CAAC;qBACF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACrB,CAAC;oBAAS,CAAC;gBACT,OAAO,CAAC,EAAE,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sEAAsE;YACtE,oEAAoE;YACpE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,wEAAwE;QACxE,2EAA2E;QAC3E,OAAO,EAAE,CAAC;IACZ,CAAC;CACF,CAAC"}

package/dist/src/commands/analyze-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-diff.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze-diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AAkC1E,eAAO,MAAM,WAAW,EAAE,OAwTzB,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,OAsPzB,CAAC"}
+{"version":3,"file":"analyze-diff.d.ts","sourceRoot":"","sources":["../../../src/commands/analyze-diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAiC,MAAM,aAAa,CAAC;AAkC1E,eAAO,MAAM,WAAW,EAAE,OAyUzB,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,OAsPzB,CAAC"}

package/dist/src/commands/analyze-diff.js

@@ -139,15 +139,19 @@ export const diffCommand = {
                 risk.breakdown.breakingChanges = risk.breakdown.breakingChanges || [];
             }
             const classification = result.classification || {
-                category: 'unknown',
+                primary: 'unknown',
+                secondary: [],
                 confidence: 0,
-                reasoning: '',
+                impactLevel: 'low',
+                suggestedReviewers: [],
+                testingStrategy: [],
+                riskFactors: [],
             };
             output.printBox([
                 `Ref: ${result.ref || 'HEAD'}`,
                 `Files: ${files.length}`,
                 `Risk: ${getRiskDisplay(risk.overall)} (${risk.score}/100)`,
-                `Type: ${classification.category}${classification.subcategory ? ` (${classification.subcategory})` : ''}`,
+                `Type: ${classification.primary}${classification.secondary.length ? ` (${classification.secondary.join(', ')})` : ''}`,
                 ``,
                 result.summary || 'No summary available',
             ].join('\n'), 'Diff Analysis');
@@ -199,13 +203,19 @@ export const diffCommand = {
                         { key: 'value', header: 'Value', width: 40 },
                     ],
                     data: [
-                        { field: 'Category', value: classification.category },
-                        { field: 'Subcategory', value: classification.subcategory || '-' },
+                        { field: 'Category', value: classification.primary },
+                        {
+                            field: 'Subcategory',
+                            value: classification.secondary.length ? classification.secondary.join(', ') : '-',
+                        },
                         { field: 'Confidence', value: `${(classification.confidence * 100).toFixed(0)}%` },
+                        { field: 'Impact Level', value: classification.impactLevel },
                     ],
                 });
                 output.writeln();
-                output.writeln(output.dim(`Reasoning: ${classification.reasoning}`));
+                output.writeln(output.dim(classification.riskFactors.length
+                    ? `Risk factors: ${classification.riskFactors.join(', ')}`
+                    : 'No specific risk factors identified.'));
             }
             // Reviewers
             if (showReviewers || showAll) {