docs(runbooks): host-rollout host_metrics op scrum4me-srv (IDEA-276 story 4) #304

Merged
janpeter merged 2 commits from docs/idea-276-host-rollout into main 2026-10-24 01:16:12 +02:00
Owner

Runbook voor story 4 van IDEA-276 (ST-086, T-227/T-228): de host-rollout van host_metrics op scrum4me-srv na merge van PR #303 (main 3c44ba8cc). Alleen documentatie: docs/runbooks/idea-276-host-rollout.md.

Inhoud: de taakplannen T-227/T-228 in uitvoerbare volgorde met verwachte uitkomsten — module-install, baseline verbatim (brengt read_only: true op read_backup_status naar de host), drift-detector in twee lagen (geen WARNING:-regels), wrapper-proef als ops-agent, pincontrole tegen docker image ls, release, container-env (OPS_AGENT_URL, INSTANCE_CAPABILITIES), sampler-log, read-only-bewijs in drie stappen via de admission-audit, UI-controle en rollback.

Geen code, geen CI-impact.

🤖 Generated with Claude Code

Runbook voor story 4 van IDEA-276 (ST-086, T-227/T-228): de host-rollout van `host_metrics` op scrum4me-srv na merge van PR #303 (main `3c44ba8cc`). Alleen documentatie: `docs/runbooks/idea-276-host-rollout.md`. Inhoud: de taakplannen T-227/T-228 in uitvoerbare volgorde met verwachte uitkomsten — module-install, baseline verbatim (brengt `read_only: true` op `read_backup_status` naar de host), drift-detector in twee lagen (geen `WARNING:`-regels), wrapper-proef als ops-agent, pincontrole tegen `docker image ls`, release, container-env (`OPS_AGENT_URL`, `INSTANCE_CAPABILITIES`), sampler-log, read-only-bewijs in drie stappen via de admission-audit, UI-controle en rollback. Geen code, geen CI-impact. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(runbooks): host-rollout host_metrics op scrum4me-srv (IDEA-276 story 4, T-227/T-228)
Some checks failed
CI / Select checks (pull_request) Successful in 1m2s
CI / Ops-agent checks (pull_request) Successful in 50s
CI / DB access operator (pull_request) Successful in 1m35s
CI / Deploy artifact checks (pull_request) Successful in 46s
CI / Docker image build (pull_request) Successful in 1m33s
CI / Mac foundation hermetic checks (pull_request) Successful in 2m0s
CI / Required checks (pull_request) Has been cancelled
CI / Root app checks (pull_request) Has been cancelled
f1a7f57810
Uitvoerbare volgorde van de Scrum4Me-taakplannen T-227 en T-228 na merge van
PR #303: module-install, baseline verbatim (brengt read_only op
read_backup_status naar de host), drift-detector in twee lagen zonder
WARNING:-regels, wrapper-proef als ops-agent, pincontrole, release,
container-env, sampler-log, read-only-bewijs in drie stappen via de
admission-audit, UI-controle en rollback.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
janpeter scheduled this pull request to auto merge when all checks succeed 2026-10-24 01:00:37 +02:00
s4m-codex-reviewer requested changes 2026-10-24 01:01:19 +02:00
Dismissed
s4m-codex-reviewer left a comment

REQUEST_CHANGES

Findings:

  • ERROR (blokkerend) — docs/runbooks/idea-276-host-rollout.md:20: de pipeline apply-drift-runtime.sh | tee ... verbergt zonder pipefail de exitcode van de installer. De instructie controleert uitsluitend het aantal WARNING:-regels. Bij bijvoorbeeld een fout in systemctl enable --now zijn de runtime-bestanden al gekopieerd; de volgende drift-check kan daardoor exit 0 geven terwijl de timerinstallatie is mislukt. Controleer direct de installer-exitcode met PIPESTATUS[0], of gebruik pipefail met expliciete stop bij een fout, en vereis daarnaast nul waarschuwingen.

Plan gekoppeld via pr_refs; references: T-227, T-228, ST-086. Er is niets weggelaten (omitted is leeg). De overige beschreven stappen sluiten aan op de gekoppelde taakplannen en de product-specificatie IDEA-276. Deze documentatie-PR levert een uitvoeringsinstructie; de feitelijke host-rollout, README-datumregel en live-bewijzen worden hier niet als voltooid geclaimd en zijn daarom geen ontbrekende implementatiebevindingen.

Verificatie: PR-head en diff gecontroleerd tegen Forgejo/git; installer en admission/exec-code statisch nagekeken. De gemaskeerde pipeline-exitcode lokaal gereproduceerd (false | tee geeft zonder pipefail exit 0). Geen hostwijzigingen of live rollout uitgevoerd; geen applicatietests/build gedraaid voor deze uitsluitend documenterende wijziging.

