@hunter-harness/workflow-harness 0.2.54 → 0.2.56

package/harness/bundles/general/claude-code/harness-test/reference.md

@@ -740,7 +740,7 @@ TEST_<change-name>_<timestamp>_<short-random>
 ```powershell
 # gate begin/close（phase=test；--task 仅 checkpoint 启用时必需；close 不需要 --skills-root）
 python <skills-root>/scripts/harness_gate.py begin --change <cn> --phase test --skills-root <skills-root> [--task N]
-python <skills-root>/scripts/harness_gate.py close --change <cn> --phase test --status OK [--task N]
+python <skills-root>/scripts/harness_gate.py close --change <cn> --phase test --status OK --to-phase <plannedPhases 中 test 的后继> --executor <tool> [--task N]
 
 # ledger 记录 / 复用（--profile-input = verification key，不是文件路径）
 python <skills-root>/scripts/harness_ledger.py record --change-dir <dir> --verification unitTestFull --status ok --command "<完整命令>" --exit-code 0 --duration-ms 120000 --evidence "Tests run: N, Failures: 0" --coverage full --files "packages/core/src/index.ts"
@@ -851,7 +851,7 @@ python <skills-root>/scripts/harness_ledger.py can-reuse --change-dir <dir> --ve
 python <skills-root>/scripts/harness_ledger.py diff-hash --repo . --base <baseCommit> --change-dir ".harness/changes/<change-name>" --json
 ```
 
-写入 `.harness/changes/<change>/evidence/verification-ledger.json`：
+通过 `harness_ledger.py record` 写入 state layout resolver 返回的 `evidence/verification-ledger.json`：
 
 ```json
 {

package/harness/bundles/general/claude-code/protocols/ledger-protocol.md

@@ -21,10 +21,10 @@ verification-ledger 把每次验证（compile / unit test / api test / package
 ## 二、账本文件位置
 
 ```text
-.harness/changes/<change-name>/evidence/verification-ledger.json
+<resolved-change-state>/evidence/verification-ledger.json
 ```
 
-> 旧路径 `.harness/changes/<change-name>/verification-ledger.json`（根目录）兼容读取，详见 `state-layout-protocol.md`。新版本优先写 `evidence/`。
+> `<resolved-change-state>` 必须由共享状态目录解析器取得：split-v1 通常位于 `.harness/state/changes/<change-name>`，旧布局仍位于 `.harness/changes/<change-name>`。根目录旧文件 `verification-ledger.json` 只兼容读取，详见 `state-layout-protocol.md`；新版本统一写入 `evidence/`。
 
 - 不提交到 git（已在 `.harness/` 屏蔽范围内）
 - 每次验证执行后**立即写回**（不得等所有阶段结束才补）
@@ -32,7 +32,7 @@ verification-ledger 把每次验证（compile / unit test / api test / package
 
 ## 三、账本结构
 
-`.harness/changes/<change>/verification-ledger.json` 必须至少包含：
+解析后的变更状态目录中，`evidence/verification-ledger.json` 必须至少包含：
 
 ```json
 {