feat(usage): usage_segments product-scope — nullable sprint, CHECK, index, additive replay (M47) #323
No reviewers
Labels
No labels
severity/s3
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/Scrum4Me!323
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "claude/sprint-usage-data-insight-4730e2"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
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
vendor/scrum4me-shared→ shared-branchfeat/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.prismavia prebuild: alleenUsageSegment(sprint_id/anchor_task_id nullable,@@index([product_id, started_at])).20261007120000_usage_segments_product_scope: 2×DROP NOT NULL, CHECKusage_segments_scope_check, indexusage_segments_product_id_started_at_idx. Additief; bestaande rijen voldoen; geen contracts-wijziging (tabel bestaat al, index/CHECK zijn geen contractobjecten).additiveFollowUpMigrationIdsinscripts/queue-dispatch/contract-inventory.ts, unie inprovision.ts additiveMigrationIds()zodat de migratie in de additieve fase ná20261005080000_usage_ledgerdraait en niet in de pre-adoptie-baseline.contract-inventory.tsis hash-input → POLICY_HASH verandert, de release bouwt een nieuwe bundle. Runbookdb-access-policy.mduitgebreid.Verificatie:
npm run verifygroen (4066 tests); migratietest 7/7.npm run test:dispatchdraaide niet lokaal (geen DB) — CI-jobqueue-dispatchmoet 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
REQUEST_CHANGES
Plan gekoppeld via pr_refs — references: T-2052, ST-1641. Er zijn geen omitted-items. Beoordeeld op commit
8b871f37640103dd909accd2921d8e7df11792cb.Findings
377989bvan 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.CI / Queue Dispatch Guard Gateloopt 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 nausage_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 --checkslagen. Forgejo meldt succes voorLint, Typecheck, Test & BuildenDB Access Policy Gateop 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.
COMMENT
Geen blokkerende codefout gevonden. Definitieve goedkeuring blijft onzeker door de open shared-afhankelijkheid en ontbrekend groen CI-bewijs.
Findings
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.__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.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
d7a6aa5a85558a151f7f60109699b0a6b34e87c1via 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 verifygroen (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.Shared #76 is gemerged (merge-commit
d75b2cd). Re-pin gedaan in163d24fb:vendor/scrum4me-shared→d75b2cd,prisma/schema.prismaopnieuw gegenereerd (alleen het// SQL:-commentaar vanUsageSegmentverandert). De codex-BLOCKER (gitlink op de branch-commit) is daarmee opgelost; wacht op CI incl.queue-dispatch.COMMENT
plan gekoppeld via pr_refs — referenties: T-2052, ST-1641 (Scrum4Me). Er zijn geen onderdelen weggelaten (
omittedis 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
163d24fbstaan zowelCI / Queue Dispatch Guard GatealsCI / Lint, Typecheck, Test & Buildnog op pending. De PR meldt dattest:dispatchlokaal 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.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.