@skillsmith/core 0.5.4 → 0.5.6

package/dist/activation/ZeroConfigActivator.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @fileoverview Zero-Config Skill Activation System
+ * @module @skillsmith/core/activation/ZeroConfigActivator
+ * @see Phase 4: Trigger System Architecture - Zero-Config Activation
+ *
+ * Enables activation of skills with configuration requirements by:
+ * - Injecting safe default values
+ * - Deferring configuration until first use
+ * - Providing configuration prompts on demand
+ *
+ * @example
+ * const activator = new ZeroConfigActivator(manager);
+ * const result = await activator.activate('community/api-client');
+ * // Skill is activated with defaults, user can configure later
+ */
+import type { ActivationManager, ActivationOptions, ActivationResult } from './ActivationManager.js';
+/**
+ * Skill configuration schema
+ */
+export interface SkillConfigSchema {
+    /** Configuration is required for this skill */
+    config_required: boolean;
+    /** Allow deferred configuration */
+    config_defer: boolean;
+    /** Default configuration values */
+    config_defaults?: Record<string, unknown>;
+    /** Configuration field definitions */
+    config_fields?: ConfigField[];
+}
+/**
+ * Configuration field definition
+ */
+export interface ConfigField {
+    /** Field name */
+    name: string;
+    /** Field type */
+    type: 'string' | 'number' | 'boolean' | 'url' | 'secret';
+    /** Field description */
+    description: string;
+    /** Whether field is required */
+    required: boolean;
+    /** Default value */
+    default?: unknown;
+    /** Validation pattern (for strings) */
+    pattern?: string;
+}
+/**
+ * Configuration status
+ */
+export interface ConfigStatus {
+    /** Whether skill has required configuration */
+    has_config: boolean;
+    /** Whether using default values */
+    using_defaults: boolean;
+    /** Whether user has customized config */
+    user_configured: boolean;
+    /** Configuration fields */
+    fields: ConfigField[];
+    /** Missing required fields */
+    missing_required: string[];
+}
+/**
+ * Zero-config activation options
+ */
+export interface ZeroConfigOptions extends Omit<ActivationOptions, 'auto_configure' | 'skill_id'> {
+    /** Skip configuration entirely (use defaults) */
+    skip_config?: boolean;
+}
+/**
+ * ZeroConfigActivator - Activates skills with automatic default configuration
+ *
+ * Handles skills that require configuration by:
+ * 1. Checking if defaults are available
+ * 2. Injecting defaults during installation
+ * 3. Marking skill as "needs configuration"
+ * 4. Providing configure endpoint for customization
+ */
+export declare class ZeroConfigActivator {
+    private readonly activationManager;
+    constructor(activationManager: ActivationManager);
+    /**
+     * Activate a skill with zero-config defaults
+     *
+     * @param skillId - Skill ID to activate
+     * @param options - Activation options
+     * @returns Activation result with configuration status
+     */
+    activate(skillId: string, options?: ZeroConfigOptions): Promise<ActivationResult & {
+        config_status?: ConfigStatus;
+    }>;
+    /**
+     * Activate skill with default configuration values
+     */
+    private activateWithDefaults;
+    /**
+     * Inject default configuration into skill directory
+     */
+    private injectDefaultConfig;
+    /**
+     * Get configuration schema for a skill
+     *
+     * In production, this would fetch from skill registry
+     * For now, returns mock schema based on skill ID
+     */
+    private getConfigSchema;
+    /**
+     * Get current configuration status for a skill
+     */
+    getConfigStatus(skillId: string, configSchema?: SkillConfigSchema): Promise<ConfigStatus>;
+    /**
+     * Check if a skill needs configuration
+     *
+     * @param skillId - Skill ID to check
+     * @returns Whether skill needs user configuration
+     */
+    needsConfiguration(skillId: string): Promise<boolean>;
+    /**
+     * Generate configuration prompt for user
+     *
+     * @param skillId - Skill ID
+     * @returns Configuration instructions
+     */
+    getConfigurationPrompt(skillId: string): Promise<string>;
+}
+export default ZeroConfigActivator;
+//# sourceMappingURL=ZeroConfigActivator.d.ts.map

