feat(runtime): HARNESS als derde runtime — schema, harness-config en resolvertak met kostenplafond (M45-2a) #74

Merged
janpeter merged 2 commits from feat/m45-2a-harness into main 2026-10-06 13:49:47 +02:00
Owner

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), spec docs/superpowers/specs/2026-10-05-harness-runtime-design.md. Scrum4Me-taken T-2022 en T-2023 (ST-1635, PBI-183).

Wat

  • Schema:
    • enum AgentRuntime krijgt HARNESS;
    • nieuw ProductHarnessChoice, met sleutel product_id + kind en tabel product_harness_choices;
    • nieuw JobCostReport, met sleutel job_id en tabel job_cost_reports;
    • virtuele back-relations op Product en ClaudeJob;
    • de CHECKs staan als // SQL:-commentaar. De SQL komt in de Scrum4Me-migratie;
    • geen bestaande kolom, default of index verandert (IDEA-213-adoptiepin).
  • lib/agent-runtime.ts:
    • AGENT_RUNTIMES bevat HARNESS;
    • normalizeAgentRuntime valt niet meer stil terug op CLAUDE. Een lege waarde blijft CLAUDE; een onbekende waarde gooit UNKNOWN_AGENT_RUNTIME, zonder de waarde in de melding.
  • lib/harness-config.ts (nieuw):
    • de jobsoorten IDEA_CHAT en TASK_IMPLEMENTATION;
    • de standaardplafonds, als decimale string: 0.05 voor IDEA_CHAT en 0.50 voor TASK_IMPLEMENTATION;
    • het patroon voor configuratienamen;
    • HARNESS_COST_SOURCES;
    • parseMaxCostUsd: past in Decimal(10,4) en werkt met stringbewerkingen. Een number wordt op zijn waarde beoordeeld, een string alleen in gewone decimale notatie.
  • lib/job-config.ts:
    • resolveRuntimeJobConfig krijgt een HARNESS-tak bovenaan en een optionele zesde parameter harnessChoice. Dat is de rij die de aanroeper bij de claim leest; de resolver zelf leest geen DB.
    • Zonder keuze geldt het standaardplafond. Een ongeldig plafond gooit HARNESS_COST_LIMIT_INVALID (fail closed).
    • Een ongeldige configuratienaam gooit HARNESS_CONFIGURATION_INVALID, een andere jobsoort HARNESS_KIND_UNSUPPORTED.
    • Daarna volgt een dichte guard: een onbekende of ontbrekende runtime gooit UNKNOWN_AGENT_RUNTIME, vóór de managed-check. Zo krijgt zo'n runtime geen Claude-config en geen DISPATCH_JOB_CONFIG_UNSAFE, dat de MCP-adapter stil tot null maakt.
  • Managed dispatch blijft gesloten voor HARNESS (spec §5.7). Er zijn tests toegevoegd voor parseDispatchInput en dispatchProfileConfigSchema; queue-dispatch*.ts is 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 een tsc-fout. Dat is de bedoeling: elke consument moet HARNESS expliciet afhandelen. Bekende plekken:

  • mcp src/dispatch/job-adapter.ts, src/lib/dispatch/snapshot.ts en src/tools/wait-for-job.ts: deel 2b;
  • docker bin/run-one-job.ts: deel 2d;
  • workers-mocks: deel 2c.

Lockstep: elke Prisma-client regenereert vóór de eerste HARNESS-rij. Die komt pas in 2e.

Verificatie

  • npm run verify is groen: 43 bestanden, 729 tests (baseline 41 en 606).
  • Elke nieuwe test is eerst rood gezien:
    • agent-runtime: 5 tests falend;
    • harness-schema: 9 tests falend op de asserties;
    • job-config: 50 tests falend, plus 7 typefouten;
    • de guards op queue-dispatch en CLAUDE/CODEX: rood gemaakt met een tijdelijke mutatie.
  • Mutatietests:
    • harness-config: 38 van de 41 mutanten gedood; de 3 overlevers zijn equivalent;
    • schema-test: 27 van de 27;
    • resolver: 28 van de 28.
  • Consument: de Scrum4Me-PR met de submodule-bump, de migraties en de additieve contracts volgt na de merge van deze PR. De submodule gaat dan naar de mergecommit.

