@ai-coders/context 0.5.2 → 0.6.1

package/dist/workflow/skills/skillRegistry.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * Skill Registry
+ *
+ * Centralized management for skill discovery and metadata retrieval.
+ * Supports both built-in and custom skills.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillRegistry = void 0;
+exports.createSkillRegistry = createSkillRegistry;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_1 = require("./types");
+const skillTemplates_1 = require("./skillTemplates");
+const frontmatter_1 = require("./frontmatter");
+/** Default skills directory path */
+const SKILLS_DIR = '.context/skills';
+class SkillRegistry {
+    constructor(repoPath) {
+        this.cache = null;
+        this.repoPath = repoPath;
+        this.contextPath = path.join(repoPath, SKILLS_DIR);
+    }
+    /**
+     * Discover all available skills (built-in + custom)
+     */
+    async discoverAll() {
+        if (this.cache) {
+            return this.cache;
+        }
+        const builtIn = this.discoverBuiltInSkills();
+        const custom = this.discoverCustomSkills();
+        this.cache = {
+            builtIn,
+            custom,
+            all: [...builtIn, ...custom],
+        };
+        return this.cache;
+    }
+    /**
+     * Get skill metadata by slug
+     */
+    async getSkillMetadata(slug) {
+        const discovered = await this.discoverAll();
+        return discovered.all.find((s) => s.slug === slug) || null;
+    }
+    /**
+     * Get skill content (full SKILL.md)
+     */
+    async getSkillContent(slug) {
+        const skill = await this.getSkillMetadata(slug);
+        if (!skill)
+            return null;
+        try {
+            return fs.readFileSync(skill.path, 'utf-8');
+        }
+        catch (error) {
+            console.error(`Failed to read skill file: ${skill.path}`, error);
+            return null;
+        }
+    }
+    /**
+     * Get skills for a PREVC phase
+     */
+    async getSkillsForPhase(phase) {
+        const discovered = await this.discoverAll();
+        return discovered.all.filter((skill) => skill.metadata.phases?.includes(phase));
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache = null;
+    }
+    /**
+     * Discover built-in skills from templates
+     */
+    discoverBuiltInSkills() {
+        const skills = [];
+        const templates = (0, skillTemplates_1.getBuiltInSkillTemplates)();
+        for (const skillType of types_1.BUILT_IN_SKILLS) {
+            const skillPath = path.join(this.contextPath, skillType, 'SKILL.md');
+            if (fs.existsSync(skillPath)) {
+                const skill = this.parseSkillFile(skillPath, skillType, true);
+                if (skill) {
+                    skills.push(skill);
+                }
+            }
+            else {
+                // Create virtual skill from built-in template
+                const skill = this.createBuiltInSkill(skillType, templates);
+                skills.push(skill);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Discover custom skills from .context/skills/
+     */
+    discoverCustomSkills() {
+        const skills = [];
+        if (!fs.existsSync(this.contextPath)) {
+            return skills;
+        }
+        try {
+            const entries = fs.readdirSync(this.contextPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const slug = entry.name;
+                // Skip built-in skills (already handled)
+                if ((0, types_1.isBuiltInSkill)(slug))
+                    continue;
+                const skillPath = path.join(this.contextPath, slug, 'SKILL.md');
+                if (fs.existsSync(skillPath)) {
+                    const skill = this.parseSkillFile(skillPath, slug, false);
+                    if (skill) {
+                        skills.push(skill);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error('Failed to discover custom skills:', error);
+        }
+        return skills;
+    }
+    /**
+     * Parse a SKILL.md file
+     */
+    parseSkillFile(skillPath, slug, isBuiltIn) {
+        try {
+            const content = fs.readFileSync(skillPath, 'utf-8');
+            const { metadata, body } = (0, frontmatter_1.parseFrontmatter)(content);
+            if (!metadata.name || !metadata.description) {
+                console.warn(`Skill ${slug} missing required name or description`);
+                return null;
+            }
+            const skillDir = path.dirname(skillPath);
+            const resources = this.discoverResources(skillDir);
+            return {
+                slug,
+                path: skillPath,
+                metadata,
+                content: body,
+                resources,
+                isBuiltIn,
+            };
+        }
+        catch (error) {
+            console.error(`Failed to parse skill file: ${skillPath}`, error);
+            return null;
+        }
+    }
+    /**
+     * Discover resource files in skill directory
+     */
+    discoverResources(skillDir) {
+        const resources = [];
+        try {
+            const entries = fs.readdirSync(skillDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name === 'SKILL.md')
+                    continue;
+                const fullPath = path.join(skillDir, entry.name);
+                if (entry.isFile()) {
+                    resources.push(fullPath);
+                }
+                else if (entry.isDirectory()) {
+                    resources.push(...this.discoverResourcesRecursive(fullPath));
+                }
+            }
+        }
+        catch (error) {
+            // Directory might not exist or be readable
+        }
+        return resources;
+    }
+    discoverResourcesRecursive(dir) {
+        const resources = [];
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isFile()) {
+                    resources.push(fullPath);
+                }
+                else if (entry.isDirectory()) {
+                    resources.push(...this.discoverResourcesRecursive(fullPath));
+                }
+            }
+        }
+        catch (error) {
+            // Directory might not exist or be readable
+        }
+        return resources;
+    }
+    /**
+     * Create a virtual built-in skill (not yet scaffolded)
+     */
+    createBuiltInSkill(skillType, templates) {
+        const template = templates[skillType];
+        return {
+            slug: skillType,
+            path: path.join(this.contextPath, skillType, 'SKILL.md'),
+            metadata: {
+                name: skillType,
+                description: template.description,
+                phases: types_1.SKILL_TO_PHASES[skillType],
+            },
+            content: template.content,
+            resources: [],
+            isBuiltIn: true,
+        };
+    }
+}
+exports.SkillRegistry = SkillRegistry;
+/**
+ * Factory function
+ */
+function createSkillRegistry(repoPath) {
+    return new SkillRegistry(repoPath);
+}
+//# sourceMappingURL=skillRegistry.js.map

package/dist/workflow/skills/skillRegistry.js.map

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

package/dist/workflow/skills/skillTemplates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Built-in Skill Templates
+ *
+ * Separated from SkillRegistry to follow Single Responsibility Principle.
+ * Each template contains description and markdown content for a built-in skill.
+ */
+import { BuiltInSkillType } from './types';
+export interface SkillTemplate {
+    description: string;
+    content: string;
+}
+/**
+ * Get all built-in skill templates
+ */
+export declare function getBuiltInSkillTemplates(): Record<BuiltInSkillType, SkillTemplate>;
+//# sourceMappingURL=skillTemplates.d.ts.map

package/dist/workflow/skills/skillTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillTemplates.d.ts","sourceRoot":"","sources":["../../../src/workflow/skills/skillTemplates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAalF"}