Skip to content

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 28 Oct 11:31
· 22 commits to main since this release

Added

  • 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.