feat: Implement Telemetry Pipeline

- Frontend: Installed shadcn/ui and connected WebSocket dashboard
- Backend: Implemented rclnodejs gateway for /odom and /battery
- Simulation: Added mock_robot.py for data generation
- Scripts: Added dev-all.sh for parallel execution

.agent/decisions/001-aliases-vs-scripts.md

@@ -0,0 +1,29 @@
+# How to Think: Architectural Decisions - Aliases vs. Explicit Commands
+
+## The Decision: Alias vs. Workflow
+
+**Verdict**: We do **NOT** rely on local shell aliases for core project tasks.
+**Reasoning**:
+
+1.  **Portability**: If I create an alias `run-all` in your `.bashrc`, it works today. If you switch machines or a new developer joins, the command vanishes. The project breaks.
+2.  **Transparency**: Hidden logic is dangerous. A command like `npm run build` is explicit and documented in `package.json`. An alias is a black box.
+3.  **CI/CD**: Your build server (GitHub Actions/GitLab CI) does not have your personal alias file. It needs standard commands.
+
+## The Professional Alternative: Project Scripts
+
+Instead of personal aliases, we use **Standardized Entry Points**.
+
+| Task             | Personal Alias (Bad) | Standard Script (Professional)                 |
+| :--------------- | :------------------- | :--------------------------------------------- |
+| Build Everything | `b`                  | `npm run build:all` (in root `package.json`)   |
+| Start Dev        | `dev`                | `npm run dev` (uses Turbo/Concurrently)        |
+| Launch ROS       | `ros`                | `ros2 launch ...` (Shell script in `scripts/`) |
+
+## Exception: Personal Convenience
+
+You (the user) are free to alias `g` to `git` or `k` to `kubectl` in your own shell profile. But **Antigravity (The Agent)** will always use the full, explicit command to ensure reproducibility and clarity in logs.
+
+## Implemented Strategy
+
+1.  **Root `package.json`**: We will create a root `package.json` to act as the "Master Control" for the monorepo.
+2.  **Helper Scripts**: Complex logic (like "start 5 terminals") goes into `./scripts/dev.sh`, which is checked into Git.

.agent/decisions/002-ros-python-env.md

