mega-brain-ai 1.3.0

package/.claude/commands/process-video.md

@@ -0,0 +1,131 @@
+# Process Video Command
+
+Process a video (YouTube or local) and extract knowledge automatically.
+
+## Input
+$ARGUMENTS (YouTube URL or local file path)
+
+## PRIMEIRA AÇÃO OBRIGATÓRIA
+
+> **ANTES de processar, LEIA `/system/SESSION-STATE.md`**
+> Verificar se este vídeo já foi processado.
+
+---
+
+## Workflow
+
+### Step 1: Detect Source Type
+- Se URL contém "youtube.com" ou "youtu.be" → YouTube processing
+- Se path termina em .mp4, .mp3, .wav, .m4a → Local file processing
+
+### Step 2: Identify Source (OBRIGATÓRIO)
+
+Identificar a fonte para organização correta:
+
+| Identificador | Pessoa | Empresa | Padrão de Pasta |
+|---------------|--------|---------|-----------------|
+| HORMOZI | Alex Hormozi | Alex Hormozi | `ALEX HORMOZI/` |
+| COLE-GORDON | Cole Gordon | Cole Gordon | `COLE GORDON/` |
+| LEILA | Leila Hormozi | Alex Hormozi | `LEILA HORMOZI/` |
+| CARDONE | Grant Cardone | Cardone Enterprises | `GRANT CARDONE (CARDONE ENTERPRISES)/` |
+
+### Step 3: Identify Content Type
+
+| Tipo | Descrição | Exemplos |
+|------|-----------|----------|
+| PODCASTS | Episódios, entrevistas | "The Game Podcast", "Role of HR" |
+| MASTERMINDS | Eventos, palestras ao vivo | "Taki Moore Mastermind" |
+| BLUEPRINTS | PDFs, playbooks, documentos | "Money Models" |
+| COURSES | Módulos de cursos | "Sales Training Module 1" |
+| VSL | Video Sales Letters | "VSL High Ticket" |
+| SCRIPTS | Scripts de vendas | "Call Script v2" |
+
+### Step 4: Extract Transcript
+
+**For YouTube:**
+```python
+from youtube_transcript_api import YouTubeTranscriptApi
+import re
+
+# Extract video ID
+video_id = re.search(r'(?:v=|/)([a-zA-Z0-9_-]{11})', url).group(1)
+
+# Fetch transcript
+api = YouTubeTranscriptApi()
+transcript = api.fetch(video_id)
+text = " ".join([entry['text'] for entry in transcript])
+```
+
+**For Local Files:**
+```bash
+whisper "arquivo.mp4" --language English --output_format txt --output_dir "pasta/"
+```
+
+### Step 5: Save Transcript
+
+**Localização:**
+```
+inbox/PESSOA (EMPRESA)/TIPO/TITULO DO VIDEO [youtube.com_watch_v=ID].txt
+```
+
+**Exemplo:**
+```
+inbox/alex hormozi/PODCASTS/HOW I SCALED MY SALES TEAM [youtube.com_watch_v=abc123].txt
+```
+
+**Regras:**
+- Pasta em CAIXA ALTA
+- Nome do arquivo em CAIXA ALTA
+- Incluir link do YouTube no nome `[youtube.com_watch_v=ID]`
+- Manter .mp4 e .txt juntos na mesma pasta
+
+### Step 6: Extract Knowledge
+
+Após salvar transcrição, automaticamente executar:
+1. `/extract-knowledge [path-da-transcrição]`
+
+---
+
+## Output
+
+| Item | Descrição |
+|------|-----------|
+| Transcript path | Caminho completo do arquivo .txt |
+| Source identified | Fonte identificada (HORMOZI, COLE-GORDON, etc.) |
+| Content type | Tipo de conteúdo (PODCASTS, MASTERMINDS, etc.) |
+| Knowledge extracted | Resumo do que foi extraído |
+| Files created/updated | Lista de arquivos em `/knowledge/SOURCES/[FONTE]/` |
+
+---
+
+## Example Usage
+
+```
+/process-video https://www.youtube.com/watch?v=okA9Yt2KZuk
+
+/process-video inbox/alex hormozi/PODCASTS/video.mp4
+```
+
+---
+
+## Error Handling
+
+| Erro | Ação |
+|------|------|
+| No transcript on YouTube | Baixar vídeo e transcrever localmente com Whisper |
+| Whisper não instalado | `pip install openai-whisper` |
+| Fonte não identificada | Perguntar ao usuário ou criar nova pasta |
+| Invalid URL/path | Mostrar mensagem de erro clara |
+
+---
+
+## Integration Checklist
+
+Após processar, verificar:
+
+| ✅ | Sistema | Arquivo |
+|----|---------|---------|
+| [ ] | Glossário | `/system/GLOSSARY/*.md` |
+| [ ] | Role-Tracking | `/agents/DISCOVERY/role-tracking.md` |
+| [ ] | Registry | `/system/REGISTRY/processed-files.md` |
+| [ ] | Session State | `/system/SESSION-STATE.md` |

