# Citations

## Eigenschappen

Een citation is immutable en verwijst naar:

- workspace/space;
- document en documentversion;
- chunk en parentchunk;
- pagina, sectie of regelbereik;
- excerpt en excerptchecksum;
- source URI en acquisition timestamp;
- retrieval run en gebruikte index/profileversie.

## ID

Deterministische UUIDv5 of stabiele opaque ID op immutable citationinputs. Een latere documentversion verandert een bestaande citation niet.

## Presentatie (1.2.0)

Naast de machine-velden levert iedere citation in `/v1/search`, `/v1/context` en
`/v1/answers` leesbare provenance, opgelost uit het Source Registry:
`source_id`, `source_name`, `source_kind`, `locator` (item binnen de bron),
`revision` (bijv. Git-commit van de geciteerde versie) en `display`, bijvoorbeeld
`Network Design.pdf · p. 18 · Firewall Segmentation` of
`infrastructure/runbooks/backup.md · commit 3fc821a · lines 118-143`.
`source_uri` (`ragcore://source/<source_id>`) blijft de stabiele interne locator.
Een citation is herleidbaar tot bron → item (`locator`) → versie
(`document_version_id` + `revision`) → chunk (`id`, `excerpt_sha256`) → locatie
(sectie/pagina/regels). Autorisatie verandert hierdoor niet: de presentatie
resolvet alleen documenten die de caller al geautoriseerd terugkreeg.

## API

Antwoorden refereren citation IDs in tekst/structured claims. `GET /v1/citations/{id}` autoriseert opnieuw en levert alleen content die de caller nu mag lezen. Audit kan historische metadata bewaren terwijl gevoelige excerptretentie policy volgt.

## Claimondersteuning

Generatie-output moet claims aan citations koppelen. Niet-ondersteunde feitelijke claims worden verwijderd, opnieuw gegenereerd of leiden tot een expliciete failure afhankelijk van profiel.