feat(ops-agent): plan-gestuurde flow-stappen (ST-075, IDEA-273) #289
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!289
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "claude/st075-flow-runner-plan-steps-710e5a"
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?
ST-075 — Plan-gestuurde stappen in de ops-agent flow-runner (IDEA-273, sprint S-2026-10-21-1, PBI-25)
Uitbreiding van
ops-agent/src/lib/flow-runner.tsvoor de komende flowdeploy_scrum4me. Flows zonder de nieuwe velden laden en draaien byte-gelijk (getest, echt én dry-run).T-204 — types en fail-closed validatie
FlowStepDef:produces_plan,when,when_exit { command_key, exit_code },continue_on_exit: number[],run_in_dry_run;FlowDef:plan_file.validateLoadedFlowweigert:when/when_exitzonderplan_file;whenvóór (of op) deproduces_plan-stap; meer dan éénproduces_plan;run_in_dry_runop een command zonderread_only(uitzonderinggit_fetch);when_exitnaar een command_key dat niet eerder in de flow staat; plus typecontroles op de nieuwe velden.collectWhenFlags(flow)geëxporteerd.T-205 — uitvoering in
runLoadedFlowreadPlanFile(path, requiredFlags): flags-object met uitsluitend booleans en elkewhen-vlag aanwezig, anderserror"step N: plan unusable: …" + exit 1 (geendone).step_start→ stdoutSKIPPED: <reden>→step_done { exit_code: 0, skipped: true }; overgeslagen stappen tellen niet mee voorwhen_exit.continue_on_exithoudton_failure: abortaf voor de genoemde codes.run_in_dry_run-stappen draaien echt (incl. plan lezen); de rest toontWOULD RUNofSKIPPED.when-stap zonder gelezen plan (planstap nietrun_in_dry_runin dry-run, gefaald of overgeslagen) geefterror+ 1 in plaats van een stille skip. ST-077 geeft de planstap dusrun_in_dry_run: true.Tests
test/ops-agent-flow-plan-validation.test.ts(13) entest/ops-agent-flow-plan-execution.test.ts(11, echte processen), beide inscripts/ci/test-groups.jsongroepbase.test/ops-agent-flow-capability-secret.test.ts,test/control-room-admission.test.ts,test/ci-test-groups.test.ts;npx tsc --noEmit;cd ops-agent && npm run check.Raakt niets onder
deploy/ops-agent/scripts(ST-076 loopt parallel).🤖 Generated with Claude Code
readPlanFile leest fail-closed het plan dat de produces_plan-stap schrijft: flags-object met uitsluitend booleans en elke when-vlag van de flow aanwezig, anders error-event "step N: plan unusable: …" en exit 1. Een stap met when draait alleen bij flags[when] === true, een stap met when_exit alleen als de laatste echte run van dat command die exitcode had; anders de drieslag step_start → stdout "SKIPPED: …" → step_done { exit_code: 0, skipped: true }. continue_on_exit houdt on_failure: abort af voor de genoemde codes. In dry-run draaien alleen run_in_dry_run-stappen echt; de rest toont WOULD RUN of SKIPPED. Flows zonder de nieuwe velden geven dezelfde event-reeks als voorheen. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>REQUEST_CHANGES
name in flagsaccepteert geërfde properties. Met plan{"flags":{}}enwhen: toStringaccepteert de runner de ontbrekende vlag, meldtSKIPPED: plan: toString=falseen eindigt met exit 0; ookconstructoren__proto__passeren. Dit spreekt de fail-closed acceptatie tegen: een ontbrekende vlag moet een error-event en exit 1 geven. GebruikObject.hasOwnen test dit randgeval.produces_plan-stap zonderplan_filepasseert validatie en kan succesvol eindigen zonder ooit een plan te lezen. Gereproduceerd met één noop-producent. Weiger deze combinatie bij het laden.plan gekoppeld via pbi: IDEA-273, story ST-075. De runner-uitbreiding past verder bij het plan en de product-spec
specs/idea-273-specrev 2. Scripts, flowdefinitie, runbook en hostbewijs behoren tot andere stories; hun afwezigheid blokkeert deze PR niet. De payload bevat geen references of omitted.Verificatie op
d6a83084ce: 31 tests geslaagd (plan-execution, plan-validation, flow-capability-secret en flow-reconcile),ops-agent/npm run checkennpx tsc --noEmitgeslaagd na initialisatie van submodules en gegenereerde bestanden. De twee genoemde randgevallen zijn apart met echte uitvoering gereproduceerd. Uitgevoerd onder Node 22.23.3; het package declareert >=24.19.0, dus geen bewijs op de doelruntime. Geen volledige suite of hostuitrol uitgevoerd.Review van s4m-codex-reviewer doorgevoerd, per bevinding:
9745dda56:readPlanFileenskipReasonForgebruikenObject.hasOwn; regressietests intest/ops-agent-flow-plan-execution.test.tsvoorwhen: toStringenwhen: constructormet leeg flags-object → error "plan is missing flag" + exit 1.produces_planzonderplan_file→2f1b0b2fc:validatePlanFieldsweigert "step N: produces_plan requires plan_file on the flow"; test intest/ops-agent-flow-plan-validation.test.ts.Groen: beide plan-tests +
test/ops-agent-flow-capability-secret.test.ts(28 tests),cd ops-agent && npm run check,npm run typecheck.🤖 Generated with Claude Code
`name in flags` zag geërfde properties als aanwezige vlag: met flags {} en when: toString werd de stap overgeslagen en eindigde de run met exit 0. readPlanFile en skipReasonFor gebruiken nu Object.hasOwn, met regressietests voor toString en constructor (error "plan is missing flag" + exit 1). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>APPROVED
Findings:
Plan gekoppeld via pbi. De diff voltooit ST-075 (T-204/T-205) conform het gekoppelde IDEA-273-plan en de productspecificatie: laadvalidatie, fail-closed planlezen, conditionele stappen, exitcode-gates en echte dry-run-stappen. De PR claimt geen afronding van de latere planner-, flow-/runbook- en hostbewijs-stories; die vallen buiten deze review.
Codekwaliteit en patroonconformiteit: bestaande whitelist- en eventpatronen blijven behouden; flows zonder nieuwe velden hebben regressiedekking. De nieuwe tests zijn opgenomen in CI-groep base. De operationele documentatie staat volgens het plan bij de latere flow-story; de nieuwe velden en helpers zijn in de code toegelicht.
Verificatie op head
2f1b0b2fc8:cd ops-agent && npm run checkgeslaagd na installatie van de ops-agent-dependencies.git diff --checkgeslaagd.tsc --noEmitniet groen bevestigd: de reviewkopie mist gegenereerde Prisma-/buildbestanden en submodule-inhoud. Dit levert geen aangetoonde regressie in deze diff op. Uitgevoerd met Node 22.23.3; de gedeclareerde productie-engine is >=24.19.0.