mega-brain-ai 1.3.0

package/.claude/skills/gdrive-transcription-downloader/SKILL.md

@@ -0,0 +1,249 @@
+# GDRIVE TRANSCRIPTION DOWNLOADER SKILL
+
+---
+name: gdrive-download
+description: Baixa transcrições .docx do Google Drive via OAuth e converte para .txt
+version: 2.0.0
+author: JARVIS
+created: 2026-01-08
+updated: 2026-01-08
+triggers:
+  - baixar transcrições
+  - download drive
+  - extrair transcrições
+  - baixar docx
+  - gdrive download
+---
+
+## PROPÓSITO
+
+Esta skill automatiza o download de transcrições .docx do Google Drive, extração de texto e salvamento como .txt no INBOX do Mega Brain.
+
+---
+
+## ⚠️ REGRA CRÍTICA: EVITAR DUPLICATAS
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  HIERARQUIA DE TRANSCRIÇÕES - BAIXAR APENAS UMA POR VÍDEO                   │
+│                                                                             │
+│  Quando uma pasta no Drive tem estrutura com subpastas:                     │
+│                                                                             │
+│  📂 Pasta Principal/                                                        │
+│  ├── 📄 video1.docx          ← Transcrição SIMPLES (só áudio)              │
+│  ├── 📄 video2.docx                                                         │
+│  └── 📂 Transcrição Visual + Verbal/                                        │
+│      ├── 📄 video1.docx      ← Transcrição COMPLETA (áudio + tela)         │
+│      └── 📄 video2.docx                                                     │
+│                                                                             │
+│  REGRA: Priorizar Visual+Verbal, ignorar simples se ambas existem          │
+│                                                                             │
+│  ALGORITMO:                                                                 │
+│  1. Listar TODOS os arquivos (raiz + subpastas)                            │
+│  2. Identificar duplicatas pelo nome base do vídeo                         │
+│  3. Se duplicata existe:                                                   │
+│     - Manter apenas o da pasta "Visual + Verbal"                           │
+│     - Descartar o da raiz                                                  │
+│  4. Se não há duplicata: baixar normalmente                                │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### Por que isso importa:
+- **151 vídeos** podem virar **302 arquivos** se baixar ambas versões
+- Isso **infla artificialmente** os números
+- A versão Visual+Verbal é **superior** (captura slides, texto na tela)
+- Duplicatas poluem o INBOX e confundem o Pipeline
+
+## QUANDO USAR
+
+1. **Fase 1 - Download:** Quando precisar baixar transcrições faltantes
+2. **Novos materiais:** Quando novas transcrições forem adicionadas ao Drive
+3. **Retry de falhas:** Quando downloads anteriores falharam
+4. **Atualização de inventário:** Após adicionar novos cursos/fontes
+
+## ARQUITETURA
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    GDRIVE DOWNLOADER                            │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  INVENTÁRIO                SCRIPT                   INBOX       │
+│  ┌─────────┐              ┌─────────┐             ┌─────────┐  │
+│  │ JSON    │─────────────▶│ OAuth   │────────────▶│ .txt    │  │
+│  │ fileIDs │              │ python  │             │ files   │  │
+│  └─────────┘              └─────────┘             └─────────┘  │
+│                                                                 │
+│  system/               scripts/                 inbox/    │
+│  DRIVE-TRANS...          download_all...          [FONTE]/      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## COMPONENTES
+
+### 1. Inventário de Transcrições
+**Localização:** `system/DRIVE-TRANSCRIPTIONS-INVENTORY.json`
+
+```json
+{
+  "courses": {
+    "COURSE_KEY": {
+      "folder": "DESTINATION/PATH",
+      "count": N,
+      "files": [
+        {"id": "GOOGLE_DRIVE_FILE_ID", "name": "filename.docx"}
+      ]
+    }
+  }
+}
+```
+
+### 2. Script de Download
+**Localização:** `scripts/download_all_transcriptions.py`
+
+**Dependências:**
+- python-docx (`pip install python-docx`)
+- google-api-python-client (via gdrive_manager)
+
+**Autenticação:**
+- OAuth2 via `scripts/gdrive_manager.py`
+- Token salvo em `~/.config/moga-brain-gdrive/token.json`
+
+### 3. Sistema de Checkpoint
+**Localização:** `.claude/mission-control/DOWNLOAD-CHECKPOINT.json`
+
+Persiste:
+- IDs de arquivos completados
+- Arquivos que falharam (para retry)
+- Último curso processado
+
+## COMANDOS
+
+### Listar cursos disponíveis
+```bash
+# From the project root
+python3 scripts/download_all_transcriptions.py --list
+```
+
+### Baixar todos os cursos
+```bash
+python3 scripts/download_all_transcriptions.py --all
+```
+
+### Baixar curso específico
+```bash
+python3 scripts/download_all_transcriptions.py --course COURSE_KEY
+```
+
+### Continuar de onde parou (resume)
+```bash
+python3 scripts/download_all_transcriptions.py --all --resume
+```
+
+## CURSOS MAPEADOS
+
+| Course Key | Destino | Count |
+|------------|---------|-------|
+| SALES_TRAINING_BR | COLE GORDON/COURSES | 59 |
+| JEREMY_HAYNES_SALES_TRAINING | JEREMY HAYNES/COURSES | 14 |
+| JEREMY_MINER_7TH_LEVEL | JEREMY MINER/COURSES | 40 |
+| ALEX_HORMOZI | ALEX HORMOZI/MARKETING | 2 |
+| JEREMY_HAYNES_PROGRAM | JEREMY HAYNES PROGRAM/COURSES | 2 |
+| COLE_GORDON_EXTRAS | COLE GORDON/MASTERMINDS | 6 |
+
+## FLUXO DE EXECUÇÃO
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  1. VERIFICAR INVENTÁRIO                                        │
+│     └─ Ler system/DRIVE-TRANSCRIPTIONS-INVENTORY.json        │
+├─────────────────────────────────────────────────────────────────┤
+│  2. CARREGAR CHECKPOINT                                         │
+│     └─ Verificar .claude/mission-control/DOWNLOAD-CHECKPOINT    │
+├─────────────────────────────────────────────────────────────────┤
+│  3. AUTENTICAR OAUTH                                            │
+│     └─ Via gdrive_manager.get_drive_service()                   │
+├─────────────────────────────────────────────────────────────────┤
+│  4. PARA CADA ARQUIVO:                                          │
+│     ├─ Skip se já completado (checkpoint)                       │
+│     ├─ Skip se arquivo já existe no destino                     │
+│     ├─ Download .docx do Drive (binary)                         │
+│     ├─ Extrair texto via python-docx                            │
+│     ├─ Salvar como .txt no INBOX                                │
+│     └─ Atualizar checkpoint                                     │
+├─────────────────────────────────────────────────────────────────┤
+│  5. GERAR SUMÁRIO                                               │
+│     └─ Downloaded / Skipped / Failed                            │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## TROUBLESHOOTING
+
+### Token expirado
+O script renova automaticamente. Se persistir:
+```bash
+rm ~/.config/moga-brain-gdrive/token.json
+# Re-executar script (abrirá browser para autenticar)
+```
+
+### Broken pipe errors
+Arquivos grandes ou conexão instável. O checkpoint preserva progresso.
+```bash
+# Re-executar com resume
+python3 scripts/download_all_transcriptions.py --all --resume
+```
+
+### Arquivo não encontrado no Drive
+Verificar se o fileId está correto no inventário.
+```bash
+# Buscar arquivo pelo ID
+python3 -c "
+from SCRIPTS.gdrive_manager import get_drive_service
+svc = get_drive_service()
+print(svc.files().get(fileId='FILE_ID_HERE').execute())
+"
+```
+
+## ADICIONAR NOVOS CURSOS
+
+1. Identificar pasta no Google Drive
+2. Listar arquivos .docx com seus IDs
+3. Adicionar ao inventário JSON:
+```json
+"NEW_COURSE_KEY": {
+  "folder": "FONTE/SUBPASTA",
+  "count": N,
+  "files": [...]
+}
+```
+4. Mapear no script (COURSE_FOLDERS dict)
+5. Executar download
+
+## INTEGRAÇÃO COM PIPELINE
+
+Após download, os arquivos .txt estão prontos para:
+1. **Fase 2.5 - Tagging:** Adicionar [TAG] aos nomes
+2. **Fase 3 - De-Para:** Validar planilha vs computador
+3. **Fase 4 - Pipeline:** Processar chunks/insights
+
+## MÉTRICAS DE SUCESSO
+
+```
+✅ 149/149 arquivos do inventário
+✅ 0 falhas permanentes
+✅ Checkpoint preservado para retry
+✅ Estrutura de pastas correta no INBOX
+```
+
+## HISTÓRICO
+
+| Data | Ação | Resultado |
+|------|------|-----------|
+| 2026-01-08 | Download inicial completo | 149 arquivos |
+| 2026-01-05 | Criação do inventário | 149 entries |
+
+---
+
+**JARVIS SKILL v1.0.0**
+*Automatizando downloads do Google Drive para o Mega Brain*

