feat(runtime): HARNESS als derde runtime — schema, harness-config en resolvertak met kostenplafond (M45-2a) #74
No reviewers
Labels
No labels
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/scrum4me-shared!74
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feat/m45-2a-harness"
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?
Aanleiding: M45 maakt de agent-harness (een LiteLLM-model) een derde runtime naast Claude en Codex. Deel 2a legt het fundament in shared en de server-DB; er komt nog geen enkele
HARNESS-rij. Plan:docs/plans/M45-2a-harness-fundament.md(Scrum4Me, Taak 1; dubbel GO in planronde 2), specdocs/superpowers/specs/2026-10-05-harness-runtime-design.md. Scrum4Me-taken T-2022 en T-2023 (ST-1635, PBI-183).Wat
AgentRuntimekrijgtHARNESS;ProductHarnessChoice, met sleutelproduct_id+kinden tabelproduct_harness_choices;JobCostReport, met sleuteljob_iden tabeljob_cost_reports;ProductenClaudeJob;// SQL:-commentaar. De SQL komt in de Scrum4Me-migratie;lib/agent-runtime.ts:AGENT_RUNTIMESbevatHARNESS;normalizeAgentRuntimevalt niet meer stil terug opCLAUDE. Een lege waarde blijftCLAUDE; een onbekende waarde gooitUNKNOWN_AGENT_RUNTIME, zonder de waarde in de melding.lib/harness-config.ts(nieuw):IDEA_CHATenTASK_IMPLEMENTATION;0.05voorIDEA_CHATen0.50voorTASK_IMPLEMENTATION;HARNESS_COST_SOURCES;parseMaxCostUsd: past inDecimal(10,4)en werkt met stringbewerkingen. Een number wordt op zijn waarde beoordeeld, een string alleen in gewone decimale notatie.lib/job-config.ts:resolveRuntimeJobConfigkrijgt eenHARNESS-tak bovenaan en een optionele zesde parameterharnessChoice. Dat is de rij die de aanroeper bij de claim leest; de resolver zelf leest geen DB.HARNESS_COST_LIMIT_INVALID(fail closed).HARNESS_CONFIGURATION_INVALID, een andere jobsoortHARNESS_KIND_UNSUPPORTED.UNKNOWN_AGENT_RUNTIME, vóór de managed-check. Zo krijgt zo'n runtime geen Claude-config en geenDISPATCH_JOB_CONFIG_UNSAFE, dat de MCP-adapter stil totnullmaakt.HARNESS(spec §5.7). Er zijn tests toegevoegd voorparseDispatchInputendispatchProfileConfigSchema;queue-dispatch*.tsis ongewijzigd.Gevolgen voor consumenten (bewust, niet in deze PR)
Wie shared bumpt, ziet het derde lid van
RuntimeJobConfig. Code die velden leest zonder eerst te vernauwen, geeft eentsc-fout. Dat is de bedoeling: elke consument moetHARNESSexpliciet afhandelen. Bekende plekken:src/dispatch/job-adapter.ts,src/lib/dispatch/snapshot.tsensrc/tools/wait-for-job.ts: deel 2b;bin/run-one-job.ts: deel 2d;Lockstep: elke Prisma-client regenereert vóór de eerste
HARNESS-rij. Die komt pas in 2e.Verificatie
npm run verifyis groen: 43 bestanden, 729 tests (baseline 41 en 606).agent-runtime: 5 tests falend;harness-schema: 9 tests falend op de asserties;job-config: 50 tests falend, plus 7 typefouten;queue-dispatchenCLAUDE/CODEX: rood gemaakt met een tijdelijke mutatie.harness-config: 38 van de 41 mutanten gedood; de 3 overlevers zijn equivalent;🤖 Generated with Claude Code
resolveRuntimeJobConfig krijgt een derde tak voor runtime HARNESS (spec §5.5) en een optionele zesde parameter harnessChoice: de rij uit product_harness_choices die de aanroeper bij de claim leest. De resolver leest zelf geen database. - HARNESS staat bovenaan en deelt niets met de Claude-/Codex-logica. De configuratienaam komt uit de job-snapshot (requested_model, gezet bij enqueue), het plafond uit de keuze bij de claim. Is die rij er niet meer, dan geldt de standaard per jobsoort; een bestaande rij met een onbruikbaar plafond gooit HARNESS_COST_LIMIT_INVALID in plaats van stil op de standaard terug te vallen (fail closed). Volgorde van de controles: jobsoort (HARNESS_KIND_UNSUPPORTED), configuratienaam (HARNESS_CONFIGURATION_INVALID), plafond. De uitkomst heeft bewust geen Claude-/Codex-velden. - Zonder keuze krijgt het plafond de constante ongewijzigd ('0.50' voor TASK_IMPLEMENTATION); met een keuze de genormaliseerde string van parseMaxCostUsd ('0.5'). - Direct na de HARNESS-tak gooit een onbekende of ontbrekende runtime UNKNOWN_AGENT_RUNTIME, vóór de managed-check. Zo valt een ongetypeerde aanroeper niet meer stil in de Claude-tak en krijgt hij ook niet DISPATCH_JOB_CONFIG_UNSAFE, dat de MCP-adapter stil tot null maakt. - Aanroepen met vijf argumenten en CLAUDE of CODEX gedragen zich ongewijzigd; de keuze heeft voor die runtimes geen effect. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>APPROVED
Findings
Plan gekoppeld via pr_refs (product Scrum4Me): T-2022, T-2023, ST-1635 en PBI-183. De supplied plan_doc voor PBI-183 is afgekapt; omitted is leeg. De volledige taakplannen voor T-2022 en T-2023 zijn beschikbaar en de diff voldoet aan die shared-scope. Migraties, DB-contracten, consumentaanpassingen en uitrol behoren tot vervolg-PR's; deze PR claimt die niet af te ronden.
De schemawijziging is additief. De bibliotheek blijft Prisma-vrij en gebruikt de bestaande ESM-importconventie. HARNESS heeft een afzonderlijke configuratievariant; ongeldige runtime, configuratie en kostenlimiet worden expliciet geweigerd. Managed dispatch blijft gesloten voor HARNESS. De tests dekken deze contracten, grenswaarden en behoud van CLAUDE/CODEX-gedrag. Schema- en codecommentaar documenteren de contracten en de migratieverantwoordelijkheid conform de productarchitectuur.
Verificatie op commit
44acdb49ede79190842c4980f6d713b07113abc9: de payload-diff komt exact overeen met de checkout; dependency-check, bijbehorende shelltests, typecheck en diff-check slagen lokaal. ForgejoCI / Verify (pull_request)staat op success voor deze SHA. De volledige lokale verify/test-run is beperkt door de noexec-mount van /tmp (tsc-launcher en native Rollup-module); lokaal testresultaat is daarom niet als geslaagd aangemerkt.