feat: complete evidence restructuring worktree

2026-08-26 11:39:02 +02:00
parent a54d4769dd
commit 38f02cfd08
56 changed files with 1981 additions and 1801 deletions
@@ -47,6 +47,19 @@ evidence/
 `source/`, the manifest, the evaluation set, and other support files are materialized for
 traceability but never acquired by v2 runtime preprocessing.

+### Curated unit representation
+
+The `schema_version` inside each `curated/**/*.md` file is distinct from the workspace descriptor
+version above. Unit schema v1 stores the complete typed unit in YAML frontmatter and remains
+readable for compatibility. Unit schema v2 keeps short metadata in frontmatter and stores the
+typed payload, supporting excerpts, and review items in a deterministic Markdown body.
+
+V2 bodies use headings, paragraphs, code lists, enum tables, fenced SQL, and blockquotes according
+to the Evidence kind. Invisible `tht:` comments delimit typed fields. Parsers must reject missing,
+duplicate, unknown, or unstructured body content; they must never silently ignore it. Newly
+prepared units use v2. `tht evidence migrate <workspace-root>` upgrades existing v1 units locally
+without a model call, commit, publication, or semantic change.
+
 ### Example: filesystem

 ```yaml