Fix version comparison, implement inline image display

- Version check now uses semver comparison (is_newer), not just
  inequality. Prevents "downgrade" prompts from stale cache.
- Inline images: when `images = true` in config, download keyframe
  or thumbnail and render using iTerm2 Inline Images Protocol.
  Falls back gracefully on unsupported terminals.
- Add base64 + reqwest blocking dependencies for image handling.
- Bump to 0.0.9.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: JessyTsui

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cerul"
-version = "0.0.8"
+version = "0.0.9"
 edition = "2021"
 description = "Official Cerul CLI - search video knowledge from your terminal"
 license = "MIT"
@@ -12,11 +12,12 @@ categories = ["command-line-utilities"]
 
 [dependencies]
 anyhow = "1"
+base64 = "0.22"
 clap = { version = "4", features = ["derive"] }
 colored = "3"
 dialoguer = { version = "0.11", features = ["fuzzy-select"] }
 flate2 = "1"
-reqwest = { version = "0.12", features = ["json", "rustls-tls", "socks"], default-features = false }
+reqwest = { version = "0.12", features = ["json", "rustls-tls", "socks", "blocking"], default-features = false }
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 tar = "0.4"

src/commands/upgrade.rs

@@ -81,7 +81,7 @@ pub async fn check_update_background() -> Option<String> {
             if modified.elapsed().unwrap_or_default().as_secs() < 86400 {
                 let cached = std::fs::read_to_string(&cache_path).ok()?;
                 let latest = cached.trim().to_string();
-                if !latest.is_empty() && latest != CURRENT_VERSION {
+                if !latest.is_empty() && is_newer(&latest, CURRENT_VERSION) {
                     return Some(latest);
                 }
                 return None;
@@ -97,7 +97,7 @@ pub async fn check_update_background() -> Option<String> {
         std::fs::write(dir.join("last_update_check"), &latest).ok();
     }
 
-    if latest != CURRENT_VERSION {
+    if is_newer(&latest, CURRENT_VERSION) {
         Some(latest)
     } else {
         None
@@ -202,6 +202,19 @@ fn extract_tar_entry(tar_data: &[u8], entry_name: &str) -> Result<Vec<u8>> {
     bail!("Binary '{entry_name}' not found in archive");
 }
 
+/// Compare semver strings: is `latest` strictly newer than `current`?
+fn is_newer(latest: &str, current: &str) -> bool {
+    let parse = |s: &str| -> (u64, u64, u64) {
+        let parts: Vec<u64> = s.split('.').filter_map(|p| p.parse().ok()).collect();
+        (
+            parts.first().copied().unwrap_or(0),
+            parts.get(1).copied().unwrap_or(0),
+            parts.get(2).copied().unwrap_or(0),
+        )
+    };
+    parse(latest) > parse(current)
+}
+
 fn cache_dir() -> Result<std::path::PathBuf> {
     let base = if cfg!(target_os = "macos") {
         env::var("HOME")

src/output.rs

@@ -1,10 +1,12 @@
+use std::io::IsTerminal;
+
 use anyhow::{Context, Result};
 use colored::Colorize;
 use serde::Serialize;
 
 use crate::types::{SearchResponse, UsageResponse};
 
-pub fn print_search_human(response: &SearchResponse, _show_images: bool) {
+pub fn print_search_human(response: &SearchResponse, show_images: bool) {
     let credit_note = if response.credits_used == 0 {
         "free daily search".green().to_string()
     } else {
@@ -49,6 +51,16 @@ pub fn print_search_human(response: &SearchResponse, _show_images: bool) {
         }
         eprintln!("  │  {}", meta.join("  ·  ").dimmed());
 
+        // Inline image (iTerm2 / Kitty protocol)
+        if show_images {
+            if let Some(url) = result.keyframe_url.as_deref().or(result.thumbnail_url.as_deref()) {
+                eprintln!("  │");
+                if let Some(img_data) = fetch_image_bytes(url) {
+                    print_inline_image(&img_data);
+                }
+            }
+        }
+
         // Transcript / snippet
         let text = result
             .transcript
@@ -211,6 +223,33 @@ fn osc8_link(url: &str, label: &str) -> String {
 }
 
 fn is_terminal_interactive() -> bool {
-    use std::io::IsTerminal;
     std::io::stderr().is_terminal()
 }
+
+/// Download image bytes. Returns None on any failure (non-blocking to UX).
+fn fetch_image_bytes(url: &str) -> Option<Vec<u8>> {
+    // Use a blocking reqwest call since we're already in an output function.
+    // Short timeout to avoid slowing down results.
+    let client = reqwest::blocking::Client::builder()
+        .timeout(std::time::Duration::from_secs(5))
+        .build()
+        .ok()?;
+    let resp = client.get(url).send().ok()?;
+    if !resp.status().is_success() {
+        return None;
+    }
+    resp.bytes().ok().map(|b| b.to_vec())
+}
+
+/// Print an inline image using the iTerm2 Inline Images Protocol.
+/// Falls back to nothing on unsupported terminals (the escape is simply ignored).
+fn print_inline_image(data: &[u8]) {
+    use base64::{engine::general_purpose::STANDARD, Engine};
+    let encoded = STANDARD.encode(data);
+    // iTerm2 protocol: \x1b]1337;File=inline=1;width=40;preserveAspectRatio=1:<base64>\x07
+    eprint!(
+        "  │  \x1b]1337;File=inline=1;width=40;preserveAspectRatio=1:{}\x07",
+        encoded
+    );
+    eprintln!();
+}