@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/core/MCPToolInterface.js

@@ -0,0 +1,376 @@
+import { spawn } from 'child_process';
+import path from 'path';
+import { NotFoundError, OperationError, ValidationError } from '../errors/index.js';
+export class MCPToolInterface {
+    tools = new Map();
+    toolDispatcher;
+    commandPolicy;
+    commandRunner;
+    memoryProvider;
+    activeProcesses = new Set();
+    constructor(options = {}) {
+        this.toolDispatcher = options.toolDispatcher;
+        this.commandPolicy = options.commandPolicy || createDefaultCommandPolicy();
+        this.commandRunner = options.commandRunner || createDefaultCommandRunner(this.activeProcesses);
+        this.memoryProvider = options.memoryProvider;
+    }
+    dispose() {
+        for (const child of this.activeProcesses) {
+            try {
+                child.kill('SIGTERM');
+                setTimeout(() => {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                    }
+                }, 1000);
+            }
+            catch {
+            }
+        }
+        this.activeProcesses.clear();
+    }
+    attachToolDispatcher(dispatcher) {
+        this.toolDispatcher = dispatcher;
+    }
+    attachMemoryProvider(provider) {
+        this.memoryProvider = provider;
+    }
+    supportsMemory() {
+        return Boolean(this.memoryProvider) || this.isToolRegistered('memory');
+    }
+    setCommandPolicy(policy) {
+        this.commandPolicy = policy;
+    }
+    filesystem = {
+        readFile: async (path) => {
+            const result = await this.invokeTool('filesystem', 'readFile', { path });
+            if (result.success && result.data) {
+                return result.data.content || '';
+            }
+            return '';
+        },
+        writeFile: async (opts) => {
+            await this.invokeTool('filesystem', 'writeFile', opts);
+        },
+    };
+    memory = {
+        createEntities: async (opts) => {
+            if (this.memoryProvider) {
+                await this.memoryProvider.createEntities(opts);
+                return;
+            }
+            await this.invokeTool('memory', 'createEntities', opts);
+        },
+        searchNodes: async (query) => {
+            if (this.memoryProvider) {
+                return await this.memoryProvider.searchNodes(query);
+            }
+            const result = await this.invokeTool('memory', 'searchNodes', { query });
+            if (result.success && result.data && Array.isArray(result.data)) {
+                return result.data;
+            }
+            return [];
+        },
+    };
+    playwright = {
+        navigate: async (url) => {
+            await this.invokeTool('playwright', 'navigate', { url });
+        },
+        snapshot: async () => {
+            const result = await this.invokeTool('playwright', 'snapshot', {});
+            return result.data || {};
+        },
+        click: async (opts) => {
+            await this.invokeTool('playwright', 'click', opts);
+        },
+        type: async (opts) => {
+            await this.invokeTool('playwright', 'type', opts);
+        },
+        waitFor: async (opts) => {
+            await this.invokeTool('playwright', 'waitFor', opts);
+        },
+        takeScreenshot: async (opts) => {
+            await this.invokeTool('playwright', 'takeScreenshot', opts);
+        },
+        evaluate: async (opts) => {
+            const result = await this.invokeTool('playwright', 'evaluate', opts);
+            return result.data || null;
+        },
+        close: async () => {
+            await this.invokeTool('playwright', 'close', {});
+        },
+    };
+    bash = async (opts) => {
+        const { command, timeout, confirmed } = opts;
+        if (!command || !command.trim()) {
+            throw new ValidationError('Command is required', {
+                component: 'MCPToolInterface',
+                method: 'bash',
+                providedValue: command,
+            });
+        }
+        let decision;
+        try {
+            decision = this.commandPolicy.evaluate(command);
+        }
+        catch (error) {
+            throw new OperationError(`Command policy evaluation failed: ${error instanceof Error ? error.message : String(error)}`, { command });
+        }
+        if (!decision.allowed) {
+            throw new OperationError(decision.reason ? `Command blocked: ${decision.reason}` : 'Command blocked by policy', { command });
+        }
+        if (decision.requiresConfirmation && !confirmed) {
+            throw new OperationError('Command requires confirmation. Re-run with confirmed: true.', { command });
+        }
+        const result = await this.commandRunner.run(command, timeout);
+        if (result.exitCode !== 0) {
+            throw new OperationError(`Command failed with exit code ${result.exitCode}`, { command, stdout: result.stdout, stderr: result.stderr });
+        }
+        return result;
+    };
+    registerTool(toolName, metadata) {
+        if (!toolName || !metadata) {
+            return false;
+        }
+        this.tools.set(toolName, metadata);
+        return true;
+    }
+    isToolRegistered(toolName) {
+        return this.tools.has(toolName);
+    }
+    getRegisteredTools() {
+        return Array.from(this.tools.keys());
+    }
+    async invokeTool(toolName, method, params) {
+        if (!this.isToolRegistered(toolName)) {
+            throw new NotFoundError(`Tool "${toolName}" is not registered`, 'tool', toolName, { method, params });
+        }
+        const metadata = this.tools.get(toolName);
+        if (!metadata?.methods.includes(method)) {
+            throw new NotFoundError(`Method "${method}" not available for tool "${toolName}"`, 'method', method, { toolName, availableMethods: metadata?.methods || [] });
+        }
+        throw new OperationError('External MCP tool invocation is not configured. Attach a ToolDispatcher for in-process tools.', {
+            toolName,
+            method,
+            params,
+        });
+    }
+    async invokeToolByName(toolName, args) {
+        if (!this.toolDispatcher) {
+            throw new OperationError('Tool dispatcher is not attached', {
+                toolName,
+                args,
+            });
+        }
+        const result = await this.toolDispatcher.routeToolCall({
+            name: toolName,
+            arguments: args,
+        });
+        return {
+            success: !result.isError,
+            data: result,
+            error: result.isError ? 'Tool execution failed' : undefined,
+        };
+    }
+    checkRequiredTools(requiredTools) {
+        const missing = [];
+        for (const tool of requiredTools) {
+            if (!this.isToolRegistered(tool)) {
+                missing.push(tool);
+            }
+        }
+        return {
+            allAvailable: missing.length === 0,
+            missing,
+        };
+    }
+    getToolMetadata(toolName) {
+        return this.tools.get(toolName);
+    }
+}
+const DEFAULT_ALLOWED_BINARIES = new Set([
+    'rg',
+    'ls',
+    'pwd',
+    'cat',
+    'stat',
+    'head',
+    'tail',
+    'node',
+    'npm',
+    'pnpm',
+    'yarn',
+    'bun',
+    'python',
+    'python3',
+    'pip',
+    'pip3',
+    'pytest',
+    'vitest',
+    'jest',
+    'mocha',
+    'tsc',
+    'eslint',
+    'prettier',
+    'go',
+    'cargo',
+    'make',
+]);
+const DEFAULT_CONFIRM_BINARIES = new Set([
+    'node',
+    'npm',
+    'pnpm',
+    'yarn',
+    'bun',
+    'python',
+    'python3',
+    'pip',
+    'pip3',
+    'go',
+    'cargo',
+    'make',
+]);
+function createDefaultCommandPolicy() {
+    return {
+        evaluate: (command) => {
+            const tokens = parseCommandLine(command);
+            if (tokens.length === 0) {
+                return { allowed: false, requiresConfirmation: false, reason: 'Empty command' };
+            }
+            const [binary] = tokens;
+            const normalizedBinary = path.basename(binary);
+            if (!DEFAULT_ALLOWED_BINARIES.has(normalizedBinary)) {
+                return {
+                    allowed: false,
+                    requiresConfirmation: false,
+                    reason: `Command not allowed by default: ${normalizedBinary}`,
+                };
+            }
+            return {
+                allowed: true,
+                requiresConfirmation: DEFAULT_CONFIRM_BINARIES.has(normalizedBinary),
+            };
+        },
+    };
+}
+function createDefaultCommandRunner(activeProcesses) {
+    return {
+        run: async (command, timeoutMs) => {
+            const tokens = parseCommandLine(command);
+            if (tokens.length === 0) {
+                return { exitCode: 1, stdout: '', stderr: 'No command provided' };
+            }
+            const [binary, ...args] = tokens;
+            const child = spawn(binary, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+            if (activeProcesses) {
+                activeProcesses.add(child);
+            }
+            let stdout = '';
+            let stderr = '';
+            let settled = false;
+            let killTimeoutId;
+            return await new Promise((resolve) => {
+                const cleanup = () => {
+                    if (activeProcesses) {
+                        activeProcesses.delete(child);
+                    }
+                    if (killTimeoutId) {
+                        clearTimeout(killTimeoutId);
+                        killTimeoutId = undefined;
+                    }
+                    child.stdout.removeAllListeners();
+                    child.stderr.removeAllListeners();
+                    child.removeAllListeners();
+                };
+                const finish = (exitCode, extraStderr) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (timeoutId)
+                        clearTimeout(timeoutId);
+                    if (extraStderr) {
+                        stderr += stderr ? `\n${extraStderr}` : extraStderr;
+                    }
+                    cleanup();
+                    resolve({ exitCode, stdout, stderr });
+                };
+                const timeoutId = timeoutMs && timeoutMs > 0 ? setTimeout(() => {
+                    try {
+                        child.kill('SIGTERM');
+                    }
+                    catch {
+                        finish(124, 'Command timed out');
+                        return;
+                    }
+                    killTimeoutId = setTimeout(() => {
+                        try {
+                            child.kill('SIGKILL');
+                        }
+                        catch {
+                        }
+                    }, 2000);
+                    finish(124, 'Command timed out');
+                }, timeoutMs) : undefined;
+                child.stdout.on('data', (chunk) => {
+                    stdout += chunk.toString();
+                });
+                child.stderr.on('data', (chunk) => {
+                    stderr += chunk.toString();
+                });
+                child.on('error', (error) => {
+                    finish(1, error.message);
+                });
+                child.on('close', (code) => {
+                    finish(code ?? 1);
+                });
+            });
+        },
+    };
+}
+function parseCommandLine(command) {
+    const tokens = [];
+    let current = '';
+    let quote = null;
+    let escape = false;
+    for (let i = 0; i < command.length; i += 1) {
+        const char = command[i];
+        if (escape) {
+            current += char;
+            escape = false;
+            continue;
+        }
+        if (char === '\\\\' && quote !== '\'') {
+            escape = true;
+            continue;
+        }
+        if ((char === '\"' || char === '\'') && !quote) {
+            quote = char;
+            continue;
+        }
+        if (quote && char === quote) {
+            quote = null;
+            continue;
+        }
+        if (!quote && /\\s/.test(char)) {
+            if (current) {
+                tokens.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (escape) {
+        current += '\\\\';
+    }
+    if (quote) {
+        throw new Error('Unterminated quote in command');
+    }
+    if (current) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+//# sourceMappingURL=MCPToolInterface.js.map

package/dist/core/MCPToolInterface.js.map

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

package/dist/core/PromptEnhancer.d.ts

@@ -0,0 +1,13 @@
+import { AgentType, Task, EnhancedPrompt } from '../orchestrator/types.js';
+export declare class PromptEnhancer {
+    enhance(agentType: AgentType, task: Task, complexity?: 'simple' | 'medium' | 'complex'): EnhancedPrompt;
+    private buildSystemPrompt;
+    private buildUserPrompt;
+    private buildGuardrails;
+    private getEvidenceGuardrails;
+    private getAgentSpecificInstructions;
+    private suggestModel;
+    getAgentPersona(agentType: AgentType): string;
+    getAgentTools(agentType: AgentType): string[];
+}
+//# sourceMappingURL=PromptEnhancer.d.ts.map

package/dist/core/PromptEnhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptEnhancer.d.ts","sourceRoot":"","sources":["../../src/core/PromptEnhancer.ts"],"names":[],"mappings":"AAgFA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AA0E3E,qBAAa,cAAc;IAmEzB,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAE,QAAQ,GAAG,QAAQ,GAAG,SAAoB,GAAG,cAAc;IAmEjH,OAAO,CAAC,iBAAiB;IAkFzB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,qBAAqB;IAgF7B,OAAO,CAAC,4BAA4B;IAgDpC,OAAO,CAAC,YAAY;IA4CpB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAsD7C,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE;CAG9C"}

package/dist/core/PromptEnhancer.js

@@ -0,0 +1,112 @@
+import { SimpleConfig } from '../config/simple-config.js';
+import { AGENT_PERSONAS, AGENT_TOOLS, AGENT_INSTRUCTIONS, MODEL_SUGGESTIONS, } from '../prompts/templates/PromptTemplates.js';
+export class PromptEnhancer {
+    enhance(agentType, task, complexity = 'medium') {
+        const systemPrompt = this.buildSystemPrompt(agentType);
+        const guardrails = this.buildGuardrails(agentType);
+        const userPrompt = this.buildUserPrompt(task, agentType, guardrails);
+        const suggestedModel = this.suggestModel(agentType, complexity);
+        const metadata = {
+            agentType,
+            taskId: task.id,
+            complexity,
+            timestamp: Date.now(),
+            tools: AGENT_TOOLS[agentType],
+        };
+        if (guardrails) {
+            metadata.guardrails = guardrails;
+        }
+        return { systemPrompt, userPrompt, suggestedModel, metadata };
+    }
+    buildSystemPrompt(agentType) {
+        const persona = AGENT_PERSONAS[agentType];
+        const tools = AGENT_TOOLS[agentType];
+        let systemPrompt = persona;
+        if (tools.length > 0) {
+            systemPrompt += `\n\nAvailable Tools:\n${tools.map(tool => `- ${tool}`).join('\n')}`;
+        }
+        systemPrompt += `\n\nIMPORTANT: Provide detailed, actionable responses with specific examples when helpful.`;
+        return systemPrompt;
+    }
+    buildUserPrompt(task, agentType, guardrails) {
+        let userPrompt = task.description;
+        const agentInstructions = this.getAgentSpecificInstructions(agentType);
+        if (agentInstructions) {
+            userPrompt += `\n\n${agentInstructions}`;
+        }
+        if (task.metadata && Object.keys(task.metadata).length > 0) {
+            userPrompt += `\n\nAdditional Context:\n${JSON.stringify(task.metadata, null, 2)}`;
+        }
+        if (guardrails) {
+            userPrompt += `\n\n${guardrails}`;
+        }
+        return userPrompt;
+    }
+    buildGuardrails(agentType) {
+        const sections = [];
+        if (SimpleConfig.EVIDENCE_MODE) {
+            const evidenceLines = [
+                'Do not invent files, APIs, errors, or test results.',
+                'Cite file paths/symbols or command output for each claim.',
+                'If evidence is missing, label it as "Assumption" and request the missing input.',
+                'Separate facts vs assumptions and list risks explicitly.',
+            ];
+            const agentSpecific = this.getEvidenceGuardrails(agentType);
+            if (agentSpecific.length > 0) {
+                evidenceLines.push(...agentSpecific);
+            }
+            sections.push(`Evidence & Risk Guard:\n${evidenceLines.map((line) => `- ${line}`).join('\n')}`);
+        }
+        if (SimpleConfig.BEGINNER_MODE) {
+            const beginnerLines = [
+                'Provide a 1-2 sentence plain-language summary.',
+                'Give exactly one "Next Step" and explain why it matters.',
+                'If a command is needed, include the safest command and expected output.',
+            ];
+            sections.push(`Beginner-Friendly Output:\n${beginnerLines.map((line) => `- ${line}`).join('\n')}`);
+        }
+        return sections.length > 0 ? sections.join('\n\n') : null;
+    }
+    getEvidenceGuardrails(agentType) {
+        switch (agentType) {
+            case 'code-reviewer':
+                return [
+                    'Group findings by severity (Blocker/High/Medium/Low).',
+                    'Include at least one concrete code reference per finding.',
+                    'List tests to run and highlight missing coverage.',
+                ];
+            case 'debugger':
+                return [
+                    'Provide reproduction steps or request them if missing.',
+                    'Explain root cause with evidence, then propose minimal fix.',
+                    'Include verification steps to prevent regressions.',
+                ];
+            case 'test-writer':
+            case 'test-automator':
+                return [
+                    'State which tests were run; if none, say "Not run".',
+                    'Provide the exact test command and summarize results.',
+                ];
+            case 'e2e-healing-agent':
+                return [
+                    'Cite screenshots/logs/traces when describing failures.',
+                    'State healing status and verification steps explicitly.',
+                ];
+            default:
+                return [];
+        }
+    }
+    getAgentSpecificInstructions(agentType) {
+        return AGENT_INSTRUCTIONS[agentType];
+    }
+    suggestModel(agentType, complexity) {
+        return MODEL_SUGGESTIONS[agentType][complexity];
+    }
+    getAgentPersona(agentType) {
+        return AGENT_PERSONAS[agentType];
+    }
+    getAgentTools(agentType) {
+        return AGENT_TOOLS[agentType];
+    }
+}
+//# sourceMappingURL=PromptEnhancer.js.map

package/dist/core/PromptEnhancer.js.map

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

package/dist/core/ResourceMonitor.d.ts

@@ -0,0 +1,32 @@
+import { SystemResources, ResourceCheckResult, ExecutionConfig } from './types.js';
+export declare class ResourceMonitor {
+    private activeBackgroundCount;
+    private maxBackgroundAgents;
+    private thresholds;
+    private activeIntervals;
+    private disposed;
+    constructor(maxBackgroundAgents?: number, thresholds?: {
+        maxCPU?: number;
+        maxMemory?: number;
+    });
+    getCurrentResources(): SystemResources;
+    canRunBackgroundTask(config?: ExecutionConfig): ResourceCheckResult;
+    registerBackgroundTask(): void;
+    unregisterBackgroundTask(): void;
+    getActiveBackgroundCount(): number;
+    setMaxCPU(percentage: number): void;
+    setMaxMemory(megabytes: number): void;
+    setMaxBackgroundAgents(count: number): void;
+    dispose(): void;
+    onThresholdExceeded(threshold: 'cpu' | 'memory', callback: (resources: SystemResources) => void): () => void;
+    getStats(): {
+        activeIntervals: number;
+        activeBackgroundAgents: number;
+        maxBackgroundAgents: number;
+        thresholds: {
+            maxCPU: number;
+            maxMemory: number;
+        };
+    };
+}
+//# sourceMappingURL=ResourceMonitor.d.ts.map

package/dist/core/ResourceMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceMonitor.d.ts","sourceRoot":"","sources":["../../src/core/ResourceMonitor.ts"],"names":[],"mappings":"AA6CA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgBnF,qBAAa,eAAe;IAC1B,OAAO,CAAC,qBAAqB,CAAa;IAC1C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,UAAU,CAGhB;IAMF,OAAO,CAAC,eAAe,CAAkC;IAKzD,OAAO,CAAC,QAAQ,CAAkB;gBAgChC,mBAAmB,GAAE,MAAU,EAC/B,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAiCH,mBAAmB,IAAI,eAAe;IA+FtC,oBAAoB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,mBAAmB;IAyEnE,sBAAsB,IAAI,IAAI;IAO9B,wBAAwB,IAAI,IAAI;IAShC,wBAAwB,IAAI,MAAM;IAOlC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAcnC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAarC,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAyB3C,OAAO,IAAI,IAAI;IAuBf,mBAAmB,CACjB,SAAS,EAAE,KAAK,GAAG,QAAQ,EAC3B,QAAQ,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,IAAI,GAC7C,MAAM,IAAI;IAwDb,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAC;QACxB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,UAAU,EAAE;YACV,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;KACH;CAQF"}