vectorgov-cli 0.2.3__tar.gz → 0.2.5__tar.gz

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/.gitignore

@@ -23,3 +23,6 @@ env/
 # OS
 .DS_Store
 Thumbs.db
+
+# Test notebooks (may contain API keys)
+test_cli_commands.ipynb

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vectorgov-cli
-Version: 0.2.3
+Version: 0.2.5
 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
@@ -138,11 +138,11 @@ vectorgov search --raw "dispensa de licitação" | jq -r '.hits[] | "- \(.docume
 | `search` | Busca semântica em legislação (filtros: `--tipo`, `--ano`, `--doc`) |
 | `ask` | Contexto para LLMs (busca + system prompt) |
 | `smart-search` | Busca inteligente MOC v4 com análise de confiança |
-| `hybrid` | Busca semântica + expansão por grafo normativo (Neo4j) |
+| `hybrid` | Busca semântica + expansão por grafo normativo |
 | `lookup` | Consulta de artigo específico por referência legal |
 | `grep` | Busca exata por texto no corpo das normas |
 | `merged` | Busca dual-path: semântica + índice curado (RRF) |
-| `fs-search` | Busca no índice curado (PG + ripgrep) — texto exato |
+| `fs-search` | Busca no índice curado — texto exato |
 | `read` | Lê texto canônico de documento/dispositivo |
 | `explain` | Contexto completo de um dispositivo (lookup + texto consolidado) |
 | `context` | Bloco completo (busca + prompt) pronto para LLMs |
@@ -325,8 +325,8 @@ vectorgov smart-search "pesquisa de preços" --cache
 
 ### Hybrid
 
-Busca semântica enriquecida com expansão por grafo normativo (Neo4j). Retorna
-evidências diretas (hits do Milvus) + artigos citados (expansão via grafo).
+Busca semântica enriquecida com expansão por grafo normativo. Retorna
+evidências diretas + artigos citados (expansão via grafo).
 
 ```bash
 # Busca híbrida
@@ -380,7 +380,7 @@ referência (ex: `"Art. 75 da Lei 14.133"` em vez de `"Art. 75" --doc ...`).
 
 ### Grep
 
-Busca exata por texto no corpo das normas via ripgrep. Diferente do `search` (semântico), o `grep` procura ocorrências literais.
+Busca exata por texto no corpo das normas. Diferente do `search` (semântico), o `grep` procura ocorrências literais.
 
 ```bash
 # Busca textual exata
@@ -403,7 +403,7 @@ vectorgov grep "art. 75" --doc LEI-14133-2021 --max 3
 
 ### Merged
 
-Busca dual-path combinando semântica (Milvus+Neo4j) + índice curado (PG+ripgrep)
+Busca dual-path combinando busca semântica + índice curado
 com Reciprocal Rank Fusion (RRF).
 
 ```bash
@@ -415,16 +415,16 @@ vectorgov merged "Pesquisa de preços" --top-k 15
 vectorgov merged "art. 75" --doc LEI-14133-2021
 
 # Controle granular de backends (v0.2.1)
-vectorgov merged "dispensa" --no-filesystem    # apenas hybrid (Milvus+Neo4j)
-vectorgov merged "licitação" --no-hybrid       # apenas filesystem (PG+ripgrep)
+vectorgov merged "dispensa" --no-filesystem    # apenas busca semântica
+vectorgov merged "licitação" --no-hybrid       # apenas índice curado
 ```
 
 **Opções**:
 - `--top-k/-k` (1-50, padrão: 10) — quantidade de resultados
 - `--doc/-d` — filtrar por documento específico
 - `--token-budget` — limite de tokens para contexto
-- `--no-hybrid` — desabilita Milvus+Neo4j (usa só filesystem)
-- `--no-filesystem` — desabilita índice curado (usa só hybrid)
+- `--no-hybrid` — desabilita busca semântica (usa só índice curado)
+- `--no-filesystem` — desabilita índice curado (usa só busca semântica)
 - `--output/-o` (table/json/text)
 - `--raw` — inclui `mutual_count`, `hybrid_count`, `filesystem_count` no output
 
@@ -455,7 +455,7 @@ quando já souber o `document_id` e `span_id` exatos (ex: após um `lookup`).
 
 ### Fs-search
 
