# $status YAML Schema 参考（CAS 节点 2C1TEMP0YAHN9）

## 权威来源
CAS 节点 `2C1TEMP0YAHN9`（CBOR 编码），可用以下命令查看：
```bash
pip3 install cbor2
python3 -c "
import cbor2, json
d = cbor2.loads(open('/home/maggie/.ocas/nodes/2C1TEMP0YAHN9.bin','rb').read())
print(json.dumps(d['payload']['oneOf'], indent=2, ensure_ascii=False))
"
```

## 字段名确认为 `$status`（带 `$` 前缀）

CAS schema 中 `properties.$status.const` 确认字段名就是 `$status`，不是 `status`。

## `$status: pass` 变体（5 个必填字段）

| 字段 | 类型 | 必填 |
|------|------|------|
| `$status` | const: "pass" | ✅ |
| `contract_file` | string | ✅ |
| `original_filename` | string | ✅ |
| `special_deliverables` | string | ✅ |
| `review_round` | integer | ✅ |
| `notes` | string | 可选 |

## `$status: needs_revision` 变体（11 个必填字段）

| 字段 | 类型 | 必填 |
|------|------|------|
| `$status` | const: "needs_revision" | ✅ |
| `contract_file` | string | ✅ |
| `original_filename` | string | ✅ |
| `ruleset_type` | string | ✅ |
| `rules_paths` | string | ✅ |
| `our_party_name` | string | ✅ |
| `our_party_role` | string | ✅ |
| `special_deliverables` | string | ✅ |
| `review_round` | integer | ✅ |
| `issues_json` | string | ✅ |
| `issue_count` | integer | ✅ |

## `$status: failed` 变体（2 个必填字段）

| 字段 | 类型 | 必填 |
|------|------|------|
| `$status` | const: "failed" | ✅ |
| `error` | string | ✅ |

## 恢复命令
```bash
uwf thread resume <thread-id> -p "YAML frontmatter must use '\$status: pass' (with dollar sign). Fix and continue."
```

## 注意
- 旧版（2026-06-26 早期）的"使用 `status` 不用 `$status`"结论是错误的——那是基于 LLM 推测，不是 CAS schema 实证
- 此文件 2026-06-26 已通过 CBOR 解析 CAS 节点实证修正