AI Claim Ledger

• Add optional source review dates with an explicit --as-of review boundary.
• Identify claims relying on overdue supporting sources, including shared source links; retain supplied truth statuses and evidence relations.
• List undated support and reviews recorded after the boundary without fetching URLs or inferring truth.

• Added a version 2 ledger format with reusable source records and explicit supports,

contradicts, and context relationships.

• Added evidence-coverage reporting for unused sources, disputed claims without contradictory

evidence, and claims with conflicting evidence.

• Preserved validation and reporting for existing version 1 ledgers.

• Replaced placeholder source URLs in the sample and tests with primary Python documentation.

• Added structured claim, source, note, and verification-status records.
• Added source URL validation and evidence requirements for verified claims.
• Added filtered Markdown checklists and JSON reports.

Read the complete changelog

Before running these source commands, download the v1.2.0 source archive, extract it, and open a terminal in the extracted project folder containing README.md. Follow the tagged README for required runtimes and any platform-specific setup.

python -m pip install .
claim-ledger examples/claims.json
claim-ledger examples/claims.json --status needs-source --format json

Verified claims require at least one supporting relationship to a syntactically valid HTTP or HTTPS source. Reports group claims by status, retain notes and source labels, and flag unused sources, disputed claims without contradictory evidence, and claims that have both supporting and contradictory evidence. The same source can be linked to multiple claims without copying its URL and title. Existing version 1 ledgers remain supported.

Version 2 uses a top-level source registry and claim-level evidence links:

{
  "version": 2,
  "sources": [
    {"id": "python-json", "url": "https://docs.python.org/3/library/json.html", "title": "Python JSON documentation"}
  ],
  "claims": [
    {
      "id": "claim-1",
      "claim": "Python includes a standard JSON encoder and decoder.",
      "status": "verified",
      "evidence": [{"source_id": "python-json", "relation": "supports"}]
    }
  ]
}