-Busca no índice curado (PostgreSQL + ripgrep) — alternativa ao `search` vetorial.
+Busca no índice curado — alternativa ao `search` vetorial.
 Ideal para termos exatos e referências legais precisas (v0.2.0).
 
 ```bash
@@ -464,9 +464,9 @@ vectorgov fs-search "art. 75 da Lei 14.133"
 vectorgov fs-search "pregão eletrônico"
 
 # Modo específico
-vectorgov fs-search "dispensa" --mode index    # só PostgreSQL
-vectorgov fs-search "art. 75" --mode grep      # só ripgrep
-vectorgov fs-search "ETP" --mode both          # PG + ripgrep combinados
+vectorgov fs-search "dispensa" --mode index    # só busca indexada
+vectorgov fs-search "art. 75" --mode grep      # só busca textual
+vectorgov fs-search "ETP" --mode both          # índice + textual combinados
 
 # Filtrar por documento
 vectorgov fs-search "art. 75" --doc LEI-14133-2021 --output json
@@ -715,4 +715,3 @@ vectorgov ask --help
 - [Documentação](https://vectorgov.io/documentacao)
 - [Playground](https://vectorgov.io/playground)
 - [SDK Python](https://pypi.org/project/vectorgov/)
-- [SDK TypeScript](https://www.npmjs.com/package/vectorgov)

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/README.md

@@ -85,11 +85,11 @@ vectorgov search --raw "dispensa de licitação" | jq -r '.hits[] | "- \(.docume
 | `search` | Busca semântica em legislação (filtros: `--tipo`, `--ano`, `--doc`) |
 | `ask` | Contexto para LLMs (busca + system prompt) |
 | `smart-search` | Busca inteligente MOC v4 com análise de confiança |
-| `hybrid` | Busca semântica + expansão por grafo normativo (Neo4j) |
+| `hybrid` | Busca semântica + expansão por grafo normativo |
 | `lookup` | Consulta de artigo específico por referência legal |
 | `grep` | Busca exata por texto no corpo das normas |
 | `merged` | Busca dual-path: semântica + índice curado (RRF) |
-| `fs-search` | Busca no índice curado (PG + ripgrep) — texto exato |
+| `fs-search` | Busca no índice curado — texto exato |
 | `read` | Lê texto canônico de documento/dispositivo |
 | `explain` | Contexto completo de um dispositivo (lookup + texto consolidado) |
 | `context` | Bloco completo (busca + prompt) pronto para LLMs |
@@ -272,8 +272,8 @@ vectorgov smart-search "pesquisa de preços" --cache
 
 ### Hybrid
 
-Busca semântica enriquecida com expansão por grafo normativo (Neo4j). Retorna
-evidências diretas (hits do Milvus) + artigos citados (expansão via grafo).
+Busca semântica enriquecida com expansão por grafo normativo. Retorna
+evidências diretas + artigos citados (expansão via grafo).
 
 ```bash
 # Busca híbrida
@@ -327,7 +327,7 @@ referência (ex: `"Art. 75 da Lei 14.133"` em vez de `"Art. 75" --doc ...`).
 
 ### Grep
 
-Busca exata por texto no corpo das normas via ripgrep. Diferente do `search` (semântico), o `grep` procura ocorrências literais.
+Busca exata por texto no corpo das normas. Diferente do `search` (semântico), o `grep` procura ocorrências literais.
 
 ```bash
 # Busca textual exata
@@ -350,7 +350,7 @@ vectorgov grep "art. 75" --doc LEI-14133-2021 --max 3
 
 ### Merged
 
-Busca dual-path combinando semântica (Milvus+Neo4j) + índice curado (PG+ripgrep)
+Busca dual-path combinando busca semântica + índice curado
 com Reciprocal Rank Fusion (RRF).
 
 ```bash
@@ -362,16 +362,16 @@ vectorgov merged "Pesquisa de preços" --top-k 15
 vectorgov merged "art. 75" --doc LEI-14133-2021
 
 # Controle granular de backends (v0.2.1)
-vectorgov merged "dispensa" --no-filesystem    # apenas hybrid (Milvus+Neo4j)
-vectorgov merged "licitação" --no-hybrid       # apenas filesystem (PG+ripgrep)
+vectorgov merged "dispensa" --no-filesystem    # apenas busca semântica
+vectorgov merged "licitação" --no-hybrid       # apenas índice curado
 ```
 
 **Opções**:
 - `--top-k/-k` (1-50, padrão: 10) — quantidade de resultados
 - `--doc/-d` — filtrar por documento específico
 - `--token-budget` — limite de tokens para contexto
-- `--no-hybrid` — desabilita Milvus+Neo4j (usa só filesystem)
-- `--no-filesystem` — desabilita índice curado (usa só hybrid)
+- `--no-hybrid` — desabilita busca semântica (usa só índice curado)
+- `--no-filesystem` — desabilita índice curado (usa só busca semântica)
 - `--output/-o` (table/json/text)
 - `--raw` — inclui `mutual_count`, `hybrid_count`, `filesystem_count` no output
 
@@ -402,7 +402,7 @@ quando já souber o `document_id` e `span_id` exatos (ex: após um `lookup`).
 
 ### Fs-search
 
-Busca no índice curado (PostgreSQL + ripgrep) — alternativa ao `search` vetorial.
+Busca no índice curado — alternativa ao `search` vetorial.
 Ideal para termos exatos e referências legais precisas (v0.2.0).
 
 ```bash
@@ -411,9 +411,9 @@ vectorgov fs-search "art. 75 da Lei 14.133"
 vectorgov fs-search "pregão eletrônico"
 
 # Modo específico
