cc-devflow 4.5.11 → 4.5.13

package/lib/skill-runtime/store.js

@@ -1,7 +1,7 @@
 /**
  * [INPUT]: 依赖 fs/path/child_process，依赖调用方提供 changeId 与命令参数。
- * [OUTPUT]: 对外提供 shared runtime 路径约定、JSON/文本读写、删除、JSONL 追加与命令执行工具。
- * [POS]: skill runtime 的数据与 IO 基础设施层，被全部 operations 复用。
+ * [OUTPUT]: 对外提供 shared path、文本读写与命令执行工具。
+ * [POS]: skill runtime 的轻量 IO 层，不承载流程 JSON 契约。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */
 
@@ -12,8 +12,7 @@ const { spawn } = require('child_process');
 const {
   getDevflowRoot,
   getChangesRoot,
-  getChangePaths,
-  getTaskPaths
+  getChangePaths
 } = require('./paths');
 
 function nowIso() {
@@ -44,42 +43,14 @@ function getChangeDir(repoRoot, changeId, options = {}) {
   return getChangePaths(repoRoot, changeId, options).changeDir;
 }
 
-function getTaskManifestPath(repoRoot, changeId, options = {}) {
-  return path.join(getChangePaths(repoRoot, changeId, options).planningDir, 'task-manifest.json');
-}
-
-function getReportCardPath(repoRoot, changeId, options = {}) {
-  return path.join(getChangePaths(repoRoot, changeId, options).reviewDir, 'report-card.json');
-}
-
-function getReleaseNotePath(repoRoot, changeId, options = {}) {
-  return path.join(getChangePaths(repoRoot, changeId, options).handoffDir, 'release-note.md');
-}
-
-function getRuntimeStatePath(repoRoot, changeId, options = {}) {
-  return path.join(getChangePaths(repoRoot, changeId, options).metaDir, 'change-state.json');
-}
-
 function getTasksMarkdownPath(repoRoot, changeId, options = {}) {
-  return path.join(getChangePaths(repoRoot, changeId, options).planningDir, 'tasks.md');
+  return path.join(getChangePaths(repoRoot, changeId, options).changeDir, 'task.md');
 }
 
 function getRuntimeRoot(repoRoot) {
   return getChangesRoot(repoRoot);
 }
 
-function getRuntimeChangeDir(repoRoot, changeId, options = {}) {
-  return getChangePaths(repoRoot, changeId, options).executionDir;
-}
-
-function getRuntimeTaskDir(repoRoot, changeId, taskId, options = {}) {
-  return getTaskPaths(repoRoot, changeId, taskId, options).taskDir;
-}
-
-function getEventsPath(repoRoot, changeId, taskId, options = {}) {
-  return getTaskPaths(repoRoot, changeId, taskId, options).eventsPath;
-}
-
 async function exists(filePath) {
   try {
     await fsp.access(filePath);
@@ -222,15 +193,8 @@ module.exports = {
   nowIso,
   resolveRepoRoot,
   getChangeDir,
-  getTaskManifestPath,
-  getReportCardPath,
-  getReleaseNotePath,
-  getRuntimeStatePath,
   getTasksMarkdownPath,
   getRuntimeRoot,
-  getRuntimeChangeDir,
-  getRuntimeTaskDir,
-  getEventsPath,
   exists,
   ensureDir,
   readText,

package/lib/skill-runtime/trace.js

@@ -1,6 +1,6 @@
 /**
- * [INPUT]: 接收 query/doctor/preflight 的事件名、artifact refs 与下一动作。
- * [OUTPUT]: 生成统一 trace shape，供恢复、排查和 report-card 引用。
+ * [INPUT]: 接收 query/doctor/preflight 的事件名、refs 与下一动作。
+ * [OUTPUT]: 生成统一 trace shape，供排查和上下文读取使用。
  * [POS]: skill runtime 的 operational trace 层，不承载 workflow 决策。
  * [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cc-devflow",
-    "version": "4.5.11",
+    "version": "4.5.13",
     "description": "Multi-platform CLI and skill pack for agent coding",
     "main": "bin/cc-devflow.js",
     "bin": {
@@ -44,13 +44,10 @@
     "scripts": {
         "prepublishOnly": "node scripts/validate-publish.js",
         "test": "jest",
-        "verify": "npm test && npm run verify:examples && npm run verify:artifacts && npm run benchmark:skills",
+        "verify": "npm test && npm run verify:examples && npm run benchmark:skills",
         "verify:examples": "bash docs/examples/scripts/check-example-bindings.sh",
-        "verify:artifacts": "node scripts/verify-artifacts.js",
         "verify:publish": "node scripts/validate-publish.js",
-        "benchmark:artifacts": "node scripts/benchmark-artifacts.js",
         "benchmark:skills": "node scripts/benchmark-skills.js",
-        "benchmark:workflow-context": "node scripts/benchmark-workflow-context-tokens.js",
         "start": "node bin/cc-devflow.js",
         "adapt": "node bin/adapt.js",
         "adapt:check": "node bin/adapt.js --check",

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

@@ -1,29 +0,0 @@
-# Project Postmortem Principles
-
-This file stores generalized lessons extracted from concrete incidents. Keep each
-principle short enough to scan, but cite the incident file and Git evidence that
-made it real.
-
-## Principles
-
-### PM-P001 <principle title>
-
-- Failure class:
-- Model limitation or professional judgment trap:
-- Rule:
-- Countermeasure before planning:
-- Countermeasure before coding:
-- Countermeasure before shipping:
-- Evidence:
-  - Incident: `devflow/postmortems/incidents/<date>-<change-key>.md`
-  - Git: `<commit-or-range>`
-- Search terms:
-
-## Candidate Principles
-
-Use this section for patterns that appeared once but are not yet strong enough to
-be promoted.
-
-| Candidate | Evidence | Promotion trigger |
-| --- | --- | --- |
-|  |  | repeats, high severity, or architecture-wide impact |

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

@@ -1,54 +0,0 @@
-# Release Note
-
-## Document Meta
-
-- Output language:
-
-## Release Scope
-
-- Why a release note is needed now:
-
-## User Impact
-
-- 
-
-## What Is New
-
-- 
-
-## Verification
-
-- 
-
-## Rollback Guard
-
-- Safe state:
-- Rollback command / manual steps:
-- Side effects:
-- Owner:
-
-## QA Behavior Evidence
-
-- Feedback loop:
-- User-visible behavior:
-- Reproduction / verification path:
-
-## Ops Notes
-
-- 
-
-## Roadmap Progress
-
-- Source RM:
-- Status after sync:
-- Progress after sync:
-- Follow-up writeback:
-- No-op reason:
-
-## Follow-Ups
-
-- Current behavior:
-- Desired behavior:
-- Acceptance criteria:
-- Out of scope:
-- Learning extraction target:

package/.claude/skills/cc-act/scripts/generate-status-report.sh

@@ -1,92 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-# ------------------------------------------------------------
-# cc-act: 汇总 requirement 当前 gate 与 ship 状态
-# ------------------------------------------------------------
-
-usage() {
-  cat <<'EOF'
-Usage: generate-status-report.sh --dir path/to/change
-EOF
-}
-
-REQ_DIR=""
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dir) REQ_DIR="$2"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    *) echo "Unknown arg: $1" >&2; usage; exit 1 ;;
-  esac
-done
-
-if [[ -z "$REQ_DIR" || ! -d "$REQ_DIR" ]]; then
-  usage
-  exit 1
-fi
-
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$script_dir/cc-act-common.sh"
-CHANGE_DIR="$(req_act_change_dir "$REQ_DIR")"
-report_card="$(req_act_report_path "$CHANGE_DIR")"
-tasks_file="$(req_act_tasks_path "$CHANGE_DIR")"
-manifest="$(req_act_manifest_path "$CHANGE_DIR")"
-handoff_dir="$(req_act_handoff_dir "$CHANGE_DIR")"
-
-verdict="unknown"
-reroute="unknown"
-evidence_count="0"
-gap_count="0"
-
-if [[ -f "$report_card" ]]; then
-  verdict="$(jq -r '.verdict // "unknown"' "$report_card" 2>/dev/null || echo unknown)"
-  reroute="$(jq -r '.reroute // "unknown"' "$report_card" 2>/dev/null || echo unknown)"
-  evidence_count="$(jq -r '(.evidence // []) | length' "$report_card" 2>/dev/null || echo 0)"
-  gap_count="$(jq -r '(.gaps // []) | length' "$report_card" 2>/dev/null || echo 0)"
-fi
-
-remaining_tasks="0"
-done_tasks="0"
-if [[ -f "$tasks_file" ]]; then
-  remaining_tasks="$(awk '/^- \[ \]/{c++} END{print c+0}' "$tasks_file" 2>/dev/null || echo 0)"
-  done_tasks="$(awk '/^- \[[xX]\]/{c++} END{print c+0}' "$tasks_file" 2>/dev/null || echo 0)"
-fi
-
-ship_context="$("$script_dir/detect-ship-target.sh" 2>/dev/null || true)"
-current_branch="$(printf '%s\n' "$ship_context" | awk -F= '/^CURRENT_BRANCH=/{print $2}')"
-branch_state="$(printf '%s\n' "$ship_context" | awk -F= '/^BRANCH_STATE=/{print $2}')"
-branch_rescue="$(printf '%s\n' "$ship_context" | awk -F= '/^BRANCH_RESCUE=/{print $2}')"
-rescue_action="$(printf '%s\n' "$ship_context" | awk -F= '/^RESCUE_ACTION=/{print $2}')"
-base_branch="$(printf '%s\n' "$ship_context" | awk -F= '/^BASE_BRANCH=/{print $2}')"
-platform="$(printf '%s\n' "$ship_context" | awk -F= '/^PLATFORM=/{print $2}')"
-decision_hint="$(printf '%s\n' "$ship_context" | awk -F= '/^DECISION_HINT=/{print $2}')"
-pr_status="$(printf '%s\n' "$ship_context" | awk -F= '/^PR_STATUS=/{print $2}')"
-pr_url="$(printf '%s\n' "$ship_context" | awk -F= '/^PR_URL=/{print $2}')"
-roadmap_sync_summary="$(req_act_roadmap_sync_summary "$manifest")"
-
-{
-  echo "# Status Report"
-  echo
-  echo "- Change dir: $CHANGE_DIR"
-  echo "- Check result: $verdict"
-  echo "- Gate reroute: $reroute"
-  echo "- Evidence items: $evidence_count"
-  echo "- Open gaps: $gap_count"
-  echo "- Completed tasks: $done_tasks"
-  echo "- Remaining tasks: $remaining_tasks"
-  [[ -n "$current_branch" ]] && echo "- Current branch: $current_branch"
-  [[ -n "$branch_state" ]] && echo "- Branch state: $branch_state"
-  [[ -n "$base_branch" ]] && echo "- Base branch: $base_branch"
-  [[ -n "$platform" ]] && echo "- Platform: $platform"
-  [[ -n "$decision_hint" ]] && echo "- Ship mode hint: $decision_hint"
-  [[ -n "$branch_rescue" && "$branch_rescue" != "none" ]] && echo "- Branch rescue: $branch_rescue"
-  [[ -n "$rescue_action" ]] && echo "- Rescue action: $rescue_action"
-  [[ -n "$pr_status" ]] && echo "- PR status: $pr_status"
-  [[ -n "$pr_url" ]] && echo "- PR url: $pr_url"
-  echo "- Roadmap progress: $roadmap_sync_summary"
-  [[ -f "$handoff_dir/pr-brief.md" ]] && echo "- PR brief: ready"
-  [[ -f "$handoff_dir/release-note.md" ]] && echo "- Release note: ready"
-  [[ -f "$handoff_dir/resume-index.md" ]] && echo "- Resume index: ready"
-  [[ -f "$handoff_dir/doc-sync-report.md" ]] && echo "- Doc sync report: ready"
-}

package/.claude/skills/cc-act/scripts/sync-act-docs.sh

@@ -1,355 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-# ------------------------------------------------------------
-# cc-act: 同步 requirement 级文档，并产出 doc sync 报告
-# ------------------------------------------------------------
-
-usage() {
-  cat <<'EOF'
-Usage: sync-act-docs.sh --dir path/to/change [--repo-root path/to/repo]
-EOF
-}
-
-REQ_DIR=""
-REPO_ROOT=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dir) REQ_DIR="$2"; shift 2 ;;
-    --repo-root) REPO_ROOT="$2"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    *) echo "Unknown arg: $1" >&2; usage; exit 1 ;;
-  esac
-done
-
-if [[ -z "$REQ_DIR" || ! -d "$REQ_DIR" ]]; then
-  usage
-  exit 1
-fi
-
-if [[ -z "$REPO_ROOT" ]]; then
-  REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-fi
-
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$script_dir/cc-act-common.sh"
-CHANGE_DIR="$(req_act_change_dir "$REQ_DIR")"
-report_card="$(req_act_report_path "$CHANGE_DIR")"
-manifest="$(req_act_manifest_path "$CHANGE_DIR")"
-tasks_file="$(req_act_tasks_path "$CHANGE_DIR")"
-design_file="$(req_act_contract_path "$CHANGE_DIR")"
-resume_index="$(req_act_resume_index_path "$CHANGE_DIR")"
-release_note="$(req_act_release_note_path "$CHANGE_DIR")"
-doc_sync_report="$(req_act_doc_sync_report_path "$CHANGE_DIR")"
-
-"$script_dir/verify-act-gate.sh" --dir "$CHANGE_DIR" >/dev/null
-mkdir -p "$(dirname "$resume_index")"
-
-ship_context="$("$script_dir/detect-ship-target.sh" 2>/dev/null || true)"
-current_branch="$(req_act_ship_field "$ship_context" "CURRENT_BRANCH")"
-branch_state="$(req_act_ship_field "$ship_context" "BRANCH_STATE")"
-branch_rescue="$(req_act_ship_field "$ship_context" "BRANCH_RESCUE")"
-rescue_action="$(req_act_ship_field "$ship_context" "RESCUE_ACTION")"
-base_branch="$(req_act_ship_field "$ship_context" "BASE_BRANCH")"
-ship_mode="$(req_act_ship_field "$ship_context" "DECISION_HINT")"
-pr_status="$(req_act_ship_field "$ship_context" "PR_STATUS")"
-pr_url="$(req_act_ship_field "$ship_context" "PR_URL")"
-
-timestamp="$(date '+%Y-%m-%d %H:%M:%S %z')"
-requirement_id="$(req_act_requirement_id "$manifest" "$CHANGE_DIR")"
-report_summary="$(req_act_report_summary "$report_card")"
-report_verdict="$(req_act_report_verdict "$report_card")"
-spec_sync_ready="$(req_act_spec_sync_ready "$report_card")"
-output_language="$(req_act_output_language "$report_card")"
-design_goal="$(req_act_design_goal "$design_file")"
-main_risk="$(req_act_main_risk "$design_file")"
-roadmap_sync_summary="$(req_act_roadmap_sync_summary "$manifest" "$REPO_ROOT")"
-
-tmp_changed="$(mktemp)"
-tmp_verify="$(mktemp)"
-tmp_followups="$(mktemp)"
-tmp_touched="$(mktemp)"
-tmp_specs="$(mktemp)"
-tmp_claude="$(mktemp)"
-tmp_readme="$(mktemp)"
-cleanup() {
-  rm -f "$tmp_changed" "$tmp_verify" "$tmp_followups" "$tmp_touched" "$tmp_specs" "$tmp_claude" "$tmp_readme"
-}
-trap cleanup EXIT
-
-# ------------------------------------------------------------
-# 共享提取：变更 / 验证 / follow-up / touched
-# ------------------------------------------------------------
-req_act_collect_completed_titles "$manifest" "$tasks_file" "$tmp_changed"
-req_act_collect_verification_commands "$manifest" "$tmp_verify"
-req_act_collect_followups "$report_card" "$manifest" "$tmp_followups"
-req_act_collect_touched_files "$manifest" "$tmp_touched"
-req_act_collect_spec_files "$manifest" "$tmp_specs"
-
-nearest_claude() {
-  local rel="$1"
-  local dir candidate
-
-  if [[ -z "$rel" ]]; then
-    return 0
-  fi
-
-  dir="$(dirname "$rel")"
-  while :; do
-    if [[ "$dir" == "." ]]; then
-      candidate="$REPO_ROOT/CLAUDE.md"
-    else
-      candidate="$REPO_ROOT/$dir/CLAUDE.md"
-    fi
-    if [[ -f "$candidate" ]]; then
-      printf '%s\n' "${candidate#$REPO_ROOT/}"
-      return 0
-    fi
-    if [[ "$dir" == "." || "$dir" == "/" ]]; then
-      break
-    fi
-    dir="$(dirname "$dir")"
-  done
-
-  if [[ -f "$REPO_ROOT/CLAUDE.md" ]]; then
-    printf '%s\n' "CLAUDE.md"
-  fi
-}
-
-while IFS= read -r touched; do
-  nearest_claude "$touched" >> "$tmp_claude" || true
-done < "$tmp_touched"
-awk 'NF && !seen[$0]++' "$tmp_claude" > "${tmp_claude}.dedup"
-mv "${tmp_claude}.dedup" "$tmp_claude"
-
-find "$REPO_ROOT" -maxdepth 2 -type f \( -iname 'README.md' -o -iname 'README*.md' \) \
-  -print 2>/dev/null | sed "s|^$REPO_ROOT/||" | awk '!seen[$0]++' > "$tmp_readme" || true
-
-# ------------------------------------------------------------
-# 生成 release note
-# ------------------------------------------------------------
-{
-  echo "# Release Note"
-  echo
-  echo "## Document Meta"
-  echo
-  echo "- Output language: $output_language"
-  echo
-  echo "## User Impact"
-  if [[ -n "$report_summary" ]]; then
-    echo
-    echo "- $report_summary"
-  fi
-  if [[ -n "$design_goal" && "$design_goal" != "$report_summary" ]]; then
-    echo "- $design_goal"
-  fi
-  if [[ ! -s "$tmp_changed" && -z "$report_summary" && -z "$design_goal" ]]; then
-    echo
-    echo "- No user-facing summary captured yet."
-  fi
-  echo
-  echo "## What Is New"
-  if [[ -s "$tmp_changed" ]]; then
-    while IFS= read -r line; do
-      echo "- $line"
-    done < "$tmp_changed"
-  else
-    echo
-    echo "- No completed task list captured yet."
-  fi
-  echo
-  echo "## Verification"
-  echo
-  echo "- CC-Check verdict: $report_verdict"
-  jq -r '(.evidence // [])[]?' "$report_card" 2>/dev/null | sed '/^$/d' | while IFS= read -r line; do
-    echo "- $line"
-  done
-  if [[ -s "$tmp_verify" ]]; then
-    while IFS= read -r cmd; do
-      echo "- Verify with: \`$cmd\`"
-    done < "$tmp_verify"
-  fi
-  echo
-  echo "## Ops Notes"
-  echo
-  echo "- Ship mode: $ship_mode"
-  [[ -n "$branch_state" ]] && echo "- Branch state: $branch_state"
-  echo "- Spec sync ready: $spec_sync_ready"
-  echo "- Current branch: ${current_branch:-unknown}"
-  echo "- Base branch: ${base_branch:-unknown}"
-  [[ -n "$branch_rescue" && "$branch_rescue" != "none" ]] && echo "- Branch rescue: $branch_rescue"
-  [[ -n "$rescue_action" ]] && echo "- Rescue action: $rescue_action"
-  [[ -n "$pr_status" ]] && echo "- PR status: $pr_status"
-  [[ -n "$pr_url" ]] && echo "- PR url: $pr_url"
-  echo "- Roadmap progress: $roadmap_sync_summary"
-  echo
-  echo "## Roadmap Progress"
-  echo
-  echo "- $roadmap_sync_summary"
-  echo
-  echo "## Follow-Ups"
-  if [[ -s "$tmp_followups" ]]; then
-    echo
-    while IFS= read -r line; do
-      echo "- $line"
-    done < "$tmp_followups"
-  else
-    echo
-    echo "- None recorded."
-  fi
-} > "$release_note"
-
-# ------------------------------------------------------------
-# 生成 resume index
-# ------------------------------------------------------------
-next_action="Refresh handoff and close the requirement."
-case "$ship_mode" in
-  create-pr) next_action="Push current branch and create PR / MR from pr-brief.md." ;;
-  update-pr) next_action="Refresh the open PR / MR body and resolve outstanding review feedback." ;;
-  local-handoff) next_action="Hand off with pr-brief.md and this resume index." ;;
-  post-merge-closeout) next_action="Run release note/backlog writeback, then run cc-devflow archive-change $requirement_id and verify the archive path." ;;
-esac
-if [[ "$branch_rescue" == "create-branch-before-pr" ]]; then
-  next_action="Run ensure-ship-branch.sh, rerun final verification, then push the named branch and create PR / MR from pr-brief.md."
-elif [[ "$branch_rescue" == "create-local-branch-or-handoff" ]]; then
-  next_action="Run ensure-ship-branch.sh before local closeout, or keep local-handoff only if no branch should be created."
-fi
-
-{
-  echo "# Resume Index"
-  echo
-  echo "## Document Meta"
-  echo
-  echo "- Output language: $output_language"
-  echo
-  echo "- Requirement: $requirement_id"
-  echo "- Current stage: cc-act"
-  echo "- Current task: ship:$ship_mode"
-  [[ -n "$branch_state" ]] && echo "- Branch state: $branch_state"
-  if [[ -s "$tmp_followups" ]]; then
-    echo "- Ready tasks: follow-up review"
-  else
-    echo "- Ready tasks: none"
-  fi
-  echo "- Updated at: $timestamp"
-  echo
-  echo "## Last Good Checkpoint"
-  echo
-  if [[ -n "$report_summary" ]]; then
-    echo "- $report_summary"
-  else
-    echo "- Req-Check passed; see review/report-card.json for evidence."
-  fi
-  echo "- Ship mode decided as \`$ship_mode\`."
-  [[ -n "$branch_rescue" && "$branch_rescue" != "none" ]] && echo "- Branch rescue: \`$branch_rescue\`."
-  [[ -n "$rescue_action" ]] && echo "- Rescue action: $rescue_action"
-  echo "- Roadmap progress: $roadmap_sync_summary"
-  [[ -n "$pr_url" ]] && echo "- Active PR / MR: $pr_url"
-  echo
-  echo "## Follow-Ups"
-  echo
-  if [[ -s "$tmp_followups" ]]; then
-    while IFS= read -r line; do
-      echo "- $line"
-    done < "$tmp_followups"
-  else
-    echo "- None."
-  fi
-  echo
-  echo "## Next Action"
-  echo
-  echo "- $next_action"
-  echo "- Formal spec sync belongs in cc-act before final ship closeout."
-  echo "- Roadmap progress must be synced through cc-roadmap before final closeout when a source RM exists."
-  echo
-  echo "## Parallel Notes"
-  echo
-  echo "- Safe to parallelize: documentation review, backlog wording, release note polish."
-  echo "- Must stay sequential: cc-check pass -> doc sync -> pr brief render -> ship action."
-} > "$resume_index"
-
-# ------------------------------------------------------------
-# 生成 doc sync 报告：要求人工关注的项目级文档目标
-# ------------------------------------------------------------
-{
-  echo "# Doc Sync Report"
-  echo
-  echo "## Document Meta"
-  echo
-  echo "- Output language: $output_language"
-  echo
-  echo "- Requirement: $requirement_id"
-  echo "- Ship mode: $ship_mode"
-  echo "- CC-Check verdict: $report_verdict"
-  echo "- Spec sync ready: $spec_sync_ready"
-  echo "- Updated at: $timestamp"
-  echo
-  echo "## Synced Requirement Artifacts"
-  echo
-  echo "- \`handoff/release-note.md\`: refreshed"
-  echo "- \`resume-index.md\`: refreshed"
-  echo
-  echo "## Touched Files"
-  echo
-  if [[ -s "$tmp_touched" ]]; then
-    while IFS= read -r line; do
-      echo "- \`$line\`"
-    done < "$tmp_touched"
-  else
-    echo "- No touched files recorded in task-manifest.json."
-  fi
-  echo
-  echo "## Spec Targets"
-  echo
-  if [[ -s "$tmp_specs" ]]; then
-    while IFS= read -r line; do
-      echo "- \`$line\`"
-    done < "$tmp_specs"
-  else
-    echo "- No capability spec files recorded in task-manifest.json."
-  fi
-  echo
-  echo "## Roadmap Targets"
-  echo
-  echo "- $roadmap_sync_summary"
-  echo
-  echo "## Project Doc Targets"
-  echo
-  echo "### CLAUDE Targets"
-  if [[ -s "$tmp_claude" ]]; then
-    echo
-    while IFS= read -r line; do
-      echo "- \`$line\`"
-    done < "$tmp_claude"
-  else
-    echo
-    echo "- No scoped \`CLAUDE.md\` target detected from touched files."
-  fi
-  echo
-  echo "### README Candidates"
-  if [[ -s "$tmp_readme" ]]; then
-    echo
-    while IFS= read -r line; do
-      echo "- \`$line\`"
-    done < "$tmp_readme"
-  else
-    echo
-    echo "- No README candidate found under repo root."
-  fi
-  echo
-  echo "## Manual Follow-Ups"
-  echo
-  echo "- Update the listed \`CLAUDE.md\` files if structure, workflow, or operational truth changed."
-  echo "- Update README candidates if user-visible behavior or setup flow changed."
-  echo "- Update \`devflow/roadmap.json\` via \`sync-roadmap-progress.sh\` when source RM status, progress, or follow-up truth changed."
-  echo "- Re-render \`pr-brief.md\` after any manual doc edits so the PR body stays in sync."
-  if [[ -n "$main_risk" ]]; then
-    echo "- Main risk to reflect in docs: $main_risk"
-  fi
-} > "$doc_sync_report"
-
-echo "Synced $release_note"
-echo "Synced $resume_index"
-echo "Wrote $doc_sync_report"