cccmemory 1.8.0

package/dist/context/ContextInjector.js

@@ -0,0 +1,235 @@
+/**
+ * Context Injector
+ *
+ * Intelligently selects and formats context for injection into new conversations.
+ * Combines working memory, handoffs, decisions, and file history.
+ */
+import { WorkingMemoryStore } from "../memory/WorkingMemoryStore.js";
+import { SessionHandoffStore } from "../handoff/SessionHandoffStore.js";
+export class ContextInjector {
+    memoryStore;
+    handoffStore;
+    constructor(db) {
+        this.memoryStore = new WorkingMemoryStore(db);
+        this.handoffStore = new SessionHandoffStore(db);
+    }
+    /**
+     * Get relevant context for a new conversation
+     */
+    async getRelevantContext(options) {
+        const { query, projectPath, maxTokens = 2000, sources = ["history", "decisions", "memory", "handoffs"], } = options;
+        const items = [];
+        // 1. Get most recent handoff
+        let handoff;
+        if (sources.includes("handoffs")) {
+            const handoffs = this.handoffStore.listHandoffs(projectPath, {
+                limit: 1,
+                includeResumed: false,
+            });
+            if (handoffs.length > 0) {
+                handoff = this.handoffStore.getHandoff(handoffs[0].id) || undefined;
+                if (handoff) {
+                    items.push({
+                        type: "handoff",
+                        content: `Previous session context: ${handoff.contextSummary}`,
+                        priority: "critical",
+                        timestamp: handoff.createdAt,
+                        tokenEstimate: this.estimateTokens(handoff.contextSummary) + 20,
+                    });
+                }
+            }
+        }
+        // 2. Get relevant working memory items
+        const memory = [];
+        if (sources.includes("memory")) {
+            if (query) {
+                // Semantic search for relevant items
+                const relevant = this.memoryStore.recallRelevant({
+                    query,
+                    projectPath,
+                    limit: 10,
+                });
+                memory.push(...relevant);
+            }
+            else {
+                // Get recent items
+                const recent = this.memoryStore.list(projectPath, { limit: 10 });
+                memory.push(...recent);
+            }
+            for (const item of memory) {
+                items.push({
+                    type: "memory",
+                    content: `${item.key}: ${item.value}`,
+                    priority: this.getMemoryPriority(item),
+                    timestamp: item.updatedAt,
+                    tokenEstimate: this.estimateTokens(`${item.key}: ${item.value}`),
+                });
+            }
+        }
+        // 3. Get decisions from handoff
+        const decisions = [];
+        if (sources.includes("decisions") && handoff) {
+            decisions.push(...handoff.decisions.slice(0, 10));
+            for (const decision of decisions) {
+                items.push({
+                    type: "decision",
+                    content: decision.text,
+                    priority: "high",
+                    timestamp: decision.timestamp,
+                    tokenEstimate: this.estimateTokens(decision.text),
+                });
+            }
+        }
+        // 4. Get recent files from handoff
+        const recentFiles = [];
+        if (sources.includes("history") && handoff) {
+            recentFiles.push(...handoff.activeFiles.slice(0, 10));
+            for (const file of recentFiles) {
+                items.push({
+                    type: "file",
+                    content: `${file.lastAction}: ${file.path}`,
+                    priority: "medium",
+                    timestamp: file.timestamp,
+                    tokenEstimate: this.estimateTokens(`${file.lastAction}: ${file.path}`),
+                });
+            }
+        }
+        // 5. Select items within token budget
+        const selectedItems = this.selectWithinBudget(items, maxTokens);
+        // 6. Generate summary
+        const summary = this.generateSummary(selectedItems, projectPath);
+        // 7. Calculate total token estimate
+        const tokenEstimate = selectedItems.reduce((sum, item) => sum + item.tokenEstimate, 0);
+        return {
+            handoff,
+            decisions,
+            memory,
+            recentFiles,
+            summary,
+            tokenEstimate,
+        };
+    }
+    /**
+     * Format context for direct injection into conversation
+     */
+    formatForInjection(context) {
+        const parts = [];
+        // Add handoff summary if available
+        if (context.handoff) {
+            parts.push("## Previous Session Context");
+            parts.push(context.handoff.contextSummary);
+            parts.push("");
+        }
+        // Add key decisions
+        if (context.decisions.length > 0) {
+            parts.push("## Recent Decisions");
+            for (const decision of context.decisions.slice(0, 5)) {
+                parts.push(`- ${decision.text}`);
+            }
+            parts.push("");
+        }
+        // Add working memory items
+        if (context.memory.length > 0) {
+            parts.push("## Remembered Context");
+            for (const item of context.memory.slice(0, 5)) {
+                parts.push(`- **${item.key}**: ${item.value}`);
+            }
+            parts.push("");
+        }
+        // Add recent file activity
+        if (context.recentFiles.length > 0) {
+            parts.push("## Recent Files");
+            for (const file of context.recentFiles.slice(0, 5)) {
+                parts.push(`- [${file.lastAction}] ${file.path}`);
+            }
+            parts.push("");
+        }
+        return parts.join("\n");
+    }
+    /**
+     * Get priority for a memory item based on tags and recency
+     */
+    getMemoryPriority(item) {
+        const tags = item.tags;
+        if (tags.includes("critical") || tags.includes("important")) {
+            return "critical";
+        }
+        if (tags.includes("decision") || tags.includes("error")) {
+            return "high";
+        }
+        if (tags.includes("task") || tags.includes("file")) {
+            return "medium";
+        }
+        return "low";
+    }
+    /**
+     * Estimate token count for a string (rough approximation)
+     */
+    estimateTokens(text) {
+        // Rough estimate: ~4 chars per token for English
+        return Math.ceil(text.length / 4);
+    }
+    /**
+     * Select items within token budget, prioritizing by importance
+     */
+    selectWithinBudget(items, maxTokens) {
+        // Sort by priority (critical first) then by recency
+        const priorityOrder = {
+            critical: 0,
+            high: 1,
+            medium: 2,
+            low: 3,
+        };
+        const sorted = [...items].sort((a, b) => {
+            const priorityDiff = priorityOrder[a.priority] - priorityOrder[b.priority];
+            if (priorityDiff !== 0) {
+                return priorityDiff;
+            }
+            // More recent first
+            return b.timestamp - a.timestamp;
+        });
+        // Select within budget
+        const selected = [];
+        let usedTokens = 0;
+        for (const item of sorted) {
+            if (usedTokens + item.tokenEstimate <= maxTokens) {
+                selected.push(item);
+                usedTokens += item.tokenEstimate;
+            }
+            else {
+                // Stop if we can't fit any more
+                break;
+            }
+        }
+        return selected;
+    }
+    /**
+     * Generate a summary of the injected context
+     */
+    generateSummary(items, projectPath) {
+        const counts = {
+            handoff: 0,
+            decision: 0,
+            memory: 0,
+            file: 0,
+        };
+        for (const item of items) {
+            counts[item.type]++;
+        }
+        const parts = [`Context for ${projectPath}:`];
+        if (counts.handoff > 0) {
+            parts.push("Previous session available");
+        }
+        if (counts.decision > 0) {
+            parts.push(`${counts.decision} decision(s)`);
+        }
+        if (counts.memory > 0) {
+            parts.push(`${counts.memory} memory item(s)`);
+        }
+        if (counts.file > 0) {
+            parts.push(`${counts.file} file(s)`);
+        }
+        return parts.join(", ");
+    }
+}
+//# sourceMappingURL=ContextInjector.js.map

