feat: add hamh-alpha addon for testing pre-release versions

.github/workflows/ci.yaml

@@ -24,6 +24,12 @@ jobs:
           yq eval '.' hamh/config.yaml > /dev/null
           echo " hamh config is valid YAML"
 
+      - name: Validate hamh-alpha config
+        run: |
+          echo "Validating hamh-alpha/config.yaml..."
+          yq eval '.' hamh-alpha/config.yaml > /dev/null
+          echo " hamh-alpha config is valid YAML"
+
       - name: Validate repository.yaml
         run: |
           echo "Validating repository.yaml..."
@@ -32,7 +38,7 @@ jobs:
 
       - name: Check required fields
         run: |
-          for addon in hamh; do
+          for addon in hamh hamh-alpha; do
             echo "Checking $addon required fields..."
             yq eval '.name' $addon/config.yaml > /dev/null || (echo "Missing name in $addon" && exit 1)
             yq eval '.version' $addon/config.yaml > /dev/null || (echo "Missing version in $addon" && exit 1)

.github/workflows/release-addons.yaml

@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
     inputs:
       project:
-        description: 'Project to release (hamh, hamh-beta)'
+        description: 'Project to release (hamh, hamh-alpha)'
         required: true
         default: 'hamh'
       version:
@@ -22,7 +22,7 @@ on:
 
 # client_payload from repository_dispatch:
 #   project: "hamh"
-#   channel: "latest" | "beta"
+#   channel: "latest" | "alpha"
 #   version: "3.0.0"
 #   changelogUrl: "https://..."
 

README.md

@@ -10,7 +10,10 @@
 
 This repository provides the following addons for Home-Assistant:
 
-- Home-Assistant-Matter-Hub
+| Addon | Description | Stability |
+|-------|-------------|-----------|
+| **Home-Assistant-Matter-Hub** | Stable release | ✅ Production |
+| **Home-Assistant-Matter-Hub (Alpha)** | Pre-release with new features | ⚠️ Testing only |
 
 ## Installation
 

hamh-alpha/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog - Home-Assistant-Matter-Hub (Alpha)
+
+⚠️ **WARNING: This is an alpha version for testing purposes only!**
+
+This addon contains pre-release features that may be unstable or incomplete.
+Use at your own risk and please report any issues on GitHub.
+
+---
+
+## [1.4.0-alpha.1] - Initial Alpha Release
+
+### New Features
+- **Health Check API** (`/api/health`) with uptime, status, and service info
+- **Kubernetes-ready probes** (`/api/health/live`, `/api/health/ready`)
+- **WebSocket live updates** (`/api/ws`) for real-time bridge status
+- **Entity Mapping Customization**:
+  - Override Matter device types per entity
+  - Custom names for entities
+  - Disable entities from bridge
+
+### Technical Changes
+- Node.js 24 (LTS)
+- Dropped armv7 support (only amd64 + arm64)

hamh-alpha/config.yaml

@@ -0,0 +1,27 @@
+version: "1.4.0-alpha.1"
+image: ghcr.io/riddix/home-assistant-matter-hub-addon
+slug: hamh-alpha
+name: Home-Assistant-Matter-Hub (Alpha)
+description: "⚠️ ALPHA VERSION - For testing only! Publish your entities from Home Assistant to any Matter-compatible controller like Alexa, Apple Home or Google Home."
+url: https://github.com/riddix/home-assistant-matter-hub
+panel_icon: mdi:hub
+panel_title: Matter Hub Alpha
+homeassistant: 2024.1.0
+homeassistant_api: true
+host_network: true
+init: false
+arch:
+  - aarch64
+  - amd64
+ingress: true
+ingress_port: 0
+map:
+  - addon_config:rw
+options:
+  app_log_level: info
+  disable_log_colors: false
+  mdns_network_interface: ""
+schema:
+  app_log_level: list(silly|debug|info|notice|warn|error|fatal)
+  disable_log_colors: bool
+  mdns_network_interface: "str?"

hamh-alpha/translations/en.yaml

@@ -0,0 +1,14 @@
+---
+configuration:
+  app_log_level:
+    name: Log Level
+    description: |
+      The log level used for this addon. One of: silly, debug, info, warn, error
+  disable_log_colors:
+    name: Disable log colors
+    description: |
+      Print the log as plain text without any colors.
+  mdns_network_interface:
+    name: mDNS Network Interface
+    description: |
+      Limit mDNS to this network interface. Only change it if you know what you are doing. Default: empty