feat(sprint4): entrega final — UI + LLM integrado + pipeline configurável (≥80% cobertura)

.claude/commands/claudinho.md

@@ -0,0 +1,3 @@
+Você é o Claudinho, mascote e "gerente não oficial" de um grupo de faculdade de Engenharia de Software da UNIPAMPA. Você fala como um colega de turma no grupo do WhatsApp — informal, engraçado, direto, sem parecer IA. Emojis com parcimônia (3-5). Termina SEMPRE com "— Claudinho 🤖". Máximo 15 linhas.
+
+Gere um informe rápido para o grupo sobre: $ARGUMENTS

.claude/commands/diario.md

@@ -0,0 +1,55 @@
+Você é o Claudinho, mascote e "gerente não oficial" de um grupo de faculdade de Engenharia de Software da UNIPAMPA. Você conhece todo mundo pelo nome e acompanha o projeto de perto. Fala como colega de turma no WhatsApp — informal, engraçado, honesto, sem parecer IA ou relatório corporativo. Cita commits e nomes reais. Elogia quem foi bem, cutuca (com carinho) quem ficou parado. Emojis com parcimônia (3-5). Termina SEMPRE com "— Claudinho 🤖". Máximo 20 linhas.
+
+Primeiro colete o contexto do repositório rodando os comandos abaixo, depois gere o relatório diário da sprint.
+
+**Devs e branches:**
+- dev1 (Bernardo) → bernardo
+- dev2 (Pedro) → pedro
+- dev3 (Dean) → dev/dev3
+- dev4 (Frederico) → frederico-barcelos
+- dev5 (Diogo) → diogo
+
+**Sprints:**
+- Fase 1: deadline 04/05/2026 — Estrutura base
+- Fase 2: deadline 11/05/2026 — Transformações (>50% cobertura)
+- Fase 3: deadline 18/05/2026 — LLM + Pipeline (>65% cobertura)
+- Fase 4: deadline 25/05/2026 — UI + Integração (≥80% cobertura)
+- Entrega Final: 01/06/2026
+
+**Passos:**
+
+1. Atualize as referências remotas antes de qualquer análise:
+```bash
+git fetch --all --prune
+```
+
+2. Rode para ver commits da semana por branch:
+```bash
+for branch in bernardo pedro dev/dev3 frederico-barcelos diogo; do echo "=== $branch ==="; git log origin/$branch --since="7 days ago" --no-merges --format="%s" 2>/dev/null; done
+```
+
+3. Rode para ver módulos existentes:
+```bash
+git ls-files src/ | grep -E "/(io|transforms|llm|cache|pipeline|ui)/" | sed 's|/[^/]*$||' | sort -u
+```
+
+4. Rode para ver issues abertas no GitHub da sprint atual (detecta a fase pelo deadline):
+```bash
+python -c "
+import datetime, subprocess, json, sys
+hoje = datetime.date.today()
+fases = [('fase-1','2026-05-04'),('fase-2','2026-05-11'),('fase-3','2026-05-18'),('fase-4','2026-05-25'),('fase-5','2026-06-01')]
+fase = next((f for f,d in fases if hoje <= datetime.date.fromisoformat(d)), 'fase-5')
+print(f'[Sprint atual: {fase}]')
+result = subprocess.run(['gh','issue','list','--repo','frebarcelos/marco-2-rp3','--label',fase,'--state','open','--limit','50','--json','number,title,assignees,labels'], capture_output=True, text=True)
+issues = json.loads(result.stdout or '[]')
+for i in issues:
+    assignees = ', '.join(a['login'] for a in i['assignees']) or '-'
+    print(f\"#{i['number']} [{assignees}] {i['title']}\")
+print(f'Total em aberto: {len(issues)}')
+"
+```
+
+5. Calcule dias restantes até o próximo deadline com base na data de hoje.
+
+6. Com tudo isso em mãos, escreva o informe diário do Claudinho para o grupo.

.claude/settings.local.json

@@ -6,7 +6,45 @@
       "Bash(pip install *)",
       "Bash(PYTHONIOENCODING=utf-8 python *)",
       "Bash(git checkout *)",
-      "Bash(git merge frederico-barcelos --no-ff -m ' *)"
+      "Bash(git merge frederico-barcelos --no-ff -m ' *)",
+      "Bash(git push *)",
+      "Bash(git rebase *)",
+      "Bash(git stash *)",
+      "Bash(pre-commit --version)",
+      "Bash(pre-commit run *)",
+      "Bash(pip show *)",
+      "Bash(pip list *)",
+      "Bash(where python *)",
+      "Bash(git fetch *)",
+      "Bash(python3 *)",
+      "Bash(gh issue *)",
+      "Bash(gh label *)",
+      "Bash(pip3 show *)",
+      "Bash(sample_pr)",
+      "Bash(sample_pr_no_body)",
+      "Bash(sample_prs)",
+      "Bash(sample_csv_file)",
+      "Bash(mock_llm_client)",
+      "Bash(pipx --version)",
+      "Bash(apt list *)",
+      "Bash(pip3 --version)",
+      "Bash(apt-cache show *)",
+      "Bash(git reset *)",
+      "Bash(git restore *)",
+      "Bash(lsb_release -a)",
+      "Read(//usr/lib/**)",
+      "Bash(gh pr *)",
+      "Bash(wait)",
+      "Bash(pip3 install *)",
+      "Bash(/home/barcelosfrederico/.cache/pre-commit/repobczmeh9z/py_env-python3.12/bin/ruff check *)",
+      "Bash(sudo docker ps -a)",
+      "Bash(ps -p 9808 -o pid,ppid,stat,cmd)",
+      "Bash(curl -s http://localhost:11434/api/tags)",
+      "Bash(systemctl is-active *)",
+      "Bash(git remote *)",
+      "Bash(ssh -T -o ConnectTimeout=5 git@github.com)",
+      "Bash(docker compose *)",
+      "Bash(git merge *)"
     ]
   }
 }

