Skip to content

Harden Hass-Cleaner 1.0.2 #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dkwolf1 merged 1 commit into from
Sep 6, 2026
Merged

Harden Hass-Cleaner 1.0.2 #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/workflows/ci.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,6 @@ jobs:
- run: pip install -r requirements.txt
- run: python -m unittest discover -s tests -v
- run: node --check web/assets/app.js
- run: node --check web/assets/i18n.js
- run: node web/tests/i18n.test.cjs
- run: python -m compileall -q hass_cleaner tests
10 changes: 5 additions & 5 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

Hass-Cleaner is a Home Assistant App for inspecting storage, stale entities and registry relationships before anything is cleaned up. Safety, informed user choice and recovery come before reclaimed space.

> **Release status:** version 1.0.1 is the current maintenance release for controlled early use. Hass-Cleaner provides facts, advice, backup options and recovery guidance; the user makes the final cleanup decision.
> **Release status:** version 1.0.2 is the current maintenance release for controlled early use. Hass-Cleaner provides facts, advice, backup options and recovery guidance; the user makes the final cleanup decision.

## English

Expand Down Expand Up @@ -67,7 +67,7 @@ For version-specific changes, see [CHANGELOG.md](hass_cleaner/CHANGELOG.md). For
- Project documentation and GitHub communication use English as the primary language and Dutch as the secondary language.
- Interface and Home Assistant App settings support Automatic, English and Nederlands.
- Automatic uses the browser or Home Assistant display language and falls back to English for unsupported languages.
- The language selected inside Hass-Cleaner takes precedence over the Home Assistant App configuration.
- Both configuration locations work: changed App configuration fields override their saved UI values; unchanged fields retain your UI choices. Saving in Hass-Cleaner applies your new choices again. Supervisor options are not rewritten by UI saves.

### Install from GitHub

Expand All @@ -77,7 +77,7 @@ For version-specific changes, see [CHANGELOG.md](hass_cleaner/CHANGELOG.md). For
4. Start the App and open its web interface.
5. Run a scan first and review the report before preparing an action.

GitHub Actions builds version 1.0.1 for `amd64` and `aarch64`. After the container is published, Home Assistant can install or update the release through this repository.
GitHub Actions builds version 1.0.2 for `amd64` and `aarch64`. After the container is published, Home Assistant can install or update the release through this repository.

### Local development and tests

Expand Down Expand Up @@ -160,7 +160,7 @@ Versiegebonden wijzigingen staan in [CHANGELOG.md](hass_cleaner/CHANGELOG.md). G
- Projectdocumentatie en GitHub-communicatie gebruiken Engels als primaire taal en Nederlands als tweede taal.
- De interface en Home Assistant App-instellingen ondersteunen Automatisch, English en Nederlands.
- Automatisch gebruikt de browser- of Home Assistant-weergavetaal en valt bij een niet-ondersteunde taal terug op Engels.
- De taalkeuze binnen Hass-Cleaner heeft voorrang op de Home Assistant App-configuratie.
- Beide configuratieplekken werken: gewijzigde App-instellingen krijgen per veld voorrang; overige UI-keuzes blijven behouden. Opnieuw opslaan binnen Hass-Cleaner past je nieuwe keuze toe.

### Installeren vanuit GitHub

Expand All @@ -170,7 +170,7 @@ Versiegebonden wijzigingen staan in [CHANGELOG.md](hass_cleaner/CHANGELOG.md). G
4. Start de App en open de webinterface.
5. Voer eerst een scan uit en beoordeel het rapport voordat je een actie voorbereidt.

GitHub Actions bouwt versie 1.0.1 voor `amd64` en `aarch64`. Na publicatie van de container kan Home Assistant de release via deze repository installeren of bijwerken.
GitHub Actions bouwt versie 1.0.2 voor `amd64` en `aarch64`. Na publicatie van de container kan Home Assistant de release via deze repository installeren of bijwerken.

