@deepwhale/coding-agent 1.0.12 → 1.0.13

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 跨包共享的 tool 类型（被工具实现和 registry 共同使用）
+ */
+import type { ToolName } from '@deepwhale/core';
+export type { ToolName };
+/**
+ * 工具输入 schema — 用 zod-like 的简化结构（避免 Sprint 0 拉 zod 依赖）
+ * Sprint 1 再决定是否引入 zod
+ */
+export type ToolInputSchema = {
+    readonly type: 'object';
+    readonly properties: Record<string, ToolParamSchema>;
+    readonly required?: ReadonlyArray<string>;
+};
+export type ToolParamSchema = {
+    type: 'string';
+    description: string;
+    enum?: ReadonlyArray<string>;
+} | {
+    type: 'number';
+    description: string;
+    minimum?: number;
+    maximum?: number;
+} | {
+    type: 'boolean';
+    description: string;
+} | {
+    type: 'array';
+    description: string;
+    items: ToolParamSchema;
+};
+/**
+ * 工具执行结果 — Observation 4 字段（arch §2.3 / ECC 借鉴）
+ * - content: 工具输出
+ * - success: 是否成功
+ * - error: 失败时的错误信息
+ * - meta: 性能/调试元数据
+ */
+export type ToolResult = {
+    success: true;
+    content: string;
+    meta?: Record<string, unknown>;
+} | {
+    success: false;
+    content: string;
+    error: string;
+    meta?: Record<string, unknown>;
+};
+/**
+ * 工具接口 — 所有 6 工具必须实现
+ *
+ * 设计原则：
+ * - name/risk/description 让 LLM 看到
+ * - schema 让 LLM 知道参数结构
+ * - execute() 是真实实现（同步或异步）
+ * - 沙箱在 Sprint 2 加（v1.0 = Docker only，v1.0 不强制沙箱）
+ */
+export interface Tool {
+    readonly name: ToolName;
+    readonly description: string;
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly schema: ToolInputSchema;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+/** Tool 错误码（arch §ApplyError 对应，扩展到所有 tool） */
+export type ToolError = {
+    kind: 'invalid-input';
+    param: string;
+    reason: string;
+} | {
+    kind: 'not-found';
+    path: string;
+} | {
+    kind: 'permission-denied';
+    path: string;
+    reason: string;
+} | {
+    kind: 'execution-failed';
+    command: string;
+    stderr: string;
+} | {
+    kind: 'io-error';
+    path: string;
+    message: string;
+} | {
+    kind: 'unsupported';
+    reason: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClE;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAEvF;;;;;;;;GAQG;AACH,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC9D;AAED,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * 跨包共享的 tool 类型（被工具实现和 registry 共同使用）
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/util/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @deepwhale/coding-agent — util barrel (D-25 B4, 跟 tui-ink + tui.ts 共享)
+ *
+ * D-25 B4 (2026-06-06) 拍板: 抽跨包共享 util 到这里, 跟 tui-ink 复用红线一致.
+ *   - 0 改业务实现, 只做 re-export
+ *   - 跟 D-24.2 policy/index.ts barrel 模式 1:1
+ *
+ * 当前 (B4): 1 个 util
+ *   - tui-history: 抽 tui-ink/src/history/index.ts 86 行到 coding-agent util,
+ *     跟 modes/tui.ts 共享, 0 业务重写, 0 删已有测
+ *
+ * 后续 sprint (D-26+) 可能加:
+ *   - memory, clipboard, osc52, syntax 等 (Hermes ui-tui 对齐)
+ */
+export { tuiHistoryPath, tuiHistoryLoad, tuiHistoryAppend, tuiHistoryTruncate, TUI_HISTORY_MAX, } from './tui-history.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/util/index.js

@@ -0,0 +1,16 @@
+/**
+ * @deepwhale/coding-agent — util barrel (D-25 B4, 跟 tui-ink + tui.ts 共享)
+ *
+ * D-25 B4 (2026-06-06) 拍板: 抽跨包共享 util 到这里, 跟 tui-ink 复用红线一致.
+ *   - 0 改业务实现, 只做 re-export
+ *   - 跟 D-24.2 policy/index.ts barrel 模式 1:1
+ *
+ * 当前 (B4): 1 个 util
+ *   - tui-history: 抽 tui-ink/src/history/index.ts 86 行到 coding-agent util,
+ *     跟 modes/tui.ts 共享, 0 业务重写, 0 删已有测
+ *
+ * 后续 sprint (D-26+) 可能加:
+ *   - memory, clipboard, osc52, syntax 等 (Hermes ui-tui 对齐)
+ */
+export { tuiHistoryPath, tuiHistoryLoad, tuiHistoryAppend, tuiHistoryTruncate, TUI_HISTORY_MAX, } from './tui-history.js';
+//# sourceMappingURL=index.js.map

package/dist/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/util/tui-history.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @deepwhale/coding-agent — TUI 历史持久化 util (D-25 B4, 跟 tui.ts + tui-ink 1:1).
+ *
+ * 业务逻辑 0 重写, 跟 packages/coding-agent/src/modes/tui.ts line 293-343 的
+ * tuiHistoryPath / tuiHistoryLoad / tuiHistoryAppend 1:1 同步.
+ *
+ * D-25 B4 (2026-06-06) — 抽 tui-ink history 到 coding-agent util, tui-ink 复用:
+ *   - 修前: tui-ink/src/history/index.ts 86 行 copy, 跟 modes/tui.ts 三处实现各管各
+ *   - 修后: 唯一实现 在这里, tui-ink 走 thin re-export, modes/tui.ts 1:1 同步
+ *   - 跨包消费: tui-ink + legacy readline 容器都 import 这个 util
+ *
+ * D-25 A1 (F4) — Windows tui-smoke history 测试 fail (HOME vs USERPROFILE) 修:
+ *   - tuiHistoryPath(homeOverride?) 新签名: 优先 homeOverride > DEEPWHALE_HOME env >
+ *     USERPROFILE (Windows 原生) > HOME (Unix + 测试 mock) > homedir() 兜底
+ *   - tuiHistoryLoad / tuiHistoryAppend 接 homeOverride 透传
+ *   - 兼容: legacy `tuiHistoryPath()` 0 参 = 走 env 探测, 不破坏老调用方
+ *
+ * 文件: <home>/.deepwhale/tui-history (JSONL, 每行 1 条 raw line)
+ * 上限: 1000 条 (LRU 截断, 防无限增长)
+ *
+ * 注意: readline 历史上依赖 `rl.history = loaded.reverse()` (readline 期望最新在尾部).
+ * Ink 容器用 `useState` 维护 history, load 时同样 reverse (保持跟 readline 一致).
+ */
+export declare const TUI_HISTORY_MAX = 1000;
+/**
+ * D-25 A1: 新签名接受 homeOverride. 不传走 3 路径优先级探测.
+ * 旧 0 参调用方 (legacy tui.ts, test 4) 0 改.
+ */
+export declare function tuiHistoryPath(homeOverride?: string): string;
+export declare function tuiHistoryLoad(homeOverride?: string): string[];
+export declare function tuiHistoryAppend(line: string, homeOverride?: string): void;
+/**
+ * LRU 截断 (跟 D-22.1 1:1 同步, 避免无限增长).
+ * 暴露给测试用.
+ */
+export declare function tuiHistoryTruncate(lines: string[], max?: number): string[];
+//# sourceMappingURL=tui-history.d.ts.map

package/dist/util/tui-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-history.d.ts","sourceRoot":"","sources":["../../src/util/tui-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,eAAO,MAAM,eAAe,OAAO,CAAA;AAqBnC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAW9D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAU1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAwB,GAAG,MAAM,EAAE,CAG3F"}

package/dist/util/tui-history.js

@@ -0,0 +1,93 @@
+/**
+ * @deepwhale/coding-agent — TUI 历史持久化 util (D-25 B4, 跟 tui.ts + tui-ink 1:1).
+ *
+ * 业务逻辑 0 重写, 跟 packages/coding-agent/src/modes/tui.ts line 293-343 的
+ * tuiHistoryPath / tuiHistoryLoad / tuiHistoryAppend 1:1 同步.
+ *
+ * D-25 B4 (2026-06-06) — 抽 tui-ink history 到 coding-agent util, tui-ink 复用:
+ *   - 修前: tui-ink/src/history/index.ts 86 行 copy, 跟 modes/tui.ts 三处实现各管各
+ *   - 修后: 唯一实现 在这里, tui-ink 走 thin re-export, modes/tui.ts 1:1 同步
+ *   - 跨包消费: tui-ink + legacy readline 容器都 import 这个 util
+ *
+ * D-25 A1 (F4) — Windows tui-smoke history 测试 fail (HOME vs USERPROFILE) 修:
+ *   - tuiHistoryPath(homeOverride?) 新签名: 优先 homeOverride > DEEPWHALE_HOME env >
+ *     USERPROFILE (Windows 原生) > HOME (Unix + 测试 mock) > homedir() 兜底
+ *   - tuiHistoryLoad / tuiHistoryAppend 接 homeOverride 透传
+ *   - 兼容: legacy `tuiHistoryPath()` 0 参 = 走 env 探测, 不破坏老调用方
+ *
+ * 文件: <home>/.deepwhale/tui-history (JSONL, 每行 1 条 raw line)
+ * 上限: 1000 条 (LRU 截断, 防无限增长)
+ *
+ * 注意: readline 历史上依赖 `rl.history = loaded.reverse()` (readline 期望最新在尾部).
+ * Ink 容器用 `useState` 维护 history, load 时同样 reverse (保持跟 readline 一致).
+ */
+import { existsSync, readFileSync, appendFileSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+export const TUI_HISTORY_MAX = 1000;
+/**
+ * D-25 A1: 解析 home dir, 3 路径优先级:
+ *   1. homeOverride 显式入参 (测试 / 业务透传)
+ *   2. DEEPWHALE_HOME env (用户 / 部署)
+ *   3. HOME > USERPROFILE (Windows) > homedir() 兜底
+ */
+function resolveTuiHome(homeOverride) {
+    if (homeOverride && homeOverride.length > 0)
+        return homeOverride;
+    const env = process.env['DEEPWHALE_HOME'];
+    if (env && env.length > 0)
+        return env;
+    // Windows 上 Node 的 homedir() 走 USERPROFILE, 但 env test 经常只设 HOME.
+    // 显式查两个, USERPROFILE 优先 (Windows 原生), 然后 HOME (Unix 原生 + 测试 mock).
+    const windowsHome = process.env['USERPROFILE'];
+    if (windowsHome && windowsHome.length > 0)
+        return windowsHome;
+    const unixHome = process.env['HOME'];
+    if (unixHome && unixHome.length > 0)
+        return unixHome;
+    return homedir();
+}
+/**
+ * D-25 A1: 新签名接受 homeOverride. 不传走 3 路径优先级探测.
+ * 旧 0 参调用方 (legacy tui.ts, test 4) 0 改.
+ */
+export function tuiHistoryPath(homeOverride) {
+    return join(resolveTuiHome(homeOverride), '.deepwhale', 'tui-history');
+}
+export function tuiHistoryLoad(homeOverride) {
+    const p = tuiHistoryPath(homeOverride);
+    if (!existsSync(p))
+        return [];
+    try {
+        const raw = readFileSync(p, 'utf8');
+        const lines = raw.split(/\r?\n/).filter((l) => l.length > 0);
+        // readline 期望最新在尾部, JSONL 顺序是 append (最新在末尾), 不需要 reverse
+        return lines;
+    }
+    catch {
+        return [];
+    }
+}
+export function tuiHistoryAppend(line, homeOverride) {
+    if (!line || !line.trim())
+        return;
+    const p = tuiHistoryPath(homeOverride);
+    try {
+        mkdirSync(dirname(p), { recursive: true });
+        // atomic fsync 避免 crash 留半行 (appendFileSync 自带 fsync)
+        appendFileSync(p, line + '\n');
+    }
+    catch {
+        /* best-effort, 不污染主路径 */
+    }
+}
+/**
+ * LRU 截断 (跟 D-22.1 1:1 同步, 避免无限增长).
+ * 暴露给测试用.
+ */
+export function tuiHistoryTruncate(lines, max = TUI_HISTORY_MAX) {
+    if (lines.length <= max)
+        return lines;
+    return lines.slice(-max);
+}
+//# sourceMappingURL=tui-history.js.map

package/dist/util/tui-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-history.js","sourceRoot":"","sources":["../../src/util/tui-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC;;;;;GAKG;AACH,SAAS,cAAc,CAAC,YAAqB;IAC3C,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,YAAY,CAAA;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IACzC,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IACrC,kEAAkE;IAClE,mEAAmE;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IAC9C,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,WAAW,CAAA;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACpC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAA;IACpD,OAAO,OAAO,EAAE,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,YAAqB;IAClD,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAqB;IAClD,MAAM,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;IACtC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC5D,0DAA0D;QAC1D,OAAO,KAAK,CAAA;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,YAAqB;IAClE,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAM;IACjC,MAAM,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;IACtC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,sDAAsD;QACtD,cAAc,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAA;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAe,EAAE,MAAc,eAAe;IAC/E,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAA;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC"}

package/dist/verify/format-report.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @deepwhale/coding-agent — Verify report formatter
+ *
+ * Sprint 1c-revive-2-D-11 (2026-06-04): 把 `VerificationReport` 渲染成人类可读文本.
+ * REPL `/verify` 跟 CLI `deepwhale --verify` 都用这个 formatter, 风格统一.
+ *
+ * 拍板 (D-11, 2026-06-04):
+ *   - 简洁优先, 跟 REPL greeting / goodbye 风格一致
+ *   - 每步 1 行 status, 失败时附带 tail
+ *   - 不打印 key, 不打印 session 路径, 不打印 .env 路径
+ *   - summary 跟 nextSuggestedAction 由 formatter 拍 (跟 D-11 拍板 "runner 纯函数,
+ *     formatter 写自然语言" 一致)
+ *
+ * @module @deepwhale/coding-agent/format-report
+ */
+import type { VerifyCheckResult, VerifyCheckStatus, VerificationReport } from './verify-runner.js';
+/**
+ * 把 `VerificationReport` 渲染成多行文本.
+ *
+ * 风格:
+ *   deepwhale verify — pass (1m 23s)
+ *
+ *   ✓ build    12.3s
+ *   ✓ lint      4.1s
+ *   ✗ test     67.0s  (exit 1)
+ *     stderr tail:
+ *     ...last 8 lines of stderr...
+ *
+ *   Summary: 1/4 checks failed (test exit 1).
+ *   Next: re-run after fixing failing test, or see /tmp/deepwhale-verify.log.
+ *
+ * @param report `runVerify()` 返回的报告
+ * @param options.verbose 默认 false. true 时**不**截断 stdout/stderr 印全 (单测 debug 用)
+ */
+export interface FormatReportOptions {
+    verbose?: boolean;
+    /** stderrTail / stdoutTail 印几行. 默认 8. */
+    tailLines?: number;
+    /** 报告写入文件路径建议 (显示在 nextSuggestedAction 里). 不传不写. */
+    logFilePath?: string;
+}
+export declare function formatReport(report: VerificationReport, options?: FormatReportOptions): string;
+/**
+ * 简化 summary 跟 nextSuggestedAction — 之前 runner 留空, formatter 拍.
+ * 拍板 (D-11, 2026-06-04): summary 给"X/Y pass", nextSuggestedAction 给 fix 提示.
+ */
+export declare function buildSummaryAndNext(report: VerificationReport, options?: {
+    logFilePath?: string;
+}): {
+    summary: string;
+    nextSuggestedAction: string;
+};
+/** @internal — 单步 status helper, 跟 status 字段对齐. 单测用. */
+export declare function _checkStatusIcon(status: VerifyCheckStatus): string;
+/** @internal — 单测用: 提取 check 简短描述. */
+export declare function _describeCheck(c: VerifyCheckResult): string;
+//# sourceMappingURL=format-report.d.ts.map

package/dist/verify/format-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-report.d.ts","sourceRoot":"","sources":["../../src/verify/format-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAY5B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAkDR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAsBlD;AAmBD,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAElE;AAED,sCAAsC;AACtC,wBAAgB,cAAc,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAE3D"}

package/dist/verify/format-report.js

@@ -0,0 +1,128 @@
+/**
+ * @deepwhale/coding-agent — Verify report formatter
+ *
+ * Sprint 1c-revive-2-D-11 (2026-06-04): 把 `VerificationReport` 渲染成人类可读文本.
+ * REPL `/verify` 跟 CLI `deepwhale --verify` 都用这个 formatter, 风格统一.
+ *
+ * 拍板 (D-11, 2026-06-04):
+ *   - 简洁优先, 跟 REPL greeting / goodbye 风格一致
+ *   - 每步 1 行 status, 失败时附带 tail
+ *   - 不打印 key, 不打印 session 路径, 不打印 .env 路径
+ *   - summary 跟 nextSuggestedAction 由 formatter 拍 (跟 D-11 拍板 "runner 纯函数,
+ *     formatter 写自然语言" 一致)
+ *
+ * @module @deepwhale/coding-agent/format-report
+ */
+const STATUS_ICON = {
+    passed: '✓',
+    failed: '✗',
+    'timed-out': '⏱',
+    'spawn-error': '⚠',
+    // Sprint 1c-revive-2-D-11-4 review P2 修复: 新增 'aborted' 状态. 跟 spawn-error
+    // 视觉区分 (⚠ vs ⛔) 让 reviewer 一眼看到"被外部 signal 干掉" vs "spawn 失败".
+    aborted: '⛔',
+};
+export function formatReport(report, options = {}) {
+    const verbose = options.verbose ?? false;
+    const tailLines = options.tailLines ?? 8;
+    const lines = [];
+    // Header
+    const duration = formatDuration(report.durationMs);
+    const headerStatus = report.overallStatus === 'passed' ? 'pass' : 'FAIL';
+    lines.push(`deepwhale verify — ${headerStatus} (${duration})`);
+    lines.push('');
+    // 每步
+    for (const check of report.checks) {
+        const icon = STATUS_ICON[check.status];
+        const dur = formatDuration(check.durationMs);
+        const statusText = check.status === 'passed' ? '' : `  (${check.status}`;
+        const exitPart = check.exitCode !== null ? ` exit ${check.exitCode}` : '';
+        const closeParen = check.status === 'passed' ? '' : exitPart + ')';
+        lines.push(`  ${icon} ${check.name.padEnd(10)} ${dur}${statusText}${closeParen}`);
+        // 失败时附 tail
+        if (check.status !== 'passed') {
+            if (check.errorMessage) {
+                lines.push(`    error: ${check.errorMessage}`);
+            }
+            const stderrTail = tailLinesOf(check.stderrTail, tailLines);
+            if (stderrTail) {
+                lines.push(`    stderr tail:`);
+                for (const line of stderrTail.split('\n')) {
+                    lines.push(`    ${line}`);
+                }
+            }
+            if (verbose) {
+                const stdoutTail = tailLinesOf(check.stdoutTail, tailLines);
+                if (stdoutTail) {
+                    lines.push(`    stdout tail (verbose):`);
+                    for (const line of stdoutTail.split('\n')) {
+                        lines.push(`    ${line}`);
+                    }
+                }
+            }
+        }
+    }
+    lines.push('');
+    lines.push(`Summary: ${report.summary}`);
+    if (report.nextSuggestedAction) {
+        lines.push(`Next: ${report.nextSuggestedAction}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * 简化 summary 跟 nextSuggestedAction — 之前 runner 留空, formatter 拍.
+ * 拍板 (D-11, 2026-06-04): summary 给"X/Y pass", nextSuggestedAction 给 fix 提示.
+ */
+export function buildSummaryAndNext(report, options = {}) {
+    const total = report.checks.length;
+    const passed = report.checks.filter((c) => c.status === 'passed').length;
+    const summary = `${passed}/${total} checks ${report.overallStatus === 'passed' ? 'passed' : 'failed'}`;
+    let next;
+    if (report.overallStatus === 'passed') {
+        next = options.logFilePath
+            ? `all green; full log: ${options.logFilePath}`
+            : 'all green; ready to commit';
+    }
+    else {
+        const failed = report.checks.filter((c) => c.status !== 'passed');
+        const firstFailed = failed[0];
+        if (firstFailed?.status === 'timed-out') {
+            next = `investigate timeout in ${firstFailed.name} (${firstFailed.durationMs}ms)`;
+        }
+        else if (firstFailed?.status === 'spawn-error') {
+            next = `fix spawn error in ${firstFailed.name}: ${firstFailed.errorMessage ?? 'unknown'}`;
+        }
+        else {
+            next = `fix failing check: ${firstFailed?.name ?? '?'} (see stderr tail above)`;
+        }
+    }
+    return { summary, nextSuggestedAction: next };
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const s = ms / 1000;
+    if (s < 60)
+        return `${s.toFixed(1)}s`;
+    const m = Math.floor(s / 60);
+    const rem = Math.floor(s - m * 60);
+    return `${m}m ${rem}s`;
+}
+function tailLinesOf(s, n) {
+    if (s.length === 0)
+        return '';
+    const lines = s.split('\n');
+    if (lines.length <= n)
+        return s.trimEnd();
+    // 取最后 n 行, 然后 join 回 "\n" (不是 "," 也不是 "")
+    return lines.slice(-n).join('\n');
+}
+/** @internal — 单步 status helper, 跟 status 字段对齐. 单测用. */
+export function _checkStatusIcon(status) {
+    return STATUS_ICON[status];
+}
+/** @internal — 单测用: 提取 check 简短描述. */
+export function _describeCheck(c) {
+    return `${c.name} ${c.status} (${c.durationMs}ms, exit ${c.exitCode ?? 'null'})`;
+}
+//# sourceMappingURL=format-report.js.map

package/dist/verify/format-report.js.map

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

package/dist/verify/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @deepwhale/coding-agent — verify module entry
+ *
+ * 公开 runVerify + formatReport + 类型, 供 REPL `/verify` 跟 CLI `deepwhale --verify` 用.
+ */
+export { runVerify, detectContext, pickChecksForContext, resolveRunner, looksLikeSpawnError, type VerifyCheck, type VerifyCheckResult, type VerifyCheckStatus, type VerificationReport, type VerificationOverallStatus, type VerifyContext, type RunVerifyOptions, } from './verify-runner.js';
+export { formatReport, buildSummaryAndNext, type FormatReportOptions, } from './format-report.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/verify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}

package/dist/verify/index.js

@@ -0,0 +1,8 @@
+/**
+ * @deepwhale/coding-agent — verify module entry
+ *
+ * 公开 runVerify + formatReport + 类型, 供 REPL `/verify` 跟 CLI `deepwhale --verify` 用.
+ */
+export { runVerify, detectContext, pickChecksForContext, resolveRunner, looksLikeSpawnError, } from './verify-runner.js';
+export { formatReport, buildSummaryAndNext, } from './format-report.js';
+//# sourceMappingURL=index.js.map

package/dist/verify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verify/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GAQpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC"}