doc-freshness-checker 1.0.0

package/dist/parsers/extractors/versionExtractor.test.js.map

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

package/dist/plugins/plugin.d.ts

@@ -0,0 +1,32 @@
+import type { BaseExtractor, BaseValidator, DocFreshnessConfig, Document, ValidationResults } from '../types.js';
+/**
+ * Plugin interface for extending doc-freshness functionality
+ */
+export declare class Plugin {
+    name: string;
+    constructor(name: string);
+    /**
+     * Called when the plugin is registered
+     */
+    initialize(_config: DocFreshnessConfig): Promise<void>;
+    /**
+     * Return custom extractors
+     */
+    getExtractors(): BaseExtractor[];
+    /**
+     * Return custom validators
+     */
+    getValidators(): Record<string, BaseValidator>;
+    /**
+     * Return custom reporters
+     */
+    getReporters(): Record<string, unknown>;
+    /**
+     * Called before validation starts
+     */
+    beforeValidation(_documents: Document[]): Promise<void>;
+    /**
+     * Called after validation completes
+     */
+    afterValidation(_results: ValidationResults): Promise<void>;
+}

package/dist/plugins/plugin.js

@@ -0,0 +1,40 @@
+/**
+ * Plugin interface for extending doc-freshness functionality
+ */
+export class Plugin {
+    name;
+    constructor(name) {
+        this.name = name;
+    }
+    /**
+     * Called when the plugin is registered
+     */
+    async initialize(_config) { }
+    /**
+     * Return custom extractors
+     */
+    getExtractors() {
+        return [];
+    }
+    /**
+     * Return custom validators
+     */
+    getValidators() {
+        return {};
+    }
+    /**
+     * Return custom reporters
+     */
+    getReporters() {
+        return {};
+    }
+    /**
+     * Called before validation starts
+     */
+    async beforeValidation(_documents) { }
+    /**
+     * Called after validation completes
+     */
+    async afterValidation(_results) { }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugins/plugin.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,MAAM;IACjB,IAAI,CAAS;IAEb,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAA2B,IAAkB,CAAC;IAE/D;;OAEG;IACH,aAAa;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,UAAsB,IAAkB,CAAC;IAEhE;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAA2B,IAAkB,CAAC;CACrE"}

package/dist/plugins/plugin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/plugins/plugin.test.js

@@ -0,0 +1,23 @@
+import { Plugin } from './plugin.js';
+describe('Plugin', () => {
+    it('has a name', () => {
+        const plugin = new Plugin('test-plugin');
+        expect(plugin.name).toBe('test-plugin');
+    });
+    it('returns empty arrays/objects from default methods', () => {
+        const plugin = new Plugin('test');
+        expect(plugin.getExtractors()).toEqual([]);
+        expect(plugin.getValidators()).toEqual({});
+        expect(plugin.getReporters()).toEqual({});
+    });
+    it('lifecycle hooks resolve without error', async () => {
+        const plugin = new Plugin('test');
+        await expect(plugin.initialize({})).resolves.not.toThrow();
+        await expect(plugin.beforeValidation([])).resolves.not.toThrow();
+        await expect(plugin.afterValidation({
+            documents: [],
+            summary: { total: 0, valid: 0, errors: 0, warnings: 0, skipped: 0 },
+        })).resolves.not.toThrow();
+    });
+});
+//# sourceMappingURL=plugin.test.js.map

package/dist/plugins/plugin.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.js","sourceRoot":"","sources":["../../src/plugins/plugin.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;QACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjE,MAAM,MAAM,CACV,MAAM,CAAC,eAAe,CAAC;YACrB,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;SACpE,CAAC,CACH,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/reporters/consoleReporter.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectScores, ValidationResults } from '../types.js';
+/**
+ * Console reporter for terminal output
+ */
+export declare class ConsoleReporter {
+    generate(results: ValidationResults): void;
+    /**
+     * Generate with freshness scores
+     */
+    generateWithScores(results: ValidationResults, freshnessScores: ProjectScores | null): void;
+    /**
+     * Generate vector mismatch report
+     */
+    private generateVectorMismatches;
+}

package/dist/reporters/consoleReporter.js