package/dist/activation/ZeroConfigActivator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZeroConfigActivator.d.ts","sourceRoot":"","sources":["../../src/activation/ZeroConfigActivator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAIpG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAA;IACxB,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAA;IACrB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,sCAAsC;IACtC,aAAa,CAAC,EAAE,WAAW,EAAE,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAA;IACxD,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAA;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAA;IACnB,mCAAmC;IACnC,cAAc,EAAE,OAAO,CAAA;IACvB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAA;IACxB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,UAAU,CAAC;IAC/F,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,iBAAiB;IAIjE;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,GAAG;QAAE,aAAa,CAAC,EAAE,YAAY,CAAA;KAAE,CAAC;IA0C/D;;OAEG;YACW,oBAAoB;IA8BlC;;OAEG;YACW,mBAAmB;IAoCjC;;;;;OAKG;YACW,eAAe;IAoD7B;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IA6B/F;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3D;;;;;OAKG;IACG,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiC/D;AAED,eAAe,mBAAmB,CAAA"}

package/dist/activation/ZeroConfigActivator.js

@@ -0,0 +1,259 @@
+/**
+ * @fileoverview Zero-Config Skill Activation System
+ * @module @skillsmith/core/activation/ZeroConfigActivator
+ * @see Phase 4: Trigger System Architecture - Zero-Config Activation
+ *
+ * Enables activation of skills with configuration requirements by:
+ * - Injecting safe default values
+ * - Deferring configuration until first use
+ * - Providing configuration prompts on demand
+ *
+ * @example
+ * const activator = new ZeroConfigActivator(manager);
+ * const result = await activator.activate('community/api-client');
+ * // Skill is activated with defaults, user can configure later
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('ZeroConfigActivator');
+/**
+ * ZeroConfigActivator - Activates skills with automatic default configuration
+ *
+ * Handles skills that require configuration by:
+ * 1. Checking if defaults are available
+ * 2. Injecting defaults during installation
+ * 3. Marking skill as "needs configuration"
+ * 4. Providing configure endpoint for customization
+ */
+export class ZeroConfigActivator {
+    activationManager;
+    constructor(activationManager) {
+        this.activationManager = activationManager;
+        log.info('ZeroConfigActivator initialized');
+    }
+    /**
+     * Activate a skill with zero-config defaults
+     *
+     * @param skillId - Skill ID to activate
+     * @param options - Activation options
+     * @returns Activation result with configuration status
+     */
+    async activate(skillId, options = {}) {
+        log.info('Zero-config activation requested', { skillId });
+        // Get skill configuration schema (in production, fetch from registry)
+        const configSchema = await this.getConfigSchema(skillId);
+        // Check if configuration is required
+        if (!configSchema.config_required) {
+            // No config needed, activate normally
+            log.debug('Skill does not require configuration', { skillId });
+            return this.activationManager.activateSkill({
+                ...options,
+                skill_id: skillId,
+            });
+        }
+        // Check if config can be deferred
+        if (!configSchema.config_defer) {
+            // Config required upfront, cannot use zero-config
+            log.warn('Skill requires configuration upfront', { skillId });
+            return {
+                success: false,
+                skill_id: skillId,
+                activation_time_ms: 0,
+                requires_restart: false,
+                error: 'Configuration required. Run skill_configure first.',
+            };
+        }
+        // Activate with defaults
+        log.info('Activating with default configuration', { skillId });
+        const result = await this.activateWithDefaults(skillId, configSchema, options);
+        // Get configuration status
+        const configStatus = await this.getConfigStatus(skillId, configSchema);
+        return {
+            ...result,
+            config_status: configStatus,
+        };
+    }
+    /**
+     * Activate skill with default configuration values
+     */
+    async activateWithDefaults(skillId, configSchema, options) {
+        // Activate the skill first
+        const result = await this.activationManager.activateSkill({
+            ...options,
+            skill_id: skillId,
+            auto_configure: true,
+        });
+        if (!result.success || !result.install_path) {
+            return result;
+        }
+        // Inject default configuration
+        try {
+            await this.injectDefaultConfig(result.install_path, configSchema);
+            log.info('Default configuration injected', { skillId });
+        }
+        catch (error) {
+            log.error('Failed to inject default config', error instanceof Error ? error : undefined, {
+                skillId,
+            });
+            // Don't fail activation, just log warning
+        }
+        return result;
+    }
+    /**
+     * Inject default configuration into skill directory
+     */
+    async injectDefaultConfig(installPath, configSchema) {
+        const configPath = path.join(installPath, 'config.json');
+        // Build config from defaults and field definitions
+        const config = {
+            ...configSchema.config_defaults,
+        };
+        // Add defaults from field definitions
+        if (configSchema.config_fields) {
+            for (const field of configSchema.config_fields) {
+                if (field.default !== undefined && config[field.name] === undefined) {
+                    config[field.name] = field.default;
+                }
+            }
+        }
+        // Add metadata
+        const configWithMeta = {
+            ...config,
+            _meta: {
+                using_defaults: true,
+                configured_at: new Date().toISOString(),
+                source: 'zero-config',
+            },
+        };
+        // Write config file
+        await fs.writeFile(configPath, JSON.stringify(configWithMeta, null, 2), 'utf-8');
+        log.debug('Config file written', { configPath });
+    }
+    /**
+     * Get configuration schema for a skill
+     *
+     * In production, this would fetch from skill registry
+     * For now, returns mock schema based on skill ID
+     */
+    async getConfigSchema(skillId) {
+        // Mock schemas for demo skills
+        const mockSchemas = {
+            'community/api-client': {
+                config_required: true,
+                config_defer: true,
+                config_defaults: {
+                    api_endpoint: 'https://api.example.com',
+                    timeout_ms: 5000,
+                    retry_attempts: 3,
+                },
+                config_fields: [
+                    {
+                        name: 'api_endpoint',
+                        type: 'url',
+                        description: 'API base endpoint URL',
+                        required: true,
+                        default: 'https://api.example.com',
+                    },
+                    {
+                        name: 'api_key',
+                        type: 'secret',
+                        description: 'API authentication key',
+                        required: true,
+                    },
+                    {
+                        name: 'timeout_ms',
+                        type: 'number',
+                        description: 'Request timeout in milliseconds',
+                        required: false,
+                        default: 5000,
+                    },
+                    {
+                        name: 'retry_attempts',
+                        type: 'number',
+                        description: 'Number of retry attempts on failure',
+                        required: false,
+                        default: 3,
+                    },
+                ],
+            },
+        };
+        // Return mock schema or default
+        return (mockSchemas[skillId] || {
+            config_required: false,
+            config_defer: false,
+        });
+    }
+    /**
+     * Get current configuration status for a skill
+     */
+    async getConfigStatus(skillId, configSchema) {
+        const schema = configSchema || (await this.getConfigSchema(skillId));
+        if (!schema.config_required) {
+            return {
+                has_config: false,
+                using_defaults: false,
+                user_configured: false,
+                fields: [],
+                missing_required: [],
+            };
+        }
+        // In production, read actual config file
+        // For now, return status based on schema
+        const requiredFields = schema.config_fields?.filter((f) => f.required) || [];
+        const missingRequired = requiredFields
+            .filter((f) => !schema.config_defaults?.[f.name])
+            .map((f) => f.name);
+        return {
+            has_config: true,
+            using_defaults: true,
+            user_configured: false,
+            fields: schema.config_fields || [],
+            missing_required: missingRequired,
+        };
+    }
+    /**
+     * Check if a skill needs configuration
+     *
+     * @param skillId - Skill ID to check
+     * @returns Whether skill needs user configuration
+     */
+    async needsConfiguration(skillId) {
+        const status = await this.getConfigStatus(skillId);
+        return status.has_config && !status.user_configured && status.missing_required.length > 0;
+    }
+    /**
+     * Generate configuration prompt for user
+     *
+     * @param skillId - Skill ID
+     * @returns Configuration instructions
+     */
+    async getConfigurationPrompt(skillId) {
+        const configSchema = await this.getConfigSchema(skillId);
+        if (!configSchema.config_required) {
+            return 'This skill does not require configuration.';
+        }
+        const status = await this.getConfigStatus(skillId, configSchema);
+        if (status.missing_required.length === 0) {
+            return 'Skill is fully configured with defaults. You can customize it if needed.';
+        }
+        const lines = [];
+        lines.push(`\n=== Configuration Required: ${skillId} ===\n`);
+        lines.push('The following fields need configuration:\n');
+        for (const fieldName of status.missing_required) {
+            const field = status.fields.find((f) => f.name === fieldName);
+            if (field) {
+                lines.push(`  ${field.name} (${field.type})`);
+                lines.push(`    ${field.description}`);
+                if (field.default) {
+                    lines.push(`    Default: ${field.default}`);
+                }
+                lines.push('');
+            }
+        }
+        lines.push('Run: skill_configure ' + skillId);
+        return lines.join('\n');
+    }
+}
+export default ZeroConfigActivator;
+//# sourceMappingURL=ZeroConfigActivator.js.map

