feat(ops-agent): flow deploy_scrum4me, baseline-keys en runbook (ST-077, IDEA-273) #290
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!290
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "claude/st077-deploy-scrum4me-flow"
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-077 — Flow
deploy_scrum4me, command-keys in de baseline en runbook (IDEA-273, PBI-25)Bindt de plan-gestuurde runner (ST-075, #289) en de planner-/marker-scripts (ST-076, #288) in één diff-gedreven deployflow voor de Scrum4Me-stack op scrum4me-server.
T-208 — baseline-keys, flow en test
deploy/ops-agent/baseline/commands.yml:scrum4me_deploy_plan(read_only, geen args) enrecord_deploy_marker(args.allowed: web/docker/codex/workers + de drie repo-paden), beide zonder sudo.deploy/ops-agent/commands.yml(verouderde kopie) blijft onaangeraakt.deploy/ops-agent/flows/deploy_scrum4me.yml+ byte-identieke kopie inbaseline/flows/:plan_file /var/lib/ops-agent/deploy-plan/scrum4me.json; preflight (repo_ownership_check, repo_clean_check, git_fetch ×4 en planner metrun_in_dry_run), daarna de blokken web (policy-gate:prepare_policy_bundle continue_on_exit [3]→approve_policy_hash when_exit {prepare_policy_bundle, 3}), mcp_pin, worker_fleet, codex, workers, elk afgesloten metrecord_deploy_marker. on_failure en scale-stappen uit de baseline-flows.test/deploy-scrum4me-flow.test.ts(groep base): validateLoadedFlow tegen de baseline-allowlist, byte-gelijkheid, stap 0, planner vóór eerstewhen, gate-constructie, blokvolgorde, decrypt vóór recreate, marker als laatste stap per blok,wait_for_health_worker: abort, en de twee command-keys.T-209 — docs
docs/runbooks/deploy-scrum4me.md: doel, regels per component (default branch per repo;mastervoor scrum4me-docker), markers, policy-hash-gate als bewuste afwijking van PBI-164 (besluit JP 2026-10-21), dry-run, preconditions (409), host-uitrol (ST-078; baseline is de bron), bekende grenzen.deploy/ops-agent/baseline/README.md: freeze-paragraaf aangevuld (2026-10-21).Bewuste keuzes t.o.v. de losse baseline-flows
git_fetch scrum4me-mcpalleen in de preflight (niet herhaald in fleet/codex).git_status/git_log_aheadweggelaten: de planner print per component van→naar en de meegaande commits.git_pull scrum4me-dockerin mcp_pin, worker_fleet én codex: elk blok kan zelfstandig geselecteerd zijn en de marker legt HEAD vast; een herhaalde ff-only pull is een no-op.Afhankelijkheid
De flow verwijst op pad naar de scripts uit #288 (nog open bij het maken van deze PR); de test valideert alleen tegen de allowlist en vereist die scripts niet. Host-uitrol is ST-078, apart geautoriseerd.
scripts/ci/test-groups.jsonraakt dezelfde buurt als #288 (triviale merge).Verificatie
npx vitest run test/deploy-scrum4me-flow.test.ts test/ci-test-groups.test.ts test/worker-db-env-flows.test.ts— 58 groennpx vitest run test/ops-agent-flow-plan-validation.test.ts test/ops-agent-flow-plan-execution.test.ts— 27 groennpx tsc --noEmit— groen🤖 Generated with Claude Code
APPROVED
Geen blokkerende findings; ST-077 is plan-conform binnen de beschreven PR-scope.
Findings
docs/runbooks/deploy-scrum4me.md:143: de beperking rond markers nacontinue-stappen geldt ook voor web.curl_smoke_scrum4me_thuisheefton_failure: continue(deploy/ops-agent/flows/deploy_scrum4me.yml:141), waarnaweb.jsonwordt geschreven. Voeg web toe aan deze uitleg; bij een mislukte smoke wordt het web-blok anders de volgende keer overgeslagen. Niet blokkerend: deze waarde volgt de baseline en het expliciete plan.Plan en scope
plan gekoppeld via pr_refs; references: T-208, T-209, ST-077, ST-075, ST-076, ST-078, PBI-25.
omittedis leeg; het meegeleverde plan-document PBI-25 is wel afgekapt (truncated: true). De relevante product-specificatiespecs/idea-273-specrev 2 is geraadpleegd.Command-keys, identieke flowkopieën, blokvolgorde, policy-gate, decrypt-volgorde, markers en testregistratie sluiten aan op ST-077. De expliciet genoemde script-afhankelijkheid #288/ST-076 en het hostbewijs ST-078 vallen buiten deze PR; host-uitrol vereist eerst die scripts.
Verificatie
PR en head SHA
1490647dc4bevestigd. Vijf gerichte suites uitgevoerd: 85 tests geslaagd, inclusief flow-, CI-groep-, worker-db-env- en runner-plan-tests. Volledigenpx tsc --noEmitniet groen in de verse checkout: ontbrekende gegenereerde Prisma/build-info-bestanden,@s4m-kit/indexen ops-agent-dependencies veroorzaken fouten buiten de gewijzigde bestanden. Geen volledige build of hostrun bewezen.Review-finding verwerkt in
2075b86f3: de runbook noemt de marker-na-continue-grens nu ook voor het web-blok (curl_smoke_scrum4me_thuis), plus codex/workers, en dat alleenworker_fleetblokkeert. Detsc-opmerking betreft de verse checkout van de reviewer (ontbrekende gegenereerde Prisma/build-info-bestanden); hier isnpx tsc --noEmitgroen nanpm ci+ generate.APPROVED
Geen blokkerende findings gevonden. De wijzigingen voldoen binnen de scope van ST-077 aan het gekoppelde plan en specs/idea-273-spec rev 2: baseline-keys, identieke flowkopieën, blokvolgorde, policy-gate, decrypt vóór recreate, markers en CI-registratie zijn gecontroleerd.
Findings:
on_failure: continuewordt toch een marker geschreven. Dit volgt het plan en de baseline en is expliciet gedocumenteerd, inclusief herstel door markerverwijdering.plan gekoppeld via pr_refs; references: T-208, T-209, ST-077, ST-075, ST-076, ST-078, PBI-25. Geen references omitted. Het meegestuurde plan-document PBI-25 is afgekapt aangeleverd; de volledige relevante productspecificatie is aanvullend gelezen. Runner, scripts en hostbewijs zijn afzonderlijke stories; deze PR claimt uitsluitend ST-077 af te ronden.
Verificatie op commit
2075b86f3d7d8137f619dbe73f5ab95b846ae4a2: 85 tests geslaagd in vijf suites (flowdefinitie, CI-groepen, worker-db-env, planvalidatie en planuitvoering);npx tsc --noEmitgeslaagd na initialisatie van dependencies, submodules en gegenereerde bestanden. Geen hostdeploy uitgevoerd.