@skillsmith/core 0.1.2 → 2.0.0

package/dist/src/analysis/parsers.js

@@ -0,0 +1,219 @@
+/**
+ * SMI-600: Source File Parsers
+ * SMI-1189: Extracted from CodebaseAnalyzer.ts
+ *
+ * Functions for parsing TypeScript/JavaScript source files
+ * and extracting imports, exports, and functions.
+ */
+import * as ts from 'typescript';
+/**
+ * Parse a single file and extract information
+ *
+ * @param content - File content to parse
+ * @param relativePath - Relative path for source file tracking
+ * @returns Parsed imports, exports, and functions
+ */
+export function parseFile(content, relativePath) {
+    const imports = [];
+    const exports = [];
+    const functions = [];
+    // Create source file
+    const sourceFile = ts.createSourceFile(relativePath, content, ts.ScriptTarget.Latest, true, relativePath.endsWith('.tsx') || relativePath.endsWith('.jsx')
+        ? ts.ScriptKind.TSX
+        : ts.ScriptKind.TS);
+    // Walk the AST
+    const visit = (node) => {
+        // Import declarations
+        if (ts.isImportDeclaration(node)) {
+            const importInfo = extractImport(node, relativePath);
+            if (importInfo) {
+                imports.push(importInfo);
+            }
+        }
+        // Export declarations
+        if (ts.isExportDeclaration(node) || ts.isExportAssignment(node)) {
+            const exportInfos = extractExport(node, relativePath);
+            exports.push(...exportInfos);
+        }
+        // Function declarations
+        if (ts.isFunctionDeclaration(node) && node.name) {
+            const funcInfo = extractFunction(node, relativePath, sourceFile);
+            if (funcInfo) {
+                functions.push(funcInfo);
+                // Also track as export if exported
+                if (funcInfo.isExported) {
+                    const isDefault = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.DefaultKeyword);
+                    exports.push({
+                        name: node.name.text,
+                        kind: 'function',
+                        isDefault: isDefault ?? false,
+                        sourceFile: relativePath,
+                    });
+                }
+            }
+        }
+        // Arrow functions assigned to variables
+        if (ts.isVariableStatement(node)) {
+            for (const decl of node.declarationList.declarations) {
+                if (decl.initializer &&
+                    ts.isArrowFunction(decl.initializer) &&
+                    ts.isIdentifier(decl.name)) {
+                    const isExported = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+                    const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+                    functions.push({
+                        name: decl.name.text,
+                        parameterCount: decl.initializer.parameters.length,
+                        isAsync: decl.initializer.modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) ??
+                            false,
+                        isExported: isExported ?? false,
+                        sourceFile: relativePath,
+                        line: line + 1,
+                    });
+                    // Also track as export if exported
+                    if (isExported) {
+                        exports.push({
+                            name: decl.name.text,
+                            kind: 'function',
+                            isDefault: false,
+                            sourceFile: relativePath,
+                        });
+                    }
+                }
+            }
+        }
+        // Class declarations
+        if (ts.isClassDeclaration(node) && node.name) {
+            const isExported = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+            const isDefault = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.DefaultKeyword);
+            if (isExported) {
+                exports.push({
+                    name: node.name.text,
+                    kind: 'class',
+                    isDefault: isDefault ?? false,
+                    sourceFile: relativePath,
+                });
+            }
+        }
+        // Interface declarations
+        if (ts.isInterfaceDeclaration(node)) {
+            const isExported = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+            if (isExported) {
+                exports.push({
+                    name: node.name.text,
+                    kind: 'interface',
+                    isDefault: false,
+                    sourceFile: relativePath,
+                });
+            }
+        }
+        // Type alias declarations
+        if (ts.isTypeAliasDeclaration(node)) {
+            const isExported = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+            if (isExported) {
+                exports.push({
+                    name: node.name.text,
+                    kind: 'type',
+                    isDefault: false,
+                    sourceFile: relativePath,
+                });
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return { imports, exports, functions };
+}
+/**
+ * Extract import information from an import declaration
+ *
+ * @param node - Import declaration node
+ * @param sourceFile - Source file path
+ * @returns Import info or null if invalid
+ */
+export function extractImport(node, sourceFile) {
+    const moduleSpecifier = node.moduleSpecifier;
+    if (!ts.isStringLiteral(moduleSpecifier)) {
+        return null;
+    }
+    const importInfo = {
+        module: moduleSpecifier.text,
+        namedImports: [],
+        isTypeOnly: node.importClause?.isTypeOnly ?? false,
+        sourceFile,
+    };
+    const importClause = node.importClause;
+    if (importClause) {
+        // Default import
+        if (importClause.name) {
+            importInfo.defaultImport = importClause.name.text;
+        }
+        // Named imports
+        const namedBindings = importClause.namedBindings;
+        if (namedBindings) {
+            if (ts.isNamespaceImport(namedBindings)) {
+                importInfo.namespaceImport = namedBindings.name.text;
+            }
+            else if (ts.isNamedImports(namedBindings)) {
+                for (const element of namedBindings.elements) {
+                    importInfo.namedImports.push(element.name.text);
+                }
+            }
+        }
+    }
+    return importInfo;
+}
+/**
+ * Extract export information from an export declaration
+ *
+ * @param node - Export declaration or assignment node
+ * @param sourceFile - Source file path
+ * @returns Array of export info
+ */
+export function extractExport(node, sourceFile) {
+    const exports = [];
+    if (ts.isExportAssignment(node)) {
+        // export default X
+        exports.push({
+            name: 'default',
+            kind: 'unknown',
+            isDefault: true,
+            sourceFile,
+        });
+    }
+    else if (node.exportClause && ts.isNamedExports(node.exportClause)) {
+        // export { X, Y }
+        for (const element of node.exportClause.elements) {
+            exports.push({
+                name: element.name.text,
+                kind: 'unknown',
+                isDefault: false,
+                sourceFile,
+            });
+        }
+    }
+    return exports;
+}
+/**
+ * Extract function information from a function declaration
+ *
+ * @param node - Function declaration node
+ * @param relativePath - Relative file path
+ * @param sourceFile - Source file for position lookup
+ * @returns Function info or null if no name
+ */
+export function extractFunction(node, relativePath, sourceFile) {
+    if (!node.name)
+        return null;
+    const isExported = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword);
+    const isAsync = node.modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword);
+    const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
+    return {
+        name: node.name.text,
+        parameterCount: node.parameters.length,
+        isAsync: isAsync ?? false,
+        isExported: isExported ?? false,
+        sourceFile: relativePath,
+        line: line + 1,
+    };
+}
+//# sourceMappingURL=parsers.js.map

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

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

