M45-2c: HARNESS in web (idee-chat via de productkeuze, herstartweigering, jobs-lijst met configuratie en bedrag) #321

Merged
janpeter merged 7 commits from feat/m45-2c-harness-web into main 2026-10-07 08:12:49 +02:00
Owner

M45-2c — HARNESS in web: idee-chat via de productkeuze, herstartweigering, jobs-lijst met configuratie en bedrag

Web kent runtime HARNESS (de agent-harness met een LiteLLM-configuratie) in de routering en de jobs-lijst. Er ontstaat nog geen enkele HARNESS-rij: de eerste keuzes en configuraties komen pas in M45-2e (cutover). Zonder keuze verandert er niets.

  • Plan: docs/plans/M45-2c-harness-workers-web.md (commit 45f1ce18f416879b9419c018f65172b391b49f0c, branch docs/harness-runtime-spec; ook in de productdocs als PLANS m45-2c-harness-workers-web), Taak 6–9. Spec: docs/superpowers/specs/2026-10-05-harness-runtime-design.md rev 9 (§5.2, §5.3, §5.7, §6.2, §7.2 stap 5).
  • Scrum4Me: sprint S-2026-10-07-m45-2c, PBI-187, ST-1639, taken T-2045..T-2048. De workers-helft staat in janpeter/scrum4me-workers#140.

Wat verandert

  1. Idee-chat (T-2045): sendIdeaChatMessage leest de keuze in dezelfde transactie als het bericht. Dat gebeurt na de coalescing-guard en vóór de create, onder dezelfde lock en voor hetzelfde product (product_harness_choices, IDEA_CHAT).
    • Met keuze: runtime: 'HARNESS', requested_model: <configuratie>. Er komt nooit een required_capability bij, ook niet als het product op IDEA_CHAT_LOCAL_PRODUCT_IDS staat, en ook geen source.
    • Zonder keuze: het create-object is exact als voorheen. De vier exacte vormtests zijn letterlijk ongewijzigd.
    • Een leesfout gaat omhoog: de transactie rolt terug, het bericht inbegrepen. Een leesfout wordt nooit als "geen keuze" behandeld.
    • Precheck van de idee-pijplijn: countActiveWorkers telt alleen workers met runtime ≠ HARNESS (spec §5.3), want een HARNESS-worker claimt geen grill-, plan-, spec- of reviewjob.
  2. Herstart (T-2046): restartClaudeJobAction weigert elke job met runtime HARNESS of capability local_llm, met code 422.
    • Dat geldt in elke status en ook bij een idee-chat. De weigering staat direct na de weigering van beheerde jobs.
    • De tekst is byte-gelijk aan die van workers.
    • Een andere capability (bijvoorbeeld een Codex-reviewjob met review) blijft herstartbaar; dat is gepind.
  3. Jobs-lijst (T-2047):
    • Prijskaart zonder stille terugval: CLAUDE → anthropic/USD_PROXY, CODEX → openai/CREDITS, en elke andere runtime krijgt geen prijskaart.
    • Volgorde van computeUsageEstimate: HARNESS → n.v.t. (HARNESS), dan geen tokens, dan een runtime zonder prijskaart → Ongeprijsd, dan CLAUDE/CODEX zoals voorheen. Een vergelijking van oude en nieuwe code geeft 0 verschillen voor CLAUDE, CODEX en een ontbrekende runtime.
    • Cost-report in de query: JOB_INCLUDE krijgt cost_report. JobWithRelations krijgt requestedModel en costReport, met amountUsd = Decimal.toFixed(6) als string, nooit als float.
    • Weergave:
      • Alleen een HARNESS-job krijgt op de kaart de badge HARNESS · <configuratie> · $<bedrag>. Beide aanroepers geven de props door, en een kaart zonder HARNESS is DOM-gelijk aan voorheen.
      • Het detailpaneel toont Runtime, Configuratie en Kosten.
      • De admintabel markeert een HARNESS-job niet meer als "mismatch".
    • Het bedrag van een al geladen job verschijnt na herladen (plan besluit 5).
  4. Docs (T-2048): de job-JSON in docs/api/rest-contract.md met requestedModel en costReport, de herstartweigering in docs/runbooks/auto-deploy-job.md, en "productkeuze gaat voor de env-lijst" in .env.example en docs/architecture/auth-and-sessions.md.

