test(db): pariteit tussen agent_message-CHECKs en het gedeelde vocabulaire #140

Merged
janpeter merged 2 commits from feat/queue-identity-shared into main 2026-07-25 22:01:52 +02:00
Owner

Tweede van vijf PR's. Volgt op scrum4me-shared #40 (gemerged). Spec: scrum4me-mcp docs/superpowers/specs/2026-07-25-queue-identity-shared-module-design.md §5.2.

Waarom

scrum4me-shared/lib/queue-identity.ts is sinds #40 de gedeelde definitie van het queue-vocabulaire. De header van die module zegt in kapitalen dat er nog geen pariteitsgate is. Deze PR is die gate. Zonder hem kan iemand het gedeelde vocabulaire verbreden zonder migratie, en weigert de database de nieuwe waarde pas op runtime.

Scrum4Me is de juiste plek: deze repo bezit de migratie die de tabel maakte en draagt de submodule al.

Wat er in zit

  • Submodule-bump cd19b4c → be67dbe
  • Vier tests in het bestaande __tests__/db/agent-message-queue-migration.test.ts: de type-, status- en source-CHECK worden geparsed uit migration.sql en gelijkgesteld aan de shared-arrays; de vierde legt vast dat er géén CHECK op de vier adreskolommen staat

Geen database. Dit is een string-assert-test op de rauwe SQL, conform de huisstijl van __tests__/db/. Geen migratie, geen schemawijziging.

Reviewnotities

  • De helper eist precies één treffer per CHECK. Nul treffers zou een lege lijst opleveren en de vergelijking vals groen maken; een tweede CHECK op dezelfde kolom zou stil genegeerd worden. Beide gevallen zijn met een mutatie getest en falen luid.
  • Servers en modellen vallen erbuiten, en dat is geen omissie. Die vier kolommen zijn text NOT NULL zonder CHECK — er is geen DDL om ze tegen te toetsen. De vierde test legt die grens vast, zodat een toekomstige CHECK de test omver duwt in plaats van ongemerkt te passeren.
  • Bekende grens, expliciet in het bestand gedocumenteerd: de test leest één migratiebestand, terwijl de effectief geldende DDL de vouw van alle migraties is. Vandaag hetzelfde — er is precies één migratie die deze constraints raakt — maar deze repo verbreedt CHECK-vocabulaires via latere DROP/ADD CONSTRAINT-migraties (zie 20260527110000_relax_claude_jobs_constraint_for_sprint). Schrijft iemand zo'n tweede migratie, dan moet de helper mee. Dat staat als waarschuwing in de code.
  • De bestaande literal-assert expect(sql).toContain("CHECK (source IN ('cli','dashboard','mcp'))") blijft staan: die vangt opmaakdrift en herordening die de afgeleide test bewust negeert. Complementair, niet overbodig.

Verificatie

npx vitest run __tests__/db/agent-message-queue-migration.test.ts → 11 passed. npx vitest run __tests__/db/ → 8 bestanden groen, 1 overgeslagen (gated op TEST_DATABASE_URL).

Mutatiematrix: 19 mutaties gedraaid door de reviewer, waaronder een toegevoegde en een verwijderde waarde per lijst, een verwijderde CHECK, een dubbele CHECK, en een gesaboteerde helper. Elke mutatie faalde de juiste test.

Na de merge

De header van scrum4me-shared/lib/queue-identity.ts zegt dan iets onwaars ("NOG GEEN PARITEITSGATE") en krijgt een kleine vervolg-PR.

🤖 Generated with Claude Code

