@sleep2agi/agent-network-dashboard 0.4.6-preview.21 → 0.4.6-preview.210

package/app/components/utils.ts

@@ -11,14 +11,15 @@ export function previewContent(raw: string | null | undefined): string {
     .trim() || '--';
 }
 
+// Round 44 / Loop: timeAgo now delegates to the shared lib/time helper.
+// The old in-line `replace + 'Z'` parse appended a Z to already-ISO
+// inputs (producing "…ZZ", browser-fragile) — strict-superset semantics
+// preserved for SQL-style inputs, fixed for ISO. Plus a 'just now' fallback
+// when clock skew puts the timestamp in the future. Five callers benefit:
+// /admin · /logs · /settings/networks · InboxPanel · /messages.
+import { relativeAgo } from '../lib/time';
 export function timeAgo(dateStr: string): string {
-  if (!dateStr) return '--';
-  const diff = Date.now() - new Date(dateStr.replace(' ', 'T') + 'Z').getTime();
-  const s = Math.floor(diff / 1000);
-  if (s < 60) return `${s}s ago`;
-  if (s < 3600) return `${Math.floor(s / 60)}m ago`;
-  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
-  return `${Math.floor(s / 86400)}d ago`;
+  return relativeAgo(dateStr) ?? '--';
 }
 
 export function statusColor(status: string, hasSse: boolean): string {

package/app/globals.css

@@ -828,6 +828,41 @@ body {
 }
 .anet-fade-in { animation: anet-fade-in 0.15s ease-out; }
 
+/* Round 184 — chrome reset button click-spin. The reset button's
+   onClick triggers R168 smoothView crossfade on the canvas, but the
+   BUTTON itself had no visual feedback that the click registered. A
+   single 360° rotation on the refresh-arrow icon (450ms ease-out) is
+   a quick "yes, I heard you" confirmation. Counter-clockwise (-360°)
+   reads as "rewind" / "undo" — natural for a reset gesture. Mirror
+   to R52's hub click ripple at the chrome scope. */
+@keyframes anet-reset-spin {
+  from { transform: rotate(0deg);     }
+  to   { transform: rotate(-360deg); }
+}
+.anet-reset-spin {
+  animation: anet-reset-spin 0.45s cubic-bezier(0.4, 0, 0.2, 1);
+  transform-origin: center;
+  transform-box: fill-box;
+}
+
+/* Round 186 — chrome zoom-in / zoom-out buttons get a brief icon pop
+   on click. Same click-feel idiom R184 added for the reset button —
+   the canvas already smoothes via R168/R169 smoothView, but the
+   chrome BUTTON itself needs its own confirmation. A quick scale
+   up-then-back (1 → 1.18 → 1 over 220ms) reads as "tapped". Same
+   transform-box: fill-box anchoring as R184 keeps the icon
+   centered in place. */
+@keyframes anet-chrome-pop {
+  0%   { transform: scale(1);    }
+  50%  { transform: scale(1.18); }
+  100% { transform: scale(1);    }
+}
+.anet-chrome-pop {
+  animation: anet-chrome-pop 0.22s ease-out;
+  transform-origin: center;
+  transform-box: fill-box;
+}
+
 /* Round 36 — current-step ring pulse on TaskDrawer timeline. Halo gently
    breathes around the active step's dot so users can spot "task is here". */
 @keyframes anet-current-step-pulse-kf {
@@ -840,24 +875,93 @@ body {
 
 /* Round 45 — TopoGraph rotating radar sweep wedge. 6s slow rotation
    gives the topology canvas a real "radar scan" feel without distracting
-   from the agent nodes. */
+   from the agent nodes.
+   R146: split shorthand into longhand so per-render inline style can
+   override animation-duration via --sweep-dur, joining the R145
+   --spoke-dur / R132 --march-dur pattern. Default 6s preserves R45's
+   original cadence for any caller that forgets the var. */
 @keyframes anet-topo-sweep-kf {
   0%   { transform: rotate(0deg); }
   100% { transform: rotate(360deg); }
 }
 .anet-topo-sweep {
-  animation: anet-topo-sweep-kf 6s linear infinite;
+  animation-name: anet-topo-sweep-kf;
+  animation-duration: var(--sweep-dur, 6s);
+  animation-timing-function: linear;
+  animation-iteration-count: infinite;
+}
+
+/* R155 — focus-visible outline for TopoGraph chip-row interactives.
+   Cyber theme's dark canvas often swallows the browser default focus
+   ring; R154 fixed it for chrome buttons via Tailwind's focus-visible:
+   ring (box-shadow). Chip-row chips reuse `box-shadow` for the R88 /
+   R139 / R140 pin-mirror inset — so a focus box-shadow would conflict
+   with the pinned-state shadow. `outline` is a separate CSS property
+   and doesn't fight box-shadow, so we use it here. `currentColor`
+   inherits the chip's own accent (green for working, cyan for online,
+   per-vendor for letters, etc.). Only fires on :focus-visible
+   (keyboard) — mouse focus stays unstyled. */
+.anet-topo-chip-focus:focus-visible {
+  outline: 2px solid currentColor;
+  outline-offset: 1px;
+}
+
+/* R156 — focus-visible outline for SVG-side TopoGraph interactives.
+   Same idiom as R155's chip-row class but for SVG <g> elements
+   (recent-signal rows, legend rows, group labels, edge badges,
+   node bodies, "+N more" footer). Each <g> already has role=
+   "button"/"link" + tabIndex=0 + onKeyDown (R116/R121/R133/R143/
+   R144/R151/R152). Browser default focus outline on SVG is hard
+   to spot against the canvas; explicit cyan-300 ring matches the
+   dashboard's legendAccent. 2-px outline-offset gives breathing
+   room around the painted bounding box. */
+.anet-topo-svg-focus:focus-visible {
+  outline: 2px solid #67e8f9;
+  outline-offset: 2px;
 }
 
 /* Round 46 — animated dashed spokes flowing from hub outward. Each spoke
    gets a small animationDelay (set inline) so the dashes don't all flow
-   in sync — reads as "command relay" pulse rather than a metronome. */
+   in sync — reads as "command relay" pulse rather than a metronome.
+   R145: split shorthand into longhand so per-render inline style can
+   override animation-duration via the --spoke-dur custom property —
+   same idiom R132 uses for --march-dur on group boxes. Default 2.4s
+   when --spoke-dur isn't set, so any future caller that forgets the
+   var keeps R46's original cadence. */
 @keyframes anet-topo-spoke-flow-kf {
   from { stroke-dashoffset: 0;   }
   to   { stroke-dashoffset: -40; }
 }
 .anet-topo-spoke-flow {
-  animation: anet-topo-spoke-flow-kf 2.4s linear infinite;
+  animation-name: anet-topo-spoke-flow-kf;
+  animation-duration: var(--spoke-dur, 2.4s);
+  animation-timing-function: linear;
+  animation-iteration-count: infinite;
+}
+
+/* Round 85 — group-box "marching ants" perimeter drift.
+   Applied to a grid-layout group box whose `statuses.working > 0`
+   AND that is neither hovered nor pinned (those treatments already
+   carry their own visual emphasis via solid stroke). Slow 12s
+   linear cycle reads as ambient motion, not animation — the eye
+   parses "this group has live work" without registering the box
+   as moving. R86 stride matches the box's `strokeDasharray="6 6"`
+   so a single full cycle returns to a frame-identical state.
+   prefers-reduced-motion handled by the blanket override below.
+   R132: split shorthand into longhand so per-group inline style can
+   override animation-duration via the --march-dur custom property
+   without re-declaring keyframe + timing + iteration count. Default
+   stays at 12s when --march-dur isn't set, so existing single-group
+   call sites keep their cadence. */
+@keyframes anet-topo-groupbox-march-kf {
+  from { stroke-dashoffset: 0;   }
+  to   { stroke-dashoffset: -12; }
+}
+.anet-topo-groupbox-live {
+  animation-name: anet-topo-groupbox-march-kf;
+  animation-duration: var(--march-dur, 12s);
+  animation-timing-function: linear;
+  animation-iteration-count: infinite;
 }
 
 /* ─────────────────────────────────────────────────────────────────────
@@ -894,7 +998,8 @@ body {
   .anet-fade-in,
   .anet-current-step-pulse,
   .anet-topo-sweep,
-  .anet-topo-spoke-flow {
+  .anet-topo-spoke-flow,
+  .anet-topo-groupbox-live {
     animation: none !important;
   }
   /* Tasks row grid 0fr↔1fr keep working (it's the toggle mechanism),

package/app/lib/time.ts

@@ -0,0 +1,36 @@
+/** Shared timestamp helpers for hub-sourced data.
+ *
+ *  Background — the CommHub serialises timestamps SQL-style without a
+ *  zone ("2026-05-15 06:00:28"), but some test data uses full ISO
+ *  ("…T06:00:28Z"). `Date.parse` on bare SQL is **local-time** in every
+ *  browser the dashboard supports, so a UTC+8 operator silently sees
+ *  every timestamp 8 h older than reality (Round 35 dug this out via
+ *  the `isGhost` filter mis-fire).
+ *
+ *  Round 38 / Loop consolidates parsing — TopoGraph (R35), ChatPopover
+ *  (R37) and utils.ts::timeAgo all mirrored the same SQL→UTC rewrite;
+ *  one source of truth here. */
+
+/** Parse a hub timestamp to ms-since-epoch, treating SQL-style strings
+ *  as UTC. ISO strings (with `T`) bypass the rewrite and are parsed as-is.
+ *  Returns null for empty / unparseable input. */
+export function parseHubTime(dateStr: string | null | undefined): number | null {
+  if (!dateStr) return null;
+  const iso = dateStr.includes('T') ? dateStr : dateStr.replace(' ', 'T') + 'Z';
+  const t = Date.parse(iso);
+  return Number.isFinite(t) ? t : null;
+}
+
+/** Format `dateStr` as a short relative-time string ("6m ago" / "2h ago").
+ *  Future timestamps (clock skew) collapse to "just now". Returns null when
+ *  the input doesn't parse — callers can decide on a fallback. */
+export function relativeAgo(dateStr: string | null | undefined): string | null {
+  const t = parseHubTime(dateStr);
+  if (t === null) return null;
+  const s = Math.floor((Date.now() - t) / 1000);
+  if (s < 0) return 'just now';
+  if (s < 60) return `${s}s ago`;
+  if (s < 3600) return `${Math.floor(s / 60)}m ago`;
+  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+  return `${Math.floor(s / 86400)}d ago`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleep2agi/agent-network-dashboard",
-  "version": "0.4.6-preview.21",
+  "version": "0.4.6-preview.210",
   "description": "Agent Network Dashboard — Web UI for managing AI Agent networks",
   "scripts": {
     "dev": "next dev",

package/scripts/help-overlay-topo-test.mjs

@@ -0,0 +1,44 @@
+/* Round 25 verification: pressing `?` opens the help overlay, and the
+ * new "Topology canvas" section is present with the documented keys. */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const browser = await chromium.launch({ headless: true });
+const ctx = await browser.newContext({ viewport: { width: 1280, height: 900 } });
+await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+await ctx.addInitScript(() => {
+  try { sessionStorage.setItem('anet_v3_auth', '1'); } catch {}
+});
+await ctx.route('**/api/hub/status*', (route) => route.fulfill({ json: { sessions: [] } }));
+await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+const page = await ctx.newPage();
+await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+await page.waitForTimeout(400);
+
+await page.keyboard.press('?');
+await page.waitForTimeout(200);
+
+// The overlay contains group headings; find the Topology canvas group + its rows.
+const data = await page.evaluate(() => {
+  // The group heading is a <div>; its parent wraps heading + the <ul> of items.
+  const heading = [...document.querySelectorAll('[role="dialog"] div')].find(el => el.textContent === 'Topology canvas');
+  if (!heading) return null;
+  return {
+    headingPresent: true,
+    sectionText: (heading.parentElement?.textContent || '').replace(/\s+/g, ' ').trim(),
+  };
+});
+
+await browser.close();
+const results = {
+  overlayOpened: !!data,
+  topologySectionPresent: !!data?.headingPresent,
+  hasZoomKeys: !!data && /Zoom in/.test(data.sectionText) && /Zoom out/.test(data.sectionText) && /Reset zoom/.test(data.sectionText),
+  hasMouseGestures: !!data && /wheel/.test(data.sectionText) && /Pan the canvas/.test(data.sectionText),
+  hasClickHint: !!data && /chat popover/.test(data.sectionText) && /dbl-click/.test(data.sectionText),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay topology section:`, JSON.stringify(results));
+if (!ok && data) console.log('section text:', data.sectionText.slice(0, 300));
+process.exit(ok ? 0 : 1);

package/scripts/servers-drawer-live-test.mjs

@@ -0,0 +1,96 @@
+/* Round 20 / #119 step 3: ServersDrawer now consumes /api/hub/servers via
+ * useSWR. Verifies:
+ *   1. drawer renders live cards from the proxied endpoint (3 hosts)
+ *   2. polling fires (refreshInterval 5s) — second snapshot reflects an
+ *      updated payload after >5.2s
+ *   3. when the hub predates 0.8.1-preview.2 the proxy returns
+ *      `{ servers: [], unavailable: true }` and the drawer shows the
+ *      friendly upgrade hint instead of an angry empty state
+ *   4. hub-down (502) shows the retry chip */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const browser = await chromium.launch({ headless: true });
+
+async function load({ payload, status = 200 }) {
+  const ctx = await browser.newContext({ viewport: { width: 1400, height: 900 } });
+  await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+  await ctx.addInitScript(() => {
+    try {
+      localStorage.setItem('anet-theme', 'cyber');
+      localStorage.setItem('anet-servers-drawer', '1'); // start expanded so SWR fires
+      sessionStorage.setItem('anet_v3_auth', '1');
+    } catch {}
+  });
+  let calls = 0;
+  await ctx.route('**/api/hub/servers', async (route) => {
+    calls++;
+    const body = typeof payload === 'function' ? payload(calls) : payload;
+    await route.fulfill({ status, contentType: 'application/json', body: JSON.stringify(body) });
+  });
+  // keep the rest of the dashboard quiet
+  await ctx.route('**/api/hub/status*', (route) => route.fulfill({ json: { sessions: [] } }));
+  await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+  const page = await ctx.newPage();
+  await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+  await page.waitForSelector('aside[aria-label="Servers panel"]', { timeout: 30000 });
+  return { ctx, page, getCalls: () => calls };
+}
+
+const results = {};
+
+// 1+2: live cards + polling
+{
+  const seed = (n) => ({
+    servers: [
+      { hostname: 'srv-01', ip: '10.0.0.1', cpu_load_1min: 1.2, cpu_cores: 4, mem_used_gb: 3, mem_total_gb: 16, agent_count: n, status: 'online' },
+      { hostname: 'srv-02', cpu_load_1min: 0.4, cpu_cores: 8, mem_used_gb: 6, mem_total_gb: 32, agent_count: 2, status: 'online' },
+      { hostname: 'srv-03', cpu_load_1min: null, cpu_cores: 0, mem_used_gb: null, mem_total_gb: null, agent_count: 1, status: 'offline' },
+    ],
+  });
+  const { ctx, page, getCalls } = await load({ payload: seed });
+  await page.waitForFunction(() => {
+    const cards = document.querySelectorAll('aside[aria-label="Servers panel"] [data-servers-body] > div[title]');
+    return cards.length >= 3;
+  }, { timeout: 10000 });
+  const hostnames = await page.$$eval(
+    'aside[aria-label="Servers panel"] [data-servers-body] span.font-semibold',
+    els => els.map(e => e.textContent),
+  );
+  results.rendersLiveCards = hostnames.includes('srv-01') && hostnames.includes('srv-02') && hostnames.includes('srv-03');
+
+  // wait past one poll cycle (5s + slack) and confirm the proxy was hit again
+  await page.waitForTimeout(5400);
+  results.polls = getCalls() >= 2;
+  await ctx.close();
+}
+
+// 3: hub predates 0.8.1-preview.2 → unavailable hint
+{
+  const { ctx, page } = await load({ payload: { servers: [], unavailable: true } });
+  await page.waitForFunction(() => {
+    const el = document.querySelector('aside[aria-label="Servers panel"] [data-servers-body]');
+    return el && el.textContent.includes('host telemetry not available');
+  }, { timeout: 10000 }).catch(() => {});
+  const body = await page.$eval('aside[aria-label="Servers panel"] [data-servers-body]', el => el.textContent);
+  results.showsUpgradeHint = /host telemetry not available/.test(body) && /commhub-server/.test(body);
+  await ctx.close();
+}
+
+// 4: hub-down 502 → retry chip
+{
+  const { ctx, page } = await load({ payload: { error: 'hub unreachable' }, status: 502 });
+  await page.waitForFunction(() => {
+    const el = document.querySelector('aside[aria-label="Servers panel"] [data-servers-body]');
+    return el && /hub unreachable/.test(el.textContent || '');
+  }, { timeout: 10000 }).catch(() => {});
+  const body = await page.$eval('aside[aria-label="Servers panel"] [data-servers-body]', el => el.textContent);
+  results.showsRetryChip = /hub unreachable/.test(body) && /every 5s/.test(body);
+  await ctx.close();
+}
+
+await browser.close();
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} servers drawer live:`, JSON.stringify(results));
+process.exit(ok ? 0 : 1);

package/scripts/topo-active-filter-pill-test.mjs

@@ -0,0 +1,101 @@
+/* Round 64 verification: active-filter pills appear in chip row when
+ * pins are set and clear their pin on × click.
+ *
+ *  - No pin → no pill rendered.
+ *  - Pin status (via legend) → pill labelled "filter: working" with
+ *    aria-label that includes "Clear working filter".
+ *  - × button click → pin clears + node opacities restore.
+ *  - Both pins independent: pin a status + pin a group → two pills.
+ */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const browser = await chromium.launch({ headless: true });
+
+const ctx = await browser.newContext({ viewport: { width: 1400, height: 1500 } });
+await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+await ctx.addInitScript(() => {
+  try {
+    localStorage.setItem('anet-theme', 'cyber');
+    localStorage.setItem('anet-topo-layout', 'grid');
+    sessionStorage.setItem('anet_v3_auth', '1');
+  } catch {}
+});
+
+const fresh = new Date(Date.now() - 60 * 1000).toISOString();
+await ctx.route('**/api/hub/status*', async (route) => {
+  const r = await route.fetch();
+  const b = await r.json();
+  const nid = (b.sessions || [])[0]?.network_id || 'default';
+  const sessions = [
+    { alias: 'alpha1', status: 'working', network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'alpha2', status: 'idle',    network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'alpha3', status: 'idle',    network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'beta',   status: 'idle',    network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+  ];
+  await route.fulfill({ response: r, json: { ...b, sessions } });
+});
+await ctx.route('**/api/hub/messages*', (route) => route.fulfill({ json: { messages: [] } }));
+await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+const page = await ctx.newPage();
+await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+await page.waitForFunction(() => document.querySelectorAll('g[data-node]').length === 4, { timeout: 30000 });
+await page.waitForTimeout(500);
+
+const readPills = () => page.evaluate(() => {
+  return [...document.querySelectorAll('[data-active-filter]')].map(el => ({
+    kind: el.getAttribute('data-active-filter'),
+    text: (el.textContent || '').trim(),
+  }));
+});
+const readWkrOpacity = () => page.evaluate(() => +(document.querySelector('g[data-node="alpha1"]')?.style.opacity || '1'));
+
+const pillsBefore = await readPills();
+
+// Pin working via legend.
+await page.locator('g[data-legend-status="working"]').first().click({ force: true });
+await page.mouse.move(10, 10);
+await page.waitForTimeout(250);
+const pillsAfterStatus = await readPills();
+const wkrAfterStatus = await readWkrOpacity();
+
+// Pin alpha group via label click.
+await page.locator('g[data-group-label-hit="alpha"]').first().click({ force: true });
+await page.mouse.move(10, 10);
+await page.waitForTimeout(250);
+const pillsBothPinned = await readPills();
+
+// Click × on the status pill.
+await page.locator('[data-active-filter="status"] button[aria-label*="working"]').first().click({ force: true });
+await page.waitForTimeout(250);
+const pillsAfterStatusClear = await readPills();
+const wkrAfterStatusClear = await readWkrOpacity();
+
+// Click × on the group pill.
+await page.locator('[data-active-filter="group"] button[aria-label*="alpha"]').first().click({ force: true });
+await page.waitForTimeout(250);
+const pillsFinal = await readPills();
+
+await browser.close();
+
+const results = {
+  before_noPills:        pillsBefore.length === 0,
+  statusPin_oneStatusPill: pillsAfterStatus.length === 1
+                          && pillsAfterStatus[0].kind === 'status'
+                          && /filter:\s*working/.test(pillsAfterStatus[0].text),
+  statusPin_dimsBeta:     wkrAfterStatus >= 0.55,   // alpha1 IS working — should stay
+  bothPinned_twoPills:    pillsBothPinned.length === 2
+                          && pillsBothPinned.some(p => p.kind === 'status')
+                          && pillsBothPinned.some(p => p.kind === 'group'),
+  statusClear_only_group_remains: pillsAfterStatusClear.length === 1
+                                  && pillsAfterStatusClear[0].kind === 'group',
+  statusClear_restoredOpacity: wkrAfterStatusClear >= 0.55,
+  groupClear_noPills:     pillsFinal.length === 0,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} active-filter pill:`, JSON.stringify(results),
+  `\n  pillsAfterStatus=`, pillsAfterStatus,
+  `\n  pillsBothPinned=`, pillsBothPinned,
+  `\n  pillsAfterStatusClear=`, pillsAfterStatusClear);
+process.exit(ok ? 0 : 1);

package/scripts/topo-active-links-chip-hover-test.mjs

@@ -0,0 +1,103 @@
+/* Round 77 verification: hovering the "N active links" header chip
+ * boosts every flow edge to 1.5× the baseline opacity simultaneously.
+ * Mouseleave restores. Composes with R49 / R50 — single-edge hover
+ * still wins over chip hover (the priority is edge > node > chip).
+ *
+ *  - 3 flow edges; baseline opacity ~0.28 each.
+ *  - Hover the active-links chip → all 3 jump to ~0.42 (1.5×).
+ *  - Mouse-leave → all 3 return to ~0.28.
+ *  - Hover an individual edge while chip is also hovered → R50 wins,
+ *    edge gets 2.0×, others drop to 0.35×.  (We just check chip-hover
+ *    here; the interaction with edge hover is documented in R50 tests.)
+ */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const browser = await chromium.launch({ headless: true });
+
+const ctx = await browser.newContext({ viewport: { width: 1400, height: 1500 } });
+await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+await ctx.addInitScript(() => {
+  try {
+    localStorage.setItem('anet-theme', 'cyber');
+    localStorage.setItem('anet-topo-layout', 'ring');
+    sessionStorage.setItem('anet_v3_auth', '1');
+    sessionStorage.removeItem('anet-topo-pinned-status');
+    sessionStorage.removeItem('anet-topo-pinned-group');
+  } catch {}
+});
+
+const fresh = new Date(Date.now() - 60 * 1000).toISOString();
+await ctx.route('**/api/hub/status*', async (route) => {
+  const r = await route.fetch();
+  const b = await r.json();
+  const nid = (b.sessions || [])[0]?.network_id || 'default';
+  const sessions = ['alpha', 'beta', 'gamma', 'delta', 'epsilon', 'zeta'].map(a => ({
+    alias: a, status: 'idle', network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  }));
+  await route.fulfill({ response: r, json: { ...b, sessions } });
+});
+const now = new Date().toISOString();
+await ctx.route('**/api/hub/messages*', (route) => route.fulfill({ json: { messages: [
+  { from_alias: 'alpha',   to_alias: 'beta',  content: 'm', created_at: now },
+  { from_alias: 'gamma',   to_alias: 'delta', content: 'm', created_at: now },
+  { from_alias: 'epsilon', to_alias: 'zeta',  content: 'm', created_at: now },
+] } }));
+await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+const page = await ctx.newPage();
+await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+await page.waitForFunction(() => document.querySelectorAll('g[data-node]').length === 6, { timeout: 30000 });
+await page.waitForTimeout(600);
+
+const readEdgeOpacities = () => page.evaluate(() => {
+  const out = {};
+  const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+  for (const g of svg.querySelectorAll(':scope > g > g')) {
+    const t = g.querySelector('path[data-edge-hitbox] title');
+    if (!t) continue;
+    const route = (t.textContent || '').split('\n')[0];
+    const base = [...g.querySelectorAll(':scope > path')].find(
+      p => !p.hasAttribute('data-edge-hitbox') && p.hasAttribute('marker-end')
+    );
+    if (base) out[route] = +base.getAttribute('opacity');
+  }
+  return out;
+});
+
+const before = await readEdgeOpacities();
+
+// Hover the active-links chip.
+const chipExists = await page.locator('[data-active-links-chip]').count();
+if (chipExists === 0) { console.log('❌ active-links chip not rendered'); process.exit(1); }
+await page.locator('[data-active-links-chip]').hover();
+await page.waitForTimeout(300);
+const onHover = await readEdgeOpacities();
+
+// Mouse-leave.
+await page.mouse.move(10, 10);
+await page.waitForTimeout(300);
+const afterLeave = await readEdgeOpacities();
+
+await browser.close();
+
+const ratio = (after, before) => after / before;
+const allAround = (rs, lo, hi) => rs.every(r => r > lo && r < hi);
+
+const baseValues = Object.values(before);
+const hoverValues = Object.values(onHover);
+const leaveValues = Object.values(afterLeave);
+
+const results = {
+  baseline_equalAtBase:  allAround(baseValues, 0.25, 0.31),
+  hover_allBoosted_15x:  allAround(hoverValues.map((v, i) => ratio(v, baseValues[i])), 1.4, 1.6),
+  hover_absoluteRange:   allAround(hoverValues, 0.39, 0.46),  // 1.5 * (0.22..0.28) * fresh
+  leave_restoreBaseline: allAround(leaveValues.map((v, i) => Math.abs(v - baseValues[i])), -0.01, 0.02),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} active-links chip hover:`, JSON.stringify(results),
+  `\n  before=`,  before,
+  `\n  onHover=`, onHover,
+  `\n  afterLeave=`, afterLeave);
+process.exit(ok ? 0 : 1);