@skillsmith/core 0.2.0 → 2.0.0

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

@@ -0,0 +1,150 @@
+/**
+ * SMI-1339: Adapter Factory Pattern
+ *
+ * Factory class for creating language adapters with lazy instantiation.
+ * Avoids unnecessary adapter creation and provides centralized adapter management.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/adapters/factory
+ */
+import type { LanguageAdapter } from './base.js';
+import type { SupportedLanguage } from '../types.js';
+/**
+ * Factory class for creating language adapters
+ *
+ * Provides lazy instantiation of adapters to avoid creating
+ * unused adapter instances and reduce startup overhead.
+ *
+ * @example
+ * ```typescript
+ * // Create a single adapter
+ * const pythonAdapter = AdapterFactory.createAdapter('python')
+ *
+ * // Create all adapters
+ * const allAdapters = AdapterFactory.createAll()
+ *
+ * // Create specific adapters
+ * const adapters = AdapterFactory.createAdapters(['typescript', 'python'])
+ * ```
+ */
+export declare class AdapterFactory {
+    /** Cache of created adapters for reuse */
+    private static adapterCache;
+    /**
+     * Create an adapter for a specific language
+     *
+     * Creates a new adapter instance for the given language.
+     * Use createCachedAdapter() if you want to reuse adapter instances.
+     *
+     * @param language - Language to create adapter for
+     * @returns New adapter instance
+     * @throws Error if language is not supported
+     *
+     * @example
+     * ```typescript
+     * const adapter = AdapterFactory.createAdapter('python')
+     * const result = adapter.parseFile(content, 'main.py')
+     * adapter.dispose()
+     * ```
+     */
+    static createAdapter(language: SupportedLanguage): LanguageAdapter;
+    /**
+     * Get or create a cached adapter for a specific language
+     *
+     * Returns an existing adapter if one was previously created,
+     * otherwise creates and caches a new adapter instance.
+     *
+     * @param language - Language to get adapter for
+     * @returns Cached or new adapter instance
+     * @throws Error if language is not supported
+     *
+     * @example
+     * ```typescript
+     * // Reuses same instance
+     * const adapter1 = AdapterFactory.createCachedAdapter('typescript')
+     * const adapter2 = AdapterFactory.createCachedAdapter('typescript')
+     * console.log(adapter1 === adapter2) // true
+     * ```
+     */
+    static createCachedAdapter(language: SupportedLanguage): LanguageAdapter;
+    /**
+     * Create adapters for all supported languages
+     *
+     * Returns a Map of language to adapter for all supported languages.
+     * Each adapter is created lazily (new instance per call).
+     *
+     * @returns Map of language to adapter
+     *
+     * @example
+     * ```typescript
+     * const adapters = AdapterFactory.createAll()
+     * for (const [lang, adapter] of adapters) {
+     *   console.log(`${lang}: ${adapter.extensions.join(', ')}`)
+     * }
+     * ```
+     */
+    static createAll(): Map<SupportedLanguage, LanguageAdapter>;
+    /**
+     * Create adapters for specific languages
+     *
+     * @param languages - Array of languages to create adapters for
+     * @returns Map of language to adapter
+     * @throws Error if any language is not supported
+     *
+     * @example
+     * ```typescript
+     * const adapters = AdapterFactory.createAdapters(['typescript', 'python'])
+     * ```
+     */
+    static createAdapters(languages: SupportedLanguage[]): Map<SupportedLanguage, LanguageAdapter>;
+    /**
+     * Get list of supported languages
+     *
+     * @returns Array of supported language identifiers
+     */
+    static getSupportedLanguages(): SupportedLanguage[];
+    /**
+     * Check if a language is supported
+     *
+     * @param language - Language to check
+     * @returns True if language is supported
+     */
+    static isSupported(language: string): language is SupportedLanguage;
+    /**
+     * Get file extensions for a language
+     *
+     * Returns the file extensions handled by the adapter for a given language,
+     * without needing to instantiate the adapter.
+     *
+     * @param language - Language to get extensions for
+     * @returns Array of file extensions (with dot prefix)
+     */
+    static getExtensions(language: SupportedLanguage): string[];
+    /**
+     * Get all file extensions from all adapters
+     *
+     * Returns a map of file extension to language.
+     * Note: TypeScript-specific extensions (.ts, .tsx) map to 'typescript',
+     * while JavaScript-specific extensions (.js, .jsx, etc.) map to 'javascript'.
+     *
+     * @returns Map of extension to language
+     */
+    static getAllExtensions(): Map<string, SupportedLanguage>;
+    /**
+     * Clear the adapter cache
+     *
+     * Disposes all cached adapters and clears the cache.
+     * Call this when you want to free resources or reset state.
+     */
+    static clearCache(): void;
+    /**
+     * Get cache statistics
+     *
+     * @returns Object with cache stats
+     */
+    static getCacheStats(): {
+        size: number;
+        languages: SupportedLanguage[];
+    };
+}
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/analysis/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAwBpD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAqD;IAEhF;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,eAAe;IAalE;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,eAAe;IAWxE;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC;IAU3D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,iBAAiB,EAAE,eAAe,CAAC;IAU9F;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,IAAI,iBAAiB,EAAE;IAInD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,iBAAiB;IAInE;;;;;;;;OAQG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,EAAE;IAc3D;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IA+BzD;;;;;OAKG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAWzB;;;;OAIG;IACH,MAAM,CAAC,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,iBAAiB,EAAE,CAAA;KAAE;CAMzE"}

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

