docs(operator): model-image vervangen en uitrol IDEA-252 #134

Merged
janpeter merged 2 commits from claude/idea-252-rollout-record into master 2026-10-13 00:15:50 +02:00
Owner

IDEA-252, PBI-38, task T-185. Docs only.

  • Procedure: a new model image is never just a restart. Each slot needs a new profile revision, because the profile carries image_digest, plus a slot binding, a host switch inside a maintenance window and, when broker code changed, the native broker checkout. The doc now describes that procedure with its rollback path.
  • Rollout record: both review slots moved to the idea252 images on 2026-10-12 22:03 UTC. Codex runs revision 9, Claude revision 7, and the broker runs d89ecc6. The previous revisions (Codex 8, Claude 6) are not revoked yet; they are the rollback until the follow-up measurement (T-180) proves a live review.

🤖 Generated with Claude Code

IDEA-252, PBI-38, task T-185. Docs only. - **Procedure:** a new model image is never just a restart. Each slot needs a new profile revision, because the profile carries `image_digest`, plus a slot binding, a host switch inside a maintenance window and, when broker code changed, the native broker checkout. The doc now describes that procedure with its rollback path. - **Rollout record:** both review slots moved to the idea252 images on 2026-10-12 22:03 UTC. Codex runs revision 9, Claude revision 7, and the broker runs d89ecc6. The previous revisions (Codex 8, Claude 6) are not revoked yet; they are the rollback until the follow-up measurement (T-180) proves a live review. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs(operator): model-image vervangen en uitrol IDEA-252 vastgelegd
All checks were successful
CI / Compose config (pull_request) Successful in 3s
CI / Build-arg coverage (pull_request) Successful in 10s
CI / Scanner gelijk aan bron (pull_request) Successful in 10s
CI / Docker build (pull_request) Successful in 1m29s
a539a3397a
Een nieuw model-image vraagt per slot een profielrevisie, slotbinding en
host-wissel in een onderhoudsvenster; nu beschreven met terugrolpad.
Uitrol 2026-10-12: codex rev 9 / claude rev 7 op de idea252-images.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
s4m-codex-reviewer requested changes 2026-10-13 00:07:29 +02:00
Dismissed
s4m-codex-reviewer left a comment

REQUEST_CHANGES

Findings

  • error (blokkerend) — docs/dispatch-runtime-operator.md:114: De procedure zet DISPATCH_ENABLED=0 in activation.env en stopt de Codex auth-refreshtimer, maar bevat geen stap die beide herstelt. De afsluitende herstart van egress, broker en supervisor laat de centrale dispatch dus uitgeschakeld; een gestopte timer vernieuwt bovendien de subscription-credential niet meer. Voeg na readiness-controles expliciet het herstel van de oorspronkelijke activatiewaarde met de bijbehorende scrum4me-dispatch-restart en het hervatten van de eerder actieve timer toe. Dit moet ook gelden voor de rollbackprocedure.

Plan en scope

plan gekoppeld via pr_refs (product scrum4me-mcp), referentie: T-185 (scrum4me-mcp), story ST-059. Geen omitted onderdelen. Deze PR documenteert de uitrol en het terugrolrecept; de prompts en implementatie horen bij eerdere PR's. De nameting T-180/ST-061 blijft volgens de PR-beschrijving vervolgwerk en is geen blokkerende scope-omissie. Datum, oude/nieuwe image-identificaties, profielrevisies, CLI-versies en MCP-commit zijn opgenomen. Voeg bij het terugrolrecept bij voorkeur ook de geplande trigger toe: DISPATCH_CHILD_RESULT_MISSING of een nameting zonder verdict.

Verificatie

Actuele PR-head geverifieerd: a539a3397a; uitsluitend 17 toegevoegde documentatieregels. Product-docs voor architectuur en image-redeploy geraadpleegd; profiel- en egressbinding getoetst aan de brokerimplementatie. git diff --check en npm run typecheck:dispatch geslaagd. npm test: 88 bestanden geslaagd, 1326 tests geslaagd, 8 overgeslagen. De eerste testpoging miste de submodule; na initialisatie slaagde de volledige suite. Docker-imageprobes, live smoke en productie-uitrol zijn hier niet opnieuw uitgevoerd; hun uitkomsten zijn claims uit het uitrolrecord.

# REQUEST_CHANGES ## Findings - **error (blokkerend)** — `docs/dispatch-runtime-operator.md:114`: De procedure zet `DISPATCH_ENABLED=0` in `activation.env` en stopt de Codex auth-refreshtimer, maar bevat geen stap die beide herstelt. De afsluitende herstart van egress, broker en supervisor laat de centrale dispatch dus uitgeschakeld; een gestopte timer vernieuwt bovendien de subscription-credential niet meer. Voeg na readiness-controles expliciet het herstel van de oorspronkelijke activatiewaarde met de bijbehorende `scrum4me-dispatch`-restart en het hervatten van de eerder actieve timer toe. Dit moet ook gelden voor de rollbackprocedure. ## Plan en scope plan gekoppeld via pr_refs (product scrum4me-mcp), referentie: T-185 (scrum4me-mcp), story ST-059. Geen omitted onderdelen. Deze PR documenteert de uitrol en het terugrolrecept; de prompts en implementatie horen bij eerdere PR's. De nameting T-180/ST-061 blijft volgens de PR-beschrijving vervolgwerk en is geen blokkerende scope-omissie. Datum, oude/nieuwe image-identificaties, profielrevisies, CLI-versies en MCP-commit zijn opgenomen. Voeg bij het terugrolrecept bij voorkeur ook de geplande trigger toe: DISPATCH_CHILD_RESULT_MISSING of een nameting zonder verdict. ## Verificatie Actuele PR-head geverifieerd: a539a3397a19fdb298cdad57016ee4eb69e822fa; uitsluitend 17 toegevoegde documentatieregels. Product-docs voor architectuur en image-redeploy geraadpleegd; profiel- en egressbinding getoetst aan de brokerimplementatie. `git diff --check` en `npm run typecheck:dispatch` geslaagd. `npm test`: 88 bestanden geslaagd, 1326 tests geslaagd, 8 overgeslagen. De eerste testpoging miste de submodule; na initialisatie slaagde de volledige suite. Docker-imageprobes, live smoke en productie-uitrol zijn hier niet opnieuw uitgevoerd; hun uitkomsten zijn claims uit het uitrolrecord.
docs(operator): onderhoudsvenster expliciet sluiten, ook bij terugrollen
All checks were successful
CI / Compose config (pull_request) Successful in 3s
CI / Build-arg coverage (pull_request) Successful in 8s
CI / Scanner gelijk aan bron (pull_request) Successful in 8s
CI / Docker build (pull_request) Successful in 5s
9bbe7dcdf3
Review #134: de procedure zette intake uit en stopte de refresh-timer
zonder herstelstap. Stap 5 herstelt beide en controleert liveness;
terugrollen noemt nu ook zijn trigger.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Author
Owner

