@skillsmith/core 0.2.0 → 2.0.0

package/dist/src/analysis/file-streamer.js

@@ -0,0 +1,291 @@
+/**
+ * SMI-1308: File Streamer
+ *
+ * Memory-efficient file reading with streaming support for large files.
+ * Provides generators for processing files without loading all into memory.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/file-streamer
+ */
+import fs from 'fs/promises';
+import { createReadStream } from 'fs';
+/**
+ * Stream files with memory-efficient chunking
+ *
+ * Uses async generators to process files one at a time,
+ * avoiding loading all file contents into memory.
+ *
+ * @param filePaths - Array of file paths to stream
+ * @param options - Streaming options
+ * @yields FileContent objects
+ *
+ * @example
+ * ```typescript
+ * for await (const file of streamFiles(paths, { maxBufferSize: 512 * 1024 })) {
+ *   console.log(`${file.path}: ${file.lineCount} lines`)
+ *   // Process file.content...
+ * }
+ * ```
+ */
+export async function* streamFiles(filePaths, options = {}) {
+    const { maxBufferSize = 1024 * 1024, skipLargeFiles = true, includeBinary = false } = options;
+    for (const filePath of filePaths) {
+        try {
+            const stat = await fs.stat(filePath);
+            // Skip directories
+            if (stat.isDirectory()) {
+                continue;
+            }
+            // Handle large files
+            if (stat.size > maxBufferSize) {
+                if (skipLargeFiles) {
+                    // Skip files larger than buffer (likely generated/minified)
+                    continue;
+                }
+                // Stream large files (read only first chunk)
+                yield* streamLargeFile(filePath, maxBufferSize);
+                continue;
+            }
+            // Read small files directly
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Skip binary files unless requested
+            if (!includeBinary && isBinaryContent(content)) {
+                continue;
+            }
+            yield {
+                path: filePath,
+                content,
+                size: stat.size,
+                lineCount: countLines(content),
+            };
+        }
+        catch {
+            // Skip files that can't be read (permissions, symlinks, etc.)
+            continue;
+        }
+    }
+}
+/**
+ * Stream a large file in chunks
+ *
+ * Reads only the first chunk of the file for analysis.
+ * Large files are often generated or minified, so we only
+ * need the beginning for pattern detection.
+ *
+ * @param filePath - Path to the large file
+ * @param maxBufferSize - Maximum bytes to read
+ * @yields Single FileContent with truncated content
+ */
+async function* streamLargeFile(filePath, maxBufferSize) {
+    const content = await new Promise((resolve, reject) => {
+        const chunks = [];
+        let totalSize = 0;
+        const stream = createReadStream(filePath, {
+            highWaterMark: Math.min(maxBufferSize, 64 * 1024), // 64KB chunks
+        });
+        stream.on('data', (chunk) => {
+            const buffer = typeof chunk === 'string' ? Buffer.from(chunk) : chunk;
+            if (totalSize < maxBufferSize) {
+                chunks.push(buffer);
+                totalSize += buffer.length;
+            }
+            if (totalSize >= maxBufferSize) {
+                stream.destroy();
+            }
+        });
+        stream.on('end', () => {
+            resolve(Buffer.concat(chunks).toString('utf-8'));
+        });
+        stream.on('error', reject);
+        stream.on('close', () => {
+            resolve(Buffer.concat(chunks).toString('utf-8'));
+        });
+    });
+    const stat = await fs.stat(filePath);
+    const actualSize = Math.min(stat.size, maxBufferSize);
+    yield {
+        path: filePath,
+        content,
+        size: actualSize,
+        lineCount: countLines(content),
+        truncated: stat.size > maxBufferSize,
+    };
+}
+/**
+ * Batch file reading with concurrency control
+ *
+ * Reads multiple files concurrently with a configurable limit
+ * to balance speed and memory usage.
+ *
+ * @param filePaths - Array of file paths to read
+ * @param options - Batch reading options
+ * @returns Array of file contents
+ *
+ * @example
+ * ```typescript
+ * const files = await batchReadFiles(paths, {
+ *   concurrency: 20,
+ *   maxFileSize: 512 * 1024
+ * })
+ *
+ * console.log(`Read ${files.length} files`)
+ * ```
+ */
+export async function batchReadFiles(filePaths, options = {}) {
+    const { concurrency = 10, maxFileSize = 1024 * 1024, skipErrors = true } = options;
+    const results = [];
+    // Process in batches
+    for (let i = 0; i < filePaths.length; i += concurrency) {
+        const batch = filePaths.slice(i, i + concurrency);
+        const batchResults = await Promise.all(batch.map(async (filePath) => {
+            try {
+                const stat = await fs.stat(filePath);
+                // Skip directories and large files
+                if (stat.isDirectory() || stat.size > maxFileSize) {
+                    return null;
+                }
+                const content = await fs.readFile(filePath, 'utf-8');
+                // Skip binary content
+                if (isBinaryContent(content)) {
+                    return null;
+                }
+                return {
+                    path: filePath,
+                    content,
+                    size: stat.size,
+                    lineCount: countLines(content),
+                };
+            }
+            catch (error) {
+                if (skipErrors) {
+                    return null;
+                }
+                throw error;
+            }
+        }));
+        for (const result of batchResults) {
+            if (result) {
+                results.push(result);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Read files as a map for quick lookup
+ *
+ * @param filePaths - Array of file paths to read
+ * @param options - Batch reading options
+ * @returns Map of path to file content
+ *
+ * @example
+ * ```typescript
+ * const fileMap = await readFilesAsMap(paths)
+ * const content = fileMap.get('src/index.ts')
+ * ```
+ */
+export async function readFilesAsMap(filePaths, options = {}) {
+    const files = await batchReadFiles(filePaths, options);
+    const map = new Map();
+    for (const file of files) {
+        map.set(file.path, file);
+    }
+    return map;
+}
+/**
+ * Count lines in content
+ *
+ * @param content - File content
+ * @returns Number of lines
+ */
+function countLines(content) {
+    if (!content)
+        return 0;
+    let count = 1;
+    for (let i = 0; i < content.length; i++) {
+        if (content[i] === '\n') {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Check if content appears to be binary
+ *
+ * Detects binary content by looking for null bytes
+ * in the first 8KB of the file.
+ *
+ * @param content - Content to check
+ * @returns True if content appears binary
+ */
+function isBinaryContent(content) {
+    // Check first 8KB for null bytes
+    const checkLength = Math.min(content.length, 8192);
+    for (let i = 0; i < checkLength; i++) {
+        if (content.charCodeAt(i) === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Get file extension
+ *
+ * @param filePath - File path
+ * @returns Extension including dot, or empty string
+ */
+export function getFileExtension(filePath) {
+    const lastDot = filePath.lastIndexOf('.');
+    const lastSep = Math.max(filePath.lastIndexOf('/'), filePath.lastIndexOf('\\'));
+    if (lastDot > lastSep && lastDot > 0) {
+        return filePath.slice(lastDot).toLowerCase();
+    }
+    return '';
+}
+/**
+ * Filter paths by extension
+ *
+ * @param filePaths - Array of file paths
+ * @param extensions - Extensions to include (with dot)
+ * @returns Filtered paths
+ *
+ * @example
+ * ```typescript
+ * const tsPaths = filterByExtension(allPaths, ['.ts', '.tsx'])
+ * ```
+ */
+export function filterByExtension(filePaths, extensions) {
+    const extSet = new Set(extensions.map((e) => e.toLowerCase()));
+    return filePaths.filter((p) => extSet.has(getFileExtension(p)));
+}
+/**
+ * Estimate memory usage for files
+ *
+ * Provides rough estimate based on file sizes.
+ *
+ * @param filePaths - Array of file paths
+ * @returns Estimated memory usage in bytes
+ *
+ * @example
+ * ```typescript
+ * const estimate = await estimateMemoryUsage(paths)
+ * console.log(`Estimated: ${MemoryMonitor.formatBytes(estimate)}`)
+ * ```
+ */
+export async function estimateMemoryUsage(filePaths) {
+    let total = 0;
+    for (const filePath of filePaths) {
+        try {
+            const stat = await fs.stat(filePath);
+            if (stat.isFile()) {
+                // Rough estimate: content + metadata overhead
+                total += stat.size + 200;
+            }
+        }
+        catch {
+            // Skip files that can't be stat'd
+        }
+    }
+    return total;
+}
+//# sourceMappingURL=file-streamer.js.map

package/dist/src/analysis/file-streamer.js.map

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

package/dist/src/analysis/incremental-parser.d.ts

@@ -0,0 +1,186 @@
+/**
+ * SMI-1309: Incremental Parser Coordinator
+ *
+ * Coordinates incremental parsing across language adapters.
+ * Uses tree caching to enable fast re-parsing when only
+ * small portions of files change.
+ *
+ * Performance target: < 100ms for incremental parse
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/incremental-parser
+ */
+import { TreeCache, type TreeCacheStats } from './tree-cache.js';
+import { type FileEdit } from './incremental.js';
+import type { ParseResult } from './types.js';
+import type { LanguageAdapter } from './adapters/base.js';
+/**
+ * Result of an incremental parse operation
+ */
+export interface IncrementalParseResult {
+    /** The parse result (imports, exports, functions) */
+    result: ParseResult;
+    /** True if incremental parsing was used */
+    wasIncremental: boolean;
+    /** Parse duration in milliseconds */
+    durationMs: number;
+    /** True if result came from cache */
+    wasCached: boolean;
+}
+/**
+ * Options for IncrementalParser
+ */
+export interface IncrementalParserOptions {
+    /** Maximum trees to cache (default: 100) */
+    maxTrees?: number;
+    /** Enable content caching for unchanged files */
+    cacheContent?: boolean;
+}
+/**
+ * Statistics for incremental parser
+ */
+export interface IncrementalParserStats {
+    /** Tree cache statistics */
+    treeCache: TreeCacheStats;
+    /** Number of files with cached content */
+    contentCacheSize: number;
+    /** Total incremental parses performed */
+    incrementalParses: number;
+    /** Total full parses performed */
+    fullParses: number;
+    /** Average incremental parse time in ms */
+    avgIncrementalTimeMs: number;
+    /** Average full parse time in ms */
+    avgFullTimeMs: number;
+}
+/**
+ * Incremental parsing coordinator
+ *
+ * Manages tree caching and content tracking to enable efficient
+ * incremental parsing when files change.
+ *
+ * Flow:
+ * 1. Check if content unchanged (return cached result)
+ * 2. Check if previous tree exists for incremental parse
+ * 3. Calculate edit between old and new content
+ * 4. Apply edit to tree and re-parse incrementally
+ * 5. Cache new tree for future updates
+ *
+ * @example
+ * ```typescript
+ * const parser = new IncrementalParser({ maxTrees: 50 })
+ * const adapter = new TypeScriptAdapter()
+ *
+ * // First parse (full)
+ * const result1 = parser.parse('src/main.ts', content1, adapter)
+ * console.log(result1.wasIncremental) // false
+ *
+ * // Second parse with small change (incremental)
+ * const result2 = parser.parse('src/main.ts', content2, adapter)
+ * console.log(result2.wasIncremental) // true
+ * console.log(result2.durationMs) // < 100ms
+ *
+ * // Cleanup
+ * parser.dispose()
+ * ```
+ */
+export declare class IncrementalParser {
+    private readonly treeCache;
+    private readonly contentCache;
+    private readonly cacheContent;
+    private incrementalParses;
+    private fullParses;
+    private totalIncrementalTime;
+    private totalFullTime;
+    constructor(options?: IncrementalParserOptions);
+    /**
+     * Parse file, using incremental parsing if possible
+     *
+     * Automatically determines whether to use incremental or
+     * full parsing based on cached state.
+     *
+     * @param filePath - Path to the file
+     * @param content - Current file content
+     * @param adapter - Language adapter for parsing
+     * @returns Parse result with metadata
+     */
+    parse(filePath: string, content: string, adapter: LanguageAdapter): IncrementalParseResult;
+    /**
+     * Parse file with explicit edit information
+     *
+     * Use this when edit information is already available
+     * (e.g., from an editor's change event).
+     *
+     * @param filePath - Path to the file
+     * @param content - Current file content
+     * @param adapter - Language adapter
+     * @param edit - Edit information
+     * @returns Parse result with metadata
+     */
+    parseWithEdit(filePath: string, content: string, adapter: LanguageAdapter, edit: FileEdit): IncrementalParseResult;
+    /**
+     * Invalidate cache for file(s)
+     *
+     * Call this when files are deleted or externally modified.
+     *
+     * @param filePaths - Path or paths to invalidate
+     */
+    invalidate(filePaths: string | string[]): void;
+    /**
+     * Invalidate files matching a pattern
+     *
+     * @param pattern - Regex to match file paths
+     * @returns Number of entries invalidated
+     */
+    invalidatePattern(pattern: RegExp): number;
+    /**
+     * Check if a file is cached
+     *
+     * @param filePath - Path to check
+     * @returns True if content and/or tree is cached
+     */
+    isCached(filePath: string): boolean;
+    /**
+     * Get cache statistics
+     */
+    getStats(): IncrementalParserStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Clear all caches
+     */
+    clear(): void;
+    /**
+     * Dispose of all resources
+     *
+     * Call this when the parser is no longer needed.
+     */
+    dispose(): void;
+    /**
+     * Get the underlying tree cache (for advanced use)
+     */
+    getTreeCache(): TreeCache;
+    /**
+     * Perform incremental parse
+     */
+    private doIncrementalParse;
+    /**
+     * Perform full parse
+     */
+    private doFullParse;
+    /**
+     * Record incremental parse statistics
+     */
+    private recordIncremental;
+    /**
+     * Record full parse statistics
+     */
+    private recordFull;
+    /**
+     * Hash content for cache validation
+     */
+    private hashContent;
+}
+//# sourceMappingURL=incremental-parser.d.ts.map

package/dist/src/analysis/incremental-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incremental-parser.d.ts","sourceRoot":"","sources":["../../../src/analysis/incremental-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAkC,KAAK,QAAQ,EAAiB,MAAM,kBAAkB,CAAA;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,MAAM,EAAE,WAAW,CAAA;IACnB,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAA;IACvB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,SAAS,EAAE,cAAc,CAAA;IACzB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAA;IACzB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,oBAAoB,CAAI;IAChC,OAAO,CAAC,aAAa,CAAI;gBAEb,OAAO,GAAE,wBAA6B;IAMlD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,sBAAsB;IA6C1F;;;;;;;;;;;OAWG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,QAAQ,GACb,sBAAsB;IAiCzB;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAQ9C;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAW1C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,QAAQ,IAAI,sBAAsB;IAYlC;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,WAAW;CAGpB"}