x4d-devkit 0.22.0rc1__tar.gz → 0.22.0rc2__tar.gz

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.22.0rc1
+Version: 0.22.0rc2
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0
@@ -66,7 +66,7 @@ Design decisions for this boundary are tracked in GitHub issues, starting with:
 ## Installation
 
 ```bash
-pip install x4d-devkit==0.22.0rc1
+pip install x4d-devkit==0.22.0rc2
 ```
 
 Devkit is released independently as an immutable wheel. X-4D, XPoints, and
@@ -473,6 +473,20 @@ converter = NuScenesConverter("/path/to/nuscenes")
 converter.convert_scene("scene-0001", output_dir="/path/to/output")
 ```
 
+## Development
+
+Development and verification run in the repository-owned Docker environment.
+A host Python installation is not part of the project workflow.
+
+```bash
+make verify
+```
+
+Use `make test`, `make lint`, `make docs`, `make package`, or `make shell` for
+individual tasks. Dependency changes are resolved and locked with `make lock`.
+See [the development environment guide](docs/development.md) for the ownership
+boundary and complete workflow.
+
 ## Modules
 
 | Module | Description |

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/README.md

@@ -23,7 +23,7 @@ Design decisions for this boundary are tracked in GitHub issues, starting with:
 ## Installation
 
 ```bash
-pip install x4d-devkit==0.22.0rc1
+pip install x4d-devkit==0.22.0rc2
 ```
 
 Devkit is released independently as an immutable wheel. X-4D, XPoints, and
@@ -430,6 +430,20 @@ converter = NuScenesConverter("/path/to/nuscenes")
 converter.convert_scene("scene-0001", output_dir="/path/to/output")
 ```
 
+## Development
+
+Development and verification run in the repository-owned Docker environment.
+A host Python installation is not part of the project workflow.
+
+```bash
+make verify
+```
+
+Use `make test`, `make lint`, `make docs`, `make package`, or `make shell` for
+individual tasks. Dependency changes are resolved and locked with `make lock`.
+See [the development environment guide](docs/development.md) for the ownership
+boundary and complete workflow.
+
 ## Modules
 
 | Module | Description |

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "x4d-devkit"
-version = "0.22.0rc1"
+version = "0.22.0rc2"
 description = "Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation"
 readme = "README.md"
 license = "Apache-2.0"
@@ -58,3 +58,6 @@ exclude = ["site*", "tests*", "docs*", "examples*"]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+
+[tool.uv]
+required-version = "==0.9.20"

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/tests/test_contract_validation.py

@@ -291,6 +291,36 @@ def test_final_sensor_coverage_requires_every_declared_channel():
     assert "incomplete_sensor_coverage" in _codes(report)
 
 
+def test_final_sensor_coverage_does_not_count_sweeps():
+    meta = _meta()
+    meta["sensors"]["cam_front"] = {"modality": "camera", "frame_id": "cam_front"}
+    sweep = _sample_data()
+    sweep.update(
+        sample_data_token="cam-sweep",
+        calibrated_sensor_token="cs-camera",
+        channel="cam_front",
+        file_path="sweeps/cam_front/1.jpg",
+        is_keyframe=False,
+        width=640,
+        height=480,
+    )
+
+    report = validate_clip_contract(_context(meta=meta, sample_data=[_sample_data(), sweep]))
+
+    assert "incomplete_sensor_coverage" in _codes(report)
+
+
+def test_annotation_must_reference_a_keyframe_sample():
+    context = _context()
+    context.samples[0]["is_keyframe"] = False
+    context.sample_data[0]["is_keyframe"] = False
+    context.sample_data[0]["file_path"] = "sweeps/lidar/1.bin"
+
+    report = validate_clip_contract(context)
+
+    assert "annotation_sample_not_keyframe" in _codes(report)
+
+
 def test_context_rejects_non_list_payloads_and_invalid_meta():
     with pytest.raises(TypeError):
         validate_annotation_payload(_context(), annotations=(), instances=[])

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/tests/test_sdk_api.py

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

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/tests/test_validation.py

@@ -223,3 +223,34 @@ def test_explicit_schema_context_must_match_meta_identity():
 
     assert not report.ok
     assert "label_schema_identity_mismatch" in _codes(report)
+
+
+def test_camera_frame_must_not_be_shared_with_point_cloud_sensor():
+    payload = current_clip_tables(include_camera=True, include_fused=True)
+    payload["meta.json"]["sensors"]["cam_front"]["frame_id"] = "base_link"
+    payload["calibrated_sensor.json"] = [
+        row
+        for row in payload["calibrated_sensor.json"]
+        if row["channel"] != "cam_front"
+    ]
+    for row in payload["sample_data.json"]:
+        if row["channel"] == "cam_front":
+            row["calibrated_sensor_token"] = "cs-root"
+
+    report = _validate_payload(payload)
+
+    assert not report.ok
+    assert "calibration_shape" in _codes(report)
+
+
+def test_camera_sample_dimensions_must_match_calibration_intrinsics():
+    payload = current_clip_tables(include_camera=True)
+    camera = next(
+        row for row in payload["sample_data.json"] if row["channel"] == "cam_front"
+    )
+    camera["width"] = 320
+
+    report = _validate_payload(payload)
+
+    assert not report.ok
+    assert "sample_data_shape" in _codes(report)

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/x4d_devkit/validation/contract.py

