Relatório do Sistema — Phase 21.5 (Histórico)

Snapshot histórico do Arc OS após a integração da Inteligência Evolutiva. Nota: Este documento reflete o estado do sistema na Phase 21.5. O sistema atual está na Phase 40.18 com 62+ endpoints de API, dashboard CRM, OAuth, Sage Worker e mais. Consulte o Guia do Usuário e a Visão Geral do Produto para a documentação atual.

Resumo do Sistema

Métrica	Valor
TypeScript principal (shared + bots + scripts)	3.298 linhas
Módulos compartilhados	7
Skills registradas (registry)	18
Skills da biblioteca	7
Total de skills	25
Tipos de regras de eval	6
Conjuntos de regras de eval piloto	3 (9 regras no total)
Agentes	6
Child bots (produção)	2
Commits Git	36
Phases entregues	15 → 21.5
Código de backend customizado	0 linhas

Arquitetura

                    ┌──────────────────────────────────┐
                    │       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 de Módulos

shared/ (7 módulos, 1.124 linhas)

Módulo	Linhas	Phase	Finalidade
`logger.ts`	189	20.5	Logging estruturado em JSONL: canais system/dialog/error, rotação diária
`vault.ts`	216	20.5	Armazenamento de segredos criptografados com AES-256-GCM: initVault, getSecret, setSecret
`quality.ts`	192	21.1+21.5	Rastreamento de execução e feedback, agregação, detecção de baixo desempenho
`ui_templates.ts`	158	21.0+21.5	Teclados Telegram: menu master, cards de projetos, botões child, propostas de melhoria
`evals.ts`	142	21.5	Motor de Binary Evals: 6 tipos de regras, checkOutput, formatWarnings
`context-router.ts`	117	21.5	Pontuação de skills: correspondência de triggers/palavras-chave, geração de SKILLS_HINT
`learnings.ts`	110	21.5	Correções persistentes: carrega/adiciona/formata learnings a partir de markdown

Runtimes dos bots (1.937 linhas)

Arquivo	Linhas	Finalidade
`child-bot/bot.ts`	944	Proxy Telegram-Claude CLI com integração da camada de inteligência
`master-bot/bot.ts`	993	Orquestrador: comandos, cards de projetos, Watchdog, aprovação de melhorias

Scripts (237 linhas)

Arquivo	Linhas	Finalidade
`scripts/nightly-improve.ts`	237	Karpathy Loop: análise de métricas → propostas de melhoria → Telegram do CEO

Inventário de Skills

Skills do Registry (18)

Skill	Categoria	Phase	Evals
handoff-protocol	complex, skill_injection	15.2	-
code-review	complex	15.3	3 regras
system-audit	complex	15.3	3 regras
git-manager	complex, skill_injection	16	3 regras
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	-

Skills da Biblioteca (7)

Skill	Domínio
docker-ops	Orquestração de containers
figma-design	Pipeline de design para código
github-actions	Workflows de CI/CD
odoo-expert	Desenvolvimento Odoo ERP
odoo-owl-expert	Framework Odoo Owl
plasthetica-style-guide	Guia de estilo específico do projeto
postgres-pro	Otimização PostgreSQL

Camada de Inteligência (Phase 21.5)

Pipeline de Processamento de Mensagens

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

Ciclo de Feedback

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

Ciclo Noturno

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

Infraestrutura

VPS (Contabo)

Serviço	Porta	Endpoint de Health
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

Agendamento	Tarefa
A cada 15min	Sincronização Git (memory bridge)
A cada 30min	Verificação de saúde do Morty SRE
A cada 2h	Agregação de métricas do CFO
Diariamente	Relatório de status do CMO
Diariamente	Backup do DB
Diariamente às 03:00	Loop noturno de melhorias

Logging

Formato: JSONL estruturado
Canais: system, dialog, error
Localização: /var/log/citadel/<bot-name>/
Rotação: diária (logrotate)
Acesso: jq . /var/log/citadel/citadel-v2/dialog-$(date +%F).log

Segurança

Tokens dos bots: Vault AES-256-GCM (config/vault.json, no gitignore)
Chave de criptografia: config/vault-key (gerada automaticamente, chmod 600)
Acesso restrito ao CEO: todos os bots verificam CEO_CHAT_ID em cada mensagem
Nenhuma credencial no Git (.gitignore + .claudeignore)

Histórico de Phases

Phase	O que foi construído
15	Sistema de skills, agentes, blueprints
16	Git manager, onboarding de projetos
18	Issue-pai guarda-chuva
19	Comandos CLI, biblioteca, wrapup/recall
20	Bots federados, arquitetura Master + Child
20.5	Logging estruturado, Watchdog, Vault, onboarding
21.0	Templates de UI, controle de subprocessos, rastreamento de qualidade
21.1	Agregação de métricas de qualidade, botões de feedback
21.5	Inteligência Evolutiva: evals, Context Router, learnings, loop noturno
22-26	API de backend CRM, Workspace, Workers, Specs
28-30	Auto-ingestão de conhecimento, wizard de onboarding
32-34	Wiki, CRUD de skills, issues, ARC CLI
36	Cloud PM, Neural Skill Generator, NotebookLM Bridge
37-38	OAuth (Google/GitHub), autenticação por email/senha, binário ARC CLI
39	CRM responsivo para mobile
40.10-40.18	Histórico de chat, Sage Worker, benchmarks, marketplace, ícones Lucide, Vault Telegram, worker bots

Para detalhes do sistema atual, consulte a Visão Geral do Produto.