feat(sessions): add Files and ByFile subcommands to terraphim-agent

Add SessionsSubcommand::Files { session_id, json } variant
Add SessionsSubcommand::ByFile { file_path, json } variant
Add command parsing for new subcommands with --json flag support
Add handler methods with table and JSON output
Export FileAccess and FileOperation from terraphim_sessions

Part of: #611

Author: AlexMikhalev

crates/terraphim_agent/src/repl/commands.rs

@@ -191,6 +191,10 @@ pub enum SessionsSubcommand {
     },
     /// Enrich sessions with concepts (Phase 3)
     Enrich { session_id: Option<String> },
+    /// List files accessed by a session
+    Files { session_id: String, json: bool },
+    /// Find sessions by file path
+    ByFile { file_path: String, json: bool },
 }
 
 #[derive(Debug, Clone, PartialEq)]
@@ -1320,8 +1324,28 @@ impl FromStr for ReplCommand {
                             subcommand: SessionsSubcommand::Enrich { session_id },
                         })
                     }
+                    "files" => {
+                        if parts.len() < 3 {
+                            return Err(anyhow!("Sessions files requires a session ID"));
+                        }
+                        let session_id = parts[2].to_string();
+                        let json = parts.iter().any(|&p| p == "--json");
+                        Ok(ReplCommand::Sessions {
+                            subcommand: SessionsSubcommand::Files { session_id, json },
+                        })
+                    }
+                    "by-file" => {
+                        if parts.len() < 3 {
+                            return Err(anyhow!("Sessions by-file requires a file path"));
+                        }
+                        let file_path = parts[2].to_string();
+                        let json = parts.iter().any(|&p| p == "--json");
+                        Ok(ReplCommand::Sessions {
+                            subcommand: SessionsSubcommand::ByFile { file_path, json },
+                        })
+                    }
                     _ => Err(anyhow!(
-                        "Unknown sessions subcommand: {}. Use: sources, import, list, search, stats, show, concepts, related, timeline, export, enrich",
+                        "Unknown sessions subcommand: {}. Use: sources, import, list, search, stats, show, concepts, related, timeline, export, enrich, files, by-file",
                         parts[1]
                     )),
                 }
