---
title: Aria Architektur (Plumbing-Doku)
type: reference
tags: [root, architecture, infrastructure]
date: 2026-06-03
status: aktiv
related: [[HEARTBEAT]], [[HOOKS]], [[SOUL]]
---

# Aria — Architektur & Infrastruktur

> **On-demand-Doku, NICHT im SessionStart-Bootstrap.** Dieses File beschreibt Plumbing
> (Watchdog, Hooks, Logging, Selbstheilung) — Infrastruktur, die läuft, ob Aria einen
> Absatz darüber liest oder nicht. Es ändert kein Agent-Verhalten zur Laufzeit, also
> gehört es nicht in einen Prompt, der pro Session geladen wird (Token-Kosten ohne
> Verhaltens-Effekt). Gezielt lesen bei Infra-Diagnose, nicht auf einem Timer.
>
> Ausgelagert aus HEARTBEAT.md im Zuge **KAR-684** (Polling→Interrupts-Refactor, 2026-06-03).

## Chat-Logging Architektur (Stand 2026-04-13)
- **Ausgehend (Aria → Kais):** PostToolUse Hook → direkt Supabase (vollständiger Text)
- **Eingehend (Kais → Aria):** UserPromptSubmit Hook → direkt Supabase (vollständiger Text)
- **Lokal:** aria-chat-logger-sqlite.service → SQLite `/root/.aria-chat.db` (für Session-Kontext-Restore)
- **aria-chat-logger.service:** läuft real ACTIVE (Korrektur 08.07.2026, KAR-882 — stand hier fälschlich „deaktiviert"); Redundanz zu den Hooks bei Gelegenheit klären
- Hook-Dateien: `/root/.claude/hooks/telegram-log-*.sh`

## Selbstheilung (aktiv)
- Watchdog prüft alle 2 Min ob die Session lebt (systemd `aria-watchdog.timer`)
- Telegram-Watchdog: `aria-telegram-watchdog.timer` (Zombie-Listener + bun-Crash-Recovery)
- SessionStart-Hook injiziert: SOUL.md + HEARTBEAT.md + Daily Log + Chat-Verlauf
- Kontext-Restore: SQLite Chat-Log wird beim Start geladen (`aria-context-restore-sqlite.py`)
- Responsiveness-Check: Passiv (Screen-Hash), kein aktives Input-Senden
- Control Panel: zwei Instanzen — Legacy http://127.0.0.1:9999 (`aria-control.service`) + v3 FastAPI http://127.0.0.1:9998 (`aria-control-v3.service`, das Panel aus Kais' Screenshots); Tunnel separat
- Für Details: `01-Projekte/Aria-Archiv/Aria-Architektur` (falls vorhanden)

## GitHub
- **aria-Infra:** privates Repo (Stand 2026-04-13, Pfade in Memory `reference_aria_distribution_repos`)

## Noch zu bauen (n8n)
- [ ] Waitlist-Alert: Neue Anmeldung → Telegram

## Verwandte Notizen
- [[HEARTBEAT]] — Timer-Index + Cron-owned Deadline-Block
- [[HOOKS]] — Hook-Inventory
- [[SOUL]] — Identität, Werte, Sicherheitsregeln
- `05-Referenzen/n8n-restart-workflow` — n8n Restart Workflow (falls vorhanden)
- `05-Referenzen/VPS-Befehle` — VPS Schnellreferenz (falls vorhanden)