mega-brain-ai 1.3.0

package/agents/boardroom/CHECKLIST-MASTER.md

@@ -0,0 +1,281 @@
+# BOARDROOM WARFARE - Checklist Master
+## Checklist completo para implementação e uso do sistema
+
+---
+
+## 1. Setup Inicial
+
+### Dependências
+
+- [ ] Python 3.8+ instalado
+- [ ] pip install elevenlabs
+- [ ] pip install pydub
+- [ ] ffmpeg instalado (para pydub no Windows)
+
+### Configuração de Ambiente
+
+- [ ] ELEVENLABS_API_KEY configurada como variável de ambiente
+- [ ] Conta ElevenLabs com créditos disponíveis
+- [ ] Acesso aos voice_ids das vozes desejadas
+
+### Estrutura de Pastas
+
+- [ ] agents/boardroom/ criado
+- [ ] CONFIG/ com arquivos de configuração
+- [ ] TEMPLATES/ com templates de episódio
+- [ ] scripts/ com scripts Python
+- [ ] OUTPUTS/scripts/ para scripts gerados
+- [ ] OUTPUTS/AUDIO/ para áudios gerados
+- [ ] OUTPUTS/temp/ para arquivos temporários
+
+---
+
+## 2. Configuração de Vozes
+
+### Mapeamento Obrigatório
+
+Editar `CONFIG/voice_mapping.json`:
+
+- [ ] NARRATOR - voz do narrador
+- [ ] CITADOR - voz para citações
+- [ ] HORMOZI - voz de Alex Hormozi
+- [ ] COLE_GORDON - voz de Cole Gordon
+- [ ] BRUNSON - voz de Russell Brunson
+- [ ] CRO - voz do Chief Revenue Officer
+- [ ] CFO - voz do Chief Financial Officer
+- [ ] CMO - voz do Chief Marketing Officer
+- [ ] COO - voz do Chief Operating Officer
+- [ ] METHODOLOGICAL-CRITIC - voz do Critic
+- [ ] DEVILS-ADVOCATE - voz do Advocate
+- [ ] SYNTHESIZER - voz do Sintetizador
+
+### Verificação de voice_ids
+
+- [ ] Cada voice_id corresponde a uma voz válida na conta ElevenLabs
+- [ ] Vozes testadas individualmente antes de episódio completo
+- [ ] Settings (stability, similarity_boost, style) ajustados por personagem
+
+---
+
+## 3. Integração com Pipeline Jarvis
+
+### Arquivos de Integração
+
+- [ ] jarvis_boardroom_hook.py em scripts/
+- [ ] Import adicionado no jarvis_pipeline.py
+- [ ] Hook chamado ao final da Fase 8
+
+### Código de Integração
+
+```python
+# Verificar se está no jarvis_pipeline.py:
+from boardroom.jarvis_boardroom_hook import boardroom_hook
+
+# No final da fase 8:
+boardroom_hook(pipeline_outputs)
+```
+
+### Formato de Output
+
+- [ ] pipeline_outputs é lista de dicts
+- [ ] Cada dict tem: type, title, path, content
+- [ ] content contém texto para análise de keywords
+
+---
+
+## 4. Pré-Geração de Episódio
+
+### Análise do Tema
+
+- [ ] Tema claramente definido
+- [ ] Keywords identificadas para detecção de participantes
+- [ ] Relevância verificada (tema polêmico ou com múltiplas perspectivas)
+
+### Participantes Detectados
+
+- [ ] Mínimo 2 Agents of Person
+- [ ] Mínimo 2 Agents of Position
+- [ ] Council completo (Critic, Advocate, Synthesizer)
+- [ ] Participantes fazem sentido para o tema
+
+### DNA Cognitivo
+
+- [ ] DNA dos participantes existe em knowledge/dna/
+- [ ] Princípios relevantes identificados para citação
+- [ ] Heurísticas disponíveis para posicionamento
+
+---
+
+## 5. Geração do Script
+
+### Estrutura do Episódio
+
+- [ ] ATO 1: Abertura com narrador
+- [ ] ATO 2: Citação da Constituição (DNA)
+- [ ] ATO 3: Debate entre Agents of Person (mín. 3 rodadas)
+- [ ] ATO 4: Perspectiva dos Agents of Position
+- [ ] ATO 5: Deliberação do Council
+- [ ] ATO 6: Resolução com scoring
+- [ ] ATO 7: Pergunta provocativa ao ouvinte
+
+### Formatação do Script
+
+- [ ] Personagens em [CAIXA_ALTA]
+- [ ] Instruções em (parênteses)
+- [ ] Textos em "aspas"
+- [ ] Sons em [SOM: descrição]
+- [ ] Pausas em [PAUSA X seg]
+- [ ] Citações com [CITADOR]
+
+### Qualidade do Conteúdo
+
+- [ ] Posições são distintas e confrontantes
+- [ ] Argumentos baseados em DNA real dos personagens
+- [ ] Gírias e tom característicos de cada agente
+- [ ] Tensão produtiva (não resolver fácil demais)
+- [ ] Council questiona premissas, não só opina
+- [ ] Scoring com justificativas claras
+- [ ] Pergunta final é pessoal e provocativa
+
+---
+
+## 6. Geração de Áudio
+
+### Pré-Requisitos
+
+- [ ] Script salvo em OUTPUTS/scripts/
+- [ ] ELEVENLABS_API_KEY válida
+- [ ] Créditos suficientes na conta
+- [ ] voice_mapping.json configurado
+
+### Comando de Geração
+
+```bash
+python scripts/audio_generator.py OUTPUTS/scripts/script.md
+```
+
+### Verificações Durante Geração
+
+- [ ] Parse identifica todos os segmentos
+- [ ] Cada speaker tem voice_id válido
+- [ ] Áudios individuais gerados em temp/
+- [ ] Concatenação sem erros
+- [ ] Arquivo final em OUTPUTS/AUDIO/
+
+### Pós-Geração
+
+- [ ] Arquivos temp/ limpos
+- [ ] Duração do áudio razoável (5-15 minutos típico)
+- [ ] Qualidade de áudio verificada
+- [ ] Transições entre vozes naturais
+
+---
+
+## 7. Quality Assurance
+
+### Script Review
+
+- [ ] Todas as posições são autênticas ao DNA
+- [ ] Não há "floreios" ou texto inventado
+- [ ] Citações são rastreáveis
+- [ ] Scoring é justificado
+- [ ] Pergunta final é impactante
+
+### Áudio Review
+
+- [ ] Vozes distinguíveis entre si
+- [ ] Tom apropriado para cada personagem
+- [ ] Pausas em momentos corretos
+- [ ] Sem cortes abruptos
+- [ ] Duração total adequada
+
+### Conteúdo Review
+
+- [ ] Debate tem tensão real
+- [ ] Council adiciona valor (não só concorda)
+- [ ] Resolução faz sentido
+- [ ] Ouvinte sai com ação clara
+
+---
+
+## 8. Troubleshooting Checklist
+
+### Script Não Gera
+
+- [ ] Verificar formato do script (.md)
+- [ ] Verificar encoding (UTF-8)
+- [ ] Verificar regex de parse
+- [ ] Testar com --dry-run primeiro
+
+### Áudio Não Gera
+
+- [ ] Verificar ELEVENLABS_API_KEY
+- [ ] Verificar voice_ids no mapping
+- [ ] Verificar créditos na conta
+- [ ] Verificar conexão de internet
+
+### Vozes Incorretas
+
+- [ ] Nome do speaker exatamente como no mapping
+- [ ] CAIXA_ALTA consistente
+- [ ] Fallback para NARRATOR funcionando
+
+### Áudio Com Problemas
+
+- [ ] pydub instalado corretamente
+- [ ] ffmpeg instalado (Windows)
+- [ ] Arquivos temp não corrompidos
+- [ ] Formato de saída correto (.mp3)
+
+---
+
+## 9. Checklist por Episódio
+
+### Antes de Começar
+
+```
+[ ] Tema definido: ________________________________
+[ ] Keywords: _____________________________________
+[ ] Participantes esperados: ______________________
+[ ] Princípio para Constituição: __________________
+```
+
+### Durante Geração
+
+```
+[ ] Script gerado em: _____________________________
+[ ] Segmentos identificados: ______________________
+[ ] Duração estimada: _____________________________
+```
+
+### Após Conclusão
+
+```
+[ ] Áudio salvo em: _______________________________
+[ ] Duração final: ________________________________
+[ ] Review de qualidade: [ ] Script [ ] Áudio [ ] Conteúdo
+[ ] Aprovado para distribuição: [ ] Sim [ ] Não
+```
+
+---
+
+## 10. Manutenção Contínua
+
+### Semanal
+
+- [ ] Verificar créditos ElevenLabs
+- [ ] Limpar pasta temp/ se necessário
+- [ ] Backup de scripts aprovados
+
+### Mensal
+
+- [ ] Atualizar voice_mapping se novas vozes
+- [ ] Revisar KEYWORD_MAPPING para novos temas
+- [ ] Atualizar templates se necessário
+
+### Por Versão
+
+- [ ] Documentar mudanças em CHANGELOG
+- [ ] Atualizar README.md se necessário
+- [ ] Testar integração com Jarvis
+- [ ] Verificar compatibilidade de dependências

