mega-brain-ai 1.1.0

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()

package/.claude/skills/github-workflow/SKILL.md

@@ -0,0 +1,190 @@
+> **Auto-Trigger:** Quando usuário menciona GitHub, issues, PRs, branches, ou workflow de código
+> **Keywords:** "github", "issue", "pull request", "pr", "branch", "merge", "commit", "workflow"
+> **Prioridade:** ALTA
+> **Tools:** Bash, Read, Write
+
+---
+
+# /github-workflow - Guia do Fluxo GitHub
+
+## Propósito
+
+Este skill guia o usuário através do fluxo GitHub obrigatório definido na **REGRA #30**.
+Todo código modificado DEVE seguir este workflow: **Issue → Branch → PR → Merge**.
+
+---
+
+## Workflow Completo
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                    GITHUB WORKFLOW OBRIGATÓRIO                              │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  1. CRIAR ISSUE                                                             │
+│     ├── Prefixo correto: [FEAT], [FIX], [REFACTOR], [DOCS]                 │
+│     ├── Título descritivo                                                   │
+│     └── Critérios de aceite claros                                         │
+│                                                                             │
+│  2. CRIAR BRANCH                                                            │
+│     ├── Formato: tipo/issue-XX-descricao                                   │
+│     ├── Exemplos:                                                          │
+│     │   feat/issue-42-add-auth                                             │
+│     │   fix/issue-15-memory-leak                                           │
+│     │   refactor/issue-8-cleanup-hooks                                     │
+│     └── git checkout -b tipo/issue-XX-desc                                 │
+│                                                                             │
+│  3. FAZER COMMITS                                                           │
+│     ├── Mensagens descritivas                                              │
+│     ├── Referência à issue: refs #XX                                       │
+│     └── Exemplo: "Add auth module refs #42"                                │
+│                                                                             │
+│  4. ABRIR PULL REQUEST                                                      │
+│     ├── Título claro                                                       │
+│     ├── "Fixes #XX" no body (auto-fecha issue)                             │
+│     ├── Checklist de 6 níveis de verificação                               │
+│     └── Usar template: .github/PULL_REQUEST_TEMPLATE.md                    │
+│                                                                             │
+│  5. VERIFICAR (6 Níveis)                                                    │
+│     ├── 1. Lint/Hooks                                                      │
+│     ├── 2. Tests                                                           │
+│     ├── 3. Build/Integrity                                                 │
+│     ├── 4. Visual                                                          │
+│     ├── 5. Staging                                                         │
+│     └── 6. Security                                                        │
+│                                                                             │
+│  6. MERGE                                                                   │
+│     └── Apenas após todos os níveis passarem                               │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Templates de Issue
+
+### [FEAT] - Nova Funcionalidade
+```bash
+gh issue create --title "[FEAT] Descrição curta" --body "## Descrição
+[Detalhe da feature]
+
+## Critérios de Aceite
+- [ ] Critério 1
+- [ ] Critério 2
+
+## Contexto JARVIS
+- Fase: [X]
+- Regras afetadas: [lista]"
+```
+
+### [FIX] - Correção de Bug
+```bash
+gh issue create --title "[FIX] Descrição do bug" --body "## Bug
+[Descrição do problema]
+
+## Reprodução
+1. Passo 1
+2. Passo 2
+
+## Comportamento Esperado
+[O que deveria acontecer]
+
+## Logs/Screenshots
+[Se aplicável]"
+```
+
+### [REFACTOR] - Refatoração
+```bash
+gh issue create --title "[REFACTOR] Área de refatoração" --body "## Objetivo
+[Por que refatorar]
+
+## Escopo
+- Arquivos afetados: [lista]
+- Impacto: [baixo/médio/alto]
+
+## Abordagem
+[Como será feito]"
+```
+
+---
+
+## Comandos Úteis
+
+### Criar Issue
+```bash
+gh issue create --title "[TIPO] Título" --label "tipo"
+```
+
+### Criar Branch
+```bash
+git checkout -b feat/issue-XX-descricao
+```
+
+### Abrir PR
+```bash
+gh pr create --title "Título do PR" --body "Fixes #XX
+
+## Summary
+- Change 1
+- Change 2
+
+## Verification Checklist
+- [ ] 1. Hooks/Lint passed
+- [ ] 2. Tests passed
+- [ ] 3. Build successful
+- [ ] 4. Visual verification
+- [ ] 5. Staging tested
+- [ ] 6. Security audit"
+```
+
+### Verificar Status
+```bash
+gh pr status
+gh pr checks
+```
+
+---
+
+## 6 Níveis de Verificação
+
+| Nível | Nome | Comando | O que Verifica |
+|-------|------|---------|----------------|
+| 1 | Lint/Hooks | `pre-commit run --all` | Formatação, style |
+| 2 | Tests | `pytest` / `npm test` | Testes automatizados |
+| 3 | Build | `python -m py_compile **/*.py` | Integridade do código |
+| 4 | Visual | Manual | Revisão visual do output |
+| 5 | Staging | Deploy staging | Funciona em ambiente real |
+| 6 | Security | `bandit` / manual | Vulnerabilidades |
+
+---
+
+## Quando NÃO Ativar
+
+- Perguntas gerais sobre git (não sobre o workflow específico)
+- Quando usuário já está no meio de um workflow e sabe o que fazer
+- Consultas sobre histórico de commits sem intenção de modificar
+
+---
+
+## Regras Relacionadas
+
+- **REGRA #30**: GitHub Workflow Obrigatório
+- **REGRA #13**: Plan Mode para modificações
+- **REGRA #8**: Logging obrigatório
+
+---
+
+## Exemplos de Uso
+
+**Usuário:** "Como faço para criar uma issue de feature?"
+**JARVIS:** [Ativa este skill, mostra template de issue FEAT]
+
+**Usuário:** "Preciso fazer um PR para a issue #42"
+**JARVIS:** [Ativa este skill, guia através do processo de PR]
+
+**Usuário:** "Qual o workflow do GitHub?"
+**JARVIS:** [Ativa este skill, mostra diagrama completo]
+
+---
+
+*Para verificação completa de 6 níveis, use `/verify-6-levels`*