-vectorgov fs-search "dispensa" --mode index    # só PostgreSQL
-vectorgov fs-search "art. 75" --mode grep      # só ripgrep
-vectorgov fs-search "ETP" --mode both          # PG + ripgrep combinados
+vectorgov fs-search "dispensa" --mode index    # só busca indexada
+vectorgov fs-search "art. 75" --mode grep      # só busca textual
+vectorgov fs-search "ETP" --mode both          # índice + textual combinados
 
 # Filtrar por documento
 vectorgov fs-search "art. 75" --doc LEI-14133-2021 --output json
@@ -662,4 +662,3 @@ vectorgov ask --help
 - [Documentação](https://vectorgov.io/documentacao)
 - [Playground](https://vectorgov.io/playground)
 - [SDK Python](https://pypi.org/project/vectorgov/)
-- [SDK TypeScript](https://www.npmjs.com/package/vectorgov)

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/pyproject.toml

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

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/src/vectorgov/cli/__init__.py

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

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/src/vectorgov/cli/commands/fs_search.py

@@ -21,10 +21,10 @@ def fs_search(
     output: str = typer.Option("table", "--output", "-o", help="Formato: table, json, text, llm"),
     raw: bool = typer.Option(False, "--raw", help="JSON bruto para piping"),
 ):
-    """Busca no índice curado do filesystem (PG + ripgrep).
+    """Busca no índice curado do filesystem.
 
     Diferente de 'search' (vetorial), busca por termos exatos no índice curado.
-    Combina PostgreSQL (aliases, termos) com ripgrep (texto canônico).
+    Combina busca indexada (aliases, termos) com busca textual (texto canônico).
 
     Exemplo:
         vectorgov fs-search "art. 75 da Lei 14.133"

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/src/vectorgov/cli/commands/hybrid.py

@@ -1,4 +1,4 @@
-"""Busca híbrida com expansão por grafo normativo (Neo4j)."""
+"""Busca híbrida com expansão por grafo normativo."""
 
 import json
 import typer
@@ -27,7 +27,7 @@ def hybrid(
 ):
     """Busca semântica + expansão por grafo de citações normativas.
 
-    Combina busca vetorial (Milvus) com navegação por relações entre normas (Neo4j).
+    Combina busca vetorial com navegação por relações entre normas via grafo.
     Ideal para encontrar artigos relacionados que citam ou são citados pelo resultado.
 
     Exemplo:
@@ -66,7 +66,7 @@ def hybrid(
         with console.status("[bold]Buscando com expansão por grafo...[/bold]"):
             result = vg.hybrid(**hybrid_kwargs)
 
-        # hits = direct_evidence do SDK (seeds do Milvus). Se vazio,
+        # hits = direct_evidence do SDK (seeds da busca semântica). Se vazio,
         # usa graph_nodes como fallback (expansão via grafo com score>0).
         direct_hits = list(result.hits) if hasattr(result, "hits") else list(result)
         graph_hits = list(getattr(result, "graph_nodes", []) or [])

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/src/vectorgov/cli/commands/merged.py

@@ -23,7 +23,7 @@ def merged(
     token_budget: int = typer.Option(None, "--token-budget", help="Limite de tokens para contexto"),
     no_hybrid: bool = typer.Option(
         False, "--no-hybrid",
-        help="Desabilita o backend hybrid (Milvus+Neo4j), usa só filesystem"
+        help="Desabilita o backend semântico, usa só filesystem"
     ),
     no_filesystem: bool = typer.Option(
         False, "--no-filesystem",

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/src/vectorgov/cli/commands/search.py

@@ -78,7 +78,7 @@ def search(
         raise typer.Exit(1)
 
     # Monta filters dict para o SDK (keys: tipo, ano, orgao — não tipo_documento)
-    # IMPORTANTE: Milvus armazena tipo_documento UPPERCASE (LEI, DECRETO, IN)
+    # IMPORTANTE: backend armazena tipo_documento UPPERCASE (LEI, DECRETO, IN)
     filters: Optional[dict] = None
     if tipo or ano:
         filters = {}

{vectorgov_cli-0.2.3 → vectorgov_cli-0.2.5}/src/vectorgov/cli/main.py

@@ -43,6 +43,14 @@ app.add_typer(read.app, name="read", help="Lê texto canônico de um documento o
 app.add_typer(explain.app, name="explain", help="Contexto completo de um dispositivo legal")
 
 
+def _version_callback(value: bool):
+    """Callback para o flag --version."""
+    if value:
+        from . import __version__
+        console.print(f"vectorgov-cli versão {__version__}")
+        raise typer.Exit()
+
+
 @app.command()
 def version():
     """Mostra a versão do CLI."""
@@ -51,7 +59,15 @@ def version():
 
 
 @app.callback()
-def callback():
+def callback(
+    version: bool = typer.Option(
+        False,
+        "--version", "-V",
+        callback=_version_callback,
+        is_eager=True,
+        help="Mostra a versão do CLI e sai.",
+    ),
+):
     """
     VectorGov CLI - Busca semântica em legislação brasileira.