fix(deploy-advice): tool-schema zonder maxItems (IDEA-275) #298

Merged
janpeter merged 1 commit from fix/deploy-advice-tool-schema into main 2026-10-22 08:31:41 +02:00
Owner

Wat

Op scrum4me-server faalde elke adviseur-call (ST-082 hostbewijs) met Claude API 400 … tools.0.custom: For 'array' type, property 'maxItems' is not supported (request_id req_011CgGjayi7A1jKv3JeYaNkw). Strikte tool-schema's accepteren alleen een JSON-schema-subset: geen maxItems, minLength, maxLength of numerieke constraints.

Wijziging

  • lib/deploy-advice/advisor.ts: maxItems (add_flags, warnings), minLength/maxLength (code, text, summary) uit ADVICE_TOOL.input_schema verwijderd. De grenzen staan nu als description voor het model; parseDeployAdvice dwingt ze al af (MAX_WARNINGS, MAX_WARNING_TEXT, MAX_SUMMARY_TEXT). enum, required en additionalProperties: false blijven.
  • test/deploy-advice-advisor.test.ts: test die het schema recursief controleert op niet-ondersteunde keywords.

Verificatie

  • vitest run test/deploy-advice-advisor.test.ts test/deploy-advice-advise-route.test.ts: 24 passed
  • npm run typecheck: 0 fouten

Daarna (apart, JP)

update_ops_dashboard op scrum4me-server en één nieuwe Plan + advies op /flows/deploy-scrum4me voor het advies-bewijs; resultaat in de bewijstabel van docs/runbooks/deploy-scrum4me.md.

🤖 Generated with Claude Code

## Wat Op scrum4me-server faalde elke adviseur-call (ST-082 hostbewijs) met `Claude API 400 … tools.0.custom: For 'array' type, property 'maxItems' is not supported` (request_id `req_011CgGjayi7A1jKv3JeYaNkw`). Strikte tool-schema's accepteren alleen een JSON-schema-subset: geen `maxItems`, `minLength`, `maxLength` of numerieke constraints. ## Wijziging - `lib/deploy-advice/advisor.ts`: `maxItems` (add_flags, warnings), `minLength`/`maxLength` (code, text, summary) uit `ADVICE_TOOL.input_schema` verwijderd. De grenzen staan nu als `description` voor het model; `parseDeployAdvice` dwingt ze al af (`MAX_WARNINGS`, `MAX_WARNING_TEXT`, `MAX_SUMMARY_TEXT`). `enum`, `required` en `additionalProperties: false` blijven. - `test/deploy-advice-advisor.test.ts`: test die het schema recursief controleert op niet-ondersteunde keywords. ## Verificatie - `vitest run test/deploy-advice-advisor.test.ts test/deploy-advice-advise-route.test.ts`: 24 passed - `npm run typecheck`: 0 fouten ## Daarna (apart, JP) `update_ops_dashboard` op scrum4me-server en één nieuwe Plan + advies op `/flows/deploy-scrum4me` voor het advies-bewijs; resultaat in de bewijstabel van `docs/runbooks/deploy-scrum4me.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
fix(deploy-advice): tool-schema zonder maxItems (IDEA-275)
All checks were successful
CI / Select checks (pull_request) Successful in 29s
CI / Ops-agent checks (pull_request) Successful in 38s
CI / Deploy artifact checks (pull_request) Successful in 42s
CI / DB access operator (pull_request) Successful in 1m32s
CI / Docker image build (pull_request) Successful in 1m34s
CI / Root app checks (pull_request) Successful in 5m59s
CI / Mac foundation hermetic checks (pull_request) Successful in 4m5s
CI / Required checks (pull_request) Successful in 29s
e16330cbf0
De Claude API weigert array-/string-constraints in strikte tool-schema's:
op de host faalde elke adviseur-call met 400 "tools.0.custom: For 'array'
type, property 'maxItems' is not supported" (req_011CgGjayi7A1jKv3JeYaNkw).
maxItems, minLength en maxLength zijn uit ADVICE_TOOL.input_schema gehaald;
de grenzen staan nu als description voor het model en blijven afgedwongen
door parseDeployAdvice (MAX_WARNINGS, MAX_WARNING_TEXT, MAX_SUMMARY_TEXT).
Een test bewaakt dat het schema geen niet-ondersteunde keywords bevat.

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

APPROVED

Findings:

  • Geen findings gevonden in de beoordeelde diff.

De schemafix is beperkt en behoudt de runtimevalidatie in parseDeployAdvice: maximaal 12 waarschuwingen, tekstlengtes, geldige vlaggen en deduplicatie. De aanpak past bij de IDEA-275-specificatie en de Anthropic-documentatie over schemabeperkingen. Geen aanvullende productdocumentatie nodig voor deze gerichte bugfix.

plan gekoppeld via pr_refs; references: ST-082. De PR herstelt de schemafout die het hostbewijs verhindert en claimt niet de gehele story af te ronden. Uitrol, nieuwe hostrun en runbook-bewijs blijven conform de PR-beschrijving vervolgwerk; dat blokkeert deze fix niet. Er zijn geen onderdelen weggelaten (omitted leeg).

Verificatie op commit e16330cbf0d661313555100a57a201b00edda721: 24/24 tests geslaagd (deploy-advice-advisor en deploy-advice-advise-route); npm run typecheck geslaagd na initialisatie van submodules, dependencies en Prisma-client. Geen live Claude-aanroep of hostdeploy uitgevoerd.

# APPROVED Findings: - Geen findings gevonden in de beoordeelde diff. De schemafix is beperkt en behoudt de runtimevalidatie in `parseDeployAdvice`: maximaal 12 waarschuwingen, tekstlengtes, geldige vlaggen en deduplicatie. De aanpak past bij de IDEA-275-specificatie en de [Anthropic-documentatie over schemabeperkingen](https://platform.claude.com/docs/en/build-with-claude/structured-outputs#json-schema-limitations). Geen aanvullende productdocumentatie nodig voor deze gerichte bugfix. plan gekoppeld via pr_refs; references: ST-082. De PR herstelt de schemafout die het hostbewijs verhindert en claimt niet de gehele story af te ronden. Uitrol, nieuwe hostrun en runbook-bewijs blijven conform de PR-beschrijving vervolgwerk; dat blokkeert deze fix niet. Er zijn geen onderdelen weggelaten (omitted leeg). Verificatie op commit `e16330cbf0d661313555100a57a201b00edda721`: 24/24 tests geslaagd (`deploy-advice-advisor` en `deploy-advice-advise-route`); `npm run typecheck` geslaagd na initialisatie van submodules, dependencies en Prisma-client. Geen live Claude-aanroep of hostdeploy uitgevoerd.
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/Ops-dashboard!298
No description provided.