Release Validation for Users

Release Validation for Users

This page is a user-safe checklist for after updating Humidity Intelligence.

It is not the maintainer release process. Release authority stays with the repository release governance, version metadata, validation gates, and maintainer approval.

After Updating

Check:

1. HACS or your install method shows the expected version.
2. Home Assistant has been restarted after the update.
3. Humidity Intelligence loads under Settings -> Devices & services.
4. Main HI entities are available.
5. The generated dashboard still renders.
6. The reason panel matches the active runtime state.
7. Native diagnostics can be downloaded if support is needed.

HACS Visibility

If HACS still shows an older version:

1. refresh HACS repository information
2. re-check the offered version
3. update or re-download through HACS
4. restart Home Assistant
5. check the installed version again

See HACS and Updates for the longer support path.

Dashboard Validation

After an update that touches generated cards, options, frontend dependencies, or output details:

1. run the supported card export or refresh flow
2. update Manual card YAML if you use Manual cards
3. reload the dashboard
4. clear browser/app cache if stale UI remains
5. check that chips and reason text reflect backend truth

Generated dashboards should not invent backend state. If the dashboard looks more confident than the runtime state, report it.

Runtime Sanity

Check the normal surfaces you already trust:

• active lane or mode
• reason text
• gate status
• configured outputs
• unavailable configured entities
• diagnostics warnings

You do not need to force a safety or emergency scenario to validate an update. For normal user validation, avoid creating risky real-world conditions just to test the integration.

Diagnostics

If anything looks wrong, download native Home Assistant diagnostics before making lots of changes. Diagnostics preserve the useful support snapshot:

• versions
• configured entities
• active lane/mode
• reason text
• gates
• output state
• generated card summary
• unavailable or unknown configured entities

See Diagnostics and Support Bundle.

Local HI-Only Snapshots

Advanced maintainers may use HI's package-local snapshot support where available.

Remember:

• it is local to the HI package
• it is not a Home Assistant backup
• it does not intercept HACS updates
• it does not automatically restore code
• it does not replace normal Home Assistant backup practice

When To Open An Issue

Open an issue if:

• the integration does not load after restart
• expected HI entities are missing
• generated cards contain unresolved placeholders
• the dashboard contradicts backend reason text
• HACS/Home Assistant version state stays inconsistent after refresh/restart
• diagnostics show unavailable configured entities you cannot explain

Include the native diagnostics file whenever practical.