[ludeeus]

Summary

This PR adds validation to prevent HACS installation on Home Assistant 2026.11 and newer versions, where HACS has been replaced by the native Marketplace integration. The script now detects incompatible versions and provides users with appropriate documentation links based on their Home Assistant version type (stable, beta, or development).

Key Changes

• Version Detection Logic: Added checks in the get script to detect Home Assistant versions 2026.11 and newer
• User-Friendly Error Messages: When an incompatible version is detected, the script displays an error message with a link to the appropriate marketplace documentation:
  • Stable releases (2026.11.0+): https://www.home-assistant.io/integrations/marketplace
  • Beta releases (2026.11.0b+): https://rc.home-assistant.io/integrations/marketplace
  • Development releases (2026.11.0.dev+): https://next.home-assistant.io/integrations/marketplace
• Test Coverage: Added comprehensive test cases in the GitHub Actions workflow to validate the version checking logic with various version formats (stable, beta, dev)
• New Marketplace Validation Job: Added a dedicated GitHub Actions job to validate that the marketplace documentation URLs are correctly displayed for incompatible versions

Implementation Details

• Version comparison uses year and month fields from the semantic version string
• The check handles pre-release versions (beta and dev) appropriately
• Early exit prevents any HACS files from being downloaded on incompatible versions
• Test matrix includes edge cases like 2026.10.5 (should allow), 2026.11.0 (should block), and various pre-release formats

https://claude.ai/code/session_01EM6kiLprQ7KKu5SHy7fxmZ

[Copilot]

🟢 Approval recommended

The guard and CI checks match the stated requirements, with no unresolved issues identified.

0 open findings

What changed in this PR

Adds an installer guard that blocks HACS installation on Home Assistant 2026.11 and newer, directing users to Marketplace documentation.

Changes:

• Checks compatibility before downloading HACS files.
• Selects documentation links for stable, beta, and development releases.
• Adds CI checks for version boundaries, messages, and early exit behavior.

File	Description
get	Adds the compatibility guard and release-specific documentation links.
.github/​workflows/​actions.yml	Updates the installation fixture and adds compatibility checks.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[frenck]

@ludeeus The "Get HACS" add-on in hacs/addons probably needs the same guard. Otherwise people on 2026.11 can still install HACS through the add-on, and the loader then blocks it right away.

../Frenck

                       

Blogging my personal ramblings at frenck.dev

[ludeeus]

The App is using this script, so only this place needs the adjustment 👍

[frenck]

ok we can already publish this, right? As in.. it works by the version? :)

../Frenck

                       

Blogging my personal ramblings at frenck.dev

[ludeeus]

Yes, as soon as #68 is merged 👍

[frenck]

merged