package/dist/context/ContextInjector.js.map

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

package/dist/documentation/CodeAnalyzer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CodeAnalyzer - Processes code graph data from CODE-GRAPH-RAG-MCP
+ *
+ * Note: This class processes data that should be fetched from CODE-GRAPH-RAG-MCP
+ * The actual MCP calls should be made by the tool handler and passed to this analyzer
+ */
+import type { CodeData, RawEntity, RawHotspot, RawClone } from './types.js';
+export interface CodeGraphRagData {
+    entities?: RawEntity[];
+    hotspots?: RawHotspot[];
+    clones?: RawClone[];
+    graph?: Record<string, unknown>;
+}
+export declare class CodeAnalyzer {
+    /**
+     * Process code graph data from CODE-GRAPH-RAG-MCP
+     */
+    analyze(codeGraphData: CodeGraphRagData): Promise<CodeData>;
+    private parseEntities;
+    private normalizeEntityType;
+    private groupEntitiesByFile;
+    private parseHotspots;
+    private parseClones;
+    /**
+     * Extract file paths from code data for cross-referencing
+     */
+    extractFilePaths(codeData: CodeData): string[];
+}
+//# sourceMappingURL=CodeAnalyzer.d.ts.map

package/dist/documentation/CodeAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeAnalyzer.d.ts","sourceRoot":"","sources":["../../src/documentation/CodeAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EAKR,SAAS,EACT,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,qBAAa,YAAY;IACvB;;OAEG;IACG,OAAO,CAAC,aAAa,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBjE,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE;CAqB/C"}