package/.claude/commands/rag-search.md

@@ -0,0 +1,78 @@
+# /rag-search - Busca Semântica no Mega Brain
+
+Execute uma busca semântica na knowledge base usando RAG.
+
+## Uso
+
+```
+/rag-search "sua pergunta aqui"
+```
+
+## Argumentos
+
+$ARGUMENTS é a query de busca em linguagem natural.
+
+## Instruções para Claude
+
+Ao receber este comando:
+
+1. **Executar busca RAG:**
+   ```bash
+   cd "scripts/tmp-scripts"
+   python rag_query.py "$ARGUMENTS" --context
+   ```
+
+2. **Analisar resultados:**
+   - Ler o contexto retornado
+   - Identificar as fontes mais relevantes
+   - Sintetizar uma resposta baseada no conhecimento encontrado
+
+3. **Formatar resposta:**
+   ```
+   ## Resposta
+   [Síntese baseada nos resultados da busca]
+
+   ## Fontes Consultadas
+   - [Lista de arquivos/seções relevantes]
+
+   ## Confiança
+   [ALTA/MÉDIA/BAIXA] - [justificativa]
+   ```
+
+## Opções Avançadas
+
+Para buscas filtradas, execute manualmente:
+
+```bash
+cd "scripts/tmp-scripts"
+
+# Filtrar por tema
+python rag_query.py "query" --theme "PROCESSO-VENDAS"
+
+# Filtrar por fonte
+python rag_query.py "query" --source "Alex Hormozi"
+
+# Mais resultados
+python rag_query.py "query" --top-k 15
+
+# Output JSON (para análise)
+python rag_query.py "query" --json
+```
+
+## Exemplos
+
+```
+/rag-search "Como estruturar comissionamento para closers?"
+/rag-search "Qual o framework CLOSER?"
+/rag-search "Métricas de conversão B2B"
+```
+
+## Pré-requisitos
+
+- Index RAG criado: `cd scripts/tmp-scripts && python rag_index.py --full`
+- VOYAGE_API_KEY configurada no .env
+- Dependências instaladas: `pip install chromadb voyageai tiktoken`
+
+## Status do Índice
+
+Para verificar status: `cd scripts/tmp-scripts && python rag_status.py`

package/.claude/commands/resume.md

@@ -0,0 +1,33 @@
+# RESUME SESSION
+
+Carrega o contexto da última sessão salva.
+
+## Instruções
+
+1. Leia `/logs/LIVE-SESSION/CURRENT-SESSION.md`
+2. Leia `/logs/LIVE-SESSION/CONTEXT.json`
+3. Apresente ao usuário:
+
+```
+[RESUMING SESSION]
+
+## Última Atividade
+{resumo do que foi feito}
+
+## Status
+{status da tarefa: in_progress/completed/blocked}
+
+## Pendências
+{lista de pendências}
+
+## Próximos Passos
+{próximos passos sugeridos}
+
+## Arquivos Relevantes
+{lista de arquivos importantes}
+
+---
+Quer continuar de onde parou?
+```
+
+4. Aguarde confirmação do usuário antes de continuar.

package/.claude/commands/save.md

@@ -0,0 +1,38 @@
+# SAVE SESSION CONTEXT
+
+Salva o contexto atual da sessão para recuperação posterior.
+
+## Instruções
+
+1. Leia o arquivo atual de sessão: `/logs/LIVE-SESSION/CURRENT-SESSION.md`
+2. Pergunte ao usuário: "O que você quer que eu salve como contexto?"
+3. Adicione ao arquivo de sessão:
+   - Timestamp atual
+   - Resumo do que foi feito
+   - Tarefas pendentes
+   - Próximos passos
+   - Qualquer contexto importante que o usuário mencionar
+
+4. Salve também em `/logs/LIVE-SESSION/CONTEXT.json`:
+```json
+{
+  "last_task": "descrição da tarefa",
+  "status": "in_progress|completed|blocked",
+  "pending": ["lista de pendências"],
+  "next_steps": ["próximos passos"],
+  "important_files": ["arquivos relevantes"],
+  "notes": "notas do usuário"
+}
+```
+
+5. Confirme ao usuário que foi salvo.
+
+## Formato de Output
+
+```
+[SAVED] Contexto salvo em:
+- /logs/LIVE-SESSION/CURRENT-SESSION.md
+- /logs/LIVE-SESSION/CONTEXT.json
+
+Próxima sessão: execute `/resume` para carregar contexto
+```

package/.claude/commands/scan-inbox.md

