feat: add spectre tui subcommand for launching TUI dashboard v0.4.2

Wire the spectre-tui crate into the CLI binary as a first-class subcommand,
enabling users to launch the multi-panel TUI dashboard directly via
`spectre tui` (or alias `spectre ui`).

Implementation:
- New `crates/spectre-cli/src/commands/tui.rs` module with `TuiArgs` struct
  and `execute()` handler that loads config via `load_config()` and invokes
  `spectre_tui::run(&config)` to start the async event loop
- Added `spectre-tui` as path dependency of `spectre-cli` in Cargo.toml
- Registered `Tui` variant (with `ui` visible alias) in `Commands` enum
  in `commands/mod.rs` with dispatch routing in `execute()`
- CLI subcommand count: 12 -> 13, test count: 43 -> 44, file count: 17 -> 18

Documentation updates:
- README.md: Updated TUI launch syntax (`spectre --tui` -> `spectre tui`),
  interface modes diagram, project structure tree, subcommand/test/file counts,
  version badge and footer (0.4.1 -> 0.4.2)
- CHANGELOG.md: Added [0.4.2] entry with full technical details
- CLAUDE.md: Updated CLI file/test/subcommand counts, added tui to commands ref
- Cargo.toml: Workspace version 0.4.1 -> 0.4.2

All quality gates pass: 44 CLI tests, zero clippy warnings, cargo fmt clean.

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: doublegate

CHANGELOG.md

@@ -11,6 +11,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - GUI application with Tauri 2.0 — Phase 5
 - MCP server implementation — Phase 6
 
+## [0.4.2] - 2026-02-04
+
+### Added
+
+#### TUI Subcommand — CLI-to-TUI Integration
+
+- **`spectre tui` subcommand** (`crates/spectre-cli/src/commands/tui.rs`):
+  - New CLI entry point to launch the SPECTRE TUI dashboard directly from the CLI binary
+  - Loads SPECTRE configuration via standard `load_config()` pipeline (file discovery, env vars, CLI override)
+  - Invokes `spectre_tui::run()` to start the async event loop with terminal initialization
+  - Visible alias `ui` for convenience (`spectre ui`)
+  - Added `spectre-tui` as a dependency of `spectre-cli` for cross-crate integration
+
+### Changed
+- CLI subcommand count: 12 → 13 (added `tui`)
+- CLI test count: 43 → 44 (added `test_tui_args_default`)
+- CLI source file count: 17 → 18 (added `commands/tui.rs`)
+- `spectre-cli/Cargo.toml`: Added `spectre-tui` path dependency
+- `spectre-cli/src/commands/mod.rs`: Registered `Tui` variant in `Commands` enum with execution routing
+
+### Technical Details
+- 119 Rust source files across 5 crates
+- 865 tests total: 44 CLI + 538 core unit + 235 TUI + 3 doc-tests + 45 integration
+- Zero clippy warnings at all lint levels (standard, pedantic, nursery)
+- No new workspace dependencies — uses existing `spectre-tui` workspace member
+
 ## [0.4.1] - 2026-02-04
 
 ### Changed
@@ -590,7 +616,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-[Unreleased]: https://github.com/doublegate/SPECTRE/compare/v0.4.1...HEAD
+[Unreleased]: https://github.com/doublegate/SPECTRE/compare/v0.4.2...HEAD
+[0.4.2]: https://github.com/doublegate/SPECTRE/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/doublegate/SPECTRE/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/doublegate/SPECTRE/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/doublegate/SPECTRE/compare/v0.2.0...v0.3.0

CLAUDE.md

@@ -19,7 +19,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 **Phase 3:** Operation PHANTOM (v0.3.x) - TUI Dashboard **COMPLETE**
 **Phase 4:** Operation SPECTER (v0.4.x) - Advanced Features **COMPLETE**
 
