chore: update internal paths for documentation moved to annex/

2 months ago · 3a12ca6765
13 changed files with 20 additions and 530 deletions
--- a/steps/Final_Changelog.html
+++ b/steps/Final_Changelog.html
@ -1,183 +0,0 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>ARAS Evolution: V2 to V3 Comprehensive Changelog</title>
    <script src="https://cdn.tailwindcss.com"></script>
    <link href="https://fonts.googleapis.com/css2?family=Fira+Code:wght@400;500&family=Inter:wght@400;600;800&display=swap" rel="stylesheet">
    <style>
        body { font-family: 'Inter', sans-serif; background: #0f172a; color: #f1f5f9; }
        .commit-hash { font-family: 'Fira Code', monospace; color: #94a3b8; font-size: 0.8rem; }
        .version-tag { background: linear-gradient(135deg, #6366f1 0%, #a855f7 100%); }
        .card { background: #1e293b; border: 1px solid #334155; transition: transform 0.2s; height: 100%; }
        .card:hover { transform: translateY(-4px); border-color: #475569; }
        .highlight-green { color: #4ade80; }
        .highlight-blue { color: #60a5fa; }
        .highlight-purple { color: #c084fc; }
        .highlight-amber { color: #fbbf24; }
        .icon-box { background: rgba(255,255,255,0.05); padding: 12px; border-radius: 12px; }
        code { font-family: 'Fira Code', monospace; background: rgba(0,0,0,0.3); padding: 2px 4px; border-radius: 4px; font-size: 0.9em; }
    </style>
 </head>
 <body class="p-8 md:p-16">
    <header class="max-w-6xl mx-auto mb-16 border-b border-slate-700 pb-12">
        <div class="flex items-center gap-4 mb-4">
            <span class="version-tag text-white px-3 py-1 rounded-full text-sm font-bold tracking-widest uppercase">Major Release</span>
            <span class="text-slate-500 font-mono text-sm">Baseline: e1b8aac (V2) | Current: 16f7736 (V3)</span>
        </div>
        <h1 class="text-5xl font-extrabold mb-4 bg-clip-text text-transparent bg-gradient-to-r from-indigo-400 to-purple-400 italic">
            ARAS Visualizer: Version 3
        </h1>
        <p class="text-xl text-slate-400 max-w-4xl leading-relaxed">
            Version 3 represents a major architectural milestone. The application evolved from a functional visualization prototype into a robust, modular, performance-optimized, and architecturally documented professional tool.
        </p>
    </header>
    <div class="max-w-6xl mx-auto grid grid-cols-1 md:grid-cols-2 gap-8">
        <!-- 1. Sync Engine Rearchitecture -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-blue text-2xl">⚡</div>
                <h2 class="text-2xl font-bold">1. Sync Engine Rearchitecture</h2>
            </div>
            <p class="text-slate-400 mb-4 text-sm italic">Redesigned to eliminate drift, stutter, and race conditions.</p>
            <ul class="space-y-3 text-slate-300 text-sm">
                <li class="flex gap-2"><span>•</span> Migration to <code>videoFrameCallback</code> for deterministic sync.</li>
                <li class="flex gap-2"><span>•</span> Hybrid video-radar synchronization architecture.</li>
                <li class="flex gap-2"><span>•</span> Centralized offset handling logic and persistence.</li>
                <li class="flex gap-2"><span>•</span> <strong>Drift Cascade Lockdown:</strong> Prevents seek-loops on low-end hardware.</li>
            </ul>
        </div>
        <!-- 2. File Loading & Caching -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-green text-2xl">📂</div>
                <h2 class="text-2xl font-bold">2. File Loading & Caching</h2>
            </div>
            <p class="text-slate-400 mb-4 text-sm italic">Complete modularization of the file processing pipeline.</p>
            <ul class="space-y-3 text-slate-300 text-sm">
                <li class="flex gap-2"><span>•</span> Extraction of file handling into dedicated <code>fileLoader.js</code>.</li>
                <li class="flex gap-2"><span>•</span> Incremental JSON & video loading support.</li>
                <li class="flex gap-2"><span>•</span> Promise-based IndexedDB initialization (Race condition fixes).</li>
                <li class="flex gap-2"><span>•</span> Non-blocking "fire-and-forget" caching logic.</li>
            </ul>
        </div>
        <!-- 3. Performance Optimization -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-amber text-2xl">🚀</div>
                <h2 class="text-2xl font-bold">3. Performance Optimization</h2>
            </div>
            <p class="text-slate-400 mb-4 text-sm italic">Rendering refactored for memory stability and frame-rate consistency.</p>
            <ul class="space-y-3 text-slate-300 text-sm">
                <li class="flex gap-2"><span>•</span> Removed layout-thrashing <code>innerHTML</code> calls in draw loops.</li>
                <li class="flex gap-2"><span>•</span> Canvas optimization to avoid heap allocations and GC pressure.</li>
                <li class="flex gap-2"><span>•</span> 20% total performance gain via smart throttling and debouncing.</li>
                <li class="flex gap-2"><span>•</span> FPS counter stabilization with warmup and smoothing logic.</li>
            </ul>
        </div>
        <!-- 4. Advanced Visualization -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-purple text-2xl">🧠</div>
                <h2 class="text-2xl font-bold">4. Advanced Visualization</h2>
            </div>
            <p class="text-slate-400 mb-4 text-sm italic">Intelligent data interpretation and professional UI interactions.</p>
            <ul class="space-y-3 text-slate-300 text-sm">
                <li class="flex gap-2"><span>•</span> <strong>Smart Labeling:</strong> Greedy collision resolution for track markers.</li>
                <li class="flex gap-2"><span>•</span> <strong>Spectral Density:</strong> Speed graph coloring based on track count.</li>
                <li class="flex gap-2"><span>•</span> Interactive seeking and high-speed scrubbing in speed graph.</li>
                <li class="flex gap-2"><span>•</span> Dynamic range slider (20m–200m) with auto-scaling ROI.</li>
            </ul>
        </div>
        <!-- 5. Zoom & God Mode -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-blue text-2xl">🔭</div>
                <h2 class="text-2xl font-bold">5. Zoom & God Mode</h2>
            </div>
            <ul class="space-y-3 text-slate-300 text-sm mt-2">
                <li class="flex gap-2"><span>•</span> <strong>Inertial Tracking:</strong> Exponential mouse smoothing (60Hz/144Hz agnostic).</li>
                <li class="flex gap-2"><span>•</span> Inverse zoom logic and boundary-aware tooltip constraints.</li>
                <li class="flex gap-2"><span>•</span> <strong>Shift-Key seeking:</strong> Integrated timeline scrubbing within radar canvas.</li>
                <li class="flex gap-2"><span>•</span> Relative distance square optimization to eliminate hover jitter.</li>
            </ul>
        </div>
        <!-- 6. Architectural Mapping -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-green text-2xl">🗺️</div>
                <h2 class="text-2xl font-bold">6. Living Documentation</h2>
            </div>
            <ul class="space-y-3 text-slate-300 text-sm mt-2">
                <li class="flex gap-2"><span>•</span> <strong>Interactive Codebase Overview:</strong> Integrated 3D-styled navigation.</li>
                <li class="flex gap-2"><span>•</span> Color-coded architecture explorer (Core, Sync, UI, P5).</li>
                <li class="flex gap-2"><span>•</span> Local <strong>PrismJS</strong> integration for high-perf syntax highlighting.</li>
                <li class="flex gap-2"><span>•</span> Mini-map docking navigation system for architectural modules.</li>
            </ul>
        </div>
        <!-- 7. UX & Modal System -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-amber text-2xl">🛠️</div>
                <h2 class="text-2xl font-bold">7. UX & Modal System</h2>
            </div>
            <ul class="space-y-3 text-slate-300 text-sm mt-2">
                <li class="flex gap-2"><span>•</span> First-run detection with automated User Guide onboarding.</li>
                <li class="flex gap-2"><span>•</span> Standalone Keyboard Shortcut reference modal.</li>
                <li class="flex gap-2"><span>•</span> Refactored header navigation with theme-aware icons.</li>
                <li class="flex gap-2"><span>•</span> Internet-free operation (Removed Google Fonts dependency).</li>
            </ul>
        </div>
        <!-- 8. Data Explorer -->
        <div class="card p-8 rounded-2xl shadow-2xl">
            <div class="flex items-center gap-4 mb-6">
                <div class="icon-box highlight-purple text-2xl">📊</div>
                <h2 class="text-2xl font-bold">8. Data Explorer</h2>
            </div>
            <ul class="space-y-3 text-slate-300 text-sm mt-2">
                <li class="flex gap-2"><span>•</span> Draggable and resizable side-panel for granular inspection.</li>
                <li class="flex gap-2"><span>•</span> Bi-directional timeline synchronization.</li>
                <li class="flex gap-2"><span>•</span> Expanded metadata for tracked objects (Risk, State, Sign).</li>
                <li class="flex gap-2"><span>•</span> Throttled data updates to maintain rendering performance.</li>
            </ul>
        </div>
        <!-- 9 & 10. Stability & Infrastructure -->
        <div class="card md:col-span-2 p-8 rounded-2xl shadow-2xl border-l-4 border-indigo-500">
            <h2 class="text-2xl font-bold mb-6">9 & 10. Stability & Infrastructure</h2>
            <div class="grid md:grid-cols-2 gap-8">
                <ul class="space-y-2 text-slate-400 text-sm">
                    <li class="flex gap-2"><span>•</span> Guards against division-by-zero in SNR mapping.</li>
                    <li class="flex gap-2"><span>•</span> Fixed tooltip Y-jitter bug in <code>drawUtils.js</code>.</li>
                    <li class="flex gap-2"><span>•</span> Standardized <code>p.deltaTime</code> across all browser engines.</li>
                    <li class="flex gap-2"><span>•</span> Dark mode refinements for raw point visibility.</li>
                </ul>
                <ul class="space-y-2 text-slate-400 text-sm">
                    <li class="flex gap-2"><span>•</span> Decoupled UI logic from the <code>main.js</code> orchestrator.</li>
                    <li class="flex gap-2"><span>•</span> Isolated keyboard shortcuts for improved maintainability.</li>
                    <li class="flex gap-2"><span>•</span> Unit test suite expanded for <code>utils</code> and <code>parsers</code>.</li>
                    <li class="flex gap-2"><span>•</span> Comprehensive Context and README documentation updates.</li>
                </ul>
            </div>
        </div>
    </div>
    <footer class="max-w-6xl mx-auto mt-24 pt-12 border-t border-slate-700 text-slate-500 text-center">
        <p class="mb-2"><strong>Classification:</strong> Major Release – Architectural & Performance Upgrade</p>
        <p class="text-sm italic">Generated via Gemini CLI | Analysis of 80+ Commits | ARAS Refactor Documentation Project &copy; 2026</p>
    </footer>
 </body>
 </html>
--- a/steps/GEM_Changes.html
+++ b/steps/GEM_Changes.html
@ -1,134 +0,0 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Version 3.0 Changelog</title>
    <script src="https://cdn.tailwindcss.com"></script>
    <style>
        body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; }
    </style>
 </head>
 <body class="bg-gray-50 text-gray-800 antialiased p-6 md:p-12">
    <div class="max-w-5xl mx-auto">
        <header class="mb-12 border-b border-gray-200 pb-6">
            <h1 class="text-4xl font-extrabold text-gray-900 tracking-tight">Changelog <span class="text-blue-600">v3.0</span></h1>
            <p class="text-lg text-gray-600 mt-2">A comprehensive overview of architectural overhauls, performance optimizations, and new features introduced in the latest release.</p>
        </header>
        <main class="space-y-12">
            <section>
                <h2 class="text-2xl font-bold text-gray-900 mb-6 flex items-center">
                    <svg class="w-6 h-6 mr-2 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 3v4M3 5h4M6 17v4m-2-2h4m5-16l2.286 6.857L21 12l-5.714 2.143L13 21l-2.286-6.857L5 12l5.714-2.143L13 3z"></path></svg>
                    Major Changes
                </h2>
                <div class="grid grid-cols-1 md:grid-cols-2 gap-6">
                    <div class="bg-white p-6 rounded-xl shadow-sm border border-gray-100">
                        <h3 class="text-xl font-bold text-gray-800 mb-3">Hybrid Sync & Playback Engine</h3>
                        <p class="text-gray-600 mb-4 text-sm">The synchronization architecture between video and radar data was completely rewritten to eliminate stutter and ensure 100% solid logic.</p>
                        <ul class="list-disc list-inside text-sm text-gray-700 space-y-2">
                            <li>Moved <code>updateFrame</code> directly into the <code>videoframecallback</code> for display refresh rate synchronization.</li>
                            <li>Implemented a "Resync Drift Cascade Lockdown" (circuit breaker) to prevent infinite loop freezes on low-end hardware or when multiple tabs are open.</li>
                            <li>Added frame-rate independent smoothing for UI and sketches.</li>
                            <li>Centralized timeline slider, manual offset, and play/stop/pause logic into a dedicated <code>sync.js</code> module.</li>
                        </ul>
                    </div>
                    <div class="bg-white p-6 rounded-xl shadow-sm border border-gray-100">
                        <h3 class="text-xl font-bold text-gray-800 mb-3">Modular File Loading & Offline Support</h3>
                        <p class="text-gray-600 mb-4 text-sm">Monolithic application files were broken down, and the software was adapted to work entirely offline.</p>
                        <ul class="list-disc list-inside text-sm text-gray-700 space-y-2">
                            <li>Extracted file handling into <code>src/fileLoader.js</code>, supporting incremental loading (replacing individual files without breaking app state).</li>
                            <li>Resolved IndexedDB race conditions and startup crashes by ensuring metadata is extracted before parsing visualization data.</li>
                            <li>Removed Google Fonts dependency and implemented robust fallback logic for local JS libraries, enabling full offline capability.</li>
                            <li>Corrected caching key usage to ensure auto-reloading from IndexedDB works seamlessly.</li>
                        </ul>
                    </div>
                    <div class="bg-white p-6 rounded-xl shadow-sm border border-gray-100">
                        <h3 class="text-xl font-bold text-gray-800 mb-3">Performance & Memory Optimizations</h3>
                        <p class="text-gray-600 mb-4 text-sm">Significant improvements to the rendering pipeline to reduce memory allocation and boost framerates.</p>
                        <ul class="list-disc list-inside text-sm text-gray-700 space-y-2">
                            <li>Resolved major heap memory issues by iterating through data and drawing rectangles directly to the canvas, changing <code>ctx.fillStyle</code> only once per column.</li>
                            <li>Improved FPS counter stability with a warmup period to prevent erroneous spikes during new file loads.</li>
                            <li>Removed unnecessary animation loop calls (e.g., drawing axes every frame) and reduced text content updates for a 20%+ performance boost.</li>
                            <li>Throttled the MATLAB-style Data Explorer updates to prevent unnecessary function calls when closed.</li>
                        </ul>
                    </div>
                    <div class="bg-white p-6 rounded-xl shadow-sm border border-gray-100">
                        <h3 class="text-xl font-bold text-gray-800 mb-3">Living Documentation & Analytical Tools</h3>
                        <p class="text-gray-600 mb-4 text-sm">Introduced powerful new ways to explore both the application data and the codebase itself.</p>
                        <ul class="list-disc list-inside text-sm text-gray-700 space-y-2">
                            <li><strong>Living Documentation:</strong> Added an interactive codebase overview with a visual 3D-styled navigation map and PrismJS syntax highlighting.</li>
                            <li><strong>Data Explorer:</strong> Added a draggable, resizable MATLAB-style data explorer with timeline sync and track information (launched via 'i' key).</li>
                            <li><strong>Speed Graph:</strong> Implemented drag-to-seek, click-to-seek, and hover tooltips for CAN/Ego speeds.</li>
                            <li>Added an Inter-Frame Timing (IFT) graph with dynamic scaling animations.</li>
                        </ul>
                    </div>
                </div>
            </section>
            <section>
                <h2 class="text-2xl font-bold text-gray-900 mb-6 flex items-center mt-12">
                    <svg class="w-6 h-6 mr-2 text-gray-600" fill="none" stroke="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 6V4m0 2a2 2 0 100 4m0-4a2 2 0 110 4m-6 8a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4m6 6v10m6-2a2 2 0 100-4m0 4a2 2 0 110-4m0 4v2m0-6V4"></path></svg>
                    Minor Changes & UX Polish
                </h2>
                <div class="bg-white p-6 rounded-xl shadow-sm border border-gray-100">
                    <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
                        <div>
                            <h4 class="font-bold text-gray-800 mb-2 border-b pb-1">User Interface</h4>
                            <ul class="list-disc list-inside text-sm text-gray-600 space-y-1.5">
                                <li>Added vertical range slider (20m-200m) to adjust <code>RADAR_Y_MAX</code> dynamically.</li>
                                <li>Double-click reset functionality added to range sliders.</li>
                                <li>Implemented an auto-loading Quick Start Guide modal on the first session launch.</li>
                                <li>Refined radar-info-overlay to match plot width and center text.</li>
                                <li>Added theme-aware color logic for raw point clouds in dark mode.</li>
                                <li>Removed redundant 'scale' and 'absolute time' metrics from persistent overlays.</li>
                            </ul>
                        </div>
                        <div>
                            <h4 class="font-bold text-gray-800 mb-2 border-b pb-1">Zoom & God Mode</h4>
                            <ul class="list-disc list-inside text-sm text-gray-600 space-y-1.5">
                                <li>Implemented smooth mouse tracking for the zoom tooltip.</li>
                                <li>Added Inverse Zoom Logic.</li>
                                <li>Constrained God Mode tooltips to remain inside the bounding sketch box.</li>
                                <li>Fixed hover detection bugs during scroll-zoom interactions.</li>
                                <li>Switched to relative distance squares to reduce computational overhead and initial hover jitter.</li>
                            </ul>
                        </div>
                        <div>
                            <h4 class="font-bold text-gray-800 mb-2 border-b pb-1">Visuals & Inputs</h4>
                            <ul class="list-disc list-inside text-sm text-gray-600 space-y-1.5">
                                <li>Added vehicle dimensions visualization and enhanced track risk coloring.</li>
                                <li>Added state identifiers directly beside TTC markers.</li>
                                <li>Fixed visibility toggle for "Confirmed ONLY" tracks.</li>
                                <li>New keyboard shortcuts: Arrow keys (navigation), Shift key (God Mode activation).</li>
                                <li>Isolated keyboard shortcut logic to prevent input conflicts.</li>
                                <li>Video player mute defaults removed; standard controls option added.</li>
                            </ul>
                        </div>
                    </div>
                </div>
            </section>
        </main>
        <footer class="mt-16 text-center text-sm text-gray-500 border-t border-gray-200 pt-6">
            Generated from git commit history.
        </footer>
    </div>
 </body>
 </html>
--- a/steps/GPT_changes.html
+++ b/steps/GPT_changes.html
@ -1,194 +0,0 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <title>Changelog – Version 2 to Version 3</title>
 <style>
 body { font-family: Arial, sans-serif; line-height: 1.6; margin: 40px; color: #222; }
 h1 { border-bottom: 2px solid #333; padding-bottom: 10px; }
 h2 { margin-top: 40px; color: #0b5394; }
 h3 { margin-top: 20px; color: #3d85c6; }
 ul { margin-top: 5px; }
 .section { margin-bottom: 30px; }
 .major { background: #f4f8fb; padding: 15px; border-left: 5px solid #0b5394; }
 .minor { background: #fafafa; padding: 10px; border-left: 4px solid #999; }
 code { background: #eee; padding: 2px 5px; border-radius: 4px; }
 </style>
 </head>
 <body>
 <h1>Version 3 – Comprehensive Changelog</h1>
 <p><strong>Release Scope:</strong> Major architectural overhaul, performance optimization, synchronization stability, enhanced visualization intelligence, and UX refinement.</p>
 <!-- ========================= -->
 <h2>1. Sync Engine Rearchitecture (Major)</h2>
 <div class="major">
 <p>The playback and synchronization system was completely redesigned to eliminate drift, stutter, and race conditions.</p>
 <h3>Key Enhancements:</h3>
 <ul>
 <li>Migration of update logic to <code>videoFrameCallback</code> for deterministic frame synchronization.</li>
 <li>Hybrid video-radar synchronization architecture.</li>
 <li>Centralized offset handling logic.</li>
 <li>Drift cascade lockdown mechanism.</li>
 <li>Manual offset persistence and improved workflow.</li>
 </ul>
 <p><strong>Impact:</strong> Playback engine is now deterministic, stable under low-end hardware, and resilient against multi-tab load conditions.</p>
 </div>
 <!-- ========================= -->
 <h2>2. File Loading & Caching Overhaul (Major)</h2>
 <div class="major">
 <p>Complete modularization of file loading pipeline.</p>
 <h3>Improvements:</h3>
 <ul>
 <li>Extraction of file handling into <code>fileLoader.js</code>.</li>
 <li>Incremental JSON & video loading.</li>
 <li>Race condition fixes using Promise-based DB initialization.</li>
 <li>Non-blocking IndexedDB caching (fire-and-forget).</li>
 <li><code>fromCache</code> optimization flag.</li>
 <li>Unit tests added for loading pipeline.</li>
 </ul>
 <p><strong>Impact:</strong> Eliminated startup crashes, resolved NaN timestamp errors, improved reload time, and increased system robustness.</p>
 </div>
 <!-- ========================= -->
 <h2>3. Performance Optimization Initiative (Major)</h2>
 <div class="major">
 <p>Large-scale performance refactoring across rendering and DOM layers.</p>
 <h3>Optimizations:</h3>
 <ul>
 <li>Removed unnecessary DOM updates and innerHTML usage.</li>
 <li>Canvas rendering optimized to avoid heap allocations.</li>
 <li>Reduced redundant draw calls (axes, explorer updates).</li>
 <li>20% performance gain via throttling.</li>
 <li>FPS counter stabilization with warmup logic.</li>
 </ul>
 <p><strong>Impact:</strong> Significant memory stability improvement and smoother animation loops.</p>
 </div>
 <!-- ========================= -->
 <h2>4. Advanced Visualization & UX Enhancements (Major)</h2>
 <div class="major">
 <p>Visualization layer significantly upgraded.</p>
 <h3>Enhancements:</h3>
 <ul>
 <li>Interactive seeking & scrubbing in speed graph.</li>
 <li>Smart labeling with density-based speed coloring.</li>
 <li>Vehicle dimension visualization.</li>
 <li>Risk & state indicators integrated into track markers.</li>
 <li>Dynamic vertical range slider (20m–200m).</li>
 <li>ROI auto-scaling with dynamic plot boundaries.</li>
 <li>Frame-rate independent smoothing for UI interactions.</li>
 </ul>
 <p><strong>Impact:</strong> Visualization now supports intelligent data interpretation and professional-grade interaction behavior.</p>
 </div>
 <!-- ========================= -->
 <h2>5. Zoom & God Mode Enhancements (Major)</h2>
 <div class="major">
 <ul>
 <li>Advanced zoom control architecture.</li>
 <li>Inverse zoom logic implementation.</li>
 <li>Smooth mouse tracking for tooltip precision.</li>
 <li>Tooltip bounding constraints.</li>
 <li>Shift-key God Mode activation.</li>
 <li>Hover jitter reduction via relative distance square optimization.</li>
 </ul>
 <p><strong>Impact:</strong> Enhanced inspection capability for dense radar scenes with stable UX behavior.</p>
 </div>
 <!-- ========================= -->
 <h2>6. In-App Documentation & Architectural Map (Major)</h2>
 <div class="major">
 <ul>
 <li>Interactive codebase overview with 3D-styled navigation.</li>
 <li>Living documentation integration.</li>
 <li>Color-coded architecture explorer (Core, Sync, UI).</li>
 <li>PrismJS integration for syntax highlighting.</li>
 <li>Mini-map docking navigation system.</li>
 </ul>
 <p><strong>Impact:</strong> Application now self-documents architecture, accelerating onboarding and internal knowledge transfer.</p>
 </div>
 <!-- ========================= -->
 <h2>7. User Guide & Modal System (Major)</h2>
 <div class="major">
 <ul>
 <li>First-run detection with sessionStorage.</li>
 <li>Auto-launch user guide modal.</li>
 <li>Shortcut reference modal.</li>
 <li>Standalone shortcuts.html reference page.</li>
 <li>Header navigation refactor.</li>
 </ul>
 </div>
 <!-- ========================= -->
 <h2>8. Data Explorer Enhancements (Major)</h2>
 <div class="major">
 <ul>
 <li>Draggable and resizable explorer.</li>
 <li>Timeline synchronization.</li>
 <li>Additional track metadata display.</li>
 <li>Performance throttling.</li>
 </ul>
 </div>
 <!-- ========================= -->
 <h2>9. Stability & Bug Fixes (Minor)</h2>
 <div class="minor">
 <ul>
 <li>Fixed smoothing and mapping edge cases.</li>
 <li>Corrected hover detection bug during scroll-zoom.</li>
 <li>Division-by-zero prevention safeguards.</li>
 <li>Fixed handleCloseUpDisplay mouseY bug.</li>
 <li>Debug overlay corrections.</li>
 <li>Speed graph fixes.</li>
 <li>Minor UI fixes and dark mode refinements.</li>
 <li>Removed Google Fonts dependency for offline support.</li>
 <li>Theme-aware coloring improvements.</li>
 <li>Various HTML & margin refinements.</li>
 </ul>
 </div>
 <!-- ========================= -->
 <h2>10. Infrastructure & Refactoring (Minor)</h2>
 <div class="minor">
 <ul>
 <li>Keyboard shortcut isolation.</li>
 <li>UI/session logic separation from main.js.</li>
 <li>Deletion of obsolete files.</li>
 <li>Context & README updates.</li>
 <li>Code cleanup and dead code removal.</li>
 </ul>
 </div>
 <!-- ========================= -->
 <h2>Summary of Version 3</h2>
 <p>
 Version 3 represents a major architectural milestone. The application evolved from a functional visualization prototype into a robust, modular, performance-optimized, and architecturally documented professional tool.
 </p>
 <ul>
 <li>Deterministic Sync Engine</li>
 <li>Modular File Loading Architecture</li>
 <li>High-Performance Rendering Pipeline</li>
 <li>Advanced Data Visualization Intelligence</li>
 <li>Integrated Living Documentation</li>
 <li>Professional UX & Stability Hardening</li>
 </ul>
 <p><strong>Overall Classification:</strong> Major Release – Architectural & Performance Upgrade</p>
 </body>
 </html>
--- a/steps/annex/Changelog.html
+++ b/steps/annex/Changelog.html
--- a/steps/annex/GIT_Changes.txt
+++ b/steps/annex/GIT_Changes.txt
--- a/steps/annex/Improvements.txt
+++ b/steps/annex/Improvements.txt
--- a/steps/annex/User_Manual.html
+++ b/steps/annex/User_Manual.html
--- a/steps/annex/code-base-overview.html
+++ b/steps/annex/code-base-overview.html
@ -8,7 +8,7 @@
    <script src="https://cdn.tailwindcss.com"></script>
    <!-- Prism.js for Syntax Highlighting (Local Okaidia Theme) -->
    <link href="vendor/prism.css" rel="stylesheet" />
    <link href="../vendor/prism.css" rel="stylesheet" />
    <link rel="preconnect" href="https://fonts.googleapis.com">
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@ -1297,7 +1297,7 @@
    </div>
    <!-- Prism JS Scripts -->
    <script src="vendor/prism.js"></script>
    <script src="../vendor/prism.js"></script>
    <script>
        const modal = document.getElementById('code-modal');
@ -1317,7 +1317,8 @@
            else if (filePath.endsWith('.css')) lang = 'css';
            try {
                const response = await fetch(filePath);
                // Since this file is in 'annex/', we need to go up one level to find the 'src/' files
                const response = await fetch('../' + filePath);
                if (!response.ok) throw new Error(`HTTP error! status: ${response.status}`);
                const text = await response.text();
--- a/steps/annex/shortcuts.html
+++ b/steps/annex/shortcuts.html
--- a/steps/index.html
+++ b/steps/index.html
@ -626,14 +626,14 @@
      </div>
      <!-- Iframe Content -->
      <iframe id="user-manual-iframe" src="User_Manual.html" class="flex-grow w-full border-0 rounded-b-2xl" style="min-height: 400px;"></iframe>
    </div>
  </div>
      <iframe id="user-manual-iframe" src="annex/User_Manual.html" class="flex-grow w-full border-0 rounded-b-2xl" style="min-height: 400px;"></iframe>
      </div>
      </div>
      <!-- CODEBASE OVERVIEW MODAL -->
      <div id="codebase-modal" class="fixed inset-0 z-50 flex items-center justify-center hidden bg-black bg-opacity-80 backdrop-blur-sm p-4">
      <div class="bg-white dark:bg-gray-900 rounded-2xl shadow-2xl w-full h-full mx-8 my-4 relative flex flex-col">
  <!-- CODEBASE OVERVIEW MODAL -->
  <div id="codebase-modal" class="fixed inset-0 z-50 flex items-center justify-center hidden bg-black bg-opacity-80 backdrop-blur-sm p-4">
    <div class="bg-white dark:bg-gray-900 rounded-2xl shadow-2xl w-full h-full mx-8 my-4 relative flex flex-col">
      <!-- Header -->
      <div class="flex items-center justify-between px-6 py-1 border-b border-gray-200 dark:border-gray-700 sticky top-0 bg-white dark:bg-gray-900 z-10 rounded-t-2xl">
        <div class="flex items-center gap-3">
@ -647,10 +647,9 @@
      </div>
      <!-- Iframe Content -->
      <iframe id="codebase-iframe" src="code-base-overview.html" class="flex-grow w-full border-0 rounded-b-2xl" style="min-height: 400px;"></iframe>
    </div>
  </div>
      <iframe id="codebase-iframe" src="annex/code-base-overview.html" class="flex-grow w-full border-0 rounded-b-2xl" style="min-height: 400px;"></iframe>
      </div>
      </div>
  <div id="modal-container" class="fixed inset-0 z-50 flex items-center justify-center hidden">
    <div id="modal-overlay" class="absolute inset-0 bg-black bg-opacity-50"></div>
    <div id="modal-content"
--- a/steps/intel/GEMINI.md
+++ b/steps/intel/GEMINI.md
--- a/steps/intel/context.md
+++ b/steps/intel/context.md
--- a/steps/intel/readme.md
+++ b/steps/intel/readme.md
@ -182,11 +182,12 @@ Project Structure
 ├── index.html                       # Main HTML shell
 ├── README.md                        # This documentation
 ├── User_Manual.html                 # Content for the Quick Start Guide (loaded via iframe)
 ├── code-base-overview.html          # Technical overview of the codebase (infographic style)
 ├── shortcuts.html                   # Reference for keyboard shortcuts (legacy/static)
 ├── Visualization_Start.bat          # Script to start the local server
 ├── python_check.bat                 # Script to check Python installation
 ├── annex/                       # Supplementary documentation and reference files
 │   ├── User_Manual.html         # Content for the Quick Start Guide (loaded via iframe)
 │   ├── code-base-overview.html  # Technical overview of the codebase (infographic style)
 │   └── shortcuts.html           # Reference for keyboard shortcuts (legacy/static)
 ├── Visualization_Start.bat      # Script to start the local server
 ├── python_check.bat             # Script to check Python installation
 ├── favicon.png                      # Browser tab icon
 ├── context.md                       # Detailed technical overview for AI assistance
 ├── Improvements.txt                 # Log of planned and completed improvements