@lingxiao-office/sdk 1.0.0

package/dist/core/SkillDefinitionService.js

@@ -0,0 +1,144 @@
+/**
+ * SkillDefinitionService — write-capable persistence for user-defined skills,
+ * mirroring AgentDefinitionService. The read-only SkillCatalog
+ * (collectAvailableSkills) stays untouched; this service owns only the
+ * create / update / delete of markdown skill files, so the cached read path
+ * is never polluted by write logic.
+ *
+ *   .lingxiao/skills/<name>.md      (project, default)
+ *   <globalSkillsDir>/<name>.md     (global)
+ *
+ * Skill file format (matches DistillCommand's skill write contract and what
+ * SkillCatalog.collectMarkdownSkills reads back — flat form):
+ *   ---
+ *   name: <name>
+ *   description: <one line>
+ *   ---
+ *   <markdown body / procedure>
+ *
+ * Project definitions override global by name (SkillCatalog visits project
+ * first). Deterministic only: name validated by regex, description + body
+ * required — no heuristics, no keyword matching.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { getGlobalSkillsDir } from './BundledSkillRegistry.js';
+const VALID_SKILL_NAME_RE = /^[A-Za-z][A-Za-z0-9_-]{1,63}$/;
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+export function validateSkillName(name) {
+    const trimmed = name.trim().replace(/\.md$/i, '');
+    if (trimmed.includes('/') || trimmed.includes('\\') || basename(trimmed) !== trimmed) {
+        throw new Error('Invalid skill name. Do not include paths.');
+    }
+    if (!VALID_SKILL_NAME_RE.test(trimmed)) {
+        throw new Error('Invalid skill name. Use 2-64 chars: letters, numbers, hyphen, underscore; start with a letter.');
+    }
+    return trimmed;
+}
+function cleanOneLine(value) {
+    return value.replace(/\r?\n/g, ' ').replace(/\s+/g, ' ').trim();
+}
+function defaultSkillsDir(workspace, scope, globalSkillsDir) {
+    return scope === 'project'
+        ? join(resolve(workspace), '.lingxiao', 'skills')
+        : resolve(globalSkillsDir ?? getGlobalSkillsDir());
+}
+function stripFrontmatter(raw) {
+    const match = raw.match(FRONTMATTER_RE);
+    if (!match) {
+        return { meta: {}, body: raw.trim() };
+    }
+    const parsed = parseYaml(match[1] || '');
+    const meta = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed
+        : {};
+    return { meta, body: raw.slice(match[0].length).trim() };
+}
+function renderSkillMarkdown(definition) {
+    const frontmatter = {
+        name: definition.name,
+        description: cleanOneLine(definition.description),
+    };
+    return [
+        '---',
+        stringifyYaml(frontmatter).trimEnd(),
+        '---',
+        '',
+        definition.body.trim(),
+        '',
+    ].join('\n');
+}
+function normalizeSkill(input) {
+    const name = validateSkillName(input.name);
+    const description = cleanOneLine(input.description || '');
+    if (!description) {
+        throw new Error('Skill description is required.');
+    }
+    const body = (input.body || '').trim();
+    if (!body) {
+        throw new Error('Skill body is required.');
+    }
+    return { name, description, body };
+}
+function parseSkillFile(path, fallbackName, source) {
+    const raw = readFileSync(path, 'utf-8');
+    const { meta, body } = stripFrontmatter(raw);
+    const name = validateSkillName(typeof meta.name === 'string' ? meta.name : fallbackName);
+    const description = cleanOneLine(typeof meta.description === 'string' ? meta.description : '');
+    if (!description || !body.trim()) {
+        return null;
+    }
+    const stat = statSync(path);
+    return {
+        name,
+        description,
+        body: body.trim(),
+        source,
+        path,
+        updatedAt: stat.mtimeMs,
+    };
+}
+export class SkillDefinitionService {
+    workspace;
+    globalSkillsDir;
+    constructor(options = {}) {
+        this.workspace = resolve(options.workspace ?? process.cwd());
+        this.globalSkillsDir = options.globalSkillsDir;
+    }
+    getSkillsDir(scope) {
+        return defaultSkillsDir(this.workspace, scope, this.globalSkillsDir);
+    }
+    /** Read back a single user-authored skill (flat <name>.md) for edit prefill. */
+    getDefinitionInScope(name, scope) {
+        const normalized = validateSkillName(name);
+        const path = join(this.getSkillsDir(scope), `${normalized}.md`);
+        if (!existsSync(path) || !statSync(path).isFile())
+            return null;
+        return parseSkillFile(path, normalized, scope);
+    }
+    saveDefinition(input) {
+        const scope = input.scope ?? 'project';
+        const definition = normalizeSkill(input);
+        const dir = this.getSkillsDir(scope);
+        mkdirSync(dir, { recursive: true });
+        const path = join(dir, `${definition.name}.md`);
+        writeFileSync(path, renderSkillMarkdown(definition), 'utf-8');
+        return {
+            ...definition,
+            source: scope,
+            path,
+            updatedAt: statSync(path).mtimeMs,
+        };
+    }
+    deleteDefinition(name, scope = 'project') {
+        const normalized = validateSkillName(name);
+        const path = join(this.getSkillsDir(scope), `${normalized}.md`);
+        if (!existsSync(path))
+            return false;
+        rmSync(path, { force: true });
+        return true;
+    }
+}
+export default SkillDefinitionService;
+//# sourceMappingURL=SkillDefinitionService.js.map

