mega-brain-ai 1.1.0

package/agents/boardroom/README.md

@@ -0,0 +1,238 @@
+# BOARDROOM WARFARE
+## Sistema de Debates em Áudio com Agentes IA
+
+---
+
+## Visão Geral
+
+O **Boardroom Warfare** transforma decisões de negócio em episódios de debate imersivos em áudio. Digital twins de experts reconhecidos (Hormozi, Cole Gordon, etc.) debatem questões estratégicas, com avaliação do Council e síntese final.
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│  📥 INPUT                                                           │
+│  └─ Tema/questão do Pipeline Jarvis ou input manual                │
+│                                                                     │
+│  🎭 DEBATE                                                          │
+│  └─ Agents of Person + Agents of Position confrontam perspectivas  │
+│                                                                     │
+│  ⚖️ COUNCIL                                                         │
+│  └─ Critic + Advocate + Synthesizer avaliam e pontuam              │
+│                                                                     │
+│  🎧 OUTPUT                                                          │
+│  └─ Script .md + Áudio .mp3 com múltiplas vozes                    │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Estrutura de Pastas
+
+```
+agents/boardroom/
+├── CONFIG/                        # Configurações do sistema
+│   ├── BOARDROOM-CONFIG.md        # Config geral e regras
+│   ├── VOICE-PROFILES.md          # Perfis de voz dos agentes
+│   ├── TTS-INTEGRATION.md         # Integração com ElevenLabs
+│   └── voice_mapping.json         # Mapeamento voice_id → agente
+│
+├── TEMPLATES/                     # Templates de episódio
+│   ├── EPISODE-TEMPLATE.md        # Estrutura completa de episódio
+│   └── SCENE-TEMPLATES/           # Templates de cenas
+│       ├── SCENE-DNA-CONSULTATION.md  # Consulta à Constituição
+│       ├── SCENE-AGENT-DEBATE.md      # Debate entre experts
+│       ├── SCENE-COUNCIL.md           # Deliberação do Council
+│       └── SCENE-QUESTION.md          # Pergunta final ao ouvinte
+│
+├── scripts/                       # Scripts Python
+│   ├── audio_generator.py         # Gerador de áudio (ElevenLabs)
+│   └── jarvis_boardroom_hook.py   # Hook de integração com Jarvis
+│
+├── OUTPUTS/                       # Arquivos gerados
+│   ├── scripts/                   # Scripts .md gerados
+│   ├── AUDIO/                     # Arquivos .mp3 finais
+│   └── temp/                      # Arquivos temporários
+│
+├── WORKFLOWS/                     # Guias de workflow
+│   └── WORKFLOW-AUDIO-GENERATION.md
+│
+├── README.md                      # Este arquivo
+├── INTEGRATION-GUIDE.md           # Guia de integração
+└── CHECKLIST-MASTER.md            # Checklist de implementação
+```
+
+---
+
+## Agentes do Sistema
+
+### Agents of Person (Digital Twins)
+
+| Agente | Especialidade | Gatilhos |
+|--------|---------------|----------|
+| **HORMOZI** | Escala, agressividade, "pensar grande" | escala, crescimento, oferta, preço |
+| **COLE_GORDON** | Sistemas de vendas, processos | vendas, closer, time, processo |
+| **BRUNSON** | Funis, copy, marketing | funil, conversão, landing, marketing |
+
+### Agents of Position (Executivos)
+
+| Agente | Papel | Gatilhos |
+|--------|-------|----------|
+| **CRO** | Revenue, vendas | vendas, escala, crescimento |
+| **CFO** | Finanças, viabilidade | comissão, salário, preço |
+| **CMO** | Marketing, marca | funil, marketing, marca |
+| **COO** | Operações, execução | time, processo, operação |
+
+### Council (Avaliadores)
+
+| Agente | Função |
+|--------|--------|
+| **SYNTHESIZER** | Sintetiza posições, propõe resolução, consolida scoring |
+| **METHODOLOGICAL-CRITIC** | Questiona premissas e metodologia |
+| **DEVILS-ADVOCATE** | Ataca posição dominante, expõe riscos |
+
+---
+
+## Estrutura de Episódio (7 Atos)
+
+```
+ATO 1: ABERTURA
+└─ Narrador introduz tema e participantes
+
+ATO 2: CONSTITUIÇÃO
+└─ Citador lê princípio do DNA Cognitivo relevante
+
+ATO 3: DEBATE
+└─ Agents of Person confrontam perspectivas (mín. 3 rodadas)
+
+ATO 4: EXECUTIVOS
+└─ Agents of Position trazem perspectiva de cargo
+
+ATO 5: COUNCIL
+└─ Critic questiona → Advocate ataca → Synthesizer sintetiza
+
+ATO 6: RESOLUÇÃO
+└─ Proposta final com scoring (5 dimensões × /10)
+
+ATO 7: PERGUNTA
+└─ Narrador faz pergunta provocativa ao ouvinte
+```
+
+---
+
+## Scoring do Council
+
+| Dimensão | Descrição |
+|----------|-----------|
+| **Viabilidade** | Implementável no contexto atual? |
+| **Impacto** | Qual o potencial de resultado? |
+| **Risco** | Quais os riscos envolvidos? |
+| **Alinhamento** | Conecta com objetivos maiores? |
+| **Timing** | É o momento certo? |
+
+**Score Final**: Média das 5 dimensões (0-10)
+
+| Score | Classificação |
+|-------|---------------|
+| 9.0+ | EXCELENTE |
+| 8.0-8.9 | MUITO BOM |
+| 7.0-7.9 | BOM |
+| 6.0-6.9 | ACEITÁVEL |
+| <6.0 | REVISAR |
+
+---
+
+## Formato do Script
+
+```markdown
+[PERSONAGEM]
+(instrução de tom/emoção)
+"Texto da fala"
+
+[SOM: descrição do efeito sonoro]
+
+[PAUSA X seg]
+
+[CITADOR]
+"Referência: fonte específica."
+```
+
+---
+
+## Quick Start
+
+### 1. Via Pipeline Jarvis (Automático)
+
+O hook é chamado automaticamente ao final da Fase 8 do Pipeline Jarvis:
+
+```python
+from boardroom.jarvis_boardroom_hook import boardroom_hook
+
+# No final da fase 8:
+boardroom_hook(pipeline_outputs)
+```
+
+### 2. Via CLI (Manual)
+
+```bash
+# Gerar áudio a partir de script existente
+python scripts/audio_generator.py OUTPUTS/scripts/episodio.md
+
+# Modo dry-run (apenas parse)
+python scripts/audio_generator.py episodio.md --dry-run
+
+# Especificar output
+python scripts/audio_generator.py episodio.md --output meu_audio.mp3
+```
+
+### 3. Via Prompt Interativo
+
+Após processar material no Pipeline Jarvis, o sistema pergunta:
+
+```
+📋 PROCESSAMENTO CONCLUÍDO
+═══════════════════════════════════════════════════════════
+
+🎬 BOARDROOM WARFARE
+───────────────────────────────────────────────────────────
+
+Deseja gerar episódio de debate para algum output?
+
+[1] SIM - Selecionar tema para debate
+[2] NÃO - Finalizar processamento
+```
+
+---
+
+## Requisitos
+
+### Dependências Python
+
+```bash
+pip install elevenlabs pydub
+```
+
+### Variáveis de Ambiente
+
+```bash
+export ELEVENLABS_API_KEY=your_key_here
+```
+
+### Configuração de Vozes
+
+Editar `CONFIG/voice_mapping.json` com os voice_ids da sua conta ElevenLabs.
+
+---
+
+## Arquivos de Referência
+
+| Arquivo | Propósito |
+|---------|-----------|
+| [INTEGRATION-GUIDE.md](INTEGRATION-GUIDE.md) | Como integrar com outros sistemas |
+| [CHECKLIST-MASTER.md](CHECKLIST-MASTER.md) | Checklist de implementação |
+| [CONFIG/VOICE-PROFILES.md](CONFIG/VOICE-PROFILES.md) | Perfis detalhados de cada voz |
+| [TEMPLATES/EPISODE-TEMPLATE.md](TEMPLATES/EPISODE-TEMPLATE.md) | Template completo de episódio |
+
+---
+
+## Versão
+
+**v1.0.0** - Sistema inicial com integração Jarvis + ElevenLabs TTS

