@cachly-dev/mcp-server 0.10.74 → 0.10.76

package/README.md

@@ -331,6 +331,40 @@ sessions + WIP registry — typically one tool call.
 
 ---
 
+## Editor support matrix
+
+`npx @cachly-dev/mcp-server@latest setup` auto-detects and configures all of the
+following. Manual snippets are in the **Manual Setup** section below.
+
+| Editor / Client | Auto-setup | Config file written | Global config | Notes |
+|---|---|---|---|---|
+| **Claude Code** | ✅ | `~/.claude/mcp.json` + `.mcp.json` | ✅ global always | Runtime device-flow sign-in on first tool call |
+| **Cursor** | ✅ detected via `.cursor/` | `.cursor/mcp.json` | — | Project-level; restart Cursor after setup |
+| **Windsurf** | ✅ detected via `.windsurf/` | `.windsurf/mcp.json` | — | Project-level; restart Windsurf after setup |
+| **VS Code + Copilot** | ✅ detected via `.vscode/` | `.vscode/mcp.json` | — | Requires VS Code MCP extension or Copilot chat |
+| **Cline** | ✅ detected via VS Code | `.vscode/mcp.json` | — | Shares config with Copilot; restart VS Code |
+| **Continue.dev** | ✅ detected via `.continue/` | `.continue/config.json` | — | Uses `modelContextProtocolServers` key |
+| **Zed** | ✅ detected via `.zed/` | `.zed/settings.json` | — | Uses `context_servers` key |
+| **Windsurf (global)** | `setup --editor windsurf` | `~/.windsurf/mcp.json` | ✅ | Pass `--editor` to target global config |
+| **Any other MCP client** | `init --editor claude` | `.mcp.json` | — | Standard `mcpServers` stdio format |
+
+**Which sign-in path each editor uses:**
+
+| Scenario | Path |
+|---|---|
+| `setup` from a real terminal (TTY) | OAuth device-flow → browser click → API key saved automatically |
+| `setup` from VSCode task / CI (non-TTY) | Auto-detects non-interactive, opens browser with step-by-step guide, prints `CACHLY_JWT=... setup` instruction |
+| First tool call from Claude Code (no JWT yet) | Inline device-flow: MCP returns URL + code, browser opens automatically, next call proceeds |
+| `CACHLY_JWT=cky_live_xxx npx ... setup` | Skips auth step entirely, uses provided key |
+
+> **Tip — fastest per-project setup from inside Claude Code:**
+> ```
+> Set up cachly for this project: npx @cachly-dev/mcp-server@latest setup
+> ```
+> Claude runs it and restarts automatically.
+
+---
+
 ## Manual Setup
 
 <details>

package/dist/src/handlers/brain.js

@@ -7,8 +7,22 @@ import { keywordSearch, tokenize, splitMultiQuery, levenshtein, indexVocab as _i
 import { rerankByQuality } from '../rerank.js';
 import { computeEmbedding, hasEmbedProvider } from '../embeddings.js';
 // ── Changelog (shown once per version in session_start) ──────────────────────
-const MCP_VERSION = '0.10.73';
+const MCP_VERSION = '0.10.76';
 const WHATS_NEW = {
+    '0.10.76': [
+        `📊 **Agent-trace benchmark + editor matrix + setup timer**`,
+        `  📂 New \`agent-traces-corpus.json\` — 22 lessons, 15 queries, realistic AI-agent debug patterns`,
+        `  🏆 Benchmark result: **P@1 +66.7%, MRR +9.5% vs flat-file** (adversarial failure-distractors per category)`,
+        `  📋 README: first-class editor support matrix (Claude Code, Cursor, Windsurf, VSCode, Cline, Continue.dev, Zed)`,
+        `  ⏱️  setup now shows elapsed time + "Brain is ready" banner at the end`,
+    ],
+    '0.10.75': [
+        `🩹 **Setup hardened — works from the VSCode plugin & any non-TTY terminal**`,
+        `  🔌 \`setup\` no longer hangs on a non-interactive stdin (VSCode tasks, CI) — auto-detects + runs in automatic mode`,
+        `  🔐 Device-flow now uses the API proxy first (the old direct-Keycloak call returned 403) — sign-in actually completes`,
+        `  🌐 When auto sign-in is unavailable, the browser opens with a step-by-step API-key guide instead of a silent paste prompt`,
+        `  📊 Funnel fix: \`device_flow_completed\` / \`device_flow_failed(reason)\` now emitted from setup too`,
+    ],
     '0.10.73': [
         `🔐 **Team visibility scopes + one-command init + external bench**`,
         `  🆕 \`team_grant_scope\` / \`team_scopes\` — scope lessons to a sub-team (group="security"); only members + admins recall them`,