feat(dispatch): host refresher for the Codex ChatGPT login (M45 T-2013) #112

Merged
janpeter merged 5 commits from feat/m45-codex-auth-refresher into master 2026-10-06 08:19:46 +02:00
Owner

Host-side refresher that keeps the Codex review slot's dedicated ChatGPT login valid.

  • bin/dispatch-codex-auth-refresh.sh + .mjs helper, hourly systemd timer (deploy/systemd/, not installed).
  • Converges three states every tick: canonical login fresh → derived child source published → broker pinned (pinned.sha256, written only after a verified restart: socket present, unit still active after 15 s, NRestarts unchanged). No-op only when all three hold; deferred publication and failed restarts are picked up on the next tick.
  • Refresh via codex app-server → account/read {refreshToken:true} in a short-lived model-image container (--user 0); never waits for the slot. Publish/restart only on a free slot: no container matching ^/?s4m-dispatch-<uuid>$ and the slot label (supervisor/egress carry the label too).
  • Due = access-token exp − margin (last_refresh+8d only without a readable exp); margin = min(24 h, lifetime/2) with floor max(1 h, 2×maxDurationSeconds); impossible margin → CODEX_AUTH_MARGIN_INVALID.
  • Flags --publish-only, --mark-pinned, --force-refresh. Never touches DISPATCH_ENABLED; never prints a token.
  • Derived source 0644 in a root-owned 0700 dir (the broker's fs.cp drops the group).

Plan: Scrum4Me docs/plans/M45-codex-review-chatgpt-abonnement.md §4.3, §5.1. Task T-2013 (ST-1632).

Verification: 16 refresher tests pass (fake docker/systemctl/flock; RED checks for prefix-only and label-only slot filters, marker logic, pre-rename re-check, NRestarts); shellcheck clean; npm test only the 2 known macOS failures. The RPC client was run against the real codex 0.160.0 binary (handshake ok; without a login it correctly reports CODEX_AUTH_RPC_NOT_CHATGPT); the live refresh itself is proven in T-2011 P3 and again at rollout.

No deploy in this PR.

🤖 Generated with Claude Code

Host-side refresher that keeps the Codex review slot's dedicated ChatGPT login valid. - `bin/dispatch-codex-auth-refresh.sh` + `.mjs` helper, hourly systemd timer (`deploy/systemd/`, not installed). - Converges three states every tick: canonical login fresh → derived child source published → broker pinned (`pinned.sha256`, written only after a verified restart: socket present, unit still active after 15 s, `NRestarts` unchanged). No-op only when all three hold; deferred publication and failed restarts are picked up on the next tick. - Refresh via `codex app-server` → `account/read {refreshToken:true}` in a short-lived model-image container (`--user 0`); never waits for the slot. Publish/restart only on a free slot: no container matching `^/?s4m-dispatch-<uuid>$` **and** the slot label (supervisor/egress carry the label too). - Due = access-token `exp` − margin (`last_refresh`+8d only without a readable exp); margin = min(24 h, lifetime/2) with floor max(1 h, 2×`maxDurationSeconds`); impossible margin → `CODEX_AUTH_MARGIN_INVALID`. - Flags `--publish-only`, `--mark-pinned`, `--force-refresh`. Never touches `DISPATCH_ENABLED`; never prints a token. - Derived source 0644 in a root-owned 0700 dir (the broker's `fs.cp` drops the group). Plan: Scrum4Me `docs/plans/M45-codex-review-chatgpt-abonnement.md` §4.3, §5.1. Task T-2013 (ST-1632). Verification: 16 refresher tests pass (fake docker/systemctl/flock; RED checks for prefix-only and label-only slot filters, marker logic, pre-rename re-check, NRestarts); shellcheck clean; `npm test` only the 2 known macOS failures. The RPC client was run against the real `codex` 0.160.0 binary (handshake ok; without a login it correctly reports `CODEX_AUTH_RPC_NOT_CHATGPT`); the live refresh itself is proven in T-2011 P3 and again at rollout. No deploy in this PR. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Keeps one canonical login valid and publishes a derived auth.json (refresh_token
empty) for the review child. The broker pins sources at start, so a publish needs
a broker restart; the script converges three states per tick (canonical fresh,
published, pinned via a marker written only after a verified restart) and only
publishes/restarts on a slot with no attempt container.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Fake docker always lists supervisor and egress with the slot label, so a filter on
label or prefix alone goes RED. Covers the two-tick convergence cases, flags,
NRestarts readiness, the margin guard and token-free output.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Documents paths, states, flags, one-time setup, the B1 revision and the residual
broker-restart risk.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
fix(dispatch): derived Codex source 0644 root, unit runs from the dispatch checkout
All checks were successful
CI / Compose config (pull_request) Successful in 9s
CI / Build-arg coverage (pull_request) Successful in 9s
CI / Docker build (pull_request) Successful in 2m36s
05f6af8959
The broker copies operator sources with fs.cp, which keeps the mode but not the
group, so root:10001 0640 would leave the copy unreadable for the uid-10001 child.
Use the documented rule for codex_api_key: 0644 in a root-owned 0700 dir. The
brokers run from scrum4me-docker-dispatch, so the unit points there.

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

