Systembericht — Phase 21.5 (Historisch)

Historischer Snapshot von Arc OS nach der Integration der evolutionären Intelligenz. Hinweis: Dieses Dokument spiegelt den Systemstand bei Phase 21.5 wider. Das aktuelle System befindet sich bei Phase 40.18 mit 62+ API-Endpunkten, CRM-Dashboard, OAuth, Sage Worker und mehr. Siehe Benutzerhandbuch und Produktübersicht für aktuelle Dokumentation.

Systemzusammenfassung

Metrik	Wert
TypeScript-Kerncode (shared + Bots + Skripte)	3.298 Zeilen
Shared-Module	7
Registrierte Skills (Registry)	18
Library-Skills	7
Skills gesamt	25
Eval-Regeltypen	6
Pilot-Eval-Regelsets	3 (9 Regeln gesamt)
Agents	6
Child Bots (Produktion)	2
Git-Commits	36
Ausgelieferte Phasen	15 → 21.5
Eigener Backend-Code	0 Zeilen

Architektur

                    ┌──────────────────────────────────┐
                    │       Master Bot (Port 19210)      │
                    │       @citadel_master_bot          │
                    │                                    │
                    │  /status /health /deploy /watchdog  │
                    │  /new_project /remove_project       │
                    │  Approve/Reject improvements        │
                    └──────────┬───────────┬─────────────┘
                               │           │
                  ┌────────────┘           └────────────┐
                  ▼                                     ▼
        ┌───────────────────┐             ┌───────────────────┐
        │  Child: citadel-v2 │             │  Child: pt         │
        │  Port 19211        │             │  Port 19212        │
        │                    │             │                    │
        │  Intelligence:     │             │  Intelligence:     │
        │  ├ Context Router  │             │  ├ Context Router  │
        │  ├ Learnings       │             │  ├ Learnings       │
        │  ├ Binary Evals    │             │  ├ Binary Evals    │
        │  └ Quality Track   │             │  └ Quality Track   │
        └───────────────────┘             └───────────────────┘
                  │                                     │
                  ▼                                     ▼
        ┌───────────────────┐             ┌───────────────────┐
        │  MCP Bridge        │             │                    │
        │  Port 19200        │             │  (noch keine Bridge)│
        │  SSE + HTTP API    │             │                    │
        └────────┬──────────┘             └───────────────────┘
                 │
                 ▼
        ┌───────────────────┐
        │  Phaser.js Frontend│
        │  Port 5173 (dev)   │
        │  Visuelles KI-Büro │
        └───────────────────┘

Modulübersicht

shared/ (7 Module, 1.124 Zeilen)

Modul	Zeilen	Phase	Zweck
`logger.ts`	189	20.5	Strukturiertes JSONL-Logging: System-/Dialog-/Fehlerkanäle, tägliche Rotation
`vault.ts`	216	20.5	AES-256-GCM-verschlüsselter Geheimnis-Speicher: initVault, getSecret, setSecret
`quality.ts`	192	21.1+21.5	Ausführungs-/Feedback-Tracking, Aggregation, Erkennung von Underperformern
`ui_templates.ts`	158	21.0+21.5	Telegram-Tastaturen: Master-Menü, Projektkarten, Child-Buttons, Verbesserungsvorschläge
`evals.ts`	142	21.5	Binäre Eval-Engine: 6 Regeltypen, checkOutput, formatWarnings
`context-router.ts`	117	21.5	Skill-Scoring: Trigger-/Keyword-Matching, SKILLS_HINT-Generierung
`learnings.ts`	110	21.5	Persistente Korrekturen: Learnings aus Markdown laden/hinzufügen/formatieren

Bot-Runtimes (1.937 Zeilen)

Datei	Zeilen	Zweck
`child-bot/bot.ts`	944	Telegram-Claude CLI-Proxy mit Integration der Intelligenzschicht
`master-bot/bot.ts`	993	Orchestrator: Befehle, Projektkarten, Watchdog, Verbesserungsgenehmigung

Skripte (237 Zeilen)

Datei	Zeilen	Zweck
`scripts/nightly-improve.ts`	237	Karpathy Loop: Metrikenanalyse → Verbesserungsvorschläge → CEO Telegram

Skills-Inventar

Registry-Skills (18)

Skill	Kategorie	Phase	Evals
handoff-protocol	complex, skill_injection	15.2	-
code-review	complex	15.3	3 Regeln
system-audit	complex	15.3	3 Regeln
git-manager	complex, skill_injection	16	3 Regeln
project-onboarding	complex, skill_injection	16	-
web-scaffolding	complex	15	-
code-review-protocol	complex	15	-
automated-testing	complex	15	-
deployment-flow	complex	15	-
knowledge-index	complex	15	-
document-analysis	complex	15	-
citadel-wrapup	cli_command	19.4	-
citadel-recall	cli_command	19.4	-
citadel-status	cli_command	19.5	-
citadel-task	cli_command	19.5	-
citadel-deploy	cli_command	19.5	-
figma-audit	complex, skill_injection	21	-
figma-apply-system	complex, skill_injection	21	-
figma-implement	complex, skill_injection	21	-

