@phuetz/code-buddy 0.1.19 → 0.1.22

package/dist/mcp/mcp-memory-tools.js

@@ -0,0 +1,79 @@
+/**
+ * MCP Memory Tools - Expose Code Buddy's memory system
+ *
+ * Tools:
+ * - memory_search: Search semantic memory
+ * - memory_save: Save a memory entry
+ */
+import { z } from 'zod';
+/**
+ * Register memory tools with the MCP server.
+ */
+export function registerMemoryTools(server) {
+    // memory_search - Search semantic memory
+    server.tool('memory_search', 'Search Code Buddy\'s semantic memory for relevant stored knowledge, patterns, and context.', {
+        query: z.string().describe('The search query to find relevant memories'),
+        max_results: z.number().optional().describe('Maximum results to return (default: 5)'),
+    }, async (args) => {
+        try {
+            const { searchAndRetrieve } = await import('../memory/semantic-memory-search.js');
+            const results = await searchAndRetrieve(args.query, {
+                maxResults: args.max_results ?? 5,
+            });
+            if (results.length === 0) {
+                return {
+                    content: [{ type: 'text', text: 'No matching memories found.' }],
+                };
+            }
+            const formatted = results.map((r, i) => {
+                const { result, content } = r;
+                return [
+                    `## Result ${i + 1} (score: ${result.score.toFixed(2)})`,
+                    `**Source:** ${result.entry.metadata?.source || 'unknown'}`,
+                    `**Snippet:** ${result.snippet}`,
+                    content ? `**Content:**\n${content}` : '',
+                ].filter(Boolean).join('\n');
+            }).join('\n\n---\n\n');
+            return {
+                content: [{ type: 'text', text: formatted }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Memory search error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    // memory_save - Save a memory entry
+    server.tool('memory_save', 'Save a piece of knowledge to Code Buddy\'s persistent memory for future reference.', {
+        key: z.string().describe('A short key/name for the memory entry'),
+        value: z.string().describe('The content to remember'),
+        category: z.enum(['project', 'preferences', 'decisions', 'patterns', 'context', 'custom']).optional()
+            .describe('Memory category (default: context)'),
+        scope: z.enum(['project', 'user']).optional()
+            .describe('Memory scope: project-specific or user-global (default: project)'),
+    }, async (args) => {
+        try {
+            const { getMemoryManager } = await import('../memory/persistent-memory.js');
+            const manager = getMemoryManager();
+            await manager.initialize();
+            await manager.remember(args.key, args.value, {
+                category: args.category,
+                scope: args.scope,
+            });
+            return {
+                content: [{ type: 'text', text: `Memory saved: "${args.key}" (${args.scope || 'project'} / ${args.category || 'context'})` }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: `Memory save error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=mcp-memory-tools.js.map

package/dist/mcp/mcp-memory-tools.js.map

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

package/dist/mcp/mcp-prompts.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MCP Prompts - Workflow templates for common development tasks
+ *
+ * Prompts:
+ * - code_review:    Review code changes
+ * - explain_code:   Explain file/function
+ * - generate_tests: Generate tests
+ * - refactor:       Refactor with strategy
+ * - fix_bugs:       Find and fix bugs
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register workflow prompt templates with the MCP server.
+ */
+export declare function registerPrompts(server: McpServer): void;

package/dist/mcp/mcp-prompts.js

@@ -0,0 +1,170 @@
+/**
+ * MCP Prompts - Workflow templates for common development tasks
+ *
+ * Prompts:
+ * - code_review:    Review code changes
+ * - explain_code:   Explain file/function
+ * - generate_tests: Generate tests
+ * - refactor:       Refactor with strategy
+ * - fix_bugs:       Find and fix bugs
+ */
+import { z } from 'zod';
+/**
+ * Register workflow prompt templates with the MCP server.
+ */
+export function registerPrompts(server) {
+    // code_review - Review code changes
+    server.prompt('code_review', 'Review code changes for bugs, security issues, and best practices', {
+        path: z.string().optional().describe('File or directory path to review (defaults to staged changes)'),
+    }, (args) => {
+        const target = args.path
+            ? `the file at \`${args.path}\``
+            : 'the current staged git changes (run `git diff --staged`)';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Please review ${target}. Focus on:`,
+                            '',
+                            '1. **Bugs & Logic Errors** - Incorrect behavior, edge cases, off-by-one errors',
+                            '2. **Security Issues** - Injection vulnerabilities, secrets exposure, unsafe operations',
+                            '3. **Performance** - Unnecessary computations, memory leaks, N+1 queries',
+                            '4. **Code Quality** - Readability, naming, DRY violations, missing error handling',
+                            '5. **TypeScript** - Type safety, proper use of generics, avoiding `any`',
+                            '',
+                            'For each issue found, provide:',
+                            '- File and line number',
+                            '- Severity (critical/warning/suggestion)',
+                            '- Description of the issue',
+                            '- Suggested fix with code snippet',
+                        ].join('\n'),
+                    },
+                }],
+        };
+    });
+    // explain_code - Explain file/function
+    server.prompt('explain_code', 'Explain how a file or function works in detail', {
+        path: z.string().describe('Path to the file to explain'),
+        function_name: z.string().optional().describe('Specific function to explain (explains whole file if omitted)'),
+    }, (args) => {
+        const target = args.function_name
+            ? `the function \`${args.function_name}\` in \`${args.path}\``
+            : `the file \`${args.path}\``;
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Please explain ${target}. Include:`,
+                            '',
+                            '1. **Purpose** - What it does and why it exists',
+                            '2. **How It Works** - Step-by-step walkthrough of the logic',
+                            '3. **Dependencies** - What it imports/uses and why',
+                            '4. **Data Flow** - Input → processing → output',
+                            '5. **Key Patterns** - Design patterns, idioms, or conventions used',
+                            '6. **Edge Cases** - Important boundary conditions handled',
+                            '',
+                            'Use code snippets from the file to illustrate key points.',
+                        ].join('\n'),
+                    },
+                }],
+        };
+    });
+    // generate_tests - Generate tests
+    server.prompt('generate_tests', 'Generate comprehensive tests for a file or module', {
+        path: z.string().describe('Path to the file to generate tests for'),
+        framework: z.string().optional().describe('Test framework to use (default: jest)'),
+    }, (args) => {
+        const framework = args.framework || 'jest';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Generate comprehensive tests for \`${args.path}\` using ${framework}. Include:`,
+                            '',
+                            '1. **Unit tests** for each exported function/method',
+                            '2. **Happy path** tests with typical inputs',
+                            '3. **Error cases** - invalid inputs, edge cases, boundary conditions',
+                            '4. **Mock setup** for external dependencies (API calls, file system, etc.)',
+                            '5. **Integration tests** if the module interacts with other components',
+                            '',
+                            'Follow these conventions:',
+                            '- Use descriptive test names: `it(\'should return error when file not found\')`',
+                            '- Group related tests with `describe` blocks',
+                            '- Use `beforeEach`/`afterEach` for setup/cleanup',
+                            `- Place the test file in the \`tests/\` directory`,
+                            '- Match the existing test patterns in the project',
+                        ].join('\n'),
+                    },
+                }],
+        };
+    });
+    // refactor - Refactor with strategy
+    server.prompt('refactor', 'Refactor code using a specific strategy', {
+        path: z.string().describe('Path to the file to refactor'),
+        strategy: z.string().describe('Refactoring strategy (e.g., extract-function, simplify, split-module, dry, rename)'),
+    }, (args) => {
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Refactor \`${args.path}\` using the **${args.strategy}** strategy.`,
+                            '',
+                            'Guidelines:',
+                            '1. **Read the file first** to understand current structure',
+                            '2. **Explain what you plan to change** and why before making edits',
+                            '3. **Preserve behavior** - refactoring should not change functionality',
+                            '4. **Keep changes minimal** - only refactor what the strategy calls for',
+                            '5. **Update imports** if moving or renaming things',
+                            '6. **Run existing tests** after refactoring to verify nothing broke',
+                            '',
+                            'Common strategies:',
+                            '- `extract-function`: Pull complex logic into named functions',
+                            '- `simplify`: Reduce complexity, flatten nesting, simplify conditionals',
+                            '- `split-module`: Break large file into focused modules',
+                            '- `dry`: Eliminate duplication',
+                            '- `rename`: Improve naming for clarity',
+                        ].join('\n'),
+                    },
+                }],
+        };
+    });
+    // fix_bugs - Find and fix bugs
+    server.prompt('fix_bugs', 'Find and fix bugs in a file', {
+        path: z.string().describe('Path to the file to fix'),
+        description: z.string().optional().describe('Description of the bug or symptoms'),
+    }, (args) => {
+        const bugDesc = args.description
+            ? `\n\n**Reported issue:** ${args.description}`
+            : '';
+        return {
+            messages: [{
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: [
+                            `Find and fix bugs in \`${args.path}\`.${bugDesc}`,
+                            '',
+                            'Steps:',
+                            '1. **Read the file** and understand its purpose',
+                            '2. **Identify bugs** - logic errors, type issues, edge cases, race conditions',
+                            '3. **For each bug found:**',
+                            '   - Explain what\'s wrong and how it manifests',
+                            '   - Show the fix with a code edit',
+                            '   - Explain why the fix works',
+                            '4. **Run tests** to verify the fixes',
+                            '5. **Check for related issues** that might have the same root cause',
+                        ].join('\n'),
+                    },
+                }],
+        };
+    });
+}
+//# sourceMappingURL=mcp-prompts.js.map