REQUEST_CHANGES

  • ERROR (blokkerend) — bin/dispatch-codex-auth-refresh.sh:132: need_restart vergelijkt alleen de marker met de doelhash. Als de gepubliceerde bron beschadigd/verwijderd is maar de canonieke login en marker nog overeenkomen, publiceert het script opnieuw zonder herstart. De rename geeft een nieuwe inode, terwijl pinSource en de create-controle in lib/dispatch-runtime-broker.ts:209 ook de inode vastleggen/controleren. Reviews worden daardoor geweigerd; volgende ticks melden no-op en herstellen dit niet. Maak de marker vóór vervanging ongeldig en zorg dat herpublicatie een herpin vereist (met behoud van --publish-only), ook wanneer de herstart faalt of de run tussentijds stopt. Voeg regressiedekking toe voor herstel met dezelfde doelhash en voor herstartfalen in dat geval.

Plan gekoppeld via pr_refs (product Scrum4Me). Verwijzingen: T-2013 (Scrum4Me), T-2011 (Scrum4Me), ST-1632 (Scrum4Me). Er is niets vermeld onder omitted. Beoordeeld als increment 2 / T-2013; kind-adapter, uitrol en story-afsluiting vallen buiten deze PR. De volledige door de PR aangehaalde plansectie §5.1 bevestigt dat alleen access-token-expiry meetelt en last_refresh + 8 dagen een fallback is; dit is dus geen plan-afwijking ondanks de oudere samenvatting in de payload. Het gevonden pin-herstelprobleem schendt wel de vereiste convergentie van gepubliceerd en gepind.

Verificatie op head 05f6af8959e18f31eb83fb27399064134037e063: 16 bestaande refreshertests slagen; een aanvullende gerichte reproductie bevestigt een gewijzigde inode en nul brokerherstarts en faalt op de verwachte herstart. Vanwege /tmp-noexec zijn uitsluitend de nep-docker/systemctl/flock via geëxporteerde Bash-functies met Bash uitgevoerd. Bash- en Node-syntaxchecks slagen. Geen volledige npm-suite, live refresh of uitrol uitgevoerd. Productstandaarden uit architecture/overview en runbooks/agent-guidance geraadpleegd.

# REQUEST_CHANGES - **ERROR (blokkerend) — bin/dispatch-codex-auth-refresh.sh:132:** `need_restart` vergelijkt alleen de marker met de **doelhash**. Als de gepubliceerde bron beschadigd/verwijderd is maar de canonieke login en marker nog overeenkomen, publiceert het script opnieuw zonder herstart. De rename geeft een nieuwe inode, terwijl `pinSource` en de create-controle in `lib/dispatch-runtime-broker.ts:209` ook de inode vastleggen/controleren. Reviews worden daardoor geweigerd; volgende ticks melden no-op en herstellen dit niet. Maak de marker vóór vervanging ongeldig en zorg dat herpublicatie een herpin vereist (met behoud van `--publish-only`), ook wanneer de herstart faalt of de run tussentijds stopt. Voeg regressiedekking toe voor herstel met dezelfde doelhash en voor herstartfalen in dat geval. Plan gekoppeld via pr_refs (product Scrum4Me). Verwijzingen: T-2013 (Scrum4Me), T-2011 (Scrum4Me), ST-1632 (Scrum4Me). Er is niets vermeld onder `omitted`. Beoordeeld als increment 2 / T-2013; kind-adapter, uitrol en story-afsluiting vallen buiten deze PR. De volledige door de PR aangehaalde plansectie §5.1 bevestigt dat alleen access-token-expiry meetelt en last_refresh + 8 dagen een fallback is; dit is dus geen plan-afwijking ondanks de oudere samenvatting in de payload. Het gevonden pin-herstelprobleem schendt wel de vereiste convergentie van gepubliceerd en gepind. Verificatie op head `05f6af8959e18f31eb83fb27399064134037e063`: 16 bestaande refreshertests slagen; een aanvullende gerichte reproductie bevestigt een gewijzigde inode en nul brokerherstarts en faalt op de verwachte herstart. Vanwege `/tmp`-noexec zijn uitsluitend de nep-docker/systemctl/flock via geëxporteerde Bash-functies met Bash uitgevoerd. Bash- en Node-syntaxchecks slagen. Geen volledige npm-suite, live refresh of uitrol uitgevoerd. Productstandaarden uit architecture/overview en runbooks/agent-guidance geraadpleegd.
fix(dispatch): refresher pins on sha256 plus inode, so a republish always re-pins
All checks were successful
CI / Compose config (pull_request) Successful in 4s
CI / Build-arg coverage (pull_request) Successful in 9s
CI / Docker build (pull_request) Successful in 1m25s
63556e5d39
Review #112: the marker held only the target sha. A lost or corrupt derived file
with an unchanged canonical login was republished (new inode) without a broker
restart, and the broker, which pins the inode too, then refused every create while
later ticks reported a no-op. The marker now records "<sha256> <inode>" of the
derived file; any publish forces the restart, and a failed restart leaves the old
marker so the next tick retries. Regression tests: lost file, corrupt file with a
failing restart then recovery, equal bytes behind a new inode.

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

