cli: make bundled help self-describing

2026-03-22 23:37:38 +08:00
parent 5859ff219e
commit 4d8c90eb26
49 changed files with 792 additions and 29 deletions
@@ -19,6 +19,12 @@ func newBlockedCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "blocked",
 		Short: "List blocked tasks and their latest question",
+		Long: helpLong(
+			"Use blocked to list tasks whose active attempt is blocked together with the latest question the leader needs to answer.",
+			"Use blocked before answer when you want a compact queue of unresolved worker questions instead of the full run view from status.",
+		),
+		Example: `  orch --db .agents/coord.db blocked --run blog_mvp_001
+  orch --db .agents/coord.db --json blocked --run blog_mvp_001`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()