chore: prepare v2.1.2 release

ndycode · ndycode · commit 6fedc30bda4a · 2026-04-30T18:06:01.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,14 +3,14 @@
 All notable changes to this project are documented in this file.
 Dates use ISO format (`YYYY-MM-DD`).
 
-This repository's current stable release line is `3.x`.
+This repository's current stable release line is `2.x`.
 Current stable release notes live in `docs/releases/`.
 This top-level changelog preserves the foundational `0.x` milestones and points older iteration history to `docs/releases/legacy-pre-0.1-history.md`.
 
-## [3.0.0] - 2026-04-30
+## [2.1.2] - 2026-04-30
 
-Major release for conflict-free installs alongside the official Codex CLI.
-See [docs/releases/v3.0.0.md](docs/releases/v3.0.0.md) for full details.
+Patch release for conflict-free installs alongside the official Codex CLI.
+See [docs/releases/v2.1.2.md](docs/releases/v2.1.2.md) for full details.
 
 ### Changed
 
diff --git a/README.md b/README.md
@@ -359,7 +359,7 @@ codex-multi-auth doctor --json
 
 ## Release Notes
 
-- Current stable: [docs/releases/v3.0.0.md](docs/releases/v3.0.0.md)
+- Current stable: [docs/releases/v2.1.2.md](docs/releases/v2.1.2.md)
 - Previous stable: [docs/releases/v2.1.1.md](docs/releases/v2.1.1.md)
 - Earlier stable: [docs/releases/v2.1.0.md](docs/releases/v2.1.0.md)
 - Earlier stable: [docs/releases/v1.3.2.md](docs/releases/v1.3.2.md)
diff --git a/SECURITY.md b/SECURITY.md
@@ -6,8 +6,7 @@ Security updates are provided for the current maintained release line.
 
 | Version line | Status |
 | --- | --- |
-| `3.x` latest | Supported |
-| `2.x` historical releases | Not supported |
+| `2.x` latest | Supported |
 | pre-`1.0` historical releases | Not supported |
 
 ---
diff --git a/docs/DOCUMENTATION.md b/docs/DOCUMENTATION.md
@@ -58,7 +58,7 @@ Canonical governance for repository documentation quality and consistency.
 3. Canonical storage root: `~/.codex/multi-auth` unless explicitly overridden.
 4. Compatibility aliases (`codex multi auth`, `codex multi-auth`, `codex multiauth`) belong only in command reference, troubleshooting, or migration sections.
 5. Legacy paths/flows and scoped package references belong only in migration and compatibility sections.
-6. Current stable release line is `3.x`; foundational `0.x` and pre-`0.1.0` entries stay archived separately.
+6. Current stable release line is `2.x`; foundational `0.x` and pre-`0.1.0` entries stay archived separately.
 7. Runtime rotation is documented as default-on unless a future release intentionally changes that policy.
 8. Audit evidence under `docs/audits/` is historical snapshot material. Do not rewrite captured evidence to look current; add snapshot notes or new audit artifacts instead.
 
diff --git a/docs/README.md b/docs/README.md
@@ -32,7 +32,7 @@ Public documentation for `codex-multi-auth`.
 
 | Document | Focus |
 | --- | --- |
-| [releases/v3.0.0.md](releases/v3.0.0.md) | Current stable release notes |
+| [releases/v2.1.2.md](releases/v2.1.2.md) | Current stable release notes |
 | [releases/v2.1.1.md](releases/v2.1.1.md) | Prior stable release notes |
 | [releases/v2.1.0.md](releases/v2.1.0.md) | Earlier stable release notes |
 | [releases/v2.0.2.md](releases/v2.0.2.md) | Earlier stable release notes |
@@ -83,7 +83,7 @@ Public documentation for `codex-multi-auth`.
 | [reference/storage-paths.md](reference/storage-paths.md) | Canonical and compatibility storage paths |
 | [reference/public-api.md](reference/public-api.md) | Public API stability and semver contract |
 | [reference/error-contracts.md](reference/error-contracts.md) | CLI, JSON, and helper error semantics |
-| [releases/v3.0.0.md](releases/v3.0.0.md) | Current stable release notes |
+| [releases/v2.1.2.md](releases/v2.1.2.md) | Current stable release notes |
 | [releases/v2.1.1.md](releases/v2.1.1.md) | Prior stable release notes |
 | [releases/v2.1.0.md](releases/v2.1.0.md) | Earlier stable release notes |
 | [releases/v2.0.2.md](releases/v2.0.2.md) | Earlier stable release notes |
diff --git a/docs/reference/public-api.md b/docs/reference/public-api.md
@@ -10,7 +10,7 @@ This project uses tiered API stability.
 
 ### Tier A: Stable APIs
 
