content-explorer/contracts/MIGRATIONS.md

# Snapshot and manifest migrations

## 0.1 — frozen 2026-10-12

This is the first supported `schemaVersion`. The seed draft omitted `claims`, required relation `sourceRefs`, manifest `schemaVersion`, `relationLabels`, and `factPolicy`. Those documents were edited in place. There is no 0.0 reader.

`content_explorer.contract.SUPPORTED_VERSIONS` accepts only `0.1`. A document with any other version fails validation. A later version must add a named migrator, for example `migrate_0_1_to_0_2`, and must not guess missing rights or claims.

Display text on an entity is not a second source of truth. A `tldr` claim with `status: asserted` is the statement the renderer prefers to show. `status: unknown` records that the field was considered and is not known.
Freeze the v0.1 contract and the local ingest connector. The snapshot and manifest schemas, both example dataspaces, and the shared text renderer now pass the fixture validator and the negative contract tests. JSON, NDJSON, and Markdown frontmatter publish a snapshot only when rights, identity, and references allow it. CONTENT-WP-0001 and CONTENT-WP-0003 are marked finished against those artifacts. CONTENT-WP-0000-T04 stays open. SCOPE.md and the 19:05 scope-against-intent note record the stop. Assistant: grok Assistant-Session: 01a130f1-abfb-7d71-9cd6-a8b75ec7f95a 2026-10-12 19:07:32 +02:00			`# Snapshot and manifest migrations`

			`## 0.1 — frozen 2026-10-12`

			This is the first supported `schemaVersion`. The seed draft omitted `claims`, required relation `sourceRefs`, manifest `schemaVersion`, `relationLabels`, and `factPolicy`. Those documents were edited in place. There is no 0.0 reader.

			`content_explorer.contract.SUPPORTED_VERSIONS` accepts only `0.1`. A document with any other version fails validation. A later version must add a named migrator, for example `migrate_0_1_to_0_2`, and must not guess missing rights or claims.

			Display text on an entity is not a second source of truth. A `tldr` claim with `status: asserted` is the statement the renderer prefers to show. `status: unknown` records that the field was considered and is not known.