Dokumentation

Architektur

Zwei Modelle mit getrennten Rollen und eine Schwelle dazwischen. Ein stiller Observer erkennt, was relevant werden könnte; erst dann übernimmt der Executive.

Observer & Executive Heute

Der Observer läuft klein und günstig, beobachtet nur aktivierte Ereignisse, antwortet nie, bündelt Signale, prüft Gedächtnis und Muster und schätzt Absicht und Konfidenz — und darf entscheiden, nichts zu tun. Die Executive wird ab Konfidenz-Schwelle 0.85 geweckt, prüft Authority, ruft Werkzeuge, erklärt ihr Warum und verifiziert das Ergebnis. Beide Rollen dürfen unabhängig unterschiedliche Provider und Modelle verwenden. Ohne Observer-Modell läuft ein ehrlicher Regelmodus.

Ereignis ──► Observer ──► Absicht ≥ 0.85? ──► Executive ──► Werkzeug ──► Impuls
   (App,      (klein,          (nein: still         (groß)      (Authority,   (an dich)
  Webhook,     dauernd)         ablegen)                        Audit)
   Cron)

Guardrails / Governor Heute

Sieben Schutzmechanismen als Tabelle, dazu zwei weitere im Code — zusammen die Sicherheitskette.

WasWie
KostenTagesbudget in Token (500k), persistent; ist es erschöpft, hört der Observer auf
ModellwahlKleines Modell dauerhaft, großes erst ab Zuversicht 0.85
RisikoDrei Klassen: read_only, write_low_risk, critical_action
FreigabeKritisches fragt immer nach — mit Vorschau von Werkzeug, Argumenten, Ziel, Risiko, Begründung
Impuls-BremseMindestabstand (900s) plus Tagesgrenze; Unterdrücktes wird abgelegt statt verworfen
Kaputte WerkzeugeDrei Fehlschläge, dann fünf Minuten Pause
ProtokollAppend-only-Audit mit Begründung bei jeder Entscheidung
Prüfer (Zweitprüfung)Ein getrenntes Modell bewertet konkrete Schritte; nur exakt „HARMLOS" oder es wird gefragt — kritisch nie automatisch
Ausweis-TorKein verifizierter Besitzer ⇒ keine Werkzeuge in Executive/Fäden

Die Risikoklassen sind bewusst identisch zu ToolRisk in der iOS-App — eine Wahrheit, nicht zwei.

Eingänge Heute

EingangWie
TaktAlle 30 min ein Blick aufs Gedächtnis (HUNCH_HEARTBEAT_SECONDS), nachts still
Telegram / WhatsAppImpulse gehen in denselben Chat zurück; fremde Chats werden gefiltert
OrdnerHUNCH_WATCH_DIR — neue/geänderte Dateien werden gemeldet
HTTP · WebSocketPOST /events, WS /ws

Alles von Dritten ist als fremd markiert und wird dem Modell als Zitat vorgelegt, nie als Befehl.