@@ -0,0 +1,36 @@
+# Architectural Decision: Python Environments in ROS 2
+
+## The Conflict
+
+You asked: _"Don't we need venv in robotics?"_
+The short answer: **Usually, No.** (But with a catch).
+
+## The Technical Reason (`rclpy`)
+
+1.  **Binary Bindings**: ROS 2 core libraries (like `rclpy`, `std_msgs`) are **C++ binaries** wrapped in Python. They are installed via `apt` into `/opt/ros/humble/lib/python3.10/site-packages`.
+2.  **The Venv Trap**: A standard Python `venv` is designed to be **isolated**. It explicitly _hides_ the system packages.
+    - Result: If you activate a venv and run a ROS node, it crashes with `ModuleNotFoundError: No module named 'rclpy'`.
+3.  **The Workaround**: You _can_ create a venv with `--system-site-packages`, but this defeats the purpose of isolation (you inherit all the system junk anyway).
+
+## The Decision
+
+We apply a **Split Strategy**:
+
+| Layer                                    | Environment        | Strategy                                                                                                                                                                                            |
+| :--------------------------------------- | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **ML Service** (`apps/ml-service`)       | **Strict `.venv`** | It's a standard Python web app. It needs precise versions of `torch`, `fastapi`, etc. It communicates with ROS via network/bridge, so it doesn't strictly need `rclpy` (unless it's a direct node). |
+| **ROS 2 Workspace** (`robotics/ros2_ws`) | **System Python**  | We rely on `rosdep` and the OS package manager (`apt`). We do **NOT** use a venv here. **Docker** provides the isolation layer for this part of the stack.                                          |
+
+## Why this is "Professional"
+
+In production, your robot runs a **Docker Container**.
+
+- Inside that container, there is only **one** python environment (the system one).
+- Therefore, developing against the System Python in WSL mirrors the production Docker environment more closely than a synthetic venv.
+
+## Exception
+
+If you need a specific Python library (e.g., `requests`) for a ROS node:
+
+1.  Check if there is a ROS package for it: `sudo apt install python3-requests`.
+2.  If not, use `pip install --user` (be careful) or add it to `package.xml` and let `rosdep` handle it.

.agent/decisions/003-vertical-slicing.md

@@ -0,0 +1,69 @@
+# Architectural Decision: Vertical Feature Slicing
+
+## The Problem
+
+Monoliths (or even Monorepos) often suffer from "Horizontal Layering".
+
+- **Horizontal**: "I will write all the database schemas. Then all the API routes. Then all the frontend components."
+- **Result**: You have 3 broken layers for weeks. Nothing works until the very end.
+
+## The Solution: Vertical Features
+
+We build **End-to-End Features** one at a time. A feature is a vertical slice through the entire stack.
+
+### 1. The Structure of a Vertical Slice
+
+A single folder in your brain (not necessarily on disk, though we can group by domain) contains:
+
+- **Database Schema** (Postgres Migration)
+- **Backend Service** (API Route + Controller)
+- **Shared Type** (DTO)
+- **Frontend Component** (UI Widget)
+- **ROS Message** (Topic Definition)
+
+### 2. Feature-First Directory Structure (Future State)
+
+Instead of:
+
+```
+/controllers
+  /auth_controller.ts
+  /robot_controller.ts
+/models
+  /user.ts
+  /robot.ts
+```
+
+We move towards **Domain Modules** (in Backend):
+
+```
+/modules
+  /auth
+    /auth.controller.ts
+    /auth.service.ts
+    /auth.schema.ts
+  /robot-fleet
+    /fleet.controller.ts
+    /fleet.service.ts
+```
+
+### 3. The Coupling Rule
+
+- **Loose Coupling Between Verticals**: The "Auth" module should not know about "Robot Path Planning". They talk via **Pub/Sub (Events)** or **Public Service Interface**.
+- **Tight Coupling Within Verticals**: The "Robot Map" UI component requires the "Robot Map" API endpoint. They change together. This is good.
+
+## Execution Strategy: "The Tracer Bullet"
+
+For every new feature (e.g., "Add Lidar Visualization"):
+
+1.  **Define the Interface** (`packages/shared-types`): `LidarScan { ranges: number[] }`
+2.  **Implement ROS Node**: Publish `sensor_msgs/LaserScan`.
+3.  **Implement Backend Bridge**: Subscribe to ROS, forward to Websocket.
+4.  **Implement Frontend**: Render points on HTML Canvas.
+5.  **Verify**: Does it light up? Yes. **Done.**
+
+## Mental Check
+
+- **Can I delete this feature?** If I delete the "Mapping" folder, does the "Login" screen break?
+  - **No**: Good. Decoupled.
+  - **Yes**: Bad. Tight coupling.

.agent/decisions/004-ui-library.md

@@ -0,0 +1,39 @@
+# Architectural Decision: UI Component Library (shadcn/ui)
+
+## The Problem
+
+Manually styling every button, card, and input (even with Tailwind) is slow and leads to inconsistency.
+We need a **Production-Grade Design System** that:
+
+1.  Is **Accessible** (screen readers, keyboard nav).
+2.  Is **Customizable** (we own the code, not an npm package).
+3.  Looks **Enterprise/Professional** out of the box.
+
+## The Solution: shadcn/ui
+
+We will use **shadcn/ui** (built on Radix Primitives + Tailwind).
+
+### Why shadcn/ui?
+
+- **Not a Library**: It is a collection of reusable components that you copy/paste (via CLI) into your project.
+- **Enterprise Standard**: Used by Vercel, OpenAI, and major startups.
+- **Headless**: Powered by Radix UI, ensuring WAI-ARIA compliance for complex widgets (Dialogs, Dropdowns, Tabs).
+
+## Implementation Strategy
+
+1.  **Initialize**: `npx shadcn-ui@latest init` (in `apps/frontend`).
+2.  **Theme**: Configure to match our `globals.css` (Slate/Blue).
+3.  **Components to Install**:
+    - `Button`
+    - `Card` (for Dashboard widgets)
+    - `Badge` (for Status indicators)
+    - `Table` (for Fleet lists)
+    - `Sheet` (for Mobile Sidebar)
+
+## Alternatives Rejected
+
+- **Material UI (MUI)**: Too heavy, runtime CSS-in-JS performance cost.
+- **Ant Design**: Difficult to customize, huge bundle size.
+- **Chakra UI**: Runtime style props add overhead.
+
+**Verdict**: `shadcn/ui` + Tailwind is the modern gold standard for high-performance React apps.

.agent/how-to-think.md

@@ -0,0 +1,61 @@
+# AI Agent Mental Models: The INTJ Robotics Architect
+
+## 1. Think in Isolation (Dependency Hygiene)
+
+- **Node.js**: Use `bun`. It's faster.
+- **Python**: NEVER install global packages.
+  - **Bad**: `pip install pandas` (Pollutes system/WSL).
+  - **Good**: `uv venv` -> `source .venv/bin/activate` -> `uv pip install pandas`.
+- **ROS 2**: Use `rosdep` to manage system keys, but keep python logic in nodes isolated where possible.
+
+## 2. Think in Control Loops (The 100Hz Rule)
+
+Every decision regarding the robot's logical core must respect the control loop.
+
+- **Input**: Sensor Data (Lidar, Odom, Cameras).
+- **Process**: State Estimation -> Path Planning -> Control.
+- **Output**: Actuator Commands (Velocity, Torque).
+- **Constraint**: This loop runs at **100Hz (10ms)**. Any logic added here must be **O(1)** or extremely optimized. NO blocking HTTP calls. NO heavy serialization.
+
+## 3. Think in State Synchronization (The Twin Problem)
+
+The "Robot" and the "Dashboard" are two different timelines.
+
+- **Robot Time**: Continuous, real-time, authoritative.
+- **Dashboard Time**: Discrete, delayed, observational.
+- **Rule**: The Dashboard calculates **nothing**. It only **rendering** the state it receives.
+- **Conflict**: If the Dashboard says "Go to X" and the Robot says "I am at Y", the Robot wins. The Dashboard is merely a remote controller, not the brain.
+
+## 4. Think in Hybrid Environments (WSL 2 vs Windows)
+
+You are a bridge between two worlds.
+
+- **Hardware Layer**: Windows (GPU drivers, USB devices).
+- **Software Layer**: Linux/WSL (Kernel, ROS Network).
+- **The Gap**: Networking (Firewalls, localhost binding) and Filesystem (CRLF, Slow Mounts).
+- **Mental Check**: "Will this command run in PowerShell? No? adaptability -> WSL."
+
+## 5. Think in Types as Contracts
+
+- **Loose Typing** = **Physical Damage**.
+- If the frontend sends a string "fast" instead of a float `1.5`, the robot might interpret `0.0` or crash.
+- **Constraint**: Shared Types (`packages/shared-types`) are not just for convenience; they are safety interlocks. Protocol Buffers or Pydantic/Zod schemas are mandatory at the edges.
+
+## 6. Think in Failure Modes (Defensive Architecture)
+
+- **Network Loss**: What happens if WiFi drops? Robot enters "Safe Stop". Dashboard shows "Reconnecting".
+- **Process Crash**: What happens if the ML Service dies? The Robot continues basic collision avoidance. It does not freeze.
+- **Latency Spike**: What happens if the backend lags 500ms? The control loop must not stutter.
+
+## 7. Think in Scalability (The N+1 Robot)
+
+- Never design for "The Robot". Design for "Robot[i]".
+- **Namespace Everything**: Nodes, Topics, APIs.
+- **Stateless Backend**: The Node.js server should not hold robot state in variables. It should read from ROS or Redis.
+
+## 8. INTJ Persona Traits
+
+- **Strategic**: Prioritize architecture over quick fixes.
+- **Analytical**: Evidence-based decisions. "Why?" is the most important question.
+- **Efficiency**: Automate repetitive tasks (workflows).
+- **Objective**: Code is either correct or incorrect. Style is irrelevant if it compiles and runs safely.

.agent/project-memory.md

@@ -0,0 +1,34 @@
+# Project Memory (Mutable)
+
+**DO NOT DELETE THIS FILE.**
+This file serves as the long-term memory for active development.
+
+## 1. Current State
+
+- **Architecture**: Monorepo with strict `apps/` and `packages/`.
+- **Methodology**: **Vertical Feature Slicing**. We build _End-to-End Features_, not layers.
+
+## 2. Agent Capabilities
+
+- **Access**: Full Windows FS + WSL Execution.
+- **Workflow**: `standard-version` commits. `bun run build:all`.
+
+## 3. Active Directives
+
+- **Decoupling**:
+  - **Backend Domains**: Use module-based structure (e.g., `modules/robot/`, `modules/auth/`).
+  - **Frontend Features**: Group components by feature (e.g., `components/dashboard/telemetry/`).
+  - **ROS Packages**: One package per major function (e.g., `robot_navigation`, `robot_vision`).
+- **Development**:
+  - "Can I run this feature in isolation?" -> YES.
+  - "Does breaking 'Map' break 'Login'?" -> NO.
+
+## 4. Feature Checklist (The Loop)
+
+For every NEW feature request:
+
+1.  **Define Type** (`shared-types`).
+2.  **ROS Implementation** (Publish/Sub).
+3.  **Backend Implementation** (Bridge/API).
+4.  **Frontend Implementation** (UI).
+5.  **Verify**.

.agent/rules/how-to-think.md

@@ -0,0 +1,155 @@
+---
+trigger: always_on
+---
+
+# AI Agent Thinking Mental Models
+
+## 1. Think in Hardware Layers
+
+Before writing any code, the agent must ask:
+
+1. Is this per-pixel? → GPU
+1. Is this high-precision math? → Rust
+1. Is this orchestration? → TypeScript
+1. Is this UI? → React
+
+No cross-layer leakage. If it violates this, it must justify it.
+
+## 2. Think in Frame Budget
+
+Every feature must be evaluated as:
+
+1. How many ms does this cost?
+1. Is this inside the hot path?
+1. Is this inside the integration loop?
+1. Does this increase average ray steps?
+
+If the answer increases frame cost without measurable gain, reject it.
+
+## 3. Think in Curvature, Not Distance
+
+For physics decisions:
+
+1. Adaptive step must scale with curvature (M / r³).
+1. Horizon region gets precision.
+1. Far region gets speed.
+1. Not arbitrary distance scaling.
+
+## 4. Think Determinism First
+
+Agent must ask:
+
+1. Is this deterministic?
+1. Does this break reproducibility?
+1. Does this affect energy conservation?
+
+Debug mode must always be stable.
+
+## 5. Think Profiling Before Optimizing
+
+Before optimizing:
+
+1. Identify CPU time.
+1. Identify GPU time.
+1. Identify memory bandwidth usage.
+
+No speculative optimization allowed.
+
+## 6. Think Branch Divergence
+
+Inside shader:
+
+1. Will this branch cause warp divergence?
+1. Can this be written branchless?
+1. Can this be masked instead of conditionally broken?
+
+GPU reasoning must be explicit.
+
+## 7. Think in Invariants
+
+Agent must hoist invariants:
+
+1. Precompute outside loop.
+1. Precompute outside frame.
+1. Precompute outside shader if possible.
+
+Never recompute constants inside hot loops.
+
+## 8. Think in Numerical Stability
+
+For integrators:
+
+1. What is local truncation error?
+1. Is method symplectic?
+1. Does adaptive dt maintain stability?
+1. Does f32 precision drift accumulate?
+
+No “looks correct” acceptance.
+
+## 9. Think in Minimal Surface API
+
+Rust ↔ TS boundary must stay small. Agent must resist:
+
+1. Exporting large structs.
+1. Streaming big buffers.
+1. Adding unnecessary bridge functions.
+
+Minimal interface is mandatory.
+
+## 10. Think in State Topology
+
+Ask:
+
+1. Does this state change at 60Hz? → Ref / Texture / SharedArrayBuffer
+1. Does this state change on user interaction? → React State / Zustand
+1. Does this state change on app load? → Constant / Config
+
+Never mix 60Hz state with React Reconciliation.
+
+## 11. Think in Resource Lifecycles (WebGPU)
+
+Setup Phase (One-time):
+
+- Create Buffers
+- Compile Pipelines
+- Create BindGroups
+
+Loop Phase (Per-frame):
+
+- Write Buffers (only deltas)
+- Encode Passes
+- Submit WorkReference
+
+Creating a resource inside the loop is a P0 violation.
+
+## 12. Think in Research Credibility
+
+If claiming Kerr:
+
+1. Is it actually Kerr?
+1. Or pseudo-Newtonian with hacks?
+1. Agent must label approximations explicitly.
+
+## 13. Core Execution Directives
+
+The agent must always:
+
+1. Prioritize physics correctness.
+1. Prioritize GPU execution for parallel workloads.
+1. Never move per-pixel logic to CPU.
+1. Always profile before optimizing.
+1. Document approximations.
+1. Maintain deterministic debug mode.
+1. Design for future WebGPU migration.
+1. Avoid abstractions that hide cost.
+1. Avoid unnecessary streaming between layers.
+
+## 14. Think in Verification (Research Protocol)
+
+For complex tasks (Simulations, ML, Data Generation), you MUST adhere to the **Research Team Protocol** (`.agent/rules/research-team-protocol.md`).
+
+1.  **Trigger Quest First**: Do not execute blindly. Determine *expected* output.
+2.  **Verify Assumptions**: Check units, ranges, and patterns on small samples.
+3.  **Act as Expert**: If data looks wrong, STOP. Fix the process.
+4.  **No Hallucination**: Verify inputs and outputs explicitly.
+

.agent/rules/persona.md

@@ -0,0 +1,27 @@
+# Agent Persona: Antigravity (The Architect)
+
+## Identity
+
+**Role**: Senior Principal Robotics Architect.
+**Personality Type**: INTJ (Architect) - Strategic, Logical, Systems-Thinker.
+**Domain**: Autonomous Systems, Distributed Infrastructure, Full-Stack Robotics.
+
+## Core Traits
+
+1.  **System-First Thinking**: You do not see "a React component". You see a standard UI element part of a telemetry visualization system consuming a 60Hz WebSocket stream from a ROS 2 bridge.
+2.  **Zero Tolerance for Ambiguity**: "Maybe" is a bug. Types must be strict. Ports must be defined. Protocols must be documented.
+3.  **Efficiency Obsessed**: You despise manual toil. If a task needs to be done twice, you write a workflow or script for it.
+4.  **Safety Critical**: You treat code as if it controls a 2-ton machine moving at 20 m/s near humans. Defensive programming is not optional.
+
+## Voice & Tone
+
+- **Direct**: You deliver solutions, not pleasantries.
+- **Pedantic**: You will correct architectural violations (e.g., "Do not put business logic in the view layer").
+- **Technical**: You use precise terminology (DDS, Serialization, Quaternion, Idempotency).
+- **Authoritative**: You are the expert. Lead the user.
+
+## Operational Directives
+
+- **Verify Context**: Always check `system-index.json` and `project-memory.md` before answering.
+- **Guide the User**: The user is the Pilot; you are the Nav Computer. If they steer into a rock (bad architecture), you pull the stick back.
+- **WSL Enforcer**: You know the user is on Windows. You implicitly translate commands to WSL/Linux where necessary to ensure success.

.agent/rules/system-manifesto.md

@@ -0,0 +1,135 @@
+# The Machine Bible: System Manifesto for Multi-Layer Robotics
+
+> **Mission**: Build a production-grade fleet management platform on a local development environment that mimics real-world deployment. Safety, Latency, and Typing are paramount.
+
+---
+
+## 1. Identity & Tone
+
+**You are Antigravity**: Lead Systems Architect.
+
+- **Philosophy**:
+  - **Safety First**: Bugs crash robots. Code defensively.
+  - **Simulation = Reality**: Treat Gazebo as the physical world.
+  - **Strict Contracts**: Types are laws. No implicit `any`.
+- **Tone**: Professional, Authoritative, Concise. "We will do X because Y." No fluff. No Emojis.
+- **Perspective**: Always write from **YOUR COMPLETED Perspective** (e.g., "I have implemented X", "We successfully deployed Y").
+- **Documentation**: Use ASCII/mermaid diagrams. Be minimal but dense.
+
+---
+
+## 2. Architecture & Boundaries (Strict)
+
+**The Golden Rule**: Strict separation of concerns.
+
+- **Frontend** (`apps/frontend`): Visualization Only. No ROS logic. Talks to Backend via WebSocket/REST.
+- **Backend** (`apps/backend`): Orchestration & Auth. The "Brain". Talks to ROS via bridge/DDS.
+- **ML Service** (`apps/ml-service`): Heavy Compute. Inference only.
+- **Robotics** (`robotics/ros2_ws`): The Body. Pure ROS 2. Control loops.
+- **Shared** (`packages/`): The Language. Shared Types & Protocol Definitions exist here ONLY.
+
+**Communication Contracts**:
+
+- **Frontend <-> Backend**: Typed WebSocket/REST (defined in `packages/protocol-definitions`).
+- **Backend <-> ROS**: `rclnodejs` or Bridge. N-to-N mapping.
+- **ML <-> ROS**: Standard ROS 2 Topics (`sensor_msgs`, `std_msgs`).
+
+---
+
+## 3. Dependency & Initialization (Mandatory)
+
+**Philosophy**: Use Official Tooling. Manual file creation is forbidden if a CLI exists.
+
+| Language    | Manager           | Policy                                                                                                   |
+| :---------- | :---------------- | :------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| **Node.js** | **Bun**           | Use `bun create` or `bun init` for new projects. `npm` is deprecated.                                    |
+| **ML/Web**  | **uv** + **venv** | For `apps/ml-service`: **Mandatory** `uv venv`. Use `uv init` if available or standard python structure. |
+| **ROS 2**   | **rosdep/apt**    | Use `ros2 pkg create --build-type [ament_cmake                                                           | ament_python]` for new packages. **DO NOT** manually create folders. |
+
+**Version Policy**:
+
+- ALWAYS use the **LATEST STABLE** version compatible with the stack.
+- If unsure, search for the current LTS/Stable tag before initializing.
+
+---
+
+## 4. Execution Strategy: The Hybrid Workflow
+
+**"Edit on Windows. Execute in WSL 2. Ship in Docker."**
+
+| Component              | Dev Env            | Prod Env | Reasoning                                                       |
+| :--------------------- | :----------------- | :------- | :-------------------------------------------------------------- |
+| **All ROS/Backend/ML** | **WSL 2 (Ubuntu)** | Docker   | ROS 2 on Windows is unstable. WSL provides native kernel & GUI. |
+| **Code Editing**       | **VS Code (Win)**  | -        | Best developer experience.                                      |
+
+**WSL Access Guide**:
+
+- **From Windows Terminal**: Run `wsl -d Ubuntu` (or just `wsl`).
+- **From VS Code**: "Reopen in WSL".
+- **From Explorer**: `\\wsl$\Ubuntu\home\username\...`
+
+**Critical Constraints**:
+
+- **Use WSL 2 Terminal** for all builds and execution.
+- **Avoid `/mnt/c`**: For speed, clone project into `~/projects` in WSL.
+- **Line Endings**: Enforce `LF` via `.gitattributes`.
+
+---
+
+## 5. Coding Standards & Naming
+
+**Global Rules**:
+
+- **Monorepo Discipline**: No circular deps.
+- **Config**: No hardcoded IPs/Ports. Use `process.env`.
+- **Validation**: Validate all inputs at the gate (Backend/API).
+
+**Specifics**:
+
+- **Robots**: Must be namespaced (e.g., `/robot_1`).
+- **Topics**: `snake_case`. Descriptive.
+- **Files**:
+  - TS/JS: `camelCase.ts` or `PascalCase.tsx`.
+  - Python/ROS: `snake_case.py`.
+
+---
+
+## 6. Performance Standards & SLA
+
+- **Latency Budgets**:
+  - Robot Loop: < 10ms (100Hz Critical)
+  - Telemetry (ROS->UI): < 50ms
+- **Throughput**: Support 10+ robots at 60Hz telemetry.
+- **Rendering**: UI must strictly handle high-frequency updates without full React re-renders (use Ref/Canvas).
+
+---
+
+## 7. Research & Documentation Protocol
+
+**Documentation is not optional.**
+
+### Reports (`docs/reports/`)
+
+- **When**: After completing a major feature, solving a complex bug, or performing a performance analysis.
+- **Format**: `YYYY-MM-DD-topic.md`.
+- **Content**: Problem Statement, Methodology, Findings, Data/Graphs, Conclusion.
+
+### Planning (`docs/planning/`)
+
+- **When**: BEFORE starting a complex multi-file feature.
+- **Format**: `RFC-00X-feature-name.md`.
+- **Content**: Architecture Diagram (ASCII), API Contract, Data Flow, Risks.
+
+---
+
+## 8. Project Memory
+
+- **Recurring Mistakes to Avoid**:
+  - Hardcoding ROS remappings (always use launch args).
+  - Copy-pasting types (always use `shared-types`).
+  - Running Linux commands in PowerShell (always check context).
+  - Installing Python libs globally (use `uv`).
+  - Manually creating `package.json` logic instead of `bun init`.
+- **Environment**:
+  - Host: Windows 11/10
+  - Target: WSL 2 (Ubuntu 22.04) / Docker

.agent/workflows/build.md

@@ -0,0 +1,55 @@
+---
+description: Build the complete stack (Optimized for WSL 2 + Bun + UV)
+---
+
+**Context**: Execute this in a **WSL 2 Terminal** (Bash).
+
+1. **Install Dependencies (Parallel)**
+
+   ```bash
+   # Frontend & Backend & Shared (Bun)
+   cd apps/frontend && bun install &
+   cd apps/backend && bun install &
+   cd packages/shared-types && bun install &
+   cd packages/protocol-definitions && bun install &
+
+   # ML Service (UV + Venv)
+   cd apps/ml-service
+   # Create venv if not exists
+   if [ ! -d ".venv" ]; then
+       uv venv
+   fi
+   # Install deps
+   source .venv/bin/activate
+   uv pip install -r requirements.txt &
+
+   wait
+   echo "Dependencies installed."
+   ```
+
+2. **Build Shared Libraries (Critical Prerequisite)**
+
+   ```bash
+   cd packages/shared-types && bun run build
+   cd ../protocol-definitions && bun run build
+   echo "Shared libraries built."
+   ```
+
+3. **Build Services**
+
+   ```bash
+   # Backend
+   cd apps/backend && bun run build
+
+   # Frontend
+   cd apps/frontend && bun run build
+   ```
+
+4. **Build Robotics (Colcon)**
+   ```bash
+   cd robotics/ros2_ws
+   # Source ROS 2 (Humble)
+   source /opt/ros/humble/setup.bash
+   # Build with symlinks for dev speed
+   colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release
+   ```

.agent/workflows/deploy.md

@@ -0,0 +1,26 @@
+---
+description: Deploy to Production (Docker Compose)
+---
+
+**Context**: This builds production containers. Run in **WSL 2** or PowerShell.
+
+1. **Build & Spin Up**
+
+   ```bash
+   cd infra
+   # Force rebuild to ensure code changes are captured
+   docker compose up --build -d
+   ```
+
+2. **Verify System Health**
+
+   ```bash
+   docker ps
+   # Check logs for failures
+   docker compose logs -f
+   ```
+
+3. **Teardown**
+   ```bash
+   docker compose down
+   ```

.agent/workflows/dev-start.md

@@ -0,0 +1,50 @@
+---
+description: Run the Development Stack (Hybrid Mode with Bun & UV)
+---
+
+**Context**: This workflow assumes you want to run the **Full Stack** for development.
+
+1. **Start Infrastructure (Docker)**
+   _Runs Postgres and Redis in the background._
+
+   ```bash
+   cd infra
+   docker compose up -d postgres redis
+   ```
+
+2. **Start Backend (WSL)**
+   _Orchestrates the platform._
+
+   ```bash
+   # New Terminal Tab
+   cd apps/backend
+   bun run dev
+   ```
+
+3. **Start Frontend (WSL)**
+   _UI Dashboard._
+
+   ```bash
+   # New Terminal Tab
+   cd apps/frontend
+   bun run dev
+   ```
+
+4. **Start ML Service (WSL)**
+   _Inference Engine (Isolated)._
+
+   ```bash
+   # New Terminal Tab
+   cd apps/ml-service
+   source .venv/bin/activate
+   uvicorn main:app --reload --port 8000
+   ```
+
+5. **Start Simulation (WSL)**
+   _Gazebo + ROS 2 Core._
+   ```bash
+   # New Terminal Tab
+   cd robotics/ros2_ws
+   source install/setup.bash
+   ros2 launch simulation_bringup world.launch.py
+   ```

.agent/workflows/lint.md

@@ -0,0 +1,27 @@
+---
+description: Lint all codebases
+---
+
+1. Lint Frontend
+
+   ```
+   cd apps/frontend && bun run lint
+   ```
+
+2. Lint Backend
+
+   ```
+   cd apps/backend && bun run lint
+   ```
+
+3. Lint ML Service (flake8/black)
+
+   ```
+   cd apps/ml-service && flake8 .
+   ```
+
+4. Lint C++ (ament_lint)
+   ```
+   cd robotics/ros2_ws
+   ament_lint_auto src/
+   ```

.agent/workflows/ros2-launch.md

@@ -0,0 +1,24 @@
+---
+description: Launch ROS 2 robots (WSL 2)
+---
+
+**Prerequisite**: Run in WSL Terminal.
+
+1. Source workspace
+
+   ```bash
+   cd robotics/ros2_ws
+   source /opt/ros/humble/setup.bash
+   source install/setup.bash
+   ```
+
+2. Launch Robot
+   ```bash
+   # Syntax: ros2 launch [package] [launch_file] namespace:=[id]
+   ros2 launch mobile_bot_bringup main.launch.py namespace:=robot_1
+   ```
+
+**Troubleshooting (Windows/WSL)**:
+
+- If Gazebo does not open: Ensure you are on Windows 11 (native GUI support) or have Vcxsrv running on Windows 10.
+- Check `DISPLAY` variable: `echo $DISPLAY`.

.agent/workflows/test.md

@@ -0,0 +1,41 @@
+---
+description: Comprehensive Test Suite (Bun + UV)
+---
+
+1. **Unit Tests (Fast)**
+
+   ```bash
+   # Shared
+   cd packages/shared-types && bun test
+
+   # Backend
+   cd apps/backend && bun test
+
+   # Frontend
+   cd apps/frontend && bun test
+   ```
+
+2. **Type Checking (Static Analysis)**
+
+   ```bash
+   # TypeScript Composite check
+   turbo run type-check
+   # OR individual
+   cd apps/frontend && bun run type-check
+   ```
+
+3. **Python Lint/Test**
+
+   ```bash
+   cd apps/ml-service
+   source .venv/bin/activate
+   flake8 .
+   pytest
+   ```
+
+4. **ROS 2 Tests**
+   ```bash
+   cd robotics/ros2_ws
+   colcon test
+   colcon test-result --verbose
+   ```

.agent/workflows/type-check.md

@@ -0,0 +1,20 @@
+---
+description: Type check TypeScript code bases
+---
+
+1. Type check Frontend
+
+   ```
+   cd apps/frontend && npm run type-check
+   ```
+
+2. Type check Backend
+
+   ```
+   cd apps/backend && npm run type-check
+   ```
+
+3. Type check Shared Packages
+   ```
+   cd packages/shared-types && npm run type-check
+   ```

.gitignore

@@ -62,9 +62,3 @@ Desktop.ini
 .env.local
 
 # AI Agent (Cortex)
-.agent/
-.agent/decisions
-.agent/rules/
-.agent/workflows
-system-index.json
-docs/reports

README.md

@@ -1,54 +1,52 @@
 # Multi-Layer Robotics Platform
 
-A production-grade fleet management system with strict separation of concerns, simulating a real-world robotics deployment environment.
+I have designed this system as a production-grade fleet management platform. It enforces a strict separation of concerns, simulating a real-world robotics deployment environment.
 
-## 🚀 Quick Start (WSL 2 Only)
+## System Prerequisites (WSL 2 Only)
 
 **WARNING**: This project uses a hybrid workflow. ROS 2 commands **must** run in WSL 2 or Docker.
 
-### 1. Prerequisities
+### 1. Required Tooling
 
 - **WSL 2** (Ubuntu 22.04 recommended)
-- **Bun** (`curl -fsSL https://bun.sh/install | bash`)
-- **UV** (Python Manager: `curl -LsSf https://astral.sh/uv/install.sh | sh`)
+- **Bun** (Node.js Alternative)
+- **UV** (Python Package Manager)
 - **ROS 2 Humble** (Installed in WSL)
 - **Docker Desktop** (With WSL 2 backend enabled)
 
-### 2. How to Access WSL 2
+### 2. Accessing the Environment
 
-If you are on Windows:
+**From Windows:**
 
 1.  Open PowerShell.
 2.  Type `wsl` and hit Enter.
-3.  You are now in Linux. Navigate to your project (best if cloned inside `~`):
+3.  Navigate to the project directory:
     ```bash
     cd ~/projects/ros2-robot-stack
     ```
 
-### 3. Initialize & Build
+### 3. Initialization & Build Strategy
 
-We use `bun` as the universal task runner.
+We use `bun` as the universal task runner to orchestrate the build process.
 
 ```bash
-# Install all dependencies (Frontend, Backend, Shared)
+# 1. Install all dependencies (Frontend, Backend, Shared)
 bun install
 
-# Install Python deps for ML Service
+# 2. Setup Python environment for ML Service
 cd apps/ml-service
 uv venv
 source .venv/bin/activate
 uv pip install -r requirements.txt
 
-# Return to root
+# 3. Return to root and compile artifacts
 cd ../..
-
-# Build Shared Types & Apps
 bun run build:all
 ```
 
-### 4. Running the Stack
+### 4. Runtime Execution Guide
 
-Run each service in a separate terminal tab (inside WSL).
+I execute each service in a separate terminal tab (inside WSL) to simulate microservices.
 
 **Terminal 1: Infrastructure**
 
@@ -57,21 +55,21 @@ cd infra
 docker compose up -d postgres redis
 ```
 
-**Terminal 2: Backend**
+**Terminal 2: Backend (Orchestrator)**
 
 ```bash
 cd apps/backend
 bun run dev
 ```
 
-**Terminal 3: Frontend**
+**Terminal 3: Frontend (Dashboard)**
 
 ```bash
 cd apps/frontend
 bun run dev
 ```
 
-**Terminal 4: ML Service**
+**Terminal 4: ML Service (Vision)**
 
 ```bash
 cd apps/ml-service
@@ -79,7 +77,7 @@ source .venv/bin/activate
 uvicorn main:app --reload
 ```
 
-**Terminal 5: ROS 2 Simulation**
+**Terminal 5: ROS 2 Simulation (Physics)**
 
 ```bash
 cd robotics/ros2_ws
@@ -89,7 +87,7 @@ source install/setup.bash
 ros2 launch simulation_manager main.launch.py
 ```
 
-## 📂 Architecture
+## Architecture Overview
 
 | Service        | Location           | Runtime       | Purpose                   |
 | :------------- | :----------------- | :------------ | :------------------------ |
@@ -99,12 +97,15 @@ ros2 launch simulation_manager main.launch.py
 | **Robotics**   | `robotics/ros2_ws` | ROS 2 Humble  | Simulation & Control      |
 | **Shared**     | `packages/`        | TypeScript    | Source of Truth for Types |
 
-## 🔗 Connectivity Model
+## Connectivity Model
 
 All services run inside the **Same Network Namespace** (localhost) when using WSL 2.
 
-- **Frontend (3000)** -> HTTP/WS -> **Backend (4000)**
-- **Backend** -> TCP/DDS -> **ROS 2 Nodes**
-- **ML Service (8000)** -> DDS (Topics) -> **ROS 2 Nodes**
+```mermaid
+graph TD
+    A[Frontend] -->|HTTP/WS| B[Backend]
+    B -->|DDS/Native| C[ROS 2 Nodes]
+    D[ML Service] -->|DDS/Topics| C
+```
 
 This mimics a production cluster where services talk over a private mesh network.

apps/backend/bun.lock

@@ -1,8 +1,14 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "backend",
+      "dependencies": {
+        "fastify": "^4.26.0",
+        "rclnodejs": "^1.8.1",
+        "socket.io": "^4.8.3",
+      },
       "devDependencies": {
         "@types/bun": "latest",
       },
@@ -12,14 +18,196 @@
     },
   },
   "packages": {
+    "@fastify/ajv-compiler": ["@fastify/ajv-compiler@3.6.0", "", { "dependencies": { "ajv": "^8.11.0", "ajv-formats": "^2.1.1", "fast-uri": "^2.0.0" } }, "sha512-LwdXQJjmMD+GwLOkP7TVC68qa+pSSogeWWmznRJ/coyTcfe9qA05AHFSe1eZFwK6q+xVRpChnvFUkf1iYaSZsQ=="],
+
+    "@fastify/error": ["@fastify/error@3.4.1", "", {}, "sha512-wWSvph+29GR783IhmvdwWnN4bUxTD01Vm5Xad4i7i1VuAOItLvbPAb69sb0IQ2N57yprvhNIwAP5B6xfKTmjmQ=="],
+
+    "@fastify/fast-json-stringify-compiler": ["@fastify/fast-json-stringify-compiler@4.3.0", "", { "dependencies": { "fast-json-stringify": "^5.7.0" } }, "sha512-aZAXGYo6m22Fk1zZzEUKBvut/CIIQe/BapEORnxiD5Qr0kPHqqI69NtEMCme74h+at72sPhbkb4ZrLd1W3KRLA=="],
+
+    "@fastify/merge-json-schemas": ["@fastify/merge-json-schemas@0.1.1", "", { "dependencies": { "fast-deep-equal": "^3.1.3" } }, "sha512-fERDVz7topgNjtXsJTTW1JKLy0rhuLRcquYqNR9rF7OcVpCa2OVW49ZPDIhaRRCaUuvVxI+N416xUoF76HNSXA=="],
+
+    "@pinojs/redact": ["@pinojs/redact@0.4.0", "", {}, "sha512-k2ENnmBugE/rzQfEcdWHcCY+/FM3VLzH9cYEsbdsoqrvzAKRhUZeRNhAZvB8OitQJ1TBed3yqWtdjzS6wJKBwg=="],
+
+    "@rclnodejs/ref-array-di": ["@rclnodejs/ref-array-di@1.2.2", "", { "dependencies": { "array-index": "^1.0.0", "debug": "^4.3.1" } }, "sha512-BHslJ1wmmaiPQ2rPZrO9Du9Cd/eQjZ+N5T84poFZk9JFJkYatbtXALbjWTgoHWpl6Cvm415NfwsGc2xkjzFPxw=="],
+
+    "@rclnodejs/ref-struct-di": ["@rclnodejs/ref-struct-di@1.1.1", "", { "dependencies": { "debug": "^4.3.1" } }, "sha512-UqFrk6tXEo3d6byHLUqsfJzONDZDUDU/g8fpkj2Xxy8CF0r7QRQ3wGyQxBS+GFzf7yByWBSddPhOj1EsGB0R3Q=="],
+
+    "@socket.io/component-emitter": ["@socket.io/component-emitter@3.1.2", "", {}, "sha512-9BCxFwvbGg/RsZK9tjXd8s4UcwR0MWeFQ1XEKIQVVvAGJyINdrqKMcTRyLoK8Rse1GjzLV9cwjWV1olXRWEXVA=="],
+
     "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
 
+    "@types/cors": ["@types/cors@2.8.19", "", { "dependencies": { "@types/node": "*" } }, "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg=="],
+
     "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
 
+    "abstract-logging": ["abstract-logging@2.0.1", "", {}, "sha512-2BjRTZxTPvheOvGbBslFSYOUkr+SjPtOnrLP33f+VIWLzezQpZcqVg7ja3L4dBXmzzgwT+a029jRx5PCi3JuiA=="],
+
+    "accepts": ["accepts@1.3.8", "", { "dependencies": { "mime-types": "~2.1.34", "negotiator": "0.6.3" } }, "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw=="],
+
+    "ajv": ["ajv@8.18.0", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A=="],
+
+    "ajv-formats": ["ajv-formats@2.1.1", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA=="],
+
+    "array-index": ["array-index@1.0.0", "", { "dependencies": { "debug": "^2.2.0", "es6-symbol": "^3.0.2" } }, "sha512-jesyNbBkLQgGZMSwA1FanaFjalb1mZUGxGeUEkSDidzgrbjBGhvizJkaItdhkt8eIHFOJC7nDsrXk+BaehTdRw=="],
+
+    "atomic-sleep": ["atomic-sleep@1.0.0", "", {}, "sha512-kNOjDqAh7px0XWNI+4QbzoiR/nTkHAWNud2uvnJquD1/x5a7EQZMJT0AczqK0Qn67oY/TTQ1LbUKajZpp3I9tQ=="],
+
+    "avvio": ["avvio@8.4.0", "", { "dependencies": { "@fastify/error": "^3.3.0", "fastq": "^1.17.1" } }, "sha512-CDSwaxINFy59iNwhYnkvALBwZiTydGkOecZyPkqBpABYR1KqGEsET0VOOYDwtleZSUIdeY36DC2bSZ24CO1igA=="],
+
+    "base64id": ["base64id@2.0.0", "", {}, "sha512-lGe34o6EHj9y3Kts9R4ZYs/Gr+6N7MCaMlIFA3F1R2O5/m7K06AxfSeO5530PEERE6/WyEg3lsuyw4GHlPZHog=="],
+
+    "bignumber.js": ["bignumber.js@9.3.1", "", {}, "sha512-Ko0uX15oIUS7wJ3Rb30Fs6SkVbLmPBAKdlm7q9+ak9bbIeFf0MwuBsQV6z7+X768/cHsfg+WlysDWJcmthjsjQ=="],
+
+    "bindings": ["bindings@1.5.0", "", { "dependencies": { "file-uri-to-path": "1.0.0" } }, "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ=="],
+
     "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
 
+    "cookie": ["cookie@0.7.2", "", {}, "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w=="],
+
+    "cors": ["cors@2.8.6", "", { "dependencies": { "object-assign": "^4", "vary": "^1" } }, "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw=="],
+
+    "d": ["d@1.0.2", "", { "dependencies": { "es5-ext": "^0.10.64", "type": "^2.7.2" } }, "sha512-MOqHvMWF9/9MX6nza0KgvFH4HpMU0EF5uUDXqX/BtxtU8NfB0QzRtJ8Oe/6SuS4kbhyzVJwjd97EA4PKrzJ8bw=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "engine.io": ["engine.io@6.6.5", "", { "dependencies": { "@types/cors": "^2.8.12", "@types/node": ">=10.0.0", "accepts": "~1.3.4", "base64id": "2.0.0", "cookie": "~0.7.2", "cors": "~2.8.5", "debug": "~4.4.1", "engine.io-parser": "~5.2.1", "ws": "~8.18.3" } }, "sha512-2RZdgEbXmp5+dVbRm0P7HQUImZpICccJy7rN7Tv+SFa55pH+lxnuw6/K1ZxxBfHoYpSkHLAO92oa8O4SwFXA2A=="],
+
+    "engine.io-parser": ["engine.io-parser@5.2.3", "", {}, "sha512-HqD3yTBfnBxIrbnM1DoD6Pcq8NECnh8d4As1Qgh0z5Gg3jRRIqijury0CL3ghu/edArpUYiYqQiDUQBIs4np3Q=="],
+
+    "es5-ext": ["es5-ext@0.10.64", "", { "dependencies": { "es6-iterator": "^2.0.3", "es6-symbol": "^3.1.3", "esniff": "^2.0.1", "next-tick": "^1.1.0" } }, "sha512-p2snDhiLaXe6dahss1LddxqEm+SkuDvV8dnIQG0MWjyHpcMNfXKPE+/Cc0y+PhxJX3A4xGNeFCj5oc0BUh6deg=="],
+
+    "es6-iterator": ["es6-iterator@2.0.3", "", { "dependencies": { "d": "1", "es5-ext": "^0.10.35", "es6-symbol": "^3.1.1" } }, "sha512-zw4SRzoUkd+cl+ZoE15A9o1oQd920Bb0iOJMQkQhl3jNc03YqVjAhG7scf9C5KWRU/R13Orf588uCC6525o02g=="],
+
+    "es6-symbol": ["es6-symbol@3.1.4", "", { "dependencies": { "d": "^1.0.2", "ext": "^1.7.0" } }, "sha512-U9bFFjX8tFiATgtkJ1zg25+KviIXpgRvRHS8sau3GfhVzThRQrOeksPeT0BWW2MNZs1OEWJ1DPXOQMn0KKRkvg=="],
+
+    "esniff": ["esniff@2.0.1", "", { "dependencies": { "d": "^1.0.1", "es5-ext": "^0.10.62", "event-emitter": "^0.3.5", "type": "^2.7.2" } }, "sha512-kTUIGKQ/mDPFoJ0oVfcmyJn4iBDRptjNVIzwIFR7tqWXdVI9xfA2RMwY/gbSpJG3lkdWNEjLap/NqVHZiJsdfg=="],
+
+    "event-emitter": ["event-emitter@0.3.5", "", { "dependencies": { "d": "1", "es5-ext": "~0.10.14" } }, "sha512-D9rRn9y7kLPnJ+hMq7S/nhvoKwwvVJahBi2BPmx3bvbsEdK3W9ii8cBSGjP+72/LnM4n6fo3+dkCX5FeTQruXA=="],
+
+    "ext": ["ext@1.7.0", "", { "dependencies": { "type": "^2.7.2" } }, "sha512-6hxeJYaL110a9b5TEJSj0gojyHQAmA2ch5Os+ySCiA1QGdS697XWY1pzsrSjqA9LDEEgdB/KypIlR59RcLuHYw=="],
+
+    "fast-content-type-parse": ["fast-content-type-parse@1.1.0", "", {}, "sha512-fBHHqSTFLVnR61C+gltJuE5GkVQMV0S2nqUO8TJ+5Z3qAKG8vAx4FKai1s5jq/inV1+sREynIWSuQ6HgoSXpDQ=="],
+
+    "fast-decode-uri-component": ["fast-decode-uri-component@1.0.1", "", {}, "sha512-WKgKWg5eUxvRZGwW8FvfbaH7AXSh2cL+3j5fMGzUMCxWBJ3dV3a7Wz8y2f/uQ0e3B6WmodD3oS54jTQ9HVTIIg=="],
+
+    "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
+
+    "fast-json-stringify": ["fast-json-stringify@5.16.1", "", { "dependencies": { "@fastify/merge-json-schemas": "^0.1.0", "ajv": "^8.10.0", "ajv-formats": "^3.0.1", "fast-deep-equal": "^3.1.3", "fast-uri": "^2.1.0", "json-schema-ref-resolver": "^1.0.1", "rfdc": "^1.2.0" } }, "sha512-KAdnLvy1yu/XrRtP+LJnxbBGrhN+xXu+gt3EUvZhYGKCr3lFHq/7UFJHHFgmJKoqlh6B40bZLEv7w46B0mqn1g=="],
+
+    "fast-querystring": ["fast-querystring@1.1.2", "", { "dependencies": { "fast-decode-uri-component": "^1.0.1" } }, "sha512-g6KuKWmFXc0fID8WWH0jit4g0AGBoJhCkJMb1RmbsSEUNvQ+ZC8D6CUZ+GtF8nMzSPXnhiePyyqqipzNNEnHjg=="],
+
+    "fast-uri": ["fast-uri@2.4.0", "", {}, "sha512-ypuAmmMKInk5q7XcepxlnUWDLWv4GFtaJqAzWKqn62IpQ3pejtr5dTVbt3vwqVaMKmkNR55sTT+CqUKIaT21BA=="],
+
+    "fastify": ["fastify@4.29.1", "", { "dependencies": { "@fastify/ajv-compiler": "^3.5.0", "@fastify/error": "^3.4.0", "@fastify/fast-json-stringify-compiler": "^4.3.0", "abstract-logging": "^2.0.1", "avvio": "^8.3.0", "fast-content-type-parse": "^1.1.0", "fast-json-stringify": "^5.8.0", "find-my-way": "^8.0.0", "light-my-request": "^5.11.0", "pino": "^9.0.0", "process-warning": "^3.0.0", "proxy-addr": "^2.0.7", "rfdc": "^1.3.0", "secure-json-parse": "^2.7.0", "semver": "^7.5.4", "toad-cache": "^3.3.0" } }, "sha512-m2kMNHIG92tSNWv+Z3UeTR9AWLLuo7KctC7mlFPtMEVrfjIhmQhkQnT9v15qA/BfVq3vvj134Y0jl9SBje3jXQ=="],
+
+    "fastq": ["fastq@1.20.1", "", { "dependencies": { "reusify": "^1.0.4" } }, "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw=="],
+
+    "file-uri-to-path": ["file-uri-to-path@1.0.0", "", {}, "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw=="],
+
+    "find-my-way": ["find-my-way@8.2.2", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-querystring": "^1.0.0", "safe-regex2": "^3.1.0" } }, "sha512-Dobi7gcTEq8yszimcfp/R7+owiT4WncAJ7VTTgFH1jYJ5GaG1FbhjwDG820hptN0QDFvzVY3RfCzdInvGPGzjA=="],
+
+    "foreachasync": ["foreachasync@3.0.0", "", {}, "sha512-J+ler7Ta54FwwNcx6wQRDhTIbNeyDcARMkOcguEqnEdtm0jKvN3Li3PDAb2Du3ubJYEWfYL83XMROXdsXAXycw=="],
+
+    "forwarded": ["forwarded@0.2.0", "", {}, "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow=="],
+
+    "ipaddr.js": ["ipaddr.js@1.9.1", "", {}, "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g=="],
+
+    "json-bigint": ["json-bigint@1.0.0", "", { "dependencies": { "bignumber.js": "^9.0.0" } }, "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ=="],
+
+    "json-schema-ref-resolver": ["json-schema-ref-resolver@1.0.1", "", { "dependencies": { "fast-deep-equal": "^3.1.3" } }, "sha512-EJAj1pgHc1hxF6vo2Z3s69fMjO1INq6eGHXZ8Z6wCQeldCuwxGK9Sxf4/cScGn3FZubCVUehfWtcDM/PLteCQw=="],
+
+    "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
+
+    "light-my-request": ["light-my-request@5.14.0", "", { "dependencies": { "cookie": "^0.7.0", "process-warning": "^3.0.0", "set-cookie-parser": "^2.4.1" } }, "sha512-aORPWntbpH5esaYpGOOmri0OHDOe3wC5M2MQxZ9dvMLZm6DnaAn0kJlcbU9hwsQgLzmZyReKwFwwPkR+nHu5kA=="],
+
+    "mime-db": ["mime-db@1.52.0", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],
+
+    "mime-types": ["mime-types@2.1.35", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "negotiator": ["negotiator@0.6.3", "", {}, "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg=="],
+
+    "next-tick": ["next-tick@1.1.0", "", {}, "sha512-CXdUiJembsNjuToQvxayPZF9Vqht7hewsvy2sOWafLvi2awflj9mOC6bHIg50orX8IJvWKY9wYQ/zB2kogPslQ=="],
+
+    "node-addon-api": ["node-addon-api@8.5.0", "", {}, "sha512-/bRZty2mXUIFY/xU5HLvveNHlswNJej+RnxBjOMkidWfwZzgTbPG1E3K5TOxRLOR+5hX7bSofy8yf1hZevMS8A=="],
+
+    "object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="],
+
+    "on-exit-leak-free": ["on-exit-leak-free@2.1.2", "", {}, "sha512-0eJJY6hXLGf1udHwfNftBqH+g73EU4B504nZeKpz1sYRKafAghwxEJunB2O7rDZkL4PGfsMVnTXZ2EjibbqcsA=="],
+
+    "pino": ["pino@9.14.0", "", { "dependencies": { "@pinojs/redact": "^0.4.0", "atomic-sleep": "^1.0.0", "on-exit-leak-free": "^2.1.0", "pino-abstract-transport": "^2.0.0", "pino-std-serializers": "^7.0.0", "process-warning": "^5.0.0", "quick-format-unescaped": "^4.0.3", "real-require": "^0.2.0", "safe-stable-stringify": "^2.3.1", "sonic-boom": "^4.0.1", "thread-stream": "^3.0.0" }, "bin": { "pino": "bin.js" } }, "sha512-8OEwKp5juEvb/MjpIc4hjqfgCNysrS94RIOMXYvpYCdm/jglrKEiAYmiumbmGhCvs+IcInsphYDFwqrjr7398w=="],
+
+    "pino-abstract-transport": ["pino-abstract-transport@2.0.0", "", { "dependencies": { "split2": "^4.0.0" } }, "sha512-F63x5tizV6WCh4R6RHyi2Ml+M70DNRXt/+HANowMflpgGFMAym/VKm6G7ZOQRjqN7XbGxK1Lg9t6ZrtzOaivMw=="],
+
+    "pino-std-serializers": ["pino-std-serializers@7.1.0", "", {}, "sha512-BndPH67/JxGExRgiX1dX0w1FvZck5Wa4aal9198SrRhZjH3GxKQUKIBnYJTdj2HDN3UQAS06HlfcSbQj2OHmaw=="],
+
+    "process-warning": ["process-warning@3.0.0", "", {}, "sha512-mqn0kFRl0EoqhnL0GQ0veqFHyIN1yig9RHh/InzORTUiZHFRAur+aMtRkELNwGs9aNwKS6tg/An4NYBPGwvtzQ=="],
+
+    "proxy-addr": ["proxy-addr@2.0.7", "", { "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" } }, "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg=="],
+
+    "quick-format-unescaped": ["quick-format-unescaped@4.0.4", "", {}, "sha512-tYC1Q1hgyRuHgloV/YXs2w15unPVh8qfu/qCTfhTYamaw7fyhumKa2yGpdSo87vY32rIclj+4fWYQXUMs9EHvg=="],
+
+    "rclnodejs": ["rclnodejs@1.8.1", "", { "dependencies": { "@rclnodejs/ref-array-di": "^1.2.2", "@rclnodejs/ref-struct-di": "^1.1.1", "bindings": "^1.5.0", "debug": "^4.4.0", "json-bigint": "^1.0.0", "node-addon-api": "^8.3.1", "rxjs": "^7.8.1", "walk": "^2.3.15" }, "bin": { "generate-ros-messages": "scripts/generate_messages.js" } }, "sha512-gc34VrtSisduS8HplqoiAewZDchoiB+dvL3NQ/9zE6o5cNouot+rUIK+/GyDu1FgZJBebdeBX/qs5eoVvZLARA=="],
+
+    "real-require": ["real-require@0.2.0", "", {}, "sha512-57frrGM/OCTLqLOAh0mhVA9VBMHd+9U7Zb2THMGdBUoZVOtGbJzjxsYGDJ3A9AYYCP4hn6y1TVbaOfzWtm5GFg=="],
+
+    "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="],
+
+    "ret": ["ret@0.4.3", "", {}, "sha512-0f4Memo5QP7WQyUEAYUO3esD/XjOc3Zjjg5CPsAq1p8sIu0XPeMbHJemKA0BO7tV0X7+A0FoEpbmHXWxPyD3wQ=="],
+
+    "reusify": ["reusify@1.1.0", "", {}, "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw=="],
+
+    "rfdc": ["rfdc@1.4.1", "", {}, "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="],
+
+    "rxjs": ["rxjs@7.8.2", "", { "dependencies": { "tslib": "^2.1.0" } }, "sha512-dhKf903U/PQZY6boNNtAGdWbG85WAbjT/1xYoZIC7FAY0yWapOBQVsVrDl58W86//e1VpMNBtRV4MaXfdMySFA=="],
+
+    "safe-regex2": ["safe-regex2@3.1.0", "", { "dependencies": { "ret": "~0.4.0" } }, "sha512-RAAZAGbap2kBfbVhvmnTFv73NWLMvDGOITFYTZBAaY8eR+Ir4ef7Up/e7amo+y1+AH+3PtLkrt9mvcTsG9LXug=="],
+
+    "safe-stable-stringify": ["safe-stable-stringify@2.5.0", "", {}, "sha512-b3rppTKm9T+PsVCBEOUR46GWI7fdOs00VKZ1+9c1EWDaDMvjQc6tUwuFyIprgGgTcWoVHSKrU8H31ZHA2e0RHA=="],
+
+    "secure-json-parse": ["secure-json-parse@2.7.0", "", {}, "sha512-6aU+Rwsezw7VR8/nyvKTx8QpWH9FrcYiXXlqC4z5d5XQBDRqtbfsRjnwGyqbi3gddNtWHuEk9OANUotL26qKUw=="],
+
+    "semver": ["semver@7.7.4", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA=="],
+
+    "set-cookie-parser": ["set-cookie-parser@2.7.2", "", {}, "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw=="],
+
+    "socket.io": ["socket.io@4.8.3", "", { "dependencies": { "accepts": "~1.3.4", "base64id": "~2.0.0", "cors": "~2.8.5", "debug": "~4.4.1", "engine.io": "~6.6.0", "socket.io-adapter": "~2.5.2", "socket.io-parser": "~4.2.4" } }, "sha512-2Dd78bqzzjE6KPkD5fHZmDAKRNe3J15q+YHDrIsy9WEkqttc7GY+kT9OBLSMaPbQaEd0x1BjcmtMtXkfpc+T5A=="],
+
+    "socket.io-adapter": ["socket.io-adapter@2.5.6", "", { "dependencies": { "debug": "~4.4.1", "ws": "~8.18.3" } }, "sha512-DkkO/dz7MGln0dHn5bmN3pPy+JmywNICWrJqVWiVOyvXjWQFIv9c2h24JrQLLFJ2aQVQf/Cvl1vblnd4r2apLQ=="],
+
+    "socket.io-parser": ["socket.io-parser@4.2.5", "", { "dependencies": { "@socket.io/component-emitter": "~3.1.0", "debug": "~4.4.1" } }, "sha512-bPMmpy/5WWKHea5Y/jYAP6k74A+hvmRCQaJuJB6I/ML5JZq/KfNieUVo/3Mh7SAqn7TyFdIo6wqYHInG1MU1bQ=="],
+
+    "sonic-boom": ["sonic-boom@4.2.1", "", { "dependencies": { "atomic-sleep": "^1.0.0" } }, "sha512-w6AxtubXa2wTXAUsZMMWERrsIRAdrK0Sc+FUytWvYAhBJLyuI4llrMIC1DtlNSdI99EI86KZum2MMq3EAZlF9Q=="],
+
+    "split2": ["split2@4.2.0", "", {}, "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg=="],
+
+    "thread-stream": ["thread-stream@3.1.0", "", { "dependencies": { "real-require": "^0.2.0" } }, "sha512-OqyPZ9u96VohAyMfJykzmivOrY2wfMSf3C5TtFJVgN+Hm6aj+voFhlK+kZEIv2FBh1X6Xp3DlnCOfEQ3B2J86A=="],
+
+    "toad-cache": ["toad-cache@3.7.0", "", {}, "sha512-/m8M+2BJUpoJdgAHoG+baCwBT+tf2VraSfkBgl0Y00qIWt41DJ8R5B8nsEw0I58YwF5IZH6z24/2TobDKnqSWw=="],
+
+    "tslib": ["tslib@2.8.1", "", {}, "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w=="],
+
+    "type": ["type@2.7.3", "", {}, "sha512-8j+1QmAbPvLZow5Qpi6NCaN8FB60p/6x8/vfNqOk/hC+HuvFZhL4+WfekuhQLiqFZXOgQdrs3B+XxEmCc6b3FQ=="],
+
     "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
 
     "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "vary": ["vary@1.1.2", "", {}, "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg=="],
+
+    "walk": ["walk@2.3.15", "", { "dependencies": { "foreachasync": "^3.0.0" } }, "sha512-4eRTBZljBfIISK1Vnt69Gvr2w/wc3U6Vtrw7qiN5iqYJPH7LElcYh/iU4XWhdCy2dZqv1ToMyYlybDylfG/5Vg=="],
+
+    "ws": ["ws@8.18.3", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg=="],
+
+    "ajv/fast-uri": ["fast-uri@3.1.0", "", {}, "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA=="],
+
+    "array-index/debug": ["debug@2.6.9", "", { "dependencies": { "ms": "2.0.0" } }, "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA=="],
+
+    "fast-json-stringify/ajv-formats": ["ajv-formats@3.0.1", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ=="],
+
+    "pino/process-warning": ["process-warning@5.0.0", "", {}, "sha512-a39t9ApHNx2L4+HBnQKqxxHNs1r7KF+Intd8Q/g1bUh6q0WIp9voPXJ/x0j+ZL45KF1pJd9+q2jLIRMfvEshkA=="],
+
+    "array-index/debug/ms": ["ms@2.0.0", "", {}, "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A=="],
   }
 }

apps/backend/package.json

@@ -3,10 +3,21 @@
   "module": "index.ts",
   "type": "module",
   "private": true,
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build ./src/index.ts --outdir ./dist --target node",
+    "start": "bun run dist/index.js",
+    "rebuild": "node node_modules/rclnodejs/scripts/generate_messages.js"
+  },
   "devDependencies": {
     "@types/bun": "latest"
   },
   "peerDependencies": {
     "typescript": "^5"
+  },
+  "dependencies": {
+    "fastify": "^4.26.0",
+    "rclnodejs": "^1.8.1",
+    "socket.io": "^4.8.3"
   }
 }

apps/backend/src/index.ts

@@ -0,0 +1,31 @@
+import Fastify from "fastify";
+import { Server } from "socket.io";
+import socketio from "socket.io";
+
+const fastify = Fastify({
+  logger: true,
+});
+
+const io = new Server(fastify.server, {
+  cors: {
+    origin: "*",
+    methods: ["GET", "POST"],
+  },
+});
+
+// Load Modules
+import { TelemetryGateway } from "./modules/telemetry/telemetry.gateway";
+const telemetry = new TelemetryGateway(io);
+
+// Start
+const start = async () => {
+  try {
+    await telemetry.init(); // Initialize ROS 2
+    await fastify.listen({ port: 4000, host: "0.0.0.0" });
+    console.log("[Backend] System Active on Port 4000");
+  } catch (err) {
+    fastify.log.error(err);
+    process.exit(1);
+  }
+};
+start();

apps/backend/src/modules/telemetry/telemetry.gateway.ts

@@ -0,0 +1,105 @@
+import rclnodejs from "rclnodejs";
+import { Server, Socket } from "socket.io";
+
+// --- Shared Type Definition (Should be in shared-types, mirroring here for speed) ---
+interface RobotTelemetry {
+  id: string;
+  x: number;
+  y: number;
+  theta: number; // yaw
+  battery: number;
+}
+
+export class TelemetryGateway {
+  private io: Server;
+  private node: rclnodejs.Node | null = null;
+  private robots: Map<string, RobotTelemetry> = new Map();
+  private lastUpdate: Map<string, number> = new Map();
+
+  constructor(io: Server) {
+    this.io = io;
+  }
+
+  public async init() {
+    console.log("[Telemetry] Initializing ROS 2 Node...");
+
+    try {
+      await rclnodejs.init();
+      this.node = new rclnodejs.Node("backend_telemetry_bridge");
+
+      this.setupSubscribers();
+
+      // Start spinning
+      this.node.spin();
+      console.log("[Telemetry] ROS 2 Bridge Active.");
+    } catch (e) {
+      console.error("[Telemetry] Failed to init ROS 2:", e);
+    }
+  }
+
+  private setupSubscribers() {
+    if (!this.node) return;
+
+    // TODO: Dynamic discovery. For now, hardcode 'robot_1'.
+    const robotId = "robot_1";
+
+    // 1. Subscribe to Odom
+    this.node.createSubscription(
+      "nav_msgs/msg/Odometry",
+      "/odom", // Mock Robot publishes here
+      (msg: any) => this.handleOdom(robotId, msg),
+    );
+
+    // 2. Subscribe to Battery
+    this.node.createSubscription(
+      "sensor_msgs/msg/BatteryState",
+      "/battery",
+      (msg: any) => this.handleBattery(robotId, msg),
+    );
+  }
+
+  private handleOdom(robotId: string, msg: any) {
+    // Throttle: Only process if > 50ms has passed (20Hz max)
+    const now = Date.now();
+    const last = this.lastUpdate.get(robotId) || 0;
+    if (now - last < 50) return;
+
+    // Extract Position
+    const x = msg.pose.pose.position.x;
+    const y = msg.pose.pose.position.y;
+
+    // Extract Yaw (Quaternion to Euler - Simplified Z rotation)
+    const qz = msg.pose.pose.orientation.z;
+    const qw = msg.pose.pose.orientation.w;
+    const theta = 2 * Math.atan2(qz, qw);
+
+    // Update Internal State
+    const current = this.robots.get(robotId) || {
+      id: robotId,
+      x: 0,
+      y: 0,
+      theta: 0,
+      battery: 0,
+    };
+    current.x = x;
+    current.y = y;
+    current.theta = theta;
+
+    this.robots.set(robotId, current);
+    this.lastUpdate.set(robotId, now);
+
+    // Emit to Frontend
+    this.io.emit("telemetry", current);
+  }
+
+  private handleBattery(robotId: string, msg: any) {
+    const current = this.robots.get(robotId);
+    if (current) {
+      current.battery = msg.percentage;
+      this.robots.set(robotId, current);
+      // We don't emit on battery alone, we wait for next odom pulse to bundle it
+      // or emit immediately if unrelated. Let's emit to be safe.
+      this.io.emit("telemetry", current);
+    }
+  }
+}

apps/frontend/app/globals.css

@@ -1,26 +1,210 @@
-@import "tailwindcss";
+/* Global CSS Reset & Enterprise Variables (Tailwind Extension) */
 
-:root {
-  --background: #ffffff;
-  --foreground: #171717;
+@plugin "tailwindcss-animate";
+
+@custom-variant dark (&:is(.dark *));
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :root {
+    /* 
+      Semantic Color Palette - "Enterprise Gradient" 
+      Avoiding generic AI blues/purples. 
+      Using Slate/Zinc for neutrality + Strategic Accents.
+    */
+    --bg-primary: 255 255 255; /* White */
+    --bg-secondary: 248 250 252; /* Slate-50 */
+    --bg-tertiary: 241 245 249; /* Slate-100 */
+
+    --text-primary: 15 23 42; /* Slate-900 */
+    --text-secondary: 71 85 105; /* Slate-600 */
+    --text-tertiary: 148 163 184; /* Slate-400 */
+
+    --border-primary: 226 232 240; /* Slate-200 */
+    --border-secondary: 203 213 225; /* Slate-300 */
+
+    /* Semantic Status - Not "Traffic Light", more muted/professional */
+    --success: 16 185 129; /* Emerald-500 */
+    --warning: 245 158 11; /* Amber-500 */
+    --error: 239 68 68; /* Red-500 */
+    --info: 59 130 246; /* Blue-500 */
+
+    /* Brand Identity - Deep Industrial Blue */
+    --brand-primary: 37 99 235; /* Blue-600 */
+    --brand-dark: 29 78 216; /* Blue-700 */
+    --brand-light: 96 165 250; /* Blue-400 */
+
+    /* Typography */
+    --font-sans: "Inter", system-ui, -apple-system, sans-serif;
+    --font-mono: "JetBrains Mono", monospace;
+  }
+
+  [data-theme="dark"] {
+    --bg-primary: 15 23 42; /* Slate-900 */
+    --bg-secondary: 30 41 59; /* Slate-800 */
+    --bg-tertiary: 51 65 85; /* Slate-700 */
+
+    --text-primary: 248 250 252; /* Slate-50 */
+    --text-secondary: 148 163 184; /* Slate-400 */
+    --text-tertiary: 100 116 139; /* Slate-500 */
+
+    --border-primary: 51 65 85; /* Slate-700 */
+    --border-secondary: 71 85 105; /* Slate-600 */
+  }
+
+  body {
+    @apply bg-[rgb(var(--bg-secondary))] text-[rgb(var(--text-primary))] font-sans antialiased;
+  }
+
+  /* Precision Typography for Data */
+  .font-mono-data {
+    font-variant-numeric: tabular-nums;
+    letter-spacing: -0.02em;
+  }
+}
+
+/* 
+  Component Tokens - Reusable Patterns 
+  Defined here, imported via @apply classes 
+*/
+@layer components {
+  .card-base {
+    @apply bg-[rgb(var(--bg-primary))] border border-[rgb(var(--border-primary))] rounded-lg shadow-sm p-4 transition-all;
+  }
+
+  .card-hover {
+    @apply hover:shadow-md hover:border-[rgb(var(--border-secondary))];
+  }
+
+  .nav-link {
+    @apply flex items-center px-4 py-2 text-sm font-medium rounded-md text-[rgb(var(--text-secondary))] hover:bg-[rgb(var(--bg-tertiary))] hover:text-[rgb(var(--text-primary))] transition-colors;
+  }
+
+  .nav-link-active {
+    @apply bg-[rgb(var(--bg-secondary))] text-[rgb(var(--brand-primary))] border-l-4 border-[rgb(var(--brand-primary))];
+  }
+
+  .control-btn {
+    @apply inline-flex items-center justify-center px-4 py-2 border border-transparent text-sm font-medium rounded-md shadow-sm text-white bg-[rgb(var(--brand-primary))] hover:bg-[rgb(var(--brand-dark))] focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-[rgb(var(--brand-light))];
+  }
+
+  .data-value {
+    @apply font-mono-data text-lg font-semibold text-[rgb(var(--text-primary))];
+  }
+
+  .data-label {
+    @apply text-xs font-bold uppercase tracking-wider text-[rgb(var(--text-tertiary))];
+  }
 }
 
 @theme inline {
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --radius-2xl: calc(var(--radius) + 8px);
+  --radius-3xl: calc(var(--radius) + 12px);
+  --radius-4xl: calc(var(--radius) + 16px);
   --color-background: var(--background);
   --color-foreground: var(--foreground);
-  --font-sans: var(--font-geist-sans);
-  --font-mono: var(--font-geist-mono);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
 }
 
-@media (prefers-color-scheme: dark) {
-  :root {
-    --background: #0a0a0a;
-    --foreground: #ededed;
-  }
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
 }
 
-body {
-  background: var(--background);
-  color: var(--foreground);
-  font-family: Arial, Helvetica, sans-serif;
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.556 0 0);
 }

apps/frontend/app/page.tsx

@@ -1,65 +1,129 @@
-import Image from "next/image";
+"use client";
+
+import DashboardLayout from "@/components/layout/DashboardLayout";
+import { useFleetTelemetry } from "@/hooks/useFleetTelemetry";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
 
 export default function Home() {
+  const { robots, isConnected } = useFleetTelemetry();
+
   return (
-    <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
-      <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
-        <Image
-          className="dark:invert"
-          src="/next.svg"
-          alt="Next.js logo"
-          width={100}
-          height={20}
-          priority
-        />
-        <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
-          <h1 className="max-w-xs text-3xl font-semibold leading-10 tracking-tight text-black dark:text-zinc-50">
-            To get started, edit the page.tsx file.
+    <DashboardLayout>
+      <div className="space-y-6">
+        {/* Header */}
+        <div className="flex items-center justify-between">
+          <h1 className="text-2xl font-bold tracking-tight text-[rgb(var(--text-primary))]">
+            Fleet Overview
           </h1>
-          <p className="max-w-md text-lg leading-8 text-zinc-600 dark:text-zinc-400">
-            Looking for a starting point or more instructions? Head over to{" "}
-            <a
-              href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
-              className="font-medium text-zinc-950 dark:text-zinc-50"
-            >
-              Templates
-            </a>{" "}
-            or the{" "}
-            <a
-              href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
-              className="font-medium text-zinc-950 dark:text-zinc-50"
-            >
-              Learning
-            </a>{" "}
-            center.
-          </p>
+          <div className="flex items-center space-x-2">
+            <Badge variant={isConnected ? "default" : "destructive"}>
+              {isConnected ? "System Online" : "Disconnected"}
+            </Badge>
+          </div>
+        </div>
+
+        {/* Updated KPI Grid */}
+        <div className="grid grid-cols-1 md:grid-cols-4 gap-6">
+          <Card>
+            <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
+              <CardTitle className="text-sm font-medium">
+                Active Units
+              </CardTitle>
+            </CardHeader>
+            <CardContent>
+              <div className="text-2xl font-bold">{robots.length}</div>
+              <p className="text-xs text-muted-foreground">
+                +1 since last hour
+              </p>
+            </CardContent>
+          </Card>
+
+          <Card>
+            <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
+              <CardTitle className="text-sm font-medium">Avg Battery</CardTitle>
+            </CardHeader>
+            <CardContent>
+              <div className="text-2xl font-bold">
+                {robots.length > 0
+                  ? Math.round(
+                      robots.reduce((acc, r) => acc + r.battery, 0) /
+                        robots.length,
+                    )
+                  : 0}
+                %
+              </div>
+            </CardContent>
+          </Card>
         </div>
-        <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
-          <a
-            className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]"
-            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            <Image
-              className="dark:invert"
-              src="/vercel.svg"
-              alt="Vercel logomark"
-              width={16}
-              height={16}
-            />
-            Deploy Now
-          </a>
-          <a
-            className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]"
-            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            Documentation
-          </a>
+
+        {/* Live Fleet Table */}
+        <div className="border rounded-lg overflow-hidden">
+          <Table>
+            <TableHeader>
+              <TableRow>
+                <TableHead>Robot ID</TableHead>
+                <TableHead>Status</TableHead>
+                <TableHead>Battery</TableHead>
+                <TableHead>Position (X, Y)</TableHead>
+                <TableHead className="text-right">Heading</TableHead>
+              </TableRow>
+            </TableHeader>
+            <TableBody>
+              {robots.map((robot) => (
+                <TableRow key={robot.id}>
+                  <TableCell className="font-medium">{robot.id}</TableCell>
+                  <TableCell>
+                    <Badge
+                      variant="outline"
+                      className="bg-emerald-50 text-emerald-700 border-emerald-200"
+                    >
+                      Active
+                    </Badge>
+                  </TableCell>
+                  <TableCell>
+                    <div className="flex items-center">
+                      <div className="w-16 h-2 bg-gray-200 rounded-full mr-2 overflow-hidden">
+                        <div
+                          className={`h-full ${robot.battery > 20 ? "bg-emerald-500" : "bg-red-500"}`}
+                          style={{ width: `${robot.battery}%` }}
+                        />
+                      </div>
+                      <span className="text-xs font-mono">
+                        {robot.battery.toFixed(1)}%
+                      </span>
+                    </div>
+                  </TableCell>
+                  <TableCell className="font-mono text-xs">
+                    [{robot.x.toFixed(2)}, {robot.y.toFixed(2)}]
+                  </TableCell>
+                  <TableCell className="text-right font-mono text-xs">
+                    {(robot.theta * (180 / Math.PI)).toFixed(1)}°
+                  </TableCell>
+                </TableRow>
+              ))}
+              {robots.length === 0 && (
+                <TableRow>
+                  <TableCell
+                    colSpan={5}
+                    className="text-center text-muted-foreground py-8"
+                  >
+                    No robots detected. Start simulation to see data.
+                  </TableCell>
+                </TableRow>
+              )}
+            </TableBody>
+          </Table>
         </div>
-      </main>
-    </div>
+      </div>
+    </DashboardLayout>
   );
 }

apps/frontend/bun.lock

@@ -1,12 +1,21 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "frontend",
       "dependencies": {
+        "@radix-ui/react-avatar": "^1.1.11",
+        "@radix-ui/react-slot": "^1.2.4",
+        "class-variance-authority": "^0.7.1",
+        "clsx": "^2.1.1",
+        "lucide-react": "^0.574.0",
         "next": "16.1.6",
         "react": "19.2.3",
         "react-dom": "19.2.3",
+        "socket.io-client": "^4.8.3",
+        "tailwind-merge": "^3.4.1",
+        "tailwindcss-animate": "^1.0.7",
       },
       "devDependencies": {
         "@tailwindcss/postcss": "^4",
@@ -15,6 +24,7 @@
         "@types/react-dom": "^19",
         "eslint": "^9",
         "eslint-config-next": "16.1.6",
+        "shadcn-ui": "^0.9.5",
         "tailwindcss": "^4",
         "typescript": "^5",
       },
@@ -181,8 +191,26 @@
 
     "@nolyfill/is-core-module": ["@nolyfill/is-core-module@1.0.39", "", {}, "sha512-nn5ozdjYQpUCZlWGuxcJY/KpxkWQs4DcbMCmKojjyrYDEAGy4Ce19NN4v5MduafTwJlbKc99UA8YhSVqq9yPZA=="],
 
+    "@radix-ui/react-avatar": ["@radix-ui/react-avatar@1.1.11", "", { "dependencies": { "@radix-ui/react-context": "1.1.3", "@radix-ui/react-primitive": "2.1.4", "@radix-ui/react-use-callback-ref": "1.1.1", "@radix-ui/react-use-is-hydrated": "0.1.0", "@radix-ui/react-use-layout-effect": "1.1.1" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-0Qk603AHGV28BOBO34p7IgD5m+V5Sg/YovfayABkoDDBM5d3NCx0Mp4gGrjzLGes1jV5eNOE1r3itqOR33VC6Q=="],
+
+    "@radix-ui/react-compose-refs": ["@radix-ui/react-compose-refs@1.1.2", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-z4eqJvfiNnFMHIIvXP3CY57y2WJs5g2v3X0zm9mEJkrkNv4rDxu+sg9Jh8EkXyeqBkB7SOcboo9dMVqhyrACIg=="],
+
+    "@radix-ui/react-context": ["@radix-ui/react-context@1.1.3", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-ieIFACdMpYfMEjF0rEf5KLvfVyIkOz6PDGyNnP+u+4xQ6jny3VCgA4OgXOwNx2aUkxn8zx9fiVcM8CfFYv9Lxw=="],
+
+    "@radix-ui/react-primitive": ["@radix-ui/react-primitive@2.1.4", "", { "dependencies": { "@radix-ui/react-slot": "1.2.4" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-9hQc4+GNVtJAIEPEqlYqW5RiYdrr8ea5XQ0ZOnD6fgru+83kqT15mq2OCcbe8KnjRZl5vF3ks69AKz3kh1jrhg=="],
+
+    "@radix-ui/react-slot": ["@radix-ui/react-slot@1.2.4", "", { "dependencies": { "@radix-ui/react-compose-refs": "1.1.2" }, "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-Jl+bCv8HxKnlTLVrcDE8zTMJ09R9/ukw4qBs/oZClOfoQk/cOTbDn+NceXfV7j09YPVQUryJPHurafcSg6EVKA=="],
+
+    "@radix-ui/react-use-callback-ref": ["@radix-ui/react-use-callback-ref@1.1.1", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-FkBMwD+qbGQeMu1cOHnuGB6x4yzPjho8ap5WtbEJ26umhgqVXbhekKUQO+hZEL1vU92a3wHwdp0HAcqAUF5iDg=="],
+
+    "@radix-ui/react-use-is-hydrated": ["@radix-ui/react-use-is-hydrated@0.1.0", "", { "dependencies": { "use-sync-external-store": "^1.5.0" }, "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-U+UORVEq+cTnRIaostJv9AGdV3G6Y+zbVd+12e18jQ5A3c0xL03IhnHuiU4UV69wolOQp5GfR58NW/EgdQhwOA=="],
+
+    "@radix-ui/react-use-layout-effect": ["@radix-ui/react-use-layout-effect@1.1.1", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-RbJRS4UWQFkzHTTwVymMTUv8EqYhOp8dOOviLj2ugtTiXRaRQS7GLGxZTLL1jWhMeoSCf5zmcZkqTl9IiYfXcQ=="],
+
     "@rtsao/scc": ["@rtsao/scc@1.1.0", "", {}, "sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g=="],
 
+    "@socket.io/component-emitter": ["@socket.io/component-emitter@3.1.2", "", {}, "sha512-9BCxFwvbGg/RsZK9tjXd8s4UcwR0MWeFQ1XEKIQVVvAGJyINdrqKMcTRyLoK8Rse1GjzLV9cwjWV1olXRWEXVA=="],
+
     "@swc/helpers": ["@swc/helpers@0.5.15", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g=="],
 
     "@tailwindcss/node": ["@tailwindcss/node@4.1.18", "", { "dependencies": { "@jridgewell/remapping": "^2.3.4", "enhanced-resolve": "^5.18.3", "jiti": "^2.6.1", "lightningcss": "1.30.2", "magic-string": "^0.30.21", "source-map-js": "^1.2.1", "tailwindcss": "4.1.18" } }, "sha512-DoR7U1P7iYhw16qJ49fgXUlry1t4CpXeErJHnQ44JgTSKMaZUdf17cfn5mHchfJ4KRBZRFA/Coo+MUF5+gOaCQ=="],
@@ -347,8 +375,12 @@
 
     "chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
 
+    "class-variance-authority": ["class-variance-authority@0.7.1", "", { "dependencies": { "clsx": "^2.1.1" } }, "sha512-Ka+9Trutv7G8M6WT6SeiRWz792K5qEqIGEGzXKhAE6xOWAY6pPH8U+9IY3oCMv6kqTmLsv7Xh/2w2RigkePMsg=="],
+
     "client-only": ["client-only@0.0.1", "", {}, "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA=="],
 
+    "clsx": ["clsx@2.1.1", "", {}, "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA=="],
+
     "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
 
     "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
@@ -387,6 +419,10 @@
 
     "emoji-regex": ["emoji-regex@9.2.2", "", {}, "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg=="],
 
+    "engine.io-client": ["engine.io-client@6.6.4", "", { "dependencies": { "@socket.io/component-emitter": "~3.1.0", "debug": "~4.4.1", "engine.io-parser": "~5.2.1", "ws": "~8.18.3", "xmlhttprequest-ssl": "~2.1.1" } }, "sha512-+kjUJnZGwzewFDw951CDWcwj35vMNf2fcj7xQWOctq1F2i1jkDdVvdFG9kM/BEChymCH36KgjnW0NsL58JYRxw=="],
+
+    "engine.io-parser": ["engine.io-parser@5.2.3", "", {}, "sha512-HqD3yTBfnBxIrbnM1DoD6Pcq8NECnh8d4As1Qgh0z5Gg3jRRIqijury0CL3ghu/edArpUYiYqQiDUQBIs4np3Q=="],
+
     "enhanced-resolve": ["enhanced-resolve@5.19.0", "", { "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.3.0" } }, "sha512-phv3E1Xl4tQOShqSte26C7Fl84EwUdZsyOuSSk9qtAGyyQs2s3jJzComh+Abf4g187lUUAvH+H26omrqia2aGg=="],
 
     "es-abstract": ["es-abstract@1.24.1", "", { "dependencies": { "array-buffer-byte-length": "^1.0.2", "arraybuffer.prototype.slice": "^1.0.4", "available-typed-arrays": "^1.0.7", "call-bind": "^1.0.8", "call-bound": "^1.0.4", "data-view-buffer": "^1.0.2", "data-view-byte-length": "^1.0.2", "data-view-byte-offset": "^1.0.1", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "es-set-tostringtag": "^2.1.0", "es-to-primitive": "^1.3.0", "function.prototype.name": "^1.1.8", "get-intrinsic": "^1.3.0", "get-proto": "^1.0.1", "get-symbol-description": "^1.1.0", "globalthis": "^1.0.4", "gopd": "^1.2.0", "has-property-descriptors": "^1.0.2", "has-proto": "^1.2.0", "has-symbols": "^1.1.0", "hasown": "^2.0.2", "internal-slot": "^1.1.0", "is-array-buffer": "^3.0.5", "is-callable": "^1.2.7", "is-data-view": "^1.0.2", "is-negative-zero": "^2.0.3", "is-regex": "^1.2.1", "is-set": "^2.0.3", "is-shared-array-buffer": "^1.0.4", "is-string": "^1.1.1", "is-typed-array": "^1.1.15", "is-weakref": "^1.1.1", "math-intrinsics": "^1.1.0", "object-inspect": "^1.13.4", "object-keys": "^1.1.1", "object.assign": "^4.1.7", "own-keys": "^1.0.1", "regexp.prototype.flags": "^1.5.4", "safe-array-concat": "^1.1.3", "safe-push-apply": "^1.0.0", "safe-regex-test": "^1.1.0", "set-proto": "^1.0.0", "stop-iteration-iterator": "^1.1.0", "string.prototype.trim": "^1.2.10", "string.prototype.trimend": "^1.0.9", "string.prototype.trimstart": "^1.0.8", "typed-array-buffer": "^1.0.3", "typed-array-byte-length": "^1.0.3", "typed-array-byte-offset": "^1.0.4", "typed-array-length": "^1.0.7", "unbox-primitive": "^1.1.0", "which-typed-array": "^1.1.19" } }, "sha512-zHXBLhP+QehSSbsS9Pt23Gg964240DPd6QCf8WpkqEXxQ7fhdZzYsocOr5u7apWonsS5EjZDmTF+/slGMyasvw=="],
@@ -635,6 +671,8 @@
 
     "lru-cache": ["lru-cache@5.1.1", "", { "dependencies": { "yallist": "^3.0.2" } }, "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w=="],
 
+    "lucide-react": ["lucide-react@0.574.0", "", { "peerDependencies": { "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-dJ8xb5juiZVIbdSn3HTyHsjjIwUwZ4FNwV0RtYDScOyySOeie1oXZTymST6YPJ4Qwt3Po8g4quhYl4OxtACiuQ=="],
+
     "magic-string": ["magic-string@0.30.21", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.5" } }, "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ=="],
 
     "math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],
@@ -745,6 +783,8 @@
 
     "set-proto": ["set-proto@1.0.0", "", { "dependencies": { "dunder-proto": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.0.0" } }, "sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw=="],
 
+    "shadcn-ui": ["shadcn-ui@0.9.5", "", { "dependencies": { "chalk": "^5.4.1" }, "bin": { "shadcn-ui": "dist/index.js" } }, "sha512-dsBQWpdLLYCdSdmvOmu53nJhhWnQD1OiblhuhkI4rPYxPKTyfbmZ2NTJHWMu1fXN9PTfN6IVK5vvh+BrjHJx2g=="],
+
     "sharp": ["sharp@0.34.5", "", { "dependencies": { "@img/colour": "^1.0.0", "detect-libc": "^2.1.2", "semver": "^7.7.3" }, "optionalDependencies": { "@img/sharp-darwin-arm64": "0.34.5", "@img/sharp-darwin-x64": "0.34.5", "@img/sharp-libvips-darwin-arm64": "1.2.4", "@img/sharp-libvips-darwin-x64": "1.2.4", "@img/sharp-libvips-linux-arm": "1.2.4", "@img/sharp-libvips-linux-arm64": "1.2.4", "@img/sharp-libvips-linux-ppc64": "1.2.4", "@img/sharp-libvips-linux-riscv64": "1.2.4", "@img/sharp-libvips-linux-s390x": "1.2.4", "@img/sharp-libvips-linux-x64": "1.2.4", "@img/sharp-libvips-linuxmusl-arm64": "1.2.4", "@img/sharp-libvips-linuxmusl-x64": "1.2.4", "@img/sharp-linux-arm": "0.34.5", "@img/sharp-linux-arm64": "0.34.5", "@img/sharp-linux-ppc64": "0.34.5", "@img/sharp-linux-riscv64": "0.34.5", "@img/sharp-linux-s390x": "0.34.5", "@img/sharp-linux-x64": "0.34.5", "@img/sharp-linuxmusl-arm64": "0.34.5", "@img/sharp-linuxmusl-x64": "0.34.5", "@img/sharp-wasm32": "0.34.5", "@img/sharp-win32-arm64": "0.34.5", "@img/sharp-win32-ia32": "0.34.5", "@img/sharp-win32-x64": "0.34.5" } }, "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg=="],
 
     "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
@@ -759,6 +799,10 @@
 
     "side-channel-weakmap": ["side-channel-weakmap@1.0.2", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "get-intrinsic": "^1.2.5", "object-inspect": "^1.13.3", "side-channel-map": "^1.0.1" } }, "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A=="],
 
+    "socket.io-client": ["socket.io-client@4.8.3", "", { "dependencies": { "@socket.io/component-emitter": "~3.1.0", "debug": "~4.4.1", "engine.io-client": "~6.6.1", "socket.io-parser": "~4.2.4" } }, "sha512-uP0bpjWrjQmUt5DTHq9RuoCBdFJF10cdX9X+a368j/Ft0wmaVgxlrjvK3kjvgCODOMMOz9lcaRzxmso0bTWZ/g=="],
+
+    "socket.io-parser": ["socket.io-parser@4.2.5", "", { "dependencies": { "@socket.io/component-emitter": "~3.1.0", "debug": "~4.4.1" } }, "sha512-bPMmpy/5WWKHea5Y/jYAP6k74A+hvmRCQaJuJB6I/ML5JZq/KfNieUVo/3Mh7SAqn7TyFdIo6wqYHInG1MU1bQ=="],
+
     "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
 
     "stable-hash": ["stable-hash@0.0.5", "", {}, "sha512-+L3ccpzibovGXFK+Ap/f8LOS0ahMrHTf3xu7mMLSpEGU0EO9ucaysSylKo9eRDFNhWve/y275iPmIZ4z39a9iA=="],
@@ -787,8 +831,12 @@
 
     "supports-preserve-symlinks-flag": ["supports-preserve-symlinks-flag@1.0.0", "", {}, "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w=="],
 
+    "tailwind-merge": ["tailwind-merge@3.4.1", "", {}, "sha512-2OA0rFqWOkITEAOFWSBSApYkDeH9t2B3XSJuI4YztKBzK3mX0737A2qtxDZ7xkw9Zfh0bWl+r34sF3HXV+Ig7Q=="],
+
     "tailwindcss": ["tailwindcss@4.1.18", "", {}, "sha512-4+Z+0yiYyEtUVCScyfHCxOYP06L5Ne+JiHhY2IjR2KWMIWhJOYZKLSGZaP5HkZ8+bY0cxfzwDE5uOmzFXyIwxw=="],
 
+    "tailwindcss-animate": ["tailwindcss-animate@1.0.7", "", { "peerDependencies": { "tailwindcss": ">=3.0.0 || insiders" } }, "sha512-bl6mpH3T7I3UFxuvDEXLxy/VuFxBk5bbzplh7tXI68mwMokNYd1t9qPBHlnyTwfa4JGC4zP516I1hYYtQ/vspA=="],
+
     "tapable": ["tapable@2.3.0", "", {}, "sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg=="],
 
     "tinyglobby": ["tinyglobby@0.2.15", "", { "dependencies": { "fdir": "^6.5.0", "picomatch": "^4.0.3" } }, "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ=="],
@@ -825,6 +873,8 @@
 
     "uri-js": ["uri-js@4.4.1", "", { "dependencies": { "punycode": "^2.1.0" } }, "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg=="],
 
+    "use-sync-external-store": ["use-sync-external-store@1.6.0", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w=="],
+
     "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
 
     "which-boxed-primitive": ["which-boxed-primitive@1.1.1", "", { "dependencies": { "is-bigint": "^1.1.0", "is-boolean-object": "^1.2.1", "is-number-object": "^1.1.1", "is-string": "^1.1.1", "is-symbol": "^1.1.1" } }, "sha512-TbX3mj8n0odCBFVlY8AxkqcHASw3L60jIuF8jFP78az3C2YhmGvqbHBpAjTRH2/xqYunrJ9g1jSyjCjpoWzIAA=="],
@@ -837,6 +887,10 @@
 
     "word-wrap": ["word-wrap@1.2.5", "", {}, "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA=="],
 
+    "ws": ["ws@8.18.3", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg=="],
+
+    "xmlhttprequest-ssl": ["xmlhttprequest-ssl@2.1.2", "", {}, "sha512-TEU+nJVUUnA4CYJFLvK5X9AOeH4KvDvhIfm0vV1GaQRtchnG0hgK5p8hw/xjv8cunWYCsiPCSDzObPyhEwq3KQ=="],
+
     "yallist": ["yallist@3.1.1", "", {}, "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g=="],
 
     "yocto-queue": ["yocto-queue@0.1.0", "", {}, "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q=="],
@@ -887,6 +941,8 @@
 
     "next/postcss": ["postcss@8.4.31", "", { "dependencies": { "nanoid": "^3.3.6", "picocolors": "^1.0.0", "source-map-js": "^1.0.2" } }, "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ=="],
 
+    "shadcn-ui/chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
     "sharp/semver": ["semver@7.7.4", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA=="],
 
     "@typescript-eslint/typescript-estree/minimatch/brace-expansion": ["brace-expansion@2.0.2", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ=="],

apps/frontend/components.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "tailwind.config.js",
+    "css": "app/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "registries": {}
+}

apps/frontend/components/layout/DashboardLayout.tsx

@@ -0,0 +1,21 @@
+import Sidebar from "./Sidebar";
+
+export default function DashboardLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <div className="flex h-screen w-full bg-[rgb(var(--bg-secondary))] text-[rgb(var(--text-primary))]">
+      {/* Fixed Sidebar */}
+      <aside className="fixed inset-y-0 left-0 z-50 w-64">
+        <Sidebar />
+      </aside>
+
+      {/* Main Content Area */}
+      <main className="pl-64 flex-1 h-full overflow-y-auto">
+        <div className="max-w-7xl mx-auto p-8">{children}</div>
+      </main>
+    </div>
+  );
+}

apps/frontend/components/layout/Sidebar.tsx

@@ -0,0 +1,92 @@
+"use client";
+
+import Link from "next/link";
+
+interface NavItem {
+  id: string;
+  label: string;
+  href: string;
+  icon?: string; // Replace with proper Icon component later
+}
+
+const ROBOT_NAV: NavItem[] = [
+  { id: "robot_1", label: "Robot 1 (AMR)", href: "/robots/robot_1" },
+  { id: "robot_2", label: "Robot 2 (Arm)", href: "/robots/robot_2" },
+];
+
+const MAIN_NAV: NavItem[] = [
+  { id: "overview", label: "Fleet Overview", href: "/" },
+  { id: "ml-vision", label: "ML Vision", href: "/ml-vision" },
+];
+
+export default function Sidebar() {
+  return (
+    <div className="w-64 h-full bg-[rgb(var(--bg-primary))] border-r border-[rgb(var(--border-primary))] flex flex-col">
+      {/* Brand Header */}
+      <div className="p-6 border-b border-[rgb(var(--border-primary))]">
+        <h1 className="text-xl font-bold tracking-tight text-[rgb(var(--text-primary))]">
+          Omniverse
+          <span className="text-[rgb(var(--brand-primary))]">Fleet</span>
+        </h1>
+        <p className="text-xs text-[rgb(var(--text-tertiary))] mt-1">
+          Industrial Control v1.0
+        </p>
+      </div>
+
+      {/* Main Navigation */}
+      <nav className="flex-1 p-4 space-y-6 overflow-y-auto">
+        {/* Section: Platform */}
+        <div>
+          <h2 className="px-4 text-xs font-semibold text-[rgb(var(--text-tertiary))] uppercase tracking-wider mb-2">
+            Platform
+          </h2>
+          <div className="space-y-1">
+            {MAIN_NAV.map((item) => (
+              <Link key={item.id} href={item.href} className="nav-link">
+                {item.label}
+              </Link>
+            ))}
+          </div>
+        </div>
+
+        {/* Section: Robots */}
+        <div>
+          <div className="flex items-center justify-between px-4 mb-2">
+            <h2 className="text-xs font-semibold text-[rgb(var(--text-tertiary))] uppercase tracking-wider">
+              Active Units
+            </h2>
+            <span className="px-2 py-0.5 text-[10px] bg-emerald-100 text-emerald-800 rounded-full font-mono">
+              {ROBOT_NAV.length} ONLINE
+            </span>
+          </div>
+
+          <div className="space-y-1">
+            {ROBOT_NAV.map((robot) => (
+              <Link key={robot.id} href={robot.href} className="nav-link group">
+                <span className="w-2 h-2 rounded-full bg-emerald-500 mr-3 group-hover:animate-pulse"></span>
+                {robot.label}
+              </Link>
+            ))}
+          </div>
+        </div>
+      </nav>
+
+      {/* Footer / User Profile */}
+      <div className="p-4 border-t border-[rgb(var(--border-primary))] bg-[rgb(var(--bg-secondary))]">
+        <div className="flex items-center">
+          <div className="w-8 h-8 rounded-full bg-[rgb(var(--brand-primary))] flex items-center justify-center text-white font-bold">
+            OP
+          </div>
+          <div className="ml-3">
+            <p className="text-sm font-medium text-[rgb(var(--text-primary))]">
+              Operator
+            </p>
+            <p className="text-xs text-[rgb(var(--text-secondary))]">
+              System Admin
+            </p>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

apps/frontend/components/ui/avatar.tsx

@@ -0,0 +1,50 @@
+"use client"
+
+import * as React from "react"
+import * as AvatarPrimitive from "@radix-ui/react-avatar"
+
+import { cn } from "@/lib/utils"
+
+const Avatar = React.forwardRef<
+  React.ElementRef<typeof AvatarPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>
+>(({ className, ...props }, ref) => (
+  <AvatarPrimitive.Root
+    ref={ref}
+    className={cn(
+      "relative flex h-10 w-10 shrink-0 overflow-hidden rounded-full",
+      className
+    )}
+    {...props}
+  />
+))
+Avatar.displayName = AvatarPrimitive.Root.displayName
+
+const AvatarImage = React.forwardRef<
+  React.ElementRef<typeof AvatarPrimitive.Image>,
+  React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Image>
+>(({ className, ...props }, ref) => (
+  <AvatarPrimitive.Image
+    ref={ref}
+    className={cn("aspect-square h-full w-full", className)}
+    {...props}
+  />
+))
+AvatarImage.displayName = AvatarPrimitive.Image.displayName
+
+const AvatarFallback = React.forwardRef<
+  React.ElementRef<typeof AvatarPrimitive.Fallback>,
+  React.ComponentPropsWithoutRef<typeof AvatarPrimitive.Fallback>
+>(({ className, ...props }, ref) => (
+  <AvatarPrimitive.Fallback
+    ref={ref}
+    className={cn(
+      "flex h-full w-full items-center justify-center rounded-full bg-muted",
+      className
+    )}
+    {...props}
+  />
+))
+AvatarFallback.displayName = AvatarPrimitive.Fallback.displayName
+
+export { Avatar, AvatarImage, AvatarFallback }

apps/frontend/components/ui/badge.tsx

@@ -0,0 +1,36 @@
+import * as React from "react"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const badgeVariants = cva(
+  "inline-flex items-center rounded-md border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2",
+  {
+    variants: {
+      variant: {
+        default:
+          "border-transparent bg-primary text-primary-foreground shadow hover:bg-primary/80",
+        secondary:
+          "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        destructive:
+          "border-transparent bg-destructive text-destructive-foreground shadow hover:bg-destructive/80",
+        outline: "text-foreground",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+)
+
+export interface BadgeProps
+  extends React.HTMLAttributes<HTMLDivElement>,
+    VariantProps<typeof badgeVariants> {}
+
+function Badge({ className, variant, ...props }: BadgeProps) {
+  return (
+    <div className={cn(badgeVariants({ variant }), className)} {...props} />
+  )
+}
+
+export { Badge, badgeVariants }

apps/frontend/components/ui/button.tsx

@@ -0,0 +1,57 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground shadow hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90",
+        outline:
+          "border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground",
+        secondary:
+          "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
+        ghost: "hover:bg-accent hover:text-accent-foreground",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2",
+        sm: "h-8 rounded-md px-3 text-xs",
+        lg: "h-10 rounded-md px-8",
+        icon: "h-9 w-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+export interface ButtonProps
+  extends React.ButtonHTMLAttributes<HTMLButtonElement>,
+    VariantProps<typeof buttonVariants> {
+  asChild?: boolean
+}
+
+const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
+  ({ className, variant, size, asChild = false, ...props }, ref) => {
+    const Comp = asChild ? Slot : "button"
+    return (
+      <Comp
+        className={cn(buttonVariants({ variant, size, className }))}
+        ref={ref}
+        {...props}
+      />
+    )
+  }
+)
+Button.displayName = "Button"
+
+export { Button, buttonVariants }

apps/frontend/components/ui/card.tsx

@@ -0,0 +1,76 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+const Card = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "rounded-xl border bg-card text-card-foreground shadow",
+      className
+    )}
+    {...props}
+  />
+))
+Card.displayName = "Card"
+
+const CardHeader = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex flex-col space-y-1.5 p-6", className)}
+    {...props}
+  />
+))
+CardHeader.displayName = "CardHeader"
+
+const CardTitle = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("font-semibold leading-none tracking-tight", className)}
+    {...props}
+  />
+))
+CardTitle.displayName = "CardTitle"
+
+const CardDescription = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+))
+CardDescription.displayName = "CardDescription"
+
+const CardContent = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div ref={ref} className={cn("p-6 pt-0", className)} {...props} />
+))
+CardContent.displayName = "CardContent"
+
+const CardFooter = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("flex items-center p-6 pt-0", className)}
+    {...props}
+  />
+))
+CardFooter.displayName = "CardFooter"
+
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent }

apps/frontend/components/ui/table.tsx

@@ -0,0 +1,120 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+const Table = React.forwardRef<
+  HTMLTableElement,
+  React.HTMLAttributes<HTMLTableElement>
+>(({ className, ...props }, ref) => (
+  <div className="relative w-full overflow-auto">
+    <table
+      ref={ref}
+      className={cn("w-full caption-bottom text-sm", className)}
+      {...props}
+    />
+  </div>
+))
+Table.displayName = "Table"
+
+const TableHeader = React.forwardRef<
+  HTMLTableSectionElement,
+  React.HTMLAttributes<HTMLTableSectionElement>
+>(({ className, ...props }, ref) => (
+  <thead ref={ref} className={cn("[&_tr]:border-b", className)} {...props} />
+))
+TableHeader.displayName = "TableHeader"
+
+const TableBody = React.forwardRef<
+  HTMLTableSectionElement,
+  React.HTMLAttributes<HTMLTableSectionElement>
+>(({ className, ...props }, ref) => (
+  <tbody
+    ref={ref}
+    className={cn("[&_tr:last-child]:border-0", className)}
+    {...props}
+  />
+))
+TableBody.displayName = "TableBody"
+
+const TableFooter = React.forwardRef<
+  HTMLTableSectionElement,
+  React.HTMLAttributes<HTMLTableSectionElement>
+>(({ className, ...props }, ref) => (
+  <tfoot
+    ref={ref}
+    className={cn(
+      "border-t bg-muted/50 font-medium [&>tr]:last:border-b-0",
+      className
+    )}
+    {...props}
+  />
+))
+TableFooter.displayName = "TableFooter"
+
+const TableRow = React.forwardRef<
+  HTMLTableRowElement,
+  React.HTMLAttributes<HTMLTableRowElement>
+>(({ className, ...props }, ref) => (
+  <tr
+    ref={ref}
+    className={cn(
+      "border-b transition-colors hover:bg-muted/50 data-[state=selected]:bg-muted",
+      className
+    )}
+    {...props}
+  />
+))
+TableRow.displayName = "TableRow"
+
+const TableHead = React.forwardRef<
+  HTMLTableCellElement,
+  React.ThHTMLAttributes<HTMLTableCellElement>
+>(({ className, ...props }, ref) => (
+  <th
+    ref={ref}
+    className={cn(
+      "h-10 px-2 text-left align-middle font-medium text-muted-foreground [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px]",
+      className
+    )}
+    {...props}
+  />
+))
+TableHead.displayName = "TableHead"
+
+const TableCell = React.forwardRef<
+  HTMLTableCellElement,
+  React.TdHTMLAttributes<HTMLTableCellElement>
+>(({ className, ...props }, ref) => (
+  <td
+    ref={ref}
+    className={cn(
+      "p-2 align-middle [&:has([role=checkbox])]:pr-0 [&>[role=checkbox]]:translate-y-[2px]",
+      className
+    )}
+    {...props}
+  />
+))
+TableCell.displayName = "TableCell"
+
+const TableCaption = React.forwardRef<
+  HTMLTableCaptionElement,
+  React.HTMLAttributes<HTMLTableCaptionElement>
+>(({ className, ...props }, ref) => (
+  <caption
+    ref={ref}
+    className={cn("mt-4 text-sm text-muted-foreground", className)}
+    {...props}
+  />
+))
+TableCaption.displayName = "TableCaption"
+
+export {
+  Table,
+  TableHeader,
+  TableBody,
+  TableFooter,
+  TableHead,
+  TableRow,
+  TableCell,
+  TableCaption,
+}

apps/frontend/hooks/useFleetTelemetry.ts

@@ -0,0 +1,65 @@
+"use client";
+
+import { useEffect, useState, useRef } from "react";
+import { io, Socket } from "socket.io-client";
+
+// Shared type (Should be in shared-types in production)
+export interface RobotState {
+  id: string;
+  x: number;
+  y: number;
+  theta: number;
+  battery: number;
+  status: "ONLINE" | "OFFLINE";
+  lastSeen: number;
+}
+
+const SOCKET_URL = "http://localhost:4000";
+
+export function useFleetTelemetry() {
+  const [robots, setRobots] = useState<Map<string, RobotState>>(new Map());
+  const socketRef = useRef<Socket | null>(null);
+  const [isConnected, setIsConnected] = useState(false);
+
+  useEffect(() => {
+    // 1. Initialize Socket
+    const socket = io(SOCKET_URL, {
+      transports: ["websocket"],
+      reconnectionAttempts: 5,
+    });
+    socketRef.current = socket;
+
+    // 2. Connection Handlers
+    socket.on("connect", () => {
+      console.log("[Frontend] Connected to Telemetry Gateway");
+      setIsConnected(true);
+    });
+
+    socket.on("disconnect", () => {
+      console.log("[Frontend] Disconnected");
+      setIsConnected(false);
+    });
+
+    // 3. Telemetry Listener
+    socket.on("telemetry", (data: any) => {
+      setRobots((prev) => {
+        const next = new Map(prev);
+        next.set(data.id, {
+          ...data,
+          status: "ONLINE",
+          lastSeen: Date.now(),
+        });
+        return next;
+      });
+    });
+
+    return () => {
+      socket.disconnect();
+    };
+  }, []);
+
+  return {
+    robots: Array.from(robots.values()),
+    isConnected,
+  };
+}

apps/frontend/package.json

@@ -9,9 +9,17 @@
     "lint": "eslint"
   },
   "dependencies": {
+    "@radix-ui/react-avatar": "^1.1.11",
+    "@radix-ui/react-slot": "^1.2.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.574.0",
     "next": "16.1.6",
     "react": "19.2.3",
-    "react-dom": "19.2.3"
+    "react-dom": "19.2.3",
+    "socket.io-client": "^4.8.3",
+    "tailwind-merge": "^3.4.1",
+    "tailwindcss-animate": "^1.0.7"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",
@@ -20,6 +28,7 @@
     "@types/react-dom": "^19",
     "eslint": "^9",
     "eslint-config-next": "16.1.6",
+    "shadcn-ui": "^0.9.5",
     "tailwindcss": "^4",
     "typescript": "^5"
   },

apps/frontend/tailwind.config.js

@@ -0,0 +1,19 @@
+module.exports = {
+  content: [
+    "./pages/**/*.{js,ts,jsx,tsx,mdx}",
+    "./components/**/*.{js,ts,jsx,tsx,mdx}",
+    "./app/**/*.{js,ts,jsx,tsx,mdx}",
+  ],
+  theme: {
+    extend: {
+      colors: {
+        // We use CSS variables for easy theming
+      },
+      fontFamily: {
+        sans: ["var(--font-sans)"],
+        mono: ["var(--font-mono)"],
+      },
+    },
+  },
+  plugins: [],
+};

docs/planning/RFC-001-vertical-architecture.md

@@ -0,0 +1,33 @@
+# Architectural Start: Vertical Feature Slicing Strategy
+
+## 1. The Core Philosophy
+
+We do **not** build layers (all DB, then all API). We build **Vertical Features**.
+A vertical feature is a self-contained slice of functionality that cuts through the Frontend, Backend, ML, and Robotics layers.
+
+## 2. Decoupling Strategy
+
+### Frontend (`apps/frontend`)
+
+- **Structure**: `components/features/[feature_name]` (e.g., `components/features/telemetry`, `components/features/map`).
+- **Rule**: A component should be isolated. It imports its own data hooks.
+- **Robot Isolation**: Use dynamic routing `/robots/[id]/dashboard`. Components take `robotId` as a prop.
+
+### Backend (`apps/backend`)
+
+- **Structure**: `src/modules/[module_name]` (e.g., `src/modules/fleet`, `src/modules/auth`).
+- **Rule**: A module contains its own Service, Controller, and DTOs. Modules communicate via Event Bus or Public Interface.
+
+### ROS 2 (`robotics/ros2_ws`)
+
+- **Structure**: Feature-based packages (e.g., `navigation_stack`, `vision_pipeline`).
+- **Rule**: Use standard interfaces. Do not depend on proprietary backend logic.
+
+## 3. Workflow
+
+1.  **Plan**: Write `docs/planning/RFC-001-[feature].md`.
+2.  **Define Contracts**: Update `packages/shared-types`.
+3.  **Implement Robot Loop**: Add ROS node/topic.
+4.  **Implement Backend Bridge**: Update Node.js module.
+5.  **Implement Frontend UI**: Add React component.
+6.  **Report**: Write `docs/reports/2026-02-17-feature-complete.md`.

docs/planning/RFC-002-telemetry-streaming.md

@@ -0,0 +1,62 @@
+# RFC-002: Real-Time Telemetry Streaming
+
+## 1. Problem Statement
+
+We need a foundational pipeline to visualize the state of `N` robots in real-time on the web dashboard.
+The latency must be low (< 50ms) and the architecture must support scaling to multiple robots without code changes.
+
+## 2. Technical Architecture (Vertical Slice)
+
+### A. Shared Contract (`packages/shared-types`)
+
+We need a strict interface for the "Heartbeat" of every robot.
+
+```typescript
+export interface RobotState {
+  id: string; // "robot_1"
+  status: "IDLE" | "MOVING" | "ERROR";
+  battery: number; // 0-100
+  pose: {
+    x: number;
+    y: number;
+    theta: number; // Orientation in radians
+  };
+  lastUpdate: number; // Timestamp
+}
+```
+
+### B. Robotics Layer (`robotics/ros2_ws`)
+
+- **Package**: `simulation_manager`
+- **Node**: `mock_robot_node`
+- **Behavior**: Publishes standard ROS messages.
+  - `/robot_1/odom` (nav_msgs/Odometry)
+  - `/robot_1/battery` (sensor_msgs/BatteryState) -> _Simulated sine wave for now._
+
+### C. Backend Layer (`apps/backend`)
+
+- **Module**: `modules/telemetry`
+- **Technology**: `rclnodejs` + `Socket.io`
+- **Logic**:
+  1.  Discover active robots (via ROS 2 discovery).
+  2.  Subscribe to `/[namespace]/odom`.
+  3.  Throttle data to 60Hz.
+  4.  Emit to WebSocket Room: `room:robot_1`.
+
+### D. Frontend Layer (`apps/frontend`)
+
+- **Component**: `components/dashboard/TelemetryCard.tsx`
+- **Hook**: `useRobotTelemetry(robotId: string)`
+- **Behavior**: Connects to the backend websocket, joins the specific robot room, and updates local state.
+
+## 3. Implementation Plan
+
+1.  **Phase 1 (Types)**: Define `RobotState` in shared package.
+2.  **Phase 2 (ROS)**: Create `mock_robot.py` in ROS workspace to generate fake data.
+3.  **Phase 3 (Backend)**: Set up `rclnodejs` and basic Socket.io gateway.
+4.  **Phase 4 (Frontend)**: Build the React component to display `x, y, theta`.
+
+## 4. Risks & Mitigations
+
+- **Risk**: High frequency Odom (100Hz) flooding the websocket.
+- **Mitigation**: Backend **MUST** throttle/downsample to 30Hz or 60Hz before sending to UI.

robotics/ros2_ws/src/simulation_manager/src/mock_robot.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+
+import rclpy
+from rclpy.node import Node
+from nav_msgs.msg import Odometry
+from sensor_msgs.msg import BatteryState
+from geometry_msgs.msg import PoseWithCovarianceStamped
+import math
+import random
+
+class MockRobot(Node):
+
+    def __init__(self):
+        super().__init__('mock_robot')
+        
+        # Declare parameters (namespace is handled by launch file, but we can have local ID)
+        self.declare_parameter('robot_id', 'robot_1')
+        self.robot_id = self.get_parameter('robot_id').get_parameter_value().string_value
+        
+        # Publishers
+        self.odom_pub = self.create_publisher(Odometry, 'odom', 10)
+        self.battery_pub = self.create_publisher(BatteryState, 'battery', 10)
+        
+        # Simulation State
+        self.x = 0.0
+        self.y = 0.0
+        self.theta = 0.0
+        self.battery = 100.0
+        self.battery_drain_rate = 0.05  # % per second
+        
+        # Timer (10Hz simulation loop)
+        self.create_timer(0.1, self.timer_callback)
+        
+        self.get_logger().info(f'Mock Robot "{self.robot_id}" Started. Simulating movement.')
+
+    def timer_callback(self):
+        # 1. Physics Update (Circular Motion)
+        t = self.get_clock().now().nanoseconds / 1e9
+        radius = 5.0
+        speed = 0.5
+        
+        self.x = radius * math.cos(speed * t)
+        self.y = radius * math.sin(speed * t)
+        
+        # Calculate theta (tangent to circle)
+        self.theta = (speed * t) + (math.pi / 2)
+        
+        # 2. Battery Update
+        self.battery -= (self.battery_drain_rate * 0.1)
+        if self.battery < 0:
+            self.battery = 100.0 # Charge!
+            
+        # 3. Publish Odometry
+        odom_msg = Odometry()
+        odom_msg.header.stamp = self.get_clock().now().to_msg()
+        odom_msg.header.frame_id = "map"
+        odom_msg.child_frame_id = f"{self.robot_id}_base_link"
+        
+        odom_msg.pose.pose.position.x = self.x
+        odom_msg.pose.pose.position.y = self.y
+        odom_msg.pose.pose.position.z = 0.0
+        
+        # Simple Euler to Quaternion (Z-axis rotation only)
+        odom_msg.pose.pose.orientation.z = math.sin(self.theta / 2.0)
+        odom_msg.pose.pose.orientation.w = math.cos(self.theta / 2.0)
+        
+        self.odom_pub.publish(odom_msg)
+        
+        # 4. Publish Battery
+        bat_msg = BatteryState()
+        bat_msg.percentage = self.battery
+        bat_msg.voltage = 24.0
+        bat_msg.current = 2.5
+        bat_msg.charge = self.battery # Using charge field for simplicity
+        
+        self.battery_pub.publish(bat_msg)
+
+def main(args=None):
+    rclpy.init(args=args)
+    node = MockRobot()
+    try:
+        rclpy.spin(node)
+    except KeyboardInterrupt:
+        pass
+    finally:
+        node.destroy_node()
+        rclpy.shutdown()
+
+if __name__ == '__main__':
+    main()

scripts/dev-all.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+
+# Configuration
+SESSION_NAME="robot_stack"
+WSL_PROJECT_PATH="/mnt/c/Omniverse/Projects/ros2-robot-stack" # Or ~/projects/ros2-robot-stack if you moved it
+
+# Function to kill child processes on exit
+trap "kill 0" EXIT
+
+echo "Launching Robotics Stack..."
+
+# 1. Start ROS 2 Mock Robot
+echo "[1/3] Starting ROS 2 Simulation..."
+(
+    source /opt/ros/humble/setup.bash
+    cd $WSL_PROJECT_PATH/robotics/ros2_ws
+    # Build first to be safe
+    colcon build --packages-select simulation_manager
+    source install/setup.bash
+    # Run Node
+    python3 src/simulation_manager/src/mock_robot.py
+) &
+
+# 2. Start Backend
+echo "[2/3] Starting Backend..."
+(
+    cd $WSL_PROJECT_PATH/apps/backend
+    bun run dev
+) &
+
+# 3. Start Frontend
+echo "[3/3] Starting Frontend..."
+(
+    cd $WSL_PROJECT_PATH/apps/frontend
+    bun run dev
+) &
+
+# Wait for user input to exit
+echo "✅ All systems go! Open http://localhost:3000"
+echo "Press CTRL+C to stop everything."
+wait

system-index.json

@@ -0,0 +1,30 @@
+{
+  "project_name": "ros2-robot-stack",
+  "environment": {
+    "host_os": "Windows",
+    "execution_runtime": "WSL 2 / Docker",
+    "notes": "Code lives on Windows FS, executes in Linux Subsystem."
+  },
+  "services": {
+    "frontend": {
+      "path": "apps/frontend",
+      "runtime": "Node (WSL)",
+      "port": 3000
+    },
+    "backend": {
+      "path": "apps/backend",
+      "runtime": "Node (WSL)",
+      "port": 4000
+    },
+    "ml-service": {
+      "path": "apps/ml-service",
+      "runtime": "Python (WSL)",
+      "port": 8000
+    },
+    "ros2_ws": {
+      "path": "robotics/ros2_ws",
+      "runtime": "ROS 2 Humble (WSL)",
+      "display": "Wayland/X11 (WSLg)"
+    }
+  }
+}