feat(usage): product-scope on usage_segments — nullable sprint/anchor, scope CHECK, index (M47) #76

Merged
janpeter merged 4 commits from feat/m47-usage-product-scope into main 2026-10-07 08:57:51 +02:00
Owner

Increment 0 van M47 usage-ledger product-scope (Scrum4Me sprint S-2026-10-07-1, PBI-188, ST-1640 / T-2050 + T-2051).

Wat verandert

  • usage_segments.sprint_id en anchor_task_id worden nullable; sprint Sprint?.
  • CHECK usage_segments_scope_check als // SQL:-commentaar in het modelblok: (task_id IS NULL OR sprint_id IS NOT NULL) AND ((sprint_id IS NULL) = (anchor_task_id IS NULL)).
  • @@index([product_id, started_at]) voor de productweergave.
  • lib/usage-sql.ts: usageScopeSqlText(alias) leidt de scope af (sprint_task | sprint_overhead | product); niets wordt opgeslagen.
  • PGlite-tests: nullable DDL met CHECK, drie scope-rijen, drie afgewezen inserts.

Uitrolvolgorde (bindend, spec §7): shared → Scrum4Me-migratie 20261007120000_usage_segments_product_scope → MCP record_usage_segment → mod usage-ledger 0.3.0. Workers doet niet mee.

Spec: Scrum4Me docs/superpowers/specs/2026-10-07-usage-ledger-product-scope-design.md (rev 5); plan docs/plans/M47-usage-ledger-product-scope.md (rev 4), beide dubbel-GO in reviewronde 3.

Verify: npm run verify groen (43 bestanden, 732 tests). Consumenten (Scrum4Me, MCP) pinnen hun submodule na merge op de merge-commit.

🤖 Generated with Claude Code

Increment 0 van M47 usage-ledger product-scope (Scrum4Me sprint S-2026-10-07-1, PBI-188, ST-1640 / T-2050 + T-2051). **Wat verandert** - `usage_segments.sprint_id` en `anchor_task_id` worden nullable; `sprint Sprint?`. - CHECK `usage_segments_scope_check` als `// SQL:`-commentaar in het modelblok: `(task_id IS NULL OR sprint_id IS NOT NULL) AND ((sprint_id IS NULL) = (anchor_task_id IS NULL))`. - `@@index([product_id, started_at])` voor de productweergave. - `lib/usage-sql.ts`: `usageScopeSqlText(alias)` leidt de scope af (`sprint_task` | `sprint_overhead` | `product`); niets wordt opgeslagen. - PGlite-tests: nullable DDL met CHECK, drie scope-rijen, drie afgewezen inserts. **Uitrolvolgorde (bindend, spec §7):** shared → Scrum4Me-migratie `20261007120000_usage_segments_product_scope` → MCP `record_usage_segment` → mod usage-ledger 0.3.0. Workers doet niet mee. Spec: Scrum4Me `docs/superpowers/specs/2026-10-07-usage-ledger-product-scope-design.md` (rev 5); plan `docs/plans/M47-usage-ledger-product-scope.md` (rev 4), beide dubbel-GO in reviewronde 3. Verify: `npm run verify` groen (43 bestanden, 732 tests). Consumenten (Scrum4Me, MCP) pinnen hun submodule na merge op de merge-commit. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
test(usage): scope CHECK rejects an anchor without a sprint (M47 review)
All checks were successful
CI / Verify (pull_request) Successful in 46s
377989b049
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

APPROVED

Findings

  • Geen blokkerende of overige codefindings.

Plan gekoppeld via pr_refs (product Scrum4Me): T-2050 (Scrum4Me), T-2051 (Scrum4Me), ST-1640 (Scrum4Me). Geen omitted onderdelen of afgekapte plandocumenten.

De diff dekt de shared-scope van ST-1640: optionele sprintrelatie en sprint/anker, CHECK-documentatie binnen het model, productindex, afgeleide scope-helper en PGlite-tests voor alle drie scopes en drie ongeldige combinaties. Bestaande SQL-helpers blijven ongewijzigd. De PR-beschrijving noemt de vereiste uitrolvolgorde en claimt alleen increment 0. De daadwerkelijke database-migratie hoort volgens de productarchitectuur bij Scrum4Me en valt buiten deze PR.

Verificatie op head 377989b049: dependencycontrole en shell-controle geslaagd, TypeScript-typecheck geslaagd, 43 testbestanden / 733 tests geslaagd. Consumerschema bevat precies één nullable anchor_task_id. Het letterlijke npm run verify stopte door noexec op /tmp; de typecheck en volledige testsuite zijn vervolgens rechtstreeks via Node uitgevoerd, met uitvoerbare native dependencies van dezelfde versie buiten /tmp.

