Entities and bundles

Entities and bundles

State is not deletion evidence

The states unavailable, unknown and problem do not automatically mean that an entity is unused.

Possible causes include:

• a temporarily offline device;
• a sleeping battery-powered device;
• a network problem;
• an integration that has not loaded;
• a sensor that does not yet have a value;
• a device that connects only occasionally.

State and duration are therefore evidence for review, not automatic deletion approval.

Entity filters

Entities can be filtered by:

• state;
• tracked duration;
• integration;
• device;
• area;
• search text.

Duration tracking

Where possible, Hass-Cleaner uses Home Assistant's last_changed value.

If a reliable timestamp is unavailable, Hass-Cleaner builds local evidence across consecutive scans.

A first observation is not a persistent problem. Multiple scans spread over several days provide better evidence.

Registered entities

Only entities present in the Home Assistant entity registry can be selected for removal.

Removal uses Home Assistant's official WebSocket API.

Before executing a registry change, Hass-Cleaner requires:

• review of the advice;
• an explicit backup choice;
• risk acknowledgement;
• confirmation of the exact number of selected items.

Runtime-only entities

Runtime-only entities have an active state but no entity registry item.

They cannot be removed by Hass-Cleaner.

Disabled entities

An entity disabled by the user, an integration or Home Assistant is shown as information. Being disabled is not evidence that it should be removed.

Bundles

The Bundles page groups related objects by integration or device.

A bundle may contain:

• devices;
• entities;
• parent or child device relationships;
• configuration-entry relationships;
• related automations, scripts or scenes.

Before removing a bundle, verify:

• whether the integration is still used;
• whether automations reference its entities;
• whether the device can be recreated;
• whether the integration itself manages those registry objects.

Recovery

Registry removal has no individual undo button.

An integration may recreate removed entities, but this is not guaranteed. Reliable recovery requires a complete Home Assistant backup.