package/dist/documentation/CodeAnalyzer.js

@@ -0,0 +1,122 @@
+/**
+ * CodeAnalyzer - Processes code graph data from CODE-GRAPH-RAG-MCP
+ *
+ * Note: This class processes data that should be fetched from CODE-GRAPH-RAG-MCP
+ * The actual MCP calls should be made by the tool handler and passed to this analyzer
+ */
+export class CodeAnalyzer {
+    /**
+     * Process code graph data from CODE-GRAPH-RAG-MCP
+     */
+    async analyze(codeGraphData) {
+        console.error('🔍 Processing codebase structure...');
+        const entities = this.parseEntities(codeGraphData.entities || []);
+        const files = this.groupEntitiesByFile(entities);
+        const hotspots = this.parseHotspots(codeGraphData.hotspots || []);
+        const clones = this.parseClones(codeGraphData.clones || []);
+        console.error(`  Found ${entities.length} entities in ${files.length} files`);
+        return {
+            entities,
+            relationships: [],
+            files,
+            hotspots,
+            clones
+        };
+    }
+    parseEntities(rawEntities) {
+        if (!Array.isArray(rawEntities)) {
+            return [];
+        }
+        return rawEntities.map(entity => ({
+            id: entity.id || entity.name || '',
+            name: entity.name || '',
+            type: this.normalizeEntityType(entity.type || ''),
+            filePath: entity.filePath || entity.file || '',
+            lineNumber: entity.lineNumber || entity.line,
+            complexity: entity.complexity,
+            description: entity.description
+        })).filter(e => e.id && e.name);
+    }
+    normalizeEntityType(type) {
+        const normalized = (type || '').toLowerCase();
+        if (normalized.includes('class')) {
+            return 'class';
+        }
+        if (normalized.includes('function') || normalized.includes('method')) {
+            return 'function';
+        }
+        if (normalized.includes('interface')) {
+            return 'interface';
+        }
+        if (normalized.includes('module')) {
+            return 'module';
+        }
+        if (normalized.includes('component')) {
+            return 'component';
+        }
+        return 'function';
+    }
+    groupEntitiesByFile(entities) {
+        const fileMap = new Map();
+        for (const entity of entities) {
+            if (!entity.filePath) {
+                continue;
+            }
+            if (!fileMap.has(entity.filePath)) {
+                fileMap.set(entity.filePath, []);
+            }
+            const fileEntities = fileMap.get(entity.filePath);
+            if (fileEntities) {
+                fileEntities.push(entity);
+            }
+        }
+        return Array.from(fileMap.entries()).map(([path, entities]) => ({
+            path,
+            size: 0, // Would need to read file to get actual size
+            entities
+        }));
+    }
+    parseHotspots(rawHotspots) {
+        if (!Array.isArray(rawHotspots)) {
+            return [];
+        }
+        return rawHotspots.map(h => ({
+            filePath: h.filePath || h.file || h.path || '',
+            complexity: h.complexity || h.score || 0,
+            changeCount: h.changeCount || h.changes || 0,
+            metric: h.metric || 'complexity'
+        })).filter(h => h.filePath);
+    }
+    parseClones(rawClones) {
+        if (!Array.isArray(rawClones)) {
+            return [];
+        }
+        return rawClones.map(c => ({
+            files: Array.isArray(c.files) ? c.files : [],
+            similarity: c.similarity || c.score || 0,
+            description: c.description || 'Code duplication detected'
+        })).filter(c => c.files.length >= 2);
+    }
+    /**
+     * Extract file paths from code data for cross-referencing
+     */
+    extractFilePaths(codeData) {
+        const paths = new Set();
+        for (const entity of codeData.entities) {
+            if (entity.filePath) {
+                paths.add(entity.filePath);
+            }
+        }
+        for (const file of codeData.files) {
+            paths.add(file.path);
+        }
+        for (const hotspot of codeData.hotspots) {
+            paths.add(hotspot.filePath);
+        }
+        for (const clone of codeData.clones) {
+            clone.files.forEach(f => paths.add(f));
+        }
+        return Array.from(paths);
+    }
+}
+//# sourceMappingURL=CodeAnalyzer.js.map

