cccmemory 1.8.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"CrossReferencer.d.ts","sourceRoot":"","sources":["../../src/documentation/CrossReferencer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,EAaX,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBvF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0CxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAiBjC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAIhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,aAAa;IAwCrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAgB5B"}

package/dist/documentation/CrossReferencer.js

@@ -0,0 +1,247 @@
+/**
+ * CrossReferencer - Links code entities with conversation data
+ */
+import { basename, dirname } from 'path';
+export class CrossReferencer {
+    /**
+     * Link code and conversation data
+     */
+    async link(codeData, conversationData) {
+        console.error('🔗 Cross-referencing code and conversations...');
+        const modules = this.groupIntoModules(codeData, conversationData);
+        const timeline = this.buildTimeline(conversationData);
+        const qualityReport = this.buildQualityReport(codeData, conversationData);
+        const statistics = this.calculateStatistics(codeData, conversationData);
+        console.error(`  Created ${modules.length} module summaries`);
+        return {
+            modules,
+            timeline,
+            qualityReport,
+            statistics
+        };
+    }
+    /**
+     * Group files into logical modules and link with conversation data
+     */
+    groupIntoModules(codeData, conversationData) {
+        // Group files by directory
+        const moduleMap = new Map();
+        for (const file of codeData.files) {
+            const modulePath = this.extractModulePath(file.path);
+            const moduleName = this.pathToModuleName(modulePath);
+            if (!moduleMap.has(modulePath)) {
+                moduleMap.set(modulePath, {
+                    path: modulePath,
+                    name: moduleName,
+                    entities: [],
+                    decisions: [],
+                    mistakes: [],
+                    requirements: [],
+                    complexity: 0,
+                    changeFrequency: 0,
+                    description: undefined
+                });
+            }
+            const module = moduleMap.get(modulePath);
+            if (module) {
+                module.entities.push(...file.entities);
+            }
+        }
+        // Link decisions, mistakes, and requirements to modules
+        for (const module of moduleMap.values()) {
+            module.decisions = this.findRelatedDecisions(module.path, conversationData.decisions);
+            module.mistakes = this.findRelatedMistakes(module.path, conversationData.mistakes);
+            module.requirements = this.findRelatedRequirements(module.path, conversationData.requirements);
+            module.complexity = this.calculateModuleComplexity(module.entities, codeData.hotspots);
+            module.changeFrequency = this.calculateChangeFrequency(module.path, conversationData.fileEdits);
+            module.description = this.extractModuleDescription(module.decisions, module.requirements);
+        }
+        return Array.from(moduleMap.values())
+            .sort((a, b) => b.decisions.length + b.mistakes.length - (a.decisions.length + a.mistakes.length));
+    }
+    /**
+     * Extract module path from file path (e.g., src/auth/token.ts → src/auth)
+     */
+    extractModulePath(filePath) {
+        const dir = dirname(filePath);
+        // If it's a top-level file, use the filename without extension
+        if (dir === '.' || dir === 'src') {
+            return basename(filePath, '.ts').replace(/\./g, '/');
+        }
+        return dir;
+    }
+    /**
+     * Convert path to human-readable module name
+     */
+    pathToModuleName(path) {
+        const parts = path.split('/');
+        const lastPart = parts[parts.length - 1];
+        // Convert snake_case or kebab-case to Title Case
+        return lastPart
+            .split(/[-_]/)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    /**
+     * Find decisions related to a module
+     */
+    findRelatedDecisions(modulePath, decisions) {
+        return decisions.filter(decision => decision.related_files.some((file) => file.startsWith(modulePath) || this.isRelatedPath(file, modulePath)));
+    }
+    /**
+     * Find mistakes related to a module
+     */
+    findRelatedMistakes(modulePath, mistakes) {
+        return mistakes.filter(mistake => mistake.related_files.some((file) => file.startsWith(modulePath) || this.isRelatedPath(file, modulePath)));
+    }
+    /**
+     * Find requirements related to a module
+     */
+    findRelatedRequirements(modulePath, requirements) {
+        return requirements.filter(req => req.related_files.some((file) => file.startsWith(modulePath) || this.isRelatedPath(file, modulePath)));
+    }
+    /**
+     * Check if two paths are related (flexible matching)
+     */
+    isRelatedPath(filePath, modulePath) {
+        return filePath.includes(modulePath) || modulePath.includes(filePath);
+    }
+    /**
+     * Calculate module complexity
+     */
+    calculateModuleComplexity(entities, hotspots) {
+        if (entities.length === 0) {
+            return 0;
+        }
+        const entityComplexity = entities
+            .filter(e => e.complexity)
+            .reduce((sum, e) => sum + (e.complexity || 0), 0);
+        const hotspotComplexity = hotspots
+            .filter(h => entities.some(e => e.filePath === h.filePath))
+            .reduce((sum, h) => sum + h.complexity, 0);
+        const avgComplexity = (entityComplexity + hotspotComplexity) / (entities.length || 1);
+        return Math.min(10, Math.round(avgComplexity));
+    }
+    /**
+     * Calculate how frequently a module changes
+     */
+    calculateChangeFrequency(modulePath, fileEdits) {
+        return fileEdits.filter(edit => edit.file_path.startsWith(modulePath)).length;
+    }
+    /**
+     * Extract module description from decisions and requirements
+     */
+    extractModuleDescription(decisions, requirements) {
+        // Use the first decision's context or rationale as description
+        if (decisions.length > 0 && decisions[0].context) {
+            return decisions[0].context;
+        }
+        if (decisions.length > 0 && decisions[0].rationale) {
+            return decisions[0].rationale;
+        }
+        if (requirements.length > 0) {
+            return requirements[0].description;
+        }
+        return undefined;
+    }
+    /**
+     * Build chronological timeline of events
+     */
+    buildTimeline(conversationData) {
+        const events = [];
+        // Add decisions
+        for (const decision of conversationData.decisions) {
+            events.push({
+                timestamp: decision.timestamp,
+                type: 'decision',
+                description: decision.decision_text,
+                files: decision.related_files,
+                details: decision
+            });
+        }
+        // Add mistakes
+        for (const mistake of conversationData.mistakes) {
+            events.push({
+                timestamp: mistake.timestamp,
+                type: 'mistake',
+                description: mistake.what_went_wrong,
+                files: mistake.related_files,
+                details: mistake
+            });
+        }
+        // Add commits
+        for (const commit of conversationData.commits) {
+            events.push({
+                timestamp: commit.timestamp,
+                type: 'commit',
+                description: commit.message,
+                files: commit.files_changed,
+                details: commit
+            });
+        }
+        // Sort by timestamp (newest first)
+        return events.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Build quality report with context
+     */
+    buildQualityReport(codeData, conversationData) {
+        const hotspotsWithContext = codeData.hotspots.map(hotspot => ({
+            ...hotspot,
+            relatedMistakes: conversationData.mistakes.filter(m => m.related_files.some(f => f === hotspot.filePath)),
+            relatedDecisions: conversationData.decisions.filter(d => d.related_files.some(f => f === hotspot.filePath))
+        }));
+        const mistakeSummary = this.summarizeMistakes(conversationData.mistakes);
+        return {
+            hotspots: hotspotsWithContext,
+            clones: codeData.clones,
+            mistakeSummary
+        };
+    }
+    /**
+     * Summarize mistakes for learning
+     */
+    summarizeMistakes(mistakes) {
+        const byCategory = {};
+        const topLessons = [];
+        const criticalIssues = [];
+        for (const mistake of mistakes) {
+            // Categorize by severity
+            const category = mistake.severity || 'medium';
+            byCategory[category] = (byCategory[category] || 0) + 1;
+            // Collect lessons
+            if (mistake.lesson_learned && !topLessons.includes(mistake.lesson_learned)) {
+                topLessons.push(mistake.lesson_learned);
+            }
+            // Identify critical issues
+            if (mistake.severity === 'critical' || mistake.severity === 'high') {
+                criticalIssues.push(mistake);
+            }
+        }
+        return {
+            total: mistakes.length,
+            byCategory,
+            topLessons: topLessons.slice(0, 10), // Top 10 lessons
+            criticalIssues
+        };
+    }
+    /**
+     * Calculate overall statistics
+     */
+    calculateStatistics(codeData, conversationData) {
+        const totalComplexity = codeData.entities
+            .filter(e => e.complexity)
+            .reduce((sum, e) => sum + (e.complexity || 0), 0);
+        return {
+            totalFiles: codeData.files.length,
+            totalEntities: codeData.entities.length,
+            totalDecisions: conversationData.decisions.length,
+            totalMistakes: conversationData.mistakes.length,
+            totalCommits: conversationData.commits.length,
+            averageComplexity: codeData.entities.length > 0
+                ? Math.round((totalComplexity / codeData.entities.length) * 10) / 10
+                : 0
+        };
+    }
+}
+//# sourceMappingURL=CrossReferencer.js.map

package/dist/documentation/CrossReferencer.js.map

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

package/dist/documentation/DocumentationGenerator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DocumentationGenerator - Main orchestrator for comprehensive documentation
+ */
+import { type CodeGraphRagData } from './CodeAnalyzer.js';
+import type { SQLiteManager } from '../storage/SQLiteManager.js';
+import type { DocumentationOptions } from './types.js';
+export declare class DocumentationGenerator {
+    private codeAnalyzer;
+    private conversationAnalyzer;
+    private crossReferencer;
+    private formatter;
+    constructor(db: SQLiteManager);
+    /**
+     * Generate comprehensive documentation
+     *
+     * @param options - Documentation options
+     * @param codeGraphData - Data from CODE-GRAPH-RAG-MCP (must be fetched externally)
+     * @returns Markdown documentation
+     */
+    generate(options: DocumentationOptions, codeGraphData: CodeGraphRagData): Promise<string>;
+}
+//# sourceMappingURL=DocumentationGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentationGenerator.d.ts","sourceRoot":"","sources":["../../src/documentation/DocumentationGenerator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,SAAS,CAAoB;gBAEzB,EAAE,EAAE,aAAa;IAO7B;;;;;;OAMG;IACG,QAAQ,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;CAuChG"}

package/dist/documentation/DocumentationGenerator.js

@@ -0,0 +1,57 @@
+/**
+ * DocumentationGenerator - Main orchestrator for comprehensive documentation
+ */
+import { CodeAnalyzer } from './CodeAnalyzer.js';
+import { ConversationAnalyzer } from './ConversationAnalyzer.js';
+import { CrossReferencer } from './CrossReferencer.js';
+import { MarkdownFormatter } from './MarkdownFormatter.js';
+export class DocumentationGenerator {
+    codeAnalyzer;
+    conversationAnalyzer;
+    crossReferencer;
+    formatter;
+    constructor(db) {
+        this.codeAnalyzer = new CodeAnalyzer();
+        this.conversationAnalyzer = new ConversationAnalyzer(db);
+        this.crossReferencer = new CrossReferencer();
+        this.formatter = new MarkdownFormatter();
+    }
+    /**
+     * Generate comprehensive documentation
+     *
+     * @param options - Documentation options
+     * @param codeGraphData - Data from CODE-GRAPH-RAG-MCP (must be fetched externally)
+     * @returns Markdown documentation
+     */
+    async generate(options, codeGraphData) {
+        console.error('\n📚 Generating Comprehensive Documentation');
+        console.error(`Project: ${options.projectPath}`);
+        console.error(`Scope: ${options.scope}`);
+        if (options.sessionId) {
+            console.error(`Session: ${options.sessionId}`);
+        }
+        if (options.moduleFilter) {
+            console.error(`Filter: ${options.moduleFilter}`);
+        }
+        try {
+            // Step 1: Analyze code structure
+            const codeData = await this.codeAnalyzer.analyze(codeGraphData);
+            // Step 2: Analyze conversation history
+            const conversationData = await this.conversationAnalyzer.analyze(options.projectPath, options.sessionId);
+            // Step 3: Cross-reference code and conversations
+            const linkedData = await this.crossReferencer.link(codeData, conversationData);
+            // Step 4: Format as markdown
+            const documentation = this.formatter.format(linkedData, options);
+            console.error('✅ Documentation generated successfully');
+            console.error(`   Modules: ${linkedData.modules.length}`);
+            console.error(`   Decisions: ${linkedData.statistics.totalDecisions}`);
+            console.error(`   Mistakes: ${linkedData.statistics.totalMistakes}`);
+            return documentation;
+        }
+        catch (error) {
+            console.error('❌ Error generating documentation:', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=DocumentationGenerator.js.map

package/dist/documentation/DocumentationGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentationGenerator.js","sourceRoot":"","sources":["../../src/documentation/DocumentationGenerator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAyB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAI3D,MAAM,OAAO,sBAAsB;IACzB,YAAY,CAAe;IAC3B,oBAAoB,CAAuB;IAC3C,eAAe,CAAkB;IACjC,SAAS,CAAoB;IAErC,YAAY,EAAiB;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA6B,EAAE,aAA+B;QAC3E,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC;YACH,iCAAiC;YACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAEhE,uCAAuC;YACvC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAC9D,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,SAAS,CAClB,CAAC;YAEF,iDAAiD;YACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YAE/E,6BAA6B;YAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAEjE,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,iBAAiB,UAAU,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,gBAAgB,UAAU,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;YAErE,OAAO,aAAa,CAAC;QAEvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/documentation/MarkdownFormatter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MarkdownFormatter - Generates comprehensive markdown documentation
+ */
+import type { LinkedData, DocumentationOptions } from './types.js';
+export declare class MarkdownFormatter {
+    /**
+     * Format linked data as markdown
+     */
+    format(data: LinkedData, options: DocumentationOptions): string;
+    private renderHeader;
+    private renderStatistics;
+    private renderArchitecture;
+    private renderModule;
+    private renderModuleDecisions;
+    private renderModuleMistakes;
+    private renderModuleRequirements;
+    private renderModuleEntities;
+    private renderDecisions;
+    private renderQuality;
+    private renderTimeline;
+    private renderTimelineEvent;
+    private renderFooter;
+    private formatDate;
+    private formatMonth;
+}
+//# sourceMappingURL=MarkdownFormatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownFormatter.d.ts","sourceRoot":"","sources":["../../src/documentation/MarkdownFormatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EAGV,oBAAoB,EAOrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM;IA6B/D,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW;CAMpB"}