cc-devflow 4.5.11 → 4.5.12

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md

@@ -1,124 +0,0 @@
-# DESIGN
-
-## Document Meta
-
-- Requirement version: `REQ-001.v1`
-- Design version: `design.v1`
-- CC-Plan skill version: `3.9.2`
-- Work branch: `REQ/001-copy-invite-link`
-- Requirement ID: `REQ-001`
-- Design mode: `tiny-design`
-- Why this stays `tiny-design`: the patch is limited to an existing dialog and test file, with no API or data model changes
-- Approval status: `approved`
-- Source roadmap item: `RM-001`
-- Source roadmap version: `roadmap.v1`
-
-## Source Handoff
-
-- Why now: Stage 1 needs the smallest possible share-flow win
-- Inherited success signal: a user can copy the invite link with one click
-- Inherited kill signal: if the patch requires backend or permission changes, reopen planning
-- Inherited non-goals: no invite role controls, no analytics, no dialog redesign
-- Upstream evidence: repeated support notes and observed manual copying
-
-## Frozen Design Card
-
-- Change: add a `Copy invite link` button beside the existing read-only invite URL in the share dialog
-- Keep out: no new invite generation flow and no fallback redesign for unsupported browsers
-- Touched files:
-  - `src/features/share/ShareDialog.tsx`
-  - `src/features/share/ShareDialog.test.tsx`
-- Contract changes: none; reuse the existing invite link source and existing dialog props
-- Key decisions that `cc-do` must not re-decide:
-  - use `navigator.clipboard.writeText`
-  - keep the current invite URL source of truth
-  - show a lightweight copied-state confirmation inside the current dialog
-- Upgrade trigger to `full-design`: if clipboard support requires new platform fallbacks, or if the patch spills into shared share-service contracts
-
-## PRD-Grade Brief
-
-- Problem statement: users can see the invite URL, but copying it still requires manual selection and creates avoidable share-flow friction.
-- Solution summary: users get a one-click copy action in the existing share dialog and see lightweight confirmation after the link is copied.
-- Actors / personas:
-  - workspace member sharing an invite
-- User stories:
-  - US-001: As a workspace member, I want to copy the invite link with one click, so that I can share it without manually selecting text.
-- Implementation decisions:
-  - Reuse the existing invite URL source and dialog props.
-  - Keep clipboard behavior inside the current share dialog surface.
-- Testing decisions:
-  - Test through the dialog behavior, not an internal helper.
-  - Existing share-dialog tests are the prior art.
-- Out of scope: new invite generation, role controls, analytics, or clipboard fallback redesign.
-- Further notes: if confirmation remains unclear, open a separate UX requirement.
-
-## Validation
-
-- Primary check: targeted dialog test proves the button renders and copies the current invite URL
-- Secondary checks:
-  - existing share dialog tests remain green
-  - lint stays green for the touched files
-- Evidence to collect:
-  - failing test before implementation
-  - passing targeted test after implementation
-  - fresh gate output for `cc-check`
-
-## Main Risk
-
-- Risk: copied-state feedback may be too subtle for users
-- Mitigation: keep the first patch minimal and log a follow-up roadmap item if support friction remains
-
-## AI Leverage Decision Lens
-
-- Real user / operator: workspace member sharing an invite
-- Status quo workaround: manually select the visible invite URL
-- Human-team effort for full scope: about half a day for one engineer including test and review
-- CC / agent effort for full scope: about 20 minutes for a targeted UI patch plus test update
-- AI compression ratio: roughly 10x for this bounded UI slice
-- Complete-lake boundary: copy action, current invite URL source, copied-state feedback, and dialog behavior test
-- Ocean boundary: invite generation, permissions, analytics, and clipboard fallback redesign
-- Scope recommendation: `boil-lake`
-- Cost model: low agent time, low human review time, targeted dialog test, no backend maintenance cost, reversible UI patch
-- 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: existing share-dialog behavior and repo tests are sufficient for the tiny design
-
-## Review Gate
-
-- Placeholder scan: pass
-- Consistency scan: pass; scope, files, and validation all point to the same tiny patch
-- Scope scan: pass; no backend, no permission work
-- Ambiguity scan: pass; execution does not need to re-decide button placement or clipboard source
-- Feasibility scan: pass; existing dialog and tests already cover the target surface
-- PRD brief scan: pass; problem, story, implementation decision, testing decision, and out-of-scope are durable
-- AI Leverage Decision Lens scan: pass; bounded same-dialog lake is cheap enough to complete, not just render a happy-path button
-- External best-practice scan: pass; not needed for a repo-local tiny design
-- Decision question scan: pass; `D1` approved the tiny-design copy-action 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 dialog already renders the invite URL and the change stays inside one UI/test surface | Approve the tiny-design copy action | Tiny design copy action | Keep implementation inside the share dialog; do not add backend or permission work | answered |
-
-## Approval
-
-- User approval status: approved
-- Deferred questions:
-  - if copied-state feedback still feels weak, open a separate requirement for richer UX
-
-## First-Read Test
-
-- This is clearly small because it stays inside one UI surface and one test surface
-- The upgrade path is explicit: any contract or fallback work forces `full-design`
-- `cc-do` should not need to ask where the URL comes from or how the copy action is triggered

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json