-**SPECTRE Tests:** 864 (43 CLI + 538 core + 235 TUI + 3 doc-tests + 45 integration) | **Code:** ~31,000 lines Rust (118 files)
+**SPECTRE Tests:** 865 (44 CLI + 538 core + 235 TUI + 3 doc-tests + 45 integration) | **Code:** ~31,000 lines Rust (119 files)
 
 **Repository:** [github.com/doublegate/SPECTRE](https://github.com/doublegate/SPECTRE)
 
@@ -91,11 +91,11 @@ Target Network → ProRT-IP (Recon) → CyberChef (Analysis) → WRAITH (Exfil/C
 
 ```
 crates/
-├── spectre-cli/        # Unified CLI orchestrator (17 files, 43 tests)
+├── spectre-cli/        # Unified CLI orchestrator (18 files, 44 tests)
 │   └── src/
 │       ├── main.rs         # Entry point, CLI parsing with clap 4
-│       ├── commands/       # 12 subcommands: scan, chef, send, receive, identity, peer,
-│       │                   # status, config, completions, campaign, pipeline, plugin
+│       ├── commands/       # 13 subcommands: scan, chef, send, receive, identity, peer,
+│       │                   # status, config, completions, campaign, pipeline, plugin, tui
 │       └── output/         # table (comfy-table) and json (serde_json) formatters
 ├── spectre-core/       # Core orchestration library (81 files, 538 unit + 45 integration tests)
 │   ├── src/
@@ -280,6 +280,7 @@ spectre peer <subcommand>         # Trusted peer management
 spectre status                    # Component health checks
 spectre config <subcommand>       # Configuration management
 spectre completions <shell>       # Shell completion generation
+spectre tui                      # Launch TUI dashboard (alias: ui)
 
 # Orchestration commands (Phase 2)
 spectre campaign create <name>    # Create a new campaign

Cargo.lock

@@ -9,7 +9,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.4.1"
+version = "0.4.2"
 edition = "2021"
 rust-version = "1.88"
 authors = ["doublegate"]

Cargo.toml

@@ -13,7 +13,7 @@ A unified offensive security toolkit combining wire-speed secure communications,
   <a href="https://github.com/doublegate/SPECTRE"><img src="https://img.shields.io/github/stars/doublegate/SPECTRE?style=flat-square" alt="GitHub Stars"></a>
   <a href="https://github.com/doublegate/SPECTRE/fork"><img src="https://img.shields.io/github/forks/doublegate/SPECTRE?style=flat-square" alt="GitHub Forks"></a>
   <a href="https://github.com/doublegate/SPECTRE/actions/workflows/ci.yml"><img src="https://github.com/doublegate/SPECTRE/actions/workflows/ci.yml/badge.svg" alt="CI Status"></a>
-  <a href="https://github.com/doublegate/SPECTRE/releases"><img src="https://img.shields.io/badge/version-0.4.1-blue.svg" alt="Version"></a>
+  <a href="https://github.com/doublegate/SPECTRE/releases"><img src="https://img.shields.io/badge/version-0.4.2-blue.svg" alt="Version"></a>
   <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/rust-1.88%2B-orange.svg" alt="Rust"></a>
   <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-22%2B-green.svg" alt="Node.js"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT%2FGPLv3%2FApache--2.0-green.svg" alt="License"></a>
@@ -48,8 +48,8 @@ Modern offensive security requires seamless tool integration. SPECTRE eliminates
 
 | Metric                 | Value                                                                   |
 | ---------------------- | ----------------------------------------------------------------------- |
-| **Combined Tests**     | 6,941 (SPECTRE: 864 + WRAITH: 2,957 + ProRT-IP: 2,557 + CyberChef: 563) |
-| **SPECTRE Codebase**   | ~31,000 lines Rust (118 source files across 5 crates)                     |
+| **Combined Tests**     | 6,942 (SPECTRE: 865 + WRAITH: 2,957 + ProRT-IP: 2,557 + CyberChef: 563) |
+| **SPECTRE Codebase**   | ~31,000 lines Rust (119 source files across 5 crates)                     |
 | **Component Code**     | ~180,000 (Rust) + ~40,000 (TypeScript/JavaScript)                         |
 | **Languages**          | Rust 2024, TypeScript, JavaScript                                         |
 | **Network Throughput** | 10+ Gbps (WRAITH), 10M+ pps (ProRT-IP)                                   |
@@ -71,7 +71,7 @@ SPECTRE provides four distinct interaction methods to suit different operational
 │   ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────────┐   │
 │   │   CLI    │  │   TUI    │  │   GUI    │  │    MCP Server    │   │
 │   │ spectre  │  │ spectre  │  │ spectre  │  │ spectre-mcp      │   │
-│   │   cmd    │  │   --tui  │  │   --gui  │  │                  │   │
+│   │   cmd    │  │    tui   │  │   --gui  │  │                  │   │
 │   ├──────────┤  ├──────────┤  ├──────────┤  ├──────────────────┤   │
 │   │ Scripts  │  │ Real-    │  │ Visual   │  │ AI-Assisted      │   │
 │   │ Pipelines│  │ time     │  │ Campaign │  │ Natural Language │   │
@@ -125,8 +125,8 @@ spectre scan --output json 10.0.0.0/24 | \
 **Real-time operational dashboard leveraging ProRT-IP's 60 FPS TUI framework.**
 
 ```bash
-spectre --tui                    # Launch full TUI dashboard
-spectre scan --tui 192.168.1.0/24  # Scan with live visualization
+spectre tui                         # Launch full TUI dashboard (alias: spectre ui)
+spectre scan --tui 192.168.1.0/24   # Scan with live visualization
 ```
 
 **Dashboard Panels:**
@@ -313,7 +313,7 @@ SPECTRE follows a modular microservices architecture where each component operat
 
 | Layer                   | Purpose                                          | Technology                       | Status          |
 | ----------------------- | ------------------------------------------------ | -------------------------------- | --------------- |
-| **CLI Orchestrator**    | Unified command interface (12 subcommands)       | Rust (clap 4)                    | **Implemented** |
+| **CLI Orchestrator**    | Unified command interface (13 subcommands)       | Rust (clap 4)                    | **Implemented** |
 | **Core Library**        | Config, scanning, comms, analysis, orchestration | Rust (tokio, serde, tracing)     | **Implemented** |
 | **Target Management**   | Priority queue, scope enforcement, async DNS     | Rust (ipnetwork, tokio)          | **Implemented** |
 | **Job Orchestration**   | State machine, concurrency control, events       | Rust (tokio, broadcast channels) | **Implemented** |
@@ -468,7 +468,7 @@ spectre scan --capture pcap -p 443 10.0.0.0/24 | \
   spectre report --format json --output indicators.json
 
 # TUI mode for live analysis
-spectre --tui threat-hunt --interface eth0
+spectre tui
 ```
 
 ### Security Auditing
@@ -561,7 +561,7 @@ spectre chef "From_Base64" --input encoded.txt
 spectre send document.pdf --peer <peer-id> --encrypt
 
 # TUI: Launch dashboard
-spectre --tui
+spectre tui
 
 # GUI: Launch web interface
 spectre --gui
@@ -589,7 +589,7 @@ SPECTRE releases follow an operational codename convention:
 
 ### Phase 1: Foundation — Operation BLACKOUT (Complete)
 
-- [x] SPECTRE CLI skeleton with subcommand routing (9 commands, Nmap-compatible flags)
+- [x] SPECTRE CLI skeleton with subcommand routing (13 commands, Nmap-compatible flags)
 - [x] Component version detection and health checks (`spectre status`)
 - [x] Unified configuration management (TOML with file discovery and env var support)
 - [x] Structured logging with tracing (RUST_LOG, file output, JSON format)
@@ -666,11 +666,11 @@ SPECTRE/
 ├── .editorconfig           # Editor standards
 │
 ├── crates/
-│   ├── spectre-cli/        # Unified CLI orchestrator (17 files, 43 tests)
+│   ├── spectre-cli/        # Unified CLI orchestrator (18 files, 44 tests)
 │   │   ├── Cargo.toml
 │   │   └── src/
 │   │       ├── main.rs         # Entry point, CLI parsing
-│   │       ├── commands/       # 12 subcommand implementations
+│   │       ├── commands/       # 13 subcommand implementations
 │   │       │   ├── scan.rs         # Network scanning (ProRT-IP)
 │   │       │   ├── chef.rs         # Data analysis (CyberChef-MCP)
 │   │       │   ├── send.rs         # Secure send (WRAITH)
@@ -682,7 +682,8 @@ SPECTRE/
 │   │       │   ├── completions.rs  # Shell completion generation
 │   │       │   ├── campaign.rs     # Campaign management (7 subcommands)
 │   │       │   ├── pipeline.rs     # Data pipeline execution (3 subcommands)
-│   │       │   └── plugin.rs       # Plugin management (3 subcommands)
+│   │       │   ├── plugin.rs       # Plugin management (3 subcommands)
+│   │       │   └── tui.rs          # TUI dashboard launcher
 │   │       └── output/         # Output formatting
 │   │           ├── table.rs        # Table output (comfy-table)
 │   │           └── json.rs         # JSON output (serde_json)
@@ -924,6 +925,6 @@ SPECTRE builds on the shoulders of giants:
 
 **SPECTRE** — _Unified Offensive Security_
 
-**Version:** 0.4.1 | **License:** Multi-license | **Language:** Rust + TypeScript | **Status:** Active Development
+**Version:** 0.4.2 | **License:** Multi-license | **Language:** Rust + TypeScript | **Status:** Active Development
 
 **Last Updated:** 2026-02-04

README.md

@@ -19,6 +19,9 @@ path = "src/main.rs"
 # Core library
 spectre-core = { path = "../spectre-core" }
 
+# TUI dashboard
+spectre-tui = { path = "../spectre-tui" }
+
 # Async runtime
 tokio = { workspace = true }
 

crates/spectre-cli/Cargo.toml

@@ -20,6 +20,7 @@ pub mod receive;
 pub mod scan;
 pub mod send;
 pub mod status;
+pub mod tui;
 
 /// SPECTRE - Security Platform for Encrypted Comms, Testing, Enumeration, Recon
 ///
@@ -108,6 +109,10 @@ pub enum Commands {
     /// Plugin management (list, run, info)
     Plugin(plugin::PluginArgs),
 
+    /// Launch the TUI dashboard
+    #[command(visible_alias = "ui")]
+    Tui(tui::TuiArgs),
+
     /// Generate shell completions
     Completions(completions::CompletionsArgs),
 }
@@ -140,6 +145,7 @@ pub async fn execute(cli: Cli) -> Result<()> {
         Commands::Campaign(args) => campaign::execute(args, cli.config).await,
         Commands::Pipeline(args) => pipeline::execute(args, cli.config).await,
         Commands::Plugin(args) => plugin::execute(args, cli.config).await,
+        Commands::Tui(args) => tui::execute(args, cli.config).await,
         Commands::Completions(args) => completions::execute(args),
     }
 }

crates/spectre-cli/src/commands/mod.rs

@@ -0,0 +1,48 @@
+//! TUI dashboard command
+//!
+//! Launches the SPECTRE terminal user interface with real-time
+//! multi-panel dashboard for scan monitoring, data analysis,
+//! secure communications, and campaign management.
+
+use std::path::PathBuf;
+
+use anyhow::{Context, Result};
+use clap::Args;
+use tracing::{debug, info, instrument};
+
+/// Arguments for the tui command
+#[derive(Args, Debug)]
+#[command(
+    about = "Launch the TUI dashboard",
+    long_about = "Launch the SPECTRE terminal user interface.\n\n\
+                  Provides a real-time, multi-panel dashboard with:\n\
+                  • Recon panel - scan monitoring and results\n\
+                  • Analysis panel - CyberChef data transformation\n\
+                  • Comms panel - WRAITH secure communications\n\
+                  • Campaign panel - operation management\n\n\
+                  Keybindings: Tab/Shift-Tab to switch panels, F1 for help, q to quit."
+)]
+pub struct TuiArgs;
+
+/// Execute the tui command
+#[instrument(skip(config_path))]
+pub async fn execute(_args: TuiArgs, config_path: Option<PathBuf>) -> Result<()> {
+    info!("Launching SPECTRE TUI dashboard");
+    debug!(?config_path, "Configuration path");
+
+    let config = spectre_core::config::load_config(config_path.as_deref())
+        .context("Failed to load configuration")?;
+
+    spectre_tui::run(&config).await
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_tui_args_default() {
+        // TuiArgs has no fields, verify it can be constructed
+        let _args = TuiArgs;
+    }
+}