cc-devflow 4.5.10 → 4.5.12

package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md

@@ -1,197 +1,41 @@
 # PR Brief
 
-## Document Meta
-
-- Output language:
-
-## Decision
-
-- Recommended mode:
-- Why now:
-- Why not others:
-
-## Requirement
-
-- 
-
-## Ship Mode
-
-- `create-pr` / `update-pr` / `local-handoff` / `post-merge-closeout`
-
-## Branch Context
-
-- Current branch:
-- Base branch:
-- PR / MR:
-
-## Ship Preflight
+## Change
 
+- Change key:
 - Branch:
-- Base:
-- Remote:
-- Local / remote HEAD:
-- Auth:
-- Clean tree:
-- Review freshness:
-- Ship mode:
-- `ShipPreflightError`:
-- Rescue action:
-
-## PR Branch Hygiene
-
-- Existing PR / MR:
-- Duplicate PR risk:
-- Commit split:
-- Push idempotency:
-- Body source:
-
-## Review Range
-
-- Reviewed base SHA:
-- Reviewed head SHA:
-- Review packet:
-- Finding triage:
-- QA / claim evidence:
-
-## Readiness Dashboard
-
-- Review freshness:
-- Review quality:
-- Specialist review facets:
-- QA coverage:
-- Browser QA:
-- Feedback loop:
-- Behavior evidence:
-- Failure ownership:
-- Documentation release:
-- PR body accuracy:
-
-## Pull Request Body Contract
-
-- Language source: `Output language: <value from report-card>`
-- PR body language: `中文` / `English`
-- Title rule: same language as the PR body after the Conventional Commits `type(scope)` prefix; keep identifiers, paths, commands, and issue keys unchanged.
-- Body source: current `pr-brief.md`, current diff, current `review/report-card.json`, doc sync output, and roadmap/backlog writeback.
-- Required sections: summary, problem, changes, validation, review/gate evidence, risk/rollback, docs/writeback, follow-ups.
-- Completeness gate: no empty headings, no stale inherited PR body, no generic "tests passed" without command or evidence, and no `<placeholder>` text before `gh pr create` or `gh pr edit`.
-
-## Pull Request Body Draft
+- Head:
 
-```markdown
-## Summary / 摘要
-
-- TBD
-
-## Problem / 问题
-
-- Requirement / 需求:
-- User-visible gap / 用户可见缺口:
-
-## Changes / 变更
+## Task Summary
 
-- TBD
+- Done:
 
-## Validation / 验证
+## Recent Commits
 
-- `report-card.json` verdict / 结论:
-- Commands / 命令:
-- Key observations / 关键观察:
+- <task summary>
 
-## Review / Gate Evidence
+## Current Diff
 
-- Reviewed base SHA:
-- Reviewed head SHA:
-- Review packet:
-- Finding triage:
-- QA / claim evidence:
-- Readiness:
+- <diff summary>
 
-## Risk And Rollback / 风险与回滚
+## Validation
 
-- Main risk / 主要风险:
-- Rollback boundary / 回滚边界:
+- Command:
+- Result:
+- Key observation:
 
-## Docs And Writeback / 文档与回写
-
-- `CLAUDE.md`:
-- `README.md`:
-- Roadmap progress:
-
-## Follow-ups / 后续事项
-
-- TBD
-```
+## PR Body Draft
 
