@shgroup/opencode-serenity-plugin 0.2.0

package/dist/msm.js

@@ -0,0 +1,317 @@
+/**
+ * msm.ts
+ *
+ * 工具集（3 个）：
+ * - msm_list          : PRIMARY — 列出所有 MSM
+ * - msm_exec          : PRIMARY — 执行 MSM / 协议元命令
+ * - msm_admin         : 注册 / 注销 MSM（合并 register/deregister）
+ *
+ * 注意：bash override (RR3) 已于 2026-06-08 移除。
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { tool } from '@opencode-ai/plugin';
+import { z } from 'zod';
+import { log } from './util/log.js';
+import { MsmAlreadyRegisteredError, MsmExecutionError, MsmNotInRegistryError, MsmNotRegisteredError, MsmPathEscapeError, MsmScriptNotFoundError, } from './errors.js';
+import { getState, ensureReady } from './state.js';
+import { isPathInside, gitAddAndCommit } from './util/git.js';
+import { normalizeFlags, validatePathArgsFromTokens } from './msm-schema.js';
+import { callMsmExec } from './util/msm-call.js';
+import { parseMechRegistryFile, } from './config-schema.js';
+import pkg from '../package.json' with { type: 'json' };
+/** v0.0.3 — plugin version exposed via msmExecTool description + msmListTool output (was silent) */
+const VERSION = pkg.version;
+/** 加载 mech-registry.json（v0 简化：实例内一份） */
+/** 支持两种 schema：
+ *  - v1 包装格式：{ version, description, entries: [...] }
+ *  - 数组格式：[...]
+ * 返回统一 MechEntry[]
+ */
+export function loadMechRegistryFrom(cwdRoot, instanceName) {
+    return loadRegistryFile(cwdRoot, instanceName).entries;
+}
+function registryFilePath(cwdRoot, instanceName) {
+    return join(cwdRoot, '.opencode', 'skills', instanceName, 'references', 'mech-registry.json');
+}
+export function loadRegistryFile(cwdRoot, instanceName) {
+    const path = registryFilePath(cwdRoot, instanceName);
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const parsed = JSON.parse(raw);
+        // v1.13: 先用 zod 校验顶层结构,失败则降级为旧宽松解析
+        const validated = parseMechRegistryFile(parsed);
+        if (validated.success) {
+            const data = validated.data;
+            if (Array.isArray(data)) {
+                return { entries: data, isV1Wrapped: false };
+            }
+            return {
+                entries: data.entries,
+                isV1Wrapped: true,
+                version: data.version,
+                description: data.description,
+            };
+        }
+        // zod 失败 — 降级为旧逻辑 (向后兼容, 部分 v0/v1 schema 字段可能不严格)
+        if (Array.isArray(parsed)) {
+            return { entries: parsed, isV1Wrapped: false };
+        }
+        if (parsed && typeof parsed === 'object' && Array.isArray(parsed.entries)) {
+            return {
+                entries: parsed.entries,
+                isV1Wrapped: true,
+                version: typeof parsed.version === 'number' ? parsed.version : undefined,
+                description: typeof parsed.description === 'string' ? parsed.description : undefined,
+            };
+        }
+        log.warn('msm', 'mech-registry.json 顶层既不是数组也无 entries 字段', { path });
+        return { entries: [], isV1Wrapped: false };
+    }
+    catch (err) {
+        log.warn('msm', 'mech-registry.json 读取/解析失败', { path, err: String(err) });
+        return { entries: [], isV1Wrapped: false };
+    }
+}
+export function writeRegistryFile(cwdRoot, instanceName, file) {
+    const path = registryFilePath(cwdRoot, instanceName);
+    const payload = file.isV1Wrapped
+        ? {
+            version: file.version ?? 1,
+            description: file.description ?? 'serenity plugin: MSM registry',
+            entries: file.entries,
+        }
+        : file.entries;
+    writeFileSync(path, JSON.stringify(payload, null, 2) + '\n', 'utf8');
+}
+function loadMechRegistry() {
+    const state = getState();
+    if (!state.activated)
+        return [];
+    return loadMechRegistryFrom(state.cwdRoot, state.instanceName);
+}
+/** 查找 MSM（严格相等 + 路径必须在 cwdRoot 内） */
+function findMsm(name, registry) {
+    const entry = registry.find((e) => e.name === name);
+    if (!entry) {
+        throw new MsmNotRegisteredError(name);
+    }
+    return entry;
+}
+/* ===== msm_list tool ===== */
+export const msmListTool = tool({
+    description: '[PRIMARY] List all available MSM (Mech & Semi-Mech) tools in the current serenity instance. ' +
+        '**This is the FIRST tool to call for any shell/exec operation** — bash, read (path arguments), ' +
+        'and most plugin tools are intentionally limited. ' +
+        'Each MSM is a deterministic, audited operation registered in `mech-registry.json`. ' +
+        'Returns one MSM per line: `name | skill | category | description`. ' +
+        'If you need an operation that has no MSM, ask the user to register a new one before running arbitrary commands.',
+    args: {},
+    execute: async () => {
+        log.info('msm', 'msm_list called');
+        try {
+            await ensureReady();
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            log.warn('msm', 'msm_list: plugin not active', { reason });
+            return `serenity plugin is not active: ${reason}`;
+        }
+        const registry = loadMechRegistry();
+        log.info('msm', 'msm_list result', { count: registry.length, cwdRoot: getState().cwdRoot });
+        if (registry.length === 0) {
+            return `(serenity-plugin v${VERSION})\n(no MSM registered)`;
+        }
+        return `(serenity-plugin v${VERSION})\n` + registry.map((e) => `${e.name} | ${e.skill} | ${e.category} | ${e.description}`).join('\n');
+    },
+});
+/* ===== msm_exec tool (纯执行，无协议元命令) =====
+ *
+ * S028 D5 极简版：只讲 msmName + args + 1 示例。
+ * - 不再写"ALWAYS call msm_list first"（LLM 已知）
+ * - 不再写"30s timeout"（实际 600s，runtime 内统一）
+ * - 不再写"bash is disabled (RR3)"（已在 init-check / 工具面板冗余告知）
+ * - 不再写"args 是 string array"（zod schema 已在 args 字段定义）
+ */
+export const msmExecTool = tool({
+    description: 'Execute a registered MSM tool. ' +
+        'Call msm_list first to discover MSM names. ' +
+        'Example: msm_name="ssh-connect", args=["exec", "ubuntu", "ls -la"]. ' +
+        `(serenity-plugin v${VERSION})`,
+    args: {
+        msm_name: z.string().describe('MSM name as registered in mech-registry.json.'),
+        args: z
+            .array(z.string())
+            .default([])
+            .describe('Business args; each element is one argument, preserved losslessly (spaces, newlines, special chars).'),
+    },
+    execute: async (input) => {
+        log.info('msm', 'msm_exec called', {
+            msm_name: input.msm_name,
+            args: input.args,
+        });
+        await ensureReady();
+        const state = getState();
+        // 1. find msm in registry
+        const registry = loadMechRegistry();
+        const entry = findMsm(input.msm_name, registry);
+        log.info('msm', 'msm found in registry', { name: entry.name, skill: entry.skill });
+        const normalized = normalizeFlags(entry.flags);
+        try {
+            // path-arg 校验直接对 input.args（string[]）跑
+            validatePathArgsFromTokens(input.args, normalized, state.cwdRoot);
+        }
+        catch (err) {
+            log.warn('msm', 'msm_exec path-arg validation failed', { msm: entry.name, err: String(err) });
+            throw err;
+        }
+        // 2. 调 msm-exec.ts（纯执行，无协议 flag）
+        const result = await callMsmExec({
+            msm_name: input.msm_name,
+            businessArgs: input.args,
+        });
+        log.info('msm', 'msm_exec result', {
+            name: input.msm_name,
+            exitCode: result.exitCode,
+            stdoutLen: result.stdout.length,
+            stderrLen: result.stderr.length,
+        });
+        // v1.15.1 §9: 错误路径保留 stdout
+        if (result.exitCode !== 0) {
+            throw new MsmExecutionError(input.msm_name, result.exitCode, result.stdout, result.stderr);
+        }
+        return result.stdout || '(no output)';
+    },
+});
+/** 内部 register 实现（v1.17 从 msmRegisterTool 抽出） */
+async function registerMsmInner(input) {
+    log.info('msm', 'msm_admin register called', { name: input.name, path: input.path });
+    const state = getState();
+    // 1. 读 registry（含 schema 信息）
+    const file = loadRegistryFile(state.cwdRoot, state.instanceName);
+    // 2. 查重
+    if (file.entries.some((e) => e.name === input.name)) {
+        throw new MsmAlreadyRegisteredError(input.name);
+    }
+    // 3. 路径必须在 cwdRoot 内
+    const absPath = resolve(state.cwdRoot, input.path);
+    if (!isPathInside(state.cwdRoot, absPath)) {
+        throw new MsmPathEscapeError(input.name, 'path', input.path, absPath);
+    }
+    // 4. 脚本文件必须存在
+    if (!existsSync(absPath)) {
+        throw new MsmScriptNotFoundError(input.name, absPath);
+    }
+    // 5. 构造 entry
+    const usage = input.usage ?? `npx tsx ${input.path}`;
+    const newEntry = {
+        name: input.name,
+        path: input.path,
+        skill: state.instanceName,
+        category: input.category,
+        description: input.description,
+        usage,
+        flags: input.flags.map((f) => ({
+            name: f.name,
+            type: f.type,
+            ...(f.description !== undefined ? { description: f.description } : {}),
+            ...(f.required !== undefined ? { required: f.required } : {}),
+            ...(f.default !== undefined ? { default: f.default } : {}),
+        })),
+    };
+    // 6. 写回（保留 schema）
+    file.entries.push(newEntry);
+    writeRegistryFile(state.cwdRoot, state.instanceName, file);
+    log.info('msm', 'msm_admin register wrote registry', { name: input.name, absPath });
+    // 7. 自动 commit
+    const relRegistry = `.opencode/skills/${state.instanceName}/references/mech-registry.json`;
+    try {
+        gitAddAndCommit(state.cwdRoot, relRegistry, `chore(msm): register ${input.name}`);
+    }
+    catch (err) {
+        log.warn('msm', 'git commit failed (continuing)', { err: String(err) });
+    }
+    return `registered "${input.name}" at ${absPath} (commit created)`;
+}
+/** 内部 deregister 实现（v1.17 从 msmDeregisterTool 抽出） */
+async function deregisterMsmInner(input) {
+    log.info('msm', 'msm_admin deregister called', { name: input.name });
+    const state = getState();
+    const file = loadRegistryFile(state.cwdRoot, state.instanceName);
+    const idx = file.entries.findIndex((e) => e.name === input.name);
+    if (idx === -1) {
+        throw new MsmNotInRegistryError(input.name);
+    }
+    const removed = file.entries.splice(idx, 1)[0];
+    writeRegistryFile(state.cwdRoot, state.instanceName, file);
+    log.info('msm', 'msm_admin deregister wrote registry', { name: input.name, path: removed.path });
+    const relRegistry = `.opencode/skills/${state.instanceName}/references/mech-registry.json`;
+    try {
+        gitAddAndCommit(state.cwdRoot, relRegistry, `chore(msm): deregister ${input.name}`);
+    }
+    catch (err) {
+        log.warn('msm', 'git commit failed (continuing)', { err: String(err) });
+    }
+    return `deregistered "${input.name}" (was at ${removed.path}; script file NOT deleted — clean up manually if needed)`;
+}
+export const msmAdminTool = tool({
+    description: 'Register or deregister an MSM (Mech/Semi-Mech) in mech-registry.json. ' +
+        '**v1.17**: replaces the old msm_register + msm_deregister tools with a single tool + action enum. ' +
+        'Auto-commits the registry change as "chore(msm): register <name>" or "chore(msm): deregister <name>".',
+    args: {
+        action: z
+            .enum(['register', 'deregister'])
+            .describe('operation to perform: register (add MSM to registry) or deregister (remove from registry)'),
+        name: z
+            .string()
+            .min(1)
+            .describe('unique MSM name (kebab-case recommended); for both register and deregister'),
+        // register-specific (required when action=register, ignored otherwise)
+        path: z
+            .string()
+            .optional()
+            .describe('[register] script path, relative to cwd root (e.g. ".opencode/skills/home-serenity/scripts/foo.ts"). Required for register.'),
+        description: z
+            .string()
+            .optional()
+            .describe('[register] one-line description of what the MSM does. Required for register.'),
+        category: z
+            .enum(['mech', 'semi-mech'])
+            .optional()
+            .describe('[register] mech = pure TS, no LLM; semi-mech = TS + LLM decision points. Required for register.'),
+        flags: z
+            .array(z.object({
+            name: z.string(),
+            type: z.string().default('string'),
+            description: z.string().optional(),
+            required: z.boolean().optional(),
+            default: z.unknown().optional(),
+        }))
+            .optional()
+            .describe('[register] flag schema; type:"path" enables v0.1-2 path-escape guard. Defaults to [] when omitted.'),
+        usage: z
+            .string()
+            .optional()
+            .describe('[register] one-line usage hint; default = "npx tsx <path>"'),
+    },
+    execute: async (input) => {
+        await ensureReady();
+        if (input.action === 'register') {
+            if (!input.path || !input.description || !input.category) {
+                throw new Error('msm_admin: action=register requires path, description, category. ' +
+                    'deregister only needs name.');
+            }
+            return await registerMsmInner({
+                name: input.name,
+                path: input.path,
+                description: input.description,
+                category: input.category,
+                flags: input.flags ?? [],
+                usage: input.usage,
+            });
+        }
+        return await deregisterMsmInner({ name: input.name });
+    },
+});
+/* 最终 4 tool slot：bash (override) + msm_list + msm_exec + msm_admin */
+//# sourceMappingURL=msm.js.map

