From 47df68d1de3b97e518fcffc5903f59d632c09fcf Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Thu, 3 Sep 2026 00:06:35 +1000 Subject: [PATCH] Refactor dashboard module to use Preact components --- ui/src/dashboard/dashboard.js | 451 ----------------- ui/src/dashboard/dashboard.jsx | 473 ++++++++++++++++++ ...tup-preference.js => setup-preference.jsx} | 0 .../{task-targets.js => task-targets.jsx} | 0 4 files changed, 473 insertions(+), 451 deletions(-) delete mode 100644 ui/src/dashboard/dashboard.js create mode 100644 ui/src/dashboard/dashboard.jsx rename ui/src/dashboard/{setup-preference.js => setup-preference.jsx} (100%) rename ui/src/dashboard/{task-targets.js => task-targets.jsx} (100%) diff --git a/ui/src/dashboard/dashboard.js b/ui/src/dashboard/dashboard.js deleted file mode 100644 index 17de1c04a..000000000 --- a/ui/src/dashboard/dashboard.js +++ /dev/null @@ -1,451 +0,0 @@ -import "./dashboard.css"; -import { api, subscribeEvents } from "../base/api.js"; -import { ago, compact, el, empty, mount, pill, statusKind } from "../base/dom.js"; -import { statTile } from "../base/statTile.js"; -import { gauge, segmentBar } from "../base/gauge.js"; -import { icon } from "../base/icons.js"; -import { dismissSetupComplete, setupPanelState } from "./setup-preference.js"; -import { dashboardTaskTargets } from "./task-targets.js"; - -/** - * The control room. Answers, in order: is anything wrong, what is Archie doing - * right now, and what have I not finished setting up. - * - * Every panel degrades to an explanatory empty state rather than a blank box, - * because a fresh install has no tasks and a dashboard of zeroes teaches - * nobody anything. - */ -export function dashboardPage() { - const root = el("div"); - const runs = el("tbody"); - const statsRow = el("div.grid.grid-4"); - const setupSlot = el("div"); - const pulseSlot = el("div"); - const topRow = el("div.dash-top", setupSlot, pulseSlot); - const forecastSlot = el("div"); - const actions = el("div.hero-actions-inner"); - const title = el("h1.hero-title", greeting()); - const streamState = pill("connecting", "idle"); - const activity = []; - const taskIDsBySource = new Map(); - - render(); - load(); - - const unsubscribe = subscribeEvents( - (event) => { - activity.unshift(event); - activity.splice(50); - renderActivity(); - }, - (state) => { - const kind = state === "live" ? "ok" : "warn"; - streamState.className = `pill pill-${kind}`; - streamState.textContent = state; - }, - ); - root.addEventListener("archie:teardown", unsubscribe); - - function render() { - mount( - root, - el( - "div.hero", - el( - "div", - title, - el( - "p.hero-sub", - "Your agent's control room \u2014 what it is working on, what needs you, and what it is spending.", - ), - ), - el("div.hero-actions", actions), - ), - el( - "div.dash-section", - el("div.dash-section-head", el("h2.dash-section-title", "Health")), - topRow, - ), - el( - "div.dash-section", - el( - "div.dash-section-head", - el("h2.dash-section-title", "Throughput"), - el("span.dash-section-note", "Across all repositories"), - ), - statsRow, - ), - el( - "div.dash-section", - el( - "div.dash-section-head", - el("h2.dash-section-title", "Right now"), - ), - el( - "div.dash-split", - forecastSlot, - el( - "div.card", - el( - "div.card-head", - el("div", el("h2.card-title", "Live activity"), el("p.card-sub", "Last 50, newest first")), - streamState, - ), - el( - "div.table-scroll", - el( - "table.table", - el("thead", el("tr", ...["Event", "Task", "Detail", "When"].map((h) => el("th", h)))), - runs, - ), - ), - ), - ), - ), - ); - renderActivity(); - } - - function renderActivity() { - if (!activity.length) { - mount(runs, el("tr", el("td", { colspan: 4 }, empty("Waiting for activity", "Events appear here as Archie works.")))); - return; - } - mount(runs, ...activity.map((event) => activityRow(event, taskIDsBySource))); - } - - async function load() { - try { - const [summary, setup, workflows, tasks] = await Promise.all([ - api.summary(), - api.setup().catch(() => null), - api.workflows().catch(() => null), - api.tasks().catch(() => []), - ]); - taskIDsBySource.clear(); - for (const task of tasks) { - if (task.owner && task.repo && task.issue_number) { - taskIDsBySource.set(`${task.owner}/${task.repo}#${task.issue_number}`, task.id); - } - } - renderActivity(); - renderActions(tasks); - // The greeting is only personalised when the deployment says who it - // assists; an unconfigured instance greets without a name rather than - // inventing one. - title.textContent = setup?.operator ? `${greeting()}, ${setup.operator}` : greeting(); - renderStats(summary); - renderSetup(setup); - renderPulse(summary, workflows); - renderForecast(summary); - } catch (err) { - mount(statsRow, el("div.card", empty("Cannot reach archied", String(err.message || err)))); - // The hero actions are only rendered on success, so a failed first load - // must offer its own retry rather than leaving the operator without a - // recovery path. - mount( - actions, - el("button.btn.btn-primary", { onclick: load }, icon("refresh", { size: 15 }), "Retry"), - ); - } - } - - // Actions follow state: what needs you comes first, and the generic ones - // only fill the space when nothing does. A row of buttons that is identical - // whatever is happening teaches nobody anything. - function renderActions(tasks) { - const targets = dashboardTaskTargets(tasks); - const blocked = targets.attention.count; - const running = targets.running.count; - - mount( - actions, - blocked > 0 && - el( - "a.btn.btn-attention", - { href: targets.attention.href }, - icon("tasks", { size: 15 }), - `${blocked} need${blocked === 1 ? "s" : ""} you`, - ), - running > 0 && - el("a.btn", { href: targets.running.href }, icon("workflows", { size: 15 }), `${running} running`), - el("a.btn", { href: "#/logs" }, icon("logs", { size: 15 }), "Logs"), - el("button.btn.btn-primary", { onclick: load }, icon("refresh", { size: 15 }), "Refresh"), - ); - } - - function renderStats(summary) { - const counts = summary?.statuses || {}; - const done = (counts.merged || 0) + (counts.pr_open || 0); - const attention = (counts.parked || 0) + (counts.waiting_human || 0); - const total = Object.values(counts).reduce((a, b) => a + b, 0); - const tokens = summary?.tokens_by_day || []; - - mount( - statsRow, - statTile({ - label: "Working now", - value: counts.running || 0, - compare: `${counts.queued || 0} waiting to start`, - series: tokens.map((d) => d.tokens || 0), - }), - statTile({ - label: "Needs you", - value: attention, - compare: attention ? "Parked or awaiting a reply" : "Nothing is blocked", - goodDirection: "down", - }), - statTile({ - label: "Delivered", - value: done, - compare: total ? `${Math.round((done / total) * 100)}% of all tasks` : "No tasks yet", - }), - statTile({ - label: "Tokens used", - value: compact(tokens.reduce((a, d) => a + (d.tokens || 0), 0)), - compare: `Across ${tokens.length || 0} days`, - trend: trendPct(tokens.map((d) => d.tokens || 0)), - goodDirection: "down", - series: tokens.map((d) => d.tokens || 0), - }), - ); - } - - function renderSetup(setup) { - // Unknown setup (endpoint unreachable) or no checklist configured: omit - // the panel and let the gate pulse take the full row, so the Health row - // never shows an empty half beside the pulse. - const state = setupPanelState(setup); - const omit = state.kind === "omit" || state.kind === "dismissed"; - topRow.classList.toggle("dash-top-standalone", omit); - if (omit) return mount(setupSlot); - const remaining = state.remaining; - if (remaining.length) { - const pct = Math.round(((setup.steps.length - remaining.length) / setup.steps.length) * 100); - mount( - setupSlot, - el( - "div.card.setup", - el( - "div.card-head", - el( - "div", - el("h2.card-title", "Finish setting up"), - el("p.card-sub", "Archie needs these before it can work on its own."), - ), - el("span.setup-pct", `${pct}%`), - ), - el("div.setup-bar", el("div.setup-bar-fill", { style: `width:${pct}%` })), - el("ul.setup-list", ...setup.steps.map(setupStep)), - ), - ); - return; - } - // Every step done: show completion so the row beside the gate pulse is - // not an empty hole on an otherwise healthy dashboard. - mount( - setupSlot, - el( - "div.card.setup.setup-done", - el( - "div.card-head", - el( - "div", - el("h2.card-title", "Setup complete"), - el("p.card-sub", "Archie is configured and ready to work."), - ), - el( - "div.setup-complete-actions", - el("span.setup-pct", icon("check", { size: 16 })), - el( - "button.icon-btn.setup-dismiss", - { - type: "button", - title: "Dismiss setup complete", - "aria-label": "Dismiss setup complete", - onclick: () => { - dismissSetupComplete(); - renderSetup(setup); - }, - }, - "×", - ), - ), - ), - ), - ); - } - - function renderPulse(summary, workflows) { - renderPulseInto(pulseSlot, summary, workflows); - } - - function renderForecast(summary) { - renderForecastInto(forecastSlot, summary); - } - - function setupStep(step) { - return el( - `li.setup-step${step.done ? ".done" : ""}`, - el("span.setup-check", step.done ? icon("check", { size: 12 }) : ""), - el("div", el("div.setup-step-title", step.title), step.detail && el("div.setup-step-detail", step.detail)), - ); - } - - return root; -} - -function activityRow(event, taskIDsBySource) { - const taskID = taskIDForEvent(event, taskIDsBySource); - const hasTask = taskID > 0; - const openTask = () => { - if (hasTask) location.hash = `#/tasks?task=${encodeURIComponent(taskID)}`; - }; - const row = el( - `tr${hasTask ? ".activity-row" : ""}`, - hasTask - ? { - role: "link", - tabindex: "0", - title: "Open task details", - onclick: openTask, - onkeydown: (e) => { - if (e.key === "Enter" || e.key === " ") { - e.preventDefault(); - openTask(); - } - }, - } - : undefined, - el("td.strong", el("span", event.kind || event.type || "event")), - el("td.mono", hasTask ? `#${taskID}` : "—"), - el("td", event.detail || event.message || ""), - el("td", ago(event.at || Date.now())), - ); - return row; -} - -function taskIDForEvent(event, taskIDsBySource) { - if (Number(event.task_id) > 0) return Number(event.task_id); - if (!event.repo || !event.issue) return 0; - return Number(taskIDsBySource.get(`${event.repo}#${event.issue}`)) || 0; -} - -function greeting() { - const h = new Date().getHours(); - if (h < 5) return "Still up?"; - if (h < 12) return "Good morning"; - if (h < 18) return "Good afternoon"; - return "Good evening"; -} - - -/** - * Gate pulse: the share of finished work that got through the quality gates. - * - * This is the dashboard's headline health number -- Archie's whole promise is - * that it does not open a PR until the gates pass, so a falling pass rate is - * the first thing worth seeing. - */ -function renderPulseInto(slot, summary, workflows) { - const stats = workflows?.workflows || []; - const runs = stats.reduce((a, w) => a + (w.runs || 0), 0); - const merged = stats.reduce((a, w) => a + (w.merged || 0) + (w.pr_open || 0), 0); - const parked = stats.reduce((a, w) => a + (w.parked || 0), 0); - - if (!runs) { - mount( - slot, - el( - "div.card", - el("div.card-head", el("h2.card-title", "Gate pulse")), - empty("No completed runs yet", "Once Archie finishes a task, its gate pass rate appears here."), - ), - ); - return; - } - - const pct = (merged / runs) * 100; - mount( - slot, - el( - "div.card", - el( - "div.card-head", - el( - "div", - el("h2.card-title", "Gate pulse"), - el("p.card-sub", "Work that passed its quality gates"), - ), - ), - gauge({ value: pct, label: "pass rate" }), - el( - "ul.pulse-list", - ...stats.slice(0, 3).map((w) => - el( - "li.pulse-item", - el("span.pulse-name", w.workflow || "workflow"), - pill( - `${w.merged || 0}/${w.runs || 0}`, - (w.merged || 0) === (w.runs || 0) ? "ok" : (w.parked || 0) > 0 ? "warn" : "info", - ), - ), - ), - parked > 0 && - el("li.pulse-item", el("span.pulse-name", "Parked, awaiting you"), pill(String(parked), "warn")), - ), - ), - ); -} - -/** - * Budget outlook: what this month's token spend is tracking toward, and how - * much of the configured budget it accounts for. - */ -function renderForecastInto(slot, summary) { - const days = summary?.tokens_by_day || []; - const used = days.reduce((a, d) => a + (d.tokens || 0), 0); - - if (!days.length) { - mount( - slot, - el( - "div.card", - el("div.card-head", el("h2.card-title", "Token outlook")), - empty("Nothing spent yet", "Usage appears here once Archie runs its first task."), - ), - ); - return; - } - - const perDay = used / days.length; - const projected = Math.round(perDay * 30); - const recent = days.slice(-7).reduce((a, d) => a + (d.tokens || 0), 0); - - mount( - slot, - el( - "div.card", - el( - "div.card-head", - el("div", el("h2.card-title", "Token outlook"), el("p.card-sub", "Next 30 days at the current rate")), - ), - el("div.forecast-value", compact(projected)), - el("div.forecast-note", `Based on ${compact(Math.round(perDay))} per day over ${days.length} days`), - segmentBar([ - { label: `Last 7 days (${compact(recent)})`, value: recent, kind: "info" }, - { label: `Earlier (${compact(used - recent)})`, value: Math.max(used - recent, 0), kind: "idle" }, - ]), - ), - ); -} - -/** Percentage change between the first and second half of a series. */ -function trendPct(series) { - if (series.length < 4) return null; - const mid = Math.floor(series.length / 2); - const older = series.slice(0, mid).reduce((a, b) => a + b, 0); - const newer = series.slice(mid).reduce((a, b) => a + b, 0); - if (!older) return null; - return ((newer - older) / older) * 100; -} diff --git a/ui/src/dashboard/dashboard.jsx b/ui/src/dashboard/dashboard.jsx new file mode 100644 index 000000000..cdfd2cc8f --- /dev/null +++ b/ui/src/dashboard/dashboard.jsx @@ -0,0 +1,473 @@ +import { h, Fragment } from "preact"; +import { useState, useEffect, useRef } from "preact/hooks"; +import "./dashboard.css"; +import { api, subscribeEvents } from "../base/api.jsx"; +import { ago, compact, statusKind } from "../base/dom.jsx"; +import { statTile } from "../base/statTile.jsx"; +import { gauge, segmentBar } from "../base/gauge.jsx"; +import { icon } from "../base/icons.jsx"; +import { dismissSetupComplete, setupPanelState } from "./setup-preference.jsx"; +import { dashboardTaskTargets } from "./task-targets.jsx"; + +// Preact wrapper for base DOM components that still use `el()` +function DOMWrap({ node }) { + const ref = useRef(); + useEffect(() => { + if (ref.current && node) { + ref.current.replaceChildren(node); + } + }, [node]); + return
; +} + +function StatTile(props) { + return ; +} + +function Gauge(props) { + return ; +} + +function SegmentBar({ segments }) { + return ; +} + +function Icon({ name, opts }) { + return ; +} + +function Empty({ title, detail }) { + return ( +
+
{title}
+ {detail &&
{detail}
} +
+ ); +} + +function Pill({ text, kind = "idle" }) { + return {text}; +} + +function taskIDForEvent(event, taskIDsBySource) { + if (Number(event.task_id) > 0) return Number(event.task_id); + if (!event.repo || !event.issue) return 0; + return Number(taskIDsBySource.get(`${event.repo}#${event.issue}`)) || 0; +} + +function greeting() { + const h = new Date().getHours(); + if (h < 5) return "Still up?"; + if (h < 12) return "Good morning"; + if (h < 18) return "Good afternoon"; + return "Good evening"; +} + +function trendPct(series) { + if (series.length < 4) return null; + const mid = Math.floor(series.length / 2); + const older = series.slice(0, mid).reduce((a, b) => a + b, 0); + const newer = series.slice(mid).reduce((a, b) => a + b, 0); + if (!older) return null; + return ((newer - older) / older) * 100; +} + +function DashboardApp() { + const [activity, setActivity] = useState([]); + const [streamStateText, setStreamStateText] = useState("connecting"); + const [streamStateKind, setStreamStateKind] = useState("idle"); + const [taskIDsBySource, setTaskIDsBySource] = useState(new Map()); + + const [summary, setSummary] = useState(null); + const [setup, setSetup] = useState(null); + const [workflows, setWorkflows] = useState(null); + const [tasks, setTasks] = useState(null); // null means loading, [] means loaded + const [error, setError] = useState(null); + // force a re-render when setup is dismissed + const [, setSetupDismissed] = useState(false); + + const load = async () => { + setError(null); + try { + const [_summary, _setup, _workflows, _tasks] = await Promise.all([ + api.summary(), + api.setup().catch(() => null), + api.workflows().catch(() => null), + api.tasks().catch(() => []), + ]); + const map = new Map(); + for (const task of _tasks) { + if (task.owner && task.repo && task.issue_number) { + map.set(`${task.owner}/${task.repo}#${task.issue_number}`, task.id); + } + } + setTaskIDsBySource(map); + setSummary(_summary); + setSetup(_setup); + setWorkflows(_workflows); + setTasks(_tasks); + } catch (err) { + setError(String(err.message || err)); + } + }; + + useEffect(() => { + load(); + const unsubscribe = subscribeEvents( + (event) => { + setActivity((prev) => { + const next = [event, ...prev]; + next.splice(50); + return next; + }); + }, + (state) => { + setStreamStateText(state); + setStreamStateKind(state === "live" ? "ok" : "warn"); + } + ); + return unsubscribe; + }, []); + + const handleDismissSetup = () => { + dismissSetupComplete(); + setSetupDismissed(s => !s); // force re-eval of setupState + }; + + const currentGreeting = setup?.operator ? `${greeting()}, ${setup.operator}` : greeting(); + + // ACTIONS + let actions = null; + if (error) { + actions = ( + + ); + } else if (tasks !== null) { + const targets = dashboardTaskTargets(tasks); + const blocked = targets.attention.count; + const running = targets.running.count; + actions = ( + + {blocked > 0 && ( + + {blocked} need{blocked === 1 ? "s" : ""} you + + )} + {running > 0 && ( + + {running} running + + )} + + Logs + + + + ); + } + + // STATS + let statsRow = null; + if (error) { + statsRow = ( +
+ +
+ ); + } else if (summary) { + const counts = summary?.statuses || {}; + const done = (counts.merged || 0) + (counts.pr_open || 0); + const attention = (counts.parked || 0) + (counts.waiting_human || 0); + const total = Object.values(counts).reduce((a, b) => a + b, 0); + const tokens = summary?.tokens_by_day || []; + + statsRow = ( + + d.tokens || 0)} + /> + + + a + (d.tokens || 0), 0))} + compare={`Across ${tokens.length || 0} days`} + trend={trendPct(tokens.map((d) => d.tokens || 0))} + goodDirection="down" + series={tokens.map((d) => d.tokens || 0)} + /> + + ); + } + + // SETUP + let setupSlot = null; + const state = setupPanelState(setup); + const omit = state.kind === "omit" || state.kind === "dismissed"; + + if (!omit) { + const remaining = state.remaining; + if (remaining.length) { + const pct = Math.round(((setup.steps.length - remaining.length) / setup.steps.length) * 100); + setupSlot = ( +
+
+
+

