Skip to main content

Documentation Index

Fetch the complete documentation index at: https://verdictweight.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
When to install from source

Install from source if any of the following apply:
  • You are auditing the codebase before deployment.
  • You are contributing fixes or extensions.
  • Your environment requires reproduction from a specific commit hash.
  • You are building against an unreleased branch.
For all other cases, use the PyPI install path.

​
Clone and install

git clone https://github.com/Odingard/verdict-weight.git
cd verdict-weight
pip install -e ".[dev]"
The -e flag installs in editable mode so changes to source are reflected immediately. The [dev] extra pulls in the test runner and linting tools.

​
Run the test suite

After install, verify the full test suite passes locally: 
pytest
You should see 673 tests across 27 suites all passing. If any test fails, do not deploy that build — open an issue with the failure log.
The test suite includes fuzz, mutation, differential, formal-verification, regression-lock, and concurrency suites. Total runtime is on the order of a few minutes on a modern laptop. See Coverage overview for the full breakdown.

​
Reproducing a published release

To build against an exact published release: 
git checkout vX.Y.Z   # replace with the desired tag
pip install -e .
The release tags on GitHub correspond one-to-one with versions on PyPI and with archived snapshots on Zenodo.

​
Auditing the code before deploy

If your organization requires source review before deployment:
1

Clone at a tagged release

Always audit a tagged release, never main. main is a development branch.
2

Verify the Zenodo archive matches

The Zenodo DOI snapshot should byte-match the GitHub tag of the same version. Compute SHA-256 of the source tarball from each and compare.
3

Run the full test suite

pytest must pass cleanly. Any environment that cannot reproduce 673/673 should not be promoted.
4

Review the security streams in detail

Stream 6, Stream 7, and Stream 8 carry the integrity guarantees and warrant the closest review.