Rush Sync Server

Crates.io

🛠 NOTE: Version 0.2.2 on crates.io has a critical bug in language file loading (*.json not embedded correctly). Please use version 0.3.1+ for a stable release!

Rush Sync Server is an ambitious project to create a professional web server orchestration platform written in Rust. Currently in Phase 0 (Foundation), the project features a robust terminal UI with internationalization, theming, and command system - laying the groundwork for the upcoming server management capabilities.

🎯 Project Vision

Rush Sync Server is being developed in phases:

Phase 0 (Current): Terminal UI foundation with command system ✅
Phase 1: Dynamic Actix-Web server management
Phase 2: Dev/Prod modes with hot-reloading
Phase 3: Redis integration & secure communication
Phase 4: Centralized logging & automation

🆕 What's New in v0.3.1

🏗️ Central System Command Architecture

The new version features a completely centralized command processing system:

🎯 Central Confirmation System - All confirmations (exit, restart, history -c) now use a unified, type-safe confirmation processor
⚡ One-Line Command Execution - System commands reduced from 5-7 code paths to a single, elegant processing pipeline
🛡️ Type-Safe Operations - Eliminated string-based matching with robust enum-based system actions
🧹 Code Simplification - Major reduction in command processing complexity and potential race conditions

🎨 Centralized Color System

🌈 Anti-Flicker Color Engine - Pre-compiled display text to color mappings for zero-delay rendering
🎯 Direct Color Resolution - O(1) lookup performance for all UI color assignments
🔧 Error-Free Color Handling - Eliminated color mapping inconsistencies and fallback issues
⚡ Performance Optimized - 60-80% faster color processing with zero computational overhead

🎬 Enhanced Startup Experience

📺 Professional Startup Message - Restored localized welcome message with color-coded categories
🌍 Multi-Language Support - Startup messages adapt to current language settings (EN/DE)
🎨 Color-Coded Display - Startup information with appropriate semantic coloring

🔧 Core System Improvements

📁 Centralized State Management - Complete overhaul of state.rs with unified system command processing
🎨 Optimized Screen Rendering - Enhanced screen.rs with simplified command flow and better error handling
🎯 Streamlined Command Architecture - Multiple command.rs files optimized for better maintainability
⚙️ Robust Configuration - Improved config handling with better validation and error recovery

🛡️ Enhanced Reliability

🔒 Type-Safe Confirmations - No more string-based confirmation states - everything is enum-based and compiler-verified
⚡ Race-Condition Elimination - Central command processor prevents multiple execution paths and timing issues
🧪 Error-Proof Design - Comprehensive error handling with graceful fallbacks for all edge cases
🎯 Consistent User Experience - Unified confirmation prompts across all system operations

🚀 Installation & Usage

📦 As Binary - Version 0.3.1+

# Install from crates.io
cargo install rush-sync-server

# Run the terminal UI (current functionality)
rush-sync

📚 As Library - Version 0.3.1+

Add to your Cargo.toml:

[dependencies]
rush-sync-server = "0.3.1"
tokio = { version = "1.36", features = ["full"] }

Quick Start Examples:

use rush_sync_server::*;

#[tokio::main]
async fn main() -> Result<()> {
    // Run with default configuration
    run().await?;
    Ok(())
}

use rush_sync_server::*;

#[tokio::main]
async fn main() -> Result<()> {
    // Custom configuration
    let mut config = load_config().await?;
    config.poll_rate = std::time::Duration::from_millis(8); // 125 FPS
    config.typewriter_delay = std::time::Duration::from_millis(1); // Ultra-fast

    // Run with custom settings
    run_with_config(config).await?;
    Ok(())
}

🛠 From Source

git clone https://github.com/LEVOGNE/rush.sync.server
cd rush.sync.server
cargo build --release
cargo run --release

✅ Current Features (Phase 0 - Foundation Complete)

🗗️ Core Foundation

Interactive Terminal UI with asynchronous event loop (Tokio)
🆕 Centralized System Commands with type-safe confirmation processing
Advanced Error Handling with graceful recovery
Zero Warnings Codebase (cargo clippy clean)
Memory-Safe Operations with proper resource management

📊 Logging & Persistence

