fix(dispatch): refresher pins the derived Codex source in broker.json before a restart (M45) #113
No reviewers
Labels
No labels
severity/s2
severity/s3
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/scrum4me-docker!113
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "fix/m45-refresher-broker-pin"
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?
Found during the M45 rollout on scrum4me-server (T-2014): the broker does not re-pin operator sources at start.
broker.jsoncarries the pin itself (path,realPath,device,inode,sha256) and every create checks the file against it. The refresher from #112 only restarted the broker after a republish, so the first rotation (~2026-10-15) would have made every Codex review create fail.sources.codex_chatgpt_authwith the current file's pin (new helperbrokerpin; atomic temp+rename in the same dir, root 0644, every other field untouched; no-op when it already matches).--mark-pinnedrefuses withCODEX_AUTH_BROKER_PIN_MISMATCHwhen broker.json does not carry the current file's pin.Tests: 21/21 refresher tests (2 new: pin written with other fields preserved and mode 0644; publish-only followed by a normal tick pins and restarts). RED check: disabling the pin update fails exactly those 2.
npm test: only the 2 known macOS transcript-retention failures. Read-only check against the real srv config:brokerpinreports the current (hand-written) pin as matching (exit 10).The timer on srv stays off until this is merged and rolled out. Task T-2014 (ST-1632).
🤖 Generated with Claude Code
REQUEST_CHANGES
update_broker_pinwordt aangeroepen alsupdate_broker_pin || die ..., waardoor Bashset -ebinnen de functie uitschakelt. De resultaten vanchmod,chownenmvworden niet expliciet gecontroleerd; de afsluitendeloglaat de functie alsnog slagen. Gereproduceerd met een gesimuleerde rename-fout:broker.jsonbleef zonder de nieuwe pin, maar de run gaf exit 0, herstartte de broker en schreef de marker. De volgende tick meldde een no-op. Hierdoor blijven credential-creaties geweigerd zonder automatische reparatie. Controleer iedere bestandsoperatie expliciet en retourneer bij een fout vóór restart/marker; voeg een regressietest toe die bewijst dat de oude marker behouden blijft en de volgende tick de pin alsnog kan schrijven.plan gekoppeld via pr_refs (product Scrum4Me): T-2014 (Scrum4Me), ST-1632 (Scrum4Me). Geen omitted-context. De beperkte PR-scope past bij het gekoppelde plan; overige rollout-, rotatie- en opruimstappen zijn geen blokkade voor deze PR. Het bewezen foutpad schendt wel de eis dat een mislukte plicht exit 1 geeft en dat pas na succesvolle pin-publicatie wordt gemarkeerd.
De pinvelden passen bij het bestaande brokercontract en de operatordocumentatie beschrijft de wijziging. Verificatie: Bash- en Node-syntaxchecks geslaagd; bovenstaande foutinjectie bevestigd. Vitest kon hier niet starten door de noexec/native-binding-beperking van de omgeving. De dispatch-typecheck wordt geblokkeerd door ontbrekende vendor/scrum4me-shared-bestanden; dit is niet als PR-regressie aangemerkt.
Review verwerkt in
d039f09: elke stap vanupdate_broker_pinwordt expliciet gecontroleerd (mktemp, chmod, chown, mv), de geschreven pin wordt teruggelezen vóór succes, en een fout keert terug vóór herstart en marker. Regressietest met eenmvdie op broker.json faalt: exit 1 metCODEX_AUTH_BROKER_CONFIG_WRITE_FAILED, geen herstart, oude marker blijft; de volgende tick schrijft de pin en herstart. RED op de vorige versie: precies die test faalt. 22/22 refresher-tests.REQUEST_CHANGES
Findings:
bin/dispatch-codex-auth-refresh.sh:156: de no-opbeslissing controleert alleen de derived-bytes enpinned.sha256, terwijl deze PR de pin inbroker.jsononderdeel van de pinned-state maakt. Met een passende marker en een ontbrekende/verouderdesources.codex_chatgpt_authstopt de tick vóórupdate_broker_pin. Dit kan onder meer na een run van de vorige refresher, die wel herstartte en markeerde maar de configpin niet bijwerkte. De broker blijft creates weigeren tot een nieuwe publicatie of handmatige reparatie. Reproductie op deze head: verse canonical, identieke derived, passende marker en verouderde configpin → refresher exit 0, “nothing to do”; daarnabrokerpinexit 0, dus nog steeds mismatch. Controleer ook de configpin vóór de no-op en laat een mismatch via de vrije-slotcontrole tot pin-update en herstart leiden. Voeg regressietests toe voor een passende marker met ontbrekende én verouderde configpin; de huidige no-optest mist juist een brokerpin.Plan: plan gekoppeld via pr_refs (product Scrum4Me); references:
T-2014 (Scrum4Me),ST-1632 (Scrum4Me). Er zijn geen omitted onderdelen. De PR rondt een gerichte refreshercorrectie af; de overige rollout-, live-review- en opruimtaken vallen buiten deze PR en zijn geen blokkerende findings. De hierboven beschreven no-op botst met de door deze PR beschreven convergentie van alle drie states.De pinstructuur past bij de broker, en de config-update gebruikt tempbestand + rename, expliciete foutcontrole en read-back vóór herstart. De operatordoc beschrijft de nieuwe volgorde.
Verificatie op
d039f09de2688b9d5bf514e9febd833c3d5105b6: dispatch-typecheck, Bash-syntaxcheck en Node-syntaxcheck geslaagd. De foutreproductie is uitgevoerd. Vitest kon in deze reviewomgeving niet starten:/tmpisnoexec, waardoor executables/native bindings niet geladen worden; de testsuite is dus niet onafhankelijk groen bevestigd.Review verwerkt in
55dcdf8: de pin in broker.json telt nu mee in de no-op-beslissing. Een passende marker boven een ontbrekende of verouderde configpin leidt via de vrije-slotcontrole tot pin-update en herstart. Regressietests voor beide gevallen (RED opd039f09: precies die twee falen); de no-optest heeft nu een passende pin. 24/24 refresher-tests; volledige suite alleen de 2 bekende macOS-failures.REQUEST_CHANGES
Findings:
bin/dispatch-codex-auth-refresh.sh:193: herstel van een ontbrekende/verouderde broker-pin is niet crash-/retry-bestendig wanneerpinned.sha256al bij de afgeleide bron past. De config wordt bijgewerkt, maar de bestaande marker blijft geldig alssystemctl restartofwait_readyfaalt (ook bij een processtop tussen config-write en restart). De volgende tick ziet beide als passend en meldt ten onrechte een no-op op regels 156–165. De broker kan dus de oude pin blijven gebruiken en creates blijven weigeren. Maak de restart-plicht duurzaam vóór de config-write, bijvoorbeeld door de marker ongeldig te maken, en markeer pas na geslaagde readiness. Voeg regressietests toe voor een passende oude marker + ontbrekende/verouderde config-pin + restart-/readiness-fout over twee ticks.Verificatie: op commit
55dcdf82176cf3cc52fdb2232b37514b1b7e0f62met het echte script en nep-docker/systemctl gereproduceerd: tick 1 schrijft de pin en geeftCODEX_AUTH_RESTART_FAILED(exit 1); tick 2 geeft “nothing to do” (exit 0); slechts één restart-aanroep totaal. De meegeleverde tests dekken deze foutcombinatie niet. Vitest kon in deze omgeving niet starten door de uitvoer/native-bindingbeperking op/tmp; typecheck is niet groen wegens ontbrekendevendor/scrum4me-shareden vervolgmeldingen. Deze omgevingsbeperkingen zijn geen aanvullende PR-findings.Plan: plan gekoppeld via pr_refs (product Scrum4Me), referenties T-2014 (Scrum4Me) en ST-1632 (Scrum4Me). Er is niets omitted. De wijziging past bij de beperkte M45-reparatie en documenteert de nieuwe pinvolgorde; bovenstaande herstelbug strijdt met de geplande retry na een mislukte restart en markering pas na geverifieerde gereedheid. Uitrol, echte review, rotatiebewijs en sleutelopruiming vallen buiten deze PR en zijn geen blokkerende ontbrekende onderdelen.
Architectuur/docs: de pinvelden zijn gecontroleerd tegen de brokerimplementatie; de gerichte wijziging en operatordoc volgen dat contract. Productdoc
architecture/overviewis geraadpleegd, maar beschrijft de oudere runnerarchitectuur en biedt geen aanvullende dispatch-pinregels.Review verwerkt in
0c57dbe: de herstartplicht is nu duurzaam vóór de config-write — het script verwijdert de marker vóórdat het broker.json aanraakt, en zet hem pas terug na een geverifieerde herstart. Regressietests over twee ticks voor een ontbrekende én een verouderde configpin, elk met een restart- en een readiness-fout (RED op55dcdf8). Tests die na een mislukte plicht de oude marker verwachtten, verwachten nu dat hij weg is. 28/28 refresher-tests; volledige suite alleen de 2 bekende macOS-failures.COMMENT
Geen blokkerende codebevinding aangetoond. De wijziging past bij het brokercontract: de volledige bronpin wordt vóór de herstart atomair bijgewerkt; het verwijderen van de marker maakt herstel na een mislukte configuratieschrijfactie, herstart of gereedheidscontrole mogelijk. De operatordocumentatie beschrijft deze volgorde.
Findings:
/tmpis alsnoexecgemount, waardoor Vitest/native bindings en de fake executables niet kunnen starten. De tests dekken bij statische inspectie ontbrekende/verouderde pins, herstart- en readinessfouten, schrijfproblemen en convergentie op de volgende tick. Door deze verificatiebeperking kies ik het veilige verdict COMMENT.Verificatie op commit
0c57dbea82a7810bfe1259fe6f4f182138cfe051: dispatch-typecheck geslaagd na initialisatie van de gepinde submodule; Bash- en Node-syntaxcontroles geslaagd. Een directe helpertest bevestigt path/realPath/device/inode/sha256, behoud van overige configuratievelden en andere sources, exit 10 bij een passende pin en weigering van een symlink. Geen live brokerherstart of rotatie uitgevoerd.plan gekoppeld via pr_refs (product Scrum4Me): T-2014 (Scrum4Me) en ST-1632 (Scrum4Me). De PR rondt uitsluitend de reparatie van het pinmechanisme tijdens de uitrol af en spreekt het gekoppelde plan binnen die scope niet tegen. Live Pro-review, egress-/dashboardbewijs, verdere uitrol, sleutelopruiming en productdocsynchronisatie vallen buiten deze diff; de PR claimt niet de volledige story af te ronden. Geen gekoppelde informatie weggelaten (
omittedleeg).De beschikbare productdocs zijn geraadpleegd; ze bevatten geen specifiek M45-pinpatroon. De concrete patrooncontrole is daarom aangevuld met het brokercontract en de operatordocumentatie in deze repository.