@deepwhale/coding-agent 1.0.0

package/dist/tools/registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Tool Registry — 6 工具的注册中心
+ *
+ * Sprint 0.2 范围：
+ * - register / get / list 基础 API
+ * - 默认注册全部 6 工具
+ * - name 重名启动时检测（pi #5316 教训）
+ *
+ * Sprint 1+ 扩展：
+ * - MCP / Plugin / Skill 注册入口（v1.5/v2.0）
+ * - 风险评级聚合（StormBreaker 用）
+ */
+import type { Tool, ToolName } from '../types.js';
+import type { SandboxRunner } from '../sandbox/types.js';
+export declare class ToolRegistry {
+    private tools;
+    /** 注册工具，重名抛错（pi #5316 教训） */
+    register(tool: Tool): void;
+    get(name: ToolName | string): Tool | undefined;
+    /** 严格获取 — 不存在抛错（v1.0 tool 路由用） */
+    require(name: ToolName | string): Tool;
+    list(): ReadonlyArray<Tool>;
+    size(): number;
+}
+/** Sprint 1c-revive-3-D-12 review P1 修复: 显式注入 sandboxRunner. */
+export interface CreateDefaultRegistryOptions {
+    /** 注入 BashTool 的 SandboxRunner. 不传 = LocalSandboxRunner (v1.0 行为). */
+    readonly sandboxRunner?: SandboxRunner;
+}
+/**
+ * 默认 6 工具的 registry 工厂
+ *
+ * Sprint 1c-revive-3-D-12 review P1 修复 (2026-06-05): 加 `sandboxRunner` 显式参数.
+ * 之前 `new BashTool()` 走默认 LocalSandboxRunner, `DEEPWHALE_SANDBOX=docker` 解析
+ * 出的 DockerSandboxRunner 不会进 tool loop. 修法: mode 调用点从 env 解析 runner 后
+ * 显式传入, 工具注册表跟 env 状态对齐.
+ */
+export declare function createDefaultRegistry(options?: CreateDefaultRegistryOptions): ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA6B;IAE1C,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAU1B,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS;IAI9C,kCAAkC;IAClC,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAQtC,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC;IAI3B,IAAI,IAAI,MAAM;CAGf;AAED,gEAAgE;AAChE,MAAM,WAAW,4BAA4B;IAC3C,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,YAAY,CAU9F"}

package/dist/tools/registry.js

