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.

Headline numbers

MetricValue
Tests673
Suites27
Pass rate (CI)100%
The full suite is required to pass on every release. Releases that do not pass 673/673 are not promoted to PyPI.

Suite categories

The 27 suites fall into seven categories. Each category targets a distinct kind of failure mode.

Functional

Standard input/output correctness. The largest suite category.

Fuzz

Randomized inputs across stream interfaces, looking for crashes, hangs, or invariant violations.

Mutation

Mutation testing of the source itself. Tests must catch deliberately-injected bugs.

Differential

Cross-validation between independent implementations of the same stream logic.

Regression locks

Pinned outputs on canonical inputs. Catches silent behavioral changes between releases.

Concurrency

Multi-thread, multi-process, and async scoring patterns. Tests audit-chain integrity under contention.

Performance benchmarks

Wall-clock and memory bounds. Failures here are budget violations, not correctness violations.

Formal verification

Property-based and constraint-solver checks of the composition rule and the audit chain invariants. See Formal verification.

Why this much testing

Three reasons drive the test-suite size:
  1. The framework asserts integrity properties. A confidence-scoring layer that claims tamper-evident audit must be verifiable to that claim. Property-based and formal-verification suites are how that is done.
  2. The framework is intended for high-stakes deployment. Bugs in this layer have the potential to silently mislead downstream pipelines. The cost of a test-suite-detectable bug reaching production is asymmetric — expensive in production, cheap to catch in CI.
  3. IEEE-grade peer review is part of the roadmap. Reviewers are skeptical of frameworks that do not publish their test apparatus. The full suite is published and reproducible.

Running the suite

git clone https://github.com/Odingard/verdict-weight.git
cd verdict-weight
pip install -e ".[dev]"
pytest
Expected output ends with 673 passed. Runtime is on the order of a few minutes on a modern laptop. The full suite can be run on CPU only; no GPU dependency.

Continuous integration

Every commit on every branch is subjected to the full suite. Pull requests cannot be merged into main without a passing CI run. Release tags require an additional manual sign-off after CI passes. The CI configuration is in the public repository and can be inspected for completeness.

Coverage breakdown

The remaining pages in this section drill into the specific test categories that matter most for the framework’s claims:

Fuzz and mutation

The two suite categories that explicitly try to break the framework.

Formal verification

Property-based and constraint-solver checks of the composition rule.