@deepwhale/coding-agent 1.0.12 → 1.0.13

package/dist/repl/repl-command-router.js

@@ -0,0 +1,112 @@
+/**
+ * REPL slash builtin command router — Sprint 1c-revive-3-D-29.1.3 (2026-06-07).
+ *
+ * 历史:
+ *   Sprint 0.3: REPL 接 /help / /exit / exit / quit 4 个内建命令, 派发写在
+ *     rl.on('line') 闭包内 (原 repl.ts L434-481). 后续 D-11 加 /verify (走
+ *     runVerify + 写 verification event 到 session), D-19 加 confirm 期间 /exit
+ *     dismiss-then-pendingExit 顺序红线, D-19.6.1 加 slash builtin guard
+ *     (turnInFlight 时除 /exit /quit 外 deny 其它 slash builtin).
+ *   D-29.1.3 (2026-06-07): 抽到独立文件, 跟 repl-confirm.ts / repl-signal-coordinator.ts
+ *     / repl-session.ts 工厂形态对齐.
+ *
+ * 拍板 (D-29.1.3):
+ *   - 入口: dispatchSlashBuiltin(line, ctx) → { handled: boolean }
+ *   - 闭包内不持 state, 所有副作用 (out / err / writer / prompt) 通过 ctx 注入
+ *     (跟 D-29.1.1 signal-coordinator 抽法 1:1 一致, 单测 mock ctx 即可).
+ *   - 派发顺序保 1:1 (跟原 rl.on('line') L434-481): /help → /verify → /unknown slash.
+ *   - 行为 1:1 等价, 5 红线 0 改: turnInFlight/lineQueue state machine 仍在 repl.ts
+ *     (slash guard L409-418 + chat path L490+), router 只搬 dispatch 闭包.
+ *   - 公共 API 0 改: 5 caller (src/index.ts, modes/print.ts, modes/tui.ts,
+ *     test/repl/*, test/unit/repl-verify.test.ts) 全部走 '../repl.js' 公共 re-export
+ *     路径, 0 改 import.
+ *   - 0 加新依赖, runVerify / buildSummaryAndNext / formatReport / appendVerificationEvent
+ *     走 ctx 注入 (test mock 用, prod 走 ./verify/index.js 真实 export).
+ *
+ * 拍板 (D-29.1.3 §out of scope):
+ *   - 不接 turnInFlight guard — 那在 repl.ts L409-418, 跟 6afccc8 / D-19.5p 拍板
+ *     "deny 非 /exit /quit slash builtin" 红线绑定, 不在本 router scope.
+ *   - 不接 lineQueue defer — D-19.5 P1 "只排 chat line, 不排 slash builtin", 跟 router
+ *     "handled: boolean" 二态返值绑定, 调用方决定 defer / deny / handle.
+ *   - 不接 confirm 期间 /exit dismiss — D-19.5 P2-dismiss, 在 repl.ts L370-373
+ *     confirm path, 不在本 router scope.
+ */
+import { t } from '@deepwhale/core';
+import { appendVerificationEvent } from '../agent/index.js';
+import { runVerify, buildSummaryAndNext, formatReport } from '../verify/index.js';
+/**
+ * Dispatch a slash builtin command (/help, /verify, unknown slash).
+ *
+ * Returns `handled: true` if the line was a recognized slash builtin and was
+ * processed. Returns `handled: false` if the line should fall through to the
+ * chat / lineQueue path.
+ *
+ * Order (跟原 repl.ts L434-481 1:1 保):
+ *   1. /help   → out.write(i18n cli.builtin_help) + prompt + return
+ *   2. /verify → runVerify → formatReport → out.write → if (writer)
+ *                appendVerificationEvent + try/catch wrap (1ceef94 红线)
+ *   3. /unknown slash (line.startsWith('/') 但不命中 /help /verify)
+ *                → out.write(i18n cli.builtin_unknown) + prompt + return
+ *
+ * 5 红线 0 改 (跟 ship-quality-checks §7a + D-19/19.5/19.5p/6afccc8/1ceef94 一致):
+ *   - /verify try/finally + appendVerificationEvent (1ceef94): 修法不在 try/finally,
+ *     而在 try/catch — verify 失败 (e.g. 命令不存在) 不污染 session, 走 stderr i18n
+ *     提示 + prompt 继续. appendVerificationEvent 仅 status='passed' 或 'failed' 时
+ *     写, 不在 catch 块里 (跟 D-11-4 拍板一致).
+ *   - turnInFlight guard (D-19.6.1 + 6afccc8): 不在本 router, 调用方 repl.ts L409-418
+ *     决定是否调 dispatchSlashBuiltin.
+ *   - confirm 期间 /exit dismiss (D-19.5 P2-dismiss): 不在本 router, repl.ts L370-373
+ *     confirm path 处理.
+ *   - /exit fast-path (D-19.5 P1): 不在本 router (line === '/exit' 走 turnInFlight guard
+ *     L412 exclude, 不入 dispatch).
+ *   - line.startsWith('/') unknown i18n (D-21.1): 跟原 L477-481 1:1 保.
+ */
+export async function dispatchSlashBuiltin(line, ctx) {
+    if (line === '/help') {
+        ctx.out.write(`${t('cli.builtin_help')}\n`);
+        ctx.prompt();
+        return { handled: true };
+    }
+    if (line === '/verify') {
+        // Sprint 1c-revive-2-D-11-4 (2026-06-04): REPL `/verify` 内建命令.
+        // 跟 CLI `deepwhale --verify` 走同一 runVerify() — 不走 LLM / tool loop.
+        // 拍板 (D-11-4 review, 2026-06-04): REPL 里 /verify 走**异步** runVerify,
+        // 跑完打 formatReport 到 out (跟其它内建命令风格一致), 然后**写 verification
+        // event 到 session JSONL** (因为用户在 REPL 里跑了 verify, session 走 audit
+        // 轨迹, 跟 CLI 不写 session 形成差异).
+        // 退出: REPL 不退, 跑完回到 prompt 继续.
+        try {
+            const report = await runVerify(ctx.verifyChecks !== undefined ? { checks: ctx.verifyChecks } : {});
+            const filled = buildSummaryAndNext(report);
+            const text = formatReport({
+                ...report,
+                summary: filled.summary,
+                nextSuggestedAction: filled.nextSuggestedAction,
+            });
+            ctx.out.write(`${text}\n`);
+            if (ctx.writer) {
+                // 写 verification event 到 session (跟 CLI 不同: REPL 用户有 session, 应该审计)
+                const failedCount = report.checks.filter((c) => c.status !== 'passed').length;
+                await appendVerificationEvent(ctx.writer, {
+                    status: report.overallStatus,
+                    durationMs: report.durationMs,
+                    commandCount: report.checks.length,
+                    failedCount,
+                    summary: filled.summary,
+                });
+            }
+        }
+        catch (e) {
+            ctx.err.write(`error: verify failed to start: ${e instanceof Error ? e.message : String(e)}\n\n`);
+        }
+        ctx.prompt();
+        return { handled: true };
+    }
+    if (line.startsWith('/')) {
+        ctx.out.write(`${t('cli.builtin_unknown', line)}\n`);
+        ctx.prompt();
+        return { handled: true };
+    }
+    return { handled: false };
+}
+//# sourceMappingURL=repl-command-router.js.map

