doc-freshness-checker 1.0.0

package/dist/utils/similarity.js

@@ -0,0 +1,64 @@
+/**
+ * Find the most similar string from a list using Levenshtein distance
+ */
+export function findSimilar(target, candidates, maxDistance = 3) {
+    if (!candidates || candidates.length === 0)
+        return null;
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    const targetLower = target.toLowerCase();
+    for (const candidate of candidates) {
+        const candidateLower = candidate.toLowerCase();
+        // Exact case-insensitive match
+        if (targetLower === candidateLower && target !== candidate) {
+            return candidate;
+        }
+        const distance = levenshteinDistance(targetLower, candidateLower);
+        if (distance < bestDistance && distance <= maxDistance) {
+            bestDistance = distance;
+            bestMatch = candidate;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+export function levenshteinDistance(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const matrix = [];
+    // Initialize matrix
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    // Fill matrix
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Calculate similarity ratio (0-1) between two strings
+ */
+export function similarityRatio(a, b) {
+    const distance = levenshteinDistance(a.toLowerCase(), b.toLowerCase());
+    const maxLength = Math.max(a.length, b.length);
+    return maxLength === 0 ? 1 : 1 - distance / maxLength;
+}
+//# sourceMappingURL=similarity.js.map

package/dist/utils/similarity.js.map

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

package/dist/utils/similarity.test.d.ts

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

package/dist/utils/similarity.test.js

@@ -0,0 +1,49 @@
+import { levenshteinDistance, findSimilar, similarityRatio } from './similarity.js';
+describe('levenshteinDistance', () => {
+    it.each([
+        ['', '', 0],
+        ['abc', '', 3],
+        ['', 'xyz', 3],
+        ['kitten', 'sitting', 3],
+        ['same', 'same', 0],
+        ['abc', 'abd', 1],
+    ])('levenshteinDistance(%s, %s) => %d', (a, b, expected) => {
+        expect(levenshteinDistance(a, b)).toBe(expected);
+    });
+});
+describe('similarityRatio', () => {
+    it('returns 1 for identical strings', () => {
+        expect(similarityRatio('hello', 'hello')).toBe(1);
+    });
+    it('returns 1 for two empty strings', () => {
+        expect(similarityRatio('', '')).toBe(1);
+    });
+    it('is case-insensitive', () => {
+        expect(similarityRatio('Hello', 'hello')).toBe(1);
+    });
+    it('returns a value between 0 and 1 for different strings', () => {
+        const ratio = similarityRatio('kitten', 'sitting');
+        expect(ratio).toBeGreaterThan(0);
+        expect(ratio).toBeLessThan(1);
+    });
+});
+describe('findSimilar', () => {
+    it('returns null for empty candidates', () => {
+        expect(findSimilar('test', [])).toBeNull();
+        expect(findSimilar('test', null)).toBeNull();
+    });
+    it('returns exact case-insensitive match preferentially', () => {
+        expect(findSimilar('README', ['readme', 'other'])).toBe('readme');
+    });
+    it('returns closest match within maxDistance', () => {
+        expect(findSimilar('fle', ['file', 'folder', 'xyz'])).toBe('file');
+    });
+    it('returns null when no match within default maxDistance', () => {
+        expect(findSimilar('abc', ['xyzxyz', 'mnopqr'])).toBeNull();
+    });
+    it('respects custom maxDistance', () => {
+        expect(findSimilar('abc', ['abd'], 1)).toBe('abd');
+        expect(findSimilar('abc', ['xyz'], 1)).toBeNull();
+    });
+});
+//# sourceMappingURL=similarity.test.js.map

package/dist/utils/similarity.test.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,13 @@
+import type { DocFreshnessConfig, Reference, Severity, ValidationResult } from '../types.js';
+/**
+ * Get a rule severity with fallback.
+ */
+export declare function getRuleSeverity(config: DocFreshnessConfig, ruleType: string, fallback: Severity): Severity;
+/**
+ * Downgrade severity for illustrative references.
+ */
+export declare function severityForIllustrative(isIllustrative: boolean, baseSeverity: Severity): Severity;
+/**
+ * Standard skipped result for illustrative references.
+ */
+export declare function createIllustrativeSkippedResult(reference: Reference, message: string): ValidationResult;

package/dist/utils/validation.js

@@ -0,0 +1,24 @@
+/**
+ * Get a rule severity with fallback.
+ */
+export function getRuleSeverity(config, ruleType, fallback) {
+    return config.rules?.[ruleType]?.severity || fallback;
+}
+/**
+ * Downgrade severity for illustrative references.
+ */
+export function severityForIllustrative(isIllustrative, baseSeverity) {
+    return isIllustrative ? 'info' : baseSeverity;
+}
+/**
+ * Standard skipped result for illustrative references.
+ */
+export function createIllustrativeSkippedResult(reference, message) {
+    return {
+        reference,
+        valid: true,
+        skipped: true,
+        message,
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B,EAAE,QAAgB,EAAE,QAAkB;IAC9F,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,IAAI,QAAQ,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAAuB,EAAE,YAAsB;IACrF,OAAO,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAAoB,EAAE,OAAe;IACnF,OAAO;QACL,SAAS;QACT,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/utils/validation.test.d.ts

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

package/dist/utils/validation.test.js

@@ -0,0 +1,28 @@
+import { getRuleSeverity, severityForIllustrative, createIllustrativeSkippedResult } from './validation.js';
+describe('getRuleSeverity', () => {
+    it('returns configured severity when present', () => {
+        const config = { rules: { 'file-path': { severity: 'warning' } } };
+        expect(getRuleSeverity(config, 'file-path', 'error')).toBe('warning');
+    });
+    it('returns fallback when rule is not configured', () => {
+        expect(getRuleSeverity({}, 'file-path', 'error')).toBe('error');
+        expect(getRuleSeverity({ rules: {} }, 'missing', 'info')).toBe('info');
+    });
+});
+describe('severityForIllustrative', () => {
+    it('downgrades to info for illustrative references', () => {
+        expect(severityForIllustrative(true, 'error')).toBe('info');
+    });
+    it('keeps base severity for non-illustrative references', () => {
+        expect(severityForIllustrative(false, 'error')).toBe('error');
+        expect(severityForIllustrative(false, 'warning')).toBe('warning');
+    });
+});
+describe('createIllustrativeSkippedResult', () => {
+    it('creates a valid skipped result', () => {
+        const ref = { type: 'file-path', value: 'foo.ts', lineNumber: 1, raw: 'foo.ts', sourceFile: 'doc.md' };
+        const result = createIllustrativeSkippedResult(ref, 'Skipped');
+        expect(result).toEqual({ reference: ref, valid: true, skipped: true, message: 'Skipped' });
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/utils/validation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.js","sourceRoot":"","sources":["../../src/utils/validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAG5G,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAuB,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACvF,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,GAAG,GAAc,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;QAClH,MAAM,MAAM,GAAG,+BAA+B,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/validators/codePatternValidator.d.ts

@@ -0,0 +1,28 @@
+import type { DocFreshnessConfig, Document, LanguageConfig, Reference, SourceFileData, SymbolLocation, ValidationResult } from '../types.js';
+/**
+ * Language-specific source file patterns and code symbol extractors
+ */
+declare const languageConfigs: Record<string, LanguageConfig>;
+/**
+ * Validates code patterns exist in source files
+ */
+export declare class CodePatternValidator {
+    private sourceIndex;
+    private sourceFiles;
+    constructor();
+    buildSourceIndex(config: DocFreshnessConfig): Promise<void>;
+    private detectSourcePatterns;
+    private detectLanguage;
+    private indexContent;
+    validateBatch(references: Reference[], _document: Document, config: DocFreshnessConfig): Promise<ValidationResult[]>;
+    private findSimilarSymbol;
+    /**
+     * Get the source index for graph building
+     */
+    getSourceIndex(): Map<string, SymbolLocation[]> | null;
+    /**
+     * Get source files with content for vector search
+     */
+    getSourceFiles(): Map<string, SourceFileData> | null;
+}
+export { languageConfigs };

package/dist/validators/codePatternValidator.js

@@ -0,0 +1,200 @@
+import fs from 'fs';
+import path from 'path';
+import { glob } from 'glob';
+import { findSimilar } from '../utils/similarity.js';
+/**
+ * Language-specific source file patterns and code symbol extractors
+ */
+const languageConfigs = {
+    javascript: {
+        extensions: ['js', 'jsx', 'mjs', 'cjs'],
+        patterns: [
+            { regex: /\bclass\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'class' },
+            { regex: /\bexport\s+(?:async\s+)?function\s+([a-zA-Z][a-zA-Z0-9]+)/g, kind: 'function' },
+            { regex: /\bexport\s+const\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'const' },
+            { regex: /\bfunction\s+([a-zA-Z][a-zA-Z0-9]+)/g, kind: 'function' },
+        ],
+    },
+    typescript: {
+        extensions: ['ts', 'tsx'],
+        patterns: [
+            { regex: /\bclass\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'class' },
+            { regex: /\binterface\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'interface' },
+            { regex: /\btype\s+([A-Z][a-zA-Z0-9]+)\s*=/g, kind: 'type' },
+            { regex: /\bexport\s+(?:async\s+)?function\s+([a-zA-Z][a-zA-Z0-9]+)/g, kind: 'function' },
+            { regex: /\bexport\s+const\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'const' },
+            { regex: /\bfunction\s+([a-zA-Z][a-zA-Z0-9]+)/g, kind: 'function' },
+        ],
+    },
+    python: {
+        extensions: ['py'],
+        patterns: [
+            { regex: /\bclass\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'class' },
+            { regex: /\bdef\s+([a-z_][a-zA-Z0-9_]*)/g, kind: 'function' },
+        ],
+    },
+    go: {
+        extensions: ['go'],
+        patterns: [
+            { regex: /\btype\s+([A-Z][a-zA-Z0-9]+)\s+struct/g, kind: 'struct' },
+            { regex: /\btype\s+([A-Z][a-zA-Z0-9]+)\s+interface/g, kind: 'interface' },
+            { regex: /\bfunc\s+(?:\([^)]+\)\s+)?([A-Z][a-zA-Z0-9]+)/g, kind: 'function' },
+        ],
+    },
+    rust: {
+        extensions: ['rs'],
+        patterns: [
+            { regex: /\bstruct\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'struct' },
+            { regex: /\benum\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'enum' },
+            { regex: /\btrait\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'trait' },
+            { regex: /\bpub\s+fn\s+([a-z_][a-zA-Z0-9_]*)/g, kind: 'function' },
+            { regex: /\bfn\s+([a-z_][a-zA-Z0-9_]*)/g, kind: 'function' },
+        ],
+    },
+    java: {
+        extensions: ['java'],
+        patterns: [
+            { regex: /\bclass\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'class' },
+            { regex: /\binterface\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'interface' },
+            { regex: /\benum\s+([A-Z][a-zA-Z0-9]+)/g, kind: 'enum' },
+        ],
+    },
+};
+import { isIllustrativeSymbol } from '../utils/illustrativePatterns.js';
+import { createIllustrativeSkippedResult, getRuleSeverity, severityForIllustrative } from '../utils/validation.js';
+/**
+ * Validates code patterns exist in source files
+ */
+export class CodePatternValidator {
+    sourceIndex;
+    sourceFiles; // Stores file content for vector search
+    constructor() {
+        this.sourceIndex = null;
+        this.sourceFiles = null;
+    }
+    async buildSourceIndex(config) {
+        if (this.sourceIndex)
+            return;
+        this.sourceIndex = new Map();
+        this.sourceFiles = new Map();
+        // Use configured source patterns or detect automatically
+        const sourcePatterns = config.sourcePatterns || this.detectSourcePatterns();
+        for (const pattern of sourcePatterns) {
+            try {
+                const files = await glob(pattern, {
+                    cwd: config.rootDir,
+                    absolute: true,
+                    ignore: ['**/*.test.*', '**/*.spec.*', '**/*.d.ts', '**/node_modules/**', '**/vendor/**'],
+                });
+                for (const file of files) {
+                    try {
+                        const content = await fs.promises.readFile(file, 'utf-8');
+                        const relativePath = path.relative(config.rootDir || process.cwd(), file);
+                        const lang = this.detectLanguage(file);
+                        this.indexContent(content, relativePath, lang);
+                        // Store file content for vector search
+                        this.sourceFiles.set(relativePath, { content, language: lang });
+                    }
+                    catch {
+                        // Skip unreadable files
+                    }
+                }
+            }
+            catch {
+                // Skip invalid patterns
+            }
+        }
+    }
+    detectSourcePatterns() {
+        // Auto-detect based on what files exist
+        const patterns = [];
+        for (const conf of Object.values(languageConfigs)) {
+            for (const ext of conf.extensions) {
+                patterns.push(`**/*.${ext}`);
+            }
+        }
+        return patterns;
+    }
+    detectLanguage(filePath) {
+        const ext = path.extname(filePath).slice(1).toLowerCase();
+        for (const [lang, conf] of Object.entries(languageConfigs)) {
+            if (conf.extensions.includes(ext)) {
+                return lang;
+            }
+        }
+        return 'javascript';
+    }
+    indexContent(content, filePath, language) {
+        const langConfig = languageConfigs[language];
+        if (!langConfig)
+            return;
+        for (const { regex, kind } of langConfig.patterns) {
+            let match;
+            // Clone regex to avoid state issues
+            const re = new RegExp(regex.source, regex.flags);
+            while ((match = re.exec(content)) !== null) {
+                const name = match[1];
+                if (!this.sourceIndex.has(name)) {
+                    this.sourceIndex.set(name, []);
+                }
+                this.sourceIndex.get(name).push({ filePath, kind, language });
+            }
+        }
+    }
+    async validateBatch(references, _document, config) {
+        await this.buildSourceIndex(config);
+        const results = [];
+        // For code-pattern, we skip illustrative symbols by default
+        const skipIllustrative = true;
+        for (const ref of references) {
+            const name = ref.value;
+            // Check if this is an illustrative symbol (marked by extractor or detected here)
+            const illustrative = ref.isIllustrative || isIllustrativeSymbol(name);
+            if (illustrative && skipIllustrative) {
+                results.push(createIllustrativeSkippedResult(ref, 'Skipped: illustrative/example code pattern'));
+                continue;
+            }
+            const found = this.sourceIndex.get(name);
+            if (found && found.length > 0) {
+                results.push({
+                    reference: ref,
+                    valid: true,
+                    foundIn: found.map((f) => f.filePath),
+                });
+            }
+            else {
+                const similar = this.findSimilarSymbol(name);
+                // Reduce severity for illustrative patterns that weren't skipped
+                const baseSeverity = getRuleSeverity(config, 'code-pattern', 'warning');
+                results.push({
+                    reference: ref,
+                    valid: false,
+                    severity: severityForIllustrative(illustrative, baseSeverity),
+                    message: illustrative
+                        ? `Code pattern not found (illustrative): ${ref.kind} ${name}`
+                        : `Code pattern not found: ${ref.kind} ${name}`,
+                    suggestion: similar ? `Did you mean: ${similar}?` : null,
+                });
+            }
+        }
+        return results;
+    }
+    findSimilarSymbol(name) {
+        const symbols = Array.from(this.sourceIndex.keys());
+        return findSimilar(name, symbols);
+    }
+    /**
+     * Get the source index for graph building
+     */
+    getSourceIndex() {
+        return this.sourceIndex;
+    }
+    /**
+     * Get source files with content for vector search
+     */
+    getSourceFiles() {
+        return this.sourceFiles;
+    }
+}
+export { languageConfigs };
+//# sourceMappingURL=codePatternValidator.js.map

package/dist/validators/codePatternValidator.js.map

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

package/dist/validators/codePatternValidator.test.d.ts

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

package/dist/validators/codePatternValidator.test.js

@@ -0,0 +1,86 @@
+import { CodePatternValidator } from './codePatternValidator.js';
+function makeRef(value, overrides = {}) {
+    return {
+        type: 'code-pattern',
+        value,
+        lineNumber: 1,
+        raw: value,
+        sourceFile: 'doc.md',
+        kind: 'class',
+        language: 'typescript',
+        ...overrides,
+    };
+}
+const doc = { path: 'doc.md', absolutePath: '/project/doc.md', content: '', format: 'markdown', lines: [], references: [] };
+describe('CodePatternValidator', () => {
+    const config = {
+        rootDir: process.cwd(),
+        sourcePatterns: ['src/**/*.ts'],
+        rules: { 'code-pattern': { enabled: true, severity: 'warning' } },
+    };
+    it('finds symbols that exist in source code', async () => {
+        const validator = new CodePatternValidator();
+        const results = await validator.validateBatch([makeRef('CodePatternValidator')], doc, config);
+        expect(results[0].valid).toBe(true);
+        expect(results[0].foundIn).toBeDefined();
+    });
+    it('reports missing symbols with suggestions', async () => {
+        const validator = new CodePatternValidator();
+        const results = await validator.validateBatch([makeRef('CodePatternValidato')], doc, config);
+        expect(results[0].valid).toBe(false);
+        expect(results[0].suggestion).toContain('CodePatternValidator');
+    });
+    it('skips illustrative symbols', async () => {
+        const validator = new CodePatternValidator();
+        const results = await validator.validateBatch([makeRef('YourComponent'), makeRef('FooBar')], doc, config);
+        expect(results.every((r) => r.skipped)).toBe(true);
+    });
+    it('skips pre-marked illustrative references', async () => {
+        const validator = new CodePatternValidator();
+        const results = await validator.validateBatch([makeRef('SomeRealName', { isIllustrative: true })], doc, config);
+        expect(results[0].skipped).toBe(true);
+    });
+    it('exposes source index and source files after building', async () => {
+        const validator = new CodePatternValidator();
+        await validator.buildSourceIndex(config);
+        expect(validator.getSourceIndex()).toBeInstanceOf(Map);
+        expect(validator.getSourceFiles()).toBeInstanceOf(Map);
+        expect(validator.getSourceIndex().size).toBeGreaterThan(0);
+    });
+    it('returns immediately when source index is already built', async () => {
+        const validator = new CodePatternValidator();
+        await validator.buildSourceIndex(config);
+        const indexBefore = validator.getSourceIndex();
+        await validator.buildSourceIndex(config);
+        expect(validator.getSourceIndex()).toBe(indexBefore);
+    });
+    it('defaults to javascript when language is unknown', async () => {
+        const validator = new CodePatternValidator();
+        await validator.buildSourceIndex({
+            rootDir: process.cwd(),
+            sourcePatterns: ['src/**/*.ts'],
+        });
+        expect(validator.getSourceIndex()).toBeInstanceOf(Map);
+    });
+    it('reports not-found symbol without suggestion when no similar exists', async () => {
+        const validator = new CodePatternValidator();
+        const results = await validator.validateBatch([makeRef('ZzzVeryUniqueName12345')], doc, config);
+        expect(results[0].valid).toBe(false);
+        expect(results[0].suggestion).toBeNull();
+        expect(results[0].message).toContain('Code pattern not found');
+    });
+    it('handles source patterns that match no files', async () => {
+        const validator = new CodePatternValidator();
+        await validator.buildSourceIndex({
+            rootDir: process.cwd(),
+            sourcePatterns: ['nonexistent-dir/**/*.zzz'],
+        });
+        expect(validator.getSourceIndex().size).toBe(0);
+    });
+    it('auto-detects source patterns when none configured', async () => {
+        const validator = new CodePatternValidator();
+        await validator.buildSourceIndex({ rootDir: process.cwd() });
+        expect(validator.getSourceIndex()).toBeInstanceOf(Map);
+    });
+});
+//# sourceMappingURL=codePatternValidator.test.js.map

package/dist/validators/codePatternValidator.test.js.map

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

package/dist/validators/dependencyValidator.d.ts

@@ -0,0 +1,12 @@
+import type { DocFreshnessConfig, Document, Reference, ValidationResult } from '../types.js';
+/**
+ * Validates that mentioned dependencies exist in manifest files
+ */
+export declare class DependencyValidator {
+    private dependencies;
+    private loadedFromKey;
+    constructor();
+    private loadDependencies;
+    private parseManifest;
+    validateBatch(references: Reference[], _document: Document, config: DocFreshnessConfig): Promise<ValidationResult[]>;
+}