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 newReconcileCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "reconcile",
 		Short: "Reconcile inbox thread state back into orch task state",
+		Long: helpLong(
+			"Use reconcile to fold inbox thread state back into orch task and run state.",
+			"reconcile is the bridge from worker-side inbox activity to leader-side scheduler state.",
+			"Call reconcile before making new dispatch, retry, or status decisions when you need fresh state.",
+		),
+		Example: `  orch --db .agents/coord.db reconcile --run blog_mvp_001`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()