Initial curated RAGcore source from c16667f0c9397e2bfc8dd0255b114fba23c8d05e

docs/02_DOMAIN/STATE_MACHINES.md

@@ -0,0 +1,43 @@
+# State Machines
+
+## Document version
+
+```text
+acquired -> security_checked -> parsed -> normalized -> chunked
+-> embedded -> indexed -> validated -> published
+```
+
+Terminal/alternatief:
+
+- `quarantined`: securitygate faalde of vereist review;
+- `failed`: technische fout met retryclassificatie;
+- `superseded`: was gepubliceerd maar is vervangen;
+- `retired`: bron verwijderd/retentie verlopen.
+
+Alle transities zijn expliciet, geaudit en idempotent. `published` vereist dat alle voorafgaande artifacts duurzaam bestaan.
+
+## Job
+
+```text
+pending -> ready -> leased -> running -> succeeded
+                    |          \-> retry_wait -> ready
+                    \-> expired -> ready
+running -> failed_terminal
+running -> cancelled
+```
+
+## Source sync
+
+```text
+idle -> scheduled -> scanning -> applying -> validating -> completed
+                       \-> failed
+```
+
+## Index build
+
+```text
+created -> building -> validating -> ready -> active -> retired
+                     \-> failed
+```
+
+Aliasactivatie mag alleen van `ready` naar `active`, met rollback naar vorige actieve build.