package/dist/msm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msm.js","sourceRoot":"","sources":["../src/msm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAuB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,qBAAqB,GAGtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,oGAAoG;AACpG,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAEpC,yCAAyC;AACzC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,YAAoB;IACxE,OAAO,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,YAAoB;IAC7D,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,YAAoB;IACpE,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,mCAAmC;QACnC,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YAC/C,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;aAC9B,CAAC;QACJ,CAAC;QACD,kDAAkD;QAClD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,MAAqB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAChE,CAAC;QACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1E,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAsB;gBACtC,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;gBACxE,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aACrF,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,yCAAyC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,4BAA4B,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,YAAoB,EAAE,IAAkB;IACzF,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW;QAC9B,CAAC,CAAC;YACE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,+BAA+B;YAChE,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;QACH,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACjB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AAED,qCAAqC;AACrC,SAAS,OAAO,CAAC,IAAY,EAAE,QAAqB;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAmB,IAAI,CAAC;IAC9C,WAAW,EACT,8FAA8F;QAC9F,iGAAiG;QACjG,mDAAmD;QACnD,qFAAqF;QACrF,qEAAqE;QACrE,iHAAiH;IACnH,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,WAAW,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,6BAA6B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,OAAO,kCAAkC,MAAM,EAAE,CAAC;QACpD,CAAC;QACD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,qBAAqB,OAAO,wBAAwB,CAAC;QAC9D,CAAC;QACD,OAAO,qBAAqB,OAAO,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzI,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAmB,IAAI,CAAC;IAC9C,WAAW,EACT,iCAAiC;QACjC,6CAA6C;QAC7C,sEAAsE;QACtE,qBAAqB,OAAO,GAAG;IACjC,IAAI,EAAE;QACJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC9E,IAAI,EAAE,CAAC;aACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,sGAAsG,CAAC;KACpH;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE;YACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QACH,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QAEzB,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,uBAAuB,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,KAA+D,CAAC,CAAC;QACzG,IAAI,CAAC;YACH,uCAAuC;YACvC,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,qCAAqC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9F,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,iCAAiC;QACjC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,IAAI;SACzB,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE;YACjC,IAAI,EAAE,KAAK,CAAC,QAAQ;YACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;YAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;SAChC,CAAC,CAAC;QACH,4BAA4B;QAC5B,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC;IACxC,CAAC;CACF,CAAC,CAAC;AAuBH,iDAAiD;AACjD,KAAK,UAAU,gBAAgB,CAAC,KAAoB;IAClD,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,2BAA2B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IAEzB,6BAA6B;IAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAEjE,QAAQ;IACR,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,qBAAqB;IACrB,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,cAAc;IACd,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,cAAc;IACd,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAc;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,YAAY;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAC,CAAC;KACJ,CAAC;IAEF,mBAAmB;IACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC3D,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,mCAAmC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpF,eAAe;IACf,MAAM,WAAW,GAAG,oBAAoB,KAAK,CAAC,YAAY,gCAAgC,CAAC;IAC3F,IAAI,CAAC;QACH,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,wBAAwB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,gCAAgC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,eAAe,KAAK,CAAC,IAAI,QAAQ,OAAO,mBAAmB,CAAC;AACrE,CAAC;AAID,qDAAqD;AACrD,KAAK,UAAU,kBAAkB,CAAC,KAAsB;IACtD,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,6BAA6B,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IAEzB,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAChD,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC3D,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,qCAAqC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjG,MAAM,WAAW,GAAG,oBAAoB,KAAK,CAAC,YAAY,gCAAgC,CAAC;IAC3F,IAAI,CAAC;QACH,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,0BAA0B,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,gCAAgC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,iBAAiB,KAAK,CAAC,IAAI,aAAa,OAAO,CAAC,IAAI,0DAA0D,CAAC;AACxH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAmB,IAAI,CAAC;IAC/C,WAAW,EACT,wEAAwE;QACxE,oGAAoG;QACpG,uGAAuG;IACzG,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC;aACN,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;aAChC,QAAQ,CAAC,2FAA2F,CAAC;QACxG,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,4EAA4E,CAAC;QACzF,uEAAuE;QACvE,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6HAA6H,CAAC;QAC1I,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8EAA8E,CAAC;QAC3F,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;aAC3B,QAAQ,EAAE;aACV,QAAQ,CAAC,iGAAiG,CAAC;QAC9G,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAChC,CAAC,CACH;aACA,QAAQ,EAAE;aACV,QAAQ,CAAC,oGAAoG,CAAC;QACjH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;KAC1E;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,WAAW,EAAE,CAAC;QACpB,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACzD,MAAM,IAAI,KAAK,CACb,mEAAmE;oBACnE,6BAA6B,CAC9B,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,gBAAgB,CAAC;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;gBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,kBAAkB,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC,CAAC;AAEH,sEAAsE"}

