doc-freshness-checker 2.0.23 → 2.2.0

package/dist/validators/codePatternValidator.js

@@ -1,175 +1,47 @@
-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 { SourceIndex, languageConfigs as sourceLanguageConfigs } from '../source/sourceIndex.js';
 import { isIllustrativeSymbol } from '../utils/illustrativePatterns.js';
 import { createIllustrativeSkippedResult, getRuleSeverity, severityForIllustrative } from '../utils/validation.js';
+const languageConfigs = sourceLanguageConfigs;
 /**
  * Validates code patterns exist in source files
  */
 export class CodePatternValidator {
+    index;
     /** @internal */
     incrementalCaptureScope = 'project';
     /** @internal */
     incrementalInputsRequiredForGraph = true;
     sourceIndex;
     sourceFiles; // Stores file content for vector search
-    sourceInputs;
-    sourceInputsAvailable;
-    capturedInputs;
-    constructor() {
+    incrementalInputs;
+    constructor(index = new SourceIndex()) {
+        this.index = index;
         this.sourceIndex = null;
         this.sourceFiles = null;
-        this.sourceInputs = null;
-        this.sourceInputsAvailable = false;
-        this.capturedInputs = null;
+        this.incrementalInputs = null;
     }
     async buildSourceIndex(config) {
         if (this.sourceIndex) {
             return;
         }
-        this.sourceIndex = new Map();
-        this.sourceFiles = new Map();
-        this.sourceInputs = new Map();
-        this.sourceInputsAvailable = true;
-        // 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,
-                    nodir: true,
-                    ignore: ['**/*.test.*', '**/*.spec.*', '**/*.d.ts', '**/node_modules/**', '**/vendor/**'],
-                });
-                for (const file of files) {
-                    const absolutePath = path.resolve(file);
-                    if (this.sourceInputs.has(absolutePath)) {
-                        continue;
-                    }
-                    try {
-                        const content = await fs.promises.readFile(absolutePath, 'utf-8');
-                        const relativePath = path.relative(config.rootDir || process.cwd(), absolutePath);
-                        const lang = this.detectLanguage(absolutePath);
-                        this.indexContent(content, relativePath, lang);
-                        // Store file content for vector search
-                        this.sourceFiles.set(relativePath, { content, language: lang });
-                        this.sourceInputs.set(absolutePath, content);
-                    }
-                    catch {
-                        // Skip unreadable files
-                        this.sourceInputsAvailable = false;
-                    }
-                }
-            }
-            catch {
-                // Skip invalid patterns
-                this.sourceInputsAvailable = false;
-            }
+        try {
+            this.useSnapshot(await this.index.load(config, 'pattern'));
         }
