@codemieai/code 0.0.32 → 0.0.34

package/dist/skills/core/SkillDiscovery.d.ts

@@ -0,0 +1,83 @@
+import type { Skill, SkillDiscoveryOptions } from './types.js';
+/**
+ * Skill discovery engine
+ *
+ * Discovers SKILL.md files from multiple locations, parses frontmatter,
+ * validates metadata, and applies priority sorting.
+ */
+export declare class SkillDiscovery {
+    private cache;
+    /**
+     * Discover all skills matching the given options
+     *
+     * @param options - Discovery options (cwd, mode, agent, forceReload)
+     * @returns Array of discovered and validated skills, sorted by priority
+     */
+    discoverSkills(options?: SkillDiscoveryOptions): Promise<Skill[]>;
+    /**
+     * Discover skills from project directory (.codemie/skills/)
+     */
+    private discoverProjectSkills;
+    /**
+     * Discover skills from mode-specific directory (~/.codemie/skills-{mode}/)
+     */
+    private discoverModeSkills;
+    /**
+     * Discover skills from global directory (~/.codemie/skills/)
+     */
+    private discoverGlobalSkills;
+    /**
+     * Discover skills from a specific directory
+     *
+     * @param directory - Directory to search
+     * @param source - Source type (project, mode-specific, global)
+     * @returns Array of discovered skills
+     */
+    private discoverFromDirectory;
+    /**
+     * Parse a single skill file
+     *
+     * @param filePath - Absolute path to SKILL.md
+     * @param source - Source type
+     * @returns Parse result with skill or error
+     */
+    private parseSkillFile;
+    /**
+     * Compute priority for a skill
+     *
+     * Priority = source base priority + metadata priority
+     */
+    private computePriority;
+    /**
+     * Deduplicate skills by name (higher priority wins)
+     */
+    private deduplicateSkills;
+    /**
+     * Filter skills by agent compatibility
+     */
+    private filterByAgent;
+    /**
+     * Filter skills by mode
+     */
+    private filterByMode;
+    /**
+     * Sort skills by computed priority (descending)
+     */
+    private sortByPriority;
+    /**
+     * Generate cache key from options
+     */
+    private getCacheKey;
+    /**
+     * Clear cache (force reload on next discovery)
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics (for debugging)
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+//# sourceMappingURL=SkillDiscovery.d.ts.map

package/dist/skills/core/SkillDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDiscovery.d.ts","sourceRoot":"","sources":["../../../src/skills/core/SkillDiscovery.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,KAAK,EAIL,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAYpB;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAmC;IAEhD;;;;;OAKG;IACG,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAwC3E;;OAEG;YACW,qBAAqB;IAKnC;;OAEG;YACW,kBAAkB;IAOhC;;OAEG;YACW,oBAAoB;IAKlC;;;;;;OAMG;YACW,qBAAqB;IAiCnC;;;;;;OAMG;YACW,cAAc;IA8C5B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;CAMlD"}

package/dist/skills/core/SkillDiscovery.js

@@ -0,0 +1,237 @@
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import fg from 'fast-glob';
+import { getCodemiePath } from '../../utils/paths.js';
+import { parseFrontmatter, FrontmatterParseError } from '../utils/frontmatter.js';
+import { SkillMetadataSchema } from './types.js';
+/**
+ * Priority multipliers for skill sources
+ * Higher priority = loaded first, can override lower priority
+ */
+const SOURCE_PRIORITY = {
+    project: 1000, // Highest priority
+    'mode-specific': 500, // Medium priority
+    global: 100, // Lowest priority
+};
+/**
+ * Skill discovery engine
+ *
+ * Discovers SKILL.md files from multiple locations, parses frontmatter,
+ * validates metadata, and applies priority sorting.
+ */
+export class SkillDiscovery {
+    cache = new Map();
+    /**
+     * Discover all skills matching the given options
+     *
+     * @param options - Discovery options (cwd, mode, agent, forceReload)
+     * @returns Array of discovered and validated skills, sorted by priority
+     */
+    async discoverSkills(options = {}) {
+        const { cwd = process.cwd(), forceReload = false } = options;
+        // Check cache first
+        const cacheKey = this.getCacheKey(options);
+        if (!forceReload && this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        // Discover from all locations
+        const [projectSkills, modeSkills, globalSkills] = await Promise.all([
+            this.discoverProjectSkills(cwd),
+            this.discoverModeSkills(options.mode),
+            this.discoverGlobalSkills(),
+        ]);
+        // Combine and deduplicate by name (higher priority wins)
+        const allSkills = [...projectSkills, ...modeSkills, ...globalSkills];
+        const deduplicatedSkills = this.deduplicateSkills(allSkills);
+        // Filter by agent if specified
+        let filteredSkills = deduplicatedSkills;
+        if (options.agentName) {
+            filteredSkills = this.filterByAgent(deduplicatedSkills, options.agentName);
+        }
+        // Filter by mode if specified
+        if (options.mode) {
+            filteredSkills = this.filterByMode(filteredSkills, options.mode);
+        }
+        // Sort by computed priority (descending)
+        const sortedSkills = this.sortByPriority(filteredSkills);
+        // Cache result
+        this.cache.set(cacheKey, sortedSkills);
+        return sortedSkills;
+    }
+    /**
+     * Discover skills from project directory (.codemie/skills/)
+     */
+    async discoverProjectSkills(cwd) {
+        const projectSkillsDir = join(cwd, '.codemie', 'skills');
+        return this.discoverFromDirectory(projectSkillsDir, 'project');
+    }
+    /**
+     * Discover skills from mode-specific directory (~/.codemie/skills-{mode}/)
+     */
+    async discoverModeSkills(mode) {
+        if (!mode)
+            return [];
+        const modeSkillsDir = getCodemiePath(`skills-${mode}`);
+        return this.discoverFromDirectory(modeSkillsDir, 'mode-specific');
+    }
+    /**
+     * Discover skills from global directory (~/.codemie/skills/)
+     */
+    async discoverGlobalSkills() {
+        const globalSkillsDir = getCodemiePath('skills');
+        return this.discoverFromDirectory(globalSkillsDir, 'global');
+    }
+    /**
+     * Discover skills from a specific directory
+     *
+     * @param directory - Directory to search
+     * @param source - Source type (project, mode-specific, global)
+     * @returns Array of discovered skills
+     */
+    async discoverFromDirectory(directory, source) {
+        try {
+            // Find all SKILL.md files (case-insensitive, up to 3 levels deep)
+            const pattern = '**/SKILL.md';
+            const files = await fg(pattern, {
+                cwd: directory,
+                absolute: true,
+                caseSensitiveMatch: false,
+                deep: 3,
+                ignore: ['**/node_modules/**', '**/.git/**'],
+                onlyFiles: true,
+            });
+            // Parse all skill files
+            const parseResults = await Promise.all(files.map((filePath) => this.parseSkillFile(filePath, source)));
+            // Filter out errors and return valid skills
+            const skills = parseResults
+                .filter((result) => result.skill !== undefined)
+                .map((result) => result.skill);
+            return skills;
+        }
+        catch {
+            // Directory doesn't exist or other error - return empty array
+            return [];
+        }
+    }
+    /**
+     * Parse a single skill file
+     *
+     * @param filePath - Absolute path to SKILL.md
+     * @param source - Source type
+     * @returns Parse result with skill or error
+     */
+    async parseSkillFile(filePath, source) {
+        try {
+            // Read file
+            const fileContent = await readFile(filePath, 'utf-8');
+            // Parse frontmatter
+            const { metadata, content } = parseFrontmatter(fileContent, filePath);
+            // Validate metadata with Zod
+            const validatedMetadata = SkillMetadataSchema.parse(metadata);
+            // Compute priority
+            const computedPriority = this.computePriority(validatedMetadata, source);
+            // Create skill object
+            const skill = {
+                metadata: validatedMetadata,
+                content: content.trim(),
+                filePath,
+                source,
+                computedPriority,
+            };
+            return { skill };
+        }
+        catch (error) {
+            // Log error but don't throw - allow partial discovery
+            const errorMessage = error instanceof FrontmatterParseError
+                ? error.message
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            return {
+                error: {
+                    filePath,
+                    message: errorMessage,
+                    cause: error,
+                },
+            };
+        }
+    }
+    /**
+     * Compute priority for a skill
+     *
+     * Priority = source base priority + metadata priority
+     */
+    computePriority(metadata, source) {
+        const sourceBasePriority = SOURCE_PRIORITY[source];
+        const metadataPriority = metadata.priority || 0;
+        return sourceBasePriority + metadataPriority;
+    }
+    /**
+     * Deduplicate skills by name (higher priority wins)
+     */
+    deduplicateSkills(skills) {
+        const skillMap = new Map();
+        for (const skill of skills) {
+            const existingSkill = skillMap.get(skill.metadata.name);
+            if (!existingSkill || skill.computedPriority > existingSkill.computedPriority) {
+                skillMap.set(skill.metadata.name, skill);
+            }
+        }
+        return Array.from(skillMap.values());
+    }
+    /**
+     * Filter skills by agent compatibility
+     */
+    filterByAgent(skills, agentName) {
+        return skills.filter((skill) => {
+            // If no compatibility specified, skill is compatible with all agents
+            if (!skill.metadata.compatibility?.agents) {
+                return true;
+            }
+            // Check if agent is in compatibility list
+            return skill.metadata.compatibility.agents.includes(agentName);
+        });
+    }
+    /**
+     * Filter skills by mode
+     */
+    filterByMode(skills, mode) {
+        return skills.filter((skill) => {
+            // If no modes specified, skill is available in all modes
+            if (!skill.metadata.modes || skill.metadata.modes.length === 0) {
+                return true;
+            }
+            // Check if mode is in modes list
+            return skill.metadata.modes.includes(mode);
+        });
+    }
+    /**
+     * Sort skills by computed priority (descending)
+     */
+    sortByPriority(skills) {
+        return [...skills].sort((a, b) => b.computedPriority - a.computedPriority);
+    }
+    /**
+     * Generate cache key from options
+     */
+    getCacheKey(options) {
+        const { cwd = process.cwd(), mode, agentName } = options;
+        return `${cwd}::${mode || ''}::${agentName || ''}`;
+    }
+    /**
+     * Clear cache (force reload on next discovery)
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics (for debugging)
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys()),
+        };
+    }
+}
+//# sourceMappingURL=SkillDiscovery.js.map

package/dist/skills/core/SkillDiscovery.js.map

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

package/dist/skills/core/SkillManager.d.ts

@@ -0,0 +1,86 @@
+import type { Skill, SkillDiscoveryOptions, SkillValidationResult, SkillWithInventory } from './types.js';
+/**
+ * Skill manager singleton
+ *
+ * Provides high-level API for skill management:
+ * - Discovery and caching
+ * - Agent-aware filtering
+ * - Validation
+ * - Cache management
+ */
+export declare class SkillManager {
+    private static instance;
+    private discovery;
+    /**
+     * Private constructor (singleton pattern)
+     */
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): SkillManager;
+    /**
+     * Get skills for a specific agent
+     *
+     * @param agentName - Name of the agent (e.g., 'codemie-code')
+     * @param options - Additional discovery options
+     * @returns Array of skills compatible with the agent
+     */
+    getSkillsForAgent(agentName: string, options?: Omit<SkillDiscoveryOptions, 'agentName'>): Promise<Skill[]>;
+    /**
+     * Get a specific skill by name
+     *
+     * @param name - Skill name
+     * @param options - Discovery options
+     * @returns Skill if found, undefined otherwise
+     */
+    getSkillByName(name: string, options?: SkillDiscoveryOptions): Promise<Skill | undefined>;
+    /**
+     * List all discovered skills
+     *
+     * @param options - Discovery options
+     * @returns Array of all skills
+     */
+    listSkills(options?: SkillDiscoveryOptions): Promise<Skill[]>;
+    /**
+     * Get multiple skills by names with file inventory
+     *
+     * Used for pattern-based invocation when /skill-name patterns are detected.
+     * Loads skill content and builds file inventory for each requested skill.
+     *
+     * @param names - Array of skill names to load
+     * @param options - Discovery options
+     * @returns Array of skills with inventory (only found skills)
+     */
+    getSkillsByNames(names: string[], options?: SkillDiscoveryOptions): Promise<SkillWithInventory[]>;
+    /**
+     * Reload skills (clear cache and force re-discovery)
+     *
+     * Call this after adding/removing/modifying skill files
+     */
+    reload(): void;
+    /**
+     * Validate all skill files
+     *
+     * Attempts to discover and parse all skills, returning validation results
+     *
+     * @param options - Discovery options
+     * @returns Validation results for all skills
+     */
+    validateAll(options?: SkillDiscoveryOptions): Promise<{
+        valid: Skill[];
+        invalid: SkillValidationResult[];
+    }>;
+    /**
+     * Get cache statistics (for debugging)
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance(): void;
+}
+//# sourceMappingURL=SkillManager.d.ts.map

package/dist/skills/core/SkillManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillManager.d.ts","sourceRoot":"","sources":["../../../src/skills/core/SkillManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,SAAS,CAAiB;IAElC;;OAEG;IACH,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;;;;;OAMG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,WAAW,CAAM,GACrD,OAAO,CAAC,KAAK,EAAE,CAAC;IAOnB;;;;;;OAMG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAK7B;;;;;OAKG;IACG,UAAU,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAIvE;;;;;;;;;OASG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyBhC;;;;OAIG;IACH,MAAM,IAAI,IAAI;IAId;;;;;;;OAOG;IACG,WAAW,CACf,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAAC,OAAO,EAAE,qBAAqB,EAAE,CAAA;KAAE,CAAC;IAiChE;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE;IAIjD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B"}

package/dist/skills/core/SkillManager.js

@@ -0,0 +1,155 @@
+import { SkillDiscovery } from './SkillDiscovery.js';
+import { loadSkillWithInventory } from '../utils/content-loader.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Skill manager singleton
+ *
+ * Provides high-level API for skill management:
+ * - Discovery and caching
+ * - Agent-aware filtering
+ * - Validation
+ * - Cache management
+ */
+export class SkillManager {
+    static instance;
+    discovery;
+    /**
+     * Private constructor (singleton pattern)
+     */
+    constructor() {
+        this.discovery = new SkillDiscovery();
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!SkillManager.instance) {
+            SkillManager.instance = new SkillManager();
+        }
+        return SkillManager.instance;
+    }
+    /**
+     * Get skills for a specific agent
+     *
+     * @param agentName - Name of the agent (e.g., 'codemie-code')
+     * @param options - Additional discovery options
+     * @returns Array of skills compatible with the agent
+     */
+    async getSkillsForAgent(agentName, options = {}) {
+        return this.discovery.discoverSkills({
+            ...options,
+            agentName,
+        });
+    }
+    /**
+     * Get a specific skill by name
+     *
+     * @param name - Skill name
+     * @param options - Discovery options
+     * @returns Skill if found, undefined otherwise
+     */
+    async getSkillByName(name, options = {}) {
+        const skills = await this.discovery.discoverSkills(options);
+        return skills.find((skill) => skill.metadata.name === name);
+    }
+    /**
+     * List all discovered skills
+     *
+     * @param options - Discovery options
+     * @returns Array of all skills
+     */
+    async listSkills(options = {}) {
+        return this.discovery.discoverSkills(options);
+    }
+    /**
+     * Get multiple skills by names with file inventory
+     *
+     * Used for pattern-based invocation when /skill-name patterns are detected.
+     * Loads skill content and builds file inventory for each requested skill.
+     *
+     * @param names - Array of skill names to load
+     * @param options - Discovery options
+     * @returns Array of skills with inventory (only found skills)
+     */
+    async getSkillsByNames(names, options = {}) {
+        const results = [];
+        // Discover all skills (uses cache)
+        const allSkills = await this.discovery.discoverSkills(options);
+        // Find and load each requested skill
+        for (const name of names) {
+            const skill = allSkills.find((s) => s.metadata.name === name);
+            if (skill) {
+                try {
+                    const withInventory = await loadSkillWithInventory(skill);
+                    results.push(withInventory);
+                }
+                catch (error) {
+                    logger.warn(`Failed to load inventory for skill '${name}':`, error);
+                }
+            }
+            else {
+                logger.debug(`Skill '${name}' not found during pattern invocation`);
+            }
+        }
+        return results;
+    }
+    /**
+     * Reload skills (clear cache and force re-discovery)
+     *
+     * Call this after adding/removing/modifying skill files
+     */
+    reload() {
+        this.discovery.clearCache();
+    }
+    /**
+     * Validate all skill files
+     *
+     * Attempts to discover and parse all skills, returning validation results
+     *
+     * @param options - Discovery options
+     * @returns Validation results for all skills
+     */
+    async validateAll(options = {}) {
+        try {
+            // Force reload to ensure fresh validation
+            const skills = await this.discovery.discoverSkills({
+                ...options,
+                forceReload: true,
+            });
+            // All discovered skills are valid (parsing errors are filtered out in discovery)
+            const valid = skills;
+            // For now, we don't track invalid skills (they're silently filtered)
+            // Future enhancement: return parse errors from discovery
+            const invalid = [];
+            return { valid, invalid };
+        }
+        catch (error) {
+            // Discovery failed entirely
+            return {
+                valid: [],
+                invalid: [
+                    {
+                        valid: false,
+                        filePath: 'unknown',
+                        errors: [
+                            error instanceof Error ? error.message : String(error),
+                        ],
+                    },
+                ],
+            };
+        }
+    }
+    /**
+     * Get cache statistics (for debugging)
+     */
+    getCacheStats() {
+        return this.discovery.getCacheStats();
+    }
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance() {
+        SkillManager.instance = undefined;
+    }
+}
+//# sourceMappingURL=SkillManager.js.map

package/dist/skills/core/SkillManager.js.map

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