feat(deploy-advice): adviseur, DeployAdvice-model en advise/run-routes (ST-080, IDEA-275) #293
No reviewers
Labels
No labels
severity/s2
severity/s3
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/Ops-dashboard!293
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "claude/st080-deploy-advice-backend-b2b8db"
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?
IDEA-275 increment 2, story ST-080 (sprint S-2026-10-21-2, PBI-26). Dashboardkant van "Plan + advies → Deploy" voor
deploy_scrum4me: adviseur, opslag en de twee API-routes. Onafhankelijk van ST-079 (ops-agent): de tests mocken de agent; de routes roepen de command-keysscrum4me_deploy_advice_inputens4m_queue_notify_jpaan die ST-079 toevoegt. ST-081 (pagina + auditblok) bouwt op de responsvormen hieronder.T-214 — execAgentResult, adviseur en DeployAdvice-model (
99c2326e0)lib/agent-client.ts:execAgentResult(commandKey, args, { stdin?, timeoutMs? })→{ code, stdout, stderr }. Parseert de SSE van/agent/v1/execper event zoalsops-agent/src/routes/exec.tsdie uitzendt (stdout/stderrmet{ data },exitmet{ code },error→ throw);stdinalleen in de body als meegegeven;AbortSignal.timeout(timeoutMs ?? 60_000).execAgentongewijzigd.lib/deploy-advice/types.ts:FLAG_NAMES = ['web','worker_fleet','codex','workers'](bewust zondermcp_pin),AdviceInput,DeployAdviceOutput,AdviceResult, limieten 12 warnings / 400 / 600 tekens.lib/deploy-advice/advisor.ts(server-only):claude-haiku-5-5,max_tokens4000, timeout 60 s, strict tooldeploy_advice(additionalProperties: false),tool_choice: automet "precies één keer aanroepen", systeemprompt met de planner-regels van increment 1 en de signaalset uit spec rev 2.redactSecrets(...).textop commit-subjects vóór verzending en op summary/warnings erna; eigen vormcontrole; al-true vlaggen weggefilterd;mcp_pin/onbekende vlaggen → ongeldig. Refusal,max_tokens, geen tool-call,APIError(incl.RateLimitError) en ontbrekende sleutel →{ advice: null, error_text }, nooit een throw.cost_usduitusage($0,10/$0,50 per 1M).DeployAdvice(uniek per dry-run, cascade op FlowRun,applied_flow_run_idnullable, index daarop voor de auditpagina) + tegenrelatiedeploy_advice_dry_runopFlowRun.prisma/migrations/20261022120000_deploy_advice/migration.sql: handgeschreven, SQL byte-gelijk aanprisma migrate diff --from-empty --to-schema; draait mee inupdate_ops_dashboard.test/agent-client-exec-result.test.ts,test/deploy-advice-advisor.test.ts.T-215 — advise-route en run-route (
4cac05c8e)POST /api/flows/deploy-scrum4me/advise{ dry_run_flow_run_id }: 401/403; 404 bij onbekende dry-run of andere gebruiker/host; 400 bij andere flow, geen dry-run, niet-success of ouder dan 30 min; 502 als het input-command code ≠ 0 geeft (stderr inerror) of geen JSON levert; 409 alsplan.generated_atbuiten[started_at, ended_at ?? now]valt of als het bestaande advies al toegepast is;adviseDeploy+ upsert; bij eenblock-warnings4m_queue_notify_jpmet keydeploy-scrum4me-advice:<advice_id>enbuildBlockNotice(...)op stdin, fail-open (notify_error).Respons 200:
{ advice_id, plan, input, advice, error_text, notify_error }.lib/deploy-advice/notify.ts:buildBlockNotice(advice, host, dashboardUrl, { advice_id, dry_run_flow_run_id, plan_generated_at }).POST /api/flows/run: optioneelplan_overrides: { add_flags }enadvice_id, uitsluitend bijdeploy_scrum4me(400);add_flagsunieke vlaggen ⊆FLAG_NAMES(400); advies van deze gebruiker (via de dry-run) en host, < 30 min, nog niet toegepast (404/409). Alle validatie vóórflowRun.create; daarnaapplied_flow_run_idzetten enplan_overridesin de agent-body. Zonder overrides is de agent-body ongewijzigd.test/deploy-advice-advise-route.test.ts,test/flows-run-route-overrides.test.ts.Verificatie (lokaal)
npx vitest runop de vier nieuwe suites +ci-test-groups,flow-reconcile,agent-fetch-401: 7 bestanden, 66 tests groen.npm run typecheck(build-info +tsc --noEmit) groen na fresh-worktree-setup;npx prisma validategroen.Afwijkingen van het plan
buildBlockNoticekreeg een vierde argument (advice_id, dry-run-id, plan-tijdstip) zodat de melding naarmac:jpde bron noemt;dashboardUrlis de request-origin, geen nieuwe env-var.DeployAdvice.applied_flow_run_idtoegevoegd (lookup van het auditblok in ST-081).isAdviceConfigured()zit in de adviseur zelf (geen sleutel →error_text, geen Claude-call), zodat ook de route fail-open blijft.🤖 Generated with Claude Code
- lib/agent-client.ts: execAgentResult(commandKey, args, { stdin, timeoutMs }) parseert de SSE van /agent/v1/exec per event (stdout/stderr/exit { code }), stuurt stdin alleen mee als gegeven, abort na 60 s; execAgent ongewijzigd. - lib/deploy-advice/types.ts: FLAG_NAMES (web, worker_fleet, codex, workers; bewust zonder mcp_pin), AdviceInput, DeployAdviceOutput, AdviceResult. - lib/deploy-advice/advisor.ts: claude-haiku-5-5, strict tool deploy_advice, tool_choice auto, redactie van commit-subjects vóór en summary/warnings ná de call, eigen vormcontrole, al-true vlaggen weggefilterd, kosten uit usage; elke fout (geen sleutel, refusal, geen tool-call, APIError) → advice null. - Prisma: model DeployAdvice (uniek per dry-run, cascade) + migratie 20261022120000_deploy_advice (gelijk aan prisma migrate diff). - Tests (base): agent-client-exec-result, deploy-advice-advisor. IDEA-275 increment 2, spec/plan rev 2. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>- POST /api/flows/deploy-scrum4me/advise: eist een geslaagde dry-run van deploy_scrum4me van deze gebruiker en host, jonger dan 30 min; haalt de adviesinvoer via execAgentResult('scrum4me_deploy_advice_input') (code ≠ 0 of geen JSON → 502 met stderr); bindt plan.generated_at aan het venster [started_at, ended_at ?? now] (anders 409); weigert overschrijven van toegepast advies (409); adviseDeploy + upsert DeployAdvice; bij een block-warning s4m_queue_notify_jp met idempotency-key deploy-scrum4me-advice:<advice_id> en de notice op stdin, fail-open (notify_error). Respons { advice_id, plan, input, advice, error_text, notify_error }. - lib/deploy-advice/notify.ts: buildBlockNotice (zuivere module). - POST /api/flows/run: plan_overrides { add_flags } en advice_id, alleen voor deploy_scrum4me (400); add_flags unieke vlaggen uit FLAG_NAMES (400); advice van deze gebruiker/host, < 30 min, nog niet toegepast (404/409); alle validatie vóór flowRun.create; daarna applied_flow_run_id zetten en plan_overrides naar de agent. - Tests (base): deploy-advice-advise-route, flows-run-route-overrides. IDEA-275 increment 2, spec/plan rev 2. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>REQUEST_CHANGES
Plan gekoppeld via pr_refs: T-214, T-215, ST-080, ST-079, ST-081, PBI-26. Geen omitted-referenties; het meegeleverde plan_doc PBI-26 was afgekapt (truncated=true). De actuele IDEA-275-specificatie is aanvullend gelezen. De diff dekt de backend van ST-080; de overige agent-/UI-onderdelen behandel ik als vervolgwerk, niet als ontbrekende oplevering van deze PR. De racecondities doorbreken de eis dat toegepast advies niet opnieuw wordt gebruikt of overschreven.
Verificatie op commit
4cac05c8e7: vier nieuwe testbestanden, 29 tests geslaagd; Prisma-schema geldig. Twee aanvullende lokale reproducties bevestigen bovenstaande fouten. Typecheck niet groen door ontbrekende @s4m-kit-submodule, gegenereerde build-info en ops-agent-dependencies; geen aangetoonde regressie in de gewijzigde bestanden. Geen live deploy of echte model-/queue-aanroep uitgevoerd.COMMENT
Geen blokkerende codebevindingen aangetoond. De implementatie sluit binnen de aangegeven PR-scope aan op ST-080/T-214/T-215 en de product-specificatie IDEA-275. Door de onvolledige onafhankelijke typeverificatie geef ik conform de safe-default geen APPROVED.
Findings
vendor/scrum4me-copilotvoor@s4m-kitkan wegens ontbrekende authenticatie niet worden opgehaald. De eerste typecheck meldt daarnaast ontbrekende ops-agent-dependencies. Dit is een verificatiebeperking, geen aangetoond defect in deze diff.Plan en scope
plan gekoppeld via pr_refs; references: T-214, T-215, ST-080, ST-079, ST-081, PBI-26.
omittedis leeg; het meegeleverde PBI-26-plandocument is wel afgekapte tekst. De relevante volledige IDEA-275-specificatie is aanvullend gelezen via de product-docs.De PR rondt expliciet ST-080 af. De ops-agent/queue-module (ST-079) en pagina/auditblok (ST-081) zijn afzonderlijke opleveringen; hun ontbreken is hier geen blokkerende finding.
Verificatie
76385c3eef927d4027a56ef479e3cc5ae656e011.De review omvat SSE-contract, toegangs-/host-/leeftijdsvalidatie, planbinding, conditionele adviesopslag en transactieclaim, redactie, migratie en testregistratie.