package/dist/documentation/CodeAnalyzer.js.map

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

package/dist/documentation/ConversationAnalyzer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ConversationAnalyzer - Queries conversation memory database
+ */
+import type { SQLiteManager } from '../storage/SQLiteManager.js';
+import type { ConversationData } from './types.js';
+export declare class ConversationAnalyzer {
+    private db;
+    constructor(db: SQLiteManager);
+    /**
+     * Analyze conversations for a project
+     */
+    analyze(projectPath: string, sessionId?: string): Promise<ConversationData>;
+    private getDecisions;
+    private getMistakes;
+    private getRequirements;
+    private getFileEdits;
+    private getGitCommits;
+}
+//# sourceMappingURL=ConversationAnalyzer.d.ts.map

package/dist/documentation/ConversationAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationAnalyzer.d.ts","sourceRoot":"","sources":["../../src/documentation/ConversationAnalyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAuD,MAAM,YAAY,CAAC;AAIxG,qBAAa,oBAAoB;IACnB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,aAAa;IAErC;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBjF,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,aAAa;CA4BtB"}

package/dist/documentation/ConversationAnalyzer.js

@@ -0,0 +1,157 @@
+/**
+ * ConversationAnalyzer - Queries conversation memory database
+ */
+import { safeJsonParse } from '../utils/safeJson.js';
+export class ConversationAnalyzer {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Analyze conversations for a project
+     */
+    async analyze(projectPath, sessionId) {
+        console.error('📊 Analyzing conversation history...');
+        const decisions = this.getDecisions(projectPath, sessionId);
+        const mistakes = this.getMistakes(projectPath, sessionId);
+        const requirements = this.getRequirements(projectPath, sessionId);
+        const fileEdits = this.getFileEdits(projectPath, sessionId);
+        const commits = this.getGitCommits(projectPath, sessionId);
+        console.error(`  Found ${decisions.length} decisions, ${mistakes.length} mistakes`);
+        return {
+            decisions,
+            mistakes,
+            requirements,
+            fileEdits,
+            commits
+        };
+    }
+    getDecisions(projectPath, sessionId) {
+        let sql = `
+      SELECT d.*
+      FROM decisions d
+      JOIN conversations c ON d.conversation_id = c.id
+      WHERE c.project_path = ?
+    `;
+        if (sessionId) {
+            sql += ' AND c.id = ?';
+        }
+        sql += ' ORDER BY d.timestamp DESC';
+        const stmt = this.db.getDatabase().prepare(sql);
+        const rows = sessionId
+            ? stmt.all(projectPath, sessionId)
+            : stmt.all(projectPath);
+        return rows.map((row) => ({
+            id: row.id,
+            conversation_id: row.conversation_id,
+            message_id: row.message_id,
+            decision_text: row.decision_text,
+            rationale: row.rationale || '',
+            alternatives_considered: safeJsonParse(row.alternatives_considered, []),
+            rejected_reasons: safeJsonParse(row.rejected_reasons, {}),
+            context: row.context,
+            related_files: safeJsonParse(row.related_files, []),
+            related_commits: safeJsonParse(row.related_commits, []),
+            timestamp: row.timestamp
+        }));
+    }
+    getMistakes(projectPath, sessionId) {
+        let sql = `
+      SELECT m.*
+      FROM mistakes m
+      JOIN conversations c ON m.conversation_id = c.id
+      WHERE c.project_path = ?
+    `;
+        if (sessionId) {
+            sql += ' AND c.id = ?';
+        }
+        sql += ' ORDER BY m.timestamp DESC';
+        const stmt = this.db.getDatabase().prepare(sql);
+        const rows = sessionId
+            ? stmt.all(projectPath, sessionId)
+            : stmt.all(projectPath);
+        return rows.map((row) => ({
+            id: row.id,
+            conversation_id: row.conversation_id,
+            what_went_wrong: row.what_went_wrong,
+            why_it_happened: '',
+            how_it_was_fixed: row.correction || '',
+            lesson_learned: row.user_correction_message || '',
+            related_files: safeJsonParse(row.files_affected, []),
+            severity: row.mistake_type || 'general',
+            timestamp: row.timestamp
+        }));
+    }
+    getRequirements(projectPath, sessionId) {
+        let sql = `
+      SELECT r.*
+      FROM requirements r
+      JOIN conversations c ON r.conversation_id = c.id
+      WHERE c.project_path = ?
+    `;
+        if (sessionId) {
+            sql += ' AND c.id = ?';
+        }
+        sql += ' ORDER BY r.timestamp DESC';
+        const stmt = this.db.getDatabase().prepare(sql);
+        const rows = sessionId
+            ? stmt.all(projectPath, sessionId)
+            : stmt.all(projectPath);
+        return rows.map((row) => ({
+            id: row.id,
+            requirement_type: row.type,
+            description: row.description,
+            rationale: row.rationale || '',
+            related_files: safeJsonParse(row.affects_components, []),
+            timestamp: row.timestamp
+        }));
+    }
+    getFileEdits(projectPath, sessionId) {
+        let sql = `
+      SELECT fe.*
+      FROM file_edits fe
+      JOIN conversations c ON fe.conversation_id = c.id
+      WHERE c.project_path = ?
+    `;
+        if (sessionId) {
+            sql += ' AND c.id = ?';
+        }
+        sql += ' ORDER BY fe.snapshot_timestamp DESC LIMIT 1000';
+        const stmt = this.db.getDatabase().prepare(sql);
+        const rows = sessionId
+            ? stmt.all(projectPath, sessionId)
+            : stmt.all(projectPath);
+        return rows.map((row) => ({
+            id: row.id,
+            conversation_id: row.conversation_id,
+            file_path: row.file_path,
+            edit_type: 'backup', // All file_edits are backups based on schema
+            timestamp: row.snapshot_timestamp
+        }));
+    }
+    getGitCommits(projectPath, sessionId) {
+        let sql = `
+      SELECT gc.*
+      FROM git_commits gc
+      JOIN conversations c ON gc.conversation_id = c.id
+      WHERE c.project_path = ?
+    `;
+        if (sessionId) {
+            sql += ' AND c.id = ?';
+        }
+        sql += ' ORDER BY gc.timestamp DESC LIMIT 500';
+        const stmt = this.db.getDatabase().prepare(sql);
+        const rows = sessionId
+            ? stmt.all(projectPath, sessionId)
+            : stmt.all(projectPath);
+        return rows.map((row) => ({
+            hash: row.hash,
+            conversation_id: row.conversation_id || '',
+            message: row.message,
+            author: row.author || 'Unknown',
+            timestamp: row.timestamp,
+            files_changed: safeJsonParse(row.files_changed, [])
+        }));
+    }
+}
+//# sourceMappingURL=ConversationAnalyzer.js.map

