Initial curated RAGcore source from c16667f0c9397e2bfc8dd0255b114fba23c8d05e

docs/05_RETRIEVAL/CITATIONS.md

@@ -0,0 +1,39 @@
+# 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.