@siming-org/opencode-plugin 0.1.13 → 0.1.16

package/dist/todo/config.js

@@ -0,0 +1,272 @@
+/**
+ * todoNudge 配置模型与热生效（技术方案 §4.1/§4.2，T202610260002）。
+ *
+ * 配置键：工作区 <ws>/.siming/config.json（严格 JSON）与全局 ~/.siming/config.json（jsonc 宽容）
+ * 新增可选键 `todoNudge: { enabled, every, text }`；既有键（serverUrl/defaultProject）互不影响。
+ *
+ * 语义要点（PRD 规则 4/17，F-1 读取路径约束）：
+ * - 合并按字段级「最具体提供层」：工作区（就近命中的那份文件）→ 全局 → 内置默认；
+ *   某层提供了该字段但值非法 → 取内置默认并告警（不继承下一层——错误不跨层传染）；
+ * - 读取不得复用 readWorkspaceConfig/tryLoadJsonc（两者把「损坏」折叠成 null=缺席）：
+ *   本模块自建读取路径 existsSync → 读取 → 解析，解析失败即 corrupt；
+ * - corrupt：任一层文件存在但不可读/解析失败 → snapshot()=null（enabled 视同 false），
+ *   不回退其他层也不回退默认；下一次配置变更事件重读成功即恢复；
+ * - 热生效：fs.watch 监听集合由定位算法驱动（walkTodoConfigPath），150ms 防抖重读，
+ *   重读即重新定位；watcher 失败降级为冻结快照 + healthy()=false（变更需重启生效）。
+ *
+ * per-location 实例（T202610220003）：每次 createTodoNudgeConfig 各自持有快照与 watcher，
+ * 无模块级状态；多 location 重复监听全局层为已接受的代价（§4.8）。
+ */
+import { existsSync, readFileSync, watch } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { parse as parseJsonc } from 'jsonc-parser';
+import { walkTodoConfigPath } from '../fetch-assets.js';
+import { DEFAULT_NUDGE_TEXT } from './prompt.js';
+import { createRateLimiter } from './rate-limit.js';
+/** 内置默认（PRD 规则 2/8.3 逐字） */
+const DEFAULTS = { enabled: true, every: 6, text: DEFAULT_NUDGE_TEXT };
+const DEBOUNCE_MS = 150;
+/** 工作区层读取：严格 JSON（对齐 CLI 工作区配置读取惯例）；不可读/解析失败/非对象即 corrupt
+ *  （与全局层同口径：文件存在但不是可用配置对象 = 损坏，不是「未提供」） */
+function readWorkspaceLayer(file) {
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return { values: null, corrupt: true };
+        }
+        return { values: parsed, corrupt: false };
+    }
+    catch {
+        return { values: null, corrupt: true };
+    }
+}
+/** 全局层读取：jsonc 宽容（注释/尾逗号容忍）；解析结果非对象、或扫描器报 error 即 corrupt。
+ *  F-CFG-01：jsonc-parser parse 是容错扫描器——内容损坏（如 `{ not-json`）不抛错而是返回
+ *  折叠结果（undefined/{}/残留对象），仅判返回值会把「损坏」视同合法空配置。必须收集 errors
+ *  并以「errors 非空」为损坏信号（PRD 规则 17/验收 7：损坏按关闭）。
+ *  allowTrailingComma 必须显式 true：ParseOptions.DEFAULT.allowTrailingComma=false，尾逗号
+ *  默认产生 error——不开启会把合法尾逗号样本误判 corrupt（注释保持默认宽容：
+ *  disallowComments 默认 false，不写 error）。 */
+function readGlobalLayer(file) {
+    try {
+        const errors = [];
+        const parsed = parseJsonc(readFileSync(file, 'utf8'), errors, { allowTrailingComma: true });
+        if (errors.length > 0 || typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return { values: null, corrupt: true };
+        }
+        return { values: parsed, corrupt: false };
+    }
+    catch {
+        return { values: null, corrupt: true };
+    }
+}
+function todoNudgeOf(values, file, allowAlert) {
+    if (values === null)
+        return { values: null, file };
+    const raw = values['todoNudge'];
+    if (raw === undefined)
+        return { values: null, file };
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        if (allowAlert(`todoNudge-shape:${file}`)) {
+            console.error(`[siming-plugin] ${file} 的 todoNudge 不是对象（忽略该层的 todoNudge，其余键不受影响）`);
+        }
+        return { values: null, file };
+    }
+    return { values: raw, file };
+}
+/** 字段级合并：最具体提供层优先；值非法取内置默认并告警（不继承下一层，PRD 规则 17） */
+function mergeLayers(workspace, global, allowAlert) {
+    const pick = (field, isValid, fallback) => {
+        for (const layer of [workspace, global]) {
+            const raw = layer.values?.[field];
+            if (raw === undefined)
+                continue;
+            if (isValid(raw))
+                return raw;
+            if (allowAlert(`field:${layer.file}:${field}`)) {
+                console.error(`[siming-plugin] ${layer.file} 的 todoNudge.${field} 非法（${JSON.stringify(raw)}），该字段回退内置默认`);
+            }
+            return fallback;
+        }
+        return fallback;
+    };
+    const enabled = pick('enabled', (v) => typeof v === 'boolean', DEFAULTS.enabled);
+    const every = pick('every', (v) => typeof v === 'number' && Number.isInteger(v) && v >= 1, DEFAULTS.every);
+    const text = pick('text', (v) => typeof v === 'string', DEFAULTS.text);
+    // text 合法但空/纯白 → 默认文案（合法配置，不告警，PRD 规则 6）
+    const effectiveText = text.trim().length > 0 ? text : DEFAULTS.text;
+    return { enabled, every, text: effectiveText };
+}
+function describeSnapshot(snap) {
+    return snap === null ? '<corrupt 按关闭>' : JSON.stringify(snap);
+}
+/**
+ * 创建配置实例：同步完成首次读取（启动即建快照）与监听挂载；失败不抛——
+ * corrupt 态/降级态在返回对象内表达（§6 契约表）。
+ */
+export function createTodoNudgeConfig(directory) {
+    const allowAlert = createRateLimiter(60_000);
+    // 全局层路径在实例创建时冻结：homedir() 读的是进程环境（HOME 可被中途改写——测试 fixture、
+    // 宿主环境异常），每次重读现取会把「别的时刻的家目录」读进本实例，跨实例互相污染快照，
+    // 违反 per-location 隔离（T202610220003：本文件头注声明各实例独立持有快照与监听）。
+    // 冻结后各实例全局层恒定指向创建时刻的家目录；生产 HOME 恒定，行为不变。
+    // 已知残留：工作区层遍历（walkTodoConfigPath/isHomeDir 的「遇 $HOME 即止」边界）仍每次现取
+    // homedir()——生产 HOME 恒定等价无影响；如需全链冻结，后续把 home 边界作为参数传入。
+    const homeDirAtCreate = homedir();
+    const globalSimingDir = join(homeDirAtCreate, '.siming');
+    const globalConfigFile = join(globalSimingDir, 'config.json');
+    let snapshot = null;
+    let watchers = [];
+    let watchTargetsKey = '';
+    let healthy = true;
+    let disposed = false;
+    let timer = null;
+    const changeCallbacks = [];
+    let booted = false; // 初读建快照为静默路径（不日志、不通知）——null 初始值不构成「变更」
+    const degrade = (reason) => {
+        if (!healthy)
+            return;
+        healthy = false;
+        for (const w of watchers) {
+            try {
+                w.close();
+            }
+            catch {
+                // 关闭失败即弃——watcher 随进程回收
+            }
+        }
+        watchers = [];
+        if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+        }
+        console.error(`[siming-plugin] todoNudge 配置热重载不可用（${reason}）——变更需重启宿主生效（当前快照冻结）`);
+    };
+    /** 防抖：末次事件后 150ms 合并重读（编辑器原子替换连发 rename/change） */
+    const scheduleReread = () => {
+        if (!healthy || disposed)
+            return;
+        if (timer !== null)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = null;
+            if (healthy && !disposed)
+                reread();
+        }, DEBOUNCE_MS);
+    };
+    const attach = (dir, onlySiming) => {
+        let w;
+        try {
+            w = watch(dir, { recursive: false }, (_eventType, filename) => {
+                // 缺口目录/家目录监听只关心 `.siming` 的出现（否则目录内高频活动会反复触发重读）
+                if (onlySiming && filename !== '.siming')
+                    return;
+                scheduleReread();
+            });
+        }
+        catch (err) {
+            degrade(String(err));
+            return;
+        }
+        w.on('error', (err) => degrade(String(err)));
+        watchers.push(w);
+    };
+    /** 监听集合随定位结果重建（§4.2：集合①全部 .siming 目录 + 集合②缺口目录 + 全局层） */
+    const rebuildWatchers = (simingDirs, gapDir) => {
+        if (!healthy || disposed)
+            return;
+        const targets = [
+            ...simingDirs.map((dir) => ({ dir, onlySiming: false })),
+            ...(gapDir !== null ? [{ dir: gapDir, onlySiming: true }] : []),
+            // 全局层：~/.siming 存在直接监听；不存在监听家目录等 .siming 出现（出现即重读升级）
+            existsSync(globalSimingDir)
+                ? { dir: globalSimingDir, onlySiming: false }
+                : { dir: homeDirAtCreate, onlySiming: true },
+        ];
+        const key = targets.map((t) => `${t.onlySiming ? '!' : '='}${t.dir}`).sort().join('|');
+        if (key === watchTargetsKey)
+            return; // 集合未变不重建（避免每次配置编辑重建 watcher）
+        for (const w of watchers) {
+            try {
+                w.close();
+            }
+            catch {
+                // 同上
+            }
+        }
+        watchers = [];
+        watchTargetsKey = key;
+        for (const t of targets) {
+            if (!healthy)
+                return; // attach 失败已走 degrade
+            attach(t.dir, t.onlySiming);
+        }
+        // 补读：watcher 建立后 macOS FSEvents 存在激活窗口，窗口内的文件变更不产生事件——
+        // 补一次防抖重读兜底（启动/拓扑变化后紧跟的配置编辑不丢；稳态无事件则读后无变化，零副作用）
+        scheduleReread();
+    };
+    const reread = () => {
+        // corrupt 判定与字段级合并（读取顺序无关，两层独立）
+        const walk = walkTodoConfigPath(directory);
+        const wsLayer = walk.hit === null ? { values: null, corrupt: false } : readWorkspaceLayer(walk.hit.path);
+        const glLayer = existsSync(globalConfigFile) ? readGlobalLayer(globalConfigFile) : { values: null, corrupt: false };
+        let next;
+        if (wsLayer.corrupt || glLayer.corrupt) {
+            const which = [wsLayer.corrupt ? walk.hit?.path : null, glLayer.corrupt ? globalConfigFile : null]
+                .filter((p) => p !== null && p !== undefined)
+                .join('、');
+            if (allowAlert(`corrupt:${which}`)) {
+                console.error(`[siming-plugin] todoNudge 配置文件损坏（${which}）——提醒按关闭处理，不回退其他层；修复后自动恢复`);
+            }
+            next = null;
+        }
+        else {
+            next = mergeLayers(todoNudgeOf(wsLayer.values, walk.hit?.path ?? '<无工作区层>', allowAlert), todoNudgeOf(glLayer.values, globalConfigFile, allowAlert), allowAlert);
+        }
+        if (!booted) {
+            // 初读建快照：静默（此前 null → 首个快照被误判为变更，会在启动时打一行假「配置已更新」并触发空通知）
+            snapshot = next;
+            booted = true;
+        }
+        else if (describeSnapshot(next) !== describeSnapshot(snapshot)) {
+            // 生效值变化一行日志（前→后，配置变更排障用，非提醒日志）
+            console.log(`[siming-plugin] todoNudge 配置已更新：${describeSnapshot(snapshot)} → ${describeSnapshot(next)}`);
+            snapshot = next;
+            for (const cb of changeCallbacks) {
+                try {
+                    cb(next);
+                }
+                catch (err) {
+                    console.error(`[siming-plugin] todoNudge onChange 回调异常（忽略）：${String(err)}`);
+                }
+            }
+        }
+        rebuildWatchers(walk.simingDirs, walk.gapDir);
+    };
+    reread(); // 启动首次读取（静默建立初始快照，不触发 onChange）
+    return {
+        snapshot: () => snapshot,
+        healthy: () => healthy,
+        onChange(cb) {
+            changeCallbacks.push(cb);
+        },
+        dispose() {
+            disposed = true;
+            if (timer !== null) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            for (const w of watchers) {
+                try {
+                    w.close();
+                }
+                catch {
+                    // 同上
+                }
+            }
+            watchers = [];
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/todo/config.js.map

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

package/dist/todo/counter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * todo 提醒计数器（技术方案 §4.4）：
+ * - per-session 自增计数（1-based），命中判定 n % every === 0（由调用方执行）；
+ * - 跨轮累计不重置；enabled=false 期间调用方不调用 next（关闭不计数）；
+ * - 重开从 0：配置快照 disabled/corrupt→enabled 跃迁时调用方调 resetAll() 清空全部会话计数；
+ * - 防膨胀：新会话键数超 4096（异常量级的长寿进程）整体清空 + 一行日志（计数归零，语义同重启）。
+ * Map 实例态随 location 工厂创建，无模块级状态（T202610220003）。
+ */
+export interface NudgeCounter {
+    next(sessionID: string): number;
+    resetAll(): void;
+}
+export declare function createNudgeCounter(): NudgeCounter;
+//# sourceMappingURL=counter.d.ts.map

package/dist/todo/counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../src/todo/counter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,IAAI,IAAI,CAAC;CAClB;AAID,wBAAgB,kBAAkB,IAAI,YAAY,CAgBjD"}

package/dist/todo/counter.js

@@ -0,0 +1,19 @@
+const SESSION_CAP = 4096;
+export function createNudgeCounter() {
+    const counts = new Map();
+    return {
+        next(sessionID) {
+            if (!counts.has(sessionID) && counts.size >= SESSION_CAP) {
+                counts.clear();
+                console.error(`[siming-plugin] todo 提醒计数会话数超 ${String(SESSION_CAP)}，计数整体重置（语义同重启）`);
+            }
+            const n = (counts.get(sessionID) ?? 0) + 1;
+            counts.set(sessionID, n);
+            return n;
+        },
+        resetAll() {
+            counts.clear();
+        },
+    };
+}
+//# sourceMappingURL=counter.js.map

package/dist/todo/counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.js","sourceRoot":"","sources":["../../src/todo/counter.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,OAAO;QACL,IAAI,CAAC,SAAiB;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;gBACzD,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,iCAAiC,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;YACtF,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACzB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,QAAQ;YACN,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/todo/nudge-log.d.ts

@@ -0,0 +1,5 @@
+export interface NudgeLogger {
+    hit(sessionID: string, count: number, every: number, messageCount: number): void;
+}
+export declare function createNudgeLogger(referencesRoot: string): NudgeLogger;
+//# sourceMappingURL=nudge-log.d.ts.map

package/dist/todo/nudge-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge-log.d.ts","sourceRoot":"","sources":["../../src/todo/nudge-log.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAClF;AAID,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,WAAW,CA6BrE"}

package/dist/todo/nudge-log.js

@@ -0,0 +1,45 @@
+/**
+ * todo 提醒命中日志（技术方案 §4.5）：
+ * - 文件 <referencesRoot>/todo-nudge.log，行格式 `<ISO> hit session=<sid> count=<n>/<N> messages=<len>`
+ *   （PRD 规则 10 四要素：时间/会话标识/累计次数/消息数）；
+ * - 性质：运行日志而非技能/子代理资产——不属于「资产不落盘」承诺范围，可手删；
+ *   技能缓存对账只清理 referencesRoot/skills/ 子目录，不会误删根级日志；
+ * - 只在命中时写（未命中/关闭不写）；轮转 1MB → .1 保留一代（写入前 statSync 判定）；
+ * - 写失败（磁盘满/根不可写）console.error 限频（同类 60s 一条），不影响注入。
+ * referencesRoot 由 setup 定格传入（referencesRootOf 语义：工作区 .siming/temp/ 或 tmpdir 兜底），
+ * 可能尚未被 references 物化创建——写入前防御性 mkdir。
+ */
+import { appendFileSync, existsSync, mkdirSync, renameSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { createRateLimiter } from './rate-limit.js';
+const ROTATE_BYTES = 1_048_576; // 1MB
+export function createNudgeLogger(referencesRoot) {
+    const file = join(referencesRoot, 'todo-nudge.log');
+    const allowLog = createRateLimiter(60_000);
+    return {
+        hit(sessionID, count, every, messageCount) {
+            try {
+                mkdirSync(referencesRoot, { recursive: true });
+                // 轮转：超 1MB → .1（rename 覆盖旧 .1，保留一代）
+                if (existsSync(file)) {
+                    try {
+                        if (statSync(file).size > ROTATE_BYTES)
+                            renameSync(file, `${file}.1`);
+                    }
+                    catch (err) {
+                        if (allowLog(`rotate:${String(err)}`)) {
+                            console.error(`[siming-plugin] todo 提醒日志轮转失败（忽略，继续写入）：${String(err)}`);
+                        }
+                    }
+                }
+                appendFileSync(file, `${new Date().toISOString()} hit session=${sessionID} count=${String(count)}/${String(every)} messages=${String(messageCount)}\n`, 'utf8');
+            }
+            catch (err) {
+                if (allowLog(String(err))) {
+                    console.error(`[siming-plugin] todo 提醒日志写入失败（不影响注入）：${String(err)}`);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=nudge-log.js.map

package/dist/todo/nudge-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nudge-log.js","sourceRoot":"","sources":["../../src/todo/nudge-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMpD,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,MAAM;AAEtC,MAAM,UAAU,iBAAiB,CAAC,cAAsB;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,GAAG,CAAC,SAAiB,EAAE,KAAa,EAAE,KAAa,EAAE,YAAoB;YACvE,IAAI,CAAC;gBACH,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,oCAAoC;gBACpC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrB,IAAI,CAAC;wBACH,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,YAAY;4BAAE,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;oBACxE,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,IAAI,QAAQ,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;4BACtC,OAAO,CAAC,KAAK,CAAC,0CAA0C,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;wBACzE,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,cAAc,CACZ,IAAI,EACJ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,gBAAgB,SAAS,UAAU,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,YAAY,CAAC,IAAI,EACjI,MAAM,CACP,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBAC1B,OAAO,CAAC,KAAK,CAAC,wCAAwC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/todo/prompt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * todo 三件套内置常量（技术方案 §4.7）：
+ * - TODO_SYSTEM_PROMPT：注入主会话 system 的常驻短规则（PRD §8.1 逐字，含标题行）；
+ * - DEFAULT_NUDGE_TEXT：尾部注入的默认提醒文案（PRD §8.3 逐字，含「非用户输入」标识）。
+ * 常量只承载 todo 规则本身，不提及 todoNudge 配置（PRD 规则 14 尾款）。
+ */
+export declare const TODO_SYSTEM_PROMPT = "## \u4EFB\u52A1\u6E05\u5355\uFF08todos\uFF09\n\n\u76F8\u5BF9\u590D\u6742\u7684\u4EFB\u52A1\uFF08\u9884\u8BA1 3 \u6B65\u4EE5\u4E0A\u3001\u6D89\u53CA\u591A\u4E2A\u6587\u4EF6\u6216\u547D\u4EE4\u3001\u6709\u5148\u540E\u4F9D\u8D56\uFF09\u5FC5\u987B\u5148\u7528 todowrite \u5EFA\u6E05\u5355\uFF1B\u5355\u6B65\u4EFB\u52A1\u3001\u7EAF\u95EE\u7B54\u4E0D\u5EFA\u3002\n\n- \u62C6\u5206\uFF1A\u600E\u4E48\u62C6\u7531\u4F60\u6309\u4EFB\u52A1\u5B9E\u9645\u5185\u5BB9\u51B3\u5B9A\uFF1B\u4E00\u6761\u5BF9\u5E94\u4E00\u4E2A\u80FD\u72EC\u7ACB\u63A8\u8FDB\u3001\u80FD\u770B\u51FA\u662F\u5426\u5B8C\u6210\u7684\u6B65\u9AA4\u3002\u7C92\u5EA6\u8981\u5408\u9002\uFF0C\u4E0D\u80FD\u7C97\u5230\u300C\u6574\u4E2A\u529F\u80FD\u300D\u6216\u300C\u6574\u4E2A DAG \u8282\u70B9\u300D\u4E00\u6761\u3002\n- siming \u6D41\u7A0B\u4EFB\u52A1\uFF1A\u53EA\u62C6\u5F53\u524D DAG \u8282\u70B9\u5185\u90E8\u7684\u6B65\u9AA4\uFF0C\u6700\u5C11 3 \u9879\u3001\u4E0D\u8BBE\u4E0A\u9650\uFF08\u6309\u8282\u70B9\u5B9E\u9645\u590D\u6742\u5EA6\u8BC4\u4F30\uFF0C\u8BE5\u591A\u5C11\u5C31\u591A\u5C11\uFF09\uFF1B\u4E0D\u8981\u628A\u591A\u4E2A\u8282\u70B9\u5408\u5E76\u8FDB\u540C\u4E00\u5F20\u6E05\u5355\u3002\n- \u72B6\u6001\uFF1A\u5F00\u59CB\u505A\u65F6\u6807 in_progress\uFF0C\u9636\u6BB5\u6027\u5B8C\u6210\u540E\u6807 completed\uFF1B\u66F4\u65B0\u4FDD\u6301\u76F8\u5BF9\u53CA\u65F6\u3002\n- \u63A8\u8FDB\uFF1A\u4E32\u884C\u3001\u5E76\u884C\u3001\u8DF3\u7740\u505A\u90FD\u7531\u4F60\u51B3\u5B9A\uFF0C\u4E0D\u8981\u6C42\u6309\u6E05\u5355\u987A\u5E8F\u63A8\u8FDB\uFF1B\u540C\u65F6\u5728\u8FDB\u884C\u7684\u6761\u76EE\u6570\u91CF\u4E0D\u505A\u9650\u5236\u3002\n- \u7EF4\u62A4\uFF1A\u53D1\u73B0\u65B0\u6B65\u9AA4\u968F\u65F6\u8FFD\u52A0\uFF1B\u653E\u5F03\u7684\u9879\u6807 cancelled \u5E76\u5199\u539F\u56E0\uFF1B\u65E7\u6E05\u5355\u5B8C\u6210\u3001\u5207\u6362\u4EFB\u52A1\u6216\u5207\u6362\u8282\u70B9\u65F6\u6574\u5F20\u66FF\u6362\uFF0C\u4E0D\u590D\u7528\u65E7\u6761\u76EE\u3002\n- \u6536\u5C3E\uFF1A\u7ED9\u6700\u7EC8\u7B54\u590D\u524D\u987A\u624B\u6838\u5BF9\u6E05\u5355\uFF0C\u72B6\u6001\u4E0E\u5B9E\u9645\u8FDB\u5EA6\u4E00\u81F4\u5373\u53EF\uFF0C\u4E0D\u5FC5\u4E3A\u4E86\u6E05\u96F6\u800C\u6539\u72B6\u6001\u3002";
+export declare const DEFAULT_NUDGE_TEXT = "[todo-nudge \u81EA\u52A8\u63D0\u9192\uFF0C\u975E\u7528\u6237\u8F93\u5165] \u590D\u6742\u4EFB\u52A1\u5EFA\u8BAE\u7528 todos \u8DDF\u8E2A\uFF1B\u5B50\u9879\u5B8C\u6210\u540E\u987A\u624B\u66F4\u65B0\u72B6\u6001\u3002";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/todo/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/todo/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,kBAAkB,wnEASW,CAAC;AAE3C,eAAO,MAAM,kBAAkB,0NAA0D,CAAC"}

package/dist/todo/prompt.js

@@ -0,0 +1,18 @@
+/**
+ * todo 三件套内置常量（技术方案 §4.7）：
+ * - TODO_SYSTEM_PROMPT：注入主会话 system 的常驻短规则（PRD §8.1 逐字，含标题行）；
+ * - DEFAULT_NUDGE_TEXT：尾部注入的默认提醒文案（PRD §8.3 逐字，含「非用户输入」标识）。
+ * 常量只承载 todo 规则本身，不提及 todoNudge 配置（PRD 规则 14 尾款）。
+ */
+export const TODO_SYSTEM_PROMPT = `## 任务清单（todos）
+
+相对复杂的任务（预计 3 步以上、涉及多个文件或命令、有先后依赖）必须先用 todowrite 建清单；单步任务、纯问答不建。
+
+- 拆分：怎么拆由你按任务实际内容决定；一条对应一个能独立推进、能看出是否完成的步骤。粒度要合适，不能粗到「整个功能」或「整个 DAG 节点」一条。
+- siming 流程任务：只拆当前 DAG 节点内部的步骤，最少 3 项、不设上限（按节点实际复杂度评估，该多少就多少）；不要把多个节点合并进同一张清单。
+- 状态：开始做时标 in_progress，阶段性完成后标 completed；更新保持相对及时。
+- 推进：串行、并行、跳着做都由你决定，不要求按清单顺序推进；同时在进行的条目数量不做限制。
+- 维护：发现新步骤随时追加；放弃的项标 cancelled 并写原因；旧清单完成、切换任务或切换节点时整张替换，不复用旧条目。
+- 收尾：给最终答复前顺手核对清单，状态与实际进度一致即可，不必为了清零而改状态。`;
+export const DEFAULT_NUDGE_TEXT = '[todo-nudge 自动提醒，非用户输入] 复杂任务建议用 todos 跟踪；子项完成后顺手更新状态。';
+//# sourceMappingURL=prompt.js.map

package/dist/todo/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/todo/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;0CASQ,CAAC;AAE3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,uDAAuD,CAAC"}

package/dist/todo/rate-limit.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 同类事件限频闸（todo 套件内部共用）：
+ * 配置告警、handler 异常、日志写失败均要求「同类 60s 一条」（技术方案 §4.1/§4.3/§4.5），
+ * 避免每请求级错误刷屏宿主日志。返回 true = 本次应输出。
+ */
+export declare function createRateLimiter(intervalMs: number): (key: string) => boolean;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/todo/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/todo/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAW9E"}

package/dist/todo/rate-limit.js

@@ -0,0 +1,20 @@
+/**
+ * 同类事件限频闸（todo 套件内部共用）：
+ * 配置告警、handler 异常、日志写失败均要求「同类 60s 一条」（技术方案 §4.1/§4.3/§4.5），
+ * 避免每请求级错误刷屏宿主日志。返回 true = 本次应输出。
+ */
+export function createRateLimiter(intervalMs) {
+    const lastAt = new Map();
+    return (key) => {
+        const now = Date.now();
+        const prev = lastAt.get(key);
+        if (prev !== undefined && now - prev < intervalMs)
+            return false;
+        // 防膨胀：键数异常量级时整体重置（限频窗口短，重置代价可忽略）
+        if (lastAt.size >= 256)
+            lastAt.clear();
+        lastAt.set(key, now);
+        return true;
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/todo/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/todo/rate-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,OAAO,CAAC,GAAW,EAAW,EAAE;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,GAAG,IAAI,GAAG,UAAU;YAAE,OAAO,KAAK,CAAC;QAChE,iCAAiC;QACjC,IAAI,MAAM,CAAC,IAAI,IAAI,GAAG;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/todo/task-planning-skill.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `task-planning` 技能内置常量（技术方案 §4.7，PRD §8.2 逐字）：
+ * 形态镜像 guide-skill.ts——path 为合成展示路径（宿主消费内嵌 content，不落盘读取），
+ * 与 references 物化根同源。随插件版本发布，不做运行时拉取。
+ */
+import type { HostSkillInfo } from '../host-api.js';
+export declare const TASK_PLANNING_SKILL_NAME = "task-planning";
+export declare function taskPlanningSkillInfo(referencesRoot: string): HostSkillInfo;
+//# sourceMappingURL=task-planning-skill.d.ts.map

package/dist/todo/task-planning-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-planning-skill.d.ts","sourceRoot":"","sources":["../../src/todo/task-planning-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAS3E"}

package/dist/todo/task-planning-skill.js

@@ -0,0 +1,58 @@
+import { skillDisplayPath } from '../host-api.js';
+export const TASK_PLANNING_SKILL_NAME = 'task-planning';
+export function taskPlanningSkillInfo(referencesRoot) {
+    return {
+        id: TASK_PLANNING_SKILL_NAME,
+        name: TASK_PLANNING_SKILL_NAME,
+        description: '多步骤任务开始前建立并维护 todo 清单；执行中相对及时地更新状态，任务边界变化时整张替换。用于 3 步以上、多文件多命令、有先后依赖或用户要求先规划再执行的任务。',
+        path: skillDisplayPath(referencesRoot, TASK_PLANNING_SKILL_NAME),
+        content: TASK_PLANNING_CONTENT,
+    };
+}
+const TASK_PLANNING_CONTENT = `# task-planning
+
+## 何时使用
+
+- 任务预计 3 步以上，或涉及多个文件、多个命令、有先后依赖；
+- 用户要求「先规划再执行」；
+- 长任务执行中需要让进度对用户可见。
+
+单步任务、纯问答不建清单。
+
+## 建清单
+
+1. 先拆步骤再动手：每条写清要做什么、做到什么程度，便于判断是否完成。
+2. 怎么拆由你决定：一条对应一个能独立推进的步骤；粒度要合适，不要粗到「整个功能」或「整个 DAG 节点」一条。
+3. siming 流程任务：只拆**当前 DAG 节点内部**的步骤，最少 3 项、不设上限，由你按节点实际复杂度评估。
+   - 不要把整个节点写成一条（如「完成技术方案」）；
+   - 不要把多个节点合并进同一张清单；
+   - 节点切换时整张替换清单，旧节点条目退场。
+4. 首次用 todowrite 提交完整清单；后续随进展更新即可。
+
+## 维护节奏
+
+- 开始做时标 in_progress，阶段性完成后标 completed；更新保持相对及时。
+- 推进顺序（串行、并行、跳着做）由你决定；同时在进行的条目数量不做限制。
+- 执行中发现新步骤 → 追加；原步骤不再需要 → 标 cancelled 并写原因。
+- 已完成项可以保留作为进度记录，不必为了整洁删除。
+
+## 边界与切换
+
+- 旧任务结束或节点切换 → 整张替换，不复用旧条目。
+- 同一会话开始新任务 → 新建清单。
+- 子代理有自己的清单，不继承主会话清单。
+
+## 收尾检查
+
+给最终答复前顺手核对清单：
+
+- 状态与实际进度一致即可；没做完的项标 cancelled 或说明后续处理；
+- 未验证的步骤不要标 completed；
+- 不需要为了「清零」而改状态。
+
+## 常见问题
+
+- 只在开头建一次清单，之后不再更新；
+- 整个功能或整个节点一条 todo（粒度太粗，看不出进度）；
+- 旧清单完成后不复位，新任务沿用旧列表。`;
+//# sourceMappingURL=task-planning-skill.js.map

package/dist/todo/task-planning-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-planning-skill.js","sourceRoot":"","sources":["../../src/todo/task-planning-skill.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,MAAM,UAAU,qBAAqB,CAAC,cAAsB;IAC1D,OAAO;QACL,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,qFAAqF;QACvF,IAAI,EAAE,gBAAgB,CAAC,cAAc,EAAE,wBAAwB,CAAC;QAChE,OAAO,EAAE,qBAAqB;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBA6CR,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siming-org/opencode-plugin",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "opencode v2 plugin for siming: registers MCP task tools (siming_*), onboarding guide skill, siming_cli/siming_refresh tools, and global+project skills/subagents pulled live from the siming server",
   "type": "module",
   "keywords": [
@@ -15,7 +15,7 @@
   "dependencies": {
     "jsonc-parser": "^3.3.1",
     "zod": "^4.4.3",
-    "@siming-org/cli": "0.8.15"
+    "@siming-org/cli": "0.8.17"
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.18.35",