-        this.capturedInputs = this.sourceInputsAvailable
-            ? [...this.sourceInputs].map(([sourcePath, content]) => ({ path: sourcePath, content }))
-            : null;
-    }
-    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}`);
-            }
+        catch (error) {
+            this.useSnapshot(await this.index.load(config, 'pattern'));
+            throw error;
         }
-        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';
+    useSnapshot(snapshot) {
+        this.sourceIndex = snapshot.symbols;
+        this.sourceFiles = snapshot.patternFiles;
+        this.incrementalInputs = snapshot.patternInputs;
     }
     /** @internal */
     async getIncrementalInputs(_references, _document, config) {
         await this.buildSourceIndex(config);
-        return this.capturedInputs;
-    }
-    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 });
-            }
-        }
+        return this.incrementalInputs;
     }
     async validateBatch(references, _document, config) {
         await this.buildSourceIndex(config);

package/dist/validators/codePatternValidator.js.map

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

package/dist/validators/codeSnippetValidator.d.ts

@@ -1,9 +1,4 @@
-import type { DocFreshnessConfig, Document, Reference, ValidationResult } from '../types.js';
-interface FunctionSignature {
-    params: string[];
-    requiredParams: number;
-    filePath: string;
-}
+import type { DocFreshnessConfig, Document, FunctionSignature, Reference, ValidationResult } from '../types.js';
 /**
  * Validates code-snippet references extracted from documentation code blocks.
  *
@@ -13,15 +8,17 @@ interface FunctionSignature {
  *  3. Config keys — keys exist in the referenced type/interface
  */
 export declare class CodeSnippetValidator {
+    private readonly index;
     private sourceFiles;
     private functionSignatures;
     private interfaceKeys;
+    private exportsByFile;
     private customPatterns;
-    private indexBuilt;
+    constructor();
     validateBatch(references: Reference[], _document: Document, config: DocFreshnessConfig): Promise<ValidationResult[]>;
     private initCustomPatterns;
     private buildIndex;
-    private detectLanguage;
+    private useSnapshot;
     private validateImport;
     private resolveImportPath;
     private resolvePythonImportPath;
@@ -29,20 +26,10 @@ export declare class CodeSnippetValidator {
     private getExportedSymbols;
     private validateFunctionCall;
     private validateConfigKeys;
-    private indexFunctionSignatures;
-    private addSignature;
-    private parseParameters;
-    private extractParamName;
-    private isOptionalParam;
     private legacyImportSpecifiers;
     private extractSpecifiersByPrefix;
     private validateFunctionParameterNames;
     private parameterNamesMatch;
-    private indexInterfaceDefinitions;
-    private addInterfaceKeys;
-    private extractBraceContent;
-    private extractPropertyKeys;
     getFunctionSignatures(): Map<string, FunctionSignature[]> | null;
     getInterfaceKeys(): Map<string, Set<string>> | null;
 }
-export {};

package/dist/validators/codeSnippetValidator.js

@@ -1,19 +1,9 @@
 import fs from 'fs';
 import path from 'path';
-import { glob } from 'glob';
+import { SourceIndex } from '../source/sourceIndex.js';
 import { isIllustrativePath, isIllustrativeSymbol, compilePatterns } from '../utils/illustrativePatterns.js';
 import { findSimilar } from '../utils/similarity.js';
 import { createIllustrativeSkippedResult, getRuleSeverity, severityForIllustrative } from '../utils/validation.js';
-const LANG_EXTENSIONS = {
-    ts: 'typescript',
-    tsx: 'typescript',
-    js: 'javascript',
-    jsx: 'javascript',
-    mjs: 'javascript',
-    cjs: 'javascript',
-    py: 'python',
-    go: 'go',
-};
 /**
  * Validates code-snippet references extracted from documentation code blocks.
  *
@@ -23,11 +13,15 @@ const LANG_EXTENSIONS = {
  *  3. Config keys — keys exist in the referenced type/interface
  */
 export class CodeSnippetValidator {
+    index;
     sourceFiles = null;
     functionSignatures = null;
     interfaceKeys = null;
+    exportsByFile = null;
     customPatterns = [];
-    indexBuilt = false;
+    constructor(index = new SourceIndex()) {
+        this.index = index;
+    }
     async validateBatch(references, _document, config) {
         await this.buildIndex(config);
         const ruleConfig = config.rules?.['code-snippet'];
@@ -59,44 +53,22 @@ export class CodeSnippetValidator {
     // Index building
     // ---------------------------------------------------------------------------
     async buildIndex(config) {
-        if (this.indexBuilt) {
+        if (this.sourceFiles) {
             return;
         }
-        this.indexBuilt = true;
-        this.sourceFiles = new Map();
-        this.functionSignatures = new Map();
-        this.interfaceKeys = new Map();
-        const rootDir = config.rootDir || process.cwd();
-        const sourcePatterns = config.sourcePatterns || ['**/*.{ts,tsx,js,jsx,py,go}'];
-        for (const pattern of sourcePatterns) {
-            try {
-                const files = await glob(pattern, {
-                    cwd: rootDir,
-                    absolute: true,
-                    ignore: ['**/*.test.*', '**/*.spec.*', '**/*.d.ts', '**/node_modules/**', '**/vendor/**', '**/dist/**', '**/build/**'],
-                });
-                for (const file of files) {
-                    try {
-                        const content = await fs.promises.readFile(file, 'utf-8');
-                        const relativePath = path.relative(rootDir, file);
-                        const lang = this.detectLanguage(file);
-                        this.sourceFiles.set(relativePath, { content, language: lang });
-                        this.indexFunctionSignatures(content, relativePath, lang);
-                        this.indexInterfaceDefinitions(content, relativePath, lang);
-                    }
-                    catch {
-                        /* skip unreadable files */
-                    }
-                }
-            }
-            catch {
-                /* skip invalid patterns */
-            }
+        try {
+            this.useSnapshot(await this.index.load(config, 'snippet'));
+        }
+        catch (error) {
+            this.useSnapshot(await this.index.load(config, 'snippet'));
+            throw error;
         }
     }
-    detectLanguage(filePath) {
-        const ext = path.extname(filePath).slice(1).toLowerCase();
-        return LANG_EXTENSIONS[ext] || 'javascript';
+    useSnapshot(snapshot) {
+        this.sourceFiles = snapshot.snippetFiles;
+        this.functionSignatures = snapshot.functionSignatures;
+        this.interfaceKeys = snapshot.interfaceKeys;
+        this.exportsByFile = snapshot.exportsByFile;
     }
     // ---------------------------------------------------------------------------
     // Import validation
@@ -228,77 +200,7 @@ export class CodeSnippetValidator {
         return null;
     }
     getExportedSymbols(filePath) {
-        const fileData = this.sourceFiles?.get(filePath);
-        if (!fileData) {
-            return new Set();
-        }
-        const exports = new Set();
-        const content = fileData.content;
-        if (fileData.language === 'python') {
-            const defPattern = /^(?:async\s+)?def\s+([A-Za-z_]\w*)\s*\(/gm;
-            let pythonMatch;
-            while ((pythonMatch = defPattern.exec(content)) !== null) {
-                if (!pythonMatch[1].startsWith('_')) {
-                    exports.add(pythonMatch[1]);
-                }
-            }
-            const classPattern = /^class\s+([A-Za-z_]\w*)\b/gm;
-            while ((pythonMatch = classPattern.exec(content)) !== null) {
-                if (!pythonMatch[1].startsWith('_')) {
-                    exports.add(pythonMatch[1]);
-                }
-            }
-            const assignmentPattern = /^([A-Za-z_]\w*)\s*=/gm;
-            while ((pythonMatch = assignmentPattern.exec(content)) !== null) {
-                if (!pythonMatch[1].startsWith('_')) {
-                    exports.add(pythonMatch[1]);
-                }
-            }
-            return exports;
-        }
-        // export [async] function|class|const|let|var|interface|type|enum Name
-        const directPattern = /export\s+(?:default\s+)?(?:async\s+)?(?:function|class|const|let|var|interface|type|enum)\s+(\w+)/g;
-        let match;
-        while ((match = directPattern.exec(content)) !== null) {
-            exports.add(match[1]);
-        }
-        // export { Name1, Name2 as Alias }
-        const namedPattern = /export\s*\{([^}]+)\}/g;
-        while ((match = namedPattern.exec(content)) !== null) {
-            for (const item of match[1].split(',')) {
-                const original = item
-                    .trim()
-                    .split(/\s+as\s+/)[0]
-                    .trim();
-                if (original) {
-                    exports.add(original);
-                }
-            }
-        }
-        // export default identifier;
-        const defaultPattern = /export\s+default\s+(\w+)\s*[;\n]/g;
-        while ((match = defaultPattern.exec(content)) !== null) {
-            exports.add(match[1]);
-            exports.add('default');
-        }
-        const defaultDeclarationPattern = /export\s+default\s+(?:async\s+)?(?:function|class)\b(?:\s+(\w+))?/g;
-        while ((match = defaultDeclarationPattern.exec(content)) !== null) {
-            if (match[1]) {
-                exports.add(match[1]);
-            }
-            exports.add('default');
-        }
-        // module.exports = { name1, name2: value }
-        const cjsPattern = /module\.exports\s*=\s*\{([^}]+)\}/g;
-        while ((match = cjsPattern.exec(content)) !== null) {
-            for (const item of match[1].split(',')) {
-                const name = item.trim().split(/\s*:/)[0].trim();
-                if (name) {
-                    exports.add(name);
-                }
-            }
-        }
-        return exports;
+        return this.exportsByFile?.get(filePath) || new Set();
     }
     // ---------------------------------------------------------------------------
     // Function call validation
@@ -393,129 +295,6 @@ export class CodeSnippetValidator {
             suggestion: suggestions.some((s) => s.includes('→')) ? `Did you mean: ${suggestions.join(', ')}?` : null,
         };
     }
-    // ---------------------------------------------------------------------------
-    // Signature & interface indexing
-    // ---------------------------------------------------------------------------
-    indexFunctionSignatures(content, filePath, lang) {
-        if (lang === 'javascript' || lang === 'typescript') {
-            const funcPattern = /(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)/g;
-            let match;
-            while ((match = funcPattern.exec(content)) !== null) {
-                this.addSignature(match[1], match[2], filePath, lang);
-            }
-            // Arrow / const functions
-            const arrowPattern = /(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\(([^)]*)\)[^{;]*=>/g;
-            while ((match = arrowPattern.exec(content)) !== null) {
-                this.addSignature(match[1], match[2], filePath, lang);
-            }
-        }
-        if (lang === 'python') {
-            const defPattern = /def\s+(\w+)\s*\(([^)]*)\)/g;
-            let match;
-            while ((match = defPattern.exec(content)) !== null) {
-                this.addSignature(match[1], match[2], filePath, lang);
-            }
-        }
-    }
-    addSignature(name, paramsStr, filePath, lang) {
-        const { names, requiredCount } = this.parseParameters(paramsStr, lang);
-        let params = names;
-        let required = requiredCount;
-        // Strip Python self/cls
-        if (lang === 'python' && params.length > 0 && (params[0] === 'self' || params[0] === 'cls')) {
-            params = params.slice(1);
-            required = Math.max(0, required - 1);
-        }
-        const signatures = this.functionSignatures.get(name) || [];
-        if (signatures.length === 0) {
-            this.functionSignatures.set(name, signatures);
-        }
-        signatures.push({ params, requiredParams: required, filePath });
-    }
-    parseParameters(paramsStr, lang) {
-        if (!paramsStr.trim()) {
-            return { names: [], requiredCount: 0 };
-        }
-        const rawParams = [];
-        let depth = 0;
-        let current = '';
-        for (const ch of paramsStr) {
-            if ('(<[{'.includes(ch)) {
-                depth++;
-            }
-            else if (')>]}'.includes(ch)) {
-                depth--;
-            }
-            if (ch === ',' && depth === 0) {
-                rawParams.push(current.trim());
-                current = '';
-            }
-            else {
-                current += ch;
-            }
-        }
-        if (current.trim()) {
-            rawParams.push(current.trim());
-        }
-        const names = [];
-        let requiredCount = 0;
-        let seenOptional = false;
-        for (const raw of rawParams) {
-            const name = this.extractParamName(raw, lang);
-            if (!name) {
-                continue;
-            }
-            names.push(name);
-            const isOptional = this.isOptionalParam(raw, lang);
-            const isRest = raw.trim().startsWith('...') || raw.trim().startsWith('*');
-            if (!isOptional && !isRest && !seenOptional) {
-                requiredCount++;
-            }
-            else {
-                seenOptional = true;
-            }
-        }
-        return { names, requiredCount };
-    }
-    extractParamName(raw, lang) {
-        if (!raw) {
-            return null;
-        }
-        if (lang === 'typescript' || lang === 'javascript') {
-            const match = raw.match(/^(?:\.\.\.)?(\w+)/);
-            return match ? match[1] : null;
-        }
-        if (lang === 'python') {
-            const match = raw.match(/^\*{0,2}(\w+)/);
-            return match ? match[1] : null;
-        }
-        return null;
-    }
-    isOptionalParam(raw, lang) {
-        if (raw.trim().startsWith('...') || raw.trim().startsWith('*')) {
-            return true;
-        }
-        if (lang === 'typescript' || lang === 'javascript') {
-            // name? (TS optional marker right after identifier)
-            if (/^\w+\s*\?/.test(raw.trim())) {
-                return true;
-            }
-        }
-        // Default value at top level (= but not =>)
-        let depth = 0;
-        for (let i = 0; i < raw.length; i++) {
-            if ('({[<'.includes(raw[i])) {
-                depth++;
-            }
-            else if (')}]>'.includes(raw[i])) {
-                depth--;
-            }
-            if (depth === 0 && raw[i] === '=' && raw[i + 1] !== '>') {
-                return true;
-            }
-        }
-        return false;
-    }
     legacyImportSpecifiers(linkText) {
         return linkText
             ? linkText
@@ -560,78 +339,6 @@ export class CodeSnippetValidator {
         }
         return argumentNames.every((name, index) => name === parameterNames[index]);
     }
-    indexInterfaceDefinitions(content, _filePath, lang) {
-        if (lang !== 'typescript') {
-            return;
-        }
-        // interface Name { ... }
-        const ifacePattern = /(?:export\s+)?interface\s+(\w+)(?:\s+extends\s+[\w,\s<>]+)?\s*\{/g;
-        let match;
-        while ((match = ifacePattern.exec(content)) !== null) {
-            this.addInterfaceKeys(match[1], content, match.index + match[0].length - 1);
-        }
-        // type Name = { ... }
-        const typeObjPattern = /(?:export\s+)?type\s+(\w+)\s*=\s*\{/g;
-        while ((match = typeObjPattern.exec(content)) !== null) {
-            this.addInterfaceKeys(match[1], content, match.index + match[0].length - 1);
-        }
-    }
-    addInterfaceKeys(name, content, braceStart) {
-        const body = this.extractBraceContent(content, braceStart);
-        if (!body) {
-            return;
-        }
-        const keys = this.extractPropertyKeys(body);
-        if (keys.size === 0) {
-            return;
-        }
-        if (!this.interfaceKeys.has(name)) {
-            this.interfaceKeys.set(name, new Set());
-        }
-        for (const key of keys) {
-            this.interfaceKeys.get(name).add(key);
-        }
-    }
-    extractBraceContent(content, braceStart) {
-        let depth = 0;
-        for (let i = braceStart; i < content.length; i++) {
-            if (content[i] === '{') {
-                depth++;
-            }
-            else if (content[i] === '}') {
-                depth--;
-                if (depth === 0) {
-                    return content.substring(braceStart + 1, i);
-                }
-            }
-        }
-        return null;
-    }
-    extractPropertyKeys(body) {
-        const keys = new Set();
-        let depth = 0;
-        for (const line of body.split('\n')) {
-            const trimmed = line.trim();
-            if (!trimmed) {
-                continue;
-            }
-            if (depth === 0) {
-                const keyMatch = trimmed.match(/^(?:readonly\s+)?(\w+)\??\s*:/);
-                if (keyMatch) {
-                    keys.add(keyMatch[1]);
-                }
-            }
-            for (const ch of trimmed) {
-                if (ch === '{') {
-                    depth++;
-                }
-                else if (ch === '}') {
-                    depth--;
-                }
-            }
-        }
-        return keys;
-    }
     // Exposed for testing / integration
     getFunctionSignatures() {
         return this.functionSignatures;