@skillsmith/core 0.2.0 → 2.0.0

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

@@ -0,0 +1,407 @@
+/**
+ * SMI-1307: Java Language Adapter
+ *
+ * Parses Java source files and extracts imports, exports, and functions
+ * using regex-based parsing. Handles Java-specific features including:
+ * - Visibility modifiers (public, private, protected, package-private)
+ * - Annotations (@Override, @Test, @Autowired, etc.)
+ * - Generics in class and method declarations
+ * - Interfaces, abstract classes, enums, and annotation types
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ */
+import { LanguageAdapter } from './base.js';
+/**
+ * Java Language Adapter
+ *
+ * Parses Java source files using regex-based parsing.
+ * Handles Java's explicit visibility modifiers and annotation system.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new JavaAdapter()
+ * const result = adapter.parseFile(javaCode, 'Main.java')
+ * console.log(result.exports) // public classes, interfaces, enums
+ * console.log(result.functions) // public/protected methods
+ * ```
+ */
+export class JavaAdapter extends LanguageAdapter {
+    language = 'java';
+    extensions = ['.java'];
+    /**
+     * Parse a Java source file and extract information
+     */
+    parseFile(content, filePath) {
+        const imports = this.extractImports(content, filePath);
+        const exports = this.extractExports(content, filePath);
+        const functions = this.extractFunctions(content, filePath);
+        return { imports, exports, functions };
+    }
+    /**
+     * Parse file incrementally (currently same as full parse)
+     */
+    parseIncremental(content, filePath, _previousTree) {
+        // Incremental parsing not yet implemented for Java
+        // Will be added with tree-sitter integration
+        return this.parseFile(content, filePath);
+    }
+    /**
+     * Get Java framework detection rules
+     */
+    getFrameworkRules() {
+        return [
+            {
+                name: 'Spring Boot',
+                depIndicators: ['spring-boot', 'org.springframework.boot'],
+                importIndicators: ['org.springframework.boot', 'org.springframework.web'],
+            },
+            {
+                name: 'Spring',
+                depIndicators: ['spring-core', 'org.springframework'],
+                importIndicators: ['org.springframework'],
+            },
+            {
+                name: 'Quarkus',
+                depIndicators: ['io.quarkus'],
+                importIndicators: ['io.quarkus', 'javax.enterprise'],
+            },
+            {
+                name: 'Micronaut',
+                depIndicators: ['io.micronaut'],
+                importIndicators: ['io.micronaut'],
+            },
+            {
+                name: 'Jakarta EE',
+                depIndicators: ['jakarta.'],
+                importIndicators: ['jakarta.'],
+            },
+            {
+                name: 'JUnit',
+                depIndicators: ['junit', 'org.junit'],
+                importIndicators: ['org.junit', 'junit.framework'],
+            },
+            {
+                name: 'Hibernate',
+                depIndicators: ['hibernate', 'org.hibernate'],
+                importIndicators: ['org.hibernate', 'javax.persistence', 'jakarta.persistence'],
+            },
+            {
+                name: 'Lombok',
+                depIndicators: ['lombok', 'org.projectlombok'],
+                importIndicators: ['lombok'],
+            },
+            {
+                name: 'Maven',
+                depIndicators: ['maven', 'org.apache.maven'],
+                importIndicators: [],
+            },
+            {
+                name: 'Gradle',
+                depIndicators: ['gradle', 'org.gradle'],
+                importIndicators: [],
+            },
+            {
+                name: 'TestNG',
+                depIndicators: ['testng', 'org.testng'],
+                importIndicators: ['org.testng'],
+            },
+            {
+                name: 'Mockito',
+                depIndicators: ['mockito', 'org.mockito'],
+                importIndicators: ['org.mockito'],
+            },
+            {
+                name: 'Jackson',
+                depIndicators: ['jackson', 'com.fasterxml.jackson'],
+                importIndicators: ['com.fasterxml.jackson'],
+            },
+            {
+                name: 'Gson',
+                depIndicators: ['gson', 'com.google.gson'],
+                importIndicators: ['com.google.gson'],
+            },
+            {
+                name: 'Apache Commons',
+                depIndicators: ['commons-', 'org.apache.commons'],
+                importIndicators: ['org.apache.commons'],
+            },
+            {
+                name: 'SLF4J',
+                depIndicators: ['slf4j', 'org.slf4j'],
+                importIndicators: ['org.slf4j'],
+            },
+            {
+                name: 'Log4j',
+                depIndicators: ['log4j', 'org.apache.logging.log4j'],
+                importIndicators: ['org.apache.logging.log4j', 'org.apache.log4j'],
+            },
+        ];
+    }
+    /**
+     * Clean up resources (no-op for regex-based parsing)
+     */
+    dispose() {
+        // No resources to clean up for regex-based parsing
+    }
+    /**
+     * Extract import statements from Java source
+     *
+     * Handles:
+     * - Regular imports: import com.example.Class;
+     * - Static imports: import static com.example.Class.method;
+     * - Wildcard imports: import com.example.*;
+     */
+    extractImports(content, filePath) {
+        const imports = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Match: import com.example.Class;
+            // Match: import static com.example.Class.method;
+            // Match: import com.example.*;
+            const importMatch = line.match(/^import\s+(static\s+)?([\w.]+(?:\.\*)?);/);
+            if (importMatch) {
+                const isStatic = !!importMatch[1];
+                const fullPath = importMatch[2];
+                const isWildcard = fullPath.endsWith('.*');
+                const module = isWildcard ? fullPath.slice(0, -2) : fullPath;
+                // Extract the simple name from the full path
+                const parts = fullPath.split('.');
+                const simpleName = isWildcard ? undefined : parts[parts.length - 1];
+                imports.push({
+                    module,
+                    namedImports: simpleName && !isWildcard ? [simpleName] : [],
+                    namespaceImport: isWildcard ? '*' : undefined,
+                    isTypeOnly: !isStatic, // Java imports are type-only unless static
+                    sourceFile: filePath,
+                    line: i + 1,
+                });
+            }
+        }
+        return imports;
+    }
+    /**
+     * Extract exports (public declarations) from Java source
+     *
+     * In Java, exports are determined by visibility modifiers:
+     * - public: accessible from anywhere
+     * - protected: accessible from subclasses
+     * - package-private (default): accessible within package
+     * - private: not exported
+     */
+    extractExports(content, filePath) {
+        const exports = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Match class/interface/enum/@interface declarations
+            // Supports: public, protected, private, abstract, final, static modifiers
+            const classMatch = line.match(/^\s*(public|protected|private)?\s*(abstract\s+)?(final\s+)?(static\s+)?(class|interface|enum|@interface)\s+(\w+)(?:<[^>]+>)?/);
+            if (classMatch) {
+                const visibility = classMatch[1] || 'package';
+                const _isAbstract = !!classMatch[2];
+                const type = classMatch[5];
+                const name = classMatch[6];
+                let kind = 'class';
+                if (type === 'interface' || type === '@interface')
+                    kind = 'interface';
+                if (type === 'enum')
+                    kind = 'enum';
+                exports.push({
+                    name,
+                    kind,
+                    isDefault: false,
+                    sourceFile: filePath,
+                    visibility: visibility === 'package'
+                        ? 'internal'
+                        : visibility,
+                    line: i + 1,
+                });
+            }
+        }
+        return exports;
+    }
+    /**
+     * Extract function definitions from Java source
+     *
+     * Handles:
+     * - Regular methods: public void foo(String s, int n)
+     * - Generic methods: public <T> List<T> bar(T item)
+     * - Abstract methods: protected abstract void baz();
+     * - Static methods: public static void main(String[] args)
+     * - Annotated methods: @Override public String toString()
+     */
+    extractFunctions(content, filePath) {
+        const functions = [];
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Match method declarations:
+            // public void foo(String s, int n)
+            // private static <T> List<T> bar(T item)
+            // protected abstract void baz();
+            // @Override public String toString()
+            const methodMatch = line.match(/^\s*(public|protected|private)?\s*(static\s+)?(abstract\s+)?(final\s+)?(synchronized\s+)?(native\s+)?(<[^>]+>\s+)?(\w+(?:<[^>]+>)?(?:\[\])*)\s+(\w+)\s*\(([^)]*)\)/);
+            if (methodMatch) {
+                const visibility = methodMatch[1] || 'package';
+                const _isStatic = !!methodMatch[2];
+                const _isAbstract = !!methodMatch[3];
+                const _returnType = methodMatch[8];
+                const name = methodMatch[9];
+                const paramsStr = methodMatch[10];
+                // Skip constructors (return type matches class name pattern - would need context)
+                // Skip if the "return type" looks like a class name being constructed
+                // A simple heuristic: constructors have no return type in the regex
+                // In practice, our regex captures return type, so constructors won't match
+                // Count parameters - handle generics in parameters like List<String>
+                let paramCount = 0;
+                if (paramsStr.trim()) {
+                    // Remove generic brackets to avoid splitting on commas inside them
+                    let depth = 0;
+                    let cleanedParams = '';
+                    for (const char of paramsStr) {
+                        if (char === '<')
+                            depth++;
+                        else if (char === '>')
+                            depth--;
+                        else if (char === ',' && depth === 0)
+                            cleanedParams += ',';
+                        else if (depth === 0)
+                            cleanedParams += char;
+                    }
+                    paramCount = cleanedParams.split(',').filter((p) => p.trim()).length;
+                }
+                // Look for annotations above the method
+                const decorators = [];
+                for (let j = i - 1; j >= 0; j--) {
+                    const prevLine = lines[j].trim();
+                    if (prevLine.startsWith('@')) {
+                        const annoMatch = prevLine.match(/@(\w+)/);
+                        if (annoMatch) {
+                            decorators.unshift(annoMatch[1]);
+                        }
+                    }
+                    else if (prevLine && !prevLine.startsWith('//') && !prevLine.startsWith('*')) {
+                        break;
+                    }
+                }
+                functions.push({
+                    name,
+                    parameterCount: paramCount,
+                    isAsync: false, // Java doesn't have async keyword
+                    isExported: visibility === 'public' || visibility === 'protected',
+                    sourceFile: filePath,
+                    line: i + 1,
+                    decorators: decorators.length > 0 ? decorators : undefined,
+                });
+            }
+        }
+        return functions;
+    }
+}
+/**
+ * Parse pom.xml to extract Maven dependencies
+ *
+ * @param content - Content of pom.xml file
+ * @returns Array of dependency information
+ *
+ * @example
+ * ```typescript
+ * const deps = parsePomXml(pomXmlContent)
+ * console.log(deps) // [{ name: "org.springframework:spring-core", version: "5.3.0", ... }]
+ * ```
+ */
+export function parsePomXml(content) {
+    const deps = [];
+    // Remove XML comments to avoid false matches
+    const contentWithoutComments = content.replace(/<!--[\s\S]*?-->/g, '');
+    // Match dependency blocks first, then extract individual elements
+    const depBlockRegex = /<dependency>([\s\S]*?)<\/dependency>/g;
+    let blockMatch;
+    while ((blockMatch = depBlockRegex.exec(contentWithoutComments)) !== null) {
+        const block = blockMatch[1];
+        // Extract individual elements from the dependency block
+        const groupIdMatch = block.match(/<groupId>([^<]+)<\/groupId>/);
+        const artifactIdMatch = block.match(/<artifactId>([^<]+)<\/artifactId>/);
+        const versionMatch = block.match(/<version>([^<]+)<\/version>/);
+        const scopeMatch = block.match(/<scope>([^<]+)<\/scope>/);
+        if (groupIdMatch && artifactIdMatch) {
+            const groupId = groupIdMatch[1].trim();
+            const artifactId = artifactIdMatch[1].trim();
+            const version = versionMatch ? versionMatch[1].trim() : 'unspecified';
+            const scope = scopeMatch ? scopeMatch[1].trim() : 'compile';
+            deps.push({
+                name: `${groupId}:${artifactId}`,
+                version,
+                isDev: scope === 'test' || scope === 'provided',
+            });
+        }
+    }
+    return deps;
+}
+/**
+ * Parse build.gradle or build.gradle.kts to extract Gradle dependencies
+ *
+ * @param content - Content of build.gradle file
+ * @returns Array of dependency information
+ *
+ * @example
+ * ```typescript
+ * const deps = parseBuildGradle(gradleContent)
+ * console.log(deps) // [{ name: "org.springframework:spring-core", version: "5.3.0", ... }]
+ * ```
+ */
+export function parseBuildGradle(content) {
+    const deps = [];
+    let match;
+    // Configuration names to match
+    const configs = 'implementation|api|testImplementation|testCompileOnly|compileOnly|runtimeOnly|testRuntimeOnly|annotationProcessor|kapt';
+    // Pattern 1: Groovy style with quotes: implementation 'group:artifact:version'
+    const groovyQuoteRegex = new RegExp(`(${configs})\\s+['"]([^'"]+)['"]`, 'g');
+    while ((match = groovyQuoteRegex.exec(content)) !== null) {
+        const config = match[1];
+        const depStr = match[2].trim();
+        addDependency(deps, config, depStr);
+    }
+    // Pattern 2: Kotlin DSL style with parens and quotes: implementation("group:artifact:version")
+    const kotlinStringRegex = new RegExp(`(${configs})\\s*\\(\\s*["']([^"']+)["']\\s*\\)`, 'g');
+    while ((match = kotlinStringRegex.exec(content)) !== null) {
+        const config = match[1];
+        const depStr = match[2].trim();
+        addDependency(deps, config, depStr);
+    }
+    // Pattern 3: Kotlin DSL with named parameters
+    // implementation(group = "com.example", name = "library", version = "1.0")
+    const kotlinNamedRegex = new RegExp(`(${configs})\\s*\\(\\s*group\\s*=\\s*"([^"]+)"\\s*,\\s*name\\s*=\\s*"([^"]+)"(?:\\s*,\\s*version\\s*=\\s*"([^"]+)")?\\s*\\)`, 'g');
+    while ((match = kotlinNamedRegex.exec(content)) !== null) {
+        const config = match[1];
+        const group = match[2];
+        const name = match[3];
+        const version = match[4] || 'unspecified';
+        deps.push({
+            name: `${group}:${name}`,
+            version,
+            isDev: config.startsWith('test'),
+        });
+    }
+    return deps;
+}
+/**
+ * Helper function to add a dependency from a colon-separated string
+ */
+function addDependency(deps, config, depStr) {
+    // Skip project references
+    if (depStr.startsWith(':') || depStr.includes('project(')) {
+        return;
+    }
+    // Parse group:artifact:version format
+    const parts = depStr.split(':');
+    if (parts.length >= 2) {
+        deps.push({
+            name: `${parts[0]}:${parts[1]}`,
+            version: parts[2] || 'unspecified',
+            isDev: config.startsWith('test') || config === 'annotationProcessor' || config === 'kapt',
+        });
+    }
+}
+//# sourceMappingURL=java.js.map

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

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

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

