docs: the launcher pin is documented where the engine pin is (#292)

[mikeallisonJS]

Map #292 shipped in #317–#320 and #323: the minBootstrap floor, the credential-lease deadline, the container ARG PHOEBE_AGENT_VERSION pin, and the upgrade/doctor halves. The docs did not move with the code, and two passages now describe behaviour that no longer exists.

docs/upgrading.md

• New The launcher floor section, between the engine-pin section and upgrading. Covers the second version pin, why the two drift, the phoebe.minBootstrap declaration, boot refusing to start below the floor, and the fix for a container and for a host.
• The --cli paragraph described the pre-phoebe upgrade cannot see or move a container deployment's launcher pin, so --both advances only half #296 behaviour — that upgrade prints a rebuild instruction for a container because the launcher is baked into the image. It rewrites the ARG PHOEBE_AGENT_VERSION line now and prints phoebe start --build.
• The --check paragraph now notes that for a container deployment the effective CLI version is the Dockerfile pin, not npm ls -g on the host, and that --json marks it cli.source: "dockerfile".

docs/operating.md

• "runs six checks" → seven, with the missing launcher-floor bullet: what it compares, where it reads the launcher version from in each deployment shape, and the two "does not apply" arms (no floor declared, local-mount engine).

Docs only — no changeset, matching the convention in #244.

🤖 Generated with Claude Code

[coderabbitai]

Warning

Review limit reached

Next included review available in 8 minutes.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 0b62dfc4-ba6a-49dc-b4cf-52ede7cfd09a

📥 Commits

Reviewing files that changed from the base of the PR and between b2baac5 and 1fa6a40.

📒 Files selected for processing (2)

• docs/operating.md
• docs/upgrading.md

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}