Raport systemowy — Phase 21.5 (Historyczny)

Historyczny snapshot Arc OS po integracji Evolutionary Intelligence. Uwaga: Ten dokument odzwierciedla stan systemu na etapie Phase 21.5. Obecny system jest na etapie Phase 40.18 z ponad 62 endpointami API, dashboardem CRM, OAuth, Sage Worker i nie tylko. Aktualna dokumentacja: Przewodnik użytkownika oraz Przegląd produktu.

Podsumowanie systemu

Metryka	Wartość
Główny TypeScript (shared + boty + skrypty)	3 298 linii
Moduły shared	7
Zarejestrowane skille (rejestr)	18
Skille biblioteczne	7
Łącznie skilli	25
Typy reguł eval	6
Pilotażowe zestawy reguł eval	3 (łącznie 9 reguł)
Agenty	6
Child boty (produkcja)	2
Commity Git	36
Dostarczone fazy	15 → 21.5
Własny kod backendowy	0 linii

Architektura

                    ┌──────────────────────────────────┐
                    │       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        │             │  (no bridge yet)   │
        │  SSE + HTTP API    │             │                    │
        └────────┬──────────┘             └───────────────────┘
                 │
                 ▼
        ┌───────────────────┐
        │  Phaser.js Frontend│
        │  Port 5173 (dev)   │
        │  Visual AI Office  │
        └───────────────────┘

Mapa modułów

shared/ (7 modułów, 1 124 linie)

Moduł	Linie	Faza	Przeznaczenie
`logger.ts`	189	20.5	Strukturalne logowanie JSONL: kanały system/dialog/error, dzienny obrót
`vault.ts`	216	20.5	Zaszyfrowane przechowywanie sekretów AES-256-GCM: initVault, getSecret, setSecret
`quality.ts`	192	21.1+21.5	Śledzenie wykonania/feedbacku, agregacja, wykrywanie słabo działających elementów
`ui_templates.ts`	158	21.0+21.5	Klawiatury Telegram: menu mastera, karty projektów, przyciski child botów, propozycje ulepszeń
`evals.ts`	142	21.5	Silnik Binary Evals: 6 typów reguł, checkOutput, formatWarnings
`context-router.ts`	117	21.5	Punktacja skilli: dopasowanie trigger/słów kluczowych, generowanie SKILLS_HINT
`learnings.ts`	110	21.5	Trwałe korekty: ładowanie/dodawanie/formatowanie learnings z Markdown

Środowiska uruchomieniowe botów (1 937 linii)

Plik	Linie	Przeznaczenie
`child-bot/bot.ts`	944	Proxy Telegram–Claude CLI z warstwą intelligence
`master-bot/bot.ts`	993	Orkiestrator: komendy, karty projektów, Watchdog, zatwierdzanie ulepszeń

Skrypty (237 linii)

Plik	Linie	Przeznaczenie
`scripts/nightly-improve.ts`	237	Karpathy Loop: analiza metryk → propozycje ulepszeń → Telegram do CEO

Inwentarz skilli

Skille rejestrowe (18)

Skill	Kategoria	Faza	Evale
handoff-protocol	complex, skill_injection	15.2	-
code-review	complex	15.3	3 reguły
system-audit	complex	15.3	3 reguły
git-manager	complex, skill_injection	16	3 reguły
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	-

Skille biblioteczne (7)

Skill	Dziedzina
docker-ops	Orkiestracja kontenerów
figma-design	Pipeline design-to-code
github-actions	Workflow CI/CD
odoo-expert	Programowanie Odoo ERP
odoo-owl-expert	Framework Odoo Owl
plasthetica-style-guide	Przewodnik stylu projektu
postgres-pro	Optymalizacja PostgreSQL

Warstwa Intelligence (Phase 21.5)

Pipeline przetwarzania wiadomości

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

Pętla feedbacku

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

Cykl nocny

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

Infrastruktura

VPS (Contabo)

Usługa	Port	Endpoint zdrowia
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

Zadania cron

Harmonogram	Zadanie
Co 15 min	Synchronizacja Git (memory bridge)
Co 30 min	Kontrola stanu SRE przez Morty
Co 2 h	Agregacja metryk CFO
Codziennie	Raport statusu CMO
Codziennie	Backup bazy danych
Codziennie 03:00	Nocna pętla ulepszeń

Logowanie

Format: Strukturalny JSONL
Kanały: system, dialog, error
Lokalizacja: /var/log/citadel/<bot-name>/
Rotacja: dzienna (logrotate)
Dostęp: jq . /var/log/citadel/citadel-v2/dialog-$(date +%F).log

Bezpieczeństwo

Tokeny botów: Vault AES-256-GCM (config/vault.json, dodany do .gitignore)
Klucz szyfrowania: config/vault-key (automatycznie generowany, chmod 600)
Dostęp tylko dla CEO: wszystkie boty sprawdzają CEO_CHAT_ID przy każdej wiadomości
Brak poświadczeń w git (.gitignore + .claudeignore)

Historia faz

Faza	Co zostało zbudowane
15	System skilli, agenty, blueprinty
16	Git manager, onboarding projektów
18	Nadrzędny issue paragwolowy
19	Komendy CLI, biblioteka, wrapup/recall
20	Federacja botów, architektura Master + Child
20.5	Strukturalne logowanie, Watchdog, Vault, onboarding
21.0	Szablony UI, kontrola podprocesów, śledzenie jakości
21.1	Agregacja metryk jakości, przyciski feedbacku
21.5	Evolutionary Intelligence: evale, Context Router, learnings, nocna pętla
22-26	Backend API CRM, Workspace, workery, specyfikacje
28-30	Automatyczne pobieranie wiedzy, kreator onboardingu
32-34	Wiki, CRUD skilli, issues, ARC CLI
36	Cloud PM, Neural Skill Generator, NotebookLM Bridge
37-38	OAuth (Google/GitHub), uwierzytelnianie email/hasło, binarka ARC CLI
39	Responsywny mobilnie CRM
40.10-40.18	Historia czatu, Sage Worker, benchmarki, marketplace, ikony Lucide, Vault Telegram, boty workerów

Aktualne szczegóły systemu znajdziesz w Przeglądzie produktu.