package/dist/documentation/ConversationAnalyzer.js.map

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

package/dist/documentation/CrossReferencer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * CrossReferencer - Links code entities with conversation data
+ */
+import type { CodeData, ConversationData, LinkedData } from './types.js';
+export declare class CrossReferencer {
+    /**
+     * Link code and conversation data
+     */
+    link(codeData: CodeData, conversationData: ConversationData): Promise<LinkedData>;
+    /**
+     * Group files into logical modules and link with conversation data
+     */
+    private groupIntoModules;
+    /**
+     * Extract module path from file path (e.g., src/auth/token.ts → src/auth)
+     */
+    private extractModulePath;
+    /**
+     * Convert path to human-readable module name
+     */
+    private pathToModuleName;
+    /**
+     * Find decisions related to a module
+     */
+    private findRelatedDecisions;
+    /**
+     * Find mistakes related to a module
+     */
+    private findRelatedMistakes;
+    /**
+     * Find requirements related to a module
+     */
+    private findRelatedRequirements;
+    /**
+     * Check if two paths are related (flexible matching)
+     */
+    private isRelatedPath;
+    /**
+     * Calculate module complexity
+     */
+    private calculateModuleComplexity;
+    /**
+     * Calculate how frequently a module changes
+     */
+    private calculateChangeFrequency;
+    /**
+     * Extract module description from decisions and requirements
+     */
+    private extractModuleDescription;
+    /**
+     * Build chronological timeline of events
+     */
+    private buildTimeline;
+    /**
+     * Build quality report with context
+     */
+    private buildQualityReport;
+    /**
+     * Summarize mistakes for learning
+     */
+    private summarizeMistakes;
+    /**
+     * Calculate overall statistics
+     */
+    private calculateStatistics;
+}
+//# sourceMappingURL=CrossReferencer.d.ts.map