assurance-cli
Did the job cover everything it was supposed to cover? Arithmetic, not models.
Install
pip install assurance-cli
# or: pip install assurance # every tool
Quick start
assurance --help lists: audit, hook, serve, reach, init, check, diff, pin, drift,
deps, budget, authority. audit, hook, serve, reach, budget, authority and deps forward
to their packages when installed.
Point check at a folder of dated files (real output from a temp folder with Jan, Feb, Apr CSVs):
$ assurance check reports
3 of 4 months from 2026-01 to 2026-04 in reports — not in this folder: March 2026 — Range inferred from filenames: earliest 2026-01, latest 2026-04 — uneven spacing, so monthly was read from the names rather than detected. Override with --expect / --from / --to.
With --fail-on-gap that same line exits 1.
diff compares any two sets of keys (no folder required). pin snapshots MCP tool definitions and detects drift. drift watches a binary outcome stream.
What it checks
- Dated or numbered series in a folder (
check) — months, weeks, days, numbered runs - Coverage over any two key sets (
diff) - MCP tool-description drift since a pin (
pin) - Shift in a binary outcome stream (
drift) - Forwards: session audit, the Stop hook, the local endpoint, what a change reaches, run budget, authority review, dependency install hooks
In CI
| exit | means |
|---|---|
0 |
checked; no gap (or not asked to fail on one) |
1 |
gap / unexpected key / stale pin / nothing it could check |
2 |
could not run (bad path, missing sibling package, bad JSON) |
Limits
- Does not invent the expected set.
difftakes your declaration;checkderives one and prints how. - No network, no telemetry, no keys.
- A folder it cannot parse exits 1, not 0 — silence is not a pass.
- Skipped tool directories (
.git,node_modules, …) are named, not folded into “files not opened” as if they were content.
See the root README and CHANGELOG.md.
1 maintainer
Metadata
1 maintainer
Release files for assurance-cli 0.6.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| assurance_cli-0.6.5.tar.gz | 69.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| assurance_cli-0.6.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 117.1 kB
Release files / assurance_cli-0.6.5.tar.gz
| Download URL | assurance_cli-0.6.5.tar.gz |
|---|---|
| Size | 69.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1e898274d0e9cbd80cb33388716646ebd03715cbe88dce566ee706b17f86a0d2
|
|
BLAKE2b-256 checksum How to use checksums |
1f2dc336d2d965821e1b9f8df3242f803937bdb43d78d6881b062e0f123fa6b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / assurance_cli-0.6.5-py3-none-any.whl
| Download URL | assurance_cli-0.6.5-py3-none-any.whl |
|---|---|
| Size | 48.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
180f4e159223162e303bd50a3dcb803b3de8c4655e330f62b70cdcc6dc6d77b6
|
|
BLAKE2b-256 checksum How to use checksums |
881d1f01ae7533120a387b4591cc8baf107aa04e421c49205e88731d895af15e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency log
