@yuaone/core 0.3.3 → 0.4.0

package/dist/skill-loader.d.ts

@@ -0,0 +1,90 @@
+/**
+ * SkillLoader — Loads and resolves skill templates from plugins
+ *
+ * Responsibilities:
+ * - Parse skill markdown into structured ParsedSkill objects
+ * - Resolve template variables with context
+ * - Match skill triggers against runtime context
+ * - Load local skills from .yuan/skills/ directory
+ */
+import type { SkillDefinition, SkillContext, ParsedSkill } from "./plugin-types.js";
+export declare class SkillLoader {
+    /**
+     * Load and parse a skill's markdown template into a ParsedSkill.
+     * The template can be inline content or a file path — this method
+     * accepts the raw template string (caller is responsible for reading files).
+     */
+    loadTemplate(skill: SkillDefinition, templateContent?: string): ParsedSkill;
+    /**
+     * Resolve template variables in a skill template string.
+     * Variables use {{variable}} syntax.
+     *
+     * @param template - Template string with {{variable}} placeholders
+     * @param context - Key-value pairs to substitute
+     * @returns Resolved template string
+     */
+    resolveTemplate(template: string, context: Record<string, unknown>): string;
+    /**
+     * Match skill triggers against the current context.
+     * Returns skills whose triggers match, sorted by confidence (highest first).
+     */
+    matchTriggers(skills: SkillDefinition[], context: SkillContext): SkillDefinition[];
+    /**
+     * Parse the ## Identity section from skill markdown.
+     *
+     * Expected format:
+     * ```
+     * ## Identity
+     * - domain: react
+     * - type: bugfix
+     * - confidence: 0.85
+     * ```
+     */
+    private parseIdentity;
+    /**
+     * Parse ### Known Error Patterns subsections.
+     *
+     * Expected format:
+     * ```
+     * ### Pattern Name
+     * - **증상**: "..."
+     * - **원인**: ...
+     * - **전략**: 1. ... 2. ...
+     * - **도구 시퀀스**: grep → file_read → ...
+     * - **함정**: ...
+     * ```
+     */
+    private parseKnownPatterns;
+    /**
+     * Parse ## Validation Checklist section.
+     * Extracts - [ ] items.
+     */
+    private parseValidationChecklist;
+    /**
+     * Parse tool sequence from content.
+     * Looks for patterns like: "도구 시퀀스: grep → file_read → file_edit"
+     */
+    private parseToolSequence;
+    /**
+     * Score how well a skill matches the given context.
+     * Returns 0 for no match, higher for better match.
+     */
+    private scoreTriggerMatch;
+    /**
+     * Extract list items following a marker pattern.
+     */
+    private extractListItems;
+    /**
+     * Extract numbered items (1. ... 2. ... 3. ...).
+     */
+    private extractNumberedItems;
+    /**
+     * Extract tool sequence from a pattern section.
+     */
+    private extractToolSequence;
+    /**
+     * Simple glob matching for file patterns.
+     */
+    private globMatch;
+}
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,WAAW,EAEZ,MAAM,mBAAmB,CAAC;AAS3B,qBAAa,WAAW;IACtB;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,WAAW;IAiC3E;;;;;;;OAOG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM;IAoBT;;;OAGG;IACH,aAAa,CACX,MAAM,EAAE,eAAe,EAAE,EACzB,OAAO,EAAE,YAAY,GACpB,eAAe,EAAE;IAoBpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,aAAa;IAuBrB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAkBhC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA8DzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,SAAS;CAclB"}

package/dist/skill-loader.js

