cc-devflow 4.5.11 → 4.5.12

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md

@@ -1,39 +0,0 @@
-# Resume Index
-
-## Current Reality
-
-- Requirement: `REQ-003`
-- Roadmap item: `RM-020`
-- Verification state: `pass`
-- Ship mode: `local-handoff`
-- Current branch: `feature/audit-summary-export`
-- Blocking environment fact: remote push / PR creation is unavailable right now
-
-## What Is Already Done
-
-- design approved as `tiny-design`
-- implementation tasks `T001-T003` completed
-- targeted test and lint evidence collected
-- `report-card.json` confirms `pass`
-
-## Next Entry
-
-- when remote access is restored, rerun `detect-ship-target`
-- if the branch still has no PR, switch from `local-handoff` to `create-pr`
-- use `resume-index.md` and `report-card.json` as the truth sources for the next ship step
-
-## Read First
-
-- `design.md`
-- `tasks.md`
-- `task-manifest.json`
-- `report-card.json`
-
-## How To Re-Verify
-
-- `npm test -- src/admin/AuditSummaryPanel.test.tsx`
-- `npm run lint -- src/admin/AuditSummaryPanel.tsx`
-
-## Open Follow-Up
-
-- if operators ask for JSON or scheduled exports, lift that into a new roadmap item instead of reopening `REQ-003`

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md

@@ -1,29 +0,0 @@
-# Status Report
-
-## Requirement
-
-- Change ID: `REQ-003`
-- Roadmap item: `RM-020`
-- Current state: verified and ready for `local-handoff`
-
-## What Is True Now
-
-- The admin audit summary panel can export the currently visible summary rows as CSV
-- The patch stayed inside the approved `tiny-design` boundary
-- Fresh targeted test and lint evidence both passed
-- `cc-check` returned `pass`
-
-## Ship Decision
-
-- Recommended mode: `local-handoff`
-- Why now: the work is verified, but remote push / PR creation is intentionally unavailable in this environment
-- Why not others:
-  - not `create-pr`: remote access is unavailable
-  - not `update-pr`: there is no existing PR to refresh
-  - not `post-merge-closeout`: the change is not merged yet
-
-## Docs And Follow-Up
-
-- README / release docs: unchanged; this is not a public release step
-- Backlog writeback: if admins request additional export formats, open a new roadmap item
-- Next entry point: use `resume-index.md` to pick up the branch when remote access becomes available

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md

