YUCLAW v8.0.1

Financial AI normally gives you an answer.

YUCLAW gives you the evidence — what was known, when it was known, what it can support, what it cannot, and whether the conclusion survived.

Mission

Make financial AI accountable to evidence.

• Trace every claim to the filing it came from.
• Lock every method before the data arrives.
• State every conclusion’s limits.
• Keep every result — including the ones we wished had come out differently.

A public, hash-linked record, built to be recomputed by anyone.

Vision

Become the Science Trust Layer for Financial AI.

The evidence infrastructure that AI systems, researchers, and institutions use to decide what deserves to be believed.

How we work

Principle	Practice
We don’t ask you to trust us.	We give you the hash.
We don’t predict.	We register, compute once, and disclose.
We don’t hide the days we were wrong.	We chain them.

What you get

For	What you get
Analysts	The evidence behind every label, and the label’s limits.
Builders	Machine-readable receipts — passports, endpoints, and a registry you can walk line by line.
Institutions	A record that can be audited without asking us.

---

Statistics is one instrument. Evidence is the foundation. Science is the discipline.

AI is the market. Trust is the product. Accountability is the mission.

Designed for reproduction from published artifacts. One affiliated external-machine reproduction recorded; unaffiliated replications: 0.

First touch — install, ask for help, check a claim, reproduce the Lab (expected exit code in the comment):

pip install yuclaw                                              # installs the CLI
yuclaw --help                                                   # command list with one-line descriptions · exit 0
yuclaw check-claim --text "NVDA reported an insider sale in May 2026"   # Evidence Passport JSON · exit 0
yuclaw check-claim --ticker NVDA --accession 0001045810-26-000019       # passport for one cited filing · exit 0
yuclaw check-claim --accession 0001045810-26-000019            # accession alone: unique → same passport · exit 0
                                                               # (ambiguous accession → exit 2 with the candidate tickers)
yuclaw replay-lab                                              # rebuilds every published Lab statistic · exit 0 = reproduced

Exit-code contract for every command: 0 = success · 1 = ran, negative result (e.g. a replay mismatch) · 2 = usage or validation error · 3 = environment unsupported. The transcript below is generated from the release-candidate wheel and regenerated every release:

Transcript produced from the release-candidate wheel yuclaw-9.1.0-py3-none-any.whl (yuclaw 9.1.0, Python 3.12) by tools/cli_transcript.py; the replay-lab run uses the documented local-bundle path. Every command ran with YUCLAW_CORPUS=snapshot: check-claim answers from the corpus snapshot bundled in the wheel and never looks for a research node (without that setting, a host that reaches a research node answers from it and its passport has no corpus block). No date: release verification compares this block byte-for-byte with a fresh transcript of the final artifact, made the same way.

This is the beginning of the README. Read the rest at the original. Read the full README ↗