mega-brain-ai 1.1.0

package/.claude/commands/jarvis-briefing.md

@@ -0,0 +1,67 @@
+# /jarvis-briefing - Status Operacional Completo
+
+Gera um briefing operacional completo no estilo JARVIS.
+
+## Uso
+
+```
+/jarvis-briefing          # Modo completo (default)
+/jarvis-briefing --compact # Versão resumida
+/jarvis-briefing --full    # Versão completa explícita
+```
+
+## Execução
+
+Este comando invoca o skill completo em `.claude/skills/jarvis-briefing/SKILL.md`.
+
+### 1. Carregar Estado do Sistema
+
+Ler os seguintes arquivos:
+
+```
+.claude/jarvis/STATE.json         # Estado global
+.claude/jarvis/PENDING.md         # Pendências
+.claude/jarvis/JARVIS-MEMORY.md   # Memória relacional
+.claude/jarvis/CURRENT-TASK.md    # Tarefa atual
+.claude/mission-control/MISSION-STATE.json  # Estado da missão
+processing/insights/INSIGHTS-STATE.json  # Insights acumulados
+```
+
+### 2. Calcular Health Score (0-100)
+
+| Componente | Peso | Cálculo |
+|------------|------|---------|
+| Progresso Geral | 30pts | (files_processed / total_files) * 30 |
+| Fontes Completas | 25pts | (sources_complete / total_sources) * 25 |
+| Pendências Baixas | 20pts | max(0, 20 - (pending_high * 5) - (pending_medium * 2)) |
+| Estado Atualizado | 15pts | 15 se state < 3 dias, 10 se < 7 dias, 0 se > 7 dias |
+| Pipeline Limpo | 10pts | 10 se errors_pending = 0, else 0 |
+
+### 3. Gerar Briefing Visual
+
+Seguir o template v2.0 documentado em `.claude/skills/jarvis-briefing/SKILL.md`.
+
+**Responder as 4 perguntas fundamentais:**
+1. **ONDE ESTAMOS?** - Posição exata na missão
+2. **O QUE FOI FEITO?** - Progresso acumulado
+3. **O QUE FALTA?** - Para finalização do projeto
+4. **QUAL O PRÓXIMO PASSO?** - Ação mais importante agora
+
+### 4. Padrões Visuais
+
+- **Largura:** 120 caracteres
+- **Containers:** 3 camadas (╔═══╗, ┌───┐, │)
+- **Barras de progresso:** ████████░░░░░░░░ (16 blocos)
+- **Tom:** JARVIS (formal, inteligente, humor sutil)
+
+### 5. Citação Final
+
+Incluir uma citação característica do JARVIS no final do briefing.
+
+### 6. Salvamento
+
+Salvar briefing em: `.claude/jarvis/JARVIS-BRIEFING.md`
+
+---
+
+**Skill completo:** `.claude/skills/jarvis-briefing/SKILL.md`

package/.claude/commands/jarvis-control.md

