x4d-devkit 0.43.0rc4__tar.gz → 0.45.0rc1__tar.gz

{x4d_devkit-0.43.0rc4/x4d_devkit.egg-info → x4d_devkit-0.45.0rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.43.0rc4
+Version: 0.45.0rc1
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0
@@ -97,18 +97,18 @@ platform-to-platform data flow. See
 generic identity model, and
 [docs/training-current-state-data.md](docs/training-current-state-data.md) for
 work-session materialization and conditional annotation writeback. Every
-Dataset 0.17 Clip carries its authoritative Label Schema snapshot at root
+Dataset 0.18 Clip carries its authoritative Label Schema snapshot at root
 `label_schema.json`.
 Shared validation rules for platform submit, X-Points preflight, local clip
 validation, and training consumers are documented in
 [docs/shared-contract-validation.md](docs/shared-contract-validation.md).
-The Dataset 0.17 native contract, exact nanosecond time, Multi-LiDAR layout,
+The Dataset 0.18 native contract, exact nanosecond time, Multi-LiDAR layout,
 and model materialization are documented in
-[docs/dataset-0.17.md](docs/dataset-0.17.md). The single-file annotation
+[docs/dataset-0.18.md](docs/dataset-0.18.md). The single-file annotation
 authority, semantic revision, and
 derived track views are documented in
 [docs/annotation-contract.md](docs/annotation-contract.md).
-Portable export producers and consumers share the exact `0.17` manifest
+Portable export producers and consumers share the exact `0.18` manifest
 parser documented in
 [docs/export-bundle-contract.md](docs/export-bundle-contract.md).
 `examples/current_state_identity_consumers.py` provides an offline downstream
@@ -133,7 +133,7 @@ Included:
 - Typed point-level semantic-scene authoring sessions, dirty semantic-chunk upload, and
   complete compare-and-set submit without a per-point mutation API.
 - Strict validation of `x4d-training-identity-v5` manifests.
-- Strict producer-option and manifest parsing for export bundle `0.17`.
+- Strict producer-option and manifest parsing for export bundle `0.18`.
 - Clip preannotation protocol, source-only inference adapter, and service
   wrapper for algorithm projects.
 
@@ -247,7 +247,7 @@ comparison = compare_project_label_schema_snapshots(project_schema, current)
 assert comparison.status == "same"
 ```
 
-The native Dataset 0.17 Clip stores the immutable identity in
+The native Dataset 0.18 Clip stores the immutable identity in
 `meta.label_schema` and the complete authoritative snapshot in root
 `label_schema.json`. Registry records are used when creating/binding Clips, not
 when loading or validating their current contents.
@@ -264,8 +264,8 @@ identity manifests, and update plans use one schema field only:
 `clip_label_schema` are not aliases and are rejected. A ready platform record
 without the complete identity is also rejected.
 
-`x4d-devkit dataset inspect` writes `x4d-remote-identity-v6`, and
-`x4d-devkit dataset diff` writes `x4d-update-plan-v8`. The v8 plan records the
+`x4d-devkit dataset inspect` writes `x4d-remote-identity-v7`, and
+`x4d-devkit dataset diff` writes `x4d-update-plan-v9`. The v8 plan records the
 requested materialization policy, each cache's reviewed samples/sweeps
 materialization revisions, and every Clip's reviewed target and local
 predecessor identities.
@@ -402,7 +402,7 @@ asset existence and point-cloud layout checks without downloading the assets.
 
 Third-party model projects should use `x4d-devkit[inference]` instead of
 hand-writing the X-4D preannotation protocol. The pipeline receives an
-annotation-isolated `InferenceClip` and returns one complete Dataset 0.17
+annotation-isolated `InferenceClip` and returns one complete Dataset 0.18
 annotation document.
 
 ```python

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/README.md

@@ -54,18 +54,18 @@ platform-to-platform data flow. See
 generic identity model, and
 [docs/training-current-state-data.md](docs/training-current-state-data.md) for
 work-session materialization and conditional annotation writeback. Every
-Dataset 0.17 Clip carries its authoritative Label Schema snapshot at root
+Dataset 0.18 Clip carries its authoritative Label Schema snapshot at root
 `label_schema.json`.
 Shared validation rules for platform submit, X-Points preflight, local clip
 validation, and training consumers are documented in
 [docs/shared-contract-validation.md](docs/shared-contract-validation.md).
-The Dataset 0.17 native contract, exact nanosecond time, Multi-LiDAR layout,
+The Dataset 0.18 native contract, exact nanosecond time, Multi-LiDAR layout,
 and model materialization are documented in
-[docs/dataset-0.17.md](docs/dataset-0.17.md). The single-file annotation
+[docs/dataset-0.18.md](docs/dataset-0.18.md). The single-file annotation
 authority, semantic revision, and
 derived track views are documented in
 [docs/annotation-contract.md](docs/annotation-contract.md).
-Portable export producers and consumers share the exact `0.17` manifest
+Portable export producers and consumers share the exact `0.18` manifest
 parser documented in
 [docs/export-bundle-contract.md](docs/export-bundle-contract.md).
 `examples/current_state_identity_consumers.py` provides an offline downstream
@@ -90,7 +90,7 @@ Included:
 - Typed point-level semantic-scene authoring sessions, dirty semantic-chunk upload, and
   complete compare-and-set submit without a per-point mutation API.
 - Strict validation of `x4d-training-identity-v5` manifests.
-- Strict producer-option and manifest parsing for export bundle `0.17`.
+- Strict producer-option and manifest parsing for export bundle `0.18`.
 - Clip preannotation protocol, source-only inference adapter, and service
   wrapper for algorithm projects.
 
@@ -204,7 +204,7 @@ comparison = compare_project_label_schema_snapshots(project_schema, current)
 assert comparison.status == "same"
 ```
 
-The native Dataset 0.17 Clip stores the immutable identity in
+The native Dataset 0.18 Clip stores the immutable identity in
 `meta.label_schema` and the complete authoritative snapshot in root
 `label_schema.json`. Registry records are used when creating/binding Clips, not
 when loading or validating their current contents.
@@ -221,8 +221,8 @@ identity manifests, and update plans use one schema field only:
 `clip_label_schema` are not aliases and are rejected. A ready platform record
 without the complete identity is also rejected.
 
-`x4d-devkit dataset inspect` writes `x4d-remote-identity-v6`, and
-`x4d-devkit dataset diff` writes `x4d-update-plan-v8`. The v8 plan records the
+`x4d-devkit dataset inspect` writes `x4d-remote-identity-v7`, and
+`x4d-devkit dataset diff` writes `x4d-update-plan-v9`. The v8 plan records the
 requested materialization policy, each cache's reviewed samples/sweeps
 materialization revisions, and every Clip's reviewed target and local
 predecessor identities.
@@ -359,7 +359,7 @@ asset existence and point-cloud layout checks without downloading the assets.
 
 Third-party model projects should use `x4d-devkit[inference]` instead of
 hand-writing the X-4D preannotation protocol. The pipeline receives an
-annotation-isolated `InferenceClip` and returns one complete Dataset 0.17
+annotation-isolated `InferenceClip` and returns one complete Dataset 0.18
 annotation document.
 
 ```python

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "x4d-devkit"
-version = "0.43.0rc4"
+version = "0.45.0rc1"
 description = "Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation"
 readme = "README.md"
 license = "Apache-2.0"

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_boundary.py

@@ -77,6 +77,11 @@ def test_top_level_exports_only_stable_sdk_surface():
 
     assert set(x4d_devkit.__all__) == {
         "__version__",
+        "VECTOR_MAP_CONTRACT_VERSION",
+        "VectorMapDocument",
+        "parse_vector_map",
+        "parse_vector_map_change",
+        "vector_map_geometry_rules",
         "ANNOTATION_CONTRACT_VERSION",
         "CLEAN_BASEMAP_CONTRACT_VERSION",
         "CleanBasemapManifest",

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_contract_validation.py

@@ -24,9 +24,8 @@ def _time(value: int) -> dict[str, int]:
 def _meta(*, keyframe_count: int = 1) -> dict:
     return {
         "clip_id": "clip-a",
-        "schema_version": "0.17",
+        "schema_version": "0.18",
         "session_id": "session-a",
-        "vehicle_id": "vehicle-a",
         "capture_time": _time(1),
         "duration_s": float(max(0, keyframe_count - 1)),
         "keyframe_count": keyframe_count,
@@ -152,7 +151,7 @@ def _context(
 ) -> ClipValidationContext:
     return ClipValidationContext(
         clip_id="clip-a",
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
         label_schema=_schema(),
         samples=[_sample()] if samples is None else samples,
         sample_data=[_sample_data()] if sample_data is None else sample_data,
@@ -423,7 +422,7 @@ def test_context_rejects_non_list_payloads_and_invalid_meta():
     with pytest.raises(TypeError):
         ClipValidationContext(
             clip_id="clip-a",
-            clip_schema_version="0.17",
+            clip_schema_version="0.18",
             label_schema=_schema(),
             samples=(),
             sample_data=[],

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_current_state.py

@@ -31,9 +31,10 @@ def _identity(**overrides):
         "pose_revision": "pose",
         "annotation_revision": current_work_session_payload()["annotation_revision"],
         "semantic_scene_revision": None,
+        "vector_map_revision": None,
         "label_schema": schema_identity(),
         "business_metadata_revision": "business-metadata",
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
         "ready": True,
         "blockers": [],
     }
@@ -209,6 +210,7 @@ def test_clip_identity_direct_constructor_requires_explicit_pose_revision():
         label_schema=label_schema,
         pose_revision=None,
         semantic_scene_revision=None,
+        vector_map_revision=None,
     )
     assert identity.to_dict()["pose_revision"] is None
 
@@ -231,5 +233,5 @@ def test_normalize_clip_identity_rejects_removed_source_granularity(field):
 
 
 def test_normalize_clip_identity_rejects_non_current_clip_schema_version():
-    with pytest.raises(ValueError, match="clip_schema_version must be '0.17'"):
+    with pytest.raises(ValueError, match="clip_schema_version must be '0.18'"):
         normalize_clip_identity(_identity(clip_schema_version="0.10"))

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_dataset_identity.py

@@ -46,9 +46,10 @@ def _identity(clip_id: str = "clip-a", **overrides):
         "pose_revision": "sha256:pose",
         "annotation_revision": "sha256:annotation",
         "semantic_scene_revision": None,
+        "vector_map_revision": None,
         "label_schema": schema_identity(),
         "business_metadata_revision": "sha256:business-metadata",
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
         "ready": True,
         "blockers": [],
     }
@@ -289,6 +290,7 @@ def test_update_plan_maps_each_change_to_independent_portable_action():
         "refresh_pose": ["clip-a"],
         "refresh_annotation": ["clip-a"],
         "refresh_semantic_scene": [],
+        "refresh_vector_map": [],
         "refresh_label_schema": ["clip-a"],
         "refresh_business_metadata": ["clip-a"],
         "rematerialize_clip": [],
@@ -459,6 +461,7 @@ def _local_from_work_session(payload):
                 "pose_revision",
                 "annotation_revision",
                 "semantic_scene_revision",
+                "vector_map_revision",
                 "label_schema",
                 "business_metadata_revision",
                 "clip_schema_version",
@@ -855,7 +858,7 @@ def test_sync_composes_schema_and_annotation_into_one_clip_update(tmp_path):
     result = sync_update_plan(client, plan=plan, data_root=tmp_path, workers=1)
 
     assert result["schema_version"] == SYNC_RESULT_SCHEMA_VERSION
-    assert result["schema_version"] == "x4d-sync-result-v8"
+    assert result["schema_version"] == "x4d-sync-result-v9"
     assert result["source_transfer"] == {
         "planned_objects": 0,
         "planned_bytes": 0,

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_export_bundle.py

@@ -20,7 +20,7 @@ def _manifest(*, include_sweeps: bool = True) -> dict:
     return {
         "export_id": "exp_20260711_a3f8c1d2",
         "exported_at": {"sec": 1_783_735_200, "nanosec": 123_456_000},
-        "schema_version": "0.17",
+        "schema_version": "0.18",
         "options": {
             "include_sweeps": include_sweeps,
             "pointcloud_format": "pcd_binary",
@@ -31,7 +31,7 @@ def _manifest(*, include_sweeps: bool = True) -> dict:
         "clips": [
             {
                 "clip_id": "20260711_G150-002_003",
-                "schema_version": "0.17",
+                "schema_version": "0.18",
                 "label_schema": schema_identity(),
                 "annotation_frame_id": "base_link",
                 "channels": ["cam_front", "lidar"],

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_inference_input.py

@@ -30,7 +30,7 @@ def _inference_clip(tmp_path) -> tuple[ClipLoader, InferenceClip]:
         sweeps_revision=_digest("b"),
         calibration_revision="calibration-1",
         pose_revision="pose-1",
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
     )
     access = PreannotationClipAccess(
         project_id=7,
@@ -174,7 +174,7 @@ def test_inference_clip_rejects_a_mismatched_source_identity(tmp_path):
         sweeps_revision=clip.source_identity.sweeps_revision,
         calibration_revision=clip.source_identity.calibration_revision,
         pose_revision=clip.source_identity.pose_revision,
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
     )
 
     with pytest.raises(ValueError, match="source identity"):

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_inference_schemas.py

@@ -37,7 +37,7 @@ def _request_payload() -> dict:
                 "sweeps_revision": _digest("f"),
                 "calibration_revision": "calibration-1",
                 "pose_revision": "pose-1",
-                "clip_schema_version": "0.17",
+                "clip_schema_version": "0.18",
             },
             "label_schema": schema_identity(),
             "base_annotation_revision": _digest("a"),
@@ -106,8 +106,9 @@ def test_source_identity_projects_only_pure_inference_dependencies():
             "pose_revision": "pose-1",
             "annotation_revision": _digest("a"),
             "semantic_scene_revision": _digest("d"),
+            "vector_map_revision": None,
             "label_schema": schema_identity(),
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
             "ready": True,
             "blockers": [],
         }
@@ -119,7 +120,7 @@ def test_source_identity_projects_only_pure_inference_dependencies():
         "sweeps_revision": _digest("f"),
         "calibration_revision": "calibration-1",
         "pose_revision": "pose-1",
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
     }
 
 

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_inference_service.py

@@ -83,7 +83,7 @@ def _fixture(tmp_path, pipeline=None, *, run_inline=True):
         sweeps_revision=_digest("e"),
         calibration_revision="calibration-1",
         pose_revision="pose-1",
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
     )
     selected = pipeline or FakePipeline()
 

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_label_schemas.py

@@ -282,9 +282,10 @@ def test_batch_resolution_deduplicates_by_task_free_binding():
             "pose_revision": "pose-a",
                 "annotation_revision": "ann-a",
                 "semantic_scene_revision": None,
+                "vector_map_revision": None,
             "business_metadata_revision": "business-a",
             "label_schema": identity,
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
             "ready": True,
             "blockers": [],
         },
@@ -298,9 +299,10 @@ def test_batch_resolution_deduplicates_by_task_free_binding():
             "pose_revision": "pose-b",
                 "annotation_revision": "ann-b",
                 "semantic_scene_revision": None,
+                "vector_map_revision": None,
             "business_metadata_revision": "business-b",
             "label_schema": identity,
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
             "ready": True,
             "blockers": [],
         },

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_loader.py