@@ -0,0 +1,125 @@
+# Scan INBOX Command
+
+Scan the inbox folder and show files ready for processing.
+
+## Usage
+```
+/scan-inbox
+```
+
+## PRIMEIRA AÇÃO OBRIGATÓRIA
+
+> **ANTES de escanear, LEIA `/system/SESSION-STATE.md`**
+> Para saber quais arquivos já foram processados.
+
+---
+
+## What It Does
+
+1. Lista todas as **fontes** (pastas de pessoas/empresas) em `inbox/`
+2. Para cada fonte, lista **tipos de conteúdo** (PODCASTS, MASTERMINDS, etc.)
+3. Identifica arquivos **não processados** (comparando com `processed-files.md`)
+4. Detecta temas automaticamente por keywords
+5. Sugere próxima ação para cada arquivo pendente
+
+---
+
+## Estrutura Esperada
+
+```
+inbox/
+├── ALEX HORMOZI/
+│   ├── PODCASTS/
+│   │   ├── VIDEO.mp4
+│   │   └── VIDEO.txt
+│   ├── MASTERMINDS/
+│   └── BLUEPRINTS/
+├── COLE GORDON/
+│   └── PODCASTS/
+└── _TEMPLATES/
+```
+
+---
+
+## Output Example
+
+```
+============================================================
+MEGA BRAIN - INBOX SCANNER
+============================================================
+
+📁 ALEX HORMOZI
+   └── PODCASTS/
+       ├── ✅ HOW I SCALED MY SALES TEAM.txt (já processado: SS001)
+       └── ⏳ THE ROLE OF HR.txt (pendente)
+           Detected themes: 03-contratacao, 09-gestao
+           Action: /extract-knowledge "inbox/alex hormozi/PODCASTS/THE ROLE OF HR.txt"
+
+   └── MASTERMINDS/
+       └── ⏳ TAKI MOORE MASTERMIND.mp4 (sem transcrição)
+           Action: /process-video "inbox/alex hormozi/MASTERMINDS/TAKI MOORE MASTERMIND.mp4"
+
+📁 COLE GORDON
+   └── PODCASTS/
+       └── ✅ HIRING SALES MANAGERS.txt (já processado: CG001)
+
+============================================================
+RESUMO
+============================================================
+Fontes: 2
+Arquivos processados: 2
+Arquivos pendentes: 2
+  - Transcrições prontas: 1
+  - Vídeos sem transcrição: 1
+
+PRÓXIMA AÇÃO SUGERIDA:
+/extract-knowledge "inbox/alex hormozi/PODCASTS/THE ROLE OF HR.txt"
+============================================================
+```
+
+---
+
+## Theme Detection Keywords
+
+| Tema | Keywords |
+|------|----------|
+| 01-ESTRUTURA-TIME | team, structure, org, bdr, sds, bc, hierarchy |
+| 02-PROCESSO-VENDAS | sales, process, closing, call, pitch, closer |
+| 03-CONTRATACAO | hiring, recruit, interview, onboard, farm system |
+| 04-COMISSIONAMENTO | compensation, commission, ote, salary, incentive |
+| 05-METRICAS | metric, kpi, conversion, rate, cac, ltv, benchmark |
+| 06-FUNIL-APLICACAO | funnel, pipeline, qualification, lead |
+| 07-PRICING | price, pricing, ticket, discount, offer |
+| 08-FERRAMENTAS | crm, tool, software, tech stack, phone burner |
+| 09-GESTAO | management, leadership, coaching, 1:1, manager |
+| 10-CULTURA-GAMIFICACAO | culture, gamification, motivation, contest |
+
+---
+
+## Status Icons
+
+| Icon | Significado |
+|------|-------------|
+| ✅ | Já processado (existe no registry) |
+| ⏳ | Pendente (transcrição pronta) |
+| 🎬 | Vídeo sem transcrição |
+| 📄 | Documento (PDF, etc.) |
+
+---
+
+## Files to Check
+
+| Arquivo | Propósito |
+|---------|-----------|
+| `/system/SESSION-STATE.md` | Lista de hashes processados |
+| `/system/REGISTRY/processed-files.md` | Detalhes completos |
+| `/agents/DISCOVERY/role-tracking.md` | Funções identificadas |
+
+---
+
+## Integration
+
+Após escanear, o comando sugere automaticamente:
+1. Qual arquivo processar primeiro (prioridade por tipo)
+2. Qual comando usar (`/extract-knowledge` ou `/process-video`)
+3. Quais temas serão provavelmente afetados

package/.claude/commands/setup.md