package/dist/repl/repl-command-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-command-router.js","sourceRoot":"","sources":["../../src/repl/repl-command-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,CAAC,EAAsB,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAA;AAenG;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,GAAiB;IAEjB,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAC3C,GAAG,CAAC,MAAM,EAAE,CAAA;QACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,+DAA+D;QAC/D,mEAAmE;QACnE,oEAAoE;QACpE,2DAA2D;QAC3D,kEAAkE;QAClE,8BAA8B;QAC9B,+BAA+B;QAC/B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAC5B,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CACnE,CAAA;YACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;YAC1C,MAAM,IAAI,GAAG,YAAY,CAAC;gBACxB,GAAG,MAAM;gBACT,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;aAChD,CAAC,CAAA;YACF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;YAC1B,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,oEAAoE;gBACpE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAA;gBAC7E,MAAM,uBAAuB,CAAC,GAAG,CAAC,MAAM,EAAE;oBACxC,MAAM,EAAE,MAAM,CAAC,aAAa;oBAC5B,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;oBAClC,WAAW;oBACX,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,GAAG,CAAC,KAAK,CACX,kCAAkC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACnF,CAAA;QACH,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,CAAA;QACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,qBAAqB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACpD,GAAG,CAAC,MAAM,EAAE,CAAA;QACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AAC3B,CAAC"}

package/dist/repl/repl-confirm.d.ts

@@ -0,0 +1,49 @@
+/**
+ * REPL y/N confirmation prompt — Sprint 1c-revive-3-D-19 (2026-06-05).
+ *
+ * 历史:
+ *   D-15 (2026-06-05): 工厂函数 + 内部 createInterface, 用 rl.question 收 y/N.
+ *     留 P1 (review blocker): 同流上主 rl + 子 rl 抢同一行, 用户输 y 时主 rl
+ *     会把 y 当新 chat turn 启动 (实测 Node repro 确认).
+ *   D-19 (2026-06-05): 拆掉自创 readline, 改成 "caller 喂 line" 的纯 resolver.
+ *     主 REPL 的 rl.on('line') 是唯一 stdin 消费者, 确认期间把 line 喂给
+ *     pending resolver, 解析完才放行, P1 串行化彻底.
+ *
+ * 拍板 (D-19, 2026-06-05):
+ *   - API 形状: createReplConfirm(opts) 返回的 confirm() 不再内部读 stdin,
+ *     而是用 offerLine(rawLine) + 内部 Promise<boolean | null> 状态机.
+ *   - prompt 格式: caller 拼好 "Allow <tool_name>? (<reason>) [y/N]: ",
+ *     confirm() 内部只负责 "收一行 → 解析 → resolve".
+ *   - 输入识别: y/yes/Y/YES → true; n/no/N/NO/空/other → false; abort → null.
+ *   - abort signal 触发立即 resolve null (dismissed).
+ *   - 同时只能有一个 pending 确认 (REPL 串行 chat-turn 拓扑保证).
+ *   - offerLine 二次调用 = 抛错 (caller bug, 不能丢 silent).
+ *
+ * 拍板 (D-19 §out of scope): 不接 RPC confirmedTools (D-17), 不接 user policy
+ * config (D-16), 不做 TUI (D-18).
+ */
+export interface ReplConfirmOptions {
+    /**
+     * REPL 的 out (拿 prompt 字符出口). 用 NodeJS.WritableStream 是为了兼容
+     * startRepl 传进来的 NodeJS.WritableStream 类型 (vs node:stream Writable).
+     * D-19 内部只写 prompt, 不读.
+     */
+    output: NodeJS.WritableStream;
+}
+export interface ReplConfirmCallOptions {
+    /** AbortSignal — 触发时 confirm 立即 resolve null (dismissed). D-19 修 Ctrl+C 链路. */
+    signal?: AbortSignal;
+}
+export type ReplConfirm = (prompt: string, options?: ReplConfirmCallOptions) => Promise<boolean | null>;
+export interface ReplConfirmController {
+    /** 提示用户 (写到 output, 加 [y/N]: 后缀). 内部 start 一个 pending. */
+    confirm: ReplConfirm;
+    /** REPL 主 line handler 拿到 line 后调: 若有 pending → 喂给 confirm; 若无 → false (caller 走 chat). */
+    offerLine: (rawLine: string) => boolean;
+    /** 当前是否有 in-flight 确认 (caller 用此守卫主 rl.line). */
+    hasPending: () => boolean;
+    /** 强制取消 (caller 进程退出/EOF/cleanup). */
+    dismiss: () => void;
+}
+export declare function createReplConfirm(opts: ReplConfirmOptions): ReplConfirmController;
+//# sourceMappingURL=repl-confirm.d.ts.map

