cc-devflow 4.5.11 → 4.5.12

package/.claude/skills/cc-do/scripts/write-task-checkpoint.sh

@@ -1,92 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-# ------------------------------------------------------------
-# 兼容旧入口：只写必要的 CLI 事件，不再生成 checkpoint.json
-# ------------------------------------------------------------
-
-usage() {
-  cat <<'EOF'
-Usage:
-  write-task-checkpoint.sh --dir path/to/change --task T001 --status pending|running|passed|failed|skipped [--summary "..."] [--event context_ready] [--attempt 0] [--session session-id] [--next-action "..."] [--tdd-json '{"red":...}']
-EOF
-}
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/cc-do-common.sh"
-REQ_DIR=""
-TASK_ID=""
-STATUS=""
-SUMMARY=""
-EVENT_TYPE=""
-ATTEMPT="0"
-SESSION_ID=""
-NEXT_ACTION=""
-TDD_JSON=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --dir) REQ_DIR="$2"; shift 2 ;;
-    --task) TASK_ID="$(echo "$2" | tr '[:lower:]' '[:upper:]')"; shift 2 ;;
-    --status) STATUS="$2"; shift 2 ;;
-    --summary) SUMMARY="$2"; shift 2 ;;
-    --event) EVENT_TYPE="$2"; shift 2 ;;
-    --attempt) ATTEMPT="$2"; shift 2 ;;
-    --session) SESSION_ID="$2"; shift 2 ;;
-    --next-action) NEXT_ACTION="$2"; shift 2 ;;
-    --tdd-json) TDD_JSON="$2"; shift 2 ;;
-    -h|--help) usage; exit 0 ;;
-    *) echo "Unknown arg: $1" >&2; usage; exit 1 ;;
-  esac
-done
-
-if [[ -z "$REQ_DIR" || -z "$TASK_ID" || -z "$STATUS" ]]; then
-  usage
-  exit 1
-fi
-
-CHANGE_DIR="$(req_do_resolve_change_dir "$REQ_DIR")"
-manifest="$(req_do_manifest_path "$CHANGE_DIR")"
-change_id="$(jq -r '.changeId // .requirementId // "REQ-UNKNOWN"' "$manifest" 2>/dev/null || basename "$REQ_DIR")"
-timestamp="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
-runtime_task_dir="$(req_do_task_runtime_dir "$CHANGE_DIR" "$TASK_ID")"
-
-if [[ -z "$SESSION_ID" ]]; then
-  SESSION_ID="${TASK_ID}-$(date -u +%s)"
-fi
-
-tdd_payload="null"
-if [[ -n "$TDD_JSON" ]]; then
-  if [[ -f "$TDD_JSON" ]]; then
-    tdd_payload="$(jq -c . "$TDD_JSON")"
-  else
-    tdd_payload="$(printf '%s' "$TDD_JSON" | jq -c .)"
-  fi
-fi
-
-if [[ -n "$EVENT_TYPE" || "$STATUS" == "failed" ]]; then
-  mkdir -p "$runtime_task_dir"
-  jq -nc \
-    --arg type "${EVENT_TYPE:-status_$STATUS}" \
-    --arg changeId "$change_id" \
-    --arg taskId "$TASK_ID" \
-    --arg sessionId "$SESSION_ID" \
-    --arg status "$STATUS" \
-    --arg summary "$SUMMARY" \
-    --arg nextAction "$NEXT_ACTION" \
-    --arg timestamp "$timestamp" \
-    --argjson tdd "$tdd_payload" \
-    '{
-      type: $type,
-      changeId: $changeId,
-      taskId: $taskId,
-      sessionId: $sessionId,
-      status: $status,
-      summary: $summary,
-      nextAction: $nextAction,
-      timestamp: $timestamp
-    } + (if $tdd == null then {} else {tdd: $tdd} end)' >> "$runtime_task_dir/events.jsonl"
-fi
-
-echo "No checkpoint written; task truth lives in planning/tasks.md and planning/task-manifest.json"

package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json