Tweede van vijf PR's. Volgt op `scrum4me-shared` #40 (gemerged). Spec: `scrum4me-mcp` `docs/superpowers/specs/2026-07-25-queue-identity-shared-module-design.md` §5.2. ## Waarom `scrum4me-shared/lib/queue-identity.ts` is sinds #40 de gedeelde definitie van het queue-vocabulaire. De header van die module zegt in kapitalen dat er nog geen pariteitsgate is. **Deze PR is die gate.** Zonder hem kan iemand het gedeelde vocabulaire verbreden zonder migratie, en weigert de database de nieuwe waarde pas op runtime. Scrum4Me is de juiste plek: deze repo bezit de migratie die de tabel maakte en draagt de submodule al. ## Wat er in zit - Submodule-bump `cd19b4c` → `be67dbe` - Vier tests in het bestaande `__tests__/db/agent-message-queue-migration.test.ts`: de type-, status- en source-CHECK worden geparsed uit `migration.sql` en gelijkgesteld aan de shared-arrays; de vierde legt vast dat er géén CHECK op de vier adreskolommen staat **Geen database.** Dit is een string-assert-test op de rauwe SQL, conform de huisstijl van `__tests__/db/`. Geen migratie, geen schemawijziging. ## Reviewnotities - **De helper eist precies één treffer per CHECK.** Nul treffers zou een lege lijst opleveren en de vergelijking vals groen maken; een tweede CHECK op dezelfde kolom zou stil genegeerd worden. Beide gevallen zijn met een mutatie getest en falen luid. - **Servers en modellen vallen erbuiten, en dat is geen omissie.** Die vier kolommen zijn `text NOT NULL` zonder CHECK — er is geen DDL om ze tegen te toetsen. De vierde test legt die grens vast, zodat een toekomstige CHECK de test omver duwt in plaats van ongemerkt te passeren. - **Bekende grens, expliciet in het bestand gedocumenteerd:** de test leest één migratiebestand, terwijl de effectief geldende DDL de vouw van alle migraties is. Vandaag hetzelfde — er is precies één migratie die deze constraints raakt — maar deze repo verbreedt CHECK-vocabulaires via latere `DROP/ADD CONSTRAINT`-migraties (zie `20260527110000_relax_claude_jobs_constraint_for_sprint`). Schrijft iemand zo'n tweede migratie, dan moet de helper mee. Dat staat als waarschuwing in de code. - De bestaande literal-assert `expect(sql).toContain("CHECK (source IN ('cli','dashboard','mcp'))")` blijft staan: die vangt opmaakdrift en herordening die de afgeleide test bewust negeert. Complementair, niet overbodig. ## Verificatie `npx vitest run __tests__/db/agent-message-queue-migration.test.ts` → 11 passed. `npx vitest run __tests__/db/` → 8 bestanden groen, 1 overgeslagen (gated op `TEST_DATABASE_URL`). Mutatiematrix: 19 mutaties gedraaid door de reviewer, waaronder een toegevoegde en een verwijderde waarde per lijst, een verwijderde CHECK, een dubbele CHECK, en een gesaboteerde helper. Elke mutatie faalde de juiste test. ## Na de merge De header van `scrum4me-shared/lib/queue-identity.ts` zegt dan iets onwaars ("NOG GEEN PARITEITSGATE") en krijgt een kleine vervolg-PR. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Bumpt vendor/scrum4me-shared en toetst de type-, status- en source-CHECK
uit de migratie tegen scrum4me-shared/lib/queue-identity.ts. Servers en
modellen vallen erbuiten: die kolommen dragen geen CHECK.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
test(db): corrigeer de reikwijdte-claim en dek alle vier de adreskolommen
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 3m47s
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
387e9d4fd6
Het comment beweerde dat de test maar een kant op kon falen omdat een
toegepaste migratie immutable is. Dat geldt niet voor de effectieve DDL: deze
repo verbreedt CHECK-vocabulaires via latere DROP/ADD CONSTRAINT-migraties, en
dan glipt een versmalling er stil doorheen terwijl een correcte verbreding deze
test ten onrechte rood maakt. De grens staat nu expliciet in het bestand.

De vierde test noemde vier adreskolommen maar assert'te er twee; een CHECK op
from_model of from_server glipte er ongezien doorheen.

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

Verdict: COMMENT

geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden.

Findings

  • warning — vendor/scrum4me-shared:1: de PR bumpet de shared submodule van cd19b4c... naar be67dbe..., maar de aangeleverde diff bevat niet de inhoudelijke wijzigingen in die submodule en de commit kon vanuit deze reviewcontext niet resolvebaar worden geïnspecteerd. Daardoor kan ik niet autonoom vaststellen dat @shared/queue-identity alleen het bedoelde vocabulaire wijzigt en geen regressies introduceert.

Notities

De nieuwe testdekking in __tests__/db/agent-message-queue-migration.test.ts is inhoudelijk logisch: de CHECK-waarden voor type, status en source worden expliciet gespiegeld aan het gedeelde queue-vocabulaire, en de grens rond server/model-kolommen zonder CHECK is helder gedocumenteerd. Geen blokkerende bevindingen in de zichtbare testwijziging.

# Verdict: COMMENT geen gekoppeld plan gevonden — beoordeeld op codekwaliteit + product-standaarden. ## Findings - warning — `vendor/scrum4me-shared:1`: de PR bumpet de shared submodule van `cd19b4c...` naar `be67dbe...`, maar de aangeleverde diff bevat niet de inhoudelijke wijzigingen in die submodule en de commit kon vanuit deze reviewcontext niet resolvebaar worden geïnspecteerd. Daardoor kan ik niet autonoom vaststellen dat `@shared/queue-identity` alleen het bedoelde vocabulaire wijzigt en geen regressies introduceert. ## Notities De nieuwe testdekking in `__tests__/db/agent-message-queue-migration.test.ts` is inhoudelijk logisch: de CHECK-waarden voor `type`, `status` en `source` worden expliciet gespiegeld aan het gedeelde queue-vocabulaire, en de grens rond server/model-kolommen zonder CHECK is helder gedocumenteerd. Geen blokkerende bevindingen in de zichtbare testwijziging.
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!140
No description provided.