cli: make bundled help self-describing

This commit is contained in:
2026-03-22 23:37:38 +08:00
parent 5859ff219e
commit 4d8c90eb26
49 changed files with 792 additions and 29 deletions
+10
View File
@@ -110,6 +110,16 @@ The leader should block on `orch wait`, not on ad hoc `sleep`.
The binary name is `orch`.
Built-in help should be sufficient for first use:
- root help should explain the leader role and the normal run -> task -> dep -> ready -> dispatch -> wait/status loop
- command help should explain the scheduling contract, not just list flags
- `dispatch` help should explicitly explain `--execution-mode analysis|code` and which flags only apply to code mode
- high-frequency commands should include concrete examples that can be copied directly
- `status` help should explain that it is the main operational dashboard command
- `blocked` help should explain that it is the compact queue to inspect before `answer`
- `cleanup` help should explain how `--task`, `--attempt`, and `--all-completed` change cleanup scope
### Global Flags
- `--db PATH`