airev 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

{airev-1.2.0.dist-info → airev-1.3.0.dist-info}/METADATA

@@ -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.dist-info → airev-1.3.0.dist-info}/RECORD

@@ -1,17 +1,17 @@
-code_reviewer/__init__.py,sha256=39ZhaBH3qjYCSKVmeSRsf21d_-DPx9UOMUCaCnqVRCw,82
-code_reviewer/cli.py,sha256=WaWoN5FFPhOtKoM1LTawCvdT6jb1eVEJyS_G69mYICA,6686
+code_reviewer/__init__.py,sha256=2ikWG5DdNPMPpfzCE5-SuTregtDM1BjI70S5l4Wks60,82
+code_reviewer/cli.py,sha256=2b7z5GX8Pv6DEEIq-kwuM0_Bc8RrRIGbcyjYdHyIpRw,6975
 code_reviewer/context_builder.py,sha256=XJGsJpc5YOP3jhldpMFnrJ-hLc4uf9O6_efxZa3sbsc,8790
 code_reviewer/diff_parser.py,sha256=07EO0kJFYuS6GRgDUHH0czYJBKcL8CxLR-jLdq6PShs,6896
-code_reviewer/models.py,sha256=SUSudQx623zS15yUKd84qOI6zqO-736lu7gjbHSsYwY,4263
-code_reviewer/prompt_builder.py,sha256=oJQtvK4cso20n98qVZ55cFWdSdTh-cFHjL-VRItPdFA,5733
-code_reviewer/response_parser.py,sha256=BR_x_x34zFF5ugerJtlxDTwaFQv4eMFaVwALUgCGLG8,7475
+code_reviewer/models.py,sha256=Rl3t216u-h304pM-Hpk4TtvsbGZHEFiXGsWsvlY_xsM,4311
+code_reviewer/prompt_builder.py,sha256=d1Kov5WCdLbGo0X1AI8XOP5bdaOVfz3d_X6HQC563S0,7262
+code_reviewer/response_parser.py,sha256=Cz1TdCVf52FyXZqx5VEaJnpUETG3Epb-q3rqLNRUIhg,7693
 code_reviewer/formatters/__init__.py,sha256=LXkD8nK7yWGtbc6ox85SHWZdQX5sVr5xLXkkCO0XE8A,49
 code_reviewer/formatters/progress.py,sha256=mUmoB2xQYYuYz5IRJzn23wgOpiV7bXehXrPhP5rDT-g,8529
-code_reviewer/formatters/terminal.py,sha256=lJohIyqav3QjGchjTUKxfCbuFtbtL3sbcW9glU3hwUM,5849
+code_reviewer/formatters/terminal.py,sha256=_bI4bf3Qcsy6pR83AkzaXi_1Af3yH5uc3-kw11gSZt8,6617
 code_reviewer/i18n/__init__.py,sha256=Uzm_sic0_ehZQSpyzxI9-IFX_5Saxo5V-sLR35eqrIM,4696
-code_reviewer/locales/en.yaml,sha256=CiVUrxIj9jnAhZjEw74pInWYljT-o2Luvo1mf1yOo14,1879
-code_reviewer/locales/pt-br.yaml,sha256=iWtokdIjBEikUthPYh8oSYUuvgYA_02rcfgzFcB7tLI,2037
-code_reviewer/prompts/review_system.md,sha256=9FDaIY8q2PdLh3p28cy2EJBi8olQhtw6I3TYgVG7fik,1995
+code_reviewer/locales/en.yaml,sha256=iIAP9eWSMUX1L0f2MQXYm1dVaI1bH9uObxV3vKcOQW8,2069
+code_reviewer/locales/pt-br.yaml,sha256=DVELflzF7B1Cdrq9lQV9KkQ2Gr-IyCE0w7uptC44vOI,2242
+code_reviewer/prompts/review_system.md,sha256=V2AeAOwXp5lYB1Op3WDAMaDZtTnUDJ1sztOWIXjaHGk,2017
 code_reviewer/runners/__init__.py,sha256=cLxawmzHwhymN2xSC7nUWEOpHHvvSklzZOqjy2Q7HIM,1194
 code_reviewer/runners/base.py,sha256=xikp7yI4IcOX86uNA7CUWTCL_oNuHSF9WIs6OP6rnx0,1491
 code_reviewer/runners/copilot.py,sha256=GpBYO-Splmo66EaUBfCmU8Et-NRB0w2gn7XEtIq9THw,2433
@@ -21,8 +21,8 @@ code_reviewer/updater/http_client.py,sha256=g4PnuY5KKbsA0EqLtHhOK4sxg_6P0drzd1HK
 code_reviewer/updater/notifier.py,sha256=o4crwJOnCOSnzqk5gMt0MkYP3xm-yEXIGSnix988YzA,992
 code_reviewer/updater/upgrade.py,sha256=xoAfpomMJA_K9t6myeXC6tLEBnKwAgxR9OD8tcJ4YXE,5842
 code_reviewer/updater/version_check.py,sha256=2Zv35s5oeR0dHAGODPwO70dyshECaCzrQx7vEZAXYJM,4917
-airev-1.2.0.dist-info/METADATA,sha256=IVqJfD0FVZFSrjWLHgbSywdE4mdR4a0UHQpynHGr5B8,6258
-airev-1.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-airev-1.2.0.dist-info/entry_points.txt,sha256=LDd8UajxUO4QUs63xt6z635doU7E1XzBPFQZeMrlShU,49
-airev-1.2.0.dist-info/top_level.txt,sha256=VqPHk5LmBEOeRJOUhXq1lkW5UiT48zW7a9h7NDy9N0E,14
-airev-1.2.0.dist-info/RECORD,,
+airev-1.3.0.dist-info/METADATA,sha256=IOCRgO9Yzy1RSxPXrOWewf43vL5-7WPv4xYt6OyQvI0,6258
+airev-1.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+airev-1.3.0.dist-info/entry_points.txt,sha256=LDd8UajxUO4QUs63xt6z635doU7E1XzBPFQZeMrlShU,49
+airev-1.3.0.dist-info/top_level.txt,sha256=VqPHk5LmBEOeRJOUhXq1lkW5UiT48zW7a9h7NDy9N0E,14
+airev-1.3.0.dist-info/RECORD,,

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"

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:

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:

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

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

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

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

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.

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)