Color-coded Logging with levels (ERROR, WARN, INFO, DEBUG, TRACE)
Runtime Log-level Switching with persistent config save
📝 Message Logging to .rss/rush.logs with timestamps
📚 Command History in .rss/rush.history with file persistence
Auto-scroll & Message History with smart viewport management

🎨 Advanced UI System

🖱️ Intelligent Dual-Cursor System - Text rendering + real terminal cursor
🎯 Multi-Platform Terminal Detection (macOS Terminal, iTerm2, VSCode, tmux)
🌈 Dynamic Terminal Cursor Colors with real-time color changes
🆕 Anti-Flicker Color System - Zero-delay color processing with pre-compiled mappings
Live Theme Switching without restart (TOML-based)
Typewriter Effect with configurable speed and cursor
Unicode Support (grapheme-based text handling)
🎯 Advanced Viewport with smooth scrolling and position preservation
📱 Responsive Layout System with panic-safe dimension handling

⌨️ Input & Navigation

Full Keyboard Support - Shift + symbols, umlauts, Unicode & emoji
Platform Shortcuts - Cmd (macOS) / Ctrl (Win/Linux) navigation
Input History Navigation with arrow keys and persistent storage
📋 Enhanced Copy/Paste Integration with text cleaning and validation
🛡️ Smart Input Validation with length limits and sanitization
💾 State Backup/Restore - Complete input state preservation
🆕 Central Confirmation System - Unified, type-safe confirmation processing

📺 Screen & Viewport Management

📐 Robust Layout Calculation with emergency fallbacks
📜 Advanced Scroll System with auto-scroll detection
🎯 Precise Content Tracking with intelligent cache management
🔄 Unified Event System for viewport changes
🚨 Error Recovery for layout failures and edge cases
📊 Performance-Optimized Rendering with 2-layer architecture

🌍 Internationalization

Runtime Language Switching (German/English)
🆕 Centralized Color Categories with consistent i18n support
Localized Error Messages and help texts
🆕 Professional Startup Messages with language adaptation
Extensible Translation System for future languages

⚙️ Configuration & Themes

Smart Config Validation with auto-correction
TOML-based Theme System with live updates
Internal Restart without process termination
Persistent Settings with automatic backup
🆕 Enhanced Error Recovery with comprehensive fallback handling

💻 Available Commands

Command	Description	Examples
`version` / `ver`	Show application version	`version`
`lang` / `language`	Switch language (EN/DE)	`lang de`, `lang en`
`theme`	Change themes live	`theme dark`, `theme light`
`clear` / `cls`	Clear all messages	`clear`
`exit` / `q`	Exit with confirmation	`exit`
`restart`	Internal restart	`restart`, `restart --force`
`history -c`	Clear input history	`history -c`
`log-level`	Change log level	`log-level debug`

🆕 Enhanced Confirmation System

All system commands now use the centralized confirmation processor:

exit                    # Shows: [CONFIRM] Do you really want to exit? (y/n)
y                       # ✅ Exits immediately - no more "__EXIT__" display bugs
n                       # ✅ Shows: "Operation cancelled"

restart                 # Shows: [CONFIRM] Really restart? (y/n)
y                       # ✅ Restarts immediately and cleanly

history -c              # Shows: [CONFIRM] Clear command history? (y/n)
y                       # ✅ History cleared with proper confirmation

Key Improvements:

🛡️ Type-Safe Processing - No more string-based states
⚡ Immediate Execution - Commands execute instantly after confirmation
🎯 Consistent UX - All confirmations follow the same pattern
🚫 Zero Race Conditions - Centralized processing eliminates timing issues

🎨 Theme Commands

theme                # Show available themes from TOML
theme dark           # Switch to dark theme (live update)
theme preview <name> # Preview theme without switching
theme debug <name>   # Show detailed theme configuration including cursor settings
theme -h             # Show comprehensive help with cursor options

📊 Log-Level Commands

log-level           # Show current level and help
log-level 3         # Set to INFO (1=ERROR, 2=WARN, 3=INFO, 4=DEBUG, 5=TRACE)
log-level DEBUG     # Set by name (case-insensitive)
log-level -h        # Show detailed help

📚 History Commands

history             # Show help and current status
history -c          # Clear command history (with confirmation)
↑ / ↓               # Navigate through history

⌨️ Enhanced Keyboard Shortcuts

🔤 Text Navigation