Finish setting up

+

Archie needs these before it can work on its own.

+
+ {pct}% +
+
+
+
+
    + {setup.steps.map((step, i) => ( +
  • + {step.done ? : ""} +
    +
    {step.title}
    + {step.detail &&
    {step.detail}
    } +
    +
  • + ))} +
+
+ ); + } else { + setupSlot = ( +
+
+
+

Setup complete

+

Archie is configured and ready to work.

+
+
+ + +
+
+
+ ); + } + } + + // PULSE + let pulseSlot = null; + if (summary) { + const wStats = workflows?.workflows || []; + const runs = wStats.reduce((a, w) => a + (w.runs || 0), 0); + const merged = wStats.reduce((a, w) => a + (w.merged || 0) + (w.pr_open || 0), 0); + const parked = wStats.reduce((a, w) => a + (w.parked || 0), 0); + + if (!runs) { + pulseSlot = ( +
+

Gate pulse

+ +
+ ); + } else { + const pct = (merged / runs) * 100; + pulseSlot = ( +
+
+
+

Gate pulse

+

Work that passed its quality gates

+
+
+ +
    + {wStats.slice(0, 3).map((w, i) => ( +
  • + {w.workflow || "workflow"} + 0 ? "warn" : "info"} + /> +
  • + ))} + {parked > 0 && ( +
  • + Parked, awaiting you + +
  • + )} +
+
+ ); + } + } + + // FORECAST + let forecastSlot = null; + if (summary) { + const days = summary?.tokens_by_day || []; + const used = days.reduce((a, d) => a + (d.tokens || 0), 0); + + if (!days.length) { + forecastSlot = ( +
+