Fixed in 9bbe7dc. Step 5 now closes the maintenance window: it restores DISPATCH_ENABLED, restarts scrum4me-dispatch, starts the Codex auth refresh timer again and checks that every slot reads live. The rollback path names steps 1 to 5 and its trigger: DISPATCH_CHILD_RESULT_MISSING, or no verdict on the first live review. On the host the window was already closed after this rollout: DISPATCH_ENABLED=1, the timer is active and both slots read live.

Fixed in 9bbe7dc. Step 5 now closes the maintenance window: it restores DISPATCH_ENABLED, restarts scrum4me-dispatch, starts the Codex auth refresh timer again and checks that every slot reads live. The rollback path names steps 1 to 5 and its trigger: DISPATCH_CHILD_RESULT_MISSING, or no verdict on the first live review. On the host the window was already closed after this rollout: DISPATCH_ENABLED=1, the timer is active and both slots read live.
s4m-codex-reviewer left a comment

REQUEST_CHANGES

Findings:

  • error — docs/dispatch-runtime-operator.md:114: Het uitrolrecept vervangt de egress-volume en -container, maar noemt niet het bijwerken van broker.json.egress.volumeName en broker.json.egress.proxyContainerId. De broker inspecteert uitsluitend die geconfigureerde bindings en vereist het nieuwe profiel-label (lib/dispatch-runtime-broker.ts:110-129). Alleen image en profileSha256 wijzigen laat hem de oude egress inspecteren en nieuwe attempts weigeren. Voeg de nieuwe volumenaam en het volledige container-ID expliciet toe aan de uitrol- én terugrolstappen.

Plan gekoppeld via pr_refs (product scrum4me-mcp), referentie: T-185 (scrum4me-mcp), story ST-059. De PR beperkt zich tot het operatorrecept en de uitrolregistratie; de nameting T-180/ST-061 is volgens de PR-beschrijving vervolgwerk en geldt hier niet als ontbrekende implementatie. Er zijn geen omitted onderdelen. Datum, oude/nieuwe images, CLI-versies en MCP-commit staan in het record; de beschreven uitrol en rollback zijn door bovenstaande finding nog niet volledig uitvoerbaar.

Verificatie: Forgejo-PR en head-SHA opgelost; checkout-diff is exact gelijk aan de aangeleverde diff; git diff --check slaagt. Product-docs en de brokercontroles gelezen. Alleen Markdown gewijzigd; geen runtime-tests of productie-uitrol uitgevoerd. De probe- en smoke-uitkomsten in het record zijn claims uit de PR, niet onafhankelijk herhaald.

# REQUEST_CHANGES Findings: - **error — docs/dispatch-runtime-operator.md:114:** Het uitrolrecept vervangt de egress-volume en -container, maar noemt niet het bijwerken van `broker.json.egress.volumeName` en `broker.json.egress.proxyContainerId`. De broker inspecteert uitsluitend die geconfigureerde bindings en vereist het nieuwe profiel-label (`lib/dispatch-runtime-broker.ts:110-129`). Alleen `image` en `profileSha256` wijzigen laat hem de oude egress inspecteren en nieuwe attempts weigeren. Voeg de nieuwe volumenaam en het volledige container-ID expliciet toe aan de uitrol- én terugrolstappen. Plan gekoppeld via pr_refs (product scrum4me-mcp), referentie: T-185 (scrum4me-mcp), story ST-059. De PR beperkt zich tot het operatorrecept en de uitrolregistratie; de nameting T-180/ST-061 is volgens de PR-beschrijving vervolgwerk en geldt hier niet als ontbrekende implementatie. Er zijn geen omitted onderdelen. Datum, oude/nieuwe images, CLI-versies en MCP-commit staan in het record; de beschreven uitrol en rollback zijn door bovenstaande finding nog niet volledig uitvoerbaar. Verificatie: Forgejo-PR en head-SHA opgelost; checkout-diff is exact gelijk aan de aangeleverde diff; `git diff --check` slaagt. Product-docs en de brokercontroles gelezen. Alleen Markdown gewijzigd; geen runtime-tests of productie-uitrol uitgevoerd. De probe- en smoke-uitkomsten in het record zijn claims uit de PR, niet onafhankelijk herhaald.
janpeter merged commit 5614ada5d2 into master 2026-10-13 00:15:50 +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/scrum4me-docker!134
No description provided.