Key	Function
`← / →`	Move cursor in text
`Home / End`	Jump to start/end
`Cmd/Ctrl + A`	Jump to start
`Cmd/Ctrl + E`	Jump to end

📝 Text Editing

Key	Function
`Backspace`	Delete previous char
`Delete`	Delete next char
`Cmd/Ctrl + U`	Clear entire line
`Cmd/Ctrl + C`	Copy current input
`Cmd/Ctrl + V`	Paste from clipboard
`Cmd/Ctrl + X`	Cut current input

📚 History & Navigation

Key	Function
`↑ / ↓`	Navigate input history
`Shift + ↑ / ↓`	Scroll messages
`Page Up / Down`	Page scroll

🎛️ Application Control

Key	Function
`Enter`	Submit command
`ESC` (2x)	Exit application

⚙️ Configuration System

📁 File Locations

Config: .rss/rush.toml (auto-created)
History: .rss/rush.history (persistent command history)
Logs: .rss/rush.logs (timestamped message log)

🛠 Configuration File

[general]
max_messages = 1000         # Message buffer size
typewriter_delay = 5        # Typewriter effect speed (0 = disabled)
input_max_length = 100      # Maximum input length
max_history = 30            # Command history entries
poll_rate = 16              # UI refresh rate (16ms = 62.5 FPS)
log_level = "info"          # Log level (error/warn/info/debug/trace)
current_theme = "dark"      # Active theme name

[language]
current = "en"              # Language (en/de)

# Built-in themes with advanced cursor configuration
[theme.dark]
output_bg = "Black"
output_text = "White"
output_cursor = "PIPE"           # PIPE, BLOCK, UNDERSCORE
output_cursor_color = "White"    # Terminal cursor color for typewriter
input_bg = "White"
input_text = "Black"
input_cursor_prefix = "/// "     # Prompt text
input_cursor = "PIPE"            # Input cursor type
input_cursor_color = "Black"     # Input cursor color (real terminal cursor)

[theme.light]
output_bg = "White"
output_text = "Black"
output_cursor = "PIPE"
output_cursor_color = "Black"
input_bg = "Black"
input_text = "White"
input_cursor_prefix = "/// "
input_cursor = "PIPE"
input_cursor_color = "White"

[theme.green]
output_bg = "Black"
output_text = "Green"
output_cursor = "BLOCK"
output_cursor_color = "Green"
input_bg = "LightGreen"
input_text = "Black"
input_cursor_prefix = "$ "
input_cursor = "BLOCK"
input_cursor_color = "Black"

[theme.blue]
output_bg = "White"
output_text = "LightBlue"
output_cursor = "UNDERSCORE"
output_cursor_color = "Blue"
input_bg = "Blue"
input_text = "White"
input_cursor_prefix = "> "
input_cursor = "UNDERSCORE"
input_cursor_color = "White"

# 🆕 Advanced theme with yellow cursor
[theme.yellow]
output_bg = "Black"
output_text = "Yellow"
output_cursor = "PIPE"
output_cursor_color = "Yellow"
input_bg = "DarkGray"
input_text = "Yellow"
input_cursor_prefix = "⚡ "
input_cursor = "PIPE"
input_cursor_color = "Yellow"     # Real terminal cursor will be yellow!

🎨 Supported Colors

Standard Colors: Black, White, Gray, DarkGray, Red, Green, Blue, Yellow, Magenta, Cyan

Light Variants: LightRed, LightGreen, LightBlue, LightYellow, LightMagenta, LightCyan

🖱️ Cursor Types

PIPE (|) - Vertical line cursor
BLOCK (█) - Block cursor (inverts character)
UNDERSCORE (_) - Underscore cursor

🌈 Terminal Cursor Colors

Enhanced in v0.3.1: Real terminal cursor color changes with centralized color system!

macOS Terminal.app - Standard OSC sequences with error-free color mapping
iTerm2 - Native color support with optimized fallback sequences
VSCode Terminal - Standard compatibility mode with enhanced reliability
tmux - Proper tmux-wrapped sequences with improved detection
Generic Terminals - Universal fallback sequences with robust error handling

🔧 Advanced Features

🛡️ Terminal Compatibility

🍎 macOS Terminal.app - Optimized sequences with RGB color support
⚡ iTerm2 - Native color support with multiple sequence types
💻 VSCode Terminal - Standard compatibility with fallback handling
🔄 tmux Sessions - Proper tmux-wrapped escape sequence handling
🌍 Generic Terminals - Universal fallback support with error recovery