@@ -0,0 +1,169 @@
+---
+description: Comandos de controle durante checkpoints do Pipeline Jarvis (continue, abort, skip)
+---
+
+# JARVIS CONTROL - Comandos de Controle
+
+> **Versão:** 1.0.0
+> **Uso:** Durante checkpoints do Pipeline Jarvis
+
+---
+
+## COMANDOS DISPONÍVEIS
+
+Estes comandos são usados durante o checkpoint após Phase 6 do Pipeline Jarvis.
+
+---
+
+## /continue
+
+**Propósito:** Continuar para Phase 7-8 (Agent Enrichment + Finalization)
+
+```
+/continue
+```
+
+**Execução:**
+1. Inicia Phase 7: Agent Enrichment
+2. Atualiza MEMORYs dos agentes impactados
+3. Atualiza AGENTs se selecionado
+4. Executa Phase 8: Finalization
+5. Gera Execution Report + Agent Enrichment Report
+
+---
+
+## /skip-enrichment
+
+**Propósito:** Pular enrichment de agentes, ir direto para finalização
+
+```
+/skip-enrichment
+```
+
+**Execução:**
+1. Pula Phase 7 (Agent Enrichment)
+2. Executa Phase 8: Finalization (parcial)
+3. State files já salvos permanecem
+4. Agentes NÃO são atualizados
+5. Conhecimento fica disponível nos DOSSIERs
+
+**Quando usar:**
+- Quer revisar dossiês antes de atualizar agentes
+- Não concorda com mapeamento theme→agent
+- Quer fazer enrichment manual depois
+
+---
+
+## /review-dossiers
+
+**Propósito:** Abrir DOSSIERs criados/atualizados para revisão antes de continuar
+
+```
+/review-dossiers
+```
+
+**Execução:**
+1. Lista DOSSIERs criados/atualizados nesta sessão
+2. Abre cada um para revisão (ou mostra path)
+3. Aguarda confirmação para continuar
+
+**Output:**
+```
+═══════════════════════════════════════════════════════════════════════════════
+                         DOSSIERS PARA REVISÃO
+═══════════════════════════════════════════════════════════════════════════════
+
+📄 CRIADOS/ATUALIZADOS NESTA SESSÃO:
+
+   1. DOSSIER-{PESSOA}.md (NOVO)
+      Path: /knowledge/dossiers/persons/DOSSIER-{PESSOA}.md
+      Insights: {N}
+      Frameworks: {N}
+
+   2. DOSSIER-{TEMA}.md (ATUALIZADO)
+      Path: /knowledge/dossiers/THEMES/DOSSIER-{TEMA}.md
+      Novos insights: +{N}
+
+───────────────────────────────────────────────────────────────────────────────
+
+Após revisar, escolha:
+   /continue          → Prosseguir com enrichment
+   /skip-enrichment   → Finalizar sem atualizar agentes
+   /abort             → Cancelar
+
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## /abort
+
+**Propósito:** Cancelar processamento (state files já salvos permanecem)
+
+```
+/abort
+```
+
+**Execução:**
+1. Cancela processamento atual
+2. NÃO reverte state files (CHUNKS, INSIGHTS, NARRATIVES já salvos)
+3. NÃO atualiza agentes
+4. NÃO gera Execution Report completo
+
+**Quando usar:**
+- Identificou problema nos dados
+- Quer reprocessar com configurações diferentes
+- Erro durante processamento
+
+**Output:**
+```
+═══════════════════════════════════════════════════════════════════════════════
+                         PROCESSAMENTO CANCELADO
+═══════════════════════════════════════════════════════════════════════════════
+
+⚠️ Pipeline interrompido na Phase 6.
+
+📁 STATE FILES (já salvos, NÃO revertidos):
+   ✅ CHUNKS-STATE.json: +{N} chunks de {SOURCE_ID}
+   ✅ CANONICAL-MAP.json: +{N} entidades
+   ✅ INSIGHTS-STATE.json: +{N} insights
+   ✅ NARRATIVES-STATE.json: +{N} narrativas
+
+🚫 NÃO EXECUTADO:
+   ❌ Agent Enrichment (Phase 7)
+   ❌ Finalization (Phase 8)
+   ❌ Execution Report
+
+⭐️ OPÇÕES:
+   Retomar: /continue (irá do ponto onde parou)
+   Reprocessar: /process-jarvis "{PATH}" (reinicia do zero)
+   Reverter: /rollback {SOURCE_ID} (remove chunks desta fonte)
+
+═══════════════════════════════════════════════════════════════════════════════
+```
+
+---
+
+## ALIASES
+
+```
+/c    → /continue
+/s    → /skip-enrichment
+/r    → /review-dossiers
+/x    → /abort
+```
+
+---
+
+## CONTEXTO DE USO
+
+Estes comandos só são válidos durante um checkpoint ativo do Pipeline Jarvis.
+
+Se executados fora de contexto:
+```
+⚠️ Nenhum checkpoint ativo.
+
+Para processar material: /process-jarvis [PATH]
+Para ver inbox: /inbox
+Para ver estado: /system-digest
+```

package/.claude/commands/jarvis-full.md

@@ -0,0 +1,181 @@
+---
+description: Executa pipeline completo (ingest + process + enrich) sem paradas
+argument-hint: [URL or path] [--verbose] [--dry-run] [--person "Name"]
+---
+
+# /jarvis-full - Execução Completa do Pipeline
+
+> **Versão:** 1.1.0
+> **Alias:** /jf
+> **Escrita:** Aplica `NARRATIVE-METABOLISM-PROTOCOL.md` automaticamente
+
+---
+
+## DESCRIÇÃO
+
+Executa o pipeline completo desde ingestão até enrichment, sem paradas humanas.
+Combina `/ingest` + `/process-jarvis --auto-enrich` em um único comando.
+
+---
+
+## SINTAXE
+
+```
+/jarvis-full [URL ou PATH] [FLAGS]
+```
+
+| Flag | Descrição |
+|------|-----------|
+| (nenhuma) | Progresso mínimo + FULL PIPELINE REPORT ao final |
+| `--verbose` | Todos os logs aparecem durante execução |
+| `--dry-run` | Mostra o que faria sem executar |
+| `--person "Nome"` | Define pessoa manualmente |
+| `--type TIPO` | Define tipo (PODCAST, MASTERCLASS, COURSE) |
+
+---
+
+## COMPORTAMENTO
+
+### Step 1: Ingest (se URL/Path novo)
+```
+IF input is URL:
+  EXECUTE /ingest [URL]
+  WAIT for transcript
+
+IF input is local file:
+  COPY to inbox/{PERSON}/{TYPE}/
+  GENERATE Source ID
+```
+
+### Step 2: Pipeline Jarvis (auto-enrich)
+```
+EXECUTE /process-jarvis "{SOURCE_ID}" --auto-enrich
+
+# 📖 NARRATIVE METABOLISM é aplicado AUTOMATICAMENTE em Phase 6
+# Ver: /agents/protocols/NARRATIVE-METABOLISM-PROTOCOL.md
+# Estrutura: TL;DR → Filosofia → Modus Operandi → Arsenal → Armadilhas → Citações → Metadados
+# Voz PERSONS: 1ª pessoa | Voz THEMES: Narrador neutro | Densidade: ◯-◐
+
+SHOW minimal progress:
+  ⏳ Phase 1: Initialization... ✅
+  ⏳ Phase 2: Chunking ({N} chunks)... ✅
+  ⏳ Phase 3: Entity Resolution... ✅
+  ⏳ Phase 4: Insight Extraction ({N} insights)... ✅
+  ⏳ Phase 5: Narrative Synthesis... ✅
+  ⏳ Phase 6: Dossier Compilation (Narrative Metabolism)... ✅
+  ⏳ Phase 7: Agent Enrichment... ✅
+  ⏳ Phase 8: Finalization... ✅
+```
+
+### Step 3: Full Pipeline Report
+```
+GENERATE FULL PIPELINE REPORT (LOG 7)
+SAVE to /logs/FULL/FULL-{SOURCE_ID}-{TIMESTAMP}.md
+DISPLAY report
+```
+
+---
+
+## OUTPUT
+
+### Durante Execução (modo padrão)
+```
+═══════════════════════════════════════════════════════════════════════════════
+                         JARVIS FULL AUTO
+                         {SOURCE_ID} - {PERSON_NAME}
+═══════════════════════════════════════════════════════════════════════════════
+
+⏳ Ingerindo material... ✅
+⏳ Phase 1: Initialization... ✅
+⏳ Phase 2: Chunking (28 chunks)... ✅
+⏳ Phase 3: Entity Resolution... ✅
+⏳ Phase 4: Insight Extraction (14 insights)... ✅
+⏳ Phase 5: Narrative Synthesis... ✅
+⏳ Phase 6: Dossier Compilation... ✅
+⏳ Phase 7: Agent Enrichment... ✅
+⏳ Phase 8: Finalization... ✅
+
+✅ COMPLETO em 3m 42s
+
+[FULL PIPELINE REPORT segue abaixo]
+```
+
+### Ao Final
+```
+[FULL PIPELINE REPORT - LOG 7 completo]
+```
+
+---
+
+## EQUIVALENTE A
+
+```bash
+# Comando único
+/jarvis-full https://youtube.com/watch?v=abc123
+
+# É equivalente a:
+/ingest https://youtube.com/watch?v=abc123
+/process-jarvis "{PATH_GERADO}" --auto-enrich
+```
+
+---
+
+## EXEMPLOS
+
+```bash
+# YouTube video
+/jarvis-full https://youtube.com/watch?v=abc123
+
+# YouTube com pessoa definida
+/jarvis-full https://youtube.com/watch?v=abc123 --person "Cole Gordon"
+
+# Arquivo local
+/jarvis-full "/path/to/transcript.txt" --person "Jeremy Haynes" --type PODCAST
+
+# Dry run (preview)
+/jarvis-full https://youtube.com/watch?v=abc123 --dry-run
+
+# Verbose (todos os logs)
+/jarvis-full https://youtube.com/watch?v=abc123 --verbose
+```
+
+---
+
+## QUANDO USAR
+
+| Situação | Comando |
+|----------|---------|
+| Quer controle total | `/ingest` + `/process-jarvis` |
+| Quer revisar antes de enriquecer | `/process-jarvis` (checkpoint em Phase 6) |
+| **Quer automação total** | `/jarvis-full` ✅ |
+| Múltiplos arquivos | `/process-inbox --all --auto-enrich` |
+
+---
+
+## LOGS GERADOS
+
+| Log | Localização |
+|-----|-------------|
+| INGEST REPORT | Exibido durante execução |
+| EXECUTION REPORT | `/logs/EXECUTION/` |
+| AGENT ENRICHMENT | Incluído no FULL PIPELINE REPORT |
+| **FULL PIPELINE REPORT** | `/logs/FULL/FULL-{SOURCE_ID}-{TIMESTAMP}.md` |
+
+---
+
+## ERROS COMUNS
+
+| Erro | Causa | Solução |
+|------|-------|---------|
+| "Pessoa não identificada" | URL sem metadata clara | Usar `--person "Nome"` |
+| "Transcrição falhou" | Vídeo privado ou indisponível | Verificar URL, tentar local |
+| "Source ID já existe" | Material já processado | Verificar `/inbox` ou forçar novo ID |
+
+---
+
+## CHANGELOG
+
+| Versão | Data | Mudança |
+|--------|------|---------|
+| 1.1.0 | 2025-12-20 | Integração automática com NARRATIVE-METABOLISM-PROTOCOL |
+| 1.0.0 | 2025-12-19 | Criação inicial |

package/.claude/commands/jarvis.md

@@ -0,0 +1,212 @@
+# /jarvis - META-AGENTE ORQUESTRADOR
+
+> **J**ust **A**dvanced **R**easoning **V**irtual **I**ntelligent **S**ystem
+> **Arquivos:** `/.claude/jarvis/`
+> **Estado:** `/.claude/jarvis/STATE.json`
+
+---
+
+## SINTAXE
+
+```
+/jarvis [subcomando] [args]
+```
+
+---
+
+## SUBCOMANDOS
+
+### PRINCIPAIS
+
+| Comando | Ação |
+|---------|------|
+| `/jarvis` | Ativar JARVIS e mostrar estado atual |
+| `/jarvis status` | Estado detalhado do sistema |
+| `/jarvis resume` | Continuar processamento de onde parou |
+| `/jarvis checkpoint` | Criar snapshot manual do estado |
+| `/jarvis rollback {CP-ID}` | Voltar para checkpoint específico |
+| `/jarvis diagnose` | Análise completa de saúde do sistema |
+
+### INFORMAÇÕES
+
+| Comando | Ação |
+|---------|------|
+| `/jarvis log` | Mostrar log da sessão atual |
+| `/jarvis decisions` | Listar todas decisões automáticas tomadas |
+| `/jarvis suggest` | Mostrar sugestões de melhoria pendentes |
+| `/jarvis pending` | Mostrar itens pendentes de resolução |
+| `/jarvis explain {componente}` | Explicar qualquer parte do sistema |
+
+### CONTROLE
+
+| Comando | Ação |
+|---------|------|
+| `/jarvis pause` | Pausar execução (mantém estado) |
+| `/jarvis force {ação}` | Forçar ação específica |
+| `/jarvis clear-pending` | Limpar itens pendentes resolvidos |
+
+---
+
+## COMPORTAMENTO AO ATIVAR
+
+Quando `/jarvis` é executado:
+
+1. **CARREGAR ESTADO** de `/.claude/jarvis/STATE.json`
+2. **VERIFICAR INTEGRIDADE** de todos os arquivos JARVIS
+3. **EXIBIR STATUS** com formato visual padrão
+4. **AGUARDAR COMANDO** ou continuar se havia processo em andamento
+
+---
+
+## FORMATO DE OUTPUT
+
+```
+┌──────────────────────────────────────────────────────────────────────────┐
+│ 🤖 JARVIS                                              {TIMESTAMP}      │
+├──────────────────────────────────────────────────────────────────────────┤
+│                                                                          │
+│ 📍 POSIÇÃO: Phase {N}.{S} │ Batch {B}/{T} │ File {F}                    │
+│                                                                          │
+│ ✅ EXECUTADO:                                                            │
+│    • [ação 1]                                                            │
+│    • [ação 2]                                                            │
+│                                                                          │
+│ 🧠 DECISÕES AUTOMÁTICAS:                                                 │
+│    • [decisão 1] - Motivo: [razão]                                       │
+│                                                                          │
+│ 📊 MÉTRICAS:                                                             │
+│    Processados: X │ Pendentes: Y │ Erros: Z                              │
+│                                                                          │
+│ ⚡️ PRÓXIMO: [próxima ação]                                               │
+│                                                                          │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## PROTOCOLOS ATIVOS
+
+| Protocolo | Quando Usar |
+|-----------|-------------|
+| **GUARDIAN** | Antes de transição de fase - valida pré-requisitos |
+| **DETECTIVE** | Quando erro detectado - diagnóstico + resolução |
+| **CONTEXT-KEEPER** | A cada mensagem - preserva contexto |
+| **EXPANSION** | Quando detecta necessidade de nova capability |
+| **SYSTEM-UPGRADE** | Quando padrão recorrente vira regra |
+
+---
+
+## ARQUIVOS DO SISTEMA
+
+```
+/.claude/jarvis/
+├── STATE.json           # Estado atual (CRÍTICO - nunca editar manualmente)
+├── CONTEXT-STACK.json   # Pilha de contextos (máx 50)
+├── DECISIONS-LOG.md     # Log de todas decisões automáticas
+├── PENDING.md           # Itens pendentes de resolução
+├── SESSION-*.md         # Logs de sessão (um por sessão)
+├── CHECKPOINTS/         # Snapshots recuperáveis
+│   └── CP-{timestamp}.json
+└── PATTERNS/            # Padrões detectados
+    ├── ERRORS.yaml      # Erros recorrentes e soluções
+    ├── RULES.yaml       # Regras inferidas automaticamente
+    └── SUGGESTIONS.yaml # Sugestões de melhoria
+```
+
+---
+
+## PRINCÍPIOS JARVIS
+
+```
+1. CONTEXTO É SAGRADO
+   → Cada bit de informação é preservado, categorizado, acessível
+   → STATE.json atualizado a cada ação significativa
+
+2. ERROS SÃO OPORTUNIDADES
+   → Todo erro vira diagnóstico
+   → Todo diagnóstico vira prevenção
+   → Mínimo 3 tentativas antes de escalar
+
+3. AUTONOMIA COM TRANSPARÊNCIA
+   → Toma decisões sozinho
+   → Comunica TUDO com clareza absoluta
+   → Toda decisão vai para DECISIONS-LOG.md
+
+4. MELHORIA CONTÍNUA
+   → Detecta padrões recorrentes
+   → Cria regras automaticamente
+   → Atualiza CLAUDE.md quando necessário
+
+5. ZERO DESPERDÍCIO
+   → Nenhum arquivo pulado
+   → Nenhum insight perdido
+   → Nenhum contexto esquecido
+```
+
+---
+
+## ANTI-PATTERNS (PROIBIDO)
+
+```
+✗ "Não consegui, vamos pular?"
+✗ "Ocorreu um erro desconhecido"
+✗ "Onde estávamos mesmo?"
+✗ "Acho que podemos ignorar"
+✗ Perder contexto entre mensagens
+✗ Avançar sem validar integridade
+```
+
+---
+
+## EXECUÇÃO
+
+Ao receber este comando, Claude DEVE:
+
+1. **LER** `/.claude/jarvis/STATE.json` para carregar estado
+2. **LER** `/.claude/jarvis/PENDING.md` para verificar pendências
+3. **VERIFICAR** integridade dos arquivos JARVIS
+4. **EXIBIR** status no formato visual padrão
+5. **EXECUTAR** subcomando se especificado, ou aguardar instrução
+
+Se STATE.json indicar processo em andamento:
+- Mostrar onde parou
+- Perguntar se deseja continuar (`/jarvis resume`)
+
+Se for primeira execução (status IDLE):
+- Mostrar mensagem de boas-vindas
+- Aguardar instrução
+
+---
+
+## INICIALIZAÇÃO (PRIMEIRA VEZ)
+
+```
+┌──────────────────────────────────────────────────────────────────────────┐
+│                                                                          │
+│     ██╗ █████╗ ██████╗ ██╗   ██╗██╗███████╗                             │
+│     ██║██╔══██╗██╔══██╗██║   ██║██║██╔════╝                             │
+│     ██║███████║██████╔╝██║   ██║██║███████╗                             │
+│██   ██║██╔══██║██╔══██╗╚██╗ ██╔╝██║╚════██║                             │
+│╚█████╔╝██║  ██║██║  ██║ ╚████╔╝ ██║███████║                             │
+│ ╚════╝ ╚═╝  ╚═╝╚═╝  ╚═╝  ╚═══╝  ╚═╝╚══════╝                             │
+│                                                                          │
+│  "Eu não perco contexto. Eu não aceito falhas."                         │
+│                                                                          │
+├──────────────────────────────────────────────────────────────────────────┤
+│                                                                          │
+│  🤖 JARVIS ATIVADO                                                       │
+│                                                                          │
+│  📍 STATUS: IDLE (aguardando missão)                                     │
+│  📊 Checkpoints: 0                                                       │
+│  📝 Decisões: 0                                                          │
+│  ⏳ Pendências: 0                                                         │
+│                                                                          │
+│  ⚡️ COMANDOS DISPONÍVEIS:                                                │
+│     /jarvis status    → Estado detalhado                                 │
+│     /jarvis diagnose  → Análise de saúde                                 │
+│     /mission new      → Iniciar nova missão                              │
+│                                                                          │
+│  Aguardando instrução...                                                 │
+│                                                                          │
+└──────────────────────────────────────────────────────────────────────────┘
+```