Diff API

Source: docs/diff-api.md

Diff API

The diff endpoint compares two analysis runs under the same lens + ruleset and returns a deterministic summary of changes in commitment boundaries.

Endpoint

POST /diff

Request


{

  "artifact_identifier": "terms-of-service",

  "analysis_run_id_a": "uuid",

  "analysis_run_id_b": "uuid"

}

Response (shape)


{

  "drift_id": "uuid",

  "added": [ { "...": "assumption record" } ],

  "removed": [ { "...": "assumption record" } ],

  "unchanged": [ { "...": "assumption record" } ],

  "net_change": 2

}

Notes

Runs must belong to the same project.
Runs must use the same lens and ruleset.
artifact_identifier is a caller-provided label used for history lookups.