package/agents/boardroom/config/BOARDROOM-CONFIG.md

@@ -0,0 +1,186 @@
+# ⚙️ BOARDROOM WARFARE - CONFIGURAÇÃO CENTRAL
+## Sistema de Debates Auditivos do Mega Brain
+
+---
+
+## PROPÓSITO
+
+Transformar decisões, análises e playbooks em **episódios de áudio imersivos** onde o ouvinte observa debates reais entre agentes, cada um com sua personalidade, DNA e fontes específicas.
+
+**Princípio fundamental:** ZERO FICÇÃO. Tudo que é dito vem do DNA, das fontes processadas, ou é claramente marcado como síntese do sistema.
+
+---
+
+## CONFIGURAÇÃO GERAL
+
+```yaml
+boardroom_config:
+  version: "1.0"
+
+  # Identificação
+  system_name: "Boardroom Warfare"
+  tagline: "Debates Executivos Sem Filtro"
+
+  # Comportamento
+  fiction_allowed: false          # NUNCA inventar informação
+  source_citation: "always"       # Sempre citar fontes
+  personality_expression: "full"  # DNA completo dos personagens
+  interruptions_allowed: true     # Interrupções naturais
+
+  # Estrutura de episódio
+  episode:
+    min_duration: 15              # minutos
+    max_duration: 35              # minutos
+    default_duration: 25          # minutos
+
+  # Fases obrigatórias
+  mandatory_phases:
+    - opening                     # Contextualização
+    - dna_consultation           # Consulta à constituição
+    - agent_debate               # Debate entre experts
+    - position_analysis          # Análise dos cargos
+    - council_deliberation       # Avaliação do Council
+    - resolution                 # Síntese final
+    - audience_question          # Pergunta ao ouvinte
+
+  # Pós-produção
+  post_episode:
+    ask_narration: true          # Perguntar se quer gerar áudio
+    auto_save_script: true       # Salvar script automaticamente
+    output_path: "agents/boardroom/outputs/"
+```
+
+---
+
+## REGRAS DO DEBATE
+
+### Princípios Invioláveis
+
+1. **FIDELIDADE AO DNA**
+   - Cada personagem só fala o que seu DNA permite
+   - Se não há informação, ele diz "não tenho dados sobre isso"
+   - Gírias e padrões de fala são respeitados
+
+2. **CITAÇÃO OBRIGATÓRIA**
+   - Toda afirmação factual deve ter fonte
+   - Citador anuncia referência após claims importantes
+   - Formato: "Referência: [Fonte], [Local específico]"
+
+3. **PROGRESSÃO DE DEBATE**
+   ```
+   DNA/Constituição → Agents of Person → Agents of Position → Council
+   ```
+   - Nunca pular etapas
+   - Council só entra após debate dos agentes
+   - Pode haver ciclos de volta se Council pedir
+
+4. **CONFLITOS SÃO BEM-VINDOS**
+   - Discordâncias são expostas, não escondidas
+   - Interrupções acontecem naturalmente
+   - Tensão é produtiva
+
+5. **PERGUNTA FINAL OBRIGATÓRIA**
+   - Todo episódio termina com pergunta ao ouvinte
+   - A pergunta deve provocar reflexão/ação
+   - Formato: "E você, [pergunta específica]?"
+
+---
+
+## MAPEAMENTO DE PERSONAGENS
+
+### Sempre Presentes
+| Personagem | Função | Quando Fala |
+|------------|--------|-------------|
+| NARRADOR | Conduz e contextualiza | Transições, explicações |
+| CITADOR | Referencia fontes | Após claims factuais |
+
+### Convocados por Tema
+| Tema | Agents of Person | Agents of Position |
+|------|------------------|-------------------|
+| Vendas | HORMOZI, COLE | CRO, SALES-MANAGER |
+| Marketing | BRUNSON, HORMOZI | CMO, CRO |
+| Escala | HORMOZI, COLE | CRO, COO, CFO |
+
+### Council (Sempre os 3)
+| Membro | Função |
+|--------|--------|
+| METHODOLOGICAL-CRITIC | Questiona método e premissas |
+| DEVILS-ADVOCATE | Ataca posição dominante |
+| SYNTHESIZER | Busca convergência |
+
+---
+
+## TRIGGERS DE CONVOCAÇÃO
+
+```yaml
+convocation_triggers:
+  # Por palavra-chave no tema
+  keywords:
+    "comissão|salário|compensação": ["COLE", "HORMOZI", "CRO", "CFO"]
+    "funil|conversão|landing": ["BRUNSON", "HORMOZI", "CMO"]
+    "oferta|preço|valor": ["HORMOZI", "BRUNSON", "CRO", "CFO"]
+
+  # Mínimo de participantes por fase
+  minimums:
+    agent_debate: 2               # Mínimo 2 Agents of Person
+    position_analysis: 2          # Mínimo 2 Agents of Position
+    council: 3                    # Sempre os 3 membros
+```
+
+---
+
+## FLUXO DE PRODUÇÃO
+
+```
+1. TRIGGER
+   └── Tema/decisão identificada (manual ou pós-pipeline)
+
+2. CONVOCAÇÃO
+   └── Sistema identifica participantes necessários
+
+3. SCRIPT GENERATION
+   └── Gera debate seguindo template e DNA
+
+4. REVIEW (opcional)
+   └── Usuário pode revisar/ajustar script
+
+5. NARRATION PROMPT
+   └── "Deseja iniciar narração do debate? [SIM/NÃO]"
+
+6. TTS GENERATION (se SIM)
+   └── Gera áudio via ElevenLabs
+
+7. SAVE & REFERENCE
+   └── Salva em /outputs/AUDIO/ + gera link
+```
+
+---
+
+## INTEGRAÇÃO COM PIPELINE JARVIS
+
+```yaml
+pipeline_integration:
+  # Quando ativar Boardroom automaticamente
+  auto_trigger:
+    on_playbook_complete: true
+    on_dossier_update: false      # Só manual
+    on_council_decision: true
+    on_synthesis_complete: true
+
+  # Hook pós-processamento
+  post_processing_hook:
+    enabled: true
+    prompt: |
+      ════════════════════════════════════════════
+      📋 PROCESSAMENTO CONCLUÍDO
+
+      Novo conteúdo disponível para debate:
+      • [LISTA DE OUTPUTS]
+
+      🎬 Deseja gerar episódio BOARDROOM WARFARE?
+
+      [1] SIM - Gerar debate sobre este conteúdo
+      [2] NÃO - Apenas salvar outputs
+      [3] SELECIONAR - Escolher tópicos específicos
+      ════════════════════════════════════════════
+```