package/.claude/skills/hookify/SKILL.md

@@ -0,0 +1,134 @@
+# Hookify Skill
+
+> **Auto-Trigger:** Quando usuário quiser criar hook, regra de segurança, validação customizada, lifecycle hook
+> **Keywords:** "hook", "criar hook", "lifecycle", "safety rule", "validação", "regra de segurança", "pre-tool", "post-tool"
+> **Prioridade:** ALTA
+> **Namespace:** [OFFICIAL]
+> **Tools:** Read, Write, Edit, Glob, Grep
+
+## Quando NÃO Ativar
+
+- Discussões sobre hooks existentes sem intenção de criar novos
+- Debugging de hooks já implementados
+- Perguntas gerais sobre o sistema de hooks
+- Quando usuário explicitamente pedir skill diferente
+
+---
+
+## Core Purpose
+
+Creating custom safety rules and hooks for Claude Code via markdown files with YAML frontmatter.
+Enables pattern detection, regex matching, and warn/block modes for tool usage control.
+
+---
+
+## Hook Structure
+
+### File Format
+
+```markdown
+---
+name: hook-name
+description: What this hook does
+trigger: PreToolUse | PostToolUse | UserPromptSubmit | SessionStart | Stop
+tools: ["Bash", "Write", "Edit"]  # Optional: specific tools to match
+pattern: "regex pattern"  # Optional: content pattern matching
+mode: warn | block  # Default: warn
+---
+
+# Instructions for what to do when triggered
+
+Your custom logic here...
+```
+
+### Trigger Types
+
+| Trigger | When It Fires |
+|---------|---------------|
+| `PreToolUse` | Before any tool execution |
+| `PostToolUse` | After tool execution |
+| `UserPromptSubmit` | When user sends a message |
+| `SessionStart` | At session initialization |
+| `Stop` | At session end |
+
+### Mode Options
+
+| Mode | Behavior |
+|------|----------|
+| `warn` | Alerts but continues execution |
+| `block` | Prevents the action entirely |
+
+---
+
+## Implementation Guidelines
+
+### 1. Identify the Need
+
+- What action should be controlled?
+- When should the hook trigger?
+- Should it warn or block?
+
+### 2. Define Patterns
+
+- Use regex for content matching
+- Specify tools if action-specific
+- Consider edge cases
+
+### 3. Write Instructions
+
+- Clear, concise logic
+- Explain the "why" for debugging
+- Include examples if complex
+
+---
+
+## Example Hooks
+
+### Prevent Dangerous Commands
+
+```markdown
+---
+name: prevent-rm-rf
+description: Blocks recursive force delete commands
+trigger: PreToolUse
+tools: ["Bash"]
+pattern: "rm\\s+-rf"
+mode: block
+---
+
+This command is blocked for safety. Use explicit file deletion instead.
+```
+
+### Warn on Sensitive Files
+
+```markdown
+---
+name: warn-env-access
+description: Warns when accessing environment files
+trigger: PreToolUse
+tools: ["Read", "Edit"]
+pattern: "\\.env"
+mode: warn
+---
+
+You're accessing an environment file. Ensure no secrets are exposed.
+```
+
+---
+
+## Example Prompts This Skill Handles
+
+- "Crie um hook para bloquear comandos perigosos"
+- "Create a safety rule for database operations"
+- "Preciso de uma validação antes de editar arquivos .env"
+- "Make a pre-tool hook that warns about large file writes"
+- "Quero criar regras de segurança customizadas"
+
+---
+
+## Integration Notes
+
+This skill is part of the **Claude Code Official Skills** collection.
+Namespace: `[OFFICIAL]` - Distinguishes from Mega Brain custom skills.
+
+For custom Mega Brain skills, see: `/.claude/skills/`