doc-freshness-checker 1.0.0

package/dist/scoring/freshnessScorer.test.js

@@ -0,0 +1,397 @@
+import { FreshnessScorer } from './freshnessScorer.js';
+import { CodeDocGraph } from '../graph/codeDocGraph.js';
+function makeDoc(docPath, refs = []) {
+    return { path: docPath, absolutePath: `/project/${docPath}`, content: '', format: 'markdown', lines: [], references: refs };
+}
+function makeRef(type, value) {
+    return { type, value, lineNumber: 1, raw: value, sourceFile: 'doc.md' };
+}
+const emptyResults = {
+    documents: [],
+    summary: { total: 0, valid: 0, errors: 0, warnings: 0, skipped: 0 },
+};
+function makeMockGitTracker(overrides = {}) {
+    return {
+        isGitRepo: () => true,
+        getCurrentCommit: () => 'abc123',
+        getFileCommitInfo: () => null,
+        getFileLastModified: () => null,
+        getChangedFiles: () => [],
+        getChangedFilesSince: () => [],
+        getAffectedDocs: () => [],
+        getChangeSummary: () => [],
+        ...overrides,
+    };
+}
+describe('FreshnessScorer', () => {
+    describe('constructor', () => {
+        it('uses provided weights and thresholds', () => {
+            const config = {
+                freshnessScoring: {
+                    weights: { referenceValidity: 1, gitTimeDelta: 0, codeChangeFrequency: 0, symbolCoverage: 0 },
+                    thresholds: { gradeA: 95, gradeB: 85, gradeC: 75, gradeD: 65 },
+                },
+            };
+            const scorer = new FreshnessScorer(config);
+            const doc = makeDoc('test.md');
+            const score = scorer.calculateDocScore(doc, emptyResults, null, null);
+            // Only referenceValidity matters (weight=1), and it's 100 with no issues
+            expect(score.totalScore).toBe(100);
+            expect(score.grade).toBe('A');
+        });
+        it('falls back to defaults when config is empty', () => {
+            const scorer = new FreshnessScorer({});
+            const doc = makeDoc('test.md');
+            const score = scorer.calculateDocScore(doc, emptyResults, null, null);
+            expect(score.totalScore).toBe(89); // same as default weights calculation
+        });
+        it('falls back to defaults for partially specified weights', () => {
+            const scorer = new FreshnessScorer({
+                freshnessScoring: { weights: { referenceValidity: 0.5 } },
+            });
+            const doc = makeDoc('test.md');
+            const score = scorer.calculateDocScore(doc, emptyResults, null, null);
+            // referenceValidity=100*0.5 + gitTimeDelta=75*0.3 + changeFreq=75*0.15 + symbolCov=100*0.15
+            // = 50 + 22.5 + 11.25 + 15 = 98.75 ≈ 99 (weights sum > 1 since only one was overridden)
+            expect(score.totalScore).toBe(99);
+        });
+    });
+    describe('calculateReferenceValidityScore (via calculateDocScore)', () => {
+        const scorer = new FreshnessScorer({
+            freshnessScoring: {
+                weights: { referenceValidity: 1, gitTimeDelta: 0, codeChangeFrequency: 0, symbolCoverage: 0 },
+            },
+        });
+        it('returns 100 when doc has no references', () => {
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, null, null);
+            expect(score.factors.referenceValidity).toBe(100);
+        });
+        it('returns 100 when doc has references but no validation issues', () => {
+            const doc = makeDoc('doc.md', [makeRef('file-path', 'a.ts')]);
+            const score = scorer.calculateDocScore(doc, emptyResults, null, null);
+            expect(score.factors.referenceValidity).toBe(100);
+        });
+        it('only counts error-severity issues as invalid (ignores warnings)', () => {
+            const doc = makeDoc('doc.md', [makeRef('file-path', 'a'), makeRef('file-path', 'b')]);
+            const results = {
+                documents: [
+                    {
+                        path: 'doc.md',
+                        issues: [{ reference: makeRef('file-path', 'b'), valid: false, severity: 'warning', message: 'stale' }],
+                    },
+                ],
+                summary: { total: 2, valid: 1, errors: 0, warnings: 1, skipped: 0 },
+            };
+            const score = scorer.calculateDocScore(doc, results, null, null);
+            expect(score.factors.referenceValidity).toBe(100);
+        });
+        it('returns 0 when all references are errors', () => {
+            const doc = makeDoc('doc.md', [makeRef('file-path', 'a'), makeRef('file-path', 'b')]);
+            const results = {
+                documents: [
+                    {
+                        path: 'doc.md',
+                        issues: [
+                            { reference: makeRef('file-path', 'a'), valid: false, severity: 'error', message: 'missing' },
+                            { reference: makeRef('file-path', 'b'), valid: false, severity: 'error', message: 'missing' },
+                        ],
+                    },
+                ],
+                summary: { total: 2, valid: 0, errors: 2, warnings: 0, skipped: 0 },
+            };
+            const score = scorer.calculateDocScore(doc, results, null, null);
+            expect(score.factors.referenceValidity).toBe(0);
+            expect(score.totalScore).toBe(0);
+        });
+        it('handles mixed errors and warnings', () => {
+            const doc = makeDoc('doc.md', [makeRef('file-path', 'a'), makeRef('file-path', 'b'), makeRef('file-path', 'c')]);
+            const results = {
+                documents: [
+                    {
+                        path: 'doc.md',
+                        issues: [
+                            { reference: makeRef('file-path', 'a'), valid: false, severity: 'error', message: 'missing' },
+                            { reference: makeRef('file-path', 'b'), valid: false, severity: 'warning', message: 'stale' },
+                        ],
+                    },
+                ],
+                summary: { total: 3, valid: 1, errors: 1, warnings: 1, skipped: 0 },
+            };
+            const score = scorer.calculateDocScore(doc, results, null, null);
+            // 1 error out of 3 refs → (3-1)/3 = 67%
+            expect(score.factors.referenceValidity).toBe(67);
+        });
+    });
+    describe('calculateGitTimeDeltaScore (via calculateDocScore)', () => {
+        const scorer = new FreshnessScorer({
+            freshnessScoring: {
+                weights: { referenceValidity: 0, gitTimeDelta: 1, codeChangeFrequency: 0, symbolCoverage: 0 },
+            },
+        });
+        it('returns 75 when gitTracker is null', () => {
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, null, null);
+            expect(score.factors.gitTimeDelta).toBe(75);
+        });
+        it('returns 75 when not a git repo', () => {
+            const tracker = makeMockGitTracker({ isGitRepo: () => false });
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, null);
+            expect(score.factors.gitTimeDelta).toBe(75);
+        });
+        it('returns 50 when doc is not tracked by git', () => {
+            const tracker = makeMockGitTracker({ getFileCommitInfo: () => null });
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, null);
+            expect(score.factors.gitTimeDelta).toBe(50);
+        });
+        it('returns 100 when doc has no code references in graph', () => {
+            const tracker = makeMockGitTracker({
+                getFileCommitInfo: () => ({ hash: 'abc', timestamp: Date.now(), message: 'update' }),
+            });
+            const graph = new CodeDocGraph();
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            expect(score.factors.gitTimeDelta).toBe(100);
+        });
+        it('returns 75 when referenced code files are not in git', () => {
+            const tracker = makeMockGitTracker({
+                getFileCommitInfo: (filePath) => (filePath === 'doc.md' ? { hash: 'abc', timestamp: Date.now(), message: 'update' } : null),
+            });
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('file-path', 'a.ts'));
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            expect(score.factors.gitTimeDelta).toBe(75);
+        });
+        it('returns 100 when doc was updated after all referenced code', () => {
+            const now = Date.now();
+            const tracker = makeMockGitTracker({
+                getFileCommitInfo: (filePath) => filePath === 'doc.md'
+                    ? { hash: 'doc', timestamp: now, message: 'doc update' }
+                    : { hash: 'code', timestamp: now - 10_000, message: 'code update' },
+            });
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('file-path', 'a.ts'));
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            expect(score.factors.gitTimeDelta).toBe(100);
+        });
+        it('decays score when doc is older than code', () => {
+            const now = Date.now();
+            const thirtyDaysMs = 30 * 24 * 60 * 60 * 1000;
+            const tracker = makeMockGitTracker({
+                getFileCommitInfo: (filePath) => filePath === 'doc.md'
+                    ? { hash: 'doc', timestamp: now - thirtyDaysMs, message: 'old doc' }
+                    : { hash: 'code', timestamp: now, message: 'recent code' },
+            });
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('file-path', 'a.ts'));
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            // ~30 days diff → 100 * exp(-0.02*30) ≈ 55
+            expect(score.factors.gitTimeDelta).toBeGreaterThan(40);
+            expect(score.factors.gitTimeDelta).toBeLessThan(70);
+        });
+        it('approaches 0 for very old docs', () => {
+            const now = Date.now();
+            const yearMs = 365 * 24 * 60 * 60 * 1000;
+            const tracker = makeMockGitTracker({
+                getFileCommitInfo: (filePath) => filePath === 'doc.md'
+                    ? { hash: 'doc', timestamp: now - yearMs, message: 'ancient' }
+                    : { hash: 'code', timestamp: now, message: 'fresh' },
+            });
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('file-path', 'a.ts'));
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            expect(score.factors.gitTimeDelta).toBeLessThan(5);
+        });
+        it('uses the most recent code timestamp across multiple files', () => {
+            const now = Date.now();
+            const oneDay = 24 * 60 * 60 * 1000;
+            const tracker = makeMockGitTracker({
+                getFileCommitInfo: (filePath) => {
+                    if (filePath === 'doc.md')
+                        return { hash: 'doc', timestamp: now - 5 * oneDay, message: 'doc' };
+                    if (filePath === 'src/old.ts')
+                        return { hash: 'old', timestamp: now - 30 * oneDay, message: 'old' };
+                    return { hash: 'new', timestamp: now, message: 'new' };
+                },
+            });
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/old.ts', makeRef('file-path', 'old.ts'));
+            graph.addReference('doc.md', 'src/new.ts', makeRef('file-path', 'new.ts'));
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            // Delta is 5 days (doc is 5 days behind the newest code file)
+            expect(score.factors.gitTimeDelta).toBeGreaterThan(85);
+            expect(score.factors.gitTimeDelta).toBeLessThanOrEqual(100);
+        });
+    });
+    describe('calculateChangeFrequencyScore (via calculateDocScore)', () => {
+        const scorer = new FreshnessScorer({
+            freshnessScoring: {
+                weights: { referenceValidity: 0, gitTimeDelta: 0, codeChangeFrequency: 1, symbolCoverage: 0 },
+            },
+        });
+        it('returns 75 when not a git repo', () => {
+            const tracker = makeMockGitTracker({ isGitRepo: () => false });
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, null);
+            expect(score.factors.codeChangeFrequency).toBe(75);
+        });
+        it('returns 100 when doc has no code references', () => {
+            const tracker = makeMockGitTracker();
+            const graph = new CodeDocGraph();
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            expect(score.factors.codeChangeFrequency).toBe(100);
+        });
+        it('returns 75 (placeholder) when doc has code references', () => {
+            const tracker = makeMockGitTracker();
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('file-path', 'a.ts'));
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, tracker, graph);
+            expect(score.factors.codeChangeFrequency).toBe(75);
+        });
+    });
+    describe('calculateSymbolCoverageScore (via calculateDocScore)', () => {
+        const scorer = new FreshnessScorer({
+            freshnessScoring: {
+                weights: { referenceValidity: 0, gitTimeDelta: 0, codeChangeFrequency: 0, symbolCoverage: 1 },
+            },
+        });
+        it('returns 100 when no graph provided', () => {
+            const doc = makeDoc('doc.md', [makeRef('code-pattern', 'X')]);
+            const score = scorer.calculateDocScore(doc, emptyResults, null, null);
+            expect(score.factors.symbolCoverage).toBe(100);
+        });
+        it('returns 100 when doc has no code references in graph', () => {
+            const graph = new CodeDocGraph();
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, null, graph);
+            expect(score.factors.symbolCoverage).toBe(100);
+        });
+        it('returns 100 when referenced files have no tracked symbols', () => {
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('file-path', 'a.ts'));
+            // No codeSymbols set for src/a.ts → totalSymbols=0
+            const score = scorer.calculateDocScore(makeDoc('doc.md'), emptyResults, null, graph);
+            expect(score.factors.symbolCoverage).toBe(100);
+        });
+        it('returns 100% when all symbols are documented', () => {
+            const doc = makeDoc('doc.md', [makeRef('code-pattern', 'A'), makeRef('code-pattern', 'B')]);
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', makeRef('code-pattern', 'A'));
+            graph.codeSymbols.set('src/a.ts', new Set(['A', 'B']));
+            const score = scorer.calculateDocScore(doc, emptyResults, null, graph);
+            expect(score.factors.symbolCoverage).toBe(100);
+        });
+        it('returns 50% when half the symbols are documented', () => {
+            const doc = makeDoc('doc.md', [makeRef('code-pattern', 'MyClass')]);
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/x.ts', makeRef('code-pattern', 'MyClass'));
+            graph.codeSymbols.set('src/x.ts', new Set(['MyClass', 'OtherClass']));
+            const score = scorer.calculateDocScore(doc, emptyResults, null, graph);
+            expect(score.factors.symbolCoverage).toBe(50);
+        });
+        it('returns 0% when no symbols are documented', () => {
+            const doc = makeDoc('doc.md', [makeRef('file-path', 'something')]);
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/x.ts', makeRef('file-path', 'x.ts'));
+            graph.codeSymbols.set('src/x.ts', new Set(['A', 'B', 'C']));
+            const score = scorer.calculateDocScore(doc, emptyResults, null, graph);
+            expect(score.factors.symbolCoverage).toBe(0);
+        });
+        it('aggregates symbols across multiple referenced files', () => {
+            const doc = makeDoc('doc.md', [makeRef('code-pattern', 'A'), makeRef('code-pattern', 'C')]);
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/x.ts', makeRef('code-pattern', 'A'));
+            graph.addReference('doc.md', 'src/y.ts', makeRef('code-pattern', 'C'));
+            graph.codeSymbols.set('src/x.ts', new Set(['A', 'B']));
+            graph.codeSymbols.set('src/y.ts', new Set(['C', 'D']));
+            // 2 documented out of 4 total → 50%
+            const score = scorer.calculateDocScore(doc, emptyResults, null, graph);
+            expect(score.factors.symbolCoverage).toBe(50);
+        });
+    });
+    describe('scoreToGrade (via calculateDocScore with weight=1 on referenceValidity)', () => {
+        const scorer = new FreshnessScorer({
+            freshnessScoring: {
+                weights: { referenceValidity: 1, gitTimeDelta: 0, codeChangeFrequency: 0, symbolCoverage: 0 },
+                thresholds: { gradeA: 90, gradeB: 80, gradeC: 70, gradeD: 60 },
+            },
+        });
+        function gradeFor(validRefs, totalRefs) {
+            const refs = Array.from({ length: totalRefs }, (_, i) => makeRef('file-path', `f${i}`));
+            const doc = makeDoc('doc.md', refs);
+            const errorIssues = refs.slice(validRefs).map((r) => ({
+                reference: r,
+                valid: false,
+                severity: 'error',
+                message: 'missing',
+            }));
+            const results = {
+                documents: errorIssues.length > 0 ? [{ path: 'doc.md', issues: errorIssues }] : [],
+                summary: { total: totalRefs, valid: validRefs, errors: totalRefs - validRefs, warnings: 0, skipped: 0 },
+            };
+            return scorer.calculateDocScore(doc, results, null, null).grade;
+        }
+        it.each([
+            [10, 10, 'A'], // 100%
+            [9, 10, 'A'], // 90%
+            [8, 10, 'B'], // 80%
+            [7, 10, 'C'], // 70%
+            [6, 10, 'D'], // 60%
+            [5, 10, 'F'], // 50%
+            [0, 10, 'F'], // 0%
+        ])('%d/%d valid → grade %s', (valid, total, expectedGrade) => {
+            expect(gradeFor(valid, total)).toBe(expectedGrade);
+        });
+    });
+    describe('calculateProjectScores', () => {
+        const scorer = new FreshnessScorer({
+            freshnessScoring: {
+                weights: { referenceValidity: 1, gitTimeDelta: 0, codeChangeFrequency: 0, symbolCoverage: 0 },
+                thresholds: { gradeA: 90, gradeB: 80, gradeC: 70, gradeD: 60 },
+            },
+        });
+        it('returns perfect score for empty project', () => {
+            const scores = scorer.calculateProjectScores([], emptyResults, null, null);
+            expect(scores.projectScore).toBe(100);
+            expect(scores.projectGrade).toBe('A');
+            expect(scores.summary).toEqual({ total: 0, gradeA: 0, gradeB: 0, gradeC: 0, gradeD: 0, gradeF: 0 });
+        });
+        it('averages scores across documents', () => {
+            const goodDoc = makeDoc('good.md', [makeRef('file-path', 'a')]);
+            const badDoc = makeDoc('bad.md', [makeRef('file-path', 'a')]);
+            const results = {
+                documents: [
+                    {
+                        path: 'bad.md',
+                        issues: [{ reference: makeRef('file-path', 'a'), valid: false, severity: 'error', message: 'missing' }],
+                    },
+                ],
+                summary: { total: 2, valid: 1, errors: 1, warnings: 0, skipped: 0 },
+            };
+            const scores = scorer.calculateProjectScores([goodDoc, badDoc], results, null, null);
+            // good=100, bad=0 → avg=50
+            expect(scores.projectScore).toBe(50);
+            expect(scores.projectGrade).toBe('F');
+        });
+        it('correctly tallies grade summary counts', () => {
+            // All docs with no issues → all grade A
+            const docs = [makeDoc('a.md'), makeDoc('b.md'), makeDoc('c.md')];
+            const scores = scorer.calculateProjectScores(docs, emptyResults, null, null);
+            expect(scores.summary.total).toBe(3);
+            expect(scores.summary.gradeA).toBe(3);
+            expect(scores.summary.gradeB + scores.summary.gradeC + scores.summary.gradeD + scores.summary.gradeF).toBe(0);
+        });
+        it('produces correct document-level detail', () => {
+            const doc = makeDoc('x.md', [makeRef('file-path', 'f1'), makeRef('file-path', 'f2')]);
+            const results = {
+                documents: [
+                    {
+                        path: 'x.md',
+                        issues: [{ reference: makeRef('file-path', 'f1'), valid: false, severity: 'error', message: 'missing' }],
+                    },
+                ],
+                summary: { total: 2, valid: 1, errors: 1, warnings: 0, skipped: 0 },
+            };
+            const scores = scorer.calculateProjectScores([doc], results, null, null);
+            expect(scores.documents).toHaveLength(1);
+            expect(scores.documents[0].document).toBe('x.md');
+            expect(scores.documents[0].factors.referenceValidity).toBe(50);
+        });
+    });
+});
+//# sourceMappingURL=freshnessScorer.test.js.map

