docs: add release build spec and implementation plan

Also un-ignores docs/ directory so project documentation (specs, plans)
is tracked in git. Individual research files remain gitignored.

docs/user-facing-text.md

@@ -0,0 +1,111 @@
+# User-facing text — Atom Relay
+
+## MainActivity — statusbalk
+| Huidige tekst | strings.xml key |
+|---|---|
+| Connected | `status_connected` |
+| Verbinden… | `status_connecting` |
+| Servicefout | `status_service_error` |
+| Service not found | `status_service_not_found` |
+| Communicatiefout | `status_comm_error` |
+| Geen HMAC sleutel - open Instellingen | `status_no_key` |
+| Permissies geweigerd — open Instellingen | `status_permissions_denied` |
+| Bluetooth not enabled | `status_bluetooth_disabled` |
+| Scanning… | `status_scanning` |
+| Device not found | `status_device_not_found` |
+| Verkeerd apparaat — opnieuw scannen… | `status_wrong_device` |
+| Verbonden, services zoeken… | `status_discovering_services` |
+
+## MainActivity — knoppen
+| Huidige tekst | strings.xml key |
+|---|---|
+| Instellingen (contentDescription) | `cd_settings` |
+| Disconnected (placeholder) | `status_default` |
+| HOLD (fallback knoplabel) | `button_hold` |
+| Opnieuw scannen (fallback) | `button_retry_scan` |
+| User-defined labels 1 & 2 | PrefsHelper (user input) |
+
+## SettingsActivity — UI
+| Huidige tekst | strings.xml key |
+|---|---|
+| Sluit de ESP aan op USB en kies een actie. | `msg_settings_intro` |
+| Sleutel Uitwisselen | `button_key_exchange` |
+| Zet de ESP in download-modus (houd reset 2s in tot de groene LED aangaat) en tik op Firmware Flashen. | `msg_flash_mode_help` |
+| Firmware Flashen | `button_firmware_flash` |
+| Knoptekst | `section_labels` |
+| Relay 1 | `hint_label_relay1` |
+| Relay 2 | `hint_label_relay2` |
+| Weergave | `section_theme` |
+| Systeem | `theme_system` |
+| Licht | `theme_light` |
+| Donker | `theme_dark` |
+| Thema: %s | `theme_applied` |
+| Buildnummer: %s | `build_number` |
+
+## SettingsActivity — dialogs / toasts
+| Huidige tekst | strings.xml key |
+|---|---|
+| Sleutel Uitwisselen | `title_key_exchange` |
+| Sluit de ESP aan via USB. | `msg_connect_usb` |
+| Sleutel uitlezen… | `msg_reading_key` |
+| Beveiligingssleutel gelezen | `key_read_success` |
+| Sleutel uitwisselen mislukt - probeer opnieuw | `key_exchange_failed` |
+| USB-toegang geweigerd | `usb_access_denied` |
+| Annuleren | `button_cancel` |
+| Sluiten | `button_close` |
+| Firmware Flashen | `title_firmware_flash` |
+| Zet de ESP in download-modus (houd reset 2s in tot groene LED) en sluit aan via USB. | `msg_flash_download_mode` |
+| Initialiseren… | `msg_initializing` |
+| Firmware geflashed!\\n\\nOntkoppel de ESP en sluit opnieuw aan om de sleutel in te stellen. | `msg_flash_complete` |
+| Flashen mislukt: %s | `flash_failed` |
+| Sleutels komen niet overeen | `title_key_conflict` |
+| De ESP (SylDa_Server) heeft andere sleutels dan deze app. Wat wil je doen? | `msg_key_conflict` |
+| ESP sleutels overnemen | `button_keep_esp_keys` |
+| App sleutels overzetten | `button_overwrite_esp` |
+| ESP sleutels overschrijven? | `title_overwrite_confirm` |
+| Dit vervangt de sleutels van de ESP. De ESP kan daarna niet meer met de oorspronkelijke app communiceren. | `msg_overwrite_warning` |
+| Ik weet het zeker | `checkbox_confirm_overwrite` |
+| Bevestigen | `button_confirm` |
+| Sleutels overschrijven | `title_overwriting_keys` |
+| Sleutels schrijven naar ESP… | `msg_writing_keys` |
+
+## SettingsActivity — foutmeldingen (hardcoded in .kt)
+| Huidige tekst | strings.xml key |
+|---|---|
+| Geen CDC interface gevonden | `err_no_cdc` |
+| Kan USB apparaat niet openen | `err_usb_open` |
+| Kan USB interface niet claimen | `err_usb_claim` |
+| Geen USB OUT endpoint gevonden | `err_no_out` |
+| Geen USB IN endpoint gevonden | `err_no_in` |
+| Ongeldig sleutel/UUID formaat | `err_invalid_key` |
+| Geen sleutel gevonden na 5 pogingen | `err_key_retries` |
+| Fout: %s | `err_generic` |
+| SET_KEY schrijven mislukt | `err_set_key_write` |
+| SET_ID schrijven mislukt | `err_set_id_write` |
+| ESP bevestigde sleutel niet | `err_key_not_ack` |
+| ESP bevestigde UUID niet | `err_uuid_not_ack` |
+
+## EspFlasher — hardcoded in .kt
+| Huidige tekst | strings.xml key |
+|---|---|
+| Kan USB-apparaat niet openen | `err_usb_open` (reuse) |
+| Geen CDC data interface gevonden | `err_no_cdc` (reuse) |
+| Kan USB interface niet claimen | `err_usb_claim` (reuse) |
+| Geen USB OUT endpoint gevonden | `err_no_out` (reuse) |
+| Geen USB IN endpoint gevonden | `err_no_in` (reuse) |
+| Verbinden met ESP bootloader... | `flash_connecting` |
+| Bootloader | `flash_step_bootloader` |
+| Partitie tabel | `flash_step_partitions` |
+| Boot app0 | `flash_step_boot_app0` |
+| Firmware | `flash_step_firmware` |
+| Sync met bootloader... | `flash_sync` |
+| Chip detecteren... | `flash_detect` |
+| Chip: %s | `flash_chip` |
+| Stub laden... | `flash_stub` |
+| Firmware geflashed! | `flash_done` |
+
+## AndroidManifest
+| Huidige tekst | strings.xml key |
+|---|---|
+| Atom Relay | `app_name` |
+| Instellingen | `settings` |