mega-brain-ai 1.1.0

package/.claude/hooks/enforce_plan_mode.py

@@ -0,0 +1,220 @@
+#!/usr/bin/env python3
+"""
+ENFORCE PLAN MODE HOOK v1.0.0
+=============================
+
+Hook: UserPromptSubmit
+Propósito: Detecta quando o usuário solicita modificação de arquivos e
+           avisa se Plan Mode não foi ativado.
+
+REGRA #13: PLAN MODE OBRIGATÓRIO PARA MODIFICAÇÃO DE ARQUIVOS
+REGRA #29: WARN, NOT BLOCK (avisa, não bloqueia)
+
+Criado: 2026-01-14
+Autor: JARVIS
+"""
+
+import json
+import sys
+import re
+from datetime import datetime
+from pathlib import Path
+
+# Keywords que indicam intenção de modificar arquivos
+MODIFYING_KEYWORDS = [
+    # Português
+    "criar", "crie", "criando", "criação",
+    "atualizar", "atualize", "atualizando", "atualização",
+    "modificar", "modifique", "modificando", "modificação",
+    "implementar", "implemente", "implementando", "implementação",
+    "adicionar", "adicione", "adicionando", "adição",
+    "remover", "remova", "removendo", "remoção",
+    "deletar", "delete", "deletando",
+    "refatorar", "refatore", "refatorando", "refatoração",
+    "corrigir", "corrija", "corrigindo", "correção",
+    "fix", "fixing", "fixed",
+    "editar", "edite", "editando", "edição",
+    "escrever", "escreva", "escrevendo",
+    "gerar", "gere", "gerando", "geração",
+    "mudar", "mude", "mudando", "mudança",
+
+    # Inglês
+    "create", "creating", "creation",
+    "update", "updating",
+    "modify", "modifying", "modification",
+    "implement", "implementing", "implementation",
+    "add", "adding",
+    "remove", "removing", "removal",
+    "delete", "deleting", "deletion",
+    "refactor", "refactoring",
+    "edit", "editing",
+    "write", "writing",
+    "generate", "generating",
+    "change", "changing",
+
+    # Comandos específicos
+    "novo arquivo", "new file",
+    "nova feature", "new feature",
+    "novo hook", "new hook",
+    "nova skill", "new skill",
+    "novo agente", "new agent",
+    "bug fix", "bugfix",
+]
+
+# Keywords que indicam exceções (não precisa Plan Mode)
+EXCEPTION_KEYWORDS = [
+    # Leitura/consulta
+    "mostrar", "show", "exibir", "display",
+    "ler", "read", "leia",
+    "buscar", "search", "find", "procurar",
+    "verificar", "check", "verify",
+    "status", "estado",
+    "listar", "list",
+    "onde estamos", "where are we",
+    "o que é", "what is",
+    "como funciona", "how does",
+    "explique", "explain",
+    "descreva", "describe",
+
+    # Comandos slash (já são skills)
+    "/jarvis", "/status", "/save", "/resume",
+    "/conclave", "/verify", "/config",
+]
+
+# Log file
+LOG_FILE = Path(__file__).parent.parent / "mission-control" / "plan_mode_warnings.jsonl"
+
+
+def check_plan_mode_required(prompt: str) -> dict:
+    """
+    Analisa o prompt para determinar se Plan Mode é necessário.
+
+    Returns:
+        dict com:
+        - required: bool (se Plan Mode é necessário)
+        - keywords_found: list (keywords de modificação encontradas)
+        - exception_found: str|None (exceção que foi encontrada)
+        - confidence: str (HIGH, MEDIUM, LOW)
+    """
+    prompt_lower = prompt.lower()
+
+    # Verificar exceções primeiro
+    for exc in EXCEPTION_KEYWORDS:
+        if exc in prompt_lower:
+            return {
+                "required": False,
+                "keywords_found": [],
+                "exception_found": exc,
+                "confidence": "HIGH"
+            }
+
+    # Verificar keywords de modificação
+    found_keywords = []
+    for kw in MODIFYING_KEYWORDS:
+        # Usar word boundary para evitar falsos positivos
+        pattern = r'\b' + re.escape(kw) + r'\b'
+        if re.search(pattern, prompt_lower):
+            found_keywords.append(kw)
+
+    if not found_keywords:
+        return {
+            "required": False,
+            "keywords_found": [],
+            "exception_found": None,
+            "confidence": "HIGH"
+        }
+
+    # Determinar confiança baseado em quantidade de keywords
+    if len(found_keywords) >= 3:
+        confidence = "HIGH"
+    elif len(found_keywords) >= 2:
+        confidence = "MEDIUM"
+    else:
+        confidence = "LOW"
+
+    return {
+        "required": True,
+        "keywords_found": found_keywords,
+        "exception_found": None,
+        "confidence": confidence
+    }
+
+
+def log_warning(prompt: str, analysis: dict):
+    """Loga warning para auditoria."""
+    try:
+        LOG_FILE.parent.mkdir(parents=True, exist_ok=True)
+
+        entry = {
+            "timestamp": datetime.now().isoformat(),
+            "hook": "enforce_plan_mode",
+            "prompt_preview": prompt[:200] + "..." if len(prompt) > 200 else prompt,
+            "keywords_found": analysis["keywords_found"],
+            "confidence": analysis["confidence"],
+            "action": "WARNING_ISSUED"
+        }
+
+        with open(LOG_FILE, "a", encoding="utf-8") as f:
+            f.write(json.dumps(entry, ensure_ascii=False) + "\n")
+    except Exception:
+        # Não falhar por erro de log
+        pass
+
+
+def main():
+    try:
+        # Ler input do hook
+        input_data = json.loads(sys.stdin.read())
+
+        # Extrair prompt do usuário
+        prompt = input_data.get("prompt", "")
+
+        if not prompt:
+            # Sem prompt, não há o que analisar
+            print(json.dumps({"continue": True}))
+            sys.exit(0)
+
+        # Analisar se Plan Mode é necessário
+        analysis = check_plan_mode_required(prompt)
+
+        if not analysis["required"]:
+            # Não precisa de Plan Mode
+            print(json.dumps({"continue": True}))
+            sys.exit(0)
+
+        # Plan Mode é necessário - emitir WARNING (não bloquear)
+        # REGRA #29: WARN, NOT BLOCK
+
+        log_warning(prompt, analysis)
+
+        # Construir mensagem de aviso
+        warning_msg = (
+            f"[PLAN MODE WARNING] Detectada intenção de modificação de arquivos. "
+            f"Keywords: {', '.join(analysis['keywords_found'][:5])}. "
+            f"Confiança: {analysis['confidence']}. "
+            f"REGRA #13 recomenda Plan Mode para modificações. "
+            f"Use Shift+Tab 2x para ativar ou digite 'plan mode'."
+        )
+
+        # Retornar com aviso (não bloqueia - exit 0)
+        print(json.dumps({
+            "continue": True,
+            "feedback": warning_msg
+        }))
+        sys.exit(0)
+
+    except json.JSONDecodeError:
+        # Input inválido - continuar silenciosamente
+        print(json.dumps({"continue": True}))
+        sys.exit(0)
+    except Exception as e:
+        # Erro inesperado - logar e continuar (não bloquear)
+        print(json.dumps({
+            "continue": True,
+            "warning": f"enforce_plan_mode hook error: {str(e)}"
+        }))
+        sys.exit(0)  # Don't block on internal errors
+
+
+if __name__ == "__main__":
+    main()