+```markdown
 ## Summary
 
-- TBD
+- <summary>
 
-## What Changed
+## Validation
 
-- TBD
+- <validation evidence>
 
-## Verification Evidence
+## Risk / Rollback
 
-- `review/report-card.json` verdict:
-- Fresh evidence:
-- Merged-result verification:
-
-## Rollback Guard
-
-- Safe state:
-- Rollback command / manual steps:
-- Side effects:
-- Owner:
-
-## QA Behavior Evidence
-
-- Feedback loop:
-- Expected behavior:
-- Actual behavior:
-- Reproduction steps:
-- Consistency:
-
-## Documentation Sync
-
-- `CLAUDE.md`:
-- `README.md`:
-- `release-note.md`:
-- `resume-index.md`:
-
-## Roadmap Progress Sync
-
-- Source RM:
-- Roadmap files: `devflow/roadmap.json`, `devflow/ROADMAP.md`, optional `devflow/BACKLOG.md`
-- Sync command:
-- Status after sync:
-- Progress after sync:
-- Follow-up writeback:
-- No-op reason:
-
-## Consolidated Memory
-
-- `handoff path`: 
-- latest task-state / review summary:
-- handoff entry for the next maintainer:
-
-## Minimum Landing Pack
-
-- Required for this mode:
-- Intentionally omitted:
-
-## How To Verify
-
-- TBD
-
-## Follow-Ups
-
-- Current behavior:
-- Desired behavior:
-- Key interfaces:
-- Acceptance criteria:
-- Out of scope:
-- Learning extraction target:
-
-## Risks
-
-- TBD
+- <risk and rollback>
+```

package/.claude/skills/cc-act/references/closure-contract.md

@@ -1,70 +1,19 @@
 # Closure Contract
 
-## Before Closing
-
-1. `report-card.json` 必须是 `pass`
-2. `reroute` 必须是 `none`
-3. `evidence` 必须非空
-4. `planning/tasks.md` 不能还有未完成项
-5. 交付材料必须只总结现实，不补编故事
-6. 如果文件结构变了，就同步对应目录的 `CLAUDE.md`
-7. PR / handoff 必须记录 `cc-check` 审过的 base/head SHA、review packet、finding triage 摘要
-8. readiness dashboard 必须说明 review freshness、QA coverage、browser evidence、failure ownership、documentation release、PR body accuracy
-9. behavior handoff 必须带上 QA feedback loop、expected / actual / reproduction steps，以及 durable follow-up brief
-10. source RM 必须已从 `devflow/roadmap.json` 定位，且 roadmap progress 与 verified reality 一致；没有 source RM 时记录 no-op reason
-11. `post-merge-closeout` 必须预先冻结 archive target；最终只能是已归档，或带 `ArchiveSkip` blocker 的未完成 closeout
-
-## Ship Decision Contract
-
-收尾动作必须归入且只归入下列模式之一：
-
-1. `create-pr`
-2. `update-pr`
-3. `local-handoff`
-4. `post-merge-closeout`
-
-如果当前状态不属于这 4 类之一，说明事实还没搞清，不准继续 ship。
-
-detached HEAD 是分支事实，不是第 5 种 ship 模式。若远端可用且用户目标是
-继续 / 提交远程 PR，必须先运行 `scripts/ensure-ship-branch.sh --dir <requirement-dir>`
-在当前 HEAD 创建命名分支，再回到 `create-pr` 流程。
-
-## During Act
-
-1. 如果 Act 阶段修改了代码、测试、验证口径，必须回 `cc-check`
-2. 已存在 PR / MR 时优先更新，不重复创建
-3. 文档不同构时，ship 不算完成
-4. follow-up 只允许回写到系统真相源，不允许停留在聊天记录里
-5. VERSION / package / changelog 漂移必须先分类处理，不能重复 bump 或覆盖发布历史
-6. PR / MR body 必须从当前事实重建，不能沿用旧验证输出
-7. push / PR 创建必须具备幂等检查：已同步则跳过，已存在 PR 则更新
-8. 本地合并或 post-merge closeout 后必须在 merged result 上重跑必要 gate
-9. 删除 branch、worktree、未合并提交、归档 requirement 前必须列出对象；丢弃未合并工作需要显式确认
-10. verification 每次进入 `cc-act` 都必须重新跑；只有 push、PR 更新、文档生成等动作可以因为幂等状态跳过
-11. PR body accuracy 必须对照当前 report-card、当前 diff、当前 commits；旧 body 不能作为证据源
-12. follow-up 回写必须用行为契约表达，包含 current behavior、desired behavior、key interfaces、acceptance criteria、out of scope；不能只写文件路径或聊天 TODO
-13. roadmap 回写只更新 `devflow/roadmap.json`，并通过 `sync-roadmap-progress.sh` 重新生成 `devflow/ROADMAP.md` / `devflow/BACKLOG.md`
-14. `post-merge-closeout` 的归档必须真实执行：`cc-devflow archive-change <change-key>`，不能只把“可归档”写进 next action
-
-## Memory Consolidation
-
-进入 ship 动作前，先把分散事实压缩进：
+## Allowed Durable Outputs
 
 - `handoff/pr-brief.md`
