Системный отчёт — Phase 21.5 (исторический)

Исторический снимок Arc OS после интеграции Evolutionary Intelligence. Примечание: Этот документ отражает состояние системы на Phase 21.5. Текущая система находится на Phase 40.18 с 62+ API endpoints, CRM дашбордом, OAuth, Sage Worker и многим другим. Актуальная документация — в Руководстве пользователя и Обзоре продукта.

Сводка системы

Метрика	Значение
Основной TypeScript (shared + bots + scripts)	3 298 строк
Shared-модули	7
Зарегистрированных скилов (registry)	18
Библиотечных скилов	7
Всего скилов	25
Типов правил для eval	6
Пилотных наборов правил eval	3 (9 правил итого)
Агенты	6
Child Bot'ы (production)	2
Коммиты в git	36
Выпущено фаз	15 → 21.5
Кастомный бэкенд-код	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 строки)

Модуль	Строки	Фаза	Назначение
`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 Bot, карточки проектов, кнопки Child Bot, предложения по улучшениям
`evals.ts`	142	21.5	Движок Binary Evals: 6 типов правил, checkOutput, formatWarnings
`context-router.ts`	117	21.5	Скоринг скилов: матчинг по триггерам/ключевым словам, генерация SKILLS_HINT
`learnings.ts`	110	21.5	Персистентные корректировки: загрузка/добавление/форматирование learnings из Markdown

Bot-рантаймы (1 937 строк)

Файл	Строки	Назначение
`child-bot/bot.ts`	944	Telegram–Claude CLI прокси с интеграцией intelligence layer
`master-bot/bot.ts`	993	Оркестратор: команды, карточки проектов, Watchdog, апрув улучшений

Скрипты (237 строк)

Файл	Строки	Назначение
`scripts/nightly-improve.ts`	237	Karpathy Loop: анализ метрик → предложения по улучшениям → Telegram CEO

Инвентарь скилов

Registry-скилы (18)

Скил	Категория	Фаза	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	Пайплайн design-to-code
github-actions	CI/CD воркфлоу
odoo-expert	Разработка на Odoo ERP
odoo-owl-expert	Фреймворк Odoo Owl
plasthetica-style-guide	Стайл-гайд проекта
postgres-pro	Оптимизация PostgreSQL

Intelligence Layer (Phase 21.5)

Пайплайн обработки сообщений

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-синк (memory bridge)
Каждые 30 мин	Morty SRE health check
Каждые 2 ч	Агрегация метрик CFO
Ежедневно	Статус-отчёт CMO
Ежедневно	Резервное копирование DB
Ежедневно 03:00	Ночной цикл улучшений

Логирование

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

Безопасность

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

История фаз

Фаза	Что было реализовано
15	Система скилов, агенты, blueprints
16	Git manager, онбординг проекта
18	Родительская umbrella-задача
19	CLI-команды, библиотека, wrapup/recall
20	Федеративные боты, архитектура Master + Child
20.5	Структурированное логирование, Watchdog, Vault, онбординг
21.0	UI-шаблоны, управление подпроцессами, трекинг качества
21.1	Агрегация метрик качества, кнопки обратной связи
21.5	Evolutionary Intelligence: evals, Context Router, learnings, ночной цикл
22-26	CRM Backend API, Workspace, воркеры, Specs
28-30	Автоматический инжест знаний, онбординг-визард
32-34	Вики, CRUD скилов, задачи, ARC CLI
36	Cloud PM, Neural Skill Generator, NotebookLM Bridge
37-38	OAuth (Google/GitHub), аутентификация по email/паролю, бинарник ARC CLI
39	Адаптивный CRM под мобильные устройства
40.10-40.18	История чатов, Sage Worker, бенчмарки, marketplace, иконки Lucide, Vault для Telegram, воркер-боты

Актуальные сведения о системе — в Обзоре продукта.