@@ -0,0 +1,73 @@
+/**
+ * Console reporter for terminal output
+ */
+export class ConsoleReporter {
+    generate(results) {
+        const { summary, documents } = results;
+        console.log('\n📚 Documentation Freshness Report\n');
+        console.log('━'.repeat(50));
+        console.log(`\n📊 Summary:`);
+        console.log(`   Total references checked: ${summary.total}`);
+        console.log(`   ✅ Valid: ${summary.valid}`);
+        console.log(`   ❌ Errors: ${summary.errors}`);
+        console.log(`   ⚠️  Warnings: ${summary.warnings}`);
+        console.log(`   ⏭️  Skipped: ${summary.skipped}`);
+        if (documents.length === 0) {
+            console.log('\n✨ All documentation is up to date!\n');
+            return;
+        }
+        console.log('\n📋 Issues by Document:\n');
+        for (const doc of documents) {
+            console.log(`\n📄 ${doc.path}`);
+            console.log('─'.repeat(40));
+            for (const issue of doc.issues) {
+                const icon = issue.severity === 'error' ? '❌' : '⚠️';
+                const ref = issue.reference;
+                console.log(`  ${icon} Line ${ref.lineNumber}: ${issue.message}`);
+                if (issue.suggestion) {
+                    console.log(`     💡 ${issue.suggestion}`);
+                }
+            }
+        }
+        console.log('\n');
+    }
+    /**
+     * Generate with freshness scores
+     */
+    generateWithScores(results, freshnessScores) {
+        this.generate(results);
+        if (freshnessScores) {
+            console.log('📊 Freshness Scores:\n');
+            console.log(`   Project Score: ${freshnessScores.projectScore}/100 (Grade: ${freshnessScores.projectGrade})\n`);
+            console.log('   By Document:');
+            for (const doc of freshnessScores.documents) {
+                const grade = doc.grade;
+                const icon = grade === 'A' ? '🟢' : grade === 'B' ? '🟡' : grade === 'C' ? '🟠' : '🔴';
+                console.log(`   ${icon} ${doc.document}: ${doc.totalScore}/100 (${grade})`);
+            }
+            console.log('');
+        }
+        // Show vector mismatches if present
+        if (results.vectorMismatches && results.vectorMismatches.length > 0) {
+            this.generateVectorMismatches(results.vectorMismatches);
+        }
+    }
+    /**
+     * Generate vector mismatch report
+     */
+    generateVectorMismatches(mismatches) {
+        console.log('🔍 Semantic Analysis (Vector Search):\n');
+        console.log(`   Found ${mismatches.length} potential documentation-code mismatches:\n`);
+        for (const mismatch of mismatches) {
+            console.log(`   ⚠️  ${mismatch.docPath}`);
+            console.log(`      Section: "${mismatch.docSection}"`);
+            console.log(`      Similarity: ${(mismatch.bestMatchScore * 100).toFixed(1)}%`);
+            if (mismatch.bestMatch) {
+                console.log(`      Best match: ${mismatch.bestMatch.path} (${mismatch.bestMatch.symbol})`);
+            }
+            console.log(`      💡 ${mismatch.suggestion}`);
+            console.log('');
+        }
+    }
+}
+//# sourceMappingURL=consoleReporter.js.map

package/dist/reporters/consoleReporter.js.map

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

package/dist/reporters/consoleReporter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/reporters/consoleReporter.test.js

