propose fix for tonersave queue default

openspec/changes/fix-tonersave-queue-default/tasks.md

@@ -0,0 +1,83 @@
+# Tasks
+
+Aufteilung: 1. Ursache feststellen (blockierend), 2. Testschicht, 3. Spec/README,
+4. Serverseitiger Fix nur falls 1 ihn hergibt.
+
+## 1. Ursache feststellen (Verifikation des Ist-Zustands)
+
+- [ ] 1.1 Jobpfad reproduzieren: Image bauen, Testcontainer mit
+      `PRINTER_OPTIONS="BRColorMode=None TonerSaveMode=True"` starten, einen Job
+      einreichen (`podman exec <c> lp -d <queue> -o raw <sample>` oder
+      `cupsfilter <sample>`), und im versandten PostScript
+      (`/var/spool/cups/d<JobId>-*`, Job-Nummer aus
+      `lpstat -W completed -o`) prüfen, ob der Tonerspar-Zweig
+      (`statusdict/tonersave` … `true`) enthalten ist.
+      Verifikation: Ergebnis (enthalten/nicht enthalten) mit dem ausgelesenen
+      Spool-Pfad und der CUPS-Version in design.md notieren.
+- [ ] 1.2 Zweiten Messpunkt gegen die Queue-Defaults aufnehmen: denselben Job
+      zusätzlich mit explizitem `-o BRColorMode=Vivid` einreichen und die
+      `UseCIEColor`-Zeile im Spool mit der des ersten Jobs vergleichen.
+      Verifikation: dokumentierter Unterschied (oder dessen Fehlen) zeigt, ob
+      per-Job-Optionen im selben Pfad sichtbar werden — belegt, dass die
+      Messmethode aus 1.1 trägt.
+- [ ] 1.3 Queue-Zustand desselben Containers gegengelesen:
+      `lpoptions -p <queue> -l` (Sternchen) und
+      `grep '^Default' /etc/cups/ppd/<queue>.ppd`.
+      Verifikation: die Abweichung aus dem Ausgangsbefund ist entweder
+      bestätigt (`*False` bei `DefaultTonerSaveMode True`) oder widerlegt;
+      Ergebnis in design.md festhalten.
+- [ ] 1.4 Ergebnis einordnen und die Entscheidung nach Design D3 treffen:
+      erreicht der Queue-Default den Job (Szenario in specs/… bleibt) oder nicht
+      (design.md um das Resultat ergänzen, Szenario auf das verifizierte
+      Verhalten umformulieren, Limitation explizit benennen).
+      Verifikation: design.md enthält den Messwert und die getroffene
+      Entscheidung; die betroffenen Tasks aus 2/3 sind entsprechend markiert.
+      Ohne dieses Ergebnis werden 2.x/3.x nicht abgehakt.
+
+## 2. Automatisierter Nachweis (neue Testschicht)
+
+- [ ] 2.1 `tests/test-queue-defaults.sh` anlegen: baut das Image, startet einen
+      Container mit `PRINTER_OPTIONS="BRColorMode=Vivid TonerSaveMode=False"`,
+      wartet auf `ready: CUPS on 631/tcp`, reicht einen Job ohne
+      `print-quality`/Preset-Attribute ein und liest das letzte Spool-File
+      (`lpstat -W completed -o` → `/var/spool/cups/d<JobId>-*`).
+      Verifikation: Skript läuft lokal durch (`bash tests/test-queue-defaults.sh`),
+      Ausgabe zeigt den Spool-Pfad und die gefundenen PostScript-Zeilen.
+- [ ] 2.2 Assertions gemäß Ergebnis aus 1.4 einbauen: `UseCIEColor true` für den
+      Queue-Default `Vivid` und der Tonerspar-Zustand aus dem verifizierten
+      Verhalten für `TonerSaveMode=False`; zusätzlich muss die
+      `UseCIEColor`-Zeile bei explizitem `-o BRColorMode=None` abweichen
+      (Regressionsschutz). Vergleich nur über `grep -F` auf Zeilen, kein Parsen
+      von PDF/PS-Struktur.
+      Verifikation: Skript endet mit Exit 0 und einer PASS-Zeile pro Assertion;
+      eine absichtlich falsch gesetzte Erwartung lässt es mit Exit ≠ 0 und
+      Klartextzeile scheitern.
+- [ ] 2.3 Lebensdauer/Umgebung absichern: Container immer aufräumen (Trap),
+      kurze Wiederholung des Spool-Lesens statt Polling, und im Skriptkopf die
+      verifizierte CUPS-Version notieren.
+      Verifikation: `podman ps -a` zeigt nach einem Lauf keinen Testcontainer;
+      zweiter Lauf hintereinander ist grün.
+
+## 3. Spec und README angleichen
+
+- [ ] 3.1 `README.md`, Abschnitt *Environment variables* / `PRINTER_OPTIONS`:
+      eine Zeile ergänzen, was ein Queue-Default für den Ausdruck bedeutet
+      (Queue-Default schlägt den PPD-Default, sichtbar im versandten
+      PostScript), mit Verweis auf das Testskript.
+      Verifikation: `grep -n 'PRINTER_OPTIONS' README.md` zeigt den neuen Satz;
+      die genannte Assertion stimmt mit 2.2 überein.
+- [ ] 3.2 `entrypoint.sh`-Hinweis prüfen: der bestehende Kommentar bei
+      `apply_printer_options` (Zeile ~341–345) behauptet, `lpadmin` würde
+      unbekannte Zuweisungen speichern — mit dem Befund aus 1.x abgleichen und
+      nur bei Bedarf präzisieren.
+      Verifikation: `jj diff` zeigt entweder keine Änderung an entrypoint.sh
+      oder ausschließlich Kommentar/Log-Text, ohne Verhaltensänderung.
+
+## 4. Aktualisierung der Hauptspec (Archive-Zeitpunkt)
+
+- [ ] 4.1 Beim Archivieren die Delta-Spec nach
+      `openspec/specs/printserver/cups/spec.md` übernehmen und dabei die alte
+      Fassung des Requirements *Queue defaults are configurable at runtime*
+      (Zeilen 69–89) durch die neue, job-beobachtbare Fassung ersetzen.
+      Verifikation: `openspec validate --strict` ohne Findings; die Hauptspec
+      enthält genau eine Fassung des Requirements.