mega-brain-ai 1.3.0

package/docs/PLAN-MODE-PROTOCOL.md

@@ -0,0 +1,388 @@
+# Plan Mode Protocol
+
+> **Quando e Como Usar Plan Mode no JARVIS**
+> Protocolo completo para planejamento antes da execução.
+
+---
+
+## O Que É Plan Mode
+
+Plan Mode é um estado especial onde o Claude:
+- **Apenas lê e analisa** - não modifica arquivos
+- **Cria um plano detalhado** - antes de executar
+- **Aguarda aprovação** - do usuário antes de agir
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                         PLAN MODE vs NORMAL MODE                            │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│   NORMAL MODE                         PLAN MODE                             │
+│   ┌───────────┐                       ┌───────────┐                        │
+│   │  Recebe   │                       │  Recebe   │                        │
+│   │  Tarefa   │                       │  Tarefa   │                        │
+│   └─────┬─────┘                       └─────┬─────┘                        │
+│         │                                   │                              │
+│         ▼                                   ▼                              │
+│   ┌───────────┐                       ┌───────────┐                        │
+│   │  Executa  │                       │  Analisa  │                        │
+│   │ Diretamente│                      │   Lê      │                        │
+│   └─────┬─────┘                       │ Pesquisa  │                        │
+│         │                             └─────┬─────┘                        │
+│         │                                   │                              │
+│         │                                   ▼                              │
+│         │                             ┌───────────┐                        │
+│         │                             │   Cria    │                        │
+│         │                             │   Plano   │                        │
+│         │                             └─────┬─────┘                        │
+│         │                                   │                              │
+│         │                                   ▼                              │
+│         │                             ┌───────────┐                        │
+│         │                             │  Aguarda  │                        │
+│         │                             │ Aprovação │                        │
+│         │                             └─────┬─────┘                        │
+│         │                                   │                              │
+│         ▼                                   ▼                              │
+│   ┌───────────┐                       ┌───────────┐                        │
+│   │ Resultado │                       │  Executa  │                        │
+│   └───────────┘                       │   (só com │                        │
+│                                       │ aprovação)│                        │
+│                                       └───────────┘                        │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Quando Usar Plan Mode
+
+### OBRIGATÓRIO (REGRA #13)
+
+| Situação | Plan Mode? |
+|----------|------------|
+| Nova feature | ✅ **OBRIGATÓRIO** |
+| Bug fix | ✅ **OBRIGATÓRIO** |
+| Refatoração de código | ✅ **OBRIGATÓRIO** |
+| Criação de agente | ✅ **OBRIGATÓRIO** |
+| Processamento de batch grande (>10 arquivos) | ✅ **OBRIGATÓRIO** |
+| Alteração em múltiplos arquivos | ✅ **OBRIGATÓRIO** |
+| Qualquer tarefa > 30 minutos | ✅ **OBRIGATÓRIO** |
+| Múltiplas abordagens possíveis | ✅ **OBRIGATÓRIO** |
+
+### OPCIONAL (Pode Pular)
+
+| Situação | Plan Mode? |
+|----------|------------|
+| Pergunta simples | ❌ Desnecessário |
+| Status check | ❌ Desnecessário |
+| Busca de informação | ❌ Desnecessário |
+| Leitura de arquivo único | ❌ Desnecessário |
+| Verificação rápida | ❌ Desnecessário |
+
+---
+
+## Como Ativar Plan Mode
+
+### Método 1: Teclado
+
+```
+Shift+Tab → Shift+Tab (2x)
+```
+
+### Método 2: Comando
+
+```
+"Entre em plan mode"
+"Vamos planejar primeiro"
+"Plan this before executing"
+```
+
+### Método 3: Automático (Hook)
+
+O hook `enforce_plan_mode.py` detecta keywords e sugere Plan Mode:
+
+```python
+# Keywords que ativam sugestão de Plan Mode:
+modifying_keywords = [
+    "criar", "atualizar", "modificar", "implementar",
+    "adicionar", "remover", "refatorar", "corrigir",
+    "create", "update", "modify", "implement",
+    "add", "remove", "refactor", "fix"
+]
+```
+
+---
+
+## Fluxo do Plan Mode
+
+### 1. Entrada
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  📋 PLAN MODE ACTIVATED                                                     │
+│                                                                             │
+│  Você está em modo de planejamento.                                         │
+│  Ações permitidas: Read, Search, Analyze                                    │
+│  Ações bloqueadas: Write, Edit, Delete                                      │
+│                                                                             │
+│  O plano será salvo em: /.claude/plans/[nome].md                           │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 2. Análise
+
+JARVIS executa:
+- Leitura de arquivos relevantes
+- Pesquisa de código existente
+- Identificação de dependências
+- Mapeamento de impacto
+
+### 3. Criação do Plano
+
+O plano inclui:
+
+```markdown
+# Plano: [Nome da Tarefa]
+
+## Objetivo
+[O que será feito]
+
+## Análise
+[O que foi descoberto durante análise]
+
+## Arquivos Afetados
+- [ ] arquivo1.py - Modificação
+- [ ] arquivo2.md - Criação
+- [ ] arquivo3.json - Atualização
+
+## Dependências
+- Requer: X
+- Afeta: Y
+- Cascateia para: Z
+
+## Etapas
+1. Primeiro passo
+2. Segundo passo
+3. Terceiro passo
+
+## Riscos
+- Risco 1: Mitigação
+- Risco 2: Mitigação
+
+## Verificação
+- [ ] Level 1: Lint
+- [ ] Level 2: Tests
+- [ ] Level 3: Build
+- [ ] Level 4: Visual
+- [ ] Level 5: Staging
+- [ ] Level 6: Security
+
+## Status
+AGUARDANDO APROVAÇÃO
+```
+
+### 4. Aprovação
+
+JARVIS apresenta:
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                           PLANO PRONTO PARA REVISÃO                          ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  Arquivos a criar:     3                                                    ║
+║  Arquivos a modificar: 2                                                    ║
+║  Cascateamentos:       4 destinos                                           ║
+║                                                                              ║
+║  Plano salvo em: /.claude/plans/rustling-stirring-rain.md                   ║
+║                                                                              ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  Opções:                                                                    ║
+║  [1] Aprovar e executar                                                     ║
+║  [2] Solicitar ajustes                                                      ║
+║  [3] Cancelar                                                               ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+### 5. Execução
+
+Após aprovação:
+- Sai do Plan Mode
+- Executa conforme plano aprovado
+- Marca itens como completos
+- Gera logs de execução
+
+---
+
+## Boas Práticas
+
+### Refinamento Iterativo
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  NÃO fazer:                          FAZER:                                 │
+│                                                                             │
+│  Plano v1 → Executar                 Plano v1 → Revisar                    │
+│                                            ↓                               │
+│                                      Plano v2 → Revisar                    │
+│                                            ↓                               │
+│                                      Plano v3 → Aprovar → Executar         │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Perguntas Obrigatórias
+
+Antes de finalizar o plano, JARVIS pergunta:
+
+```
+"Algo mais que devo considerar antes de executar?"
+"Há algum requisito que não mencionei?"
+"Este plano cobre todas as suas necessidades?"
+```
+
+### Granularidade
+
+| Tarefa | Plano |
+|--------|-------|
+| Pequena (1-2 arquivos) | Plano simples, 1 página |
+| Média (3-5 arquivos) | Plano detalhado, 2-3 páginas |
+| Grande (6+ arquivos) | Plano extenso, com sub-etapas |
+
+---
+
+## Template de Plano
+
+```markdown
+# PLANO: [Título]
+
+## Metadata
+- **Criado:** YYYY-MM-DD HH:MM
+- **Autor:** JARVIS
+- **Status:** AGUARDANDO APROVAÇÃO
+- **Versão:** 1.0.0
+
+---
+
+## 1. OBJETIVO
+
+[Descrição clara do que será feito]
+
+---
+
+## 2. ANÁLISE
+
+### Contexto Atual
+[Estado atual do sistema]
+
+### Descobertas
+[O que foi encontrado durante análise]
+
+### Dependências
+[O que precisa existir/funcionar]
+
+---
+
+## 3. ARQUIVOS
+
+| Arquivo | Ação | Descrição |
+|---------|------|-----------|
+| path/file1.py | CRIAR | Nova funcionalidade |
+| path/file2.md | MODIFICAR | Adicionar seção |
+| path/file3.json | ATUALIZAR | Novo campo |
+
+---
+
+## 4. ETAPAS
+
+### Etapa 1: [Nome]
+- [ ] Sub-tarefa 1.1
+- [ ] Sub-tarefa 1.2
+
+### Etapa 2: [Nome]
+- [ ] Sub-tarefa 2.1
+- [ ] Sub-tarefa 2.2
+
+### Etapa 3: [Nome]
+- [ ] Sub-tarefa 3.1
+- [ ] Sub-tarefa 3.2
+
+---
+
+## 5. CASCATEAMENTOS
+
+| Artefato | Destino | Impacto |
+|----------|---------|---------|
+| Framework X | Agent Y | +1 método |
+| Metodologia Z | Dossier W | Atualização |
+
+---
+
+## 6. RISCOS
+
+| Risco | Probabilidade | Mitigação |
+|-------|---------------|-----------|
+| Risco 1 | Baixa | Ação A |
+| Risco 2 | Média | Ação B |
+
+---
+
+## 7. VERIFICAÇÃO
+
+- [ ] Level 1: Hooks/Lint
+- [ ] Level 2: Tests
+- [ ] Level 3: Build
+- [ ] Level 4: Visual
+- [ ] Level 5: Staging
+- [ ] Level 6: Security
+
+---
+
+## 8. APROVAÇÃO
+
+**Status:** AGUARDANDO APROVAÇÃO
+
+[ ] Aprovar e executar
+[ ] Solicitar ajustes
+[ ] Cancelar
+```
+
+---
+
+## Comandos Úteis
+
+| Comando | Ação |
+|---------|------|
+| `Shift+Tab 2x` | Entrar em Plan Mode |
+| "Entre em plan mode" | Entrar em Plan Mode |
+| "Mostre o plano" | Exibir plano atual |
+| "Ajuste o plano" | Solicitar modificações |
+| "Aprove o plano" | Aprovar para execução |
+| "Cancele o plano" | Cancelar e sair |
+
+---
+
+## Integração com JARVIS
+
+### Regra #13 (Atualizada)
+
+```
+PLAN MODE É OBRIGATÓRIO PARA QUALQUER TAREFA QUE MODIFIQUE ARQUIVOS.
+
+Exceções (pode pular):
+- Respostas informativas
+- Buscas simples
+- Status checks
+```
+
+### Hook de Enforcement
+
+O hook `enforce_plan_mode.py` detecta automaticamente quando Plan Mode deveria
+ser usado e sugere ativação.
+
+---
+
+> 🤖 Plan Mode economiza tempo no longo prazo.
+> Plano ruim = Execução ruim = Retrabalho.
+> Sempre refinar. Sempre confirmar.