@@ -0,0 +1,155 @@
+import { ConsoleReporter } from './consoleReporter.js';
+import { captureConsoleLog } from '../test-utils/console.js';
+describe('ConsoleReporter', () => {
+    const reporter = new ConsoleReporter();
+    const cleanResults = {
+        documents: [],
+        summary: { total: 5, valid: 5, errors: 0, warnings: 0, skipped: 0 },
+    };
+    const resultsWithIssues = {
+        documents: [
+            {
+                path: 'docs/api.md',
+                issues: [
+                    {
+                        reference: { type: 'file-path', value: 'missing.ts', lineNumber: 10, raw: 'missing.ts', sourceFile: 'api.md' },
+                        valid: false,
+                        severity: 'error',
+                        message: 'File not found: missing.ts',
+                        suggestion: 'Did you mean: missing.tsx?',
+                    },
+                    {
+                        reference: { type: 'external-url', value: 'https://old.com', lineNumber: 20, raw: 'https://old.com', sourceFile: 'api.md' },
+                        valid: false,
+                        severity: 'warning',
+                        message: 'URL returned 404',
+                    },
+                ],
+            },
+        ],
+        summary: { total: 5, valid: 3, errors: 1, warnings: 1, skipped: 0 },
+    };
+    it('generate() logs summary and "up to date" for clean results', () => {
+        const spy = captureConsoleLog();
+        reporter.generate(cleanResults);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('Valid: 5');
+        expect(output).toContain('up to date');
+    });
+    it('generate() logs issues with error and warning icons', () => {
+        const spy = captureConsoleLog();
+        reporter.generate(resultsWithIssues);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('File not found');
+        expect(output).toContain('missing.tsx');
+        expect(output).toContain('URL returned 404');
+        expect(output).toContain('Line 10');
+        expect(output).toContain('Line 20');
+    });
+    it('generateWithScores() includes freshness scores', () => {
+        const spy = captureConsoleLog();
+        const scores = {
+            projectScore: 85,
+            projectGrade: 'B',
+            documents: [
+                {
+                    document: 'docs/api.md',
+                    totalScore: 85,
+                    factors: { referenceValidity: 100, gitTimeDelta: 75, codeChangeFrequency: 75, symbolCoverage: 80 },
+                    grade: 'B',
+                },
+            ],
+            summary: { total: 1, gradeA: 0, gradeB: 1, gradeC: 0, gradeD: 0, gradeF: 0 },
+        };
+        reporter.generateWithScores(cleanResults, scores);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('85/100');
+        expect(output).toContain('Grade: B');
+    });
+    it('generateWithScores() with null scores skips scores section', () => {
+        const spy = captureConsoleLog();
+        reporter.generateWithScores(cleanResults, null);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).not.toContain('Freshness Scores');
+    });
+    it('generateWithScores() shows all grade icons', () => {
+        const spy = captureConsoleLog();
+        const scores = {
+            projectScore: 70,
+            projectGrade: 'C',
+            documents: [
+                {
+                    document: 'a.md',
+                    totalScore: 95,
+                    factors: { referenceValidity: 100, gitTimeDelta: 90, codeChangeFrequency: 90, symbolCoverage: 90 },
+                    grade: 'A',
+                },
+                {
+                    document: 'b.md',
+                    totalScore: 85,
+                    factors: { referenceValidity: 90, gitTimeDelta: 80, codeChangeFrequency: 80, symbolCoverage: 80 },
+                    grade: 'B',
+                },
+                {
+                    document: 'c.md',
+                    totalScore: 75,
+                    factors: { referenceValidity: 80, gitTimeDelta: 70, codeChangeFrequency: 70, symbolCoverage: 70 },
+                    grade: 'C',
+                },
+                {
+                    document: 'd.md',
+                    totalScore: 50,
+                    factors: { referenceValidity: 50, gitTimeDelta: 50, codeChangeFrequency: 50, symbolCoverage: 50 },
+                    grade: 'F',
+                },
+            ],
+            summary: { total: 4, gradeA: 1, gradeB: 1, gradeC: 1, gradeD: 0, gradeF: 1 },
+        };
+        reporter.generateWithScores(cleanResults, scores);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('🟢');
+        expect(output).toContain('🟡');
+        expect(output).toContain('🟠');
+        expect(output).toContain('🔴');
+    });
+    it('generateWithScores() shows vector mismatches when present', () => {
+        const spy = captureConsoleLog();
+        const mismatches = [
+            {
+                docPath: 'docs/api.md',
+                docSection: 'Auth API',
+                docText: 'This function handles auth',
+                bestMatchScore: 0.2,
+                bestMatch: { type: 'code', path: 'src/db.ts', symbol: 'dbConnect', text: 'DB connect' },
+                suggestion: 'Documentation may describe functionality not found in code',
+            },
+        ];
+        const results = { ...cleanResults, vectorMismatches: mismatches };
+        reporter.generateWithScores(results, null);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('Semantic Analysis');
+        expect(output).toContain('docs/api.md');
+        expect(output).toContain('Auth API');
+        expect(output).toContain('src/db.ts');
+        expect(output).toContain('20.0%');
+    });
+    it('generateVectorMismatches handles mismatches without bestMatch', () => {
+        const spy = captureConsoleLog();
+        const mismatches = [
+            {
+                docPath: 'docs/guide.md',
+                docSection: 'Setup',
+                docText: 'Setup instructions',
+                bestMatchScore: 0,
+                bestMatch: null,
+                suggestion: 'No matching code found',
+            },
+        ];
+        const results = { ...cleanResults, vectorMismatches: mismatches };
+        reporter.generateWithScores(results, null);
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('docs/guide.md');
+        expect(output).not.toContain('Best match:');
+    });
+});
+//# sourceMappingURL=consoleReporter.test.js.map

