@memtensor/memos-local-openclaw-plugin 0.1.4 → 0.1.6

package/dist/skill/upgrader.js

@@ -0,0 +1,263 @@
+"use strict";
+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.SkillUpgrader = void 0;
+const uuid_1 = require("uuid");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const validator_1 = require("./validator");
+const UPGRADE_PROMPT = `You are a Skill upgrade expert. You're merging new real-world execution experience into an existing Skill to make it better.
+
+Remember: this is based on ACTUAL execution — the new task was really run, errors were really encountered and fixed. This makes the upgrade valuable.
+
+## Core principles (follow strictly but do NOT include in output)
+
+### Progressive disclosure
+- Keep the frontmatter description as the primary trigger mechanism (~60-120 words, proactive — see below)
+- SKILL.md body should stay under 400 lines total
+- If content grows too large, consider moving deep details to references/ and just pointing to them
+
+### Description as trigger
+The description decides whether the agent activates this skill. Write it "proactively":
+- Cover what it does + situations/keywords/phrasings that should trigger it
+- Be explicit about edge cases — "even if the user doesn't say X explicitly but describes Y"
+- If the new task reveals new trigger scenarios, ADD them to the description
+
+### Writing style
+- Imperative form
+- Explain WHY for each step — reasoning beats rigid rules
+- Avoid ALWAYS/NEVER in caps — rephrase with reasoning instead
+- Generalize from specific tasks
+- Keep verified commands/code/config from both old and new tasks
+- CRITICAL: Match the language of the skill and task record. If the existing skill or the new task record is in Chinese, write ALL upgraded content in Chinese. If English, write in English. Only the "name" field stays in English kebab-case. DO NOT default to English.
+
+## Existing skill (v{VERSION}):
+{SKILL_CONTENT}
+
+## Upgrade context
+- Type: {UPGRADE_TYPE}
+- Dimensions improved: {DIMENSIONS}
+- Reason: {REASON}
+- Merge strategy: {MERGE_STRATEGY}
+
+## New task record
+Title: {TITLE}
+Summary:
+{SUMMARY}
+
+## Merge rules
+1. Preserve all valid core content from the existing skill — upgrades should ADD value, not lose it
+2. Merge new experience strategically:
+   - Better approach found → replace old, keep old as "Alternative approach" if it's still valid
+   - New scenario discovered → add a new section (don't replace unrelated content)
+   - Bug/error corrected → replace directly, add to "Pitfalls and solutions" section
+   - Performance improvement → update steps, note the improvement in why-reasoning
+3. Update description if new scenarios/keywords/triggers need coverage
+4. Update "When to use this skill" section if the new task reveals new use cases
+5. If a "Pitfalls and solutions" section exists, append new pitfalls; if it doesn't exist, create it
+6. Total length ≤ 400 lines — if approaching limit, move detailed configs/references to references/
+7. Add version comment at end:
+   <!-- v{NEW_VERSION}: {one-line change note} (from task: {TASK_ID}) -->
+
+## Output format
+
+Output the complete upgraded SKILL.md (with full frontmatter), then on a new line write:
+---CHANGELOG---
+{one-line changelog title}
+---CHANGE_SUMMARY---
+{A 3-5 sentence summary in the same language as the skill. Cover: (1) What specifically was changed and what triggered the change, (2) What concrete new capability or improvement this version brings, (3) What real problem from the new task this solves. Write for a human reader who wants to quickly understand the value of this upgrade.}`;
+class SkillUpgrader {
+    store;
+    ctx;
+    validator;
+    constructor(store, ctx) {
+        this.store = store;
+        this.ctx = ctx;
+        this.validator = new validator_1.SkillValidator(ctx);
+    }
+    async upgrade(task, skill, evalResult) {
+        const currentContent = this.readCurrentContent(skill);
+        if (!currentContent) {
+            this.ctx.log.warn(`SkillUpgrader: could not read content for "${skill.name}"`);
+            return { upgraded: false, qualityScore: null };
+        }
+        const { newContent, changelog, changeSummary } = await this.callUpgradeLLM(task, skill, currentContent, evalResult);
+        if (!newContent || newContent.length < 100) {
+            this.ctx.log.warn(`SkillUpgrader: generated content too short for "${skill.name}", skipping`);
+            return { upgraded: false, qualityScore: null };
+        }
+        fs.writeFileSync(path.join(skill.dirPath, "SKILL.md"), newContent, "utf-8");
+        const validation = await this.validator.validate(skill.dirPath, {
+            previousContent: currentContent,
+        });
+        if (!validation.valid) {
+            this.ctx.log.warn(`SkillUpgrader: validation failed for "${skill.name}", reverting: ${validation.errors.join("; ")}`);
+            fs.writeFileSync(path.join(skill.dirPath, "SKILL.md"), currentContent, "utf-8");
+            return { upgraded: false, qualityScore: null };
+        }
+        const newVersion = skill.version + 1;
+        const newDescription = this.parseDescription(newContent) || skill.description;
+        const newStatus = validation.qualityScore !== null && validation.qualityScore < 6 ? "draft" : skill.status;
+        this.store.updateSkill(skill.id, {
+            description: newDescription,
+            version: newVersion,
+            status: newStatus,
+            qualityScore: validation.qualityScore,
+            updatedAt: Date.now(),
+        });
+        this.store.insertSkillVersion({
+            id: (0, uuid_1.v4)(),
+            skillId: skill.id,
+            version: newVersion,
+            content: newContent,
+            changelog: changelog || `Upgraded from task "${task.title}"`,
+            changeSummary: changeSummary || `基于任务"${task.title}"的执行记录进行了版本升级。`,
+            upgradeType: evalResult.upgradeType,
+            sourceTaskId: task.id,
+            metrics: JSON.stringify({
+                dimensions: evalResult.dimensions,
+                confidence: evalResult.confidence,
+                validation: {
+                    errors: validation.errors,
+                    warnings: validation.warnings,
+                    suggestions: validation.suggestions,
+                },
+            }),
+            qualityScore: validation.qualityScore,
+            createdAt: Date.now(),
+        });
+        if (validation.warnings.length > 0) {
+            this.ctx.log.info(`Skill "${skill.name}" upgrade warnings: ${validation.warnings.join("; ")}`);
+        }
+        this.ctx.log.info(`Skill upgraded: "${skill.name}" v${skill.version} → v${newVersion} [${newStatus}] score=${validation.qualityScore ?? "N/A"}`);
+        return { upgraded: true, qualityScore: validation.qualityScore };
+    }
+    readCurrentContent(skill) {
+        const filePath = path.join(skill.dirPath, "SKILL.md");
+        try {
+            return fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            const sv = this.store.getLatestSkillVersion(skill.id);
+            return sv?.content ?? null;
+        }
+    }
+    async callUpgradeLLM(task, skill, currentContent, evalResult) {
+        const cfg = this.getProviderConfig();
+        if (!cfg)
+            throw new Error("No LLM configured for skill upgrade");
+        const newVersion = skill.version + 1;
+        const detectLang = (text) => {
+            const cjk = text.match(/[\u4e00-\u9fff\u3400-\u4dbf]/g)?.length ?? 0;
+            const total = text.replace(/\s+/g, "").length || 1;
+            return (cjk / total > 0.15) ? "Chinese (中文)" : "English";
+        };
+        const lang = detectLang(task.summary + currentContent);
+        const langInstruction = `\n\n⚠️ LANGUAGE REQUIREMENT: The content is in ${lang}. You MUST write ALL prose (description, headings, explanations, pitfalls, changelog, change summary) in ${lang}. Only the "name" field stays in English kebab-case.\n`;
+        const prompt = UPGRADE_PROMPT
+            .replace("{VERSION}", String(skill.version))
+            .replace("{SKILL_CONTENT}", currentContent.slice(0, 6000))
+            .replace("{UPGRADE_TYPE}", evalResult.upgradeType)
+            .replace("{DIMENSIONS}", evalResult.dimensions.join(", "))
+            .replace("{REASON}", evalResult.reason)
+            .replace("{MERGE_STRATEGY}", evalResult.mergeStrategy)
+            .replace("{TITLE}", task.title)
+            .replace("{SUMMARY}", task.summary.slice(0, 4000))
+            .replace("{NEW_VERSION}", String(newVersion))
+            .replace("{TASK_ID}", task.id)
+            + langInstruction;
+        const endpoint = this.normalizeEndpoint(cfg.endpoint ?? "https://api.openai.com/v1/chat/completions");
+        const model = cfg.model ?? "gpt-4o-mini";
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${cfg.apiKey}`,
+            ...cfg.headers,
+        };
+        const resp = await fetch(endpoint, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                model,
+                temperature: cfg.temperature ?? 0.2,
+                max_tokens: 6000,
+                messages: [
+                    { role: "user", content: prompt },
+                ],
+            }),
+            signal: AbortSignal.timeout(cfg.timeoutMs ?? 90_000),
+        });
+        if (!resp.ok) {
+            const body = await resp.text();
+            throw new Error(`Skill upgrade LLM failed (${resp.status}): ${body}`);
+        }
+        const json = (await resp.json());
+        const raw = json.choices[0]?.message?.content?.trim() ?? "";
+        const changelogSep = raw.indexOf("---CHANGELOG---");
+        if (changelogSep !== -1) {
+            const newContent = raw.slice(0, changelogSep).trim();
+            const afterChangelog = raw.slice(changelogSep + "---CHANGELOG---".length).trim();
+            const summarySep = afterChangelog.indexOf("---CHANGE_SUMMARY---");
+            if (summarySep !== -1) {
+                const changelog = afterChangelog.slice(0, summarySep).trim();
+                const changeSummary = afterChangelog.slice(summarySep + "---CHANGE_SUMMARY---".length).trim();
+                return { newContent, changelog, changeSummary };
+            }
+            return { newContent, changelog: afterChangelog, changeSummary: "" };
+        }
+        return { newContent: raw, changelog: "", changeSummary: "" };
+    }
+    parseDescription(content) {
+        const match = content.match(/description:\s*"([^"]+)"/);
+        if (match)
+            return match[1];
+        const match2 = content.match(/description:\s*'([^']+)'/);
+        if (match2)
+            return match2[1];
+        return "";
+    }
+    getProviderConfig() {
+        return this.ctx.config.skillEvolution?.summarizer ?? this.ctx.config.summarizer;
+    }
+    normalizeEndpoint(url) {
+        const stripped = url.replace(/\/+$/, "");
+        if (stripped.endsWith("/chat/completions"))
+            return stripped;
+        if (stripped.endsWith("/completions"))
+            return stripped;
+        return `${stripped}/chat/completions`;
+    }
+}
+exports.SkillUpgrader = SkillUpgrader;
+//# sourceMappingURL=upgrader.js.map

package/dist/skill/upgrader.js.map

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

package/dist/skill/validator.d.ts

@@ -0,0 +1,29 @@
+import type { PluginContext } from "../types";
+export interface ValidationResult {
+    valid: boolean;
+    qualityScore: number | null;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+}
+export declare class SkillValidator {
+    private ctx;
+    constructor(ctx: PluginContext);
+    /**
+     * Format validation (no LLM needed) + optional LLM quality assessment.
+     * Returns combined result with score 0-10.
+     */
+    validate(dirPath: string, opts?: {
+        skipLLM?: boolean;
+        previousContent?: string;
+    }): Promise<ValidationResult>;
+    private validateFormat;
+    /**
+     * Check that an upgrade doesn't lose significant content from the previous version.
+     */
+    private regressionCheck;
+    private assessQuality;
+    private getProviderConfig;
+    private normalizeEndpoint;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/skill/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/skill/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,UAAU,CAAC;AAGhE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAEtC;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4BlH,OAAO,CAAC,cAAc;IA8DtB;;OAEG;IACH,OAAO,CAAC,eAAe;YAqBT,aAAa;IA8D3B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,iBAAiB;CAM1B"}

package/dist/skill/validator.js

@@ -0,0 +1,227 @@
+"use strict";
+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.SkillValidator = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_1 = require("../types");
+class SkillValidator {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /**
+     * Format validation (no LLM needed) + optional LLM quality assessment.
+     * Returns combined result with score 0-10.
+     */
+    async validate(dirPath, opts) {
+        const result = {
+            valid: true,
+            qualityScore: null,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+        };
+        this.validateFormat(dirPath, result);
+        if (!result.valid)
+            return result;
+        if (opts?.previousContent) {
+            this.regressionCheck(dirPath, opts.previousContent, result);
+        }
+        if (!opts?.skipLLM) {
+            try {
+                await this.assessQuality(dirPath, result);
+            }
+            catch (err) {
+                this.ctx.log.warn(`SkillValidator: LLM quality assessment failed: ${err}`);
+                result.warnings.push(`Quality assessment skipped: ${err}`);
+            }
+        }
+        return result;
+    }
+    validateFormat(dirPath, result) {
+        const skillMdPath = path.join(dirPath, "SKILL.md");
+        if (!fs.existsSync(skillMdPath)) {
+            result.valid = false;
+            result.errors.push("SKILL.md not found");
+            return;
+        }
+        const content = fs.readFileSync(skillMdPath, "utf-8");
+        if (!content.trim()) {
+            result.valid = false;
+            result.errors.push("SKILL.md is empty");
+            return;
+        }
+        const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+        if (!fmMatch) {
+            result.valid = false;
+            result.errors.push("YAML frontmatter missing (expected --- ... ---)");
+            return;
+        }
+        const frontmatter = fmMatch[1];
+        const nameMatch = frontmatter.match(/^name:\s*["']?(.+?)["']?\s*$/m);
+        if (!nameMatch || !nameMatch[1].trim()) {
+            result.valid = false;
+            result.errors.push("Frontmatter missing 'name' field");
+            return;
+        }
+        const name = nameMatch[1].trim();
+        if (name.length > 64) {
+            result.errors.push(`Name too long (${name.length} chars, max 64)`);
+            result.valid = false;
+        }
+        if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(name) && name.length > 1) {
+            result.warnings.push(`Name "${name}" is not strict kebab-case`);
+        }
+        const descMatch = frontmatter.match(/^description:\s*["']?([\s\S]*?)["']?\s*$/m);
+        if (!descMatch || !descMatch[1].trim()) {
+            result.valid = false;
+            result.errors.push("Frontmatter missing 'description' field");
+            return;
+        }
+        const desc = descMatch[1].trim();
+        if (desc.length > 1024) {
+            result.warnings.push(`Description too long (${desc.length} chars, max 1024)`);
+        }
+        const maxLines = this.ctx.config.skillEvolution?.maxSkillLines ?? types_1.DEFAULTS.skillMaxLines;
+        const lineCount = content.split("\n").length;
+        if (lineCount > maxLines) {
+            result.warnings.push(`Content exceeds ${maxLines} lines (has ${lineCount})`);
+        }
+        if (content.length < 200) {
+            result.warnings.push("Content seems very short (< 200 chars)");
+        }
+    }
+    /**
+     * Check that an upgrade doesn't lose significant content from the previous version.
+     */
+    regressionCheck(dirPath, previousContent, result) {
+        const skillMdPath = path.join(dirPath, "SKILL.md");
+        const newContent = fs.readFileSync(skillMdPath, "utf-8");
+        const prevLines = previousContent.split("\n").length;
+        const newLines = newContent.split("\n").length;
+        if (newLines < prevLines * 0.7 && prevLines > 20) {
+            result.warnings.push(`Content shrank significantly: ${prevLines} → ${newLines} lines (${Math.round((1 - newLines / prevLines) * 100)}% reduction)`);
+        }
+        const prevSections = (previousContent.match(/^##\s+.+$/gm) || []).map(s => s.replace(/^##\s+/, "").trim().toLowerCase());
+        const newSections = (newContent.match(/^##\s+.+$/gm) || []).map(s => s.replace(/^##\s+/, "").trim().toLowerCase());
+        const missingSections = prevSections.filter(s => !newSections.some(ns => ns.includes(s) || s.includes(ns)));
+        if (missingSections.length > 0) {
+            result.warnings.push(`Sections may have been lost: ${missingSections.join(", ")}`);
+        }
+    }
+    async assessQuality(dirPath, result) {
+        const cfg = this.getProviderConfig();
+        if (!cfg)
+            return;
+        const skillMdPath = path.join(dirPath, "SKILL.md");
+        const content = fs.readFileSync(skillMdPath, "utf-8");
+        const prompt = QUALITY_PROMPT.replace("{SKILL_CONTENT}", content.slice(0, 6000));
+        const endpoint = this.normalizeEndpoint(cfg.endpoint ?? "https://api.openai.com/v1/chat/completions");
+        const headers = {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${cfg.apiKey}`,
+            ...cfg.headers,
+        };
+        const resp = await fetch(endpoint, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                model: cfg.model ?? "gpt-4o-mini",
+                temperature: cfg.temperature ?? 0.1,
+                max_tokens: 1024,
+                messages: [{ role: "user", content: prompt }],
+            }),
+            signal: AbortSignal.timeout(cfg.timeoutMs ?? 30_000),
+        });
+        if (!resp.ok) {
+            const body = await resp.text();
+            throw new Error(`Quality LLM failed (${resp.status}): ${body}`);
+        }
+        const json = (await resp.json());
+        const raw = json.choices[0]?.message?.content?.trim() ?? "";
+        const jsonMatch = raw.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            return;
+        try {
+            const assessment = JSON.parse(jsonMatch[0]);
+            result.qualityScore = Math.max(0, Math.min(10, assessment.score));
+            if (assessment.suggestions) {
+                result.suggestions.push(...assessment.suggestions);
+            }
+            if (assessment.weaknesses) {
+                result.warnings.push(...assessment.weaknesses);
+            }
+            if (result.qualityScore < 6) {
+                result.warnings.push(`Quality score ${result.qualityScore}/10 is below threshold, marked as draft`);
+            }
+        }
+        catch {
+            this.ctx.log.warn("SkillValidator: failed to parse quality assessment JSON");
+        }
+    }
+    getProviderConfig() {
+        return this.ctx.config.skillEvolution?.summarizer ?? this.ctx.config.summarizer;
+    }
+    normalizeEndpoint(url) {
+        const stripped = url.replace(/\/+$/, "");
+        if (stripped.endsWith("/chat/completions"))
+            return stripped;
+        if (stripped.endsWith("/completions"))
+            return stripped;
+        return `${stripped}/chat/completions`;
+    }
+}
+exports.SkillValidator = SkillValidator;
+const QUALITY_PROMPT = `You are a skill quality reviewer. Evaluate the following SKILL.md and give a score from 0 to 10.
+
+Criteria:
+1. Clarity: Are the steps clear and actionable? (0-2 pts)
+2. Completeness: Does it cover scenarios, pitfalls, and key code? (0-2 pts)
+3. Reusability: Can this skill be applied to similar future tasks? (0-2 pts)
+4. Accuracy: Are commands, code, and configurations correct? (0-2 pts)
+5. Structure: Is the format well-organized with proper sections? (0-2 pts)
+
+SKILL.md:
+{SKILL_CONTENT}
+
+Reply in JSON only:
+{
+  "score": 0-10,
+  "strengths": ["what's good"],
+  "weaknesses": ["what's lacking"],
+  "suggestions": ["how to improve"]
+}`;
+//# sourceMappingURL=validator.js.map

