Publish one complete CLI and first-run guide

[itsjling]

Closes #22.

Summary

• document every accepted CLI option, default, range, path rule, environment override, and provider limit
• cover package setup, readiness, browser-open failure, watch lifetime, shutdown, and retained state
• make one option registry supply parser membership, numeric limits, defaults, and public-help drift checks
• require every accepted option in both built-in help and the published reference
• make the lifecycle test wait for its event instead of relying on a fixed delay

Stack and blockers

• base: PR Publish the exact data and review-target contract #66 (Publish the exact data and review-target contract #21)
• next: PR Retire the divergent completed-plan stack #70 (Retire the divergent completed-plan stack #23)
• cross blockers: PR Reject malformed and conflicting CLI input #55 (Reject malformed and conflicting CLI input #5) for final input rules and PR Report doctor capabilities separately #44 (Make doctor report real capabilities #20) for final doctor behavior

Verification

• node --test tests/cli-docs.test.mjs tests/cli-args.test.mjs (20 tests)
• node --test tests/present-agent.test.mjs (1 test)
• npm run lint
• npm test (85 tests)
• npm run docs:check
• npm run docs:build
• npx fallow audit --changed-since 5e318672c3b925bd14b8af5da1da7cb6e255ac49
• git diff --check

Stack

1. Keep review notes outside target repos #43
2. Publish the exact data and review-target contract #66
3. Publish one complete CLI and first-run guide #69 👈 current
4. Retire the divergent completed-plan stack #70

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cd6fbff0ee

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[itsjling]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 94c6e99367

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".