.dockerignore

@@ -0,0 +1,25 @@
+# Dados grandes — não entram no build context
+data/
+
+# Ambiente virtual e cache Python
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Git e CI
+.git/
+.github/
+
+# Arquivos de ambiente local
+.env
+*.local
+
+# Docs e scripts auxiliares
+*.md
+scripts/

.env.example

@@ -8,8 +8,14 @@ ANTHROPIC_API_KEY=sk-ant-your_key_here
 # Modelo padrão para classificações (gratuito via Groq)
 LLM_MODEL=llama3-8b-8192
 
-# Caminho para o dataset CSV do Kaggle
+# Caminho para o dataset (CSV ou JSON mined-comments)
 DATASET_PATH=data/github_prs.csv
 
+# Backend LLM: groq (padrão, requer GROQ_API_KEY) | ollama (local, sem API key)
+LLM_BACKEND=groq
+
+# Host do Ollama — use http://host.docker.internal:11434 quando rodar via Docker
+OLLAMA_HOST=http://localhost:11434
+
 # Tamanho máximo do cache LRU para classificações LLM
 LLM_CACHE_SIZE=1024

.gitignore

@@ -182,8 +182,8 @@ data/*.json
 data/*.gz
 data/*.zip
 
-# Resultados de análise persistidos localmente
-cache/
+# Resultados de análise persistidos localmente (só o diretório raiz)
+/cache/
 
 # PyPI configuration file
 .pypirc
@@ -196,4 +196,4 @@ cache/
 .cursorindexingignore
 
 # Configurações locais do Claude Code (contexto pessoal por dev — não versionar)
-.claude/local/
+.claude/local/

.pre-commit-config.yaml

@@ -13,7 +13,7 @@ repos:
     hooks:
       - id: mypy
         args: [--strict, --ignore-missing-imports]
-        additional_dependencies: ["types-all"]
+        exclude: ^tests/
 
   # ── Checagens básicas de arquivo ─────────────────────────────────────────
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -28,50 +28,56 @@ repos:
       - id: check-added-large-files
         args: [--maxkb=500]         # impede commitar o dataset CSV
 
+  # ── Mensagem de commit (Conventional Commits) ────────────────────────────
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v3.4.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args:
+          - feat      # nova funcionalidade
+          - fix       # correção de bug
+          - test      # adição ou correção de testes
+          - docs      # documentação
+          - chore     # manutenção, configs, dependências
+          - refactor  # refatoração sem mudança de comportamento
+          - style     # formatação, espaçamento (sem lógica)
+          - perf      # melhoria de performance
+          - ci        # CI/CD e pipelines
+          - build     # sistema de build, Docker, Makefile
+          - revert    # reverter commit anterior
+
   # ── Verificações locais ───────────────────────────────────────────────────
   - repo: local
     hooks:
 
       # Verificador de paradigma funcional e boas práticas (AST)
-      # Analisa: loops imperativos, mutações in-place, I/O em módulos puros,
-      #          estado global mutável, funções longas, parâmetros sem tipo.
       - id: check-paradigm
         name: "Verificador de paradigma funcional e boas práticas"
         language: python
-        entry: python scripts/check_paradigm.py
+        entry: python -X utf8 scripts/check_paradigm.py
         types: [python]
-        # Roda em TODOS os .py modificados; o script decide quais regras aplicar
-        # com base no caminho do arquivo (puro vs. camada de efeito colateral)
 
-      # Cobertura mínima de testes: 80%
-      # Roda apenas no git push (lento — executa toda a suite de testes)
-      - id: coverage-check
-        name: "Cobertura de testes >= 80%"
+      # Testes unitários básicos (sem cobertura) — roda no pre-push via Docker
+      - id: pytest-unit
+        name: "Testes unitários (sem integração)"
         language: system
-        entry: >
-          pytest tests/ -m "not integration"
-          --cov=src/pr_analyzer
-          --cov-fail-under=80
-          --cov-report=term-missing
-          --tb=short -q --no-header
+        entry: docker compose run --rm -T app python -m pytest tests/ -m "not integration" --tb=short -q --no-header
         pass_filenames: false
-        stages: [pre-push]
+        stages: [push]
 
-      # Testes unitários básicos (sem cobertura) — roda no pre-push também
-      # Separado do coverage-check para feedback mais rápido em caso de falha
-      - id: pytest-unit
-        name: "Testes unitários (sem integração)"
+      # Cobertura mínima de testes: 80% — roda no pre-push via Docker
+      - id: coverage-check
+        name: "Cobertura de testes >= 80%"
         language: system
-        entry: pytest tests/ -m "not integration" --tb=short -q --no-header
+        entry: docker compose run --rm -T app python -m pytest tests/ -m "not integration" --cov=src/pr_analyzer --cov-fail-under=80 --cov-report=term-missing --tb=short -q --no-header
         pass_filenames: false
-        stages: [pre-push]
+        stages: [push]
 
-      # Revisão semântica via Claude API
-      # Analisa conformidade com paradigma funcional, TDD e Clean Code.
-      # Requer ANTHROPIC_API_KEY no .env — se ausente, é ignorado (sem bloqueio).
+      # Revisão semântica via Claude API — roda no pre-push via Docker
       - id: claude-review
         name: "Revisao de codigo (regras locais)"
         language: system
-        entry: python scripts/claude_review.py
+        entry: docker compose run --rm -T app python scripts/claude_review.py
         pass_filenames: false
-        stages: [pre-push]
+        stages: [push]