Системний звіт — Phase 21.5 (Історичний)

Історичний знімок Arc OS після інтеграції Evolutionary Intelligence. Примітка: Цей документ відображає стан системи на Phase 21.5. Поточна система знаходиться на Phase 40.18 з 62+ API endpoints, CRM dashboard, OAuth, Sage Worker та іншим. Дивись Посібник користувача і Огляд продукту для актуальної документації.

Підсумок системи

Метрика	Значення
Основний TypeScript (shared + bots + scripts)	3 298 рядків
Shared-модулі	7
Зареєстровані скіли (registry)	18
Скіли з бібліотеки	7
Загалом скілів	25
Типи правил eval	6
Пілотні набори eval-правил	3 (загалом 9 правил)
Агентів	6
Child bots (production)	2
Git-коміти	36
Виконані фази	15 → 21.5
Власний backend-код	0 рядків

Архітектура

                    ┌──────────────────────────────────┐
                    │       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  │
        └───────────────────┘

Карта модулів

shared/ (7 модулів, 1 124 рядки)

Модуль	Рядків	Phase	Призначення
`logger.ts`	189	20.5	Структуроване JSONL-логування: канали system/dialog/error, щоденна ротація
`vault.ts`	216	20.5	Зашифроване AES-256-GCM сховище секретів: initVault, getSecret, setSecret
`quality.ts`	192	21.1+21.5	Трекінг виконання/фідбеку, агрегація, виявлення слабких місць
`ui_templates.ts`	158	21.0+21.5	Telegram-клавіатури: меню master, картки проєктів, кнопки child, пропозиції покращень
`evals.ts`	142	21.5	Двійковий eval-движок: 6 типів правил, checkOutput, formatWarnings
`context-router.ts`	117	21.5	Скоринг скілів: збіг trigger/keyword, генерація SKILLS_HINT
`learnings.ts`	110	21.5	Постійні корекції: load/add/format learnings з markdown

Bot runtimes (1 937 рядків)

Файл	Рядків	Призначення
`child-bot/bot.ts`	944	Telegram-Claude CLI-проксі з інтеграцією шару intelligence
`master-bot/bot.ts`	993	Оркестратор: команди, картки проєктів, watchdog, схвалення покращень

Скрипти (237 рядків)

Файл	Рядків	Призначення
`scripts/nightly-improve.ts`	237	Karpathy Loop: аналіз метрик → пропозиції покращень → CEO Telegram

Інвентар скілів

Registry-скіли (18)

Скіл	Категорія	Phase	Evals
handoff-protocol	complex, skill_injection	15.2	-
code-review	complex	15.3	3 правила
system-audit	complex	15.3	3 правила
git-manager	complex, skill_injection	16	3 правила
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	-

Скіли з бібліотеки (7)

Скіл	Домен
docker-ops	Оркестрація контейнерів
figma-design	Pipeline design-to-code
github-actions	CI/CD-воркфлоу
odoo-expert	Розробка Odoo ERP
odoo-owl-expert	Фреймворк Odoo Owl
plasthetica-style-guide	Project-specific style guide
postgres-pro	Оптимізація PostgreSQL

Шар Intelligence (Phase 21.5)

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

Цикл фідбеку

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

Нічний цикл

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

Інфраструктура

VPS (Contabo)

Сервіс	Порт	Health Endpoint
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-задачі

Розклад	Задача
Кожні 15 хв	Git sync (memory bridge)
Кожні 30 хв	Morty SRE health check
Кожні 2 год	Агрегація CFO-метрик
Щодня	CMO status report
Щодня	DB backup
Щодня 03:00	Нічний цикл покращень

Логування

Формат: Структурований JSONL
Канали: system, dialog, error
Розташування: /var/log/citadel/<bot-name>/
Ротація: щоденна (logrotate)
Доступ: jq . /var/log/citadel/citadel-v2/dialog-$(date +%F).log

Безпека

Bot-токени: AES-256-GCM vault (config/vault.json, gitignored)
Ключ шифрування: config/vault-key (auто-генерація, chmod 600)
Доступ лише для CEO: всі боти перевіряють CEO_CHAT_ID на кожному повідомленні
Жодних креденшалів у git (.gitignore + .claudeignore)

Історія фаз

Phase	Що було реалізовано
15	Система скілів, агенти, blueprints
16	Git manager, project onboarding
18	Parent umbrella issue
19	CLI-команди, бібліотека, wrapup/recall
20	Федеративні боти, архітектура Master + Child
20.5	Структуроване логування, watchdog, vault, onboarding
21.0	UI-шаблони, контроль subprocess, трекінг якості
21.1	Агрегація метрик якості, кнопки фідбеку
21.5	Evolutionary Intelligence: evals, context router, learnings, nightly loop
22-26	CRM Backend API, Workspace, Workers, специфікації
28-30	Авто-інжест знань, майстер онбордингу
32-34	Wiki, CRUD скілів, Issues, ARC CLI
36	Cloud PM, Neural Skill Generator, NotebookLM Bridge
37-38	OAuth (Google/GitHub), email/password-авторизація, ARC CLI binary
39	Мобільно-адаптивний CRM
40.10-40.18	Історія чату, Sage Worker, benchmarks, marketplace, іконки Lucide, Telegram vault, воркер-боти

Для актуальних деталей системи дивись Огляд продукту.