package/.claude/skills/gemini-fallback/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: gemini-fallback
+description: Usa Gemini CLI para acessar sites bloqueados (Reddit, etc)
+triggers:
+  - "buscar no reddit"
+  - "acessar site bloqueado"
+  - "gemini fetch"
+  - "/gemini"
+---
+
+# Gemini CLI Fallback
+
+Use este skill quando precisar acessar sites que Claude Code não consegue (Reddit, sites com bloqueio).
+
+## Pré-requisitos
+
+```bash
+# Instalar Gemini CLI (se não instalado)
+npm install -g @anthropic-ai/gemini-cli
+# ou
+pip install google-generativeai
+```
+
+## Como Usar
+
+### Via Skill
+```
+/gemini [URL ou query]
+```
+
+### Exemplos
+```
+/gemini https://reddit.com/r/ClaudeAI/top
+/gemini "melhores práticas claude code reddit"
+```
+
+## Execução
+
+Quando acionado, este skill:
+
+1. Verifica se Gemini CLI está disponível
+2. Usa tmux para criar sessão isolada
+3. Executa query via Gemini (que tem acesso web)
+4. Captura e retorna o resultado
+
+### Script de Execução
+
+Execute o script auxiliar:
+```bash
+python3 .claude/skills/gemini-fallback/gemini_fetch.py "URL_OU_QUERY"
+```
+
+## Alternativa Manual
+
+Se Gemini CLI não estiver disponível, use:
+
+1. Abrir nova aba do terminal
+2. Usar browser ou curl para acessar
+3. Copiar conteúdo relevante
+4. Colar no Claude Code
+
+## Sites Comumente Bloqueados
+
+- Reddit (r/ClaudeAI, r/LocalLLaMA)
+- Twitter/X
+- LinkedIn
+- Alguns docs sites

