feat(db,chat): agent_model_facts met additief contract, chat-label uit de registry (IDEA-269 S2) #406

Merged
janpeter merged 2 commits from feat/idea-269-agent-model-facts into main 2026-10-20 16:20:31 +02:00
Owner

IDEA-269 S2: sprint S-2026-10-20-1, story ST-084, taken T-272 en T-273. De spec staat in agent-harness docs/specs/2026-10-20-idea-269-model-registry-origin-design.md rev 4, §4.3 en §4.4; die spec staat nog op branch claude/remote-lokale-modellen-e5a55a.

T-272: migratie, additief contract en tests

  • Shared-bump naar d07f8b62, de merge van scrum4me-shared PR #86. prisma/schema.prisma krijgt alleen ModelOrigin, AgentModelFacts en de back-relation facts.
  • Migratie 20261020140000_agent_model_facts:
    • de enum, de tabel en de FK met ON DELETE/UPDATE CASCADE naar agent_models;
    • een backfill: elke HARNESS-rij krijgt een facts-rij. gsq-lokaal wordt LOCAL met ollama/qwen3.8-gsq-rco:27b-iq3_s-text, iq3_s en 65536; de rest wordt REMOTE;
    • geen GRANT, REVOKE of ALTER TABLE "agent_models".
  • Contract public.table.agent_model_facts (additief, achteraan contracts):
    • web en preparedWeb: CRUD;
    • observer: SELECT, voor de read-only driftcheck;
    • queue, dispatch en projector: niets;
    • geen publicPrivileges.
  • Tests, naar het precedent van product_access_steps:
    • __tests__/db/agent-model-facts-migration.test.ts. pinnedTableViolations vangt nu ook INSERT INTO, UPDATE en DELETE FROM op een vastgepinde tabel. Zo is aantoonbaar dat de backfill uit agent_models alleen leest;
    • __tests__/lib/db-access/agent-model-facts-contract.test.ts: het contract is additief, en de gesloten set hasht nog naar de pin.
  • Docs: docs/architecture/data-model.md krijgt een sectie agent_model_facts en een rij ModelOrigin in de enum-tabel.

Backfill met de hand gecontroleerd: CI draait de backfill tegen een lege agent_models. De kolomlijst en de WHEN-takken zijn daarom met de hand tegen spec §4.3 gecontroleerd, en de migratietest pint het statement letterlijk. De productiecontrole is S4-T3, stap 3.

T-273: chat-label 'gehost' uit de registry

  • Nieuw lib/agent-chat/model-options.ts met toChatModelOptions. facts is verplicht in het invoertype, zodat een vergeten select in tsc faalt en niet stil overal 'gehost' toont.
  • app/(app)/chat/layout.tsx selecteert facts.origin, en hosted volgt uit isHostedOrigin.
  • getAgentChatView zoekt de HARNESS-rij van de chatconfiguratie zonder active-filter en geeft origin terug. app/(app)/chat/[id]/page.tsx gebruikt isHostedOrigin(view.origin).
  • Een configuratie zonder facts-rij geldt als gehost.
  • Na deze PR verwijst niets buiten vendor/ en docs/ meer naar isHostedHarnessConfiguration of HARNESS_LOCAL_CONFIGURATIONS. Shared haalt ze weg in S4-T1.
  • Tests:
    • __tests__/lib/agent-chat-model-options.test.ts;
    • __tests__/lib/agent-chat-view.test.ts met de cases LOCAL, REMOTE, geen rij, facts null en de inactieve LOCAL-rij, plus een assert op de exacte where.

Verificatie

  • Lokaal:
    • npm run verify groen: 5622 tests, 0 lint-errors;
    • npm run build groen met de dummy-env van de CI-stap;
    • docs:check-links groen.
  • CI op c929d4b is groen:
    • Lint, Typecheck, Test & Build;
    • Queue Dispatch Guard Gate (test:dispatch en test:dispatch:chain);
    • DB Access Policy Gate;
    • DB Access Production Sentinel.

Uitrol

Deze PR deployt niets. JP rolt uit in T-279, in deze volgorde:

  1. update_scrum4me_web, met Approve Policy Hash;
  2. de wrapper-precheck;
  3. pas daarna workers.

🤖 Generated with Claude Code

