feat(ops-agent): plan-gestuurde flow-stappen (ST-075, IDEA-273) #289

Merged
janpeter merged 4 commits from claude/st075-flow-runner-plan-steps-710e5a into main 2026-10-21 21:13:58 +02:00
Owner

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.ts voor de komende flow deploy_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.
  • validateLoadedFlow weigert: when/when_exit zonder plan_file; when vóór (of op) de produces_plan-stap; meer dan één produces_plan; run_in_dry_run op een command zonder read_only (uitzondering git_fetch); when_exit naar een command_key dat niet eerder in de flow staat; plus typecontroles op de nieuwe velden.
  • collectWhenFlags(flow) geëxporteerd.

T-205 — uitvoering in runLoadedFlow

  • readPlanFile(path, requiredFlags): flags-object met uitsluitend booleans en elke when-vlag aanwezig, anders error "step N: plan unusable: …" + exit 1 (geen done).
  • Overslaan via de bestaande events: step_start → stdout SKIPPED: <reden> → step_done { exit_code: 0, skipped: true }; overgeslagen stappen tellen niet mee voor when_exit.
  • continue_on_exit houdt on_failure: abort af voor de genoemde codes.
  • Dry-run: alleen run_in_dry_run-stappen draaien echt (incl. plan lezen); de rest toont WOULD RUN of SKIPPED.
  • Fail-closed aanvulling: een when-stap zonder gelezen plan (planstap niet run_in_dry_run in dry-run, gefaald of overgeslagen) geeft error + 1 in plaats van een stille skip. ST-077 geeft de planstap dus run_in_dry_run: true.

Tests

  • Nieuw: test/ops-agent-flow-plan-validation.test.ts (13) en test/ops-agent-flow-plan-execution.test.ts (11, echte processen), beide in scripts/ci/test-groups.json groep base.
  • Groen: beide tests, 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

## 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.ts` voor de komende flow `deploy_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`. - `validateLoadedFlow` weigert: `when`/`when_exit` zonder `plan_file`; `when` vóór (of op) de `produces_plan`-stap; meer dan één `produces_plan`; `run_in_dry_run` op een command zonder `read_only` (uitzondering `git_fetch`); `when_exit` naar een command_key dat niet eerder in de flow staat; plus typecontroles op de nieuwe velden. - `collectWhenFlags(flow)` geëxporteerd. ### T-205 — uitvoering in `runLoadedFlow` - `readPlanFile(path, requiredFlags)`: flags-object met uitsluitend booleans en elke `when`-vlag aanwezig, anders `error` "step N: plan unusable: …" + exit 1 (geen `done`). - Overslaan via de bestaande events: `step_start` → stdout `SKIPPED: <reden>` → `step_done { exit_code: 0, skipped: true }`; overgeslagen stappen tellen niet mee voor `when_exit`. - `continue_on_exit` houdt `on_failure: abort` af voor de genoemde codes. - Dry-run: alleen `run_in_dry_run`-stappen draaien echt (incl. plan lezen); de rest toont `WOULD RUN` of `SKIPPED`. - Fail-closed aanvulling: een `when`-stap zonder gelezen plan (planstap niet `run_in_dry_run` in dry-run, gefaald of overgeslagen) geeft `error` + 1 in plaats van een stille skip. ST-077 geeft de planstap dus `run_in_dry_run: true`. ### Tests - Nieuw: `test/ops-agent-flow-plan-validation.test.ts` (13) en `test/ops-agent-flow-plan-execution.test.ts` (11, echte processen), beide in `scripts/ci/test-groups.json` groep `base`. - Groen: beide tests, `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](https://claude.com/claude-code)
FlowStepDef krijgt produces_plan, when, when_exit, continue_on_exit en
run_in_dry_run; FlowDef krijgt plan_file. validateLoadedFlow weigert
when/when_exit zonder plan_file, when vóór de produces_plan-stap, meer dan
één produces_plan, run_in_dry_run op een niet-read_only command (behalve
git_fetch) en when_exit naar een command dat niet eerder in de flow staat.
collectWhenFlags levert de vereiste plan-vlaggen voor de uitvoeringstaak.
Flows zonder de nieuwe velden valideren ongewijzigd.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
feat(ops-agent): plan-gestuurde uitvoering in runLoadedFlow (T-205, ST-075)
All checks were successful
CI / Select checks (pull_request) Successful in 11s
CI / Ops-agent checks (pull_request) Successful in 2m29s
CI / Root app checks (pull_request) Successful in 7m42s
CI / Deploy artifact checks (pull_request) Successful in 4m41s
CI / Docker image build (pull_request) Successful in 2m26s
CI / DB access operator (pull_request) Successful in 5m44s
CI / Mac foundation hermetic checks (pull_request) Successful in 2m54s
CI / Required checks (pull_request) Successful in 11s
d6a83084ce
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>
s4m-codex-reviewer requested changes 2026-10-21 19:12:22 +02:00
Dismissed
s4m-codex-reviewer left a comment