@@ -0,0 +1,244 @@
+/**
+ * SMI-1339: Adapter Factory Pattern
+ *
+ * Factory class for creating language adapters with lazy instantiation.
+ * Avoids unnecessary adapter creation and provides centralized adapter management.
+ *
+ * @see docs/architecture/multi-language-analysis.md
+ * @module analysis/adapters/factory
+ */
+import { TypeScriptAdapter } from './typescript.js';
+import { PythonAdapter } from './python.js';
+import { GoAdapter } from './go.js';
+import { RustAdapter } from './rust.js';
+import { JavaAdapter } from './java.js';
+/**
+ * Registry of adapter factory functions by language
+ */
+const ADAPTER_FACTORIES = {
+    typescript: () => new TypeScriptAdapter(),
+    javascript: () => new TypeScriptAdapter(), // TypeScript adapter handles JS
+    python: () => new PythonAdapter(),
+    go: () => new GoAdapter(),
+    rust: () => new RustAdapter(),
+    java: () => new JavaAdapter(),
+};
+/**
+ * Factory class for creating language adapters
+ *
+ * Provides lazy instantiation of adapters to avoid creating
+ * unused adapter instances and reduce startup overhead.
+ *
+ * @example
+ * ```typescript
+ * // Create a single adapter
+ * const pythonAdapter = AdapterFactory.createAdapter('python')
+ *
+ * // Create all adapters
+ * const allAdapters = AdapterFactory.createAll()
+ *
+ * // Create specific adapters
+ * const adapters = AdapterFactory.createAdapters(['typescript', 'python'])
+ * ```
+ */
+export class AdapterFactory {
+    /** Cache of created adapters for reuse */
+    static adapterCache = new Map();
+    /**
+     * Create an adapter for a specific language
+     *
+     * Creates a new adapter instance for the given language.
+     * Use createCachedAdapter() if you want to reuse adapter instances.
+     *
+     * @param language - Language to create adapter for
+     * @returns New adapter instance
+     * @throws Error if language is not supported
+     *
+     * @example
+     * ```typescript
+     * const adapter = AdapterFactory.createAdapter('python')
+     * const result = adapter.parseFile(content, 'main.py')
+     * adapter.dispose()
+     * ```
+     */
+    static createAdapter(language) {
+        const factory = ADAPTER_FACTORIES[language];
+        if (!factory) {
+            const supported = AdapterFactory.getSupportedLanguages();
+            throw new Error(`Unsupported language: ${language}. ` + `Supported languages: ${supported.join(', ')}`);
+        }
+        return factory();
+    }
+    /**
+     * Get or create a cached adapter for a specific language
+     *
+     * Returns an existing adapter if one was previously created,
+     * otherwise creates and caches a new adapter instance.
+     *
+     * @param language - Language to get adapter for
+     * @returns Cached or new adapter instance
+     * @throws Error if language is not supported
+     *
+     * @example
+     * ```typescript
+     * // Reuses same instance
+     * const adapter1 = AdapterFactory.createCachedAdapter('typescript')
+     * const adapter2 = AdapterFactory.createCachedAdapter('typescript')
+     * console.log(adapter1 === adapter2) // true
+     * ```
+     */
+    static createCachedAdapter(language) {
+        const cached = this.adapterCache.get(language);
+        if (cached) {
+            return cached;
+        }
+        const adapter = this.createAdapter(language);
+        this.adapterCache.set(language, adapter);
+        return adapter;
+    }
+    /**
+     * Create adapters for all supported languages
+     *
+     * Returns a Map of language to adapter for all supported languages.
+     * Each adapter is created lazily (new instance per call).
+     *
+     * @returns Map of language to adapter
+     *
+     * @example
+     * ```typescript
+     * const adapters = AdapterFactory.createAll()
+     * for (const [lang, adapter] of adapters) {
+     *   console.log(`${lang}: ${adapter.extensions.join(', ')}`)
+     * }
+     * ```
+     */
+    static createAll() {
+        const adapters = new Map();
+        for (const language of AdapterFactory.getSupportedLanguages()) {
+            adapters.set(language, this.createAdapter(language));
+        }
+        return adapters;
+    }
+    /**
+     * Create adapters for specific languages
+     *
+     * @param languages - Array of languages to create adapters for
+     * @returns Map of language to adapter
+     * @throws Error if any language is not supported
+     *
+     * @example
+     * ```typescript
+     * const adapters = AdapterFactory.createAdapters(['typescript', 'python'])
+     * ```
+     */
+    static createAdapters(languages) {
+        const adapters = new Map();
+        for (const language of languages) {
+            adapters.set(language, this.createAdapter(language));
+        }
+        return adapters;
+    }
+    /**
+     * Get list of supported languages
+     *
+     * @returns Array of supported language identifiers
+     */
+    static getSupportedLanguages() {
+        return Object.keys(ADAPTER_FACTORIES);
+    }
+    /**
+     * Check if a language is supported
+     *
+     * @param language - Language to check
+     * @returns True if language is supported
+     */
+    static isSupported(language) {
+        return language in ADAPTER_FACTORIES;
+    }
+    /**
+     * Get file extensions for a language
+     *
+     * Returns the file extensions handled by the adapter for a given language,
+     * without needing to instantiate the adapter.
+     *
+     * @param language - Language to get extensions for
+     * @returns Array of file extensions (with dot prefix)
+     */
+    static getExtensions(language) {
+        // Use cached adapter if available, otherwise create temporary one
+        const cached = this.adapterCache.get(language);
+        if (cached) {
+            return [...cached.extensions];
+        }
+        // Create temporary adapter to get extensions
+        const adapter = this.createAdapter(language);
+        const extensions = [...adapter.extensions];
+        adapter.dispose();
+        return extensions;
+    }
+    /**
+     * Get all file extensions from all adapters
+     *
+     * Returns a map of file extension to language.
+     * Note: TypeScript-specific extensions (.ts, .tsx) map to 'typescript',
+     * while JavaScript-specific extensions (.js, .jsx, etc.) map to 'javascript'.
+     *
+     * @returns Map of extension to language
+     */
+    static getAllExtensions() {
+        const extensionMap = new Map();
+        // Define canonical mappings - TypeScript-specific extensions should map to typescript
+        const canonicalMappings = {
+            '.ts': 'typescript',
+            '.tsx': 'typescript',
+            '.mts': 'typescript',
+            '.cts': 'typescript',
+            '.js': 'javascript',
+            '.jsx': 'javascript',
+            '.mjs': 'javascript',
+            '.cjs': 'javascript',
+        };
+        for (const language of this.getSupportedLanguages()) {
+            const extensions = this.getExtensions(language);
+            for (const ext of extensions) {
+                const normalizedExt = ext.toLowerCase();
+                // Use canonical mapping if available, otherwise use the adapter's language
+                const mappedLanguage = canonicalMappings[normalizedExt] ?? language;
+                // Only set if not already defined (first definition wins for non-canonical)
+                if (!extensionMap.has(normalizedExt)) {
+                    extensionMap.set(normalizedExt, mappedLanguage);
+                }
+            }
+        }
+        return extensionMap;
+    }
+    /**
+     * Clear the adapter cache
+     *
+     * Disposes all cached adapters and clears the cache.
+     * Call this when you want to free resources or reset state.
+     */
+    static clearCache() {
+        for (const adapter of this.adapterCache.values()) {
+            try {
+                adapter.dispose();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        }
+        this.adapterCache.clear();
+    }
+    /**
+     * Get cache statistics
+     *
+     * @returns Object with cache stats
+     */
+    static getCacheStats() {
+        return {
+            size: this.adapterCache.size,
+            languages: Array.from(this.adapterCache.keys()),
+        };
+    }
+}
+//# sourceMappingURL=factory.js.map

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

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

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

@@ -0,0 +1,131 @@
+/**
+ * SMI-1305: Go Language Adapter
+ *
+ * Parses Go source files and extracts imports, exports, and functions
+ * using regex-based parsing. Go uses capitalization-based visibility:
+ * identifiers starting with uppercase are exported (public).
+ *
+ * @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 Go with visibility support
+ */
+export interface GoExportInfo extends ExportInfo {
+    /** Go exports via capitalization */
+    visibility: 'public' | 'private';
+    /** Line number in source */
+    line: number;
+}
+/**
+ * Extended FunctionInfo for Go with receiver support
+ */
+export interface GoFunctionInfo extends FunctionInfo {
+    /** Method receiver type (e.g., "*MyStruct") */
+    receiver?: string;
+}
+/**
+ * Go module information from go.mod
+ */
+export interface GoModInfo {
+    /** Module path (e.g., "github.com/user/project") */
+    module: string;
+    /** Go version (e.g., "1.21") */
+    goVersion?: string;
+    /** Direct dependencies */
+    require: Array<{
+        path: string;
+        version: string;
+    }>;
+    /** Replaced dependencies */
+    replace: Array<{
+        old: string;
+        new: string;
+        version?: string;
+    }>;
+}
+/**
+ * Go Language Adapter
+ *
+ * Parses Go source files using regex-based parsing.
+ * Handles Go's capitalization-based visibility rules.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new GoAdapter()
+ * const result = adapter.parseFile(goCode, 'main.go')
+ * console.log(result.exports) // Uppercase identifiers only
+ * ```
+ */
+export declare class GoAdapter extends LanguageAdapter {
+    readonly language: SupportedLanguage;
+    readonly extensions: string[];
+    /**
+     * Parse a Go 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 Go framework detection rules
+     */
+    getFrameworkRules(): FrameworkRule[];
+    /**
+     * Clean up resources (no-op for regex-based parsing)
+     */
+    dispose(): void;
+    /**
+     * Check if an identifier is exported (starts with uppercase)
+     *
+     * In Go, identifiers starting with uppercase are exported (public)
+     * and can be accessed from other packages.
+     *
+     * @param name - Identifier name
+     * @returns True if the identifier is exported
+     */
+    private isExported;
+    /**
+     * Extract import statements from Go source
+     *
+     * Handles both single imports and import blocks:
+     * - import "fmt"
+     * - import ( "fmt" \n "os" )
+     * - import alias "path/to/package"
+     */
+    private extractImports;
+    /**
+     * Extract exports (public declarations) from Go source
+     *
+     * In Go, any top-level declaration starting with uppercase is exported:
+     * - type Foo struct/interface
+     * - func Foo() or func (r *Receiver) Foo()
+     * - const/var Foo
+     */
+    private extractExports;
+    /**
+     * Extract function definitions from Go source
+     *
+     * Handles both regular functions and methods:
+     * - func name(params) return
+     * - func (r *Receiver) name(params) return
+     */
+    private extractFunctions;
+}
+/**
+ * Parse go.mod file to extract module info and dependencies
+ *
+ * @param content - Content of go.mod file
+ * @returns Parsed go.mod information
+ *
+ * @example
+ * ```typescript
+ * const modInfo = parseGoMod(goModContent)
+ * console.log(modInfo.module) // "github.com/user/project"
+ * console.log(modInfo.require) // [{ path: "...", version: "..." }]
+ * ```
+ */
+export declare function parseGoMod(content: string): GoModInfo;
+//# sourceMappingURL=go.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"go.d.ts","sourceRoot":"","sources":["../../../../src/analysis/adapters/go.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,YAAa,SAAQ,UAAU;IAC9C,oCAAoC;IACpC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAA;IAChC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjD,4BAA4B;IAC5B,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,SAAQ,eAAe;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAO;IAC3C,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;IA2DpC;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAsCtB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAyHtB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAwCzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAmFrD"}