@phuetz/code-buddy 0.1.18 → 0.1.20

package/dist/memory/auto-memory.js

@@ -0,0 +1,250 @@
+/**
+ * Auto-Memory System
+ *
+ * Automatically extracts and stores memories from agent interactions.
+ * Supports three scopes: user, project, and local.
+ * Memories are stored in MEMORY.md files at scope-appropriate paths.
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Keyword Patterns for Analysis
+// ============================================================================
+const ANALYSIS_PATTERNS = [
+    {
+        category: 'project-structure',
+        patterns: [
+            /(?:project|repo|codebase) (?:uses?|is built with|structure[ds]?) ([^.]+)/i,
+            /(?:main|entry|root) (?:file|directory|folder) (?:is|at) ([^\s.]+)/i,
+            /monorepo (?:with|using|containing) ([^.]+)/i,
+        ],
+    },
+    {
+        category: 'user-preference',
+        patterns: [
+            /(?:i |we |please )prefer ([^.]+)/i,
+            /(?:always|never) (?:use|do|include) ([^.]+)/i,
+            /(?:my|our) (?:preferred|favorite) ([^.]+)/i,
+        ],
+    },
+    {
+        category: 'error-solution',
+        patterns: [
+            /(?:fix|solution|resolved|workaround)[:\s]+([^.]+)/i,
+            /(?:the error|the issue|the bug) (?:was|is) (?:caused by|due to|fixed by) ([^.]+)/i,
+        ],
+    },
+    {
+        category: 'architecture',
+        patterns: [
+            /(?:architecture|pattern|design) (?:is|uses?|follows?) ([^.]+)/i,
+            /(?:we use|using) (?:the )?([^.]*(?:pattern|architecture|approach))/i,
+        ],
+    },
+    {
+        category: 'important-file',
+        patterns: [
+            /(?:important|key|critical|config) files?[:\s]+([^\n.]+)/i,
+            /(?:don't|do not|never) (?:edit|modify|touch|delete) ([^\s.]+)/i,
+        ],
+    },
+];
+// ============================================================================
+// AutoMemoryManager
+// ============================================================================
+export class AutoMemoryManager {
+    projectDir;
+    memories = new Map();
+    constructor(projectDir = process.cwd()) {
+        this.projectDir = projectDir;
+        this.loadAllMemories();
+    }
+    /**
+     * Analyze context and response for potential memories to extract
+     */
+    analyzeForMemories(context, response) {
+        const extracted = [];
+        const combined = `${context}\n${response}`;
+        for (const { category, patterns } of ANALYSIS_PATTERNS) {
+            for (const pattern of patterns) {
+                const match = combined.match(pattern);
+                if (match && match[1]) {
+                    const key = `${category}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+                    const entry = {
+                        key,
+                        value: match[0].trim(),
+                        scope: 'project',
+                        timestamp: Date.now(),
+                        source: 'agent',
+                    };
+                    extracted.push(entry);
+                }
+            }
+        }
+        return extracted;
+    }
+    /**
+     * Write a memory entry to the appropriate MEMORY.md file
+     */
+    writeMemory(key, value, scope = 'project') {
+        const entry = {
+            key,
+            value,
+            scope,
+            timestamp: Date.now(),
+            source: 'user',
+        };
+        this.memories.set(`${scope}:${key}`, entry);
+        const memoryPath = this.getMemoryPath(scope);
+        const dir = path.dirname(memoryPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.saveMemoryFile(scope);
+        logger.debug(`Memory written: ${key} (${scope})`, { source: 'AutoMemoryManager' });
+    }
+    /**
+     * Search all scoped memory files for relevant entries
+     */
+    recallMemories(context) {
+        const contextLower = context.toLowerCase();
+        const words = contextLower.split(/\s+/).filter((w) => w.length > 3);
+        const results = [];
+        for (const entry of this.memories.values()) {
+            const entryText = `${entry.key} ${entry.value}`.toLowerCase();
+            let score = 0;
+            for (const word of words) {
+                if (entryText.includes(word)) {
+                    score++;
+                }
+            }
+            if (score > 0) {
+                results.push(entry);
+            }
+        }
+        // Sort by relevance (more matching words first), then by recency
+        results.sort((a, b) => {
+            return b.timestamp - a.timestamp;
+        });
+        return results;
+    }
+    /**
+     * Get the file path for a given memory scope
+     */
+    getMemoryPath(scope) {
+        switch (scope) {
+            case 'user':
+                return path.join(os.homedir(), '.codebuddy', 'memory', 'MEMORY.md');
+            case 'project':
+                return path.join(this.projectDir, '.codebuddy', 'memory', 'MEMORY.md');
+            case 'local':
+                return path.join(this.projectDir, '.codebuddy', 'memory', 'local', 'MEMORY.md');
+        }
+    }
+    /**
+     * List all memories, optionally filtered by scope
+     */
+    listMemories(scope) {
+        const entries = Array.from(this.memories.values());
+        if (scope) {
+            return entries.filter((e) => e.scope === scope);
+        }
+        return entries;
+    }
+    /**
+     * Delete a memory entry by key and optional scope
+     */
+    deleteMemory(key, scope) {
+        if (scope) {
+            const compositeKey = `${scope}:${key}`;
+            const deleted = this.memories.delete(compositeKey);
+            if (deleted) {
+                this.saveMemoryFile(scope);
+            }
+            return deleted;
+        }
+        // Try all scopes
+        let deleted = false;
+        for (const s of ['user', 'project', 'local']) {
+            const compositeKey = `${s}:${key}`;
+            if (this.memories.delete(compositeKey)) {
+                this.saveMemoryFile(s);
+                deleted = true;
+            }
+        }
+        return deleted;
+    }
+    /**
+     * Get a summary of recalled memories count
+     */
+    getRecallSummary() {
+        const count = this.memories.size;
+        return `Recalled ${count} memories`;
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    loadAllMemories() {
+        for (const scope of ['user', 'project', 'local']) {
+            this.loadMemoryFile(scope);
+        }
+    }
+    loadMemoryFile(scope) {
+        const memoryPath = this.getMemoryPath(scope);
+        try {
+            if (!fs.existsSync(memoryPath)) {
+                return;
+            }
+            const content = fs.readFileSync(memoryPath, 'utf-8');
+            const lines = content.split('\n');
+            for (const line of lines) {
+                // Parse entries in format: - **key**: value [timestamp] [source]
+                const match = line.match(/^-\s*\*\*([^*]+)\*\*:\s*(.+?)(?:\s*\[(\d+)\])?\s*(?:\[(\w+)\])?\s*$/);
+                if (match) {
+                    const entry = {
+                        key: match[1],
+                        value: match[2].trim(),
+                        scope,
+                        timestamp: match[3] ? parseInt(match[3], 10) : Date.now(),
+                        source: match[4] || 'user',
+                    };
+                    this.memories.set(`${scope}:${entry.key}`, entry);
+                }
+            }
+        }
+        catch (error) {
+            logger.debug(`Failed to load memory file ${memoryPath}: ${error}`, { source: 'AutoMemoryManager' });
+        }
+    }
+    saveMemoryFile(scope) {
+        const memoryPath = this.getMemoryPath(scope);
+        const entries = this.listMemories(scope);
+        let content = `# Code Buddy Auto-Memory (${scope})\n\n`;
+        content += `## Memories\n\n`;
+        for (const entry of entries) {
+            content += `- **${entry.key}**: ${entry.value} [${entry.timestamp}] [${entry.source}]\n`;
+        }
+        content += `\n---\n*Last updated: ${new Date().toISOString()}*\n`;
+        const dir = path.dirname(memoryPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(memoryPath, content);
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let instance = null;
+export function getAutoMemoryManager(projectDir) {
+    if (!instance || projectDir) {
+        instance = new AutoMemoryManager(projectDir);
+    }
+    return instance;
+}
+export function resetAutoMemory() {
+    instance = null;
+}
+//# sourceMappingURL=auto-memory.js.map

package/dist/memory/auto-memory.js.map

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

package/dist/memory/hybrid-search.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hybrid Memory Search
+ *
+ * Combines BM25 keyword search with semantic vector search
+ * for high-quality memory retrieval. Currently BM25 is fully
+ * implemented; semantic search is a stub for future embedding integration.
+ */
+export interface SearchResult {
+    key: string;
+    value: string;
+    score: number;
+    source: 'bm25' | 'semantic' | 'hybrid';
+}
+export declare class BM25Index {
+    private documents;
+    private tokenizedDocs;
+    private docLengths;
+    private avgDocLength;
+    private df;
+    private k1;
+    private b;
+    constructor(k1?: number, b?: number);
+    addDocument(id: string, text: string): void;
+    search(query: string, limit?: number): SearchResult[];
+    removeDocument(id: string): void;
+    getDocumentCount(): number;
+    private tokenize;
+    private updateAvgDocLength;
+}
+export declare class HybridMemorySearch {
+    private static instance;
+    private bm25Index;
+    private bm25Weight;
+    private semanticWeight;
+    private constructor();
+    static getInstance(): HybridMemorySearch;
+    static resetInstance(): void;
+    index(entries: Array<{
+        key: string;
+        value: string;
+    }>): void;
+    search(query: string, limit?: number): SearchResult[];
+    setWeights(bm25Weight: number, semanticWeight: number): void;
+    getStats(): {
+        documentCount: number;
+        bm25Weight: number;
+        semanticWeight: number;
+    };
+    clear(): void;
+    private mergeResults;
+}

package/dist/memory/hybrid-search.js

@@ -0,0 +1,199 @@
+/**
+ * Hybrid Memory Search
+ *
+ * Combines BM25 keyword search with semantic vector search
+ * for high-quality memory retrieval. Currently BM25 is fully
+ * implemented; semantic search is a stub for future embedding integration.
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// BM25Index
+// ============================================================================
+export class BM25Index {
+    documents = new Map();
+    tokenizedDocs = new Map();
+    docLengths = new Map();
+    avgDocLength = 0;
+    df = new Map(); // document frequency
+    k1;
+    b;
+    constructor(k1 = 1.5, b = 0.75) {
+        this.k1 = k1;
+        this.b = b;
+    }
+    addDocument(id, text) {
+        // Remove if exists to update
+        if (this.documents.has(id)) {
+            this.removeDocument(id);
+        }
+        this.documents.set(id, text);
+        const tokens = this.tokenize(text);
+        this.tokenizedDocs.set(id, tokens);
+        this.docLengths.set(id, tokens.length);
+        // Update document frequency
+        const uniqueTokens = new Set(tokens);
+        for (const token of uniqueTokens) {
+            this.df.set(token, (this.df.get(token) || 0) + 1);
+        }
+        this.updateAvgDocLength();
+        logger.debug('Document added to BM25 index', { id });
+    }
+    search(query, limit = 10) {
+        const queryTokens = this.tokenize(query);
+        const n = this.documents.size;
+        if (n === 0)
+            return [];
+        const scores = [];
+        for (const [docId, tokens] of this.tokenizedDocs.entries()) {
+            let score = 0;
+            const dl = this.docLengths.get(docId) || 0;
+            for (const qToken of queryTokens) {
+                const docFreq = this.df.get(qToken) || 0;
+                if (docFreq === 0)
+                    continue;
+                // IDF = ln((N - df + 0.5) / (df + 0.5) + 1)
+                const idf = Math.log((n - docFreq + 0.5) / (docFreq + 0.5) + 1);
+                // Term frequency in document
+                const tf = tokens.filter(t => t === qToken).length;
+                // BM25 score component
+                const tfNorm = (tf * (this.k1 + 1)) / (tf + this.k1 * (1 - this.b + this.b * dl / this.avgDocLength));
+                score += idf * tfNorm;
+            }
+            if (score > 0) {
+                scores.push({ id: docId, score });
+            }
+        }
+        scores.sort((a, b) => b.score - a.score);
+        return scores.slice(0, limit).map(s => ({
+            key: s.id,
+            value: this.documents.get(s.id) || '',
+            score: s.score,
+            source: 'bm25',
+        }));
+    }
+    removeDocument(id) {
+        const tokens = this.tokenizedDocs.get(id);
+        if (tokens) {
+            const uniqueTokens = new Set(tokens);
+            for (const token of uniqueTokens) {
+                const count = this.df.get(token) || 0;
+                if (count <= 1) {
+                    this.df.delete(token);
+                }
+                else {
+                    this.df.set(token, count - 1);
+                }
+            }
+        }
+        this.documents.delete(id);
+        this.tokenizedDocs.delete(id);
+        this.docLengths.delete(id);
+        this.updateAvgDocLength();
+    }
+    getDocumentCount() {
+        return this.documents.size;
+    }
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter(t => t.length > 0);
+    }
+    updateAvgDocLength() {
+        if (this.docLengths.size === 0) {
+            this.avgDocLength = 0;
+            return;
+        }
+        let total = 0;
+        for (const len of this.docLengths.values()) {
+            total += len;
+        }
+        this.avgDocLength = total / this.docLengths.size;
+    }
+}
+// ============================================================================
+// HybridMemorySearch
+// ============================================================================
+export class HybridMemorySearch {
+    static instance = null;
+    bm25Index;
+    bm25Weight = 0.7;
+    semanticWeight = 0.3;
+    constructor() {
+        this.bm25Index = new BM25Index();
+    }
+    static getInstance() {
+        if (!HybridMemorySearch.instance) {
+            HybridMemorySearch.instance = new HybridMemorySearch();
+        }
+        return HybridMemorySearch.instance;
+    }
+    static resetInstance() {
+        HybridMemorySearch.instance = null;
+    }
+    index(entries) {
+        for (const entry of entries) {
+            this.bm25Index.addDocument(entry.key, entry.value);
+        }
+        logger.debug('Indexed entries', { count: entries.length });
+    }
+    search(query, limit = 10) {
+        // BM25 search
+        const bm25Results = this.bm25Index.search(query, limit);
+        // Semantic search stub - returns empty for now
+        const semanticResults = [];
+        // If no semantic results, use BM25 at full weight
+        if (semanticResults.length === 0) {
+            return bm25Results.map(r => ({
+                ...r,
+                source: 'hybrid',
+            }));
+        }
+        // Hybrid merge (for future use when semantic is implemented)
+        return this.mergeResults(bm25Results, semanticResults, limit);
+    }
+    setWeights(bm25Weight, semanticWeight) {
+        this.bm25Weight = bm25Weight;
+        this.semanticWeight = semanticWeight;
+    }
+    getStats() {
+        return {
+            documentCount: this.bm25Index.getDocumentCount(),
+            bm25Weight: this.bm25Weight,
+            semanticWeight: this.semanticWeight,
+        };
+    }
+    clear() {
+        this.bm25Index = new BM25Index();
+    }
+    mergeResults(bm25, semantic, limit) {
+        const merged = new Map();
+        for (const r of bm25) {
+            merged.set(r.key, {
+                key: r.key,
+                value: r.value,
+                score: r.score * this.bm25Weight,
+                source: 'hybrid',
+            });
+        }
+        for (const r of semantic) {
+            const existing = merged.get(r.key);
+            if (existing) {
+                existing.score += r.score * this.semanticWeight;
+            }
+            else {
+                merged.set(r.key, {
+                    key: r.key,
+                    value: r.value,
+                    score: r.score * this.semanticWeight,
+                    source: 'hybrid',
+                });
+            }
+        }
+        return Array.from(merged.values())
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+}
+//# sourceMappingURL=hybrid-search.js.map

package/dist/memory/hybrid-search.js.map

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

package/dist/memory/memory-flush.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Pre-Threshold Memory Flush + Plugin Memory Backends
+ * Flushes context before compaction and supports pluggable memory backends.
+ */
+export interface SearchResult {
+    key: string;
+    value: string;
+    score: number;
+}
+export interface MemoryBackend {
+    name: string;
+    search(query: string, limit?: number): SearchResult[];
+    index(entries: Array<{
+        key: string;
+        value: string;
+    }>): void;
+    clear(): void;
+}
+export declare class PreThresholdFlusher {
+    private static instance;
+    private lastFlushTime;
+    private flushCount;
+    private flushPath;
+    constructor(flushPath?: string);
+    static getInstance(): PreThresholdFlusher;
+    static resetInstance(): void;
+    shouldFlush(currentTokens: number, maxTokens: number, threshold?: number): boolean;
+    flush(context: {
+        messages: unknown[];
+        keyFacts: string[];
+    }): {
+        flushed: boolean;
+        path: string;
+    };
+    getFlushPath(): string;
+    getLastFlushTime(): number;
+    getFlushCount(): number;
+}
+export declare class MemoryBackendManager {
+    private static instance;
+    private backends;
+    private activeBackendName;
+    constructor();
+    static getInstance(): MemoryBackendManager;
+    static resetInstance(): void;
+    registerBackend(backend: MemoryBackend): void;
+    getBackend(name: string): MemoryBackend | undefined;
+    setActiveBackend(name: string): void;
+    getActiveBackend(): MemoryBackend;
+    listBackends(): string[];
+}

package/dist/memory/memory-flush.js

@@ -0,0 +1,102 @@
+/**
+ * Pre-Threshold Memory Flush + Plugin Memory Backends
+ * Flushes context before compaction and supports pluggable memory backends.
+ */
+import { logger } from '../utils/logger.js';
+export class PreThresholdFlusher {
+    static instance = null;
+    lastFlushTime = 0;
+    flushCount = 0;
+    flushPath;
+    constructor(flushPath) {
+        this.flushPath = flushPath || '.codebuddy/memory-flush.json';
+    }
+    static getInstance() {
+        if (!PreThresholdFlusher.instance) {
+            PreThresholdFlusher.instance = new PreThresholdFlusher();
+        }
+        return PreThresholdFlusher.instance;
+    }
+    static resetInstance() {
+        PreThresholdFlusher.instance = null;
+    }
+    shouldFlush(currentTokens, maxTokens, threshold) {
+        const t = threshold ?? 0.8;
+        return currentTokens / maxTokens > t;
+    }
+    flush(context) {
+        this.lastFlushTime = Date.now();
+        this.flushCount++;
+        logger.debug(`Memory flush #${this.flushCount}: ${context.keyFacts.length} key facts`);
+        return { flushed: true, path: this.flushPath };
+    }
+    getFlushPath() {
+        return this.flushPath;
+    }
+    getLastFlushTime() {
+        return this.lastFlushTime;
+    }
+    getFlushCount() {
+        return this.flushCount;
+    }
+}
+class DefaultMemoryBackend {
+    name = 'default';
+    store = new Map();
+    search(query, limit) {
+        const results = [];
+        const queryLower = query.toLowerCase();
+        for (const [key, value] of this.store) {
+            const text = `${key} ${value}`.toLowerCase();
+            if (text.includes(queryLower)) {
+                results.push({ key, value, score: 1.0 });
+            }
+        }
+        return limit ? results.slice(0, limit) : results;
+    }
+    index(entries) {
+        for (const entry of entries) {
+            this.store.set(entry.key, entry.value);
+        }
+    }
+    clear() {
+        this.store.clear();
+    }
+}
+export class MemoryBackendManager {
+    static instance = null;
+    backends = new Map();
+    activeBackendName = 'default';
+    constructor() {
+        this.backends.set('default', new DefaultMemoryBackend());
+    }
+    static getInstance() {
+        if (!MemoryBackendManager.instance) {
+            MemoryBackendManager.instance = new MemoryBackendManager();
+        }
+        return MemoryBackendManager.instance;
+    }
+    static resetInstance() {
+        MemoryBackendManager.instance = null;
+    }
+    registerBackend(backend) {
+        this.backends.set(backend.name, backend);
+        logger.debug(`Registered memory backend: ${backend.name}`);
+    }
+    getBackend(name) {
+        return this.backends.get(name);
+    }
+    setActiveBackend(name) {
+        if (!this.backends.has(name)) {
+            throw new Error(`Memory backend '${name}' not found`);
+        }
+        this.activeBackendName = name;
+    }
+    getActiveBackend() {
+        return this.backends.get(this.activeBackendName);
+    }
+    listBackends() {
+        return Array.from(this.backends.keys());
+    }
+}
+//# sourceMappingURL=memory-flush.js.map