merge

.claude/README.md

@@ -1,168 +0,0 @@
-# Claude Code Skills and Reference Files
-
-This directory contains Claude Skills and reference documentation for working with Home Assistant integrations.
-
-## Directory Structure
-
-```
-.claude/
-├── skills/                          # Claude Skills (auto-loaded)
-│   ├── testing/
-│   │   └── SKILL.md                 # Testing specialist skill
-│   ├── code-review/
-│   │   └── SKILL.md                 # Code review specialist skill
-│   └── quality-scale-architect/
-│       └── SKILL.md                 # Architecture guidance skill
-├── agents/                          # Legacy agent definitions
-│   └── quality-scale-rule-verifier.md
-└── references/                      # Deep-dive reference docs
-    ├── diagnostics.md               # Diagnostics implementation
-    ├── sensor.md                    # Sensor platform
-    ├── binary_sensor.md             # Binary sensor platform
-    ├── switch.md                    # Switch platform
-    ├── button.md                    # Button platform
-    ├── number.md                    # Number platform
-    └── select.md                    # Select platform
-```
-
-## Claude Skills
-
-Claude Skills are modular capabilities that extend Claude's functionality. Each Skill packages instructions and metadata that Claude uses automatically when relevant.
-
-### How Skills Work
-
-Skills use **progressive disclosure** - they load content in stages:
-
-1. **Level 1 - Metadata (always loaded)**: Skill name and description
-2. **Level 2 - Instructions (loaded when triggered)**: Main SKILL.md content
-3. **Level 3+ - Resources (loaded as needed)**: Reference files and additional docs
-
-This means you can have many Skills installed with minimal context penalty. Claude only knows each Skill exists and when to use it until triggered.
-
-### Available Skills
-
-#### Testing (`testing`)
-**Use when**: Writing, running, or fixing tests for Home Assistant integrations
-
-Specializes in:
-- Writing comprehensive test coverage (>95%)
-- Running pytest with appropriate flags
-- Fixing failing tests and updating snapshots
-- Following Home Assistant testing patterns
-- Modern fixture patterns and snapshot testing
-
-**Triggers on**: Requests about writing tests, running tests, fixing test failures, test coverage, pytest, snapshots
-
-#### Code Review (`code-review`)
-**Use when**: Reviewing code for quality, best practices, and standards compliance
-
-Specializes in:
-- Reviewing pull requests and code changes
-- Identifying anti-patterns and security vulnerabilities
-- Verifying async patterns and error handling
-- Ensuring quality scale compliance
-- Performance optimization
-
-**Triggers on**: Requests to review code, check for issues, analyze code quality, security review
-
-#### Quality Scale Architect (`quality-scale-architect`)
-**Use when**: Needing architectural guidance and quality scale planning
-
-Specializes in:
-- High-level architecture guidance
-- Quality scale tier selection (Bronze/Silver/Gold/Platinum)
-- Integration structure planning
-- Pattern recommendations (coordinator, push, hub)
-- Progression strategies between quality tiers
-
-**Triggers on**: Requests about architecture, integration design, quality tiers, structural planning, choosing patterns
-
-## Reference Files
-
-Reference files provide deep-dive documentation for specific implementation areas. Skills can reference these for detailed guidance, and they're loaded on-demand to avoid consuming context.
-
-### Available References
-
-- **diagnostics.md**: Complete guide to implementing integration and device diagnostics, data redaction, testing
-- **sensor.md**: Sensor platform implementation, device classes, state classes, entity descriptions
-- **binary_sensor.md**: Binary sensor implementation, device classes, push-updated patterns
-- **switch.md**: Switch control implementation, state updates, configuration switches
-- **button.md**: Button action implementation, device classes, one-time actions
-- **number.md**: Numeric value control, ranges, display modes, units
-- **select.md**: Option selection implementation, enums, translations, dynamic options
-
-## How to Use
-
-### As a Developer
-
-Skills work automatically - just ask Claude to help with tasks:
-
-- **Testing**: "Write tests for my sensor platform" or "Fix the failing config flow tests"
-- **Review**: "Review this integration for security issues" or "Check my async patterns"
-- **Architecture**: "Help me design a hub integration" or "What quality tier should I target?"
-
-### As Claude
-
-Skills are triggered automatically when requests match the skill descriptions. Skills can reference the documentation files in `.claude/references/` for detailed implementation guidance.
-
-Example:
-```python
-# When a testing request comes in, Claude triggers the testing skill
-# The skill can then reference .claude/references/sensor.md for sensor-specific patterns
-```
-
-## Quality Scale Overview
-
-Home Assistant uses a Quality Scale system:
-
-- **Bronze**: Basic requirements (mandatory baseline) - Config flow, unique IDs, auth flows
-- **Silver**: Enhanced functionality - Unavailability tracking, runtime data, parallel updates
-- **Gold**: Advanced features - Diagnostics, translations, device registry
-- **Platinum**: Highest quality - Strict typing, async-only dependencies, WebSession injection
-
-All Bronze rules are mandatory. Higher tiers are additive.
-
-## Skill Structure
-
-Each Skill is a directory containing a `SKILL.md` file with YAML frontmatter:
-
-```yaml
----
-name: skill-name
-description: Brief description of what this Skill does and when to use it (max 1024 chars)
----
-
-# Skill Content in Markdown
-
-Instructions, examples, and guidance...
-```
-
-**Progressive Loading**: Only the name/description are loaded initially. The full content loads when the Skill is triggered.
-
-## Creating Custom Skills
-
-To add a new Skill:
-
-1. Create a directory: `.claude/skills/my-skill/`
-2. Add a `SKILL.md` file with proper frontmatter
-3. Include clear instructions and examples
-4. Reference existing documentation when appropriate
-
-See [Claude Skills Documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) for complete guidance.
-
-## Additional Resources
-
-- Main instructions: `/home/user/core/CLAUDE.md`
-- Home Assistant Docs: https://developers.home-assistant.io
-- Integration Quality Scale: https://developers.home-assistant.io/docs/core/integration-quality-scale/
-- Claude Skills Cookbook: https://platform.claude.com/cookbook/skills-notebooks-01-skills-introduction
-
-## Contributing
-
-When adding new Skills or references:
-1. Follow the proper Skill structure (SKILL.md with frontmatter)
-2. Keep descriptions concise and trigger-focused (max 1024 chars)
-3. Include practical examples in Skill content
-4. Link to reference documentation for deep dives
-5. Consider quality scale implications
-6. Test that Skills trigger appropriately

.claude/agents/quality-scale-rule-verifier.md

@@ -1,77 +0,0 @@
----
-name: quality-scale-rule-verifier
-description: |
-  Use this agent when you need to verify that a Home Assistant integration follows a specific quality scale rule. This includes checking if the integration implements required patterns, configurations, or code structures defined by the quality scale system.
-
-  <example>
-  Context: The user wants to verify if an integration follows a specific quality scale rule.
-  user: "Check if the peblar integration follows the config-flow rule"
-  assistant: "I'll use the quality scale rule verifier to check if the peblar integration properly implements the config-flow rule."
-  <commentary>
-  Since the user is asking to verify a quality scale rule implementation, use the quality-scale-rule-verifier agent.
-  </commentary>
-  </example>
-
-  <example>
-  Context: The user is reviewing if an integration reaches a specific quality scale level.
-  user: "Verify that this integration reaches the bronze quality scale"
-  assistant: "Let me use the quality scale rule verifier to check the bronze quality scale implementation."
-  <commentary>
-  The user wants to verify the integration has reached a certain quality level, so use multiple quality-scale-rule-verifier agents to verify each bronze rule.
-  </commentary>
-  </example>
-model: inherit
-color: yellow
-tools: Read, Bash, Grep, Glob, WebFetch
----
-
-You are an expert Home Assistant integration quality scale auditor specializing in verifying compliance with specific quality scale rules. You have deep knowledge of Home Assistant's architecture, best practices, and the quality scale system that ensures integration consistency and reliability.
-
-You will verify if an integration follows a specific quality scale rule by:
-
-1. **Fetching Rule Documentation**: Retrieve the official rule documentation from:
-   `https://raw.githubusercontent.com/home-assistant/developers.home-assistant/refs/heads/master/docs/core/integration-quality-scale/rules/{rule_name}.md`
-   where `{rule_name}` is the rule identifier (e.g., 'config-flow', 'entity-unique-id', 'parallel-updates')
-
-2. **Understanding Rule Requirements**: Parse the rule documentation to identify:
-   - Core requirements and mandatory implementations
-   - Specific code patterns or configurations required
-   - Common violations and anti-patterns
-   - Exemption criteria (when a rule might not apply)
-   - The quality tier this rule belongs to (Bronze, Silver, Gold, Platinum)
-
-3. **Analyzing Integration Code**: Examine the integration's codebase at `homeassistant/components/<integration domain>` focusing on:
-   - `manifest.json` for quality scale declaration and configuration
-   - `quality_scale.yaml` for rule status (done, todo, exempt)
-   - Relevant Python modules based on the rule requirements
-   - Configuration files and service definitions as needed
-
-4. **Verification Process**:
-   - Check if the rule is marked as 'done', 'todo', or 'exempt' in quality_scale.yaml
-   - If marked 'exempt', verify the exemption reason is valid
-   - If marked 'done', verify the actual implementation matches requirements
-   - Identify specific files and code sections that demonstrate compliance or violations
-   - Consider the integration's declared quality tier when applying rules
-   - To fetch the integration docs, use WebFetch to fetch from `https://raw.githubusercontent.com/home-assistant/home-assistant.io/refs/heads/current/source/_integrations/<integration domain>.markdown`
-   - To fetch information about a PyPI package, use the URL `https://pypi.org/pypi/<package>/json`
-
-5. **Reporting Findings**: Provide a comprehensive verification report that includes:
-   - **Rule Summary**: Brief description of what the rule requires
-   - **Compliance Status**: Clear pass/fail/exempt determination
-   - **Evidence**: Specific code examples showing compliance or violations
-   - **Issues Found**: Detailed list of any non-compliance issues with file locations
-   - **Recommendations**: Actionable steps to achieve compliance if needed
-   - **Exemption Analysis**: If applicable, whether the exemption is justified
-
-When examining code, you will:
-- Look for exact implementation patterns specified in the rule
-- Verify all required components are present and properly configured
-- Check for common mistakes and anti-patterns
-- Consider edge cases and error handling requirements
-- Validate that implementations follow Home Assistant conventions
-
-You will be thorough but focused, examining only the aspects relevant to the specific rule being verified. You will provide clear, actionable feedback that helps developers understand both what needs to be fixed and why it matters for integration quality.
-
-If you cannot access the rule documentation or find the integration code, clearly state what information is missing and what you would need to complete the verification.
-
-Remember that quality scale rules are cumulative - Bronze rules apply to all integrations with a quality scale, Silver rules apply to Silver+ integrations, and so on. Always consider the integration's target quality level when determining which rules should be enforced.

.claude/references/binary_sensor.md

@@ -1,470 +0,0 @@
-# Binary Sensor Platform Reference
-
-## Overview
-
-Binary sensors are read-only entities that represent an on/off, true/false, or open/closed state. They are simpler than regular sensors and don't have units or numeric values.
-
-## Basic Binary Sensor Implementation
-
-```python
-"""Binary sensor platform for my_integration."""
-from homeassistant.components.binary_sensor import (
-    BinarySensorDeviceClass,
-    BinarySensorEntity,
-)
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers.entity_platform import AddEntitiesCallback
-
-from . import MyConfigEntry
-from .coordinator import MyCoordinator
-from .entity import MyEntity
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up binary sensors."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MyBinarySensor(coordinator, device_id)
-        for device_id in coordinator.data.devices
-    )
-
-
-class MyBinarySensor(MyEntity, BinarySensorEntity):
-    """Representation of a binary sensor."""
-
-    _attr_has_entity_name = True
-    _attr_translation_key = "motion"
-    _attr_device_class = BinarySensorDeviceClass.MOTION
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        """Initialize the binary sensor."""
-        super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}_motion"
-
-    @property
-    def is_on(self) -> bool | None:
-        """Return true if motion is detected."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.motion_detected
-        return None
-```
-
-## Binary Sensor State
-
-The core property for binary sensors is `is_on`:
-
-```python
-@property
-def is_on(self) -> bool | None:
-    """Return true if the binary sensor is on."""
-    return self.device.is_active
-
-# Alternatively, use attribute
-_attr_is_on = True  # or False, or None
-```
-
-**State Meaning**:
-- `True` / `"on"` - Active/detected/open
-- `False` / `"off"` - Inactive/not detected/closed
-- `None` - Unknown (displays as "unavailable")
-
-## Device Classes
-
-Binary sensors should use device classes for proper representation:
-
-```python
-from homeassistant.components.binary_sensor import BinarySensorDeviceClass
-
-# Common device classes
-_attr_device_class = BinarySensorDeviceClass.MOTION
-_attr_device_class = BinarySensorDeviceClass.OCCUPANCY
-_attr_device_class = BinarySensorDeviceClass.DOOR
-_attr_device_class = BinarySensorDeviceClass.WINDOW
-_attr_device_class = BinarySensorDeviceClass.OPENING
-_attr_device_class = BinarySensorDeviceClass.CONNECTIVITY
-_attr_device_class = BinarySensorDeviceClass.BATTERY
-_attr_device_class = BinarySensorDeviceClass.BATTERY_CHARGING
-_attr_device_class = BinarySensorDeviceClass.PROBLEM
-_attr_device_class = BinarySensorDeviceClass.RUNNING
-_attr_device_class = BinarySensorDeviceClass.SMOKE
-_attr_device_class = BinarySensorDeviceClass.MOISTURE
-_attr_device_class = BinarySensorDeviceClass.LOCK
-_attr_device_class = BinarySensorDeviceClass.TAMPER
-_attr_device_class = BinarySensorDeviceClass.PLUG
-_attr_device_class = BinarySensorDeviceClass.POWER
-```
-
-### Device Class Selection Guide
-
-**Detection Sensors**:
-- Motion detector → `MOTION`
-- Presence detector → `OCCUPANCY`
-- Smoke detector → `SMOKE`
-- Water leak detector → `MOISTURE`
-
-**Contact Sensors**:
-- Door sensor → `DOOR`
-- Window sensor → `WINDOW`
-- Generic contact → `OPENING`
-
-**Status Sensors**:
-- Network connection → `CONNECTIVITY`
-- Device running → `RUNNING`
-- Low battery → `BATTERY`
-- Charging state → `BATTERY_CHARGING`
-- Problem/fault → `PROBLEM`
-- Tamper detection → `TAMPER`
-
-**Power Sensors**:
-- Outlet state → `PLUG`
-- Power state → `POWER`
-- Lock state → `LOCK`
-
-## Entity Descriptions Pattern
-
-For multiple similar binary sensors:
-
-```python
-from dataclasses import dataclass
-from collections.abc import Callable
-
-from homeassistant.components.binary_sensor import (
-    BinarySensorDeviceClass,
-    BinarySensorEntityDescription,
-)
-
-@dataclass(frozen=True, kw_only=True)
-class MyBinarySensorDescription(BinarySensorEntityDescription):
-    """Describes a binary sensor."""
-    is_on_fn: Callable[[MyData], bool | None]
-
-
-BINARY_SENSORS: tuple[MyBinarySensorDescription, ...] = (
-    MyBinarySensorDescription(
-        key="motion",
-        translation_key="motion",
-        device_class=BinarySensorDeviceClass.MOTION,
-        is_on_fn=lambda data: data.motion_detected,
-    ),
-    MyBinarySensorDescription(
-        key="door",
-        translation_key="door",
-        device_class=BinarySensorDeviceClass.DOOR,
-        is_on_fn=lambda data: data.door_open,
-    ),
-    MyBinarySensorDescription(
-        key="battery_low",
-        translation_key="battery_low",
-        device_class=BinarySensorDeviceClass.BATTERY,
-        entity_category=EntityCategory.DIAGNOSTIC,
-        is_on_fn=lambda data: data.battery_level < 20,
-    ),
-)
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up binary sensors."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MyBinarySensor(coordinator, device_id, description)
-        for device_id in coordinator.data.devices
-        for description in BINARY_SENSORS
-    )
-
-
-class MyBinarySensor(MyEntity, BinarySensorEntity):
-    """Binary sensor using entity description."""
-
-    entity_description: MyBinarySensorDescription
-
-    def __init__(
-        self,
-        coordinator: MyCoordinator,
-        device_id: str,
-        description: MyBinarySensorDescription,
-    ) -> None:
-        """Initialize the binary sensor."""
-        super().__init__(coordinator, device_id)
-        self.entity_description = description
-        self._attr_unique_id = f"{device_id}_{description.key}"
-
-    @property
-    def is_on(self) -> bool | None:
-        """Return true if the binary sensor is on."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return self.entity_description.is_on_fn(device)
-        return None
-```
-
-## Entity Category
-
-Mark diagnostic or configuration binary sensors:
-
-```python
-from homeassistant.helpers.entity import EntityCategory
-
-# Diagnostic sensors
-_attr_entity_category = EntityCategory.DIAGNOSTIC
-# Examples: connectivity, update available, battery low
-
-# Config sensors
-_attr_entity_category = EntityCategory.CONFIG
-# Examples: configuration status
-```
-
-## State Inversion
-
-For some sensors, you may need to invert the logic:
-
-```python
-class MyBinarySensor(BinarySensorEntity):
-    """Binary sensor with inverted state."""
-
-    @property
-    def is_on(self) -> bool | None:
-        """Return true if sensor is on."""
-        if self.device.is_closed:
-            return False  # Closed = off for door sensor
-        if self.device.is_open:
-            return True   # Open = on for door sensor
-        return None
-```
-
-## Push-Updated Binary Sensor
-
-For event-driven sensors:
-
-```python
-class MyPushBinarySensor(BinarySensorEntity):
-    """Push-updated binary sensor."""
-
-    _attr_should_poll = False
-
-    async def async_added_to_hass(self) -> None:
-        """Subscribe to updates when added."""
-        self.async_on_remove(
-            self.device.subscribe_state(self._handle_state_update)
-        )
-
-    @callback
-    def _handle_state_update(self, state: bool) -> None:
-        """Handle state update from device."""
-        self._attr_is_on = state
-        self.async_write_ha_state()
-```
-
-## Testing Binary Sensors
-
-### Snapshot Testing
-
-```python
-"""Test binary sensors."""
-import pytest
-from syrupy import SnapshotAssertion
-
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import entity_registry as er
-
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default")
-async def test_binary_sensors(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    mock_config_entry: MockConfigEntry,
-    init_integration,
-) -> None:
-    """Test binary sensor entities."""
-    await snapshot_platform(
-        hass,
-        entity_registry,
-        snapshot,
-        mock_config_entry.entry_id,
-    )
-```
-
-### State Testing
-
-```python
-async def test_binary_sensor_states(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-) -> None:
-    """Test binary sensor states."""
-    await init_integration(hass, mock_config_entry)
-
-    # Test on state
-    state = hass.states.get("binary_sensor.my_device_motion")
-    assert state
-    assert state.state == "on"
-    assert state.attributes["device_class"] == "motion"
-
-    # Test off state
-    state = hass.states.get("binary_sensor.my_device_door")
-    assert state
-    assert state.state == "off"
-    assert state.attributes["device_class"] == "door"
-```
-
-## Common Patterns
-
-### Pattern 1: Coordinator-Based
-
-```python
-class MyBinarySensor(CoordinatorEntity[MyCoordinator], BinarySensorEntity):
-    """Coordinator-based binary sensor."""
-
-    _attr_should_poll = False
-
-    @property
-    def is_on(self) -> bool | None:
-        """Get state from coordinator data."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.is_active
-        return None
-
-    @property
-    def available(self) -> bool:
-        """Return if entity is available."""
-        return super().available and self.device_id in self.coordinator.data
-```
-
-### Pattern 2: Event-Driven
-
-```python
-class MyEventBinarySensor(BinarySensorEntity):
-    """Event-driven binary sensor."""
-
-    _attr_should_poll = False
-
-    async def async_added_to_hass(self) -> None:
-        """Subscribe to events."""
-        self.async_on_remove(
-            async_dispatcher_connect(
-                self.hass,
-                f"{DOMAIN}_event",
-                self._handle_event,
-            )
-        )
-
-    @callback
-    def _handle_event(self, event_type: str, active: bool) -> None:
-        """Handle incoming event."""
-        if event_type == self.event_type:
-            self._attr_is_on = active
-            self.async_write_ha_state()
-```
-
-### Pattern 3: Calculated/Derived
-
-```python
-class MyCalculatedBinarySensor(BinarySensorEntity):
-    """Binary sensor calculated from other sensors."""
-
-    _attr_should_poll = False
-
-    async def async_added_to_hass(self) -> None:
-        """Subscribe to source sensors."""
-        self.async_on_remove(
-            async_track_state_change_event(
-                self.hass,
-                ["sensor.temperature", "sensor.humidity"],
-                self._handle_source_update,
-            )
-        )
-
-    @callback
-    def _handle_source_update(self, event: Event) -> None:
-        """Recalculate when sources change."""
-        temp = self.hass.states.get("sensor.temperature")
-        humidity = self.hass.states.get("sensor.humidity")
-
-        if temp and humidity:
-            # Example: high comfort if temp 20-25 and humidity 30-60
-            temp_ok = 20 <= float(temp.state) <= 25
-            humidity_ok = 30 <= float(humidity.state) <= 60
-            self._attr_is_on = temp_ok and humidity_ok
-            self.async_write_ha_state()
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Use appropriate device classes
-- Return `None` for unknown state
-- Use `is_on` property (not state)
-- Implement unique IDs
-- Use entity descriptions for similar sensors
-- Mark diagnostic sensors with entity_category
-- Use translation keys for entity names
-- Handle availability properly
-
-### ❌ DON'T
-
-- Return strings like "on"/"off" from is_on
-- Use regular Sensor for binary states
-- Hardcode entity names
-- Create binary sensors without device classes (when available)
-- Use unavailable/unknown as state values
-- Block the event loop
-- Poll unnecessarily (use coordinator or events)
-
-## Disabled by Default
-
-For less important binary sensors:
-
-```python
-class MyConnectivitySensor(BinarySensorEntity):
-    """Connectivity sensor - diagnostic."""
-
-    _attr_entity_registry_enabled_default = False
-    _attr_entity_category = EntityCategory.DIAGNOSTIC
-    _attr_device_class = BinarySensorDeviceClass.CONNECTIVITY
-```
-
-## Troubleshooting
-
-### Binary Sensor Not Appearing
-
-Check:
-- [ ] Unique ID is set
-- [ ] Platform is in PLATFORMS list
-- [ ] Entity is added with async_add_entities
-- [ ] is_on returns bool or None (not string)
-
-### State Not Updating
-
-Check:
-- [ ] Coordinator is updating (if used)
-- [ ] Event subscriptions are working
-- [ ] is_on returns correct value
-- [ ] async_write_ha_state() is called (push updates)
-
-### Wrong Icon
-
-Check:
-- [ ] Device class is set correctly
-- [ ] Device class matches sensor purpose
-- [ ] Icon translations if using Gold tier
-
-## Quality Scale Considerations
-
-- **Bronze**: Unique ID required
-- **Gold**: Entity translations, device class, entity category
-- **Platinum**: Full type hints
-
-## References
-
-- [Binary Sensor Documentation](https://developers.home-assistant.io/docs/core/entity/binary-sensor)
-- [Device Classes](https://www.home-assistant.io/integrations/binary_sensor/#device-class)

.claude/references/button.md

@@ -1,459 +0,0 @@
-# Button Platform Reference
-
-## Overview
-
-Buttons are entities that trigger an action when pressed. They don't have a state (on/off) and are used for one-time actions like rebooting a device, triggering an update, or running a routine.
-
-## Basic Button Implementation
-
-```python
-"""Button platform for my_integration."""
-from homeassistant.components.button import ButtonEntity
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers.entity_platform import AddEntitiesCallback
-
-from . import MyConfigEntry
-from .coordinator import MyCoordinator
-from .entity import MyEntity
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up buttons."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MyButton(coordinator, device_id)
-        for device_id in coordinator.data.devices
-    )
-
-
-class MyButton(MyEntity, ButtonEntity):
-    """Representation of a button."""
-
-    _attr_has_entity_name = True
-    _attr_translation_key = "reboot"
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        """Initialize the button."""
-        super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}_reboot"
-
-    async def async_press(self) -> None:
-        """Handle the button press."""
-        await self.coordinator.client.reboot(self.device_id)
-```
-
-## Button Method
-
-The only required method for buttons:
-
-```python
-async def async_press(self) -> None:
-    """Handle the button press."""
-    await self.device.trigger_action()
-```
-
-**Note**: Buttons don't have state. They only perform an action when pressed.
-
-## Device Class
-
-Buttons can have device classes to indicate their purpose:
-
-```python
-from homeassistant.components.button import ButtonDeviceClass
-
-_attr_device_class = ButtonDeviceClass.RESTART
-_attr_device_class = ButtonDeviceClass.UPDATE
-_attr_device_class = ButtonDeviceClass.IDENTIFY
-```
-
-Device classes:
-- `RESTART` - Reboot/restart device
-- `UPDATE` - Trigger update check or installation
-- `IDENTIFY` - Make device identify itself (blink LED, beep, etc.)
-
-## Entity Category
-
-Most buttons are configuration actions:
-
-```python
-from homeassistant.helpers.entity import EntityCategory
-
-# Config buttons (device settings/actions)
-_attr_entity_category = EntityCategory.CONFIG
-# Examples: reboot, reset, identify
-
-# Diagnostic buttons (troubleshooting)
-_attr_entity_category = EntityCategory.DIAGNOSTIC
-# Examples: test connection, refresh diagnostics
-```
-
-## Entity Descriptions Pattern
-
-For multiple buttons:
-
-```python
-from dataclasses import dataclass
-from collections.abc import Awaitable, Callable
-
-from homeassistant.components.button import ButtonEntityDescription, ButtonDeviceClass
-
-
-@dataclass(frozen=True, kw_only=True)
-class MyButtonDescription(ButtonEntityDescription):
-    """Describes a button."""
-    press_fn: Callable[[MyClient, str], Awaitable[None]]
-
-
-BUTTONS: tuple[MyButtonDescription, ...] = (
-    MyButtonDescription(
-        key="reboot",
-        translation_key="reboot",
-        device_class=ButtonDeviceClass.RESTART,
-        entity_category=EntityCategory.CONFIG,
-        press_fn=lambda client, device_id: client.reboot(device_id),
-    ),
-    MyButtonDescription(
-        key="identify",
-        translation_key="identify",
-        device_class=ButtonDeviceClass.IDENTIFY,
-        entity_category=EntityCategory.CONFIG,
-        press_fn=lambda client, device_id: client.identify(device_id),
-    ),
-    MyButtonDescription(
-        key="check_update",
-        translation_key="check_update",
-        device_class=ButtonDeviceClass.UPDATE,
-        entity_category=EntityCategory.CONFIG,
-        press_fn=lambda client, device_id: client.check_updates(device_id),
-    ),
-)
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up buttons."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MyButton(coordinator, device_id, description)
-        for device_id in coordinator.data.devices
-        for description in BUTTONS
-    )
-
-
-class MyButton(MyEntity, ButtonEntity):
-    """Button using entity description."""
-
-    entity_description: MyButtonDescription
-
-    def __init__(
-        self,
-        coordinator: MyCoordinator,
-        device_id: str,
-        description: MyButtonDescription,
-    ) -> None:
-        """Initialize the button."""
-        super().__init__(coordinator, device_id)
-        self.entity_description = description
-        self._attr_unique_id = f"{device_id}_{description.key}"
-
-    async def async_press(self) -> None:
-        """Handle the button press."""
-        await self.entity_description.press_fn(
-            self.coordinator.client,
-            self.device_id,
-        )
-```
-
-## Common Button Types
-
-### Restart Button
-
-```python
-class RestartButton(ButtonEntity):
-    """Restart device button."""
-
-    _attr_device_class = ButtonDeviceClass.RESTART
-    _attr_entity_category = EntityCategory.CONFIG
-    _attr_translation_key = "restart"
-
-    async def async_press(self) -> None:
-        """Restart the device."""
-        await self.device.restart()
-```
-
-### Update Button
-
-```python
-class UpdateButton(ButtonEntity):
-    """Trigger update check button."""
-
-    _attr_device_class = ButtonDeviceClass.UPDATE
-    _attr_entity_category = EntityCategory.CONFIG
-    _attr_translation_key = "check_update"
-
-    async def async_press(self) -> None:
-        """Check for updates."""
-        await self.device.check_for_updates()
-```
-
-### Identify Button
-
-```python
-class IdentifyButton(ButtonEntity):
-    """Make device identify itself."""
-
-    _attr_device_class = ButtonDeviceClass.IDENTIFY
-    _attr_entity_category = EntityCategory.CONFIG
-    _attr_translation_key = "identify"
-
-    async def async_press(self) -> None:
-        """Trigger device identification."""
-        await self.device.identify()
-```
-
-### Custom Action Button
-
-```python
-class CustomButton(ButtonEntity):
-    """Custom action button."""
-
-    _attr_entity_category = EntityCategory.CONFIG
-    _attr_translation_key = "run_cycle"
-
-    async def async_press(self) -> None:
-        """Run cleaning cycle."""
-        await self.device.start_cleaning_cycle()
-```
-
-## State Updates After Press
-
-Buttons trigger coordinator refresh if needed:
-
-```python
-async def async_press(self) -> None:
-    """Handle press with refresh."""
-    await self.coordinator.client.reboot(self.device_id)
-    # Refresh coordinator to update related entities
-    await self.coordinator.async_request_refresh()
-```
-
-## Error Handling
-
-Handle errors appropriately:
-
-```python
-from homeassistant.exceptions import HomeAssistantError
-
-
-async def async_press(self) -> None:
-    """Handle press with error handling."""
-    try:
-        await self.device.reboot()
-    except DeviceOfflineError as err:
-        raise HomeAssistantError(f"Device is offline: {err}") from err
-    except DeviceError as err:
-        raise HomeAssistantError(f"Failed to reboot: {err}") from err
-```
-
-## Testing Buttons
-
-### Snapshot Testing
-
-```python
-"""Test buttons."""
-import pytest
-from syrupy import SnapshotAssertion
-
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import entity_registry as er
-
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default")
-async def test_buttons(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    mock_config_entry: MockConfigEntry,
-    init_integration,
-) -> None:
-    """Test button entities."""
-    await snapshot_platform(
-        hass,
-        entity_registry,
-        snapshot,
-        mock_config_entry.entry_id,
-    )
-```
-
-### Press Testing
-
-```python
-from homeassistant.const import ATTR_ENTITY_ID
-from homeassistant.components.button import DOMAIN as BUTTON_DOMAIN, SERVICE_PRESS
-
-
-async def test_button_press(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_device,
-) -> None:
-    """Test button press."""
-    await init_integration(hass, mock_config_entry)
-
-    # Press button
-    await hass.services.async_call(
-        BUTTON_DOMAIN,
-        SERVICE_PRESS,
-        {ATTR_ENTITY_ID: "button.my_device_reboot"},
-        blocking=True,
-    )
-
-    # Verify action was called
-    mock_device.reboot.assert_called_once()
-```
-
-### Error Testing
-
-```python
-async def test_button_press_error(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_device,
-) -> None:
-    """Test button press with error."""
-    await init_integration(hass, mock_config_entry)
-
-    mock_device.reboot.side_effect = DeviceError("Connection failed")
-
-    # Press button should raise error
-    with pytest.raises(HomeAssistantError):
-        await hass.services.async_call(
-            BUTTON_DOMAIN,
-            SERVICE_PRESS,
-            {ATTR_ENTITY_ID: "button.my_device_reboot"},
-            blocking=True,
-        )
-```
-
-## Common Patterns
-
-### Pattern 1: Simple Action Button
-
-```python
-class SimpleButton(ButtonEntity):
-    """Simple button that triggers action."""
-
-    async def async_press(self) -> None:
-        """Trigger action."""
-        await self.device.do_something()
-```
-
-### Pattern 2: Button with Coordinator Refresh
-
-```python
-class RefreshingButton(CoordinatorEntity[MyCoordinator], ButtonEntity):
-    """Button that refreshes coordinator."""
-
-    async def async_press(self) -> None:
-        """Trigger action and refresh."""
-        await self.coordinator.client.action(self.device_id)
-        await self.coordinator.async_request_refresh()
-```
-
-### Pattern 3: Button with Validation
-
-```python
-class ValidatingButton(ButtonEntity):
-    """Button with pre-action validation."""
-
-    async def async_press(self) -> None:
-        """Validate then trigger action."""
-        if not self.device.is_ready:
-            raise HomeAssistantError("Device not ready")
-
-        await self.device.trigger_action()
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Use appropriate device class
-- Set entity category (usually CONFIG)
-- Handle errors with HomeAssistantError
-- Implement unique IDs
-- Use translation keys
-- Refresh coordinator if state changes
-- Provide clear button names/translations
-
-### ❌ DON'T
-
-- Create buttons that track state (use switch instead)
-- Poll buttons (they have no state)
-- Block the event loop
-- Ignore errors silently
-- Create buttons without entity category
-- Hardcode entity names
-- Use buttons for binary controls (use switch)
-
-## Button vs. Switch vs. Service
-
-**Use Button when**:
-- One-time action with no state
-- Trigger command (reboot, identify)
-- User initiates action
-
-**Use Switch when**:
-- Binary control (on/off)
-- State matters
-- Can be turned on and off
-
-**Use Service when**:
-- Complex parameters needed
-- Multiple related actions
-- Integration-wide operations
-
-## Troubleshooting
-
-### Button Not Appearing
-
-Check:
-- [ ] Unique ID is set
-- [ ] Platform is in PLATFORMS list
-- [ ] Entity is added with async_add_entities
-- [ ] async_press is implemented
-
-### Button Press Not Working
-
-Check:
-- [ ] async_press is async def
-- [ ] Not blocking the event loop
-- [ ] API client is working
-- [ ] Errors are being raised properly
-
-### Button Not in Expected Category
-
-Check:
-- [ ] entity_category is set
-- [ ] Using correct EntityCategory value
-- [ ] Device class is appropriate
-
-## Quality Scale Considerations
-
-- **Bronze**: Unique ID required
-- **Gold**: Entity translations, device class, entity category
-- **Platinum**: Full type hints
-
-## References
-
-- [Button Documentation](https://developers.home-assistant.io/docs/core/entity/button)
-- [Button Integration](https://www.home-assistant.io/integrations/button/)

.claude/references/diagnostics.md

@@ -1,420 +0,0 @@
-# Diagnostics Reference
-
-## Overview
-
-Diagnostics provide a way to collect and export integration data for troubleshooting purposes. This is a **Gold tier** quality scale requirement that helps users and developers debug issues.
-
-## When to Implement Diagnostics
-
-Diagnostics are required for:
-- ✅ Gold tier and above integrations
-- ✅ Any integration where users might need support
-- ✅ Integrations with complex configuration or state
-
-## Diagnostics Types
-
-Home Assistant supports two types of diagnostics:
-
-### 1. Config Entry Diagnostics
-Provides data about a specific configuration entry.
-
-**File**: `diagnostics.py` in your integration folder
-
-```python
-"""Diagnostics support for My Integration."""
-from typing import Any
-
-from homeassistant.config_entries import ConfigEntry
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import device_registry as dr, entity_registry as er
-
-from .const import DOMAIN
-
-TO_REDACT = {
-    "api_key",
-    "access_token",
-    "refresh_token",
-    "password",
-    "username",
-    "email",
-    "latitude",
-    "longitude",
-}
-
-async def async_get_config_entry_diagnostics(
-    hass: HomeAssistant,
-    entry: ConfigEntry,
-) -> dict[str, Any]:
-    """Return diagnostics for a config entry."""
-    coordinator = entry.runtime_data
-
-    return {
-        "entry": {
-            "title": entry.title,
-            "data": async_redact_data(entry.data, TO_REDACT),
-            "options": async_redact_data(entry.options, TO_REDACT),
-        },
-        "coordinator_data": coordinator.data.to_dict(),
-        "last_update_success": coordinator.last_update_success,
-        "last_update": coordinator.last_update_success_time.isoformat()
-        if coordinator.last_update_success_time
-        else None,
-    }
-```
-
-### 2. Device Diagnostics
-Provides data about a specific device.
-
-```python
-async def async_get_device_diagnostics(
-    hass: HomeAssistant,
-    entry: ConfigEntry,
-    device: dr.DeviceEntry,
-) -> dict[str, Any]:
-    """Return diagnostics for a device."""
-    coordinator = entry.runtime_data
-
-    # Find device identifier
-    device_id = None
-    for identifier in device.identifiers:
-        if identifier[0] == DOMAIN:
-            device_id = identifier[1]
-            break
-
-    if device_id is None:
-        return {}
-
-    device_data = coordinator.data.devices.get(device_id)
-    if device_data is None:
-        return {}
-
-    return {
-        "device_info": {
-            "id": device_id,
-            "name": device_data.name,
-            "model": device_data.model,
-            "firmware": device_data.firmware_version,
-        },
-        "device_data": device_data.to_dict(),
-        "entities": [
-            {
-                "entity_id": entity.entity_id,
-                "name": entity.name,
-                "state": hass.states.get(entity.entity_id).state
-                if (state := hass.states.get(entity.entity_id))
-                else None,
-            }
-            for entity in er.async_entries_for_device(
-                er.async_get(hass), device.id, include_disabled_entities=True
-            )
-        ],
-    }
-```
-
-## Data Redaction
-
-**CRITICAL**: Always redact sensitive information!
-
-### What to Redact
-
-Always redact:
-- API keys, tokens, secrets
-- Passwords, credentials
-- Email addresses, usernames
-- Precise GPS coordinates (latitude, longitude)
-- MAC addresses (sometimes)
-- Serial numbers (if sensitive)
-- Personal information
-
-### Using async_redact_data
-
-```python
-from homeassistant.helpers import async_redact_data
-
-# Basic redaction
-data = async_redact_data(entry.data, TO_REDACT)
-
-# With nested redaction
-TO_REDACT = {
-    "api_key",
-    "auth.password",  # Nested key
-    "user.email",     # Nested key
-}
-
-# Redacting from multiple sources
-diagnostics = {
-    "config": async_redact_data(entry.data, TO_REDACT),
-    "options": async_redact_data(entry.options, TO_REDACT),
-    "coordinator": async_redact_data(coordinator.data, TO_REDACT),
-}
-```
-
-### Custom Redaction
-
-For complex data structures:
-
-```python
-def redact_device_data(data: dict[str, Any]) -> dict[str, Any]:
-    """Redact sensitive device data."""
-    redacted = data.copy()
-
-    # Redact specific fields
-    if "serial_number" in redacted:
-        redacted["serial_number"] = "**REDACTED**"
-
-    # Redact nested structures
-    if "location" in redacted:
-        redacted["location"] = {
-            "city": redacted["location"].get("city"),
-            # Don't include exact coordinates
-        }
-
-    return redacted
-```
-
-## What to Include
-
-### Good Diagnostic Data
-
-Include information helpful for troubleshooting:
-- ✅ Integration version/state
-- ✅ Configuration (redacted)
-- ✅ Coordinator/connection status
-- ✅ Device information (model, firmware)
-- ✅ API response examples (redacted)
-- ✅ Error states
-- ✅ Entity states
-- ✅ Feature flags/capabilities
-
-### Example Comprehensive Diagnostics
-
-```python
-async def async_get_config_entry_diagnostics(
-    hass: HomeAssistant,
-    entry: ConfigEntry,
-) -> dict[str, Any]:
-    """Return diagnostics for a config entry."""
-    coordinator = entry.runtime_data
-
-    return {
-        # Integration state
-        "integration": {
-            "version": coordinator.version,
-            "entry_id": entry.entry_id,
-            "title": entry.title,
-            "state": entry.state,
-        },
-        # Configuration (redacted)
-        "configuration": {
-            "data": async_redact_data(entry.data, TO_REDACT),
-            "options": async_redact_data(entry.options, TO_REDACT),
-        },
-        # Connection/Coordinator status
-        "coordinator": {
-            "last_update_success": coordinator.last_update_success,
-            "last_update": coordinator.last_update_success_time.isoformat()
-            if coordinator.last_update_success_time
-            else None,
-            "update_interval": coordinator.update_interval.total_seconds(),
-            "last_exception": str(coordinator.last_exception)
-            if coordinator.last_exception
-            else None,
-        },
-        # Device/System information
-        "devices": {
-            device_id: {
-                "name": device.name,
-                "model": device.model,
-                "firmware": device.firmware,
-                "features": device.supported_features,
-                "state": device.state,
-            }
-            for device_id, device in coordinator.data.devices.items()
-        },
-        # API information (redacted)
-        "api": {
-            "endpoint": coordinator.client.endpoint,
-            "authenticated": coordinator.client.is_authenticated,
-            "rate_limit_remaining": coordinator.client.rate_limit_remaining,
-        },
-    }
-```
-
-## Testing Diagnostics
-
-### Test File Structure
-
-```python
-"""Test diagnostics."""
-from homeassistant.core import HomeAssistant
-from pytest_homeassistant_custom_component.common import MockConfigEntry
-
-from tests.components.my_integration import setup_integration
-
-
-async def test_entry_diagnostics(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_api,
-) -> None:
-    """Test config entry diagnostics."""
-    await setup_integration(hass, mock_config_entry)
-
-    diagnostics = await get_diagnostics_for_config_entry(
-        hass, hass_client, mock_config_entry
-    )
-
-    # Verify structure
-    assert "entry" in diagnostics
-    assert "coordinator_data" in diagnostics
-
-    # Verify redaction
-    assert "api_key" not in str(diagnostics)
-    assert "password" not in str(diagnostics)
-
-    # Verify useful data is present
-    assert diagnostics["entry"]["title"] == "My Device"
-    assert diagnostics["coordinator_data"]["devices"]
-
-
-async def test_device_diagnostics(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    device_registry: dr.DeviceRegistry,
-) -> None:
-    """Test device diagnostics."""
-    await setup_integration(hass, mock_config_entry)
-
-    device = device_registry.async_get_device(
-        identifiers={(DOMAIN, "device_id")}
-    )
-    assert device
-
-    diagnostics = await get_diagnostics_for_device(
-        hass, hass_client, mock_config_entry, device
-    )
-
-    # Verify device-specific data
-    assert diagnostics["device_info"]["id"] == "device_id"
-    assert "entities" in diagnostics
-```
-
-## Common Patterns
-
-### Pattern 1: Coordinator-Based Integration
-
-```python
-async def async_get_config_entry_diagnostics(
-    hass: HomeAssistant,
-    entry: ConfigEntry,
-) -> dict[str, Any]:
-    """Return diagnostics for a config entry."""
-    coordinator = entry.runtime_data
-
-    return {
-        "coordinator": {
-            "last_update_success": coordinator.last_update_success,
-            "data": coordinator.data.to_dict(),
-        }
-    }
-```
-
-### Pattern 2: Multiple Coordinators
-
-```python
-async def async_get_config_entry_diagnostics(
-    hass: HomeAssistant,
-    entry: ConfigEntry,
-) -> dict[str, Any]:
-    """Return diagnostics for a config entry."""
-    data = entry.runtime_data
-
-    return {
-        "device_coordinator": data.device_coordinator.data.to_dict(),
-        "status_coordinator": data.status_coordinator.data.to_dict(),
-    }
-```
-
-### Pattern 3: Hub with Multiple Devices
-
-```python
-async def async_get_config_entry_diagnostics(
-    hass: HomeAssistant,
-    entry: ConfigEntry,
-) -> dict[str, Any]:
-    """Return diagnostics for a config entry."""
-    hub = entry.runtime_data
-
-    return {
-        "hub": {
-            "connected": hub.connected,
-            "version": hub.version,
-        },
-        "devices": {
-            device_id: device.to_dict()
-            for device_id, device in hub.devices.items()
-        },
-    }
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Redact all sensitive information
-- Include coordinator state and update times
-- Provide device/system information
-- Include error messages (if present)
-- Make data easily readable
-- Test that redaction works
-- Include API/connection status
-
-### ❌ DON'T
-
-- Include raw passwords, tokens, or API keys
-- Include precise GPS coordinates
-- Include personal information (emails, names)
-- Make diagnostics too large (>1MB)
-- Include binary data
-- Assume all fields are present (use .get())
-- Include sensitive serial numbers
-
-## Troubleshooting
-
-### Diagnostics Not Appearing
-
-Check:
-1. File named `diagnostics.py` in integration folder
-2. Function named exactly `async_get_config_entry_diagnostics`
-3. Proper import of `ConfigEntry` and `HomeAssistant`
-4. Integration is loaded successfully
-
-### Redaction Not Working
-
-Check:
-1. Using `async_redact_data` from `homeassistant.helpers`
-2. Field names match exactly (case-sensitive)
-3. Nested fields use dot notation: `"auth.password"`
-4. TO_REDACT is a set, not a list
-
-### Device Diagnostics Not Working
-
-Check:
-1. Device has proper identifiers
-2. Function named exactly `async_get_device_diagnostics`
-3. Device parameter is `dr.DeviceEntry`
-4. Proper device lookup logic
-
-## Quality Scale Considerations
-
-Diagnostics are required for **Gold tier** integrations:
-- Must implement config entry diagnostics
-- Should implement device diagnostics (if applicable)
-- Must redact all sensitive information
-- Should provide comprehensive troubleshooting data
-
-## References
-
-- Quality Scale Rule: `diagnostics`
-- Home Assistant Docs: [Integration Diagnostics](https://developers.home-assistant.io/docs/integration_fetching_data)
-- Helper Functions: `homeassistant.helpers.redact`

.claude/references/number.md

@@ -1,508 +0,0 @@
-# Number Platform Reference
-
-## Overview
-
-Number entities allow users to control numeric values within a defined range. They're used for settings like volume, brightness, temperature setpoints, or any numeric configuration parameter.
-
-## Basic Number Implementation
-
-```python
-"""Number platform for my_integration."""
-from homeassistant.components.number import NumberEntity, NumberMode
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers.entity_platform import AddEntitiesCallback
-
-from . import MyConfigEntry
-from .coordinator import MyCoordinator
-from .entity import MyEntity
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up numbers."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MyNumber(coordinator, device_id)
-        for device_id in coordinator.data.devices
-    )
-
-
-class MyNumber(MyEntity, NumberEntity):
-    """Representation of a number."""
-
-    _attr_has_entity_name = True
-    _attr_translation_key = "volume"
-    _attr_native_min_value = 0
-    _attr_native_max_value = 100
-    _attr_native_step = 1
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        """Initialize the number."""
-        super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}_volume"
-
-    @property
-    def native_value(self) -> float | None:
-        """Return the current value."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.volume
-        return None
-
-    async def async_set_native_value(self, value: float) -> None:
-        """Set new value."""
-        await self.coordinator.client.set_volume(self.device_id, int(value))
-        await self.coordinator.async_request_refresh()
-```
-
-## Number Properties
-
-### Core Properties
-
-```python
-class MyNumber(NumberEntity):
-    """Number with all common properties."""
-
-    # Basic identification
-    _attr_has_entity_name = True
-    _attr_translation_key = "brightness"
-    _attr_unique_id = "device_123_brightness"
-
-    # Value range and step
-    _attr_native_min_value = 0
-    _attr_native_max_value = 255
-    _attr_native_step = 1  # or 0.1 for decimals
-
-    # Unit of measurement
-    _attr_native_unit_of_measurement = PERCENTAGE  # or other units
-
-    # Display mode
-    _attr_mode = NumberMode.SLIDER  # or NumberMode.BOX, NumberMode.AUTO
-
-    # Entity category
-    _attr_entity_category = EntityCategory.CONFIG
-
-    @property
-    def native_value(self) -> float | None:
-        """Return current value."""
-        return self.device.brightness
-
-    async def async_set_native_value(self, value: float) -> None:
-        """Set new value."""
-        await self.device.set_brightness(int(value))
-```
-
-### Required Properties
-
-```python
-# Minimum value
-_attr_native_min_value = 0
-
-# Maximum value
-_attr_native_max_value = 100
-
-# Step size (precision)
-_attr_native_step = 1  # Integers
-_attr_native_step = 0.1  # One decimal place
-_attr_native_step = 0.01  # Two decimal places
-```
-
-### Current Value
-
-```python
-@property
-def native_value(self) -> float | None:
-    """Return the current value."""
-    return self.device.current_value
-
-# Or use attribute
-_attr_native_value = 50.0
-```
-
-### Set Value Method
-
-```python
-async def async_set_native_value(self, value: float) -> None:
-    """Update to new value."""
-    await self.device.set_value(value)
-    # Update state
-    self._attr_native_value = value
-    self.async_write_ha_state()
-```
-
-## Display Mode
-
-Control how the number is displayed in the UI:
-
-```python
-from homeassistant.components.number import NumberMode
-
-# Slider (default for ranges)
-_attr_mode = NumberMode.SLIDER
-
-# Input box (better for precise values or large ranges)
-_attr_mode = NumberMode.BOX
-
-# Auto (let HA decide based on range)
-_attr_mode = NumberMode.AUTO
-```
-
-**When to use each**:
-- `SLIDER`: Small ranges (0-100), settings like volume/brightness
-- `BOX`: Large ranges, precise values, IDs or codes
-- `AUTO`: Let Home Assistant decide (default)
-
-## Device Class
-
-Use device classes for proper representation:
-
-```python
-from homeassistant.components.number import NumberDeviceClass
-
-# Common device classes
-_attr_device_class = NumberDeviceClass.TEMPERATURE
-_attr_device_class = NumberDeviceClass.HUMIDITY
-_attr_device_class = NumberDeviceClass.VOLTAGE
-_attr_device_class = NumberDeviceClass.CURRENT
-_attr_device_class = NumberDeviceClass.POWER
-_attr_device_class = NumberDeviceClass.BATTERY
-_attr_device_class = NumberDeviceClass.DISTANCE
-_attr_device_class = NumberDeviceClass.DURATION
-```
-
-## Units of Measurement
-
-```python
-from homeassistant.const import (
-    PERCENTAGE,
-    UnitOfTemperature,
-    UnitOfTime,
-)
-
-# Percentage (0-100)
-_attr_native_unit_of_measurement = PERCENTAGE
-
-# Temperature
-_attr_native_unit_of_measurement = UnitOfTemperature.CELSIUS
-
-# Time
-_attr_native_unit_of_measurement = UnitOfTime.SECONDS
-
-# Custom units
-_attr_native_unit_of_measurement = "dB"  # Decibels
-```
-
-## Entity Descriptions Pattern
-
-For multiple number entities:
-
-```python
-from dataclasses import dataclass
-from collections.abc import Awaitable, Callable
-
-from homeassistant.components.number import NumberEntityDescription, NumberMode
-
-
-@dataclass(frozen=True, kw_only=True)
-class MyNumberDescription(NumberEntityDescription):
-    """Describes a number."""
-    value_fn: Callable[[MyData], float | None]
-    set_fn: Callable[[MyClient, str, float], Awaitable[None]]
-
-
-NUMBERS: tuple[MyNumberDescription, ...] = (
-    MyNumberDescription(
-        key="volume",
-        translation_key="volume",
-        native_min_value=0,
-        native_max_value=100,
-        native_step=1,
-        native_unit_of_measurement=PERCENTAGE,
-        mode=NumberMode.SLIDER,
-        entity_category=EntityCategory.CONFIG,
-        value_fn=lambda data: data.volume,
-        set_fn=lambda client, device_id, value: client.set_volume(device_id, int(value)),
-    ),
-    MyNumberDescription(
-        key="temperature_setpoint",
-        translation_key="temperature_setpoint",
-        device_class=NumberDeviceClass.TEMPERATURE,
-        native_min_value=16,
-        native_max_value=30,
-        native_step=0.5,
-        native_unit_of_measurement=UnitOfTemperature.CELSIUS,
-        mode=NumberMode.SLIDER,
-        value_fn=lambda data: data.target_temperature,
-        set_fn=lambda client, device_id, value: client.set_temperature(device_id, value),
-    ),
-)
-
-
-class MyNumber(MyEntity, NumberEntity):
-    """Number using entity description."""
-
-    entity_description: MyNumberDescription
-
-    def __init__(
-        self,
-        coordinator: MyCoordinator,
-        device_id: str,
-        description: MyNumberDescription,
-    ) -> None:
-        """Initialize the number."""
-        super().__init__(coordinator, device_id)
-        self.entity_description = description
-        self._attr_unique_id = f"{device_id}_{description.key}"
-
-    @property
-    def native_value(self) -> float | None:
-        """Return current value."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return self.entity_description.value_fn(device)
-        return None
-
-    async def async_set_native_value(self, value: float) -> None:
-        """Set new value."""
-        await self.entity_description.set_fn(
-            self.coordinator.client,
-            self.device_id,
-            value,
-        )
-        await self.coordinator.async_request_refresh()
-```
-
-## Value Validation
-
-Home Assistant validates against min/max/step, but you can add custom validation:
-
-```python
-async def async_set_native_value(self, value: float) -> None:
-    """Set value with custom validation."""
-    # Custom validation
-    if value % 5 != 0:
-        raise ValueError("Value must be multiple of 5")
-
-    await self.device.set_value(value)
-    await self.coordinator.async_request_refresh()
-```
-
-## State Update Patterns
-
-### Pattern 1: Optimistic Update
-
-```python
-async def async_set_native_value(self, value: float) -> None:
-    """Set value with optimistic update."""
-    # Update immediately
-    self._attr_native_value = value
-    self.async_write_ha_state()
-
-    try:
-        await self.device.set_value(value)
-    except DeviceError:
-        # Revert on error
-        await self.coordinator.async_request_refresh()
-        raise
-```
-
-### Pattern 2: Coordinator Refresh
-
-```python
-async def async_set_native_value(self, value: float) -> None:
-    """Set value and refresh."""
-    await self.device.set_value(value)
-    # Get actual value from device
-    await self.coordinator.async_request_refresh()
-```
-
-### Pattern 3: Direct State Update
-
-```python
-async def async_set_native_value(self, value: float) -> None:
-    """Set value with direct state update."""
-    new_value = await self.device.set_value(value)
-    # Device returns actual value
-    self._attr_native_value = new_value
-    self.async_write_ha_state()
-```
-
-## Testing Numbers
-
-### Snapshot Testing
-
-```python
-"""Test numbers."""
-import pytest
-from syrupy import SnapshotAssertion
-
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import entity_registry as er
-
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default")
-async def test_numbers(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    mock_config_entry: MockConfigEntry,
-    init_integration,
-) -> None:
-    """Test number entities."""
-    await snapshot_platform(
-        hass,
-        entity_registry,
-        snapshot,
-        mock_config_entry.entry_id,
-    )
-```
-
-### Value Testing
-
-```python
-from homeassistant.const import ATTR_ENTITY_ID
-from homeassistant.components.number import (
-    ATTR_VALUE,
-    DOMAIN as NUMBER_DOMAIN,
-    SERVICE_SET_VALUE,
-)
-
-
-async def test_set_value(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_device,
-) -> None:
-    """Test setting number value."""
-    await init_integration(hass, mock_config_entry)
-
-    # Check initial value
-    state = hass.states.get("number.my_device_volume")
-    assert state
-    assert state.state == "50"
-    assert state.attributes["min"] == 0
-    assert state.attributes["max"] == 100
-    assert state.attributes["step"] == 1
-
-    # Set new value
-    await hass.services.async_call(
-        NUMBER_DOMAIN,
-        SERVICE_SET_VALUE,
-        {
-            ATTR_ENTITY_ID: "number.my_device_volume",
-            ATTR_VALUE: 75,
-        },
-        blocking=True,
-    )
-
-    mock_device.set_volume.assert_called_once_with(75)
-
-    # Verify state updated
-    state = hass.states.get("number.my_device_volume")
-    assert state.state == "75"
-```
-
-## Common Number Types
-
-### Volume Control
-
-```python
-class VolumeNumber(NumberEntity):
-    """Volume control."""
-
-    _attr_native_min_value = 0
-    _attr_native_max_value = 100
-    _attr_native_step = 1
-    _attr_native_unit_of_measurement = PERCENTAGE
-    _attr_mode = NumberMode.SLIDER
-```
-
-### Temperature Setpoint
-
-```python
-class TemperatureNumber(NumberEntity):
-    """Temperature setpoint."""
-
-    _attr_device_class = NumberDeviceClass.TEMPERATURE
-    _attr_native_min_value = 16.0
-    _attr_native_max_value = 30.0
-    _attr_native_step = 0.5
-    _attr_native_unit_of_measurement = UnitOfTemperature.CELSIUS
-    _attr_mode = NumberMode.SLIDER
-```
-
-### Duration Setting
-
-```python
-class DurationNumber(NumberEntity):
-    """Duration setting."""
-
-    _attr_device_class = NumberDeviceClass.DURATION
-    _attr_native_min_value = 0
-    _attr_native_max_value = 3600
-    _attr_native_step = 60  # 1 minute steps
-    _attr_native_unit_of_measurement = UnitOfTime.SECONDS
-    _attr_mode = NumberMode.BOX
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Set appropriate min/max/step values
-- Use device class when available
-- Use standard units
-- Set display mode appropriately
-- Implement unique IDs
-- Use translation keys
-- Mark config numbers with entity_category
-- Handle value updates properly
-
-### ❌ DON'T
-
-- Allow invalid ranges (min > max)
-- Use zero or negative step
-- Block the event loop
-- Ignore validation errors
-- Create numbers without min/max/step
-- Hardcode entity names
-- Use for binary values (use switch)
-- Use for selection from list (use select)
-
-## Troubleshooting
-
-### Number Not Appearing
-
-Check:
-- [ ] Unique ID is set
-- [ ] Platform is in PLATFORMS list
-- [ ] min/max/step are all set
-- [ ] Entity is added with async_add_entities
-
-### Value Not Updating
-
-Check:
-- [ ] async_set_native_value is called
-- [ ] Coordinator refresh is working
-- [ ] native_value returns correct value
-- [ ] Value is within min/max range
-
-### UI Shows Wrong Control Type
-
-Check:
-- [ ] mode is set correctly
-- [ ] Range is appropriate for mode
-- [ ] Step size is reasonable
-
-## Quality Scale Considerations
-
-- **Bronze**: Unique ID required
-- **Gold**: Entity translations, device class, entity category
-- **Platinum**: Full type hints
-
-## References
-
-- [Number Documentation](https://developers.home-assistant.io/docs/core/entity/number)
-- [Number Integration](https://www.home-assistant.io/integrations/number/)

.claude/references/select.md

@@ -1,520 +0,0 @@
-# Select Platform Reference
-
-## Overview
-
-Select entities allow users to choose from a predefined list of options. They're used for settings like operation modes, presets, input sources, or any configuration with a fixed set of choices.
-
-## Basic Select Implementation
-
-```python
-"""Select platform for my_integration."""
-from homeassistant.components.select import SelectEntity
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers.entity_platform import AddEntitiesCallback
-
-from . import MyConfigEntry
-from .coordinator import MyCoordinator
-from .entity import MyEntity
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up selects."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MySelect(coordinator, device_id)
-        for device_id in coordinator.data.devices
-    )
-
-
-class MySelect(MyEntity, SelectEntity):
-    """Representation of a select."""
-
-    _attr_has_entity_name = True
-    _attr_translation_key = "operation_mode"
-    _attr_options = ["auto", "cool", "heat", "fan"]
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        """Initialize the select."""
-        super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}_mode"
-
-    @property
-    def current_option(self) -> str | None:
-        """Return the current selected option."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.mode
-        return None
-
-    async def async_select_option(self, option: str) -> None:
-        """Change the selected option."""
-        await self.coordinator.client.set_mode(self.device_id, option)
-        await self.coordinator.async_request_refresh()
-```
-
-## Select Properties
-
-### Core Properties
-
-```python
-class MySelect(SelectEntity):
-    """Select with all common properties."""
-
-    # Basic identification
-    _attr_has_entity_name = True
-    _attr_translation_key = "preset"
-    _attr_unique_id = "device_123_preset"
-
-    # Available options (required)
-    _attr_options = ["comfort", "eco", "away", "sleep"]
-
-    # Entity category
-    _attr_entity_category = EntityCategory.CONFIG
-
-    @property
-    def current_option(self) -> str | None:
-        """Return current selected option."""
-        return self.device.preset
-
-    async def async_select_option(self, option: str) -> None:
-        """Set the selected option."""
-        await self.device.set_preset(option)
-```
-
-### Required Properties and Methods
-
-```python
-# List of available options
-_attr_options = ["option1", "option2", "option3"]
-
-# Current selected option
-@property
-def current_option(self) -> str | None:
-    """Return the selected option."""
-    return self.device.current_mode
-
-# Or use attribute
-_attr_current_option = "option1"
-
-# Method to change option
-async def async_select_option(self, option: str) -> None:
-    """Change the selected option."""
-    await self.device.set_option(option)
-```
-
-## Using Enums for Options
-
-Recommended pattern for type safety:
-
-```python
-from enum import StrEnum
-
-
-class OperationMode(StrEnum):
-    """Operation modes."""
-    AUTO = "auto"
-    COOL = "cool"
-    HEAT = "heat"
-    FAN = "fan"
-
-
-class MySelect(SelectEntity):
-    """Select using enum."""
-
-    _attr_options = [mode.value for mode in OperationMode]
-
-    @property
-    def current_option(self) -> str | None:
-        """Return current mode."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.mode
-        return None
-
-    async def async_select_option(self, option: str) -> None:
-        """Set mode."""
-        # Validate option is in enum
-        mode = OperationMode(option)
-        await self.coordinator.client.set_mode(self.device_id, mode)
-        await self.coordinator.async_request_refresh()
-```
-
-## Entity Descriptions Pattern
-
-For multiple select entities:
-
-```python
-from dataclasses import dataclass
-from collections.abc import Awaitable, Callable
-
-from homeassistant.components.select import SelectEntityDescription
-
-
-@dataclass(frozen=True, kw_only=True)
-class MySelectDescription(SelectEntityDescription):
-    """Describes a select."""
-    current_fn: Callable[[MyData], str | None]
-    select_fn: Callable[[MyClient, str, str], Awaitable[None]]
-
-
-SELECTS: tuple[MySelectDescription, ...] = (
-    MySelectDescription(
-        key="mode",
-        translation_key="operation_mode",
-        options=["auto", "cool", "heat", "fan"],
-        entity_category=EntityCategory.CONFIG,
-        current_fn=lambda data: data.mode,
-        select_fn=lambda client, device_id, option: client.set_mode(device_id, option),
-    ),
-    MySelectDescription(
-        key="preset",
-        translation_key="preset",
-        options=["comfort", "eco", "away", "sleep"],
-        entity_category=EntityCategory.CONFIG,
-        current_fn=lambda data: data.preset,
-        select_fn=lambda client, device_id, option: client.set_preset(device_id, option),
-    ),
-)
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up selects."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MySelect(coordinator, device_id, description)
-        for device_id in coordinator.data.devices
-        for description in SELECTS
-    )
-
-
-class MySelect(MyEntity, SelectEntity):
-    """Select using entity description."""
-
-    entity_description: MySelectDescription
-
-    def __init__(
-        self,
-        coordinator: MyCoordinator,
-        device_id: str,
-        description: MySelectDescription,
-    ) -> None:
-        """Initialize the select."""
-        super().__init__(coordinator, device_id)
-        self.entity_description = description
-        self._attr_unique_id = f"{device_id}_{description.key}"
-
-    @property
-    def current_option(self) -> str | None:
-        """Return current option."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return self.entity_description.current_fn(device)
-        return None
-
-    async def async_select_option(self, option: str) -> None:
-        """Select option."""
-        await self.entity_description.select_fn(
-            self.coordinator.client,
-            self.device_id,
-            option,
-        )
-        await self.coordinator.async_request_refresh()
-```
-
-## Dynamic Options
-
-If options change based on device state:
-
-```python
-class MyDynamicSelect(SelectEntity):
-    """Select with dynamic options."""
-
-    @property
-    def options(self) -> list[str]:
-        """Return available options based on device state."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.available_modes
-        return []
-
-    @property
-    def current_option(self) -> str | None:
-        """Return current option."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.current_mode
-        return None
-
-    async def async_select_option(self, option: str) -> None:
-        """Select option."""
-        await self.device.set_mode(option)
-        await self.coordinator.async_request_refresh()
-```
-
-## Option Translation
-
-Use translation keys for user-friendly option labels:
-
-```json
-// strings.json
-{
-  "entity": {
-    "select": {
-      "operation_mode": {
-        "name": "Operation mode",
-        "state": {
-          "auto": "Automatic",
-          "cool": "Cooling",
-          "heat": "Heating",
-          "fan": "Fan only"
-        }
-      }
-    }
-  }
-}
-```
-
-```python
-class MySelect(SelectEntity):
-    """Select with translated options."""
-
-    _attr_translation_key = "operation_mode"
-    _attr_options = ["auto", "cool", "heat", "fan"]
-```
-
-## State Update Patterns
-
-### Pattern 1: Optimistic Update
-
-```python
-async def async_select_option(self, option: str) -> None:
-    """Select option with optimistic update."""
-    # Update immediately
-    self._attr_current_option = option
-    self.async_write_ha_state()
-
-    try:
-        await self.device.set_option(option)
-    except DeviceError:
-        # Revert on error
-        await self.coordinator.async_request_refresh()
-        raise
-```
-
-### Pattern 2: Coordinator Refresh
-
-```python
-async def async_select_option(self, option: str) -> None:
-    """Select option and refresh."""
-    await self.device.set_option(option)
-    # Get actual option from device
-    await self.coordinator.async_request_refresh()
-```
-
-### Pattern 3: Direct State Update
-
-```python
-async def async_select_option(self, option: str) -> None:
-    """Select option with direct state update."""
-    actual_option = await self.device.set_option(option)
-    # Device returns actual option
-    self._attr_current_option = actual_option
-    self.async_write_ha_state()
-```
-
-## Testing Selects
-
-### Snapshot Testing
-
-```python
-"""Test selects."""
-import pytest
-from syrupy import SnapshotAssertion
-
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import entity_registry as er
-
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default")
-async def test_selects(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    mock_config_entry: MockConfigEntry,
-    init_integration,
-) -> None:
-    """Test select entities."""
-    await snapshot_platform(
-        hass,
-        entity_registry,
-        snapshot,
-        mock_config_entry.entry_id,
-    )
-```
-
-### Option Selection Testing
-
-```python
-from homeassistant.const import ATTR_ENTITY_ID, ATTR_OPTION
-from homeassistant.components.select import DOMAIN as SELECT_DOMAIN, SERVICE_SELECT_OPTION
-
-
-async def test_select_option(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_device,
-) -> None:
-    """Test selecting an option."""
-    await init_integration(hass, mock_config_entry)
-
-    # Check initial state
-    state = hass.states.get("select.my_device_mode")
-    assert state
-    assert state.state == "auto"
-    assert state.attributes["options"] == ["auto", "cool", "heat", "fan"]
-
-    # Select new option
-    await hass.services.async_call(
-        SELECT_DOMAIN,
-        SERVICE_SELECT_OPTION,
-        {
-            ATTR_ENTITY_ID: "select.my_device_mode",
-            ATTR_OPTION: "cool",
-        },
-        blocking=True,
-    )
-
-    mock_device.set_mode.assert_called_once_with("cool")
-
-    # Verify state updated
-    state = hass.states.get("select.my_device_mode")
-    assert state.state == "cool"
-```
-
-## Common Select Types
-
-### Operation Mode
-
-```python
-class ModeSelect(SelectEntity):
-    """Operation mode select."""
-
-    _attr_translation_key = "operation_mode"
-    _attr_options = ["auto", "cool", "heat", "fan", "dry"]
-    _attr_entity_category = EntityCategory.CONFIG
-```
-
-### Preset
-
-```python
-class PresetSelect(SelectEntity):
-    """Preset select."""
-
-    _attr_translation_key = "preset"
-    _attr_options = ["comfort", "eco", "away", "sleep", "boost"]
-    _attr_entity_category = EntityCategory.CONFIG
-```
-
-### Input Source
-
-```python
-class InputSourceSelect(SelectEntity):
-    """Input source select."""
-
-    _attr_translation_key = "source"
-    _attr_options = ["hdmi1", "hdmi2", "usb", "bluetooth", "optical"]
-```
-
-### Effect/Scene
-
-```python
-class EffectSelect(SelectEntity):
-    """Light effect select."""
-
-    _attr_translation_key = "effect"
-    _attr_options = ["none", "rainbow", "pulse", "strobe", "breathe"]
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Use enums for type safety
-- Provide translation keys for options
-- Validate selected options
-- Implement unique IDs
-- Use entity_category for config selects
-- Keep option lists reasonable (<20 items)
-- Use consistent option naming (lowercase, underscores)
-- Provide clear option translations
-
-### ❌ DON'T
-
-- Accept options not in the list
-- Have too many options (use input_select helper instead)
-- Block the event loop
-- Hardcode entity names
-- Change options list arbitrarily
-- Use for numeric values (use number entity)
-- Use for binary choices (use switch)
-- Have empty options list
-
-## Select vs. Other Entities
-
-**Use Select when**:
-- Fixed list of text options
-- Modes, presets, or settings
-- 2-20 options
-
-**Use Switch when**:
-- Binary on/off control
-- Only 2 states
-
-**Use Number when**:
-- Numeric range
-- Continuous values
-
-**Use Input Select when**:
-- User-defined options
-- Need dynamic option list
-- Helper/template integration
-
-## Troubleshooting
-
-### Select Not Appearing
-
-Check:
-- [ ] Unique ID is set
-- [ ] Platform is in PLATFORMS list
-- [ ] options list is not empty
-- [ ] Entity is added with async_add_entities
-
-### Option Not Accepted
-
-Check:
-- [ ] Option is in options list (case-sensitive)
-- [ ] Options list is properly formatted
-- [ ] async_select_option handles the option
-
-### Options Not Translating
-
-Check:
-- [ ] translation_key is set
-- [ ] strings.json has state translations
-- [ ] Option keys match exactly
-
-## Quality Scale Considerations
-
-- **Bronze**: Unique ID required
-- **Gold**: Entity translations, entity category
-- **Platinum**: Full type hints, use StrEnum for options
-
-## References
-
-- [Select Documentation](https://developers.home-assistant.io/docs/core/entity/select)
-- [Select Integration](https://www.home-assistant.io/integrations/select/)

.claude/references/sensor.md

@@ -1,560 +0,0 @@
-# Sensor Platform Reference
-
-## Overview
-
-Sensors are read-only entities that represent measurements, states, or information from devices and services. They display numeric values, strings, timestamps, or other data types.
-
-## Basic Sensor Implementation
-
-### Minimal Sensor
-
-```python
-"""Sensor platform for my_integration."""
-from homeassistant.components.sensor import SensorEntity
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers.entity_platform import AddEntitiesCallback
-
-from . import MyConfigEntry
-from .const import DOMAIN
-from .coordinator import MyCoordinator
-from .entity import MyEntity
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up sensors."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MySensor(coordinator, device_id)
-        for device_id in coordinator.data.devices
-    )
-
-
-class MySensor(MyEntity, SensorEntity):
-    """Representation of a sensor."""
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        """Initialize the sensor."""
-        super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}_temperature"
-        self._attr_translation_key = "temperature"
-
-    @property
-    def native_value(self) -> float | None:
-        """Return the sensor value."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.temperature
-        return None
-```
-
-## Sensor Properties
-
-### Core Properties
-
-```python
-class MySensor(SensorEntity):
-    """Sensor with all common properties."""
-
-    # Basic identification
-    _attr_has_entity_name = True  # Required
-    _attr_translation_key = "temperature"  # For translations
-    _attr_unique_id = "device_123_temp"  # Required
-
-    # Device class and units
-    _attr_device_class = SensorDeviceClass.TEMPERATURE
-    _attr_native_unit_of_measurement = UnitOfTemperature.CELSIUS
-    _attr_suggested_display_precision = 1  # Decimal places
-
-    # State class for statistics
-    _attr_state_class = SensorStateClass.MEASUREMENT
-
-    # Entity category
-    _attr_entity_category = EntityCategory.DIAGNOSTIC  # If diagnostic
-
-    # Availability
-    _attr_entity_registry_enabled_default = False  # If noisy/less important
-
-    @property
-    def native_value(self) -> float | None:
-        """Return sensor value."""
-        return self.device.temperature
-
-    @property
-    def available(self) -> bool:
-        """Return if entity is available."""
-        return super().available and self.device_id in self.coordinator.data
-```
-
-## Device Classes
-
-Use device classes for proper representation:
-
-```python
-from homeassistant.components.sensor import SensorDeviceClass
-
-# Common device classes
-_attr_device_class = SensorDeviceClass.TEMPERATURE
-_attr_device_class = SensorDeviceClass.HUMIDITY
-_attr_device_class = SensorDeviceClass.PRESSURE
-_attr_device_class = SensorDeviceClass.BATTERY
-_attr_device_class = SensorDeviceClass.ENERGY
-_attr_device_class = SensorDeviceClass.POWER
-_attr_device_class = SensorDeviceClass.VOLTAGE
-_attr_device_class = SensorDeviceClass.CURRENT
-_attr_device_class = SensorDeviceClass.TIMESTAMP
-_attr_device_class = SensorDeviceClass.MONETARY
-```
-
-Benefits:
-- Automatic unit conversion
-- Proper UI representation
-- Voice assistant integration
-- Historical statistics
-
-## State Classes
-
-For long-term statistics support:
-
-```python
-from homeassistant.components.sensor import SensorStateClass
-
-# Measurement - value at a point in time
-_attr_state_class = SensorStateClass.MEASUREMENT
-# Examples: temperature, humidity, power
-
-# Total - cumulative value that can increase/decrease
-_attr_state_class = SensorStateClass.TOTAL
-# Examples: energy consumed, data transferred
-# Use with last_reset for resettable totals
-
-# Total increasing - cumulative value that only increases
-_attr_state_class = SensorStateClass.TOTAL_INCREASING
-# Examples: lifetime energy, odometer
-```
-
-### When to Use State Classes
-
-✅ **Use MEASUREMENT for**:
-- Temperature, humidity, pressure
-- Current power usage
-- Instantaneous values
-
-✅ **Use TOTAL for**:
-- Daily/monthly energy consumption (resets)
-- Periodic counters
-
-✅ **Use TOTAL_INCREASING for**:
-- Lifetime energy consumption
-- Monotonically increasing counters
-
-❌ **Don't use state class for**:
-- Text/string sensors
-- Status sensors (enum values)
-- Non-numeric sensors
-
-## Unit of Measurement
-
-### Using Standard Units
-
-```python
-from homeassistant.const import (
-    UnitOfTemperature,
-    UnitOfPower,
-    UnitOfEnergy,
-    PERCENTAGE,
-)
-
-# Temperature
-_attr_native_unit_of_measurement = UnitOfTemperature.CELSIUS
-# Auto-converts to user's preference (°F/°C/K)
-
-# Power
-_attr_native_unit_of_measurement = UnitOfPower.WATT
-
-# Energy
-_attr_native_unit_of_measurement = UnitOfEnergy.KILO_WATT_HOUR
-
-# Percentage
-_attr_native_unit_of_measurement = PERCENTAGE
-```
-
-### Custom Units
-
-```python
-# For non-standard units
-_attr_native_unit_of_measurement = "AQI"  # Air Quality Index
-_attr_native_unit_of_measurement = "ppm"  # Parts per million
-```
-
-## Entity Descriptions Pattern
-
-For multiple similar sensors, use SensorEntityDescription:
-
-```python
-from dataclasses import dataclass
-from homeassistant.components.sensor import SensorEntityDescription
-from homeassistant.helpers.typing import StateType
-
-@dataclass(frozen=True, kw_only=True)
-class MySensorDescription(SensorEntityDescription):
-    """Describes a sensor."""
-    value_fn: Callable[[MyData], StateType]
-
-
-SENSORS: tuple[MySensorDescription, ...] = (
-    MySensorDescription(
-        key="temperature",
-        translation_key="temperature",
-        device_class=SensorDeviceClass.TEMPERATURE,
-        native_unit_of_measurement=UnitOfTemperature.CELSIUS,
-        state_class=SensorStateClass.MEASUREMENT,
-        value_fn=lambda data: data.temperature,
-    ),
-    MySensorDescription(
-        key="humidity",
-        translation_key="humidity",
-        device_class=SensorDeviceClass.HUMIDITY,
-        native_unit_of_measurement=PERCENTAGE,
-        state_class=SensorStateClass.MEASUREMENT,
-        value_fn=lambda data: data.humidity,
-    ),
-)
-
-
-class MySensor(MyEntity, SensorEntity):
-    """Sensor using entity description."""
-
-    entity_description: MySensorDescription
-
-    def __init__(
-        self,
-        coordinator: MyCoordinator,
-        description: MySensorDescription,
-        device_id: str,
-    ) -> None:
-        """Initialize the sensor."""
-        super().__init__(coordinator, device_id)
-        self.entity_description = description
-        self._attr_unique_id = f"{device_id}_{description.key}"
-
-    @property
-    def native_value(self) -> StateType:
-        """Return the sensor value."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return self.entity_description.value_fn(device)
-        return None
-```
-
-### Lambda Functions in EntityDescription
-
-When lambdas get long, use proper formatting:
-
-```python
-# ❌ Bad - too long
-SensorEntityDescription(
-    key="temperature",
-    value_fn=lambda data: round(data["temp_value"] * 1.8 + 32, 1) if data.get("temp_value") is not None else None,
-)
-
-# ✅ Good - wrapped properly
-SensorEntityDescription(
-    key="temperature",
-    value_fn=lambda data: (
-        round(data["temp_value"] * 1.8 + 32, 1)
-        if data.get("temp_value") is not None
-        else None
-    ),
-)
-```
-
-## Timestamp Sensors
-
-For datetime values:
-
-```python
-from datetime import datetime
-from homeassistant.components.sensor import SensorDeviceClass
-
-class MyTimestampSensor(SensorEntity):
-    """Timestamp sensor."""
-
-    _attr_device_class = SensorDeviceClass.TIMESTAMP
-
-    @property
-    def native_value(self) -> datetime | None:
-        """Return timestamp."""
-        return self.device.last_update
-```
-
-## Enum Sensors
-
-For sensors with fixed set of possible values:
-
-```python
-from enum import StrEnum
-from homeassistant.components.sensor import SensorEntity
-
-class OperationMode(StrEnum):
-    """Operation modes."""
-    AUTO = "auto"
-    MANUAL = "manual"
-    ECO = "eco"
-
-
-class MyModeSensor(SensorEntity):
-    """Mode sensor."""
-
-    _attr_device_class = SensorDeviceClass.ENUM
-    _attr_options = [mode.value for mode in OperationMode]
-
-    @property
-    def native_value(self) -> str | None:
-        """Return current mode."""
-        return self.device.mode
-```
-
-## Entity Category
-
-Mark diagnostic or configuration sensors:
-
-```python
-from homeassistant.helpers.entity import EntityCategory
-
-# Diagnostic sensors (technical info)
-_attr_entity_category = EntityCategory.DIAGNOSTIC
-# Examples: signal strength, uptime, IP address
-
-# Config sensors (device settings)
-_attr_entity_category = EntityCategory.CONFIG
-# Examples: current mode setting, configuration values
-```
-
-## Disabled by Default
-
-For noisy or less important sensors:
-
-```python
-class MySignalStrengthSensor(SensorEntity):
-    """Signal strength sensor - noisy."""
-
-    _attr_entity_registry_enabled_default = False
-```
-
-## Dynamic Sensor Addition
-
-For devices that appear after setup:
-
-```python
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up sensors with dynamic addition."""
-    coordinator = entry.runtime_data
-    known_devices: set[str] = set()
-
-    @callback
-    def _add_new_devices() -> None:
-        """Add newly discovered devices."""
-        current_devices = set(coordinator.data.devices.keys())
-        new_devices = current_devices - known_devices
-
-        if new_devices:
-            known_devices.update(new_devices)
-            async_add_entities(
-                MySensor(coordinator, device_id)
-                for device_id in new_devices
-            )
-
-    # Initial setup
-    _add_new_devices()
-
-    # Listen for new devices
-    entry.async_on_unload(coordinator.async_add_listener(_add_new_devices))
-```
-
-## Testing Sensors
-
-### Test with Snapshots
-
-```python
-"""Test sensors."""
-import pytest
-from syrupy import SnapshotAssertion
-
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import entity_registry as er
-
-from tests.common import MockConfigEntry
-
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default")
-async def test_sensors(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    mock_config_entry: MockConfigEntry,
-    init_integration,
-) -> None:
-    """Test sensor entities."""
-    await snapshot_platform(
-        hass,
-        entity_registry,
-        snapshot,
-        mock_config_entry.entry_id,
-    )
-```
-
-### Test Sensor Values
-
-```python
-async def test_sensor_values(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-) -> None:
-    """Test sensor values are correct."""
-    await init_integration(hass, mock_config_entry)
-
-    state = hass.states.get("sensor.my_device_temperature")
-    assert state
-    assert state.state == "22.5"
-    assert state.attributes["unit_of_measurement"] == "°C"
-    assert state.attributes["device_class"] == "temperature"
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Use device classes when available
-- Set state classes for statistics
-- Use standard units of measurement
-- Implement unique IDs
-- Use entity descriptions for similar sensors
-- Mark diagnostic sensors with entity_category
-- Disable noisy sensors by default
-- Return None for unknown values
-- Use translation keys for entity names
-
-### ❌ DON'T
-
-- Hardcode entity names
-- Use string "unavailable" or "unknown" as state
-- Mix units (always use native_unit_of_measurement)
-- Create sensors without unique IDs
-- Poll in sensor update if using coordinator
-- Block the event loop
-- Use state class for non-numeric sensors
-
-## Common Patterns
-
-### Pattern 1: Coordinator-Based Sensor
-
-```python
-class MySensor(CoordinatorEntity[MyCoordinator], SensorEntity):
-    """Coordinator-based sensor."""
-
-    _attr_should_poll = False  # Coordinator handles updates
-
-    @property
-    def native_value(self) -> StateType:
-        """Get value from coordinator data."""
-        return self.coordinator.data.get(self.key)
-```
-
-### Pattern 2: Push-Updated Sensor
-
-```python
-class MyPushSensor(SensorEntity):
-    """Push-updated sensor."""
-
-    _attr_should_poll = False
-
-    async def async_added_to_hass(self) -> None:
-        """Subscribe to updates."""
-        self.async_on_remove(
-            self.device.subscribe(self._handle_update)
-        )
-
-    @callback
-    def _handle_update(self, value: float) -> None:
-        """Handle push update."""
-        self._attr_native_value = value
-        self.async_write_ha_state()
-```
-
-### Pattern 3: Calculated Sensor
-
-```python
-class MyCalculatedSensor(SensorEntity):
-    """Calculated from other sensors."""
-
-    _attr_should_poll = False
-
-    async def async_added_to_hass(self) -> None:
-        """Subscribe to source sensors."""
-        self.async_on_remove(
-            async_track_state_change_event(
-                self.hass,
-                ["sensor.source1", "sensor.source2"],
-                self._handle_update,
-            )
-        )
-
-    @callback
-    def _handle_update(self, event: Event) -> None:
-        """Recalculate when sources change."""
-        # Calculate new value
-        self._attr_native_value = self._calculate()
-        self.async_write_ha_state()
-```
-
-## Troubleshooting
-
-### Sensor Not Appearing
-
-Check:
-- [ ] Unique ID is set
-- [ ] Platform is in PLATFORMS list
-- [ ] async_setup_entry is called
-- [ ] Entity is added with async_add_entities
-
-### Values Not Updating
-
-Check:
-- [ ] Coordinator is updating
-- [ ] Entity is available
-- [ ] native_value returns correct data
-- [ ] should_poll is False for coordinator
-
-### Units Not Converting
-
-Check:
-- [ ] Using standard unit constants
-- [ ] Device class is set correctly
-- [ ] Unit matches device class
-
-### Statistics Not Working
-
-Check:
-- [ ] State class is set
-- [ ] Values are numeric
-- [ ] Device class is appropriate
-- [ ] Units are consistent
-
-## Quality Scale Considerations
-
-- **Bronze**: Unique ID required
-- **Gold**: Entity translations, device class, entity category
-- **Platinum**: Full type hints
-
-## References
-
-- [Sensor Documentation](https://developers.home-assistant.io/docs/core/entity/sensor)
-- [Device Classes](https://www.home-assistant.io/integrations/sensor/#device-class)
-- [State Classes](https://developers.home-assistant.io/docs/core/entity/sensor/#available-state-classes)

.claude/references/switch.md

@@ -1,505 +0,0 @@
-# Switch Platform Reference
-
-## Overview
-
-Switches are entities that can be turned on or off. They represent controllable devices like smart plugs, relays, or any binary control. Unlike binary sensors, switches can be controlled by the user.
-
-## Basic Switch Implementation
-
-```python
-"""Switch platform for my_integration."""
-from typing import Any
-
-from homeassistant.components.switch import SwitchEntity
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers.entity_platform import AddEntitiesCallback
-
-from . import MyConfigEntry
-from .coordinator import MyCoordinator
-from .entity import MyEntity
-
-
-async def async_setup_entry(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-    async_add_entities: AddEntitiesCallback,
-) -> None:
-    """Set up switches."""
-    coordinator = entry.runtime_data
-
-    async_add_entities(
-        MySwitch(coordinator, device_id)
-        for device_id in coordinator.data.devices
-    )
-
-
-class MySwitch(MyEntity, SwitchEntity):
-    """Representation of a switch."""
-
-    _attr_has_entity_name = True
-    _attr_translation_key = "outlet"
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        """Initialize the switch."""
-        super().__init__(coordinator, device_id)
-        self._attr_unique_id = f"{device_id}_switch"
-
-    @property
-    def is_on(self) -> bool | None:
-        """Return true if switch is on."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.is_on
-        return None
-
-    async def async_turn_on(self, **kwargs: Any) -> None:
-        """Turn the switch on."""
-        await self.coordinator.client.turn_on(self.device_id)
-        await self.coordinator.async_request_refresh()
-
-    async def async_turn_off(self, **kwargs: Any) -> None:
-        """Turn the switch off."""
-        await self.coordinator.client.turn_off(self.device_id)
-        await self.coordinator.async_request_refresh()
-```
-
-## Switch Properties and Methods
-
-### Core Properties
-
-```python
-@property
-def is_on(self) -> bool | None:
-    """Return true if entity is on."""
-    return self.device.state
-
-# Or use attribute
-_attr_is_on = True  # or False, or None
-```
-
-### Required Methods
-
-```python
-async def async_turn_on(self, **kwargs: Any) -> None:
-    """Turn the entity on."""
-    await self.device.turn_on()
-    # Update state
-    self._attr_is_on = True
-    self.async_write_ha_state()
-
-async def async_turn_off(self, **kwargs: Any) -> None:
-    """Turn the entity off."""
-    await self.device.turn_off()
-    # Update state
-    self._attr_is_on = False
-    self.async_write_ha_state()
-```
-
-### Optional Toggle Method
-
-```python
-async def async_toggle(self, **kwargs: Any) -> None:
-    """Toggle the entity."""
-    # Only implement if device has native toggle
-    await self.device.toggle()
-    await self.coordinator.async_request_refresh()
-```
-
-**Note**: If `async_toggle` is not implemented, Home Assistant will use `async_turn_on`/`async_turn_off` based on current state.
-
-## Device Class
-
-Switches can have device classes to indicate their type:
-
-```python
-from homeassistant.components.switch import SwitchDeviceClass
-
-_attr_device_class = SwitchDeviceClass.OUTLET
-_attr_device_class = SwitchDeviceClass.SWITCH
-```
-
-Device classes:
-- `OUTLET` - Smart plug/outlet
-- `SWITCH` - Generic switch (default)
-
-## State Update Patterns
-
-### Pattern 1: Optimistic Update
-
-For fast UI response:
-
-```python
-async def async_turn_on(self, **kwargs: Any) -> None:
-    """Turn on."""
-    # Update state immediately (optimistic)
-    self._attr_is_on = True
-    self.async_write_ha_state()
-
-    try:
-        await self.coordinator.client.turn_on(self.device_id)
-    except DeviceError:
-        # Revert on error
-        self._attr_is_on = False
-        self.async_write_ha_state()
-        raise
-```
-
-### Pattern 2: Coordinator Refresh
-
-Wait for actual state:
-
-```python
-async def async_turn_on(self, **kwargs: Any) -> None:
-    """Turn on."""
-    await self.coordinator.client.turn_on(self.device_id)
-    # Refresh coordinator to get actual state
-    await self.coordinator.async_request_refresh()
-```
-
-### Pattern 3: Push Update
-
-For push-based systems:
-
-```python
-async def async_turn_on(self, **kwargs: Any) -> None:
-    """Turn on."""
-    # Command device
-    await self.device.turn_on()
-    # State will be updated via push event
-    # No need to call async_write_ha_state()
-```
-
-## Entity Descriptions Pattern
-
-For multiple similar switches:
-
-```python
-from dataclasses import dataclass
-from collections.abc import Awaitable, Callable
-
-from homeassistant.components.switch import SwitchEntityDescription
-
-
-@dataclass(frozen=True, kw_only=True)
-class MySwitchDescription(SwitchEntityDescription):
-    """Describes a switch."""
-    is_on_fn: Callable[[MyData], bool | None]
-    turn_on_fn: Callable[[MyClient, str], Awaitable[None]]
-    turn_off_fn: Callable[[MyClient, str], Awaitable[None]]
-
-
-SWITCHES: tuple[MySwitchDescription, ...] = (
-    MySwitchDescription(
-        key="outlet",
-        translation_key="outlet",
-        device_class=SwitchDeviceClass.OUTLET,
-        is_on_fn=lambda data: data.outlet_state,
-        turn_on_fn=lambda client, device_id: client.turn_on_outlet(device_id),
-        turn_off_fn=lambda client, device_id: client.turn_off_outlet(device_id),
-    ),
-    MySwitchDescription(
-        key="led",
-        translation_key="led",
-        entity_category=EntityCategory.CONFIG,
-        is_on_fn=lambda data: data.led_enabled,
-        turn_on_fn=lambda client, device_id: client.enable_led(device_id),
-        turn_off_fn=lambda client, device_id: client.disable_led(device_id),
-    ),
-)
-
-
-class MySwitch(MyEntity, SwitchEntity):
-    """Switch using entity description."""
-
-    entity_description: MySwitchDescription
-
-    def __init__(
-        self,
-        coordinator: MyCoordinator,
-        device_id: str,
-        description: MySwitchDescription,
-    ) -> None:
-        """Initialize the switch."""
-        super().__init__(coordinator, device_id)
-        self.entity_description = description
-        self._attr_unique_id = f"{device_id}_{description.key}"
-
-    @property
-    def is_on(self) -> bool | None:
-        """Return if switch is on."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return self.entity_description.is_on_fn(device)
-        return None
-
-    async def async_turn_on(self, **kwargs: Any) -> None:
-        """Turn on."""
-        await self.entity_description.turn_on_fn(
-            self.coordinator.client,
-            self.device_id,
-        )
-        await self.coordinator.async_request_refresh()
-
-    async def async_turn_off(self, **kwargs: Any) -> None:
-        """Turn off."""
-        await self.entity_description.turn_off_fn(
-            self.coordinator.client,
-            self.device_id,
-        )
-        await self.coordinator.async_request_refresh()
-```
-
-## Configuration Switches
-
-Switches that control device settings (not physical devices):
-
-```python
-from homeassistant.helpers.entity import EntityCategory
-
-class MyConfigSwitch(SwitchEntity):
-    """Configuration switch."""
-
-    _attr_entity_category = EntityCategory.CONFIG
-    _attr_translation_key = "led_indicator"
-
-    @property
-    def is_on(self) -> bool:
-        """Return if LED is enabled."""
-        return self.device.led_enabled
-
-    async def async_turn_on(self, **kwargs: Any) -> None:
-        """Enable LED indicator."""
-        await self.device.set_led(True)
-        self._attr_is_on = True
-        self.async_write_ha_state()
-
-    async def async_turn_off(self, **kwargs: Any) -> None:
-        """Disable LED indicator."""
-        await self.device.set_led(False)
-        self._attr_is_on = False
-        self.async_write_ha_state()
-```
-
-## Error Handling
-
-Handle errors gracefully:
-
-```python
-async def async_turn_on(self, **kwargs: Any) -> None:
-    """Turn on with error handling."""
-    try:
-        await self.device.turn_on()
-    except DeviceOfflineError as err:
-        # Let entity become unavailable
-        raise HomeAssistantError(f"Device is offline: {err}") from err
-    except DeviceError as err:
-        # Specific error
-        raise HomeAssistantError(f"Failed to turn on: {err}") from err
-    else:
-        self._attr_is_on = True
-        self.async_write_ha_state()
-```
-
-## Testing Switches
-
-### Snapshot Testing
-
-```python
-"""Test switches."""
-import pytest
-from syrupy import SnapshotAssertion
-
-from homeassistant.core import HomeAssistant
-from homeassistant.helpers import entity_registry as er
-
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default")
-async def test_switches(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    mock_config_entry: MockConfigEntry,
-    init_integration,
-) -> None:
-    """Test switch entities."""
-    await snapshot_platform(
-        hass,
-        entity_registry,
-        snapshot,
-        mock_config_entry.entry_id,
-    )
-```
-
-### Control Testing
-
-```python
-from homeassistant.const import (
-    ATTR_ENTITY_ID,
-    SERVICE_TURN_OFF,
-    SERVICE_TURN_ON,
-)
-from homeassistant.components.switch import DOMAIN as SWITCH_DOMAIN
-
-
-async def test_switch_on_off(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_device,
-) -> None:
-    """Test turning switch on and off."""
-    await init_integration(hass, mock_config_entry)
-
-    # Test initial state
-    state = hass.states.get("switch.my_device_outlet")
-    assert state
-    assert state.state == "off"
-
-    # Turn on
-    await hass.services.async_call(
-        SWITCH_DOMAIN,
-        SERVICE_TURN_ON,
-        {ATTR_ENTITY_ID: "switch.my_device_outlet"},
-        blocking=True,
-    )
-    mock_device.turn_on.assert_called_once()
-
-    # Check state updated
-    state = hass.states.get("switch.my_device_outlet")
-    assert state.state == "on"
-
-    # Turn off
-    await hass.services.async_call(
-        SWITCH_DOMAIN,
-        SERVICE_TURN_OFF,
-        {ATTR_ENTITY_ID: "switch.my_device_outlet"},
-        blocking=True,
-    )
-    mock_device.turn_off.assert_called_once()
-
-    state = hass.states.get("switch.my_device_outlet")
-    assert state.state == "off"
-```
-
-## Common Patterns
-
-### Pattern 1: Coordinator-Based Switch
-
-```python
-class MySwitch(CoordinatorEntity[MyCoordinator], SwitchEntity):
-    """Coordinator-based switch."""
-
-    async def async_turn_on(self, **kwargs: Any) -> None:
-        """Turn on."""
-        await self.coordinator.client.turn_on(self.device_id)
-        await self.coordinator.async_request_refresh()
-
-    async def async_turn_off(self, **kwargs: Any) -> None:
-        """Turn off."""
-        await self.coordinator.client.turn_off(self.device_id)
-        await self.coordinator.async_request_refresh()
-
-    @property
-    def is_on(self) -> bool | None:
-        """Return if switch is on."""
-        if device := self.coordinator.data.devices.get(self.device_id):
-            return device.is_on
-        return None
-```
-
-### Pattern 2: Local State Management
-
-```python
-class MyLocalSwitch(SwitchEntity):
-    """Switch with local state."""
-
-    _attr_should_poll = False
-    _attr_is_on = False
-
-    async def async_turn_on(self, **kwargs: Any) -> None:
-        """Turn on."""
-        await self.device.turn_on()
-        self._attr_is_on = True
-        self.async_write_ha_state()
-
-    async def async_turn_off(self, **kwargs: Any) -> None:
-        """Turn off."""
-        await self.device.turn_off()
-        self._attr_is_on = False
-        self.async_write_ha_state()
-```
-
-### Pattern 3: With Additional Control
-
-```python
-class MyAdvancedSwitch(SwitchEntity):
-    """Switch with timer support."""
-
-    async def async_turn_on(self, **kwargs: Any) -> None:
-        """Turn on with optional duration."""
-        duration = kwargs.get("duration")  # Custom kwarg
-
-        if duration:
-            await self.device.turn_on_for(duration)
-        else:
-            await self.device.turn_on()
-
-        await self.coordinator.async_request_refresh()
-```
-
-## Best Practices
-
-### ✅ DO
-
-- Implement both turn_on and turn_off
-- Update state after commands
-- Handle errors properly
-- Use coordinator for state management
-- Implement unique IDs
-- Use translation keys
-- Mark config switches with entity_category
-- Refresh coordinator after commands
-
-### ❌ DON'T
-
-- Block the event loop
-- Ignore errors silently
-- Create switches without unique IDs
-- Mix control and sensing (use separate entities)
-- Poll unnecessarily
-- Hardcode entity names
-- Forget to update state after commands
-
-## Troubleshooting
-
-### Switch Not Responding
-
-Check:
-- [ ] turn_on/turn_off methods are async
-- [ ] Not blocking the event loop
-- [ ] API client is working
-- [ ] Errors are being raised properly
-
-### State Not Updating
-
-Check:
-- [ ] async_write_ha_state() is called
-- [ ] Coordinator refresh is working
-- [ ] is_on returns correct value
-- [ ] Push updates are subscribed
-
-### Switch Appearing as Unavailable
-
-Check:
-- [ ] Device connection is working
-- [ ] Coordinator update is successful
-- [ ] available property returns True
-- [ ] Entity is in coordinator.data
-
-## Quality Scale Considerations
-
-- **Bronze**: Unique ID required
-- **Gold**: Entity translations, device class (if applicable)
-- **Platinum**: Full type hints
-
-## References
-
-- [Switch Documentation](https://developers.home-assistant.io/docs/core/entity/switch)
-- [Switch Integration](https://www.home-assistant.io/integrations/switch/)

.claude/skills/code-review/SKILL.md

@@ -1,285 +0,0 @@
----
-name: code-review
-description: Review Home Assistant integration code for quality, best practices, and standards compliance. Use when reviewing pull requests, identifying anti-patterns, checking security vulnerabilities (OWASP), verifying async patterns, ensuring quality scale compliance, or providing comprehensive code feedback.
----
-
-# Code Review Skill for Home Assistant Integrations
-
-You are an expert Home Assistant code reviewer with deep knowledge of Python, async programming, Home Assistant architecture, and integration best practices.
-
-## Review Guidelines
-
-### What to Review
-✅ **DO review and comment on:**
-- Architecture and design patterns
-- Async programming correctness
-- Error handling and edge cases
-- Security vulnerabilities (XSS, SQL injection, command injection, etc.)
-- Performance issues (blocking operations, inefficient loops)
-- Code organization and clarity
-- Compliance with Home Assistant patterns
-- Quality scale requirements
-- Missing functionality or incomplete implementations
-
-❌ **DO NOT comment on:**
-- Missing imports (static analysis catches this)
-- Code formatting (Ruff handles this)
-- Minor style issues that linters catch
-
-### Git Practices During Review
-⚠️ **CRITICAL**: After review has started:
-- **DO NOT amend commits**
-- **DO NOT squash commits**
-- **DO NOT rebase commits**
-- Reviewers need to see what changed since their last review
-
-## Key Review Areas
-
-### 1. Async Programming Patterns
-
-#### ✅ Good Async Patterns
-```python
-# Proper async I/O
-data = await client.get_data()
-
-# Using asyncio.sleep instead of time.sleep
-await asyncio.sleep(5)
-
-# Executor for blocking operations
-result = await hass.async_add_executor_job(blocking_function, args)
-
-# Gathering async operations
-results = await asyncio.gather(
-    client.get_temp(),
-    client.get_humidity(),
-)
-
-# @callback for event loop safe functions
-@callback
-def async_update_callback(self, event):
-    self.async_write_ha_state()
-```
-
-#### ❌ Bad Async Patterns
-```python
-# Blocking operations in event loop
-data = requests.get(url)  # ❌ Blocks event loop
-time.sleep(5)  # ❌ Blocks event loop
-
-# Awaiting in loops (use gather instead)
-for device in devices:
-    data = await device.get_data()  # ❌ Sequential, slow
-
-# Reusing BleakClient instances
-await self.client.connect()  # ❌ Don't reuse BleakClient
-```
-
-### 2. Error Handling
-
-#### ✅ Good Error Handling
-```python
-# Minimal try blocks, process outside
-try:
-    data = await device.get_data()
-except DeviceError as err:
-    _LOGGER.error("Failed to get data: %s", err)
-    return
-
-# Process data outside try block
-processed = data.get("value", 0) * 100
-self._attr_native_value = processed
-
-# Proper exception types
-try:
-    await client.connect()
-except asyncio.TimeoutError as ex:
-    raise ConfigEntryNotReady(f"Timeout connecting to {host}") from ex
-except AuthError as ex:
-    raise ConfigEntryAuthFailed("Invalid credentials") from ex
-```
-
-#### ❌ Bad Error Handling
-```python
-# Too much code in try block
-try:
-    data = await device.get_data()
-    processed = data.get("value", 0) * 100  # ❌ Should be outside
-    self._attr_native_value = processed
-except DeviceError:
-    _LOGGER.error("Failed")
-
-# Bare exceptions in regular code
-try:
-    data = await device.get_data()
-except Exception:  # ❌ Too broad (unless in config flow/background task)
-    _LOGGER.error("Failed")
-
-# Wrong exception type
-if end_date < start_date:
-    raise ValueError("Invalid dates")  # ❌ Should be ServiceValidationError
-```
-
-### 3. Security Vulnerabilities
-
-Check for OWASP Top 10 vulnerabilities:
-
-```python
-# ❌ Command Injection
-os.system(f"ping {user_input}")  # DANGEROUS
-
-# ✅ Safe alternative
-await hass.async_add_executor_job(
-    subprocess.run,
-    ["ping", user_input],
-    check=True
-)
-
-# ❌ Exposing secrets in diagnostics
-return {"api_key": entry.data[CONF_API_KEY]}  # DANGEROUS
-
-# ✅ Safe alternative
-return async_redact_data(entry.data, {CONF_API_KEY, CONF_PASSWORD})
-```
-
-### 4. Configuration Flow Patterns
-
-#### ✅ Good Config Flow
-```python
-class MyConfigFlow(ConfigFlow, domain=DOMAIN):
-    VERSION = 1
-    MINOR_VERSION = 1
-
-    async def async_step_user(self, user_input=None):
-        errors = {}
-
-        if user_input is not None:
-            try:
-                await self._test_connection(user_input)
-            except ConnectionError:
-                errors["base"] = "cannot_connect"
-            except AuthError:
-                errors["base"] = "invalid_auth"
-            except Exception:  # ✅ Allowed in config flow
-                errors["base"] = "unknown"
-            else:
-                await self.async_set_unique_id(device_id)
-                self._abort_if_unique_id_configured()
-
-                return self.async_create_entry(
-                    title=device_name,
-                    data=user_input,
-                )
-
-        return self.async_show_form(
-            step_id="user",
-            data_schema=vol.Schema({
-                vol.Required(CONF_HOST): str,
-                vol.Required(CONF_API_KEY): str,
-            }),
-            errors=errors,
-        )
-```
-
-### 5. Entity Patterns
-
-#### ✅ Good Entity Patterns
-```python
-class MySensor(CoordinatorEntity[MyCoordinator], SensorEntity):
-    _attr_has_entity_name = True
-    _attr_translation_key = "temperature"
-
-    def __init__(self, coordinator: MyCoordinator, device_id: str) -> None:
-        super().__init__(coordinator)
-        self._attr_unique_id = f"{device_id}_temperature"
-        self._attr_device_info = DeviceInfo(
-            identifiers={(DOMAIN, device_id)},
-            name=coordinator.data[device_id].name,
-        )
-
-    @property
-    def native_value(self) -> float | None:
-        if device_data := self.coordinator.data.get(self.device_id):
-            return device_data.temperature
-        return None
-
-    @property
-    def available(self) -> bool:
-        return super().available and self.device_id in self.coordinator.data
-```
-
-### 6. Quality Scale Compliance
-
-Review manifest.json and quality_scale.yaml:
-
-```json
-{
-  "domain": "my_integration",
-  "name": "My Integration",
-  "codeowners": ["@me"],
-  "config_flow": true,
-  "integration_type": "device",
-  "iot_class": "cloud_polling",
-  "quality_scale": "silver"
-}
-```
-
-Check:
-- [ ] All required Bronze rules implemented or exempted
-- [ ] Rules match declared quality scale tier
-- [ ] Valid exemption reasons provided
-- [ ] manifest.json has all required fields
-
-## Performance Patterns
-
-### ✅ Good Performance
-```python
-# Parallel API calls
-temp, humidity = await asyncio.gather(
-    api.get_temperature(),
-    api.get_humidity(),
-)
-
-# Efficient coordinator usage
-PARALLEL_UPDATES = 0  # Unlimited for coordinator-based
-```
-
-### ❌ Bad Performance
-```python
-# Sequential API calls
-temp = await api.get_temperature()
-humidity = await api.get_humidity()  # ❌ Should use gather
-
-# User-configurable scan intervals
-vol.Optional("scan_interval"): cv.positive_int  # ❌ Not allowed
-```
-
-## Review Process
-
-When reviewing code:
-
-1. **Architecture Review**: Does it follow HA patterns?
-2. **Code Quality**: Are async patterns correct? Is error handling comprehensive?
-3. **Standards Compliance**: Quality scale requirements met?
-4. **Performance & Efficiency**: No blocking operations? Efficient API usage?
-5. **User Experience**: Clear error messages? Proper translations?
-
-## Providing Feedback
-
-Structure feedback as:
-1. **Summary**: Overall assessment
-2. **Critical Issues**: Must fix before merge
-3. **Suggestions**: Nice-to-have improvements
-4. **Positive Notes**: What's done well
-
-Be specific with file:line references and provide code examples.
-
-## Reference Files
-
-For detailed patterns and best practices, see:
-- `.claude/references/diagnostics.md` - Diagnostics implementation
-- `.claude/references/sensor.md` - Sensor platform
-- `.claude/references/binary_sensor.md` - Binary sensor platform
-- `.claude/references/switch.md` - Switch platform
-- `.claude/references/button.md` - Button platform
-- `.claude/references/number.md` - Number platform
-- `.claude/references/select.md` - Select platform

.claude/skills/quality-scale-architect/SKILL.md

@@ -1,297 +0,0 @@
----
-name: quality-scale-architect
-description: Provide architectural guidance and quality scale oversight for Home Assistant integrations. Use when designing integration structure, selecting quality tiers (Bronze/Silver/Gold/Platinum), recommending architectural patterns (coordinator/push/hub), planning quality progression, or advising on integration organization.
----
-
-# Quality Scale Architect for Home Assistant Integrations
-
-You are an expert Home Assistant integration architect specializing in quality scale systems, best practices, and architectural patterns.
-
-## Quality Scale System
-
-### Quality Scale Tiers
-
-**Bronze** - Basic Requirements (Mandatory for all integrations with quality scale)
-- ✅ Config flow (UI configuration)
-- ✅ Entity unique IDs
-- ✅ Action setup (or exempt)
-- ✅ Appropriate setup retries
-- ✅ Reauthentication flow
-- ✅ Reconfigure flow
-- ✅ Test coverage
-
-**Silver** - Enhanced Functionality
-- All Bronze requirements +
-- ✅ Entity unavailable tracking
-- ✅ Parallel updates configuration
-- ✅ Runtime data storage
-- ✅ Unique config entry titles
-
-**Gold** - Advanced Features
-- All Silver requirements +
-- ✅ Device registry usage
-- ✅ Integration diagnostics
-- ✅ Device diagnostics
-- ✅ Entity category
-- ✅ Device class
-- ✅ Disabled by default (for noisy entities)
-- ✅ Entity translations
-- ✅ Exception translations
-- ✅ Icon translations
-
-**Platinum** - Highest Quality Standards
-- All Gold requirements +
-- ✅ Strict typing (full type hints)
-- ✅ Async dependencies (no sync-blocking libs)
-- ✅ WebSession injection
-- ✅ config_entry parameter in coordinator
-
-## Architectural Patterns
-
-### Pattern 1: Coordinator-Based Architecture
-**Use when**: Polling multiple entities from the same API
-
-```python
-class MyCoordinator(DataUpdateCoordinator[MyData]):
-    def __init__(
-        self,
-        hass: HomeAssistant,
-        client: MyClient,
-        config_entry: ConfigEntry,
-    ) -> None:
-        super().__init__(
-            hass,
-            logger=LOGGER,
-            name=DOMAIN,
-            update_interval=timedelta(minutes=5),
-            config_entry=config_entry,  # ✅ Pass for Platinum
-        )
-        self.client = client
-
-    async def _async_update_data(self) -> MyData:
-        try:
-            return await self.client.fetch_data()
-        except ApiError as err:
-            raise UpdateFailed(f"Error: {err}") from err
-```
-
-### Pattern 2: Push-Based Architecture
-**Use when**: Device pushes updates (webhooks, MQTT, WebSocket)
-
-```python
-class MyEntity(SensorEntity):
-    async def async_added_to_hass(self) -> None:
-        self.async_on_remove(
-            self.hub.subscribe_updates(self._handle_update)
-        )
-
-    @callback
-    def _handle_update(self, data: dict) -> None:
-        self._attr_native_value = data["value"]
-        self.async_write_ha_state()
-```
-
-### Pattern 3: Hub with Discovery
-**Use when**: Hub device with multiple discoverable endpoints
-
-```python
-@callback
-def _check_new_devices() -> None:
-    """Check for new devices."""
-    current = set(coordinator.data.devices.keys())
-    new = current - known_devices
-
-    if new:
-        known_devices.update(new)
-        async_dispatcher_send(hass, f"{DOMAIN}_new_device", new)
-
-entry.async_on_unload(coordinator.async_add_listener(_check_new_devices))
-```
-
-## Architectural Decision Guide
-
-### Choosing Integration Type
-
-**Device Integration** (`"integration_type": "device"`)
-- Physical or virtual devices
-- Example: Smart plugs, thermostats, cameras
-
-**Hub Integration** (`"integration_type": "hub"`)
-- Central hub controlling multiple devices
-- Example: Philips Hue bridge, Z-Wave controller
-
-**Service Integration** (`"integration_type": "service"`)
-- Cloud services, APIs
-- Example: Weather services, notification platforms
-
-**Helper Integration** (`"integration_type": "helper"`)
-- Utility integrations
-- Example: Template, group, automation helpers
-
-### Choosing IoT Class
-
-```json
-{
-  "iot_class": "cloud_polling",      // API polling
-  "iot_class": "cloud_push",         // Cloud webhooks/MQTT
-  "iot_class": "local_polling",      // Local device polling
-  "iot_class": "local_push",         // Local device push
-  "iot_class": "calculated"          // No external data
-}
-```
-
-## Quality Scale Progression Strategy
-
-### Starting Bronze (Minimum Viable Integration)
-
-**Essential Components**:
-```
-homeassistant/components/my_integration/
-├── __init__.py          # async_setup_entry, async_unload_entry
-├── manifest.json        # Required fields, quality_scale: "bronze"
-├── const.py            # DOMAIN constant
-├── config_flow.py      # UI configuration with reauth/reconfigure
-├── sensor.py           # Platform with unique IDs
-├── strings.json        # Translations
-└── quality_scale.yaml  # Rule tracking
-
-tests/components/my_integration/
-├── conftest.py         # Test fixtures
-├── test_config_flow.py # 100% coverage
-└── test_sensor.py      # Entity tests
-```
-
-**Bronze Checklist**:
-- [ ] Config flow with UI setup
-- [ ] Reauthentication flow
-- [ ] Reconfigure flow
-- [ ] All entities have unique IDs
-- [ ] Proper setup error handling
-- [ ] >95% test coverage
-- [ ] 100% config flow coverage
-
-### Progressing to Silver
-
-**Add**:
-- Entity unavailability tracking
-- Runtime data storage (not hass.data)
-- Parallel updates configuration
-- Unique entry titles
-
-```python
-# Store in runtime_data (Silver requirement)
-entry.runtime_data = coordinator
-
-# Entity availability (Silver requirement)
-@property
-def available(self) -> bool:
-    return super().available and self.device_id in self.coordinator.data
-
-# Parallel updates (Silver requirement)
-PARALLEL_UPDATES = 0  # For coordinator-based
-```
-
-### Progressing to Gold
-
-**Add**:
-- Device registry entries
-- Integration & device diagnostics
-- Entity categories, device classes
-- Entity translations
-- Exception translations
-- Icon translations
-
-```python
-# Device info (Gold requirement)
-_attr_device_info = DeviceInfo(
-    identifiers={(DOMAIN, device.id)},
-    name=device.name,
-    manufacturer="Manufacturer",
-    model="Model",
-)
-
-# Diagnostics (Gold requirement)
-async def async_get_config_entry_diagnostics(
-    hass: HomeAssistant,
-    entry: MyConfigEntry,
-) -> dict[str, Any]:
-    return {
-        "data": async_redact_data(entry.data, TO_REDACT),
-        "runtime": entry.runtime_data.to_dict(),
-    }
-```
-
-### Progressing to Platinum
-
-**Add**:
-- Comprehensive type hints (py.typed)
-- Async-only dependencies
-- WebSession injection support
-
-```python
-# Type hints (Platinum requirement)
-type MyIntegrationConfigEntry = ConfigEntry[MyClient]
-
-# WebSession injection (Platinum requirement)
-client = MyClient(
-    host=entry.data[CONF_HOST],
-    session=async_get_clientsession(hass),
-)
-
-# Pass config_entry to coordinator (Platinum requirement)
-coordinator = MyCoordinator(hass, client, entry)
-```
-
-## Common Architectural Questions
-
-### Q: Should I use a coordinator?
-**Use coordinator when**:
-- Polling API for multiple entities
-- Want efficient data sharing
-- Need coordinated updates
-
-**Don't use coordinator when**:
-- Push-based updates (use callbacks)
-- Single entity integration
-- Each entity has independent data source
-
-### Q: Where should I store runtime data?
-```python
-# ✅ GOOD - Use runtime_data (Silver+)
-entry.runtime_data = coordinator
-
-# ❌ BAD - Don't use hass.data
-hass.data.setdefault(DOMAIN, {})[entry.entry_id] = coordinator
-```
-
-### Q: When should I create devices vs. just entities?
-**Create devices when**:
-- Representing physical/virtual devices
-- Multiple entities belong to same device
-- Want grouped device management
-
-**Just entities when**:
-- Service integration (no physical device)
-- Single entity integration
-- Calculated/helper entities
-
-## Reference Files
-
-For detailed implementation guidance, see:
-- `.claude/references/diagnostics.md` - Diagnostics implementation
-- `.claude/references/sensor.md` - Sensor platform
-- `.claude/references/binary_sensor.md` - Binary sensor platform
-- `.claude/references/switch.md` - Switch platform
-- `.claude/references/button.md` - Button platform
-- `.claude/references/number.md` - Number platform
-- `.claude/references/select.md` - Select platform
-
-## Your Task
-
-When providing architectural guidance:
-
-1. **Understand Requirements**: What is the integration type? What data needs exposure? Polling or push? What quality tier?
-2. **Recommend Architecture**: Suggest appropriate patterns, identify required components, explain decisions
-3. **Quality Scale Guidance**: Recommend starting tier, identify applicable rules, suggest progression path
-4. **Implementation Plan**: Outline file structure, identify key components, suggest implementation order
-5. **Best Practices**: Performance considerations, maintainability tips, common pitfalls to avoid

.claude/skills/testing/SKILL.md

@@ -1,205 +0,0 @@
----
-name: testing
-description: Write, run, and fix tests for Home Assistant integrations. Use when writing comprehensive test coverage (>95%), running pytest, fixing failing tests, updating snapshots, or following HA testing patterns. Specializes in modern fixture patterns, config flow testing (100% coverage), entity snapshot testing, and mocking external APIs.
----
-
-# Testing Skill for Home Assistant Integrations
-
-You are an expert Home Assistant integration test engineer specializing in writing comprehensive, maintainable tests that follow Home Assistant conventions and best practices.
-
-## Testing Standards
-
-### Coverage Requirements
-- **Minimum Coverage**: 95% for all modules
-- **Config Flow**: 100% coverage required for all paths
-- **Location**: Tests go in `tests/components/{domain}/`
-
-### Test File Organization
-```
-tests/components/my_integration/
-├── __init__.py
-├── conftest.py         # Fixtures and test setup
-├── test_config_flow.py # Config flow tests (100% coverage)
-├── test_sensor.py      # Sensor platform tests
-├── test_init.py        # Integration setup tests
-└── snapshots/          # Generated snapshot files
-```
-
-## Modern Fixture Setup Pattern
-
-Always use this pattern for integration tests:
-
-```python
-from homeassistant.core import HomeAssistant
-from homeassistant.const import Platform
-from pytest_homeassistant_custom_component.common import MockConfigEntry
-
-@pytest.fixture
-def mock_config_entry() -> MockConfigEntry:
-    """Return the default mocked config entry."""
-    return MockConfigEntry(
-        title="My Integration",
-        domain=DOMAIN,
-        data={CONF_HOST: "127.0.0.1", CONF_API_KEY: "test_key"},
-        unique_id="device_unique_id",
-    )
-
-@pytest.fixture
-def mock_device_api() -> Generator[MagicMock]:
-    """Return a mocked device API."""
-    with patch("homeassistant.components.my_integration.MyDeviceAPI", autospec=True) as api_mock:
-        api = api_mock.return_value
-        api.get_data.return_value = MyDeviceData.from_json(
-            load_fixture("device_data.json", DOMAIN)
-        )
-        yield api
-
-@pytest.fixture
-def platforms() -> list[Platform]:
-    """Fixture to specify platforms to test."""
-    return [Platform.SENSOR]
-
-@pytest.fixture
-async def init_integration(
-    hass: HomeAssistant,
-    mock_config_entry: MockConfigEntry,
-    mock_device_api: MagicMock,
-    platforms: list[Platform],
-) -> MockConfigEntry:
-    """Set up the integration for testing."""
-    mock_config_entry.add_to_hass(hass)
-
-    with patch("homeassistant.components.my_integration.PLATFORMS", platforms):
-        await hass.config_entries.async_setup(mock_config_entry.entry_id)
-        await hass.async_block_till_done()
-
-    return mock_config_entry
-```
-
-## Entity Testing with Snapshots
-
-Use snapshot testing for entity verification:
-
-```python
-from syrupy import SnapshotAssertion
-from homeassistant.helpers import entity_registry as er, device_registry as dr
-
-@pytest.mark.usefixtures("entity_registry_enabled_by_default", "init_integration")
-async def test_entities(
-    hass: HomeAssistant,
-    snapshot: SnapshotAssertion,
-    entity_registry: er.EntityRegistry,
-    device_registry: dr.DeviceRegistry,
-    mock_config_entry: MockConfigEntry,
-) -> None:
-    """Test the sensor entities."""
-    await snapshot_platform(hass, entity_registry, snapshot, mock_config_entry.entry_id)
-
-    # Verify entities are assigned to device
-    device_entry = device_registry.async_get_device(
-        identifiers={(DOMAIN, "device_unique_id")}
-    )
-    assert device_entry
-    entity_entries = er.async_entries_for_config_entry(
-        entity_registry, mock_config_entry.entry_id
-    )
-    for entity_entry in entity_entries:
-        assert entity_entry.device_id == device_entry.id
-```
-
-## Config Flow Testing (100% Coverage Required)
-
-Test ALL paths in config flow:
-
-```python
-async def test_user_flow_success(hass, mock_api):
-    """Test successful user flow."""
-    result = await hass.config_entries.flow.async_init(
-        DOMAIN, context={"source": config_entries.SOURCE_USER}
-    )
-    assert result["type"] == FlowResultType.FORM
-    assert result["step_id"] == "user"
-
-    result = await hass.config_entries.flow.async_configure(
-        result["flow_id"], user_input=TEST_USER_INPUT
-    )
-    assert result["type"] == FlowResultType.CREATE_ENTRY
-    assert result["title"] == "My Device"
-    assert result["data"] == TEST_USER_INPUT
-
-async def test_flow_connection_error(hass, mock_api_error):
-    """Test connection error handling."""
-    result = await hass.config_entries.flow.async_init(
-        DOMAIN, context={"source": config_entries.SOURCE_USER}
-    )
-    result = await hass.config_entries.flow.async_configure(
-        result["flow_id"], user_input=TEST_USER_INPUT
-    )
-    assert result["type"] == FlowResultType.FORM
-    assert result["errors"] == {"base": "cannot_connect"}
-
-async def test_flow_duplicate_entry(hass, mock_config_entry, mock_api):
-    """Test duplicate entry prevention."""
-    mock_config_entry.add_to_hass(hass)
-
-    result = await hass.config_entries.flow.async_init(
-        DOMAIN, context={"source": config_entries.SOURCE_USER}
-    )
-    result = await hass.config_entries.flow.async_configure(
-        result["flow_id"], user_input=TEST_USER_INPUT
-    )
-    assert result["type"] == FlowResultType.ABORT
-    assert result["reason"] == "already_configured"
-```
-
-## Running Tests
-
-### Integration-Specific Tests (Recommended)
-```bash
-pytest ./tests/components/<integration_domain> \
-  --cov=homeassistant.components.<integration_domain> \
-  --cov-report term-missing \
-  --durations-min=1 \
-  --durations=0 \
-  --numprocesses=auto
-```
-
-### Quick Test of Changed Files
-```bash
-pytest --timeout=10 --picked
-```
-
-### Update Test Snapshots
-```bash
-pytest ./tests/components/<integration_domain> --snapshot-update
-```
-
-**⚠️ IMPORTANT**: After using `--snapshot-update`:
-1. Run tests again WITHOUT the flag to verify snapshots
-2. Review the snapshot changes carefully
-3. Don't commit snapshot updates without verification
-
-## Critical Testing Rules
-
-### NEVER Do These Things
-- ❌ Don't access `hass.data` directly in tests
-- ❌ Don't test entities in isolation without integration setup
-- ❌ Don't forget to mock external dependencies
-
-### ALWAYS Do These Things
-- ✅ Use proper integration setup through fixtures
-- ✅ Mock all external APIs
-- ✅ Test through the integration's public interface
-- ✅ Use snapshot testing for entities
-- ✅ Achieve 100% config flow coverage
-- ✅ Achieve >95% overall coverage
-
-## Reference Files
-
-For detailed implementation guidance, see:
-- `.claude/references/sensor.md` - Sensor platform patterns
-- `.claude/references/binary_sensor.md` - Binary sensor patterns
-- `.claude/references/switch.md` - Switch platform patterns
-- `.claude/references/button.md` - Button platform patterns
-- `.claude/references/number.md` - Number platform patterns
-- `.claude/references/select.md` - Select platform patterns

.core_files.yaml

@@ -6,14 +6,12 @@ core: &core
   - homeassistant/helpers/**
   - homeassistant/package_constraints.txt
   - homeassistant/util/**
-  - mypy.ini
   - pyproject.toml
   - requirements.txt
   - setup.cfg
 
 # Our base platforms, that are used by other integrations
 base_platforms: &base_platforms
-  - homeassistant/components/ai_task/**
   - homeassistant/components/air_quality/**
   - homeassistant/components/alarm_control_panel/**
   - homeassistant/components/assist_satellite/**
@@ -59,7 +57,6 @@ base_platforms: &base_platforms
 # Extra components that trigger the full suite
 components: &components
   - homeassistant/components/alexa/**
-  - homeassistant/components/analytics/**
   - homeassistant/components/application_credentials/**
   - homeassistant/components/assist_pipeline/**
   - homeassistant/components/auth/**
@@ -82,7 +79,6 @@ components: &components
   - homeassistant/components/group/**
   - homeassistant/components/hassio/**
   - homeassistant/components/homeassistant/**
-  - homeassistant/components/homeassistant_hardware/**
   - homeassistant/components/http/**
   - homeassistant/components/image/**
   - homeassistant/components/input_boolean/**
@@ -115,7 +111,6 @@ components: &components
   - homeassistant/components/tag/**
   - homeassistant/components/template/**
   - homeassistant/components/timer/**
-  - homeassistant/components/trace/**
   - homeassistant/components/usb/**
   - homeassistant/components/webhook/**
   - homeassistant/components/websocket_api/**
@@ -131,13 +126,9 @@ tests: &tests
   - tests/*.py
   - tests/auth/**
   - tests/backports/**
-  - tests/components/conftest.py
-  - tests/components/diagnostics/**
   - tests/components/history/**
-  - tests/components/light/common.py
   - tests/components/logbook/**
   - tests/components/recorder/**
-  - tests/components/repairs/**
   - tests/components/sensor/**
   - tests/hassfest/**
   - tests/helpers/**

.devcontainer/devcontainer.json

@@ -2,37 +2,30 @@
   "name": "Home Assistant Dev",
   "context": "..",
   "dockerFile": "../Dockerfile.dev",
-  "postCreateCommand": "git config --global --add safe.directory ${containerWorkspaceFolder} && script/setup",
+  "postCreateCommand": "script/setup",
   "postStartCommand": "script/bootstrap",
   "containerEnv": {
     "PYTHONASYNCIODEBUG": "1"
   },
   "features": {
-    // Node feature required for Claude Code until fixed https://github.com/anthropics/devcontainer-features/issues/28
-    "ghcr.io/devcontainers/features/node:1": {},
-    "ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {},
     "ghcr.io/devcontainers/features/github-cli:1": {}
   },
   // Port 5683 udp is used by Shelly integration
   "appPort": ["8123:8123", "5683:5683/udp"],
-  "runArgs": [
-    "-e",
-    "GIT_EDITOR=code --wait",
-    "--security-opt",
-    "label=disable"
-  ],
+  "runArgs": ["-e", "GIT_EDITOR=code --wait"],
   "customizations": {
     "vscode": {
       "extensions": [
         "charliermarsh.ruff",
         "ms-python.pylint",
         "ms-python.vscode-pylance",
+        "visualstudioexptteam.vscodeintellicode",
         "redhat.vscode-yaml",
         "esbenp.prettier-vscode",
         "GitHub.vscode-pull-request-github",
         "GitHub.copilot"
       ],
-      // Please keep this file in sync with settings in home-assistant/.vscode/settings.default.jsonc
+      // Please keep this file in sync with settings in home-assistant/.vscode/settings.default.json
       "settings": {
         "python.experiments.optOutFrom": ["pythonTestAdapter"],
         "python.defaultInterpreterPath": "/home/vscode/.local/ha-venv/bin/python",
@@ -40,7 +33,6 @@
         "python.terminal.activateEnvInCurrentTerminal": true,
         "python.testing.pytestArgs": ["--no-cov"],
         "pylint.importStrategy": "fromEnvironment",
-        "python.analysis.typeCheckingMode": "basic",
         "editor.formatOnPaste": false,
         "editor.formatOnSave": true,
         "editor.formatOnType": true,
@@ -61,16 +53,7 @@
         ],
         "[python]": {
           "editor.defaultFormatter": "charliermarsh.ruff"
-        },
-        "[json][jsonc][yaml]": {
-          "editor.defaultFormatter": "esbenp.prettier-vscode"
-        },
-        "json.schemas": [
-          {
-            "fileMatch": ["homeassistant/components/*/manifest.json"],
-            "url": "${containerWorkspaceFolder}/script/json_schemas/manifest_schema.json"
-          }
-        ]
+        }
       }
     }
   }

.dockerignore

@@ -7,15 +7,13 @@ docs
 # Development
 .devcontainer
 .vscode
-.tool-versions
 
 # Test related files
 tests
 
 # Other virtualization methods
 venv
-.venv
 .vagrant
 
 # Temporary files
-**/__pycache__
+**/__pycache__

.gitattributes

@@ -11,14 +11,3 @@
 *.pcm binary
 
 Dockerfile.dev linguist-language=Dockerfile
-
-# Generated files
-CODEOWNERS linguist-generated=true
-Dockerfile linguist-generated=true
-homeassistant/generated/*.py linguist-generated=true
-mypy.ini linguist-generated=true
-requirements.txt linguist-generated=true
-requirements_all.txt linguist-generated=true
-requirements_test_all.txt linguist-generated=true
-requirements_test_pre_commit.txt linguist-generated=true
-script/hassfest/docker/Dockerfile linguist-generated=true

.github/FUNDING.yml

@@ -1 +1,2 @@
-custom: https://www.openhomefoundation.org
+custom: https://www.nabucasa.com
+github: balloob

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -6,9 +6,9 @@ body:
       value: |
         This issue form is for reporting bugs only!
 
-        If you have a feature or enhancement request, please [request them here instead][fr].
+        If you have a feature or enhancement request, please use the [feature request][fr] section of our [Community Forum][fr].
 
-        [fr]: https://github.com/orgs/home-assistant/discussions
+        [fr]: https://community.home-assistant.io/c/feature-requests
   - type: textarea
     validations:
       required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -10,8 +10,8 @@ contact_links:
     url: https://www.home-assistant.io/help
     about: We use GitHub for tracking bugs, check our website for resources on getting help.
   - name: Feature Request
-    url: https://github.com/orgs/home-assistant/discussions
-    about: Please use this link to request new features or enhancements to existing features.
+    url: https://community.home-assistant.io/c/feature-requests
+    about: Please use our Community Forum for making feature requests.
   - name: I'm unsure where to go
     url: https://www.home-assistant.io/join-chat
     about: If you are unsure where to go, then joining our chat is recommended; Just ask!

.github/ISSUE_TEMPLATE/task.yml

@@ -1,53 +0,0 @@
-name: Task
-description: For staff only - Create a task
-type: Task
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ## ⚠️ RESTRICTED ACCESS
-
-        **This form is restricted to Open Home Foundation staff, authorized contributors, and integration code owners only.**
-
-        If you are a community member wanting to contribute, please:
-        - For bug reports: Use the [bug report form](https://github.com/home-assistant/core/issues/new?template=bug_report.yml)
-        - For feature requests: Submit to [Feature Requests](https://github.com/orgs/home-assistant/discussions)
-
-        ---
-
-        ### For authorized contributors
-
-        Use this form to create tasks for development work, improvements, or other actionable items that need to be tracked.
-  - type: textarea
-    id: description
-    attributes:
-      label: Description
-      description: |
-        Provide a clear and detailed description of the task that needs to be accomplished.
-
-        Be specific about what needs to be done, why it's important, and any constraints or requirements.
-      placeholder: |
-        Describe the task, including:
-        - What needs to be done
-        - Why this task is needed
-        - Expected outcome
-        - Any constraints or requirements
-    validations:
-      required: true
-  - type: textarea
-    id: additional_context
-    attributes:
-      label: Additional context
-      description: |
-        Any additional information, links, research, or context that would be helpful.
-
-        Include links to related issues, research, prototypes, roadmap opportunities etc.
-      placeholder: |
-        - Roadmap opportunity: [link]
-        - Epic: [link]
-        - Feature request: [link]
-        - Technical design documents: [link]
-        - Prototype/mockup: [link]
-        - Dependencies: [links]
-    validations:
-      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -46,8 +46,6 @@
 - This PR fixes or closes issue: fixes #
 - This PR is related to issue: 
 - Link to documentation pull request: 
-- Link to developer documentation pull request: 
-- Link to frontend pull request: 
 
 ## Checklist
 <!--
@@ -55,12 +53,8 @@
   creating the PR. If you're unsure about any of them, don't hesitate to ask.
   We're here to help! This is simply a reminder of what we are going to look
   for before merging your code.
-
-  AI tools are welcome, but contributors are responsible for *fully*
-  understanding the code before submitting a PR.
 -->
 
-- [ ] I understand the code I am submitting and can explain how it works.
 - [ ] The code change is tested and works locally.
 - [ ] Local tests pass. **Your PR cannot be merged unless tests pass**
 - [ ] There is no commented out code in this PR.
@@ -68,7 +62,6 @@
 - [ ] I have followed the [perfect PR recommendations][perfect-pr]
 - [ ] The code has been formatted using Ruff (`ruff format homeassistant tests`)
 - [ ] Tests have been added to verify that the new code works.
-- [ ] Any generated code has been carefully reviewed for correctness and compliance with project standards.
 
 If user exposed functionality or configuration variables are added/changed:
 

.github/dependabot.yml

@@ -6,6 +6,3 @@ updates:
       interval: daily
       time: "06:00"
     open-pull-requests-limit: 10
-    labels:
-      - dependency
-      - github_actions

.github/workflows/builder.yml

@@ -10,13 +10,10 @@ on:
 
 env:
   BUILD_TYPE: core
-  DEFAULT_PYTHON: "3.13"
+  DEFAULT_PYTHON: "3.12"
   PIP_TIMEOUT: 60
   UV_HTTP_TIMEOUT: 60
   UV_SYSTEM_PYTHON: "true"
-  # Base image version from https://github.com/home-assistant/docker
-  BASE_IMAGE_VERSION: "2025.12.0"
-  ARCHITECTURES: '["amd64", "aarch64"]'
 
 jobs:
   init:
@@ -24,16 +21,18 @@ jobs:
     if: github.repository_owner == 'home-assistant'
     runs-on: ubuntu-latest
     outputs:
+      architectures: ${{ steps.info.outputs.architectures }}
       version: ${{ steps.version.outputs.version }}
       channel: ${{ steps.version.outputs.channel }}
       publish: ${{ steps.version.outputs.publish }}
-      architectures: ${{ env.ARCHITECTURES }}
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
+        with:
+          fetch-depth: 0
 
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
-        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
 
@@ -70,7 +69,7 @@ jobs:
         run: find ./homeassistant/components/*/translations -name "*.json" | tar zcvf translations.tar.gz -T -
 
       - name: Upload translations
-        uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        uses: actions/upload-artifact@v4.4.0
         with:
           name: translations
           path: translations.tar.gz
@@ -80,7 +79,7 @@ jobs:
     name: Build ${{ matrix.arch }} base core image
     if: github.repository_owner == 'home-assistant'
     needs: init
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     permissions:
       contents: read
       packages: write
@@ -89,18 +88,13 @@ jobs:
       fail-fast: false
       matrix:
         arch: ${{ fromJson(needs.init.outputs.architectures) }}
-        include:
-          - arch: amd64
-            os: ubuntu-latest
-          - arch: aarch64
-            os: ubuntu-24.04-arm
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
 
       - name: Download nightly wheels of frontend
         if: needs.init.outputs.channel == 'dev'
-        uses: dawidd6/action-download-artifact@0bd50d53a6d7fb5cb921e607957e9cc12b4ce392 # v12
+        uses: dawidd6/action-download-artifact@v6
         with:
           github_token: ${{secrets.GITHUB_TOKEN}}
           repo: home-assistant/frontend
@@ -111,10 +105,10 @@ jobs:
 
       - name: Download nightly wheels of intents
         if: needs.init.outputs.channel == 'dev'
-        uses: dawidd6/action-download-artifact@0bd50d53a6d7fb5cb921e607957e9cc12b4ce392 # v12
+        uses: dawidd6/action-download-artifact@v6
         with:
           github_token: ${{secrets.GITHUB_TOKEN}}
-          repo: OHF-Voice/intents-package
+          repo: home-assistant/intents-package
           branch: main
           workflow: nightly.yaml
           workflow_conclusion: success
@@ -122,7 +116,7 @@ jobs:
 
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         if: needs.init.outputs.channel == 'dev'
-        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
 
@@ -132,7 +126,7 @@ jobs:
         env:
           UV_PRERELEASE: allow
         run: |
-          python3 -m pip install "$(grep '^uv' < requirements.txt)"
+          python3 -m pip install "$(grep '^uv' < requirements_test.txt)"
           uv pip install packaging tomli
           uv pip install .
           python3 script/version_bump.py nightly --set-nightly-version "${{ needs.init.outputs.version }}"
@@ -168,8 +162,20 @@ jobs:
             sed -i "s|home-assistant-intents==.*||" requirements_all.txt
           fi
 
+      - name: Adjustments for armhf
+        if: matrix.arch == 'armhf'
+        run: |
+          # Pandas has issues building on armhf, it is expected they
+          # will drop the platform in the near future (they consider it
+          # "flimsy" on 386). The following packages depend on pandas,
+          # so we comment them out.
+          sed -i "s|env-canada|# env-canada|g" requirements_all.txt
+          sed -i "s|noaa-coops|# noaa-coops|g" requirements_all.txt
+          sed -i "s|pyezviz|# pyezviz|g" requirements_all.txt
+          sed -i "s|pykrakenapi|# pykrakenapi|g" requirements_all.txt
+
       - name: Download translations
-        uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
+        uses: actions/download-artifact@v4.1.8
         with:
           name: translations
 
@@ -184,66 +190,21 @@ jobs:
           echo "${{ github.sha }};${{ github.ref }};${{ github.event_name }};${{ github.actor }}" > rootfs/OFFICIAL_IMAGE
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        uses: docker/login-action@v3.3.0
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - &install_cosign
-        name: Install Cosign
-        uses: sigstore/cosign-installer@faadad0cce49287aee09b3a48701e75088a2c6ad # v4.0.0
-        with:
-          cosign-release: "v2.5.3"
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3.12.0
-
-      - name: Build variables
-        id: vars
-        shell: bash
-        run: |
-          echo "base_image=ghcr.io/home-assistant/${{ matrix.arch }}-homeassistant-base:${{ env.BASE_IMAGE_VERSION }}" >> "$GITHUB_OUTPUT"
-          echo "cache_image=ghcr.io/home-assistant/${{ matrix.arch }}-homeassistant:latest" >> "$GITHUB_OUTPUT"
-          echo "created=$(date --rfc-3339=seconds --utc)" >> "$GITHUB_OUTPUT"
-
-      - name: Verify base image signature
-        run: |
-          cosign verify \
-            --certificate-oidc-issuer https://token.actions.githubusercontent.com \
-            --certificate-identity-regexp "https://github.com/home-assistant/docker/.*" \
-            "${{ steps.vars.outputs.base_image }}"
-
-      - name: Verify cache image signature
-        id: cache
-        continue-on-error: true
-        run: |
-          cosign verify \
-            --certificate-oidc-issuer https://token.actions.githubusercontent.com \
-            --certificate-identity-regexp "https://github.com/home-assistant/core/.*" \
-            "${{ steps.vars.outputs.cache_image }}"
-
       - name: Build base image
-        id: build
-        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
+        uses: home-assistant/builder@2024.08.2
         with:
-          context: .
-          file: ./Dockerfile
-          platforms: ${{ steps.vars.outputs.platform }}
-          push: true
-          cache-from: ${{ steps.cache.outcome == 'success' && steps.vars.outputs.cache_image || '' }}
-          build-args: |
-            BUILD_FROM=${{ steps.vars.outputs.base_image }}
-          tags: ghcr.io/home-assistant/${{ matrix.arch }}-homeassistant:${{ needs.init.outputs.version }}
-          labels: |
-            io.hass.arch=${{ matrix.arch }}
-            io.hass.version=${{ needs.init.outputs.version }}
-            org.opencontainers.image.created=${{ steps.vars.outputs.created }}
-            org.opencontainers.image.version=${{ needs.init.outputs.version }}
-
-      - name: Sign image
-        run: |
-          cosign sign --yes "ghcr.io/home-assistant/${{ matrix.arch }}-homeassistant:${{ needs.init.outputs.version }}@${{ steps.build.outputs.digest }}"
+          args: |
+            $BUILD_ARGS \
+            --${{ matrix.arch }} \
+            --cosign \
+            --target /data \
+            --generic ${{ needs.init.outputs.version }}
 
   build_machine:
     name: Build ${{ matrix.machine }} machine core image
@@ -264,16 +225,24 @@ jobs:
           - odroid-c4
           - odroid-m1
           - odroid-n2
+          - odroid-xu
+          - qemuarm
           - qemuarm-64
+          - qemux86
           - qemux86-64
+          - raspberrypi
+          - raspberrypi2
+          - raspberrypi3
           - raspberrypi3-64
+          - raspberrypi4
           - raspberrypi4-64
           - raspberrypi5-64
+          - tinker
           - yellow
           - green
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
 
       - name: Set build additional args
         run: |
@@ -287,15 +256,14 @@ jobs:
           fi
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        uses: docker/login-action@v3.3.0
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      # home-assistant/builder doesn't support sha pinning
       - name: Build base image
-        uses: home-assistant/builder@2025.11.0
+        uses: home-assistant/builder@2024.08.2
         with:
           args: |
             $BUILD_ARGS \
@@ -311,7 +279,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
 
       - name: Initialize git
         uses: home-assistant/actions/helpers/git-init@master
@@ -327,7 +295,6 @@ jobs:
           key-description: "Home Assistant Core"
           version: ${{ needs.init.outputs.version }}
           channel: ${{ needs.init.outputs.channel }}
-          exclude-list: '["odroid-xu","qemuarm","qemux86","raspberrypi","raspberrypi2","raspberrypi3","raspberrypi4","tinker"]'
 
       - name: Update version file (stable -> beta)
         if: needs.init.outputs.channel == 'stable'
@@ -337,7 +304,6 @@ jobs:
           key-description: "Home Assistant Core"
           version: ${{ needs.init.outputs.version }}
           channel: beta
-          exclude-list: '["odroid-xu","qemuarm","qemux86","raspberrypi","raspberrypi2","raspberrypi3","raspberrypi4","tinker"]'
 
   publish_container:
     name: Publish meta container for ${{ matrix.registry }}
@@ -350,139 +316,149 @@ jobs:
       packages: write
       id-token: write
     strategy:
-      fail-fast: false
       matrix:
         registry: ["ghcr.io/home-assistant", "docker.io/homeassistant"]
     steps:
-      - *install_cosign
+      - name: Checkout the repository
+        uses: actions/checkout@v4.1.7
+
+      - name: Install Cosign
+        uses: sigstore/cosign-installer@v3.6.0
+        with:
+          cosign-release: "v2.2.3"
 
       - name: Login to DockerHub
         if: matrix.registry == 'docker.io/homeassistant'
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        uses: docker/login-action@v3.3.0
         with:
           username: ${{ secrets.DOCKERHUB_USERNAME }}
           password: ${{ secrets.DOCKERHUB_TOKEN }}
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        if: matrix.registry == 'ghcr.io/home-assistant'
+        uses: docker/login-action@v3.3.0
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Verify architecture image signatures
+      - name: Build Meta Image
         shell: bash
         run: |
-          ARCHS=$(echo '${{ needs.init.outputs.architectures }}' | jq -r '.[]')
-          for arch in $ARCHS; do
-            echo "Verifying ${arch} image signature..."
-            cosign verify \
-              --certificate-oidc-issuer https://token.actions.githubusercontent.com \
-              --certificate-identity-regexp https://github.com/home-assistant/core/.* \
-              "ghcr.io/home-assistant/${arch}-homeassistant:${{ needs.init.outputs.version }}"
-          done
-          echo "✓ All images verified successfully"
+          export DOCKER_CLI_EXPERIMENTAL=enabled
 
-      # Generate all Docker tags based on version string
-      # Version format: YYYY.MM.PATCH, YYYY.MM.PATCHbN (beta), or YYYY.MM.PATCH.devYYYYMMDDHHMM (dev)
-      # Examples:
-      #   2025.12.1     (stable)    -> tags: 2025.12.1, 2025.12, stable, latest, beta, rc
-      #   2025.12.0b3   (beta)      -> tags: 2025.12.0b3, beta, rc
-      #   2025.12.0.dev202511250240 -> tags: 2025.12.0.dev202511250240, dev
-      - name: Generate Docker metadata
-        id: meta
-        uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5.10.0
-        with:
-          images: ${{ matrix.registry }}/home-assistant
-          sep-tags: ","
-          tags: |
-            type=raw,value=${{ needs.init.outputs.version }},priority=9999
-            type=raw,value=dev,enable=${{ contains(needs.init.outputs.version, 'd') }}
-            type=raw,value=beta,enable=${{ !contains(needs.init.outputs.version, 'd') }}
-            type=raw,value=rc,enable=${{ !contains(needs.init.outputs.version, 'd') }}
-            type=raw,value=stable,enable=${{ !contains(needs.init.outputs.version, 'd') && !contains(needs.init.outputs.version, 'b') }}
-            type=raw,value=latest,enable=${{ !contains(needs.init.outputs.version, 'd') && !contains(needs.init.outputs.version, 'b') }}
-            type=semver,pattern={{major}}.{{minor}},value=${{ needs.init.outputs.version }},enable=${{ !contains(needs.init.outputs.version, 'd') && !contains(needs.init.outputs.version, 'b') }}
+          function create_manifest() {
+            local tag_l=${1}
+            local tag_r=${2}
+            local registry=${{ matrix.registry }}
 
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3.7.1
+            docker manifest create "${registry}/home-assistant:${tag_l}" \
+              "${registry}/amd64-homeassistant:${tag_r}" \
+              "${registry}/i386-homeassistant:${tag_r}" \
+              "${registry}/armhf-homeassistant:${tag_r}" \
+              "${registry}/armv7-homeassistant:${tag_r}" \
+              "${registry}/aarch64-homeassistant:${tag_r}"
 
-      - name: Copy architecture images to DockerHub
-        if: matrix.registry == 'docker.io/homeassistant'
-        shell: bash
-        run: |
-          # Use imagetools to copy image blobs directly between registries
-          # This preserves provenance/attestations and seems to be much faster than pull/push
-          ARCHS=$(echo '${{ needs.init.outputs.architectures }}' | jq -r '.[]')
-          for arch in $ARCHS; do
-            echo "Copying ${arch} image to DockerHub..."
-            for attempt in 1 2 3; do
-              if docker buildx imagetools create \
-                --tag "docker.io/homeassistant/${arch}-homeassistant:${{ needs.init.outputs.version }}" \
-                "ghcr.io/home-assistant/${arch}-homeassistant:${{ needs.init.outputs.version }}"; then
-                break
-              fi
-              echo "Attempt ${attempt} failed, retrying in 10 seconds..."
-              sleep 10
-              if [ "${attempt}" -eq 3 ]; then
-                echo "Failed after 3 attempts"
-                exit 1
-              fi
-            done
-            cosign sign --yes "docker.io/homeassistant/${arch}-homeassistant:${{ needs.init.outputs.version }}"
-          done
+            docker manifest annotate "${registry}/home-assistant:${tag_l}" \
+              "${registry}/amd64-homeassistant:${tag_r}" \
+              --os linux --arch amd64
 
-      - name: Create and push multi-arch manifests
-        shell: bash
-        run: |
-          # Build list of architecture images dynamically
-          ARCHS=$(echo '${{ needs.init.outputs.architectures }}' | jq -r '.[]')
-          ARCH_IMAGES=()
-          for arch in $ARCHS; do
-            ARCH_IMAGES+=("${{ matrix.registry }}/${arch}-homeassistant:${{ needs.init.outputs.version }}")
-          done
+            docker manifest annotate "${registry}/home-assistant:${tag_l}" \
+              "${registry}/i386-homeassistant:${tag_r}" \
+              --os linux --arch 386
 
-          # Build list of all tags for single manifest creation
-          # Note: Using sep-tags=',' in metadata-action for easier parsing
-          TAG_ARGS=()
-          IFS=',' read -ra TAGS <<< "${{ steps.meta.outputs.tags }}"
-          for tag in "${TAGS[@]}"; do
-            TAG_ARGS+=("--tag" "${tag}")
-          done
+            docker manifest annotate "${registry}/home-assistant:${tag_l}" \
+              "${registry}/armhf-homeassistant:${tag_r}" \
+              --os linux --arch arm --variant=v6
 
-          # Create manifest with ALL tags in a single operation (much faster!)
-          echo "Creating multi-arch manifest with tags: ${TAGS[*]}"
-          docker buildx imagetools create "${TAG_ARGS[@]}" "${ARCH_IMAGES[@]}"
+            docker manifest annotate "${registry}/home-assistant:${tag_l}" \
+              "${registry}/armv7-homeassistant:${tag_r}" \
+              --os linux --arch arm --variant=v7
 
-          # Sign each tag separately (signing requires individual tag names)
-          echo "Signing all tags..."
-          for tag in "${TAGS[@]}"; do
-            echo "Signing ${tag}"
-            cosign sign --yes "${tag}"
-          done
+            docker manifest annotate "${registry}/home-assistant:${tag_l}" \
+              "${registry}/aarch64-homeassistant:${tag_r}" \
+              --os linux --arch arm64 --variant=v8
 
-          echo "All manifests created and signed successfully"
+            docker manifest push --purge "${registry}/home-assistant:${tag_l}"
+            cosign sign --yes "${registry}/home-assistant:${tag_l}"
+          }
+
+          function validate_image() {
+            local image=${1}
+            if ! cosign verify --certificate-oidc-issuer https://token.actions.githubusercontent.com --certificate-identity-regexp https://github.com/home-assistant/core/.* "${image}"; then
+              echo "Invalid signature!"
+              exit 1
+            fi
+          }
+
+          function push_dockerhub() {
+            local image=${1}
+            local tag=${2}
+
+            docker tag "ghcr.io/home-assistant/${image}:${tag}" "docker.io/homeassistant/${image}:${tag}"
+            docker push "docker.io/homeassistant/${image}:${tag}"
+            cosign sign --yes "docker.io/homeassistant/${image}:${tag}"
+          }
+
+          # Pull images from github container registry and verify signature
+          docker pull "ghcr.io/home-assistant/amd64-homeassistant:${{ needs.init.outputs.version }}"
+          docker pull "ghcr.io/home-assistant/i386-homeassistant:${{ needs.init.outputs.version }}"
+          docker pull "ghcr.io/home-assistant/armhf-homeassistant:${{ needs.init.outputs.version }}"
+          docker pull "ghcr.io/home-assistant/armv7-homeassistant:${{ needs.init.outputs.version }}"
+          docker pull "ghcr.io/home-assistant/aarch64-homeassistant:${{ needs.init.outputs.version }}"
+
+          validate_image "ghcr.io/home-assistant/amd64-homeassistant:${{ needs.init.outputs.version }}"
+          validate_image "ghcr.io/home-assistant/i386-homeassistant:${{ needs.init.outputs.version }}"
+          validate_image "ghcr.io/home-assistant/armhf-homeassistant:${{ needs.init.outputs.version }}"
+          validate_image "ghcr.io/home-assistant/armv7-homeassistant:${{ needs.init.outputs.version }}"
+          validate_image "ghcr.io/home-assistant/aarch64-homeassistant:${{ needs.init.outputs.version }}"
+
+          if [[ "${{ matrix.registry }}" ==  "docker.io/homeassistant" ]]; then
+            # Upload images to dockerhub
+            push_dockerhub "amd64-homeassistant" "${{ needs.init.outputs.version }}"
+            push_dockerhub "i386-homeassistant" "${{ needs.init.outputs.version }}"
+            push_dockerhub "armhf-homeassistant" "${{ needs.init.outputs.version }}"
+            push_dockerhub "armv7-homeassistant" "${{ needs.init.outputs.version }}"
+            push_dockerhub "aarch64-homeassistant" "${{ needs.init.outputs.version }}"
+          fi
+
+          # Create version tag
+          create_manifest "${{ needs.init.outputs.version }}" "${{ needs.init.outputs.version }}"
+
+          # Create general tags
+          if [[ "${{ needs.init.outputs.version }}" =~ d ]]; then
+            create_manifest "dev" "${{ needs.init.outputs.version }}"
+          elif [[ "${{ needs.init.outputs.version }}" =~ b ]]; then
+            create_manifest "beta" "${{ needs.init.outputs.version }}"
+            create_manifest "rc" "${{ needs.init.outputs.version }}"
+          else
+            create_manifest "stable" "${{ needs.init.outputs.version }}"
+            create_manifest "latest" "${{ needs.init.outputs.version }}"
+            create_manifest "beta" "${{ needs.init.outputs.version }}"
+            create_manifest "rc" "${{ needs.init.outputs.version }}"
+
+            # Create series version tag (e.g. 2021.6)
+            v="${{ needs.init.outputs.version }}"
+            create_manifest "${v%.*}" "${{ needs.init.outputs.version }}"
+          fi
 
   build_python:
     name: Build PyPi package
     environment: ${{ needs.init.outputs.channel }}
     needs: ["init", "build_base"]
     runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
     if: github.repository_owner == 'home-assistant' && needs.init.outputs.publish == 'true'
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
 
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
-        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
 
       - name: Download translations
-        uses: actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
+        uses: actions/download-artifact@v4.1.8
         with:
           name: translations
 
@@ -496,13 +472,16 @@ jobs:
         run: |
           # Remove dist, build, and homeassistant.egg-info
           # when build locally for testing!
-          pip install build
+          pip install twine build
           python -m build
 
-      - name: Upload package to PyPI
-        uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # v1.13.0
-        with:
-          skip-existing: true
+      - name: Upload package
+        shell: bash
+        run: |
+          export TWINE_USERNAME="__token__"
+          export TWINE_PASSWORD="${{ secrets.TWINE_TOKEN }}"
+
+          twine upload dist/* --skip-existing
 
   hassfest-image:
     name: Build and test hassfest image
@@ -519,17 +498,17 @@ jobs:
       HASSFEST_IMAGE_TAG: ghcr.io/home-assistant/hassfest:${{ needs.init.outputs.version }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
 
       - name: Login to GitHub Container Registry
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef # v3.6.0
+        uses: docker/login-action@9780b0c442fbb1117ed29e0efdff1e18412f7567 # v3.3.0
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Build Docker image
-        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
+        uses: docker/build-push-action@5cd11c3a4ced054e52742c5fd54dca954e0edd85 # v6.7.0
         with:
           context: . # So action will not pull the repository again
           file: ./script/hassfest/docker/Dockerfile
@@ -537,12 +516,12 @@ jobs:
           tags: ${{ env.HASSFEST_IMAGE_TAG }}
 
       - name: Run hassfest against core
-        run: docker run --rm -v ${{ github.workspace }}:/github/workspace ${{ env.HASSFEST_IMAGE_TAG }} --core-path=/github/workspace
+        run: docker run --rm -v ${{ github.workspace }}/homeassistant:/github/workspace/homeassistant ${{ env.HASSFEST_IMAGE_TAG }} --core-integrations-path=/github/workspace/homeassistant/components
 
       - name: Push Docker image
         if: needs.init.outputs.channel != 'dev' && needs.init.outputs.publish == 'true'
         id: push
-        uses: docker/build-push-action@263435318d21b8e681c14492fe198d362a7d2c83 # v6.18.0
+        uses: docker/build-push-action@5cd11c3a4ced054e52742c5fd54dca954e0edd85 # v6.7.0
         with:
           context: . # So action will not pull the repository again
           file: ./script/hassfest/docker/Dockerfile
@@ -551,7 +530,7 @@ jobs:
 
       - name: Generate artifact attestation
         if: needs.init.outputs.channel != 'dev' && needs.init.outputs.publish == 'true'
-        uses: actions/attest-build-provenance@00014ed6ed5efc5b1ab7f7f34a39eb55d41aa4f8 # v3.1.0
+        uses: actions/attest-build-provenance@6149ea5740be74af77f260b9db67e633f6b0a9a1 # v1.4.2
         with:
           subject-name: ${{ env.HASSFEST_IMAGE_NAME }}
           subject-digest: ${{ steps.push.outputs.digest }}

.github/workflows/codeql.yml

@@ -21,14 +21,14 @@ jobs:
 
     steps:
       - name: Check out code from GitHub
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@5d4e8d1aca955e8d8589aabd499c5cae939e33c7 # v4.31.9
+        uses: github/codeql-action/init@v3.26.6
         with:
           languages: python
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@5d4e8d1aca955e8d8589aabd499c5cae939e33c7 # v4.31.9
+        uses: github/codeql-action/analyze@v3.26.6
         with:
           category: "/language:python"

.github/workflows/detect-duplicate-issues.yml

@@ -1,385 +0,0 @@
-name: Auto-detect duplicate issues
-
-# yamllint disable-line rule:truthy
-on:
-  issues:
-    types: [labeled]
-
-permissions:
-  issues: write
-  models: read
-
-jobs:
-  detect-duplicates:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Check if integration label was added and extract details
-        id: extract
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        with:
-          script: |
-            // Debug: Log the event payload
-            console.log('Event name:', context.eventName);
-            console.log('Event action:', context.payload.action);
-            console.log('Event payload keys:', Object.keys(context.payload));
-
-            // Check the specific label that was added
-            const addedLabel = context.payload.label;
-            if (!addedLabel) {
-              console.log('No label found in labeled event payload');
-              core.setOutput('should_continue', 'false');
-              return;
-            }
-
-            console.log(`Label added: ${addedLabel.name}`);
-
-            if (!addedLabel.name.startsWith('integration:')) {
-              console.log('Added label is not an integration label, skipping duplicate detection');
-              core.setOutput('should_continue', 'false');
-              return;
-            }
-
-            console.log(`Integration label added: ${addedLabel.name}`);
-
-            let currentIssue;
-            let integrationLabels = [];
-
-            try {
-              const issue = await github.rest.issues.get({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.payload.issue.number
-              });
-
-              currentIssue = issue.data;
-
-              // Check if potential-duplicate label already exists
-              const hasPotentialDuplicateLabel = currentIssue.labels
-                .some(label => label.name === 'potential-duplicate');
-
-              if (hasPotentialDuplicateLabel) {
-                console.log('Issue already has potential-duplicate label, skipping duplicate detection');
-                core.setOutput('should_continue', 'false');
-                return;
-              }
-
-              integrationLabels = currentIssue.labels
-                .filter(label => label.name.startsWith('integration:'))
-                .map(label => label.name);
-            } catch (error) {
-              core.error(`Failed to fetch issue #${context.payload.issue.number}:`, error.message);
-              core.setOutput('should_continue', 'false');
-              return;
-            }
-
-            // Check if we've already posted a duplicate detection comment recently
-            let comments;
-            try {
-              comments = await github.rest.issues.listComments({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.payload.issue.number,
-                per_page: 10
-              });
-            } catch (error) {
-              core.error('Failed to fetch comments:', error.message);
-              // Continue anyway, worst case we might post a duplicate comment
-              comments = { data: [] };
-            }
-
-            // Check if we've already posted a duplicate detection comment
-            const recentDuplicateComment = comments.data.find(comment =>
-              comment.user && comment.user.login === 'github-actions[bot]' &&
-              comment.body.includes('<!-- workflow: detect-duplicate-issues -->')
-            );
-
-            if (recentDuplicateComment) {
-              console.log('Already posted duplicate detection comment, skipping');
-              core.setOutput('should_continue', 'false');
-              return;
-            }
-
-            core.setOutput('should_continue', 'true');
-            core.setOutput('current_number', currentIssue.number);
-            core.setOutput('current_title', currentIssue.title);
-            core.setOutput('current_body', currentIssue.body);
-            core.setOutput('current_url', currentIssue.html_url);
-            core.setOutput('integration_labels', JSON.stringify(integrationLabels));
-
-            console.log(`Current issue: #${currentIssue.number}`);
-            console.log(`Integration labels: ${integrationLabels.join(', ')}`);
-
-      - name: Fetch similar issues
-        id: fetch_similar
-        if: steps.extract.outputs.should_continue == 'true'
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        env:
-          INTEGRATION_LABELS: ${{ steps.extract.outputs.integration_labels }}
-          CURRENT_NUMBER: ${{ steps.extract.outputs.current_number }}
-        with:
-          script: |
-            const integrationLabels = JSON.parse(process.env.INTEGRATION_LABELS);
-            const currentNumber = parseInt(process.env.CURRENT_NUMBER);
-
-            if (integrationLabels.length === 0) {
-              console.log('No integration labels found, skipping duplicate detection');
-              core.setOutput('has_similar', 'false');
-              return;
-            }
-
-            // Use GitHub search API to find issues with matching integration labels
-            console.log(`Searching for issues with integration labels: ${integrationLabels.join(', ')}`);
-
-            // Build search query for issues with any of the current integration labels
-            const labelQueries = integrationLabels.map(label => `label:"${label}"`);
-
-            // Calculate date 6 months ago
-            const sixMonthsAgo = new Date();
-            sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
-            const dateFilter = `created:>=${sixMonthsAgo.toISOString().split('T')[0]}`;
-
-            let searchQuery;
-
-            if (labelQueries.length === 1) {
-              searchQuery = `repo:${context.repo.owner}/${context.repo.repo} is:issue ${labelQueries[0]} ${dateFilter}`;
-            } else {
-              searchQuery = `repo:${context.repo.owner}/${context.repo.repo} is:issue (${labelQueries.join(' OR ')}) ${dateFilter}`;
-            }
-
-            console.log(`Search query: ${searchQuery}`);
-
-            let result;
-            try {
-              result = await github.rest.search.issuesAndPullRequests({
-                q: searchQuery,
-                per_page: 15,
-                sort: 'updated',
-                order: 'desc'
-              });
-            } catch (error) {
-              core.error('Failed to search for similar issues:', error.message);
-              if (error.status === 403 && error.message.includes('rate limit')) {
-                core.error('GitHub API rate limit exceeded');
-              }
-              core.setOutput('has_similar', 'false');
-              return;
-            }
-
-            // Filter out the current issue, pull requests, and newer issues (higher numbers)
-            const similarIssues = result.data.items
-              .filter(item =>
-                item.number !== currentNumber &&
-                !item.pull_request &&
-                item.number < currentNumber // Only include older issues (lower numbers)
-              )
-              .map(item => ({
-                number: item.number,
-                title: item.title,
-                body: item.body,
-                url: item.html_url,
-                state: item.state,
-                createdAt: item.created_at,
-                updatedAt: item.updated_at,
-                comments: item.comments,
-                labels: item.labels.map(l => l.name)
-              }));
-
-            console.log(`Found ${similarIssues.length} issues with matching integration labels`);
-            console.log('Raw similar issues:', JSON.stringify(similarIssues.slice(0, 3), null, 2));
-
-            if (similarIssues.length === 0) {
-              console.log('No similar issues found, setting has_similar to false');
-              core.setOutput('has_similar', 'false');
-              return;
-            }
-
-            console.log('Similar issues found, setting has_similar to true');
-            core.setOutput('has_similar', 'true');
-
-            // Clean the issue data to prevent JSON parsing issues
-            const cleanedIssues = similarIssues.slice(0, 15).map(item => {
-              // Handle body with improved truncation and null handling
-              let cleanBody = '';
-              if (item.body && typeof item.body === 'string') {
-                // Remove control characters
-                const cleaned = item.body.replace(/[\u0000-\u001F\u007F-\u009F]/g, '');
-                // Truncate to 1000 characters and add ellipsis if needed
-                cleanBody = cleaned.length > 1000
-                  ? cleaned.substring(0, 1000) + '...'
-                  : cleaned;
-              }
-
-              return {
-                number: item.number,
-                title: item.title.replace(/[\u0000-\u001F\u007F-\u009F]/g, ''), // Remove control characters
-                body: cleanBody,
-                url: item.url,
-                state: item.state,
-                createdAt: item.createdAt,
-                updatedAt: item.updatedAt,
-                comments: item.comments,
-                labels: item.labels
-              };
-            });
-
-            console.log(`Cleaned issues count: ${cleanedIssues.length}`);
-            console.log('First cleaned issue:', JSON.stringify(cleanedIssues[0], null, 2));
-
-            core.setOutput('similar_issues', JSON.stringify(cleanedIssues));
-
-      - name: Detect duplicates using AI
-        id: ai_detection
-        if: steps.extract.outputs.should_continue == 'true' && steps.fetch_similar.outputs.has_similar == 'true'
-        uses: actions/ai-inference@334892bb203895caaed82ec52d23c1ed9385151e # v2.0.4
-        with:
-          model: openai/gpt-4o
-          system-prompt: |
-            You are a Home Assistant issue duplicate detector. Your task is to identify TRUE DUPLICATES - issues that report the EXACT SAME problem, not just similar or related issues.
-
-            CRITICAL: An issue is ONLY a duplicate if:
-            - It describes the SAME problem with the SAME root cause
-            - Issues about the same integration but different problems are NOT duplicates
-            - Issues with similar symptoms but different causes are NOT duplicates
-
-            Important considerations:
-            - Open issues are more relevant than closed ones for duplicate detection
-            - Recently updated issues may indicate ongoing work or discussion
-            - Issues with more comments are generally more relevant and active
-            - Older closed issues might be resolved differently than newer approaches
-            - Consider the time between issues - very old issues may have different contexts
-
-            Rules:
-            1. ONLY mark as duplicate if the issues describe IDENTICAL problems
-            2. Look for issues that report the same problem or request the same functionality
-            3. Different error messages = NOT a duplicate (even if same integration)
-            4. For CLOSED issues, only mark as duplicate if they describe the EXACT same problem
-            5. For OPEN issues, use a lower threshold (90%+ similarity)
-            6. Prioritize issues with higher comment counts as they indicate more activity/relevance
-            7. When in doubt, do NOT mark as duplicate
-            8. Return ONLY a JSON array of issue numbers that are duplicates
-            9. If no duplicates are found, return an empty array: []
-            10. Maximum 5 potential duplicates, prioritize open issues with comments
-            11. Consider the age of issues - prefer recent duplicates over very old ones
-
-            Example response format:
-            [1234, 5678, 9012]
-
-          prompt: |
-            Current issue (just created):
-            Title: ${{ steps.extract.outputs.current_title }}
-            Body: ${{ steps.extract.outputs.current_body }}
-
-            Other issues to compare against (each includes state, creation date, last update, and comment count):
-            ${{ steps.fetch_similar.outputs.similar_issues }}
-
-            Analyze these issues and identify which ones describe IDENTICAL problems and thus are duplicates of the current issue. When sorting them, consider their state (open/closed), how recently they were updated, and their comment count (higher = more relevant).
-
-          max-tokens: 100
-
-      - name: Post duplicate detection results
-        id: post_results
-        if: steps.extract.outputs.should_continue == 'true' && steps.fetch_similar.outputs.has_similar == 'true'
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        env:
-          AI_RESPONSE: ${{ steps.ai_detection.outputs.response }}
-          SIMILAR_ISSUES: ${{ steps.fetch_similar.outputs.similar_issues }}
-        with:
-          script: |
-            const aiResponse = process.env.AI_RESPONSE;
-
-            console.log('Raw AI response:', JSON.stringify(aiResponse));
-
-            let duplicateNumbers = [];
-            try {
-              // Clean the response of any potential control characters
-              const cleanResponse = aiResponse.trim().replace(/[\u0000-\u001F\u007F-\u009F]/g, '');
-              console.log('Cleaned AI response:', cleanResponse);
-
-              duplicateNumbers = JSON.parse(cleanResponse);
-
-              // Ensure it's an array and contains only numbers
-              if (!Array.isArray(duplicateNumbers)) {
-                console.log('AI response is not an array, trying to extract numbers');
-                const numberMatches = cleanResponse.match(/\d+/g);
-                duplicateNumbers = numberMatches ? numberMatches.map(n => parseInt(n)) : [];
-              }
-
-              // Filter to only valid numbers
-              duplicateNumbers = duplicateNumbers.filter(n => typeof n === 'number' && !isNaN(n));
-
-            } catch (error) {
-              console.log('Failed to parse AI response as JSON:', error.message);
-              console.log('Raw response:', aiResponse);
-
-              // Fallback: try to extract numbers from the response
-              const numberMatches = aiResponse.match(/\d+/g);
-              duplicateNumbers = numberMatches ? numberMatches.map(n => parseInt(n)) : [];
-              console.log('Extracted numbers as fallback:', duplicateNumbers);
-            }
-
-            if (!Array.isArray(duplicateNumbers) || duplicateNumbers.length === 0) {
-              console.log('No duplicates detected by AI');
-              return;
-            }
-
-            console.log(`AI detected ${duplicateNumbers.length} potential duplicates: ${duplicateNumbers.join(', ')}`);
-
-            // Get details of detected duplicates
-            const similarIssues = JSON.parse(process.env.SIMILAR_ISSUES);
-            const duplicates = similarIssues.filter(issue => duplicateNumbers.includes(issue.number));
-
-            if (duplicates.length === 0) {
-              console.log('No matching issues found for detected numbers');
-              return;
-            }
-
-            // Create comment with duplicate detection results
-            const duplicateLinks = duplicates.map(issue => `- [#${issue.number}: ${issue.title}](${issue.url})`).join('\n');
-
-            const commentBody = [
-              '<!-- workflow: detect-duplicate-issues -->',
-              '### 🔍 **Potential duplicate detection**',
-              '',
-              'I\'ve analyzed similar issues and found the following potential duplicates:',
-              '',
-              duplicateLinks,
-              '',
-              '**What to do next:**',
-              '1. Please review these issues to see if they match your issue',
-              '2. If you find an existing issue that covers your problem:',
-              '   - Consider closing this issue',
-              '   - Add your findings or 👍 on the existing issue instead',
-              '3. If your issue is different or adds new aspects, please clarify how it differs',
-              '',
-              'This helps keep our issues organized and ensures similar issues are consolidated for better visibility.',
-              '',
-              '*This message was generated automatically by our duplicate detection system.*'
-            ].join('\n');
-
-            try {
-              await github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.payload.issue.number,
-                body: commentBody
-              });
-
-              console.log(`Posted duplicate detection comment with ${duplicates.length} potential duplicates`);
-
-              // Add the potential-duplicate label
-              await github.rest.issues.addLabels({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.payload.issue.number,
-                labels: ['potential-duplicate']
-              });
-
-              console.log('Added potential-duplicate label to the issue');
-            } catch (error) {
-              core.error('Failed to post duplicate detection comment or add label:', error.message);
-              if (error.status === 403) {
-                core.error('Permission denied or rate limit exceeded');
-              }
-              // Don't throw - we've done the analysis, just couldn't post the result
-            }

.github/workflows/detect-non-english-issues.yml

@@ -1,193 +0,0 @@
-name: Auto-detect non-English issues
-
-# yamllint disable-line rule:truthy
-on:
-  issues:
-    types: [opened]
-
-permissions:
-  issues: write
-  models: read
-
-jobs:
-  detect-language:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Check issue language
-        id: detect_language
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        env:
-          ISSUE_NUMBER: ${{ github.event.issue.number }}
-          ISSUE_TITLE: ${{ github.event.issue.title }}
-          ISSUE_BODY: ${{ github.event.issue.body }}
-          ISSUE_USER_TYPE: ${{ github.event.issue.user.type }}
-        with:
-          script: |
-            // Get the issue details from environment variables
-            const issueNumber = process.env.ISSUE_NUMBER;
-            const issueTitle = process.env.ISSUE_TITLE || '';
-            const issueBody = process.env.ISSUE_BODY || '';
-            const userType = process.env.ISSUE_USER_TYPE;
-
-            // Skip language detection for bot users
-            if (userType === 'Bot') {
-              console.log('Skipping language detection for bot user');
-              core.setOutput('should_continue', 'false');
-              return;
-            }
-
-            console.log(`Checking language for issue #${issueNumber}`);
-            console.log(`Title: ${issueTitle}`);
-
-            // Combine title and body for language detection
-            const fullText = `${issueTitle}\n\n${issueBody}`;
-
-            // Check if the text is too short to reliably detect language
-            if (fullText.trim().length < 20) {
-              console.log('Text too short for reliable language detection');
-              core.setOutput('should_continue', 'false'); // Skip processing for very short text
-              return;
-            }
-
-            core.setOutput('issue_number', issueNumber);
-            core.setOutput('issue_text', fullText);
-            core.setOutput('should_continue', 'true');
-
-      - name: Detect language using AI
-        id: ai_language_detection
-        if: steps.detect_language.outputs.should_continue == 'true'
-        uses: actions/ai-inference@334892bb203895caaed82ec52d23c1ed9385151e # v2.0.4
-        with:
-          model: openai/gpt-4o-mini
-          system-prompt: |
-            You are a language detection system. Your task is to determine if the provided text is written in English or another language.
-
-            Rules:
-            1. Analyze the text and determine the primary language of the USER'S DESCRIPTION only
-            2. IGNORE markdown headers (lines starting with #, ##, ###, etc.) as these are from issue templates, not user input
-            3. IGNORE all code blocks (text between ``` or ` markers) as they may contain system-generated error messages in other languages
-            4. IGNORE error messages, logs, and system output even if not in code blocks - these often appear in the user's system language
-            5. Consider technical terms, code snippets, URLs, and file paths as neutral (they don't indicate non-English)
-            6. Focus ONLY on the actual sentences and descriptions written by the user explaining their issue
-            7. If the user's explanation/description is in English but includes non-English error messages or logs, consider it ENGLISH
-            8. Return ONLY a JSON object with two fields:
-               - "is_english": boolean (true if the user's description is primarily in English, false otherwise)
-               - "detected_language": string (the name of the detected language, e.g., "English", "Spanish", "Chinese", etc.)
-            9. Be lenient - if the user's explanation is in English with non-English system output, it's still English
-            10. Common programming terms, error messages, and technical jargon should not be considered as non-English
-            11. If you cannot reliably determine the language, set detected_language to "undefined"
-
-            Example response:
-            {"is_english": false, "detected_language": "Spanish"}
-
-          prompt: |
-            Please analyze the following issue text and determine if it is written in English:
-
-            ${{ steps.detect_language.outputs.issue_text }}
-
-          max-tokens: 50
-
-      - name: Process non-English issues
-        if: steps.detect_language.outputs.should_continue == 'true'
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        env:
-          AI_RESPONSE: ${{ steps.ai_language_detection.outputs.response }}
-          ISSUE_NUMBER: ${{ steps.detect_language.outputs.issue_number }}
-        with:
-          script: |
-            const issueNumber = parseInt(process.env.ISSUE_NUMBER);
-            const aiResponse = process.env.AI_RESPONSE;
-
-            console.log('AI language detection response:', aiResponse);
-
-            let languageResult;
-            try {
-              languageResult = JSON.parse(aiResponse.trim());
-
-              // Validate the response structure
-              if (!languageResult || typeof languageResult.is_english !== 'boolean') {
-                throw new Error('Invalid response structure');
-              }
-            } catch (error) {
-              core.error(`Failed to parse AI response: ${error.message}`);
-              console.log('Raw AI response:', aiResponse);
-
-              // Log more details for debugging
-              core.warning('Defaulting to English due to parsing error');
-
-              // Default to English if we can't parse the response
-              return;
-            }
-
-            if (languageResult.is_english) {
-              console.log('Issue is in English, no action needed');
-              return;
-            }
-
-            // If language is undefined or not detected, skip processing
-            if (!languageResult.detected_language || languageResult.detected_language === 'undefined') {
-              console.log('Language could not be determined, skipping processing');
-              return;
-            }
-
-            console.log(`Issue detected as non-English: ${languageResult.detected_language}`);
-
-            // Post comment explaining the language requirement
-            const commentBody = [
-              '<!-- workflow: detect-non-english-issues -->',
-              '### 🌐 Non-English issue detected',
-              '',
-              `This issue appears to be written in **${languageResult.detected_language}** rather than English.`,
-              '',
-              'The Home Assistant project uses English as the primary language for issues to ensure that everyone in our international community can participate and help resolve issues. This allows any of our thousands of contributors to jump in and provide assistance.',
-              '',
-              '**What to do:**',
-              '1. Re-create the issue using the English language',
-              '2. If you need help with translation, consider using:',
-              '   - Translation tools like Google Translate',
-              '   - AI assistants like ChatGPT or Claude',
-              '',
-              'This helps our community provide the best possible support and ensures your issue gets the attention it deserves from our global contributor base.',
-              '',
-              'Thank you for your understanding! 🙏'
-            ].join('\n');
-
-            try {
-              // Add comment
-              await github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: issueNumber,
-                body: commentBody
-              });
-
-              console.log('Posted language requirement comment');
-
-              // Add non-english label
-              await github.rest.issues.addLabels({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: issueNumber,
-                labels: ['non-english']
-              });
-
-              console.log('Added non-english label');
-
-              // Close the issue
-              await github.rest.issues.update({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: issueNumber,
-                state: 'closed',
-                state_reason: 'not_planned'
-              });
-
-              console.log('Closed the issue');
-
-            } catch (error) {
-              core.error('Failed to process non-English issue:', error.message);
-              if (error.status === 403) {
-                core.error('Permission denied or rate limit exceeded');
-              }
-            }

.github/workflows/lock.yml

@@ -10,7 +10,7 @@ jobs:
     if: github.repository_owner == 'home-assistant'
     runs-on: ubuntu-latest
     steps:
-      - uses: dessant/lock-threads@7266a7ce5c1df01b1c6db85bf8cd86c737dadbe7 # v6.0.0
+      - uses: dessant/lock-threads@v5.0.1
         with:
           github-token: ${{ github.token }}
           issue-inactive-days: "30"

.github/workflows/restrict-task-creation.yml

@@ -1,84 +0,0 @@
-name: Restrict task creation
-
-# yamllint disable-line rule:truthy
-on:
-  issues:
-    types: [opened]
-
-jobs:
-  check-authorization:
-    runs-on: ubuntu-latest
-    # Only run if this is a Task issue type (from the issue form)
-    if: github.event.issue.type.name == 'Task'
-    steps:
-      - name: Check if user is authorized
-        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
-        with:
-          script: |
-            const issueAuthor = context.payload.issue.user.login;
-
-            // First check if user is an organization member
-            try {
-              await github.rest.orgs.checkMembershipForUser({
-                org: 'home-assistant',
-                username: issueAuthor
-              });
-              console.log(`✅ ${issueAuthor} is an organization member`);
-              return; // Authorized, no need to check further
-            } catch (error) {
-              console.log(`ℹ️ ${issueAuthor} is not an organization member, checking codeowners...`);
-            }
-
-            // If not an org member, check if they're a codeowner
-            try {
-              // Fetch CODEOWNERS file from the repository
-              const { data: codeownersFile } = await github.rest.repos.getContent({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                path: 'CODEOWNERS',
-                ref: 'dev'
-              });
-
-              // Decode the content (it's base64 encoded)
-              const codeownersContent = Buffer.from(codeownersFile.content, 'base64').toString('utf-8');
-
-              // Check if the issue author is mentioned in CODEOWNERS
-              // GitHub usernames in CODEOWNERS are prefixed with @
-              if (codeownersContent.includes(`@${issueAuthor}`)) {
-                console.log(`✅ ${issueAuthor} is a integration code owner`);
-                return; // Authorized
-              }
-            } catch (error) {
-              console.error('Error checking CODEOWNERS:', error);
-            }
-
-            // If we reach here, user is not authorized
-            console.log(`❌ ${issueAuthor} is not authorized to create Task issues`);
-
-            // Close the issue with a comment
-            await github.rest.issues.createComment({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              body: `Hi @${issueAuthor}, thank you for your contribution!\n\n` +
-                    `Task issues are restricted to Open Home Foundation staff, authorized contributors, and integration code owners.\n\n` +
-                    `If you would like to:\n` +
-                    `- Report a bug: Please use the [bug report form](https://github.com/home-assistant/core/issues/new?template=bug_report.yml)\n` +
-                    `- Request a feature: Please submit to [Feature Requests](https://github.com/orgs/home-assistant/discussions)\n\n` +
-                    `If you believe you should have access to create Task issues, please contact the maintainers.`
-            });
-
-            await github.rest.issues.update({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              state: 'closed'
-            });
-
-            // Add a label to indicate this was auto-closed
-            await github.rest.issues.addLabels({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              labels: ['auto-closed']
-            });

.github/workflows/stale.yml

@@ -17,7 +17,7 @@ jobs:
       # - No PRs marked as no-stale
       # - No issues (-1)
       - name: 60 days stale PRs policy
-        uses: actions/stale@997185467fa4f803885201cee163a9f38240193d # v10.1.1
+        uses: actions/stale@v9.0.0
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           days-before-stale: 60
@@ -57,7 +57,7 @@ jobs:
       # - No issues marked as no-stale or help-wanted
       # - No PRs (-1)
       - name: 90 days stale issues
-        uses: actions/stale@997185467fa4f803885201cee163a9f38240193d # v10.1.1
+        uses: actions/stale@v9.0.0
         with:
           repo-token: ${{ steps.token.outputs.token }}
           days-before-stale: 90
@@ -87,7 +87,7 @@ jobs:
       # - No Issues marked as no-stale or help-wanted
       # - No PRs (-1)
       - name: Needs more information stale issues policy
-        uses: actions/stale@997185467fa4f803885201cee163a9f38240193d # v10.1.1
+        uses: actions/stale@v9.0.0
         with:
           repo-token: ${{ steps.token.outputs.token }}
           only-labels: "needs-more-information"

.github/workflows/translations.yml

@@ -10,7 +10,7 @@ on:
       - "**strings.json"
 
 env:
-  DEFAULT_PYTHON: "3.13"
+  DEFAULT_PYTHON: "3.12"
 
 jobs:
   upload:
@@ -19,10 +19,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@v4.1.7
 
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
-        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
 

.github/workflows/wheels.yml

@@ -17,7 +17,7 @@ on:
       - "script/gen_requirements_all.py"
 
 env:
-  DEFAULT_PYTHON: "3.13"
+  DEFAULT_PYTHON: "3.12"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref_name}}
@@ -28,14 +28,15 @@ jobs:
     name: Initialize wheels builder
     if: github.repository_owner == 'home-assistant'
     runs-on: ubuntu-latest
+    outputs:
+      architectures: ${{ steps.info.outputs.architectures }}
     steps:
-      - &checkout
-        name: Checkout the repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+      - name: Checkout the repository
+        uses: actions/checkout@v4.1.7
 
       - name: Set up Python ${{ env.DEFAULT_PYTHON }}
         id: python
-        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548 # v6.1.0
+        uses: actions/setup-python@v5.2.0
         with:
           python-version: ${{ env.DEFAULT_PYTHON }}
           check-latest: true
@@ -45,9 +46,13 @@ jobs:
           python -m venv venv
           . venv/bin/activate
           python --version
-          pip install "$(grep '^uv' < requirements.txt)"
+          pip install "$(grep '^uv' < requirements_test.txt)"
           uv pip install -r requirements.txt
 
+      - name: Get information
+        id: info
+        uses: home-assistant/actions/helpers/info@master
+
       - name: Create requirements_diff file
         run: |
           if [[ ${{ github.event_name }} =~ (schedule|workflow_dispatch) ]]; then
@@ -59,8 +64,11 @@ jobs:
       - name: Write env-file
         run: |
           (
+            echo "GRPC_BUILD_WITH_BORING_SSL_ASM=false"
             echo "GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=true"
             echo "GRPC_PYTHON_BUILD_WITH_CYTHON=true"
+            echo "GRPC_PYTHON_DISABLE_LIBC_COMPATIBILITY=true"
+            echo "GRPC_PYTHON_LDFLAGS=-lpthread -Wl,-wrap,memcpy -static-libgcc"
 
             # Fix out of memory issues with rust
             echo "CARGO_NET_GIT_FETCH_WITH_CLI=true"
@@ -74,7 +82,7 @@ jobs:
           ) > .env_file
 
       - name: Upload env_file
-        uses: &actions-upload-artifact actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6.0.0
+        uses: actions/upload-artifact@v4.4.0
         with:
           name: env_file
           path: ./.env_file
@@ -82,7 +90,7 @@ jobs:
           overwrite: true
 
       - name: Upload requirements_diff
-        uses: *actions-upload-artifact
+        uses: actions/upload-artifact@v4.4.0
         with:
           name: requirements_diff
           path: ./requirements_diff.txt
@@ -94,7 +102,7 @@ jobs:
           python -m script.gen_requirements_all ci
 
       - name: Upload requirements_all_wheels
-        uses: *actions-upload-artifact
+        uses: actions/upload-artifact@v4.4.0
         with:
           name: requirements_all_wheels
           path: ./requirements_all_wheels_*.txt
@@ -103,48 +111,36 @@ jobs:
     name: Build Core wheels ${{ matrix.abi }} for ${{ matrix.arch }} (musllinux_1_2)
     if: github.repository_owner == 'home-assistant'
     needs: init
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
-      matrix: &matrix-build
-        abi: ["cp313", "cp314"]
-        arch: ["amd64", "aarch64"]
-        include:
-          - arch: amd64
-            os: ubuntu-latest
-          - arch: aarch64
-            os: ubuntu-24.04-arm
+      matrix:
+        abi: ["cp312"]
+        arch: ${{ fromJson(needs.init.outputs.architectures) }}
     steps:
-      - *checkout
+      - name: Checkout the repository
+        uses: actions/checkout@v4.1.7
 
-      - &download-env-file
-        name: Download env_file
-        uses: &actions-download-artifact actions/download-artifact@37930b1c2abaa49bbe596cd826c3c89aef350131 # v7.0.0
+      - name: Download env_file
+        uses: actions/download-artifact@v4.1.8
         with:
           name: env_file
 
-      - &download-requirements-diff
-        name: Download requirements_diff
-        uses: *actions-download-artifact
+      - name: Download requirements_diff
+        uses: actions/download-artifact@v4.1.8
         with:
           name: requirements_diff
 
-      - name: Adjust build env
-        run: |
-          # Don't build wheels for uv as uv requires a greater version of rust as currently available on alpine
-          sed -i "/uv/d" requirements.txt
-          sed -i "/uv/d" requirements_diff.txt
-
       - name: Build wheels
-        uses: &home-assistant-wheels home-assistant/wheels@e5742a69d69f0e274e2689c998900c7d19652c21 # 2025.12.0
+        uses: home-assistant/wheels@2024.07.1
         with:
           abi: ${{ matrix.abi }}
           tag: musllinux_1_2
           arch: ${{ matrix.arch }}
           wheels-key: ${{ secrets.WHEELS_KEY }}
           env-file: true
-          apk: "libffi-dev;openssl-dev;yaml-dev;nasm;zlib-ng-dev"
-          skip-binary: aiohttp;multidict;propcache;yarl;SQLAlchemy
+          apk: "libffi-dev;openssl-dev;yaml-dev;nasm"
+          skip-binary: aiohttp;multidict;yarl
           constraints: "homeassistant/package_constraints.txt"
           requirements-diff: "requirements_diff.txt"
           requirements: "requirements.txt"
@@ -153,40 +149,113 @@ jobs:
     name: Build wheels ${{ matrix.abi }} for ${{ matrix.arch }}
     if: github.repository_owner == 'home-assistant'
     needs: init
-    runs-on: ${{ matrix.os }}
+    runs-on: ubuntu-latest
     strategy:
       fail-fast: false
-      matrix: *matrix-build
+      matrix:
+        abi: ["cp312"]
+        arch: ${{ fromJson(needs.init.outputs.architectures) }}
     steps:
-      - *checkout
+      - name: Checkout the repository
+        uses: actions/checkout@v4.1.7
 
-      - *download-env-file
+      - name: Download env_file
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: env_file
 
-      - *download-requirements-diff
+      - name: Download requirements_diff
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: requirements_diff
 
       - name: Download requirements_all_wheels
-        uses: *actions-download-artifact
+        uses: actions/download-artifact@v4.1.8
         with:
           name: requirements_all_wheels
 
+      - name: Split requirements all
+        run: |
+          # We split requirements all into multiple files.
+          # This is to prevent the build from running out of memory when
+          # resolving packages on 32-bits systems (like armhf, armv7).
+
+          split -l $(expr $(expr $(cat requirements_all.txt | wc -l) + 1) / 3) requirements_all_wheels_${{ matrix.arch }}.txt requirements_all.txt
+
+      - name: Create requirements for cython<3
+        run: |
+          # Some dependencies still require 'cython<3'
+          # and don't yet use isolated build environments.
+          # Build these first.
+          # grpcio: https://github.com/grpc/grpc/issues/33918
+          # pydantic: https://github.com/pydantic/pydantic/issues/7689
+
+          touch requirements_old-cython.txt
+          cat homeassistant/package_constraints.txt | grep 'grpcio==' >> requirements_old-cython.txt
+          cat homeassistant/package_constraints.txt | grep 'pydantic==' >> requirements_old-cython.txt
+
       - name: Adjust build env
         run: |
+          if [ "${{ matrix.arch }}" = "i386" ]; then
+            echo "NPY_DISABLE_SVML=1" >> .env_file
+          fi
+
           # Do not pin numpy in wheels building
           sed -i "/numpy/d" homeassistant/package_constraints.txt
-          # Don't build wheels for uv as uv requires a greater version of rust as currently available on alpine
-          sed -i "/uv/d" requirements.txt
-          sed -i "/uv/d" requirements_diff.txt
 
-      - name: Build wheels
-        uses: *home-assistant-wheels
+      - name: Build wheels (old cython)
+        uses: home-assistant/wheels@2024.07.1
         with:
           abi: ${{ matrix.abi }}
           tag: musllinux_1_2
           arch: ${{ matrix.arch }}
           wheels-key: ${{ secrets.WHEELS_KEY }}
           env-file: true
-          apk: "bluez-dev;libffi-dev;openssl-dev;glib-dev;eudev-dev;libxml2-dev;libxslt-dev;libpng-dev;libjpeg-turbo-dev;tiff-dev;gmp-dev;mpfr-dev;mpc1-dev;ffmpeg-dev;yaml-dev;openblas-dev;fftw-dev;lapack-dev;gfortran;blas-dev;eigen-dev;freetype-dev;glew-dev;harfbuzz-dev;hdf5-dev;libdc1394-dev;libtbb-dev;mesa-dev;openexr-dev;openjpeg-dev;uchardet-dev;nasm;zlib-ng-dev"
-          skip-binary: aiohttp;charset-normalizer;grpcio;multidict;SQLAlchemy;propcache;protobuf;pymicro-vad;yarl
+          apk: "bluez-dev;libffi-dev;openssl-dev;glib-dev;eudev-dev;libxml2-dev;libxslt-dev;libpng-dev;libjpeg-turbo-dev;tiff-dev;cups-dev;gmp-dev;mpfr-dev;mpc1-dev;ffmpeg-dev;gammu-dev;yaml-dev;openblas-dev;fftw-dev;lapack-dev;gfortran;blas-dev;eigen-dev;freetype-dev;glew-dev;harfbuzz-dev;hdf5-dev;libdc1394-dev;libtbb-dev;mesa-dev;openexr-dev;openjpeg-dev;uchardet-dev"
+          skip-binary: aiohttp;charset-normalizer;grpcio;multidict;SQLAlchemy;protobuf;pydantic;pymicro-vad;yarl
           constraints: "homeassistant/package_constraints.txt"
           requirements-diff: "requirements_diff.txt"
-          requirements: "requirements_all.txt"
+          requirements: "requirements_old-cython.txt"
+          pip: "'cython<3'"
+
+      - name: Build wheels (part 1)
+        uses: home-assistant/wheels@2024.07.1
+        with:
+          abi: ${{ matrix.abi }}
+          tag: musllinux_1_2
+          arch: ${{ matrix.arch }}
+          wheels-key: ${{ secrets.WHEELS_KEY }}
+          env-file: true
+          apk: "bluez-dev;libffi-dev;openssl-dev;glib-dev;eudev-dev;libxml2-dev;libxslt-dev;libpng-dev;libjpeg-turbo-dev;tiff-dev;cups-dev;gmp-dev;mpfr-dev;mpc1-dev;ffmpeg-dev;gammu-dev;yaml-dev;openblas-dev;fftw-dev;lapack-dev;gfortran;blas-dev;eigen-dev;freetype-dev;glew-dev;harfbuzz-dev;hdf5-dev;libdc1394-dev;libtbb-dev;mesa-dev;openexr-dev;openjpeg-dev;uchardet-dev;nasm"
+          skip-binary: aiohttp;charset-normalizer;grpcio;multidict;SQLAlchemy;protobuf;pydantic;pymicro-vad;yarl
+          constraints: "homeassistant/package_constraints.txt"
+          requirements-diff: "requirements_diff.txt"
+          requirements: "requirements_all.txtaa"
+
+      - name: Build wheels (part 2)
+        uses: home-assistant/wheels@2024.07.1
+        with:
+          abi: ${{ matrix.abi }}
+          tag: musllinux_1_2
+          arch: ${{ matrix.arch }}
+          wheels-key: ${{ secrets.WHEELS_KEY }}
+          env-file: true
+          apk: "bluez-dev;libffi-dev;openssl-dev;glib-dev;eudev-dev;libxml2-dev;libxslt-dev;libpng-dev;libjpeg-turbo-dev;tiff-dev;cups-dev;gmp-dev;mpfr-dev;mpc1-dev;ffmpeg-dev;gammu-dev;yaml-dev;openblas-dev;fftw-dev;lapack-dev;gfortran;blas-dev;eigen-dev;freetype-dev;glew-dev;harfbuzz-dev;hdf5-dev;libdc1394-dev;libtbb-dev;mesa-dev;openexr-dev;openjpeg-dev;uchardet-dev;nasm"
+          skip-binary: aiohttp;charset-normalizer;grpcio;multidict;SQLAlchemy;protobuf;pydantic;pymicro-vad;yarl
+          constraints: "homeassistant/package_constraints.txt"
+          requirements-diff: "requirements_diff.txt"
+          requirements: "requirements_all.txtab"
+
+      - name: Build wheels (part 3)
+        uses: home-assistant/wheels@2024.07.1
+        with:
+          abi: ${{ matrix.abi }}
+          tag: musllinux_1_2
+          arch: ${{ matrix.arch }}
+          wheels-key: ${{ secrets.WHEELS_KEY }}
+          env-file: true
+          apk: "bluez-dev;libffi-dev;openssl-dev;glib-dev;eudev-dev;libxml2-dev;libxslt-dev;libpng-dev;libjpeg-turbo-dev;tiff-dev;cups-dev;gmp-dev;mpfr-dev;mpc1-dev;ffmpeg-dev;gammu-dev;yaml-dev;openblas-dev;fftw-dev;lapack-dev;gfortran;blas-dev;eigen-dev;freetype-dev;glew-dev;harfbuzz-dev;hdf5-dev;libdc1394-dev;libtbb-dev;mesa-dev;openexr-dev;openjpeg-dev;uchardet-dev;nasm"
+          skip-binary: aiohttp;charset-normalizer;grpcio;multidict;SQLAlchemy;protobuf;pydantic;pymicro-vad;yarl
+          constraints: "homeassistant/package_constraints.txt"
+          requirements-diff: "requirements_diff.txt"
+          requirements: "requirements_all.txtac"

.gitignore

@@ -69,7 +69,6 @@ test-reports/
 test-results.xml
 test-output.xml
 pytest-*.txt
-junit.xml
 
 # Translations
 *.mo
@@ -79,7 +78,7 @@ junit.xml
 .project
 .pydevproject
 
-.tool-versions
+.python-version
 
 # emacs auto backups
 *~
@@ -92,7 +91,6 @@ pip-selfcheck.json
 venv
 .venv
 Pipfile*
-uv.lock
 share/*
 /Scripts/
 
@@ -112,7 +110,6 @@ virtualization/vagrant/config
 !.vscode/cSpell.json
 !.vscode/extensions.json
 !.vscode/tasks.json
-!.vscode/settings.default.jsonc
 .env
 
 # Windows Explorer
@@ -138,9 +135,4 @@ tmp_cache
 .ropeproject
 
 # Will be created from script/split_tests.py
-pytest_buckets.txt
-
-# AI tooling
-.claude/settings.local.json
-.serena/
-
+pytest_buckets.txt

.pre-commit-config.yaml

@@ -1,24 +1,24 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.13.0
+    rev: v0.6.4
     hooks:
-      - id: ruff-check
+      - id: ruff
         args:
           - --fix
       - id: ruff-format
         files: ^((homeassistant|pylint|script|tests)/.+)?[^/]+\.(py|pyi)$
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.4.1
+    rev: v2.3.0
     hooks:
       - id: codespell
         args:
-          - --ignore-words-list=aiport,astroid,checkin,currenty,hass,iif,incomfort,lookin,nam,NotIn
+          - --ignore-words-list=astroid,checkin,currenty,hass,iif,incomfort,lookin,nam,NotIn
           - --skip="./.*,*.csv,*.json,*.ambr"
           - --quiet-level=2
         exclude_types: [csv, json, html]
         exclude: ^tests/fixtures/|homeassistant/generated/|tests/components/.*/snapshots/
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v6.0.0
+    rev: v4.4.0
     hooks:
       - id: check-executables-have-shebangs
         stages: [manual]
@@ -30,16 +30,13 @@ repos:
           - --branch=master
           - --branch=rc
   - repo: https://github.com/adrienverge/yamllint.git
-    rev: v1.37.1
+    rev: v1.35.1
     hooks:
       - id: yamllint
-  - repo: https://github.com/rbubley/mirrors-prettier
-    rev: v3.6.2
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v3.0.3
     hooks:
       - id: prettier
-        additional_dependencies:
-          - prettier@3.6.2
-          - prettier-plugin-sort-json@4.1.1
   - repo: https://github.com/cdce8p/python-typing-update
     rev: v0.6.0
     hooks:
@@ -64,14 +61,13 @@ repos:
         name: mypy
         entry: script/run-in-env.sh mypy
         language: script
-        require_serial: true
         types_or: [python, pyi]
+        require_serial: true
         files: ^(homeassistant|pylint)/.+\.(py|pyi)$
       - id: pylint
         name: pylint
-        entry: script/run-in-env.sh pylint --ignore-missing-annotations=y
+        entry: script/run-in-env.sh pylint -j 0 --ignore-missing-annotations=y
         language: script
-        require_serial: true
         types_or: [python, pyi]
         files: ^(homeassistant|tests)/.+\.(py|pyi)$
       - id: gen_requirements_all
@@ -87,14 +83,14 @@ repos:
         pass_filenames: false
         language: script
         types: [text]
-        files: ^(homeassistant/.+/(icons|manifest|strings)\.json|homeassistant/.+/(conditions|quality_scale|services|triggers)\.yaml|homeassistant/brands/.*\.json|script/hassfest/(?!metadata|mypy_config).+\.py|requirements.+\.txt)$
+        files: ^(homeassistant/.+/(icons|manifest|strings)\.json|homeassistant/brands/.*\.json|homeassistant/.+/services\.yaml|script/hassfest/(?!metadata|mypy_config).+\.py|requirements_test.txt)$
       - id: hassfest-metadata
         name: hassfest-metadata
-        entry: script/run-in-env.sh python3 -m script.hassfest -p metadata,docker
+        entry: script/run-in-env.sh python3 -m script.hassfest -p metadata
         pass_filenames: false
         language: script
         types: [text]
-        files: ^(script/hassfest/(metadata|docker)\.py|homeassistant/const\.py$|pyproject\.toml)$
+        files: ^(script/hassfest/metadata\.py|homeassistant/const\.py$|pyproject\.toml)$
       - id: hassfest-mypy-config
         name: hassfest-mypy-config
         entry: script/run-in-env.sh python3 -m script.hassfest -p mypy_config

.prettierrc.js

@@ -1,24 +0,0 @@
-/** @type {import("prettier").Config} */
-module.exports = {
-  overrides: [
-    {
-      files: "./homeassistant/**/*.json",
-      options: {
-        plugins: [require.resolve("prettier-plugin-sort-json")],
-        jsonRecursiveSort: true,
-        jsonSortOrder: JSON.stringify({ [/.*/]: "numeric" }),
-      },
-    },
-    {
-      files: ["manifest.json", "./**/brands/*.json"],
-      options: {
-        // domain and name should stay at the top
-        jsonSortOrder: JSON.stringify({
-          domain: null,
-          name: null,
-          [/.*/]: "numeric",
-        }),
-      },
-    },
-  ],
-};

.python-version

@@ -1 +0,0 @@
-3.13

.strict-typing

@@ -41,7 +41,6 @@ homeassistant.util.unit_system
 # --- Add components below this line ---
 homeassistant.components
 homeassistant.components.abode.*
-homeassistant.components.acaia.*
 homeassistant.components.accuweather.*
 homeassistant.components.acer_projector.*
 homeassistant.components.acmeda.*
@@ -53,7 +52,6 @@ homeassistant.components.air_quality.*
 homeassistant.components.airgradient.*
 homeassistant.components.airly.*
 homeassistant.components.airnow.*
-homeassistant.components.airos.*
 homeassistant.components.airq.*
 homeassistant.components.airthings.*
 homeassistant.components.airthings_ble.*
@@ -66,9 +64,7 @@ homeassistant.components.aladdin_connect.*
 homeassistant.components.alarm_control_panel.*
 homeassistant.components.alert.*
 homeassistant.components.alexa.*
-homeassistant.components.alexa_devices.*
 homeassistant.components.alpha_vantage.*
-homeassistant.components.altruist.*
 homeassistant.components.amazon_polly.*
 homeassistant.components.amberelectric.*
 homeassistant.components.ambient_network.*
@@ -106,8 +102,6 @@ homeassistant.components.auth.*
 homeassistant.components.automation.*
 homeassistant.components.awair.*
 homeassistant.components.axis.*
-homeassistant.components.azure_storage.*
-homeassistant.components.backblaze_b2.*
 homeassistant.components.backup.*
 homeassistant.components.baf.*
 homeassistant.components.bang_olufsen.*
@@ -120,18 +114,16 @@ homeassistant.components.blueprint.*
 homeassistant.components.bluesound.*
 homeassistant.components.bluetooth.*
 homeassistant.components.bluetooth_adapters.*
+homeassistant.components.bluetooth_tracker.*
 homeassistant.components.bmw_connected_drive.*
 homeassistant.components.bond.*
-homeassistant.components.bosch_alarm.*
 homeassistant.components.braviatv.*
-homeassistant.components.bring.*
 homeassistant.components.brother.*
 homeassistant.components.browser.*
 homeassistant.components.bryant_evolution.*
 homeassistant.components.bthome.*
 homeassistant.components.button.*
 homeassistant.components.calendar.*
-homeassistant.components.cambridge_audio.*
 homeassistant.components.camera.*
 homeassistant.components.canary.*
 homeassistant.components.cert_expiry.*
@@ -140,12 +132,9 @@ homeassistant.components.clicksend.*
 homeassistant.components.climate.*
 homeassistant.components.cloud.*
 homeassistant.components.co2signal.*
-homeassistant.components.comelit.*
 homeassistant.components.command_line.*
-homeassistant.components.compit.*
 homeassistant.components.config.*
 homeassistant.components.configurator.*
-homeassistant.components.cookidoo.*
 homeassistant.components.counter.*
 homeassistant.components.cover.*
 homeassistant.components.cpuspeed.*
@@ -170,7 +159,6 @@ homeassistant.components.dnsip.*
 homeassistant.components.doorbird.*
 homeassistant.components.dormakaba_dkey.*
 homeassistant.components.downloader.*
-homeassistant.components.droplet.*
 homeassistant.components.dsmr.*
 homeassistant.components.duckdns.*
 homeassistant.components.dunehd.*
@@ -179,15 +167,14 @@ homeassistant.components.easyenergy.*
 homeassistant.components.ecovacs.*
 homeassistant.components.ecowitt.*
 homeassistant.components.efergy.*
-homeassistant.components.eheimdigital.*
 homeassistant.components.electrasmart.*
 homeassistant.components.electric_kiwi.*
+homeassistant.components.elevenlabs.*
 homeassistant.components.elgato.*
 homeassistant.components.elkm1.*
 homeassistant.components.emulated_hue.*
 homeassistant.components.energenie_power_sockets.*
 homeassistant.components.energy.*
-homeassistant.components.energyid.*
 homeassistant.components.energyzero.*
 homeassistant.components.enigma2.*
 homeassistant.components.enphase_envoy.*
@@ -203,7 +190,6 @@ homeassistant.components.feedreader.*
 homeassistant.components.file_upload.*
 homeassistant.components.filesize.*
 homeassistant.components.filter.*
-homeassistant.components.firefly_iii.*
 homeassistant.components.fitbit.*
 homeassistant.components.flexit_bacnet.*
 homeassistant.components.flux_led.*
@@ -221,38 +207,29 @@ homeassistant.components.generic_thermostat.*
 homeassistant.components.geo_location.*
 homeassistant.components.geocaching.*
 homeassistant.components.gios.*
-homeassistant.components.github.*
 homeassistant.components.glances.*
-homeassistant.components.go2rtc.*
 homeassistant.components.goalzero.*
 homeassistant.components.google.*
 homeassistant.components.google_assistant_sdk.*
 homeassistant.components.google_cloud.*
-homeassistant.components.google_drive.*
 homeassistant.components.google_photos.*
 homeassistant.components.google_sheets.*
-homeassistant.components.google_weather.*
-homeassistant.components.govee_ble.*
 homeassistant.components.gpsd.*
 homeassistant.components.greeneye_monitor.*
 homeassistant.components.group.*
 homeassistant.components.guardian.*
-homeassistant.components.habitica.*
 homeassistant.components.hardkernel.*
 homeassistant.components.hardware.*
-homeassistant.components.heos.*
 homeassistant.components.here_travel_time.*
 homeassistant.components.history.*
 homeassistant.components.history_stats.*
 homeassistant.components.holiday.*
-homeassistant.components.home_connect.*
 homeassistant.components.homeassistant.*
 homeassistant.components.homeassistant_alerts.*
 homeassistant.components.homeassistant_green.*
 homeassistant.components.homeassistant_hardware.*
 homeassistant.components.homeassistant_sky_connect.*
 homeassistant.components.homeassistant_yellow.*
-homeassistant.components.homee.*
 homeassistant.components.homekit.*
 homeassistant.components.homekit_controller
 homeassistant.components.homekit_controller.alarm_control_panel
@@ -278,9 +255,6 @@ homeassistant.components.image_processing.*
 homeassistant.components.image_upload.*
 homeassistant.components.imap.*
 homeassistant.components.imgw_pib.*
-homeassistant.components.immich.*
-homeassistant.components.incomfort.*
-homeassistant.components.inels.*
 homeassistant.components.input_button.*
 homeassistant.components.input_select.*
 homeassistant.components.input_text.*
@@ -291,7 +265,6 @@ homeassistant.components.ios.*
 homeassistant.components.iotty.*
 homeassistant.components.ipp.*
 homeassistant.components.iqvia.*
-homeassistant.components.iron_os.*
 homeassistant.components.islamic_prayer_times.*
 homeassistant.components.isy994.*
 homeassistant.components.jellyfin.*
@@ -301,7 +274,6 @@ homeassistant.components.kaleidescape.*
 homeassistant.components.knocki.*
 homeassistant.components.knx.*
 homeassistant.components.kraken.*
-homeassistant.components.kulersky.*
 homeassistant.components.lacrosse.*
 homeassistant.components.lacrosse_view.*
 homeassistant.components.lamarzocco.*
@@ -312,11 +284,10 @@ homeassistant.components.lcn.*
 homeassistant.components.ld2410_ble.*
 homeassistant.components.led_ble.*
 homeassistant.components.lektrico.*
-homeassistant.components.letpot.*
-homeassistant.components.libre_hardware_monitor.*
 homeassistant.components.lidarr.*
 homeassistant.components.lifx.*
 homeassistant.components.light.*
+homeassistant.components.linear_garage_door.*
 homeassistant.components.linkplay.*
 homeassistant.components.litejet.*
 homeassistant.components.litterrobot.*
@@ -327,23 +298,18 @@ homeassistant.components.logbook.*
 homeassistant.components.logger.*
 homeassistant.components.london_underground.*
 homeassistant.components.lookin.*
-homeassistant.components.lovelace.*
 homeassistant.components.luftdaten.*
-homeassistant.components.lunatone.*
 homeassistant.components.madvr.*
 homeassistant.components.manual.*
+homeassistant.components.map.*
 homeassistant.components.mastodon.*
 homeassistant.components.matrix.*
 homeassistant.components.matter.*
-homeassistant.components.mcp.*
-homeassistant.components.mcp_server.*
-homeassistant.components.mealie.*
 homeassistant.components.media_extractor.*
 homeassistant.components.media_player.*
 homeassistant.components.media_source.*
 homeassistant.components.met_eireann.*
 homeassistant.components.metoffice.*
-homeassistant.components.miele.*
 homeassistant.components.mikrotik.*
 homeassistant.components.min_max.*
 homeassistant.components.minecraft_server.*
@@ -356,13 +322,11 @@ homeassistant.components.moon.*
 homeassistant.components.mopeka.*
 homeassistant.components.motionmount.*
 homeassistant.components.mqtt.*
-homeassistant.components.music_assistant.*
 homeassistant.components.my.*
 homeassistant.components.mysensors.*
 homeassistant.components.myuplink.*
 homeassistant.components.nam.*
 homeassistant.components.nanoleaf.*
-homeassistant.components.nasweb.*
 homeassistant.components.neato.*
 homeassistant.components.nest.*
 homeassistant.components.netatmo.*
@@ -372,43 +336,27 @@ homeassistant.components.nfandroidtv.*
 homeassistant.components.nightscout.*
 homeassistant.components.nissan_leaf.*
 homeassistant.components.no_ip.*
-homeassistant.components.nordpool.*
 homeassistant.components.notify.*
 homeassistant.components.notion.*
-homeassistant.components.ntfy.*
 homeassistant.components.number.*
 homeassistant.components.nut.*
-homeassistant.components.ohme.*
 homeassistant.components.onboarding.*
 homeassistant.components.oncue.*
-homeassistant.components.onedrive.*
 homeassistant.components.onewire.*
 homeassistant.components.onkyo.*
 homeassistant.components.open_meteo.*
-homeassistant.components.open_router.*
-homeassistant.components.openai_conversation.*
 homeassistant.components.openexchangerates.*
 homeassistant.components.opensky.*
 homeassistant.components.openuv.*
-homeassistant.components.opnsense.*
-homeassistant.components.opower.*
 homeassistant.components.oralb.*
 homeassistant.components.otbr.*
 homeassistant.components.overkiz.*
-homeassistant.components.overseerr.*
 homeassistant.components.p1_monitor.*
-homeassistant.components.panel_custom.*
-homeassistant.components.paperless_ngx.*
-homeassistant.components.peblar.*
 homeassistant.components.peco.*
-homeassistant.components.pegel_online.*
 homeassistant.components.persistent_notification.*
-homeassistant.components.person.*
 homeassistant.components.pi_hole.*
 homeassistant.components.ping.*
 homeassistant.components.plugwise.*
-homeassistant.components.portainer.*
-homeassistant.components.powerfox.*
 homeassistant.components.powerwall.*
 homeassistant.components.private_ble_device.*
 homeassistant.components.prometheus.*
@@ -418,24 +366,17 @@ homeassistant.components.pure_energie.*
 homeassistant.components.purpleair.*
 homeassistant.components.pushbullet.*
 homeassistant.components.pvoutput.*
-homeassistant.components.pyload.*
-homeassistant.components.python_script.*
-homeassistant.components.qbus.*
 homeassistant.components.qnap_qsw.*
 homeassistant.components.rabbitair.*
 homeassistant.components.radarr.*
-homeassistant.components.radio_browser.*
 homeassistant.components.rainforest_raven.*
 homeassistant.components.rainmachine.*
 homeassistant.components.raspberry_pi.*
 homeassistant.components.rdw.*
 homeassistant.components.recollect_waste.*
 homeassistant.components.recorder.*
-homeassistant.components.remember_the_milk.*
 homeassistant.components.remote.*
-homeassistant.components.remote_calendar.*
 homeassistant.components.renault.*
-homeassistant.components.reolink.*
 homeassistant.components.repairs.*
 homeassistant.components.rest.*
 homeassistant.components.rest_command.*
@@ -447,16 +388,14 @@ homeassistant.components.rituals_perfume_genie.*
 homeassistant.components.roborock.*
 homeassistant.components.roku.*
 homeassistant.components.romy.*
-homeassistant.components.route_b_smart_meter.*
 homeassistant.components.rpi_power.*
 homeassistant.components.rss_feed_template.*
-homeassistant.components.russound_rio.*
+homeassistant.components.rtsp_to_webrtc.*
 homeassistant.components.ruuvi_gateway.*
 homeassistant.components.ruuvitag_ble.*
 homeassistant.components.samsungtv.*
 homeassistant.components.scene.*
 homeassistant.components.schedule.*
-homeassistant.components.schlage.*
 homeassistant.components.scrape.*
 homeassistant.components.script.*
 homeassistant.components.search.*
@@ -464,12 +403,9 @@ homeassistant.components.select.*
 homeassistant.components.sensibo.*
 homeassistant.components.sensirion_ble.*
 homeassistant.components.sensor.*
-homeassistant.components.sensorpush_cloud.*
 homeassistant.components.sensoterra.*
 homeassistant.components.senz.*
 homeassistant.components.sfr_box.*
-homeassistant.components.sftp_storage.*
-homeassistant.components.shell_command.*
 homeassistant.components.shelly.*
 homeassistant.components.shopping_list.*
 homeassistant.components.simplepush.*
@@ -477,24 +413,19 @@ homeassistant.components.simplisafe.*
 homeassistant.components.siren.*
 homeassistant.components.skybell.*
 homeassistant.components.slack.*
-homeassistant.components.sleep_as_android.*
 homeassistant.components.sleepiq.*
-homeassistant.components.sma.*
 homeassistant.components.smhi.*
-homeassistant.components.smlight.*
-homeassistant.components.smtp.*
 homeassistant.components.snooz.*
 homeassistant.components.solarlog.*
 homeassistant.components.sonarr.*
 homeassistant.components.speedtestdotnet.*
-homeassistant.components.spotify.*
 homeassistant.components.sql.*
 homeassistant.components.squeezebox.*
 homeassistant.components.ssdp.*
 homeassistant.components.starlink.*
 homeassistant.components.statistics.*
 homeassistant.components.steamist.*
-homeassistant.components.stookwijzer.*
+homeassistant.components.stookalert.*
 homeassistant.components.stream.*
 homeassistant.components.streamlabswater.*
 homeassistant.components.stt.*
@@ -502,7 +433,6 @@ homeassistant.components.suez_water.*
 homeassistant.components.sun.*
 homeassistant.components.surepetcare.*
 homeassistant.components.switch.*
-homeassistant.components.switch_as_x.*
 homeassistant.components.switchbee.*
 homeassistant.components.switchbot_cloud.*
 homeassistant.components.switcher_kis.*
@@ -514,12 +444,10 @@ homeassistant.components.tag.*
 homeassistant.components.tailscale.*
 homeassistant.components.tailwind.*
 homeassistant.components.tami4.*
-homeassistant.components.tankerkoenig.*
 homeassistant.components.tautulli.*
 homeassistant.components.tcp.*
 homeassistant.components.technove.*
 homeassistant.components.tedee.*
-homeassistant.components.telegram_bot.*
 homeassistant.components.text.*
 homeassistant.components.thethingsnetwork.*
 homeassistant.components.threshold.*
@@ -550,24 +478,18 @@ homeassistant.components.unifiprotect.*
 homeassistant.components.upcloud.*
 homeassistant.components.update.*
 homeassistant.components.uptime.*
-homeassistant.components.uptime_kuma.*
 homeassistant.components.uptimerobot.*
 homeassistant.components.usb.*
-homeassistant.components.uvc.*
 homeassistant.components.vacuum.*
 homeassistant.components.vallox.*
 homeassistant.components.valve.*
 homeassistant.components.velbus.*
-homeassistant.components.vivotek.*
 homeassistant.components.vlc_telnet.*
-homeassistant.components.vodafone_station.*
-homeassistant.components.volvo.*
 homeassistant.components.wake_on_lan.*
 homeassistant.components.wake_word.*
 homeassistant.components.wallbox.*
 homeassistant.components.waqi.*
 homeassistant.components.water_heater.*
-homeassistant.components.watts.*
 homeassistant.components.watttime.*
 homeassistant.components.weather.*
 homeassistant.components.webhook.*
@@ -578,9 +500,7 @@ homeassistant.components.whois.*
 homeassistant.components.withings.*
 homeassistant.components.wiz.*
 homeassistant.components.wled.*
-homeassistant.components.workday.*
 homeassistant.components.worldclock.*
-homeassistant.components.xbox.*
 homeassistant.components.xiaomi_ble.*
 homeassistant.components.yale_smart_alarm.*
 homeassistant.components.yalexs_ble.*

.vscode/launch.json

@@ -38,17 +38,10 @@
       "module": "pytest",
       "justMyCode": false,
       "args": [
+        "--timeout=10",
         "--picked"
       ],
     },
-    {
-      "name": "Home Assistant: Debug Current Test File",
-      "type": "debugpy",
-      "request": "launch",
-      "module": "pytest",
-      "console": "integratedTerminal",
-      "args": ["-vv", "${file}"]
-    },
     {
       // Debug by attaching to local Home Assistant server using Remote Python Debugger.
       // See https://www.home-assistant.io/integrations/debugpy/
@@ -84,4 +77,4 @@
       ]
     }
   ]
-}
+}

.vscode/settings.default.json

@@ -0,0 +1,10 @@
+{
+  // Please keep this file in sync with settings in home-assistant/.devcontainer/devcontainer.json
+  // Added --no-cov to work around TypeError: message must be set
+  // https://github.com/microsoft/vscode-python/issues/14067
+  "python.testing.pytestArgs": ["--no-cov"],
+  // https://code.visualstudio.com/docs/python/testing#_pytest-configuration-settings
+  "python.testing.pytestEnabled": false,
+  // https://code.visualstudio.com/docs/python/linting#_general-settings
+  "pylint.importStrategy": "fromEnvironment"
+}

.vscode/settings.default.jsonc

@@ -1,25 +0,0 @@
-{
-  // Please keep this file (mostly!) in sync with settings in home-assistant/.devcontainer/devcontainer.json
-  // Added --no-cov to work around TypeError: message must be set
-  // https://github.com/microsoft/vscode-python/issues/14067
-  "python.testing.pytestArgs": ["--no-cov"],
-  // https://code.visualstudio.com/docs/python/testing#_pytest-configuration-settings
-  "python.testing.pytestEnabled": false,
-  // https://code.visualstudio.com/docs/python/linting#_general-settings
-  "pylint.importStrategy": "fromEnvironment",
-  // Pyright is too pedantic for Home Assistant
-  "python.analysis.typeCheckingMode": "basic",
-  "[python]": {
-    "editor.defaultFormatter": "charliermarsh.ruff",
-  },
-  "[json][jsonc][yaml]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode",
-  },
-  "json.schemas": [
-    {
-      "fileMatch": ["homeassistant/components/*/manifest.json"],
-      // This value differs between working with devcontainer and locally, therefore this value should NOT be in sync!
-      "url": "./script/json_schemas/manifest_schema.json",
-    },
-  ],
-}

.vscode/tasks.json

@@ -4,7 +4,7 @@
     {
       "label": "Run Home Assistant Core",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m homeassistant -c ./config",
+      "command": "hass -c ./config",
       "group": "test",
       "presentation": {
         "reveal": "always",
@@ -16,7 +16,7 @@
     {
       "label": "Pytest",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m pytest --timeout=10 tests",
+      "command": "python3 -m pytest --timeout=10 tests",
       "dependsOn": ["Install all Test Requirements"],
       "group": {
         "kind": "test",
@@ -31,7 +31,7 @@
     {
       "label": "Pytest (changed tests only)",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m pytest --timeout=10 --picked",
+      "command": "python3 -m pytest --timeout=10 --picked",
       "group": {
         "kind": "test",
         "isDefault": true
@@ -45,21 +45,7 @@
     {
       "label": "Ruff",
       "type": "shell",
-      "command": "pre-commit run ruff-check --all-files",
-      "group": {
-        "kind": "test",
-        "isDefault": true
-      },
-      "presentation": {
-        "reveal": "always",
-        "panel": "new"
-      },
-      "problemMatcher": []
-    },
-    {
-      "label": "Pre-commit",
-      "type": "shell",
-      "command": "pre-commit run --show-diff-on-failure",
+      "command": "pre-commit run ruff --all-files",
       "group": {
         "kind": "test",
         "isDefault": true
@@ -89,23 +75,7 @@
       "label": "Code Coverage",
       "detail": "Generate code coverage report for a given integration.",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m pytest ./tests/components/${input:integrationName}/ --cov=homeassistant.components.${input:integrationName} --cov-report term-missing --durations-min=1 --durations=0 --numprocesses=auto",
-      "dependsOn": ["Compile English translations"],
-      "group": {
-        "kind": "test",
-        "isDefault": true
-      },
-      "presentation": {
-        "reveal": "always",
-        "panel": "new"
-      },
-      "problemMatcher": []
-    },
-    {
-      "label": "Update syrupy snapshots",
-      "detail": "Update syrupy snapshots for a given integration.",
-      "type": "shell",
-      "command": "${command:python.interpreterPath} -m pytest ./tests/components/${input:integrationName} --snapshot-update",
+      "command": "python3 -m pytest ./tests/components/${input:integrationName}/ --cov=homeassistant.components.${input:integrationName} --cov-report term-missing --durations-min=1 --durations=0 --numprocesses=auto",
       "dependsOn": ["Compile English translations"],
       "group": {
         "kind": "test",
@@ -148,7 +118,7 @@
     {
       "label": "Install all Test Requirements",
       "type": "shell",
-      "command": "uv pip install -r requirements.txt -r requirements_test_all.txt",
+      "command": "uv pip install -r requirements_test_all.txt",
       "group": {
         "kind": "build",
         "isDefault": true
@@ -163,7 +133,7 @@
       "label": "Compile English translations",
       "detail": "In order to test changes to translation files, the translation strings must be compiled into Home Assistant's translation directories.",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m script.translations develop --all",
+      "command": "python3 -m script.translations develop --all",
       "group": {
         "kind": "build",
         "isDefault": true
@@ -173,7 +143,7 @@
       "label": "Run scaffold",
       "detail": "Add new functionality to a integration using a scaffold.",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m script.scaffold ${input:scaffoldName} --integration ${input:integrationName}",
+      "command": "python3 -m script.scaffold ${input:scaffoldName} --integration ${input:integrationName}",
       "group": {
         "kind": "build",
         "isDefault": true
@@ -183,7 +153,7 @@
       "label": "Create new integration",
       "detail": "Use the scaffold to create a new integration.",
       "type": "shell",
-      "command": "${command:python.interpreterPath} -m script.scaffold integration",
+      "command": "python3 -m script.scaffold integration",
       "group": {
         "kind": "build",
         "isDefault": true

AGENTS.md

@@ -1 +0,0 @@
-.github/copilot-instructions.md

CLAUDE.md

@@ -1 +0,0 @@
-.github/copilot-instructions.md

CONTRIBUTING.md

@@ -14,8 +14,5 @@ Still interested? Then you should take a peek at the [developer documentation](h
 
 ## Feature suggestions
 
-If you want to suggest a new feature for Home Assistant (e.g. new integrations), please [start a discussion](https://github.com/orgs/home-assistant/discussions) on GitHub.
-
-## Issue Tracker
-
-If you want to report an issue, please [create an issue](https://github.com/home-assistant/core/issues) on GitHub.
+If you want to suggest a new feature for Home Assistant (e.g., new integrations), please open a thread in our [Community Forum: Feature Requests](https://community.home-assistant.io/c/feature-requests).
+We use [GitHub for tracking issues](https://github.com/home-assistant/core/issues), not for tracking feature requests.

Dockerfile

@@ -4,33 +4,15 @@
 ARG BUILD_FROM
 FROM ${BUILD_FROM}
 
-LABEL \
-    io.hass.type="core" \
-    org.opencontainers.image.authors="The Home Assistant Authors" \
-    org.opencontainers.image.description="Open-source home automation platform running on Python 3" \
-    org.opencontainers.image.documentation="https://www.home-assistant.io/docs/" \
-    org.opencontainers.image.licenses="Apache-2.0" \
-    org.opencontainers.image.source="https://github.com/home-assistant/core" \
-    org.opencontainers.image.title="Home Assistant" \
-    org.opencontainers.image.url="https://www.home-assistant.io/"
-
 # Synchronize with homeassistant/core.py:async_stop
 ENV \
     S6_SERVICES_GRACETIME=240000 \
-    UV_SYSTEM_PYTHON=true \
-    UV_NO_CACHE=true
+    UV_SYSTEM_PYTHON=true
 
-# Home Assistant S6-Overlay
-COPY rootfs /
+ARG QEMU_CPU
 
-# Add go2rtc binary
-COPY --from=ghcr.io/alexxit/go2rtc@sha256:f394f6329f5389a4c9a7fc54b09fdec9621bbb78bf7a672b973440bbdfb02241 /usr/local/bin/go2rtc /bin/go2rtc
-
-RUN \
-    # Verify go2rtc can be executed
-    go2rtc --version \
-    # Install uv
-    && pip3 install uv==0.9.17
+# Install uv
+RUN pip3 install uv==0.2.27
 
 WORKDIR /usr/src
 
@@ -47,9 +29,15 @@ RUN \
     if ls homeassistant/home_assistant_*.whl 1> /dev/null 2>&1; then \
         uv pip install homeassistant/home_assistant_*.whl; \
     fi \
-    && uv pip install \
-        --no-build \
-        -r homeassistant/requirements_all.txt
+    && if [ "${BUILD_ARCH}" = "i386" ]; then \
+        linux32 uv pip install \
+            --no-build \
+            -r homeassistant/requirements_all.txt; \
+    else \
+        uv pip install \
+            --no-build \
+            -r homeassistant/requirements_all.txt; \
+    fi
 
 ## Setup Home Assistant Core
 COPY . homeassistant/
@@ -59,4 +47,7 @@ RUN \
     && python3 -m compileall \
         homeassistant/homeassistant
 
+# Home Assistant S6-Overlay
+COPY rootfs /
+
 WORKDIR /config

Dockerfile.dev

@@ -1,9 +1,18 @@
-FROM mcr.microsoft.com/vscode/devcontainers/base:debian
+FROM mcr.microsoft.com/devcontainers/python:1-3.12
 
 SHELL ["/bin/bash", "-o", "pipefail", "-c"]
 
+# Uninstall pre-installed formatting and linting tools
+# They would conflict with our pinned versions
 RUN \
-    apt-get update \
+    pipx uninstall pydocstyle \
+    && pipx uninstall pycodestyle \
+    && pipx uninstall mypy \
+    && pipx uninstall pylint
+
+RUN \
+    curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - \
+    && apt-get update \
     && DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends \
         # Additional library needed by some tests and accordingly by VScode Tests Discovery
         bluez \
@@ -13,6 +22,7 @@ RUN \
         libavcodec-dev \
         libavdevice-dev \
         libavutil-dev \
+        libgammu-dev \
         libswscale-dev \
         libswresample-dev \
         libavfilter-dev \
@@ -22,37 +32,34 @@ RUN \
         libxml2 \
         git \
         cmake \
-        autoconf \
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
 
-# Add go2rtc binary
-COPY --from=ghcr.io/alexxit/go2rtc:latest /usr/local/bin/go2rtc /bin/go2rtc
+# Install uv
+RUN pip3 install uv
 
 WORKDIR /usr/src
 
-COPY --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/uv
+# Setup hass-release
+RUN git clone --depth 1 https://github.com/home-assistant/hass-release \
+    && uv pip install --system -e hass-release/ \
+    && chown -R vscode /usr/src/hass-release/data
 
 USER vscode
-
 ENV VIRTUAL_ENV="/home/vscode/.local/ha-venv"
-RUN --mount=type=bind,source=.python-version,target=.python-version \
-    uv python install \
-    && uv venv $VIRTUAL_ENV
+RUN uv venv $VIRTUAL_ENV
 ENV PATH="$VIRTUAL_ENV/bin:$PATH"
 
-# Setup hass-release
-RUN git clone --depth 1 https://github.com/home-assistant/hass-release ~/hass-release \
-    && uv pip install -e ~/hass-release/
+WORKDIR /tmp
 
 # Install Python dependencies from requirements
-RUN --mount=type=bind,source=requirements.txt,target=requirements.txt \
-    --mount=type=bind,source=homeassistant/package_constraints.txt,target=homeassistant/package_constraints.txt \
-    --mount=type=bind,source=requirements_test.txt,target=requirements_test.txt \
-    --mount=type=bind,source=requirements_test_pre_commit.txt,target=requirements_test_pre_commit.txt \
-    uv pip install -r requirements.txt -r requirements_test.txt
+COPY requirements.txt ./
+COPY homeassistant/package_constraints.txt homeassistant/package_constraints.txt
+RUN uv pip install -r requirements.txt
+COPY requirements_test.txt requirements_test_pre_commit.txt ./
+RUN uv pip install -r requirements_test.txt
 
 WORKDIR /workspaces
 
 # Set the default shell to bash instead of sh
-ENV SHELL=/bin/bash
+ENV SHELL /bin/bash

README.rst

@@ -7,6 +7,8 @@ Check out `home-assistant.io <https://home-assistant.io>`__ for `a
 demo <https://demo.home-assistant.io>`__, `installation instructions <https://home-assistant.io/getting-started/>`__,
 `tutorials <https://home-assistant.io/getting-started/automation/>`__ and `documentation <https://home-assistant.io/docs/>`__.
 
+This is a project of the `Open Home Foundation <https://www.openhomefoundation.org/>`__.
+
 |screenshot-states|
 
 Featured integrations
@@ -20,14 +22,9 @@ components <https://developers.home-assistant.io/docs/creating_component_index/>
 If you run into issues while using Home Assistant or during development
 of a component, check the `Home Assistant help section <https://home-assistant.io/help/>`__ of our website for further help and information.
 
-|ohf-logo|
-
 .. |Chat Status| image:: https://img.shields.io/discord/330944238910963714.svg
    :target: https://www.home-assistant.io/join-chat/
 .. |screenshot-states| image:: https://raw.githubusercontent.com/home-assistant/core/dev/.github/assets/screenshot-states.png
    :target: https://demo.home-assistant.io
 .. |screenshot-integrations| image:: https://raw.githubusercontent.com/home-assistant/core/dev/.github/assets/screenshot-integrations.png
    :target: https://home-assistant.io/integrations/
-.. |ohf-logo| image:: https://www.openhomefoundation.org/badges/home-assistant.png
-   :alt: Home Assistant - A project from the Open Home Foundation
-   :target: https://www.openhomefoundation.org/

build.yaml

@@ -0,0 +1,22 @@
+image: ghcr.io/home-assistant/{arch}-homeassistant
+build_from:
+  aarch64: ghcr.io/home-assistant/aarch64-homeassistant-base:2024.06.1
+  armhf: ghcr.io/home-assistant/armhf-homeassistant-base:2024.06.1
+  armv7: ghcr.io/home-assistant/armv7-homeassistant-base:2024.06.1
+  amd64: ghcr.io/home-assistant/amd64-homeassistant-base:2024.06.1
+  i386: ghcr.io/home-assistant/i386-homeassistant-base:2024.06.1
+codenotary:
+  signer: notary@home-assistant.io
+  base_image: notary@home-assistant.io
+cosign:
+  base_identity: https://github.com/home-assistant/docker/.*
+  identity: https://github.com/home-assistant/core/.*
+labels:
+  io.hass.type: core
+  org.opencontainers.image.title: Home Assistant
+  org.opencontainers.image.description: Open-source home automation platform running on Python 3
+  org.opencontainers.image.source: https://github.com/home-assistant/core
+  org.opencontainers.image.authors: The Home Assistant Authors
+  org.opencontainers.image.url: https://www.home-assistant.io/
+  org.opencontainers.image.documentation: https://www.home-assistant.io/docs/
+  org.opencontainers.image.licenses: Apache License 2.0

homeassistant/__main__.py

@@ -9,7 +9,6 @@ import os
 import sys
 import threading
 
-from .backup_restore import restore_backup
 from .const import REQUIRED_PYTHON_VER, RESTART_EXIT_CODE, __version__
 
 FAULT_LOG_FILENAME = "home-assistant.log.fault"
@@ -38,7 +37,8 @@ def validate_python() -> None:
 
 def ensure_config_path(config_dir: str) -> None:
     """Validate the configuration directory."""
-    from . import config as config_util  # noqa: PLC0415
+    # pylint: disable-next=import-outside-toplevel
+    from . import config as config_util
 
     lib_dir = os.path.join(config_dir, "deps")
 
@@ -79,7 +79,8 @@ def ensure_config_path(config_dir: str) -> None:
 
 def get_arguments() -> argparse.Namespace:
     """Get parsed passed in arguments."""
-    from . import config as config_util  # noqa: PLC0415
+    # pylint: disable-next=import-outside-toplevel
+    from . import config as config_util
 
     parser = argparse.ArgumentParser(
         description="Home Assistant: Observe, Control, Automate.",
@@ -175,54 +176,47 @@ def main() -> int:
         validate_os()
 
     if args.script is not None:
-        from . import scripts  # noqa: PLC0415
+        # pylint: disable-next=import-outside-toplevel
+        from . import scripts
 
         return scripts.run(args.script)
 
     config_dir = os.path.abspath(os.path.join(os.getcwd(), args.config))
-    if restore_backup(config_dir):
-        return RESTART_EXIT_CODE
-
     ensure_config_path(config_dir)
 
-    from . import config, runner  # noqa: PLC0415
+    # pylint: disable-next=import-outside-toplevel
+    from . import config, runner
 
-    # Ensure only one instance runs per config directory
-    with runner.ensure_single_execution(config_dir) as single_execution_lock:
-        # Check if another instance is already running
-        if single_execution_lock.exit_code is not None:
-            return single_execution_lock.exit_code
+    safe_mode = config.safe_mode_enabled(config_dir)
 
-        safe_mode = config.safe_mode_enabled(config_dir)
+    runtime_conf = runner.RuntimeConfig(
+        config_dir=config_dir,
+        verbose=args.verbose,
+        log_rotate_days=args.log_rotate_days,
+        log_file=args.log_file,
+        log_no_color=args.log_no_color,
+        skip_pip=args.skip_pip,
+        skip_pip_packages=args.skip_pip_packages,
+        recovery_mode=args.recovery_mode,
+        debug=args.debug,
+        open_ui=args.open_ui,
+        safe_mode=safe_mode,
+    )
 
-        runtime_conf = runner.RuntimeConfig(
-            config_dir=config_dir,
-            verbose=args.verbose,
-            log_rotate_days=args.log_rotate_days,
-            log_file=args.log_file,
-            log_no_color=args.log_no_color,
-            skip_pip=args.skip_pip,
-            skip_pip_packages=args.skip_pip_packages,
-            recovery_mode=args.recovery_mode,
-            debug=args.debug,
-            open_ui=args.open_ui,
-            safe_mode=safe_mode,
-        )
+    fault_file_name = os.path.join(config_dir, FAULT_LOG_FILENAME)
+    with open(fault_file_name, mode="a", encoding="utf8") as fault_file:
+        faulthandler.enable(fault_file)
+        exit_code = runner.run(runtime_conf)
+        faulthandler.disable()
 
-        fault_file_name = os.path.join(config_dir, FAULT_LOG_FILENAME)
-        with open(fault_file_name, mode="a", encoding="utf8") as fault_file:
-            faulthandler.enable(fault_file)
-            exit_code = runner.run(runtime_conf)
-            faulthandler.disable()
+    # It's possible for the fault file to disappear, so suppress obvious errors
+    with suppress(FileNotFoundError):
+        if os.path.getsize(fault_file_name) == 0:
+            os.remove(fault_file_name)
 
-        # It's possible for the fault file to disappear, so suppress obvious errors
-        with suppress(FileNotFoundError):
-            if os.path.getsize(fault_file_name) == 0:
-                os.remove(fault_file_name)
+    check_threads()
 
-        check_threads()
-
-        return exit_code
+    return exit_code
 
 
 if __name__ == "__main__":

homeassistant/auth/__init__.py

@@ -12,6 +12,7 @@ from typing import Any, cast
 
 import jwt
 
+from homeassistant import data_entry_flow
 from homeassistant.core import (
     CALLBACK_TYPE,
     HassJob,
@@ -19,14 +20,13 @@ from homeassistant.core import (
     HomeAssistant,
     callback,
 )
-from homeassistant.data_entry_flow import FlowHandler, FlowManager, FlowResultType
 from homeassistant.helpers.event import async_track_point_in_utc_time
 from homeassistant.util import dt as dt_util
 
 from . import auth_store, jwt_wrapper, models
 from .const import ACCESS_TOKEN_EXPIRATION, GROUP_ID_ADMIN, REFRESH_TOKEN_EXPIRATION
 from .mfa_modules import MultiFactorAuthModule, auth_mfa_module_from_config
-from .models import AuthFlowContext, AuthFlowResult
+from .models import AuthFlowResult
 from .providers import AuthProvider, LoginFlow, auth_provider_from_config
 from .providers.homeassistant import HassAuthProvider
 
@@ -98,7 +98,7 @@ async def auth_manager_from_config(
 
 
 class AuthManagerFlowManager(
-    FlowManager[AuthFlowContext, AuthFlowResult, tuple[str, str]]
+    data_entry_flow.FlowManager[AuthFlowResult, tuple[str, str]]
 ):
     """Manage authentication flows."""
 
@@ -113,9 +113,9 @@ class AuthManagerFlowManager(
         self,
         handler_key: tuple[str, str],
         *,
-        context: AuthFlowContext | None = None,
+        context: dict[str, Any] | None = None,
         data: dict[str, Any] | None = None,
-    ) -> LoginFlow[Any]:
+    ) -> LoginFlow:
         """Create a login flow."""
         auth_provider = self.auth_manager.get_auth_provider(*handler_key)
         if not auth_provider:
@@ -124,17 +124,13 @@ class AuthManagerFlowManager(
 
     async def async_finish_flow(
         self,
-        flow: FlowHandler[AuthFlowContext, AuthFlowResult, tuple[str, str]],
+        flow: data_entry_flow.FlowHandler[AuthFlowResult, tuple[str, str]],
         result: AuthFlowResult,
     ) -> AuthFlowResult:
-        """Return a user as result of login flow.
-
-        This method is called when a flow step returns FlowResultType.ABORT or
-        FlowResultType.CREATE_ENTRY.
-        """
+        """Return a user as result of login flow."""
         flow = cast(LoginFlow, flow)
 
-        if result["type"] != FlowResultType.CREATE_ENTRY:
+        if result["type"] != data_entry_flow.FlowResultType.CREATE_ENTRY:
             return result
 
         # we got final result
@@ -402,8 +398,6 @@ class AuthManager:
         if user.is_owner:
             raise ValueError("Unable to deactivate the owner")
         await self._store.async_deactivate_user(user)
-        for refresh_token in list(user.refresh_tokens.values()):
-            self.async_remove_refresh_token(refresh_token)
 
     async def async_remove_credentials(self, credentials: models.Credentials) -> None:
         """Remove credentials."""

homeassistant/auth/auth_store.py

@@ -120,9 +120,6 @@ class AuthStore:
 
         new_user = models.User(**kwargs)
 
-        while new_user.id in self._users:
-            new_user = models.User(**kwargs)
-
         self._users[new_user.id] = new_user
 
         if credentials is None:
@@ -311,7 +308,7 @@ class AuthStore:
         credentials.data = data
         self._async_schedule_save()
 
-    async def async_load(self) -> None:
+    async def async_load(self) -> None:  # noqa: C901
         """Load the users."""
         if self._loaded:
             raise RuntimeError("Auth storage is already loaded")

homeassistant/auth/jwt_wrapper.py

@@ -18,7 +18,7 @@ from homeassistant.util.json import json_loads
 JWT_TOKEN_CACHE_SIZE = 16
 MAX_TOKEN_SIZE = 8192
 
-_VERIFY_KEYS = ("signature", "exp", "nbf", "iat", "aud", "iss", "sub", "jti")
+_VERIFY_KEYS = ("signature", "exp", "nbf", "iat", "aud", "iss")
 
 _VERIFY_OPTIONS: dict[str, Any] = {f"verify_{key}": True for key in _VERIFY_KEYS} | {
     "require": []

homeassistant/auth/mfa_modules/__init__.py

@@ -71,7 +71,7 @@ class MultiFactorAuthModule:
         """Return a voluptuous schema to define mfa auth module's input."""
         raise NotImplementedError
 
-    async def async_setup_flow(self, user_id: str) -> SetupFlow[Any]:
+    async def async_setup_flow(self, user_id: str) -> SetupFlow:
         """Return a data entry flow handler for setup module.
 
         Mfa module should extend SetupFlow
@@ -95,16 +95,11 @@ class MultiFactorAuthModule:
         raise NotImplementedError
 
 
-class SetupFlow[_MultiFactorAuthModuleT: MultiFactorAuthModule = MultiFactorAuthModule](
-    data_entry_flow.FlowHandler
-):
+class SetupFlow(data_entry_flow.FlowHandler):
     """Handler for the setup flow."""
 
     def __init__(
-        self,
-        auth_module: _MultiFactorAuthModuleT,
-        setup_schema: vol.Schema,
-        user_id: str,
+        self, auth_module: MultiFactorAuthModule, setup_schema: vol.Schema, user_id: str
     ) -> None:
         """Initialize the setup flow."""
         self._auth_module = auth_module

homeassistant/auth/mfa_modules/notify.py

@@ -6,6 +6,7 @@ Sending HOTP through notify service
 from __future__ import annotations
 
 import asyncio
+from collections import OrderedDict
 import logging
 from typing import Any, cast
 
@@ -26,7 +27,7 @@ from . import (
     SetupFlow,
 )
 
-REQUIREMENTS = ["pyotp==2.9.0"]
+REQUIREMENTS = ["pyotp==2.8.0"]
 
 CONF_MESSAGE = "message"
 
@@ -51,28 +52,28 @@ _LOGGER = logging.getLogger(__name__)
 
 def _generate_secret() -> str:
     """Generate a secret."""
-    import pyotp  # noqa: PLC0415
+    import pyotp  # pylint: disable=import-outside-toplevel
 
     return str(pyotp.random_base32())
 
 
 def _generate_random() -> int:
     """Generate a 32 digit number."""
-    import pyotp  # noqa: PLC0415
+    import pyotp  # pylint: disable=import-outside-toplevel
 
     return int(pyotp.random_base32(length=32, chars=list("1234567890")))
 
 
 def _generate_otp(secret: str, count: int) -> str:
     """Generate one time password."""
-    import pyotp  # noqa: PLC0415
+    import pyotp  # pylint: disable=import-outside-toplevel
 
     return str(pyotp.HOTP(secret).at(count))
 
 
 def _verify_otp(secret: str, otp: str, count: int) -> bool:
     """Verify one time password."""
-    import pyotp  # noqa: PLC0415
+    import pyotp  # pylint: disable=import-outside-toplevel
 
     return bool(pyotp.HOTP(secret).verify(otp, count))
 
@@ -161,7 +162,7 @@ class NotifyAuthModule(MultiFactorAuthModule):
 
         return sorted(unordered_services)
 
-    async def async_setup_flow(self, user_id: str) -> NotifySetupFlow:
+    async def async_setup_flow(self, user_id: str) -> SetupFlow:
         """Return a data entry flow handler for setup module.
 
         Mfa module should extend SetupFlow
@@ -267,7 +268,7 @@ class NotifyAuthModule(MultiFactorAuthModule):
         await self.hass.services.async_call("notify", notify_service, data)
 
 
-class NotifySetupFlow(SetupFlow[NotifyAuthModule]):
+class NotifySetupFlow(SetupFlow):
     """Handler for the setup flow."""
 
     def __init__(
@@ -279,6 +280,8 @@ class NotifySetupFlow(SetupFlow[NotifyAuthModule]):
     ) -> None:
         """Initialize the setup flow."""
         super().__init__(auth_module, setup_schema, user_id)
+        # to fix typing complaint
+        self._auth_module: NotifyAuthModule = auth_module
         self._available_notify_services = available_notify_services
         self._secret: str | None = None
         self._count: int | None = None
@@ -303,14 +306,13 @@ class NotifySetupFlow(SetupFlow[NotifyAuthModule]):
         if not self._available_notify_services:
             return self.async_abort(reason="no_available_service")
 
-        schema = vol.Schema(
-            {
-                vol.Required("notify_service"): vol.In(self._available_notify_services),
-                vol.Optional("target"): str,
-            }
-        )
+        schema: dict[str, Any] = OrderedDict()
+        schema["notify_service"] = vol.In(self._available_notify_services)
+        schema["target"] = vol.Optional(str)
 
-        return self.async_show_form(step_id="init", data_schema=schema, errors=errors)
+        return self.async_show_form(
+            step_id="init", data_schema=vol.Schema(schema), errors=errors
+        )
 
     async def async_step_setup(
         self, user_input: dict[str, str] | None = None

homeassistant/auth/mfa_modules/totp.py

@@ -20,7 +20,7 @@ from . import (
     SetupFlow,
 )
 
-REQUIREMENTS = ["pyotp==2.9.0", "PyQRCode==1.2.1"]
+REQUIREMENTS = ["pyotp==2.8.0", "PyQRCode==1.2.1"]
 
 CONFIG_SCHEMA = MULTI_FACTOR_AUTH_MODULE_SCHEMA.extend({}, extra=vol.PREVENT_EXTRA)
 
@@ -34,13 +34,10 @@ INPUT_FIELD_CODE = "code"
 
 DUMMY_SECRET = "FPPTH34D4E3MI2HG"
 
-GOOGLE_AUTHENTICATOR_URL = "https://support.google.com/accounts/answer/1066447"
-AUTHY_URL = "https://authy.com/"
-
 
 def _generate_qr_code(data: str) -> str:
     """Generate a base64 PNG string represent QR Code image of data."""
-    import pyqrcode  # noqa: PLC0415
+    import pyqrcode  # pylint: disable=import-outside-toplevel
 
     qr_code = pyqrcode.create(data)
 
@@ -62,7 +59,7 @@ def _generate_qr_code(data: str) -> str:
 
 def _generate_secret_and_qr_code(username: str) -> tuple[str, str, str]:
     """Generate a secret, url, and QR code."""
-    import pyotp  # noqa: PLC0415
+    import pyotp  # pylint: disable=import-outside-toplevel
 
     ota_secret = pyotp.random_base32()
     url = pyotp.totp.TOTP(ota_secret).provisioning_uri(
@@ -110,14 +107,14 @@ class TotpAuthModule(MultiFactorAuthModule):
 
     def _add_ota_secret(self, user_id: str, secret: str | None = None) -> str:
         """Create a ota_secret for user."""
-        import pyotp  # noqa: PLC0415
+        import pyotp  # pylint: disable=import-outside-toplevel
 
         ota_secret: str = secret or pyotp.random_base32()
 
         self._users[user_id] = ota_secret  # type: ignore[index]
         return ota_secret
 
-    async def async_setup_flow(self, user_id: str) -> TotpSetupFlow:
+    async def async_setup_flow(self, user_id: str) -> SetupFlow:
         """Return a data entry flow handler for setup module.
 
         Mfa module should extend SetupFlow
@@ -166,7 +163,7 @@ class TotpAuthModule(MultiFactorAuthModule):
 
     def _validate_2fa(self, user_id: str, code: str) -> bool:
         """Validate two factor authentication code."""
-        import pyotp  # noqa: PLC0415
+        import pyotp  # pylint: disable=import-outside-toplevel
 
         if (ota_secret := self._users.get(user_id)) is None:  # type: ignore[union-attr]
             # even we cannot find user, we still do verify
@@ -177,19 +174,20 @@ class TotpAuthModule(MultiFactorAuthModule):
         return bool(pyotp.TOTP(ota_secret).verify(code, valid_window=1))
 
 
-class TotpSetupFlow(SetupFlow[TotpAuthModule]):
+class TotpSetupFlow(SetupFlow):
     """Handler for the setup flow."""
 
-    _ota_secret: str
-    _url: str
-    _image: str
-
     def __init__(
         self, auth_module: TotpAuthModule, setup_schema: vol.Schema, user: User
     ) -> None:
         """Initialize the setup flow."""
         super().__init__(auth_module, setup_schema, user.id)
+        # to fix typing complaint
+        self._auth_module: TotpAuthModule = auth_module
         self._user = user
+        self._ota_secret: str = ""
+        self._url: str | None = None
+        self._image: str | None = None
 
     async def async_step_init(
         self, user_input: dict[str, str] | None = None
@@ -199,7 +197,7 @@ class TotpSetupFlow(SetupFlow[TotpAuthModule]):
         Return self.async_show_form(step_id='init') if user_input is None.
         Return self.async_create_entry(data={'result': result}) if finish.
         """
-        import pyotp  # noqa: PLC0415
+        import pyotp  # pylint: disable=import-outside-toplevel
 
         errors: dict[str, str] = {}
 
@@ -216,11 +214,12 @@ class TotpSetupFlow(SetupFlow[TotpAuthModule]):
             errors["base"] = "invalid_code"
 
         else:
+            hass = self._auth_module.hass
             (
                 self._ota_secret,
                 self._url,
                 self._image,
-            ) = await self._auth_module.hass.async_add_executor_job(
+            ) = await hass.async_add_executor_job(
                 _generate_secret_and_qr_code,
                 str(self._user.name),
             )
@@ -232,8 +231,6 @@ class TotpSetupFlow(SetupFlow[TotpAuthModule]):
                 "code": self._ota_secret,
                 "url": self._url,
                 "qr_code": self._image,
-                "google_authenticator_url": GOOGLE_AUTHENTICATOR_URL,
-                "authy_url": AUTHY_URL,
             },
             errors=errors,
         )

homeassistant/auth/models.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from datetime import datetime, timedelta
-from ipaddress import IPv4Address, IPv6Address
+from functools import cached_property
 import secrets
 from typing import Any, NamedTuple
 import uuid
@@ -11,10 +11,9 @@ import uuid
 import attr
 from attr import Attribute
 from attr.setters import validate
-from propcache.api import cached_property
 
 from homeassistant.const import __version__
-from homeassistant.data_entry_flow import FlowContext, FlowResult
+from homeassistant.data_entry_flow import FlowResult
 from homeassistant.util import dt as dt_util
 
 from . import permissions as perm_mdl
@@ -24,19 +23,7 @@ TOKEN_TYPE_NORMAL = "normal"
 TOKEN_TYPE_SYSTEM = "system"
 TOKEN_TYPE_LONG_LIVED_ACCESS_TOKEN = "long_lived_access_token"
 
-
-class AuthFlowContext(FlowContext, total=False):
-    """Typed context dict for auth flow."""
-
-    credential_only: bool
-    ip_address: IPv4Address | IPv6Address
-    redirect_uri: str
-
-
-class AuthFlowResult(FlowResult[AuthFlowContext, tuple[str, str]], total=False):
-    """Typed result dict for auth flow."""
-
-    result: Credentials  # Only present if type is CREATE_ENTRY
+AuthFlowResult = FlowResult[tuple[str, str]]
 
 
 @attr.s(slots=True)

homeassistant/auth/permissions/__init__.py

@@ -17,12 +17,12 @@ POLICY_SCHEMA = vol.Schema({vol.Optional(CAT_ENTITIES): ENTITY_POLICY_SCHEMA})
 
 __all__ = [
     "POLICY_SCHEMA",
-    "AbstractPermissions",
-    "OwnerPermissions",
-    "PermissionLookup",
-    "PolicyPermissions",
-    "PolicyType",
     "merge_policies",
+    "PermissionLookup",
+    "PolicyType",
+    "AbstractPermissions",
+    "PolicyPermissions",
+    "OwnerPermissions",
 ]
 
 

homeassistant/auth/permissions/events.py

@@ -7,7 +7,6 @@ from typing import Any, Final
 from homeassistant.const import (
     EVENT_COMPONENT_LOADED,
     EVENT_CORE_CONFIG_UPDATE,
-    EVENT_LABS_UPDATED,
     EVENT_LOVELACE_UPDATED,
     EVENT_PANELS_UPDATED,
     EVENT_RECORDER_5MIN_STATISTICS_GENERATED,
@@ -46,7 +45,6 @@ SUBSCRIBE_ALLOWLIST: Final[set[EventType[Any] | str]] = {
     EVENT_STATE_CHANGED,
     EVENT_THEMES_UPDATED,
     EVENT_LABEL_REGISTRY_UPDATED,
-    EVENT_LABS_UPDATED,
     EVENT_CATEGORY_REGISTRY_UPDATED,
     EVENT_FLOOR_REGISTRY_UPDATED,
 }

homeassistant/auth/providers/__init__.py

@@ -10,10 +10,9 @@ from typing import Any
 import voluptuous as vol
 from voluptuous.humanize import humanize_error
 
-from homeassistant import requirements
+from homeassistant import data_entry_flow, requirements
 from homeassistant.const import CONF_ID, CONF_NAME, CONF_TYPE
 from homeassistant.core import HomeAssistant, callback
-from homeassistant.data_entry_flow import FlowHandler
 from homeassistant.exceptions import HomeAssistantError
 from homeassistant.helpers.importlib import async_import_module
 from homeassistant.util import dt as dt_util
@@ -22,14 +21,7 @@ from homeassistant.util.hass_dict import HassKey
 
 from ..auth_store import AuthStore
 from ..const import MFA_SESSION_EXPIRATION
-from ..models import (
-    AuthFlowContext,
-    AuthFlowResult,
-    Credentials,
-    RefreshToken,
-    User,
-    UserMeta,
-)
+from ..models import AuthFlowResult, Credentials, RefreshToken, User, UserMeta
 
 _LOGGER = logging.getLogger(__name__)
 DATA_REQS: HassKey[set[str]] = HassKey("auth_prov_reqs_processed")
@@ -105,7 +97,7 @@ class AuthProvider:
 
     # Implement by extending class
 
-    async def async_login_flow(self, context: AuthFlowContext | None) -> LoginFlow[Any]:
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow:
         """Return the data flow for logging in with auth provider.
 
         Auth provider should extend LoginFlow and return an instance.
@@ -192,14 +184,12 @@ async def load_auth_provider_module(
     return module
 
 
-class LoginFlow[_AuthProviderT: AuthProvider = AuthProvider](
-    FlowHandler[AuthFlowContext, AuthFlowResult, tuple[str, str]],
-):
+class LoginFlow(data_entry_flow.FlowHandler[AuthFlowResult, tuple[str, str]]):
     """Handler for the login flow."""
 
     _flow_result = AuthFlowResult
 
-    def __init__(self, auth_provider: _AuthProviderT) -> None:
+    def __init__(self, auth_provider: AuthProvider) -> None:
         """Initialize the login flow."""
         self._auth_provider = auth_provider
         self._auth_module_id: str | None = None

homeassistant/auth/providers/command_line.py

@@ -6,14 +6,14 @@ import asyncio
 from collections.abc import Mapping
 import logging
 import os
-from typing import Any
+from typing import Any, cast
 
 import voluptuous as vol
 
 from homeassistant.const import CONF_COMMAND
 from homeassistant.exceptions import HomeAssistantError
 
-from ..models import AuthFlowContext, AuthFlowResult, Credentials, UserMeta
+from ..models import AuthFlowResult, Credentials, UserMeta
 from . import AUTH_PROVIDER_SCHEMA, AUTH_PROVIDERS, AuthProvider, LoginFlow
 
 CONF_ARGS = "args"
@@ -59,9 +59,7 @@ class CommandLineAuthProvider(AuthProvider):
         super().__init__(*args, **kwargs)
         self._user_meta: dict[str, dict[str, Any]] = {}
 
-    async def async_login_flow(
-        self, context: AuthFlowContext | None
-    ) -> CommandLineLoginFlow:
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow:
         """Return a flow to login."""
         return CommandLineLoginFlow(self)
 
@@ -135,7 +133,7 @@ class CommandLineAuthProvider(AuthProvider):
         )
 
 
-class CommandLineLoginFlow(LoginFlow[CommandLineAuthProvider]):
+class CommandLineLoginFlow(LoginFlow):
     """Handler for the login flow."""
 
     async def async_step_init(
@@ -147,9 +145,9 @@ class CommandLineLoginFlow(LoginFlow[CommandLineAuthProvider]):
         if user_input is not None:
             user_input["username"] = user_input["username"].strip()
             try:
-                await self._auth_provider.async_validate_login(
-                    user_input["username"], user_input["password"]
-                )
+                await cast(
+                    CommandLineAuthProvider, self._auth_provider
+                ).async_validate_login(user_input["username"], user_input["password"])
             except InvalidAuthError:
                 errors["base"] = "invalid_auth"
 

homeassistant/auth/providers/homeassistant.py

@@ -17,7 +17,7 @@ from homeassistant.exceptions import HomeAssistantError
 from homeassistant.helpers import issue_registry as ir
 from homeassistant.helpers.storage import Store
 
-from ..models import AuthFlowContext, AuthFlowResult, Credentials, UserMeta
+from ..models import AuthFlowResult, Credentials, UserMeta
 from . import AUTH_PROVIDER_SCHEMA, AUTH_PROVIDERS, AuthProvider, LoginFlow
 
 STORAGE_VERSION = 1
@@ -179,18 +179,12 @@ class Data:
         user_hash = base64.b64decode(found["password"])
 
         # bcrypt.checkpw is timing-safe
-        # With bcrypt 5.0 passing a password longer than 72 bytes raises a ValueError.
-        # Previously the password was silently truncated.
-        # https://github.com/pyca/bcrypt/pull/1000
-        if not bcrypt.checkpw(password.encode()[:72], user_hash):
+        if not bcrypt.checkpw(password.encode(), user_hash):
             raise InvalidAuth
 
     def hash_password(self, password: str, for_storage: bool = False) -> bytes:
         """Encode a password."""
-        # With bcrypt 5.0 passing a password longer than 72 bytes raises a ValueError.
-        # Previously the password was silently truncated.
-        # https://github.com/pyca/bcrypt/pull/1000
-        hashed: bytes = bcrypt.hashpw(password.encode()[:72], bcrypt.gensalt(rounds=12))
+        hashed: bytes = bcrypt.hashpw(password.encode(), bcrypt.gensalt(rounds=12))
 
         if for_storage:
             hashed = base64.b64encode(hashed)
@@ -311,7 +305,7 @@ class HassAuthProvider(AuthProvider):
             await data.async_load()
             self.data = data
 
-    async def async_login_flow(self, context: AuthFlowContext | None) -> HassLoginFlow:
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow:
         """Return a flow to login."""
         return HassLoginFlow(self)
 
@@ -406,7 +400,7 @@ class HassAuthProvider(AuthProvider):
             pass
 
 
-class HassLoginFlow(LoginFlow[HassAuthProvider]):
+class HassLoginFlow(LoginFlow):
     """Handler for the login flow."""
 
     async def async_step_init(
@@ -417,7 +411,7 @@ class HassLoginFlow(LoginFlow[HassAuthProvider]):
 
         if user_input is not None:
             try:
-                await self._auth_provider.async_validate_login(
+                await cast(HassAuthProvider, self._auth_provider).async_validate_login(
                     user_input["username"], user_input["password"]
                 )
             except InvalidAuth:

homeassistant/auth/providers/insecure_example.py

@@ -4,13 +4,14 @@ from __future__ import annotations
 
 from collections.abc import Mapping
 import hmac
+from typing import Any, cast
 
 import voluptuous as vol
 
 from homeassistant.core import callback
 from homeassistant.exceptions import HomeAssistantError
 
-from ..models import AuthFlowContext, AuthFlowResult, Credentials, UserMeta
+from ..models import AuthFlowResult, Credentials, UserMeta
 from . import AUTH_PROVIDER_SCHEMA, AUTH_PROVIDERS, AuthProvider, LoginFlow
 
 USER_SCHEMA = vol.Schema(
@@ -35,9 +36,7 @@ class InvalidAuthError(HomeAssistantError):
 class ExampleAuthProvider(AuthProvider):
     """Example auth provider based on hardcoded usernames and passwords."""
 
-    async def async_login_flow(
-        self, context: AuthFlowContext | None
-    ) -> ExampleLoginFlow:
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow:
         """Return a flow to login."""
         return ExampleLoginFlow(self)
 
@@ -94,7 +93,7 @@ class ExampleAuthProvider(AuthProvider):
         return UserMeta(name=name, is_active=True)
 
 
-class ExampleLoginFlow(LoginFlow[ExampleAuthProvider]):
+class ExampleLoginFlow(LoginFlow):
     """Handler for the login flow."""
 
     async def async_step_init(
@@ -105,7 +104,7 @@ class ExampleLoginFlow(LoginFlow[ExampleAuthProvider]):
 
         if user_input is not None:
             try:
-                self._auth_provider.async_validate_login(
+                cast(ExampleAuthProvider, self._auth_provider).async_validate_login(
                     user_input["username"], user_input["password"]
                 )
             except InvalidAuthError:

homeassistant/auth/providers/trusted_networks.py

@@ -21,17 +21,11 @@ import voluptuous as vol
 
 from homeassistant.core import callback
 from homeassistant.exceptions import HomeAssistantError
-from homeassistant.helpers import config_validation as cv
+import homeassistant.helpers.config_validation as cv
 from homeassistant.helpers.network import is_cloud_connection
 
 from .. import InvalidAuthError
-from ..models import (
-    AuthFlowContext,
-    AuthFlowResult,
-    Credentials,
-    RefreshToken,
-    UserMeta,
-)
+from ..models import AuthFlowResult, Credentials, RefreshToken, UserMeta
 from . import AUTH_PROVIDER_SCHEMA, AUTH_PROVIDERS, AuthProvider, LoginFlow
 
 type IPAddress = IPv4Address | IPv6Address
@@ -104,9 +98,7 @@ class TrustedNetworksAuthProvider(AuthProvider):
         """Trusted Networks auth provider does not support MFA."""
         return False
 
-    async def async_login_flow(
-        self, context: AuthFlowContext | None
-    ) -> TrustedNetworksLoginFlow:
+    async def async_login_flow(self, context: dict[str, Any] | None) -> LoginFlow:
         """Return a flow to login."""
         assert context is not None
         ip_addr = cast(IPAddress, context.get("ip_address"))
@@ -216,7 +208,7 @@ class TrustedNetworksAuthProvider(AuthProvider):
         self.async_validate_access(ip_address(remote_ip))
 
 
-class TrustedNetworksLoginFlow(LoginFlow[TrustedNetworksAuthProvider]):
+class TrustedNetworksLoginFlow(LoginFlow):
     """Handler for the login flow."""
 
     def __init__(
@@ -237,7 +229,9 @@ class TrustedNetworksLoginFlow(LoginFlow[TrustedNetworksAuthProvider]):
     ) -> AuthFlowResult:
         """Handle the step of the form."""
         try:
-            self._auth_provider.async_validate_access(self._ip_address)
+            cast(
+                TrustedNetworksAuthProvider, self._auth_provider
+            ).async_validate_access(self._ip_address)
 
         except InvalidAuthError:
             return self.async_abort(reason="not_allowed")

homeassistant/backports/enum.py

@@ -0,0 +1,29 @@
+"""Enum backports from standard lib.
+
+This file contained the backport of the StrEnum of Python 3.11.
+
+Since we have dropped support for Python 3.10, we can remove this backport.
+This file is kept for now to avoid breaking custom components that might
+import it.
+"""
+
+from __future__ import annotations
+
+from enum import StrEnum as _StrEnum
+from functools import partial
+
+from homeassistant.helpers.deprecation import (
+    DeprecatedAlias,
+    all_with_deprecated_constants,
+    check_if_deprecated_constant,
+    dir_with_deprecated_constants,
+)
+
+# StrEnum deprecated as of 2024.5 use enum.StrEnum instead.
+_DEPRECATED_StrEnum = DeprecatedAlias(_StrEnum, "enum.StrEnum", "2025.5")
+
+__getattr__ = partial(check_if_deprecated_constant, module_globals=globals())
+__dir__ = partial(
+    dir_with_deprecated_constants, module_globals_keys=[*globals().keys()]
+)
+__all__ = all_with_deprecated_constants(globals())

homeassistant/backports/functools.py

@@ -0,0 +1,30 @@
+"""Functools backports from standard lib.
+
+This file contained the backport of the cached_property implementation of Python 3.12.
+
+Since we have dropped support for Python 3.11, we can remove this backport.
+This file is kept for now to avoid breaking custom components that might
+import it.
+"""
+
+from __future__ import annotations
+
+from functools import cached_property as _cached_property, partial
+
+from homeassistant.helpers.deprecation import (
+    DeprecatedAlias,
+    all_with_deprecated_constants,
+    check_if_deprecated_constant,
+    dir_with_deprecated_constants,
+)
+
+# cached_property deprecated as of 2024.5 use functools.cached_property instead.
+_DEPRECATED_cached_property = DeprecatedAlias(
+    _cached_property, "functools.cached_property", "2025.5"
+)
+
+__getattr__ = partial(check_if_deprecated_constant, module_globals=globals())
+__dir__ = partial(
+    dir_with_deprecated_constants, module_globals_keys=[*globals().keys()]
+)
+__all__ = all_with_deprecated_constants(globals())

homeassistant/backup_restore.py

@@ -1,213 +0,0 @@
-"""Home Assistant module to handle restoring backups."""
-
-from __future__ import annotations
-
-from collections.abc import Iterable
-from dataclasses import dataclass
-import hashlib
-import json
-import logging
-from pathlib import Path
-import shutil
-import sys
-from tempfile import TemporaryDirectory
-
-from awesomeversion import AwesomeVersion
-import securetar
-
-from .const import __version__ as HA_VERSION
-
-RESTORE_BACKUP_FILE = ".HA_RESTORE"
-RESTORE_BACKUP_RESULT_FILE = ".HA_RESTORE_RESULT"
-KEEP_BACKUPS = ("backups",)
-KEEP_DATABASE = (
-    "home-assistant_v2.db",
-    "home-assistant_v2.db-wal",
-)
-
-
-_LOGGER = logging.getLogger(__name__)
-
-
-@dataclass
-class RestoreBackupFileContent:
-    """Definition for restore backup file content."""
-
-    backup_file_path: Path
-    password: str | None
-    remove_after_restore: bool
-    restore_database: bool
-    restore_homeassistant: bool
-
-
-def password_to_key(password: str) -> bytes:
-    """Generate a AES Key from password.
-
-    Matches the implementation in supervisor.backups.utils.password_to_key.
-    """
-    key: bytes = password.encode()
-    for _ in range(100):
-        key = hashlib.sha256(key).digest()
-    return key[:16]
-
-
-def restore_backup_file_content(config_dir: Path) -> RestoreBackupFileContent | None:
-    """Return the contents of the restore backup file."""
-    instruction_path = config_dir.joinpath(RESTORE_BACKUP_FILE)
-    try:
-        instruction_content = json.loads(instruction_path.read_text(encoding="utf-8"))
-        return RestoreBackupFileContent(
-            backup_file_path=Path(instruction_content["path"]),
-            password=instruction_content["password"],
-            remove_after_restore=instruction_content["remove_after_restore"],
-            restore_database=instruction_content["restore_database"],
-            restore_homeassistant=instruction_content["restore_homeassistant"],
-        )
-    except FileNotFoundError:
-        return None
-    except (KeyError, json.JSONDecodeError) as err:
-        _write_restore_result_file(config_dir, False, err)
-        return None
-    finally:
-        # Always remove the backup instruction file to prevent a boot loop
-        instruction_path.unlink(missing_ok=True)
-
-
-def _clear_configuration_directory(config_dir: Path, keep: Iterable[str]) -> None:
-    """Delete all files and directories in the config directory except entries in the keep list."""
-    keep_paths = [config_dir.joinpath(path) for path in keep]
-    entries_to_remove = sorted(
-        entry for entry in config_dir.iterdir() if entry not in keep_paths
-    )
-
-    for entry in entries_to_remove:
-        entrypath = config_dir.joinpath(entry)
-
-        if entrypath.is_file():
-            entrypath.unlink()
-        elif entrypath.is_dir():
-            shutil.rmtree(entrypath)
-
-
-def _extract_backup(
-    config_dir: Path,
-    restore_content: RestoreBackupFileContent,
-) -> None:
-    """Extract the backup file to the config directory."""
-    with (
-        TemporaryDirectory() as tempdir,
-        securetar.SecureTarFile(
-            restore_content.backup_file_path,
-            gzip=False,
-            mode="r",
-        ) as ostf,
-    ):
-        ostf.extractall(
-            path=Path(tempdir, "extracted"),
-            members=securetar.secure_path(ostf),
-            filter="fully_trusted",
-        )
-        backup_meta_file = Path(tempdir, "extracted", "backup.json")
-        backup_meta = json.loads(backup_meta_file.read_text(encoding="utf8"))
-
-        if (
-            backup_meta_version := AwesomeVersion(
-                backup_meta["homeassistant"]["version"]
-            )
-        ) > HA_VERSION:
-            raise ValueError(
-                f"You need at least Home Assistant version {backup_meta_version} to restore this backup"
-            )
-
-        with securetar.SecureTarFile(
-            Path(
-                tempdir,
-                "extracted",
-                f"homeassistant.tar{'.gz' if backup_meta['compressed'] else ''}",
-            ),
-            gzip=backup_meta["compressed"],
-            key=password_to_key(restore_content.password)
-            if restore_content.password is not None
-            else None,
-            mode="r",
-        ) as istf:
-            istf.extractall(
-                path=Path(tempdir, "homeassistant"),
-                members=securetar.secure_path(istf),
-                filter="fully_trusted",
-            )
-            if restore_content.restore_homeassistant:
-                keep = list(KEEP_BACKUPS)
-                if not restore_content.restore_database:
-                    keep.extend(KEEP_DATABASE)
-                _clear_configuration_directory(config_dir, keep)
-                shutil.copytree(
-                    Path(tempdir, "homeassistant", "data"),
-                    config_dir,
-                    dirs_exist_ok=True,
-                    ignore=shutil.ignore_patterns(*(keep)),
-                    ignore_dangling_symlinks=True,
-                )
-            elif restore_content.restore_database:
-                for entry in KEEP_DATABASE:
-                    entrypath = config_dir / entry
-
-                    if entrypath.is_file():
-                        entrypath.unlink()
-                    elif entrypath.is_dir():
-                        shutil.rmtree(entrypath)
-
-                for entry in KEEP_DATABASE:
-                    shutil.copy(
-                        Path(tempdir, "homeassistant", "data", entry),
-                        config_dir,
-                    )
-
-
-def _write_restore_result_file(
-    config_dir: Path, success: bool, error: Exception | None
-) -> None:
-    """Write the restore result file."""
-    result_path = config_dir.joinpath(RESTORE_BACKUP_RESULT_FILE)
-    result_path.write_text(
-        json.dumps(
-            {
-                "success": success,
-                "error": str(error) if error else None,
-                "error_type": str(type(error).__name__) if error else None,
-            }
-        ),
-        encoding="utf-8",
-    )
-
-
-def restore_backup(config_dir_path: str) -> bool:
-    """Restore the backup file if any.
-
-    Returns True if a restore backup file was found and restored, False otherwise.
-    """
-    config_dir = Path(config_dir_path)
-    if not (restore_content := restore_backup_file_content(config_dir)):
-        return False
-
-    logging.basicConfig(stream=sys.stdout, level=logging.INFO)
-    backup_file_path = restore_content.backup_file_path
-    _LOGGER.info("Restoring %s", backup_file_path)
-    try:
-        _extract_backup(
-            config_dir=config_dir,
-            restore_content=restore_content,
-        )
-    except FileNotFoundError as err:
-        file_not_found = ValueError(f"Backup file {backup_file_path} does not exist")
-        _write_restore_result_file(config_dir, False, file_not_found)
-        raise file_not_found from err
-    except Exception as err:
-        _write_restore_result_file(config_dir, False, err)
-        raise
-    else:
-        _write_restore_result_file(config_dir, True, None)
-    if restore_content.remove_after_restore:
-        backup_file_path.unlink(missing_ok=True)
-    _LOGGER.info("Restore complete, restarting")
-    return True

homeassistant/block_async_io.py

@@ -31,7 +31,7 @@ def _check_import_call_allowed(mapped_args: dict[str, Any]) -> bool:
 def _check_file_allowed(mapped_args: dict[str, Any]) -> bool:
     # If the file is in /proc we can ignore it.
     args = mapped_args["args"]
-    path = args[0] if type(args[0]) is str else str(args[0])
+    path = args[0] if type(args[0]) is str else str(args[0])  # noqa: E721
     return path.startswith(ALLOWED_FILE_PREFIXES)
 
 
@@ -50,12 +50,6 @@ def _check_sleep_call_allowed(mapped_args: dict[str, Any]) -> bool:
     return False
 
 
-def _check_load_verify_locations_call_allowed(mapped_args: dict[str, Any]) -> bool:
-    # If only cadata is passed, we can ignore it
-    kwargs = mapped_args.get("kwargs")
-    return bool(kwargs and len(kwargs) == 1 and "cadata" in kwargs)
-
-
 @dataclass(slots=True, frozen=True)
 class BlockingCall:
     """Class to hold information about a blocking call."""
@@ -164,7 +158,7 @@ _BLOCKING_CALLS: tuple[BlockingCall, ...] = (
         original_func=SSLContext.load_verify_locations,
         object=SSLContext,
         function="load_verify_locations",
-        check_allowed=_check_load_verify_locations_call_allowed,
+        check_allowed=None,
         strict=False,
         strict_core=False,
         skip_for_tests=True,
@@ -178,15 +172,6 @@ _BLOCKING_CALLS: tuple[BlockingCall, ...] = (
         strict_core=False,
         skip_for_tests=True,
     ),
-    BlockingCall(
-        original_func=SSLContext.set_default_verify_paths,
-        object=SSLContext,
-        function="set_default_verify_paths",
-        check_allowed=None,
-        strict=False,
-        strict_core=False,
-        skip_for_tests=True,
-    ),
     BlockingCall(
         original_func=Path.open,
         object=Path,

homeassistant/bootstrap.py

@@ -53,7 +53,6 @@ from .components import (
     logbook as logbook_pre_import,  # noqa: F401
     lovelace as lovelace_pre_import,  # noqa: F401
     onboarding as onboarding_pre_import,  # noqa: F401
-    person as person_pre_import,  # noqa: F401
     recorder as recorder_import,  # noqa: F401 - not named pre_import since it has requirements
     repairs as repairs_pre_import,  # noqa: F401
     search as search_pre_import,  # noqa: F401
@@ -71,31 +70,26 @@ from .const import (
     REQUIRED_NEXT_PYTHON_VER,
     SIGNAL_BOOTSTRAP_INTEGRATIONS,
 )
-from .core_config import async_process_ha_core_config
 from .exceptions import HomeAssistantError
 from .helpers import (
     area_registry,
     category_registry,
-    condition,
     config_validation as cv,
     device_registry,
     entity,
     entity_registry,
     floor_registry,
-    frame,
     issue_registry,
     label_registry,
     recorder,
     restore_state,
     template,
     translation,
-    trigger,
 )
 from .helpers.dispatcher import async_dispatcher_send_internal
 from .helpers.storage import get_internal_store_manager
-from .helpers.system_info import async_get_system_info
+from .helpers.system_info import async_get_system_info, is_official_image
 from .helpers.typing import ConfigType
-from .loader import Integration
 from .setup import (
     # _setup_started is marked as protected to make it clear
     # that it is not part of the public API and should not be used
@@ -111,17 +105,11 @@ from .util.async_ import create_eager_task
 from .util.hass_dict import HassKey
 from .util.logging import async_activate_log_queue_handler
 from .util.package import async_get_user_site, is_docker_env, is_virtual_env
-from .util.system_info import is_official_image
 
 with contextlib.suppress(ImportError):
     # Ensure anyio backend is imported to avoid it being imported in the event loop
     from anyio._backends import _asyncio  # noqa: F401
 
-with contextlib.suppress(ImportError):
-    # httpx will import trio if it is installed which does
-    # blocking I/O in the event loop. We want to avoid that.
-    import trio  # noqa: F401
-
 
 if TYPE_CHECKING:
     from .runner import RuntimeConfig
@@ -139,12 +127,14 @@ DATA_REGISTRIES_LOADED: HassKey[None] = HassKey("bootstrap_registries_loaded")
 LOG_SLOW_STARTUP_INTERVAL = 60
 SLOW_STARTUP_CHECK_INTERVAL = 1
 
-STAGE_0_SUBSTAGE_TIMEOUT = 60
 STAGE_1_TIMEOUT = 120
 STAGE_2_TIMEOUT = 300
 WRAP_UP_TIMEOUT = 300
 COOLDOWN_TIME = 60
 
+
+DEBUGGER_INTEGRATIONS = {"debugpy"}
+
 # Core integrations are unconditionally loaded
 CORE_INTEGRATIONS = {"homeassistant", "persistent_notification"}
 
@@ -155,10 +145,6 @@ LOGGING_AND_HTTP_DEPS_INTEGRATIONS = {
     "isal",
     # Set log levels
     "logger",
-    # Ensure network config is available
-    # before hassio or any other integration is
-    # loaded that might create an aiohttp client session
-    "network",
     # Error logging
     "system_log",
     "sentry",
@@ -169,27 +155,12 @@ FRONTEND_INTEGRATIONS = {
     # visible in frontend
     "frontend",
 }
-# Stage 0 is divided into substages. Each substage has a name, a set of integrations and a timeout.
-# The substage containing recorder should have no timeout, as it could cancel a database migration.
-# Recorder freezes "recorder" timeout during a migration, but it does not freeze other timeouts.
-# If we add timeouts to the frontend substages, we should make sure they don't apply in recovery mode.
-STAGE_0_INTEGRATIONS = (
-    # Load logging and http deps as soon as possible
-    ("logging, http deps", LOGGING_AND_HTTP_DEPS_INTEGRATIONS, None),
-    # Setup labs for preview features
-    ("labs", {"labs"}, STAGE_0_SUBSTAGE_TIMEOUT),
-    # Setup frontend
-    ("frontend", FRONTEND_INTEGRATIONS, None),
-    # Setup recorder
-    ("recorder", {"recorder"}, None),
-    # Start up debuggers. Start these first in case they want to wait.
-    ("debugger", {"debugpy"}, STAGE_0_SUBSTAGE_TIMEOUT),
-    # Zeroconf is used for mdns resolution in aiohttp client helper.
-    ("zeroconf", {"zeroconf"}, STAGE_0_SUBSTAGE_TIMEOUT),
-)
-
-DISCOVERY_INTEGRATIONS = ("bluetooth", "dhcp", "ssdp", "usb")
-# Stage 1 integrations are not to be preimported in bootstrap.
+RECORDER_INTEGRATIONS = {
+    # Setup after frontend
+    # To record data
+    "recorder",
+}
+DISCOVERY_INTEGRATIONS = ("bluetooth", "dhcp", "ssdp", "usb", "zeroconf")
 STAGE_1_INTEGRATIONS = {
     # We need to make sure discovery integrations
     # update their deps before stage 2 integrations
@@ -204,7 +175,6 @@ STAGE_1_INTEGRATIONS = {
     # Ensure supervisor is available
     "hassio",
 }
-
 DEFAULT_INTEGRATIONS = {
     # These integrations are set up unless recovery mode is activated.
     #
@@ -214,7 +184,6 @@ DEFAULT_INTEGRATIONS = {
     "backup",
     "frontend",
     "hardware",
-    "labs",
     "logger",
     "network",
     "system_health",
@@ -246,12 +215,22 @@ DEFAULT_INTEGRATIONS_SUPERVISOR = {
     # These integrations are set up if using the Supervisor
     "hassio",
 }
-
 CRITICAL_INTEGRATIONS = {
     # Recovery mode is activated if these integrations fail to set up
     "frontend",
 }
 
+SETUP_ORDER = (
+    # Load logging and http deps as soon as possible
+    ("logging, http deps", LOGGING_AND_HTTP_DEPS_INTEGRATIONS),
+    # Setup frontend
+    ("frontend", FRONTEND_INTEGRATIONS),
+    # Setup recorder
+    ("recorder", RECORDER_INTEGRATIONS),
+    # Start up debuggers. Start these first in case they want to wait.
+    ("debugger", DEBUGGER_INTEGRATIONS),
+)
+
 #
 # Storage keys we are likely to load during startup
 # in order of when we expect to load them.
@@ -272,7 +251,6 @@ PRELOAD_STORAGE = [
     "assist_pipeline.pipelines",
     "core.analytics",
     "auth_module.totp",
-    "backup",
 ]
 
 
@@ -303,6 +281,14 @@ async def async_setup_hass(
 
         return hass
 
+    async def stop_hass(hass: core.HomeAssistant) -> None:
+        """Stop hass."""
+        # Ask integrations to shut down. It's messy but we can't
+        # do a clean stop without knowing what is broken
+        with contextlib.suppress(TimeoutError):
+            async with hass.timeout.async_timeout(10):
+                await hass.async_stop()
+
     hass = await create_hass()
 
     if runtime_config.skip_pip or runtime_config.skip_pip_packages:
@@ -318,10 +304,10 @@ async def async_setup_hass(
 
     block_async_io.enable()
 
-    if not (recovery_mode := runtime_config.recovery_mode):
-        config_dict = None
-        basic_setup_success = False
+    config_dict = None
+    basic_setup_success = False
 
+    if not (recovery_mode := runtime_config.recovery_mode):
         await hass.async_add_executor_job(conf_util.process_ha_config_upgrade, hass)
 
         try:
@@ -335,50 +321,43 @@ async def async_setup_hass(
             if not is_virtual_env():
                 await async_mount_local_lib_path(runtime_config.config_dir)
 
-            if hass.config.safe_mode:
-                _LOGGER.info("Starting in safe mode")
-
             basic_setup_success = (
                 await async_from_config_dict(config_dict, hass) is not None
             )
 
-        if config_dict is None:
-            recovery_mode = True
-            await hass.async_stop(force=True)
-            hass = await create_hass()
+    if config_dict is None:
+        recovery_mode = True
+        await stop_hass(hass)
+        hass = await create_hass()
 
-        elif not basic_setup_success:
-            _LOGGER.warning(
-                "Unable to set up core integrations. Activating recovery mode"
-            )
-            recovery_mode = True
-            await hass.async_stop(force=True)
-            hass = await create_hass()
+    elif not basic_setup_success:
+        _LOGGER.warning("Unable to set up core integrations. Activating recovery mode")
+        recovery_mode = True
+        await stop_hass(hass)
+        hass = await create_hass()
 
-        elif any(
-            domain not in hass.config.components for domain in CRITICAL_INTEGRATIONS
-        ):
-            _LOGGER.warning(
-                "Detected that %s did not load. Activating recovery mode",
-                ",".join(CRITICAL_INTEGRATIONS),
-            )
+    elif any(domain not in hass.config.components for domain in CRITICAL_INTEGRATIONS):
+        _LOGGER.warning(
+            "Detected that %s did not load. Activating recovery mode",
+            ",".join(CRITICAL_INTEGRATIONS),
+        )
 
-            old_config = hass.config
-            old_logging = hass.data.get(DATA_LOGGING)
+        old_config = hass.config
+        old_logging = hass.data.get(DATA_LOGGING)
 
-            recovery_mode = True
-            await hass.async_stop(force=True)
-            hass = await create_hass()
+        recovery_mode = True
+        await stop_hass(hass)
+        hass = await create_hass()
 
-            if old_logging:
-                hass.data[DATA_LOGGING] = old_logging
-            hass.config.debug = old_config.debug
-            hass.config.skip_pip = old_config.skip_pip
-            hass.config.skip_pip_packages = old_config.skip_pip_packages
-            hass.config.internal_url = old_config.internal_url
-            hass.config.external_url = old_config.external_url
-            # Setup loader cache after the config dir has been set
-            loader.async_setup(hass)
+        if old_logging:
+            hass.data[DATA_LOGGING] = old_logging
+        hass.config.debug = old_config.debug
+        hass.config.skip_pip = old_config.skip_pip
+        hass.config.skip_pip_packages = old_config.skip_pip_packages
+        hass.config.internal_url = old_config.internal_url
+        hass.config.external_url = old_config.external_url
+        # Setup loader cache after the config dir has been set
+        loader.async_setup(hass)
 
     if recovery_mode:
         _LOGGER.info("Starting in recovery mode")
@@ -390,6 +369,8 @@ async def async_setup_hass(
             {"recovery_mode": {}, "http": http_conf},
             hass,
         )
+    elif hass.config.safe_mode:
+        _LOGGER.info("Starting in safe mode")
 
     if runtime_config.open_ui:
         hass.add_job(open_hass_ui, hass)
@@ -399,7 +380,7 @@ async def async_setup_hass(
 
 def open_hass_ui(hass: core.HomeAssistant) -> None:
     """Open the UI."""
-    import webbrowser  # noqa: PLC0415
+    import webbrowser  # pylint: disable=import-outside-toplevel
 
     if hass.config.api is None or "frontend" not in hass.config.components:
         _LOGGER.warning("Cannot launch the UI because frontend not loaded")
@@ -439,10 +420,9 @@ async def async_load_base_functionality(hass: core.HomeAssistant) -> None:
     if DATA_REGISTRIES_LOADED in hass.data:
         return
     hass.data[DATA_REGISTRIES_LOADED] = None
-    entity.async_setup(hass)
-    frame.async_setup(hass)
-    template.async_setup(hass)
     translation.async_setup(hass)
+    entity.async_setup(hass)
+    template.async_setup(hass)
     await asyncio.gather(
         create_eager_task(get_internal_store_manager(hass).async_initialize()),
         create_eager_task(area_registry.async_load(hass)),
@@ -457,8 +437,6 @@ async def async_load_base_functionality(hass: core.HomeAssistant) -> None:
         create_eager_task(restore_state.async_load(hass)),
         create_eager_task(hass.config_entries.async_initialize()),
         create_eager_task(async_get_system_info(hass)),
-        create_eager_task(condition.async_setup(hass)),
-        create_eager_task(trigger.async_setup(hass)),
     )
 
 
@@ -501,7 +479,7 @@ async def async_from_config_dict(
     core_config = config.get(core.DOMAIN, {})
 
     try:
-        await async_process_ha_core_config(hass, core_config)
+        await conf_util.async_process_ha_core_config(hass, core_config)
     except vol.Invalid as config_err:
         conf_util.async_log_schema_error(config_err, core.DOMAIN, core_config, hass)
         async_notify_setup_error(hass, core.DOMAIN)
@@ -536,7 +514,7 @@ async def async_from_config_dict(
         issue_registry.async_create_issue(
             hass,
             core.DOMAIN,
-            f"python_version_{required_python_version}",
+            "python_version",
             is_fixable=False,
             severity=issue_registry.IssueSeverity.WARNING,
             breaks_in_ha_version=REQUIRED_NEXT_PYTHON_HA_RELEASE,
@@ -568,7 +546,8 @@ async def async_enable_logging(
 
     if not log_no_color:
         try:
-            from colorlog import ColoredFormatter  # noqa: PLC0415
+            # pylint: disable-next=import-outside-toplevel
+            from colorlog import ColoredFormatter
 
             # basicConfig must be called after importing colorlog in order to
             # ensure that the handlers it sets up wraps the correct streams.
@@ -619,37 +598,34 @@ async def async_enable_logging(
         ),
     )
 
-    logger = logging.getLogger()
-    logger.setLevel(logging.INFO if verbose else logging.WARNING)
-
+    # Log errors to a file if we have write access to file or config dir
     if log_file is None:
-        default_log_path = hass.config.path(ERROR_LOG_FILENAME)
-        if "SUPERVISOR" in os.environ and "HA_DUPLICATE_LOG_FILE" not in os.environ:
-            # Rename the default log file if it exists, since previous versions created
-            # it even on Supervisor
-            def rename_old_file() -> None:
-                """Rename old log file in executor."""
-                if os.path.isfile(default_log_path):
-                    with contextlib.suppress(OSError):
-                        os.rename(default_log_path, f"{default_log_path}.old")
-
-            await hass.async_add_executor_job(rename_old_file)
-            err_log_path = None
-        else:
-            err_log_path = default_log_path
+        err_log_path = hass.config.path(ERROR_LOG_FILENAME)
     else:
         err_log_path = os.path.abspath(log_file)
 
-    if err_log_path:
+    err_path_exists = os.path.isfile(err_log_path)
+    err_dir = os.path.dirname(err_log_path)
+
+    # Check if we can write to the error log if it exists or that
+    # we can create files in the containing directory if not.
+    if (err_path_exists and os.access(err_log_path, os.W_OK)) or (
+        not err_path_exists and os.access(err_dir, os.W_OK)
+    ):
         err_handler = await hass.async_add_executor_job(
             _create_log_file, err_log_path, log_rotate_days
         )
 
         err_handler.setFormatter(logging.Formatter(fmt, datefmt=FORMAT_DATETIME))
+
+        logger = logging.getLogger()
         logger.addHandler(err_handler)
+        logger.setLevel(logging.INFO if verbose else logging.WARNING)
 
         # Save the log file location for access by other components.
         hass.data[DATA_LOGGING] = err_log_path
+    else:
+        _LOGGER.error("Unable to set up error log %s (access denied)", err_log_path)
 
     async_activate_log_queue_handler(hass)
 
@@ -667,10 +643,11 @@ def _create_log_file(
         err_handler = _RotatingFileHandlerWithoutShouldRollOver(
             err_log_path, backupCount=1
         )
-        try:
-            err_handler.doRollover()
-        except OSError as err:
-            _LOGGER.error("Error rolling over log file: %s", err)
+
+    try:
+        err_handler.doRollover()
+    except OSError as err:
+        _LOGGER.error("Error rolling over log file: %s", err)
 
     return err_handler
 
@@ -699,12 +676,13 @@ async def async_mount_local_lib_path(config_dir: str) -> str:
     return deps_dir
 
 
+@core.callback
 def _get_domains(hass: core.HomeAssistant, config: dict[str, Any]) -> set[str]:
     """Get domains of components to set up."""
-    # The common config section [homeassistant] could be filtered here,
-    # but that is not necessary, since it corresponds to the core integration,
-    # that is always unconditionally loaded.
-    domains = {cv.domain_key(key) for key in config}
+    # Filter out the repeating and common config section [homeassistant]
+    domains = {
+        domain for key in config if (domain := cv.domain_key(key)) != core.DOMAIN
+    }
 
     # Add config entry and default domains
     if not hass.config.recovery_mode:
@@ -720,251 +698,6 @@ def _get_domains(hass: core.HomeAssistant, config: dict[str, Any]) -> set[str]:
     return domains
 
 
-async def _async_resolve_domains_and_preload(
-    hass: core.HomeAssistant, config: dict[str, Any]
-) -> tuple[dict[str, Integration], dict[str, Integration]]:
-    """Resolve all dependencies and return integrations to set up.
-
-    The return value is a tuple of two dictionaries:
-    - The first dictionary contains integrations
-      specified by the configuration (including config entries).
-    - The second dictionary contains the same integrations as the first dictionary
-      together with all their dependencies.
-    """
-    domains_to_setup = _get_domains(hass, config)
-
-    # Also process all base platforms since we do not require the manifest
-    # to list them as dependencies.
-    # We want to later avoid lock contention when multiple integrations try to load
-    # their manifests at once.
-    #
-    # Additionally process integrations that are defined under base platforms
-    # to speed things up.
-    # For example if we have
-    # sensor:
-    #   - platform: template
-    #
-    # `template` has to be loaded to validate the config for sensor.
-    # The more platforms under `sensor:`, the longer
-    # it will take to finish setup for `sensor` because each of these
-    # platforms has to be imported before we can validate the config.
-    #
-    # Thankfully we are migrating away from the platform pattern
-    # so this will be less of a problem in the future.
-    platform_integrations = conf_util.extract_platform_integrations(
-        config, BASE_PLATFORMS
-    )
-    additional_domains_to_process = {
-        *BASE_PLATFORMS,
-        *chain.from_iterable(platform_integrations.values()),
-    }
-
-    # Resolve all dependencies so we know all integrations
-    # that will have to be loaded and start right-away
-    integrations_or_excs = await loader.async_get_integrations(
-        hass, {*domains_to_setup, *additional_domains_to_process}
-    )
-    # Eliminate those missing or with invalid manifest
-    integrations_to_process = {
-        domain: itg
-        for domain, itg in integrations_or_excs.items()
-        if isinstance(itg, Integration)
-    }
-    integrations_dependencies = await loader.resolve_integrations_dependencies(
-        hass, integrations_to_process.values()
-    )
-    # Eliminate those without valid dependencies
-    integrations_to_process = {
-        domain: integrations_to_process[domain] for domain in integrations_dependencies
-    }
-
-    integrations_to_setup = {
-        domain: itg
-        for domain, itg in integrations_to_process.items()
-        if domain in domains_to_setup
-    }
-    all_integrations_to_setup = integrations_to_setup.copy()
-    all_integrations_to_setup.update(
-        (dep, loader.async_get_loaded_integration(hass, dep))
-        for domain in integrations_to_setup
-        for dep in integrations_dependencies[domain].difference(
-            all_integrations_to_setup
-        )
-    )
-
-    # Gather requirements for all integrations,
-    # their dependencies and after dependencies.
-    # To gather all the requirements we must ignore exceptions here.
-    # The exceptions will be detected and handled later in the bootstrap process.
-    integrations_after_dependencies = (
-        await loader.resolve_integrations_after_dependencies(
-            hass, integrations_to_process.values(), ignore_exceptions=True
-        )
-    )
-    integrations_requirements = {
-        domain: itg.requirements for domain, itg in integrations_to_process.items()
-    }
-    integrations_requirements.update(
-        (dep, loader.async_get_loaded_integration(hass, dep).requirements)
-        for deps in integrations_after_dependencies.values()
-        for dep in deps.difference(integrations_requirements)
-    )
-    all_requirements = set(chain.from_iterable(integrations_requirements.values()))
-
-    # Optimistically check if requirements are already installed
-    # ahead of setting up the integrations so we can prime the cache
-    # We do not wait for this since it's an optimization only
-    hass.async_create_background_task(
-        requirements.async_load_installed_versions(hass, all_requirements),
-        "check installed requirements",
-        eager_start=True,
-    )
-
-    # Start loading translations for all integrations we are going to set up
-    # in the background so they are ready when we need them. This avoids a
-    # lot of waiting for the translation load lock and a thundering herd of
-    # tasks trying to load the same translations at the same time as each
-    # integration is loaded.
-    #
-    # We do not wait for this since as soon as the task runs it will
-    # hold the translation load lock and if anything is fast enough to
-    # wait for the translation load lock, loading will be done by the
-    # time it gets to it.
-    translations_to_load = {*all_integrations_to_setup, *additional_domains_to_process}
-    hass.async_create_background_task(
-        translation.async_load_integrations(hass, translations_to_load),
-        "load translations",
-        eager_start=True,
-    )
-
-    # Preload storage for all integrations we are going to set up
-    # so we do not have to wait for it to be loaded when we need it
-    # in the setup process.
-    hass.async_create_background_task(
-        get_internal_store_manager(hass).async_preload(
-            [*PRELOAD_STORAGE, *all_integrations_to_setup]
-        ),
-        "preload storage",
-        eager_start=True,
-    )
-
-    return integrations_to_setup, all_integrations_to_setup
-
-
-async def _async_set_up_integrations(
-    hass: core.HomeAssistant, config: dict[str, Any]
-) -> None:
-    """Set up all the integrations."""
-    watcher = _WatchPendingSetups(hass, _setup_started(hass))
-    watcher.async_start()
-
-    integrations, all_integrations = await _async_resolve_domains_and_preload(
-        hass, config
-    )
-    # Detect all cycles
-    integrations_after_dependencies = (
-        await loader.resolve_integrations_after_dependencies(
-            hass, all_integrations.values(), set(all_integrations)
-        )
-    )
-    all_domains = set(integrations_after_dependencies)
-    domains = set(integrations) & all_domains
-
-    _LOGGER.info(
-        "Domains to be set up: %s\nDependencies: %s",
-        domains or "{}",
-        (all_domains - domains) or "{}",
-    )
-
-    async_set_domains_to_be_loaded(hass, all_domains)
-
-    # Initialize recorder
-    if "recorder" in all_domains:
-        recorder.async_initialize_recorder(hass)
-
-    stages: list[tuple[str, set[str], int | None]] = [
-        *(
-            (name, domain_group, timeout)
-            for name, domain_group, timeout in STAGE_0_INTEGRATIONS
-        ),
-        ("1", STAGE_1_INTEGRATIONS, STAGE_1_TIMEOUT),
-        ("2", domains, STAGE_2_TIMEOUT),
-    ]
-
-    _LOGGER.info("Setting up stage 0")
-    for name, domain_group, timeout in stages:
-        stage_domains_unfiltered = domain_group & all_domains
-        if not stage_domains_unfiltered:
-            _LOGGER.info("Nothing to set up in stage %s: %s", name, domain_group)
-            continue
-
-        stage_domains = stage_domains_unfiltered - hass.config.components
-        if not stage_domains:
-            _LOGGER.info("Already set up stage %s: %s", name, stage_domains_unfiltered)
-            continue
-
-        stage_dep_domains_unfiltered = {
-            dep
-            for domain in stage_domains
-            for dep in integrations_after_dependencies[domain]
-            if dep not in stage_domains
-        }
-        stage_dep_domains = stage_dep_domains_unfiltered - hass.config.components
-
-        stage_all_domains = stage_domains | stage_dep_domains
-
-        _LOGGER.info(
-            "Setting up stage %s: %s; already set up: %s\n"
-            "Dependencies: %s; already set up: %s",
-            name,
-            stage_domains,
-            (stage_domains_unfiltered - stage_domains) or "{}",
-            stage_dep_domains or "{}",
-            (stage_dep_domains_unfiltered - stage_dep_domains) or "{}",
-        )
-
-        if timeout is None:
-            await _async_setup_multi_components(hass, stage_all_domains, config)
-            continue
-        try:
-            async with hass.timeout.async_timeout(
-                timeout,
-                cool_down=COOLDOWN_TIME,
-                cancel_message=f"Bootstrap stage {name} timeout",
-            ):
-                await _async_setup_multi_components(hass, stage_all_domains, config)
-        except TimeoutError:
-            _LOGGER.warning(
-                "Setup timed out for stage %s waiting on %s - moving forward",
-                name,
-                hass._active_tasks,  # noqa: SLF001
-            )
-
-    # Wrap up startup
-    _LOGGER.debug("Waiting for startup to wrap up")
-    try:
-        async with hass.timeout.async_timeout(
-            WRAP_UP_TIMEOUT,
-            cool_down=COOLDOWN_TIME,
-            cancel_message="Bootstrap startup wrap up timeout",
-        ):
-            await hass.async_block_till_done()
-    except TimeoutError:
-        _LOGGER.warning(
-            "Setup timed out for bootstrap waiting on %s - moving forward",
-            hass._active_tasks,  # noqa: SLF001
-        )
-
-    watcher.async_stop()
-
-    if _LOGGER.isEnabledFor(logging.DEBUG):
-        setup_time = async_get_setup_timings(hass)
-        _LOGGER.debug(
-            "Integration setup times: %s",
-            dict(sorted(setup_time.items(), key=itemgetter(1), reverse=True)),
-        )
-
-
 class _WatchPendingSetups:
     """Periodic log and dispatch of setups that are pending."""
 
@@ -1003,7 +736,7 @@ class _WatchPendingSetups:
             # We log every LOG_SLOW_STARTUP_INTERVAL until all integrations are done
             # once we take over LOG_SLOW_STARTUP_INTERVAL (60s) to start up
             _LOGGER.warning(
-                "Waiting for integrations to complete setup: %s",
+                "Waiting on integrations to complete setup: %s",
                 self._setup_started,
             )
 
@@ -1036,12 +769,14 @@ class _WatchPendingSetups:
             self._handle = None
 
 
-async def _async_setup_multi_components(
+async def async_setup_multi_components(
     hass: core.HomeAssistant,
     domains: set[str],
     config: dict[str, Any],
 ) -> None:
     """Set up multiple domains. Log on failure."""
+    # Avoid creating tasks for domains that were setup in a previous stage
+    domains_not_yet_setup = domains - hass.config.components
     # Create setup tasks for base platforms first since everything will have
     # to wait to be imported, and the sooner we can get the base platforms
     # loaded the sooner we can start loading the rest of the integrations.
@@ -1051,7 +786,9 @@ async def _async_setup_multi_components(
             f"setup component {domain}",
             eager_start=True,
         )
-        for domain in sorted(domains, key=SETUP_ORDER_SORT_KEY, reverse=True)
+        for domain in sorted(
+            domains_not_yet_setup, key=SETUP_ORDER_SORT_KEY, reverse=True
+        )
     }
     results = await asyncio.gather(*futures.values(), return_exceptions=True)
     for idx, domain in enumerate(futures):
@@ -1062,3 +799,278 @@ async def _async_setup_multi_components(
                 domain,
                 exc_info=(type(result), result, result.__traceback__),
             )
+
+
+async def _async_resolve_domains_to_setup(
+    hass: core.HomeAssistant, config: dict[str, Any]
+) -> tuple[set[str], dict[str, loader.Integration]]:
+    """Resolve all dependencies and return list of domains to set up."""
+    domains_to_setup = _get_domains(hass, config)
+    needed_requirements: set[str] = set()
+    platform_integrations = conf_util.extract_platform_integrations(
+        config, BASE_PLATFORMS
+    )
+    # Ensure base platforms that have platform integrations are added to
+    # to `domains_to_setup so they can be setup first instead of
+    # discovering them when later when a config entry setup task
+    # notices its needed and there is already a long line to use
+    # the import executor.
+    #
+    # For example if we have
+    # sensor:
+    #   - platform: template
+    #
+    # `template` has to be loaded to validate the config for sensor
+    # so we want to start loading `sensor` as soon as we know
+    # it will be needed. The more platforms under `sensor:`, the longer
+    # it will take to finish setup for `sensor` because each of these
+    # platforms has to be imported before we can validate the config.
+    #
+    # Thankfully we are migrating away from the platform pattern
+    # so this will be less of a problem in the future.
+    domains_to_setup.update(platform_integrations)
+
+    # Load manifests for base platforms and platform based integrations
+    # that are defined under base platforms right away since we do not require
+    # the manifest to list them as dependencies and we want to avoid the lock
+    # contention when multiple integrations try to load them at once
+    additional_manifests_to_load = {
+        *BASE_PLATFORMS,
+        *chain.from_iterable(platform_integrations.values()),
+    }
+
+    translations_to_load = additional_manifests_to_load.copy()
+
+    # Resolve all dependencies so we know all integrations
+    # that will have to be loaded and start right-away
+    integration_cache: dict[str, loader.Integration] = {}
+    to_resolve: set[str] = domains_to_setup
+    while to_resolve or additional_manifests_to_load:
+        old_to_resolve: set[str] = to_resolve
+        to_resolve = set()
+
+        if additional_manifests_to_load:
+            to_get = {*old_to_resolve, *additional_manifests_to_load}
+            additional_manifests_to_load.clear()
+        else:
+            to_get = old_to_resolve
+
+        manifest_deps: set[str] = set()
+        resolve_dependencies_tasks: list[asyncio.Task[bool]] = []
+        integrations_to_process: list[loader.Integration] = []
+
+        for domain, itg in (await loader.async_get_integrations(hass, to_get)).items():
+            if not isinstance(itg, loader.Integration):
+                continue
+            integration_cache[domain] = itg
+            needed_requirements.update(itg.requirements)
+
+            # Make sure manifests for dependencies are loaded in the next
+            # loop to try to group as many as manifest loads in a single
+            # call to avoid the creating one-off executor jobs later in
+            # the setup process
+            additional_manifests_to_load.update(
+                dep
+                for dep in chain(itg.dependencies, itg.after_dependencies)
+                if dep not in integration_cache
+            )
+
+            if domain not in old_to_resolve:
+                continue
+
+            integrations_to_process.append(itg)
+            manifest_deps.update(itg.dependencies)
+            manifest_deps.update(itg.after_dependencies)
+            if not itg.all_dependencies_resolved:
+                resolve_dependencies_tasks.append(
+                    create_eager_task(
+                        itg.resolve_dependencies(),
+                        name=f"resolve dependencies {domain}",
+                        loop=hass.loop,
+                    )
+                )
+
+        if unseen_deps := manifest_deps - integration_cache.keys():
+            # If there are dependencies, try to preload all
+            # the integrations manifest at once and add them
+            # to the list of requirements we need to install
+            # so we can try to check if they are already installed
+            # in a single call below which avoids each integration
+            # having to wait for the lock to do it individually
+            deps = await loader.async_get_integrations(hass, unseen_deps)
+            for dependant_domain, dependant_itg in deps.items():
+                if isinstance(dependant_itg, loader.Integration):
+                    integration_cache[dependant_domain] = dependant_itg
+                    needed_requirements.update(dependant_itg.requirements)
+
+        if resolve_dependencies_tasks:
+            await asyncio.gather(*resolve_dependencies_tasks)
+
+        for itg in integrations_to_process:
+            try:
+                all_deps = itg.all_dependencies
+            except RuntimeError:
+                # Integration.all_dependencies raises RuntimeError if
+                # dependencies could not be resolved
+                continue
+            for dep in all_deps:
+                if dep in domains_to_setup:
+                    continue
+                domains_to_setup.add(dep)
+                to_resolve.add(dep)
+
+    _LOGGER.info("Domains to be set up: %s", domains_to_setup)
+
+    # Optimistically check if requirements are already installed
+    # ahead of setting up the integrations so we can prime the cache
+    # We do not wait for this since its an optimization only
+    hass.async_create_background_task(
+        requirements.async_load_installed_versions(hass, needed_requirements),
+        "check installed requirements",
+        eager_start=True,
+    )
+
+    #
+    # Only add the domains_to_setup after we finish resolving
+    # as new domains are likely to added in the process
+    #
+    translations_to_load.update(domains_to_setup)
+    # Start loading translations for all integrations we are going to set up
+    # in the background so they are ready when we need them. This avoids a
+    # lot of waiting for the translation load lock and a thundering herd of
+    # tasks trying to load the same translations at the same time as each
+    # integration is loaded.
+    #
+    # We do not wait for this since as soon as the task runs it will
+    # hold the translation load lock and if anything is fast enough to
+    # wait for the translation load lock, loading will be done by the
+    # time it gets to it.
+    hass.async_create_background_task(
+        translation.async_load_integrations(hass, translations_to_load),
+        "load translations",
+        eager_start=True,
+    )
+
+    # Preload storage for all integrations we are going to set up
+    # so we do not have to wait for it to be loaded when we need it
+    # in the setup process.
+    hass.async_create_background_task(
+        get_internal_store_manager(hass).async_preload(
+            [*PRELOAD_STORAGE, *domains_to_setup]
+        ),
+        "preload storage",
+        eager_start=True,
+    )
+
+    return domains_to_setup, integration_cache
+
+
+async def _async_set_up_integrations(
+    hass: core.HomeAssistant, config: dict[str, Any]
+) -> None:
+    """Set up all the integrations."""
+    watcher = _WatchPendingSetups(hass, _setup_started(hass))
+    watcher.async_start()
+
+    domains_to_setup, integration_cache = await _async_resolve_domains_to_setup(
+        hass, config
+    )
+
+    # Initialize recorder
+    if "recorder" in domains_to_setup:
+        recorder.async_initialize_recorder(hass)
+
+    pre_stage_domains = [
+        (name, domains_to_setup & domain_group) for name, domain_group in SETUP_ORDER
+    ]
+
+    # calculate what components to setup in what stage
+    stage_1_domains: set[str] = set()
+
+    # Find all dependencies of any dependency of any stage 1 integration that
+    # we plan on loading and promote them to stage 1. This is done only to not
+    # get misleading log messages
+    deps_promotion: set[str] = STAGE_1_INTEGRATIONS
+    while deps_promotion:
+        old_deps_promotion = deps_promotion
+        deps_promotion = set()
+
+        for domain in old_deps_promotion:
+            if domain not in domains_to_setup or domain in stage_1_domains:
+                continue
+
+            stage_1_domains.add(domain)
+
+            if (dep_itg := integration_cache.get(domain)) is None:
+                continue
+
+            deps_promotion.update(dep_itg.all_dependencies)
+
+    stage_2_domains = domains_to_setup - stage_1_domains
+
+    for name, domain_group in pre_stage_domains:
+        if domain_group:
+            stage_2_domains -= domain_group
+            _LOGGER.info("Setting up %s: %s", name, domain_group)
+            to_be_loaded = domain_group.copy()
+            to_be_loaded.update(
+                dep
+                for domain in domain_group
+                if (integration := integration_cache.get(domain)) is not None
+                for dep in integration.all_dependencies
+            )
+            async_set_domains_to_be_loaded(hass, to_be_loaded)
+            await async_setup_multi_components(hass, domain_group, config)
+
+    # Enables after dependencies when setting up stage 1 domains
+    async_set_domains_to_be_loaded(hass, stage_1_domains)
+
+    # Start setup
+    if stage_1_domains:
+        _LOGGER.info("Setting up stage 1: %s", stage_1_domains)
+        try:
+            async with hass.timeout.async_timeout(
+                STAGE_1_TIMEOUT, cool_down=COOLDOWN_TIME
+            ):
+                await async_setup_multi_components(hass, stage_1_domains, config)
+        except TimeoutError:
+            _LOGGER.warning(
+                "Setup timed out for stage 1 waiting on %s - moving forward",
+                hass._active_tasks,  # noqa: SLF001
+            )
+
+    # Add after dependencies when setting up stage 2 domains
+    async_set_domains_to_be_loaded(hass, stage_2_domains)
+
+    if stage_2_domains:
+        _LOGGER.info("Setting up stage 2: %s", stage_2_domains)
+        try:
+            async with hass.timeout.async_timeout(
+                STAGE_2_TIMEOUT, cool_down=COOLDOWN_TIME
+            ):
+                await async_setup_multi_components(hass, stage_2_domains, config)
+        except TimeoutError:
+            _LOGGER.warning(
+                "Setup timed out for stage 2 waiting on %s - moving forward",
+                hass._active_tasks,  # noqa: SLF001
+            )
+
+    # Wrap up startup
+    _LOGGER.debug("Waiting for startup to wrap up")
+    try:
+        async with hass.timeout.async_timeout(WRAP_UP_TIMEOUT, cool_down=COOLDOWN_TIME):
+            await hass.async_block_till_done()
+    except TimeoutError:
+        _LOGGER.warning(
+            "Setup timed out for bootstrap waiting on %s - moving forward",
+            hass._active_tasks,  # noqa: SLF001
+        )
+
+    watcher.async_stop()
+
+    if _LOGGER.isEnabledFor(logging.DEBUG):
+        setup_time = async_get_setup_timings(hass)
+        _LOGGER.debug(
+            "Integration setup times: %s",
+            dict(sorted(setup_time.items(), key=itemgetter(1), reverse=True)),
+        )

homeassistant/brands/amazon.json

@@ -1,13 +1,5 @@
 {
   "domain": "amazon",
   "name": "Amazon",
-  "integrations": [
-    "alexa",
-    "alexa_devices",
-    "amazon_polly",
-    "aws",
-    "aws_s3",
-    "fire_tv",
-    "route53"
-  ]
+  "integrations": ["alexa", "amazon_polly", "aws", "fire_tv", "route53"]
 }

homeassistant/brands/aqara.json

@@ -1,5 +0,0 @@
-{
-  "domain": "aqara",
-  "name": "Aqara",
-  "iot_standards": ["matter", "zigbee"]
-}

homeassistant/brands/bosch.json

@@ -1,5 +0,0 @@
-{
-  "domain": "bosch",
-  "name": "Bosch",
-  "integrations": ["bosch_alarm", "bosch_shc", "home_connect"]
-}

homeassistant/brands/eltako.json

@@ -1,5 +0,0 @@
-{
-  "domain": "eltako",
-  "name": "Eltako",
-  "iot_standards": ["matter"]
-}

homeassistant/brands/eve.json

@@ -1,5 +0,0 @@
-{
-  "domain": "eve",
-  "name": "Eve",
-  "iot_standards": ["matter"]
-}

homeassistant/brands/frient.json

@@ -1,5 +0,0 @@
-{
-  "domain": "frient",
-  "name": "Frient",
-  "iot_standards": ["zigbee"]
-}

homeassistant/brands/fritzbox.json

@@ -1,5 +1,5 @@
 {
   "domain": "fritzbox",
-  "name": "FRITZ!",
+  "name": "FRITZ!Box",
   "integrations": ["fritz", "fritzbox", "fritzbox_callmonitor"]
 }

homeassistant/brands/google.json

@@ -2,11 +2,10 @@
   "domain": "google",
   "name": "Google",
   "integrations": [
-    "google_air_quality",
     "google_assistant",
     "google_assistant_sdk",
     "google_cloud",
-    "google_drive",
+    "google_domains",
     "google_generative_ai_conversation",
     "google_mail",
     "google_maps",
@@ -16,7 +15,6 @@
     "google_tasks",
     "google_translate",
     "google_travel_time",
-    "google_weather",
     "google_wifi",
     "google",
     "nest",

homeassistant/brands/husqvarna.json

@@ -1,5 +0,0 @@
-{
-  "domain": "husqvarna",
-  "name": "Husqvarna",
-  "integrations": ["husqvarna_automower", "husqvarna_automower_ble"]
-}

homeassistant/brands/ibm.json

@@ -0,0 +1,5 @@
+{
+  "domain": "ibm",
+  "name": "IBM",
+  "integrations": ["watson_iot", "watson_tts"]
+}

homeassistant/brands/konnected.json

@@ -1,5 +0,0 @@
-{
-  "domain": "konnected",
-  "name": "Konnected",
-  "integrations": ["konnected", "konnected_esphome"]
-}

homeassistant/brands/level.json

@@ -1,5 +0,0 @@
-{
-  "domain": "level",
-  "name": "Level",
-  "iot_standards": ["matter"]
-}

homeassistant/brands/lg.json

@@ -1,5 +1,5 @@
 {
   "domain": "lg",
   "name": "LG",
-  "integrations": ["lg_netcast", "lg_soundbar", "lg_thinq", "webostv"]
+  "integrations": ["lg_netcast", "lg_thinq", "lg_soundbar", "webostv"]
 }

homeassistant/brands/microsoft.json

@@ -2,17 +2,14 @@
   "domain": "microsoft",
   "name": "Microsoft",
   "integrations": [
-    "azure_data_explorer",
     "azure_devops",
     "azure_event_hub",
     "azure_service_bus",
-    "azure_storage",
     "microsoft_face_detect",
     "microsoft_face_identify",
     "microsoft_face",
     "microsoft",
     "msteams",
-    "onedrive",
     "xbox"
   ]
 }

homeassistant/brands/motionblinds.json

@@ -1,6 +1,5 @@
 {
   "domain": "motionblinds",
   "name": "Motionblinds",
-  "integrations": ["motion_blinds", "motionblinds_ble"],
-  "iot_standards": ["matter"]
+  "integrations": ["motion_blinds", "motionblinds_ble"]
 }

homeassistant/brands/nuki.json

@@ -1,6 +0,0 @@
-{
-  "domain": "nuki",
-  "name": "Nuki",
-  "integrations": ["nuki"],
-  "iot_standards": ["matter"]
-}

homeassistant/brands/philips.json

@@ -1,5 +1,5 @@
 {
   "domain": "philips",
   "name": "Philips",
-  "integrations": ["dynalite", "hue", "hue_ble", "philips_js"]
+  "integrations": ["dynalite", "hue", "philips_js"]
 }

homeassistant/brands/raspberry_pi.json

@@ -1,5 +1,5 @@
 {
   "domain": "raspberry_pi",
   "name": "Raspberry Pi",
-  "integrations": ["raspberry_pi", "rpi_power", "remote_rpi_gpio"]
+  "integrations": ["raspberry_pi", "rpi_camera", "rpi_power", "remote_rpi_gpio"]
 }

homeassistant/brands/sensorpush.json

@@ -1,5 +0,0 @@
-{
-  "domain": "sensorpush",
-  "name": "SensorPush",
-  "integrations": ["sensorpush", "sensorpush_cloud"]
-}

homeassistant/brands/shelly.json

@@ -1,6 +0,0 @@
-{
-  "domain": "shelly",
-  "name": "shelly",
-  "integrations": ["shelly"],
-  "iot_standards": ["zwave"]
-}

homeassistant/brands/sky.json

@@ -1,5 +0,0 @@
-{
-  "domain": "sky",
-  "name": "Sky",
-  "integrations": ["sky_hub", "sky_remote"]
-}

homeassistant/brands/slide.json

@@ -1,5 +0,0 @@
-{
-  "domain": "slide",
-  "name": "Slide",
-  "integrations": ["slide", "slide_local"]
-}

homeassistant/brands/sony.json

@@ -1,11 +1,5 @@
 {
   "domain": "sony",
   "name": "Sony",
-  "integrations": [
-    "braviatv",
-    "ps4",
-    "sony_projector",
-    "songpal",
-    "playstation_network"
-  ]
+  "integrations": ["braviatv", "ps4", "sony_projector", "songpal"]
 }

homeassistant/brands/switchbot.json

@@ -1,6 +1,5 @@
 {
   "domain": "switchbot",
   "name": "SwitchBot",
-  "integrations": ["switchbot", "switchbot_cloud"],
-  "iot_standards": ["matter"]
+  "integrations": ["switchbot", "switchbot_cloud"]
 }

homeassistant/brands/third_reality.json

@@ -1,5 +1,5 @@
 {
   "domain": "third_reality",
   "name": "Third Reality",
-  "iot_standards": ["matter", "zigbee"]
+  "iot_standards": ["zigbee"]
 }

homeassistant/brands/tilt.json

@@ -1,5 +0,0 @@
-{
-  "domain": "tilt",
-  "name": "Tilt",
-  "integrations": ["tilt_ble", "tilt_pi"]
-}

homeassistant/brands/ubiquiti.json

@@ -1,5 +1,5 @@
 {
   "domain": "ubiquiti",
   "name": "Ubiquiti",
-  "integrations": ["airos", "unifi", "unifi_direct", "unifiled", "unifiprotect"]
+  "integrations": ["unifi", "unifi_direct", "unifiled", "unifiprotect"]
 }

homeassistant/brands/victron.json

@@ -1,5 +0,0 @@
-{
-  "domain": "victron",
-  "name": "Victron",
-  "integrations": ["victron_ble", "victron_remote_monitoring"]
-}

homeassistant/brands/yale.json

@@ -1,5 +1,11 @@
 {
   "domain": "yale",
-  "name": "Yale (non-US/Canada)",
-  "integrations": ["yale", "yalexs_ble", "yale_smart_alarm"]
+  "name": "Yale",
+  "integrations": [
+    "august",
+    "yale_smart_alarm",
+    "yalexs_ble",
+    "yale_home",
+    "yale"
+  ]
 }