cli: make bundled help self-describing

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

@@ -26,6 +26,14 @@ func newUpdateCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "update",
 		Short: "Append a progress or blocked update to a thread",
+		Long: helpLong(
+			"Use update to append worker progress inside one claimed thread.",
+			"in_progress means real work has started.",
+			"blocked means the worker cannot continue without a precise answer or dependency.",
+			"Blocked updates should include a concise summary and usually a payload_json question so the leader can answer deterministically.",
+		),
+		Example: `  inbox --db .agents/coord.db update --agent worker-a --thread thr_123 --status in_progress --summary "Reading current auth flow"
+  inbox --db .agents/coord.db update --agent worker-a --thread thr_123 --status blocked --summary "Need logging decision" --payload-json '{"question":"Use stdout or stderr?"}'`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()