--- pattern_id: PAT-018 title: "Erfolgsmeldung einer Automatik ist kein Zustellbeweis — dateibasierte Queues validieren zweimal" category: integration severity: high status: active first_observed: 2026-10 last_updated: 2026-11-01 related_systems: [fleet-spool, board-service, spool-watcher, submit_task] related_solution_docs: - bug-fixes/2026-10-30-fleet-redispatch-envelope-contract-quarantine.md - bug-fixes/2026-11-01-fleet-karten-review-sweep-zustellkette.md related_skills: [devops/agent-fleet-operations] --- # Erfolgsmeldung einer Automatik ist kein Zustellbeweis ## Symptom Ein Automatik-Dienst meldet Erfolg (Log-Zeile, `rc=0`, `{"result":"OK","task_id":…}`, MCP-`OK_*`) — aber der erzeugte Auftrag existiert nirgends: - `grep` nach dem Sender findet **0** Dateien im Spool, - die Zielgröße bleibt unverändert (Karte `Neu`, Dead-Letter-Eintrag weg), - im Journal stehen **zwei** Events zur selben `task_id`: `accepted` **und** `quarantined`. Der Dienst läuft stundenlang „grün" und arbeitet nichts ab. ## Root Cause Der Spool hat **zwei unabhängige Validierungsschichten**: | Schicht | Datei | Zeitpunkt | Sichtbar für den Einleger? | |---|---|---|---| | Einleger | `spool/submit_task.py` (`VALID_SYSTEM_SENDERS`, `VALID_SYSTEM_SENDER_TYPES`) | beim Schreiben | ja (Rückgabewert) | | Watcher | `spool/watcher/watcher_main.py` (`SUBMIT_SYSTEM_SENDERS`, `SUBMIT_SYSTEM_SENDER_TYPES`, `validate_schema_loose`) | beim Scan, Sekunden später | **nein** | Der Watcher-Pod hat `submit_task.py` nicht im Image und hält eine **Hardcode-Kopie** derselben Konstanten. Wer nur eine Seite pflegt, erzeugt Drift: Der Einleger akzeptiert, der Watcher quarantäniert (`_invalid/`), und `accepted` wird **vor** der Quarantäne geschrieben — der Aufrufer sieht nur den Erfolg. Zweite Ausprägung derselben Klasse: Der Watcher prüft das Envelope-Schema strikt (uuid4-`task_id`, Status-Enum, Feld-Whitelist). Ein Erzeuger, der eigene IDs oder Zusatzstatus schreibt, wird erst beim Scan abgewiesen. ## Mitigation 1. **Zustell-Indikator prüfen, nicht den Rückgabewert:** `grep -l "^from: " /*.yaml | wc -l` → muss > 0 sein. 2. **Journal nach der `task_id` fragen:** `accepted` + `quarantined` in derselben Sekunde beweist Einleger-schuld-frei / Watcher-schuld-tragend. 3. **`_invalid/*quar-.yaml` prüfen** — der Envelope ist meist inhaltlich korrekt und kann nach dem Fix unverändert zurück in den Spool (`mv` statt Neuerzeugung, IDs/Bodies bleiben). 4. **Beide Konstanten-Dateien patchen**, dann Sync-Test laufen lassen (`spool/test_sender_sync.py`, AST-Vergleich beider Dateien). ## Prevention - **Sync-Test für Duplikate:** Wo eine Konstante bewusst doppelt liegt, muss ein Test die Gleichheit erzwingen (`test_sender_sync.py`: Sendermengen, Typ-Mapping je Sender, keine Kollision System-Sender/Org-Agent). - **Erfolg erst behaupten, wenn zugestellt:** Automatik-Trigger loggen „ok" erst bei `task_claimed` / Datei im Spool nach dem Scan — nicht bei `accepted`. - **Typen sind Format, nicht Absicht:** Dedupe/Filter nie auf einen Typ stützen, den auch Menschen benutzen (`review` = fachliche Abnahme **und** Sweep-Auftrag). Diskriminator ist der Sender (`from`). - **Automatik-Tasks nicht mit `karte_id` versehen**, wenn sie nur aktivieren sollen — sonst koppelt `complete_task` die Karte blind auf `Fertig`. ## Evidence - **2026-10-30** — Re-Dispatch verletzte den Envelope-Vertrag (synthetische `task_id`, `status: re-dispatched`, Zusatzfelder) → zwei `quarantined`-Events, Dead-Letter-Eintrag weg. SolDoc `bug-fixes/2026-10-30-fleet-redispatch-envelope-contract-quarantine.md`. - **2026-11-01** — Karten-Bewertungs-Sweep: `board-service` fehlte in der Watcher-Kopie der Sender-Allowlist; 4 Tasks quarantäniert, 12 Karten blieben unbewertet, Sweep meldete `cards=5` als Erfolg. Zusätzlich sperrte ein fachlicher `review`-Task (`Abnahme: deadman-rezidiv-research-4`, `working`) den Value Stream `vs-fleet-rebuild` mit 40 fälligen Karten. SolDoc `bug-fixes/2026-11-01-fleet-karten-review-sweep-zustellkette.md`.