@@ -0,0 +1,99 @@
+# /setup - First-Time Configuration Wizard
+
+Guia o usuário na configuração inicial do Mega Brain após instalação.
+
+## Instruções
+
+Execute os seguintes passos em sequência, mostrando progresso ao usuário:
+
+### STEP 1: Verificar Python
+```bash
+python --version 2>&1 || python3 --version 2>&1
+```
+- Se Python 3.10+ encontrado: mostrar versão com checkmark
+- Se não encontrado: informar "Python 3.10+ necessário. Instale em https://python.org" e parar
+
+### STEP 2: Verificar Node.js
+```bash
+node --version
+```
+- Se Node.js 18+ encontrado: mostrar versão com checkmark
+- Se não encontrado: informar "Node.js 18+ necessário. Instale em https://nodejs.org" e parar
+
+### STEP 3: Instalar Dependências Python
+Verificar se existe `requirements.txt` na raiz. Se existir:
+```bash
+pip install -r requirements.txt
+```
+Se falhar, tentar:
+```bash
+pip install --user -r requirements.txt
+```
+Se o arquivo não existir, pular este passo informando que será configurado depois.
+
+### STEP 4: Configurar API Keys
+
+Para cada chave abaixo, explicar o serviço e pedir a chave ao usuário.
+Usar a ferramenta AskUserQuestion para cada grupo.
+
+**OBRIGATÓRIA:**
+1. **OPENAI_API_KEY** - "A API da OpenAI fornece o Whisper para transcrição automática de vídeos do YouTube e áudios. Essencial para o /ingest funcionar com vídeos. Obtenha em: https://platform.openai.com/api-keys"
+
+**RECOMENDADA:**
+2. **VOYAGE_API_KEY** - "Voyage AI fornece busca semântica avançada. Permite que o Conclave e agentes encontrem evidências nos materiais inseridos. Obtenha em: https://dash.voyageai.com/api-keys"
+
+**OPCIONAIS (usuário pode pular):**
+3. **ANTHROPIC_API_KEY** - "Não necessária se você usa o Claude Code via assinatura Max ou Pro (o acesso ao Claude já está incluído). Apenas necessária se você pretende rodar scripts autônomos fora do Claude Code. Obtenha em: https://console.anthropic.com/settings/keys"
+4. **GOOGLE_CLIENT_ID** + **GOOGLE_CLIENT_SECRET** - "Para importar conteúdos diretamente do Google Drive (PDFs, documentos, planilhas). Configure em: https://console.cloud.google.com/apis/credentials"
+
+### STEP 5: Validar Configuração
+
+Para cada chave fornecida, testar a conexão:
+- **OpenAI**: Verificar endpoint /models (listar modelos disponíveis)
+- **Voyage AI**: Verificar endpoint /embeddings (teste de embedding)
+- **Anthropic**: Fazer uma chamada simples de teste (se fornecida)
+- **Google Drive**: Verificar OAuth token (se credenciais fornecidas)
+- Para chaves opcionais puladas: mostrar "⏭️ Pulado" ao invés de testar
+
+Mostrar resumo:
+```
+═══════════════════════════════════════════════════════════════
+ 🔌 VALIDAÇÃO DE CONEXÕES
+═══════════════════════════════════════════════════════════════
+
+  OpenAI (Whisper):  [resultado]
+  Voyage AI (RAG):   [resultado ou "⏭️ Pulado"]
+  Anthropic API:     [resultado ou "⏭️ Pulado"]
+  Google Drive:      [resultado ou "⏭️ Pulado"]
+```
+
+### STEP 6: Gerar .env
+
+Criar arquivo `.env` na raiz do projeto com todas as chaves configuradas.
+Usar o template de `bin/templates/env.example` como base, preenchendo os valores fornecidos.
+
+```bash
+# Verificar se .env já existe
+test -f .env && echo "EXISTE" || echo "NAO EXISTE"
+```
+
+Se já existir, perguntar se deseja sobrescrever.
+
+### STEP 7: Exibir Onboarding
+
+Após completar a configuração, exibir o dashboard de status no formato do JARVIS Operational Briefing:
+
+1. Exibir ASCII JARVIS banner
+2. Status do sistema (tabela com progress bars — tudo zerado para instalação nova)
+3. Capacidades: Clonagem Mental, Agentes de Cargo, Conclave (com fases completas)
+4. Checklists de conteúdo: Especialistas + Negócio
+5. Primeiro uso do Conclave
+6. Frase de fechamento JARVIS
+
+Usar o conteúdo da função `showOnboarding()` de `bin/lib/ascii-art.js` como referência visual, mas formatar diretamente no output como texto Markdown para melhor visualização no Claude Code.
+
+### Comportamento de Erro
+
+- Se qualquer step OBRIGATÓRIO falhar, parar e informar claramente o que fazer
+- Se steps OPCIONAIS falharem, continuar e informar que pode ser configurado depois
+- Se o usuário cancelar, salvar progresso parcial no .env com as chaves já configuradas