Rood eerst (constraint 9)

Elke nieuwe test is eerst rood gezien, met de bron uit de tabel van zijn taak. Pinnen die vooraf al groen waren, zijn rood gezien via een tijdelijke mutatie, die daarna is teruggedraaid. De bewijsbestanden staan lokaal bij de uitvoerder.

Taak Nieuwe tests Bron van het rood
T-2045 6 idee-chat + 5 precheck geen lezing en geen runtime; local_llm naast een keuze; een afgewezen lezing gaf geen fout; de runtimefilter in de precheck ontbrak; pinnen via mutaties (lezing vóór guard 1, runtime: 'CLAUDE' op het pad zonder keuze, plus 9 extra)
T-2046 28 weigergevallen + select + pinnen (+1 na review) FAILED/CANCELLED/SKIPPED werden herstart of kregen de oude idee-chattekst, de andere vier statussen gaven de statustekst; de select miste de velden; pinnen via runtime !== 'CLAUDE' en required_capability != null
T-2047 58 (+1 na review) de velden bestonden niet; een sleutel met anthropic voor HARNESS en onbekende runtimes; een anthropic-sleutel voor een HARNESS-prijsrij; geen badge en geen rijen; mismatch rood gemarkeerd; cost_report ontbrak in JOB_INCLUDE; pinnen via mutaties (stap 3 weg, CODEX op USD_PROXY, ?? 'CODEX', include zonder cost_report in de route)

Gates

  • npm run verify op de head: lint 0 fouten en 6 waarschuwingen (de baseline), typecheck schoon, vitest 394 bestanden + 3 overgeslagen en 4164 tests + 31 overgeslagen (baseline 1348f4d6: 393/4059). npm run build draait in CI.
  • Policy-hash ongewijzigd: package.json, package-lock.json, tsconfig.json, prisma/, vendor/ en scripts/db-access/ zijn onaangeroerd. De volledige hash-invoer is gemeten: DB_ACCESS_HASH_FILES plus de contract-migraties, 36 bestanden. De diff ae6483b2..head (uitgerold) en 1348f4d6..head is over die invoer leeg.

Uitrol (niet in deze PR)

  • Alleen op JP's go (T-2049), via update_scrum4me_web.
  • Web gaat vóór workers, vanwege de QR-migratie 20261006191000_login_pairing_session_duration, die met deze uitrol meegaat. Pas na de gate volgt workers.
  • Harde voorcontrole vóór de flow: de web-rol heeft SELECT op product_harness_choices en op job_cost_reports. Zonder die rechten faalt elk idee-chatbericht (de lezing zit in dezelfde transactie) en elke jobs-query (de include).
  • Na de uitrol volgt een praktijkproef zonder iets op te slaan.

Merge graag als merge-commit (JP).

🤖 Generated with Claude Code

