docs(evidence): publish curated-only workspace contract

2026-08-25 01:52:27 +02:00
parent 619ac2e141
commit 9f0184388d
7 changed files with 153 additions and 14 deletions
@@ -226,6 +226,13 @@
 - **Engine:** `evidencePolicy` no longer stops filesystem sources (`evidence_materialization_required`
  retired); `preprocess evidence`/`preprocess run` operate on the materialized root. Evidence Qdrant
  records remain revision-scoped; corpus ACTIVE is revision-qualified. HTTP/S3 Evidence is unchanged.
+- **Curated-only runtime contract (Evidence schema v2):** the new authoring layout preserves the
+  complete commit-addressed `evidence/` tree (`source/`, `curated/`, manifest and evaluation files),
+  while the rendered filesystem acquisition default is only `curated/**/*.md`. Version 2 rejects
+  source or mixed source/curated runtime patterns; legacy Evidence version 1 retains its explicit
+  safe-pattern compatibility. The curator validates before merge and the runtime validates the
+  pinned curated corpus before indexing. The existing unnamed dense vector remains intact while
+  Evidence may add `bm25`/`idf` additively; no runtime operation writes the authoring repository.
 - **Retention:** materialized roots live inside the commit-addressed snapshot directory, so they are
  retained while pinned and removed by the existing snapshot retention scan when unreferenced.
 - **Key files:** `backend/src/workspaces/evidence-materialization.ts` (+test),