@hunter-harness/workflow-harness 0.2.59 → 0.2.61

package/harness/bundles/java/codex/protocols/report-pipeline-protocol.md

@@ -1,5 +1,5 @@
 ---
-description: 结构化事件、summary-data 生成、final-summary 校验和外部可观测性边界协议（finalize/replay）。
+description: 结构化事件、summary-data 生成与校验，以及外部可观测性边界协议（finalize/replay）。
 ---
 
 # Report Pipeline Protocol
@@ -10,7 +10,7 @@ description: 结构化事件、summary-data 生成、final-summary 校验和外
 
 1. **Event Layer**：`events.ndjson` 记录结构化执行事实。
 2. **Report Data Layer**：`summary-data.json` 由程序或确定性规则生成。
-3. **Renderer / Final Report Layer**：`final-summary.html` 只渲染和解释 summary-data，不重新推理统计。
+3. **Platform View Layer**：Hunter Platform 读取 `summary-data.json` 并展示结果，不在本地保存重复报告。
 
 模型可以写维护者结论、风险解释和人工判断，但不得凭印象手写统计数字、通过率、耗时、命令结果或 artifact hash。
 
@@ -19,12 +19,12 @@ description: 结构化事件、summary-data 生成、final-summary 校验和外
 Skill-bundled 脚本（推荐）：
 
 ```powershell
-python <skills-root>/scripts/harness_archive.py finalize --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --json
+python <skills-root>/scripts/harness_archive.py execute --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --intent record-only --closure completed --json
 python <skills-root>/scripts/harness_archive.py replay --archive-dir ".harness/archive/YYYY-MM-DD-<change-name>" --json
 python <skills-root>/scripts/harness_events.py append --change-dir ".harness/changes/<change-name>" --phase "<phase>" --type <type> [--note "..."]
 ```
 
-归档报告流水线只有两个入口，均由 `harness_archive.py` 提供：`collect`/`render`/`validate` 是 `finalize` 的内嵌同进程步骤，**不再作为独立 CLI 暴露**（不存在 `report collect`/`report validate` 子命令）。`summary-data.json` 只能由 `finalize`（归档时）或 `replay`（回放时）生成；**禁止 agent 临场手写或拼装等价的 `summary-data.json`**。`harness_archive.py` 不可用时归档失败退出，不得退回手写汇总。
+归档报告流水线的常规入口是 `execute`。它只采集一次状态并复用给内部 finalize；`collect` 与 `validate` 是 finalize 的内嵌同进程步骤，**不作为独立 CLI 暴露**（不存在 `report collect` / `report validate` 子命令）。`summary-data.json` 只能由 finalize（归档时）或 `replay`（回放时）生成；**禁止 agent 临场手写或拼装等价的 `summary-data.json`**。`harness_archive.py` 不可用时归档失败退出，不得退回手写汇总。
 
 ## events.ndjson
 
@@ -141,15 +141,16 @@ summary-data 必须保留原 archive final report 维度，并增加事件层摘
 
 新增 `reportPipeline` 不替代这些字段；它负责为这些字段提供可追溯的数据来源和一致性校验结果。
 
-## finalize 责任边界（`harness_archive.py finalize`）
+## execute 与 finalize 责任边界
+
+`execute` 负责一次性状态采集、自动门禁、准备耗时事件和对 finalize 的单次调用。常规调用者不得串行执行 `auto-gate`、`status`、`finalize`。finalize 负责正式归档尝试，并复用 execute 传入的预检结果。
 
 | 阶段 | 责任 | 写入 |
 |---|---|---|
 | `collect` | 从 events/ledger/log/manifest/report/git evidence 收集事实 | `summary-data.json` |
-| `render` | 由 `render-summary.mjs` 渲染 final-summary | `final-summary.html` |
-| `validate` | 检查 final-summary 是否覆盖 summary-data 关键事实 | issues；不得静默忽略 error |
+| `validate` | 检查 summary-data 的身份、验证状态与事实是否一致 | issues；不得静默忽略 error |
 
-> **已废弃**：独立 `enrich` 步骤与 `harness-report` skill；全部并入 `finalize` 单命令。回放见 `harness_archive.py replay`。
+> **已废弃**：独立 `enrich` 步骤与 `harness-report` skill；报告生成并入 finalize，常规归档由 `execute` 调用。回放见 `harness_archive.py replay`。
 
 `validate` error 存在时，`harness-archive` 不得删除原 changes 目录。
 
@@ -168,4 +169,4 @@ summary-data 必须保留原 archive final report 维度，并增加事件层摘
 
 - 可保留 `reportPipeline.externalTraceRefs[]` 等扩展字段。
 - 不得要求外部服务可用才允许 archive 成功。
-- 未来接入也必须以 `events.ndjson` 和 `summary-data.json` 为稳定合同，不改变 final-summary 质量维度。
+- 未来接入也必须以 `events.ndjson` 和 `summary-data.json` 为稳定合同，不改变结构化报告的质量维度。

package/harness/bundles/java/codex/protocols/sensitive-info-protocol.md

@@ -1,10 +1,10 @@
 ---