## M45-2c — HARNESS in web: idee-chat via de productkeuze, herstartweigering, jobs-lijst met configuratie en bedrag Web kent runtime `HARNESS` (de agent-harness met een LiteLLM-configuratie) in de routering en de jobs-lijst. Er ontstaat nog **geen enkele `HARNESS`-rij**: de eerste keuzes en configuraties komen pas in M45-2e (cutover). Zonder keuze verandert er niets. - **Plan:** `docs/plans/M45-2c-harness-workers-web.md` (commit `45f1ce18f416879b9419c018f65172b391b49f0c`, branch `docs/harness-runtime-spec`; ook in de productdocs als PLANS `m45-2c-harness-workers-web`), Taak 6–9. Spec: `docs/superpowers/specs/2026-10-05-harness-runtime-design.md` rev 9 (§5.2, §5.3, §5.7, §6.2, §7.2 stap 5). - **Scrum4Me:** sprint S-2026-10-07-m45-2c, PBI-187, ST-1639, taken T-2045..T-2048. De workers-helft staat in janpeter/scrum4me-workers#140. ### Wat verandert 1. **Idee-chat (T-2045):** `sendIdeaChatMessage` leest de keuze in dezelfde transactie als het bericht. Dat gebeurt na de coalescing-guard en vóór de create, onder dezelfde lock en voor hetzelfde product (`product_harness_choices`, `IDEA_CHAT`). - **Met keuze:** `runtime: 'HARNESS'`, `requested_model: <configuratie>`. Er komt nooit een `required_capability` bij, ook niet als het product op `IDEA_CHAT_LOCAL_PRODUCT_IDS` staat, en ook geen `source`. - **Zonder keuze:** het create-object is exact als voorheen. De vier exacte vormtests zijn letterlijk ongewijzigd. - **Een leesfout gaat omhoog:** de transactie rolt terug, het bericht inbegrepen. Een leesfout wordt nooit als "geen keuze" behandeld. - **Precheck van de idee-pijplijn:** `countActiveWorkers` telt alleen workers met `runtime ≠ HARNESS` (spec §5.3), want een HARNESS-worker claimt geen grill-, plan-, spec- of reviewjob. 2. **Herstart (T-2046):** `restartClaudeJobAction` weigert elke job met runtime `HARNESS` of capability `local_llm`, met code 422. - Dat geldt in elke status en ook bij een idee-chat. De weigering staat direct na de weigering van beheerde jobs. - De tekst is byte-gelijk aan die van workers. - Een andere capability (bijvoorbeeld een Codex-reviewjob met `review`) blijft herstartbaar; dat is gepind. 3. **Jobs-lijst (T-2047):** - **Prijskaart zonder stille terugval:** CLAUDE → anthropic/USD_PROXY, CODEX → openai/CREDITS, en elke andere runtime krijgt geen prijskaart. - **Volgorde van `computeUsageEstimate`:** HARNESS → `n.v.t. (HARNESS)`, dan geen tokens, dan een runtime zonder prijskaart → `Ongeprijsd`, dan CLAUDE/CODEX zoals voorheen. Een vergelijking van oude en nieuwe code geeft 0 verschillen voor CLAUDE, CODEX en een ontbrekende runtime. - **Cost-report in de query:** `JOB_INCLUDE` krijgt `cost_report`. `JobWithRelations` krijgt `requestedModel` en `costReport`, met `amountUsd` = `Decimal.toFixed(6)` als string, nooit als float. - **Weergave:** - Alleen een HARNESS-job krijgt op de kaart de badge `HARNESS · <configuratie> · $<bedrag>`. Beide aanroepers geven de props door, en een kaart zonder HARNESS is DOM-gelijk aan voorheen. - Het detailpaneel toont Runtime, Configuratie en Kosten. - De admintabel markeert een HARNESS-job niet meer als "mismatch". - Het bedrag van een al geladen job verschijnt na herladen (plan besluit 5). 4. **Docs (T-2048):** de job-JSON in `docs/api/rest-contract.md` met `requestedModel` en `costReport`, de herstartweigering in `docs/runbooks/auto-deploy-job.md`, en "productkeuze gaat voor de env-lijst" in `.env.example` en `docs/architecture/auth-and-sessions.md`. ### Rood eerst (constraint 9) Elke nieuwe test is eerst rood gezien, met de bron uit de tabel van zijn taak. Pinnen die vooraf al groen waren, zijn rood gezien via een tijdelijke mutatie, die daarna is teruggedraaid. De bewijsbestanden staan lokaal bij de uitvoerder. | Taak | Nieuwe tests | Bron van het rood | |---|---|---| | T-2045 | 6 idee-chat + 5 precheck | geen lezing en geen runtime; `local_llm` naast een keuze; een afgewezen lezing gaf geen fout; de runtimefilter in de precheck ontbrak; pinnen via mutaties (lezing vóór guard 1, `runtime: 'CLAUDE'` op het pad zonder keuze, plus 9 extra) | | T-2046 | 28 weigergevallen + select + pinnen (+1 na review) | `FAILED`/`CANCELLED`/`SKIPPED` werden herstart of kregen de oude idee-chattekst, de andere vier statussen gaven de statustekst; de select miste de velden; pinnen via `runtime !== 'CLAUDE'` en `required_capability != null` | | T-2047 | 58 (+1 na review) | de velden bestonden niet; een sleutel met `anthropic` voor HARNESS en onbekende runtimes; een `anthropic`-sleutel voor een HARNESS-prijsrij; geen badge en geen rijen; mismatch rood gemarkeerd; `cost_report` ontbrak in `JOB_INCLUDE`; pinnen via mutaties (stap 3 weg, CODEX op USD_PROXY, `?? 'CODEX'`, include zonder `cost_report` in de route) | ### Gates - `npm run verify` op de head: lint 0 fouten en 6 waarschuwingen (de baseline), typecheck schoon, vitest 394 bestanden + 3 overgeslagen en 4164 tests + 31 overgeslagen (baseline `1348f4d6`: 393/4059). `npm run build` draait in CI. - **Policy-hash ongewijzigd:** `package.json`, `package-lock.json`, `tsconfig.json`, `prisma/`, `vendor/` en `scripts/db-access/` zijn onaangeroerd. De volledige hash-invoer is gemeten: `DB_ACCESS_HASH_FILES` plus de contract-migraties, 36 bestanden. De diff `ae6483b2..head` (uitgerold) en `1348f4d6..head` is over die invoer leeg. ### Uitrol (niet in deze PR) - Alleen op JP's go (T-2049), via `update_scrum4me_web`. - **Web gaat vóór workers**, vanwege de QR-migratie `20261006191000_login_pairing_session_duration`, die met deze uitrol meegaat. Pas na de gate volgt workers. - **Harde voorcontrole vóór de flow:** de web-rol heeft `SELECT` op `product_harness_choices` en op `job_cost_reports`. Zonder die rechten faalt elk idee-chatbericht (de lezing zit in dezelfde transactie) en elke jobs-query (de include). - Na de uitrol volgt een praktijkproef zonder iets op te slaan. Merge graag als **merge-commit** (JP). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
sendIdeaChatMessage leest in dezelfde transactie, onder dezelfde lock en voor
hetzelfde product als de create de keuze voor (product, IDEA_CHAT), na de guards
voor "geen product" en "lopende beurt". Met keuze krijgt de job runtime HARNESS
en de configuratie als requested_model, zonder required_capability (ook als het
product op IDEA_CHAT_LOCAL_PRODUCT_IDS staat) en zonder source; zonder keuze
blijft het create-object zoals vóór M45. Een leesfout wordt niet afgevangen: de
transactie rolt terug, bericht inbegrepen, en de actie faalt.

