feat(usage): issue-scope in schema en scope-helper (IDEA-249 §5.1, §5.2) #84

Merged
janpeter merged 1 commit from feat/idea-249-issue-scope into main 2026-10-13 21:37:21 +02:00
Owner

IDEA-249 Taak 1 (T-31, sprint S-2026-10-13-1). Spec: my-mods docs/superpowers/specs/2026-10-12-usage-ledger-issue-scope-design.md rev 6 §5.1–5.2; plan rev 4 Taak 1 (branch claude/idea-249-review-loop, my-mods#28).

  • enum UsageIssuePhase { RESEARCH PLAN }; UsageSegment.issue_id String?, issue_phase UsageIssuePhase?, relatie issue Issue? (onDelete: Cascade), Issue.usage_segments, @@index([issue_id, started_at]).
  • // SQL:-CHECK uitgebreid met ((issue_id IS NULL) = (issue_phase IS NULL)) AND (issue_id IS NULL OR sprint_id IS NULL) AND (issue_id IS NULL OR idea_id IS NULL).
  • usageScopeSqlText: WHEN issue_id IS NOT NULL THEN 'issue' vóór ELSE 'product'.
  • PGlite-tests: vijfde scope-rij; CHECK accepteert issue+fase zonder sprint en weigert issue+sprint/anker, issue zonder fase, fase zonder issue, issue+idee (elke rij geldig op de geteste clausule na).

Inventarisatie spec §5.2 (2026-10-13): git grep -nE "sprint_id IS NULL|anchor_task_id IS NULL|sprint_id: null|anchor_task_id: null" in scrum4me-shared, Scrum4Me en scrum4me-workers (origin/main): geen code die de usage-scope met de hand afleidt. Enige codetreffer: scrum4me-workers lib/usage/jobs.ts:96,103 (st.sprint_id IS NULL, storyrelatie van claude_jobs, niet usage_segments). Rest is documentatie.

Afwijking van de plantekst: het plan noemt de CHECK met gequote identifiers; het // SQL:-commentaar en de test-DDL in deze repo gebruiken ongequote namen, en die conventie is aangehouden (semantisch gelijk). De Scrum4Me-migratie (Taak 2) gebruikt de gequote vorm.

Verificatie: npm run verify groen (799 tests); prisma@7.8.0 validate met postgres-datasource-kop: valid.

Volgt: Taak 2 (Scrum4Me-migratie) en Taak 3 (mcp) bumpen de submodule naar de gemergde commit van deze PR. Niet zelf gemergd.

🤖 Generated with Claude Code

IDEA-249 Taak 1 (T-31, sprint S-2026-10-13-1). Spec: my-mods `docs/superpowers/specs/2026-10-12-usage-ledger-issue-scope-design.md` rev 6 §5.1–5.2; plan rev 4 Taak 1 (branch `claude/idea-249-review-loop`, my-mods#28). - `enum UsageIssuePhase { RESEARCH PLAN }`; `UsageSegment.issue_id String?`, `issue_phase UsageIssuePhase?`, relatie `issue Issue?` (onDelete: Cascade), `Issue.usage_segments`, `@@index([issue_id, started_at])`. - `// SQL:`-CHECK uitgebreid met `((issue_id IS NULL) = (issue_phase IS NULL)) AND (issue_id IS NULL OR sprint_id IS NULL) AND (issue_id IS NULL OR idea_id IS NULL)`. - `usageScopeSqlText`: `WHEN issue_id IS NOT NULL THEN 'issue'` vóór `ELSE 'product'`. - PGlite-tests: vijfde scope-rij; CHECK accepteert issue+fase zonder sprint en weigert issue+sprint/anker, issue zonder fase, fase zonder issue, issue+idee (elke rij geldig op de geteste clausule na). **Inventarisatie spec §5.2 (2026-10-13):** `git grep -nE "sprint_id IS NULL|anchor_task_id IS NULL|sprint_id: null|anchor_task_id: null"` in scrum4me-shared, Scrum4Me en scrum4me-workers (origin/main): geen code die de usage-scope met de hand afleidt. Enige codetreffer: scrum4me-workers `lib/usage/jobs.ts:96,103` (`st.sprint_id IS NULL`, storyrelatie van claude_jobs, niet usage_segments). Rest is documentatie. **Afwijking van de plantekst:** het plan noemt de CHECK met gequote identifiers; het `// SQL:`-commentaar en de test-DDL in deze repo gebruiken ongequote namen, en die conventie is aangehouden (semantisch gelijk). De Scrum4Me-migratie (Taak 2) gebruikt de gequote vorm. Verificatie: `npm run verify` groen (799 tests); `prisma@7.8.0 validate` met postgres-datasource-kop: valid. Volgt: Taak 2 (Scrum4Me-migratie) en Taak 3 (mcp) bumpen de submodule naar de gemergde commit van deze PR. Niet zelf gemergd. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(usage): issue-scope in schema en scope-helper (IDEA-249 §5.1, §5.2)
All checks were successful
CI / Verify (pull_request) Successful in 47s
c79f6e3c0c
usage_segments krijgt issue_id/issue_phase (enum UsageIssuePhase RESEARCH|PLAN),
FK naar issues met cascade, index (issue_id, started_at) en de uitgebreide
usage_segments_scope_check. usageScopeSqlText leidt de vijfde scope 'issue' af.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

APPROVED

Findings:

  • Geen findings gevonden in de beoordeelde diff.

plan gekoppeld via pr_refs (product my Mod), referentie: T-31 (my Mod), story ST-008. Geen omitted onderdelen.

De diff rondt Taak 1 af: enum RESEARCH/PLAN, optionele issue-velden met cascade-relatie en tegenrelatie, index, uitgebreide scope-CHECK en de vijfde scope in usageScopeSqlText. De PGlite-tests dekken de vijf scopes en isoleren alle vier nieuwe ongeldige combinaties. De ongequote identifiers volgen de bestaande conventie en zijn semantisch gelijk aan het plan.

De PR-beschrijving documenteert de scope-inventarisatie en begrenst de oplevering tot Taak 1. Migratie, MCP en mod-uitrol behoren tot vervolg-PR's; de story als geheel wordt hier niet als afgerond gepresenteerd. Dit past bij de productarchitectuur: schema en pure SQL-helper in shared, migraties uitsluitend in Scrum4Me.

Verificatie op c79f6e3c0c: npm run verify geslaagd (45 testbestanden, 799 tests, typecheck en dependency-gate); prisma@6.19.0 validate geslaagd op het gegenereerde consumer-schema. Forgejo CI / Verify staat op success voor dezelfde commit.

# APPROVED Findings: - Geen findings gevonden in de beoordeelde diff. plan gekoppeld via pr_refs (product my Mod), referentie: T-31 (my Mod), story ST-008. Geen omitted onderdelen. De diff rondt Taak 1 af: enum RESEARCH/PLAN, optionele issue-velden met cascade-relatie en tegenrelatie, index, uitgebreide scope-CHECK en de vijfde scope in usageScopeSqlText. De PGlite-tests dekken de vijf scopes en isoleren alle vier nieuwe ongeldige combinaties. De ongequote identifiers volgen de bestaande conventie en zijn semantisch gelijk aan het plan. De PR-beschrijving documenteert de scope-inventarisatie en begrenst de oplevering tot Taak 1. Migratie, MCP en mod-uitrol behoren tot vervolg-PR's; de story als geheel wordt hier niet als afgerond gepresenteerd. Dit past bij de productarchitectuur: schema en pure SQL-helper in shared, migraties uitsluitend in Scrum4Me. Verificatie op c79f6e3c0c0322e1da758a4efb6c2047d23a30cb: npm run verify geslaagd (45 testbestanden, 799 tests, typecheck en dependency-gate); prisma@6.19.0 validate geslaagd op het gegenereerde consumer-schema. Forgejo CI / Verify staat op success voor dezelfde commit.
Sign in to join this conversation.
No reviewers
No labels
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
janpeter/scrum4me-shared!84
No description provided.