Home Assistant Quality Scale Audit This document provides a comprehensive audit of the AutoArm integration against the Home Assistant Integration Quality Scale .
Audit Date: February 2026 Integration Version: 1.0.0 Auditor: Automated analysis
Summary Tier Done Exempt Todo Total Bronze 16 3 0 19 Silver 7 4 0 11 Gold 10 7 4 21 Platinum 1 1 1 3 Total 34 15 5 54
Current Tier Achievement: Silver (with most Gold requirements met)
Path to Gold: Complete entity-category, entity-device-class, entity-translations, and icon-translations rules (requires refactoring to entity classes).
Bronze Tier The Bronze tier represents the baseline standard for all integrations.
Completed Rules Rule Status Notes action-setupDone Services registered in async_setup (autoarming.py) brandsDone Brand assets submitted and approved in the HA brands repository common-modulesDone Logic separated into const.py, helpers.py, hass_api.py, calendar.py config-flowDone UI config flow for alarm panel, calendars, persons, and occupancy defaults config-flow-test-coverageDone Config flow and options flow covered by tests dependency-transparencyDone All dependencies are standard HA components declared in manifest.json docs-actionsDone Services documented in services.yaml and README docs-high-level-descriptionDone Clear overview in README.md docs-installation-instructionsDone HACS installation documented docs-removal-instructionsDone Removal instructions in docs/removal.md entity-event-setupDone Events subscribed in initialize_* methods using proper HA tracking functions runtime-dataDone Uses HassKey[AutoArmData] for typed runtime data storage test-before-configureDone Config flow validates entity selections; YAML validated via voluptuous test-before-setupDone Validates config via voluptuous schemas; ConfigEntryNotReady on init failure; raises repair issues for invalid transitions unique-config-entryDone Unique ID set to domain; _abort_if_unique_id_configured() prevents duplicates
Exempt Rules Rule Status Reason appropriate-pollingExempt Event-driven integration; calendar polling is configurable entity-unique-idExempt Uses fixed entity IDs for integration-scoped singletons has-entity-nameExempt Entities created via async_set, not entity classes
Silver Tier The Silver tier focuses on reliability and robustness.
Completed Rules Rule Status Notes action-exceptionsDone Service handlers raise HomeAssistantError on failure config-entry-unloadingDone shutdown() method properly cleans up all listeners docs-configuration-parametersDone Parameters documented in automated_arming.md and examples entity-unavailableDone Entities initialized to "unavailable" when appropriate integration-ownerDone @jeyrb declared as code owner log-when-unavailableDone Consistent "AUTOARM" prefix; appropriate log levels test-coverageDone Test coverage >90% with --cov-fail-under=90 enforced
Exempt Rules Rule Status Reason docs-installation-parametersExempt Config flow parameters are self-descriptive entity selectors parallel-updatesExempt No parallel device polling reauthentication-flowExempt No authentication required
Gold Tier The Gold tier represents best-in-class user experience.
Completed Rules Rule Status Notes diagnosticsDone diagnostics.py exposes entry data, options, YAML keys, and armer state docs-data-updateDone Update mechanisms documented (events, polling, manual triggers) docs-examplesDone Example configs in docs/configuration/examples/ docs-known-limitationsDone Limitations documented in docs/known_limitations.md docs-supported-functionsDone All features documented in README and automated_arming.md docs-troubleshootingDone Troubleshooting guide in docs/troubleshooting.md docs-use-casesDone Use cases illustrated in "Why use alarm control panels?" section exception-translationsDone Issue messages use translation keys with placeholders reconfiguration-flowDone Options flow allows reconfiguring calendars, persons, occupancy defaults, and no-event mode repair-issuesDone Raises repair issues for invalid transition conditions
Exempt Rules Rule Status Reason devicesExempt Orchestrates existing entities; doesn't represent physical devices discoveryExempt User-configured entities; nothing to discover discovery-update-infoExempt No discovery docs-supported-devicesExempt Works with any compatible HA entities dynamic-devicesExempt No device registry usage entity-disabled-by-defaultExempt All entities are essential stale-devicesExempt No device registry usage
Todo Rules Rule Status Action Required entity-categoryTodo Add EntityCategory if refactored to entity classes entity-device-classTodo Add device classes (e.g., diagnostic for initialized sensor) entity-translationsTodo Refactor to use translation keys for entity names icon-translationsTodo Implement icon translations
Platinum Tier The Platinum tier represents technical excellence.
Completed Rules Rule Status Notes async-dependencyDone No external dependencies; fully async using HA APIs
Exempt Rules Rule Status Reason inject-websessionExempt No external HTTP calls
In Progress Rule Status Notes strict-typingIn Progress py.typed marker present; some Any types remain due to HA ConfigType patterns
Remaining Work Gold Tier (requires entity class refactoring) These four rules all require migrating from hass.states.async_set() to proper HA entity classes:
entity-categoryEntityCategory.DIAGNOSTIC to status sensorsentity-device-classentity-translationsicon-translations Platinum Tier strict-typingAny types where possible Code Quality Notes Strengths Clean separation of concerns across modules Comprehensive error tracking via failures counter and repair issues Rate limiting prevents arming loops Proper async/await throughout Good test coverage (>90%) for core functionality Consistent logging with "AUTOARM" prefix Support for graceful shutdown and reload Diagnostics support for debugging Areas for Improvement Some methods in autoarming.py are lengthy and could be refactored A few Any type hints remain that could be more specific Entities use async_set directly rather than entity classes References February 17, 2026 February 17, 2026