mega-brain-ai 1.1.0

package/system/protocols/system/AUTO-LOG-PROTOCOL.md

@@ -0,0 +1,369 @@
+# AUTO-LOG PROTOCOL v1.0.0
+
+> **Versão:** 1.0.0
+> **Criado:** 2025-12-20
+> **Propósito:** Sistema automático de logs que evolui com o projeto
+> **Ativação:** Automática em QUALQUER operação do sistema
+
+---
+
+## FILOSOFIA DO AUTO-LOG
+
+### Princípio Central
+
+O sistema de logs não é apenas documentação - é um **espelho da evolução do projeto e do usuário**. Cada log captura:
+
+1. **O que mudou** (técnico)
+2. **Por que mudou** (contexto)
+3. **Quem impulsionou** (dúvidas/inseguranças do usuário → correções aplicadas)
+4. **O que ficou mais forte** (avanços comprovados)
+
+### Características do Usuário Capturadas
+
+```
+PADRÃO DE EVOLUÇÃO DO USUÁRIO:
+├── Dúvidas → Amarrações → Correções → Avanços
+├── Inseguranças expressas → Sistemas criados para endereçá-las
+├── Perguntas recorrentes → Protocolos automatizados
+└── Frustrações → Otimizações implementadas
+```
+
+---
+
+## GATILHOS DE ATIVAÇÃO
+
+### Comandos Explícitos (com barra)
+```
+/jarvis-full    → FULL PIPELINE REPORT
+/process-jarvis → EXECUTION REPORT
+/ingest         → INGEST REPORT
+/inbox          → INBOX STATUS
+/system-digest  → SYSTEM DIGEST
+/agents         → AGENT ENRICHMENT REPORT
+/dossiers       → DOSSIER STATUS
+/log [tipo]     → Log específico
+```
+
+### Comandos Implícitos (secos)
+```
+"processar"           → Detectar contexto → Log apropriado
+"rodar pipeline"      → EXECUTION REPORT
+"atualizar agentes"   → AGENT ENRICHMENT REPORT
+"ver estado"          → SYSTEM DIGEST
+"o que falta"         → INBOX STATUS
+"resumo"              → FULL PIPELINE REPORT
+```
+
+### Eventos Automáticos
+```
+Fim de processamento      → EXECUTION REPORT automático
+Novo arquivo em INBOX     → INGEST REPORT automático
+Agente atualizado         → AGENT ENRICHMENT automático
+Threshold de role         → ROLE-TRACKING REPORT automático
+Fim de sessão             → SESSION-STATE update automático
+```
+
+---
+
+## ESTRUTURA DO LOG EVOLUTIVO
+
+### Header Dinâmico
+
+Todo log deve começar com:
+
+```markdown
+═══════════════════════════════════════════════════════════════════════════════
+                         [TIPO DO LOG]
+                         v{VERSÃO} • {TIMESTAMP}
+                         Sessão: {ID_SESSAO}
+═══════════════════════════════════════════════════════════════════════════════
+
+📊 CONTEXTO DE EVOLUÇÃO
+───────────────────────────────────────────────────────────────────────────────
+   Versão anterior:   {VERSAO_ANTERIOR}
+   Versão atual:      {VERSAO_ATUAL}
+   Delta:             {O_QUE_MUDOU_EM_RESUMO}
+
+   Gatilho desta sessão:
+   └─ "{FRASE_DO_USUARIO_QUE_INICIOU}"
+```
+
+### Seção de Evolução do Usuário
+
+**OBRIGATÓRIO** em logs de sessão:
+
+```markdown
+═══════════════════════════════════════════════════════════════════════════════
+                         EVOLUÇÃO DO PROJETO
+═══════════════════════════════════════════════════════════════════════════════
+
+🔄 DÚVIDAS → SOLUÇÕES
+───────────────────────────────────────────────────────────────────────────────
+
+   Dúvida expressada:
+   └─ "{DUVIDA_DO_USUARIO}"
+
+   Solução implementada:
+   └─ {DESCRICAO_DA_SOLUCAO}
+
+   Evidência de sucesso:
+   └─ {METRICA_OU_OUTPUT_QUE_COMPROVA}
+
+🎯 INSEGURANÇAS CORRIGIDAS
+───────────────────────────────────────────────────────────────────────────────
+
+   | Insegurança Original | Correção Aplicada | Status |
+   |---------------------|-------------------|--------|
+   | {INSEGURANCA_1}     | {CORRECAO_1}      | ✅     |
+   | {INSEGURANCA_2}     | {CORRECAO_2}      | ✅     |
+
+📈 AVANÇOS COMPROVADOS
+───────────────────────────────────────────────────────────────────────────────
+
+   ┌────────────────────────┬─────────────────────┬─────────────────────────┐
+   │ Área                   │ Antes               │ Depois                  │
+   ├────────────────────────┼─────────────────────┼─────────────────────────┤
+   │ Chunks processados     │ {N_ANTES}           │ {N_DEPOIS} (+{DELTA})   │
+   │ Insights extraídos     │ {N_ANTES}           │ {N_DEPOIS} (+{DELTA})   │
+   │ Dossiês compilados     │ {N_ANTES}           │ {N_DEPOIS} (+{DELTA})   │
+   │ Agentes atualizados    │ {N_ANTES}           │ {N_DEPOIS} (+{DELTA})   │
+   └────────────────────────┴─────────────────────┴─────────────────────────┘
+```
+
+---
+
+## DETECÇÃO AUTOMÁTICA DE CONTEXTO
+
+### Análise de Mensagens do Usuário
+
+O sistema deve analisar as mensagens do usuário para detectar:
+
+```python
+PATTERNS = {
+    # Dúvidas
+    "cadê": "usuario_procurando_algo",
+    "como faço": "usuario_precisa_instrucao",
+    "não entendi": "usuario_confuso",
+    "está certo": "usuario_validando",
+
+    # Inseguranças
+    "tenho medo": "inseguranca_declarada",
+    "não sei se": "incerteza",
+    "será que": "duvida_existencial",
+
+    # Comandos implícitos
+    "processar tudo": "full_pipeline",
+    "rodar": "executar",
+    "atualizar": "refresh",
+    "sincronizar": "sync",
+
+    # Frustração
+    "de novo": "repetição_problema",
+    "ainda": "problema_persistente",
+    "sempre": "padrão_recorrente"
+}
+```
+
+### Mapeamento de Intenção → Log
+
+```
+INTENÇÃO DETECTADA          →  LOG GERADO
+────────────────────────────────────────────────
+processar_fonte             →  EXECUTION REPORT
+verificar_estado            →  SYSTEM DIGEST
+ver_pendentes               →  INBOX STATUS
+atualizar_agentes           →  AGENT ENRICHMENT
+criar_agente                →  ROLE-TRACKING
+pipeline_completo           →  FULL PIPELINE REPORT
+ingerir_material            →  INGEST REPORT
+fim_sessao                  →  SESSION UPDATE + EVOLUTION LOG
+```
+
+---
+
+## LOGS ENCADEADOS
+
+### Hierarquia de Logs
+
+```
+FULL PIPELINE REPORT (agregador)
+├── INGEST REPORT (entrada)
+├── EXECUTION REPORT (processamento)
+│   ├── CHUNKS-STATE update
+│   ├── INSIGHTS-STATE update
+│   └── NARRATIVES-STATE update
+├── AGENT ENRICHMENT REPORT (distribuição)
+│   └── ROLE-TRACKING REPORT (se threshold)
+└── SESSION UPDATE (estado final)
+    └── EVOLUTION LOG entry (mudança estrutural)
+```
+
+### Auto-Encadeamento
+
+Quando um log é gerado, ele deve:
+1. Verificar se há logs anteriores na sessão
+2. Linkar com logs relacionados
+3. Atualizar contadores globais
+4. Propagar mudanças para arquivos de estado
+
+---
+
+## PERSONALIZAÇÃO POR PADRÃO DO USUÁRIO
+
+### Padrões Identificados deste Usuário
+
+```yaml
+usuario_owner:
+  estilo_aprendizado: "dúvidas e amarrações"
+  necessidade_principal: "correção de inseguranças"
+  preferencia_output: "logs detalhados com evidências"
+  gatilhos_comuns:
+    - "cadê o log"
+    - "comece de novo"
+    - "rode tudo"
+    - "me dê o log"
+  expectativas:
+    - logs entre cada etapa
+    - evidência de progresso
+    - sincronização total
+    - automação sem perguntas
+```
+
+### Customizações Aplicadas
+
+```
+PARA ESTE USUÁRIO:
+├── Logs mais detalhados (não omitir passos)
+├── Evidências explícitas de sucesso
+├── Comparações antes/depois sempre visíveis
+├── Timeline visual do progresso
+├── Confirmação de que inseguranças foram endereçadas
+└── Histórico de evolução sempre presente
+```
+
+---
+
+## INTEGRAÇÃO COM COMANDOS
+
+### Hook de Pré-Execução
+
+Antes de QUALQUER comando, verificar:
+
+```
+1. Qual é a intenção do usuário?
+2. Qual log será gerado ao final?
+3. Há logs pendentes de sessão anterior?
+4. O estado atual está sincronizado?
+```
+
+### Hook de Pós-Execução
+
+Após QUALQUER operação:
+
+```
+1. Gerar log apropriado automaticamente
+2. Atualizar arquivos de estado
+3. Verificar se houve mudança estrutural → EVOLUTION LOG
+4. Comparar com estado anterior → métricas de progresso
+```
+
+---
+
+## TEMPLATE: LOG DE SESSÃO EVOLUTIVO
+
+```markdown
+═══════════════════════════════════════════════════════════════════════════════
+                    SESSÃO {DATA} - LOG EVOLUTIVO
+                    Sistema Mega Brain v{VERSAO}
+═══════════════════════════════════════════════════════════════════════════════
+
+📋 RESUMO EXECUTIVO
+───────────────────────────────────────────────────────────────────────────────
+
+   Início:         {TIMESTAMP_INICIO}
+   Fim:            {TIMESTAMP_FIM}
+   Duração:        {DURACAO}
+
+   Gatilho:        "{FRASE_INICIAL_USUARIO}"
+   Objetivo:       {OBJETIVO_INFERIDO}
+   Resultado:      {SUCESSO/PARCIAL/FALHA}
+
+═══════════════════════════════════════════════════════════════════════════════
+                    JORNADA DO USUÁRIO
+═══════════════════════════════════════════════════════════════════════════════
+
+🔄 FLUXO DE EVOLUÇÃO
+───────────────────────────────────────────────────────────────────────────────
+
+   {TIMESTAMP_1}
+   ├─ Usuário: "{MENSAGEM_1}"
+   ├─ Intenção detectada: {INTENCAO}
+   ├─ Ação executada: {ACAO}
+   └─ Resultado: {RESULTADO}
+
+   {TIMESTAMP_2}
+   ├─ Usuário: "{MENSAGEM_2}"
+   ...
+
+📊 PONTOS DE CORREÇÃO
+───────────────────────────────────────────────────────────────────────────────
+
+   | # | Dúvida/Insegurança | Correção | Evidência |
+   |---|---------------------|----------|-----------|
+   | 1 | {DUVIDA}            | {CORR}   | {EVID}    |
+   | 2 | {DUVIDA}            | {CORR}   | {EVID}    |
+
+═══════════════════════════════════════════════════════════════════════════════
+                    MÉTRICAS DE PROGRESSO
+═══════════════════════════════════════════════════════════════════════════════
+
+📈 ANTES vs DEPOIS
+───────────────────────────────────────────────────────────────────────────────
+
+   ┌──────────────────────────┬───────────┬───────────┬───────────┐
+   │ Métrica                  │ Início    │ Fim       │ Delta     │
+   ├──────────────────────────┼───────────┼───────────┼───────────┤
+   │ CHUNKS-STATE             │ {N}       │ {N}       │ +{N}      │
+   │ INSIGHTS-STATE           │ {N}       │ {N}       │ +{N}      │
+   │ NARRATIVES-STATE         │ {N}       │ {N}       │ +{N}      │
+   │ DOSSIERS                 │ {N}       │ {N}       │ +{N}      │
+   │ AGENTS ATUALIZADOS       │ {N}       │ {N}       │ +{N}      │
+   │ EXECUTION REPORTS        │ {N}       │ {N}       │ +{N}      │
+   └──────────────────────────┴───────────┴───────────┴───────────┘
+
+🎯 OBJETIVOS ALCANÇADOS
+───────────────────────────────────────────────────────────────────────────────
+
+   ✅ {OBJETIVO_1}
+   ✅ {OBJETIVO_2}
+   ⏸️ {OBJETIVO_PENDENTE} (próxima sessão)
+
+═══════════════════════════════════════════════════════════════════════════════
+                    PRÓXIMAS AÇÕES
+═══════════════════════════════════════════════════════════════════════════════
+
+   🔴 IMEDIATO:
+      {ACAO_CRITICA}
+
+   🟡 RECOMENDADO:
+      {ACAO_RECOMENDADA}
+
+   🟢 OPCIONAL:
+      {ACAO_OPCIONAL}
+
+═══════════════════════════════════════════════════════════════════════════════
+                    FIM DO LOG DE SESSÃO
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## CHANGELOG
+
+| Versão | Data | Mudanças |
+|--------|------|----------|
+| v1.0.0 | 2025-12-20 | Versão inicial - Sistema Auto-Log completo |
+
+---
+
+*Este protocolo é executado automaticamente. Não requer ativação manual.*

package/system/protocols/system/CHECKPOINT-ENFORCEMENT.md

@@ -0,0 +1,176 @@
+# CHECKPOINT ENFORCEMENT PROTOCOL
+
+> **Versão:** 1.0.0
+> **Pipeline:** Jarvis → Todas as Etapas
+> **Propósito:** Bloquear execução de etapas sem pré-requisitos
+
+---
+
+## PRINCÍPIO FUNDAMENTAL
+
+```
+⛔ NENHUMA ETAPA PODE EXECUTAR SEM VALIDAR CHECKPOINTS ANTERIORES
+```
+
+---
+
+## MAPA DE DEPENDÊNCIAS
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         PIPELINE JARVIS v2.0                            │
+│                                                                         │
+│  [ETAPA 1.1] ──────────────────────────────────────────────────────────┐│
+│  CHUNKING                                                               ││
+│  ├─ INPUT: Transcrição bruta (inbox/*.txt)                          ││
+│  ├─ OUTPUT: CHUNKS-STATE.json                                          ││
+│  └─ CHECKPOINT: Arquivo existe + chunks[] não vazio                    ││
+│                              │                                          ││
+│                              ▼                                          ││
+│  [ETAPA 1.2] ──────────────────────────────────────────────────────────┐││
+│  ENTITY RESOLUTION                                                      │││
+│  ├─ REQUIRES: CHUNKS-STATE.json com chunks                             │││
+│  ├─ OUTPUT: CANONICAL-MAP.json                                         │││
+│  └─ CHECKPOINT: canonical_state existe + entities mapeadas             │││
+│                              │                                          │││
+│                              ▼                                          │││
+│  [ETAPA 2.1] ──────────────────────────────────────────────────────────┐││││
+│  INSIGHT EXTRACTION                                                     │││││
+│  ├─ REQUIRES: CHUNKS-STATE.json + CANONICAL-MAP.json                   │││││
+│  ├─ OUTPUT: INSIGHTS-STATE.json                                        │││││
+│  └─ CHECKPOINT: insights_state com persons{} e themes{} não vazios     │││││
+│                              │                                          │││││
+│                              ▼                                          │││││
+│  [ETAPA 3.1] ──────────────────────────────────────────────────────────┐│││││
+│  NARRATIVE SYNTHESIS                                                    ││││││
+│  ├─ REQUIRES: INSIGHTS-STATE.json com insights                         ││││││
+│  ├─ OUTPUT: NARRATIVES-STATE.json                                      ││││││
+│  └─ CHECKPOINT: persons{} e themes{} com narrativas                    ││││││
+│                              │                                          ││││││
+│                              ▼                                          ││││││
+│  [ETAPA 4.0] ──────────────────────────────────────────────────────────┐││││││
+│  DOSSIER COMPILATION                                                    │││││││
+│  ├─ REQUIRES: NARRATIVES-STATE.json                                    │││││││
+│  ├─ OUTPUT: DOSSIER-*.md em /knowledge/dossiers/                    │││││││
+│  └─ CHECKPOINT: Dossiês gerados para cada entidade com narrativa       │││││││
+│                                                                         │││││││
+└─────────────────────────────────────────────────────────────────────────┘││││││
+```
+
+---
+
+## CHECKPOINTS OBRIGATÓRIOS
+
+### ANTES DE ETAPA 1.1 (Chunking)
+
+| Checkpoint | Validação | Ação se Falhar |
+|------------|-----------|----------------|
+| CP-1.1.A | Arquivo de transcrição existe | ⛔ PARAR - "Arquivo não encontrado" |
+| CP-1.1.B | Arquivo tem conteúdo (> 100 chars) | ⛔ PARAR - "Transcrição vazia ou muito curta" |
+| CP-1.1.C | Metadados identificáveis (fonte) | ⚠️ WARN - "Fonte não identificada, usar UNKNOWN" |
+
+### ANTES DE ETAPA 1.2 (Entity Resolution)
+
+| Checkpoint | Validação | Ação se Falhar |
+|------------|-----------|----------------|
+| CP-1.2.A | CHUNKS-STATE.json existe | ⛔ PARAR - "Execute Etapa 1.1 primeiro" |
+| CP-1.2.B | chunks[] tem elementos | ⛔ PARAR - "Nenhum chunk para processar" |
+| CP-1.2.C | Cada chunk tem id_chunk único | ⛔ PARAR - "Chunks com IDs duplicados" |
+
+### ANTES DE ETAPA 2.1 (Insight Extraction)
+
+| Checkpoint | Validação | Ação se Falhar |
+|------------|-----------|----------------|
+| CP-2.1.A | CHUNKS-STATE.json existe | ⛔ PARAR - "Execute Etapa 1.1 primeiro" |
+| CP-2.1.B | CANONICAL-MAP.json existe | ⛔ PARAR - "Execute Etapa 1.2 primeiro" |
+| CP-2.1.C | canonical_state tem entidades | ⚠️ WARN - "Sem entidades canônicas, usar nomes raw" |
+
+### ANTES DE ETAPA 3.1 (Narrative Synthesis)
+
+| Checkpoint | Validação | Ação se Falhar |
+|------------|-----------|----------------|
+| CP-3.1.A | INSIGHTS-STATE.json existe | ⛔ PARAR - "Execute Etapa 2.1 primeiro" |
+| CP-3.1.B | insights_state.persons não vazio | ⚠️ WARN - "Sem insights de pessoas" |
+| CP-3.1.C | insights_state.themes não vazio | ⚠️ WARN - "Sem insights de temas" |
+
+### ANTES DE ETAPA 4.0 (Dossier Compilation)
+
+| Checkpoint | Validação | Ação se Falhar |
+|------------|-----------|----------------|
+| CP-4.0.A | NARRATIVES-STATE.json existe | ⛔ PARAR - "Execute Etapa 3.1 primeiro" |
+| CP-4.0.B | Pelo menos 1 pessoa com narrativa | ⛔ PARAR - "Nenhuma narrativa para compilar" |
+| CP-4.0.C | open_loops identificados | ⚠️ WARN - "Verificar open_loops pendentes" |
+
+---
+
+## MENSAGENS DE ERRO PADRONIZADAS
+
+```
+⛔ CHECKPOINT FALHOU: {código}
+   Etapa: {etapa_atual}
+   Requisito: {descrição}
+   Ação: {ação_necessária}
+
+   Execute: {comando_ou_etapa_anterior}
+```
+
+**Exemplo:**
+```
+⛔ CHECKPOINT FALHOU: CP-2.1.B
+   Etapa: 2.1 (Insight Extraction)
+   Requisito: CANONICAL-MAP.json deve existir
+   Ação: Entity Resolution não foi executado
+
+   Execute: Etapa 1.2 antes de continuar
+```
+
+---
+
+## VALIDAÇÃO DE INTEGRIDADE (opcional)
+
+Script de validação rápida:
+
+```bash
+# Verificar estado do pipeline
+python scripts/pipeline_validator.py --check
+
+# Output esperado:
+# ✅ CHUNKS-STATE.json: 96 chunks
+# ✅ CANONICAL-MAP.json: 15 entidades
+# ✅ INSIGHTS-STATE.json: 3 persons, 5 themes
+# ✅ NARRATIVES-STATE.json: 3 persons, 5 themes
+#
+# Pipeline Status: READY para Etapa 4.0
+```
+
+---
+
+## INTEGRAÇÃO COM PROTOCOLOS
+
+Cada prompt de etapa DEVE iniciar com:
+
+```
+ANTES DE EXECUTAR, VALIDE:
+[ ] Checkpoint {X} passou
+[ ] Checkpoint {Y} passou
+[ ] Checkpoint {Z} passou
+
+Se qualquer checkpoint falhar: PARE e reporte o erro.
+```
+
+---
+
+## REGRAS INVIOLÁVEIS
+
+1. **NUNCA pular etapas** - Mesmo que pareça desnecessário
+2. **NUNCA ignorar ⛔ PARAR** - Warnings (⚠️) podem continuar, PARADAs não
+3. **SEMPRE reportar** - Qual checkpoint falhou e por quê
+4. **RASTREABILIDADE** - Logar qual checkpoint foi validado
+
+---
+
+## CHANGELOG
+
+| Versão | Data | Mudança |
+|--------|------|---------|
+| 1.0.0 | 2025-12-18 | Criação inicial do protocolo |