package/dist/skill/validator.js.map

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

package/dist/storage/sqlite.d.ts

@@ -1,4 +1,4 @@
-import type { Chunk, ChunkRef, Task, TaskStatus, Logger } from "../types";
+import type { Chunk, ChunkRef, Task, TaskStatus, Skill, SkillStatus, SkillVersion, TaskSkillRelation, Logger } from "../types";
 export declare class SqliteStore {
     private log;
     private db;
@@ -6,6 +6,49 @@ export declare class SqliteStore {
     private migrate;
     private migrateTaskId;
     private migrateContentHash;
+    private migrateSkillTables;
+    private migrateSkillId;
+    private migrateSkillQualityScore;
+    private migrateTaskSkillMeta;
+    setTaskSkillMeta(taskId: string, meta: {
+        skillStatus: string;
+        skillReason: string;
+    }): void;
+    private migrateMergeFields;
+    private migrateApiLogs;
+    private migrateDedupStatus;
+    recordApiLog(toolName: string, input: unknown, output: string, durationMs: number, success: boolean): void;
+    getApiLogs(limit?: number, offset?: number, toolFilter?: string): {
+        logs: Array<{
+            id: number;
+            toolName: string;
+            input: string;
+            output: string;
+            durationMs: number;
+            success: boolean;
+            calledAt: number;
+        }>;
+        total: number;
+    };
+    getApiLogToolNames(): string[];
+    recordMergeHit(chunkId: string, action: "DUPLICATE" | "UPDATE", reason: string, oldSummary?: string, newSummary?: string): void;
+    updateChunkSummaryAndContent(chunkId: string, newSummary: string, appendContent: string): void;
+    private migrateToolCalls;
+    recordToolCall(toolName: string, durationMs: number, success: boolean): void;
+    getToolMetrics(minutes: number): {
+        tools: string[];
+        series: Array<{
+            minute: string;
+            [tool: string]: number | string;
+        }>;
+        aggregated: Array<{
+            tool: string;
+            totalCalls: number;
+            avgMs: number;
+            p95Ms: number;
+            errorCount: number;
+        }>;
+    };
     /** Record a viewer API call for analytics (list, search, etc.). */
     recordViewerEvent(eventType: string): void;
     /**
@@ -33,6 +76,7 @@ export declare class SqliteStore {
         };
     };
     insertChunk(chunk: Chunk): void;
+    markDedupStatus(chunkId: string, status: "duplicate" | "merged", targetChunkId: string | null, reason: string): void;
     updateSummary(chunkId: string, summary: string): void;
     upsertEmbedding(chunkId: string, vector: number[]): void;
     getChunk(chunkId: string): Chunk | null;
@@ -95,6 +139,36 @@ export declare class SqliteStore {
     chunkExistsByContent(sessionKey: string, role: string, content: string): boolean;
     getRecentChunkIds(limit: number): string[];
     countChunks(): number;
+    insertSkill(skill: Skill): void;
+    getSkill(skillId: string): Skill | null;
+    getSkillByName(name: string): Skill | null;
+    updateSkill(skillId: string, fields: {
+        description?: string;
+        version?: number;
+        status?: SkillStatus;
+        installed?: number;
+        qualityScore?: number | null;
+        updatedAt?: number;
+    }): void;
+    listSkills(opts?: {
+        status?: string;
+    }): Skill[];
+    insertSkillVersion(sv: SkillVersion): void;
+    getLatestSkillVersion(skillId: string): SkillVersion | null;
+    getSkillVersions(skillId: string): SkillVersion[];
+    getSkillVersion(skillId: string, version: number): SkillVersion | null;
+    linkTaskSkill(taskId: string, skillId: string, relation: TaskSkillRelation, versionAt: number): void;
+    getSkillsByTask(taskId: string): Array<{
+        skill: Skill;
+        relation: TaskSkillRelation;
+        versionAt: number;
+    }>;
+    getTasksBySkill(skillId: string): Array<{
+        task: Task;
+        relation: TaskSkillRelation;
+    }>;
+    countSkills(status?: string): number;
+    setChunkSkillId(chunkId: string, skillId: string): void;
     close(): void;
 }
 //# sourceMappingURL=sqlite.d.ts.map