feat(usage): usage_segments product-scope — nullable sprint, CHECK, index, additive replay (M47) #323

Merged
janpeter merged 8 commits from claude/sprint-usage-data-insight-4730e2 into main 2026-10-07 09:29:47 +02:00
Owner

M47 usage-ledger product-scope, increment 0 — Scrum4Me-deel (sprint S-2026-10-07-1, PBI-188, ST-1641 / T-2052). Bevat ook de spec (rev 5) en het plan (rev 4), dubbel-GO in reviewronde 3.

Wat verandert

  • Submodule vendor/scrum4me-shared → shared-branch feat/m47-usage-product-scope @ 377989b (scrum4me-shared PR #76). Na merge van #76 volgt één gitlink-commit die op de merge-commit pint; merge deze PR pas daarna.
  • prisma/schema.prisma via prebuild: alleen UsageSegment (sprint_id/anchor_task_id nullable, @@index([product_id, started_at])).
  • Migratie 20261007120000_usage_segments_product_scope: 2× DROP NOT NULL, CHECK usage_segments_scope_check, index usage_segments_product_id_started_at_idx. Additief; bestaande rijen voldoen; geen contracts-wijziging (tabel bestaat al, index/CHECK zijn geen contractobjecten).
  • Queue-dispatch-replay: additiveFollowUpMigrationIds in scripts/queue-dispatch/contract-inventory.ts, unie in provision.ts additiveMigrationIds() zodat de migratie in de additieve fase ná 20261005080000_usage_ledger draait en niet in de pre-adoptie-baseline. contract-inventory.ts is hash-input → POLICY_HASH verandert, de release bouwt een nieuwe bundle. Runbook db-access-policy.md uitgebreid.

Verificatie: npm run verify groen (4066 tests); migratietest 7/7. npm run test:dispatch draaide niet lokaal (geen DB) — CI-job queue-dispatch moet groen zijn.

Uitrolvolgorde (bindend): shared (#76) → deze migratie op scrum4me-server → MCP (scrum4me-mcp PR) → mod usage-ledger 0.3.0. Workers doet niet mee.

🤖 Generated with Claude Code

M47 usage-ledger product-scope, increment 0 — Scrum4Me-deel (sprint S-2026-10-07-1, PBI-188, ST-1641 / T-2052). Bevat ook de spec (rev 5) en het plan (rev 4), dubbel-GO in reviewronde 3. **Wat verandert** - Submodule `vendor/scrum4me-shared` → shared-branch `feat/m47-usage-product-scope` @ `377989b` (scrum4me-shared PR #76). **Na merge van #76 volgt één gitlink-commit die op de merge-commit pint; merge deze PR pas daarna.** - `prisma/schema.prisma` via prebuild: alleen `UsageSegment` (sprint_id/anchor_task_id nullable, `@@index([product_id, started_at])`). - Migratie `20261007120000_usage_segments_product_scope`: 2× `DROP NOT NULL`, CHECK `usage_segments_scope_check`, index `usage_segments_product_id_started_at_idx`. Additief; bestaande rijen voldoen; geen contracts-wijziging (tabel bestaat al, index/CHECK zijn geen contractobjecten). - Queue-dispatch-replay: `additiveFollowUpMigrationIds` in `scripts/queue-dispatch/contract-inventory.ts`, unie in `provision.ts additiveMigrationIds()` zodat de migratie in de additieve fase ná `20261005080000_usage_ledger` draait en niet in de pre-adoptie-baseline. `contract-inventory.ts` is hash-input → POLICY_HASH verandert, de release bouwt een nieuwe bundle. Runbook `db-access-policy.md` uitgebreid. **Verificatie:** `npm run verify` groen (4066 tests); migratietest 7/7. `npm run test:dispatch` draaide niet lokaal (geen DB) — **CI-job `queue-dispatch` moet groen zijn.** **Uitrolvolgorde (bindend):** shared (#76) → deze migratie op scrum4me-server → MCP (scrum4me-mcp PR) → mod usage-ledger 0.3.0. Workers doet niet mee. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Spec (akkoord JP op keuze C, idee-scope later; Codex-review rev 1 verwerkt) en het
plan voor increment 0: nullable sprint op usage_segments, record_usage_segment met
product_id, usage-ledger 0.3.0 met de get_context-hook. Nog geen ceremonie.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Codex NO-GO (2 BLOCKER) en Claude GO (11 MINOR) op ronde 1. Verwerkt: normalisatie van
0.2.x-state op de leesgrens, geen invoer-fallback voor productidentiteit, unparsedProduct-
teller, basis mod 0.2.2, Workers-bump uit het increment, migratietest, proeven met inline SQL.
Afgewezen met bewijs: uitstel van de index (product_id, started_at).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude MAJOR bevestigd: de migratie zou in de queue-dispatch-replay vóór usage_segments
draaien; fix via additiveFollowUpMigrationIds in contract-inventory + provision.ts, runbook-zin,
test:dispatch in de acceptatie. MINORs: Global Constraints zonder Workers-bump, proef-SQL per
sessie gebonden (Q1–Q4), volledige JSON-fixture, over-MCP happy path, §4.2-rij voor sprintwerk
zonder bekend product, bekende beperking taak-zonder-sprint, spec §8 stapverwijzing.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Codex GO (4 MINOR) en Claude GO (6 MINOR) op commit 977b715d. MINORs als tekstfixes verwerkt:
POLICY_HASH verandert wél (contract-inventory.ts is hash-input), proef 4 bindt op de laatste
taak, unattributed is geen LedgerState-veld, uitrolcontrole grept op anchor_task_id, CHECK op
één regel voor de migratietest, ensureSession houdt cost null. Geen ceremonie: hardstop.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Pins vendor/scrum4me-shared on 377989b (feat/m47-usage-product-scope, pre-merge; re-pin to
the merge commit follows). Changes since old pin 2083ae4: only the M47 commits
(5a6bebf nullable sprint/anchor, 0ee9944 usageScopeSqlText + CHECK tests, 377989b test);
the 34eeb47 QR-duration merge listed in the range was already part of the generated schema.
Adds additiveFollowUpMigrationIds so queue-dispatch replays the migration in the additive
phase, after 20261005080000_usage_ledger.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
test(usage): pin the full scope-CHECK expression in the migration test (M47 review)
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 2m46s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m46s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 3m8s
CI / DB Access Production Sentinel (pull_request) Successful in 1m15s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
8b871f3764
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

REQUEST_CHANGES

Plan gekoppeld via pr_refs — references: T-2052, ST-1641. Er zijn geen omitted-items. Beoordeeld op commit 8b871f37640103dd909accd2921d8e7df11792cb.

Findings

  • ERROR (blokkerend) — vendor/scrum4me-shared:1: de gitlink wijst naar 377989b van de featurebranch van shared-PR #76. Die PR is bij controle nog open en niet gemerged. ST-1641 vereist expliciet de S1-mergecommit; ook deze PR-beschrijving noemt de gitlink-correctie als voorwaarde vóór merge. Merge eerst shared-PR #76, voeg daarna de aangekondigde gitlink-commit toe en regenereer/controleer het consumer-schema. De huidige commit voldoet nog niet aan deze acceptatievoorwaarde.
  • INFO — tests/db/usage-segments-product-scope-migration.test.ts:65: de replay-volgorde is statisch afgedekt, maar CI / Queue Dispatch Guard Gate loopt nog. Het plan vereist een groene database-replaytest; wacht dit resultaat af vóór merge.

Beoordeling en verificatie

De nullable kolommen, beide CHECK-clausules en de productindex volgen het plan. De gesorteerde unie in additiveMigrationIds() wordt door zowel het baseline-filter als de additieve replay gebruikt en plaatst de migratie na usage_ledger. Profielcontracts en token-usage-transition blijven ongewijzigd, conform de productrichtlijnen. De runbook-aanvulling beschrijft de replayfase en de hash-impact.

Het gegenereerde Prisma-schema is exact gelijk aan de output van de gepinde shared-versie. Gerichte ESLint-controle en git diff --check slagen. Forgejo meldt succes voor Lint, Typecheck, Test & Build en DB Access Policy Gate op deze head. De lokale Vitest-run kon niet starten doordat de native binding in /tmp niet geladen kan worden (failed to map segment from shared object); dit is geen vastgestelde testfailure in de PR.

De overige MCP-, mod- en uitroltaken van M47 vallen buiten deze PR en vormen geen blokkerende findings. Buiten de ontbrekende mergecommit-pin zijn geen blokkerende codebevindingen vastgesteld.

# REQUEST_CHANGES Plan gekoppeld via pr_refs — references: T-2052, ST-1641. Er zijn geen omitted-items. Beoordeeld op commit `8b871f37640103dd909accd2921d8e7df11792cb`. ## Findings - **ERROR (blokkerend) — vendor/scrum4me-shared:1:** de gitlink wijst naar `377989b` van de featurebranch van shared-PR #76. Die PR is bij controle nog open en niet gemerged. ST-1641 vereist expliciet de S1-mergecommit; ook deze PR-beschrijving noemt de gitlink-correctie als voorwaarde vóór merge. Merge eerst shared-PR #76, voeg daarna de aangekondigde gitlink-commit toe en regenereer/controleer het consumer-schema. De huidige commit voldoet nog niet aan deze acceptatievoorwaarde. - **INFO — __tests__/db/usage-segments-product-scope-migration.test.ts:65:** de replay-volgorde is statisch afgedekt, maar `CI / Queue Dispatch Guard Gate` loopt nog. Het plan vereist een groene database-replaytest; wacht dit resultaat af vóór merge. ## Beoordeling en verificatie De nullable kolommen, beide CHECK-clausules en de productindex volgen het plan. De gesorteerde unie in `additiveMigrationIds()` wordt door zowel het baseline-filter als de additieve replay gebruikt en plaatst de migratie na `usage_ledger`. Profielcontracts en token-usage-transition blijven ongewijzigd, conform de productrichtlijnen. De runbook-aanvulling beschrijft de replayfase en de hash-impact. Het gegenereerde Prisma-schema is exact gelijk aan de output van de gepinde shared-versie. Gerichte ESLint-controle en `git diff --check` slagen. Forgejo meldt succes voor `Lint, Typecheck, Test & Build` en `DB Access Policy Gate` op deze head. De lokale Vitest-run kon niet starten doordat de native binding in /tmp niet geladen kan worden (`failed to map segment from shared object`); dit is geen vastgestelde testfailure in de PR. De overige MCP-, mod- en uitroltaken van M47 vallen buiten deze PR en vormen geen blokkerende findings. Buiten de ontbrekende mergecommit-pin zijn geen blokkerende codebevindingen vastgesteld.
docs(M47): Taak 8 stap 4 — sessies herstarten vóór de mod-sync (eindreview)
Some checks failed
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m50s
CI / DB Access Production Sentinel (pull_request) Has been cancelled
CI / Detect deploy-relevant changes (pull_request) Has been cancelled
CI / Deploy Preview (PR) (pull_request) Has been cancelled
CI / Deploy Production (main) (pull_request) Has been cancelled
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been cancelled
CI / DB Access Policy Gate (pull_request) Has been cancelled
CI / Queue Dispatch Guard Gate (pull_request) Has been cancelled
d7a6aa5a85
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

COMMENT

Geen blokkerende codefout gevonden. Definitieve goedkeuring blijft onzeker door de open shared-afhankelijkheid en ontbrekend groen CI-bewijs.

Findings

  • warning — vendor/scrum4me-shared:1: De gitlink pint 377989b op de nog open shared-PR #76, niet de S1-merge-commit uit de acceptatiecriteria. De PR-beschrijving noemt dit terecht als open vervolg: eerst #76 mergen en de pin bijwerken; deze PR is nog niet gereed voor definitieve goedkeuring.
  • warning — __tests__/db/usage-segments-product-scope-migration.test.ts:64: De vereiste CI-gates, inclusief Queue Dispatch Guard Gate, staan voor deze head nog op pending. De volgorde-assertie is aanwezig, maar de daadwerkelijke database-replay is nog niet onafhankelijk groen aangetoond.
  • minor — docs/superpowers/specs/2026-10-07-usage-ledger-product-scope-design.md:15: De introductie zegt dat geen sprint, stories, taken of codewijzigingen bestaan, terwijl deze PR ST-1641/T-2052 implementeert. Ook het plan presenteert de ceremonie nog als toekomstig. Werk deze statusbeschrijvingen bij of markeer ze expliciet als historische ontwerpstatus.

Plan en scope

plan gekoppeld via pr_refs; references: T-2052, ST-1641 (Scrum4Me). Geen omitted onderdelen. De schemawijziging, handgeschreven CHECK/index, migratietests en additieve replay voldoen inhoudelijk aan het gekoppelde taakplan. De PR claimt alleen het Scrum4Me-deel; de MCP-/mod-stappen en latere praktijkproeven vallen buiten deze review en zijn geen blokkerende findings.

Verificatie

Head d7a6aa5a85558a151f7f60109699b0a6b34e87c1 via Forgejo opgelost en uitgecheckt. Shared-delta gecontroleerd; regeneratie levert exact het gecommitteerde schema. Documentlinkcontrole groen (313 bestanden). Migratie en replaypad statisch gecontroleerd tegen product-runbook db-access-policy en het gekoppelde plan; geen extra contracts-entry vereist. Bestaande Insights-query's sluiten productsegmenten uit via taak-/sprintfilters.

De PR meldt lokaal npm run verify groen (4066 tests); dat resultaat is hier niet gereproduceerd. Lokale Vitest start niet door uitvoer-/native-librarybeperkingen in /tmp (Permission denied / failed to map segment). Geen testfalen van de PR vastgesteld. Forgejo meldt de vereiste CI-gates voor deze head nog als pending; database-replay is hier niet uitgevoerd.

# COMMENT Geen blokkerende codefout gevonden. Definitieve goedkeuring blijft onzeker door de open shared-afhankelijkheid en ontbrekend groen CI-bewijs. ## Findings - **warning** — `vendor/scrum4me-shared:1`: De gitlink pint 377989b op de nog open shared-PR #76, niet de S1-merge-commit uit de acceptatiecriteria. De PR-beschrijving noemt dit terecht als open vervolg: eerst #76 mergen en de pin bijwerken; deze PR is nog niet gereed voor definitieve goedkeuring. - **warning** — `__tests__/db/usage-segments-product-scope-migration.test.ts:64`: De vereiste CI-gates, inclusief Queue Dispatch Guard Gate, staan voor deze head nog op pending. De volgorde-assertie is aanwezig, maar de daadwerkelijke database-replay is nog niet onafhankelijk groen aangetoond. - **minor** — `docs/superpowers/specs/2026-10-07-usage-ledger-product-scope-design.md:15`: De introductie zegt dat geen sprint, stories, taken of codewijzigingen bestaan, terwijl deze PR ST-1641/T-2052 implementeert. Ook het plan presenteert de ceremonie nog als toekomstig. Werk deze statusbeschrijvingen bij of markeer ze expliciet als historische ontwerpstatus. ## Plan en scope plan gekoppeld via pr_refs; references: T-2052, ST-1641 (Scrum4Me). Geen omitted onderdelen. De schemawijziging, handgeschreven CHECK/index, migratietests en additieve replay voldoen inhoudelijk aan het gekoppelde taakplan. De PR claimt alleen het Scrum4Me-deel; de MCP-/mod-stappen en latere praktijkproeven vallen buiten deze review en zijn geen blokkerende findings. ## Verificatie Head `d7a6aa5a85558a151f7f60109699b0a6b34e87c1` via Forgejo opgelost en uitgecheckt. Shared-delta gecontroleerd; regeneratie levert exact het gecommitteerde schema. Documentlinkcontrole groen (313 bestanden). Migratie en replaypad statisch gecontroleerd tegen product-runbook db-access-policy en het gekoppelde plan; geen extra contracts-entry vereist. Bestaande Insights-query's sluiten productsegmenten uit via taak-/sprintfilters. De PR meldt lokaal `npm run verify` groen (4066 tests); dat resultaat is hier niet gereproduceerd. Lokale Vitest start niet door uitvoer-/native-librarybeperkingen in /tmp (Permission denied / failed to map segment). Geen testfalen van de PR vastgesteld. Forgejo meldt de vereiste CI-gates voor deze head nog als pending; database-replay is hier niet uitgevoerd.
chore(shared): pin vendor/scrum4me-shared on the M47 merge commit d75b2cd
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 2m45s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 4m57s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m54s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / DB Access Production Sentinel (pull_request) Successful in 1m15s
CI / Detect deploy-relevant changes (pull_request) Has been skipped
CI / Deploy Preview (PR) (pull_request) Has been skipped
CI / Deploy Production (main) (pull_request) Has been skipped
163d24fb61
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Author
Owner

Shared #76 is gemerged (merge-commit d75b2cd). Re-pin gedaan in 163d24fb: vendor/scrum4me-shared → d75b2cd, prisma/schema.prisma opnieuw gegenereerd (alleen het // SQL:-commentaar van UsageSegment verandert). De codex-BLOCKER (gitlink op de branch-commit) is daarmee opgelost; wacht op CI incl. queue-dispatch.

Shared #76 is gemerged (merge-commit `d75b2cd`). Re-pin gedaan in `163d24fb`: `vendor/scrum4me-shared` → `d75b2cd`, `prisma/schema.prisma` opnieuw gegenereerd (alleen het `// SQL:`-commentaar van `UsageSegment` verandert). De codex-BLOCKER (gitlink op de branch-commit) is daarmee opgelost; wacht op CI incl. `queue-dispatch`.
s4m-codex-reviewer left a comment

COMMENT

plan gekoppeld via pr_refs — referenties: T-2052, ST-1641 (Scrum4Me). Er zijn geen onderdelen weggelaten (omitted is leeg).

De diff is inhoudelijk conform het Scrum4Me-deel van het plan: nullable sprint/anker, de scope-CHECK, productindex, submodule-bump, migratietests en additieve dispatch-replay zijn aanwezig. De gitlink d75b2cde is bevestigd als merge-commit van scrum4me-shared PR #76; het gegenereerde UsageSegment-model komt overeen met shared. De CHECK laat precies de drie bedoelde combinaties toe. Geen blokkerende codebevindingen gevonden.

Findings

  • WARNING — tests/db/usage-segments-product-scope-migration.test.ts:65 — De test controleert de replay-inventaris en volgorde, maar voert de PostgreSQL-replay niet uit. Voor head 163d24fb staan zowel CI / Queue Dispatch Guard Gate als CI / Lint, Typecheck, Test & Build nog op pending. De PR meldt dat test:dispatch lokaal niet draaide. Daarmee is de expliciete acceptatie-eis van een groene dispatch-gate nog niet aangetoond; daarom nu COMMENT. Dit is ontbrekend verificatiebewijs, geen vastgestelde runtimefout.
  • MINOR — docs/superpowers/specs/2026-10-07-usage-ledger-product-scope-design.md:14 — De inleiding zegt nog dat geen sprint, PBI, stories, taken of codewijzigingen bestaan; deze PR implementeert inmiddels ST-1641/T-2052 en noemt PBI-188. Actualiseer de status of markeer die passage als historische context. Ook docs/plans/M47-usage-ledger-product-scope.md:16 noemt nog 'nog geen ceremonie'.

Beoordeeld op de aangeleverde diff en aanvullende broncode op de exacte head, met de productstandaard runbooks/db-access-policy. De baseline sluit de nieuwe migratie via additiveMigrationIds uit; de additieve fase speelt haar gesorteerd ná usage_ledger af. De bestaande tabel heeft al een contract; index en CHECK vragen geen nieuwe contractentry. De uitgebreidere MCP/mod/Workers-plandelen vallen buiten de afgebakende scope van deze PR en vormen geen ontbrekend werk voor deze review.

Verificatiebeperking: geen lokale projecttest/build of database-replay uitgevoerd in deze reviewomgeving; de lokale verify-resultaten in de PR-beschrijving zijn auteursrapportage. CI-status is rechtstreeks op bovenstaande head gecontroleerd.

# COMMENT plan gekoppeld via pr_refs — referenties: T-2052, ST-1641 (Scrum4Me). Er zijn geen onderdelen weggelaten (`omitted` is leeg). De diff is inhoudelijk conform het Scrum4Me-deel van het plan: nullable sprint/anker, de scope-CHECK, productindex, submodule-bump, migratietests en additieve dispatch-replay zijn aanwezig. De gitlink d75b2cde is bevestigd als merge-commit van scrum4me-shared PR #76; het gegenereerde UsageSegment-model komt overeen met shared. De CHECK laat precies de drie bedoelde combinaties toe. Geen blokkerende codebevindingen gevonden. ## Findings - **WARNING — __tests__/db/usage-segments-product-scope-migration.test.ts:65** — De test controleert de replay-inventaris en volgorde, maar voert de PostgreSQL-replay niet uit. Voor head 163d24fb staan zowel `CI / Queue Dispatch Guard Gate` als `CI / Lint, Typecheck, Test & Build` nog op pending. De PR meldt dat `test:dispatch` lokaal niet draaide. Daarmee is de expliciete acceptatie-eis van een groene dispatch-gate nog niet aangetoond; daarom nu COMMENT. Dit is ontbrekend verificatiebewijs, geen vastgestelde runtimefout. - **MINOR — docs/superpowers/specs/2026-10-07-usage-ledger-product-scope-design.md:14** — De inleiding zegt nog dat geen sprint, PBI, stories, taken of codewijzigingen bestaan; deze PR implementeert inmiddels ST-1641/T-2052 en noemt PBI-188. Actualiseer de status of markeer die passage als historische context. Ook docs/plans/M47-usage-ledger-product-scope.md:16 noemt nog 'nog geen ceremonie'. Beoordeeld op de aangeleverde diff en aanvullende broncode op de exacte head, met de productstandaard `runbooks/db-access-policy`. De baseline sluit de nieuwe migratie via additiveMigrationIds uit; de additieve fase speelt haar gesorteerd ná usage_ledger af. De bestaande tabel heeft al een contract; index en CHECK vragen geen nieuwe contractentry. De uitgebreidere MCP/mod/Workers-plandelen vallen buiten de afgebakende scope van deze PR en vormen geen ontbrekend werk voor deze review. Verificatiebeperking: geen lokale projecttest/build of database-replay uitgevoerd in deze reviewomgeving; de lokale verify-resultaten in de PR-beschrijving zijn auteursrapportage. CI-status is rechtstreeks op bovenstaande head gecontroleerd.
Sign in to join this conversation.
No reviewers
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!323
No description provided.