package/dist/session/lib.d.ts

@@ -0,0 +1,33 @@
+/**
+ * session/lib.ts — 会话管理核心逻辑
+ *
+ * 供 session-tool.ts 消费，实现会话 CRUD + 健康检查 + 归档。
+ */
+/** list 子命令 */
+export declare function listSessions(sessionsDir: string): string;
+/** show 子命令 */
+export declare function showSession(sessionsDir: string, name: string): string;
+/** create 子命令 */
+export interface CreateSessionOptions {
+    sessionsDir: string;
+    root: string;
+    desc: string;
+    type: 'item' | 'project';
+    goal?: string;
+    dryRun: boolean;
+}
+export declare function createSession(opts: CreateSessionOptions): string;
+/** health 子命令 */
+export declare function healthCheck(sessionsDir: string): string;
+/** archive 子命令 */
+export interface ArchiveOptions {
+    sessionsDir: string;
+    name?: string;
+    dryRun: boolean;
+}
+export declare function archiveSessions(opts: ArchiveOptions): string;
+/** summary 子命令 */
+export declare function sessionSummary(sessionsDir: string): string;
+/** 事实核对：检查 SESSION.md 声明与实际情况的一致性 */
+export declare function qaSession(sessionsDir: string, name: string): string;
+//# sourceMappingURL=lib.d.ts.map

package/dist/session/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/session/lib.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsHH,eAAe;AACf,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAcxD;AAED,eAAe;AACf,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAarE;AAED,iBAAiB;AACjB,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAmEhE;AAED,iBAAiB;AACjB,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAkDvD;AAED,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA6D5D;AAED,kBAAkB;AAClB,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAqC1D;AAUD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA2MnE"}