@@ -1,224 +0,0 @@
-{
-  "changeId": "FIX-XXX",
-  "requirementId": "FIX-XXX",
-  "requirementVersion": "FIX-XXX.v1",
-  "outputPolicy": {
-    "documentLanguage": ""
-  },
-  "planningMeta": {
-    "ccInvestigateSkillVersion": "1.5.1",
-    "analysisVersion": "analysis.v1",
-    "workBranch": "FIX/XXX-short-bug-name",
-    "approvedAt": "2026-04-17T12:00:00.000Z",
-    "basedOnRootCause": "Root cause sentence"
-  },
-  "investigationMeta": {
-    "symptomStatus": "stable",
-    "reproductionPath": "npm test -- src/feature/feature.test.ts",
-    "feedbackLoop": {
-      "loopType": "failing-test",
-      "commandOrDriver": "npm test -- src/feature/feature.test.ts",
-      "expectedFailingSignal": "The test fails with the user-reported behavior",
-      "actualFailingSignal": "Observed failure output from the current repo",
-      "symptomMatchEvidence": "Failure output matches the reported symptom, not a nearby unrelated failure",
-      "runtime": "under 10s",
-      "determinism": "deterministic",
-      "failureRate": "100%",
-      "signalSpecificity": "asserts the exact broken behavior",
-      "sharpeningPlan": "Narrow setup or assertions if the loop becomes slow or broad",
-      "evidenceRequest": ""
-    },
-    "patternAnalysis": {
-      "selectedPattern": "null propagation",
-      "ruledOutPatterns": [
-        "race condition",
-        "performance regression",
-        "configuration drift",
-        "timing guess / flaky wait"
-      ],
-      "notes": "Pattern evidence belongs in planning/tasks.md#Root Cause Contract"
-    },
-    "boundaryProbes": [
-      {
-        "componentBoundary": "api -> service",
-        "inputObserved": "Request payload matches the reproduced failure",
-        "outputObserved": "Service receives invalid state",
-        "configEnvObserved": "Relevant env/config values recorded in planning/tasks.md#Root Cause Contract",
-        "stateObserved": "State snapshot or log pointer",
-        "verdict": "fail"
-      }
-    ],
-    "backwardTrace": {
-      "immediateFailureSite": "file:line or operation where the symptom appears",
-      "directCaller": "caller that passed the bad value or state",
-      "callerChain": [
-        "entrypoint",
-        "intermediate caller",
-        "failure site"
-      ],
-      "badValueOrigin": "where the invalid data/state first appears",
-      "originalTrigger": "user action, command, event, config, or dependency response that starts the chain",
-      "symptomSiteFixRejectedBecause": "Guarding only the failure site would leave the bad upstream contract intact"
-    },
-    "rootCauseProof": {
-      "symptomSite": "User-visible failure, command, UI state, log, or bad artifact",
-      "firstBadState": "First field, artifact, cache entry, queue message, config, response, or memory object that becomes invalid",
-      "firstBadStateEvidence": [
-        "Boundary probe or trace evidence from planning/tasks.md#Root Cause Contract"
-      ],
-      "violatedContract": "Schema, invariant, API contract, state transition, trust boundary, or timing condition violated",
-      "originalTrigger": "User action, command, event, recent diff, config change, or external response that created the first bad state",
-      "counterfactualProof": {
-        "method": "Restore the contract, replace input, roll back diff, fix config, or assert the boundary",
-        "expectedObservation": "The first bad state no longer forms and the symptom disappears",
-        "actualObservation": "Observed evidence from the current repo"
-      },
-      "escapeReason": "Why tests, types, validators, monitoring, review, or artifact gates missed it",
-      "status": "confirmed"
-    },
-    "referenceComparison": {
-      "similarWorkingExample": "path/to/working/example",
-      "brokenPath": "path/to/broken/path",
-      "differencesFound": [
-        "Working path validates input before persistence"
-      ],
-      "differencesAcceptedAsHypothesis": [
-        "Missing validation before persistence"
-      ],
-      "differencesRuledOut": []
-    },
-    "diagnosticInstrumentation": [
-      {
-        "probeTag": "[DEBUG-FIXXXX-a4f2]",
-        "probeLocation": "file:line or component boundary",
-        "questionAnswered": "Which boundary first emits the invalid value?",
-        "commandToRun": "npm test -- src/feature/feature.test.ts",
-        "expectedSignal": "Probe records invalid value before the failure site",
-        "actualSignal": "Observed evidence from the current repo",
-        "cleanupRequirement": "Remove temporary probe or convert it into a durable assertion/log"
-      }
-    ],
-    "candidateHypotheses": [
-      {
-        "rank": 1,
-        "statement": "Specific, testable root-cause claim",
-        "whyPlausible": "Reproduction output points to the affected contract",
-        "prediction": "The failing signal disappears when that contract is restored",
-        "status": "accepted-for-testing"
-      }
-    ],
-    "priorInvestigations": [],
-    "researchEvidence": [],
-    "domainDecisionContext": {
-      "contextFilesRead": [],
-      "adrFilesRead": [],
-      "vocabularyNotes": [],
-      "adrConflicts": []
-    },
-    "rootCauseHypothesis": {
-      "statement": "Specific, testable root-cause claim",
-      "falsificationMethod": "Command, log probe, assertion, or code-path check",
-      "expectedObservation": "What should be observed if the hypothesis is true",
-      "actualObservation": "Observed evidence from the current repo",
-      "status": "confirmed"
-    },
-    "rootCauseClass": "code",
-    "noCodeRootCause": {
-      "whyNotCodeRootCause": "",
-      "monitoringOrFutureEvidenceNeeded": "",
-      "operatorHandlingAfterFix": ""
-    },
-    "hypothesisAttempts": [
-      {
-        "statement": "Specific, testable root-cause claim",
-        "status": "confirmed",
-        "evidenceFor": [
-          "Reproduction output points to the affected code path"
-        ],
-        "evidenceAgainst": [],
-        "falsificationMethod": "Run the reproduction command"
-      }
-    ],
-    "escalationDecision": {
-      "failedHypothesisCount": 0,
-      "nextOption": "cc-do",
-      "recommendation": "Repair the confirmed root cause"
-    },
-    "correctTestSeam": {
-      "testSeam": "public interface or end-to-end path that reaches the real trigger chain",
-      "publicInterfaceExercised": "CLI/API/UI behavior observed by callers",
-      "realTriggerChainCoverage": "The test enters through the same trigger path as the bug",
-      "whyShallowTestRejected": "A lower-level unit test would not prove the upstream contract",
-      "ifNoCorrectSeam": ""
-    },
-    "repairBoundary": {
-      "affectedModule": "src/feature",
-      "allowedFiles": [
-        "src/feature/feature.ts",
-        "src/feature/feature.test.ts"
-      ],
-      "forbiddenFiles": [
-        "unrelated modules"
-      ],
-      "blastRadiusFileCount": 2,
-      "blastRadiusRisk": "low",
-      "splitOrRerouteDecision": "single focused repair"
-    }
-  },
-  "currentTaskId": "T001",
-  "tasks": [
-    {
-      "id": "T001",
-      "title": "[TEST] Capture the bug as a failing reproduction",
-      "phase": 1,
-      "status": "pending",
-      "dependsOn": [],
-      "parallel": false,
-      "touches": [
-        "tests",
-        "bug-reproduction"
-      ],
-      "files": [
-        "src/feature/feature.test.ts"
-      ],
-      "acceptance": [
-        "The target bug is reproduced as a stable failure",
-        "The failing loop matches the user-reported symptom",
-        "The regression test uses the correct seam for the real trigger chain",
-        "The failure output points to the confirmed root-cause path",
-        "The reproduction preserves evidence for first bad state and original trigger"
-      ],
-      "verification": [
-        "npm test -- src/feature/feature.test.ts"
-      ],
-      "evidence": [
-        "Failing test output"
-      ],
-      "context": {
-        "readFiles": [
-          "tasks.md",
-          "change-meta.json"
-        ],
-        "commands": [
-          "npm test -- src/feature/feature.test.ts"
-        ],
-        "notes": [
-          "Prove the bug first",
-          "Do not repair the symptom site unless Root Cause Contract proves it is the original trigger",
-          "Do not change unrelated contracts in this task"
-        ]
-      },
-      "reviews": {
-        "spec": "pending",
-        "code": "pending"
-      },
-      "type": "TEST",
-      "run": [
-        "npm test -- src/feature/feature.test.ts"
-      ],
-      "checks": [],
-      "attempts": 0,
-      "maxRetries": 1
-    }
-  ]
-}