@@ -0,0 +1,165 @@
+/**
+ * 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, type SupportedLanguage, type FrameworkRule } from './base.js';
+import type { ParseResult } from '../types.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 declare class PythonAdapter extends LanguageAdapter {
+    readonly language: SupportedLanguage;
+    readonly extensions: string[];
+    private parser;
+    private parserInitialized;
+    private parserInitPromise;
+    /**
+     * 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.
+     */
+    initParser(): Promise<void>;
+    private doInitParser;
+    /**
+     * 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: string, filePath: string): ParseResult;
+    /**
+     * 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
+     */
+    parseFileAsync(content: string, filePath: string): Promise<ParseResult>;
+    /**
+     * 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: string, filePath: string, _previousTree?: unknown): ParseResult;
+    /**
+     * 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(): FrameworkRule[];
+    /**
+     * Clean up resources
+     */
+    dispose(): void;
+    /**
+     * Parse Python source code using regex patterns
+     *
+     * @param content - Python source code
+     * @param filePath - Path to the file
+     * @returns Parsed result
+     */
+    private parseWithRegex;
+    /**
+     * 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
+     */
+    private extractImports;
+    /**
+     * Parse comma-separated import names, handling aliases
+     *
+     * @param namesStr - String containing import names
+     * @returns Array of imported names (without aliases)
+     */
+    private parseImportNames;
+    /**
+     * 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
+     */
+    private extractExports;
+    /**
+     * 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
+     */
+    private extractFunctions;
+    /**
+     * 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
+     */
+    private parseWithTreeSitter;
+}
+//# sourceMappingURL=python.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../../src/analysis/adapters/python.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAwC,MAAM,aAAa,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAChD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAW;IAC/C,QAAQ,CAAC,UAAU,WAA0B;IAE7C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAQnB,YAAY;IAkC1B;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAIzD;;;;;;;;OAQG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAc7E;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW;IAKzF;;;;;;;;;;;OAWG;IACH,iBAAiB,IAAI,aAAa,EAAE;IAsEpC;;OAEG;IACH,OAAO,IAAI,IAAI;IAaf;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,cAAc;IAkFtB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAkEtB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;CAM5B"}