Skip to content

Interface protocol rev 2: two-level docs, hc CLI retired#14

Merged
T-K-233 merged 1 commit into
mainfrom
pixi-interface-rev2
Jul 6, 2026
Merged

Interface protocol rev 2: two-level docs, hc CLI retired#14
T-K-233 merged 1 commit into
mainfrom
pixi-interface-rev2

Conversation

@T-K-233

@T-K-233 T-K-233 commented Jul 6, 2026

Copy link
Copy Markdown
Member

Second-round docs PR for rev 2 of the pixi workspace interface protocol (rev 1 docs landed in #13). Rev 2 dissolves the packaged hc CLI tier: the package is deleted (Berkeley-Humanoids/humanoid_control#18), its verbs became workspace tasks or documented canonical commands, sim/real mean plant bring-up only everywhere, and deploy-sim/deploy-real are the reserved one-command bring-up+policy names (Lite-Deployment rename: Berkeley-Humanoids/Lite-Deployment#2).

  • how_to/use_pixi_tasks.md — rewritten around the two-level model; includes the copy-paste TOML reference block for consumer workspaces (the anti-drift copy source for the utility one-liners), the 25-task dev-ws menu, the one-qualifier grammar, the no-auto-build rule, and a retirement note for hc.
  • reference/cli_tools.md — now "Diagnostics and utility commands": old-verb → task → canonical-command mapping table; task-less tools (robstride_probe_report, mit_slider_gui, view_lite.launch.py, standalone viewers) shown in canonical form per the rarely-used rule.
  • Sweep of tutorials/how-tos/reference (drive_one_robstride, probe_can_bus, first_real_bringup, recover_from_fault, diagnose_enobufs, mit_slider_gui, quick_reference, hardware_specs, packages, installation, workspace_and_environment) from hc … to pixi run ping-bus/scan-bus/profile-bus/viz/calibrate or pixi run -- ros2 run …; humanoid_control_cli removed from package lists and install snippets.

13 files, +307/−151. No local build (no Node here) — relying on CI per repo convention. Protocol RFC (rev 2) is in the Berkeley-Humanoids/Skills#1 PR body.

🤖 Generated with Claude Code

Rewrite use_pixi_tasks around the two-level model (lifecycle core +
workspace tasks) with the copy-paste reference block as the anti-drift
source for utility one-liners; rework cli_tools into the diagnostics/
utility command reference with the hc->task mapping; sweep every page
from hc verbs to task names (ping-bus/scan-bus/profile-bus/viz/
calibrate) or canonical ros2 run/launch forms; drop the
humanoid_control_cli package from packages/installation.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@T-K-233 T-K-233 merged commit 4fc6dea into main Jul 6, 2026
2 checks passed
@T-K-233 T-K-233 deleted the pixi-interface-rev2 branch July 6, 2026 07:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant