Reorder CLI commands for better discoverability

Grouped commands logically:
1. Project setup: init
2. Core CRUD: create, show, list, update, delete, search
3. Workflow shortcuts: start, done, archive, mv
4. Bulk operations: bulk
5. Memory & Assets: memory, asset
6. Views & Reports: tui, suggest, roadmap
7. Agent integration: prime, context
8. GraphQL API: query, mutate, serve
9. Maintenance: doctor, migrate, undo
10. Import/Export: import-beans, export-beans

Author: asaaki

src/cli/commands.rs

@@ -32,6 +32,9 @@ pub struct Cli {
 
 #[derive(Subcommand)]
 pub enum Commands {
+    // =========================================================================
+    // Project Setup
+    // =========================================================================
     /// Initialize a new peas project
     Init {
         /// Use a custom prefix for pea IDs
@@ -43,6 +46,9 @@ pub enum Commands {
         id_length: usize,
     },
 
+    // =========================================================================
+    // Core CRUD Operations
+    // =========================================================================
     /// Create a new pea
     #[command(visible_alias = "c", visible_alias = "new")]
     Create {
@@ -182,20 +188,6 @@ pub enum Commands {
         dry_run: bool,
     },
 
-    /// Archive a pea (move to archive folder)
-    Archive {
-        /// Pea ID
-        id: String,
-
-        /// Keep associated asset files instead of prompting to delete them
-        #[arg(long)]
-        keep_assets: bool,
-
-        /// Output as JSON
-        #[arg(long)]
-        json: bool,
-    },
-
     /// Delete a pea permanently
     Delete {
         /// Pea ID
@@ -224,6 +216,9 @@ pub enum Commands {
         json: bool,
     },
 
+    // =========================================================================
+    // Workflow Shortcuts
+    // =========================================================================
     /// Mark a pea as in-progress
     Start {
         /// Pea ID
@@ -244,38 +239,65 @@ pub enum Commands {
         json: bool,
     },
 
-    /// Execute a GraphQL query
-    Query {
-        /// GraphQL query string
-        query: String,
+    /// Archive a pea (move to archive folder)
+    Archive {
+        /// Pea ID
+        id: String,
 
-        /// Variables as JSON
+        /// Keep associated asset files instead of prompting to delete them
         #[arg(long)]
-        variables: Option<String>,
+        keep_assets: bool,
+
+        /// Output as JSON
+        #[arg(long)]
+        json: bool,
     },
 
-    /// Execute a GraphQL mutation (automatically wraps in 'mutation { }')
-    Mutate {
-        /// Mutation body (without 'mutation' keyword)
-        mutation: String,
+    /// Rename a ticket ID
+    ///
+    /// Example: `peas mv abc12 xyz99` renames peas-abc12 to peas-xyz99
+    #[command(name = "mv")]
+    Mv {
+        /// The old ID suffix (or full ID - prefix is stripped if present)
+        old_id: String,
 
-        /// Variables as JSON
+        /// The new ID suffix (or full ID - prefix is stripped if present)
+        new_id: String,
+
+        /// Force rename even if suffix length or mode doesn't match config
         #[arg(long)]
-        variables: Option<String>,
+        force: bool,
     },
 
-    /// Start GraphQL HTTP server
-    Serve {
-        /// Port to listen on
-        #[arg(short, long, default_value = "4000")]
-        port: u16,
+    // =========================================================================
+    // Bulk Operations
+    // =========================================================================
+    /// Bulk update multiple peas at once
+    Bulk {
+        #[command(subcommand)]
+        action: BulkAction,
     },
 
-    /// Output instructions for AI coding agents
-    Prime,
+    // =========================================================================
+    // Memory & Assets
+    // =========================================================================
+    /// Manage project memory and knowledge
+    Memory {
+        #[command(subcommand)]
+        action: MemoryAction,
+    },
 
-    /// Output project context for LLMs
-    Context,
+    /// Manage ticket assets (files, images, documents)
+    Asset {
+        #[command(subcommand)]
+        action: AssetAction,
+    },
+
+    // =========================================================================
+    // Views & Reports
+    // =========================================================================
+    /// Open the interactive TUI
+    Tui,
 
     /// Suggest the next ticket to work on
     Suggest {
@@ -290,18 +312,48 @@ pub enum Commands {
     /// Generate a Markdown roadmap from milestones and epics
     Roadmap,
 
-    /// Open the interactive TUI
-    Tui,
+    // =========================================================================
+    // Agent Integration
+    // =========================================================================
+    /// Output instructions for AI coding agents
+    Prime,
 
-    /// Migrate legacy config to new location (.peas/config.toml)
-    ///
-    /// Alias for `peas doctor --fix` focused on config migration.
-    Migrate {
-        /// Dry run - show what would be migrated without making changes
+    /// Output project context for LLMs
+    Context,
+
+    // =========================================================================
+    // GraphQL API
+    // =========================================================================
+    /// Execute a GraphQL query
+    Query {
+        /// GraphQL query string
+        query: String,
+
+        /// Variables as JSON
         #[arg(long)]
-        dry_run: bool,
+        variables: Option<String>,
+    },
+
+    /// Execute a GraphQL mutation (automatically wraps in 'mutation { }')
+    Mutate {
+        /// Mutation body (without 'mutation' keyword)
+        mutation: String,
+
+        /// Variables as JSON
+        #[arg(long)]
+        variables: Option<String>,
+    },
+
+    /// Start GraphQL HTTP server
+    Serve {
+        /// Port to listen on
+        #[arg(short, long, default_value = "4000")]
+        port: u16,
     },
 
+    // =========================================================================
+    // Maintenance & Recovery
+    // =========================================================================
     /// Check project health and suggest fixes
     ///
     /// With --fix, also performs config migration (same as `peas migrate`).
@@ -311,22 +363,25 @@ pub enum Commands {
         fix: bool,
     },
 
-    /// Rename a ticket ID
+    /// Migrate legacy config to new location (.peas/config.toml)
     ///
-    /// Example: `peas mv abc12 xyz99` renames peas-abc12 to peas-xyz99
-    #[command(name = "mv")]
-    Mv {
-        /// The old ID suffix (or full ID - prefix is stripped if present)
-        old_id: String,
-
-        /// The new ID suffix (or full ID - prefix is stripped if present)
-        new_id: String,
+    /// Alias for `peas doctor --fix` focused on config migration.
+    Migrate {
+        /// Dry run - show what would be migrated without making changes
+        #[arg(long)]
+        dry_run: bool,
+    },
 
-        /// Force rename even if suffix length or mode doesn't match config
+    /// Undo the last operation
+    Undo {
+        /// Output as JSON
         #[arg(long)]
-        force: bool,
+        json: bool,
     },
 
+    // =========================================================================
+    // Import & Export
+    // =========================================================================
     /// Import from a beans project
     #[command(name = "import-beans")]
     ImportBeans {
@@ -346,31 +401,6 @@ pub enum Commands {
         #[arg(default_value = ".beans-export")]
         output: String,
     },
-
-    /// Bulk update multiple peas at once
-    Bulk {
-        #[command(subcommand)]
-        action: BulkAction,
-    },
-
-    /// Manage project memory and knowledge
-    Memory {
-        #[command(subcommand)]
-        action: MemoryAction,
-    },
-
-    /// Manage ticket assets (files, images, documents)
-    Asset {
-        #[command(subcommand)]
-        action: AssetAction,
-    },
-
-    /// Undo the last operation
-    Undo {
-        /// Output as JSON
-        #[arg(long)]
-        json: bool,
-    },
 }
 
 #[derive(Subcommand)]