feat(ops-agent): flow deploy_scrum4me, baseline-keys en runbook (ST-077, IDEA-273) #290

Merged
janpeter merged 3 commits from claude/st077-deploy-scrum4me-flow into main 2026-10-21 21:51:28 +02:00
Owner

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) en record_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 in baseline/flows/: plan_file /var/lib/ops-agent/deploy-plan/scrum4me.json; preflight (repo_ownership_check, repo_clean_check, git_fetch ×4 en planner met run_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 met record_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 eerste when, 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; master voor 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-mcp alleen in de preflight (niet herhaald in fleet/codex).
  • git_status/git_log_ahead weggelaten: de planner print per component van→naar en de meegaande commits.
  • git_pull scrum4me-docker in 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.json raakt 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 groen
  • npx vitest run test/ops-agent-flow-plan-validation.test.ts test/ops-agent-flow-plan-execution.test.ts — 27 groen
  • npx tsc --noEmit — groen

🤖 Generated with Claude Code

## 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) en `record_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 in `baseline/flows/`: `plan_file /var/lib/ops-agent/deploy-plan/scrum4me.json`; preflight (repo_ownership_check, repo_clean_check, git_fetch ×4 en planner met `run_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 met `record_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 eerste `when`, 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; `master` voor 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-mcp` alleen in de preflight (niet herhaald in fleet/codex). - `git_status`/`git_log_ahead` weggelaten: de planner print per component van→naar en de meegaande commits. - `git_pull scrum4me-docker` in 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.json` raakt 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 groen - `npx vitest run test/ops-agent-flow-plan-validation.test.ts test/ops-agent-flow-plan-execution.test.ts` — 27 groen - `npx tsc --noEmit` — groen 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Bindt de plan-gestuurde runner (ST-075) en de planner-/marker-scripts (ST-076)
in één diff-gedreven deployflow voor de Scrum4Me-stack op scrum4me-server:
preflight (ownership, clean-check, fetch x4, planner; fetch en planner ook in
dry-run) en de blokken web (policy-gate: exit 3 -> approve -> doorgaan),
mcp_pin, worker_fleet, codex en workers, elk eindigend met zijn marker.
on_failure en scale-stappen volgen de baseline-flows; scrum4me-mcp wordt
alleen in de preflight gefetcht.

De twee command-keys staan in deploy/ops-agent/baseline/commands.yml (de live
bron); deploy/ops-agent/commands.yml blijft de verouderde kopie. De flow staat
byte-identiek in flows/ en baseline/flows/. De test valideert de flow tegen de
baseline-allowlist en bewaakt blokvolgorde, gate-constructie, decrypt vóór
recreate en de marker als laatste stap per blok.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
docs(runbooks): runbook deploy_scrum4me en baseline-README freeze-aanvulling (T-209, ST-077)
Some checks failed
CI / Select checks (pull_request) Successful in 11s
CI / DB access operator (pull_request) Successful in 51s
CI / Deploy artifact checks (pull_request) Successful in 22s
CI / Ops-agent checks (pull_request) Successful in 2m57s
CI / Docker image build (pull_request) Successful in 3m8s
CI / Required checks (pull_request) Has been cancelled
CI / Root app checks (pull_request) Has been cancelled
CI / Mac foundation hermetic checks (pull_request) Has been cancelled
1490647dc4
Beschrijft doel, regels per component (met default branch per repo, master
voor scrum4me-docker), markers (pad, velden, herstel door verwijderen,
handmatige deploys schrijven geen markers), de policy-hash-gate als bewuste
afwijking van PBI-164 (besluit JP 2026-10-21, hashverschil in het FlowRun-
log), dry-run met echt plan, preconditions vooraf over alle stappen (409),
de host-uitrolvolgorde uit ST-078 met de baseline als bron voor commands.yml,
en de bekende grenzen. De baseline-README noemt de twee keys en de flow in
de freeze-paragraaf met datum.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
s4m-codex-reviewer approved these changes 2026-10-21 21:37:01 +02:00
Dismissed
s4m-codex-reviewer left a comment

APPROVED

Geen blokkerende findings; ST-077 is plan-conform binnen de beschreven PR-scope.

Findings

  • info — docs/runbooks/deploy-scrum4me.md:143: de beperking rond markers na continue-stappen geldt ook voor web. curl_smoke_scrum4me_thuis heeft on_failure: continue (deploy/ops-agent/flows/deploy_scrum4me.yml:141), waarna web.json wordt 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. omitted is leeg; het meegeleverde plan-document PBI-25 is wel afgekapt (truncated: true). De relevante product-specificatie specs/idea-273-spec rev 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 1490647dc4 bevestigd. Vijf gerichte suites uitgevoerd: 85 tests geslaagd, inclusief flow-, CI-groep-, worker-db-env- en runner-plan-tests. Volledige npx tsc --noEmit niet groen in de verse checkout: ontbrekende gegenereerde Prisma/build-info-bestanden, @s4m-kit/index en ops-agent-dependencies veroorzaken fouten buiten de gewijzigde bestanden. Geen volledige build of hostrun bewezen.

# APPROVED Geen blokkerende findings; ST-077 is plan-conform binnen de beschreven PR-scope. ## Findings - **info** — `docs/runbooks/deploy-scrum4me.md:143`: de beperking rond markers na `continue`-stappen geldt ook voor **web**. `curl_smoke_scrum4me_thuis` heeft `on_failure: continue` (`deploy/ops-agent/flows/deploy_scrum4me.yml:141`), waarna `web.json` wordt 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. `omitted` is leeg; het meegeleverde plan-document PBI-25 is wel afgekapt (`truncated: true`). De relevante product-specificatie `specs/idea-273-spec` rev 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 1490647dc493f30e8958820e03069548d91b771b bevestigd. Vijf gerichte suites uitgevoerd: **85 tests geslaagd**, inclusief flow-, CI-groep-, worker-db-env- en runner-plan-tests. Volledige `npx tsc --noEmit` niet groen in de verse checkout: ontbrekende gegenereerde Prisma/build-info-bestanden, `@s4m-kit/index` en ops-agent-dependencies veroorzaken fouten buiten de gewijzigde bestanden. Geen volledige build of hostrun bewezen.
docs(runbooks): marker-na-continue geldt ook voor het web-blok (review #290, ST-077)
All checks were successful
CI / Select checks (pull_request) Successful in 1m35s
CI / DB access operator (pull_request) Successful in 1m4s
CI / Ops-agent checks (pull_request) Successful in 1m40s
CI / Deploy artifact checks (pull_request) Successful in 36s
CI / Docker image build (pull_request) Successful in 1m40s
CI / Root app checks (pull_request) Successful in 7m1s
CI / Mac foundation hermetic checks (pull_request) Successful in 3m57s
CI / Required checks (pull_request) Successful in 1m17s
2075b86f3d
curl_smoke_scrum4me_thuis staat op continue, dus ook web.json wordt na een
mislukte smoke geschreven; de runbook noemt nu alle drie de blokken en dat
alleen worker_fleet blokkeert.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Author
Owner

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 alleen worker_fleet blokkeert. De tsc-opmerking betreft de verse checkout van de reviewer (ontbrekende gegenereerde Prisma/build-info-bestanden); hier is npx tsc --noEmit groen na npm ci + generate.

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 alleen `worker_fleet` blokkeert. De `tsc`-opmerking betreft de verse checkout van de reviewer (ontbrekende gegenereerde Prisma/build-info-bestanden); hier is `npx tsc --noEmit` groen na `npm ci` + generate.
s4m-codex-reviewer left a comment

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:

  • INFO — deploy/ops-agent/baseline/commands.yml:400 — De scripts achter de nieuwe keys komen uit ST-076/#288 en ontbreken op deze head. De PR vermeldt deze afhankelijkheid expliciet; zorg dat #288 beschikbaar is vóór host-uitrol. Dit is geen ontbrekend werk binnen ST-077.
  • INFO — docs/runbooks/deploy-scrum4me.md:143 — Na falende health-/smoke-stappen met on_failure: continue wordt 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 --noEmit geslaagd na initialisatie van dependencies, submodules en gegenereerde bestanden. Geen hostdeploy uitgevoerd.

# 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: - INFO — deploy/ops-agent/baseline/commands.yml:400 — De scripts achter de nieuwe keys komen uit ST-076/#288 en ontbreken op deze head. De PR vermeldt deze afhankelijkheid expliciet; zorg dat #288 beschikbaar is vóór host-uitrol. Dit is geen ontbrekend werk binnen ST-077. - INFO — docs/runbooks/deploy-scrum4me.md:143 — Na falende health-/smoke-stappen met `on_failure: continue` wordt 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 --noEmit` geslaagd na initialisatie van dependencies, submodules en gegenereerde bestanden. Geen hostdeploy uitgevoerd.
janpeter scheduled this pull request to auto merge when all checks succeed 2026-10-21 21:48:43 +02:00
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!290
No description provided.