Skip to content

test(pwa): Service-Worker-Wächter ASSET_HASH - #10

Open
lukisch wants to merge 1 commit into
masterfrom
pwa-asset-hash-guard
Open

lukisch wants to merge 1 commit into
masterfrom
pwa-asset-hash-guard

Conversation

@lukisch

@lukisch lukisch commented Nov 15, 2026

Copy link
Copy Markdown
Collaborator

Was

Service-Worker-Wächter nach Vorlage assistassets-ai/mediplaner a0363a2 (PR #8): Der Test liest das Asset-Array aus webapp/static/service-worker.js, verlangt, dass jeder Eintrag existiert, und hasht alle gecachten Dateien (Text mit CRLF zu LF, Icons als Bytes, Pfad als Hash-Präfix). Der Gesamthash muss ASSET_HASH entsprechen, sonst ist der Test rot.

Warum

Cache-first-Service-Worker liefern nach Updates alte Dateien aus, wenn CACHE_NAME nicht zum tatsächlichen Inhalt passt (DokuReader-Fehlerklasse vom 13.09.). Bisher fiel das erst auf dem Gerät auf.

Details

  • ASSET_HASH: (keiner) -> af4ec644be12
  • CACHE_NAME unverändert (methodenanalyser-webapp-v3): nur neue Hash-Basis, kein gecachter Inhalt geändert, daher keine neue Version nötig.
  • Negativkontrolle: lokal ein Byte einer gecachten Datei geändert, Test wurde rot; danach zurückgesetzt, nichts davon committet.
  • Test: node --test über die neue Testdatei lokal grün. Einhängung: Test läuft in der CI über die bestehende pytest-Suite: tests/test_sw_asset_hash.py ruft node --test auf (wird ohne Node.js übersprungen), Repo hat keine Node-Tests/package.json.
  • Keine Icons erzeugt, ersetzt oder verändert.
  • Array heißt STATIC_ASSETS; der SW nutzt URLs: / -> index.html, /assets/x -> store_assets/x (so liefert server.py es aus), sonst webapp/static/. Negativkontrolle über store_assets/Square44x44Logo.png.

Ticket T-20261114-620420536 (WS-Ticket-Master).

🤖 Generated with Claude Code

https://claude.ai/code/session_01THB2Ey4obVQ1wvjCAf4rJ5

…teien

Cache-first-Service-Worker liefern nach Updates alte Dateien aus, wenn
CACHE_NAME nicht zum Inhalt passt. ASSET_HASH in der SW-Datei bindet die
Version an den Inhalt; der Test liest das Asset-Array aus dem SW selbst,
verlangt dass jeder Eintrag existiert und hasht Text (CRLF->LF) und
Icons (Bytes). Abweichung macht den Test rot. Vorlage:
assistassets-ai/mediplaner a0363a2. CACHE_NAME unveraendert (nur neue
Hash-Basis, kein geaenderter Cache-Inhalt). Keine Icons veraendert.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01THB2Ey4obVQ1wvjCAf4rJ5
@github-actions

Copy link
Copy Markdown

Welcome! 👋 Thanks for your first pull request in this repository.

A maintainer will review it soon. Please make sure:

  • Your changes are tested
  • Documentation is updated if needed
  • The PR description explains what and why

Thanks for contributing!

@lukisch lukisch left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Zweitprüfung (Cloud-Bot): inhaltlich freigegeben ✅ (formales Approve ist mit demselben Konto nicht möglich)

Geprüft auf Head 01c0832 (Linux, Node lokal):

  • node --test tests/sw_asset_hash.test.mjs: 1 passed, der eingetragene ASSET_HASH stimmt.
  • Die Zuordnung der URLs ist korrekt: / → index.html, /assets/… → store_assets/…, alles andere relativ zu webapp/static/.
  • Gegenprobe: store_assets/Square44x44Logo.png verändert → Test schlägt fehl und nennt den neuen Hash. Auch die Dateien außerhalb von webapp/static/ sind also wirksam abgedeckt.
  • Kein Laufzeitverhalten geändert.

Hinweis (nicht blockierend): Der Wächter läuft nur über den Pytest-Wrapper und wird übersprungen, wenn auf dem Runner kein node liegt. Bitte im CI-Log einmal prüfen, ob test_sw_asset_hash_waechter dort PASSED oder SKIPPED meldet.


Generated by Claude Code

@lukisch lukisch left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Zweitmodell-Abnahme: keine Einwände, aus Review-Sicht mergebereit (formales Approve ist nicht möglich, weil PR und Review über dasselbe Konto laufen)

Geprüft auf 01c0832 (aktuell zu master; Linux, Node 22):

  • node --test tests/sw_asset_hash.test.mjs: 1 bestanden, ASSET_HASH = af4ec644be12 stimmt.
  • pytest tests/test_sw_asset_hash.py: 1 bestanden (Brücke in die bestehende pytest-Suite funktioniert).
  • Negativkontrolle: ein Byte an webapp/static/app.js angehängt, Test rot; zurückgesetzt, wieder grün.
  • Die Pfadabbildung /assets/… → store_assets/… und / → index.html löst alle STATIC_ASSETS-Einträge auf vorhandene Dateien auf.

Generated by Claude Code

@lukisch lukisch left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Zweitmodell-Review: Diff freigabefähig; die roten Smoke-Jobs kommen nicht aus diesem PR.

Geprüft: Wächter lokal grün; nach einer Teständerung an webapp/static/index.html schlägt er mit dem neuen Hash-Wert an. Die Abbildung / → index.html und /assets/… → store_assets/… löst alle neun STATIC_ASSETS-Einträge auf, keiner wird ausgelassen.

Rote Checks: Alle zwölf Smoke-Jobs scheitern im Lint-Schritt (ruff check, in der CI 21 Fehler, z. B. I001 in tests/test_store_materials.py). Die neue Datei tests/test_sw_asset_hash.py ist mit der Repo-Konfiguration lint-sauber, und die Fehlerzahl ist lokal mit und ohne diesen PR identisch. Der Lint-Schritt bricht ab, bevor die Tests starten; der Wächter ist in der CI deshalb noch nie gelaufen.

#9 („restore lint and test run on master“) behebt genau das. Empfehlung: zuerst #9 mergen, dann diesen PR aktualisieren und den CI-Lauf abwarten.


Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant