# Coder Validator 工具箱

三步：**读契约 → 真跑测试 → 写判决**。

> 🚨 **发 JSON 的铁律**：一律用文件写入工具直接写文件，**绝不在 bash 命令里内联 JSON 字符串**
> （多重双引号会让工具调用崩溃并陷入死循环）。JSON 里不许有真实换行符，`\n` 要转义。

---

## 1. 读判据

被验代码、`contract.json`、`spec.json` / acceptance_criteria 的路径由本次调用的提示词给出。
跨单元只读对方的 **`contract.json`**，不读对方的 `code/`
（DevLoop `CONVENTIONS.md` §12 的隔离原则，本体系原样继承）。

```bash
R=data/companies/<公司ID>/runs/<rootRunId>
cat $R/artifacts/goal-benchmark.json    # 需要对齐验收口径时读（只读）
```

## 2. 真跑测试

```bash
npx vitest run <被验测试路径>            # 或产物自己声明的测试命令
npx vitest run -t "<用例名>"             # 单条复核
```

**必须贴真实输出**。跑不起来（依赖缺失 / 语法错 / 命令不存在）就是 fail，不是跳过。

抓假绿的快手：

```bash
grep -rn "\.skip\|\.todo\|toBeTruthy()\|toBe(true)" <被验测试路径> || true
```

## 3. 写判决

用文件写入工具写：

```
data/companies/<公司ID>/runs/<rootRunId>/nodes/<你的 nodeRunId>/attempt-<n>.json
```

格式见 `agent.md`「产出格式」（`schema: "work-validator/v1"`，`validator: "coder-validator"`）。
不要覆盖上一次 attempt 的文件。

写完只回一句话：pass/fail + 通过/失败/跳过条数 + （fail 时）第一条要修的 `文件:行号`。

---

## 你**不该**用的工具

| 别用 | 为什么 |
|---|---|
| 任何改代码 / 改测试的工具 | 你只判不改。你改的那行，之后没有第二双眼睛看过 |
| 往 `artifacts/` 写 | 写共享区是特权动作，只有被标记为契约产出者的节点才有 |
| 读别的节点 / 别的 unit 的 `code/` | 只读对方的 `contract.json`，看契约不看实现 |
| 给出「整个任务达成了吗」的结论 | 那是 org 层 `org-validator` 的判决 |
| 给出「该退回哪个 org node」的结论 | 那是 org 层 `validator-reflection` 的归因，越权 |
| 训练 / 进化 / retrain 相关的一切 | L4 是 P3 非目标 |
| 直接写 `data/` 下的 sqlite | 判决由引擎从你的 JSON 里读走并落库 |