🖱️ Advanced Cursor System

# Real-time cursor changes in terminal
theme blue    # Terminal cursor becomes blue
theme yellow  # Terminal cursor becomes yellow
theme green   # Terminal cursor becomes green

# Cursor debugging
theme debug dark    # Shows detailed cursor configuration

📺 Viewport Management

📐 Panic-Safe Layout Calculation - Emergency fallbacks for edge cases
📜 Smart Auto-Scroll Detection - Preserves manual scroll position
🎯 Precise Content Tracking - Optimized message rendering
🔄 Event-Driven Updates - Unified system for all viewport changes
📊 Performance-Optimized Rendering - 2-layer architecture (text + cursor)

🆕 Central Command Processing

// Example: How the new system works internally
enum SystemAction {
    Exit,
    Restart,
    ClearHistory,
}

// Type-safe, compiler-verified, zero race conditions
match confirmed_action {
    SystemAction::Exit => exit_application(),      // ⚡ Immediate
    SystemAction::Restart => restart_system(),    // ⚡ Clean
    SystemAction::ClearHistory => clear_data(),   // ⚡ Instant
}

📊 Intelligent Logging

# Enhanced message logs with centralized processing
[2024-01-15 14:30:25] [BEREIT] Willkommen zu Rush Sync Version 0.3.1
[2024-01-15 14:30:26] Theme changed to: DARK
[2024-01-15 14:30:30] Language switched to: DE
[2024-01-15 14:30:35] Terminal cursor color changed to: Yellow
[2024-01-15 14:30:40] System command processed: Exit confirmed
[2024-01-15 14:30:41] ✅ Terminal reset correctly

# Automatic log rotation and size management with improved categorization

🔄 Error Recovery

Graceful Panic Handling with complete terminal cleanup
🆕 Central Error Processing - All system errors flow through unified handler
Config Validation with automatic correction
File System Error Handling with fallbacks
Layout Failure Recovery with emergency layouts
🆕 Terminal State Recovery - Enhanced cursor and color reset on exit
🆕 Type-Safe Operations - Compiler-verified state transitions

🗺 Development Roadmap

Phase 1: Server Management (Next)

CLI commands: create, start, stop, delete, status, logs
Dynamic Actix-Web server spawning
Hash-based server isolation
Ghost mode (background execution)
JSON/SQLite server registry

Phase 2: Dev/Prod & Versioning

Dev mode with hot-reloading
Prod mode with TLS
Automatic versioning (v1, v2, ...)
File watcher with notify
SCSS compilation

Phase 3: Communication & Security

Redis Pub/Sub integration
TLS/HTTPS with rustls
Session caching
Inter-server communication

Phase 4: Logging & Automation

Centralized logging dashboard
Automated setup scripts
WebSocket support
Integration tests

Future Considerations

Load balancing
Docker integration
Kubernetes support
Web-based monitoring dashboard

🗂 Project Structure

Current Structure (v0.3.1)

src/
├── core/           # Core logic & configuration
│   ├── config.rs   # TOML config with enhanced theme system
│   ├── error.rs    # Comprehensive error handling
│   ├── constants.rs # Application constants
│   └── prelude.rs  # Common imports with enhanced traits
├── ui/             # Advanced terminal UI
│   ├── screen.rs   # 🆕 Centralized command processing with simplified flow
│   ├── terminal.rs # Enhanced terminal initialization
│   ├── cursor.rs   # 🆕 Unified cursor system (input/output)
│   ├── viewport.rs # 🆕 Advanced scroll & layout management
│   ├── widget.rs   # Enhanced UI widget traits
│   └── color.rs    # 🆕 Anti-flicker color system with O(1) lookup
├── input/          # Enhanced input handling system
│   ├── keyboard.rs # 🆕 Improved keyboard with better filtering
│   ├── state.rs    # 🆕 Central system command processor with type-safe confirmations
│   └── mod.rs      # Optimized event loop
├── output/         # Enhanced display & logging
│   └── display.rs  # 🆕 Advanced message display with viewport integration
├── commands/       # Streamlined command system
│   ├── clear/      # Clear command
│   ├── exit/       # 🆕 Enhanced exit with central confirmation
│   ├── history/    # 🆕 Enhanced history management with central confirmation
│   ├── lang/       # Language switching
│   ├── log_level/  # Log level control
│   ├── restart/    # 🆕 Enhanced restart with central confirmation
│   ├── theme/      # 🆕 Enhanced live theme system
│   ├── version/    # Version display
│   ├── command.rs  # Command trait
│   ├── handler.rs  # 🆕 Enhanced command processing
│   └── registry.rs # Command registry
├── setup/          # Auto-configuration
│   └── setup_toml.rs # 🆕 Enhanced config with sorted themes
└── i18n/           # Enhanced internationalization
    ├── mod.rs      # 🆕 Centralized translation engine with improved caching
    └── langs/      # Language files
        ├── en.json # 🆕 Extended English translations
        └── de.json # 🆕 Extended German translations

