evor-dashboard

evor-dashboard starts the FastAPI dashboard server for the active Evor mission. The dashboard provides a live D3 tree visualization of the evolution DAG, Chart.js telemetry curves for each node, and a real-time frontier table. It streams live data from the active run via SSE, requiring no separate database.

<Use_When>

• User says "dashboard", "show dashboard", "open dashboard", or invokes /evor-dashboard
• During a running mission to monitor progress in real time
• After a completed mission to browse the evolution tree before generating a report </Use_When>

<Do_Not_Use_When>

• User wants a static final report — use evor-report
• No active run exists (.evor/active-run.json absent) — redirect to /evor-setup </Do_Not_Use_When>

Step 1 — Resolve Run Directory

Call evor_state_read to get run_dir from the active run. If a run-id argument was provided, call evor_state_read with the provided run-id to get run_dir.

If no active run is found: print "No active run found. Start a mission with /evor-setup first." and stop.

Step 2 — Check for Running Server

lsof -i :8756 2>/dev/null | grep LISTEN

If a server is already listening on port 8756: print "Dashboard already running at http://localhost:8756 (run-id: <run_id>)" and open the browser (Step 4). Do not start a second server.

Step 3 — Start Dashboard Server

Launch the server in the background. Call evor_state_read to get the log path from the active run state, then:

EVOR_RUN_DIR=<run_dir> uvicorn evor.dashboard.server:app \
  --host 0.0.0.0 \
  --port 8756 \
  --reload \
  --reload-dir <run_dir> \
  2><log_path> &

Wait up to 5 seconds for the server to become ready:

for i in 1 2 3 4 5; do
  curl -s http://localhost:8756/health && break
  sleep 1
done

If health check fails after 5 attempts: print "Dashboard failed to start. Check the server log for details." and stop.

Step 4 — Open Browser

Attempt to open the dashboard in the default browser:

xdg-open http://localhost:8756 2>/dev/null || open http://localhost:8756 2>/dev/null || true

Print:

Dashboard running at: http://localhost:8756
Run ID: <run_id>
Mission: <mission_id>

Available views:
  /          — Evolution tree (D3 DAG, frontier highlighted)
  /telemetry — Live training curves (Chart.js, SSE stream)
  /frontier  — Frontier table (best-so-far nodes)
  /health    — Server health check

Press Ctrl+C or run /evor-dashboard --stop to shut down.

Step 5 — Stop (optional, via --stop argument)

If the user passes --stop as an argument:

pkill -f "uvicorn evor.dashboard.server:app"

Print: "Dashboard server stopped."

<Tool_Usage>

• evor_state_read — read active-run.json to resolve run_dir
• Bash — lsof, uvicorn background launch, curl health check, xdg-open/open </Tool_Usage>