vectorgov-cli 0.3.0__tar.gz → 0.3.2__tar.gz

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/.gitignore

@@ -12,6 +12,7 @@ __pycache__/
 # Virtual environments
 venv/
 .venv/
+.venv-test/
 env/
 
 # IDE
@@ -23,6 +24,6 @@ env/
 # OS
 .DS_Store
 Thumbs.db
-
-# Test notebooks (may contain API keys)
-test_cli_commands.ipynb
+
+# Test notebooks (may contain API keys)
+test_cli_commands.ipynb

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vectorgov-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: CLI para a API VectorGov - Busca semântica em legislação brasileira
 Project-URL: Homepage, https://vectorgov.io
 Project-URL: Documentation, https://vectorgov.io/documentacao
@@ -60,7 +60,17 @@ Cliente de linha de comando para a API VectorGov - Busca semântica em legislaç
 [![Python versions](https://img.shields.io/pypi/pyversions/vectorgov-cli.svg)](https://pypi.org/project/vectorgov-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Para LLMs e agentes de IA (v0.2.3)
+> **Novo em 0.3.2** — zero truncamento de conteúdo em todos os formatos
+> de saída + TTY detection automática: quando stdout não é terminal
+> (pipe, LLM, CI/CD), o formato padrão vira `llm` automaticamente. A
+> tabela do `search` ganhou coluna `Norma` para identificar de qual lei
+> cada artigo veio. Veja o [CHANGELOG](CHANGELOG.md#032---2026-04-15).
+>
+> **Novo em 0.3.1** — parsing GNU-style: flags e argumentos funcionam em
+> qualquer ordem (`search "ETP" --top-k 3` e `search --top-k 3 "ETP"`
+> fazem a mesma coisa).
+
+## Para LLMs e agentes de IA (v0.3.2+)
 
 Se voce e um LLM ou agente de IA usando o CLI do VectorGov em sessoes
 de vibe coding, estas features foram projetadas para voce:
@@ -198,6 +208,11 @@ export VECTORGOV_API_KEY="vg_sua_chave"
 
 ## Uso
 
+> **Ordem de argumentos**: o CLI aceita flags e argumentos posicionais em
+> qualquer ordem (estilo GNU, igual a `git`, `curl`, `kubectl`, `npm`).
+> `vectorgov search "ETP" --top-k 3` e `vectorgov search --top-k 3 "ETP"`
+> produzem o mesmo resultado. Use o estilo que preferir.
+
 ### Busca
 
 ```bash

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/README.md

@@ -7,7 +7,17 @@ Cliente de linha de comando para a API VectorGov - Busca semântica em legislaç
 [![Python versions](https://img.shields.io/pypi/pyversions/vectorgov-cli.svg)](https://pypi.org/project/vectorgov-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Para LLMs e agentes de IA (v0.2.3)
+> **Novo em 0.3.2** — zero truncamento de conteúdo em todos os formatos
+> de saída + TTY detection automática: quando stdout não é terminal
+> (pipe, LLM, CI/CD), o formato padrão vira `llm` automaticamente. A
+> tabela do `search` ganhou coluna `Norma` para identificar de qual lei
+> cada artigo veio. Veja o [CHANGELOG](CHANGELOG.md#032---2026-04-15).
+>
+> **Novo em 0.3.1** — parsing GNU-style: flags e argumentos funcionam em
+> qualquer ordem (`search "ETP" --top-k 3` e `search --top-k 3 "ETP"`
+> fazem a mesma coisa).
+
+## Para LLMs e agentes de IA (v0.3.2+)
 
 Se voce e um LLM ou agente de IA usando o CLI do VectorGov em sessoes
 de vibe coding, estas features foram projetadas para voce:
@@ -145,6 +155,11 @@ export VECTORGOV_API_KEY="vg_sua_chave"
 
 ## Uso
 
+> **Ordem de argumentos**: o CLI aceita flags e argumentos posicionais em
+> qualquer ordem (estilo GNU, igual a `git`, `curl`, `kubectl`, `npm`).
+> `vectorgov search "ETP" --top-k 3` e `vectorgov search --top-k 3 "ETP"`
+> produzem o mesmo resultado. Use o estilo que preferir.
+
 ### Busca
 
 ```bash

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vectorgov-cli"
-version = "0.3.0"
+version = "0.3.2"
 description = "CLI para a API VectorGov - Busca semântica em legislação brasileira"
 readme = "README.md"
 license = "MIT"

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/__init__.py

@@ -7,7 +7,7 @@ Uso:
     vectorgov auth login
 """
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 
 from .main import app
 

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/__init__.py

@@ -4,7 +4,7 @@ Comandos do CLI VectorGov.
 
 from . import auth, search, ask, feedback, docs, config, tokens
 from . import smart_search, hybrid, lookup, grep_cmd, merged, audit, quota, prompts
-from . import context, init
+from . import context, init, fs_search, read, explain
 
 __all__ = [
     "auth",
@@ -24,4 +24,7 @@ __all__ = [
     "prompts",
     "context",
     "init",
+    "fs_search",
+    "read",
+    "explain",
 ]

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/ask.py

@@ -17,7 +17,6 @@ from rich.syntax import Syntax
 from ..utils.config import ConfigManager
 from ..utils.output import OutputFormat, extract_request_id, print_request_id_footer
 
-app = typer.Typer()
 console = Console()
 config_manager = ConfigManager()
 
@@ -43,7 +42,6 @@ def _check_admin(api_key: str) -> bool:
         return False
 
 
-@app.callback(invoke_without_command=True)
 def ask(
     query: str = typer.Argument(..., help="Pergunta em linguagem natural"),
     top_k: int = typer.Option(5, "--top-k", "-k", help="Número de chunks para contexto"),
@@ -150,7 +148,7 @@ def ask(
             for i, hit in enumerate(results.hits, 1):
                 title = f"[bold]#{i}[/bold] Art. {hit.article_number} ({getattr(hit, 'document_id', None) or getattr(hit, 'source', '')})"
                 console.print(Panel(
-                    hit.text[:500] + ("..." if len(hit.text) > 500 else ""),
+                    hit.text,
                     title=title,
                     border_style="blue"
                 ))

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/context.py

@@ -8,12 +8,10 @@ from rich.console import Console
 from ..utils.config import ConfigManager
 from ..utils.output import extract_request_id, print_request_id_footer
 
-app = typer.Typer()
 console = Console()
 config_manager = ConfigManager()
 
 
-@app.callback(invoke_without_command=True)
 def context(
     query: str = typer.Argument(..., help="Pergunta jurídica"),
     top_k: int = typer.Option(5, "--top-k", "-k", help="Quantidade de resultados (1-20)"),

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/docs.py

@@ -120,7 +120,7 @@ def list_docs(
         else:
             table = Table(title="Documentos Disponíveis")
             table.add_column("ID", style="cyan")
-            table.add_column("Título")
+            table.add_column("Título", overflow="fold")
             table.add_column("Tipo", style="green")
             table.add_column("Ano", justify="right")
             table.add_column("Chunks", justify="right")
@@ -135,7 +135,7 @@ def list_docs(
                 chunks = getattr(d, "chunks_count", 0)
                 table.add_row(
                     str(doc_id),
-                    titulo[:50] + "..." if len(str(titulo)) > 50 else str(titulo),
+                    str(titulo),
                     str(tipo),
                     str(ano),
                     str(chunks),

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/explain.py

@@ -13,12 +13,10 @@ from ..utils.output import (
     render_llm_output,
 )
 
-app = typer.Typer()
 console = Console()
 config_manager = ConfigManager()
 
 
-@app.callback(invoke_without_command=True)
 def explain(
     reference: str = typer.Argument(..., help="Referencia legal (ex: 'Art. 75 da Lei 14.133')"),
     output: str = typer.Option("llm", "--output", "-o", help="Formato: llm, text, json, raw"),
@@ -158,7 +156,7 @@ def explain(
             lines.append(main_text)
             if parent_text:
                 lines.append("")
-                lines.append(f"PARENT: {parent_text[:200]}")
+                lines.append(f"PARENT: {parent_text}")
             else:
                 lines.append("")
                 lines.append("PARENT: (nenhum -- dispositivo de primeiro nivel)")
@@ -199,10 +197,10 @@ def explain(
             console.print(f"\nStatus: [green]{status}[/green]")
             console.print(Panel(main_text, title=title, border_style="cyan"))
             if parent_text:
-                console.print(f"[dim]Parent: {parent_text[:150]}...[/dim]")
+                console.print(Panel(parent_text, title="Parent", border_style="dim"))
             console.print(f"[dim]Filhos: {children_count} dispositivos[/dim]")
             if nota:
-                console.print(f"\n[bold]Nota do especialista:[/bold] {nota[:200]}")
+                console.print(f"\n[bold]Nota do especialista:[/bold] {nota}")
             if evidence_url:
                 console.print(f"[dim]    Ver trecho: {evidence_url}[/dim]")
             if document_url:

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/fs_search.py

@@ -14,12 +14,10 @@ from ..utils.output import (
     resolve_output_format,
 )
 
-app = typer.Typer()
 console = Console()
 config_manager = ConfigManager()
 
 
-@app.callback(invoke_without_command=True)
 def fs_search(
     query: str = typer.Argument(..., help="Pergunta ou termo para buscar"),
     document_id: str = typer.Option(None, "--doc", "-d", help="Filtrar por documento (ex: LEI-14133-2021)"),
@@ -117,7 +115,7 @@ def fs_search(
                     {
                         "source": getattr(h, "source", ""),
                         "score": getattr(h, "score", 0),
-                        "text": getattr(h, "text", str(h))[:300],
+                        "text": getattr(h, "text", str(h)),
                         "breadcrumb": getattr(h, "breadcrumb", ""),
                     }
                     for h in hits
@@ -128,17 +126,16 @@ def fs_search(
             table = Table(title=f"Filesystem Search ({len(hits)} resultados)")
             table.add_column("#", style="dim", width=3)
             table.add_column("Fonte", style="cyan", width=30)
-            table.add_column("Texto", width=65)
+            table.add_column("Texto", overflow="fold")
             table.add_column("Score", justify="right", width=6)
             table.add_column("Motivo", width=10)
             for i, h in enumerate(hits, 1):
                 source = getattr(h, "source", getattr(h, "document_id", ""))
                 score = getattr(h, "score", 0)
                 text = getattr(h, "text", str(h))
-                text = text[:160] + "..." if len(text) > 160 else text
                 reason = getattr(h, "match_reason", "")
                 table.add_row(
-                    str(i), source, text, f"{score:.2f}" if score else "-", reason[:10]
+                    str(i), source, text, f"{score:.2f}" if score else "-", reason
                 )
             console.print(table)
         else:
@@ -148,7 +145,7 @@ def fs_search(
                 console.print(f"\n[cyan][{i}][/cyan] [bold]{source}[/bold]")
                 if breadcrumb:
                     console.print(f"  [dim]{breadcrumb}[/dim]")
-                console.print(f"  {getattr(h, 'text', str(h))[:300]}")
+                console.print(f"  {getattr(h, 'text', str(h))}")
                 for line in render_evidence_lines_text(h):
                     console.print(f"[dim]{line}[/dim]")
 

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/grep_cmd.py

@@ -14,12 +14,10 @@ from ..utils.output import (
     resolve_output_format,
 )
 
-app = typer.Typer()
 console = Console()
 config_manager = ConfigManager()
 
 
-@app.callback(invoke_without_command=True)
 def grep(
     query: str = typer.Argument(..., help="Texto exato para buscar (ex: 'dispensa de licitação')"),
     document_id: str = typer.Option(None, "--doc", "-d", help="Filtrar por documento (ex: LEI-14.133-2021)"),
@@ -109,7 +107,7 @@ def grep(
                 "request_id": extract_request_id(result),
                 "hits": [
                     {"source": getattr(h, "source", ""), "span_id": getattr(h, "span_id", ""),
-                     "text": getattr(h, "text", str(h))[:300]}
+                     "text": getattr(h, "text", str(h))}
                     for h in hits
                 ],
             }
@@ -118,18 +116,17 @@ def grep(
             table = Table(title=f"grep: '{query}'")
             table.add_column("#", style="dim", width=3)
             table.add_column("Fonte", style="cyan", width=30)
-            table.add_column("Trecho", width=80)
+            table.add_column("Trecho", overflow="fold")
             for i, h in enumerate(hits, 1):
                 source = getattr(h, "source", getattr(h, "document_id", ""))
                 text = getattr(h, "text", str(h))
-                text = text[:200] + "..." if len(text) > 200 else text
                 table.add_row(str(i), source, text)
             console.print(table)
         else:
             for i, h in enumerate(hits, 1):
                 source = getattr(h, "source", getattr(h, "document_id", ""))
                 console.print(f"[cyan][{i}][/cyan] [bold]{source}[/bold]")
-                console.print(f"  {getattr(h, 'text', str(h))[:300]}")
+                console.print(f"  {getattr(h, 'text', str(h))}")
                 for line in render_evidence_lines_text(h):
                     console.print(f"[dim]{line}[/dim]")
                 console.print()

{vectorgov_cli-0.3.0 → vectorgov_cli-0.3.2}/src/vectorgov/cli/commands/hybrid.py

@@ -14,12 +14,10 @@ from ..utils.output import (
     resolve_output_format,
 )
 
-app = typer.Typer()
 console = Console()
 config_manager = ConfigManager()
 
 
-@app.callback(invoke_without_command=True)
 def hybrid(
     query: str = typer.Argument(..., help="Pergunta jurídica"),
     top_k: int = typer.Option(10, "--top-k", "-k", help="Quantidade de resultados (1-50)"),
@@ -143,7 +141,7 @@ def hybrid(
                 {
                     "source": getattr(h, "source", ""),
                     "score": getattr(h, "score", 0),
-                    "text": h.text[:300],
+                    "text": h.text,
                     "graph": getattr(h, "is_graph_expanded", False),
                 }
                 for h in hits
@@ -153,13 +151,13 @@ def hybrid(
             table = Table(title=f"Busca Híbrida ({len(hits)} resultados)")
             table.add_column("#", style="dim", width=3)
             table.add_column("Fonte", style="cyan", width=30)
-            table.add_column("Texto", width=70)
+            table.add_column("Texto", overflow="fold")
             table.add_column("Score", justify="right", width=6)
             table.add_column("Grafo", width=5)
             for i, h in enumerate(hits, 1):
                 source = getattr(h, "source", getattr(h, "document_id", ""))
                 score = getattr(h, "score", 0)
-                text = h.text[:180] + "..." if len(h.text) > 180 else h.text
+                text = h.text
                 graph = "+" if getattr(h, "is_graph_expanded", False) else ""
                 table.add_row(
                     str(i), source, text, f"{score:.2f}" if score else "-", graph
@@ -174,7 +172,7 @@ def hybrid(
                     else ""
                 )
                 console.print(f"\n[cyan][{i}][/cyan] [bold]{source}[/bold]{graph_tag}")
-                console.print(f"  {h.text[:300]}")
+                console.print(f"  {h.text}")
                 for line in render_evidence_lines_text(h):
                     console.print(f"[dim]{line}[/dim]")