@skillsmith/core 0.2.0 → 2.0.0

package/dist/src/analysis/adapters/python.js

@@ -0,0 +1,475 @@
+/**
+ * SMI-1304: Python Language Adapter
+ *
+ * Parses Python source files (.py, .pyi, .pyw) and extracts
+ * imports, exports, and function definitions using regex-based
+ * parsing with optional tree-sitter support for incremental parsing.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ */
+import { LanguageAdapter } from './base.js';
+/**
+ * Python adapter using regex-based parsing with optional tree-sitter
+ *
+ * The adapter provides:
+ * - Synchronous regex-based parsing for basic analysis
+ * - Async tree-sitter parsing for enhanced accuracy (when available)
+ * - Framework detection rules for Django, FastAPI, Flask, etc.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new PythonAdapter()
+ *
+ * const result = adapter.parseFile(`
+ *   import os
+ *   from django.http import HttpResponse
+ *
+ *   def hello(request):
+ *       return HttpResponse("Hello")
+ * `, 'views.py')
+ *
+ * console.log(result.imports)  // [{ module: 'os', ... }, { module: 'django.http', ... }]
+ * console.log(result.functions)  // [{ name: 'hello', ... }]
+ * ```
+ */
+export class PythonAdapter extends LanguageAdapter {
+    language = 'python';
+    extensions = ['.py', '.pyi', '.pyw'];
+    parser = null;
+    parserInitialized = false;
+    parserInitPromise = null;
+    /**
+     * Initialize the tree-sitter parser (lazy loaded)
+     *
+     * This method is called automatically when using parseFileAsync.
+     * Tree-sitter provides more accurate parsing but requires WASM modules.
+     */
+    async initParser() {
+        if (this.parserInitialized)
+            return;
+        if (this.parserInitPromise)
+            return this.parserInitPromise;
+        this.parserInitPromise = this.doInitParser();
+        await this.parserInitPromise;
+    }
+    async doInitParser() {
+        try {
+            // Lazy load web-tree-sitter (optional dependency)
+            // @ts-expect-error - Optional dependency, may not have type declarations
+            const treeSitterModule = await import('web-tree-sitter').catch(() => null);
+            if (!treeSitterModule) {
+                // Tree-sitter not available, will use regex fallback
+                this.parserInitialized = false;
+                return;
+            }
+            const Parser = treeSitterModule.default;
+            await Parser.init();
+            this.parser = new Parser();
+            // Load Python language WASM
+            // Note: The WASM file path would need to be provided via configuration
+            // For now, we use a relative path that works in typical setups
+            const wasmPath = 'tree-sitter-python.wasm';
+            const Python = await Parser.Language.load(wasmPath);
+            this.parser.setLanguage(Python);
+            this.parserInitialized = true;
+        }
+        catch (error) {
+            // Tree-sitter not available, will use regex fallback
+            console.warn('[PythonAdapter] tree-sitter initialization failed, using regex fallback:', error instanceof Error ? error.message : String(error));
+            this.parserInitialized = false;
+        }
+    }
+    /**
+     * Parse a Python file using regex-based parsing
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file (for source tracking)
+     * @returns Parsed imports, exports, and functions
+     */
+    parseFile(content, filePath) {
+        return this.parseWithRegex(content, filePath);
+    }
+    /**
+     * Parse a Python file asynchronously with tree-sitter (if available)
+     *
+     * Falls back to regex parsing if tree-sitter is not available.
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file (for source tracking)
+     * @returns Promise resolving to parsed imports, exports, and functions
+     */
+    async parseFileAsync(content, filePath) {
+        if (!this.parserInitialized && !this.parserInitPromise) {
+            await this.initParser();
+        }
+        else if (this.parserInitPromise) {
+            await this.parserInitPromise;
+        }
+        if (this.parser && this.parserInitialized) {
+            return this.parseWithTreeSitter(content, filePath);
+        }
+        return this.parseWithRegex(content, filePath);
+    }
+    /**
+     * Parse file incrementally using previous parse tree
+     *
+     * Currently falls back to full regex parsing. Tree-sitter
+     * incremental parsing will be implemented in SMI-1309.
+     *
+     * @param content - Updated Python source code
+     * @param filePath - Path to the file
+     * @param _previousTree - Previous parse tree (not yet used)
+     * @returns Parsed imports, exports, and functions
+     */
+    parseIncremental(content, filePath, _previousTree) {
+        // TODO: SMI-1309 - Implement incremental parsing with tree-sitter
+        return this.parseFile(content, filePath);
+    }
+    /**
+     * Get Python framework detection rules
+     *
+     * Detects common Python frameworks and libraries including:
+     * - Web frameworks: Django, FastAPI, Flask
+     * - Testing: pytest
+     * - Data science: pandas, numpy
+     * - Databases: SQLAlchemy
+     * - Task queues: Celery
+     *
+     * @returns Array of framework detection rules
+     */
+    getFrameworkRules() {
+        return [
+            {
+                name: 'Django',
+                depIndicators: ['django', 'Django'],
+                importIndicators: ['django', 'django.db', 'django.http', 'django.views', 'django.urls'],
+            },
+            {
+                name: 'FastAPI',
+                depIndicators: ['fastapi'],
+                importIndicators: ['fastapi', 'starlette', 'pydantic'],
+            },
+            {
+                name: 'Flask',
+                depIndicators: ['flask', 'Flask'],
+                importIndicators: ['flask', 'flask_restful', 'flask_sqlalchemy'],
+            },
+            {
+                name: 'pytest',
+                depIndicators: ['pytest'],
+                importIndicators: ['pytest', 'pytest_asyncio', '_pytest'],
+            },
+            {
+                name: 'pandas',
+                depIndicators: ['pandas'],
+                importIndicators: ['pandas', 'pd'],
+            },
+            {
+                name: 'numpy',
+                depIndicators: ['numpy'],
+                importIndicators: ['numpy', 'np'],
+            },
+            {
+                name: 'SQLAlchemy',
+                depIndicators: ['sqlalchemy', 'SQLAlchemy'],
+                importIndicators: ['sqlalchemy', 'sqlalchemy.orm', 'sqlalchemy.ext'],
+            },
+            {
+                name: 'Celery',
+                depIndicators: ['celery'],
+                importIndicators: ['celery', 'celery.task'],
+            },
+            {
+                name: 'Requests',
+                depIndicators: ['requests'],
+                importIndicators: ['requests'],
+            },
+            {
+                name: 'aiohttp',
+                depIndicators: ['aiohttp'],
+                importIndicators: ['aiohttp'],
+            },
+            {
+                name: 'Scrapy',
+                depIndicators: ['scrapy'],
+                importIndicators: ['scrapy'],
+            },
+            {
+                name: 'TensorFlow',
+                depIndicators: ['tensorflow', 'tensorflow-gpu'],
+                importIndicators: ['tensorflow', 'tf'],
+            },
+            {
+                name: 'PyTorch',
+                depIndicators: ['torch', 'pytorch'],
+                importIndicators: ['torch', 'torch.nn', 'torchvision'],
+            },
+        ];
+    }
+    /**
+     * Clean up resources
+     */
+    dispose() {
+        if (this.parser && typeof this.parser.delete === 'function') {
+            ;
+            this.parser.delete();
+        }
+        this.parser = null;
+        this.parserInitialized = false;
+        this.parserInitPromise = null;
+    }
+    // ============================================================
+    // Private parsing methods
+    // ============================================================
+    /**
+     * Parse Python source code using regex patterns
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file
+     * @returns Parsed result
+     */
+    parseWithRegex(content, filePath) {
+        const imports = this.extractImports(content, filePath);
+        const exports = this.extractExports(content, filePath);
+        const functions = this.extractFunctions(content, filePath);
+        return { imports, exports, functions };
+    }
+    /**
+     * Extract imports from Python source code
+     *
+     * Handles:
+     * - `import module`
+     * - `import module as alias`
+     * - `from module import name`
+     * - `from module import name as alias`
+     * - `from module import *`
+     * - `from module import (name1, name2)`
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file
+     * @returns Array of import information
+     */
+    extractImports(content, filePath) {
+        const imports = [];
+        const lines = content.split('\n');
+        // Regex patterns for import statements
+        const importRegex = /^import\s+([\w.]+)(?:\s+as\s+(\w+))?$/;
+        const fromImportRegex = /^from\s+([\w.]+)\s+import\s+(.+)$/;
+        // Track multi-line imports
+        let multiLineBuffer = '';
+        let inMultiLineImport = false;
+        let multiLineModule = '';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Skip comments and empty lines
+            if (line.startsWith('#') || line === '') {
+                continue;
+            }
+            // Handle multi-line imports (with parentheses)
+            if (inMultiLineImport) {
+                multiLineBuffer += ' ' + line;
+                if (line.includes(')')) {
+                    inMultiLineImport = false;
+                    // Parse the complete multi-line import
+                    const names = this.parseImportNames(multiLineBuffer.replace(/[()]/g, ''));
+                    imports.push({
+                        module: multiLineModule,
+                        namedImports: names.filter((n) => n !== '*'),
+                        namespaceImport: names.includes('*') ? '*' : undefined,
+                        isTypeOnly: false,
+                        sourceFile: filePath,
+                        line: i + 1,
+                    });
+                    multiLineBuffer = '';
+                    multiLineModule = '';
+                }
+                continue;
+            }
+            // Check for multi-line import start
+            const fromMatch = line.match(fromImportRegex);
+            if (fromMatch && line.includes('(') && !line.includes(')')) {
+                inMultiLineImport = true;
+                multiLineModule = fromMatch[1];
+                multiLineBuffer = fromMatch[2];
+                continue;
+            }
+            // Simple import: `import module`
+            const importMatch = line.match(importRegex);
+            if (importMatch) {
+                imports.push({
+                    module: importMatch[1],
+                    namedImports: [],
+                    defaultImport: importMatch[2] || undefined, // alias becomes "default-like" import
+                    isTypeOnly: false,
+                    sourceFile: filePath,
+                    line: i + 1,
+                });
+                continue;
+            }
+            // From import: `from module import name`
+            if (fromMatch) {
+                const names = this.parseImportNames(fromMatch[2]);
+                imports.push({
+                    module: fromMatch[1],
+                    namedImports: names.filter((n) => n !== '*'),
+                    namespaceImport: names.includes('*') ? '*' : undefined,
+                    isTypeOnly: false,
+                    sourceFile: filePath,
+                    line: i + 1,
+                });
+            }
+        }
+        return imports;
+    }
+    /**
+     * Parse comma-separated import names, handling aliases
+     *
+     * @param namesStr - String containing import names
+     * @returns Array of imported names (without aliases)
+     */
+    parseImportNames(namesStr) {
+        return namesStr
+            .split(',')
+            .map((n) => n.trim())
+            .filter((n) => n !== '')
+            .map((n) => {
+            // Handle 'name as alias' - we only want the original name
+            const asMatch = n.match(/^(\w+)\s+as\s+\w+$/);
+            if (asMatch)
+                return asMatch[1];
+            return n.replace(/[()]/g, '').trim();
+        })
+            .filter((n) => n !== '');
+    }
+    /**
+     * Extract exports from Python source code
+     *
+     * In Python, exports are determined by:
+     * 1. `__all__` list (explicit exports)
+     * 2. Top-level class/function definitions (implicit, if not starting with _)
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file
+     * @returns Array of export information
+     */
+    extractExports(content, filePath) {
+        const exports = [];
+        const lines = content.split('\n');
+        const explicitExports = new Set();
+        // Look for __all__ definition (handle multi-line with [\s\S] instead of dotAll flag)
+        const allMatch = content.match(/__all__\s*=\s*\[([^\]]+)\]/);
+        if (allMatch) {
+            const names = allMatch[1].match(/['"](\w+)['"]/g) || [];
+            for (const name of names) {
+                const cleanName = name.replace(/['"]/g, '');
+                explicitExports.add(cleanName);
+                exports.push({
+                    name: cleanName,
+                    kind: 'unknown',
+                    isDefault: false,
+                    sourceFile: filePath,
+                });
+            }
+        }
+        // Find top-level class and function definitions
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Skip if not at column 0 (not top-level)
+            if (line.startsWith(' ') || line.startsWith('\t')) {
+                continue;
+            }
+            // Class definition
+            const classMatch = line.match(/^class\s+(\w+)/);
+            if (classMatch) {
+                const name = classMatch[1];
+                // Only add if not private (starts with _) and not already in __all__
+                if (!name.startsWith('_') && !explicitExports.has(name)) {
+                    exports.push({
+                        name,
+                        kind: 'class',
+                        isDefault: false,
+                        sourceFile: filePath,
+                        line: i + 1,
+                    });
+                }
+            }
+            // Function definition (not method - those are indented)
+            const funcMatch = line.match(/^(?:async\s+)?def\s+(\w+)/);
+            if (funcMatch) {
+                const name = funcMatch[1];
+                // Only add if not private (starts with _) and not already in __all__
+                if (!name.startsWith('_') && !explicitExports.has(name)) {
+                    exports.push({
+                        name,
+                        kind: 'function',
+                        isDefault: false,
+                        sourceFile: filePath,
+                        line: i + 1,
+                    });
+                }
+            }
+        }
+        return exports;
+    }
+    /**
+     * Extract function definitions from Python source code
+     *
+     * Handles:
+     * - Regular functions: `def func():`
+     * - Async functions: `async def func():`
+     * - Methods (indented functions)
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file
+     * @returns Array of function information
+     */
+    extractFunctions(content, filePath) {
+        const functions = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Match function definitions (both sync and async)
+            const match = line.match(/^(\s*)(async\s+)?def\s+(\w+)\s*\(([^)]*)\)/);
+            if (match) {
+                const indentation = match[1];
+                const isAsync = !!match[2];
+                const name = match[3];
+                const paramsStr = match[4];
+                // Count parameters (excluding self, cls)
+                const params = paramsStr
+                    .split(',')
+                    .map((p) => p.trim())
+                    .filter((p) => p !== '' && p !== 'self' && p !== 'cls');
+                // Is top-level (exported) if no indentation and not private
+                const isTopLevel = indentation === '';
+                const isExported = isTopLevel && !name.startsWith('_');
+                functions.push({
+                    name,
+                    parameterCount: params.length,
+                    isAsync,
+                    isExported,
+                    sourceFile: filePath,
+                    line: i + 1,
+                });
+            }
+        }
+        return functions;
+    }
+    /**
+     * Parse Python source code using tree-sitter for more accurate results
+     *
+     * Tree-sitter provides a full AST which enables more accurate parsing
+     * of complex Python constructs.
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file
+     * @returns Parsed result
+     */
+    parseWithTreeSitter(content, filePath) {
+        // Tree-sitter parsing for more accurate results
+        // For now, fall back to regex until tree-sitter queries are implemented
+        // TODO: SMI-1309 - Implement tree-sitter query-based extraction
+        return this.parseWithRegex(content, filePath);
+    }
+}
+//# sourceMappingURL=python.js.map

