85 lines
4.0 KiB
Markdown
85 lines
4.0 KiB
Markdown
---
|
|
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: <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`.
|