feat: add devtrail explore interactive TUI documentation viewer

cli/Cargo.toml

@@ -31,6 +31,13 @@ anyhow = "1"
 semver = "1"
 flate2 = "1"
 tar = "0.4"
+ratatui = { version = "0.29", optional = true, default-features = false, features = ["crossterm"] }
+crossterm = { version = "0.28", optional = true }
+pulldown-cmark = { version = "0.12", optional = true }
+
+[features]
+default = ["tui"]
+tui = ["ratatui", "crossterm", "pulldown-cmark"]
 
 [dev-dependencies]
 assert_cmd = "2"

cli/src/commands/explore.rs

@@ -0,0 +1,23 @@
+use anyhow::{bail, Result};
+use std::path::PathBuf;
+
+use crate::utils;
+
+pub fn run(path: &str) -> Result<()> {
+    let target = PathBuf::from(path)
+        .canonicalize()
+        .unwrap_or_else(|_| PathBuf::from(path));
+
+    let devtrail_dir = target.join(".devtrail");
+
+    if !devtrail_dir.exists() {
+        utils::warn(&format!(
+            "DevTrail is not initialized in {}",
+            target.display()
+        ));
+        utils::info("Run 'devtrail init' to initialize DevTrail in this directory.");
+        bail!("No DevTrail installation found");
+    }
+
+    crate::tui::run(&target)
+}

cli/src/commands/mod.rs

@@ -1,4 +1,6 @@
 pub mod about;
+#[cfg(feature = "tui")]
+pub mod explore;
 pub mod init;
 pub mod remove;
 pub mod status;

cli/src/main.rs

@@ -8,6 +8,8 @@ mod inject;
 mod manifest;
 mod platform;
 mod self_update;
+#[cfg(feature = "tui")]
+mod tui;
 mod utils;
 
 /// DevTrail CLI - Documentation Governance for AI-Assisted Development
@@ -47,6 +49,13 @@ enum Commands {
     },
     /// Show version, author, and license information
     About,
+    /// Explore DevTrail documentation interactively
+    #[cfg(feature = "tui")]
+    Explore {
+        /// Target directory (default: current directory)
+        #[arg(default_value = ".")]
+        path: String,
+    },
 }
 
 fn main() {
@@ -63,6 +72,8 @@ fn main() {
         Commands::Remove { full } => commands::remove::run(full),
         Commands::Status { path } => commands::status::run(&path),
         Commands::About => commands::about::run(),
+        #[cfg(feature = "tui")]
+        Commands::Explore { path } => commands::explore::run(&path),
     };
 
     if let Err(e) = result {