[yamarkov]

What changed

The CLI was built on /v1/business-status, which is no longer part of the published API. This rebuilds voygr and its Python client on the endpoints described at https://api.voygr.tech/docs/.

• voygr validate checks whether a place exists and is open. 1 credit.
• voygr enrich returns phone, website, opening hours, social profiles and email for 1 credit per place. Research fields cost 1 credit per place per field. --estimate prices a request without running it.
• --file places.csv on either command submits a bulk job of up to 10,000 rows, waits, and prints one JSON line per row. voygr jobs status, results and cancel pick a job up later.
• voygr usage and voygr pricing are new. Pricing needs no key.
• The default base URL is now https://api.voygr.tech.
• voygr check is gone. That breaks existing scripts, so the version goes to 0.4.0.

Charges

• The CLI never retries a single validate or enrich call after a server error, a timeout or a dropped connection, because the API may already have charged for it. It retries those calls on 429 only.
• A job submit sends one Idempotency-Key and reuses it on every retry, so a retry replays the same job.
• The CLI checks a CSV locally first. A bad row stops the command with its line number before anything reaches the API.
• The client downloads result files without the API key and checks each one against its sha256.

Release

.github/workflows/release.yml publishes to PyPI when a v* tag is pushed. It uses trusted publishing, so the repo holds no PyPI token. The voygr project on PyPI needs a trusted publisher for this workflow before the first tag.

Tests

• 481 unit and integration tests pass locally, with 99% line coverage.
• actionlint passes on both workflows.
• python -m build produces voygr-0.4.0.tar.gz and voygr-0.4.0-py3-none-any.whl.
• Every README output that calls the API comes from a live run on 21 October 2026, which used 20 credits on a free key.

The release workflow hasn't run yet. The first tag will be its first run.

🤖 Generated with Claude Code

[greptile-apps]

Confidence Score: 5/5

[High impact] The follow-up appears safe to merge, with no new blocking findings.

Summary

Rebuilds the CLI and Python client around the Places API, with bulk jobs and a PyPI release workflow.

• The CLI checks places and looks up details through the Places API.
• CSV files run as bulk jobs that people can revisit later.
• People can check credit use and see what requests cost.
• A version tag builds and publishes the CLI package to PyPI.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Read CSV] --> B[Check rows and headers]
  B --> C[Choose idempotency key]
  C --> D[Submit job]
  D --> E{Submit outcome}
  E -->|Unclear failure| F[Print key for replay]
  E -->|Job returned| G[Poll job]
  G --> H[Download and check result files]
  H --> I[Print JSON Lines]

Loading

_{Reviews (2) · Last reviewed commit: "fix: keep the submit key after an unclea..." · Reviewed by Greptile}

[yamarkov]

@greptileai please re-review. ad2856a fixes the three findings from the first review: the submit key after an unclear failure, wait_for_job timeouts, and repeated CSV columns. This is a public repository, so please keep comments to the code in this PR.