cc-devflow 4.5.10 → 4.5.12

package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json

@@ -1,488 +0,0 @@
-{
-  "changeId": "REQ-002",
-  "goal": "Add a trustworthy CSV bulk invite flow for admins without inventing row-outcome semantics during execution.",
-  "createdAt": "2026-04-16T09:00:00.000Z",
-  "updatedAt": "2026-04-16T12:00:00.000Z",
-  "requirementId": "REQ-002",
-  "requirementVersion": "REQ-002.v2",
-  "planningMeta": {
-    "reqPlanSkillVersion": "3.9.0",
-    "designVersion": "design.v2",
-    "workBranch": "REQ/002-bulk-invite-import",
-    "approvedAt": null,
-    "basedOnOption": "Option B",
-    "aiLeverageDecisionLens": {
-      "realUserOrOperator": "workspace admin onboarding larger teams",
-      "statusQuoWorkaround": "paste invite emails one by one or track them in spreadsheets",
-      "humanTeamEffortForFullScope": "multiple weeks across product, engineering, billing, and support review",
-      "ccAgentEffortForFullScope": "several hours once row semantics are approved, but unbounded before that",
-      "aiCompressionRatio": "high after semantics freeze, low while the product contract is ambiguous",
-      "completeLakeBoundary": "row classification, admin upload flow, billing-seat checks, and audit mapping after rule approval",
-      "oceanBoundary": "SCIM, background retries, rollback wizard, and unspecified billing semantics",
-      "scopeRecommendation": "sharp-wedge",
-      "costModel": {
-        "agentTime": "medium after rule approval",
-        "humanReviewTime": "high until semantics are approved",
-        "verificationCost": "bulk rules, admin flow, billing, and audit tests",
-        "maintenanceCost": "medium after semantics freeze",
-        "failureCost": "high if billing or audit outcomes drift",
-        "reversibility": "limited once execution semantics ship"
-      },
-      "verdict": "sharp-wedge",
-      "missingEvidenceOrPivotReason": "none at plan approval; cc-check later reopened duplicate, invalid-row, partial-success, and seat-limit semantics before retry or cc-act",
-      "impactOnApprovedDirection": "allow bounded import-path execution, then block final proof if review finds row semantics drift"
-    },
-    "externalBestPractice": {
-      "needed": true,
-      "decisionStatus": "declined",
-      "decisionQuestionId": "D2",
-      "privacyGuard": "generalized terms only; no project names, private requirements, customer names, secrets, logs, or proprietary concepts",
-      "generalizedSearchTerms": [
-        "bulk invite CSV import validation best practices"
-      ],
-      "sourcesChecked": [],
-      "conventionalWisdom": "",
-      "currentDiscourse": "",
-      "repoFitVerdict": "skipped",
-      "designImpacts": [
-        "keep the design blocked until row-outcome semantics are approved from internal evidence"
-      ],
-      "skippedReason": "user kept the example repo-local for the blocked design"
-    },
-    "decisionQuestions": [
-      {
-        "questionId": "D1",
-        "gate": "approach-approval",
-        "knownEvidence": [
-          "Best-effort upload would hide duplicate, invalid, and seat-limit semantics",
-          "Audit mapping depends on deterministic row outcomes"
-        ],
-        "recommendation": "Choose Option B and freeze a rule matrix first",
-        "options": [
-          {
-            "id": "A",
-            "label": "Front-end-only CSV upload",
-            "recommended": false,
-            "completeness": "5/10",
-            "good": "Fastest prototype and reuses the existing single-invite API",
-            "costRisk": "Lets hidden backend edge cases define user-visible semantics"
-          },
-          {
-            "id": "B",
-            "label": "Rule matrix first",
-            "recommended": true,
-            "completeness": "9/10",
-            "good": "Makes billing, duplicate, invalid, and audit behavior reviewable",
-            "costRisk": "Requires one more planning pass before execution can start"
-          }
-        ],
-        "userChoice": "B",
-        "impact": "cc-do stays blocked until row outcomes are modeled",
-        "status": "answered"
-      },
-      {
-        "questionId": "D2",
-        "gate": "external-best-practice",
-        "knownEvidence": [
-          "Bulk CSV import semantics could benefit from generalized external practice",
-          "The example keeps private details out of any external lookup"
-        ],
-        "recommendation": "Stay repo-local for this blocked example",
-        "options": [
-          {
-            "id": "A",
-            "label": "Search generalized best practices",
-            "recommended": false,
-            "completeness": "9/10",
-            "good": "Could improve row-outcome terminology before task generation",
-            "costRisk": "Sends generalized category terms outside the local repo"
-          },
-          {
-            "id": "B",
-            "label": "Stay repo-local",
-            "recommended": true,
-            "completeness": "7/10",
-            "good": "Keeps the blocked example private and focused on internal semantics",
-            "costRisk": "Does not compare against external CSV-import conventions"
-          }
-        ],
-        "userChoice": "B",
-        "impact": "cc-do still must not start implementation until row outcomes are answered from internal evidence",
-        "status": "answered"
-      },
-      {
-        "questionId": "D3",
-        "gate": "review-blocker",
-        "knownEvidence": [
-          "Duplicate and seat-limit outcomes are still not explicit enough for final requirement proof",
-          "Audit entries must match visible row outcomes"
-        ],
-        "recommendation": "Answer the row-outcome matrix before retry or cc-act",
-        "options": [
-          {
-            "id": "A",
-            "label": "Block execution until matrix is explicit",
-            "recommended": true,
-            "completeness": "10/10",
-            "good": "Prevents cc-do from inventing semantics during implementation",
-            "costRisk": "Requires user/product input before coding can continue"
-          },
-          {
-            "id": "B",
-            "label": "Let implementation choose defaults",
-            "recommended": false,
-            "completeness": "4/10",
-            "good": "Starts coding sooner with fewer planning minutes",
-            "costRisk": "Creates invisible product decisions inside implementation tasks"
-          }
-        ],
-        "userChoice": null,
-        "impact": "cc-do retry and cc-act must stay blocked until this is answered",
-        "status": "asked"
-      }
-    ]
-  },
-  "currentTaskId": null,
-  "tasks": [
-    {
-      "id": "T001",
-      "title": "[TEST] Add failing tests for duplicate and over-limit row outcomes",
-      "type": "TEST",
-      "phase": 1,
-      "parallel": false,
-      "dependsOn": [],
-      "touches": [
-        "bulk-invite-rules"
-      ],
-      "files": [
-        "src/invite/bulk-import.test.ts"
-      ],
-      "run": [
-        "npm test -- src/invite/bulk-import.test.ts"
-      ],
-      "checks": [
-        "tests fail before implementation"
-      ],
-      "acceptance": [
-        "dangerous row outcomes are reproduced as explicit failing tests"
-      ],
-      "verification": [
-        "npm test -- src/invite/bulk-import.test.ts"
-      ],
-      "evidence": [
-        "failing test output"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/invite/bulk-import.ts"
-        ],
-        "commands": [
-          "npm test -- src/invite/bulk-import.test.ts"
-        ],
-        "notes": [
-          "freeze row semantics before broader execution"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "red",
-      "verticalSlice": "Slice 1",
-      "testSeam": {
-        "entry": "bulk invite rules and admin upload UI behavior",
-        "behaviorAsserted": "dangerous row outcomes are reproduced as explicit failing tests",
-        "specStyleTestName": "dangerous row outcomes are reproduced as explicit failing tests",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the bulk invite rule and admin panel tests through their public flows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": "Fails before the behavior exists"
-      }
-    },
-    {
-      "id": "T002",
-      "title": "[IMPL] Implement the initial bulk invite row classification",
-      "type": "IMPL",
-      "phase": 1,
-      "parallel": false,
-      "dependsOn": [
-        "T001"
-      ],
-      "touches": [
-        "bulk-invite-rules"
-      ],
-      "files": [
-        "src/invite/bulk-import.ts"
-      ],
-      "run": [
-        "npm test -- src/invite/bulk-import.test.ts"
-      ],
-      "checks": [
-        "rule tests pass"
-      ],
-      "acceptance": [
-        "bulk invite rows receive deterministic initial states"
-      ],
-      "verification": [
-        "npm test -- src/invite/bulk-import.test.ts"
-      ],
-      "evidence": [
-        "passing test output",
-        "CLI log summary"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/invite/bulk-import.test.ts"
-        ],
-        "commands": [
-          "npm test -- src/invite/bulk-import.test.ts"
-        ],
-        "notes": [
-          "do not invent partial-failure semantics outside the approved design"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "green",
-      "verticalSlice": "Slice 2",
-      "testSeam": {
-        "entry": "bulk invite rules and admin upload UI behavior",
-        "behaviorAsserted": "bulk invite rows receive deterministic initial states",
-        "specStyleTestName": "bulk invite rows receive deterministic initial states",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the bulk invite rule and admin panel tests through their public flows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    },
-    {
-      "id": "T003",
-      "title": "[TEST] Add failing admin panel tests for mixed CSV results",
-      "type": "TEST",
-      "phase": 2,
-      "parallel": false,
-      "dependsOn": [
-        "T002"
-      ],
-      "touches": [
-        "admin-bulk-invite-ui"
-      ],
-      "files": [
-        "src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "run": [
-        "npm test -- src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "checks": [
-        "admin panel tests fail before UI integration"
-      ],
-      "acceptance": [
-        "mixed row outcomes are visible as UI failures before implementation"
-      ],
-      "verification": [
-        "npm test -- src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "evidence": [
-        "failing test output"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/admin/BulkInvitePanel.tsx"
-        ],
-        "commands": [
-          "npm test -- src/admin/BulkInvitePanel.test.tsx"
-        ],
-        "notes": [
-          "UI must not hide ambiguous row states"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "red",
-      "verticalSlice": "Slice 3",
-      "testSeam": {
-        "entry": "bulk invite rules and admin upload UI behavior",
-        "behaviorAsserted": "mixed row outcomes are visible as UI failures before implementation",
-        "specStyleTestName": "mixed row outcomes are visible as UI failures before implementation",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the bulk invite rule and admin panel tests through their public flows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": "Fails before the behavior exists"
-      }
-    },
-    {
-      "id": "T004",
-      "title": "[IMPL] Render bulk invite results in the admin panel",
-      "type": "IMPL",
-      "phase": 2,
-      "parallel": false,
-      "dependsOn": [
-        "T003"
-      ],
-      "touches": [
-        "admin-bulk-invite-ui"
-      ],
-      "files": [
-        "src/admin/BulkInvitePanel.tsx"
-      ],
-      "run": [
-        "npm test -- src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "checks": [
-        "admin panel tests pass"
-      ],
-      "acceptance": [
-        "admins can see accepted, skipped, and rejected rows in the panel"
-      ],
-      "verification": [
-        "npm test -- src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "evidence": [
-        "passing test output",
-        "review notes"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/admin/BulkInvitePanel.test.tsx"
-        ],
-        "commands": [
-          "npm test -- src/admin/BulkInvitePanel.test.tsx"
-        ],
-        "notes": [
-          "surface row states without redefining backend truth"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "green",
-      "verticalSlice": "Slice 3",
-      "testSeam": {
-        "entry": "bulk invite rules and admin upload UI behavior",
-        "behaviorAsserted": "admins can see accepted, skipped, and rejected rows in the panel",
-        "specStyleTestName": "admins can see accepted, skipped, and rejected rows in the panel",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the bulk invite rule and admin panel tests through their public flows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    },
-    {
-      "id": "T005",
-      "title": "Run mixed-surface checks and gather review evidence",
-      "type": "OTHER",
-      "phase": 3,
-      "parallel": false,
-      "dependsOn": [
-        "T004"
-      ],
-      "touches": [
-        "quality-gates"
-      ],
-      "files": [
-        "src/admin/BulkInvitePanel.tsx",
-        "src/invite/bulk-import.ts"
-      ],
-      "run": [
-        "npm test -- src/invite/bulk-import.test.ts",
-        "npm test -- src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "checks": [
-        "targeted tests pass",
-        "review evidence collected"
-      ],
-      "acceptance": [
-        "fresh verification evidence exists for cc-check"
-      ],
-      "verification": [
-        "npm test -- src/invite/bulk-import.test.ts",
-        "npm test -- src/admin/BulkInvitePanel.test.tsx"
-      ],
-      "evidence": [
-        "passing targeted test output",
-        "review notes"
-      ],
-      "context": {
-        "readFiles": [
-          "tasks.md",
-          "task-manifest.json"
-        ],
-        "commands": [
-          "npm test -- src/invite/bulk-import.test.ts",
-          "npm test -- src/admin/BulkInvitePanel.test.tsx"
-        ],
-        "notes": [
-          "fresh evidence can still block if the design contract is incomplete"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "evidence",
-      "verticalSlice": "Slice 3",
-      "testSeam": {
-        "entry": "bulk invite rules and admin upload UI behavior",
-        "behaviorAsserted": "fresh verification evidence exists for cc-check",
-        "specStyleTestName": "fresh verification evidence exists for cc-check",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the bulk invite rule and admin panel tests through their public flows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    }
-  ],
-  "metadata": {
-    "source": "tasks.md",
-    "generatedBy": "docs-example",
-    "planVersion": 1
-  }
-}

package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json

@@ -1,189 +0,0 @@
-{
-  "changeId": "REQ-002",
-  "verdict": "blocked",
-  "overall": "fail",
-  "summary": "verdict=blocked quick=2/2 strict=0/0 review=blocked",
-  "specAlignment": "blocked",
-  "specDeltaVerified": false,
-  "specSyncReady": false,
-  "runtime": {
-    "status": "blocked",
-    "failureOwnership": [
-      {
-        "failure": "requirement semantics cannot be proven from current design",
-        "classification": "ambiguous",
-        "touchedByDiff": true,
-        "evidence": "duplicate-email and seat-limit outcomes lack a frozen row matrix",
-        "action": "reroute-cc-plan",
-        "status": "open"
-      }
-    ]
-  },
-  "claimEvidence": [
-    {
-      "claim": "tests-pass",
-      "requiredProof": "fresh targeted test command with exit 0",
-      "commandOrArtifact": "npm test -- src/invite/bulk-import.test.ts",
-      "exitStatus": 0,
-      "keyObservation": "targeted bulk invite rule tests passed",
-      "status": "pass"
-    },
-    {
-      "claim": "requirements-met",
-      "requiredProof": "line-by-line planning/tasks.md and task-manifest.json checklist",
-      "commandOrArtifact": "planning/tasks.md#Contract Summary + planning/task-manifest.json",
-      "exitStatus": null,
-      "keyObservation": "duplicate-email and seat-limit semantics are still underspecified",
-      "status": "blocked"
-    }
-  ],
-  "qa": {
-    "status": "blocked",
-    "regressionProof": [],
-    "testQuality": [
-      {
-        "area": "bulk-invite-rules",
-        "checksRealBehavior": true,
-        "mockBoundary": "none",
-        "testOnlyProductionApi": false,
-        "status": "pass"
-      }
-    ],
-    "coverageAudit": {
-      "status": "blocked",
-      "coveragePct": null,
-      "pathMap": ["bulk invite parser", "admin panel happy path"],
-      "gaps": ["duplicate-email row semantics", "seat-limit partial-failure semantics"],
-      "testsAdded": ["src/invite/bulk-import.test.ts", "src/admin/BulkInvitePanel.test.tsx"],
-      "e2eRequired": true,
-      "evalRequired": false,
-      "qualityStars": "★"
-    },
-    "browserEvidence": {
-      "status": "skipped",
-      "mode": "not-applicable",
-      "affectedRoutes": [],
-      "screenshots": [],
-      "consoleErrors": [],
-      "healthScore": null,
-      "issues": [],
-      "skipReason": "design contract is blocked before browser QA can prove the intended behavior"
-    },
-    "tddException": "design contract is incomplete, so tests cannot prove final requirement semantics yet"
-  },
-  "quickGates": [
-    {
-      "name": "bulk-rule-tests",
-      "status": "pass",
-      "command": "npm test -- src/invite/bulk-import.test.ts",
-      "summary": "targeted bulk invite rule tests passed"
-    },
-    {
-      "name": "admin-panel-tests",
-      "status": "pass",
-      "command": "npm test -- src/admin/BulkInvitePanel.test.tsx",
-      "summary": "admin panel tests passed for the current diff"
-    }
-  ],
-  "strictGates": [],
-  "review": {
-    "status": "blocked",
-    "summary": "The implementation evidence is real, but the requirement-level design contract is still incomplete",
-    "details": "Diff review found that duplicate-email and seat-limit semantics are still not frozen tightly enough to trust the current implementation as the requirement truth.",
-    "freshness": {
-      "status": "fresh",
-      "reviewedCommit": "example-head",
-      "currentCommit": "example-head",
-      "commitsSinceReview": 0,
-      "staleReason": ""
-    },
-    "qualityScore": 6,
-    "specialistReviews": [
-      {
-        "name": "testing",
-        "status": "blocked",
-        "required": true,
-        "summary": "tests are real but cannot cover semantics that are not frozen in design",
-        "skipReason": "",
-        "findings": []
-      }
-    ],
-    "taskReviews": {
-      "status": "pass",
-      "required": true,
-      "summary": "All completed tasks carry spec/code proof",
-      "reviewPacket": {
-        "baseSha": "example-base",
-        "headSha": "example-head",
-        "requirements": "planning/tasks.md",
-        "implemented": "bulk invite import implementation",
-        "reviewerContext": "task manifest plus current implementation evidence"
-      },
-      "reviewers": [],
-      "findings": []
-    },
-    "diffReview": {
-      "status": "blocked",
-      "required": false,
-      "summary": "Requirement-level review says the row-outcome matrix must be reopened in planning",
-      "reviewPacket": {
-        "baseSha": "example-base",
-        "headSha": "example-head",
-        "requirements": "planning/tasks.md#Contract Summary",
-        "implemented": "bulk invite import implementation",
-        "reviewerContext": "requirement diff, plan completion, scope drift, docs staleness"
-      },
-      "reviewers": [],
-      "findings": [
-        {
-          "severity": "important",
-          "confidence": "high",
-          "source": "diff-review",
-          "summary": "duplicate-email behavior is still underspecified",
-          "evidence": "planning/tasks.md#Contract Summary does not freeze row-level duplicate semantics",
-          "action": "reroute-cc-plan",
-          "triageStatus": "clarification-needed",
-          "confidenceScore": 9,
-          "fingerprint": "diff-review:bulk-invite:duplicate-email-semantics",
-          "displayTier": "blocking",
-          "suppressionReason": null
-        },
-        {
-          "severity": "important",
-          "confidence": "high",
-          "source": "diff-review",
-          "summary": "seat-limit partial-failure semantics are not frozen in design.md",
-          "evidence": "planning/tasks.md#Contract Summary lacks accepted row-outcome matrix",
-          "action": "reroute-cc-plan",
-          "triageStatus": "clarification-needed",
-          "confidenceScore": 9,
-          "fingerprint": "diff-review:bulk-invite:seat-limit-partial-failure",
-          "displayTier": "blocking",
-          "suppressionReason": null
-        }
-      ]
-    },
-    "findings": [
-      {
-        "severity": "important",
-        "confidence": "medium",
-        "source": "diff-review",
-        "summary": "The current code may be locally green while still violating the intended admin trust model",
-        "evidence": "tests pass but requirement claim remains blocked by design ambiguity",
-        "action": "reroute-cc-plan",
-        "triageStatus": "clarification-needed",
-        "confidenceScore": 7,
-        "fingerprint": "diff-review:bulk-invite:trust-model-ambiguous",
-        "displayTier": "warning",
-        "suppressionReason": null
-      }
-    ]
-  },
-  "blockingFindings": [
-    "design: duplicate-email row handling is not frozen tightly enough",
-    "design: seat-limit partial-failure semantics must be reopened in cc-plan"
-  ],
-  "gaps": ["duplicate-email row handling", "seat-limit partial-failure semantics"],
-  "reroute": "cc-plan",
-  "timestamp": "2026-04-16T12:15:00.000Z"
-}