package/dist/core/SkillDefinitionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDefinitionService.js","sourceRoot":"","sources":["../../src/core/SkillDefinitionService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AA4B/D,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAC5D,MAAM,cAAc,GAAG,mCAAmC,CAAC;AAE3D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,KAAK,OAAO,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,KAA2B,EAAE,eAAwB;IAChG,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC;QACjD,CAAC,CAAC,OAAO,CAAC,eAAe,IAAI,kBAAkB,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QACzE,CAAC,CAAC,MAAiC;QACnC,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,mBAAmB,CAAC,UAA2B;IACtD,MAAM,WAAW,GAA4B;QAC3C,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC;KAClD,CAAC;IACF,OAAO;QACL,KAAK;QACL,aAAa,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;QACpC,KAAK;QACL,EAAE;QACF,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QACtB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAA+B;IACrD,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,YAAoB,EAAE,MAA4B;IACtF,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACzF,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/F,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO;QACL,IAAI;QACJ,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,MAAM;QACN,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,sBAAsB;IAChB,SAAS,CAAS;IAClB,eAAe,CAAU;IAE1C,YAAY,UAAyC,EAAE;QACrD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,KAA2B;QACtC,OAAO,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACvE,CAAC;IAED,gFAAgF;IAChF,oBAAoB,CAAC,IAAY,EAAE,KAA2B;QAC5D,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,UAAU,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAC/D,OAAO,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,cAAc,CAAC,KAA+B;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;QACvC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;QAChD,aAAa,CAAC,IAAI,EAAE,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO;YACL,GAAG,UAAU;YACb,MAAM,EAAE,KAAK;YACb,IAAI;YACJ,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO;SAClC,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,QAA8B,SAAS;QACpE,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,UAAU,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,eAAe,sBAAsB,CAAC"}

package/dist/core/SkillPhaseLoader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SkillPhaseLoader — 分层技能加载器
+ *
+ * 加载技能目录下的 phases/ 子目录，并解析 Phase 文件中的 Quality Gate。
+ */
+export interface SkillPhase {
+    name: string;
+    path: string;
+    content: string;
+}
+export interface QualityGate {
+    checks: string[];
+    skipConditions: string[];
+}
+/** 从 markdown 中解析 Quality Gate 和 Skip Conditions 段落 */
+export declare function parseQualityGate(content: string): QualityGate;
+/** 加载技能目录下的 phases/ 子目录 */
+export declare function loadSkillPhases(skillDir: string): SkillPhase[];
+/** 检查 phases 中是否存在 Quality Gate */
+export declare function hasQualityGates(phases: SkillPhase[]): boolean;
+//# sourceMappingURL=SkillPhaseLoader.d.ts.map