-- `handoff/resume-index.md`（需要 handoff 时）
-- `handoff/release-note.md`（需要发布时）
+- `devflow/postmortems/INDEX.md`
+- `devflow/postmortems/incidents/<date>-<change-key>.md`
+
+## Hard Rules
 
-如果下一位接手者还得去翻零散过程笔记才知道从哪接，说明 act 还没收口。
+1. Git commits are the process record.
+2. PR text is rebuilt from current commits, diff, `task.md`, and fresh validation.
+3. Incident postmortems are factual and evidence-backed.
+4. No process file beyond the allowed durable outputs.
+5. If verification changes during Act, return to `cc-check`.
 
-## After Closing
+## Exit
 
-- reviewer 能接手
-- maintainer 知道怎么验证
-- PR / handoff / release 材料反映同一套事实
-- readiness dashboard 没有 blocker，PR body accuracy 已检查或明确阻塞
-- QA behavior evidence 和 feedback loop 已进入 PR / handoff / release 材料
-- post-merge closeout 反映 merged result 的验证事实，而不是只反映合并前事实
-- source RM 的 status、REQ/FIX 绑定、progress 和 follow-up 已经落入 roadmap truth
-- closed change 已经移动到 `devflow/changes/archive/YYYY-MM/<change-key>`；如果没有，必须有 `ArchiveSkip` blocker、原因、受影响路径和 retry command
-- 下一轮计划入口更清楚
-- 文档入口可发现，changelog 不丢历史，TODO / backlog 只记录有证据的事项
+Close with commit hashes, validation commands, PR/handoff state, and any incident postmortem path.

package/.claude/skills/cc-act/references/git-commit-guidelines.md

@@ -9,7 +9,7 @@
 1. `git log --oneline` 能看懂变更类型和范围。
 2. `git show` 能解释问题、取舍、验证和风险。
 3. 每个 commit 边界足够小，后续可以独立 review、cherry-pick 或 revert。
-4. PR body、release note、handoff 和 commit history 讲同一套事实。
+4. PR body、handoff 和 commit history 讲同一套事实。
 5. 后续维护者不需要聊天记录，也能知道为什么这么改。
 
 ## Research Baseline
@@ -65,8 +65,8 @@
 2. 改变用户可见行为、公共 API、CLI、schema、prompt、skill contract、验证脚本或发布流程。
 3. 修 bug、回归、flaky、性能、安全、权限、数据一致性或 trust boundary。
 4. 引入或改变测试策略、mock 边界、fixture、golden artifact。
-5. 触碰 roadmap / planning / task manifest / report-card / handoff 等 durable artifact。
-6. 有兼容性、迁移、回滚、release note 或 follow-up 风险。
+5. 触碰 roadmap / task.md / PR brief / handoff 等 durable artifact。
+6. 有兼容性、迁移、回滚或 follow-up 风险。
 
 单行 commit 仅适合：
 
@@ -156,7 +156,7 @@
 - <影响范围和回滚路径>
 
 关联:
