feat(ops-agent): plan_overrides, advice-input en queue-module (ST-079, IDEA-275) #294
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!294
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "claude/st079-ops-agent-plan-overrides-queue-896f55"
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-079 — ops-agent: plan_overrides, advice-input en queue-module (IDEA-275, increment 2)
Sprint S-2026-10-21-2 / PBI-26 / ST-079. Spec rev 2 en plan rev 2 (Scrum4Me docs
idea-275-spec,idea-275-plan). Geen flowwijziging, geen sudoers. Onafhankelijk van de dashboard-story ST-080.T-211 — plan_overrides in flow-runner en flow-route (
758b587c8)ops-agent/src/lib/flow-runner.ts:PlanOverrides { add_flags }envalidatePlanOverrides(flow, overrides)(object,add_flags: string[], elke naam incollectWhenFlags(flow)viaArray.includes, uniek, max 8).runLoadedFlow(..., { planOverrides })valideert fail-closed en past de overrides toe direct nareadPlanFileen vóórstep_donevan de planstap: per vlag één stdout-regelOVERRIDE: <flag>=true (advies). Een onleesbaar plan geefterror+ return 1 zonder voorafgaandestep_donemet exit 0. Nooitfalse; zonder overrides byte-gelijk gedrag; ook in dry-run.ops-agent/src/routes/flow.ts: bodyplan_overrides→ 400{ error }vóór admission; doorgegeven aan de runner.test/ops-agent-flow-plan-overrides.test.ts(volgorde OVERRIDE vóór step_done, al-true vlag geen regel, byte-gelijke eventreeks zonder overrides, onleesbaar plan → error zonder step_done, dry-run toont OVERRIDE en de when-stap blijft WOULD RUN, ongeldige override fail-closed) entest/ops-agent-flow-route-overrides.test.ts(Fastify-inject met stub-admission: onbekende/dubbele/9 vlaggen → 400 zonder admission; geldig → 200 met OVERRIDE vóór step_done in de SSE-stream).T-212 — scrum4me-deploy-advice-input.sh (
fe4421b00)deploy/ops-agent/scripts/scrum4me-deploy-advice-input.sh(+x): zelfde env-overrides als de planner plusSCRUM4ME_ADVICE_MAX_AGE_S=1800. Plan ontbreekt/onleesbaar/ongeldig/te oud → exit 2 op stderr. Per component web/docker/workers:fromnull of niet in de checkout (git cat-file -e) →first_deploymetgit log -n 50 <to>,diffstat: null, lege paden; anderslog -n 50 from..to,diff --shortstat,diff --name-onlygeclassificeerd inmigrations,db_access,submodule_bumpsen (docker)compose_or_dockerfile, elk max 50.mcp:MCP_GIT_REFvia awk met de vormeisen vanverify-mcp-release-ref.sh,pinned_sha,main_sha,commits_behind, commits. JSON vianode -euit een werkmap; begrenzing metgit -n, geen head-pipe; geen bestandsinhoud of compose-env-waarden in de uitvoer.test/scrum4me-deploy-advice-input.test.ts(11 cases op de git-fixtures van de planner-test: vorm, commits/diffstat, classificatie, cap 50, first_deploy zonder marker en bij onbekende sha, mcp-afstand, geen env-lek, exit 2 zonder/oud/kapot plan en zonder checkout).T-213 — queue-module en baseline-keys (
ea3f2e173)ops-agent/wrappers/queue/notify-jp.sh(+x): leest${S4M_QUEUE_ENV_FILE:-/etc/ops-agent/s4m-queue.env}regel voor regel (alleenS4M_QUEUE_URLenS4M_SERVER, niets gesourced), roept${S4M_QUEUE_NODE:-/usr/bin/node} ${S4M_QUEUE_CLI:-/usr/local/lib/s4m-queue/dist/cli.js} push --to mac:jp --type info --as claude --idempotency-key <arg1>aan met kopregelops-dashboard deploy_scrum4me advies (scrum4me-server)+ lege regel + stdin;--checkcontroleert alleen CLI en env (en eist een gevuldeS4M_QUEUE_URL); exit 2 bij elke fout zonder env-waarden te printen; CLI-exitcode wordt doorgegeven.deploy/ops-agent/install-queue-module.sh(+x, idempotent, root, testmodusOPS_AGENT_QUEUE_INSTALL_TEST=1):--source(default/home/janpeter/s4m-queue, eistdist/cli.js), rsyncdist/,node_modules/,package.jsonnaar/usr/local/lib/s4m-queue(root:root, 0755/0644), wrapper naar/usr/local/lib/ops-agent/wrappers/queue/, env-placeholder alleen als die ontbreekt (0640 root:ops-agent), keys4m_queue_notify_jpéén keer toegevoegd aan de livecommands.yml(blok uit de baseline), geen sudoers, restart tenzijOPS_AGENT_SKIP_RESTART=1, eindigt met de--check-verificatieopdracht.deploy/ops-agent/baseline/commands.yml:scrum4me_deploy_advice_input(read_only: true, geen args) ens4m_queue_notify_jp(wrapper,args.patterns ^deploy-scrum4me-advice:[A-Za-z0-9_-]{1,64}$,stdin_from_body: true) met kopcommentaar;baseline/README.mdfreeze-paragraaf 2026-10-22.deploy/ops-agent/setup.shroeptinstall-queue-module.shaan als/home/janpeter/s4m-queue/dist/cli.jsbestaat (de fail-closed testops-agent-setup-moduleseist dat elke module-installer in setup.sh staat).test/ops-agent-queue-notify-wrapper.test.ts(stub-CLI: argv + kopregel + stdin + key, exitcode doorgegeven,--checkzonder push, env/CLI ontbreekt → 2, placeholder → 2, key buiten patroon → 2, geen env-lek, env wordt niet gesourced),test/ops-agent-install-queue-module.test.ts(testmodus naar tmp; idempotent; env niet overschreven; key één keer; stale CLI-bestand verwijderd; weigert bron zonder cli.js en ontbrekende commands.yml),test/deploy-scrum4me-flow.test.tsuitgebreid (beide keys laden en valideren;validateArgsweigertx,--checken een te lange key).Afwijkingen van het plan
node -e-stap (uit hetname-only-bestand) in plaats van in bash-arrays; zelfde resultaat, geen head-pipe.setup.shkrijgt een geguardde aanroep vaninstall-queue-module.sh(niet in het plan), omdattest/ops-agent-setup-modules.test.tsfail-closed eist dat elkeinstall-*-module.shdoor setup.sh wordt aangeroepen.notify-jp.sh --checkfaalt ook bij een legeS4M_QUEUE_URL(placeholder), zodat het hostbewijs pas groen is na het vullen van de credential.dockergebruikttargets.worker_fleet.from/to(codex deelt dezelfde checkout).Verificatie (lokaal)
npx vitest runop de zeven nieuwe/uitgebreide tests plusops-agent-flow-plan-execution,ops-agent-flow-plan-validation,ops-agent-setup-modules,ci-test-groups,control-room-legacy-routes,scrum4me-deploy-plan,pre-push-test-registry-hook: 177/177.cd ops-agent && npm run check: ok.npx tsc --noEmit: schoon.bash -nop de drie nieuwe scripts ensetup.sh: ok.scripts/ci/test-groups.json(groep base).Hostbewijs (install, credential,
--check, Plan + advies, Deploy met override) volgt in ST-082.🤖 Generated with Claude Code
De runner krijgt een optie planOverrides { add_flags } die vlaggen uitsluitend op true bijzet, direct na readPlanFile en vóór het step_done-event van de planstap, met per vlag één stdout-regel "OVERRIDE: <flag>=true (advies)". Een onleesbaar plan geeft nu error + 1 zónder voorafgaande step_done met exit 0. POST /agent/v1/flow valideert plan_overrides (when-vlaggen van de flow, uniek, max 8) vóór admission en antwoordt 400 bij een fout. Zonder plan_overrides is het gedrag byte-gelijk aan increment 1 (IDEA-273). Tests: test/ops-agent-flow-plan-overrides.test.ts en test/ops-agent-flow-route-overrides.test.ts (groep base). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>Eigen, beperkte s4m-queue-route voor ops-agent (JP-besluit optie b): - ops-agent/wrappers/queue/notify-jp.sh leest /etc/ops-agent/s4m-queue.env regel voor regel (alleen S4M_QUEUE_URL en S4M_SERVER, niets gesourced), pusht kopregel + stdin als info naar mac:jp met de meegegeven idempotency-key (^deploy-scrum4me-advice:[A-Za-z0-9_-]{1,64}$); --check controleert alleen CLI en env; exit 2 bij elke fout zonder env-waarden te printen. - deploy/ops-agent/install-queue-module.sh (idempotent, root, testmodus): rsync van dist/, node_modules/ en package.json naar /usr/local/lib/s4m-queue, wrapper naar /usr/local/lib/ops-agent/wrappers/queue/, env-placeholder alleen als die ontbreekt (0640 root:ops-agent), command-key s4m_queue_notify_jp één keer toegevoegd aan de live commands.yml, geen sudoers, eindigt met de --check-verificatie. setup.sh roept hem aan als de CLI-build aanwezig is. - baseline/commands.yml: scrum4me_deploy_advice_input (read_only) en s4m_queue_notify_jp (stdin_from_body, args.patterns); README-freeze aangevuld. Tests (base): ops-agent-queue-notify-wrapper, ops-agent-install-queue-module, deploy-scrum4me-flow uitgebreid met beide keys en validateArgs-weigering. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>REQUEST_CHANGES
Findings:
plan.targets.web.to !== components.web.to. De geplandegenerated_at-binding kan hierdoor advies bij het verkeerde wijzigingenpakket accepteren. Gebruik dezelfde snapshot voor leeftijdscontrole, targets en uitvoer; test vervanging tijdens het verzamelen.env-objecten missenNODE_ENV. De root-typecheck geeft op beide locaties TS2769, omdat Next.js dit veld verplicht stelt inProcessEnv. Voeg bijvoorbeeldNODE_ENV: 'test'toe aan beide objecten.Plan gekoppeld via pr_refs. References: T-211, T-212, T-213, ST-079, ST-080, ST-082, PBI-26. Geen vermeldingen in
omitted; het aangeleverde plandocument PBI-26 is wel afgekapt (truncated=true). De toetsing betreft ST-079 en de relevante IDEA-275-productspecificatie. Dashboardwerk (ST-080) en hostuitrol (ST-082) zijn vervolgwerk en vormen hier geen blokkerende ontbrekende scope. De twee bovenstaande fouten verhinderen goedkeuring.Verificatie op head
ea3f2e1738(komt overeen met de remote PR-head): 90 gerichte tests geslaagd; drie installertests konden niet slagen doordat rsync in deze reviewomgeving ontbreekt.ops-agent/npm run checken bash-syntaxcontroles slagen.npx tsc --noEmitfaalt, waaronder de twee nieuwe fouten hierboven; daarnaast ontbreken in deze kopie gegenereerde Prisma/build-info-bestanden en de copilot-submodule. Node in de reviewomgeving is 22.23.4, onder de vereiste ops-agent-versie 24.19.0. Geen hostacties of queue-berichten uitgevoerd.Review verwerkt in
59285e50b:cp -p) naar de werkmap en haalt leeftijd, targets én hetplan-veld uit die snapshot. Nieuwe testuses one plan snapshot even when the plan file is replaced while git runs(git-shim op PATH vervangt het plan tijdens het verzamelen; uitvoer blijft plan A,components.web.to === plan.targets.web.to).NODE_ENV: 'test'toegevoegd aan de subprocess-env vantest/ops-agent-install-queue-module.test.tsentest/ops-agent-queue-notify-wrapper.test.ts. Mijn eerdere tsc-gate was ongeldig (verkeerde cwd);npx tsc --noEmitvanuit de root geeft nu exit 0. Dat verklaart ook de rode "Root app checks" op de vorige head.Lokaal: vitest op de drie scripttests 29/29,
npx tsc --noEmitexit 0,bash -nok.CI-oorzaak gevonden via het joblog in de web-UI (run 545, stap "Run base test group"): de runner heeft geen
rsync(ERROR: rsync not found), waardoor de drie tests intest/ops-agent-install-queue-module.test.tsmet exit 2 faalden. Dezelfde reden waarom de reviewomgeving die tests niet kon draaien.Opgelost in
5e0d1772c:install-queue-module.shkopieertdist/ennode_modules/nu met coreutils (diff -rqvoor "in sync", anderscp -anaar een staging-map en atomair omwisselen). Gedrag en tests ongewijzigd; bewuste afwijking van het taakplan (rsync).Lokaal: installer-test 3/3 (ook met een PATH zonder rsync-aanname),
npx tsc --noEmitexit 0,bash -nok.De Forgejo-runner heeft geen rsync ("ERROR: rsync not found"), waardoor de drie installer-tests in de base-groep met exit 2 faalden. De CLI-kopie gaat nu met coreutils: diff -rq bepaalt of dist/ en node_modules/ al gelijk zijn (extra bestanden tellen als afwijking), anders cp -a naar een staging-map en atomair omwisselen. Gedrag en tests (idempotent, stale bestand verdwijnt) ongewijzigd; afwijking van het taakplan (rsync) bewust. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>COMMENT
Geen blokkerende findings gevonden; één kleine afwijking en een verificatiebeperking.
ops-agent/wrappers/queue/notify-jp.sh:55:--checkprint de uit het env-bestand gelezenS4M_SERVER-waarde. Dit wijkt af van ST-079/T-213 en de productspecificatie (“geen env-waarden”). Gereproduceerd met een sentinelwaarde in stdout. Gebruik een vaste ok-melding en controleer in de test dat beide env-waarden ontbreken. Niet blokkerend: de queue-credential wordt hier niet geprint.plan gekoppeld via pr_refs: T-211, T-212, T-213, ST-079, ST-080, ST-082, PBI-26. De diff dekt ST-079; dashboardwerk (ST-080) en hostuitrol (ST-082) zijn vervolgwerk en geen ontbrekende oplevering van deze PR. Plan-document PBI-26 is afgekapt (
truncated: true);omittedis leeg. Getoetst aan de volledige meegeleverde ST-079-taken en productdocumentspecs/idea-275-spec.Verificatie op commit
59285e50b2e9df478d3377ffc30083820f48818e: 113/116 gerichte tests geslaagd (8/9 suites). De drie installatietests falen uitsluitend doordatrsyncontbreekt in deze reviewomgeving; installatie/idempotentie daardoor niet dynamisch bevestigd.npx tsc --noEmit,ops-agent/npm run check,bash -nvoor de vier betrokken scripts engit diff --checkslagen. Tests uitgevoerd met Node 22.23.4; ops-agent declareert Node >=24.19.0.Review 1379 (warning
--checkprintS4M_SERVER) verwerkt inc296a18be: vaste meldingnotify-jp: ok; de test asserteert dat zowel de URL als de servernaam in stdout/stderr ontbreken. De rsync-afhankelijkheid uit je verificatiebeperking is in5e0d1772cal weggenomen (diff -rq + cp -a).REQUEST_CHANGES
deploy/ops-agent/scripts/scrum4me-deploy-advice-input.sh:142: mislukte Git-log/diff-opdrachten worden via|| : > bestandvervangen door lege bestanden. Gereproduceerd met geldige from/to-commitobjecten maar een ontbrekend tree-object: Git geeftfatal: unable to read tree, terwijl het script exit 0 retourneert met nul gewijzigde bestanden en lege migratiepaden, ondanks een toegevoegde migratie. Hierdoor krijgt de adviseur onvolledige invoer zonder foutsignaal. Geef een niet-nul exitcode terug bij deze leesfouten, inclusief de MCP-log, en dek dit af met een regressietest.plan gekoppeld via pr_refs — references: T-211, T-212, T-213, ST-079, ST-080, ST-082, PBI-26. De PR begrenst de oplevering expliciet tot ST-079; ST-080 en hostbewijs ST-082 zijn vervolgwerk en geen bevinding. Geen omitted-items; één meegeleverd plan_doc is afgekapt. Getoetst aan product-spec
idea-275-specrev 2. De runner, routevalidatie, baseline en documentatie sluiten verder aan op deze scope.Verificatie op
c296a18be4: 7 gerichte testsuites, 94 tests geslaagd;ops-agent/npm run check,npx tsc --noEmitenbash -nop de drie nieuwe scripts geslaagd. Gedraaid met Node 22.23.4; ops-agent declareert Node >=24.19.0. Geen hostuitrol uitgevoerd.Review 1381 (blocker: stille lege lijsten bij mislukte git log/diff) verwerkt in
93bc8ddf2: elke misluktegit log/git diff, inclusief de MCP-log, geeft nu exit 2 met reden op stderr en geen JSON. Regressietests: verwijderd tree-object van het doel in de web-set (web: git diff … mislukt) en een kapotte mcp-HEAD. Suite 14/14,npx tsc --noEmitexit 0,bash -nok.APPROVED
Findings
De diff is conform de ST-079-scope: overridevalidatie vóór admission, toepassing vóór het planstap-
step_done, uitsluitend bijzetten van vlaggen, begrensde adviseursinvoer met foutafhandeling, en een afzonderlijke queue-module zonder sudoers. Baseline-documentatie en CI-testregistratie zijn bijgewerkt.Plan gekoppeld via pr_refs: T-211, T-212, T-213, ST-079, ST-080, ST-082 en PBI-26. De meegeleverde PBI-26-plantekst is afgekapt;
omittedis leeg. Aanvullend de volledige product-specificatieidea-275-specgeraadpleegd. ST-080 (dashboard) en ST-082 (hostbewijs) zijn expliciet vervolgwerk en worden door deze PR niet als afgerond geclaimd.Verificatie op commit
93bc8ddf22297b39825acb3a4c085601bffe783c:ops-agent: npm run check, dashboard-npm run typecheck,bash -nengit diff --checkgeslaagd.