-Stable APIs are covered by semver compatibility guarantees and must remain backward-compatible inside the current `3.x` line unless explicitly documented.
+Stable APIs are covered by semver compatibility guarantees and must remain backward-compatible inside the current `2.x` line unless explicitly documented.
 
 - Package root plugin entrypoint exports:
   - `OpenAIOAuthPlugin`
@@ -125,7 +125,7 @@ These details are documented for operator expectations. Internal helper process
 - Tier A bug fix or doc-only clarification: `PATCH`
 - Tier B additive compatibility improvement: usually `PATCH` or `MINOR` depending on caller impact
 
-This repository currently ships on a `3.x` line, and breaking changes still require explicit migration documentation and review sign-off.
+This repository currently ships on a `2.x` line, and breaking changes still require explicit migration documentation and review sign-off.
 
 ---
 
diff --git a/docs/releases/v2.1.2.md b/docs/releases/v2.1.2.md
@@ -1,17 +1,17 @@
-# Release v3.0.0
+# Release v2.1.2
 
 Release line: `stable`
 
-This major release removes the package-owned global `codex` executable so
+This patch release removes the package-owned global `codex` executable so
 `codex-multi-auth` can install beside official Codex distributions without npm
 bin collisions.
 
 ## Scope
 
-- Package version prepared for publish: `3.0.0`
+- Package version prepared for publish: `2.1.2`
 - Previous stable release: `v2.1.1`
-- Semver rationale: removing a previously published executable name is a
-  breaking CLI contract change.
+- Semver rationale: patch release for the npm install collision reported in
+  issue `#457`.
 
 ## Changed
 
diff --git a/docs/upgrade.md b/docs/upgrade.md
@@ -1,6 +1,6 @@
 # Upgrade Guide
 
-Migrate legacy installs to the canonical `codex-multi-auth` workflow on the current `3.x` release line.
+Migrate legacy installs to the canonical `codex-multi-auth` workflow on the current `2.x` release line.
 
 ---
 
@@ -12,9 +12,9 @@ Migrate legacy installs to the canonical `codex-multi-auth` workflow on the curr
 
 ---
 
-## v3.0.0 Bin Migration
+## v2.1.2 Bin Migration
 
-`v3.0.0` intentionally stops publishing a global `codex` executable. That
+`v2.1.2` intentionally stops publishing a global `codex` executable. That
 name belongs to the official Codex install path and can be owned by npm,
 Homebrew, or an official release binary.
 
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
 	"name": "codex-multi-auth",
-	"version": "3.0.0",
+	"version": "2.1.2",
 	"description": "Multi-account OAuth manager and codex auth wrapper for the official @openai/codex CLI, with switching, health checks, and recovery tools",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
diff --git a/test/documentation.test.ts b/test/documentation.test.ts
@@ -448,21 +448,21 @@ describe("Documentation Integrity", () => {
 		expect(settingsRef).toContain("- `menuStatuslineFields`");
 	});
 
-	it("keeps release-line docs aligned with the current 3.x policy", () => {
+	it("keeps release-line docs aligned with the current 2.x policy", () => {
 		const changelog = read("CHANGELOG.md");
 		const security = read("SECURITY.md");
 		const docsGovernance = read("docs/DOCUMENTATION.md");
 		const upgradeGuide = read("docs/upgrade.md");
 		const publicApi = read("docs/reference/public-api.md");
 
-		expect(changelog).toContain("current stable release line is `3.x`");
+		expect(changelog).toContain("current stable release line is `2.x`");
 		expect(changelog).toContain("docs/releases/");
-		expect(security).toContain("`3.x` latest");
+		expect(security).toContain("`2.x` latest");
 		expect(security).toContain("pre-`1.0` historical releases");
-		expect(docsGovernance).toContain("Current stable release line is `3.x`");
-		expect(upgradeGuide).toContain("current `3.x` release line");
-		expect(publicApi).toContain("inside the current `3.x` line");
-		expect(publicApi).toContain("currently ships on a `3.x` line");
+		expect(docsGovernance).toContain("Current stable release line is `2.x`");
+		expect(upgradeGuide).toContain("current `2.x` release line");
+		expect(publicApi).toContain("inside the current `2.x` line");
+		expect(publicApi).toContain("currently ships on a `2.x` line");
 	});
 
 	it("keeps the historical changelog aligned with the archived 0.x release set", () => {

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "codex-multi-auth",`
`3`		`- "version": "3.0.0",`
	`3`	`+ "version": "2.1.2",`
`4`	`4`	`"description": "Multi-account OAuth manager and codex auth wrapper for the official @openai/codex CLI, with switching, health checks, and recovery tools",`
`5`	`5`	`"main": "./dist/index.js",`
`6`	`6`	`"types": "./dist/index.d.ts",`