@@ -370,9 +370,15 @@ def validate_annotation_payload(
     _validate_context(context, builder)
 
     sample_tokens = {
-        _strict_token(row.get("sample_token"))
+        token
         for row in context.samples
-        if _strict_token(row.get("sample_token"))
+        if (token := _strict_token(row.get("sample_token"))) is not None
+    }
+    keyframe_sample_tokens = {
+        token
+        for row in context.samples
+        if row.get("is_keyframe") is True
+        if (token := _strict_token(row.get("sample_token"))) is not None
     }
     class_map = class_rule_map(context.label_schema)
 
@@ -428,6 +434,15 @@ def validate_annotation_payload(
                 related_token=sample_token,
                 details={"sample_token": sample_token},
             )
+        elif sample_token not in keyframe_sample_tokens:
+            builder.issue(
+                "annotation_sample_not_keyframe",
+                f"{path}.sample_token",
+                "annotation sample_token must identify a keyframe sample",
+                row=ann,
+                related_token=sample_token,
+                details={"sample_token": sample_token},
+            )
 
         if not instance_token:
             builder.issue(
@@ -1401,6 +1416,8 @@ def _validate_sensor_coverage(builder: _ReportBuilder, context: ClipValidationCo
 
     channels_by_sample: dict[str, set[str]] = {}
     for row in context.sample_data:
+        if row.get("is_keyframe") is not True:
+            continue
         sample_token = _strict_token(row.get("sample_token"))
         channel = _strict_token(row.get("channel"))
         if sample_token and channel:

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/x4d_devkit/validation/validator.py

@@ -401,7 +401,14 @@ def _validate_calibrated_sensors(
         intrinsics = row.get("intrinsics")
         distortion = row.get("distortion")
         frame_modality = _modality_for_frame(meta, channel)
-        if frame_modality == "camera":
+        if frame_modality == "ambiguous":
+            _append_error(
+                issues,
+                "calibration_shape",
+                "a camera frame must not be shared with a non-camera sensor",
+                f"{path}.channel",
+            )
+        elif frame_modality == "camera":
             _validate_camera_calibration(
                 intrinsics,
                 distortion,
@@ -612,6 +619,29 @@ def _validate_sample_data(
                         f"camera {field} must be a positive integer",
                         f"{path}.{field}",
                     )
+            calibration = calibrated_sensors.get(calibrated_token)
+            intrinsics = (
+                calibration.get("intrinsics")
+                if isinstance(calibration, dict)
+                else None
+            )
+            if isinstance(intrinsics, dict):
+                expected_dimensions = {
+                    "width": intrinsics.get("image_width"),
+                    "height": intrinsics.get("image_height"),
+                }
+                actual_dimensions = {"width": width, "height": height}
+                if actual_dimensions != expected_dimensions:
+                    _append_error(
+                        issues,
+                        "sample_data_shape",
+                        "camera dimensions must match resolved calibration intrinsics",
+                        path,
+                        {
+                            "expected": expected_dimensions,
+                            "actual": actual_dimensions,
+                        },
+                    )
         elif width is not None or height is not None:
             _append_error(
                 issues,

{x4d_devkit-0.22.0rc1 → x4d_devkit-0.22.0rc2}/x4d_devkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.22.0rc1
+Version: 0.22.0rc2
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0
@@ -66,7 +66,7 @@ Design decisions for this boundary are tracked in GitHub issues, starting with:
 ## Installation
 
 ```bash
-pip install x4d-devkit==0.22.0rc1
+pip install x4d-devkit==0.22.0rc2
 ```
 
 Devkit is released independently as an immutable wheel. X-4D, XPoints, and
@@ -473,6 +473,20 @@ converter = NuScenesConverter("/path/to/nuscenes")
 converter.convert_scene("scene-0001", output_dir="/path/to/output")
 ```
 
+## Development
+
+Development and verification run in the repository-owned Docker environment.
+A host Python installation is not part of the project workflow.
+
+```bash
+make verify
+```
+
+Use `make test`, `make lint`, `make docs`, `make package`, or `make shell` for
+individual tasks. Dependency changes are resolved and locked with `make lock`.
+See [the development environment guide](docs/development.md) for the ownership
+boundary and complete workflow.
+
 ## Modules
 
 | Module | Description |