@@ -1,123 +0,0 @@
-# DESIGN
-
-## Document Meta
-
-- Requirement version: `REQ-003.v1`
-- Design version: `design.v1`
-- CC-Plan skill version: `3.9.2`
-- Work branch: `REQ/003-audit-log-export`
-- Requirement ID: `REQ-003`
-- Design mode: `tiny-design`
-- Why this stays `tiny-design`: the patch adds one export action inside the existing admin audit UI without changing data contracts
-- Approval status: `approved`
-- Source roadmap item: `RM-020`
-- Source roadmap version: `roadmap.v3`
-
-## Source Handoff
-
-- Why now: admins need a lightweight way to take weekly activity summaries out of the UI
-- Inherited success signal: admins can download the summary without manual row copying
-- Inherited kill signal: if export requires a shared reporting pipeline, reopen planning
-- Inherited non-goals: no JSON export mode, no scheduled reporting
-- Upstream evidence: repeated internal admin requests during weekly reviews
-
-## Frozen Design Card
-
-- Change: add a `Download summary` action that exports the visible audit summary rows as CSV
-- Keep out: no multi-format export and no shared reporting backend
-- Touched files:
-  - `src/admin/AuditSummaryPanel.tsx`
-  - `src/admin/AuditSummaryPanel.test.tsx`
-- Contract changes: none; reuse the existing summary rows already shown in the panel
-- Key decisions that `cc-do` must not re-decide:
-  - export only what is already visible in the panel
-  - use CSV as the single output format
-  - keep the action inside the current admin panel
-- Upgrade trigger to `full-design`: if export needs background generation or new reporting contracts
-
-## PRD-Grade Brief
-
-- Problem statement: admins can review audit summary rows in the UI, but taking them into weekly reports requires manual copying.
-- Solution summary: admins can download the currently visible audit summary rows as a CSV from the existing admin panel.
-- Actors / personas:
-  - workspace admin reviewing weekly activity
-- User stories:
-  - US-001: As a workspace admin, I want to download visible audit summary rows as CSV, so that I can include them in weekly reporting without manual copying.
-- Implementation decisions:
-  - Export only the rows already visible in the panel.
-  - Keep CSV as the only output format.
-- Testing decisions:
-  - Test through the admin panel action and visible row data.
-  - Existing audit summary panel tests are the prior art.
-- Out of scope: JSON export, scheduled reporting, and shared reporting backend work.
-- Further notes: richer machine-readable exports should become a separate requirement.
-
-## Validation
-
-- Primary check: targeted panel test proves the export action is available and uses current summary rows
-- Secondary checks:
-  - existing audit summary rendering stays green
-  - lint passes for the touched panel
-- Evidence to collect:
-  - failing test before implementation
-  - passing test and lint after implementation
-
-## Main Risk
-
-- Risk: admins may soon ask for more export formats
-- Mitigation: treat JSON or scheduled exports as later roadmap items
-
-## AI Leverage Decision Lens
-
-- Real user / operator: workspace admin preparing weekly review notes
-- Status quo workaround: manually copy visible audit rows
-- Human-team effort for full scope: about one day for an engineer to implement, test, and document the local export
-- CC / agent effort for full scope: about 30 minutes for visible-row CSV export plus targeted test and lint
-- AI compression ratio: roughly 10x for the bounded local export path
-- Complete-lake boundary: visible-row CSV export, panel action, current data source, targeted panel test, and lint
-- Ocean boundary: JSON export, scheduled reporting, shared reporting backend, and cross-panel reporting platform
-- Scope recommendation: `boil-lake`
-- Cost model: low agent time, low human review time, targeted panel test plus lint, low maintenance cost while scoped to visible rows, reversible UI action
-- Verdict: `boil-lake`
-- Missing evidence or pivot reason: none
-
-## External Best-Practice Validation
-
-- Needed: No
-- Decision status: not-needed
-- Generalized search terms:
-- Sources checked:
-- Repo-fit verdict: skipped
-- Changes to frozen design:
-- Skipped reason: the local handoff exports existing visible rows and does not introduce a new reporting standard
-
-## Review Gate
-
-- Placeholder scan: pass
-- Consistency scan: pass
-- Scope scan: pass
-- Ambiguity scan: pass
-- Feasibility scan: pass
-- PRD brief scan: pass; the export story and scope boundaries are explicit
-- AI Leverage Decision Lens scan: pass; visible-row export lake is bounded enough to complete while reporting platform work stays out
-- External best-practice scan: pass; not needed for a repo-local visible-row export
-- Decision question scan: pass; `D1` approved the tiny-design CSV-export boundary
-- Final recommendation: approved as `tiny-design`
-
-## Decision Questions
-
-| ID | Gate | Known evidence | Recommendation | User choice | Impact on `cc-do` | Status |
-|----|------|----------------|----------------|-------------|-------------------|--------|
-| D1 | approach-approval | Existing admin panel already owns visible summary rows and the change does not need a reporting backend | Approve the tiny-design CSV export | Tiny design CSV export | Export only visible rows from the current panel; do not create reporting contracts | answered |
-
-## Approval
-
-- User approval status: approved
-- Deferred questions:
-  - if admins ask for machine-readable export next, open a separate requirement
-
-## First-Read Test
-
-- 一眼能看出这次为什么够小
-- 一眼能看出什么情况会逼它升级成 `full-design`
-- `cc-do` 看完不会继续追问“导出的字段从哪里来”

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json

