feat(cli): fbuild bringup orchestrator scaffold (#697)

[zackees]

#697. Promotes the bring-up orchestrator to a first-class fbuild command so the end-to-end pipeline stops being split between fbuild (build + flash) and FastLED Python (autoresearch port-resolution + monitor + RPC) — the split is exactly what caused the FastLED/FastLED#3300 LPC845-BRK incident.

What ships

• fbuild bringup <env> CLI subcommand with --rpc-method / --rpc-payload / --expect-result / --skip-build / --dry-run flags
• BringupConfig with default_echo_4242() (FastLED's classic autoresearch baseline) and with_overrides() for CLI overlay
• 3-way BringupResult { remote_ok, log_ok, echo_ok, elapsed_ms, details } verbatim from FastLED's autoresearch so every consumer already knows the shape. is_passing() = all-three
• Display walks the tuple left-to-right so the user sees where the chain broke
• Orchestration skeleton consults the existing primitives end-to-end: vcom_for_env (fbuild-serial: vendor a serial-probe CLI + shared BOARD_FINGERPRINTS table (companion to closed #684, parallel to FastLED #3339) #686), family_for_vid_pid (fbuild-serial: vendor a serial-probe CLI + shared BOARD_FINGERPRINTS table (companion to closed #684, parallel to FastLED #3339) #686), BoardFamily::idle_dtr_rts (fbuild-serial: BoardFamily enum + polymorphic ResetMethod dispatch registry #687), BoardFamily::reset_method (fbuild-serial: BoardFamily enum + polymorphic ResetMethod dispatch registry #687), BoardFamily::handoff_timing (fbuild: standardize flash→monitor handoff timing as per-family HandoffTiming on BoardFamily #691)
• --dry-run surfaces the resolved family / vcom / DTR-RTS / handoff timing / RPC config so CI can validate orchestration shape end-to-end without attached hardware

Tests — 8 passed

Default config + CLI override propagation, is_passing semantics, Display order, dry-run LPC845-BRK end-to-end shape (vcom + family + reset_method + idle_dtr_rts + handoff timing + RPC defaults all reach the report), env-without-vcom-override truthful reporting, non-dry-run stubbed but still informative.

Out of scope (follow-up PRs)

• Real build phase (defer to existing fbuild build)
• Real flash phase per BoardFamily
• Real monitor phase (consume HandoffTiming.boot_drain_ms + open with idle_dtr_rts)
• Real JSON-RPC send/receive
• Per-board bringup.* keys in board JSON
• FastLED's bash autoresearch migrated to thin wrapper

Closes #697.

[coderabbitai]

Warning

Review limit reached

@zackees, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 30 minutes and 8 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 15cbbf4b-c158-4abf-bebc-112a52fa7fe6

📥 Commits

Reviewing files that changed from the base of the PR and between b22a016 and d39c857.

📒 Files selected for processing (4)

• crates/fbuild-cli/src/cli/args.rs
• crates/fbuild-cli/src/cli/bringup.rs
• crates/fbuild-cli/src/cli/dispatch.rs
• crates/fbuild-cli/src/cli/mod.rs

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/697-bringup-command

---

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 and usage tips.}