@@ -28,7 +28,7 @@ def loader(tmp_path):
 
 def test_loader_builds_current_typed_models_and_indexes(loader):
     assert isinstance(loader.meta, ClipMeta)
-    assert loader.schema_version == "0.17"
+    assert loader.schema_version == "0.18"
     assert loader.annotation_revision.startswith("sha256:")
     assert all(isinstance(item, Sample) for item in loader.samples)
     assert all(isinstance(item, Annotation) for item in loader.annotations)

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_models.py

@@ -82,9 +82,8 @@ def test_clip_meta_serializes_exact_current_metadata():
     sensors = {"cam_front": SensorInfo("camera", "cam_front")}
     meta = ClipMeta(
         clip_id="clip-a",
-        schema_version="0.17",
+        schema_version="0.18",
         session_id="session-a",
-        vehicle_id="vehicle-a",
         capture_time=TimeNs(1, 2),
         duration_s=1.0,
         num_keyframes=1,
@@ -96,7 +95,7 @@ def test_clip_meta_serializes_exact_current_metadata():
         scene_tags=["urban"],
     )
     wire = meta.to_dict()
-    assert wire["schema_version"] == "0.17"
+    assert wire["schema_version"] == "0.18"
     assert wire["capture_time"] == {"sec": 1, "nanosec": 2}
     assert wire["scene_tags"] == ["urban"]
     assert "route_tag" not in wire

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_preannotation_client.py

