Skip to content

chore: release v2.1.13-beta.0 - #490

Merged
ndycode merged 1 commit into
mainfrom
release/v2.1.13-beta.0
May 27, 2026
Merged

chore: release v2.1.13-beta.0#490
ndycode merged 1 commit into
mainfrom
release/v2.1.13-beta.0

Conversation

@ndycode

@ndycode ndycode commented May 27, 2026

Copy link
Copy Markdown
Owner

Summary

Prerelease to npm beta dist-tag carrying the pinned-account 503 diagnostic surface that just merged in #487 (issue #486).

Why

Issue #486 reports a recurring codex_pinned_account_unavailable 503 while codex-multi-auth doctor shows all green. The 503 body previously omitted the runtime skip reason, so the reporter could not diagnose the cause and neither could we. PR #487 lands the structured reason and account_skip_reasons fields plus a null-reason desync marker; this release pushes that build to users who can reproduce.

The root cause (forecast vs runtime state desync) is not fixed here. Cutting a beta instead of a stable so the patch lands fast for the reporter without claiming a full fix.

Changes

  • package.json, package-lock.json, .codex-plugin/plugin.json bumped to 2.1.13-beta.0
  • docs/releases/v2.1.13-beta.0.md new release notes
  • README.md, docs/README.md link the prerelease alongside current stable (v2.1.12)

Verification

  • npm test 4020 passed, 268 files, 0 failures
  • npm run typecheck clean
  • npm run lint:ts clean

Publish plan

After merge:

git checkout main
git pull origin main
git tag v2.1.13-beta.0
git push origin v2.1.13-beta.0
npm publish --tag beta

--tag beta is critical so this does not move the latest dist-tag away from v2.1.12. Users on stable will not auto-upgrade. Only npm i -g codex-multi-auth@beta opts in.

Risk Notes

Follow-ups

Refs #486, #487.

note: greptile review for oc-chatgpt-multi-auth. cite files like lib/foo.ts:123. confirm regression tests + windows concurrency/token redaction coverage.

Greptile Summary

