Yichus / Reference / API MCP tools

api_fact_diff

Diff the fact families between two versions of a program: which agenda cards appeared, vanished or changed, so a review reads the DELTA a change made rather than re-reading the whole program. Optional delta claims are checked against the same report and answered with refuted, exactly as api_verify_claims answers claims about one version. Same job as yichus fact-diff, which reads the two versions from disk and turns refutals into a nonzero exit code.

Kind: FactDiff. Origin: Yichus/Mcp::catalog.

CLI: yichus fact-diff — the same FactDelta over two program versions; the CLI reads them from two sets of paths and the tool from before_sources and after_sources.

Parameters

• before_sources (required, array) — JSON array of {fileName, source} for the BEFORE version.
• after_sources (required, array) — JSON array of {fileName, source} for the AFTER version.
• claims (optional, object) — Optional JSON object with a claims array, each claim naming a subject and the change it asserts.

Read the result according to this tool’s scope: static checks, bounded execution checks, and descriptive diagrams answer different questions. A successful call is not a general approval of the program. The safety and permissions guide compares the checks and provides editable ownership, guard, and role examples.