VERITY / 0.1

Append-only evidence ledger

A claim is not a proof.

Verity hashes every line of an agent run. A claim is accepted only when the recorded result supports it. Edit a line later and the chain fails.

Download free Source How to use 
$ verity log --run verity.jsonl --kind tool_result --data '{"text":"9 passed, 0 failed"}'
index=3 hash=1ac27e468272
$ verity claim --run verity.jsonl --statement "the bot tests passed" --evidence 3
index=4 hash=4dcd22ea8e29
$ verity verify --run verity.jsonl
OK entries=5

What it checks

Three rules. No model call in the core.

Chain

Each line is hashed to the previous line. Change any payload and verity verify fails.

Citation

A claim must cite an observation or a tool result already in the ledger. A goal is not evidence.

Support

9 passed, 0 failed supports a pass claim. binary found does not.

How to use

Verity does not run your tests. You or an agent run them. Verity records the result.

01

Install

Clone the repo and install the CLI. Python 3.10 or newer.

git clone https://github.com/jdkabattles/verity.git
cd verity
pip install -e .
02

Open a ledger on the project

One file per run. The goal is a statement, not a result.

cd your-project
verity init --run verity.jsonl
verity log --run verity.jsonl --kind goal \
  --data '{"text":"run the tests and report the real result"}'
03

Log the real output

Run the suite yourself, or have Hermes run it. Log what the tool printed.

verity log --run verity.jsonl --kind tool_result \
  --data '{"text":"9 passed, 0 failed"}'
04

Claim only what the output supports

Cite the tool_result index. An unrelated observation is refused.

verity claim --run verity.jsonl \
  --statement "the bot tests passed" --evidence 1
verity verify --run verity.jsonl
05

Check against a spec

A passing check means this run is intact and the required claim is supported. It does not mean the next run will pass.

printf '%s\n' '{"must_claim":["the bot tests passed"]}' > spec.json
verity check --run verity.jsonl --spec spec.json

Free version

Apache-2.0. Local. No account.

Download ZIP Clone on GitHub 
pip install "git+https://github.com/jdkabattles/verity.git"