@dotcontext/cli 0.8.0

package/dist/workflow/skills/skillRegistry.js

@@ -0,0 +1,276 @@
+"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';
+/** Secondary skills directory (cross-client interoperability) */
+const AGENTS_SKILLS_DIR = '.agents/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/ and .agents/skills/
+     *
+     * Skills from .context/skills/ take precedence over .agents/skills/
+     * on name collisions (project-level skills override cross-client ones).
+     */
+    discoverCustomSkills() {
+        const skills = [];
+        const discoveredSlugs = new Set();
+        // 1. Discover from .context/skills/ (highest priority)
+        this.discoverSkillsFromDirectory(this.contextPath, skills, discoveredSlugs);
+        // 2. Discover from .agents/skills/ (lower priority, skip collisions)
+        const agentsSkillsPath = path.join(this.repoPath, AGENTS_SKILLS_DIR);
+        this.discoverSkillsFromDirectory(agentsSkillsPath, skills, discoveredSlugs);
+        return skills;
+    }
+    /**
+     * Discover custom skills from a specific directory
+     */
+    discoverSkillsFromDirectory(dirPath, skills, discoveredSlugs) {
+        if (!fs.existsSync(dirPath)) {
+            return;
+        }
+        try {
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const slug = entry.name;
+                // Skip built-in skills (already handled) and already-discovered slugs
+                if ((0, types_1.isBuiltInSkill)(slug))
+                    continue;
+                if (discoveredSlugs.has(slug))
+                    continue;
+                const skillPath = path.join(dirPath, slug, 'SKILL.md');
+                if (fs.existsSync(skillPath)) {
+                    const skill = this.parseSkillFile(skillPath, slug, false);
+                    if (skill) {
+                        skills.push(skill);
+                        discoveredSlugs.add(slug);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Failed to discover custom skills from ${dirPath}:`, error);
+        }
+    }
+    /**
+     * 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,20 @@
+/**
+ * Built-in Skill Templates
+ *
+ * Separated from SkillRegistry to follow Single Responsibility Principle.
+ * Each template contains description and markdown content for a built-in skill.
+ *
+ * Content is derived from the canonical skill definitions in
+ * src/generators/shared/structures/skills/definitions.ts to maintain
+ * a single source of truth.
+ */
+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;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAiB3C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAsBD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAalF"}

package/dist/workflow/skills/skillTemplates.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Built-in Skill Templates
+ *
+ * Separated from SkillRegistry to follow Single Responsibility Principle.
+ * Each template contains description and markdown content for a built-in skill.
+ *
+ * Content is derived from the canonical skill definitions in
+ * src/generators/shared/structures/skills/definitions.ts to maintain
+ * a single source of truth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBuiltInSkillTemplates = getBuiltInSkillTemplates;
+const definitions_1 = require("../../generators/shared/structures/skills/definitions");
+/**
+ * Convert a SkillDefaultContent object into formatted markdown
+ */
+function contentToMarkdown(title, content) {
+    let md = `# ${title}\n\n`;
+    if (content.whenToUse) {
+        md += `## When to Use\n${content.whenToUse}\n\n`;
+    }
+    if (content.instructions) {
+        md += `## Instructions\n${content.instructions}\n\n`;
+    }
+    if (content.examples) {
+        md += `## Examples\n${content.examples}\n\n`;
+    }
+    if (content.guidelines) {
+        md += `## Guidelines\n${content.guidelines}`;
+    }
+    return md;
+}
+/**
+ * Get all built-in skill templates
+ */
+function getBuiltInSkillTemplates() {
+    return {
+        'commit-message': createCommitMessageSkill(),
+        'pr-review': createPrReviewSkill(),
+        'code-review': createCodeReviewSkill(),
+        'test-generation': createTestGenerationSkill(),
+        'documentation': createDocumentationSkill(),
+        'refactoring': createRefactoringSkill(),
+        'bug-investigation': createBugInvestigationSkill(),
+        'feature-breakdown': createFeatureBreakdownSkill(),
+        'api-design': createApiDesignSkill(),
+        'security-audit': createSecurityAuditSkill(),
+    };
+}
+function createCommitMessageSkill() {
+    return {
+        description: 'Generate commit messages following conventional commits with scope detection',
+        content: contentToMarkdown('Commit Message Generator', definitions_1.commitMessageContent),
+    };
+}
+function createPrReviewSkill() {
+    return {
+        description: 'Review pull requests against team standards and best practices',
+        content: contentToMarkdown('Pull Request Review', definitions_1.prReviewContent),
+    };
+}
+function createCodeReviewSkill() {
+    return {
+        description: 'Review code quality, patterns, and best practices',
+        content: contentToMarkdown('Code Review', definitions_1.codeReviewContent),
+    };
+}
+function createTestGenerationSkill() {
+    return {
+        description: 'Generate comprehensive test cases for code',
+        content: contentToMarkdown('Test Generation', definitions_1.testGenerationContent),
+    };
+}
+function createDocumentationSkill() {
+    return {
+        description: 'Generate and update technical documentation',
+        content: contentToMarkdown('Documentation Generator', definitions_1.documentationContent),
+    };
+}
+function createRefactoringSkill() {
+    return {
+        description: 'Safe code refactoring with step-by-step approach',
+        content: contentToMarkdown('Refactoring Guide', definitions_1.refactoringContent),
+    };
+}
+function createBugInvestigationSkill() {
+    return {
+        description: 'Systematic bug investigation and root cause analysis',
+        content: contentToMarkdown('Bug Investigation', definitions_1.bugInvestigationContent),
+    };
+}
+function createFeatureBreakdownSkill() {
+    return {
+        description: 'Break down features into implementable tasks',
+        content: contentToMarkdown('Feature Breakdown', definitions_1.featureBreakdownContent),
+    };
+}
+function createApiDesignSkill() {
+    return {
+        description: 'Design RESTful APIs following best practices',
+        content: contentToMarkdown('API Design', definitions_1.apiDesignContent),
+    };
+}
+function createSecurityAuditSkill() {
+    return {
+        description: 'Security review checklist for code and infrastructure',
+        content: contentToMarkdown('Security Audit', definitions_1.securityAuditContent),
+    };
+}
+//# sourceMappingURL=skillTemplates.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * Skill Types
+ *
+ * Skills are on-demand expertise that AI agents can activate when needed.
+ * Unlike agents (persistent behavioral playbooks), skills are task-specific
+ * procedures that get loaded only when relevant.
+ */
+import { PrevcPhase } from '../types';
+/**
+ * SKILL.md frontmatter metadata
+ */
+export interface SkillMetadata {
+    /** Unique identifier (lowercase, hyphens) */
+    name: string;
+    /** Description of when to use this skill */
+    description: string;
+    /** Categorize as mode command (modifies behavior) */
+    mode?: boolean;
+    /** Prevent auto-activation by AI */
+    disableModelInvocation?: boolean;
+    /** PREVC phases where this skill is relevant */
+    phases?: PrevcPhase[];
+}
+/**
+ * Full skill representation
+ */
+export interface Skill {
+    /** Directory name */
+    slug: string;
+    /** Full path to SKILL.md */
+    path: string;
+    /** Parsed frontmatter */
+    metadata: SkillMetadata;
+    /** Markdown instructions */
+    content: string;
+    /** Optional helper files in skill directory */
+    resources: string[];
+    /** Is this a built-in skill? */
+    isBuiltIn: boolean;
+}
+/**
+ * Skill reference for linking
+ */
+export interface SkillReference {
+    slug: string;
+    path: string;
+    name: string;
+    description: string;
+    linkedAt: string;
+}
+/**
+ * Discovered skills summary
+ */
+export interface DiscoveredSkills {
+    builtIn: Skill[];
+    custom: Skill[];
+    all: Skill[];
+}
+/**
+ * Built-in skills we provide
+ */
+export declare const BUILT_IN_SKILLS: readonly ["commit-message", "pr-review", "code-review", "test-generation", "documentation", "refactoring", "bug-investigation", "feature-breakdown", "api-design", "security-audit"];
+export type BuiltInSkillType = (typeof BUILT_IN_SKILLS)[number];
+/**
+ * Check if a skill is built-in
+ */
+export declare function isBuiltInSkill(skillType: string): skillType is BuiltInSkillType;
+/**
+ * Skill to PREVC phase mapping
+ */
+export declare const SKILL_TO_PHASES: Record<BuiltInSkillType, PrevcPhase[]>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflow/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,gDAAgD;IAChD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,GAAG,EAAE,KAAK,EAAE,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,sLAWlB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,gBAAgB,CAE/E;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,UAAU,EAAE,CAWlE,CAAC"}

package/dist/workflow/skills/types.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Skill Types
+ *
+ * Skills are on-demand expertise that AI agents can activate when needed.
+ * Unlike agents (persistent behavioral playbooks), skills are task-specific
+ * procedures that get loaded only when relevant.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_TO_PHASES = exports.BUILT_IN_SKILLS = void 0;
+exports.isBuiltInSkill = isBuiltInSkill;
+/**
+ * Built-in skills we provide
+ */
+exports.BUILT_IN_SKILLS = [
+    'commit-message',
+    'pr-review',
+    'code-review',
+    'test-generation',
+    'documentation',
+    'refactoring',
+    'bug-investigation',
+    'feature-breakdown',
+    'api-design',
+    'security-audit',
+];
+/**
+ * Check if a skill is built-in
+ */
+function isBuiltInSkill(skillType) {
+    return exports.BUILT_IN_SKILLS.includes(skillType);
+}
+/**
+ * Skill to PREVC phase mapping
+ */
+exports.SKILL_TO_PHASES = {
+    'commit-message': ['E', 'C'],
+    'pr-review': ['R', 'V'],
+    'code-review': ['R', 'V'],
+    'test-generation': ['E', 'V'],
+    'documentation': ['P', 'C'],
+    'refactoring': ['E'],
+    'bug-investigation': ['E', 'V'],
+    'feature-breakdown': ['P'],
+    'api-design': ['P', 'R'],
+    'security-audit': ['R', 'V'],
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/workflow/skills/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AA+EH,wCAEC;AAvBD;;GAEG;AACU,QAAA,eAAe,GAAG;IAC7B,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,mBAAmB;IACnB,mBAAmB;IACnB,YAAY;IACZ,gBAAgB;CACR,CAAC;AAIX;;GAEG;AACH,SAAgB,cAAc,CAAC,SAAiB;IAC9C,OAAO,uBAAe,CAAC,QAAQ,CAAC,SAA6B,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAA2C;IACrE,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC5B,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACvB,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACzB,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC7B,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC3B,aAAa,EAAE,CAAC,GAAG,CAAC;IACpB,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAC/B,mBAAmB,EAAE,CAAC,GAAG,CAAC;IAC1B,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACxB,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;CAC7B,CAAC"}