Merge pull request #178 from unhappychoice/feature/history-tui-screen

feat: Add History screen and comprehensive development tooling

Author: unhappychoice

examples/README.md

@@ -0,0 +1,43 @@
+# Development Tools
+
+This directory contains development tools and utilities for GitType.
+
+## Seed Database
+
+Populate the database with sample data for development and testing.
+
+### Usage
+
+```bash
+# Generate default dataset (10 repos, 1000 sessions, 3000 stages)
+cargo run --example seed_database -- --clear
+
+# Generate custom dataset
+cargo run --example seed_database -- --clear --repos 5 --sessions 100 --stages 500
+
+# Small dataset for quick testing
+cargo run --example seed_database -- --clear --repos 2 --sessions 20 --stages 50
+```
+
+### Options
+
+- `--clear`: Clear existing data before seeding
+- `--repos <N>`: Number of repositories to generate (default: 10)
+- `--sessions <N>`: Number of sessions to generate (default: 1000)  
+- `--stages <N>`: Number of stages to generate (default: 3000)
+
+### Generated Data
+
+The tool generates realistic sample data including:
+
+- **Repositories**: Various programming languages and project types
+- **Sessions**: Mix of completed and incomplete typing sessions
+- **Challenges**: Real code snippets in multiple languages
+- **Stages**: Individual typing challenges with timing data
+- **Results**: Performance metrics, rankings, and statistics
+
+This data is useful for:
+- Testing UI components with realistic data volumes
+- Performance testing with large datasets
+- Developing analytics and reporting features
+- Manual testing of different user scenarios

examples/seed_database.rs

@@ -0,0 +1,82 @@
+use clap::Parser;
+use gittype::{
+    storage::{seeders::DatabaseSeeder, Database},
+    Result,
+};
+use std::sync::{Arc, Mutex};
+
+#[derive(Parser)]
+#[command(name = "seed_database")]
+#[command(about = "Populate database with seed data for development")]
+struct Args {
+    /// Clear existing data before seeding
+    #[arg(long)]
+    clear: bool,
+    /// Number of repositories to generate
+    #[arg(long, default_value = "10")]
+    repos: usize,
+    /// Number of sessions to generate  
+    #[arg(long, default_value = "1000")]
+    sessions: usize,
+    /// Number of stages to generate
+    #[arg(long, default_value = "3000")]
+    stages: usize,
+}
+
+fn main() -> Result<()> {
+    let args = Args::parse();
+
+    println!("🌱 Starting database seeding...");
+
+    let database = Arc::new(Mutex::new(Database::new()?));
+
+    // Initialize database tables if needed
+    {
+        let db = database.lock().unwrap();
+        db.init()?;
+    }
+
+    if args.clear {
+        println!("🧹 Clearing existing data...");
+        clear_database(&database)?;
+    }
+
+    println!(
+        "📊 Generating {} repositories, {} sessions, {} stages...",
+        args.repos, args.sessions, args.stages
+    );
+
+    let seeder = DatabaseSeeder::new(database);
+    seeder.seed_with_counts(args.repos, args.sessions, args.stages)?;
+
+    println!("✅ Seed data has been successfully loaded!");
+    println!("💡 You can now use the application with sample data for development and testing.");
+
+    Ok(())
+}
+
+fn clear_database(database: &Arc<Mutex<Database>>) -> Result<()> {
+    let db = database.lock().unwrap();
+    let conn = db.get_connection();
+
+    // Disable foreign key checks temporarily
+    conn.execute("PRAGMA foreign_keys = OFF", [])?;
+
+    let tables = vec![
+        "stage_results",
+        "session_results",
+        "stages",
+        "challenges",
+        "sessions",
+        "repositories",
+    ];
+
+    for table in tables {
+        conn.execute(&format!("DELETE FROM {}", table), [])?;
+    }
+
+    // Re-enable foreign key checks
+    conn.execute("PRAGMA foreign_keys = ON", [])?;
+
+    Ok(())
+}

src/cli/commands/game.rs