package/dist/core/SkillPhaseLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillPhaseLoader.d.ts","sourceRoot":"","sources":["../../src/core/SkillPhaseLoader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CA6C7D;AA0BD,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAE9D;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAK7D"}

package/dist/core/SkillPhaseLoader.js

@@ -0,0 +1,85 @@
+/**
+ * SkillPhaseLoader — 分层技能加载器
+ *
+ * 加载技能目录下的 phases/ 子目录，并解析 Phase 文件中的 Quality Gate。
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { basename, join } from 'path';
+/** 从 markdown 中解析 Quality Gate 和 Skip Conditions 段落 */
+export function parseQualityGate(content) {
+    const checks = [];
+    const skipConditions = [];
+    const lines = content.split('\n');
+    let section = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (/^#{1,3}\s*Quality\s*Gate/i.test(trimmed)) {
+            section = 'checks';
+            continue;
+        }
+        if (/^#{1,3}\s*Skip\s*Conditions?/i.test(trimmed)) {
+            section = 'skip';
+            continue;
+        }
+        // 遇到下一个同级或更高级标题时退出当前段落
+        if (/^#{1,3}\s+/.test(trimmed) && section) {
+            section = null;
+            continue;
+        }
+        if (section === 'checks') {
+            const match = trimmed.match(/^[-*]\s+\[?\s*[x ]?\s*\]?\s*(.+)/i);
+            if (match?.[1]) {
+                checks.push(match[1].trim());
+            }
+            else if (trimmed && !trimmed.startsWith('#')) {
+                // 非 checkbox 格式的条目也收集
+                checks.push(trimmed);
+            }
+        }
+        if (section === 'skip') {
+            const match = trimmed.match(/^[-*]\s+(.+)/);
+            if (match?.[1]) {
+                skipConditions.push(match[1].trim());
+            }
+            else if (trimmed && !trimmed.startsWith('#')) {
+                skipConditions.push(trimmed);
+            }
+        }
+    }
+    return { checks, skipConditions };
+}
+/** 从目录中加载 .md 文件为条目列表 */
+function loadMarkdownEntries(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const entries = [];
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.md'))
+            continue;
+        const fullPath = join(dir, file);
+        const stat = statSync(fullPath);
+        if (!stat.isFile())
+            continue;
+        try {
+            const content = readFileSync(fullPath, 'utf-8');
+            entries.push({ name: basename(file, '.md'), path: fullPath, content });
+        }
+        catch {
+            // 跳过读取失败的文件
+        }
+    }
+    return entries;
+}
+/** 加载技能目录下的 phases/ 子目录 */
+export function loadSkillPhases(skillDir) {
+    return loadMarkdownEntries(join(skillDir, 'phases'));
+}
+/** 检查 phases 中是否存在 Quality Gate */
+export function hasQualityGates(phases) {
+    return phases.some((phase) => {
+        const gate = parseQualityGate(phase.content);
+        return gate.checks.length > 0;
+    });
+}
+//# sourceMappingURL=SkillPhaseLoader.js.map

package/dist/core/SkillPhaseLoader.js.map

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

package/dist/core/SkillSelectionPolicy.d.ts

@@ -0,0 +1,7 @@
+export interface SkillSelectionPolicy {
+    disabledSkillNames: string[];
+    digestGuidance: string[];
+}
+export declare const SKILL_SELECTION_POLICY: SkillSelectionPolicy;
+export declare function isSkillDisabledByPolicy(name: string): boolean;
+//# sourceMappingURL=SkillSelectionPolicy.d.ts.map

package/dist/core/SkillSelectionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillSelectionPolicy.d.ts","sourceRoot":"","sources":["../../src/core/SkillSelectionPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,eAAO,MAAM,sBAAsB,EAAE,oBAKpC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/core/SkillSelectionPolicy.js

