cli: make bundled help self-describing

packages/inbox-runtime/internal/cli/inbox/wait_reply.go

@@ -24,6 +24,15 @@ func newWaitReplyCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "wait-reply",
 		Short: "Block until a reply-like message appears in a thread",
+		Long: helpLong(
+			"Use wait-reply after a worker has marked a thread blocked and needs a leader response.",
+			"This is the worker-side blocking primitive; prefer it over ad hoc sleep loops.",
+			"Resume with --after-event or --after-message when you already know the last event or message you processed.",
+			"wait-reply watches one thread, unlike watch which can observe broader inbox activity.",
+		),
+		Example: `  inbox --db .agents/coord.db wait-reply --thread thr_123
+  inbox --db .agents/coord.db wait-reply --thread thr_123 --after-event 42 --timeout-seconds 900
+  inbox --db .agents/coord.db wait-reply --thread thr_123 --kinds answer,result`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()