- Industrial dark theme with #76B900 NVIDIA green accents - Real-time telemetry from Kubernetes API - Create Sandbox button and workflow - Destroy Sandbox mode with destructive confirmation overlay - Sidebar fetches pod data directly from /api/telemetry/real - Fixed TypeError with defensive array checks - Technical typography, sharp corners, data-dense panels - Status indicators: GREEN RUNNING, red DESTROY mode
6.2 KiB
NemoClaw Dashboard Build Plan
CONTRACT_VERSION: v1
PLAN
Phase 1: Telemetry Data Integration
Objective: Fetch real telemetry from OpenShell and expose it through API endpoints Exit Criteria: API endpoints return real CPU, GPU, Disk, and Network data
Phase 2: UI Component Architecture
Objective: Build modular, reusable UI components with dark/light mode Exit Criteria: Components render correctly with proper styling and NVIDIA color scheme
Phase 3: Telemetry Display
Objective: Implement speedometer-style gauges with selectable telemetry targets Exit Criteria: Gauges show real data, sandboxes can be selected, combined telemetry works
Phase 4: Dashboard Integration
Objective: Add "OpenClaw Gateway Dashboard" button and finalize layout Exit Criteria: Button opens OpenClaw dashboard in new window, layout is responsive
TASKS
Phase 1: Telemetry Data Integration
Task 1.1: Fetch OpenShell Kubernetes Data
- Owner: Builder
- Dependency: None
- Timeout: 120s
- Command:
/Applications/Docker.app/Contents/Resources/bin/docker exec openshell-cluster-openshell kubectl get pods --all-namespaces -o json - Acceptance Test: JSON response with pod data returned
Task 1.2: Create Telemetry API Route
- Owner: Builder
- Dependency: Task 1.1
- Timeout: 120s
- Command:
/Applications/Docker.app/Contents/Resources/bin/docker exec openshell-cluster-openshell kubectl get pods --all-namespaces -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.podIP}{"\n"}{end}' > /tmp/openshell-pods.json - Acceptance Test: JSON file created with pod names and IPs
Task 1.3: Expose Telemetry via API
- Owner: Builder
- Dependency: Task 1.2
- Timeout: 120s
- Command:
/Applications/Docker.app/Contents/Resources/bin/docker exec openshell-cluster-openshell kubectl top pods --all-namespaces -o json - Acceptance Test: Real CPU/memory metrics returned
Phase 2: UI Component Architecture
Task 2.1: Build Dark/Light Mode Component
- Owner: Builder
- Dependency: None
- Timeout: 120s
- Command:
/Applications/Docker.app/Contents/Resources/bin/docker exec openshell-cluster-openshell kubectl get configmaps -n openshell -o yaml > /tmp/openshell-configmaps.yaml - Acceptance Test: Config maps fetched successfully
Task 2.2: Create NVIDIA Styling
- Owner: Builder
- Dependency: Task 2.1
- Timeout: 120s
- Command: Update
/Users/markmckeen/nemo-shell-dashboard/app/globals.csswith:@media (prefers-color-scheme: dark) { :root { --bg-color: #0a0a0a; --text-color: #76B900; --card-bg: #1a1a1a; } } @media (prefers-color-scheme: light) { :root { --bg-color: #f0f0f0; --text-color: #0D47A1; --card-bg: #ffffff; } } - Acceptance Test: CSS classes render correctly in both modes
Task 2.3: Build Speedometer Gauge Component
- Owner: Builder
- Dependency: Task 2.2
- Timeout: 120s
- Command: Create
/Users/markmckeen/nemo-shell-dashboard/app/components/SpeedometerGauge.tsxwith SVG-based gauges - Acceptance Test: Gauge renders with correct color and scale
Phase 3: Telemetry Display
Task 3.1: Build Sandbox List Component
- Owner: Builder
- Dependency: Task 2.3
- Timeout: 120s
- Command: Create
/Users/markmckeen/nemo-shell-dashboard/app/components/SandboxList.tsxwith click handlers - Acceptance Test: List renders with sandbox names and IPs
Task 3.2: Implement Combined Telemetry
- Owner: Builder
- Dependency: Task 3.1
- Timeout: 120s
- Command: Create
/Users/markmckeen/nemo-shell-dashboard/app/api/telemetry/combined/route.ts - Acceptance Test: Returns average metrics from all sandboxes
Task 3.3: Add Speedometer Gauges for Each Metric
- Owner: Builder
- Dependency: Task 3.2
- Timeout: 120s
- Command: Create gauge components for CPU, GPU, Disk, Network
- Acceptance Test: Gauges show real data with text labels
Phase 4: Dashboard Integration
Task 4.1: Add "OpenClaw Gateway Dashboard" Button
- Owner: Builder
- Dependency: Task 3.3
- Timeout: 120s
- Command: Create
/Users/markmckeen/nemo-shell-dashboard/app/components/OpenClawButton.tsxwithtarget="_blank"andhref="http://localhost:18789" - Acceptance Test: Button opens OpenClaw dashboard in new window
Task 4.2: Final Layout and Responsiveness
- Owner: Builder
- Dependency: Task 4.1
- Timeout: 120s
- Command: Update
/Users/markmckeen/nemo-shell-dashboard/app/page.tsxwith new layout - Acceptance Test: Layout is responsive and displays all components
RISKS
Risk 1: Kubernetes API Not Accessible
- Trigger:
kubectlcommand fails in Docker container - Impact: Cannot fetch telemetry data
- Mitigation: Use mock data fallback, explore alternative data sources
Risk 2: GPU Metrics Not Available
- Trigger:
kubectl top podsdoes not return GPU metrics - Impact: GPU gauge shows incorrect data
- Mitigation: Use CPU/memory data as fallback, add GPU-aware monitoring
Risk 3: Dark Mode CSS Not Applying
- Trigger: Media queries not working
- Impact: User sees wrong color scheme
- Mitigation: Add explicit theme toggles, test in both modes
FAILURE TAXONOMY
CLASS: DEPENDENCY_BLOCKED
- Detection Signal:
kubectlcommand fails - Response: Check Docker container status, verify kubectl is installed
CLASS: SCOPE_DRIFT
- Detection Signal: User requests additional features mid-implementation
- Response: Confirm with user, re-plan if needed
CLASS: VALIDATION_GAP
- Detection Signal: Cannot verify telemetry data is real
- Response: Add mock data fallback, verify against known values
NEXT ACTION
Build Phase 1, Task 1.1: Fetch OpenShell Kubernetes Data
Command to run:
/Applications/Docker.app/Contents/Resources/bin/docker exec openshell-cluster-openshell kubectl get pods --all-namespaces -o json
Owner: Builder Timeout: 120s Acceptance Test: JSON response with pod data returned
This plan is based on the Planner skill contract v1. All tasks are designed to be completed in one execution cycle with explicit verification criteria.