release: v1.0.0-beta — cross-platform parity is testable

Bump pyproject version 0.1.17 → 1.0.0b0 (PEP 440 form of v1.0.0-beta;
follows the v1.0.0-alpha lineage) and add CHANGELOG.md +
RELEASE_NOTES_NEXT.md covering the downstream content + parity work
landed since v1.0.0-alpha.

Highlights (full list in CHANGELOG.md):
- 60 RobotCfg validated × 4 checks; 9 real bugs xfail-documented
- mjlab 1:1 obs/reward: height_scan, rough terrain, IMU velocimeter
  (ω × r), tracking-g1 motion obs, lift_cube_yam ee_to_cube
- IL+RL fusion bridge end-to-end pipeline (roboverse_learn/fusion/)
- RoboTwin v2 passthrough — 50 native gym envs (1:1 by construction)
- get_started/0 handles missing cameras gracefully
- AGENTS.md/CLAUDE.md repo-level dev rules

Pairs with MetaSim v0.2.0. Backward-compatible.

Author: geng-haoran

CHANGELOG.md

@@ -0,0 +1,102 @@
+# Changelog
+
+All notable changes to RoboVerse are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+RoboVerse is the downstream content-pack + research layer on top of the
+[MetaSim](https://github.com/RoboVerseOrg/MetaSim) core. See
+`MetaSim/CHANGELOG.md` for the core-framework changes that ship with this
+release.
+
+## [Unreleased]
+
+Nothing yet — open a PR to add entries here.
+
+## [1.0.0-beta] - 2026-05-31
+
+The headline of this release is **cross-platform parity is now testable and
+load-bearing**. Every shipped `RobotCfg`, every contracted handler method,
+and every benchmark `reset(seed=N)` is exercised across the supported
+backends and either passes or is xfail-documented with a specific reason.
+
+The release is forward- and backward-compatible.
+
+### Added
+
+- **`tests/test_roboverse_robot_cfg_validation.py`** — validates every
+  `RobotCfg` shipped in `roboverse_pack`: instantiation, non-empty `name`,
+  default joint positions inside `joint_limits` ranges. 60 cfgs × 4 checks,
+  9 real downstream bugs surfaced and xfail-documented:
+  - `AlohaAgilex`, `G1Tracking` — orphan joints in `default_joint_positions`
+  - `YamCfg`, `ArxL5Cfg`, `Vega`, `SoArm100`, `Koch`, `Go2`, `AllegroHand` —
+    defaults outside `joint_limits` ranges
+- **IL + RL fusion bridge** (`roboverse_learn/fusion/`) — RL-trained policy
+  → demo collection (rollout → `save_demo` → `data2zarr` unchanged) +
+  IL-to-RL BC warmstart. End-to-end pipeline orchestrator
+  (`rl-train → collect → to-zarr → il-train`). 6/6 tests; validated against
+  a real cartpole checkpoint and real mujoco/EGL launch. Fails fast on
+  scene-MJCF tasks where robot is not a `RobotCfg`.
+- **mjlab 1:1 obs/reward parity** — extensive byte-level alignment work:
+  - `TerrainGridScanSensor` + `height_scan` obs wired into
+    `velocity_rough_go1` / `velocity_rough_g1` (1:1 building block).
+  - Continuous rough terrain wired into both velocity-rough quadruped
+    tasks.
+  - `tracking-g1` motion-tracking obs ports `motion_anchor` + `robot_body`
+    1:1.
+  - `lift_cube_yam` regains the missing `ee_to_cube` + `cube_to_goal` obs.
+  - `velocity_rough` height_scan is now correctly scaled by
+    `1 / max_distance` (matches mjlab); clip-then-scale order on the obs
+    term matches mjlab's `noise → clip → scale`.
+  - go1 / g1 `base_lin_vel` obs reads the IMU velocimeter at the offset
+    site (adds the `ω × r` cross-term — fixes a real obs gap that diverged
+    under turning).
+  - cross-sim cartpole eval pipeline repaired (actor build, device,
+    episode metric).
+- **RoboTwin v2 passthrough** — 50 RoboTwin tasks registered as native gym
+  envs (`RoboVerse/RoboTwin-<task>-v0`), 1:1 by construction, mirrors the
+  ManiSkill passthrough pattern.
+- **`AGENTS.md` / `CLAUDE.md`** — repo-level dev rules for AI agents
+  (double quote, line-length 120, py38 target, lazy imports OK,
+  parity-is-load-bearing, multi-repo discipline, commit-as-user).
+
+### Fixed
+
+- **`get_started/0_static_scene.py`** — gracefully skips the cameras-empty
+  case instead of crashing on first-time setup.
+- **mjlab tooling paths** — lint-clean across mjlab/maniskill tasks;
+  tooling paths made portable (no hardcoded `/home/ghr/...`).
+- **mjlab MJCF asset resolution** — assets pulled from
+  `RoboVerseOrg/roboverse_data` on Hugging Face instead of hardcoded local
+  paths (fresh checkout no longer breaks). Dual-mode locator
+  `_locator.mjlab_asset` = clone-or-HF.
+- **mjlab go1 Newton 1:1** — go1 RL now stands on Newton (PD actuators +
+  init pose + action order alignment).
+
+### Documentation
+
+- `ROADMAP.md` — P0/P1 cross-platform infra items marked fixed; P2/P3
+  items refreshed.
+- mjlab / maniskill / robotwin integration pages wired into the docs
+  toctree.
+
+### Tests
+
+- 60 RoboVerse `RobotCfg` configs validated × 4 checks = 240 statically
+  exercised; 9 real bugs xfail-documented.
+- Cross-4-backend sweep against MetaSim core in the `roboverse` conda env:
+  mujoco + sapien3 + newton + passthroughs — 323 passed, 0 regressions.
+
+### Migration
+
+No code changes are required for existing users.
+
+If you maintain an out-of-tree `RobotCfg`, the new validation test will
+exercise it as soon as it is imported through `roboverse_pack` — fix any
+flagged `default_joint_positions` mismatches before they trip in CI.
+
+---
+
+[Unreleased]: https://github.com/RoboVerseOrg/RoboVerse/compare/v1.0.0-beta...HEAD
+[1.0.0-beta]: https://github.com/RoboVerseOrg/RoboVerse/compare/v1.0.0-alpha...v1.0.0-beta

RELEASE_NOTES_NEXT.md

@@ -0,0 +1,68 @@
+# RoboVerse — next release (paste-ready notes)
+
+**Suggested tag**: `v1.0.0-beta` (follows the `v1.0.0-alpha` lineage; the
+"beta" gate is the cross-platform-parity work landing in this release).
+
+**Usage**: rename `[Unreleased]` → `[1.0.0-beta] - 2026-05-31` in
+`CHANGELOG.md`, then:
+
+```bash
+git tag -a v1.0.0-beta -m "RoboVerse v1.0.0-beta — cross-platform parity is testable"
+git push origin v1.0.0-beta
+gh release create v1.0.0-beta --prerelease \
+  --title "RoboVerse v1.0.0-beta — cross-platform parity is testable" \
+  --notes-file RELEASE_NOTES_NEXT.md
+```
+
+This release should be cut alongside **MetaSim v0.2.0** (see
+`MetaSim/RELEASE_NOTES_NEXT.md`).
+
+---
+
+## Cross-platform parity is now load-bearing
+
+Every shipped `RobotCfg`, every contracted handler method, and every
+benchmark `reset(seed=N)` is exercised across the supported backends and
+either passes or is xfail-documented with a specific reason. The release is
+forward- and backward-compatible.
+
+### Highlights
+
+- **60 `RobotCfg`s validated**. `tests/test_roboverse_robot_cfg_validation.py`
+  exercises every shipped robot for instantiation, non-empty name, and
+  defaults-inside-limits. 9 real downstream bugs surfaced:
+  - `AlohaAgilex`, `G1Tracking` — orphan joints in `default_joint_positions`
+  - `YamCfg`, `ArxL5Cfg`, `Vega`, `SoArm100`, `Koch`, `Go2`, `AllegroHand` —
+    defaults outside `joint_limits` ranges
+- **mjlab 1:1 obs/reward parity** got measurably tighter. `velocity_rough_go1`
+  / `velocity_rough_g1` now ship `height_scan` obs (scale `1/max_distance`,
+  clip-then-scale order matches mjlab), continuous rough terrain, and
+  `tracking-g1` motion-tracking obs. go1/g1 `base_lin_vel` reads the IMU
+  velocimeter at the offset site (adds `ω × r` cross-term — closes a real
+  obs gap that diverged under turning).
+- **IL + RL fusion bridge** (`roboverse_learn/fusion/`) wires RL training →
+  demo collection → IL warmstart end-to-end. 6/6 tests, validated against a
+  real cartpole checkpoint and real mujoco/EGL launch.
+- **RoboTwin v2 passthrough** — 50 native gym envs registered, 1:1 by
+  construction (same pattern as the existing ManiSkill passthrough).
+- **`get_started/0_static_scene.py`** no longer crashes on first-time setup
+  when no cameras are configured.
+- **AGENTS.md / CLAUDE.md** lands: repo-level dev rules for AI agents
+  (parity is load-bearing, multi-repo discipline, commit-as-user).
+
+### Migration
+
+No required changes. If you maintain an out-of-tree `RobotCfg`, the new
+validation test will exercise it as soon as it is imported through
+`roboverse_pack` — fix any flagged `default_joint_positions` mismatches
+before they trip in CI.
+
+### Verification
+
+**323 tests pass** in the cross-4-backend sweep
+(mujoco + sapien3 + newton + passthroughs) in the `roboverse` conda env,
+zero regressions.
+
+### Full changelog
+
+See [`CHANGELOG.md`](./CHANGELOG.md) for the complete commit-by-commit list.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "roboverse-py"
-version = "0.1.17"
+version = "1.0.0b0"
 description = "RoboVerse content, learning, and examples built on MetaSim"
 requires-python = ">=3.8"
 license = { file = "LICENSE" }