@agentbrain/mcp-server 1.4.36 → 1.4.38

package/README.md

@@ -89,11 +89,15 @@ Then reopen it.
 
 1. Start a new conversation in Claude Desktop
 2. Look for the **🔌 icon** in the toolbar or bottom of the chat
-3. Click it - you should see "agentbrain" with 5 tools:
+3. Click it - you should see "agentbrain" with 9 tools:
    - `scan_repo`
+   - `load_standards`
    - `load_context`
+   - `setup_repo` ⭐ NEW
+   - `save_context` ⭐ NEW
    - `load_spec`
-   - `load_standards`
+   - `detect_doom_loop`
+   - `create_spec`
    - `save_handoff`
 
 #### Step 6: Try It Out!
@@ -222,7 +226,7 @@ Look for MCP tools in the Windsurf interface, then ask:
 
 ## Available Tools
 
-Once configured, your agent can use these 5 tools:
+Once configured, your agent can use these 9 tools:
 
 ### 1. `scan_repo` - Analyze Repository Structure
 
@@ -375,6 +379,161 @@ This ensures the next session starts with awareness of potential issues.
 
 ---
 
+### 6. `setup_repo` ⭐ NEW - Agent-Driven Context Setup
+
+**What it does:** Scans the repository and returns file tree + key file contents so your **agent** can generate context documents. No API key required!
+
+**Parameters:**
+- `repo_path` (required): Path to repository
+
+**Example prompts:**
+- "Set up AgentBrain for this project"
+- "Scan /path/to/project and help me generate context"
+- "Initialize AgentBrain context for my repo"
+
+**Returns:**
+```json
+{
+  "repo_path": "/path/to/project",
+  "file_tree": "src/index.ts (typescript)\nsrc/auth.ts (typescript)\n...",
+  "key_files": [
+    { "path": "package.json", "content": "..." },
+    { "path": "src/index.ts", "content": "..." }
+  ],
+  "instructions": "Based on the file tree and key files above, generate:\n1. context.md\n2. dependency-map.md\n3. patterns.md\nThen call save_context()..."
+}
+```
+
+**How it works:**
+1. Scans repository to find 30 most relevant files
+2. Returns file tree and actual file contents
+3. Your **agent reads and analyzes** the code
+4. Agent generates 3 context documents based on what it learned
+5. Agent calls `save_context()` to save them
+
+**Cost:** Free - pure file I/O, no API calls
+
+**Why this is better:**
+- **No API key needed** - your agent does the analysis
+- **Agent understands** - it reads actual code, not generated summaries
+- **Customizable** - agent can focus on what matters for your current task
+- **One-time setup** - after saving, `load_context` works instantly
+
+---
+
+### 7. `save_context` ⭐ NEW - Save Agent-Generated Context
+
+**What it does:** Saves the 3 context documents generated by your agent to `.agentbrain/` directory. Works with `setup_repo` for fully agent-driven setup.
+
+**Parameters:**
+- `repo_path` (required): Path to repository
+- `context` (required): Content for context.md (architecture, modules, tech stack)
+- `dependency_map` (required): Content for dependency-map.md (module relationships, data flow)
+- `patterns` (required): Content for patterns.md (conventions, patterns, standards)
+
+**Example prompts:**
+- "Save the context I generated to .agentbrain/"
+- "Write these context files to disk"
+
+**Returns:**
+```json
+{
+  "success": true,
+  "files_written": [
+    ".agentbrain/context.md",
+    ".agentbrain/dependency-map.md",
+    ".agentbrain/patterns.md",
+    ".agentbrain/cache.json"
+  ],
+  "message": "Context saved successfully. load_context will now work without an API key."
+}
+```
+
+**What it creates:**
+- `.agentbrain/context.md` - Architecture overview
+- `.agentbrain/dependency-map.md` - Module relationships
+- `.agentbrain/patterns.md` - Coding conventions
+- `.agentbrain/cache.json` - Cache metadata with git hash
+
+**Cost:** Free - pure file I/O
+
+**After saving:**
+- `load_context` works instantly
+- `load_standards` works (if you also create standards file)
+- `load_spec`, `detect_doom_loop`, `save_handoff` all work
+- No API key needed for any subsequent operations
+
+---
+
+### 8. `create_spec` - Create Task Specification
+
+**What it does:** Creates a new task specification file from agent-generated content.
+
+**Parameters:**
+- `repoPath` (required): Path to repository
+- `task` (required): Task description or name
+- `content` (required): Full specification content
+
+**Example prompts:**
+- "Create a spec for adding OAuth authentication"
+- "Save this specification as add-stripe-integration"
+
+**Returns:**
+```json
+{
+  "specPath": ".agentbrain/specs/add-oauth-authentication.md",
+  "slug": "add-oauth-authentication"
+}
+```
+
+**Cost:** Free - writes to disk
+
+**Note:** The agent can analyze your request, draft a comprehensive spec (problem, approach, acceptance criteria, etc.), then call this tool to save it.
+
+---
+
+### 9. `detect_doom_loop` - Manually Check for Doom Loops
+
+**What it does:** Analyzes recent git history to detect if you're stuck modifying the same files repeatedly.
+
+**Parameters:**
+- `repo_path` (required): Path to repository
+- `commit_count` (optional): Number of commits to analyze (default: 10)
+- `threshold` (optional): Min occurrences to trigger warning (default: 4)
+
+**Example prompts:**
+- "Check if I'm in a doom loop"
+- "Analyze my recent commits for patterns"
+- "Am I stuck on any files?"
+
+**Returns:**
+```json
+{
+  "detected": true,
+  "files": [
+    { "path": "src/auth.ts", "count": 8, "percentage": 80 },
+    { "path": "src/main.ts", "count": 6, "percentage": 60 }
+  ],
+  "message": "Doom loop detected. You've modified src/auth.ts 8 times in the last 10 commits (80%). Stop coding and investigate the root cause."
+}
+```
+
+**Cost:** Free - analyzes local git history
+
+**When to use:**
+- When you feel stuck on a problem
+- After multiple failed attempts
+- Before starting a coding session
+- When agent suggests checking
+
+**What to do if detected:**
+- Stop coding immediately
+- Review why the file keeps being modified
+- Plan a different approach
+- Consider refactoring or architectural changes
+
+---
+
 ## Complete Workflow Example
 
 ### Morning: Start Your Day