### Lokaal ontwikkelen en testen

Expand Down
6 changes: 4 additions & 2 deletions ROADMAP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,11 @@ Veiligheid gaat vóór extra opruimwinst. Een release gaat pas door wanneer risi
| 0.9.1 | Afgerond | Toegestane back-upcontrole, hergebruik van back-upbewijs, bewuste optionele back-upkeuze en selecteerbare entitybeoordeling. |
| 1.0.0 | Uitgebracht | Gebruikersgestuurde cleanup, registeruitvoering, persoonlijke inhoud, schone start en behoud van harde systeembescherming. |
| 1.0.1 | Voorbereid | Technische hardening: crashbestendige uitvoering, paginering, atomaire opslag, toegankelijkheid en betrouwbaar frontendcachebeleid. |
| 1.0.2 | Voorbereid | Herstel- en registerjournals, veilige configuratiesynchronisatie, begrensd scangeheugen, robuuste verzoekvalidatie en verbeterde tweetalige exports. |

### Praktijkcontrole voor vroege testers

- 1.0.1 installeren of bijwerken via de echte GitHub/GHCR-workflow.
- 1.0.2 installeren of bijwerken via de echte GitHub/GHCR-workflow.
- Volledige back-up starten en voltooiing op Home Assistant OS verifiëren.
- Zowel een veilige als een bewust gekozen reviewkandidaat naar quarantaine verplaatsen.
- Hersteltest uitvoeren en hetzelfde bestand werkelijk terugplaatsen.
Expand Down Expand Up @@ -69,10 +70,11 @@ Safety takes priority over reclaimed space. A release proceeds only when risky s
| 0.9.1 | Completed | Permitted backup verification, reusable evidence, an explicit optional backup choice and selectable entity reviews. |
| 1.0.0 | Released | User-directed cleanup, registry execution, personal content, clean-start controls and hard core-system protection. |
| 1.0.1 | Prepared | Technical hardening: crash-safe execution, pagination, atomic storage, accessibility and reliable frontend caching. |
| 1.0.2 | Prepared | Recovery and registry journals, safe configuration synchronization, bounded scan memory, robust request validation and improved bilingual exports. |

### Practical checks for early testers

- Install or update 1.0.1 through the real GitHub/GHCR workflow.
- Install or update 1.0.2 through the real GitHub/GHCR workflow.
- Start a full backup and verify completion on Home Assistant OS.
- Move both a safe file and an explicitly accepted review candidate into quarantine.
- Run the restore test and restore that file to its original location.
Expand Down
13 changes: 13 additions & 0 deletions hass_cleaner/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,18 @@
# Changelog

## 1.0.2 — 2026-09-06

- Apply changed Supervisor configuration fields without discarding unrelated UI choices; migrate the obsolete deletion_mode option at startup.
- Reject history clearing during active work and prevent new scans during clearing; include the entity comparison snapshot in a clean start.
- Reject malformed, non-object and oversized request bodies without changing settings; return structured operation errors and bound request-read time.
- Share Python-cache classification between scanning and quarantine validation, including reviewed bytecode without source files.
- Bound retained in-memory scans and avoid serializing the full registry for summary requests; preserve registry error details.
- Correct dynamic English text and accessibility labels, support language-specific Markdown downloads and document configuration precedence in English first.
- Restore files without overwriting targets created concurrently by integrations.
- Journal restore and purge intent and recover interrupted operations on startup, retaining recovery copies until completion is recorded.
- Persist registry cleanup intent and per-command progress; stop on journal errors and always release the operation lock. Interrupted outcomes remain visible for review.
- Preserve unreadable or damaged quarantine manifests and report errors instead of treating existing recovery data as empty.

## 1.0.1 — 2026-08-26

- Quarantaine en registeropschoning crashbestendiger en volledig geaudit gemaakt.
Expand Down
Loading