mega-brain-ai 1.3.0

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

@@ -0,0 +1,182 @@
+---
+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
+> **Workflow:** `core/workflows/wf-pipeline-full.yaml`
+> **Templates:** `core/templates/phases/narrative-metabolism.md`
+
+---
+
+## 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: core/templates/phases/narrative-metabolism.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...                                                 │
+│                                                                          │
+└──────────────────────────────────────────────────────────────────────────┘
+```

package/.claude/commands/ler-drive.md

@@ -0,0 +1,212 @@
+---
+description: Lê e cria recursos do Google Drive (planilhas, pastas, documentos) via MCP
+tags: [mcp, gdrive, sheets, docs, automation]
+---
+
+# /ler-drive
+
+Explora, lê e **cria** recursos do Google Drive conectado via MCP.
+
+## MODOS DE USO
+
+### 1. Listar recursos disponíveis
+```
+/ler-drive
+```
+→ Mostra todos os recursos do Google Drive conectados
+
+### 2. Ler planilha específica
+```
+/ler-drive [nome ou parte do nome]
+```
+→ Busca e lê a planilha correspondente
+
+**Exemplos:**
+- `/ler-drive BENCH` → Lê "[BENCH] ESTRUTURA COMERCIAL"
+- `/ler-drive [Sua Empresa]` → Lê "Ferramentas [Sua Empresa] 2025 [MATRIZ]"
+- `/ler-drive Fixos` → Lê "Fixos 2025 | [Sua Empresa] V.2"
+
+### 3. Explorar pasta
+```
+/ler-drive pasta:[nome]
+```
+→ Lista conteúdo da pasta
+
+**Exemplos:**
+- `/ler-drive pasta:Acervo`
+- `/ler-drive pasta:Estratégia`
+
+### 4. Criar documento Google Docs (NOVO!)
+```
+/ler-drive criar:[titulo] --arquivo [path]
+/ler-drive criar:[titulo] --conteudo "texto direto"
+```
+→ Cria um novo Google Doc com o conteúdo especificado
+
+**Exemplos:**
+- `/ler-drive criar:Relatório Mensal --arquivo logs/relatorio.md`
+- `/ler-drive criar:Notas Rápidas --conteudo "Texto do documento"`
+- `/ler-drive criar:Backup DOSSIER --arquivo knowledge/dossiers/persons/DOSSIER-COLE-GORDON.md`
+
+## COMPORTAMENTO
+
+**Ao executar, Claude deve:**
+
+1. **Listar recursos** (se sem argumentos)
+   - Mostrar tabela com: Nome | Tipo | ID
+   - Separar por: Planilhas, Pastas, Documentos
+
+2. **Ler planilha** (se argumento fornecido)
+   - Buscar por nome parcial (case-insensitive)
+   - Ler primeiras 50 linhas de todas as abas
+   - Identificar estrutura: colunas, tipos de dados
+   - **DESTACAR URLs** encontradas (YouTube, Google Docs, etc.)
+   - Mostrar resumo executivo
+
+3. **Explorar pasta** (se prefixo `pasta:`)
+   - Listar arquivos dentro da pasta
+   - Mostrar tipos e tamanhos
+   - Identificar arquivos processáveis (planilhas, docs)
+
+4. **Auto-detectar links**
+   - Escanear células em busca de URLs
+   - Categorizar: YouTube, Google Docs, PDFs, externos
+   - Sugerir `/jarvis-full` para URLs de vídeo
+
+## OUTPUT ESPERADO
+
+### Para Planilhas:
+```markdown
+## 📊 [NOME DA PLANILHA]
+
+**ID:** [spreadsheet_id]
+**Abas:** [lista de abas]
+
+### 📋 Estrutura Detectada
+
+| Coluna | Tipo | Exemplo |
+|--------|------|---------|
+| A | Texto | "Nome do curso" |
+| B | URL | https://youtube.com/... |
+| C | Status | "Pendente" |
+
+### 🔗 URLs Encontradas (12)
+
+**YouTube (8):**
+- [Linha 5] https://youtube.com/watch?v=...
+- [Linha 7] https://youtube.com/watch?v=...
+
+**Google Docs (4):**
+- [Linha 3] https://docs.google.com/...
+
+### 💡 Sugestões
+- [ ] Processar 8 vídeos do YouTube via `/jarvis-full`
+- [ ] Ingerir 4 Google Docs via MCP
+- [ ] Atualizar Status após processamento
+```
+
+### Para Pastas:
+```markdown
+## 📁 [NOME DA PASTA]
+
+**Conteúdo (15 itens):**
+
+| Nome | Tipo | Processável |
+|------|------|-------------|
+| Curso 1.pdf | PDF | ✅ SIM |
+| Planilha.xlsx | Spreadsheet | ✅ SIM |
+| Video.mp4 | Video | ⚠️ Precisa link |
+```
+
+## INTEGRAÇÕES
+
+**Após ler planilha com URLs, sugerir automaticamente:**
+
+1. **Comando de lote:**
+   ```bash
+   # Processar todos os vídeos encontrados
+   /jarvis-batch --from-gdrive [spreadsheet_id] --col [coluna_url]
+   ```
+
+2. **Atualização de status:**
+   ```bash
+   # Atualizar coluna Status após processar
+   /update-gdrive [spreadsheet_id] --row [N] --col "Status" --value "Processado"
+   ```
+
+## CASOS DE USO
+
+### Caso 1: Acervo de Aprendizado
+```
+/ler-drive Acervo
+→ Lista cursos/vídeos pendentes
+→ Identifica URLs do YouTube
+→ Sugere processamento em lote
+```
+
+### Caso 2: Estrutura Comercial
+```
+/ler-drive BENCH
+→ Lê benchmarks e estrutura
+→ Extrai KPIs e métricas
+→ Sugere atualização de agentes (CRO, CFO)
+```
+
+### Caso 3: Ferramentas [Sua Empresa]
+```
+/ler-drive [Sua Empresa]
+→ Lê matriz de ferramentas
+→ Identifica stack tecnológico
+→ Atualiza AGENT-COO.md
+```
+
+## REGRAS DE EXECUÇÃO
+
+1. **SEMPRE** usar `mcp__gdrive__gdrive_search` para buscar
+2. **SEMPRE** usar `mcp__gdrive__gsheets_read` para planilhas
+3. **SEMPRE** usar `mcp__gdrive__gdocs_create` para criar documentos
+4. **SEMPRE** destacar URLs em formato de lista
+5. **SEMPRE** sugerir próximos passos (comandos)
+6. **NUNCA** processar automaticamente sem confirmar com usuário
+
+## ARGUMENTOS AVANÇADOS
+
+```
+/ler-drive [nome] --extract-urls    # Apenas extrair URLs
+/ler-drive [nome] --format json     # Output JSON
+/ler-drive [nome] --col [letra]     # Ler apenas coluna específica
+```
+
+## FERRAMENTAS MCP DISPONÍVEIS
+
+| Ferramenta | Uso |
+|------------|-----|
+| `mcp__gdrive__gdrive_search` | Buscar arquivos e pastas |
+| `mcp__gdrive__gdrive_read_file` | Ler conteúdo de arquivo |
+| `mcp__gdrive__gsheets_read` | Ler planilhas |
+| `mcp__gdrive__gsheets_update_cell` | Atualizar célula em planilha |
+| `mcp__gdrive__gdocs_create` | **NOVO** - Criar Google Docs |
+
+## SCRIPT DE CRIAÇÃO DE DOCUMENTOS
+
+Para criar documentos diretamente via linha de comando:
+
+```bash
+# Sintaxe
+python scripts/gdocs_full_auth.py "Título do Documento" "caminho/arquivo.md" [folder_id]
+
+# Exemplos
+python scripts/gdocs_full_auth.py "Meu Relatório" "arquivo.md"
+python scripts/gdocs_full_auth.py "Backup DOSSIER" "knowledge/dossiers/persons/DOSSIER-COLE-GORDON.md"
+```
+
+---
+
+**Criado em:** 2025-12-21
+**Atualizado em:** 2025-12-28
+**Versão:** 2.0.0
+
+## CHANGELOG
+
+- **v2.0.0** (2025-12-28): Adicionado suporte a criação de Google Docs
+- **v1.0.0** (2025-12-21): Versão inicial com leitura de planilhas e pastas