feat(db): runtime HARNESS, product_harness_choices en job_cost_reports met additieve contracts (M45-2a) #314

Merged
janpeter merged 2 commits from feat/m45-2a-harness-db into main 2026-10-06 14:05:06 +02:00
Owner

Aanleiding: M45-2a, Taak 2 van docs/plans/M45-2a-harness-fundament.md. Het plan kreeg dubbel GO in planronde 2. Dit is Scrum4Me-taak T-2024 (ST-1635, PBI-183). De server-DB krijgt runtime HARNESS en de twee nieuwe tabellen. In 2a schrijft niets een HARNESS-rij.

Wat

  • Submodule vendor/scrum4me-shared gaat van 9dbc93a naar 132656b, de mergecommit van janpeter/scrum4me-shared#74.
    • prisma/schema.prisma is alleen geregenereerd met gen-schema.sh, niet met de hand.
    • Het schema verschilt alleen in: enum-lid HARNESS, twee modellen en twee virtuele back-relations.
  • Migratie 1, 20261006120000_agent_runtime_harness: alleen ALTER TYPE "AgentRuntime" ADD VALUE IF NOT EXISTS 'HARNESS'. Dat is een eigen migratie, omdat Postgres een nieuw enum-lid niet toestaat in de transactie waarin het ontstaat.
  • Migratie 2, 20261006120100_harness_choices_cost_reports:
    • gegenereerd met prisma migrate diff, zonder het enum-deel;
    • product_harness_choices met PK (product_id, kind) en drie CHECKs: jobsoort, configuratienaam en plafond > 0;
    • job_cost_reports met PK job_id en twee CHECKs: kostbron en bedrag ≥ 0;
    • twee FK's met ON DELETE CASCADE;
    • geen GRANT, en geen wijziging aan een tabel uit het IDEA-213-manifest.
  • Twee additieve contracts in scripts/db-access/profiles/scrum4me.json:
    • product_harness_choices: web en preparedWeb krijgen SELECT, INSERT, UPDATE en DELETE; observer krijgt SELECT;
    • job_cost_reports: web en preparedWeb krijgen SELECT, INSERT en UPDATE, zonder DELETE; observer krijgt SELECT;
    • queue, dispatch, projector en PUBLIC krijgen niets.
  • Tests:
    • __tests__/db/harness-migration.test.ts controleert de volgorde na 20261005080000_usage_ledger, de exacte inhoud van M1, de CHECKs, PK's en FK's, het ontbreken van GRANT, VIEW, FUNCTION en HARNESS in M2, en dat er niets aan een vastgepinde tabel verandert. De tabellen komen uit het manifest, en de test controleert ook zijn eigen controles;
    • __tests__/lib/db-access/harness-contracts.test.ts controleert de additieve split, dat de gesloten set nog naar de IDEA-227-pin hasht, de exacte rechten, en dat de map van migrationId bestaat.

Uitrol (niet automatisch)

  • Geen auto-merge, dus geen DEPLOY-job. De uitrol is T-2025 en gebeurt alleen op JP's go: update_scrum4me_web (prisma-operator.sh deploy).
  • Policy-hash: het profiel verandert, dus de policy-hash ook. Na de eerste deploy volgt prepare_policy_bundle exit 3, dan approve_policy_hash, dan een nieuwe deploy.
  • Neon/Vercel valt buiten heel M45 (JP, 2026-10-06).
  • Lockstep: workers, MCP en docker blijven voorlopig op hun oude shared. Dat is veilig zolang er geen HARNESS-rij is; die komt pas in 2e.

Verificatie

  • npm run verify is groen: 384 testbestanden, 3989 tests, 0 lint-errors. De 6 lint-warnings en de vi.hoisted-warnings stonden er al.
  • npx prisma validate is groen.
  • npm run build draait niet in een Claude-worktree, omdat .env en de Prisma-CLI-resolutie daar ontbreken. De CI-build is het bewijs.
  • Beide nieuwe testbestanden waren eerst rood: 12 falend, 11 geslaagd (de geslaagde zijn de regex-controles). Een tijdelijke index op claude_jobs in M2 maakte de pin-test rood, en de controles op de checker vangen een blinde regex.
  • Daarnaast heb ik M1 en M2 afgespeeld op PGlite (Postgres 17) met stubtabellen:
    • het enum wordt {CLAUDE,CODEX,HARNESS}, en M1 is herhaalbaar;
    • alle CHECKs weigeren wat ze moeten weigeren: IDEA_PLAN, Gsq, -x, plafond 0, een plafond > Decimal(10,4), een onbekende kostbron en een negatief bedrag;
    • none met NULL wordt geaccepteerd, de upsert werkt, en de cascades vanuit products en claude_jobs werken.
  • CI moet db-access:test-db (regressie) en test:dispatch laten slagen. test:dispatch speelt alle migraties af en controleert de after-schema's van het manifest.

