airev 1.2.0__tar.gz → 1.3.0__tar.gz

{airev-1.2.0 → airev-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airev
-Version: 1.2.0
+Version: 1.3.0
 Summary: CLI tool for AI-powered code review with context backtracking
 Author-email: Tarcisio <tarcisiojunior@gmail.com>
 License: MIT

{airev-1.2.0 → airev-1.3.0}/src/airev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airev
-Version: 1.2.0
+Version: 1.3.0
 Summary: CLI tool for AI-powered code review with context backtracking
 Author-email: Tarcisio <tarcisiojunior@gmail.com>
 License: MIT

{airev-1.2.0 → airev-1.3.0}/src/airev.egg-info/SOURCES.txt

@@ -29,6 +29,7 @@ src/code_reviewer/updater/http_client.py
 src/code_reviewer/updater/notifier.py
 src/code_reviewer/updater/upgrade.py
 src/code_reviewer/updater/version_check.py
+tests/test_cli.py
 tests/test_context_builder.py
 tests/test_copilot_runner.py
 tests/test_diff_parser.py

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/__init__.py

@@ -1,3 +1,3 @@
 """Code Reviewer - CLI para revisão de código com IA."""
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/cli.py

@@ -75,6 +75,13 @@ def main():
     type=click.Choice(get_available_languages()),
     help="Idioma das mensagens (default: pt-br)",
 )