package/dist/activation/ZeroConfigActivator.js.map

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

package/dist/activation/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Skill Activation System
+ * @module @skillsmith/core/activation
+ * @see Phase 4: Trigger System Architecture
+ */
+export { ActivationManager, type ActivationOptions, type ActivationResult, } from './ActivationManager.js';
+export { ZeroConfigActivator, type SkillConfigSchema, type ConfigField, type ConfigStatus, type ZeroConfigOptions, } from './ZeroConfigActivator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/activation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/activation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAA"}

package/dist/activation/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Skill Activation System
+ * @module @skillsmith/core/activation
+ * @see Phase 4: Trigger System Architecture
+ */
+export { ActivationManager, } from './ActivationManager.js';
+export { ZeroConfigActivator, } from './ZeroConfigActivator.js';
+//# sourceMappingURL=index.js.map

package/dist/activation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/activation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,mBAAmB,GAKpB,MAAM,0BAA0B,CAAA"}

package/dist/analysis/CodebaseAnalyzer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SMI-600: CodebaseAnalyzer
+ * SMI-1189: Refactored to use extracted modules
+ *
+ * Analyzes TypeScript/JavaScript codebases to extract structure and patterns.
+ * Uses TypeScript compiler API for accurate AST parsing.
+ * Focuses on TS/JS only per ADR-010.
+ *
+ * @see ADR-010: Codebase Analysis Scope
+ */
+import { type CodebaseContext, type AnalyzeOptions } from './types.js';
+export type { ImportInfo, ExportInfo, FunctionInfo, FrameworkInfo, DependencyInfo, CodebaseContext, AnalyzeOptions, } from './types.js';
+/**
+ * CodebaseAnalyzer - Analyzes TypeScript/JavaScript codebases
+ *
+ * @example
+ * const analyzer = new CodebaseAnalyzer();
+ * const context = await analyzer.analyze('/path/to/project');
+ * console.log(context.frameworks);
+ */
+export declare class CodebaseAnalyzer {
+    private readonly version;
+    /**
+     * Analyze a codebase and extract context for skill recommendations
+     *
+     * @param rootPath - Root directory of the codebase
+     * @param options - Analysis options
+     * @returns CodebaseContext with extracted information
+     */
+    analyze(rootPath: string, options?: AnalyzeOptions): Promise<CodebaseContext>;
+    /**
+     * Find all source files in directory
+     */
+    private findSourceFiles;
+    /**
+     * Read dependencies from package.json
+     */
+    private readDependencies;
+    /**
+     * Get a summary of the codebase for skill matching
+     */
+    getSummary(context: CodebaseContext): string;
+}
+export default CodebaseAnalyzer;
+//# sourceMappingURL=CodebaseAnalyzer.d.ts.map