@@ -1,292 +0,0 @@
-{
-  "changeId": "REQ-003",
-  "goal": "Add a local CSV export for the existing audit summary panel without introducing new reporting contracts.",
-  "createdAt": "2026-04-16T13:00:00.000Z",
-  "updatedAt": "2026-04-16T14:20:00.000Z",
-  "requirementId": "REQ-003",
-  "requirementVersion": "REQ-003.v1",
-  "planningMeta": {
-    "reqPlanSkillVersion": "3.9.2",
-    "designVersion": "design.v1",
-    "workBranch": "REQ/003-audit-log-export",
-    "approvedAt": "2026-04-16T13:10:00.000Z",
-    "basedOnOption": "Tiny design card",
-    "aiLeverageDecisionLens": {
-      "realUserOrOperator": "workspace admin preparing weekly review notes",
-      "statusQuoWorkaround": "manual copy of visible audit rows",
-      "humanTeamEffortForFullScope": "about one day for an engineer to implement, test, and document the local export",
-      "ccAgentEffortForFullScope": "about 30 minutes for visible-row CSV export plus targeted test and lint",
-      "aiCompressionRatio": "roughly 10x for the bounded local export path",
-      "completeLakeBoundary": "visible-row CSV export, panel action, current data source, targeted panel test, and lint",
-      "oceanBoundary": "JSON export, scheduled reporting, shared reporting backend, and cross-panel reporting platform",
-      "scopeRecommendation": "boil-lake",
-      "costModel": {
-        "agentTime": "low",
-        "humanReviewTime": "low",
-        "verificationCost": "targeted panel test plus lint",
-        "maintenanceCost": "low while scoped to visible rows",
-        "failureCost": "admins keep copying rows manually",
-        "reversibility": "reversible UI action"
-      },
-      "verdict": "boil-lake",
-      "missingEvidenceOrPivotReason": "",
-      "impactOnApprovedDirection": "complete the local visible-row export lake while deferring reporting platform work"
-    },
-    "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": "the local handoff exports existing visible rows and does not introduce a new reporting standard"
-    },
-    "decisionQuestions": [
-      {
-        "questionId": "D1",
-        "gate": "approach-approval",
-        "knownEvidence": [
-          "Existing admin panel already owns the visible summary rows",
-          "No reporting backend is needed for the first useful export"
-        ],
-        "recommendation": "Approve the tiny-design CSV export",
-        "options": [
-          {
-            "id": "A",
-            "label": "Tiny design CSV export",
-            "recommended": true,
-            "completeness": "8/10",
-            "good": "Solves weekly reporting friction with the current panel data",
-            "costRisk": "Does not handle JSON, scheduling, or shared reporting contracts"
-          },
-          {
-            "id": "B",
-            "label": "Shared reporting pipeline",
-            "recommended": false,
-            "completeness": "10/10",
-            "good": "Could support more formats and future scheduled reports",
-            "costRisk": "Creates a larger platform surface before the local export is proven"
-          }
-        ],
-        "userChoice": "A",
-        "impact": "cc-do exports only visible rows from the current panel and avoids new reporting contracts",
-        "status": "answered"
-      }
-    ]
-  },
-  "currentTaskId": null,
-  "tasks": [
-    {
-      "id": "T001",
-      "title": "[TEST] Add a failing test for the missing download action",
-      "type": "TEST",
-      "phase": 1,
-      "parallel": false,
-      "dependsOn": [],
-      "touches": [
-        "audit-summary",
-        "tests"
-      ],
-      "files": [
-        "src/admin/AuditSummaryPanel.test.tsx"
-      ],
-      "run": [
-        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
-      ],
-      "checks": [
-        "test fails before implementation"
-      ],
-      "acceptance": [
-        "the missing download action is reproduced as a failing test"
-      ],
-      "verification": [
-        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
-      ],
-      "evidence": [
-        "failing test output"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/admin/AuditSummaryPanel.tsx"
-        ],
-        "commands": [
-          "npm test -- src/admin/AuditSummaryPanel.test.tsx"
-        ],
-        "notes": [
-          "stay inside the current audit summary panel"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "red",
-      "verticalSlice": "Slice 1",
-      "testSeam": {
-        "entry": "admin audit panel UI behavior",
-        "behaviorAsserted": "the missing download action is reproduced as a failing test",
-        "specStyleTestName": "the missing download action is reproduced as a failing test",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the audit summary panel test and observe CSV export through visible rows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": "Fails before the behavior exists"
-      }
-    },
-    {
-      "id": "T002",
-      "title": "[IMPL] Add the download summary action",
-      "type": "IMPL",
-      "phase": 1,
-      "parallel": false,
-      "dependsOn": [
-        "T001"
-      ],
-      "touches": [
-        "audit-summary"
-      ],
-      "files": [
-        "src/admin/AuditSummaryPanel.tsx"
-      ],
-      "run": [
-        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
-      ],
-      "checks": [
-        "panel test passes"
-      ],
-      "acceptance": [
-        "admins can trigger a CSV download from the existing summary panel"
-      ],
-      "verification": [
-        "npm test -- src/admin/AuditSummaryPanel.test.tsx"
-      ],
-      "evidence": [
-        "passing test output",
-        "CLI log summary"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/admin/AuditSummaryPanel.test.tsx"
-        ],
-        "commands": [
-          "npm test -- src/admin/AuditSummaryPanel.test.tsx"
-        ],
-        "notes": [
-          "reuse visible summary rows as the export source"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "green",
-      "verticalSlice": "Slice 2",
-      "testSeam": {
-        "entry": "admin audit panel UI behavior",
-        "behaviorAsserted": "admins can trigger a CSV download from the existing summary panel",
-        "specStyleTestName": "admins can trigger a CSV download from the existing summary panel",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the audit summary panel test and observe CSV export through visible rows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    },
-    {
-      "id": "T003",
-      "title": "Run targeted checks and collect handoff evidence",
-      "type": "OTHER",
-      "phase": 2,
-      "parallel": false,
-      "dependsOn": [
-        "T002"
-      ],
-      "touches": [
-        "quality-gates"
-      ],
-      "files": [
-        "src/admin/AuditSummaryPanel.tsx",
-        "src/admin/AuditSummaryPanel.test.tsx"
-      ],
-      "run": [
-        "npm test -- src/admin/AuditSummaryPanel.test.tsx",
-        "npm run lint -- src/admin/AuditSummaryPanel.tsx"
-      ],
-      "checks": [
-        "targeted tests pass",
-        "lint passes"
-      ],
-      "acceptance": [
-        "fresh verification evidence exists for local handoff"
-      ],
-      "verification": [
-        "npm test -- src/admin/AuditSummaryPanel.test.tsx",
-        "npm run lint -- src/admin/AuditSummaryPanel.tsx"
-      ],
-      "evidence": [
-        "passing test output",
-        "clean lint output"
-      ],
-      "context": {
-        "readFiles": [
-          "tasks.md",
-          "task-manifest.json"
-        ],
-        "commands": [
-          "npm test -- src/admin/AuditSummaryPanel.test.tsx",
-          "npm run lint -- src/admin/AuditSummaryPanel.tsx"
-        ],
-        "notes": [
-          "remote push is intentionally out of scope for this example"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "evidence",
-      "verticalSlice": "Slice 3",
-      "testSeam": {
-        "entry": "admin audit panel UI behavior",
-        "behaviorAsserted": "fresh verification evidence exists for local handoff",
-        "specStyleTestName": "fresh verification evidence exists for local handoff",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the audit summary panel test and observe CSV export through visible rows",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    }
-  ],
-  "metadata": {
-    "source": "tasks.md",
-    "generatedBy": "docs-example",
-    "planVersion": 1
-  }
-}

package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json

@@ -1,136 +0,0 @@
-{
-  "changeId": "REQ-003",
-  "verdict": "pass",
-  "overall": "pass",
-  "summary": "verdict=pass quick=2/2 strict=0/0 review=pass",
-  "specAlignment": "pass",
-  "specDeltaVerified": true,
-  "specSyncReady": true,
-  "runtime": {
-    "status": "pass",
-    "failureOwnership": []
-  },
-  "claimEvidence": [
-    {
-      "claim": "tests-pass",
-      "requiredProof": "fresh targeted test command with exit 0",
-      "commandOrArtifact": "npm test -- src/admin/AuditSummaryPanel.test.tsx",
-      "exitStatus": 0,
-      "keyObservation": "audit summary panel targeted tests passed",
-      "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": "approved tiny-design scope completed",
-      "status": "pass"
-    }
-  ],
-  "qa": {
-    "status": "pass",
-    "regressionProof": [],
-    "testQuality": [
-      {
-        "area": "audit-summary-panel",
-        "checksRealBehavior": true,
-        "mockBoundary": "none",
-        "testOnlyProductionApi": false,
-        "status": "pass"
-      }
-    ],
-    "coverageAudit": {
-      "status": "pass",
-      "coveragePct": 80,
-      "pathMap": ["audit summary render path", "empty audit state"],
-      "gaps": [],
-      "testsAdded": ["src/admin/AuditSummaryPanel.test.tsx"],
-      "e2eRequired": false,
-      "evalRequired": false,
-      "qualityStars": "★★"
-    },
-    "browserEvidence": {
-      "status": "skipped",
-      "mode": "not-applicable",
-      "affectedRoutes": [],
-      "screenshots": [],
-      "consoleErrors": [],
-      "healthScore": null,
-      "issues": [],
-      "skipReason": "local handoff example records component evidence without a live browser fixture"
-    },
-    "tddException": null
-  },
-  "quickGates": [
-    {
-      "name": "targeted-tests",
-      "status": "pass",
-      "command": "npm test -- src/admin/AuditSummaryPanel.test.tsx",
-      "summary": "audit summary panel targeted tests passed"
-    },
-    {
-      "name": "lint",
-      "status": "pass",
-      "command": "npm run lint -- src/admin/AuditSummaryPanel.tsx",
-      "summary": "lint passed for the touched panel file"
-    }
-  ],
-  "strictGates": [],
-  "review": {
-    "status": "pass",
-    "summary": "Task review proof and requirement-level diff review both passed",
-    "details": "The diff stayed inside the approved tiny-design scope and verification evidence is fresh.",
-    "freshness": {
-      "status": "fresh",
-      "reviewedCommit": "example-head",
-      "currentCommit": "example-head",
-      "commitsSinceReview": 0,
-      "staleReason": ""
-    },
-    "qualityScore": 9,
-    "specialistReviews": [
-      {
-        "name": "testing",
-        "status": "pass",
-        "required": true,
-        "summary": "targeted tests cover the audit summary behavior for this example",
-        "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": "audit log export summary view",
-        "reviewerContext": "task manifest plus changed audit panel files"
-      },
-      "reviewers": [],
-      "findings": []
-    },
-    "diffReview": {
-      "status": "pass",
-      "required": false,
-      "summary": "No blocking requirement-level findings",
-      "reviewPacket": {
-        "baseSha": "example-base",
-        "headSha": "example-head",
-        "requirements": "planning/tasks.md#Contract Summary",
-        "implemented": "audit log export summary view",
-        "reviewerContext": "requirement diff, plan completion, scope drift, docs staleness"
-      },
-      "reviewers": [],
-      "findings": []
-    },
-    "findings": []
-  },
-  "blockingFindings": [],
-  "gaps": [],
-  "reroute": "none",
-  "timestamp": "2026-04-16T14:30:00.000Z"
-}

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md

@@ -1,29 +0,0 @@
-# Status Report
-
-## Requirement
-
-- Change ID: `REQ-001`
-- Roadmap item: `RM-001`
-- Current state: verified and ready to ship as `create-pr`
-
-## What Is True Now
-
-- The share dialog exposes a one-click copy action for the existing invite URL
-- The patch stayed inside the approved `tiny-design` boundary
-- Fresh targeted test and lint evidence both passed
-- Review proof is present, so `cc-check` returned `pass`
-
-## Ship Decision
-
-- Recommended mode: `create-pr`
-- Why now: the work is verified, the branch is assumed to be a feature branch, and no open PR exists yet
-- Why not others:
-  - not `update-pr`: there is no existing PR to refresh
-  - not `local-handoff`: the work is ready to move forward
-  - not `post-merge-closeout`: the change is not merged yet
-
-## Docs And Follow-Up
-
-- README / release docs: no public user-facing release note yet
-- Backlog writeback: keep `RM-002` parked as the next UX refinement if support friction remains
-- Next entry point: create the PR using `pr-brief.md` as the truth source