chore: release v2.3.0-beta.0 (#509 sequential drain-first) (#511)

Prerelease that ships the opt-in sequential / drain-first account scheduling mode from issue #509 to npm under the beta dist-tag. Set schedulingStrategy=sequential (or CODEX_AUTH_SCHEDULING_STRATEGY=sequential) to drain one account fully before advancing to the next, staggering quota-window recovery across the pool for longer uninterrupted sessions. Default hybrid behavior is unchanged; the mode is fully opt-in. Manual pin still wins and per-session affinity is bypassed in sequential mode.

Author: ndycode

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-multi-auth",
-  "version": "2.2.2",
+  "version": "2.3.0-beta.0",
   "description": "Install and operate codex-multi-auth for the official @openai/codex CLI with multi-account OAuth rotation, switching, health checks, and recovery tools.",
   "interface": {
     "composerIcon": "./assets/codex-multi-auth-icon.svg"

README.md

@@ -383,6 +383,7 @@ codex-multi-auth doctor --json
 
 ## Release Notes
 
+- Current prerelease: [docs/releases/v2.3.0-beta.0.md](docs/releases/v2.3.0-beta.0.md) — install via `npm i -g codex-multi-auth@beta`
 - Current stable: [docs/releases/v2.2.2.md](docs/releases/v2.2.2.md) — install via `npm i -g codex-multi-auth`
 - Previous stable: [docs/releases/v2.2.1.md](docs/releases/v2.2.1.md)
 - Previous stable: [docs/releases/v2.2.0.md](docs/releases/v2.2.0.md)

docs/README.md

@@ -32,6 +32,7 @@ Public documentation for the `codex-multi-auth` Codex CLI multi-account OAuth ma
 
 | Document | Focus |
 | --- | --- |
+| [releases/v2.3.0-beta.0.md](releases/v2.3.0-beta.0.md) | Current prerelease notes (install via `npm i -g codex-multi-auth@beta`) |
 | [releases/v2.2.2.md](releases/v2.2.2.md) | Current stable release notes (install via `npm i -g codex-multi-auth`) |
 | [releases/v2.2.1.md](releases/v2.2.1.md) | Prior stable release notes |
 | [releases/v2.2.0.md](releases/v2.2.0.md) | Prior stable release notes |

docs/releases/v2.3.0-beta.0.md

@@ -0,0 +1,42 @@
+## Runtime Rotation
+
+### Features
+
+- **Sequential / drain-first account scheduling (opt-in).** A new
+  `schedulingStrategy` setting (`CODEX_AUTH_SCHEDULING_STRATEGY` /
+  `schedulingStrategy`, default `hybrid`) adds a `sequential` mode that drains one
+  account fully before moving to the next, instead of spreading load across the
+  pool. Set it to `sequential` to keep every new request on the current active
+  account until that account is exhausted (rate-limited, cooling down, circuit-open,
+  or disabled), then advance to the next usable account. When an earlier account's
+  quota window recovers it reclaims the active slot on the next forward scan, so the
+  pool's quota windows stagger over time rather than resetting together — longer
+  uninterrupted sessions across a multi-account pool (issue #509).
+- **Default behavior is unchanged.** `hybrid` remains the default and keeps the
+  existing weighted health/token/freshness selection plus per-session affinity.
+  `sequential` is fully opt-in; pools that do not set it behave exactly as before.
+- **Manual pin still wins.** A `switch <n>` pin overrides scheduling in both modes.
+  In `sequential` mode per-session affinity is intentionally bypassed — every
+  request follows the single active account, not a per-chat sticky account.
+
+## Release Hygiene
+
+### Tests
+
+- Selector coverage for the drain-first path: sticky-while-usable, advance-on-
+  exhaustion, wrap-to-recovered-earlier-account, returns-null when the whole pool is
+  exhausted, cooldown/circuit-open/disabled failover, per-family cursor isolation,
+  and the policy-blocked-anchor guard.
+- Proxy-level coverage: affinity is ignored, manual pin takes precedence, the active
+  pointer advances only on true exhaustion (not on a transient attempted-this-request
+  skip), and the mode survives the routing-mutex select+commit path without double-
+  advancing the cursor.
+- Config coverage for `schedulingStrategy`: default, explicit value, env override in
+  both directions, and invalid env/persisted values falling back safely.
+
+### Notes
+
+- Prerelease published under the `beta` dist-tag
+  (`npm i -g codex-multi-auth@beta`). Whether drain-first delivers longer
+  uninterrupted sessions depends on each pool's real quota-window timing, which is
+  why this ships as a beta for validation on real accounts before a stable cut.

package-lock.json

@@ -1,6 +1,6 @@
 {
 	"name": "codex-multi-auth",
-	"version": "2.2.2",
+	"version": "2.3.0-beta.0",
 	"description": "Codex CLI multi-account OAuth manager with account switching, health checks, runtime rotation, diagnostics, and recovery tools for @openai/codex",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",