package/docs/RESTORE-AND-INDEX.md

@@ -0,0 +1,203 @@
+# RESTORE-AND-INDEX.md
+# Instruções para Restauração de Arquivos e Criação do Sistema de Indexação
+
+---
+
+## CONTEXTO DO PROBLEMA
+
+Durante a Fase 2.5 (Deduplicação), arquivos foram movidos de suas pastas principais para pastas de backup (`_DUPLICATAS_*`, `_DEDUP_BACKUP`, etc.). Isso quebrou a rastreabilidade porque:
+
+1. Batches referenciam TAGs (ex: `JH-ST-0002`)
+2. TAGs apontam para subpastas específicas (ex: `inbox/JEREMY HAYNES/SALES-TRAINING/`)
+3. Essas subpastas estão VAZIAS - arquivos estão nos backups
+4. Agentes não conseguem resolver TAG → arquivo original
+
+---
+
+## PARTE 1: RESTAURAÇÃO VIA GIT
+
+### 1.1 Verificar Estado Atual
+
+```bash
+# Verificar quantos arquivos estão "deletados" (movidos)
+# From the project root
+git status --porcelain | grep "^ D" | wc -l
+
+# Ver quais pastas estão afetadas
+git status --porcelain | grep "inbox" | head -20
+```
+
+**Resultado esperado:** ~1.248 arquivos marcados como deletados
+
+### 1.2 Executar Restauração
+
+```bash
+# COMANDO PRINCIPAL - Restaura todos os arquivos do INBOX
+# From the project root
+git restore "inbox/"
+```
+
+**O que acontece:**
+- Arquivos voltam para suas pastas originais
+- Pastas de backup (`_DUPLICATAS_*`) continuam existindo com suas cópias
+- Nenhum dado é perdido
+
+### 1.3 Validar Restauração
+
+```bash
+# Verificar que arquivos voltaram
+cd inbox
+
+# Contar por fonte principal
+echo "=== ALEX HORMOZI ===" && find "ALEX HORMOZI" -type f | wc -l
+echo "=== COLE GORDON ===" && find "COLE GORDON" -type f | wc -l
+echo "=== JEREMY HAYNES ===" && find "JEREMY HAYNES" -type f | wc -l
+echo "=== JEREMY MINER ===" && find "JEREMY MINER" -type f | wc -l
+```
+
+**Resultado esperado:** Cada pasta deve ter dezenas/centenas de arquivos
+
+### 1.4 Verificar Integridade das TAGs
+
+```bash
+# Contar arquivos COM TAG (formato [XXX-NNNN])
+cd inbox
+find . -name "*\[*-*\]*" -type f | wc -l
+
+# Listar alguns exemplos
+find . -name "*\[JH-*" -type f | head -10
+find . -name "*\[JM-*" -type f | head -10
+```
+
+**Resultado esperado:** ~727 arquivos com TAG no nome
+
+---
+
+## PARTE 2: LIMPEZA DOS BACKUPS
+
+### 2.1 Mover Backups para ARCHIVE
+
+Após restauração confirmada, mover pastas de backup para não poluir o INBOX:
+
+```bash
+# From the project root
+
+# Criar pasta de archive para backups de deduplicação
+mkdir -p "archive/dedup-backups-2026-01-08"
+
+# Mover todas as pastas de backup
+mv "inbox/_DEDUP_BACKUP" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_DUPLICATAS_1PARA1_2026-01-08" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_DUPLICATAS_FINAL" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_DUPLICATAS_FINAL_V2" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_DUPLICATAS_REMOVIDAS" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_EXTRAS_ORFAOS_2026-01-08" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_EXTRAS_REMOVIDOS_2026-01-08" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_EXTRAS_RIGOROSO_2026-01-08" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_EXTRAS_SEM_MATCH_2026-01-08" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_LIMPEZA_FINAL" "archive/dedup-backups-2026-01-08/"
+mv "inbox/_UNKNOWN" "archive/dedup-backups-2026-01-08/"
+```
+
+**MANTER no INBOX:**
+- `_TEMPLATES/` - templates de transcrição
+- `_BACKUP_COLE_GORDON_CLEANUP/` - se estiver vazio, pode deletar
+
+### 2.2 Criar README no Archive
+
+```bash
+cat > "archive/dedup-backups-2026-01-08/README.md" << 'EOF'
+# Backups de Deduplicação - 2026-01-08
+
+## Contexto
+Durante a Fase 2.5 (Deduplicação), arquivos foram movidos para estas pastas
+para identificar e remover duplicatas.
+
+## Conteúdo
+- `_DEDUP_BACKUP/` - Backup inicial antes de deduplicação
+- `_DUPLICATAS_*` - Arquivos identificados como duplicatas
+- `_EXTRAS_*` - Arquivos extras ou sem match na planilha
+- `_LIMPEZA_FINAL/` - Resultado da limpeza final
+
+## Status
+- Data: 2026-01-08
+- Arquivos originais: RESTAURADOS para inbox via git restore
+- Estes backups: Mantidos para referência histórica
+
+## Ação
+Estes arquivos podem ser DELETADOS após confirmação de que:
+1. Todos os originais estão em inbox
+2. TAG-RESOLVER.json foi criado e validado
+3. Sistema de rastreabilidade está funcionando
+EOF
+```
+
+---
+
+## PARTE 3: VALIDAÇÃO FINAL
+
+### 3.1 Checklist de Validação
+
+Execute e confirme cada item:
+
+```bash
+# From the project root
+
+# 1. Git status limpo para INBOX
+echo "=== GIT STATUS ==="
+git status --porcelain | grep "inbox" | wc -l
+# Esperado: 0 (nenhuma mudança pendente)
+
+# 2. Pastas principais têm arquivos
+echo "=== CONTAGEM POR FONTE ==="
+for dir in "inbox/alex hormozi" \
+           "inbox/COLE GORDON" \
+           "inbox/JEREMY HAYNES" \
+           "inbox/JEREMY MINER" \
+    count=$(find "$dir" -type f 2>/dev/null | wc -l)
+    echo "$dir: $count arquivos"
+done
+
+# 3. Arquivos com TAG existem
+echo "=== ARQUIVOS COM TAG ==="
+find "inbox" -name "*\[*-*\]*" -type f | wc -l
+# Esperado: ~727
+
+# 4. Backups foram movidos
+echo "=== BACKUPS NO ARCHIVE ==="
+ls -la "archive/dedup-backups-2026-01-08/" | wc -l
+# Esperado: ~12 itens (10 pastas + README + .)
+
+# 5. INBOX não tem mais pastas _*
+echo "=== PASTAS _ NO INBOX ==="
+ls -d "inbox/_"* 2>/dev/null | grep -v "_TEMPLATES" | wc -l
+# Esperado: 0 ou 1 (apenas _TEMPLATES deve restar)
+```
+
+### 3.2 Resultado Esperado
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  VALIDAÇÃO PÓS-RESTAURAÇÃO                                                   ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║                                                                              ║
+║  [✓] Git status limpo para inbox                                          ║
+║  [✓] ALEX HORMOZI: ~19 arquivos                                              ║
+║  [✓] COLE GORDON: ~120+ arquivos                                             ║
+║  [✓] JEREMY HAYNES: ~253 arquivos                                            ║
+║  [✓] JEREMY MINER: ~153 arquivos                                             ║
+║  [✓] Arquivos com TAG: ~727                                                  ║
+║  [✓] Backups movidos para archive                                         ║
+║  [✓] INBOX sem pastas _* (exceto _TEMPLATES)                                 ║
+║                                                                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```
+
+---
+
+## PRÓXIMO PASSO
+
+Após completar esta parte, execute as instruções em:
+**`TAG-RESOLVER-IMPLEMENTATION.md`**
+
+Isso criará o sistema de resolução TAG → Path que está faltando.