@@ -1,292 +0,0 @@
-{
-  "changeId": "REQ-001",
-  "goal": "Add a one-click copy action to the existing share dialog without changing backend contracts.",
-  "createdAt": "2026-04-15T10:00:00.000Z",
-  "updatedAt": "2026-04-15T11:10:00.000Z",
-  "requirementId": "REQ-001",
-  "requirementVersion": "REQ-001.v1",
-  "planningMeta": {
-    "reqPlanSkillVersion": "3.9.2",
-    "designVersion": "design.v1",
-    "workBranch": "REQ/001-copy-invite-link",
-    "approvedAt": "2026-04-15T10:05:00.000Z",
-    "basedOnOption": "Tiny design card",
-    "aiLeverageDecisionLens": {
-      "realUserOrOperator": "workspace member sharing an invite",
-      "statusQuoWorkaround": "manual selection and copy of the visible invite URL",
-      "humanTeamEffortForFullScope": "about half a day for one engineer including test and review",
-      "ccAgentEffortForFullScope": "about 20 minutes for a targeted UI patch plus test update",
-      "aiCompressionRatio": "roughly 10x for this bounded UI slice",
-      "completeLakeBoundary": "copy action, current invite URL source, copied-state feedback, and dialog behavior test",
-      "oceanBoundary": "invite generation, permissions, analytics, or clipboard fallback redesign",
-      "scopeRecommendation": "boil-lake",
-      "costModel": {
-        "agentTime": "low",
-        "humanReviewTime": "low",
-        "verificationCost": "targeted dialog test",
-        "maintenanceCost": "low while scoped to the dialog",
-        "failureCost": "sharing friction remains",
-        "reversibility": "reversible UI patch"
-      },
-      "verdict": "boil-lake",
-      "missingEvidenceOrPivotReason": "",
-      "impactOnApprovedDirection": "cover the full same-dialog copy lake instead of only a happy-path button render"
-    },
-    "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": "existing share-dialog behavior and repo tests are sufficient for the tiny design"
-    },
-    "decisionQuestions": [
-      {
-        "questionId": "D1",
-        "gate": "approach-approval",
-        "knownEvidence": [
-          "Existing dialog already renders the invite URL",
-          "The patch stays inside one UI/test surface"
-        ],
-        "recommendation": "Approve the tiny-design copy action",
-        "options": [
-          {
-            "id": "A",
-            "label": "Tiny design copy action",
-            "recommended": true,
-            "completeness": "8/10",
-            "good": "Ships the visible user win with one dialog and one behavior test",
-            "costRisk": "Leaves richer feedback and clipboard fallback work for later"
-          },
-          {
-            "id": "B",
-            "label": "Full share-flow redesign",
-            "recommended": false,
-            "completeness": "10/10",
-            "good": "Could solve broader invite UX issues in one larger pass",
-            "costRisk": "Expands beyond the roadmap wedge and touches unrelated share contracts"
-          }
-        ],
-        "userChoice": "A",
-        "impact": "cc-do keeps implementation inside the share dialog and avoids backend or permission work",
-        "status": "answered"
-      }
-    ]
-  },
-  "currentTaskId": null,
-  "tasks": [
-    {
-      "id": "T001",
-      "title": "[TEST] Add a failing dialog test for the missing copy action",
-      "type": "TEST",
-      "phase": 1,
-      "parallel": false,
-      "dependsOn": [],
-      "touches": [
-        "share-dialog",
-        "tests"
-      ],
-      "files": [
-        "src/features/share/ShareDialog.test.tsx"
-      ],
-      "run": [
-        "npm test -- src/features/share/ShareDialog.test.tsx"
-      ],
-      "checks": [
-        "test fails before implementation"
-      ],
-      "acceptance": [
-        "The missing copy action is reproduced as a failing test"
-      ],
-      "verification": [
-        "npm test -- src/features/share/ShareDialog.test.tsx"
-      ],
-      "evidence": [
-        "Failing test output"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/features/share/ShareDialog.tsx"
-        ],
-        "commands": [
-          "npm test -- src/features/share/ShareDialog.test.tsx"
-        ],
-        "notes": [
-          "Do not change share-service contracts in this task"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "red",
-      "verticalSlice": "Slice 1",
-      "testSeam": {
-        "entry": "share dialog UI behavior",
-        "behaviorAsserted": "The missing copy action is reproduced as a failing test",
-        "specStyleTestName": "The missing copy action is reproduced as a failing test",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the share dialog test and observe the copy action through the rendered dialog",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": "Fails before the behavior exists"
-      }
-    },
-    {
-      "id": "T002",
-      "title": "[IMPL] Add the copy button and copied-state confirmation",
-      "type": "IMPL",
-      "phase": 1,
-      "parallel": false,
-      "dependsOn": [
-        "T001"
-      ],
-      "touches": [
-        "share-dialog"
-      ],
-      "files": [
-        "src/features/share/ShareDialog.tsx"
-      ],
-      "run": [
-        "npm test -- src/features/share/ShareDialog.test.tsx"
-      ],
-      "checks": [
-        "dialog test passes after implementation"
-      ],
-      "acceptance": [
-        "The dialog exposes a copy button and confirms the copied state"
-      ],
-      "verification": [
-        "npm test -- src/features/share/ShareDialog.test.tsx"
-      ],
-      "evidence": [
-        "Passing targeted test output",
-        "Checkpoint summary"
-      ],
-      "context": {
-        "readFiles": [
-          "design.md",
-          "tasks.md",
-          "src/features/share/ShareDialog.test.tsx"
-        ],
-        "commands": [
-          "npm test -- src/features/share/ShareDialog.test.tsx"
-        ],
-        "notes": [
-          "Keep the patch inside the existing dialog"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "green",
-      "verticalSlice": "Slice 2",
-      "testSeam": {
-        "entry": "share dialog UI behavior",
-        "behaviorAsserted": "The dialog exposes a copy button and confirms the copied state",
-        "specStyleTestName": "The dialog exposes a copy button and confirms the copied state",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the share dialog test and observe the copy action through the rendered dialog",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    },
-    {
-      "id": "T003",
-      "title": "Run targeted checks and collect fresh evidence",
-      "type": "OTHER",
-      "phase": 2,
-      "parallel": false,
-      "dependsOn": [
-        "T002"
-      ],
-      "touches": [
-        "quality-gates"
-      ],
-      "files": [
-        "src/features/share/ShareDialog.tsx",
-        "src/features/share/ShareDialog.test.tsx"
-      ],
-      "run": [
-        "npm test -- src/features/share/ShareDialog.test.tsx",
-        "npm run lint -- src/features/share/ShareDialog.tsx"
-      ],
-      "checks": [
-        "targeted test passes",
-        "lint passes"
-      ],
-      "acceptance": [
-        "Fresh verification evidence is ready for cc-check"
-      ],
-      "verification": [
-        "npm test -- src/features/share/ShareDialog.test.tsx",
-        "npm run lint -- src/features/share/ShareDialog.tsx"
-      ],
-      "evidence": [
-        "Passing targeted test output",
-        "Clean lint output"
-      ],
-      "context": {
-        "readFiles": [
-          "tasks.md",
-          "task-manifest.json"
-        ],
-        "commands": [
-          "npm test -- src/features/share/ShareDialog.test.tsx",
-          "npm run lint -- src/features/share/ShareDialog.tsx"
-        ],
-        "notes": [
-          "Collect only fresh evidence from this run"
-        ]
-      },
-      "reviews": {
-        "spec": "pass",
-        "code": "pass"
-      },
-      "status": "passed",
-      "attempts": 1,
-      "maxRetries": 1,
-      "tddPhase": "evidence",
-      "verticalSlice": "Slice 3",
-      "testSeam": {
-        "entry": "share dialog UI behavior",
-        "behaviorAsserted": "Fresh verification evidence is ready for cc-check",
-        "specStyleTestName": "Fresh verification evidence is ready for cc-check",
-        "oneLogicalBehavior": true,
-        "publicVerificationPath": "Run the share dialog test and observe the copy action through the rendered dialog",
-        "implementationDetailRisk": "low"
-      },
-      "feedbackLoop": {
-        "type": "automated-test",
-        "determinism": "deterministic",
-        "expectedFailure": ""
-      }
-    }
-  ],
-  "metadata": {
-    "source": "tasks.md",
-    "generatedBy": "docs-example",
-    "planVersion": 1
-  }
-}

package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json

@@ -1,136 +0,0 @@
-{
-  "changeId": "REQ-001",
-  "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/features/share/ShareDialog.test.tsx",
-      "exitStatus": 0,
-      "keyObservation": "share dialog 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": "T001-T003 complete with spec/code review proof",
-      "status": "pass"
-    }
-  ],
-  "qa": {
-    "status": "pass",
-    "regressionProof": [],
-    "testQuality": [
-      {
-        "area": "share-dialog",
-        "checksRealBehavior": true,
-        "mockBoundary": "none",
-        "testOnlyProductionApi": false,
-        "status": "pass"
-      }
-    ],
-    "coverageAudit": {
-      "status": "pass",
-      "coveragePct": 80,
-      "pathMap": ["copy invite link success path", "clipboard fallback error path"],
-      "gaps": [],
-      "testsAdded": ["src/features/share/ShareDialog.test.tsx"],
-      "e2eRequired": false,
-      "evalRequired": false,
-      "qualityStars": "★★"
-    },
-    "browserEvidence": {
-      "status": "skipped",
-      "mode": "not-applicable",
-      "affectedRoutes": [],
-      "screenshots": [],
-      "consoleErrors": [],
-      "healthScore": null,
-      "issues": [],
-      "skipReason": "example fixture uses targeted component evidence instead of a live browser"
-    },
-    "tddException": null
-  },
-  "quickGates": [
-    {
-      "name": "targeted-tests",
-      "status": "pass",
-      "command": "npm test -- src/features/share/ShareDialog.test.tsx",
-      "summary": "share dialog targeted tests passed"
-    },
-    {
-      "name": "lint",
-      "status": "pass",
-      "command": "npm run lint -- src/features/share/ShareDialog.tsx",
-      "summary": "lint passed for the touched dialog file"
-    }
-  ],
-  "strictGates": [],
-  "review": {
-    "status": "pass",
-    "summary": "Task review proof and requirement-level diff review both passed",
-    "details": "T001-T003 have matching spec/code review proof and the diff stays inside the approved tiny-design boundary.",
-    "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 share dialog 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#T001-T003",
-        "implemented": "copy invite link workflow",
-        "reviewerContext": "task manifest plus changed share dialog 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": "copy invite link workflow",
-        "reviewerContext": "requirement diff, plan completion, scope drift, docs staleness"
-      },
-      "reviewers": [],
-      "findings": []
-    },
-    "findings": []
-  },
-  "blockingFindings": [],
-  "gaps": [],
-  "reroute": "none",
-  "timestamp": "2026-04-15T11:20:00.000Z"
-}