-- <FIX/issue/analysis/report-card>
+- <FIX/issue/root-cause/verification evidence>
 ```
 
 ### `refactor`
@@ -383,6 +383,6 @@ fix(auth): 拒绝过期 refresh token
 5. `fix` commit 是否写了 `根因`，且不是只描述 symptom。
 6. `验证` 是否是实际命令 / artifact / explicit skip reason，而不是 “tested locally”。
 7. footer 是否使用 trailer 风格，issue closing keyword 是否符合目标平台语义。
-8. push、PR body、release note、handoff 是否与最终 commit history 表达同一套事实。
+8. push、PR body、handoff 是否与最终 commit history 表达同一套事实。
 
 如果无法满足这些条件，停在 `local-handoff` 或 reroute，不要制造粗糙历史。

package/.claude/skills/cc-act/scripts/cc-act-common.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 
 # ------------------------------------------------------------
-# cc-act: 共享提取与归一化逻辑
+# cc-act: task.md + pr-brief path helpers
 # ------------------------------------------------------------
 
 req_act_change_dir() {
@@ -9,7 +9,7 @@ req_act_change_dir() {
   local normalized="${input%/}"
 
   case "$(basename "$normalized")" in
-    planning|execution|review|handoff|meta)
+    handoff)
       dirname "$normalized"
       ;;
     *)
@@ -18,335 +18,18 @@ req_act_change_dir() {
   esac
 }
 
-req_act_planning_dir() {
-  printf '%s/planning\n' "$(req_act_change_dir "$1")"
-}
-
-req_act_review_dir() {
-  printf '%s/review\n' "$(req_act_change_dir "$1")"
-}
-
 req_act_handoff_dir() {
   printf '%s/handoff\n' "$(req_act_change_dir "$1")"
 }
 
-req_act_manifest_path() {
-  printf '%s/task-manifest.json\n' "$(req_act_planning_dir "$1")"
-}
-
-req_act_change_meta_path() {
-  printf '%s/change-meta.json\n' "$(req_act_change_dir "$1")"
-}
-
 req_act_tasks_path() {
-  printf '%s/tasks.md\n' "$(req_act_planning_dir "$1")"
+  printf '%s/task.md\n' "$(req_act_change_dir "$1")"
 }
 
-req_act_contract_path() {
-  local planning_dir
-  local design_file
-  local analysis_file
-
-  planning_dir="$(req_act_planning_dir "$1")"
-  design_file="$planning_dir/design.md"
-  analysis_file="$planning_dir/analysis.md"
-
-  if [[ -f "$analysis_file" && ! -f "$design_file" ]]; then
-    printf '%s\n' "$analysis_file"
-    return 0
-  fi
-
-  printf '%s\n' "$design_file"
-}
-
-req_act_report_path() {
-  printf '%s/report-card.json\n' "$(req_act_review_dir "$1")"
-}
-
-req_act_release_note_path() {
-  printf '%s/release-note.md\n' "$(req_act_handoff_dir "$1")"
-}
-
-req_act_resume_index_path() {
-  printf '%s/resume-index.md\n' "$(req_act_handoff_dir "$1")"
-}
-
-req_act_doc_sync_report_path() {
-  printf '%s/doc-sync-report.md\n' "$(req_act_handoff_dir "$1")"
+req_act_pr_brief_path() {
+  printf '%s/pr-brief.md\n' "$(req_act_handoff_dir "$1")"
 }
 
 req_act_repo_root() {
   git rev-parse --show-toplevel 2>/dev/null || pwd
 }
-
-req_act_requirement_id() {
-  local manifest="$1"
-  local req_dir="$2"
-  local requirement_id=""
-
-  requirement_id="$(jq -r '.requirementId // .changeId // empty' "$manifest" 2>/dev/null || true)"
-  if [[ -z "$requirement_id" ]]; then
-    requirement_id="$(basename "$req_dir")"
-  fi
-
-  printf '%s\n' "$requirement_id"
-}
-
-req_act_report_summary() {
-  local report_card="$1"
-  jq -r '.summary // ""' "$report_card" 2>/dev/null || true
-}
-
-req_act_report_verdict() {
-  local report_card="$1"
-  jq -r '.verdict // "unknown"' "$report_card" 2>/dev/null || echo unknown
-}
-
-req_act_spec_sync_ready() {
-  local report_card="$1"
-  jq -r '.specSyncReady // false' "$report_card" 2>/dev/null || echo false
-}
-
-req_act_output_language() {
-  local report_card="$1"
-  jq -r '.outputPolicy.documentLanguage // "en"' "$report_card" 2>/dev/null || echo en
-}
-
-req_act_design_goal() {
-  local design_file="$1"
-  awk -F': ' '/^- Deliver:/{print $2; exit} /^- Change:/{print $2; exit}' "$design_file" 2>/dev/null || true
-}
-
-req_act_main_risk() {
-  local design_file="$1"
-  local risk=""
-
-  risk="$(awk -F': ' '/^- Main risk:/{print $2; exit}' "$design_file" 2>/dev/null || true)"
-  if [[ -n "$risk" ]]; then
-    printf '%s\n' "$risk"
-    return 0
-  fi
-
-  awk -F'|' '
-    /^\|/ {
-      risk=$2
-      gsub(/^[[:space:]]+|[[:space:]]+$/, "", risk)
-      if (risk != "" && risk != "Risk" && risk !~ /^-+$/) {
-        print risk
-        exit
-      }
-    }
-  ' "$design_file" 2>/dev/null || true
-}
-
-req_act_dedup_file() {
-  local file="$1"
-  awk 'NF && !seen[$0]++' "$file" > "${file}.dedup"
-  mv "${file}.dedup" "$file"
-}
-
-req_act_collect_completed_titles() {
-  local manifest="$1"
-  local tasks_file="$2"
-  local out_file="$3"
-
-  : > "$out_file"
-
-  if [[ -f "$manifest" ]]; then
-    jq -r '
-      (.tasks // [])
-      | map(select((.status // "") | test("done|completed"; "i")))
-      | .[]
-      | .title // empty
-    ' "$manifest" 2>/dev/null | sed '/^$/d' > "$out_file" || true
-  fi
-
-  if [[ ! -s "$out_file" && -f "$tasks_file" ]]; then
-    awk '/^- \[[xX]\] /{sub(/^- \[[xX]\] /, "", $0); print}' "$tasks_file" > "$out_file" || true
-  fi
-}
-
-req_act_collect_verification_commands() {
-  local manifest="$1"
-  local out_file="$2"
-
-  : > "$out_file"
-
-  if [[ -f "$manifest" ]]; then
-    jq -r '
-      (.tasks // [])
-      | map(.verification // [])
-      | add
-      | .[]?
-    ' "$manifest" 2>/dev/null | sed '/^$/d' > "$out_file" || true
-  fi
-
-  req_act_dedup_file "$out_file"
-}
-
-req_act_collect_followups() {
-  local report_card="$1"
-  local manifest="$2"
-  local out_file="$3"
-
-  : > "$out_file"
-
-  if [[ -f "$report_card" ]]; then
-    jq -r '(.gaps // [])[]?' "$report_card" 2>/dev/null | sed '/^$/d' > "$out_file" || true
-    jq -r '
-      (.followupBriefs // .review.followupBriefs // [])[]?
-      | [
-          ("summary: " + (.summary // .title // "follow-up")),
-          ("current: " + (.currentBehavior // "not recorded")),
-          ("desired: " + (.desiredBehavior // "not recorded")),
-          ("interfaces: " + ((.keyInterfaces // []) | join(", "))),
-          ("acceptance: " + ((.acceptanceCriteria // []) | join("; "))),
-          ("out-of-scope: " + ((.outOfScope // []) | join(", ")))
-        ]
-      | join(" | ")
-    ' "$report_card" 2>/dev/null | sed '/^$/d' >> "$out_file" || true
-    jq -r '
-      (.qa.architectureFollowUps // [])[]?
-      | [
-          ("summary: " + (.summary // .title // "architecture follow-up")),
-          ("current: " + (.currentBehavior // "not recorded")),
-          ("desired: " + (.desiredBehavior // "not recorded")),
-          ("interfaces: " + ((.keyInterfaces // []) | join(", "))),
-          ("acceptance: " + ((.acceptanceCriteria // []) | join("; "))),
-          ("out-of-scope: " + ((.outOfScope // []) | join(", ")))
-        ]
-      | join(" | ")
-    ' "$report_card" 2>/dev/null | sed '/^$/d' >> "$out_file" || true
-  fi
-
-  if [[ -f "$manifest" ]]; then
-    jq -r '(.openQuestions // [])[]?, (.deferredQuestions // [])[]?' "$manifest" 2>/dev/null | sed '/^$/d' >> "$out_file" || true
-  fi
-
-  req_act_dedup_file "$out_file"
-}
-
-req_act_collect_touched_files() {
-  local manifest="$1"
-  local out_file="$2"
-
-  : > "$out_file"
-
-  if [[ -f "$manifest" ]]; then
-    jq -r '
-      (.tasks // [])
-      | map((.files // []) + (.touches // []))
-      | add
-      | .[]?
-    ' "$manifest" 2>/dev/null | sed '/^$/d' > "$out_file" || true
-  fi
-
-  req_act_dedup_file "$out_file"
-}
-
-req_act_collect_spec_files() {
-  local manifest="$1"
-  local out_file="$2"
-  local change_dir=""
-  local change_meta=""
-
-  : > "$out_file"
-
-  if [[ -f "$manifest" ]]; then
-    change_dir="$(req_act_change_dir "$(dirname "$manifest")")"
-    change_meta="$(req_act_change_meta_path "$change_dir")"
-  fi
-
-  if [[ -n "$change_meta" && -f "$change_meta" ]]; then
-    jq -r '(.spec.specFiles // [])[]?' "$change_meta" 2>/dev/null | sed '/^$/d' > "$out_file" || true
-  fi
-
-  if [[ -f "$manifest" ]]; then
-    jq -r '(.spec.specFiles // [])[]?' "$manifest" 2>/dev/null | sed '/^$/d' >> "$out_file" || true
-  fi
-
-  req_act_dedup_file "$out_file"
-}
-
-req_act_roadmap_sync_summary() {
-  local manifest="$1"
-  local repo_root="${2:-$(req_act_repo_root)}"
-  local item_id=""
-  local sync_status=""
-  local sync_command=""
-  local no_op_reason=""
-  local updated_files=""
-  local existing_files=""
-  local change_dir=""
-  local change_meta=""
-
-  if [[ -f "$manifest" ]]; then
-    change_dir="$(req_act_change_dir "$(dirname "$manifest")")"
-    change_meta="$(req_act_change_meta_path "$change_dir")"
-  fi
-
-  if [[ -n "$change_meta" && -f "$change_meta" ]]; then
-    item_id="$(jq -r '.sourceRoadmap.itemId // empty' "$change_meta" 2>/dev/null || true)"
-    sync_status="$(jq -r '.roadmapSync.status // .sourceRoadmap.syncStatus // "not recorded"' "$change_meta" 2>/dev/null || true)"
-    sync_command="$(jq -r '.roadmapSync.command // .sourceRoadmap.syncCommand // empty' "$change_meta" 2>/dev/null || true)"
-    no_op_reason="$(jq -r '.roadmapSync.noOpReason // .sourceRoadmap.noOpReason // empty' "$change_meta" 2>/dev/null || true)"
-    updated_files="$(jq -r '(.roadmapSync.updatedFiles // .sourceRoadmap.updatedFiles // []) | join(", ")' "$change_meta" 2>/dev/null || true)"
-  elif [[ -f "$manifest" ]]; then
-    item_id="$(jq -r '.sourceRoadmap.itemId // empty' "$manifest" 2>/dev/null || true)"
-    sync_status="$(jq -r '.sourceRoadmap.syncStatus // .roadmapSync.status // "not recorded"' "$manifest" 2>/dev/null || true)"
-    sync_command="$(jq -r '.sourceRoadmap.syncCommand // .roadmapSync.command // empty' "$manifest" 2>/dev/null || true)"
-    no_op_reason="$(jq -r '.sourceRoadmap.noOpReason // .roadmapSync.noOpReason // empty' "$manifest" 2>/dev/null || true)"
-    updated_files="$(jq -r '(.sourceRoadmap.updatedFiles // .roadmapSync.updatedFiles // []) | join(", ")' "$manifest" 2>/dev/null || true)"
-  fi
-
-  for candidate in devflow/roadmap.json devflow/ROADMAP.md devflow/BACKLOG.md devflow/roadmap-tracking.json; do
-    if [[ -f "$repo_root/$candidate" ]]; then
-      if [[ -n "$existing_files" ]]; then
-        existing_files+=", "
-      fi
-      existing_files+="$candidate"
-    fi
-  done
-
-  [[ -n "$existing_files" ]] || existing_files="no roadmap files found"
-  [[ -n "$updated_files" ]] || updated_files="not recorded"
-  [[ -n "$sync_command" ]] || sync_command="not recorded"
-  [[ -n "$sync_status" ]] || sync_status="not recorded"
-
-  if [[ -z "$item_id" ]]; then
-    [[ -n "$no_op_reason" ]] || no_op_reason="no-source-rm"
-    printf 'source=none; status=no-op; files=%s; no-op=%s\n' "$existing_files" "$no_op_reason"
-    return 0
-  fi
-
-  printf 'source=%s; status=%s; files=%s; updated=%s; command=%s' \
-    "$item_id" "$sync_status" "$existing_files" "$updated_files" "$sync_command"
-
-  if [[ -n "$no_op_reason" ]]; then
-    printf '; no-op=%s' "$no_op_reason"
-  fi
-
-  printf '\n'
-}
-
-req_act_collect_evidence() {
-  local report_card="$1"
-  local out_file="$2"
-
-  : > "$out_file"
-  jq -r '
-    (.evidence // [])[]?,
-    ((.claimEvidence // [])[]? | "- " + (.claim // "claim") + ": " + (.status // "unknown") + " via " + (.commandOrArtifact // "artifact") + " - " + (.keyObservation // "")),
-    (if .qa.coverageAudit then "- qa.coverage: " + (.qa.coverageAudit.status // "unknown") + ", gaps=" + (((.qa.coverageAudit.gaps // []) | length) | tostring) else empty end),
-    (if .qa.browserEvidence then "- qa.browser: " + (.qa.browserEvidence.status // "unknown") + ", mode=" + (.qa.browserEvidence.mode // "unknown") else empty end),
-    (if .qa.feedbackLoop then "- qa.feedbackLoop: " + (.qa.feedbackLoop.status // "unknown") + ", mode=" + (.qa.feedbackLoop.mode // "unknown") + ", signal=" + (.qa.feedbackLoop.signalSharpness // "not recorded") else empty end),
-    (if .qa.behaviorEvidence then "- qa.behavior: " + (.qa.behaviorEvidence.status // "unknown") + ", expected=" + (.qa.behaviorEvidence.expectedBehavior // "not recorded") + ", actual=" + (.qa.behaviorEvidence.actualBehavior // "not recorded") else empty end)
-  ' "$report_card" 2>/dev/null | sed '/^$/d' > "$out_file" || true
-  req_act_dedup_file "$out_file"
-}
-
-req_act_ship_field() {
-  local ship_context="$1"
-  local key="$2"
-  printf '%s\n' "$ship_context" | awk -F= -v key="$key" '$1 == key {print substr($0, index($0, "=") + 1)}'
-}