countActiveWorkers (de precheck van de idee-pijplijn) telt alleen workers met
runtime niet HARNESS: een HARNESS-worker claimt geen IDEA_GRILL, IDEA_MAKE_PLAN,
IDEA_MAKE_SPEC of IDEA_REVIEW_PLAN. Melding en code 422 blijven gelijk.

Tests: zes nieuwe gevallen voor de idee-chat en een tabel over de vijf ingangen
van de precheck. De bestaande tests zijn letterlijk ongewijzigd (alleen txMocks
en beforeEach van idea-chat.test.ts kregen de stub voor de lezing).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewbevinding: zonder die zin leest de afwijking van web-enqueue-no-freeze
als regressie. Alleen commentaar.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
restartClaudeJobAction selecteert nu ook runtime en required_capability. Direct
na de weigering van beheerde jobs, vóór DEPLOY, DOCS_AUDIT, de statuscontrole en
de IDEA_CHAT-weigering, geeft runtime HARNESS of required_capability local_llm
{ error, code: 422 } met dezelfde tekst als de workers-app (niet-geëxporteerde
constante HARNESS_RESTART_REFUSED: het bestand is 'use server'). Een herstart
zet zo'n job terug met de oude runtime, buiten de actuele keuze van het product
om; opnieuw dispatchen leest die keuze.