package/.claude/skills/gha/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: gha
+description: Diagnóstico de GitHub Actions failures
+triggers:
+  - "/gha"
+  - "github actions"
+  - "ci failed"
+  - "workflow failed"
+  - "build failed"
+---
+
+# GitHub Actions Diagnostics
+
+Diagnóstico automático de falhas em GitHub Actions.
+
+## Uso
+
+```
+/gha                    # Verifica último workflow run
+/gha [run_id]           # Analisa run específico
+/gha --flaky           # Identifica testes flaky
+/gha --history         # Histórico de falhas
+```
+
+## O Que Faz
+
+1. **Busca último workflow run com falha**
+2. **Baixa logs do job**
+3. **Analisa erro e identifica causa raiz**
+4. **Sugere correção**
+
+## Execução Manual
+
+Se precisar debugar manualmente:
+
+```bash
+# Listar workflows
+gh run list --limit 10
+
+# Ver detalhes de um run
+gh run view [RUN_ID]
+
+# Baixar logs
+gh run view [RUN_ID] --log
+
+# Ver jobs de um run
+gh run view [RUN_ID] --job [JOB_ID]
+```
+
+## Análise Automática
+
+Quando acionado, JARVIS irá:
+
+1. Executar `gh run list --status failure --limit 5`
+2. Identificar o run mais recente
+3. Executar `gh run view [ID] --log`
+4. Analisar os logs buscando:
+   - Erros de teste
+   - Erros de build
+   - Erros de lint
+   - Timeout
+   - Dependências faltando
+5. Reportar causa provável e sugerir fix
+
+## Padrões Comuns de Erro
+
+| Padrão | Causa Provável | Sugestão |
+|--------|----------------|----------|
+| `npm ERR!` | Dependência | `npm ci` ou limpar cache |
+| `ENOENT` | Arquivo faltando | Verificar paths |
+| `timeout` | Teste lento/flaky | Aumentar timeout ou otimizar |
+| `FAILED` em test | Teste quebrado | Ver stack trace |
+| `TypeScript error` | Tipo incorreto | Fix no código |
+| `ESLint` | Lint error | Auto-fix ou manual |
+
+## Exemplo de Output
+
+```
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  GITHUB ACTIONS DIAGNOSTIC                                                   ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  Run ID:      12345678                                                       ║
+║  Workflow:    CI                                                             ║
+║  Status:      FAILED                                                         ║
+║  Duration:    3m 42s                                                         ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  CAUSA RAIZ:                                                                 ║
+║  Test failure in src/__tests__/api.test.ts:42                                ║
+║                                                                              ║
+║  Error: Expected 200, got 404                                                ║
+║                                                                              ║
+║  SUGESTÃO:                                                                   ║
+║  O endpoint /api/users foi removido ou renomeado.                            ║
+║  Verificar se o route existe em src/routes/users.ts                          ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+```

