cc-devflow 4.5.10 → 4.5.12

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"

package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json

@@ -1,234 +0,0 @@
-{
-  "changeId": "REQ-123",
-  "outputPolicy": {
-    "documentLanguage": ""
-  },
-  "verdict": "blocked",
-  "overall": "fail",
-  "summary": "verdict=blocked quick=1/2 strict=0/0 review=blocked",
-  "specAlignment": "blocked",
-  "specDeltaVerified": false,
-  "specSyncReady": false,
-  "runtime": {
-    "status": "blocked",
-    "failureOwnership": [
-      {
-        "errorName": "MissingSpecReviewProof",
-        "failure": "missing spec review proof",
-        "classification": "in-branch",
-        "owner": "branch",
-        "touchedByDiff": true,
-        "artifactRefs": [
-          "planning/task-manifest.json",
-          "review/report-card.json"
-        ],
-        "evidence": "planning/task-manifest.json tasks[T002].reviews.spec is empty",
-        "rescueAction": "record spec review proof for T002 or reroute to cc-do",
-        "action": "reroute-cc-do",
-        "status": "open"
-      }
-    ]
-  },
-  "claimEvidence": [
-    {
-      "claim": "tests-pass",
-      "requiredProof": "fresh test command with exit 0 and 0 failures",
-      "commandOrArtifact": "npm test -- src/feature/feature.test.ts",
-      "exitStatus": 0,
-      "keyObservation": "targeted tests passed in this run",
-      "status": "pass"
-    },
-    {
-      "claim": "requirements-met",
-      "requiredProof": "line-by-line planning/tasks.md and task-manifest.json checklist",
-      "commandOrArtifact": "planning/tasks.md + planning/task-manifest.json",
-      "exitStatus": null,
-      "keyObservation": "T002 still lacks spec review proof",
-      "status": "blocked"
-    }
-  ],
-  "qa": {
-    "status": "blocked",
-    "feedbackLoop": {
-      "status": "blocked",
-      "mode": "targeted-test",
-      "commandOrArtifact": "npm test -- src/feature/feature.test.ts",
-      "speed": "fast",
-      "determinism": "high",
-      "signalSharpness": "targeted failure would indicate the user-visible behavior regressed",
-      "reproductionRate": "not recorded",
-      "attempts": [
-        "targeted unit test"
-      ],
-      "blockedReason": "red/green reproduction is not recorded yet"
-    },
-    "behaviorEvidence": {
-      "status": "blocked",
-      "userFacingBoundary": "feature behavior",
-      "expectedBehavior": "target behavior succeeds for the user",
-      "actualBehavior": "not proven yet",
-      "reproductionSteps": [
-        "run the targeted verification command"
-      ],
-      "consistency": "not recorded",
-      "domainLanguage": [
-        "feature behavior"
-      ]
-    },
-    "regressionProof": [
-      {
-        "behavior": "original symptom",
-        "redCommand": "",
-        "redFailure": "",
-        "greenCommand": "",
-        "greenObservation": "",
-        "restoredState": false
-      }
-    ],
-    "testQuality": [
-      {
-        "area": "targeted-tests",
-        "checksRealBehavior": true,
-        "mockBoundary": "none",
-        "testOnlyProductionApi": false,
-        "status": "pass"
-      }
-    ],
-    "coverageAudit": {
-      "status": "blocked",
-      "coveragePct": null,
-      "pathMap": ["planning/tasks.md#T002"],
-      "gaps": ["T002 has no spec review proof, so the requirement cannot be marked covered"],
-      "testsAdded": [],
-      "e2eRequired": false,
-      "evalRequired": false,
-      "qualityStars": "★"
-    },
-    "browserEvidence": {
-      "status": "skipped",
-      "mode": "not-applicable",
-      "affectedRoutes": [],
-      "screenshots": [],
-      "consoleErrors": [],
-      "healthScore": null,
-      "issues": [],
-      "skipReason": "template example is not a UI browser QA scenario"
-    },
-    "humanUat": {
-      "status": "skipped",
-      "required": false,
-      "scenario": "",
-      "tester": "",
-      "evidence": [],
-      "failure": "",
-      "reroute": "none",
-      "skipReason": "not required for this template scenario"
-    },
-    "architectureFollowUps": [
-      {
-        "summary": "Add the missing public test seam before widening coverage",
-        "currentBehavior": "review proof depends on task metadata instead of a direct behavior seam",
-        "desiredBehavior": "tests verify the behavior through a stable public interface",
-        "keyInterfaces": [
-          "feature public API"
-        ],
-        "acceptanceCriteria": [
-          "target behavior can be reproduced without private implementation hooks"
-        ],
-        "outOfScope": [
-          "rewriting unrelated modules"
-        ],
-        "status": "deferred-minor"
-      }
-    ],
-    "tddException": null
-  },
-  "quickGates": [
-    {
-      "name": "targeted-tests",
-      "status": "pass",
-      "command": "npm test -- src/feature/feature.test.ts",
-      "summary": "targeted tests passed"
-    },
-    {
-      "name": "review-proof",
-      "status": "blocked",
-      "command": "review artifacts",
-      "summary": "missing spec review proof for T002"
-    }
-  ],
-  "strictGates": [],
-  "review": {
-    "status": "blocked",
-    "summary": "Task review evidence is incomplete",
-    "details": "T002 is implemented, but the requirement still lacks spec review proof required by the gate.",
-    "freshness": {
-      "status": "unknown",
-      "reviewedCommit": "",
-      "currentCommit": "",
-      "commitsSinceReview": null,
-      "staleReason": "review range is not recorded yet"
-    },
-    "qualityScore": null,
-    "specialistReviews": [
-      {
-        "name": "testing",
-        "status": "blocked",
-        "required": true,
-        "summary": "testing facet cannot pass while task review proof is missing",
-        "skipReason": "",
-        "findings": []
-      }
-    ],
-    "taskReviews": {
-      "status": "blocked",
-      "required": true,
-      "summary": "T002 has no spec review record yet",
-      "reviewPacket": {
-        "baseSha": "",
-        "headSha": "",
-        "requirements": "planning/tasks.md#T002",
-        "implemented": "implementation report for T002",
-        "reviewerContext": "task spec and changed files"
-      },
-      "reviewers": [],
-      "findings": [
-        {
-          "severity": "important",
-          "confidence": "high",
-          "source": "task-review",
-          "summary": "T002 spec review proof is missing",
-          "evidence": "planning/task-manifest.json tasks[T002].reviews.spec is empty",
-          "action": "reroute-cc-do",
-          "rescueAction": "record spec review proof for T002 or return to cc-do",
-          "triageStatus": "clarification-needed",
-          "confidenceScore": 9,
-          "fingerprint": "task-review:T002:missing-spec-review",
-          "displayTier": "blocking",
-          "suppressionReason": null
-        }
-      ]
-    },
-    "diffReview": {
-      "status": "skipped",
-      "required": false,
-      "summary": "",
-      "reviewPacket": {
-        "baseSha": "",
-        "headSha": "",
-        "requirements": "planning/design.md",
-        "implemented": "",
-        "reviewerContext": ""
-      },
-      "reviewers": [],
-      "findings": []
-    },
-    "findings": []
-  },
-  "blockingFindings": [
-    "review: missing spec review proof for T002"
-  ],
-  "gaps": [],
-  "reroute": "cc-do",
-  "timestamp": "2026-04-15T12:00:00.000Z"
-}