Tests: een tabel over de zeven statussen, taak en idee-chat, beide markeringen
(28 gevallen), de select met beide velden, en twee pinnen: een gewone job wordt
nog herstart en de bestaande IDEA_CHAT-tekst blijft exact gelijk. De bestaande
tests zijn ongewijzigd.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewbevinding: een te brede voorwaarde (`required_capability != null`)
overleefde de pinnen en zou echte reviewjobs blokkeren. Rood gezien via die
mutatie (T-2046-ctrl-mutation-capability-broad.txt).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
jobs-mapper: alleen CLAUDE (anthropic, USD_PROXY) en CODEX (openai, CREDITS)
hebben een prijskaart (rateCardForRuntime vervangt providerForRuntime en
billingUnitForRuntime). Elke andere runtime krijgt geen prijssleutel, geen
eenheid en geen bedrag: priceKeyForRuntimeModel geeft null en buildPriceMap
maakt geen sleutel voor een rij zonder prijskaart en zonder eigen provider of
eenheid. computeUsageEstimate volgt de volgorde HARNESS ('n.v.t. (HARNESS)',
nieuw lid not_applicable), geen tokens, runtime zonder prijskaart (Ongeprijsd,
vóór de sleutelopzoeking), daarna CLAUDE en CODEX zoals voorheen; een prijsrij
zonder eenheid voor een runtime zonder prijskaart geeft expliciet Ongeprijsd.
De ?? 'CLAUDE'-standaard voor een ontbrekende runtime blijft; een aanwezige
waarde gaat ongewijzigd door.

JobWithRelations krijgt requestedModel en costReport (amountUsd is toFixed(6)
op de Decimal: een decimale string, nooit een Decimal of float over de
RSC-grens). JOB_INCLUDE haalt cost_report mee (de callers casten naar RawJob,
dus tsc ziet een vergeten include niet; gepind). formatReportedCost geeft 'nog
niet gemeld', 'onbekend · bron <bron>' of '$<bedrag> · bron <bron>' met
' · aanbieder <aanbieder>'.

UI: de kaart toont bij runtime HARNESS een tweede badge 'HARNESS ·
<configuratie> · $<bedrag>' (beide aanroepers geven de props door; zonder
HARNESS blijft de DOM gelijk), het detailpaneel (desktop en mobiel) de rijen
Runtime, Configuratie en Kosten, en de admintabel markeert bij HARNESS geen
mismatch tussen requested_model (de configuratie) en model_id.

Tests: 58 nieuwe tests, elk eerst rood met de bron uit de rubriek
(T-2047-red-*.txt); de pinnen 3a, 5 en 11 rood via een tijdelijke mutatie
(T-2047-mutation-*.txt). De fixtures krijgen alleen de stubs requestedModel:
null en costReport: null.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reviewbevindingen: een configuratienaam van 64 tekens liep in een smalle kaart
over de rand (wrapper nu min-w-0 break-all; badgeklassen gelijk aan de
soortbadge); en dat de route include: JOB_INCLUDE gebruikt stond in geen test
(rood gezien via een include zonder cost_report).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs(M45-2c): job-JSON met requestedModel en costReport; herstartweigering HARNESS/local_llm; productkeuze gaat voor de env-lijst (T-2048)
All checks were successful
CI / DB Access Policy Gate (pull_request) Successful in 1m53s
CI / Queue Dispatch Guard Gate (pull_request) Successful in 1m46s
CI / DB Access Production Sentinel (pull_request) Successful in 1m13s
CI / Deploy Manual (workflow_dispatch) (pull_request) Has been skipped
CI / Lint, Typecheck, Test & Build (pull_request) Successful in 9m17s
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
102979e3b6
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer left a comment

COMMENT

