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 |
|
|
|
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:
grepnach 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:acceptedundquarantined.
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
- Zustell-Indikator prüfen, nicht den Rückgabewert:
grep -l "^from: <sender>" <spool>/*.yaml | wc -l→ muss > 0 sein. - Journal nach der
task_idfragen:accepted+quarantinedin derselben Sekunde beweist Einleger-schuld-frei / Watcher-schuld-tragend. _invalid/*quar-<id>.yamlprüfen — der Envelope ist meist inhaltlich korrekt und kann nach dem Fix unverändert zurück in den Spool (mvstatt Neuerzeugung, IDs/Bodies bleiben).- 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 beiaccepted. - 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_idversehen, wenn sie nur aktivieren sollen — sonst koppeltcomplete_taskdie Karte blind aufFertig.
Evidence
- 2026-10-30 — Re-Dispatch verletzte den Envelope-Vertrag (synthetische
task_id,status: re-dispatched, Zusatzfelder) → zweiquarantined-Events, Dead-Letter-Eintrag weg. SolDocbug-fixes/2026-10-30-fleet-redispatch-envelope-contract-quarantine.md. - 2026-11-01 — Karten-Bewertungs-Sweep:
board-servicefehlte in der Watcher-Kopie der Sender-Allowlist; 4 Tasks quarantäniert, 12 Karten blieben unbewertet, Sweep meldetecards=5als Erfolg. Zusätzlich sperrte ein fachlicherreview-Task (Abnahme: deadman-rezidiv-research-4,working) den Value Streamvs-fleet-rebuildmit 40 fälligen Karten. SolDocbug-fixes/2026-11-01-fleet-karten-review-sweep-zustellkette.md.