package/.claude/hooks/inbox_age_alert.py

@@ -0,0 +1,367 @@
+#!/usr/bin/env python3
+"""
+INBOX AGE ALERT HOOK - REGRA #7 ENFORCEMENT
+============================================
+
+Alerta sobre arquivos antigos no INBOX no inicio de cada sessao.
+
+REGRA #7: INBOX E TEMPORARIO
+- NAO PODE deixar arquivos no INBOX indefinidamente
+- NAO PODE mover para INBOX sem plano de organizacao
+- DEVE organizar cada arquivo que entra no INBOX
+
+Este hook:
+1. Executa no inicio de cada sessao (session_start hook)
+2. Verifica arquivos no INBOX com mais de 3 dias
+3. Se encontrar, gera alerta formatado para o JARVIS exibir
+4. Loga em /logs/inbox_alerts.jsonl
+
+Autor: JARVIS Autonomous System
+Data: 2026-01-11
+"""
+
+import os
+import json
+import sys
+from pathlib import Path
+from datetime import datetime, timedelta
+from typing import List, Dict, Optional
+
+# ==============================================================================
+# CONFIGURACAO
+# ==============================================================================
+
+PROJECT_ROOT = Path(os.environ.get('CLAUDE_PROJECT_DIR', '.'))
+INBOX_PATH = PROJECT_ROOT / "inbox"
+MAX_AGE_DAYS = 3
+ALERT_LOG = PROJECT_ROOT / "logs" / "inbox_alerts.jsonl"
+
+# Extensoes de arquivos para monitorar
+MONITORED_EXTENSIONS = {".txt", ".md", ".docx", ".pdf", ".json", ".yaml", ".yml"}
+
+# Pastas/prefixos a ignorar
+IGNORE_PREFIXES = {"_", ".", "__"}
+IGNORE_FOLDERS = {"_BACKUP", "_OLD", "_ARCHIVE", "__pycache__"}
+
+
+# ==============================================================================
+# FUNCOES PRINCIPAIS
+# ==============================================================================
+
+
+def get_old_files(max_age_days: int = MAX_AGE_DAYS) -> List[Dict]:
+    """
+    Retorna lista de arquivos mais velhos que max_age_days.
+
+    Args:
+        max_age_days: Numero maximo de dias que um arquivo pode ficar no INBOX
+
+    Returns:
+        Lista de dicts com informacoes dos arquivos antigos
+    """
+    old_files = []
+    cutoff = datetime.now() - timedelta(days=max_age_days)
+
+    if not INBOX_PATH.exists():
+        return []
+
+    for root, dirs, files in os.walk(INBOX_PATH):
+        # Ignorar pastas de backup e ocultas
+        dirs[:] = [
+            d
+            for d in dirs
+            if not any(d.startswith(p) for p in IGNORE_PREFIXES)
+            and d not in IGNORE_FOLDERS
+        ]
+
+        for f in files:
+            # Ignorar arquivos ocultos
+            if any(f.startswith(p) for p in IGNORE_PREFIXES):
+                continue
+
+            # Verificar extensao
+            ext = Path(f).suffix.lower()
+            if ext not in MONITORED_EXTENSIONS:
+                continue
+
+            try:
+                fpath = Path(root) / f
+                mtime = datetime.fromtimestamp(fpath.stat().st_mtime)
+
+                if mtime < cutoff:
+                    # Calcular caminho relativo ao INBOX
+                    rel_path = fpath.relative_to(INBOX_PATH)
+                    folder = rel_path.parent if rel_path.parent != Path(".") else "ROOT"
+
+                    old_files.append(
+                        {
+                            "path": str(fpath),
+                            "relative_path": str(rel_path),
+                            "name": f,
+                            "age_days": (datetime.now() - mtime).days,
+                            "folder": str(folder),
+                            "size_kb": round(fpath.stat().st_size / 1024, 2),
+                            "modified_at": mtime.isoformat(),
+                        }
+                    )
+            except (OSError, PermissionError) as e:
+                # Ignorar arquivos inacessiveis
+                continue
+
+    return sorted(old_files, key=lambda x: x["age_days"], reverse=True)
+
+
+def count_by_folder(old_files: List[Dict]) -> Dict[str, int]:
+    """Agrupa arquivos antigos por pasta."""
+    folder_counts = {}
+    for f in old_files:
+        folder = f["folder"]
+        folder_counts[folder] = folder_counts.get(folder, 0) + 1
+    return dict(sorted(folder_counts.items(), key=lambda x: x[1], reverse=True))
+
+
+def generate_alert(old_files: List[Dict]) -> str:
+    """
+    Gera mensagem de alerta formatada no estilo JARVIS.
+
+    Args:
+        old_files: Lista de arquivos antigos
+
+    Returns:
+        String formatada com o alerta
+    """
+    if not old_files:
+        return ""
+
+    folder_counts = count_by_folder(old_files)
+    total_size = sum(f["size_kb"] for f in old_files)
+
+    # Construir alerta visual
+    alert = f"""
++==============================================================================+
+|                    REGRA #7 ALERTA - INBOX TEMPORARIO                        |
++==============================================================================+
+
+ATENCAO, senhor. {len(old_files)} arquivo(s) no INBOX com mais de {MAX_AGE_DAYS} dias.
+
++------------------------------------------------------------------------------+
+|  METRICAS                                                                    |
++------------------------------------------------------------------------------+
+|  Total de arquivos antigos:  {len(old_files):>4}                                            |
+|  Tamanho total:              {total_size:>8.1f} KB                                       |
+|  Arquivo mais antigo:        {old_files[0]["age_days"]:>4} dias                                         |
++------------------------------------------------------------------------------+
+
++------------------------------------------------------------------------------+
+|  POR PASTA                                                                   |
++------------------------------------------------------------------------------+
+"""
+
+    for folder, count in list(folder_counts.items())[:8]:
+        folder_display = folder[:40] if len(folder) <= 40 else folder[:37] + "..."
+        alert += f"|  {folder_display:<42} {count:>3} arquivo(s)                   |\n"
+
+    if len(folder_counts) > 8:
+        alert += f"|  ... e mais {len(folder_counts) - 8} pastas                                                   |\n"
+
+    alert += """+------------------------------------------------------------------------------+
+
++------------------------------------------------------------------------------+
+|  ARQUIVOS MAIS ANTIGOS                                                       |
++------------------------------------------------------------------------------+
+"""
+
+    for f in old_files[:10]:
+        name_display = (
+            f["name"][:50] if len(f["name"]) <= 50 else f["name"][:47] + "..."
+        )
+        alert += f"|  [{f['age_days']:>3}d] {name_display:<50}      |\n"
+
+    if len(old_files) > 10:
+        alert += f"|  ... e mais {len(old_files) - 10} arquivos                                                   |\n"
+
+    alert += """+------------------------------------------------------------------------------+
+
++------------------------------------------------------------------------------+
+|  ACAO RECOMENDADA                                                            |
++------------------------------------------------------------------------------+
+|  Executar: python3 SCRIPTS/organize_inbox_to_knowledge.py --execute          |
+|  Ou:       /inbox para ver lista completa                                    |
++------------------------------------------------------------------------------+
+
+REGRA #7: INBOX E TEMPORARIO - Organizar, nao acumular.
+"""
+
+    return alert
+
+
+def generate_summary(old_files: List[Dict]) -> str:
+    """Gera resumo curto para o contexto do JARVIS."""
+    if not old_files:
+        return ""
+
+    return f"REGRA #7: {len(old_files)} arquivo(s) antigos no INBOX (>{MAX_AGE_DAYS} dias). Mais antigo: {old_files[0]['age_days']} dias."
+
+
+def log_alert(old_files: List[Dict]) -> bool:
+    """
+    Loga alerta em jsonl para historico.
+
+    Args:
+        old_files: Lista de arquivos antigos
+
+    Returns:
+        True se logou com sucesso
+    """
+    try:
+        # Garantir que diretorio existe
+        ALERT_LOG.parent.mkdir(parents=True, exist_ok=True)
+
+        log_entry = {
+            "timestamp": datetime.now().isoformat(),
+            "alert_type": "inbox_age",
+            "rule": "REGRA_7",
+            "total_files": len(old_files),
+            "max_age_days_threshold": MAX_AGE_DAYS,
+            "oldest_file_days": old_files[0]["age_days"] if old_files else 0,
+            "folders_affected": count_by_folder(old_files),
+            "files": old_files[:20],  # Limitar a 20 arquivos no log
+            "action_suggested": "python3 SCRIPTS/organize_inbox_to_knowledge.py --execute",
+        }
+
+        with open(ALERT_LOG, "a", encoding="utf-8") as f:
+            f.write(json.dumps(log_entry, ensure_ascii=False) + "\n")
+
+        return True
+
+    except Exception as e:
+        # Nao bloquear execucao por falha de log
+        sys.stderr.write(f"[INBOX_ALERT] Erro ao logar: {e}\n")
+        return False
+
+
+def check_inbox_health() -> Dict:
+    """
+    Verifica saude geral do INBOX.
+
+    Returns:
+        Dict com metricas de saude
+    """
+    if not INBOX_PATH.exists():
+        return {"status": "error", "message": "INBOX path not found"}
+
+    total_files = 0
+    total_size = 0
+
+    for root, dirs, files in os.walk(INBOX_PATH):
+        # Ignorar pastas de backup
+        dirs[:] = [
+            d
+            for d in dirs
+            if not any(d.startswith(p) for p in IGNORE_PREFIXES)
+            and d not in IGNORE_FOLDERS
+        ]
+
+        for f in files:
+            if any(f.startswith(p) for p in IGNORE_PREFIXES):
+                continue
+            try:
+                fpath = Path(root) / f
+                total_files += 1
+                total_size += fpath.stat().st_size
+            except:
+                continue
+
+    old_files = get_old_files()
+
+    # Determinar status
+    if len(old_files) == 0:
+        status = "healthy"
+    elif len(old_files) < 10:
+        status = "warning"
+    else:
+        status = "critical"
+
+    return {
+        "status": status,
+        "total_files": total_files,
+        "total_size_mb": round(total_size / (1024 * 1024), 2),
+        "old_files_count": len(old_files),
+        "oldest_file_days": old_files[0]["age_days"] if old_files else 0,
+        "threshold_days": MAX_AGE_DAYS,
+    }
+
+
+# ==============================================================================
+# INTEGRACAO COM SESSION_START
+# ==============================================================================
+
+
+def get_session_context(old_files: List[Dict]) -> Dict:
+    """
+    Retorna contexto para integracao com session_start.
+
+    Args:
+        old_files: Lista de arquivos antigos
+
+    Returns:
+        Dict com contexto para o JARVIS
+    """
+    if not old_files:
+        return {"has_alert": False, "summary": "", "alert": ""}
+
+    return {
+        "has_alert": True,
+        "summary": generate_summary(old_files),
+        "alert": generate_alert(old_files),
+        "file_count": len(old_files),
+        "oldest_days": old_files[0]["age_days"],
+        "health": check_inbox_health(),
+    }
+
+
+# ==============================================================================
+# MAIN
+# ==============================================================================
+
+
+def main():
+    """
+    Hook entry point for Claude Code SessionStart event.
+    Reads JSON from stdin, outputs JSON to stdout.
+    """
+    try:
+        input_data = sys.stdin.read()
+        hook_input = json.loads(input_data) if input_data else {}
+
+        old_files = get_old_files()
+
+        if old_files:
+            log_alert(old_files)
+            summary = generate_summary(old_files)
+            print(json.dumps({'continue': True, 'feedback': summary}))
+        else:
+            print(json.dumps({'continue': True}))
+
+    except Exception:
+        print(json.dumps({'continue': True}))
+
+
+def cli_test():
+    """CLI test mode - run directly for debugging."""
+    old_files = get_old_files()
+    if old_files:
+        alert = generate_alert(old_files)
+        print(alert)
+    else:
+        print("[INBOX_ALERT] No old files found. INBOX is clean.")
+
+    health = check_inbox_health()
+    print(f"\nHealth: {json.dumps(health, indent=2)}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1 and sys.argv[1] == '--test':
+        cli_test()
+    else:
+        main()