version-only prerelease bump — all three manifest files (package.json, package-lock.json, .codex-plugin/plugin.json) consistently move from 2.1.122.1.13-beta.0, and the new release notes document the structured 503 diagnostic fields shipped in #487.

  • version bump is internally consistent and the --tag beta publish plan correctly keeps latest pinned to v2.1.12.
  • release notes accurately describe the changes from fix(runtime): surface skip reason in pinned 503 (#486) #487 and correctly reference docs/reference/error-contracts.md, which exists and contains the new fields.
  • the known-gaps troubleshooting line should add a token-safety guard against CODEX_PLUGIN_LOG_BODIES=1 and a windows log-path note.

Confidence Score: 4/5

safe to merge; this is a version bump and docs-only release preparation with no runtime code changes.

all three manifest files are consistently bumped, the publish plan correctly uses --tag beta, and the underlying runtime fix already landed in #487. the only item worth a second look is the known-gaps troubleshooting line, which guides users toward request logging without warning that enabling body logging would expose oauth tokens to disk.

docs/releases/v2.1.13-beta.0.md — the known-gaps section needs a token-safety guard and a windows log-path note before users follow it to reproduce #486.

Security Review

  • docs/releases/v2.1.13-beta.0.md (line 36): the troubleshooting instruction tells users to enable ENABLE_PLUGIN_REQUEST_LOGGING=1 without explicitly warning against also setting CODEX_PLUGIN_LOG_BODIES=1; SECURITY.md classifies body logging as sensitive because raw OAuth bearer tokens pass through the runtime proxy and would be written to disk under ~/.codex/multi-auth/logs/.

Important Files Changed

Filename Overview
package.json version bumped from 2.1.12 → 2.1.13-beta.0; no structural changes
package-lock.json lockfile root version bumped to match package.json; no dependency changes
.codex-plugin/plugin.json plugin manifest version bumped to 2.1.13-beta.0; consistent with package.json
docs/releases/v2.1.13-beta.0.md new release notes for the beta; troubleshooting guidance in Known Gaps omits a token-safety warning for CODEX_PLUGIN_LOG_BODIES and lacks a Windows path note
README.md prerelease link added above stable; ordering and install command are correct
docs/README.md prerelease row added to the releases table; consistent with README.md change

Sequence Diagram

sequenceDiagram
    participant User
    participant Proxy as Runtime Rotation Proxy
    participant AM as AccountManager

    User->>Proxy: Codex request with pinned account
    Proxy->>AM: getAccountRuntimeSkipReason(pinnedIndex)
    AM-->>Proxy: reason or null
    alt reason present
        Proxy-->>User: 503 with reason and account_skip_reasons map
    else reason null desync
        Proxy-->>Proxy: record null in status.lastError
        Proxy-->>User: 503 with explicit reason null
    end
Loading

Fix All in Codex

Prompt To Fix All With AI
Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
docs/releases/v2.1.13-beta.0.md:36
the troubleshooting step directs users to enable request logging without warning that `CODEX_PLUGIN_LOG_BODIES=1` must **not** be set alongside it. `SECURITY.md` classifies body logging as "sensitive" because raw OAuth payloads (including bearer tokens) flow through the proxy; a frustrated user chasing a 503 might add it for more detail and inadvertently persist tokens to disk. also, the log path uses `~/` syntax which doesn't work in `cmd.exe` — windows users need the `%USERPROFILE%` equivalent.

```suggestion
- The 503 root cause from issue #486 (doctor reports all green, runtime still returns 503) is **not** fixed by this prerelease. Users who reproduce on this build should set `ENABLE_PLUGIN_REQUEST_LOGGING=1` (**do not also set `CODEX_PLUGIN_LOG_BODIES=1`** — body logs capture raw OAuth payloads and must be treated as sensitive data), repro, and attach the new 503 body plus logs from `~/.codex/multi-auth/logs/codex-plugin/` (`%USERPROFILE%\.codex\multi-auth\logs\codex-plugin\` on Windows) to issue #486.
```

Reviews (1): Last reviewed commit: "chore: release v2.1.13-beta.0" | Re-trigger Greptile

Greptile also left 1 inline comment on this PR.

Prerelease that ships the pinned-account 503 diagnostic surface from
#487 (issue #486) to npm under the `beta` dist-tag. Users who can
reproduce the recurring 503 should install via
`npm i -g codex-multi-auth@beta` so the new structured `reason` and
`account_skip_reasons` fields are visible in their next failure, then
attach the body plus logs to issue #486 for root-cause analysis.

Stable v2.1.13 will land once the underlying forecast-vs-runtime state
desync is identified and patched.
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

@coderabbitai

coderabbitai Bot commented May 27, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@ndycode, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 3 minutes and 44 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: c8f2f8de-6ce3-40e0-89d8-630a6572d8fa

📥 Commits

Reviewing files that changed from the base of the PR and between 387651c and d7142f6.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (5)
  • .codex-plugin/plugin.json
  • README.md
  • docs/README.md
  • docs/releases/v2.1.13-beta.0.md
  • package.json
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch release/v2.1.13-beta.0
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch release/v2.1.13-beta.0

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ndycode
ndycode merged commit 9807f12 into main May 27, 2026
1 of 2 checks passed
@ndycode
ndycode deleted the release/v2.1.13-beta.0 branch May 27, 2026 15:59

## Known Gaps

- The 503 root cause from issue #486 (doctor reports all green, runtime still returns 503) is **not** fixed by this prerelease. Users who reproduce on this build should set `ENABLE_PLUGIN_REQUEST_LOGGING=1`, repro, and attach the new 503 body plus logs from `~/.codex/multi-auth/logs/codex-plugin/` to issue #486.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 security the troubleshooting step directs users to enable request logging without warning that CODEX_PLUGIN_LOG_BODIES=1 must not be set alongside it. SECURITY.md classifies body logging as "sensitive" because raw OAuth payloads (including bearer tokens) flow through the proxy; a frustrated user chasing a 503 might add it for more detail and inadvertently persist tokens to disk. also, the log path uses ~/ syntax which doesn't work in cmd.exe — windows users need the %USERPROFILE% equivalent.

Suggested change
- The 503 root cause from issue #486 (doctor reports all green, runtime still returns 503) is **not** fixed by this prerelease. Users who reproduce on this build should set `ENABLE_PLUGIN_REQUEST_LOGGING=1`, repro, and attach the new 503 body plus logs from `~/.codex/multi-auth/logs/codex-plugin/` to issue #486.
- The 503 root cause from issue #486 (doctor reports all green, runtime still returns 503) is **not** fixed by this prerelease. Users who reproduce on this build should set `ENABLE_PLUGIN_REQUEST_LOGGING=1` (**do not also set `CODEX_PLUGIN_LOG_BODIES=1`** — body logs capture raw OAuth payloads and must be treated as sensitive data), repro, and attach the new 503 body plus logs from `~/.codex/multi-auth/logs/codex-plugin/` (`%USERPROFILE%\.codex\multi-auth\logs\codex-plugin\` on Windows) to issue #486.
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/releases/v2.1.13-beta.0.md
Line: 36

Comment:
the troubleshooting step directs users to enable request logging without warning that `CODEX_PLUGIN_LOG_BODIES=1` must **not** be set alongside it. `SECURITY.md` classifies body logging as "sensitive" because raw OAuth payloads (including bearer tokens) flow through the proxy; a frustrated user chasing a 503 might add it for more detail and inadvertently persist tokens to disk. also, the log path uses `~/` syntax which doesn't work in `cmd.exe` — windows users need the `%USERPROFILE%` equivalent.

```suggestion
- The 503 root cause from issue #486 (doctor reports all green, runtime still returns 503) is **not** fixed by this prerelease. Users who reproduce on this build should set `ENABLE_PLUGIN_REQUEST_LOGGING=1` (**do not also set `CODEX_PLUGIN_LOG_BODIES=1`** — body logs capture raw OAuth payloads and must be treated as sensitive data), repro, and attach the new 503 body plus logs from `~/.codex/multi-auth/logs/codex-plugin/` (`%USERPROFILE%\.codex\multi-auth\logs\codex-plugin\` on Windows) to issue #486.
```

How can I resolve this? If you propose a fix, please make it concise.

Fix in Codex

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant