Task-Runtime

Stand: 2026-05-25

Ziel

Laengere Infrastrukturaufgaben sollen nicht nur im Chat existieren. Sie brauchen Status, Wiederaufnahme, Fehlerbehandlung und Nachvollziehbarkeit.

Statusmodell

Status	Bedeutung
queued	Aufgabe geplant, noch nicht gestartet
running	Aufgabe laeuft
needs_approval	wartet auf Freigabe
blocked	Abhaengigkeit fehlt
failed_retryable	Fehler, Retry sinnvoll
failed_final	Fehler, manuelle Klaerung
completed	abgeschlossen und dokumentiert

Run-ID

Format:

YYYYMMDD-HHMMSS-<kurzer-slug>

Beispiel:

20260525-103000-netbox-prefix-discovery

Jeder Run sollte in Logs, Doku, n8n und Git wiederfindbar sein.

Persistenz

Kurzfristig:

• Markdown-Runbooks in Gitea
• n8n Execution History
• Service-Logs

Mittelfristig:

• PostgreSQL fuer Agent-Runs, Steps, Approvals und Artefakte
• Qdrant fuer Knowledge
• optional Neo4j fuer GraphRAG/Abhaengigkeiten

Schema

Ein erster PostgreSQL-Schemaentwurf liegt unter:

• agent-runtime/schemas/agent-runtime.sql

Er umfasst:

• agent_runs
• agent_steps
• agent_approvals
• agent_artifacts

Secrets werden dort nicht gespeichert. Artefakte werden nur referenziert und mit contains_secrets markiert.

Retry/Recovery

Automatische Retries sind erlaubt bei:

• transienten HTTP-Fehlern
• DNS-/Timeout-Problemen
• read-only Abfragen
• Git-Fetch/Push-Konflikten mit Rebase-Pruefung

Keine automatischen Retries bei:

• fehlgeschlagenen produktiven Writes
• Auth-/Permission-Fehlern
• Firewall-/Routing-Aenderungen
• Datenbankmigrationen