Ground a claim with evidence

What you will build

A claim on an artifact revision, grounded by evidence. Sources are bound as supporting or contradicting, with provenance retained, so the assertion is never separated from the reason it is believed.

Architecture preview

Coverage is the input a policy uses to decide whether a claim is ready for a decision or an effect. Contradictions are surfaced as conflicts rather than silently resolved.

Prerequisites

• An artifact revision (see the previous quickstart)

Steps

1. Create a claim

   Record a discrete, addressable assertion on the revision.

   curl --request POST \
     --url "$CRESCEVO_BASE_URL/v1/artifacts/a_123/claims" \
     --header "Authorization: Bearer $CRESCEVO_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{ "revision_id": "rev_2", "statement": "Pricing rose 4% quarter over quarter." }'

   { "claim_id": "c_1", "coverage": "uncovered" }

2. Attach supporting evidence

   Bind a source as supporting, with its provenance.

   curl --request POST \
     --url "$CRESCEVO_BASE_URL/v1/claims/c_1/evidence" \
     --header "Authorization: Bearer $CRESCEVO_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{ "stance": "supporting", "source_uri": "https://example.test/report", "excerpt": "Q3 list prices up 4%." }'

3. Attach contradicting evidence

   Bind a second source as contradicting. Crescevo surfaces the disagreement rather than resolving it for you.

   curl --request POST \
     --url "$CRESCEVO_BASE_URL/v1/claims/c_1/evidence" \
     --header "Authorization: Bearer $CRESCEVO_API_KEY" \
     --header "Content-Type: application/json" \
     --data '{ "stance": "contradicting", "source_uri": "https://example.test/survey", "excerpt": "Street pricing flat." }'

4. Read coverage

   Fetch the claim and inspect its coverage and conflict state.

   curl --url "$CRESCEVO_BASE_URL/v1/claims/c_1" \
     --header "Authorization: Bearer $CRESCEVO_API_KEY"

   { "claim_id": "c_1", "coverage": "partial", "conflict": true }

Verify success

• The claim has one supporting and one contradicting evidence relation.
• Coverage reflects the attached evidence.
• The conflict between sources is surfaced, not hidden.

Clean up

Test-tenant resources expire automatically; reset the fixture to start over.

Next: Request and resolve a decision →