Extend simulation runtime coverage and kinematics support

scripts/generate_kinematics_motion_report.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""Generate deterministic evidence for TP -> IK -> motion integration."""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import subprocess
+from pathlib import Path
+
+INPUTS = {
+    "motion_header": "wasm-core/include/sim_motion_queue.h",
+    "motion_source": "wasm-core/src/sim_motion_queue.c",
+    "kinematics_motion_header": "wasm-core/include/sim_kinematics_motion.h",
+    "kinematics_motion_source": "wasm-core/src/sim_kinematics_motion.c",
+    "kinematics_header": "wasm-core/include/sim_kinematics.h",
+    "kinematics_source": "wasm-core/src/sim_kinematics.c",
+    "test": "wasm-core/tests/sim_kinematics_motion_test.c",
+    "linuxcnc_control": "linuxcnc/src/emc/motion/control.c",
+    "linuxcnc_motion": "linuxcnc/src/emc/motion/motion.c",
+}
+
+
+def sha256(path: Path) -> str:
+    return hashlib.sha256(path.read_bytes()).hexdigest()
+
+
+def run_json(command: list[str], root: Path) -> dict[str, object]:
+    result = subprocess.run(command, cwd=root, check=False, text=True, capture_output=True)
+    if result.returncode:
+        raise RuntimeError(f"{command[0]} exited {result.returncode}: {result.stderr.strip()}")
+    for line in result.stdout.splitlines():
+        if line.lstrip().startswith("{"):
+            item = json.loads(line)
+            if item.get("schema") == "kinematics-motion-samples.v1":
+                return item
+    raise RuntimeError("runner did not emit kinematics-motion-samples.v1")
+
+
+def generate(root: Path, output: Path) -> dict[str, object]:
+    root = root.resolve()
+    native = run_json([str(root / "build-native/sim_kinematics_motion_test")], root)
+    wasm = run_json(["node", str(root / "build-wasm/sim_kinematics_motion_wasm_test.js")], root)
+    report = {
+        "schema": "kinematics-motion-report.v1",
+        "status": "partial",
+        "implementation_status": "verified",
+        "source_records": {name: {"path": path, "sha256": sha256(root / path)} for name, path in INPUTS.items()},
+        "pipeline": {"order": ["fixed_tick", "trajectory_planner", "kinematics_inverse", "atomic_joint_queue"], "joint_queue_capacity": 64, "planner_queue_capacity": 32, "transaction": "snapshot planner and kinematics; rollback on IK, planner, nonfinite, or capacity failure"},
+        "configuration_candidates": [{"id": "trivkins-xyz-fixed-tick", "kind": "derived", "path": INPUTS["test"], "coordinates": "XYZ", "purpose": "deterministic TP to inverse to joint sample"}, {"id": "xyzbc-singular-rollback", "kind": "derived", "path": INPUTS["test"], "coordinates": "XYZBC", "purpose": "B=90 inverse failure leaves planner untouched"}],
+        "boundaries": {"pause": native["nominal"]["pause_status"], "capacity": native["capacity"]["status"], "inverse_failure": native["inverse_failure"]["status"], "inverse_error": native["inverse_failure"]["kinematics_error"], "nonfinite": native["nonfinite_status"], "capacity_planner_rollback": native["capacity"]["planner_before"] == native["capacity"]["planner_after"], "inverse_planner_rollback": native["inverse_failure"]["planner_before"] == native["inverse_failure"]["planner_after"], "state_hash_stable": native["nominal"]["state_hash"] == native["nominal"]["repeat_hash"]},
+        "samples": {"native": native, "wasm": wasm, "byte_identical_json": json.dumps(native, sort_keys=True, separators=(",", ":")) == json.dumps(wasm, sort_keys=True, separators=(",", ":")), "state_hash_identical": native["nominal"]["state_hash"] == wasm["nominal"]["state_hash"] and native["capacity"]["state_hash"] == wasm["capacity"]["state_hash"]},
+        "native_wasm": {"status": "passed", "native_command": "build-native/sim_kinematics_motion_test", "wasm_command": "node build-wasm/sim_kinematics_motion_wasm_test.js"},
+        "oracle": {"status": "blocked", "reason": "linuxcnc/unit_tests/kinematics is absent from the locked source", "blocked_samples": ["TP to IK fixed tick", "joint queue capacity", "pause/resume", "singular IK rollback", "nonfinite segment"]},
+    }
+    report["report_sha256"] = hashlib.sha256(json.dumps(report, sort_keys=True, separators=(",", ":")).encode()).hexdigest()
+    output.parent.mkdir(parents=True, exist_ok=True)
+    output.write_text(json.dumps(report, ensure_ascii=False, sort_keys=True, indent=2) + "\n", encoding="utf-8")
+    return report
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--repo-root", type=Path, default=Path(__file__).resolve().parents[1])
+    parser.add_argument("--output", type=Path, default=Path("coverage/kinematics-motion.report.json"))
+    args = parser.parse_args()
+    report = generate(args.repo_root, args.repo_root / args.output)
+    print(f"kinematics_motion={report['status']} native_wasm={report['native_wasm']['status']} oracle={report['oracle']['status']}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())