package/agents/boardroom/config/TTS-INTEGRATION.md

@@ -0,0 +1,258 @@
+# 🔊 TTS INTEGRATION
+## Configuração de Text-to-Speech para Boardroom Warfare
+
+---
+
+## PROVIDER: ELEVENLABS
+
+ElevenLabs é o TTS recomendado por ter:
+- Melhor qualidade em português brasileiro
+- Múltiplas vozes distintas
+- API fácil de integrar
+- Clonagem de voz (opcional)
+
+---
+
+## CONFIGURAÇÃO INICIAL
+
+### Pré-requisitos
+
+1. **Conta ElevenLabs** - https://elevenlabs.io
+2. **API Key** - Gerar em Settings > API
+3. **Plano** - Starter ($5/mês) ou Creator ($22/mês)
+
+### Variáveis de Ambiente
+
+```bash
+# Adicionar ao .env ou exportar
+export ELEVENLABS_API_KEY="sua-api-key-aqui"
+```
+
+### Instalação
+
+```bash
+pip install elevenlabs pydub
+```
+
+---
+
+## MAPEAMENTO DE VOZES
+
+### ⚠️ AÇÃO NECESSÁRIA DO USUÁRIO
+
+Você precisa selecionar vozes no ElevenLabs para cada personagem.
+
+**Opção A: Vozes Pré-existentes (Mais Rápido)**
+Use vozes da biblioteca do ElevenLabs.
+
+**Opção B: Voice Cloning (Mais Autêntico)**
+Clone vozes reais para cada personagem.
+
+### Mapeamento Padrão
+
+```yaml
+voice_mapping:
+  # SISTEMA
+  NARRATOR:
+    voice_id: "[CONFIGURAR]"       # Sugestão: "Daniel" ou voz grave BR
+    description: "Voz grave, calma, sussurrada"
+    settings:
+      stability: 0.7
+      similarity_boost: 0.8
+      style: 0.3
+
+  CITADOR:
+    voice_id: "[CONFIGURAR]"       # Sugestão: Voz neutra BR
+    description: "Voz neutra, sem emoção"
+    settings:
+      stability: 0.9
+      similarity_boost: 0.9
+      style: 0.0
+
+  # AGENTS OF PERSON
+  HORMOZI:
+    voice_id: "[CONFIGURAR]"       # Sugestão: Voz masculina confiante EN
+    description: "Voz alta, rápida, americana"
+    settings:
+      stability: 0.5
+      similarity_boost: 0.75
+      style: 0.6
+
+  COLE_GORDON:
+    voice_id: "[CONFIGURAR]"       # Sugestão: Voz masculina controlada EN
+    description: "Voz grave, lenta, analítica"
+    settings:
+      stability: 0.8
+      similarity_boost: 0.8
+      style: 0.2
+
+  BRUNSON:
+    voice_id: "[CONFIGURAR]"       # Sugestão: Voz masculina energética EN
+    description: "Voz média, rápida, entusiasmada"
+    settings:
+      stability: 0.4
+      similarity_boost: 0.7
+      style: 0.8
+
+    voice_id: "[CONFIGURAR]"       # IMPORTANTE: Voz BR nativa
+    description: "Voz média, português brasileiro"
+    settings:
+      stability: 0.6
+      similarity_boost: 0.75
+      style: 0.4
+
+  # AGENTS OF POSITION
+  CRO:
+    voice_id: "[CONFIGURAR]"       # Voz assertiva
+    description: "Voz alta, impaciente"
+    settings:
+      stability: 0.5
+      similarity_boost: 0.7
+      style: 0.5
+
+  CFO:
+    voice_id: "[CONFIGURAR]"       # Voz grave, seca
+    description: "Voz grave, calculada"
+    settings:
+      stability: 0.8
+      similarity_boost: 0.8
+      style: 0.2
+
+  CMO:
+    voice_id: "[CONFIGURAR]"       # Voz articulada
+    description: "Voz média, estratégica"
+    settings:
+      stability: 0.6
+      similarity_boost: 0.75
+      style: 0.4
+
+  COO:
+    voice_id: "[CONFIGURAR]"       # Voz firme
+    description: "Voz média, pragmática"
+    settings:
+      stability: 0.7
+      similarity_boost: 0.75
+      style: 0.3
+
+  # COUNCIL
+  COUNCIL_CRITIC:
+    voice_id: "[CONFIGURAR]"       # Voz inquisitiva
+    description: "Voz questionadora"
+    settings:
+      stability: 0.6
+      similarity_boost: 0.75
+      style: 0.4
+
+  COUNCIL_ADVOCATE:
+    voice_id: "[CONFIGURAR]"       # Voz provocadora
+    description: "Voz desafiadora"
+    settings:
+      stability: 0.5
+      similarity_boost: 0.7
+      style: 0.6
+
+  COUNCIL_SYNTHESIZER:
+    voice_id: "[CONFIGURAR]"       # Voz serena
+    description: "Voz calma, ponderada"
+    settings:
+      stability: 0.8
+      similarity_boost: 0.8
+      style: 0.2
+```
+
+---
+
+## API REFERENCE
+
+### Gerar Áudio de Um Segmento
+
+```python
+from elevenlabs import generate, set_api_key, Voice, VoiceSettings
+
+set_api_key("sua-api-key")
+
+def generate_segment(text: str, voice_config: dict) -> bytes:
+    """
+    Gera áudio para um segmento de texto.
+
+    Args:
+        text: Texto a ser narrado
+        voice_config: Configuração da voz (voice_id, settings)
+
+    Returns:
+        bytes: Áudio em formato mp3
+    """
+    audio = generate(
+        text=text,
+        voice=Voice(
+            voice_id=voice_config["voice_id"],
+            settings=VoiceSettings(
+                stability=voice_config["settings"]["stability"],
+                similarity_boost=voice_config["settings"]["similarity_boost"],
+                style=voice_config["settings"]["style"],
+            )
+        ),
+        model="eleven_multilingual_v2"  # Importante para PT-BR
+    )
+    return audio
+```
+
+### Listar Vozes Disponíveis
+
+```python
+from elevenlabs import voices
+
+def list_available_voices():
+    """Lista todas as vozes disponíveis na conta."""
+    all_voices = voices()
+    for voice in all_voices:
+        print(f"Nome: {voice.name}, ID: {voice.voice_id}")
+```
+
+---
+
+## LIMITES E CUSTOS
+
+| Plano | Caracteres/mês | Custo | Episódios (~25min) |
+|-------|----------------|-------|-------------------|
+| Free | 10.000 | $0 | ~0.5 |
+| Starter | 30.000 | $5/mês | ~1.5 |
+| Creator | 100.000 | $22/mês | ~5 |
+| Pro | 500.000 | $99/mês | ~25 |
+
+**Estimativa:** Um episódio de 25 minutos tem ~15.000-20.000 caracteres.
+
+---
+
+## FALLBACK: GOOGLE CLOUD TTS
+
+Se ElevenLabs não estiver disponível:
+
+```python
+from google.cloud import texttospeech
+
+def generate_google_tts(text: str, voice_name: str, language: str = "pt-BR"):
+    client = texttospeech.TextToSpeechClient()
+
+    synthesis_input = texttospeech.SynthesisInput(text=text)
+    voice = texttospeech.VoiceSelectionParams(
+        language_code=language,
+        name=voice_name
+    )
+    audio_config = texttospeech.AudioConfig(
+        audio_encoding=texttospeech.AudioEncoding.MP3
+    )
+
+    response = client.synthesize_speech(
+        input=synthesis_input,
+        voice=voice,
+        audio_config=audio_config
+    )
+
+    return response.audio_content
+```
+
+Vozes PT-BR recomendadas no Google:
+- `pt-BR-Neural2-A` (feminina)
+- `pt-BR-Neural2-B` (masculina)
+- `pt-BR-Neural2-C` (feminina)