@@ -0,0 +1,67 @@
+/**
+ * Tool Registry — 6 工具的注册中心
+ *
+ * Sprint 0.2 范围：
+ * - register / get / list 基础 API
+ * - 默认注册全部 6 工具
+ * - name 重名启动时检测（pi #5316 教训）
+ *
+ * Sprint 1+ 扩展：
+ * - MCP / Plugin / Skill 注册入口（v1.5/v2.0）
+ * - 风险评级聚合（StormBreaker 用）
+ */
+import { ReadFileTool } from './read-file.js';
+import { WriteFileTool } from './write-file.js';
+import { EditFileTool } from './edit-file.js';
+import { BashTool } from './bash.js';
+import { FindTool } from './find.js';
+import { GrepTool } from './grep.js';
+import { LocalSandboxRunner } from '../sandbox/local-runner.js';
+export class ToolRegistry {
+    tools = new Map();
+    /** 注册工具，重名抛错（pi #5316 教训） */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool name collision: '${tool.name}' already registered. ` +
+                `Extension tool 重名启动时检测（pi #5316 教训）`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** 严格获取 — 不存在抛错（v1.0 tool 路由用） */
+    require(name) {
+        const tool = this.get(name);
+        if (!tool) {
+            throw new Error(`Tool not found: '${name}'`);
+        }
+        return tool;
+    }
+    list() {
+        return Array.from(this.tools.values());
+    }
+    size() {
+        return this.tools.size;
+    }
+}
+/**
+ * 默认 6 工具的 registry 工厂
+ *
+ * Sprint 1c-revive-3-D-12 review P1 修复 (2026-06-05): 加 `sandboxRunner` 显式参数.
+ * 之前 `new BashTool()` 走默认 LocalSandboxRunner, `DEEPWHALE_SANDBOX=docker` 解析
+ * 出的 DockerSandboxRunner 不会进 tool loop. 修法: mode 调用点从 env 解析 runner 后
+ * 显式传入, 工具注册表跟 env 状态对齐.
+ */
+export function createDefaultRegistry(options = {}) {
+    const reg = new ToolRegistry();
+    const runner = options.sandboxRunner ?? new LocalSandboxRunner();
+    reg.register(new ReadFileTool());
+    reg.register(new WriteFileTool());
+    reg.register(new EditFileTool());
+    reg.register(new BashTool(runner));
+    reg.register(new FindTool());
+    reg.register(new GrepTool());
+    return reg;
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,6BAA6B;IAC7B,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,CAAC,IAAI,wBAAwB;gBACxD,qCAAqC,CACxC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAuB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAgB,CAAC,CAAC;IAC1C,CAAC;IAED,kCAAkC;IAClC,OAAO,CAAC,IAAuB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAQD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAwC,EAAE;IAC9E,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,kBAAkB,EAAE,CAAC;IACjE,GAAG,CAAC,QAAQ,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,QAAQ,CAAC,IAAI,YAAY,EAAE,CAAC,CAAC;IACjC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACnC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC7B,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC7B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools/write-file.d.ts

@@ -0,0 +1,18 @@
+/**
+ * write_file 工具 — 写入本地文件
+ *
+ * Sprint 0.2 范围：直接覆盖（不追加）
+ * Sprint 1 扩展：append 模式 + 原子写（write to tmp + rename）
+ *
+ * 风险：medium（覆盖原文件不可恢复）— v1.0 必须经用户确认（arch §2.2 决策）
+ */
+import type { ToolName } from '@deepwhale/core';
+import type { Tool, ToolInputSchema, ToolResult } from '../types.js';
+export declare class WriteFileTool implements Tool {
+    readonly name: ToolName;
+    readonly description = "Write content to a local file. Overwrites existing file. Requires user confirmation (medium risk).";
+    readonly risk: 'low' | 'medium' | 'high';
+    readonly schema: ToolInputSchema;
+    execute(input: Record<string, unknown>): Promise<ToolResult>;
+}
+//# sourceMappingURL=write-file.d.ts.map

package/dist/tools/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErE,qBAAa,aAAc,YAAW,IAAI;IACxC,QAAQ,CAAC,IAAI,EAAmB,QAAQ,CAAC;IACzC,QAAQ,CAAC,WAAW,wGACmF;IACvG,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAY;IAEpD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAO9B;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAuBnE"}

package/dist/tools/write-file.js

@@ -0,0 +1,47 @@
+/**
+ * write_file 工具 — 写入本地文件
+ *
+ * Sprint 0.2 范围：直接覆盖（不追加）
+ * Sprint 1 扩展：append 模式 + 原子写（write to tmp + rename）
+ *
+ * 风险：medium（覆盖原文件不可恢复）— v1.0 必须经用户确认（arch §2.2 决策）
+ */
+import { promises as fs } from 'node:fs';
+import { dirname } from 'node:path';
+export class WriteFileTool {
+    name = 'write_file';
+    description = 'Write content to a local file. Overwrites existing file. Requires user confirmation (medium risk).';
+    risk = 'medium';
+    schema = {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Absolute path to the file' },
+            content: { type: 'string', description: 'Full file content to write' },
+        },
+        required: ['path', 'content'],
+    };
+    async execute(input) {
+        const path = input['path'];
+        const content = input['content'];
+        if (typeof path !== 'string' || path.length === 0) {
+            return { success: false, content: '', error: 'invalid-input: path is required' };
+        }
+        if (typeof content !== 'string') {
+            return { success: false, content: '', error: 'invalid-input: content must be string' };
+        }
+        try {
+            await fs.mkdir(dirname(path), { recursive: true });
+            await fs.writeFile(path, content, 'utf8');
+            return {
+                success: true,
+                content: `Written ${content.length} bytes to ${path}`,
+                meta: { path, bytes: content.length },
+            };
+        }
+        catch (err) {
+            const e = err;
+            return { success: false, content: '', error: `io-error: ${e.message}`, meta: { path } };
+        }
+    }
+}
+//# sourceMappingURL=write-file.js.map