package/dist/repl/repl-confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-confirm.d.ts","sourceRoot":"","sources":["../../src/repl/repl-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,sBAAsB,KAC7B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAQ7B,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,OAAO,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,iDAAiD;IACjD,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,sCAAsC;IACtC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,qBAAqB,CAqEjF"}

package/dist/repl/repl-confirm.js

@@ -0,0 +1,88 @@
+/**
+ * REPL y/N confirmation prompt — Sprint 1c-revive-3-D-19 (2026-06-05).
+ *
+ * 历史:
+ *   D-15 (2026-06-05): 工厂函数 + 内部 createInterface, 用 rl.question 收 y/N.
+ *     留 P1 (review blocker): 同流上主 rl + 子 rl 抢同一行, 用户输 y 时主 rl
+ *     会把 y 当新 chat turn 启动 (实测 Node repro 确认).
+ *   D-19 (2026-06-05): 拆掉自创 readline, 改成 "caller 喂 line" 的纯 resolver.
+ *     主 REPL 的 rl.on('line') 是唯一 stdin 消费者, 确认期间把 line 喂给
+ *     pending resolver, 解析完才放行, P1 串行化彻底.
+ *
+ * 拍板 (D-19, 2026-06-05):
+ *   - API 形状: createReplConfirm(opts) 返回的 confirm() 不再内部读 stdin,
+ *     而是用 offerLine(rawLine) + 内部 Promise<boolean | null> 状态机.
+ *   - prompt 格式: caller 拼好 "Allow <tool_name>? (<reason>) [y/N]: ",
+ *     confirm() 内部只负责 "收一行 → 解析 → resolve".
+ *   - 输入识别: y/yes/Y/YES → true; n/no/N/NO/空/other → false; abort → null.
+ *   - abort signal 触发立即 resolve null (dismissed).
+ *   - 同时只能有一个 pending 确认 (REPL 串行 chat-turn 拓扑保证).
+ *   - offerLine 二次调用 = 抛错 (caller bug, 不能丢 silent).
+ *
+ * 拍板 (D-19 §out of scope): 不接 RPC confirmedTools (D-17), 不接 user policy
+ * config (D-16), 不做 TUI (D-18).
+ */
+export function createReplConfirm(opts) {
+    let pending = null;
+    const settle = (v) => {
+        if (!pending)
+            return;
+        const p = pending;
+        pending = null;
+        if (p.abortHandler && p.abortHandler !== null) {
+            // no-op: signal listener 已被 offerLine / abortHandler 清理
+        }
+        p.resolve(v);
+    };
+    const confirm = (prompt, callOpts) => {
+        if (pending) {
+            // 拍板 (D-19): 同时只能有一个 pending, 二次 confirm 抛错 (caller bug).
+            return Promise.reject(new Error('repl-confirm: confirm() called while another confirmation is in flight. ' +
+                'Caller must serialize via hasPending() guard.'));
+        }
+        // 拍板 (D-19): caller 拼好 prompt, 我们只追加 [y/N]: 后缀.
+        const fullPrompt = `${prompt} [y/N]: `;
+        opts.output.write(fullPrompt);
+        return new Promise((resolve) => {
+            const p = {
+                prompt: fullPrompt,
+                resolve,
+                abortHandler: null,
+            };
+            pending = p;
+            // abort signal — 立即 resolve null (dismissed)
+            if (callOpts?.signal) {
+                if (callOpts.signal.aborted) {
+                    settle(null);
+                    return;
+                }
+                const handler = () => settle(null);
+                callOpts.signal.addEventListener('abort', handler, { once: true });
+                p.abortHandler = handler;
+            }
+        });
+    };
+    const offerLine = (rawLine) => {
+        if (!pending)
+            return false;
+        const answer = rawLine.trim().toLowerCase();
+        if (answer === 'y' || answer === 'yes') {
+            settle(true);
+        }
+        else if (answer === 'n' || answer === 'no' || answer === '') {
+            settle(false);
+        }
+        else {
+            // 拍板 (D-15 §Decision 3, D-19 沿用): other 当 N 处理 (不打扰)
+            settle(false);
+        }
+        return true;
+    };
+    const hasPending = () => pending !== null;
+    const dismiss = () => {
+        if (pending)
+            settle(null);
+    };
+    return { confirm, offerLine, hasPending, dismiss };
+}
+//# sourceMappingURL=repl-confirm.js.map