package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json

@@ -1,178 +0,0 @@
-{
-  "changeId": "REQ-XXX",
-  "goal": "Deliver planned requirement changes safely.",
-  "createdAt": "2026-05-11T00:00:00.000Z",
-  "updatedAt": "2026-05-11T00:00:00.000Z",
-  "requirementId": "REQ-XXX",
-  "requirementVersion": "REQ-XXX.v1",
-  "outputPolicy": {
-    "documentLanguage": ""
-  },
-  "planningMeta": {
-    "reqPlanSkillVersion": "3.9.2",
-    "designVersion": "design.v1",
-    "workBranch": "REQ/XXX-short-feature-name",
-    "approvedAt": "2026-04-15T12:00:00.000Z",
-    "basedOnOption": "Option A",
-    "aiLeverageDecisionLens": {
-      "realUserOrOperator": "",
-      "statusQuoWorkaround": "",
-      "humanTeamEffortForFullScope": "",
-      "ccAgentEffortForFullScope": "",
-      "aiCompressionRatio": "",
-      "completeLakeBoundary": "",
-      "oceanBoundary": "",
-      "scopeRecommendation": "sharp-wedge",
-      "costModel": {
-        "agentTime": "",
-        "humanReviewTime": "",
-        "verificationCost": "",
-        "maintenanceCost": "",
-        "failureCost": "",
-        "reversibility": ""
-      },
-      "verdict": "sharp-wedge",
-      "missingEvidenceOrPivotReason": "",
-      "impactOnApprovedDirection": ""
-    },
-    "externalBestPractice": {
-      "needed": false,
-      "decisionStatus": "not-needed",
-      "decisionQuestionId": "",
-      "privacyGuard": "generalized terms only; no project names, private requirements, customer names, secrets, logs, or proprietary concepts",
-      "generalizedSearchTerms": [],
-      "sourcesChecked": [],
-      "conventionalWisdom": "",
-      "currentDiscourse": "",
-      "repoFitVerdict": "skipped",
-      "designImpacts": [],
-      "skippedReason": "repo evidence is sufficient for this plan"
-    },
-    "decisionQuestions": [
-      {
-        "questionId": "D1",
-        "gate": "approach-approval",
-        "knownEvidence": [],
-        "recommendation": "Option A",
-        "options": [
-          {
-            "id": "A",
-            "label": "Minimal viable",
-            "recommended": true,
-            "completeness": "7/10",
-            "good": "",
-            "costRisk": ""
-          },
-          {
-            "id": "B",
-            "label": "Ideal architecture",
-            "recommended": false,
-            "completeness": "10/10",
-            "good": "",
-            "costRisk": ""
-          }
-        ],
-        "userChoice": "A",
-        "impact": "cc-do follows the approved implementation surface and task split",
-        "status": "answered"
-      }
-    ]
-  },
-  "currentTaskId": "T001",
-  "tasks": [
-    {
-      "id": "T001",
-      "title": "[TEST] Add a failing test for the missing behavior",
-      "type": "TEST",
-      "phase": 1,
-      "contract": {
-        "sourceFunnelRounds": [
-          "Requirement Reality",
-          "Interface & Data Contract",
-          "Task Contract"
-        ],
-        "userStory": "US-001",
-        "edgeOrRecoveryStory": "US-EDGE-001",
-        "fileResponsibility": "tests own behavior proof",
-        "methodOrInterface": "public interface / caller flow / CLI / API / UI / trace replay / harness",
-        "keyFields": [],
-        "inputOutput": "",
-        "failurePath": "The behavior is currently missing",
-        "afkOrHitl": "AFK",
-        "doNotRedecide": [
-          "target behavior",
-          "public seam",
-          "key fields",
-          "allowed mock boundary"
-        ],
-        "artifactUpdates": [
-          "src/feature/feature.test.ts"
-        ]
-      },
-      "parallel": false,
-      "dependsOn": [],
-      "touches": [
-        "tests",
-        "requirement-behavior"
-      ],
-      "files": [
-        "src/feature/feature.test.ts"
-      ],
-      "run": [
-        "npm test -- src/feature/feature.test.ts"
-      ],
-      "acceptance": [
-        "The target behavior is reproduced as a failing test",
-        "The failure message points to the missing requirement behavior"
-      ],
-      "verification": [
-        "npm test -- src/feature/feature.test.ts"
-      ],
-      "evidence": [
-        "Failing test output"
-      ],
-      "context": {
-        "readFiles": [
-          "tasks.md",
-          "change-meta.json"
-        ],
-        "commands": [
-          "npm test -- src/feature/feature.test.ts"
-        ],
-        "notes": [
-          "Write the failing test first",
-          "Do not change unrelated contracts in this task",
-          "Do not generate execution context.md, checkpoint.json, review markdown, or AI-written process files"
-        ]
-      },
-      "reviews": {
-        "spec": "pending",
-        "code": "pending"
-      },
-      "status": "pending",
-      "tddPhase": "red",
-      "verticalSlice": "Slice 1",
-      "testSeam": {
-        "entry": "public interface / caller flow / CLI / API / UI / trace replay / harness",
-        "behaviorAsserted": "The user or caller observable behavior that should exist",
-        "specStyleTestName": "caller can observe the required behavior",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Read back through the same public interface or user-visible path",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": "Fails because the target behavior is missing"
-      },
-      "checks": [],
-      "attempts": 0,
-      "maxRetries": 1
-    }
-  ],
-  "metadata": {
-    "source": "tasks.md",
-    "generatedBy": "cc-devflow task-contract",
-    "planVersion": 1
-  }
-}