Geen blokkerende codebevindingen gevonden. Geen APPROVED zolang de vereiste verificatie voor deze head niet bevestigd is.

Findings

  • WARNING — .github/workflows/ci.yml:80: lint/typecheck/tests/build zijn in CI nog pending op 102979e3b6e404202d94f58d3ed47236981d1c2b; ook Production Sentinel is nog niet afgerond. DB Access Policy Gate en Queue Dispatch Guard Gate zijn groen. Lokaal faalde PUPPETEER_SKIP_DOWNLOAD=1 npm ci bij esbuild met EACCES door de noexec-mount op /tmp, zodat ik npm run verify en de build niet kon uitvoeren. Verificatiebeperking, geen bewezen codefout.

Plan en inhoudelijke beoordeling

plan gekoppeld via pbi — M45-2c, PBI-187 / ST-1639, webtaken 6–9. Getoetst aan het meegeleverde plan en productdocs (HARNESS-spec rev 9, Server Action en MD3-styling). Geen references- of omitted-velden meegeleverd.

De diff volgt de webcontracten: keuzelezing onder de bestaande idee-lock en in dezelfde transactie; voorrang boven de env-lijst zonder required_capability; leesfouten worden doorgegeven; HARNESS-workers tellen niet mee in de pipeline-precheck. De herstartweigering staat vóór de bestaande soort/statuscontroles. De jobs-query neemt cost_report mee, kosten blijven exacte decimale strings en HARNESS krijgt geen vreemde prijskaart of model-mismatch.

De toegevoegde regressietests dekken routering, fouten, guards, alle herstartstatussen, kostenbronnen en desktop/mobiele bedrading. De relevante docs zijn bijgewerkt; schema, shared en dependency/configbestanden zijn onaangeroerd. Workers-taken 1–5 en uitroltaak 10 zijn expliciet buiten deze PR en vormen geen ontbrekende oplevering hier. De PR noemt de vereiste SELECT-rechten als uitrolvoorcontrole.

# COMMENT Geen blokkerende codebevindingen gevonden. Geen APPROVED zolang de vereiste verificatie voor deze head niet bevestigd is. ## Findings - **WARNING — .github/workflows/ci.yml:80:** lint/typecheck/tests/build zijn in CI nog `pending` op `102979e3b6e404202d94f58d3ed47236981d1c2b`; ook Production Sentinel is nog niet afgerond. DB Access Policy Gate en Queue Dispatch Guard Gate zijn groen. Lokaal faalde `PUPPETEER_SKIP_DOWNLOAD=1 npm ci` bij esbuild met `EACCES` door de `noexec`-mount op `/tmp`, zodat ik `npm run verify` en de build niet kon uitvoeren. Verificatiebeperking, geen bewezen codefout. ## Plan en inhoudelijke beoordeling plan gekoppeld via pbi — M45-2c, PBI-187 / ST-1639, webtaken 6–9. Getoetst aan het meegeleverde plan en productdocs (HARNESS-spec rev 9, Server Action en MD3-styling). Geen references- of omitted-velden meegeleverd. De diff volgt de webcontracten: keuzelezing onder de bestaande idee-lock en in dezelfde transactie; voorrang boven de env-lijst zonder required_capability; leesfouten worden doorgegeven; HARNESS-workers tellen niet mee in de pipeline-precheck. De herstartweigering staat vóór de bestaande soort/statuscontroles. De jobs-query neemt cost_report mee, kosten blijven exacte decimale strings en HARNESS krijgt geen vreemde prijskaart of model-mismatch. De toegevoegde regressietests dekken routering, fouten, guards, alle herstartstatussen, kostenbronnen en desktop/mobiele bedrading. De relevante docs zijn bijgewerkt; schema, shared en dependency/configbestanden zijn onaangeroerd. Workers-taken 1–5 en uitroltaak 10 zijn expliciet buiten deze PR en vormen geen ontbrekende oplevering hier. De PR noemt de vereiste SELECT-rechten als uitrolvoorcontrole.
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!321
No description provided.