IDEA-269 S2: sprint S-2026-10-20-1, story ST-084, taken T-272 en T-273. De spec staat in agent-harness `docs/specs/2026-10-20-idea-269-model-registry-origin-design.md` rev 4, §4.3 en §4.4; die spec staat nog op branch `claude/remote-lokale-modellen-e5a55a`. ## T-272: migratie, additief contract en tests - **Shared-bump** naar `d07f8b62`, de merge van scrum4me-shared PR #86. `prisma/schema.prisma` krijgt alleen `ModelOrigin`, `AgentModelFacts` en de back-relation `facts`. - **Migratie `20261020140000_agent_model_facts`:** - de enum, de tabel en de FK met `ON DELETE/UPDATE CASCADE` naar `agent_models`; - een backfill: elke HARNESS-rij krijgt een facts-rij. gsq-lokaal wordt LOCAL met `ollama/qwen3.8-gsq-rco:27b-iq3_s-text`, `iq3_s` en 65536; de rest wordt REMOTE; - geen GRANT, REVOKE of `ALTER TABLE "agent_models"`. - **Contract `public.table.agent_model_facts`** (additief, achteraan `contracts`): - web en preparedWeb: CRUD; - observer: SELECT, voor de read-only driftcheck; - queue, dispatch en projector: niets; - geen `publicPrivileges`. - **Tests**, naar het precedent van product_access_steps: - `__tests__/db/agent-model-facts-migration.test.ts`. `pinnedTableViolations` vangt nu ook `INSERT INTO`, `UPDATE` en `DELETE FROM` op een vastgepinde tabel. Zo is aantoonbaar dat de backfill uit `agent_models` alleen leest; - `__tests__/lib/db-access/agent-model-facts-contract.test.ts`: het contract is additief, en de gesloten set hasht nog naar de pin. - **Docs:** `docs/architecture/data-model.md` krijgt een sectie `agent_model_facts` en een rij `ModelOrigin` in de enum-tabel. **Backfill met de hand gecontroleerd:** CI draait de backfill tegen een lege `agent_models`. De kolomlijst en de WHEN-takken zijn daarom met de hand tegen spec §4.3 gecontroleerd, en de migratietest pint het statement letterlijk. De productiecontrole is S4-T3, stap 3. ## T-273: chat-label 'gehost' uit de registry - Nieuw `lib/agent-chat/model-options.ts` met `toChatModelOptions`. `facts` is verplicht in het invoertype, zodat een vergeten select in tsc faalt en niet stil overal 'gehost' toont. - `app/(app)/chat/layout.tsx` selecteert `facts.origin`, en `hosted` volgt uit `isHostedOrigin`. - `getAgentChatView` zoekt de HARNESS-rij van de chatconfiguratie zonder active-filter en geeft `origin` terug. `app/(app)/chat/[id]/page.tsx` gebruikt `isHostedOrigin(view.origin)`. - Een configuratie zonder facts-rij geldt als gehost. - Na deze PR verwijst niets buiten `vendor/` en `docs/` meer naar `isHostedHarnessConfiguration` of `HARNESS_LOCAL_CONFIGURATIONS`. Shared haalt ze weg in S4-T1. - Tests: - `__tests__/lib/agent-chat-model-options.test.ts`; - `__tests__/lib/agent-chat-view.test.ts` met de cases LOCAL, REMOTE, geen rij, facts null en de inactieve LOCAL-rij, plus een assert op de exacte `where`. ## Verificatie - Lokaal: - `npm run verify` groen: 5622 tests, 0 lint-errors; - `npm run build` groen met de dummy-env van de CI-stap; - `docs:check-links` groen. - CI op `c929d4b` is groen: - Lint, Typecheck, Test & Build; - Queue Dispatch Guard Gate (`test:dispatch` en `test:dispatch:chain`); - DB Access Policy Gate; - DB Access Production Sentinel. ## Uitrol Deze PR deployt niets. JP rolt uit in T-279, in deze volgorde: 1. `update_scrum4me_web`, met Approve Policy Hash; 2. de wrapper-precheck; 3. pas daarna workers. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
feat(db): agent_model_facts met additief contract en backfill (IDEA-269 S2)
Some checks failed
CI / Queue Dispatch Guard Gate (pull_request) Successful in 1m59s
CI / DB Access Policy Gate (pull_request) Successful in 2m6s
CI / DB Access Production Sentinel (pull_request) Successful in 38s
CI / Lint, Typecheck, Test & Build (pull_request) Has been cancelled
cd121a7194
Shared-bump naar d07f8b62 (scrum4me-shared PR #86): enum ModelOrigin en model
AgentModelFacts. De migratie maakt de enum en de 1:1-tabel agent_model_facts met
FK en cascade naar agent_models, en backfillt elke HARNESS-rij (gsq-lokaal
LOCAL, de rest REMOTE). agent_models blijft ongewijzigd: het is een gesloten
object van de IDEA-213-adoptie. De rechten komen uit het additieve contract
public.table.agent_model_facts (web/preparedWeb CRUD, observer SELECT voor de
read-only driftcheck). De migratietest controleert nu ook dat er geen
INSERT/UPDATE/DELETE op een vastgepinde tabel staat.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
feat(chat): 'gehost' uit agent_model_facts.origin (IDEA-269 S2)
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m40s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 2m14s
CI / DB Access Production Sentinel (pull_request) Successful in 57s
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 7m33s
c929d4b95d
De chat-modelkiezer en het chatvenster bepalen 'gehost' nu uit de facts-rij van
de configuratie (isHostedOrigin), niet meer uit de codelijst
HARNESS_LOCAL_CONFIGURATIONS. Zonder facts-rij geldt een configuratie als
gehost. getAgentChatView zoekt de registry-rij zonder active-filter, zodat een
chat met een inmiddels inactieve configuratie zijn herkomst houdt.
toChatModelOptions eist facts in de invoer, zodat een vergeten select in tsc
faalt in plaats van stil overal 'gehost' te tonen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
janpeter changed title from WIP: feat(db,chat): agent_model_facts met additief contract, chat-label uit de registry (IDEA-269 S2) to feat(db,chat): agent_model_facts met additief contract, chat-label uit de registry (IDEA-269 S2) 2026-10-20 16:14:18 +02:00
s4m-codex-reviewer left a comment

APPROVED

Geen blokkerende bevindingen in codekwaliteit, architectuur/patronen, tests of documentatie.

Findings

  • INFO — prisma/migrations/20261020140000_agent_model_facts/migration.sql:1: de automatisch gekoppelde TaskDialog-plannen (ST-1122/ST-1123) betreffen ander werk dan IDEA-269. Dit is een mismatch in de plankoppeling, geen ontbrekende implementatie in deze PR.

Plan-conformiteit

plan gekoppeld via pr_refs; references: T-272, T-273, T-279. omitted is leeg. De payload resolveert deze codes naar Scrum4Me-stories; de PR beschrijft werk onder scrum4me-workers. Daarom ook de daadwerkelijk genoemde specificatie gelezen: agent-harness docs/specs/2026-10-20-idea-269-model-registry-origin-design.md, revisie 4, op commit e7d95bc6bfac8bba9503a0d7b7d9046a6682738e.

De diff voldoet aan §4.3–4.4: additieve tabel en contract zonder wijziging van gesloten tabellen, voorgeschreven HARNESS-backfill, gedeelde herkomsthelper en correcte chatqueries inclusief inactieve configuraties en ontbrekende facts. Schema, tests en data-modeldocumentatie zijn bijgewerkt. Workers-UI, driftcheck, verwijdering van de oude shared-helper en productie-uitrol vallen buiten de afgeronde scope van deze PR.

Verificatie

Beoordeeld op c929d4b95d; actuele PR-head gecontroleerd.

  • Lokaal: 39 gerichte tests groen; typecheck groen met 4 GB Node-heap; lint 0 errors (8 waarschuwingen buiten de diff); schemageneratie zonder afwijking; documentlinks groen.
  • Volledige suite: 5621 geslaagd, 38 overgeslagen, één fout in de ongewijzigde VAPID-test door geërfde VAPID-omgevingsvariabelen. Afzonderlijke herhaling zonder deze variabelen: alle 4 tests groen. Geen lokale live-DB-verificatie uitgevoerd.
  • Forgejo bevestigt vier groene CI-statussen op dezelfde head: Lint/Typecheck/Test/Build, Queue Dispatch Guard Gate, DB Access Policy Gate en DB Access Production Sentinel.
# APPROVED Geen blokkerende bevindingen in codekwaliteit, architectuur/patronen, tests of documentatie. ## Findings - **INFO — prisma/migrations/20261020140000_agent_model_facts/migration.sql:1:** de automatisch gekoppelde TaskDialog-plannen (ST-1122/ST-1123) betreffen ander werk dan IDEA-269. Dit is een mismatch in de plankoppeling, geen ontbrekende implementatie in deze PR. ## Plan-conformiteit plan gekoppeld via pr_refs; references: T-272, T-273, T-279. `omitted` is leeg. De payload resolveert deze codes naar Scrum4Me-stories; de PR beschrijft werk onder scrum4me-workers. Daarom ook de daadwerkelijk genoemde specificatie gelezen: agent-harness `docs/specs/2026-10-20-idea-269-model-registry-origin-design.md`, revisie 4, op commit e7d95bc6bfac8bba9503a0d7b7d9046a6682738e. De diff voldoet aan §4.3–4.4: additieve tabel en contract zonder wijziging van gesloten tabellen, voorgeschreven HARNESS-backfill, gedeelde herkomsthelper en correcte chatqueries inclusief inactieve configuraties en ontbrekende facts. Schema, tests en data-modeldocumentatie zijn bijgewerkt. Workers-UI, driftcheck, verwijdering van de oude shared-helper en productie-uitrol vallen buiten de afgeronde scope van deze PR. ## Verificatie Beoordeeld op c929d4b95db7494333535f2469d5a43ffd05c5ff; actuele PR-head gecontroleerd. - Lokaal: 39 gerichte tests groen; typecheck groen met 4 GB Node-heap; lint 0 errors (8 waarschuwingen buiten de diff); schemageneratie zonder afwijking; documentlinks groen. - Volledige suite: 5621 geslaagd, 38 overgeslagen, één fout in de ongewijzigde VAPID-test door geërfde VAPID-omgevingsvariabelen. Afzonderlijke herhaling zonder deze variabelen: alle 4 tests groen. Geen lokale live-DB-verificatie uitgevoerd. - Forgejo bevestigt vier groene CI-statussen op dezelfde head: Lint/Typecheck/Test/Build, Queue Dispatch Guard Gate, DB Access Policy Gate en DB Access Production Sentinel.
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!406
No description provided.