Fix hassfest validation and add bluetooth discovery confirm step

- Replace leftover integration_blueprint boilerplate in translations/en.json
  that contained a URL (rejected by hassfest) and described a non-existent
  username/password flow; align strings with the actual bluetooth flow.
- Require user confirmation for bluetooth-discovered devices via a new
  async_step_bluetooth_confirm instead of silently creating the entry, and
  use the device name for the title and discovery card.
- Use no_devices_found abort key and correct the documentation/issue_tracker
  URLs in manifest.json to point at the ha-run-chicken repo.

Author: bkanuka

custom_components/run_chicken/config_flow.py

@@ -6,16 +6,14 @@
 from typing import TYPE_CHECKING, Any
 
 import voluptuous as vol
-from homeassistant.components.bluetooth import (
-    BluetoothServiceInfo,
-    async_discovered_service_info,
-)
+from homeassistant.components.bluetooth import async_discovered_service_info
 from homeassistant.config_entries import ConfigFlow
 from homeassistant.const import CONF_ADDRESS
 
 from .const import DOMAIN, MANUFACTURER_ID
 
 if TYPE_CHECKING:
+    from homeassistant.components.bluetooth import BluetoothServiceInfoBleak
     from homeassistant.data_entry_flow import FlowResult
 
 _LOGGER = logging.getLogger(__name__)
@@ -26,19 +24,32 @@ class RunChickenConfigFlow(ConfigFlow, domain=DOMAIN):
 
     VERSION = 1
 
-    async def async_step_bluetooth(self, discovery_info: BluetoothServiceInfo) -> FlowResult:
-        """Handle a bluetooth discovery. Add immediately without prompts."""
-        address = discovery_info.address
+    _discovery_info: BluetoothServiceInfoBleak
+
+    async def async_step_bluetooth(self, discovery_info: BluetoothServiceInfoBleak) -> FlowResult:
+        """Handle a bluetooth discovery and ask the user to confirm."""
         if MANUFACTURER_ID not in discovery_info.manufacturer_data:
             return self.async_abort(reason="not_run_chicken_device")
 
-        _LOGGER.debug("Bluetooth discovery for Run-Chicken: %s", address)
+        _LOGGER.debug("Bluetooth discovery for Run-Chicken: %s", discovery_info.address)
 
-        await self.async_set_unique_id(address)
+        await self.async_set_unique_id(discovery_info.address)
         self._abort_if_unique_id_configured()
 
-        # Create the entry right away; we identify devices by address only
-        return self.async_create_entry(title=address, data={})
+        self._discovery_info = discovery_info
+        self.context["title_placeholders"] = {"name": discovery_info.name}
+        return await self.async_step_bluetooth_confirm()
+
+    async def async_step_bluetooth_confirm(self, user_input: dict[str, Any] | None = None) -> FlowResult:
+        """Confirm adding a device discovered over bluetooth."""
+        if user_input is not None:
+            return self.async_create_entry(title=self._discovery_info.name, data={})
+
+        self._set_confirm_only()
+        return self.async_show_form(
+            step_id="bluetooth_confirm",
+            description_placeholders={"name": self._discovery_info.name},
+        )
 
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> FlowResult:
         """Show list of discovered devices (by address) and let user pick one."""
@@ -61,7 +72,7 @@ async def async_step_user(self, user_input: dict[str, Any] | None = None) -> Flo
             options[addr] = f"{addr}"
 
         if not options:
-            return self.async_abort(reason="No devices found")
+            return self.async_abort(reason="no_devices_found")
 
         schema = vol.Schema({vol.Required(CONF_ADDRESS): vol.In(options)})
         return self.async_show_form(step_id="user", data_schema=schema)

custom_components/run_chicken/manifest.json

@@ -14,10 +14,10 @@
   "dependencies": [
     "bluetooth_adapters"
   ],
-  "documentation": "https://github.com/bkanuka/run_chicken",
+  "documentation": "https://github.com/bkanuka/ha-run-chicken",
   "integration_type": "device",
   "iot_class": "local_push",
-  "issue_tracker": "https://github.com/bkanuka/run_chicken/issues",
+  "issue_tracker": "https://github.com/bkanuka/ha-run-chicken/issues",
   "loggers": [
     "run_chicken",
     "run_chicken.run_chicken_ble"

custom_components/run_chicken/translations/en.json

@@ -1,21 +1,21 @@
 {
     "config": {
+        "flow_title": "{name}",
         "step": {
             "user": {
-                "description": "If you need help with the configuration have a look here: https://github.com/ludeeus/run_chicken",
+                "description": "Select the Run-Chicken door to add.",
                 "data": {
-                    "username": "Username",
-                    "password": "Password"
+                    "address": "Device"
                 }
+            },
+            "bluetooth_confirm": {
+                "description": "Do you want to set up the Run-Chicken door {name}?"
             }
         },
-        "error": {
-            "auth": "Username/Password is wrong.",
-            "connection": "Unable to connect to the server.",
-            "unknown": "Unknown error occurred."
-        },
         "abort": {
-            "already_configured": "This entry is already configured."
+            "already_configured": "This device is already configured.",
+            "not_run_chicken_device": "The discovered device is not a Run-Chicken door.",
+            "no_devices_found": "No Run-Chicken devices were found."
         }
     }
-}
+}