@skillsmith/core 0.1.0

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/analysis/CodebaseAnalyzer.d.ts

@@ -0,0 +1,175 @@
+/**
+ * SMI-600: CodebaseAnalyzer
+ * 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 information extracted from source files
+ */
+export interface ImportInfo {
+    /** Module specifier (e.g., 'react', './utils') */
+    module: string;
+    /** Named imports (e.g., ['useState', 'useEffect']) */
+    namedImports: string[];
+    /** Default import name if present */
+    defaultImport?: string;
+    /** Namespace import name if present (import * as X) */
+    namespaceImport?: string;
+    /** Whether this is a type-only import */
+    isTypeOnly: boolean;
+    /** Source file where import was found */
+    sourceFile: string;
+}
+/**
+ * Export information extracted from source files
+ */
+export interface ExportInfo {
+    /** Exported name */
+    name: string;
+    /** Kind of export (function, class, variable, type, interface) */
+    kind: 'function' | 'class' | 'variable' | 'type' | 'interface' | 'enum' | 'unknown';
+    /** Whether this is a default export */
+    isDefault: boolean;
+    /** Source file where export was found */
+    sourceFile: string;
+}
+/**
+ * Function information extracted from source files
+ */
+export interface FunctionInfo {
+    /** Function name */
+    name: string;
+    /** Number of parameters */
+    parameterCount: number;
+    /** Whether function is async */
+    isAsync: boolean;
+    /** Whether function is exported */
+    isExported: boolean;
+    /** Source file where function was found */
+    sourceFile: string;
+    /** Line number */
+    line: number;
+}
+/**
+ * Detected framework information
+ */
+export interface FrameworkInfo {
+    /** Framework name */
+    name: string;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Evidence for detection */
+    evidence: string[];
+}
+/**
+ * Package.json dependency information
+ */
+export interface DependencyInfo {
+    /** Package name */
+    name: string;
+    /** Version specifier */
+    version: string;
+    /** Whether this is a dev dependency */
+    isDev: boolean;
+}
+/**
+ * Complete codebase context for skill recommendations
+ */
+export interface CodebaseContext {
+    /** Root directory analyzed */
+    rootPath: string;
+    /** All imports found in the codebase */
+    imports: ImportInfo[];
+    /** All exports found in the codebase */
+    exports: ExportInfo[];
+    /** All functions found in the codebase */
+    functions: FunctionInfo[];
+    /** Detected frameworks */
+    frameworks: FrameworkInfo[];
+    /** Dependencies from package.json */
+    dependencies: DependencyInfo[];
+    /** File statistics */
+    stats: {
+        /** Total files analyzed */
+        totalFiles: number;
+        /** Files by extension */
+        filesByExtension: Record<string, number>;
+        /** Total lines of code (approximate) */
+        totalLines: number;
+    };
+    /** Analysis metadata */
+    metadata: {
+        /** Analysis duration in ms */
+        durationMs: number;
+        /** Analyzer version */
+        version: string;
+    };
+}
+/**
+ * Options for codebase analysis
+ */
+export interface AnalyzeOptions {
+    /** Maximum files to analyze (default: 1000) */
+    maxFiles?: number;
+    /** Directories to exclude (default: node_modules, dist, .git) */
+    excludeDirs?: string[];
+    /** Include dev dependencies in analysis */
+    includeDevDeps?: boolean;
+}
+/**
+ * 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;
+    /**
+     * Parse a single file and extract information
+     */
+    private parseFile;
+    /**
+     * Extract import information from an import declaration
+     */
+    private extractImport;
+    /**
+     * Extract export information from an export declaration
+     */
+    private extractExport;
+    /**
+     * Extract function information from a function declaration
+     */
+    private extractFunction;
+    /**
+     * Read dependencies from package.json
+     */
+    private readDependencies;
+    /**
+     * Detect frameworks based on imports and dependencies
+     */
+    private detectFrameworks;
+    /**
+     * Get a summary of the codebase for skill matching
+     */
+    getSummary(context: CodebaseContext): string;
+}
+export default CodebaseAnalyzer;
+//# sourceMappingURL=CodebaseAnalyzer.d.ts.map

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

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