package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json

@@ -1,28 +0,0 @@
-{
-  "changeId": "REQ-001",
-  "requirementId": "REQ-001",
-  "outputPolicy": {
-    "documentLanguage": ""
-  },
-  "sourceRoadmap": {
-    "itemId": "RM-001",
-    "roadmapVersion": "roadmap.v1",
-    "roadmapSkillVersion": "4.1.0"
-  },
-  "spec": {
-    "primaryCapability": "cap-example",
-    "secondaryCapabilities": [],
-    "changeType": "update",
-    "specFiles": [
-      "devflow/specs/capabilities/cap-example.md"
-    ],
-    "expectedDelta": [
-      "Describe the new truth the change should add or tighten"
-    ],
-    "affectedInvariants": [],
-    "gapsClosed": [],
-    "newGaps": [],
-    "syncStatus": "planned",
-    "notes": []
-  }
-}

package/.claude/skills/cc-spec-init/scripts/validate-spec-links.sh

@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-# ------------------------------------------------------------
-# 校验 spec / roadmap / change 链路是否断裂
-# ------------------------------------------------------------
-
-ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-INDEX_FILE="$ROOT/devflow/specs/INDEX.md"
-CAP_DIR="$ROOT/devflow/specs/capabilities"
-FAILED=0
-
-if [[ ! -f "$INDEX_FILE" ]]; then
-  echo "Missing devflow/specs/INDEX.md" >&2
-  exit 1
-fi
-
-if [[ ! -d "$CAP_DIR" ]]; then
-  echo "Missing devflow/specs/capabilities/" >&2
-  exit 1
-fi
-
-while IFS= read -r capability; do
-  [[ -z "$capability" ]] && continue
-  if [[ ! -f "$CAP_DIR/$capability.md" ]]; then
-    echo "Dangling capability in INDEX.md: $capability" >&2
-    FAILED=1
-  fi
-done < <(awk -F'|' '/^\|/ {id=$2; gsub(/^[[:space:]]+|[[:space:]]+$/, "", id); if (id != "" && id != "Capability ID" && id !~ /^-+$/) print id}' "$INDEX_FILE")
-
-while IFS= read -r meta; do
-  primary="$(jq -r '.spec.primaryCapability // empty' "$meta" 2>/dev/null || true)"
-  [[ -z "$primary" ]] && continue
-  if [[ ! -f "$CAP_DIR/$primary.md" ]]; then
-    echo "Dangling primary capability in ${meta#$ROOT/}: $primary" >&2
-    FAILED=1
-  fi
-done < <(find "$ROOT/devflow/changes" -maxdepth 2 -name change-meta.json -type f 2>/dev/null | sort)
-
-if [[ "$FAILED" -ne 0 ]]; then
-  exit 1
-fi
-
-echo "Spec links are valid"