+@click.option(
+    "--text-quality",
+    "-t",
+    is_flag=True,
+    default=False,
+    help="Ativa verificação de ortografia e clareza em mensagens de usuário",
+)
 def review(
     base: str,
     runner: str,
@@ -83,6 +90,7 @@ def review(
     no_progress: bool,
     progress: bool,
     lang: str,
+    text_quality: bool,
 ):
     """Analisa o diff da branch atual contra a branch base.
 
@@ -95,6 +103,8 @@ def review(
         airev review --base main --json-output
 
         airev review --base main --no-progress
+
+        airev review --base main --text-quality
     """
     workdir = workdir or Path.cwd()
     start_time = time.perf_counter()
@@ -173,7 +183,9 @@ def review(
 
     # Monta o prompt
     with reporter.status(t("cli.building_prompt")):
-        prompt = build_prompt(diff_files, context_graphs, current_branch, base)
+        prompt = build_prompt(
+            diff_files, context_graphs, current_branch, base, text_quality=text_quality
+        )
 
     # Obtém o runner
     try:

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/formatters/terminal.py

@@ -5,7 +5,7 @@ from typing import TextIO
 import sys
 
 from ..i18n import t
-from ..models import Finding, ReviewResult, Severity
+from ..models import Category, Finding, ReviewResult, Severity
 
 
 # Códigos ANSI para cores
@@ -71,6 +71,28 @@ def format_severity(severity: Severity) -> str:
         return _colorize(f"[{severity.value}]", Colors.BOLD, Colors.BLUE)
 
 
+def format_category_badge(category: Category) -> str:
+    """Formata o badge da categoria.
+
+    Args:
+        category: Categoria do finding
+
+    Returns:
+        String formatada com ícone e cor para a categoria
+    """
+    # Ícones e cores por categoria
+    category_styles = {
+        Category.SECURITY: ("🔒", Colors.RED),
+        Category.PERFORMANCE: ("⚡", Colors.YELLOW),
+        Category.BUG: ("🐛", Colors.MAGENTA),
+        Category.RESOURCE_LEAK: ("💧", Colors.CYAN),
+        Category.TEXT_QUALITY: ("✏️", Colors.CYAN),
+    }
+
+    icon, color = category_styles.get(category, ("•", Colors.WHITE))
+    return f"{icon} {_colorize(category.value, color)}"
+
+
 def format_finding(finding: Finding) -> str:
     """Formata um finding para exibição.
 
@@ -84,10 +106,11 @@ def format_finding(finding: Finding) -> str:
 
     # Header: [SEVERITY] arquivo:linha - Título
     severity_str = format_severity(finding.severity)
+    category_badge = format_category_badge(finding.category)
     location = _colorize(f"{finding.file}:{finding.line}", Colors.CYAN)
     title = _colorize(finding.title, Colors.BOLD)
 
-    lines.append(f"  {severity_str} {location} - {title}")
+    lines.append(f"  {severity_str} {category_badge} {location} - {title}")
 
     # Descrição
     if finding.description:

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/locales/en.yaml

@@ -47,6 +47,13 @@ terminal:
   # Findings
   suggestion: "Suggestion:"
 
+  # Categories
+  category_security: "security"
+  category_performance: "performance"
+  category_bug: "bug"
+  category_resource_leak: "resource leak"
+  category_text_quality: "text quality"
+
   # Summary
   summary: "SUMMARY:"
   findings_count: "{count} finding(s)"

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/locales/pt-br.yaml

@@ -47,6 +47,13 @@ terminal:
   # Findings
   suggestion: "Sugestão:"
 
+  # Categorias
+  category_security: "segurança"
+  category_performance: "performance"
+  category_bug: "bug"
+  category_resource_leak: "vazamento de recurso"
+  category_text_quality: "qualidade de texto"
+
   # Resumo
   summary: "RESUMO:"
   findings_count: "{count} finding(s)"

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/models.py

@@ -21,6 +21,7 @@ class Category(str, Enum):
     PERFORMANCE = "performance"
     BUG = "bug"
     RESOURCE_LEAK = "resource-leak"
+    TEXT_QUALITY = "text-quality"
 
 
 class DiffLine(BaseModel):
@@ -90,7 +91,7 @@ class Finding(BaseModel):
     line: int = Field(description="Número da linha")
     severity: Severity = Field(description="Severidade: CRITICAL, WARNING, INFO")
     category: Category = Field(
-        description="Categoria: security, performance, bug, resource-leak"
+        description="Categoria: security, performance, bug, resource-leak, text-quality"
     )
     title: str = Field(description="Título curto do problema")
     description: str = Field(description="Descrição detalhada do problema")

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/prompt_builder.py

@@ -152,11 +152,54 @@ def format_references_for_prompt(context_graphs: list[ContextGraph]) -> str:
     return "\n".join(parts)
 
 
+def get_text_quality_section(language_name: str) -> str:
+    """Retorna a seção de instruções para verificação de qualidade de texto.
+
+    Args:
+        language_name: Nome do idioma para verificação
+
+    Returns:
+        String com instruções de verificação de texto
+    """
+    return f"""
+## QUALIDADE DE TEXTO
+
+Verifique ortografia e clareza semântica em mensagens voltadas ao usuário, no idioma **{language_name}**.
+
+### O que verificar:
+
+**Padrões de código:**
+- `raise *Error("...")` e `raise *Exception("...")`
+- `print("...")` e `console.log("...")`
+- Parâmetros nomeados: `message=`, `label=`, `title=`, `description=`, `text=`
+- Funções de UI: `flash("...")`, `toast("...")`, `alert("...")`
+
+**Arquivos de i18n:**
+- Arquivos em `locales/**/*`
+- Arquivos em `i18n/**/*`
+- Arquivos `messages.*` e `strings.*`
+
+### O que ignorar:
+
+- Identificadores: snake_case, camelCase, PascalCase
+- Termos técnicos: HTTP, JSON, API, SQL, URL, etc.
+- Nomes próprios e termos de domínio específico
+- Chaves de configuração e variáveis de ambiente
+
+### Formato dos findings:
+
+- Categoria: `text-quality`
+- Severidade: sempre `INFO`
+- Inclua a correção sugerida no campo `suggestion`
+"""
+
+
 def build_prompt(
     diff_files: list[DiffFile],
     context_graphs: list[ContextGraph],
     branch: str,
     base: str,
+    text_quality: bool = False,
 ) -> str:
     """Monta o prompt completo para a IA.
 
@@ -165,6 +208,7 @@ def build_prompt(
         context_graphs: Grafos de contexto com backtracking
         branch: Nome da branch sendo analisada
         base: Nome da branch base
+        text_quality: Se True, inclui verificação de ortografia e clareza
 
     Returns:
         Prompt completo pronto para enviar à IA
@@ -183,11 +227,15 @@ def build_prompt(
     lang_code = get_language()
     language_name = LANGUAGE_NAMES.get(lang_code, lang_code)
 
+    # Seção de text-quality (condicional)
+    text_quality_section = get_text_quality_section(language_name) if text_quality else ""
+
     # Substitui placeholders
     prompt = template.replace("{diff}", diff_section)
     prompt = prompt.replace("{context}", context_section)
     prompt = prompt.replace("{references}", references_section)
     prompt = prompt.replace("{json_schema}", json_schema)
     prompt = prompt.replace("{language}", language_name)
+    prompt = prompt.replace("{text_quality_section}", text_quality_section)
 
     return prompt

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/prompts/review_system.md

@@ -25,7 +25,7 @@ O DIFF abaixo mostra APENAS as linhas alteradas, não o arquivo completo. Códig
 - **Performance**: N+1 queries, loops desnecessários, operações O(n²), falta de índices, carregamento excessivo
 - **Bugs potenciais**: null pointer, race conditions, off-by-one, divisão por zero, exceções não tratadas
 - **Recursos não fechados**: conexões de banco, arquivos, sockets, locks não liberados
-
+{text_quality_section}
 ## FORMATO DE SAÍDA
 
 Retorne APENAS um JSON válido no formato abaixo. Não inclua explicações fora do JSON.

{airev-1.2.0 → airev-1.3.0}/src/code_reviewer/response_parser.py

@@ -121,6 +121,11 @@ def normalize_category(value: str) -> Category:
         "resource_leak": Category.RESOURCE_LEAK,
         "leak": Category.RESOURCE_LEAK,
         "memory": Category.RESOURCE_LEAK,
+        "text-quality": Category.TEXT_QUALITY,
+        "text_quality": Category.TEXT_QUALITY,
+        "spelling": Category.TEXT_QUALITY,
+        "grammar": Category.TEXT_QUALITY,
+        "typo": Category.TEXT_QUALITY,
     }
 
     return mapping.get(value_lower, Category.BUG)

airev-1.3.0/tests/test_cli.py

@@ -0,0 +1,29 @@
+"""Testes para o CLI."""
+
+from click.testing import CliRunner
+
+from code_reviewer.cli import review
+
+
+class TestReviewCommand:
+    """Testes para o comando review."""
+
+    def test_flag_text_quality_reconhecida(self):
+        """Verifica que a flag --text-quality é aceita pelo CLI."""
+        runner = CliRunner()
+
+        # Invoca com --help para verificar que a flag existe
+        result = runner.invoke(review, ["--help"])
+
+        assert result.exit_code == 0
+        assert "--text-quality" in result.output
+        assert "ortografia" in result.output or "spelling" in result.output.lower()
+
+    def test_flag_text_quality_short_form(self):
+        """Verifica que a forma curta -t funciona."""
+        runner = CliRunner()
+
+        result = runner.invoke(review, ["--help"])
+
+        assert result.exit_code == 0
+        assert "-t" in result.output

{airev-1.2.0 → airev-1.3.0}/tests/test_prompt_builder.py

@@ -188,3 +188,70 @@ class TestBuildPrompt:
         assert "REGRAS" in prompt
         assert "test.py" in prompt
         assert "review" in prompt  # Schema JSON
+
+    def test_prompt_sem_text_quality_por_padrao(self):
+        """Verifica que seção text-quality não aparece quando flag desativada."""
+        diff_files = [
+            DiffFile(
+                path="test.py",
+                hunks=[
+                    DiffHunk(
+                        function_name="test",
+                        start_line_old=1,
+                        start_line_new=1,
+                        added_lines=[],
+                        removed_lines=[],
+                    )
+                ],
+            )
+        ]
+        context_graphs = []
+
+        prompt = build_prompt(diff_files, context_graphs, "feature/test", "main")
+
+        # Não deve conter seção de text-quality
+        assert "QUALIDADE DE TEXTO" not in prompt
+        assert "text-quality" not in prompt
+
+    def test_prompt_com_text_quality_ativo(self):
+        """Verifica que seção text-quality aparece quando flag ativada."""
+        diff_files = [
+            DiffFile(
+                path="test.py",
+                hunks=[
+                    DiffHunk(
+                        function_name="test",
+                        start_line_old=1,
+                        start_line_new=1,
+                        added_lines=[],
+                        removed_lines=[],
+                    )
+                ],
+            )
+        ]
+        context_graphs = []
+
+        prompt = build_prompt(
+            diff_files, context_graphs, "feature/test", "main", text_quality=True
+        )
+
+        # Deve conter seção de text-quality
+        assert "QUALIDADE DE TEXTO" in prompt
+        assert "text-quality" in prompt
+        assert "ortografia" in prompt
+        assert "raise *Error" in prompt
+        assert "locales/" in prompt
+
+    def test_prompt_text_quality_menciona_ignorar_identificadores(self):
+        """Verifica que instruções de exclusão estão presentes."""
+        diff_files = []
+        context_graphs = []
+
+        prompt = build_prompt(
+            diff_files, context_graphs, "feature/test", "main", text_quality=True
+        )
+
+        # Deve instruir a ignorar identificadores
+        assert "snake_case" in prompt
+        assert "camelCase" in prompt
+        assert "termos técnicos" in prompt or "Termos técnicos" in prompt

{airev-1.2.0 → airev-1.3.0}/tests/test_response_parser.py

@@ -117,6 +117,13 @@ class TestNormalizeCategory:
         assert normalize_category("resource-leak") == Category.RESOURCE_LEAK
         assert normalize_category("memory") == Category.RESOURCE_LEAK
 
+    def test_text_quality(self):
+        assert normalize_category("text-quality") == Category.TEXT_QUALITY
+        assert normalize_category("text_quality") == Category.TEXT_QUALITY
+        assert normalize_category("spelling") == Category.TEXT_QUALITY
+        assert normalize_category("grammar") == Category.TEXT_QUALITY
+        assert normalize_category("typo") == Category.TEXT_QUALITY
+
     def test_desconhecido_para_bug(self):
         assert normalize_category("unknown") == Category.BUG