Library-Skills (7)

Skill	Domäne
docker-ops	Container-Orchestrierung
figma-design	Design-to-Code-Pipeline
github-actions	CI/CD-Workflows
odoo-expert	Odoo-ERP-Entwicklung
odoo-owl-expert	Odoo-Owl-Framework
plasthetica-style-guide	Projektspezifischer Style Guide
postgres-pro	PostgreSQL-Optimierung

Intelligenzschicht (Phase 21.5)

Nachrichtenverarbeitungs-Pipeline

Message In
    │
    ├─ Context Router    scores 18 registry skills → top-5 SKILLS_HINT
    ├─ Learnings Loader  reads learnings.md → LEARNINGS block
    ├─ BTW Queue         prepends extra context from BTW mode
    │
    ▼
buildGsdPrompt() assembles: LEARNINGS → BTW → CONTEXT → SKILLS_HINT → TASK
    │
    ▼
claude -p <prompt> --max-turns 20
    │
    ▼
    ├─ Binary Evals      checks response against .evals.json rules
    ├─ Quality Tracker    logs execution event (skills, success, duration)
    │
    ▼
Telegram response + inline buttons + eval footnotes

Feedback-Schleife

Fix It button → addLearning(source: "fixit") → learnings.md → next prompt
Thumbs-down   → addLearning(source: "negative") + logFeedback → metrics
Thumbs-up     → logFeedback(positive: true) → metrics

Nächtlicher Zyklus

03:00 UTC → nightly-improve.ts
  → Read quality-metrics.json per child
  → findUnderperformingSkills(threshold: 80%)
  → Generate proposals
  → Send to CEO via Master Bot Telegram
  → CEO: [Approve] → backup skill.md → mark approved
  → CEO: [Reject] → mark rejected

Infrastruktur

VPS (Contabo)

Dienst	Port	Health-Endpunkt
Master Bot	19210	`/api/master/health`
Child: citadel-v2	19211	`/api/child/health`
Child: pt	19212	`/api/child/health`
MCP Bridge	19200	`/api/health`
Frontend	5173 (dev) / Docker	N/A

Cron-Jobs

Zeitplan	Job
Alle 15 Min.	Git-Sync (Memory-Bridge)
Alle 30 Min.	Morty SRE-Healthcheck
Alle 2 Std.	CFO-Metriken-Aggregation
Täglich	CMO-Statusbericht
Täglich	DB-Backup
Täglich 03:00	Nächtliche Verbesserungsschleife

Logging

Format: Strukturiertes JSONL
Kanäle: system, dialog, error
Speicherort: /var/log/citadel/<bot-name>/
Rotation: täglich (logrotate)
Zugriff: jq . /var/log/citadel/citadel-v2/dialog-$(date +%F).log

Sicherheit

Bot-Tokens: AES-256-GCM Vault (config/vault.json, gitignored)
Verschlüsselungsschlüssel: config/vault-key (automatisch generiert, chmod 600)
Nur CEO-Zugriff: alle Bots prüfen CEO_CHAT_ID bei jeder Nachricht
Keine Zugangsdaten in git (.gitignore + .claudeignore)

Phasenhistorie

Phase	Was gebaut wurde
15	Skills-System, Agents, Blueprints
16	Git-Manager, Projekt-Onboarding
18	Übergeordnetes Eltern-Issue
19	CLI-Befehle, Library, Wrapup/Recall
20	Föderierte Bots, Master Bot + Child Bot-Architektur
20.5	Strukturiertes Logging, Watchdog, Vault, Onboarding
21.0	UI-Templates, Subprocess-Kontrolle, Quality-Tracking
21.1	Qualitätsmetriken-Aggregation, Feedback-Buttons
21.5	Evolutionäre Intelligenz: Evals, Context Router, Learnings, nächtliche Schleife
22-26	CRM-Backend-API, Workspace, Worker, Specs
28-30	Automatische Wissens-Ingest, Onboarding-Assistent
32-34	Wiki, Skills-CRUD, Issues, ARC CLI
36	Cloud PM, Neural Skill Generator, NotebookLM Bridge
37-38	OAuth (Google/GitHub), E-Mail-/Passwort-Auth, ARC CLI-Binary
39	Mobile-responsives CRM
40.10-40.18	Chat-Verlauf, Sage Worker, Benchmarks, Marketplace, Lucide-Icons, Telegram-Vault, Worker-Bots

Für aktuelle Systemdetails siehe Produktübersicht.