package/dist/reporters/consoleReporter.test.js.map

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

package/dist/reporters/enhancedReporter.d.ts

@@ -0,0 +1,12 @@
+import type { ProjectScores, ValidationResults } from '../types.js';
+import type { CodeDocGraph } from '../graph/codeDocGraph.js';
+import type { GitChangeTracker } from '../git/changeTracker.js';
+/**
+ * Enhanced reporter with DeepDocs-style output
+ */
+export declare class EnhancedReporter {
+    /**
+     * Generate a DeepDocs-style scan report
+     */
+    generateScanReport(results: ValidationResults, graph: CodeDocGraph | null, gitTracker: GitChangeTracker | null, freshnessScores: ProjectScores | null): string;
+}

package/dist/reporters/enhancedReporter.js

@@ -0,0 +1,81 @@
+/**
+ * Enhanced reporter with DeepDocs-style output
+ */
+export class EnhancedReporter {
+    /**
+     * Generate a DeepDocs-style scan report
+     */
+    generateScanReport(results, graph, gitTracker, freshnessScores) {
+        let report = '';
+        report += '# 📚 Documentation Freshness Scan Report\n\n';
+        report += `**Generated:** ${new Date().toISOString()}\n\n`;
+        // Project Score
+        if (freshnessScores) {
+            report += `## 📊 Project Freshness Score: ${freshnessScores.projectScore}/100 `;
+            report += `(Grade: ${freshnessScores.projectGrade})\n\n`;
+            report += '| Grade | Count |\n|-------|-------|\n';
+            report += `| A (90-100) | ${freshnessScores.summary.gradeA} |\n`;
+            report += `| B (80-89)  | ${freshnessScores.summary.gradeB} |\n`;
+            report += `| C (70-79)  | ${freshnessScores.summary.gradeC} |\n`;
+            report += `| D (60-69)  | ${freshnessScores.summary.gradeD} |\n`;
+            report += `| F (0-59)   | ${freshnessScores.summary.gradeF} |\n\n`;
+        }
+        // Validation Summary
+        report += '## ✅ Validation Summary\n\n';
+        report += `- **Total References:** ${results.summary.total}\n`;
+        report += `- **Valid:** ${results.summary.valid}\n`;
+        report += `- **Errors:** ${results.summary.errors}\n`;
+        report += `- **Warnings:** ${results.summary.warnings}\n\n`;
+        // Affected Documents (DeepDocs-style)
+        if (results.documents.length > 0) {
+            report += '## 📋 Affected Documents\n\n';
+            for (const doc of results.documents) {
+                const score = freshnessScores?.documents.find((d) => d.document === doc.path);
+                const scoreStr = score ? ` (Score: ${score.totalScore}, Grade: ${score.grade})` : '';
+                report += `### 📄 \`${doc.path}\`${scoreStr}\n\n`;
+                // Show referenced code files
+                const codeFiles = graph?.getCodeReferencedByDoc(doc.path);
+                if (codeFiles && codeFiles.size > 0) {
+                    report += '**Referenced Code Files:**\n';
+                    for (const codeFile of codeFiles) {
+                        const commitInfo = gitTracker?.getFileCommitInfo(codeFile);
+                        const commitStr = commitInfo ? ` (last modified: ${new Date(commitInfo.timestamp).toLocaleDateString()})` : '';
+                        report += `- \`${codeFile}\`${commitStr}\n`;
+                    }
+                    report += '\n';
+                }
+                // Issues table
+                report += '| Line | Type | Issue | Suggestion |\n';
+                report += '|------|------|-------|------------|\n';
+                for (const issue of doc.issues) {
+                    const severity = issue.severity === 'error' ? '❌' : '⚠️';
+                    const suggestion = issue.suggestion || '-';
+                    const message = (issue.message || '').replace(/\|/g, '\\|');
+                    report += `| ${issue.reference.lineNumber} | ${severity} ${issue.reference.type} | ${message} | ${suggestion} |\n`;
+                }
+                report += '\n';
+            }
+        }
+        // Code Change Impact (if git available)
+        if (gitTracker?.isGitRepo() && graph) {
+            try {
+                const recentChanges = gitTracker.getChangedFilesSince(Date.now() - 7 * 24 * 60 * 60 * 1000 // Last 7 days
+                );
+                const impactedDocs = gitTracker.getAffectedDocs(graph, recentChanges);
+                if (impactedDocs.length > 0) {
+                    report += '## 🔄 Recent Code Changes Impacting Docs\n\n';
+                    report += 'The following documents reference code that changed in the last 7 days:\n\n';
+                    for (const docPath of impactedDocs) {
+                        report += `- \`${docPath}\`\n`;
+                    }
+                    report += '\n';
+                }
+            }
+            catch {
+                // Git operations failed
+            }
+        }
+        return report;
+    }
+}
+//# sourceMappingURL=enhancedReporter.js.map