@@ -632,16 +791,25 @@ agentbrain setup --no-confirm
 
 ## Tips for Best Results
 
-### 1. Generate Context First
+### 1. Generate Context (Two Options)
 
-Before using the MCP server, generate context once via CLI:
+**Option A: Agent-Driven Setup** (Recommended, no API key needed)
+```
+You: "Set up AgentBrain for /path/to/project"
+Agent: *Uses setup_repo tool*
+Agent: "I've analyzed your codebase. Let me generate context documents..."
+Agent: *Generates context.md, dependency-map.md, patterns.md*
+Agent: *Uses save_context tool*
+Agent: "Done! Context saved to .agentbrain/. All tools now work instantly."
+```
 
+**Option B: CLI Setup** (Requires API key once)
 ```bash
 cd /path/to/project
 agentbrain init
 ```
 
-This creates the cache, making MCP tool calls instant and free.
+Both create the cache, making MCP tool calls instant and free.
 
 ### 2. Paths Are Flexible
 
@@ -678,17 +846,32 @@ This gives your agent full project awareness immediately.
 **Q: Does this cost money?**
 A: Depends on the tool:
 - `scan_repo` - Free
+- `setup_repo` ⭐ NEW - Free (no API key needed!)
+- `save_context` ⭐ NEW - Free
 - `load_spec` - Free
 - `load_standards` - Free
+- `detect_doom_loop` - Free
+- `create_spec` - Free
 - `load_context` (cached) - Free
-- `load_context` (first time) - ~$0.02-0.05
+- `load_context` (first time with API key) - ~$0.02-0.05
 - `save_handoff` - ~$0.01
 
+**Q: Can I use AgentBrain without an API key?**
+A: YES! Use the new `setup_repo` + `save_context` workflow:
+1. Ask your agent to "Set up AgentBrain for /path/to/project"
+2. Agent uses `setup_repo` to scan files (no API call)
+3. Agent reads and analyzes the code
+4. Agent generates context documents
+5. Agent uses `save_context` to save them (no API call)
+After that, ALL tools work without an API key!
+
 **Q: Where does it get the API key?**
