HA-Pulse/home-assistant-global-health-score v1.1

HAGHS Technical Specification & PoC

on GitHub

🛡️ HAGHS v1.1.0 - The Foundation

This is the initial release of the Home Assistant Global Health Score (HAGHS). This project establishes a logical framework for measuring system stability through a weighted 0-100 index.

💎 Key Features

• The 40/60 Logic: A balanced weighting system that prioritizes long-term software maintenance over transient hardware spikes.
• Self-Healing Advisor: A built-in recommendation engine that provides actionable repair steps via sensor attributes.
• Standardized Naming: Full compliance with the Area: Object - Function naming convention for a clean entity registry.
• Fair-Play Engine: Intelligent filtering for "Zombie" entities to prevent false negatives on intentional sleepers (e.g., battery-powered trackers).

🛠️ Reference Implementation

Included in this release is the haghs.yaml reference code. This Proof of Concept (PoC) uses the native Home Assistant Template engine to demonstrate the HAGHS calculation logic.

📋 Technical Abstract

The score is derived from two primary pillars:

1. Hardware Integrity (40%): CPU, Memory, and Disk analysis with non-linear penalty curves.
2. System Hygiene (60%): Maintenance debt tracking including Entity states, Backups, and Updates.

Architectural Note: This release serves as a functional specification for the ongoing proposal to integrate HAGHS logic natively into the Home Assistant Core.