Initial curated RAGcore source from c16667f0c9397e2bfc8dd0255b114fba23c8d05e

docs/06_API/ERROR_MODEL.md

@@ -0,0 +1,23 @@
+# Error Model
+
+Alle API-fouten gebruiken `application/problem+json`:
+
+```json
+{
+  "type": "https://ragcore.example.test/problems/space-forbidden",
+  "title": "Knowledge space access denied",
+  "status": 403,
+  "code": "SPACE_FORBIDDEN",
+  "detail": "The caller is not allowed to use one or more requested spaces.",
+  "trace_id": "..."
+}
+```
+
+## Regels
+
+- `code` is stabiel en machineleesbaar.
+- `detail` bevat geen secrets, SQL, filesystemroots of providerkeys.
+- Validation errors bevatten veldpaden en veilige redenen.
+- Provider/downstream errors worden gemapt naar RAGCore-codes.
+- Retryable errors geven optioneel `retry_after_seconds`.
+- 404 mag voor gevoelige resources worden gebruikt waar 403 bestaan zou lekken.