[wlgys8]

Summary

• move shared console panel lifecycle and sampling into a reusable motrix_rl.console package
• refactor FastSAC sync and async trainers to use the shared panel session and stats pipeline
• decouple panel rendering from TensorBoard/live logging and pass resolved collector devices directly
• document the architecture and update focused tests

Validation

• ruff check on changed console and FastSAC modules
• python -m compileall -q on changed Python modules

Closes #153

[Copilot]

🟡 Changes recommended

The collector test omits the required collector_device argument and fails with TypeError, while statistics handling misreports weight-publication rates and can permanently discard checkpoint notices.

3 open issues

• Pass the collector device to the spawned worker · New
• Deliver checkpoint notices when panel data is incomplete · New
• Preserve version baseline between logging boundaries · New

What changed in this PR

This PR extracts reusable console-panel utilities into motrix_rl and migrates FastSAC to shared lifecycle and sampling components, laying groundwork for other RL providers.

Changes:

• Adds shared panel sessions, resource sampling, and statistics helpers.
• Separates FastSAC async statistics aggregation, rendering, and logging; passes resolved collector devices directly.
• Updates focused tests and documents the console architecture.

File	Description
wiki/​design/​rl-console-panel.md	Documents shared console architecture and migration plans.
wiki/​design/​index.md	Links the console design document.
motrix_rl/​tests/​test_panel_data.py	Tests shared statistics helpers.
motrix_rl/​tests/​test_console.py	Updates imports and tests session lifecycle.
motrix_rl/​src/​motrix_rl/​console/​panel.py	Adds session-owned refresh and cleanup.
motrix_rl/​src/​motrix_rl/​console/​data.py	Adds aggregation and system-sampling utilities.
motrix_rl/​src/​motrix_rl/​console/​__init__.py	Exposes the shared console API.
motrix_rl_builtin/​tests/​test_fastsac_live_metrics.py	Adapts queue and rendering test hooks.
motrix_rl_builtin/​tests/​test_fastsac_collector.py	Tests explicit collector-device handoff.
motrix_rl_builtin/​tests/​test_builtin_sim_backend.py	Updates collector queue naming.
motrix_rl_builtin/​src/​motrix_rl_builtin/​fastsac/​sync/​train.py	Uses shared sessions and samplers.
motrix_rl_builtin/​src/​motrix_rl_builtin/​fastsac/​async_impl/​worker.py	Renames data queues and accepts resolved devices.
motrix_rl_builtin/​src/​motrix_rl_builtin/​fastsac/​async_impl/​train.py	Integrates separate statistics consumers.
motrix_rl_builtin/​src/​motrix_rl_builtin/​fastsac/​async_impl/​stats.py	Extracts aggregation, logging, and rendering components.
motrix_rl_builtin/​src/​motrix_rl_builtin/​fastsac/​async_impl/​collector.py	Uses the supplied device without re-resolution.

_{Review effort: Balanced}

[Copilot]

🟡 Changes recommended

The regression fixture relies on three 30-second timeouts due to incorrect expected log counts, and non-TTY output suppresses checkpoint-save notices after the first stats submission.

2 open issues

• Pass the collector device to the spawned worker
• Fix expected log counts for non-logging stages · New

2 resolved since last review

• Preserve version baseline between logging boundaries
• Deliver checkpoint notices when panel data is incomplete

_{Review effort: Balanced}