Runbook: Add Auth Command

Safe workflow for adding a new codex-multi-auth ... command without expanding scope or breaking the existing CLI contract.

Goal

Add one new command path while keeping:

lib/codex-manager/commands/<name>.ts — command implementation
lib/codex-manager.ts — CLI_COMMAND_HANDLERS registration
lib/codex-manager/account-manager-commands.ts — ACCOUNT_MANAGER_COMMANDS registration (required for the bare codex-multi-auth <name> form)
lib/codex-manager/help.ts — printUsage() text
docs/reference/commands.md
README.md when user-visible workflow changes
test/codex-manager-cli.test.ts
test/documentation.test.ts
docs/upgrade.md when the command changes user-visible behavior or a documented workflow
package.json scripts, when the command adds or changes a build/test entrypoint referenced by docs

For the full dispatch contract and the two-registry trap, see RUNBOOK_ADD_AUTH_MANAGER_COMMAND.md.

Add the command logic as a module under lib/codex-manager/commands/, then register it in both CLI_COMMAND_HANDLERS and ACCOUNT_MANAGER_COMMANDS.
Keep usage text literal and copy-pasteable, and add the line to printUsage() in lib/codex-manager/help.ts.
Reuse existing storage, refresh, and quota helpers instead of adding new command-local state.
Add or extend CLI tests in test/codex-manager-cli.test.ts for:
- success path
- invalid input or missing args
- JSON mode if supported
- non-interactive behavior if relevant
Update docs/reference/commands.md with the command and flags.
Update README.md only when the command changes the recommended user workflow.
Update test/documentation.test.ts if new command text must stay aligned across docs and runtime usage text.

npm run lint
npm run typecheck
npm test -- test/codex-manager-cli.test.ts test/documentation.test.ts
npm run build