Files
memory/patterns/automatik-erfolg-kein-zustellbeweis.md
2026-11-01 22:00:25 +00:00

4.0 KiB

pattern_id, title, category, severity, status, first_observed, last_updated, related_systems, related_solution_docs, related_skills
pattern_id title category severity status first_observed last_updated related_systems related_solution_docs related_skills
PAT-018 Erfolgsmeldung einer Automatik ist kein Zustellbeweis — dateibasierte Queues validieren zweimal integration high active 2026-10 2026-11-01
fleet-spool
board-service
spool-watcher
submit_task
bug-fixes/2026-10-30-fleet-redispatch-envelope-contract-quarantine.md
bug-fixes/2026-11-01-fleet-karten-review-sweep-zustellkette.md
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: <sender>" <spool>/*.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-<id>.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.