What problem does it solve?
Elixir teams lack a durable, reviewable record of which Hex dependency versions have passed security review, so supply-chain audit findings keep resurfacing and trust decisions get lost.
Core Features & Use Cases
- Audit ledger management: Appends human-confirmed vetting verdicts (
:safe_to_deploy, :safe_to_run, :does_not_implement_crypto) to hex_vet.exs at the project root, visible in PR review alongside mix.lock.
- Seed import and drift checks: Imports a curated baseline of ~30 vetted packages via
--seed, lists existing entries with --list, and cross-checks the ledger against mix.lock with --check.
- Integration with deps-audit: Runs Phase 1 supply-chain rules before prompting for a verdict, and vetted versions are downgraded to INFO on subsequent
phx-deps-audit runs.
- Use Case: After running a dependency audit on a Phoenix project, vet
phoenix 1.7.21 by reviewing its findings, confirming a verdict, and recording it in the ledger so future audits treat it as trusted.
Quick Start
Ask the assistant to vet a specific Hex package version, for example by running phx-deps-vet on phoenix 1.7.21 and confirming the verdict when prompted.