Token outlook

+ +
+ ); + } else { + const perDay = used / days.length; + const projected = Math.round(perDay * 30); + const recent = days.slice(-7).reduce((a, d) => a + (d.tokens || 0), 0); + + forecastSlot = ( +
+
+
+

Token outlook

+

Next 30 days at the current rate

+
+
+
{compact(projected)}
+
Based on {compact(Math.round(perDay))} per day over {days.length} days
+ +
+ ); + } + } + + return ( + +
+
+

{currentGreeting}

+

+ Your agent's control room — what it is working on, what needs you, and what it is spending. +

+
+
+
{actions}
+
+
+ +
+
+

Health

+
+
+
{setupSlot}
+
{pulseSlot}
+
+
+ +
+
+

Throughput

+ Across all repositories +
+
{statsRow}
+
+ +
+
+

Right now

+
+
+
{forecastSlot}
+
+
+
+

Live activity

+

Last 50, newest first

+
+ +
+
+ + + + + + + + + + + {!activity.length ? ( + + + + ) : ( + activity.map((event, i) => { + const taskID = taskIDForEvent(event, taskIDsBySource); + const hasTask = taskID > 0; + const openTask = () => { + if (hasTask) location.hash = `#/tasks?task=${encodeURIComponent(taskID)}`; + }; + return ( + { + if (e.key === "Enter" || e.key === " ") { + e.preventDefault(); + openTask(); + } + } : undefined} + > + + + + + + ); + }) + )} + +
EventTaskDetailWhen
+ +
+ {event.kind || event.type || "event"} + {hasTask ? `#${taskID}` : "—"}{event.detail || event.message || ""}{ago(event.at || Date.now())}
+
+
+
+
+
+ ); +} + +export function dashboardPage() { + return ; +} diff --git a/ui/src/dashboard/setup-preference.js b/ui/src/dashboard/setup-preference.jsx similarity index 100% rename from ui/src/dashboard/setup-preference.js rename to ui/src/dashboard/setup-preference.jsx diff --git a/ui/src/dashboard/task-targets.js b/ui/src/dashboard/task-targets.jsx similarity index 100% rename from ui/src/dashboard/task-targets.js rename to ui/src/dashboard/task-targets.jsx