cli: make bundled help self-describing

packages/orch-runtime/internal/cli/orch/wait.go

@@ -24,6 +24,12 @@ func newWaitCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "wait",
 		Short: "Block until matching run-scoped task events become available",
+		Long: helpLong(
+			"Use wait as the leader-side blocking primitive.",
+			"Instead of polling with manual sleep loops, wait blocks until later matching task events exist for the run, such as ready, blocked, done, or failed.",
+			"Use --after-event when resuming from a known cursor so you do not reprocess earlier events.",
+		),
+		Example: `  orch --db .agents/coord.db wait --run blog_mvp_001 --for task_blocked,task_done --after-event 0 --timeout-seconds 900`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()