package/.claude/skills/gha/gha_diagnostic.py

@@ -0,0 +1,227 @@
+#!/usr/bin/env python3
+"""
+GITHUB ACTIONS DIAGNOSTIC
+=========================
+Diagnóstico automático de falhas em GitHub Actions.
+
+Usage:
+    python3 gha_diagnostic.py              # Último run com falha
+    python3 gha_diagnostic.py [run_id]     # Run específico
+    python3 gha_diagnostic.py --flaky      # Testes flaky
+    python3 gha_diagnostic.py --history    # Histórico
+"""
+
+import sys
+import subprocess
+import json
+import re
+from datetime import datetime
+
+
+def run_gh(args: list) -> tuple[bool, str]:
+    """Execute gh CLI command"""
+    try:
+        result = subprocess.run(
+            ['gh'] + args,
+            capture_output=True,
+            text=True,
+            timeout=30
+        )
+        if result.returncode == 0:
+            return True, result.stdout
+        return False, result.stderr
+    except Exception as e:
+        return False, str(e)
+
+
+def get_failed_runs(limit: int = 5) -> list:
+    """Get recent failed runs"""
+    success, output = run_gh([
+        'run', 'list',
+        '--status', 'failure',
+        '--limit', str(limit),
+        '--json', 'databaseId,name,conclusion,createdAt,headBranch'
+    ])
+
+    if success:
+        try:
+            return json.loads(output)
+        except:
+            pass
+    return []
+
+
+def get_run_logs(run_id: str) -> str:
+    """Get logs for a specific run"""
+    success, output = run_gh(['run', 'view', run_id, '--log'])
+    if success:
+        return output
+    return f"Error getting logs: {output}"
+
+
+def get_run_details(run_id: str) -> dict:
+    """Get detailed info about a run"""
+    success, output = run_gh([
+        'run', 'view', run_id,
+        '--json', 'databaseId,name,conclusion,createdAt,headBranch,jobs'
+    ])
+
+    if success:
+        try:
+            return json.loads(output)
+        except:
+            pass
+    return {}
+
+
+def analyze_logs(logs: str) -> dict:
+    """Analyze logs to find root cause"""
+    analysis = {
+        'error_type': 'Unknown',
+        'error_message': '',
+        'file': '',
+        'line': '',
+        'suggestion': ''
+    }
+
+    # Common patterns
+    patterns = [
+        # Test failures
+        (r'FAIL\s+(.+\.test\.[jt]sx?)', 'Test Failure', 'Verificar o teste indicado'),
+        (r'AssertionError:\s*(.+)', 'Assertion Failed', 'Verificar expectativa do teste'),
+        (r'Expected:\s*(.+)\s*Received:\s*(.+)', 'Assertion Mismatch', 'Valores não correspondem'),
+
+        # TypeScript errors
+        (r'error TS\d+:\s*(.+)', 'TypeScript Error', 'Corrigir tipo no código'),
+        (r"Property '(\w+)' does not exist", 'Missing Property', 'Adicionar propriedade ao tipo'),
+
+        # Build errors
+        (r'npm ERR!\s*(.+)', 'NPM Error', 'Verificar dependências, rodar npm ci'),
+        (r'Module not found:\s*(.+)', 'Module Not Found', 'Instalar módulo faltante'),
+
+        # ESLint
+        (r'error\s+(.+)\s+@typescript-eslint', 'ESLint Error', 'Corrigir lint error'),
+
+        # Generic errors
+        (r'Error:\s*(.+)', 'Generic Error', 'Ver stack trace para mais detalhes'),
+        (r'ENOENT.*?([^\s]+)', 'File Not Found', 'Verificar se arquivo existe'),
+        (r'timeout', 'Timeout', 'Aumentar timeout ou otimizar'),
+    ]
+
+    for pattern, error_type, suggestion in patterns:
+        match = re.search(pattern, logs, re.IGNORECASE)
+        if match:
+            analysis['error_type'] = error_type
+            analysis['error_message'] = match.group(1) if match.groups() else match.group(0)
+            analysis['suggestion'] = suggestion
+            break
+
+    # Try to find file:line reference
+    file_match = re.search(r'([^\s]+\.[jt]sx?):(\d+)', logs)
+    if file_match:
+        analysis['file'] = file_match.group(1)
+        analysis['line'] = file_match.group(2)
+
+    return analysis
+
+
+def print_diagnostic(run_id: str):
+    """Print full diagnostic for a run"""
+    details = get_run_details(run_id)
+    logs = get_run_logs(run_id)
+    analysis = analyze_logs(logs)
+
+    print("""
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  GITHUB ACTIONS DIAGNOSTIC                                                   ║
+╠══════════════════════════════════════════════════════════════════════════════╣""")
+
+    if details:
+        name = details.get('name', 'Unknown')[:60]
+        branch = details.get('headBranch', 'Unknown')[:30]
+        conclusion = details.get('conclusion', 'Unknown')
+
+        print(f"║  Run ID:      {run_id:<62} ║")
+        print(f"║  Workflow:    {name:<62} ║")
+        print(f"║  Branch:      {branch:<62} ║")
+        print(f"║  Status:      {conclusion:<62} ║")
+
+    print("╠══════════════════════════════════════════════════════════════════════════════╣")
+    print("║  ANÁLISE:                                                                    ║")
+    print(f"║  Tipo:        {analysis['error_type']:<62} ║")
+
+    if analysis['error_message']:
+        msg = analysis['error_message'][:60]
+        print(f"║  Erro:        {msg:<62} ║")
+
+    if analysis['file']:
+        loc = f"{analysis['file']}:{analysis['line']}"[:60]
+        print(f"║  Local:       {loc:<62} ║")
+
+    print("║                                                                              ║")
+    print("║  SUGESTÃO:                                                                   ║")
+    suggestion = analysis['suggestion'][:70]
+    print(f"║  {suggestion:<76} ║")
+
+    print("╚══════════════════════════════════════════════════════════════════════════════╝")
+
+    # Print relevant log snippet
+    if analysis['error_message']:
+        print("\n📋 LOG RELEVANTE:")
+        print("-" * 80)
+        # Find context around error
+        lines = logs.split('\n')
+        for i, line in enumerate(lines):
+            if analysis['error_message'][:30] in line:
+                start = max(0, i - 5)
+                end = min(len(lines), i + 10)
+                print('\n'.join(lines[start:end]))
+                break
+        print("-" * 80)
+
+
+def main():
+    args = sys.argv[1:]
+
+    if '--help' in args or '-h' in args:
+        print(__doc__)
+        return
+
+    # Check gh CLI
+    success, _ = run_gh(['--version'])
+    if not success:
+        print("❌ GitHub CLI (gh) not installed or not authenticated")
+        print("   Install: brew install gh")
+        print("   Auth: gh auth login")
+        return
+
+    if '--history' in args:
+        print("📊 Histórico de falhas recentes:\n")
+        runs = get_failed_runs(10)
+        for run in runs:
+            print(f"  • {run['databaseId']} - {run['name']} ({run['headBranch']})")
+        return
+
+    if '--flaky' in args:
+        print("🔍 Analisando testes flaky...\n")
+        # Get recent runs and look for intermittent failures
+        runs = get_failed_runs(20)
+        print(f"  {len(runs)} falhas nas últimas 20 runs")
+        # Could do more sophisticated analysis here
+        return
+
+    # Get specific run or latest failed
+    if args and args[0].isdigit():
+        run_id = args[0]
+    else:
+        runs = get_failed_runs(1)
+        if not runs:
+            print("✅ Nenhuma falha recente encontrada!")
+            return
+        run_id = str(runs[0]['databaseId'])
+
+    print_diagnostic(run_id)
+
+
+if __name__ == '__main__':
+    main()