🤖 Generated with Claude Code

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`](https://git.jp-visser.nl/janpeter/Scrum4Me/src/commit/2fbde2814d0ea7507d6c4cc1d86b75a17dcb4580/docs/plans/M45-2a-harness-fundament.md) (Scrum4Me, Taak 1; dubbel GO in planronde 2), spec `docs/superpowers/specs/2026-10-05-harness-runtime-design.md`. Scrum4Me-taken T-2022 en T-2023 (ST-1635, PBI-183). ## Wat - **Schema:** - enum `AgentRuntime` krijgt `HARNESS`; - nieuw `ProductHarnessChoice`, met sleutel `product_id` + `kind` en tabel `product_harness_choices`; - nieuw `JobCostReport`, met sleutel `job_id` en tabel `job_cost_reports`; - virtuele back-relations op `Product` en `ClaudeJob`; - de CHECKs staan als `// SQL:`-commentaar. De SQL komt in de Scrum4Me-migratie; - geen bestaande kolom, default of index verandert (IDEA-213-adoptiepin). - **`lib/agent-runtime.ts`:** - `AGENT_RUNTIMES` bevat `HARNESS`; - `normalizeAgentRuntime` valt niet meer stil terug op `CLAUDE`. Een lege waarde blijft `CLAUDE`; een onbekende waarde gooit `UNKNOWN_AGENT_RUNTIME`, zonder de waarde in de melding. - **`lib/harness-config.ts` (nieuw):** - de jobsoorten `IDEA_CHAT` en `TASK_IMPLEMENTATION`; - de standaardplafonds, als decimale string: `0.05` voor `IDEA_CHAT` en `0.50` voor `TASK_IMPLEMENTATION`; - het patroon voor configuratienamen; - `HARNESS_COST_SOURCES`; - `parseMaxCostUsd`: past in `Decimal(10,4)` en werkt met stringbewerkingen. Een number wordt op zijn waarde beoordeeld, een string alleen in gewone decimale notatie. - **`lib/job-config.ts`:** - `resolveRuntimeJobConfig` krijgt een `HARNESS`-tak bovenaan en een optionele zesde parameter `harnessChoice`. Dat is de rij die de aanroeper bij de claim leest; de resolver zelf leest geen DB. - Zonder keuze geldt het standaardplafond. Een ongeldig plafond gooit `HARNESS_COST_LIMIT_INVALID` (fail closed). - Een ongeldige configuratienaam gooit `HARNESS_CONFIGURATION_INVALID`, een andere jobsoort `HARNESS_KIND_UNSUPPORTED`. - Daarna volgt een dichte guard: een onbekende of ontbrekende runtime gooit `UNKNOWN_AGENT_RUNTIME`, vóór de managed-check. Zo krijgt zo'n runtime geen Claude-config en geen `DISPATCH_JOB_CONFIG_UNSAFE`, dat de MCP-adapter stil tot `null` maakt. - **Managed dispatch blijft gesloten voor `HARNESS` (spec §5.7).** Er zijn tests toegevoegd voor `parseDispatchInput` en `dispatchProfileConfigSchema`; `queue-dispatch*.ts` is 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 een `tsc`-fout. Dat is de bedoeling: elke consument moet `HARNESS` expliciet afhandelen. Bekende plekken: - mcp `src/dispatch/job-adapter.ts`, `src/lib/dispatch/snapshot.ts` en `src/tools/wait-for-job.ts`: deel 2b; - docker `bin/run-one-job.ts`: deel 2d; - workers-mocks: deel 2c. **Lockstep:** elke Prisma-client regenereert vóór de eerste `HARNESS`-rij. Die komt pas in 2e. ## Verificatie - `npm run verify` is groen: 43 bestanden, 729 tests (baseline 41 en 606). - Elke nieuwe test is eerst rood gezien: - `agent-runtime`: 5 tests falend; - `harness-schema`: 9 tests falend op de asserties; - `job-config`: 50 tests falend, plus 7 typefouten; - de guards op `queue-dispatch` en `CLAUDE`/`CODEX`: rood gemaakt met een tijdelijke mutatie. - Mutatietests: - `harness-config`: 38 van de 41 mutanten gedood; de 3 overlevers zijn equivalent; - schema-test: 27 van de 27; - resolver: 28 van de 28. - Consument: de Scrum4Me-PR met de submodule-bump, de migraties en de additieve contracts volgt na de merge van deze PR. De submodule gaat dan naar de mergecommit. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
HARNESS wordt een derde runtime naast CLAUDE en CODEX (M45, spec
docs/superpowers/specs/2026-10-05-harness-runtime-design.md in Scrum4Me).
Deze commit legt alleen het fundament in shared; de resolver in
job-config.ts volgt in een aparte commit op dezelfde branch.

- schema: enum AgentRuntime krijgt HARNESS. Nieuw zijn ProductHarnessChoice
  (keuze per product en jobsoort, sleutel product_id + kind) en
  JobCostReport (gemeld bedrag per HARNESS-job, één rij per job), met
  virtuele back-relations op Product en ClaudeJob. Geen bestaande kolom,
  default of index wijzigt (IDEA-213-adoptiepin). De CHECKs staan als
  `// SQL:`-commentaar; de SQL schrijft de migratie in Scrum4Me.
- cost_source is tekst met een CHECK in plaats van een enum: een nieuwe bron
  wordt dan één CHECK-wijziging en forceert geen Prisma-lockstep van alle
  clients.
- normalizeAgentRuntime valt niet langer stil terug op CLAUDE. Een lege
  waarde (undefined, null, '') blijft de gedocumenteerde standaard CLAUDE,
  een onbekende waarde gooit UNKNOWN_AGENT_RUNTIME (message = code, zonder de
  waarde: die kan uit een omgevingsvariabele komen). Zo wordt HARNESS niet
  per ongeluk een Claude-job.
- harness-config.ts: de jobsoorten, de standaardplafonds als decimale string
  ($0,05 IDEA_CHAT, $0,50 TASK_IMPLEMENTATION), het configuratienaam-patroon,
  de kostbronnen en parseMaxCostUsd. Die rekent met stringbewerkingen en niet
  met floats (Decimal(10,4), genormaliseerd of null) en trimt met lussen:
  een regex als /0+$/ loopt bij ongecontroleerde invoer kwadratisch terug.
- Managed dispatch blijft gesloten voor HARNESS (spec §5.7): tests voor
  parseDispatchInput en dispatchProfileConfigSchema; queue-dispatch*.ts is
  ongewijzigd.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
feat(job-config): resolvertak HARNESS met kostenplafond en dichte runtime-guard (M45-2a)
All checks were successful
CI / Verify (pull_request) Successful in 44s
44acdb49ed
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>
s4m-codex-reviewer left a comment

APPROVED

Findings

  • Geen 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. Forgejo CI / 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.

# APPROVED ## Findings - Geen 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. Forgejo `CI / 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.
Sign in to join this conversation.
No reviewers
No labels
severity/s4
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-shared!74
No description provided.