docs: rewrite product docs for current 2.6.1 architecture - #632

Summary

• Rewrites user, reference, and maintainer docs to match the shipped 2.6.1 architecture (manager-first, optional wrapper, mcodex, runtime rotation default-on).
• Documents four published bins, local governance (usage/budget/policies), bridge tokens, enforced pause/drain, and shipped first-run setup (first-run-setup.json).
• Keeps historical docs/releases/* and audit snapshots as archives; updates architecture maps in AGENTS.md / lib/AGENTS.md.

Key accuracy fixes

• README and architecture: four bins including mcodex (not three)
• First-run setup marked as shipped (not "Unreleased")
• Account pause/drain documented as runtime-enforced via evaluateRuntimePolicy
• Settings / CONFIG_FIELDS parity for anti-abuse, force-account, routing mutex, pid offset
• Probe/default model examples use gpt-5.6-sol / gpt-5.5

Test plan

• npx vitest run --maxWorkers=1 test/documentation.test.ts (26/26 passed)
• Spot-check docs portal links from docs/README.md
• Spot-check codex-multi-auth / mcodex / rotation sections against lib/codex-manager/help.ts and package.json bins

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

this pr rewrites the full user, reference, and maintainer docs to match the shipped 2.6.1 architecture: four published bins, default-on runtime rotation, local governance (usage/budget/policies), bridge tokens, account pause/drain runtime enforcement, and first-run setup. source changes are narrow — expanding IMPLEMENTED_FEATURES to 54 entries, updating help.ts flag signatures, and updating the test suite to match.

• docs/reference/commands.md and docs/development/ARCHITECTURE.md are the heaviest changes; both are accurate against lib/AGENTS.md and lib/codex-manager/help.ts.
• test/documentation.test.ts adds two new integrity tests and updates stable release pins to v2.6.0/v2.5.0.
• test/cli-output-contracts.test.ts drops budget check|list [--json] and usage rotate from the contract anchor list.
• docs/getting-started.md uses where codex-multi-auth (Windows-only) in the first-run troubleshooting block; macOS/Linux users need which.

Confidence Score: 4/5

safe to merge after fixing the where / which cross-platform issue in getting-started.md

the docs are accurate against the shipped architecture and the source changes are narrow and well-tested. the one actionable problem is where codex-multi-auth in the first-run troubleshooting block — it is a Windows-only built-in and will silently fail for every macOS and Linux user who hits that path, giving them a confusing second error on top of an already-broken install.

docs/getting-started.md line 229 (where → add which for macOS/Linux); test/cli-output-contracts.test.ts (budget check|list and usage rotate missing from contract anchors)

Important Files Changed

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
docs/getting-started.md:226-230
`where` is a Windows-only built-in — it prints "not recognized" on macOS and Linux. the upgrade guide already uses the dual form; apply it here too.

```suggestion
If `codex-multi-auth` is not recognized:

```bash
where codex-multi-auth    # Windows
which codex-multi-auth    # macOS / Linux
```
```

_{Reviews (2): Last reviewed commit: "docs: close remaining architecture cover..." | Re-trigger Greptile}