> ## Documentation Index
> Fetch the complete documentation index at: https://motorbridge.seeedstudio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MotorBridge 0.4.1 Release Test Note

Date: 2026-06-02

## Summary

MotorBridge 0.4.1 aligns the public ABI, Python binding, C++ binding, and
documentation API surface. It adds ABI metadata discovery, completes C++
RobStride wrapper parity with Python, and introduces `bindings/api_surface.json`
as the canonical API surface checklist.

## Version Alignment

| Component                      | Version  |
| ------------------------------ | -------- |
| Git release tag when published | `v0.4.1` |
| Rust workspace crates          | `0.4.1`  |
| Python package                 | `0.4.1`  |
| C++ package metadata           | `0.4.1`  |

## Key Changes

* Added C ABI metadata functions:
  * `motor_abi_version()`
  * `motor_abi_capabilities_json()`
* Added Python metadata helpers:
  * `motorbridge.abi_version()`
  * `motorbridge.abi_capabilities()`
* Added C++ metadata helpers:
  * `motorbridge::abi_version()`
  * `motorbridge::abi_capabilities_json()`
* Completed C++ RobStride wrapper parity for:
  * `robstride_ping_host_id`
  * `robstride_get_param_f32_host_id`
  * `robstride_get_fault_report`
  * `robstride_set_active_report`
* Added `bindings/api_surface.json` and API surface regression coverage.

## Required Checks

```bash theme={null}
cargo fmt --all -- --check
cargo check -p motor_abi
cargo build -p motor_abi
PYTHONPATH=bindings/python/src python3 -m compileall bindings/python/src/motorbridge
```

Python API surface and metadata smoke:

```bash theme={null}
PYTHONPATH=bindings/python/src python3 - <<'PY'
import motorbridge

assert motorbridge.get_version() == "0.4.1"
assert motorbridge.abi_version() == "0.4.1"
caps = motorbridge.abi_capabilities()
assert caps["abi"]["version"] == "0.4.1"
assert "dm-serial" in caps["transports"]
assert "robstride" in caps["vendors"]
print("abi metadata ok")
PY
```

## Expected Version Smoke

```text theme={null}
motor_cli 0.4.1
ws_gateway 0.4.1
motorbridge 0.4.1
motor_abi 0.4.1
```