package/dist/src/analysis/router.d.ts

@@ -0,0 +1,264 @@
+/**
+ * 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 type { LanguageAdapter } from './adapters/base.js';
+import type { SupportedLanguage, FrameworkRule, ParseResult } from './types.js';
+import { type AnalysisMetrics } from './metrics.js';
+import { type LanguageDetectionResult } from './language-detector.js';
+/**
+ * Options for LanguageRouter
+ */
+export interface LanguageRouterOptions {
+    /** Whether to throw on unsupported files (default: false) */
+    throwOnUnsupported?: boolean;
+    /** Custom metrics instance (uses default if not provided) */
+    metrics?: AnalysisMetrics;
+    /** Languages to register adapters for (default: all) */
+    languages?: SupportedLanguage[];
+    /** Enable language detection for extensionless files (default: true) */
+    enableLanguageDetection?: boolean;
+    /** Minimum confidence for language detection (default: 0.5) */
+    detectionMinConfidence?: number;
+}
+/**
+ * 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 declare class LanguageRouter {
+    private adapters;
+    private extensionMap;
+    private readonly throwOnUnsupported;
+    private readonly metrics;
+    private readonly languageDetector;
+    private readonly enableLanguageDetection;
+    constructor(options?: LanguageRouterOptions);
+    /**
+     * 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?: LanguageRouterOptions): LanguageRouter;
+    /**
+     * 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?: LanguageRouterOptions): LanguageRouter;
+    /**
+     * 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: LanguageAdapter): void;
+    /**
+     * Unregister a language adapter
+     *
+     * @param language - Language to unregister
+     * @returns True if adapter was found and removed
+     */
+    unregisterAdapter(language: SupportedLanguage): boolean;
+    /**
+     * 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: string): LanguageAdapter;
+    /**
+     * 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: string, content?: string): LanguageAdapter | 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: string): LanguageDetectionResult;
+    /**
+     * 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: string): {
+        adapter: LanguageAdapter | null;
+        detection: LanguageDetectionResult;
+    };
+    /**
+     * 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: string): boolean;
+    /**
+     * Get language for a file path
+     *
+     * @param filePath - Path to check
+     * @returns Language or null if not supported
+     */
+    getLanguage(filePath: string): SupportedLanguage | 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: string, filePath: string): ParseResult;
+    /**
+     * Get list of supported languages
+     *
+     * @returns Array of registered languages
+     */
+    getSupportedLanguages(): SupportedLanguage[];
+    /**
+     * Get list of supported file extensions
+     *
+     * @returns Array of extensions (with dot)
+     */
+    getSupportedExtensions(): string[];
+    /**
+     * Get adapter for a specific language
+     *
+     * @param language - Language to get adapter for
+     * @returns Adapter or undefined if not registered
+     */
+    getAdapterByLanguage(language: SupportedLanguage): LanguageAdapter | undefined;
+    /**
+     * 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(): FrameworkRule[];
+    /**
+     * Get framework rules for a specific language
+     *
+     * @param language - Language to get rules for
+     * @returns Framework rules or empty array
+     */
+    getFrameworkRules(language: SupportedLanguage): FrameworkRule[];
+    /**
+     * Get number of registered adapters
+     */
+    get adapterCount(): number;
+    /**
+     * Clean up all adapters
+     *
+     * Disposes all registered adapters and clears the registry.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/src/analysis/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/analysis/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC/E,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAEvF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,wDAAwD;IACxD,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC/B,wEAAwE;IACxE,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,+DAA+D;IAC/D,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;gBAErC,OAAO,GAAE,qBAA0B;IAe/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc;IAejF;;;;;;;OAOG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc;IAepF;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAkB/C;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAavD;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IAkB7C;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAoBzE;;;;;;;;;;;;;;;;OAgBG;IACH,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB;IAanE;;;;;;;;OAQG;IACH,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG;QACzC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;QAC/B,SAAS,EAAE,uBAAuB,CAAA;KACnC;IAWD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKpC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAKvD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAkBzD;;;;OAIG;IACH,qBAAqB,IAAI,iBAAiB,EAAE;IAI5C;;;;OAIG;IACH,sBAAsB,IAAI,MAAM,EAAE;IAIlC;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,eAAe,GAAG,SAAS;IAI9E;;;;;;;;;;;;;OAaG;IACH,oBAAoB,IAAI,aAAa,EAAE;IAUvC;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,EAAE;IAK/D;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAWhB"}