fix: sync plugin manifest and docs portal to v2.3.0-beta.2 - #577

Summary

Fixes two test failures currently live on main, plus a third stale version reference the suite didn't guard. A full-suite canary run against clean main came back at 60 failures instead of the documented 58-failure environment baseline; the byte-level diff against docs/audits/evidence/test-baseline-2026-06-10.txt isolated two genuinely new, non-environmental failures, both fallout from the 2.3.0-beta.2 version bump:

• test/plugin-manifest.test.ts — .codex-plugin/plugin.json still declared 2.3.0-beta.1 while package.json says 2.3.0-beta.2.
• test/documentation.test.ts — docs/README.md's release-history table still listed v2.3.0-beta.1 as the current prerelease, so the releases/v${packageVersion}.md link assertion failed. (The root README and docs/releases/v2.3.0-beta.2.md were already updated.)

A follow-up sweep for other stale 2.3.0-beta.1 references found one more: the root AGENTS.md "Package version" header — the second time that header has drifted on a version bump (the audit's M6 caught it at 2.2.0), because nothing guards it.

Changes

• .codex-plugin/plugin.json: version → 2.3.0-beta.2.
• docs/README.md: prerelease rows shifted — v2.3.0-beta.2 becomes the current prerelease, v2.3.0-beta.1 becomes the prior, preserving the table's established one-prior-beta window.
• AGENTS.md: "Package version" header → 2.3.0-beta.2.
• test/documentation.test.ts: new assertion pinning the AGENTS.md version header to package.json, so the third bump cannot drift silently.

Validation

• vitest run test/documentation.test.ts test/plugin-manifest.test.ts — 28/28 passing (both previously failing tests now green, new guard included)
• With this fix the failure set on main returns exactly to the 58 environment-only baseline names.

https://claude.ai/code/session_01XNtnkLbBiXZxfQQYLMpucB

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

syncs three version-string locations — .codex-plugin/plugin.json, AGENTS.md, and docs/README.md — to 2.3.0-beta.2 after a prior bump left them stale against package.json, fixing two failing tests. a new vitest guard in test/documentation.test.ts pins AGENTS.md's version header to package.json so the drift can't silently recur.

• .codex-plugin/plugin.json + AGENTS.md: mechanical version-string updates from 2.3.0-beta.1 → 2.3.0-beta.2, no logic change.
• docs/README.md: release-history table rolled forward — beta.2 becomes current prerelease, beta.1 becomes prior, honoring the one-prior-beta window policy; beta.0 is retired from the table.
• test/documentation.test.ts: new it block reads AGENTS.md and asserts Package version: ${packageVersion} is present, using the packageVersion already populated by beforeAll.

Confidence Score: 5/5

all four changed files are version-string updates or a new regression-guard test — no logic, auth, or filesystem paths touched.

changes are purely mechanical: three files update a single version string from beta.1 to beta.2, and the test file adds one assertion that reads a static file and compares a string. no runtime paths, token handling, concurrency, or windows filesystem code is touched. the new test correctly relies on the pre-existing beforeAll hook for packageVersion and adds meaningful coverage against future drift.

no files require special attention.

Important Files Changed

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    PJ[package.json\nversion: 2.3.0-beta.2]
    PJ -->|read by beforeAll| TV[packageVersion variable]
    TV -->|assertion| AT[test: AGENTS.md header sync]
    TV -->|assertion| PM[test: plugin-manifest version]
    TV -->|assertion| DR[test: docs/README.md release link]

    PJ -.->|must match| CPJ[.codex-plugin/plugin.json\nversion: 2.3.0-beta.2 ✓]
    PJ -.->|must match| AM[AGENTS.md\nPackage version: 2.3.0-beta.2 ✓]
    PJ -.->|link must exist| RM[docs/README.md\nreleases/v2.3.0-beta.2.md ✓]

_{Reviews (2): Last reviewed commit: "fix: sync the AGENTS.md version claim an..." | Re-trigger Greptile}