@winspan/claude-forge 8.51.1 → 8.54.3

package/dist/skills/upgrade-engine.d.ts

@@ -0,0 +1,93 @@
+/**
+ * upgrade-engine.ts
+ *
+ * Orchestrates the AI-assisted official skill upgrade pipeline.
+ * Does NOT contain AI prompt strings — those live in upgrade-prompt.ts.
+ */
+import type { OfficialSkill } from './official-skills.js';
+import type { ClaudeProvider } from '../core/ai/provider.js';
+export interface CandidateSkill {
+    id: string;
+    source: string;
+    filePath: string;
+    name: string;
+    description: string;
+    keywords: string[];
+    content: string;
+}
+export interface MatchResult {
+    officialId: string;
+    score: number;
+}
+export type UpgradeAction = 'upgrade' | 'merge' | 'skip';
+export interface UpgradeDecision {
+    action: UpgradeAction;
+    confidence: number;
+    reasoning: string;
+    merged_content: string | null;
+}
+export interface ReportEntry {
+    officialId: string;
+    candidateId: string;
+    candidateSource: string;
+    action: UpgradeAction | 'error' | 'needs_review';
+    confidence: number;
+    reasoning: string;
+    candidateFilePath: string;
+    merged_content: string | null;
+}
+export declare const DEFAULT_SOURCES: Array<{
+    name: string;
+    url: string;
+}>;
+/**
+ * Clone or pull each source into `candidatesDir/<source.name>/`, then scan
+ * all .md files and parse them into CandidateSkill objects.
+ * Individual source failures are caught and logged; they do not abort the run.
+ */
+export declare function pullCandidates(sources: Array<{
+    name: string;
+    url: string;
+}>, candidatesDir: string): Promise<CandidateSkill[]>;
+/**
+ * Match a candidate skill to the best official skill using keyword + name token
+ * overlap. Returns null if the best score is below the 15-point threshold.
+ * (Threshold lowered from 30 in v8.53.1 to accommodate English↔中文 keyword mismatch;
+ * substring boost forces score=50 when keyword appears as substring in the other's text.)
+ */
+export declare function matchToOfficial(candidate: CandidateSkill, officialSkills: OfficialSkill[]): MatchResult | null;
+/**
+ * Ask the AI provider to evaluate whether a candidate should upgrade / merge /
+ * skip the matched official skill. Returns a parsed UpgradeDecision.
+ *
+ * On JSON parse failure → returns { action: 'skip', confidence: 0, reasoning:
+ * 'AI response could not be parsed', merged_content: null } with needs_review=true
+ * embedded in the reasoning (caller promotes to needs_review).
+ */
+export declare function evaluateWithAI(candidate: CandidateSkill, official: OfficialSkill, aiProvider: ClaudeProvider): Promise<UpgradeDecision & {
+    needs_review?: boolean;
+}>;
+/**
+ * Write the upgrade report as a markdown file with embedded HTML comment
+ * machine markers for `applyDecisions` to parse.
+ */
+export declare function generateReport(entries: ReportEntry[], outputPath: string, stats: {
+    total: number;
+    matched: number;
+    unmatched: number;
+}): Promise<void>;
+/**
+ * Apply the decisions recorded in a report file to the official skills directory.
+ *
+ * Safety checks:
+ * 1. `git status --porcelain <officialDir>` must be clean
+ * 2. Full backup created in `backupBaseDir/<YYYYMMDD-HHMM>/` (conflict → -2/-3)
+ *
+ * Returns { applied, skipped, backupPath }.
+ */
+export declare function applyDecisions(reportPath: string, officialDir: string, backupBaseDir: string): Promise<{
+    applied: number;
+    skipped: number;
+    backupPath: string;
+}>;
+//# sourceMappingURL=upgrade-engine.d.ts.map

package/dist/skills/upgrade-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-engine.d.ts","sourceRoot":"","sources":["../../src/skills/upgrade-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,cAAc,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAID,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAGhE,CAAC;AAuFF;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAkD3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,aAAa,EAAE,GAC9B,WAAW,GAAG,IAAI,CAoEpB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,eAAe,GAAG;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAyDvD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAgHnE"}

package/dist/skills/upgrade-engine.js

@@ -0,0 +1,447 @@
+/**
+ * upgrade-engine.ts
+ *
+ * Orchestrates the AI-assisted official skill upgrade pipeline.
+ * Does NOT contain AI prompt strings — those live in upgrade-prompt.ts.
+ */
+import { exec, execFile } from 'node:child_process';
+import { promises as fs, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import matter from 'gray-matter';
+import { buildEvaluationPrompt } from './upgrade-prompt.js';
+import { logger } from '../core/utils/logger.js';
+const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
+// ── Default candidate sources ───────────────────────────────────────────────
+export const DEFAULT_SOURCES = [
+    { name: 'agent-skills', url: 'https://github.com/addyosmani/agent-skills.git' },
+    { name: 'superpowers', url: 'https://github.com/obra/superpowers.git' },
+];
+// ── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Parse a .md file into a CandidateSkill.
+ * Returns null if frontmatter `name` is missing or keywords are absent —
+ * such candidates cannot be meaningfully matched and should not pollute
+ * the AI evaluation pipeline.
+ */
+function parseCandidateFile(filePath, sourceName) {
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = matter(raw);
+        const { data } = parsed;
+        // Require frontmatter name — fileName fallback produces noisy / unmatchable candidates
+        if (typeof data.name !== 'string' || data.name.trim().length === 0) {
+            return null;
+        }
+        const id = data.name;
+        const name = data.name;
+        const description = typeof data.description === 'string' ? data.description : '';
+        const rawKeywords = data.keywords ?? data.tags;
+        const keywords = Array.isArray(rawKeywords)
+            ? rawKeywords.filter((k) => typeof k === 'string')
+            : [];
+        // Require at least one keyword OR a non-empty description to ground the AI match
+        if (keywords.length === 0 && description.trim().length === 0) {
+            return null;
+        }
+        return {
+            id,
+            source: sourceName,
+            filePath,
+            name,
+            description,
+            keywords,
+            content: raw,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Recursively scan a directory for .md files.
+ * Supports both directory/SKILL.md format (agent-skills) and flat *.md format.
+ */
+async function scanMdFiles(dir) {
+    const results = [];
+    async function walk(current) {
+        let entries;
+        try {
+            entries = await fs.readdir(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                // Check for SKILL.md inside this directory (agent-skills format)
+                const skillMd = path.join(fullPath, 'SKILL.md');
+                try {
+                    await fs.access(skillMd);
+                    results.push(skillMd);
+                }
+                catch {
+                    // Recurse into sub-directories that don't have SKILL.md directly
+                    await walk(fullPath);
+                }
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md') && entry.name !== 'README.md') {
+                results.push(fullPath);
+            }
+        }
+    }
+    await walk(dir);
+    return results;
+}
+// ── Exported pipeline functions ─────────────────────────────────────────────
+/**
+ * Clone or pull each source into `candidatesDir/<source.name>/`, then scan
+ * all .md files and parse them into CandidateSkill objects.
+ * Individual source failures are caught and logged; they do not abort the run.
+ */
+export async function pullCandidates(sources, candidatesDir) {
+    await fs.mkdir(candidatesDir, { recursive: true });
+    const candidates = [];
+    for (const source of sources) {
+        const targetDir = path.join(candidatesDir, source.name);
+        let exists = false;
+        try {
+            await fs.access(targetDir);
+            exists = true;
+        }
+        catch { /* not exists */ }
+        // Try pull/clone, but don't abort scan if pull fails on existing dir
+        try {
+            if (exists) {
+                logger.info(`[upgrade] Pulling ${source.name}...`);
+                await execAsync(`git -C "${targetDir}" pull --ff-only`, { timeout: 60_000 });
+            }
+            else {
+                logger.info(`[upgrade] Cloning ${source.name}...`);
+                await execAsync(`git clone --depth=1 "${source.url}" "${targetDir}"`, { timeout: 120_000 });
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (exists) {
+                logger.warn(`[upgrade] ${source.name} pull failed (using existing checkout): ${msg}`);
+            }
+            else {
+                logger.warn(`[upgrade] ${source.name} clone failed, skipping: ${msg}`);
+                continue;
+            }
+        }
+        // Always scan if dir exists (even when pull fails — old checkout is better than nothing)
+        try {
+            const mdFiles = await scanMdFiles(targetDir);
+            for (const filePath of mdFiles) {
+                const candidate = parseCandidateFile(filePath, source.name);
+                if (candidate) {
+                    candidates.push(candidate);
+                }
+            }
+            logger.info(`[upgrade] ${source.name}: ${mdFiles.length} .md files found`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`[upgrade] Skipping source ${source.name}: ${msg}`);
+        }
+    }
+    return candidates;
+}
+/**
+ * Match a candidate skill to the best official skill using keyword + name token
+ * overlap. Returns null if the best score is below the 15-point threshold.
+ * (Threshold lowered from 30 in v8.53.1 to accommodate English↔中文 keyword mismatch;
+ * substring boost forces score=50 when keyword appears as substring in the other's text.)
+ */
+export function matchToOfficial(candidate, officialSkills) {
+    /** Tokenise a string into lowercase words / tokens. */
+    function tokenise(text) {
+        // L3: 中文按字符边界切分（`一-鿿` 范围内每个汉字单独成 token）；英文按空白/连字符。
+        // 这种方式对「调试 / debugging」之类的跨语言匹配很弱（中文整词不会切出 "调试"
+        // 而是 "调" + "试"）。
+        // TODO: v8.54+ 引入 jieba 或类似分词，提升中英混合 keyword 命中率。
+        return new Set(text
+            .toLowerCase()
+            .replace(/[^a-z0-9一-鿿\s-]/g, ' ')
+            .split(/[\s-]+/)
+            .filter((t) => t.length > 1));
+    }
+    /** Jaccard-like overlap score (0–100). */
+    function overlapScore(aSet, bSet) {
+        if (aSet.size === 0 && bSet.size === 0)
+            return 0;
+        let intersection = 0;
+        for (const t of aSet) {
+            if (bSet.has(t))
+                intersection++;
+        }
+        const union = new Set([...aSet, ...bSet]).size;
+        return union === 0 ? 0 : Math.round((intersection / union) * 100);
+    }
+    const candidateKeywordTokens = tokenise(candidate.keywords.join(' '));
+    const candidateNameTokens = tokenise(candidate.name + ' ' + candidate.description);
+    let best = null;
+    for (const official of officialSkills) {
+        const officialKeywordTokens = tokenise(official.keywords.join(' '));
+        const officialNameTokens = tokenise(official.name + ' ' + official.description);
+        // keyword overlap (weight 60) + name/description token overlap (weight 40)
+        const keywordScore = overlapScore(candidateKeywordTokens, officialKeywordTokens);
+        const nameScore = overlapScore(candidateNameTokens, officialNameTokens);
+        let combined = Math.round(keywordScore * 0.6 + nameScore * 0.4);
+        // Substring boost: candidate id/name contains official keyword (or vice versa)
+        // helps with English↔中文 token mismatch (e.g. "debugging" ↔ "debug"/"调试")
+        const candidateText = (candidate.id + ' ' + candidate.name + ' ' + candidate.description).toLowerCase();
+        const officialText = (official.name + ' ' + official.description).toLowerCase();
+        for (const kw of official.keywords) {
+            const kwLower = kw.toLowerCase();
+            if (kwLower.length >= 3 && candidateText.includes(kwLower)) {
+                combined = Math.max(combined, 50);
+                break;
+            }
+        }
+        for (const kw of candidate.keywords) {
+            const kwLower = kw.toLowerCase();
+            if (kwLower.length >= 3 && officialText.includes(kwLower)) {
+                combined = Math.max(combined, 50);
+                break;
+            }
+        }
+        if (combined >= 15) {
+            if (!best || combined > best.score) {
+                best = { officialId: official.name, score: combined };
+            }
+        }
+    }
+    return best;
+}
+/**
+ * Ask the AI provider to evaluate whether a candidate should upgrade / merge /
+ * skip the matched official skill. Returns a parsed UpgradeDecision.
+ *
+ * On JSON parse failure → returns { action: 'skip', confidence: 0, reasoning:
+ * 'AI response could not be parsed', merged_content: null } with needs_review=true
+ * embedded in the reasoning (caller promotes to needs_review).
+ */
+export async function evaluateWithAI(candidate, official, aiProvider) {
+    const { system, user } = buildEvaluationPrompt(candidate, official);
+    let raw;
+    try {
+        raw = await aiProvider.complete(user, {
+            system,
+            maxTokens: 1200,
+            timeoutMs: 45_000,
+            maxRetries: 2,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            action: 'skip',
+            confidence: 0,
+            reasoning: `AI 调用失败: ${msg}`,
+            merged_content: null,
+            needs_review: true,
+        };
+    }
+    // Strip markdown code fences if model wrapped the JSON
+    const stripped = raw
+        .replace(/^```(?:json)?\s*/im, '')
+        .replace(/\s*```$/im, '')
+        .trim();
+    try {
+        const parsed = JSON.parse(stripped);
+        const validActions = new Set(['upgrade', 'merge', 'skip']);
+        const action = typeof parsed.action === 'string' && validActions.has(parsed.action)
+            ? parsed.action
+            : 'skip';
+        const confidence = typeof parsed.confidence === 'number'
+            ? Math.max(0, Math.min(100, parsed.confidence))
+            : 0;
+        const reasoning = typeof parsed.reasoning === 'string' ? parsed.reasoning : '';
+        const merged_content = typeof parsed.merged_content === 'string' ? parsed.merged_content : null;
+        return { action, confidence, reasoning, merged_content };
+    }
+    catch {
+        return {
+            action: 'skip',
+            confidence: 0,
+            reasoning: `AI 返回内容无法解析为 JSON，需人工审核。原始响应片段: ${stripped.slice(0, 200)}`,
+            merged_content: null,
+            needs_review: true,
+        };
+    }
+}
+/**
+ * Write the upgrade report as a markdown file with embedded HTML comment
+ * machine markers for `applyDecisions` to parse.
+ */
+export async function generateReport(entries, outputPath, stats) {
+    const now = new Date();
+    const timestamp = now.toISOString().replace('T', ' ').slice(0, 16);
+    const actionCounts = { upgrade: 0, merge: 0, skip: 0, error: 0, needs_review: 0 };
+    for (const e of entries) {
+        if (e.action in actionCounts) {
+            actionCounts[e.action]++;
+        }
+    }
+    const lines = [
+        '# Skill Upgrade Report',
+        '',
+        `Generated: ${timestamp}`,
+        '',
+        '## Summary',
+        '',
+        '| Metric | Count |',
+        '|--------|-------|',
+        `| Candidates scanned | ${stats.total} |`,
+        `| Matched to official | ${stats.matched} |`,
+        `| Action: upgrade | ${actionCounts.upgrade} |`,
+        `| Action: merge | ${actionCounts.merge} |`,
+        `| Action: skip | ${actionCounts.skip} |`,
+        `| Needs review | ${actionCounts.needs_review} |`,
+        `| Error | ${actionCounts.error} |`,
+        `| Unmatched | ${stats.unmatched} |`,
+        '',
+        '## Per-Skill Decisions',
+        '',
+    ];
+    for (const entry of entries) {
+        lines.push(`### ${entry.officialId}`);
+        lines.push(`- **Action**: ${entry.action}`);
+        lines.push(`- **Confidence**: ${entry.confidence}%`);
+        lines.push(`- **Candidate**: \`${entry.candidateSource}/${entry.candidateId}\``);
+        lines.push(`- **Candidate path**: \`${entry.candidateFilePath}\``);
+        lines.push(`- **Reasoning**: ${entry.reasoning}`);
+        // Machine-readable marker for applyDecisions
+        lines.push('');
+        lines.push(`<!-- upgrade-entry: ${entry.officialId} | ${entry.candidateFilePath} | ${entry.action} -->`);
+        if (entry.action === 'merge' && entry.merged_content) {
+            lines.push('');
+            lines.push('<!-- merged-content-begin -->');
+            lines.push(entry.merged_content);
+            lines.push('<!-- merged-content-end -->');
+        }
+        lines.push('');
+    }
+    await fs.mkdir(path.dirname(outputPath), { recursive: true });
+    await fs.writeFile(outputPath, lines.join('\n'), 'utf-8');
+    logger.info(`[upgrade] Report written to ${outputPath}`);
+}
+/**
+ * Apply the decisions recorded in a report file to the official skills directory.
+ *
+ * Safety checks:
+ * 1. `git status --porcelain <officialDir>` must be clean
+ * 2. Full backup created in `backupBaseDir/<YYYYMMDD-HHMM>/` (conflict → -2/-3)
+ *
+ * Returns { applied, skipped, backupPath }.
+ */
+export async function applyDecisions(reportPath, officialDir, backupBaseDir) {
+    // 1. Check git working tree is clean (use execFile to avoid shell injection via officialDir)
+    try {
+        const { stdout } = await execFileAsync('git', ['status', '--porcelain', officialDir]);
+        if (stdout.trim().length > 0) {
+            throw new Error(`Working tree is dirty in ${officialDir}. Commit or stash changes before applying.\n${stdout}`);
+        }
+    }
+    catch (err) {
+        // If git is not available or it's not a repo, rethrow only for dirty-tree errors
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('Working tree is dirty'))
+            throw err;
+        logger.warn(`[upgrade] git status check failed (not a git repo?): ${msg}`);
+    }
+    // 2. Create timestamped backup directory (YYYYMMDD-HHMM format)
+    const tsFormatted = (() => {
+        const d = new Date();
+        const YYYY = d.getFullYear();
+        const MM = String(d.getMonth() + 1).padStart(2, '0');
+        const DD = String(d.getDate()).padStart(2, '0');
+        const HH = String(d.getHours()).padStart(2, '0');
+        const mm = String(d.getMinutes()).padStart(2, '0');
+        return `${YYYY}${MM}${DD}-${HH}${mm}`;
+    })();
+    let backupPath = path.join(backupBaseDir, tsFormatted);
+    // Handle conflict: try -2, -3, ...
+    let suffix = 2;
+    while (true) {
+        try {
+            await fs.access(backupPath);
+            // Directory exists — try next suffix
+            backupPath = path.join(backupBaseDir, `${tsFormatted}-${suffix}`);
+            suffix++;
+        }
+        catch {
+            break; // doesn't exist, we can use it
+        }
+    }
+    await fs.mkdir(backupPath, { recursive: true });
+    // Copy all .md files from officialDir into backup
+    const officialFiles = (await fs.readdir(officialDir)).filter((f) => f.endsWith('.md'));
+    for (const file of officialFiles) {
+        await fs.copyFile(path.join(officialDir, file), path.join(backupPath, file));
+    }
+    logger.info(`[upgrade] Backed up ${officialFiles.length} files to ${backupPath}`);
+    // 3. Parse report
+    const reportContent = await fs.readFile(reportPath, 'utf-8');
+    // Parse <!-- upgrade-entry: id | path | action --> markers
+    const entryPattern = /<!-- upgrade-entry: (.+?) \| (.+?) \| (.+?) -->/g;
+    let match;
+    const entries = [];
+    while ((match = entryPattern.exec(reportContent)) !== null) {
+        entries.push({
+            officialId: match[1].trim(),
+            candidatePath: match[2].trim(),
+            action: match[3].trim(),
+        });
+    }
+    // Parse merged content blocks
+    const mergedContentMap = new Map();
+    // Associate merged-content blocks with the preceding entry
+    const mergedPattern = /<!-- upgrade-entry: (.+?) \| (.+?) \| merge -->[\s\S]*?<!-- merged-content-begin -->\n([\s\S]*?)\n<!-- merged-content-end -->/g;
+    while ((match = mergedPattern.exec(reportContent)) !== null) {
+        mergedContentMap.set(match[1].trim(), match[3]);
+    }
+    let applied = 0;
+    let skipped = 0;
+    for (const entry of entries) {
+        if (entry.action === 'skip' || entry.action === 'error' || entry.action === 'needs_review') {
+            skipped++;
+            continue;
+        }
+        const targetFile = path.join(officialDir, `${entry.officialId}.md`);
+        try {
+            if (entry.action === 'upgrade') {
+                // Copy candidate file content
+                const candidateContent = await fs.readFile(entry.candidatePath, 'utf-8');
+                await fs.writeFile(targetFile, candidateContent, 'utf-8');
+                applied++;
+                logger.info(`[upgrade] Applied upgrade: ${entry.officialId}`);
+            }
+            else if (entry.action === 'merge') {
+                const mergedContent = mergedContentMap.get(entry.officialId);
+                if (mergedContent) {
+                    await fs.writeFile(targetFile, mergedContent, 'utf-8');
+                    applied++;
+                    logger.info(`[upgrade] Applied merge: ${entry.officialId}`);
+                }
+                else {
+                    logger.warn(`[upgrade] Merge entry ${entry.officialId} has no merged content; skipping`);
+                    skipped++;
+                }
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`[upgrade] Failed to apply ${entry.officialId}: ${msg}`);
+            skipped++;
+        }
+    }
+    logger.info(`[upgrade] Apply complete: ${applied} applied, ${skipped} skipped`);
+    return { applied, skipped, backupPath };
+}
+//# sourceMappingURL=upgrade-engine.js.map

package/dist/skills/upgrade-engine.js.map

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

package/dist/skills/upgrade-prompt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * upgrade-prompt.ts
+ *
+ * Builds the system + user prompts for AI-assisted skill evaluation.
+ * Pure functions — no I/O, no side effects.
+ */
+import type { CandidateSkill } from './upgrade-engine.js';
+import type { OfficialSkill } from './official-skills.js';
+/**
+ * Build system + user prompts for evaluating whether a candidate skill should
+ * upgrade, merge with, or skip an official skill.
+ *
+ * The system prompt defines the decision criteria and output JSON contract.
+ * The user prompt contains the two skill bodies (capped at 2000 chars each).
+ */
+export declare function buildEvaluationPrompt(candidate: CandidateSkill, official: OfficialSkill): {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=upgrade-prompt.d.ts.map

package/dist/skills/upgrade-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-prompt.d.ts","sourceRoot":"","sources":["../../src/skills/upgrade-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAa1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,aAAa,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoDlC"}