cli: make bundled help self-describing

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

@@ -31,6 +31,14 @@ func newSendCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "send",
 		Short: "Create a thread with an initial directed message",
+		Long: helpLong(
+			"Use send to create a new directed thread and first message.",
+			"This is the low-level thread creation primitive.",
+			"Leaders often create task threads through orch dispatch instead; use inbox send for manual repair, ad hoc coordination, or a thread that does not belong to an orch-managed task.",
+			"Creating a new thread requires a subject unless you are explicitly targeting an existing thread ID.",
+		),
+		Example: `  inbox --db .agents/coord.db send --from leader --to worker-a --subject "Investigate flaky test" --summary "Check latest failures" --run run_blog_001 --task T1
+  inbox --db .agents/coord.db send --from leader --to worker-a --subject "Review logs" --summary "See attached stacktrace" --body-file ./brief.md --artifact ./failure.log --artifact-kind log`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()