package/dist/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,YAAwB,CAAC;IAChC,WAAW,GAClB,oGAAoG,CAAC;IAC9F,IAAI,GAA8B,QAAQ,CAAC;IAE3C,MAAM,GAAoB;QACjC,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAClE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;SACvE;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA8B;QAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;QACnF,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;QACzF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,WAAW,OAAO,CAAC,MAAM,aAAa,IAAI,EAAE;gBACrD,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;aACtC,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,GAAkE,CAAC;YAC7E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1F,CAAC;IACH,CAAC;CACF"}

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/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, type VerifyCheck, type VerifyCheckResult, type VerifyCheckStatus, type VerificationReport, type VerificationOverallStatus, 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,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,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, } 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,GAOV,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC"}

package/dist/verify/verify-runner.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @deepwhale/coding-agent — Verify runner
+ *
+ * Sprint 1c-revive-2-D-11 (2026-06-04): `deepwhale --verify` 跟 REPL `/verify`
+ * 内部统一走 `runVerify()` — 跑 4 步真验证 (build / lint / typecheck / test),
+ * 不走 LLM, 不走 tool loop, 生成 `VerificationReport`.
+ *
+ * 设计拍板:
+ *   - 4 步默认: corepack pnpm build / lint / typecheck / test
+ *   - 用户可覆盖 checks (单测用) / cwd (单测 tmpdir) / signal (取消)
+ *   - 每步 spawn child_process 同步等 exit, **不**用 stream (避免长 stdout 卡 session)
+ *   - stdout/stderr 截断: 默认 4 KB 尾, 防止 session JSONL 撑爆
+ *   - timeout 默认 5 min/步, 总 timeout 默认 30 min (build+lint+typecheck+test 全跑)
+ *   - 任何一步 fail → 整体 fail, **不**继续后续步 (用户拍的 D-11 review: fail-fast
+ *     比继续跑节省时间, 而且后续步基于 build 产物, fail-fast 防止假绿)
+ *   - 不读 .env, 不动 LLM, 不调 tool loop — 真·本地 CLI
+ *
+ * 不变量 (跟 D-10c 集成测语义 hotfix 一脉相承):
+ *   - 不打印 / 不写 key 值
+ *   - 不做 ASCII-only sanitize
+ *   - 不读 .env 文件 (D-7 loadProjectEnv 是 caller 职责)
+ *   - 不依赖 LLM client (跑 verify 不需要 key)
+ *
+ * @module @deepwhale/coding-agent/verify-runner
+ */
+/** 单步验证配置. */
+export interface VerifyCheck {
+    /** 人类可读步骤名 (报告里显示). */
+    name: string;
+    /** 完整命令 (报告里显示). 例: "corepack pnpm build". */
+    command: string;
+    /** 实际 spawn 的 argv (不含 corepack, corepack 处理自动). */
+    args: ReadonlyArray<string>;
+    /** spawn cwd. 不传走 options.cwd / process.cwd(). */
+    cwd?: string;
+    /** 该步 timeout (ms). 不传走 options.defaultTimeoutMs / 300_000. */
+    timeoutMs?: number;
+}
+/** 单步结果. */
+export type VerifyCheckStatus = 'passed' | 'failed' | 'timed-out' | 'spawn-error' | 'aborted';
+export interface VerifyCheckResult {
+    name: string;
+    command: string;
+    status: VerifyCheckStatus;
+    /** spawn 退出码. spawn 失败或 timeout 时为 null. */
+    exitCode: number | null;
+    /** 该步 startedAt (epoch ms). */
+    startedAt: number;
+    /** 该步 endedAt (epoch ms). */
+    endedAt: number;
+    /** 该步 durationMs. */
+    durationMs: number;
+    /** stdout 末尾截断 (默认 4 KB). 永远不写原始大文件. */
+    stdoutTail: string;
+    /** stderr 末尾截断 (默认 4 KB). */
+    stderrTail: string;
+    /** spawn / abort 错时的 error.message. 否则 undefined. */
+    errorMessage?: string;
+}
+/** 整体报告. */
+export type VerificationOverallStatus = 'passed' | 'failed';
+export interface VerificationReport {
+    startedAt: number;
+    endedAt: number;
+    durationMs: number;
+    overallStatus: VerificationOverallStatus;
+    checks: ReadonlyArray<VerifyCheckResult>;
+    /** 一句话人类可读总结. */
+    summary: string;
+    /** 建议下一步. */
+    nextSuggestedAction: string;
+}
+export interface RunVerifyOptions {
+    /** 自定义 checks. 不传走默认 4 步. */
+    checks?: ReadonlyArray<VerifyCheck>;
+    /** 工作目录. 不传走 process.cwd(). */
+    cwd?: string;
+    /** 外部 AbortSignal (单测 / REPL / CLI 取消). */
+    signal?: AbortSignal;
+    /** 默认每步 timeout (ms). 默认 300_000 (5 min). */
+    defaultTimeoutMs?: number;
+    /** stdout/stderr 截断字节数. 默认 4096. */
+    stdoutCapBytes?: number;
+    /** 失败时是否继续. 默认 false (fail-fast). 单测可改. */
+    continueOnError?: boolean;
+}
+/**
+ * Sprint 1c-revive-2-D-11-4 review P1 修复: Windows 上 `corepack` 在 PATH 解析不到
+ * (Node `spawn('corepack', ...)` 在 Win32 默认走 CreateProcessW, 不接 .cmd shim).
+ * 实际 `where corepack` 只返 `corepack.cmd`. 修复: Win32 上把 'corepack' → 'corepack.cmd'.
+ *
+ * 设计: 接受 platform 参数, 默认用 process.platform, 单测可注入 'win32' 验证.
+ * 仅在 args0 严格 === 'corepack' 时转换; 其它可执行 (node / bash / .exe) 透传,
+ * 跟单测里 mock 各种 runner 的行为兼容.
+ */
+export declare function resolveRunner(args0: string, platform?: NodeJS.Platform): string;
+/**
+ * 判定 child close 时的 stderr / stdout 是不是 "启错" 文本 (Win32 shell:true
+ * 路径下, "命令不存在" / "No such file" 走 cmd.exe exit 1, 不会 sync spawn
+ * 抛). 跨 Win32 shell 启错模式: cmd.exe "X is not recognized" + PowerShell
+ * "term not recognized" + POSIX shell 偶发 (e.g. via /bin/sh -c) "No such
+ * file". 命中返 true, caller 报 'spawn-error' 跟 POSIX 语义对齐.
+ *
+ * 设计: 故意**不**用 ENOENT (Node child 不暴露), 也不查 PATH. 简单字符串匹配
+ * 几个高置信度关键词, 误伤率低. 留 D-20.8 用 stderr 双检 + Node fs.access
+ * 再强化.
+ *
+ * 拍板 (D-20.7.7, 2026-06-06): 保守匹配, 不命中普通命令 exit 1 (e.g. 编译失败,
+ * 测试 fail) 误报.
+ */
+export declare function looksLikeSpawnError(stdout: string, stderr: string, exitCode: number | null): boolean;
+/**
+ * 跑 4 步验证 (默认), 返回 `VerificationReport`.
+ *
+ * 拍板 (D-11, 2026-06-04):
+ *   - 任一 step 失败 → 整体 fail, **不**继续后续 step (fail-fast).
+ *     后续 step 基于 build 产物, 跑也是浪费; 而且 build fail 时 typecheck/test 必挂,
+ *     显式 fail-fast 比假绿更诚实.
+ *   - 步骤间**不**共享 stdout/stderr buffer: 每步清零 Buffer 防止污染.
+ *   - 返回的报告 `overallStatus` = 'failed' iff 任一 step status ∈ {failed, timed-out, spawn-error}.
+ *   - summary / nextSuggestedAction 由调用方 (REPL/CLI/format-report) 写.
+ *     runner 不写自然语言, 保持纯函数语义 (便于单测 / roundtrip).
+ */
+export declare function runVerify(options?: RunVerifyOptions): Promise<VerificationReport>;
+//# sourceMappingURL=verify-runner.d.ts.map