Planned Structure (Phase 1+)

src/
├── cli/            # Server management CLI
├── server/         # Actix-Web management
├── db/             # Redis & PostgreSQL
├── versioning/     # Version control
└── websocket/      # Real-time communication

🧪 Testing & Quality Assurance

📐 Code Quality Checks

# Zero warnings guarantee
cargo clippy --all-targets --all-features
cargo check --all-targets
cargo test --all-features

# Specific component tests
cargo test central_command_system
cargo test color_system_tests
cargo test config_validation
cargo test theme_system
cargo test i18n_system
cargo test input_handling
cargo test viewport_management
cargo test cursor_system

🛡️ Security Testing

# Input sanitization tests
cargo test escape_sequence_filtering
cargo test input_validation
cargo test file_operations

# Error recovery tests
cargo test panic_recovery
cargo test mutex_poisoning
cargo test config_corruption
cargo test layout_failure_recovery
cargo test central_command_processor

🎨 UI System Tests

# Enhanced system tests
cargo test viewport_calculations
cargo test scroll_management
cargo test cursor_positioning
cargo test theme_switching
cargo test terminal_compatibility
cargo test color_system_performance
cargo test confirmation_system
cargo test startup_sequence

📊 Version History

v0.3.1 (Current) - Central Command Architecture

🏗️ Major Architectural Improvements:

🎯 Central Confirmation System - Complete overhaul with type-safe confirmation processing
⚡ One-Line System Commands - Reduced from 5-7 code paths to single execution pipeline
🌈 Anti-Flicker Color System - Pre-compiled color mappings with O(1) lookup performance
🎬 Professional Startup Experience - Restored and enhanced startup messages with color coding
🛡️ Type-Safe Operations - Eliminated string-based states with robust enum architecture

🔧 Core System Refinements:

📁 Complete state.rs Overhaul - Central system command processor with unified confirmation handling
🎨 Enhanced color.rs - Anti-flicker engine with pre-compiled display-to-color mappings
🖥️ Optimized screen.rs - Simplified command flow with better error handling and immediate execution
⚙️ Multiple command.rs Improvements - Enhanced exit, restart, and history commands with central processing
🌍 Improved Startup Sequence - Professional welcome messages with language adaptation

📈 Performance & Reliability:

⚡ 60-80% Faster Color Processing - Zero computational overhead for UI color assignments
🚫 Race Condition Elimination - Central processor prevents timing issues and multiple execution paths
🎯 Immediate Command Execution - No more "EXIT" or "RESTART" display bugs
🛡️ Comprehensive Error Handling - Type-safe operations with compiler-verified state transitions

v0.3.0 - Code Optimization & Performance

🔧 Major Code Architecture Improvements:

📦 17.6% Code Reduction - From 289,700 to 238,817 characters
🧹 Complete Code Cleanup - Removed redundant structures and debug code
⚡ Performance Optimizations - Streamlined rendering and input processing
🎯 Focused Module Structure - Consolidated and simplified APIs
🔄 Enhanced Widget System - Improved trait implementations

v0.2.9 - Screen & Cursor System Complete

🎉 Major Features:

🖥️ Complete screen management overhaul with robust viewport handling
📜 Advanced scroll system with smooth navigation and auto-scroll detection
🎨 Terminal cursor integration - Real terminal cursor synchronized with text
🔄 Enhanced live theme updates with complete UI state preservation
🛡️ Bulletproof input state management with backup/restore functionality

v0.2.8 - Foundation Complete