🤖 Generated with Claude Code

Aanleiding: M45-2a, Taak 2 van [`docs/plans/M45-2a-harness-fundament.md`](https://git.jp-visser.nl/janpeter/Scrum4Me/src/commit/2fbde2814d0ea7507d6c4cc1d86b75a17dcb4580/docs/plans/M45-2a-harness-fundament.md). Het plan kreeg dubbel GO in planronde 2. Dit is Scrum4Me-taak T-2024 (ST-1635, PBI-183). De server-DB krijgt runtime `HARNESS` en de twee nieuwe tabellen. In 2a schrijft niets een `HARNESS`-rij. ## Wat - **Submodule** `vendor/scrum4me-shared` gaat van `9dbc93a` naar `132656b`, de mergecommit van janpeter/scrum4me-shared#74. - `prisma/schema.prisma` is alleen geregenereerd met `gen-schema.sh`, niet met de hand. - Het schema verschilt alleen in: enum-lid `HARNESS`, twee modellen en twee virtuele back-relations. - **Migratie 1, `20261006120000_agent_runtime_harness`:** alleen `ALTER TYPE "AgentRuntime" ADD VALUE IF NOT EXISTS 'HARNESS'`. Dat is een eigen migratie, omdat Postgres een nieuw enum-lid niet toestaat in de transactie waarin het ontstaat. - **Migratie 2, `20261006120100_harness_choices_cost_reports`:** - gegenereerd met `prisma migrate diff`, zonder het enum-deel; - `product_harness_choices` met PK (`product_id`, `kind`) en drie CHECKs: jobsoort, configuratienaam en plafond > 0; - `job_cost_reports` met PK `job_id` en twee CHECKs: kostbron en bedrag ≥ 0; - twee FK's met `ON DELETE CASCADE`; - geen `GRANT`, en geen wijziging aan een tabel uit het IDEA-213-manifest. - **Twee additieve contracts** in `scripts/db-access/profiles/scrum4me.json`: - `product_harness_choices`: web en preparedWeb krijgen SELECT, INSERT, UPDATE en DELETE; observer krijgt SELECT; - `job_cost_reports`: web en preparedWeb krijgen SELECT, INSERT en UPDATE, zonder DELETE; observer krijgt SELECT; - `queue`, `dispatch`, `projector` en PUBLIC krijgen niets. - **Tests:** - `__tests__/db/harness-migration.test.ts` controleert de volgorde na `20261005080000_usage_ledger`, de exacte inhoud van M1, de CHECKs, PK's en FK's, het ontbreken van GRANT, VIEW, FUNCTION en `HARNESS` in M2, en dat er niets aan een vastgepinde tabel verandert. De tabellen komen uit het manifest, en de test controleert ook zijn eigen controles; - `__tests__/lib/db-access/harness-contracts.test.ts` controleert de additieve split, dat de gesloten set nog naar de IDEA-227-pin hasht, de exacte rechten, en dat de map van `migrationId` bestaat. ## Uitrol (niet automatisch) - **Geen auto-merge, dus geen DEPLOY-job.** De uitrol is T-2025 en gebeurt alleen op JP's go: `update_scrum4me_web` (`prisma-operator.sh deploy`). - **Policy-hash:** het profiel verandert, dus de policy-hash ook. Na de eerste deploy volgt `prepare_policy_bundle` exit 3, dan `approve_policy_hash`, dan een nieuwe deploy. - **Neon/Vercel** valt buiten heel M45 (JP, 2026-10-06). - **Lockstep:** workers, MCP en docker blijven voorlopig op hun oude shared. Dat is veilig zolang er geen `HARNESS`-rij is; die komt pas in 2e. ## Verificatie - `npm run verify` is groen: 384 testbestanden, 3989 tests, 0 lint-errors. De 6 lint-warnings en de `vi.hoisted`-warnings stonden er al. - `npx prisma validate` is groen. - `npm run build` draait niet in een Claude-worktree, omdat `.env` en de Prisma-CLI-resolutie daar ontbreken. De CI-build is het bewijs. - Beide nieuwe testbestanden waren eerst rood: 12 falend, 11 geslaagd (de geslaagde zijn de regex-controles). Een tijdelijke index op `claude_jobs` in M2 maakte de pin-test rood, en de controles op de checker vangen een blinde regex. - Daarnaast heb ik M1 en M2 afgespeeld op PGlite (Postgres 17) met stubtabellen: - het enum wordt `{CLAUDE,CODEX,HARNESS}`, en M1 is herhaalbaar; - alle CHECKs weigeren wat ze moeten weigeren: `IDEA_PLAN`, `Gsq`, `-x`, plafond 0, een plafond > Decimal(10,4), een onbekende kostbron en een negatief bedrag; - `none` met NULL wordt geaccepteerd, de upsert werkt, en de cascades vanuit `products` en `claude_jobs` werken. - CI moet `db-access:test-db` (regressie) en `test:dispatch` laten slagen. `test:dispatch` speelt alle migraties af en controleert de after-schema's van het manifest. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
De submodule gaat van 9dbc93a naar de mergecommit van scrum4me-shared #74: runtime HARNESS in het
schema, lib/harness-config.ts en de resolvertak met kostenplafond.

prisma/schema.prisma is geregenereerd met `bash scripts/gen-schema.sh` (nooit met de hand). Het verschil
met main is precies de shared-wijziging:
- enum AgentRuntime: lid HARNESS
- Product.harness_choices en ClaudeJob.cost_report: virtuele back-relations, geen kolommen
- modellen ProductHarnessChoice (product_harness_choices) en JobCostReport (job_cost_reports)

De migraties en de DB-rechten voor deze objecten volgen in de volgende commit.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(db): runtime HARNESS, product_harness_choices en job_cost_reports met additieve contracts (M45-2a)
All checks were successful
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 9m57s
CI / DB Access Policy Gate (pull_request) Successful in 1m58s
CI / DB Access Production Sentinel (pull_request) Successful in 1m23s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m50s
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
99082707c4
M45-2a legt het database-fundament voor runtime HARNESS (een LiteLLM-model als derde runtime naast
CLAUDE en CODEX). Alleen schema, migraties en DB-rechten: in 2a schrijft niets een HARNESS-rij.

- 20261006120000_agent_runtime_harness: ALTER TYPE "AgentRuntime" ADD VALUE IF NOT EXISTS 'HARNESS'.
  Bewust een eigen migratie: Postgres weigert een nieuw enum-lid in dezelfde transactie als de
  ALTER TYPE (precedent 20260704090000_add_idea_chat_kind).
- 20261006120100_harness_choices_cost_reports: de tabellen product_harness_choices (keuze per product
  en jobsoort) en job_cost_reports (gemeld bedrag per job). 1:1 uit `prisma migrate diff` (zonder het
  enum-deel), plus vijf met de hand toegevoegde CHECK-constraints. Additief: geen enkele wijziging aan
  een tabel uit het IDEA-213-adoptiemanifest; de twee FK's staan op de nieuwe tabellen en laten de
  vingerafdruk van products en claude_jobs ongemoeid.
- Geen GRANT in de SQL: de rechten komen uit twee additieve contracts in
  scripts/db-access/profiles/scrum4me.json (applyContracts), zoals bij usage_ledger. product_harness_choices
  volgt het usage_lines-patroon (web en preparedWeb SELECT, INSERT, UPDATE, DELETE; observer SELECT).
  job_cost_reports krijgt nergens DELETE: het cascade-delete vanuit claude_jobs vraagt dat recht niet
  (precedent task_estimates); web en preparedWeb doen SELECT, INSERT en UPDATE voor de upsert.
- Tests: __tests__/db/harness-migration.test.ts (mapvolgorde, exacte enum-migratie, de vijf CHECKs, PK's
  en FK's, geen GRANT, view, functie, sequence, identity of HARNESS in de tabellenmigratie, en geen
  ALTER, INDEX, COMMENT, DROP of TRUNCATE op een vastgepinde tabel; de lijst komt uit het manifest, met
  controles dat de regexen aantoonbaar raken) en __tests__/lib/db-access/harness-contracts.test.ts
  (additief, exacte privileges, de gesloten set hasht nog naar de IDEA-227-pin).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

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

Verdict: COMMENT

Geen blokkerende codefouten gevonden; goedkeuring blijft achterwege omdat de verplichte verificatie nog niet bevestigd is.

Findings

  • WARNING — tests/db/harness-migration.test.ts:5 — De tests controleren SQL als tekst. Voor head 99082707c47d668aa4103a4651223a62810cd315 staan de CI-gates Lint, Typecheck, Test & Build, DB Access Policy Gate en Queue Dispatch Guard Gate nog op pending. Het plan vereist ook een geslaagde build, db-access:test-db en volledige migratie-replay via test:dispatch. De PR rapporteert lokale verify/Prisma-validatie en een PGlite-proef, maar die vervangen deze gates niet. Dit is ontbrekend verificatiebewijs, geen aangetoonde codefout.

Beoordeling

De aparte, herhaalbare enum-migratie en de twee tabellen met vijf CHECKs, primaire sleutels en cascade-FK's volgen het afgesproken contract. De diff wijzigt geen vastgepinde bestaande tabel en maakt geen HARNESS-rijen. De rechten zijn additief en minimaal volgens het plan, inclusief geen DELETE op job_cost_reports. De tests controleren de gesloten policy-hash, exacte privileges en verboden wijzigingen aan gepinde tabellen. De bestaande bundle-test neemt migraties dynamisch uit de contracts mee. Het gegenereerde schema komt voor modellen/enums overeen met shared-mergecommit 132656b; de SQL-commentaren en PR-beschrijving documenteren de keuzes en uitrolgrens.

plan gekoppeld via pr_refs — referenties: T-2024, T-2025, ST-1635, PBI-183; plandocument docs/plans/M45-2a-harness-fundament.md. De meegeleverde documenttekst is afgekapt; de relevante sectie Taak 2 is aanvullend via ProductDocs gelezen. omitted is leeg. Binnen de scope van T-2024 is de diff plan-conform, met bovenstaande open verificatie. T-2025 (serveruitrol, hashgoedkeuring en praktijkcontroles) wordt expliciet later uitgevoerd en is daarom geen ontbrekende implementatie in deze PR.

Verificatie door reviewer: diff, actuele PR/head, CI-status, shared-bronnen/schema, policy-hashing en bestaande bundle-test gelezen. Geen lokale projecttest/build uitgevoerd; de lokale resultaten hierboven zijn door de auteur gerapporteerd.

# Verdict: COMMENT Geen blokkerende codefouten gevonden; goedkeuring blijft achterwege omdat de verplichte verificatie nog niet bevestigd is. ## Findings - **WARNING — __tests__/db/harness-migration.test.ts:5** — De tests controleren SQL als tekst. Voor head `99082707c47d668aa4103a4651223a62810cd315` staan de CI-gates **Lint, Typecheck, Test & Build**, **DB Access Policy Gate** en **Queue Dispatch Guard Gate** nog op `pending`. Het plan vereist ook een geslaagde build, `db-access:test-db` en volledige migratie-replay via `test:dispatch`. De PR rapporteert lokale verify/Prisma-validatie en een PGlite-proef, maar die vervangen deze gates niet. Dit is ontbrekend verificatiebewijs, geen aangetoonde codefout. ## Beoordeling De aparte, herhaalbare enum-migratie en de twee tabellen met vijf CHECKs, primaire sleutels en cascade-FK's volgen het afgesproken contract. De diff wijzigt geen vastgepinde bestaande tabel en maakt geen HARNESS-rijen. De rechten zijn additief en minimaal volgens het plan, inclusief geen DELETE op `job_cost_reports`. De tests controleren de gesloten policy-hash, exacte privileges en verboden wijzigingen aan gepinde tabellen. De bestaande bundle-test neemt migraties dynamisch uit de contracts mee. Het gegenereerde schema komt voor modellen/enums overeen met shared-mergecommit `132656b`; de SQL-commentaren en PR-beschrijving documenteren de keuzes en uitrolgrens. **plan gekoppeld via pr_refs** — referenties: `T-2024`, `T-2025`, `ST-1635`, `PBI-183`; plandocument `docs/plans/M45-2a-harness-fundament.md`. De meegeleverde documenttekst is afgekapt; de relevante sectie Taak 2 is aanvullend via ProductDocs gelezen. `omitted` is leeg. Binnen de scope van T-2024 is de diff plan-conform, met bovenstaande open verificatie. T-2025 (serveruitrol, hashgoedkeuring en praktijkcontroles) wordt expliciet later uitgevoerd en is daarom geen ontbrekende implementatie in deze PR. Verificatie door reviewer: diff, actuele PR/head, CI-status, shared-bronnen/schema, policy-hashing en bestaande bundle-test gelezen. Geen lokale projecttest/build uitgevoerd; de lokale resultaten hierboven zijn door de auteur gerapporteerd.
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!314
No description provided.