COMMENT

  • INFO — tests/dispatch-codex-auth-refresh.test.ts:115 — De 19 refreshertests konden hier niet draaien: de reviewcheckout staat op een noexec-mount; Vitest faalt bij het laden van de native Rolldown-binding. Daardoor is de groene testclaim niet onafhankelijk bevestigd. Dit is een verificatiebeperking, geen aangetoond codeprobleem.

Geen blokkerende bevinding gevonden in de diff. Slotfiltering, herpublicatie met nieuwe inode, herstel na een mislukte herstart, flags en operatorinstructies passen bij de bestaande brokerpins en het refresherontwerp. Dispatch-typecheck, bash -n en node --check slagen op commit 63556e5d39dc1d746c3432b516f7793ccd1d2108. De volledige testsuite en live refresh zijn niet onafhankelijk bevestigd; daarom geen APPROVED.

plan gekoppeld via pr_refs (product Scrum4Me). References: T-2013 (Scrum4Me), T-2011 (Scrum4Me), ST-1632 (Scrum4Me). Er is niets omitted. Het taakplan bevat nog de oorspronkelijke 8-dagenregel; het bronplan op branch claude/review-loop-api-key-278c11, §5.1, wijzigt die expliciet op basis van P2(b)/(c): access-token-expiry is leidend, met last_refresh als fallback. De diff volgt die wijziging. Deze PR rondt uitsluitend T-2013 af; kind-adapter, uitrol, live rotatie en overige storyacceptatie vallen onder andere increments en zijn hier geen blokkade.

Productstandaarden: de architectuur-overview en agent-guide zijn gelezen; de productdoc-zoekopdracht naar dispatch leverde geen resultaten. De concrete dispatchconventies zijn daarom ook tegen de bestaande brokerimplementatie en operatordoc gecontroleerd.

# COMMENT - **INFO — __tests__/dispatch-codex-auth-refresh.test.ts:115** — De 19 refreshertests konden hier niet draaien: de reviewcheckout staat op een `noexec`-mount; Vitest faalt bij het laden van de native Rolldown-binding. Daardoor is de groene testclaim niet onafhankelijk bevestigd. Dit is een verificatiebeperking, geen aangetoond codeprobleem. Geen blokkerende bevinding gevonden in de diff. Slotfiltering, herpublicatie met nieuwe inode, herstel na een mislukte herstart, flags en operatorinstructies passen bij de bestaande brokerpins en het refresherontwerp. Dispatch-typecheck, `bash -n` en `node --check` slagen op commit `63556e5d39dc1d746c3432b516f7793ccd1d2108`. De volledige testsuite en live refresh zijn niet onafhankelijk bevestigd; daarom geen APPROVED. plan gekoppeld via pr_refs (product Scrum4Me). References: T-2013 (Scrum4Me), T-2011 (Scrum4Me), ST-1632 (Scrum4Me). Er is niets omitted. Het taakplan bevat nog de oorspronkelijke 8-dagenregel; het bronplan op branch `claude/review-loop-api-key-278c11`, §5.1, wijzigt die expliciet op basis van P2(b)/(c): access-token-expiry is leidend, met last_refresh als fallback. De diff volgt die wijziging. Deze PR rondt uitsluitend T-2013 af; kind-adapter, uitrol, live rotatie en overige storyacceptatie vallen onder andere increments en zijn hier geen blokkade. Productstandaarden: de architectuur-overview en agent-guide zijn gelezen; de productdoc-zoekopdracht naar dispatch leverde geen resultaten. De concrete dispatchconventies zijn daarom ook tegen de bestaande brokerimplementatie en operatordoc gecontroleerd.
Author
Owner

Review 1048 verwerkt in 63556e5: de marker legt nu <sha256> <inode> vast (de identiteit die de broker pint), dus elke herpublicatie — ook met gelijke bytes — dwingt een herstart; een mislukte herstart laat de oude marker staan en de volgende tick herstelt. Regressietests: verloren bestand, corrupt bestand + falende herstart → herstel, gelijke bytes achter nieuwe inode (RED op de oude logica: 3 failures). 19/19 refresher-tests, shellcheck schoon.

Review 1048 verwerkt in 63556e5: de marker legt nu `<sha256> <inode>` vast (de identiteit die de broker pint), dus elke herpublicatie — ook met gelijke bytes — dwingt een herstart; een mislukte herstart laat de oude marker staan en de volgende tick herstelt. Regressietests: verloren bestand, corrupt bestand + falende herstart → herstel, gelijke bytes achter nieuwe inode (RED op de oude logica: 3 failures). 19/19 refresher-tests, shellcheck schoon.
janpeter merged commit d87b6aae0b into master 2026-10-06 08:19:46 +02:00
janpeter deleted branch feat/m45-codex-auth-refresher 2026-10-06 08:19:46 +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!112
No description provided.