package/dist/repl/repl-confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-confirm.js","sourceRoot":"","sources":["../../src/repl/repl-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAsCH,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,IAAI,OAAO,GAA0B,IAAI,CAAC;IAE1C,MAAM,MAAM,GAAG,CAAC,CAAiB,EAAQ,EAAE;QACzC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,CAAC,GAAG,OAAO,CAAC;QAClB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC9C,wDAAwD;QAC1D,CAAC;QACD,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,OAAO,GAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,0DAA0D;YAC1D,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,0EAA0E;gBACxE,+CAA+C,CAClD,CACF,CAAC;QACJ,CAAC;QACD,gDAAgD;QAChD,MAAM,UAAU,GAAG,GAAG,MAAM,UAAU,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE9B,OAAO,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,EAAE;YAC7C,MAAM,CAAC,GAAmB;gBACxB,MAAM,EAAE,UAAU;gBAClB,OAAO;gBACP,YAAY,EAAE,IAAI;aACnB,CAAC;YACF,OAAO,GAAG,CAAC,CAAC;YAEZ,6CAA6C;YAC7C,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACrB,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,CAAC;oBACb,OAAO;gBACT,CAAC;gBACD,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnE,CAAC,CAAC,YAAY,GAAG,OAAO,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,OAAe,EAAW,EAAE;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAC9D,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,qDAAqD;YACrD,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,GAAY,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;IAEnD,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,IAAI,OAAO;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/repl/repl-session.d.ts

@@ -0,0 +1,79 @@
+/**
+ * REPL session / usage-status utilities — Sprint 1c-revive-3-D-29.1.2 (2026-06-07).
+ *
+ * 历史:
+ *   Sprint 1b: 把 usage 翻译成人类可读的一行 status, 写到 stderr (不污染 stdout 流式输出).
+ *   Sprint 1c-revive-2-D-21.1 (2026-06-06, 修 cache 96%↔85% 跳变 footer 焦虑): 增 EMA
+ *     平滑闭包 state — appendUsageStatus 每 turn in-place 更新, formatUsageStatus 读
+ *     ema 显示 (avg NN%). 跨 turn 累积, 闭包内 mutable, 不持久化 (session reload 后
+ *     sampleCount 重置为 0, 避免误导 — user 看到 avg 段消失就知道 reload 过了).
+ *
+ * 拍板 (D-29.1.2):
+ *   - 文件: `repl-session.ts` (跟 `repl-confirm.ts` / `repl-signal-coordinator.ts` 同
+ *     kebab-case 工厂形态命名, 本次抽 usage-status 三件套, 后续 D-29.1.5 可能扩展到
+ *     session loading / state 持久化).
+ *   - 公共 API 0 改: repl.ts re-export `formatUsageStatus` / `appendUsageStatus` /
+ *     `type UsageEmaState` 跟现状 1:1, src/index.ts / modes/print.ts / modes/tui.ts /
+ *     test/unit/usage-ema.test.ts 4 caller import path 不变.
+ *   - 行为 1:1: formatUsageStatus 输出字符串逐字保持, appendUsageStatus in-place
+ *     update 顺序 (update ema → format → write) 保持. 旧 caller 不传 emaState 用
+ *     默认 `{ sampleCount: 0 }` 行为兼容 (不显示 avg 段).
+ *   - 本文件**不**抽 session loading / state 持久化 (Sprint 1a 那段 L250-263 还在
+ *     repl.ts 闭包内, 跟 startRepl 强耦合, 留给 D-29.1.5).
+ *
+ * 拍板 (D-29.1.2 §out of scope):
+ *   - 不抽 SessionReader / SessionWriter 构造 (L250-251) — 跟 startRepl 闭包
+ *     强耦合, 抽需要拆出 loadSessionOptions factory, 收益小, 留给 D-29.1.5.
+ *   - 不动 /verify / /help / /exit dispatcher (L437-479) — 那是 6afccc8 slash
+ *     builtin 红线, 留给 D-29.1.4.
+ *   - 不动 runAgentTurn 主体 (L618-753) — 留给 D-29.1.5.
+ */
+import type { Usage } from '@deepwhale/llm';
+/**
+ * EMA 平滑 state (Sprint 1c-revive-2-D-21.1).
+ *
+ * - `hitRateEMA`: 过去 5-turn 滚动平均 (α=0.5 平滑). undefined = cold start, 第一次
+ *   sample 直接赋值. 跨 turn 累积, 闭包内 mutable, 不持久化.
+ * - `sampleCount`: 已 sample 的 turn 数. `sampleCount < 3` 时不显示 (avg) 段 (样本
+ *   太少, 趋势没意义). 跟 `hitRateEMA` 一起被 appendUsageStatus in-place 更新.
+ */
+export interface UsageEmaState {
+    hitRateEMA?: number;
+    sampleCount: number;
+}
+/**
+ * 把 usage 翻译成人类可读的一行 status 字符串.
+ *
+ * 显示规则 (Hermes footer 教训应用 — 多字段同值时去冗余):
+ * - 满 usage (有 cached_tokens) → 完整 4 字段: cache: 90% | ¥0.05/turn | prompt 1.2k (1.1k cached)
+ * - 无 cached_tokens → 简化为: usage: 1.2k prompt / 200 completion
+ *   (不打 cache% / cost, 避免没数据时显示 0% 误导)
+ * - 无 usage → 完全不打印 (LLM 没返 usage 时不污染 stderr)
+ *
+ * Sprint 1c 抽 pricing 到 config.toml, 此函数签名不变。
+ *
+ * Sprint 1c-revive-2-D-21.1 (2026-06-06, 修 cache 96%↔85% 跳变 footer 焦虑):
+ * 增 emaState 形参. 形参 hitRateEMA 是过去 5-turn 滚动平均 (α=0.5 平滑).
+ * 输出: `cache: 90% (avg 85%)` — per-turn 数字 + 趋势均值并列. user 视角:
+ * 1) 知道当 turn 真值, 2) 知道趋势 (avg 不会跟着单 turn 抖动).
+ * 边界:
+ *   - sampleCount < 3: 不显示 (avg) 段 (样本太少, 趋势没意义, 不污染)
+ *   - sampleCount >= 3: 显示 (avg NN%)
+ *   - ema 永远存在 (闭包外, startRepl 持有), 跨 turn 累积
+ * 行为兼容: 旧 caller 不传 emaState 用默认 { hitRateEMA: undefined, sampleCount: 0 }
+ * → 行为跟改前一致 (不显示 avg 段). 现有单测 (formatUsageStatus) 不破.
+ */
+export declare function formatUsageStatus(usage: Usage | undefined, emaState?: UsageEmaState): string | null;
+/**
+ * Sprint 1c-revive-2-D-21.1 (2026-06-06): emaState 接受 mutable 引用 (闭包),
+ * 在 sampleCount < 5 用 cold-start EMA (直接赋值), 之后 α=0.5 平滑:
+ *   newEMA = α * current + (1 - α) * oldEMA = 0.5 * current + 0.5 * oldEMA
+ * α=0.5 是 "等权平滑" (5-turn 半衰期 ≈ 1 turn, 快速响应 + 适度平滑).
+ * 数学: sampleCount=5 时, 5 turn 前的数据权重 = 0.5^5 = 3.1% (基本忘掉),
+ * 跟 5-turn rolling window 趋势一致, 但 EMA 实现更轻.
+ *
+ * export 出来供单测 (test/unit/usage-ema.test.ts) 验证 state machine.
+ * 之前是 local function, D-21.1 改成 export — 单测需要直接调它验 in-place update.
+ */
+export declare function appendUsageStatus(usage: Usage | undefined, err: NodeJS.WritableStream, emaState: UsageEmaState): void;
+//# sourceMappingURL=repl-session.d.ts.map