@@ -0,0 +1,309 @@
+/**
+ * SkillLoader — Loads and resolves skill templates from plugins
+ *
+ * Responsibilities:
+ * - Parse skill markdown into structured ParsedSkill objects
+ * - Resolve template variables with context
+ * - Match skill triggers against runtime context
+ * - Load local skills from .yuan/skills/ directory
+ */
+export class SkillLoader {
+    /**
+     * Load and parse a skill's markdown template into a ParsedSkill.
+     * The template can be inline content or a file path — this method
+     * accepts the raw template string (caller is responsible for reading files).
+     */
+    loadTemplate(skill, templateContent) {
+        const content = templateContent ?? skill.template;
+        // Warn if content looks like a file path rather than markdown
+        if (content && /^\.?\/[\w\-./]+\.\w{1,5}$/.test(content.trim())) {
+            // Content is likely a file path, not markdown — return minimal ParsedSkill
+            return {
+                definition: skill,
+                content,
+                knownPatterns: [],
+                validationChecklist: [],
+                toolSequence: [],
+            };
+        }
+        const identity = this.parseIdentity(content);
+        const knownPatterns = this.parseKnownPatterns(content);
+        const validationChecklist = this.parseValidationChecklist(content);
+        const toolSequence = this.parseToolSequence(content);
+        return {
+            definition: skill,
+            content,
+            domain: identity.domain,
+            type: identity.type,
+            confidence: identity.confidence,
+            knownPatterns: knownPatterns.length > 0 ? knownPatterns : undefined,
+            validationChecklist: validationChecklist.length > 0 ? validationChecklist : undefined,
+            toolSequence: toolSequence.length > 0 ? toolSequence : undefined,
+        };
+    }
+    /**
+     * Resolve template variables in a skill template string.
+     * Variables use {{variable}} syntax.
+     *
+     * @param template - Template string with {{variable}} placeholders
+     * @param context - Key-value pairs to substitute
+     * @returns Resolved template string
+     */
+    resolveTemplate(template, context) {
+        return template.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (_match, key) => {
+            // Support dotted paths like "project.name"
+            const parts = key.split(".");
+            let value = context;
+            for (const part of parts) {
+                if (value === null || value === undefined)
+                    return `{{${key}}}`;
+                if (typeof value === "object") {
+                    value = value[part];
+                }
+                else {
+                    return `{{${key}}}`;
+                }
+            }
+            if (value === null || value === undefined)
+                return `{{${key}}}`;
+            return String(value);
+        });
+    }
+    /**
+     * Match skill triggers against the current context.
+     * Returns skills whose triggers match, sorted by confidence (highest first).
+     */
+    matchTriggers(skills, context) {
+        const matched = [];
+        for (const skill of skills) {
+            if (!skill.enabled)
+                continue;
+            const score = this.scoreTriggerMatch(skill, context);
+            if (score > 0) {
+                matched.push({ skill, score });
+            }
+        }
+        // Sort by score descending
+        matched.sort((a, b) => b.score - a.score);
+        return matched.map((m) => m.skill);
+    }
+    // ─── Markdown Parsing ───
+    /**
+     * Parse the ## Identity section from skill markdown.
+     *
+     * Expected format:
+     * ```
+     * ## Identity
+     * - domain: react
+     * - type: bugfix
+     * - confidence: 0.85
+     * ```
+     */
+    parseIdentity(content) {
+        const result = {};
+        // Find ## Identity section
+        const identityMatch = content.match(/## Identity\s*\n([\s\S]*?)(?=\n## |\n---|$)/);
+        if (!identityMatch)
+            return result;
+        const section = identityMatch[1];
+        const domainMatch = section.match(/-\s*domain:\s*(.+)/i);
+        if (domainMatch)
+            result.domain = domainMatch[1].trim();
+        const typeMatch = section.match(/-\s*type:\s*(.+)/i);
+        if (typeMatch)
+            result.type = typeMatch[1].trim();
+        const confidenceMatch = section.match(/-\s*confidence:\s*([\d.]+)/i);
+        if (confidenceMatch)
+            result.confidence = parseFloat(confidenceMatch[1]);
+        return result;
+    }
+    /**
+     * Parse ### Known Error Patterns subsections.
+     *
+     * Expected format:
+     * ```
+     * ### Pattern Name
+     * - **증상**: "..."
+     * - **원인**: ...
+     * - **전략**: 1. ... 2. ...
+     * - **도구 시퀀스**: grep → file_read → ...
+     * - **함정**: ...
+     * ```
+     */
+    parseKnownPatterns(content) {
+        const patterns = [];
+        // Find sections that start with ### under ## Known Error Patterns
+        const knownSection = content.match(/## Known (?:Error )?Patterns\s*\n([\s\S]*?)(?=\n## |\n---|$)/);
+        if (!knownSection)
+            return patterns;
+        const sectionContent = knownSection[1];
+        // Split by ### headers
+        const subsections = sectionContent.split(/\n### /).filter(Boolean);
+        for (const sub of subsections) {
+            const lines = sub.trim().split("\n");
+            const name = lines[0]?.trim() ?? "";
+            if (!name)
+                continue;
+            const body = lines.slice(1).join("\n");
+            const pattern = {
+                name,
+                symptoms: this.extractListItems(body, /\*\*증상\*\*[:\s]*/i),
+                causes: this.extractListItems(body, /\*\*원인\*\*[:\s]*/i),
+                strategy: this.extractNumberedItems(body, /\*\*전략\*\*[:\s]*/i),
+                tools: this.extractToolSequence(body),
+                pitfalls: this.extractListItems(body, /\*\*함정\*\*[:\s]*/i),
+            };
+            patterns.push(pattern);
+        }
+        return patterns;
+    }
+    /**
+     * Parse ## Validation Checklist section.
+     * Extracts - [ ] items.
+     */
+    parseValidationChecklist(content) {
+        const items = [];
+        const checklistMatch = content.match(/## Validation Checklist\s*\n([\s\S]*?)(?=\n## |\n---|$)/);
+        if (!checklistMatch)
+            return items;
+        const section = checklistMatch[1];
+        const matches = section.matchAll(/- \[[ x]?\]\s*(.+)/gi);
+        for (const match of matches) {
+            items.push(match[1].trim());
+        }
+        return items;
+    }
+    /**
+     * Parse tool sequence from content.
+     * Looks for patterns like: "도구 시퀀스: grep → file_read → file_edit"
+     */
+    parseToolSequence(content) {
+        const match = content.match(/(?:\*\*도구 시퀀스\*\*|tool.?sequence)[:\s]*(.+)/i);
+        if (!match)
+            return [];
+        return match[1]
+            .split(/→|->|,/)
+            .map((t) => t.trim())
+            .filter(Boolean);
+    }
+    // ─── Trigger Matching ───
+    /**
+     * Score how well a skill matches the given context.
+     * Returns 0 for no match, higher for better match.
+     */
+    scoreTriggerMatch(skill, context) {
+        const trigger = skill.trigger;
+        switch (trigger.kind) {
+            case "file_pattern": {
+                if (!context.filePath || !trigger.pattern)
+                    return 0;
+                return this.globMatch(trigger.pattern, context.filePath) ? 1 : 0;
+            }
+            case "command": {
+                if (!context.command || !trigger.command)
+                    return 0;
+                const cmd = context.command.replace(/^\//, "");
+                return cmd === trigger.command ? 10 : 0; // High score for exact command match
+            }
+            case "auto": {
+                let score = 0;
+                if (trigger.pattern) {
+                    try {
+                        const regex = new RegExp(trigger.pattern, "i");
+                        if (context.filePath && regex.test(context.filePath))
+                            score += 1;
+                        if (context.errorMessage && regex.test(context.errorMessage))
+                            score += 2; // Errors are higher signal
+                        if (context.taskDescription && regex.test(context.taskDescription))
+                            score += 1;
+                    }
+                    catch {
+                        return 0;
+                    }
+                }
+                // Apply confidence threshold
+                if (trigger.confidence && score > 0) {
+                    score *= trigger.confidence;
+                }
+                // Check tag matches against task description
+                if (skill.tags && context.taskDescription) {
+                    const taskLower = context.taskDescription.toLowerCase();
+                    for (const tag of skill.tags) {
+                        if (taskLower.includes(tag.toLowerCase())) {
+                            score += 0.5;
+                        }
+                    }
+                }
+                return score;
+            }
+            case "manual":
+                return 0;
+            default:
+                return 0;
+        }
+    }
+    // ─── Utility Helpers ───
+    /**
+     * Extract list items following a marker pattern.
+     */
+    extractListItems(content, markerPattern) {
+        const match = content.match(new RegExp(markerPattern.source + "(.+)", "i"));
+        if (!match)
+            return [];
+        const text = match[1].trim();
+        // Handle quoted content
+        const quoted = text.match(/"([^"]+)"/);
+        if (quoted)
+            return [quoted[1]];
+        // Handle comma-separated
+        return text
+            .split(/,|;/)
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    /**
+     * Extract numbered items (1. ... 2. ... 3. ...).
+     */
+    extractNumberedItems(content, markerPattern) {
+        const markerMatch = content.match(new RegExp(markerPattern.source + "[\\s\\S]*?(?=\\n- \\*\\*|$)", "i"));
+        if (!markerMatch)
+            return [];
+        const section = markerMatch[0];
+        const items = [];
+        const matches = section.matchAll(/\d+\.\s*(.+)/g);
+        for (const match of matches) {
+            items.push(match[1].trim());
+        }
+        return items;
+    }
+    /**
+     * Extract tool sequence from a pattern section.
+     */
+    extractToolSequence(content) {
+        const match = content.match(/(?:\*\*도구 시퀀스\*\*|tool.?sequence)[:\s]*(.+)/i);
+        if (!match)
+            return [];
+        return match[1]
+            .split(/→|->|,/)
+            .map((t) => t.trim())
+            .filter(Boolean);
+    }
+    /**
+     * Simple glob matching for file patterns.
+     */
+    globMatch(pattern, filePath) {
+        const regexStr = pattern
+            .replace(/\./g, "\\.")
+            .replace(/\*\*/g, "<<GLOBSTAR>>")
+            .replace(/\*/g, "[^/]*")
+            .replace(/<<GLOBSTAR>>/g, ".*");
+        try {
+            const regex = new RegExp(`^${regexStr}$`);
+            return regex.test(filePath);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skill-loader.js.map

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

package/dist/specialist-registry.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @module specialist-registry
+ * @description Specialist Agent Registry — Domain-specific agent configurations.
+ *
+ * Each specialist has pre-loaded expertise, preferred tools, and quality thresholds.
+ * Routing: TaskClassifier -> SpecialistRegistry -> specialist config -> SubAgent
+ */
+/** Configuration for a domain specialist agent */
+export interface SpecialistConfig {
+    /** Unique specialist ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Domain description */
+    domain: string;
+    /** System prompt prefix for this specialist */
+    systemPrompt: string;
+    /** Preferred tools (ordered by priority) */
+    preferredTools: string[];
+    /** Plugin skills to auto-activate */
+    preferredSkills: string[];
+    /** Minimum quality threshold for output (0–1) */
+    qualityThreshold: number;
+    /** Languages this specialist handles */
+    languages?: string[];
+    /** Frameworks this specialist handles */
+    frameworks?: string[];
+    /** Can delegate to these other specialists */
+    canDelegateTo?: string[];
+}
+/** Result of matching a specialist to a task */
+export interface SpecialistMatch {
+    /** The matched specialist configuration */
+    specialist: SpecialistConfig;
+    /** Confidence of the match (0–1) */
+    confidence: number;
+    /** Reason for the match */
+    reason: string;
+}
+/**
+ * Registry for domain-specific specialist agent configurations.
+ *
+ * Manages built-in and custom specialists that can be matched to tasks
+ * based on type, language, framework, and error context.
+ *
+ * @example
+ * ```typescript
+ * const registry = new SpecialistRegistry();
+ *
+ * // Find best specialist for a TypeScript security task
+ * const match = registry.findSpecialist("security", {
+ *   language: "typescript",
+ * });
+ * if (match) {
+ *   console.log(match.specialist.name); // "Security Specialist"
+ *   console.log(match.confidence);      // 0.9
+ * }
+ *
+ * // Register a custom specialist
+ * registry.register({
+ *   id: "rust-specialist",
+ *   name: "Rust Specialist",
+ *   domain: "Rust systems programming",
+ *   systemPrompt: "You are a Rust expert...",
+ *   preferredTools: ["file_read", "file_edit", "shell_exec"],
+ *   preferredSkills: ["cargo-check", "clippy-lint"],
+ *   qualityThreshold: 0.85,
+ *   languages: ["rust"],
+ * });
+ * ```
+ */
+export declare class SpecialistRegistry {
+    private specialists;
+    constructor();
+    /**
+     * Register a specialist configuration.
+     * If a specialist with the same ID exists, it is replaced.
+     *
+     * @param config - Specialist configuration to register
+     */
+    register(config: SpecialistConfig): void;
+    /**
+     * Find the best specialist for a given task type and context.
+     *
+     * Matching priority:
+     * 1. Exact task type match
+     * 2. Language/framework affinity bonus
+     * 3. Error message pattern match
+     *
+     * @param taskType - Task type string (from TaskClassifier)
+     * @param context - Optional context for better matching
+     * @returns Best matching specialist or null if none found
+     */
+    findSpecialist(taskType: string, context?: {
+        language?: string;
+        framework?: string;
+        errorMessage?: string;
+    }): SpecialistMatch | null;
+    /**
+     * Get a specialist by its unique ID.
+     *
+     * @param id - Specialist ID
+     * @returns Specialist config or undefined if not found
+     */
+    get(id: string): SpecialistConfig | undefined;
+    /**
+     * List all registered specialists.
+     *
+     * @returns Array of all specialist configurations
+     */
+    list(): SpecialistConfig[];
+    /**
+     * Remove a specialist by ID.
+     *
+     * @param id - Specialist ID to remove
+     * @returns true if removed, false if not found
+     */
+    remove(id: string): boolean;
+    /**
+     * Get the total number of registered specialists.
+     */
+    get size(): number;
+    /**
+     * Check if a specialist's domain matches the given task type.
+     */
+    private matchesDomain;
+    /**
+     * Register all built-in specialist configurations.
+     */
+    private registerBuiltins;
+}
+//# sourceMappingURL=specialist-registry.d.ts.map

package/dist/specialist-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-registry.d.ts","sourceRoot":"","sources":["../src/specialist-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qCAAqC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,UAAU,EAAE,gBAAgB,CAAC;IAC7B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAA4C;;IAM/D;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIxC;;;;;;;;;;;OAWG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,eAAe,GAAG,IAAI;IA+DzB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C;;;;OAIG;IACH,IAAI,IAAI,gBAAgB,EAAE;IAI1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAID;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqPzB"}