feat: add auto-announcement feature with /changelog command (#2833)

Author: abhraina-aws

crates/chat-cli/build.rs

@@ -83,6 +83,11 @@ fn write_plist() {
 fn main() {
     println!("cargo:rerun-if-changed=def.json");
 
+    // Download feed.json if FETCH_FEED environment variable is set
+    if std::env::var("FETCH_FEED").is_ok() {
+        download_feed_json();
+    }
+
     #[cfg(target_os = "macos")]
     write_plist();
 
@@ -322,3 +327,58 @@ fn main() {
     // write an empty file to the output directory
     std::fs::write(format!("{}/mod.rs", outdir), pp).unwrap();
 }
+
+/// Downloads the latest feed.json from the autocomplete repository.
+/// This ensures official builds have the most up-to-date changelog information.
+///
+/// # Errors
+///
+/// Prints cargo warnings if:
+/// - `curl` command is not available
+/// - Network request fails
+/// - File write operation fails
+fn download_feed_json() {
+    use std::process::Command;
+
+    println!("cargo:warning=Downloading latest feed.json from autocomplete repo...");
+
+    // Check if curl is available first
+    let curl_check = Command::new("curl").arg("--version").output();
+
+    if curl_check.is_err() {
+        panic!(
+            "curl command not found. Cannot download latest feed.json. Please install curl or build without FETCH_FEED=1 to use existing feed.json."
+        );
+    }
+
+    let output = Command::new("curl")
+        .args([
+            "-H",
+            "Accept: application/vnd.github.v3.raw",
+            "-s", // silent
+            "-f", // fail on HTTP errors
+            "https://api.github.com/repos/aws/amazon-q-developer-cli-autocomplete/contents/feed.json",
+        ])
+        .output();
+
+    match output {
+        Ok(result) if result.status.success() => {
+            if let Err(e) = std::fs::write("src/cli/feed.json", result.stdout) {
+                panic!("Failed to write feed.json: {}", e);
+            } else {
+                println!("cargo:warning=Successfully downloaded latest feed.json");
+            }
+        },
+        Ok(result) => {
+            let error_msg = if !result.stderr.is_empty() {
+                format!("HTTP error: {}", String::from_utf8_lossy(&result.stderr))
+            } else {
+                "HTTP error occurred".to_string()
+            };
+            panic!("Failed to download feed.json: {}", error_msg);
+        },
+        Err(e) => {
+            panic!("Failed to execute curl: {}", e);
+        },
+    }
+}

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

@@ -0,0 +1,23 @@
+use clap::Args;
+use eyre::Result;
+
+use crate::cli::chat::{
+    ChatError,
+    ChatSession,
+    ChatState,
+};
+use crate::util::ui;
+
+#[derive(Debug, PartialEq, Args)]
+pub struct ChangelogArgs {}
+
+impl ChangelogArgs {
+    pub async fn execute(self, session: &mut ChatSession) -> Result<ChatState, ChatError> {
+        // Use the shared rendering function from util::ui
+        ui::render_changelog_content(&mut session.stderr).map_err(|e| ChatError::Std(std::io::Error::other(e)))?;
+
+        Ok(ChatState::PromptUser {
+            skip_printing_tools: true,
+        })
+    }
+}

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

@@ -1,3 +1,4 @@
+pub mod changelog;
 pub mod clear;
 pub mod compact;
 pub mod context;
@@ -16,6 +17,7 @@ pub mod todos;
 pub mod tools;
 pub mod usage;
 
+use changelog::ChangelogArgs;
 use clap::Parser;
 use clear::ClearArgs;
 use compact::CompactArgs;
@@ -75,6 +77,9 @@ pub enum SlashCommand {
     Tools(ToolsArgs),
     /// Create a new Github issue or make a feature request
     Issue(issue::IssueArgs),
+    /// View changelog for Amazon Q CLI
+    #[command(name = "changelog")]
+    Changelog(ChangelogArgs),
     /// View and retrieve prompts
     Prompts(PromptsArgs),
     /// View context hooks
@@ -145,6 +150,7 @@ impl SlashCommand {
                     skip_printing_tools: true,
                 })
             },
+            Self::Changelog(args) => args.execute(session).await,
             Self::Prompts(args) => args.execute(session).await,
             Self::Hooks(args) => args.execute(session).await,
             Self::Usage(args) => args.execute(os, session).await,
@@ -179,6 +185,7 @@ impl SlashCommand {
             Self::Compact(_) => "compact",
             Self::Tools(_) => "tools",
             Self::Issue(_) => "issue",
+            Self::Changelog(_) => "changelog",
             Self::Prompts(_) => "prompts",
             Self::Hooks(_) => "hooks",
             Self::Usage(_) => "usage",

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

@@ -167,6 +167,7 @@ use crate::telemetry::{
 use crate::util::{
     MCP_SERVER_TOOL_DELIMITER,
     directories,
+    ui,
 };
 
 const LIMIT_REACHED_TEXT: &str = color_print::cstr! { "You've used all your free requests for this month. You have two options:
@@ -449,8 +450,11 @@ const WELCOME_TEXT: &str = color_print::cstr! {"<cyan!>
 const SMALL_SCREEN_WELCOME_TEXT: &str = color_print::cstr! {"<em>Welcome to <cyan!>Amazon Q</cyan!>!</em>"};
 const RESUME_TEXT: &str = color_print::cstr! {"<em>Picking up where we left off...</em>"};
 
+// Maximum number of times to show the changelog announcement per version
+const CHANGELOG_MAX_SHOW_COUNT: i64 = 2;
+
 // Only show the model-related tip for now to make users aware of this feature.
-const ROTATING_TIPS: [&str; 18] = [
+const ROTATING_TIPS: [&str; 19] = [
     color_print::cstr! {"You can resume the last conversation from your current directory by launching with
     <green!>q chat --resume</green!>"},
     color_print::cstr! {"Get notified whenever Q CLI finishes responding.
@@ -484,6 +488,7 @@ const ROTATING_TIPS: [&str; 18] = [
     color_print::cstr! {"Run <green!>/prompts</green!> to learn how to build & run repeatable workflows"},
     color_print::cstr! {"Use <green!>/tangent</green!> or <green!>ctrl + t</green!> (customizable) to start isolated conversations ( ↯ ) that don't affect your main chat history"},
     color_print::cstr! {"Ask me directly about my capabilities! Try questions like <green!>\"What can you do?\"</green!> or <green!>\"Can you save conversations?\"</green!>"},
+    color_print::cstr! {"Stay up to date with the latest features and improvements! Use <green!>/changelog</green!> to see what's new in Amazon Q CLI"},
 ];
 
 const GREETING_BREAK_POINT: usize = 80;
@@ -1109,6 +1114,34 @@ impl ChatSession {
 
         Ok(())
     }
+
+    async fn show_changelog_announcement(&mut self, os: &mut Os) -> Result<()> {
+        let current_version = env!("CARGO_PKG_VERSION");
+        let last_version = os.database.get_changelog_last_version()?;
+        let show_count = os.database.get_changelog_show_count()?.unwrap_or(0);
+
+        // Check if version changed or if we haven't shown it max times yet
+        let should_show = match &last_version {
+            Some(last) if last == current_version => show_count < CHANGELOG_MAX_SHOW_COUNT,
+            _ => true, // New version or no previous version
+        };
+
+        if should_show {
+            // Use the shared rendering function
+            ui::render_changelog_content(&mut self.stderr)?;
+
+            // Update the database entries
+            os.database.set_changelog_last_version(current_version)?;
+            let new_count = if last_version.as_deref() == Some(current_version) {
+                show_count + 1
+            } else {
+                1
+            };
+            os.database.set_changelog_show_count(new_count)?;
+        }
+
+        Ok(())
+    }
 }
 
 impl Drop for ChatSession {
@@ -1255,6 +1288,9 @@ impl ChatSession {
             execute!(self.stderr, style::Print("\n"), style::SetForegroundColor(Color::Reset))?;
         }
 
+        // Check if we should show the whats-new announcement
+        self.show_changelog_announcement(os).await?;
+
         if self.all_tools_trusted() {
             queue!(
                 self.stderr,

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

@@ -92,6 +92,7 @@ pub const COMMANDS: &[&str] = &[
     "/compact",
     "/compact help",
     "/usage",
+    "/changelog",
     "/save",
     "/load",
     "/subscribe",

crates/chat-cli/src/cli/chat/tools/introspect.rs

@@ -71,6 +71,17 @@ impl Introspect {
         documentation.push_str("\n\n--- docs/todo-lists.md ---\n");
         documentation.push_str(include_str!("../../../../../../docs/todo-lists.md"));
 
+        documentation.push_str("\n\n--- changelog (from feed.json) ---\n");
+        // Include recent changelog entries from feed.json
+        let feed = crate::cli::feed::Feed::load();
+        let recent_entries = feed.get_all_changelogs().into_iter().take(5).collect::<Vec<_>>();
+        for entry in recent_entries {
+            documentation.push_str(&format!("\n## {} ({})\n", entry.version, entry.date));
+            for change in &entry.changes {
+                documentation.push_str(&format!("- {}: {}\n", change.change_type, change.description));
+            }
+        }
+
         documentation.push_str("\n\n--- CONTRIBUTING.md ---\n");
         documentation.push_str(include_str!("../../../../../../CONTRIBUTING.md"));