package/dist/repl/repl-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-session.d.ts","sourceRoot":"","sources":["../../src/repl/repl-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,QAAQ,GAAE,aAAyB,GAClC,MAAM,GAAG,IAAI,CA2Bf;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,GAAG,EAAE,MAAM,CAAC,cAAc,EAC1B,QAAQ,EAAE,aAAa,GACtB,IAAI,CAgBN"}

package/dist/repl/repl-session.js

@@ -0,0 +1,129 @@
+/**
+ * REPL session / usage-status utilities — Sprint 1c-revive-3-D-29.1.2 (2026-06-07).
+ *
+ * 历史:
+ *   Sprint 1b: 把 usage 翻译成人类可读的一行 status, 写到 stderr (不污染 stdout 流式输出).
+ *   Sprint 1c-revive-2-D-21.1 (2026-06-06, 修 cache 96%↔85% 跳变 footer 焦虑): 增 EMA
+ *     平滑闭包 state — appendUsageStatus 每 turn in-place 更新, formatUsageStatus 读
+ *     ema 显示 (avg NN%). 跨 turn 累积, 闭包内 mutable, 不持久化 (session reload 后
+ *     sampleCount 重置为 0, 避免误导 — user 看到 avg 段消失就知道 reload 过了).
+ *
+ * 拍板 (D-29.1.2):
+ *   - 文件: `repl-session.ts` (跟 `repl-confirm.ts` / `repl-signal-coordinator.ts` 同
+ *     kebab-case 工厂形态命名, 本次抽 usage-status 三件套, 后续 D-29.1.5 可能扩展到
+ *     session loading / state 持久化).
+ *   - 公共 API 0 改: repl.ts re-export `formatUsageStatus` / `appendUsageStatus` /
+ *     `type UsageEmaState` 跟现状 1:1, src/index.ts / modes/print.ts / modes/tui.ts /
+ *     test/unit/usage-ema.test.ts 4 caller import path 不变.
+ *   - 行为 1:1: formatUsageStatus 输出字符串逐字保持, appendUsageStatus in-place
+ *     update 顺序 (update ema → format → write) 保持. 旧 caller 不传 emaState 用
+ *     默认 `{ sampleCount: 0 }` 行为兼容 (不显示 avg 段).
+ *   - 本文件**不**抽 session loading / state 持久化 (Sprint 1a 那段 L250-263 还在
+ *     repl.ts 闭包内, 跟 startRepl 强耦合, 留给 D-29.1.5).
+ *
+ * 拍板 (D-29.1.2 §out of scope):
+ *   - 不抽 SessionReader / SessionWriter 构造 (L250-251) — 跟 startRepl 闭包
+ *     强耦合, 抽需要拆出 loadSessionOptions factory, 收益小, 留给 D-29.1.5.
+ *   - 不动 /verify / /help / /exit dispatcher (L437-479) — 那是 6afccc8 slash
+ *     builtin 红线, 留给 D-29.1.4.
+ *   - 不动 runAgentTurn 主体 (L618-753) — 留给 D-29.1.5.
+ */
+/** 默认 (空) EMA state — 旧 caller 不传 emaState 时用, 行为兼容. */
+const EMPTY_EMA = { sampleCount: 0 };
+/**
+ * 把 usage 翻译成人类可读的一行 status 字符串.
+ *
+ * 显示规则 (Hermes footer 教训应用 — 多字段同值时去冗余):
+ * - 满 usage (有 cached_tokens) → 完整 4 字段: cache: 90% | ¥0.05/turn | prompt 1.2k (1.1k cached)
+ * - 无 cached_tokens → 简化为: usage: 1.2k prompt / 200 completion
+ *   (不打 cache% / cost, 避免没数据时显示 0% 误导)
+ * - 无 usage → 完全不打印 (LLM 没返 usage 时不污染 stderr)
+ *
+ * Sprint 1c 抽 pricing 到 config.toml, 此函数签名不变。
+ *
+ * Sprint 1c-revive-2-D-21.1 (2026-06-06, 修 cache 96%↔85% 跳变 footer 焦虑):
+ * 增 emaState 形参. 形参 hitRateEMA 是过去 5-turn 滚动平均 (α=0.5 平滑).
+ * 输出: `cache: 90% (avg 85%)` — per-turn 数字 + 趋势均值并列. user 视角:
+ * 1) 知道当 turn 真值, 2) 知道趋势 (avg 不会跟着单 turn 抖动).
+ * 边界:
+ *   - sampleCount < 3: 不显示 (avg) 段 (样本太少, 趋势没意义, 不污染)
+ *   - sampleCount >= 3: 显示 (avg NN%)
+ *   - ema 永远存在 (闭包外, startRepl 持有), 跨 turn 累积
+ * 行为兼容: 旧 caller 不传 emaState 用默认 { hitRateEMA: undefined, sampleCount: 0 }
+ * → 行为跟改前一致 (不显示 avg 段). 现有单测 (formatUsageStatus) 不破.
+ */
+export function formatUsageStatus(usage, emaState = EMPTY_EMA) {
+    if (usage === undefined)
+        return null;
+    const { prompt_tokens, completion_tokens } = usage;
+    // 无 cached_tokens: 简版
+    if (usage.cached_tokens === undefined) {
+        return `usage: ${formatTokens(prompt_tokens)} prompt / ${formatTokens(completion_tokens)} completion`;
+    }
+    // 满 usage: 完整 status
+    const hitRatePct = ((usage.cache_hit_rate ?? 0) * 100).toFixed(0);
+    const uncached = formatTokens(usage.tokens_uncached ?? prompt_tokens);
+    // Sprint 1c-revive-2-D-21.1: EMA 平滑尾部段. sampleCount >= 3 才显示 avg
+    // (样本太少趋势不稳). 不更新 caller state, 只读 (state update 在
+    // appendUsageStatus, 这是纯函数好测).
+    const avgSegment = emaState.sampleCount >= 3 && emaState.hitRateEMA !== undefined
+        ? ` (avg ${(emaState.hitRateEMA * 100).toFixed(0)}%)`
+        : '';
+    // Sprint 1b.5 Step 2.5 (F5 拍板, review 2026-06-03 找到): cost_turn/cost_currency 都 absent
+    // (R7 中间路径 / F4 保守) → 安静少显示字段, **不**显示 'cost ?'. 跟 1b 拍板 "absent 安静"
+    // 一致. user 视角看 'cost ?/turn' 是 'UI 不知道' 不是 '这次没算', 显示 '?' 反而误导.
+    if (usage.cost_turn === undefined || usage.cost_currency === undefined) {
+        return `cache: ${hitRatePct}%${avgSegment} | prompt ${formatTokens(prompt_tokens)} (${uncached} new)`;
+    }
+    // cost 字段齐: 读 cost_currency 决 symbol
+    const symbol = formatCostSymbol(usage.cost_currency);
+    const cost = usage.cost_turn; // narrowed by 上面 if guard (cost_turn !== undefined)
+    const costStr = cost < 0.01 ? `${symbol}${cost.toFixed(4)}` : `${symbol}${cost.toFixed(3)}`;
+    return `cache: ${hitRatePct}%${avgSegment} | ${costStr}/turn | prompt ${formatTokens(prompt_tokens)} (${uncached} new)`;
+}
+/** cost_currency → 显示 symbol. 不在 UI 层做汇率换算. */
+function formatCostSymbol(currency) {
+    switch (currency) {
+        case 'CNY':
+            return '¥';
+        case 'USD':
+            return '$';
+        case undefined:
+            return '?';
+    }
+}
+function formatTokens(n) {
+    if (n >= 1000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return String(n);
+}
+/**
+ * Sprint 1c-revive-2-D-21.1 (2026-06-06): emaState 接受 mutable 引用 (闭包),
+ * 在 sampleCount < 5 用 cold-start EMA (直接赋值), 之后 α=0.5 平滑:
+ *   newEMA = α * current + (1 - α) * oldEMA = 0.5 * current + 0.5 * oldEMA
+ * α=0.5 是 "等权平滑" (5-turn 半衰期 ≈ 1 turn, 快速响应 + 适度平滑).
+ * 数学: sampleCount=5 时, 5 turn 前的数据权重 = 0.5^5 = 3.1% (基本忘掉),
+ * 跟 5-turn rolling window 趋势一致, 但 EMA 实现更轻.
+ *
+ * export 出来供单测 (test/unit/usage-ema.test.ts) 验证 state machine.
+ * 之前是 local function, D-21.1 改成 export — 单测需要直接调它验 in-place update.
+ */
+export function appendUsageStatus(usage, err, emaState) {
+    // 同步更新 EMA state (in-place). 调 formatUsageStatus 之前先 update,
+    // 防止 "刚 sample 1 个, display 当 turn 仍显示 sample 0 的 ema".
+    if (usage !== undefined && usage.cached_tokens !== undefined) {
+        const current = usage.cache_hit_rate ?? 0;
+        if (emaState.hitRateEMA === undefined) {
+            emaState.hitRateEMA = current;
+        }
+        else {
+            emaState.hitRateEMA = 0.5 * current + 0.5 * emaState.hitRateEMA;
+        }
+        emaState.sampleCount += 1;
+    }
+    const line = formatUsageStatus(usage, emaState);
+    if (line !== null) {
+        err.write(`  ${line}\n`);
+    }
+}
+//# sourceMappingURL=repl-session.js.map

package/dist/repl/repl-session.js.map

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

package/dist/repl/repl-signal-coordinator.d.ts

@@ -0,0 +1,74 @@
+/**
+ * REPL SIGINT + turn AbortController coordinator — Sprint 1c-revive-3-D-29.1.1 (2026-06-07).
+ *
+ * 历史:
+ *   D-19 (2026-06-05): SIGINT handler + turnAbortController 写在 repl.ts L342-363 闭包内,
+ *     rl.on('line') chat turn 入口 new 一个新 controller (L510), close handler 调
+ *     controller.abort() (L583-585), finish() 调 process.off (L305). 拍板: AbortController
+ *     单次 abort 语义 — 上一个 turn 被 abort 后, 必须 new 新 controller 才能再 abort.
+ *   D-19.5 (2026-06-05): 修 P2.5 — finish() 入口先 process.off, 防止嵌入式 / 多次启动
+ *     REPL 累积 listener. 顺序红线: off 必须在 rl.close() 之前, 否则 close 派发 'close'
+ *     期间 Ctrl+C 还能触达 onSigint 闭包.
+ *   D-19.6 (2026-06-05): close handler 改成 dismiss + abort + pendingExit + exitTimer
+ *     状态机根治, 不用 try/catch absorb race.
+ *   D-29.1.1 (2026-06-07): 抽到独立文件, 跟 repl-confirm.ts 工厂形态对齐.
+ *
+ * 拍板 (D-29.1.1):
+ *   - 工厂函数: createSignalCoordinator(opts) → ReplSignalCoordinator.
+ *   - 闭包形态: 内部 let controller 持有当前 turnAbortController, getSignal() / refresh()
+ *     / abortIfActive() 三方法对外暴露, caller 不用直接看 controller 变量.
+ *   - SIGINT 行为 1:1 等价 — 先 dismiss in-flight confirm (D-19 P2-dismiss 顺序), 再
+ *     abort 当前 turnAbortController. 进程不退出, 跟 D-19 拍板一致.
+ *   - dispose() 幂等 — 多次调安全 (disposed 闭包 boolean 守卫), 防止 finish() 重入.
+ *   - process 来源: opts.process 注入 (单测 mock), 默认 node:process. 跟 D-19 红线
+ *     "测 SIGINT 走 abort 直接调, 不挂真 process" 一致 — 单测不需 mock process.
+ *   - dispose 顺序红线: process.off 必须在 rl.close() 之前 (D-19.5 拍板) — coordinator
+ *     内部按这个顺序处理, caller 只需在 finish() 入口调 dispose().
+ *
+ * 拍板 (D-29.1.1 §out of scope):
+ *   - 不接 exitTimer 兜底 timer (那是 D-19.6 P1 close 路径的, 跟 pendingExit state
+ *     machine 绑定, 留给 D-29.1.3 turn-guard 抽).
+ *   - 不接 pendingExit / lineQueue (那是 6afccc8 6 红线段的职责, 留给 D-29.1.3).
+ *   - 不抽 rl.on('close') 路径里的 dismiss + abort (L580-585) — close handler
+ *     跟 lineQueue / exitTimer 强耦合, 整体抽风险大于收益, 留给 D-29.1.3+.
+ */
+import type { ReplConfirmController } from './repl-confirm.js';
+export interface ReplSignalCoordinatorOptions {
+    /**
+     * REPL 的 confirm controller (D-19 P2-dismiss 顺序的源).
+     * SIGINT 触发时先 confirmController.dismiss() (落 user_denied 审计),
+     * 再 abort turnAbortController.
+     */
+    confirmController: ReplConfirmController;
+    /**
+     * 注入 process (单测 mock 用). 默认 node:process.
+     * D-19 红线: 测 SIGINT 行为走 abort() 直接调, 不挂真 process.
+     */
+    process?: NodeJS.Process;
+}
+export interface ReplSignalCoordinator {
+    /** 当前 in-flight turn 的 AbortSignal. 派给 runAgentTurn / runOneTurn. */
+    getSignal: () => AbortSignal;
+    /**
+     * 续命 controller — turn 入口 new 一个新 controller, 旧的被 SIGINT abort 后
+     * 第二次 abort 无效, 必须 refresh. D-19 拍板: onSigint 闭包持有的是 coordinator
+     * 内部 let 变量, refresh 后下次 SIGINT 自动 abort 新的, 不需要重建 handler.
+     * 红线: 不要 add 多份 SIGINT listener 重复触发.
+     */
+    refresh: () => void;
+    /**
+     * 主动 abort (close 路径 / pendingExit 兜底). 幂等 — 已 abort 的 controller 不再
+     * 派发 abort 事件. D-19.6 拍板: close handler 走 dismiss + abort + pendingExit
+     * 状态机, abort 顺序在 dismiss 之后.
+     */
+    abortIfActive: () => void;
+    /**
+     * finish() 入口调 — process.off('SIGINT', onSigint) + 清 disposed 守卫.
+     * 顺序红线 (D-19.5): dispose() 必须在 caller 的 rl.close() 之前, 否则 close
+     * 派发 'close' 期间 Ctrl+C 还能触达 onSigint 闭包.
+     * 幂等: 多次调安全.
+     */
+    dispose: () => void;
+}
+export declare function createSignalCoordinator(opts: ReplSignalCoordinatorOptions): ReplSignalCoordinator;
+//# sourceMappingURL=repl-signal-coordinator.d.ts.map

package/dist/repl/repl-signal-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-signal-coordinator.d.ts","sourceRoot":"","sources":["../../src/repl/repl-signal-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,iBAAiB,EAAE,qBAAqB,CAAC;IACzC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,SAAS,EAAE,MAAM,WAAW,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,4BAA4B,GACjC,qBAAqB,CAwCvB"}

package/dist/repl/repl-signal-coordinator.js

@@ -0,0 +1,73 @@
+/**
+ * REPL SIGINT + turn AbortController coordinator — Sprint 1c-revive-3-D-29.1.1 (2026-06-07).
+ *
+ * 历史:
+ *   D-19 (2026-06-05): SIGINT handler + turnAbortController 写在 repl.ts L342-363 闭包内,
+ *     rl.on('line') chat turn 入口 new 一个新 controller (L510), close handler 调
+ *     controller.abort() (L583-585), finish() 调 process.off (L305). 拍板: AbortController
+ *     单次 abort 语义 — 上一个 turn 被 abort 后, 必须 new 新 controller 才能再 abort.
+ *   D-19.5 (2026-06-05): 修 P2.5 — finish() 入口先 process.off, 防止嵌入式 / 多次启动
+ *     REPL 累积 listener. 顺序红线: off 必须在 rl.close() 之前, 否则 close 派发 'close'
+ *     期间 Ctrl+C 还能触达 onSigint 闭包.
+ *   D-19.6 (2026-06-05): close handler 改成 dismiss + abort + pendingExit + exitTimer
+ *     状态机根治, 不用 try/catch absorb race.
+ *   D-29.1.1 (2026-06-07): 抽到独立文件, 跟 repl-confirm.ts 工厂形态对齐.
+ *
+ * 拍板 (D-29.1.1):
+ *   - 工厂函数: createSignalCoordinator(opts) → ReplSignalCoordinator.
+ *   - 闭包形态: 内部 let controller 持有当前 turnAbortController, getSignal() / refresh()
+ *     / abortIfActive() 三方法对外暴露, caller 不用直接看 controller 变量.
+ *   - SIGINT 行为 1:1 等价 — 先 dismiss in-flight confirm (D-19 P2-dismiss 顺序), 再
+ *     abort 当前 turnAbortController. 进程不退出, 跟 D-19 拍板一致.
+ *   - dispose() 幂等 — 多次调安全 (disposed 闭包 boolean 守卫), 防止 finish() 重入.
+ *   - process 来源: opts.process 注入 (单测 mock), 默认 node:process. 跟 D-19 红线
+ *     "测 SIGINT 走 abort 直接调, 不挂真 process" 一致 — 单测不需 mock process.
+ *   - dispose 顺序红线: process.off 必须在 rl.close() 之前 (D-19.5 拍板) — coordinator
+ *     内部按这个顺序处理, caller 只需在 finish() 入口调 dispose().
+ *
+ * 拍板 (D-29.1.1 §out of scope):
+ *   - 不接 exitTimer 兜底 timer (那是 D-19.6 P1 close 路径的, 跟 pendingExit state
+ *     machine 绑定, 留给 D-29.1.3 turn-guard 抽).
+ *   - 不接 pendingExit / lineQueue (那是 6afccc8 6 红线段的职责, 留给 D-29.1.3).
+ *   - 不抽 rl.on('close') 路径里的 dismiss + abort (L580-585) — close handler
+ *     跟 lineQueue / exitTimer 强耦合, 整体抽风险大于收益, 留给 D-29.1.3+.
+ */
+export function createSignalCoordinator(opts) {
+    const proc = opts.process ?? process;
+    let controller = new AbortController();
+    let disposed = false;
+    // 拍板 (D-19 P2-dismiss): SIGINT 先 dismiss in-flight confirm 落 user_denied 审计,
+    // 再 abort turnAbortController. 顺序: dismiss 先于 abort — confirm resolve 后
+    // runToolLoop 才检查 signal, 调换会丢 audit 路径. 进程不退出, 用户可继续.
+    const onSigint = () => {
+        if (opts.confirmController.hasPending()) {
+            opts.confirmController.dismiss();
+        }
+        if (!controller.signal.aborted) {
+            controller.abort();
+        }
+    };
+    proc.on('SIGINT', onSigint);
+    return {
+        getSignal: () => controller.signal,
+        refresh: () => {
+            if (disposed)
+                return;
+            controller = new AbortController();
+        },
+        abortIfActive: () => {
+            if (!controller.signal.aborted) {
+                controller.abort();
+            }
+        },
+        dispose: () => {
+            if (disposed)
+                return;
+            disposed = true;
+            // 红线 (D-19.5): off 必须在 caller 的 rl.close() 之前. Coordinator 在
+            // dispose() 同步内 off, caller 调用顺序 = dispose() → rl.close() → ...
+            proc.off('SIGINT', onSigint);
+        },
+    };
+}
+//# sourceMappingURL=repl-signal-coordinator.js.map

package/dist/repl/repl-signal-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-signal-coordinator.js","sourceRoot":"","sources":["../../src/repl/repl-signal-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AA2CH,MAAM,UAAU,uBAAuB,CACrC,IAAkC;IAElC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC;IACrC,IAAI,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,6EAA6E;IAC7E,wEAAwE;IACxE,uDAAuD;IACvD,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE5B,OAAO;QACL,SAAS,EAAE,GAAgB,EAAE,CAAC,UAAU,CAAC,MAAM;QAE/C,OAAO,EAAE,GAAS,EAAE;YAClB,IAAI,QAAQ;gBAAE,OAAO;YACrB,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,CAAC;QAED,aAAa,EAAE,GAAS,EAAE;YACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,GAAS,EAAE;YAClB,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,6DAA6D;YAC7D,gEAAgE;YAChE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}