@@ -117,7 +117,7 @@ def _portable_candidate() -> dict:
             "sweeps_revision": _digest("f"),
             "calibration_revision": "calibration-1",
             "pose_revision": "pose-1",
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
         },
         "label_schema": schema_identity(),
         "base_annotation_revision": _digest("0"),

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_sdk_api.py

@@ -11,14 +11,14 @@ from x4d_devkit.eval.matching import MetricData
 
 
 def test_package_version_is_current_release():
-    assert x4d_devkit.__version__ == "0.43.0rc4"
+    assert x4d_devkit.__version__ == "0.45.0rc1"
 
 
 def test_loader_exposes_and_enforces_only_current_schema(tmp_path):
     loader = ClipLoader(write_current_clip(tmp_path / "current"))
-    assert loader.schema_version == "0.17"
-    loader.require_schema_version("0.17")
-    loader.require_schema_version({"0.17"})
+    assert loader.schema_version == "0.18"
+    loader.require_schema_version("0.18")
+    loader.require_schema_version({"0.18"})
     with pytest.raises(SchemaVersionMismatch):
         loader.require_schema_version("0.10")
     with pytest.raises(SchemaVersionMismatch):

x4d_devkit-0.45.0rc1/tests/test_source_attributes.py

@@ -0,0 +1,54 @@
+"""Vehicle-free metadata and the independent business-metadata boundary."""
+
+import copy
+
+import pytest
+
+from tests.current_clip_fixtures import current_clip_tables, write_current_clip
+from x4d_devkit.core.loader import ClipLoader
+from x4d_devkit.dataset_contract import (
+    DatasetContractError,
+    parse_clip_meta,
+    project_business_metadata,
+    project_source_metadata,
+)
+
+
+def test_vehicle_free_clip_loads_and_roundtrips(tmp_path):
+    tables = current_clip_tables()
+    clip_dir = write_current_clip(tmp_path / "test-clip")
+    clip = ClipLoader(clip_dir)
+    assert clip.meta.source_attributes is None
+    assert clip.meta.to_dict() == tables["meta.json"]
+
+
+def test_source_attributes_change_only_business_metadata():
+    meta = current_clip_tables()["meta.json"]
+    candidate = copy.deepcopy(meta)
+    candidate["source_attributes"] = {"vehicle_id": "V01", "vehicle_model": "车型 A"}
+    parsed = parse_clip_meta(candidate, include_label_schema=True)
+    assert parsed == candidate
+    assert project_source_metadata(meta) == project_source_metadata(candidate)
+    assert project_business_metadata(meta) == {}
+    assert project_business_metadata(candidate) == {
+        "source_attributes": candidate["source_attributes"]
+    }
+
+
+@pytest.mark.parametrize("attributes", [{}, [], {"a": None}, {"a": 1}, {"a": " x"}, {"a": ""}, {"Bad key": "x"}])
+def test_source_attributes_reject_inexact_values(attributes):
+    meta = current_clip_tables()["meta.json"]
+    meta["source_attributes"] = attributes
+    with pytest.raises(DatasetContractError):
+        parse_clip_meta(meta, include_label_schema=True)
+
+
+def test_previous_vehicle_field_and_dataset_version_are_rejected():
+    meta = current_clip_tables()["meta.json"]
+    meta["vehicle_id"] = "V01"
+    with pytest.raises(DatasetContractError):
+        parse_clip_meta(meta, include_label_schema=True)
+    del meta["vehicle_id"]
+    meta["schema_version"] = "0.17"
+    with pytest.raises(DatasetContractError):
+        parse_clip_meta(meta, include_label_schema=True)

