Keep Bluetooth Proxy on for legacy BLE builds

[bharvey88]

Version: 26.7.29.1

What does this implement/fix?

The Bluetooth Proxy switch does restore from flash, but the _OFF half of
RESTORE_DEFAULT_OFF only decides the boot where nothing is stored yet, which is
the first boot after the switch shipped. MSR-2_BLE.yaml inherited that mode from
Core, so a legacy BLE device that had always proxied comes up with the proxy off
after updating and stays that way until the user finds the switch. Reported in #92.

Core now reads the mode from a bluetooth_proxy_restore_mode substitution
defaulting to RESTORE_DEFAULT_OFF, and MSR-2_BLE.yaml overrides it to
RESTORE_DEFAULT_ON, the same override pattern that file already uses for its OTA
manifest URLs. The unified image is unchanged, and a user's saved choice still wins
on every later boot.

Validated with esphome config on 2026.7.2 across MSR-2.yaml, MSR-2_BLE.yaml
and MSR-2_Factory.yaml. Rendered switch: standard RESTORE_DEFAULT_OFF, BLE
RESTORE_DEFAULT_ON.

Matching PRs go to AIR-1, MSR-1 and MTR-1, which carry the identical switch and BLE variant.

Types of changes

• Bugfix (fixed change that fixes an issue)
• New feature (thanks!)
• Breaking change (repair/feature that breaks existing functionality)
• Dependency Update - Does not publish
• Other - Does not publish
• Website of github readme file update - Does not publish
• Github workflows - Does not publish

Checklist / Checklijst:

• The code change has been tested and works locally
• The code change has not yet been tested

If user-visible functionality or configuration variables are added/modified:

• Added/updated documentation for the web page

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features
  • Added configurable Bluetooth Proxy state restoration after first boot or factory reset.
  • BLE devices now restore Bluetooth Proxy enabled by default, helping maintain proxying after updates.
  • Updated ESPHome package version to 26.7.29.1.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a91d1391-934d-4a2d-bfda-e25b83be67c3

📥 Commits

Reviewing files that changed from the base of the PR and between c9ff283 and 54c9d94.

📒 Files selected for processing (2)

• Integrations/ESPHome/Core.yaml
• Integrations/ESPHome/MSR-2_BLE.yaml

---

Walkthrough

ESPHome core configuration now exposes a configurable Bluetooth Proxy restore mode. The BLE configuration sets it to restore enabled, while the core default remains disabled. The package version and related boot comments were also updated.

Changes

Bluetooth Proxy restore behavior

Layer / File(s)	Summary
Configurable core restore mode Integrations/ESPHome/Core.yaml	Adds bluetooth_proxy_restore_mode, wires it into bluetooth_proxy_switch, updates the package version, and clarifies BLE scanning behavior.
BLE restore override Integrations/ESPHome/MSR-2_BLE.yaml	Sets the Bluetooth Proxy restore mode to RESTORE_DEFAULT_ON for legacy BLE devices.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• ApolloAutomation/MSR-2#80: Introduces the Bluetooth Proxy restore-mode configuration and wiring in the same ESPHome files.
• ApolloAutomation/MSR-2#81: Adds related runtime Bluetooth Proxy and BLE proxy control in these ESPHome configurations.

Poem

A bunny hops through YAML bright,
RESTORE_ON keeps BLE alight.
Core defaults softly rest,
While legacy friends get proxy zest.
Version blooms—what a delightful flight!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main change: preserving Bluetooth Proxy behavior for legacy BLE builds.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix/ble-proxy-restore-on

---

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.}