docs: fix v1.5.7 release notes scope and restore archived notes

Author: DerekSeaman

RELEASE_NOTES_v1.5.5.md

@@ -0,0 +1,19 @@
+# Release Notes v1.5.5
+
+## Bug Fixes
+
+- **Fixed thread safety race conditions**: Six pairing/polling state fields were accessed across threads without mutex protection, risking missed IRK captures on dual-core ESP32 variants.
+- **Fixed 32-bit timer overflow**: Absolute timer comparisons would fail after ~49.5 days of uptime. All timer checks now use wraparound-safe arithmetic.
+- **Fixed post-disconnect IRK lookup**: Used the event's embedded connection descriptor instead of `ble_gap_conn_find`, which could fail after NimBLE removed the descriptor.
+- **Fixed config defaults mismatch**: Python schema defaults now match the intended C++ behavior (`continuous_mode=true`, `max_captures=10`).
+- **Fixed BLE name validation**: Compile-time limit reduced from 29 to 12 bytes to match the runtime Samsung S24/S25 compatibility constraint.
+
+## Improvements
+
+- IRK cache size now scales with `max_captures` setting instead of being hardcoded to 10.
+- Replaced `esp_restart()` with `App.safe_reboot()` to avoid watchdog timeouts on profile change.
+- Consolidated `dump_config` output into a single log line, removing `vTaskDelay` workarounds.
+- Replaced magic number for NimBLE DHKey error with a named constant.
+- Simplified `is_valid_irk`, MAC generation, and NVS health check logic.
+- Added input validation for BLE profile select to reject invalid values.
+- Removed unused `on_auth_complete` method and `to_hex_fwd` dead code.

RELEASE_NOTES_v1.5.6.md

@@ -0,0 +1,13 @@
+# Release Notes v1.5.6
+
+## Reliability Fixes
+
+- **Fixed MAC rotation race condition**: `refresh_mac()` now sets the `suppress_next_adv_` flag before triggering disconnect, preventing `handle_gap_disconnect` from restarting advertising while the MAC rotation is still in progress.
+- **Component fails cleanly on critical init errors**: `setup()` now calls `mark_failed()` and returns early if the FreeRTOS mutex cannot be created, and `register_gatt_services()` marks the component as failed if GATT registration fails.
+- **NVS profile range validation**: Persisted BLE profile values are now range-checked before `static_cast`, preventing undefined behavior from corrupted NVS data.
+- **BLE name whitespace trimming**: `sanitize_ble_name()` now trims leading and trailing spaces after character filtering, preventing names like `" IRK "` from wasting bytes in the advertising packet.
+- **Fixed `host_synced_` cross-core visibility**: Changed from plain `bool` to `std::atomic<bool>` to ensure the NimBLE task's write is visible to the ESPHome main loop on dual-core ESP32 variants.
+
+## Code Quality
+
+- **Added explicit standard library includes**: Added `<string>`, `<vector>` to header and `<cstring>` to implementation, removing reliance on transitive includes from ESPHome/NimBLE headers.

RELEASE_NOTES_v1.5.7.md

@@ -1,5 +1,7 @@
 # Release Notes v1.5.7
 
+This release note reflects changes from `v1.5.6` to `v1.5.7`.
+
 ## Boot Stability and GATT Reliability
 
 - **Fixed Keyboard profile boot crash**: The Keyboard BLE profile was causing GATT registration to fail at boot because NimBLE rejects HID services with no characteristics. Added a minimal `HID Protocol Mode` characteristic (`0x2A4E`) to make the HID service structurally valid.
@@ -16,7 +18,6 @@
 - **Fixed `irk_last_try_ms_` first-poll bypass**: The IRK poll interval guard was bypassed on the first poll because the timestamp initialized to 0. It is now set to `now_ms()` alongside `enc_ready_` when encryption completes.
 - **Fixed `mac_rotation_retries_` and `mac_rotation_ready_time_` unprotected writes**: These members are now reset inside existing `MutexGuard` blocks, consistent with the documented threading model.
 - **Made getters thread-safe**: `get_ble_profile()` and `get_ble_name()` now acquire `state_mutex_` before reading shared state.
-- **Fixed `host_synced_` cross-core visibility**: Uses `std::atomic<bool>` to ensure the NimBLE task's write is visible to the ESPHome main loop on dual-core ESP32 variants.
 
 ## Correctness Fixes
 
@@ -25,8 +26,6 @@
 - **Fixed BLE name length silent truncation**: The `name_len` field is now clamped to 29 bytes with a warning log before the `uint8_t` cast.
 - **Fixed `commit_err` misleading log**: NVS set and commit errors are now tracked with separate variables so the log accurately reports which operation failed.
 - **Advertising switch state now reflects reality**: The advertising switch publishes the actual runtime state after start/stop attempts rather than echoing only the requested state.
-- **NVS profile range validation**: Persisted BLE profile values are range-checked before `static_cast`, preventing undefined behavior from corrupted NVS data.
-- **BLE name whitespace trimming**: `sanitize_ble_name()` trims leading and trailing spaces after character filtering.
 
 ## Observability and Diagnostics
 
@@ -40,13 +39,13 @@
 
 - **Removed dead code**: Unused helper `read_peer_bond_by_conn()`, unused constant `IRK_MIN_POLL_INTERVAL_MS`, unused local `adv_success`.
 - **Replaced magic GAP event numbers with named constants** for readability and safer maintenance across ESP-IDF/NimBLE SDK variants.
-- **Added explicit standard library includes**: Added `<string>`, `<vector>` to header and `<cstring>` to implementation, removing reliance on transitive includes.
 
 ## Files Updated
 
 - `components/irk_capture/irk_capture.cpp`
 - `components/irk_capture/irk_capture.h`
 - `ESPHome Devices/irk-capture-base.yaml`
 - `ESPHome Devices/irk-capture-full.yaml`
-- `ESPHome Devices/irk-capture-device-remote.yaml`
-- `RELEASE_NOTES_v1.5.7.md` (this file; replaces `RELEASE_NOTES_v1.5.6.md`)
+- `RELEASE_NOTES_v1.5.7.md`
+- `RELEASE_NOTES_v1.5.6.md` (archived)
+- `RELEASE_NOTES_v1.5.5.md` (archived)