# Appendix A — Glossary

Terms as used throughout this report series. Where Home Assistant assigns a term a specific
technical meaning, that meaning is used.

| Term | Definition |
|------|------------|
| **ADR** | Architecture Decision Record; numbered documents in `home-assistant/architecture` recording accepted core design decisions (e.g., ADR-0010 config-flow requirement, ADR-0011 library-first protocol code). |
| **Analytics (opt-in)** | Home Assistant's voluntary telemetry (`analytics.home-assistant.io`); source of install-base figures. Known opt-in bias documented in report 01. |
| **Assist** | Home Assistant's local voice assistant stack: pipelines composing wake word, STT, intent handling (including LLM conversation agents via the Assist API), and TTS. |
| **Availability (entity)** | Whether an entity reports itself reachable; correct handling (marking entities unavailable on device loss) is a quality-scale rule and a top issue class in report 04. |
| **Bronze / Silver / Gold / Platinum** | Tiers of the revamped integration quality scale. Roughly: Bronze = correct modern foundations (config flow, tests for flows, proper setup); Silver = robust runtime behavior (reauth, availability, logging discipline); Gold = polished UX and documentation completeness; Platinum = engineering excellence (full strict typing incl. upstream library, full async, websession injection). |
| **Codemod** | Automated, AST-level source transformation applied across many files/repos; proposed in P6 for mechanical migrations. |
| **Code owner** | Maintainer(s) listed in an integration's `manifest.json`; auto-requested on PRs and issues for that integration. |
| **Config entry** | The stored configuration instance created by a config flow; the modern unit of integration setup. |
| **Config flow** | UI-driven setup/configuration wizard for an integration, replacing YAML configuration (ADR-0010). |
| **Core** | The `home-assistant/core` repository: the Python application plus all built-in integrations. |
| **Deprecation sweep** | Core's rolling removal of deprecated APIs/patterns after a published grace window (typically six months); a steady generator of breakage in unmaintained integrations. |
| **Diagnostics** | Per-integration downloadable debug data (redacted) used in issue reports; a quality-scale rule. |
| **Entity translations** | Localizable entity names/attributes via `strings.json`; paired with `has_entity_name` naming. |
| **HACS** | Home Assistant Community Store; distribution channel for third-party (non-core) integrations. Out of scope for this report's triage, which covers core integrations only. |
| **hassfest** | Core's CI validation tool enforcing manifest, quality-scale, and structural rules on integrations. |
| **has_entity_name** | Entity-naming convention where the entity name composes from device name + entity-specific name; required for scaled integrations. |
| **Impact-per-effort** | This report's ranking key: weighted impact score divided by effort rating (report 06 §06.2). |
| **Integration** | A component connecting Home Assistant to a device, service, or providing a capability; ~thousands exist in core, distribution analyzed in report 03. |
| **Install base / rank** | Number (or rank) of analytics-reporting installations with a given integration configured. |
| **Library-first (ADR-0011)** | Requirement that device/service protocol logic live in a published PyPI library rather than inside the integration. |
| **Manifest (`manifest.json`)** | Per-integration metadata: domain, dependencies, code owners, IoT class, quality scale tier. |
| **Month of "What the Heck?!" (WTH)** | Periodic community feedback round collecting friction reports; used in report 05 as an unabsorbed-demand signal. |
| **Open Home Foundation (OHF)** | Non-profit owning Home Assistant and sibling projects since 2024; charter values privacy, choice, sustainability. |
| **Quality scale** | The per-integration rating system (see Bronze…Platinum); operationalized as named rules tracked in each integration's `quality_scale.yaml`. |
| **Quality-scale rule** | An individually named, checkable requirement (e.g., `reauthentication-flow`, `runtime-data`, `entity-unavailable`); tiers are defined as rule sets. |
| **Reauthentication flow** | Config-flow path letting users re-enter expired credentials instead of the integration silently failing; Silver-tier rule and a major issue class in report 04. |
| **Repair issue** | In-app, user-visible actionable notification about a problem (e.g., deprecated config); core's mechanism for surfacing fixable states. |
| **`runtime_data`** | Typed attribute on `ConfigEntry` for an integration's runtime objects, replacing untyped `hass.data[DOMAIN]` storage. |
| **Strict typing (`.strict-typing`)** | Allowlist in core of modules checked under mypy strict mode; Platinum requires it including the upstream library. |
| **Triage** | The classification of open issues by severity/category/actionability performed in report 04 over the top-150 integrations. |
| **Wave (uplift wave)** | This report's term for a batched campaign uplifting a selected set of integrations through quality-scale tiers (recommendation, report 07). |
| **Wyoming protocol** | Peer protocol used by Assist for connecting voice services (STT/TTS/wake word) as networked components. |
| **Works With Home Assistant** | OHF's device-certification program for manufacturers. |

---

### Report series index

| File | Contents |
|------|----------|
| `report/00-executive-summary.md` | One-page findings & recommendation |
| `report/01-methodology-and-data-provenance.md` | Data sources, collection method, caveats |
| `report/02-architecture-overview.md` | Core architecture: event bus, registries, integration model |
| `report/03-quality-scale-distribution.md` | Tier distribution analysis (+ `data/quality_scale_distribution.csv`, `data/top_integrations.csv`) |
| `report/04-issue-triage-top-150.md` | Open-issue triage across top-150 integrations (+ `data/issue_triage.csv`) |
| `report/05-roadmap-and-architecture-signals.md` | Roadmap pillars, ADR direction, gap scan |
| `report/06-candidate-path-scoring.md` | Scoring model & ranked paths (+ `data/candidate_path_scores.csv`) |
| `report/07-recommendation-and-risk-register.md` | Recommendation, program plan, risk register |
| `report/08-appendix-glossary.md` | This glossary |
| `tools/` | Reproduction scripts for all data tables |