package/agents/boardroom/INTEGRATION-GUIDE.md

@@ -0,0 +1,406 @@
+# BOARDROOM WARFARE - Guia de Integração
+## Como integrar o sistema de debates com outros componentes
+
+---
+
+## 1. Integração com Pipeline Jarvis
+
+### Ponto de Integração
+
+O Boardroom Warfare se conecta ao Pipeline Jarvis na **Fase 8** (Finalização).
+
+```
+Pipeline Jarvis
+│
+├── Fase 1-7: Processamento normal
+│
+└── Fase 8: Finalização
+    │
+    └── 8.X: BOARDROOM HOOK ← Ponto de integração
+        │
+        ├── Detecta participantes relevantes
+        ├── Gera script de debate
+        └── Oferece opção de narração
+```
+
+### Como Ativar
+
+No arquivo `jarvis_pipeline.py` ou equivalente, adicione ao final da Fase 8:
+
+```python
+from boardroom.jarvis_boardroom_hook import boardroom_hook
+
+# Ao final da fase 8, após todos os outputs:
+pipeline_outputs = [
+    {
+        "type": "playbook",
+        "title": "Estrutura de Comissão para Time de Vendas",
+        "path": "knowledge/playbooks/PLAYBOOK-COMISSAO.md",
+        "content": "Conteúdo do playbook..."
+    },
+    {
+        "type": "dossier",
+        "title": "Dossiê Cole Gordon",
+        "path": "knowledge/dossiers/persons/DOSSIER-COLE-GORDON.md",
+        "content": "Conteúdo do dossiê..."
+    }
+]
+
+# Chamar o hook
+boardroom_hook(pipeline_outputs, auto_prompt=True)
+```
+
+### Formato do Output Esperado
+
+```python
+pipeline_outputs = [
+    {
+        "type": str,      # "playbook", "dossier", "source", etc.
+        "title": str,     # Título do output
+        "path": str,      # Caminho do arquivo gerado
+        "content": str    # Conteúdo para análise de keywords (opcional)
+    }
+]
+```
+
+---
+
+## 2. Detecção Automática de Participantes
+
+### Mapeamento de Keywords
+
+O sistema usa keywords para detectar quais agentes devem participar:
+
+```python
+KEYWORD_MAPPING = {
+    # Tema → Agentes relevantes
+    "comissão": ["COLE_GORDON", "HORMOZI", "CRO", "CFO"],
+    "salário": ["COLE_GORDON", "HORMOZI", "CRO", "CFO"],
+    "vendas": ["COLE_GORDON", "HORMOZI", "CRO"],
+    "closer": ["COLE_GORDON", "HORMOZI", "CRO"],
+    "funil": ["BRUNSON", "HORMOZI", "CMO"],
+    "conversão": ["BRUNSON", "HORMOZI", "CMO"],
+    "oferta": ["HORMOZI", "BRUNSON", "CRO"],
+    "preço": ["HORMOZI", "CFO", "CRO"],
+    "marketing": ["BRUNSON", "CMO"],
+}
+```
+
+### Customização
+
+Para adicionar novos mapeamentos, edite `scripts/jarvis_boardroom_hook.py`:
+
+```python
+# Adicionar novo mapeamento
+KEYWORD_MAPPING["seu_tema"] = ["AGENT_1", "AGENT_2", "POSITION_1"]
+```
+
+### API de Detecção
+
+```python
+from boardroom.jarvis_boardroom_hook import detect_participants
+
+participants = detect_participants(
+    topic="Estrutura de comissão para closers",
+    content="Texto adicional para análise..."
+)
+
+# Retorna:
+{
+    "persons": ["COLE_GORDON", "HORMOZI"],      # Max 4
+    "positions": ["CRO", "CFO"],                 # Max 4
+    "council": ["METHODOLOGICAL-CRITIC", "DEVILS-ADVOCATE", "SYNTHESIZER"]
+}
+```
+
+---
+
+## 3. Integração com ElevenLabs TTS
+
+### Configuração Inicial
+
+1. **Obter API Key**: Criar conta em [elevenlabs.io](https://elevenlabs.io)
+
+2. **Configurar variável de ambiente**:
+```bash
+export ELEVENLABS_API_KEY=your_api_key_here
+```
+
+3. **Mapear vozes**: Editar `CONFIG/voice_mapping.json`:
+```json
+{
+    "NARRATOR": {
+        "voice_id": "seu_voice_id_aqui",
+        "settings": {
+            "stability": 0.7,
+            "similarity_boost": 0.8,
+            "style": 0.3
+        }
+    },
+    "HORMOZI": {
+        "voice_id": "seu_voice_id_aqui",
+        "settings": {
+            "stability": 0.5,
+            "similarity_boost": 0.75,
+            "style": 0.6
+        }
+    }
+}
+```
+
+### Modelo Utilizado
+
+O sistema usa `eleven_multilingual_v2` para suporte a português:
+
+```python
+audio = generate(
+    text=segment.text,
+    voice=Voice(
+        voice_id=voice_config["voice_id"],
+        settings=VoiceSettings(...)
+    ),
+    model="eleven_multilingual_v2"
+)
+```
+
+### Fallback de Vozes
+
+Se uma voz não está configurada, o sistema usa NARRATOR como fallback:
+
+```python
+voice_config = voice_mapping.get(speaker_key)
+if not voice_config:
+    voice_config = voice_mapping.get("NARRATOR")
+```
+
+---
+
+## 4. Integração com DNA Cognitivo
+
+### Consultando o DNA
+
+Os agentes devem consultar seu DNA antes de gerar posições:
+
+```
+DNA Cognitivo (knowledge/dna/persons/{PESSOA}/)
+│
+├── CONFIG.yaml      → Metadados e fontes
+├── PRINCIPIOS.yaml  → Princípios fundamentais
+├── HEURISTICAS.yaml → Regras de decisão
+├── FRAMEWORKS.yaml  → Modelos mentais
+└── METODOLOGIAS.yaml → Processos e táticas
+```
+
+### No Script de Debate
+
+O CITADOR referencia o DNA:
+
+```markdown
+[CITADOR]
+"Referência: DNA Cognitivo de Hormozi, camada de Heurísticas,
+princípio 'Pay per performance, not per presence'."
+```
+
+---
+
+## 5. Integração com Sistema de Agentes
+
+### Mapeamento Agent IA → Boardroom
+
+| Agent IA (agents/) | Boardroom Agent |
+|-----------------------|-----------------|
+| AGENT-CRO | CRO |
+| AGENT-CFO | CFO |
+| AGENT-CMO | CMO |
+| AGENT-COO | COO |
+| AGENT-CLOSER | (via COLE_GORDON) |
+
+### Usando Memórias dos Agentes
+
+Os agentes podem consultar MEMORY para decisões precedentes:
+
+```python
+# Em geração de script
+memory_path = "agents/cargo/C-LEVEL/CRO/MEMORY.md"
+# Consultar decisões anteriores relevantes ao tema
+```
+
+---
+
+## 6. Integração com Council System
+
+### Ativação do Council
+
+O Council é ativado automaticamente em todo episódio (Ato 5):
+
+```
+1. SYNTHESIZER → Resume posições do debate
+2. METHODOLOGICAL-CRITIC → Questiona premissas
+3. DEVILS-ADVOCATE → Ataca posição dominante
+4. SYNTHESIZER → Propõe resolução + scoring
+```
+
+### Formato de Scoring
+
+```markdown
+SCORING:
+- Viabilidade: 8/10 - implementável em 90 dias
+- Impacto: 8/10 - resolve raiz, não sintoma
+- Risco: 7/10 - risco controlado por fases
+- Alinhamento: 9/10 - conecta com retenção
+- Timing: 8/10 - momento adequado
+
+Score final: 8.0 - Classificação: MUITO BOM
+Recomendação: IMPLEMENTAR
+```
+
+---
+
+## 7. Integração via CLI
+
+### Comandos Disponíveis
+
+```bash
+# Gerar áudio de script existente
+python agents/boardroom/scripts/audio_generator.py \
+    agents/boardroom/outputs/scripts/episodio.md
+
+# Com output customizado
+python agents/boardroom/scripts/audio_generator.py \
+    episodio.md \
+    --output meu_episodio.mp3
+
+# Dry-run (apenas parse)
+python agents/boardroom/scripts/audio_generator.py \
+    episodio.md \
+    --dry-run
+```
+
+### Integração com Outros Scripts
+
+```python
+from boardroom.audio_generator import (
+    parse_script,
+    generate_episode_audio
+)
+
+# Parse de script
+segments = parse_script(Path("script.md"))
+print(f"{len(segments)} segmentos encontrados")
+
+# Geração completa
+audio_path = generate_episode_audio(
+    script_path=Path("script.md"),
+    output_path=Path("output.mp3")
+)
+```
+
+---
+
+## 8. Fluxo de Dados Completo
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                     FLUXO DE INTEGRAÇÃO                             │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  Pipeline Jarvis (Fases 1-7)                                        │
+│       │                                                             │
+│       ▼                                                             │
+│  pipeline_outputs[] ──────────────────────────────────────────────┐ │
+│       │                                                           │ │
+│       ▼                                                           │ │
+│  boardroom_hook()                                                 │ │
+│       │                                                           │ │
+│       ├── detect_participants(topic, content)                     │ │
+│       │       │                                                   │ │
+│       │       ├── KEYWORD_MAPPING                                 │ │
+│       │       └── Returns: {persons, positions, council}          │ │
+│       │                                                           │ │
+│       ├── generate_episode_script()                               │ │
+│       │       │                                                   │ │
+│       │       ├── EPISODE-TEMPLATE.md                             │ │
+│       │       ├── SCENE-TEMPLATES/*                               │ │
+│       │       ├── DNA Cognitivo (para citações)                   │ │
+│       │       └── Saves: OUTPUTS/scripts/BWE-*.md                 │ │
+│       │                                                           │ │
+│       └── [Se usuário aceitar narração]                           │ │
+│               │                                                   │ │
+│               ▼                                                   │ │
+│           generate_episode_audio()                                │ │
+│               │                                                   │ │
+│               ├── parse_script() → Segments[]                     │ │
+│               ├── voice_mapping.json                              │ │
+│               ├── ElevenLabs API                                  │ │
+│               │       └── eleven_multilingual_v2                  │ │
+│               ├── pydub (concatenação)                            │ │
+│               └── Saves: OUTPUTS/AUDIO/*.mp3                      │ │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 9. Troubleshooting
+
+### Problema: "ElevenLabs não está instalado"
+
+```bash
+pip install elevenlabs
+```
+
+### Problema: "ELEVENLABS_API_KEY não configurada"
+
+```bash
+export ELEVENLABS_API_KEY=your_key_here
+```
+
+### Problema: "voice_id não configurado para: AGENT"
+
+Editar `CONFIG/voice_mapping.json` e adicionar o voice_id correto.
+
+### Problema: "pydub não instalado"
+
+```bash
+pip install pydub
+# No Windows, também instalar ffmpeg
+```
+
+### Problema: Voz não reconhecida no script
+
+Verificar se o nome do personagem está em CAIXA ALTA e corresponde ao mapeamento:
+
+```markdown
+# Correto
+[HORMOZI]
+
+# Incorreto
+[Hormozi]
+[Alex Hormozi]
+```
+
+---
+
+## 10. Extensão do Sistema
+
+### Adicionar Novo Agente
+
+1. Adicionar em `KEYWORD_MAPPING` (jarvis_boardroom_hook.py)
+2. Adicionar perfil em `CONFIG/VOICE-PROFILES.md`
+3. Adicionar voice_id em `CONFIG/voice_mapping.json`
+4. Testar com script de exemplo
+
+### Adicionar Novo Tipo de Cena
+
+1. Criar template em `TEMPLATES/SCENE-TEMPLATES/`
+2. Seguir padrão dos templates existentes
+3. Documentar em `TEMPLATES/EPISODE-TEMPLATE.md`
+
+### Customizar Scoring
+
+Editar a seção de Council em `TEMPLATES/SCENE-TEMPLATES/SCENE-COUNCIL.md`:
+
+```markdown
+SCORING:
+- [Nova Dimensão]: [X]/10 - [justificativa]
+```