@@ -0,0 +1,10 @@
+export const SKILL_SELECTION_POLICY = {
+    disabledSkillNames: [],
+    digestGuidance: [
+        '按任务目标主动选择 skill_names；用户显式写 $skill 时按指定 skill 优先。',
+    ],
+};
+export function isSkillDisabledByPolicy(name) {
+    return SKILL_SELECTION_POLICY.disabledSkillNames.includes(name);
+}
+//# sourceMappingURL=SkillSelectionPolicy.js.map

package/dist/core/SkillSelectionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillSelectionPolicy.js","sourceRoot":"","sources":["../../src/core/SkillSelectionPolicy.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,sBAAsB,GAAyB;IAC1D,kBAAkB,EAAE,EAAE;IACtB,cAAc,EAAE;QACd,mDAAmD;KACpD;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/core/SlidevServerManager.d.ts

@@ -0,0 +1,51 @@
+export interface SlidevServerHandle {
+    id: string;
+    projectDir: string;
+    slidesPath: string;
+    host: string;
+    port: number;
+    url: string;
+    createdAt: number;
+    lastAccessAt: number;
+}
+interface ManagedSlidevServer extends SlidevServerHandle {
+    server: {
+        close?: () => Promise<void> | void;
+        listen?: (port?: number, isRestart?: boolean) => Promise<unknown>;
+    };
+}
+export declare class SlidevServerManager {
+    /**
+     * in-flight + 已就绪的 server 创建 Promise，按 projectDir 派生的 id 去重。
+     * 并发同一 projectDir 的 start 复用同一个 Promise，避免后到的调用重复 createServer
+     * 覆盖前者的 server 实例，导致前一个 server 端口/内存泄漏（无人 close）。
+     */
+    private servers;
+    /** 已成功创建并就绪的 server，供同步 getter / 清理 / 销毁使用 */
+    private resolved;
+    private cleanupTimer;
+    private readonly ttlMs;
+    start(input: {
+        projectDir: string;
+        slidesPath: string;
+        host?: string;
+        port?: number;
+    }): Promise<SlidevServerHandle>;
+    private createManagedServer;
+    /**
+     * 真正拉起底层 @slidev/cli 服务。抽成独立的可重写方法，便于测试在不依赖真实
+     * Slidev 运行时的前提下验证并发去重 / 生命周期逻辑。
+     */
+    protected instantiateSlidevServer(slidesPath: string, host: string, port: number): Promise<ManagedSlidevServer['server']>;
+    getById(id: string): SlidevServerHandle | undefined;
+    getByProjectDir(projectDir: string): SlidevServerHandle | undefined;
+    stopById(id: string): Promise<boolean>;
+    destroy(): Promise<void>;
+    private ensureCleanupTimer;
+    private cleanupExpired;
+    private closeServer;
+    private publicHandle;
+}
+export declare const slidevServerManager: SlidevServerManager;
+export {};
+//# sourceMappingURL=SlidevServerManager.d.ts.map

package/dist/core/SlidevServerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlidevServerManager.d.ts","sourceRoot":"","sources":["../../src/core/SlidevServerManager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,mBAAoB,SAAQ,kBAAkB;IACtD,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;CACnH;AA4BD,qBAAa,mBAAmB;IAC9B;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAmD;IAClE,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAE/B,KAAK,CAAC,KAAK,EAAE;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAsCjB,mBAAmB;IAwBjC;;;OAGG;cACa,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAoBzC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAOnD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI7D,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBtC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,OAAO,CAAC,kBAAkB;YAQZ,cAAc;YAed,WAAW;IAQzB,OAAO,CAAC,YAAY;CAIrB;AAED,eAAO,MAAM,mBAAmB,qBAA4B,CAAC"}

package/dist/core/SlidevServerManager.js

