@skillsmith/core 0.1.2 → 2.0.0

package/dist/src/analysis/router.js

@@ -0,0 +1,398 @@
+/**
+ * SMI-1303: Language Router
+ * SMI-1337: Added metrics integration
+ * SMI-1339: Added factory pattern integration
+ * SMI-1340: Added language detection for extensionless files
+ *
+ * Detects file language and dispatches to appropriate adapter.
+ * Manages adapter registry and provides unified access to framework rules.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/router
+ */
+import path from 'path';
+import { AdapterFactory } from './adapters/factory.js';
+import { getAnalysisMetrics } from './metrics.js';
+import { LanguageDetector } from './language-detector.js';
+/**
+ * Routes files to appropriate language adapters
+ *
+ * Manages a registry of language adapters and provides:
+ * - File extension to adapter mapping
+ * - Aggregated framework detection rules
+ * - Unified parsing interface
+ *
+ * @example
+ * ```typescript
+ * const router = new LanguageRouter()
+ *
+ * // Register adapters
+ * router.registerAdapter(new TypeScriptAdapter())
+ * router.registerAdapter(new PythonAdapter())
+ *
+ * // Route files to appropriate adapter
+ * const adapter = router.getAdapter('src/main.py')
+ * const result = adapter.parseFile(content, 'src/main.py')
+ * ```
+ */
+export class LanguageRouter {
+    adapters = new Map();
+    extensionMap = new Map();
+    throwOnUnsupported;
+    metrics;
+    languageDetector;
+    enableLanguageDetection;
+    constructor(options = {}) {
+        this.throwOnUnsupported = options.throwOnUnsupported ?? false;
+        this.metrics = options.metrics ?? getAnalysisMetrics();
+        this.enableLanguageDetection = options.enableLanguageDetection ?? true;
+        // Initialize language detector if enabled
+        if (this.enableLanguageDetection) {
+            this.languageDetector = new LanguageDetector({
+                minConfidence: options.detectionMinConfidence ?? 0.5,
+            });
+        }
+        else {
+            this.languageDetector = null;
+        }
+    }
+    /**
+     * Create a LanguageRouter with all adapters pre-registered
+     *
+     * Uses AdapterFactory to create adapters for all supported languages.
+     *
+     * @param options - Router options
+     * @returns Configured LanguageRouter
+     *
+     * @example
+     * ```typescript
+     * // Create router with all language adapters
+     * const router = LanguageRouter.createWithAllAdapters()
+     *
+     * // Create router with specific languages only
+     * const router2 = LanguageRouter.createWithAllAdapters({
+     *   languages: ['typescript', 'python']
+     * })
+     * ```
+     */
+    static createWithAllAdapters(options = {}) {
+        const router = new LanguageRouter(options);
+        // Determine which languages to register
+        const languages = options.languages ?? AdapterFactory.getSupportedLanguages();
+        // Create and register adapters using factory
+        const adapters = AdapterFactory.createAdapters(languages);
+        for (const adapter of adapters.values()) {
+            router.registerAdapter(adapter);
+        }
+        return router;
+    }
+    /**
+     * Create a LanguageRouter using cached adapters from factory
+     *
+     * Reuses adapter instances from the factory cache for efficiency.
+     *
+     * @param options - Router options
+     * @returns Configured LanguageRouter
+     */
+    static createWithCachedAdapters(options = {}) {
+        const router = new LanguageRouter(options);
+        // Determine which languages to register
+        const languages = options.languages ?? AdapterFactory.getSupportedLanguages();
+        // Use cached adapters from factory
+        for (const language of languages) {
+            const adapter = AdapterFactory.createCachedAdapter(language);
+            router.registerAdapter(adapter);
+        }
+        return router;
+    }
+    /**
+     * Register a language adapter
+     *
+     * The adapter's extensions are mapped for fast lookup.
+     * If an adapter for the same language exists, it is replaced.
+     *
+     * @param adapter - Adapter to register
+     *
+     * @example
+     * ```typescript
+     * router.registerAdapter(new PythonAdapter())
+     * // Now handles .py, .pyi, .pyw files
+     * ```
+     */
+    registerAdapter(adapter) {
+        // Store by language
+        const existing = this.adapters.get(adapter.language);
+        if (existing) {
+            // Remove old extension mappings
+            for (const ext of existing.extensions) {
+                this.extensionMap.delete(ext.toLowerCase());
+            }
+        }
+        this.adapters.set(adapter.language, adapter);
+        // Map extensions to adapter
+        for (const ext of adapter.extensions) {
+            this.extensionMap.set(ext.toLowerCase(), adapter);
+        }
+    }
+    /**
+     * Unregister a language adapter
+     *
+     * @param language - Language to unregister
+     * @returns True if adapter was found and removed
+     */
+    unregisterAdapter(language) {
+        const adapter = this.adapters.get(language);
+        if (!adapter)
+            return false;
+        // Remove extension mappings
+        for (const ext of adapter.extensions) {
+            this.extensionMap.delete(ext.toLowerCase());
+        }
+        this.adapters.delete(language);
+        return true;
+    }
+    /**
+     * Get adapter for a file path
+     *
+     * @param filePath - Path to the file
+     * @returns Adapter that can handle the file
+     * @throws Error if no adapter found and throwOnUnsupported is true
+     *
+     * @example
+     * ```typescript
+     * const adapter = router.getAdapter('src/main.py')
+     * // Returns PythonAdapter
+     *
+     * const adapter2 = router.getAdapter('unknown.xyz')
+     * // Throws if throwOnUnsupported, otherwise returns null
+     * ```
+     */
+    getAdapter(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        const adapter = this.extensionMap.get(ext);
+        if (!adapter) {
+            if (this.throwOnUnsupported) {
+                throw new Error(`No adapter registered for extension: ${ext}. ` +
+                    `Supported extensions: ${this.getSupportedExtensions().join(', ')}`);
+            }
+            // Return a no-op adapter for unsupported files
+            throw new Error(`No adapter registered for extension: ${ext}`);
+        }
+        return adapter;
+    }
+    /**
+     * Try to get adapter for a file path (returns null instead of throwing)
+     *
+     * SMI-1340: For extensionless files, attempts language detection
+     * from content if provided and detection is enabled.
+     *
+     * @param filePath - Path to the file
+     * @param content - Optional file content for language detection
+     * @returns Adapter or null if not supported
+     *
+     * @example
+     * ```typescript
+     * // With extension - uses extension mapping
+     * const adapter = router.tryGetAdapter('main.py')
+     *
+     * // Without extension - attempts content detection
+     * const adapter2 = router.tryGetAdapter('Makefile', 'package main\n...')
+     * ```
+     */
+    tryGetAdapter(filePath, content) {
+        const ext = path.extname(filePath).toLowerCase();
+        // Try extension-based lookup first
+        const adapter = this.extensionMap.get(ext);
+        if (adapter) {
+            return adapter;
+        }
+        // For extensionless files, try language detection if content provided
+        if (!ext && content && this.languageDetector) {
+            const detection = this.detectLanguageFromContent(content);
+            if (detection.language) {
+                return this.adapters.get(detection.language) ?? null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Detect language from file content
+     *
+     * Uses heuristics to determine the language of a file:
+     * - Shebang analysis (#!/usr/bin/python, etc.)
+     * - Content patterns (import statements, syntax markers)
+     * - Statistical keyword analysis
+     *
+     * @param content - File content to analyze
+     * @returns Detection result with language and confidence
+     *
+     * @example
+     * ```typescript
+     * const result = router.detectLanguageFromContent('#!/usr/bin/env python3\nprint("hello")')
+     * // { language: 'python', confidence: 1.0, method: 'shebang', evidence: [...] }
+     * ```
+     */
+    detectLanguageFromContent(content) {
+        if (!this.languageDetector) {
+            return {
+                language: null,
+                confidence: 0,
+                method: 'none',
+                evidence: ['Language detection disabled'],
+            };
+        }
+        return this.languageDetector.detect(content);
+    }
+    /**
+     * Try to get adapter using content detection
+     *
+     * Specifically for extensionless files where content-based
+     * detection is required.
+     *
+     * @param content - File content to analyze
+     * @returns Object with adapter and detection result
+     */
+    tryGetAdapterFromContent(content) {
+        const detection = this.detectLanguageFromContent(content);
+        if (detection.language) {
+            const adapter = this.adapters.get(detection.language) ?? null;
+            return { adapter, detection };
+        }
+        return { adapter: null, detection };
+    }
+    /**
+     * Check if a file can be handled
+     *
+     * @param filePath - Path to check
+     * @returns True if an adapter is registered for this file type
+     *
+     * @example
+     * ```typescript
+     * router.canHandle('main.py')   // true (if Python adapter registered)
+     * router.canHandle('main.xyz')  // false
+     * ```
+     */
+    canHandle(filePath) {
+        const ext = path.extname(filePath).toLowerCase();
+        return this.extensionMap.has(ext);
+    }
+    /**
+     * Get language for a file path
+     *
+     * @param filePath - Path to check
+     * @returns Language or null if not supported
+     */
+    getLanguage(filePath) {
+        const adapter = this.tryGetAdapter(filePath);
+        return adapter?.language ?? null;
+    }
+    /**
+     * Parse a file using the appropriate adapter
+     *
+     * Convenience method that combines getAdapter and parseFile.
+     * SMI-1337: Records metrics for file parsing.
+     *
+     * @param content - File content
+     * @param filePath - Path to the file
+     * @returns Parse result
+     * @throws Error if no adapter for file type
+     */
+    parseFile(content, filePath) {
+        const adapter = this.getAdapter(filePath);
+        const language = adapter.language;
+        const start = performance.now();
+        try {
+            const result = adapter.parseFile(content, filePath);
+            this.metrics.recordFileParsed(language);
+            return result;
+        }
+        catch (error) {
+            this.metrics.recordError('parse_error', language);
+            throw error;
+        }
+        finally {
+            const duration = performance.now() - start;
+            this.metrics.recordParseDuration(language, duration);
+        }
+    }
+    /**
+     * Get list of supported languages
+     *
+     * @returns Array of registered languages
+     */
+    getSupportedLanguages() {
+        return Array.from(this.adapters.keys());
+    }
+    /**
+     * Get list of supported file extensions
+     *
+     * @returns Array of extensions (with dot)
+     */
+    getSupportedExtensions() {
+        return Array.from(this.extensionMap.keys());
+    }
+    /**
+     * Get adapter for a specific language
+     *
+     * @param language - Language to get adapter for
+     * @returns Adapter or undefined if not registered
+     */
+    getAdapterByLanguage(language) {
+        return this.adapters.get(language);
+    }
+    /**
+     * Get all framework detection rules from all adapters
+     *
+     * Aggregates rules from all registered adapters for
+     * comprehensive framework detection.
+     *
+     * @returns Combined array of framework rules
+     *
+     * @example
+     * ```typescript
+     * const rules = router.getAllFrameworkRules()
+     * // Includes rules for React, Django, Gin, Actix, etc.
+     * ```
+     */
+    getAllFrameworkRules() {
+        const rules = [];
+        for (const adapter of this.adapters.values()) {
+            rules.push(...adapter.getFrameworkRules());
+        }
+        return rules;
+    }
+    /**
+     * Get framework rules for a specific language
+     *
+     * @param language - Language to get rules for
+     * @returns Framework rules or empty array
+     */
+    getFrameworkRules(language) {
+        const adapter = this.adapters.get(language);
+        return adapter?.getFrameworkRules() ?? [];
+    }
+    /**
+     * Get number of registered adapters
+     */
+    get adapterCount() {
+        return this.adapters.size;
+    }
+    /**
+     * Clean up all adapters
+     *
+     * Disposes all registered adapters and clears the registry.
+     */
+    dispose() {
+        for (const adapter of this.adapters.values()) {
+            try {
+                adapter.dispose();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        this.adapters.clear();
+        this.extensionMap.clear();
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/src/analysis/router.js.map

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

package/dist/src/analysis/tree-cache.d.ts

@@ -0,0 +1,208 @@
+/**
+ * SMI-1309: Tree Cache for Incremental Parsing
+ *
+ * LRU cache for parsed AST trees to enable fast incremental updates.
+ * Manages tree lifecycle independently from parse result caching.
+ *
+ * Tree-sitter trees hold native resources and must be explicitly
+ * deleted to free memory. This cache handles that lifecycle.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/tree-cache
+ */
+/**
+ * Cached tree entry with metadata
+ */
+export interface CachedTree {
+    /** Tree-sitter Tree object (typed as unknown for flexibility) */
+    tree: unknown;
+    /** Version number for LRU tracking */
+    version: number;
+    /** SHA-256 hash prefix of content (for validation) */
+    contentHash: string;
+    /** Timestamp when entry was created */
+    createdAt: number;
+}
+/**
+ * Cache statistics for monitoring
+ */
+export interface TreeCacheStats {
+    /** Current number of cached trees */
+    size: number;
+    /** Maximum trees allowed */
+    maxSize: number;
+    /** Hit rate (0-1) since last reset */
+    hitRate: number;
+    /** Oldest tree version in cache */
+    oldestVersion: number;
+    /** Newest tree version in cache */
+    newestVersion: number;
+}
+/**
+ * Options for TreeCache
+ */
+export interface TreeCacheOptions {
+    /** Maximum number of trees to cache (default: 100) */
+    maxTrees?: number;
+}
+/**
+ * LRU cache for parsed AST trees
+ *
+ * Manages tree-sitter tree instances with proper lifecycle handling.
+ * Trees require explicit deletion to free native memory.
+ *
+ * Separate from ParseCache because:
+ * 1. Trees have native resources requiring explicit cleanup
+ * 2. Tree reuse enables incremental parsing
+ * 3. Different eviction strategies may be optimal
+ *
+ * @example
+ * ```typescript
+ * const cache = new TreeCache({ maxTrees: 50 })
+ *
+ * // Store tree after initial parse
+ * const tree = parser.parse(content)
+ * cache.set('src/main.ts', tree, hashContent(content))
+ *
+ * // Later, check if tree is valid for incremental parse
+ * if (cache.isValid('src/main.ts', hashContent(newContent))) {
+ *   // Use cached tree as base
+ *   const oldTree = cache.get('src/main.ts')
+ *   oldTree.edit(editInfo)
+ *   const newTree = parser.parse(newContent, oldTree)
+ * }
+ *
+ * // Cleanup
+ * cache.dispose()
+ * ```
+ */
+export declare class TreeCache {
+    private trees;
+    private readonly maxTrees;
+    private version;
+    private hits;
+    private misses;
+    constructor(options?: TreeCacheOptions);
+    /**
+     * Get cached tree for a file
+     *
+     * Returns null if no tree is cached for the path.
+     * Updates hit/miss statistics.
+     *
+     * @param filePath - Path to look up
+     * @returns Cached tree or null
+     */
+    get(filePath: string): unknown | null;
+    /**
+     * Get full cache entry with metadata
+     *
+     * @param filePath - Path to look up
+     * @returns Full cache entry or undefined
+     */
+    getEntry(filePath: string): CachedTree | undefined;
+    /**
+     * Check if cached tree is valid for content
+     *
+     * Compares content hash to detect if the cached tree
+     * can be used as a base for incremental parsing.
+     *
+     * @param filePath - Path to check
+     * @param contentHash - Hash of current content
+     * @returns True if tree matches content
+     */
+    isValid(filePath: string, contentHash: string): boolean;
+    /**
+     * Get version number for a cached tree
+     *
+     * @param filePath - Path to look up
+     * @returns Version number or null if not cached
+     */
+    getVersion(filePath: string): number | null;
+    /**
+     * Store a tree in cache
+     *
+     * Evicts oldest entry if at capacity.
+     * Properly deletes existing tree before replacement.
+     *
+     * @param filePath - File path as cache key
+     * @param tree - Tree-sitter tree to cache
+     * @param contentHash - Hash of content tree was parsed from
+     */
+    set(filePath: string, tree: unknown, contentHash: string): void;
+    /**
+     * Invalidate cached tree for a file
+     *
+     * Deletes tree to free native memory.
+     *
+     * @param filePath - Path to invalidate
+     */
+    invalidate(filePath: string): void;
+    /**
+     * Invalidate multiple files
+     *
+     * @param filePaths - Paths to invalidate
+     */
+    invalidateMany(filePaths: string[]): void;
+    /**
+     * Invalidate files matching a pattern
+     *
+     * @param pattern - Regex pattern to match file paths
+     * @returns Number of entries invalidated
+     */
+    invalidatePattern(pattern: RegExp): number;
+    /**
+     * Check if a file has a cached tree
+     *
+     * @param filePath - Path to check
+     * @returns True if tree is cached
+     */
+    has(filePath: string): boolean;
+    /**
+     * Get current cache size
+     */
+    get size(): number;
+    /**
+     * Get cache statistics
+     *
+     * @returns Current cache statistics
+     */
+    getStats(): TreeCacheStats;
+    /**
+     * Reset hit/miss counters
+     */
+    resetStats(): void;
+    /**
+     * Clear all cached trees
+     *
+     * Properly deletes all trees to free native resources.
+     */
+    clear(): void;
+    /**
+     * Dispose of cache and free all resources
+     *
+     * Call this when the cache is no longer needed.
+     */
+    dispose(): void;
+    /**
+     * Get list of all cached file paths
+     */
+    keys(): string[];
+    /**
+     * Hash content for cache validation
+     *
+     * @param content - Content to hash
+     * @returns SHA-256 hash prefix (16 chars)
+     */
+    static hashContent(content: string): string;
+    /**
+     * Evict the oldest entry from cache
+     */
+    private evictOldest;
+    /**
+     * Safely delete a tree object
+     *
+     * Handles trees that may or may not have a delete method.
+     */
+    private deleteTree;
+}
+//# sourceMappingURL=tree-cache.d.ts.map

package/dist/src/analysis/tree-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-cache.d.ts","sourceRoot":"","sources":["../../../src/analysis/tree-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAA;IACb,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;gBAEN,OAAO,GAAE,gBAAqB;IAI1C;;;;;;;;OAQG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAUrC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIlD;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAKvD;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;;;;;;;OASG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAqB/D;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQlC;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAMzC;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAW1C;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,QAAQ,IAAI,cAAc;IAmB1B;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;;OAIG;IACH,KAAK,IAAI,IAAI;IASb;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAYnB"}