package/dist/mcp/mcp-prompts.js.map

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

package/dist/mcp/mcp-resources.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP Resources - Read-only project context exposed via URI scheme
+ *
+ * Resources (codebuddy:// URI scheme):
+ * - codebuddy://project/context   - Project context files + git status
+ * - codebuddy://project/instructions - CODEBUDDY.md / CLAUDE.md custom instructions
+ * - codebuddy://sessions/latest   - Latest session data as JSON
+ * - codebuddy://memory/all        - All stored memories formatted as markdown
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register read-only resources with the MCP server.
+ */
+export declare function registerResources(server: McpServer): void;

package/dist/mcp/mcp-resources.js

@@ -0,0 +1,183 @@
+/**
+ * MCP Resources - Read-only project context exposed via URI scheme
+ *
+ * Resources (codebuddy:// URI scheme):
+ * - codebuddy://project/context   - Project context files + git status
+ * - codebuddy://project/instructions - CODEBUDDY.md / CLAUDE.md custom instructions
+ * - codebuddy://sessions/latest   - Latest session data as JSON
+ * - codebuddy://memory/all        - All stored memories formatted as markdown
+ */
+/**
+ * Register read-only resources with the MCP server.
+ */
+export function registerResources(server) {
+    // codebuddy://project/context
+    server.resource('project_context', 'codebuddy://project/context', {
+        description: 'Project context files (CODEBUDDY.md, .codebuddy/config, etc.) and git status',
+        mimeType: 'text/markdown',
+    }, async () => {
+        try {
+            const { loadContext, formatContextForPrompt } = await import('../context/context-files.js');
+            const context = await loadContext(process.cwd());
+            let text = formatContextForPrompt(context);
+            // Append git status
+            try {
+                const { execSync } = await import('child_process');
+                const gitStatus = execSync('git status --short 2>/dev/null', { encoding: 'utf-8', timeout: 5000 });
+                if (gitStatus.trim()) {
+                    text += `\n\n## Git Status\n\`\`\`\n${gitStatus.trim()}\n\`\`\``;
+                }
+            }
+            catch {
+                // Not a git repo or git not available
+            }
+            return {
+                contents: [{
+                        uri: 'codebuddy://project/context',
+                        mimeType: 'text/markdown',
+                        text,
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                contents: [{
+                        uri: 'codebuddy://project/context',
+                        mimeType: 'text/plain',
+                        text: `Error loading project context: ${message}`,
+                    }],
+            };
+        }
+    });
+    // codebuddy://project/instructions
+    server.resource('project_instructions', 'codebuddy://project/instructions', {
+        description: 'Custom project instructions from CODEBUDDY.md, CLAUDE.md, or .codebuddy/instructions',
+        mimeType: 'text/markdown',
+    }, async () => {
+        try {
+            const fs = await import('fs');
+            const path = await import('path');
+            const cwd = process.cwd();
+            const instructionFiles = [
+                'CODEBUDDY.md',
+                'CLAUDE.md',
+                '.codebuddy/instructions.md',
+                '.github/copilot-instructions.md',
+            ];
+            const parts = [];
+            for (const file of instructionFiles) {
+                const fullPath = path.join(cwd, file);
+                try {
+                    const content = fs.readFileSync(fullPath, 'utf-8');
+                    parts.push(`## ${file}\n\n${content}`);
+                }
+                catch {
+                    // File doesn't exist, skip
+                }
+            }
+            const text = parts.length > 0
+                ? parts.join('\n\n---\n\n')
+                : 'No custom instruction files found in this project.';
+            return {
+                contents: [{
+                        uri: 'codebuddy://project/instructions',
+                        mimeType: 'text/markdown',
+                        text,
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                contents: [{
+                        uri: 'codebuddy://project/instructions',
+                        mimeType: 'text/plain',
+                        text: `Error loading instructions: ${message}`,
+                    }],
+            };
+        }
+    });
+    // codebuddy://sessions/latest
+    server.resource('sessions_latest', 'codebuddy://sessions/latest', {
+        description: 'Latest Code Buddy session data including messages and metadata',
+        mimeType: 'application/json',
+    }, async () => {
+        try {
+            const { getSessionStore } = await import('../persistence/session-store.js');
+            const store = getSessionStore();
+            const sessions = await store.getRecentSessions(1);
+            if (sessions.length === 0) {
+                return {
+                    contents: [{
+                            uri: 'codebuddy://sessions/latest',
+                            mimeType: 'application/json',
+                            text: JSON.stringify({ message: 'No sessions found' }),
+                        }],
+                };
+            }
+            const session = sessions[0];
+            const data = {
+                id: session.id,
+                name: session.name,
+                model: session.model,
+                workingDirectory: session.workingDirectory,
+                messageCount: session.messages?.length ?? 0,
+                createdAt: session.createdAt,
+                lastAccessedAt: session.lastAccessedAt,
+                recentMessages: (session.messages || []).slice(-10).map(m => ({
+                    type: m.type,
+                    content: m.content.length > 500 ? m.content.slice(0, 500) + '...' : m.content,
+                    timestamp: m.timestamp,
+                })),
+            };
+            return {
+                contents: [{
+                        uri: 'codebuddy://sessions/latest',
+                        mimeType: 'application/json',
+                        text: JSON.stringify(data, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                contents: [{
+                        uri: 'codebuddy://sessions/latest',
+                        mimeType: 'application/json',
+                        text: JSON.stringify({ error: message }),
+                    }],
+            };
+        }
+    });
+    // codebuddy://memory/all
+    server.resource('memory_all', 'codebuddy://memory/all', {
+        description: 'All stored Code Buddy memories formatted as markdown',
+        mimeType: 'text/markdown',
+    }, async () => {
+        try {
+            const { getMemoryManager } = await import('../memory/persistent-memory.js');
+            const manager = getMemoryManager();
+            await manager.initialize();
+            const text = manager.formatMemories() || 'No memories stored.';
+            return {
+                contents: [{
+                        uri: 'codebuddy://memory/all',
+                        mimeType: 'text/markdown',
+                        text,
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                contents: [{
+                        uri: 'codebuddy://memory/all',
+                        mimeType: 'text/plain',
+                        text: `Error loading memories: ${message}`,
+                    }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=mcp-resources.js.map

package/dist/mcp/mcp-resources.js.map

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

package/dist/mcp/mcp-server.d.ts

@@ -4,7 +4,7 @@
  * Allows Code Buddy to act as a tool provider for other AI agents
  * (VS Code, Cursor, Claude Desktop, etc.) over stdio transport.
  *
- * Exposed tools:
+ * Exposed tools (15 total):
  * - read_file: Read file contents
  * - write_file: Write/create a file
  * - edit_file: String replacement editing
@@ -12,6 +12,23 @@
  * - search_files: Search file contents (ripgrep-based)
  * - list_files: List directory contents
  * - git: Git operations (status, diff, log, add, commit, etc.)
+ * - agent_chat: AI-powered chat with tool execution
+ * - agent_task: Autonomous task execution
+ * - agent_plan: Create execution plan
+ * - memory_search: Search semantic memory
+ * - memory_save: Save persistent memory
+ * - session_list: List recent sessions
+ * - session_resume: Resume previous session
+ * - web_search: Web search via configured providers
+ *
+ * Resources (4):
+ * - codebuddy://project/context
+ * - codebuddy://project/instructions
+ * - codebuddy://sessions/latest
+ * - codebuddy://memory/all
+ *
+ * Prompts (5):
+ * - code_review, explain_code, generate_tests, refactor, fix_bugs
  */
 /**
  * Tool definition metadata for listing purposes.
@@ -37,7 +54,19 @@ export declare class CodeBuddyMCPServer {
     private searchTool;
     private gitTool;
     private bashTool;
+    private agent;
+    private agentInitPromise;
     constructor();
+    /**
+     * Lazily initialize the CodeBuddyAgent on first use.
+     */
+    private ensureAgent;
+    /**
+     * Register agent intelligence tools, resources, and prompts.
+     * Registration modules are lightweight (just Zod schemas + handler stubs).
+     * Heavy dependencies (agent, memory, sessions) are lazy-loaded inside handlers.
+     */
+    private registerAgentLayer;
     /**
      * Get the list of tools exposed by this MCP server.
      */