You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
falsify anchor <spec> [--sealed] [--registry URL] [--handle H]. Posts the
manifest to a PRML registry (default registry.falsify.dev), refuses the answer
unless the registry's hash equals the local canonical hash, and saves <stem>.prml.receipt.json, <stem>.prml.tsr (RFC 3161) and <stem>.prml.rekor.json (Rekor v2) next to the manifest. --sealed publishes
only the hash and timestamps. Standard library only.
falsify receipt verify <spec> [--fetch] [--trusted-root FILE] [--json].
Offline receipt check without OpenSSL: the RFC 3161 token's messageImprint must
equal the manifest hash and its signature must chain to Sigstore's TSA root;
the Rekor entry's digest must equal the manifest hash, its RFC 9162 inclusion
proof must reach the checkpoint root, and the checkpoint must be signed by the
log key. Trust anchors are pinned from Sigstore's trusted_root.json (sha256
6494e21e…, 28 Oct 2026); --trusted-root overrides them. Exit 0 VERIFIED,
3 INVALID, 11 PARTIAL (log key unknown), 2 bad input. Needs the new optional
extra pip install "falsify[receipt]" (rfc3161-client, cryptography).
Tests: tests/test_receipt.py (offline fixtures from a real registry record,
mock registry for anchor).
falsify attest <spec> --as test-result --observed <v> [--subject NAME=sha256:HEX] [--url URL].
Emits an in-toto Test Result v0.1 Statement for one run: configuration is the
PRML manifest (digest = PRML hash, media type application/vnd.prml+yaml), result is PASSED or FAILED from the locked predicate, subject is the
tested artifact (default: the dataset). It refuses to attest when the manifest
no longer matches its lock (sidecar or --expected-hash; exit 3) and exits 10
on FAILED so CI can gate. In GitHub Actions url defaults to the run URL.
Hosts that already consume in-toto test results can require "ran against this
locked bar" without learning a new predicate type. Tests: tests/test_attest_test_result.py.
Changed
falsify init writes a manifest that can be locked as written. It now
generates a real UUIDv7 claim_id (RFC 9562; uuid.uuid7 is 3.14+ only) and
the current UTC created_at, and --dataset FILE sets dataset.hash to the
file's SHA-256 (dataset.id defaults to the file name). New flags --metric, --comparator, --threshold, --seed, --producer, --dataset-id. A
missing output directory is a clean error (exit 2) instead of a traceback; a .json name writes JSON. Placeholders that remain are listed. Tests: tests/test_prml_init.py.
Docs: docs/CASE_STUDIES.md, docs/EXAMPLES.md and docs/DEMO_SCRIPT.md used
the old command name for the workflow engine (falsify init --template, falsify run, falsify verdict, ...); they now say falsify-engine.