@@ -1478,7 +1502,7 @@ impl ReplCommand {
 
             #[cfg(feature = "repl-sessions")]
             "sessions" => Some(
-                "/sessions <subcommand> - AI coding session history (sources, import, list, search, stats, show, concepts, related, timeline, export, enrich)",
+                "/sessions <subcommand> - AI coding session history (sources, import, list, search, stats, show, concepts, related, timeline, export, enrich, files, by-file)",
             ),
 
             _ => None,

crates/terraphim_agent/src/repl/handler.rs

@@ -1761,11 +1761,12 @@ impl ReplHandler {
     #[cfg(feature = "repl-sessions")]
     async fn handle_sessions(&mut self, subcommand: SessionsSubcommand) -> Result<()> {
         use colored::Colorize;
+        use comfy_table::Color;
         use comfy_table::modifiers::UTF8_ROUND_CORNERS;
         use comfy_table::presets::UTF8_FULL;
         use comfy_table::{Cell, Table};
         use terraphim_sessions::{
-            ConnectorStatus, ImportOptions, MessageRole, Session, SessionService,
+            ConnectorStatus, FileAccess, ImportOptions, MessageRole, Session, SessionService,
         };
 
         // Get or create session service
@@ -2358,6 +2359,109 @@ impl ReplHandler {
                     );
                 }
             }
+
+            SessionsSubcommand::Files { session_id, json } => {
+                if let Some(files) = svc.extract_files(&session_id).await {
+                    if files.is_empty() {
+                        println!(
+                            "{} No files found in session {}",
+                            "ℹ".blue(),
+                            session_id.cyan()
+                        );
+                    } else if json {
+                        match serde_json::to_string_pretty(&files) {
+                            Ok(output) => println!("{}", output),
+                            Err(e) => println!("{} Failed to serialize: {}", "✗".red().bold(), e),
+                        }
+                    } else {
+                        println!("\n{} Files in session {}:", "📁".bold(), session_id.cyan());
+                        println!();
+
+                        let mut table = Table::new();
+                        table
+                            .load_preset(UTF8_FULL)
+                            .apply_modifier(UTF8_ROUND_CORNERS)
+                            .set_header(vec![
+                                Cell::new("Path").add_attribute(comfy_table::Attribute::Bold),
+                                Cell::new("Operation").add_attribute(comfy_table::Attribute::Bold),
+                                Cell::new("Tool").add_attribute(comfy_table::Attribute::Bold),
+                            ]);
+
+                        for FileAccess {
+                            path,
+                            operation,
+                            tool_name,
+                            ..
+                        } in files
+                        {
+                            let op_cell = match operation {
+                                terraphim_sessions::FileOperation::Read => {
+                                    Cell::new("read").fg(Color::Green)
+                                }
+                                terraphim_sessions::FileOperation::Write => {
+                                    Cell::new("write").fg(Color::Yellow)
+                                }
+                            };
+                            table.add_row(vec![
+                                Cell::new(path),
+                                op_cell,
+                                Cell::new(tool_name).fg(Color::Cyan),
+                            ]);
+                        }
+                        println!("{}", table);
+                    }
+                } else {
+                    println!("{} Session '{}' not found", "⚠".yellow().bold(), session_id);
+                }
+            }
+
+            SessionsSubcommand::ByFile { file_path, json } => {
+                let sessions = svc.sessions_by_file(&file_path).await;
+                if sessions.is_empty() {
+                    println!(
+                        "{} No sessions found that touched '{}'",
+                        "ℹ".blue(),
+                        file_path.cyan()
+                    );
+                } else if json {
+                    match serde_json::to_string_pretty(&sessions) {
+                        Ok(output) => println!("{}", output),
+                        Err(e) => println!("{} Failed to serialize: {}", "✗".red().bold(), e),
+                    }
+                } else {
+                    println!(
+                        "\n{} Sessions that touched '{}':",
+                        "📂".bold(),
+                        file_path.cyan()
+                    );
+                    println!();
+
+                    let mut table = Table::new();
+                    table
+                        .load_preset(UTF8_FULL)
+                        .apply_modifier(UTF8_ROUND_CORNERS)
+                        .set_header(vec![
+                            Cell::new("ID").add_attribute(comfy_table::Attribute::Bold),
+                            Cell::new("Source").add_attribute(comfy_table::Attribute::Bold),
+                            Cell::new("Title").add_attribute(comfy_table::Attribute::Bold),
+                            Cell::new("Messages").add_attribute(comfy_table::Attribute::Bold),
+                        ]);
+
+                    for session in sessions {
+                        let title = session
+                            .title
+                            .clone()
+                            .unwrap_or_else(|| "(no title)".to_string());
+                        table.add_row(vec![
+                            Cell::new(&session.id).fg(Color::Cyan),
+                            Cell::new(&session.source).fg(Color::Magenta),
+                            Cell::new(title),
+                            Cell::new(session.message_count().to_string()),
+                        ]);
+                    }
+                    println!("{}", table);
+                }
+            }
         }
 
         Ok(())

crates/terraphim_sessions/src/lib.rs

@@ -39,7 +39,9 @@ pub mod enrichment;
 
 // Re-exports for convenience
 pub use connector::{ConnectorRegistry, ConnectorStatus, ImportOptions, SessionConnector};
-pub use model::{ContentBlock, Message, MessageRole, Session, SessionMetadata};
+pub use model::{
+    ContentBlock, FileAccess, FileOperation, Message, MessageRole, Session, SessionMetadata,
+};
 pub use service::SessionService;
 
 #[cfg(feature = "enrichment")]