{x4d_devkit-0.43.0rc4 → x4d_devkit-0.45.0rc1}/tests/test_training_identity.py

@@ -38,7 +38,7 @@ def _clip(**overrides):
         "annotation_revision": "ann",
         "semantic_scene_revision": None,
         "label_schema": schema_identity(),
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
         "materialization_policy": "keyframes_only",
     }
     data.update(overrides)
@@ -133,7 +133,7 @@ def test_training_identity_file_rejects_duplicate_json_fields(tmp_path):
 
 
 def test_training_identity_rejects_non_current_clip_schema_version():
-    with pytest.raises(ValueError, match="clip_schema_version must be '0.17'"):
+    with pytest.raises(ValueError, match="clip_schema_version must be '0.18'"):
         build_training_identity_manifest(
             projects=_projects(),
             clips=[_clip(clip_schema_version="0.10")]
@@ -251,7 +251,7 @@ def test_project_training_identities_are_dataset_diff_ready(tmp_path):
         "annotation_revision": "ann",
         "semantic_scene_revision": None,
         "label_schema": schema_identity(),
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
     }]
 
 

x4d_devkit-0.45.0rc1/tests/test_vector_map.py

@@ -0,0 +1,119 @@
+import copy
+import pytest
+
+from tests.vector_map_fixtures import document, map_schema, map_schema_body
+from tests.test_vector_map_geometry import square
+from x4d_devkit.label_schema import parse_label_schema_body
+from x4d_devkit.vector_map import parse_vector_map, parse_vector_map_change
+
+
+def parse(value):
+    return parse_vector_map(value, map_schema(), clip_id="clip-a")
+
+
+def test_shared_boundaries_and_directed_neighbor_survive_canonical_roundtrip():
+    value = document()
+    parsed = parse(value)
+    assert parsed.to_dict() == value
+    assert parse(parsed).revision == parsed.revision
+    value["features"][0]["geometry"]["coordinates"][0][2] = 100
+    assert parsed.to_dict()["features"][0]["geometry"]["coordinates"][0][2] == 2
+
+
+@pytest.mark.parametrize(
+    "change",
+    [
+        "opposite",
+        "swapped",
+        "range",
+        "dangling",
+        "duplicate",
+        "foreign_clip",
+        "wrong_frame",
+        "schema",
+    ],
+)
+def test_invalid_native_references_geometry_or_identity_fail_closed(change):
+    value = document()
+    if change == "opposite":
+        value["lane_segments"][0]["right_boundary"]["reverse"] = True
+    elif change == "swapped":
+        lane = value["lane_segments"][0]
+        lane["left_boundary"], lane["right_boundary"] = (
+            lane["right_boundary"],
+            lane["left_boundary"],
+        )
+    elif change == "range":
+        value["lane_segments"][0]["left_boundary"]["end_s_m"] = 100
+    elif change == "dangling":
+        value["relations"][0]["to_token"] = "missing"
+    elif change == "duplicate":
+        value["relations"].append({**value["relations"][0], "token": "another"})
+    elif change == "foreign_clip":
+        value["clip_id"] = "other"
+    elif change == "wrong_frame":
+        value["frame_id"] = "world"
+    elif change == "schema":
+        value["provenance"]["label_schema_fingerprint"] = "sha256:" + "0" * 64
+    with pytest.raises(ValueError):
+        parse(value)
+
+
+def test_explicit_successor_cycle_is_legal_without_inferred_reciprocal_edges():
+    value = document()
+    value["relations"] = [
+        {
+            "token": "cycle",
+            "kind": "lane_successor",
+            "from_token": "lane-a",
+            "to_token": "lane-a",
+            "side": None,
+            "source_tokens": [],
+        }
+    ]
+    assert len(parse(value).to_dict()["relations"]) == 1
+
+
+def test_complete_zero_feature_coverage_is_preserved_and_same_category_overlap_rejected():
+    value = document()
+    value.update(features=[], lane_segments=[], relations=[])
+    region = {
+        "token": "inspected",
+        "geometry": square(),
+        "categories": [{"category_id": "area", "state": "complete"}],
+    }
+    value["coverage"] = [region]
+    assert parse(value).to_dict()["coverage"][0]["categories"][0]["state"] == "complete"
+    value["coverage"].append({**copy.deepcopy(region), "token": "duplicate-region"})
+    with pytest.raises(ValueError, match="overlaps"):
+        parse(value)
+    value["coverage"][1]["categories"][0]["category_id"] = "boundary"
+    parse(value)
+
+
+def test_schema_geometry_rules_are_mandatory_complete_and_do_not_supply_defaults():
+    body = map_schema_body()
+    del body["task_views"][0]["geometry_rules"]
+    with pytest.raises(ValueError):
+        parse_label_schema_body(body)
+    body = map_schema_body()
+    body["task_views"][0]["geometry_rules"][0]["geometry_types"] = ["polygon", "point"]
+    with pytest.raises(ValueError):
+        parse_label_schema_body(body)
+    value = document()
+    value["features"][0]["category_id"] = "area"
+    with pytest.raises(ValueError, match="does not permit"):
+        parse(value)
+
+
+def test_component_retain_replace_and_clear_are_distinct_and_explicit():
+    for operation in ("retain", "clear"):
+        value = {"operation": operation, "base_revision": None, "document": None}
+        assert parse_vector_map_change(value, map_schema(), clip_id="clip-a") == value
+    value = {"operation": "replace", "base_revision": None, "document": document()}
+    assert (
+        parse_vector_map_change(value, map_schema(), clip_id="clip-a")["document"]
+        == document()
+    )
+    with pytest.raises(ValueError):
+        parse_vector_map_change({"document": None}, map_schema(), clip_id="clip-a")