Improve changelog rendering and clarify prompt commands (#3048)

- Sort changelog entries by change type alphabetically
- Display change types in colored brackets (e.g., [Added], [Fixed])
- Clarify prompt subcommands refer to local prompts

Author: kkashilk

crates/chat-cli/src/cli/chat/cli/prompts.rs

@@ -866,7 +866,7 @@ pub enum PromptsSubcommand {
         /// Optional arguments for the prompt
         arguments: Option<Vec<String>>,
     },
-    /// Create a new prompt
+    /// Create a new local prompt
     Create {
         /// Name of the prompt to create
         #[arg(short = 'n', long)]
@@ -878,15 +878,15 @@ pub enum PromptsSubcommand {
         #[arg(long)]
         global: bool,
     },
-    /// Edit an existing prompt
+    /// Edit an existing local prompt
     Edit {
         /// Name of the prompt to edit
         name: String,
         /// Edit global prompt instead of local
         #[arg(long)]
         global: bool,
     },
-    /// Remove an existing prompt
+    /// Remove an existing local prompt
     Remove {
         /// Name of the prompt to remove
         name: String,

crates/chat-cli/src/cli/feed.json

@@ -66,7 +66,7 @@
       "changes": [
         {
           "type": "added",
-          "description": "Add support for preToolUse and postToolUse hook -  [#2875](https://github.com/aws/amazon-q-developer-cli/pull/2875)"
+          "description": "Add support for preToolUse and postToolUse hook - [#2875](https://github.com/aws/amazon-q-developer-cli/pull/2875)"
         },
         {
           "type": "added",

crates/chat-cli/src/util/ui.rs

@@ -42,11 +42,21 @@ pub fn render_changelog_content(output: &mut impl Write) -> Result<()> {
             style::SetForegroundColor(Color::Reset),
         )?;
 
-        for change in &entry.changes {
-            // Process **bold** syntax and remove PR links
+        let mut sorted_changes = entry.changes.clone();
+        sorted_changes.sort_by(|a, b| a.change_type.cmp(&b.change_type));
+
+        for change in &sorted_changes {
             let cleaned_description = clean_pr_links(&change.description);
             let processed_description = process_bold_text(&cleaned_description);
-            execute!(output, style::Print("• "))?;
+            let capitalized_type = capitalize_first_word(&change.change_type);
+            execute!(output, style::Print("• ["))?;
+            execute!(
+                output,
+                style::SetForegroundColor(Color::Magenta),
+                style::Print(&capitalized_type),
+                style::SetForegroundColor(Color::Reset),
+            )?;
+            execute!(output, style::Print("] "))?;
             print_with_bold(output, &processed_description)?;
             execute!(output, style::Print("\n"))?;
         }
@@ -60,6 +70,19 @@ pub fn render_changelog_content(output: &mut impl Write) -> Result<()> {
     Ok(())
 }
 
+/// Capitalizes the first character of a string.
+fn capitalize_first_word(s: &str) -> String {
+    let mut chars = s.chars();
+    match chars.next() {
+        None => String::new(),
+        Some(first) => {
+            let mut result = first.to_uppercase().collect::<String>();
+            result.push_str(chars.as_str());
+            result
+        },
+    }
+}
+
 /// Removes PR links and numbers from changelog descriptions to improve readability.
 ///
 /// Removes text matching the pattern " - [#NUMBER](URL)" from the end of descriptions.