package/dist/reporters/enhancedReporter.js.map

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

package/dist/reporters/enhancedReporter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/reporters/enhancedReporter.test.js

@@ -0,0 +1,152 @@
+import { EnhancedReporter } from './enhancedReporter.js';
+import { CodeDocGraph } from '../graph/codeDocGraph.js';
+describe('EnhancedReporter', () => {
+    const reporter = new EnhancedReporter();
+    const results = {
+        documents: [
+            {
+                path: 'docs/api.md',
+                issues: [
+                    {
+                        reference: { type: 'file-path', value: 'missing.ts', lineNumber: 5, raw: 'missing.ts', sourceFile: 'api.md' },
+                        valid: false,
+                        severity: 'error',
+                        message: 'File not found',
+                        suggestion: 'Did you mean missing.tsx?',
+                    },
+                    {
+                        reference: { type: 'external-url', value: 'https://old.com', lineNumber: 12, raw: 'https://old.com', sourceFile: 'api.md' },
+                        valid: false,
+                        severity: 'warning',
+                        message: 'URL returned 404',
+                    },
+                ],
+            },
+        ],
+        summary: { total: 3, valid: 1, errors: 1, warnings: 1, skipped: 0 },
+    };
+    const emptyResults = {
+        documents: [],
+        summary: { total: 0, valid: 0, errors: 0, warnings: 0, skipped: 0 },
+    };
+    it('generates scan report with validation summary', () => {
+        const report = reporter.generateScanReport(results, null, null, null);
+        expect(report).toContain('Documentation Freshness Scan Report');
+        expect(report).toContain('Total References:** 3');
+        expect(report).toContain('Errors:** 1');
+        expect(report).toContain('Warnings:** 1');
+    });
+    it('includes freshness scores with grade table', () => {
+        const scores = {
+            projectScore: 80,
+            projectGrade: 'B',
+            documents: [
+                {
+                    document: 'docs/api.md',
+                    totalScore: 80,
+                    factors: { referenceValidity: 80, gitTimeDelta: 80, codeChangeFrequency: 80, symbolCoverage: 80 },
+                    grade: 'B',
+                },
+            ],
+            summary: { total: 1, gradeA: 0, gradeB: 1, gradeC: 0, gradeD: 0, gradeF: 0 },
+        };
+        const report = reporter.generateScanReport(results, null, null, scores);
+        expect(report).toContain('80/100');
+        expect(report).toContain('Grade: B');
+        expect(report).toContain('A (90-100)');
+    });
+    it('shows referenced code files from graph', () => {
+        const graph = new CodeDocGraph();
+        graph.addReference('docs/api.md', 'src/server.ts', {
+            type: 'file-path',
+            value: 'src/server.ts',
+            lineNumber: 1,
+            raw: 'src/server.ts',
+            sourceFile: 'api.md',
+        });
+        const report = reporter.generateScanReport(results, graph, null, null);
+        expect(report).toContain('src/server.ts');
+        expect(report).toContain('Referenced Code Files');
+    });
+    it('shows commit info for referenced code files', () => {
+        const graph = new CodeDocGraph();
+        graph.addReference('docs/api.md', 'src/server.ts', {
+            type: 'file-path',
+            value: 'src/server.ts',
+            lineNumber: 1,
+            raw: 'src/server.ts',
+            sourceFile: 'api.md',
+        });
+        const gitTracker = {
+            isGitRepo: () => true,
+            getFileCommitInfo: vi.fn().mockReturnValue({ hash: 'abc', timestamp: Date.now(), message: 'fix' }),
+            getChangedFilesSince: vi.fn().mockReturnValue([]),
+            getAffectedDocs: vi.fn().mockReturnValue([]),
+        };
+        const report = reporter.generateScanReport(results, graph, gitTracker, null);
+        expect(report).toContain('last modified');
+    });
+    it('shows document score inline when scores are provided', () => {
+        const scores = {
+            projectScore: 80,
+            projectGrade: 'B',
+            documents: [
+                {
+                    document: 'docs/api.md',
+                    totalScore: 80,
+                    factors: { referenceValidity: 80, gitTimeDelta: 80, codeChangeFrequency: 80, symbolCoverage: 80 },
+                    grade: 'B',
+                },
+            ],
+            summary: { total: 1, gradeA: 0, gradeB: 1, gradeC: 0, gradeD: 0, gradeF: 0 },
+        };
+        const report = reporter.generateScanReport(results, null, null, scores);
+        expect(report).toContain('Score: 80');
+        expect(report).toContain('Grade: B');
+    });
+    it('shows issues table with both error and warning severity, plus suggestions', () => {
+        const report = reporter.generateScanReport(results, null, null, null);
+        expect(report).toContain('❌');
+        expect(report).toContain('⚠️');
+        expect(report).toContain('File not found');
+        expect(report).toContain('missing.tsx');
+        expect(report).toContain('URL returned 404');
+    });
+    it('omits affected documents section when no documents have issues', () => {
+        const report = reporter.generateScanReport(emptyResults, null, null, null);
+        expect(report).not.toContain('Affected Documents');
+    });
+    it('shows recent code changes impacting docs when git is available', () => {
+        const graph = new CodeDocGraph();
+        graph.addReference('docs/api.md', 'src/server.ts', {
+            type: 'file-path',
+            value: 'src/server.ts',
+            lineNumber: 1,
+            raw: 'src/server.ts',
+            sourceFile: 'api.md',
+        });
+        const gitTracker = {
+            isGitRepo: () => true,
+            getFileCommitInfo: vi.fn().mockReturnValue(null),
+            getChangedFilesSince: vi.fn().mockReturnValue(['src/server.ts']),
+            getAffectedDocs: vi.fn().mockReturnValue(['docs/api.md']),
+        };
+        const report = reporter.generateScanReport(emptyResults, graph, gitTracker, null);
+        expect(report).toContain('Recent Code Changes');
+        expect(report).toContain('docs/api.md');
+    });
+    it('handles git operation errors gracefully', () => {
+        const graph = new CodeDocGraph();
+        const gitTracker = {
+            isGitRepo: () => true,
+            getFileCommitInfo: vi.fn(),
+            getChangedFilesSince: vi.fn().mockImplementation(() => {
+                throw new Error('git error');
+            }),
+            getAffectedDocs: vi.fn(),
+        };
+        const report = reporter.generateScanReport(emptyResults, graph, gitTracker, null);
+        expect(report).not.toContain('Recent Code Changes');
+    });
+});
+//# sourceMappingURL=enhancedReporter.test.js.map