x4d-devkit 0.55.0rc1__tar.gz → 0.55.1__tar.gz

{x4d_devkit-0.55.0rc1/x4d_devkit.egg-info → x4d_devkit-0.55.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.55.0rc1
+Version: 0.55.1
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0

{x4d_devkit-0.55.0rc1 → x4d_devkit-0.55.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "x4d-devkit"
-version = "0.55.0rc1"
+version = "0.55.1"
 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.55.0rc1 → x4d_devkit-0.55.1}/tests/test_sdk_api.py

@@ -11,7 +11,7 @@ from x4d_devkit.eval.matching import MetricData
 
 
 def test_package_version_is_current_release():
-    assert x4d_devkit.__version__ == "0.55.0rc1"
+    assert x4d_devkit.__version__ == "0.55.1"
 
 
 def test_loader_exposes_and_enforces_only_current_schema(tmp_path):

{x4d_devkit-0.55.0rc1 → x4d_devkit-0.55.1}/tests/test_work_session.py

@@ -442,6 +442,22 @@ def test_work_session_materializes_optional_semantic_scene_as_an_independent_com
     loader = ClipLoader(tmp_path)
     assert loader.load_semantic_scene_component().manifest.semantic_scene_revision == source["semantic_scene_revision"]
 
+    # A later complete materialization of the same semantic-scene revision
+    # reuses the vouched component: no removal, transfer or re-validation.
+    semantic_urls = set(source["semantic_scene_asset_urls"].values())
+    before = len(client._http.urls)
+    again = materialize_work_session_clip(
+        source,
+        output_dir=tmp_path,
+        client=client,
+        workers=1,
+    )
+    assert again["errors"] == []
+    assert not semantic_urls & {url for _, url in client._http.urls[before:]}
+    assert ClipLoader(tmp_path).load_semantic_scene_component().manifest.semantic_scene_revision == (
+        source["semantic_scene_revision"]
+    )
+
 
 def test_keyframes_only_materialization_writes_self_contained_projection(
     tmp_path,
@@ -707,11 +723,12 @@ def test_invalid_native_projection_never_publishes_cache_identity(
 ):
     original = materialize_module._write_component_tables
 
-    def write_invalid_projection(clip_dir, tables, *, selected_components):
+    def write_invalid_projection(clip_dir, tables, *, selected_components, complete):
         original(
             clip_dir,
             tables,
             selected_components=selected_components,
+            complete=complete,
         )
         (clip_dir / "ego_pose.json").write_text("[]", encoding="utf-8")
 
@@ -740,6 +757,25 @@ def test_materialize_rejects_malformed_completed_cache_identity(tmp_path):
         materialize_work_session_clip(_manifest(), output_dir=tmp_path)
 
 
+def test_complete_materialization_replaces_older_contract_meta(tmp_path):
+    # An older cache keeps retired meta fields (Dataset 0.17 vehicle_id).
+    (tmp_path / "meta.json").write_text(
+        json.dumps({"clip_id": "stale", "schema_version": "0.17", "vehicle_id": "G150"})
+    )
+    result = materialize_work_session_clip(
+        _manifest(),
+        output_dir=tmp_path,
+        api_url="http://x4d.local",
+        client=_FakeX4DClient(),
+        workers=1,
+    )
+    assert result["errors"] == []
+    meta = json.loads((tmp_path / "meta.json").read_text())
+    assert "vehicle_id" not in meta
+    assert meta["schema_version"] != "0.17"
+    assert validate_clip(tmp_path).ok
+
+
 def test_materialize_rejects_legacy_root_occ(tmp_path):
     (tmp_path / "occ").mkdir()
 

{x4d_devkit-0.55.0rc1 → x4d_devkit-0.55.1}/x4d_devkit/materialize.py

@@ -428,6 +428,7 @@ def materialize_work_session_clip(
         clip_dir,
         tables,
         selected_components=selected_components,
+        complete=complete_request,
     )
 
     selected_sample_data = tables["sample_data.json"]
@@ -466,7 +467,17 @@ def materialize_work_session_clip(
                     errors=errors,
                 )
 
-    if "semantic_scene" in selected_components:
+    # The Semantic Scene is an independent content-addressed component with its
+    # own revision. When the completed cache already vouches for exactly the
+    # target revision, it is reused: no removal, transfer, or re-validation.
+    reuse_semantic_scene = (
+        "semantic_scene" in selected_components
+        and ws.semantic_scene_revision is not None
+        and previous_identity.get("semantic_scene_revision")
+        == ws.semantic_scene_revision
+        and (clip_dir / "semantic_scene" / "manifest.json").is_file()
+    )
+    if "semantic_scene" in selected_components and not reuse_semantic_scene:
         _remove_semantic_scene_component(clip_dir)
         if ws.semantic_scene_revision is not None:
             with _http_context(client=client, api_url=api_url, token=token) as http:
@@ -502,6 +513,7 @@ def materialize_work_session_clip(
         not errors
         and "semantic_scene" in selected_components
         and ws.semantic_scene_revision is not None
+        and not reuse_semantic_scene
     ):
         try:
             from x4d_devkit.validation.validator import load_semantic_scene_component
@@ -523,7 +535,10 @@ def materialize_work_session_clip(
     if not errors:
         from x4d_devkit.validation.validator import validate_clip
 
-        report = validate_clip(clip_dir)
+        report = validate_clip(
+            clip_dir,
+            validate_semantic_scene=not reuse_semantic_scene,
+        )
         if not report.ok:
             errors.append(
                 {
@@ -915,11 +930,17 @@ def _write_component_tables(
     tables: dict[str, Any],
     *,
     selected_components: frozenset[str],
+    complete: bool = False,
 ) -> None:
     target_meta = tables["meta.json"]
     source_components = {"samples", "sweeps"}
     meta_components = {*source_components, "label_schema", "business_metadata"}
-    if selected_components & meta_components:
+    if complete:
+        # A complete materialization owns every metadata field: write the
+        # target projection and never parse a previous (possibly older
+        # contract) meta.json, whose retired fields would fail validation.
+        _write_json(clip_dir / "meta.json", dict(target_meta))
+    elif selected_components & meta_components:
         meta_path = clip_dir / "meta.json"
         if meta_path.exists():
             current_meta = load_i_json(meta_path)

{x4d_devkit-0.55.0rc1 → x4d_devkit-0.55.1}/x4d_devkit/validation/validator.py

@@ -86,8 +86,15 @@ def _is_canonical_asset_path(value: Any) -> bool:
 
 def validate_clip(
     clip_dir: str | Path,
+    *,
+    validate_semantic_scene: bool = True,
 ) -> ValidationReport:
-    """Validate one self-contained native Dataset 0.18 Clip."""
+    """Validate one self-contained native Dataset 0.18 Clip.
+
+    ``validate_semantic_scene=False`` is only for a caller that already holds
+    proof that the present Semantic Scene component is the exact unchanged
+    revision it validated before (for example a reused cache component).
+    """
 
     root = Path(clip_dir)
     issues: list[ValidationIssue] = []
@@ -136,7 +143,7 @@ def validate_clip(
                 "native semantic_scene component path must be a directory",
                 str(semantic_scene_path),
             )
-        elif report.ok:
+        elif report.ok and validate_semantic_scene:
             try:
                 load_semantic_scene_component(root)
             except Exception as exc:

{x4d_devkit-0.55.0rc1 → x4d_devkit-0.55.1/x4d_devkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.55.0rc1
+Version: 0.55.1
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0