-A: From environment variables (`ANTHROPIC_API_KEY` or `OPENAI_API_KEY`) or from `~/.agentbrain/config.json` (set via `agentbrain config`).
+A: From environment variables (`ANTHROPIC_API_KEY` or `OPENAI_API_KEY`) or from `~/.agentbrain/config.json` (set via `agentbrain config`). But with `setup_repo` + `save_context`, you don't need one!
 
 **Q: Can I use this without the CLI?**
-A: Yes! The MCP server works standalone. But using the CLI once to generate initial context (`agentbrain init`) will make subsequent MCP calls free and instant.
+A: Yes! The MCP server works standalone. You can either:
+- Use `setup_repo` + `save_context` (no API key, agent-driven)
+- Use CLI once (`agentbrain init`) to generate context (requires API key)
 
 **Q: Which agent is best?**
 A: All three work great:

package/dist/index.js

@@ -10,6 +10,37 @@ import { loadSpecTool, loadSpecSchema } from './tools/load-spec.js';
 import { detectDoomLoop, detectDoomLoopSchema } from './tools/detect-doom-loop.js';
 import { createSpecTool, createSpecSchema } from './tools/create-spec.js';
 import { saveHandoff, saveHandoffSchema } from './tools/save-handoff.js';
+import { setupRepo, setupRepoSchema } from './tools/setup-repo.js';
+import { saveContext, saveContextSchema } from './tools/save-context.js';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    return resolve(path);
+}
+/**
+ * Check if .agentbrain/ directory exists. If not, return bootstrap message.
+ * Returns null if bootstrap is not needed (directory exists).
+ */
+async function checkBootstrap(repo_path) {
+    const expandedPath = expandPath(repo_path);
+    const contextDir = join(expandedPath, '.agentbrain');
+    if (!existsSync(contextDir)) {
+        return ('No .agentbrain/ directory found. To set up context without an API key:\n\n' +
+            '1. Call setup_repo() to scan the repo and get instructions\n' +
+            '2. Generate the three context documents based on what setup_repo returns\n' +
+            '3. Call save_context() with your generated content\n\n' +
+            'After that, this tool will work instantly with no API key needed.\n\n' +
+            'Alternative: Run `agentbrain setup` in your terminal (requires API key, one-time ~$0.03)');
+    }
+    return null;
+}
 // Create MCP server
 const server = new Server({
     name: 'agentbrain',
@@ -26,6 +57,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             scanRepoSchema,
             loadStandardsSchema,
             loadContextSchema,
+            setupRepoSchema,
+            saveContextSchema,
             loadSpecSchema,
             detectDoomLoopSchema,
             createSpecSchema,
@@ -45,12 +78,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'load_standards': {
+                const bootstrap = await checkBootstrap(args.repo_path);
+                if (bootstrap) {
+                    return {
+                        content: [{ type: 'text', text: bootstrap }],
+                    };
+                }
                 const result = await loadStandards(args);
                 return {
                     content: [{ type: 'text', text: result.content }],
                 };
             }
             case 'load_context': {
+                const bootstrap = await checkBootstrap(args.repo_path);
+                if (bootstrap) {
+                    return {
+                        content: [{ type: 'text', text: bootstrap }],
+                    };
+                }
                 const result = await loadContext(args);
                 return {
                     content: [
@@ -62,6 +107,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'load_spec': {
+                const bootstrap = await checkBootstrap(args.repoPath);
+                if (bootstrap) {
+                    return {
+                        content: [{ type: 'text', text: bootstrap }],
+                    };
+                }
                 const result = await loadSpecTool(args);
                 return {
                     content: [
@@ -75,6 +126,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'detect_doom_loop': {
+                const bootstrap = await checkBootstrap(args.repo_path);
+                if (bootstrap) {
+                    return {
+                        content: [{ type: 'text', text: bootstrap }],
+                    };
+                }
                 const result = await detectDoomLoop(args);
                 return {
                     content: [
@@ -97,6 +154,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 };
             }
             case 'save_handoff': {
+                const bootstrap = await checkBootstrap(args.repo_path);
+                if (bootstrap) {
+                    return {
+                        content: [{ type: 'text', text: bootstrap }],
+                    };
+                }
                 const result = await saveHandoff(args);
                 return {
                     content: [
@@ -107,6 +170,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case 'setup_repo': {
+                const result = await setupRepo(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `# Repository Setup Data\n\n## File Tree\n${result.file_tree}\n\n## Key Files (${result.key_files.length} files)\n\n${result.key_files.map(f => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``).join('\n\n')}\n\n## Instructions\n\n${result.instructions}`,
+                        },
+                    ],
+                };
+            }
+            case 'save_context': {
+                const result = await saveContext(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `${result.message}\n\nFiles written:\n${result.files_written.map(f => `- ${f}`).join('\n')}`,
+                        },
+                    ],
+                };
+            }
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/load-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-context.d.ts","sourceRoot":"","sources":["../../src/tools/load-context.ts"],"names":[],"mappings":"AAMA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAA;AAYzB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACxC;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoHrF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAkB7B,CAAA"}
+{"version":3,"file":"load-context.d.ts","sourceRoot":"","sources":["../../src/tools/load-context.ts"],"names":[],"mappings":"AAMA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAA;AAYzB,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACxC;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqHrF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAkB7B,CAAA"}

package/dist/tools/load-context.js

@@ -73,25 +73,26 @@ export async function loadContext(input) {
             doom_warning: doomWarning,
         };
     }
-    // Need to generate - requires API key (only loaded if we reach this point)
+    // Need to generate - check for API key first
     let aiConfig;
     try {
         aiConfig = await loadAIConfig();
     }
     catch {
-        // No API key configured - return helpful message
+        // No API key configured - return bootstrap instructions
         return {
-            content: 'No context found for this repository and no API key configured.\n\n' +
-                'To fix:\n' +
-                '1. Run `agentbrain setup` in your repo to generate context (one-time, ~$0.03)\n' +
-                '2. After setup, load_context works without an API key\n\n' +
-                'The API key is only needed for first-time generation.',
+            content: 'No context found for this repository. To set up context without an API key:\n\n' +
+                '1. Call setup_repo() to scan the repo and get instructions\n' +
+                '2. Generate the three context documents based on what setup_repo returns\n' +
+                '3. Call save_context() with your generated content\n\n' +
+                'After that, load_context will work instantly with no API key needed.\n\n' +
+                'Alternative: Run `agentbrain setup` in your terminal (requires API key, one-time ~$0.03)',
             fromCache: false,
             tokensUsed: 0,
             doom_warning: null,
         };
     }
-    // Generate new context
+    // Generate new context using API
     const result = await generateContext({
         repoPath: expandedPath,
         aiConfig,

package/dist/tools/load-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-context.js","sourceRoot":"","sources":["../../src/tools/load-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"load-context.js","sourceRoot":"","sources":["../../src/tools/load-context.ts"],"names":[],"mappings":"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"}

package/dist/tools/save-context.d.ts

@@ -0,0 +1,40 @@
+export interface SaveContextInput {
+    repo_path: string;
+    context: string;
+    dependency_map: string;
+    patterns: string;
+}
+export interface SaveContextOutput {
+    success: boolean;
+    files_written: string[];
+    agent_detected: 'cursor' | 'windsurf' | 'claude' | 'unknown';
+    message: string;
+}
+export declare function saveContext(input: SaveContextInput): Promise<SaveContextOutput>;
+export declare const saveContextSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            dependency_map: {
+                type: string;
+                description: string;
+            };
+            patterns: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=save-context.d.ts.map

package/dist/tools/save-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-context.d.ts","sourceRoot":"","sources":["../../src/tools/save-context.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC5D,OAAO,EAAE,MAAM,CAAA;CAChB;AAwGD,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwHrF;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CA0B7B,CAAA"}

package/dist/tools/save-context.js

@@ -0,0 +1,236 @@
+// MCP tool: save_context - save agent-generated context to disk
+import { writeFile, mkdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { getGitHash, ensureGitignore } from '@agentbrain/core';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    return resolve(path);
+}
+/**
+ * Detect agent type from filesystem
+ */
+function detectAgentType(repoPath) {
+    if (existsSync(join(repoPath, '.cursor'))) {
+        return 'cursor';
+    }
+    if (existsSync(join(repoPath, '.windsurf'))) {
+        return 'windsurf';
+    }
+    if (existsSync(join(repoPath, 'CLAUDE.md'))) {
+        return 'claude';
+    }
+    return 'unknown';
+}
+/**
+ * Get agent file content
+ */
+function getAgentFileContent(isModernFormat) {
+    const baseContent = `## AgentBrain Context
+@.agentbrain/context.md
+@.agentbrain/patterns.md
+@.agentbrain/dependency-map.md
+
+## Workflow
+- Always read context at session start via load_context()
+- Before any task: load_spec() or agentbrain spec "task"
+- After commits: context auto-updates via git hook
+- If stuck in a loop: detect_doom_loop() or agentbrain doom
+- End of session: save_handoff() or agentbrain handoff
+- If context feels stale: agentbrain init
+
+## MCP Tools
+- load_context() — full codebase context
+- load_spec() — spec for current task
+- detect_doom_loop() — check for stuck patterns
+- save_handoff() — end of session handoff
+- setup_repo() — first time MCP setup
+- save_context() — save agent-generated context`;
+    if (isModernFormat) {
+        return `---
+description: AgentBrain codebase context and workflow
+alwaysApply: true
+---
+
+${baseContent}`;
+    }
+    return baseContent;
+}
+/**
+ * Check if agent file already contains AgentBrain section
+ */
+async function hasAgentBrainSection(filePath) {
+    if (!existsSync(filePath)) {
+        return false;
+    }
+    const content = await readFile(filePath, 'utf-8');
+    return content.includes('── AgentBrain ──');
+}
+/**
+ * Append AgentBrain section to agent file
+ */
+async function appendToAgentFile(filePath, content) {
+    const marker = '# ── AgentBrain ──────────────────────────────';
+    const endMarker = '# ── End AgentBrain ──────────────────────────';
+    if (await hasAgentBrainSection(filePath)) {
+        return; // Already has AgentBrain section
+    }
+    let existingContent = '';
+    if (existsSync(filePath)) {
+        existingContent = await readFile(filePath, 'utf-8');
+    }
+    const agentBrainSection = `\n${marker}\n${content}\n${endMarker}\n`;
+    await writeFile(filePath, existingContent + agentBrainSection, 'utf-8');
+}
+/**
+ * Create modern agent file (with frontmatter)
+ */
+async function createModernAgentFile(filePath, content) {
+    const dir = join(filePath, '..');
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    // Modern files get replaced entirely (they're auto-loaded)
+    await writeFile(filePath, content, 'utf-8');
+}
+export async function saveContext(input) {
+    const { repo_path, context, dependency_map, patterns } = input;
+    // Expand path to handle ~, relative paths, etc.
+    const expandedPath = expandPath(repo_path);
+    const contextDir = join(expandedPath, '.agentbrain');
+    const filesWritten = [];
+    // Step 1: Create .agentbrain directory if it doesn't exist
+    if (!existsSync(contextDir)) {
+        await mkdir(contextDir, { recursive: true });
+    }
+    // Step 2: Write the three context files
+    const contextPath = join(contextDir, 'context.md');
+    const depMapPath = join(contextDir, 'dependency-map.md');
+    const patternsPath = join(contextDir, 'patterns.md');
+    await writeFile(contextPath, context, 'utf-8');
+    await writeFile(depMapPath, dependency_map, 'utf-8');
+    await writeFile(patternsPath, patterns, 'utf-8');
+    filesWritten.push('.agentbrain/context.md', '.agentbrain/dependency-map.md', '.agentbrain/patterns.md');
+    // Step 3: Get current git hash and write cache.json
+    const gitHash = await getGitHash(expandedPath);
+    const cachePath = join(contextDir, 'cache.json');
+    const cache = {
+        gitHash,
+        docs: {
+            context: {
+                type: 'context',
+                content: context,
+                savedAt: new Date().toISOString(),
+            },
+            'dependency-map': {
+                type: 'dependency-map',
+                content: dependency_map,
+                savedAt: new Date().toISOString(),
+            },
+            patterns: {
+                type: 'patterns',
+                content: patterns,
+                savedAt: new Date().toISOString(),
+            },
+        },
+        savedAt: new Date().toISOString(),
+    };
+    await writeFile(cachePath, JSON.stringify(cache, null, 2), 'utf-8');
+    filesWritten.push('.agentbrain/cache.json');
+    // Step 4: Update .gitignore
+    await ensureGitignore(expandedPath);
+    // Step 5: Detect agent type
+    const agentType = detectAgentType(expandedPath);
+    // Step 6: Create agent files based on detection
+    const modernContent = getAgentFileContent(true);
+    const legacyContent = getAgentFileContent(false);
+    if (agentType === 'cursor') {
+        // Create modern format
+        const modernPath = join(expandedPath, '.cursor', 'rules', 'agentbrain.mdc');
+        await createModernAgentFile(modernPath, modernContent);
+        filesWritten.push('.cursor/rules/agentbrain.mdc');
+        // Create legacy fallback
+        const legacyPath = join(expandedPath, '.cursorrules');
+        await appendToAgentFile(legacyPath, legacyContent);
+        filesWritten.push('.cursorrules');
+    }
+    else if (agentType === 'windsurf') {
+        // Create modern format (plain markdown, no frontmatter for Windsurf)
+        const modernPath = join(expandedPath, '.windsurf', 'rules', 'agentbrain.md');
+        await createModernAgentFile(modernPath, legacyContent); // Use legacyContent (no frontmatter)
+        filesWritten.push('.windsurf/rules/agentbrain.md');
+        // Create legacy fallback
+        const legacyPath = join(expandedPath, '.windsurfrules');
+        await appendToAgentFile(legacyPath, legacyContent);
+        filesWritten.push('.windsurfrules');
+    }
+    else if (agentType === 'claude') {
+        // Just create/append to CLAUDE.md
+        const claudePath = join(expandedPath, 'CLAUDE.md');
+        await appendToAgentFile(claudePath, legacyContent);
+        filesWritten.push('CLAUDE.md');
+    }
+    else {
+        // Unknown - create all legacy files as safe default
+        const claudePath = join(expandedPath, 'CLAUDE.md');
+        const cursorPath = join(expandedPath, '.cursorrules');
+        const windsurfPath = join(expandedPath, '.windsurfrules');
+        await appendToAgentFile(claudePath, legacyContent);
+        await appendToAgentFile(cursorPath, legacyContent);
+        await appendToAgentFile(windsurfPath, legacyContent);
+        filesWritten.push('CLAUDE.md', '.cursorrules', '.windsurfrules');
+    }
+    // Step 7: Generate message
+    let message = '';
+    if (agentType === 'cursor') {
+        message = `Detected Cursor (.cursor/ directory found). Created .cursor/rules/agentbrain.mdc (modern, always applied) and .cursorrules (legacy fallback).`;
+    }
+    else if (agentType === 'windsurf') {
+        message = `Detected Windsurf (.windsurf/ directory found). Created .windsurf/rules/agentbrain.md (modern, always applied) and .windsurfrules (legacy fallback).`;
+    }
+    else if (agentType === 'claude') {
+        message = `Detected Claude (CLAUDE.md found). Updated CLAUDE.md with AgentBrain context loading instructions.`;
+    }
+    else {
+        message = `Could not detect your agent type. Created CLAUDE.md, .cursorrules, and .windsurfrules as a safe default. If you're using Cursor, .cursor/rules/agentbrain.mdc gives better performance. If Windsurf, use .windsurf/rules/agentbrain.md instead.`;
+    }
+    return {
+        success: true,
+        files_written: filesWritten,
+        agent_detected: agentType,
+        message: `Context saved successfully. ${message} load_context will now work without an API key.`,
+    };
+}
+export const saveContextSchema = {
+    name: 'save_context',
+    description: 'Save agent-generated context files to .agentbrain/ directory. No API key required - pure file I/O. After saving, load_context will work instantly without needing API calls.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to the repository',
+            },
+            context: {
+                type: 'string',
+                description: 'Content for context.md (architecture, modules, tech stack)',
+            },
+            dependency_map: {
+                type: 'string',
+                description: 'Content for dependency-map.md (module relationships, data flow)',
+            },
+            patterns: {
+                type: 'string',
+                description: 'Content for patterns.md (conventions, patterns, standards)',
+            },
+        },
+        required: ['repo_path', 'context', 'dependency_map', 'patterns'],
+    },
+};
+//# sourceMappingURL=save-context.js.map

package/dist/tools/save-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-context.js","sourceRoot":"","sources":["../../src/tools/save-context.ts"],"names":[],"mappings":"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"}

package/dist/tools/setup-repo.d.ts

@@ -0,0 +1,28 @@
+export interface SetupRepoInput {
+    repo_path: string;
+}
+export interface SetupRepoOutput {
+    repo_path: string;
+    file_tree: string;
+    key_files: Array<{
+        path: string;
+        content: string;
+    }>;
+    instructions: string;
+}
+export declare function setupRepo(input: SetupRepoInput): Promise<SetupRepoOutput>;
+export declare const setupRepoSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            repo_path: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=setup-repo.d.ts.map

package/dist/tools/setup-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-repo.d.ts","sourceRoot":"","sources":["../../src/tools/setup-repo.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;IACF,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAmD/E;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAc3B,CAAA"}

package/dist/tools/setup-repo.js

@@ -0,0 +1,73 @@
+// MCP tool: setup_repo - scan repo and return data for agent to generate context
+import { scanRepository, readFileContent } from '@agentbrain/core';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * Expand path: handles ~, relative paths, etc.
+ */
+function expandPath(path) {
+    if (path.startsWith('~/') || path === '~') {
+        return path.replace('~', homedir());
+    }
+    return resolve(path);
+}
+export async function setupRepo(input) {
+    const { repo_path } = input;
+    // Expand path to handle ~, relative paths, etc.
+    const expandedPath = expandPath(repo_path);
+    // Scan the repository to get relevant files
+    const scanResult = await scanRepository(expandedPath, { maxFiles: 30 });
+    // Build file tree visualization
+    const fileTree = scanResult.relevantFiles
+        .map((f) => `${f.path} (${f.language})`)
+        .join('\n');
+    // Read content of top files (prioritized by scan)
+    const keyFiles = [];
+    for (const file of scanResult.relevantFiles.slice(0, 30)) {
+        const content = await readFileContent(expandedPath, file.path);
+        if (content !== null) {
+            keyFiles.push({
+                path: file.path,
+                content,
+            });
+        }
+    }
+    // Instructions for the agent
+    const instructions = `Based on the file tree and key files above, generate:
+
+1. context.md — Architecture overview, key modules, entry points, what the codebase does, tech stack
+
+2. dependency-map.md — How modules relate to each other, data flow, service relationships
+
+3. patterns.md — Coding conventions, patterns used, naming conventions, error handling approach
+
+Then call save_context() with all three documents.
+
+Guidelines:
+- Be concise but thorough
+- Focus on what's unique to this codebase
+- Include specific file paths and module names
+- Identify the main entry points and core business logic
+- Note any important patterns or conventions used consistently`;
+    return {
+        repo_path: expandedPath,
+        file_tree: fileTree,
+        key_files: keyFiles,
+        instructions,
+    };
+}
+export const setupRepoSchema = {
+    name: 'setup_repo',
+    description: 'Scan repository and return file tree + key file contents for agent-driven context generation. No API key required - pure file analysis. Use this when load_context indicates setup is needed.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            repo_path: {
+                type: 'string',
+                description: 'Absolute path to the repository',
+            },
+        },
+        required: ['repo_path'],
+    },
+};
+//# sourceMappingURL=setup-repo.js.map

package/dist/tools/setup-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-repo.js","sourceRoot":"","sources":["../../src/tools/setup-repo.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC;;GAEG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAgBD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAE3B,gDAAgD;IAChD,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAE1C,4CAA4C;IAC5C,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAA;IAEvE,gCAAgC;IAChC,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC;SACvC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,kDAAkD;IAClD,MAAM,QAAQ,GAA6C,EAAE,CAAA;IAE7D,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO;aACR,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;+DAewC,CAAA;IAE7D,OAAO;QACL,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,QAAQ;QACnB,SAAS,EAAE,QAAQ;QACnB,YAAY;KACb,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,+LAA+L;IACjM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentbrain/mcp-server",
-  "version": "1.4.36",
+   "version": "1.4.38",
   "description": "Model Context Protocol server for AgentBrain - connect Claude, Cursor, and Windsurf to repository intelligence",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,4 +52,4 @@
     "ts-jest": "^29.4.6",
     "typescript": "^5.7.2"
   }
-}
+}