# Fox v1.1 Release Walkthrough

This release marks a major architectural shift from a monolithic script to a modular, stage-based pipeline, while simultaneously achieving full feature parity with the high-fidelity `test_shenron.py` radar testbench.

## 🚀 Key Achievements

### 1. Unified Radar Physics & Visualization
- **Single Source of Truth**: All radar plotting and post-processing logic is now centralized in `scripts/ISOLATE/sim_radar_utils/plots.py`.
- **FastHeatmapEngine**: Migrated the production pipeline to the stateful rendering engine, resulting in consistent dB scaling and improved performance.
- **Dual RA Stream**: Range-Azimuth (RA) visualization now produces both a **Static** (absolute magnitude) and **Dynamic** (peak-tracking) stream for Foxglove.
- **3D FOV Frustums**: Added hardware-accurate 3D frustum wireframes for all radar types (AWRL1432 and RadarBook).

### 2. Modular Stage-Based Pipeline
- **PipelineManager**: Orchestrates the execution of discrete stages: `Simulation` → `Shenron` → `MCAP` → `Video`.
- **Feature Parity**: Ported advanced telemetry flattening and metrology math from the testbench to the production exporter.
- **Selective Execution**: New CLI flags allow running only specific stages (e.g., `--only-mcap` to re-process existing data).

### 3. Robustness & Portability
- **Pathlib Integration**: Replaced brittle `os.path` joins with robust `Pathlib` logic in all pipeline stages and the orchestrator.
- **Stop Flag Detection**: Fixed a path bug in the stop flag detection to ensure graceful simulation shutdown works reliably across different working directories.
- **Hardware Persistence**: Added `radar_specs.json` generation to save hardware constants (carrier frequency, velocity limits) during synthesis for downstream visualization.

## 🛠️ Verification Results

| Component | Status | Verification Detail |
|---|---|---|
| **Dashboard** | ✅ | Version bumped to v1.1; scenario list and status polling verified. |
| **SimStage** | ✅ | Verified ego spawn, weather application, and `stop.flag` path resolution. |
| **ShenronStage** | ✅ | Verified `sys.path` injection and telemetry event emission. |
| **McapStage** | ✅ | Verified `FastHeatmapEngine` initialization and `ISOLATE` path handling. |
| **Telemetry** | ✅ | Verified flattened schema for Foxglove Plot panel compatibility. |

## 📦 File Audit Summary

- `src/main.py`: Refactored to thin CLI wrapper for `PipelineManager`.
- `src/pipeline/*`: New core architecture for stage management.
- `src/recorder.py`: Decoupled from physics logic; focused on raw capture.
- `src/processing/physics.py`: Reusable physics layer for radial velocity and ADAS metrics.
- `scripts/data_to_mcap.py`: Upgraded to v1.1 with testbench parity and 3D diagnostics.
- `dashboard/templates/index.html`: UI updated to reflect v1.1.

---
*Generated by Antigravity AI | Fox v1.1 "Ares" Release*