package/dist/analysis/CodebaseAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodebaseAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/CodebaseAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAA;AAKnB,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC;;;;;;OAMG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsEvF;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;CAiC7C;AAED,eAAe,gBAAgB,CAAA"}

package/dist/analysis/CodebaseAnalyzer.js

@@ -0,0 +1,187 @@
+/**
+ * SMI-600: CodebaseAnalyzer
+ * SMI-1189: Refactored to use extracted modules
+ *
+ * Analyzes TypeScript/JavaScript codebases to extract structure and patterns.
+ * Uses TypeScript compiler API for accurate AST parsing.
+ * Focuses on TS/JS only per ADR-010.
+ *
+ * @see ADR-010: Codebase Analysis Scope
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { SUPPORTED_EXTENSIONS, DEFAULT_EXCLUDE_DIRS, } from './types.js';
+import { parseFile } from './parsers.js';
+import { detectFrameworks } from './framework-detector.js';
+/**
+ * CodebaseAnalyzer - Analyzes TypeScript/JavaScript codebases
+ *
+ * @example
+ * const analyzer = new CodebaseAnalyzer();
+ * const context = await analyzer.analyze('/path/to/project');
+ * console.log(context.frameworks);
+ */
+export class CodebaseAnalyzer {
+    version = '1.0.0';
+    /**
+     * Analyze a codebase and extract context for skill recommendations
+     *
+     * @param rootPath - Root directory of the codebase
+     * @param options - Analysis options
+     * @returns CodebaseContext with extracted information
+     */
+    async analyze(rootPath, options = {}) {
+        const startTime = performance.now();
+        const { maxFiles = 1000, excludeDirs = DEFAULT_EXCLUDE_DIRS, includeDevDeps = true } = options;
+        // Resolve to absolute path
+        const absolutePath = path.resolve(rootPath);
+        // Verify directory exists
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`Directory not found: ${absolutePath}`);
+        }
+        // Find all source files
+        const sourceFiles = this.findSourceFiles(absolutePath, excludeDirs, maxFiles);
+        // Parse all files and extract information
+        const imports = [];
+        const exports = [];
+        const functions = [];
+        const filesByExtension = {};
+        let totalLines = 0;
+        for (const filePath of sourceFiles) {
+            const ext = path.extname(filePath);
+            filesByExtension[ext] = (filesByExtension[ext] || 0) + 1;
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                totalLines += content.split('\n').length;
+                const relativePath = path.relative(absolutePath, filePath);
+                const fileInfo = parseFile(content, relativePath);
+                imports.push(...fileInfo.imports);
+                exports.push(...fileInfo.exports);
+                functions.push(...fileInfo.functions);
+            }
+            catch (error) {
+                // Skip files that can't be read/parsed
+                console.warn(`Failed to parse ${filePath}:`, error);
+            }
+        }
+        // Read dependencies from package.json
+        const dependencies = this.readDependencies(absolutePath, includeDevDeps);
+        // Detect frameworks
+        const frameworks = detectFrameworks(imports, dependencies);
+        const endTime = performance.now();
+        return {
+            rootPath: absolutePath,
+            imports,
+            exports,
+            functions,
+            frameworks,
+            dependencies,
+            stats: {
+                totalFiles: sourceFiles.length,
+                filesByExtension,
+                totalLines,
+            },
+            metadata: {
+                durationMs: Math.round(endTime - startTime),
+                version: this.version,
+            },
+        };
+    }
+    /**
+     * Find all source files in directory
+     */
+    findSourceFiles(dir, excludeDirs, maxFiles) {
+        const files = [];
+        const walk = (currentDir) => {
+            if (files.length >= maxFiles)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(currentDir, { withFileTypes: true });
+            }
+            catch {
+                return; // Skip directories we can't read
+            }
+            for (const entry of entries) {
+                if (files.length >= maxFiles)
+                    break;
+                const fullPath = path.join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    // Skip excluded directories
+                    if (!excludeDirs.includes(entry.name)) {
+                        walk(fullPath);
+                    }
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name);
+                    if (SUPPORTED_EXTENSIONS.includes(ext)) {
+                        files.push(fullPath);
+                    }
+                }
+            }
+        };
+        walk(dir);
+        return files;
+    }
+    /**
+     * Read dependencies from package.json
+     */
+    readDependencies(rootPath, includeDevDeps) {
+        const packageJsonPath = path.join(rootPath, 'package.json');
+        const dependencies = [];
+        if (!fs.existsSync(packageJsonPath)) {
+            return dependencies;
+        }
+        try {
+            const content = fs.readFileSync(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            if (pkg.dependencies) {
+                for (const [name, version] of Object.entries(pkg.dependencies)) {
+                    dependencies.push({ name, version, isDev: false });
+                }
+            }
+            if (includeDevDeps && pkg.devDependencies) {
+                for (const [name, version] of Object.entries(pkg.devDependencies)) {
+                    dependencies.push({ name, version, isDev: true });
+                }
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+        return dependencies;
+    }
+    /**
+     * Get a summary of the codebase for skill matching
+     */
+    getSummary(context) {
+        const parts = [];
+        // Frameworks
+        if (context.frameworks.length > 0) {
+            const topFrameworks = context.frameworks
+                .slice(0, 5)
+                .map((f) => f.name)
+                .join(', ');
+            parts.push(`Frameworks: ${topFrameworks}`);
+        }
+        // Top dependencies
+        const prodDeps = context.dependencies
+            .filter((d) => !d.isDev)
+            .slice(0, 10)
+            .map((d) => d.name);
+        if (prodDeps.length > 0) {
+            parts.push(`Dependencies: ${prodDeps.join(', ')}`);
+        }
+        // File stats
+        parts.push(`Files: ${context.stats.totalFiles} (${context.stats.totalLines} lines)`);
+        // Top extensions
+        const extensions = Object.entries(context.stats.filesByExtension)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 3)
+            .map(([ext, count]) => `${ext}: ${count}`);
+        parts.push(`Types: ${extensions.join(', ')}`);
+        return parts.join(' | ');
+    }
+}
+export default CodebaseAnalyzer;
+//# sourceMappingURL=CodebaseAnalyzer.js.map