logger:
  default: warning
  logs:
    custom_components.{domain}: debug
    homeassistant.config_entries: debug

# Check 1: Are relative imports correct?
from .const import DOMAIN  # RIGHT
from custom_components.my_integration.const import DOMAIN  # WRONG in package context

# Check 2: Is manifest.json requirements correct?
# "requirements": ["my-library==1.0.0"]

# Check 3: Does __init__.py exist in the integration folder?

# Check: Is errors dict initialized?
async def async_step_user(self, user_input=None):
    errors: dict[str, str] = {}  # Must exist!

# Check: Are all strings.json keys present for every error?
# Every errors["base"] = "key" must have a matching entry in strings.json

# Check: Does the domain match everywhere?
# manifest.json domain == const.py DOMAIN == config_flow.py ConfigFlow(domain=DOMAIN)

# Check 1: Is _async_update_data raising UpdateFailed?
async def _async_update_data(self):
    try:
        return await self.client.get_data()
    except Exception as err:
        raise UpdateFailed(f"Error: {err}") from err  # This marks entities unavailable

# Check 2: Is the entity's available property too restrictive?
@property
def available(self) -> bool:
    return super().available and self._device_id in self.coordinator.data

# Check 3: Did async_config_entry_first_refresh() succeed?
# If it fails, ConfigEntryNotReady is raised and setup retries

# Check 1: Is the platform in the PLATFORMS list?
PLATFORMS = [Platform.SENSOR, Platform.SWITCH]  # Must include your platform

# Check 2: Is async_forward_entry_setups called?
await hass.config_entries.async_forward_entry_setups(entry, PLATFORMS)

# Check 3: Does async_setup_entry call async_add_entities?
async def async_setup_entry(hass, entry, async_add_entities):
    entities = [MySensor(coordinator, "temp")]
    async_add_entities(entities)  # Must be called!

# Check 4: Is the entity list empty due to data filtering?
# If you filter entities based on data, check that data contains expected keys

# Find the sync call and wrap it:
# WRONG
data = requests.get(url)

# RIGHT
data = await hass.async_add_executor_job(requests.get, url)

# Check: Does entity inherit CoordinatorEntity FIRST?
class MySensor(CoordinatorEntity[MyCoordinator], SensorEntity):  # Correct order!

# Check: Is super().__init__(coordinator) called?
def __init__(self, coordinator):
    super().__init__(coordinator)  # Required!

# Check: Does native_value read from self.coordinator.data?
@property
def native_value(self):
    return self.coordinator.data.get("value")  # Must use coordinator.data

# Validate JSON files
python -c "import json; json.load(open('manifest.json')); print('OK')"
python -c "import json; json.load(open('strings.json')); print('OK')"

# Check Python syntax
python -m py_compile __init__.py
python -m py_compile config_flow.py

# Run linter
ruff check .

# Type check
mypy .

# View config entries storage
cat config/.storage/core.config_entries | python -m json.tool | grep -A 20 '{domain}'

# Check if integration loaded
grep '{domain}' config/home-assistant.log | tail -20