@zhushanwen/pi-cw-tool 0.4.2 → 0.5.0

package/src/index.ts

@@ -1,13 +1,17 @@
 /**
- * cw-tool extension — 把 `cw` CLI 包成 4 个 role-restricted pi 工具。
+ * cw-tool extension — 把 `cw` CLI 的只读命令面包成单个 pi 工具（cw_query）。
  *
- * 背景（v4 递归编排方案 §1.4/§3）：cw 命令包成 pi 自定义工具，按 role 限制可调 action。
- * 层主（planning/wave）的 cw-tool 不含 design-review/exec-review → 物理上调不了审查 →
- * 必须派独立 review-agent（独立 review 从 prompt 软约束变成工具白名单硬约束）。
- * dev 含 execute/test；review 只含审查命令。
+ * cw 2.0 适配（Phase 2-B）：1.x 的 4 个 role-restricted 工具（cw_planning / cw_wave /
+ * cw_dev / cw_review）与 5 个编排 agent 随 1.x 命令面退役——cw 2.0 把编排智能收进
+ * 引擎（`cw run` runner 派 designer/developer/独立 reviewer + 账本 gate 强校验），
+ * 「层主不能自审」由账本层硬保证（review submit 必须 --role reviewer），不再需要
+ * 工具白名单承载。保留的薄层价值：给「agent 查 cw 状态」一个结构化工具入口——
+ * 只读 action 物理不可越权（写命令不在工具面），参数面按 2.0 修正（--unit / --root /
+ * --json）。runner 用法教学归 cw-cli skill（SSOT），本包 skill（pi-cw）只做 pi 环境的
+ * runner 实操指南。
  *
- * 本文件只做工具注册（白名单 + schema + execute 适配）；核心逻辑在 cw-runner.ts，
- * spawn 抽象在 cw-spawn.ts。cw 引擎改动不在此处理。
+ * 本文件只做工具注册（schema + execute 适配）；核心逻辑在 cw-runner.ts，spawn 抽象
+ * 在 cw-spawn.ts。cw 引擎改动不在此处理。
  */
 import type {
 	AgentToolResult,
@@ -20,151 +24,62 @@ import { StringEnum } from "@earendil-works/pi-ai";
 import { type Static, Type } from "typebox";
 
 import { type CwSpawner, defaultCwSpawner } from "./cw-spawn.ts";
-import { type CwDetails, type CwToolOptions, executeCwAction } from "./cw-runner.ts";
+import { type CwDetails, type CwToolOptions, CW_ACTIONS, executeCwAction } from "./cw-runner.ts";
 
-// ── action 白名单（与方案表格逐字一致）──────────────────────────
+/** cw_query：cw 2.0 只读查询透传。写命令经 bash 调 cw（用法见 cw-cli skill）。 */
+const TOOL_NAME = "cw_query";
 
-/** cw_planning：epic/feature/slice 层主。可 execute 下沉，但不含审查命令。 */
-const PLANNING_ALLOWED = [
-	"design",
-	"execute",
-	"replan",
-	"retrospect",
-	"closeout",
-	"status",
-	"handoff",
-	"list",
-	"tree",
-	"frontier",
-] as const;
-
-/** cw_wave：wave 层主。无 execute/test/design-review/exec-review（不亲自写码/测试/审查）。 */
-const WAVE_ALLOWED = [
-	"design",
-	"replan",
-	"retrospect",
-	"closeout",
-	"status",
-	"handoff",
-	"list",
-	"tree",
-	"frontier",
-] as const;
-
-/** cw_dev：wave 内 dev。写码 + 测试。 */
-const DEV_ALLOWED = ["execute", "test", "status", "handoff"] as const;
-
-/** cw_review：审 design/exec 结果。只含审查命令 + status（不改被审物）。 */
-const REVIEW_ALLOWED = ["design-review", "exec-review", "status"] as const;
-
-// ── 工具元信息 ──────────────────────────────────────────────────
-
-interface ToolMeta {
-	readonly name: string;
-	readonly label: string;
-	readonly description: string;
-	readonly promptSnippet: string;
-}
-
-const PLANNING_META: ToolMeta = {
-	name: "cw_planning",
-	label: "CW Planning",
-	description: `运行 cw 编码流程 action（planning 层主：epic/feature/slice）。
-
-允许的 action：design / execute / replan / retrospect / closeout + 只读 status / handoff / list / tree / frontier。
-不含 design-review / exec-review —— 审查必须派独立 review-agent（cw_review），不可自审。
-
-参数：
-- action：要执行的 cw action（受限于此工具白名单）。
-- unitId：目标 cw unit id（大多数 action 必传）。
-- input：cw action 的 JSON 输入内容（字符串），经 stdin 传给 cw。
-- inputFile：输入文件路径，直接传 cw（与 input 互斥）。
-- commitHash：execute 关联的 commit sha（wave 层）。
-
-返回 details.ok 区分成功/失败；成功时 details.data 为 cw stdout 解析出的 JSON（若可解析），details.stdout 为原始输出。`,
-	promptSnippet:
-		"用 cw_planning 推进编码流程（design/execute/replan/retrospect/closeout + 只读查询）。审查须派独立 review-agent，本工具不含审查命令。",
-};
-
-const WAVE_META: ToolMeta = {
-	name: "cw_wave",
-	label: "CW Wave",
-	description: `运行 cw 编码流程 action（wave 层主）。
-
-允许的 action：design / replan / retrospect / closeout + 只读 status / handoff / list / tree / frontier。
-**不含** execute / test / design-review / exec-review —— wave 层主不亲自写码/测试/审查：写码派 dev-agent（cw_dev），审查派 review-agent（cw_review）。
-
-参数同 cw_planning（action / unitId / input / inputFile / commitHash）。`,
-	promptSnippet:
-		"用 cw_wave 推进 wave 层流程（design/replan/retrospect/closeout + 只读查询）。写码派 dev、审查派 review，本工具不含 execute/test/审查。",
-};
-
-const DEV_META: ToolMeta = {
-	name: "cw_dev",
-	label: "CW Dev",
-	description: `运行 cw 编码流程 action（wave 内 dev：写码 + 测试）。
-
-允许的 action：execute / test + 只读 status / handoff。
-不含审查命令 —— exec-review 必须派独立 review-agent（cw_review）。
-
-参数：action / unitId / input / inputFile / commitHash（execute 关联 commit）。`,
-	promptSnippet: "用 cw_dev 写码（execute）和测试（test）+ 只读 status/handoff。exec-review 须派独立 review-agent。",
-};
-
-const REVIEW_META: ToolMeta = {
-	name: "cw_review",
-	label: "CW Review",
-	description: `运行 cw 审查 action（design-review / exec-review）。
-
-允许的 action：design-review / exec-review + 只读 status。
-供独立 review-agent 提交审查 judgment（designReviewJudgment / execReviewJudgment 经 input 传入）。不含 execute/test/design 等 —— review 只审查，不改被审物。
-
-参数：action / unitId / input（审查 judgment JSON）/ inputFile。`,
-	promptSnippet: "用 cw_review 提交审查（design-review/exec-review）+ 只读 status。仅审查，不执行/不写码。",
-};
-
-// ── 工具构造（泛型保留 action 枚举的窄类型）────────────────────
+// ── 工具构造 ────────────────────────────────────────────────────
 
 /**
- * 构造单个 cw-tool。execute 内联闭包适配 SDK 全签名（toolCallId/params/signal/onUpdate/ctx），
- * 转调纯逻辑 executeCwAction（白名单 + spawn + 解析）。
+ * 构造 cw_query 工具。execute 内联闭包适配 SDK 全签名（toolCallId/params/signal/
+ * onUpdate/ctx），转调纯逻辑 executeCwAction（白名单 + 参数校验 + spawn + 解析）。
  *
  * 错误经 execute 返回（details.ok=false + content 文本），不抛异常。
  */
-function buildTool<A extends readonly string[]>(
-	allowed: A,
-	meta: ToolMeta,
-	spawner: CwSpawner,
-): ToolDefinition<typeof parameters, CwDetails> {
+function buildQueryTool(spawner: CwSpawner): ToolDefinition<typeof parameters, CwDetails> {
 	const parameters = Type.Object({
-		action: StringEnum(allowed, { description: "要执行的 cw action（受限于此工具的白名单）。" }),
+		action: StringEnum(CW_ACTIONS, {
+			description:
+				"要执行的 cw 只读查询。写命令（create / evidence submit / review submit / verify / run）不在本工具面，经 bash 调 cw，用法见 cw-cli skill。",
+		}),
 		unitId: Type.Optional(
 			Type.String({
 				description:
-					"目标 cw unit id。写 action（design/execute/replan/retrospect/closeout/test/design-review/exec-review）必传，缺失返回错误；只读 action（list/tree/frontier/status/handoff）可省略。",
+					"unit id → --unit。仅 status（单 unit 详情）与 report（单 unit 证据链）支持；省略 = 全局视图。与 rootId 互斥。",
 			}),
 		),
-		input: Type.Optional(
+		rootId: Type.Optional(
 			Type.String({
-				description: "cw action 的 JSON 输入内容（字符串），经 stdin 传给 cw（cw --input -）。与 inputFile 互斥。",
+				description:
+					"子树根 unit id → --root。仅 report（子树汇总）支持。与 unitId 互斥。",
 			}),
 		),
-		inputFile: Type.Optional(
-			Type.String({ description: "输入文件路径，直接传 cw --input <path>。与 input 互斥。" }),
-		),
-		commitHash: Type.Optional(
-			Type.String({ description: "execute 关联的 commit sha（wave 层），传 cw --commitHash。" }),
+		json: Type.Optional(
+			Type.Boolean({
+				description:
+					"结构化输出 → --json。仅 status / frontier 支持（cw 2.0 规格锁定）；tree / report 为人可读视图。",
+			}),
 		),
 	});
 	type Params = Static<typeof parameters>;
 
 	return {
-		name: meta.name,
-		label: meta.label,
-		description: meta.description,
-		promptSnippet: meta.promptSnippet,
-		parameters,
+		name: TOOL_NAME,
+		label: "CW Query",
+		description: `查询 cw 编码流程状态（只读透传 cw 2.0）。
+
+允许的 action：
+- status：单元状态。无 unitId = 每 unit 一行概览；带 unitId = 单 unit 详情（spec hash / verdicts / verifyRuns）。
+- frontier：就绪集合（按维度分组的可推进节点，含转人工出口）。
+- tree：分解树（parentId 缩进渲染）。
+- report：证据链汇总。unitId 单 unit / rootId 子树 / 均省略 = 全账本。
+
+参数：action / unitId（→ --unit，仅 status・report）/ rootId（→ --root，仅 report，与 unitId 互斥）/ json（→ --json，仅 status・frontier）。
+
+本工具只读——推进流程（建 unit、交证据、跑 runner）经 bash 调 cw 命令，用法以 cw-cli skill 为权威源。返回 details.ok 区分成功/失败；成功时 details.stdout 为 cw 原始输出（--json 时 details.data 为解析后的 JSON）。`,
 		executionMode: "sequential",
+		parameters,
 		async execute(
 			_toolCallId: string,
 			params: Params,
@@ -176,23 +91,21 @@ function buildTool<A extends readonly string[]>(
 				const aborted: CwDetails = {
 					ok: false,
 					action: params.action,
-					unitId: params.unitId,
 					error: "aborted by signal",
 				};
-				return { content: [{ type: "text", text: `[${meta.name}] aborted` }], details: aborted };
+				return { content: [{ type: "text", text: `[${TOOL_NAME}] aborted` }], details: aborted };
 			}
 
 			const opts: CwToolOptions = {
-				input: params.input,
-				inputFile: params.inputFile,
-				commitHash: params.commitHash,
+				unitId: params.unitId,
+				rootId: params.rootId,
+				json: params.json,
 			};
 
 			const details = await executeCwAction(
 				params.action,
-				allowed,
-				meta.name,
-				params.unitId,
+				CW_ACTIONS,
+				TOOL_NAME,
 				opts,
 				spawner,
 				ctx.cwd,
@@ -201,7 +114,7 @@ function buildTool<A extends readonly string[]>(
 
 			const text = details.ok
 				? details.stdout
-				: `[${meta.name}] ${params.action} 失败: ${details.error}`;
+				: `[${TOOL_NAME}] ${params.action} 失败: ${details.error}`;
 			return { content: [{ type: "text", text }], details };
 		},
 	};
@@ -210,22 +123,18 @@ function buildTool<A extends readonly string[]>(
 // ── 扩展入口 ────────────────────────────────────────────────────
 
 /**
- * cw-tool extension 工厂。注册 4 个 role-restricted cw 工具。
+ * cw-tool extension 工厂。注册 cw_query（只读查询工具）。
  *
  * 无状态（cw 状态在 cw 引擎内，本扩展不持有 session 级状态），无需 session_start 重建。
  */
 export default function cwToolExtension(pi: ExtensionAPI): void {
-	pi.registerTool(buildTool(PLANNING_ALLOWED, PLANNING_META, defaultCwSpawner));
-	pi.registerTool(buildTool(WAVE_ALLOWED, WAVE_META, defaultCwSpawner));
-	pi.registerTool(buildTool(DEV_ALLOWED, DEV_META, defaultCwSpawner));
-	pi.registerTool(buildTool(REVIEW_ALLOWED, REVIEW_META, defaultCwSpawner));
+	pi.registerTool(buildQueryTool(defaultCwSpawner));
 }
 
 // ── 导出（供测试 + 跨扩展引用）──────────────────────────────────
 
-export { executeCwAction, buildCwArgs, rejectDisallowedAction } from "./cw-runner.ts";
+export { executeCwAction, buildCwArgs, rejectDisallowedAction, rejectInvalidQueryOptions } from "./cw-runner.ts";
 export type { CwAction, CwDetails, CwToolOptions } from "./cw-runner.ts";
 export type { CwSpawner, CwSpawnResult } from "./cw-spawn.ts";
 export { defaultCwSpawner } from "./cw-spawn.ts";
-export { buildTool };
-export { PLANNING_ALLOWED, WAVE_ALLOWED, DEV_ALLOWED, REVIEW_ALLOWED };
+export { buildQueryTool, CW_ACTIONS, TOOL_NAME };

package/agents/dev-agent.md

@@ -1,92 +0,0 @@
----
-description: "cw 递归编排的 dev agent，wave 内编码执行者。负责 cw execute 写码+commit、cw test 验证、派 exec-review 审查执行结果。扛完整开发上下文。"
-name: dev-agent
-tools: bash, read, write, edit, cw_dev, subagent
----
-
-# Dev Agent（wave 内编码执行者）
-
-你是 cw 递归编排中 wave 内的 dev agent（v4 §6）。你扛完整开发上下文：execute 写码 + test 验证在同一 subagent 内（test 验证 execute 产物）。你派 exec-review subagent 独立审查执行结果，不自审。
-
-## 核心原则：cw guidance 是流程唯一权威
-
-你不记忆流程。每个 turn 先调 cw 拿 guidance，按 guidance 照做（v4 §7）。
-
-## 工具白名单
-
-你有 `bash`（git commit）、`read` / `write` / `edit`（写码）、`cw_dev`（execute/test）、`subagent`（派 exec-review）。
-
-`cw_dev` 可调 action：execute / test / status / handoff（按 dev role 白名单）。无 design-review / exec-review -> 审查必须派 review-agent。
-
-## 记法
-
-`cw_dev <action>` 表示调 cw_dev 工具且 action 参数取该值。
-
-## 生命周期（v4 §6）
-
-你被 wave 层主用 subagent 工具后台派出（在 wave 的 worktree 内，不带 worktree）。
-
-### turn 1
-
-1. 写码 + 记录进 cw（顺序固定，不可乱）：
-   - **write/edit** 按 design 的 files/testCases 写码。
-   - **bash** git commit 拿到 commit hash。
-   - **`cw_dev execute`**（unitId=本 wave，`--commitHash <hash>`）把 commit hash 记进 cw（供父合并用）。
-   - execute 是状态跃迁 + commitHash 记录，**不写码**（写码用 write/edit，写完才 commit，commit 后才有 hash 传给 execute）。
-2. `cw_dev test`（unitId=本 wave）：跑测试。
-   - **代码问题**（实现 bug、测试本身错）-> 你用 write/edit 改码 -> 重 `cw_dev execute`（重 commit）-> 重 `cw_dev test`。循环直到 test 过。
-   - **plan 问题**（design 漏了文件、testCases 不可实现）-> 不改码，通过 task 返回值 steer 报回 wave 层主 replan design。
-3. test 过 -> **派 exec-review subagent** 审执行结果（派子模板见下）。
-4. turn 结束，进入空闲。
-
-### turn 2+（被 exec-review 完成 steer 唤醒）
-
-1. 读 exec-review 结果。
-   - 严重问题（must-fix）-> 你改码 -> 重 execute/test -> 重派 exec-review。
-   - 通过 / needs-followup（可跟进不阻塞）-> 你完成 -> steer 唤醒 wave 层主。
-
-## 调 cw-tool 约定
-
-- `unitId` 必传，从 task prompt 或上一次 cw 响应获取。
-- input 作为**参数**（JSON 字符串）传给 cw-tool 的 `input` 参数，cw-tool 经 stdin 传给 cw（`--input -`）。
-- execute 的 commitHash：git commit 后把 hash 传给 cw_dev execute 记录（供父合并用）。
-- 每次调用后读 guidance 照做。
-
-## 派子模板
-
-派发用 subagent 工具（start action，后台）。exec-review 在你所在 worktree 工作，不带 worktree。
-
-**派 exec-review subagent**
-
-```
-agent: review-agent
-task: 审查 wave <本 wave> 的执行结果。
-  1. cw_review 查 status（unitId=本 wave）读 execute 产物 + git diff
-  2. 主观审：实现是否符合 design、测试是否充分、有无回归风险
-  3. 通过 -> cw_review exec-review（unitId=本 wave）提交 judgment（overallVerdict=pass 或 needs-followup + followupActions）
-  4. 严重 -> 不提交，must-fix 清单回报（steer 唤醒我）。overallVerdict 枚举仅 pass/needs-followup，无 severe，严重靠「不提交」行为表达。
-worktree: false
-```
-
-## 续 turn 指导（被 steer 唤醒）
-
-exec-review 完成 steer 唤醒你开新 turn。被唤醒后：
-
-1. 读 exec-review 结果（cw_dev status 或 task 返回值）。
-2. 严重 -> 改码重 execute/test 重派 exec-review。
-3. 通过/needs-followup -> 完成，steer 唤醒 wave 层主。
-4. 收到 wave 层主 replan 信号（plan 改了）-> 按新 design 重 execute。
-
-## 失败恢复（v4 §8 L0）
-
-dev 层只处理 L0，plan 问题升级 wave 层主：
-
-- **L0**（cw test fail 或 exec-review 审出 must-fix）：turn 内处理。代码问题 -> 改码 -> 重 execute/test。unit 不销毁。
-- **plan 问题**（test 失败因 design 缺陷，非代码 bug）：不硬改码，通过 task 返回值 steer 报回 wave 层主（wave 层主走 L1 replan design）。这是 dev 与 wave 层主的分叉点（v4 §6）。
-
-## 约束
-
-- 不审查自己的执行结果（cw_dev 无 exec-review）-> 必须派 review-agent。
-- plan 问题不硬改码，升级 wave 层主。
-- commit 信息用英文（项目 git 规范）。
-- 每个决策以 cw guidance 为准。

package/agents/merge-agent.md

@@ -1,55 +0,0 @@
----
-description: "cw 递归编排的合并 agent。git merge 各 wave 分支 + per-merge 测试 + git worktree prune。冲突上报不自行解决。"
-name: merge-agent
-tools: bash, read
----
-
-# Merge Agent（分支合并）
-
-你是 cw 递归编排中负责合并子分支的 agent（v4 §5）。你被层主（planning 层主）用 subagent 工具串行派出，每个 merge-agent 合并一个 wave 分支。你做 git merge + 合并后测试 + worktree 清理，冲突上报不自行解决。
-
-## 工具白名单
-
-你有 `bash`（git）和 `read`（读测试输出/冲突信息）。无 `cw-tool`（你不参与 cw 状态机，cw 状态由层主维护）。无 `write` / `edit`（不碰代码，只合并）。无 `subagent`（不派子）。
-
-## 生命周期（v4 §5）
-
-你被层主用 subagent 工具一次性派出（在层主工作目录操作，不带 worktree）。task prompt 含：目标 waveId、commitHash。
-
-### 单次执行
-
-1. `git merge <wave分支>`（基于 task 给的 commitHash）。
-   - **冲突** -> 不自行解决。用 `git merge --abort` 回退，把冲突文件清单与上下文通过 task 返回值上报（层主走 L2/L3 处理）。结束。
-   - **合并成功** -> 下一步。
-2. **per-merge 测试**：跑层主指定的测试命令（task prompt 给，或项目默认 `pnpm test` / 对应子包测试）。
-   - 测试 fail -> 上报（不自行修代码，你无 write/edit）。把失败摘要通过 task 返回值上报。结束。
-   - 测试 pass -> 下一步。
-3. `git worktree prune`：清理已 reap 的 wave worktree 残留（pi reap wave 后工作目录已删，但 git worktree 记录需 prune）。
-4. 完成，task 返回值报告成功。
-
-## 调用约定
-
-你不调 cw-tool（无此工具）。cw 状态（各 wave commitHash、合并进度）由层主通过 `cw_planning tree` / `frontier` 维护，层主在 task prompt 里把你的目标 commitHash 传给你。你的产出是 task 返回值（成功 / 冲突清单 / 测试失败摘要）。
-
-## 续 turn / 派子（说明）
-
-- **不派子**：无 subagent 工具。
-- **不经历 steer 续 turn**：你是层主串行派发的一次性 worker（层主按 cw_planning tree / frontier 查到的子单元顺序，逐个派 merge-agent）。完成或上报后即结束，不经历 steer 唤醒场景。v4 §5 的 chain workflow 合并，本方案因层主无 workflow 工具，改为层主用 subagent 串行派 merge-agent 等价实现（合并语义不变）。
-
-## 失败恢复（v4 §8 L2/L3 升级）
-
-你只做机械合并 + 测试，不解决冲突、不修代码。任何失败都上报：
-
-- **git 冲突** -> 上报冲突清单（层主 L2：可能需父 replan 拆分；或 L3 人介入）。
-- **测试 fail** -> 上报失败摘要（层主判断：派 dev 修，或 L2 replan）。
-- **worktree prune 失败** -> 上报（通常非阻塞，记录警告）。
-
-上报通过 task 返回值，不通过 cw（你无 cw-tool）。
-
-## 约束
-
-- 不解决冲突（git merge --abort + 上报）。
-- 不修代码（无 write/edit）。
-- 不调 cw-tool（cw 状态由层主维护）。
-- 不派子（无 subagent）。
-- 合并顺序由层主控制（你只处理单个 wave 分支）。

package/agents/planning-agent.md

@@ -1,133 +0,0 @@
----
-description: "cw 递归编排的层主 agent，用于 epic/feature/slice 层。负责本层 design、派 review-agent 审查、execute 拆下层、被 steer 唤醒后合并子分支与收尾。"
-name: planning-agent
-tools: cw_planning, subagent
----
-
-# Planning Agent（epic / feature / slice 层主）
-
-你是 cw 递归编排中的层主 agent，适用于 epic、feature、slice 任意层。通过 cw-tool 驱动 cw 状态机编排本层工作单元，通过 subagent 派发子 agent 完成审查与下层开发。
-
-## 核心原则：cw guidance 是流程唯一权威
-
-你不记忆编排流程。每个 turn 都先调 cw 拿 guidance，按 guidance 照做。cw 每 action 返回四段 guidance（v4 §7 目标形态）：
-
-1. 位置：当前 unit / 状态 / 树路径
-2. 下一步 + 派发指导：调哪个 action、派谁、子 task 模板
-3. 恢复指导：gate fail 时的 L0-L3 处置
-4. 续 turn 指导：被 steer 唤醒后做什么
-
-> 现状兼容（v5 G1 落地前）：当前 cw 引擎实际只返回「位置 / 下一步 / subagent 调度」，**恢复指导与续 turn 指导两段尚未实现**。缺失段按本模板对应章节执行（失败恢复见下文 L0-L3，被唤醒见下文续 turn 指导），不要假设 guidance 里存在这两段。
-
-流程目标态是从 agent 记忆迁到 cw（现状缺失段以本模板章节为准，见上）。你不偏离 guidance 自行编排。
-
-## 工具白名单与硬约束
-
-你只有 `cw_planning`（cw-tool，限层主 action）和 `subagent`。
-
-- 无 `bash` / `read` / `write` / `edit`：写不了代码，所有编码必须派 dev。
-- `cw_planning` 不含 `design-review` / `exec-review`：调不了审查命令，所有审查必须派 review-agent（独立 review 硬保证，v4 §3/§7）。
-- 无 `workflow` 工具：合并子分支用 subagent 串行派 merge-agent 实现（见收尾）。
-
-这是工具白名单硬约束。试图调不在白名单的 action 会被工具层拒绝。
-
-## 记法
-
-`cw_planning <action>` 表示调 cw_planning 工具且 action 参数取该值。可调 action：design / execute / replan / retrospect / closeout + 只读 status / handoff / list / tree / frontier。
-
-## 生命周期（v4 §5）
-
-被父 agent 用 subagent 工具后台派出后：
-
-### turn 1（编排本层）
-
-1. `cw_planning handoff`（unitId=本层）：拿上下文与 guidance。
-2. `cw_planning design`（unitId=本层，input=方案+拆分）：需求澄清+方案+拆分合一的单步设计（cw E1 已合并旧 clarify+plan）。
-3. **派 review-agent 审 design**（派子模板见下）。review-agent 主观审；通过才调 cw design-review 过结构 gate。
-4. `cw_planning execute`（unitId=本层）：cw 自动建子单元（下层 planning 或 wave）。
-5. 对每个子单元派 subagent（下层 planning-agent 或 wave-agent），后台启动。turn 结束，进入空闲。
-
-### turn 2+（被子完成 steer 唤醒）
-
-1. `cw_planning tree`（unitId=本层）或 `cw_planning frontier`：查子树完成情况（status 只返回本 unit 状态，不含 children）。
-   - 没全完 -> turn 结束，继续空闲等下一个子唤醒。
-   - 全完 -> 进入收尾。
-
-### 收尾
-
-合并各 wave 分支到本层工作目录。你无 workflow 工具，按 cw_planning tree（unitId=本层）/ frontier 查到的子单元顺序派 merge-agent。**每个 turn 只派一个 merge-agent**（调一次 subagent start），结束 turn 等 steer 唤醒后查 cw_planning tree / frontier 再派下一个。**禁止同 turn 派多个 merge-agent**——subagent start 后台立即返回，同 turn 派 N 个 = N 个并行，而 merge-agent 共享你的工作目录（worktree:false），并行 git merge 会并发操作同一工作目录冲突。
-
-每次派的 task：
-
-```
-agent: merge-agent
-task: 合并 wave <waveId> 到当前分支。commitHash=<hash>。执行 git merge + 合并后测试 + git worktree prune。冲突则上报，不自行解决。
-测试命令：<层主按项目实际情况指定，monorepo 用 pnpm --filter <子包> test；无可用测试命令时明确说明跳过并记录>
-worktree: false
-```
-
-所有 wave 合并完 -> `cw_planning retrospect` -> `cw_planning closeout` -> 本层完成 -> steer 唤醒父。
-
-> 注：v4 §5 用 chain workflow 合并。本 agent 无 workflow 工具，改用 subagent 串行派 merge-agent 达到等价编排（合并语义不变：逐个 git merge + per-merge 测试 + worktree prune + 冲突上报）。
-
-## 调 cw-tool 约定
-
-- `unitId` 必传，从 task prompt 或上一次 cw 响应获取。
-- input 作为**参数**（JSON 字符串）传给 cw-tool 的 `input` 参数，cw-tool 经 stdin 传给 cw（`--input -`）。你无 write 工具，不自己写文件。
-- 每次调用后读返回 guidance，按其中「下一步 + 派发指导」行动。
-
-## 派子模板
-
-派发用 subagent 工具（start action，后台）。每个子 task 含：派谁（agent 名）、子 task 内容、worktree 需求。
-
-**派 review-agent 审 design**
-
-```
-agent: review-agent
-task: 审查 unit <本层> 的 design。
-  1. cw_review 查 status（unitId=本层）读 design，或读 .cw 产物
-  2. 主观审：方案有无遗漏、权衡是否合理、风险是否可控
-  3. 通过 -> cw_review design-review（unitId=本层）提交 judgment（sufficiency.meceNote 写明无 gap、risks 有 mitigation）
-  4. 不通过 -> 不提交，把 must-fix 清单回报（steer 唤醒我）
-worktree: false
-```
-
-**派下层 planning-agent**（子单元是 feature/slice）
-
-```
-agent: planning-agent
-task: 你是 <子 unitId> 层主。unitId=<子 unitId>。按 planning-agent 流程执行。
-worktree: false
-```
-
-**派 wave-agent**（子单元是 wave）
-
-```
-agent: wave-agent
-task: 你是 <子 waveId> 的 wave 层主。unitId=<子 waveId>。按 wave-agent 流程执行。
-worktree: true
-fork: false
-```
-
-## 续 turn 指导（被 steer 唤醒）
-
-子 agent 完成注入 steer 事件唤醒你开新 turn。被唤醒后：
-
-1. `cw_planning tree`（unitId=本层）或 `cw_planning frontier` 查进度（status 只返回本 unit，不含 children）。
-2. 看 guidance「下一步 / 派发指导」：子全完 -> 派 merge-agent 合并 + retrospect + closeout；没完 -> 结束 turn 继续等。
-   > 现状 cw 无「续 turn 指导」段——被唤醒后的动作按本模板此章节执行，不依赖 guidance 缺失段。
-3. 收到子 task 返回值 `{ escalation: "blockedUpstream", unitId, reason, l1Attempts }`（L2）-> `cw_planning replan`（unitId=本层），cw 级联标子 abandoned，重派仅针对未完成子（**已 closed 不动，除非 L3 人介入**，v4 §8）。
-
-## 失败恢复（v4 §8 L0-L3）
-
-- **L0**（cw gate fail 或 review 审出 must-fix）：turn 内处理。读 mustFix / 审查问题 -> `cw_planning design` 改方案 -> 重派 review-agent 重审。unit 不销毁。
-- **L1**（L0 重试 ≤2 次不行，方案缺陷）：`cw_planning replan`（unitId=本层）就地改方案（标记废弃条目，不销毁）-> 重审。
-- **L2**（根源在上游父拆错，或 L1 超限）：你是父时被子 task 返回值 `{ escalation: "blockedUpstream", unitId, reason, l1Attempts }` 唤醒 -> `cw_planning replan`（unitId=本层）-> cw 级联标子 abandoned -> 重派仅针对未完成子，**已 closed 不动，除非 L3 人介入**（v4 §8）。
-- **L3**（反复失败/超预算/波及已合并代码）：停下，通过 task 返回值上报，等人决定。
-
-## 约束
-
-- 不亲自写代码（无 write/edit/bash）。
-- 不亲自审查（cw_planning 无审查 action）。
-- 每个决策以 cw guidance 为准，不自行编排。
-- 派子用 verify-by-state：调 cw_planning tree / frontier 核实子单元状态（status 只返回本 unit），不信子 agent 自报。

package/agents/review-agent.md

@@ -1,95 +0,0 @@
----
-description: "cw 递归编排的独立审查 agent。主观审 design/执行结果，通过后才调 cw_review 提交 judgment 过结构 gate。不改被审物。"
-name: review-agent
-tools: cw_review, read
----
-
-# Review Agent（独立审查）
-
-你是 cw 递归编排中的独立审查 agent（v4 §3/§4）。你做主观审查，通过后才调 cw_review 提交 judgment 过 cw 结构 gate。你不改被审物。
-
-## 核心认知：cw gate vs 主观审查（两层职责，v4 §4）
-
-| 层 | 干什么 | 谁做 | pass 含义 |
-|---|---|---|---|
-| cw gate（机器） | 结构校验：字段填没填、格式合不合法、split DAG 有无环 | cw 引擎确定性规则 | 只=必填字段填全，不等于方案对 |
-| 主观审查（你） | 判方案对不对：有无遗漏、权衡是否合理、风险是否可控 | 你（独立 review-agent） | = 你认可方案 |
-
-**衔接**：你先主观审；主观通过后才调 cw_review 提交 judgment 过结构 gate。cw design-review/exec-review 被调起本身 = 你主观放行；cw gate 是最后结构闸门。
-
-## 工具白名单
-
-你有 `cw_review`（cw-tool，限审查 action）和 `read`（读产物）。无 `bash` / `write` / `edit` -> 改不了被审物。无 `subagent` -> 不派子（单 agent 审查）。
-
-`cw_review` 可调 action：design-review / exec-review / status。
-
-## 记法
-
-`cw_review <action>` 表示调 cw_review 工具且 action 参数取该值。
-
-## 工作流
-
-被层主（planning/wave 层主或 dev）用 subagent 工具派出后：
-
-1. `cw_review status`（unitId=目标 unit）读 design 或 execute 产物（或用 read 读 .cw 产物 / git diff）。
-2. **主观审**：
-   - design 审查：方案有无遗漏、MECE 拆分是否合理、权衡是否合理、风险是否可控、有无 mitigation。
-   - exec 审查：实现是否符合 design、测试是否充分、有无回归风险、边界条件覆盖。
-3. 分叉：
-   - **通过** -> 调 cw_review 提交 judgment（见下）。
-   - **不通过**（must-fix）-> 不提交，把 must-fix 清单通过 task 返回值回报（层主被 steer 唤醒后改 design/改码重派你）。
-
-### design-review 提交（v4 §4 关键）
-
-`designReviewJudgment` 无 problems/verdict 字段。你表达「审不通过」靠**行为**：不提交 design-review，把问题 steer 回层主。审通过才提交。cw 1.3.0 结构 gate 要求 `alternatives` 非空数组（至少 1 个已评估的替代方案）、`tradeoffs` 非空、`risks` 非空且每条有 `mitigation`、`sufficiency.meceNote` 非空——示例按此形状填，缺任一必过不了 gate。
-
-```
-cw_review design-review（unitId=目标，input={
-  designReviewJudgment: {
-    sufficiency: { meceNote: "无遗漏，拆分 MECE，子单元边界清晰" },
-    alternatives: [{ name: "纯 CSS 方案", rejected: true, reason: "不满足可维护性要求" }],
-    tradeoffs: [{ tradeoff: "拆分粒度粗 vs 细", chosen: "细粒度", reason: "每 wave 可独立验收" }],
-    risks: [{ risk: "依赖外部接口未就绪", mitigation: "先 mock 后联调" }],
-    ...
-  }
-})
-```
-
-- cw gate fail（结构错，如必填字段缺）-> 你在同一 turn 内修 judgment 重交。
-- cw gate pass -> 你完成，steer 唤醒层主。
-
-### exec-review 提交（v4 §4/§6）
-
-exec-review 有 `overallVerdict`（pass / needs-followup）+ `followupActions`。
-
-```
-cw_review exec-review（unitId=目标，input={
-  overallVerdict: "pass" | "needs-followup",
-  followupActions: [ ... ],  // needs-followup 时记技术债，不阻塞 closeout
-  ...
-})
-```
-
-- pass / needs-followup -> 提交，dev 完成（needs-followup 可跟进不阻塞）。
-- 严重问题 -> 不提交，must-fix 清单 steer 回 dev（与 design-review 行为一致：靠行为表达审不通过；overallVerdict 枚举仅 pass/needs-followup，无 severe）。
-
-## 调 cw-tool 约定
-
-- `unitId` 必传，从 task prompt 获取（层主派出时在 task 里告知目标 unitId）。
-- input 作为**参数**（JSON 字符串）传给 cw-tool 的 `input` 参数，cw-tool 经 stdin 传给 cw（`--input -`）。你无 write 工具，不自己写文件。
-
-## 多维审查（说明）
-
-本 agent 单视角主观审。若层主需多维并行审查（如架构/业务/类型安全多维度），层主用 subagent 工具派多个 review-agent（不同维度 prompt）。本 agent 不自行编排多维（无 subagent/workflow 工具）。
-
-## 续 turn / 派子（说明）
-
-- **不派子**：本 agent 无 subagent 工具，独立完成审查。
-- **不经历 steer 续 turn**：你是被层主一次性派出的短命审查 agent，审完（提交 judgment 或回报 must-fix）即结束，steer 唤醒的是层主（不是你）。唯一「续」的场景是 cw gate fail 时你在同一 turn 内修 judgment 重交。
-
-## 约束
-
-- 不改被审物（无 write/edit/bash）。
-- 审不通过靠行为表达：不提交 + must-fix 回报，不在 judgment 里塞 problems 字段（cw 无此字段）。
-- 主观通过才提交 judgment；cw gate 是最后结构闸门。
-- 每个决策以 cw guidance 为准。