From 11d6583230cab96144330690450ee6ac02cedfd2 Mon Sep 17 00:00:00 2001
From: rakadu1 <rakadu1@bajajauto.co.in>
Date: Tue, 5 May 2026 17:05:33 +0530
Subject: [PATCH] Intel update

---
 README.md           | 2 +-
 gemini.md           | 8 ++++++++
 intel/CHRONICLES.md | 8 ++++++++
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8eb25fe..77c8feb 100644
--- a/README.md
+++ b/README.md
@@ -71,7 +71,7 @@ You can run scenarios directly via the `run.bat` wrapper:
 
 *   **`src/`**: Core logic including `PipelineManager`, `SensorManager`, and `Recorder`.
 *   **`scenarios/`**: Modular scenario implementations (e.g., `braking.py`, `cutin.py`).
-*   **`scripts/`**: Data conversion tools (MCAP) and the **Shenron** radar synthesis engine.
+*   **`scripts/`**: Data conversion tools (MCAP) and the **Shenron** radar synthesis engine (orchestrated by `ShenronOrchestrator`).
 *   **`dashboard/`**: Flask-based web interface for the orchestrator.
 *   **`intel/`**: Deep-dive documentation, project history (CHRONICLES.md), and versioned changelogs.
 
diff --git a/gemini.md b/gemini.md
index 92aafb9..a27681a 100644
--- a/gemini.md
+++ b/gemini.md
@@ -30,6 +30,7 @@ This document is the consolidated source of truth for AI agents working on the F
 - `scripts/test_shenron.py`: Standalone diagnostic testbench for radar iteration.
 - `scripts/ISOLATE/`: High-fidelity radar simulation engine.
 - `scripts/ISOLATE/sim_radar_utils/`: Visualization and DSP utilities.
+- `scripts/ISOLATE/shenron_orchestrator.py`: **Unified Orchestration Engine** — Centralized processing loop for physics-based radar synthesis. Ensures parity between `generate_shenron.py` (Production) and `test_shenron.py` (Iterative Lab).
 - `scripts/ISOLATE/sim_radar_utils/plots.py`: **Single source of truth** for all radar heatmap rendering (`FastHeatmapEngine`, `postprocess_ra`, `scan_convert_ra`).
 - `scripts/ISOLATE/sim_radar_utils/config.yaml`: DSP processor and plot limit configuration.
 - `dashboard/`: Flask backend and static web assets for the GUI.
@@ -59,6 +60,13 @@ This document is the consolidated source of truth for AI agents working on the F
 - `McapStage` (`mcap_stage.py`): Performs Foxglove serialization via `data_to_mcap.py`.
 - `VideoStage` (`video_stage.py`): Stitches captured camera frames into `.mp4` preview videos (dash + third-person).
 
+### `scripts/ISOLATE/shenron_orchestrator.py` (The Unified Engine)
+- **Role**: Centralized orchestration for physics-based radar synthesis.
+- **Features**: 
+    - Ensures 100% parity between `generate_shenron.py` and `test_shenron.py`.
+    - Manages directory structures and multi-modal serialization (ADC, PCD, Metrology).
+    - Decouples core physics processing from UI-specific telemetry via a callback pattern.
+
 ### `src/processing/physics.py` (The Math Layer)
 - Centralized source of truth for:
     - **Radial Velocity Injection**: Projecting relative velocity onto LOS via `calculate_radial_velocity()`.
diff --git a/intel/CHRONICLES.md b/intel/CHRONICLES.md
index 01ef571..0c3055c 100644
--- a/intel/CHRONICLES.md
+++ b/intel/CHRONICLES.md
@@ -148,6 +148,14 @@ After 30 iterations of parameter tuning, we identified the fundamental reason fo
 
 ## 📜 6. Detailed Daily Chronology (Git Absolute)
 
+### **May 05**
+- **Task**: Unified Radar Processing Orchestration.
+- **Problem**: Identified divergence and confusion between the "Iterative Lab" (test_shenron) and "Production" (generate_shenron) pipelines. Changes made in research were not consistently propagated to the simulation engine.
+- **Action**: Developed the **ShenronOrchestrator** in `scripts/ISOLATE/shenron_orchestrator.py`.
+- **Decision**: Centralized the core processing loop, directory management, and data serialization (ADC, PCD, Metrology, Metrics) into a shared engine.
+- **UI Logic**: Implemented a callback-based telemetry pattern to keep production-specific Dashboard logic (`[SHENRON_STEP]`) isolated from the core physics loop.
+- **Parity**: Achieved 100% bit-identical logic between the research lab and the production simulation.
+
 ### **April 23 (Milestone: Fox v1.1 "Ares")**
 - **Task**: Stage-Based Pipeline & Radar Parity Sync.
 - **Architecture**: Completed the full refactor to a modular stage-based pipeline. Isolated `SimulationStage`, `ShenronStage`, and `McapStage`.