package/dist/scoring/freshnessScorer.test.js.map

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

package/dist/semantic/vectorSearch.d.ts

@@ -0,0 +1,84 @@
+import type { CacheStats, CodeFile, DocFreshnessConfig, Document, VectorMismatch } from '../types.js';
+export declare class VectorSearch {
+    private config;
+    private model;
+    private modelInitPromise;
+    private vectorIndex;
+    private indexMetadata;
+    private embeddingCache;
+    private cacheLoaded;
+    private dimensions;
+    private cacheDir;
+    private embeddingCacheFile;
+    private modelCacheDir;
+    constructor(config: DocFreshnessConfig);
+    /**
+     * Initialize the FastEmbed model (lazy loading)
+     */
+    initialize(): Promise<boolean>;
+    private initializeModel;
+    /**
+     * Check if vector search is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Check if model cache directory has the model files
+     */
+    private checkModelCacheExists;
+    /**
+     * Load embedding cache from disk
+     */
+    private loadCache;
+    /**
+     * Save embedding cache to disk
+     */
+    private saveCache;
+    /**
+     * Generate a cache key for content
+     */
+    private getCacheKey;
+    /**
+     * Generate embedding for text (with caching)
+     */
+    private embed;
+    /**
+     * Generate embedding for a query (optimized for search)
+     */
+    embedQuery(text: string): Promise<number[]>;
+    /**
+     * Index all documentation sections (with incremental support)
+     */
+    indexDocumentation(documents: Document[]): Promise<void>;
+    /**
+     * Index code comments and docstrings (with incremental support)
+     */
+    indexCodeComments(codeFiles: CodeFile[]): Promise<void>;
+    /**
+     * Find semantic mismatches between docs and code
+     */
+    findMismatches(threshold?: number | null): Promise<VectorMismatch[]>;
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Split markdown into sections
+     */
+    private splitIntoSections;
+    /**
+     * Extract comments from code
+     */
+    private extractComments;
+    /**
+     * Find the function/class name nearest to a comment
+     */
+    private findNearestSymbol;
+    /**
+     * Clear the embedding cache
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): CacheStats;
+}