@brainbank/mcp 0.1.4 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @brainbank/mcp
2
2
 
3
- [MCP](https://modelcontextprotocol.io/) server for [BrainBank](https://github.com/pinecall/brainbank) — exposes code search, git history, and collections as tools for AI agents via stdio transport.
3
+ [MCP](https://modelcontextprotocol.io/) server for [BrainBank](https://github.com/pinecall/brainbank) — exposes code context as a single tool for AI agents via stdio transport.
4
4
 
5
5
  ## Install
6
6
 
@@ -8,6 +8,12 @@
8
8
  npm install @brainbank/mcp
9
9
  ```
10
10
 
11
+ Plugin packages are optional peer dependencies — install whichever you need:
12
+
13
+ ```bash
14
+ npm install @brainbank/code @brainbank/git @brainbank/docs
15
+ ```
16
+
11
17
  ## Quick Start
12
18
 
13
19
  ### Antigravity
@@ -19,10 +25,7 @@ Add to `~/.gemini/antigravity/mcp_config.json`:
19
25
  "mcpServers": {
20
26
  "brainbank": {
21
27
  "command": "npx",
22
- "args": ["-y", "@brainbank/mcp"],
23
- "env": {
24
- "BRAINBANK_EMBEDDING": "openai"
25
- }
28
+ "args": ["-y", "@brainbank/mcp"]
26
29
  }
27
30
  }
28
31
  }
@@ -37,11 +40,7 @@ Add to Claude Desktop settings → Developer → MCP Servers:
37
40
  "mcpServers": {
38
41
  "brainbank": {
39
42
  "command": "npx",
40
- "args": ["-y", "@brainbank/mcp"],
41
- "env": {
42
- "BRAINBANK_EMBEDDING": "openai",
43
- "OPENAI_API_KEY": "sk-..."
44
- }
43
+ "args": ["-y", "@brainbank/mcp"]
45
44
  }
46
45
  }
47
46
  }
@@ -56,10 +55,7 @@ Add to `.cursor/mcp.json` in your project:
56
55
  "mcpServers": {
57
56
  "brainbank": {
58
57
  "command": "npx",
59
- "args": ["-y", "@brainbank/mcp"],
60
- "env": {
61
- "BRAINBANK_EMBEDDING": "openai"
62
- }
58
+ "args": ["-y", "@brainbank/mcp"]
63
59
  }
64
60
  }
65
61
  }
@@ -71,45 +67,90 @@ Add to `.cursor/mcp.json` in your project:
71
67
  brainbank serve
72
68
  ```
73
69
 
74
- ## Environment Variables
70
+ ## Zero-Config
75
71
 
76
- | Variable | Description | Default |
77
- |----------|-------------|---------|
78
- | `BRAINBANK_REPO` | Default repo path (fallback if `repo` param not provided) | — |
79
- | `BRAINBANK_EMBEDDING` | Embedding provider: `openai` or `local` | `local` |
80
- | `OPENAI_API_KEY` | Required when using `openai` embeddings | — |
81
-
82
- > The agent passes the `repo` parameter per tool call based on the active workspace — no hardcoded paths needed.
83
-
84
- ## Available Tools
85
-
86
- | Tool | Description |
87
- |------|-------------|
88
- | `brainbank_hybrid_search` | Best quality: vector + BM25 fused search |
89
- | `brainbank_search` | Semantic vector search |
90
- | `brainbank_keyword_search` | Instant BM25 full-text search |
91
- | `brainbank_context` | Formatted context for system prompt injection |
92
- | `brainbank_index` | Trigger incremental code/git indexing |
93
- | `brainbank_stats` | Index statistics (files, commits, chunks) |
94
- | `brainbank_history` | Git history for a specific file |
95
- | `brainbank_coedits` | Files that frequently change together |
96
- | `brainbank_collection_add` | Add item to a KV collection |
97
- | `brainbank_collection_search` | Semantic search within a collection |
98
- | `brainbank_collection_trim` | Trim a collection to N most recent items |
72
+ The MCP server auto-detects everything:
99
73
 
100
- ## Multi-Workspace
74
+ - **Repo path** — from `repo` tool param > `BRAINBANK_REPO` env > `findRepoRoot(cwd)`
75
+ - **Embedding provider** — from `.brainbank/config.json` > `BRAINBANK_EMBEDDING` env > `provider_key` stored in DB > falls back to local
76
+ - **Plugins** — reads `plugins` array from `config.json` (default: `['code']`). Loaded dynamically by the core factory — no hardcoded imports
101
77
 
102
- The MCP server maintains a pool of BrainBank instances — one per unique `repo` path. Each tool call can target a different workspace:
78
+ Index your repo once with the CLI:
79
+
80
+ ```bash
81
+ brainbank index . --yes
82
+ ```
83
+
84
+ After that, the MCP server auto-resolves the correct provider — no env vars needed.
85
+
86
+ ## Tools (2)
87
+
88
+ ### `brainbank_context`
89
+
90
+ **Primary tool.** Returns a Workflow Trace:
103
91
 
104
92
  ```typescript
105
- // Agent working in one workspace
106
- brainbank_hybrid_search({ query: "login form", repo: "/Users/you/project-a" })
93
+ brainbank_context({
94
+ task: string, // what you're trying to understand or implement
95
+ affectedFiles?: string[], // files you plan to modify (improves co-edit suggestions)
96
+ codeResults?: number, // max code results (default: 6)
97
+ gitResults?: number, // max git commit results (default: 5)
98
+ repo?: string, // repository path (default: auto-detect)
99
+ })
100
+ ```
101
+
102
+ Returns a **Workflow Trace** — a single flat `## Code Context` section with:
103
+ - Search hits with `% match` scores
104
+ - Full call tree (3 levels deep) with `called by` annotations
105
+ - Part adjacency boost (multi-part functions shown complete)
106
+ - Trivial wrapper collapse (one-liners for delegation)
107
+ - All source code included — no trimming, no truncation
108
+
109
+ If the project is **not indexed**, the tool returns an error with the CLI command to run.
110
+
111
+ ### `brainbank_index`
107
112
 
108
- // Agent switches to another project new instance auto-created
109
- brainbank_hybrid_search({ query: "API routes", repo: "/Users/you/project-b" })
113
+ Re-index code/git/docs. Requires `.brainbank/config.json`. Incrementalonly changed files are processed.
114
+
115
+ ```typescript
116
+ brainbank_index({
117
+ forceReindex?: boolean, // force full re-index (default: false)
118
+ repo?: string, // repository path
119
+ })
110
120
  ```
111
121
 
112
- Instances are cached in memory after first initialization (~480ms), so subsequent queries to the same repo are fast.
122
+ ## Multi-Workspace
123
+
124
+ The MCP server manages a `WorkspacePool` of BrainBank instances — one per unique `repo` path. The pool uses memory-pressure eviction (configurable max memory) and TTL eviction (configurable idle timeout):
125
+
126
+ ```typescript
127
+ brainbank_context({ task: "login form", repo: "/project-a" })
128
+ brainbank_context({ task: "API routes", repo: "/project-b" })
129
+ ```
130
+
131
+ Instances are cached in memory after first initialization (~480ms). Active operations are tracked — the pool never evicts a workspace with in-flight queries.
132
+
133
+ ## Environment Variables
134
+
135
+ All optional — the server works without any env vars.
136
+
137
+ | Variable | Description | Default |
138
+ |----------|-------------|---------|
139
+ | `BRAINBANK_REPO` | Fallback repo path | auto-detect from cwd |
140
+ | `BRAINBANK_EMBEDDING` | Embedding provider key | from `config.json` or DB |
141
+ | `BRAINBANK_MAX_MEMORY_MB` | Maximum total pool memory in MB | `2048` |
142
+ | `BRAINBANK_TTL_MINUTES` | Idle workspace eviction timeout in minutes | `30` |
143
+ | `OPENAI_API_KEY` | Required when embedding provider is `openai` | — |
144
+ | `PERPLEXITY_API_KEY` | Required when embedding provider is `perplexity` / `perplexity-context` | — |
145
+
146
+ ## Architecture
147
+
148
+ ```
149
+ @brainbank/mcp
150
+ ├── mcp-server.ts ← MCP stdio server (1 tool: brainbank_context)
151
+ ├── workspace-pool.ts ← Memory-pressure + TTL eviction, active-op tracking
152
+ └── workspace-factory.ts ← Delegates to core createBrain() — no plugin hardcoding
153
+ ```
113
154
 
114
155
  ## How it works
115
156
 
@@ -117,10 +158,11 @@ Instances are cached in memory after first initialization (~480ms), so subsequen
117
158
  AI Agent ←→ stdio ←→ @brainbank/mcp ←→ BrainBank core ←→ SQLite
118
159
  ```
119
160
 
120
- 1. Agent sends an MCP tool call (e.g., `brainbank_hybrid_search`)
121
- 2. Server routes to the correct BrainBank instance (by `repo` path)
122
- 3. BrainBank executes the search against its local SQLite database
123
- 4. Results returned as structured JSON to the agent
161
+ 1. Agent sends `brainbank_context({ task: "..." })`
162
+ 2. `WorkspacePool` resolves `repo` gets/creates a BrainBank instance
163
+ 3. BrainBank calls `ensureFresh()` hot-reloads stale HNSW if needed
164
+ 4. BrainBank executes search + call tree + formatting
165
+ 5. Workflow Trace returned as markdown to the agent
124
166
 
125
167
  ## License
126
168
 
package/package.json CHANGED
@@ -1,17 +1,31 @@
1
1
  {
2
2
  "name": "@brainbank/mcp",
3
- "version": "0.1.4",
3
+ "version": "0.3.0",
4
4
  "description": "MCP (Model Context Protocol) server for BrainBank",
5
5
  "type": "module",
6
- "main": "dist/mcp-server.js",
7
- "bin": "dist/mcp-server.js",
8
- "files": ["dist/"],
9
- "scripts": { "build": "tsup" },
6
+ "main": "src/mcp-server.ts",
7
+ "bin": "src/mcp-server.ts",
8
+ "files": [
9
+ "src/"
10
+ ],
11
+ "scripts": {
12
+ "build": "tsup"
13
+ },
10
14
  "dependencies": {
11
- "brainbank": ">=0.1.0",
15
+ "brainbank": ">=0.2.2",
12
16
  "@modelcontextprotocol/sdk": "^1.27.1",
13
17
  "zod": "^4.3.6"
14
18
  },
19
+ "peerDependencies": {
20
+ "@brainbank/code": ">=0.1.0",
21
+ "@brainbank/git": ">=0.1.0",
22
+ "@brainbank/docs": ">=0.1.0"
23
+ },
24
+ "peerDependenciesMeta": {
25
+ "@brainbank/code": { "optional": true },
26
+ "@brainbank/git": { "optional": true },
27
+ "@brainbank/docs": { "optional": true }
28
+ },
15
29
  "repository": {
16
30
  "type": "git",
17
31
  "url": "git+https://github.com/pinecall/brainbank.git",
@@ -0,0 +1,265 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * BrainBank — MCP Server
5
+ *
6
+ * Exposes BrainBank as an MCP server via stdio transport.
7
+ * Works with Google Antigravity, Claude Desktop, and any MCP-compatible client.
8
+ *
9
+ * Usage in mcp_config.json:
10
+ * {
11
+ * "mcpServers": {
12
+ * "brainbank": {
13
+ * "command": "npx",
14
+ * "args": ["-y", "@brainbank/mcp"]
15
+ * }
16
+ * }
17
+ * }
18
+ *
19
+ * Tools (2):
20
+ * brainbank_context — Workflow Trace: search + call tree + called-by annotations
21
+ * brainbank_index — Re-index (requires .brainbank/config.json)
22
+ */
23
+
24
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
25
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
26
+ import { z } from 'zod/v3';
27
+ import { existsSync } from 'node:fs';
28
+ import { WorkspacePool } from './workspace-pool.js';
29
+ import { createWorkspaceBrain, resolveRepoPath } from './workspace-factory.js';
30
+
31
+
32
+
33
+ // ── Multi-Workspace BrainBank Pool ─────────────────────
34
+
35
+ const pool = new WorkspacePool({
36
+ factory: createWorkspaceBrain,
37
+ maxMemoryMB: parseInt(process.env.BRAINBANK_MAX_MEMORY_MB ?? '2048', 10),
38
+ ttlMinutes: parseInt(process.env.BRAINBANK_TTL_MINUTES ?? '30', 10),
39
+ onError: (repo, err) => {
40
+ const msg = err instanceof Error ? err.message : String(err);
41
+ console.error(`BrainBank pool error [${repo}]: ${msg}`);
42
+ },
43
+ });
44
+
45
+ /** Resolve repo and get a BrainBank from the pool. */
46
+ async function getBrainBank(targetRepo?: string) {
47
+ return pool.get(resolveRepoPath(targetRepo));
48
+ }
49
+
50
+ // ── MCP Server Setup ────────────────────────────────
51
+
52
+ const server = new McpServer({
53
+ name: 'brainbank',
54
+ version: '0.4.0',
55
+ });
56
+
57
+ // ── Tool: brainbank_context ─────────────────────────
58
+
59
+ server.registerTool(
60
+ 'brainbank_context',
61
+ {
62
+ title: 'BrainBank Context',
63
+ description:
64
+ 'Get a formatted knowledge context block for a task. Returns a Workflow Trace: ' +
65
+ 'search hits + full call tree with `called by` annotations, topologically ordered. ' +
66
+ 'All source code included — no trimming, no truncation.',
67
+ inputSchema: z.object({
68
+ task: z.string().describe('Description of the task you need context for'),
69
+ affectedFiles: z.array(z.string()).optional().default([]).describe('Files you plan to modify (improves co-edit suggestions)'),
70
+ codeResults: z.number().optional().default(20).describe('Max code results'),
71
+ gitResults: z.number().optional().default(5).describe('Max git commit results'),
72
+ docsResults: z.number().optional().describe('Max document results (omit to skip docs)'),
73
+ sources: z.record(z.number()).optional().describe('Per-source result limits, overrides codeResults/gitResults/docsResults (e.g. { code: 10, git: 0, docs: 5 })'),
74
+ path: z.string().optional().describe('Filter results to files under this path prefix (e.g. src/services/)'),
75
+ repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),
76
+ // BrainBankQL context fields
77
+ lines: z.boolean().optional().describe('Prefix each code line with its source line number (e.g. 127| code)'),
78
+ symbols: z.boolean().optional().describe('Append symbol index (all functions, classes, interfaces) for matched files'),
79
+ compact: z.boolean().optional().describe('Show only function/class signatures, skip bodies'),
80
+ callTree: z.union([z.boolean(), z.object({ depth: z.number() })]).optional().describe('Include call tree expansion. Pass { depth: N } to control depth'),
81
+ imports: z.boolean().optional().describe('Include dependency/import summary section'),
82
+ expander: z.boolean().optional().describe('Enable LLM-powered context expansion to discover related chunks not found by search'),
83
+ }),
84
+ },
85
+ async ({ task, affectedFiles, codeResults, gitResults, docsResults, sources, path, repo, lines, symbols, compact, callTree, imports, expander }) => {
86
+ const repoPath = resolveRepoPath(repo);
87
+ const brainbank = await getBrainBank(repo);
88
+
89
+ // Build sources from explicit params, then let `sources` override
90
+ const base: Record<string, number> = { code: codeResults, git: gitResults };
91
+ if (docsResults !== undefined) base.docs = docsResults;
92
+ const resolvedSources = sources ? { ...base, ...sources } : base;
93
+
94
+ // Build fields from explicit params (only include defined values)
95
+ const fields: Record<string, unknown> = {};
96
+ if (lines !== undefined) fields.lines = lines;
97
+ if (symbols !== undefined) fields.symbols = symbols;
98
+ if (compact !== undefined) fields.compact = compact;
99
+ if (callTree !== undefined) fields.callTree = callTree;
100
+ if (imports !== undefined) fields.imports = imports;
101
+ if (expander !== undefined) fields.expander = expander;
102
+
103
+ const context = await brainbank.getContext(task, {
104
+ affectedFiles,
105
+ sources: resolvedSources,
106
+ pathPrefix: path,
107
+ source: 'mcp',
108
+ fields: Object.keys(fields).length > 0 ? fields : undefined,
109
+ });
110
+
111
+ return { content: [{ type: 'text' as const, text: context }] };
112
+ },
113
+ );
114
+
115
+ // ── Tool: brainbank_index ───────────────────────────
116
+
117
+ server.registerTool(
118
+ 'brainbank_index',
119
+ {
120
+ title: 'BrainBank Index',
121
+ description:
122
+ 'Re-index code, git history, and docs. Requires .brainbank/config.json to exist. ' +
123
+ 'Incremental — only changed files are processed.',
124
+ inputSchema: z.object({
125
+ forceReindex: z.boolean().optional().default(false).describe('Force re-index of all files'),
126
+ repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),
127
+ }),
128
+ },
129
+ async ({ forceReindex, repo }) => {
130
+ const repoPath = resolveRepoPath(repo);
131
+
132
+ // Require config.json — force users to set up structure first
133
+ if (!existsSync(`${repoPath}/.brainbank/config.json`)) {
134
+ return {
135
+ content: [{
136
+ type: 'text' as const,
137
+ text:
138
+ `BrainBank: No .brainbank/config.json found at ${repoPath}.\n\n` +
139
+ `## How to set up\n\n` +
140
+ `Create \`${repoPath}/.brainbank/config.json\` with:\n\n` +
141
+ '```json\n' +
142
+ '{\n' +
143
+ ' "plugins": ["code"],\n' +
144
+ ' "code": {\n' +
145
+ ' "embedding": "perplexity-context",\n' +
146
+ ' "ignore": [\n' +
147
+ ' "node_modules/**", "dist/**", "build/**",\n' +
148
+ ' ".next/**", "coverage/**", "__pycache__/**",\n' +
149
+ ' "**/*.min.js", "**/*.min.css",\n' +
150
+ ' "tests/**", "test/**",\n' +
151
+ ' "**/test_*.py", "**/*_test.py",\n' +
152
+ ' "**/*.test.ts", "**/*.spec.ts"\n' +
153
+ ' ]\n' +
154
+ ' },\n' +
155
+ ' "embedding": "perplexity-context"\n' +
156
+ '}\n' +
157
+ '```\n\n' +
158
+ `**Embedding options:** \`local\` (free, offline), \`openai\`, \`perplexity\`, \`perplexity-context\` (best quality)\n` +
159
+ `**Plugins available:** \`code\`, \`git\`, \`docs\`\n\n` +
160
+ `Then run:\n` +
161
+ '```bash\nbrainbank index . --force --yes\n```',
162
+ }],
163
+ };
164
+ }
165
+
166
+ const brainbank = await getBrainBank(repo);
167
+ const result = await brainbank.index({ forceReindex });
168
+
169
+ const lines = ['## Indexing Complete', ''];
170
+
171
+ const codeResult = result.code as { indexed?: number; skipped?: number; chunks?: number } | undefined;
172
+ const gitResult = result.git as { indexed?: number; skipped?: number } | undefined;
173
+
174
+ lines.push(`**Code**: ${codeResult?.indexed ?? 0} files indexed, ${codeResult?.skipped ?? 0} skipped, ${codeResult?.chunks ?? 0} chunks`);
175
+ lines.push(`**Git**: ${gitResult?.indexed ?? 0} commits indexed, ${gitResult?.skipped ?? 0} skipped`);
176
+
177
+ const docsResult = result.docs as Record<string, { indexed: number; skipped: number; chunks: number }> | undefined;
178
+ if (docsResult) {
179
+ for (const [name, stat] of Object.entries(docsResult)) {
180
+ lines.push(`**Docs [${name}]**: ${stat.indexed} indexed, ${stat.skipped} skipped, ${stat.chunks} chunks`);
181
+ }
182
+ }
183
+
184
+ const stats = brainbank.stats();
185
+ const codeStats = stats.code as { chunks?: number } | undefined;
186
+ const gitStats = stats.git as { commits?: number } | undefined;
187
+ const docStats = stats.documents as { documents?: number } | undefined;
188
+ lines.push('');
189
+ lines.push(`**Totals**: ${codeStats?.chunks ?? 0} code chunks, ${gitStats?.commits ?? 0} commits, ${docStats?.documents ?? 0} docs`);
190
+
191
+ return { content: [{ type: 'text' as const, text: lines.join('\n') }] };
192
+ },
193
+ );
194
+
195
+ // ── Tool: brainbank_files ───────────────────────────
196
+
197
+ server.registerTool(
198
+ 'brainbank_files',
199
+ {
200
+ title: 'BrainBank Files',
201
+ description:
202
+ 'Fetch full file contents from the index. Use AFTER brainbank_context ' +
203
+ 'to view complete files identified by search. No semantic search runs — ' +
204
+ 'this is a direct file viewer.\n\n' +
205
+ 'Supports:\n' +
206
+ '- Exact paths: "src/auth/login.ts"\n' +
207
+ '- Directories: "src/graph/" (trailing / = all files under path)\n' +
208
+ '- Glob patterns: "src/**/*.service.ts"\n' +
209
+ '- Fuzzy basename: "plugin.ts" (matches src/plugin.ts when exact fails)',
210
+ inputSchema: z.object({
211
+ files: z.array(z.string()).describe(
212
+ 'File paths to fetch. Exact paths, directories (trailing /), ' +
213
+ 'glob patterns (e.g. src/**/*.ts), or fuzzy basenames.',
214
+ ),
215
+ repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),
216
+ lines: z.boolean().optional().describe('Prefix each line with source line number'),
217
+ }),
218
+ },
219
+ async ({ files, repo, lines }) => {
220
+ const brainbank = await getBrainBank(repo);
221
+ const results = brainbank.resolveFiles(files);
222
+
223
+ if (results.length === 0) {
224
+ return { content: [{ type: 'text' as const, text: 'No matching files found in the index.' }] };
225
+ }
226
+
227
+ // Format: markdown with file headers + fenced code blocks
228
+ const parts: string[] = [];
229
+ for (const r of results) {
230
+ const meta = r.metadata as Record<string, unknown>;
231
+ const lang = (meta.language as string) ?? '';
232
+ const startLine = (meta.startLine as number) ?? 1;
233
+
234
+ parts.push(`## ${r.filePath}\n`);
235
+ parts.push('```' + lang);
236
+
237
+ if (lines) {
238
+ const codeLines = r.content.split('\n');
239
+ const pad = String(startLine + codeLines.length - 1).length;
240
+ parts.push(codeLines.map((l, i) =>
241
+ `${String(startLine + i).padStart(pad)}| ${l}`,
242
+ ).join('\n'));
243
+ } else {
244
+ parts.push(r.content);
245
+ }
246
+
247
+ parts.push('```\n');
248
+ }
249
+
250
+ return { content: [{ type: 'text' as const, text: parts.join('\n') }] };
251
+ },
252
+ );
253
+
254
+ // ── Start Server ────────────────────────────────────
255
+
256
+ async function main() {
257
+ const transport = new StdioServerTransport();
258
+ await server.connect(transport);
259
+ }
260
+
261
+ main().catch(err => {
262
+ const message = err instanceof Error ? err.message : String(err);
263
+ console.error(`BrainBank MCP Server Error: ${message}`);
264
+ process.exit(1);
265
+ });
@@ -0,0 +1,66 @@
1
+ /**
2
+ * WorkspaceFactory — creates BrainBank instances via the core factory.
3
+ *
4
+ * Delegates to `createBrain()` from the `brainbank` package, passing
5
+ * a portable `BrainContext`. No plugin hardcoding — the factory handles
6
+ * plugin discovery from config and installed packages.
7
+ */
8
+
9
+ import type { BrainBank, BrainContext } from 'brainbank';
10
+
11
+ import * as fs from 'node:fs';
12
+ import * as path from 'node:path';
13
+
14
+ /**
15
+ * Detect repo root by walking up from startDir until we find `.git/`.
16
+ * Returns startDir itself if no `.git/` is found.
17
+ */
18
+ export function findRepoRoot(startDir: string): string {
19
+ let dir = path.resolve(startDir);
20
+ while (true) {
21
+ if (fs.existsSync(path.join(dir, '.git'))) return dir;
22
+ const parent = path.dirname(dir);
23
+ if (parent === dir) break;
24
+ dir = parent;
25
+ }
26
+ return path.resolve(startDir);
27
+ }
28
+
29
+ /** Resolve the effective repo path from an optional target, env, or cwd. */
30
+ export function resolveRepoPath(targetRepo?: string): string {
31
+ const rp = targetRepo
32
+ ?? process.env.BRAINBANK_REPO
33
+ ?? findRepoRoot(process.cwd());
34
+ return rp.replace(/\/+$/, '');
35
+ }
36
+
37
+ /**
38
+ * Create a BrainBank instance for a workspace.
39
+ * Uses the core factory which handles:
40
+ * - Config loading from .brainbank/config.json
41
+ * - Dynamic plugin discovery and registration
42
+ * - Embedding/reranker provider setup
43
+ * - Folder plugin auto-discovery
44
+ */
45
+ export async function createWorkspaceBrain(repoPath: string): Promise<BrainBank> {
46
+ const { createBrain, resetFactoryCache } = await import('brainbank') as typeof import('brainbank');
47
+ resetFactoryCache();
48
+
49
+ const context: BrainContext = {
50
+ repoPath,
51
+ env: process.env as Record<string, string | undefined>,
52
+ };
53
+
54
+ // Silence stdout during initialization — the core factory emits ANSI-colored
55
+ // console.log messages (plugin loading, multi-repo detection) that corrupt
56
+ // the MCP JSON-RPC stdio transport. Redirect console.log → stderr temporarily.
57
+ const origLog = console.log;
58
+ console.log = (...args: unknown[]) => console.error(...args);
59
+ try {
60
+ const brain = await createBrain(context);
61
+ await brain.initialize();
62
+ return brain;
63
+ } finally {
64
+ console.log = origLog;
65
+ }
66
+ }
@@ -0,0 +1,224 @@
1
+ /**
2
+ * WorkspacePool — BrainBank instance lifecycle manager.
3
+ *
4
+ * Manages cached BrainBank instances per workspace with:
5
+ * - Memory-pressure eviction (oldest idle first)
6
+ * - TTL eviction for inactive workspaces
7
+ * - Active-operation tracking (prevents mid-query eviction)
8
+ * - Hot-reload of stale HNSW indices
9
+ */
10
+
11
+ import type { BrainBank } from 'brainbank';
12
+
13
+ /** Pool configuration. */
14
+ export interface PoolOptions {
15
+ /** Max total estimated memory in MB. Default: 2048. */
16
+ maxMemoryMB?: number;
17
+ /** Minutes of inactivity before eviction. Default: 30. */
18
+ ttlMinutes?: number;
19
+ /** Factory function to create a BrainBank for a repo path. */
20
+ factory: (repoPath: string) => Promise<BrainBank>;
21
+ /** Called when a workspace is evicted. */
22
+ onEvict?: (repoPath: string) => void;
23
+ /** Called when an error occurs during pool operations. */
24
+ onError?: (repoPath: string, err: unknown) => void;
25
+ }
26
+
27
+ /** Internal pool entry. */
28
+ interface PoolEntry {
29
+ brain: BrainBank;
30
+ repoPath: string;
31
+ lastAccess: number;
32
+ createdAt: number;
33
+ activeOps: number;
34
+ }
35
+
36
+ /** Public pool statistics. */
37
+ export interface PoolStats {
38
+ size: number;
39
+ totalMemoryMB: number;
40
+ entries: PoolEntryStats[];
41
+ }
42
+
43
+ /** Per-entry statistics. */
44
+ export interface PoolEntryStats {
45
+ repoPath: string;
46
+ lastAccessAgo: string;
47
+ memoryMB: number;
48
+ activeOps: number;
49
+ }
50
+
51
+ const DEFAULT_MAX_MEMORY_MB = 2048;
52
+ const DEFAULT_TTL_MINUTES = 30;
53
+ const EVICTION_INTERVAL_MS = 60_000;
54
+
55
+ /** Format milliseconds as a human-readable "ago" string. */
56
+ function formatAgo(ms: number): string {
57
+ if (ms < 60_000) return `${Math.round(ms / 1000)}s ago`;
58
+ if (ms < 3_600_000) return `${Math.round(ms / 60_000)}m ago`;
59
+ return `${Math.round(ms / 3_600_000)}h ago`;
60
+ }
61
+
62
+ export class WorkspacePool {
63
+ private _pool = new Map<string, PoolEntry>();
64
+ private _timer: ReturnType<typeof setInterval> | null = null;
65
+ private _maxMemoryBytes: number;
66
+ private _ttlMs: number;
67
+ private _factory: (repoPath: string) => Promise<BrainBank>;
68
+ private _onEvict?: (repoPath: string) => void;
69
+ private _onError?: (repoPath: string, err: unknown) => void;
70
+
71
+ constructor(options: PoolOptions) {
72
+ this._maxMemoryBytes = (options.maxMemoryMB ?? DEFAULT_MAX_MEMORY_MB) * 1024 * 1024;
73
+ this._ttlMs = (options.ttlMinutes ?? DEFAULT_TTL_MINUTES) * 60 * 1000;
74
+ this._factory = options.factory;
75
+ this._onEvict = options.onEvict;
76
+ this._onError = options.onError;
77
+
78
+ this._timer = setInterval(() => this._evictStale(), EVICTION_INTERVAL_MS);
79
+ // Don't hold the process open for the timer
80
+ if (this._timer.unref) this._timer.unref();
81
+ }
82
+
83
+ /** Number of cached workspaces. */
84
+ get size(): number {
85
+ return this._pool.size;
86
+ }
87
+
88
+ /**
89
+ * Get a BrainBank for the given repo path.
90
+ * Returns a cached instance (with hot-reload) or creates a new one.
91
+ */
92
+ async get(repoPath: string): Promise<BrainBank> {
93
+ const key = repoPath.replace(/\/+$/, '');
94
+
95
+ const existing = this._pool.get(key);
96
+ if (existing) {
97
+ existing.lastAccess = Date.now();
98
+ try { await existing.brain.ensureFresh(); } catch { /* stale is better than nothing */ }
99
+ return existing.brain;
100
+ }
101
+
102
+ this._evictByMemoryPressure();
103
+
104
+ const brain = await this._factory(key);
105
+ this._pool.set(key, {
106
+ brain,
107
+ repoPath: key,
108
+ lastAccess: Date.now(),
109
+ createdAt: Date.now(),
110
+ activeOps: 0,
111
+ });
112
+
113
+ return brain;
114
+ }
115
+
116
+ /**
117
+ * Execute an operation with active-op tracking.
118
+ * Prevents the workspace from being evicted while the operation runs.
119
+ */
120
+ async withBrain<T>(repoPath: string, fn: (brain: BrainBank) => Promise<T>): Promise<T> {
121
+ const brain = await this.get(repoPath);
122
+ const key = repoPath.replace(/\/+$/, '');
123
+ const entry = this._pool.get(key);
124
+ if (entry) entry.activeOps++;
125
+
126
+ try {
127
+ return await fn(brain);
128
+ } finally {
129
+ if (entry) {
130
+ entry.activeOps--;
131
+ entry.lastAccess = Date.now();
132
+ }
133
+ }
134
+ }
135
+
136
+ /** Manually evict a specific workspace. */
137
+ evict(repoPath: string): void {
138
+ const key = repoPath.replace(/\/+$/, '');
139
+ this._evictEntry(key);
140
+ }
141
+
142
+ /** Get pool statistics. */
143
+ stats(): PoolStats {
144
+ const now = Date.now();
145
+ let totalMemory = 0;
146
+ const entries: PoolEntryStats[] = [];
147
+
148
+ for (const entry of this._pool.values()) {
149
+ const memBytes = entry.brain.memoryHint();
150
+ const memMB = Math.round(memBytes / 1024 / 1024 * 100) / 100;
151
+ totalMemory += memBytes;
152
+
153
+ entries.push({
154
+ repoPath: entry.repoPath,
155
+ lastAccessAgo: formatAgo(now - entry.lastAccess),
156
+ memoryMB: memMB,
157
+ activeOps: entry.activeOps,
158
+ });
159
+ }
160
+
161
+ return {
162
+ size: this._pool.size,
163
+ totalMemoryMB: Math.round(totalMemory / 1024 / 1024 * 100) / 100,
164
+ entries,
165
+ };
166
+ }
167
+
168
+ /** Close all entries and stop the eviction timer. */
169
+ close(): void {
170
+ if (this._timer) {
171
+ clearInterval(this._timer);
172
+ this._timer = null;
173
+ }
174
+ for (const key of [...this._pool.keys()]) {
175
+ this._evictEntry(key);
176
+ }
177
+ }
178
+
179
+ /** Evict workspaces that haven't been accessed within the TTL. */
180
+ private _evictStale(): void {
181
+ const cutoff = Date.now() - this._ttlMs;
182
+ for (const [key, entry] of this._pool) {
183
+ if (entry.lastAccess < cutoff && entry.activeOps === 0) {
184
+ this._evictEntry(key);
185
+ }
186
+ }
187
+ }
188
+
189
+ /** Evict oldest idle entries until total memory is under the limit. */
190
+ private _evictByMemoryPressure(): void {
191
+ let totalMemory = 0;
192
+ for (const entry of this._pool.values()) {
193
+ totalMemory += entry.brain.memoryHint();
194
+ }
195
+
196
+ if (totalMemory < this._maxMemoryBytes) return;
197
+
198
+ // Sort by lastAccess ascending (oldest first), filter idle
199
+ const candidates = [...this._pool.entries()]
200
+ .filter(([, e]) => e.activeOps === 0)
201
+ .sort(([, a], [, b]) => a.lastAccess - b.lastAccess);
202
+
203
+ for (const [key, entry] of candidates) {
204
+ if (totalMemory < this._maxMemoryBytes) break;
205
+ totalMemory -= entry.brain.memoryHint();
206
+ this._evictEntry(key);
207
+ }
208
+ }
209
+
210
+ /** Evict a single entry by key. */
211
+ private _evictEntry(key: string): void {
212
+ const entry = this._pool.get(key);
213
+ if (!entry) return;
214
+
215
+ try {
216
+ entry.brain.close();
217
+ } catch (err: unknown) {
218
+ this._onError?.(key, err);
219
+ }
220
+
221
+ this._pool.delete(key);
222
+ this._onEvict?.(key);
223
+ }
224
+ }
@@ -1,425 +0,0 @@
1
- #!/usr/bin/env node
2
- var __defProp = Object.defineProperty;
3
- var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
4
-
5
- // src/mcp-server.ts
6
- import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
7
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
8
- import { z } from "zod/v3";
9
- import * as fs from "fs";
10
- import * as path from "path";
11
- import { BrainBank } from "brainbank";
12
- import { code } from "brainbank/code";
13
- import { git } from "brainbank/git";
14
- import { docs } from "brainbank/docs";
15
- var defaultRepoPath = process.env.BRAINBANK_REPO || void 0;
16
- async function createReranker() {
17
- const rerankerEnv = process.env.BRAINBANK_RERANKER ?? "none";
18
- if (rerankerEnv === "none") return void 0;
19
- if (rerankerEnv === "qwen3") {
20
- const { Qwen3Reranker } = await import("@brainbank/reranker");
21
- return new Qwen3Reranker();
22
- }
23
- return void 0;
24
- }
25
- __name(createReranker, "createReranker");
26
- async function createEmbeddingProvider() {
27
- const embeddingEnv = process.env.BRAINBANK_EMBEDDING ?? "local";
28
- if (embeddingEnv === "openai") {
29
- const { OpenAIEmbedding } = await import("brainbank");
30
- return new OpenAIEmbedding();
31
- }
32
- return void 0;
33
- }
34
- __name(createEmbeddingProvider, "createEmbeddingProvider");
35
- var _pool = /* @__PURE__ */ new Map();
36
- var _sharedReranker = void 0;
37
- var _sharedEmbedding = void 0;
38
- var _sharedReady = false;
39
- async function ensureShared() {
40
- if (_sharedReady) return;
41
- _sharedReranker = await createReranker();
42
- _sharedEmbedding = await createEmbeddingProvider();
43
- _sharedReady = true;
44
- }
45
- __name(ensureShared, "ensureShared");
46
- async function getBrainBank(targetRepo) {
47
- const rp = targetRepo ?? defaultRepoPath;
48
- if (!rp) {
49
- throw new Error(
50
- "No repository specified. Pass the `repo` parameter with the workspace path, or set BRAINBANK_REPO environment variable."
51
- );
52
- }
53
- const resolved = rp.replace(/\/+$/, "");
54
- if (_pool.has(resolved)) return _pool.get(resolved);
55
- await ensureShared();
56
- const opts = { repoPath: resolved, reranker: _sharedReranker };
57
- if (_sharedEmbedding) {
58
- opts.embeddingProvider = _sharedEmbedding;
59
- opts.embeddingDims = _sharedEmbedding.dims;
60
- }
61
- const brain = new BrainBank(opts).use(code({ repoPath: resolved })).use(git({ repoPath: resolved })).use(docs());
62
- await brain.initialize();
63
- _pool.set(resolved, brain);
64
- return brain;
65
- }
66
- __name(getBrainBank, "getBrainBank");
67
- var server = new McpServer({
68
- name: "brainbank",
69
- version: "0.1.0"
70
- });
71
- server.registerTool(
72
- "brainbank_search",
73
- {
74
- title: "BrainBank Search",
75
- description: "Semantic search across indexed code and git commits. Returns the most relevant results sorted by similarity score.",
76
- inputSchema: z.object({
77
- query: z.string().describe("Natural language search query describing what you are looking for"),
78
- codeK: z.number().optional().default(6).describe("Max code results to return"),
79
- gitK: z.number().optional().default(5).describe("Max git commit results to return"),
80
- minScore: z.number().optional().default(0.25).describe("Minimum similarity score threshold (0-1)"),
81
- repo: z.string().optional().describe("Repository path to search (default: BRAINBANK_REPO)")
82
- })
83
- },
84
- async ({ query, codeK, gitK, minScore, repo }) => {
85
- const brainbank = await getBrainBank(repo);
86
- const results = await brainbank.search(query, { codeK, gitK, minScore });
87
- if (results.length === 0) {
88
- return { content: [{ type: "text", text: "No results found for this query." }] };
89
- }
90
- return { content: [{ type: "text", text: formatResults(results, "Semantic Search") }] };
91
- }
92
- );
93
- server.registerTool(
94
- "brainbank_context",
95
- {
96
- title: "BrainBank Context",
97
- description: "Get a formatted knowledge context block for a task. Returns relevant code snippets, git history, co-edit patterns as markdown. Perfect for enriching your understanding before working on a task.",
98
- inputSchema: z.object({
99
- task: z.string().describe("Description of the task you need context for"),
100
- affectedFiles: z.array(z.string()).optional().default([]).describe("Files you plan to modify (improves co-edit suggestions)"),
101
- codeResults: z.number().optional().default(6).describe("Max code results"),
102
- gitResults: z.number().optional().default(5).describe("Max git commit results"),
103
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
104
- })
105
- },
106
- async ({ task, affectedFiles, codeResults, gitResults, repo }) => {
107
- const brainbank = await getBrainBank(repo);
108
- const context = await brainbank.getContext(task, {
109
- affectedFiles,
110
- codeResults,
111
- gitResults
112
- });
113
- return { content: [{ type: "text", text: context }] };
114
- }
115
- );
116
- server.registerTool(
117
- "brainbank_index",
118
- {
119
- title: "BrainBank Index",
120
- description: "Index (or re-index) the repository code and git history. Run this before searching if the codebase has changed. Indexing is incremental \u2014 only changed files are processed.",
121
- inputSchema: z.object({
122
- modules: z.array(z.enum(["code", "git", "docs"])).optional().describe("Which modules to index. Default: all available (code, git, docs)"),
123
- docsPath: z.string().optional().describe("Path to a docs folder to register and index. Creates a doc collection named after the folder."),
124
- forceReindex: z.boolean().optional().default(false).describe("Force re-index of all files, even unchanged ones"),
125
- gitDepth: z.number().optional().default(500).describe("Number of git commits to index"),
126
- repo: z.string().optional().describe("Repository path to index (default: BRAINBANK_REPO)")
127
- })
128
- },
129
- async ({ modules, docsPath, forceReindex, gitDepth, repo }) => {
130
- const brainbank = await getBrainBank(repo);
131
- if (docsPath) {
132
- const absPath = path.resolve(docsPath);
133
- const collName = path.basename(absPath);
134
- try {
135
- brainbank.module("docs").addCollection({
136
- name: collName,
137
- path: absPath,
138
- pattern: "**/*.md",
139
- ignore: ["deprecated/**", "node_modules/**"]
140
- });
141
- } catch {
142
- }
143
- }
144
- const result = await brainbank.index({ modules, forceReindex, gitDepth });
145
- const lines = [
146
- "## Indexing Complete",
147
- "",
148
- `**Code**: ${result.code?.indexed ?? 0} files indexed, ${result.code?.skipped ?? 0} skipped, ${result.code?.chunks ?? 0} chunks`,
149
- `**Git**: ${result.git?.indexed ?? 0} commits indexed, ${result.git?.skipped ?? 0} skipped`
150
- ];
151
- if (result.docs) {
152
- for (const [name, stat] of Object.entries(result.docs)) {
153
- lines.push(`**Docs [${name}]**: ${stat.indexed} indexed, ${stat.skipped} skipped, ${stat.chunks} chunks`);
154
- }
155
- }
156
- const stats = brainbank.stats();
157
- lines.push("");
158
- lines.push(`**Totals**: ${stats.code?.chunks ?? 0} code chunks, ${stats.git?.commits ?? 0} commits, ${stats.documents?.documents ?? 0} docs`);
159
- return { content: [{ type: "text", text: lines.join("\n") }] };
160
- }
161
- );
162
- server.registerTool(
163
- "brainbank_stats",
164
- {
165
- title: "BrainBank Stats",
166
- description: "Get statistics about the indexed knowledge base: file count, code chunks, git commits, HNSW index sizes, and KV collections.",
167
- inputSchema: z.object({
168
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
169
- })
170
- },
171
- async ({ repo }) => {
172
- const brainbank = await getBrainBank(repo);
173
- const s = brainbank.stats();
174
- const lines = [
175
- "## BrainBank Knowledge Base Stats",
176
- ""
177
- ];
178
- if (s.code) {
179
- lines.push("### Code");
180
- lines.push(`- Files indexed: ${s.code.files}`);
181
- lines.push(`- Code chunks: ${s.code.chunks}`);
182
- lines.push(`- HNSW vectors: ${s.code.hnswSize}`);
183
- lines.push("");
184
- }
185
- if (s.git) {
186
- lines.push("### Git History");
187
- lines.push(`- Commits indexed: ${s.git.commits}`);
188
- lines.push(`- Files tracked: ${s.git.filesTracked}`);
189
- lines.push(`- Co-edit pairs: ${s.git.coEdits}`);
190
- lines.push(`- HNSW vectors: ${s.git.hnswSize}`);
191
- lines.push("");
192
- }
193
- if (s.documents) {
194
- lines.push("### Documents");
195
- lines.push(`- Collections: ${s.documents.collections}`);
196
- lines.push(`- Documents: ${s.documents.documents}`);
197
- lines.push(`- HNSW vectors: ${s.documents.hnswSize}`);
198
- lines.push("");
199
- }
200
- const kvNames = brainbank.listCollectionNames();
201
- if (kvNames.length > 0) {
202
- lines.push("### KV Collections");
203
- for (const name of kvNames) {
204
- const coll = brainbank.collection(name);
205
- lines.push(`- ${name}: ${coll.count()} items`);
206
- }
207
- }
208
- return { content: [{ type: "text", text: lines.join("\n") }] };
209
- }
210
- );
211
- server.registerTool(
212
- "brainbank_history",
213
- {
214
- title: "BrainBank File History",
215
- description: "Get the git commit history for a specific file. Shows recent changes, authors, and line counts.",
216
- inputSchema: z.object({
217
- filePath: z.string().describe('File path (relative or partial match, e.g. "auth.ts" or "src/core/agent.ts")'),
218
- limit: z.number().optional().default(20).describe("Max commits to return"),
219
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
220
- })
221
- },
222
- async ({ filePath, limit, repo }) => {
223
- const brainbank = await getBrainBank(repo);
224
- const history = await brainbank.fileHistory(filePath, limit);
225
- if (history.length === 0) {
226
- return { content: [{ type: "text", text: `No git history found for "${filePath}"` }] };
227
- }
228
- const lines = [`## Git History: ${filePath}`, ""];
229
- for (const h of history) {
230
- lines.push(`**[${h.short_hash}]** ${h.message} *(${h.author}, +${h.additions}/-${h.deletions})*`);
231
- }
232
- return { content: [{ type: "text", text: lines.join("\n") }] };
233
- }
234
- );
235
- server.registerTool(
236
- "brainbank_coedits",
237
- {
238
- title: "BrainBank Co-Edits",
239
- description: "Find files that historically change together with a given file. Useful for understanding dependencies and ensuring you do not miss related changes.",
240
- inputSchema: z.object({
241
- filePath: z.string().describe("File path to check co-edit relationships for"),
242
- limit: z.number().optional().default(5).describe("Max co-edit suggestions"),
243
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
244
- })
245
- },
246
- async ({ filePath, limit, repo }) => {
247
- const brainbank = await getBrainBank(repo);
248
- const suggestions = brainbank.coEdits(filePath, limit);
249
- if (suggestions.length === 0) {
250
- return { content: [{ type: "text", text: `No co-edit patterns found for "${filePath}"` }] };
251
- }
252
- const lines = [`## Co-Edits for: ${filePath}`, ""];
253
- lines.push("Files that frequently change together:");
254
- for (const s of suggestions) {
255
- lines.push(`- **${s.file}** (changed together ${s.count} times)`);
256
- }
257
- return { content: [{ type: "text", text: lines.join("\n") }] };
258
- }
259
- );
260
- server.registerTool(
261
- "brainbank_hybrid_search",
262
- {
263
- title: "BrainBank Hybrid Search",
264
- description: "Best quality search: combines semantic vector search + BM25 keyword search using Reciprocal Rank Fusion. Catches both exact keyword matches AND conceptual similarities. Use this by default for all searches.",
265
- inputSchema: z.object({
266
- query: z.string().describe("Search query \u2014 works with both keywords and natural language"),
267
- codeK: z.number().optional().default(8).describe("Max code results (shorthand for collections.code)"),
268
- gitK: z.number().optional().default(5).describe("Max git results (shorthand for collections.git)"),
269
- collections: z.record(z.string(), z.number()).optional().describe(
270
- 'Max results per source. Reserved keys: "code", "git", "docs" control built-in indexers. Any other key is a KV collection. Example: { "code": 8, "git": 5, "errors": 3, "slack": 2 }'
271
- ),
272
- repo: z.string().optional().describe("Repository path to search (default: BRAINBANK_REPO)")
273
- })
274
- },
275
- async ({ query, codeK, gitK, collections, repo }) => {
276
- const t0 = performance.now();
277
- const brainbank = await getBrainBank(repo);
278
- const t1 = performance.now();
279
- const results = await brainbank.hybridSearch(query, { codeK, gitK, collections });
280
- const t2 = performance.now();
281
- const timing = `
282
-
283
- \u23F1 getBrainBank: ${(t1 - t0).toFixed(0)}ms | hybridSearch: ${(t2 - t1).toFixed(0)}ms | total: ${(t2 - t0).toFixed(0)}ms`;
284
- if (results.length === 0) {
285
- return { content: [{ type: "text", text: "No results found for this query." + timing }] };
286
- }
287
- return { content: [{ type: "text", text: formatResults(results, "Hybrid Search (Vector + BM25 \u2192 RRF)") + timing }] };
288
- }
289
- );
290
- server.registerTool(
291
- "brainbank_keyword_search",
292
- {
293
- title: "BrainBank Keyword Search",
294
- description: "Instant BM25 keyword search (no embedding computation needed). Best for exact terms, function names, variable names, error messages, and specific identifiers.",
295
- inputSchema: z.object({
296
- query: z.string().describe("Keywords to search for"),
297
- codeK: z.number().optional().default(8).describe("Max code results to return"),
298
- gitK: z.number().optional().default(5).describe("Max git commit results to return"),
299
- repo: z.string().optional().describe("Repository path to search (default: BRAINBANK_REPO)")
300
- })
301
- },
302
- async ({ query, codeK, gitK, repo }) => {
303
- const brainbank = await getBrainBank(repo);
304
- const results = brainbank.searchBM25(query, { codeK, gitK });
305
- if (results.length === 0) {
306
- return { content: [{ type: "text", text: "No keyword matches found." }] };
307
- }
308
- return { content: [{ type: "text", text: formatResults(results, "Keyword Search (BM25)") }] };
309
- }
310
- );
311
- server.registerTool(
312
- "brainbank_collection_add",
313
- {
314
- title: "BrainBank Collection Add",
315
- description: "Add an item to a dynamic KV collection. Collections are created automatically. Use this to store any structured data: errors, decisions, notes, context, etc.",
316
- inputSchema: z.object({
317
- collection: z.string().describe('Collection name (e.g. "errors", "decisions", "context")'),
318
- content: z.string().describe("Content to store"),
319
- metadata: z.record(z.any()).optional().default({}).describe("Optional metadata object"),
320
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
321
- })
322
- },
323
- async ({ collection, content, metadata, repo }) => {
324
- const brainbank = await getBrainBank(repo);
325
- const coll = brainbank.collection(collection);
326
- const id = await coll.add(content, metadata);
327
- return {
328
- content: [{ type: "text", text: `\u2713 Item #${id} added to '${collection}' (${coll.count()} total)` }]
329
- };
330
- }
331
- );
332
- server.registerTool(
333
- "brainbank_collection_search",
334
- {
335
- title: "BrainBank Collection Search",
336
- description: "Search a dynamic KV collection using hybrid vector + keyword search. Returns semantically similar items.",
337
- inputSchema: z.object({
338
- collection: z.string().describe("Collection name to search"),
339
- query: z.string().describe("Search query"),
340
- k: z.number().optional().default(5).describe("Max results"),
341
- mode: z.enum(["hybrid", "vector", "keyword"]).optional().default("hybrid").describe("Search mode"),
342
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
343
- })
344
- },
345
- async ({ collection, query, k, mode, repo }) => {
346
- const brainbank = await getBrainBank(repo);
347
- const coll = brainbank.collection(collection);
348
- const results = await coll.search(query, { k, mode });
349
- if (results.length === 0) {
350
- return { content: [{ type: "text", text: `No results in '${collection}' for "${query}"` }] };
351
- }
352
- const lines = [`## Collection: ${collection} \u2014 "${query}"`, ""];
353
- for (const r of results) {
354
- const score = Math.round((r.score ?? 0) * 100);
355
- lines.push(`[${score}%] ${r.content}`);
356
- if (Object.keys(r.metadata).length > 0) {
357
- lines.push(` ${JSON.stringify(r.metadata)}`);
358
- }
359
- lines.push("");
360
- }
361
- return { content: [{ type: "text", text: lines.join("\n") }] };
362
- }
363
- );
364
- server.registerTool(
365
- "brainbank_collection_trim",
366
- {
367
- title: "BrainBank Collection Trim",
368
- description: "Trim a dynamic collection to keep only the N most recent items. Use this to prevent collections from growing unbounded.",
369
- inputSchema: z.object({
370
- collection: z.string().describe("Collection name"),
371
- keep: z.number().describe("Number of most recent items to keep"),
372
- repo: z.string().optional().describe("Repository path (default: BRAINBANK_REPO)")
373
- })
374
- },
375
- async ({ collection, keep, repo }) => {
376
- const brainbank = await getBrainBank(repo);
377
- const coll = brainbank.collection(collection);
378
- const result = await coll.trim({ keep });
379
- return {
380
- content: [{
381
- type: "text",
382
- text: `\u2713 Trimmed ${result.removed} items from '${collection}' (kept ${keep})`
383
- }]
384
- };
385
- }
386
- );
387
- function formatResults(results, mode) {
388
- const lines = [`## ${mode}`, ""];
389
- for (const r of results) {
390
- const score = Math.round(r.score * 100);
391
- if (r.type === "code") {
392
- const m = r.metadata;
393
- lines.push(`[CODE ${score}%] ${r.filePath} \u2014 ${m.name || m.chunkType} (L${m.startLine}-${m.endLine})`);
394
- lines.push(r.content);
395
- lines.push("");
396
- } else if (r.type === "commit") {
397
- const m = r.metadata;
398
- lines.push(`[COMMIT ${score}%] ${m.shortHash} \u2014 ${r.content} (${m.author})`);
399
- if (m.files?.length) lines.push(` Files: ${m.files.join(", ")}`);
400
- lines.push("");
401
- } else if (r.type === "document") {
402
- const ctx = r.context ? ` \u2014 ${r.context}` : "";
403
- lines.push(`[DOC ${score}%] ${r.filePath} [${r.metadata.collection}]${ctx}`);
404
- lines.push(r.content);
405
- lines.push("");
406
- } else if (r.type === "collection") {
407
- const col = r.metadata?.collection ?? "unknown";
408
- lines.push(`[COLLECTION ${score}%] [${col}]`);
409
- lines.push(r.content);
410
- lines.push("");
411
- }
412
- }
413
- return lines.join("\n");
414
- }
415
- __name(formatResults, "formatResults");
416
- async function main() {
417
- const transport = new StdioServerTransport();
418
- await server.connect(transport);
419
- }
420
- __name(main, "main");
421
- main().catch((err) => {
422
- console.error(`BrainBank MCP Server Error: ${err.message}`);
423
- process.exit(1);
424
- });
425
- //# sourceMappingURL=mcp-server.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/mcp-server.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * BrainBank — MCP Server\n * \n * Exposes BrainBank as an MCP server via stdio transport.\n * Works with Google Antigravity, Claude Desktop, and any MCP-compatible client.\n * \n * Usage in Antigravity mcp_config.json:\n * {\n * \"mcpServers\": {\n * \"brainbank\": {\n * \"command\": \"npx\",\n * \"args\": [\"tsx\", \"/path/to/brainbank/src/integrations/mcp-server.ts\"],\n * \"env\": { \"BRAINBANK_REPO\": \"/path/to/your/repo\" }\n * }\n * }\n * }\n * \n * Tools exposed:\n * brainbank_search — Semantic search across code, commits\n * brainbank_hybrid_search — Best quality: vector + BM25 fused\n * brainbank_keyword_search — Instant BM25 full-text\n * brainbank_context — Get formatted context for a task\n * brainbank_index — Trigger code/git indexing\n * brainbank_stats — Get index statistics\n * brainbank_history — Git history for a specific file\n * brainbank_coedits — Files that frequently change together\n * brainbank_collection_add — Add item to a dynamic collection\n * brainbank_collection_search — Search a dynamic collection\n * brainbank_collection_trim — Trim a dynamic collection\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod/v3';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { BrainBank } from 'brainbank';\nimport { code } from 'brainbank/code';\nimport { git } from 'brainbank/git';\nimport { docs } from 'brainbank/docs';\n\n// ── Configuration from env ──────────────────────────\n\n/**\n * Detect repo root by walking up from startDir until we find `.git/`.\n * Returns startDir itself if no `.git/` is found (mono-repo or non-git project).\n */\nfunction findRepoRoot(startDir: string): string {\n let dir = path.resolve(startDir);\n while (true) {\n if (fs.existsSync(path.join(dir, '.git'))) return dir;\n const parent = path.dirname(dir);\n if (parent === dir) break; // filesystem root\n dir = parent;\n }\n return path.resolve(startDir); // fallback: use startDir as-is\n}\n\nconst defaultRepoPath = process.env.BRAINBANK_REPO || undefined;\n\n// ── Reranker (default: qwen3, set BRAINBANK_RERANKER=none to disable) ──\n\nasync function createReranker() {\n const rerankerEnv = process.env.BRAINBANK_RERANKER ?? 'none';\n if (rerankerEnv === 'none') return undefined;\n if (rerankerEnv === 'qwen3') {\n const { Qwen3Reranker } = await import('@brainbank/reranker');\n return new Qwen3Reranker();\n }\n return undefined;\n}\n\n// ── Embedding Provider (default: local, set BRAINBANK_EMBEDDING=openai) ──\n\nasync function createEmbeddingProvider() {\n const embeddingEnv = process.env.BRAINBANK_EMBEDDING ?? 'local';\n if (embeddingEnv === 'openai') {\n const { OpenAIEmbedding } = await import('brainbank');\n return new OpenAIEmbedding();\n }\n return undefined; // BrainBank defaults to local WASM\n}\n\n// ── Multi-Workspace BrainBank Pool ─────────────────────\n// Reranker + embedding provider are shared; each repo gets its own DB.\n\nconst _pool = new Map<string, BrainBank>();\nlet _sharedReranker: any = undefined;\nlet _sharedEmbedding: any = undefined;\nlet _sharedReady = false;\n\nasync function ensureShared() {\n if (_sharedReady) return;\n _sharedReranker = await createReranker();\n _sharedEmbedding = await createEmbeddingProvider();\n _sharedReady = true;\n}\n\nasync function getBrainBank(targetRepo?: string): Promise<BrainBank> {\n const rp = targetRepo ?? defaultRepoPath;\n if (!rp) {\n throw new Error(\n 'No repository specified. Pass the `repo` parameter with the workspace path, ' +\n 'or set BRAINBANK_REPO environment variable.'\n );\n }\n const resolved = rp.replace(/\\/+$/, ''); // normalize\n\n if (_pool.has(resolved)) return _pool.get(resolved)!;\n\n await ensureShared();\n\n const opts: Record<string, any> = { repoPath: resolved, reranker: _sharedReranker };\n if (_sharedEmbedding) {\n opts.embeddingProvider = _sharedEmbedding;\n opts.embeddingDims = _sharedEmbedding.dims;\n }\n const brain = new BrainBank(opts)\n .use(code({ repoPath: resolved }))\n .use(git({ repoPath: resolved }))\n .use(docs());\n await brain.initialize();\n\n _pool.set(resolved, brain);\n return brain;\n}\n\n// ── MCP Server Setup ────────────────────────────────\n\nconst server = new McpServer({\n name: 'brainbank',\n version: '0.1.0',\n});\n\n// ── Tool: brainbank_search ─────────────────────────────\n\nserver.registerTool(\n 'brainbank_search',\n {\n title: 'BrainBank Search',\n description: 'Semantic search across indexed code and git commits. Returns the most relevant results sorted by similarity score.',\n inputSchema: z.object({\n query: z.string().describe('Natural language search query describing what you are looking for'),\n codeK: z.number().optional().default(6).describe('Max code results to return'),\n gitK: z.number().optional().default(5).describe('Max git commit results to return'),\n minScore: z.number().optional().default(0.25).describe('Minimum similarity score threshold (0-1)'),\n repo: z.string().optional().describe('Repository path to search (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ query, codeK, gitK, minScore, repo }) => {\n const brainbank = await getBrainBank(repo);\n const results = await brainbank.search(query, { codeK, gitK, minScore });\n\n if (results.length === 0) {\n return { content: [{ type: 'text', text: 'No results found for this query.' }] };\n }\n\n return { content: [{ type: 'text', text: formatResults(results, 'Semantic Search') }] };\n },\n);\n\n// ── Tool: brainbank_context ────────────────────────────\n\nserver.registerTool(\n 'brainbank_context',\n {\n title: 'BrainBank Context',\n description: 'Get a formatted knowledge context block for a task. Returns relevant code snippets, git history, co-edit patterns as markdown. Perfect for enriching your understanding before working on a task.',\n inputSchema: z.object({\n task: z.string().describe('Description of the task you need context for'),\n affectedFiles: z.array(z.string()).optional().default([]).describe('Files you plan to modify (improves co-edit suggestions)'),\n codeResults: z.number().optional().default(6).describe('Max code results'),\n gitResults: z.number().optional().default(5).describe('Max git commit results'),\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ task, affectedFiles, codeResults, gitResults, repo }) => {\n const brainbank = await getBrainBank(repo);\n const context = await brainbank.getContext(task, {\n affectedFiles,\n codeResults,\n gitResults,\n });\n\n return { content: [{ type: 'text', text: context }] };\n },\n);\n\n// ── Tool: brainbank_index ──────────────────────────────\n\nserver.registerTool(\n 'brainbank_index',\n {\n title: 'BrainBank Index',\n description: 'Index (or re-index) the repository code and git history. Run this before searching if the codebase has changed. Indexing is incremental — only changed files are processed.',\n inputSchema: z.object({\n modules: z.array(z.enum(['code', 'git', 'docs'])).optional().describe('Which modules to index. Default: all available (code, git, docs)'),\n docsPath: z.string().optional().describe('Path to a docs folder to register and index. Creates a doc collection named after the folder.'),\n forceReindex: z.boolean().optional().default(false).describe('Force re-index of all files, even unchanged ones'),\n gitDepth: z.number().optional().default(500).describe('Number of git commits to index'),\n repo: z.string().optional().describe('Repository path to index (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ modules, docsPath, forceReindex, gitDepth, repo }) => {\n const brainbank = await getBrainBank(repo);\n\n // Auto-register docs collection if docsPath provided\n if (docsPath) {\n const absPath = path.resolve(docsPath);\n const collName = path.basename(absPath);\n try {\n brainbank.module('docs').addCollection!({\n name: collName,\n path: absPath,\n pattern: '**/*.md',\n ignore: ['deprecated/**', 'node_modules/**'],\n });\n } catch {\n // docs module not loaded — ignore\n }\n }\n\n const result = await brainbank.index({ modules, forceReindex, gitDepth });\n\n const lines = [\n '## Indexing Complete',\n '',\n `**Code**: ${result.code?.indexed ?? 0} files indexed, ${result.code?.skipped ?? 0} skipped, ${result.code?.chunks ?? 0} chunks`,\n `**Git**: ${result.git?.indexed ?? 0} commits indexed, ${result.git?.skipped ?? 0} skipped`,\n ];\n\n if (result.docs) {\n for (const [name, stat] of Object.entries(result.docs)) {\n lines.push(`**Docs [${name}]**: ${stat.indexed} indexed, ${stat.skipped} skipped, ${stat.chunks} chunks`);\n }\n }\n\n const stats = brainbank.stats();\n lines.push('');\n lines.push(`**Totals**: ${stats.code?.chunks ?? 0} code chunks, ${stats.git?.commits ?? 0} commits, ${stats.documents?.documents ?? 0} docs`);\n\n return { content: [{ type: 'text', text: lines.join('\\n') }] };\n },\n);\n\n// ── Tool: brainbank_stats ──────────────────────────────\n\nserver.registerTool(\n 'brainbank_stats',\n {\n title: 'BrainBank Stats',\n description: 'Get statistics about the indexed knowledge base: file count, code chunks, git commits, HNSW index sizes, and KV collections.',\n inputSchema: z.object({\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ repo }) => {\n const brainbank = await getBrainBank(repo);\n const s = brainbank.stats();\n\n const lines = [\n '## BrainBank Knowledge Base Stats',\n '',\n ];\n\n if (s.code) {\n lines.push('### Code');\n lines.push(`- Files indexed: ${s.code.files}`);\n lines.push(`- Code chunks: ${s.code.chunks}`);\n lines.push(`- HNSW vectors: ${s.code.hnswSize}`);\n lines.push('');\n }\n\n if (s.git) {\n lines.push('### Git History');\n lines.push(`- Commits indexed: ${s.git.commits}`);\n lines.push(`- Files tracked: ${s.git.filesTracked}`);\n lines.push(`- Co-edit pairs: ${s.git.coEdits}`);\n lines.push(`- HNSW vectors: ${s.git.hnswSize}`);\n lines.push('');\n }\n\n if (s.documents) {\n lines.push('### Documents');\n lines.push(`- Collections: ${s.documents.collections}`);\n lines.push(`- Documents: ${s.documents.documents}`);\n lines.push(`- HNSW vectors: ${s.documents.hnswSize}`);\n lines.push('');\n }\n\n const kvNames = brainbank.listCollectionNames();\n if (kvNames.length > 0) {\n lines.push('### KV Collections');\n for (const name of kvNames) {\n const coll = brainbank.collection(name);\n lines.push(`- ${name}: ${coll.count()} items`);\n }\n }\n\n return { content: [{ type: 'text', text: lines.join('\\n') }] };\n },\n);\n\n// ── Tool: brainbank_history ────────────────────────────\n\nserver.registerTool(\n 'brainbank_history',\n {\n title: 'BrainBank File History',\n description: 'Get the git commit history for a specific file. Shows recent changes, authors, and line counts.',\n inputSchema: z.object({\n filePath: z.string().describe('File path (relative or partial match, e.g. \"auth.ts\" or \"src/core/agent.ts\")'),\n limit: z.number().optional().default(20).describe('Max commits to return'),\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ filePath, limit, repo }) => {\n const brainbank = await getBrainBank(repo);\n const history = await brainbank.fileHistory(filePath, limit);\n\n if (history.length === 0) {\n return { content: [{ type: 'text', text: `No git history found for \"${filePath}\"` }] };\n }\n\n const lines = [`## Git History: ${filePath}`, ''];\n for (const h of history as any[]) {\n lines.push(`**[${h.short_hash}]** ${h.message} *(${h.author}, +${h.additions}/-${h.deletions})*`);\n }\n\n return { content: [{ type: 'text', text: lines.join('\\n') }] };\n },\n);\n\n// ── Tool: brainbank_coedits ────────────────────────────\n\nserver.registerTool(\n 'brainbank_coedits',\n {\n title: 'BrainBank Co-Edits',\n description: 'Find files that historically change together with a given file. Useful for understanding dependencies and ensuring you do not miss related changes.',\n inputSchema: z.object({\n filePath: z.string().describe('File path to check co-edit relationships for'),\n limit: z.number().optional().default(5).describe('Max co-edit suggestions'),\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ filePath, limit, repo }) => {\n const brainbank = await getBrainBank(repo);\n const suggestions = brainbank.coEdits(filePath, limit);\n\n if (suggestions.length === 0) {\n return { content: [{ type: 'text', text: `No co-edit patterns found for \"${filePath}\"` }] };\n }\n\n const lines = [`## Co-Edits for: ${filePath}`, ''];\n lines.push('Files that frequently change together:');\n for (const s of suggestions) {\n lines.push(`- **${s.file}** (changed together ${s.count} times)`);\n }\n\n return { content: [{ type: 'text', text: lines.join('\\n') }] };\n },\n);\n\n// ── Tool: brainbank_hybrid_search ─────────────────────\n\nserver.registerTool(\n 'brainbank_hybrid_search',\n {\n title: 'BrainBank Hybrid Search',\n description: 'Best quality search: combines semantic vector search + BM25 keyword search using Reciprocal Rank Fusion. Catches both exact keyword matches AND conceptual similarities. Use this by default for all searches.',\n inputSchema: z.object({\n query: z.string().describe('Search query — works with both keywords and natural language'),\n codeK: z.number().optional().default(8).describe('Max code results (shorthand for collections.code)'),\n gitK: z.number().optional().default(5).describe('Max git results (shorthand for collections.git)'),\n collections: z.record(z.string(), z.number()).optional().describe(\n 'Max results per source. Reserved keys: \"code\", \"git\", \"docs\" control built-in indexers. ' +\n 'Any other key is a KV collection. Example: { \"code\": 8, \"git\": 5, \"errors\": 3, \"slack\": 2 }'\n ),\n repo: z.string().optional().describe('Repository path to search (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ query, codeK, gitK, collections, repo }) => {\n const t0 = performance.now();\n const brainbank = await getBrainBank(repo);\n const t1 = performance.now();\n const results = await brainbank.hybridSearch(query, { codeK, gitK, collections });\n const t2 = performance.now();\n\n const timing = `\\n\\n⏱ getBrainBank: ${(t1 - t0).toFixed(0)}ms | hybridSearch: ${(t2 - t1).toFixed(0)}ms | total: ${(t2 - t0).toFixed(0)}ms`;\n\n if (results.length === 0) {\n return { content: [{ type: 'text', text: 'No results found for this query.' + timing }] };\n }\n\n return { content: [{ type: 'text', text: formatResults(results, 'Hybrid Search (Vector + BM25 → RRF)') + timing }] };\n },\n);\n\n// ── Tool: brainbank_keyword_search ────────────────────\n\nserver.registerTool(\n 'brainbank_keyword_search',\n {\n title: 'BrainBank Keyword Search',\n description: 'Instant BM25 keyword search (no embedding computation needed). Best for exact terms, function names, variable names, error messages, and specific identifiers.',\n inputSchema: z.object({\n query: z.string().describe('Keywords to search for'),\n codeK: z.number().optional().default(8).describe('Max code results to return'),\n gitK: z.number().optional().default(5).describe('Max git commit results to return'),\n repo: z.string().optional().describe('Repository path to search (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ query, codeK, gitK, repo }) => {\n const brainbank = await getBrainBank(repo);\n const results = brainbank.searchBM25(query, { codeK, gitK });\n\n if (results.length === 0) {\n return { content: [{ type: 'text', text: 'No keyword matches found.' }] };\n }\n\n return { content: [{ type: 'text', text: formatResults(results, 'Keyword Search (BM25)') }] };\n },\n);\n\n// ── Tool: brainbank_collection_add ────────────────────\n\nserver.registerTool(\n 'brainbank_collection_add',\n {\n title: 'BrainBank Collection Add',\n description: 'Add an item to a dynamic KV collection. Collections are created automatically. Use this to store any structured data: errors, decisions, notes, context, etc.',\n inputSchema: z.object({\n collection: z.string().describe('Collection name (e.g. \"errors\", \"decisions\", \"context\")'),\n content: z.string().describe('Content to store'),\n metadata: z.record(z.any()).optional().default({}).describe('Optional metadata object'),\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ collection, content, metadata, repo }) => {\n const brainbank = await getBrainBank(repo);\n const coll = brainbank.collection(collection);\n const id = await coll.add(content, metadata);\n\n return {\n content: [{ type: 'text', text: `✓ Item #${id} added to '${collection}' (${coll.count()} total)` }],\n };\n },\n);\n\n// ── Tool: brainbank_collection_search ──────────────────\n\nserver.registerTool(\n 'brainbank_collection_search',\n {\n title: 'BrainBank Collection Search',\n description: 'Search a dynamic KV collection using hybrid vector + keyword search. Returns semantically similar items.',\n inputSchema: z.object({\n collection: z.string().describe('Collection name to search'),\n query: z.string().describe('Search query'),\n k: z.number().optional().default(5).describe('Max results'),\n mode: z.enum(['hybrid', 'vector', 'keyword']).optional().default('hybrid').describe('Search mode'),\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ collection, query, k, mode, repo }) => {\n const brainbank = await getBrainBank(repo);\n const coll = brainbank.collection(collection);\n const results = await coll.search(query, { k, mode: mode as any });\n\n if (results.length === 0) {\n return { content: [{ type: 'text', text: `No results in '${collection}' for \"${query}\"` }] };\n }\n\n const lines = [`## Collection: ${collection} — \"${query}\"`, ''];\n for (const r of results) {\n const score = Math.round((r.score ?? 0) * 100);\n lines.push(`[${score}%] ${r.content}`);\n if (Object.keys(r.metadata).length > 0) {\n lines.push(` ${JSON.stringify(r.metadata)}`);\n }\n lines.push('');\n }\n\n return { content: [{ type: 'text', text: lines.join('\\n') }] };\n },\n);\n\n// ── Tool: brainbank_collection_trim ────────────────────\n\nserver.registerTool(\n 'brainbank_collection_trim',\n {\n title: 'BrainBank Collection Trim',\n description: 'Trim a dynamic collection to keep only the N most recent items. Use this to prevent collections from growing unbounded.',\n inputSchema: z.object({\n collection: z.string().describe('Collection name'),\n keep: z.number().describe('Number of most recent items to keep'),\n repo: z.string().optional().describe('Repository path (default: BRAINBANK_REPO)'),\n }),\n },\n async ({ collection, keep, repo }) => {\n const brainbank = await getBrainBank(repo);\n const coll = brainbank.collection(collection);\n const result = await coll.trim({ keep });\n\n return {\n content: [{\n type: 'text',\n text: `✓ Trimmed ${result.removed} items from '${collection}' (kept ${keep})`,\n }],\n };\n },\n);\n\n// ── Shared result formatter ────────────────────────\n\nfunction formatResults(results: any[], mode: string): string {\n const lines: string[] = [`## ${mode}`, ''];\n for (const r of results) {\n const score = Math.round(r.score * 100);\n if (r.type === 'code') {\n const m = r.metadata;\n lines.push(`[CODE ${score}%] ${r.filePath} — ${m.name || m.chunkType} (L${m.startLine}-${m.endLine})`);\n lines.push(r.content);\n lines.push('');\n } else if (r.type === 'commit') {\n const m = r.metadata;\n lines.push(`[COMMIT ${score}%] ${m.shortHash} — ${r.content} (${m.author})`);\n if (m.files?.length) lines.push(` Files: ${m.files.join(', ')}`);\n lines.push('');\n } else if (r.type === 'document') {\n const ctx = r.context ? ` — ${r.context}` : '';\n lines.push(`[DOC ${score}%] ${r.filePath} [${r.metadata.collection}]${ctx}`);\n lines.push(r.content);\n lines.push('');\n } else if (r.type === 'collection') {\n const col = r.metadata?.collection ?? 'unknown';\n lines.push(`[COLLECTION ${score}%] [${col}]`);\n lines.push(r.content);\n lines.push('');\n }\n }\n return lines.join('\\n');\n}\n\n// ── Start Server ────────────────────────────────────\n\nasync function main() {\n const transport = new StdioServerTransport();\n await server.connect(transport);\n}\n\nmain().catch(err => {\n console.error(`BrainBank MCP Server Error: ${err.message}`);\n process.exit(1);\n});\n"],"mappings":"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","names":[]}