"""Chunk schema version — stamped into every chunk's metadata at persistence time.

Single source of truth for the per-chunk shape version written by Doc-Extraction
into PostgreSQL (`data_hierarchical_nodes.value->'__data__'->'metadata'`) and
Milvus. Covers both the metadata-envelope JSON and any top-level Milvus columns
projected from the chunk (e.g., `verified_tag_names` introduced in TEXTIQ-569,
bump 1.0 → 1.1).

Bump rules (semver-style):
- **Major** (`1.0` -> `2.0`): breaking — field removed or renamed, type changed,
  or semantics altered in a way that existing consumers cannot handle.
- **Minor** (`1.0` -> `1.1`): additive — new optional field (envelope JSON or
  Milvus column); existing consumers continue to work without changes.

Consumer contract:
- Producers (this file's importers) MUST stamp the current value on every chunk.
- Consumers MUST accept versions `N` and `N-1`.
- A missing `schema_version` field on an existing row is treated as implicit `"1.0"`
  (unblocks the initial rollout without a backfill migration).
"""

CHUNK_SCHEMA_VERSION = "1.1"