@@ -102,6 +102,9 @@ pub fn run_game_session(cli: Cli) -> Result<()> {
 }
 
 fn handle_game_error(e: GitTypeError) -> Result<()> {
+    // Log the error details for debugging before handling user-friendly output
+    crate::logging::log_error_to_file(&e);
+
     match e {
         GitTypeError::NoSupportedFiles => {
             eprintln!("❌ No code chunks found in the repository");

src/cli/runner.rs

@@ -1,7 +1,7 @@
 use crate::cli::args::{Cli, Commands};
 use crate::cli::commands::{run_export, run_game_session, run_history, run_stats};
 use crate::game::stage_manager::{cleanup_terminal, show_session_summary_on_interrupt};
-use crate::logging::{setup_console_logging, setup_logging};
+use crate::logging::{log_panic_to_file, setup_console_logging, setup_logging};
 use crate::Result;
 
 pub fn run_cli(cli: Cli) -> Result<()> {
@@ -27,6 +27,9 @@ pub fn setup_signal_handlers() {
     std::panic::set_hook(Box::new(|panic_info| {
         use std::io::{stderr, Write};
 
+        // Log panic information to file
+        log_panic_to_file(panic_info);
+
         // Ensure panic message is displayed before terminal cleanup
         let _ = writeln!(stderr(), "Error: {}", panic_info);
         let _ = stderr().flush();
@@ -35,6 +38,7 @@ pub fn setup_signal_handlers() {
 
         // Display panic info again after cleanup to ensure visibility
         eprintln!("Application encountered a panic: {}", panic_info);
+        eprintln!("💡 Panic details have been logged to the log file for debugging.");
     }));
 
     ctrlc::set_handler(move || {

src/game/screens/cancel_screen.rs

@@ -16,7 +16,7 @@ impl CancelScreen {
     pub fn show_session_summary_cancel_mode(
         total_stages: usize,
         completed_stages: usize,
-        stage_engines: &[(String, StageTracker)],
+        stage_trackers: &[(String, StageTracker)],
         _repo_info: &Option<GitRepository>,
     ) -> Result<ResultAction> {
         let mut stdout = stdout();
@@ -53,9 +53,9 @@ impl CancelScreen {
         execute!(stdout, Print(stage_text))?;
 
         // Show basic metrics if available (centered, white)
-        if !stage_engines.is_empty() {
-            let (_last_stage_name, last_engine) = stage_engines.last().unwrap();
-            let metrics = crate::scoring::StageCalculator::calculate(last_engine, false, false);
+        if !stage_trackers.is_empty() {
+            let (_last_stage_name, last_tracker) = stage_trackers.last().unwrap();
+            let metrics = crate::scoring::StageCalculator::calculate(last_tracker);
 
             let metrics_text = format!(
                 "CPM: {:.0} | WPM: {:.0} | Accuracy: {:.0}%",

src/game/screens/failure_screen.rs

@@ -16,7 +16,7 @@ impl FailureScreen {
     pub fn show_session_summary_fail_mode(
         total_stages: usize,
         completed_stages: usize,
-        stage_engines: &[(String, StageTracker)],
+        stage_trackers: &[(String, StageTracker)],
         _repo_info: &Option<GitRepository>,
     ) -> Result<ResultAction> {
         let mut stdout = stdout();
@@ -53,9 +53,12 @@ impl FailureScreen {
         execute!(stdout, Print(stage_text))?;
 
         // Show basic metrics if available (centered, white)
-        if !stage_engines.is_empty() {
-            let (_last_stage_name, last_engine) = stage_engines.last().unwrap();
-            let metrics = crate::scoring::StageCalculator::calculate(last_engine, false, true);
+        if !stage_trackers.is_empty() {
+            let (_last_stage_name, last_tracker) = stage_trackers.last().unwrap();
+            // Mark as failed first, then calculate
+            let mut tracker = last_tracker.clone();
+            tracker.record(crate::scoring::StageInput::Fail);
+            let metrics = crate::scoring::StageCalculator::calculate(&tracker);
 
             let metrics_text = format!(
                 "CPM: {:.0} | WPM: {:.0} | Accuracy: {:.0}%",