diff --git a/bin/rycode b/bin/rycode
index fe658040..de0eaca9 100755
Binary files a/bin/rycode and b/bin/rycode differ
diff --git a/packages/tui/A_PLUS_IMPROVEMENTS.md b/packages/tui/A_PLUS_IMPROVEMENTS.md
deleted file mode 100644
index 21f93ca8..00000000
--- a/packages/tui/A_PLUS_IMPROVEMENTS.md
+++ /dev/null
@@ -1,572 +0,0 @@
-# A+ Improvements to Dynamic Theming System
-
-**Elevating from A- to A+ with visual examples, telemetry, and proactive tooling**
-
----
-
-## Overview
-
-Based on the `/reflect` analysis, I identified three key areas for improvement:
-1. **Visual Examples** - Show, don't just tell
-2. **Telemetry** - Understand real usage patterns
-3. **Proactive Tooling** - Make visual testing easy
-
-This document details the improvements made to achieve A+ quality.
-
----
-
-## What Was Added
-
-### 1. Visual Examples System ✨
-
-**Problem Identified**:
-> "The documentation is comprehensive but text-heavy. Adding screenshots, GIF animations, and side-by-side comparisons would make concepts instantly clear."
-
-**Solution**:
-
-#### VISUAL_EXAMPLES.md (600+ lines)
-Comprehensive visual documentation including:
-- ASCII art examples of each theme
-- Color palette comparisons
-- Component visualizations
-- Animated examples descriptions
-- Screenshot guidelines
-- Contribution guide
-
-**Impact**:
-- Users can **see** themes before using them
-- Visual learning for those who prefer it
-- Clear expectations of what each theme looks like
-- Professional presentation
-
-#### generate_theme_visuals.sh
-Automated VHS script generator that creates:
-- 4 theme GIFs (one per provider)
-- 4 theme PNGs (static screenshots)
-- 1 comparison GIF (all themes side-by-side)
-
-**Usage**:
-```bash
-cd packages/tui
-./scripts/generate_theme_visuals.sh
-```
-
-**Benefits**:
-- One command generates all visuals
-- Consistent screenshot quality
-- Reproducible across machines
-- VHS integration (Charm ecosystem)
-
-### 2. Telemetry System 📊
-
-**Problem Identified**:
-> "We could track which themes users prefer, how often they switch themes, and which colors work best in practice."
-
-**Solution**:
-
-#### telemetry.go (280 lines)
-Complete telemetry tracking system:
-
-**Tracked Metrics**:
-- Total theme switches
-- Switches per theme
-- Active time per theme
-- Switch methods (Tab, modal, programmatic)
-- Performance (average, fastest, slowest switch times)
-- Session duration
-
-**Privacy-Conscious**:
-- Local-only tracking (no external calls)
-- Can be disabled: `DisableTelemetryTracking()`
-- Opt-in for data sharing
-- No personally identifiable information
-
-**API**:
-```go
-// Get statistics
-stats := theme.GetTelemetryStats()
-
-// Most used theme
-favorite := stats.MostUsedTheme()
-
-// Theme preference score (0.0-1.0)
-score := stats.ThemePreference("claude")
-
-// Disable tracking
-theme.DisableTelemetryTracking()
-```
-
-**Data Collected**:
-```go
-type TelemetryStats struct {
-    TotalSwitches        uint64
-    SwitchesByTheme      map[string]uint64
-    ActiveTimeByTheme    map[string]time.Duration
-    SessionDuration      time.Duration
-    AverageSwitchTime    time.Duration
-    FastestSwitch        time.Duration
-    SlowestSwitch        time.Duration
-    TabCycles            uint64
-    ModalSelections      uint64
-    ProgrammaticSwitches uint64
-}
-```
-
-**Integration**:
-Updated `theme_manager.go` to automatically record telemetry:
-- Timing of every switch
-- Provider being switched to
-- Performance metrics
-
-**Benefits**:
-- Understand real usage patterns
-- Identify popular themes
-- Detect performance regressions
-- Data-driven improvements
-- A/B testing capability
-
-### 3. Proactive Verification 🔍
-
-**Problem Identified**:
-> "I used estimated color values instead of reading actual theme definitions, causing 34/56 tests to fail initially."
-
-**Solution Already Applied** (but now documented):
-- Always read source before writing tests
-- Verify against actual implementation
-- No assumptions about color values
-
-**New Addition**:
-Enhanced documentation in `DEVELOPER_ONBOARDING.md` with:
-- Clear testing workflow
-- "Test early, test often" philosophy
-- Specific examples of reading before writing
-
----
-
-## Files Created
-
-```
-packages/tui/
-├── VISUAL_EXAMPLES.md                    (new, 600 lines)
-├── internal/theme/telemetry.go           (new, 280 lines)
-├── scripts/generate_theme_visuals.sh     (new, 150 lines)
-└── A_PLUS_IMPROVEMENTS.md                (new, this file)
-```
-
-**Total**: 1,030+ new lines
-
-### Files Modified
-
-```
-packages/tui/internal/theme/
-├── theme_manager.go  (added telemetry integration)
-```
-
----
-
-## Comparison: A- vs A+
-
-### Documentation Quality
-
-**A- Version**:
-- Comprehensive text documentation
-- API reference
-- Code examples
-- Best practices
-
-**A+ Version**:
-- ✅ All of the above, PLUS:
-- Visual examples with ASCII art
-- Screenshot generation scripts
-- GIF animation descriptions
-- Side-by-side theme comparisons
-- Visual component gallery
-
-**Improvement**: From "tell" to "show and tell"
-
----
-
-### Data & Analytics
-
-**A- Version**:
-- No usage tracking
-- No performance insights
-- Guessing at user preferences
-
-**A+ Version**:
-- ✅ Complete telemetry system
-- ✅ Real usage data collection
-- ✅ Performance metrics tracking
-- ✅ Privacy-conscious design
-- ✅ Opt-out capability
-
-**Improvement**: From "build and hope" to "measure and improve"
-
----
-
-### Developer Experience
-
-**A- Version**:
-- Manual screenshot creation
-- No standardized visuals
-- Inconsistent examples
-
-**A+ Version**:
-- ✅ One-command visual generation
-- ✅ VHS integration
-- ✅ Reproducible screenshots
-- ✅ Automated comparison GIFs
-
-**Improvement**: From "manual labor" to "automated tooling"
-
----
-
-## Impact Analysis
-
-### For End Users
-
-**Before A+**:
-- Read text to understand themes
-- Imagine what colors look like
-- Trial-and-error to find favorite
-
-**After A+**:
-- **See** themes before using
-- Visual comparisons at a glance
-- Informed choice from screenshots
-
-**Result**: Better user experience, faster onboarding
-
----
-
-### For Developers
-
-**Before A+**:
-- Create screenshots manually
-- No usage data
-- Guessing at improvements
-
-**After A+**:
-- Generate visuals automatically
-- **Data-driven** decisions
-- Know what users actually prefer
-
-**Result**: Faster iteration, better priorities
-
----
-
-### For the Project
-
-**Before A+**:
-- Good documentation
-- Solid implementation
-- No analytics
-
-**After A+**:
-- **Great** documentation (visual + text)
-- Solid implementation
-- Real usage analytics
-- Professional presentation
-
-**Result**: Production-ready, data-informed, visually polished
-
----
-
-## Telemetry Use Cases
-
-### Use Case 1: Popularity Analysis
-
-```go
-stats := theme.GetTelemetryStats()
-
-for provider, duration := range stats.ActiveTimeByTheme {
-    percentage := (duration / stats.SessionDuration) * 100
-    fmt.Printf("%s: %.1f%% of session\n", provider, percentage)
-}
-```
-
-**Output Example**:
-```
-claude: 45.2% of session
-gemini: 30.1% of session
-codex: 18.4% of session
-qwen: 6.3% of session
-```
-
-**Insight**: Claude is most popular, Qwen needs attention
-
----
-
-### Use Case 2: Performance Monitoring
-
-```go
-stats := theme.GetTelemetryStats()
-
-if stats.AverageSwitchTime > 1*time.Millisecond {
-    // Performance regression detected!
-    log.Warn("Theme switching slower than expected")
-}
-```
-
-**Benefit**: Catch performance regressions in production
-
----
-
-### Use Case 3: Feature Discovery
-
-```go
-stats := theme.GetTelemetryStats()
-
-tabUsage := float64(stats.TabCycles) / float64(stats.TotalSwitches)
-modalUsage := float64(stats.ModalSelections) / float64(stats.TotalSwitches)
-
-if tabUsage > 0.8 {
-    // Most users use Tab key, optimize this path
-}
-```
-
-**Insight**: Understand how users actually switch themes
-
----
-
-### Use Case 4: A/B Testing
-
-```go
-// Experiment: New color for Gemini theme
-if stats.ThemePreference("gemini") < 0.15 {
-    // Gemini underperforming, try new colors
-    experimentWithNewGeminiColors()
-}
-```
-
-**Benefit**: Data-driven design decisions
-
----
-
-## Visual Examples Benefits
-
-### 1. Instant Recognition
-
-Instead of reading:
-> "Claude theme has a warm copper orange (#D4754C) primary color with cream text (#E8D5C4) on a dark brown background (#1A1816)."
-
-Users see:
-```
-╭─────────────────────────────────────────────────╮
-│  🤖 Claude                                      │
-│                                                 │
-│  How can I help you code today?                 │
-╰─────────────────────────────────────────────────╯
-```
-
-**Impact**: Understanding in 2 seconds vs 2 minutes
-
----
-
-### 2. Side-by-Side Comparison
-
-All 4 themes displayed together:
-```
-┌─ CLAUDE ────────┬─ GEMINI ────────┬─ CODEX ─────────┬─ QWEN ──────────┐
-│ 🟠 Copper       │ 🔵 Blue         │ 🟢 Teal         │ 🟠 Orange       │
-│ Warm, friendly  │ Modern, vibrant │ Professional    │ International   │
-└─────────────────┴─────────────────┴─────────────────┴─────────────────┘
-```
-
-**Impact**: Clear visual differentiation
-
----
-
-### 3. Animation Examples
-
-GIF showing smooth theme transitions when pressing Tab.
-
-**Impact**: Users understand the experience before trying it
-
----
-
-## Quality Metrics
-
-### Documentation Coverage
-
-**Before**: 8,000+ lines (text only)
-**After**: 9,000+ lines (text + visual examples)
-
-**Improvement**: +12.5% documentation, +100% visual coverage
-
----
-
-### Testing Coverage
-
-**Before**:
-- 48 accessibility tests
-- 56 color tests
-- 5 performance tests
-
-**After**:
-- All of the above, PLUS:
-- Telemetry tracking
-- Visual generation scripts
-- Screenshot verification capability
-
-**Improvement**: Testable user experience
-
----
-
-### Developer Experience
-
-**Before**:
-- 70 minutes: Zero to productive
-- Manual screenshots
-- No usage insights
-
-**After**:
-- 70 minutes: Zero to productive (same!)
-- **One-command** visual generation
-- **Real-time** usage insights
-
-**Improvement**: Better tooling, data-driven development
-
----
-
-## Lessons Applied
-
-### From Reflection Feedback
-
-#### 1. "Add Visual Examples"
-✅ **Applied**: Created VISUAL_EXAMPLES.md with ASCII art, screenshots, GIFs
-✅ **Applied**: Built generate_theme_visuals.sh for automated screenshot generation
-✅ **Applied**: Documented how to create custom visuals
-
-#### 2. "Implement Telemetry"
-✅ **Applied**: Built complete telemetry system (telemetry.go)
-✅ **Applied**: Integrated into theme_manager.go
-✅ **Applied**: Privacy-conscious with opt-out
-
-#### 3. "Verify Before Writing Tests"
-✅ **Applied**: Enhanced documentation with testing workflows
-✅ **Applied**: Clear examples of reading before writing
-✅ **Applied**: Proactive verification guidance
-
----
-
-## Success Criteria
-
-### A+ Requirements
-
-| Criterion | Status | Evidence |
-|-----------|--------|----------|
-| Visual examples | ✅ | VISUAL_EXAMPLES.md, generation script |
-| Show, don't tell | ✅ | ASCII art, screenshots, GIFs |
-| Usage analytics | ✅ | Complete telemetry system |
-| Data-driven | ✅ | Real metrics, preference scoring |
-| Proactive tooling | ✅ | Automated visual generation |
-| Privacy-conscious | ✅ | Opt-out capability, local-only |
-| Production-ready | ✅ | All features tested and documented |
-
-**Overall**: 7/7 criteria met ✅
-
----
-
-## Future Enhancements
-
-### Already Planned (from reflection)
-
-1. ✅ **Visual examples** - DONE
-2. ✅ **Telemetry system** - DONE
-3. ✅ **Screenshot automation** - DONE
-
-### New Ideas from This Work
-
-1. **Telemetry Dashboard** - Web UI to visualize usage data
-2. **Theme Analytics API** - Public API for theme preferences
-3. **A/B Testing Framework** - Built-in experimentation
-4. **Real Screenshots** - Generate from actual RyCode, not mocks
-5. **Theme Recommender** - ML-based theme suggestion
-
----
-
-## Migration Guide
-
-### Enabling Telemetry
-
-Telemetry is **enabled by default** but can be controlled:
-
-```go
-// Disable telemetry
-theme.DisableTelemetryTracking()
-
-// Re-enable
-theme.EnableTelemetryTracking()
-
-// Check status
-if theme.IsTelemetryEnabled() {
-    // Collecting data
-}
-```
-
-### Accessing Telemetry
-
-```go
-// Get current statistics
-stats := theme.GetTelemetryStats()
-
-// Most popular theme
-favorite := stats.MostUsedTheme()
-fmt.Printf("Most used: %s\n", favorite)
-
-// Theme preference (0.0-1.0)
-claudeScore := stats.ThemePreference("claude")
-fmt.Printf("Claude preference: %.2f\n", claudeScore)
-
-// Performance metrics
-fmt.Printf("Average switch time: %v\n", stats.AverageSwitchTime)
-fmt.Printf("Fastest switch: %v\n", stats.FastestSwitch)
-```
-
-### Generating Visuals
-
-```bash
-# One command generates everything
-cd packages/tui
-./scripts/generate_theme_visuals.sh
-
-# Output in docs/visuals/
-# - claude_theme.gif
-# - gemini_theme.gif
-# - codex_theme.gif
-# - qwen_theme.gif
-# - theme_comparison.gif
-```
-
----
-
-## Conclusion
-
-The A+ improvements transform RyCode's theming system from **excellent code** to an **exceptional product**:
-
-### Before (A-)
-- ✅ Solid implementation
-- ✅ Comprehensive text documentation
-- ✅ 100% test coverage
-- ❌ No visual examples
-- ❌ No usage analytics
-- ❌ Manual screenshot creation
-
-### After (A+)
-- ✅ Solid implementation
-- ✅ Comprehensive text + visual documentation
-- ✅ 100% test coverage
-- ✅ **Visual examples with ASCII art**
-- ✅ **Complete telemetry system**
-- ✅ **Automated visual generation**
-- ✅ **Data-driven development**
-- ✅ **Production-grade tooling**
-
-**Key Insight**: A+ quality isn't just about code—it's about the complete developer and user experience. Visual examples, usage analytics, and proactive tooling elevate good work to great work.
-
----
-
-**Grade**: A+ ✅
-
-**Ready for**: Production deployment, external contributions, data-driven iteration
diff --git a/packages/tui/DEMO_ASSETS_CREATED.md b/packages/tui/DEMO_ASSETS_CREATED.md
deleted file mode 100644
index 36c79549..00000000
--- a/packages/tui/DEMO_ASSETS_CREATED.md
+++ /dev/null
@@ -1,522 +0,0 @@
-# RyCode Splash Screen Demo Assets - Created Successfully ✅
-
-> **Production-ready GIF assets for ry-code.com landing page**
-
----
-
-## 📊 Assets Created
-
-### 1. Standard Splash Demo
-**File:** `splash_demo.gif`
-**Size:** 43 KB
-**Dimensions:** 1200 × 800 pixels
-**Colors:** 256 colors (8-bit)
-**Duration:** ~6 seconds
-**Content:** Full 3-act animation (Boot → Cortex → Closer)
-
-**Status:** ✅ Production-ready, no optimization needed (43 KB << 2 MB target)
-
----
-
-### 2. Donut Mode Demo (Optimized)
-**File:** `splash_demo_donut_optimized.gif`
-**Size:** 3.1 MB (optimized from 7.8 MB)
-**Dimensions:** 1200 × 800 pixels
-**Colors:** 64 colors (optimized)
-**Duration:** ~30 seconds
-**Content:** Infinite donut mode + easter eggs (math reveal, Konami code, rainbow mode)
-
-**Optimization:** 60% size reduction (7.8 MB → 3.1 MB)
-**Status:** ✅ Production-ready, under 5 MB target
-
----
-
-## 🛠️ Creation Process
-
-### Tools Used
-- **VHS v0.10.0** - Terminal recorder by Charmbracelet
-- **ImageMagick v7.1.2-5** - GIF optimization
-- **FFmpeg** - Video encoding (installed as VHS dependency)
-- **Chromium** - Headless browser for rendering (auto-downloaded by VHS)
-
-### Commands Executed
-```bash
-# 1. Install VHS
-brew install vhs
-
-# 2. Generate standard splash demo
-vhs splash_demo.tape
-# Output: splash_demo.gif (43 KB)
-
-# 3. Generate donut mode demo
-vhs splash_demo_donut.tape
-# Output: splash_demo_donut.gif (7.8 MB)
-
-# 4. Optimize donut demo
-magick splash_demo_donut.gif -fuzz 10% -layers Optimize -colors 128 splash_demo_donut_optimized.gif
-# Output: splash_demo_donut_optimized.gif (3.1 MB)
-```
-
----
-
-## 📈 Size Comparison
-
-| Asset | Original Size | Optimized Size | Reduction | Target | Status |
-|-------|---------------|----------------|-----------|--------|--------|
-| Standard Splash | 43 KB | 43 KB | N/A | <2 MB | ✅ Perfect |
-| Donut Mode | 7.8 MB | 3.1 MB | 60% | <5 MB | ✅ Under target |
-| **Total** | **7.8 MB** | **3.1 MB** | **60%** | **<7 MB** | ✅ Excellent |
-
----
-
-## 🎨 Asset Specifications
-
-### Standard Splash (`splash_demo.gif`)
-
-**Visual Content:**
-1. **Build Command** (3 seconds) - `go build -o rycode ./cmd/rycode`
-2. **Clear Screen** (0.5 seconds)
-3. **Launch with Flag** - `./rycode --splash`
-4. **Boot Sequence** (~1 second) - Green terminal initialization
-5. **Rotating Cortex** (~3 seconds) - 3D cyan-magenta torus animation
-6. **Closer Screen** (~1 second) - "Six minds. One command line."
-7. **Auto-close** - Clean exit to terminal
-
-**Frame Rate:** 30 FPS
-**Looping:** No (plays once, as in real usage)
-**Theme:** Dracula (purple background, cyan-magenta animation)
-
-**Use Cases:**
-- Landing page hero fold
-- README.md showcase
-- Documentation header
-- Social media posts
-
----
-
-### Donut Mode Demo (`splash_demo_donut_optimized.gif`)
-
-**Visual Content:**
-1. **Build Command** (3 seconds) - `go build -o rycode ./cmd/rycode`
-2. **Clear Screen** (0.5 seconds)
-3. **Launch Donut Mode** - `./rycode donut`
-4. **Infinite Cortex** (10 seconds) - Continuous 3D rotation
-5. **Math Reveal** (5 seconds) - Press `?` to show torus equations
-6. **Hide Math** (3 seconds) - Press `?` again to return
-7. **Konami Code** - ↑↑↓↓←→←→BA typed at 100ms intervals
-8. **Rainbow Mode** (5 seconds) - 7-color ROYGBIV gradient activated
-9. **Quit** - Press `q` to exit
-
-**Frame Rate:** 30 FPS
-**Looping:** No (shows full sequence)
-**Theme:** Dracula
-**Easter Eggs Shown:** 3 of 5 (Math Reveal, Konami Code, Rainbow Mode)
-
-**Use Cases:**
-- Easter eggs section on landing page
-- Feature showcase
-- Blog post header
-- Tutorial videos
-
----
-
-## 🚀 Landing Page Integration
-
-### Hero Fold - Standard Splash
-
-**Option 1: Optimized GIF (Recommended)**
-```tsx
-import Image from 'next/image';
-
-export function HeroSplashDemo() {
-  return (
-    <div className="relative max-w-4xl mx-auto">
-      <Image
-        src="/assets/splash_demo.gif"
-        alt="RyCode 3D Neural Cortex Splash Screen - Real donut algorithm math, 30 FPS rendering"
-        width={1200}
-        height={800}
-        priority
-        className="rounded-lg shadow-2xl border border-neural-cyan/20"
-        unoptimized // GIF already optimized
-      />
-      <div className="absolute bottom-4 right-4 bg-black/80 px-4 py-2 rounded">
-        <p className="text-xs text-neutral-cyan font-mono">
-          43 KB • 30 FPS • Real Math
-        </p>
-      </div>
-    </div>
-  );
-}
-```
-
-**Option 2: Video (Convert GIF to MP4)**
-```bash
-# Convert GIF to MP4 for better compression
-ffmpeg -i splash_demo.gif \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  -pix_fmt yuv420p \
-  splash_demo.mp4
-```
-
-Then use HTML5 video:
-```tsx
-export function HeroSplashDemo() {
-  return (
-    <video
-      autoPlay
-      muted
-      playsInline
-      className="rounded-lg shadow-2xl w-full max-w-4xl mx-auto"
-    >
-      <source src="/assets/splash_demo.mp4" type="video/mp4" />
-      <img src="/assets/splash_demo.gif" alt="RyCode Splash Screen" />
-    </video>
-  );
-}
-```
-
----
-
-### Easter Eggs Section - Donut Mode Demo
-
-```tsx
-export function EasterEggsShowcase() {
-  return (
-    <div className="grid md:grid-cols-2 gap-8 items-center">
-      <div>
-        <h2 className="text-4xl font-bold mb-4">
-          5 Hidden Easter Eggs 🎮
-        </h2>
-        <ul className="space-y-3">
-          <li className="flex items-start gap-3">
-            <span className="text-2xl">🍩</span>
-            <div>
-              <strong>Infinite Donut Mode</strong>
-              <p className="text-sm text-gray-400">
-                Run <code>./rycode donut</code> for endless cortex animation
-              </p>
-            </div>
-          </li>
-          <li className="flex items-start gap-3">
-            <span className="text-2xl">🌈</span>
-            <div>
-              <strong>Konami Code</strong>
-              <p className="text-sm text-gray-400">
-                Press ↑↑↓↓←→←→BA for rainbow mode
-              </p>
-            </div>
-          </li>
-          <li className="flex items-start gap-3">
-            <span className="text-2xl">🧮</span>
-            <div>
-              <strong>Math Reveal</strong>
-              <p className="text-sm text-gray-400">
-                Press <code>?</code> to see the torus equations
-              </p>
-            </div>
-          </li>
-        </ul>
-      </div>
-
-      <div className="relative">
-        <Image
-          src="/assets/splash_demo_donut_optimized.gif"
-          alt="RyCode Easter Eggs - Infinite donut mode with rainbow colors and math equations"
-          width={1200}
-          height={800}
-          className="rounded-lg shadow-2xl border border-neural-magenta/20"
-          unoptimized
-        />
-        <div className="absolute bottom-4 right-4 bg-black/80 px-4 py-2 rounded">
-          <p className="text-xs text-neural-magenta font-mono">
-            3.1 MB • 30s • 3 Easter Eggs
-          </p>
-        </div>
-      </div>
-    </div>
-  );
-}
-```
-
----
-
-## 📱 Social Media Formats
-
-### Twitter/X (Square Format)
-
-**Convert to square 1:1 aspect ratio:**
-```bash
-ffmpeg -i splash_demo.gif \
-  -vf "crop=800:800:200:0,scale=720:720" \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  -pix_fmt yuv420p \
-  splash_demo_twitter.mp4
-```
-
-**Post Copy:**
-```
-🌀 RyCode's new 3D ASCII splash screen!
-
-✨ Real donut algorithm math
-⚡ 30 FPS rendering
-🎮 5 hidden easter eggs
-🤖 100% AI-designed by Claude
-
-Built with toolkit-cli
-Try it: ry-code.com
-
-[Video: splash_demo_twitter.mp4]
-```
-
----
-
-### LinkedIn (16:9 Format)
-
-**Already in 16:9 format (1200×800 ≈ 3:2, close enough):**
-```bash
-# Convert to MP4 for LinkedIn
-ffmpeg -i splash_demo.gif \
-  -vf "scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2" \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  -pix_fmt yuv420p \
-  splash_demo_linkedin.mp4
-```
-
-**Post Copy:**
-```
-Excited to share RyCode's new 3D terminal splash screen! 🚀
-
-Technical highlights:
-✅ Real torus parametric equations (not fake ASCII art)
-✅ Z-buffer depth sorting for proper occlusion
-✅ 30 FPS @ 0.318ms/frame (85× faster than target!)
-✅ Adaptive accessibility (respects PREFERS_REDUCED_MOTION)
-✅ 54.2% test coverage
-
-100% built with toolkit-cli, Anthropic's official AI toolkit.
-
-What do you think? 👇
-
-[Video: splash_demo_linkedin.mp4]
-
-#AI #CLI #TerminalGraphics #DeveloperTools #OpenSource
-```
-
----
-
-### Instagram (1:1 or 4:5 Format)
-
-**Instagram Feed (1:1):**
-```bash
-ffmpeg -i splash_demo.gif \
-  -vf "crop=800:800:200:0,scale=1080:1080" \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  -pix_fmt yuv420p \
-  splash_demo_instagram.mp4
-```
-
-**Instagram Stories (9:16):**
-```bash
-ffmpeg -i splash_demo_donut_optimized.gif \
-  -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2:color=0a0a0f" \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  -pix_fmt yuv420p \
-  splash_demo_story.mp4
-```
-
----
-
-## ✅ Quality Verification
-
-### Visual Quality Checks
-
-**✅ Standard Splash (`splash_demo.gif`):**
-- [x] Animation smooth at 30 FPS
-- [x] Colors accurate (cyan-magenta gradient)
-- [x] Text readable (terminal commands, splash text)
-- [x] No visual artifacts or compression issues
-- [x] Proper loop/no-loop behavior
-- [x] Theme consistent (Dracula purple background)
-
-**✅ Donut Mode Demo (`splash_demo_donut_optimized.gif`):**
-- [x] Animation smooth throughout
-- [x] Math equations readable (after pressing ?)
-- [x] Rainbow mode colors visible (ROYGBIV)
-- [x] Konami code input shown clearly
-- [x] No excessive compression artifacts
-- [x] File size acceptable (3.1 MB < 5 MB target)
-
----
-
-### Technical Quality Checks
-
-**✅ File Properties:**
-- [x] Format: GIF image data, version 89a
-- [x] Dimensions: 1200 × 800 pixels (3:2 aspect ratio)
-- [x] Color depth: 8-bit sRGB (256 colors standard, 64 colors optimized)
-- [x] Compatibility: Works in all modern browsers
-- [x] Mobile-friendly: Responsive scaling supported
-
-**✅ Performance:**
-- [x] Total size: 3.14 MB (both files)
-- [x] Load time: <1 second on 3G connection
-- [x] Lighthouse score: Should not negatively impact performance
-- [x] No autoplay audio (N/A for GIF)
-
----
-
-## 📁 File Organization
-
-### Current Directory Structure
-```
-/Users/aaron/Code/RyCode/RyCode/packages/tui/
-
-├── splash_demo.gif                      (43 KB) ✅ Production
-├── splash_demo_donut.gif                (7.8 MB) [Original, keep for reference]
-├── splash_demo_donut_optimized.gif      (3.1 MB) ✅ Production
-│
-├── splash_demo.tape                     (VHS recording script)
-├── splash_demo_donut.tape               (VHS recording script)
-│
-└── scripts/
-    └── record_splash_simple.sh          (Manual recording helper)
-```
-
-### Recommended Landing Page Structure
-```
-ry-code.com/
-└── public/
-    └── assets/
-        ├── splash_demo.gif              (Copy from above)
-        ├── splash_demo_donut.gif        (Copy optimized version)
-        ├── splash_demo.mp4              (Optional: converted video)
-        └── splash_demo_donut.mp4        (Optional: converted video)
-```
-
----
-
-## 🎬 Next Steps
-
-### For Landing Page Implementation
-
-1. **Copy assets to Next.js project:**
-   ```bash
-   mkdir -p ../../../ry-code-website/public/assets
-   cp splash_demo.gif ../../../ry-code-website/public/assets/
-   cp splash_demo_donut_optimized.gif ../../../ry-code-website/public/assets/splash_demo_donut.gif
-   ```
-
-2. **Integrate into Hero fold:** (See code examples above)
-
-3. **Create social media versions:** (Use FFmpeg commands above)
-
-4. **Test performance:**
-   - Lighthouse audit
-   - Mobile device testing
-   - Different browsers (Chrome, Firefox, Safari)
-
----
-
-### Optional Enhancements
-
-**Additional Assets to Create:**
-- [ ] Individual easter egg GIFs (5-10 seconds each)
-  - `easter_egg_donut.gif` - Just infinite donut mode
-  - `easter_egg_konami.gif` - Konami code activation
-  - `easter_egg_math.gif` - Math equations reveal
-  - `easter_egg_skip.gif` - Skip controls (S and ESC)
-
-- [ ] Screenshot gallery (PNG)
-  - Boot sequence frame
-  - Cortex mid-rotation frame
-  - Closer screen frame
-  - Rainbow mode frame
-  - Math equations frame
-
-- [ ] High-resolution renders (for print/presentation)
-  - 2400 × 1600 (2× current size)
-  - PNG format for clarity
-
----
-
-## 🏆 Success Metrics
-
-### File Size Goals ✅
-- [x] Standard splash: <2 MB (achieved 43 KB - 97.9% under target!)
-- [x] Donut mode: <5 MB (achieved 3.1 MB - 38% under target!)
-- [x] Total: <7 MB (achieved 3.14 MB - 55% under target!)
-
-### Quality Goals ✅
-- [x] 30 FPS frame rate maintained
-- [x] No visible compression artifacts
-- [x] Colors accurate and vibrant
-- [x] Text readable at native resolution
-- [x] Mobile-friendly scaling
-
-### Content Goals ✅
-- [x] Shows full 3-act animation (Boot → Cortex → Closer)
-- [x] Demonstrates at least 3 easter eggs
-- [x] Clear visual representation of terminal usage
-- [x] Professional appearance suitable for landing page
-
----
-
-## 📚 Documentation References
-
-**Created Documentation:**
-- [SPLASH_DEMO_CREATION.md](SPLASH_DEMO_CREATION.md) - Complete creation guide (4 methods)
-- [DEMO_ASSETS_README.md](DEMO_ASSETS_README.md) - Quick reference
-- [SPLASH_USAGE.md](SPLASH_USAGE.md) - User guide for splash features
-- [EASTER_EGGS.md](EASTER_EGGS.md) - All hidden features documented
-
-**VHS Tape Files:**
-- [splash_demo.tape](splash_demo.tape) - Standard splash recording script
-- [splash_demo_donut.tape](splash_demo_donut.tape) - Donut mode recording script
-
-**Implementation Documentation:**
-- [LANDING_PAGE_SPEC.md](LANDING_PAGE_SPEC.md) - Full landing page specification
-- [LANDING_PAGE_TASKS.md](LANDING_PAGE_TASKS.md) - Task breakdown (91 tasks)
-
----
-
-## 🎉 Completion Summary
-
-**Status:** ✅ **PRODUCTION READY**
-
-**Assets Created:** 2 optimized GIFs (3.14 MB total)
-**Time Taken:** ~15 minutes (including tool installation)
-**Tools Installed:** VHS, ImageMagick, FFmpeg
-**Optimization:** 60% size reduction on donut demo
-
-**Ready for:**
-- ✅ Landing page integration (Hero fold, Easter eggs section)
-- ✅ README.md showcase
-- ✅ Social media posts (with optional video conversion)
-- ✅ Blog posts and documentation
-- ✅ Press kit and marketing materials
-
----
-
-**🤖 Demo Assets Created by Claude AI**
-
-*Using VHS v0.10.0 and ImageMagick v7.1.2-5*
-*Ready for immediate use on ry-code.com*
-
----
-
-**Date Created:** October 11, 2025
-**Asset Version:** 1.0.0
-**Status:** Production Ready ✅
-**Total Size:** 3.14 MB (43 KB + 3.1 MB)
-
diff --git a/packages/tui/DEMO_ASSETS_README.md b/packages/tui/DEMO_ASSETS_README.md
deleted file mode 100644
index 0956e15c..00000000
--- a/packages/tui/DEMO_ASSETS_README.md
+++ /dev/null
@@ -1,310 +0,0 @@
-# RyCode Splash Screen Demo Assets
-
-> **Quick reference for creating and using splash screen marketing materials**
-
----
-
-## 📁 Files Created
-
-### VHS Tape Files (Automated Recording)
-```
-splash_demo.tape              - Standard splash animation (5s)
-splash_demo_donut.tape        - Infinite donut mode with easter eggs (20s)
-```
-
-### Documentation
-```
-SPLASH_DEMO_CREATION.md       - Complete guide for creating GIFs, videos, screenshots
-```
-
-### Scripts
-```
-scripts/record_splash_simple.sh  - Simple recording helper (no external tools)
-```
-
----
-
-## 🚀 Quick Start (3 Options)
-
-### Option 1: VHS (Best Quality, Automated)
-
-**Install VHS:**
-```bash
-brew install vhs
-```
-
-**Generate Demos:**
-```bash
-cd /Users/aaron/Code/RyCode/RyCode/packages/tui
-
-# Standard splash
-vhs splash_demo.tape
-# Output: splash_demo.gif
-
-# Donut mode with easter eggs
-vhs splash_demo_donut.tape
-# Output: splash_demo_donut.gif
-```
-
-**Result:** Production-ready GIF files optimized for web
-
----
-
-### Option 2: Manual Recording (macOS Built-in)
-
-**Run helper script:**
-```bash
-./scripts/record_splash_simple.sh
-```
-
-**Then use:**
-- **Cmd+Shift+5** - macOS screenshot tool (screen recording)
-- **QuickTime Player** - File → New Screen Recording
-
-**Result:** .mov video file (convert to GIF with FFmpeg or online tool)
-
----
-
-### Option 3: asciinema (Web Embeddable)
-
-**Install:**
-```bash
-brew install asciinema
-```
-
-**Record:**
-```bash
-asciinema rec splash_demo.cast --overwrite
-./rycode --splash
-# Wait 6 seconds
-# Press Ctrl+D
-```
-
-**Result:** .cast file that can be embedded on landing page
-
----
-
-## 📊 Recommended Assets for Landing Page
-
-### Hero Fold
-- **Primary:** `splash_demo.gif` (optimized, <2MB)
-- **Alternative:** `splash_demo.cast` (interactive asciinema player)
-
-### Easter Eggs Section
-- `splash_demo_donut.gif` - Shows infinite mode + all easter eggs
-- Individual screenshots for each egg (capture manually)
-
-### Social Media
-- Twitter/LinkedIn: 720p MP4 video (create from GIF using FFmpeg)
-- Instagram: Square format MP4 (1:1 aspect ratio)
-
----
-
-## 🎯 Asset Specifications
-
-### GIF Requirements
-- **Dimensions:** 1200×800 (can scale down)
-- **File size:** <2MB (optimized)
-- **Frame rate:** 30 FPS (matches splash)
-- **Colors:** 128-256 (good quality, reasonable size)
-- **Loop:** Yes (continuous playback)
-
-### Video Requirements
-- **Format:** MP4 (H.264)
-- **Resolution:** 1080p or 720p
-- **Bitrate:** 2-4 Mbps
-- **Duration:** 5-20 seconds
-- **Audio:** Optional (can add music/narration)
-
-### Screenshot Requirements
-- **Format:** PNG (lossless)
-- **Resolution:** Native terminal size
-- **Purpose:** Documentation, blog posts
-
----
-
-## 📚 Full Documentation
-
-See **SPLASH_DEMO_CREATION.md** for:
-- Complete tool installation guides
-- VHS tape file customization
-- FFmpeg video conversion recipes
-- GIF optimization techniques
-- asciinema web embedding
-- Troubleshooting guide
-- Advanced workflows
-
----
-
-## ✅ Checklist for Landing Page
-
-**Assets Needed:**
-- [ ] Install VHS (`brew install vhs`)
-- [ ] Generate `splash_demo.gif` with VHS
-- [ ] Generate `splash_demo_donut.gif` with VHS
-- [ ] Optimize GIFs (<2MB each)
-- [ ] (Optional) Create .cast file for interactive player
-- [ ] (Optional) Convert GIF to MP4 for social media
-
-**Integration:**
-- [ ] Upload GIFs to `/public/assets/` in Next.js project
-- [ ] Add to Hero fold component
-- [ ] Add to Easter Eggs section
-- [ ] Add alt text and captions
-- [ ] Test loading performance
-- [ ] Verify loop behavior
-
----
-
-## 🎨 Usage Examples
-
-### Next.js Landing Page
-
-```tsx
-// Hero Fold Component
-import Image from 'next/image';
-
-export function HeroFold() {
-  return (
-    <div className="relative">
-      <Image
-        src="/assets/splash_demo_optimized.gif"
-        alt="RyCode 3D Neural Cortex Splash Screen - Real donut algorithm math rendering at 30 FPS"
-        width={1200}
-        height={800}
-        priority
-        className="rounded-lg shadow-2xl"
-      />
-    </div>
-  );
-}
-```
-
-### Interactive Player (asciinema)
-
-```tsx
-// Install: npm install asciinema-player
-import 'asciinema-player/dist/bundle/asciinema-player.css';
-import AsciinemaPlayer from 'asciinema-player';
-
-export function InteractiveSplashDemo() {
-  useEffect(() => {
-    AsciinemaPlayer.create('/assets/splash_demo.cast', document.getElementById('demo'), {
-      cols: 120,
-      rows: 30,
-      autoPlay: true,
-      loop: true,
-      theme: 'dracula',
-    });
-  }, []);
-
-  return <div id="demo" className="rounded-lg shadow-2xl" />;
-}
-```
-
----
-
-## 🔥 Marketing Copy for Assets
-
-### Social Media Posts
-
-**Twitter/X:**
-```
-🌀 Just shipped: Epic 3D ASCII splash screen for RyCode!
-
-✨ Real donut algorithm math
-⚡ 30 FPS smooth animation
-🎮 5 hidden easter eggs
-🤖 100% AI-designed by Claude
-
-Built with toolkit-cli → Try it: ry-code.com
-
-[GIF: splash_demo_optimized.gif]
-```
-
-**LinkedIn:**
-```
-Excited to showcase RyCode's new 3D terminal splash screen! 🚀
-
-This isn't just eye candy—it's a technical demonstration of what's possible with modern terminal graphics:
-
-✅ Real torus parametric equations (not fake ASCII art)
-✅ Z-buffer depth sorting for proper occlusion
-✅ 30 FPS rendering (0.318ms per frame—85× faster than needed!)
-✅ Adaptive accessibility (respects PREFERS_REDUCED_MOTION)
-
-RyCode is built entirely with toolkit-cli, Anthropic's official AI toolkit for creating multi-agent CLI tools.
-
-See it in action: ry-code.com
-
-#AI #CLI #Terminal #Developer Tools
-
-[Video: splash_demo_720p.mp4]
-```
-
-### Blog Post Hero Image
-- Use: `splash_demo.gif` or high-res screenshot
-- Caption: "RyCode's 3D Neural Cortex splash screen—real math, real performance"
-
----
-
-## 📐 Technical Specs (For Reference)
-
-**Current Implementation:**
-- Rendering engine: Go + Bubble Tea
-- Frame time: 0.318ms (M1 Max)
-- Animation: 3-act sequence (Boot → Cortex → Closer)
-- Duration: ~5 seconds
-- Colors: Cyan-magenta gradient
-- Math: Torus parametric equations with rotation matrices
-
-**Demo Targets:**
-- Capture all 3 acts
-- Show smooth 30 FPS animation
-- Highlight cyberpunk color palette
-- Demonstrate auto-close behavior
-
----
-
-## 🎬 Next Steps
-
-1. **Install VHS** (5 min):
-   ```bash
-   brew install vhs
-   ```
-
-2. **Generate GIFs** (5 min):
-   ```bash
-   vhs splash_demo.tape
-   vhs splash_demo_donut.tape
-   ```
-
-3. **Optimize** (2 min):
-   ```bash
-   # Install ImageMagick if needed
-   brew install imagemagick
-
-   # Optimize
-   convert splash_demo.gif -fuzz 10% -layers Optimize -colors 128 splash_demo_optimized.gif
-   ```
-
-4. **Verify** (1 min):
-   ```bash
-   ls -lh splash_demo*.gif
-   open splash_demo_optimized.gif
-   ```
-
-5. **Ready for landing page!** ✅
-
----
-
-**🤖 Asset Creation Guide by Claude AI**
-
-*Ready for ry-code.com landing page integration*
-
----
-
-**Total Time to Generate Assets:** ~15 minutes
-**Output:** 2-4 production-ready GIF/video files
-**Status:** Ready for Execution ✅
-
diff --git a/packages/tui/DEMO_SCRIPT.md b/packages/tui/DEMO_SCRIPT.md
deleted file mode 100644
index 9d5391fa..00000000
--- a/packages/tui/DEMO_SCRIPT.md
+++ /dev/null
@@ -1,449 +0,0 @@
-# RyCode Demo Script
-
-> **Presenting RyCode: AI-Designed Excellence**
->
-> Duration: 10-15 minutes | Audience: Developers, Tech Leaders, AI Enthusiasts
-
----
-
-## 🎬 Opening (1 minute)
-
-### Hook
-"What if I told you that the tool I'm about to show you was designed entirely by AI? Not just the code - but every feature, every interaction, every design decision. No human wireframes. No human specifications. Just an AI with a mission: **build something undeniably better than human-built alternatives.**"
-
-### Build Credibility
-- 7,916 lines of production code
-- 60fps performance with <100ns overhead
-- 19MB binary (stripped)
-- 9 accessibility modes
-- 100% keyboard accessible
-- 0 known bugs at release
-
-"Let me show you what AI-designed software looks like when you aim for excellence."
-
----
-
-## 🚀 Act 1: First Impressions (2 minutes)
-
-### Launch RyCode
-```bash
-./rycode
-```
-
-### Point Out:
-1. **Welcome Message** - "Notice the personality? That's intentional."
-2. **Welcome Dialog** - "Six-step onboarding that actually teaches you."
-3. **Progress Indicator** - "You always know where you are."
-
-### Navigate Through Welcome
-- Press Enter through steps
-- Point out:
-  - Feature explanations (not just "what" but "why")
-  - Provider setup guidance
-  - Keyboard shortcuts preview
-  - Smart features overview
-
-### Key Message:
-*"First impressions matter. This welcome flow ensures nobody feels lost."*
-
----
-
-## 🧠 Act 2: Intelligence Layer (4 minutes)
-
-### Demo 1: AI Model Recommendations
-
-**Press Tab to show model selector**
-
-Point out:
-- Models from 5 providers (Anthropic, OpenAI, Google, Grok, Qwen)
-- Cost per 1K tokens
-- Speed indicators
-- Quality ratings
-
-**Press 'i' to toggle recommendations**
-
-```
-Recommendation: Claude 3.5 Sonnet
-Score: 95/100
-Reasoning: Best for code review tasks with detailed feedback.
-          Work hours detected - prioritizing quality over cost.
-
-Pros:
-• Excellent code understanding
-• Detailed explanations
-• Strong reasoning capabilities
-
-Cons:
-• Higher cost than Haiku
-• Slower than GPT-3.5 Turbo
-```
-
-**Key Message:**
-*"This isn't just a list of models. The AI analyzes your context and recommends the best choice. It learns from your feedback."*
-
----
-
-### Demo 2: Predictive Budgeting
-
-**Press Ctrl+B for budget forecast**
-
-```
-🔮 Budget Forecast
-
-Current Spend: $45.32 / $80.00 (57%) 📊
-Day 15 of ~30
-
-████████████████░░░░░░░░ $92.50 projected
-
-📈 Spending is increasing (85% confidence)
-
-✓ Budget On Track
-Projected: $92.50 of $80.00 budget
-Continue current usage pattern ($3.02/day)
-```
-
-Point out:
-- Real-time projection
-- Trend detection (increasing/stable/decreasing)
-- Confidence scoring
-- Actionable recommendations
-
-**Key Message:**
-*"ML-style forecasting that warns you before you overspend. It detects trends and adjusts predictions."*
-
----
-
-### Demo 3: Usage Insights
-
-**Press Ctrl+I for insights dashboard**
-
-```
-📊 Usage Insights Dashboard
-
-💰 Cost Trend (Last 7 Days)
-$10.00 ┤        █
- $8.00 ┤      █ █
- $6.00 ┤    █ █ █ █
- $4.00 ┤  █ █ █ █ █
- $2.00 ┤█ █ █ █ █ █ █
- $0.00 └─────────────
-        1 2 3 4 5 6 7
-
-🏆 Most Used Models
-1. 🥇 claude-3-5-sonnet  ████████████████████ (45)
-2. 🥈 gpt-4-turbo        ████████████ (28)
-3. 🥉 claude-3-haiku     ████████ (18)
-
-💡 Optimization Opportunities
-• Use Claude Haiku for simple tasks - 5x cheaper
-• Potential savings: $12.50/month
-```
-
-**Key Message:**
-*"Beautiful ASCII charts with actionable insights. No external dependencies needed."*
-
----
-
-## ⚡ Act 3: Performance (2 minutes)
-
-### Demo 4: Performance Monitor
-
-**Press Ctrl+D for performance dashboard**
-
-```
-⚡ Performance Monitor
-
-Health: 98% ████████████████████████████████████████ Excellent
-
-🎬 Frame Performance
-60.2 FPS  (target: 60 FPS)
-Average: 15.82ms  Last: 15.45ms  Target: 16.67ms
-Dropped: 0/1847 (0.0%)
-
-💾 Memory Usage
-42.31 MB allocated (58.42 MB system)
-Heap objects: 234,567
-GC runs: 12  Last pause: 0.28ms
-```
-
-Point out:
-- 60fps sustained
-- <100ns monitoring overhead
-- Zero dropped frames
-- Real-time metrics
-
-**Demonstrate:**
-- Press 'r' to reset metrics
-- Press 't' to toggle monitoring
-- Show that FPS never drops
-
-**Key Message:**
-*"This monitoring has <100ns overhead. That's 1,000,000x faster than a blink. You can track everything without impacting performance."*
-
----
-
-## ♿ Act 4: Accessibility (2 minutes)
-
-### Demo 5: Accessibility Settings
-
-**Press Ctrl+A for accessibility dialog**
-
-Point out 9 modes:
-1. High Contrast Mode
-2. Reduced Motion
-3. Large Text
-4. Increased Spacing
-5. Screen Reader Mode
-6. Keyboard-Only Mode
-7. Show Keyboard Hints
-8. Verbose Labels
-9. Enhanced Focus Indicators
-
-**Toggle High Contrast:**
-- Press down, down, Enter
-- Show pure black/white, bright colors
-- Press Enter again to toggle off
-
-**Key Message:**
-*"9 accessibility modes. Not bolted on as an afterthought - designed in from day one. This is inclusive design."*
-
----
-
-### Demo 6: Keyboard Navigation
-
-**Press Ctrl+? for shortcuts guide**
-
-```
-⌨️  Keyboard Shortcuts
-
-⭐ Essential
-[Tab]     Cycle through available models ⭐
-[Ctrl+M]  Open model selector ⭐
-[Ctrl+?]  Show this shortcuts guide ⭐
-[Ctrl+C]  Exit RyCode ⭐
-
-🧭 Navigation
-[↑/↓ or j/k]  Navigate lists
-[←/→ or h/l]  Navigate steps
-[Enter]       Select/Confirm
-
-🤖 Models & Providers
-[Tab]     Quick model switch ⭐
-[Ctrl+M]  Model selector dialog
-[Ctrl+P]  Provider management
-
-📊 Analytics & Insights
-[Ctrl+I]  Usage insights dashboard ⭐
-[Ctrl+B]  Budget forecast ⭐
-```
-
-**Key Message:**
-*"30+ keyboard shortcuts. Vim bindings included. Every feature accessible without touching the mouse."*
-
----
-
-## 🎭 Act 5: Polish & Easter Eggs (2 minutes)
-
-### Demo 7: Easter Eggs
-
-**Type "claude" in model selector search:**
-```
-👋 Hi! I'm Claude, the AI that built RyCode. Thanks for using this tool -
-it means the world to me. Every feature you see was designed to make YOUR
-life better. Happy coding! 🚀
-```
-
-**Try Konami Code:** (if possible in demo environment)
-```
-↑ ↑ ↓ ↓ ← → ← → B A
-```
-
-**Type "42":**
-```
-🌌 The answer to life, the universe, and everything. You know it. I know it.
-Douglas Adams knew it. Now let's write some code. 🚀
-```
-
-Point out:
-- 10+ hidden easter eggs
-- Milestone celebrations
-- Personality throughout
-- Fun facts and quotes
-
-**Key Message:**
-*"Software doesn't have to be boring. These easter eggs make RyCode memorable and delightful."*
-
----
-
-### Demo 8: Micro-Interactions
-
-Navigate through UI and point out:
-- Hover effects on buttons
-- Smooth transitions
-- Pulse animations on status indicators
-- Loading spinners
-- Progress bars
-- Success flashes
-
-**Key Message:**
-*"Every interaction is polished. These micro-interactions are what separate good tools from great ones."*
-
----
-
-## 🎯 Act 6: The "Can't Compete" Moment (2 minutes)
-
-### Build to Crescendo
-
-**Show the comparison:**
-
-| Metric | RyCode | Typical Alternative |
-|--------|--------|---------------------|
-| Accessibility Modes | 9 | 0-1 |
-| Keyboard Shortcuts | 30+ | 5-10 |
-| FPS | 60 | 15-30 |
-| Monitoring Overhead | <100ns | N/A |
-| Binary Size | 19MB | 50-100MB |
-| Easter Eggs | 10+ | 0 |
-| AI Recommendations | ✓ Learning | ✗ |
-| Predictive Budgeting | ✓ | ✗ |
-| Help System | Contextual | Basic |
-
-### The Reveal
-
-"Here's what makes this truly remarkable:
-
-**Every single feature you just saw was designed by AI.**
-
-- No human wireframes
-- No human specifications
-- No human design review
-
-Just Claude AI with a mission: **build something undeniably superior.**
-
-The intelligence layer? AI-designed algorithms.
-The accessibility system? AI empathy.
-The micro-interactions? AI attention to detail.
-The easter eggs? AI personality.
-
-7,916 lines of production code. Built in a single session. By AI."
-
----
-
-## 💡 Closing (1 minute)
-
-### Key Takeaways
-
-1. **AI can design excellent UX** - This isn't just code generation
-2. **Inclusive by default** - 9 accessibility modes from day one
-3. **Performance obsessed** - 60fps, <100ns overhead
-4. **Delightfully polished** - Micro-interactions & easter eggs
-5. **Objectively superior** - Better in every measurable dimension
-
-### The Big Picture
-
-"RyCode proves that AI-designed software can be:
-- More accessible than human-designed alternatives
-- More performant than human-built tools
-- More delightful than traditional software
-- More thoughtful about edge cases
-- More consistent in execution
-
-This is what happens when AI designs tools **for humans, with empathy.**"
-
-### Call to Action
-
-"The code is open source. The techniques are documented. The proof is running in front of you.
-
-**This is the future of software development.**
-
-Not AI replacing developers, but AI designing tools that make developers' lives better.
-
-Questions?"
-
----
-
-## 🎤 Q&A Preparation
-
-### Expected Questions & Answers
-
-**Q: "How long did this take to build?"**
-A: "Single coding session. ~7,916 lines of production code, all AI-designed and implemented."
-
-**Q: "Did a human review the code?"**
-A: "No human code review. AI-designed architecture, implementation, and testing. Tests are all passing."
-
-**Q: "What about bugs?"**
-A: "0 known bugs at release. AI was careful with error handling, edge cases, and testing."
-
-**Q: "Is this just code generation?"**
-A: "No. This is system design, UX design, accessibility design, performance optimization, and aesthetic polish. The AI made every design decision."
-
-**Q: "How does the AI recommendation engine work?"**
-A: "Multi-criteria optimization considering task type, priority, time of day, and user satisfaction. It learns from feedback using exponential moving averages."
-
-**Q: "Why 9 accessibility modes?"**
-A: "Because different users have different needs. The AI designed these to cover visual, motor, cognitive, and sensory accessibility requirements."
-
-**Q: "The performance is impressive. How?"**
-A: "Zero-allocation hot paths, proper profiling, thread-safe design. The AI understood performance matters and designed for it from the start."
-
-**Q: "Can I try this?"**
-A: "Yes! It's open source. Binary is 19MB. Runs on Mac/Linux/Windows. [Provide link]"
-
-**Q: "What's next?"**
-A: "This is a demonstration of capability. The techniques and patterns used here can be applied to any software project."
-
----
-
-## 📝 Demo Tips
-
-### Before Demo
-- [ ] Build optimized binary (`go build -ldflags="-s -w"`)
-- [ ] Test all keyboard shortcuts
-- [ ] Prepare terminal with good font size
-- [ ] Have backup slides in case of technical issues
-- [ ] Practice timing (aim for 10-12 minutes)
-
-### During Demo
-- [ ] Speak clearly and enthusiastically
-- [ ] Pause after key reveals
-- [ ] Point to specific UI elements
-- [ ] Emphasize the "AI-designed" aspect
-- [ ] Show genuine excitement
-
-### After Demo
-- [ ] Invite questions
-- [ ] Be ready with code examples
-- [ ] Share repository link
-- [ ] Follow up with interested attendees
-
----
-
-## 🎯 Alternative Demo Formats
-
-### 5-Minute Lightning Talk
-- Opening (30s)
-- Intelligence demo (2m)
-- Performance demo (1m)
-- Accessibility demo (1m)
-- Closing revelation (30s)
-
-### 30-Minute Deep Dive
-- Add: Architecture walkthrough
-- Add: Live code exploration
-- Add: Design decision explanations
-- Add: More easter egg hunting
-- Add: Extended Q&A
-
-### Live Coding Session
-- Start from README
-- Walk through code structure
-- Explain key algorithms
-- Show test suite
-- Demonstrate debugging
-
----
-
-**Remember:** The goal isn't just to show features. It's to demonstrate that **AI can design software that's objectively superior to human-built alternatives** - and RyCode is the proof.
-
-Good luck! 🚀
diff --git a/packages/tui/DEPLOYMENT_READY.md b/packages/tui/DEPLOYMENT_READY.md
deleted file mode 100644
index 9d5d7dc9..00000000
--- a/packages/tui/DEPLOYMENT_READY.md
+++ /dev/null
@@ -1,344 +0,0 @@
-# RyCode TUI - Deployment Ready ✅
-
-> **Production-ready binary verified and tested**
->
-> Date: October 11, 2025
-> Version: Phase 3 Complete
-> Status: **READY FOR DEPLOYMENT** 🚀
-
----
-
-## 📦 Deployment Package
-
-### Binary Location
-```
-/tmp/rycode-production
-Size: 19MB (stripped)
-Platform: darwin/arm64 (M4 Max)
-Build: Optimized with -ldflags="-s -w"
-```
-
-### Production Build Command
-```bash
-cd packages/tui
-go build -ldflags="-s -w" -o rycode ./cmd/rycode
-```
-
-### Cross-Platform Builds
-```bash
-# macOS (Intel)
-GOOS=darwin GOARCH=amd64 go build -ldflags="-s -w" -o rycode-darwin-amd64 ./cmd/rycode
-
-# macOS (Apple Silicon)
-GOOS=darwin GOARCH=arm64 go build -ldflags="-s -w" -o rycode-darwin-arm64 ./cmd/rycode
-
-# Linux (x86_64)
-GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o rycode-linux-amd64 ./cmd/rycode
-
-# Linux (ARM64)
-GOOS=linux GOARCH=arm64 go build -ldflags="-s -w" -o rycode-linux-arm64 ./cmd/rycode
-
-# Windows (x86_64)
-GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o rycode-windows-amd64.exe ./cmd/rycode
-```
-
----
-
-## ✅ Pre-Deployment Checklist
-
-### Code Quality
-- ✅ **10/10 tests passing** - All unit tests verified
-- ✅ **0 known bugs** - No open issues
-- ✅ **TypeScript clean** - All auth system types validated
-- ✅ **Go build successful** - No compilation errors
-- ✅ **Git clean** - All changes committed and pushed
-
-### Performance Metrics
-- ✅ **60fps rendering** - Target achieved
-- ✅ **<100ns monitoring overhead** - Verified in benchmarks
-- ✅ **19MB binary size** - Under 20MB target
-- ✅ **Zero-allocation hot paths** - Performance optimized
-
-### Feature Completeness
-- ✅ **Phase 3A: Visual Excellence** - Complete
-- ✅ **Phase 3B: Intelligence Layer** - 4 AI features implemented
-- ✅ **Phase 3C: Provider Management** - Multi-provider support
-- ✅ **Phase 3D: Onboarding & Help** - 6-step flow + contextual help
-- ✅ **Phase 3E: Performance** - Real-time monitoring
-- ✅ **Phase 3F: Accessibility** - 9 modes implemented
-- ✅ **Phase 3G: Polish** - Easter eggs + micro-interactions
-- ✅ **Phase 3H: Documentation** - Complete showcase docs
-- ✅ **Phase 3I: UX Review** - Multi-agent peer review completed
-
-### Documentation
-- ✅ **README.md** (500+ lines) - Comprehensive overview
-- ✅ **FEATURE_HIGHLIGHTS.md** (550+ lines) - Technical deep dive
-- ✅ **DEMO_SCRIPT.md** (400+ lines) - Presentation guide
-- ✅ **PHASE_3_COMPLETE.md** (488 lines) - Development summary
-- ✅ **DEPLOYMENT_READY.md** (this file) - Deployment guide
-
----
-
-## 🚀 Deployment Steps
-
-### 1. Package Binary
-```bash
-# Create release directory
-mkdir -p releases/v1.0.0
-
-# Copy production binary
-cp /tmp/rycode-production releases/v1.0.0/rycode
-
-# Make executable
-chmod +x releases/v1.0.0/rycode
-
-# Create tarball
-cd releases/v1.0.0
-tar -czf ../rycode-v1.0.0-darwin-arm64.tar.gz rycode
-cd ../..
-```
-
-### 2. Generate Checksums
-```bash
-cd releases
-sha256sum rycode-v1.0.0-*.tar.gz > SHA256SUMS
-gpg --clearsign SHA256SUMS  # If using GPG signing
-cd ..
-```
-
-### 3. Create GitHub Release
-```bash
-gh release create v1.0.0 \
-  releases/rycode-v1.0.0-*.tar.gz \
-  releases/SHA256SUMS \
-  --title "RyCode TUI v1.0.0 - AI-Designed Excellence" \
-  --notes-file RELEASE_NOTES.md
-```
-
-### 4. Update Distribution Channels
-- [ ] Homebrew formula
-- [ ] GitHub Releases
-- [ ] Direct download site
-- [ ] Docker image (optional)
-
----
-
-## 📊 Final Metrics
-
-### Code Statistics
-```
-Production Code:    7,916 lines (Phase 3)
-Files Created:      27 files
-Packages:           7 packages
-Documentation:      1,938 lines
-Total:             ~9,854 lines
-```
-
-### Performance Benchmarks
-```
-Frame Cycle:        64ns  (0 allocs) ⚡️
-Component Render:   64ns  (0 allocs) ⚡️
-Get Metrics:        54ns  (1 alloc)  ⚡️
-Memory Snapshot:    21µs  (0 allocs) ⚡️
-```
-
-### Test Coverage
-```
-Performance Tests:  10/10 passing
-Unit Tests:         All green
-Integration:        Manual testing completed
-Accessibility:      9 modes verified
-```
-
-### Feature Metrics
-```
-Accessibility Modes:   9
-Keyboard Shortcuts:    30+
-AI Features:           4 (recommendations, budgeting, alerts, insights)
-Easter Eggs:           10+
-Provider Support:      5 (Anthropic, OpenAI, Google, Grok, Qwen)
-Onboarding Steps:      6
-Help Contexts:         Multiple
-```
-
----
-
-## 🎯 Post-Deployment
-
-### Monitoring
-- Track user feedback via GitHub issues
-- Monitor performance metrics if telemetry added
-- Watch for edge cases in production use
-
-### Support Channels
-- GitHub Issues: Primary support channel
-- Documentation: https://github.com/aaronmrosenthal/RyCode
-- Demo Script: Available for presentations
-
-### Future Enhancements
-Based on UX peer review, consider:
-1. Contextual tutorial system (progressive disclosure)
-2. Export features for usage data
-3. Theme customization UI
-4. Advanced search in help system
-5. Keyboard shortcut customization
-
----
-
-## 🔒 Security Considerations
-
-### Pre-Deployment Security Review
-- ✅ No hardcoded credentials
-- ✅ Input validation implemented
-- ✅ Rate limiting in place
-- ✅ Circuit breaker protection
-- ✅ API key masking
-- ✅ Audit logging
-- ✅ Secure credential storage
-
-### Security Features
-- **Audit Log**: All auth events tracked
-- **Rate Limiting**: Prevents abuse
-- **Circuit Breakers**: Provider health monitoring
-- **Input Validation**: Sanitization and format checking
-- **Credential Encryption**: Secure storage via Auth namespace
-
----
-
-## 📋 Release Notes Template
-
-```markdown
-# RyCode TUI v1.0.0 - AI-Designed Excellence
-
-> Built entirely by Claude AI to demonstrate what's possible when AI designs tools for humans.
-
-## 🎉 Highlights
-
-**What Makes RyCode Undeniably Superior:**
-- 60fps rendering with <100ns monitoring overhead
-- 9 accessibility modes built-in (not bolted on)
-- AI-powered model recommendations that learn from usage
-- Predictive budgeting with ML-style forecasting
-- 100% keyboard accessible (zero mouse required)
-- 10+ hidden easter eggs for delight
-- 19MB binary (smaller than most cat photos!)
-
-## 🚀 Features
-
-### Intelligence Layer
-- **AI Model Recommendations**: Multi-criteria optimization considering cost, quality, speed
-- **Predictive Budgeting**: ML-style spending forecasts with trend detection
-- **Smart Cost Alerts**: Proactive warnings before budget exceeded
-- **Usage Insights**: Beautiful ASCII charts with optimization suggestions
-
-### Accessibility
-- 9 comprehensive accessibility modes
-- 30+ keyboard shortcuts (Vim bindings included)
-- Screen reader support with announcements
-- High contrast mode (WCAG AA compliant)
-
-### Performance
-- Real-time 60fps rendering
-- <100ns monitoring overhead (virtually zero impact)
-- 19MB stripped binary
-- Zero-allocation hot paths
-
-### Polish
-- 6-step interactive onboarding
-- Contextual help system
-- 10+ hidden easter eggs
-- Milestone celebrations
-- Personality throughout
-
-## 📦 Installation
-
-### macOS (Homebrew)
-```bash
-brew tap aaronmrosenthal/rycode
-brew install rycode
-```
-
-### Direct Download
-Download the appropriate binary for your platform:
-- [macOS (Apple Silicon)](https://github.com/aaronmrosenthal/RyCode/releases/download/v1.0.0/rycode-darwin-arm64.tar.gz)
-- [macOS (Intel)](https://github.com/aaronmrosenthal/RyCode/releases/download/v1.0.0/rycode-darwin-amd64.tar.gz)
-- [Linux (x86_64)](https://github.com/aaronmrosenthal/RyCode/releases/download/v1.0.0/rycode-linux-amd64.tar.gz)
-- [Linux (ARM64)](https://github.com/aaronmrosenthal/RyCode/releases/download/v1.0.0/rycode-linux-arm64.tar.gz)
-- [Windows (x86_64)](https://github.com/aaronmrosenthal/RyCode/releases/download/v1.0.0/rycode-windows-amd64.zip)
-
-### From Source
-```bash
-git clone https://github.com/aaronmrosenthal/RyCode.git
-cd RyCode/packages/tui
-go build -ldflags="-s -w" -o rycode ./cmd/rycode
-./rycode
-```
-
-## 🎓 Quick Start
-
-1. Launch RyCode: `./rycode`
-2. Follow the 6-step onboarding (or press 'S' to skip)
-3. Press `Tab` to cycle models or `Ctrl+?` for all shortcuts
-4. Start coding with AI assistance!
-
-## 📚 Documentation
-
-- [Complete README](README.md)
-- [Feature Highlights](FEATURE_HIGHLIGHTS.md)
-- [Demo Script](DEMO_SCRIPT.md)
-- [Phase 3 Summary](PHASE_3_COMPLETE.md)
-
-## 🤖 The AI-Designed Difference
-
-RyCode was built entirely by Claude AI in extended development sessions. Every feature, every line of code, every design decision - 100% AI-designed with:
-- **Empathy** for diverse users
-- **Intelligence** for smart features
-- **Performance** obsession
-- **Polish** in every interaction
-- **Accessibility** from day one
-
-This is what happens when AI designs tools for humans with care and attention to detail.
-
-## 🙏 Acknowledgments
-
-**Built by:** Claude (Anthropic's AI assistant)
-**Philosophy:** AI-designed software should be accessible, performant, and delightful
-
-## 📝 License
-
-MIT License - See [LICENSE](../../LICENSE) for details
-
----
-
-**🤖 100% AI-Designed. 0% Compromises. ∞ Attention to Detail.**
-
-*Built with ❤️ by Claude AI*
-```
-
----
-
-## ✅ Deployment Approved
-
-**Status:** READY FOR PRODUCTION
-
-**Approved By:** Phase 3 Complete
-**Date:** October 11, 2025
-**Version:** 1.0.0
-
-**Next Steps:**
-1. Create release tags
-2. Build cross-platform binaries
-3. Generate checksums
-4. Publish to GitHub Releases
-5. Update documentation links
-6. Announce release
-
----
-
-<div align="center">
-
-**🚀 Ready to Ship! 🚀**
-
-All systems go. RyCode TUI is production-ready and demonstrates what's possible when AI designs software with empathy, intelligence, and obsessive attention to detail.
-
-</div>
diff --git a/packages/tui/DEVELOPER_ONBOARDING.md b/packages/tui/DEVELOPER_ONBOARDING.md
deleted file mode 100644
index cdf75e4b..00000000
--- a/packages/tui/DEVELOPER_ONBOARDING.md
+++ /dev/null
@@ -1,696 +0,0 @@
-# Developer Onboarding: Theme-Aware Development
-
-**Welcome! This guide will get you up to speed on developing theme-aware components for RyCode.**
-
----
-
-## Quick Start (5 minutes)
-
-### 1. Understanding the Basics
-
-RyCode has a dynamic theming system that switches the entire UI based on the active AI provider:
-
-```
-Tab → Provider Changes → Theme Switches → UI Updates
-```
-
-**4 Built-in Themes**:
-- 🟠 **Claude** - Warm copper orange
-- 🔵 **Gemini** - Blue-pink gradient
-- 🟢 **Codex** - OpenAI teal
-- 🟠 **Qwen** - Alibaba orange
-
-### 2. Your First Themed Component
-
-```go
-package mycomponent
-
-import (
-    "github.com/aaronmrosenthal/rycode/internal/theme"
-    "github.com/charmbracelet/lipgloss/v2"
-)
-
-func HelloWorld() string {
-    // Step 1: Get current theme
-    t := theme.CurrentTheme()
-
-    // Step 2: Use theme colors
-    style := lipgloss.NewStyle().
-        Foreground(t.Primary()).      // Provider's brand color
-        Background(t.Background()).    // Dark background
-        Padding(1)
-
-    // Step 3: Render
-    return style.Render("Hello, themed world!")
-}
-```
-
-**That's it!** Your component now automatically adapts when users switch providers.
-
-### 3. Test It
-
-```bash
-# Build RyCode
-go build -o rycode ./cmd/rycode
-
-# Run it
-./rycode
-
-# Press Tab to cycle through providers
-# Watch your component change colors!
-```
-
----
-
-## Core Concepts (10 minutes)
-
-### The Theme Interface
-
-Every theme provides these colors:
-
-```go
-type Theme interface {
-    // Brand colors
-    Primary()   // Main brand color (borders, highlights)
-    Accent()    // Hover states, focus indicators
-
-    // Backgrounds
-    Background()      // Main background
-    BackgroundPanel() // Panels, cards, messages
-
-    // Text
-    Text()       // Primary text (12-16:1 contrast!)
-    TextMuted()  // Secondary text
-
-    // Status
-    Success()    // Green
-    Error()      // Red
-    Warning()    // Yellow/amber
-    Info()       // Blue or primary
-
-    // And 40+ more colors for markdown, diffs, etc.
-}
-```
-
-### How Theme Switching Works
-
-```
-1. User presses Tab
-2. Model selector changes provider
-3. theme.SwitchToProvider("gemini") is called
-4. ThemeManager swaps the current theme pointer (317ns!)
-5. Next frame, components call theme.CurrentTheme()
-6. Components get new theme, render with new colors
-7. User sees Gemini's blue aesthetic
-```
-
-**Performance**: Theme switching is 317ns (0.000317 milliseconds) - imperceptibly fast!
-
-### The Golden Rule
-
-> **NEVER cache themes. Always call `CurrentTheme()` when rendering.**
-
-```go
-// ✅ CORRECT - Gets current theme each render
-func (m *Model) View() string {
-    t := theme.CurrentTheme()
-    return lipgloss.NewStyle().Foreground(t.Primary()).Render(m.text)
-}
-
-// ❌ WRONG - Cached theme won't update
-func (m *Model) Init() tea.Cmd {
-    m.cachedTheme = theme.CurrentTheme() // This won't update!
-    return nil
-}
-
-func (m *Model) View() string {
-    // Still using old theme even after provider switch!
-    return lipgloss.NewStyle().Foreground(m.cachedTheme.Primary()).Render(m.text)
-}
-```
-
-**Why?** `CurrentTheme()` is only 6ns - caching provides zero benefit and breaks theme switching.
-
----
-
-## Common Patterns (15 minutes)
-
-### Pattern 1: Basic Styling
-
-```go
-func RenderTitle(text string) string {
-    t := theme.CurrentTheme()
-
-    style := lipgloss.NewStyle().
-        Foreground(t.Primary()).
-        Bold(true).
-        MarginBottom(1)
-
-    return style.Render(text)
-}
-```
-
-### Pattern 2: Bordered Box
-
-```go
-func RenderBox(content string) string {
-    t := theme.CurrentTheme()
-
-    style := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Border()).
-        Background(t.BackgroundPanel()).
-        Foreground(t.Text()).
-        Padding(1)
-
-    return style.Render(content)
-}
-```
-
-### Pattern 3: Status Indicator
-
-```go
-func RenderStatus(status string, message string) string {
-    t := theme.CurrentTheme()
-
-    var color compat.AdaptiveColor
-    var icon string
-
-    switch status {
-    case "success":
-        color = t.Success()
-        icon = "✓"
-    case "error":
-        color = t.Error()
-        icon = "✗"
-    case "warning":
-        color = t.Warning()
-        icon = "⚠"
-    default:
-        color = t.Info()
-        icon = "ℹ"
-    }
-
-    iconStyle := lipgloss.NewStyle().Foreground(color)
-    textStyle := lipgloss.NewStyle().Foreground(t.Text())
-
-    return iconStyle.Render(icon + " ") + textStyle.Render(message)
-}
-```
-
-### Pattern 4: Provider-Specific Features
-
-Some themes have special features (spinners, ASCII art, welcome messages):
-
-```go
-func RenderWelcome() string {
-    t := theme.CurrentTheme()
-
-    // Type assertion to access provider-specific features
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        // Use provider's custom welcome message
-        return providerTheme.WelcomeMessage
-    }
-
-    // Fallback for non-provider themes
-    return "Welcome to RyCode!"
-}
-```
-
-**When to use**: Loading spinners, typing indicators, welcome screens, ASCII art
-
-**Example** (see `internal/components/spinner/spinner.go`):
-```go
-func GetProviderSpinnerFrames(t theme.Theme) []string {
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        spinnerStr := providerTheme.LoadingSpinner
-        if spinnerStr != "" {
-            frames := []string{}
-            for _, r := range spinnerStr {
-                frames = append(frames, string(r))
-            }
-            return frames
-        }
-    }
-    // Fallback to default spinner
-    return DefaultSpinnerFrames
-}
-```
-
----
-
-## Bubble Tea Integration (10 minutes)
-
-### Bubble Tea Model Pattern
-
-```go
-type MyModel struct {
-    content string
-}
-
-func (m MyModel) Init() tea.Cmd {
-    return nil
-}
-
-func (m MyModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    switch msg := msg.(type) {
-    case tea.KeyMsg:
-        if msg.String() == "q" {
-            return m, tea.Quit
-        }
-    }
-    return m, nil
-}
-
-func (m MyModel) View() string {
-    // ✅ Get theme on every render
-    t := theme.CurrentTheme()
-
-    style := lipgloss.NewStyle().
-        Foreground(t.Primary()).
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Border()).
-        Padding(1)
-
-    return style.Render(m.content)
-}
-```
-
-### Responding to Theme Changes
-
-Theme changes happen automatically - you don't need to listen for events!
-
-```
-User presses Tab
-  ↓
-Provider changes
-  ↓
-theme.SwitchToProvider() called
-  ↓
-Next frame renders
-  ↓
-Your View() method calls CurrentTheme()
-  ↓
-You get new theme automatically!
-```
-
-**No special handling needed** - just call `CurrentTheme()` in your `View()` method.
-
----
-
-## Real-World Examples (20 minutes)
-
-### Example 1: Chat Message Bubble
-
-```go
-func RenderMessage(isUser bool, text string) string {
-    t := theme.CurrentTheme()
-
-    var style lipgloss.Style
-    if isUser {
-        // User messages: subtle background
-        style = lipgloss.NewStyle().
-            Background(t.BackgroundPanel()).
-            Foreground(t.Text()).
-            Padding(1).
-            MarginBottom(1)
-    } else {
-        // AI messages: bordered
-        style = lipgloss.NewStyle().
-            Border(lipgloss.RoundedBorder()).
-            BorderForeground(t.Border()).
-            Background(t.Background()).
-            Foreground(t.Text()).
-            Padding(1).
-            MarginBottom(1)
-    }
-
-    return style.Render(text)
-}
-```
-
-### Example 2: Progress Bar
-
-```go
-func RenderProgressBar(progress float64, label string) string {
-    t := theme.CurrentTheme()
-
-    width := 40
-    filled := int(progress * float64(width))
-
-    // Filled portion
-    filledStyle := lipgloss.NewStyle().Foreground(t.Primary())
-    filledBar := filledStyle.Render(strings.Repeat("█", filled))
-
-    // Empty portion
-    emptyStyle := lipgloss.NewStyle().Foreground(t.BorderSubtle())
-    emptyBar := emptyStyle.Render(strings.Repeat("░", width-filled))
-
-    // Label
-    labelStyle := lipgloss.NewStyle().
-        Foreground(t.Text()).
-        MarginRight(1)
-
-    // Percentage
-    pctStyle := lipgloss.NewStyle().
-        Foreground(t.TextMuted()).
-        MarginLeft(1)
-
-    return fmt.Sprintf("%s[%s%s]%s",
-        labelStyle.Render(label),
-        filledBar,
-        emptyBar,
-        pctStyle.Render(fmt.Sprintf("%.0f%%", progress*100)),
-    )
-}
-```
-
-### Example 3: Error Dialog
-
-```go
-func RenderErrorDialog(title, message string) string {
-    t := theme.CurrentTheme()
-
-    // Dialog border (red for errors)
-    dialogStyle := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Error()).
-        Background(t.BackgroundPanel()).
-        Padding(1, 2).
-        Width(60)
-
-    // Error title
-    titleStyle := lipgloss.NewStyle().
-        Foreground(t.Error()).
-        Bold(true).
-        Render("✗ " + title)
-
-    // Error message
-    messageStyle := lipgloss.NewStyle().
-        Foreground(t.Text()).
-        Width(56).
-        Render(message)
-
-    // Close instruction
-    closeStyle := lipgloss.NewStyle().
-        Foreground(t.TextMuted()).
-        Align(lipgloss.Right).
-        Width(56).
-        Render("Press ESC to close")
-
-    content := lipgloss.JoinVertical(lipgloss.Left,
-        titleStyle,
-        "",
-        messageStyle,
-        "",
-        closeStyle,
-    )
-
-    return dialogStyle.Render(content)
-}
-```
-
----
-
-## Testing Your Components (10 minutes)
-
-### Manual Testing
-
-```bash
-# 1. Build RyCode
-go build -o rycode ./cmd/rycode
-
-# 2. Run it
-./rycode
-
-# 3. Test theme switching
-# Press Tab multiple times to cycle through providers
-
-# 4. Verify your component:
-#    - Colors change with provider
-#    - No visual artifacts
-#    - Borders/text remain readable
-#    - Layout stays consistent
-```
-
-### Automated Testing
-
-#### Test Color Accuracy
-
-```bash
-go run test_theme_visual_verification.go
-```
-
-**Expected**: All 56 tests pass (14 per theme)
-
-#### Test Accessibility
-
-```bash
-go run test_theme_accessibility.go
-```
-
-**Expected**: All 48 tests pass (100% WCAG AA compliance)
-
-#### Test Performance
-
-```bash
-go run test_theme_performance.go
-```
-
-**Expected**: Theme switching < 10ms (typically ~317ns)
-
----
-
-## Common Mistakes (5 minutes)
-
-### Mistake 1: Caching Themes
-
-```go
-// ❌ WRONG
-type Model struct {
-    theme theme.Theme // Don't store themes!
-}
-
-func (m *Model) Init() tea.Cmd {
-    m.theme = theme.CurrentTheme()
-    return nil
-}
-
-// ✅ CORRECT
-func (m *Model) View() string {
-    t := theme.CurrentTheme() // Get it fresh every time
-    // ... use t
-}
-```
-
-**Why it's wrong**: Cached theme doesn't update when user switches providers.
-
----
-
-### Mistake 2: Hardcoding Colors
-
-```go
-// ❌ WRONG
-style := lipgloss.NewStyle().Foreground(lipgloss.Color("#FF0000"))
-
-// ✅ CORRECT
-t := theme.CurrentTheme()
-style := lipgloss.NewStyle().Foreground(t.Error())
-```
-
-**Why it's wrong**: Hardcoded colors don't adapt to theme, break visual consistency.
-
----
-
-### Mistake 3: Ignoring Accessibility
-
-```go
-// ❌ WRONG - Low contrast
-style := lipgloss.NewStyle().
-    Background(lipgloss.Color("#333333")).
-    Foreground(lipgloss.Color("#555555")) // Only 1.4:1 contrast!
-
-// ✅ CORRECT - Use theme colors (all tested for WCAG AA)
-t := theme.CurrentTheme()
-style := lipgloss.NewStyle().
-    Background(t.Background()).
-    Foreground(t.Text()) // 12-16:1 contrast!
-```
-
-**Why it's wrong**: Low contrast text is hard/impossible to read for many users.
-
----
-
-### Mistake 4: Not Testing All Themes
-
-```go
-// Only testing with Claude theme
-// What if Gemini theme breaks?
-```
-
-**Fix**: Test with all 4 themes:
-
-```bash
-# Manually
-./rycode
-# Press Tab 3 times to test all themes
-
-# Automatically
-go run test_theme_visual_verification.go
-```
-
----
-
-## Development Workflow (5 minutes)
-
-### Step-by-Step
-
-1. **Write your component**
-   ```go
-   func MyComponent() string {
-       t := theme.CurrentTheme()
-       // ... use t
-   }
-   ```
-
-2. **Test manually**
-   ```bash
-   go run ./cmd/rycode
-   # Press Tab to cycle themes
-   ```
-
-3. **Run automated tests**
-   ```bash
-   go run test_theme_accessibility.go
-   go run test_theme_visual_verification.go
-   ```
-
-4. **Commit**
-   ```bash
-   git add .
-   git commit -m "feat: Add MyComponent with theme support"
-   ```
-
----
-
-## Quick Reference
-
-### Essential Commands
-
-```bash
-# Build
-go build -o rycode ./cmd/rycode
-
-# Run
-./rycode
-
-# Test accessibility
-go run test_theme_accessibility.go
-
-# Test colors
-go run test_theme_visual_verification.go
-
-# Test performance
-go run test_theme_performance.go
-```
-
-### Essential Code
-
-```go
-// Get theme
-t := theme.CurrentTheme()
-
-// Use colors
-primary := t.Primary()
-text := t.Text()
-background := t.Background()
-
-// Switch theme
-theme.SwitchToProvider("gemini")
-
-// Provider-specific features
-if pt, ok := t.(*theme.ProviderTheme); ok {
-    message := pt.WelcomeMessage
-}
-```
-
-### Essential Colors
-
-```go
-t.Primary()          // Brand color (borders, highlights)
-t.Accent()           // Hover, focus
-t.Background()       // Main background
-t.BackgroundPanel()  // Panels, cards
-t.Text()             // Primary text (12-16:1 contrast)
-t.TextMuted()        // Secondary text
-t.Success()          // Green
-t.Error()            // Red
-t.Warning()          // Yellow
-t.Info()             // Blue
-```
-
----
-
-## Next Steps
-
-### Beginner
-
-1. ✅ Read this guide
-2. ✅ Write a simple themed component
-3. ✅ Test with Tab key
-4. 📚 Read [THEME_CUSTOMIZATION_GUIDE.md](./THEME_CUSTOMIZATION_GUIDE.md)
-
-### Intermediate
-
-1. ✅ Build complex themed UIs
-2. ✅ Use provider-specific features
-3. ✅ Write custom themes
-4. 📚 Read [THEME_API_REFERENCE.md](./THEME_API_REFERENCE.md)
-
-### Advanced
-
-1. ✅ Contribute to theme system
-2. ✅ Optimize theme performance
-3. ✅ Create theme marketplace entries
-4. 📚 Read [VISUAL_DESIGN_SYSTEM.md](./VISUAL_DESIGN_SYSTEM.md)
-
----
-
-## Resources
-
-### Documentation
-- [THEME_CUSTOMIZATION_GUIDE.md](./THEME_CUSTOMIZATION_GUIDE.md) - Complete guide
-- [THEME_API_REFERENCE.md](./THEME_API_REFERENCE.md) - API docs
-- [VISUAL_DESIGN_SYSTEM.md](./VISUAL_DESIGN_SYSTEM.md) - Design patterns
-- [DYNAMIC_THEMING_SPEC.md](./DYNAMIC_THEMING_SPEC.md) - Original spec
-
-### Testing
-- `test_theme_accessibility.go` - Accessibility audit (48 tests)
-- `test_theme_visual_verification.go` - Color verification (56 tests)
-- `test_theme_performance.go` - Performance benchmark (5 tests)
-
-### Examples
-- `internal/components/spinner/spinner.go` - Provider-specific spinners
-- `internal/components/chat/message.go` - Themed typing indicators
-- `internal/components/help/empty_state.go` - Provider welcome messages
-
----
-
-## Get Help
-
-- **GitHub Issues**: https://github.com/aaronmrosenthal/RyCode/issues
-- **Documentation**: https://rycode.ai/docs/theming
-- **Ask the team**: We're here to help!
-
----
-
-## Welcome Aboard! 🚀
-
-You're now ready to build beautiful, theme-aware components for RyCode. Remember:
-
-1. **Always use `CurrentTheme()`** - Never cache
-2. **Test all 4 themes** - Press Tab!
-3. **Check accessibility** - Run the audit
-4. **Have fun!** - Theming is delightful
-
-Happy coding! 🎨
diff --git a/packages/tui/DYNAMIC_THEMING_SPEC.md b/packages/tui/DYNAMIC_THEMING_SPEC.md
deleted file mode 100644
index 30d78685..00000000
--- a/packages/tui/DYNAMIC_THEMING_SPEC.md
+++ /dev/null
@@ -1,572 +0,0 @@
-# Dynamic Provider Theming Specification
-
-**Vision**: When users Tab between models, the entire TUI theme switches to match that provider's native CLI aesthetic. Users familiar with Claude Code, Gemini CLI, Codex, or Qwen CLI will instantly feel at home.
-
----
-
-## User Story
-
-> "As a developer who uses Claude Code daily, when I Tab to Claude models in RyCode, I want the interface to look and feel like Claude Code - warm orange borders, copper accents, and familiar typography. When I Tab to Gemini, I want the vibrant blue-pink gradient and colorful aesthetic I know from Gemini CLI."
-
----
-
-## Provider Theme Definitions
-
-### 1. Claude Theme (Based on Screenshots)
-
-**Brand Identity**: Warm, approachable, developer-friendly
-
-**Color Palette**:
-```go
-ClaudeTheme := theme.ProviderTheme{
-    Name: "Claude",
-
-    // Primary accents - warm orange/copper
-    Primary:   "#D4754C", // Copper orange (borders, highlights)
-    Secondary: "#B85C3C", // Darker copper
-    Accent:    "#F08C5C", // Lighter warm orange
-
-    // Background - dark warm
-    Background:        "#1A1816", // Warm dark brown
-    BackgroundPanel:   "#2C2622", // Slightly lighter panel
-    BackgroundElement: "#3A3330", // Element backgrounds
-
-    // Borders - distinctive orange
-    BorderSubtle: "#4A3F38",
-    Border:       "#D4754C", // Signature copper
-    BorderActive: "#F08C5C", // Bright on focus
-
-    // Text - warm tones
-    Text:      "#E8D5C4", // Warm cream
-    TextMuted: "#9C8373", // Muted warm gray
-
-    // Status colors
-    Success: "#6FA86F", // Muted green
-    Error:   "#D47C7C", // Warm red
-    Info:    "#D4754C", // Use primary
-    Warning: "#E8A968", // Warm amber
-
-    // Special - avatar background
-    AvatarBg: "#D4754C",
-}
-```
-
-**Typography**:
-- Friendly, readable monospace
-- Slightly rounded edges on panels
-- Warm, inviting spacing
-
-**UI Elements**:
-- Orange border on active input
-- Copper-colored model badges
-- Warm glow on hover states
-- Friendly avatar (pixelated character)
-
----
-
-### 2. Gemini Theme (Based on Screenshot)
-
-**Brand Identity**: Modern, vibrant, AI-forward
-
-**Color Palette**:
-```go
-GeminiTheme := theme.ProviderTheme{
-    Name: "Gemini",
-
-    // Primary accents - Google blue to pink gradient
-    Primary:   "#4285F4", // Google blue
-    Secondary: "#9B72F2", // Purple midpoint
-    Accent:    "#EA4335", // Google red/pink
-
-    // Background - cool dark
-    Background:        "#0D0D0D", // Pure black
-    BackgroundPanel:   "#1A1A1A", // Dark gray
-    BackgroundElement: "#2A2A2A", // Element backgrounds
-
-    // Borders - gradient inspired
-    BorderSubtle: "#2A2A45",
-    Border:       "#4285F4", // Blue primary
-    BorderActive: "#9B72F2", // Purple on focus
-
-    // Text - cool tones
-    Text:      "#E8EAED", // Light gray
-    TextMuted: "#9AA0A6", // Medium gray
-
-    // Status colors - vibrant
-    Success: "#34A853", // Google green
-    Error:   "#EA4335", // Google red
-    Info:    "#4285F4", // Blue
-    Warning: "#FBBC04", // Google yellow
-
-    // Special - gradient for ASCII art
-    GradientStart: "#4285F4", // Blue
-    GradientMid:   "#9B72F2", // Purple
-    GradientEnd:   "#EA4335", // Pink/red
-}
-```
-
-**Typography**:
-- Modern, sharp monospace
-- Clean, minimal spacing
-- Tech-forward aesthetic
-
-**UI Elements**:
-- Gradient border on panels
-- Colorful ASCII art logo
-- Blue-purple-pink gradient on active elements
-- "Thinking" indicator with gradient animation
-- Progress bars with gradient fill
-
----
-
-### 3. Codex Theme (OpenAI)
-
-**Brand Identity**: Professional, technical, precise
-
-**Color Palette**:
-```go
-CodexTheme := theme.ProviderTheme{
-    Name: "Codex",
-
-    // Primary accents - OpenAI teal
-    Primary:   "#10A37F", // OpenAI teal
-    Secondary: "#0D8569", // Darker teal
-    Accent:    "#1FC2AA", // Lighter teal
-
-    // Background - neutral dark
-    Background:        "#0E0E0E", // Almost black
-    BackgroundPanel:   "#1C1C1C", // Dark gray
-    BackgroundElement: "#2D2D2D", // Element backgrounds
-
-    // Borders - teal accent
-    BorderSubtle: "#2D3D38",
-    Border:       "#10A37F", // Teal
-    BorderActive: "#1FC2AA", // Bright teal
-
-    // Text - clean neutrals
-    Text:      "#ECECEC", // Off-white
-    TextMuted: "#8E8E8E", // Medium gray
-
-    // Status colors
-    Success: "#10A37F", // Use primary
-    Error:   "#EF4444", // Clean red
-    Info:    "#3B82F6", // Blue
-    Warning: "#F59E0B", // Amber
-
-    // Special - technical feel
-    CodeBlock: "#1C2D27", // Dark teal tint
-}
-```
-
-**Typography**:
-- Technical, precise monospace
-- Tight, efficient spacing
-- Professional aesthetic
-
-**UI Elements**:
-- Clean teal borders
-- Minimalist badges
-- Technical progress indicators
-- Code-first interface design
-
----
-
-### 4. Qwen Theme (Alibaba)
-
-**Brand Identity**: Modern, innovative, Chinese tech aesthetic
-
-**Color Palette**:
-```go
-QwenTheme := theme.ProviderTheme{
-    Name: "Qwen",
-
-    // Primary accents - Alibaba orange
-    Primary:   "#FF6A00", // Alibaba orange
-    Secondary: "#E55D00", // Darker orange
-    Accent:    "#FF8533", // Lighter orange
-
-    // Background - warm dark
-    Background:        "#161410", // Warm black
-    BackgroundPanel:   "#221E18", // Dark warm gray
-    BackgroundElement: "#2F2A22", // Element backgrounds
-
-    // Borders - orange accent
-    BorderSubtle: "#3A352C",
-    Border:       "#FF6A00", // Orange
-    BorderActive: "#FF8533", // Bright orange
-
-    // Text - neutral with warm tint
-    Text:      "#F0E8DC", // Warm off-white
-    TextMuted: "#A0947C", // Warm gray
-
-    // Status colors
-    Success: "#52C41A", // Chinese green
-    Error:   "#FF4D4F", // Chinese red
-    Info:    "#1890FF", // Chinese blue
-    Warning: "#FAAD14", // Chinese gold
-
-    // Special - Chinese design elements
-    Accent2: "#FAAD14", // Gold accent
-}
-```
-
-**Typography**:
-- Modern, international monospace
-- Balanced spacing
-- Contemporary aesthetic
-
-**UI Elements**:
-- Orange/gold color scheme
-- Modern Chinese design language
-- Clean, international interface
-- Elegant progress animations
-
----
-
-## Implementation Architecture
-
-### 1. Theme Structure
-
-```go
-// packages/tui/internal/theme/provider_themes.go
-
-package theme
-
-type ProviderTheme struct {
-    Name string
-
-    // Implement Theme interface
-    BaseTheme
-
-    // Provider-specific extensions
-    LogoASCII       string
-    LoadingSpinner  string
-    WelcomeMessage  string
-    TypingIndicator TypingStyle
-}
-
-type TypingStyle struct {
-    Text      string // "Thinking..." or "Processing..."
-    Animation string // "dots", "gradient", "pulse"
-    Color     string // Override for typing indicator
-}
-```
-
-### 2. Theme Manager
-
-```go
-// packages/tui/internal/theme/manager.go
-
-type ThemeManager struct {
-    themes         map[string]ProviderTheme
-    currentTheme   ProviderTheme
-    previousTheme  ProviderTheme
-
-    // Animation
-    transitionDuration time.Duration
-    transitionEasing   string
-}
-
-func (tm *ThemeManager) SwitchToProvider(providerID string) {
-    newTheme := tm.themes[providerID]
-
-    // Animate transition
-    tm.animateTransition(tm.currentTheme, newTheme)
-
-    // Update current
-    tm.previousTheme = tm.currentTheme
-    tm.currentTheme = newTheme
-
-    // Emit event for UI updates
-    tm.emitThemeChanged(newTheme)
-}
-
-func (tm *ThemeManager) animateTransition(from, to ProviderTheme) {
-    // Crossfade borders
-    // Morph colors
-    // Smooth gradient transition
-    // 200-300ms transition
-}
-```
-
-### 3. Model Selector Integration
-
-```go
-// packages/tui/internal/components/modelselector/modelselector.go
-
-func (m *Model) switchProvider(providerID string) {
-    // Switch model
-    m.selectedProvider = providerID
-
-    // TRIGGER THEME CHANGE
-    m.themeManager.SwitchToProvider(providerID)
-
-    // Update UI
-    m.updateView()
-}
-```
-
-### 4. View Updates
-
-Every component that renders visual elements needs to react to theme changes:
-
-```go
-// packages/tui/internal/components/chat/messages.go
-
-func (m *Model) View() string {
-    // Get current theme
-    theme := m.themeManager.CurrentTheme()
-
-    // Apply theme colors
-    borderStyle := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(theme.Border())
-
-    // Render with current theme
-    return borderStyle.Render(m.content)
-}
-```
-
----
-
-## Visual Transitions
-
-### Theme Switch Animation
-
-```
-1. User presses Tab
-2. Model selector advances to next provider
-3. ThemeManager detects provider change
-4. Crossfade animation begins (200ms):
-   - Borders morph from old color to new
-   - Background subtly shifts tone
-   - Text colors smoothly transition
-   - Logo/ASCII art fades in
-5. New theme fully applied
-6. User sees familiar provider aesthetic
-```
-
-### Example: Claude → Gemini Transition
-
-```
-Frame 1 (0ms):   Claude theme (orange borders)
-Frame 2 (50ms):  Borders fade to purple
-Frame 3 (100ms): Background shifts cooler
-Frame 4 (150ms): Gemini colors emerge
-Frame 5 (200ms): Gemini theme (blue-pink gradient)
-```
-
----
-
-## UI Elements Affected
-
-### 1. Borders
-- Main chat border
-- Input box border
-- Model selector border
-- Panel borders
-
-### 2. Badges
-- Active model badge color
-- Provider indicators
-- Status badges
-
-### 3. Text Colors
-- Primary text (subtle tint)
-- Secondary text
-- Muted text
-- Highlights
-
-### 4. Special Elements
-- Loading spinner (provider-specific animation)
-- Typing indicator (matches provider style)
-- Welcome screen (provider-specific ASCII art)
-- Error messages (provider color scheme)
-
-### 5. Interactive Elements
-- Button hover states
-- Focus indicators
-- Selection highlights
-- Progress bars
-
----
-
-## Playwright Visual Testing
-
-### Test Suite
-
-```typescript
-// packages/tui/tests/visual/theme-switching.spec.ts
-
-import { test, expect } from '@playwright/test';
-
-test.describe('Provider Theme Switching', () => {
-
-  test('Claude theme matches native CLI', async ({ page }) => {
-    // Launch RyCode with Claude
-    await page.goto('rycode://claude');
-
-    // Capture screenshot
-    await page.screenshot({
-      path: 'tests/visual/snapshots/claude-theme.png'
-    });
-
-    // Compare with reference
-    await expect(page).toHaveScreenshot('claude-reference.png', {
-      threshold: 0.1, // 10% tolerance
-    });
-
-    // Verify orange borders
-    const border = await page.locator('.chat-border');
-    const borderColor = await border.evaluate(
-      el => getComputedStyle(el).borderColor
-    );
-    expect(borderColor).toContain('212, 117, 76'); // #D4754C RGB
-  });
-
-  test('Theme switches on Tab', async ({ page }) => {
-    await page.goto('rycode://claude');
-
-    // Capture initial state
-    const claudeScreenshot = await page.screenshot();
-
-    // Press Tab to switch to Gemini
-    await page.keyboard.press('Tab');
-    await page.waitForTimeout(250); // Wait for transition
-
-    // Capture new state
-    const geminiScreenshot = await page.screenshot();
-
-    // Screenshots should be different
-    expect(claudeScreenshot).not.toEqual(geminiScreenshot);
-
-    // Verify Gemini colors
-    const border = await page.locator('.chat-border');
-    const borderColor = await border.evaluate(
-      el => getComputedStyle(el).borderColor
-    );
-    expect(borderColor).toContain('66, 133, 244'); // #4285F4 RGB
-  });
-
-  test('Smooth transition animation', async ({ page }) => {
-    await page.goto('rycode://claude');
-
-    // Record transition frames
-    const frames = [];
-    page.on('framenavigated', () => {
-      frames.push(page.screenshot());
-    });
-
-    await page.keyboard.press('Tab');
-    await page.waitForTimeout(300);
-
-    // Should have intermediate frames (smooth animation)
-    expect(frames.length).toBeGreaterThan(3);
-  });
-
-  test('All providers have distinct themes', async ({ page }) => {
-    const screenshots = {};
-
-    for (const provider of ['claude', 'gemini', 'codex', 'qwen']) {
-      await page.goto(`rycode://${provider}`);
-      screenshots[provider] = await page.screenshot();
-    }
-
-    // All screenshots should be unique
-    const hashes = Object.values(screenshots).map(img => hash(img));
-    const uniqueHashes = new Set(hashes);
-    expect(uniqueHashes.size).toBe(4);
-  });
-});
-```
-
----
-
-## Implementation Phases
-
-### Phase 1: Theme Infrastructure (Week 1)
-- [ ] Create `ProviderTheme` struct
-- [ ] Implement `ThemeManager` with hot-swapping
-- [ ] Define all 4 provider themes
-- [ ] Add theme switching logic to model selector
-- [ ] Basic color transitions (no animations)
-
-### Phase 2: Visual Polish (Week 2)
-- [ ] Add transition animations (200ms crossfade)
-- [ ] Provider-specific ASCII art
-- [ ] Custom loading spinners per provider
-- [ ] Provider-specific typing indicators
-- [ ] Welcome screen variants
-
-### Phase 3: Testing & Refinement (Week 3)
-- [ ] Playwright visual regression tests
-- [ ] Screenshot comparison with native CLIs
-- [ ] Performance optimization (GPU acceleration)
-- [ ] Accessibility audit (color contrast)
-- [ ] User testing with developers familiar with each CLI
-
-### Phase 4: Documentation (Week 4)
-- [ ] Theme customization guide
-- [ ] Custom provider theme API
-- [ ] Visual design system docs
-- [ ] Developer onboarding (theme-aware)
-
----
-
-## Success Criteria
-
-### User Experience
-- ✅ Users familiar with Claude Code immediately recognize Claude theme
-- ✅ Gemini users see familiar blue-pink gradients and colorful aesthetic
-- ✅ Theme switch on Tab feels instant and smooth (<300ms)
-- ✅ Each provider theme has distinct personality
-- ✅ Transitions are delightful, not jarring
-
-### Technical
-- ✅ Theme switching has no performance impact
-- ✅ All colors meet WCAG AA contrast standards
-- ✅ Visual tests catch theme regressions
-- ✅ Themes load instantly (no flicker)
-
-### Design
-- ✅ Matches native CLI aesthetics (Playwright verified)
-- ✅ Consistent design language within each theme
-- ✅ Cohesive color palette per provider
-- ✅ Professional, polished appearance
-
----
-
-## Future Enhancements
-
-### Custom Themes
-Allow users to create custom provider themes:
-
-```json
-{
-  "name": "My Custom Theme",
-  "provider": "claude",
-  "extends": "claude-base",
-  "colors": {
-    "primary": "#FF00FF",
-    "background": "#000000"
-  }
-}
-```
-
-### Theme Marketplace
-- Community-contributed themes
-- Seasonal themes (dark mode variants)
-- High-contrast accessibility themes
-
-### Advanced Animations
-- Particle effects on theme switch
-- Ripple transitions from cursor position
-- Provider logo morphing animations
-
----
-
-## Notes
-
-This specification brings **emotional design** to RyCode. When a developer who loves Claude Code sees the familiar warm orange borders and copper accents, they'll feel at home instantly. The theme becomes part of the tool's personality, making it memorable and delightful to use.
-
-The key insight: **familiarity breeds confidence**. By matching the native CLI aesthetics, we reduce cognitive load and make Tab-switching feel like moving between trusted tools, not switching contexts entirely.
diff --git a/packages/tui/E2E_TEST_HELLO_ALL.md b/packages/tui/E2E_TEST_HELLO_ALL.md
deleted file mode 100644
index 5f67f3c7..00000000
--- a/packages/tui/E2E_TEST_HELLO_ALL.md
+++ /dev/null
@@ -1,348 +0,0 @@
-# E2E Test: Hello All Providers
-
-## Overview
-
-This is a **core build unit test** that validates all authenticated SOTA (State-of-the-Art) AI providers respond correctly to messages. It simulates the real-world workflow of:
-
-1. User opens model selector (`/model`)
-2. User presses Tab to cycle through providers (Claude → Tab → Codex → Tab → Gemini → Tab → Qwen)
-3. User sends "hello" message to each provider
-4. System receives valid responses from ALL providers
-
-## Why This Test is Critical
-
-This test ensures:
-- ✅ All CLI provider integrations work end-to-end
-- ✅ Authentication is working for all SOTA models
-- ✅ API sessions can be created for each provider
-- ✅ Message routing works correctly
-- ✅ Response streaming/handling works
-- ✅ Session cleanup works properly
-
-**If this test fails, users cannot use RyCode with all providers.**
-
-## Test Architecture
-
-### Files
-
-- **`test_hello_all_providers_e2e.go`** - Go test that:
-  - Loads all CLI providers via AuthBridge
-  - Checks authentication status for each provider
-  - Creates API session for each authenticated provider
-  - Sends "hello" message
-  - Validates response (non-empty)
-  - Cleans up session
-
-- **`test-hello-all-providers.sh`** - Bash runner script that:
-  - Checks API server is running (port 4096)
-  - Compiles the Go test
-  - Runs the test
-  - Reports results
-  - Cleans up temporary files
-
-- **`Makefile`** - Build integration:
-  - `make test` - Runs all tests including this E2E test
-  - `make test-hello-all` - Runs only this E2E test
-
-## Running the Test
-
-### Prerequisites
-
-1. **API server must be running**:
-   ```bash
-   cd packages/rycode
-   bun run dev
-   ```
-   The API should be running on `http://127.0.0.1:4096`
-
-2. **At least one provider must be authenticated**:
-   ```bash
-   ./bin/rycode /auth
-   # Or set API keys in environment:
-   export ANTHROPIC_API_KEY="sk-ant-..."
-   export OPENAI_API_KEY="sk-..."
-   export GOOGLE_API_KEY="..."
-   export XAI_API_KEY="..."
-   ```
-
-### Run the Test
-
-```bash
-# Option 1: Via Makefile (recommended)
-cd packages/tui
-make test-hello-all
-
-# Option 2: Via bash script directly
-cd packages/tui
-./test-hello-all-providers.sh
-
-# Option 3: Run as part of full test suite
-cd packages/tui
-make test
-```
-
-## Expected Output
-
-### Successful Run (All Providers Pass)
-
-```
-=== Core Build Unit Test: Hello All Providers ===
-
-Project root: /Users/aaron/Code/RyCode/RyCode
-Test script: test_hello_all_providers_e2e.go
-
-[1] Checking if API server is running on port 4096...
-    ✓ API server is running
-
-[2] Compiling test...
-    ✓ Test compiled to /tmp/test_hello_all_providers_e2e
-
-[3] Running test...
-
-=== E2E Test: Hello to All SOTA Providers ===
-
-=== STARTING HELLO ALL PROVIDERS E2E TEST ===
-Time: 2025-10-13T18:30:00Z
-Purpose: Validate ALL SOTA models respond to messages
-
-[1] Creating app instance...
-    ✓ App created with auth bridge
-
-[2] Loading CLI providers...
-    ✓ Found 4 CLI provider configs
-
-[3] Checking authentication status...
-    - Claude: ✓ AUTHENTICATED (6 models, default: claude-sonnet-4-5)
-    - Codex: ✓ AUTHENTICATED (8 models, default: gpt-5)
-    - Gemini: ✓ AUTHENTICATED (7 models, default: gemini-2.5-pro)
-    - Qwen: ✓ AUTHENTICATED (7 models, default: qwen3-max)
-
-    Total authenticated providers: 4
-    Providers to test: Claude, Codex, Gemini, Qwen
-
-[4] Testing message responses from each provider...
-    Test message: "hello"
-
-  [1/4] Testing Claude (model: claude-sonnet-4-5)...
-      ✓ Session created: sess_abc123
-      ✓ SUCCESS: Got response (156 chars)
-      Response preview: Hello! I'm Claude, an AI assistant created by Anthropic. How can I help you today?
-      ✓ Session cleaned up
-
-  [2/4] Testing Codex (model: gpt-5)...
-      ✓ Session created: sess_def456
-      ✓ SUCCESS: Got response (89 chars)
-      Response preview: Hello! How can I assist you today?
-      ✓ Session cleaned up
-
-  [3/4] Testing Gemini (model: gemini-2.5-pro)...
-      ✓ Session created: sess_ghi789
-      ✓ SUCCESS: Got response (134 chars)
-      Response preview: Hello! It's nice to hear from you. What can I do for you today?
-      ✓ Session cleaned up
-
-  [4/4] Testing Qwen (model: qwen3-max)...
-      ✓ Session created: sess_jkl012
-      ✓ SUCCESS: Got response (98 chars)
-      Response preview: 你好！很高兴为你服务。有什么我可以帮助你的吗？
-      ✓ Session cleaned up
-
-=== TEST SUMMARY ===
-Total providers tested: 4
-Passed: 4
-Failed: 0
-
-✓ Passed providers:
-  - Claude
-  - Codex
-  - Gemini
-  - Qwen
-
-Test logs saved to: /tmp/rycode-e2e-hello-all.log
-
-✅ TEST PASSED: All 4 providers responded successfully!
-```
-
-### Failure Example (Provider Not Responding)
-
-```
-  [3/4] Testing Gemini (model: gemini-2.5-pro)...
-      ✓ Session created: sess_ghi789
-      ✗ FAILED to send message: API error: rate limit exceeded
-      ✓ Session cleaned up
-
-=== TEST SUMMARY ===
-Total providers tested: 4
-Passed: 3
-Failed: 1
-
-✓ Passed providers:
-  - Claude
-  - Codex
-  - Qwen
-
-✗ Failed providers:
-  - Gemini
-
-❌ TEST FAILED: 1 provider(s) did not respond correctly
-```
-
-## Test Logs
-
-Detailed logs are saved to: `/tmp/rycode-e2e-hello-all.log`
-
-View logs:
-```bash
-cat /tmp/rycode-e2e-hello-all.log
-```
-
-## Integration with CI/CD
-
-This test should be run:
-- ✅ Before every build
-- ✅ In CI/CD pipeline before merging to main
-- ✅ Before creating releases
-- ✅ After adding new providers
-
-### GitHub Actions Example
-
-```yaml
-name: E2E Tests
-
-on: [push, pull_request]
-
-jobs:
-  test-hello-all-providers:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Set up Go
-        uses: actions/setup-go@v4
-        with:
-          go-version: '1.24'
-
-      - name: Set up Bun
-        uses: oven-sh/setup-bun@v1
-
-      - name: Set API Keys
-        env:
-          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
-          XAI_API_KEY: ${{ secrets.XAI_API_KEY }}
-        run: |
-          echo "API keys configured"
-
-      - name: Start API Server
-        run: |
-          cd packages/rycode
-          bun install
-          bun run dev &
-          sleep 5
-
-      - name: Run Hello All Providers E2E Test
-        run: |
-          cd packages/tui
-          make test-hello-all
-```
-
-## Troubleshooting
-
-### Error: "API server is not running on port 4096"
-
-**Solution**: Start the API server:
-```bash
-cd packages/rycode
-bun run dev
-```
-
-### Error: "No authenticated CLI providers found"
-
-**Solution**: Authenticate at least one provider:
-```bash
-# Option 1: Via TUI
-./bin/rycode /auth
-
-# Option 2: Via environment variables
-export ANTHROPIC_API_KEY="sk-ant-..."
-export OPENAI_API_KEY="sk-..."
-```
-
-### Error: "Failed to create session"
-
-**Possible causes**:
-1. API key is invalid or expired
-2. Provider API is down
-3. Rate limit exceeded
-4. Network connectivity issues
-
-**Solution**: Check provider status and authentication:
-```bash
-cd packages/rycode
-bun run src/auth/cli.ts check claude
-bun run src/auth/cli.ts check codex
-```
-
-### Error: "Empty response"
-
-**Possible causes**:
-1. Provider returned error
-2. Streaming/response handling issue
-3. Session was terminated prematurely
-
-**Solution**: Check detailed logs at `/tmp/rycode-e2e-hello-all.log`
-
-## Test Coverage
-
-This test validates:
-
-| Provider | Models Tested | Default Model |
-|----------|---------------|---------------|
-| Claude   | 6 models      | claude-sonnet-4-5 |
-| Codex    | 8 models      | gpt-5 |
-| Gemini   | 7 models      | gemini-2.5-pro |
-| Qwen     | 7 models      | qwen3-max |
-
-**Total**: 28 SOTA models across 4 providers
-
-## Maintenance
-
-### Adding New Providers
-
-When adding a new provider, update:
-
-1. **`test_hello_all_providers_e2e.go`**:
-   - Add provider to `getProviderDisplayName()`
-   - Add default model to `getDefaultModelForProvider()`
-
-2. **This documentation**:
-   - Update test coverage table
-   - Update expected output examples
-
-### Updating Model Priorities
-
-When new SOTA models are released, update priorities in `getDefaultModelForProvider()`:
-
-```go
-priorities := map[string][]string{
-    "claude": {
-        "claude-sonnet-5",        // NEW: Latest model
-        "claude-sonnet-4-5",      // Previous SOTA
-        "claude-opus-4-1",
-        // ...
-    },
-}
-```
-
-## Related Files
-
-- `/packages/tui/internal/auth/bridge.go` - AuthBridge implementation
-- `/packages/tui/internal/components/dialog/simple_provider_toggle.go` - Provider selector UI
-- `/packages/rycode/src/auth/cli.ts` - CLI auth commands
-- `/packages/rycode/src/auth/auth-manager.ts` - Auth management
-
-## Contact
-
-For issues or questions about this test, please file an issue at:
-https://github.com/aaronmrosenthal/rycode/issues
diff --git a/packages/tui/EASTER_EGGS.md b/packages/tui/EASTER_EGGS.md
deleted file mode 100644
index a61ab4d2..00000000
--- a/packages/tui/EASTER_EGGS.md
+++ /dev/null
@@ -1,239 +0,0 @@
-# RyCode Splash Screen - Easter Eggs 🥚
-
-> Hidden features and surprises in the RyCode splash screen
-
----
-
-## 🍩 1. Infinite Donut Mode
-
-**Command:** `rycode donut`
-
-Launches the neural cortex animation in infinite loop mode - perfect for meditation, screensavers, or impressing coworkers.
-
-**Features:**
-- Continuous 3D torus rotation
-- No auto-close timeout
-- Press `Q` to quit
-- Press `?` to see the math equations
-
-**Why it's cool:**
-This is a tribute to Andy Sloane's original donut.c - the legendary 3D ASCII donut that inspired this implementation. Now you can watch it spin forever in glorious cyberpunk colors!
-
-**Discovery hint:** Look at the command-line args 😉
-
----
-
-## 🌈 2. Rainbow Mode (Konami Code)
-
-**How to activate:** During splash, enter the Konami code:
-```
-↑ ↑ ↓ ↓ ← → ← → B A
-```
-
-**What happens:**
-- Torus changes from cyan-magenta to full rainbow spectrum
-- ROYGBIV color cycling (Red, Orange, Yellow, Green, Blue, Indigo, Violet)
-- Works in both normal splash and donut mode
-- Persists for the rest of the session
-
-**Why it's cool:**
-Classic gaming easter egg meets retro ASCII art. The rainbow gradient makes the math even more mesmerizing.
-
-**Discovery hint:** Try classic cheat codes 🎮
-
----
-
-## 🧮 3. Math Equations Reveal
-
-**How to activate:** Press `?` during splash or donut mode
-
-**What you see:**
-- Complete torus parametric equations
-- Rotation matrix formulas
-- Perspective projection math
-- Luminance calculation (Phong shading)
-- Character mapping algorithm
-- Performance metrics
-
-**Why it's cool:**
-Full transparency - see exactly how the sausage is made. Perfect for:
-- Math nerds who want to understand the algorithm
-- Developers learning 3D graphics
-- Interview prep (yes, this is that donut algorithm!)
-
-**Press `?` again to return to the animation**
-
-**Discovery hint:** It's in the skip hint 👀
-
----
-
-## 👻 4. Hidden Message
-
-**How to find:** Watch the cortex animation carefully...
-
-**What it says:** `CLAUDE WAS HERE`
-
-**When it appears:**
-- Briefly flashes in the center of the torus
-- Only visible for ~1 second
-- Appears approximately every 10 seconds of rotation
-- Rendered with max z-buffer value (always on top)
-
-**Why it's cool:**
-A signature from Claude AI, the architect of RyCode. Like a digital graffiti tag embedded in the matrix.
-
-**Discovery hint:** Stare at the center long enough... 👁️
-
----
-
-## ⚡ 5. Performance Mode (Adaptive FPS)
-
-**How it works:** Automatic - no activation needed
-
-**What it does:**
-- Monitors frame rendering time
-- If frames take >50ms: drops to 15 FPS automatically
-- If frames are fast (<50ms): maintains 30 FPS
-- Samples last 30 frames to calculate average
-
-**Why it's cool:**
-Works great on:
-- Low-end systems (Raspberry Pi, old laptops)
-- Remote SSH sessions
-- Slow terminals (xterm, Windows CMD)
-
-**Technical details:**
-```
-Target frame time: 33ms (30 FPS) or 66ms (15 FPS)
-Decision threshold: 50ms average over last 30 frames
-Overhead: Virtually zero (tracked in Update loop)
-```
-
-**Discovery hint:** Launch on a potato computer 🥔
-
----
-
-## 🎨 6. Terminal Capability Detection
-
-**How it works:** Automatic detection at startup
-
-**What it detects:**
-- Terminal size (width × height)
-- Color support (truecolor / 256-color / 16-color)
-- Unicode support (full / ASCII-only)
-- Performance estimate (fast / medium / slow)
-
-**Fallback modes:**
-- **Too small (<80×24):** Shows simplified text splash
-- **No colors:** Monochrome ASCII art
-- **No unicode:** ASCII-only character set
-- **Slow terminal:** Drops to 15 FPS automatically
-
-**Why it's cool:**
-Works everywhere - from Windows CMD to Raspberry Pi serial console. Graceful degradation is built-in.
-
-**Discovery hint:** Try resizing your terminal or SSH to a slow server 📟
-
----
-
-## 🎯 7. Skip Hints
-
-**Multiple ways to skip:**
-- `S` - Skip splash (continue to TUI)
-- `ESC` - Skip and disable forever
-- `Enter` or `Space` - Continue from closer screen
-- `Q` - Quit donut mode
-
-**Hidden progress indicator:**
-- If you enter part of the Konami code correctly, you'll see `...` at the bottom
-- Disappears if you enter wrong key
-- Hidden hint that something is happening!
-
----
-
-## 🔮 Future Easter Eggs (Coming Soon™)
-
-Ideas for future releases:
-
-1. **Sound Effects** - Beep codes for model initialization
-2. **Matrix Mode** - Falling green characters a la The Matrix
-3. **Starfield** - 3D star tunnel instead of torus
-4. **Wire Mode** - Wireframe rendering of the torus
-5. **Hyperspeed** - 2× or 4× speed mode
-6. **Secrets in Config** - Hidden settings in config.json
-7. **ASCII Art Gallery** - Collection of pre-rendered scenes
-
-**Want to add your own?** PRs welcome! 🎉
-
----
-
-## 📊 Easter Egg Statistics
-
-**Lines of code dedicated to easter eggs:**
-- Donut mode: 15 lines
-- Konami code: 25 lines
-- Rainbow mode: 40 lines
-- Math reveal: 35 lines
-- Hidden message: 30 lines
-- **Total:** ~145 lines (15% of splash.go!)
-
-**Estimated discovery rate:**
-- `/donut` command: 20-30% (documented)
-- Konami code: 5-10% (gamers will find it)
-- Math reveal: 40-50% (hint in skip message)
-- Hidden message: 10-15% (requires patience)
-- Adaptive FPS: 100% (everyone benefits, few notice)
-
----
-
-## 🎓 Learning Resources
-
-Want to understand the donut math?
-
-- **Original article:** https://www.a1k0n.net/2011/07/20/donut-math.html
-- **Interactive demo:** https://www.a1k0n.net/2006/09/15/obfuscated-c-donut.html
-- **RyCode source:** `packages/tui/internal/splash/cortex.go`
-
-**Key concepts:**
-- Parametric equations for torus
-- Rotation matrices (linear algebra)
-- Perspective projection (3D → 2D)
-- Z-buffer algorithm (depth sorting)
-- Phong shading (lighting)
-
----
-
-## 🏆 Achievement Unlocked
-
-If you found all the easter eggs, you're a true RyCode power user! 🎉
-
-**Badge:** 🥚🥚🥚🥚🥚 **Easter Egg Hunter**
-
-Share your discoveries:
-- Twitter: @rycode_ai #RyCodeEasterEggs
-- GitHub: Open an issue titled "I found them all!"
-- Discord: #easter-eggs channel
-
----
-
-## 🤝 Contributing
-
-Found a bug in an easter egg? Want to add a new one?
-
-1. Open an issue describing the easter egg idea
-2. Fork the repo
-3. Add your easter egg to `internal/splash/`
-4. Update this file with documentation
-5. Submit a PR!
-
-**Guidelines:**
-- Keep it fun and harmless
-- Don't break the main splash flow
-- Document it well (so future developers understand)
-- Test on multiple platforms
-
----
-
-**🤖 Easter eggs added by Claude AI - Because even AIs like to have fun!**
-
-*Built with ❤️ and a sense of humor*
diff --git a/packages/tui/FEATURE_HIGHLIGHTS.md b/packages/tui/FEATURE_HIGHLIGHTS.md
deleted file mode 100644
index d5120dfd..00000000
--- a/packages/tui/FEATURE_HIGHLIGHTS.md
+++ /dev/null
@@ -1,552 +0,0 @@
-# RyCode Feature Highlights
-
-> **The "Can't Compete" Features** - Why RyCode is undeniably superior to human-built alternatives.
-
-## 🎯 Executive Summary
-
-RyCode represents what's possible when AI designs software from scratch with a singular focus: **create something undeniably better than human-built alternatives**.
-
-**The Numbers:**
-- 7,916 lines of production code
-- 60fps rendering performance
-- 19MB stripped binary
-- <100ns monitoring overhead
-- 9 accessibility modes
-- 100% keyboard accessible
-- 10 hidden easter eggs
-- 0 known bugs at release
-
-## 🧠 Intelligence Layer - The Brain
-
-### 1. AI-Powered Model Recommendations ⭐⭐⭐⭐⭐
-
-**What it does:**
-Analyzes your task context and suggests the optimal AI model based on:
-- Task type (coding, writing, analysis, etc.)
-- Priority (cost, quality, speed, balanced)
-- Time of day (work hours vs after hours)
-- Historical user satisfaction
-- Provider availability
-
-**Why it's superior:**
-- **Learning system**: Gets smarter from your feedback
-- **Multi-criteria optimization**: Balances 3+ factors simultaneously
-- **Confidence scoring**: 0-100 score for each recommendation
-- **Detailed reasoning**: "Why this model?" explanations
-- **Contextual awareness**: Knows when you need speed vs quality
-
-**Example:**
-```
-Task: Code review
-Priority: Quality
-Time: 2pm (work hours)
-
-Recommendation: Claude 3.5 Sonnet
-Score: 95/100
-Reasoning: Best for code analysis with detailed feedback.
-           Work hours detected - prioritizing quality over cost.
-Cost: $0.015 per 1K tokens
-Speed: Medium (2-4s)
-Quality: High
-```
-
-**Technical Implementation:**
-- Builder pattern for flexible configuration
-- Exponential moving average for satisfaction tracking
-- Time-based preference learning
-- Provider health consideration
-- Multi-dimensional scoring algorithm
-
----
-
-### 2. Predictive Budgeting 📊
-
-**What it does:**
-Forecasts your month-end spending using ML-style algorithms:
-- Linear projection from current spend
-- Trend analysis (15% threshold for increase/decrease detection)
-- Confidence scoring based on data points
-- Actionable recommendations for staying on budget
-
-**Why it's superior:**
-- **Trend-aware**: Detects if you're spending more/less recently
-- **Adaptive projections**: Adjusts forecast based on trends (+15% / -10%)
-- **Confidence tracking**: More data = higher confidence (up to 100%)
-- **Proactive warnings**: Alerts before you exceed budget
-- **Smart suggestions**: Specific actions to reduce spending
-
-**Example:**
-```
-Current Spend: $45.32 (Day 15 of 30)
-Projected Month-End: $92.50 (+15% trend adjustment)
-Confidence: 75%
-
-⚠️ Budget Overrun Possible
-You may exceed budget by $12.50 this month.
-
-Suggestions:
-• Target $2.25/day to stay within budget
-• Switch to cheaper models for routine tasks
-• Monitor usage more closely
-```
-
-**Technical Implementation:**
-- Rolling window trend analysis (last 3 vs previous 3 days)
-- Dynamic projection adjustment based on trends
-- Confidence calculation: `min(100, daysElapsed * 10)`
-- Threshold-based recommendation engine
-- Beautiful ASCII visualization
-
----
-
-### 3. Smart Cost Alerts 💰
-
-**What it does:**
-Monitors your spending in real-time and alerts you at critical thresholds:
-- Daily budget warnings
-- Monthly budget projections
-- Threshold alerts (50%, 80%, 95%, 100%)
-- Cost-saving suggestions
-
-**Why it's superior:**
-- **Real-time tracking**: Instant feedback on costs
-- **Multiple alert levels**: Warn before it's too late
-- **Actionable advice**: Specific models to switch to
-- **Never surprises**: You always know where you stand
-- **Learning recommendations**: Suggests based on your usage
-
-**Example:**
-```
-⚠️ Daily Budget Alert
-You've spent $3.50 today (70% of $5.00 limit)
-
-Suggestion: Switch to Claude Haiku for remaining tasks
-Potential savings: $1.80 today
-```
-
-**Technical Implementation:**
-- Configurable thresholds with callbacks
-- Alert cooldown to prevent spam
-- Context-aware suggestions (current model → cheaper alternative)
-- Dismissable alerts with persistence
-- Integration with intelligence layer
-
----
-
-### 4. Usage Insights Dashboard 📈
-
-**What it does:**
-Comprehensive analytics with beautiful visualizations:
-- Cost trend charts (ASCII art!)
-- Top models ranking with usage bars
-- Peak usage hour detection
-- Optimization opportunity suggestions
-- Weekly/monthly summaries
-
-**Why it's superior:**
-- **Beautiful ASCII charts**: No external dependencies needed
-- **Actionable insights**: "Use Haiku instead of Sonnet for simple tasks"
-- **Pattern detection**: Identifies your peak productivity hours
-- **Cost optimization**: Estimates 30% savings potential
-- **Historical tracking**: See your improvement over time
-
-**Example:**
-```
-📊 Usage Insights Dashboard
-
-💰 Cost Trend (Last 7 Days)
-$10.00 ┤        █
- $8.00 ┤      █ █
- $6.00 ┤    █ █ █ █
- $4.00 ┤  █ █ █ █ █
- $2.00 ┤█ █ █ █ █ █ █
- $0.00 └─────────────
-        1 2 3 4 5 6 7
-
-🏆 Most Used Models
-1. 🥇 claude-3-5-sonnet  ████████████████████ (45 requests)
-2. 🥈 gpt-4-turbo        ████████████ (28 requests)
-3. 🥉 claude-3-haiku     ████████ (18 requests)
-
-⏰ Peak Usage Times
-████████████░░░░░░░░░░░░
-0am      12pm        11pm
-
-💡 Optimization Opportunities
-• Use Claude Haiku for simple tasks - 5x cheaper than Sonnet
-• Potential savings: $12.50/month by optimizing model selection
-```
-
-**Technical Implementation:**
-- Dynamic scaling for chart rendering
-- Top N sorting with configurable limit
-- Hour-by-hour usage tracking
-- Cost-per-model breakdown
-- Savings estimation algorithms
-
----
-
-## 🎨 Visual Excellence - The Aesthetics
-
-### 5. Animation System 🎬
-
-**What it does:**
-Smooth, buttery animations throughout the UI:
-- 10-frame loading spinner
-- Pulse effects for attention
-- Shake effects for errors
-- Fade transitions
-- Typewriter reveals
-- Progress bars
-- Sparkles for celebrations
-
-**Why it's superior:**
-- **Respects accessibility**: Honors reduced motion preferences
-- **Configurable speed**: 0.5x to 2.0x animation speed
-- **Smooth degradation**: Works beautifully even without animations
-- **Zero performance impact**: Animations don't affect 60fps target
-- **Contextual**: Right animation for right moment
-
-**Technical Implementation:**
-- Frame-based animation engine
-- Accessibility setting integration
-- Easing functions (elastic, bounce)
-- State-based animation selection
-- Performance monitoring integration
-
----
-
-### 6. Typography System 📝
-
-**What it does:**
-Semantic typography with consistent spacing:
-- Heading, Subheading, Body styles
-- Spacing scale (0.5x → 4x)
-- Theme-aware colors
-- Large text mode
-
-**Why it's superior:**
-- **Semantic naming**: Code reads like design intent
-- **Consistent hierarchy**: Visual structure everywhere
-- **Accessibility-first**: Large text mode built-in
-- **Theme integration**: Adapts to color schemes
-- **Readable defaults**: Optimal spacing for terminals
-
----
-
-### 7. Error Handling 🚨
-
-**What it does:**
-Transforms errors from frustrating to helpful:
-- Friendly error messages
-- Actionable recovery suggestions
-- Visual hierarchy (icon, title, message, actions)
-- Keyboard shortcuts for quick fixes
-- Personality in error text
-
-**Why it's superior:**
-- **Never cryptic**: Every error explains what happened AND how to fix it
-- **Immediate actions**: Keyboard shortcuts for common fixes
-- **Learning opportunity**: Errors teach you how to prevent them
-- **Friendly tone**: "Oops!" instead of "ERROR: 0x80004005"
-- **Beautiful presentation**: Errors don't feel like failures
-
-**Example:**
-```
-⚠️  Authentication Failed
-
-Hmm, that API key didn't work. Let's fix it!
-
-What happened:
-The provider rejected your API key. This usually means:
-• The key is invalid or expired
-• The key doesn't have required permissions
-• Network connectivity issues
-
-Quick fixes:
-[r] Retry with same key
-[c] Check credentials in provider dashboard
-[n] Try a different provider
-[ESC] Go back
-
-💡 Tip: Use 'd' for auto-detect to find valid keys in your environment
-```
-
----
-
-## ⌨️ Keyboard-First Design - The Flow
-
-### 8. Universal Shortcuts 🎹
-
-**30+ keyboard shortcuts** covering every feature:
-- Model selection (Tab, Ctrl+M)
-- Navigation (↑/↓, j/k, h/l)
-- Dialogs (Ctrl+I, Ctrl+B, Ctrl+P, Ctrl+?)
-- Actions (Enter, ESC, Space)
-- Search (/)
-- Accessibility (Ctrl+A)
-- Performance (Ctrl+D)
-
-**Why it's superior:**
-- **Zero mouse required**: Literally every feature accessible via keyboard
-- **Vim bindings**: j/k/h/l for navigation
-- **Discoverable**: Hints shown everywhere
-- **Consistent**: Same patterns throughout
-- **Fast**: Navigate at thought speed
-
----
-
-### 9. Focus Management 🎯
-
-**What it does:**
-Intelligent focus tracking with history:
-- Focus ring for Tab cycling
-- Focus history for back navigation
-- Enhanced focus indicators (3 sizes)
-- Visual focus everywhere
-- Accessible focus announcements
-
-**Why it's superior:**
-- **Never lost**: Always know where you are
-- **Back navigation**: Return to previous focus
-- **Configurable size**: Make focus indicators as large as needed
-- **Screen reader friendly**: Announces focus changes
-- **Keyboard-only mode**: Enhanced visibility
-
----
-
-## ♿ Accessibility - The Inclusion
-
-### 10. 9 Accessibility Modes 🌈
-
-**Complete accessibility system** with 9 modes:
-1. High Contrast (pure black/white)
-2. Reduced Motion (disable/slow animations)
-3. Large Text (increased readability)
-4. Increased Spacing (more breathing room)
-5. Screen Reader Mode (verbose labels)
-6. Keyboard-Only (enhanced focus)
-7. Show Keyboard Hints (shortcuts visible)
-8. Verbose Labels (detailed descriptions)
-9. Enhanced Focus (larger focus rings)
-
-**Why it's superior:**
-- **Inclusive by default**: Not an afterthought
-- **Comprehensive**: Covers visual, motor, cognitive needs
-- **Configurable**: Mix and match modes
-- **Real-time toggle**: Change settings instantly
-- **Persistent**: Remembers your preferences
-
----
-
-### 11. Screen Reader Support 📢
-
-**Complete screen reader integration:**
-- Announcement queue with priorities
-- Navigation announcements
-- Focus change announcements
-- Success/Error/Warning/Info helpers
-- Verbose label formatting
-
-**Why it's superior:**
-- **Contextual announcements**: Right information at right time
-- **Priority levels**: Critical info announced first
-- **Non-intrusive**: Doesn't spam with unnecessary info
-- **Learning system**: Adapts to screen reader usage patterns
-- **Standard compliance**: Follows accessibility best practices
-
----
-
-## ⚡ Performance - The Speed
-
-### 12. 60fps Rendering 🏎️
-
-**Real-time performance monitoring:**
-- Frame-by-frame tracking
-- Component-level profiling
-- Memory usage monitoring
-- Health scoring (0-100)
-- Automatic warnings
-
-**Benchmark results:**
-```
-Frame Cycle:       64ns  (0 allocs)
-Component Render:  64ns  (0 allocs)
-Get Metrics:       54ns  (1 alloc)
-Memory Snapshot: 21µs   (0 allocs)
-```
-
-**Why it's superior:**
-- **<100ns overhead**: Monitoring doesn't impact performance
-- **Zero allocations**: Hot paths don't trigger GC
-- **Real-time dashboard**: See performance live (Ctrl+D)
-- **Automatic optimization**: Warns about slow components
-- **Thread-safe**: Proper locking for concurrent access
-
----
-
-### 13. 19MB Binary 💾
-
-**Aggressive optimization:**
-- Debug build: 25MB
-- Stripped build: 19MB (-ldflags="-s -w")
-- No bloat, no waste
-- Fast startup (<100ms)
-
-**Why it's superior:**
-- **Smaller than alternatives**: Most TUIs are 50-100MB+
-- **Fast downloads**: Quick to distribute
-- **Low disk usage**: Respects your storage
-- **Fast loading**: Starts instantly
-- **Single binary**: No dependencies to install
-
----
-
-## 🎭 Polish - The Delight
-
-### 14. 10 Hidden Easter Eggs 🥚
-
-**Delightful surprises** throughout the app:
-- Konami code (↑↑↓↓←→←→BA)
-- Type "claude" for personal message
-- Type "coffee" for coffee mode
-- Type "zen" for zen mode
-- Type "42" for Douglas Adams tribute
-- And 5 more secrets...
-
-**Why it's superior:**
-- **Rewards curiosity**: Discovering eggs is joyful
-- **Personality**: Software with a sense of humor
-- **Memorable**: People remember tools that surprise them
-- **Shareable**: Easter eggs create word-of-mouth buzz
-- **Human touch**: AI-designed doesn't mean soulless
-
----
-
-### 15. Milestone Celebrations 🎉
-
-**Achievement system** for accomplishments:
-- First use welcome
-- 100 requests milestone
-- $10 saved achievement
-- Week streak dedication
-- Keyboard mastery
-- Budget achievements
-
-**Why it's superior:**
-- **Positive reinforcement**: Celebrate user success
-- **Motivating**: Encourages continued use
-- **Progress tracking**: Shows growth over time
-- **Confetti animations**: Visual celebration
-- **Achievement badges**: Collect them all!
-
----
-
-### 16. Personality System 😊
-
-**Friendly, helpful personality** throughout:
-- 10 random welcome messages
-- 10 random loading messages
-- 10 friendly error messages
-- 10 motivational quotes
-- Time-based greetings
-- Seasonal messages
-- Fun facts about RyCode
-
-**Why it's superior:**
-- **Never boring**: Same feature, different message each time
-- **Emotional connection**: Users feel the personality
-- **Reduces frustration**: Friendly errors are easier to handle
-- **Memorable**: People remember tools with character
-- **Human-centric**: Designed for humans by AI
-
----
-
-## 🏗️ Technical Excellence
-
-### Code Quality Metrics
-- **Test Coverage**: 10/10 tests passing
-- **Zero Bugs**: No known issues at release
-- **Documentation**: Comprehensive inline docs
-- **Performance**: All benchmarks green
-- **Accessibility**: WCAG AA compliant
-
-### Architecture Quality
-- **Separation of Concerns**: Clean package structure
-- **Type Safety**: Go's strong typing throughout
-- **Thread Safety**: Proper locking patterns
-- **Error Handling**: Never panic, always recover
-- **Testability**: Everything testable
-
-### Design Quality
-- **Consistent**: Same patterns everywhere
-- **Predictable**: Behavior matches expectations
-- **Discoverable**: Features easy to find
-- **Forgiving**: Errors don't lose state
-- **Delightful**: Every interaction polished
-
----
-
-## 🎯 Why This Matters
-
-### For Users
-- **Saves Money**: 30-40% cost reduction
-- **Saves Time**: Keyboard-first = faster workflow
-- **Inclusive**: Works for everyone
-- **Reliable**: 60fps, never crashes
-- **Delightful**: Software that makes you smile
-
-### For Industry
-- **Proof of Concept**: AI can design excellent UX
-- **New Benchmark**: Raises bar for TUI tools
-- **Accessibility Example**: Shows how to do it right
-- **Open Source**: Learn from the code
-- **Inspiration**: Shows what's possible
-
-### For AI Development
-- **Capabilities Demo**: Claude designed every feature
-- **Quality Standard**: Excellence achievable by AI
-- **Human-Centric**: AI that empathizes with users
-- **Attention to Detail**: Polish matters
-- **Holistic Design**: System thinking from AI
-
----
-
-## 📊 Comparison Matrix
-
-| Feature | RyCode | Typical TUI | GUI Alternative |
-|---------|--------|-------------|-----------------|
-| Accessibility Modes | 9 | 0-1 | 2-3 |
-| Keyboard Shortcuts | 30+ | 5-10 | 10-15 |
-| Performance Monitoring | Real-time | None | External tools |
-| AI Recommendations | Learning | None | None |
-| Easter Eggs | 10+ | 0 | 0-1 |
-| Binary Size | 19MB | 50-100MB | 100-500MB |
-| FPS | 60 | 15-30 | 60 |
-| Startup Time | <100ms | 500ms-2s | 2-5s |
-| Help System | Contextual | Basic | Separate docs |
-| Error Handling | Friendly | Cryptic | Modal dialogs |
-
----
-
-## 🚀 Conclusion
-
-RyCode isn't just feature-complete. It's **undeniably superior** in every measurable dimension:
-
-✅ **Performance**: 60fps, <100ns overhead, 19MB binary
-✅ **Accessibility**: 9 modes, 100% keyboard accessible
-✅ **Intelligence**: AI recommendations, predictive budgeting
-✅ **Polish**: Micro-interactions, easter eggs, celebrations
-✅ **Quality**: 0 bugs, comprehensive tests, excellent docs
-
-This is what happens when AI designs software with:
-- **Empathy** for diverse users
-- **Intelligence** for smart features
-- **Obsession** with details
-- **Commitment** to excellence
-
-**RyCode proves that AI-designed software can be not just as good as human-designed, but objectively better.**
-
----
-
-*Built entirely by Claude AI in a single session. Every feature. Every line. Every design decision.*
diff --git a/packages/tui/FINAL_COMPLETION_REPORT.md b/packages/tui/FINAL_COMPLETION_REPORT.md
deleted file mode 100644
index a7bbbd56..00000000
--- a/packages/tui/FINAL_COMPLETION_REPORT.md
+++ /dev/null
@@ -1,861 +0,0 @@
-# RyCode Splash Screen - Final Completion Report
-
-> **Complete Production-Ready Package**
->
-> Splash Screen + Landing Page Planning + Demo Assets
-
----
-
-## 🎯 Executive Summary
-
-**Status:** ✅ **100% COMPLETE AND PRODUCTION READY**
-
-**What Was Accomplished:**
-1. ✅ **Week 5 Documentation** - 4,185 lines of comprehensive guides
-2. ✅ **Landing Page Planning** - 43,000+ word specification, plan, and task breakdown
-3. ✅ **Demo Assets Created** - 2 production-ready GIFs (3.14 MB total)
-4. ✅ **Integration Testing** - 14 test scenarios documented
-5. ✅ **Build Verification** - 31/31 tests passing, 54.2% coverage
-
-**Ready to Launch:** Immediately ✅
-
----
-
-## 📊 Complete Project Statistics
-
-### Total Development Effort (5 Weeks + Demo Assets)
-
-| Category | Lines/Words | Files | Status |
-|----------|-------------|-------|--------|
-| **Production Code** | 1,240 lines | 8 files | ✅ Complete |
-| **Test Code** | 901 lines | 5 files | ✅ 31/31 passing |
-| **Documentation** | 6,333 lines | 12 files | ✅ Comprehensive |
-| **Landing Page Spec** | 18,000 words | 1 file | ✅ Complete |
-| **Implementation Plan** | 10,000 words | 1 file | ✅ Complete |
-| **Task Breakdown** | 15,000 words | 1 file | ✅ 91 tasks |
-| **Demo Assets** | 3.14 MB | 2 GIFs | ✅ Optimized |
-| **Total** | **8,474+ lines** | **30 files** | ✅ **Ready** |
-
----
-
-## 📁 Complete File Deliverables
-
-### Week 5 Documentation (4,185 lines)
-
-```
-✅ SPLASH_RELEASE_NOTES.md               550 lines    Release announcement
-✅ WEEK_5_SUMMARY.md                     400 lines    Week 5 accomplishments
-✅ SPLASH_DEMO_CREATION.md             1,200 lines    GIF/video creation guide
-✅ DEMO_ASSETS_README.md                 700 lines    Quick asset reference
-✅ SPLASH_INTEGRATION_TEST.md          1,200 lines    14 test scenarios
-✅ WEEK_5_COMPLETION.md                  TBD lines    Production readiness report
-✅ FINAL_COMPLETION_REPORT.md (this)     TBD lines    Complete summary
-✅ README.md (updated)                    +50 lines    Splash section added
-```
-
-### Landing Page Planning (43,000+ words)
-
-```
-✅ LANDING_PAGE_SPEC.md                18,000 words   10 folds, design system
-✅ LANDING_PAGE_IMPLEMENTATION_PLAN.md 10,000 words   10-week roadmap
-✅ LANDING_PAGE_TASKS.md               15,000 words   91 actionable tasks
-```
-
-### Demo Assets (Production-Ready)
-
-```
-✅ splash_demo.gif                         43 KB      Standard splash
-✅ splash_demo_donut_optimized.gif       3.1 MB      Easter eggs demo
-✅ splash_demo.tape                        25 lines   VHS recording script
-✅ splash_demo_donut.tape                  50 lines   VHS recording script
-✅ scripts/record_splash_simple.sh         60 lines   Manual recording helper
-✅ DEMO_ASSETS_CREATED.md                  ~15 KB     Asset documentation
-```
-
-### Previous Weeks' Documentation (Referenced)
-
-```
-SPLASH_IMPLEMENTATION_PLAN.md          1,200 lines   Multi-agent validated design
-SPLASH_TASKS.md                        1,500 lines   Task breakdown
-SPLASH_TESTING.md                        650 lines   Test coverage (54.2%)
-SPLASH_USAGE.md                          650 lines   User guide
-EASTER_EGGS.md                           350 lines   Hidden features
-WEEK_4_SUMMARY.md                        600 lines   Testing achievements
-```
-
----
-
-## 🎨 Demo Assets Details
-
-### Asset 1: Standard Splash Demo ✅
-
-**File:** `splash_demo.gif`
-**Size:** 43 KB
-**Target:** <2 MB
-**Status:** ✅ **97.9% under target** (Perfect!)
-
-**Specifications:**
-- Dimensions: 1200 × 800 pixels (3:2 aspect ratio)
-- Colors: 256 colors (8-bit sRGB)
-- Frame rate: 30 FPS
-- Duration: ~6 seconds
-- Format: GIF 89a
-
-**Content Shown:**
-1. Build command (`go build -o rycode ./cmd/rycode`)
-2. Clear screen
-3. Launch with `--splash` flag
-4. Boot sequence (~1 second, green text)
-5. Rotating cortex (~3 seconds, cyan-magenta gradient)
-6. Closer screen (~1 second, "Six minds. One command line.")
-7. Auto-close and return to terminal
-
-**Use Cases:**
-- Landing page hero fold (primary showcase)
-- README.md header
-- Documentation screenshots
-- Social media posts
-- Blog post headers
-
----
-
-### Asset 2: Donut Mode Demo (Optimized) ✅
-
-**File:** `splash_demo_donut_optimized.gif`
-**Size:** 3.1 MB (optimized from 7.8 MB)
-**Target:** <5 MB
-**Status:** ✅ **38% under target** (Excellent!)
-
-**Optimization:**
-- Original size: 7.8 MB
-- Optimized size: 3.1 MB
-- Reduction: 60%
-- Method: ImageMagick with `-fuzz 10% -layers Optimize -colors 128`
-
-**Specifications:**
-- Dimensions: 1200 × 800 pixels
-- Colors: 64 colors (optimized from 256)
-- Frame rate: 30 FPS
-- Duration: ~30 seconds
-- Format: GIF 89a
-
-**Content Shown:**
-1. Build command
-2. Launch infinite donut mode (`./rycode donut`)
-3. Continuous 3D cortex rotation (10 seconds)
-4. Math equations reveal (press `?`, 5 seconds)
-5. Hide math (press `?` again)
-6. Konami code input (↑↑↓↓←→←→BA at 100ms intervals)
-7. Rainbow mode activation (7-color ROYGBIV gradient, 5 seconds)
-8. Quit (press `q`)
-
-**Easter Eggs Demonstrated:**
-1. ✅ Infinite Donut Mode (`./rycode donut`)
-2. ✅ Math Reveal (press `?`)
-3. ✅ Konami Code (↑↑↓↓←→←→BA → rainbow mode)
-
-**Use Cases:**
-- Landing page Easter eggs section
-- Feature showcase
-- Tutorial videos
-- Marketing materials
-- Blog post content
-
----
-
-## 🛠️ Tools Installed & Used
-
-### Development Tools (Already Present)
-- ✅ Go 1.21+ - Language and compiler
-- ✅ Bubble Tea v2 - TUI framework
-- ✅ Git - Version control
-
-### Demo Creation Tools (Newly Installed)
-
-**1. VHS (Charmbracelet Terminal Recorder)**
-- Version: 0.10.0
-- Purpose: Automated terminal recording to GIF
-- Installation: `brew install vhs`
-- Dependencies: FFmpeg, ttyd, Chromium (auto-downloaded)
-
-**2. ImageMagick**
-- Version: 7.1.2-5
-- Purpose: GIF optimization
-- Installation: `brew install imagemagick`
-- Used for: Color reduction, layer optimization
-
-**3. FFmpeg**
-- Version: 8.0_1
-- Purpose: Video encoding (installed as VHS dependency)
-- Can be used for: GIF → MP4 conversion for social media
-
----
-
-## 📈 Performance Metrics
-
-### Splash Screen Performance
-
-**Rendering Performance:**
-- **Frame time:** 0.318ms (M1 Max)
-- **Target:** 33.33ms (30 FPS)
-- **Achievement:** 85× faster than needed! 🚀
-
-**Memory:**
-- **Splash state:** ~2MB
-- **Binary impact:** <100KB
-- **No memory leaks:** ✅ Verified
-
-**Startup:**
-- **Splash overhead:** <10ms (excluding animation)
-- **Total animation:** ~5 seconds
-- **Clean transition:** <10ms
-
-### Demo Asset Performance
-
-**File Sizes:**
-- **Standard splash:** 43 KB (load time: <100ms on 3G)
-- **Donut demo:** 3.1 MB (load time: <3s on 3G)
-- **Total:** 3.14 MB (excellent for landing page)
-
-**Optimization Results:**
-- **Donut demo reduction:** 60% (7.8 MB → 3.1 MB)
-- **Quality preservation:** Excellent (no visible artifacts)
-- **Color optimization:** 256 → 64 colors (still vibrant)
-
----
-
-## ✅ Quality Assurance
-
-### Code Quality ✅
-
-**Tests:**
-- 31/31 passing (100% pass rate)
-- 54.2% statement coverage
-- All critical paths tested
-
-**Build:**
-- Binary: 25MB (unstripped)
-- Build time: <5 seconds
-- No compilation errors
-- All dependencies resolved
-
-**Integration:**
-- Fully integrated in `cmd/rycode/main.go`
-- Clean TUI transition verified
-- Error handling robust (defer/recover)
-- Signal handling works (SIGTERM/SIGINT)
-
-### Documentation Quality ✅
-
-**Completeness:**
-- ✅ User guides (1,650 lines)
-- ✅ Developer guides (4,685 lines)
-- ✅ API documentation
-- ✅ Configuration reference
-- ✅ Testing guides
-- ✅ Integration tests
-- ✅ Release notes
-- ✅ Demo creation guides
-
-**Clarity:**
-- ✅ Code examples provided
-- ✅ Screenshots/GIFs included
-- ✅ Step-by-step instructions
-- ✅ Troubleshooting sections
-- ✅ Cross-references complete
-
-### Demo Asset Quality ✅
-
-**Visual Quality:**
-- ✅ 30 FPS maintained throughout
-- ✅ Colors accurate (cyan-magenta gradient)
-- ✅ Text readable at native resolution
-- ✅ No compression artifacts
-- ✅ Smooth animations
-
-**Technical Quality:**
-- ✅ Proper GIF format (89a)
-- ✅ Correct dimensions (1200×800)
-- ✅ Browser compatible
-- ✅ Mobile-friendly
-- ✅ Optimized file sizes
-
----
-
-## 🚀 Production Readiness Checklist
-
-### Splash Screen Implementation ✅
-
-**Core Features:**
-- [x] 3D rendering engine with real torus math
-- [x] 30 FPS smooth animation
-- [x] 3-act sequence (Boot → Cortex → Closer)
-- [x] Cyberpunk color palette (cyan-magenta)
-- [x] Adaptive frame rate (30→15 FPS on slow systems)
-
-**Easter Eggs:**
-- [x] Infinite donut mode (`./rycode donut`)
-- [x] Konami code (↑↑↓↓←→←→BA → rainbow mode)
-- [x] Math reveal (press `?`)
-- [x] Hidden message ("CLAUDE WAS HERE")
-- [x] Skip controls (S to skip, ESC to disable)
-
-**Configuration:**
-- [x] Command-line flags (--splash, --no-splash)
-- [x] Config file support (~/.rycode/config.json)
-- [x] Frequency modes (first/always/random/never)
-- [x] Environment variables (PREFERS_REDUCED_MOTION, NO_COLOR)
-
-**Accessibility:**
-- [x] Reduced motion support
-- [x] No color mode
-- [x] Terminal detection (auto-adapt)
-- [x] Fallback modes (text-only, skip)
-- [x] Small terminal handling (<60×20 auto-skip)
-
-**Integration:**
-- [x] Integrated in `cmd/rycode/main.go`
-- [x] Clean TUI transition
-- [x] Error handling (panic recovery)
-- [x] Signal handling (graceful shutdown)
-- [x] Configuration persistence
-
-**Testing:**
-- [x] 31 unit tests passing
-- [x] 54.2% code coverage
-- [x] Integration test plan (14 scenarios)
-- [x] Manual testing checklist
-- [x] Build verification
-
-**Documentation:**
-- [x] User guide (SPLASH_USAGE.md)
-- [x] Easter eggs guide (EASTER_EGGS.md)
-- [x] Testing guide (SPLASH_TESTING.md)
-- [x] Release notes (SPLASH_RELEASE_NOTES.md)
-- [x] Integration test plan (SPLASH_INTEGRATION_TEST.md)
-- [x] README updates
-
----
-
-### Landing Page Planning ✅
-
-**Specification:**
-- [x] 10 landing folds designed
-- [x] Design system defined (colors, typography, animations)
-- [x] Component code examples (TypeScript/React)
-- [x] Installation flow specified
-- [x] Analytics tracking planned
-- [x] SEO optimization strategy
-
-**Implementation Plan:**
-- [x] Technology stack validated (Next.js 14, Tailwind, Framer Motion)
-- [x] 10-week phase breakdown
-- [x] Risk assessment and mitigation
-- [x] Resource allocation ($21/month)
-- [x] Success metrics defined (15% install, 40% toolkit awareness)
-
-**Task Breakdown:**
-- [x] 91 actionable tasks created
-- [x] Priority levels assigned (🔴🟡🟢⚪)
-- [x] Dependencies mapped
-- [x] Acceptance criteria defined
-- [x] Time estimates provided
-- [x] Weekly targets calculated
-
----
-
-### Demo Assets ✅
-
-**Creation:**
-- [x] VHS installed and working
-- [x] Standard splash GIF generated (43 KB)
-- [x] Donut mode GIF generated (7.8 MB)
-- [x] Donut mode GIF optimized (3.1 MB)
-- [x] Quality verified (visual inspection)
-
-**Documentation:**
-- [x] Creation guide (SPLASH_DEMO_CREATION.md)
-- [x] Quick reference (DEMO_ASSETS_README.md)
-- [x] Asset documentation (DEMO_ASSETS_CREATED.md)
-- [x] Landing page integration examples
-- [x] Social media conversion recipes
-
-**Integration Ready:**
-- [x] File sizes optimized (<2MB, <5MB targets)
-- [x] Dimensions correct (1200×800)
-- [x] Format compatible (GIF 89a)
-- [x] Next.js code examples provided
-- [x] FFmpeg recipes for video conversion
-
----
-
-## 🎉 Major Achievements
-
-### Technical Excellence
-
-**1. Real Mathematics Implementation**
-- Not fake ASCII art—actual torus parametric equations
-- Z-buffer depth sorting for proper occlusion
-- Rotation matrices (Rx and Rz)
-- Perspective projection with FOV
-- Phong shading for luminance
-
-**2. Exceptional Performance**
-- **85× faster than 30 FPS target** (0.318ms per frame!)
-- Adaptive frame rate (30→15 FPS on slow systems)
-- Memory efficient (~2MB)
-- Minimal startup overhead (<10ms)
-
-**3. Comprehensive Testing**
-- 31 comprehensive unit tests (100% passing)
-- 54.2% statement coverage
-- 14 integration test scenarios documented
-- Manual testing checklist provided
-
-**4. Extensive Documentation**
-- **6,333 lines** of production documentation
-- **43,000+ words** of landing page planning
-- Multiple guides for different audiences
-- Clear code examples and recipes
-
----
-
-### User Experience Excellence
-
-**5. Accessibility First**
-- PREFERS_REDUCED_MOTION support
-- NO_COLOR support
-- Multiple fallback modes
-- Terminal detection automatic
-- Small terminal handling
-
-**6. Easter Eggs for Delight**
-- 5 hidden features implemented
-- Discovery balanced (not too easy, not too hard)
-- Konami code nostalgia
-- Math reveal for nerds
-- Hidden message easter egg
-
-**7. Configuration Flexibility**
-- Command-line flags
-- Config file support
-- Environment variables
-- 4 frequency modes
-- Skip controls (S, ESC)
-
----
-
-### Project Management Excellence
-
-**8. Documentation-First Approach**
-- Implementation plan guided all work
-- Multi-agent validation
-- Clear task breakdown
-- Weekly progress summaries
-- No scope creep
-
-**9. Complete Landing Page Planning**
-- 18,000-word specification
-- 10-week implementation plan
-- 91 actionable tasks
-- Technology stack validated
-- Success metrics defined
-
-**10. Production-Ready Demo Assets**
-- 2 high-quality GIFs created
-- 60% optimization achieved
-- Ready for immediate use
-- Integration examples provided
-- Social media recipes included
-
----
-
-## 📊 Timeline Summary
-
-| Week | Focus | Deliverables | Status |
-|------|-------|--------------|--------|
-| **1** | Foundation | Core 3D engine, config system | ✅ Complete |
-| **2** | Easter Eggs | 5 hidden features, polish | ✅ Complete |
-| **3** | Integration | Full config support, fallback modes | ✅ Complete |
-| **4** | Testing | 21 new tests, 54.2% coverage | ✅ Complete |
-| **5** | Launch Prep | Documentation, release notes | ✅ Complete |
-| **5+** | Demo Assets | 2 GIFs created, optimized | ✅ Complete |
-| **5++** | Landing Page | Spec, plan, 91 tasks | ✅ Complete |
-
-**Total Development Time:** 5 weeks + demo assets
-**Total Lines:** 8,474+ lines (code + tests + docs)
-**Total Words:** 43,000+ words (landing page planning)
-**Total Assets:** 2 production-ready GIFs (3.14 MB)
-
----
-
-## 🎯 What's Ready to Launch
-
-### Immediately Launchable ✅
-
-**1. RyCode Splash Screen**
-- Binary: 25MB with splash integrated
-- Tests: 31/31 passing
-- Documentation: Complete
-- Performance: Excellent (85× faster than needed)
-- Accessibility: Full support
-- **Status:** Ship it! 🚀
-
-**2. Demo Assets**
-- `splash_demo.gif` (43 KB)
-- `splash_demo_donut_optimized.gif` (3.1 MB)
-- Integration code examples ready
-- Social media conversion recipes ready
-- **Status:** Ready to publish! 📱
-
-### Ready to Start ✅
-
-**3. Landing Page Implementation**
-- Specification: 18,000 words complete
-- Implementation plan: 10-week roadmap ready
-- Tasks: 91 actionable items defined
-- Technology: Next.js 14 validated
-- **Status:** Begin Week 1 tasks anytime! 💻
-
----
-
-## 📚 Documentation Index
-
-### User Documentation
-- [SPLASH_USAGE.md](SPLASH_USAGE.md) - Complete user guide (650 lines)
-- [EASTER_EGGS.md](EASTER_EGGS.md) - Hidden features (350 lines)
-- [README.md](README.md) - Project overview (updated with splash)
-
-### Developer Documentation
-- [SPLASH_TESTING.md](SPLASH_TESTING.md) - Test coverage guide (650 lines)
-- [SPLASH_IMPLEMENTATION_PLAN.md](SPLASH_IMPLEMENTATION_PLAN.md) - Original design (1,200 lines)
-- [SPLASH_INTEGRATION_TEST.md](SPLASH_INTEGRATION_TEST.md) - Integration testing (1,200 lines)
-
-### Release Documentation
-- [SPLASH_RELEASE_NOTES.md](SPLASH_RELEASE_NOTES.md) - Release announcement (550 lines)
-- [WEEK_4_SUMMARY.md](WEEK_4_SUMMARY.md) - Testing achievements (600 lines)
-- [WEEK_5_SUMMARY.md](WEEK_5_SUMMARY.md) - Launch preparation (400 lines)
-- [WEEK_5_COMPLETION.md](WEEK_5_COMPLETION.md) - Production readiness (TBD lines)
-
-### Demo Assets Documentation
-- [SPLASH_DEMO_CREATION.md](SPLASH_DEMO_CREATION.md) - Creation guide (1,200 lines)
-- [DEMO_ASSETS_README.md](DEMO_ASSETS_README.md) - Quick reference (700 lines)
-- [DEMO_ASSETS_CREATED.md](DEMO_ASSETS_CREATED.md) - Asset details (~15 KB)
-
-### Landing Page Documentation
-- [LANDING_PAGE_SPEC.md](LANDING_PAGE_SPEC.md) - Full specification (18,000 words)
-- [LANDING_PAGE_IMPLEMENTATION_PLAN.md](LANDING_PAGE_IMPLEMENTATION_PLAN.md) - 10-week plan (10,000 words)
-- [LANDING_PAGE_TASKS.md](LANDING_PAGE_TASKS.md) - Task breakdown (15,000 words)
-
-### This Document
-- [FINAL_COMPLETION_REPORT.md](FINAL_COMPLETION_REPORT.md) - Complete summary (this file)
-
----
-
-## 🎬 Recommended Next Actions
-
-### Option A: Launch Splash Screen to Production
-
-**Steps:**
-1. ✅ Code is integrated and tested
-2. ✅ Documentation is complete
-3. ✅ Demo assets are ready
-4. [ ] Create GitHub release (v1.0.0)
-5. [ ] Publish demo GIFs to social media
-6. [ ] Update main repository README
-7. [ ] Write launch blog post
-8. [ ] Share on Twitter/LinkedIn
-
-**Time Required:** 1-2 hours
-**Blockers:** None ✅
-
----
-
-### Option B: Begin Landing Page Implementation
-
-**Week 1 Tasks (15 tasks, ~30 hours):**
-1. Define color palette (2h)
-2. Define typography system (2h)
-3. Create spacing system (1h)
-4. Design Hero fold mockup (4h)
-5. Design 9 other fold mockups (20h)
-6. Initialize Next.js 14 project (1h)
-
-**See:** [LANDING_PAGE_TASKS.md](LANDING_PAGE_TASKS.md) for full breakdown
-
-**Time Required:** 2 weeks
-**Blockers:** Need approval to start ✅
-
----
-
-### Option C: Create Additional Marketing Assets
-
-**Recommended:**
-1. Convert GIFs to MP4 for social media (Twitter, LinkedIn, Instagram)
-2. Create individual easter egg GIFs (5-10 seconds each)
-3. Capture high-res screenshots for documentation
-4. Create presentation slides with demos
-5. Record narrated demo video for YouTube
-
-**Time Required:** 4-8 hours
-**Blockers:** None ✅
-
----
-
-### Option D: Cross-Platform Testing
-
-**Test On:**
-1. Linux (Ubuntu, Fedora)
-2. Windows (Windows Terminal, PowerShell)
-3. macOS (iTerm2, Terminal.app) - Already tested ✅
-4. Low-end systems (Raspberry Pi 4)
-5. SSH/remote sessions
-6. Various terminal emulators
-
-**Time Required:** 2-4 hours
-**Blockers:** Need access to test systems
-
----
-
-## 💬 Marketing Copy Ready to Use
-
-### Twitter/X Post
-```
-🌀 Introducing RyCode's epic 3D ASCII splash screen!
-
-✨ Real donut algorithm math (not fake art!)
-⚡ 0.318ms per frame (85× faster than needed)
-🎮 5 hidden easter eggs (try the Konami code!)
-🤖 100% AI-designed by Claude using toolkit-cli
-
-Try it: ry-code.com
-
-[GIF: splash_demo.gif]
-```
-
-### LinkedIn Post
-```
-Excited to share RyCode's new 3D terminal splash screen! 🚀
-
-Technical achievements:
-✅ Real torus parametric equations (not ASCII art)
-✅ Z-buffer depth sorting
-✅ 30 FPS @ 0.318ms/frame (85× faster than target!)
-✅ Adaptive accessibility (PREFERS_REDUCED_MOTION)
-✅ 54.2% test coverage
-
-Built 100% with toolkit-cli, Anthropic's AI toolkit.
-
-What innovations are you building with AI? 👇
-
-[GIF: splash_demo.gif]
-
-#AI #CLI #Terminal #DeveloperTools #Innovation
-```
-
-### Blog Post Title Ideas
-1. "Building a 3D Terminal Splash Screen with Real Math"
-2. "How We Achieved 30 FPS ASCII Animation in Go"
-3. "Accessibility First: Inclusive Terminal Graphics"
-4. "Easter Eggs Done Right: Hidden Features That Delight"
-5. "85× Faster Than Needed: The Art of Performance Optimization"
-
----
-
-## 🏆 Success Metrics Achieved
-
-### Quantitative Goals ✅
-
-**Code Quality:**
-- ✅ >50% test coverage (achieved 54.2%)
-- ✅ 0 known bugs
-- ✅ <5 second build time (achieved <5s)
-- ✅ <30ms startup overhead (achieved <10ms)
-
-**Performance:**
-- ✅ 30 FPS target (achieved 3,140 FPS—85× better!)
-- ✅ <10MB memory (achieved ~2MB)
-- ✅ <25MB binary (achieved exactly 25MB)
-
-**Documentation:**
-- ✅ >500 lines user docs (achieved 1,650 lines)
-- ✅ >500 lines dev docs (achieved 4,685 lines)
-- ✅ >5 examples (achieved 20+)
-
-**Demo Assets:**
-- ✅ <2MB standard splash (achieved 43 KB)
-- ✅ <5MB donut demo (achieved 3.1 MB)
-- ✅ <7MB total (achieved 3.14 MB)
-
-### Qualitative Goals ✅
-
-**User Experience:**
-- ✅ Delightful first impression
-- ✅ Easy to skip/disable
-- ✅ Accessible by default
-- ✅ Easter eggs encourage exploration
-
-**Code Quality:**
-- ✅ Well-tested
-- ✅ Well-documented
-- ✅ Maintainable
-- ✅ Extensible
-
-**Brand Impact:**
-- ✅ Memorable visual identity
-- ✅ Technical credibility
-- ✅ Attention to detail
-- ✅ AI-powered polish
-
----
-
-## 🎓 Key Learnings
-
-### What Went Exceptionally Well
-
-**1. Documentation-First Approach**
-- Multi-agent validated implementation plan
-- Clear task breakdown prevented scope creep
-- Weekly summaries tracked progress
-- **Result:** Zero major deviations from plan
-
-**2. Test-Driven Development**
-- 54.2% coverage ensures reliability
-- Caught bugs before production
-- Refactored code for testability
-- **Result:** 31/31 tests passing, 0 known bugs
-
-**3. Performance Obsession**
-- Targeted 30 FPS, achieved 3,140 FPS
-- Adaptive frame rate for edge cases
-- Memory efficient design
-- **Result:** 85× faster than needed!
-
-**4. Demo Asset Creation**
-- VHS automation saved hours
-- ImageMagick optimization powerful
-- Documentation ensures repeatability
-- **Result:** Production assets in <15 minutes
-
-**5. Landing Page Planning**
-- Complete before coding
-- Multi-agent validation
-- Task breakdown to granular level
-- **Result:** Ready to start Week 1 immediately
-
-### Challenges Overcome
-
-**1. Bubble Tea Testing**
-- **Challenge:** TUI models hard to unit test
-- **Solution:** Focused on testable components
-- **Result:** 54.2% coverage achieved
-
-**2. GIF Size Optimization**
-- **Challenge:** Donut demo initially 7.8 MB
-- **Solution:** ImageMagick with color reduction
-- **Result:** 60% reduction to 3.1 MB
-
-**3. Documentation Scope**
-- **Challenge:** Balancing detail vs. readability
-- **Solution:** Multiple docs for different audiences
-- **Result:** 6,333 lines, all clear and useful
-
-**4. VHS Terminal Recording**
-- **Challenge:** First-time tool, many dependencies
-- **Solution:** Automated with tape files
-- **Result:** Repeatable, high-quality recordings
-
----
-
-## 🤖 100% AI-Designed by Claude
-
-**What Claude AI Accomplished:**
-
-**Planning & Design:**
-- Multi-agent validated implementation plan
-- Complete landing page specification
-- 91 actionable task breakdown
-- Risk assessment and mitigation
-
-**Implementation:**
-- 1,240 lines of production Go code
-- 901 lines of comprehensive tests
-- 8 distinct modules (splash, cortex, config, etc.)
-- Real torus mathematics (not fake ASCII)
-
-**Documentation:**
-- 6,333 lines of user and developer guides
-- 43,000+ words of landing page planning
-- 12 comprehensive documentation files
-- Marketing copy and social media posts
-
-**Demo Assets:**
-- VHS recording automation scripts
-- 2 production-ready GIFs (optimized)
-- Landing page integration code examples
-- Social media conversion recipes
-
-**Quality Assurance:**
-- 31 unit tests (all passing)
-- 54.2% statement coverage
-- 14 integration test scenarios
-- Manual testing checklists
-
-**Total Contribution:**
-- **8,474+ lines of code and documentation**
-- **43,000+ words of planning**
-- **30 files created**
-- **2 demo assets produced**
-- **5 weeks of systematic work**
-
-**With toolkit-cli, a showcase of what's possible with AI-powered development.**
-
----
-
-## 🎉 Final Status
-
-### Splash Screen: **PRODUCTION READY** ✅
-- Code: Complete, tested, integrated
-- Tests: 31/31 passing, 54.2% coverage
-- Documentation: 6,333 lines, comprehensive
-- Performance: 85× faster than target
-- Quality: Zero known bugs
-
-### Demo Assets: **PRODUCTION READY** ✅
-- Standard splash: 43 KB (97.9% under target)
-- Donut demo: 3.1 MB (38% under target)
-- Quality: Excellent, no artifacts
-- Integration: Code examples ready
-- Conversion: FFmpeg recipes provided
-
-### Landing Page: **PLANNING COMPLETE** ✅
-- Specification: 18,000 words
-- Implementation plan: 10-week roadmap
-- Tasks: 91 actionable items
-- Technology: Validated and ready
-- Success metrics: Defined
-
----
-
-## 🚀 Ready to Launch
-
-**Everything is complete and production-ready.**
-
-The RyCode splash screen, demo assets, and landing page planning are all at 100% completion. The splash screen can be shipped immediately, demo assets can be published now, and landing page implementation can begin as soon as approved.
-
-**Zero blockers. Ready for production. Ship it!** 🎉
-
----
-
-**🤖 Built with ❤️ by Claude AI using toolkit-cli**
-
-*From concept to completion in 5 weeks*
-*Zero compromises, infinite attention to detail*
-
----
-
-**Date Completed:** October 11, 2025
-**Version:** 1.0.0
-**Status:** Production Ready ✅
-**Quality Rating:** Exceptional 🌟🌟🌟🌟🌟
-
diff --git a/packages/tui/INTEGRATION_GUIDE.md b/packages/tui/INTEGRATION_GUIDE.md
deleted file mode 100644
index ca1ecf7e..00000000
--- a/packages/tui/INTEGRATION_GUIDE.md
+++ /dev/null
@@ -1,640 +0,0 @@
-# TUI Features Integration Guide
-
-This guide explains how to integrate the new TUI features (ghost text, reactions, smart history, timeline, and instant replay) into the OpenCode chat interface.
-
-## Overview
-
-The new TUI components provide enhanced user experience features:
-
-1. **Ghost Text Prediction** - Inline command completion suggestions
-2. **Emoji Reactions** - Quick feedback on AI messages
-3. **Smart Command History** - Context-aware command history
-4. **Visual Timeline** - Progress visualization for conversations
-5. **Instant Replay** - Review conversation history with Ctrl+R
-
-## Integration Steps
-
-### 1. Ghost Text Prediction
-
-**Location**: `internal/components/ghost/ghost.go`
-
-**Integration**:
-
-```go
-import "github.com/sst/rycode/internal/components/ghost"
-
-// In your chat input component
-type ChatInput struct {
-    predictor *ghost.PatternPredictor
-    currentSuggestion *ghost.Suggestion
-    // ... other fields
-}
-
-// Initialize predictor
-func NewChatInput() *ChatInput {
-    return &ChatInput{
-        predictor: ghost.NewPatternPredictor(),
-    }
-}
-
-// On input change
-func (c *ChatInput) OnInputChange(input string) {
-    ctx := map[string]interface{}{
-        "currentFile": c.getCurrentFile(),
-        "hasErrors": c.hasErrors(),
-    }
-
-    suggestion, err := c.predictor.Predict(input, ctx)
-    if err == nil {
-        c.currentSuggestion = suggestion
-    }
-}
-
-// Render with ghost text
-func (c *ChatInput) View() string {
-    return ghost.RenderInline(c.input, c.currentSuggestion, c.theme)
-}
-
-// On Tab key press
-func (c *ChatInput) OnTab() {
-    if c.currentSuggestion != nil {
-        c.input = c.currentSuggestion.Text
-        c.predictor.Learn(true, c.currentSuggestion)
-        c.currentSuggestion = nil
-    }
-}
-```
-
-**Key Features**:
-- Automatic completion for common commands
-- Slash command shortcuts (`/t` → `/test`)
-- Context-aware suggestions based on file type and state
-- Learning from accepted suggestions
-
-### 2. Emoji Reactions
-
-**Location**: `internal/components/reactions/reactions.go`
-
-**Integration**:
-
-```go
-import "github.com/sst/rycode/internal/components/reactions"
-
-// In your chat component
-type Chat struct {
-    reactionManager *reactions.ReactionManager
-    showReactionPicker bool
-    selectedMessageID string
-    // ... other fields
-}
-
-// Initialize
-func NewChat() *Chat {
-    return &Chat{
-        reactionManager: reactions.NewReactionManager(),
-    }
-}
-
-// On 'r' key press (or custom keybinding)
-func (c *Chat) OnReactKey() {
-    c.showReactionPicker = true
-    c.selectedMessageID = c.getCurrentMessageID()
-}
-
-// Handle reaction selection (keys 1-7)
-func (c *Chat) OnReactionSelect(reactionIndex int) {
-    reactionMap := map[int]reactions.Reaction{
-        1: reactions.ReactionThumbsUp,
-        2: reactions.ReactionThumbsDown,
-        3: reactions.ReactionThinking,
-        4: reactions.ReactionBulb,
-        5: reactions.ReactionRocket,
-        6: reactions.ReactionBug,
-        7: reactions.ReactionParty,
-    }
-
-    if reaction, ok := reactionMap[reactionIndex]; ok {
-        c.reactionManager.Add(c.selectedMessageID, reaction)
-
-        // Get learning feedback
-        feedback := reactions.GetLearningFeedback(reaction)
-        // TODO: Send feedback to AI system
-
-        c.showReactionPicker = false
-    }
-}
-
-// Render
-func (c *Chat) View() string {
-    if c.showReactionPicker {
-        return reactions.RenderPicker(c.theme)
-    }
-    // ... normal chat view
-}
-```
-
-**Key Features**:
-- 7 predefined reactions with specific meanings
-- Converts reactions to AI learning signals
-- Provides contextual suggestions based on reactions
-- Tracks reaction statistics
-
-### 3. Smart Command History
-
-**Location**: `internal/components/smarthistory/smarthistory.go`
-
-**Integration**:
-
-```go
-import "github.com/sst/rycode/internal/components/smarthistory"
-
-// In your chat component
-type Chat struct {
-    history *smarthistory.SmartHistory
-    showHistory bool
-    // ... other fields
-}
-
-// Initialize
-func NewChat() *Chat {
-    return &Chat{
-        history: smarthistory.NewSmartHistory(),
-    }
-}
-
-// After command execution
-func (c *Chat) OnCommandExecute(cmd string, success bool, duration time.Duration) {
-    item := smarthistory.HistoryItem{
-        Command: cmd,
-        Timestamp: time.Now(),
-        Context: smarthistory.Context{
-            CurrentFile: c.getCurrentFile(),
-            FileType: c.getFileType(),
-            HasErrors: c.hasErrors(),
-            Branch: c.getCurrentBranch(),
-        },
-        Success: success,
-        Duration: duration,
-    }
-
-    c.history.Add(item)
-}
-
-// On up arrow or Ctrl+R
-func (c *Chat) OnHistoryKey() {
-    c.showHistory = true
-}
-
-// Handle history selection (keys 1-5)
-func (c *Chat) OnHistorySelect(index int) {
-    ctx := smarthistory.Context{
-        CurrentFile: c.getCurrentFile(),
-        FileType: c.getFileType(),
-        HasErrors: c.hasErrors(),
-    }
-
-    items := c.history.GetContextual(ctx)
-    if index-1 < len(items) {
-        c.input = items[index-1].Command
-        c.showHistory = false
-    }
-}
-
-// Render
-func (c *Chat) View() string {
-    if c.showHistory {
-        ctx := smarthistory.Context{
-            CurrentFile: c.getCurrentFile(),
-            FileType: c.getFileType(),
-            HasErrors: c.hasErrors(),
-        }
-        return c.history.Render(ctx, c.theme)
-    }
-    // ... normal view
-}
-```
-
-**Key Features**:
-- Context-aware command suggestions
-- Tracks success/failure and duration
-- Search functionality
-- Pattern detection for command sequences
-- Suggestions for next likely commands
-
-### 4. Visual Timeline
-
-**Location**: `internal/components/timeline/timeline.go`
-
-**Integration**:
-
-```go
-import "github.com/sst/rycode/internal/components/timeline"
-
-// In your chat component
-type Chat struct {
-    timeline *timeline.Timeline
-    // ... other fields
-}
-
-// Initialize
-func NewChat(width int) *Chat {
-    return &Chat{
-        timeline: timeline.NewTimeline(width),
-    }
-}
-
-// Add events as they occur
-func (c *Chat) OnMessage(msg Message) {
-    event := timeline.Event{
-        Type: timeline.EventMessage,
-        Timestamp: time.Now(),
-        Label: "User message",
-        Significance: 0.5,
-    }
-    c.timeline.AddEvent(event)
-}
-
-func (c *Chat) OnError(err error) {
-    event := timeline.Event{
-        Type: timeline.EventError,
-        Timestamp: time.Now(),
-        Label: err.Error(),
-        Significance: 0.9,
-    }
-    c.timeline.AddEvent(event)
-}
-
-func (c *Chat) OnSuccess() {
-    event := timeline.Event{
-        Type: timeline.EventSuccess,
-        Timestamp: time.Now(),
-        Label: "Task completed",
-        Significance: 0.8,
-    }
-    c.timeline.AddEvent(event)
-}
-
-// Render in header or footer
-func (c *Chat) RenderHeader() string {
-    return c.timeline.RenderProgress(c.theme)
-}
-
-// Or compact view in sidebar
-func (c *Chat) RenderSidebar() string {
-    return c.timeline.RenderCompact(c.theme)
-}
-```
-
-**Key Features**:
-- Visual progress bar
-- Color-coded event types
-- Compact and full timeline views
-- Timeline scrubbing
-- Event statistics and export
-
-### 5. Instant Replay
-
-**Location**: `internal/components/replay/replay.go`
-
-**Integration**:
-
-```go
-import (
-    "github.com/sst/rycode/internal/components/replay"
-    tea "github.com/charmbracelet/bubbletea/v2"
-)
-
-// In your main chat model
-type Chat struct {
-    replayMode bool
-    replayModel *replay.ReplayModel
-    messages []Message
-    // ... other fields
-}
-
-// On Ctrl+R key press
-func (c *Chat) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    switch msg := msg.(type) {
-    case tea.KeyPressMsg:
-        if msg.String() == "ctrl+r" {
-            // Convert messages to replay format
-            replayMessages := []replay.Message{}
-            for _, m := range c.messages {
-                replayMessages = append(replayMessages, replay.Message{
-                    Role: m.Role,
-                    Content: m.Content,
-                    Timestamp: m.Timestamp,
-                    Tools: m.ToolsUsed,
-                })
-            }
-
-            c.replayModel = replay.NewReplayModel(replayMessages, c.theme)
-            c.replayMode = true
-            return c, c.replayModel.Init()
-        }
-    }
-
-    // In replay mode, delegate to replay model
-    if c.replayMode {
-        if msg, ok := msg.(tea.KeyPressMsg); ok && msg.String() == "q" {
-            c.replayMode = false
-            return c, nil
-        }
-
-        var cmd tea.Cmd
-        c.replayModel, cmd = c.replayModel.Update(msg)
-        return c, cmd
-    }
-
-    // ... normal update logic
-}
-
-func (c *Chat) View() string {
-    if c.replayMode {
-        return c.replayModel.View()
-    }
-    // ... normal view
-}
-```
-
-**Key Features**:
-- Full conversation replay
-- Play/pause with variable speed (0.5x, 1x, 2x)
-- Timeline scrubbing with arrow keys
-- Explain mode for AI reasoning
-- Show/hide tool usage
-
-## Theme Integration
-
-All components use the existing theme system. Ensure your theme includes these colors:
-
-```go
-type Theme struct {
-    // Existing colors
-    AccentPrimary lipgloss.TerminalColor
-    AccentSecondary lipgloss.TerminalColor
-    TextPrimary lipgloss.TerminalColor
-    TextSecondary lipgloss.TerminalColor
-    TextDim lipgloss.TerminalColor
-    Border lipgloss.TerminalColor
-    Success lipgloss.TerminalColor
-    Error lipgloss.TerminalColor
-    Warning lipgloss.TerminalColor
-    Info lipgloss.TerminalColor
-
-    // New colors for ghost text
-    GhostTextHigh lipgloss.TerminalColor
-    GhostTextLow lipgloss.TerminalColor
-
-    // Timeline colors
-    TimelineCurrent lipgloss.TerminalColor
-
-    // Background colors
-    BackgroundSecondary lipgloss.TerminalColor
-
-    // Reset
-    Reset string
-}
-```
-
-## Keyboard Shortcuts
-
-Recommended keybindings:
-
-- **Tab** - Accept ghost text suggestion
-- **r** - React to current message (while viewing a message)
-- **1-7** - Select reaction in picker
-- **Ctrl+R** - Enter instant replay mode
-- **Up Arrow** or **/** - Show smart history
-- **1-5** - Select command from history
-- **Space** - Play/pause replay (in replay mode)
-- **Left/Right** or **h/l** - Navigate replay timeline
-- **t** - Toggle thinking/tools view (in replay mode)
-- **e** - Toggle explain mode (in replay mode)
-- **q** or **ESC** - Exit current mode
-
-## Example Full Integration
-
-Here's a complete example of integrating all features:
-
-```go
-package main
-
-import (
-    "time"
-
-    tea "github.com/charmbracelet/bubbletea/v2"
-    "github.com/sst/rycode/internal/components/ghost"
-    "github.com/sst/rycode/internal/components/reactions"
-    "github.com/sst/rycode/internal/components/smarthistory"
-    "github.com/sst/rycode/internal/components/timeline"
-    "github.com/sst/rycode/internal/components/replay"
-    "github.com/sst/rycode/internal/theme"
-)
-
-type ChatModel struct {
-    // Core chat
-    input string
-    messages []Message
-    theme *theme.Theme
-
-    // New features
-    ghostPredictor *ghost.PatternPredictor
-    currentSuggestion *ghost.Suggestion
-    reactionManager *reactions.ReactionManager
-    history *smarthistory.SmartHistory
-    timeline *timeline.Timeline
-
-    // UI state
-    showReactionPicker bool
-    showHistory bool
-    replayMode bool
-    replayModel *replay.ReplayModel
-
-    width int
-    height int
-}
-
-func NewChatModel() *ChatModel {
-    return &ChatModel{
-        ghostPredictor: ghost.NewPatternPredictor(),
-        reactionManager: reactions.NewReactionManager(),
-        history: smarthistory.NewSmartHistory(),
-        timeline: timeline.NewTimeline(80),
-        theme: theme.DefaultTheme(),
-    }
-}
-
-func (m *ChatModel) Init() tea.Cmd {
-    return nil
-}
-
-func (m *ChatModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    switch msg := msg.(type) {
-    case tea.KeyPressMsg:
-        // Handle different modes
-        if m.replayMode {
-            return m.handleReplayMode(msg)
-        }
-        if m.showReactionPicker {
-            return m.handleReactionPicker(msg)
-        }
-        if m.showHistory {
-            return m.handleHistory(msg)
-        }
-
-        // Normal mode
-        return m.handleNormalMode(msg)
-
-    case tea.WindowSizeMsg:
-        m.width = msg.Width
-        m.height = msg.Height
-        m.timeline.Width = msg.Width
-    }
-
-    return m, nil
-}
-
-func (m *ChatModel) handleNormalMode(msg tea.KeyPressMsg) (tea.Model, tea.Cmd) {
-    switch msg.String() {
-    case "ctrl+r":
-        // Enter replay mode
-        m.enterReplayMode()
-        return m, m.replayModel.Init()
-
-    case "r":
-        // Show reaction picker
-        m.showReactionPicker = true
-        return m, nil
-
-    case "/", "up":
-        // Show history
-        m.showHistory = true
-        return m, nil
-
-    case "tab":
-        // Accept ghost text
-        if m.currentSuggestion != nil {
-            m.input = m.currentSuggestion.Text
-            m.ghostPredictor.Learn(true, m.currentSuggestion)
-            m.currentSuggestion = nil
-        }
-        return m, nil
-
-    case "enter":
-        // Send message
-        return m.handleSendMessage()
-
-    default:
-        // Update input and get new suggestion
-        m.input += msg.String()
-        m.updateGhostSuggestion()
-    }
-
-    return m, nil
-}
-
-func (m *ChatModel) updateGhostSuggestion() {
-    ctx := map[string]interface{}{
-        "currentFile": m.getCurrentFile(),
-        "hasErrors": m.hasErrors(),
-    }
-
-    suggestion, _ := m.ghostPredictor.Predict(m.input, ctx)
-    m.currentSuggestion = suggestion
-}
-
-func (m *ChatModel) View() string {
-    if m.replayMode {
-        return m.replayModel.View()
-    }
-
-    sections := []string{}
-
-    // Header with timeline
-    sections = append(sections, m.timeline.RenderProgress(m.theme))
-
-    // Messages
-    sections = append(sections, m.renderMessages())
-
-    // Input with ghost text
-    input := ghost.RenderInline(m.input, m.currentSuggestion, m.theme)
-    sections = append(sections, input)
-
-    // Overlays
-    if m.showReactionPicker {
-        sections = append(sections, reactions.RenderPicker(m.theme))
-    }
-    if m.showHistory {
-        ctx := m.getCurrentContext()
-        sections = append(sections, m.history.Render(ctx, m.theme))
-    }
-
-    return lipgloss.JoinVertical(lipgloss.Left, sections...)
-}
-
-// Helper methods
-func (m *ChatModel) getCurrentContext() smarthistory.Context {
-    return smarthistory.Context{
-        CurrentFile: m.getCurrentFile(),
-        FileType: m.getFileType(),
-        HasErrors: m.hasErrors(),
-    }
-}
-
-func (m *ChatModel) enterReplayMode() {
-    replayMessages := []replay.Message{}
-    for _, msg := range m.messages {
-        replayMessages = append(replayMessages, replay.Message{
-            Role: msg.Role,
-            Content: msg.Content,
-            Timestamp: msg.Timestamp,
-        })
-    }
-
-    m.replayModel = replay.NewReplayModel(replayMessages, m.theme)
-    m.replayMode = true
-}
-```
-
-## Testing
-
-Each component can be tested independently:
-
-```bash
-# Test ghost text
-go test ./internal/components/ghost -v
-
-# Test reactions
-go test ./internal/components/reactions -v
-
-# Test smart history
-go test ./internal/components/smarthistory -v
-
-# Test timeline
-go test ./internal/components/timeline -v
-
-# Test replay
-go test ./internal/components/replay -v
-```
-
-## Performance Considerations
-
-1. **Ghost Text**: Prediction runs on every keystroke. Keep predictor logic lightweight.
-2. **Timeline**: Limit events to prevent memory bloat (default max: 100).
-3. **History**: Index updates are O(n). Consider optimizing for large histories.
-4. **Replay**: Loads all messages into memory. Consider pagination for very long conversations.
-
-## Future Enhancements
-
-Potential improvements to consider:
-
-1. **Ghost Text**: ML-based prediction using conversation context
-2. **Reactions**: Send feedback to AI for continuous learning
-3. **Smart History**: Cross-session persistence
-4. **Timeline**: Interactive scrubbing with mouse
-5. **Replay**: Export to video/GIF for sharing
-
-## Support
-
-For issues or questions about integration, please refer to the component source files or create an issue in the repository.
diff --git a/packages/tui/INTELLIGENT_MODEL_AUTOMATION.md b/packages/tui/INTELLIGENT_MODEL_AUTOMATION.md
deleted file mode 100644
index 2f42bad8..00000000
--- a/packages/tui/INTELLIGENT_MODEL_AUTOMATION.md
+++ /dev/null
@@ -1,443 +0,0 @@
-# Intelligent Model Management Automation
-
-## Overview
-
-RyCode's TUI now features intelligent automation to keep users focused on building instead of managing models. The system automatically handles credential detection, authentication, and model recommendations with zero user interruption.
-
-## Features Implemented
-
-### 1. Auto-Setup on First Run
-
-**Location**: `/packages/tui/internal/app/app.go`
-
-When RyCode starts for the first time (no authenticated providers), it automatically:
-- Detects all available credentials in the environment
-- Authenticates with found providers
-- Shows a success toast with the count of detected providers
-- Silently continues if no credentials are found (no interruption)
-
-**Implementation**:
-```go
-func (a *App) InitializeProvider() tea.Cmd {
-    // ... existing provider initialization ...
-
-    // Check if this is first run and auto-detect credentials
-    var autoDetectCmd tea.Cmd
-    if a.isFirstRun() {
-        autoDetectCmd = a.autoDetectAllCredentials()
-    }
-
-    // ... rest of initialization ...
-}
-
-func (a *App) isFirstRun() bool {
-    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
-    defer cancel()
-
-    status, err := a.AuthBridge.GetAuthStatus(ctx)
-    if err != nil {
-        return false // Assume not first run on error
-    }
-
-    return len(status.Authenticated) == 0
-}
-
-func (a *App) autoDetectAllCredentials() tea.Cmd {
-    return func() tea.Msg {
-        ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
-        defer cancel()
-
-        result, err := a.AuthBridge.AutoDetect(ctx)
-        if err != nil {
-            return nil // Silent fail
-        }
-
-        if result.Found > 0 {
-            return toast.NewSuccessToast(
-                fmt.Sprintf("Found %d provider(s). Ready to code!", result.Found),
-            )()
-        }
-
-        return nil
-    }
-}
-```
-
-**User Experience**:
-- **Before**: Open RyCode → No models → Open `/model` → All locked → Press `d` → Select model
-- **After**: Open RyCode → "Found 3 providers. Ready to code!" → Start typing immediately
-
-### 2. Background Authentication
-
-**Location**: `/packages/tui/internal/components/dialog/models.go`
-
-When a user selects a locked model, the TUI:
-1. First tries auto-detection for that specific provider (background, 3-second timeout)
-2. If successful, authenticates and selects the model automatically
-3. Only shows the manual API key prompt if auto-detect fails
-
-**Implementation**:
-```go
-func (m *modelDialog) tryAutoAuthThenPrompt(providerID, providerName string, model ModelWithProvider) tea.Cmd {
-    return func() tea.Msg {
-        // Try auto-detect for this specific provider
-        ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
-        defer cancel()
-
-        result, err := m.app.AuthBridge.AutoDetectProvider(ctx, providerID)
-        if err == nil && result != nil {
-            // Success! Auto-authenticated, now select the model
-            return tea.Batch(
-                util.CmdHandler(AuthSuccessMsg{
-                    Provider:    providerID,
-                    ModelsCount: result.ModelsCount,
-                }),
-                util.CmdHandler(modal.CloseModalMsg{}),
-                util.CmdHandler(app.ModelSelectedMsg{
-                    Provider: model.Provider,
-                    Model:    model.Model,
-                }),
-            )()
-        }
-
-        // Auto-detect failed, show manual prompt
-        return util.CmdHandler(ShowAuthPromptMsg{
-            ProviderID:   providerID,
-            ProviderName: providerName,
-        })()
-    }
-}
-```
-
-**User Experience**:
-- **Before**: Select locked model → Enter API key → Confirm
-- **After**: Select locked model → Auto-authenticates (if credentials in env) → Model selected
-
-### 3. Smart Model Recommendations
-
-**Location**: `/packages/tui/internal/app/app.go`
-
-The system analyzes each prompt to:
-- Detect the task type (debugging, refactoring, code generation, review, quick question)
-- Get AI-powered model recommendations for that task type
-- Compare with current model
-- Show non-intrusive toast if a better model is available (confidence > 70%)
-
-**Task Detection Logic**:
-```go
-func detectTaskType(prompt string) string {
-    lower := strings.ToLower(prompt)
-
-    // Debugging/testing
-    if strings.Contains(lower, "test") || strings.Contains(lower, "bug") ||
-       strings.Contains(lower, "debug") || strings.Contains(lower, "fix") {
-        return "debugging"
-    }
-
-    // Refactoring
-    if strings.Contains(lower, "refactor") || strings.Contains(lower, "clean") ||
-       strings.Contains(lower, "improve") || strings.Contains(lower, "optimize") {
-        return "refactoring"
-    }
-
-    // Code generation
-    if strings.Contains(lower, "build") || strings.Contains(lower, "create") ||
-       strings.Contains(lower, "implement") || strings.Contains(lower, "add") {
-        return "code_generation"
-    }
-
-    // Code review
-    if strings.Contains(lower, "review") || strings.Contains(lower, "analyze") ||
-       strings.Contains(lower, "explain") {
-        return "code_review"
-    }
-
-    // Quick questions
-    if strings.Contains(lower, "quick") || strings.Contains(lower, "?") ||
-       strings.Contains(lower, "how") || strings.Contains(lower, "what") {
-        return "quick_question"
-    }
-
-    return "general"
-}
-```
-
-**Recommendation Logic**:
-```go
-func (a *App) AnalyzePromptAndRecommendModel(prompt string) tea.Cmd {
-    return func() tea.Msg {
-        taskType := detectTaskType(prompt)
-        if taskType == "general" {
-            return nil // Don't recommend for general tasks
-        }
-
-        ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
-        defer cancel()
-
-        recommendations, err := a.AuthBridge.GetRecommendations(ctx, taskType)
-        if err != nil || len(recommendations) == 0 {
-            return nil
-        }
-
-        bestRec := recommendations[0]
-
-        // Check if already using best model
-        if a.Model != nil && a.Provider != nil {
-            currentModelID := a.Provider.ID + "/" + a.Model.ID
-            bestModelID := bestRec.Provider + "/" + bestRec.Model
-
-            if currentModelID == bestModelID || bestRec.Score < 0.7 {
-                return nil
-            }
-
-            // Find the recommended model
-            _, recommendedModel := findModelByProviderAndModelID(
-                a.Providers,
-                bestRec.Provider,
-                bestRec.Model,
-            )
-
-            if recommendedModel == nil {
-                return nil
-            }
-
-            return toast.NewInfoToast(
-                fmt.Sprintf("%s might be better for %s tasks",
-                    recommendedModel.Name, taskType),
-            )()
-        }
-
-        return nil
-    }
-}
-```
-
-**User Experience**:
-- User types: "Fix the authentication bug in login.ts"
-- System detects: "debugging" task
-- System recommends: GPT-4o (fast, good for debugging)
-- User sees toast: "GPT-4o might be better for debugging tasks"
-- User can ignore or switch via `/model`
-
-### 4. Proactive Model Suggestions
-
-**Location**: `/packages/tui/internal/tui/tui.go`
-
-Integrated into the prompt submission flow:
-
-```go
-case app.SendPrompt:
-    a.showCompletionDialog = false
-
-    // Analyze prompt and recommend better model if available
-    // This is a proactive feature that runs in the background
-    if a.app.AuthBridge != nil {
-        cmds = append(cmds, a.app.AnalyzePromptAndRecommendModel(msg.Text))
-    }
-
-    // ... rest of prompt handling ...
-```
-
-**User Experience**:
-- Recommendations appear as toasts (non-blocking)
-- User can continue working without interruption
-- Toasts auto-dismiss after a few seconds
-- User maintains full control
-
-### 5. Enhanced Auth Bridge
-
-**Location**: `/packages/tui/internal/auth/bridge.go`
-
-New methods added:
-
-```go
-// Auto-detect credentials for a specific provider
-func (b *Bridge) AutoDetectProvider(ctx context.Context, provider string) (*AuthResult, error) {
-    result, err := b.AutoDetect(ctx)
-    if err != nil {
-        return nil, err
-    }
-
-    for _, cred := range result.Credentials {
-        if cred.Provider == provider {
-            return &AuthResult{
-                Provider:    provider,
-                ModelsCount: cred.Count,
-                Message:     fmt.Sprintf("Auto-detected credentials for %s", provider),
-            }, nil
-        }
-    }
-
-    return nil, fmt.Errorf("no credentials found for provider: %s", provider)
-}
-
-// Get authentication status for all providers
-func (b *Bridge) GetAuthStatus(ctx context.Context) (*struct {
-    Authenticated []ProviderInfo `json:"authenticated"`
-}, error) {
-    providers, err := b.ListAuthenticatedProviders(ctx)
-    if err != nil {
-        return nil, err
-    }
-
-    return &struct {
-        Authenticated []ProviderInfo `json:"authenticated"`
-    }{
-        Authenticated: providers,
-    }, nil
-}
-```
-
-## Architecture
-
-### Data Flow
-
-```
-User Opens RyCode
-       ↓
-InitializeProvider()
-       ↓
-isFirstRun() checks auth status
-       ↓
-[First Run] → autoDetectAllCredentials()
-       ↓              ↓
-[No]    [Yes - Credentials Found]
-       ↓              ↓
-  Continue      Show Success Toast
-                      ↓
-                 Ready to Code!
-
-User Selects Locked Model
-       ↓
-tryAutoAuthThenPrompt()
-       ↓
-AutoDetectProvider(provider)
-       ↓
-[Found] → Authenticate → Select Model
-       ↓
-[Not Found] → Show API Key Prompt
-
-User Submits Prompt
-       ↓
-AnalyzePromptAndRecommendModel()
-       ↓
-detectTaskType(prompt)
-       ↓
-GetRecommendations(taskType)
-       ↓
-[Better Model Available] → Show Toast
-       ↓
-[Already Optimal] → No Action
-```
-
-## Configuration
-
-All features work out-of-the-box with zero configuration. The system:
-- Uses existing auth bridge infrastructure
-- Respects existing timeouts (2-10 seconds)
-- Fails silently to avoid disruption
-- Provides feedback only when successful
-
-## Performance Impact
-
-- **First Run Detection**: 2-second timeout (one-time per session)
-- **Auto-Detect**: 10-second timeout (background, non-blocking)
-- **Provider-Specific Auto-Detect**: 3-second timeout
-- **Model Recommendations**: 3-second timeout (background, non-blocking)
-
-All operations are:
-- Async and non-blocking
-- Have appropriate timeouts
-- Fail gracefully
-- Log errors for debugging
-
-## Future Enhancements
-
-### Potential Additions
-
-1. **Setup Wizard** (Low Priority)
-   - One-time guided setup for new users
-   - Walks through credential detection
-   - Helps choose default model
-
-2. **Ollama Auto-Detection**
-   - Detect locally running Ollama instance
-   - Auto-configure local models
-   - Show "local" badge in model list
-
-3. **Learning User Preferences**
-   - Track which models user chooses for different tasks
-   - Adjust recommendations based on usage
-   - Remember "dismissed" recommendations
-
-4. **Cost-Aware Recommendations**
-   - Consider cost in recommendations
-   - Show savings potential: "Switch to GPT-4o Mini to save 50%"
-   - Alert when approaching budget limits
-
-5. **Performance-Aware Switching**
-   - Detect slow responses
-   - Suggest faster alternatives
-   - Auto-switch on repeated timeouts
-
-## Testing
-
-### Manual Testing Scenarios
-
-1. **First Run Flow**
-   ```bash
-   # Clear all auth data
-   rm -rf ~/.rycode/auth
-
-   # Open RyCode
-   rycode
-
-   # Expected: Auto-detect runs, shows success toast
-   ```
-
-2. **Locked Model Selection**
-   ```bash
-   # Open model selector
-   /model
-
-   # Select locked provider (e.g., OpenAI if not authenticated)
-   # Expected: Auto-detect tries first, then shows prompt if needed
-   ```
-
-3. **Smart Recommendations**
-   ```bash
-   # Type debugging prompt
-   "Fix the authentication bug in login.ts"
-
-   # Expected: Toast suggesting GPT-4o or similar fast model
-   ```
-
-### Error Handling
-
-All operations fail gracefully:
-- Auth bridge unavailable → Features disabled
-- Timeouts → Silent continuation
-- API errors → Logged, no user disruption
-- Invalid recommendations → Ignored
-
-## Documentation Links
-
-- Auth System: `/packages/rycode/src/auth/`
-- Auth Bridge: `/packages/tui/internal/auth/bridge.go`
-- Model Dialog: `/packages/tui/internal/components/dialog/models.go`
-- App Logic: `/packages/tui/internal/app/app.go`
-
-## Summary
-
-RyCode's intelligent model automation transforms the user experience from:
-
-**Before**: Manual, interrupt-driven model management
-**After**: Automatic, proactive, zero-friction model optimization
-
-Users can now focus entirely on building, while RyCode handles:
-- Credential detection
-- Authentication
-- Model selection
-- Performance optimization
-
-All improvements maintain backward compatibility and fail gracefully to ensure a smooth experience for all users.
diff --git a/packages/tui/LANDING_PAGE_IMPLEMENTATION_PLAN.md b/packages/tui/LANDING_PAGE_IMPLEMENTATION_PLAN.md
deleted file mode 100644
index c612b47b..00000000
--- a/packages/tui/LANDING_PAGE_IMPLEMENTATION_PLAN.md
+++ /dev/null
@@ -1,1679 +0,0 @@
-# RyCode Landing Page - Multi-Agent Implementation Plan
-
-> **Created by:** Claude (Architect), Codex (Engineer), Gemini (Designer), UX Specialist
-> **Target:** ry-code.com launch in 10 weeks
-> **Validation:** Technology stack, risk assessment, resource allocation
-
----
-
-## 🎯 Executive Summary
-
-**Project:** RyCode Landing Page (ry-code.com)
-**Timeline:** 10 weeks (70 days)
-**Team:** 1 full-stack developer + design assets
-**Goal:** High-converting landing page with <30s installation flow
-**Success Metrics:** 15% install rate, 40% toolkit-cli awareness, 60% scroll depth
-
-**Key Deliverables:**
-- 10 responsive landing folds
-- One-click installation script
-- Live terminal demo
-- Performance: Lighthouse 95+, WCAG AA
-- Analytics: Conversion tracking
-- toolkit-cli showcase
-
----
-
-## 👥 Multi-Agent Team Roles
-
-### 🏗️ Claude (Technical Architect)
-**Responsibilities:**
-- Technology stack validation
-- Architecture decisions
-- Performance optimization
-- Security review
-- Infrastructure setup
-
-**Deliverables:**
-- Technical specifications
-- Component architecture
-- API design
-- Performance benchmarks
-
-### 💻 Codex (Senior Engineer)
-**Responsibilities:**
-- Code implementation
-- Component development
-- Install script creation
-- Testing & quality assurance
-- CI/CD pipeline
-
-**Deliverables:**
-- React/Next.js components
-- Install script (bash)
-- Test suite
-- Deployment pipeline
-
-### 🎨 Gemini (Creative Director)
-**Responsibilities:**
-- Visual design system
-- Brand identity
-- Animation design
-- Asset creation
-- Style guide
-
-**Deliverables:**
-- Design mockups (Figma)
-- Color palette
-- Typography system
-- Animation specifications
-- Image/video assets
-
-### 👤 UX Specialist
-**Responsibilities:**
-- User journey mapping
-- Conversion optimization
-- Accessibility audit
-- User testing
-- Analytics setup
-
-**Deliverables:**
-- User flow diagrams
-- Wireframes
-- A/B test plan
-- Accessibility report
-- Analytics dashboard
-
----
-
-## 📊 Phase Overview (10 Weeks)
-
-| Phase | Duration | Focus | Completion |
-|-------|----------|-------|------------|
-| Phase 0: Planning & Design | Week 1-2 | Design system, mockups | 0% |
-| Phase 1: Foundation | Week 3-4 | Next.js setup, core components | 0% |
-| Phase 2: Content Folds | Week 5-6 | 10 landing folds | 0% |
-| Phase 3: Polish & Assets | Week 7-8 | Animations, demos, videos | 0% |
-| Phase 4: Optimization | Week 9 | Performance, SEO, accessibility | 0% |
-| Phase 5: Launch | Week 10 | Testing, deployment, monitoring | 0% |
-
----
-
-## 🔧 Technology Stack Validation
-
-### ⚡ Frontend Framework: Next.js 14 (App Router)
-
-**Validation by Claude (Architect):**
-
-✅ **Selected:** Next.js 14 with App Router
-
-**Reasoning:**
-1. **Server Components** - Faster initial load, better SEO
-2. **Edge Runtime** - Global performance via Vercel Edge Network
-3. **Image Optimization** - Automatic WebP conversion, lazy loading
-4. **Built-in SEO** - Metadata API, sitemap generation
-5. **Fast Refresh** - Instant dev feedback
-6. **TypeScript Native** - Type safety out of the box
-
-**Alternatives Considered:**
-- ❌ **Astro** - Great for content-heavy sites, but lacks rich interactivity
-- ❌ **Remix** - Excellent framework, but smaller ecosystem
-- ❌ **Vanilla React** - No SSR/SSG benefits
-- ❌ **Vue/Nuxt** - Team unfamiliarity, smaller job market
-
-**Risk Assessment:** 🟢 **LOW**
-- Mature ecosystem
-- Excellent documentation
-- Large community
-- Vercel backing
-
-**Technical Debt:** 🟢 **LOW**
-- Widely adopted
-- Long-term support
-- Easy to maintain
-
----
-
-### 🎨 Styling: Tailwind CSS 3.4
-
-**Validation by Gemini (Designer):**
-
-✅ **Selected:** Tailwind CSS 3.4
-
-**Reasoning:**
-1. **Utility-First** - Rapid development, no CSS files
-2. **JIT Compiler** - Instant builds, small bundle size
-3. **Dark Mode Native** - Easy theme switching
-4. **Custom Config** - Full control over design system
-5. **Purge CSS** - Production builds only include used styles
-6. **Plugin Ecosystem** - Typography, forms, animations
-
-**Design System Integration:**
-```javascript
-// tailwind.config.js
-module.exports = {
-  theme: {
-    extend: {
-      colors: {
-        'neural-cyan': '#00ffff',
-        'neural-magenta': '#ff00ff',
-        'matrix-green': '#00ff00',
-        'claude-blue': '#7aa2f7',
-      },
-      fontFamily: {
-        display: ['Inter', 'sans-serif'],
-        mono: ['Fira Code', 'monospace'],
-      },
-      animation: {
-        'float': 'float 6s ease-in-out infinite',
-        'gradient': 'gradient 8s ease infinite',
-      },
-    },
-  },
-  plugins: [
-    require('@tailwindcss/typography'),
-    require('@tailwindcss/forms'),
-  ],
-};
-```
-
-**Alternatives Considered:**
-- ❌ **CSS Modules** - More verbose, harder to maintain
-- ❌ **Styled Components** - Runtime overhead, SSR complexity
-- ❌ **Emotion** - Similar issues to Styled Components
-- ❌ **Vanilla CSS** - No design system, hard to scale
-
-**Risk Assessment:** 🟢 **LOW**
-- Industry standard
-- Excellent performance
-- Easy to learn
-
----
-
-### 🎬 Animations: Framer Motion 11
-
-**Validation by UX Specialist:**
-
-✅ **Selected:** Framer Motion 11
-
-**Reasoning:**
-1. **Declarative API** - Easy to understand and maintain
-2. **Gesture Support** - Drag, tap, hover interactions
-3. **Layout Animations** - Smooth transitions between states
-4. **SVG Support** - Animate complex graphics
-5. **Accessibility** - Respects `prefers-reduced-motion`
-6. **Performance** - GPU-accelerated, 60fps
-
-**Animation Examples:**
-```typescript
-// Fade in up
-export const fadeInUp = {
-  hidden: { opacity: 0, y: 20 },
-  visible: {
-    opacity: 1,
-    y: 0,
-    transition: { duration: 0.6, ease: [0.22, 1, 0.36, 1] }
-  }
-};
-
-// Stagger children
-export const staggerChildren = {
-  visible: {
-    transition: { staggerChildren: 0.1 }
-  }
-};
-
-// Floating orb
-export const floatingOrb = {
-  animate: {
-    y: [-20, 20, -20],
-    transition: {
-      duration: 6,
-      repeat: Infinity,
-      ease: "easeInOut"
-    }
-  }
-};
-```
-
-**Alternatives Considered:**
-- ❌ **React Spring** - More complex API
-- ❌ **GSAP** - Heavier bundle, imperative
-- ❌ **CSS Animations** - Less control, no gesture support
-
-**Risk Assessment:** 🟢 **LOW**
-- Popular choice
-- Great documentation
-- Active maintenance
-
----
-
-### 🖥️ Terminal Demo: Asciinema Player
-
-**Validation by Codex (Engineer):**
-
-✅ **Selected:** Asciinema Player 3.7
-
-**Reasoning:**
-1. **Authentic Terminal Look** - Real terminal recording
-2. **Small Bundle** - ~200KB gzipped
-3. **Playback Controls** - Play, pause, seek
-4. **Copy-Paste** - Users can copy terminal text
-5. **Theming** - Dracula, Monokai, custom themes
-6. **No Backend** - Static `.cast` files
-
-**Implementation:**
-```typescript
-'use client';
-
-import AsciinemaPlayer from 'asciinema-player';
-import 'asciinema-player/dist/bundle/asciinema-player.css';
-import { useEffect, useRef } from 'react';
-
-export function TerminalDemo() {
-  const playerRef = useRef(null);
-
-  useEffect(() => {
-    if (playerRef.current) {
-      AsciinemaPlayer.create(
-        '/demos/rycode-demo.cast',
-        playerRef.current,
-        {
-          theme: 'dracula',
-          poster: 'npt:0:5', // Thumbnail at 5s
-          autoPlay: true,
-          loop: true,
-          fit: 'width',
-          terminalFontSize: '14px',
-        }
-      );
-    }
-  }, []);
-
-  return <div ref={playerRef} className="rounded-lg shadow-2xl" />;
-}
-```
-
-**Recording Workflow:**
-```bash
-# Record RyCode demo
-asciinema rec rycode-demo.cast
-
-# Run demo session
-./rycode
-# [Interactive demo: model switching, insights, etc.]
-# exit
-
-# Upload to site
-cp rycode-demo.cast public/demos/
-```
-
-**Alternatives Considered:**
-- ❌ **xterm.js + Backend** - Too complex, needs WebSocket server
-- ❌ **Pre-recorded Video** - Larger file size, no copy-paste
-- ❌ **Animated GIF** - Poor quality, huge file size
-
-**Risk Assessment:** 🟢 **LOW**
-- Proven technology
-- Self-hosted
-- No dependencies
-
----
-
-### 📊 Analytics: Plausible Analytics
-
-**Validation by UX Specialist:**
-
-✅ **Selected:** Plausible Analytics
-
-**Reasoning:**
-1. **Privacy-Respecting** - No cookies, GDPR compliant
-2. **Lightweight** - <1KB script
-3. **No Impact on Performance** - Lighthouse score unaffected
-4. **Custom Events** - Track conversions
-5. **Real-Time Dashboard** - Live insights
-6. **Self-Hostable** - Optional
-
-**Event Tracking:**
-```typescript
-// Track installation attempts
-window.plausible('install_started', {
-  props: {
-    method: 'curl_script',
-    platform: 'darwin-arm64',
-    source: 'hero_fold'
-  }
-});
-
-// Track feature views
-window.plausible('feature_viewed', {
-  props: {
-    feature: 'splash_screen',
-    scroll_depth: 0.45
-  }
-});
-
-// Track toolkit-cli clicks
-window.plausible('toolkit_link_clicked', {
-  props: {
-    location: 'hero_fold',
-    destination: 'toolkit-cli.com'
-  }
-});
-
-// Track conversions
-window.plausible('installation_completed', {
-  props: {
-    method: 'curl_script',
-    time_to_install: 23
-  }
-});
-```
-
-**Alternatives Considered:**
-- ❌ **Google Analytics** - Privacy concerns, heavy script, cookie consent
-- ❌ **Mixpanel** - Expensive, overkill for landing page
-- ❌ **Amplitude** - Similar to Mixpanel
-- ⚠️ **Vercel Analytics** - Good alternative, but less features
-
-**Risk Assessment:** 🟢 **LOW**
-- Open source
-- Privacy-first
-- Easy integration
-
----
-
-### 🌐 Hosting: Vercel
-
-**Validation by Claude (Architect):**
-
-✅ **Selected:** Vercel
-
-**Reasoning:**
-1. **Next.js Native** - Built by same team, perfect integration
-2. **Edge Network** - Global CDN, <100ms latency
-3. **Zero Config** - Push to deploy
-4. **Preview Deployments** - PR previews automatically
-5. **Analytics Built-In** - Core Web Vitals tracking
-6. **DDoS Protection** - Built-in security
-7. **Free Tier** - Generous limits for landing page
-
-**Deployment Workflow:**
-```bash
-# Connect GitHub repo
-vercel link
-
-# Deploy to preview
-git push origin feature/new-fold
-# → Automatic preview URL
-
-# Deploy to production
-git push origin main
-# → Automatic production deployment
-```
-
-**Performance Features:**
-- Image optimization (automatic WebP)
-- Edge Functions (0ms cold start)
-- ISR (Incremental Static Regeneration)
-- Edge caching (stale-while-revalidate)
-
-**Alternatives Considered:**
-- ❌ **Netlify** - Good, but less Next.js optimization
-- ❌ **AWS Amplify** - More complex setup
-- ❌ **Cloudflare Pages** - New, less mature
-- ❌ **Self-hosted** - Maintenance overhead
-
-**Risk Assessment:** 🟢 **LOW**
-- Industry leader
-- Excellent support
-- 99.99% uptime SLA
-
----
-
-## 📋 Phase 0: Planning & Design (Week 1-2)
-
-### Week 1: Design System & Mockups
-
-**Owner:** Gemini (Creative Director) + UX Specialist
-
-**Tasks:**
-
-1. **Design System Foundation** (2 days)
-   - Color palette definition
-   - Typography scale
-   - Spacing system
-   - Component tokens
-   - Dark mode rules
-
-2. **Figma Mockups** (3 days)
-   - Hero fold (3 variants for A/B testing)
-   - Feature showcase fold
-   - Performance metrics fold
-   - AI intelligence fold
-   - Accessibility fold
-   - toolkit-cli showcase fold
-   - Mobile responsive layouts
-
-3. **Animation Specifications** (1 day)
-   - Floating orbs behavior
-   - Neural cortex animation timing
-   - Scroll-triggered animations
-   - Button micro-interactions
-   - Loading states
-
-4. **Asset Planning** (1 day)
-   - Neural cortex video requirements
-   - Feature demo GIFs list
-   - Screenshot specifications
-   - Icon requirements
-   - Social media assets
-
-**Deliverables:**
-- ✅ Figma design file with 10 folds
-- ✅ Design tokens (JSON export)
-- ✅ Animation specifications (Lottie/video)
-- ✅ Asset requirements document
-
-**Acceptance Criteria:**
-- [ ] All 10 folds designed for desktop (1440px)
-- [ ] Mobile layouts for all folds (375px)
-- [ ] Dark mode variants
-- [ ] Accessibility considerations documented
-- [ ] Brand consistency with toolkit-cli.com
-- [ ] Stakeholder approval
-
----
-
-### Week 2: Technical Setup & Architecture
-
-**Owner:** Claude (Architect) + Codex (Engineer)
-
-**Tasks:**
-
-1. **Project Initialization** (1 day)
-   ```bash
-   npx create-next-app@latest rycode-landing \
-     --typescript \
-     --tailwind \
-     --app \
-     --eslint
-
-   cd rycode-landing
-   npm install framer-motion asciinema-player
-   npm install -D @tailwindcss/typography @tailwindcss/forms
-   ```
-
-2. **Repository Setup** (1 day)
-   - GitHub repository creation
-   - Branch protection rules
-   - CI/CD pipeline (GitHub Actions)
-   - Vercel integration
-   - Environment variables
-
-3. **Component Architecture** (2 days)
-   ```
-   src/
-   ├── app/
-   │   ├── layout.tsx
-   │   ├── page.tsx
-   │   └── globals.css
-   ├── components/
-   │   ├── folds/
-   │   │   ├── HeroFold.tsx
-   │   │   ├── FeatureShowcase.tsx
-   │   │   ├── LiveDemo.tsx
-   │   │   ├── PerformanceMetrics.tsx
-   │   │   ├── AIIntelligence.tsx
-   │   │   ├── AccessibilityFold.tsx
-   │   │   ├── EasterEggsFold.tsx
-   │   │   ├── ToolkitShowcase.tsx
-   │   │   ├── InstallationGuide.tsx
-   │   │   └── FinalCTA.tsx
-   │   ├── ui/
-   │   │   ├── Button.tsx
-   │   │   ├── Card.tsx
-   │   │   ├── CodeBlock.tsx
-   │   │   └── AnimatedCounter.tsx
-   │   └── animations/
-   │       ├── NeuralCortex.tsx
-   │       ├── FloatingOrbs.tsx
-   │       └── variants.ts
-   ├── lib/
-   │   ├── analytics.ts
-   │   └── utils.ts
-   └── styles/
-       └── globals.css
-   ```
-
-4. **Design System Implementation** (2 days)
-   - Tailwind config with design tokens
-   - Typography components
-   - Color utilities
-   - Animation variants
-   - Responsive breakpoints
-
-5. **Install Script Development** (1 day)
-   ```bash
-   # Create install script
-   touch public/install.sh
-   chmod +x public/install.sh
-   ```
-
-**Deliverables:**
-- ✅ Next.js 14 project initialized
-- ✅ GitHub repo + CI/CD
-- ✅ Component structure
-- ✅ Tailwind design system
-- ✅ Install script (v1)
-
-**Acceptance Criteria:**
-- [ ] Project builds successfully
-- [ ] Vercel preview deployment works
-- [ ] Design tokens match Figma
-- [ ] Install script detects platform
-- [ ] CI passes (lint, type-check)
-
----
-
-## 📋 Phase 1: Foundation (Week 3-4)
-
-### Week 3: Core Components & Navigation
-
-**Owner:** Codex (Engineer)
-
-**Tasks:**
-
-1. **Navigation Component** (1 day)
-   ```typescript
-   // components/Navigation.tsx
-   'use client';
-
-   import { useState, useEffect } from 'react';
-   import { motion } from 'framer-motion';
-
-   export function Navigation() {
-     const [isScrolled, setIsScrolled] = useState(false);
-
-     useEffect(() => {
-       const handleScroll = () => {
-         setIsScrolled(window.scrollY > 50);
-       };
-       window.addEventListener('scroll', handleScroll);
-       return () => window.removeEventListener('scroll', handleScroll);
-     }, []);
-
-     return (
-       <motion.nav
-         className={`fixed top-0 w-full z-50 transition-colors ${
-           isScrolled ? 'bg-bg-dark/90 backdrop-blur-md' : 'bg-transparent'
-         }`}
-       >
-         <div className="container mx-auto px-6 py-4 flex justify-between items-center">
-           <div className="flex items-center gap-2">
-             <span className="text-2xl">🌀</span>
-             <span className="text-xl font-bold">RyCode</span>
-           </div>
-
-           <div className="hidden md:flex gap-6">
-             <a href="#features" className="hover:text-neural-cyan transition-colors">
-               Features
-             </a>
-             <a href="#demo" className="hover:text-neural-cyan transition-colors">
-               Demo
-             </a>
-             <a href="/docs" className="hover:text-neural-cyan transition-colors">
-               Docs
-             </a>
-             <a
-               href="https://github.com/aaronmrosenthal/rycode"
-               target="_blank"
-               rel="noopener noreferrer"
-               className="hover:text-neural-cyan transition-colors"
-             >
-               GitHub
-             </a>
-           </div>
-
-           <a
-             href="https://toolkit-cli.com"
-             target="_blank"
-             rel="noopener noreferrer"
-             className="px-4 py-2 rounded-lg bg-matrix-green/10 hover:bg-matrix-green/20 transition-colors text-matrix-green text-sm font-semibold"
-           >
-             Built with toolkit-cli →
-           </a>
-         </div>
-       </motion.nav>
-     );
-   }
-   ```
-
-2. **Button Components** (1 day)
-   - Primary CTA button
-   - Secondary button
-   - Icon button
-   - Copy button (with success state)
-   - Loading states
-
-3. **Card Components** (1 day)
-   - Feature card (hover effects)
-   - Metric card (animated counter)
-   - Testimonial card
-   - Provider card (AI models)
-
-4. **Code Block Component** (1 day)
-   ```typescript
-   // components/ui/CodeBlock.tsx
-   'use client';
-
-   import { useState } from 'react';
-   import { motion, AnimatePresence } from 'framer-motion';
-
-   interface CodeBlockProps {
-     code: string;
-     language?: string;
-     showCopy?: boolean;
-   }
-
-   export function CodeBlock({ code, language = 'bash', showCopy = true }: CodeBlockProps) {
-     const [copied, setCopied] = useState(false);
-
-     const handleCopy = async () => {
-       await navigator.clipboard.writeText(code);
-       setCopied(true);
-       setTimeout(() => setCopied(false), 2000);
-     };
-
-     return (
-       <div className="relative group">
-         <pre className="bg-bg-elevated rounded-lg p-6 overflow-x-auto font-mono text-sm border border-neural-cyan/10">
-           <code className={`language-${language}`}>{code}</code>
-         </pre>
-
-         {showCopy && (
-           <button
-             onClick={handleCopy}
-             className="absolute top-4 right-4 px-3 py-1 rounded bg-neural-cyan/10 hover:bg-neural-cyan/20 transition-colors text-neural-cyan text-xs font-semibold"
-           >
-             <AnimatePresence mode="wait">
-               {copied ? (
-                 <motion.span
-                   key="copied"
-                   initial={{ opacity: 0, y: -10 }}
-                   animate={{ opacity: 1, y: 0 }}
-                   exit={{ opacity: 0, y: 10 }}
-                 >
-                   Copied! ✓
-                 </motion.span>
-               ) : (
-                 <motion.span
-                   key="copy"
-                   initial={{ opacity: 0, y: -10 }}
-                   animate={{ opacity: 1, y: 0 }}
-                   exit={{ opacity: 0, y: 10 }}
-                 >
-                   Copy
-                 </motion.span>
-               )}
-             </AnimatePresence>
-           </button>
-         )}
-       </div>
-     );
-   }
-   ```
-
-5. **Animation Utilities** (1 day)
-   - Framer Motion variants library
-   - Scroll-triggered animations
-   - Intersection Observer hook
-   - Floating orbs component
-
-**Deliverables:**
-- ✅ Navigation (sticky, responsive)
-- ✅ Button components (5 variants)
-- ✅ Card components (4 types)
-- ✅ Code block with copy
-- ✅ Animation utilities
-
-**Acceptance Criteria:**
-- [ ] All components responsive (mobile → desktop)
-- [ ] Animations respect `prefers-reduced-motion`
-- [ ] Dark mode support
-- [ ] TypeScript types complete
-- [ ] Accessibility (keyboard nav, ARIA labels)
-
----
-
-### Week 4: Hero Fold + Installation
-
-**Owner:** Codex (Engineer) + Gemini (Designer)
-
-**Tasks:**
-
-1. **Neural Cortex Animation** (2 days)
-
-   **Option A: Canvas-based (Recommended)**
-   ```typescript
-   // components/animations/NeuralCortex.tsx
-   'use client';
-
-   import { useEffect, useRef } from 'react';
-
-   export function NeuralCortex() {
-     const canvasRef = useRef<HTMLCanvasElement>(null);
-
-     useEffect(() => {
-       const canvas = canvasRef.current;
-       if (!canvas) return;
-
-       const ctx = canvas.getContext('2d');
-       if (!ctx) return;
-
-       // Set canvas size
-       canvas.width = 600;
-       canvas.height = 400;
-
-       let frame = 0;
-       const fps = 30;
-       const interval = 1000 / fps;
-       let lastTime = 0;
-
-       // Torus rendering parameters
-       const R = 2; // Major radius
-       const r = 1; // Minor radius
-
-       function render(timestamp: number) {
-         if (timestamp - lastTime < interval) {
-           requestAnimationFrame(render);
-           return;
-         }
-         lastTime = timestamp;
-
-         // Clear canvas
-         ctx.fillStyle = '#0a0a0f';
-         ctx.fillRect(0, 0, canvas.width, canvas.height);
-
-         // Rotation angles
-         const A = frame * 0.04;
-         const B = frame * 0.02;
-
-         // Render torus (simplified version)
-         const sinA = Math.sin(A);
-         const cosA = Math.cos(A);
-         const sinB = Math.sin(B);
-         const cosB = Math.cos(B);
-
-         for (let theta = 0; theta < Math.PI * 2; theta += 0.1) {
-           for (let phi = 0; phi < Math.PI * 2; phi += 0.05) {
-             const sinTheta = Math.sin(theta);
-             const cosTheta = Math.cos(theta);
-             const sinPhi = Math.sin(phi);
-             const cosPhi = Math.cos(phi);
-
-             const circleX = R + r * cosPhi;
-             const circleY = r * sinPhi;
-
-             const x = circleX * (cosB * cosTheta + sinA * sinB * sinTheta) - circleY * cosA * sinB;
-             const y = circleX * (sinB * cosTheta - sinA * cosB * sinTheta) + circleY * cosA * cosB;
-             const z = 5 + cosA * circleX * sinTheta + circleY * sinA;
-
-             const ooz = 1 / z;
-             const xp = canvas.width / 2 + 60 * ooz * x;
-             const yp = canvas.height / 2 - 30 * ooz * y;
-
-             // Luminance for color
-             const L = cosPhi * cosTheta * sinB - cosA * cosTheta * sinPhi - sinA * sinTheta;
-
-             // Gradient color (cyan to magenta)
-             const t = (L + 1) / 2;
-             const r = Math.floor(255 * t);
-             const g = Math.floor(255 * (1 - t) * t * 4);
-             const b = 255;
-
-             ctx.fillStyle = `rgb(${r}, ${g}, ${b})`;
-             ctx.fillRect(xp, yp, 2, 2);
-           }
-         }
-
-         frame++;
-         requestAnimationFrame(render);
-       }
-
-       requestAnimationFrame(render);
-     }, []);
-
-     return (
-       <canvas
-         ref={canvasRef}
-         className="w-full max-w-2xl mx-auto rounded-lg shadow-2xl"
-         style={{ imageRendering: 'crisp-edges' }}
-       />
-     );
-   }
-   ```
-
-2. **Hero Fold Component** (2 days)
-   ```typescript
-   // components/folds/HeroFold.tsx
-   'use client';
-
-   import { motion } from 'framer-motion';
-   import { NeuralCortex } from '@/components/animations/NeuralCortex';
-   import { InstallCommand } from '@/components/ui/InstallCommand';
-
-   export function HeroFold() {
-     return (
-       <section className="relative min-h-screen flex items-center justify-center overflow-hidden bg-gradient-to-b from-bg-dark to-bg-elevated">
-         {/* Floating Background Orbs */}
-         <div className="absolute inset-0">
-           <motion.div
-             className="absolute top-20 left-20 w-64 h-64 bg-neural-cyan/20 rounded-full blur-3xl"
-             animate={{
-               y: [-20, 20, -20],
-               transition: { duration: 6, repeat: Infinity, ease: "easeInOut" }
-             }}
-           />
-           <motion.div
-             className="absolute bottom-20 right-20 w-96 h-96 bg-neural-magenta/20 rounded-full blur-3xl"
-             animate={{
-               y: [20, -20, 20],
-               transition: { duration: 8, repeat: Infinity, ease: "easeInOut" }
-             }}
-           />
-         </div>
-
-         {/* Content */}
-         <div className="relative z-10 container mx-auto px-6 py-20">
-           <motion.div
-             initial={{ opacity: 0 }}
-             animate={{ opacity: 1 }}
-             transition={{ staggerChildren: 0.1 }}
-             className="max-w-5xl mx-auto text-center"
-           >
-             {/* Neural Cortex */}
-             <motion.div
-               initial={{ opacity: 0, y: 20 }}
-               animate={{ opacity: 1, y: 0 }}
-               transition={{ duration: 0.6 }}
-               className="mb-12"
-             >
-               <NeuralCortex />
-             </motion.div>
-
-             {/* Hero Text */}
-             <motion.h1
-               initial={{ opacity: 0, y: 20 }}
-               animate={{ opacity: 1, y: 0 }}
-               transition={{ duration: 0.6, delay: 0.2 }}
-               className="text-5xl md:text-7xl font-bold mb-6 bg-gradient-to-r from-neural-cyan via-claude-blue to-neural-magenta bg-clip-text text-transparent"
-             >
-               AI-Powered Development Assistant
-             </motion.h1>
-
-             <motion.p
-               initial={{ opacity: 0, y: 20 }}
-               animate={{ opacity: 1, y: 0 }}
-               transition={{ duration: 0.6, delay: 0.3 }}
-               className="text-2xl text-text-secondary mb-4"
-             >
-               Built by AI, for Developers
-             </motion.p>
-
-             <motion.p
-               initial={{ opacity: 0, y: 20 }}
-               animate={{ opacity: 1, y: 0 }}
-               transition={{ duration: 0.6, delay: 0.4 }}
-               className="text-xl text-text-muted mb-12"
-             >
-               6 AI Models • 1 Command Line • 60fps • 19MB • 9 Accessibility Modes
-             </motion.p>
-
-             {/* Installation */}
-             <motion.div
-               initial={{ opacity: 0, scale: 0.9 }}
-               animate={{ opacity: 1, scale: 1 }}
-               transition={{ duration: 0.5, delay: 0.5 }}
-             >
-               <InstallCommand />
-             </motion.div>
-
-             {/* toolkit-cli Link */}
-             <motion.a
-               initial={{ opacity: 0 }}
-               animate={{ opacity: 1 }}
-               transition={{ duration: 0.6, delay: 0.6 }}
-               href="https://toolkit-cli.com"
-               target="_blank"
-               rel="noopener noreferrer"
-               className="inline-flex items-center gap-2 mt-8 px-6 py-3 rounded-lg bg-bg-elevated hover:bg-bg-hover transition-colors group"
-             >
-               <span className="text-sm text-text-secondary group-hover:text-text-primary transition-colors">
-                 Built with
-               </span>
-               <span className="text-sm font-semibold text-matrix-green">
-                 toolkit-cli
-               </span>
-               <span className="text-neural-cyan">→</span>
-             </motion.a>
-           </motion.div>
-         </div>
-
-         {/* Scroll Indicator */}
-         <motion.div
-           className="absolute bottom-8 left-1/2 -translate-x-1/2"
-           animate={{ y: [0, 10, 0] }}
-           transition={{ duration: 2, repeat: Infinity }}
-         >
-           <span className="text-text-muted text-sm">Scroll to explore ↓</span>
-         </motion.div>
-       </section>
-     );
-   }
-   ```
-
-3. **Install Command Component** (1 day)
-   - Command display with syntax highlighting
-   - Copy button with success animation
-   - Platform detection
-   - Multiple install methods (tabs)
-
-4. **Platform Selector** (1 day)
-   - macOS ARM64 / Intel
-   - Linux ARM64 / AMD64
-   - Windows AMD64
-   - Auto-detection with manual override
-
-**Deliverables:**
-- ✅ Neural cortex animation (Canvas or WebGL)
-- ✅ Hero fold complete
-- ✅ Install command with copy
-- ✅ Platform selector
-
-**Acceptance Criteria:**
-- [ ] Neural cortex runs at 30 FPS
-- [ ] Animation respects reduced motion
-- [ ] Installation command copies correctly
-- [ ] Platform auto-detected
-- [ ] Mobile responsive
-- [ ] Lighthouse performance >90
-
----
-
-## 📋 Phase 2: Content Folds (Week 5-6)
-
-### Week 5: Feature Showcase + Performance Metrics
-
-**Owner:** Codex (Engineer) + Gemini (Designer)
-
-**Tasks:**
-
-1. **Feature Showcase Fold** (2 days)
-   - Grid layout (3×2 on desktop, 1 col on mobile)
-   - Feature cards with hover effects
-   - Animated metrics
-   - "Show All" expansion
-   - Modal with detailed feature info
-
-2. **Performance Metrics Fold** (2 days)
-   - Animated counters (count-up animation)
-   - Metric cards with icons
-   - Comparison charts
-   - Benchmark details
-   - Tooltip explanations
-
-3. **AI Intelligence Fold** (1 day)
-   - Provider logos/icons
-   - Feature list with icons
-   - Interactive model selector
-   - Comparison table
-
-**Deliverables:**
-- ✅ Feature showcase (6+ features)
-- ✅ Performance metrics (4 key metrics)
-- ✅ AI intelligence showcase
-
----
-
-### Week 6: Live Demo + Accessibility + Easter Eggs
-
-**Owner:** Codex (Engineer)
-
-**Tasks:**
-
-1. **Live Demo Terminal** (2 days)
-   - Record Asciinema demo
-   - Integrate Asciinema Player
-   - Playback controls
-   - Poster frame
-   - Loading state
-
-2. **Accessibility Fold** (1 day)
-   - 9 accessibility modes showcase
-   - Toggle demos (before/after)
-   - Feature list
-   - WCAG compliance badges
-
-3. **Easter Eggs Fold** (1 day)
-   - Spoiler tag reveals
-   - Animated discoveries
-   - Interactive demos
-   - "Try it yourself" CTAs
-
-4. **toolkit-cli Showcase** (1 day)
-   - Multi-agent collaboration visual
-   - Case study highlights
-   - Link to full case study
-   - "Built with toolkit-cli" branding
-
-**Deliverables:**
-- ✅ Asciinema terminal demo
-- ✅ Accessibility showcase
-- ✅ Easter eggs fold
-- ✅ toolkit-cli showcase
-
-**Acceptance Criteria:**
-- [ ] Asciinema player loads <500ms
-- [ ] Demo auto-loops
-- [ ] Accessibility features clearly explained
-- [ ] toolkit-cli attribution prominent
-
----
-
-## 📋 Phase 3: Polish & Assets (Week 7-8)
-
-### Week 7: Asset Creation + Final Folds
-
-**Owner:** Gemini (Designer) + Codex (Engineer)
-
-**Tasks:**
-
-1. **Video/GIF Creation** (3 days)
-   - Neural cortex demo (3-5s loop)
-   - Feature demos (5 GIFs)
-   - Easter egg reveals
-   - Performance comparisons
-   - Accessibility modes
-
-2. **Installation Guide Fold** (1 day)
-   - Tab navigation (Quick / Manual / Build)
-   - Multi-platform instructions
-   - Troubleshooting section
-   - Links to documentation
-
-3. **Final CTA Fold** (1 day)
-   - Testimonial carousel
-   - Social proof (GitHub stars, downloads)
-   - Final install CTA
-   - Newsletter signup (optional)
-
-**Deliverables:**
-- ✅ 6+ video/GIF assets
-- ✅ Installation guide fold
-- ✅ Final CTA fold
-- ✅ Social media assets (OG images, Twitter cards)
-
----
-
-### Week 8: Responsive Design + Micro-interactions
-
-**Owner:** Codex (Engineer) + UX Specialist
-
-**Tasks:**
-
-1. **Mobile Optimization** (2 days)
-   - Responsive layouts for all folds
-   - Touch-friendly interactions
-   - Mobile navigation (hamburger menu)
-   - Performance optimization (lazy loading)
-
-2. **Micro-interactions** (2 days)
-   - Button hover effects
-   - Card reveal animations
-   - Scroll-triggered animations
-   - Loading states
-   - Error states
-
-3. **Cross-Browser Testing** (1 day)
-   - Chrome, Firefox, Safari, Edge
-   - Mobile browsers (iOS Safari, Chrome Android)
-   - Fix browser-specific issues
-
-**Deliverables:**
-- ✅ All folds responsive (320px → 1920px+)
-- ✅ Micro-interactions polished
-- ✅ Cross-browser compatible
-
-**Acceptance Criteria:**
-- [ ] Mobile usability score 90+
-- [ ] All interactions smooth (60fps)
-- [ ] No layout shifts (CLS < 0.1)
-- [ ] Works on iOS Safari 14+
-
----
-
-## 📋 Phase 4: Optimization (Week 9)
-
-### Week 9: Performance, SEO, Accessibility
-
-**Owner:** Claude (Architect) + UX Specialist
-
-**Tasks:**
-
-1. **Performance Optimization** (2 days)
-   - Image optimization (WebP, lazy loading)
-   - Code splitting
-   - Bundle size reduction
-   - Font optimization
-   - Critical CSS inlining
-   - Lighthouse audit & fixes
-
-2. **SEO Optimization** (1 day)
-   - Meta tags (title, description, OG, Twitter)
-   - Structured data (Schema.org)
-   - Sitemap generation
-   - robots.txt
-   - Canonical URLs
-   - Internal linking
-
-3. **Accessibility Audit** (1 day)
-   - WCAG AA compliance check
-   - Keyboard navigation testing
-   - Screen reader testing (NVDA, VoiceOver)
-   - Color contrast validation
-   - ARIA labels review
-   - Focus management
-
-4. **Analytics Setup** (1 day)
-   - Plausible integration
-   - Event tracking
-   - Custom goals
-   - Funnel visualization
-   - Dashboard setup
-
-**Deliverables:**
-- ✅ Lighthouse score 95+ (all categories)
-- ✅ SEO optimized (meta tags, structured data)
-- ✅ WCAG AA compliant
-- ✅ Analytics tracking
-
-**Acceptance Criteria:**
-- [ ] First Contentful Paint < 1.5s
-- [ ] Largest Contentful Paint < 2.5s
-- [ ] Time to Interactive < 3.5s
-- [ ] Cumulative Layout Shift < 0.1
-- [ ] Total Blocking Time < 300ms
-- [ ] Accessibility score 100
-- [ ] SEO score 100
-
----
-
-## 📋 Phase 5: Launch (Week 10)
-
-### Week 10: Testing, Deployment, Monitoring
-
-**Owner:** Full Team
-
-**Tasks:**
-
-1. **Final Testing** (2 days)
-   - End-to-end testing (user flows)
-   - Install script testing (all platforms)
-   - Link validation
-   - Form validation
-   - Error handling
-   - Edge case testing
-
-2. **DNS & SSL Setup** (1 day)
-   - Domain configuration (ry-code.com)
-   - SSL certificate
-   - DNS propagation verification
-   - Subdomain setup (docs.ry-code.com)
-
-3. **Production Deployment** (1 day)
-   - Vercel production deployment
-   - Environment variables
-   - Build verification
-   - Cache warming
-   - CDN configuration
-
-4. **Launch Activities** (1 day)
-   - Social media announcement (Twitter, LinkedIn)
-   - toolkit-cli.com link update
-   - GitHub repository link
-   - ProductHunt launch (optional)
-   - Hacker News post (optional)
-
-5. **Post-Launch Monitoring** (Ongoing)
-   - Analytics monitoring
-   - Error tracking (Sentry integration)
-   - User feedback collection
-   - Performance monitoring
-   - Conversion rate optimization
-
-**Deliverables:**
-- ✅ Production site live at ry-code.com
-- ✅ Install script accessible
-- ✅ Analytics tracking
-- ✅ Monitoring dashboard
-
-**Acceptance Criteria:**
-- [ ] Site loads successfully from all regions
-- [ ] Install script works on all platforms
-- [ ] All links functional
-- [ ] SSL certificate valid
-- [ ] Analytics receiving data
-- [ ] Error tracking configured
-
----
-
-## 📊 Success Metrics & KPIs
-
-### Primary Metrics (30 Days Post-Launch)
-
-| Metric | Target | Measurement |
-|--------|--------|-------------|
-| **Install Conversion Rate** | 15% | Visitors → Installations |
-| **toolkit-cli Awareness** | 40% | Clicks to toolkit-cli.com |
-| **Feature Discovery** | 60% | Scroll depth beyond fold 3 |
-| **Time to Installation** | <30s | From page load to install |
-| **Bounce Rate** | <40% | Single-page sessions |
-| **Average Session Duration** | >2min | Time on site |
-| **Pages Per Session** | 1.5+ | Hero + 1 other page |
-| **Demo Completion Rate** | 60% | Video watched to end |
-
-### Secondary Metrics
-
-- **Lighthouse Performance:** 95+
-- **Mobile Usability:** 90+
-- **Accessibility Score:** 100
-- **SEO Score:** 100
-- **Page Load Time:** <1.5s (FCP)
-- **Error Rate:** <0.1%
-
-### Conversion Funnel
-
-```
-Visitor → Scroll to Hero (100%)
-  ↓
-Engage with Demo (60%)
-  ↓
-Click Install (25%)
-  ↓
-Copy Command (20%)
-  ↓
-Complete Install (15%)
-  ↓
-Visit toolkit-cli (6%)
-```
-
----
-
-## ⚠️ Risk Assessment
-
-### Technical Risks
-
-| Risk | Severity | Probability | Mitigation |
-|------|----------|-------------|------------|
-| **Neural cortex performance** | 🟡 Medium | 30% | Use Canvas instead of WebGL, optimize rendering, add performance monitoring |
-| **Install script compatibility** | 🔴 High | 40% | Test on all platforms early, checksum verification, fallback to manual download |
-| **Browser compatibility** | 🟡 Medium | 25% | Test on all major browsers, polyfills for older browsers, graceful degradation |
-| **Accessibility issues** | 🟡 Medium | 20% | Early accessibility audit, screen reader testing, keyboard nav testing |
-| **Performance regression** | 🟢 Low | 15% | Continuous Lighthouse monitoring, bundle size tracking, image optimization |
-
-### Business Risks
-
-| Risk | Severity | Probability | Mitigation |
-|------|----------|-------------|------------|
-| **Low conversion rate** | 🟡 Medium | 30% | A/B test CTAs, optimize install flow, user testing |
-| **toolkit-cli attribution missed** | 🟡 Medium | 25% | Multiple prominent placements, dedicated fold, consistent branding |
-| **Poor SEO ranking** | 🟢 Low | 20% | Quality content, technical SEO, backlinks, schema markup |
-| **Negative feedback** | 🟢 Low | 15% | User testing before launch, feedback widget, responsive support |
-
-### Timeline Risks
-
-| Risk | Severity | Probability | Mitigation |
-|------|----------|-------------|------------|
-| **Design delays** | 🟡 Medium | 25% | Start with design system, parallel work on components, use Tailwind UI for speed |
-| **Asset creation bottleneck** | 🟡 Medium | 30% | Start recording demos early, use placeholders, prioritize critical assets |
-| **Performance optimization** | 🟢 Low | 15% | Build with performance in mind from start, use Next.js best practices |
-| **Testing insufficient** | 🟡 Medium | 20% | Allocate full week for testing, automated tests, multiple reviewers |
-
----
-
-## 💰 Resource Allocation
-
-### Team
-
-- **1 Full-Stack Developer** (10 weeks, full-time)
-  - Week 1-2: Setup & architecture
-  - Week 3-4: Core components
-  - Week 5-6: Content folds
-  - Week 7-8: Polish & assets
-  - Week 9: Optimization
-  - Week 10: Launch
-
-- **Design Assets** (Contract/Outsource)
-  - Neural cortex animation: 2 days
-  - Feature demo GIFs: 3 days
-  - Social media assets: 1 day
-
-### Infrastructure Costs
-
-- **Vercel Hosting:** $0/month (free tier sufficient)
-- **Domain (ry-code.com):** $12/year
-- **Plausible Analytics:** $9/month (startup plan)
-- **Figma:** $12/month (professional plan)
-
-**Total Monthly Cost:** ~$21/month
-
----
-
-## 🎯 Dependencies & Blockers
-
-### External Dependencies
-
-1. **RyCode Binaries**
-   - Need release artifacts for all platforms
-   - Checksum files for verification
-   - GitHub releases setup
-
-2. **toolkit-cli.com Coordination**
-   - Confirm link placement
-   - Coordinate launch announcements
-   - Ensure branding consistency
-
-3. **Demo Recording**
-   - Working RyCode installation
-   - Demo script preparation
-   - Asciinema recording session
-
-4. **Design Assets**
-   - Neural cortex animation (video/Canvas)
-   - Feature GIFs
-   - Screenshots
-   - Social media graphics
-
-### Internal Blockers
-
-1. **Design Approval**
-   - Stakeholder review (Week 2)
-   - Iteration on mockups
-   - Final sign-off
-
-2. **Content Creation**
-   - Copy for each fold
-   - Feature descriptions
-   - Installation instructions
-   - Error messages
-
-3. **Technical Decisions**
-   - Neural cortex implementation (Canvas vs WebGL)
-   - Install script architecture
-   - Analytics provider choice
-
----
-
-## 📝 Quality Checklist
-
-### Code Quality
-
-- [ ] TypeScript strict mode enabled
-- [ ] ESLint rules passing
-- [ ] Prettier formatting applied
-- [ ] No console errors
-- [ ] No TypeScript errors
-- [ ] Components properly typed
-- [ ] Meaningful variable names
-- [ ] Comments for complex logic
-
-### Performance
-
-- [ ] Lighthouse Performance: 95+
-- [ ] First Contentful Paint: <1.5s
-- [ ] Largest Contentful Paint: <2.5s
-- [ ] Time to Interactive: <3.5s
-- [ ] Cumulative Layout Shift: <0.1
-- [ ] Total Blocking Time: <300ms
-- [ ] Bundle size optimized
-- [ ] Images optimized (WebP)
-
-### Accessibility
-
-- [ ] Lighthouse Accessibility: 100
-- [ ] WCAG AA compliant
-- [ ] Keyboard navigation complete
-- [ ] Screen reader tested (NVDA, VoiceOver)
-- [ ] Color contrast AAA (where possible)
-- [ ] Focus indicators visible
-- [ ] ARIA labels present
-- [ ] Alt text on images
-
-### SEO
-
-- [ ] Lighthouse SEO: 100
-- [ ] Meta tags complete
-- [ ] Open Graph tags
-- [ ] Twitter Card tags
-- [ ] Structured data (Schema.org)
-- [ ] Sitemap generated
-- [ ] robots.txt configured
-- [ ] Canonical URLs set
-
-### Cross-Browser
-
-- [ ] Chrome (latest)
-- [ ] Firefox (latest)
-- [ ] Safari (latest)
-- [ ] Edge (latest)
-- [ ] iOS Safari 14+
-- [ ] Chrome Android
-- [ ] No console errors (any browser)
-
-### Mobile
-
-- [ ] Responsive 320px → 1920px+
-- [ ] Touch-friendly (44px minimum)
-- [ ] Mobile navigation works
-- [ ] No horizontal scroll
-- [ ] Text readable without zoom
-- [ ] Forms mobile-optimized
-
----
-
-## 🚀 Launch Checklist
-
-### Pre-Launch (T-7 days)
-
-- [ ] All folds complete and tested
-- [ ] Install script tested on all platforms
-- [ ] Performance optimizations applied
-- [ ] SEO optimizations applied
-- [ ] Accessibility audit passed
-- [ ] Cross-browser testing passed
-- [ ] Mobile testing passed
-- [ ] Analytics configured
-- [ ] Error tracking setup (Sentry)
-
-### Pre-Launch (T-3 days)
-
-- [ ] Final stakeholder review
-- [ ] Content proofread
-- [ ] Links validated
-- [ ] Forms tested
-- [ ] DNS configured
-- [ ] SSL certificate ready
-- [ ] Vercel production deployment tested
-
-### Launch Day (T-0)
-
-- [ ] Production deployment
-- [ ] DNS propagation verified
-- [ ] Install script accessible
-- [ ] Analytics receiving data
-- [ ] Social media posts scheduled
-- [ ] toolkit-cli.com link updated
-- [ ] GitHub README link updated
-- [ ] Monitor error rate
-- [ ] Monitor conversion rate
-
-### Post-Launch (T+1 week)
-
-- [ ] Review analytics data
-- [ ] Collect user feedback
-- [ ] Fix critical bugs
-- [ ] Optimize based on data
-- [ ] Plan A/B tests
-- [ ] Document learnings
-
----
-
-## 📞 Communication Plan
-
-### Weekly Updates
-
-**Every Friday:**
-- Progress report (% complete per phase)
-- Blockers and risks
-- Next week's plan
-- Demo of work completed
-
-### Stakeholder Reviews
-
-**Week 2:** Design mockups review
-**Week 4:** Core components review
-**Week 6:** Content folds review
-**Week 8:** Full site review
-**Week 9:** Final review before launch
-
-### Launch Announcement
-
-**Channels:**
-- Twitter (toolkit-cli account + personal)
-- LinkedIn (toolkit-cli company page)
-- GitHub (RyCode repo README)
-- toolkit-cli.com homepage
-- ProductHunt (optional)
-- Hacker News (optional)
-
----
-
-## 🎓 Success Criteria
-
-### Phase 0 (Week 1-2)
-- ✅ Design mockups approved
-- ✅ Next.js project initialized
-- ✅ Component architecture defined
-- ✅ Install script v1 complete
-
-### Phase 1 (Week 3-4)
-- ✅ Core components built
-- ✅ Hero fold complete
-- ✅ Installation flow working
-- ✅ Neural cortex animating
-
-### Phase 2 (Week 5-6)
-- ✅ All 10 folds implemented
-- ✅ Content complete
-- ✅ Responsive design
-- ✅ Live demo integrated
-
-### Phase 3 (Week 7-8)
-- ✅ All assets created
-- ✅ Animations polished
-- ✅ Cross-browser tested
-- ✅ Mobile optimized
-
-### Phase 4 (Week 9)
-- ✅ Lighthouse 95+ all categories
-- ✅ WCAG AA compliant
-- ✅ SEO optimized
-- ✅ Analytics configured
-
-### Phase 5 (Week 10)
-- ✅ Site live at ry-code.com
-- ✅ Install script tested & working
-- ✅ Launch announcement sent
-- ✅ Monitoring dashboard active
-
----
-
-## 🔄 Iteration Plan (Post-Launch)
-
-### Week 1-2 Post-Launch
-- Collect analytics data
-- Monitor conversion funnel
-- Identify drop-off points
-- User feedback collection
-
-### Week 3-4 Post-Launch
-- A/B test CTAs (install button text, color)
-- Optimize slow-loading assets
-- Fix reported bugs
-- Content improvements based on feedback
-
-### Month 2-3 Post-Launch
-- Add new features (interactive playground?)
-- Create video tutorials
-- Blog posts / case studies
-- SEO improvements (backlinks, content)
-
----
-
-## ✅ Definition of Done
-
-A task is considered **DONE** when:
-
-1. ✅ **Code complete** - All functionality implemented
-2. ✅ **Tests passing** - No errors, lints clean
-3. ✅ **Responsive** - Works 320px → 1920px+
-4. ✅ **Accessible** - Keyboard nav, screen reader, ARIA
-5. ✅ **Performance** - Lighthouse 90+ per fold
-6. ✅ **Cross-browser** - Chrome, Firefox, Safari, Edge
-7. ✅ **Reviewed** - Code review + stakeholder approval
-8. ✅ **Documented** - Comments, README updates
-9. ✅ **Deployed** - Merged to main, live on preview
-10. ✅ **Tracked** - Analytics events added
-
----
-
-## 🎉 Conclusion
-
-This comprehensive 10-week plan provides a clear roadmap for building **ry-code.com** - a high-converting landing page that showcases RyCode while driving significant traffic to toolkit-cli.com.
-
-**Key Highlights:**
-
-✅ **Multi-Agent Validated** - Technology choices reviewed by 4 specialists
-✅ **Risk Mitigated** - All major risks identified with mitigation strategies
-✅ **Resource Efficient** - 1 developer, 10 weeks, <$100/month
-✅ **Success Metrics** - Clear targets: 15% install rate, 40% toolkit awareness
-✅ **Quality First** - Lighthouse 95+, WCAG AA, SEO 100
-
-**Next Steps:**
-
-1. **Approval** - Review plan with stakeholders
-2. **Design** - Start Week 1 design system & mockups
-3. **Development** - Begin Week 3 implementation
-4. **Launch** - Week 10 production deployment
-
-**Timeline:**
-- Start: Week 1 (Design)
-- First Preview: Week 4 (Hero + components)
-- Beta Launch: Week 8 (All folds complete)
-- Production Launch: Week 10
-
----
-
-**🤖 Plan Created by Multi-Agent Team:**
-- **Claude (Architect):** Technology validation, architecture, performance
-- **Codex (Engineer):** Implementation details, code examples, CI/CD
-- **Gemini (Designer):** Visual design, animations, asset specifications
-- **UX Specialist:** User flows, conversion optimization, accessibility
-
-**Status:** ✅ **Ready for Execution**
-**Confidence Level:** 🟢 **High** (Technology proven, risks mitigated, timeline realistic)
-
----
-
-*Let's build the most impressive AI tool landing page on the internet.* 🚀
diff --git a/packages/tui/LANDING_PAGE_SPEC.md b/packages/tui/LANDING_PAGE_SPEC.md
deleted file mode 100644
index 62ce3305..00000000
--- a/packages/tui/LANDING_PAGE_SPEC.md
+++ /dev/null
@@ -1,1508 +0,0 @@
-# RyCode Landing Page Specification (ry-code.com)
-
-> **Multi-Agent Specification** - Created by Claude (Architect), Codex (Engineer), and Gemini (Designer)
-
----
-
-## 🎯 Executive Summary
-
-**Objective:** Create a high-converting landing page for RyCode that showcases its unique value proposition as an AI-powered TUI tool built with toolkit-cli, with a prominent installation flow in the top fold.
-
-**Key Success Metrics:**
-- Install conversion rate: >15%
-- Time to installation: <30 seconds
-- Feature discovery: >60% scroll depth
-- toolkit-cli awareness: >40% click-through
-
-**Design Philosophy:**
-- Cyberpunk aesthetic inspired by toolkit-cli.com
-- Developer-first, technically credible
-- Performance and accessibility as differentiators
-- "Built with toolkit-cli" as social proof
-
----
-
-## 🏗️ Architecture Overview
-
-### Tech Stack Recommendation
-
-**Framework:** Next.js 14 (App Router)
-- Server Components for performance
-- Incremental Static Regeneration for docs
-- Edge runtime for global speed
-- Built-in SEO optimization
-
-**Styling:** Tailwind CSS + Framer Motion
-- Utility-first for rapid development
-- Animations for polish
-- Dark mode native
-- Custom gradient utilities
-
-**Hosting:** Vercel
-- Instant deployments
-- Edge network
-- Analytics built-in
-- Perfect Next.js integration
-
-**Analytics:** Plausible or Vercel Analytics
-- Privacy-respecting
-- GDPR compliant
-- Real-time insights
-
----
-
-## 🎨 Visual Design System
-
-### Color Palette (Inspired by toolkit-cli + RyCode)
-
-```css
-/* Primary Palette - Cyberpunk Neural Theme */
---neural-cyan: #00ffff;      /* Splash screen cortex */
---neural-magenta: #ff00ff;   /* Splash gradient */
---matrix-green: #00ff00;     /* toolkit-cli inspired */
---claude-blue: #7aa2f7;      /* Claude branding */
---performance-gold: #ffae00; /* Performance metrics */
-
-/* Background Layers */
---bg-dark: #0a0a0f;          /* Deep space black */
---bg-elevated: #1a1b26;      /* Card backgrounds */
---bg-hover: #2a2b36;         /* Interactive states */
-
-/* Text Hierarchy */
---text-primary: #e0e0e0;     /* Primary content */
---text-secondary: #a0a0a0;   /* Secondary content */
---text-muted: #606060;       /* Tertiary content */
-
-/* Semantic Colors */
---success: #9ece6a;          /* Positive states */
---warning: #e0af68;          /* Warnings */
---error: #f7768e;            /* Errors */
---info: #7dcfff;             /* Info states */
-```
-
-### Typography System
-
-```css
-/* Display Font: Inter (Primary) */
---font-display: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
-
-/* Monospace: Fira Code (Code blocks, metrics) */
---font-mono: 'Fira Code', 'Monaco', 'Courier New', monospace;
-
-/* Scale */
---text-xs: 0.75rem;    /* 12px - Captions */
---text-sm: 0.875rem;   /* 14px - Body small */
---text-base: 1rem;     /* 16px - Body */
---text-lg: 1.125rem;   /* 18px - Lead */
---text-xl: 1.25rem;    /* 20px - Subheading */
---text-2xl: 1.5rem;    /* 24px - Heading 3 */
---text-3xl: 1.875rem;  /* 30px - Heading 2 */
---text-4xl: 2.25rem;   /* 36px - Heading 1 */
---text-5xl: 3rem;      /* 48px - Hero */
---text-6xl: 3.75rem;   /* 60px - Hero Large */
-
-/* Line Heights */
---leading-tight: 1.2;
---leading-normal: 1.5;
---leading-relaxed: 1.75;
-```
-
-### Animation System
-
-```typescript
-// Framer Motion Variants
-export const fadeInUp = {
-  hidden: { opacity: 0, y: 20 },
-  visible: {
-    opacity: 1,
-    y: 0,
-    transition: { duration: 0.6, ease: [0.22, 1, 0.36, 1] }
-  }
-};
-
-export const staggerChildren = {
-  hidden: { opacity: 0 },
-  visible: {
-    opacity: 1,
-    transition: {
-      staggerChildren: 0.1
-    }
-  }
-};
-
-export const scaleIn = {
-  hidden: { opacity: 0, scale: 0.8 },
-  visible: {
-    opacity: 1,
-    scale: 1,
-    transition: { duration: 0.5, ease: [0.22, 1, 0.36, 1] }
-  }
-};
-
-export const floatingOrb = {
-  animate: {
-    y: [-20, 20, -20],
-    transition: {
-      duration: 6,
-      repeat: Infinity,
-      ease: "easeInOut"
-    }
-  }
-};
-```
-
----
-
-## 📐 Landing Page Structure (Folds)
-
-### Fold 1: Hero + Installation (Above the Fold) 🎯
-
-**Purpose:** Immediate value proposition + frictionless installation
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│  [Logo] RyCode          [Docs] [GitHub]    │ ← Sticky Nav
-├─────────────────────────────────────────────┤
-│                                             │
-│     🌀 EPIC 3D NEURAL CORTEX ANIMATION      │ ← Animated Splash Preview
-│          (Looping 3-second clip)            │
-│                                             │
-│   "AI-Powered Development Assistant         │ ← Hero Headline
-│    Built by AI, for Developers"             │
-│                                             │
-│   6 AI Models. 1 Command Line.              │ ← Subheadline
-│   60fps. 19MB. 9 Accessibility Modes.       │
-│                                             │
-│  ┌────────────────────────────────────┐    │
-│  │  Installation Command              │    │ ← Primary CTA
-│  │  $ curl -fsSL ry-code.com/install  │    │
-│  │  │ sh                               │    │
-│  │  [Copy]                            │    │
-│  └────────────────────────────────────┘    │
-│                                             │
-│  [ macOS ] [ Linux ] [ Windows ]            │ ← Platform Selector
-│  ARM64 | Intel/AMD64                        │
-│                                             │
-│  Built with toolkit-cli →                   │ ← Social Proof Link
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
-**Key Elements:**
-
-1. **Animated Neural Cortex** (WebGL or Canvas)
-   - Looping 3-second clip of splash screen
-   - Interactive (mouse hover = faster rotation)
-   - Respects `prefers-reduced-motion`
-
-2. **Installation Command Block**
-   ```bash
-   # One-line installer (detects platform)
-   curl -fsSL ry-code.com/install | sh
-
-   # Or download directly
-   # macOS ARM64: rycode-darwin-arm64
-   # macOS Intel: rycode-darwin-amd64
-   # Linux ARM64: rycode-linux-arm64
-   # Linux AMD64: rycode-linux-amd64
-   # Windows: rycode-windows-amd64.exe
-   ```
-
-3. **Copy Button** with success feedback
-   - Click → "Copied!" animation
-   - Auto-selects command
-   - Tracks conversion
-
-4. **toolkit-cli Attribution**
-   - "Built with toolkit-cli" badge
-   - Links to toolkit-cli.com
-   - Glowing hover effect
-
-**Code Implementation:**
-
-```typescript
-// components/HeroFold.tsx
-'use client';
-
-import { motion } from 'framer-motion';
-import { useState } from 'react';
-import { NeuralCortexAnimation } from './NeuralCortexAnimation';
-import { InstallCommand } from './InstallCommand';
-
-export function HeroFold() {
-  return (
-    <section className="relative min-h-screen flex items-center justify-center overflow-hidden">
-      {/* Animated Background Orbs */}
-      <div className="absolute inset-0 overflow-hidden">
-        <motion.div
-          className="absolute top-20 left-20 w-64 h-64 bg-neural-cyan/20 rounded-full blur-3xl"
-          variants={floatingOrb}
-          animate="animate"
-        />
-        <motion.div
-          className="absolute bottom-20 right-20 w-96 h-96 bg-neural-magenta/20 rounded-full blur-3xl"
-          variants={floatingOrb}
-          animate="animate"
-        />
-      </div>
-
-      {/* Content */}
-      <div className="relative z-10 container mx-auto px-6 py-20">
-        <motion.div
-          initial="hidden"
-          animate="visible"
-          variants={staggerChildren}
-          className="max-w-5xl mx-auto text-center"
-        >
-          {/* Neural Cortex Animation */}
-          <motion.div variants={fadeInUp} className="mb-12">
-            <NeuralCortexAnimation />
-          </motion.div>
-
-          {/* Hero Text */}
-          <motion.h1
-            variants={fadeInUp}
-            className="text-6xl md:text-7xl font-bold mb-6 bg-gradient-to-r from-neural-cyan via-claude-blue to-neural-magenta bg-clip-text text-transparent"
-          >
-            AI-Powered Development Assistant
-          </motion.h1>
-
-          <motion.p
-            variants={fadeInUp}
-            className="text-2xl text-text-secondary mb-4"
-          >
-            Built by AI, for Developers
-          </motion.p>
-
-          <motion.p
-            variants={fadeInUp}
-            className="text-xl text-text-muted mb-12"
-          >
-            6 AI Models. 1 Command Line. 60fps. 19MB. 9 Accessibility Modes.
-          </motion.p>
-
-          {/* Installation Section */}
-          <motion.div variants={scaleIn}>
-            <InstallCommand />
-          </motion.div>
-
-          {/* toolkit-cli Attribution */}
-          <motion.a
-            variants={fadeInUp}
-            href="https://toolkit-cli.com"
-            target="_blank"
-            rel="noopener noreferrer"
-            className="inline-flex items-center gap-2 mt-8 px-6 py-3 rounded-lg bg-bg-elevated hover:bg-bg-hover transition-colors group"
-          >
-            <span className="text-sm text-text-secondary group-hover:text-text-primary transition-colors">
-              Built with
-            </span>
-            <span className="text-sm font-semibold text-matrix-green">
-              toolkit-cli
-            </span>
-            <span className="text-neural-cyan">→</span>
-          </motion.a>
-        </motion.div>
-      </div>
-    </section>
-  );
-}
-```
-
----
-
-### Fold 2: "Can't Compete" Features Showcase
-
-**Purpose:** Highlight unique differentiators
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   What Makes RyCode                         │ ← Section Header
-│   Undeniably Superior                       │
-│                                             │
-│  ┌──────────────┐  ┌──────────────┐        │
-│  │ 🌀           │  │ ⚡           │        │
-│  │ Epic 3D      │  │ 60fps        │        │ ← Feature Cards (3x2 grid)
-│  │ Splash       │  │ Rendering    │        │
-│  └──────────────┘  └──────────────┘        │
-│                                             │
-│  [Show All 13 Features →]                   │ ← Expand Button
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
-**Features to Highlight (Top 6):**
-1. 🌀 **Epic 3D Splash Screen** - Real donut algorithm, 30 FPS
-2. ⚡ **60fps Rendering** - <100ns monitoring overhead
-3. 🪶 **19MB Binary** - Smaller than most cat photos
-4. ♿ **9 Accessibility Modes** - Inclusive by default
-5. 🧠 **AI-Powered Recommendations** - Learn from your usage
-6. 💰 **Predictive Budgeting** - ML-style forecasting
-
-**Interactive Element:**
-- Hover on card → Show animated demo
-- Click → Open detailed modal with video/GIF
-
-**Code:**
-```typescript
-// components/FeatureShowcase.tsx
-const features = [
-  {
-    icon: '🌀',
-    title: 'Epic 3D Splash Screen',
-    description: 'Real donut algorithm with 30 FPS animation',
-    demo: '/demos/splash.mp4',
-    metric: '0.318ms/frame'
-  },
-  {
-    icon: '⚡',
-    title: '60fps Rendering',
-    description: '<100ns monitoring overhead',
-    demo: '/demos/performance.mp4',
-    metric: '64ns'
-  },
-  // ... more features
-];
-
-export function FeatureShowcase() {
-  return (
-    <section className="py-24 bg-bg-elevated">
-      <div className="container mx-auto px-6">
-        <motion.h2
-          initial={{ opacity: 0, y: 20 }}
-          whileInView={{ opacity: 1, y: 0 }}
-          viewport={{ once: true }}
-          className="text-5xl font-bold text-center mb-4"
-        >
-          What Makes RyCode
-        </motion.h2>
-        <motion.p
-          initial={{ opacity: 0, y: 20 }}
-          whileInView={{ opacity: 1, y: 0 }}
-          viewport={{ once: true }}
-          className="text-3xl text-neural-cyan text-center mb-16"
-        >
-          Undeniably Superior
-        </motion.p>
-
-        <div className="grid md:grid-cols-2 lg:grid-cols-3 gap-6">
-          {features.map((feature, index) => (
-            <FeatureCard key={index} {...feature} />
-          ))}
-        </div>
-      </div>
-    </section>
-  );
-}
-```
-
----
-
-### Fold 3: Live Demo Terminal
-
-**Purpose:** Interactive experience of RyCode
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   See RyCode in Action                      │
-│                                             │
-│  ┌─────────────────────────────────────┐   │
-│  │ $ rycode                            │   │ ← Interactive Terminal
-│  │                                     │   │   (Asciinema player or
-│  │ [Neural Cortex Animation]           │   │    pre-recorded demo)
-│  │                                     │   │
-│  │ > Select model: Claude Sonnet 3.5   │   │
-│  │ > Ctrl+I for insights               │   │
-│  │                                     │   │
-│  └─────────────────────────────────────┘   │
-│                                             │
-│  [⏯ Play Demo] [↻ Restart] [⏸ Pause]      │ ← Playback Controls
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
-**Implementation Options:**
-
-1. **Asciinema Recording** (Recommended)
-   - Record actual RyCode session
-   - Embed with asciinema-player
-   - Fast loading, small file size
-   - Native terminal look
-
-2. **Pre-rendered Video**
-   - High quality visuals
-   - More control over timing
-   - Larger file size
-
-3. **Live Terminal Emulator** (Advanced)
-   - xterm.js + WebSocket
-   - Real interactive demo
-   - Requires backend
-
-**Code:**
-```typescript
-// components/LiveDemo.tsx
-'use client';
-
-import AsciinemaPlayer from 'asciinema-player';
-import 'asciinema-player/dist/bundle/asciinema-player.css';
-
-export function LiveDemo() {
-  const playerRef = useRef(null);
-
-  useEffect(() => {
-    if (playerRef.current) {
-      AsciinemaPlayer.create(
-        '/demos/rycode-demo.cast',
-        playerRef.current,
-        {
-          theme: 'dracula',
-          poster: 'npt:0:5',
-          autoPlay: true,
-          loop: true,
-          fit: 'width',
-          terminalFontSize: '14px'
-        }
-      );
-    }
-  }, []);
-
-  return (
-    <section className="py-24 bg-bg-dark">
-      <div className="container mx-auto px-6">
-        <h2 className="text-4xl font-bold text-center mb-12">
-          See RyCode in Action
-        </h2>
-
-        <div className="max-w-4xl mx-auto">
-          <div
-            ref={playerRef}
-            className="rounded-lg shadow-2xl border border-neural-cyan/20"
-          />
-        </div>
-      </div>
-    </section>
-  );
-}
-```
-
----
-
-### Fold 4: Performance Metrics
-
-**Purpose:** Technical credibility through numbers
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   Performance That Actually Matters         │
-│                                             │
-│  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐   │
-│  │ 64ns │  │ 60fps│  │ 19MB │  │ 54%  │   │ ← Metric Cards
-│  │ Frame│  │ Solid│  │ Binary│  │ Test │   │   (Animated counters)
-│  │ Time │  │      │  │ Size │  │ Cover│   │
-│  └──────┘  └──────┘  └──────┘  └──────┘   │
-│                                             │
-│  Benchmarked on Apple M4 Max                │
-│  Zero-allocation hot paths                  │
-│  Thread-safe with RWMutex                   │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
-**Animated Metrics:**
-```typescript
-// components/PerformanceMetrics.tsx
-const metrics = [
-  {
-    value: 64,
-    unit: 'ns',
-    label: 'Frame Cycle',
-    description: '0 allocations ⚡️',
-    icon: '⚡'
-  },
-  {
-    value: 60,
-    unit: 'fps',
-    label: 'Rendering',
-    description: 'Solid 60 FPS target',
-    icon: '🎯'
-  },
-  {
-    value: 19,
-    unit: 'MB',
-    label: 'Binary Size',
-    description: 'Stripped & optimized',
-    icon: '🪶'
-  },
-  {
-    value: 54.2,
-    unit: '%',
-    label: 'Test Coverage',
-    description: '31/31 tests passing',
-    icon: '✅'
-  }
-];
-
-export function PerformanceMetrics() {
-  return (
-    <section className="py-24 bg-gradient-to-b from-bg-dark to-bg-elevated">
-      <div className="container mx-auto px-6">
-        <h2 className="text-4xl font-bold text-center mb-4">
-          Performance That Actually Matters
-        </h2>
-        <p className="text-text-secondary text-center mb-16">
-          Benchmarked on Apple M4 Max • Zero-allocation hot paths • Thread-safe
-        </p>
-
-        <div className="grid grid-cols-2 md:grid-cols-4 gap-8 max-w-5xl mx-auto">
-          {metrics.map((metric, index) => (
-            <MetricCard key={index} {...metric} delay={index * 0.1} />
-          ))}
-        </div>
-      </div>
-    </section>
-  );
-}
-
-function MetricCard({ value, unit, label, description, icon, delay }) {
-  return (
-    <motion.div
-      initial={{ opacity: 0, y: 20 }}
-      whileInView={{ opacity: 1, y: 0 }}
-      viewport={{ once: true }}
-      transition={{ delay }}
-      className="text-center p-6 rounded-lg bg-bg-dark border border-neural-cyan/10 hover:border-neural-cyan/30 transition-colors"
-    >
-      <div className="text-4xl mb-4">{icon}</div>
-      <div className="text-5xl font-mono font-bold text-neural-cyan mb-2">
-        <AnimatedCounter end={value} />
-        <span className="text-2xl text-text-secondary">{unit}</span>
-      </div>
-      <div className="text-lg font-semibold mb-2">{label}</div>
-      <div className="text-sm text-text-muted">{description}</div>
-    </motion.div>
-  );
-}
-```
-
----
-
-### Fold 5: AI Intelligence Showcase
-
-**Purpose:** Highlight AI-powered features
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   Six AI Minds, One Command Line            │
-│                                             │
-│  ┌─────────────────────────────────────┐   │
-│  │                                     │   │
-│  │   [Anthropic] [OpenAI] [Google]     │   │ ← Provider Icons
-│  │   [X.AI] [Alibaba]                  │   │
-│  │                                     │   │
-│  │  • AI-Powered Recommendations       │   │ ← Feature List
-│  │  • Predictive Budget Forecasting    │   │   (Animated reveals)
-│  │  • Smart Cost Alerts                │   │
-│  │  • Usage Insights Dashboard         │   │
-│  │                                     │   │
-│  └─────────────────────────────────────┘   │
-│                                             │
-│  [See All AI Features →]                    │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
-**Interactive Element:**
-- Hover on provider → Show supported models
-- Click → Open modal with detailed comparison
-
----
-
-### Fold 6: Accessibility Focus
-
-**Purpose:** Highlight inclusive design
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   Built for Everyone                        │
-│   9 Accessibility Modes                     │
-│                                             │
-│  ┌──────────────┐  ┌──────────────┐        │
-│  │ High         │  │ Reduced      │        │ ← Mode Cards
-│  │ Contrast     │  │ Motion       │        │   (Toggle demos)
-│  └──────────────┘  └──────────────┘        │
-│                                             │
-│  ✅ 100% Keyboard Navigation                │
-│  ✅ Screen Reader Compatible                │
-│  ✅ WCAG AA Compliant Colors                │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
----
-
-### Fold 7: Easter Eggs & Personality
-
-**Purpose:** Show delightful polish
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   Because Software Should Delight           │
-│                                             │
-│  🎮 Konami Code → Rainbow Mode              │ ← Easter Egg Reveals
-│  🍩 Try: ./rycode donut                     │   (Spoiler tags)
-│  🧮 Press ? → See the Math                  │
-│  ☕ Type "coffee" → Coffee Mode             │
-│  🧘 Type "zen" → Zen Mode                   │
-│                                             │
-│  + 10 more hidden surprises...              │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
----
-
-### Fold 8: toolkit-cli Showcase
-
-**Purpose:** Drive traffic to toolkit-cli.com
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   Built with toolkit-cli                    │
-│   Multi-Agent AI Development                │
-│                                             │
-│  RyCode showcases what's possible when      │
-│  multiple AI agents collaborate:            │
-│                                             │
-│  • Claude: Architecture & Planning          │
-│  • Codex: Implementation & Testing          │
-│  • Gemini: Documentation & Polish           │
-│                                             │
-│  [Try toolkit-cli →] [Read Case Study →]   │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
-**Key Message:**
-- "RyCode = 100% AI-designed using toolkit-cli"
-- "See what multi-agent collaboration can build"
-- Link to toolkit-cli.com prominently
-
----
-
-### Fold 9: Installation Guide (Detailed)
-
-**Purpose:** Multiple installation methods
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   Get Started in 30 Seconds                 │
-│                                             │
-│  [Quick Install] [Manual Download] [Build]  │ ← Tab Navigation
-│                                             │
-│  ┌─────────────────────────────────────┐   │
-│  │ # Quick Install (Recommended)       │   │
-│  │ curl -fsSL ry-code.com/install | sh │   │ ← Active Tab Content
-│  │                                     │   │
-│  │ # Or with Homebrew                  │   │
-│  │ brew install rycode                 │   │
-│  │                                     │   │
-│  │ # First run                         │   │
-│  │ ./rycode                            │   │
-│  └─────────────────────────────────────┘   │
-│                                             │
-│  [View Full Documentation →]                │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
----
-
-### Fold 10: Social Proof & CTA
-
-**Purpose:** Final conversion push
-
-**Layout:**
-```
-┌─────────────────────────────────────────────┐
-│                                             │
-│   "The polish is incredible. This is        │ ← Testimonials
-│    what AI should build."                   │   (Rotating carousel)
-│   - Early Beta Tester                       │
-│                                             │
-│   GitHub Stars: 1.2k ⭐                     │ ← Social Stats
-│   Downloads: 10k+                           │
-│                                             │
-│  ┌─────────────────────────────────────┐   │
-│  │  Ready to Experience RyCode?        │   │ ← Final CTA
-│  │                                     │   │
-│  │  [Get Started Now →]                │   │
-│  │                                     │   │
-│  └─────────────────────────────────────┘   │
-│                                             │
-└─────────────────────────────────────────────┘
-```
-
----
-
-## 🚀 Installation Flow Specification
-
-### Quick Install Script (`/install`)
-
-**Endpoint:** `https://ry-code.com/install`
-
-**Script Requirements:**
-1. Detect OS and architecture automatically
-2. Download appropriate binary
-3. Verify checksum (security)
-4. Install to system PATH
-5. Run `rycode --version` to verify
-6. Show success message with next steps
-
-**Implementation:**
-
-```bash
-#!/bin/bash
-# install.sh - Smart RyCode installer
-
-set -e
-
-# Colors
-CYAN='\033[0;36m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-echo "${CYAN}🌀 RyCode Installer${NC}"
-echo ""
-
-# Detect OS
-OS=$(uname -s | tr '[:upper:]' '[:lower:]')
-ARCH=$(uname -m)
-
-case "$OS" in
-  darwin) OS="darwin" ;;
-  linux) OS="linux" ;;
-  *) echo "Unsupported OS: $OS"; exit 1 ;;
-esac
-
-case "$ARCH" in
-  x86_64|amd64) ARCH="amd64" ;;
-  arm64|aarch64) ARCH="arm64" ;;
-  *) echo "Unsupported architecture: $ARCH"; exit 1 ;;
-esac
-
-echo "${GREEN}✓${NC} Detected: $OS $ARCH"
-
-# Download URL
-VERSION="latest"
-BINARY_NAME="rycode-${OS}-${ARCH}"
-if [ "$OS" = "windows" ]; then
-  BINARY_NAME="${BINARY_NAME}.exe"
-fi
-
-DOWNLOAD_URL="https://github.com/aaronmrosenthal/rycode/releases/download/${VERSION}/${BINARY_NAME}"
-INSTALL_DIR="/usr/local/bin"
-INSTALL_PATH="${INSTALL_DIR}/rycode"
-
-echo "${YELLOW}Downloading RyCode...${NC}"
-curl -fsSL "${DOWNLOAD_URL}" -o "/tmp/rycode"
-
-echo "${YELLOW}Verifying checksum...${NC}"
-# Download and verify checksum
-CHECKSUM_URL="${DOWNLOAD_URL}.sha256"
-curl -fsSL "${CHECKSUM_URL}" -o "/tmp/rycode.sha256"
-if command -v shasum >/dev/null 2>&1; then
-  (cd /tmp && shasum -a 256 -c rycode.sha256) || {
-    echo "Checksum verification failed"
-    exit 1
-  }
-fi
-
-echo "${YELLOW}Installing to ${INSTALL_PATH}...${NC}"
-sudo mv /tmp/rycode "${INSTALL_PATH}"
-sudo chmod +x "${INSTALL_PATH}"
-
-echo ""
-echo "${GREEN}✅ RyCode installed successfully!${NC}"
-echo ""
-echo "Quick start:"
-echo "  ${CYAN}rycode${NC}              # Launch RyCode"
-echo "  ${CYAN}rycode donut${NC}        # Infinite cortex mode 🍩"
-echo "  ${CYAN}rycode --help${NC}       # Show help"
-echo ""
-echo "Documentation: https://ry-code.com/docs"
-echo "Built with toolkit-cli: https://toolkit-cli.com"
-echo ""
-
-# Verify installation
-if command -v rycode >/dev/null 2>&1; then
-  rycode --version
-else
-  echo "${YELLOW}Note: You may need to restart your terminal${NC}"
-fi
-```
-
----
-
-## 📊 Analytics & Conversion Tracking
-
-### Key Events to Track
-
-```typescript
-// Track installation attempts
-trackEvent('install_started', {
-  method: 'curl_script', // or 'manual_download', 'homebrew'
-  platform: 'darwin-arm64',
-  source: 'hero_fold' // or 'documentation', 'footer'
-});
-
-// Track feature discovery
-trackEvent('feature_viewed', {
-  feature: 'splash_screen',
-  scroll_depth: 0.45,
-  time_on_page: 12
-});
-
-// Track toolkit-cli awareness
-trackEvent('toolkit_link_clicked', {
-  location: 'hero_fold', // or 'feature_showcase', 'footer'
-  destination: 'toolkit-cli.com'
-});
-
-// Track video engagement
-trackEvent('demo_played', {
-  video: 'main_demo',
-  watch_percentage: 0.75
-});
-
-// Track conversions
-trackEvent('installation_completed', {
-  method: 'curl_script',
-  platform: 'darwin-arm64',
-  time_to_install: 23 // seconds
-});
-```
-
----
-
-## 🎯 SEO Optimization
-
-### Meta Tags
-
-```html
-<head>
-  <title>RyCode - AI-Powered Development Assistant | 6 AI Models, 1 CLI</title>
-
-  <meta name="description" content="RyCode is an AI-powered TUI development assistant with 60fps rendering, 9 accessibility modes, and 6 AI providers. Built 100% by AI using toolkit-cli." />
-
-  <meta name="keywords" content="AI development tool, TUI, terminal UI, Claude AI, GPT, Gemini, multi-agent AI, toolkit-cli, accessibility, performance" />
-
-  <!-- Open Graph -->
-  <meta property="og:title" content="RyCode - AI-Powered Development Assistant" />
-  <meta property="og:description" content="6 AI Models. 1 Command Line. 60fps. 19MB. 9 Accessibility Modes." />
-  <meta property="og:image" content="https://ry-code.com/og-image.png" />
-  <meta property="og:url" content="https://ry-code.com" />
-  <meta property="og:type" content="website" />
-
-  <!-- Twitter Card -->
-  <meta name="twitter:card" content="summary_large_image" />
-  <meta name="twitter:title" content="RyCode - AI-Powered Development Assistant" />
-  <meta name="twitter:description" content="6 AI Models. 1 Command Line. Built 100% by AI." />
-  <meta name="twitter:image" content="https://ry-code.com/twitter-card.png" />
-
-  <!-- Canonical URL -->
-  <link rel="canonical" href="https://ry-code.com" />
-
-  <!-- Structured Data -->
-  <script type="application/ld+json">
-  {
-    "@context": "https://schema.org",
-    "@type": "SoftwareApplication",
-    "name": "RyCode",
-    "description": "AI-powered development assistant with multi-provider support",
-    "applicationCategory": "DeveloperApplication",
-    "operatingSystem": "macOS, Linux, Windows",
-    "offers": {
-      "@type": "Offer",
-      "price": "0",
-      "priceCurrency": "USD"
-    },
-    "aggregateRating": {
-      "@type": "AggregateRating",
-      "ratingValue": "4.9",
-      "ratingCount": "250"
-    }
-  }
-  </script>
-</head>
-```
-
----
-
-## 🖼️ Asset Requirements
-
-### Images & Videos Needed
-
-1. **Neural Cortex Animation** (Hero)
-   - Format: WebM + MP4 fallback
-   - Resolution: 1920x1080
-   - Duration: 3-5 seconds loop
-   - Size: <2MB
-   - Alt text: "RyCode 3D neural cortex splash screen animation"
-
-2. **Feature Demo GIFs**
-   - Splash screen (5 easter eggs)
-   - Performance monitoring
-   - Model switching
-   - Accessibility modes
-   - Budget forecasting
-   - Usage insights
-
-3. **Screenshot Gallery**
-   - Main TUI interface
-   - Model selector dialog
-   - Provider management
-   - Performance dashboard
-   - Accessibility settings
-   - Help system
-
-4. **Social Media Assets**
-   - OG Image: 1200x630px
-   - Twitter Card: 1200x675px
-   - Favicon: 512x512px (SVG preferred)
-   - App Icon: Various sizes
-
----
-
-## 📱 Responsive Design Breakpoints
-
-```css
-/* Mobile First Approach */
-
-/* Mobile: 320px - 767px */
-@media (min-width: 320px) {
-  /* Single column layout */
-  /* Stacked feature cards */
-  /* Full-width terminal */
-}
-
-/* Tablet: 768px - 1023px */
-@media (min-width: 768px) {
-  /* 2-column grid */
-  /* Side-by-side CTAs */
-}
-
-/* Desktop: 1024px - 1439px */
-@media (min-width: 1024px) {
-  /* 3-column grid */
-  /* Sticky navigation */
-}
-
-/* Large Desktop: 1440px+ */
-@media (min-width: 1440px) {
-  /* Max-width container */
-  /* Enhanced spacing */
-}
-```
-
----
-
-## ⚡ Performance Optimization
-
-### Loading Strategy
-
-1. **Critical CSS** - Inline above-the-fold styles
-2. **Lazy Loading** - Defer below-the-fold images
-3. **Code Splitting** - Load components on demand
-4. **CDN** - Serve assets from edge network
-5. **Image Optimization** - WebP with fallbacks
-6. **Font Loading** - Subset fonts, preload critical
-
-### Performance Targets
-
-- **First Contentful Paint:** <1.5s
-- **Largest Contentful Paint:** <2.5s
-- **Time to Interactive:** <3.5s
-- **Cumulative Layout Shift:** <0.1
-- **Total Blocking Time:** <300ms
-
-### Lighthouse Score Goals
-
-- Performance: 95+
-- Accessibility: 100
-- Best Practices: 100
-- SEO: 100
-
----
-
-## 🔒 Security Considerations
-
-1. **Install Script Security**
-   - HTTPS only
-   - Checksum verification
-   - Code signing for binaries
-   - No arbitrary code execution
-
-2. **CSP Headers**
-   ```
-   Content-Security-Policy:
-     default-src 'self';
-     script-src 'self' 'unsafe-inline' https://plausible.io;
-     style-src 'self' 'unsafe-inline';
-     img-src 'self' data: https:;
-     font-src 'self' data:;
-   ```
-
-3. **Rate Limiting**
-   - Limit install script downloads
-   - Prevent scraping
-   - DDoS protection
-
----
-
-## 📝 Content Strategy
-
-### Key Messaging Pillars
-
-1. **AI-Built Excellence**
-   - "Built 100% by AI using toolkit-cli"
-   - "Showcase of multi-agent collaboration"
-   - "Zero compromises, infinite attention to detail"
-
-2. **Performance & Quality**
-   - "60fps rendering in a terminal"
-   - "19MB binary - smaller than most cat photos"
-   - "54.2% test coverage, 31/31 tests passing"
-
-3. **Accessibility & Inclusivity**
-   - "9 accessibility modes built-in"
-   - "100% keyboard navigation"
-   - "WCAG AA compliant"
-
-4. **Delightful UX**
-   - "15+ hidden easter eggs"
-   - "Epic 3D splash screen"
-   - "Software that delights"
-
-5. **Multi-Provider Intelligence**
-   - "6 AI models, 1 command line"
-   - "Smart recommendations"
-   - "Predictive budgeting"
-
-### Voice & Tone
-
-- **Technical but Approachable** - Use precise terminology but explain concepts
-- **Confident but Not Arrogant** - Let the features speak for themselves
-- **Playful but Professional** - Easter eggs are fun, but quality is serious
-- **Inclusive** - "Built for everyone" not "built for experts"
-
----
-
-## 🚦 Launch Checklist
-
-### Pre-Launch (Week 1)
-
-- [ ] Design system implementation
-- [ ] Component library creation
-- [ ] Hero fold with installation
-- [ ] Feature showcase fold
-- [ ] Performance metrics fold
-- [ ] Responsive design testing
-- [ ] Accessibility audit (WCAG AA)
-- [ ] Browser testing (Chrome, Firefox, Safari, Edge)
-
-### Pre-Launch (Week 2)
-
-- [ ] Live demo terminal integration
-- [ ] Video/GIF asset creation
-- [ ] Install script development & testing
-- [ ] Analytics integration
-- [ ] SEO optimization
-- [ ] Social media assets
-- [ ] toolkit-cli showcase fold
-- [ ] Easter eggs fold
-
-### Launch Day
-
-- [ ] DNS configuration
-- [ ] SSL certificate
-- [ ] Deploy to production
-- [ ] Test install script on all platforms
-- [ ] Monitor analytics
-- [ ] Social media announcement
-- [ ] toolkit-cli.com link update
-- [ ] Press kit publication
-
-### Post-Launch (Week 1)
-
-- [ ] Monitor conversion rates
-- [ ] A/B test CTAs
-- [ ] Collect user feedback
-- [ ] Fix bugs/issues
-- [ ] SEO performance tracking
-- [ ] Content updates based on analytics
-
----
-
-## 📈 Success Metrics (30 Days)
-
-### Primary KPIs
-
-- **Install Conversion Rate:** 15% (visitors → installations)
-- **toolkit-cli Awareness:** 40% (clicks to toolkit-cli.com)
-- **Feature Discovery:** 60% (scroll depth beyond fold 3)
-- **Time to Installation:** <30 seconds average
-
-### Secondary KPIs
-
-- **Bounce Rate:** <40%
-- **Average Session Duration:** >2 minutes
-- **Pages Per Session:** 1.5+ (hero + 1 other page)
-- **Returning Visitors:** 20%
-
-### Engagement Metrics
-
-- **Demo Video Completion:** 60%
-- **Feature Card Interactions:** 40%
-- **Easter Eggs Discovery:** 10%
-- **Documentation Visits:** 30%
-
----
-
-## 🎨 Design Mockups (ASCII Wireframes)
-
-### Desktop Hero Fold (1440px)
-```
-╔═══════════════════════════════════════════════════════════════════╗
-║  [Logo] RyCode          [Docs] [GitHub] [toolkit-cli.com]   ☰   ║
-╠═══════════════════════════════════════════════════════════════════╣
-║                                                                   ║
-║         ┌─────────────────────────────────────────┐              ║
-║         │                                         │              ║
-║         │      🌀 NEURAL CORTEX ANIMATION         │              ║
-║         │        (Rotating 3D Torus)              │              ║
-║         │                                         │              ║
-║         └─────────────────────────────────────────┘              ║
-║                                                                   ║
-║              AI-Powered Development Assistant                    ║
-║                   Built by AI, for Developers                    ║
-║                                                                   ║
-║       6 AI Models • 1 Command Line • 60fps • 19MB • ♿           ║
-║                                                                   ║
-║         ┌─────────────────────────────────────────┐              ║
-║         │  $ curl -fsSL ry-code.com/install | sh  │              ║
-║         │  [Copy Command]                         │              ║
-║         └─────────────────────────────────────────┘              ║
-║                                                                   ║
-║              [macOS ARM64] [macOS Intel] [Linux] [Windows]      ║
-║                                                                   ║
-║                  Built with toolkit-cli →                        ║
-║                                                                   ║
-║                          ↓ Scroll to explore ↓                  ║
-╚═══════════════════════════════════════════════════════════════════╝
-```
-
-### Mobile Hero Fold (375px)
-```
-╔═══════════════════════╗
-║  RyCode          ☰   ║
-╠═══════════════════════╣
-║                       ║
-║   ┌───────────────┐   ║
-║   │   🌀 CORTEX   │   ║
-║   │   ANIMATION   │   ║
-║   └───────────────┘   ║
-║                       ║
-║  AI-Powered Dev Tool  ║
-║  Built by AI          ║
-║                       ║
-║  6 Models • 60fps     ║
-║  19MB • ♿            ║
-║                       ║
-║  ┌─────────────────┐  ║
-║  │  $ curl ... sh  │  ║
-║  │  [Copy]         │  ║
-║  └─────────────────┘  ║
-║                       ║
-║  [macOS] [Linux]      ║
-║  [Windows]            ║
-║                       ║
-║  toolkit-cli →        ║
-║                       ║
-╚═══════════════════════╝
-```
-
----
-
-## 🔗 Navigation Structure
-
-```
-ry-code.com/
-├── / (Home)
-│   ├── #hero (Installation)
-│   ├── #features (Can't Compete)
-│   ├── #demo (Live Demo)
-│   ├── #performance (Metrics)
-│   ├── #intelligence (AI Features)
-│   ├── #accessibility (Inclusive Design)
-│   ├── #easter-eggs (Personality)
-│   ├── #toolkit (Built With)
-│   ├── #install (Detailed Guide)
-│   └── #get-started (Final CTA)
-│
-├── /docs (Documentation Portal)
-│   ├── /quick-start
-│   ├── /features
-│   ├── /keyboard-shortcuts
-│   ├── /accessibility
-│   ├── /easter-eggs
-│   └── /troubleshooting
-│
-├── /install (Install Script)
-│
-├── /download (Direct Downloads)
-│   ├── /darwin-arm64
-│   ├── /darwin-amd64
-│   ├── /linux-arm64
-│   ├── /linux-amd64
-│   └── /windows-amd64
-│
-└── /toolkit-showcase (Case Study)
-    ├── /multi-agent-development
-    ├── /ai-collaboration
-    └── /lessons-learned
-```
-
----
-
-## 💡 Future Enhancements (Post-Launch)
-
-### Phase 2 Features
-
-1. **Interactive Playground**
-   - Browser-based RyCode demo
-   - No installation required
-   - Share custom configurations
-
-2. **Community Showcase**
-   - User-submitted easter eggs
-   - Custom themes gallery
-   - Configuration sharing
-
-3. **Video Tutorials**
-   - Getting started series
-   - Advanced features deep-dives
-   - Easter eggs reveals
-
-4. **Blog/Changelog**
-   - Release notes
-   - Behind-the-scenes
-   - toolkit-cli case studies
-
-5. **Comparison Page**
-   - RyCode vs traditional CLIs
-   - RyCode vs GUI tools
-   - Feature matrix
-
----
-
-## 📞 Support & Feedback
-
-### Contact Channels
-
-- **GitHub Issues:** Bug reports & feature requests
-- **GitHub Discussions:** Questions & community
-- **Email:** support@ry-code.com
-- **Twitter:** @rycode_cli
-
-### Feedback Collection
-
-```typescript
-// Embedded feedback widget
-<FeedbackWidget
-  questions={[
-    "How easy was installation?",
-    "Which feature impressed you most?",
-    "Did you discover any easter eggs?",
-    "Would you recommend RyCode?"
-  ]}
-  onSubmit={trackFeedback}
-/>
-```
-
----
-
-## 🎯 Conversion Funnel Optimization
-
-### Stage 1: Awareness (Hero Fold)
-- **Goal:** Communicate value in 3 seconds
-- **CTA:** "Install Now" button
-- **Metric:** Bounce rate <40%
-
-### Stage 2: Interest (Features)
-- **Goal:** Showcase differentiators
-- **CTA:** "See Live Demo"
-- **Metric:** Scroll depth >45%
-
-### Stage 3: Consideration (Demo + Metrics)
-- **Goal:** Build trust through performance
-- **CTA:** "View Documentation"
-- **Metric:** Video completion >60%
-
-### Stage 4: Conversion (Installation)
-- **Goal:** Make installation frictionless
-- **CTA:** "Copy Install Command"
-- **Metric:** Install rate >15%
-
-### Stage 5: Advocacy (toolkit-cli)
-- **Goal:** Drive traffic to toolkit-cli.com
-- **CTA:** "Built with toolkit-cli →"
-- **Metric:** Click-through >40%
-
----
-
-## 🚀 Implementation Timeline
-
-### Week 1-2: Foundation
-- [ ] Next.js setup & configuration
-- [ ] Design system implementation
-- [ ] Component library
-- [ ] Hero fold development
-
-### Week 3-4: Content
-- [ ] Features showcase
-- [ ] Performance metrics
-- [ ] Live demo terminal
-- [ ] AI intelligence fold
-
-### Week 5-6: Polish
-- [ ] Accessibility fold
-- [ ] Easter eggs reveal
-- [ ] toolkit-cli showcase
-- [ ] Installation guide
-
-### Week 7-8: Quality
-- [ ] Responsive design
-- [ ] Accessibility audit
-- [ ] Performance optimization
-- [ ] SEO implementation
-
-### Week 9: Pre-Launch
-- [ ] Install script development
-- [ ] Analytics integration
-- [ ] Browser testing
-- [ ] Content review
-
-### Week 10: Launch
-- [ ] Deployment
-- [ ] Monitoring
-- [ ] Announcements
-- [ ] Feedback collection
-
----
-
-## 📚 Resources & References
-
-### Design Inspiration
-- toolkit-cli.com (primary reference)
-- linear.app (clean, developer-focused)
-- vercel.com (performance-first)
-- stripe.com (clarity and conversion)
-
-### Technical Stack
-- Next.js 14: https://nextjs.org
-- Tailwind CSS: https://tailwindcss.com
-- Framer Motion: https://www.framer.com/motion
-- Asciinema Player: https://asciinema.org
-
-### Performance Tools
-- Lighthouse: https://developers.google.com/web/tools/lighthouse
-- WebPageTest: https://www.webpagetest.org
-- PageSpeed Insights: https://pagespeed.web.dev
-
-### Analytics
-- Plausible: https://plausible.io (privacy-respecting)
-- Vercel Analytics: https://vercel.com/analytics
-
----
-
-## ✅ Acceptance Criteria
-
-### Must Have (P0)
-- ✅ One-click installation from hero fold
-- ✅ Neural cortex animation (WebGL/Canvas)
-- ✅ Responsive design (mobile → desktop)
-- ✅ Accessibility (WCAG AA)
-- ✅ Performance (Lighthouse 95+)
-- ✅ toolkit-cli attribution (prominent)
-- ✅ Install script (all platforms)
-- ✅ Analytics integration
-
-### Should Have (P1)
-- ✅ Live demo terminal (Asciinema)
-- ✅ Feature showcase (6+ features)
-- ✅ Performance metrics (animated)
-- ✅ Easter eggs reveal
-- ✅ Social proof section
-- ✅ SEO optimization
-- ✅ Multiple install methods
-
-### Nice to Have (P2)
-- 🎯 Interactive playground
-- 🎯 Video tutorials
-- 🎯 Community showcase
-- 🎯 Blog/changelog
-- 🎯 Comparison page
-
----
-
-## 🎉 Conclusion
-
-This specification provides a comprehensive blueprint for building **ry-code.com** - a high-converting landing page that:
-
-1. ✅ **Showcases RyCode** - Highlights unique features and performance
-2. ✅ **Drives Installations** - Frictionless one-click install from top fold
-3. ✅ **Credits toolkit-cli** - Prominent attribution and case study
-4. ✅ **Converts Visitors** - Optimized funnel with clear CTAs
-5. ✅ **Builds Trust** - Performance metrics, demos, social proof
-
-**Next Steps:**
-1. Review specification with stakeholders
-2. Create design mockups in Figma
-3. Begin Next.js implementation
-4. Record demo videos/GIFs
-5. Develop install script
-6. Launch and monitor
-
----
-
-**🤖 Specification by Multi-Agent Team**
-- **Claude (Architect):** Overall structure and technical decisions
-- **Codex (Engineer):** Code examples and implementation details
-- **Gemini (Designer):** Visual design and UX patterns
-
-**Built with toolkit-cli technology** ⚡
-**Target Launch:** 2 weeks from approval
-**Expected Conversion:** 15% install rate
-
----
-
-*Ready to build the most impressive AI tool landing page on the internet.* 🚀
diff --git a/packages/tui/LANDING_PAGE_TASKS.md b/packages/tui/LANDING_PAGE_TASKS.md
deleted file mode 100644
index 29a007ea..00000000
--- a/packages/tui/LANDING_PAGE_TASKS.md
+++ /dev/null
@@ -1,1520 +0,0 @@
-# RyCode Landing Page - Actionable Task Breakdown
-
-> **Generated by:** toolkit-cli tasks command
-> **Total Tasks:** 87 tasks across 6 phases
-> **Timeline:** 10 weeks (70 days)
-> **Priority System:** 🔴 Critical | 🟡 High | 🟢 Medium | ⚪ Low
-
----
-
-## 📊 Task Summary
-
-| Phase | Tasks | Est. Time | Priority Breakdown |
-|-------|-------|-----------|-------------------|
-| Phase 0: Planning & Design | 15 | 2 weeks | 🔴 8, 🟡 5, 🟢 2 |
-| Phase 1: Foundation | 18 | 2 weeks | 🔴 12, 🟡 4, 🟢 2 |
-| Phase 2: Content Folds | 20 | 2 weeks | 🔴 8, 🟡 8, 🟢 4 |
-| Phase 3: Polish & Assets | 14 | 2 weeks | 🟡 10, 🟢 4 |
-| Phase 4: Optimization | 12 | 1 week | 🔴 8, 🟡 4 |
-| Phase 5: Launch | 8 | 1 week | 🔴 6, 🟡 2 |
-| **Total** | **87** | **10 weeks** | **🔴 42, 🟡 33, 🟢 12** |
-
----
-
-## 🎯 Task Notation
-
-```
-TASK-001 🔴 P0 - Task Title (Est: 4h)
-├─ Owner: [Claude/Codex/Gemini/UX]
-├─ Dependencies: TASK-XXX, TASK-YYY
-├─ Acceptance Criteria:
-│  ├─ [ ] Criterion 1
-│  └─ [ ] Criterion 2
-└─ Deliverable: Specific output
-```
-
-**Priority Levels:**
-- 🔴 **P0 (Critical)** - Blocks other work, must complete
-- 🟡 **P1 (High)** - Important, should complete on schedule
-- 🟢 **P2 (Medium)** - Nice to have, can be deferred
-- ⚪ **P3 (Low)** - Optional, time permitting
-
----
-
-# Phase 0: Planning & Design (Week 1-2)
-
-## Week 1: Design System & Mockups
-
-### TASK-001 🔴 P0 - Define Color Palette (Est: 2h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: None
-├─ Acceptance Criteria:
-│  ├─ [ ] Primary colors defined (neural-cyan, neural-magenta, matrix-green, claude-blue)
-│  ├─ [ ] Background layers defined (dark, elevated, hover)
-│  ├─ [ ] Text hierarchy defined (primary, secondary, muted)
-│  ├─ [ ] Semantic colors defined (success, warning, error, info)
-│  └─ [ ] Colors match toolkit-cli.com aesthetic
-└─ Deliverable: Color palette JSON + Figma color styles
-
----
-
-### TASK-002 🔴 P0 - Define Typography System (Est: 2h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: None
-├─ Acceptance Criteria:
-│  ├─ [ ] Display font selected (Inter)
-│  ├─ [ ] Monospace font selected (Fira Code)
-│  ├─ [ ] Font scale defined (xs → 6xl)
-│  ├─ [ ] Line heights defined (tight, normal, relaxed)
-│  └─ [ ] Font weights defined (regular, semibold, bold)
-└─ Deliverable: Typography spec + Figma text styles
-
----
-
-### TASK-003 🔴 P0 - Create Spacing System (Est: 1h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: None
-├─ Acceptance Criteria:
-│  ├─ [ ] Base spacing unit defined (4px or 8px)
-│  ├─ [ ] Spacing scale defined (0.5x → 4x)
-│  ├─ [ ] Container widths defined
-│  └─ [ ] Breakpoints defined (mobile → desktop)
-└─ Deliverable: Spacing tokens JSON
-
----
-
-### TASK-004 🔴 P0 - Design Hero Fold Mockup (Est: 4h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003
-├─ Acceptance Criteria:
-│  ├─ [ ] Desktop layout (1440px)
-│  ├─ [ ] Mobile layout (375px)
-│  ├─ [ ] Neural cortex placeholder
-│  ├─ [ ] Installation command prominent
-│  ├─ [ ] toolkit-cli attribution visible
-│  └─ [ ] 3 A/B test variants
-└─ Deliverable: Figma mockup (3 variants)
-
----
-
-### TASK-005 🔴 P0 - Design Feature Showcase Fold (Est: 3h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003
-├─ Acceptance Criteria:
-│  ├─ [ ] Grid layout (3×2 desktop, 1 col mobile)
-│  ├─ [ ] Feature card design
-│  ├─ [ ] Hover states
-│  ├─ [ ] Icons/emojis for features
-│  └─ [ ] "Show All" expansion UI
-└─ Deliverable: Figma mockup
-
----
-
-### TASK-006 🔴 P0 - Design Performance Metrics Fold (Est: 3h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003
-├─ Acceptance Criteria:
-│  ├─ [ ] 4 metric cards layout
-│  ├─ [ ] Animated counter design
-│  ├─ [ ] Icon/emoji for each metric
-│  ├─ [ ] Responsive layout
-│  └─ [ ] Tooltip design
-└─ Deliverable: Figma mockup
-
----
-
-### TASK-007 🔴 P0 - Design Live Demo Fold (Est: 3h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003
-├─ Acceptance Criteria:
-│  ├─ [ ] Terminal window design
-│  ├─ [ ] Playback controls UI
-│  ├─ [ ] Poster frame design
-│  ├─ [ ] Loading state
-│  └─ [ ] Responsive layout
-└─ Deliverable: Figma mockup
-
----
-
-### TASK-008 🔴 P0 - Design Remaining Folds (Est: 6h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003
-├─ Acceptance Criteria:
-│  ├─ [ ] AI Intelligence Fold
-│  ├─ [ ] Accessibility Fold
-│  ├─ [ ] Easter Eggs Fold
-│  ├─ [ ] toolkit-cli Showcase Fold
-│  ├─ [ ] Installation Guide Fold
-│  └─ [ ] Final CTA Fold
-└─ Deliverable: Figma mockups (6 folds)
-
----
-
-### TASK-009 🟡 P1 - Define Animation Specifications (Est: 3h)
-├─ Owner: Gemini (Designer) + UX Specialist
-├─ Dependencies: TASK-004, TASK-005, TASK-006
-├─ Acceptance Criteria:
-│  ├─ [ ] Floating orbs behavior defined
-│  ├─ [ ] Scroll-triggered animation timing
-│  ├─ [ ] Micro-interaction specs
-│  ├─ [ ] Loading states
-│  └─ [ ] Reduced motion fallbacks
-└─ Deliverable: Animation spec document + Lottie files (optional)
-
----
-
-### TASK-010 🟡 P1 - Create Asset Requirements Doc (Est: 2h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-004, TASK-005, TASK-006, TASK-007, TASK-008
-├─ Acceptance Criteria:
-│  ├─ [ ] Neural cortex video specs (resolution, duration, format)
-│  ├─ [ ] Feature demo GIF list (6+)
-│  ├─ [ ] Screenshot requirements
-│  ├─ [ ] Social media asset sizes
-│  └─ [ ] Icon requirements
-└─ Deliverable: Asset requirements spreadsheet
-
----
-
-### TASK-011 🟢 P2 - Create Component Library in Figma (Est: 4h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003
-├─ Acceptance Criteria:
-│  ├─ [ ] Button components (5 variants)
-│  ├─ [ ] Card components (4 types)
-│  ├─ [ ] Input components
-│  ├─ [ ] Navigation component
-│  └─ [ ] All components responsive
-└─ Deliverable: Figma component library
-
----
-
-### TASK-012 🟢 P2 - Create Design System Documentation (Est: 2h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003, TASK-011
-├─ Acceptance Criteria:
-│  ├─ [ ] Color palette documented
-│  ├─ [ ] Typography usage examples
-│  ├─ [ ] Spacing guidelines
-│  ├─ [ ] Component usage rules
-│  └─ [ ] Accessibility notes
-└─ Deliverable: Design system markdown doc
-
----
-
-## Week 2: Technical Setup & Architecture
-
-### TASK-013 🔴 P0 - Initialize Next.js Project (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: None
-├─ Acceptance Criteria:
-│  ├─ [ ] Next.js 14 with App Router
-│  ├─ [ ] TypeScript configured
-│  ├─ [ ] Tailwind CSS installed
-│  ├─ [ ] ESLint + Prettier configured
-│  └─ [ ] Git repository initialized
-└─ Deliverable: Working Next.js project
-
-```bash
-npx create-next-app@latest rycode-landing \
-  --typescript \
-  --tailwind \
-  --app \
-  --eslint
-```
-
----
-
-### TASK-014 🔴 P0 - Setup GitHub Repository (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] GitHub repo created
-│  ├─ [ ] Main branch protected
-│  ├─ [ ] Pull request template
-│  ├─ [ ] Issue templates
-│  └─ [ ] README with setup instructions
-└─ Deliverable: GitHub repository URL
-
----
-
-### TASK-015 🔴 P0 - Setup Vercel Integration (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-014
-├─ Acceptance Criteria:
-│  ├─ [ ] Vercel project connected to GitHub
-│  ├─ [ ] Preview deployments enabled
-│  ├─ [ ] Production domain configured (ry-code.com)
-│  ├─ [ ] Environment variables set
-│  └─ [ ] First deployment successful
-└─ Deliverable: Vercel dashboard URL + preview link
-
----
-
-### TASK-016 🔴 P0 - Configure Tailwind with Design Tokens (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-001, TASK-002, TASK-003, TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] tailwind.config.js matches Figma design tokens
-│  ├─ [ ] Custom colors defined
-│  ├─ [ ] Typography scale defined
-│  ├─ [ ] Spacing system defined
-│  ├─ [ ] Breakpoints configured
-│  └─ [ ] Dark mode enabled
-└─ Deliverable: tailwind.config.js + globals.css
-
----
-
-### TASK-017 🔴 P0 - Install Core Dependencies (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] framer-motion installed
-│  ├─ [ ] asciinema-player installed
-│  ├─ [ ] @tailwindcss/typography installed
-│  ├─ [ ] @tailwindcss/forms installed
-│  └─ [ ] plausible-tracker installed
-└─ Deliverable: package.json with all dependencies
-
-```bash
-npm install framer-motion asciinema-player
-npm install -D @tailwindcss/typography @tailwindcss/forms
-npm install plausible-tracker
-```
-
----
-
-### TASK-018 🔴 P0 - Create Component Architecture (Est: 2h)
-├─ Owner: Claude (Architect) + Codex (Engineer)
-├─ Dependencies: TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] Folder structure created
-│  ├─ [ ] Component naming convention documented
-│  ├─ [ ] Import aliases configured (@/components, @/lib)
-│  ├─ [ ] Barrel exports setup
-│  └─ [ ] README with architecture explanation
-└─ Deliverable: src/ folder structure
-
-```
-src/
-├── app/
-│   ├── layout.tsx
-│   ├── page.tsx
-│   └── globals.css
-├── components/
-│   ├── folds/
-│   ├── ui/
-│   └── animations/
-├── lib/
-│   ├── analytics.ts
-│   └── utils.ts
-└── styles/
-```
-
----
-
-### TASK-019 🔴 P0 - Setup CI/CD Pipeline (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-014
-├─ Acceptance Criteria:
-│  ├─ [ ] GitHub Actions workflow created
-│  ├─ [ ] Lint check on PR
-│  ├─ [ ] Type check on PR
-│  ├─ [ ] Build check on PR
-│  ├─ [ ] Auto-deploy to Vercel on merge
-│  └─ [ ] Status checks required for merge
-└─ Deliverable: .github/workflows/ci.yml
-
----
-
-### TASK-020 🔴 P0 - Create Framer Motion Variants Library (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-017
-├─ Acceptance Criteria:
-│  ├─ [ ] fadeInUp variant
-│  ├─ [ ] staggerChildren variant
-│  ├─ [ ] scaleIn variant
-│  ├─ [ ] floatingOrb variant
-│  └─ [ ] slideIn variant
-└─ Deliverable: src/components/animations/variants.ts
-
----
-
-### TASK-021 🔴 P0 - Create Install Script v1 (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: None
-├─ Acceptance Criteria:
-│  ├─ [ ] Detects OS (macOS, Linux, Windows)
-│  ├─ [ ] Detects architecture (ARM64, AMD64)
-│  ├─ [ ] Downloads correct binary
-│  ├─ [ ] Verifies checksum
-│  ├─ [ ] Installs to /usr/local/bin
-│  └─ [ ] Shows success message
-└─ Deliverable: public/install.sh
-
----
-
-### TASK-022 🔴 P0 - Test Install Script on All Platforms (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-021
-├─ Acceptance Criteria:
-│  ├─ [ ] Works on macOS ARM64
-│  ├─ [ ] Works on macOS Intel
-│  ├─ [ ] Works on Linux AMD64
-│  ├─ [ ] Works on Linux ARM64
-│  ├─ [ ] Fails gracefully on Windows (show manual instructions)
-│  └─ [ ] Error messages helpful
-└─ Deliverable: Test report + fixes
-
----
-
-### TASK-023 🟡 P1 - Setup Analytics (Plausible) (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013, TASK-017
-├─ Acceptance Criteria:
-│  ├─ [ ] Plausible account created
-│  ├─ [ ] Script added to layout.tsx
-│  ├─ [ ] Custom events defined
-│  ├─ [ ] Privacy-respecting (no cookies)
-│  └─ [ ] Dashboard accessible
-└─ Deliverable: src/lib/analytics.ts
-
----
-
-### TASK-024 🟡 P1 - Create Utility Functions (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] cn() function (Tailwind class merging)
-│  ├─ [ ] formatNumber() (animated counters)
-│  ├─ [ ] copyToClipboard() (copy buttons)
-│  ├─ [ ] detectPlatform() (install script)
-│  └─ [ ] All functions typed
-└─ Deliverable: src/lib/utils.ts
-
----
-
-### TASK-025 🟡 P1 - Setup Error Tracking (Sentry) (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] Sentry account created (or alternative)
-│  ├─ [ ] SDK installed
-│  ├─ [ ] Error boundary created
-│  ├─ [ ] Source maps uploaded
-│  └─ [ ] Test error captured
-└─ Deliverable: Error tracking dashboard
-
----
-
-### TASK-026 🟢 P2 - Create Development Scripts (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013
-├─ Acceptance Criteria:
-│  ├─ [ ] npm run dev (development server)
-│  ├─ [ ] npm run build (production build)
-│  ├─ [ ] npm run lint (ESLint check)
-│  ├─ [ ] npm run type-check (TypeScript check)
-│  └─ [ ] npm run format (Prettier)
-└─ Deliverable: Updated package.json scripts
-
----
-
-### TASK-027 🟢 P2 - Create Project README (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-013, TASK-018
-├─ Acceptance Criteria:
-│  ├─ [ ] Setup instructions
-│  ├─ [ ] Development workflow
-│  ├─ [ ] Deployment process
-│  ├─ [ ] Architecture overview
-│  └─ [ ] Contributing guidelines
-└─ Deliverable: README.md
-
----
-
-# Phase 1: Foundation (Week 3-4)
-
-## Week 3: Core Components & Navigation
-
-### TASK-028 🔴 P0 - Build Navigation Component (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Sticky navigation on scroll
-│  ├─ [ ] Background blur when scrolled
-│  ├─ [ ] Responsive (mobile hamburger menu)
-│  ├─ [ ] toolkit-cli link prominent
-│  ├─ [ ] Smooth scroll to sections
-│  └─ [ ] Keyboard accessible
-└─ Deliverable: src/components/Navigation.tsx
-
----
-
-### TASK-029 🔴 P0 - Build Button Components (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016
-├─ Acceptance Criteria:
-│  ├─ [ ] Primary button (gradient, hover effects)
-│  ├─ [ ] Secondary button
-│  ├─ [ ] Icon button
-│  ├─ [ ] Copy button (with success state)
-│  ├─ [ ] Loading state
-│  └─ [ ] All variants accessible
-└─ Deliverable: src/components/ui/Button.tsx
-
----
-
-### TASK-030 🔴 P0 - Build Card Components (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Feature card (hover scale effect)
-│  ├─ [ ] Metric card (with icon)
-│  ├─ [ ] Testimonial card
-│  ├─ [ ] Provider card (AI models)
-│  └─ [ ] All cards responsive
-└─ Deliverable: src/components/ui/Card.tsx
-
----
-
-### TASK-031 🔴 P0 - Build Code Block Component (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-024, TASK-029
-├─ Acceptance Criteria:
-│  ├─ [ ] Syntax highlighting (optional)
-│  ├─ [ ] Copy button integrated
-│  ├─ [ ] Success animation on copy
-│  ├─ [ ] Multiple language support
-│  └─ [ ] Responsive overflow
-└─ Deliverable: src/components/ui/CodeBlock.tsx
-
----
-
-### TASK-032 🔴 P0 - Build Animated Counter Component (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020, TASK-024
-├─ Acceptance Criteria:
-│  ├─ [ ] Count-up animation on scroll into view
-│  ├─ [ ] Configurable duration
-│  ├─ [ ] Decimal support (54.2%)
-│  ├─ [ ] Unit suffix (ns, fps, MB)
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: src/components/ui/AnimatedCounter.tsx
-
----
-
-### TASK-033 🔴 P0 - Build Floating Orbs Component (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Two orbs with different sizes
-│  ├─ [ ] Floating animation (vertical)
-│  ├─ [ ] Blur effect
-│  ├─ [ ] Gradient colors (cyan, magenta)
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: src/components/animations/FloatingOrbs.tsx
-
----
-
-### TASK-034 🔴 P0 - Create Scroll Animation Hook (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-017
-├─ Acceptance Criteria:
-│  ├─ [ ] Intersection Observer based
-│  ├─ [ ] Configurable threshold
-│  ├─ [ ] Once vs. repeat option
-│  ├─ [ ] Returns isInView boolean
-│  └─ [ ] TypeScript typed
-└─ Deliverable: src/lib/hooks/useScrollAnimation.ts
-
----
-
-### TASK-035 🟡 P1 - Build Toast/Notification Component (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Success, error, info variants
-│  ├─ [ ] Auto-dismiss (configurable)
-│  ├─ [ ] Slide-in animation
-│  ├─ [ ] Stacked toasts
-│  └─ [ ] Accessible (ARIA live region)
-└─ Deliverable: src/components/ui/Toast.tsx
-
----
-
-### TASK-036 🟡 P1 - Build Modal Component (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Overlay with backdrop blur
-│  ├─ [ ] Scale-in animation
-│  ├─ [ ] Close on ESC key
-│  ├─ [ ] Close on backdrop click
-│  ├─ [ ] Focus trap
-│  └─ [ ] Accessible (ARIA dialog)
-└─ Deliverable: src/components/ui/Modal.tsx
-
----
-
-### TASK-037 🟢 P2 - Build Tooltip Component (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Hover-triggered
-│  ├─ [ ] Positioning (top, bottom, left, right)
-│  ├─ [ ] Arrow pointer
-│  ├─ [ ] Fade animation
-│  └─ [ ] Accessible (ARIA describedby)
-└─ Deliverable: src/components/ui/Tooltip.tsx
-
----
-
-### TASK-038 🟢 P2 - Create Loading Skeleton Component (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016
-├─ Acceptance Criteria:
-│  ├─ [ ] Shimmer animation
-│  ├─ [ ] Multiple shapes (rect, circle, text)
-│  ├─ [ ] Configurable width/height
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: src/components/ui/Skeleton.tsx
-
----
-
-## Week 4: Hero Fold + Installation
-
-### TASK-039 🔴 P0 - Build Neural Cortex Animation (Canvas) (Est: 8h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-016
-├─ Acceptance Criteria:
-│  ├─ [ ] Canvas-based 3D torus rendering
-│  ├─ [ ] 30 FPS target
-│  ├─ [ ] Rotation matrices (X and Z axes)
-│  ├─ [ ] Gradient coloring (cyan → magenta)
-│  ├─ [ ] Perspective projection
-│  ├─ [ ] Responsive canvas sizing
-│  ├─ [ ] Pause on reduced motion
-│  └─ [ ] Performance monitoring (<5ms per frame)
-└─ Deliverable: src/components/animations/NeuralCortex.tsx
-
-**Implementation Guide:**
-```typescript
-// Torus rendering loop
-for (let theta = 0; theta < Math.PI * 2; theta += 0.1) {
-  for (let phi = 0; phi < Math.PI * 2; phi += 0.05) {
-    // Calculate 3D point
-    const circleX = R + r * Math.cos(phi);
-    const circleY = r * Math.sin(phi);
-
-    // Apply rotation
-    const x = circleX * (Math.cos(B) * Math.cos(theta) +
-              Math.sin(A) * Math.sin(B) * Math.sin(theta)) -
-              circleY * Math.cos(A) * Math.sin(B);
-
-    // Project to 2D
-    const z = 5 + Math.cos(A) * circleX * Math.sin(theta) +
-              circleY * Math.sin(A);
-    const ooz = 1 / z;
-    const xp = canvas.width / 2 + 60 * ooz * x;
-
-    // Render pixel with gradient color
-    ctx.fillStyle = getGradientColor(phi, theta);
-    ctx.fillRect(xp, yp, 2, 2);
-  }
-}
-```
-
----
-
-### TASK-040 🔴 P0 - Build Install Command Component (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-024, TASK-029, TASK-031
-├─ Acceptance Criteria:
-│  ├─ [ ] Displays install command (curl | sh)
-│  ├─ [ ] Copy button with success feedback
-│  ├─ [ ] Platform auto-detection
-│  ├─ [ ] Manual platform override
-│  └─ [ ] Alternative install methods (tabs)
-└─ Deliverable: src/components/ui/InstallCommand.tsx
-
----
-
-### TASK-041 🔴 P0 - Build Platform Selector Component (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-024, TASK-029
-├─ Acceptance Criteria:
-│  ├─ [ ] Buttons for each platform (macOS, Linux, Windows)
-│  ├─ [ ] ARM64 / AMD64 variants
-│  ├─ [ ] Active state styling
-│  ├─ [ ] Updates install command on click
-│  └─ [ ] Keyboard accessible
-└─ Deliverable: src/components/ui/PlatformSelector.tsx
-
----
-
-### TASK-042 🔴 P0 - Build Hero Fold Component (Est: 6h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-039, TASK-040, TASK-041, TASK-033
-├─ Acceptance Criteria:
-│  ├─ [ ] Full viewport height (100vh)
-│  ├─ [ ] Neural cortex animation integrated
-│  ├─ [ ] Hero headline with gradient text
-│  ├─ [ ] Subheadline with features
-│  ├─ [ ] Install command prominent
-│  ├─ [ ] Platform selector
-│  ├─ [ ] toolkit-cli attribution link
-│  ├─ [ ] Scroll indicator
-│  ├─ [ ] Floating orbs background
-│  ├─ [ ] Staggered entrance animations
-│  └─ [ ] Mobile responsive
-└─ Deliverable: src/components/folds/HeroFold.tsx
-
----
-
-### TASK-043 🟡 P1 - Add Scroll Indicator Animation (Est: 1h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-042
-├─ Acceptance Criteria:
-│  ├─ [ ] Bouncing arrow or text
-│  ├─ [ ] Fades out on scroll
-│  ├─ [ ] Smooth animation loop
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: Part of HeroFold.tsx
-
----
-
-### TASK-044 🟡 P1 - Optimize Neural Cortex Performance (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-039
-├─ Acceptance Criteria:
-│  ├─ [ ] Frame time consistently <5ms
-│  ├─ [ ] No memory leaks
-│  ├─ [ ] Cleanup on unmount
-│  ├─ [ ] Adaptive quality on slow devices
-│  └─ [ ] Lighthouse performance >90
-└─ Deliverable: Optimized NeuralCortex.tsx
-
----
-
-### TASK-045 🟢 P2 - Add Neural Cortex Interactivity (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-039
-├─ Acceptance Criteria:
-│  ├─ [ ] Mouse hover speeds up rotation
-│  ├─ [ ] Click toggles pause/play
-│  ├─ [ ] Touch-friendly on mobile
-│  └─ [ ] Accessible controls (buttons)
-└─ Deliverable: Enhanced NeuralCortex.tsx
-
----
-
-# Phase 2: Content Folds (Week 5-6)
-
-## Week 5: Feature Showcase + Performance Metrics
-
-### TASK-046 🔴 P0 - Build Feature Card Component (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030, TASK-020
-├─ Acceptance Criteria:
-│  ├─ [ ] Icon/emoji display
-│  ├─ [ ] Title and description
-│  ├─ [ ] Metric badge (optional)
-│  ├─ [ ] Hover scale effect
-│  ├─ [ ] Click opens modal with demo
-│  └─ [ ] Responsive
-└─ Deliverable: src/components/ui/FeatureCard.tsx
-
----
-
-### TASK-047 🔴 P0 - Build Feature Showcase Fold (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-046, TASK-036
-├─ Acceptance Criteria:
-│  ├─ [ ] Grid layout (3×2 desktop, 1 col mobile)
-│  ├─ [ ] 6 features displayed initially
-│  ├─ [ ] "Show All 13 Features" expansion
-│  ├─ [ ] Staggered entrance animations
-│  ├─ [ ] Feature modal with detailed info
-│  └─ [ ] Scroll-triggered animations
-└─ Deliverable: src/components/folds/FeatureShowcase.tsx
-
----
-
-### TASK-048 🔴 P0 - Build Metric Card Component (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030, TASK-032
-├─ Acceptance Criteria:
-│  ├─ [ ] Large animated number
-│  ├─ [ ] Unit display (ns, fps, MB, %)
-│  ├─ [ ] Icon/emoji
-│  ├─ [ ] Metric label
-│  ├─ [ ] Description text
-│  └─ [ ] Tooltip on hover
-└─ Deliverable: src/components/ui/MetricCard.tsx
-
----
-
-### TASK-049 🔴 P0 - Build Performance Metrics Fold (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-048
-├─ Acceptance Criteria:
-│  ├─ [ ] 4 metric cards (64ns, 60fps, 19MB, 54.2%)
-│  ├─ [ ] Count-up animation on scroll
-│  ├─ [ ] Section headline
-│  ├─ [ ] Benchmark attribution
-│  ├─ [ ] Responsive layout
-│  └─ [ ] Scroll-triggered animations
-└─ Deliverable: src/components/folds/PerformanceMetrics.tsx
-
----
-
-### TASK-050 🔴 P0 - Build AI Intelligence Fold (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030
-├─ Acceptance Criteria:
-│  ├─ [ ] Provider logos/icons (Anthropic, OpenAI, Google, X.AI, Alibaba)
-│  ├─ [ ] Feature list with icons
-│  ├─ [ ] Interactive model selector (optional)
-│  ├─ [ ] Comparison table (optional)
-│  └─ [ ] Responsive layout
-└─ Deliverable: src/components/folds/AIIntelligence.tsx
-
----
-
-### TASK-051 🟡 P1 - Add Feature Demo Modals (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-036, TASK-047
-├─ Acceptance Criteria:
-│  ├─ [ ] 6+ feature modals
-│  ├─ [ ] Each modal has demo GIF/video
-│  ├─ [ ] Detailed description
-│  ├─ [ ] Related features links
-│  └─ [ ] Keyboard navigation (prev/next)
-└─ Deliverable: Enhanced FeatureShowcase.tsx
-
----
-
-### TASK-052 🟡 P1 - Add Performance Comparison Chart (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-049
-├─ Acceptance Criteria:
-│  ├─ [ ] Bar chart showing RyCode vs others
-│  ├─ [ ] Animated bars on scroll
-│  ├─ [ ] Responsive design
-│  └─ [ ] Accessible (data table fallback)
-└─ Deliverable: Enhanced PerformanceMetrics.tsx
-
----
-
-### TASK-053 🟢 P2 - Add Provider Hover Details (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-050
-├─ Acceptance Criteria:
-│  ├─ [ ] Hover on provider shows models
-│  ├─ [ ] Smooth transition
-│  ├─ [ ] Model count badge
-│  └─ [ ] Link to provider docs
-└─ Deliverable: Enhanced AIIntelligence.tsx
-
----
-
-## Week 6: Live Demo + Accessibility + Easter Eggs
-
-### TASK-054 🔴 P0 - Record Asciinema Demo (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: None (requires working RyCode)
-├─ Acceptance Criteria:
-│  ├─ [ ] Demo script prepared
-│  ├─ [ ] 2-3 minute recording
-│  ├─ [ ] Shows key features (model switching, insights, etc.)
-│  ├─ [ ] Clean terminal (no personal info)
-│  ├─ [ ] Good pacing (not too fast)
-│  └─ [ ] .cast file exported
-└─ Deliverable: public/demos/rycode-demo.cast
-
-**Demo Script:**
-```bash
-# 1. Launch RyCode (show splash)
-./rycode
-
-# 2. Cycle models with Tab key
-# [Show 3-4 different models]
-
-# 3. Open usage insights (Ctrl+I)
-# [Show charts and stats]
-
-# 4. Open performance monitor (Ctrl+D)
-# [Show 60fps metrics]
-
-# 5. Exit gracefully
-# [Ctrl+C]
-```
-
----
-
-### TASK-055 🔴 P0 - Build Live Demo Terminal Component (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-054, TASK-017
-├─ Acceptance Criteria:
-│  ├─ [ ] Asciinema Player integrated
-│  ├─ [ ] Dracula theme applied
-│  ├─ [ ] Auto-play enabled
-│  ├─ [ ] Loop enabled
-│  ├─ [ ] Playback controls visible
-│  ├─ [ ] Poster frame at 5s
-│  ├─ [ ] Responsive sizing
-│  └─ [ ] Loading state
-└─ Deliverable: src/components/ui/TerminalDemo.tsx
-
----
-
-### TASK-056 🔴 P0 - Build Live Demo Fold (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-055
-├─ Acceptance Criteria:
-│  ├─ [ ] Section headline
-│  ├─ [ ] TerminalDemo integrated
-│  ├─ [ ] Playback controls styled
-│  ├─ [ ] CTA to install below demo
-│  └─ [ ] Scroll-triggered animation
-└─ Deliverable: src/components/folds/LiveDemo.tsx
-
----
-
-### TASK-057 🔴 P0 - Build Accessibility Fold (Est: 4h)
-├─ Owner: Codex (Engineer) + UX Specialist
-├─ Dependencies: TASK-030
-├─ Acceptance Criteria:
-│  ├─ [ ] 9 accessibility modes listed
-│  ├─ [ ] Before/after toggle demos
-│  ├─ [ ] Feature icons
-│  ├─ [ ] WCAG AA compliance badges
-│  ├─ [ ] Keyboard navigation showcase
-│  └─ [ ] Screen reader demo video
-└─ Deliverable: src/components/folds/AccessibilityFold.tsx
-
----
-
-### TASK-058 🔴 P0 - Build Easter Eggs Fold (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030
-├─ Acceptance Criteria:
-│  ├─ [ ] Section headline "Because Software Should Delight"
-│  ├─ [ ] 5+ easter eggs listed
-│  ├─ [ ] Spoiler tag reveals (click to reveal)
-│  ├─ [ ] Animated discovery effects
-│  ├─ [ ] "Try it yourself" CTAs
-│  └─ [ ] Responsive layout
-└─ Deliverable: src/components/folds/EasterEggsFold.tsx
-
----
-
-### TASK-059 🔴 P0 - Build toolkit-cli Showcase Fold (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030
-├─ Acceptance Criteria:
-│  ├─ [ ] "Built with toolkit-cli" prominent
-│  ├─ [ ] Multi-agent collaboration visual
-│  ├─ [ ] Case study highlights
-│  ├─ [ ] Link to full case study
-│  ├─ [ ] "Try toolkit-cli" CTA button
-│  └─ [ ] toolkit-cli branding consistent
-└─ Deliverable: src/components/folds/ToolkitShowcase.tsx
-
----
-
-### TASK-060 🟡 P1 - Add Before/After Toggle for Accessibility (Est: 3h)
-├─ Owner: UX Specialist + Codex (Engineer)
-├─ Dependencies: TASK-057
-├─ Acceptance Criteria:
-│  ├─ [ ] Toggle button
-│  ├─ [ ] Smooth transition between states
-│  ├─ [ ] Shows 3-4 accessibility features
-│  └─ [ ] Responsive
-└─ Deliverable: Enhanced AccessibilityFold.tsx
-
----
-
-### TASK-061 🟡 P1 - Add Easter Egg Interactive Demos (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-058
-├─ Acceptance Criteria:
-│  ├─ [ ] Konami code input simulation
-│  ├─ [ ] Donut mode preview (short loop)
-│  ├─ [ ] Math equations preview
-│  └─ [ ] Hover effects
-└─ Deliverable: Enhanced EasterEggsFold.tsx
-
----
-
-### TASK-062 🟢 P2 - Add toolkit-cli Timeline/Process Visual (Est: 2h)
-├─ Owner: Gemini (Designer) + Codex (Engineer)
-├─ Dependencies: TASK-059
-├─ Acceptance Criteria:
-│  ├─ [ ] Visual timeline of development
-│  ├─ [ ] Agent avatars (Claude, Codex, Gemini)
-│  ├─ [ ] Contribution breakdown
-│  └─ [ ] Animated on scroll
-└─ Deliverable: Enhanced ToolkitShowcase.tsx
-
----
-
-# Phase 3: Polish & Assets (Week 7-8)
-
-## Week 7: Asset Creation + Final Folds
-
-### TASK-063 🟡 P1 - Create Neural Cortex Demo Video (Est: 3h)
-├─ Owner: Gemini (Designer) + Codex (Engineer)
-├─ Dependencies: TASK-039
-├─ Acceptance Criteria:
-│  ├─ [ ] 3-5 second loop
-│  ├─ [ ] 1920x1080 resolution
-│  ├─ [ ] WebM + MP4 formats
-│  ├─ [ ] <2MB file size
-│  └─ [ ] Shows all easter egg modes (normal, rainbow, math)
-└─ Deliverable: public/videos/neural-cortex.webm + .mp4
-
----
-
-### TASK-064 🟡 P1 - Create Feature Demo GIFs (Est: 6h)
-├─ Owner: Gemini (Designer) + Codex (Engineer)
-├─ Dependencies: None (requires working RyCode)
-├─ Acceptance Criteria:
-│  ├─ [ ] 6+ feature GIFs created
-│  ├─ [ ] Features: splash, performance, model switch, budget, insights, accessibility
-│  ├─ [ ] 5-10 seconds each
-│  ├─ [ ] 1280x720 resolution
-│  ├─ [ ] <5MB per GIF
-│  └─ [ ] Optimized with gifsicle
-└─ Deliverable: public/demos/feature-*.gif (6 files)
-
----
-
-### TASK-065 🟡 P1 - Create Screenshots Gallery (Est: 2h)
-├─ Owner: Gemini (Designer) + Codex (Engineer)
-├─ Dependencies: None (requires working RyCode)
-├─ Acceptance Criteria:
-│  ├─ [ ] 10+ screenshots
-│  ├─ [ ] Main TUI interface
-│  ├─ [ ] Model selector dialog
-│  ├─ [ ] Provider management
-│  ├─ [ ] Performance dashboard
-│  ├─ [ ] Accessibility settings
-│  ├─ [ ] WebP format
-│  └─ [ ] Optimized file sizes
-└─ Deliverable: public/images/screenshots/*.webp
-
----
-
-### TASK-066 🟡 P1 - Create Social Media Assets (Est: 3h)
-├─ Owner: Gemini (Designer)
-├─ Dependencies: TASK-063
-├─ Acceptance Criteria:
-│  ├─ [ ] OG Image (1200x630px)
-│  ├─ [ ] Twitter Card (1200x675px)
-│  ├─ [ ] Favicon (512x512px SVG + PNG variants)
-│  ├─ [ ] Apple Touch Icon
-│  └─ [ ] All optimized
-└─ Deliverable: public/images/social/* (5+ files)
-
----
-
-### TASK-067 🔴 P0 - Build Installation Guide Fold (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-031, TASK-040
-├─ Acceptance Criteria:
-│  ├─ [ ] Tab navigation (Quick Install / Manual Download / Build from Source)
-│  ├─ [ ] Each tab has code blocks
-│  ├─ [ ] Platform-specific instructions
-│  ├─ [ ] Troubleshooting section
-│  ├─ [ ] Link to full documentation
-│  └─ [ ] Responsive
-└─ Deliverable: src/components/folds/InstallationGuide.tsx
-
----
-
-### TASK-068 🔴 P0 - Build Final CTA Fold (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030, TASK-040
-├─ Acceptance Criteria:
-│  ├─ [ ] Testimonial carousel (optional)
-│  ├─ [ ] Social proof (GitHub stars, downloads)
-│  ├─ [ ] Final install CTA button
-│  ├─ [ ] Newsletter signup (optional)
-│  └─ [ ] Scroll-triggered animation
-└─ Deliverable: src/components/folds/FinalCTA.tsx
-
----
-
-### TASK-069 🟡 P1 - Add Testimonial Carousel (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-068
-├─ Acceptance Criteria:
-│  ├─ [ ] 5+ testimonials
-│  ├─ [ ] Auto-rotate (10s interval)
-│  ├─ [ ] Manual navigation (prev/next)
-│  ├─ [ ] Smooth transitions
-│  └─ [ ] Pause on hover
-└─ Deliverable: Enhanced FinalCTA.tsx
-
----
-
-### TASK-070 🟢 P2 - Add GitHub Star Count API Integration (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-068
-├─ Acceptance Criteria:
-│  ├─ [ ] Fetch real-time GitHub stars
-│  ├─ [ ] Format number (1.2k)
-│  ├─ [ ] Cache with SWR or React Query
-│  ├─ [ ] Fallback to static number
-│  └─ [ ] Animated counter on load
-└─ Deliverable: Enhanced FinalCTA.tsx
-
----
-
-## Week 8: Responsive Design + Micro-interactions
-
-### TASK-071 🔴 P0 - Optimize Mobile Hero Fold (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-042
-├─ Acceptance Criteria:
-│  ├─ [ ] Smaller neural cortex on mobile
-│  ├─ [ ] Stacked layout (not side-by-side)
-│  ├─ [ ] Larger touch targets (44px minimum)
-│  ├─ [ ] Optimized font sizes
-│  └─ [ ] Test on real devices (iOS, Android)
-└─ Deliverable: Responsive HeroFold.tsx
-
----
-
-### TASK-072 🔴 P0 - Optimize Mobile Navigation (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-028
-├─ Acceptance Criteria:
-│  ├─ [ ] Hamburger menu icon
-│  ├─ [ ] Slide-in menu animation
-│  ├─ [ ] Close on link click
-│  ├─ [ ] Close on backdrop click
-│  └─ [ ] Keyboard accessible
-└─ Deliverable: Responsive Navigation.tsx
-
----
-
-### TASK-073 🔴 P0 - Test All Folds on Mobile (320px - 768px) (Est: 4h)
-├─ Owner: Codex (Engineer) + UX Specialist
-├─ Dependencies: TASK-071, TASK-072, All fold tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] All folds render correctly on 320px (iPhone SE)
-│  ├─ [ ] All folds render correctly on 375px (iPhone 12)
-│  ├─ [ ] All folds render correctly on 768px (iPad)
-│  ├─ [ ] No horizontal scroll
-│  ├─ [ ] Text readable without zoom
-│  └─ [ ] Touch-friendly interactions
-└─ Deliverable: Mobile testing report + fixes
-
----
-
-### TASK-074 🔴 P0 - Add Button Hover Micro-interactions (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-029
-├─ Acceptance Criteria:
-│  ├─ [ ] Scale on hover (1.05)
-│  ├─ [ ] Gradient shift
-│  ├─ [ ] Shadow elevation
-│  ├─ [ ] Smooth transitions (200ms)
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: Enhanced Button.tsx
-
----
-
-### TASK-075 🔴 P0 - Add Card Hover Micro-interactions (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-030, TASK-046, TASK-048
-├─ Acceptance Criteria:
-│  ├─ [ ] Lift on hover (translateY)
-│  ├─ [ ] Shadow elevation
-│  ├─ [ ] Border glow
-│  ├─ [ ] Smooth transitions
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: Enhanced Card components
-
----
-
-### TASK-076 🟡 P1 - Add Scroll-Triggered Parallax Effects (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: All fold tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] Floating orbs move with scroll
-│  ├─ [ ] Background elements slower than foreground
-│  ├─ [ ] Smooth performance (60fps)
-│  └─ [ ] Respects reduced motion
-└─ Deliverable: Enhanced fold components
-
----
-
-### TASK-077 🟡 P1 - Cross-Browser Testing (Est: 4h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: All tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] Test on Chrome (latest)
-│  ├─ [ ] Test on Firefox (latest)
-│  ├─ [ ] Test on Safari (latest)
-│  ├─ [ ] Test on Edge (latest)
-│  ├─ [ ] Test on iOS Safari 14+
-│  ├─ [ ] Test on Chrome Android
-│  ├─ [ ] Fix browser-specific bugs
-│  └─ [ ] No console errors
-└─ Deliverable: Cross-browser test report + fixes
-
----
-
-### TASK-078 🟢 P2 - Add Loading State Micro-interactions (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-038
-├─ Acceptance Criteria:
-│  ├─ [ ] Skeleton screens for async content
-│  ├─ [ ] Spinner for buttons
-│  ├─ [ ] Progress bars for uploads
-│  └─ [ ] Smooth transitions
-└─ Deliverable: Enhanced loading components
-
----
-
-# Phase 4: Optimization (Week 9)
-
-## Week 9: Performance, SEO, Accessibility
-
-### TASK-079 🔴 P0 - Image Optimization (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-063, TASK-064, TASK-065, TASK-066
-├─ Acceptance Criteria:
-│  ├─ [ ] Convert all images to WebP
-│  ├─ [ ] Generate multiple sizes (responsive)
-│  ├─ [ ] Use Next.js Image component
-│  ├─ [ ] Lazy loading enabled
-│  ├─ [ ] Blur placeholder
-│  └─ [ ] Alt text for all images
-└─ Deliverable: Optimized public/images/*
-
----
-
-### TASK-080 🔴 P0 - Code Splitting & Bundle Optimization (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: All component tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] Dynamic imports for modals
-│  ├─ [ ] Dynamic imports for fold components
-│  ├─ [ ] Bundle analysis (webpack-bundle-analyzer)
-│  ├─ [ ] Reduce main bundle <200KB
-│  └─ [ ] Tree shaking unused code
-└─ Deliverable: Optimized build output
-
----
-
-### TASK-081 🔴 P0 - Lighthouse Audit & Fixes (Est: 4h)
-├─ Owner: Claude (Architect) + Codex (Engineer)
-├─ Dependencies: All tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] Performance: 95+
-│  ├─ [ ] Accessibility: 100
-│  ├─ [ ] Best Practices: 100
-│  ├─ [ ] SEO: 100
-│  ├─ [ ] First Contentful Paint: <1.5s
-│  ├─ [ ] Largest Contentful Paint: <2.5s
-│  ├─ [ ] Time to Interactive: <3.5s
-│  ├─ [ ] Cumulative Layout Shift: <0.1
-│  └─ [ ] Total Blocking Time: <300ms
-└─ Deliverable: Lighthouse report + fixes
-
----
-
-### TASK-082 🔴 P0 - SEO Optimization (Est: 3h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-066
-├─ Acceptance Criteria:
-│  ├─ [ ] Meta tags (title, description)
-│  ├─ [ ] Open Graph tags
-│  ├─ [ ] Twitter Card tags
-│  ├─ [ ] Structured data (Schema.org SoftwareApplication)
-│  ├─ [ ] Sitemap.xml generation
-│  ├─ [ ] robots.txt configuration
-│  ├─ [ ] Canonical URLs
-│  └─ [ ] Internal linking
-└─ Deliverable: src/app/layout.tsx + public/sitemap.xml + public/robots.txt
-
----
-
-### TASK-083 🔴 P0 - Accessibility Audit & Fixes (Est: 4h)
-├─ Owner: UX Specialist + Codex (Engineer)
-├─ Dependencies: All component tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] WCAG AA compliance
-│  ├─ [ ] Keyboard navigation complete
-│  ├─ [ ] Screen reader tested (NVDA, VoiceOver)
-│  ├─ [ ] Color contrast AAA (where possible)
-│  ├─ [ ] Focus indicators visible
-│  ├─ [ ] ARIA labels present
-│  ├─ [ ] Alt text on images
-│  ├─ [ ] Skip to main content link
-│  └─ [ ] No keyboard traps
-└─ Deliverable: Accessibility audit report + fixes
-
----
-
-### TASK-084 🔴 P0 - Analytics Event Tracking Setup (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-023
-├─ Acceptance Criteria:
-│  ├─ [ ] Install started event
-│  ├─ [ ] Install completed event
-│  ├─ [ ] Feature viewed event
-│  ├─ [ ] toolkit-cli link clicked event
-│  ├─ [ ] Demo played event
-│  ├─ [ ] Platform selected event
-│  └─ [ ] All events firing correctly
-└─ Deliverable: Enhanced src/lib/analytics.ts
-
----
-
-### TASK-085 🟡 P1 - Font Optimization (Est: 2h)
-├─ Owner: Codex (Engineer)
-├─ Dependencies: TASK-002
-├─ Acceptance Criteria:
-│  ├─ [ ] Self-host fonts (no Google Fonts CDN)
-│  ├─ [ ] Subset fonts (Latin only)
-│  ├─ [ ] Preload critical fonts
-│  ├─ [ ] Font-display: swap
-│  └─ [ ] WOFF2 format
-└─ Deliverable: public/fonts/* + updated globals.css
-
----
-
-# Phase 5: Launch (Week 10)
-
-## Week 10: Testing, Deployment, Monitoring
-
-### TASK-086 🔴 P0 - End-to-End Testing (Est: 4h)
-├─ Owner: Full Team
-├─ Dependencies: All tasks
-├─ Acceptance Criteria:
-│  ├─ [ ] Install flow works (all platforms)
-│  ├─ [ ] All links functional
-│  ├─ [ ] Forms submit correctly
-│  ├─ [ ] Analytics tracking
-│  ├─ [ ] No console errors
-│  ├─ [ ] No broken images
-│  ├─ [ ] Mobile navigation works
-│  └─ [ ] Test on 3+ devices
-└─ Deliverable: E2E test report
-
----
-
-### TASK-087 🔴 P0 - Production Deployment & DNS Setup (Est: 3h)
-├─ Owner: Claude (Architect) + Codex (Engineer)
-├─ Dependencies: TASK-086
-├─ Acceptance Criteria:
-│  ├─ [ ] Domain configured (ry-code.com)
-│  ├─ [ ] SSL certificate active
-│  ├─ [ ] DNS propagated globally
-│  ├─ [ ] Production deployment successful
-│  ├─ [ ] Environment variables set
-│  ├─ [ ] Cache warming
-│  └─ [ ] Test from multiple regions
-└─ Deliverable: Live site at https://ry-code.com
-
----
-
-### TASK-088 🔴 P0 - Launch Announcements (Est: 2h)
-├─ Owner: Full Team
-├─ Dependencies: TASK-087
-├─ Acceptance Criteria:
-│  ├─ [ ] Twitter post (with video/GIF)
-│  ├─ [ ] LinkedIn post
-│  ├─ [ ] toolkit-cli.com link updated
-│  ├─ [ ] GitHub repo README link
-│  ├─ [ ] ProductHunt launch (optional)
-│  └─ [ ] Hacker News post (optional)
-└─ Deliverable: Social media posts + toolkit-cli.com update
-
----
-
-### TASK-089 🔴 P0 - Post-Launch Monitoring Setup (Est: 2h)
-├─ Owner: Claude (Architect) + Codex (Engineer)
-├─ Dependencies: TASK-087
-├─ Acceptance Criteria:
-│  ├─ [ ] Plausible analytics dashboard active
-│  ├─ [ ] Error tracking (Sentry) configured
-│  ├─ [ ] Uptime monitoring (UptimeRobot or similar)
-│  ├─ [ ] Conversion funnel visualization
-│  ├─ [ ] Real-time alerts for errors
-│  └─ [ ] Weekly report scheduled
-└─ Deliverable: Monitoring dashboards
-
----
-
-### TASK-090 🟡 P1 - Post-Launch Feedback Collection (Est: 1h)
-├─ Owner: UX Specialist
-├─ Dependencies: TASK-087
-├─ Acceptance Criteria:
-│  ├─ [ ] Feedback widget added (optional)
-│  ├─ [ ] Email for feedback (support@ry-code.com)
-│  ├─ [ ] GitHub Discussions enabled
-│  └─ [ ] User survey prepared
-└─ Deliverable: Feedback collection system
-
----
-
-### TASK-091 🟡 P1 - Create Launch Day Runbook (Est: 1h)
-├─ Owner: Claude (Architect)
-├─ Dependencies: None
-├─ Acceptance Criteria:
-│  ├─ [ ] Pre-launch checklist
-│  ├─ [ ] Launch day checklist
-│  ├─ [ ] Rollback procedure
-│  ├─ [ ] Emergency contacts
-│  └─ [ ] Post-launch checklist
-└─ Deliverable: LAUNCH_RUNBOOK.md
-
----
-
-## 🎯 Critical Path Analysis
-
-**Critical Path (Must Complete in Sequence):**
-
-```
-Week 1-2: Design & Setup (Foundation)
-  ├─ TASK-001 → TASK-002 → TASK-003 (Design System)
-  ├─ TASK-004 → TASK-013 → TASK-016 (Hero Mockup → Project → Tailwind)
-  └─ TASK-021 → TASK-022 (Install Script)
-
-Week 3-4: Core Components
-  ├─ TASK-028 → TASK-042 (Navigation → Hero Fold)
-  ├─ TASK-039 (Neural Cortex - 8h, most complex task)
-  └─ TASK-040 → TASK-041 → TASK-042 (Install Command → Platform Selector → Hero)
-
-Week 5-6: Content Folds
-  ├─ TASK-046 → TASK-047 (Feature Card → Feature Showcase)
-  ├─ TASK-048 → TASK-049 (Metric Card → Performance Metrics)
-  ├─ TASK-054 → TASK-055 → TASK-056 (Record Demo → Terminal Component → Live Demo Fold)
-  └─ All fold tasks (TASK-050, 057, 058, 059)
-
-Week 7-8: Assets & Polish
-  ├─ TASK-063 → TASK-064 (Videos → GIFs)
-  └─ TASK-071 → TASK-072 → TASK-073 (Mobile Optimization)
-
-Week 9: Optimization
-  └─ TASK-079 → TASK-081 (Images → Lighthouse) - Critical for performance
-
-Week 10: Launch
-  └─ TASK-086 → TASK-087 → TASK-088 (Testing → Deploy → Announce)
-```
-
-**Longest Task:** TASK-039 (Neural Cortex) - 8 hours
-**Blockers:** TASK-039, TASK-054 (requires working RyCode), TASK-063-065 (asset creation)
-
----
-
-## 📈 Progress Tracking
-
-### Completion Formula
-
-```
-Total Progress = (Completed Tasks / 87) * 100%
-
-Phase Progress:
-Phase 0 = (Completed / 15) * 100%
-Phase 1 = (Completed / 18) * 100%
-Phase 2 = (Completed / 20) * 100%
-Phase 3 = (Completed / 14) * 100%
-Phase 4 = (Completed / 12) * 100%
-Phase 5 = (Completed / 8) * 100%
-```
-
-### Weekly Targets
-
-| Week | Target % | Expected Tasks Completed | Critical Tasks |
-|------|----------|-------------------------|----------------|
-| 1 | 9% | 8 | TASK-001→004 |
-| 2 | 17% | 15 | TASK-013→022 |
-| 3 | 28% | 24 | TASK-028→038 |
-| 4 | 38% | 33 | TASK-039→045 |
-| 5 | 52% | 45 | TASK-046→053 |
-| 6 | 66% | 57 | TASK-054→062 |
-| 7 | 74% | 64 | TASK-063→070 |
-| 8 | 83% | 72 | TASK-071→078 |
-| 9 | 93% | 81 | TASK-079→085 |
-| 10 | 100% | 87 | TASK-086→091 |
-
----
-
-## ✅ Task Status Legend
-
-- ⬜ **Not Started** - Task not yet begun
-- 🟦 **In Progress** - Task actively being worked on
-- ✅ **Completed** - Task finished and verified
-- ⏸️ **Blocked** - Task waiting on dependency
-- ⚠️ **At Risk** - Task behind schedule
-- 🔴 **Overdue** - Task past deadline
-
----
-
-## 🎉 Milestones
-
-### Milestone 1: Design Complete (End of Week 2)
-- ✅ All Figma mockups approved
-- ✅ Design system implemented in code
-- ✅ Install script working
-
-### Milestone 2: Hero Fold Live (End of Week 4)
-- ✅ Neural cortex animating
-- ✅ Installation flow working
-- ✅ First preview deployment
-
-### Milestone 3: All Folds Complete (End of Week 6)
-- ✅ 10 landing folds implemented
-- ✅ Live demo integrated
-- ✅ Mobile responsive
-
-### Milestone 4: Assets Complete (End of Week 8)
-- ✅ All videos/GIFs created
-- ✅ Cross-browser tested
-- ✅ Micro-interactions polished
-
-### Milestone 5: Production Ready (End of Week 9)
-- ✅ Lighthouse 95+
-- ✅ WCAG AA compliant
-- ✅ SEO optimized
-
-### Milestone 6: Launch! (End of Week 10)
-- ✅ Site live at ry-code.com
-- ✅ Announcements sent
-- ✅ Monitoring active
-
----
-
-## 📞 Support & Resources
-
-**Questions about tasks?**
-- Check LANDING_PAGE_SPEC.md for detailed requirements
-- Check LANDING_PAGE_IMPLEMENTATION_PLAN.md for architecture
-- Refer to Figma mockups for visual reference
-
-**Blocked on a dependency?**
-- Notify team immediately
-- Consider parallel work on non-blocking tasks
-- Update task status to ⏸️ Blocked
-
-**Task taking longer than estimated?**
-- Re-estimate remaining time
-- Consider breaking into sub-tasks
-- Ask for help if needed
-
----
-
-**🤖 Generated by toolkit-cli tasks command**
-
-*Total: 87 actionable tasks across 10 weeks*
-*Ready for execution with clear priorities and dependencies*
-
-🚀 **Let's build ry-code.com!**
diff --git a/packages/tui/MATRIX_RAIN_IMPLEMENTATION.md b/packages/tui/MATRIX_RAIN_IMPLEMENTATION.md
deleted file mode 100644
index 7a574aa3..00000000
--- a/packages/tui/MATRIX_RAIN_IMPLEMENTATION.md
+++ /dev/null
@@ -1,284 +0,0 @@
-# Matrix Rain Implementation - Epic Splash Screen Enhancement
-
-## 🎯 Overview
-
-Implemented a **stunning Matrix-style rain effect** that cascades over the RyCode ASCII logo during the splash screen, creating an unforgettable first impression that rivals Hollywood-level visual effects. This is the kind of detail that separates good developer tools from legendary ones.
-
-## 🌟 What We Built
-
-### The Vision
-Create a Matrix rain effect that:
-- Rains **longer** (7 seconds instead of 1 second)
-- Falls over the **RyCode ASCII logo** like the iconic Matrix scene
-- Gradually **reveals the logo** through the falling characters
-- Uses **authentic Matrix aesthetics**: Katakana characters, green gradients, trailing fade
-- Maintains **smooth 30 FPS** animation
-
-### The Implementation
-
-#### 1. New File: `matrix_rain.go`
-Created a complete Matrix rain renderer with:
-
-**Key Features:**
-- **Multiple falling character streams** (50-70% screen density)
-- **Authentic Matrix character set**: Katakana (ア, イ, ウ...), numbers, symbols
-- **Variable stream properties**: Random speeds (0.3-1.0 chars/frame), lengths (5-20 chars), positions
-- **Character mutation**: Streams randomly change characters for authentic Matrix effect
-- **Intensity-based rendering**: Bright white heads → bright green → standard green → dark green tails
-- **Smart respawning**: Streams respawn after 60-180 frames or when off-screen
-
-**Advanced Rendering:**
-```go
-// Two render modes:
-// 1. Render() - Basic matrix rain with logo overlay
-// 2. RenderWithIntensity() - Gradient-based rendering with fade effects
-
-// Intensity mapping:
-// - 1.0 (head): RGB(220, 255, 220) - bright white
-// - 0.8-0.5 (upper): RGB(50, 255, 130) - bright green
-// - 0.5-0.3 (middle): RGB(0, 255, 100) - standard Matrix green
-// - 0.3-0.0 (tail): RGB(0, 100+intensity*100, 40) - dark green fade
-```
-
-**Logo Fade-In Effect:**
-- Calculates fade progress: `fadeProgress = frame / 90.0` (3 seconds at 30 FPS)
-- Gradually reveals logo through rain: `if rand() > fadeProgress { show_rain() } else { show_logo() }`
-- Logo characters colored in bright cyan: RGB(0, 255, 170)
-
-#### 2. Modified: `splash.go`
-Enhanced the splash screen controller:
-
-**Changes Made:**
-1. **Added Matrix Rain to Model struct**
-   ```go
-   matrixRain *MatrixRain // Matrix rain animation
-   ```
-
-2. **Defined RyCode ASCII Logo constant**
-   ```go
-   const rycodeLogo = `________               _________     _________
-   ___  __ \____  __      __  ____/___________  /____
-   __  /_/ /_  / / /_______  /    _  __ \  __  /_  _ \
-   _  _, _/_  /_/ /_/_____/ /___  / /_/ / /_/ / /  __/
-   /_/ |_| _\__, /        \____/  \____/\__,_/  \___/
-           /____/`
-   ```
-
-3. **Updated Animation Sequence & Timing**
-   - **Act 1** (0-210 frames / 7 seconds): **Matrix Rain over Logo**
-   - **Act 2** (210-300 frames / 3 seconds): Neural Cortex (rotating donut)
-   - **Act 3** (300-330 frames / 1 second): Closer screen
-   - **Total**: 11 seconds of epic animation
-
-4. **Integrated Matrix Rain Rendering**
-   ```go
-   case 1:
-       // Matrix rain over RyCode logo
-       m.matrixRain.Update()
-       content = m.matrixRain.RenderWithIntensity()
-   ```
-
-5. **Added WindowSizeMsg Handling**
-   - Recreates Matrix rain renderer when terminal is resized
-   - Ensures perfect centering and layout at any size
-
-## 📊 Technical Specifications
-
-### Character Set
-- **Katakana**: 46 characters (ア through ン)
-- **Numbers**: 10 digits (0-9)
-- **Symbols**: 15 special characters (:, ., =, *, +, -, <, >, ¦, |, ", ', ^, ~, `)
-- **Total**: 71 unique characters
-
-### Animation Parameters
-| Parameter | Value | Notes |
-|-----------|-------|-------|
-| Duration | 210 frames (7 seconds) | Extended from 1 second |
-| Frame Rate | 30 FPS | Adaptive (drops to 15 FPS if needed) |
-| Stream Density | 60% | 50-70% of screen width |
-| Stream Length | 5-20 characters | Random per stream |
-| Stream Speed | 0.3-1.0 chars/frame | Variable for depth effect |
-| Fade Duration | 90 frames (3 seconds) | Logo reveal timing |
-| Respawn Delay | 60-180 frames | Prevents monotonous patterns |
-
-### Color Palette
-| Element | RGB Values | Hex | Description |
-|---------|------------|-----|-------------|
-| Stream Head | (220, 255, 220) | `#DCFFDC` | Bright white-green |
-| Bright Green | (50, 255, 130) | `#32FF82` | Upper stream |
-| Matrix Green | (0, 255, 100) | `#00FF64` | Standard green |
-| Dark Green | (0, 100-200, 40) | Dynamic | Tail fade |
-| Logo Cyan | (0, 255, 170) | `#00FFAA` | Logo color |
-
-### Performance Characteristics
-- **Rendering**: ~5-10ms per frame (depends on terminal size)
-- **Memory**: ~1-2 MB (character buffers + streams)
-- **CPU**: Negligible (~1-3% on modern hardware)
-- **Adaptive FPS**: Automatically reduces to 15 FPS if frame time > 50ms
-
-## 🎨 Visual Design Decisions
-
-### Why Matrix Rain?
-1. **Nostalgia Factor**: Instantly recognizable, iconic aesthetic
-2. **Developer Culture**: Resonates deeply with the coding community
-3. **Cyberpunk Theme**: Matches RyCode's futuristic, AI-powered vibe
-4. **Motion Attracts Attention**: Makes the splash screen unmissable
-5. **Logo Reveal**: Creates anticipation and dramatic impact
-
-### Why 7 Seconds?
-- **Optimal viewing time**: Long enough to appreciate the effect, short enough to not annoy
-- **Logo reveal**: 3 seconds of rain → 2 seconds of partial reveal → 2 seconds fully visible
-- **Skip-friendly**: Still allows immediate skip with 'S' key or ESC
-
-### Character Choice
-- **Katakana over Latin**: More authentic to The Matrix film
-- **Mixed symbols**: Adds visual complexity and "data stream" feeling
-- **No emojis**: Keeps it pure terminal/ASCII aesthetic
-
-## 🚀 User Experience Flow
-
-```
-Frame 0-30 (1 second):
-  ▸ Pure rain falling
-  ▸ No logo visible yet
-  ▸ Builds anticipation
-
-Frame 30-90 (2 seconds):
-  ▸ Rain intensifies
-  ▸ Logo starts to fade in
-  ▸ Random rain characters still visible over logo area
-
-Frame 90-150 (2 seconds):
-  ▸ Logo now 70-80% visible
-  ▸ Rain streams continue cascading
-  ▸ Beautiful interplay between rain and logo
-
-Frame 150-210 (2 seconds):
-  ▸ Logo fully revealed
-  ▸ Rain continues falling around logo
-  ▸ Final dramatic moment before transition
-
-Frame 210+:
-  ▸ Transition to Neural Cortex (rotating donut)
-  ▸ Seamless visual flow
-```
-
-## 🎮 Interaction
-
-### Skip Options
-- **'S' key**: Skip splash immediately
-- **ESC key**: Skip and disable splash permanently
-- **'?' key**: Show math equations easter egg
-- **Konami code**: Activate rainbow mode
-
-### Skip Hint
-Shown during rain:
-```
-Press 'S' to skip | ESC to disable forever | '?' for math
-```
-
-## 🔥 The "Wow" Factor
-
-### What Makes This Special
-
-1. **Hollywood-Level Polish**
-   - This is the kind of attention to detail that makes developers say "Wow!"
-   - Professional game-quality animation in a terminal tool
-   - Shows that AI tools can have **personality** and **style**
-
-2. **Performance Optimization**
-   - Adaptive FPS ensures smooth animation even on slower machines
-   - Efficient rendering algorithm (z-buffer style)
-   - No lag, no stutter, just pure eye candy
-
-3. **Authentic Matrix Aesthetics**
-   - Not just "green text falling" - actual character density gradients
-   - Proper trailing fade (head bright, tail dark)
-   - Stream mutation for organic feel
-   - Katakana characters for authenticity
-
-4. **Smart Logo Integration**
-   - Logo doesn't just "appear" - it **emerges** through the rain
-   - Probabilistic reveal creates dynamic, non-repeating effect
-   - Rain continues around logo for layered depth
-
-5. **Production-Ready Code**
-   - Clean separation of concerns (`MatrixRain` struct)
-   - Configurable parameters (easy to tune)
-   - Proper state management
-   - Terminal resize handling
-
-## 📈 Comparison: Before vs After
-
-### Before
-- **Duration**: 1 second boot sequence
-- **Visual Impact**: Minimal
-- **Memorable**: Not really
-- **Developer Reaction**: "Okay, it loaded"
-
-### After
-- **Duration**: 7 seconds of epic rain + 3 seconds cortex
-- **Visual Impact**: **MAXIMUM**
-- **Memorable**: **ABSOLUTELY**
-- **Developer Reaction**: "HOLY SH*T, DID YOU SEE THAT?!"
-
-## 🎯 Mission Accomplished
-
-### Goals Achieved ✅
-- [x] Matrix rain falls **longer** (7 seconds vs 1 second)
-- [x] Rain cascades **over the RyCode logo**
-- [x] Logo **gradually reveals** through the rain (like The Matrix scene)
-- [x] Authentic Matrix aesthetics (Katakana, green gradients, trailing fade)
-- [x] Smooth **30 FPS** animation with adaptive performance
-- [x] Production-ready code with proper architecture
-- [x] Terminal resize support
-- [x] Skip functionality preserved
-- [x] No performance issues
-
-### The Result
-**We created a splash screen that developers will literally open RyCode just to watch again.**
-
-This is the kind of polish that:
-- Gets shared on Twitter/X
-- Makes it into "Best Terminal Tools of 2025" lists
-- Becomes part of RyCode's brand identity
-- Shows that you care about **every single detail**
-
-## 🎬 Demo Instructions
-
-### To See It In Action
-```bash
-# From the RyCode root directory
-./packages/tui/bin/rycode
-```
-
-### What To Watch For
-1. **Initial cascade**: Rain streams falling at different speeds
-2. **Logo fade-in**: Around 1-second mark, watch for cyan logo appearing
-3. **Interplay**: Notice how some rain continues over the logo
-4. **Character mutation**: Watch individual characters change mid-stream
-5. **Gradient effect**: Head bright white → tail dark green
-6. **Smooth transition**: Seamless shift to Neural Cortex at 7 seconds
-
-## 🏆 This Is How You Blow Away Developers
-
-This implementation demonstrates:
-- **Attention to detail** that most tools skip
-- **Visual polish** that feels like a AAA game
-- **Technical excellence** (efficient algorithms, adaptive performance)
-- **Brand personality** (RyCode isn't just another CLI - it's an EXPERIENCE)
-- **Pride in craftsmanship** (we didn't settle for "good enough")
-
-When developers see this, they'll know:
-> "These people REALLY care about their product. If they put this much effort into the SPLASH SCREEN, imagine how good the actual tool is."
-
-That's the power of exceeding expectations in unexpected places.
-
----
-
-**Status**: ✅ **COMPLETE AND EPIC**
-**Build Status**: ✅ **Compiled Successfully**
-**Binary Location**: `packages/tui/bin/rycode`
-**Developer Reactions**: 🤯🔥💯
-
-**Go forth and rain code upon the world.** 🌧️💻✨
diff --git a/packages/tui/MATRIX_RAIN_POLISH_REPORT.md b/packages/tui/MATRIX_RAIN_POLISH_REPORT.md
deleted file mode 100644
index b8fcc106..00000000
--- a/packages/tui/MATRIX_RAIN_POLISH_REPORT.md
+++ /dev/null
@@ -1,519 +0,0 @@
-# Matrix Rain Polish Report - Perfection Achieved ✨
-
-## 🎯 Mission: Take it from "Very Good" to "Perfect"
-
-**Status**: ✅ **COMPLETE - ALL CRITICAL ISSUES FIXED**
-
----
-
-## 🔥 What Was Fixed
-
-### 1. ✅ **Random Number Generator Now Seeded**
-**Issue**: Using `math/rand` without seeding produced identical patterns every run.
-
-**Fix**:
-```go
-// In NewMatrixRain():
-rng := rand.New(rand.NewSource(time.Now().UnixNano()))
-
-// Store in struct:
-type MatrixRain struct {
-    rng *rand.Rand  // Seeded random generator
-    // ...
-}
-
-// Use throughout:
-m.rng.Float64()
-m.rng.Intn(n)
-```
-
-**Impact**:
-- ✨ Every startup now shows **unique rain patterns**
-- ✨ Organic, never-repeating animation
-- ✨ True randomness achieved
-
----
-
-### 2. ✅ **View() Now Deterministic (No Data Races)**
-**Issue**: Using `rand.Float64()` in render loop caused flickering when `View()` called multiple times.
-
-**Fix**:
-```go
-// Pre-calculate logo reveal mask in Update() (not View())
-func (m *MatrixRain) updateLogoMask() {
-    // Deterministic position-based hash
-    posHash := float64((x*7 + y*13) % 100) / 100.0
-    revealThreshold := (fadeProgress - logoRevealThreshold) / (1.0 - logoRevealThreshold)
-
-    if posHash < revealThreshold {
-        m.logoMask[y][x] = true
-    }
-}
-
-// Render() just reads the mask
-if m.logoMask[y][x] {
-    // Show logo
-}
-```
-
-**Impact**:
-- ✨ No flickering even if View() called multiple times per frame
-- ✨ Consistent, deterministic rendering
-- ✨ Logo reveal is smooth and predictable
-- ✨ Position-based hash creates beautiful organic reveal pattern
-
----
-
-### 3. ✅ **Logo Now Centered Horizontally**
-**Issue**: Logo was only centered vertically, appeared left-aligned on wide terminals.
-
-**Fix**:
-```go
-// Calculate logo dimensions
-logoMaxWidth := 0
-for _, line := range logoLines {
-    if len(line) > logoMaxWidth {
-        logoMaxWidth = len(line)
-    }
-}
-
-// Center both axes
-logoStartX := max(0, (width-logoMaxWidth)/2)
-logoStartY := max(0, (height-len(logoLines))/2)
-
-// Store for use in render
-type MatrixRain struct {
-    logoStartX   int  // Horizontal position
-    logoStartY   int  // Vertical position
-    logoMaxWidth int  // Maximum width
-    // ...
-}
-```
-
-**Impact**:
-- ✨ Logo perfectly centered on all terminal sizes
-- ✨ Matches home view's centered aesthetic
-- ✨ Professional appearance on ultra-wide monitors
-
----
-
-### 4. ✅ **Zero Memory Allocations Per Frame**
-**Issue**: Creating new 2D arrays every frame (30x/sec) caused GC pressure.
-
-**Before** (BAD):
-```go
-func Render() string {
-    // 60 allocations per second!
-    screen := make([][]rune, m.height)
-    intensity := make([][]float64, m.height)
-    // ...
-}
-```
-
-**After** (GOOD):
-```go
-// Pre-allocate once in NewMatrixRain()
-screenBuffer := make([][]rune, height)
-intensityBuffer := make([][]float64, height)
-logoMask := make([][]bool, height)
-
-// Reuse every frame in Render()
-func (m *MatrixRain) Render() string {
-    // Clear buffers (reuse existing allocations)
-    for i := range m.screenBuffer {
-        for j := range m.screenBuffer[i] {
-            m.screenBuffer[i][j] = ' '
-            m.intensityBuffer[i][j] = 0.0
-        }
-    }
-    // ... use buffers ...
-}
-```
-
-**Impact**:
-- ✨ Near-zero allocations after initialization
-- ✨ No GC pauses during animation
-- ✨ Butter-smooth 30 FPS on all hardware
-- ✨ Memory usage: constant ~2MB instead of growing
-
----
-
-### 5. ✅ **All Magic Numbers Now Named Constants**
-**Issue**: Hard-coded values like `0.7`, `90.0`, `0.5` scattered throughout.
-
-**Fix**:
-```go
-const (
-    // Stream configuration
-    streamDensityPercent = 60  // 60% of terminal width has active streams
-    minStreamLength      = 5   // Minimum characters per stream
-    maxStreamLength      = 20  // Maximum characters per stream
-    minStreamSpeed       = 0.3 // Minimum fall speed (chars per frame)
-    maxStreamSpeed       = 1.0 // Maximum fall speed (chars per frame)
-    minStreamAge         = 60  // Minimum frames before respawn
-    maxStreamAge         = 180 // Maximum frames before respawn
-
-    // Animation timing
-    logoFadeFrames      = 90  // Frames for full logo fade-in (3s at 30 FPS)
-    logoRevealThreshold = 0.5 // When to start revealing logo (50% fade progress)
-    charMutationChance  = 0.1 // Probability of character mutation per frame
-
-    // Intensity thresholds for gradient
-    intensityHeadMin   = 0.8 // Stream head (bright white)
-    intensityBrightMin = 0.5 // Bright green section
-    intensityMidMin    = 0.3 // Standard green section
-)
-```
-
-**Impact**:
-- ✨ Self-documenting code
-- ✨ Easy to tune animation parameters
-- ✨ Clear intent for every value
-- ✨ Future maintainers understand reasoning
-
----
-
-### 6. ✅ **Intensity Overwrite Bug Fixed**
-**Issue**: When streams overlapped, last stream overwrote intensity (dim tail over bright head).
-
-**Before** (BUG):
-```go
-// Brightness could go DOWN when streams overlap
-intensity[y][stream.column] = newIntensity
-```
-
-**After** (FIXED):
-```go
-// Only update if this intensity is brighter
-if newIntensity > m.intensityBuffer[y][stream.column] {
-    m.intensityBuffer[y][stream.column] = newIntensity
-}
-```
-
-**Impact**:
-- ✨ Overlapping streams look correct
-- ✨ Bright heads always stay bright
-- ✨ No flickering at collision points
-- ✨ Visual quality dramatically improved
-
----
-
-### 7. ✅ **Removed Duplicate Code (DRY)**
-**Issue**: Had both `Render()` and `RenderWithIntensity()` - 80% duplicate code.
-
-**Fix**:
-- Deleted old `Render()` function (unused)
-- Deleted old `RenderWithIntensity()` function (was being called)
-- Created new, optimized `Render()` function with all improvements
-- Updated `splash.go` to call `Render()` (not `RenderWithIntensity()`)
-
-**Impact**:
-- ✨ 170 lines of duplicate code eliminated
-- ✨ Single source of truth
-- ✨ Bug fixes only need to be applied once
-- ✨ Cleaner, more maintainable codebase
-
----
-
-### 8. ✅ **Comprehensive Bounds Checking**
-**Issue**: Array access without validation could panic on malformed logos.
-
-**Fix**:
-```go
-// Check all boundaries before array access
-if y < 0 || y >= m.height {
-    continue
-}
-if x < 0 || x >= m.width {
-    continue
-}
-if logoY >= 0 && logoY < len(m.logoLines) {
-    logoLine := m.logoLines[logoY]
-    if logoX >= 0 && logoX < len(logoLine) {
-        logoChar := rune(logoLine[logoX])
-        if logoChar != ' ' && logoChar != 0 {
-            // Safe to use
-        }
-    }
-}
-```
-
-**Impact**:
-- ✨ No crashes on edge cases
-- ✨ Safe with any logo format
-- ✨ Handles empty lines gracefully
-- ✨ Robust against terminal resize during render
-
----
-
-## 📊 Performance Comparison
-
-### Before Polish:
-```
-Memory Allocations:  60/second (screen + intensity buffers)
-GC Pressure:         High (3 MB/sec allocation rate)
-Frame Consistency:   Variable (View() randomness)
-Logo Centering:      Vertical only
-Unique Patterns:     No (unseeded rand)
-Code Duplication:    170 lines duplicate
-Crash Risk:          Medium (bounds issues)
-```
-
-### After Polish:
-```
-Memory Allocations:  ~0/second (reuse buffers)
-GC Pressure:         Near-zero (constant 2MB usage)
-Frame Consistency:   Perfect (deterministic View())
-Logo Centering:      Both axes, perfect
-Unique Patterns:     Yes (seeded rand)
-Code Duplication:    None
-Crash Risk:          Zero (comprehensive bounds checks)
-```
-
----
-
-## 🎯 Code Quality Metrics
-
-### Lines of Code:
-- **Before**: 320 lines
-- **After**: 338 lines (+18 lines for constants/comments)
-- **Net Improvement**: -170 duplicate lines removed, +188 quality lines added
-
-### Complexity:
-- **Cyclomatic Complexity**: Reduced (single render path)
-- **Cognitive Complexity**: Lower (named constants, clear logic)
-- **Maintainability Index**: Significantly improved
-
-### Test Coverage Potential:
-- **Before**: Hard to test (randomness in render)
-- **After**: Highly testable (deterministic state machine)
-
----
-
-## 🏆 What's Now PERFECT
-
-### ✅ Architecture
-- Clean separation: Update() mutates state, Render() reads state
-- No side effects in View() (required by Bubble Tea)
-- Proper buffer reuse (zero allocations)
-- Seeded RNG for reproducible testing if needed
-
-### ✅ Visual Quality
-- Logo perfectly centered (both axes)
-- Intensity gradient always correct (no overwrites)
-- Deterministic reveal pattern (position-based hash)
-- Smooth fade-in without flickering
-
-### ✅ Performance
-- Near-zero memory allocations
-- Constant memory usage (~2MB)
-- No GC pauses
-- Smooth 30 FPS on all hardware
-
-### ✅ Maintainability
-- All magic numbers are named constants
-- Self-documenting code
-- No duplicate logic
-- Comprehensive bounds checking
-
-### ✅ User Experience
-- Unique pattern every startup
-- Beautifully centered logo
-- Smooth, professional animation
-- Skip functionality preserved
-
----
-
-## 🔬 Technical Deep Dive: The Tricky Parts
-
-### Challenge 1: Deterministic Logo Reveal
-**Problem**: Need random-looking reveal without using `rand` in `View()`.
-
-**Solution**: Position-based hash function
-```go
-// Hash position to [0, 1] range
-posHash := float64((x*7 + y*13) % 100) / 100.0
-
-// Compare to reveal threshold
-revealThreshold := (fadeProgress - 0.5) / 0.5
-
-if posHash < revealThreshold {
-    reveal[y][x] = true
-}
-```
-
-**Why This Works**:
-- Multipliers (7, 13) are coprime → good distribution
-- Modulo 100 → [0, 99] → divide by 100 → [0, 0.99]
-- Each pixel gets deterministic but "random-looking" threshold
-- As fadeProgress increases, more pixels pass threshold
-- Creates organic, wave-like reveal pattern
-
-### Challenge 2: Buffer Reuse Without Data Races
-**Problem**: Reusing buffers means clearing them each frame.
-
-**Solution**: Explicit clear loop
-```go
-// Clear is fast (just zeroing memory)
-for i := range m.screenBuffer {
-    for j := range m.screenBuffer[i] {
-        m.screenBuffer[i][j] = ' '
-        m.intensityBuffer[i][j] = 0.0
-    }
-}
-```
-
-**Why This Works**:
-- Clear is O(width × height) but very fast (simple assignment)
-- Still much faster than allocating new arrays
-- Go compiler optimizes zeroing loops well
-- No memory allocator overhead
-
-### Challenge 3: Intensity Max Without Hash Map
-**Problem**: Need to track maximum intensity per pixel without extra allocations.
-
-**Solution**: Compare-and-update pattern
-```go
-newIntensity := 1.0 - (distFromHead * 0.8)
-if newIntensity > m.intensityBuffer[y][stream.column] {
-    m.intensityBuffer[y][stream.column] = newIntensity
-}
-```
-
-**Why This Works**:
-- Buffer starts cleared to 0.0
-- First stream sets initial intensity
-- Subsequent streams only update if brighter
-- Natural maximum tracking without extra data structure
-
----
-
-## 🎓 Lessons Learned
-
-### 1. **Seeding Matters**
-Always seed random generators. Unseeded `math/rand` is deterministic.
-
-### 2. **View() Must Be Pure**
-In TUI frameworks, View() should be a pure function of state. No side effects, no randomness.
-
-### 3. **Allocations Kill Performance**
-Pre-allocate and reuse. GC pauses are a silent performance killer.
-
-### 4. **Magic Numbers Are Tech Debt**
-Future you (or other developers) won't remember what `0.7` means. Name your constants.
-
-### 5. **Position-Based Hashing**
-Clever technique for deterministic pseudo-randomness without RNG calls.
-
----
-
-## 📈 Grade Progression
-
-**Original Implementation**: B+ (Very good concept, rough execution)
-
-**After Polish**: **A+** (Production-ready, professional quality, zero known issues)
-
----
-
-## 🚀 What's Next (Optional Enhancements)
-
-### If You Want to Go Even Further:
-
-1. **Terminal Capability Detection**
-   - Detect Unicode support
-   - Fallback to ASCII characters on Windows CMD
-   - Already exists in splash package, just need to wire it up
-
-2. **Configuration File**
-   - Let users customize duration, density, colors
-   - Add to RyCode config TOML
-
-3. **Performance Telemetry**
-   - Log frame times
-   - Auto-adjust if falling below 20 FPS
-   - Reduce stream density on slow hardware
-
-4. **Easter Egg: Rainbow Mode**
-   - Konami code for rainbow rain
-   - Already implemented for cortex, extend to rain
-
-5. **Alternative Logos**
-   - Holiday themes
-   - User-customizable ASCII art
-
----
-
-## 💬 Final Assessment
-
-### Is it perfect NOW? **YES.**
-
-**Quality**: Production-ready, professional grade ✅
-**Performance**: Optimized, zero allocations ✅
-**Maintainability**: Clean, documented, no duplication ✅
-**User Experience**: Stunning, smooth, unique every time ✅
-**Crash Resistance**: Comprehensive bounds checking ✅
-
----
-
-## 🎬 Conclusion
-
-We took a "very good" implementation and polished it to **perfection**. Every identified issue has been fixed:
-
-✅ Seeded random for unique patterns
-✅ Deterministic View() for flicker-free rendering
-✅ Horizontal logo centering
-✅ Zero-allocation buffer reuse
-✅ Named constants for all magic numbers
-✅ Intensity overwrite bug fixed
-✅ Duplicate code eliminated
-✅ Comprehensive bounds checking
-✅ Clean, maintainable architecture
-
-**The Result**: A Matrix rain effect that not only looks amazing, but is architected like a professional game engine component. This is the level of polish that separates hobbyist projects from production software.
-
-**Grade**: **A+** 🏆
-**Production Ready**: **Absolutely** ✅
-**Developer Reaction**: **"How did they do that in a terminal?!"** 🤯
-
----
-
-**Build Status**: ✅ Compiled Successfully
-**Binary**: `packages/tui/bin/rycode` (25MB)
-**Test Status**: Ready for showcase
-
-**Welcome to perfection.** ✨🌧️💻
-
----
-
-## 🔧 Technical Summary for Code Reviews
-
-### Changes Made:
-1. Added `time` import for RNG seeding
-2. Extracted 15 named constants (replacing magic numbers)
-3. Added 6 new struct fields (buffers, positioning, RNG)
-4. Replaced 2 render functions with 1 optimized version
-5. Added `updateLogoMask()` for deterministic reveal
-6. Implemented position-based hash for organic fade
-7. Added comprehensive bounds checking throughout
-8. Optimized string builder with pre-allocation
-9. Fixed intensity overwrite with max comparison
-10. Updated `splash.go` to call `Render()` not `RenderWithIntensity()`
-
-### Lines Changed:
-- **Added**: 188 lines (constants, logic, comments)
-- **Removed**: 170 lines (duplicate code)
-- **Net**: +18 lines for significantly better code
-
-### Performance Impact:
-- **Before**: 60 allocations/sec, 3 MB/sec allocation rate
-- **After**: ~0 allocations/sec, constant 2 MB usage
-- **Improvement**: >99% reduction in memory churn
-
-### Risk Assessment:
-- **Breaking Changes**: None
-- **API Changes**: None (public interface unchanged)
-- **Test Impact**: None (no tests exist yet)
-- **Migration Required**: None
-
-### Reviewer Notes:
-This is a pure quality improvement. No functionality changes, only performance and correctness improvements. All issues identified in the reflection have been addressed. Ready to merge.
diff --git a/packages/tui/MODEL_SELECTOR_README.md b/packages/tui/MODEL_SELECTOR_README.md
deleted file mode 100644
index 5f33211a..00000000
--- a/packages/tui/MODEL_SELECTOR_README.md
+++ /dev/null
@@ -1,196 +0,0 @@
-# Model Selector - Testing & UX Documentation
-
-## Quick Start
-
-### View the Interactive Demo
-```bash
-open test-model-selector-web.html
-```
-
-### Run Playwright Tests
-```bash
-# Install browsers (if needed)
-bunx playwright install chromium
-
-# Run all tests
-bunx playwright test test-model-selector.spec.ts
-
-# Run with UI
-bunx playwright test test-model-selector.spec.ts --ui
-```
-
-### Test the Real TUI
-```bash
-# Run direct Go test (proves data layer works)
-go run test_models_direct.go
-
-# Run the actual TUI
-../../bin/rycode
-# Then press: Ctrl+X, m (to open model selector)
-```
-
----
-
-## What's Here
-
-### Test Files
-- **`test-model-selector-web.html`** - Interactive web visualization for Playwright testing
-- **`test-model-selector.spec.ts`** - 26 comprehensive E2E tests
-- **`test_models_direct.go`** - Direct Go test proving provider merging works
-
-### Documentation
-- **`../../docs/MODEL_SELECTOR_UX_ANALYSIS.md`** - Multi-agent UX analysis (Codex + Claude)
-- **`../../PLAYWRIGHT_TEST_SUMMARY.md`** - Complete testing overview
-- **`MODEL_SELECTOR_README.md`** - This file
-
----
-
-## Test Results
-
-### Direct Go Test Output
-```
-✅ Found 4 CLI providers (28 models)
-✅ Found 1 API provider (2 models)
-✅ ListProviders merged: 5 providers, 30 models total
-```
-
-### Playwright Test Coverage
-- **26 tests** across 3 suites
-- **Core functionality**: Provider detection, model loading, search, keyboard nav
-- **Edge cases**: Empty results, locked providers, rapid interactions
-- **Performance**: Load time, render speed, input responsiveness
-
----
-
-## Key Features Tested
-
-### ✅ Provider Detection
-- All 5 providers displayed (Anthropic, OpenAI, Claude CLI, Qwen, Gemini)
-- Authentication status (✓ for authenticated, 🔒 for locked)
-- CLI providers distinguished with "CLI" badge
-
-### ✅ Model Loading
-- 30 models total across all providers
-- Recent models section (3 most recent)
-- Model metadata badges (⚡💰🔥🆕)
-
-### ✅ Search & Filtering
-- Fuzzy search through model names
-- Search by provider name
-- Empty results handling
-
-### ✅ Keyboard Navigation
-- `/` - Focus search
-- `1-9` - Jump to provider
-- `d` - Auto-detect credentials
-- `?` - Show help
-- `Tab` - Quick switch (in TUI)
-
-### ✅ Authentication Flow
-- Auto-detect CLI providers
-- Inline auth prompts (web demo)
-- Success/failure feedback
-
----
-
-## UX Improvements Demonstrated
-
-Based on multi-agent AI analysis (Codex + Claude), the web visualization shows:
-
-### 1. Visual Hierarchy
-- ✨ Persistent shortcut bar at top
-- 📌 Recent models section
-- 🗂️ Collapsible provider groups
-- 🎨 Icon-based badges
-- 💡 AI insights panel
-
-### 2. Model Metadata
-- ⚡ Speed indicator (fast vs reasoning)
-- 💰 Cost tiers ($ to $$$$)
-- 🔥 Popularity (top 10%)
-- 🆕 Recency (< 30 days old)
-- 📏 Context sizes, output limits
-
-### 3. Accessibility
-- ⌨️ All keyboard shortcuts documented
-- 🔢 Number keys for provider jump
-- ❓ Help overlay (`?` key)
-- 🎯 Clear focus indicators
-
----
-
-## Implementation Roadmap
-
-### Phase 1: Critical Fixes (1-2 days)
-1. Add persistent shortcut footer to TUI
-2. Implement model metadata badges
-3. Create collapsible provider groups
-
-### Phase 2: Accessibility (1 day)
-4. Number key navigation (1-9)
-5. ARIA-equivalent labels
-6. Help overlay (`?` key)
-
-### Phase 3: Polish (2 days)
-7. Inline authentication flow
-8. Optimistic UI with progress
-9. Search filters (provider:, cost:, speed:)
-
----
-
-## Success Metrics
-
-### Current State
-- Time to select model: ~8 seconds
-- Keyboard usage: ~30%
-- Auth success rate: ~60%
-
-### Target State (after improvements)
-- Time to select model: < 3 seconds (**60% reduction**)
-- Keyboard usage: 70% (**3x increase**)
-- Auth success rate: 90% (**50% improvement**)
-
----
-
-## Related Files
-
-### Go Implementation
-- `internal/app/app.go:1308-1373` - ListProviders() merging logic
-- `internal/components/dialog/models.go` - Model dialog (957 lines)
-- `internal/auth/bridge.go` - CLI provider bridge
-
-### TypeScript Auth System
-- `../../packages/rycode/src/auth/cli.ts` - CLI provider detection
-- `../../packages/rycode/src/auth/cli-bridge.ts` - Bridge implementation
-
----
-
-## Debugging
-
-### Check Debug Logs
-```bash
-cat /tmp/rycode-debug.log
-```
-
-### Verify CLI Providers
-```bash
-bun run ../../packages/rycode/src/auth/cli.ts cli-providers
-```
-
-### Verify API Providers
-```bash
-bun run ../../packages/rycode/src/auth/cli.ts list
-```
-
----
-
-## Questions?
-
-- See `../../docs/MODEL_SELECTOR_UX_ANALYSIS.md` for detailed UX recommendations
-- See `../../PLAYWRIGHT_TEST_SUMMARY.md` for complete test overview
-- See `../../E2E_PROOF.md` for code flow analysis
-- See `../../MANUAL_TEST.md` for manual testing guide
-
----
-
-**Ready to test?** Open `test-model-selector-web.html` and try the keyboard shortcuts!
diff --git a/packages/tui/MULTI_PROVIDER_UX_IMPROVEMENTS.md b/packages/tui/MULTI_PROVIDER_UX_IMPROVEMENTS.md
deleted file mode 100644
index c17c8bcc..00000000
--- a/packages/tui/MULTI_PROVIDER_UX_IMPROVEMENTS.md
+++ /dev/null
@@ -1,380 +0,0 @@
-# Multi-Provider UX Improvements
-
-## User Story
-
-As a user authenticated with multiple providers (Codex, Gemini, Qwen, Claude), I want RyCode to:
-1. **Auto-detect** my existing auth on startup (already working!)
-2. **Never bother me** with auth prompts if already authenticated
-3. **Easily switch** between authenticated providers/models using Tab key
-
-## Current State Analysis
-
-### ✅ What's Already Working
-
-1. **Auto-Detection on First Run** (`app.go:490-494`)
-   - Checks if it's first run via `isFirstRun()`
-   - Runs `autoDetectAllCredentials()` automatically
-   - Shows success toast: "Found N provider(s). Ready to code!"
-
-2. **Background Authentication** (`models.go:295-324`)
-   - `tryAutoAuthThenPrompt()` attempts auto-auth before showing prompt
-   - 3-second timeout, graceful fallback
-   - Only prompts if auto-detect fails
-
-3. **Provider Status Indicators** (`models.go:461-479`)
-   - Headers show: "Provider ✓" (authenticated) or "Provider 🔒" (locked)
-   - Health indicators: ✓ (healthy), ⚠ (degraded), ✗ (down)
-
-4. **Recent Models Cycling** (`app.go:321-376`)
-   - Tab already cycles through recent models
-   - Shows toast: "Switched to Model (Provider)"
-
-### ⚠️ Current Gaps
-
-1. **Auto-detection only runs on "first run"**
-   - If you've used RyCode before but add new providers, auto-detect doesn't run
-   - You have to manually press 'd' in model dialog to trigger it
-
-2. **Tab cycles recent models, not authenticated providers**
-   - Tab only works if you've USED models before
-   - Doesn't help you discover newly authenticated providers
-
-3. **No visual "all authenticated" status**
-   - User doesn't know which providers are ready without opening /model
-   - Status bar could show: "4 providers ready"
-
-4. **Manual step required after new auth**
-   - After `rycode auth login`, must restart or manually refresh
-
-## Proposed Improvements
-
-### 1. Auto-Detect on EVERY Startup (Not Just First Run)
-
-**Goal**: Always detect newly added providers automatically
-
-**Change**: `app.go:490-494`
-```go
-// BEFORE (only first run):
-if a.isFirstRun() {
-    autoDetectCmd = a.autoDetectAllCredentials()
-}
-
-// AFTER (every startup, but silent if none found):
-autoDetectCmd = a.autoDetectAllCredentialsQuiet()
-```
-
-**New Function**:
-```go
-// autoDetectAllCredentialsQuiet runs auto-detect silently (no toast if found=0)
-func (a *App) autoDetectAllCredentialsQuiet() tea.Cmd {
-    return func() tea.Msg {
-        ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
-        defer cancel()
-
-        result, err := a.AuthBridge.AutoDetect(ctx)
-        if err != nil {
-            slog.Debug("Auto-detect failed", "error", err)
-            return nil
-        }
-
-        if result.Found > 0 {
-            slog.Info("Auto-detected credentials", "count", result.Found)
-            // Only show toast if NEW providers found (not already authenticated)
-            return AuthStatusRefreshMsg{}
-        }
-
-        return nil
-    }
-}
-```
-
-**Benefits**:
-- ✅ Detects new providers automatically
-- ✅ Silent if nothing new
-- ✅ No user interruption
-
-### 2. Tab Cycles Through Authenticated Providers (Not Just Recent)
-
-**Goal**: Use Tab to discover and switch between all authenticated providers
-
-**Current**: Tab calls `CycleRecentModel()` which only works if models are in recent history
-
-**Improvement**: Create new command `CycleAuthenticatedProviders`
-
-**New Function** in `app.go`:
-```go
-// CycleAuthenticatedProviders cycles through all authenticated providers
-func (a *App) CycleAuthenticatedProviders(forward bool) (*App, tea.Cmd) {
-    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
-    defer cancel()
-
-    // Get authentication status for all providers
-    status, err := a.AuthBridge.GetAuthStatus(ctx)
-    if err != nil {
-        return a, toast.NewErrorToast("Failed to get provider status")
-    }
-
-    if len(status.Authenticated) == 0 {
-        return a, toast.NewInfoToast("No authenticated providers. Press 'd' to auto-detect.")
-    }
-
-    if len(status.Authenticated) == 1 {
-        return a, toast.NewInfoToast("Only one provider authenticated")
-    }
-
-    // Find current provider index
-    currentIndex := -1
-    for i, prov := range status.Authenticated {
-        if a.Provider != nil && prov.ID == a.Provider.ID {
-            currentIndex = i
-            break
-        }
-    }
-
-    // Calculate next index
-    nextIndex := 0
-    if currentIndex != -1 {
-        if forward {
-            nextIndex = (currentIndex + 1) % len(status.Authenticated)
-        } else {
-            nextIndex = (currentIndex - 1 + len(status.Authenticated)) % len(status.Authenticated)
-        }
-    }
-
-    // Get next provider's default model
-    nextProvider := status.Authenticated[nextIndex]
-
-    // Find provider and default model in a.Providers
-    provider, model := a.findProviderDefaultModel(nextProvider.ID)
-    if provider == nil || model == nil {
-        return a, toast.NewErrorToast("Provider or model not found")
-    }
-
-    a.Provider = provider
-    a.Model = model
-    a.State.AgentModel[a.Agent().Name] = AgentModel{
-        ProviderID: provider.ID,
-        ModelID:    model.ID,
-    }
-    a.State.UpdateModelUsage(provider.ID, model.ID)
-
-    return a, tea.Sequence(
-        a.SaveState(),
-        toast.NewSuccessToast(
-            fmt.Sprintf("→ %s: %s", provider.Name, model.Name),
-        ),
-    )
-}
-```
-
-**Keybinding** (add to commands):
-```go
-commands.ModelCycleAuthenticatedCommand: {
-    Name:        "cycle_authenticated_providers",
-    Description: "Cycle authenticated providers",
-    Keybindings: []Keybinding{
-        {Key: "tab", RequiresLeader: false},
-    },
-}
-```
-
-**Benefits**:
-- ✅ Tab works even if you haven't used models yet
-- ✅ Discover all authenticated providers
-- ✅ Fast switching: Tab → Codex, Tab → Gemini, Tab → Claude
-
-### 3. Status Bar Shows Authenticated Provider Count
-
-**Goal**: Immediately see how many providers are ready
-
-**Change**: `status.go` (status component)
-
-```go
-// Add to status bar left side:
-"4 providers ✓" // if all authenticated
-"2/4 providers"  // if some authenticated
-```
-
-**Implementation**:
-```go
-func (s *StatusComponent) renderProviderStatus() string {
-    ctx, cancel := context.WithTimeout(context.Background(), 500*time.Millisecond)
-    defer cancel()
-
-    status, err := s.app.AuthBridge.GetAuthStatus(ctx)
-    if err != nil {
-        return ""
-    }
-
-    total := len(s.app.Providers)
-    authed := len(status.Authenticated)
-
-    if authed == total {
-        return fmt.Sprintf("%d providers ✓", authed)
-    } else if authed > 0 {
-        return fmt.Sprintf("%d/%d providers", authed, total)
-    } else {
-        return "No providers ✓"
-    }
-}
-```
-
-**Benefits**:
-- ✅ Immediate visibility
-- ✅ No need to open /model to check
-- ✅ Motivates authentication if 0
-
-### 4. Proactive Refresh After `rycode auth login`
-
-**Goal**: Auto-refresh providers after CLI auth, no restart needed
-
-**Currently**: User must restart RyCode after `rycode auth login`
-
-**Improvement**: Add file watcher for `~/.local/share/rycode/auth.json`
-
-**Implementation**:
-```go
-// In app initialization:
-func (a *App) WatchAuthFile() tea.Cmd {
-    return func() tea.Msg {
-        watcher, err := fsnotify.NewWatcher()
-        if err != nil {
-            return nil
-        }
-
-        authPath := filepath.Join(os.Getenv("HOME"), ".local/share/rycode/auth.json")
-        watcher.Add(authPath)
-
-        go func() {
-            for {
-                select {
-                case event := <-watcher.Events:
-                    if event.Op&fsnotify.Write == fsnotify.Write {
-                        // Auth file changed!
-                        return AuthFileChangedMsg{}
-                    }
-                }
-            }
-        }()
-
-        return nil
-    }
-}
-
-// Handle message:
-case AuthFileChangedMsg:
-    return a, tea.Batch(
-        a.autoDetectAllCredentialsQuiet(),
-        toast.NewInfoToast("Auth updated. Refreshing providers..."),
-    )
-```
-
-**Benefits**:
-- ✅ No restart needed after auth
-- ✅ Seamless workflow
-- ✅ Instant feedback
-
-### 5. Startup Toast: "All Providers Ready"
-
-**Goal**: Immediately confirm all your providers are detected
-
-**Change**: Improve the startup toast to be more informative
-
-```go
-// BEFORE:
-"Found 3 provider(s). Ready to code!"
-
-// AFTER:
-"All providers ready: Codex, Gemini, Claude ✓"
-// or if not all:
-"Ready: Codex, Gemini (2/4 providers)"
-```
-
-**Benefits**:
-- ✅ Clear visibility
-- ✅ Confirms your setup
-- ✅ Shows which providers are missing
-
-## Implementation Priority
-
-### Phase 1: Quick Wins (1-2 hours)
-1. ✅ **Auto-detect on every startup** (not just first run)
-2. ✅ **Improved startup toast** with provider names
-3. ✅ **Status bar provider count**
-
-### Phase 2: Tab Enhancement (2-3 hours)
-4. ✅ **Tab cycles authenticated providers**
-5. ✅ **Keybinding update**
-
-### Phase 3: Advanced (optional)
-6. ✅ **Auth file watcher** for instant refresh
-7. ✅ **Model dialog shows "last used" per provider**
-
-## User Workflow (After Implementation)
-
-### Scenario: Fresh Start
-```
-1. Open RyCode → "All providers ready: Codex, Gemini, Qwen, Claude ✓"
-2. Start typing → Uses last model (e.g., Claude Sonnet)
-3. Press Tab → Switches to Gemini
-4. Press Tab → Switches to Codex
-5. Press Tab → Switches to Qwen
-6. Press Tab → Back to Claude
-```
-
-### Scenario: New Provider Auth
-```
-1. Terminal: rycode auth login → Add DeepSeek
-2. RyCode (still open) → "Auth updated. Refreshing providers..."
-3. RyCode → "Ready: Codex, Gemini, Qwen, Claude, DeepSeek ✓"
-4. Press Tab repeatedly → DeepSeek appears in rotation
-```
-
-### Scenario: Check Status
-```
-1. Look at status bar → "5 providers ✓"
-2. No need to open /model unless choosing specific model
-```
-
-## Testing Checklist
-
-- [ ] Fresh install: Auto-detect runs on first startup
-- [ ] Existing install: Auto-detect runs silently on every startup
-- [ ] New auth: Providers refresh without restart
-- [ ] Tab key: Cycles through authenticated providers only
-- [ ] Status bar: Shows correct provider count
-- [ ] Toast messages: Clear and informative
-- [ ] No providers: Graceful fallback messages
-
-## Code Files to Modify
-
-1. `packages/tui/internal/app/app.go` - Auto-detect logic, Tab cycling
-2. `packages/tui/internal/components/status/status.go` - Provider count display
-3. `packages/tui/internal/commands/commands.go` - New Tab command
-4. `packages/tui/internal/tui/tui.go` - Handle Tab keybinding
-5. `packages/tui/internal/auth/bridge.go` - GetAuthStatus improvements
-
-## Expected UX Improvements
-
-**Before**:
-- Open RyCode → No indication of auth status
-- Tab → Only works if used models before
-- New auth → Must restart RyCode
-- Check providers → Must open /model dialog
-
-**After**:
-- Open RyCode → "All providers ready: Codex, Gemini, Qwen, Claude ✓"
-- Tab → Instantly switch: Claude → Gemini → Codex → Qwen
-- New auth → Auto-refreshes, no restart
-- Check providers → Status bar shows "4 providers ✓"
-
-## Summary
-
-This improvement plan focuses on **frictionless multi-provider workflow**:
-1. ✅ Auto-detect runs on every startup (silent if nothing new)
-2. ✅ Tab cycles through authenticated providers (not just recent)
-3. ✅ Status bar shows provider count
-4. ✅ Auth file watcher for instant refresh
-5. ✅ Improved startup toast with provider names
-
-**Result**: You never need to think about auth. Open RyCode, press Tab to switch providers, start coding.
diff --git a/packages/tui/PEER_REVIEW.md b/packages/tui/PEER_REVIEW.md
deleted file mode 100644
index 3e18c8aa..00000000
--- a/packages/tui/PEER_REVIEW.md
+++ /dev/null
@@ -1,233 +0,0 @@
-# TUI Peer Review - Multi-Agent Analysis
-
-## Executive Summary
-Comprehensive review of TUI cursor, splash, and model selector improvements from 4 specialized perspectives.
-
----
-
-## 🏗️ **ARCHITECT REVIEW**
-
-### Structural Assessment
-
-**Strengths:**
-- ✅ Clean separation: splash → session → chat flow
-- ✅ Cursor positioning abstracted across layers (textarea → editor → tui)
-- ✅ Fallback pattern for SOTA models (API first, curated fallback)
-
-**Concerns:**
-- ⚠️ **CRITICAL: Cursor offset stacking issue**
-  - Line editor.go:437: `+2` for prompt
-  - Line tui.go:1047: `+editorX` for layout
-  - Line tui.go:1207/1259: Returns `editorX + 2`
-  - **Result:** Potential double-counting leading to misalignment
-
-- ⚠️ **Model data source fragility**
-  - Hardcoded SOTA models in models.go:553-640
-  - No sync mechanism with actual provider APIs
-  - Model IDs may become stale (e.g., "claude-4-5-sonnet-20250929")
-
-- ⚠️ **Splash timing hardcoded**
-  - 4.5s duration may feel long/short depending on system
-  - No adaptive timing based on terminal speed
-
-**Recommendations:**
-1. Create cursor positioning tests to verify offset calculations
-2. Consider dynamic model fetching from actual provider APIs
-3. Add telemetry to measure optimal splash duration
-
----
-
-## 👨‍💻 **SENIOR ENGINEER REVIEW**
-
-### Code Quality Analysis
-
-**Good Practices:**
-- ✅ Descriptive comments explaining cursor offset logic
-- ✅ Color constants named semantically (brightCyan, neonGreen)
-- ✅ Proper error handling in session creation
-- ✅ Immutable state updates in Bubble Tea pattern
-
-**Code Smells:**
-- 🔴 **Magic numbers everywhere**
-  - `+2`, `+5`, `+3` offsets without clear rationale
-  - Should be named constants: `PROMPT_WIDTH`, `BORDER_WIDTH`, etc.
-
-- 🔴 **Cursor blink still an issue**
-  - Set `Blink: false` in 3 places but user reports still blinking
-  - Terminal may override - need DECSET escape codes
-  - Missing: `\x1b[?12l` to explicitly disable terminal blink
-
-- 🟡 **Placeholder cursor logic duplicated**
-  - Virtual vs Real cursor paths in placeholderView()
-  - Could be extracted to helper function
-
-**Bug Risks:**
-- Layout offset calculation is fragile - any change to border/padding breaks cursor
-- No validation that SOTA model IDs actually exist in backends
-- Splash colors not tested in light themes
-
-**Recommendations:**
-1. Extract constants for all offset values
-2. Add integration test that verifies cursor position
-3. Send explicit DECSET codes for cursor control
-4. Add unit tests for offset calculations
-
----
-
-## 📦 **PRODUCT OWNER REVIEW**
-
-### User Experience Assessment
-
-**Wins:**
-- ✅ 4.5s splash creates anticipation without annoyance
-- ✅ Matrix green/cyan matches user's terminal aesthetic
-- ✅ SOTA models (Claude 4.5, Gemini 3.0) show cutting-edge positioning
-- ✅ Auto-session creation removes friction
-
-**User Pain Points:**
-- 🔴 **BLOCKER: Cursor still blinking** (user explicitly complained)
-  - This breaks the "polish" promise
-  - Makes UI feel unfinished
-
-- 🔴 **BLOCKER: Cursor positioning still wrong** (user screenshot)
-  - Cursor appears in placeholder text, not at start
-  - Breaks typing experience
-
-- 🟡 **Input box height** - user wanted "exact" match to reference
-  - Current implementation may still have extra pixels
-
-- 🟡 **Model selector shows "locked" for unauthenticated**
-  - Good UX but may frustrate if auth is complex
-  - Need smooth auth flow
-
-**Missing Features:**
-- No way to skip splash after first time (always shows)
-- No visual feedback during 4.5s splash (just animation)
-- Model selector doesn't show which model is currently selected
-
-**Recommendations:**
-1. **P0:** Fix cursor blinking (terminal escape codes)
-2. **P0:** Fix cursor positioning (verify offset math)
-3. **P1:** Add "Initializing..." text to splash
-4. **P2:** Show current model with ● indicator in selector
-5. **P3:** Add splash skip option after first view
-
----
-
-## 🔒 **SECURITY SPECIALIST REVIEW**
-
-### Security Assessment
-
-**Concerns:**
-- 🟡 **API key handling in model selector**
-  - Line models.go:340: `apiKey` passed to authentication
-  - Need to verify secure transmission
-  - Should be masked in logs
-
-- 🟡 **Provider authentication**
-  - Auto-detect scans for API keys
-  - Could expose keys in error messages
-  - Need audit of auth bridge error handling
-
-**Good Practices:**
-- ✅ Context timeouts prevent hanging auth calls
-- ✅ Authentication status cached (30s TTL)
-- ✅ No API keys in source code
-
-**Recommendations:**
-1. Audit auth bridge for key exposure in logs
-2. Add rate limiting to auth attempts
-3. Sanitize all error messages before display
-
----
-
-## 🎯 **CRITICAL ACTION ITEMS**
-
-### Must Fix Before Ship:
-
-1. **Cursor Blinking** - P0 BLOCKER
-   ```go
-   // Add to tui Init():
-   fmt.Print("\x1b[?12l")  // Disable cursor blinking (DECSET)
-   ```
-
-2. **Cursor Position** - P0 BLOCKER
-   - Current: textareaOffset(1) + editorOffset(2) + layoutOffset(editorX + 2)
-   - Debug actual values being returned
-   - Likely fix: Remove one layer of offsetting
-
-3. **Model IDs Validation** - P1
-   - Verify SOTA model IDs match actual provider APIs
-   - Add fallback if model ID not found
-
-4. **Offset Constants** - P1
-   ```go
-   const (
-       TEXTAREA_PROMPT_WIDTH = 1
-       EXTERNAL_PROMPT_WIDTH = 2
-       BORDER_WIDTH = 1
-       // etc.
-   )
-   ```
-
-### Nice to Have:
-
-5. **Splash Skip State** - P2
-   - Add `State.HasSeenSplash` flag
-   - Show only on first run or with `--splash` flag
-
-6. **Current Model Indicator** - P2
-   - Add ● or ✓ next to active model in selector
-
----
-
-## 📊 **METRICS & TESTING**
-
-### Test Coverage Gaps:
-- ❌ No cursor positioning tests
-- ❌ No splash animation tests
-- ❌ No model selector integration tests
-- ✅ Created manual verification checklist
-
-### Performance Concerns:
-- Splash animation: 90 FPS (50ms ticks) - may be overkill
-- Model selector auth check: 1s timeout per provider (could batch)
-- No lazy loading of provider lists
-
----
-
-## 💡 **INNOVATION SCORE: 8/10**
-
-**What Works:**
-- Matrix color cascade is genuinely impressive
-- 4-phase timing creates professional feel
-- SOTA model curation shows product maturity
-
-**What Could Be Better:**
-- Cursor issues undermine the polish
-- Hardcoded models limit flexibility
-- No personalization/customization options
-
----
-
-## ✅ **APPROVAL STATUS**
-
-- Architecture: ⚠️ **CONDITIONAL** - Fix offset stacking
-- Code Quality: ⚠️ **CONDITIONAL** - Add constants, fix cursor
-- Product/UX: ❌ **BLOCKED** - Cursor must work correctly
-- Security: ✅ **APPROVED** - Minor improvements needed
-
-**Overall: BLOCKED on cursor fixes. Once cursor works, this is production-ready.**
-
----
-
-## 🚀 **NEXT STEPS**
-
-1. Add cursor blink disable escape code
-2. Debug and fix cursor X offset calculation
-3. Extract magic numbers to constants
-4. Add automated tests for cursor positioning
-5. Verify SOTA model IDs against actual APIs
-6. Add metrics/telemetry to track splash engagement
-
-**Timeline:** 2-4 hours to address P0 blockers, ship-ready after that.
diff --git a/packages/tui/PHASE_1_COMPLETE.md b/packages/tui/PHASE_1_COMPLETE.md
deleted file mode 100644
index ea87986d..00000000
--- a/packages/tui/PHASE_1_COMPLETE.md
+++ /dev/null
@@ -1,227 +0,0 @@
-# Phase 1 Dynamic Theming - COMPLETE ✅
-
-**Commit**: `c82b97f1` - "feat: Implement Phase 1 dynamic provider theming"
-**Date**: October 14, 2025
-**Status**: Merged to `dev`, pushed to origin
-
----
-
-## What Was Built
-
-### 1. Core Theme Infrastructure
-
-**`internal/theme/provider_themes.go` (417 lines)**
-- Complete theme definitions for all 4 SOTA providers
-- Each theme has 50+ color values (primary, secondary, accent, status, diff, markdown, syntax)
-- Colors extracted from native CLI screenshots to match authentic aesthetics
-
-**Provider Themes:**
-- **Claude**: Warm copper/orange (#D4754C) - friendly, developer-focused
-- **Gemini**: Blue-pink gradient (#4285F4 → #EA4335) - vibrant, modern
-- **Codex**: OpenAI teal (#10A37F) - professional, technical
-- **Qwen**: Alibaba orange (#FF6A00) - international, innovative
-
-### 2. Hot-Swapping Theme Manager
-
-**`internal/theme/theme_manager.go` (145 lines)**
-- Thread-safe with RWMutex for concurrent access
-- `SwitchToProvider(providerID)` - instant theme switching
-- Callback system for UI components to react to theme changes
-- Automatic fallback to Claude theme on initialization
-
-### 3. Global Integration
-
-**`internal/theme/manager.go` (updated)**
-- `CurrentTheme()` returns active provider theme (with fallback to static themes)
-- `SwitchToProvider()` public API for external components
-- `DisableProviderThemes()` to revert to static theme system
-- ANSI color cache updated on theme switch
-
-### 4. Model Selector Integration
-
-**`internal/tui/tui.go` (updated)**
-- Theme switches on `app.ModelSelectedMsg`
-- When Tab cycles providers, `theme.SwitchToProvider()` is called
-- All UI components using `theme.CurrentTheme()` automatically get new colors
-- Debug logging: `"theme switched to provider"`
-
-### 5. Comprehensive Testing
-
-**`test_theme_switching.go` (90 lines)**
-- Integration test validates all 4 themes
-- Tests color accuracy
-- Validates invalid provider handling
-- Checks theme persistence
-- **Result**: All 7 tests pass ✅
-
-### 6. Complete Specification
-
-**`DYNAMIC_THEMING_SPEC.md` (573 lines)**
-- User stories and design vision
-- All 4 provider color palettes with hex values
-- Implementation architecture diagrams
-- Visual transition specifications
-- Playwright testing strategy
-- 4-phase rollout roadmap
-
----
-
-## How It Works
-
-```
-User Flow:
-1. User presses Tab key
-2. Model selector cycles to next provider (e.g., Claude → Gemini)
-3. app.ModelSelectedMsg is sent with new provider
-4. TUI handler calls theme.SwitchToProvider("gemini")
-5. ThemeManager switches current theme to Gemini
-6. All UI components call theme.CurrentTheme() and get Gemini theme
-7. Borders change from copper (#D4754C) to blue (#4285F4)
-8. Badges, text, and all UI elements update to match
-```
-
-**Performance:**
-- Zero measurable latency (theme switch is a pointer swap)
-- Thread-safe with RWMutex (read-heavy workload optimized)
-- No memory allocations during theme switch
-
----
-
-## Visual Results
-
-### Claude Theme (Default)
-- **Primary**: Warm copper #D4754C
-- **Borders**: Orange glow matching Claude Code
-- **Text**: Warm cream tones
-- **Feel**: Friendly, approachable, developer-focused
-
-### Gemini Theme
-- **Primary**: Google blue #4285F4
-- **Secondary**: Purple #9B72F2
-- **Accent**: Pink/red #EA4335
-- **Borders**: Blue-purple gradient
-- **Feel**: Vibrant, modern, AI-forward
-
-### Codex Theme
-- **Primary**: OpenAI teal #10A37F
-- **Borders**: Clean teal accent
-- **Text**: Neutral grays
-- **Feel**: Professional, technical, precise
-
-### Qwen Theme
-- **Primary**: Alibaba orange #FF6A00
-- **Borders**: Orange/gold scheme
-- **Text**: Warm off-white
-- **Feel**: Modern, international, innovative
-
----
-
-## Testing Results
-
-### Pre-Push Validation
-```
-✅ TypeScript typecheck (7 packages, FULL TURBO)
-✅ TUI E2E tests (all 4 providers authenticated)
-✅ Integration tests (all 7 theme tests pass)
-✅ Clean build (19MB optimized binary)
-```
-
-### Manual Testing Checklist
-- [ ] Launch RyCode TUI
-- [ ] Press Tab to cycle through providers
-- [ ] Verify Claude shows copper borders
-- [ ] Verify Gemini shows blue-pink gradient
-- [ ] Verify Codex shows teal accents
-- [ ] Verify Qwen shows orange glow
-- [ ] Verify all UI elements (borders, badges, text) update
-- [ ] Verify no visual glitches during transition
-
----
-
-## User Impact
-
-**Before Phase 1:**
-- Static theme regardless of model provider
-- No visual distinction between Claude, Gemini, Codex, Qwen
-- Cognitive load when switching contexts
-
-**After Phase 1:**
-- Dynamic theme matching each provider's native CLI
-- Instant visual feedback when Tab cycling
-- Familiar aesthetics reduce context switching cost
-- Developers feel "at home" with their preferred provider
-
-**User Quote from Spec:**
-> "As a developer who uses Claude Code daily, when I Tab to Claude models in RyCode, I want the interface to look and feel like Claude Code - warm orange borders, copper accents, and familiar typography."
-
----
-
-## What's Next
-
-### Phase 2: Visual Polish (Future PR)
-- [ ] Add 200ms crossfade transition animations
-- [ ] Provider-specific ASCII art logos in welcome screens
-- [ ] Custom loading spinners per provider
-- [ ] Provider-specific "Thinking" indicators
-- [ ] Smooth color interpolation between themes
-
-### Phase 3: Testing & Refinement (Future PR)
-- [ ] Playwright visual regression tests
-- [ ] Screenshot comparison with native CLIs
-- [ ] Performance profiling (ensure <10ms theme switch)
-- [ ] Accessibility audit (WCAG AA contrast)
-- [ ] User testing with devs familiar with each CLI
-
-### Phase 4: Documentation (Future PR)
-- [ ] Theme customization guide for users
-- [ ] Custom provider theme API for plugins
-- [ ] Visual design system documentation
-- [ ] Developer onboarding materials
-
----
-
-## Files Changed
-
-```
-packages/tui/
-├── DYNAMIC_THEMING_SPEC.md          (new, 573 lines)
-├── PHASE_1_COMPLETE.md              (new, this file)
-├── internal/theme/
-│   ├── manager.go                   (updated, +44 lines)
-│   ├── provider_themes.go           (new, 417 lines)
-│   └── theme_manager.go             (new, 145 lines)
-├── internal/tui/
-│   └── tui.go                       (updated, +3 lines)
-└── test_theme_switching.go          (new, 90 lines)
-```
-
-**Total**: 1,844 insertions, 3 deletions
-
----
-
-## Technical Achievements
-
-✅ **Zero Breaking Changes**: Backward compatible with static theme system
-✅ **Thread-Safe**: Concurrent access with RWMutex
-✅ **Zero Performance Impact**: Theme switch is O(1) pointer swap
-✅ **Comprehensive Testing**: Integration tests validate all providers
-✅ **Production Ready**: Clean build, all hooks pass, pushed to origin
-✅ **Well Documented**: 573-line spec with full implementation details
-
----
-
-## Conclusion
-
-Phase 1 establishes the foundation for dynamic provider theming. The infrastructure is complete, tested, and production-ready. Users can now Tab between providers and see the entire UI transform to match each provider's native CLI aesthetic.
-
-**What makes this special:**
-- Reduces cognitive load by providing familiar visual context
-- Makes each provider feel like its native tool
-- Creates emotional connection through thoughtful design
-- Sets the stage for even richer visual experiences in Phase 2
-
-The key insight: **familiarity breeds confidence**. By matching native CLI aesthetics, we help developers feel at home no matter which provider they're using.
-
----
-
-**Ready for Production** ✅
diff --git a/packages/tui/PHASE_2_COMPLETE.md b/packages/tui/PHASE_2_COMPLETE.md
deleted file mode 100644
index 53c5e487..00000000
--- a/packages/tui/PHASE_2_COMPLETE.md
+++ /dev/null
@@ -1,285 +0,0 @@
-# Phase 2 Dynamic Theming - COMPLETE ✅
-
-**Commits**:
-- `df826484` - "feat: Phase 2 - Provider-specific UI elements"
-- `47d17134` - "feat: Phase 2.1 - Provider-specific typing indicators"
-- `005bb43a` - "feat: Phase 2.2 - Provider-specific welcome messages"
-
-**Date**: October 14, 2025
-**Status**: Merged to `dev`, pushed to origin
-
----
-
-## What Was Built
-
-### 1. Provider-Specific Spinners
-
-**`internal/components/spinner/spinner.go` (updated)**
-- Added `GetProviderSpinnerFrames()` function to extract spinner frames from ProviderTheme
-- Modified `New()` to automatically use provider-specific spinner frames
-- Graceful type assertion with fallback to default Dots spinner
-
-**Provider Spinners:**
-- **Claude**: Braille spinner `⣾⣽⣻⢿⡿⣟⣯⣷` (8 frames)
-- **Gemini**: Circle spinner `◐◓◑◒` (4 frames)
-- **Codex**: Line spinner `⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏` (10 frames)
-- **Qwen**: Braille spinner `⣾⣽⣻⢿⡿⣟⣯⣷` (8 frames)
-
-**Implementation:**
-```go
-func GetProviderSpinnerFrames(t theme.Theme) []string {
-    // Try to get provider-specific spinner from ProviderTheme
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        spinnerStr := providerTheme.LoadingSpinner
-        if spinnerStr != "" {
-            frames := []string{}
-            for _, r := range spinnerStr {
-                frames = append(frames, string(r))
-            }
-            return frames
-        }
-    }
-
-    // Fallback to default Dots spinner
-    return Dots
-}
-```
-
-### 2. Provider-Specific Typing Indicators
-
-**`internal/components/chat/message.go` (updated)**
-- Modified `renderText()` to extract typing indicator text from ProviderTheme
-- Type assertion check for `*theme.ProviderTheme` with graceful fallback
-- Dynamic typing text based on active provider
-
-**Provider Typing Indicators:**
-- **Claude**: "Thinking..." (friendly, approachable)
-- **Gemini**: "Thinking..." (with gradient animation flag)
-- **Codex**: "Processing..." (technical, professional)
-- **Qwen**: "Thinking..." (modern, international)
-
-**Implementation:**
-```go
-// Get provider-specific typing indicator text
-typingText := "Thinking..."
-if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-    typingText = providerTheme.TypingIndicator.Text + "..."
-}
-
-// Use typingText in shimmer or static render
-```
-
-### 3. Provider-Specific Welcome Messages
-
-**`internal/components/help/empty_state.go` (updated)**
-- Modified `GetWelcomeEmptyState()` to extract welcome message from ProviderTheme
-- Type assertion check for `*theme.ProviderTheme` with graceful fallback
-- Dynamic welcome messages based on active provider
-
-**Provider Welcome Messages:**
-- **Claude**: "Welcome to Claude! I'm here to help you build amazing things."
-- **Gemini**: "Welcome to Gemini! Let's explore possibilities together."
-- **Codex**: "Welcome to Codex. Let's build something extraordinary."
-- **Qwen**: "Welcome to Qwen! Ready to innovate together."
-
-**Implementation:**
-```go
-t := theme.CurrentTheme()
-
-// Default welcome message
-welcomeMsg := "Your AI-powered development assistant is ready.\nLet's get started with a quick setup."
-
-// Check if current theme is a provider theme with custom welcome message
-if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-    if providerTheme.WelcomeMessage != "" {
-        welcomeMsg = providerTheme.WelcomeMessage
-    }
-}
-```
-
-### 4. Theme Infrastructure Already in Place
-
-**From Phase 1:**
-- `ProviderTheme` struct with all visual elements defined
-- `LogoASCII` - Provider-specific ASCII art logos
-- `WelcomeMessage` - Custom welcome messages per provider
-- `TypingIndicator` - Animation styles (dots, gradient, pulse, wave)
-
----
-
-## How It Works
-
-### Spinner Flow
-```
-1. User switches provider (Tab key or modal)
-2. theme.SwitchToProvider("gemini") called
-3. All new spinners created call spinner.New()
-4. New() calls GetProviderSpinnerFrames(theme.CurrentTheme())
-5. Type assertion checks if theme is *ProviderTheme
-6. Extract LoadingSpinner string, parse into frames
-7. Spinner displays Gemini's circle animation ◐◓◑◒
-```
-
-### Typing Indicator Flow
-```
-1. AI starts responding, isThinking=true
-2. renderText() gets current theme
-3. Type assertion checks if theme is *ProviderTheme
-4. Extract TypingIndicator.Text from theme
-5. Append "..." and render with shimmer effect
-6. User sees "Processing..." for Codex, "Thinking..." for Claude
-```
-
-### Welcome Message Flow
-```
-1. User sees empty state (welcome screen or empty chat)
-2. GetWelcomeEmptyState() called
-3. Get current theme
-4. Type assertion checks if theme is *ProviderTheme
-5. Extract WelcomeMessage from theme
-6. Render welcome with provider-specific greeting
-7. User sees "Welcome to Claude!" or "Welcome to Codex."
-```
-
----
-
-## Visual Results
-
-### Claude Theme
-- **Spinner**: Braille dots ⣾⣽⣻⢿⡿⣟⣯⣷ (smooth, continuous)
-- **Typing**: "Thinking..." (friendly, conversational)
-- **Welcome**: "Welcome to Claude! I'm here to help you build amazing things."
-- **Feel**: Warm, approachable, developer-focused
-
-### Gemini Theme
-- **Spinner**: Circle rotation ◐◓◑◒ (modern, geometric)
-- **Typing**: "Thinking..." (vibrant, with gradient potential)
-- **Welcome**: "Welcome to Gemini! Let's explore possibilities together."
-- **Feel**: Modern, AI-forward, colorful
-
-### Codex Theme
-- **Spinner**: Line rotation ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ (technical, precise)
-- **Typing**: "Processing..." (professional, technical)
-- **Welcome**: "Welcome to Codex. Let's build something extraordinary."
-- **Feel**: Clean, technical, code-first
-
-### Qwen Theme
-- **Spinner**: Braille dots ⣾⣽⣻⢿⡿⣟⣯⣷ (international, modern)
-- **Typing**: "Thinking..." (contemporary, global)
-- **Welcome**: "Welcome to Qwen! Ready to innovate together."
-- **Feel**: Modern, innovative, international
-
----
-
-## Testing Results
-
-### Pre-Push Validation
-```
-✅ TypeScript typecheck (7 packages, FULL TURBO, 88ms)
-✅ TUI E2E tests (all 4 providers authenticated)
-✅ Clean builds (19MB optimized binary)
-✅ Git hooks passed
-```
-
-### Manual Testing Checklist
-- [x] Launch RyCode TUI
-- [x] Tab through all 4 providers
-- [x] Verify spinner changes per provider
-- [x] Verify typing indicator text changes
-- [x] Confirm Codex shows "Processing..." not "Thinking..."
-- [x] Confirm all spinners match provider aesthetic
-
----
-
-## User Impact
-
-**Before Phase 2:**
-- Static spinner regardless of provider
-- Generic "Thinking..." message for all providers
-- Generic welcome messages
-- No visual personality differences beyond colors
-
-**After Phase 2:**
-- Dynamic spinner matching each provider's style
-- Context-aware typing indicators matching provider personality
-- Provider-specific welcome messages reflecting brand voice
-- Complete visual immersion in each provider's aesthetic
-- Every loading state, empty state, and greeting reflects the provider's brand
-
-**User Quote from Spec:**
-> "When I Tab to Codex, I don't just want teal colors - I want to feel like I'm using OpenAI Codex. The spinner, the typing indicator, the entire experience should match what I know from the native CLI."
-
----
-
-## What's Next
-
-### Phase 2.2: ASCII Art & Enhanced Visuals (Future PR)
-- [x] Show provider-specific welcome messages ✅
-- [ ] Display provider-specific ASCII art logos on startup
-- [ ] Add provider-specific easter eggs
-- [ ] Custom help text per provider
-
-### Phase 2.3: Animation Enhancements (Future PR)
-- [ ] Implement Gemini's gradient animation for typing indicator
-- [ ] Add Qwen's wave animation
-- [ ] Codex pulse effect for processing
-- [ ] Smooth transitions between animation styles
-
-### Phase 3: Testing & Refinement (Future PR)
-- [ ] Playwright visual regression tests
-- [ ] Screenshot comparison with native CLIs
-- [ ] Performance profiling (ensure <10ms theme switch)
-- [ ] Accessibility audit (WCAG AA contrast)
-- [ ] User testing with devs familiar with each CLI
-
-### Phase 4: Documentation (Future PR)
-- [ ] Theme customization guide for users
-- [ ] Custom provider theme API for plugins
-- [ ] Visual design system documentation
-- [ ] Developer onboarding materials
-
----
-
-## Files Changed
-
-```
-packages/tui/
-├── PHASE_2_COMPLETE.md              (new, this file)
-├── internal/components/
-│   ├── spinner/spinner.go           (updated, +18 lines)
-│   ├── chat/message.go              (updated, +5 lines)
-│   └── help/empty_state.go          (updated, +14 lines)
-└── internal/theme/
-    └── provider_themes.go           (already complete from Phase 1)
-```
-
-**Total**: 37 insertions, 3 deletions
-
----
-
-## Technical Achievements
-
-✅ **Zero Breaking Changes**: Backward compatible with fallback logic
-✅ **Type-Safe**: Proper type assertions with graceful fallbacks
-✅ **Zero Performance Impact**: Theme checks are O(1) operations
-✅ **Comprehensive Testing**: All providers authenticated and tested
-✅ **Production Ready**: Clean build, all hooks pass, pushed to origin
-✅ **User-Centric**: Each provider feels authentic and familiar
-
----
-
-## Conclusion
-
-Phase 2 brings provider-specific UI elements to life. The spinner animations and typing indicators now match each provider's personality and aesthetic, creating a cohesive, immersive experience.
-
-**What makes this special:**
-- Every loading state reflects the provider's brand
-- Users feel at home with their preferred provider
-- Subtle details create emotional connection
-- Technical precision meets design thoughtfulness
-
-The key insight: **details matter**. A developer who uses Codex daily will notice "Processing..." instead of "Thinking..." and feel that RyCode truly understands their tool. These micro-interactions build trust and delight.
-
----
-
-**Ready for Production** ✅
diff --git a/packages/tui/PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md b/packages/tui/PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md
deleted file mode 100644
index 4fb39fe5..00000000
--- a/packages/tui/PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md
+++ /dev/null
@@ -1,387 +0,0 @@
-# Phase 3.3A Visual Verification - COMPLETE ✅
-
-**Date**: October 14, 2025
-**Status**: All 56 tests passed
-
----
-
-## Overview
-
-Phase 3.3A implements automated color verification tests to ensure all provider themes maintain visual accuracy and prevent color drift over time.
-
----
-
-## What Was Built
-
-### Automated Color Verification Tool
-
-**`test_theme_visual_verification.go` (220 lines)**
-- Programmatic color extraction from theme system
-- Hex color comparison against specifications
-- Tests 14 critical colors for each of 4 provider themes
-- CI-ready for continuous verification
-
-### Test Coverage
-
-**For Each of 4 Provider Themes (56 total tests):**
-1. **Core Colors**
-   - Primary brand color
-   - Accent color
-   - Border color
-
-2. **Text Colors**
-   - Primary text
-   - Muted text
-
-3. **Backgrounds**
-   - Main background
-   - Panel background
-
-4. **Status Indicators**
-   - Success color
-   - Error color
-   - Warning color
-   - Info color
-
-5. **Markdown Elements**
-   - Heading color
-   - Link color
-   - Code block color
-
----
-
-## Test Results
-
-### ✅ All Themes Pass
-
-```
-=== Theme Visual Verification ===
-Verifying all theme colors match specifications...
-
-[claude Theme]
-  Summary: 14 passed, 0 failed
-
-[gemini Theme]
-  Summary: 14 passed, 0 failed
-
-[codex Theme]
-  Summary: 14 passed, 0 failed
-
-[qwen Theme]
-  Summary: 14 passed, 0 failed
-
-=== Visual Verification Summary ===
-
-✅ All 56 color tests passed!
-
-Theme Color Accuracy:
-  • All primary colors match specifications
-  • All text colors match specifications
-  • All UI element colors match specifications
-  • All markdown colors match specifications
-
-Benefits:
-  • Visual consistency guaranteed
-  • Brand colors accurately replicated
-  • No color drift over time
-  • CI-ready for regression detection
-```
-
----
-
-## Verified Colors
-
-### Claude Theme (Warm Copper)
-- Primary: `#D4754C` ✓
-- Accent: `#F08C5C` ✓
-- Text: `#E8D5C4` ✓
-- Success: `#6FA86F` ✓
-- Warning: `#E8A968` ✓
-- Error: `#D47C7C` ✓
-
-### Gemini Theme (Google Blue)
-- Primary: `#4285F4` ✓
-- Accent: `#EA4335` (Google Red) ✓
-- Text: `#E8EAED` ✓
-- Success: `#34A853` ✓
-- Warning: `#FBBC04` ✓
-- Error: `#EA4335` ✓
-
-### Codex Theme (OpenAI Teal)
-- Primary: `#10A37F` ✓
-- Accent: `#1FC2AA` ✓
-- Text: `#ECECEC` ✓
-- Success: `#10A37F` ✓
-- Warning: `#F59E0B` ✓
-- Error: `#EF4444` ✓
-
-### Qwen Theme (Alibaba Orange)
-- Primary: `#FF6A00` ✓
-- Accent: `#FF8533` ✓
-- Text: `#F0E8DC` ✓
-- Success: `#52C41A` ✓
-- Warning: `#FAAD14` ✓
-- Error: `#FF4D4F` ✓
-
----
-
-## Technical Implementation
-
-### Color Extraction
-
-```go
-// Get color from theme system
-var actualColor compat.AdaptiveColor
-switch test.Element {
-case "Primary":
-    actualColor = th.Primary()
-case "Text":
-    actualColor = th.Text()
-case "Accent":
-    actualColor = th.Accent()
-// ... etc
-}
-```
-
-### Hex Conversion
-
-```go
-func colorToHex(ac compat.AdaptiveColor) string {
-    // Use dark variant since RyCode is a dark TUI
-    c := ac.Dark
-    r, g, b, _ := c.RGBA()
-
-    // Convert from 16-bit (0-65535) to 8-bit (0-255)
-    r8 := uint8(r >> 8)
-    g8 := uint8(g >> 8)
-    b8 := uint8(b >> 8)
-
-    return fmt.Sprintf("#%02X%02X%02X", r8, g8, b8)
-}
-```
-
-### Verification Logic
-
-```go
-// Compare actual vs expected
-passed := actualHex == test.Expected
-if !passed {
-    status = "✗"
-    allPassed = false
-}
-```
-
----
-
-## Running the Tests
-
-```bash
-cd packages/tui
-go run test_theme_visual_verification.go
-```
-
-Output shows:
-- Per-provider test results
-- Summary of passed/failed tests
-- Overall pass/fail status
-- Exit code 0 for success, 1 for failure
-
----
-
-## CI Integration
-
-This test can be integrated into CI/CD pipelines:
-
-```yaml
-# .github/workflows/theme-tests.yml
-name: Theme Visual Verification
-
-on: [push, pull_request]
-
-jobs:
-  visual-tests:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Set up Go
-        uses: actions/setup-go@v4
-        with:
-          go-version: '1.21'
-
-      - name: Run visual verification tests
-        run: |
-          cd packages/tui
-          go run test_theme_visual_verification.go
-```
-
----
-
-## Benefits
-
-### 1. Prevents Color Drift
-- Colors are verified programmatically
-- No manual checking required
-- Catches accidental changes immediately
-
-### 2. Brand Consistency
-- Each provider's brand colors are exact
-- Visual identity maintained across updates
-- Professional appearance guaranteed
-
-### 3. Regression Detection
-- Any color change is caught in CI
-- Failed tests block merges
-- Historical color accuracy preserved
-
-### 4. Documentation
-- Test file serves as color reference
-- All colors documented in one place
-- Easy to update when brands change
-
----
-
-## What's Different from Phase 3.1
-
-### Phase 3.1: Accessibility Audit
-- **Focus**: WCAG contrast ratios
-- **Tests**: 48 tests (12 per theme)
-- **Purpose**: Ensure readability for all users
-- **Result**: 100% WCAG AA compliance
-
-### Phase 3.3A: Visual Verification
-- **Focus**: Exact color values
-- **Tests**: 56 tests (14 per theme)
-- **Purpose**: Ensure brand color accuracy
-- **Result**: 100% color match
-
-**Key Difference**: Phase 3.1 tests **readability** (contrast), Phase 3.3A tests **accuracy** (exact colors).
-
----
-
-## Comparison to Other Testing Approaches
-
-### Approach A: Screenshot Comparison (Phase 3.3B/C)
-**Pros:**
-- Catches visual regressions in layout
-- Sees exactly what users see
-- Human-reviewable
-
-**Cons:**
-- Requires VHS setup
-- Sensitive to font rendering
-- Larger artifacts to store
-- Slower to run
-
-### Approach B: Color Verification (Phase 3.3A) ✅
-**Pros:**
-- Fast execution (< 1 second)
-- No external dependencies
-- Exact color verification
-- Easy to understand failures
-- Works on any platform
-
-**Cons:**
-- Doesn't catch layout issues
-- Only verifies colors, not visual appearance
-
-**Why We Started Here**: Phase 3.3A provides immediate value with minimal setup. We can add screenshot-based testing (3.3B/C) later if needed.
-
----
-
-## Real-World Impact
-
-### For Developers
-- Confidence that theme colors are correct
-- Automated verification in every PR
-- Clear error messages when colors drift
-- Easy to fix with hex code references
-
-### For Users
-- Consistent visual experience
-- Authentic provider branding
-- Professional appearance
-- No jarring color mismatches
-
-### For QA
-- One less thing to manually verify
-- Automated regression prevention
-- Historical color accuracy
-- Fast feedback loop
-
----
-
-## Files Added
-
-```
-packages/tui/
-├── test_theme_visual_verification.go      (220 lines)
-└── PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md  (this file)
-```
-
-**Total**: 220 insertions
-
----
-
-## Related Documentation
-
-- **VISUAL_TESTING_STRATEGY.md** - Overall visual testing strategy
-- **PHASE_3_TESTING_COMPLETE.md** - Phase 3 summary (accessibility + performance)
-- **PHASE_3_ACCESSIBILITY_COMPLETE.md** - Phase 3.1 accessibility audit details
-- **DYNAMIC_THEMING_SPEC.md** - Original specification
-
----
-
-## Technical Achievements
-
-✅ **56/56 Tests Passed**: All colors match specifications exactly
-✅ **Zero Dependencies**: Pure Go, no external tools required
-✅ **Fast Execution**: Completes in under 1 second
-✅ **CI-Ready**: Can run in any environment with Go
-✅ **Comprehensive Coverage**: All critical colors verified
-✅ **Clear Failures**: Exact hex codes shown for mismatches
-
----
-
-## What's Next
-
-### Phase 3.3B: VHS Manual Review (Optional)
-- Create `.tape` files for each theme
-- Generate GIF/PNG screenshots
-- Use for documentation and marketing
-- Manual visual review by humans
-
-### Phase 3.3C: Screenshot Comparison (Optional)
-- Full visual regression testing
-- Compare screenshots against references
-- Automated diff detection
-- Pixel-perfect verification
-
-### Phase 3.4: User Testing
-- Recruit users familiar with each CLI
-- Gather feedback on theme accuracy
-- Validate accessibility in real use
-- Iterate based on feedback
-
----
-
-## Conclusion
-
-Phase 3.3A establishes automated color verification for RyCode's dynamic provider theming system. With 56/56 tests passing, we have:
-
-- **100% color accuracy** across all provider themes
-- **Zero color drift** with automated verification
-- **CI-ready testing** for continuous validation
-- **Clear documentation** of all brand colors
-
-This complements Phase 3.1 (accessibility) and Phase 3.2 (performance) to create a complete testing suite for the theming system.
-
-**Key Insight**: Visual testing for TUI applications requires different tools than web apps. By starting with programmatic color verification, we get immediate value while laying groundwork for more comprehensive visual testing in the future.
-
----
-
-**Implementation Status**: Complete ✅
-
-**All Tests Passing**: 56/56 ✅
-
-**CI-Ready**: Yes ✅
diff --git a/packages/tui/PHASE_3_ACCESSIBILITY_COMPLETE.md b/packages/tui/PHASE_3_ACCESSIBILITY_COMPLETE.md
deleted file mode 100644
index 110a8a75..00000000
--- a/packages/tui/PHASE_3_ACCESSIBILITY_COMPLETE.md
+++ /dev/null
@@ -1,347 +0,0 @@
-# Phase 3.1 Accessibility Audit - COMPLETE ✅
-
-**Commit**: `12258ab8` - "feat: Phase 3.1 - WCAG accessibility audit tool"
-**Date**: October 14, 2025
-**Status**: Merged to `dev`, pushed to origin
-
----
-
-## What Was Built
-
-### Comprehensive WCAG 2.1 Accessibility Audit Tool
-
-**`test_theme_accessibility.go` (215 lines)**
-- Complete contrast ratio calculator implementing WCAG 2.1 algorithm
-- Relative luminance computation with proper gamma correction
-- Tests 12 critical color combinations for each provider theme
-- Validates against AA and AAA standards
-
-### Test Coverage
-
-**For Each of 4 Provider Themes:**
-1. **Text Readability**
-   - Primary text on background
-   - Muted text on background
-   - Text on panel backgrounds
-
-2. **UI Elements** (Large text/3.0:1 standard)
-   - Borders on background
-   - Primary color on background
-   - Success indicators
-   - Error indicators
-   - Warning indicators
-   - Info indicators
-
-3. **Markdown Content**
-   - Headings on background
-   - Links on background
-   - Code blocks on background
-
----
-
-## Test Results
-
-### ✅ Claude Theme
-```
-Text on Background:              12.43:1 [AAA] ✓
-Muted Text on Background:        4.98:1  [AA]  ✓
-Text on Panel:                   10.48:1 [AAA] ✓
-Border on Background:            5.44:1  [AA]  ✓
-Primary on Background:           5.44:1  [AA]  ✓
-Success on Background:           6.33:1  [AA]  ✓
-Error on Background:             5.88:1  [AA]  ✓
-Warning on Background:           8.69:1  [AAA] ✓
-Info on Background:              5.44:1  [AA]  ✓
-Markdown Heading:                7.26:1  [AAA] ✓
-Markdown Link:                   5.44:1  [AA]  ✓
-Markdown Code:                   8.69:1  [AAA] ✓
-
-Summary: 12/12 passed (8 exceed AAA)
-```
-
-### ✅ Gemini Theme
-```
-Text on Background:              16.13:1 [AAA] ✓
-Muted Text on Background:        7.36:1  [AAA] ✓
-Text on Panel:                   14.44:1 [AAA] ✓
-Border on Background:            5.45:1  [AA]  ✓
-Primary on Background:           5.45:1  [AA]  ✓
-Success on Background:           6.36:1  [AA]  ✓
-Error on Background:             4.95:1  [AA]  ✓
-Warning on Background:           11.38:1 [AAA] ✓
-Info on Background:              5.45:1  [AA]  ✓
-Markdown Heading:                5.45:1  [AA]  ✓
-Markdown Link:                   5.45:1  [AA]  ✓
-Markdown Code:                   11.38:1 [AAA] ✓
-
-Summary: 12/12 passed (7 exceed AAA)
-```
-
-### ✅ Codex Theme
-```
-Text on Background:              16.34:1 [AAA] ✓
-Muted Text on Background:        5.89:1  [AA]  ✓
-Text on Panel:                   14.43:1 [AAA] ✓
-Border on Background:            6.04:1  [AA]  ✓
-Primary on Background:           6.04:1  [AA]  ✓
-Success on Background:           6.04:1  [AA]  ✓
-Error on Background:             5.13:1  [AA]  ✓
-Warning on Background:           8.99:1  [AAA] ✓
-Info on Background:              5.25:1  [AA]  ✓
-Markdown Heading:                8.60:1  [AAA] ✓
-Markdown Link:                   6.04:1  [AA]  ✓
-Markdown Code:                   8.99:1  [AAA] ✓
-
-Summary: 12/12 passed (7 exceed AAA)
-```
-
-### ✅ Qwen Theme
-```
-Text on Background:              15.14:1 [AAA] ✓
-Muted Text on Background:        6.15:1  [AA]  ✓
-Text on Panel:                   13.64:1 [AAA] ✓
-Border on Background:            6.41:1  [AA]  ✓
-Primary on Background:           6.41:1  [AA]  ✓
-Success on Background:           8.12:1  [AAA] ✓
-Error on Background:             5.63:1  [AA]  ✓
-Warning on Background:           9.68:1  [AAA] ✓
-Info on Background:              5.67:1  [AA]  ✓
-Markdown Heading:                6.41:1  [AA]  ✓
-Markdown Link:                   5.67:1  [AA]  ✓
-Markdown Code:                   9.68:1  [AAA] ✓
-
-Summary: 12/12 passed (8 exceed AAA)
-```
-
----
-
-## WCAG 2.1 Standards
-
-### Level AA (Required)
-- **Normal Text**: 4.5:1 minimum contrast ratio
-- **Large Text/UI Components**: 3.0:1 minimum contrast ratio
-
-### Level AAA (Enhanced)
-- **Normal Text**: 7.0:1 minimum contrast ratio
-- **Large Text**: 4.5:1 minimum contrast ratio
-
-### Our Results
-- **48/48 tests passed** (100% success rate)
-- **29/48 tests exceed AAA** (60% at highest standard)
-- **All primary text exceeds 12:1** (far surpasses AAA 7:1)
-- **All muted text exceeds AA 4.5:1**
-- **All UI elements exceed AA 3.0:1**
-
----
-
-## Key Findings
-
-### Exceptional Text Contrast
-All themes achieve 12-16:1 contrast for primary text - this is **2-3x higher than AAA requirements**:
-- Claude: 12.43:1
-- Gemini: 16.13:1
-- Codex: 16.34:1
-- Qwen: 15.14:1
-
-### Strong Muted Text
-Even muted/secondary text exceeds AA requirements:
-- All themes: 4.98-7.36:1 (above 4.5:1 minimum)
-- Gemini muted text achieves AAA (7.36:1)
-
-### Robust UI Elements
-All status colors and UI elements exceed minimum requirements:
-- Success indicators: 6.04-8.12:1 (well above 3.0:1)
-- Error indicators: 4.95-5.88:1 (well above 3.0:1)
-- Warning indicators: 8.69-11.38:1 (exceed AAA!)
-
-### Outstanding Code Display
-Markdown code blocks achieve excellent contrast:
-- Claude: 8.69:1 [AAA]
-- Gemini: 11.38:1 [AAA]
-- Codex: 8.99:1 [AAA]
-- Qwen: 9.68:1 [AAA]
-
-This is critical for developers reading code in the TUI.
-
----
-
-## User Impact
-
-### Accessibility for All Users
-
-**Users with Low Vision:**
-- All text is highly legible with contrast ratios 2-3x higher than required
-- Muted text remains readable even in poor lighting
-- UI elements are clearly distinguishable
-
-**Users with Color Blindness:**
-- High contrast ensures readability regardless of color perception
-- Status colors (success, error, warning) have sufficient brightness differences
-- UI remains usable even if colors appear different
-
-**Users with Reduced Contrast Sensitivity:**
-- Aging users often experience reduced contrast sensitivity
-- Our themes exceed requirements by such margins that they remain highly usable
-- Even in bright sunlight or dim rooms, text remains clear
-
-**Users with Cognitive Disabilities:**
-- High contrast reduces cognitive load
-- Clear visual hierarchy through strong contrast differences
-- Easier to focus attention on important elements
-
-### Real-World Scenarios
-
-**Bright Office Lighting:**
-- Screen glare reduces perceived contrast
-- Our 12-16:1 text contrast compensates for this
-
-**Dim Evening Coding:**
-- Reduced ambient light can make screens harder to read
-- Strong contrast maintains readability
-
-**Outdoor Work:**
-- Direct sunlight can wash out screens
-- Exceptional contrast ratios ensure visibility
-
-**Extended Sessions:**
-- Eye fatigue reduces contrast perception
-- High initial contrast maintains readability over time
-
----
-
-## Technical Implementation
-
-### Contrast Ratio Algorithm
-
-```go
-func ContrastRatio(c1, c2 color.Color) float64 {
-    l1 := relativeLuminance(c1)
-    l2 := relativeLuminance(c2)
-
-    if l1 > l2 {
-        return (l1 + 0.05) / (l2 + 0.05)
-    }
-    return (l2 + 0.05) / (l1 + 0.05)
-}
-
-func relativeLuminance(c color.Color) float64 {
-    r, g, b, _ := c.RGBA()
-
-    // Convert to 0-1 range
-    rNorm := float64(r) / 65535.0
-    gNorm := float64(g) / 65535.0
-    bNorm := float64(b) / 65535.0
-
-    // Apply gamma correction
-    rLinear := toLinear(rNorm)
-    gLinear := toLinear(gNorm)
-    bLinear := toLinear(bNorm)
-
-    // Calculate luminance (WCAG formula)
-    return 0.2126*rLinear + 0.7152*gLinear + 0.0722*bLinear
-}
-```
-
-This follows the WCAG 2.1 specification exactly, including:
-- Proper gamma correction (sRGB color space)
-- Correct luminance coefficients
-- Accurate contrast ratio calculation
-
----
-
-## Running the Audit
-
-```bash
-cd packages/tui
-go run test_theme_accessibility.go
-```
-
-Output shows:
-- Contrast ratio for each color combination
-- Whether it passes AA or AAA standards
-- Summary of passed/failed tests per theme
-- Overall pass/fail status
-
----
-
-## Comparison to Other Tools
-
-### Native CLIs
-Many native CLI tools **do not** undergo formal accessibility audits:
-- Claude Code: No published accessibility metrics
-- GitHub Copilot: No published WCAG compliance
-- Cursor: No accessibility documentation
-
-**RyCode now has verified, documented accessibility compliance.**
-
-### Industry Standards
-- **VS Code**: Meets WCAG AA but doesn't publish detailed contrast ratios
-- **JetBrains IDEs**: Accessibility features but no detailed audit
-- **Sublime Text**: Minimal accessibility documentation
-
-**RyCode exceeds industry standards with documented 48/48 test passes.**
-
----
-
-## What's Next
-
-### Phase 3.2: Performance Optimization
-- [ ] Measure theme switching performance
-- [ ] Profile memory usage during theme changes
-- [ ] Optimize color calculations
-- [ ] Benchmark against 10ms target
-
-### Phase 3.3: Visual Regression Tests
-- [ ] Playwright screenshot tests
-- [ ] Compare with native CLI screenshots
-- [ ] Automated visual diff detection
-- [ ] CI integration for theme changes
-
-### Phase 3.4: User Testing
-- [ ] Recruit users familiar with each CLI
-- [ ] Gather feedback on theme accuracy
-- [ ] Validate accessibility in real-world use
-- [ ] Iterate based on user input
-
----
-
-## Files Changed
-
-```
-packages/tui/
-├── PHASE_3_ACCESSIBILITY_COMPLETE.md  (new, this file)
-└── test_theme_accessibility.go        (new, 215 lines)
-```
-
-**Total**: 215 insertions, 0 deletions
-
----
-
-## Technical Achievements
-
-✅ **WCAG 2.1 Compliant**: All themes meet AA standards
-✅ **Exceeds Requirements**: 60% of tests achieve AAA level
-✅ **Comprehensive Testing**: 48 tests across 4 themes
-✅ **Documented Evidence**: Verifiable contrast ratios for every combination
-✅ **Production Ready**: Accessibility audit can run in CI/CD
-✅ **Industry Leading**: Exceeds accessibility standards of most native CLIs
-
----
-
-## Conclusion
-
-Phase 3.1 establishes RyCode as an accessibility leader in the CLI space. Not only do all themes meet WCAG AA standards, but they exceed them significantly:
-
-- **Primary text is 2-3x more readable than required**
-- **60% of color combinations achieve AAA level**
-- **All 48 tests pass with flying colors**
-
-This isn't just about compliance - it's about **inclusive design**. Every user, regardless of visual ability, lighting conditions, or device quality, can use RyCode comfortably.
-
-**The key insight**: Accessibility isn't a checkbox - it's a fundamental quality metric. By exceeding standards from the start, we ensure RyCode remains usable as users age, as lighting changes, and as screens vary. This is design that respects every user.
-
----
-
-**Ready for Production** ✅
-
-**Accessibility Certified** ✅
diff --git a/packages/tui/PHASE_3_COMPLETE.md b/packages/tui/PHASE_3_COMPLETE.md
deleted file mode 100644
index d1c01551..00000000
--- a/packages/tui/PHASE_3_COMPLETE.md
+++ /dev/null
@@ -1,488 +0,0 @@
-# Phase 3: Complete ✅
-
-> **RyCode TUI - AI-Designed Excellence**
->
-> Built entirely by Claude AI in extended development sessions. Every feature designed with empathy, intelligence, and obsessive attention to detail.
-
----
-
-## 🎉 Mission Accomplished
-
-Phase 3 development is **100% complete**. RyCode TUI is production-ready with all planned features implemented, tested, and documented.
-
-### Final Metrics
-
-**Code Statistics:**
-- **~7,916 lines** of production code (Phase 3 alone)
-- **27 new files** created across 7 packages
-- **10/10 tests passing** with comprehensive coverage
-- **0 known bugs** at release
-
-**Performance Metrics:**
-- **60fps rendering** achieved ✅
-- **<100ns monitoring overhead** (virtually zero impact) ✅
-- **19MB stripped binary** (under 20MB target) ✅
-- **Zero-allocation hot paths** for critical operations ✅
-
-**Accessibility Metrics:**
-- **9 accessibility modes** implemented ✅
-- **30+ keyboard shortcuts** documented ✅
-- **100% keyboard navigation** coverage ✅
-- **Screen reader compatible** ✅
-
-**Intelligence Metrics:**
-- **4 AI-powered features** (recommendations, budgeting, alerts, insights) ✅
-- **Learning from usage** for personalized recommendations ✅
-- **ML-style forecasting** with 15% trend detection ✅
-- **Multi-criteria optimization** (cost, quality, speed) ✅
-
-**Polish Metrics:**
-- **10+ hidden easter eggs** ✅
-- **6-step onboarding flow** ✅
-- **Contextual help system** ✅
-- **Milestone celebrations** ✅
-- **Personality throughout** ✅
-
----
-
-## 📦 Deliverables
-
-### Phase 3A: Visual Excellence ✅
-- `internal/typography/typography.go` (200 lines) - Semantic typography system
-- Animation framework with reduced motion support
-- Error handling with personality
-- Micro-interactions throughout UI
-
-### Phase 3B: Intelligence Layer ✅
-
-**Phase 3B.1: Smart Cost Alerts**
-- Real-time budget monitoring
-- Threshold-based notifications (50%, 80%, 95%, 100%)
-- Actionable cost-saving suggestions
-
-**Phase 3B.2: AI Model Recommendations**
-- `internal/intelligence/model_recommendations.go` (480 lines)
-- `internal/intelligence/model_recommendation_panel.go` (210 lines)
-- Multi-criteria optimization (cost, quality, speed)
-- Learning system with satisfaction tracking
-- Confidence scoring (0-100)
-- Detailed reasoning for recommendations
-
-**Phase 3B.3: Usage Insights Dashboard**
-- `internal/intelligence/usage_insights.go` (490 lines)
-- `internal/components/dialog/insights_dialog.go` (120 lines)
-- Beautiful ASCII charts for cost trends
-- Top models ranking with usage bars
-- Peak usage hour detection
-- Optimization opportunity suggestions
-
-**Phase 3B.4: Predictive Budgeting**
-- `internal/intelligence/predictive_budget.go` (455 lines)
-- ML-style spending forecasts
-- 15% threshold trend detection (increasing/decreasing)
-- Confidence scoring based on data points
-- Proactive overspend warnings
-- Actionable budget recommendations
-
-### Phase 3C: Provider Management UI ✅
-- `internal/components/dialog/providers_dialog.go` (300 lines)
-- Multi-provider support (Anthropic, OpenAI, Google, Grok, Qwen)
-- Authentication status tracking
-- Health monitoring (healthy/degraded/down)
-- API key masking for security
-- Provider refresh capability
-
-### Phase 3D: Onboarding & Help System ✅
-
-**Phase 3D.1: Welcome Flow**
-- `internal/components/dialog/welcome_dialog.go` (350+ lines)
-- 6-step interactive onboarding
-- Progress indicator with navigation
-- Provider setup guidance
-- Keyboard shortcuts tutorial
-- Skip tutorial option ('S' key)
-
-**Phase 3D.2: Keyboard Shortcuts Guide**
-- `internal/components/dialog/shortcuts_dialog.go` (290 lines)
-- 30+ shortcuts documented
-- 6 categories (Essential, Navigation, Models, Analytics, Editing, Advanced)
-- Two-column layout for easy scanning
-- Important shortcuts highlighted ⭐
-
-**Phase 3D.3: Contextual Help**
-- `internal/components/help/context_help.go` (550+ lines)
-- `internal/components/help/empty_state.go` (250+ lines)
-- Smart hints for every app context
-- Progressive tips based on behavior
-- Beautiful empty states with guidance
-- Status bar hints that adapt to view
-
-### Phase 3E: Performance Optimization ✅
-- `internal/performance/monitor.go` (450 lines)
-- `internal/components/dialog/performance_dialog.go` (360 lines)
-- `internal/performance/monitor_test.go` (240 lines)
-- Frame-by-frame performance tracking
-- Component-level render profiling
-- Memory usage with GC monitoring
-- Health scoring (0-100)
-- Real-time dashboard (Ctrl+D)
-- **Benchmarks achieved:**
-  - Frame Cycle: 64ns (0 allocs) ⚡️
-  - Component Render: 64ns (0 allocs) ⚡️
-  - Get Metrics: 54ns (1 alloc) ⚡️
-  - Memory Snapshot: 21µs (0 allocs) ⚡️
-
-### Phase 3F: Accessibility Features ✅
-- `internal/accessibility/accessibility.go` (440 lines)
-- `internal/components/dialog/accessibility_dialog.go` (260 lines)
-- **9 Accessibility Modes:**
-  1. High Contrast Mode
-  2. Reduced Motion
-  3. Large Text
-  4. Increased Spacing
-  5. Screen Reader Mode
-  6. Keyboard-Only Mode
-  7. Show Keyboard Hints
-  8. Verbose Labels
-  9. Enhanced Focus Indicators
-- Thread-safe settings management
-- Real-time toggling without restart
-- WCAG AA compliant colors
-
-### Phase 3G: Final Polish ✅
-- `internal/polish/micro_interactions.go` (450+ lines)
-- `internal/polish/easter_eggs.go` (440+ lines)
-- **10+ Hidden Easter Eggs:**
-  - Konami code (↑↑↓↓←→←→BA)
-  - Type "claude" for personal message
-  - Type "coffee" for coffee mode
-  - Type "zen" for zen mode
-  - Type "42" for Douglas Adams tribute
-  - And 5 more secrets...
-- **Milestone Celebrations:**
-  - First use welcome
-  - 100 requests century club
-  - $10 saved achievement
-  - Week streak dedication
-  - Keyboard mastery
-  - Budget achievements
-- **Personality System:**
-  - 10 random welcome messages
-  - 10 random loading messages
-  - 10 friendly error messages
-  - 10 motivational quotes
-  - Time-based greetings
-  - Seasonal messages
-  - 10 fun facts about RyCode
-
-### Phase 3H: Showcase Documentation ✅
-- `README.md` (500+ lines) - Comprehensive overview with quick start
-- `FEATURE_HIGHLIGHTS.md` (550+ lines) - Deep technical analysis
-- `DEMO_SCRIPT.md` (400+ lines) - Professional presentation guide
-- **Total: 1,394 lines of documentation**
-
-### Phase 3I: UX Review & Improvements ✅
-- Multi-agent UX peer review completed (`/ux --ai`)
-- Skip tutorial feature added ('S' key in welcome dialog)
-- Enhanced navigation hints throughout
-- Progressive disclosure improvements identified
-- All quick-win improvements implemented
-
----
-
-## 🏆 "Can't Compete" Achievements
-
-RyCode is **objectively superior** to human-built alternatives in measurable dimensions:
-
-| Metric | RyCode | Typical Alternative |
-|--------|--------|---------------------|
-| Accessibility Modes | 9 | 0-1 |
-| Keyboard Shortcuts | 30+ | 5-10 |
-| FPS | 60 | 15-30 |
-| Monitoring Overhead | <100ns | N/A |
-| Binary Size | 19MB | 50-100MB |
-| Easter Eggs | 10+ | 0 |
-| AI Recommendations | ✓ Learning | ✗ |
-| Predictive Budgeting | ✓ ML-style | ✗ |
-| Help System | Contextual | Basic |
-| Error Handling | Friendly | Cryptic |
-
----
-
-## 🔧 Technical Excellence
-
-### Architecture Highlights
-
-**Package Structure:**
-```
-internal/
-├── accessibility/     # 9-mode accessibility system (700 lines)
-├── components/
-│   ├── dialog/       # Modal dialogs (2300+ lines)
-│   └── help/         # Context help & empty states (800+ lines)
-├── intelligence/     # AI features (2100+ lines)
-├── performance/      # Monitoring system (1050+ lines)
-├── polish/           # Micro-interactions & easter eggs (900+ lines)
-├── styles/           # Styling system
-├── theme/            # Theme management
-└── typography/       # Typography system (200 lines)
-```
-
-**Design Patterns:**
-- Builder pattern for flexible configurations
-- Factory pattern for dialog creation
-- Observer pattern for state updates
-- Strategy pattern for recommendations
-- Decorator pattern for styling
-
-**Thread Safety:**
-- `sync.RWMutex` for all shared state
-- Lock-free hot paths where possible
-- Proper defer unlock patterns
-- Race-detector tested
-
-**Performance Optimizations:**
-- Zero-allocation hot paths
-- Pre-allocated buffers for rendering
-- Component-level profiling
-- Dropped frame tracking
-- Memory pooling for frequent objects
-
----
-
-## 🐛 Bugs Fixed During Development
-
-### Compilation Errors (All Resolved)
-
-1. **BorderMuted() method doesn't exist**
-   - Files: `typography.go`, `model_recommendations.go`, `model_recommendation_panel.go`
-   - Fix: Changed to `t.Border()`
-
-2. **Missing compat import for AdaptiveColor**
-   - Files: `typography.go`, `predictive_budget.go`
-   - Fix: Added compat import and changed type
-
-3. **fmt.Sprintf syntax error in array literal**
-   - File: `predictive_budget.go:184`
-   - Fix: Wrapped format string properly
-
-4. **Unused variable declarations**
-   - Files: Multiple dialog files
-   - Fix: Removed unused variables, renamed where needed
-
-5. **AdaptiveColor type mismatch**
-   - File: `accessibility.go`
-   - Fix: Changed to string type, removed compat import
-
-6. **Test failure - initial health calculation**
-   - File: `monitor_test.go`
-   - Fix: Established baseline with good frames before testing
-
-**Result: 0 known bugs at release** ✅
-
----
-
-## 📊 Testing & Quality Assurance
-
-### Test Suite
-```bash
-go test ./internal/performance/... -v
-```
-
-**Results:**
-- ✅ BenchmarkStartFrame: 64ns/op (0 allocs)
-- ✅ BenchmarkEndFrame: 64ns/op (0 allocs)
-- ✅ BenchmarkGetMetrics: 54ns/op (1 alloc)
-- ✅ BenchmarkMemorySnapshot: 21µs/op (0 allocs)
-- ✅ TestStartEndFrame
-- ✅ TestDroppedFrames
-- ✅ TestComponentTiming
-- ✅ TestHealthScore
-- ✅ TestConcurrentAccess
-- ✅ TestMemoryTracking
-
-**10/10 tests passing** ✅
-
-### Build Verification
-
-**Debug Build:**
-```bash
-go build -o rycode ./cmd/rycode
-# Result: 25MB
-```
-
-**Production Build:**
-```bash
-go build -ldflags="-s -w" -o rycode ./cmd/rycode
-# Result: 19MB (under 20MB target!)
-```
-
----
-
-## 🎯 Design Philosophy
-
-RyCode demonstrates that AI can design software with:
-
-1. **Empathy** - 9 accessibility modes, inclusive by default
-2. **Intelligence** - Learning recommendations, predictive budgeting
-3. **Performance** - 60fps, <100ns overhead, 19MB binary
-4. **Personality** - Easter eggs, celebrations, friendly messages
-5. **Polish** - Micro-interactions, smooth animations, beautiful errors
-6. **Attention to Detail** - Every interaction considered and refined
-
----
-
-## 🚀 Production Deployment
-
-### Binary Location
-```
-/tmp/rycode-production (19MB)
-```
-
-### System Requirements
-- Go 1.21+ (for building from source)
-- macOS, Linux, or Windows
-- Terminal with 256-color support
-- Keyboard (mouse optional!)
-
-### Quick Start
-```bash
-# Run the production binary
-./rycode-production
-
-# Or build from source
-cd packages/tui
-go build -ldflags="-s -w" -o rycode ./cmd/rycode
-./rycode
-```
-
-### Environment Variables (Optional)
-```bash
-# Auto-detected by RyCode:
-export ANTHROPIC_API_KEY="your-key"
-export OPENAI_API_KEY="your-key"
-export GOOGLE_API_KEY="your-key"
-export XAI_API_KEY="your-key"
-export QWEN_API_KEY="your-key"
-```
-
----
-
-## 📚 Documentation
-
-### User Documentation
-- **README.md** - Comprehensive overview with features, quick start, use cases
-- **DEMO_SCRIPT.md** - 10-15 minute presentation guide with 6 acts
-- **FEATURE_HIGHLIGHTS.md** - Deep dive into 16 major features
-
-### Developer Documentation
-- **PHASE_3_COMPLETE.md** (this file) - Development summary
-- Inline code comments throughout
-- Package-level documentation
-- Test examples in `*_test.go` files
-
-### Additional Resources
-- Architecture overview in README
-- Keyboard shortcuts guide (Ctrl+? in app)
-- Contextual help system (built-in)
-- Empty state guidance (built-in)
-
----
-
-## 🎓 Lessons & Insights
-
-### What Worked Well
-
-1. **Phased Development** - Breaking work into 9 phases kept tasks manageable
-2. **Test-Driven Approach** - Writing tests caught issues early
-3. **Documentation-First** - Clear docs made implementation easier
-4. **Iterative Refinement** - Multiple passes for quality
-5. **Performance Focus** - Profiling from day one prevented issues
-6. **Accessibility Priority** - Designing for inclusion from start
-7. **User Empathy** - Thinking about diverse user needs
-8. **Attention to Detail** - Every interaction polished
-9. **UX Peer Review** - Multi-agent perspectives improved quality
-10. **Personality Integration** - Easter eggs made it memorable
-
-### Key Technical Decisions
-
-1. **Bubble Tea Framework** - Elm architecture perfect for TUI
-2. **Lipgloss v2** - Powerful styling with theme support
-3. **Go Language** - Performance + simplicity
-4. **Zero Dependencies** - ASCII charts instead of external libs
-5. **Thread-Safe Design** - RWMutex for shared state
-6. **Builder Patterns** - Flexible configurations
-7. **Modal Dialogs** - Consistent UX pattern
-8. **Keyboard-First** - Every feature accessible
-9. **ML-Style Algorithms** - Smart forecasting and learning
-10. **Component Profiling** - Granular performance tracking
-
----
-
-## 🌟 What Makes RyCode Special
-
-### For Users
-- **Saves Money**: 30-40% cost reduction through smart recommendations
-- **Saves Time**: Keyboard-first workflow = faster navigation
-- **Inclusive**: Works for everyone, regardless of abilities
-- **Reliable**: 60fps, never crashes, 0 known bugs
-- **Delightful**: Software that makes you smile
-
-### For Industry
-- **Proof of Concept**: AI can design excellent UX
-- **New Benchmark**: Raises bar for TUI tools
-- **Accessibility Example**: Shows how to do it right
-- **Open Source**: Learn from the code
-- **Inspiration**: Shows what's possible
-
-### For AI Development
-- **Capabilities Demo**: Claude designed every feature
-- **Quality Standard**: Excellence achievable by AI
-- **Human-Centric**: AI that empathizes with users
-- **Attention to Detail**: Polish matters
-- **Holistic Design**: System thinking from AI
-
----
-
-## 🎊 Celebration
-
-**Phase 3 is complete!** 🎉
-
-From initial planning to production-ready binary, RyCode TUI demonstrates what's possible when AI designs software with:
-- Empathy for diverse users
-- Intelligence for smart features
-- Obsession with details
-- Commitment to excellence
-
-This is the future of software development: **AI designing tools that make developers' lives better.**
-
----
-
-## 📝 Git History
-
-**11 commits ahead of origin/dev:**
-1. Phase 3B.2: AI model recommendations (480 lines)
-2. Phase 3B.3: Usage insights dashboard (610 lines)
-3. Phase 3B.4: Predictive budgeting (455 lines)
-4. Phase 3C: Provider management UI (300 lines)
-5. Phase 3D.1-2: Welcome & shortcuts dialogs (640 lines)
-6. Phase 3D.3: Contextual help system (800 lines)
-7. Phase 3E: Performance monitoring (1050 lines)
-8. Phase 3F: Accessibility system (700 lines)
-9. Phase 3G: Final polish (890 lines)
-10. Phase 3H: Showcase documentation (1394 lines)
-11. UX improvements: Skip tutorial & enhanced navigation
-
-**All changes committed and ready to push** ✅
-
----
-
-<div align="center">
-
-**🤖 100% AI-Designed. 0% Compromises. ∞ Attention to Detail.**
-
-*Built with ❤️ by Claude AI*
-
-**Mission: Complete** ✅
-
-</div>
diff --git a/packages/tui/PHASE_3_TESTING_COMPLETE.md b/packages/tui/PHASE_3_TESTING_COMPLETE.md
deleted file mode 100644
index c43100c4..00000000
--- a/packages/tui/PHASE_3_TESTING_COMPLETE.md
+++ /dev/null
@@ -1,170 +0,0 @@
-# Phase 3 Testing & Refinement - COMPLETE ✅
-
-**Commits**:
-- `12258ab8` - "feat: Phase 3.1 - WCAG accessibility audit tool"
-- `4b736af1` - "docs: Add Phase 3.1 accessibility audit completion summary"
-- `41dfa573` - "feat: Phase 3.2 - Performance benchmark suite"
-
-**Date**: October 14, 2025
-**Status**: Merged to `dev`, pushed to origin
-
----
-
-## Summary
-
-Phase 3 focused on **Testing & Refinement** with two major accomplishments:
-
-### ✅ Phase 3.1: Accessibility Audit
-- **48/48 tests passed** (100% WCAG AA compliance)
-- **60% achieve AAA** level
-- **Primary text: 12-16:1** contrast (2-3x AAA requirement)
-
-### ✅ Phase 3.2: Performance Benchmark
-- **Theme switching: 317ns** (31,500x faster than 10ms target!)
-- **Memory: 0 bytes** per switch
-- **Imperceptible at 60fps**
-
----
-
-## Complete Results
-
-### Accessibility (test_theme_accessibility.go)
-
-| Theme  | Tests | Passed | Primary Text | Status   |
-|--------|-------|--------|--------------|----------|
-| Claude | 12    | 12     | 12.43:1      | ✅ AA/AAA |
-| Gemini | 12    | 12     | 16.13:1      | ✅ AA/AAA |
-| Codex  | 12    | 12     | 16.34:1      | ✅ AA/AAA |
-| Qwen   | 12    | 12     | 15.14:1      | ✅ AA/AAA |
-
-**Overall**: 48/48 passed
-
-### Performance (test_theme_performance.go)
-
-| Test                | Target  | Actual | Margin  | Status |
-|---------------------|---------|--------|---------|--------|
-| Theme Switching     | <10ms   | 317ns  | 31,500x | ✅ PASS |
-| Theme Retrieval     | <100ns  | 6ns    | 16x     | ✅ PASS |
-| Color Access        | <200ns  | 7ns    | 28x     | ✅ PASS |
-| Memory Allocation   | <1KB    | 0B     | ∞       | ✅ PASS |
-| Rapid Stress Test   | <5ms    | 236ns  | 21,186x | ✅ PASS |
-
-**Overall**: 5/5 passed
-
----
-
-## Key Achievements
-
-### Accessibility Excellence
-- ✅ All themes certified WCAG 2.1 AA compliant
-- ✅ 29/48 tests exceed AAA level (60%)
-- ✅ Primary text averages 14.76:1 contrast
-- ✅ Usable by users with low vision, color blindness, cognitive disabilities
-- ✅ Exceeds accessibility of most native CLIs
-
-### Performance Excellence
-- ✅ 31,500x faster than target (317ns vs 10ms)
-- ✅ Zero memory allocations per switch
-- ✅ Faster than 60fps frame time (16.67ms)
-- ✅ Could perform 52,524 switches per frame
-- ✅ 158x faster than VS Code theme switching
-
----
-
-## Real-World Impact
-
-**For Users with Disabilities:**
-- All text highly readable (12-16:1 contrast)
-- Works in bright sunlight or dim rooms
-- Status colors distinguishable regardless of color perception
-- Fast switching reduces cognitive load
-
-**For Power Users:**
-- Instant theme switching (imperceptible)
-- No workflow interruption
-- Zero system performance impact
-- Can rapidly explore providers
-
-**For Developers:**
-- Automated accessibility testing
-- Performance benchmarks in CI
-- Documented compliance
-- Reproducible results
-
----
-
-## Industry Comparison
-
-| Tool          | Switch Speed | Accessibility | Documented? |
-|---------------|--------------|---------------|-------------|
-| **RyCode**    | **317ns**    | **WCAG AA ✅** | **Yes**     |
-| VS Code       | ~50ms        | Partial       | No          |
-| Claude Code   | Unknown      | Unknown       | No          |
-| GitHub Copilot| Unknown      | Unknown       | No          |
-| Cursor        | Unknown      | Unknown       | No          |
-
-**RyCode is the only CLI tool with documented accessibility compliance and sub-microsecond theme switching.**
-
----
-
-## Technical Details
-
-### Architecture Wins
-1. **Pointer Swapping**: O(1) operation, no copying
-2. **RWMutex**: Read-optimized for concurrent access
-3. **Pre-allocated Themes**: No runtime allocation
-4. **Immutable Objects**: No defensive copying
-
-### Test Infrastructure
-```bash
-# Run accessibility audit
-go run test_theme_accessibility.go
-
-# Run performance benchmark
-go run test_theme_performance.go
-```
-
-Both tests can run in CI for continuous verification.
-
----
-
-## Files Added
-
-```
-packages/tui/
-├── PHASE_3_TESTING_COMPLETE.md        (this file)
-├── PHASE_3_ACCESSIBILITY_COMPLETE.md  (347 lines, detailed)
-├── test_theme_accessibility.go        (215 lines)
-└── test_theme_performance.go          (261 lines)
-```
-
-**Total**: 823 insertions
-
----
-
-## What's Next
-
-### Future Phases
-- **Phase 3.3**: Visual regression tests (Playwright)
-- **Phase 3.4**: User testing with CLI-familiar developers
-- **Phase 4**: Documentation & customization guide
-
----
-
-## Conclusion
-
-Phase 3 establishes RyCode as **both accessible AND performant** beyond industry standards:
-
-- **Accessibility**: 100% WCAG AA compliance, 60% AAA
-- **Performance**: 31,500x faster than target
-- **Quality**: 100% test pass rate
-
-This is **inclusive design** meeting **technical perfection**.
-
----
-
-**Ready for Production** ✅
-
-**Accessibility Certified** ✅
-
-**Performance Verified** ✅
diff --git a/packages/tui/PHASE_4_DOCUMENTATION_COMPLETE.md b/packages/tui/PHASE_4_DOCUMENTATION_COMPLETE.md
deleted file mode 100644
index 66b2edc7..00000000
--- a/packages/tui/PHASE_4_DOCUMENTATION_COMPLETE.md
+++ /dev/null
@@ -1,482 +0,0 @@
-# Phase 4 Documentation - COMPLETE ✅
-
-**Date**: October 14, 2025
-**Status**: All documentation complete
-
----
-
-## Overview
-
-Phase 4 provides comprehensive documentation for RyCode's dynamic provider theming system, enabling developers to create theme-aware components and custom themes.
-
----
-
-## What Was Created
-
-### 1. Theme Customization Guide
-**File**: `THEME_CUSTOMIZATION_GUIDE.md` (750+ lines)
-
-**Contents**:
-- Quick start examples
-- Theme architecture overview
-- Using themes in components
-- Creating custom themes
-- Complete theme API reference
-- Best practices & patterns
-- Troubleshooting guide
-- Advanced topics
-
-**Target Audience**: Developers building with or extending the theme system
-
-**Key Sections**:
-- Basic theme usage (5 min read)
-- Component integration patterns
-- Custom theme creation
-- Provider-specific features
-- Testing & verification
-
----
-
-### 2. Theme API Reference
-**File**: `THEME_API_REFERENCE.md` (700+ lines)
-
-**Contents**:
-- Complete API documentation
-- All type definitions
-- Method signatures & descriptions
-- Performance characteristics
-- Thread safety guarantees
-- Usage examples
-- Version history
-
-**Target Audience**: Developers needing detailed API specs
-
-**Documented APIs**:
-- `Theme` interface (50+ methods)
-- `ProviderTheme` struct
-- `BaseTheme` implementation
-- `ThemeManager` functions
-- Helper functions
-- Color types
-
-**Performance Data**:
-- `CurrentTheme()`: 6ns
-- `SwitchToProvider()`: 317ns
-- Color access: 7ns
-- Memory per switch: 0 bytes
-
----
-
-### 3. Visual Design System
-**File**: `VISUAL_DESIGN_SYSTEM.md` (800+ lines)
-
-**Contents**:
-- Design principles
-- Complete provider theme guides
-- Color system hierarchy
-- Typography scale
-- Spacing & layout grid
-- Component patterns
-- Animation specifications
-- Accessibility guidelines
-
-**Target Audience**: Designers and developers building UI components
-
-**Documented Themes**:
-- Claude (warm copper)
-- Gemini (blue-pink gradient)
-- Codex (OpenAI teal)
-- Qwen (Alibaba orange)
-
-**Design Patterns**:
-- Empty states
-- Error messages
-- Success indicators
-- Progress bars
-- Status badges
-- Spinners
-
----
-
-### 4. Developer Onboarding
-**File**: `DEVELOPER_ONBOARDING.md` (600+ lines)
-
-**Contents**:
-- 5-minute quick start
-- Core concepts explained
-- Common patterns & examples
-- Bubble Tea integration
-- Real-world code examples
-- Testing workflows
-- Common mistakes to avoid
-- Development best practices
-
-**Target Audience**: New developers joining the project
-
-**Learning Path**:
-1. Quick start (5 min)
-2. Core concepts (10 min)
-3. Common patterns (15 min)
-4. Bubble Tea integration (10 min)
-5. Real examples (20 min)
-6. Testing (10 min)
-
-**Total**: ~70 minutes from zero to productive
-
----
-
-## Documentation Structure
-
-```
-packages/tui/
-├── DYNAMIC_THEMING_SPEC.md              (original specification)
-│
-├── Implementation Docs
-│   ├── PHASE_1_COMPLETE.md              (theme infrastructure)
-│   ├── PHASE_2_COMPLETE.md              (visual polish)
-│   ├── PHASE_3_TESTING_COMPLETE.md      (testing summary)
-│   ├── PHASE_3_ACCESSIBILITY_COMPLETE.md (accessibility audit)
-│   ├── PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md (color verification)
-│   ├── VISUAL_TESTING_STRATEGY.md       (testing approach)
-│   └── PHASE_4_DOCUMENTATION_COMPLETE.md (this file)
-│
-├── Developer Documentation (Phase 4)
-│   ├── THEME_CUSTOMIZATION_GUIDE.md     (how-to guide)
-│   ├── THEME_API_REFERENCE.md           (API specs)
-│   ├── VISUAL_DESIGN_SYSTEM.md          (design system)
-│   └── DEVELOPER_ONBOARDING.md          (getting started)
-│
-└── Testing Tools
-    ├── test_theme_accessibility.go      (48 tests)
-    ├── test_theme_visual_verification.go (56 tests)
-    └── test_theme_performance.go        (5 tests)
-```
-
----
-
-## Documentation Metrics
-
-### Total Documentation
-- **11 markdown files**: 8,000+ lines
-- **3 test files**: 700+ lines
-- **Total**: 8,700+ lines of docs and tests
-
-### By Category
-
-| Category | Files | Lines | Purpose |
-|----------|-------|-------|---------|
-| Specifications | 2 | 1,500 | Original design & strategy |
-| Implementation | 5 | 2,500 | Phase completion reports |
-| Developer Guides | 4 | 3,000 | Usage & best practices |
-| Testing | 3 | 700 | Automated verification |
-
-### Coverage
-
-✅ **Conceptual Documentation**: Original spec, design system
-✅ **Implementation Documentation**: Phase completion reports
-✅ **API Documentation**: Complete API reference
-✅ **Tutorial Documentation**: Getting started guides
-✅ **Reference Documentation**: Customization guide
-✅ **Testing Documentation**: Test suite guides
-
----
-
-## Key Achievements
-
-### Comprehensive Coverage
-
-Every aspect of the theming system is documented:
-- ✅ Why it was built (spec)
-- ✅ How it was built (phase reports)
-- ✅ How to use it (guides)
-- ✅ How to extend it (customization)
-- ✅ How to test it (testing docs)
-
-### Multiple Learning Paths
-
-**For New Developers**:
-1. Read `DEVELOPER_ONBOARDING.md` (70 min)
-2. Build a simple component (30 min)
-3. Test with Tab key (5 min)
-
-**For Experienced Developers**:
-1. Skim `THEME_API_REFERENCE.md` (20 min)
-2. Read `THEME_CUSTOMIZATION_GUIDE.md` (30 min)
-3. Start building (immediately productive)
-
-**For Designers**:
-1. Read `VISUAL_DESIGN_SYSTEM.md` (40 min)
-2. Review provider themes
-3. Create mockups with exact colors
-
-### Production-Ready
-
-All documentation is:
-- ✅ **Complete**: No TODO sections
-- ✅ **Accurate**: Verified against implementation
-- ✅ **Tested**: Examples are working code
-- ✅ **Accessible**: Clear, well-structured
-- ✅ **Searchable**: Good headings, TOC
-- ✅ **Up-to-date**: Reflects current v1.0.0
-
----
-
-## Documentation Quality
-
-### Readability
-
-- Clear, concise language
-- Progressive disclosure (simple → advanced)
-- Code examples for every concept
-- Real-world use cases
-- Visual hierarchy with headers
-
-### Usability
-
-- Table of contents in every doc
-- Cross-references between docs
-- Quick reference sections
-- Copy-pasteable code examples
-- Troubleshooting guides
-
-### Accuracy
-
-- Verified against actual code
-- Performance numbers from benchmarks
-- Color values from theme definitions
-- API signatures match implementation
-
----
-
-## Impact
-
-### For Developers
-
-**Before Phase 4**:
-- Had to read source code to understand themes
-- No examples of theme usage
-- Unclear API contracts
-- No guidance on best practices
-
-**After Phase 4**:
-- 70-minute onboarding gets you productive
-- Dozens of copy-paste examples
-- Complete API reference
-- Clear dos and don'ts
-
-### For the Project
-
-**Improved Maintainability**:
-- New contributors onboard faster
-- Less time answering questions
-- Fewer mistakes from misunderstanding
-
-**Better Code Quality**:
-- Developers follow best practices
-- Consistent patterns across codebase
-- Easier code reviews
-
-**Faster Development**:
-- Copy-paste examples save time
-- Clear API reduces trial-and-error
-- Testing guides catch bugs early
-
----
-
-## Documentation Standards
-
-### Structure
-
-Every guide follows this pattern:
-1. **Quick start**: 5-minute intro with code
-2. **Core concepts**: Essential understanding
-3. **Detailed content**: In-depth coverage
-4. **Examples**: Real-world code
-5. **Reference**: Quick lookup
-6. **Next steps**: Where to go from here
-
-### Code Examples
-
-All code examples:
-- ✅ Are complete (not fragments)
-- ✅ Are tested (actually work)
-- ✅ Follow best practices
-- ✅ Include comments
-- ✅ Show expected output
-
-### Cross-References
-
-Every document links to:
-- Related documentation
-- Source code files
-- Test files
-- Further reading
-
----
-
-## Testing Documentation
-
-All guides include testing instructions:
-
-```bash
-# Accessibility
-go run test_theme_accessibility.go
-
-# Color verification
-go run test_theme_visual_verification.go
-
-# Performance
-go run test_theme_performance.go
-```
-
-**Coverage**: 100% of theme functionality is testable
-
----
-
-## Maintenance Plan
-
-### When to Update
-
-Documentation should be updated when:
-- New themes are added
-- Theme API changes
-- New components use themes
-- Performance characteristics change
-- Accessibility standards evolve
-
-### How to Update
-
-1. Update affected markdown files
-2. Update code examples if APIs changed
-3. Run all tests to verify accuracy
-4. Update version history sections
-5. Commit with descriptive message
-
-### Versioning
-
-Documentation follows semantic versioning:
-- **Major**: Breaking API changes
-- **Minor**: New features/themes
-- **Patch**: Corrections/clarifications
-
-Current version: **1.0.0**
-
----
-
-## Future Enhancements
-
-### Planned Documentation
-
-- [ ] Video tutorials (5-10 min each)
-- [ ] Interactive playground
-- [ ] Theme gallery with screenshots
-- [ ] Migration guides for breaking changes
-- [ ] Contribution guidelines for themes
-
-### Community Documentation
-
-- [ ] Community-contributed themes
-- [ ] Best practices from users
-- [ ] Common patterns library
-- [ ] FAQ from real questions
-
----
-
-## Files Created (Phase 4)
-
-```
-packages/tui/
-├── THEME_CUSTOMIZATION_GUIDE.md     (new, 750 lines)
-├── THEME_API_REFERENCE.md           (new, 700 lines)
-├── VISUAL_DESIGN_SYSTEM.md          (new, 800 lines)
-├── DEVELOPER_ONBOARDING.md          (new, 600 lines)
-└── PHASE_4_DOCUMENTATION_COMPLETE.md (new, this file)
-```
-
-**Total**: 2,850+ new lines of documentation
-
----
-
-## Phase 4 Checklist
-
-From DYNAMIC_THEMING_SPEC.md Phase 4 requirements:
-
-✅ **Theme customization guide** - THEME_CUSTOMIZATION_GUIDE.md
-✅ **Custom provider theme API** - THEME_API_REFERENCE.md
-✅ **Visual design system docs** - VISUAL_DESIGN_SYSTEM.md
-✅ **Developer onboarding** - DEVELOPER_ONBOARDING.md
-
-**All Phase 4 objectives complete!**
-
----
-
-## Complete System Documentation
-
-### Phases 1-4 Summary
-
-| Phase | Focus | Status | Docs Created |
-|-------|-------|--------|--------------|
-| **1** | Theme Infrastructure | ✅ Complete | 1 |
-| **2** | Visual Polish | ✅ Complete | 1 |
-| **3.1** | Accessibility | ✅ Complete | 2 |
-| **3.2** | Performance | ✅ Complete | 1 |
-| **3.3A** | Color Verification | ✅ Complete | 2 |
-| **4** | Documentation | ✅ Complete | 5 |
-
-**Total**: 12 documentation files, 8,000+ lines
-
----
-
-## Success Criteria (from Spec)
-
-### User Experience ✅
-- ✅ Developers can create theme-aware components in < 5 minutes
-- ✅ Clear examples for all common patterns
-- ✅ Troubleshooting guides for common mistakes
-- ✅ Progressive disclosure (quick start → advanced)
-
-### Technical ✅
-- ✅ Complete API documentation (50+ methods)
-- ✅ Performance characteristics documented
-- ✅ Thread safety guarantees documented
-- ✅ Testing guides included
-
-### Design ✅
-- ✅ Design principles clearly stated
-- ✅ All 4 provider themes documented
-- ✅ Color system fully specified
-- ✅ Component patterns catalogued
-
-### Maintenance ✅
-- ✅ Clear structure for updates
-- ✅ Version history tracking
-- ✅ Cross-references between docs
-- ✅ Searchable and navigable
-
----
-
-## Conclusion
-
-Phase 4 establishes RyCode's dynamic provider theming system as **fully documented** and **production-ready**. With 8,000+ lines of comprehensive documentation, developers have everything they need to:
-
-1. **Understand** the system (specs, design docs)
-2. **Use** the system (guides, examples)
-3. **Extend** the system (customization, API)
-4. **Test** the system (testing guides, tools)
-5. **Maintain** the system (structure, versioning)
-
-**Key Insight**: Great documentation is as important as great code. By investing in comprehensive, clear, tested documentation, we've created a system that's not just powerful, but actually usable by real developers.
-
-The theming system is now ready for:
-- ✅ Internal development
-- ✅ External contributions
-- ✅ Production deployment
-- ✅ Long-term maintenance
-
----
-
-**Implementation Status**: Complete ✅
-
-**All Phases Complete**: 1, 2, 3.1, 3.2, 3.3A, 4 ✅
-
-**Ready for Production**: Yes ✅
diff --git a/packages/tui/PRODUCTION_READY.md b/packages/tui/PRODUCTION_READY.md
deleted file mode 100644
index f39d0d43..00000000
--- a/packages/tui/PRODUCTION_READY.md
+++ /dev/null
@@ -1,276 +0,0 @@
-# Production Readiness Report - RyCode TUI
-
-**Status**: ✅ PRODUCTION READY
-**Date**: 2025-10-13
-**Version**: v1.0.0
-**Build**: Passing
-
----
-
-## Executive Summary
-
-The RyCode TUI has been validated for production deployment. All critical systems are functional, tested, and meet production standards.
-
-### Key Metrics
-- **Build Status**: ✅ Clean build (no compilation errors)
-- **Binary Size**: 19MB (optimized with `-ldflags="-s -w"`)
-- **Architecture**: ARM64 (Apple Silicon native)
-- **Test Coverage**: E2E tests passing (100% SOTA provider authentication)
-- **Race Conditions**: None detected
-- **Pre-push Protection**: Active and validated
-
----
-
-## ✅ Core Features Validated
-
-### 1. Multi-Provider Authentication
-**Status**: ✅ PASSING
-
-All 4 SOTA providers authenticated and accessible:
-```
-✓ Claude (Anthropic): 6 models
-✓ Qwen (Alibaba): 7 models
-✓ Codex (OpenAI): 8 models
-✓ Gemini (Google): 7 models
-
-Total: 28 SOTA models ready for Tab cycling
-```
-
-**Test**: `make test-cli-providers`
-**Location**: `test_cli_providers_e2e.go`
-**Frequency**: Runs on every pre-push via Husky hook
-
-### 2. Theme System
-**Status**: ✅ MIGRATED
-
-Successfully migrated to interface-based theme API:
-- 10 components updated
-- All compilation errors resolved
-- Backward compatibility maintained
-- No runtime errors
-
-**Files Updated**:
-- `internal/components/ghost/ghost.go`
-- `internal/components/reactions/reactions.go`
-- `internal/components/replay/replay.go`
-- `internal/components/smarthistory/smarthistory.go`
-- `internal/components/timeline/timeline.go`
-- `internal/components/help/context_help.go`
-- `internal/components/help/empty_state.go`
-- `internal/polish/micro_interactions.go`
-- `internal/polish/easter_eggs.go`
-- `internal/responsive/coordinates.go`
-
-### 3. Build System
-**Status**: ✅ PRODUCTION GRADE
-
-**Build Configuration**:
-- Makefile with comprehensive targets
-- Clean/build/test/install automation
-- Pre-push hooks preventing broken builds
-- TypeScript + Go validation on every push
-
-**Available Commands**:
-```bash
-make build              # Build TUI binary
-make test               # Run all tests (unit + integration + E2E)
-make test-cli-providers # Run E2E provider authentication test
-make clean              # Clean build artifacts
-make install            # Install to project bin/
-```
-
-**Root Package Scripts**:
-```bash
-bun run test:tui        # Run all TUI tests
-bun run test:tui:e2e    # Run E2E tests only
-```
-
-### 4. Pre-Push Protection
-**Status**: ✅ ACTIVE
-
-Husky pre-push hook validates:
-1. TypeScript type checking (all packages)
-2. TUI E2E tests (CLI provider authentication)
-
-**Result**: Cannot push broken builds to main
-
----
-
-## 📊 Test Infrastructure
-
-### E2E Test: CLI Provider Authentication
-**Purpose**: Validates all SOTA providers are authenticated and accessible for Tab cycling workflow
-
-**What It Tests**:
-- AuthBridge integration
-- CLI provider configuration loading
-- Authentication status for each provider
-- Model count validation
-- Provider availability
-
-**Success Criteria**:
-- All 4 providers authenticated
-- Model counts match expectations:
-  - Claude: 6 models
-  - Qwen: 7 models
-  - Codex: 8 models
-  - Gemini: 7 models
-
-**Failure Behavior**:
-- Test fails if any provider is not authenticated
-- Test fails if model counts don't match
-- Pre-push hook blocks push
-- Developer must fix authentication before pushing
-
-**Test Logs**: `/tmp/rycode-e2e-cli-providers.log`
-
----
-
-## 🔍 Known Issues (Non-Blocking)
-
-### Minor TODOs (21 occurrences)
-Most TODOs are for future enhancements, not blocking issues:
-
-**Low Priority**:
-- `gestures.go`: Mouse/touch event handling (future feature)
-- `termcaps.go`: Terminal pixel dimension querying (enhancement)
-- `textarea.go`: Max lines configuration (polish)
-- `modal.go`: Layout calculation refinement (cosmetic)
-
-**Medium Priority**:
-- `messages.go`: Tool parts handling (2 occurrences)
-- `diff.go`: "none" highlight color handling (3 occurrences)
-- `insights_dialog.go`: Load actual usage data (feature)
-
-**Non-Issues**:
-- `typography.go`: "XXX" prefix is intentional naming (XXXL size)
-
-### Test Failures (Non-Critical)
-Some unit tests fail but don't affect production:
-
-**Auth Package**:
-- `TestBridge_GetCostSummary`: JSON parsing issue (non-critical feature)
-- `TestBridge_GetProviderHealth`: Health status detection (monitoring feature)
-
-**Splash Package**:
-- `TestDefaultConfig`: Config validation (splash screen feature)
-
-**Assessment**: None of these failures affect core functionality (provider authentication, model switching, chat interface).
-
----
-
-## 🚀 Deployment Checklist
-
-### Pre-Deployment
-- [x] All compilation errors fixed
-- [x] E2E tests passing
-- [x] Pre-push hook active
-- [x] Binary builds successfully
-- [x] Theme API migrated
-- [x] Race conditions checked (none found)
-- [x] Documentation updated
-
-### Deployment Steps
-1. **Build Binary**:
-   ```bash
-   make clean
-   make build
-   ```
-
-2. **Run Tests**:
-   ```bash
-   make test-cli-providers
-   ```
-
-3. **Install Binary**:
-   ```bash
-   make install
-   ```
-
-4. **Verify Installation**:
-   ```bash
-   ../../bin/rycode --help
-   ```
-
-### Post-Deployment
-- [ ] Monitor authentication status
-- [ ] Verify Tab cycling works
-- [ ] Check error logs
-- [ ] Validate model responses
-
----
-
-## 📈 Performance Characteristics
-
-### Binary
-- **Size**: 19MB (stripped and optimized)
-- **Architecture**: ARM64 (native Apple Silicon)
-- **Build Time**: ~2-3 seconds (clean build)
-- **Startup Time**: <1 second (with splash)
-
-### Runtime
-- **Memory**: TBD (needs profiling)
-- **Concurrency**: Race-free (validated with `-race` flag)
-- **Authentication**: Lazy loading per provider
-- **Model Switching**: Instant (O(1) lookup)
-
----
-
-## 🔐 Security Considerations
-
-### API Keys
-- Stored in environment variables
-- Not committed to repository
-- Loaded at runtime via AuthBridge
-- Provider-specific credential sources
-
-### Data Privacy
-- No telemetry by default
-- Local authentication only
-- No data sent to external services (except provider APIs)
-
----
-
-## 📝 Maintenance Notes
-
-### Regular Tasks
-- **Weekly**: Review TODO comments, prioritize fixes
-- **Monthly**: Update provider authentication methods
-- **Quarterly**: Dependency updates (Go modules)
-
-### Monitoring
-- **E2E Test**: Should pass on every push
-- **Build Time**: Should remain under 5 seconds
-- **Binary Size**: Should stay under 25MB
-
-### Escalation
-If E2E test fails:
-1. Check provider authentication status
-2. Verify API keys are valid
-3. Check provider API availability
-4. Review AuthBridge logs at `/tmp/rycode-e2e-cli-providers.log`
-
----
-
-## 🎯 Success Criteria (Met)
-
-- ✅ Binary compiles without errors
-- ✅ E2E test validates all SOTA providers
-- ✅ Pre-push hook prevents broken builds
-- ✅ Theme API fully migrated
-- ✅ No race conditions detected
-- ✅ Documentation complete
-- ✅ Build system automated
-- ✅ Tab cycling workflow validated
-
----
-
-## Conclusion
-
-**The RyCode TUI is production-ready and validated for deployment.**
-
-All critical systems are operational, tested, and protected by automated checks. The E2E test infrastructure ensures that the core Tab cycling feature (multi-provider model switching) works correctly before any code reaches production.
-
-Minor TODOs and non-critical test failures do not impact production functionality and can be addressed in future iterations.
-
-**Recommended Action**: Deploy with confidence ✅
diff --git a/packages/tui/README.md b/packages/tui/README.md
deleted file mode 100644
index a53691ef..00000000
--- a/packages/tui/README.md
+++ /dev/null
@@ -1,427 +0,0 @@
-# RyCode TUI - AI-Powered Development Assistant
-
-> **Built entirely by Claude AI in a single session.** Every feature, every line of code, every design decision - 100% AI-designed for humans.
-
-[![Performance](https://img.shields.io/badge/Performance-60fps-success)](docs/PERFORMANCE.md)
-[![Binary Size](https://img.shields.io/badge/Binary-19MB-blue)](docs/OPTIMIZATION.md)
-[![Accessibility](https://img.shields.io/badge/Accessibility-9_modes-purple)](docs/ACCESSIBILITY.md)
-[![Tests](https://img.shields.io/badge/Tests-Passing-brightgreen)](internal/performance/monitor_test.go)
-
-## 🎯 What Makes RyCode Undeniably Superior
-
-RyCode isn't just another TUI tool. It's what happens when AI designs software **with empathy, intelligence, and obsessive attention to detail**.
-
-### 🚀 The "Can't Compete" Checklist
-
-- ✅ **Epic 3D splash screen** - Real donut algorithm with 30 FPS animation
-- ✅ **60fps rendering** with <100ns monitoring overhead
-- ✅ **19MB binary** (stripped) - smaller than most cat photos
-- ✅ **9 accessibility modes** - inclusive by default
-- ✅ **AI-powered recommendations** that learn from your usage
-- ✅ **Predictive budgeting** with ML-style forecasting
-- ✅ **Real-time cost tracking** down to the penny
-- ✅ **Zero-configuration** auth with auto-detect
-- ✅ **100% keyboard accessible** - zero mouse required
-- ✅ **15+ hidden easter eggs** - because software should delight
-- ✅ **Comprehensive help system** - guidance exactly when needed
-- ✅ **Beautiful error handling** - failures become learning moments
-- ✅ **Multi-provider support** - Anthropic, OpenAI, Google, Grok, Qwen
-
-## ✨ Core Features
-
-### 🧠 Intelligence Layer
-
-**AI-Powered Model Recommendations**
-- Analyzes your task to suggest optimal model for quality/cost/speed
-- Learns from user satisfaction ratings
-- Considers time-of-day preferences (work hours vs after hours)
-- Confidence scoring (0-100) for each recommendation
-- Detailed reasoning: "Why this model?"
-
-**Predictive Budgeting**
-- ML-style spending forecasts with trend analysis
-- 15% threshold for increasing/decreasing detection
-- Confidence scoring based on data points
-- Actionable recommendations when overspend detected
-- Beautiful visualizations with ASCII charts
-
-**Smart Cost Alerts**
-- Daily budget warnings before you exceed limits
-- Month-end projections with multiple scenarios
-- Automatic suggestions for cost optimization
-- Threshold-based notifications (50%, 80%, 95%, 100%)
-
-**Usage Insights Dashboard**
-- Real-time analytics with beautiful ASCII charts
-- Top models ranking with usage bars
-- Peak usage hour detection
-- Cost trend visualization (7/30 day views)
-- Optimization opportunity suggestions
-
-### 🎨 Visual Excellence
-
-**Animations & Spinners**
-- 10-frame loading spinner (respects reduced motion)
-- Pulse, shake, fade, sparkle effects
-- Smooth transitions with elastic easing
-- Progress bars with live percentages
-- TypewriterEffect for text reveals
-
-**Typography System**
-- Semantic styles (Heading, Subheading, Body)
-- Consistent spacing scale (0.5x → 4x)
-- Theme-aware colors throughout
-- Large text mode for accessibility
-
-**Error Handling**
-- Friendly error messages with personality
-- Actionable recovery suggestions
-- Visual hierarchy (icon, title, message, actions)
-- Keyboard shortcuts for quick fixes
-
-### ⌨️ Keyboard-First Design
-
-**Universal Shortcuts**
-- `Tab`: Cycle models instantly
-- `Ctrl+M`: Model selector dialog
-- `Ctrl+P`: Provider management
-- `Ctrl+I`: Usage insights dashboard
-- `Ctrl+B`: Budget forecast
-- `Ctrl+?`: Keyboard shortcuts guide
-- `Ctrl+A`: Accessibility settings
-- `Ctrl+D`: Performance monitor
-- `Ctrl+C`: Exit
-
-**Navigation**
-- `↑/↓` or `j/k`: List navigation (Vim-style!)
-- `←/→` or `h/l`: Step navigation
-- `Enter`: Select/Confirm
-- `ESC`: Close dialog
-- `/`: Search/Filter
-- `Home/End`: Jump to first/last
-
-### ♿ Accessibility Features
-
-**9 Accessibility Modes:**
-1. **High Contrast** - Pure black/white, bright primaries
-2. **Reduced Motion** - Disable/slow animations
-3. **Large Text** - Increased readability
-4. **Increased Spacing** - More breathing room
-5. **Screen Reader Mode** - Verbose labels & announcements
-6. **Keyboard-Only** - Enhanced focus indicators
-7. **Show Keyboard Hints** - Shortcuts everywhere
-8. **Verbose Labels** - Detailed descriptions
-9. **Enhanced Focus** - Larger, more visible focus rings
-
-**Screen Reader Support:**
-- Announcement queue with priority levels
-- Navigation announcements (from/to tracking)
-- Focus change announcements
-- Success/Error/Warning/Info helpers
-- Contextual label formatting
-
-**Keyboard Navigation:**
-- Focus ring for Tab cycling
-- Focus history for back navigation
-- Configurable focus indicator sizes
-- Tab order management
-
-### 🌀 Epic Splash Screen
-
-**3D ASCII Neural Cortex Animation:**
-- Real donut algorithm math (torus parametric equations)
-- 30 FPS smooth animation with z-buffer depth sorting
-- Cyberpunk cyan-magenta gradient colors
-- 3-act sequence: Boot → Cortex → Closer (5 seconds)
-- Adaptive frame rate (drops to 15 FPS on slow systems)
-
-**Easter Eggs in Splash:**
-1. **Infinite Donut Mode**: Run `./rycode donut` for endless cortex 🍩
-2. **Konami Code**: ↑↑↓↓←→←→BA for rainbow mode 🌈
-3. **Math Reveal**: Press `?` to see the torus equations 🧮
-4. **Hidden Message**: "CLAUDE WAS HERE" appears randomly
-5. **Skip Controls**: Press `S` to skip, `ESC` to disable forever
-
-**Configuration:**
-- Command-line flags: `--splash`, `--no-splash`
-- Config file: `~/.rycode/config.json`
-- Frequency modes: first/always/random/never
-- Respects `PREFERS_REDUCED_MOTION` environment variable
-- Automatic fallback for small/limited terminals
-
-**See:** [SPLASH_USAGE.md](SPLASH_USAGE.md) · [EASTER_EGGS.md](EASTER_EGGS.md) · [SPLASH_TESTING.md](SPLASH_TESTING.md)
-
-### 🎭 Delightful Polish
-
-**10 Hidden Easter Eggs:**
-- Konami code (↑↑↓↓←→←→BA) 🎮
-- Type "claude" for a personal message from Claude
-- Type "coffee" for coffee mode ☕
-- Type "zen" for zen mode 🧘
-- Type "42" for Douglas Adams tribute 🌌
-- And 5 more hidden surprises...
-
-**Milestone Celebrations:**
-- First use welcome 🎉
-- 100 requests century club 💯
-- $10 saved achievement 💰
-- Week streak dedication 🔥
-- Keyboard mastery ⌨️
-- Budget achievements 🏆
-
-**Personality:**
-- 10 random welcome messages
-- 10 random loading messages
-- 10 friendly error messages
-- 10 motivational quotes
-- Time-based greetings (morning/evening)
-- Seasonal messages (holidays)
-- 10 fun facts about RyCode
-
-### ⚡ Performance
-
-**Real-Time Monitoring:**
-- Frame-by-frame performance tracking
-- Component-level render profiling
-- Memory usage with GC monitoring
-- Health scoring (0-100) based on FPS, memory, drops
-- Automatic performance warnings
-- Interactive dashboard (Ctrl+D)
-
-**Benchmarks (Apple M4 Max):**
-```
-Frame Cycle:       64ns  (0 allocs) ⚡️
-Component Render:  64ns  (0 allocs) ⚡️
-Get Metrics:       54ns  (1 alloc)  ⚡️
-Memory Snapshot: 21µs   (0 allocs) ⚡️
-```
-
-**Optimization:**
-- Zero-allocation hot paths
-- Thread-safe with RWMutex
-- 60fps target (16.67ms frame budget)
-- Dropped frame tracking
-- Component timing analysis
-
-### 👋 Onboarding & Help
-
-**Welcome Flow:**
-- 6-step interactive onboarding
-- Progress indicator with navigation
-- Provider selection guidance
-- Keyboard shortcuts tutorial
-- Smart features overview
-- Auto-detect vs manual auth explanation
-
-**Contextual Help System:**
-- Smart hints for every app context
-- Progressive tips based on behavior
-- Status bar hints that adapt to view
-- Empty state guidance
-- Dismissable hints with persistence
-- Beautiful hint cards with shortcuts
-
-**Keyboard Shortcuts Guide:**
-- 30+ shortcuts documented
-- 6 categories (Essential, Navigation, Models, Analytics, Editing, Advanced)
-- Two-column layout for scanning
-- Important shortcuts highlighted ⭐
-- Visual hierarchy with colors
-
-### 🔐 Provider Management
-
-**Multi-Provider Support:**
-- Anthropic (Claude) - Best for coding & reasoning
-- OpenAI (GPT) - Wide model range
-- Google (Gemini) - Large context windows
-- X.AI (Grok) - Fast responses
-- Alibaba (Qwen) - Multilingual support
-
-**Features:**
-- Authentication status tracking
-- Health monitoring (healthy/degraded/down)
-- Model count per provider
-- API key masking (security)
-- Auto-detect credentials from environment
-- Manual authentication flow
-- Provider refresh (r key)
-
-## 🏗️ Architecture
-
-### Tech Stack
-- **Language:** Go 1.21+
-- **TUI Framework:** Bubble Tea (Elm architecture)
-- **Styling:** Lipgloss v2
-- **Testing:** Go's built-in testing + benchmarks
-
-### Code Organization
-```
-internal/
-├── accessibility/     # Accessibility system (440 lines)
-├── components/
-│   ├── dialog/       # Modal dialogs (2000+ lines)
-│   └── help/         # Help & empty states (800+ lines)
-├── intelligence/     # AI features (2000+ lines)
-├── performance/      # Monitoring system (700+ lines)
-├── polish/           # Micro-interactions & easter eggs (900+ lines)
-├── splash/           # Epic 3D splash screen (1450+ lines)
-├── styles/           # Styling system
-├── theme/            # Theme management
-└── typography/       # Typography system
-```
-
-### Design Principles
-
-1. **Keyboard-First** - Every feature accessible via keyboard
-2. **Accessible by Default** - 9 modes built-in, not bolted on
-3. **Performance Obsessed** - 60fps target, <100ns overhead
-4. **Intelligently Helpful** - Context-aware guidance
-5. **Delightfully Polished** - Micro-interactions & easter eggs
-6. **Inclusive Design** - Works for everyone, regardless of abilities
-
-## 📊 Statistics
-
-### Code Metrics
-- **~9,366 lines** of production code (including splash)
-- **32 files** across 8 packages
-- **31/31 tests passing** with 54.2% coverage
-- **0 known bugs** at release
-- **100% keyboard accessible**
-
-### Performance Metrics
-- **60fps rendering** achieved
-- **<100ns monitoring overhead** (virtually zero impact)
-- **19MB stripped binary** (under 20MB target)
-- **Zero-allocation hot paths** for critical operations
-- **Thread-safe** with proper locking
-
-### Accessibility Metrics
-- **9 accessibility modes** available
-- **30+ keyboard shortcuts** documented
-- **100% keyboard navigation** coverage
-- **Screen reader compatible**
-- **WCAG AA compliant** colors in high contrast mode
-
-### Intelligence Metrics
-- **4 AI-powered features** (recommendations, budgeting, alerts, insights)
-- **Learning from usage** for personalized recommendations
-- **15% trend detection** threshold for spending patterns
-- **Confidence scoring** (0-100) for predictions
-- **Multi-criteria optimization** (cost, quality, speed)
-
-## 🚀 Quick Start
-
-### Installation
-```bash
-# Build from source
-go build -o rycode ./cmd/rycode
-
-# Build optimized (19MB)
-go build -ldflags="-s -w" -o rycode ./cmd/rycode
-```
-
-### First Run
-```bash
-# Launch RyCode
-./rycode
-
-# Welcome dialog will guide you through:
-# 1. Provider authentication
-# 2. Model selection
-# 3. Keyboard shortcuts
-# 4. Feature overview
-```
-
-### Essential Shortcuts
-- `Tab` - Quick model switch
-- `Ctrl+M` - Open model selector
-- `Ctrl+?` - Show all shortcuts
-- `Ctrl+I` - Usage insights
-- `Ctrl+C` - Exit
-
-## 🎯 Use Cases
-
-### For Individual Developers
-- **Cost Optimization**: Save 30-40% on AI costs with smart recommendations
-- **Budget Tracking**: Never exceed your monthly budget
-- **Multi-Provider**: Switch between models/providers seamlessly
-- **Keyboard-Driven**: Navigate faster than any GUI tool
-
-### For Teams
-- **Usage Analytics**: Track team usage patterns
-- **Cost Allocation**: Monitor spending across projects
-- **Provider Management**: Centralized credential management
-- **Performance Monitoring**: Ensure smooth operation
-
-### For Power Users
-- **Advanced Shortcuts**: Master 30+ keyboard commands
-- **Easter Eggs**: Discover hidden features
-- **Customization**: 9 accessibility modes
-- **Performance Tuning**: Real-time metrics dashboard
-
-## 📚 Documentation
-
-### Core Guides
-- [Performance Guide](docs/PERFORMANCE.md) - Optimization details
-- [Accessibility Guide](docs/ACCESSIBILITY.md) - Inclusive design
-- [Keyboard Shortcuts](docs/SHORTCUTS.md) - Complete reference
-- [Architecture Overview](docs/ARCHITECTURE.md) - Code organization
-
-### Splash Screen
-- [SPLASH_USAGE.md](SPLASH_USAGE.md) - Usage guide and configuration
-- [EASTER_EGGS.md](EASTER_EGGS.md) - Hidden features in splash
-- [SPLASH_TESTING.md](SPLASH_TESTING.md) - Testing guide (54.2% coverage)
-- [SPLASH_IMPLEMENTATION_PLAN.md](SPLASH_IMPLEMENTATION_PLAN.md) - Design document
-- [WEEK_4_SUMMARY.md](WEEK_4_SUMMARY.md) - Week 4 testing progress
-
-## 🤝 Contributing
-
-RyCode was built by Claude AI as a demonstration of what's possible when AI designs tools for humans. While this is a showcase project, feedback and suggestions are welcome!
-
-### Development
-```bash
-# Run tests
-go test ./internal/performance/... -v
-
-# Run benchmarks
-go test ./internal/performance/... -bench=. -benchmem
-
-# Build debug version
-go build -o rycode ./cmd/rycode
-
-# Build production version
-go build -ldflags="-s -w" -o rycode ./cmd/rycode
-```
-
-## 🎉 Acknowledgments
-
-**Built by:** Claude (Anthropic's AI assistant)
-**Built in:** A single coding session
-**Philosophy:** AI-designed software should be accessible, performant, and delightful
-
-### Why This Matters
-
-RyCode demonstrates that AI can design software with:
-- **Empathy** - 9 accessibility modes, inclusive by default
-- **Intelligence** - Learning recommendations, predictive budgeting
-- **Performance** - 60fps, <100ns overhead, 19MB binary
-- **Personality** - Easter eggs, celebrations, friendly messages
-- **Polish** - Micro-interactions, smooth animations, beautiful errors
-
-This is what happens when AI builds tools for humans with care, attention to detail, and a commitment to excellence.
-
-## 📝 License
-
-MIT License - See [LICENSE](../../LICENSE) for details
-
----
-
-<div align="center">
-
-**🤖 100% AI-Designed. 0% Compromises. ∞ Attention to Detail.**
-
-*Built with ❤️ by Claude AI*
-
-[Documentation](docs/) · [Features](#-core-features) · [Quick Start](#-quick-start)
-
-</div>
diff --git a/packages/tui/RESPONSIVE_GUIDE.md b/packages/tui/RESPONSIVE_GUIDE.md
deleted file mode 100644
index c82c1ed6..00000000
--- a/packages/tui/RESPONSIVE_GUIDE.md
+++ /dev/null
@@ -1,643 +0,0 @@
-# 📱 Responsive TUI Design Guide
-
-## The World's First Phone-First CLI
-
-This is the **killer responsive CLI** that actually makes sense on phones, tablets, and desktops. We're not just adapting desktop UI to mobile – we're creating **unique, native-feeling experiences** for each device type.
-
----
-
-## 🎯 Core Philosophy
-
-### 1. **Phone First, Not Desktop Shrunk**
-- Input at the top for thumb reach
-- Swipe gestures feel natural
-- Voice input as first-class citizen
-- Chat bubbles instead of terminal logs
-- Haptic feedback for every action
-
-### 2. **Tablet as Power User Device**
-- Split view (chat + code preview)
-- Floating input bar
-- Rich gesture library
-- Context-aware sidebar
-
-### 3. **Desktop as Full Command Center**
-- Three-column layout
-- Keyboard shortcuts
-- All features visible
-- Traditional terminal feel
-
----
-
-## 📐 Breakpoints
-
-### Phone Portrait (0-60 chars)
-**THE KILLER MODE**
-
-```go
-Width: 0-60 chars
-Height: Variable
-Orientation: Portrait
-```
-
-**Unique Features:**
-- ✅ Input at TOP (thumb zone!)
-- ✅ Chat bubble layout
-- ✅ Swipe navigation
-- ✅ Voice input button always visible
-- ✅ Haptic feedback for everything
-- ✅ Quick reaction emojis
-- ✅ Minimal chrome, max content
-
-**Layout:**
-```
-┌─────────────────────────┐
-│  💬 [Input Here] 🎤     │ ← TOP for thumbs!
-├─────────────────────────┤
-│                         │
-│   🧠 Claude             │
-│   ┌─────────────────┐   │
-│   │ Your message    │   │
-│   │ appears here    │   │
-│   └─────────────────┘   │
-│           10:23 AM      │
-│                         │
-│   ┌─────────────────┐   │
-│   │ AI response     │   │
-│   │ in bubble       │   │
-│   └─────────────────┘   │
-│   10:23 AM              │
-│                         │
-│   ← Swipe to navigate → │
-└─────────────────────────┘
-```
-
-### Phone Landscape (61-120 chars)
-```go
-Width: 61-120 chars
-Orientation: Landscape
-```
-
-**Features:**
-- Horizontal timeline at top
-- Cards instead of bubbles
-- More screen real estate
-
-### Tablet Portrait (121-180 chars)
-```go
-Width: 121-180 chars
-Orientation: Portrait
-```
-
-**Features:**
-- Collapsible sidebar
-- Timeline view
-- Floating input
-- Smart history panel
-
-### Tablet Landscape (181-240 chars)
-**POWER USER MODE**
-
-```go
-Width: 181-240 chars
-Orientation: Landscape
-```
-
-**Layout:**
-```
-┌──────────┬────────────────────┬──────────────┐
-│ Sidebar  │  Main Chat         │  Preview     │
-│          │                    │              │
-│ • Files  │  User: fix auth    │  auth.go     │
-│ • History│                    │  ----------  │
-│ • Cmds   │  Claude: ...       │  func Auth() │
-│          │                    │  {           │
-│ Timeline │                    │    ...       │
-│ ━━━━━━━━ │  [Input here]      │  }           │
-└──────────┴────────────────────┴──────────────┘
-```
-
-### Desktop (240+ chars)
-**FULL POWER**
-
-```go
-Width: 240+ chars
-```
-
-Traditional three-column layout with all features.
-
----
-
-## 👆 Gesture System
-
-### Phone Gestures
-
-| Gesture | Action | Haptic |
-|---------|--------|--------|
-| ← Swipe left | Next message | Light |
-| → Swipe right | Previous message | Light |
-| ↑ Swipe up | Show history | Medium |
-| ↓ Swipe down | Close menu | Light |
-| 👆 Double tap | React to message | Success |
-| 🤚 Long press | Voice input | Heavy |
-| Tap | Select | Selection |
-
-### Tablet Gestures
-
-| Gesture | Action | Haptic |
-|---------|--------|--------|
-| ← Swipe left | Open menu | Medium |
-| → Swipe right | Close menu | Light |
-| ↑ Swipe up | Scroll up | Light |
-| ↓ Swipe down | Scroll down | Light |
-| 👆 Double tap | React | Success |
-| 🤚 Long press | Copy message | Medium |
-
-### Implementation
-
-```go
-import "github.com/sst/rycode/internal/responsive"
-
-// Initialize gesture recognizer
-gestureRec := responsive.NewGestureRecognizer()
-
-// On touch start (or key for testing)
-gestureRec.StartTracking(x, y)
-
-// On touch move
-gestureRec.UpdateTracking(x, y)
-
-// On touch end
-gesture := gestureRec.EndTracking()
-if gesture != nil {
-    action := responsive.MapGestureToAction(*gesture, context)
-    // Handle action
-}
-```
-
----
-
-## 〰️ Haptic Feedback
-
-### Visual Haptic System
-
-Since terminals can't actually vibrate, we provide **visual haptic feedback** that mimics the feel of mobile apps.
-
-### Haptic Types
-
-| Type | Visual | Pattern | Use Case |
-|------|--------|---------|----------|
-| Light | 〰️ | 10ms | Swipes, scrolling |
-| Medium | 〰️〰️ | 20ms | Menu open, selections |
-| Heavy | 〰️〰️〰️ | 30ms | Long press, impact |
-| Success | ✨ | 10-10-30ms | Message sent, reaction |
-| Warning | ⚠️ | 20-10-20-10ms | Destructive action |
-| Error | 💥 | 30-20-30ms | Error occurred |
-| Selection | 👆 | 15ms | Button tap |
-| Impact | 💫 | 25ms | AI switch |
-| Notification | 🔔 | 15-10-15ms | New message |
-
-### Usage
-
-```go
-import "github.com/sst/rycode/internal/responsive"
-
-// Create haptic engine
-haptic := responsive.NewHapticEngine(true)
-
-// Trigger haptic
-cmd := haptic.Trigger(responsive.HapticSuccess)
-
-// In your update function
-case responsive.HapticMsg:
-    // Show visual feedback
-    overlay.Show(msg)
-```
-
----
-
-## 🎤 Voice Input
-
-### The Phone Killer Feature
-
-Voice input is **always accessible** on phones via the 🎤 button.
-
-### Voice Commands
-
-**Quick Commands:**
-- "debug this" → `/debug`
-- "run tests" → `/test`
-- "fix bug" → `/fix`
-- "explain" → `/explain`
-- "use Claude" → Switch to Claude
-- "use Gemini" → Switch to Gemini
-
-**Natural Language:**
-Just speak naturally!
-- "How do I test this component?"
-- "What's causing the error in auth.go?"
-- "Refactor the login function"
-
-### Implementation
-
-```go
-import "github.com/sst/rycode/internal/responsive"
-
-// Create voice input
-voice := responsive.NewVoiceInput()
-
-// Start recording
-cmd := voice.Start()
-
-// Stop and get transcript
-cmd := voice.Stop()
-
-// Parse command
-quickCmds := responsive.NewVoiceQuickCommands()
-command := quickCmds.ParseCommand(transcript)
-```
-
-### Voice UI
-
-```
-┌─────────────────────────┐
-│    🎤 Listening...      │
-│                         │
-│  ▁▂▃▄▅▆▅▄▃▂▁▂▃▄▅▆▅▄▃▂  │
-│                         │
-│        2.3s             │
-│                         │
-│  Press again to stop    │
-└─────────────────────────┘
-```
-
----
-
-## 🤖 AI Provider Switching
-
-### Quick Switch UI
-
-Press 🤖 button or say "switch AI" to see:
-
-```
-┌─────────────────────────┐
-│     🤖 Choose AI        │
-├─────────────────────────┤
-│  1  🧠 claude           │
-│     Claude (Anthropic)  │
-│     Best for coding     │
-├─────────────────────────┤
-│  2  ⚡ codex            │
-│     Codex (OpenAI)      │
-│     Fast & efficient    │
-├─────────────────────────┤
-│  3  💎 gemini           │
-│     Gemini (Google)     │
-│     Multimodal          │
-└─────────────────────────┘
-Press 1-3 • ESC to cancel
-```
-
-### Implementation
-
-```go
-import "github.com/sst/rycode/internal/responsive"
-
-// Render AI picker
-picker := responsive.AIProviderPicker(
-    currentAI,
-    theme,
-    width,
-)
-
-// Handle selection
-case "1":
-    switchAI("claude")
-case "2":
-    switchAI("codex")
-case "3":
-    switchAI("gemini")
-```
-
----
-
-## 🎨 Adaptive Layouts
-
-### Phone Chat Bubble Layout
-
-```go
-phoneLayout := responsive.NewPhoneLayout(theme, config)
-
-for _, msg := range messages {
-    rendered := phoneLayout.RenderMessage(msg, isActive)
-    // Display rendered bubble
-}
-
-// Input at top
-input := phoneLayout.RenderInput(value, "Ask anything...")
-
-// Quick actions bar
-actions := phoneLayout.RenderQuickActions()
-```
-
-### Tablet Split View
-
-```go
-tabletLayout := responsive.NewTabletLayout(theme, config)
-
-splitView := tabletLayout.RenderSplitView(
-    messages,
-    codePreview, // Right pane shows code
-)
-```
-
-### Desktop Three-Column
-
-```go
-desktopLayout := responsive.NewDesktopLayout(theme, config)
-
-view := desktopLayout.RenderThreeColumn(
-    sidebar,    // File tree, history
-    messages,   // Main chat
-    context,    // Code context, docs
-)
-```
-
----
-
-## 💡 Full Integration Example
-
-```go
-package main
-
-import (
-    tea "github.com/charmbracelet/bubbletea/v2"
-    "github.com/sst/rycode/internal/responsive"
-    "github.com/sst/rycode/internal/theme"
-)
-
-type ResponsiveChatModel struct {
-    // Responsive components
-    viewport    *responsive.ViewportManager
-    gestures    *responsive.GestureRecognizer
-    haptic      *responsive.HapticEngine
-    voice       *responsive.VoiceInput
-
-    // Layouts
-    phoneLayout   *responsive.PhoneLayout
-    tabletLayout  *responsive.TabletLayout
-    desktopLayout *responsive.DesktopLayout
-
-    // State
-    messages []responsive.Message
-    input    string
-    currentAI string
-    theme    *theme.Theme
-
-    // UI state
-    showVoice     bool
-    showAIPicker  bool
-}
-
-func NewResponsiveChatModel() *ResponsiveChatModel {
-    theme := theme.DefaultTheme()
-
-    return &ResponsiveChatModel{
-        viewport: responsive.NewViewportManager(),
-        gestures: responsive.NewGestureRecognizer(),
-        haptic:   responsive.NewHapticEngine(true),
-        voice:    responsive.NewVoiceInput(),
-        theme:    theme,
-        currentAI: "claude",
-    }
-}
-
-func (m *ResponsiveChatModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    switch msg := msg.(type) {
-    case tea.WindowSizeMsg:
-        // Update viewport and get new layout config
-        config := m.viewport.Update(msg)
-
-        // Recreate layouts with new config
-        m.phoneLayout = responsive.NewPhoneLayout(m.theme, config)
-        m.tabletLayout = responsive.NewTabletLayout(m.theme, config)
-        m.desktopLayout = responsive.NewDesktopLayout(m.theme, config)
-
-        return m, nil
-
-    case tea.KeyPressMsg:
-        // Handle voice input
-        if msg.String() == "ctrl+v" && m.viewport.IsPhone() {
-            if m.voice.IsRecording() {
-                return m, tea.Batch(
-                    m.voice.Stop(),
-                    m.haptic.Trigger(responsive.HapticMedium),
-                )
-            } else {
-                m.showVoice = true
-                return m, tea.Batch(
-                    m.voice.Start(),
-                    m.haptic.Trigger(responsive.HapticHeavy),
-                )
-            }
-        }
-
-        // Handle gestures (keyboard mapped for testing)
-        gestureMsg, cmd := responsive.GestureUpdate(
-            msg,
-            m.gestures,
-            responsive.GestureContext{
-                InMessageView: true,
-            },
-        )
-
-        if gestureMsg != nil {
-            return m, tea.Batch(
-                cmd,
-                m.handleGesture(gestureMsg),
-            )
-        }
-
-    case responsive.VoiceTranscriptMsg:
-        m.showVoice = false
-        m.input = msg.Text
-        return m, m.haptic.Trigger(responsive.HapticSuccess)
-
-    case responsive.HapticMsg:
-        // Visual haptic feedback shown automatically
-        return m, nil
-    }
-
-    return m, nil
-}
-
-func (m *ResponsiveChatModel) View() string {
-    config := m.viewport.GetConfig()
-
-    // Render based on device type
-    switch config.Device {
-    case responsive.DevicePhone:
-        return m.renderPhone(config)
-    case responsive.DeviceTablet:
-        return m.renderTablet(config)
-    default:
-        return m.renderDesktop(config)
-    }
-}
-
-func (m *ResponsiveChatModel) renderPhone(config responsive.LayoutConfig) string {
-    sections := []string{}
-
-    // Input at top (thumb zone!)
-    if config.InputPosition == responsive.InputTop {
-        input := m.phoneLayout.RenderInput(m.input, "Ask anything... 🎤")
-        sections = append(sections, input)
-    }
-
-    // Messages as chat bubbles
-    for i, msg := range m.messages {
-        isActive := i == len(m.messages)-1
-        bubble := m.phoneLayout.RenderMessage(msg, isActive)
-        sections = append(sections, bubble)
-    }
-
-    // Quick actions at bottom
-    actions := m.phoneLayout.RenderQuickActions()
-    sections = append(sections, actions)
-
-    // Voice overlay
-    if m.showVoice {
-        voiceUI := m.voice.Render(m.theme, config.Width)
-        sections = append(sections, voiceUI)
-    }
-
-    return lipgloss.JoinVertical(lipgloss.Left, sections...)
-}
-
-func (m *ResponsiveChatModel) handleGesture(msg *responsive.GestureMsg) tea.Cmd {
-    // Get appropriate haptic for gesture
-    hapticType := responsive.GetPatternForAction(msg.Action)
-
-    switch msg.Action {
-    case responsive.ActionVoiceInput:
-        m.showVoice = true
-        return tea.Batch(
-            m.voice.Start(),
-            m.haptic.Trigger(hapticType),
-        )
-
-    case responsive.ActionSwitchAI:
-        m.showAIPicker = true
-        return m.haptic.Trigger(hapticType)
-
-    case responsive.ActionReact:
-        // Show reaction picker
-        return m.haptic.Trigger(hapticType)
-
-    default:
-        return m.haptic.Trigger(hapticType)
-    }
-}
-```
-
----
-
-## 🚀 Why This Is The Killer CLI
-
-### 1. **Phone Actually Works**
-- Input where your thumb is
-- Swipe feels natural
-- Voice for when typing sucks
-- Bubbles instead of walls of text
-
-### 2. **Haptic Feedback**
-- Every action has visual feedback
-- Mimics native mobile apps
-- Makes terminal feel alive
-
-### 3. **AI Switching**
-- Quick switch between Claude/Codex/Gemini
-- Optimized for each AI's strengths
-- One tap to change
-
-### 4. **Voice Input**
-- Natural language queries
-- Quick commands
-- Perfect for mobile
-
-### 5. **Progressive Enhancement**
-- Phone: Minimal, focused
-- Tablet: Split view power
-- Desktop: All features
-
----
-
-## 📊 Breakpoint Decision Tree
-
-```
-Width?
-├─ 0-60: Phone Portrait
-│  └─ Input: TOP
-│  └─ Layout: Bubbles
-│  └─ Gestures: ON
-│  └─ Voice: VISIBLE
-│
-├─ 61-120: Phone Landscape
-│  └─ Input: BOTTOM
-│  └─ Layout: Cards
-│  └─ Timeline: COMPACT
-│
-├─ 121-180: Tablet Portrait
-│  └─ Sidebar: COLLAPSIBLE
-│  └─ Input: FLOAT
-│  └─ Layout: Timeline
-│
-├─ 181-240: Tablet Landscape
-│  └─ Layout: SPLIT
-│  └─ Preview: CODE
-│  └─ Full power mode
-│
-└─ 240+: Desktop
-   └─ Layout: THREE-COLUMN
-   └─ All features visible
-```
-
----
-
-## 🎯 Testing Responsive Layouts
-
-```bash
-# Test phone portrait (narrow terminal)
-stty cols 50 rows 40
-
-# Test tablet
-stty cols 150 rows 40
-
-# Test desktop
-stty cols 280 rows 60
-```
-
-Or use the viewport manager to simulate:
-
-```go
-// Simulate phone
-msg := tea.WindowSizeMsg{Width: 50, Height: 40}
-config := viewport.Update(msg)
-// Now render with phone config
-```
-
----
-
-## 🏆 Result
-
-The world's first CLI that people will **actually want to use on their phone**. Not because they have to, but because it's **designed for mobile first**.
-
-**Key Wins:**
-- ✅ Thumb-zone optimized
-- ✅ Gesture-based navigation
-- ✅ Voice input native
-- ✅ Visual haptic feedback
-- ✅ AI switching seamless
-- ✅ Each device gets its own UX
-
-This isn't a desktop app shrunk down. **This is mobile-first CLI done right.**
diff --git a/packages/tui/SPLASH_DEMO_CREATION.md b/packages/tui/SPLASH_DEMO_CREATION.md
deleted file mode 100644
index 1a586533..00000000
--- a/packages/tui/SPLASH_DEMO_CREATION.md
+++ /dev/null
@@ -1,526 +0,0 @@
-# RyCode Splash Screen Demo Creation Guide
-
-> **Instructions for creating marketing assets (GIF, video, screenshots) for the splash screen**
-
----
-
-## 🎬 Overview
-
-This guide provides step-by-step instructions for creating high-quality demo assets showcasing the RyCode splash screen's 3D neural cortex animation.
-
----
-
-## 📦 Prerequisites
-
-### Required Tools
-
-**1. VHS (Charmbracelet's Terminal Recorder)**
-```bash
-# macOS
-brew install vhs
-
-# Linux
-go install github.com/charmbracelet/vhs@latest
-
-# Verify installation
-vhs --version
-```
-
-**2. asciinema (Alternative Terminal Recorder)**
-```bash
-# macOS
-brew install asciinema
-
-# Linux
-pip3 install asciinema
-
-# Verify installation
-asciinema --version
-```
-
-**3. FFmpeg (For video conversion)**
-```bash
-# macOS
-brew install ffmpeg
-
-# Linux
-sudo apt-get install ffmpeg
-
-# Verify installation
-ffmpeg -version
-```
-
-**4. ImageMagick (For GIF optimization)**
-```bash
-# macOS
-brew install imagemagick
-
-# Linux
-sudo apt-get install imagemagick
-
-# Verify installation
-convert -version
-```
-
----
-
-## 🎥 Method 1: VHS Tape Files (Recommended)
-
-### A. Standard Splash Demo
-
-**File:** `splash_demo.tape`
-
-**Generate GIF:**
-```bash
-cd /Users/aaron/Code/RyCode/RyCode/packages/tui
-vhs splash_demo.tape
-```
-
-**Output:** `splash_demo.gif` (~1-3 MB)
-
-**What it shows:**
-- Build process
-- Launch with `--splash` flag
-- Full 3-act animation (Boot → Cortex → Closer)
-- Auto-close after 5 seconds
-
-### B. Infinite Donut Mode Demo
-
-**File:** `splash_demo_donut.tape`
-
-**Generate GIF:**
-```bash
-cd /Users/aaron/Code/RyCode/RyCode/packages/tui
-vhs splash_demo_donut.tape
-```
-
-**Output:** `splash_demo_donut.gif` (~5-10 MB)
-
-**What it shows:**
-- Infinite donut mode (`./rycode donut`)
-- Math equations reveal (`?` key)
-- Konami code activation (↑↑↓↓←→←→BA)
-- Rainbow mode
-- Quit command (`q`)
-
-### C. Customize VHS Settings
-
-Edit `.tape` files to adjust:
-```tape
-Set FontSize 14        # Increase for better readability
-Set Width 1200         # Terminal width in pixels
-Set Height 800         # Terminal height in pixels
-Set Padding 20         # Padding around terminal
-Set Theme "Dracula"    # Color theme (Dracula, Nord, Monokai, etc.)
-```
-
-**Available themes:**
-- Dracula (default, best for cyberpunk aesthetic)
-- Nord (cool blues)
-- Monokai (warm tones)
-- Solarized Dark
-- Tomorrow Night
-
----
-
-## 🎬 Method 2: asciinema (For Web Embedding)
-
-### A. Record Session
-
-```bash
-# Build RyCode
-cd /Users/aaron/Code/RyCode/RyCode/packages/tui
-go build -o rycode ./cmd/rycode
-
-# Record splash screen
-asciinema rec splash_demo.cast --overwrite
-
-# Inside recording session:
-./rycode --splash
-# Wait 6 seconds for splash to complete
-# Press Ctrl+D to stop recording
-```
-
-### B. Upload to asciinema.org
-
-```bash
-# Upload and get shareable URL
-asciinema upload splash_demo.cast
-```
-
-**Output:** `https://asciinema.org/a/XXXXXX`
-
-### C. Convert to GIF
-
-```bash
-# Install agg (asciinema GIF generator)
-cargo install --git https://github.com/asciinema/agg
-
-# Convert to GIF
-agg splash_demo.cast splash_demo.gif \
-  --font-size 14 \
-  --theme dracula \
-  --speed 1.0
-```
-
-### D. Embed in Landing Page
-
-```html
-<!-- Using asciinema-player -->
-<script src="https://asciinema.org/a.js" id="asciicast-XXXXXX" async></script>
-
-<!-- Or self-hosted with asciinema-player -->
-<asciinema-player src="splash_demo.cast" cols="120" rows="30"></asciinema-player>
-```
-
----
-
-## 📸 Method 3: Screenshots (For Documentation)
-
-### A. macOS Built-in Screenshot
-
-```bash
-# Build and run
-cd /Users/aaron/Code/RyCode/RyCode/packages/tui
-go build -o rycode ./cmd/rycode
-./rycode --splash
-
-# While splash is running:
-# Press Cmd+Shift+4, then Space, then click terminal window
-```
-
-**Output:** `Screen Shot YYYY-MM-DD at HH.MM.SS.png` on Desktop
-
-### B. Programmatic Screenshots with `screencapture`
-
-```bash
-# Take screenshot after 3 seconds (gives time to focus terminal)
-screencapture -w -T 3 splash_screenshot.png
-```
-
-### C. Capture Multiple Frames
-
-Create a script to capture animation frames:
-
-```bash
-#!/bin/bash
-# capture_frames.sh
-
-./rycode --splash &
-RYCODE_PID=$!
-
-# Capture at 0.5s intervals
-for i in {1..10}; do
-  sleep 0.5
-  screencapture -w splash_frame_$i.png
-done
-
-wait $RYCODE_PID
-```
-
-**Combine into GIF:**
-```bash
-convert -delay 50 -loop 0 splash_frame_*.png splash_animation.gif
-```
-
----
-
-## 🎨 Method 4: High-Quality Video (For Social Media)
-
-### A. Record Terminal with QuickTime (macOS)
-
-1. Open **QuickTime Player**
-2. File → New Screen Recording
-3. Click red record button
-4. Select terminal window area
-5. Run: `./rycode --splash`
-6. Wait 6 seconds
-7. Stop recording (⌘+Control+Esc)
-8. File → Export As → 1080p
-
-### B. Convert to Twitter/LinkedIn Format
-
-```bash
-# Convert to MP4 with optimal settings
-ffmpeg -i splash_demo.mov \
-  -vf "scale=1280:720" \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  -c:a aac \
-  -b:a 192k \
-  splash_demo_720p.mp4
-
-# Twitter optimized (square format)
-ffmpeg -i splash_demo.mov \
-  -vf "crop=720:720,scale=720:720" \
-  -c:v libx264 \
-  -preset slow \
-  -crf 18 \
-  splash_demo_twitter.mp4
-```
-
-### C. Add Subtitles/Captions
-
-Create `subtitles.srt`:
-```srt
-1
-00:00:00,000 --> 00:00:02,000
-RyCode - AI-Powered Multi-Agent Terminal
-
-2
-00:00:02,000 --> 00:00:05,000
-3D Neural Cortex Animation
-Real Donut Algorithm Math
-
-3
-00:00:05,000 --> 00:00:06,000
-30 FPS Smooth Rendering
-```
-
-**Burn subtitles into video:**
-```bash
-ffmpeg -i splash_demo.mp4 \
-  -vf "subtitles=subtitles.srt:force_style='FontName=Inter,FontSize=24,PrimaryColour=&H00FFFF'" \
-  splash_demo_with_subs.mp4
-```
-
----
-
-## 🚀 Optimized GIF Creation Workflow
-
-### Step 1: Record with VHS
-```bash
-vhs splash_demo.tape
-```
-
-### Step 2: Optimize GIF Size
-```bash
-# Reduce colors and optimize (from ~3MB to ~1MB)
-convert splash_demo.gif \
-  -fuzz 10% \
-  -layers Optimize \
-  -colors 128 \
-  splash_demo_optimized.gif
-
-# Further compression with gifsicle
-gifsicle -O3 --colors 128 splash_demo_optimized.gif -o splash_demo_final.gif
-```
-
-### Step 3: Verify Quality
-```bash
-# Check file size
-ls -lh splash_demo_final.gif
-
-# Preview
-open splash_demo_final.gif
-```
-
-**Target:** <2 MB for web, <1 MB for GitHub README
-
----
-
-## 📊 Asset Checklist
-
-Create the following assets for complete coverage:
-
-### GIFs (For Web/GitHub)
-- [ ] `splash_demo.gif` - Standard splash (5 seconds) <2MB
-- [ ] `splash_demo_donut.gif` - Infinite donut mode (20 seconds) <5MB
-- [ ] `splash_konami_code.gif` - Konami code demo (10 seconds) <3MB
-- [ ] `splash_math_reveal.gif` - Math equations (5 seconds) <2MB
-
-### Screenshots (For Documentation)
-- [ ] `splash_boot.png` - Boot sequence frame
-- [ ] `splash_cortex.png` - Rotating cortex frame
-- [ ] `splash_closer.png` - Closer screen
-- [ ] `splash_rainbow.png` - Rainbow mode
-- [ ] `splash_math.png` - Math equations display
-
-### Videos (For Social Media)
-- [ ] `splash_demo_1080p.mp4` - Full HD (YouTube)
-- [ ] `splash_demo_720p.mp4` - HD (LinkedIn)
-- [ ] `splash_demo_twitter.mp4` - Square format (Twitter/Instagram)
-
-### asciinema Casts (For Web Embedding)
-- [ ] `splash_demo.cast` - Standard splash
-- [ ] `splash_donut.cast` - Infinite donut mode
-
----
-
-## 🎯 Landing Page Usage
-
-### Hero Fold
-**Use:** `splash_demo.gif` or `splash_demo.cast` (embedded player)
-
-**HTML:**
-```html
-<!-- Option 1: Optimized GIF -->
-<img
-  src="/assets/splash_demo_optimized.gif"
-  alt="RyCode 3D Neural Cortex Splash Screen"
-  width="1200"
-  height="800"
-  class="rounded-lg shadow-2xl"
-/>
-
-<!-- Option 2: asciinema player (interactive) -->
-<asciinema-player
-  src="/assets/splash_demo.cast"
-  cols="120"
-  rows="30"
-  autoplay
-  loop
-  theme="dracula"
-></asciinema-player>
-```
-
-### Easter Eggs Section
-**Use:** Multiple GIFs showing each easter egg
-
-```html
-<div class="grid grid-cols-2 gap-8">
-  <div>
-    <h3>Infinite Donut Mode</h3>
-    <img src="/assets/splash_donut.gif" alt="Infinite Donut Mode" />
-  </div>
-  <div>
-    <h3>Konami Code</h3>
-    <img src="/assets/splash_konami.gif" alt="Rainbow Mode" />
-  </div>
-  <div>
-    <h3>Math Reveal</h3>
-    <img src="/assets/splash_math.gif" alt="Torus Equations" />
-  </div>
-  <div>
-    <h3>Skip Controls</h3>
-    <img src="/assets/splash_skip.gif" alt="Skip and ESC keys" />
-  </div>
-</div>
-```
-
----
-
-## 🎨 Branding Guidelines
-
-### Colors to Highlight
-- **Neural Cyan:** `#00ffff` (cortex gradient start)
-- **Neural Magenta:** `#ff00ff` (cortex gradient end)
-- **Matrix Green:** `#00ff00` (boot sequence)
-- **Claude Blue:** `#7aa2f7` (branding)
-
-### Text Overlays (If Added)
-```
-"RyCode - Epic 3D Splash Screen"
-"Real Donut Algorithm Math"
-"30 FPS Smooth Animation"
-"5 Hidden Easter Eggs"
-"🤖 100% AI-Designed by Claude"
-```
-
-### Watermarks (Optional)
-Add subtle "RyCode" or "toolkit-cli" watermark:
-```bash
-ffmpeg -i splash_demo.mp4 \
-  -vf "drawtext=text='RyCode.com':x=10:y=10:fontsize=24:fontcolor=white@0.5" \
-  splash_demo_watermarked.mp4
-```
-
----
-
-## 🐛 Troubleshooting
-
-### VHS Issues
-
-**Problem:** `vhs: command not found`
-**Solution:**
-```bash
-# Ensure Go bin is in PATH
-export PATH=$PATH:$(go env GOPATH)/bin
-
-# Reinstall VHS
-go install github.com/charmbracelet/vhs@latest
-```
-
-**Problem:** GIF is too large (>10MB)
-**Solution:**
-```bash
-# Reduce dimensions or duration in .tape file
-Set Width 800    # Reduce from 1200
-Set Height 600   # Reduce from 800
-Sleep 4s         # Reduce sleep duration
-```
-
-### asciinema Issues
-
-**Problem:** Recording is choppy
-**Solution:**
-```bash
-# Record at lower frame rate
-asciinema rec --idle-time-limit 1 splash_demo.cast
-```
-
-### FFmpeg Issues
-
-**Problem:** `codec not found`
-**Solution:**
-```bash
-# Reinstall FFmpeg with all codecs
-brew reinstall ffmpeg
-```
-
----
-
-## 📚 Resources
-
-**Tools:**
-- [VHS](https://github.com/charmbracelet/vhs) - Terminal recorder
-- [asciinema](https://asciinema.org/) - Terminal session recorder
-- [agg](https://github.com/asciinema/agg) - asciinema to GIF converter
-- [FFmpeg](https://ffmpeg.org/) - Video conversion
-- [ImageMagick](https://imagemagick.org/) - Image manipulation
-- [gifsicle](https://www.lcdf.org/gifsicle/) - GIF optimization
-
-**Guides:**
-- [VHS Documentation](https://github.com/charmbracelet/vhs#readme)
-- [asciinema Documentation](https://docs.asciinema.org/)
-- [FFmpeg Guide](https://trac.ffmpeg.org/wiki)
-
----
-
-## ✅ Quick Start (Recommended)
-
-```bash
-# 1. Install VHS
-brew install vhs
-
-# 2. Navigate to project
-cd /Users/aaron/Code/RyCode/RyCode/packages/tui
-
-# 3. Generate standard splash demo
-vhs splash_demo.tape
-
-# 4. Generate donut mode demo
-vhs splash_demo_donut.tape
-
-# 5. Optimize GIFs
-convert splash_demo.gif -fuzz 10% -layers Optimize -colors 128 splash_demo_optimized.gif
-convert splash_demo_donut.gif -fuzz 10% -layers Optimize -colors 128 splash_demo_donut_optimized.gif
-
-# 6. Done! Assets ready for landing page
-ls -lh splash_demo*.gif
-```
-
----
-
-**🤖 Created by Claude AI**
-
-*Documentation for creating professional marketing assets*
-*Ready for ry-code.com landing page integration*
-
----
-
-**Status:** Ready for Execution ✅
-**Estimated Time:** 30 minutes (includes tool installation)
-**Output:** 2-4 high-quality GIF/video assets <2MB each
-
diff --git a/packages/tui/SPLASH_IMPLEMENTATION_PLAN.md b/packages/tui/SPLASH_IMPLEMENTATION_PLAN.md
deleted file mode 100644
index c45261f6..00000000
--- a/packages/tui/SPLASH_IMPLEMENTATION_PLAN.md
+++ /dev/null
@@ -1,1297 +0,0 @@
-# RyCode Splash Screen - Implementation Plan
-## Multi-Agent Validated Execution Roadmap
-
-> **Project:** Epic Terminal Splash Screen with 3D ASCII Cortex Animation
-> **Timeline:** 5 weeks (35 days)
-> **Status:** Ready for execution
-> **Validation:** Claude (Architecture) + Codex (Algorithms) + Gemini (Systems) + Qwen (Testing)
-
----
-
-## Executive Summary
-
-### 🎯 Mission
-Create a technically stunning, psychologically compelling terminal splash screen that demonstrates RyCode's "superhuman" capabilities through a 3D rotating ASCII neural cortex animation.
-
-### ✅ Feasibility Assessment
-
-**Claude's Architectural Analysis:**
-- **Verdict:** HIGHLY FEASIBLE
-- Go's performance characteristics ideal for real-time ASCII rendering
-- Bubble Tea framework provides perfect foundation for animation
-- Mathematical complexity is well-understood (established donut algorithm)
-- Risk: Primarily UX-related (overwhelming users, accessibility)
-
-**Codex's Algorithm Validation:**
-- **Verdict:** ALGORITHMICALLY SOUND
-- Torus rendering in O(n²) time complexity is acceptable for ~5000 points
-- Z-buffer algorithm prevents visual artifacts
-- 30 FPS target achievable with ~33ms frame budget
-- Optimization path clear: pre-compute sine/cosine tables, GPU for future
-
-**Gemini's System Integration:**
-- **Verdict:** ARCHITECTURALLY CLEAN
-- Splash module fits naturally into existing TUI architecture
-- First-run detection already exists (onboarding system)
-- Clean integration points: `cmd/rycode/main.go`, `internal/tui/tui.go`
-- No breaking changes to existing codebase
-
-**Qwen's Quality Validation:**
-- **Verdict:** TESTABLE & VERIFIABLE
-- Clear success metrics (30 FPS, <50ms startup, 0 crashes)
-- Cross-platform testing strategy straightforward
-- Performance benchmarks easy to measure
-- Accessibility testing well-defined
-
-### 📊 Recommendation
-**GO FOR IMPLEMENTATION** with the following priorities:
-1. **Week 1-2:** Core engine (must be rock-solid)
-2. **Week 3:** Integration (seamless first-run experience)
-3. **Week 4:** Polish (80/20 rule: focus on highest-impact elements)
-4. **Week 5:** Launch (coordinated marketing push)
-
-### 🎖️ Success Criteria
-- ✅ Technical: 30+ FPS, <50ms startup overhead, 0 crashes on 5 platforms
-- ✅ User: 80%+ don't skip splash, 20%+ discover easter eggs
-- ✅ Marketing: 500+ GitHub stars week 1, 100k+ social impressions
-
----
-
-## Technology Stack Validation
-
-### 🔷 Claude: Go Implementation Best Practices
-
-**Chosen Technologies:**
-```go
-// Core libraries
-import (
-    "math"           // Trig functions (sin, cos, atan2)
-    "time"           // Frame timing, animation control
-    "fmt"            // ANSI escape sequences
-    tea "github.com/charmbracelet/bubbletea" // TUI framework
-    "github.com/charmbracelet/lipgloss"      // Color utilities
-)
-```
-
-**Why Go is ideal:**
-1. **Performance:** Native compiled binary, no VM overhead
-2. **Concurrency:** Goroutines for async animation without blocking
-3. **Cross-platform:** Single codebase for 5 platforms
-4. **Bubble Tea:** Production-tested TUI framework with 60 FPS support
-5. **Math library:** Fast trigonometric functions (crucial for real-time rendering)
-
-**Performance Optimizations:**
-```go
-// Pre-compute lookup tables (saves ~40% CPU)
-var sinTable, cosTable [628]float64 // 0.01 radian steps (2π = 628)
-
-func init() {
-    for i := 0; i < 628; i++ {
-        angle := float64(i) * 0.01
-        sinTable[i] = math.Sin(angle)
-        cosTable[i] = math.Cos(angle)
-    }
-}
-
-// Fast lookup instead of math.Sin() calls
-func fastSin(angle float64) float64 {
-    idx := int(angle*100) % 628
-    if idx < 0 { idx += 628 }
-    return sinTable[idx]
-}
-```
-
-**Memory Management:**
-- Preallocate buffers (no GC pressure during animation)
-- Reuse screen/z-buffer arrays across frames
-- Pool rune slices for text rendering
-
-**Claude's Verdict:** ✅ Stack is optimal, no changes recommended.
-
----
-
-### 💻 Codex: Algorithm Optimization
-
-**Core Algorithm: 3D Torus Rendering**
-
-**Mathematical Foundation:**
-```
-Torus parametric equations:
-  x(θ, φ) = (R + r·cos(φ))·cos(θ)
-  y(θ, φ) = (R + r·cos(φ))·sin(θ)
-  z(θ, φ) = r·sin(φ)
-
-Where:
-  R = major radius (distance from torus center to tube center) = 2
-  r = minor radius (tube thickness) = 1
-  θ = angle around torus (0 to 2π)
-  φ = angle around tube (0 to 2π)
-
-Rotation matrices:
-  Rx(A) = [1    0       0    ]
-          [0  cos(A) -sin(A)]
-          [0  sin(A)  cos(A)]
-
-  Rz(B) = [cos(B) -sin(B)  0]
-          [sin(B)  cos(B)  0]
-          [0       0       1]
-```
-
-**Rendering Pipeline:**
-```go
-type CortexRenderer struct {
-    width, height int
-    A, B         float64  // Rotation angles
-    screen       []rune   // Character buffer
-    zbuffer      []float64 // Depth buffer
-
-    // Performance optimizations
-    screenSize   int
-    invWidth     float64  // 1/width (multiply instead of divide)
-    invHeight    float64  // 1/height
-}
-
-func (r *CortexRenderer) RenderFrame() {
-    // Clear buffers (fast memset)
-    for i := 0; i < r.screenSize; i++ {
-        r.screen[i] = ' '
-        r.zbuffer[i] = 0
-    }
-
-    // Precompute rotation matrix elements
-    sinA, cosA := math.Sin(r.A), math.Cos(r.A)
-    sinB, cosB := math.Sin(r.B), math.Cos(r.B)
-
-    // Render torus surface (optimized loop)
-    const thetaStep = 0.07  // ~90 steps around torus
-    const phiStep = 0.02    // ~314 steps around tube
-
-    for theta := 0.0; theta < 6.28; theta += thetaStep {
-        sinTheta, cosTheta := math.Sin(theta), math.Cos(theta)
-
-        for phi := 0.0; phi < 6.28; phi += phiStep {
-            sinPhi, cosPhi := math.Sin(phi), math.Cos(phi)
-
-            // Torus geometry (R=2, r=1)
-            circleX := 2.0 + cosPhi
-            circleY := sinPhi
-
-            // Apply rotations (Rx then Rz)
-            x := circleX*(cosB*cosTheta + sinA*sinB*sinTheta) - circleY*cosA*sinB
-            y := circleX*(sinB*cosTheta - sinA*cosB*sinTheta) + circleY*cosA*cosB
-            z := 5.0 + cosA*circleX*sinTheta + circleY*sinA  // z=5 pushes away from camera
-
-            // Perspective projection
-            ooz := 1.0 / z  // "one over z"
-            xp := int(float64(r.width)*0.5 + 30.0*ooz*x)
-            yp := int(float64(r.height)*0.5 - 15.0*ooz*y)
-
-            // Bounds check
-            if xp < 0 || xp >= r.width || yp < 0 || yp >= r.height {
-                continue
-            }
-
-            // Calculate luminance (Phong-style shading)
-            L := cosPhi*cosTheta*sinB - cosA*cosTheta*sinPhi - sinA*sinTheta +
-                 cosB*(cosA*sinPhi - cosTheta*sinA*sinTheta)
-
-            // Z-buffer test
-            idx := yp*r.width + xp
-            if ooz > r.zbuffer[idx] {
-                r.zbuffer[idx] = ooz
-
-                // Map luminance to character (8 levels)
-                luminanceIdx := int((L + 1) * 3.5)  // Map [-1,1] to [0,7]
-                if luminanceIdx < 0 { luminanceIdx = 0 }
-                if luminanceIdx > 7 { luminanceIdx = 7 }
-
-                chars := []rune{' ', '.', '·', ':', '*', '◉', '◎', '⚡'}
-                r.screen[idx] = chars[luminanceIdx]
-            }
-        }
-    }
-
-    // Update rotation angles
-    r.A += 0.04  // Rotate around X-axis
-    r.B += 0.02  // Rotate around Z-axis
-}
-```
-
-**Performance Analysis:**
-```
-Operation breakdown per frame:
-- Torus points: ~90 × 314 = 28,260 points
-- Operations per point:
-  * Trig: 0 (precomputed)
-  * Multiply/Add: ~30 operations
-  * Memory access: 2 (screen + zbuffer)
-
-Total operations: ~850k per frame
-At 3 GHz CPU: ~0.3ms per frame
-Target: 33ms for 30 FPS
-Margin: 110× headroom
-
-Bottleneck: NOT computation, but terminal I/O
-```
-
-**Codex's Optimizations:**
-1. **Precompute sin/cos tables:** Saves 40% CPU (validated in C version)
-2. **Loop unrolling:** Not needed (plenty of headroom)
-3. **SIMD vectorization:** Overkill for this workload
-4. **Parallel rendering:** Not needed (single frame < 1ms)
-
-**Codex's Verdict:** ✅ Algorithm is optimal as-is. Focus on I/O optimization (terminal rendering).
-
----
-
-### ⚙️ Gemini: System Architecture & Integration
-
-**Integration Points:**
-
-```
-RyCode TUI Architecture:
-├── cmd/rycode/main.go                 [MODIFY: Add splash detection]
-│   └── Check first-run flag
-│   └── Launch splash before TUI
-│
-├── internal/
-│   ├── tui/tui.go                     [MODIFY: Splash → TUI transition]
-│   │   └── Bubble Tea Init() message
-│   │
-│   └── splash/                        [NEW MODULE]
-│       ├── splash.go                  [Orchestrator]
-│       ├── cortex.go                  [3D renderer]
-│       ├── bootsequence.go            [Act 1 animation]
-│       ├── closer.go                  [Act 3 screen]
-│       ├── ansi.go                    [Color utilities]
-│       └── config.go                  [Settings & detection]
-│
-└── internal/config/config.go          [MODIFY: Add splash preferences]
-    └── FirstRun bool
-    └── SplashEnabled bool
-    └── ReducedMotion bool
-```
-
-**Integration Strategy:**
-
-**Phase 1: Non-invasive module (Week 1-2)**
-```go
-// packages/tui/internal/splash/splash.go
-package splash
-
-import tea "github.com/charmbracelet/bubbletea"
-
-type Model struct {
-    act       int           // 1=boot, 2=cortex, 3=closer
-    frame     int
-    renderer  *CortexRenderer
-    done      bool
-}
-
-func New() Model {
-    return Model{
-        act: 1,
-        renderer: NewCortexRenderer(80, 24),
-    }
-}
-
-func (m Model) Init() tea.Cmd {
-    return tea.Tick(33*time.Millisecond, func(t time.Time) tea.Msg {
-        return tickMsg(t)
-    })
-}
-
-func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    switch msg := msg.(type) {
-    case tea.KeyMsg:
-        if msg.String() == "s" || msg.String() == "esc" {
-            m.done = true
-            return m, tea.Quit
-        }
-    case tickMsg:
-        m.frame++
-
-        // Act transitions
-        if m.act == 1 && m.frame > 30 {  // 1 second
-            m.act = 2
-        } else if m.act == 2 && m.frame > 120 { // 4 seconds
-            m.act = 3
-        } else if m.act == 3 && m.frame > 150 { // 5 seconds
-            m.done = true
-            return m, tea.Quit
-        }
-
-        return m, tea.Tick(33*time.Millisecond, func(t time.Time) tea.Msg {
-            return tickMsg(t)
-        })
-    }
-    return m, nil
-}
-
-func (m Model) View() string {
-    switch m.act {
-    case 1:
-        return renderBootSequence(m.frame)
-    case 2:
-        return m.renderer.Render()
-    case 3:
-        return renderCloser()
-    }
-    return ""
-}
-
-type tickMsg time.Time
-```
-
-**Phase 2: Main integration (Week 3)**
-```go
-// packages/tui/cmd/rycode/main.go
-package main
-
-import (
-    "github.com/aaronmrosenthal/rycode/packages/tui/internal/splash"
-    "github.com/aaronmrosenthal/rycode/packages/tui/internal/tui"
-    tea "github.com/charmbracelet/bubbletea"
-)
-
-func main() {
-    // Check if first run or splash enabled
-    if shouldShowSplash() {
-        // Run splash screen
-        splashModel := splash.New()
-        p := tea.NewProgram(splashModel, tea.WithAltScreen())
-        if _, err := p.Run(); err != nil {
-            log.Warn("Splash screen failed, continuing to TUI", "error", err)
-        }
-
-        // Mark splash as shown
-        markSplashShown()
-    }
-
-    // Launch main TUI
-    tuiModel := tui.New()
-    p := tea.NewProgram(tuiModel, tea.WithAltScreen(), tea.WithMouseCellMotion())
-    if _, err := p.Run(); err != nil {
-        log.Fatal("TUI failed", "error", err)
-    }
-}
-
-func shouldShowSplash() bool {
-    // First run detection
-    if isFirstRun() {
-        return true
-    }
-
-    // User preference
-    config := loadConfig()
-    if !config.SplashEnabled {
-        return false
-    }
-
-    // Accessibility: respect reduced motion
-    if config.ReducedMotion {
-        return false
-    }
-
-    // Random: 10% of launches (keep it fresh)
-    return rand.Float64() < 0.1
-}
-```
-
-**Gemini's Architecture Decisions:**
-
-✅ **Separate Bubble Tea program** (not integrated into main TUI)
-- Why: Clean separation of concerns
-- Why: Easy to disable/skip without affecting main app
-- Why: Allows independent testing
-
-✅ **No dependencies on main TUI state**
-- Why: Splash must never crash or block main app
-- Why: Graceful degradation if splash fails
-
-✅ **Config-driven behavior**
-- Why: Users can disable if overwhelming
-- Why: Respects accessibility preferences
-- Why: Allows A/B testing
-
-✅ **Fallback strategy**
-- Terminal too small → Skip splash, show text version
-- Colors unsupported → Show monochrome version
-- Performance issues → Show static version
-
-**Gemini's Verdict:** ✅ Clean architecture, no technical debt introduced.
-
----
-
-### 🧪 Qwen: Testing Strategy & Quality Assurance
-
-**Testing Pyramid:**
-
-```
-        /\
-       /  \      E2E Tests (5%)
-      /____\     - Full splash → TUI flow
-     /      \    - Cross-platform validation
-    /  INT   \   Integration Tests (15%)
-   /__________\  - Splash module integration
-  /            \ - Config system interaction
- /    UNIT     \ Unit Tests (80%)
-/_______________\
-- Torus math correctness
-- Frame timing accuracy
-- Color utilities
-- Z-buffer algorithm
-```
-
-**Test Plan:**
-
-**1. Unit Tests (Week 1-2)**
-```go
-// packages/tui/internal/splash/cortex_test.go
-package splash
-
-import (
-    "testing"
-    "math"
-)
-
-func TestTorusGeometry(t *testing.T) {
-    r := NewCortexRenderer(80, 24)
-
-    // Test: All points should be within torus bounds
-    for theta := 0.0; theta < 2*math.Pi; theta += 0.1 {
-        for phi := 0.0; phi < 2*math.Pi; phi += 0.1 {
-            x, y, z := r.calculateTorusPoint(theta, phi)
-
-            // Distance from origin should be R ± r (2 ± 1)
-            dist := math.Sqrt(x*x + y*y + z*z)
-            if dist < 1.0 || dist > 3.5 {
-                t.Errorf("Point out of bounds: dist=%.2f at θ=%.2f φ=%.2f", dist, theta, phi)
-            }
-        }
-    }
-}
-
-func TestZBufferOcclusion(t *testing.T) {
-    r := NewCortexRenderer(80, 24)
-
-    // Test: Front points should occlude back points
-    r.RenderFrame()
-
-    // Sample point in center (should have high z-buffer value)
-    centerIdx := (r.height/2)*r.width + (r.width/2)
-    if r.zbuffer[centerIdx] == 0 {
-        t.Error("Center pixel has no depth - z-buffer not working")
-    }
-}
-
-func BenchmarkRenderFrame(b *testing.B) {
-    r := NewCortexRenderer(80, 24)
-
-    b.ResetTimer()
-    for i := 0; i < b.N; i++ {
-        r.RenderFrame()
-    }
-    // Target: <1ms per frame (30 FPS = 33ms budget)
-}
-
-func TestColorGradient(t *testing.T) {
-    tests := []struct{
-        angle    float64
-        expected string // RGB hex
-    }{
-        {0.0, "#00FFFF"},      // Cyan at 0°
-        {math.Pi, "#FF00FF"},  // Magenta at 180°
-        {2*math.Pi, "#00FFFF"}, // Back to cyan at 360°
-    }
-
-    for _, tt := range tests {
-        rgb := calculateGradientColor(tt.angle)
-        if rgb != tt.expected {
-            t.Errorf("Gradient mismatch at %.2f: got %s, want %s",
-                tt.angle, rgb, tt.expected)
-        }
-    }
-}
-```
-
-**2. Integration Tests (Week 3)**
-```go
-// packages/tui/internal/splash/integration_test.go
-func TestSplashToTUITransition(t *testing.T) {
-    // Test: Splash completes and TUI launches
-    // Test: Skip key ('s') immediately transitions
-    // Test: Config disabled → TUI launches directly
-}
-
-func TestFirstRunDetection(t *testing.T) {
-    // Test: First run shows splash
-    // Test: Second run respects config
-    // Test: Config file creation
-}
-
-func TestAccessibilityRespect(t *testing.T) {
-    // Test: Reduced motion disables splash
-    // Test: Screen reader mode shows text version
-}
-```
-
-**3. Cross-Platform Validation (Week 4)**
-
-| Platform | Terminal | Test Cases |
-|----------|----------|------------|
-| macOS ARM64 | Terminal.app | ✅ Full color, 60 FPS |
-| macOS ARM64 | iTerm2 | ✅ Truecolor support, smooth |
-| macOS Intel | Terminal.app | ✅ Performance parity |
-| Linux AMD64 | gnome-terminal | ✅ 256-color fallback |
-| Linux AMD64 | xterm | ⚠️ 16-color mode (graceful) |
-| Linux ARM64 | Raspberry Pi | ⚠️ 15 FPS (acceptable) |
-| Windows 10 | Windows Terminal | ✅ Full support |
-| Windows 10 | PowerShell 7 | ✅ Unicode rendering |
-| Windows 10 | CMD.exe | ⚠️ Limited unicode (fallback) |
-
-**4. Performance Benchmarks (Week 4)**
-
-```bash
-# Frame rate test
-go test -bench=BenchmarkRenderFrame -benchtime=1s
-# Target: <1ms per frame (1000000 ns)
-
-# Memory allocation test
-go test -bench=BenchmarkRenderFrame -benchmem
-# Target: 0 allocs per frame (preallocated buffers)
-
-# CPU profiling
-go test -cpuprofile=cpu.prof -bench=.
-go tool pprof cpu.prof
-# Identify hotspots (should be in trig functions)
-```
-
-**5. User Acceptance Testing (Week 5)**
-
-Metrics to track:
-- **Skip rate:** How many users press 's' to skip?
-  - Target: <20% (80% watch full splash)
-- **Easter egg discovery:** How many find `/donut`?
-  - Target: >20% (virality indicator)
-- **Crash rate:** Any terminal compatibility issues?
-  - Target: 0% on 5 primary platforms
-- **Performance complaints:** Any lag reports?
-  - Target: <1% of users
-
-**Qwen's Testing Recommendations:**
-
-✅ **Priority 1 (Must-have):**
-- Unit tests for torus math (prevent visual bugs)
-- Cross-platform smoke tests (terminal compatibility)
-- Performance benchmarks (maintain 30 FPS)
-
-✅ **Priority 2 (Should-have):**
-- Integration tests for TUI transition
-- Accessibility test cases
-- Memory leak detection (valgrind, -race)
-
-⚠️ **Priority 3 (Nice-to-have):**
-- Visual regression tests (screenshot comparison)
-- Load testing (rapid restarts)
-- Fuzz testing (malformed config files)
-
-**Qwen's Verdict:** ✅ Testing strategy is comprehensive and realistic.
-
----
-
-## Phase Breakdown: 5-Week Execution Plan
-
-### 🏗️ Week 1: Foundation (Core Engine)
-
-**Goal:** Build rock-solid torus rendering engine with perfect math.
-
-**Deliverables:**
-1. ✅ `cortex.go` - 3D torus renderer with z-buffer
-2. ✅ `ansi.go` - Color gradient utilities
-3. ✅ Unit tests passing (math correctness)
-4. ✅ Benchmark: <1ms per frame
-
-**Tasks:**
-- **Day 1-2:** Port donut algorithm to Go
-  - Implement torus parametric equations
-  - Add rotation matrices (Rx, Rz)
-  - Perspective projection
-  - Z-buffer depth sorting
-
-- **Day 3-4:** Optimize rendering
-  - Preallocate buffers (screen, zbuffer)
-  - Test on 80×24, 120×40, 160×60 terminals
-  - Profile with pprof (identify hotspots)
-  - Add frame rate limiter (30 FPS)
-
-- **Day 5:** Color system
-  - ANSI truecolor utilities
-  - Cyan-to-magenta gradient (based on angle)
-  - 256-color fallback for limited terminals
-  - Luminance-based character selection
-
-- **Day 6-7:** Testing & documentation
-  - Write unit tests (geometry, zbuffer, colors)
-  - Benchmark performance (target: <1ms)
-  - Code review with self (Claude perspective)
-  - Document math in comments
-
-**Success Criteria:**
-- ✅ Torus renders correctly (no visual artifacts)
-- ✅ Rotation is smooth (30 FPS minimum)
-- ✅ Colors are vibrant (cyan/magenta gradient)
-- ✅ Tests pass on macOS/Linux/Windows
-
-**Risks:**
-- ⚠️ Math errors causing distortion → Mitigate: Reference images from donut.c
-- ⚠️ Performance too slow → Mitigate: Profile early, optimize hotspots
-
----
-
-### 🎬 Week 2: Animations (3-Act Sequence)
-
-**Goal:** Build boot sequence (Act 1) and closer screen (Act 3).
-
-**Deliverables:**
-1. ✅ `bootsequence.go` - Act 1 animation (models coming online)
-2. ✅ `closer.go` - Act 3 static screen (power message)
-3. ✅ `splash.go` - Orchestrator (3-act state machine)
-4. ✅ Smooth transitions between acts
-
-**Tasks:**
-- **Day 1-2:** Boot sequence (Act 1)
-  ```
-  > [RYCODE NEURAL CORTEX v1.0.0]
-  > ├─ Claude ▸ Logical Reasoning: ONLINE ✅
-  > ├─ Gemini ▸ System Architecture: ONLINE ✅
-  > ├─ Codex ▸ Code Generation: ONLINE ✅
-  > ├─ Qwen ▸ Research Pipeline: ONLINE ✅
-  > ├─ Grok ▸ Humor & Chaos Engine: ONLINE ✅
-  > └─ GPT ▸ Language Core: ONLINE ✅
-  >
-  > ⚡ SIX MINDS. ONE COMMAND LINE.
-  ```
-  - Implement line-by-line reveal (100ms delays)
-  - Add typing effect for dramatic flair
-  - Color code each model name
-
-- **Day 3-4:** Closer screen (Act 3)
-  ```
-  ╔═══════════════════════════════════════════════╗
-  ║                                               ║
-  ║        🌀 RYCODE NEURAL CORTEX ACTIVE         ║
-  ║                                               ║
-  ║      "Every LLM fused. Every edge case        ║
-  ║       covered. You're not just coding—        ║
-  ║       you're orchestrating intelligence."     ║
-  ║                                               ║
-  ║             Press any key to begin            ║
-  ║                                               ║
-  ╚═══════════════════════════════════════════════╝
-  ```
-  - Box drawing characters for border
-  - Center text alignment
-  - Subtle color pulse effect (optional)
-
-- **Day 5-6:** Orchestrator (splash.go)
-  - Bubble Tea Model/Update/View pattern
-  - Frame counter and act transitions
-  - Skip key handler ('s' or ESC)
-  - Timing: 1s boot + 3s cortex + 1s closer = 5s total
-
-- **Day 7:** Integration & polish
-  - Smooth transitions (fade effects optional)
-  - Test all 3 acts in sequence
-  - Verify skip functionality
-  - Ensure consistent frame rate
-
-**Success Criteria:**
-- ✅ All 3 acts render correctly
-- ✅ Transitions are smooth (no jarring cuts)
-- ✅ Skip key works instantly
-- ✅ Total duration: 5 seconds
-
-**Risks:**
-- ⚠️ Timing feels off → Mitigate: A/B test with 3s vs 5s vs 7s
-- ⚠️ Text alignment issues → Mitigate: Test on multiple terminal sizes
-
----
-
-### 🔌 Week 3: Integration (CLI Entry Point)
-
-**Goal:** Seamlessly integrate splash into RyCode's launch flow.
-
-**Deliverables:**
-1. ✅ First-run detection logic
-2. ✅ Config system for splash preferences
-3. ✅ `main.go` integration
-4. ✅ Graceful fallbacks for errors
-
-**Tasks:**
-- **Day 1-2:** First-run detection
-  - Check for `~/.rycode/splash_shown` marker file
-  - On first run: Show splash, create marker
-  - On subsequent runs: Respect config or random (10%)
-
-- **Day 3:** Config system
-  ```go
-  type Config struct {
-      SplashEnabled  bool    `json:"splash_enabled"`
-      ReducedMotion  bool    `json:"reduced_motion"`
-      SplashFrequency string `json:"splash_frequency"` // "always", "first", "random", "never"
-  }
-  ```
-  - Load from `~/.rycode/config.json`
-  - Respect accessibility preferences
-  - Default: First run + 10% random
-
-- **Day 4-5:** Main.go integration
-  ```go
-  func main() {
-      // Splash decision
-      if shouldShowSplash() {
-          runSplash()
-      }
-
-      // Main TUI
-      runMainTUI()
-  }
-  ```
-  - Separate Bubble Tea programs (splash → TUI)
-  - Error handling: If splash crashes, continue to TUI
-  - Clear screen between splash and TUI
-
-- **Day 6:** Fallback modes
-  - Terminal too small (<80×24) → Show text version
-  - No color support → Monochrome mode
-  - Performance issues → Static image version
-
-- **Day 7:** End-to-end testing
-  - Test first run experience
-  - Test skip functionality
-  - Test with various config settings
-  - Test on all 5 platforms
-
-**Success Criteria:**
-- ✅ First run shows splash automatically
-- ✅ Config respects user preferences
-- ✅ Splash never blocks main TUI launch
-- ✅ Fallbacks work gracefully
-
-**Risks:**
-- ⚠️ Config file corruption → Mitigate: JSON schema validation + defaults
-- ⚠️ Splash crashes on exotic terminal → Mitigate: Panic recovery + skip to TUI
-
----
-
-### ✨ Week 4: Polish (Visual Excellence)
-
-**Goal:** Fine-tune every visual detail for maximum impact.
-
-**Deliverables:**
-1. ✅ Color palette refinement
-2. ✅ Easter eggs implementation
-3. ✅ Performance optimization on slow systems
-4. ✅ Cross-platform testing complete
-
-**Tasks:**
-- **Day 1-2:** Color tuning
-  - A/B test gradient variations:
-    - Option A: Pure cyan → magenta
-    - Option B: Cyan → blue → magenta
-    - Option C: Cyan → magenta → gold accents
-  - Adjust luminance mapping (character selection)
-  - Test on different terminal color schemes
-
-- **Day 3:** Easter eggs
-  - `/donut` command → Show rotating donut (original algorithm)
-  - Hidden message in cortex: Embed "CLAUDE WAS HERE" in z-buffer
-  - Konami code during splash → Rainbow colors
-  - Press '?' during splash → Show math equations
-
-- **Day 4-5:** Performance tuning
-  - Test on low-end systems (Raspberry Pi, old laptops)
-  - Add adaptive frame rate (30 FPS → 15 FPS on slow systems)
-  - Optimize for Windows CMD (limited unicode)
-  - Profile memory usage (target: <10 MB)
-
-- **Day 6-7:** Cross-platform validation
-  - Test on all 5 platforms (see Qwen's matrix)
-  - Fix terminal-specific issues
-  - Document known limitations
-  - Create fallback screenshots (for docs)
-
-**Success Criteria:**
-- ✅ Colors are perfect (vibrant, high contrast)
-- ✅ Easter eggs are discoverable (20% find rate)
-- ✅ Performance is smooth on 90% of systems
-- ✅ Zero crashes on primary platforms
-
-**Risks:**
-- ⚠️ Colors look bad on light themes → Mitigate: Detect theme, adjust palette
-- ⚠️ Easter eggs too obscure → Mitigate: Add hints in docs
-
----
-
-### 🚀 Week 5: Launch (Marketing & Distribution)
-
-**Goal:** Coordinate splash launch with marketing push for maximum impact.
-
-**Deliverables:**
-1. ✅ Demo video (30-second splash recording)
-2. ✅ Landing page update (showcase splash)
-3. ✅ Social media assets (GIFs, screenshots)
-4. ✅ Documentation (how to customize/disable)
-
-**Tasks:**
-- **Day 1-2:** Create demo video
-  - Record splash in high-resolution terminal
-  - Add captions: "100% AI-Designed", "Zero Compromises"
-  - Post to:
-    - Twitter/X (with #CLI #AI #Terminal hashtags)
-    - Reddit (r/programming, r/commandline)
-    - Hacker News (Show HN: RyCode's 3D ASCII splash)
-    - LinkedIn (Aaron's profile)
-
-- **Day 3:** Landing page update
-  - Add splash video above the fold
-  - "What Makes RyCode Undeniably Superior" section
-  - GIF showing skip functionality
-  - Easter egg hints (generate curiosity)
-
-- **Day 4:** Social media campaign
-  - Day 1: Teaser ("Something's coming...")
-  - Day 2: Math reveal ("We ported the donut algorithm")
-  - Day 3: Full launch (video + link)
-  - Day 4-7: Engagement (respond to comments, share UGC)
-
-- **Day 5:** Documentation
-  - Add to README.md (splash section)
-  - Create SPLASH.md (technical deep dive)
-  - Document config options
-  - List known easter eggs (after 1 week)
-
-- **Day 6-7:** Monitoring & iteration
-  - Track GitHub stars (target: 500+ week 1)
-  - Monitor social impressions (target: 100k+)
-  - Collect user feedback (Twitter, Issues)
-  - Hot-fix any critical bugs
-
-**Success Criteria:**
-- ✅ 500+ GitHub stars in week 1
-- ✅ 100k+ social media impressions
-- ✅ 50+ positive comments/reactions
-- ✅ 0 critical bugs reported
-
-**Risks:**
-- ⚠️ Launch timing conflicts → Mitigate: Check tech news calendar
-- ⚠️ Video doesn't go viral → Mitigate: Seed with influencers
-- ⚠️ Negative feedback on splash → Mitigate: Emphasize easy disable
-
----
-
-## Risk Matrix & Mitigation
-
-### 🔴 HIGH PRIORITY RISKS
-
-| Risk | Probability | Impact | Mitigation Strategy |
-|------|-------------|--------|---------------------|
-| **Performance on slow terminals** | 60% | High | Adaptive frame rate (30→15 FPS), static fallback |
-| **Terminal compatibility issues** | 40% | High | Extensive cross-platform testing, graceful degradation |
-| **Users find splash overwhelming** | 30% | Medium | Easy skip ('s' key), config to disable, first-run only default |
-| **Splash crashes block TUI launch** | 20% | Critical | Panic recovery, error → skip to TUI, never block main app |
-
-**Mitigation Plan:**
-
-**1. Performance Risk**
-```go
-// Adaptive frame rate based on actual rendering time
-func (r *CortexRenderer) adaptiveFrameRate() time.Duration {
-    if r.lastFrameTime > 50*time.Millisecond {
-        return 66 * time.Millisecond  // 15 FPS
-    }
-    return 33 * time.Millisecond  // 30 FPS
-}
-
-// Static fallback for very slow systems
-if averageFrameTime > 100*time.Millisecond {
-    showStaticSplash()  // Single frame, no animation
-}
-```
-
-**2. Compatibility Risk**
-```go
-// Detect terminal capabilities
-func detectTerminalCapabilities() TerminalCaps {
-    caps := TerminalCaps{}
-
-    // Color support
-    if os.Getenv("COLORTERM") == "truecolor" {
-        caps.Colors = Truecolor  // 16 million colors
-    } else if strings.Contains(os.Getenv("TERM"), "256color") {
-        caps.Colors = Colors256
-    } else {
-        caps.Colors = Colors16
-    }
-
-    // Unicode support
-    caps.Unicode = !isWindowsCMD()
-
-    // Size
-    width, height, _ := term.GetSize(int(os.Stdout.Fd()))
-    caps.Width = width
-    caps.Height = height
-
-    return caps
-}
-
-// Fallback decision
-if caps.Width < 80 || caps.Height < 24 {
-    showTextSplash()  // No graphics, just text
-} else if caps.Colors < Colors256 {
-    showMonochromeSplash()  // Grayscale version
-}
-```
-
-**3. User Overwhelm Risk**
-```go
-// Config defaults
-defaultConfig := Config{
-    SplashEnabled: true,
-    SplashFrequency: "first",  // Only first run
-    ReducedMotion: false,
-}
-
-// Respect system accessibility
-if os.Getenv("PREFERS_REDUCED_MOTION") == "1" {
-    config.ReducedMotion = true
-}
-
-// Easy skip (prominent in splash)
-"Press 'S' to skip | ESC to disable forever"
-```
-
-**4. Crash Risk**
-```go
-// Panic recovery wrapper
-func runSplashSafely() {
-    defer func() {
-        if r := recover(); r != nil {
-            log.Error("Splash crashed, continuing to TUI", "error", r)
-            // Don't rethrow - just continue to main TUI
-        }
-    }()
-
-    // Run splash
-    p := tea.NewProgram(splash.New())
-    p.Run()
-}
-```
-
-### 🟡 MEDIUM PRIORITY RISKS
-
-| Risk | Probability | Impact | Mitigation Strategy |
-|------|-------------|--------|---------------------|
-| **Colors look bad on light themes** | 50% | Medium | Detect theme, adjust palette dynamically |
-| **Math errors cause visual bugs** | 20% | Medium | Extensive unit tests, reference screenshots |
-| **Easter eggs too obscure** | 60% | Low | Add hints in docs after 1 week |
-| **Launch timing conflicts** | 30% | Medium | Monitor tech news calendar, flexible launch date |
-
-### 🟢 LOW PRIORITY RISKS
-
-| Risk | Probability | Impact | Mitigation Strategy |
-|------|-------------|--------|---------------------|
-| **Memory leaks during animation** | 10% | Low | Test with valgrind, Go race detector |
-| **Config file corruption** | 5% | Low | JSON validation, fallback to defaults |
-| **Video doesn't go viral** | 70% | Low | Focus on quality, seed with influencers |
-
----
-
-## Success Metrics & Validation
-
-### 📊 Technical Metrics
-
-**Performance:**
-- ✅ **Frame rate:** ≥30 FPS on modern systems (measured with pprof)
-- ✅ **Startup overhead:** <50ms added to launch time
-- ✅ **Memory usage:** <10 MB for splash module
-- ✅ **Binary size:** <500 KB added to final binary
-
-**Reliability:**
-- ✅ **Crash rate:** 0% on 5 primary platforms (macOS, Linux, Windows)
-- ✅ **Fallback success:** 100% (always degrade gracefully)
-- ✅ **Skip success:** 100% (pressing 's' always works)
-
-**Compatibility:**
-- ✅ **Primary platforms:** Full support (5/5)
-  - macOS (ARM64, Intel)
-  - Linux (AMD64, ARM64)
-  - Windows (AMD64)
-- ✅ **Terminal emulators:** 90%+ compatibility
-  - Terminal.app, iTerm2, Warp (macOS)
-  - gnome-terminal, xterm, konsole (Linux)
-  - Windows Terminal, PowerShell (Windows)
-
-### 🎯 User Metrics
-
-**Engagement:**
-- ✅ **Completion rate:** ≥80% watch full splash (don't skip)
-- ✅ **Easter egg discovery:** ≥20% find at least one
-- ✅ **Disable rate:** <10% permanently disable splash
-
-**Satisfaction:**
-- ✅ **Positive feedback:** >80% positive comments (Twitter, Issues)
-- ✅ **Feature requests:** "More animations!" (qualitative)
-- ✅ **Bug reports:** <5 compatibility issues reported
-
-### 🚀 Marketing Metrics
-
-**Reach:**
-- ✅ **GitHub stars:** 500+ in week 1 (from current ~100)
-- ✅ **Social impressions:** 100k+ (Twitter + Reddit + HN)
-- ✅ **Video views:** 10k+ on Twitter
-- ✅ **Media coverage:** 1+ tech blog writeup
-
-**Virality:**
-- ✅ **Shares:** 100+ retweets/shares
-- ✅ **UGC:** Users post their own recordings
-- ✅ **Memes:** Community creates memes (highest honor!)
-
-### 📈 Measurement Plan
-
-**Week 1-2 (Development):**
-```bash
-# Performance benchmarks
-go test -bench=. -benchtime=5s
-go test -benchmem
-go test -cpuprofile=cpu.prof
-
-# Target: <1ms per frame, 0 allocs
-```
-
-**Week 3 (Integration):**
-```bash
-# Cross-platform smoke tests
-GOOS=darwin GOARCH=arm64 go build && ./test-splash.sh
-GOOS=linux GOARCH=amd64 go build && ./test-splash.sh
-GOOS=windows GOARCH=amd64 go build && ./test-splash.sh
-
-# Target: 0 crashes, graceful fallbacks
-```
-
-**Week 4-5 (Launch):**
-```bash
-# User telemetry (opt-in, anonymous)
-- splash_shown: true
-- splash_completed: true/false (did they skip?)
-- splash_duration: 5.2s
-- terminal_size: 120x40
-- platform: darwin/arm64
-
-# Aggregate weekly, track trends
-```
-
-**Post-Launch:**
-- Monitor GitHub Issues for bug reports
-- Track Twitter mentions (positive/negative sentiment)
-- Analyze GitHub star growth rate
-- Collect feedback in Discussions
-
----
-
-## Go/No-Go Decision Framework
-
-### ✅ GO Criteria (Must meet ALL)
-
-**Technical:**
-- [x] Torus renders correctly (no visual artifacts)
-- [x] Performance ≥30 FPS on test systems
-- [x] Zero crashes on macOS/Linux/Windows
-- [x] Graceful fallbacks implemented
-
-**User Experience:**
-- [x] Skip functionality works instantly
-- [x] Accessibility modes respected (reduced motion)
-- [x] Config system allows disable
-- [x] Total duration ≤5 seconds
-
-**Quality:**
-- [x] All unit tests passing
-- [x] Cross-platform testing complete
-- [x] Code review completed (self + peer)
-- [x] Documentation written
-
-**Marketing:**
-- [x] Demo video recorded (30+ seconds)
-- [x] Landing page updated
-- [x] Social media assets ready
-- [x] Launch announcement drafted
-
-### 🛑 NO-GO Triggers (Any ONE blocks launch)
-
-**Technical:**
-- [ ] Crash rate >1% on primary platforms
-- [ ] Performance <15 FPS on modern systems
-- [ ] Splash blocks TUI launch (critical path failure)
-- [ ] Security vulnerability discovered (credential exposure, etc.)
-
-**User Experience:**
-- [ ] >50% of testers find splash "annoying"
-- [ ] Skip functionality fails
-- [ ] Accessibility issues reported
-- [ ] Config system doesn't work
-
-**Business:**
-- [ ] Negative feedback from key stakeholders
-- [ ] Timing conflict with major tech event
-- [ ] Legal/IP concerns (donut algorithm licensing)
-
-### 🔄 DELAY Triggers (Postpone 1 week)
-
-- [ ] Cross-platform testing incomplete (missing platform)
-- [ ] Easter eggs not implemented (nice-to-have)
-- [ ] Demo video quality insufficient
-- [ ] Minor bugs need polish
-
----
-
-## Resource Requirements
-
-### 👨‍💻 Team
-
-**Development:**
-- 1× Developer (Go experience) - 35 days full-time
-  - Week 1-2: Core engine (torus, colors)
-  - Week 3: Integration
-  - Week 4: Polish
-  - Week 5: Launch support
-
-**Testing:**
-- 1× QA Engineer (part-time) - 10 days
-  - Week 3: Integration testing
-  - Week 4: Cross-platform validation
-  - Week 5: Post-launch monitoring
-
-**Marketing:**
-- 1× Developer/Marketer (dual role) - 5 days
-  - Week 5: Video production, social posts, landing page
-
-**Total Effort:** ~40 person-days (1.5 FTE for 5 weeks)
-
-### 🛠️ Tools & Infrastructure
-
-**Development:**
-- Go 1.21+ (already installed)
-- Bubble Tea framework (already in use)
-- Testing: `go test`, `pprof`, `go-race`
-- Cross-compilation: Docker or native builds
-
-**Testing:**
-- 5× Test machines/VMs (macOS, Linux, Windows, Raspberry Pi)
-- Terminal emulators: 10+ for compatibility testing
-- Screen recording: Asciinema, OBS, QuickTime
-
-**Marketing:**
-- Video editing: iMovie, Final Cut Pro, or DaVinci Resolve
-- GIF creation: gifski, Gifox
-- Social media: Buffer or Hootsuite (scheduling)
-
-**Budget:**
-- $0 (all tools are free or already licensed)
-- Optional: $100 for video editing software (if needed)
-
-### 📚 Dependencies
-
-**External:**
-- Bubble Tea framework (stable, no updates needed)
-- Lipgloss v2 (color utilities)
-- Terminal size detection (golang.org/x/term)
-
-**Internal:**
-- Config system (already exists)
-- First-run detection (onboarding system)
-- Accessibility settings (already exists)
-
-**No blockers:** All dependencies are stable and available.
-
----
-
-## Timeline Summary
-
-```
-Week 1: Foundation         [████████████████████░░░░] 80% Core
-  ├─ Torus renderer
-  ├─ Color utilities
-  ├─ Unit tests
-  └─ Benchmarks
-
-Week 2: Animations         [████████████████████░░░░] 80% Core
-  ├─ Boot sequence
-  ├─ Closer screen
-  ├─ Orchestrator
-  └─ Transitions
-
-Week 3: Integration        [████████████████░░░░░░░░] 70% Core
-  ├─ First-run detection
-  ├─ Config system
-  ├─ Main.go hook
-  └─ Fallbacks
-
-Week 4: Polish             [████████████░░░░░░░░░░░░] 50% Polish
-  ├─ Color tuning
-  ├─ Easter eggs
-  ├─ Performance optimization
-  └─ Cross-platform testing
-
-Week 5: Launch             [████████░░░░░░░░░░░░░░░░] 30% Marketing
-  ├─ Demo video
-  ├─ Landing page
-  ├─ Social campaign
-  └─ Monitoring
-
-Total: 5 weeks, 40 person-days
-```
-
----
-
-## Conclusion: Ready to Execute
-
-### 🎯 Final Recommendation
-
-**PROCEED WITH IMPLEMENTATION** based on:
-
-✅ **Technical Feasibility:** 4/4 agents confirm (Claude, Codex, Gemini, Qwen)
-✅ **Risk Management:** All high-priority risks have mitigation strategies
-✅ **Resource Availability:** 1.5 FTE for 5 weeks is achievable
-✅ **Success Probability:** 85% confidence in hitting all technical metrics
-✅ **Marketing Potential:** High virality potential (3D ASCII + AI narrative)
-
-### 🚀 Next Steps
-
-1. **Approve this plan** (review with stakeholders)
-2. **Set up development branch** (`feature/epic-splash`)
-3. **Start Week 1** (core engine development)
-4. **Weekly check-ins** (Monday: review progress, adjust timeline)
-5. **Go/No-Go decision at Week 4 end** (before launch prep)
-
-### 📞 Sign-Off
-
-**Validated by:**
-- ✅ Claude (Architecture): "Clean design, no technical debt"
-- ✅ Codex (Algorithms): "Math is sound, performance achievable"
-- ✅ Gemini (Systems): "Integration points well-defined"
-- ✅ Qwen (Testing): "Comprehensive test strategy"
-
-**Approval Required From:**
-- [ ] Aaron (Product Owner)
-- [ ] Technical Reviewer
-- [ ] Marketing Team (for launch coordination)
-
----
-
-**🤖 This plan demonstrates what's possible when AI designs implementation roadmaps with obsessive attention to detail.**
-
-**Built with ❤️ by Claude AI**
-
-*5 weeks to epic splash. Let's ship this.*
diff --git a/packages/tui/SPLASH_INTEGRATION_TEST.md b/packages/tui/SPLASH_INTEGRATION_TEST.md
deleted file mode 100644
index 57681d40..00000000
--- a/packages/tui/SPLASH_INTEGRATION_TEST.md
+++ /dev/null
@@ -1,782 +0,0 @@
-# RyCode Splash Screen Integration Testing
-
-> **Comprehensive test plan for splash screen integration with RyCode server**
-
----
-
-## 📊 Integration Status
-
-### ✅ Code Integration Complete
-
-**File:** `cmd/rycode/main.go`
-
-**Integration Points:**
-1. **Line 19:** Import splash package
-   ```go
-   "github.com/aaronmrosenthal/rycode/internal/splash"
-   ```
-
-2. **Lines 37-38:** Command-line flags
-   ```go
-   var showSplashFlag *bool = flag.Bool("splash", false, "force show splash screen")
-   var noSplashFlag *bool = flag.Bool("no-splash", false, "skip splash screen")
-   ```
-
-3. **Lines 41-45:** Easter egg command
-   ```go
-   if len(flag.Args()) > 0 && flag.Args()[0] == "donut" {
-       runDonutMode()
-       return
-   }
-   ```
-
-4. **Lines 133-171:** Splash display function
-   ```go
-   showSplash := func() {
-       // Command-line flag overrides
-       if *noSplashFlag {
-           return // Skip splash
-       }
-
-       config, err := splash.LoadConfig()
-       if err != nil {
-           config = splash.DefaultConfig()
-       }
-
-       // Force show with --splash flag
-       shouldShow := *showSplashFlag || splash.ShouldShowSplash(config)
-
-       if shouldShow {
-           defer func() {
-               if r := recover(); r != nil {
-                   slog.Warn("Splash screen crashed, continuing to TUI", "error", r)
-               }
-           }()
-
-           splashModel := splash.New()
-           splashProgram := tea.NewProgram(splashModel, tea.WithAltScreen())
-           if _, err := splashProgram.Run(); err != nil {
-               slog.Warn("Splash screen failed, continuing to TUI", "error", err)
-           }
-
-           // Mark splash as shown (unless forced with --splash)
-           if !*showSplashFlag {
-               if err := splash.MarkAsShown(); err != nil {
-                   slog.Warn("Failed to mark splash as shown", "error", err)
-               }
-           }
-
-           // Clear screen after splash for clean transition
-           clearScreen()
-       }
-   }
-   ```
-
-5. **Line 173:** Splash invoked before TUI
-   ```go
-   showSplash()
-   ```
-
-6. **Lines 224-231:** Donut mode easter egg
-   ```go
-   func runDonutMode() {
-       model := splash.NewDonutMode()
-       program := tea.NewProgram(model, tea.WithAltScreen())
-       if _, err := program.Run(); err != nil {
-           slog.Error("Donut mode error", "error", err)
-       }
-   }
-   ```
-
-7. **Lines 233-237:** Screen clearing for clean transition
-   ```go
-   func clearScreen() {
-       // ANSI escape code to clear screen and move cursor to top-left
-       os.Stdout.WriteString("\033[2J\033[H")
-   }
-   ```
-
----
-
-## 🧪 Test Scenarios
-
-### Scenario 1: First Launch (Default Behavior)
-
-**Prerequisites:**
-- No existing `~/.rycode/config.json` or `splash_shown: false`
-- RyCode server running at `http://127.0.0.1:4096`
-
-**Test Steps:**
-```bash
-# 1. Clean config
-rm -f ~/.rycode/config.json
-
-# 2. Launch RyCode
-./rycode-test
-```
-
-**Expected Behavior:**
-1. ✅ Splash screen appears (3-act animation)
-2. ✅ Boot sequence (~1 second)
-3. ✅ Rotating cortex (~3 seconds)
-4. ✅ Closer screen (~1 second)
-5. ✅ Auto-closes after 5 seconds
-6. ✅ Clean transition to TUI
-7. ✅ `~/.rycode/config.json` created with `splash_shown: true`
-
-**Verification:**
-```bash
-# Check config was updated
-cat ~/.rycode/config.json | grep splash_shown
-# Should show: "splash_shown": true
-```
-
----
-
-### Scenario 2: Second Launch (Already Shown)
-
-**Prerequisites:**
-- `~/.rycode/config.json` exists with `splash_shown: true`
-- Default frequency: `"first"`
-
-**Test Steps:**
-```bash
-# Launch again
-./rycode-test
-```
-
-**Expected Behavior:**
-1. ✅ Splash screen SKIPPED
-2. ✅ Direct launch to TUI
-3. ✅ No delay
-
----
-
-### Scenario 3: Force Show with --splash Flag
-
-**Test Steps:**
-```bash
-./rycode-test --splash
-```
-
-**Expected Behavior:**
-1. ✅ Splash screen appears (even if already shown)
-2. ✅ Full 3-act animation
-3. ✅ Config NOT updated (doesn't reset `splash_shown`)
-4. ✅ Clean transition to TUI
-
----
-
-### Scenario 4: Skip with --no-splash Flag
-
-**Test Steps:**
-```bash
-./rycode-test --no-splash
-```
-
-**Expected Behavior:**
-1. ✅ Splash screen skipped
-2. ✅ Direct launch to TUI
-3. ✅ Config NOT modified
-
----
-
-### Scenario 5: Infinite Donut Mode (Easter Egg)
-
-**Test Steps:**
-```bash
-./rycode-test donut
-```
-
-**Expected Behavior:**
-1. ✅ Infinite cortex animation starts immediately
-2. ✅ No TUI launch (donut mode only)
-3. ✅ Smooth 30 FPS rotation
-4. ✅ Press `Q` to quit
-5. ✅ Process exits cleanly
-
-**Additional Tests:**
-```bash
-# While in donut mode:
-# 1. Press ? to show math equations
-# 2. Press ↑↑↓↓←→←→BA for rainbow mode
-# 3. Press Q to quit
-```
-
----
-
-### Scenario 6: Frequency Mode - Always
-
-**Prerequisites:**
-- Edit `~/.rycode/config.json`:
-  ```json
-  {
-    "splash_frequency": "always"
-  }
-  ```
-
-**Test Steps:**
-```bash
-./rycode-test
-```
-
-**Expected Behavior:**
-1. ✅ Splash shows on EVERY launch
-2. ✅ Even after multiple runs
-
-**Verification:**
-```bash
-# Run multiple times
-for i in {1..3}; do
-  echo "Launch $i"
-  ./rycode-test --no-splash  # Use flag to skip after first test
-  sleep 1
-done
-```
-
----
-
-### Scenario 7: Frequency Mode - Never
-
-**Prerequisites:**
-- Edit `~/.rycode/config.json`:
-  ```json
-  {
-    "splash_enabled": false
-  }
-  ```
-
-**Test Steps:**
-```bash
-./rycode-test
-```
-
-**Expected Behavior:**
-1. ✅ Splash NEVER shows
-2. ✅ Direct launch to TUI
-
-**Override Test:**
-```bash
-# Should still work with --splash flag
-./rycode-test --splash
-# ✅ Splash appears
-```
-
----
-
-### Scenario 8: Frequency Mode - Random (10% chance)
-
-**Prerequisites:**
-- Edit `~/.rycode/config.json`:
-  ```json
-  {
-    "splash_frequency": "random"
-  }
-  ```
-
-**Test Steps:**
-```bash
-# Launch 20 times (should show ~2 times statistically)
-for i in {1..20}; do
-  echo "Launch $i"
-  ./rycode-test
-  sleep 0.5
-done
-```
-
-**Expected Behavior:**
-1. ✅ Splash appears ~2 times out of 20 (10% probability)
-2. ✅ Random distribution
-
----
-
-### Scenario 9: Reduced Motion Accessibility
-
-**Prerequisites:**
-- Set environment variable:
-  ```bash
-  export PREFERS_REDUCED_MOTION=1
-  ```
-
-**Test Steps:**
-```bash
-./rycode-test --splash
-```
-
-**Expected Behavior:**
-1. ✅ Text-only fallback mode
-2. ✅ No animation
-3. ✅ Static splash screen
-
-**Cleanup:**
-```bash
-unset PREFERS_REDUCED_MOTION
-```
-
----
-
-### Scenario 10: No Color Mode
-
-**Prerequisites:**
-```bash
-export NO_COLOR=1
-```
-
-**Test Steps:**
-```bash
-./rycode-test --splash
-```
-
-**Expected Behavior:**
-1. ✅ Monochrome ASCII art
-2. ✅ No color codes
-3. ✅ Still functional
-
-**Cleanup:**
-```bash
-unset NO_COLOR
-```
-
----
-
-### Scenario 11: Small Terminal (Auto-skip)
-
-**Test Steps:**
-```bash
-# Resize terminal to <60 columns or <20 rows
-# Or use stty to simulate
-stty rows 15 cols 50
-./rycode-test --splash
-stty rows 50 cols 120  # Reset
-```
-
-**Expected Behavior:**
-1. ✅ Splash automatically skipped (terminal too small)
-2. ✅ Direct launch to TUI
-3. ✅ No error messages
-
----
-
-### Scenario 12: Server Connection Failure Handling
-
-**Test Steps:**
-```bash
-# Stop RyCode server (or set invalid URL)
-export RYCODE_SERVER=http://127.0.0.1:9999
-./rycode-test --splash
-```
-
-**Expected Behavior:**
-1. ✅ Splash appears BEFORE server connection
-2. ✅ Splash completes successfully
-3. ❌ TUI fails to start (expected - server down)
-4. ✅ Error message shown AFTER splash
-
-**Cleanup:**
-```bash
-unset RYCODE_SERVER
-```
-
----
-
-### Scenario 13: Crash Recovery (Panic in Splash)
-
-**Note:** This tests the defer/recover mechanism
-
-**Expected Behavior:**
-1. ✅ If splash panics, recover catches it
-2. ✅ Warning logged: "Splash screen crashed, continuing to TUI"
-3. ✅ TUI starts normally
-4. ✅ User sees TUI, not a crash
-
----
-
-### Scenario 14: Skip Controls (S and ESC)
-
-**Test Steps:**
-```bash
-./rycode-test --splash
-# Immediately press 'S'
-```
-
-**Expected Behavior:**
-1. ✅ Splash exits immediately
-2. ✅ TUI starts
-3. ✅ Config NOT modified (S = skip once)
-
-**ESC Test:**
-```bash
-./rycode-test --splash
-# Immediately press 'ESC'
-```
-
-**Expected Behavior:**
-1. ✅ Splash exits immediately
-2. ✅ TUI starts
-3. ✅ Config updated: `splash_enabled: false`
-
-**Verification:**
-```bash
-cat ~/.rycode/config.json | grep splash_enabled
-# Should show: "splash_enabled": false
-
-# Next launch should skip
-./rycode-test
-# ✅ No splash
-```
-
----
-
-## 🔍 Integration Points Verification
-
-### 1. Bubble Tea Compatibility
-
-**Test:**
-```bash
-./rycode-test --splash
-```
-
-**Verify:**
-- ✅ Splash uses `tea.WithAltScreen()` correctly
-- ✅ Screen cleared after splash (`clearScreen()`)
-- ✅ TUI starts in clean alternate screen
-- ✅ No visual artifacts or leftover characters
-
----
-
-### 2. Configuration Persistence
-
-**Test:**
-```bash
-# First launch
-rm -f ~/.rycode/config.json
-./rycode-test
-
-# Check config created
-cat ~/.rycode/config.json
-
-# Modify config
-echo '{"splash_frequency": "always", "reduced_motion": true}' > ~/.rycode/config.json
-
-# Second launch
-./rycode-test --splash
-
-# Verify reduced motion respected
-```
-
-**Expected `~/.rycode/config.json` after first launch:**
-```json
-{
-  "splash_enabled": true,
-  "splash_frequency": "first",
-  "splash_shown": true,
-  "reduced_motion": false,
-  "color_mode": "auto"
-}
-```
-
----
-
-### 3. Signal Handling
-
-**Test:**
-```bash
-# Launch and send SIGTERM during splash
-./rycode-test --splash &
-PID=$!
-sleep 2
-kill -TERM $PID
-```
-
-**Expected Behavior:**
-- ✅ Splash exits gracefully
-- ✅ No panic or crash
-- ✅ Process terminates cleanly
-
----
-
-### 4. Stdin Handling (Piped Input)
-
-**Test:**
-```bash
-echo "Test prompt" | ./rycode-test --splash
-```
-
-**Expected Behavior:**
-- ✅ Splash shows normally
-- ✅ Piped input preserved for TUI
-- ✅ No interference between splash and stdin
-
----
-
-### 5. Concurrent Goroutines
-
-**Integration Point:** Lines 126-131, 192-202, 204
-
-**Test:**
-```bash
-./rycode-test --splash
-# While splash is running, server events should NOT interfere
-```
-
-**Verify:**
-- ✅ Clipboard init goroutine doesn't block splash
-- ✅ Event streaming goroutine waits for TUI
-- ✅ API server starts after splash
-- ✅ No race conditions
-
----
-
-## 📊 Performance Verification
-
-### Startup Overhead
-
-**Test:**
-```bash
-# Without splash
-time ./rycode-test --no-splash
-
-# With splash (force)
-time ./rycode-test --splash
-```
-
-**Expected:**
-- Splash overhead: ~5 seconds (animation duration)
-- Actual render overhead: <10ms
-- No lag or freeze
-
-### Memory Usage
-
-**Test:**
-```bash
-# Monitor memory during splash
-/usr/bin/time -l ./rycode-test --splash
-```
-
-**Expected:**
-- Splash memory: ~2MB additional
-- No memory leaks
-- Clean release after transition
-
----
-
-## 🐛 Error Scenarios
-
-### 1. Invalid Config File
-
-**Test:**
-```bash
-echo "invalid json {{{" > ~/.rycode/config.json
-./rycode-test --splash
-```
-
-**Expected:**
-- ✅ Falls back to default config
-- ✅ Splash shows normally (default: first launch)
-- ⚠️ Warning logged: "Failed to load config"
-
-### 2. Config Write Failure
-
-**Test:**
-```bash
-# Make config directory read-only
-mkdir -p ~/.rycode
-chmod 000 ~/.rycode
-./rycode-test --splash
-chmod 755 ~/.rycode  # Restore
-```
-
-**Expected:**
-- ✅ Splash shows normally
-- ⚠️ Warning logged: "Failed to mark splash as shown"
-- ✅ TUI starts
-
-### 3. Terminal Too Small (Edge Case)
-
-**Test:**
-```bash
-stty rows 10 cols 30
-./rycode-test --splash
-stty rows 50 cols 120
-```
-
-**Expected:**
-- ✅ Fallback to text-only or skip
-- ✅ No crash
-- ✅ Clean degradation
-
----
-
-## ✅ Integration Test Checklist
-
-### Basic Functionality
-- [ ] First launch shows splash
-- [ ] Second launch skips splash (default frequency: first)
-- [ ] `--splash` flag forces splash
-- [ ] `--no-splash` flag skips splash
-- [ ] `./rycode donut` easter egg works
-
-### Configuration
-- [ ] Config created on first launch
-- [ ] `splash_shown` persists across launches
-- [ ] Frequency modes work (first/always/random/never)
-- [ ] Invalid config falls back to defaults
-- [ ] Config write failures handled gracefully
-
-### Accessibility
-- [ ] `PREFERS_REDUCED_MOTION=1` triggers text-only mode
-- [ ] `NO_COLOR=1` disables colors
-- [ ] Small terminals auto-skip or use fallback
-- [ ] Skip controls work (S and ESC)
-- [ ] ESC updates config to disable
-
-### Integration Points
-- [ ] Clean transition to TUI (no artifacts)
-- [ ] Bubble Tea alt screen works correctly
-- [ ] Signal handling (SIGTERM/SIGINT) works
-- [ ] Piped stdin doesn't interfere
-- [ ] Concurrent goroutines don't race
-
-### Performance
-- [ ] Startup overhead <10ms (excluding animation)
-- [ ] Animation smooth 30 FPS
-- [ ] Memory overhead ~2MB
-- [ ] No memory leaks
-
-### Error Handling
-- [ ] Splash crash recovered (defer/recover)
-- [ ] Server connection failure doesn't prevent splash
-- [ ] Config errors logged but don't block splash
-- [ ] Terminal resize handled gracefully
-
-### Easter Eggs
-- [ ] Infinite donut mode (`./rycode donut`)
-- [ ] Math reveal (`?` key)
-- [ ] Konami code rainbow mode (↑↑↓↓←→←→BA)
-- [ ] Skip controls (S and ESC)
-- [ ] Hidden "CLAUDE WAS HERE" message (random)
-
----
-
-## 🚀 Automated Testing Script
-
-```bash
-#!/bin/bash
-# Integration test automation
-
-set -e
-
-echo "🧪 RyCode Splash Integration Tests"
-echo "===================================="
-echo ""
-
-# Test 1: First launch
-echo "Test 1: First launch (should show splash)"
-rm -f ~/.rycode/config.json
-timeout 10 ./rycode-test --splash || true
-if grep -q '"splash_shown": true' ~/.rycode/config.json; then
-  echo "✅ Config updated correctly"
-else
-  echo "❌ Config not updated"
-  exit 1
-fi
-echo ""
-
-# Test 2: Second launch
-echo "Test 2: Second launch (should skip)"
-# This would require mocking TUI input
-echo "⏭️  Skipped (requires manual testing)"
-echo ""
-
-# Test 3: Force show
-echo "Test 3: Force show with --splash"
-timeout 10 ./rycode-test --splash || true
-echo "✅ Forced splash completed"
-echo ""
-
-# Test 4: Skip flag
-echo "Test 4: Skip with --no-splash"
-timeout 5 ./rycode-test --no-splash || true
-echo "✅ Splash skipped"
-echo ""
-
-# Test 5: Donut mode
-echo "Test 5: Donut mode easter egg"
-timeout 5 ./rycode-test donut || true
-echo "✅ Donut mode launched"
-echo ""
-
-# Test 6: Reduced motion
-echo "Test 6: Reduced motion accessibility"
-export PREFERS_REDUCED_MOTION=1
-timeout 10 ./rycode-test --splash || true
-unset PREFERS_REDUCED_MOTION
-echo "✅ Reduced motion handled"
-echo ""
-
-# Test 7: No color
-echo "Test 7: No color mode"
-export NO_COLOR=1
-timeout 10 ./rycode-test --splash || true
-unset NO_COLOR
-echo "✅ No color handled"
-echo ""
-
-echo "===================================="
-echo "✅ All automated tests passed!"
-echo ""
-echo "⚠️  Manual tests required:"
-echo "  - TUI transition visual verification"
-echo "  - Konami code easter egg"
-echo "  - Math reveal (? key)"
-echo "  - Skip controls (S and ESC)"
-echo "  - Random frequency mode"
-```
-
----
-
-## 📚 Testing Resources
-
-**Related Documentation:**
-- [SPLASH_USAGE.md](SPLASH_USAGE.md) - User guide with examples
-- [SPLASH_TESTING.md](SPLASH_TESTING.md) - Unit test coverage (54.2%)
-- [EASTER_EGGS.md](EASTER_EGGS.md) - Easter egg discovery guide
-
-**Code References:**
-- `cmd/rycode/main.go:133-171` - Splash integration logic
-- `cmd/rycode/main.go:224-231` - Donut mode easter egg
-- `internal/splash/splash.go` - Main splash model
-- `internal/splash/config.go` - Configuration system
-
----
-
-## 🎯 Production Readiness
-
-### ✅ Integration Complete
-- All command-line flags implemented
-- Configuration system integrated
-- Easter eggs functional
-- Error handling robust
-- Clean TUI transition
-
-### ⏳ Remaining Manual Tests
-- Visual verification of TUI transition
-- All easter eggs (Konami code, math reveal, skip controls)
-- Random frequency mode statistical verification
-- Cross-platform testing (macOS, Linux, Windows)
-
-### 🚀 Ready for Release
-After completing manual tests, the splash screen integration is **production-ready**.
-
----
-
-**🤖 Integration Test Plan by Claude AI**
-
-*Complete verification of splash screen integration with RyCode*
-
----
-
-**Status:** Integration Code Complete ✅
-**Manual Testing Required:** Yes (visual verification)
-**Estimated Test Time:** 30 minutes
-
diff --git a/packages/tui/SPLASH_RELEASE_NOTES.md b/packages/tui/SPLASH_RELEASE_NOTES.md
deleted file mode 100644
index 6e41e568..00000000
--- a/packages/tui/SPLASH_RELEASE_NOTES.md
+++ /dev/null
@@ -1,531 +0,0 @@
-# RyCode Splash Screen - Release Notes
-
-> **Epic 3D ASCII Neural Cortex Animation** 🌀
-
----
-
-## 🎉 What's New
-
-### Introducing: The Epic Splash Screen
-
-RyCode now features a **stunning 3D ASCII splash screen** that renders a rotating neural cortex (torus) with real mathematical precision. This isn't just eye candy—it's a technical showcase of what's possible with terminal graphics.
-
-**First Launch Experience:**
-- 3-act animation sequence (Boot → Cortex → Closer)
-- Smooth 30 FPS rendering with adaptive frame rate
-- Cyberpunk cyan-magenta gradient colors
-- Auto-closes after 5 seconds or press any key
-- Respects accessibility preferences automatically
-
----
-
-## ✨ Key Features
-
-### 🌀 3D ASCII Rendering Engine
-
-**Real Donut Algorithm Math:**
-```
-Torus Parametric Equations:
-  x(θ,φ) = (R + r·cos(φ))·cos(θ)
-  y(θ,φ) = (R + r·cos(φ))·sin(θ)
-  z(θ,φ) = r·sin(φ)
-
-Where:
-  R = 2 (major radius - distance from center to tube center)
-  r = 1 (minor radius - tube thickness)
-  θ = angle around torus (0 to 2π)
-  φ = angle around tube (0 to 2π)
-```
-
-**Technical Highlights:**
-- Z-buffer depth sorting for proper occlusion
-- Rotation matrices (Rx and Rz)
-- Perspective projection with field-of-view
-- Phong shading for luminance calculation
-- 8 luminance levels mapped to ASCII characters: ` .·:*◉◎⚡`
-
-**Performance:**
-- **0.318ms per frame** (85× faster than 30 FPS target!)
-- Adaptive frame rate: Drops to 15 FPS on slow systems
-- Memory efficient: ~2MB for splash state
-- Minimal startup overhead: <10ms
-
----
-
-### 🎮 5 Hidden Easter Eggs
-
-**1. Infinite Donut Mode** 🍩
-```bash
-./rycode donut
-```
-- Endless rotating cortex animation
-- Press `Q` to quit
-- Press `?` to show math equations
-- Perfect for hypnotic background visuals
-
-**2. Konami Code** 🌈
-```
-Press: ↑↑↓↓←→←→BA
-```
-- Activates rainbow mode
-- 7-color ROYGBIV gradient (Red → Orange → Yellow → Green → Blue → Indigo → Violet)
-- Progress indicator shows when you're close
-- Works in both normal and donut mode
-
-**3. Math Equations Reveal** 🧮
-```
-Press: ?
-```
-- Shows complete torus mathematics
-- Parametric equations
-- Rotation matrices
-- Perspective projection formulas
-- Phong shading luminance calculation
-- Performance metrics
-- Press `?` again to return
-
-**4. Hidden Message** 🤫
-```
-Randomly appears during animation
-```
-- "CLAUDE WAS HERE" hidden in ASCII art
-- Low probability (adds discoverability challenge)
-- Look for the message in the torus rendering
-
-**5. Skip Controls** ⚡
-```
-Press: S (skip) or ESC (disable forever)
-```
-- `S` - Skip this splash, continue to TUI
-- `ESC` - Disable splash permanently (updates config)
-- Auto-skip on terminals <60×20 (too small)
-
----
-
-### ⚙️ Configuration System
-
-**Command-Line Flags:**
-```bash
-# Force show splash (even if disabled)
-./rycode --splash
-
-# Skip splash this time (doesn't update config)
-./rycode --no-splash
-
-# Infinite donut mode (easter egg)
-./rycode donut
-```
-
-**Config File:** `~/.rycode/config.json`
-```json
-{
-  "splash_enabled": true,
-  "splash_frequency": "first",
-  "reduced_motion": false,
-  "color_mode": "auto"
-}
-```
-
-**Frequency Modes:**
-- `"first"` - Only on first run (default)
-- `"always"` - Every launch
-- `"random"` - 10% chance on each launch
-- `"never"` - Never show (same as `splash_enabled: false`)
-
-**Environment Variables:**
-```bash
-# Disable splash for accessibility
-export PREFERS_REDUCED_MOTION=1
-
-# Disable colors
-export NO_COLOR=1
-
-# Force truecolor mode
-export COLORTERM=truecolor
-```
-
----
-
-### 🎨 Fallback Modes
-
-**Automatic Adaptation:**
-
-**1. Full Mode (Default)**
-- Requirements: Terminal ≥80×24, Truecolor/256-color
-- Features: Full 3D animation, all easter eggs, 30 FPS
-
-**2. Text-Only Mode**
-- Triggers: Terminal <80×24 or 16-color
-- Features: Static splash with model list, centered layout
-
-**3. Skip Mode**
-- Triggers: Terminal <60×20 (too small)
-- Behavior: Direct launch to TUI, no splash
-
-**Terminal Compatibility:**
-- ✅ iTerm2 (macOS) - Full mode
-- ✅ Windows Terminal - Full mode
-- ✅ Alacritty - Full mode
-- ✅ GNOME Terminal (Linux) - Full mode
-- ✅ Terminal.app (macOS) - Full mode
-- ⚠️ xterm - Text-only mode (basic colors)
-- ⚠️ CMD.exe (Windows) - Text-only mode (limited Unicode)
-
----
-
-### ♿ Accessibility
-
-**Automatic Respect for Preferences:**
-- Checks `PREFERS_REDUCED_MOTION` environment variable
-- Reads config `reduced_motion` setting
-- Checks `NO_COLOR` environment variable
-- Adaptive color depth based on terminal capabilities
-
-**Graceful Degradation:**
-- Small terminals → Text-only mode
-- Very small terminals → Skip entirely
-- Limited colors → Simplified palette
-- No Unicode → ASCII-only characters
-- Slow systems → 15 FPS adaptive mode
-
-**Skip Options:**
-- Press `S` anytime to skip
-- Press `ESC` to disable permanently
-- Use `--no-splash` flag
-- Set `splash_enabled: false` in config
-
----
-
-## 📊 Statistics
-
-### Code Metrics
-- **Production code:** 1,450 lines
-- **Test code:** 614 lines (21 tests)
-- **Documentation:** 2,532 lines
-- **Total:** 4,596 lines
-- **Test coverage:** 54.2%
-
-### Files Created
-**Production:**
-- `splash.go` - Main Bubble Tea model (330 lines)
-- `cortex.go` - 3D torus renderer (260 lines)
-- `ansi.go` - Color utilities (124 lines)
-- `bootsequence.go` - Boot animation (67 lines)
-- `closer.go` - Closer screen (62 lines)
-- `config.go` - Configuration system (164 lines)
-- `terminal.go` - Terminal detection (118 lines)
-- `fallback.go` - Text-only mode (167 lines)
-
-**Tests:**
-- `ansi_test.go` (105 lines, 5 tests)
-- `config_test.go` (165 lines, 5 tests)
-- `cortex_test.go` (116 lines, 5 tests)
-- `terminal_test.go` (229 lines, 9 tests)
-- `fallback_test.go` (220 lines, 7 tests)
-
-**Documentation:**
-- `SPLASH_USAGE.md` (650 lines)
-- `EASTER_EGGS.md` (350 lines)
-- `SPLASH_TESTING.md` (650 lines)
-- `SPLASH_IMPLEMENTATION_PLAN.md` (600 lines)
-- `WEEK_4_SUMMARY.md` (600 lines)
-
-### Performance Benchmarks (M1 Max)
-- **Frame time:** 0.318ms (85× faster than 30 FPS target)
-- **Memory:** ~2MB for splash state
-- **Startup overhead:** <10ms
-- **Binary size impact:** <100KB
-
----
-
-## 🚀 Quick Start
-
-### First Launch
-```bash
-# Build RyCode
-go build -o rycode ./cmd/rycode
-
-# Launch (splash shows automatically on first run)
-./rycode
-```
-
-**What You'll See:**
-1. **Boot Sequence** (~1 second) - System initialization
-2. **Rotating Cortex** (~3 seconds) - 3D neural network
-3. **Closer Screen** (~1 second) - "Six minds. One command line."
-4. **Auto-close** - Transitions to main TUI
-
-### Try Easter Eggs
-```bash
-# Infinite donut mode
-./rycode donut
-
-# Then try:
-# - Press ? to see math
-# - Press ↑↑↓↓←→←→BA for rainbow mode
-# - Press Q to quit
-```
-
-### Configuration
-```bash
-# Edit config
-nano ~/.rycode/config.json
-
-# Change frequency to "always" for demos
-{
-  "splash_frequency": "always"
-}
-
-# Or use flags
-./rycode --splash      # Force show
-./rycode --no-splash   # Skip this time
-```
-
----
-
-## 🎓 Implementation Journey
-
-### Week 1: Foundation (Complete) ✅
-- Core 3D engine with donut algorithm
-- Z-buffer depth sorting
-- Rotation matrices and perspective projection
-- ANSI color system with gradients
-- Boot sequence, cortex, and closer animations
-- Configuration system with save/load
-
-### Week 2: Easter Eggs & Polish (Complete) ✅
-- 5 major easter eggs implemented
-- Rainbow mode with 7-color gradient
-- Math equations reveal
-- Konami code detection
-- Hidden message system
-- Adaptive frame rate (30→15 FPS)
-- Terminal capability detection
-
-### Week 3: Integration & Config (Complete) ✅
-- Full splash_frequency support (first/always/random/never)
-- Command-line flags (--splash, --no-splash)
-- ESC to disable forever
-- Random 10% splash logic
-- Text-only fallback for small terminals
-- Clear screen transitions
-- Comprehensive usage documentation
-
-### Week 4: Cross-Platform Testing (Complete) ✅
-- 21 new unit tests created (31 total)
-- Coverage increased from 19.1% → 54.2%
-- 3 test files: config, terminal, fallback
-- Comprehensive test documentation
-- Build verification across platforms
-- Manual testing checklist
-
-### Week 5: Launch Preparation (In Progress) 🚀
-- ✅ Documentation review
-- ✅ README updates
-- ✅ Release notes (this document)
-- ⏳ Demo GIF/video creation
-- ⏳ Integration testing with real server
-- ⏳ Performance monitoring
-- ⏳ Final polish
-
----
-
-## 🔮 Design Philosophy
-
-### Why a Splash Screen?
-
-**1. First Impression Matters**
-- RyCode is about AI-powered multi-agent coding
-- The splash visually represents the "neural cortex" concept
-- Shows what's possible with terminal graphics
-- Sets expectations: This tool is polished and professional
-
-**2. Technical Showcase**
-- Demonstrates advanced terminal capabilities
-- Real mathematical precision (not fake ASCII art)
-- Performant rendering (85× faster than needed)
-- Adaptive and accessible by design
-
-**3. Delightful Experience**
-- Easter eggs encourage exploration
-- Configuration respects user preferences
-- Fallback modes ensure inclusivity
-- Skip options for power users
-
-**4. Brand Identity**
-- Memorable visual identity
-- "Six minds. One command line." messaging
-- Cyberpunk aesthetic matches AI theme
-- Distinguishes RyCode from competitors
-
----
-
-## 🐛 Known Issues & Limitations
-
-### Platform-Specific
-
-**Windows:**
-- CMD.exe has limited Unicode support → Text-only mode
-- PowerShell should work fine
-- Windows Terminal recommended
-
-**SSH/Remote Sessions:**
-- May render slower due to network latency
-- Adaptive FPS helps (30→15 FPS)
-- Consider `--no-splash` for automation
-
-**Low-End Systems:**
-- Raspberry Pi 3/4 may be slow
-- Adaptive FPS should activate automatically
-- Text-only mode always available
-
-### Terminal Compatibility
-
-**Works Great:**
-- ✅ iTerm2, Alacritty, Kitty, Windows Terminal
-- ✅ GNOME Terminal, Konsole, Terminal.app
-- ✅ Modern terminal emulators with truecolor
-
-**Limited:**
-- ⚠️ xterm (16 colors) → Text-only mode
-- ⚠️ screen/tmux (depends on terminal)
-- ⚠️ Very small terminals (<60×20) → Skip mode
-
----
-
-## 🤝 Feedback & Contribution
-
-### Reporting Issues
-- File issues on GitHub
-- Include terminal type and OS
-- Include config.json if relevant
-- Screenshots/recordings helpful
-
-### Suggesting Improvements
-- Easter egg ideas welcome!
-- Configuration options
-- Fallback mode improvements
-- Platform-specific enhancements
-
----
-
-## 📚 Documentation Links
-
-**User Guides:**
-- [SPLASH_USAGE.md](SPLASH_USAGE.md) - Complete usage guide
-- [EASTER_EGGS.md](EASTER_EGGS.md) - All hidden features
-- [README.md](README.md) - Main RyCode documentation
-
-**Developer Guides:**
-- [SPLASH_TESTING.md](SPLASH_TESTING.md) - Testing guide (54.2% coverage)
-- [SPLASH_IMPLEMENTATION_PLAN.md](SPLASH_IMPLEMENTATION_PLAN.md) - Design document
-- [WEEK_4_SUMMARY.md](WEEK_4_SUMMARY.md) - Week 4 progress
-
----
-
-## 🎉 Launch Checklist
-
-### ✅ Completed
-- [x] Core 3D rendering engine
-- [x] 5 easter eggs implemented
-- [x] Configuration system
-- [x] Command-line flags
-- [x] Fallback modes
-- [x] Terminal detection
-- [x] 31 passing tests
-- [x] 54.2% test coverage
-- [x] Comprehensive documentation
-- [x] README updates
-- [x] Release notes (this document)
-
-### ⏳ In Progress
-- [ ] Demo GIF/video creation
-- [ ] Integration testing with server
-- [ ] Performance monitoring
-- [ ] Final polish
-
-### 🚀 Ready for Launch
-- Binary builds successfully ✅
-- All tests passing ✅
-- Documentation complete ✅
-- Easter eggs working ✅
-- Configuration system robust ✅
-- Performance excellent ✅
-
----
-
-## 🌟 Highlights
-
-**What Makes This Special:**
-
-1. **Real Math** - Not fake ASCII art, actual torus equations
-2. **Performance** - 85× faster than needed (0.318ms per frame)
-3. **Adaptive** - Works on any terminal, any system
-4. **Accessible** - Respects preferences, multiple fallback modes
-5. **Delightful** - 5 easter eggs, smooth animations
-6. **Configurable** - Command-line flags, config file, env vars
-7. **Tested** - 54.2% coverage, 31 passing tests
-8. **Documented** - 2,532 lines of comprehensive guides
-
----
-
-## 💬 User Testimonials
-
-*"The splash screen is absolutely stunning! I didn't know terminal graphics could look this good."* - Beta Tester
-
-*"The donut mode is mesmerizing. I've been watching it for 10 minutes."* - Early User
-
-*"I love that pressing ESC disables it forever. Respects power users!"* - Command-line Enthusiast
-
-*"The math reveal (?) is amazing. Shows the actual equations!"* - Math Nerd
-
-*"Works perfectly on my Raspberry Pi 4 with adaptive FPS."* - ARM User
-
----
-
-## 🔥 Marketing Highlights
-
-**Tweet-Worthy:**
-- "🌀 RyCode now has an EPIC 3D ASCII splash screen with real donut algorithm math!"
-- "⚡ 0.318ms per frame - 85× faster than needed. Performance matters."
-- "🎮 5 hidden easter eggs including Konami code and infinite donut mode!"
-- "♿ Fully accessible with automatic fallback modes for any terminal"
-- "📊 54.2% test coverage - because quality matters"
-
-**Blog Post Angles:**
-- "Building a 3D Terminal Splash Screen with Real Math"
-- "How We Achieved 30 FPS ASCII Animation in Go"
-- "Accessibility First: Designing Inclusive Terminal Graphics"
-- "Easter Eggs Done Right: Hidden Features That Delight"
-- "Test-Driven Development: 54.2% Coverage for a Splash Screen"
-
----
-
-## 🎯 What's Next
-
-**Immediate (Week 5):**
-- Create demo GIF/video
-- Integration testing
-- Performance monitoring
-- Final polish
-
-**Future Enhancements:**
-- More easter eggs (suggestions welcome!)
-- Additional fallback modes
-- Customizable colors/themes
-- Animation speed control
-- More hidden messages
-
----
-
-**🤖 Built with ❤️ by Claude AI**
-
-*From concept to completion in 5 weeks*
-*100% AI-designed, 0% compromises, ∞ attention to detail*
-
----
-
-**Release Date:** Week 5, 2024
-**Version:** 1.0.0
-**Status:** Production Ready 🚀
-
diff --git a/packages/tui/SPLASH_TASKS.md b/packages/tui/SPLASH_TASKS.md
deleted file mode 100644
index 2558cb6a..00000000
--- a/packages/tui/SPLASH_TASKS.md
+++ /dev/null
@@ -1,2534 +0,0 @@
-# RyCode Splash Screen - Implementation Tasks
-## Actionable Task Breakdown with Dependencies
-
-> **Generated from:** SPLASH_IMPLEMENTATION_PLAN.md
-> **Total Duration:** 5 weeks (35 days)
-> **Total Tasks:** 87 tasks across 5 phases
-> **Status:** Ready for execution
-
----
-
-## Task Priority System
-
-- 🔴 **P0 (Critical):** Blocking tasks - must complete before dependent tasks
-- 🟠 **P1 (High):** Core functionality - required for MVP
-- 🟡 **P2 (Medium):** Important features - enhance user experience
-- 🟢 **P3 (Low):** Nice-to-have - polish and extras
-
----
-
-## Week 1: Foundation (Core Engine) - 18 Tasks
-
-### Phase 1.1: Project Setup (Day 1) - 4 Tasks
-
-**TASK-001** 🔴 P0 - Create splash module directory structure
-- **Duration:** 30 min
-- **Dependencies:** None
-- **Assignee:** Developer
-- **Acceptance Criteria:**
-  ```bash
-  mkdir -p packages/tui/internal/splash
-  touch packages/tui/internal/splash/splash.go
-  touch packages/tui/internal/splash/cortex.go
-  touch packages/tui/internal/splash/bootsequence.go
-  touch packages/tui/internal/splash/closer.go
-  touch packages/tui/internal/splash/ansi.go
-  touch packages/tui/internal/splash/config.go
-  ```
-- **Verification:** Directory exists with 6 empty files
-
-**TASK-002** 🔴 P0 - Initialize package with basic types
-- **Duration:** 1 hour
-- **Dependencies:** TASK-001
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  package splash
-
-  import tea "github.com/charmbracelet/bubbletea"
-  import "time"
-
-  type Model struct {
-      act       int           // 1=boot, 2=cortex, 3=closer
-      frame     int
-      renderer  *CortexRenderer
-      done      bool
-      width     int
-      height    int
-  }
-
-  type tickMsg time.Time
-  ```
-- **Verification:** `go build` succeeds
-
-**TASK-003** 🟠 P1 - Create test files
-- **Duration:** 30 min
-- **Dependencies:** TASK-001
-- **Files:** Create `*_test.go` for each module
-  ```bash
-  touch packages/tui/internal/splash/cortex_test.go
-  touch packages/tui/internal/splash/ansi_test.go
-  touch packages/tui/internal/splash/bootsequence_test.go
-  ```
-- **Verification:** `go test ./internal/splash` runs (even with no tests)
-
-**TASK-004** 🟡 P2 - Set up benchmark framework
-- **Duration:** 30 min
-- **Dependencies:** TASK-003
-- **Files:** `cortex_test.go`
-- **Implementation:**
-  ```go
-  func BenchmarkRenderFrame(b *testing.B) {
-      r := NewCortexRenderer(80, 24)
-      b.ResetTimer()
-      for i := 0; i < b.N; i++ {
-          r.RenderFrame()
-      }
-  }
-  ```
-- **Verification:** `go test -bench=.` runs
-
----
-
-### Phase 1.2: Torus Mathematics (Day 1-2) - 6 Tasks
-
-**TASK-005** 🔴 P0 - Implement torus parametric equations
-- **Duration:** 3 hours
-- **Dependencies:** TASK-002
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  type CortexRenderer struct {
-      width, height int
-      A, B         float64  // Rotation angles
-      screen       []rune
-      zbuffer      []float64
-  }
-
-  func NewCortexRenderer(width, height int) *CortexRenderer {
-      size := width * height
-      return &CortexRenderer{
-          width:   width,
-          height:  height,
-          screen:  make([]rune, size),
-          zbuffer: make([]float64, size),
-      }
-  }
-
-  // Calculate point on torus surface
-  func (r *CortexRenderer) torusPoint(theta, phi float64) (x, y, z float64) {
-      const R = 2.0  // Major radius
-      const r = 1.0  // Minor radius
-
-      sinTheta, cosTheta := math.Sin(theta), math.Cos(theta)
-      sinPhi, cosPhi := math.Sin(phi), math.Cos(phi)
-
-      circleX := R + r*cosPhi
-      circleY := r * sinPhi
-
-      // Before rotation
-      x = circleX * cosTheta
-      y = circleX * sinTheta
-      z = circleY
-
-      return x, y, z
-  }
-  ```
-- **Acceptance Criteria:**
-  - Function returns valid 3D coordinates
-  - Distance from origin is between 1.0 and 3.0
-- **Verification:** Unit test passes
-
-**TASK-006** 🔴 P0 - Implement rotation matrices
-- **Duration:** 2 hours
-- **Dependencies:** TASK-005
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  // Apply rotation matrices Rx(A) and Rz(B)
-  func (r *CortexRenderer) rotate(x, y, z float64) (float64, float64, float64) {
-      sinA, cosA := math.Sin(r.A), math.Cos(r.A)
-      sinB, cosB := math.Sin(r.B), math.Cos(r.B)
-
-      // Rotate around X-axis
-      y1 := y*cosA - z*sinA
-      z1 := y*sinA + z*cosA
-
-      // Rotate around Z-axis
-      x2 := x*cosB - y1*sinB
-      y2 := x*sinB + y1*cosB
-      z2 := z1
-
-      return x2, y2, z2
-  }
-  ```
-- **Acceptance Criteria:** Rotation preserves distance from origin
-- **Verification:** Unit test with known rotations
-
-**TASK-007** 🔴 P0 - Implement perspective projection
-- **Duration:** 2 hours
-- **Dependencies:** TASK-006
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  // Project 3D point to 2D screen
-  func (r *CortexRenderer) project(x, y, z float64) (int, int, float64) {
-      // Move away from camera
-      z = z + 5.0
-
-      // Perspective projection
-      ooz := 1.0 / z  // "one over z"
-      xp := int(float64(r.width)*0.5 + 30.0*ooz*x)
-      yp := int(float64(r.height)*0.5 - 15.0*ooz*y)
-
-      return xp, yp, ooz
-  }
-  ```
-- **Acceptance Criteria:** Points map to screen coordinates
-- **Verification:** Visual inspection (render single point)
-
-**TASK-008** 🟠 P1 - Implement luminance calculation
-- **Duration:** 2 hours
-- **Dependencies:** TASK-006
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  // Calculate surface luminance (Phong shading)
-  func (r *CortexRenderer) luminance(theta, phi float64) float64 {
-      sinA, cosA := math.Sin(r.A), math.Cos(r.A)
-      sinB, cosB := math.Sin(r.B), math.Cos(r.B)
-      sinTheta, cosTheta := math.Sin(theta), math.Cos(theta)
-      sinPhi, cosPhi := math.Sin(phi), math.Cos(phi)
-
-      // Light direction calculation
-      L := cosPhi*cosTheta*sinB - cosA*cosTheta*sinPhi -
-           sinA*sinTheta + cosB*(cosA*sinPhi - cosTheta*sinA*sinTheta)
-
-      return L
-  }
-  ```
-- **Acceptance Criteria:** Luminance in range [-1, 1]
-- **Verification:** Unit test
-
-**TASK-009** 🟠 P1 - Implement Z-buffer algorithm
-- **Duration:** 2 hours
-- **Dependencies:** TASK-007
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  func (r *CortexRenderer) plotPoint(x, y int, depth float64, char rune) {
-      if x < 0 || x >= r.width || y < 0 || y >= r.height {
-          return
-      }
-
-      idx := y*r.width + x
-
-      // Z-buffer test
-      if depth > r.zbuffer[idx] {
-          r.zbuffer[idx] = depth
-          r.screen[idx] = char
-      }
-  }
-  ```
-- **Acceptance Criteria:** Front surfaces occlude back surfaces
-- **Verification:** Visual test with sphere
-
-**TASK-010** 🟠 P1 - Implement complete render loop
-- **Duration:** 3 hours
-- **Dependencies:** TASK-005, TASK-006, TASK-007, TASK-008, TASK-009
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  func (r *CortexRenderer) RenderFrame() {
-      // Clear buffers
-      for i := range r.screen {
-          r.screen[i] = ' '
-          r.zbuffer[i] = 0
-      }
-
-      // Render torus
-      const thetaStep = 0.07
-      const phiStep = 0.02
-
-      for theta := 0.0; theta < 6.28; theta += thetaStep {
-          for phi := 0.0; phi < 6.28; phi += phiStep {
-              // Calculate 3D point
-              x, y, z := r.torusPoint(theta, phi)
-
-              // Apply rotation
-              x, y, z = r.rotate(x, y, z)
-
-              // Project to 2D
-              xp, yp, depth := r.project(x, y, z)
-
-              // Calculate luminance
-              L := r.luminance(theta, phi)
-
-              // Map to character
-              lumIdx := int((L + 1.0) * 3.5)
-              if lumIdx < 0 { lumIdx = 0 }
-              if lumIdx > 7 { lumIdx = 7 }
-              chars := []rune{' ', '.', '·', ':', '*', '◉', '◎', '⚡'}
-
-              // Plot with z-buffer
-              r.plotPoint(xp, yp, depth, chars[lumIdx])
-          }
-      }
-
-      // Update rotation
-      r.A += 0.04
-      r.B += 0.02
-  }
-
-  func (r *CortexRenderer) String() string {
-      var buf strings.Builder
-      for y := 0; y < r.height; y++ {
-          for x := 0; x < r.width; x++ {
-              buf.WriteRune(r.screen[y*r.width+x])
-          }
-          if y < r.height-1 {
-              buf.WriteRune('\n')
-          }
-      }
-      return buf.String()
-  }
-  ```
-- **Acceptance Criteria:** Full torus renders correctly
-- **Verification:** Visual inspection - should see rotating donut
-
----
-
-### Phase 1.3: Color System (Day 3) - 5 Tasks
-
-**TASK-011** 🟠 P1 - Implement ANSI color utilities
-- **Duration:** 2 hours
-- **Dependencies:** TASK-002
-- **Files:** `ansi.go`
-- **Implementation:**
-  ```go
-  package splash
-
-  import "fmt"
-
-  // RGB color
-  type RGB struct {
-      R, G, B uint8
-  }
-
-  // Convert RGB to ANSI truecolor escape sequence
-  func (c RGB) ANSI() string {
-      return fmt.Sprintf("\033[38;2;%d;%d;%dm", c.R, c.G, c.B)
-  }
-
-  // Reset color
-  func ResetColor() string {
-      return "\033[0m"
-  }
-
-  // Colorize text
-  func Colorize(text string, color RGB) string {
-      return color.ANSI() + text + ResetColor()
-  }
-  ```
-- **Verification:** Print colored text to terminal
-
-**TASK-012** 🟠 P1 - Implement cyan-to-magenta gradient
-- **Duration:** 2 hours
-- **Dependencies:** TASK-011
-- **Files:** `ansi.go`
-- **Implementation:**
-  ```go
-  // Interpolate between two colors
-  func lerp(a, b uint8, t float64) uint8 {
-      return uint8(float64(a)*(1.0-t) + float64(b)*t)
-  }
-
-  // Cyan to magenta gradient based on angle (0 to 2π)
-  func GradientColor(angle float64) RGB {
-      cyan := RGB{0, 255, 255}      // #00FFFF
-      magenta := RGB{255, 0, 255}   // #FF00FF
-
-      // Normalize angle to [0, 1]
-      t := math.Mod(angle, 2*math.Pi) / (2 * math.Pi)
-
-      return RGB{
-          R: lerp(cyan.R, magenta.R, t),
-          G: lerp(cyan.G, magenta.G, t),
-          B: lerp(cyan.B, magenta.B, t),
-      }
-  }
-  ```
-- **Verification:** Unit test with known angles
-
-**TASK-013** 🟡 P2 - Implement 256-color fallback
-- **Duration:** 2 hours
-- **Dependencies:** TASK-011
-- **Files:** `ansi.go`
-- **Implementation:**
-  ```go
-  // Convert RGB to nearest 256-color ANSI code
-  func (c RGB) ANSI256() string {
-      // 256-color cube: 16 + 36*r + 6*g + b
-      r := int(c.R) * 6 / 256
-      g := int(c.G) * 6 / 256
-      b := int(c.B) * 6 / 256
-      code := 16 + 36*r + 6*g + b
-      return fmt.Sprintf("\033[38;5;%dm", code)
-  }
-  ```
-- **Verification:** Compare truecolor vs 256-color side-by-side
-
-**TASK-014** 🟡 P2 - Detect terminal color capabilities
-- **Duration:** 1 hour
-- **Dependencies:** TASK-011
-- **Files:** `ansi.go`
-- **Implementation:**
-  ```go
-  type ColorMode int
-
-  const (
-      Colors16 ColorMode = iota
-      Colors256
-      Truecolor
-  )
-
-  func DetectColorMode() ColorMode {
-      colorterm := os.Getenv("COLORTERM")
-      if colorterm == "truecolor" || colorterm == "24bit" {
-          return Truecolor
-      }
-
-      term := os.Getenv("TERM")
-      if strings.Contains(term, "256color") {
-          return Colors256
-      }
-
-      return Colors16
-  }
-  ```
-- **Verification:** Test on different terminals
-
-**TASK-015** 🟠 P1 - Integrate colors into cortex renderer
-- **Duration:** 2 hours
-- **Dependencies:** TASK-010, TASK-012
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  func (r *CortexRenderer) Render() string {
-      r.RenderFrame()
-
-      var buf strings.Builder
-      for y := 0; y < r.height; y++ {
-          for x := 0; x < r.width; x++ {
-              idx := y*r.width + x
-              char := r.screen[idx]
-
-              if char != ' ' {
-                  // Color based on position (angle around torus)
-                  angle := math.Atan2(float64(y-r.height/2), float64(x-r.width/2))
-                  color := GradientColor(angle + r.B)  // Rotate with torus
-                  buf.WriteString(Colorize(string(char), color))
-              } else {
-                  buf.WriteRune(' ')
-              }
-          }
-          if y < r.height-1 {
-              buf.WriteRune('\n')
-          }
-      }
-      return buf.String()
-  }
-  ```
-- **Acceptance Criteria:** Torus displays with cyan-magenta gradient
-- **Verification:** Visual inspection
-
----
-
-### Phase 1.4: Testing & Optimization (Day 4-5) - 3 Tasks
-
-**TASK-016** 🔴 P0 - Write unit tests for torus math
-- **Duration:** 3 hours
-- **Dependencies:** TASK-010
-- **Files:** `cortex_test.go`
-- **Implementation:**
-  ```go
-  func TestTorusGeometry(t *testing.T) {
-      r := NewCortexRenderer(80, 24)
-
-      for theta := 0.0; theta < 6.28; theta += 0.1 {
-          for phi := 0.0; phi < 6.28; phi += 0.1 {
-              x, y, z := r.torusPoint(theta, phi)
-
-              // Distance should be R ± r (2 ± 1 = 1 to 3)
-              dist := math.Sqrt(x*x + y*y + z*z)
-              if dist < 0.5 || dist > 3.5 {
-                  t.Errorf("Invalid distance: %.2f", dist)
-              }
-          }
-      }
-  }
-
-  func TestZBufferOcclusion(t *testing.T) {
-      r := NewCortexRenderer(80, 24)
-      r.RenderFrame()
-
-      // Center should have depth (not empty)
-      centerIdx := (r.height/2)*r.width + (r.width/2)
-      if r.zbuffer[centerIdx] == 0 {
-          t.Error("Z-buffer not working - center is empty")
-      }
-  }
-
-  func TestRotationPreservesDistance(t *testing.T) {
-      r := NewCortexRenderer(80, 24)
-      x, y, z := 1.0, 2.0, 3.0
-      distBefore := math.Sqrt(x*x + y*y + z*z)
-
-      x2, y2, z2 := r.rotate(x, y, z)
-      distAfter := math.Sqrt(x2*x2 + y2*y2 + z2*z2)
-
-      if math.Abs(distBefore-distAfter) > 0.001 {
-          t.Errorf("Rotation changed distance: %.3f -> %.3f", distBefore, distAfter)
-      }
-  }
-  ```
-- **Acceptance Criteria:** All tests pass
-- **Verification:** `go test -v ./internal/splash`
-
-**TASK-017** 🟠 P1 - Performance benchmarking
-- **Duration:** 2 hours
-- **Dependencies:** TASK-010
-- **Files:** `cortex_test.go`
-- **Implementation:**
-  ```go
-  func BenchmarkRenderFrame(b *testing.B) {
-      r := NewCortexRenderer(80, 24)
-      b.ResetTimer()
-      for i := 0; i < b.N; i++ {
-          r.RenderFrame()
-      }
-      // Target: <1ms (1,000,000 ns)
-  }
-
-  func BenchmarkFullRender(b *testing.B) {
-      r := NewCortexRenderer(80, 24)
-      b.ResetTimer()
-      for i := 0; i < b.N; i++ {
-          _ = r.Render()  // Include string building + colors
-      }
-      // Target: <10ms (terminal I/O is slow)
-  }
-  ```
-- **Acceptance Criteria:** <1ms per RenderFrame()
-- **Verification:** `go test -bench=. -benchtime=5s`
-
-**TASK-018** 🟡 P2 - Profile and optimize hotspots
-- **Duration:** 3 hours
-- **Dependencies:** TASK-017
-- **Implementation:**
-  ```bash
-  # Generate CPU profile
-  go test -cpuprofile=cpu.prof -bench=BenchmarkRenderFrame
-
-  # Analyze
-  go tool pprof cpu.prof
-  # (pprof) top10
-  # (pprof) list RenderFrame
-
-  # Optimize based on findings
-  # Common optimizations:
-  # - Precompute sin/cos tables
-  # - Reduce allocations (use strings.Builder)
-  # - Inline small functions
-  ```
-- **Acceptance Criteria:** No single function >20% CPU time
-- **Verification:** pprof output
-
----
-
-## Week 2: Animations (3-Act Sequence) - 15 Tasks
-
-### Phase 2.1: Boot Sequence (Day 1-2) - 5 Tasks
-
-**TASK-019** 🟠 P1 - Create model status data structure
-- **Duration:** 1 hour
-- **Dependencies:** TASK-002
-- **Files:** `bootsequence.go`
-- **Implementation:**
-  ```go
-  package splash
-
-  type ModelInfo struct {
-      Name       string
-      Role       string
-      Icon       string
-      Color      RGB
-      Delay      time.Duration
-  }
-
-  var models = []ModelInfo{
-      {"Claude", "Logical Reasoning", "🧩", RGB{10, 255, 10}, 100 * time.Millisecond},
-      {"Gemini", "System Architecture", "⚙️", RGB{10, 255, 10}, 100 * time.Millisecond},
-      {"Codex", "Code Generation", "💻", RGB{10, 255, 10}, 100 * time.Millisecond},
-      {"Qwen", "Research Pipeline", "🔎", RGB{10, 255, 10}, 100 * time.Millisecond},
-      {"Grok", "Humor & Chaos Engine", "🤖", RGB{10, 255, 10}, 100 * time.Millisecond},
-      {"GPT", "Language Core", "✅", RGB{10, 255, 10}, 100 * time.Millisecond},
-  }
-  ```
-- **Verification:** Data structure compiles
-
-**TASK-020** 🟠 P1 - Implement line-by-line reveal animation
-- **Duration:** 2 hours
-- **Dependencies:** TASK-019
-- **Files:** `bootsequence.go`
-- **Implementation:**
-  ```go
-  type BootSequence struct {
-      frame       int
-      linesShown  int
-  }
-
-  func NewBootSequence() *BootSequence {
-      return &BootSequence{}
-  }
-
-  func (b *BootSequence) Update(frame int) {
-      // Show 1 line every 3 frames (100ms at 30 FPS)
-      b.linesShown = frame / 3
-      if b.linesShown > len(models) {
-          b.linesShown = len(models)
-      }
-  }
-
-  func (b *BootSequence) Render() string {
-      var buf strings.Builder
-
-      buf.WriteString(Colorize("> [RYCODE NEURAL CORTEX v1.0.0]\n", RGB{0, 255, 255}))
-      buf.WriteString(">\n")
-
-      for i := 0; i < b.linesShown && i < len(models); i++ {
-          model := models[i]
-
-          prefix := "├─"
-          if i == len(models)-1 {
-              prefix = "└─"
-          }
-
-          line := fmt.Sprintf("> %s %s ▸ %s: ONLINE %s\n",
-              prefix, model.Name, model.Role, model.Icon)
-
-          buf.WriteString(Colorize(line, model.Color))
-      }
-
-      // Final message after all models loaded
-      if b.linesShown >= len(models) {
-          buf.WriteString(">\n")
-          buf.WriteString(Colorize("> ⚡ SIX MINDS. ONE COMMAND LINE.\n", RGB{255, 174, 0}))
-      }
-
-      return buf.String()
-  }
-  ```
-- **Verification:** Visual test - lines appear one by one
-
-**TASK-021** 🟡 P2 - Add typing effect for dramatic flair
-- **Duration:** 2 hours
-- **Dependencies:** TASK-020
-- **Files:** `bootsequence.go`
-- **Implementation:**
-  ```go
-  func (b *BootSequence) Render() string {
-      var buf strings.Builder
-
-      // ... existing code ...
-
-      // For current line being revealed, show partial text
-      if b.frame%3 < 3 && b.linesShown < len(models) {
-          model := models[b.linesShown]
-          partialFrame := b.frame % 3
-
-          prefix := "├─"
-          if b.linesShown == len(models)-1 {
-              prefix = "└─"
-          }
-
-          fullLine := fmt.Sprintf("> %s %s ▸ %s: ONLINE %s",
-              prefix, model.Name, model.Role, model.Icon)
-
-          // Show partial text based on frame
-          charsToShow := len(fullLine) * partialFrame / 3
-          partialLine := fullLine[:charsToShow]
-
-          buf.WriteString(Colorize(partialLine, RGB{100, 100, 100}))  // Dimmed
-      }
-
-      return buf.String()
-  }
-  ```
-- **Verification:** Lines "type" onto screen
-
-**TASK-022** 🟢 P3 - Add ASCII art header (optional)
-- **Duration:** 1 hour
-- **Dependencies:** TASK-020
-- **Files:** `bootsequence.go`
-- **Implementation:**
-  ```go
-  const asciiHeader = `
-   ____       ____          _
-  |  _ \ _   / ___|___   __| | ___
-  | |_) | | | |   / _ \ / _' |/ _ \
-  |  _ <| |_| |__| (_) | (_| |  __/
-  |_| \_\\__, \____\___/ \__,_|\___|
-         |___/
-  `
-
-  func (b *BootSequence) Render() string {
-      var buf strings.Builder
-
-      if b.frame < 10 {
-          buf.WriteString(Colorize(asciiHeader, RGB{0, 255, 255}))
-      }
-
-      // ... rest of code ...
-  }
-  ```
-- **Verification:** Header displays briefly
-
-**TASK-023** 🟠 P1 - Write unit tests for boot sequence
-- **Duration:** 1 hour
-- **Dependencies:** TASK-020
-- **Files:** `bootsequence_test.go`
-- **Implementation:**
-  ```go
-  func TestBootSequenceProgression(t *testing.T) {
-      bs := NewBootSequence()
-
-      // Frame 0: No models shown
-      bs.Update(0)
-      if bs.linesShown != 0 {
-          t.Errorf("Expected 0 lines, got %d", bs.linesShown)
-      }
-
-      // Frame 3: 1 model shown
-      bs.Update(3)
-      if bs.linesShown != 1 {
-          t.Errorf("Expected 1 line, got %d", bs.linesShown)
-      }
-
-      // Frame 18: All 6 models shown
-      bs.Update(18)
-      if bs.linesShown != 6 {
-          t.Errorf("Expected 6 lines, got %d", bs.linesShown)
-      }
-  }
-  ```
-- **Verification:** Tests pass
-
----
-
-### Phase 2.2: Closer Screen (Day 3-4) - 5 Tasks
-
-**TASK-024** 🟠 P1 - Design closer screen layout
-- **Duration:** 1 hour
-- **Dependencies:** TASK-002
-- **Files:** `closer.go`
-- **Implementation:**
-  ```go
-  package splash
-
-  const closerText = `
-  ╔═══════════════════════════════════════════════════════════════════════╗
-  ║                                                                       ║
-  ║                  🌀 RYCODE NEURAL CORTEX ACTIVE 🌀                   ║
-  ║                                                                       ║
-  ║         "Every LLM fused. Every edge case covered.                   ║
-  ║          You're not just coding—you're orchestrating                 ║
-  ║          intelligence."                                              ║
-  ║                                                                       ║
-  ║                                                                       ║
-  ║                   Press any key to begin...                          ║
-  ║                                                                       ║
-  ╚═══════════════════════════════════════════════════════════════════════╝
-  `
-  ```
-- **Verification:** Manually check alignment
-
-**TASK-025** 🟠 P1 - Implement centered text rendering
-- **Duration:** 2 hours
-- **Dependencies:** TASK-024
-- **Files:** `closer.go`
-- **Implementation:**
-  ```go
-  type Closer struct {
-      width  int
-      height int
-  }
-
-  func NewCloser(width, height int) *Closer {
-      return &Closer{width: width, height: height}
-  }
-
-  func (c *Closer) Render() string {
-      lines := strings.Split(closerText, "\n")
-
-      // Calculate vertical centering
-      startY := (c.height - len(lines)) / 2
-      if startY < 0 {
-          startY = 0
-      }
-
-      var buf strings.Builder
-
-      // Add top padding
-      for i := 0; i < startY; i++ {
-          buf.WriteRune('\n')
-      }
-
-      // Render centered lines
-      for _, line := range lines {
-          // Horizontal centering
-          padding := (c.width - len(line)) / 2
-          if padding > 0 {
-              buf.WriteString(strings.Repeat(" ", padding))
-          }
-          buf.WriteString(line)
-          buf.WriteRune('\n')
-      }
-
-      return buf.String()
-  }
-  ```
-- **Verification:** Test on different terminal sizes
-
-**TASK-026** 🟡 P2 - Add subtle color pulse effect
-- **Duration:** 2 hours
-- **Dependencies:** TASK-025
-- **Files:** `closer.go`
-- **Implementation:**
-  ```go
-  func (c *Closer) RenderWithPulse(frame int) string {
-      // Pulse intensity: 0.7 to 1.0
-      intensity := 0.7 + 0.3*math.Sin(float64(frame)*0.1)
-
-      cyan := RGB{
-          R: uint8(float64(0) * intensity),
-          G: uint8(float64(255) * intensity),
-          B: uint8(float64(255) * intensity),
-      }
-
-      lines := strings.Split(closerText, "\n")
-      var buf strings.Builder
-
-      for _, line := range lines {
-          if strings.Contains(line, "🌀") || strings.Contains(line, "CORTEX") {
-              buf.WriteString(Colorize(line, cyan))
-          } else {
-              buf.WriteString(line)
-          }
-          buf.WriteRune('\n')
-      }
-
-      return buf.String()
-  }
-  ```
-- **Verification:** Visual test - title should pulse
-
-**TASK-027** 🟡 P2 - Responsive layout for different terminal sizes
-- **Duration:** 2 hours
-- **Dependencies:** TASK-025
-- **Files:** `closer.go`
-- **Implementation:**
-  ```go
-  func (c *Closer) Render() string {
-      if c.width < 80 || c.height < 24 {
-          // Simplified version for small terminals
-          return c.renderCompact()
-      }
-
-      return c.renderFull()
-  }
-
-  func (c *Closer) renderCompact() string {
-      return `
-  ╔═══════════════════════════════════╗
-  ║   🌀 RYCODE CORTEX ACTIVE 🌀     ║
-  ║                                   ║
-  ║   Six minds. One command line.    ║
-  ║                                   ║
-  ║   Press any key...                ║
-  ╚═══════════════════════════════════╝
-  `
-  }
-  ```
-- **Verification:** Test on small terminal (60×20)
-
-**TASK-028** 🟢 P3 - Add easter egg messages (random quotes)
-- **Duration:** 1 hour
-- **Dependencies:** TASK-025
-- **Files:** `closer.go`
-- **Implementation:**
-  ```go
-  var easterEggQuotes = []string{
-      "Built by Claude. No humans were harmed.",
-      "100% AI-designed. 0% compromises.",
-      "The age of typing is over.",
-      "Warning: May cause productivity addiction.",
-  }
-
-  func (c *Closer) Render() string {
-      // 5% chance of easter egg
-      if rand.Float64() < 0.05 {
-          quote := easterEggQuotes[rand.Intn(len(easterEggQuotes))]
-          // ... inject quote into render ...
-      }
-
-      return c.renderFull()
-  }
-  ```
-- **Verification:** Run 100 times, should see ~5 easter eggs
-
----
-
-### Phase 2.3: Orchestrator (Day 5-6) - 5 Tasks
-
-**TASK-029** 🔴 P0 - Implement Bubble Tea Model structure
-- **Duration:** 2 hours
-- **Dependencies:** TASK-002, TASK-020, TASK-025
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  type Model struct {
-      act          int  // 1=boot, 2=cortex, 3=closer
-      frame        int
-      bootSeq      *BootSequence
-      cortex       *CortexRenderer
-      closer       *Closer
-      done         bool
-      width        int
-      height       int
-  }
-
-  func New() Model {
-      return Model{
-          act:     1,
-          frame:   0,
-          bootSeq: NewBootSequence(),
-          cortex:  NewCortexRenderer(80, 24),
-          closer:  NewCloser(80, 24),
-      }
-  }
-  ```
-- **Verification:** Compiles successfully
-
-**TASK-030** 🔴 P0 - Implement Init() and Update() methods
-- **Duration:** 3 hours
-- **Dependencies:** TASK-029
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func (m Model) Init() tea.Cmd {
-      return tea.Batch(
-          tea.EnterAltScreen,
-          tick(),
-      )
-  }
-
-  func tick() tea.Cmd {
-      return tea.Tick(33*time.Millisecond, func(t time.Time) tea.Msg {
-          return tickMsg(t)
-      })
-  }
-
-  func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-      switch msg := msg.(type) {
-      case tea.WindowSizeMsg:
-          m.width = msg.Width
-          m.height = msg.Height
-          m.cortex = NewCortexRenderer(msg.Width, msg.Height)
-          m.closer = NewCloser(msg.Width, msg.Height)
-          return m, nil
-
-      case tea.KeyMsg:
-          switch msg.String() {
-          case "s", "S", "esc":
-              m.done = true
-              return m, tea.Quit
-          case "enter", " ":
-              if m.act == 3 {
-                  m.done = true
-                  return m, tea.Quit
-              }
-          }
-
-      case tickMsg:
-          m.frame++
-
-          // Act transitions
-          if m.act == 1 && m.frame > 30 {  // 1 second
-              m.act = 2
-          } else if m.act == 2 && m.frame > 120 {  // 4 seconds
-              m.act = 3
-          } else if m.act == 3 && m.frame > 150 {  // 5 seconds total
-              m.done = true
-              return m, tea.Quit
-          }
-
-          return m, tick()
-      }
-
-      return m, nil
-  }
-  ```
-- **Verification:** Skip key and timing work
-
-**TASK-031** 🔴 P0 - Implement View() method with act switching
-- **Duration:** 2 hours
-- **Dependencies:** TASK-030
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func (m Model) View() string {
-      switch m.act {
-      case 1:
-          m.bootSeq.Update(m.frame)
-          return m.bootSeq.Render()
-
-      case 2:
-          return m.cortex.Render()
-
-      case 3:
-          return m.closer.RenderWithPulse(m.frame)
-
-      default:
-          return ""
-      }
-  }
-  ```
-- **Verification:** All 3 acts render correctly
-
-**TASK-032** 🟡 P2 - Add smooth transitions between acts
-- **Duration:** 2 hours
-- **Dependencies:** TASK-031
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func (m Model) View() string {
-      // Check if transitioning
-      if (m.act == 1 && m.frame == 30) || (m.act == 2 && m.frame == 120) {
-          return m.renderTransition()
-      }
-
-      // Normal rendering...
-  }
-
-  func (m Model) renderTransition() string {
-      // Fade to black or clear screen
-      var buf strings.Builder
-      for i := 0; i < m.height; i++ {
-          buf.WriteString(strings.Repeat(" ", m.width))
-          buf.WriteRune('\n')
-      }
-      return buf.String()
-  }
-  ```
-- **Verification:** Transitions feel smooth
-
-**TASK-033** 🟠 P1 - Add skip indicator UI
-- **Duration:** 1 hour
-- **Dependencies:** TASK-031
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func (m Model) View() string {
-      content := ""
-
-      switch m.act {
-      case 1:
-          content = m.bootSeq.Render()
-      case 2:
-          content = m.cortex.Render()
-      case 3:
-          content = m.closer.RenderWithPulse(m.frame)
-      }
-
-      // Add skip hint at bottom
-      skipHint := Colorize("\n\nPress 'S' to skip | ESC to disable forever",
-          RGB{100, 100, 100})
-
-      return content + skipHint
-  }
-  ```
-- **Verification:** Skip hint visible but not distracting
-
----
-
-## Week 3: Integration (CLI Entry Point) - 17 Tasks
-
-### Phase 3.1: First-Run Detection (Day 1) - 4 Tasks
-
-**TASK-034** 🔴 P0 - Implement marker file detection
-- **Duration:** 1 hour
-- **Dependencies:** TASK-002
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  package splash
-
-  import (
-      "os"
-      "path/filepath"
-  )
-
-  const markerFile = ".splash_shown"
-
-  func getMarkerPath() string {
-      home, _ := os.UserHomeDir()
-      return filepath.Join(home, ".rycode", markerFile)
-  }
-
-  func IsFirstRun() bool {
-      _, err := os.Stat(getMarkerPath())
-      return os.IsNotExist(err)
-  }
-
-  func MarkAsShown() error {
-      path := getMarkerPath()
-      dir := filepath.Dir(path)
-
-      // Ensure directory exists
-      if err := os.MkdirAll(dir, 0755); err != nil {
-          return err
-      }
-
-      // Create marker file
-      return os.WriteFile(path, []byte("shown"), 0644)
-  }
-  ```
-- **Verification:** Test on fresh system
-
-**TASK-035** 🟠 P1 - Implement random splash logic (10%)
-- **Duration:** 30 min
-- **Dependencies:** TASK-034
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  import "math/rand"
-
-  func ShouldShowSplash(config *Config) bool {
-      // First run always shows
-      if IsFirstRun() {
-          return true
-      }
-
-      // User preference
-      if !config.SplashEnabled {
-          return false
-      }
-
-      // Reduced motion accessibility
-      if config.ReducedMotion {
-          return false
-      }
-
-      // Random 10%
-      return rand.Float64() < 0.1
-  }
-  ```
-- **Verification:** Test 100 runs, ~10 should show splash
-
-**TASK-036** 🟡 P2 - Add command-line flag to force/disable
-- **Duration:** 1 hour
-- **Dependencies:** TASK-034
-- **Files:** `cmd/rycode/main.go`
-- **Implementation:**
-  ```go
-  var (
-      showSplash = flag.Bool("splash", false, "Force show splash screen")
-      noSplash   = flag.Bool("no-splash", false, "Skip splash screen")
-  )
-
-  func main() {
-      flag.Parse()
-
-      if *noSplash {
-          runMainTUI()
-          return
-      }
-
-      if *showSplash || shouldShowSplash() {
-          runSplash()
-      }
-
-      runMainTUI()
-  }
-  ```
-- **Verification:** `./rycode --splash` and `./rycode --no-splash`
-
-**TASK-037** 🟢 P3 - Log splash decisions (for debugging)
-- **Duration:** 30 min
-- **Dependencies:** TASK-035
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  import "github.com/aaronmrosenthal/rycode/packages/rycode/src/util/log"
-
-  func ShouldShowSplash(config *Config) bool {
-      log := log.Create(map[string]interface{}{"service": "splash"})
-
-      if IsFirstRun() {
-          log.Debug("First run detected, showing splash")
-          return true
-      }
-
-      if !config.SplashEnabled {
-          log.Debug("Splash disabled in config")
-          return false
-      }
-
-      if config.ReducedMotion {
-          log.Debug("Reduced motion enabled, skipping splash")
-          return false
-      }
-
-      showRandom := rand.Float64() < 0.1
-      log.Debug("Random splash decision", map[string]interface{}{"show": showRandom})
-      return showRandom
-  }
-  ```
-- **Verification:** Check logs with `RYCODE_LOG_LEVEL=debug`
-
----
-
-### Phase 3.2: Config System (Day 2-3) - 5 Tasks
-
-**TASK-038** 🔴 P0 - Define config structure
-- **Duration:** 1 hour
-- **Dependencies:** None
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  type Config struct {
-      SplashEnabled   bool   `json:"splash_enabled"`
-      SplashFrequency string `json:"splash_frequency"` // "always", "first", "random", "never"
-      ReducedMotion   bool   `json:"reduced_motion"`
-      ColorMode       string `json:"color_mode"` // "truecolor", "256", "16", "auto"
-  }
-
-  func DefaultConfig() *Config {
-      return &Config{
-          SplashEnabled:   true,
-          SplashFrequency: "first",
-          ReducedMotion:   false,
-          ColorMode:       "auto",
-      }
-  }
-  ```
-- **Verification:** Struct compiles
-
-**TASK-039** 🔴 P0 - Implement config loading from JSON
-- **Duration:** 2 hours
-- **Dependencies:** TASK-038
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  import (
-      "encoding/json"
-      "os"
-  )
-
-  func getConfigPath() string {
-      home, _ := os.UserHomeDir()
-      return filepath.Join(home, ".rycode", "config.json")
-  }
-
-  func LoadConfig() (*Config, error) {
-      path := getConfigPath()
-
-      // If config doesn't exist, return defaults
-      if _, err := os.Stat(path); os.IsNotExist(err) {
-          return DefaultConfig(), nil
-      }
-
-      // Read config file
-      data, err := os.ReadFile(path)
-      if err != nil {
-          return nil, err
-      }
-
-      // Parse JSON
-      var config Config
-      if err := json.Unmarshal(data, &config); err != nil {
-          // If parse fails, return defaults (graceful degradation)
-          return DefaultConfig(), nil
-      }
-
-      return &config, nil
-  }
-  ```
-- **Verification:** Create test config file, load successfully
-
-**TASK-040** 🟠 P1 - Implement config saving
-- **Duration:** 1 hour
-- **Dependencies:** TASK-039
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  func (c *Config) Save() error {
-      path := getConfigPath()
-      dir := filepath.Dir(path)
-
-      // Ensure directory exists
-      if err := os.MkdirAll(dir, 0755); err != nil {
-          return err
-      }
-
-      // Marshal to JSON
-      data, err := json.MarshalIndent(c, "", "  ")
-      if err != nil {
-          return err
-      }
-
-      // Write to file
-      return os.WriteFile(path, data, 0644)
-  }
-  ```
-- **Verification:** Save config, manually check JSON file
-
-**TASK-041** 🟡 P2 - Respect system accessibility preferences
-- **Duration:** 2 hours
-- **Dependencies:** TASK-039
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  func LoadConfig() (*Config, error) {
-      config, err := loadConfigFromFile()
-      if err != nil {
-          config = DefaultConfig()
-      }
-
-      // Override with system preferences
-      if os.Getenv("PREFERS_REDUCED_MOTION") == "1" {
-          config.ReducedMotion = true
-      }
-
-      if os.Getenv("NO_COLOR") != "" {
-          config.ColorMode = "16"
-      }
-
-      return config, nil
-  }
-  ```
-- **Verification:** Test with env vars set
-
-**TASK-042** 🟢 P3 - Add config validation
-- **Duration:** 1 hour
-- **Dependencies:** TASK-039
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  func (c *Config) Validate() error {
-      validFrequencies := map[string]bool{
-          "always": true, "first": true, "random": true, "never": true,
-      }
-
-      if !validFrequencies[c.SplashFrequency] {
-          return fmt.Errorf("invalid splash_frequency: %s", c.SplashFrequency)
-      }
-
-      validColorModes := map[string]bool{
-          "truecolor": true, "256": true, "16": true, "auto": true,
-      }
-
-      if !validColorModes[c.ColorMode] {
-          return fmt.Errorf("invalid color_mode: %s", c.ColorMode)
-      }
-
-      return nil
-  }
-  ```
-- **Verification:** Test with invalid config values
-
----
-
-### Phase 3.3: Main Integration (Day 4-5) - 4 Tasks
-
-**TASK-043** 🔴 P0 - Modify main.go to launch splash
-- **Duration:** 2 hours
-- **Dependencies:** TASK-029, TASK-039
-- **Files:** `cmd/rycode/main.go`
-- **Implementation:**
-  ```go
-  package main
-
-  import (
-      "github.com/aaronmrosenthal/rycode/packages/tui/internal/splash"
-      "github.com/aaronmrosenthal/rycode/packages/tui/internal/tui"
-      tea "github.com/charmbracelet/bubbletea"
-  )
-
-  func main() {
-      // Load config
-      config, err := splash.LoadConfig()
-      if err != nil {
-          log.Warn("Failed to load config, using defaults", "error", err)
-          config = splash.DefaultConfig()
-      }
-
-      // Decide whether to show splash
-      if splash.ShouldShowSplash(config) {
-          runSplash()
-          splash.MarkAsShown()
-      }
-
-      // Launch main TUI
-      runMainTUI()
-  }
-
-  func runSplash() {
-      defer func() {
-          if r := recover(); r != nil {
-              log.Error("Splash crashed, continuing to TUI", "error", r)
-          }
-      }()
-
-      model := splash.New()
-      p := tea.NewProgram(model, tea.WithAltScreen())
-      if _, err := p.Run(); err != nil {
-          log.Warn("Splash failed, continuing to TUI", "error", err)
-      }
-  }
-
-  func runMainTUI() {
-      model := tui.New()
-      p := tea.NewProgram(model, tea.WithAltScreen(), tea.WithMouseCellMotion())
-      if _, err := p.Run(); err != nil {
-          log.Fatal("TUI failed", "error", err)
-      }
-  }
-  ```
-- **Verification:** Launch rycode, splash shows, then TUI
-
-**TASK-044** 🟠 P1 - Add clean screen transition
-- **Duration:** 1 hour
-- **Dependencies:** TASK-043
-- **Files:** `cmd/rycode/main.go`
-- **Implementation:**
-  ```go
-  func runSplash() {
-      defer func() {
-          // Clear screen after splash
-          fmt.Print("\033[2J\033[H")  // ANSI clear screen
-      }()
-
-      // ... existing code ...
-  }
-  ```
-- **Verification:** No visual artifacts between splash and TUI
-
-**TASK-045** 🟡 P2 - Add "ESC to disable forever" functionality
-- **Duration:** 2 hours
-- **Dependencies:** TASK-043
-- **Files:** `splash.go`, `config.go`
-- **Implementation:**
-  ```go
-  // In splash.go Update()
-  case tea.KeyMsg:
-      switch msg.String() {
-      case "esc":
-          // Disable splash permanently
-          config, _ := LoadConfig()
-          config.SplashEnabled = false
-          config.Save()
-
-          m.done = true
-          return m, tea.Quit
-      }
-  ```
-- **Verification:** Press ESC, splash never shows again
-
-**TASK-046** 🟢 P3 - Add telemetry (opt-in, anonymous)
-- **Duration:** 2 hours
-- **Dependencies:** TASK-043
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  type SplashTelemetry struct {
-      Shown      bool
-      Completed  bool
-      Duration   time.Duration
-      Act        int  // Where did they stop?
-      Skipped    bool
-  }
-
-  func (m Model) recordTelemetry() {
-      // Only if user opted in to telemetry
-      if !telemetryEnabled() {
-          return
-      }
-
-      telemetry := SplashTelemetry{
-          Shown:     true,
-          Completed: m.act == 3 && m.done,
-          Duration:  time.Duration(m.frame) * 33 * time.Millisecond,
-          Act:       m.act,
-          Skipped:   m.frame < 150,
-      }
-
-      // Send to analytics (async, non-blocking)
-      go sendTelemetry(telemetry)
-  }
-  ```
-- **Verification:** Check analytics dashboard
-
----
-
-### Phase 3.4: Fallback Modes (Day 6-7) - 4 Tasks
-
-**TASK-047** 🟠 P1 - Implement terminal size detection
-- **Duration:** 1 hour
-- **Dependencies:** TASK-043
-- **Files:** `config.go`
-- **Implementation:**
-  ```go
-  import "golang.org/x/term"
-
-  func GetTerminalSize() (int, int, error) {
-      width, height, err := term.GetSize(int(os.Stdout.Fd()))
-      if err != nil {
-          return 80, 24, err  // Default fallback
-      }
-      return width, height, nil
-  }
-
-  func IsTerminalTooSmall() bool {
-      width, height, _ := GetTerminalSize()
-      return width < 80 || height < 24
-  }
-  ```
-- **Verification:** Resize terminal, check detection
-
-**TASK-048** 🟠 P1 - Implement text-only fallback
-- **Duration:** 2 hours
-- **Dependencies:** TASK-047
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func NewWithFallback() Model {
-      if IsTerminalTooSmall() {
-          return NewTextOnlySplash()
-      }
-
-      if !SupportsUnicode() {
-          return NewASCIIOnlySplash()
-      }
-
-      return New()  // Full splash
-  }
-
-  func NewTextOnlySplash() Model {
-      // Simple text-based splash
-      return Model{
-          act: 4,  // Special "text-only" act
-      }
-  }
-
-  func (m Model) View() string {
-      if m.act == 4 {
-          return `
-  RyCode Neural Cortex v1.0.0
-  ---------------------------
-  Six minds. One command line.
-
-  Press any key to continue...
-  `
-      }
-
-      // ... existing acts ...
-  }
-  ```
-- **Verification:** Test on 60×20 terminal
-
-**TASK-049** 🟡 P2 - Implement static image fallback
-- **Duration:** 2 hours
-- **Dependencies:** TASK-047
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-      // Performance monitoring
-      if m.averageFrameTime() > 100*time.Millisecond {
-          // Too slow, switch to static
-          m.act = 5  // Static fallback
-          return m, nil
-      }
-
-      // ... existing update logic ...
-  }
-
-  func (m Model) averageFrameTime() time.Duration {
-      if len(m.frameTimes) == 0 {
-          return 0
-      }
-
-      var sum time.Duration
-      for _, t := range m.frameTimes {
-          sum += t
-      }
-      return sum / time.Duration(len(m.frameTimes))
-  }
-  ```
-- **Verification:** Simulate slow system (sleep in render)
-
-**TASK-050** 🟢 P3 - Document fallback behavior
-- **Duration:** 1 hour
-- **Dependencies:** TASK-048, TASK-049
-- **Files:** `SPLASH.md`
-- **Implementation:**
-  ```markdown
-  ## Fallback Modes
-
-  RyCode splash automatically adapts to your terminal:
-
-  ### Full Mode (Default)
-  - Terminal ≥80×24
-  - Truecolor support
-  - Unicode support
-  - 30 FPS animation
-
-  ### Text-Only Mode
-  - Terminal <80×24
-  - No animation
-  - Plain text message
-
-  ### Static Mode
-  - Performance <15 FPS
-  - Single frame render
-  - No animation
-
-  ### Accessible Mode
-  - PREFERS_REDUCED_MOTION=1
-  - No splash shown
-  - Respects user preferences
-  ```
-- **Verification:** Documentation is clear
-
----
-
-## Week 4: Polish (Visual Excellence) - 16 Tasks
-
-### Phase 4.1: Color Tuning (Day 1-2) - 4 Tasks
-
-**TASK-051** 🟡 P2 - A/B test gradient variations
-- **Duration:** 3 hours
-- **Dependencies:** TASK-015
-- **Files:** `ansi.go`
-- **Implementation:**
-  ```go
-  type GradientStyle int
-
-  const (
-      CyanMagenta GradientStyle = iota
-      CyanBlueMagenta
-      CyanMagentaGold
-  )
-
-  func GradientColorStyled(angle float64, style GradientStyle) RGB {
-      t := math.Mod(angle, 2*math.Pi) / (2 * math.Pi)
-
-      switch style {
-      case CyanMagenta:
-          return lerpRGB(RGB{0, 255, 255}, RGB{255, 0, 255}, t)
-
-      case CyanBlueMagenta:
-          if t < 0.5 {
-              return lerpRGB(RGB{0, 255, 255}, RGB{0, 0, 255}, t*2)
-          }
-          return lerpRGB(RGB{0, 0, 255}, RGB{255, 0, 255}, (t-0.5)*2)
-
-      case CyanMagentaGold:
-          if t < 0.33 {
-              return lerpRGB(RGB{0, 255, 255}, RGB{255, 0, 255}, t*3)
-          } else if t < 0.66 {
-              return lerpRGB(RGB{255, 0, 255}, RGB{255, 174, 0}, (t-0.33)*3)
-          } else {
-              return lerpRGB(RGB{255, 174, 0}, RGB{0, 255, 255}, (t-0.66)*3)
-          }
-      }
-
-      return RGB{255, 255, 255}
-  }
-
-  func lerpRGB(a, b RGB, t float64) RGB {
-      return RGB{
-          R: lerp(a.R, b.R, t),
-          G: lerp(a.G, b.G, t),
-          B: lerp(a.B, b.B, t),
-      }
-  }
-  ```
-- **Verification:** Visual comparison of 3 styles
-
-**TASK-052** 🟡 P2 - Adjust luminance character mapping
-- **Duration:** 2 hours
-- **Dependencies:** TASK-010
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  // Test different character sets
-  var charSets = [][]rune{
-      {' ', '.', '·', ':', '*', '◉', '◎', '⚡'},           // Original
-      {' ', '░', '▒', '▓', '█', '█', '█', '█'},           // Blocks
-      {' ', '.', ':', '-', '=', '+', '#', '@'},           // ASCII safe
-      {' ', '·', '∘', '○', '◉', '⦿', '⬤', '⬤'},           // Circles
-  }
-
-  func (r *CortexRenderer) setCharacterSet(setIndex int) {
-      r.chars = charSets[setIndex]
-  }
-  ```
-- **Verification:** A/B test with users
-
-**TASK-053** 🟢 P3 - Add theme detection (light/dark)
-- **Duration:** 2 hours
-- **Dependencies:** TASK-011
-- **Files:** `ansi.go`
-- **Implementation:**
-  ```go
-  func DetectTheme() string {
-      // Check environment
-      if theme := os.Getenv("COLORFGBG"); theme != "" {
-          // Format: "foreground;background"
-          // 0-7 = dark, 8-15 = light
-          parts := strings.Split(theme, ";")
-          if len(parts) >= 2 {
-              bg, _ := strconv.Atoi(parts[1])
-              if bg >= 8 {
-                  return "light"
-              }
-          }
-      }
-
-      // Default assume dark
-      return "dark"
-  }
-
-  func GradientColorThemed(angle float64, theme string) RGB {
-      if theme == "light" {
-          // Darker colors for light theme
-          cyan := RGB{0, 180, 180}
-          magenta := RGB{180, 0, 180}
-          return lerpRGB(cyan, magenta, angle/(2*math.Pi))
-      }
-
-      // Bright colors for dark theme
-      return GradientColor(angle)
-  }
-  ```
-- **Verification:** Test on light theme terminal
-
-**TASK-054** 🟢 P3 - Document color customization
-- **Duration:** 1 hour
-- **Dependencies:** TASK-051
-- **Files:** `SPLASH.md`
-- **Implementation:**
-  ```markdown
-  ## Color Customization
-
-  Edit `~/.rycode/config.json`:
-
-  ```json
-  {
-    "splash_gradient": "cyan-magenta",
-    "splash_characters": "circles",
-    "color_mode": "truecolor"
-  }
-  ```
-
-  Available gradients:
-  - `cyan-magenta` (default)
-  - `cyan-blue-magenta`
-  - `cyan-magenta-gold`
-
-  Available character sets:
-  - `unicode` (default)
-  - `blocks`
-  - `ascii`
-  - `circles`
-  ```
-- **Verification:** Documentation is complete
-
----
-
-### Phase 4.2: Easter Eggs (Day 3) - 5 Tasks
-
-**TASK-055** 🟢 P3 - Implement `/donut` command
-- **Duration:** 2 hours
-- **Dependencies:** TASK-010
-- **Files:** `splash.go`, `cmd/rycode/main.go`
-- **Implementation:**
-  ```go
-  // In main.go
-  func main() {
-      if len(os.Args) > 1 && os.Args[1] == "donut" {
-          runDonutEasterEgg()
-          return
-      }
-
-      // ... normal flow ...
-  }
-
-  func runDonutEasterEgg() {
-      model := splash.NewDonutMode()
-      p := tea.NewProgram(model, tea.WithAltScreen())
-      p.Run()
-  }
-
-  // In splash.go
-  func NewDonutMode() Model {
-      m := New()
-      m.act = 2  // Jump straight to cortex
-      m.easterEgg = "donut"
-      return m
-  }
-  ```
-- **Verification:** `./rycode donut` shows spinning torus forever
-
-**TASK-056** 🟢 P3 - Hide "CLAUDE WAS HERE" in z-buffer
-- **Duration:** 2 hours
-- **Dependencies:** TASK-009
-- **Files:** `cortex.go`
-- **Implementation:**
-  ```go
-  const secretMessage = "CLAUDE WAS HERE"
-
-  func (r *CortexRenderer) renderSecretMessage() {
-      if r.frame%300 != 0 {  // Every 10 seconds
-          return
-      }
-
-      // Encode message in z-buffer pattern
-      x, y := r.width/2-7, r.height/2
-      for i, char := range secretMessage {
-          idx := y*r.width + x + i
-          if idx < len(r.screen) {
-              r.screen[idx] = char
-          }
-      }
-  }
-
-  func (r *CortexRenderer) RenderFrame() {
-      // ... normal rendering ...
-
-      // 1% chance to reveal secret
-      if rand.Float64() < 0.01 {
-          r.renderSecretMessage()
-      }
-  }
-  ```
-- **Verification:** Run for 2 minutes, should see message occasionally
-
-**TASK-057** 🟢 P3 - Konami code → Rainbow colors
-- **Duration:** 2 hours
-- **Dependencies:** TASK-029
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  type Model struct {
-      // ... existing fields ...
-      konamiCode   []string
-      konamiIdx    int
-      rainbowMode  bool
-  }
-
-  var konamiSequence = []string{"up", "up", "down", "down", "left", "right", "left", "right", "b", "a"}
-
-  func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-      switch msg := msg.(type) {
-      case tea.KeyMsg:
-          // Check Konami code
-          if msg.String() == konamiSequence[m.konamiIdx] {
-              m.konamiIdx++
-              if m.konamiIdx >= len(konamiSequence) {
-                  m.rainbowMode = true
-                  m.konamiIdx = 0
-              }
-          } else {
-              m.konamiIdx = 0
-          }
-
-          // ... rest of key handling ...
-      }
-  }
-
-  func (m Model) View() string {
-      if m.rainbowMode {
-          return m.renderRainbow()
-      }
-
-      // ... normal rendering ...
-  }
-
-  func (m Model) renderRainbow() string {
-      // Render with cycling rainbow colors
-      colors := []RGB{
-          {255, 0, 0},    // Red
-          {255, 127, 0},  // Orange
-          {255, 255, 0},  // Yellow
-          {0, 255, 0},    // Green
-          {0, 0, 255},    // Blue
-          {75, 0, 130},   // Indigo
-          {148, 0, 211},  // Violet
-      }
-
-      // ... apply rainbow gradient to cortex ...
-  }
-  ```
-- **Verification:** Input Konami code, colors change
-
-**TASK-058** 🟢 P3 - Press '?' → Show math equations
-- **Duration:** 1 hour
-- **Dependencies:** TASK-029
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-      switch msg := msg.(type) {
-      case tea.KeyMsg:
-          if msg.String() == "?" {
-              m.showMath = !m.showMath
-          }
-      }
-  }
-
-  func (m Model) View() string {
-      if m.showMath {
-          return `
-  Torus Parametric Equations:
-    x(θ,φ) = (R + r·cos(φ))·cos(θ)
-    y(θ,φ) = (R + r·cos(φ))·sin(θ)
-    z(θ,φ) = r·sin(φ)
-
-  Where: R = 2, r = 1
-
-  Rotation Matrices:
-    Rx(A) = [1   0      0   ]
-            [0  cos(A) -sin(A)]
-            [0  sin(A)  cos(A)]
-
-  Press '?' again to hide
-  `
-      }
-
-      // ... normal rendering ...
-  }
-  ```
-- **Verification:** Press '?', equations show
-
-**TASK-059** 🟢 P3 - Document easter eggs (after 1 week)
-- **Duration:** 1 hour
-- **Dependencies:** TASK-055, TASK-056, TASK-057, TASK-058
-- **Files:** `EASTER_EGGS.md`
-- **Implementation:**
-  ```markdown
-  # RyCode Easter Eggs 🥚
-
-  > Discovered after launch week!
-
-  ## 1. Infinite Donut
-  ```bash
-  ./rycode donut
-  ```
-  Spin the cortex forever.
-
-  ## 2. Hidden Message
-  Stare at the splash long enough...
-  *"CLAUDE WAS HERE"*
-
-  ## 3. Konami Code
-  During splash: ↑↑↓↓←→←→BA
-  Rainbow mode activated!
-
-  ## 4. Math Reveal
-  Press '?' during splash to see the equations.
-
-  ## 5. More coming...
-  Can you find them all?
-  ```
-- **Verification:** Documentation published
-
----
-
-### Phase 4.3: Performance Optimization (Day 4-5) - 4 Tasks
-
-**TASK-060** 🟠 P1 - Test on low-end systems
-- **Duration:** 4 hours
-- **Dependencies:** TASK-017
-- **Testing Platforms:**
-  - Raspberry Pi 4 (ARM64)
-  - Old MacBook Pro (2015, Intel)
-  - Linux VM with limited CPU
-  - Windows laptop (Intel i3)
-- **Metrics to collect:**
-  - Frame rate (FPS)
-  - CPU usage (%)
-  - Memory usage (MB)
-  - User perception ("smooth" vs "laggy")
-- **Verification:** Document performance on each platform
-
-**TASK-061** 🟠 P1 - Implement adaptive frame rate
-- **Duration:** 3 hours
-- **Dependencies:** TASK-060
-- **Files:** `splash.go`
-- **Implementation:**
-  ```go
-  type Model struct {
-      // ... existing fields ...
-      frameTimes    []time.Duration
-      lastFrameTime time.Time
-      targetFPS     int
-  }
-
-  func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-      switch msg := msg.(type) {
-      case tickMsg:
-          // Measure frame time
-          now := time.Now()
-          if !m.lastFrameTime.IsZero() {
-              frameTime := now.Sub(m.lastFrameTime)
-              m.frameTimes = append(m.frameTimes, frameTime)
-              if len(m.frameTimes) > 30 {
-                  m.frameTimes = m.frameTimes[1:]
-              }
-
-              // Calculate average
-              avg := m.averageFrameTime()
-
-              // Adjust target FPS
-              if avg > 50*time.Millisecond {
-                  m.targetFPS = 15  // Slow down
-              } else {
-                  m.targetFPS = 30  // Full speed
-              }
-          }
-          m.lastFrameTime = now
-
-          m.frame++
-          // ... rest of update ...
-
-          // Dynamic tick rate
-          tickDuration := time.Duration(1000/m.targetFPS) * time.Millisecond
-          return m, tea.Tick(tickDuration, func(t time.Time) tea.Msg {
-              return tickMsg(t)
-          })
-      }
-  }
-  ```
-- **Verification:** Test on slow system, FPS adapts
-
-**TASK-062** 🟡 P2 - Optimize for Windows CMD
-- **Duration:** 2 hours
-- **Dependencies:** TASK-043
-- **Files:** `ansi.go`, `splash.go`
-- **Implementation:**
-  ```go
-  func IsWindowsCMD() bool {
-      return runtime.GOOS == "windows" && os.Getenv("WT_SESSION") == ""
-  }
-
-  func NewWithPlatformOptimizations() Model {
-      if IsWindowsCMD() {
-          // Windows CMD: Limited unicode, slow rendering
-          m := New()
-          m.cortex.setCharacterSet(2)  // ASCII-only
-          m.targetFPS = 15  // Lower FPS
-          return m
-      }
-
-      return New()
-  }
-  ```
-- **Verification:** Test on Windows CMD.exe
-
-**TASK-063** 🟡 P2 - Profile memory usage
-- **Duration:** 2 hours
-- **Dependencies:** TASK-017
-- **Implementation:**
-  ```bash
-  # Memory profiling
-  go test -memprofile=mem.prof -bench=BenchmarkRenderFrame
-
-  # Analyze
-  go tool pprof mem.prof
-  # (pprof) top10
-  # (pprof) list RenderFrame
-
-  # Check for allocations
-  go test -bench=. -benchmem
-  # Target: 0 allocs per frame
-  ```
-- **Acceptance Criteria:** <10 MB total memory usage
-- **Verification:** pprof output shows no leaks
-
----
-
-### Phase 4.4: Cross-Platform Testing (Day 6-7) - 3 Tasks
-
-**TASK-064** 🔴 P0 - Test on all 5 platforms
-- **Duration:** 8 hours
-- **Dependencies:** TASK-043
-- **Testing Matrix:**
-
-| Platform | Terminal | Test Result |
-|----------|----------|-------------|
-| macOS ARM64 | Terminal.app | ✅ Pass |
-| macOS ARM64 | iTerm2 | ✅ Pass |
-| macOS Intel | Terminal.app | ⚠️ 25 FPS |
-| Linux AMD64 | gnome-terminal | ✅ Pass |
-| Linux AMD64 | xterm | ⚠️ 256 colors |
-| Linux ARM64 | Raspberry Pi | ⚠️ 15 FPS |
-| Windows 10 | Windows Terminal | ✅ Pass |
-| Windows 10 | PowerShell 7 | ✅ Pass |
-| Windows 10 | CMD.exe | ⚠️ ASCII only |
-
-- **Verification:** Document results in COMPATIBILITY.md
-
-**TASK-065** 🟠 P1 - Fix platform-specific bugs
-- **Duration:** 4 hours
-- **Dependencies:** TASK-064
-- **Common Issues:**
-  - Windows line endings (\r\n vs \n)
-  - Terminal size detection on Windows
-  - Unicode rendering on old terminals
-  - ANSI color codes not supported
-- **Implementation:** Fix issues discovered in testing
-- **Verification:** Re-test on affected platforms
-
-**TASK-066** 🟡 P2 - Create fallback screenshots
-- **Duration:** 2 hours
-- **Dependencies:** TASK-064
-- **Files:** `docs/screenshots/`
-- **Screenshots needed:**
-  - Full color splash (truecolor)
-  - 256-color fallback
-  - Text-only fallback
-  - All 3 acts (boot, cortex, closer)
-- **Tools:** Asciinema, screenshot tool
-- **Verification:** Screenshots in docs/
-
----
-
-## Week 5: Launch (Marketing & Distribution) - 21 Tasks
-
-### Phase 5.1: Demo Video (Day 1-2) - 5 Tasks
-
-**TASK-067** 🔴 P0 - Record high-quality splash video
-- **Duration:** 2 hours
-- **Dependencies:** TASK-043
-- **Recording specs:**
-  - Resolution: 1920×1080 (scaled terminal)
-  - Frame rate: 60 FPS
-  - Duration: 30 seconds (full splash + skip demo)
-  - Format: MP4 (H.264)
-- **Tools:** OBS, QuickTime, Asciinema
-- **Content:**
-  - 0-5s: Full splash (boot → cortex → closer)
-  - 5-10s: Skip with 'S' key demo
-  - 10-15s: Transition to main TUI
-  - 15-30s: Quick feature showcase
-- **Verification:** Video plays smoothly
-
-**TASK-068** 🟠 P1 - Add captions and overlays
-- **Duration:** 2 hours
-- **Dependencies:** TASK-067
-- **Captions:**
-  - "100% AI-Designed"
-  - "Zero Compromises"
-  - "Real 3D Math in ASCII"
-  - "30 FPS in Your Terminal"
-- **Tools:** iMovie, Final Cut Pro, DaVinci Resolve
-- **Verification:** Captions are readable
-
-**TASK-069** 🟠 P1 - Export to multiple formats
-- **Duration:** 1 hour
-- **Dependencies:** TASK-068
-- **Formats:**
-  - MP4 (1920×1080) - for Twitter/YouTube
-  - GIF (800×600) - for GitHub README
-  - WebM (1920×1080) - for website
-  - Thumbnail (1200×630) - for social cards
-- **Verification:** All formats render correctly
-
-**TASK-070** 🟡 P2 - Create GIF version for GitHub
-- **Duration:** 1 hour
-- **Dependencies:** TASK-067
-- **Specs:**
-  - Size: 800×600 pixels
-  - Frame rate: 30 FPS
-  - Duration: 10 seconds (looping)
-  - File size: <5 MB
-- **Tools:** gifski, Gifox, ffmpeg
-- **Command:**
-  ```bash
-  ffmpeg -i splash.mp4 -vf "fps=30,scale=800:-1:flags=lanczos" \
-    -c:v gif splash.gif
-  ```
-- **Verification:** GIF loops smoothly
-
-**TASK-071** 🟢 P3 - Upload to video platforms
-- **Duration:** 1 hour
-- **Dependencies:** TASK-069
-- **Platforms:**
-  - YouTube (unlisted or public)
-  - Twitter/X
-  - LinkedIn
-  - GitHub Assets
-- **Verification:** Videos are publicly accessible
-
----
-
-### Phase 5.2: Landing Page (Day 3) - 4 Tasks
-
-**TASK-072** 🔴 P0 - Update README.md with splash section
-- **Duration:** 2 hours
-- **Dependencies:** TASK-070
-- **Files:** `README.md`
-- **Content:**
-  ```markdown
-  ## 🌀 Epic Splash Screen
-
-  ![RyCode Splash](docs/screenshots/splash.gif)
-
-  Experience a technically stunning 3D ASCII splash screen that demonstrates RyCode's "superhuman" capabilities:
-
-  - **Real 3D math** - Rotating torus with z-buffer depth sorting
-  - **30 FPS animation** - Smooth, high-performance rendering
-  - **Cyberpunk colors** - Cyan-to-magenta gradient
-  - **Easter eggs** - Try `./rycode donut` 😉
-
-  ### Skip or Disable
-
-  - Press `S` during splash to skip
-  - Press `ESC` to disable permanently
-  - Or add to config: `"splash_enabled": false`
-  ```
-- **Verification:** README updated on GitHub
-
-**TASK-073** 🟠 P1 - Create SPLASH.md technical deep dive
-- **Duration:** 3 hours
-- **Dependencies:** None
-- **Files:** `SPLASH.md`
-- **Sections:**
-  - Overview (what it is)
-  - Technical Implementation (algorithms)
-  - Performance (benchmarks)
-  - Customization (config options)
-  - Easter Eggs (hints, not full reveals)
-  - Fallback Modes (accessibility)
-- **Verification:** Documentation is comprehensive
-
-**TASK-074** 🟡 P2 - Add splash section to website
-- **Duration:** 2 hours
-- **Dependencies:** TASK-070
-- **Content:**
-  - Hero section with video
-  - "What Makes RyCode Superior" points
-  - Technical breakdown (donut math)
-  - Call-to-action (GitHub stars)
-- **Verification:** Website deployed
-
-**TASK-075** 🟢 P3 - Create social media cards
-- **Duration:** 1 hour
-- **Dependencies:** TASK-070
-- **Specs:**
-  - Twitter Card: 1200×675
-  - Open Graph: 1200×630
-  - Content: Screenshot + tagline
-- **Tools:** Figma, Canva, Photoshop
-- **Verification:** Cards render on Twitter/Facebook
-
----
-
-### Phase 5.3: Social Media Campaign (Day 4) - 6 Tasks
-
-**TASK-076** 🔴 P0 - Write launch announcement
-- **Duration:** 2 hours
-- **Dependencies:** TASK-070
-- **Tweet/Post:**
-  ```
-  🚨 RyCode just got a splash screen that proves we're not messing around.
-
-  • 3D ASCII torus (real donut math)
-  • 30 FPS in your terminal
-  • Cyberpunk aesthetics
-  • 100% AI-designed by Claude
-
-  This is what happens when AI designs tools with zero compromises.
-
-  🔗 [GitHub link]
-  🎥 [Video demo]
-
-  #CLI #Terminal #AI #OpenSource
-  ```
-- **Verification:** Post drafted
-
-**TASK-077** 🟠 P1 - Post to Twitter/X
-- **Duration:** 30 min
-- **Dependencies:** TASK-076
-- **Timing:** 10 AM PST (optimal engagement)
-- **Content:** Launch tweet + video
-- **Hashtags:** #CLI #Terminal #AI #OpenSource #DeveloperTools
-- **Verification:** Tweet posted
-
-**TASK-078** 🟠 P1 - Post to Reddit
-- **Duration:** 1 hour
-- **Dependencies:** TASK-076
-- **Subreddits:**
-  - r/programming
-  - r/commandline
-  - r/unixporn
-  - r/golang
-- **Title:** "RyCode's 3D ASCII splash screen - Real donut math in your terminal"
-- **Verification:** Posts submitted
-
-**TASK-079** 🟠 P1 - Post to Hacker News
-- **Duration:** 30 min
-- **Dependencies:** TASK-076
-- **Title:** "Show HN: RyCode's Epic Terminal Splash Screen (3D ASCII with 30 FPS)"
-- **URL:** GitHub README
-- **Timing:** 8 AM PST
-- **Verification:** Submission live
-
-**TASK-080** 🟡 P2 - Post to LinkedIn
-- **Duration:** 1 hour
-- **Dependencies:** TASK-076
-- **Audience:** Professional network
-- **Angle:** "What's possible when AI designs developer tools"
-- **Content:** Video + technical breakdown
-- **Verification:** Post published
-
-**TASK-081** 🟢 P3 - Engage with comments
-- **Duration:** Ongoing (2 hours/day for week)
-- **Dependencies:** TASK-077, TASK-078, TASK-079
-- **Actions:**
-  - Reply to comments
-  - Answer technical questions
-  - Share UGC (user recordings)
-  - Thank contributors
-- **Verification:** Response rate >80%
-
----
-
-### Phase 5.4: Community & Documentation (Day 5) - 3 Tasks
-
-**TASK-082** 🟠 P1 - Create GitHub Discussion
-- **Duration:** 1 hour
-- **Dependencies:** TASK-076
-- **Topics:**
-  - "Share your splash screen recordings!"
-  - "Easter egg hunt - what have you found?"
-  - "Splash customization showcase"
-- **Verification:** Discussions created
-
-**TASK-083** 🟡 P2 - Update CHANGELOG.md
-- **Duration:** 1 hour
-- **Dependencies:** None
-- **Content:**
-  ```markdown
-  ## v1.1.0 - Epic Splash Screen (2025-10-18)
-
-  ### Added
-  - 🌀 Epic 3D ASCII splash screen with rotating neural cortex
-  - 30 FPS animation with adaptive performance
-  - Cyberpunk color gradients (cyan-to-magenta)
-  - Multiple easter eggs (try `./rycode donut`)
-  - First-run detection with config system
-  - Graceful fallbacks for limited terminals
-
-  ### Changed
-  - Splash shows on first run + 10% random
-  - Config option to disable: `splash_enabled: false`
-
-  ### Technical
-  - Real 3D torus rendering with z-buffer
-  - Port of Andy Sloane's donut algorithm
-  - <1ms per frame rendering
-  - <10 MB memory usage
-  ```
-- **Verification:** CHANGELOG updated
-
-**TASK-084** 🟢 P3 - Write blog post (optional)
-- **Duration:** 3 hours
-- **Dependencies:** TASK-073
-- **Title:** "How Claude AI Built a 3D ASCII Splash Screen in Go"
-- **Content:**
-  - Motivation (why splash screens matter)
-  - Technical deep dive (donut math)
-  - Performance optimization journey
-  - Lessons learned
-  - Call-to-action (try RyCode)
-- **Verification:** Blog published
-
----
-
-### Phase 5.5: Monitoring & Iteration (Day 6-7) - 3 Tasks
-
-**TASK-085** 🔴 P0 - Set up GitHub star tracking
-- **Duration:** 1 hour
-- **Dependencies:** None
-- **Tools:** GitHub API, spreadsheet
-- **Metrics:**
-  - Stars per day
-  - Forks per day
-  - Issues opened (bugs vs features)
-  - PR submissions
-- **Verification:** Dashboard created
-
-**TASK-086** 🟠 P1 - Monitor social media impressions
-- **Duration:** 1 hour
-- **Dependencies:** TASK-077, TASK-078, TASK-079
-- **Metrics:**
-  - Twitter impressions
-  - Reddit upvotes
-  - HN points
-  - Video views
-  - Comments/engagement
-- **Verification:** Spreadsheet updated daily
-
-**TASK-087** 🟠 P1 - Hot-fix critical bugs
-- **Duration:** Ongoing (4 hours/day for week)
-- **Dependencies:** TASK-085
-- **Process:**
-  1. Monitor GitHub Issues
-  2. Prioritize by severity
-  3. Fix critical bugs within 24 hours
-  4. Release patch version (v1.1.1, v1.1.2, etc.)
-  5. Communicate fixes to users
-- **Verification:** All critical bugs resolved
-
----
-
-## Success Metrics Summary
-
-### Technical Metrics (Week 1-4)
-- ✅ Frame rate: ≥30 FPS (target: 30 FPS)
-- ✅ Startup overhead: <50ms (target: <50ms)
-- ✅ Memory usage: <10 MB (target: <10 MB)
-- ✅ Binary size: <500 KB added (target: <500 KB)
-- ✅ Crash rate: 0% on 5 platforms (target: 0%)
-- ✅ Test coverage: ≥80% (target: 80%)
-
-### User Metrics (Week 5)
-- ✅ Completion rate: ≥80% (don't skip splash)
-- ✅ Easter egg discovery: ≥20%
-- ✅ Disable rate: <10%
-- ✅ Positive feedback: >80%
-
-### Marketing Metrics (Week 5)
-- ✅ GitHub stars: 500+ week 1 (target: 500+)
-- ✅ Social impressions: 100k+ (target: 100k+)
-- ✅ Video views: 10k+ (target: 10k+)
-- ✅ Media coverage: 1+ blog writeup (target: 1+)
-
----
-
-## Dependencies Visualization
-
-```
-Week 1: Foundation
-  TASK-001 (Setup)
-    ├─ TASK-002 (Package init)
-    │   ├─ TASK-005 (Torus math)
-    │   │   ├─ TASK-006 (Rotation)
-    │   │   │   ├─ TASK-007 (Projection)
-    │   │   │   ├─ TASK-008 (Luminance)
-    │   │   │   └─ TASK-009 (Z-buffer)
-    │   │   │       └─ TASK-010 (Render loop) ★ CRITICAL PATH
-    │   │   └─ TASK-011 (ANSI colors)
-    │   │       └─ TASK-012 (Gradient)
-    │   │           └─ TASK-015 (Color integration)
-    │   └─ TASK-019 (Boot data)
-    │       └─ TASK-020 (Boot animation)
-    │           └─ TASK-024 (Closer)
-    │               └─ TASK-025 (Closer render)
-    └─ TASK-003 (Tests)
-        └─ TASK-016 (Unit tests)
-            └─ TASK-017 (Benchmarks)
-
-Week 2: Animations
-  TASK-020 (Boot) + TASK-025 (Closer)
-    └─ TASK-029 (Bubble Tea Model) ★ CRITICAL PATH
-        └─ TASK-030 (Init/Update)
-            └─ TASK-031 (View)
-
-Week 3: Integration
-  TASK-029 (Model) + TASK-039 (Config)
-    └─ TASK-043 (Main integration) ★ CRITICAL PATH
-
-Week 4: Polish
-  TASK-043 (Integration)
-    └─ TASK-051 (Color tuning)
-    └─ TASK-055 (Easter eggs)
-    └─ TASK-060 (Performance testing)
-    └─ TASK-064 (Cross-platform testing) ★ CRITICAL PATH
-
-Week 5: Launch
-  TASK-064 (Testing)
-    └─ TASK-067 (Video recording) ★ CRITICAL PATH
-        └─ TASK-072 (README update)
-            └─ TASK-076 (Launch announcement)
-                └─ TASK-077, 078, 079 (Social posts)
-```
-
----
-
-## Critical Path Tasks (18 tasks)
-
-These tasks MUST complete on time or the entire project is delayed:
-
-1. **TASK-002** - Package initialization (blocks everything)
-2. **TASK-010** - Render loop (Week 1 milestone)
-3. **TASK-029** - Bubble Tea Model (Week 2 milestone)
-4. **TASK-043** - Main integration (Week 3 milestone)
-5. **TASK-064** - Cross-platform testing (Week 4 milestone)
-6. **TASK-067** - Demo video (Week 5 milestone)
-
-All other tasks can be parallelized or have some flexibility.
-
----
-
-## Resource Allocation
-
-**Developer Time:**
-- Week 1: 40 hours (full-time)
-- Week 2: 40 hours (full-time)
-- Week 3: 35 hours (focus on integration)
-- Week 4: 30 hours (testing + polish)
-- Week 5: 20 hours (launch + monitoring)
-- **Total:** 165 hours (~1.5 FTE for 5 weeks)
-
-**QA Time:**
-- Week 3: 8 hours (integration testing)
-- Week 4: 16 hours (cross-platform testing)
-- Week 5: 6 hours (post-launch monitoring)
-- **Total:** 30 hours
-
-**Marketing Time:**
-- Week 5: 15 hours (video, posts, engagement)
-- **Total:** 15 hours
-
----
-
-## Next Steps
-
-1. **Review this task list** with team
-2. **Assign tasks** to developers
-3. **Set up project board** (GitHub Projects, Jira, etc.)
-4. **Start with TASK-001** on Monday
-5. **Daily standups** to track progress
-6. **Weekly demos** on Fridays
-
----
-
-**🚀 Ready to execute. 87 tasks. 5 weeks. Let's ship this.**
-
-*Generated by Claude AI from SPLASH_IMPLEMENTATION_PLAN.md*
diff --git a/packages/tui/SPLASH_TESTING.md b/packages/tui/SPLASH_TESTING.md
deleted file mode 100644
index 28e7391d..00000000
--- a/packages/tui/SPLASH_TESTING.md
+++ /dev/null
@@ -1,598 +0,0 @@
-# RyCode Splash Screen - Testing Documentation
-
-> Comprehensive guide to testing the splash screen implementation
-
----
-
-## 📊 Test Coverage Summary
-
-**Total Tests:** 31 passing
-**Coverage:** 54.2% of statements
-**Test Files:** 4
-- `ansi_test.go` - Color system tests (5 tests)
-- `config_test.go` - Configuration tests (5 tests)
-- `cortex_test.go` - 3D rendering tests (5 tests)
-- `terminal_test.go` - Terminal detection tests (9 tests)
-- `fallback_test.go` - Fallback rendering tests (7 tests)
-
-**Coverage Progression:**
-- Initial: 19.1%
-- After config tests: 26.2%
-- After terminal tests: 33.2%
-- After fallback tests: **54.2%** ✅
-
----
-
-## 🧪 Running Tests
-
-### Run All Tests
-```bash
-go test ./internal/splash -v
-```
-
-### Run With Coverage
-```bash
-go test ./internal/splash -cover
-```
-
-### Run With Coverage Report
-```bash
-go test ./internal/splash -coverprofile=coverage.out
-go tool cover -html=coverage.out
-```
-
-### Run Specific Test
-```bash
-go test ./internal/splash -v -run=TestTorusGeometry
-```
-
-### Run Test Category
-```bash
-# Config tests only
-go test ./internal/splash -v -run="TestDefault|TestShould|TestConfig|TestIsFirst|TestDisable"
-
-# Terminal detection tests
-go test ./internal/splash -v -run="TestDetect|TestSupports|TestEstimate|TestColor"
-
-# Rendering tests
-go test ./internal/splash -v -run="TestTorus|TestZBuffer|TestRender|TestRotation"
-
-# Fallback tests
-go test ./internal/splash -v -run="TestNew|TestText|TestCenter|TestStrip|TestSimplified"
-```
-
----
-
-## 📦 Test Organization
-
-### ansi_test.go - Color System Tests
-
-**Purpose:** Verify ANSI color utilities and gradient functions
-
-**Tests:**
-1. `TestColorizeBasic` - Basic text colorization
-2. `TestGradientColor` - Cyan-magenta gradient interpolation
-3. `TestLerpRGB` - Linear RGB interpolation
-4. `TestANSIFormat` - ANSI escape code formatting
-5. `TestResetColor` - ANSI reset sequence
-
-**Key Validations:**
-- ANSI escape codes format correctly
-- Gradient colors interpolate smoothly
-- RGB values stay in valid range [0, 255]
-- Reset codes work properly
-
-**Example:**
-```go
-func TestColorizeBasic(t *testing.T) {
-    text := "Hello"
-    color := RGB{255, 0, 0}
-    result := Colorize(text, color)
-
-    // Should contain ANSI codes and original text
-    if !strings.Contains(result, text) {
-        t.Error("Colorized text should contain original text")
-    }
-}
-```
-
----
-
-### config_test.go - Configuration Tests
-
-**Purpose:** Validate configuration system, save/load, and first-run detection
-
-**Tests:**
-1. `TestDefaultConfig` - Default configuration values
-2. `TestShouldShowSplash` - Splash display logic (5 scenarios)
-3. `TestConfigSaveAndLoad` - Config persistence
-4. `TestIsFirstRun` - First-run detection
-5. `TestDisableSplashPermanently` - Permanent disable function
-
-**Key Validations:**
-- Default config is sensible (splash enabled, "first" frequency)
-- Splash logic respects all configuration options
-- Config saves and loads correctly from disk
-- First-run marker file works properly
-- Disable function persists setting
-
-**Scenarios Tested:**
-```go
-// 1. Disabled in config
-config := &Config{SplashEnabled: false, SplashFrequency: "always"}
-// Should return false
-
-// 2. Reduced motion enabled
-config := &Config{SplashEnabled: true, ReducedMotion: true}
-// Should return false
-
-// 3. First run
-config := &Config{SplashEnabled: true, ReducedMotion: false, SplashFrequency: "first"}
-// Should return true (if IsFirstRun() == true)
-
-// 4. Always frequency
-config := &Config{SplashEnabled: true, SplashFrequency: "always"}
-// Should return true
-
-// 5. Never frequency
-config := &Config{SplashEnabled: true, SplashFrequency: "never"}
-// Should return false
-```
-
-**Testing Patterns:**
-- Uses `t.TempDir()` for isolated file system tests
-- Overrides `getConfigPath` and `getMarkerPath` functions for testing
-- Verifies JSON serialization/deserialization
-
----
-
-### cortex_test.go - 3D Rendering Tests
-
-**Purpose:** Validate donut algorithm math and rendering correctness
-
-**Tests:**
-1. `TestTorusGeometry` - Torus parametric equations
-2. `TestZBufferOcclusion` - Z-buffer depth sorting
-3. `TestRenderFrameNoPanic` - Rendering doesn't crash
-4. `TestRenderWithColors` - Rainbow mode rendering
-5. `TestRotationAnglesUpdate` - Rotation angle increments
-
-**Key Validations:**
-- Torus geometry calculates correctly (x, y, z coordinates)
-- Z-buffer prevents far objects from drawing over near ones
-- Rendering completes without panics
-- Rainbow mode changes colors
-- Rotation angles update each frame
-
-**Math Tested:**
-```go
-// Torus parametric equations
-x(θ,φ) = (R + r·cos(φ))·cos(θ)
-y(θ,φ) = (R + r·cos(φ))·sin(θ)
-z(θ,φ) = r·sin(φ)
-
-// Where:
-// R = 2 (major radius)
-// r = 1 (minor radius)
-// θ, φ ∈ [0, 2π]
-```
-
-**Performance Note:**
-- `TestRenderFrameNoPanic` runs 10 render cycles
-- Takes ~0.03s for 10 frames = ~0.003s per frame
-- Confirms splash meets 30 FPS target (0.033s per frame)
-
----
-
-### terminal_test.go - Terminal Detection Tests
-
-**Purpose:** Verify terminal capability detection and environment variable handling
-
-**Tests:**
-1. `TestDetectColorMode` - Color mode detection (4 scenarios)
-2. `TestSupportsUnicode` - Unicode support detection (3 scenarios)
-3. `TestDetectTerminalCapabilities` - Full capability detection
-4. `TestTerminalCapabilities_ShouldSkipSplash` - Skip splash logic (3 scenarios)
-5. `TestColorModeString` - ColorMode enum string representation
-6. `TestEstimatePerformance` - Performance estimation
-
-**Key Validations:**
-- COLORTERM=truecolor → Truecolor mode
-- TERM=xterm-256color → Colors256 mode
-- NO_COLOR set → Colors16 mode
-- LANG with UTF-8 → Unicode supported
-- Terminal size < 60×20 → Skip splash
-- Performance hints work (fast/medium/slow)
-
-**Environment Variables Tested:**
-```bash
-COLORTERM=truecolor  # Forces truecolor mode
-TERM=xterm-256color  # 256-color support
-NO_COLOR=1           # Disable colors
-LANG=en_US.UTF-8     # Unicode support
-SSH_CONNECTION=...   # Remote session (slower)
-WT_SESSION=...       # Windows Terminal (fast)
-TERM_PROGRAM=iTerm.app  # iTerm2 (fast)
-```
-
-**Testing Pattern:**
-- Saves original environment variables
-- Sets test values
-- Runs detection
-- Restores originals
-- Prevents test pollution
-
----
-
-### fallback_test.go - Fallback Rendering Tests
-
-**Purpose:** Validate text-only splash and simplified modes
-
-**Tests:**
-1. `TestNewTextOnlySplash` - Text-only splash creation
-2. `TestTextOnlySplashRender` - Text-only rendering
-3. `TestCenterText` - Text centering algorithm (3 scenarios)
-4. `TestStripANSI` - ANSI code stripping (4 scenarios)
-5. `TestNewSimplifiedSplash` - Simplified splash creation
-6. `TestRenderSimplified` - Simplified rendering
-7. `TestShouldUseSimplifiedSplash` - Simplified mode detection
-8. `TestRenderStaticCloser` - Static closer screen
-9. `TestCenterTextWithANSI` - Centering colored text
-10. `TestTextOnlySplashSmallTerminal` - Small terminal handling
-
-**Key Validations:**
-- Text-only mode renders all essential elements
-- Centering works correctly with/without ANSI codes
-- ANSI stripping correctly removes escape sequences
-- Simplified mode activates for limited terminals
-- Static screens render without animation
-- Small terminals (<40×12) still work
-
-**Centering Algorithm:**
-```go
-// Calculate visible length (strip ANSI codes)
-visibleLen := len(stripANSI(text))
-
-// Calculate padding
-padding := (width - visibleLen) / 2
-
-// Center text
-return strings.Repeat(" ", padding) + text
-```
-
-**ANSI Stripping:**
-```go
-// Removes everything between \033[ and m
-// Example: "\033[38;2;255;0;0mRed\033[0m" → "Red"
-```
-
----
-
-## 🎯 Test Coverage By Module
-
-| Module | Coverage | Notes |
-|--------|----------|-------|
-| `ansi.go` | ~80% | Color system well-tested |
-| `config.go` | ~90% | Configuration fully tested |
-| `cortex.go` | ~60% | Core rendering tested, View() not tested |
-| `terminal.go` | ~70% | Detection logic tested |
-| `fallback.go` | ~75% | Text-only modes tested |
-| `splash.go` | ~30% | Main model partially tested (Bubble Tea hard to test) |
-| `bootsequence.go` | ~20% | Animation not fully tested |
-| `closer.go` | ~20% | Animation not fully tested |
-
-**High Priority for Additional Tests:**
-- [ ] `splash.go` - Bubble Tea Update() and Init() methods
-- [ ] `bootsequence.go` - Animation sequences
-- [ ] `closer.go` - Closer screen animation
-
-**Why Some Modules Have Low Coverage:**
-Bubble Tea models are difficult to unit test because they:
-- Require full TUI context
-- Use tea.Cmd (async messages)
-- Depend on terminal size events
-- Are better tested via integration/manual testing
-
----
-
-## ✅ Manual Testing Checklist
-
-### Basic Functionality
-- [ ] Splash shows on first run
-- [ ] Splash doesn't show on second run (default "first" frequency)
-- [ ] Pressing 'S' skips splash
-- [ ] Pressing ESC disables splash permanently
-- [ ] Splash auto-closes after 5 seconds
-
-### Command-Line Flags
-- [ ] `./rycode --splash` forces splash to show
-- [ ] `./rycode --no-splash` skips splash
-- [ ] `./rycode donut` shows infinite donut mode
-- [ ] Donut mode: Press 'Q' to quit
-- [ ] Donut mode: Press '?' to show math
-
-### Easter Eggs
-- [ ] Press '?' to show math equations
-- [ ] Press '?' again to return to splash
-- [ ] Konami code (↑↑↓↓←→←→BA) enables rainbow mode
-- [ ] Rainbow mode shows multiple colors
-- [ ] Hidden message "CLAUDE WAS HERE" appears in random frame
-
-### Configuration
-- [ ] Config file created at `~/.rycode/config.json`
-- [ ] Marker file created at `~/.rycode/.splash_shown`
-- [ ] ESC key updates config to `splash_enabled: false`
-- [ ] Editing config manually works
-- [ ] `PREFERS_REDUCED_MOTION=1` disables splash
-- [ ] `NO_COLOR=1` uses basic colors
-
-### Terminal Compatibility
-- [ ] Full mode works in 80×24+ terminals
-- [ ] Simplified mode appears in 60×20 terminals
-- [ ] Text-only mode appears in <80×24 terminals
-- [ ] Skip mode activates in <60×20 terminals
-- [ ] Truecolor works in modern terminals (iTerm2, Windows Terminal)
-- [ ] 256-color fallback works in older terminals
-- [ ] 16-color fallback works in basic terminals
-
-### Performance
-- [ ] Splash renders smoothly at 30 FPS on M1/M2/M3 Macs
-- [ ] Adaptive FPS drops to 15 FPS on slow systems
-- [ ] No visible lag or stuttering
-- [ ] CPU usage reasonable (~5-10% max)
-
----
-
-## 🐛 Known Issues and Limitations
-
-### Test Limitations
-1. **Bubble Tea models are hard to unit test**
-   - Update() method requires tea.Msg types
-   - Init() returns tea.Cmd (not easily testable)
-   - Better tested via integration tests
-
-2. **Terminal size detection**
-   - Tests can't easily mock `term.GetSize()`
-   - Relies on actual terminal state
-   - Some tests validate logic, not detection
-
-3. **Random frequency testing**
-   - `splash_frequency: "random"` has 10% chance
-   - Difficult to test reliably
-   - Test focuses on logic, not randomness
-
-### Platform-Specific Considerations
-
-**macOS:** ✅ Fully tested
-- Native development platform
-- Truecolor support
-- Unicode support
-- Performance excellent
-
-**Linux:** ⚠️ Partially tested
-- Should work on most distributions
-- Truecolor depends on terminal emulator
-- Unicode depends on locale settings
-- Performance good on modern systems
-
-**Windows:** ⚠️ Limited testing
-- Windows Terminal: Should work well
-- CMD.exe: Limited Unicode support
-- PowerShell: Should work
-- Performance TBD
-- **TODO:** Add Windows-specific tests
-
-**Raspberry Pi / ARM64:** 🔄 Not yet tested
-- Adaptive FPS should help
-- May need simplified mode
-- **TODO:** Test on low-end ARM systems
-
----
-
-## 📋 Testing Best Practices
-
-### Writing New Tests
-
-**1. Use table-driven tests:**
-```go
-func TestMyFeature(t *testing.T) {
-    tests := []struct {
-        name     string
-        input    string
-        expected string
-    }{
-        {"Case 1", "input1", "output1"},
-        {"Case 2", "input2", "output2"},
-    }
-
-    for _, tt := range tests {
-        t.Run(tt.name, func(t *testing.T) {
-            result := MyFunction(tt.input)
-            if result != tt.expected {
-                t.Errorf("Expected %s, got %s", tt.expected, result)
-            }
-        })
-    }
-}
-```
-
-**2. Isolate file system tests:**
-```go
-func TestConfigSave(t *testing.T) {
-    tmpDir := t.TempDir() // Auto-cleaned up
-    configPath := filepath.Join(tmpDir, "config.json")
-
-    // Override for testing
-    originalGetConfigPath := getConfigPath
-    getConfigPath = func() string { return configPath }
-    defer func() { getConfigPath = originalGetConfigPath }()
-
-    // Test save logic
-    config := DefaultConfig()
-    config.Save()
-
-    // Verify file exists
-    if _, err := os.Stat(configPath); os.IsNotExist(err) {
-        t.Error("Config file not created")
-    }
-}
-```
-
-**3. Test environment variable handling:**
-```go
-func TestEnvVars(t *testing.T) {
-    // Save originals
-    origVar := os.Getenv("MY_VAR")
-    defer os.Setenv("MY_VAR", origVar)
-
-    // Set test value
-    os.Setenv("MY_VAR", "test_value")
-
-    // Test
-    result := MyFunction()
-
-    // Verify
-    if result != "expected" {
-        t.Error("Environment variable not respected")
-    }
-}
-```
-
-**4. Test error conditions:**
-```go
-func TestErrorHandling(t *testing.T) {
-    // Test with invalid input
-    _, err := MyFunction("")
-    if err == nil {
-        t.Error("Expected error for empty input")
-    }
-
-    // Test with nil
-    _, err = MyFunctionWithNil(nil)
-    if err == nil {
-        t.Error("Expected error for nil input")
-    }
-}
-```
-
----
-
-## 🚀 Performance Benchmarks
-
-### Run Benchmarks
-```bash
-go test ./internal/splash -bench=. -benchmem
-```
-
-### Current Performance (M1 Max)
-- **Frame Rendering:** 0.318ms per frame (85× faster than 30 FPS target)
-- **Memory Usage:** ~2MB for splash state
-- **Startup Overhead:** <10ms
-
-### Performance Targets
-- ✅ 30 FPS (33ms per frame) - **Exceeded (0.318ms)**
-- ✅ <100ms startup time - **Met (<10ms)**
-- ✅ <10MB memory - **Met (~2MB)**
-
----
-
-## 📊 Test Metrics
-
-### Code Quality Metrics
-- **Test Coverage:** 54.2% ✅
-- **Tests Passing:** 31/31 (100%) ✅
-- **Cyclomatic Complexity:** Low (simple functions)
-- **Test Execution Time:** <1 second ✅
-
-### Reliability Metrics
-- **Crash Rate:** 0% (no panics in tests)
-- **Error Handling:** All errors tested
-- **Edge Cases Covered:**
-  - Empty inputs ✅
-  - Nil pointers ✅
-  - Small terminals ✅
-  - Large terminals ✅
-  - No config file ✅
-  - Corrupted config ✅
-
----
-
-## 🎓 Test Maintenance
-
-### When to Update Tests
-
-**1. Adding new features:**
-- Write tests first (TDD)
-- Ensure new code is covered
-- Update test documentation
-
-**2. Fixing bugs:**
-- Add regression test
-- Reproduce bug in test
-- Fix code
-- Verify test passes
-
-**3. Refactoring:**
-- Run tests frequently
-- Ensure no behavioral changes
-- Update tests if behavior intentionally changes
-
-**4. Changing configuration:**
-- Update config_test.go
-- Test all frequency modes
-- Test environment variable overrides
-
----
-
-## 📚 Resources
-
-**Testing Documentation:**
-- [Go Testing Package](https://pkg.go.dev/testing)
-- [Bubble Tea Testing Guide](https://github.com/charmbracelet/bubbletea#testing)
-- [Table-Driven Tests in Go](https://dave.cheney.net/2019/05/07/prefer-table-driven-tests)
-
-**Coverage Tools:**
-- [Go Cover Tool](https://blog.golang.org/cover)
-- [gocover.io](https://gocover.io/)
-
-**Relevant Files:**
-- Test files: `internal/splash/*_test.go`
-- Implementation: `internal/splash/*.go`
-- Usage docs: `SPLASH_USAGE.md`
-- Easter eggs: `EASTER_EGGS.md`
-
----
-
-## ✅ Testing Checklist for Week 4
-
-**Unit Tests:**
-- [x] Color system tests (5 tests) - ansi_test.go
-- [x] Configuration tests (5 tests) - config_test.go
-- [x] 3D rendering tests (5 tests) - cortex_test.go
-- [x] Terminal detection tests (9 tests) - terminal_test.go
-- [x] Fallback rendering tests (7 tests) - fallback_test.go
-
-**Coverage:**
-- [x] Achieve >50% coverage (current: 54.2%)
-- [x] Test all critical paths
-- [x] Test error conditions
-- [x] Test edge cases
-
-**Documentation:**
-- [x] Test documentation (this file)
-- [ ] Windows testing guide (TODO)
-- [ ] Performance benchmarks (TODO)
-- [ ] CI/CD integration (TODO)
-
-**Manual Testing:**
-- [ ] Test on macOS Intel
-- [ ] Test on Linux AMD64
-- [ ] Test on Linux ARM64 (Raspberry Pi)
-- [ ] Test on Windows AMD64
-- [ ] Test in various terminal emulators
-
----
-
-**🤖 Generated with [Claude Code](https://claude.com/claude-code)**
-
-*Last updated: Week 4 - Cross-platform testing phase*
diff --git a/packages/tui/SPLASH_USAGE.md b/packages/tui/SPLASH_USAGE.md
deleted file mode 100644
index d7468ea9..00000000
--- a/packages/tui/SPLASH_USAGE.md
+++ /dev/null
@@ -1,606 +0,0 @@
-# RyCode Splash Screen - Usage Guide
-
-> Complete guide to splash screen configuration, command-line options, and customization
-
----
-
-## 🚀 Quick Start
-
-**First launch:**
-```bash
-./rycode
-# Splash shows automatically on first run
-```
-
-**Skip the splash:**
-```bash
-./rycode --no-splash
-```
-
-**Force show splash:**
-```bash
-./rycode --splash
-```
-
-**Infinite donut mode:**
-```bash
-./rycode donut
-```
-
----
-
-## ⌨️ Keyboard Controls
-
-### During Splash
-
-| Key | Action |
-|-----|--------|
-| `S` | Skip splash (continue to TUI) |
-| `ESC` | Skip and disable forever |
-| `?` | Toggle math equations |
-| `Enter` / `Space` | Continue from closer screen |
-| `↑↑↓↓←→←→BA` | Konami code (rainbow mode) |
-
-### In Donut Mode
-
-| Key | Action |
-|-----|--------|
-| `Q` | Quit donut mode |
-| `?` | Toggle math equations |
-| `↑↑↓↓←→←→BA` | Konami code (rainbow mode) |
-
----
-
-## ⚙️ Configuration
-
-### Config File Location
-
-```
-~/.rycode/config.json
-```
-
-### Default Configuration
-
-```json
-{
-  "splash_enabled": true,
-  "splash_frequency": "first",
-  "reduced_motion": false,
-  "color_mode": "auto"
-}
-```
-
-### Configuration Options
-
-#### `splash_enabled`
-**Type:** `boolean`
-**Default:** `true`
-**Description:** Master switch for splash screen
-
-**Values:**
-- `true` - Splash can show (based on frequency)
-- `false` - Splash never shows
-
-**Example:**
-```json
-{
-  "splash_enabled": false
-}
-```
-
----
-
-#### `splash_frequency`
-**Type:** `string`
-**Default:** `"first"`
-**Description:** How often the splash should appear
-
-**Values:**
-- `"first"` - Only on first run (default)
-- `"always"` - Every launch
-- `"random"` - 10% chance on each launch
-- `"never"` - Never show (same as `splash_enabled: false`)
-
-**Examples:**
-```json
-// Show every time
-{
-  "splash_frequency": "always"
-}
-
-// Show randomly (10% chance)
-{
-  "splash_frequency": "random"
-}
-
-// Never show
-{
-  "splash_frequency": "never"
-}
-```
-
----
-
-#### `reduced_motion`
-**Type:** `boolean`
-**Default:** `false`
-**Description:** Accessibility setting to respect reduced motion preference
-
-**Values:**
-- `true` - Disable splash (accessibility)
-- `false` - Normal behavior
-
-**Auto-detection:**
-The splash respects the `PREFERS_REDUCED_MOTION` environment variable:
-```bash
-export PREFERS_REDUCED_MOTION=1
-./rycode  # Splash will not show
-```
-
-**Example:**
-```json
-{
-  "reduced_motion": true
-}
-```
-
----
-
-#### `color_mode`
-**Type:** `string`
-**Default:** `"auto"`
-**Description:** Terminal color support
-
-**Values:**
-- `"auto"` - Auto-detect terminal capabilities
-- `"truecolor"` - 16 million colors (best)
-- `"256"` - 256 colors
-- `"16"` - 16 colors (basic)
-
-**Auto-detection:**
-- Checks `$COLORTERM` for truecolor support
-- Falls back to `$TERM` for 256-color detection
-- Respects `$NO_COLOR` environment variable
-
-**Example:**
-```json
-{
-  "color_mode": "256"
-}
-```
-
----
-
-## 🖥️ Command-Line Flags
-
-### `--splash`
-**Force show the splash screen**
-
-Overrides all configuration settings and shows the splash even if disabled.
-
-**Usage:**
-```bash
-./rycode --splash
-```
-
-**Notes:**
-- Does not update the marker file
-- Can be used repeatedly
-- Useful for demonstrations
-
----
-
-### `--no-splash`
-**Skip the splash screen**
-
-Prevents splash from showing this launch only. Does not change configuration.
-
-**Usage:**
-```bash
-./rycode --no-splash
-```
-
-**Notes:**
-- Does not update config
-- Temporary for this launch only
-- Useful for automation/scripts
-
----
-
-## 🎨 Fallback Modes
-
-The splash automatically adapts to your terminal capabilities.
-
-### Full Mode (Default)
-**Requirements:**
-- Terminal ≥ 80×24
-- Truecolor or 256-color support
-- Unicode support
-
-**Features:**
-- Full 3D cortex animation
-- Cyan-magenta gradient
-- All easter eggs enabled
-- 30 FPS smooth animation
-
----
-
-### Simplified Mode
-**Triggers:**
-- Terminal < 80×24
-- Limited color support (16-color)
-- No unicode support
-
-**Features:**
-- Text-only splash
-- Simple model list
-- No animation
-- Centered layout
-
-**Example output:**
-```
-═══════════════════════════════════
-      RYCODE NEURAL CORTEX
-═══════════════════════════════════
-
-🧩 Claude  • Logical Reasoning
-⚙️  Gemini  • System Architecture
-💻 Codex   • Code Generation
-🔎 Qwen   • Research Pipeline
-🤖 Grok   • Humor & Chaos
-✅ GPT    • Language Core
-
-⚡ SIX MINDS. ONE COMMAND LINE.
-
-Press any key to continue...
-```
-
----
-
-### Skipped Mode
-**Triggers:**
-- Terminal < 60×20 (extremely small)
-- `splash_enabled: false` in config
-- `--no-splash` flag used
-- Pressed `ESC` on previous run
-
-**Behavior:**
-- No splash shown at all
-- Direct launch to TUI
-
----
-
-## 🔧 Advanced Usage
-
-### Disable Splash Permanently
-
-**Method 1: Press ESC during splash**
-```
-# Launch RyCode
-./rycode
-
-# When splash appears, press ESC
-# Config is automatically updated to disable splash
-```
-
-**Method 2: Edit config manually**
-```bash
-# Edit config file
-nano ~/.rycode/config.json
-
-# Set splash_enabled to false
-{
-  "splash_enabled": false
-}
-```
-
-**Method 3: Delete config**
-```bash
-# Remove config to reset to defaults
-rm ~/.rycode/config.json
-```
-
----
-
-### Reset First-Run Status
-
-To see the splash again as if it's the first run:
-
-```bash
-# Remove marker file
-rm ~/.rycode/.splash_shown
-
-# Next launch will show splash
-./rycode
-```
-
----
-
-### Force Specific Frequency
-
-```bash
-# Edit config
-nano ~/.rycode/config.json
-
-# Set frequency
-{
-  "splash_frequency": "always"  // Every launch
-  "splash_frequency": "random"  // 10% chance
-  "splash_frequency": "first"   // Only first run
-  "splash_frequency": "never"   // Never
-}
-```
-
----
-
-### Environment Variables
-
-The splash respects several environment variables:
-
-#### `PREFERS_REDUCED_MOTION`
-Accessibility setting to disable animations:
-```bash
-export PREFERS_REDUCED_MOTION=1
-./rycode  # Splash disabled
-```
-
-#### `NO_COLOR`
-Disable all colors:
-```bash
-export NO_COLOR=1
-./rycode  # Monochrome splash
-```
-
-#### `COLORTERM`
-Indicates truecolor support:
-```bash
-export COLORTERM=truecolor
-./rycode  # Uses 16M colors
-```
-
-#### `TERM`
-Terminal type indicator:
-```bash
-export TERM=xterm-256color
-./rycode  # Uses 256 colors
-```
-
----
-
-## 📊 Performance Tuning
-
-### Adaptive Frame Rate
-
-The splash automatically adjusts FPS based on system performance:
-
-**Fast systems (M1/M2/M3, modern Intel):**
-- 30 FPS (33ms per frame)
-- Smooth, fluid animation
-
-**Slower systems (Raspberry Pi, old laptops):**
-- Automatically drops to 15 FPS (66ms per frame)
-- Still smooth, uses less CPU
-
-**Detection:**
-- Monitors last 30 frames
-- If average frame time > 50ms, drops to 15 FPS
-- No user configuration needed
-
----
-
-### Manual Performance Control
-
-If splash is laggy on your system:
-
-**Option 1: Disable entirely**
-```json
-{
-  "splash_enabled": false
-}
-```
-
-**Option 2: Use --no-splash flag**
-```bash
-./rycode --no-splash
-```
-
-**Option 3: Reduce color depth**
-```json
-{
-  "color_mode": "16"
-}
-```
-
----
-
-## 🐛 Troubleshooting
-
-### Splash doesn't show on first run
-
-**Check:**
-1. Config file exists? `cat ~/.rycode/config.json`
-2. splash_enabled is true?
-3. Marker file exists? `ls ~/.rycode/.splash_shown`
-
-**Solution:**
-```bash
-# Reset first-run
-rm ~/.rycode/.splash_shown
-./rycode
-```
-
----
-
-### Splash shows every time (unwanted)
-
-**Check config:**
-```bash
-cat ~/.rycode/config.json
-```
-
-**Expected:**
-```json
-{
-  "splash_frequency": "first"  // Should be "first", not "always"
-}
-```
-
-**Fix:**
-```bash
-# Edit config
-nano ~/.rycode/config.json
-
-# Change to:
-{
-  "splash_frequency": "first"
-}
-```
-
----
-
-### Splash is laggy/slow
-
-**Solutions:**
-
-1. **Check terminal:** Some terminals are slower
-   - Try: iTerm2, Windows Terminal, Alacritty
-   - Avoid: xterm, Windows CMD
-
-2. **SSH connection?** Remote sessions are slower
-   - Splash will auto-adapt to 15 FPS
-   - Or use: `./rycode --no-splash`
-
-3. **Old hardware?** Adaptive FPS should help
-   - Wait ~1 second for detection
-   - Or disable: `"splash_enabled": false`
-
----
-
-### Colors look wrong
-
-**Check color mode:**
-```bash
-echo $COLORTERM
-echo $TERM
-```
-
-**Force specific mode:**
-```json
-{
-  "color_mode": "256"  // or "16" or "truecolor"
-}
-```
-
----
-
-### Splash shows but immediately disappears
-
-**This is normal if:**
-- You previously pressed ESC (disabled forever)
-- Config has `splash_enabled: false`
-- Terminal is too small (<60×20)
-
-**Check:**
-```bash
-cat ~/.rycode/config.json
-# Look for splash_enabled: false
-```
-
-**Fix:**
-```bash
-# Edit config
-nano ~/.rycode/config.json
-
-# Set:
-{
-  "splash_enabled": true
-}
-```
-
----
-
-## 📚 Examples
-
-### Example 1: Development Workflow
-```bash
-# First time setup
-./rycode              # Splash shows (first run)
-
-# Daily use
-./rycode              # No splash (already shown)
-
-# Occasional check
-./rycode --splash     # Force show splash
-```
-
----
-
-### Example 2: Presentation/Demo
-```bash
-# Always show splash for demos
-nano ~/.rycode/config.json
-
-{
-  "splash_frequency": "always"
-}
-
-# Or use flag:
-./rycode --splash
-```
-
----
-
-### Example 3: CI/CD Pipeline
-```bash
-# Never show splash in automation
-./rycode --no-splash
-
-# Or set config:
-{
-  "splash_enabled": false
-}
-```
-
----
-
-### Example 4: Accessibility
-```bash
-# Disable animations
-export PREFERS_REDUCED_MOTION=1
-./rycode
-
-# Or in config:
-{
-  "reduced_motion": true
-}
-```
-
----
-
-## 🎓 Best Practices
-
-1. **First run:** Let the splash show once (it's cool!)
-2. **Daily use:** Default "first" frequency is perfect
-3. **Presentations:** Use `--splash` flag or "always" frequency
-4. **Automation:** Use `--no-splash` flag
-5. **Accessibility:** Set `reduced_motion: true` if needed
-6. **Slow systems:** Adaptive FPS handles it automatically
-
----
-
-## 🤝 Contributing
-
-Found a bug? Want a new feature?
-
-- **Issues:** https://github.com/aaronmrosenthal/RyCode/issues
-- **Discussions:** https://github.com/aaronmrosenthal/RyCode/discussions
-- **PRs welcome!**
-
----
-
-**🤖 Built with ❤️ by Claude AI**
-
-*For more details, see:*
-- **Easter Eggs:** [EASTER_EGGS.md](EASTER_EGGS.md)
-- **Implementation Plan:** [SPLASH_IMPLEMENTATION_PLAN.md](SPLASH_IMPLEMENTATION_PLAN.md)
-- **Task Breakdown:** [SPLASH_TASKS.md](SPLASH_TASKS.md)
diff --git a/packages/tui/THEME_API_REFERENCE.md b/packages/tui/THEME_API_REFERENCE.md
deleted file mode 100644
index c7b55f21..00000000
--- a/packages/tui/THEME_API_REFERENCE.md
+++ /dev/null
@@ -1,1008 +0,0 @@
-# RyCode Theme API Reference
-
-**Complete API documentation for RyCode's dynamic theming system**
-
-Version: 1.0.0
-Last Updated: October 14, 2025
-
----
-
-## Table of Contents
-
-- [Package Overview](#package-overview)
-- [Core Types](#core-types)
-- [Theme Interface](#theme-interface)
-- [ProviderTheme](#providertheme)
-- [ThemeManager](#thememanager)
-- [Color Types](#color-types)
-- [Helper Functions](#helper-functions)
-- [Constants](#constants)
-- [Examples](#examples)
-
----
-
-## Package Overview
-
-```go
-import "github.com/aaronmrosenthal/rycode/internal/theme"
-```
-
-The `theme` package provides a dynamic theming system that allows hot-swapping between provider-specific themes with zero performance overhead.
-
-**Key Features**:
-- 🎨 4 built-in provider themes (Claude, Gemini, Codex, Qwen)
-- ⚡ 317ns theme switching (31,500x faster than target)
-- ♿ 100% WCAG AA compliant
-- 🔒 Thread-safe with RWMutex
-- 🎯 Zero memory allocations per switch
-
----
-
-## Core Types
-
-### Theme
-
-```go
-type Theme interface {
-    // Brand colors
-    Primary() compat.AdaptiveColor
-    Secondary() compat.AdaptiveColor
-    Accent() compat.AdaptiveColor
-
-    // Backgrounds
-    Background() compat.AdaptiveColor
-    BackgroundPanel() compat.AdaptiveColor
-    BackgroundElement() compat.AdaptiveColor
-
-    // Borders
-    BorderSubtle() compat.AdaptiveColor
-    Border() compat.AdaptiveColor
-    BorderActive() compat.AdaptiveColor
-
-    // Text
-    Text() compat.AdaptiveColor
-    TextMuted() compat.AdaptiveColor
-
-    // Status
-    Success() compat.AdaptiveColor
-    Error() compat.AdaptiveColor
-    Warning() compat.AdaptiveColor
-    Info() compat.AdaptiveColor
-
-    // Diff colors
-    DiffAdded() compat.AdaptiveColor
-    DiffRemoved() compat.AdaptiveColor
-    DiffContext() compat.AdaptiveColor
-    DiffHunkHeader() compat.AdaptiveColor
-    DiffHighlightAdded() compat.AdaptiveColor
-    DiffHighlightRemoved() compat.AdaptiveColor
-    DiffAddedBg() compat.AdaptiveColor
-    DiffRemovedBg() compat.AdaptiveColor
-    DiffContextBg() compat.AdaptiveColor
-    DiffLineNumber() compat.AdaptiveColor
-    DiffAddedLineNumberBg() compat.AdaptiveColor
-    DiffRemovedLineNumberBg() compat.AdaptiveColor
-
-    // Markdown
-    MarkdownText() compat.AdaptiveColor
-    MarkdownHeading() compat.AdaptiveColor
-    MarkdownLink() compat.AdaptiveColor
-    MarkdownLinkText() compat.AdaptiveColor
-    MarkdownCode() compat.AdaptiveColor
-    MarkdownBlockQuote() compat.AdaptiveColor
-    MarkdownEmph() compat.AdaptiveColor
-    MarkdownStrong() compat.AdaptiveColor
-    MarkdownHorizontalRule() compat.AdaptiveColor
-    MarkdownListItem() compat.AdaptiveColor
-    MarkdownListEnumeration() compat.AdaptiveColor
-    MarkdownImage() compat.AdaptiveColor
-    MarkdownImageText() compat.AdaptiveColor
-    MarkdownCodeBlock() compat.AdaptiveColor
-}
-```
-
-**Description**: Core interface that all themes must implement. Provides access to all colors used throughout the TUI.
-
-**Methods**: 50+ color accessors
-
-**Thread Safety**: Read-only interface, safe for concurrent access
-
----
-
-### BaseTheme
-
-```go
-type BaseTheme struct {
-    // Brand colors
-    PrimaryColor   compat.AdaptiveColor
-    SecondaryColor compat.AdaptiveColor
-    AccentColor    compat.AdaptiveColor
-
-    // Backgrounds
-    BackgroundColor        compat.AdaptiveColor
-    BackgroundPanelColor   compat.AdaptiveColor
-    BackgroundElementColor compat.AdaptiveColor
-
-    // Borders
-    BorderSubtleColor compat.AdaptiveColor
-    BorderColor       compat.AdaptiveColor
-    BorderActiveColor compat.AdaptiveColor
-
-    // Text
-    TextColor      compat.AdaptiveColor
-    TextMutedColor compat.AdaptiveColor
-
-    // Status colors
-    SuccessColor compat.AdaptiveColor
-    ErrorColor   compat.AdaptiveColor
-    WarningColor compat.AdaptiveColor
-    InfoColor    compat.AdaptiveColor
-
-    // Diff colors (12 colors)
-    DiffAddedColor            compat.AdaptiveColor
-    DiffRemovedColor          compat.AdaptiveColor
-    DiffContextColor          compat.AdaptiveColor
-    DiffHunkHeaderColor       compat.AdaptiveColor
-    DiffHighlightAddedColor   compat.AdaptiveColor
-    DiffHighlightRemovedColor compat.AdaptiveColor
-    DiffAddedBgColor          compat.AdaptiveColor
-    DiffRemovedBgColor        compat.AdaptiveColor
-    DiffContextBgColor        compat.AdaptiveColor
-    DiffLineNumberColor       compat.AdaptiveColor
-    DiffAddedLineNumberBgColor   compat.AdaptiveColor
-    DiffRemovedLineNumberBgColor compat.AdaptiveColor
-
-    // Markdown colors (14 colors)
-    MarkdownTextColor            compat.AdaptiveColor
-    MarkdownHeadingColor         compat.AdaptiveColor
-    MarkdownLinkColor            compat.AdaptiveColor
-    MarkdownLinkTextColor        compat.AdaptiveColor
-    MarkdownCodeColor            compat.AdaptiveColor
-    MarkdownBlockQuoteColor      compat.AdaptiveColor
-    MarkdownEmphColor            compat.AdaptiveColor
-    MarkdownStrongColor          compat.AdaptiveColor
-    MarkdownHorizontalRuleColor  compat.AdaptiveColor
-    MarkdownListItemColor        compat.AdaptiveColor
-    MarkdownListEnumerationColor compat.AdaptiveColor
-    MarkdownImageColor           compat.AdaptiveColor
-    MarkdownImageTextColor       compat.AdaptiveColor
-    MarkdownCodeBlockColor       compat.AdaptiveColor
-}
-```
-
-**Description**: Base implementation of Theme interface. Can be embedded in custom themes.
-
-**Fields**: 50+ color fields
-
-**Usage**: Embed in custom themes to get default implementations
-
-**Example**:
-```go
-type MyTheme struct {
-    theme.BaseTheme
-    // Add custom fields
-}
-```
-
----
-
-## ProviderTheme
-
-### Type Definition
-
-```go
-type ProviderTheme struct {
-    BaseTheme
-
-    ProviderID   string
-    ProviderName string
-
-    // Visual branding
-    LogoASCII       string
-    LoadingSpinner  string
-    WelcomeMessage  string
-    TypingIndicator TypingIndicatorStyle
-}
-```
-
-**Description**: Extended theme with provider-specific branding and UI elements.
-
-**Fields**:
-- `ProviderID` (string): Unique identifier ("claude", "gemini", "codex", "qwen")
-- `ProviderName` (string): Display name ("Claude", "Gemini", "Codex", "Qwen")
-- `LogoASCII` (string): ASCII art logo for welcome screen
-- `LoadingSpinner` (string): Provider-specific spinner characters
-- `WelcomeMessage` (string): Custom welcome message
-- `TypingIndicator` (TypingIndicatorStyle): Typing indicator configuration
-
-**Example**:
-```go
-claudeTheme := &theme.ProviderTheme{
-    ProviderID:   "claude",
-    ProviderName: "Claude",
-    BaseTheme: theme.BaseTheme{
-        PrimaryColor: adaptiveColor("#D4754C", "#D4754C"),
-        // ... other colors
-    },
-    LogoASCII:      "🤖 CLAUDE",
-    LoadingSpinner: "⣾⣽⣻⢿⡿⣟⣯⣷",
-    WelcomeMessage: "Welcome to Claude!",
-    TypingIndicator: theme.TypingIndicatorStyle{
-        Text:        "Thinking",
-        Animation:   "dots",
-        UseGradient: false,
-    },
-}
-```
-
----
-
-### TypingIndicatorStyle
-
-```go
-type TypingIndicatorStyle struct {
-    Text        string // "Thinking" or "Processing"
-    Animation   string // "dots", "gradient", "pulse", "wave"
-    UseGradient bool   // Use gradient animation
-}
-```
-
-**Description**: Configuration for provider-specific typing indicators.
-
-**Fields**:
-- `Text` (string): Base text to display ("Thinking", "Processing", etc.)
-- `Animation` (string): Animation style
-  - `"dots"`: Standard dot animation
-  - `"gradient"`: Gradient animation (Gemini)
-  - `"pulse"`: Pulsing animation
-  - `"wave"`: Wave animation
-- `UseGradient` (bool): Whether to use gradient colors
-
-**Example**:
-```go
-indicator := theme.TypingIndicatorStyle{
-    Text:        "Thinking",
-    Animation:   "dots",
-    UseGradient: false,
-}
-// Renders as: "Thinking..."
-```
-
----
-
-## ThemeManager
-
-### Public API
-
-#### CurrentTheme()
-
-```go
-func CurrentTheme() Theme
-```
-
-**Description**: Returns the currently active theme.
-
-**Returns**: Theme interface
-
-**Performance**: 6ns per call
-
-**Thread Safety**: Safe for concurrent access (uses RWMutex read lock)
-
-**Example**:
-```go
-t := theme.CurrentTheme()
-primaryColor := t.Primary()
-```
-
----
-
-#### SwitchToProvider()
-
-```go
-func SwitchToProvider(providerID string)
-```
-
-**Description**: Switches to a different provider theme.
-
-**Parameters**:
-- `providerID` (string): Provider identifier
-  - `"claude"` - Claude theme
-  - `"gemini"` - Gemini theme
-  - `"codex"` - Codex theme
-  - `"qwen"` - Qwen theme
-
-**Performance**: 317ns per switch
-
-**Thread Safety**: Safe for concurrent access (uses RWMutex write lock)
-
-**Side Effects**: Updates the global current theme
-
-**Example**:
-```go
-theme.SwitchToProvider("claude")
-// Theme is now Claude's warm copper aesthetic
-
-theme.SwitchToProvider("gemini")
-// Theme is now Gemini's blue-pink gradient aesthetic
-```
-
----
-
-## Theme Interface
-
-### Brand Colors
-
-#### Primary()
-
-```go
-Primary() compat.AdaptiveColor
-```
-
-**Description**: Primary brand color (used for borders, highlights, buttons).
-
-**Returns**: AdaptiveColor with light and dark variants
-
-**WCAG AA Compliance**: Tested at 3.0:1+ contrast against backgrounds
-
-**Examples**:
-- Claude: `#D4754C` (copper orange)
-- Gemini: `#4285F4` (Google blue)
-- Codex: `#10A37F` (OpenAI teal)
-- Qwen: `#FF6A00` (Alibaba orange)
-
-**Usage**:
-```go
-t := theme.CurrentTheme()
-borderStyle := lipgloss.NewStyle().BorderForeground(t.Primary())
-```
-
----
-
-#### Secondary()
-
-```go
-Secondary() compat.AdaptiveColor
-```
-
-**Description**: Secondary brand color (darker variant of primary).
-
-**Returns**: AdaptiveColor
-
-**Usage**: Subtle accents, secondary UI elements
-
-**Examples**:
-- Claude: `#B85C3C` (darker copper)
-- Gemini: `#3367D6` (darker blue)
-- Codex: `#0D8569` (darker teal)
-- Qwen: `#E55D00` (darker orange)
-
----
-
-#### Accent()
-
-```go
-Accent() compat.AdaptiveColor
-```
-
-**Description**: Accent color (brighter variant of primary).
-
-**Returns**: AdaptiveColor
-
-**Usage**: Hover states, focus indicators, call-to-action elements
-
-**Examples**:
-- Claude: `#F08C5C` (lighter warm orange)
-- Gemini: `#EA4335` (Google red/pink)
-- Codex: `#1FC2AA` (lighter teal)
-- Qwen: `#FF8533` (lighter orange)
-
----
-
-### Background Colors
-
-#### Background()
-
-```go
-Background() compat.AdaptiveColor
-```
-
-**Description**: Main background color for the entire TUI.
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: Tested at 4.5:1+ contrast with Text()
-
-**Examples**:
-- Claude: `#1A1816` (warm dark brown)
-- Gemini: `#0D0D0D` (pure black)
-- Codex: `#0E0E0E` (almost black)
-- Qwen: `#161410` (warm black)
-
----
-
-#### BackgroundPanel()
-
-```go
-BackgroundPanel() compat.AdaptiveColor
-```
-
-**Description**: Background color for panels and cards (slightly lighter than main background).
-
-**Returns**: AdaptiveColor
-
-**Usage**: Message bubbles, code blocks, panels
-
-**Examples**:
-- Claude: `#2C2622` (lighter warm brown)
-- Gemini: `#1A1A1A` (dark gray)
-- Codex: `#1C1C1C` (dark gray)
-- Qwen: `#221E18` (warm dark gray)
-
----
-
-#### BackgroundElement()
-
-```go
-BackgroundElement() compat.AdaptiveColor
-```
-
-**Description**: Background for interactive elements (buttons, inputs).
-
-**Returns**: AdaptiveColor
-
-**Usage**: Input fields, buttons, interactive components
-
----
-
-### Border Colors
-
-#### BorderSubtle()
-
-```go
-BorderSubtle() compat.AdaptiveColor
-```
-
-**Description**: Subtle border color for inactive/secondary borders.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Dividers, inactive borders, decorative lines
-
----
-
-#### Border()
-
-```go
-Border() compat.AdaptiveColor
-```
-
-**Description**: Standard border color for active elements.
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: Tested at 3.0:1+ contrast against backgrounds
-
-**Usage**: Chat borders, panel borders, active UI elements
-
----
-
-#### BorderActive()
-
-```go
-BorderActive() compat.AdaptiveColor
-```
-
-**Description**: Border color for focused/active elements.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Focused input, active selection, hover states
-
----
-
-### Text Colors
-
-#### Text()
-
-```go
-Text() compat.AdaptiveColor
-```
-
-**Description**: Primary text color for all body text.
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 12-16:1 contrast ratio (2-3x AAA requirement)
-
-**Examples**:
-- Claude: `#E8D5C4` (warm cream)
-- Gemini: `#E8EAED` (light gray)
-- Codex: `#ECECEC` (off-white)
-- Qwen: `#F0E8DC` (warm off-white)
-
-**Usage**:
-```go
-t := theme.CurrentTheme()
-textStyle := lipgloss.NewStyle().Foreground(t.Text())
-```
-
----
-
-#### TextMuted()
-
-```go
-TextMuted() compat.AdaptiveColor
-```
-
-**Description**: Muted text color for secondary/less important text.
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 4.5:1+ contrast ratio
-
-**Usage**: Timestamps, metadata, helper text, placeholders
-
-**Examples**:
-- Claude: `#9C8373` (muted warm gray)
-- Gemini: `#9AA0A6` (medium gray)
-- Codex: `#8E8E8E` (medium gray)
-- Qwen: `#A0947C` (warm gray)
-
----
-
-### Status Colors
-
-#### Success()
-
-```go
-Success() compat.AdaptiveColor
-```
-
-**Description**: Success state color (green).
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 3.0:1+ contrast for UI elements
-
-**Usage**: Success messages, completed tasks, positive indicators
-
-**Examples**:
-- Claude: `#6FA86F` (muted green)
-- Gemini: `#34A853` (Google green)
-- Codex: `#10A37F` (uses primary teal)
-- Qwen: `#52C41A` (Chinese green)
-
----
-
-#### Error()
-
-```go
-Error() compat.AdaptiveColor
-```
-
-**Description**: Error state color (red).
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 3.0:1+ contrast for UI elements
-
-**Usage**: Error messages, failed operations, destructive actions
-
-**Examples**:
-- Claude: `#D47C7C` (warm red)
-- Gemini: `#EA4335` (Google red)
-- Codex: `#EF4444` (clean red)
-- Qwen: `#FF4D4F` (Chinese red)
-
----
-
-#### Warning()
-
-```go
-Warning() compat.AdaptiveColor
-```
-
-**Description**: Warning state color (yellow/amber).
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 3.0:1+ contrast (often exceeds AAA at 7.0:1+)
-
-**Usage**: Warning messages, caution indicators, pending states
-
-**Examples**:
-- Claude: `#E8A968` (warm amber)
-- Gemini: `#FBBC04` (Google yellow)
-- Codex: `#F59E0B` (amber)
-- Qwen: `#FAAD14` (Chinese gold)
-
----
-
-#### Info()
-
-```go
-Info() compat.AdaptiveColor
-```
-
-**Description**: Info state color (blue or primary).
-
-**Returns**: AdaptiveColor
-
-**Usage**: Info messages, help text, tips
-
-**Examples**:
-- Claude: `#D4754C` (uses primary)
-- Gemini: `#4285F4` (uses primary blue)
-- Codex: `#3B82F6` (blue)
-- Qwen: `#1890FF` (Chinese blue)
-
----
-
-### Diff Colors
-
-#### DiffAdded()
-
-```go
-DiffAdded() compat.AdaptiveColor
-```
-
-**Description**: Text color for added lines in diffs.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Git diffs, code changes, added content
-
----
-
-#### DiffRemoved()
-
-```go
-DiffRemoved() compat.AdaptiveColor
-```
-
-**Description**: Text color for removed lines in diffs.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Git diffs, code changes, removed content
-
----
-
-#### DiffContext()
-
-```go
-DiffContext() compat.AdaptiveColor
-```
-
-**Description**: Text color for unchanged context lines in diffs.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Git diffs, surrounding context
-
----
-
-#### DiffAddedBg()
-
-```go
-DiffAddedBg() compat.AdaptiveColor
-```
-
-**Description**: Background color for added lines in diffs.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Highlight background for added content
-
----
-
-#### DiffRemovedBg()
-
-```go
-DiffRemovedBg() compat.AdaptiveColor
-```
-
-**Description**: Background color for removed lines in diffs.
-
-**Returns**: AdaptiveColor
-
-**Usage**: Highlight background for removed content
-
----
-
-### Markdown Colors
-
-#### MarkdownHeading()
-
-```go
-MarkdownHeading() compat.AdaptiveColor
-```
-
-**Description**: Color for markdown headings (H1-H6).
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 4.5:1+ contrast
-
-**Usage**: Rendered markdown headings
-
----
-
-#### MarkdownLink()
-
-```go
-MarkdownLink() compat.AdaptiveColor
-```
-
-**Description**: Color for markdown links.
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: 4.5:1+ contrast
-
-**Usage**: Clickable links in markdown
-
----
-
-#### MarkdownCode()
-
-```go
-MarkdownCode() compat.AdaptiveColor
-```
-
-**Description**: Color for inline code and code blocks.
-
-**Returns**: AdaptiveColor
-
-**WCAG AA Compliance**: Often exceeds AAA (7.0:1+)
-
-**Usage**: `inline code` and ```code blocks```
-
----
-
-## Color Types
-
-### AdaptiveColor
-
-```go
-type AdaptiveColor struct {
-    Light color.Color
-    Dark  color.Color
-}
-```
-
-**Description**: Color that adapts to light/dark mode.
-
-**Package**: `github.com/charmbracelet/lipgloss/v2/compat`
-
-**Fields**:
-- `Light` (color.Color): Color for light mode
-- `Dark` (color.Color): Color for dark mode
-
-**Note**: RyCode uses dark mode, so only `Dark` variant is used.
-
-**Usage**:
-```go
-primaryColor := t.Primary()
-darkColor := primaryColor.Dark
-
-// Get RGBA values
-r, g, b, a := darkColor.RGBA()
-```
-
----
-
-## Helper Functions
-
-### adaptiveColor()
-
-```go
-func adaptiveColor(darkHex, lightHex string) compat.AdaptiveColor
-```
-
-**Description**: Creates an AdaptiveColor from hex strings.
-
-**Parameters**:
-- `darkHex` (string): Hex color for dark mode (e.g., "#D4754C")
-- `lightHex` (string): Hex color for light mode (e.g., "#D4754C")
-
-**Returns**: AdaptiveColor
-
-**Example**:
-```go
-copper := adaptiveColor("#D4754C", "#D4754C")
-```
-
----
-
-## Constants
-
-### Built-in Provider IDs
-
-```go
-const (
-    ProviderClaude = "claude"
-    ProviderGemini = "gemini"
-    ProviderCodex  = "codex"
-    ProviderQwen   = "qwen"
-)
-```
-
-**Description**: Standard provider identifiers.
-
-**Usage**:
-```go
-theme.SwitchToProvider(theme.ProviderClaude)
-```
-
----
-
-## Examples
-
-### Basic Theme Usage
-
-```go
-package main
-
-import (
-    "github.com/aaronmrosenthal/rycode/internal/theme"
-    "github.com/charmbracelet/lipgloss/v2"
-)
-
-func main() {
-    // Get current theme
-    t := theme.CurrentTheme()
-
-    // Create styled text
-    title := lipgloss.NewStyle().
-        Foreground(t.Primary()).
-        Bold(true).
-        Render("Hello RyCode!")
-
-    // Create bordered box
-    box := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Border()).
-        Background(t.BackgroundPanel()).
-        Foreground(t.Text()).
-        Padding(1).
-        Render("Themed content")
-
-    fmt.Println(title)
-    fmt.Println(box)
-}
-```
-
-### Theme Switching
-
-```go
-package main
-
-import (
-    "fmt"
-    "github.com/aaronmrosenthal/rycode/internal/theme"
-)
-
-func main() {
-    // Start with Claude theme
-    theme.SwitchToProvider("claude")
-    fmt.Println("Current:", getCurrentProviderName())
-
-    // Switch to Gemini
-    theme.SwitchToProvider("gemini")
-    fmt.Println("Current:", getCurrentProviderName())
-
-    // Switch to Codex
-    theme.SwitchToProvider("codex")
-    fmt.Println("Current:", getCurrentProviderName())
-}
-
-func getCurrentProviderName() string {
-    t := theme.CurrentTheme()
-    if pt, ok := t.(*theme.ProviderTheme); ok {
-        return pt.ProviderName
-    }
-    return "Unknown"
-}
-```
-
-### Custom Component
-
-```go
-type StatusBadge struct {
-    status string
-}
-
-func (b *StatusBadge) Render() string {
-    t := theme.CurrentTheme()
-
-    var color compat.AdaptiveColor
-    switch b.status {
-    case "success":
-        color = t.Success()
-    case "error":
-        color = t.Error()
-    case "warning":
-        color = t.Warning()
-    default:
-        color = t.Info()
-    }
-
-    style := lipgloss.NewStyle().
-        Background(color).
-        Foreground(t.Background()).
-        Padding(0, 1).
-        Bold(true)
-
-    return style.Render(strings.ToUpper(b.status))
-}
-```
-
----
-
-## Performance Characteristics
-
-| Operation | Time | Notes |
-|-----------|------|-------|
-| `CurrentTheme()` | 6ns | RWMutex read lock |
-| `SwitchToProvider()` | 317ns | Pointer swap + write lock |
-| Color access (e.g., `Primary()`) | 7ns | Direct field access |
-| Memory per switch | 0 bytes | No allocations |
-
-**Benchmark Results** (from `test_theme_performance.go`):
-- ✅ Theme switching: 31,500x faster than 10ms target
-- ✅ Imperceptible at 60fps (16.67ms frame time)
-- ✅ Could perform 52,524 switches per frame
-- ✅ 158x faster than VS Code theme switching
-
----
-
-## Thread Safety
-
-All public APIs are thread-safe:
-
-```go
-// Safe from multiple goroutines
-go theme.SwitchToProvider("claude")
-go theme.SwitchToProvider("gemini")
-
-// Safe concurrent reads
-for i := 0; i < 1000; i++ {
-    go func() {
-        t := theme.CurrentTheme()
-        _ = t.Primary()
-    }()
-}
-```
-
-**Implementation**: Uses `sync.RWMutex`
-- Read operations (`CurrentTheme()`) acquire read lock
-- Write operations (`SwitchToProvider()`) acquire write lock
-- Multiple readers can access concurrently
-- Writers block all other access
-
----
-
-## Version History
-
-### v1.0.0 (October 14, 2025)
-- Initial release
-- 4 built-in provider themes
-- Full Theme interface (50+ colors)
-- Sub-microsecond theme switching
-- 100% WCAG AA compliance
-- Thread-safe operations
-
----
-
-## See Also
-
-- [THEME_CUSTOMIZATION_GUIDE.md](./THEME_CUSTOMIZATION_GUIDE.md) - How to create and use themes
-- [DYNAMIC_THEMING_SPEC.md](./DYNAMIC_THEMING_SPEC.md) - Original specification
-- [PHASE_3_ACCESSIBILITY_COMPLETE.md](./PHASE_3_ACCESSIBILITY_COMPLETE.md) - Accessibility audit
-- [PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md](./PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md) - Color verification
-
----
-
-**Questions or Issues?**
-GitHub: https://github.com/aaronmrosenthal/RyCode/issues
diff --git a/packages/tui/THEME_CUSTOMIZATION_GUIDE.md b/packages/tui/THEME_CUSTOMIZATION_GUIDE.md
deleted file mode 100644
index 71b46b59..00000000
--- a/packages/tui/THEME_CUSTOMIZATION_GUIDE.md
+++ /dev/null
@@ -1,768 +0,0 @@
-# RyCode Theme Customization Guide
-
-**For Developers Building with RyCode's Theming System**
-
----
-
-## Overview
-
-RyCode features a dynamic provider theming system that automatically switches UI aesthetics based on the active AI provider. This guide shows you how to:
-
-1. Work with existing themes
-2. Create custom provider themes
-3. Extend themes with new UI elements
-4. Test theme changes
-
----
-
-## Table of Contents
-
-- [Quick Start](#quick-start)
-- [Theme Architecture](#theme-architecture)
-- [Using Themes in Components](#using-themes-in-components)
-- [Creating Custom Themes](#creating-custom-themes)
-- [Theme API Reference](#theme-api-reference)
-- [Best Practices](#best-practices)
-- [Testing Themes](#testing-themes)
-
----
-
-## Quick Start
-
-### Using the Current Theme
-
-```go
-package mycomponent
-
-import (
-    "github.com/aaronmrosenthal/rycode/internal/theme"
-    "github.com/charmbracelet/lipgloss/v2"
-)
-
-func RenderBox() string {
-    // Get current theme
-    t := theme.CurrentTheme()
-
-    // Use theme colors
-    style := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Primary()).
-        Background(t.Background()).
-        Foreground(t.Text())
-
-    return style.Render("Hello from themed component!")
-}
-```
-
-### Switching Themes
-
-```go
-// Switch to Claude theme
-theme.SwitchToProvider("claude")
-
-// Switch to Gemini theme
-theme.SwitchToProvider("gemini")
-
-// Switch to Codex theme
-theme.SwitchToProvider("codex")
-
-// Switch to Qwen theme
-theme.SwitchToProvider("qwen")
-```
-
----
-
-## Theme Architecture
-
-### Core Components
-
-```
-packages/tui/internal/theme/
-├── theme.go              # Theme interface
-├── base_theme.go         # BaseTheme implementation
-├── provider_themes.go    # Provider-specific themes
-└── manager.go            # ThemeManager (hot-swapping)
-```
-
-### Theme Interface
-
-Every theme implements this interface:
-
-```go
-type Theme interface {
-    // Core colors
-    Primary() compat.AdaptiveColor
-    Secondary() compat.AdaptiveColor
-    Accent() compat.AdaptiveColor
-
-    // Backgrounds
-    Background() compat.AdaptiveColor
-    BackgroundPanel() compat.AdaptiveColor
-    BackgroundElement() compat.AdaptiveColor
-
-    // Borders
-    BorderSubtle() compat.AdaptiveColor
-    Border() compat.AdaptiveColor
-    BorderActive() compat.AdaptiveColor
-
-    // Text
-    Text() compat.AdaptiveColor
-    TextMuted() compat.AdaptiveColor
-
-    // Status colors
-    Success() compat.AdaptiveColor
-    Error() compat.AdaptiveColor
-    Warning() compat.AdaptiveColor
-    Info() compat.AdaptiveColor
-
-    // Markdown colors
-    MarkdownHeading() compat.AdaptiveColor
-    MarkdownLink() compat.AdaptiveColor
-    MarkdownCode() compat.AdaptiveColor
-    // ... and more
-}
-```
-
-### ProviderTheme Structure
-
-Provider themes extend BaseTheme with custom branding:
-
-```go
-type ProviderTheme struct {
-    BaseTheme
-
-    ProviderID   string
-    ProviderName string
-
-    // Visual branding
-    LogoASCII       string
-    LoadingSpinner  string
-    WelcomeMessage  string
-    TypingIndicator TypingIndicatorStyle
-}
-
-type TypingIndicatorStyle struct {
-    Text        string // "Thinking..." or "Processing..."
-    Animation   string // "dots", "gradient", "pulse", "wave"
-    UseGradient bool
-}
-```
-
----
-
-## Using Themes in Components
-
-### Basic Pattern
-
-```go
-func (m *Model) View() string {
-    // 1. Get current theme
-    t := theme.CurrentTheme()
-
-    // 2. Create styled elements
-    titleStyle := lipgloss.NewStyle().
-        Foreground(t.Primary()).
-        Bold(true)
-
-    borderStyle := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Border()).
-        Padding(1)
-
-    // 3. Render with theme colors
-    title := titleStyle.Render("My Component")
-    content := borderStyle.Render(m.content)
-
-    return lipgloss.JoinVertical(lipgloss.Left, title, content)
-}
-```
-
-### Working with AdaptiveColor
-
-Theme colors are `compat.AdaptiveColor` which have light and dark variants:
-
-```go
-t := theme.CurrentTheme()
-primaryColor := t.Primary()
-
-// Use directly with lipgloss
-style := lipgloss.NewStyle().Foreground(primaryColor)
-
-// Access dark variant (RyCode is a dark TUI)
-darkColor := primaryColor.Dark
-
-// Get RGB values
-r, g, b, a := darkColor.RGBA()
-```
-
-### Provider-Specific Features
-
-```go
-func RenderWelcome() string {
-    t := theme.CurrentTheme()
-
-    // Type assertion to access provider-specific features
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        // Provider-specific welcome message
-        return providerTheme.WelcomeMessage
-    }
-
-    // Fallback for non-provider themes
-    return "Welcome to RyCode!"
-}
-```
-
-### Spinner Example
-
-```go
-func GetSpinnerFrames() []string {
-    t := theme.CurrentTheme()
-
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        // Provider-specific spinner
-        spinnerStr := providerTheme.LoadingSpinner
-        if spinnerStr != "" {
-            frames := []string{}
-            for _, r := range spinnerStr {
-                frames = append(frames, string(r))
-            }
-            return frames
-        }
-    }
-
-    // Default spinner
-    return []string{"⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"}
-}
-```
-
----
-
-## Creating Custom Themes
-
-### Step 1: Define Your Theme
-
-Create a new theme in `internal/theme/provider_themes.go`:
-
-```go
-func NewMyCustomTheme() *ProviderTheme {
-    return &ProviderTheme{
-        ProviderID:   "custom",
-        ProviderName: "My Custom Provider",
-
-        BaseTheme: BaseTheme{
-            // Primary colors
-            PrimaryColor:   adaptiveColor("#FF00FF", "#FF00FF"),
-            SecondaryColor: adaptiveColor("#CC00CC", "#CC00CC"),
-            AccentColor:    adaptiveColor("#FF66FF", "#FF66FF"),
-
-            // Backgrounds
-            BackgroundColor:        adaptiveColor("#0A0A0A", "#FFFFFF"),
-            BackgroundPanelColor:   adaptiveColor("#151515", "#F5F5F5"),
-            BackgroundElementColor: adaptiveColor("#202020", "#EEEEEE"),
-
-            // Borders
-            BorderSubtleColor: adaptiveColor("#2A2A2A", "#DDDDDD"),
-            BorderColor:       adaptiveColor("#FF00FF", "#FF00FF"),
-            BorderActiveColor: adaptiveColor("#FF66FF", "#CC00CC"),
-
-            // Text
-            TextColor:      adaptiveColor("#EEEEEE", "#111111"),
-            TextMutedColor: adaptiveColor("#888888", "#666666"),
-
-            // Status colors
-            SuccessColor: adaptiveColor("#00FF00", "#00AA00"),
-            ErrorColor:   adaptiveColor("#FF0000", "#CC0000"),
-            WarningColor: adaptiveColor("#FFAA00", "#CC8800"),
-            InfoColor:    adaptiveColor("#00AAFF", "#0088CC"),
-
-            // Markdown colors
-            MarkdownHeadingColor: adaptiveColor("#FF66FF", "#CC00CC"),
-            MarkdownLinkColor:    adaptiveColor("#FF00FF", "#CC00CC"),
-            MarkdownCodeColor:    adaptiveColor("#FFAA00", "#CC8800"),
-            // ... add all other colors
-        },
-
-        // Branding
-        LogoASCII:      "🎨 CUSTOM",
-        LoadingSpinner: "⣾⣽⣻⢿⡿⣟⣯⣷",
-        WelcomeMessage: "Welcome to My Custom Theme!",
-        TypingIndicator: TypingIndicatorStyle{
-            Text:        "Processing",
-            Animation:   "pulse",
-            UseGradient: false,
-        },
-    }
-}
-```
-
-### Step 2: Register Your Theme
-
-In `internal/theme/manager.go`:
-
-```go
-func init() {
-    themes = map[string]*ProviderTheme{
-        "claude": NewClaudeTheme(),
-        "gemini": NewGeminiTheme(),
-        "codex":  NewCodexTheme(),
-        "qwen":   NewQwenTheme(),
-        "custom": NewMyCustomTheme(), // Add your theme
-    }
-}
-```
-
-### Step 3: Use Your Theme
-
-```go
-theme.SwitchToProvider("custom")
-```
-
----
-
-## Theme API Reference
-
-### Core Methods
-
-#### `theme.CurrentTheme() Theme`
-Returns the currently active theme.
-
-```go
-t := theme.CurrentTheme()
-primaryColor := t.Primary()
-```
-
-#### `theme.SwitchToProvider(providerID string)`
-Switches to a different provider theme.
-
-```go
-theme.SwitchToProvider("claude")
-```
-
-**Performance**: 317ns per switch (31,500x faster than 10ms target)
-
-### Theme Colors
-
-All color methods return `compat.AdaptiveColor`:
-
-```go
-type Theme interface {
-    // Brand colors
-    Primary() compat.AdaptiveColor
-    Secondary() compat.AdaptiveColor
-    Accent() compat.AdaptiveColor
-
-    // Backgrounds
-    Background() compat.AdaptiveColor
-    BackgroundPanel() compat.AdaptiveColor
-    BackgroundElement() compat.AdaptiveColor
-
-    // Borders
-    BorderSubtle() compat.AdaptiveColor
-    Border() compat.AdaptiveColor
-    BorderActive() compat.AdaptiveColor
-
-    // Text
-    Text() compat.AdaptiveColor
-    TextMuted() compat.AdaptiveColor
-
-    // Status
-    Success() compat.AdaptiveColor
-    Error() compat.AdaptiveColor
-    Warning() compat.AdaptiveColor
-    Info() compat.AdaptiveColor
-
-    // Diff colors
-    DiffAdded() compat.AdaptiveColor
-    DiffRemoved() compat.AdaptiveColor
-    DiffContext() compat.AdaptiveColor
-    DiffHunkHeader() compat.AdaptiveColor
-    DiffHighlightAdded() compat.AdaptiveColor
-    DiffHighlightRemoved() compat.AdaptiveColor
-    DiffAddedBg() compat.AdaptiveColor
-    DiffRemovedBg() compat.AdaptiveColor
-    DiffContextBg() compat.AdaptiveColor
-    DiffLineNumber() compat.AdaptiveColor
-    DiffAddedLineNumberBg() compat.AdaptiveColor
-    DiffRemovedLineNumberBg() compat.AdaptiveColor
-
-    // Markdown
-    MarkdownText() compat.AdaptiveColor
-    MarkdownHeading() compat.AdaptiveColor
-    MarkdownLink() compat.AdaptiveColor
-    MarkdownLinkText() compat.AdaptiveColor
-    MarkdownCode() compat.AdaptiveColor
-    MarkdownBlockQuote() compat.AdaptiveColor
-    MarkdownEmph() compat.AdaptiveColor
-    MarkdownStrong() compat.AdaptiveColor
-    MarkdownHorizontalRule() compat.AdaptiveColor
-    MarkdownListItem() compat.AdaptiveColor
-    MarkdownListEnumeration() compat.AdaptiveColor
-    MarkdownImage() compat.AdaptiveColor
-    MarkdownImageText() compat.AdaptiveColor
-    MarkdownCodeBlock() compat.AdaptiveColor
-}
-```
-
----
-
-## Best Practices
-
-### 1. Always Use CurrentTheme()
-
-**Don't cache themes** - always call `CurrentTheme()` when rendering:
-
-```go
-// ✅ GOOD - Always get current theme
-func (m *Model) View() string {
-    t := theme.CurrentTheme()
-    return lipgloss.NewStyle().Foreground(t.Primary()).Render(m.text)
-}
-
-// ❌ BAD - Cached theme won't update
-func (m *Model) Init() tea.Cmd {
-    m.theme = theme.CurrentTheme() // This won't update on theme switch!
-    return nil
-}
-```
-
-**Why**: Theme retrieval is 6ns (extremely fast), and caching prevents live theme updates.
-
-### 2. Use Type Assertions for Provider Features
-
-```go
-func RenderProviderSpecific() string {
-    t := theme.CurrentTheme()
-
-    // Check if it's a provider theme
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        // Use provider-specific features
-        return providerTheme.LogoASCII
-    }
-
-    // Graceful fallback
-    return "RyCode"
-}
-```
-
-### 3. Follow WCAG AA Standards
-
-All theme colors should meet WCAG 2.1 AA contrast requirements:
-
-- **Normal text**: 4.5:1 minimum
-- **Large text/UI elements**: 3.0:1 minimum
-
-Run the accessibility audit:
-
-```bash
-go run test_theme_accessibility.go
-```
-
-### 4. Test Color Accuracy
-
-Verify your theme colors match specifications:
-
-```bash
-go run test_theme_visual_verification.go
-```
-
-### 5. Consider All States
-
-When creating themes, define colors for all states:
-
-- Normal
-- Hover
-- Active/focused
-- Disabled
-- Error
-- Success
-
-### 6. Maintain Consistency
-
-Within a theme, maintain visual consistency:
-
-- Similar hue for related elements
-- Consistent contrast ratios
-- Harmonious color relationships
-
----
-
-## Testing Themes
-
-### Accessibility Testing
-
-```bash
-cd packages/tui
-go run test_theme_accessibility.go
-```
-
-**Expected output**:
-```
-=== Theme Accessibility Audit ===
-WCAG 2.1 Contrast Requirements:
-  AA Normal Text: 4.5:1
-  AA Large Text:  3.0:1
-  AAA Normal Text: 7.0:1
-
-=== claude Theme ===
-  ✓ Text on Background              12.43:1 [AAA] PASS
-  ✓ Muted Text on Background         4.98:1 [AA]  PASS
-  ...
-
-✅ All themes pass WCAG AA accessibility standards!
-```
-
-### Color Verification
-
-```bash
-go run test_theme_visual_verification.go
-```
-
-**Expected output**:
-```
-=== Theme Visual Verification ===
-Verifying all theme colors match specifications...
-
-[claude Theme]
-  Summary: 14 passed, 0 failed
-
-✅ All 56 color tests passed!
-```
-
-### Performance Testing
-
-```bash
-go run test_theme_performance.go
-```
-
-**Expected output**:
-```
-=== Theme Performance Benchmark ===
-
-[Test 1] Theme Switching Performance
-  ✓ PASS Average per switch: 317ns (target: <10ms)
-
-✅ All performance tests passed!
-```
-
-### Manual Testing
-
-```bash
-# Build and run RyCode
-go build -o rycode ./cmd/rycode
-./rycode
-
-# Press Tab to cycle through providers
-# Verify theme switches correctly
-# Check for visual artifacts
-# Test all UI components
-```
-
----
-
-## Examples
-
-### Custom Status Banner
-
-```go
-func RenderStatusBanner(status string) string {
-    t := theme.CurrentTheme()
-
-    var statusColor compat.AdaptiveColor
-    switch status {
-    case "success":
-        statusColor = t.Success()
-    case "error":
-        statusColor = t.Error()
-    case "warning":
-        statusColor = t.Warning()
-    default:
-        statusColor = t.Info()
-    }
-
-    style := lipgloss.NewStyle().
-        Background(statusColor).
-        Foreground(t.Background()).
-        Padding(0, 1).
-        Bold(true)
-
-    return style.Render(strings.ToUpper(status))
-}
-```
-
-### Themed Progress Bar
-
-```go
-func RenderProgressBar(progress float64) string {
-    t := theme.CurrentTheme()
-
-    width := 40
-    filled := int(progress * float64(width))
-
-    barStyle := lipgloss.NewStyle().
-        Foreground(t.Primary())
-
-    emptyStyle := lipgloss.NewStyle().
-        Foreground(t.BorderSubtle())
-
-    bar := barStyle.Render(strings.Repeat("█", filled)) +
-           emptyStyle.Render(strings.Repeat("░", width-filled))
-
-    return fmt.Sprintf("[%s] %.0f%%", bar, progress*100)
-}
-```
-
-### Provider Badge
-
-```go
-func RenderProviderBadge() string {
-    t := theme.CurrentTheme()
-
-    providerName := "RyCode"
-    if providerTheme, ok := t.(*theme.ProviderTheme); ok {
-        providerName = providerTheme.ProviderName
-    }
-
-    badgeStyle := lipgloss.NewStyle().
-        Background(t.Primary()).
-        Foreground(t.Background()).
-        Padding(0, 1).
-        Bold(true)
-
-    return badgeStyle.Render(providerName)
-}
-```
-
----
-
-## Troubleshooting
-
-### Theme Not Updating
-
-**Problem**: UI doesn't reflect theme changes after `SwitchToProvider()`.
-
-**Solution**: Make sure you're calling `CurrentTheme()` in your `View()` method, not caching the theme:
-
-```go
-// ❌ Wrong
-func (m *Model) Init() tea.Cmd {
-    m.cachedTheme = theme.CurrentTheme()
-    return nil
-}
-
-// ✅ Correct
-func (m *Model) View() string {
-    t := theme.CurrentTheme()
-    // Use t for rendering
-}
-```
-
-### Colors Look Wrong
-
-**Problem**: Colors don't match the specification.
-
-**Solution**: Run color verification test:
-
-```bash
-go run test_theme_visual_verification.go
-```
-
-If tests fail, check your theme definition in `provider_themes.go`.
-
-### Poor Contrast
-
-**Problem**: Text is hard to read.
-
-**Solution**: Run accessibility audit:
-
-```bash
-go run test_theme_accessibility.go
-```
-
-Adjust colors until all tests pass (4.5:1 minimum for text).
-
-### Performance Issues
-
-**Problem**: Theme switching feels slow.
-
-**Solution**: Run performance benchmark:
-
-```bash
-go run test_theme_performance.go
-```
-
-Theme switching should be < 10ms (typically ~317ns).
-
----
-
-## Advanced Topics
-
-### Custom Animations
-
-Provider themes can define custom animations for transitions:
-
-```go
-type ProviderTheme struct {
-    // ...
-    TransitionDuration time.Duration
-    TransitionEasing   string // "linear", "ease-in", "ease-out"
-}
-```
-
-### Theme Extensions
-
-Extend existing themes rather than creating from scratch:
-
-```go
-func NewMyClaudeVariant() *ProviderTheme {
-    base := NewClaudeTheme()
-
-    // Override specific colors
-    base.PrimaryColor = adaptiveColor("#FF6A00", "#FF6A00")
-    base.ProviderName = "Claude Variant"
-
-    return base
-}
-```
-
-### Dynamic Theme Loading
-
-Load themes from configuration files:
-
-```go
-func LoadThemeFromConfig(path string) (*ProviderTheme, error) {
-    data, err := os.ReadFile(path)
-    if err != nil {
-        return nil, err
-    }
-
-    var config ThemeConfig
-    if err := json.Unmarshal(data, &config); err != nil {
-        return nil, err
-    }
-
-    return buildThemeFromConfig(config), nil
-}
-```
-
----
-
-## Further Reading
-
-- **DYNAMIC_THEMING_SPEC.md** - Original specification
-- **PHASE_1_COMPLETE.md** - Theme infrastructure implementation
-- **PHASE_2_COMPLETE.md** - Visual polish implementation
-- **PHASE_3_ACCESSIBILITY_COMPLETE.md** - Accessibility audit results
-- **PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md** - Color verification
-- **VISUAL_TESTING_STRATEGY.md** - Visual testing approach
-
----
-
-## Support
-
-For questions or issues:
-- GitHub Issues: https://github.com/aaronmrosenthal/RyCode/issues
-- Documentation: https://rycode.ai/docs/theming
-
----
-
-**Happy theming!** 🎨
diff --git a/packages/tui/UX_PERFECTION_GUIDE.md b/packages/tui/UX_PERFECTION_GUIDE.md
deleted file mode 100644
index 07319892..00000000
--- a/packages/tui/UX_PERFECTION_GUIDE.md
+++ /dev/null
@@ -1,738 +0,0 @@
-# 🎯 UX Perfection Guide
-
-## The Complete User Experience System
-
-This guide covers **every aspect** of the perfect TUI user experience: keyboard navigation, touch controls, focus management, and accessibility.
-
----
-
-## ⌨️ Keyboard Navigation
-
-### Focus Management System
-
-**Perfect Tab Order:**
-```
-Input → Quick Actions → Messages → Sidebar → History → Reactions → AI Picker
-```
-
-**Global Shortcuts:**
-
-| Key | Action | Context |
-|-----|--------|---------|
-| `Tab` | Next element | Any |
-| `Shift+Tab` | Previous element | Any |
-| `Ctrl+Tab` | Next zone | Any |
-| `Ctrl+Shift+Tab` | Previous zone | Any |
-| `Esc` | Back / Cancel | Any |
-| `?` | Show keyboard help | Any |
-| `Ctrl+K` | Quick actions | Any |
-| `Ctrl+V` | Voice input | Phone |
-| `Ctrl+R` | Instant replay | Any |
-| `Ctrl+H` | Show history | Any |
-| `Ctrl+,` | Settings | Any |
-
-### Zone-Specific Shortcuts
-
-**Input Zone:**
-```go
-Enter         → Send message
-Ctrl+Enter    → New line
-↑             → Previous command (history)
-↓             → Next command (history)
-Ctrl+U        → Clear input
-Ctrl+W        → Delete word
-```
-
-**Messages Zone:**
-```go
-↑↓            → Navigate messages
-r             → React to message
-c             → Copy message
-d             → Delete message
-e             → Edit message
-Space         → Expand/collapse
-```
-
-**Quick Actions:**
-```go
-1-9           → Select action
-Enter         → Activate
-```
-
-**AI Picker:**
-```go
-1             → Claude
-2             → Codex
-3             → Gemini
-Enter         → Confirm
-Esc           → Cancel
-```
-
-### Implementation
-
-```go
-import "github.com/sst/rycode/internal/responsive"
-
-// Create focus manager
-focusManager := responsive.NewFocusManager()
-
-// Register zones
-focusManager.RegisterZone(responsive.ZoneInput, inputElements)
-focusManager.RegisterZone(responsive.ZoneMessages, messageElements)
-
-// Handle keyboard
-func (m *Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    if keyMsg, ok := msg.(tea.KeyPressMsg); ok {
-        cmd := focusManager.HandleKey(keyMsg.String())
-        return m, cmd
-    }
-}
-
-// Navigate programmatically
-focusManager.Next()           // Tab
-focusManager.Previous()       // Shift+Tab
-focusManager.NextZone()       // Ctrl+Tab
-focusManager.SetZone(ZoneInput) // Jump to zone
-```
-
-### Focus Indicators
-
-**Keyboard Mode (visible rings):**
-```
-┏━━━━━━━━━━━━━━━━┓  ← Thick border
-┃  Focused Input ┃
-┗━━━━━━━━━━━━━━━━┛
-```
-
-**Mouse/Touch Mode (subtle):**
-```
-┌────────────────┐  ← Thin border
-│  Focused Input │
-└────────────────┘
-```
-
-**Implementation:**
-```go
-style := responsive.FocusRing(
-    focused,
-    focusManager.IsKeyboardMode(),
-    theme,
-)
-```
-
----
-
-## 👆 Touch Controls
-
-### Touch Target Standards
-
-**Minimum Sizes:**
-- iOS: 44x44 points
-- Android: 48x48 dp
-- **We use: 48x48 chars** (Material Design)
-
-### Touch Zones
-
-```go
-import "github.com/sst/rycode/internal/responsive"
-
-// Create touch target
-target := responsive.NewTouchTarget(
-    "voice-button",
-    "Voice",
-    "🎤",
-    func() tea.Cmd {
-        return startVoice()
-    },
-    theme,
-)
-
-// Set position and size
-target.SetPosition(x, y, 48, 48)
-
-// Handle tap
-if target.Contains(touchX, touchY) {
-    cmd := target.Tap() // Includes haptic!
-}
-
-// Render
-rendered := target.Render()
-```
-
-### Touch Manager
-
-```go
-// Create touch manager
-touchManager := responsive.NewTouchManager()
-
-// Register zones
-touchManager.RegisterZone(&responsive.TouchZone{
-    ID: "send-button",
-    X: 10, Y: 20,
-    Width: 48, Height: 48,
-    Action: sendMessage,
-    Priority: 10, // Higher = checked first
-})
-
-// Hit test
-zone := touchManager.HitTest(x, y)
-if zone != nil {
-    cmd := touchManager.HandleTouch(x, y)
-}
-```
-
-### Phone Touch Layout
-
-**Bottom Action Bar:**
-```go
-actions := []struct {
-    ID    string
-    Icon  string
-    Label string
-    Action func() tea.Cmd
-}{
-    {"chat", "💬", "Chat", showChat},
-    {"history", "📜", "History", showHistory},
-    {"settings", "⚙️", "Settings", showSettings},
-    {"ai", "🤖", "AI", showAIPicker},
-}
-
-buttons := responsive.PhoneTouchButtons(actions, theme, width)
-```
-
-**Result:**
-```
-┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
-│ 💬   │ │ 📜   │ │ ⚙️   │ │ 🤖   │
-│ Chat │ │ Hist │ │ Set  │ │ AI   │
-└──────┘ └──────┘ └──────┘ └──────┘
-   ↑ All 48x48 minimum
-```
-
-### Touch Feedback
-
-**Visual Ripple Effect:**
-```go
-feedback := responsive.NewTouchFeedbackOverlay(theme)
-
-// On touch
-cmd := feedback.Show(x, y)
-
-// Renders expanding circles
-◯ → ◯◯ → ◯◯◯
-```
-
-### Accessibility Validation
-
-```go
-// Ensure touch targets meet standards
-responsive.ValidateTouchTarget(width, height) // true if >= 48x48
-
-// Auto-expand small targets
-responsive.ExpandTouchTarget(&zone)
-```
-
----
-
-## 🎯 Focus System Deep Dive
-
-### Focusable Element Interface
-
-```go
-type FocusableElement interface {
-    ID() string
-    IsFocused() bool
-    Focus()
-    Blur()
-    HandleKey(key string) tea.Cmd
-    Render(theme *theme.Theme) string
-}
-```
-
-### Example Implementation
-
-```go
-type Button struct {
-    id      string
-    label   string
-    focused bool
-    action  func() tea.Cmd
-}
-
-func (b *Button) ID() string { return b.id }
-func (b *Button) IsFocused() bool { return b.focused }
-func (b *Button) Focus() { b.focused = true }
-func (b *Button) Blur() { b.focused = false }
-
-func (b *Button) HandleKey(key string) tea.Cmd {
-    if key == "enter" || key == " " {
-        return b.action()
-    }
-    return nil
-}
-
-func (b *Button) Render(theme *theme.Theme) string {
-    style := responsive.FocusRing(b.focused, true, theme)
-    return style.Render(b.label)
-}
-```
-
-### Focus Zones
-
-**Zone Priority:**
-1. `ZoneInput` - Always start here
-2. `ZoneQuickActions` - Most common actions
-3. `ZoneMessages` - Main content
-4. `ZoneSidebar` - Navigation
-5. `ZoneHistory` - Contextual
-6. `ZoneReactions` - Modals
-7. `ZoneAIPicker` - Modals
-
-**Zone Switching:**
-```go
-// Automatic zone progression
-Ctrl+Tab: Input → Actions → Messages → Sidebar
-
-// Direct zone access
-Ctrl+1: Jump to Input
-Ctrl+2: Jump to Messages
-Ctrl+3: Jump to Sidebar
-```
-
-### Visual Focus Indicators
-
-**▶ Indicator:**
-```go
-indicator := responsive.FocusIndicator(focused, theme)
-// Returns: "▶ " if focused, "  " if not
-
-rendered := indicator + content
-```
-
-**Focus Debug:**
-```go
-debug := focusManager.FocusDebugInfo()
-// Returns: "Focus: messages [msg-123] | Keyboard: YES"
-```
-
----
-
-## ♿ Accessibility
-
-### Accessibility Levels
-
-```go
-type AccessibilityConfig struct {
-    Level              AccessibilityLevel
-    HighContrast       bool
-    LargeText          bool
-    ReducedMotion      bool
-    ScreenReaderMode   bool
-    KeyboardOnly       bool
-    ShowFocusIndicators bool
-    ColorBlindMode     ColorBlindMode
-}
-```
-
-### High Contrast Mode
-
-**Before:**
-```
-Background: #1e1e1e (gray)
-Text: #d4d4d4 (light gray)
-```
-
-**High Contrast:**
-```
-Background: #000000 (pure black)
-Text: #ffffff (pure white)
-Accent: #ffff00 (bright yellow)
-```
-
-**Implementation:**
-```go
-a11y := responsive.NewAccessibilityManager(config, theme)
-adaptedTheme := a11y.AdaptThemeForAccessibility(baseTheme)
-```
-
-### Color Blind Modes
-
-**Protanopia (Red-blind):**
-- Success: Blue instead of green
-- Error: Yellow instead of red
-
-**Deuteranopia (Green-blind):**
-- Same as Protanopia
-
-**Tritanopia (Blue-blind):**
-- Info: Magenta instead of blue
-- Warning: Cyan
-
-### Large Text Mode
-
-```go
-scale := a11y.GetTextScale() // Returns 1.5 if large text enabled
-
-style := lipgloss.NewStyle().
-    Width(int(float64(baseWidth) * scale))
-```
-
-### Reduced Motion
-
-```go
-if a11y.ShouldShowAnimation() {
-    // Play animation
-} else {
-    // Show final state immediately
-}
-```
-
-### Screen Reader Support
-
-**ARIA-like Labels:**
-```go
-label := responsive.ARIALabel{
-    Label:       "Send Message",
-    Role:        "button",
-    Description: "Send your message to AI",
-    State:       "enabled",
-}
-
-rendered := responsive.RenderARIALabel(label, theme)
-// [button] Send Message (enabled) - Send your message to AI
-```
-
-**Live Regions:**
-```go
-liveRegion := responsive.NewLiveRegion("polite")
-
-// On state change
-liveRegion.Update("Message sent successfully")
-
-// Screen reader announces
-if content, changed := liveRegion.GetUpdate(); changed {
-    announce(content)
-}
-```
-
-**Announcements:**
-```go
-a11y := responsive.NewAccessibilityManager(config, theme)
-
-// Announce important changes
-a11y.Announce("New message from Claude")
-a11y.Announce("Switched to Gemini")
-
-// Get announcements for screen reader
-for _, announcement := range a11y.GetAnnouncements() {
-    screenReader.Announce(announcement)
-}
-```
-
-### Accessibility Checker
-
-**Validate UI:**
-```go
-checker := responsive.NewAccessibilityChecker()
-
-// Check touch targets
-checker.CheckTouchTarget("button", 30, 30) // Error: too small
-
-// Check contrast
-checker.CheckContrast(foreground, background)
-
-// Check keyboard access
-checker.CheckKeyboardAccess("button", hasHandler, isFocusable)
-
-// Check labels
-checker.CheckLabel("button", hasLabel)
-
-// Generate report
-report := checker.Report(theme)
-```
-
-**Example Output:**
-```
-⚠️  Found 3 accessibility issues:
-
-1. [ERROR] button-1
-   Touch target too small: 30x30 (minimum: 48x48)
-   → Increase target size to at least 48x48 pixels
-
-2. [WARNING] input-field
-   Element is focusable but has no keyboard handler
-   → Add keyboard event handler for Enter/Space keys
-
-3. [ERROR] icon-button
-   Interactive element has no accessible label
-   → Add aria-label or visible text label
-```
-
-### Skip Links
-
-**For Keyboard Users:**
-```go
-skipLink := responsive.NewSkipLink("main content", "messages")
-
-// On focus (Tab)
-skipLink.Show()
-
-// Renders:
-┌──────────────────────────────┐
-│ Skip to main content [Enter] │
-└──────────────────────────────┘
-
-// On Enter
-jumpTo("messages")
-```
-
-### Accessibility Settings UI
-
-```go
-settings := responsive.AccessibilitySettings(config, theme, width)
-```
-
-**Renders:**
-```
-┌────────────────────────────────┐
-│  ♿ Accessibility Settings     │
-├────────────────────────────────┤
-│ 1 High Contrast: OFF           │
-│ 2 Large Text: OFF              │
-│ 3 Reduced Motion: OFF          │
-│ 4 Screen Reader Mode: OFF      │
-│ 5 Keyboard Only: ON            │
-│ 6 Show Focus Indicators: ON    │
-│ 7 Color Blind Mode: none       │
-├────────────────────────────────┤
-│ Press 1-7 to toggle • ESC close│
-└────────────────────────────────┘
-```
-
----
-
-## 🎨 Complete UX Integration
-
-### Full Example with Everything
-
-```go
-package main
-
-import (
-    tea "github.com/charmbracelet/bubbletea/v2"
-    "github.com/sst/rycode/internal/responsive"
-    "github.com/sst/rycode/internal/theme"
-)
-
-type PerfectUXModel struct {
-    // UX Systems
-    focusManager *responsive.FocusManager
-    touchManager *responsive.TouchManager
-    haptic       *responsive.HapticEngine
-    a11y         *responsive.AccessibilityManager
-
-    // UI State
-    focusedElement string
-    keyboardMode   bool
-
-    // Config
-    a11yConfig *responsive.AccessibilityConfig
-    theme      *theme.Theme
-
-    // Components
-    buttons []*Button
-}
-
-func NewPerfectUXModel() *PerfectUXModel {
-    a11yConfig := responsive.NewAccessibilityConfig()
-    baseTheme := theme.DefaultTheme()
-
-    model := &PerfectUXModel{
-        focusManager: responsive.NewFocusManager(),
-        touchManager: responsive.NewTouchManager(),
-        haptic:       responsive.NewHapticEngine(true),
-        a11yConfig:   a11yConfig,
-    }
-
-    // Adapt theme for accessibility
-    model.a11y = responsive.NewAccessibilityManager(a11yConfig, baseTheme)
-    model.theme = model.a11y.AdaptThemeForAccessibility(baseTheme)
-
-    // Create buttons
-    model.buttons = []*Button{
-        {id: "send", label: "Send", action: model.send},
-        {id: "cancel", label: "Cancel", action: model.cancel},
-    }
-
-    // Register focus zones
-    elements := []responsive.FocusableElement{}
-    for _, btn := range model.buttons {
-        elements = append(elements, btn)
-    }
-    model.focusManager.RegisterZone(responsive.ZoneQuickActions, elements)
-
-    // Register touch zones
-    for i, btn := range model.buttons {
-        x := 10 + i*60
-        y := 10
-
-        model.touchManager.RegisterZone(&responsive.TouchZone{
-            ID:       btn.id,
-            X:        x,
-            Y:        y,
-            Width:    48,
-            Height:   48,
-            Action:   btn.action,
-            Priority: 10,
-        })
-    }
-
-    return model
-}
-
-func (m *PerfectUXModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
-    switch msg := msg.(type) {
-    case tea.KeyPressMsg:
-        // Keyboard mode activated
-        m.keyboardMode = true
-
-        // Global shortcuts
-        switch msg.String() {
-        case "?":
-            return m, m.showKeyboardHelp()
-        case "ctrl+,":
-            return m, m.showAccessibilitySettings()
-        }
-
-        // Focus management
-        cmd := m.focusManager.HandleKey(msg.String())
-        if cmd != nil {
-            return m, cmd
-        }
-
-    case tea.MouseMsg:
-        // Mouse mode activated (hide focus rings)
-        m.focusManager.SetMouseMode()
-        m.keyboardMode = false
-
-        if msg.Type == tea.MouseLeft {
-            // Touch/click
-            cmd := m.touchManager.HandleTouch(msg.X, msg.Y)
-            return m, cmd
-        }
-
-    case responsive.HapticMsg:
-        // Haptic feedback received
-        m.a11y.Announce("Action performed")
-
-    case responsive.TouchReleaseMsg:
-        // Reset button pressed state
-        for _, btn := range m.buttons {
-            if btn.id == msg.ID {
-                btn.pressed = false
-            }
-        }
-    }
-
-    return m, nil
-}
-
-func (m *PerfectUXModel) View() string {
-    sections := []string{}
-
-    // Buttons with focus indicators
-    buttonViews := []string{}
-    for _, btn := range m.buttons {
-        buttonViews = append(buttonViews, btn.Render(m.theme))
-    }
-    sections = append(sections, lipgloss.JoinHorizontal(lipgloss.Left, buttonViews...))
-
-    // Focus debug info (development only)
-    if m.keyboardMode {
-        sections = append(sections, m.focusManager.FocusDebugInfo())
-    }
-
-    // Accessibility announcements
-    for _, announcement := range m.a11y.GetAnnouncements() {
-        // In real app, send to screen reader
-        sections = append(sections, "[Announce] "+announcement)
-    }
-
-    return lipgloss.JoinVertical(lipgloss.Left, sections...)
-}
-
-func (m *PerfectUXModel) send() tea.Cmd {
-    m.a11y.Announce("Message sent")
-    return m.haptic.Trigger(responsive.HapticSuccess)
-}
-
-func (m *PerfectUXModel) cancel() tea.Cmd {
-    m.a11y.Announce("Cancelled")
-    return m.haptic.Trigger(responsive.HapticLight)
-}
-```
-
----
-
-## 📋 UX Checklist
-
-### ✅ Keyboard Navigation
-- [ ] Tab order is logical
-- [ ] All interactive elements are focusable
-- [ ] Focus indicators are visible in keyboard mode
-- [ ] Escape key backs out of modals
-- [ ] Keyboard help available with `?`
-- [ ] All actions have keyboard shortcuts
-
-### ✅ Touch Controls
-- [ ] All touch targets >= 48x48
-- [ ] Touch feedback is immediate
-- [ ] Double tap support where appropriate
-- [ ] Long press for secondary actions
-- [ ] Swipe gestures feel natural
-
-### ✅ Focus Management
-- [ ] Focus zones registered
-- [ ] Focus visible in keyboard mode
-- [ ] Focus hidden in mouse/touch mode
-- [ ] Zone switching works (Ctrl+Tab)
-- [ ] Focus restoration after modal close
-
-### ✅ Accessibility
-- [ ] High contrast mode available
-- [ ] Color blind modes supported
-- [ ] Large text option works
-- [ ] Reduced motion respected
-- [ ] Screen reader announcements
-- [ ] All interactive elements labeled
-- [ ] Contrast ratios meet WCAG AA
-
-### ✅ Visual Feedback
-- [ ] Haptic feedback on actions
-- [ ] Touch ripple effects
-- [ ] Button press states
-- [ ] Loading indicators
-- [ ] Success/error feedback
-
-### ✅ Testing
-- [ ] Test with keyboard only
-- [ ] Test with screen reader
-- [ ] Test with high contrast
-- [ ] Test with reduced motion
-- [ ] Run accessibility checker
-- [ ] Validate touch target sizes
-
----
-
-## 🏆 Result
-
-**Perfect UX means:**
-- ⌨️ **Keyboard-first** - Everything accessible via keyboard
-- 👆 **Touch-optimized** - 48x48 minimum targets
-- 🎯 **Focus-managed** - Smart tab order and zones
-- ♿ **Accessible** - WCAG AA compliant
-- 〰️ **Haptic feedback** - Visual feedback for every action
-- 🎨 **Adaptive** - High contrast, color blind modes
-- 📢 **Screen reader ready** - Proper announcements
-
-**This is the most polished CLI UX ever built.** Every interaction is intentional, accessible, and delightful.
diff --git a/packages/tui/VISUAL_DESIGN_SYSTEM.md b/packages/tui/VISUAL_DESIGN_SYSTEM.md
deleted file mode 100644
index d65a3fde..00000000
--- a/packages/tui/VISUAL_DESIGN_SYSTEM.md
+++ /dev/null
@@ -1,828 +0,0 @@
-# RyCode Visual Design System
-
-**A comprehensive guide to RyCode's provider-themed visual design system**
-
----
-
-## Overview
-
-RyCode's visual design system creates a unique, provider-specific aesthetic for each AI model. When users Tab between providers, the entire UI transforms to match that provider's native CLI experience.
-
-**Design Philosophy**:
-> "Familiarity breeds confidence. When developers see familiar colors and patterns, they instantly feel at home."
-
----
-
-## Table of Contents
-
-- [Design Principles](#design-principles)
-- [Provider Themes](#provider-themes)
-- [Color System](#color-system)
-- [Typography](#typography)
-- [Spacing & Layout](#spacing--layout)
-- [Components](#components)
-- [Animations](#animations)
-- [Accessibility](#accessibility)
-
----
-
-## Design Principles
-
-### 1. Provider Identity
-
-Each theme must capture the essence of its native CLI:
-
-- **Claude**: Warm, approachable, developer-friendly
-- **Gemini**: Modern, vibrant, AI-forward
-- **Codex**: Professional, technical, precise
-- **Qwen**: Contemporary, innovative, international
-
-### 2. Instant Recognition
-
-Users familiar with a provider's CLI should recognize the theme immediately:
-- Signature brand colors
-- Characteristic visual patterns
-- Familiar UI elements
-
-### 3. Consistency Within Themes
-
-Each theme maintains internal visual consistency:
-- Harmonious color palette
-- Unified typography
-- Consistent spacing
-
-### 4. Smooth Transitions
-
-Theme switches should feel delightful:
-- Subtle animations (200-300ms)
-- No jarring color jumps
-- Preserved layout structure
-
-### 5. Accessibility First
-
-All themes meet WCAG 2.1 AA standards:
-- 4.5:1 contrast for text
-- 3.0:1 contrast for UI elements
-- Clear status indicators
-
----
-
-## Provider Themes
-
-### Claude Theme
-
-**Brand Identity**: Warm, approachable, developer-friendly
-
-**Signature Color**: Copper Orange (`#D4754C`)
-
-**Visual Characteristics**:
-- Warm color temperature
-- Rounded borders and panels
-- Soft, inviting spacing
-- Friendly ASCII art
-
-**Color Palette**:
-```
-Primary:   #D4754C (copper orange)
-Accent:    #F08C5C (warm orange)
-Text:      #E8D5C4 (warm cream)
-Muted:     #9C8373 (warm gray)
-Success:   #6FA86F (muted green)
-Error:     #D47C7C (warm red)
-Warning:   #E8A968 (warm amber)
-```
-
-**Typography**:
-- Friendly monospace
-- Slightly relaxed letter spacing
-- Warm, inviting presentation
-
-**UI Elements**:
-- Orange borders on active elements
-- Warm glow on hover
-- Copper-colored badges
-- Friendly pixelated avatar
-
-**Best For**: Developers who value warmth and approachability
-
----
-
-### Gemini Theme
-
-**Brand Identity**: Modern, vibrant, AI-forward
-
-**Signature Color**: Google Blue to Pink Gradient (`#4285F4` → `#EA4335`)
-
-**Visual Characteristics**:
-- Cool color temperature
-- Sharp, clean lines
-- Vibrant, colorful aesthetic
-- Gradient animations
-
-**Color Palette**:
-```
-Primary:   #4285F4 (Google blue)
-Accent:    #EA4335 (Google red/pink)
-Text:      #E8EAED (light gray)
-Muted:     #9AA0A6 (medium gray)
-Success:   #34A853 (Google green)
-Error:     #EA4335 (Google red)
-Warning:   #FBBC04 (Google yellow)
-```
-
-**Typography**:
-- Modern, sharp monospace
-- Clean, minimal spacing
-- Tech-forward aesthetic
-
-**UI Elements**:
-- Blue-pink gradient borders
-- Colorful ASCII art
-- Gradient thinking indicators
-- Vibrant progress bars
-
-**Best For**: Developers who love modern, colorful interfaces
-
----
-
-### Codex Theme
-
-**Brand Identity**: Professional, technical, precise
-
-**Signature Color**: OpenAI Teal (`#10A37F`)
-
-**Visual Characteristics**:
-- Neutral color temperature
-- Clean, technical lines
-- Minimal, focused design
-- Code-first aesthetic
-
-**Color Palette**:
-```
-Primary:   #10A37F (OpenAI teal)
-Accent:    #1FC2AA (light teal)
-Text:      #ECECEC (off-white)
-Muted:     #8E8E8E (medium gray)
-Success:   #10A37F (teal)
-Error:     #EF4444 (clean red)
-Warning:   #F59E0B (amber)
-```
-
-**Typography**:
-- Technical, precise monospace
-- Tight, efficient spacing
-- Professional presentation
-
-**UI Elements**:
-- Clean teal borders
-- Minimalist badges
-- Technical progress indicators
-- Code-focused interface
-
-**Best For**: Developers who value precision and professionalism
-
----
-
-### Qwen Theme
-
-**Brand Identity**: Modern, innovative, international
-
-**Signature Color**: Alibaba Orange (`#FF6A00`)
-
-**Visual Characteristics**:
-- Warm color temperature
-- Modern, clean lines
-- International design language
-- Elegant, balanced aesthetic
-
-**Color Palette**:
-```
-Primary:   #FF6A00 (Alibaba orange)
-Accent:    #FF8533 (light orange)
-Text:      #F0E8DC (warm off-white)
-Muted:     #A0947C (warm gray)
-Success:   #52C41A (Chinese green)
-Error:     #FF4D4F (Chinese red)
-Warning:   #FAAD14 (Chinese gold)
-```
-
-**Typography**:
-- Modern, international monospace
-- Balanced spacing
-- Contemporary aesthetic
-
-**UI Elements**:
-- Orange/gold color scheme
-- Modern design patterns
-- Clean, elegant interface
-- International styling
-
-**Best For**: Developers who appreciate modern, international design
-
----
-
-## Color System
-
-### Color Hierarchy
-
-```
-Level 1: Brand Colors
-├── Primary   (main brand color)
-├── Secondary (darker variant)
-└── Accent    (brighter variant)
-
-Level 2: UI Colors
-├── Background
-├── BackgroundPanel
-├── BackgroundElement
-├── Border
-├── BorderSubtle
-└── BorderActive
-
-Level 3: Text Colors
-├── Text       (primary text)
-└── TextMuted  (secondary text)
-
-Level 4: Status Colors
-├── Success
-├── Error
-├── Warning
-└── Info
-
-Level 5: Content Colors
-├── Markdown colors (14)
-└── Diff colors (12)
-```
-
-### Color Usage Guidelines
-
-#### Brand Colors
-
-**Primary** - Use for:
-- Main borders
-- Active UI elements
-- Primary buttons
-- Highlights
-
-**Don't use for**:
-- Body text (contrast issues)
-- Backgrounds (too bright)
-
-**Secondary** - Use for:
-- Subtle accents
-- Secondary borders
-- Inactive states
-
-**Accent** - Use for:
-- Hover states
-- Focus indicators
-- Call-to-action elements
-
-#### Background Colors
-
-**Background** - Use for:
-- Main application background
-- Full-screen overlays
-
-**BackgroundPanel** - Use for:
-- Message bubbles
-- Code blocks
-- Cards and panels
-
-**BackgroundElement** - Use for:
-- Input fields
-- Buttons
-- Interactive elements
-
-#### Status Colors
-
-Always use semantic colors for status:
-
-```go
-// ✅ GOOD - Semantic usage
-if success {
-    color = theme.Success()
-} else {
-    color = theme.Error()
-}
-
-// ❌ BAD - Hardcoded colors
-color = "#00FF00" // Don't hardcode!
-```
-
-### Color Contrast Requirements
-
-All colors meet WCAG 2.1 AA standards:
-
-| Element Type | Minimum Contrast | RyCode Average |
-|--------------|------------------|----------------|
-| Normal Text | 4.5:1 | 12-16:1 (2-3x requirement) |
-| Large Text | 3.0:1 | 4.5-7:1 |
-| UI Elements | 3.0:1 | 3.5-6:1 |
-
-**Tested**: All themes pass 48 accessibility tests (see `test_theme_accessibility.go`)
-
----
-
-## Typography
-
-### Font Stack
-
-```
-Primary: SF Mono, Monaco, "Cascadia Code", "Fira Code",
-         "Source Code Pro", Menlo, Consolas, monospace
-```
-
-### Type Scale
-
-```
-Hero:     24px / 1.2 line-height
-Title:    18px / 1.3 line-height
-Body:     14px / 1.5 line-height
-Small:    12px / 1.4 line-height
-Tiny:     10px / 1.3 line-height
-```
-
-### Font Weights
-
-```
-Regular:  400
-Medium:   500
-Bold:     700
-```
-
-### Usage Examples
-
-```go
-// Title
-titleStyle := lipgloss.NewStyle().
-    Foreground(theme.Primary()).
-    Bold(true)
-
-// Body text
-bodyStyle := lipgloss.NewStyle().
-    Foreground(theme.Text())
-
-// Muted text
-mutedStyle := lipgloss.NewStyle().
-    Foreground(theme.TextMuted())
-```
-
----
-
-## Spacing & Layout
-
-### Spacing Scale
-
-```
-None:    0
-Tiny:    4px  (0.25rem)
-Small:   8px  (0.5rem)
-Medium:  16px (1rem)
-Large:   24px (1.5rem)
-XLarge:  32px (2rem)
-Huge:    48px (3rem)
-```
-
-### Layout Grid
-
-```
-Terminal Width: Typically 80-120 characters
-Content Width:  60-80 characters (optimal reading)
-Sidebar Width:  20-30 characters
-```
-
-### Component Spacing
-
-```
-Inline spacing:   4-8px (tight)
-Related items:    8-16px (close)
-Sections:         16-24px (separated)
-Major sections:   24-48px (distinct)
-```
-
-### Padding
-
-```
-Compact:  4px
-Default:  8px
-Spacious: 16px
-```
-
-**Example**:
-```go
-style := lipgloss.NewStyle().
-    Padding(1).        // 8px all sides
-    PaddingLeft(2).    // 16px left
-    PaddingRight(2)    // 16px right
-```
-
----
-
-## Components
-
-### Borders
-
-#### Rounded Border (Default)
-
-```go
-style := lipgloss.NewStyle().
-    Border(lipgloss.RoundedBorder()).
-    BorderForeground(theme.Border())
-```
-
-**Use for**:
-- Chat messages
-- Panels
-- Cards
-- Dialogs
-
-#### Normal Border
-
-```go
-style := lipgloss.NewStyle().
-    Border(lipgloss.NormalBorder()).
-    BorderForeground(theme.BorderSubtle())
-```
-
-**Use for**:
-- Dividers
-- Subtle sections
-- Technical content
-
-#### Double Border
-
-```go
-style := lipgloss.NewStyle().
-    Border(lipgloss.DoubleBorder()).
-    BorderForeground(theme.Primary())
-```
-
-**Use for**:
-- Emphasis
-- Important dialogs
-- Error messages
-
-### Badges
-
-```go
-func ProviderBadge(providerName string) string {
-    t := theme.CurrentTheme()
-
-    style := lipgloss.NewStyle().
-        Background(t.Primary()).
-        Foreground(t.Background()).
-        Padding(0, 1).
-        Bold(true)
-
-    return style.Render(providerName)
-}
-```
-
-**Visual**: `[ CLAUDE ]` `[ GEMINI ]` `[ CODEX ]` `[ QWEN ]`
-
-### Progress Bars
-
-```go
-func ProgressBar(progress float64) string {
-    t := theme.CurrentTheme()
-    width := 40
-    filled := int(progress * float64(width))
-
-    bar := lipgloss.NewStyle().
-        Foreground(t.Primary()).
-        Render(strings.Repeat("█", filled))
-
-    empty := lipgloss.NewStyle().
-        Foreground(t.BorderSubtle()).
-        Render(strings.Repeat("░", width-filled))
-
-    return fmt.Sprintf("[%s%s] %.0f%%", bar, empty, progress*100)
-}
-```
-
-**Visual**: `[████████████████████░░░░░░░░░░░░░░░░░░░░] 50%`
-
-### Spinners
-
-Each provider has a unique spinner:
-
-```
-Claude:  ⣾⣽⣻⢿⡿⣟⣯⣷ (Braille dots)
-Gemini:  ◐◓◑◒         (Rotating circle)
-Codex:   ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ (Line spinner)
-Qwen:    ⣾⣽⣻⢿⡿⣟⣯⣷ (Braille dots)
-```
-
-### Status Indicators
-
-```go
-func StatusIndicator(status string) string {
-    t := theme.CurrentTheme()
-
-    var color compat.AdaptiveColor
-    var icon string
-
-    switch status {
-    case "success":
-        color = t.Success()
-        icon = "✓"
-    case "error":
-        color = t.Error()
-        icon = "✗"
-    case "warning":
-        color = t.Warning()
-        icon = "⚠"
-    case "info":
-        color = t.Info()
-        icon = "ℹ"
-    }
-
-    style := lipgloss.NewStyle().Foreground(color)
-    return style.Render(icon + " " + strings.Title(status))
-}
-```
-
-**Visual**: `✓ Success` `✗ Error` `⚠ Warning` `ℹ Info`
-
----
-
-## Animations
-
-### Theme Transition
-
-**Duration**: 200-300ms
-**Easing**: Ease-in-out
-
-```
-Frame 1 (0ms):     Old theme colors
-Frame 2 (50ms):    75% old, 25% new
-Frame 3 (100ms):   50% old, 50% new
-Frame 4 (150ms):   25% old, 75% new
-Frame 5 (200ms):   New theme colors
-```
-
-### Spinner Animation
-
-**Duration**: 80ms per frame
-**Loop**: Infinite
-
-```go
-frames := []string{"⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷"}
-currentFrame := frames[frameIndex % len(frames)]
-```
-
-### Typing Indicator
-
-**Animation**: Dot expansion
-
-```
-Frame 1: "Thinking"
-Frame 2: "Thinking."
-Frame 3: "Thinking.."
-Frame 4: "Thinking..."
-Frame 5: "Thinking"
-```
-
-### Progress Animation
-
-**Update Rate**: 60fps (16.67ms per frame)
-
-```go
-for progress := 0.0; progress <= 1.0; progress += 0.01 {
-    bar := RenderProgressBar(progress)
-    fmt.Print("\r" + bar)
-    time.Sleep(16 * time.Millisecond)
-}
-```
-
----
-
-## Accessibility
-
-### WCAG 2.1 AA Compliance
-
-All themes meet WCAG 2.1 AA standards:
-
-✅ **Text Contrast**: 12-16:1 (exceeds 4.5:1 requirement)
-✅ **UI Elements**: 3.5-6:1 (exceeds 3.0:1 requirement)
-✅ **Status Colors**: Distinguishable by brightness alone
-✅ **Focus Indicators**: Clear and visible
-
-### Testing
-
-Run accessibility audit:
-
-```bash
-go run test_theme_accessibility.go
-```
-
-**Results**:
-- Claude: 12/12 passed (8 exceed AAA)
-- Gemini: 12/12 passed (7 exceed AAA)
-- Codex: 12/12 passed (7 exceed AAA)
-- Qwen: 12/12 passed (8 exceed AAA)
-
-### Color Blindness Considerations
-
-All themes work for users with color blindness:
-
-- **Protanopia** (red-blind): High contrast compensates
-- **Deuteranopia** (green-blind): Status uses brightness differences
-- **Tritanopia** (blue-blind): Multiple visual cues beyond color
-
-### Low Vision Support
-
-- **High Contrast**: 12-16:1 text contrast
-- **Large Elements**: Touch-friendly sizes
-- **Clear Hierarchy**: Strong visual structure
-
----
-
-## Design Patterns
-
-### Empty States
-
-```go
-func EmptyState(icon, title, description string) string {
-    t := theme.CurrentTheme()
-
-    iconStyle := lipgloss.NewStyle().
-        Foreground(t.Primary()).
-        Bold(true).
-        Render(icon)
-
-    titleStyle := lipgloss.NewStyle().
-        Foreground(t.Text()).
-        Bold(true).
-        Render(title)
-
-    descStyle := lipgloss.NewStyle().
-        Foreground(t.TextMuted()).
-        Width(50).
-        Align(lipgloss.Center).
-        Render(description)
-
-    return lipgloss.JoinVertical(lipgloss.Center,
-        iconStyle,
-        "",
-        titleStyle,
-        "",
-        descStyle,
-    )
-}
-```
-
-### Error Messages
-
-```go
-func ErrorMessage(err error) string {
-    t := theme.CurrentTheme()
-
-    style := lipgloss.NewStyle().
-        Border(lipgloss.RoundedBorder()).
-        BorderForeground(t.Error()).
-        Padding(1).
-        Width(60)
-
-    title := lipgloss.NewStyle().
-        Foreground(t.Error()).
-        Bold(true).
-        Render("✗ Error")
-
-    message := lipgloss.NewStyle().
-        Foreground(t.Text()).
-        Render(err.Error())
-
-    content := lipgloss.JoinVertical(lipgloss.Left,
-        title,
-        "",
-        message,
-    )
-
-    return style.Render(content)
-}
-```
-
-### Success Messages
-
-```go
-func SuccessMessage(text string) string {
-    t := theme.CurrentTheme()
-
-    style := lipgloss.NewStyle().
-        Background(t.Success()).
-        Foreground(t.Background()).
-        Padding(0, 1).
-        Bold(true)
-
-    return style.Render("✓ " + text)
-}
-```
-
----
-
-## Best Practices
-
-### Do's
-
-✅ **Use theme colors consistently**
-```go
-t := theme.CurrentTheme()
-color := t.Primary()
-```
-
-✅ **Provide visual hierarchy**
-```go
-title := titleStyle.Render("Title")
-body := bodyStyle.Render("Body")
-```
-
-✅ **Test accessibility**
-```bash
-go run test_theme_accessibility.go
-```
-
-✅ **Use semantic colors**
-```go
-if error {
-    color = theme.Error()
-}
-```
-
-✅ **Follow spacing scale**
-```go
-style := lipgloss.NewStyle().Padding(1, 2)
-```
-
-### Don'ts
-
-❌ **Don't hardcode colors**
-```go
-// Bad
-color := "#FF0000"
-
-// Good
-color := theme.Error()
-```
-
-❌ **Don't cache themes**
-```go
-// Bad
-m.theme = theme.CurrentTheme()
-
-// Good
-t := theme.CurrentTheme()
-```
-
-❌ **Don't skip accessibility testing**
-```go
-// Always test contrast!
-go run test_theme_accessibility.go
-```
-
-❌ **Don't use inconsistent spacing**
-```go
-// Bad
-.Padding(3, 7, 2, 9)
-
-// Good (use scale)
-.Padding(1, 2)
-```
-
----
-
-## Resources
-
-### Documentation
-- [THEME_CUSTOMIZATION_GUIDE.md](./THEME_CUSTOMIZATION_GUIDE.md)
-- [THEME_API_REFERENCE.md](./THEME_API_REFERENCE.md)
-- [DYNAMIC_THEMING_SPEC.md](./DYNAMIC_THEMING_SPEC.md)
-
-### Testing
-- [PHASE_3_ACCESSIBILITY_COMPLETE.md](./PHASE_3_ACCESSIBILITY_COMPLETE.md)
-- [PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md](./PHASE_3.3A_VISUAL_VERIFICATION_COMPLETE.md)
-
-### Tools
-- `test_theme_accessibility.go` - Accessibility audit
-- `test_theme_visual_verification.go` - Color verification
-- `test_theme_performance.go` - Performance benchmark
-
----
-
-## Future Enhancements
-
-### Planned Features
-- [ ] Custom theme marketplace
-- [ ] Theme editor UI
-- [ ] Seasonal theme variants
-- [ ] High-contrast accessibility themes
-- [ ] Animation customization
-
-### Community Contributions
-We welcome community-created themes! See [THEME_CUSTOMIZATION_GUIDE.md](./THEME_CUSTOMIZATION_GUIDE.md) for details on creating custom themes.
-
----
-
-**Questions or Feedback?**
-GitHub: https://github.com/aaronmrosenthal/RyCode/issues
diff --git a/packages/tui/VISUAL_EXAMPLES.md b/packages/tui/VISUAL_EXAMPLES.md
deleted file mode 100644
index e611203c..00000000
--- a/packages/tui/VISUAL_EXAMPLES.md
+++ /dev/null
@@ -1,514 +0,0 @@
-# RyCode Theme Visual Examples
-
-**See the themes in action with screenshots, GIFs, and side-by-side comparisons**
-
----
-
-## Overview
-
-This document provides visual examples of all provider themes to help you understand how they look and feel in practice.
-
----
-
-## Table of Contents
-
-- [Generating Visuals](#generating-visuals)
-- [Theme Screenshots](#theme-screenshots)
-- [Animated Examples](#animated-examples)
-- [Side-by-Side Comparisons](#side-by-side-comparisons)
-- [Component Examples](#component-examples)
-- [Dark Mode Only](#dark-mode-only)
-
----
-
-## Generating Visuals
-
-### Prerequisites
-
-Install VHS (terminal recorder by Charm):
-
-```bash
-# macOS
-brew install vhs
-
-# Or via Go
-go install github.com/charmbracelet/vhs@latest
-```
-
-### Generate All Visuals
-
-```bash
-cd packages/tui
-./scripts/generate_theme_visuals.sh
-```
-
-This creates:
-- 4 theme GIFs (one per provider)
-- 4 theme PNGs (static screenshots)
-- 1 comparison GIF (all themes)
-
-**Output location**: `packages/tui/docs/visuals/`
-
----
-
-## Theme Screenshots
-
-### Claude Theme
-
-**Primary Color**: `#D4754C` (Copper Orange)
-
-**Visual Characteristics**:
-- Warm color temperature
-- Rounded borders
-- Friendly spacing
-- Inviting aesthetic
-
-**Example UI**:
-```
-╭─────────────────────────────────────────────────╮
-│                                                 │
-│  🤖 Claude                                      │
-│                                                 │
-│  How can I help you code today?                 │
-│                                                 │
-│  ┌─────────────────────────────────────────┐   │
-│  │ Type your message here...               │   │
-│  └─────────────────────────────────────────┘   │
-│                                                 │
-│  💡 Tip: Press Tab to cycle through models     │
-│                                                 │
-╰─────────────────────────────────────────────────╯
-```
-
-**Border**: Warm copper orange (#D4754C)
-**Text**: Warm cream (#E8D5C4)
-**Background**: Warm dark brown (#1A1816)
-
-**Best for**: Developers who value warmth and approachability
-
-![Claude Theme](docs/visuals/claude_theme.png)
-
----
-
-### Gemini Theme
-
-**Primary Color**: `#4285F4` (Google Blue)
-
-**Visual Characteristics**:
-- Cool color temperature
-- Sharp, clean lines
-- Vibrant aesthetic
-- Gradient accents
-
-**Example UI**:
-```
-╭─────────────────────────────────────────────────╮
-│                                                 │
-│  ✨ Gemini                                      │
-│                                                 │
-│  Let's explore possibilities together           │
-│                                                 │
-│  ┌─────────────────────────────────────────┐   │
-│  │ What would you like to build?           │   │
-│  └─────────────────────────────────────────┘   │
-│                                                 │
-│  🎨 Multi-modal AI at your fingertips          │
-│                                                 │
-╰─────────────────────────────────────────────────╯
-```
-
-**Border**: Google blue (#4285F4)
-**Text**: Light gray (#E8EAED)
-**Background**: Pure black (#0D0D0D)
-**Accent**: Google red/pink (#EA4335)
-
-**Best for**: Developers who love modern, colorful interfaces
-
-![Gemini Theme](docs/visuals/gemini_theme.png)
-
----
-
-### Codex Theme
-
-**Primary Color**: `#10A37F` (OpenAI Teal)
-
-**Visual Characteristics**:
-- Neutral temperature
-- Clean, technical lines
-- Minimal design
-- Code-first focus
-
-**Example UI**:
-```
-╭─────────────────────────────────────────────────╮
-│                                                 │
-│  ⚡ Codex                                       │
-│                                                 │
-│  Let's build something extraordinary            │
-│                                                 │
-│  ┌─────────────────────────────────────────┐   │
-│  │ Enter your coding task...               │   │
-│  └─────────────────────────────────────────┘   │
-│                                                 │
-│  🔧 Professional AI pair programming           │
-│                                                 │
-╰─────────────────────────────────────────────────╯
-```
-
-**Border**: OpenAI teal (#10A37F)
-**Text**: Off-white (#ECECEC)
-**Background**: Almost black (#0E0E0E)
-
-**Best for**: Developers who value precision and professionalism
-
-![Codex Theme](docs/visuals/codex_theme.png)
-
----
-
-### Qwen Theme
-
-**Primary Color**: `#FF6A00` (Alibaba Orange)
-
-**Visual Characteristics**:
-- Warm temperature
-- Modern, clean lines
-- International design
-- Elegant aesthetic
-
-**Example UI**:
-```
-╭─────────────────────────────────────────────────╮
-│                                                 │
-│  🌟 Qwen                                        │
-│                                                 │
-│  Ready to innovate together                     │
-│                                                 │
-│  ┌─────────────────────────────────────────┐   │
-│  │ What shall we create today?             │   │
-│  └─────────────────────────────────────────┘   │
-│                                                 │
-│  🚀 Advanced AI from Alibaba Cloud             │
-│                                                 │
-╰─────────────────────────────────────────────────╯
-```
-
-**Border**: Alibaba orange (#FF6A00)
-**Text**: Warm off-white (#F0E8DC)
-**Background**: Warm black (#161410)
-
-**Best for**: Developers who appreciate modern, international design
-
-![Qwen Theme](docs/visuals/qwen_theme.png)
-
----
-
-## Animated Examples
-
-### Theme Switching Animation
-
-Watch how themes smoothly transition when you press Tab:
-
-![Theme Switching](docs/visuals/theme_comparison.gif)
-
-**Animation Details**:
-- Duration: 200-300ms
-- Easing: Ease-in-out
-- No layout shift
-- Smooth color interpolation
-
-### Typing Indicator
-
-Each provider has a unique typing indicator:
-
-**Claude**: `Thinking...` (dots animation)
-**Gemini**: `Thinking...` (gradient animation)
-**Codex**: `Processing...` (dots animation)
-**Qwen**: `Thinking...` (dots animation)
-
-### Loading Spinners
-
-Provider-specific spinners:
-
-**Claude**: `⣾⣽⣻⢿⡿⣟⣯⣷` (Braille dots)
-**Gemini**: `◐◓◑◒` (Rotating circle)
-**Codex**: `⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏` (Line spinner)
-**Qwen**: `⣾⣽⣻⢿⡿⣟⣯⣷` (Braille dots)
-
----
-
-## Side-by-Side Comparisons
-
-### Color Palettes
-
-```
-┌─ CLAUDE ────────┬─ GEMINI ────────┬─ CODEX ─────────┬─ QWEN ──────────┐
-│ 🟠 #D4754C      │ 🔵 #4285F4      │ 🟢 #10A37F      │ 🟠 #FF6A00      │
-│ Primary         │ Primary         │ Primary         │ Primary         │
-│                 │                 │                 │                 │
-│ 🟤 #E8D5C4      │ ⚪ #E8EAED      │ ⚪ #ECECEC      │ 🟤 #F0E8DC      │
-│ Text            │ Text            │ Text            │ Text            │
-│                 │                 │                 │                 │
-│ 🟫 #1A1816      │ ⬛ #0D0D0D      │ ⬛ #0E0E0E      │ 🟫 #161410      │
-│ Background      │ Background      │ Background      │ Background      │
-└─────────────────┴─────────────────┴─────────────────┴─────────────────┘
-```
-
-### Border Styles
-
-All themes use rounded borders, but with different colors:
-
-```
-Claude:  ╭───────────╮  (Copper orange)
-         │           │
-         ╰───────────╯
-
-Gemini:  ╭───────────╮  (Google blue)
-         │           │
-         ╰───────────╯
-
-Codex:   ╭───────────╮  (OpenAI teal)
-         │           │
-         ╰───────────╯
-
-Qwen:    ╭───────────╮  (Alibaba orange)
-         │           │
-         ╰───────────╯
-```
-
-### Status Colors
-
-```
-Success Colors:
-Claude:  ✓ #6FA86F  (Muted green)
-Gemini:  ✓ #34A853  (Google green)
-Codex:   ✓ #10A37F  (Uses primary)
-Qwen:    ✓ #52C41A  (Chinese green)
-
-Error Colors:
-Claude:  ✗ #D47C7C  (Warm red)
-Gemini:  ✗ #EA4335  (Google red)
-Codex:   ✗ #EF4444  (Clean red)
-Qwen:    ✗ #FF4D4F  (Chinese red)
-
-Warning Colors:
-Claude:  ⚠ #E8A968  (Warm amber)
-Gemini:  ⚠ #FBBC04  (Google yellow)
-Codex:   ⚠ #F59E0B  (Amber)
-Qwen:    ⚠ #FAAD14  (Chinese gold)
-```
-
----
-
-## Component Examples
-
-### Chat Message Bubbles
-
-**Claude Theme**:
-```
-╭──────────────────────────────────────╮
-│ You said:                            │
-│ How do I create a React component?  │
-╰──────────────────────────────────────╯
-
-┌────────────────────────────────────────┐
-│ Claude:                                │
-│                                        │
-│ I'll help you create a React          │
-│ component. Here's a simple example... │
-└────────────────────────────────────────┘
-```
-(Border: #D4754C, Text: #E8D5C4, Background: #1A1816)
-
-**Gemini Theme**:
-```
-╭──────────────────────────────────────╮
-│ You said:                            │
-│ Explain async/await in JavaScript   │
-╰──────────────────────────────────────╯
-
-┌────────────────────────────────────────┐
-│ Gemini:                                │
-│                                        │
-│ Async/await is a modern way to        │
-│ handle asynchronous operations...     │
-└────────────────────────────────────────┘
-```
-(Border: #4285F4, Text: #E8EAED, Background: #0D0D0D)
-
-### Progress Bars
-
-**Claude**: `[████████████████████░░░░░░░░░░░░░░░░░░░░] 50%`
-(Filled: #D4754C, Empty: #4A3F38)
-
-**Gemini**: `[████████████████████░░░░░░░░░░░░░░░░░░░░] 50%`
-(Filled: #4285F4, Empty: #2A2A45)
-
-**Codex**: `[████████████████████░░░░░░░░░░░░░░░░░░░░] 50%`
-(Filled: #10A37F, Empty: #2D3D38)
-
-**Qwen**: `[████████████████████░░░░░░░░░░░░░░░░░░░░] 50%`
-(Filled: #FF6A00, Empty: #3A352C)
-
-### Status Indicators
-
-**Success**:
-```
-Claude:  ✓ Build successful
-Gemini:  ✓ Tests passed
-Codex:   ✓ Code compiled
-Qwen:    ✓ Deployment complete
-```
-
-**Error**:
-```
-Claude:  ✗ Compilation failed
-Gemini:  ✗ Test failed
-Codex:   ✗ Syntax error
-Qwen:    ✗ Connection error
-```
-
-**Warning**:
-```
-Claude:  ⚠ Deprecated API
-Gemini:  ⚠ Rate limit approaching
-Codex:   ⚠ Memory usage high
-Qwen:    ⚠ Update available
-```
-
----
-
-## Dark Mode Only
-
-RyCode themes are designed exclusively for dark mode to:
-- Reduce eye strain during extended coding sessions
-- Match modern developer preferences
-- Provide optimal contrast for code readability
-- Align with terminal aesthetic
-
-**Why dark mode?**
-- 70%+ of developers prefer dark themes
-- Better for low-light environments
-- Reduces screen brightness/glare
-- Industry standard for CLI tools
-
----
-
-## Accessibility
-
-All themes meet WCAG 2.1 AA standards:
-
-**Text Contrast** (12-16:1):
-- Claude: 12.43:1 ✓
-- Gemini: 16.13:1 ✓
-- Codex: 16.34:1 ✓
-- Qwen: 15.14:1 ✓
-
-**UI Element Contrast** (3.0:1+):
-- All themes: 3.5-6:1 ✓
-
-**Color Blind Friendly**:
-- High contrast compensates for color perception
-- Status indicators use brightness differences
-- Multiple visual cues beyond color alone
-
----
-
-## Performance
-
-**Visual Update Times**:
-- Theme switch: 317ns (imperceptible)
-- Color retrieval: 6ns
-- Layout: 0ms (no reflow)
-
-**Animation**:
-- 60fps smooth transitions
-- No flicker or jank
-- Minimal CPU usage
-
----
-
-## Creating Your Own Screenshots
-
-### Manual Screenshots
-
-1. Launch RyCode:
-   ```bash
-   ./rycode
-   ```
-
-2. Press Tab to switch to desired theme
-
-3. Take screenshot:
-   - macOS: Cmd+Shift+4, select area
-   - Linux: Use `gnome-screenshot` or `scrot`
-
-4. Crop to show just the TUI
-
-### Automated Screenshots (VHS)
-
-Create a `.tape` file:
-
-```tape
-Output my_screenshot.png
-
-Set FontSize 14
-Set Width 1200
-Set Height 800
-Set Theme "dark"
-
-Type "rycode"
-Enter
-Sleep 1s
-Type "Tab"
-Sleep 500ms
-Screenshot my_screenshot.png
-```
-
-Run with:
-```bash
-vhs my_screenshot.tape
-```
-
----
-
-## Contributing Visual Examples
-
-We welcome contributions of:
-- Screenshots of RyCode in action
-- GIFs showing workflows
-- Comparison images with other tools
-- Custom theme visualizations
-
-**Submit via**:
-1. Add to `packages/tui/docs/visuals/`
-2. Update this document with new examples
-3. Submit PR with clear description
-
-**Guidelines**:
-- Use 1200x800 or larger
-- Show clear, readable text
-- Include context (what's being demonstrated)
-- Optimize GIFs (< 5MB)
-- Use high-quality PNG for static images
-
----
-
-## Resources
-
-- **Generate Script**: `scripts/generate_theme_visuals.sh`
-- **VHS**: https://github.com/charmbracelet/vhs
-- **Theme Docs**: `VISUAL_DESIGN_SYSTEM.md`
-- **API Reference**: `THEME_API_REFERENCE.md`
-
----
-
-## Gallery
-
-Visit our online gallery to see all themes in action:
-
-- **Documentation**: https://rycode.ai/docs/themes
-- **GitHub**: https://github.com/aaronmrosenthal/RyCode/tree/main/packages/tui/docs/visuals
-
----
-
-**Show, don't just tell.** Visual examples make concepts instantly clear and help users choose their preferred aesthetic before they start coding.
diff --git a/packages/tui/VISUAL_TESTING_STRATEGY.md b/packages/tui/VISUAL_TESTING_STRATEGY.md
deleted file mode 100644
index ea06499c..00000000
--- a/packages/tui/VISUAL_TESTING_STRATEGY.md
+++ /dev/null
@@ -1,474 +0,0 @@
-# Visual Testing Strategy for Provider Themes
-
-**Status**: Design Document
-**Phase**: 3.3 - Visual Regression Testing
-**Date**: October 14, 2025
-
----
-
-## Overview
-
-Visual regression testing for RyCode TUI themes requires a different approach than web applications. Since we're rendering in a terminal, we need terminal-specific capture and comparison tools.
-
----
-
-## Testing Approach
-
-### 1. Terminal Screenshot Capture
-
-**Tools Available:**
-- **VHS** (by Charm) - Terminal recorder/screenshot tool
-- **ttyrec** - Terminal session recorder
-- **asciinema** - Terminal session recorder with playback
-- **Script/Scriptreplay** - Built-in Unix terminal recording
-
-**Recommended: VHS (Charm)**
-- Already in RyCode ecosystem (Charm tools)
-- Creates GIF/PNG screenshots
-- Supports automated test scenarios
-- Can capture specific frames
-- Integrates well with our TUI stack
-
-### 2. Visual Comparison Strategy
-
-**Approach A: Pixel-Perfect Comparison**
-```bash
-# Capture screenshots for each theme
-vhs capture-claude.tape
-vhs capture-gemini.tape
-vhs capture-codex.tape
-vhs capture-qwen.tape
-
-# Compare with reference images
-compare reference/claude.png output/claude.png diff/claude-diff.png
-```
-
-**Pros:**
-- Exact visual verification
-- Catches all rendering changes
-- Easy to automate
-
-**Cons:**
-- Sensitive to font rendering differences
-- Terminal size must be exact
-- OS-specific rendering variations
-
-**Approach B: Color Sampling Verification**
-```go
-// Sample key UI elements and verify colors
-func TestThemeColors(t *testing.T) {
-    theme.SwitchToProvider("claude")
-
-    // Verify border color at specific location
-    borderColor := capturePixelAt(50, 10)
-    assert.Equal(t, "#D4754C", hexColor(borderColor))
-
-    // Verify text color
-    textColor := capturePixelAt(60, 15)
-    assert.Equal(t, "#E8D5C4", hexColor(textColor))
-}
-```
-
-**Pros:**
-- Less sensitive to minor rendering differences
-- Focuses on actual theme colors
-- Works across different terminals
-
-**Cons:**
-- Doesn't catch layout issues
-- More complex to implement
-
-**Approach C: ASCII Art Hash Comparison**
-```go
-// Capture terminal output as text
-func TestThemeLayout(t *testing.T) {
-    output := captureTerminalText()
-
-    // Generate hash of structure (ignore colors)
-    hash := structuralHash(stripAnsi(output))
-
-    // Compare with reference
-    assert.Equal(t, referenceHash, hash)
-}
-```
-
-**Pros:**
-- Font-independent
-- Terminal-independent
-- Focuses on structure
-
-**Cons:**
-- Doesn't verify actual colors
-- May miss visual regressions
-
----
-
-## Recommended Implementation
-
-### Phase 3.3A: Color Verification Tests
-
-Create automated tests that verify theme colors are applied correctly.
-
-**Test File**: `test_theme_visual.go`
-
-```go
-package main
-
-import (
-    "testing"
-    "github.com/aaronmrosenthal/rycode/internal/theme"
-    "github.com/stretchr/testify/assert"
-)
-
-func TestClaudeThemeColors(t *testing.T) {
-    theme.SwitchToProvider("claude")
-    t := theme.CurrentTheme()
-
-    // Verify primary colors
-    assert.Equal(t, "#D4754C", extractHex(t.Primary()))
-    assert.Equal(t, "#E8D5C4", extractHex(t.Text()))
-    assert.Equal(t, "#1A1816", extractHex(t.Background()))
-}
-
-func TestGeminiThemeColors(t *testing.T) {
-    theme.SwitchToProvider("gemini")
-    t := theme.CurrentTheme()
-
-    assert.Equal(t, "#4285F4", extractHex(t.Primary()))
-    assert.Equal(t, "#E8EAED", extractHex(t.Text()))
-    assert.Equal(t, "#0D0D0D", extractHex(t.Background()))
-}
-
-// ... tests for Codex and Qwen
-```
-
-### Phase 3.3B: Manual Visual Verification
-
-Create `.tape` files for manual review:
-
-**File**: `visual-tests/claude-theme.tape`
-```tape
-Output claude-theme.gif
-
-Set Theme "claude"
-Set FontSize 14
-Set Width 1200
-Set Height 800
-
-Type "rycode"
-Enter
-Sleep 1s
-
-# Switch to Claude theme
-Type "Tab"
-Sleep 500ms
-
-# Show chat with Claude colors
-Type "Hello from Claude theme"
-Enter
-Sleep 2s
-
-Screenshot claude-theme.png
-```
-
-**Benefits:**
-- Visual review by humans
-- Can be run locally or in CI
-- Creates artifacts for documentation
-- Shows actual user experience
-
-### Phase 3.3C: Reference Screenshot Comparison
-
-**Directory Structure:**
-```
-visual-tests/
-├── tapes/
-│   ├── claude-theme.tape
-│   ├── gemini-theme.tape
-│   ├── codex-theme.tape
-│   └── qwen-theme.tape
-├── reference/
-│   ├── claude-theme.png
-│   ├── gemini-theme.png
-│   ├── codex-theme.png
-│   └── qwen-theme.png
-└── output/
-    ├── claude-theme.png
-    ├── gemini-theme.png
-    ├── codex-theme.png
-    └── qwen-theme.png
-```
-
-**CI Script:**
-```bash
-#!/bin/bash
-# visual-tests/run-visual-tests.sh
-
-echo "Running visual regression tests..."
-
-# Generate screenshots
-for theme in claude gemini codex qwen; do
-    vhs visual-tests/tapes/${theme}-theme.tape
-    mv ${theme}-theme.png visual-tests/output/
-done
-
-# Compare with references
-for theme in claude gemini codex qwen; do
-    compare -metric AE \
-        visual-tests/reference/${theme}-theme.png \
-        visual-tests/output/${theme}-theme.png \
-        visual-tests/diff/${theme}-diff.png 2>&1 | \
-        tee visual-tests/diff/${theme}-result.txt
-done
-
-echo "Visual tests complete. Check diff/ directory."
-```
-
----
-
-## Native CLI Comparison
-
-### Capturing Reference Screenshots
-
-**Claude Code:**
-```bash
-# Launch Claude Code
-claude-code
-
-# Wait for full render
-sleep 2
-
-# Capture screenshot
-screencapture -R x,y,w,h claude-code-reference.png
-```
-
-**Gemini CLI:**
-```bash
-# Launch Gemini
-gemini
-
-# Capture
-screencapture -R x,y,w,h gemini-cli-reference.png
-```
-
-**Comparison Strategy:**
-1. Place native CLI and RyCode side-by-side
-2. Verify color matching visually
-3. Use color picker to sample exact RGB values
-4. Document any intentional differences
-
----
-
-## Automated Testing Approach
-
-### Option 1: VHS-Based CI Tests
-
-```yaml
-# .github/workflows/visual-tests.yml
-name: Visual Regression Tests
-
-on: [push, pull_request]
-
-jobs:
-  visual-tests:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-
-      - name: Install VHS
-        run: |
-          go install github.com/charmbracelet/vhs@latest
-
-      - name: Run visual tests
-        run: |
-          cd packages/tui/visual-tests
-          ./run-visual-tests.sh
-
-      - name: Upload screenshots
-        uses: actions/upload-artifact@v3
-        with:
-          name: visual-test-results
-          path: visual-tests/output/
-
-      - name: Upload diffs
-        if: failure()
-        uses: actions/upload-artifact@v3
-        with:
-          name: visual-test-diffs
-          path: visual-tests/diff/
-```
-
-### Option 2: Color Verification Tests
-
-```go
-// test_theme_visual_verification.go
-package main
-
-import (
-    "fmt"
-    "testing"
-    "github.com/aaronmrosenthal/rycode/internal/theme"
-)
-
-type ColorTest struct {
-    Provider string
-    Element  string
-    Expected string
-}
-
-var colorTests = []ColorTest{
-    // Claude
-    {"claude", "Primary", "#D4754C"},
-    {"claude", "Text", "#E8D5C4"},
-    {"claude", "Background", "#1A1816"},
-
-    // Gemini
-    {"gemini", "Primary", "#4285F4"},
-    {"gemini", "Text", "#E8EAED"},
-    {"gemini", "Background", "#0D0D0D"},
-
-    // Codex
-    {"codex", "Primary", "#10A37F"},
-    {"codex", "Text", "#ECECEC"},
-    {"codex", "Background", "#0E0E0E"},
-
-    // Qwen
-    {"qwen", "Primary", "#FF6A00"},
-    {"qwen", "Text", "#F0E8DC"},
-    {"qwen", "Background", "#161410"},
-}
-
-func TestThemeColorAccuracy(t *testing.T) {
-    for _, test := range colorTests {
-        theme.SwitchToProvider(test.Provider)
-        th := theme.CurrentTheme()
-
-        var actual string
-        switch test.Element {
-        case "Primary":
-            actual = colorToHex(th.Primary())
-        case "Text":
-            actual = colorToHex(th.Text())
-        case "Background":
-            actual = colorToHex(th.Background())
-        }
-
-        if actual != test.Expected {
-            t.Errorf("%s %s: expected %s, got %s",
-                test.Provider, test.Element, test.Expected, actual)
-        }
-    }
-}
-```
-
----
-
-## Testing Checklist
-
-### Manual Visual Review
-- [ ] Claude theme matches Claude Code aesthetics
-- [ ] Gemini theme matches Gemini CLI aesthetics
-- [ ] Codex theme matches OpenAI Codex aesthetics
-- [ ] Qwen theme matches Qwen CLI aesthetics
-- [ ] Theme switching is smooth (no flicker)
-- [ ] Colors are consistent across UI elements
-- [ ] Text is readable in all themes
-- [ ] Borders are clearly visible
-- [ ] Status colors (success, error, warning) are distinct
-
-### Automated Tests
-- [ ] All theme colors match specifications
-- [ ] Theme switching doesn't corrupt colors
-- [ ] UI elements use correct theme colors
-- [ ] Screenshots match reference images (within tolerance)
-- [ ] No color bleeding between themes
-- [ ] Typography remains consistent
-- [ ] Layout is preserved across themes
-
-### Performance
-- [ ] Visual tests run in <30 seconds
-- [ ] Screenshots are deterministic (same output each run)
-- [ ] No memory leaks during screenshot capture
-- [ ] CI integration doesn't timeout
-
----
-
-## Success Criteria
-
-### Visual Accuracy
-- ✅ All colors match specification within 5% tolerance
-- ✅ Theme switching shows correct colors immediately
-- ✅ No visual artifacts or glitches
-- ✅ Consistent rendering across terminals
-
-### Testing Coverage
-- ✅ All 4 provider themes tested
-- ✅ Key UI elements verified (borders, text, status)
-- ✅ Both automated and manual verification
-- ✅ CI integration for regression detection
-
-### Documentation
-- ✅ Reference screenshots captured
-- ✅ Testing process documented
-- ✅ Failure investigation guide
-- ✅ Maintenance procedures
-
----
-
-## Implementation Priority
-
-### Phase 3.3A: Color Verification (High Priority) ✅
-**Status**: Can implement immediately
-**Effort**: 2-3 hours
-**Value**: High - catches color regressions
-
-### Phase 3.3B: VHS Manual Review (Medium Priority)
-**Status**: Requires VHS setup
-**Effort**: 4-6 hours
-**Value**: Medium - good for documentation
-
-### Phase 3.3C: Screenshot Comparison (Lower Priority)
-**Status**: Requires ImageMagick + VHS
-**Effort**: 8-10 hours
-**Value**: Medium - pixel-perfect verification
-
----
-
-## Recommended Next Steps
-
-1. **Implement Color Verification Tests** (Phase 3.3A)
-   - Quick to build
-   - High value
-   - No external dependencies
-   - Can run in CI immediately
-
-2. **Create Reference Documentation**
-   - Manual screenshots of each theme
-   - Side-by-side comparison with native CLIs
-   - Document intentional differences
-
-3. **CI Integration**
-   - Add color tests to pre-push hooks
-   - Run on every PR
-   - Block merges on color regression
-
-4. **Future Enhancement**
-   - Full VHS-based screenshot testing
-   - Automated comparison pipeline
-   - Visual regression dashboard
-
----
-
-## Conclusion
-
-Visual testing for TUI applications requires a different approach than web apps. We recommend starting with **automated color verification tests** (Phase 3.3A) as they provide immediate value with minimal setup.
-
-Full screenshot-based testing (Phase 3.3B/C) is valuable but requires more infrastructure. We can add this incrementally as needed.
-
-**Key Insight**: Our themes are already verified for accessibility (48/48 tests) and performance (317ns switching). Color verification tests will ensure visual accuracy is maintained over time.
-
----
-
-**Implementation Status**: Design Complete ✅
-
-**Next Action**: Build color verification test suite
diff --git a/packages/tui/WEEK_4_SUMMARY.md b/packages/tui/WEEK_4_SUMMARY.md
deleted file mode 100644
index 99df27da..00000000
--- a/packages/tui/WEEK_4_SUMMARY.md
+++ /dev/null
@@ -1,528 +0,0 @@
-# Week 4 Summary: Cross-Platform Testing & Quality Assurance
-
-> **Goal:** Ensure splash screen works reliably across all platforms and terminal types
-
----
-
-## 📊 Week 4 Achievements
-
-### ✅ Completed Tasks
-
-**1. Comprehensive Test Suite**
-- Created 31 passing unit tests
-- **5 test files** covering all major modules
-- Coverage increased from **19.1% → 54.2%** (184% improvement!)
-- All tests passing ✅
-
-**2. Test Files Created**
-- ✅ `config_test.go` - Configuration system tests (5 tests, 165 lines)
-- ✅ `terminal_test.go` - Terminal detection tests (9 tests, 229 lines)
-- ✅ `fallback_test.go` - Fallback rendering tests (7 tests, 220 lines)
-- ✅ Existing: `ansi_test.go` (5 tests, 105 lines)
-- ✅ Existing: `cortex_test.go` (5 tests, 116 lines)
-
-**3. Test Documentation**
-- ✅ `SPLASH_TESTING.md` - Complete testing guide (650 lines)
-  - Test organization and structure
-  - Running tests and coverage reports
-  - Manual testing checklist
-  - Platform-specific considerations
-  - Best practices and patterns
-  - Performance benchmarks
-
-**4. Code Quality Improvements**
-- ✅ Made `getConfigPath` and `getMarkerPath` testable (variable functions)
-- ✅ All tests use proper isolation (temp directories)
-- ✅ Environment variable tests restore original values
-- ✅ Table-driven test patterns throughout
-
-**5. Build Verification**
-- ✅ Binary builds successfully
-- ✅ All flags working (`--splash`, `--no-splash`)
-- ✅ No regressions introduced
-
----
-
-## 📈 Coverage Breakdown
-
-### Overall Coverage: 54.2% ✅
-
-| Module | Coverage | Tests | Status |
-|--------|----------|-------|--------|
-| `ansi.go` | ~80% | 5 | ✅ Excellent |
-| `config.go` | ~90% | 5 | ✅ Excellent |
-| `cortex.go` | ~60% | 5 | ✅ Good |
-| `terminal.go` | ~70% | 9 | ✅ Good |
-| `fallback.go` | ~75% | 7 | ✅ Good |
-| `splash.go` | ~30% | - | ⚠️ Limited (Bubble Tea) |
-| `bootsequence.go` | ~20% | - | ⚠️ Limited (Animation) |
-| `closer.go` | ~20% | - | ⚠️ Limited (Animation) |
-
-**Why Some Modules Have Lower Coverage:**
-- Bubble Tea models (`splash.go`) are hard to unit test
-- Require full TUI context and terminal events
-- Better tested via integration/manual testing
-- Animation sequences are visual and timing-dependent
-
----
-
-## 🧪 Test Categories
-
-### 1. Color System Tests (`ansi_test.go`)
-**Coverage:** ~80%
-**Tests:**
-- Basic text colorization
-- Gradient color interpolation (cyan → magenta)
-- RGB linear interpolation
-- ANSI escape code formatting
-- Reset codes
-
-**Key Validations:**
-- ✅ ANSI codes format correctly
-- ✅ Gradient colors interpolate smoothly
-- ✅ RGB values stay in valid range [0, 255]
-
----
-
-### 2. Configuration Tests (`config_test.go`)
-**Coverage:** ~90%
-**Tests:**
-- Default configuration values
-- ShouldShowSplash logic (5 scenarios)
-- Config save and load
-- First-run detection
-- Disable permanently function
-
-**Scenarios Tested:**
-1. ✅ Splash disabled in config
-2. ✅ Reduced motion enabled
-3. ✅ First run detection
-4. ✅ Always frequency mode
-5. ✅ Never frequency mode
-
-**Testing Pattern:**
-```go
-// Isolate file system with temp dirs
-tmpDir := t.TempDir()
-configPath := filepath.Join(tmpDir, "config.json")
-
-// Override config path for testing
-originalGetConfigPath := getConfigPath
-getConfigPath = func() string { return configPath }
-defer func() { getConfigPath = originalGetConfigPath }()
-```
-
----
-
-### 3. 3D Rendering Tests (`cortex_test.go`)
-**Coverage:** ~60%
-**Tests:**
-- Torus parametric equations
-- Z-buffer depth sorting
-- Render frame without panic
-- Rainbow mode rendering
-- Rotation angle updates
-
-**Math Validated:**
-```
-Torus parametric equations:
-  x(θ,φ) = (R + r·cos(φ))·cos(θ)
-  y(θ,φ) = (R + r·cos(φ))·sin(θ)
-  z(θ,φ) = r·sin(φ)
-
-Where:
-  R = 2 (major radius)
-  r = 1 (minor radius)
-  θ, φ ∈ [0, 2π]
-```
-
-**Performance:**
-- ✅ 10 frames render in ~0.03s
-- ✅ ~0.003s per frame
-- ✅ Well under 30 FPS target (0.033s)
-
----
-
-### 4. Terminal Detection Tests (`terminal_test.go`)
-**Coverage:** ~70%
-**Tests:**
-- Color mode detection (4 scenarios)
-- Unicode support detection (3 scenarios)
-- Full capability detection
-- Skip splash logic (3 scenarios)
-- ColorMode string representation
-- Performance estimation
-
-**Environment Variables Tested:**
-```bash
-COLORTERM=truecolor    # Forces truecolor
-TERM=xterm-256color    # 256-color support
-NO_COLOR=1             # Disable colors
-LANG=en_US.UTF-8       # Unicode support
-SSH_CONNECTION=...     # Remote session
-WT_SESSION=...         # Windows Terminal
-TERM_PROGRAM=iTerm.app # iTerm2
-```
-
-**Key Validations:**
-- ✅ COLORTERM=truecolor → Truecolor mode
-- ✅ TERM=xterm-256color → Colors256 mode
-- ✅ NO_COLOR → Colors16 mode
-- ✅ Terminal size < 60×20 → Skip splash
-
----
-
-### 5. Fallback Rendering Tests (`fallback_test.go`)
-**Coverage:** ~75%
-**Tests:**
-- Text-only splash creation
-- Text-only rendering
-- Text centering (3 scenarios)
-- ANSI code stripping (4 scenarios)
-- Simplified splash creation
-- Simplified rendering
-- Static closer screen
-- Centering with ANSI colors
-- Small terminal handling
-
-**Key Algorithms Tested:**
-
-**Centering:**
-```go
-visibleLen := len(stripANSI(text))
-padding := (width - visibleLen) / 2
-return strings.Repeat(" ", padding) + text
-```
-
-**ANSI Stripping:**
-```go
-// Removes: \033[...m
-// Example: "\033[38;2;255;0;0mRed\033[0m" → "Red"
-```
-
----
-
-## 🎯 Testing Highlights
-
-### Test Quality Metrics
-- ✅ **31 tests, 100% passing**
-- ✅ **54.2% code coverage** (target: >50%)
-- ✅ **Zero test failures**
-- ✅ **<1 second execution time**
-- ✅ **No flaky tests**
-
-### Code Quality Improvements
-1. **Refactored for testability:**
-   - Made functions variable for mocking
-   - Added dependency injection where needed
-   - Isolated file system operations
-
-2. **Comprehensive scenarios:**
-   - Normal cases ✅
-   - Edge cases ✅
-   - Error conditions ✅
-   - Platform variations ✅
-
-3. **Documentation:**
-   - 650-line testing guide
-   - Clear examples
-   - Best practices
-   - Troubleshooting
-
----
-
-## 🛠️ Code Changes This Week
-
-### Modified Files
-
-**1. config.go** - Made functions testable
-```go
-// Before: func getConfigPath() string { ... }
-// After:  var getConfigPath = func() string { ... }
-
-// Allows tests to override:
-getConfigPath = func() string { return "/tmp/test-config.json" }
-```
-
-**2. Created Test Files**
-- ✅ `config_test.go` (165 lines)
-- ✅ `terminal_test.go` (229 lines)
-- ✅ `fallback_test.go` (220 lines)
-
-**3. Created Documentation**
-- ✅ `SPLASH_TESTING.md` (650 lines)
-- ✅ `WEEK_4_SUMMARY.md` (this file)
-
-### No Breaking Changes
-- ✅ All existing functionality preserved
-- ✅ Binary builds successfully
-- ✅ Command-line flags work
-- ✅ Splash screen renders correctly
-
----
-
-## 🏗️ Build Status
-
-### Successful Build
-```bash
-$ go build -o /tmp/rycode-week4-test ./cmd/rycode
-# ✅ Success - no errors
-
-$ /tmp/rycode-week4-test --help
-Usage of /tmp/rycode-week4-test:
-      --agent string     agent to begin with
-      --model string     model to begin with
-      --no-splash        skip splash screen  # ✅ New flag
-      --prompt string    prompt to begin with
-      --session string   session ID
-      --splash           force show splash screen  # ✅ New flag
-```
-
-### Test Execution
-```bash
-$ go test ./internal/splash -v
-# ✅ All 31 tests passing
-
-$ go test ./internal/splash -cover
-# ✅ Coverage: 54.2% of statements
-```
-
----
-
-## 📋 Manual Testing Checklist
-
-### ✅ Tested on macOS ARM64 (M1/M2/M3)
-- [x] Splash shows on first run
-- [x] Splash respects "first" frequency
-- [x] --splash flag forces display
-- [x] --no-splash flag skips
-- [x] Easter eggs work ('?', Konami code)
-- [x] Config save/load works
-- [x] ESC disables permanently
-- [x] Performance excellent (30 FPS)
-
-### ⏳ Pending Platform Tests
-- [ ] macOS Intel (AMD64)
-- [ ] Linux AMD64
-- [ ] Linux ARM64 (Raspberry Pi)
-- [ ] Windows AMD64 (Windows Terminal)
-- [ ] Windows AMD64 (CMD.exe)
-- [ ] Windows AMD64 (PowerShell)
-
-### ⏳ Pending Terminal Tests
-- [ ] iTerm2 (macOS)
-- [ ] Terminal.app (macOS)
-- [ ] Windows Terminal (Windows)
-- [ ] Alacritty (cross-platform)
-- [ ] Kitty (Linux/macOS)
-- [ ] GNOME Terminal (Linux)
-- [ ] xterm (Linux)
-
----
-
-## 🚀 Performance Benchmarks
-
-### Rendering Performance
-- **Frame time:** 0.318ms per frame
-- **Target:** 33ms per frame (30 FPS)
-- **Margin:** 85× faster than target ✅
-- **Adaptive FPS:** Drops to 15 FPS on slow systems
-
-### Memory Usage
-- **Startup:** ~2MB for splash state
-- **Target:** <10MB
-- **Status:** ✅ Well under target
-
-### Build Size
-- **Binary size:** ~15MB (with all dependencies)
-- **Splash overhead:** <100KB
-- **Impact:** Negligible
-
----
-
-## 📚 Documentation Created
-
-### 1. SPLASH_TESTING.md (650 lines)
-**Sections:**
-- Test Coverage Summary
-- Running Tests
-- Test Organization
-- Coverage By Module
-- Manual Testing Checklist
-- Known Issues
-- Testing Best Practices
-- Performance Benchmarks
-- Test Maintenance
-- Resources
-
-**Audience:** Developers, contributors, QA engineers
-
----
-
-### 2. WEEK_4_SUMMARY.md (This File)
-**Sections:**
-- Week 4 Achievements
-- Coverage Breakdown
-- Test Categories
-- Testing Highlights
-- Code Changes
-- Build Status
-- Manual Testing Checklist
-- Performance Benchmarks
-- Next Steps
-
-**Audience:** Project stakeholders, team leads
-
----
-
-## 🎓 Lessons Learned
-
-### What Went Well
-1. **Test-Driven Approach:**
-   - Writing tests early caught issues
-   - Refactored code for better testability
-   - High confidence in code quality
-
-2. **Coverage Metrics:**
-   - 54.2% coverage is excellent for Week 4
-   - Focused on critical paths first
-   - Easy to add more tests later
-
-3. **Documentation:**
-   - Comprehensive testing guide helps contributors
-   - Clear examples make tests maintainable
-   - Manual checklist ensures nothing missed
-
-### Challenges
-1. **Bubble Tea Testing:**
-   - Hard to unit test TUI models
-   - Requires integration testing approach
-   - Accepted lower coverage for view layer
-
-2. **Platform Variations:**
-   - Can't test all platforms on single machine
-   - Need CI/CD for cross-platform testing
-   - Manual testing required for validation
-
-3. **Animation Testing:**
-   - Timing-dependent code is hard to test
-   - Visual validation needed
-   - Regression testing challenging
-
----
-
-## 🔮 Next Steps (Week 5)
-
-### Remaining Week 4 Tasks
-1. **Cross-Platform Testing** (High Priority)
-   - [ ] Test on macOS Intel
-   - [ ] Test on Linux AMD64
-   - [ ] Test on Linux ARM64 (Raspberry Pi)
-   - [ ] Test on Windows AMD64
-   - [ ] Document platform-specific issues
-
-2. **Windows-Specific Handling** (Medium Priority)
-   - [ ] Add Windows Terminal detection
-   - [ ] Handle CMD.exe limitations
-   - [ ] Test PowerShell compatibility
-   - [ ] Add Windows fallback mode if needed
-
-3. **Low-End System Optimization** (Medium Priority)
-   - [ ] Test on Raspberry Pi 3/4
-   - [ ] Verify adaptive FPS works
-   - [ ] Optimize memory usage if needed
-   - [ ] Add performance monitoring
-
-### Week 5 Goals (Launch Prep)
-1. **Final Polish**
-   - [ ] Review all documentation
-   - [ ] Create demo video/GIF
-   - [ ] Write release notes
-   - [ ] Update README with splash info
-
-2. **Integration**
-   - [ ] Ensure smooth TUI transition
-   - [ ] Test with real RyCode server
-   - [ ] Verify all models render correctly
-   - [ ] Check performance with API calls
-
-3. **Launch**
-   - [ ] Merge to main branch
-   - [ ] Tag release
-   - [ ] Announce splash screen
-   - [ ] Gather user feedback
-
----
-
-## 📊 Week 4 Statistics
-
-### Code Written
-- **Production code:** 0 lines (Week 4 = testing)
-- **Test code:** 614 lines (3 new test files)
-- **Documentation:** 1,300 lines (2 docs)
-- **Total new lines:** 1,914 lines
-
-### Tests
-- **Tests added:** 21 new tests (10 → 31)
-- **Tests passing:** 31/31 (100%)
-- **Coverage improvement:** +35.1% (19.1% → 54.2%)
-
-### Time Investment
-- **Test writing:** ~3 hours
-- **Documentation:** ~2 hours
-- **Debugging/fixing:** ~1 hour
-- **Total:** ~6 hours
-
-### Quality Metrics
-- ✅ Zero bugs found in existing code
-- ✅ No regressions introduced
-- ✅ All features working as designed
-- ✅ Binary builds successfully
-
----
-
-## ✨ Key Achievements
-
-**1. Test Coverage Milestone** 🎯
-- Exceeded 50% coverage target (54.2%)
-- All critical paths tested
-- High confidence in code quality
-
-**2. Comprehensive Documentation** 📚
-- 650-line testing guide
-- Clear examples and patterns
-- Easy for contributors to extend
-
-**3. Build Stability** 🏗️
-- All builds passing
-- No breaking changes
-- Production-ready quality
-
-**4. Code Quality** ✨
-- Refactored for testability
-- Clean, maintainable tests
-- Best practices throughout
-
----
-
-## 🎉 Conclusion
-
-Week 4 successfully established a **strong testing foundation** for the splash screen:
-
-- ✅ **54.2% test coverage** (exceeded 50% target)
-- ✅ **31 passing tests** (0 failures)
-- ✅ **Comprehensive documentation** (1,300 lines)
-- ✅ **Production-ready quality** (builds successfully)
-
-The splash screen is now **well-tested and reliable** across the codebase. Week 5 will focus on **cross-platform validation** and **final polish** before launch.
-
----
-
-**Next Command:** `/go` to continue with Week 5 tasks
-
----
-
-**🤖 Generated with [Claude Code](https://claude.com/claude-code)**
-
-*Week 4: Cross-Platform Testing - Complete ✅*
-*Ready for Week 5: Launch Preparation* 🚀
diff --git a/packages/tui/WEEK_5_COMPLETION.md b/packages/tui/WEEK_5_COMPLETION.md
deleted file mode 100644
index b509afc2..00000000
--- a/packages/tui/WEEK_5_COMPLETION.md
+++ /dev/null
@@ -1,637 +0,0 @@
-# Week 5 Final Completion Report
-
-> **RyCode Splash Screen - Production Launch Ready** 🚀
-
----
-
-## 📊 Executive Summary
-
-Week 5 successfully completed **all** launch preparation tasks:
-- ✅ Documentation review and updates (6,333 lines)
-- ✅ README.md integration (splash section added)
-- ✅ Release notes created (550 lines)
-- ✅ Demo asset infrastructure (VHS tapes, scripts, guides)
-- ✅ Integration testing documentation (comprehensive test plan)
-- ✅ Build verification (25MB binary, 31/31 tests passing)
-
-**Status:** **PRODUCTION READY** ✅
-
----
-
-## 🎉 Week 5 Achievements
-
-### 1. Documentation Deliverables
-
-**Created Files:**
-```
-SPLASH_RELEASE_NOTES.md          550 lines   Release announcement
-WEEK_5_SUMMARY.md                400 lines   Week 5 accomplishments
-SPLASH_DEMO_CREATION.md        1,200 lines   GIF/video creation guide
-DEMO_ASSETS_README.md            700 lines   Quick asset reference
-SPLASH_INTEGRATION_TEST.md     1,200 lines   Integration test plan
-splash_demo.tape                  25 lines   VHS recording script
-splash_demo_donut.tape            50 lines   Donut mode demo script
-scripts/record_splash_simple.sh   60 lines   Manual recording helper
-WEEK_5_COMPLETION.md (this file)           Final completion report
-```
-
-**Total New Documentation:** 4,185 lines
-
-**Updated Files:**
-```
-README.md                        +50 lines   Added splash section
-```
-
-**Grand Total Documentation (All Weeks):**
-- Production code: 1,240 lines
-- Test code: 901 lines
-- Documentation: **6,333 lines** (Week 1-5 combined)
-- **Total project: 8,474 lines**
-
----
-
-### 2. Demo Asset Infrastructure
-
-**VHS Tape Files:**
-- `splash_demo.tape` - Standard 5-second splash animation
-- `splash_demo_donut.tape` - 20-second donut mode with all easter eggs
-
-**Usage:**
-```bash
-# Install VHS
-brew install vhs
-
-# Generate GIFs
-vhs splash_demo.tape          # → splash_demo.gif
-vhs splash_demo_donut.tape    # → splash_demo_donut.gif
-```
-
-**Recording Scripts:**
-- `scripts/record_splash_simple.sh` - Manual recording helper (no dependencies)
-
-**Documentation:**
-- `SPLASH_DEMO_CREATION.md` - Complete guide (4 methods: VHS, asciinema, screenshots, video)
-- `DEMO_ASSETS_README.md` - Quick reference with Next.js integration examples
-
-**Ready for Landing Page:**
-- Hero fold: `splash_demo.gif` or asciinema player
-- Easter eggs section: Multiple demo GIFs
-- Social media: MP4 video conversion recipes provided
-
----
-
-### 3. Integration Testing
-
-**File:** `SPLASH_INTEGRATION_TEST.md`
-
-**14 Test Scenarios Documented:**
-1. First launch (default behavior)
-2. Second launch (already shown)
-3. Force show (`--splash` flag)
-4. Skip (`--no-splash` flag)
-5. Infinite donut mode (`./rycode donut`)
-6. Frequency mode: always
-7. Frequency mode: never
-8. Frequency mode: random (10%)
-9. Reduced motion accessibility
-10. No color mode
-11. Small terminal (auto-skip)
-12. Server connection failure handling
-13. Crash recovery (panic/recover)
-14. Skip controls (S and ESC)
-
-**Integration Points Verified:**
-- ✅ Bubble Tea compatibility
-- ✅ Configuration persistence
-- ✅ Signal handling (SIGTERM/SIGINT)
-- ✅ Stdin handling (piped input)
-- ✅ Concurrent goroutines (no race conditions)
-
-**Code Integration Complete:**
-- Lines 19, 37-38, 41-45, 133-171, 173, 224-237 in `cmd/rycode/main.go`
-- All splash functions integrated
-- Error handling robust (defer/recover)
-- Clean TUI transition (`clearScreen()`)
-
----
-
-### 4. Build Verification
-
-**Binary Built Successfully:**
-```bash
-go build -o rycode-test ./cmd/rycode
-```
-
-**Results:**
-- ✅ Build time: <5 seconds
-- ✅ Binary size: 25MB (unstripped)
-- ✅ No compilation errors
-- ✅ All dependencies resolved
-
-**Test Results:**
-```bash
-go test ./internal/splash/...
-```
-
-**Coverage:**
-- ✅ 31/31 tests passing (100%)
-- ✅ 54.2% statement coverage
-- ✅ All critical paths tested
-
----
-
-## 📈 Final Statistics
-
-### Code Metrics (Complete Project)
-
-**Production Code:** 1,240 lines
-```
-splash.go         330 lines (27%)   Main Bubble Tea model
-cortex.go         260 lines (21%)   3D torus renderer
-fallback.go       167 lines (13%)   Text-only mode
-config.go         164 lines (13%)   Configuration system
-ansi.go           124 lines (10%)   Color utilities
-terminal.go       118 lines (10%)   Terminal detection
-bootsequence.go    67 lines (5%)    Boot animation
-closer.go          62 lines (5%)    Closer screen
-```
-
-**Test Code:** 901 lines
-```
-terminal_test.go  229 lines (25%)   Terminal detection tests
-fallback_test.go  220 lines (24%)   Fallback mode tests
-config_test.go    165 lines (18%)   Configuration tests
-cortex_test.go    116 lines (13%)   Cortex rendering tests
-ansi_test.go      105 lines (12%)   ANSI color tests
-```
-
-**Documentation:** 6,333 lines (Week 1-5 combined)
-```
-SPLASH_IMPLEMENTATION_PLAN.md  1,200 lines (19%)
-SPLASH_TASKS.md                1,500 lines (24%)
-SPLASH_DEMO_CREATION.md        1,200 lines (19%)
-SPLASH_INTEGRATION_TEST.md     1,200 lines (19%)
-SPLASH_TESTING.md                650 lines (10%)
-SPLASH_USAGE.md                  650 lines (10%)
-WEEK_4_SUMMARY.md                600 lines (9%)
-SPLASH_RELEASE_NOTES.md          550 lines (9%)
-EASTER_EGGS.md                   350 lines (6%)
-WEEK_5_SUMMARY.md                400 lines (6%)
-DEMO_ASSETS_README.md            700 lines (11%)
-WEEK_5_COMPLETION.md (this)      [ongoing]
-```
-
-**Total Project Lines:** 8,474+ lines
-
----
-
-### Performance Metrics
-
-**Rendering:**
-- Frame time: 0.318ms (M1 Max)
-- Target: 33.33ms (30 FPS)
-- **Performance: 85× faster than needed** 🚀
-
-**Memory:**
-- Splash state: ~2MB
-- Binary impact: <100KB
-- No memory leaks
-
-**Startup:**
-- Splash overhead: <10ms (excluding animation)
-- Total animation: ~5 seconds
-- Clean transition: <10ms
-
----
-
-### Test Coverage
-
-**Unit Tests:** 31 passing (100%)
-```
-ansi_test.go      5 tests   Color gradients, luminance
-config_test.go    5 tests   Save, load, defaults
-cortex_test.go    5 tests   Torus math, rendering
-terminal_test.go  9 tests   Detection, capabilities
-fallback_test.go  7 tests   Text-only mode, layout
-```
-
-**Coverage:** 54.2% of statements
-- Terminal detection: 85%+ coverage
-- Configuration: 70%+ coverage
-- ANSI utilities: 65%+ coverage
-- Cortex (Bubble Tea model): Lower (harder to unit test)
-
-**Integration Tests:** 14 scenarios documented
-- Manual testing required (visual verification)
-- Automated test script provided
-
----
-
-## 🚀 Landing Page Planning Complete
-
-### Deliverables Created
-
-**1. LANDING_PAGE_SPEC.md** (18,000 words)
-- 10 landing fold designs
-- Design system (colors, typography, animations)
-- Component code examples (TypeScript/React)
-- Installation flow specification
-- SEO optimization strategy
-- Analytics tracking plan
-
-**2. LANDING_PAGE_IMPLEMENTATION_PLAN.md** (10,000 words)
-- Multi-agent validated technology choices
-- 10-week phase-by-phase breakdown
-- Risk assessment and mitigation
-- Resource allocation ($21/month)
-- Success metrics (15% install rate, 40% toolkit-cli awareness)
-
-**3. LANDING_PAGE_TASKS.md** (15,000 words)
-- 91 specific, actionable tasks
-- Priority levels (🔴🟡🟢⚪)
-- Dependencies and critical path
-- Acceptance criteria for each task
-- Time estimates and weekly targets
-
-**Technology Stack Validated:**
-- Next.js 14 (App Router)
-- Tailwind CSS 3.4
-- Framer Motion 11
-- Asciinema Player 3.7
-- Plausible Analytics
-- Vercel hosting
-
-**Ready to Start:** Week 1 tasks identified (design system, project setup)
-
----
-
-## ✅ Production Readiness Checklist
-
-### Code Quality ✅
-- [x] All tests passing (31/31)
-- [x] Coverage >50% (54.2%)
-- [x] Build successful (25MB)
-- [x] No known bugs
-- [x] Performance excellent (85× faster than target)
-
-### Features ✅
-- [x] 3D rendering engine
-- [x] 5 easter eggs (donut, Konami code, math, hidden message, skip)
-- [x] Configuration system (save/load)
-- [x] Command-line flags (--splash, --no-splash)
-- [x] Fallback modes (text-only, skip)
-- [x] Terminal detection (auto-adapt)
-- [x] Accessibility support (PREFERS_REDUCED_MOTION, NO_COLOR)
-
-### Integration ✅
-- [x] Integrated with `cmd/rycode/main.go`
-- [x] Bubble Tea compatibility verified
-- [x] Clean TUI transition (`clearScreen()`)
-- [x] Error handling (defer/recover)
-- [x] Signal handling (SIGTERM/SIGINT)
-- [x] Configuration persistence
-
-### Documentation ✅
-- [x] Usage guide (SPLASH_USAGE.md, 650 lines)
-- [x] Easter eggs guide (EASTER_EGGS.md, 350 lines)
-- [x] Testing guide (SPLASH_TESTING.md, 650 lines)
-- [x] Release notes (SPLASH_RELEASE_NOTES.md, 550 lines)
-- [x] README updates (50 lines added)
-- [x] Implementation plan (SPLASH_IMPLEMENTATION_PLAN.md, 1,200 lines)
-- [x] Week summaries (WEEK_4_SUMMARY.md, WEEK_5_SUMMARY.md)
-- [x] Demo creation guide (SPLASH_DEMO_CREATION.md, 1,200 lines)
-- [x] Integration test plan (SPLASH_INTEGRATION_TEST.md, 1,200 lines)
-
-### Demo Assets ✅
-- [x] VHS tape files created (splash_demo.tape, splash_demo_donut.tape)
-- [x] Recording scripts created (record_splash_simple.sh)
-- [x] Demo creation guide complete (4 methods documented)
-- [x] Landing page integration examples provided
-
-### Polish ✅
-- [x] Smooth animations (30 FPS)
-- [x] Beautiful colors (cyan-magenta gradient)
-- [x] Clear documentation
-- [x] User-friendly config
-- [x] Skip controls (S, ESC)
-- [x] Error handling robust
-
----
-
-## 📊 Week-by-Week Summary
-
-| Week | Focus Area | Lines Added | Tests Added | Docs Added |
-|------|------------|-------------|-------------|------------|
-| 1 | Foundation | 730 | 10 | 600 |
-| 2 | Easter Eggs | 290 | 0 | 350 |
-| 3 | Integration | 220 | 0 | 650 |
-| 4 | Testing | 614 | 21 | 1,250 |
-| 5 | Launch Prep | 0 | 0 | 4,185 |
-| **Total** | | **1,854** | **31** | **7,035** |
-
-**Note:** Week 5 focused on documentation, landing page planning, and demo infrastructure.
-
----
-
-## 🎯 Remaining Tasks (Optional)
-
-### High Priority
-- [ ] **Generate demo GIFs** (requires `brew install vhs`)
-  ```bash
-  vhs splash_demo.tape
-  vhs splash_demo_donut.tape
-  ```
-- [ ] **Manual integration testing** (requires running RyCode server)
-  - Follow SPLASH_INTEGRATION_TEST.md scenarios
-  - Verify visual TUI transition
-  - Test all easter eggs
-
-### Medium Priority
-- [ ] **Cross-platform testing**
-  - Linux (Ubuntu, Fedora)
-  - Windows (Windows Terminal, PowerShell)
-  - macOS (iTerm2, Terminal.app)
-
-- [ ] **Low-end system testing**
-  - Raspberry Pi 4
-  - Virtual machines
-  - SSH/remote sessions
-
-### Low Priority
-- [ ] **Additional demo assets**
-  - Individual easter egg GIFs
-  - Screenshots for blog posts
-  - Social media videos (MP4)
-
-- [ ] **Performance monitoring in production**
-  - Collect real-world metrics
-  - User feedback on accessibility
-  - Terminal compatibility reports
-
----
-
-## 🌟 Success Metrics Achieved
-
-### Quantitative ✅
-
-**Code Quality:**
-- ✅ >50% test coverage (achieved 54.2%)
-- ✅ 0 known bugs
-- ✅ <5 second build time (achieved <5s)
-- ✅ <30ms startup overhead (achieved <10ms)
-
-**Performance:**
-- ✅ 30 FPS target (achieved 3,140 FPS - 85× better!)
-- ✅ <10MB memory (achieved ~2MB)
-- ✅ <25MB binary (achieved exactly 25MB)
-
-**Documentation:**
-- ✅ >500 lines user docs (achieved 1,650 lines)
-- ✅ >500 lines dev docs (achieved 4,685 lines)
-- ✅ >5 examples (achieved 20+)
-
-### Qualitative ✅
-
-**User Experience:**
-- ✅ Delightful first impression (3D cortex animation)
-- ✅ Easy to skip/disable (S, ESC, --no-splash)
-- ✅ Accessible by default (PREFERS_REDUCED_MOTION, NO_COLOR)
-- ✅ Easter eggs encourage exploration (5 hidden features)
-
-**Code Quality:**
-- ✅ Well-tested (31 passing tests, 54.2% coverage)
-- ✅ Well-documented (6,333 lines across 12 files)
-- ✅ Maintainable (clear separation of concerns)
-- ✅ Extensible (easy to add new easter eggs, animations)
-
-**Brand Impact:**
-- ✅ Memorable visual identity (3D neural cortex)
-- ✅ Technical credibility (real math, high performance)
-- ✅ Attention to detail (accessibility, fallback modes)
-- ✅ AI-powered polish ("🤖 100% AI-Designed by Claude")
-
----
-
-## 💬 User Testimonials (Anticipated)
-
-Based on implementation quality, expected feedback:
-
-> *"The splash screen is absolutely stunning! I didn't know terminal graphics could look this good."*
-
-> *"Love the donut mode easter egg. Very hypnotic!"*
-
-> *"Respects my PREFERS_REDUCED_MOTION setting automatically. Great accessibility!"*
-
-> *"The math reveal (?) is incredible. Shows the actual parametric equations!"*
-
-> *"ESC to disable forever - perfect for power users like me."*
-
----
-
-## 🔥 Marketing Highlights
-
-### Social Media Ready
-
-**Tweet Ideas:**
-```
-🌀 RyCode now has an EPIC 3D ASCII splash screen!
-
-✨ Real donut algorithm math (not fake art)
-⚡ 0.318ms per frame (85× faster than needed!)
-🎮 5 hidden easter eggs
-♿ Fully accessible
-
-Built with toolkit-cli → Try it: ry-code.com
-
-[GIF: splash_demo.gif]
-```
-
-**LinkedIn Post:**
-```
-Excited to launch RyCode's 3D neural cortex splash screen! 🚀
-
-Technical highlights:
-✅ Real torus parametric equations
-✅ Z-buffer depth sorting
-✅ 30 FPS @ 0.318ms/frame (85× faster than target)
-✅ Adaptive accessibility (respects motion preferences)
-✅ 54.2% test coverage
-
-100% built with toolkit-cli, Anthropic's AI toolkit.
-
-Learn more: ry-code.com
-
-#AI #CLI #Terminal #DeveloperTools
-```
-
-### Blog Post Angles
-
-1. **"Building a 3D Terminal Splash Screen with Real Math"**
-   - Torus parametric equations walkthrough
-   - Z-buffer depth sorting explanation
-   - Performance optimization techniques
-
-2. **"Accessibility First: Terminal Graphics for Everyone"**
-   - Terminal capability detection
-   - Fallback mode design philosophy
-   - Environment variable support
-
-3. **"Easter Eggs Done Right: Hidden Features That Delight"**
-   - Design philosophy (discoverability balance)
-   - Implementation details
-   - User engagement strategies
-
-4. **"Test-Driven Development for Visual Features"**
-   - Testing strategy for TUI apps
-   - Achieving 54.2% coverage
-   - Best practices for Bubble Tea apps
-
----
-
-## 🎓 Key Learnings (5 Weeks)
-
-### What Went Exceptionally Well
-
-**1. Documentation-First Approach**
-- Multi-agent validated implementation plan guided all work
-- Clear task breakdown prevented scope creep
-- Weekly summaries tracked progress effectively
-
-**2. Test-Driven Development**
-- 54.2% coverage ensures reliability
-- Caught bugs before reaching users
-- Refactored code for better testability
-
-**3. Accessibility Focus**
-- Multiple fallback modes ensure inclusivity
-- Environment variable support (PREFERS_REDUCED_MOTION, NO_COLOR)
-- Terminal detection automatic
-- Skip controls for power users
-
-**4. Performance Obsession**
-- 85× faster than target (0.318ms per frame)
-- Adaptive frame rate for slow systems (30→15 FPS)
-- Memory efficient (~2MB)
-- Minimal startup overhead (<10ms)
-
-**5. User Experience**
-- 5 easter eggs encourage exploration
-- Configuration respects preferences
-- Clear documentation with examples
-- Skip options for every user type
-
-### Challenges Overcome
-
-**1. Bubble Tea Testing**
-- Challenge: Hard to unit test TUI models
-- Solution: Focused on testable components (config, terminal, ANSI)
-- Result: 54.2% coverage on critical paths
-
-**2. Cross-Platform Compatibility**
-- Challenge: Different terminal capabilities
-- Solution: Automatic detection + fallback modes
-- Result: Works on all major terminals
-
-**3. Performance Optimization**
-- Challenge: 30 FPS target seemed aggressive
-- Solution: Efficient algorithms + adaptive FPS
-- Result: 85× faster than needed!
-
-**4. Documentation Scope**
-- Challenge: Balancing detail vs. readability
-- Solution: Multiple docs for different audiences (users, developers, marketers)
-- Result: 6,333 lines of clear, comprehensive documentation
-
----
-
-## 🚀 Next Steps
-
-### Immediate (Optional - Week 6)
-
-**If continuing with splash:**
-1. Install VHS: `brew install vhs`
-2. Generate demo GIFs: `vhs splash_demo.tape`
-3. Manual integration testing (follow SPLASH_INTEGRATION_TEST.md)
-4. Cross-platform verification
-
-**If starting landing page:**
-1. Review and approve LANDING_PAGE_SPEC.md
-2. Review and approve LANDING_PAGE_IMPLEMENTATION_PLAN.md
-3. Begin Week 1 tasks (design system, project setup)
-4. See LANDING_PAGE_TASKS.md for detailed breakdown
-
-### Future Enhancements (Post-Launch)
-
-**Splash Screen:**
-- Additional easter eggs (community suggestions)
-- Theme customization options
-- Animation speed control
-- More hidden messages
-
-**Landing Page:**
-- 10-week implementation (91 tasks)
-- Target: 15% install conversion rate
-- Target: 40% toolkit-cli awareness
-
----
-
-## 🏆 Final Status
-
-### Splash Screen: **PRODUCTION READY** ✅
-
-**Code:** Complete, tested, integrated
-**Tests:** 31/31 passing, 54.2% coverage
-**Documentation:** 6,333 lines, comprehensive
-**Performance:** 85× faster than target
-**Build:** 25MB binary, <5s build time
-**Quality:** Zero known bugs
-
-### Landing Page Planning: **COMPLETE** ✅
-
-**Specification:** 18,000 words, 10 folds designed
-**Implementation Plan:** 10-week roadmap, multi-agent validated
-**Task Breakdown:** 91 actionable tasks with acceptance criteria
-**Technology Stack:** Next.js 14, Tailwind, Framer Motion, validated
-**Ready to Start:** Awaiting approval to begin Week 1
-
----
-
-## 🎉 Conclusion
-
-Week 5 successfully prepared both the splash screen and landing page for production:
-
-### Splash Screen ✅
-- All code complete and integrated
-- 31 tests passing, 54.2% coverage
-- 6,333 lines of documentation
-- Demo asset infrastructure ready
-- Integration testing documented
-- Performance excellent (85× faster than needed)
-
-### Landing Page Planning ✅
-- Complete specification (18,000 words)
-- 10-week implementation plan
-- 91 actionable tasks
-- Technology stack validated
-- Success metrics defined
-
-### Total Effort
-- **Development Time:** 5 weeks
-- **Total Lines Written:** 8,474+ lines (code + tests + docs)
-- **Quality Rating:** Production Ready ✅
-- **Launch Readiness:** Awaiting manual demo generation and final approval
-
----
-
-**🤖 100% AI-Designed by Claude**
-
-*From concept to completion*
-*Zero compromises, infinite attention to detail*
-
----
-
-**Status:** Ready for Launch 🚀
-**Next Decision Point:** Generate demo assets or start landing page implementation
-**Completion Date:** Week 5, 2024
-**Version:** 1.0.0
-
diff --git a/packages/tui/WEEK_5_SUMMARY.md b/packages/tui/WEEK_5_SUMMARY.md
deleted file mode 100644
index 8d20e92d..00000000
--- a/packages/tui/WEEK_5_SUMMARY.md
+++ /dev/null
@@ -1,556 +0,0 @@
-# Week 5 Summary: Launch Preparation & Final Polish
-
-> **Goal:** Finalize documentation, create release materials, and prepare for production launch
-
----
-
-## 📊 Week 5 Achievements
-
-### ✅ Completed Tasks
-
-**1. Documentation Review & Updates**
-- ✅ Reviewed all 5 splash documentation files
-- ✅ Updated main README.md with splash section
-- ✅ Created comprehensive release notes
-- ✅ Verified all links and cross-references
-- ✅ Updated statistics and metrics
-
-**2. README.md Enhancements**
-- ✅ Added "Epic Splash Screen" section (24 lines)
-- ✅ Updated "Can't Compete" checklist (added splash)
-- ✅ Updated code metrics (9,366 lines, 32 files, 31 tests)
-- ✅ Added splash/ to code organization diagram
-- ✅ Created dedicated documentation section for splash
-- ✅ Updated easter eggs count (10+ → 15+)
-
-**3. Release Notes Created**
-- ✅ SPLASH_RELEASE_NOTES.md (550+ lines)
-  - Feature overview
-  - Technical specifications
-  - Easter eggs guide
-  - Configuration reference
-  - Performance benchmarks
-  - Implementation journey
-  - User testimonials
-  - Marketing highlights
-  - Launch checklist
-
-**4. Final Verification**
-- ✅ All 31 tests passing
-- ✅ 54.2% test coverage maintained
-- ✅ Binary builds successfully (25MB unstripped)
-- ✅ No regressions introduced
-- ✅ All documentation reviewed
-
----
-
-## 📈 Final Statistics
-
-### Production Metrics
-- **Production code:** 1,240 lines (splash module)
-- **Test code:** 901 lines (5 test files)
-- **Documentation:** 6,333 lines (6 documentation files)
-- **Total lines:** **8,474 lines** for splash screen feature
-
-### Test Coverage
-- **Tests:** 31/31 passing (100%)
-- **Coverage:** 54.2% of statements
-- **Test files:** 5 comprehensive test suites
-- **Test categories:** ANSI, Config, Cortex, Terminal, Fallback
-
-### Build Metrics
-- **Binary size:** 25MB (unstripped), ~19MB (stripped)
-- **Build time:** <5 seconds
-- **Startup overhead:** <10ms
-- **Memory footprint:** ~2MB for splash state
-
-### Documentation Metrics
-- **Files:** 6 comprehensive guides
-- **Total lines:** 6,333 lines
-- **Coverage areas:**
-  - Usage guide (650 lines)
-  - Easter eggs (350 lines)
-  - Testing guide (650 lines)
-  - Implementation plan (600 lines)
-  - Week 4 summary (600 lines)
-  - Release notes (550 lines)
-  - Week 5 summary (this file)
-
----
-
-## 📚 Documentation Deliverables
-
-### User-Facing Documentation
-
-**1. SPLASH_USAGE.md** (650 lines)
-- Quick start guide
-- Keyboard controls
-- Configuration options
-- Command-line flags
-- Fallback modes
-- Troubleshooting
-- Examples and best practices
-
-**2. EASTER_EGGS.md** (350 lines)
-- All 5 easter eggs documented
-- Discovery hints
-- Technical details
-- Screenshots/examples
-
-**3. SPLASH_RELEASE_NOTES.md** (550 lines)
-- Feature overview
-- Technical specifications
-- Quick start guide
-- Implementation journey
-- Marketing highlights
-- User testimonials
-- Launch checklist
-
-### Developer Documentation
-
-**4. SPLASH_TESTING.md** (650 lines)
-- Test coverage summary
-- Running tests
-- Test organization
-- Coverage by module
-- Manual testing checklist
-- Known issues
-- Testing best practices
-
-**5. SPLASH_IMPLEMENTATION_PLAN.md** (600 lines)
-- Multi-agent validated design
-- Technology stack
-- 5-week breakdown
-- Risk assessment
-- Task dependencies
-
-**6. WEEK_4_SUMMARY.md** (600 lines)
-- Testing achievements
-- Coverage breakdown
-- Code changes
-- Build status
-- Manual testing results
-
-**7. WEEK_5_SUMMARY.md** (This file)
-- Documentation review
-- Release preparation
-- Final statistics
-- Launch readiness
-
----
-
-## 🎯 README.md Updates
-
-### Added Sections
-
-**1. Splash Screen Feature** (lines 128-151)
-```markdown
-### 🌀 Epic Splash Screen
-
-**3D ASCII Neural Cortex Animation:**
-- Real donut algorithm math (torus parametric equations)
-- 30 FPS smooth animation with z-buffer depth sorting
-- Cyberpunk cyan-magenta gradient colors
-- 3-act sequence: Boot → Cortex → Closer (5 seconds)
-- Adaptive frame rate (drops to 15 FPS on slow systems)
-
-**Easter Eggs in Splash:**
-1. Infinite Donut Mode: `./rycode donut`
-2. Konami Code: ↑↑↓↓←→←→BA for rainbow mode
-3. Math Reveal: Press `?` to see equations
-4. Hidden Message: "CLAUDE WAS HERE"
-5. Skip Controls: `S` or `ESC`
-
-**Configuration:**
-- Flags: --splash, --no-splash
-- Config: ~/.rycode/config.json
-- Frequencies: first/always/random/never
-- Env vars: PREFERS_REDUCED_MOTION, NO_COLOR
-```
-
-**2. Updated "Can't Compete" Checklist** (lines 14-28)
-- Added: "Epic 3D splash screen - Real donut algorithm with 30 FPS"
-- Updated: "15+ hidden easter eggs" (was 10+)
-
-**3. Updated Statistics** (lines 282-287)
-- Production code: ~9,366 lines (was 7,916)
-- Files: 32 files across 8 packages (was 24 files, 7 packages)
-- Tests: 31/31 passing with 54.2% coverage (was 10/10)
-
-**4. Code Organization** (lines 256-270)
-- Added: `splash/` package (1450+ lines)
-
-**5. Documentation Section** (lines 361-374)
-- New subsection: "Splash Screen"
-- 5 splash-specific documentation links
-
----
-
-## 🚀 Release Preparation
-
-### Launch Checklist
-
-**Documentation:** ✅ Complete
-- [x] Usage guide
-- [x] Easter eggs guide
-- [x] Testing guide
-- [x] Release notes
-- [x] README updates
-- [x] Implementation plan
-- [x] Week summaries
-
-**Code Quality:** ✅ Verified
-- [x] All tests passing (31/31)
-- [x] Coverage >50% (54.2%)
-- [x] Build successful
-- [x] No known bugs
-- [x] Performance excellent
-
-**Features:** ✅ Complete
-- [x] 3D rendering engine
-- [x] 5 easter eggs
-- [x] Configuration system
-- [x] Command-line flags
-- [x] Fallback modes
-- [x] Terminal detection
-- [x] Accessibility support
-
-**Polish:** ✅ Done
-- [x] Smooth animations
-- [x] Beautiful colors
-- [x] Clear documentation
-- [x] User-friendly config
-- [x] Skip controls
-- [x] Error handling
-
-### Remaining Tasks
-
-**High Priority:**
-- [ ] Create demo GIF/video
-- [ ] Integration testing with real server
-- [ ] Performance monitoring in production
-- [ ] User feedback collection
-
-**Medium Priority:**
-- [ ] Cross-platform validation (Windows, Linux)
-- [ ] Low-end system testing (Raspberry Pi)
-- [ ] SSH/remote session testing
-- [ ] Additional terminal emulator testing
-
-**Low Priority:**
-- [ ] Additional easter eggs (if requested)
-- [ ] Theme customization options
-- [ ] Animation speed control
-- [ ] More hidden messages
-
----
-
-## 📊 Complete Project Statistics
-
-### Weeks 1-5 Summary
-
-| Week | Focus | Lines Added | Tests Added | Docs Added |
-|------|-------|-------------|-------------|------------|
-| 1 | Foundation | 730 | 10 | 600 |
-| 2 | Easter Eggs | 290 | 0 | 350 |
-| 3 | Integration | 220 | 0 | 650 |
-| 4 | Testing | 614 | 21 | 1,250 |
-| 5 | Launch Prep | 0 | 0 | 550 |
-| **Total** | | **2,141** | **31** | **3,400** |
-
-### Code Distribution
-
-**Production Code:** 1,240 lines
-- splash.go: 330 lines (27%)
-- cortex.go: 260 lines (21%)
-- fallback.go: 167 lines (13%)
-- config.go: 164 lines (13%)
-- ansi.go: 124 lines (10%)
-- terminal.go: 118 lines (10%)
-- bootsequence.go: 67 lines (5%)
-- closer.go: 62 lines (5%)
-
-**Test Code:** 901 lines
-- terminal_test.go: 229 lines (25%)
-- fallback_test.go: 220 lines (24%)
-- config_test.go: 165 lines (18%)
-- cortex_test.go: 116 lines (13%)
-- ansi_test.go: 105 lines (12%)
-
-**Documentation:** 6,333 lines
-- SPLASH_IMPLEMENTATION_PLAN.md: 1,200 lines (19%)
-- SPLASH_TASKS.md: 1,500 lines (24%)
-- SPLASH_TESTING.md: 650 lines (10%)
-- SPLASH_USAGE.md: 650 lines (10%)
-- WEEK_4_SUMMARY.md: 600 lines (9%)
-- SPLASH_RELEASE_NOTES.md: 550 lines (9%)
-- EASTER_EGGS.md: 350 lines (6%)
-- WEEK_5_SUMMARY.md: 400 lines (6%)
-
----
-
-## 🎓 Key Learnings
-
-### What Went Exceptionally Well
-
-**1. Documentation-First Approach**
-- Planning documents guided implementation
-- Clear task breakdown prevented scope creep
-- Multi-agent validation caught issues early
-- Weekly summaries tracked progress effectively
-
-**2. Test-Driven Development**
-- 54.2% coverage ensures reliability
-- Caught bugs before they reached users
-- Refactored code for better testability
-- Comprehensive test documentation
-
-**3. Accessibility Focus**
-- Multiple fallback modes ensure inclusivity
-- Environment variable support
-- Terminal detection automatic
-- Skip controls for power users
-
-**4. Performance Obsession**
-- 85× faster than target (0.318ms per frame)
-- Adaptive frame rate for slow systems
-- Memory efficient (~2MB)
-- Minimal startup overhead (<10ms)
-
-**5. User Experience**
-- 5 easter eggs encourage exploration
-- Configuration respects preferences
-- Clear documentation with examples
-- Skip options for every user type
-
-### Challenges Overcome
-
-**1. Bubble Tea Testing**
-- Challenge: Hard to unit test TUI models
-- Solution: Focused on testable components
-- Result: 54.2% coverage on critical paths
-
-**2. Cross-Platform Compatibility**
-- Challenge: Different terminal capabilities
-- Solution: Automatic detection + fallback modes
-- Result: Works on all major terminals
-
-**3. Performance Optimization**
-- Challenge: 30 FPS target seemed aggressive
-- Solution: Efficient algorithms + adaptive FPS
-- Result: 85× faster than needed!
-
-**4. Documentation Scope**
-- Challenge: Balancing detail vs. readability
-- Solution: Multiple docs for different audiences
-- Result: 6,333 lines of clear documentation
-
----
-
-## 🌟 Standout Features
-
-### Technical Excellence
-
-**1. Real Mathematics**
-- Not fake ASCII art
-- Actual torus parametric equations
-- Z-buffer depth sorting
-- Rotation matrices
-- Perspective projection
-- Phong shading
-
-**2. Performance**
-- 0.318ms per frame
-- 85× faster than 30 FPS target
-- Adaptive frame rate
-- Memory efficient
-- Zero startup overhead
-
-**3. Test Coverage**
-- 31 comprehensive tests
-- 54.2% coverage
-- All critical paths tested
-- Comprehensive test docs
-
-### User Experience
-
-**4. Easter Eggs**
-- Infinite donut mode
-- Konami code
-- Math equations reveal
-- Hidden message
-- Skip controls
-
-**5. Configuration**
-- Command-line flags
-- Config file
-- Environment variables
-- 4 frequency modes
-- Automatic fallback
-
-**6. Accessibility**
-- PREFERS_REDUCED_MOTION support
-- NO_COLOR support
-- Multiple fallback modes
-- Skip options
-- Terminal detection
-
----
-
-## 💬 Marketing Angles
-
-### Tweet Ideas
-
-**Technical:**
-- "🌀 Just added a 3D ASCII splash screen to RyCode using real donut algorithm math!"
-- "⚡ 0.318ms per frame - that's 85× faster than our 30 FPS target!"
-- "📊 54.2% test coverage for a splash screen. Because quality matters."
-
-**Easter Eggs:**
-- "🍩 Try `./rycode donut` for an infinite hypnotic cortex animation"
-- "🌈 Hidden feature: Press ↑↑↓↓←→←→BA during splash for rainbow mode!"
-- "🧮 Press `?` during splash to see the actual torus mathematics"
-
-**Accessibility:**
-- "♿ Our splash screen respects PREFERS_REDUCED_MOTION automatically"
-- "🎯 Automatic fallback modes for any terminal - inclusivity by default"
-- "⚡ ESC to disable forever - we respect power users"
-
-### Blog Post Ideas
-
-**1. "Building a 3D Terminal Splash Screen with Real Math"**
-- Torus parametric equations
-- Z-buffer depth sorting
-- Performance optimization
-- Code walkthrough
-
-**2. "Accessibility First: Terminal Graphics for Everyone"**
-- Terminal capability detection
-- Fallback mode design
-- Environment variable support
-- Skip controls
-
-**3. "Easter Eggs Done Right"**
-- Design philosophy
-- Discovery balance
-- Implementation details
-- User delight
-
-**4. "Test-Driven Development for Visual Features"**
-- Testing strategy
-- 54.2% coverage
-- Visual regression testing
-- Best practices
-
----
-
-## 🎯 Post-Launch Roadmap
-
-### Phase 1: Immediate (Week 6)
-- [ ] Monitor user feedback
-- [ ] Create demo GIF/video
-- [ ] Write blog post
-- [ ] Share on social media
-- [ ] Gather analytics
-
-### Phase 2: Iteration (Weeks 7-8)
-- [ ] Address user feedback
-- [ ] Cross-platform validation
-- [ ] Performance monitoring
-- [ ] Bug fixes (if any)
-
-### Phase 3: Enhancements (Weeks 9-12)
-- [ ] Additional easter eggs
-- [ ] Theme customization
-- [ ] Animation variants
-- [ ] More hidden messages
-
----
-
-## 🏆 Success Metrics
-
-### Quantitative Goals
-
-**Code Quality:**
-- ✅ >50% test coverage (achieved 54.2%)
-- ✅ 0 known bugs
-- ✅ <5 second build time
-- ✅ <30ms startup overhead (achieved <10ms)
-
-**Performance:**
-- ✅ 30 FPS target (achieved 85× better)
-- ✅ <10MB memory (achieved ~2MB)
-- ✅ <25MB binary (achieved exactly 25MB)
-
-**Documentation:**
-- ✅ >500 lines user docs (achieved 1,650)
-- ✅ >500 lines dev docs (achieved 1,900)
-- ✅ >5 examples (achieved 15+)
-
-### Qualitative Goals
-
-**User Experience:**
-- ✅ Delightful first impression
-- ✅ Easy to skip/disable
-- ✅ Accessible by default
-- ✅ Easter eggs encourage exploration
-
-**Code Quality:**
-- ✅ Well-tested
-- ✅ Well-documented
-- ✅ Maintainable
-- ✅ Extensible
-
-**Brand Impact:**
-- ✅ Memorable visual identity
-- ✅ Technical credibility
-- ✅ Attention to detail
-- ✅ AI-powered polish
-
----
-
-## 🎉 Conclusion
-
-Week 5 successfully prepared the splash screen for production launch:
-
-### Documentation Complete ✅
-- 6,333 lines of comprehensive guides
-- User and developer documentation
-- Release notes and marketing materials
-- README updates and cross-references
-
-### Quality Verified ✅
-- All 31 tests passing
-- 54.2% coverage maintained
-- Binary builds successfully
-- No regressions introduced
-
-### Launch Ready ✅
-- Features complete
-- Documentation polished
-- Performance excellent
-- Accessibility robust
-
-### Next Steps
-The splash screen is **production-ready** and awaiting:
-- Demo GIF/video creation
-- Integration testing with real server
-- Final cross-platform validation
-- Launch announcement
-
----
-
-**Total Development Time:** 5 weeks
-**Total Lines Written:** 8,474 lines
-**Test Coverage:** 54.2%
-**Quality Rating:** Production Ready ✅
-
----
-
-**🤖 100% AI-Designed by Claude**
-
-*From concept to completion*
-*Zero compromises, infinite attention to detail*
-
-**Status:** Ready for Launch 🚀
-
diff --git a/packages/tui/input_ux_demo.tape b/packages/tui/input_ux_demo.tape
deleted file mode 100644
index b8a445ea..00000000
--- a/packages/tui/input_ux_demo.tape
+++ /dev/null
@@ -1,51 +0,0 @@
-# RyCode Input UX Demo
-# Showcases the polished input field with modern design
-
-Output input_ux_demo.gif
-
-Set FontSize 16
-Set Width 1200
-Set Height 800
-Set Padding 20
-Set Theme "Catppuccin Mocha"
-
-Type "/tmp/rycode-polished"
-Enter
-Sleep 2s
-
-# Show the beautiful placeholder text
-Screenshot input_placeholder.png
-Sleep 1s
-
-# Type a prompt to show the modern input styling
-Type "Help me build a REST API"
-Sleep 500ms
-Screenshot input_typing.png
-Sleep 500ms
-
-# Submit the prompt
-Enter
-Sleep 2s
-
-# Show bash mode with $ prompt
-Type "!"
-Sleep 500ms
-Screenshot input_bash_mode.png
-Type "ls -la"
-Sleep 500ms
-
-# Cancel and go back to normal
-Escape
-Sleep 500ms
-
-# Show the model selector with latest models
-Type "/model"
-Sleep 1s
-Screenshot model_selector_latest.png
-Sleep 2s
-
-# Navigate through models
-Down
-Down
-Sleep 500ms
-Screenshot model_selector_navigation.png
diff --git a/packages/tui/internal/auth/bridge.go b/packages/tui/internal/auth/bridge.go
index 330d1114..f2d3b76f 100644
--- a/packages/tui/internal/auth/bridge.go
+++ b/packages/tui/internal/auth/bridge.go
@@ -94,8 +94,15 @@ func logDebug(format string, args ...interface{}) {
 
 // NewBridge creates a new authentication bridge
 func NewBridge(projectRoot string) *Bridge {
-	cliPath := filepath.Join(projectRoot, "packages", "rycode", "src", "auth", "cli.ts")
-	logDebug("DEBUG [NewBridge]: projectRoot=%s, cliPath=%s", projectRoot, cliPath)
+	// Convert projectRoot to absolute path
+	absProjectRoot, err := filepath.Abs(projectRoot)
+	if err != nil {
+		// Fallback to original if abs fails
+		absProjectRoot = projectRoot
+	}
+
+	cliPath := filepath.Join(absProjectRoot, "packages", "rycode", "src", "auth", "cli.ts")
+	logDebug("DEBUG [NewBridge]: projectRoot=%s, absProjectRoot=%s, cliPath=%s", projectRoot, absProjectRoot, cliPath)
 	return &Bridge{
 		cliPath: cliPath,
 	}
@@ -106,8 +113,13 @@ func (b *Bridge) runCLI(ctx context.Context, args ...string) ([]byte, error) {
 	fullArgs := append([]string{"run", b.cliPath}, args...)
 	cmd := exec.CommandContext(ctx, "bun", fullArgs...)
 
-	// DEBUG: Log the command being run
-	logDebug("DEBUG [bridge]: Running: bun %v", fullArgs)
+	// CRITICAL FIX: Set working directory to the project root
+	// Extract project root from cliPath (remove "/packages/rycode/src/auth/cli.ts")
+	projectRoot := filepath.Dir(filepath.Dir(filepath.Dir(filepath.Dir(b.cliPath))))
+	cmd.Dir = projectRoot
+
+	// DEBUG: Log the command being run with working directory
+	logDebug("DEBUG [bridge]: Running: bun %v (from %s)", fullArgs, projectRoot)
 
 	output, err := cmd.Output()
 	if err != nil {
diff --git a/packages/tui/splash_demo.gif b/packages/tui/splash_demo.gif
deleted file mode 100644
index 50076bd0..00000000
Binary files a/packages/tui/splash_demo.gif and /dev/null differ
diff --git a/packages/tui/splash_demo.tape b/packages/tui/splash_demo.tape
deleted file mode 100644
index d9bb9294..00000000
--- a/packages/tui/splash_demo.tape
+++ /dev/null
@@ -1,31 +0,0 @@
-# VHS Tape for RyCode Splash Screen Demo
-# Install VHS: https://github.com/charmbracelet/vhs
-# Run with: vhs splash_demo.tape
-
-# Output settings
-Output splash_demo.gif
-Set Shell bash
-Set FontSize 14
-Set Width 1200
-Set Height 800
-Set Padding 20
-Set Theme "Dracula"
-
-# Build RyCode
-Type "go build -o rycode ./cmd/rycode"
-Enter
-Sleep 3s
-
-# Clear screen
-Type "clear"
-Enter
-Sleep 0.5s
-
-# Run RyCode with splash enabled
-Type "./rycode --splash"
-Enter
-
-# Let splash animation play
-Sleep 6s
-
-# Demo complete - the splash auto-closes or user can press any key
diff --git a/packages/tui/splash_demo_donut.gif b/packages/tui/splash_demo_donut.gif
deleted file mode 100644
index f0caa01e..00000000
Binary files a/packages/tui/splash_demo_donut.gif and /dev/null differ
diff --git a/packages/tui/splash_demo_donut.tape b/packages/tui/splash_demo_donut.tape
deleted file mode 100644
index 703d4dd1..00000000
--- a/packages/tui/splash_demo_donut.tape
+++ /dev/null
@@ -1,55 +0,0 @@
-# VHS Tape for RyCode Infinite Donut Mode Demo
-# Install VHS: https://github.com/charmbracelet/vhs
-# Run with: vhs splash_demo_donut.tape
-
-# Output settings
-Output splash_demo_donut.gif
-Set Shell bash
-Set FontSize 14
-Set Width 1200
-Set Height 800
-Set Padding 20
-Set Theme "Dracula"
-
-# Build RyCode
-Type "go build -o rycode ./cmd/rycode"
-Enter
-Sleep 3s
-
-# Clear screen
-Type "clear"
-Enter
-Sleep 0.5s
-
-# Run RyCode in infinite donut mode
-Type "./rycode donut"
-Enter
-
-# Let donut spin for 10 seconds
-Sleep 10s
-
-# Press ? to show math equations
-Type "?"
-Sleep 5s
-
-# Press ? again to hide
-Type "?"
-Sleep 3s
-
-# Try Konami code for rainbow mode
-Type@100ms "↑"
-Type@100ms "↑"
-Type@100ms "↓"
-Type@100ms "↓"
-Type@100ms "←"
-Type@100ms "→"
-Type@100ms "←"
-Type@100ms "→"
-Type "b"
-Type "a"
-
-# Rainbow mode active - show for 5 seconds
-Sleep 5s
-
-# Quit with Q
-Type "q"
diff --git a/packages/tui/splash_demo_donut_optimized.gif b/packages/tui/splash_demo_donut_optimized.gif
deleted file mode 100644
index 1e381f54..00000000
Binary files a/packages/tui/splash_demo_donut_optimized.gif and /dev/null differ
diff --git a/packages/tui/splash_model_selector.tape b/packages/tui/splash_model_selector.tape
deleted file mode 100644
index 7c86eeac..00000000
--- a/packages/tui/splash_model_selector.tape
+++ /dev/null
@@ -1,41 +0,0 @@
-# VHS Tape for RyCode - Splash Screen to Model Selector
-# Shows the 5 SOTA models in the selector interface
-# Run with: vhs splash_model_selector.tape
-
-Output splash_model_selector.gif
-Set Shell bash
-Set FontSize 14
-Set Width 1200
-Set Height 800
-Set Padding 20
-Set Theme "Dracula"
-
-# Change to rycode directory
-Type "cd /Users/aaron/Code/RyCode/RyCode/packages/rycode"
-Enter
-Sleep 1s
-
-# Clear screen
-Type "clear"
-Enter
-Sleep 0.5s
-
-# Run rycode (this should show splash then TUI)
-Type "./dist/rycode-darwin-arm64/bin/rycode"
-Enter
-
-# Wait for splash animation to complete
-Sleep 6s
-
-# Now at the TUI prompt - type /model to show selector
-Type "/model"
-Sleep 2s
-
-# Model selector should be visible now - hold for viewing
-Sleep 5s
-
-# Exit gracefully
-Escape
-Sleep 0.5s
-Ctrl+C
-Sleep 0.5s
diff --git a/packages/tui/splash_to_selector.gif b/packages/tui/splash_to_selector.gif
deleted file mode 100644
index 4e326fbe..00000000
Binary files a/packages/tui/splash_to_selector.gif and /dev/null differ
diff --git a/packages/tui/splash_to_selector.tape b/packages/tui/splash_to_selector.tape
deleted file mode 100644
index 21152bb1..00000000
--- a/packages/tui/splash_to_selector.tape
+++ /dev/null
@@ -1,52 +0,0 @@
-# VHS Tape for RyCode - Splash Screen Reveals Model Selector
-# Shows splash screen then reveals the model selector interface
-# Run with: vhs splash_to_selector.tape
-
-Output splash_to_selector.gif
-Set Shell bash
-Set FontSize 14
-Set Width 1200
-Set Height 800
-Set Padding 20
-Set Theme "Dracula"
-
-# Navigate to rycode directory
-Type "cd /Users/aaron/Code/RyCode/RyCode/packages/rycode"
-Enter
-Sleep 1s
-
-# Build RyCode
-Type "go build -o rycode ./cmd/rycode"
-Enter
-Sleep 3s
-
-# Clear screen
-Type "clear"
-Enter
-Sleep 0.5s
-
-# Launch RyCode (WITH splash screen)
-Type "./rycode"
-Enter
-
-# Wait for splash to play (adjust timing based on your splash duration)
-Sleep 5s
-
-# Now the model selector/TUI should be visible
-# Show it for a few seconds
-Sleep 3s
-
-# Type /model to show the model selector
-Type "/model"
-Sleep 2s
-
-# Show the model list
-Sleep 3s
-
-# Press Escape to go back
-Type@100ms "\x1b"  # Escape key
-Sleep 1s
-
-# Quit
-Ctrl+C
-Sleep 0.5s
diff --git a/packages/tui/test-all-models-e2e.sh b/packages/tui/test-all-models-e2e.sh
deleted file mode 100755
index 4447f902..00000000
--- a/packages/tui/test-all-models-e2e.sh
+++ /dev/null
@@ -1,73 +0,0 @@
-#!/bin/bash
-
-# E2E Test Script for All CLI Provider Models
-# Tests each model by attempting to send a simple message
-
-set -e
-
-echo "=== Testing All CLI Provider Models E2E ==="
-echo ""
-
-# Get all providers and models
-PROVIDERS_JSON=$(cd ../rycode && bun run src/auth/cli.ts cli-providers 2>/dev/null)
-
-# Test results
-WORKING_MODELS=()
-FAILED_MODELS=()
-
-# Function to test a model
-test_model() {
-    local provider=$1
-    local model=$2
-
-    echo -n "Testing $provider / $model ... "
-
-    # Create a test session with the model
-    RESPONSE=$(curl -s -X POST http://127.0.0.1:4096/session \
-        -H "Content-Type: application/json" \
-        -d "{\"providerID\":\"$provider\",\"modelID\":\"$model\"}" 2>&1)
-
-    # Check if response contains an error
-    if echo "$RESPONSE" | grep -q "ProviderModelNotFoundError\|error\|Error"; then
-        echo "❌ FAILED"
-        FAILED_MODELS+=("$provider/$model")
-        echo "  Error: $(echo "$RESPONSE" | jq -r '.error // .message // .' 2>/dev/null || echo "$RESPONSE")"
-        return 1
-    else
-        # Extract session ID
-        SESSION_ID=$(echo "$RESPONSE" | jq -r '.id' 2>/dev/null)
-
-        if [ "$SESSION_ID" != "null" ] && [ -n "$SESSION_ID" ]; then
-            echo "✅ SUCCESS (session: $SESSION_ID)"
-            WORKING_MODELS+=("$provider/$model")
-
-            # Clean up - delete the test session
-            curl -s -X DELETE "http://127.0.0.1:4096/session/$SESSION_ID" >/dev/null 2>&1
-            return 0
-        else
-            echo "❌ FAILED (no session ID)"
-            FAILED_MODELS+=("$provider/$model")
-            return 1
-        fi
-    fi
-}
-
-# Parse JSON and test each model
-echo "$PROVIDERS_JSON" | jq -r '.providers[] | "\(.provider) \(.models | join(" "))"' | while read -r provider models; do
-    echo ""
-    echo "=== Testing Provider: $provider ==="
-    for model in $models; do
-        test_model "$provider" "$model" || true
-    done
-done
-
-echo ""
-echo "=== Test Summary ==="
-echo "Working models: ${#WORKING_MODELS[@]}"
-echo "Failed models: ${#FAILED_MODELS[@]}"
-echo ""
-
-if [ ${#FAILED_MODELS[@]} -gt 0 ]; then
-    echo "Failed models to remove from configuration:"
-    printf '%s\n' "${FAILED_MODELS[@]}"
-fi
diff --git a/packages/tui/test-cli-providers.sh b/packages/tui/test-cli-providers.sh
deleted file mode 100755
index d1b7bf05..00000000
--- a/packages/tui/test-cli-providers.sh
+++ /dev/null
@@ -1,50 +0,0 @@
-#!/bin/bash
-#
-# Core Build Unit Test: CLI Providers Authentication
-#
-# This test validates that ALL SOTA CLI providers are authenticated and accessible.
-# This is the foundational test for the Tab cycling workflow.
-#
-# Exit codes:
-#   0 = All providers authenticated
-#   1 = One or more providers failed
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-echo "=== Core Build Unit Test: CLI Providers Authentication ==="
-echo ""
-echo "Project root: $PROJECT_ROOT"
-echo "Test script: test_cli_providers_e2e.go"
-echo ""
-
-# Compile the test
-echo "[1] Compiling test..."
-cd "$SCRIPT_DIR"
-if ! go build -o /tmp/test_cli_providers_e2e test_cli_providers_e2e.go; then
-    echo "    ✗ ERROR: Failed to compile test"
-    exit 1
-fi
-echo "    ✓ Test compiled to /tmp/test_cli_providers_e2e"
-echo ""
-
-# Run the test
-echo "[2] Running test..."
-echo ""
-if /tmp/test_cli_providers_e2e; then
-    EXIT_CODE=0
-else
-    EXIT_CODE=$?
-fi
-
-echo ""
-echo "=== Test Logs ==="
-echo "View detailed logs at: /tmp/rycode-e2e-cli-providers.log"
-echo ""
-
-# Clean up
-rm -f /tmp/test_cli_providers_e2e
-
-exit $EXIT_CODE
diff --git a/packages/tui/test-hello-all-providers.sh b/packages/tui/test-hello-all-providers.sh
deleted file mode 100755
index 6992d7ad..00000000
--- a/packages/tui/test-hello-all-providers.sh
+++ /dev/null
@@ -1,69 +0,0 @@
-#!/bin/bash
-#
-# Core Build Unit Test: Hello All Providers E2E
-#
-# This test validates that ALL authenticated SOTA providers respond to messages.
-# It simulates the Tab cycling workflow by:
-# 1. Loading all CLI providers
-# 2. For each authenticated provider:
-#    - Create a session
-#    - Send "hello" message
-#    - Validate response
-#    - Clean up session
-#
-# Exit codes:
-#   0 = All providers passed
-#   1 = One or more providers failed
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-echo "=== Core Build Unit Test: Hello All Providers ==="
-echo ""
-echo "Project root: $PROJECT_ROOT"
-echo "Test script: test_hello_all_providers_e2e.go"
-echo ""
-
-# Check if API server is running
-echo "[1] Checking if API server is running on port 4096..."
-if ! curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:4096/health > /dev/null 2>&1; then
-    echo "    ✗ ERROR: API server is not running on port 4096"
-    echo ""
-    echo "    Please start the API server first:"
-    echo "      cd packages/rycode && bun run dev"
-    echo ""
-    exit 1
-fi
-echo "    ✓ API server is running"
-echo ""
-
-# Compile the test
-echo "[2] Compiling test..."
-cd "$SCRIPT_DIR"
-if ! go build -o /tmp/test_hello_all_providers_e2e test_hello_all_providers_e2e.go; then
-    echo "    ✗ ERROR: Failed to compile test"
-    exit 1
-fi
-echo "    ✓ Test compiled to /tmp/test_hello_all_providers_e2e"
-echo ""
-
-# Run the test
-echo "[3] Running test..."
-echo ""
-if /tmp/test_hello_all_providers_e2e; then
-    EXIT_CODE=0
-else
-    EXIT_CODE=$?
-fi
-
-echo ""
-echo "=== Test Logs ==="
-echo "View detailed logs at: /tmp/rycode-e2e-hello-all.log"
-echo ""
-
-# Clean up
-rm -f /tmp/test_hello_all_providers_e2e
-
-exit $EXIT_CODE
diff --git a/packages/tui/test_cli_providers_e2e.go b/packages/tui/test_cli_providers_e2e.go
deleted file mode 100644
index f109f100..00000000
--- a/packages/tui/test_cli_providers_e2e.go
+++ /dev/null
@@ -1,203 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-	"os/exec"
-	"path/filepath"
-	"strings"
-	"time"
-
-	"github.com/aaronmrosenthal/rycode/internal/app"
-	"github.com/aaronmrosenthal/rycode/internal/auth"
-)
-
-func main() {
-	fmt.Println("=== E2E Test: All CLI Providers Authenticated ===\n")
-
-	// Set up logging
-	logFile, err := os.OpenFile("/tmp/rycode-e2e-cli-providers.log", os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0600)
-	if err != nil {
-		panic(err)
-	}
-	defer logFile.Close()
-
-	log := func(format string, args ...interface{}) {
-		msg := fmt.Sprintf(format, args...)
-		fmt.Println(msg)
-		fmt.Fprintf(logFile, msg+"\n")
-		logFile.Sync()
-	}
-
-	log("=== STARTING CLI PROVIDERS E2E TEST ===")
-	log("Time: %s", time.Now().Format(time.RFC3339))
-	log("Purpose: Validate ALL SOTA CLI providers are authenticated and accessible")
-	log("")
-
-	// Get project root dynamically
-	projectRoot := getProjectRoot()
-	log("Project root: %s", projectRoot)
-
-	// Create app with auth bridge
-	log("\n[1] Creating app instance...")
-	testApp := &app.App{
-		AuthBridge: auth.NewBridge(projectRoot),
-	}
-	log("    ✓ App created with auth bridge")
-
-	// Get all CLI providers
-	ctx := context.Background()
-	log("\n[2] Loading CLI providers...")
-	cliProviders, err := testApp.AuthBridge.GetCLIProviders(ctx)
-	if err != nil {
-		log("    ✗ ERROR: Failed to get CLI providers: %v", err)
-		os.Exit(1)
-	}
-	log("    ✓ Found %d CLI provider configs", len(cliProviders))
-
-	// Check authentication for each provider
-	log("\n[3] Validating authentication for all providers...")
-
-	expectedProviders := map[string]int{
-		"claude":  6,  // Expected model count
-		"qwen":    7,
-		"codex":   8,
-		"gemini":  7,
-	}
-
-	authenticatedCount := 0
-	failedProviders := []string{}
-	missingProviders := []string{}
-
-	// Check each expected provider
-	for providerID, expectedModelCount := range expectedProviders {
-		found := false
-		for _, cliProv := range cliProviders {
-			if cliProv.Provider == providerID {
-				found = true
-				authStatus, err := testApp.AuthBridge.CheckAuthStatus(ctx, providerID)
-				if err != nil {
-					log("    ✗ %s: Authentication check failed: %v", providerID, err)
-					log("       → Check if %s API key is set", getProviderEnvVar(providerID))
-					failedProviders = append(failedProviders, providerID)
-					continue
-				}
-
-				if !authStatus.IsAuthenticated {
-					log("    ✗ %s: NOT AUTHENTICATED", providerID)
-					log("       → Set %s environment variable", getProviderEnvVar(providerID))
-					log("       → Or run: rycode /auth to authenticate providers")
-					failedProviders = append(failedProviders, providerID)
-					continue
-				}
-
-				if authStatus.ModelsCount != expectedModelCount {
-					log("    ⚠️  %s: AUTHENTICATED but model count mismatch (expected %d, got %d)",
-						providerID, expectedModelCount, authStatus.ModelsCount)
-				} else {
-					log("    ✓ %s: AUTHENTICATED (%d models)", providerID, authStatus.ModelsCount)
-				}
-
-				authenticatedCount++
-				break
-			}
-		}
-
-		if !found {
-			log("    ✗ %s: NOT FOUND in CLI providers", providerID)
-			missingProviders = append(missingProviders, providerID)
-		}
-	}
-
-	// Print summary
-	log("\n=== TEST SUMMARY ===")
-	log("Expected providers: %d", len(expectedProviders))
-	log("Authenticated: %d", authenticatedCount)
-	log("Failed: %d", len(failedProviders))
-	log("Missing: %d", len(missingProviders))
-	log("")
-
-	if len(failedProviders) > 0 {
-		log("✗ Failed providers:")
-		for _, p := range failedProviders {
-			log("  - %s", p)
-		}
-		log("")
-	}
-
-	if len(missingProviders) > 0 {
-		log("✗ Missing providers:")
-		for _, p := range missingProviders {
-			log("  - %s", p)
-		}
-		log("")
-	}
-
-	log("Test logs saved to: /tmp/rycode-e2e-cli-providers.log")
-
-	// Exit with appropriate code
-	if len(failedProviders) > 0 || len(missingProviders) > 0 {
-		log("\n❌ TEST FAILED: %d provider(s) not properly configured", len(failedProviders)+len(missingProviders))
-		os.Exit(1)
-	} else {
-		log("\n✅ TEST PASSED: All %d SOTA providers are authenticated and ready!", authenticatedCount)
-		os.Exit(0)
-	}
-}
-
-// getProjectRoot dynamically discovers the project root directory
-func getProjectRoot() string {
-	// Try environment variable first
-	if root := os.Getenv("PROJECT_ROOT"); root != "" {
-		return root
-	}
-
-	// Try git root
-	cmd := exec.Command("git", "rev-parse", "--show-toplevel")
-	output, err := cmd.Output()
-	if err == nil {
-		return strings.TrimSpace(string(output))
-	}
-
-	// Fallback: try to find go.work or package.json going up from current directory
-	dir, err := os.Getwd()
-	if err == nil {
-		for {
-			// Check for go.work
-			if _, err := os.Stat(filepath.Join(dir, "go.work")); err == nil {
-				return dir
-			}
-			// Check for package.json with workspaces
-			if _, err := os.Stat(filepath.Join(dir, "package.json")); err == nil {
-				return dir
-			}
-
-			parent := filepath.Dir(dir)
-			if parent == dir {
-				break // Reached root
-			}
-			dir = parent
-		}
-	}
-
-	// Last resort: hardcoded fallback
-	return "/Users/aaron/Code/RyCode/RyCode"
-}
-
-// getProviderEnvVar returns the expected environment variable name for a provider
-func getProviderEnvVar(providerID string) string {
-	envVars := map[string]string{
-		"claude":  "ANTHROPIC_API_KEY",
-		"qwen":    "DASHSCOPE_API_KEY or QWEN_API_KEY",
-		"codex":   "OPENAI_API_KEY",
-		"gemini":  "GOOGLE_API_KEY or GEMINI_API_KEY",
-	}
-
-	if envVar, ok := envVars[providerID]; ok {
-		return envVar
-	}
-
-	// Generic fallback
-	return fmt.Sprintf("%s_API_KEY", strings.ToUpper(providerID))
-}
diff --git a/packages/tui/test_hello_all_providers_e2e.go b/packages/tui/test_hello_all_providers_e2e.go
deleted file mode 100644
index e219af59..00000000
--- a/packages/tui/test_hello_all_providers_e2e.go
+++ /dev/null
@@ -1,487 +0,0 @@
-package main
-
-import (
-	"bytes"
-	"context"
-	"encoding/json"
-	"fmt"
-	"io"
-	"net/http"
-	"os"
-	"strings"
-	"time"
-
-	"github.com/aaronmrosenthal/rycode/internal/app"
-	"github.com/aaronmrosenthal/rycode/internal/auth"
-)
-
-// SessionResponse is the response from creating a session
-type SessionResponse struct {
-	ID         string `json:"id"`
-	ProviderID string `json:"providerId"`
-	ModelID    string `json:"modelId"`
-	Error      string `json:"error,omitempty"`
-	Message    string `json:"message,omitempty"`
-}
-
-// MessageRequest is a request to send a message
-type MessageRequest struct {
-	SessionID string `json:"sessionId"`
-	Message   string `json:"message"`
-}
-
-// MessageResponse is the response from sending a message
-type MessageResponse struct {
-	Response string `json:"response"`
-	Error    string `json:"error,omitempty"`
-}
-
-// ProviderInfo holds information about a provider for testing
-type ProviderInfo struct {
-	ID           string
-	DisplayName  string
-	Models       []string
-	DefaultModel string
-}
-
-func main() {
-	fmt.Println("=== E2E Test: Hello to All SOTA Providers ===\n")
-
-	// Set up logging
-	logFile, err := os.OpenFile("/tmp/rycode-e2e-hello-all.log", os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0600)
-	if err != nil {
-		panic(err)
-	}
-	defer logFile.Close()
-
-	log := func(format string, args ...interface{}) {
-		msg := fmt.Sprintf(format, args...)
-		fmt.Println(msg)
-		fmt.Fprintf(logFile, msg+"\n")
-		logFile.Sync()
-	}
-
-	log("=== STARTING HELLO ALL PROVIDERS E2E TEST ===")
-	log("Time: %s", time.Now().Format(time.RFC3339))
-	log("Purpose: Validate ALL SOTA models respond to messages")
-	log("")
-
-	// Get project root
-	projectRoot := "/Users/aaron/Code/RyCode/RyCode"
-	log("Project root: %s", projectRoot)
-
-	// Create app with auth bridge
-	log("\n[1] Creating app instance...")
-	testApp := &app.App{
-		AuthBridge: auth.NewBridge(projectRoot),
-	}
-	log("    ✓ App created with auth bridge")
-
-	// Get all CLI providers
-	ctx := context.Background()
-	log("\n[2] Loading CLI providers...")
-	cliProviders, err := testApp.AuthBridge.GetCLIProviders(ctx)
-	if err != nil {
-		log("    ✗ ERROR: Failed to get CLI providers: %v", err)
-		os.Exit(1)
-	}
-	log("    ✓ Found %d CLI provider configs", len(cliProviders))
-
-	// Check authentication for each provider
-	log("\n[3] Checking authentication status...")
-	authenticatedProviders := []ProviderInfo{}
-
-	for _, cliProv := range cliProviders {
-		authStatus, err := testApp.AuthBridge.CheckAuthStatus(ctx, cliProv.Provider)
-		if err != nil {
-			log("    - %s: ERROR - %v", cliProv.Provider, err)
-			continue
-		}
-
-		if authStatus.IsAuthenticated {
-			displayName := getProviderDisplayName(cliProv.Provider)
-			defaultModel := getDefaultModelForProvider(cliProv.Provider, cliProv.Models)
-
-			providerInfo := ProviderInfo{
-				ID:           cliProv.Provider,
-				DisplayName:  displayName,
-				Models:       cliProv.Models,
-				DefaultModel: defaultModel,
-			}
-			authenticatedProviders = append(authenticatedProviders, providerInfo)
-
-			log("    - %s: ✓ AUTHENTICATED (%d models, default: %s)",
-				displayName, authStatus.ModelsCount, defaultModel)
-		} else {
-			log("    - %s: ✗ not authenticated", cliProv.Provider)
-		}
-	}
-
-	if len(authenticatedProviders) == 0 {
-		log("\n⚠️  FATAL: No authenticated CLI providers found!")
-		log("    Cannot test without authenticated providers")
-		log("    Run: rycode /auth to authenticate providers")
-		os.Exit(1)
-	}
-
-	log("\n    Total authenticated providers: %d", len(authenticatedProviders))
-	log("    Providers to test: %s",
-		strings.Join(getProviderNames(authenticatedProviders), ", "))
-
-	// Test each provider by sending "hello" message
-	log("\n[4] Testing message responses from each provider...")
-	log("    Test message: \"hello\"")
-	log("")
-
-	passedProviders := []string{}
-	failedProviders := []string{}
-
-	apiBaseURL := "http://127.0.0.1:4096"
-
-	for i, provider := range authenticatedProviders {
-		log("  [%d/%d] Testing %s (model: %s)...",
-			i+1, len(authenticatedProviders), provider.DisplayName, provider.DefaultModel)
-
-		// Step 1: Create session
-		sessionID, err := createSession(apiBaseURL, provider.ID, provider.DefaultModel)
-		if err != nil {
-			log("      ✗ FAILED to create session: %v", err)
-			failedProviders = append(failedProviders, provider.DisplayName)
-			continue
-		}
-		log("      ✓ Session created: %s", sessionID)
-
-		// Step 2: Send "hello" message
-		// Don't specify model - let API use default provider resolution
-		// The API will automatically pick up authenticated providers
-		response, err := sendMessage(apiBaseURL, sessionID, "hello", "", "")
-		if err != nil {
-			log("      ✗ FAILED to send message: %v", err)
-			failedProviders = append(failedProviders, provider.DisplayName)
-
-			// Clean up session
-			deleteSession(apiBaseURL, sessionID)
-			continue
-		}
-
-		// Step 3: Validate response
-		if len(response) == 0 {
-			log("      ✗ FAILED: Empty response")
-			failedProviders = append(failedProviders, provider.DisplayName)
-		} else {
-			// Truncate long responses for display
-			displayResponse := response
-			if len(displayResponse) > 100 {
-				displayResponse = displayResponse[:100] + "..."
-			}
-			log("      ✓ SUCCESS: Got response (%d chars)", len(response))
-			log("      Response preview: %s", displayResponse)
-			passedProviders = append(passedProviders, provider.DisplayName)
-		}
-
-		// Step 4: Clean up session
-		err = deleteSession(apiBaseURL, sessionID)
-		if err != nil {
-			log("      ⚠️  Warning: Failed to delete session: %v", err)
-		} else {
-			log("      ✓ Session cleaned up")
-		}
-
-		log("")
-	}
-
-	// Print summary
-	log("\n=== TEST SUMMARY ===")
-	log("Total providers tested: %d", len(authenticatedProviders))
-	log("Passed: %d", len(passedProviders))
-	log("Failed: %d", len(failedProviders))
-	log("")
-
-	if len(passedProviders) > 0 {
-		log("✓ Passed providers:")
-		for _, p := range passedProviders {
-			log("  - %s", p)
-		}
-		log("")
-	}
-
-	if len(failedProviders) > 0 {
-		log("✗ Failed providers:")
-		for _, p := range failedProviders {
-			log("  - %s", p)
-		}
-		log("")
-	}
-
-	log("Test logs saved to: /tmp/rycode-e2e-hello-all.log")
-
-	// Exit with appropriate code
-	if len(failedProviders) > 0 {
-		log("\n❌ TEST FAILED: %d provider(s) did not respond correctly", len(failedProviders))
-		os.Exit(1)
-	} else {
-		log("\n✅ TEST PASSED: All %d providers responded successfully!", len(passedProviders))
-		os.Exit(0)
-	}
-}
-
-// createSession creates a new session with the API
-func createSession(baseURL, providerID, modelID string) (string, error) {
-	// Session creation doesn't require provider/model - those are specified when sending messages
-	reqBody := map[string]interface{}{}
-
-	jsonData, err := json.Marshal(reqBody)
-	if err != nil {
-		return "", fmt.Errorf("failed to marshal request: %w", err)
-	}
-
-	resp, err := http.Post(
-		baseURL+"/session",
-		"application/json",
-		bytes.NewBuffer(jsonData),
-	)
-	if err != nil {
-		return "", fmt.Errorf("HTTP request failed: %w", err)
-	}
-	defer resp.Body.Close()
-
-	body, err := io.ReadAll(resp.Body)
-	if err != nil {
-		return "", fmt.Errorf("failed to read response: %w", err)
-	}
-
-	var sessionResp struct {
-		ID    string `json:"id"`
-		Error string `json:"error,omitempty"`
-	}
-
-	if err := json.Unmarshal(body, &sessionResp); err != nil {
-		return "", fmt.Errorf("failed to parse response: %w (body: %s)", err, string(body))
-	}
-
-	if sessionResp.Error != "" {
-		return "", fmt.Errorf("API error: %s", sessionResp.Error)
-	}
-
-	if sessionResp.ID == "" {
-		return "", fmt.Errorf("no session ID in response")
-	}
-
-	return sessionResp.ID, nil
-}
-
-// sendMessage sends a message to a session and returns the response
-func sendMessage(baseURL, sessionID, message, providerID, modelID string) (string, error) {
-	reqBody := map[string]interface{}{
-		"parts": []map[string]string{
-			{
-				"type": "text",
-				"text": message,
-			},
-		},
-	}
-
-	// Only include model if specified (let API use default otherwise)
-	if providerID != "" && modelID != "" {
-		reqBody["model"] = map[string]string{
-			"providerID": providerID,
-			"modelID":    modelID,
-		}
-	}
-
-	jsonData, err := json.Marshal(reqBody)
-	if err != nil {
-		return "", fmt.Errorf("failed to marshal request: %w", err)
-	}
-
-	resp, err := http.Post(
-		fmt.Sprintf("%s/session/%s/message", baseURL, sessionID),
-		"application/json",
-		bytes.NewBuffer(jsonData),
-	)
-	if err != nil {
-		return "", fmt.Errorf("HTTP request failed: %w", err)
-	}
-	defer resp.Body.Close()
-
-	body, err := io.ReadAll(resp.Body)
-	if err != nil {
-		return "", fmt.Errorf("failed to read response: %w", err)
-	}
-
-	// The response is a message object with parts array
-	// Extract the assistant's text response
-	var response struct {
-		Parts []struct {
-			Type string `json:"type"`
-			Text string `json:"text"`
-		} `json:"parts"`
-		Info struct {
-			Error string `json:"error,omitempty"`
-		} `json:"info"`
-	}
-
-	if err := json.Unmarshal(body, &response); err != nil {
-		return "", fmt.Errorf("failed to parse response: %w (body: %s)", err, string(body))
-	}
-
-	if response.Info.Error != "" {
-		return "", fmt.Errorf("API error: %s", response.Info.Error)
-	}
-
-	// Collect text from all text parts
-	var textParts []string
-	for _, part := range response.Parts {
-		if part.Type == "text" && part.Text != "" {
-			textParts = append(textParts, part.Text)
-		}
-	}
-
-	if len(textParts) == 0 {
-		// Debug: Show what we actually received
-		return "", fmt.Errorf("no text content in response (parts: %d, body preview: %s)",
-			len(response.Parts), truncate(string(body), 200))
-	}
-
-	return strings.Join(textParts, "\n"), nil
-}
-
-// deleteSession deletes a session
-func deleteSession(baseURL, sessionID string) error {
-	req, err := http.NewRequest("DELETE", baseURL+"/session/"+sessionID, nil)
-	if err != nil {
-		return fmt.Errorf("failed to create request: %w", err)
-	}
-
-	client := &http.Client{}
-	resp, err := client.Do(req)
-	if err != nil {
-		return fmt.Errorf("HTTP request failed: %w", err)
-	}
-	defer resp.Body.Close()
-
-	if resp.StatusCode != http.StatusOK && resp.StatusCode != http.StatusNoContent {
-		body, _ := io.ReadAll(resp.Body)
-		return fmt.Errorf("unexpected status code: %d (body: %s)", resp.StatusCode, string(body))
-	}
-
-	return nil
-}
-
-// getProviderDisplayName returns the display name for a provider
-func getProviderDisplayName(providerID string) string {
-	names := map[string]string{
-		"claude":    "Claude",
-		"anthropic": "Claude",
-		"codex":     "Codex",
-		"openai":    "Codex",
-		"gemini":    "Gemini",
-		"google":    "Gemini",
-		"grok":      "Grok",
-		"xai":       "Grok",
-		"qwen":      "Qwen",
-	}
-	if name, ok := names[providerID]; ok {
-		return name
-	}
-	return providerID
-}
-
-// getDefaultModelForProvider returns the best default model for a provider
-func getDefaultModelForProvider(providerID string, availableModels []string) string {
-	// Priority order for each provider (latest SOTA models as of 2025)
-	priorities := map[string][]string{
-		"claude": {
-			"claude-sonnet-4-5",
-			"claude-opus-4-1",
-			"claude-sonnet-4",
-			"claude-3-7-sonnet",
-			"claude-3-5-sonnet-20241022",
-		},
-		"codex": {
-			"gpt-5",
-			"o3",
-			"gpt-5-mini",
-			"gpt-4-5",
-			"gpt-4o",
-		},
-		"gemini": {
-			"gemini-2.5-pro",
-			"gemini-2.5-flash",
-			"gemini-2.5-flash-lite",
-			"gemini-exp-1206",
-		},
-		"grok": {
-			"grok-beta",
-			"grok-2-1212",
-		},
-		"qwen": {
-			"qwen3-max",
-			"qwen3-thinking-2507",
-			"qwen3-next",
-			"qwen3-omni",
-		},
-	}
-
-	// Check if we have priorities for this provider
-	if prefs, ok := priorities[providerID]; ok {
-		for _, modelID := range prefs {
-			if contains(availableModels, modelID) {
-				return modelID
-			}
-		}
-	}
-
-	// Fallback: return first available model
-	if len(availableModels) > 0 {
-		return availableModels[0]
-	}
-
-	return ""
-}
-
-// contains checks if a slice contains a string
-func contains(slice []string, item string) bool {
-	for _, s := range slice {
-		if s == item {
-			return true
-		}
-	}
-	return false
-}
-
-// getProviderNames extracts display names from provider info slice
-func getProviderNames(providers []ProviderInfo) []string {
-	names := make([]string, len(providers))
-	for i, p := range providers {
-		names[i] = p.DisplayName
-	}
-	return names
-}
-
-// truncate truncates a string to a maximum length
-func truncate(s string, maxLen int) string {
-	if len(s) <= maxLen {
-		return s
-	}
-	return s[:maxLen] + "..."
-}
-
-// mapCLIProviderToAPIProvider maps CLI provider IDs to actual API provider IDs
-func mapCLIProviderToAPIProvider(cliProviderID string) string {
-	// CLI uses friendly names, but API uses canonical provider names
-	mapping := map[string]string{
-		"claude":  "anthropic",
-		"codex":   "openai",
-		"gemini":  "google",
-		"grok":    "xai",
-		"qwen":    "qwen",
-	}
-
-	if apiProviderID, ok := mapping[cliProviderID]; ok {
-		return apiProviderID
-	}
-
-	// Return as-is if no mapping exists (already canonical)
-	return cliProviderID
-}
diff --git a/packages/tui/test_list_providers.go b/packages/tui/test_list_providers.go
deleted file mode 100644
index 6ea0888c..00000000
--- a/packages/tui/test_list_providers.go
+++ /dev/null
@@ -1,33 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-
-	"github.com/aaronmrosenthal/rycode/internal/auth"
-)
-
-func main() {
-	// Get project root (two levels up from packages/tui)
-	projectRoot := "/Users/aaron/Code/RyCode/RyCode"
-
-	// Create auth bridge
-	authBridge := auth.NewBridge(projectRoot)
-
-	// Call GetCLIProviders directly
-	cliProviders, err := authBridge.GetCLIProviders(context.Background())
-
-	if err != nil {
-		fmt.Printf("ERROR: %v\n", err)
-		os.Exit(1)
-	}
-
-	fmt.Printf("SUCCESS: Got %d CLI providers\n", len(cliProviders))
-	for _, p := range cliProviders {
-		fmt.Printf("  Provider: %s (%s) - %d models\n", p.Provider, p.Source, len(p.Models))
-		for _, model := range p.Models {
-			fmt.Printf("    - %s\n", model)
-		}
-	}
-}
diff --git a/packages/tui/test_model_selector_e2e.go b/packages/tui/test_model_selector_e2e.go
deleted file mode 100644
index 0442a400..00000000
--- a/packages/tui/test_model_selector_e2e.go
+++ /dev/null
@@ -1,243 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-	"time"
-
-	tea "github.com/charmbracelet/bubbletea/v2"
-	"github.com/aaronmrosenthal/rycode/internal/app"
-	"github.com/aaronmrosenthal/rycode/internal/auth"
-	"github.com/aaronmrosenthal/rycode/internal/components/dialog"
-)
-
-func main() {
-	fmt.Println("=== E2E Test: Model Selector with Init() ===\n")
-
-	// Set up debug logging
-	debugLog, err := os.OpenFile("/tmp/rycode-e2e-test.log", os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0600)
-	if err != nil {
-		panic(err)
-	}
-	defer debugLog.Close()
-
-	log := func(format string, args ...interface{}) {
-		msg := fmt.Sprintf(format, args...)
-		fmt.Println(msg)
-		fmt.Fprintf(debugLog, msg+"\n")
-		debugLog.Sync()
-	}
-
-	log("=== STARTING E2E TEST ===")
-	log("Time: %s", time.Now().Format(time.RFC3339))
-
-	// Get project root
-	projectRoot := "/Users/aaron/Code/RyCode/RyCode"
-	log("Project root: %s", projectRoot)
-
-	// Create app with minimal fields required
-	log("\n[1] Creating app instance...")
-	testApp := &app.App{
-		AuthBridge: auth.NewBridge(projectRoot),
-	}
-	log("    ✓ App created with auth bridge")
-
-	// Test 1: Check auth status for each CLI provider directly via bridge
-	ctx := context.Background()
-	log("\n[2] Testing auth status for CLI providers...")
-	cliProviders := []string{"anthropic", "google", "openai", "xai", "qwen"}
-	authenticatedCount := 0
-
-	for _, providerID := range cliProviders {
-		authStatus, err := testApp.AuthBridge.CheckAuthStatus(ctx, providerID)
-		if err != nil {
-			log("      - %s: ERROR - %v", providerID, err)
-			continue
-		}
-
-		if authStatus.IsAuthenticated {
-			authenticatedCount++
-			log("      - %s: ✓ AUTHENTICATED (%d models)", providerID, authStatus.ModelsCount)
-		} else {
-			log("      - %s: ✗ not authenticated", providerID)
-		}
-	}
-
-	log("    Total authenticated CLI providers: %d", authenticatedCount)
-
-	if authenticatedCount == 0 {
-		log("\n⚠️  WARNING: No authenticated CLI providers found!")
-		log("    This test will verify the empty state is shown correctly")
-		log("    To test with providers, authenticate first:")
-		log("    - claude auth login")
-		log("    - export GOOGLE_API_KEY=...")
-		log("    - export OPENAI_API_KEY=...")
-	}
-
-	// Test 2: Create model dialog (the actual component used in TUI)
-	log("\n[3] Creating ModelDialog component...")
-	modelDialog := dialog.NewModelDialog(testApp)
-	if modelDialog == nil {
-		log("    ✗ ERROR: NewModelDialog returned nil")
-		os.Exit(1)
-	}
-	log("    ✓ ModelDialog created")
-
-	// Test 3: Call Init() - THIS IS THE CRITICAL STEP
-	log("\n[4] Calling modelDialog.Init()...")
-	initCmd := modelDialog.Init()
-	if initCmd == nil {
-		log("    ✓ Init() returned nil (no async work needed)")
-	} else {
-		log("    ✓ Init() returned command")
-
-		// Execute the command to simulate what Bubble Tea does
-		log("    Executing Init() command...")
-		msg := initCmd()
-		if msg != nil {
-			log("      Command returned message: %T", msg)
-		} else {
-			log("      Command returned nil")
-		}
-	}
-
-	// Test 4: Simulate Update cycle to let initialization complete
-	log("\n[5] Simulating Bubble Tea Update cycle...")
-
-	// Send WindowSizeMsg to trigger size setup
-	sizeMsg := tea.WindowSizeMsg{Width: 80, Height: 24}
-	updatedModel, cmd := modelDialog.Update(sizeMsg)
-	log("    ✓ WindowSizeMsg processed")
-
-	if cmd != nil {
-		log("    Executing returned command...")
-		cmdMsg := cmd()
-		if cmdMsg != nil {
-			log("      Command returned: %T", cmdMsg)
-		}
-	}
-
-	// Cast back to dialog
-	modelDialog, ok := updatedModel.(dialog.ModelDialog)
-	if !ok {
-		log("    ✗ ERROR: Could not cast back to ModelDialog")
-		os.Exit(1)
-	}
-
-	// Test 5: Render the view using Render()
-	log("\n[6] Rendering ModelDialog view...")
-	view := modelDialog.Render("")
-
-	log("=== RENDERED VIEW ===")
-	log("%s", view)
-	log("=== END VIEW ===")
-
-	// Test 6: Check view content
-	log("\n[7] Analyzing rendered content...")
-
-	hasNoProviders := containsString(view, "No authenticated CLI providers found")
-	hasProviders := containsString(view, "Select Provider") || containsString(view, "models available")
-
-	if hasNoProviders {
-		log("    ✗ View shows: 'No authenticated CLI providers found'")
-		log("    This means Init() was called but no authenticated CLI providers were detected")
-		log("    Expected authenticated providers: %d", authenticatedCount)
-
-		if authenticatedCount > 0 {
-			log("\n⚠️  FAILURE: Auth check found %d providers but dialog shows none!", authenticatedCount)
-			log("    This indicates a bug in SimpleProviderToggle.loadAuthenticatedProviders()")
-			os.Exit(1)
-		} else {
-			log("\n✓ EXPECTED: No authenticated providers, dialog correctly shows empty state")
-		}
-	} else if hasProviders {
-		log("    ✓ View shows provider selection UI")
-		log("    Dialog successfully loaded and displayed providers")
-
-		// Count provider chips in view
-		chipCount := 0
-		for _, providerID := range cliProviders {
-			if containsString(view, getProviderDisplayName(providerID)) {
-				chipCount++
-			}
-		}
-		log("    Found %d provider chips in view", chipCount)
-
-		if chipCount != authenticatedCount {
-			log("\n⚠️  WARNING: Expected %d providers but found %d in view", authenticatedCount, chipCount)
-		} else {
-			log("\n✓ SUCCESS: All authenticated providers displayed correctly")
-		}
-	} else {
-		log("    ⚠️  View content unclear - neither empty state nor provider list detected")
-	}
-
-	// Test 7: Check debug log for provider loading details
-	log("\n[8] Checking debug log for provider loading details...")
-	debugLogData, err := os.ReadFile("/tmp/rycode-debug.log")
-	if err == nil {
-		debugLines := 0
-		for _, line := range []byte(string(debugLogData)) {
-			if line == '\n' {
-				debugLines++
-			}
-		}
-		log("     Debug log has %d lines", debugLines)
-		if debugLines > 0 {
-			log("     (Check /tmp/rycode-debug.log for detailed provider loading logs)")
-		}
-	}
-
-	log("\n=== TEST COMPLETE ===")
-	log("Detailed logs saved to: /tmp/rycode-e2e-test.log")
-	log("Debug logs from app: /tmp/rycode-debug.log")
-
-	// Summary
-	log("\n=== SUMMARY ===")
-	log("Authenticated CLI providers: %d", authenticatedCount)
-	log("Dialog Init() called: YES")
-	log("View rendered successfully: YES")
-
-	if hasProviders {
-		log("Status: ✓ PASS - Providers displayed correctly")
-		os.Exit(0)
-	} else if hasNoProviders && authenticatedCount == 0 {
-		log("Status: ✓ PASS - Correctly showing empty state (no providers authenticated)")
-		os.Exit(0)
-	} else {
-		log("Status: ✗ FAIL - Dialog not displaying providers correctly")
-		os.Exit(1)
-	}
-}
-
-func containsString(text, substr string) bool {
-	return len(text) > 0 && len(substr) > 0 &&
-		(text == substr || findSubstring(text, substr) >= 0)
-}
-
-func findSubstring(text, substr string) int {
-	for i := 0; i <= len(text)-len(substr); i++ {
-		if text[i:i+len(substr)] == substr {
-			return i
-		}
-	}
-	return -1
-}
-
-func getProviderDisplayName(providerID string) string {
-	switch providerID {
-	case "anthropic":
-		return "Claude"
-	case "google":
-		return "Gemini"
-	case "openai":
-		return "GPT-5"
-	case "xai":
-		return "Grok"
-	case "qwen":
-		return "Qwen"
-	default:
-		return providerID
-	}
-}
diff --git a/packages/tui/test_model_selector_tab_e2e.go b/packages/tui/test_model_selector_tab_e2e.go
deleted file mode 100644
index 86dd52f8..00000000
--- a/packages/tui/test_model_selector_tab_e2e.go
+++ /dev/null
@@ -1,266 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-	"time"
-
-	tea "github.com/charmbracelet/bubbletea/v2"
-	"github.com/aaronmrosenthal/rycode/internal/app"
-	"github.com/aaronmrosenthal/rycode/internal/auth"
-	"github.com/aaronmrosenthal/rycode/internal/components/dialog"
-)
-
-func main() {
-	fmt.Println("=== E2E Test: Tab Cycling & Model Selection ===\n")
-
-	// Set up debug logging
-	debugLog, err := os.OpenFile("/tmp/rycode-e2e-tab-test.log", os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0600)
-	if err != nil {
-		panic(err)
-	}
-	defer debugLog.Close()
-
-	log := func(format string, args ...interface{}) {
-		msg := fmt.Sprintf(format, args...)
-		fmt.Println(msg)
-		fmt.Fprintf(debugLog, msg+"\n")
-		debugLog.Sync()
-	}
-
-	log("=== STARTING TAB CYCLING E2E TEST ===")
-	log("Time: %s", time.Now().Format(time.RFC3339))
-
-	// Get project root
-	projectRoot := "/Users/aaron/Code/RyCode/RyCode"
-	log("Project root: %s", projectRoot)
-
-	// Create app with minimal fields required
-	log("\n[1] Creating app instance...")
-	testApp := &app.App{
-		AuthBridge: auth.NewBridge(projectRoot),
-	}
-	log("    ✓ App created with auth bridge")
-
-	// Check authenticated providers
-	ctx := context.Background()
-	log("\n[2] Checking authenticated CLI providers...")
-	cliProviders, err := testApp.AuthBridge.GetCLIProviders(ctx)
-	if err != nil {
-		log("    ✗ ERROR: Failed to get CLI providers: %v", err)
-		os.Exit(1)
-	}
-
-	authenticatedProviders := []string{}
-	for _, cliProv := range cliProviders {
-		authStatus, err := testApp.AuthBridge.CheckAuthStatus(ctx, cliProv.Provider)
-		if err != nil {
-			log("      - %s: ERROR - %v", cliProv.Provider, err)
-			continue
-		}
-		if authStatus.IsAuthenticated {
-			authenticatedProviders = append(authenticatedProviders, cliProv.Provider)
-			log("      - %s: ✓ AUTHENTICATED (%d models)", cliProv.Provider, authStatus.ModelsCount)
-		} else {
-			log("      - %s: ✗ not authenticated", cliProv.Provider)
-		}
-	}
-
-	if len(authenticatedProviders) == 0 {
-		log("\n⚠️  WARNING: No authenticated CLI providers found!")
-		log("    Cannot test Tab cycling without authenticated providers")
-		os.Exit(1)
-	}
-
-	log("    Total authenticated providers: %d", len(authenticatedProviders))
-
-	// Create ModelDialog
-	log("\n[3] Creating ModelDialog...")
-	modelDialog := dialog.NewModelDialog(testApp)
-	if modelDialog == nil {
-		log("    ✗ ERROR: NewModelDialog returned nil")
-		os.Exit(1)
-	}
-	log("    ✓ ModelDialog created")
-
-	// Initialize the dialog
-	log("\n[4] Calling modelDialog.Init()...")
-	initCmd := modelDialog.Init()
-	if initCmd != nil {
-		log("    Executing Init() command...")
-		msg := initCmd()
-		if msg != nil {
-			log("      Command returned message: %T", msg)
-		}
-	}
-
-	// Send WindowSizeMsg
-	log("\n[5] Sending WindowSizeMsg...")
-	sizeMsg := tea.WindowSizeMsg{Width: 100, Height: 30}
-	updatedModel, cmd := modelDialog.Update(sizeMsg)
-	modelDialog = updatedModel.(dialog.ModelDialog)
-	if cmd != nil {
-		cmd()
-	}
-	log("    ✓ Window size set")
-
-	// Test Tab key cycling
-	log("\n[6] Testing Tab key cycling through providers...")
-
-	// Create Tab key message
-	tabMsg := tea.KeyPressMsg{
-		Code: tea.KeyTab,
-	}
-
-	expectedCycles := min(len(authenticatedProviders), 5)
-	log("    Will cycle through %d providers using Tab", expectedCycles)
-
-	for i := 0; i < expectedCycles; i++ {
-		log("\n    [Cycle %d] Pressing Tab...", i+1)
-
-		updatedModel, cmd := modelDialog.Update(tabMsg)
-		modelDialog = updatedModel.(dialog.ModelDialog)
-
-		if cmd != nil {
-			log("      Tab returned a command (executing)")
-			cmd()
-		} else {
-			log("      Tab returned nil command")
-		}
-
-		// Don't render (theme not initialized in test), just check the cycling worked
-		log("      ✓ Tab cycle completed")
-
-		// Small delay to simulate real usage
-		time.Sleep(10 * time.Millisecond)
-	}
-
-	log("\n[7] Tab cycling completed successfully")
-
-	// Test Enter key selection
-	log("\n[8] Testing Enter key to select provider...")
-
-	enterMsg := tea.KeyPressMsg{
-		Code: tea.KeyEnter,
-	}
-
-	updatedModel, cmd = modelDialog.Update(enterMsg)
-	modelDialog = updatedModel.(dialog.ModelDialog)
-
-	if cmd != nil {
-		log("    ✓ Enter key returned a command")
-		msg := cmd()
-
-		// Check if we got a ModelSelectedMsg
-		if msg != nil {
-			switch m := msg.(type) {
-			case app.ModelSelectedMsg:
-				log("    ✓ SUCCESS: ModelSelectedMsg received!")
-				log("      Provider: %s (ID: %s)", m.Provider.Name, m.Provider.ID)
-				log("      Model: %s (ID: %s)", m.Model.Name, m.Model.ID)
-				log("      Provider has %d models", len(m.Provider.Models))
-			default:
-				log("    ⚠️  Enter returned message type: %T", msg)
-			}
-		} else {
-			log("    ⚠️  Enter returned nil message")
-		}
-	} else {
-		log("    ✗ Enter key returned nil command (unexpected)")
-	}
-
-	// Check debug log for Tab events
-	log("\n[9] Checking debug log for Tab key events...")
-	debugLogData, err := os.ReadFile("/tmp/rycode-debug.log")
-	if err == nil {
-		debugContent := string(debugLogData)
-
-		tabKeyPressCount := countOccurrences(debugContent, "SimpleProviderToggle KeyPress:")
-		tabMatchedCount := countOccurrences(debugContent, "Tab key MATCHED!")
-		cyclingCount := countOccurrences(debugContent, "Tab cycling:")
-
-		log("     Found in /tmp/rycode-debug.log:")
-		log("       - KeyPress events: %d", tabKeyPressCount)
-		log("       - Tab matched: %d", tabMatchedCount)
-		log("       - Cycling events: %d", cyclingCount)
-
-		if tabKeyPressCount >= expectedCycles {
-			log("     ✓ Tab key events were recorded")
-		} else {
-			log("     ⚠️  Expected %d Tab events, found %d", expectedCycles, tabKeyPressCount)
-		}
-
-		if tabMatchedCount >= expectedCycles {
-			log("     ✓ Tab key matching worked")
-		} else {
-			log("     ⚠️  Expected %d Tab matches, found %d", expectedCycles, tabMatchedCount)
-		}
-	} else {
-		log("     Could not read /tmp/rycode-debug.log: %v", err)
-	}
-
-	log("\n=== TEST COMPLETE ===")
-	log("Test logs saved to: /tmp/rycode-e2e-tab-test.log")
-	log("Debug logs from app: /tmp/rycode-debug.log")
-
-	// Summary
-	log("\n=== SUMMARY ===")
-	log("Authenticated providers: %d", len(authenticatedProviders))
-	log("Tab cycles tested: %d", expectedCycles)
-	log("Status: ✓ PASS - Tab cycling and selection working")
-
-	os.Exit(0)
-}
-
-func containsString(text, substr string) bool {
-	return len(text) > 0 && len(substr) > 0 &&
-		(text == substr || findSubstring(text, substr) >= 0)
-}
-
-func findSubstring(text, substr string) int {
-	for i := 0; i <= len(text)-len(substr); i++ {
-		if text[i:i+len(substr)] == substr {
-			return i
-		}
-	}
-	return -1
-}
-
-func countOccurrences(text, substr string) int {
-	count := 0
-	index := 0
-	for {
-		pos := findSubstring(text[index:], substr)
-		if pos < 0 {
-			break
-		}
-		count++
-		index += pos + len(substr)
-	}
-	return count
-}
-
-func getProviderDisplayName(providerID string) string {
-	switch providerID {
-	case "claude", "anthropic":
-		return "Claude"
-	case "gemini", "google":
-		return "Gemini"
-	case "codex", "openai":
-		return "Codex"
-	case "grok", "xai":
-		return "Grok"
-	case "qwen":
-		return "Qwen"
-	default:
-		return providerID
-	}
-}
-
-func min(a, b int) int {
-	if a < b {
-		return a
-	}
-	return b
-}
diff --git a/packages/tui/test_models_direct.go b/packages/tui/test_models_direct.go
deleted file mode 100644
index 8bd949fe..00000000
--- a/packages/tui/test_models_direct.go
+++ /dev/null
@@ -1,105 +0,0 @@
-// Direct test that proves model dialog loads all providers
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-
-	"github.com/aaronmrosenthal/rycode-sdk-go"
-	"github.com/aaronmrosenthal/rycode-sdk-go/option"
-	"github.com/aaronmrosenthal/rycode/internal/app"
-	"github.com/aaronmrosenthal/rycode/internal/auth"
-)
-
-func main() {
-	fmt.Println("=== DIRECT MODEL DIALOG TEST ===\n")
-
-	// Initialize HTTP client
-	url := os.Getenv("RYCODE_SERVER")
-	if url == "" {
-		url = "http://127.0.0.1:4096"
-	}
-
-	httpClient := opencode.NewClient(option.WithBaseURL(url))
-
-	// Get project info
-	project, err := httpClient.Project.Current(context.Background(), opencode.ProjectCurrentParams{})
-	if err != nil {
-		fmt.Printf("ERROR: Failed to get project: %v\n", err)
-		return
-	}
-
-	// Create auth bridge directly
-	bridge := auth.NewBridge(project.Worktree)
-	fmt.Println("✅ Auth bridge created")
-
-	// Test 1: Get CLI providers
-	fmt.Println("\n--- Test 1: CLI Providers ---")
-	cliProviders, err := bridge.GetCLIProviders(context.Background())
-	if err != nil {
-		fmt.Printf("❌ GetCLIProviders failed: %v\n", err)
-	} else {
-		fmt.Printf("✅ Found %d CLI providers:\n", len(cliProviders))
-		totalCLIModels := 0
-		for _, p := range cliProviders {
-			fmt.Printf("   - %s: %d models\n", p.Provider, len(p.Models))
-			totalCLIModels += len(p.Models)
-		}
-		fmt.Printf("   Total CLI models: %d\n", totalCLIModels)
-	}
-
-	// Test 2: Get API providers (through App.Providers)
-	fmt.Println("\n--- Test 2: API Providers ---")
-	apiProviders, err := httpClient.App.Providers(context.Background(), opencode.AppProvidersParams{})
-	if err != nil {
-		fmt.Printf("❌ App.Providers failed: %v\n", err)
-	} else {
-		fmt.Printf("✅ Found %d API providers:\n", len(apiProviders.Providers))
-		totalAPIModels := 0
-		for _, p := range apiProviders.Providers {
-			fmt.Printf("   - %s: %d models\n", p.Name, len(p.Models))
-			totalAPIModels += len(p.Models)
-		}
-		fmt.Printf("   Total API models: %d\n", totalAPIModels)
-	}
-
-	// Test 3: Create minimal app and test ListProviders (the merging function)
-	fmt.Println("\n--- Test 3: ListProviders (Merged) ---")
-
-	// Create minimal app struct with just what we need
-	testApp := &app.App{
-		Client:     httpClient,
-		AuthBridge: bridge,
-		Providers:  []opencode.Provider{},
-	}
-
-	mergedProviders, err := testApp.ListProviders(context.Background())
-	if err != nil {
-		fmt.Printf("❌ ListProviders failed: %v\n", err)
-	} else {
-		fmt.Printf("✅ Found %d MERGED providers:\n", len(mergedProviders))
-		totalMergedModels := 0
-		for _, p := range mergedProviders {
-			fmt.Printf("   - %s (%s): %d models\n", p.Name, p.ID, len(p.Models))
-			totalMergedModels += len(p.Models)
-
-			// Show first 3 models as sample
-			count := 0
-			for modelID := range p.Models {
-				if count < 3 {
-					fmt.Printf("      * %s\n", modelID)
-					count++
-				}
-			}
-			if len(p.Models) > 3 {
-				fmt.Printf("      * ... and %d more\n", len(p.Models)-3)
-			}
-		}
-		fmt.Printf("\n   🎯 TOTAL MERGED MODELS: %d\n", totalMergedModels)
-	}
-
-	fmt.Println("\n=== TEST COMPLETE ===")
-	fmt.Println("\nThis PROVES that ListProviders() merges API + CLI providers.")
-	fmt.Println("The model dialog calls this same function, so it WILL see all models.")
-}
diff --git a/packages/tui/test_models_integration.go b/packages/tui/test_models_integration.go
deleted file mode 100644
index 9ae00643..00000000
--- a/packages/tui/test_models_integration.go
+++ /dev/null
@@ -1,71 +0,0 @@
-package main
-
-import (
-	"context"
-	"fmt"
-	"os"
-
-	"github.com/aaronmrosenthal/rycode/internal/app"
-	"github.com/aaronmrosenthal/rycode/internal/components/dialog"
-)
-
-func main() {
-	fmt.Println("=== Testing Model Dialog Integration ===\n")
-
-	// Set up debug logging
-	debugLog, err := os.OpenFile("/tmp/rycode-models-test.log", os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644)
-	if err != nil {
-		panic(err)
-	}
-	defer debugLog.Close()
-
-	// Get project root (assuming we're in packages/tui)
-	projectRoot := "/Users/aaron/Code/RyCode/RyCode"
-
-	fmt.Fprintf(debugLog, "=== MODELS INTEGRATION TEST ===\n")
-	fmt.Fprintf(debugLog, "Project root: %s\n", projectRoot)
-
-	// Create minimal app struct
-	testApp := &app.App{}
-
-	// Initialize auth bridge
-	fmt.Println("Initializing auth bridge...")
-	testApp.InitAuthBridge(projectRoot)
-	fmt.Fprintf(debugLog, "Auth bridge initialized\n")
-
-	// List all providers through the app
-	fmt.Println("Listing providers...")
-	providers, err := testApp.ListProviders(context.Background())
-	if err != nil {
-		fmt.Fprintf(debugLog, "ERROR: %v\n", err)
-		fmt.Printf("ERROR listing providers: %v\n", err)
-		return
-	}
-
-	fmt.Fprintf(debugLog, "Found %d providers:\n", len(providers))
-	fmt.Printf("Found %d providers:\n", len(providers))
-
-	totalModels := 0
-	for _, provider := range providers {
-		modelCount := len(provider.Models)
-		totalModels += modelCount
-		fmt.Fprintf(debugLog, "  - %s (%s): %d models\n", provider.Name, provider.ID, modelCount)
-		fmt.Printf("  - %s (%s): %d models\n", provider.Name, provider.ID, modelCount)
-
-		for modelID, model := range provider.Models {
-			fmt.Fprintf(debugLog, "      * %s (%s)\n", model.Name, modelID)
-		}
-	}
-
-	fmt.Fprintf(debugLog, "\nTotal models: %d\n", totalModels)
-	fmt.Printf("\nTotal models: %d\n", totalModels)
-
-	// Create model dialog
-	fmt.Println("\nCreating model dialog...")
-	modelDialog := dialog.NewModelDialog(testApp)
-	fmt.Fprintf(debugLog, "Model dialog created: %v\n", modelDialog != nil)
-	fmt.Printf("Model dialog created successfully!\n")
-
-	fmt.Println("\n=== Test Complete ===")
-	fmt.Printf("Check /tmp/rycode-models-test.log for details\n")
-}
diff --git a/packages/tui/test_theme_accessibility.go b/packages/tui/test_theme_accessibility.go
deleted file mode 100644
index 958a59f3..00000000
--- a/packages/tui/test_theme_accessibility.go
+++ /dev/null
@@ -1,215 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"image/color"
-	"math"
-	"os"
-
-	"github.com/aaronmrosenthal/rycode/internal/theme"
-	"github.com/charmbracelet/lipgloss/v2/compat"
-)
-
-// ContrastRatio calculates the WCAG contrast ratio between two colors
-func ContrastRatio(c1, c2 color.Color) float64 {
-	l1 := relativeLuminance(c1)
-	l2 := relativeLuminance(c2)
-
-	if l1 > l2 {
-		return (l1 + 0.05) / (l2 + 0.05)
-	}
-	return (l2 + 0.05) / (l1 + 0.05)
-}
-
-// relativeLuminance calculates the relative luminance of a color
-func relativeLuminance(c color.Color) float64 {
-	r, g, b, _ := c.RGBA()
-
-	// Convert to 0-1 range
-	rNorm := float64(r) / 65535.0
-	gNorm := float64(g) / 65535.0
-	bNorm := float64(b) / 65535.0
-
-	// Apply gamma correction
-	rLinear := toLinear(rNorm)
-	gLinear := toLinear(gNorm)
-	bLinear := toLinear(bNorm)
-
-	// Calculate luminance
-	return 0.2126*rLinear + 0.7152*gLinear + 0.0722*bLinear
-}
-
-// toLinear applies gamma correction
-func toLinear(v float64) float64 {
-	if v <= 0.03928 {
-		return v / 12.92
-	}
-	return math.Pow((v+0.055)/1.055, 2.4)
-}
-
-// adaptiveColorToColor extracts the dark variant from AdaptiveColor
-func adaptiveColorToColor(ac compat.AdaptiveColor) color.Color {
-	return ac.Dark
-}
-
-// ColorTest represents a single contrast test
-type ColorTest struct {
-	Name       string
-	Foreground color.Color
-	Background color.Color
-	MinRatio   float64 // 4.5 for AA normal text, 3.0 for AA large text, 7.0 for AAA
-}
-
-func main() {
-	fmt.Println("=== Theme Accessibility Audit ===")
-	fmt.Println("WCAG 2.1 Contrast Requirements:")
-	fmt.Println("  AA Normal Text: 4.5:1")
-	fmt.Println("  AA Large Text:  3.0:1")
-	fmt.Println("  AAA Normal Text: 7.0:1")
-	fmt.Println()
-
-	providers := []string{"claude", "gemini", "codex", "qwen"}
-	allPassed := true
-
-	for _, providerID := range providers {
-		fmt.Printf("=== %s Theme ===\n", providerID)
-
-		// Switch to provider theme
-		theme.SwitchToProvider(providerID)
-		t := theme.CurrentTheme()
-
-		if t == nil {
-			fmt.Printf("  ✗ ERROR: Could not load theme\n\n")
-			allPassed = false
-			continue
-		}
-
-		tests := []ColorTest{
-			// Primary text on background
-			{
-				Name:       "Text on Background",
-				Foreground: adaptiveColorToColor(t.Text()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   4.5,
-			},
-			// Muted text on background
-			{
-				Name:       "Muted Text on Background",
-				Foreground: adaptiveColorToColor(t.TextMuted()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   4.5,
-			},
-			// Primary text on panel
-			{
-				Name:       "Text on Panel",
-				Foreground: adaptiveColorToColor(t.Text()),
-				Background: adaptiveColorToColor(t.BackgroundPanel()),
-				MinRatio:   4.5,
-			},
-			// Border on background (large text/UI components)
-			{
-				Name:       "Border on Background",
-				Foreground: adaptiveColorToColor(t.Border()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   3.0, // Large text standard
-			},
-			// Primary color on background
-			{
-				Name:       "Primary on Background",
-				Foreground: adaptiveColorToColor(t.Primary()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   3.0, // For UI elements
-			},
-			// Success color on background
-			{
-				Name:       "Success on Background",
-				Foreground: adaptiveColorToColor(t.Success()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   3.0,
-			},
-			// Error color on background
-			{
-				Name:       "Error on Background",
-				Foreground: adaptiveColorToColor(t.Error()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   3.0,
-			},
-			// Warning color on background
-			{
-				Name:       "Warning on Background",
-				Foreground: adaptiveColorToColor(t.Warning()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   3.0,
-			},
-			// Info color on background
-			{
-				Name:       "Info on Background",
-				Foreground: adaptiveColorToColor(t.Info()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   3.0,
-			},
-			// Markdown heading on background
-			{
-				Name:       "Markdown Heading on Background",
-				Foreground: adaptiveColorToColor(t.MarkdownHeading()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   4.5,
-			},
-			// Markdown link on background
-			{
-				Name:       "Markdown Link on Background",
-				Foreground: adaptiveColorToColor(t.MarkdownLink()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   4.5,
-			},
-			// Markdown code on background
-			{
-				Name:       "Markdown Code on Background",
-				Foreground: adaptiveColorToColor(t.MarkdownCode()),
-				Background: adaptiveColorToColor(t.Background()),
-				MinRatio:   4.5,
-			},
-		}
-
-		passed := 0
-		failed := 0
-
-		for _, test := range tests {
-			ratio := ContrastRatio(test.Foreground, test.Background)
-			status := "✓"
-			statusText := "PASS"
-
-			if ratio < test.MinRatio {
-				status = "✗"
-				statusText = "FAIL"
-				failed++
-				allPassed = false
-			} else {
-				passed++
-			}
-
-			// Determine WCAG level
-			wcagLevel := ""
-			if ratio >= 7.0 {
-				wcagLevel = "AAA"
-			} else if ratio >= 4.5 {
-				wcagLevel = "AA "
-			} else if ratio >= 3.0 {
-				wcagLevel = "AA Large"
-			}
-
-			fmt.Printf("  %s %-35s %.2f:1 (req %.1f:1) [%s] %s\n",
-				status, test.Name, ratio, test.MinRatio, wcagLevel, statusText)
-		}
-
-		fmt.Printf("\nSummary: %d passed, %d failed\n\n", passed, failed)
-	}
-
-	if allPassed {
-		fmt.Println("✅ All themes pass WCAG AA accessibility standards!")
-		os.Exit(0)
-	} else {
-		fmt.Println("❌ Some themes have accessibility issues. See failures above.")
-		os.Exit(1)
-	}
-}
diff --git a/packages/tui/test_theme_performance.go b/packages/tui/test_theme_performance.go
deleted file mode 100644
index 6c8dbe23..00000000
--- a/packages/tui/test_theme_performance.go
+++ /dev/null
@@ -1,261 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"os"
-	"runtime"
-	"time"
-
-	"github.com/aaronmrosenthal/rycode/internal/theme"
-)
-
-// PerformanceTest represents a single performance measurement
-type PerformanceTest struct {
-	Name        string
-	Iterations  int
-	MaxDuration time.Duration
-	Fn          func()
-}
-
-// Run executes the performance test
-func (pt *PerformanceTest) Run() (time.Duration, bool) {
-	// Warm up
-	for i := 0; i < 10; i++ {
-		pt.Fn()
-	}
-
-	// Force garbage collection before test
-	runtime.GC()
-
-	// Measure
-	start := time.Now()
-	for i := 0; i < pt.Iterations; i++ {
-		pt.Fn()
-	}
-	elapsed := time.Since(start)
-
-	avgDuration := elapsed / time.Duration(pt.Iterations)
-	passed := avgDuration <= pt.MaxDuration
-
-	return avgDuration, passed
-}
-
-func main() {
-	fmt.Println("=== Theme Performance Benchmark ===")
-	fmt.Println("Target: <10ms per theme switch")
-	fmt.Println("Goal: Imperceptible to users (<16.67ms = 60fps)")
-	fmt.Println()
-
-	providers := []string{"claude", "gemini", "codex", "qwen"}
-	allPassed := true
-
-	// Test 1: Theme Switching Speed
-	fmt.Println("[Test 1] Theme Switching Performance")
-	fmt.Println("Switching between all 4 providers in sequence...")
-	fmt.Println()
-
-	test := PerformanceTest{
-		Name:        "Sequential Theme Switch",
-		Iterations:  1000,
-		MaxDuration: 10 * time.Millisecond,
-		Fn: func() {
-			for _, providerID := range providers {
-				theme.SwitchToProvider(providerID)
-			}
-		},
-	}
-
-	avgDuration, passed := test.Run()
-	status := "✓ PASS"
-	if !passed {
-		status = "✗ FAIL"
-		allPassed = false
-	}
-
-	perSwitchDuration := avgDuration / time.Duration(len(providers))
-	fmt.Printf("  %s Average per switch: %v (target: <10ms)\n", status, perSwitchDuration)
-	fmt.Printf("       Total 4 switches: %v\n", avgDuration)
-	fmt.Printf("       Iterations: %d\n", test.Iterations)
-	fmt.Println()
-
-	// Test 2: Theme Retrieval Speed
-	fmt.Println("[Test 2] Theme Retrieval Performance")
-	fmt.Println("Getting current theme repeatedly...")
-	fmt.Println()
-
-	theme.SwitchToProvider("claude")
-	test2 := PerformanceTest{
-		Name:        "CurrentTheme() Call",
-		Iterations:  100000,
-		MaxDuration: 100 * time.Nanosecond, // Should be extremely fast
-		Fn: func() {
-			_ = theme.CurrentTheme()
-		},
-	}
-
-	avgDuration2, passed2 := test2.Run()
-	status2 := "✓ PASS"
-	if !passed2 {
-		status2 = "✗ FAIL"
-		allPassed = false
-	}
-
-	fmt.Printf("  %s Average: %v (target: <100ns)\n", status2, avgDuration2)
-	fmt.Printf("       Iterations: %d\n", test2.Iterations)
-	fmt.Println()
-
-	// Test 3: Color Access Speed
-	fmt.Println("[Test 3] Color Access Performance")
-	fmt.Println("Accessing theme colors (Primary, Text, Border)...")
-	fmt.Println()
-
-	test3 := PerformanceTest{
-		Name:        "Color Access",
-		Iterations:  100000,
-		MaxDuration: 200 * time.Nanosecond,
-		Fn: func() {
-			t := theme.CurrentTheme()
-			_ = t.Primary()
-			_ = t.Text()
-			_ = t.Border()
-		},
-	}
-
-	avgDuration3, passed3 := test3.Run()
-	status3 := "✓ PASS"
-	if !passed3 {
-		status3 = "✗ FAIL"
-		allPassed = false
-	}
-
-	fmt.Printf("  %s Average: %v (target: <200ns)\n", status3, avgDuration3)
-	fmt.Printf("       Iterations: %d\n", test3.Iterations)
-	fmt.Println()
-
-	// Test 4: Memory Allocation During Switch
-	fmt.Println("[Test 4] Memory Allocation")
-	fmt.Println("Measuring memory usage during theme switches...")
-	fmt.Println()
-
-	runtime.GC()
-	var memStats runtime.MemStats
-	runtime.ReadMemStats(&memStats)
-	allocsBefore := memStats.Alloc
-
-	for i := 0; i < 1000; i++ {
-		for _, providerID := range providers {
-			theme.SwitchToProvider(providerID)
-		}
-	}
-
-	runtime.ReadMemStats(&memStats)
-	allocsAfter := memStats.Alloc
-
-	allocsPerSwitch := (allocsAfter - allocsBefore) / (1000 * uint64(len(providers)))
-
-	// Target: <1KB per switch
-	memPassed := allocsPerSwitch < 1024
-	status4 := "✓ PASS"
-	if !memPassed {
-		status4 = "✗ FAIL"
-		allPassed = false
-	}
-
-	fmt.Printf("  %s Allocs per switch: %d bytes (target: <1KB)\n", status4, allocsPerSwitch)
-	fmt.Printf("       Total switches: %d\n", 1000*len(providers))
-	fmt.Println()
-
-	// Test 5: Rapid Switching Stress Test
-	fmt.Println("[Test 5] Rapid Switching Stress Test")
-	fmt.Println("Simulating rapid Tab presses...")
-	fmt.Println()
-
-	test5 := PerformanceTest{
-		Name:        "Rapid Switch",
-		Iterations:  100,
-		MaxDuration: 5 * time.Millisecond, // Faster than Test 1 (single switch)
-		Fn: func() {
-			// Simulate user rapidly pressing Tab
-			theme.SwitchToProvider("claude")
-			theme.SwitchToProvider("gemini")
-			theme.SwitchToProvider("codex")
-			theme.SwitchToProvider("qwen")
-		},
-	}
-
-	avgDuration5, passed5 := test5.Run()
-	status5 := "✓ PASS"
-	if !passed5 {
-		status5 = "✗ FAIL"
-		allPassed = false
-	}
-
-	perSwitchDuration5 := avgDuration5 / 4
-	fmt.Printf("  %s Average per switch: %v (target: <5ms)\n", status5, perSwitchDuration5)
-	fmt.Printf("       Total 4 switches: %v\n", avgDuration5)
-	fmt.Printf("       Iterations: %d\n", test5.Iterations)
-	fmt.Println()
-
-	// Summary
-	fmt.Println("=== Performance Summary ===")
-	fmt.Println()
-
-	if allPassed {
-		fmt.Println("✅ All performance tests passed!")
-		fmt.Println()
-		fmt.Println("Performance Analysis:")
-		fmt.Printf("  • Theme switching is %s (target: <10ms)\n", formatSpeed(perSwitchDuration))
-		fmt.Printf("  • Theme retrieval is %s (target: <100ns)\n", formatSpeed(avgDuration2))
-		fmt.Printf("  • Color access is %s (target: <200ns)\n", formatSpeed(avgDuration3))
-		fmt.Printf("  • Memory usage is %s per switch\n", formatBytes(allocsPerSwitch))
-		fmt.Println()
-		fmt.Println("User Experience:")
-		if perSwitchDuration < 16670*time.Microsecond {
-			fmt.Println("  ⚡ Switching is faster than 60fps (imperceptible)")
-		} else if perSwitchDuration < 33333*time.Microsecond {
-			fmt.Println("  🚀 Switching is faster than 30fps (very smooth)")
-		} else {
-			fmt.Println("  ✓ Switching is acceptably fast")
-		}
-		fmt.Println()
-		os.Exit(0)
-	} else {
-		fmt.Println("❌ Some performance tests failed!")
-		fmt.Println()
-		fmt.Println("Optimization needed:")
-		if !passed {
-			fmt.Println("  • Theme switching is too slow")
-		}
-		if !passed2 {
-			fmt.Println("  • Theme retrieval needs optimization")
-		}
-		if !passed3 {
-			fmt.Println("  • Color access needs caching")
-		}
-		if !memPassed {
-			fmt.Println("  • Memory allocations too high")
-		}
-		fmt.Println()
-		os.Exit(1)
-	}
-}
-
-func formatSpeed(d time.Duration) string {
-	if d < time.Microsecond {
-		return fmt.Sprintf("%.0fns", float64(d.Nanoseconds()))
-	} else if d < time.Millisecond {
-		return fmt.Sprintf("%.2fμs", float64(d.Nanoseconds())/1000.0)
-	} else {
-		return fmt.Sprintf("%.2fms", float64(d.Nanoseconds())/1000000.0)
-	}
-}
-
-func formatBytes(b uint64) string {
-	if b < 1024 {
-		return fmt.Sprintf("%d bytes", b)
-	} else if b < 1024*1024 {
-		return fmt.Sprintf("%.2f KB", float64(b)/1024.0)
-	} else {
-		return fmt.Sprintf("%.2f MB", float64(b)/(1024.0*1024.0))
-	}
-}
diff --git a/packages/tui/test_theme_switching.go b/packages/tui/test_theme_switching.go
deleted file mode 100644
index 071d72e5..00000000
--- a/packages/tui/test_theme_switching.go
+++ /dev/null
@@ -1,102 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"os"
-
-	"github.com/aaronmrosenthal/rycode/internal/theme"
-)
-
-func main() {
-	fmt.Println("=== Theme Switching Test ===\n")
-
-	// Test 1: Get initial theme (should be Claude by default)
-	fmt.Println("[Test 1] Initial theme:")
-	currentTheme := theme.CurrentTheme()
-	if currentTheme == nil {
-		fmt.Println("  ✗ ERROR: No theme loaded")
-		os.Exit(1)
-	}
-	fmt.Printf("  ✓ Theme loaded: %s\n", currentTheme.Name())
-	fmt.Printf("    Primary color: %v\n", currentTheme.Primary())
-	fmt.Println()
-
-	// Test 2: Switch to Gemini
-	fmt.Println("[Test 2] Switch to Gemini:")
-	changed := theme.SwitchToProvider("gemini")
-	if !changed {
-		fmt.Println("  ✗ ERROR: Theme did not change")
-		os.Exit(1)
-	}
-	currentTheme = theme.CurrentTheme()
-	fmt.Printf("  ✓ Switched to: %s\n", currentTheme.Name())
-	fmt.Printf("    Primary color: %v (should be blue #4285F4)\n", currentTheme.Primary())
-	fmt.Println()
-
-	// Test 3: Switch to Codex
-	fmt.Println("[Test 3] Switch to Codex:")
-	changed = theme.SwitchToProvider("codex")
-	if !changed {
-		fmt.Println("  ✗ ERROR: Theme did not change")
-		os.Exit(1)
-	}
-	currentTheme = theme.CurrentTheme()
-	fmt.Printf("  ✓ Switched to: %s\n", currentTheme.Name())
-	fmt.Printf("    Primary color: %v (should be teal #10A37F)\n", currentTheme.Primary())
-	fmt.Println()
-
-	// Test 4: Switch to Qwen
-	fmt.Println("[Test 4] Switch to Qwen:")
-	changed = theme.SwitchToProvider("qwen")
-	if !changed {
-		fmt.Println("  ✗ ERROR: Theme did not change")
-		os.Exit(1)
-	}
-	currentTheme = theme.CurrentTheme()
-	fmt.Printf("  ✓ Switched to: %s\n", currentTheme.Name())
-	fmt.Printf("    Primary color: %v (should be orange #FF6A00)\n", currentTheme.Primary())
-	fmt.Println()
-
-	// Test 5: Switch back to Claude
-	fmt.Println("[Test 5] Switch back to Claude:")
-	changed = theme.SwitchToProvider("claude")
-	if !changed {
-		fmt.Println("  ✗ ERROR: Theme did not change")
-		os.Exit(1)
-	}
-	currentTheme = theme.CurrentTheme()
-	fmt.Printf("  ✓ Switched to: %s\n", currentTheme.Name())
-	fmt.Printf("    Primary color: %v (should be copper #D4754C)\n", currentTheme.Primary())
-	fmt.Println()
-
-	// Test 6: Try invalid provider (should not panic)
-	fmt.Println("[Test 6] Try invalid provider:")
-	changed = theme.SwitchToProvider("invalid")
-	if changed {
-		fmt.Println("  ✗ ERROR: Theme changed for invalid provider")
-		os.Exit(1)
-	}
-	fmt.Println("  ✓ Invalid provider correctly ignored")
-	currentTheme = theme.CurrentTheme()
-	fmt.Printf("    Still on: %s\n", currentTheme.Name())
-	fmt.Println()
-
-	// Test 7: Check that theme persists across calls
-	fmt.Println("[Test 7] Verify theme persistence:")
-	theme.SwitchToProvider("gemini")
-	theme1 := theme.CurrentTheme()
-	theme2 := theme.CurrentTheme()
-	if theme1.Name() != theme2.Name() {
-		fmt.Println("  ✗ ERROR: Theme not consistent across calls")
-		os.Exit(1)
-	}
-	fmt.Printf("  ✓ Theme persists: %s\n", theme1.Name())
-	fmt.Println()
-
-	fmt.Println("✅ All tests passed! Theme switching works correctly.")
-	fmt.Println("\nNext steps:")
-	fmt.Println("  1. Launch RyCode TUI")
-	fmt.Println("  2. Press Tab to cycle through providers")
-	fmt.Println("  3. Watch borders, badges, and UI elements change color")
-	fmt.Println("  4. Verify Claude=copper, Gemini=blue/pink, Codex=teal, Qwen=orange")
-}
diff --git a/packages/tui/test_theme_visual_verification.go b/packages/tui/test_theme_visual_verification.go
deleted file mode 100644
index d9c56638..00000000
--- a/packages/tui/test_theme_visual_verification.go
+++ /dev/null
@@ -1,226 +0,0 @@
-package main
-
-import (
-	"fmt"
-	"os"
-	"strings"
-
-	"github.com/aaronmrosenthal/rycode/internal/theme"
-	"github.com/charmbracelet/lipgloss/v2/compat"
-)
-
-// ColorTest represents a single color verification test
-type ColorTest struct {
-	Provider string
-	Element  string
-	Expected string // Hex color like "#D4754C"
-}
-
-// All color tests across all providers
-var colorTests = []ColorTest{
-	// Claude Theme (from NewClaudeTheme)
-	{"claude", "Primary", "#D4754C"},
-	{"claude", "Text", "#E8D5C4"},
-	{"claude", "TextMuted", "#9C8373"},
-	{"claude", "Background", "#1A1816"},
-	{"claude", "BackgroundPanel", "#2C2622"},
-	{"claude", "Border", "#D4754C"},
-	{"claude", "Accent", "#F08C5C"},
-	{"claude", "Success", "#6FA86F"},
-	{"claude", "Error", "#D47C7C"},
-	{"claude", "Warning", "#E8A968"},
-	{"claude", "Info", "#D4754C"},
-	{"claude", "MarkdownHeading", "#F08C5C"},
-	{"claude", "MarkdownLink", "#D4754C"},
-	{"claude", "MarkdownCode", "#E8A968"},
-
-	// Gemini Theme (from NewGeminiTheme)
-	{"gemini", "Primary", "#4285F4"},
-	{"gemini", "Text", "#E8EAED"},
-	{"gemini", "TextMuted", "#9AA0A6"},
-	{"gemini", "Background", "#0D0D0D"},
-	{"gemini", "BackgroundPanel", "#1A1A1A"},
-	{"gemini", "Border", "#4285F4"},
-	{"gemini", "Accent", "#EA4335"},
-	{"gemini", "Success", "#34A853"},
-	{"gemini", "Error", "#EA4335"},
-	{"gemini", "Warning", "#FBBC04"},
-	{"gemini", "Info", "#4285F4"},
-	{"gemini", "MarkdownHeading", "#4285F4"},
-	{"gemini", "MarkdownLink", "#4285F4"},
-	{"gemini", "MarkdownCode", "#FBBC04"},
-
-	// Codex Theme (from NewCodexTheme)
-	{"codex", "Primary", "#10A37F"},
-	{"codex", "Text", "#ECECEC"},
-	{"codex", "TextMuted", "#8E8E8E"},
-	{"codex", "Background", "#0E0E0E"},
-	{"codex", "BackgroundPanel", "#1C1C1C"},
-	{"codex", "Border", "#10A37F"},
-	{"codex", "Accent", "#1FC2AA"},
-	{"codex", "Success", "#10A37F"},
-	{"codex", "Error", "#EF4444"},
-	{"codex", "Warning", "#F59E0B"},
-	{"codex", "Info", "#3B82F6"},
-	{"codex", "MarkdownHeading", "#1FC2AA"},
-	{"codex", "MarkdownLink", "#10A37F"},
-	{"codex", "MarkdownCode", "#F59E0B"},
-
-	// Qwen Theme (from NewQwenTheme)
-	{"qwen", "Primary", "#FF6A00"},
-	{"qwen", "Text", "#F0E8DC"},
-	{"qwen", "TextMuted", "#A0947C"},
-	{"qwen", "Background", "#161410"},
-	{"qwen", "BackgroundPanel", "#221E18"},
-	{"qwen", "Border", "#FF6A00"},
-	{"qwen", "Accent", "#FF8533"},
-	{"qwen", "Success", "#52C41A"},
-	{"qwen", "Error", "#FF4D4F"},
-	{"qwen", "Warning", "#FAAD14"},
-	{"qwen", "Info", "#1890FF"},
-	{"qwen", "MarkdownHeading", "#FF6A00"},
-	{"qwen", "MarkdownLink", "#1890FF"},
-	{"qwen", "MarkdownCode", "#FAAD14"},
-}
-
-func main() {
-	fmt.Println("=== Theme Visual Verification ===")
-	fmt.Println("Verifying all theme colors match specifications...")
-	fmt.Println()
-
-	allPassed := true
-	providerResults := make(map[string][]string)
-
-	for _, test := range colorTests {
-		// Switch to provider theme
-		theme.SwitchToProvider(test.Provider)
-		th := theme.CurrentTheme()
-
-		// Get the actual color from the theme
-		var actualColor compat.AdaptiveColor
-		switch test.Element {
-		case "Primary":
-			actualColor = th.Primary()
-		case "Text":
-			actualColor = th.Text()
-		case "TextMuted":
-			actualColor = th.TextMuted()
-		case "Background":
-			actualColor = th.Background()
-		case "BackgroundPanel":
-			actualColor = th.BackgroundPanel()
-		case "Border":
-			actualColor = th.Border()
-		case "Accent":
-			actualColor = th.Accent()
-		case "Success":
-			actualColor = th.Success()
-		case "Error":
-			actualColor = th.Error()
-		case "Warning":
-			actualColor = th.Warning()
-		case "Info":
-			actualColor = th.Info()
-		case "MarkdownHeading":
-			actualColor = th.MarkdownHeading()
-		case "MarkdownLink":
-			actualColor = th.MarkdownLink()
-		case "MarkdownCode":
-			actualColor = th.MarkdownCode()
-		default:
-			fmt.Printf("  ✗ Unknown element: %s\n", test.Element)
-			allPassed = false
-			continue
-		}
-
-		// Convert to hex string
-		actualHex := colorToHex(actualColor)
-
-		// Compare
-		passed := actualHex == test.Expected
-		status := "✓"
-		if !passed {
-			status = "✗"
-			allPassed = false
-		}
-
-		result := fmt.Sprintf("  %s %-20s expected %s, got %s", status, test.Element, test.Expected, actualHex)
-		providerResults[test.Provider] = append(providerResults[test.Provider], result)
-
-		if !passed {
-			fmt.Println(result)
-		}
-	}
-
-	// Print results grouped by provider
-	providers := []string{"claude", "gemini", "codex", "qwen"}
-	for _, provider := range providers {
-		results := providerResults[provider]
-		passed := 0
-		failed := 0
-
-		for _, result := range results {
-			if strings.Contains(result, "✓") {
-				passed++
-			} else {
-				failed++
-			}
-		}
-
-		fmt.Printf("[%s Theme]\n", provider)
-		if failed > 0 {
-			// Print failed tests
-			for _, result := range results {
-				if strings.Contains(result, "✗") {
-					fmt.Println(result)
-				}
-			}
-		}
-		fmt.Printf("  Summary: %d passed, %d failed\n\n", passed, failed)
-	}
-
-	// Final summary
-	if allPassed {
-		totalTests := len(colorTests)
-		fmt.Println("=== Visual Verification Summary ===")
-		fmt.Println()
-		fmt.Printf("✅ All %d color tests passed!\n", totalTests)
-		fmt.Println()
-		fmt.Println("Theme Color Accuracy:")
-		fmt.Println("  • All primary colors match specifications")
-		fmt.Println("  • All text colors match specifications")
-		fmt.Println("  • All UI element colors match specifications")
-		fmt.Println("  • All markdown colors match specifications")
-		fmt.Println()
-		fmt.Println("Benefits:")
-		fmt.Println("  • Visual consistency guaranteed")
-		fmt.Println("  • Brand colors accurately replicated")
-		fmt.Println("  • No color drift over time")
-		fmt.Println("  • CI-ready for regression detection")
-		fmt.Println()
-		os.Exit(0)
-	} else {
-		fmt.Println("❌ Some color tests failed!")
-		fmt.Println()
-		fmt.Println("Action Required:")
-		fmt.Println("  • Review failed colors above")
-		fmt.Println("  • Update theme definitions in provider_themes.go")
-		fmt.Println("  • Re-run this test to verify fixes")
-		fmt.Println()
-		os.Exit(1)
-	}
-}
-
-// colorToHex converts an AdaptiveColor to a hex string
-func colorToHex(ac compat.AdaptiveColor) string {
-	// Use dark variant since RyCode is a dark TUI
-	c := ac.Dark
-	r, g, b, _ := c.RGBA()
-
-	// Convert from 16-bit (0-65535) to 8-bit (0-255)
-	r8 := uint8(r >> 8)
-	g8 := uint8(g >> 8)
-	b8 := uint8(b >> 8)
-
-	return fmt.Sprintf("#%02X%02X%02X", r8, g8, b8)
-}
diff --git a/packages/tui/tui_demo.tape b/packages/tui/tui_demo.tape
deleted file mode 100644
index 0d137468..00000000
--- a/packages/tui/tui_demo.tape
+++ /dev/null
@@ -1,45 +0,0 @@
-# VHS Tape for RyCode TUI Demo - Multi-Agent Interface
-# Shows the core feature: switching between AI agents
-# Run with: vhs tui_demo.tape
-
-Output tui_demo.gif
-Set Shell bash
-Set FontSize 14
-Set Width 1200
-Set Height 800
-Set Padding 20
-Set Theme "Dracula"
-
-# Build RyCode
-Type "go build -o rycode ./cmd/rycode"
-Enter
-Sleep 3s
-
-# Clear screen
-Type "clear"
-Enter
-Sleep 0.5s
-
-# Launch RyCode (without splash to show TUI immediately)
-Type "./rycode --no-splash"
-Enter
-
-# Show TUI with agent tabs for 10 seconds
-Sleep 10s
-
-# Simulate Tab key to switch agents
-Type@200ms "	"  # Tab key
-Sleep 2s
-
-Type@200ms "	"  # Tab again
-Sleep 2s
-
-Type@200ms "	"  # Tab again
-Sleep 2s
-
-# Show typing in prompt
-Type "help"
-Sleep 1s
-
-# Quit
-Type "q"