@@ -0,0 +1,200 @@
+import { createServer as netCreateServer } from 'net';
+import { resolve } from 'path';
+import { coreLogger } from './Log.js';
+async function findAvailablePort(host, requestedPort) {
+    return new Promise((resolvePort, reject) => {
+        const server = netCreateServer();
+        server.listen(requestedPort ?? 0, host, () => {
+            const port = server.address().port;
+            server.close(() => resolvePort(port));
+        });
+        server.on('error', (err) => {
+            if (requestedPort && err.code === 'EADDRINUSE') {
+                const fallback = netCreateServer();
+                fallback.listen(0, host, () => {
+                    const port = fallback.address().port;
+                    fallback.close(() => resolvePort(port));
+                });
+                fallback.on('error', reject);
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+function idFromProjectDir(projectDir) {
+    return Buffer.from(resolve(projectDir)).toString('base64url');
+}
+export class SlidevServerManager {
+    /**
+     * in-flight + 已就绪的 server 创建 Promise，按 projectDir 派生的 id 去重。
+     * 并发同一 projectDir 的 start 复用同一个 Promise，避免后到的调用重复 createServer
+     * 覆盖前者的 server 实例，导致前一个 server 端口/内存泄漏（无人 close）。
+     */
+    servers = new Map();
+    /** 已成功创建并就绪的 server，供同步 getter / 清理 / 销毁使用 */
+    resolved = new Map();
+    cleanupTimer = null;
+    ttlMs = 60 * 60_000;
+    async start(input) {
+        const projectDir = resolve(input.projectDir);
+        const id = idFromProjectDir(projectDir);
+        // 并发去重：若已有同 projectDir 的 in-flight / 已就绪 Promise，复用它，
+        // 绝不重复创建。占位在 createServer 之前完成，关闭并发竞态窗口。
+        const inflight = this.servers.get(id);
+        if (inflight) {
+            try {
+                const server = await inflight;
+                server.lastAccessAt = Date.now();
+                return this.publicHandle(server);
+            }
+            catch {
+                // 之前那次创建失败：清掉坏槽位（若仍是同一个）后继续重新创建
+                if (this.servers.get(id) === inflight) {
+                    this.servers.delete(id);
+                }
+            }
+        }
+        const startPromise = this.createManagedServer(id, projectDir, input);
+        // 立刻占位：后续并发 start 会命中这个 Promise 而非另起一个 server
+        this.servers.set(id, startPromise);
+        try {
+            const server = await startPromise;
+            this.resolved.set(id, server);
+            this.ensureCleanupTimer();
+            return this.publicHandle(server);
+        }
+        catch (err) {
+            // 创建失败：撤销占位，避免坏槽位永久卡住后续 start
+            if (this.servers.get(id) === startPromise) {
+                this.servers.delete(id);
+            }
+            throw err;
+        }
+    }
+    async createManagedServer(id, projectDir, input) {
+        const host = input.host || '127.0.0.1';
+        const port = await findAvailablePort(host, input.port);
+        const server = await this.instantiateSlidevServer(input.slidesPath, host, port);
+        const url = `http://${host}:${port}/`;
+        const handle = {
+            id,
+            projectDir,
+            slidesPath: input.slidesPath,
+            host,
+            port,
+            url,
+            createdAt: Date.now(),
+            lastAccessAt: Date.now(),
+            server,
+        };
+        return handle;
+    }
+    /**
+     * 真正拉起底层 @slidev/cli 服务。抽成独立的可重写方法，便于测试在不依赖真实
+     * Slidev 运行时的前提下验证并发去重 / 生命周期逻辑。
+     */
+    async instantiateSlidevServer(slidesPath, host, port) {
+        const { createServer, resolveOptions } = await import('@slidev/cli');
+        const options = await resolveOptions({
+            entry: slidesPath,
+        }, 'dev');
+        const server = await createServer(options, {
+            server: {
+                host,
+                port,
+                strictPort: true,
+                open: false,
+            },
+            optimizeDeps: { force: true },
+            clearScreen: false,
+            logLevel: 'warn',
+        });
+        await server.listen(port);
+        return server;
+    }
+    getById(id) {
+        const existing = this.resolved.get(id);
+        if (!existing)
+            return undefined;
+        existing.lastAccessAt = Date.now();
+        return this.publicHandle(existing);
+    }
+    getByProjectDir(projectDir) {
+        return this.getById(idFromProjectDir(projectDir));
+    }
+    async stopById(id) {
+        const pending = this.servers.get(id);
+        this.servers.delete(id);
+        const existing = this.resolved.get(id);
+        this.resolved.delete(id);
+        if (existing) {
+            await this.closeServer(existing);
+            return true;
+        }
+        if (pending) {
+            // 还在创建中：等它就绪后再关，避免泄漏刚起来的 server
+            try {
+                const server = await pending;
+                await this.closeServer(server);
+            }
+            catch {
+                // 创建本就失败，无需关闭
+            }
+            return true;
+        }
+        return false;
+    }
+    async destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        // servers 覆盖 in-flight + 已就绪的全部 Promise，先结算再统一关闭，避免漏关刚起来的 server
+        const pending = Array.from(this.servers.values());
+        this.servers.clear();
+        this.resolved.clear();
+        const settled = await Promise.allSettled(pending);
+        const servers = settled
+            .filter((r) => r.status === 'fulfilled')
+            .map(r => r.value);
+        await Promise.allSettled(servers.map(server => this.closeServer(server)));
+    }
+    ensureCleanupTimer() {
+        if (this.cleanupTimer)
+            return;
+        this.cleanupTimer = setInterval(() => {
+            void this.cleanupExpired();
+        }, 5 * 60_000);
+        this.cleanupTimer.unref();
+    }
+    async cleanupExpired() {
+        const now = Date.now();
+        for (const [id, server] of this.resolved) {
+            if (now - server.lastAccessAt > this.ttlMs) {
+                this.resolved.delete(id);
+                this.servers.delete(id);
+                await this.closeServer(server);
+            }
+        }
+        if (this.resolved.size === 0 && this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    async closeServer(server) {
+        try {
+            await server.server.close?.();
+        }
+        catch (err) {
+            coreLogger.warn('Slidev server 关闭失败', { err: err instanceof Error ? err.message : String(err), projectDir: server.projectDir });
+        }
+    }
+    publicHandle(server) {
+        const { id, projectDir, slidesPath, host, port, url, createdAt, lastAccessAt } = server;
+        return { id, projectDir, slidesPath, host, port, url, createdAt, lastAccessAt };
+    }
+}
+export const slidevServerManager = new SlidevServerManager();
+//# sourceMappingURL=SlidevServerManager.js.map

package/dist/core/SlidevServerManager.js.map

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

package/dist/core/SoulExtractor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SoulExtractor - 会话结束时自动提取可沉淀的长期记忆候选
+ *
+ * 过滤噪音（工具调用、系统消息、思考片段），只保留用户请求和 Leader 最终回复中的关键信息。
+ */
+/** 通用消息接口，兼容 BusMessage 和 CommandLogMessage */
+export interface SoulMessage {
+    type?: string;
+    content?: unknown;
+    from?: string;
+    to?: string;
+    payload?: unknown;
+}
+export interface SoulExtractedEntry {
+    category: 'preference' | 'decision' | 'architecture' | 'norm' | 'other';
+    content: string;
+    scope: 'user' | 'project';
+}
+export interface SoulExtractResult {
+    entries: SoulExtractedEntry[];
+    soulPath?: string;
+}
+/**
+ * 从会话消息中提取长期记忆候选
+ *
+ * 过滤掉工具调用日志、系统消息、思考片段，
+ * 只保留用户请求和 Leader 最终回复，并分类提取。
+ */
+export declare function extractSoulContent(messages: SoulMessage[]): SoulExtractedEntry[];
+/**
+ * 格式化长期记忆条目正文。函数名保留旧 soul 口径，供兼容调用。
+ */
+export declare function formatSoulEntry(entry: SoulExtractedEntry, timestamp: string): string;
+//# sourceMappingURL=SoulExtractor.d.ts.map

package/dist/core/SoulExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoulExtractor.d.ts","sourceRoot":"","sources":["../../src/core/SoulExtractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA8DD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAE,CAwBhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUpF"}