# APPROVED ## Findings - Geen blokkerende of overige codefindings. Plan gekoppeld via pr_refs (product Scrum4Me): T-2050 (Scrum4Me), T-2051 (Scrum4Me), ST-1640 (Scrum4Me). Geen omitted onderdelen of afgekapte plandocumenten. De diff dekt de shared-scope van ST-1640: optionele sprintrelatie en sprint/anker, CHECK-documentatie binnen het model, productindex, afgeleide scope-helper en PGlite-tests voor alle drie scopes en drie ongeldige combinaties. Bestaande SQL-helpers blijven ongewijzigd. De PR-beschrijving noemt de vereiste uitrolvolgorde en claimt alleen increment 0. De daadwerkelijke database-migratie hoort volgens de productarchitectuur bij Scrum4Me en valt buiten deze PR. Verificatie op head 377989b0494c0e8a6dba95f7c2affd7ef59fc9e0: dependencycontrole en shell-controle geslaagd, TypeScript-typecheck geslaagd, 43 testbestanden / 733 tests geslaagd. Consumerschema bevat precies één nullable anchor_task_id. Het letterlijke npm run verify stopte door noexec op /tmp; de typecheck en volledige testsuite zijn vervolgens rechtstreeks via Node uitgevoerd, met uitvoerbare native dependencies van dezelfde versie buiten /tmp.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

COMMENT

Geen blokkerende code- of planafwijkingen gevonden. Door de onderstaande verificatiebeperking geef ik geen APPROVED.

Findings:

  • INFO — __tests__/usage-sql.test.ts:223: de nieuwe scope- en CHECK-tests zijn inhoudelijk passend (drie geldige scopes en drie ongeldige combinaties), maar konden in deze reviewomgeving niet worden uitgevoerd. npm run verify stopt op tsc: Permission denied; rechtstreeks via Node slaagt de typecheck, maar Vitest start niet doordat de native Rollup-module op /tmp niet kan worden geladen (failed to map segment from shared object). Dit is een omgevingsbeperking, geen aangetoond defect in de diff.

Plan gekoppeld via pr_refs (product Scrum4Me): T-2050 (Scrum4Me), T-2051 (Scrum4Me), ST-1640 (Scrum4Me). Er is niets omitted/afgekapt. De nullable relation/kolommen, index, SQL-CHECK-commentaar binnen het model, afgeleide scope-helper en fixtures voldoen aan de geraakte acceptatiecriteria. De PR-beschrijving vermeldt shared → Scrum4Me-migratie → MCP → mod 0.3.0, zonder Workers. De daadwerkelijke migratie en consumerwijzigingen vallen buiten deze increment.

Architectuur: pure SQL-tekst zonder nieuwe runtime-dependencies; migraties blijven conform de productstandaard bij Scrum4Me. Schema- en helpercommentaar documenteren de derde scope. Dependencycontroles en rechtstreeks uitgevoerde TypeScript-typecheck slagen; de consumer-schema-generator geeft precies één anchor_task_id String?-treffer.

Beoordeeld op head e70c08f1e4610ae98ee73630061563d8cc52b560; Forgejo meldt dat de PR inmiddels is gemerged.

# COMMENT Geen blokkerende code- of planafwijkingen gevonden. Door de onderstaande verificatiebeperking geef ik geen APPROVED. Findings: - INFO — `__tests__/usage-sql.test.ts:223`: de nieuwe scope- en CHECK-tests zijn inhoudelijk passend (drie geldige scopes en drie ongeldige combinaties), maar konden in deze reviewomgeving niet worden uitgevoerd. `npm run verify` stopt op `tsc: Permission denied`; rechtstreeks via Node slaagt de typecheck, maar Vitest start niet doordat de native Rollup-module op /tmp niet kan worden geladen (`failed to map segment from shared object`). Dit is een omgevingsbeperking, geen aangetoond defect in de diff. Plan gekoppeld via pr_refs (product Scrum4Me): T-2050 (Scrum4Me), T-2051 (Scrum4Me), ST-1640 (Scrum4Me). Er is niets omitted/afgekapt. De nullable relation/kolommen, index, SQL-CHECK-commentaar binnen het model, afgeleide scope-helper en fixtures voldoen aan de geraakte acceptatiecriteria. De PR-beschrijving vermeldt shared → Scrum4Me-migratie → MCP → mod 0.3.0, zonder Workers. De daadwerkelijke migratie en consumerwijzigingen vallen buiten deze increment. Architectuur: pure SQL-tekst zonder nieuwe runtime-dependencies; migraties blijven conform de productstandaard bij Scrum4Me. Schema- en helpercommentaar documenteren de derde scope. Dependencycontroles en rechtstreeks uitgevoerde TypeScript-typecheck slagen; de consumer-schema-generator geeft precies één `anchor_task_id String?`-treffer. Beoordeeld op head `e70c08f1e4610ae98ee73630061563d8cc52b560`; Forgejo meldt dat de PR inmiddels is gemerged.
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!76
No description provided.