@phuetz/code-buddy 0.1.25 → 0.1.26

package/dist/tools/registry/lessons-tools.js

@@ -0,0 +1,359 @@
+/**
+ * Lessons Tool Adapters
+ *
+ * ITool-compliant adapters for the self-improvement loop:
+ * - LessonsAddTool    (`lessons_add`)    — capture a lesson after a correction
+ * - LessonsSearchTool (`lessons_search`) — find relevant lessons before a task
+ * - LessonsListTool   (`lessons_list`)   — list all lessons (with optional filter)
+ * - TaskVerifyTool    (`task_verify`)    — run tsc/tests/lint verification contract
+ */
+import { spawnSync } from 'child_process';
+import { getLessonsTracker } from '../../agent/lessons-tracker.js';
+// ============================================================================
+// LessonsAddTool
+// ============================================================================
+export class LessonsAddTool {
+    name = 'lessons_add';
+    description = [
+        'Capture a lesson learned into the persistent lessons.md file.',
+        'Use category=PATTERN for "what went wrong → correct approach" after a user correction.',
+        'Use category=RULE for invariants to always follow.',
+        'Use category=CONTEXT for project/domain-specific facts.',
+        'Use category=INSIGHT for non-obvious observations.',
+        'Call this immediately after any user correction to prevent the same mistake.',
+    ].join(' ');
+    async execute(input) {
+        const category = input.category ?? 'INSIGHT';
+        const content = input.content;
+        const context = input.context;
+        const source = input.source ?? 'manual';
+        if (!content)
+            return { success: false, error: 'content is required' };
+        const validCats = ['PATTERN', 'RULE', 'CONTEXT', 'INSIGHT'];
+        if (!validCats.includes(category)) {
+            return { success: false, error: `category must be one of: ${validCats.join(', ')}` };
+        }
+        try {
+            const tracker = getLessonsTracker(process.cwd());
+            const item = tracker.add(category, content, source, context);
+            return {
+                success: true,
+                output: `Lesson saved [${item.id}] (${category}): ${content}`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `lessons_add failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    category: {
+                        type: 'string',
+                        enum: ['PATTERN', 'RULE', 'CONTEXT', 'INSIGHT'],
+                        description: 'Lesson category',
+                    },
+                    content: {
+                        type: 'string',
+                        description: 'The lesson content. For PATTERN: "[what went wrong] → [correct behaviour]"',
+                    },
+                    context: {
+                        type: 'string',
+                        description: 'Optional domain context (e.g. "TypeScript", "bash", "React")',
+                    },
+                    source: {
+                        type: 'string',
+                        enum: ['user_correction', 'self_observed', 'manual'],
+                        description: 'Source of this lesson (default: manual)',
+                    },
+                },
+                required: ['content'],
+            },
+        };
+    }
+    validate(input) {
+        if (!input.content) {
+            return { isValid: false, errors: ['content is required'] };
+        }
+        const validCats = ['PATTERN', 'RULE', 'CONTEXT', 'INSIGHT'];
+        if (input.category && !validCats.includes(input.category)) {
+            return { isValid: false, errors: [`category must be one of: ${validCats.join(', ')}`] };
+        }
+        return { isValid: true, errors: [] };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            version: '1.0.0',
+            author: 'Code Buddy',
+            category: 'planning',
+            tags: ['lessons', 'self-improvement', 'patterns', 'learning'],
+        };
+    }
+    async isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// LessonsSearchTool
+// ============================================================================
+export class LessonsSearchTool {
+    name = 'lessons_search';
+    description = [
+        'Search lessons learned by keyword and optional category filter.',
+        'Call this before starting tasks similar to previous ones to avoid repeating mistakes.',
+        'Returns matching lessons sorted by recency.',
+    ].join(' ');
+    async execute(input) {
+        const query = input.query;
+        const category = input.category;
+        const limit = Math.min(Number(input.limit ?? 10), 50);
+        if (!query)
+            return { success: false, error: 'query is required' };
+        try {
+            const tracker = getLessonsTracker(process.cwd());
+            const results = tracker.search(query, category).slice(0, limit);
+            if (results.length === 0) {
+                return { success: true, output: `No lessons found matching "${query}".` };
+            }
+            const lines = results.map(l => `[${l.id}] **${l.category}** ${l.context ? `_(${l.context})_ ` : ''}${l.content}`);
+            return { success: true, output: `Found ${results.length} lesson(s):\n\n${lines.join('\n')}` };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `lessons_search failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Keyword(s) to search for in lesson content',
+                    },
+                    category: {
+                        type: 'string',
+                        enum: ['PATTERN', 'RULE', 'CONTEXT', 'INSIGHT'],
+                        description: 'Optional: filter to a specific category',
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of results (default: 10)',
+                    },
+                },
+                required: ['query'],
+            },
+        };
+    }
+    validate(input) {
+        if (!input.query) {
+            return { isValid: false, errors: ['query is required'] };
+        }
+        return { isValid: true, errors: [] };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            version: '1.0.0',
+            author: 'Code Buddy',
+            category: 'planning',
+            tags: ['lessons', 'search', 'self-improvement'],
+        };
+    }
+    async isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// LessonsListTool
+// ============================================================================
+export class LessonsListTool {
+    name = 'lessons_list';
+    description = 'List all lessons learned, optionally filtered by category (PATTERN|RULE|CONTEXT|INSIGHT).';
+    async execute(input) {
+        const category = input.category;
+        try {
+            const tracker = getLessonsTracker(process.cwd());
+            const items = tracker.list(category);
+            if (items.length === 0) {
+                return { success: true, output: 'No lessons recorded yet.' };
+            }
+            const lines = items.map(l => `[${l.id}] **${l.category}** ${l.context ? `_(${l.context})_ ` : ''}${l.content}`);
+            return { success: true, output: `${items.length} lesson(s):\n\n${lines.join('\n')}` };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `lessons_list failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    category: {
+                        type: 'string',
+                        enum: ['PATTERN', 'RULE', 'CONTEXT', 'INSIGHT'],
+                        description: 'Optional: filter to a specific category',
+                    },
+                },
+                required: [],
+            },
+        };
+    }
+    validate(_input) {
+        return { isValid: true, errors: [] };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            version: '1.0.0',
+            author: 'Code Buddy',
+            category: 'planning',
+            tags: ['lessons', 'list', 'self-improvement'],
+        };
+    }
+    async isAvailable() {
+        return true;
+    }
+}
+function runCheck(cmd, args, cwd, timeoutMs = 60_000) {
+    const result = spawnSync(cmd, args, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+        shell: false,
+    });
+    const raw = [result.stdout ?? '', result.stderr ?? ''].join('\n').trim();
+    // Truncate to last 2000 chars to keep output manageable
+    const output = raw.length > 2000 ? '...(truncated)\n' + raw.slice(-2000) : raw;
+    const pass = result.status === 0 && !result.error;
+    return { pass, output };
+}
+export class TaskVerifyTool {
+    name = 'task_verify';
+    description = [
+        'Run verification checks before marking a task complete (Verification Contract).',
+        'Checks: typescript (npx tsc --noEmit), tests (auto-detected from package.json), lint (eslint).',
+        'Returns pass/fail per check with truncated output.',
+        'Call this before every task completion to satisfy the Verification Contract.',
+    ].join(' ');
+    async execute(input) {
+        const checksInput = input.checks;
+        const workDir = input.workDir ?? process.cwd();
+        const checks = checksInput ?? ['typescript', 'tests'];
+        const validChecks = ['typescript', 'tests', 'lint'];
+        const invalid = checks.filter(c => !validChecks.includes(c));
+        if (invalid.length > 0) {
+            return { success: false, error: `Invalid checks: ${invalid.join(', ')}. Valid: ${validChecks.join(', ')}` };
+        }
+        const results = [];
+        for (const check of checks) {
+            let res;
+            if (check === 'typescript') {
+                res = runCheck('npx', ['tsc', '--noEmit'], workDir);
+            }
+            else if (check === 'tests') {
+                // Try to detect test command from RepoProfiler cache
+                let testCmd = 'npm';
+                let testArgs = ['test', '--', '--passWithNoTests'];
+                try {
+                    const { getRepoProfiler } = await import('../../agent/repo-profiler.js');
+                    const profile = await getRepoProfiler(workDir).getProfile();
+                    if (profile.commands.test) {
+                        const parts = profile.commands.test.split(/\s+/);
+                        testCmd = parts[0];
+                        testArgs = parts.slice(1);
+                    }
+                }
+                catch {
+                    // use default npm test
+                }
+                res = runCheck(testCmd, testArgs, workDir, 120_000);
+            }
+            else {
+                // lint
+                res = runCheck('npx', ['eslint', '.', '--max-warnings=0'], workDir, 60_000);
+            }
+            results.push({ check, pass: res.pass, output: res.output });
+        }
+        const allPass = results.every(r => r.pass);
+        const lines = results.map(r => {
+            const icon = r.pass ? '✅' : '❌';
+            return `${icon} **${r.check}**: ${r.pass ? 'PASS' : 'FAIL'}\n${r.output ? r.output + '\n' : ''}`;
+        });
+        return {
+            success: allPass,
+            output: lines.join('\n---\n'),
+            error: allPass ? undefined : `Verification failed for: ${results.filter(r => !r.pass).map(r => r.check).join(', ')}`,
+        };
+    }
+    getSchema() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: {
+                type: 'object',
+                properties: {
+                    checks: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            enum: ['typescript', 'tests', 'lint'],
+                        },
+                        description: 'List of checks to run (default: ["typescript", "tests"])',
+                    },
+                    workDir: {
+                        type: 'string',
+                        description: 'Working directory to run checks in (default: current directory)',
+                    },
+                },
+                required: [],
+            },
+        };
+    }
+    validate(_input) {
+        return { isValid: true, errors: [] };
+    }
+    getMetadata() {
+        return {
+            name: this.name,
+            version: '1.0.0',
+            author: 'Code Buddy',
+            category: 'testing',
+            tags: ['verify', 'typescript', 'tests', 'lint', 'quality'],
+        };
+    }
+    async isAvailable() {
+        return true;
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+export function createLessonsTools() {
+    return [
+        new LessonsAddTool(),
+        new LessonsSearchTool(),
+        new LessonsListTool(),
+        new TaskVerifyTool(),
+    ];
+}
+//# sourceMappingURL=lessons-tools.js.map

package/dist/tools/registry/lessons-tools.js.map

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

package/dist/tools/registry/plan-tools.d.ts

@@ -0,0 +1,2 @@
+import { ITool } from './types.js';
+export declare function createPlanTools(): ITool[];

package/dist/tools/registry/plan-tools.js

@@ -0,0 +1,7 @@
+import { PlanTool } from '../plan-tool.js';
+export function createPlanTools() {
+    return [
+        new PlanTool(),
+    ];
+}
+//# sourceMappingURL=plan-tools.js.map

package/dist/tools/registry/plan-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-tools.js","sourceRoot":"","sources":["../../../src/tools/registry/plan-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,IAAI,QAAQ,EAAE;KACf,CAAC;AACJ,CAAC"}

package/dist/tools/registry/script-tools.d.ts

@@ -0,0 +1,2 @@
+import { ITool } from './types.js';
+export declare function createScriptTools(): ITool[];

package/dist/tools/registry/script-tools.js

@@ -0,0 +1,7 @@
+import { RunScriptTool } from '../run-script-tool.js';
+export function createScriptTools() {
+    return [
+        new RunScriptTool(),
+    ];
+}
+//# sourceMappingURL=script-tools.js.map

package/dist/tools/registry/script-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-tools.js","sourceRoot":"","sources":["../../../src/tools/registry/script-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,aAAa,EAAE;KACpB,CAAC;AACJ,CAAC"}

package/dist/tools/registry/tool-aliases.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool Prefix Naming Convention — Codex-inspired canonical tool names.
+ *
+ * Codex CLI uses a strict `<namespace>_<action>` naming scheme so models
+ * can reason about tool categories by prefix (e.g. all `shell_*` tools
+ * spawn subprocesses; all `file_*` tools touch the filesystem).
+ *
+ * This module registers backward-compatible alias ITool wrappers so both
+ * the original names (e.g. `bash`, `view_file`) and the new canonical names
+ * (e.g. `shell_exec`, `file_read`) route to the same underlying implementation.
+ *
+ * Convention:
+ *   shell_*    → subprocess / terminal execution (bash, git, docker, process)
+ *   file_*     → read / write / edit filesystem files
+ *   browser_*  → web requests, browser control, screenshots
+ *   search_*   → code search, symbol lookup, find
+ *   plan_*     → persistent planning (PLAN.md)
+ *   todo_*     → attention todo list
+ *   knowledge_*→ knowledge base operations
+ *   agent_*    → human-in-the-loop / skill authoring
+ *
+ * To add new aliases simply append to TOOL_ALIASES below.
+ */
+import type { ITool } from './types.js';
+export declare const TOOL_ALIASES: Record<string, string>;
+/** Reverse map: legacy_name → canonical_name */
+export declare const CANONICAL_NAME: Record<string, string>;
+/**
+ * Given a list of registered tools, build alias ITool wrappers for each
+ * entry in TOOL_ALIASES that points to an existing primary tool.
+ *
+ * Aliases that point to missing primaries are silently skipped.
+ */
+export declare function createAliasTools(primaryTools: ITool[]): ITool[];
+/**
+ * Resolve a tool name to its canonical prefixed form.
+ * Returns the canonical name if a mapping exists, otherwise the original name.
+ */
+export declare function toCanonicalName(name: string): string;
+/**
+ * Resolve a canonical tool name to its legacy name (for backward compat lookup).
+ * Returns the legacy name if a mapping exists, otherwise the original name.
+ */
+export declare function toLegacyName(canonical: string): string;

package/dist/tools/registry/tool-aliases.js

@@ -0,0 +1,130 @@
+/**
+ * Tool Prefix Naming Convention — Codex-inspired canonical tool names.
+ *
+ * Codex CLI uses a strict `<namespace>_<action>` naming scheme so models
+ * can reason about tool categories by prefix (e.g. all `shell_*` tools
+ * spawn subprocesses; all `file_*` tools touch the filesystem).
+ *
+ * This module registers backward-compatible alias ITool wrappers so both
+ * the original names (e.g. `bash`, `view_file`) and the new canonical names
+ * (e.g. `shell_exec`, `file_read`) route to the same underlying implementation.
+ *
+ * Convention:
+ *   shell_*    → subprocess / terminal execution (bash, git, docker, process)
+ *   file_*     → read / write / edit filesystem files
+ *   browser_*  → web requests, browser control, screenshots
+ *   search_*   → code search, symbol lookup, find
+ *   plan_*     → persistent planning (PLAN.md)
+ *   todo_*     → attention todo list
+ *   knowledge_*→ knowledge base operations
+ *   agent_*    → human-in-the-loop / skill authoring
+ *
+ * To add new aliases simply append to TOOL_ALIASES below.
+ */
+// ============================================================================
+// Alias map: canonical_name → legacy_name
+// ============================================================================
+export const TOOL_ALIASES = {
+    // shell_* — subprocess execution
+    shell_exec: 'bash',
+    shell_git: 'git',
+    shell_docker: 'docker',
+    shell_k8s: 'kubernetes',
+    shell_process: 'process',
+    // file_* — filesystem operations
+    file_read: 'view_file',
+    file_write: 'create_file',
+    file_edit: 'str_replace_editor',
+    // browser_* — web / browser
+    browser_search: 'web_search',
+    browser_fetch: 'web_fetch',
+    browser_control: 'browser',
+    browser_screen: 'screenshot',
+    // search_* — code intelligence
+    search_code: 'search',
+    search_symbol: 'find_symbols',
+    search_refs: 'find_references',
+    search_definition: 'find_definition',
+    search_multi: 'search_multi', // already has prefix
+    // agent_* — agent capabilities
+    agent_reason: 'reason',
+    agent_ask_human: 'ask_human',
+    agent_create_skill: 'create_skill',
+    agent_skill_search: 'skill_discover',
+    agent_device: 'device_manage',
+    // todo_* (already prefixed, kept for completeness)
+    todo_attention: 'todo_update',
+    context_restore: 'restore_context',
+};
+/** Reverse map: legacy_name → canonical_name */
+export const CANONICAL_NAME = Object.fromEntries(Object.entries(TOOL_ALIASES).map(([canonical, legacy]) => [legacy, canonical]));
+// ============================================================================
+// AliasITool — lightweight wrapper that delegates to the primary tool
+// ============================================================================
+class AliasITool {
+    name;
+    primary;
+    constructor(aliasName, primaryTool) {
+        this.name = aliasName;
+        this.primary = primaryTool;
+    }
+    get metadata() {
+        return {
+            ...this.primary.metadata,
+            name: this.name,
+            description: `[alias → ${this.primary.name}] ${this.primary.metadata.description}`,
+            tags: [...(this.primary.metadata.tags ?? []), 'alias'],
+        };
+    }
+    get schema() {
+        return {
+            ...this.primary.schema,
+            name: this.name,
+            description: `[alias → ${this.primary.name}] ${this.primary.schema.description ?? ''}`,
+        };
+    }
+    validate(input) {
+        return this.primary.validate(input);
+    }
+    async execute(input, context) {
+        return this.primary.execute(input, context);
+    }
+}
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Given a list of registered tools, build alias ITool wrappers for each
+ * entry in TOOL_ALIASES that points to an existing primary tool.
+ *
+ * Aliases that point to missing primaries are silently skipped.
+ */
+export function createAliasTools(primaryTools) {
+    const byName = new Map(primaryTools.map(t => [t.name, t]));
+    const aliases = [];
+    for (const [canonical, legacy] of Object.entries(TOOL_ALIASES)) {
+        const primary = byName.get(legacy);
+        if (!primary)
+            continue;
+        // Don't create an alias if the canonical name is already registered
+        if (byName.has(canonical))
+            continue;
+        aliases.push(new AliasITool(canonical, primary));
+    }
+    return aliases;
+}
+/**
+ * Resolve a tool name to its canonical prefixed form.
+ * Returns the canonical name if a mapping exists, otherwise the original name.
+ */
+export function toCanonicalName(name) {
+    return CANONICAL_NAME[name] ?? name;
+}
+/**
+ * Resolve a canonical tool name to its legacy name (for backward compat lookup).
+ * Returns the legacy name if a mapping exists, otherwise the original name.
+ */
+export function toLegacyName(canonical) {
+    return TOOL_ALIASES[canonical] ?? canonical;
+}
+//# sourceMappingURL=tool-aliases.js.map

package/dist/tools/registry/tool-aliases.js.map

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

package/dist/tools/run-script-tool.d.ts

@@ -0,0 +1,13 @@
+import { BaseTool } from './base-tool.js';
+import { ToolResult } from '../types/index.js';
+import { ParameterDefinition } from './base-tool.js';
+export declare class RunScriptTool extends BaseTool {
+    readonly name = "run_script";
+    readonly description = "Execute a Python, TypeScript, or JavaScript script in a secure sandboxed environment (Docker). Supports external dependencies.";
+    private workspacePath;
+    constructor(workspacePath?: string);
+    protected getParameters(): Record<string, ParameterDefinition>;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+    private getExtension;
+    private getDockerImage;
+}