-description: harness 全流程的敏感信息脱敏协议。所有 skill 的输出（控制台、execution-log、报告、commit message、final-summary）按本协议脱敏，禁止明文 token/密码/密钥。由原 harness-plan/sensitive-info.md 迁移。
+description: harness 全流程的敏感信息脱敏协议。所有 skill 的输出（控制台、execution-log、报告、commit message、summary-data）按本协议脱敏，禁止明文 token/密码/密钥。由原 harness-plan/sensitive-info.md 迁移。
 ---
 
 # Sensitive Info Protocol
 
-> 本协议适用于所有 harness-skills 的输出（控制台、execution-log.md、package-report、review-report、final-summary.html、commit message）。
+> 本协议适用于所有 harness-skills 的输出（控制台、execution-log.md、package-report、review-report、summary-data.json、commit message）。
 
 ## 1. 禁止明文输出的信息类型
 
@@ -49,7 +49,7 @@ description: harness 全流程的敏感信息脱敏协议。所有 skill 的输
 | 执行日志 | `.harness/changes/<change-name>/logs/execution-log.md` |
 | 审查报告 | `.harness/changes/<change-name>/reports/review/review-report-*.md` |
 | 测试报告 | `.harness/changes/<change-name>/reports/test/test-report-*.md` |
-| 最终总结 | `.harness/archive/YYYY-MM-DD-<change-name>/reports/final/final-summary.html` |
+| 最终总结数据 | `.harness/archive/YYYY-MM-DD-<change-name>/reports/final/summary-data.json` |
 | 归档元数据 | `.harness/archive/YYYY-MM-DD-<change-name>/meta/archive-meta.md` |
 | Commit message | git log 中的提交信息 |
 

package/harness/bundles/java/codex/protocols/state-layout-protocol.md

@@ -55,8 +55,7 @@ description: harness .harness 状态目录分层协议。用于减少根目录
 │   ├── review/
 │   ├── package/
 │   └── final/
-│       ├── summary-data.json
-│       └── final-summary.html
+│       └── summary-data.json
 ├── sqls/
 ├── scripts/
 ├── runtime/
@@ -117,7 +116,6 @@ package SHA-256，且服务端同时确认 `archive_status=durable` 与
 | worktree | `meta/worktree.json` | `worktree.json` |
 | run status | `evidence/run-task-status.md` | `run-task-status.md` |
 | final summary data | `reports/final/summary-data.json` | `summary-data.json` |
-| final report | `reports/final/final-summary.html` | `final-summary.html` |
 
 ## 写入规则
 
@@ -143,7 +141,7 @@ package SHA-256，且服务端同时确认 `archive_status=durable` 与
 
 ## state-snapshot.json（cluster 3 §3.6）
 
-`meta/state-snapshot.json`（由 `harness_state.py` 写入）集中记录 project/worktree root、HEAD/base、profile/rules/map/knowledge/diff 各段指纹与相关文件。plan/run/test/review/submit 读取该快照；失效时由脚本刷新，**不得仅凭缓存跳过代码或验证门禁**。
+`meta/state-snapshot.json`（由 `harness_state.py` 写入）集中记录 project/worktree root、不可变 `changeBase`、当前 HEAD，以及 profile/rules/map/knowledge/diff 各段指纹与相关文件。Plan 首次捕获把当时 HEAD 写入 `changeBase`；run/test/review/submit/archive 刷新时只能更新当前 HEAD 和各段指纹。失效时由脚本刷新，**不得仅凭缓存跳过代码或验证门禁，也不得把后续 HEAD 覆盖为变更基线**。
 
 schema：
 
@@ -152,6 +150,7 @@ schema：
   "schemaVersion": 1,
   "generatedAt": "<iso>",
   "changeName": "<change-name>",
+  "changeBase": "<首次 Plan 捕获的 sha>",
   "project": {"root": "<abs>"},
   "worktree": {"root": "<abs>"},
   "git": {"base": "<sha>", "head": "<sha>"},
@@ -161,13 +160,13 @@ schema：
 }
 ```
 
-各段独立失效：`is_segment_stale(snapshot, segment, current_fingerprint)` 比较单段指纹；段不存在 → stale（需采集）。`refresh_segments(..., segments=["profile"])` 只重采受影响段，其他段保留原 capturedAt/fingerprint（缓存失效只重采受影响段）。
+各段独立失效：`is_segment_stale(snapshot, segment, current_fingerprint)` 比较单段指纹；段不存在 → stale（需采集）。`refresh_segments(..., segments=["profile"])` 只重采受影响段，其他段保留原 capturedAt/fingerprint（缓存失效只重采受影响段）。`git.base` 是 `changeBase` 的兼容镜像，不是每次 capture 的 HEAD。
 
 segment 的文件集由调用方（各 skill）决定：`capture_snapshot(..., segment_files={"profile": [...], "rules": [...]})`。snapshot 只负责采集 + 比对 + 失效，不负责发现文件。git 段记录 base/head；diff 段指纹由调用方按需用 `harness_ledger.compute_diff_hash` 采集后填入 segment_files。
 
 ## archive 结构
 
-archive 后保持同样分层结构，不把 `.bak`、脚本、manifest、HTML 全部放在 archive 根目录。
+archive 后保持同样分层结构，不把 `.bak`、脚本、manifest 或其他生成文件堆在 archive 根目录。
 
 未提交但用于验证的测试文件放入：