docs(releases): align stable docs with 1.2.2

Author: ndycode

README.md

@@ -308,9 +308,9 @@ codex auth doctor --json
 
 ## Release Notes
 
-- Current stable: [docs/releases/v1.1.10.md](docs/releases/v1.1.10.md)
-- Previous stable: [docs/releases/v0.1.9.md](docs/releases/v0.1.9.md)
-- Earlier stable: [docs/releases/v0.1.8.md](docs/releases/v0.1.8.md)
+- Current stable: [docs/releases/v1.2.2.md](docs/releases/v1.2.2.md)
+- Previous stable: [docs/releases/v1.2.1.md](docs/releases/v1.2.1.md)
+- Earlier stable: [docs/releases/v1.2.0.md](docs/releases/v1.2.0.md)
 - Archived prerelease: [docs/releases/v0.1.0-beta.0.md](docs/releases/v0.1.0-beta.0.md)
 
 ## License

docs/README.md

@@ -23,9 +23,9 @@ Public documentation for `codex-multi-auth`.
 | [configuration.md](configuration.md) | Stable defaults, precedence, and environment overrides |
 | [architecture.md](architecture.md) | Public system overview of the wrapper, storage, and optional plugin runtime |
 | [privacy.md](privacy.md) | Data handling and local storage behavior |
-| [releases/v1.1.10.md](releases/v1.1.10.md) | Stable release notes |
-| [releases/v0.1.9.md](releases/v0.1.9.md) | Previous stable release notes |
-| [releases/v0.1.8.md](releases/v0.1.8.md) | Earlier stable release notes |
+| [releases/v1.2.2.md](releases/v1.2.2.md) | Stable release notes |
+| [releases/v1.2.1.md](releases/v1.2.1.md) | Previous stable release notes |
+| [releases/v1.2.0.md](releases/v1.2.0.md) | Earlier stable release notes |
 | [releases/v0.1.7.md](releases/v0.1.7.md) | Archived stable release notes |
 | [releases/v0.1.6.md](releases/v0.1.6.md) | Archived stable release notes |
 | [releases/v0.1.5.md](releases/v0.1.5.md) | Archived stable release notes |
@@ -51,7 +51,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/v1.1.10.md](releases/v1.1.10.md) | Current stable release notes |
+| [releases/v1.2.2.md](releases/v1.2.2.md) | Current stable release notes |
 | [releases/v0.1.0-beta.0.md](releases/v0.1.0-beta.0.md) | Archived prerelease reference |
 | [Daily Use release notes](#daily-use) | Stable, previous, and archived release notes |
 | [releases/legacy-pre-0.1-history.md](releases/legacy-pre-0.1-history.md) | Archived pre-0.1 changelog history |

docs/releases/v1.2.2.md

@@ -0,0 +1,19 @@
+# Release v1.2.2
+
+Release line: `stable`
+
+This document anchors the current stable release reference used by the docs portal.
+
+## Scope
+
+- Current package version in `package.json` is `1.2.2`.
+- Canonical command family remains `codex auth ...`.
+- Canonical package name remains `codex-multi-auth`.
+- Keeps the docs portal and root README aligned with the currently published package version.
+
+## Related
+
+- [../getting-started.md](../getting-started.md)
+- [../upgrade.md](../upgrade.md)
+- [../reference/commands.md](../reference/commands.md)
+- [../reference/public-api.md](../reference/public-api.md)

test/documentation.test.ts

@@ -14,6 +14,19 @@ import { UI_COPY } from "../lib/ui/copy.js";
 
 const projectRoot = resolve(process.cwd());
 
+function readPackageVersion(): string {
+	const parsed = JSON.parse(readFileSync(join(projectRoot, "package.json"), "utf-8")) as {
+		version?: unknown;
+	};
+	if (typeof parsed.version !== "string" || parsed.version.trim().length === 0) {
+		throw new Error("package.json must define a non-empty version string");
+	}
+	return parsed.version.trim();
+}
+
+const packageVersion = readPackageVersion();
+const currentStableReleaseDoc = `docs/releases/v${packageVersion}.md`;
+
 const userDocs = [
 	"docs/index.md",
 	"docs/README.md",
@@ -30,9 +43,9 @@ const userDocs = [
 	"docs/reference/error-contracts.md",
 	"docs/reference/settings.md",
 	"docs/reference/storage-paths.md",
-	"docs/releases/v1.1.10.md",
-	"docs/releases/v0.1.9.md",
-	"docs/releases/v0.1.8.md",
+	currentStableReleaseDoc,
+	"docs/releases/v1.2.1.md",
+	"docs/releases/v1.2.0.md",
 	"docs/releases/v0.1.7.md",
 	"docs/releases/v0.1.6.md",
 	"docs/releases/v0.1.5.md",
@@ -122,10 +135,14 @@ describe("Documentation Integrity", () => {
 		}
 	});
 
-	it("docs portal links to stable, beta, and archived release history", () => {
+	it("docs portal and root README link to stable, beta, and archived release history", () => {
 		const portal = read("docs/README.md");
+		const readme = read("README.md");
 		expect(portal).toContain("reference/public-api.md");
 		expect(portal).toContain("reference/error-contracts.md");
+		expect(portal).toContain(`releases/v${packageVersion}.md`);
+		expect(portal).toContain("releases/v1.2.1.md");
+		expect(portal).toContain("releases/v1.2.0.md");
 		expect(portal).toContain("releases/v0.1.7.md");
 		expect(portal).toContain("releases/v0.1.6.md");
 		expect(portal).toContain("releases/v0.1.5.md");
@@ -134,6 +151,9 @@ describe("Documentation Integrity", () => {
 		expect(portal).toContain(
 			"| [Daily Use release notes](#daily-use) | Stable, previous, and archived release notes |",
 		);
+		expect(readme).toContain(currentStableReleaseDoc);
+		expect(readme).toContain("docs/releases/v1.2.1.md");
+		expect(readme).toContain("docs/releases/v1.2.0.md");
 
 		const beta = read("docs/releases/v0.1.0-beta.0.md");
 		expect(beta).toContain("Archived");