REQUEST_CHANGES

  • ERROR (blokkerend) — ops-agent/src/lib/flow-runner.ts:232 — name in flags accepteert geërfde properties. Met plan {"flags":{}} en when: toString accepteert de runner de ontbrekende vlag, meldt SKIPPED: plan: toString=false en eindigt met exit 0; ook constructor en __proto__ passeren. Dit spreekt de fail-closed acceptatie tegen: een ontbrekende vlag moet een error-event en exit 1 geven. Gebruik Object.hasOwn en test dit randgeval.
  • WARNING (niet blokkerend) — ops-agent/src/lib/flow-runner.ts:349 — Een produces_plan-stap zonder plan_file passeert 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-spec rev 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 check en npx tsc --noEmit geslaagd 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.

# REQUEST_CHANGES - **ERROR (blokkerend)** — ops-agent/src/lib/flow-runner.ts:232 — `name in flags` accepteert geërfde properties. Met plan `{"flags":{}}` en `when: toString` accepteert de runner de ontbrekende vlag, meldt `SKIPPED: plan: toString=false` en eindigt met exit 0; ook `constructor` en `__proto__` passeren. Dit spreekt de fail-closed acceptatie tegen: een ontbrekende vlag moet een error-event en exit 1 geven. Gebruik `Object.hasOwn` en test dit randgeval. - **WARNING (niet blokkerend)** — ops-agent/src/lib/flow-runner.ts:349 — Een `produces_plan`-stap zonder `plan_file` passeert 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-spec` rev 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 d6a83084ceba5391d2a76d29f69d7a2a964e43df: 31 tests geslaagd (plan-execution, plan-validation, flow-capability-secret en flow-reconcile), `ops-agent/npm run check` en `npx tsc --noEmit` geslaagd 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.
Author
Owner

Review van s4m-codex-reviewer doorgevoerd, per bevinding:

  1. Blokkerend — geërfde properties telden als plan-vlag → 9745dda56: readPlanFile en skipReasonFor gebruiken Object.hasOwn; regressietests in test/ops-agent-flow-plan-execution.test.ts voor when: toString en when: constructor met leeg flags-object → error "plan is missing flag" + exit 1.
  2. Waarschuwing — produces_plan zonder plan_file → 2f1b0b2fc: validatePlanFields weigert "step N: produces_plan requires plan_file on the flow"; test in test/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

Review van s4m-codex-reviewer doorgevoerd, per bevinding: 1. **Blokkerend — geërfde properties telden als plan-vlag** → 9745dda56: `readPlanFile` en `skipReasonFor` gebruiken `Object.hasOwn`; regressietests in `test/ops-agent-flow-plan-execution.test.ts` voor `when: toString` en `when: constructor` met leeg flags-object → error "plan is missing flag" + exit 1. 2. **Waarschuwing — `produces_plan` zonder `plan_file`** → 2f1b0b2fc: `validatePlanFields` weigert "step N: produces_plan requires plan_file on the flow"; test in `test/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](https://claude.com/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>
fix(ops-agent): produces_plan zonder plan_file weigeren (review #289, ST-075)
All checks were successful
CI / Ops-agent checks (pull_request) Successful in 17s
CI / DB access operator (pull_request) Successful in 51s
CI / Deploy artifact checks (pull_request) Successful in 13s
CI / Docker image build (pull_request) Successful in 2m35s
CI / Select checks (pull_request) Successful in 5m18s
CI / Mac foundation hermetic checks (pull_request) Successful in 4m6s
CI / Root app checks (pull_request) Successful in 12m9s
CI / Required checks (pull_request) Successful in 28s
2f1b0b2fc8
Zonder plan_file las de runner nooit een plan terwijl de flow wel valideerde.
validatePlanFields weigert nu "step N: produces_plan requires plan_file on the
flow", met test.

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

APPROVED

Findings:

  • Geen blokkerende of overige codefindings gevonden.

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:

  • 62 tests geslaagd over de twee nieuwe suites, flow-capability-secret, control-room-admission en ci-test-groups.
  • cd ops-agent && npm run check geslaagd na installatie van de ops-agent-dependencies.
  • git diff --check geslaagd.
  • Root-tsc --noEmit niet 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.
# APPROVED Findings: - Geen blokkerende of overige codefindings gevonden. 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 2f1b0b2fc8df7b02cb5bc33628a0689343ce5343: - 62 tests geslaagd over de twee nieuwe suites, flow-capability-secret, control-room-admission en ci-test-groups. - `cd ops-agent && npm run check` geslaagd na installatie van de ops-agent-dependencies. - `git diff --check` geslaagd. - Root-`tsc --noEmit` niet 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.
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!289
No description provided.