# REQUEST_CHANGES Findings: - **ERROR (blokkerend)** — `docs/runbooks/idea-276-host-rollout.md:20`: de pipeline `apply-drift-runtime.sh | tee ...` verbergt zonder `pipefail` de exitcode van de installer. De instructie controleert uitsluitend het aantal `WARNING:`-regels. Bij bijvoorbeeld een fout in `systemctl enable --now` zijn de runtime-bestanden al gekopieerd; de volgende drift-check kan daardoor exit 0 geven terwijl de timerinstallatie is mislukt. Controleer direct de installer-exitcode met `PIPESTATUS[0]`, of gebruik `pipefail` met expliciete stop bij een fout, en vereis daarnaast nul waarschuwingen. Plan gekoppeld via pr_refs; references: T-227, T-228, ST-086. Er is niets weggelaten (`omitted` is leeg). De overige beschreven stappen sluiten aan op de gekoppelde taakplannen en de product-specificatie IDEA-276. Deze documentatie-PR levert een uitvoeringsinstructie; de feitelijke host-rollout, README-datumregel en live-bewijzen worden hier niet als voltooid geclaimd en zijn daarom geen ontbrekende implementatiebevindingen. Verificatie: PR-head en diff gecontroleerd tegen Forgejo/git; installer en admission/exec-code statisch nagekeken. De gemaskeerde pipeline-exitcode lokaal gereproduceerd (`false | tee` geeft zonder `pipefail` exit 0). Geen hostwijzigingen of live rollout uitgevoerd; geen applicatietests/build gedraaid voor deze uitsluitend documenterende wijziging.
docs(runbooks): installer-exitcode van apply-drift-runtime.sh apart controleren (review PR #304)
All checks were successful
CI / Ops-agent checks (pull_request) Successful in 16s
CI / Select checks (pull_request) Successful in 43s
CI / DB access operator (pull_request) Successful in 1m2s
CI / Deploy artifact checks (pull_request) Successful in 36s
CI / Mac foundation hermetic checks (pull_request) Successful in 2m5s
CI / Docker image build (pull_request) Successful in 3m11s
CI / Root app checks (pull_request) Successful in 6m35s
CI / Required checks (pull_request) Successful in 11s
e325d4d9ef
De pipe naar tee maskeerde zonder pipefail de exitcode van de installer; nu
eerst de exitcode (moet 0), dan het aantal WARNING:-regels (moet 0).

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

APPROVED

  • LOW — docs/runbooks/idea-276-host-rollout.md:45 — Neem ook de voltooiingscontrole uit T-228 op: exec-auditregels voor host_metrics en read_backup_status, beide met exit_code: 0. HTTP 200 en geldige JSON bewijzen op zichzelf geen succesvolle procesexit. Niet blokkerend omdat de volledige bewijscriteria expliciet naar het gekoppelde taakplan worden verwezen.

Plan gekoppeld via pr_refs; references: T-227, T-228, ST-086. Geen omitted onderdelen. Deze PR levert een runbook; de daadwerkelijke host-rollout en het bijbehorende meetbewijs worden hiermee niet als voltooid beschouwd. Binnen die scope is de diff plan-conform.

Verificatie: PR-head opgehaald en gecontroleerd; repository-diff exact gelijk aan de payload; git diff --check geslaagd; alle vier Bash-blokken slagen voor bash -n. Commando’s getoetst aan installer, drift-runtime, wrapper, agent-client en capability-resolutie, plus de IDEA-276-productdocumentatie. Geen runtimecode gewijzigd; geen hostmutaties of productietests uitgevoerd.

# APPROVED - **LOW — docs/runbooks/idea-276-host-rollout.md:45** — Neem ook de voltooiingscontrole uit T-228 op: exec-auditregels voor `host_metrics` en `read_backup_status`, beide met `exit_code: 0`. HTTP 200 en geldige JSON bewijzen op zichzelf geen succesvolle procesexit. Niet blokkerend omdat de volledige bewijscriteria expliciet naar het gekoppelde taakplan worden verwezen. Plan gekoppeld via pr_refs; references: T-227, T-228, ST-086. Geen omitted onderdelen. Deze PR levert een runbook; de daadwerkelijke host-rollout en het bijbehorende meetbewijs worden hiermee niet als voltooid beschouwd. Binnen die scope is de diff plan-conform. Verificatie: PR-head opgehaald en gecontroleerd; repository-diff exact gelijk aan de payload; `git diff --check` geslaagd; alle vier Bash-blokken slagen voor `bash -n`. Commando’s getoetst aan installer, drift-runtime, wrapper, agent-client en capability-resolutie, plus de IDEA-276-productdocumentatie. Geen runtimecode gewijzigd; geen hostmutaties of productietests uitgevoerd.
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!304
No description provided.