package/dist/src/analysis/adapters/python.js.map

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

package/dist/src/analysis/adapters/rust.d.ts

@@ -0,0 +1,116 @@
+/**
+ * SMI-1306: Rust Language Adapter
+ *
+ * Parses Rust source files (.rs) and extracts imports, exports, and functions
+ * using regex-based parsing. Rust uses explicit `pub` visibility modifiers
+ * for public items.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ */
+import { LanguageAdapter, type SupportedLanguage } from './base.js';
+import type { ParseResult, ExportInfo, FunctionInfo, FrameworkRule } from './base.js';
+/**
+ * Extended ExportInfo for Rust with visibility support
+ */
+export interface RustExportInfo extends ExportInfo {
+    /** Rust exports via pub modifier */
+    visibility: 'public' | 'private';
+    /** Line number in source */
+    line: number;
+}
+/**
+ * Extended FunctionInfo for Rust with attribute support
+ */
+export interface RustFunctionInfo extends FunctionInfo {
+    /** Rust attributes (e.g., #[derive], #[test]) */
+    attributes?: string[];
+}
+/**
+ * Cargo.toml dependency information
+ */
+export interface CargoDependency {
+    /** Crate name */
+    name: string;
+    /** Version specifier */
+    version: string;
+    /** Whether this is a dev dependency */
+    isDev: boolean;
+}
+/**
+ * Rust Language Adapter
+ *
+ * Parses Rust source files using regex-based parsing.
+ * Handles Rust's `pub` visibility modifiers and module system.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new RustAdapter()
+ * const result = adapter.parseFile(rustCode, 'lib.rs')
+ * console.log(result.exports) // Items with pub modifier
+ * ```
+ */
+export declare class RustAdapter extends LanguageAdapter {
+    readonly language: SupportedLanguage;
+    readonly extensions: string[];
+    /**
+     * Parse a Rust source file and extract information
+     */
+    parseFile(content: string, filePath: string): ParseResult;
+    /**
+     * Parse file incrementally (currently same as full parse)
+     */
+    parseIncremental(content: string, filePath: string, _previousTree?: unknown): ParseResult;
+    /**
+     * Get Rust framework detection rules
+     */
+    getFrameworkRules(): FrameworkRule[];
+    /**
+     * Clean up resources (no-op for regex-based parsing)
+     */
+    dispose(): void;
+    /**
+     * Extract use statements from Rust source
+     *
+     * Handles:
+     * - use crate::module::item;
+     * - use std::collections::HashMap;
+     * - use super::parent;
+     * - use self::child;
+     * - use std::{io, fs};
+     * - use module::*;
+     * - extern crate foo;
+     */
+    private extractImports;
+    /**
+     * Extract exports (pub items) from Rust source
+     *
+     * In Rust, items prefixed with `pub` are public.
+     * Handles visibility modifiers: pub, pub(crate), pub(super), pub(in path)
+     */
+    private extractExports;
+    /**
+     * Extract function definitions from Rust source
+     *
+     * Handles:
+     * - fn name(params)
+     * - pub fn name(params)
+     * - async fn name(params)
+     * - pub async fn name(params)
+     * - Functions with generics: fn name<T>(params)
+     */
+    private extractFunctions;
+}
+/**
+ * Parse Cargo.toml to extract dependencies
+ *
+ * @param content - Content of Cargo.toml file
+ * @returns Array of dependencies with name, version, and isDev flag
+ *
+ * @example
+ * ```typescript
+ * const deps = parseCargoToml(cargoTomlContent)
+ * console.log(deps) // [{ name: 'serde', version: '1.0', isDev: false }]
+ * ```
+ */
+export declare function parseCargoToml(content: string): CargoDependency[];
+//# sourceMappingURL=rust.d.ts.map

package/dist/src/analysis/adapters/rust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust.d.ts","sourceRoot":"","sources":["../../../../src/analysis/adapters/rust.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAc,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEjG;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,oCAAoC;IACpC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAA;IAChC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,eAAe;IAC9C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAS;IAC7C,QAAQ,CAAC,UAAU,WAAU;IAE7B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAOzD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW;IAMzF;;OAEG;IACH,iBAAiB,IAAI,aAAa,EAAE;IAsEpC;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAoFtB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAmHtB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;CAqEzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CA+EjE"}