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

package/scripts/topo-layout-switch-crossfade-test.mjs

@@ -0,0 +1,126 @@
+/* Round 170 verification: layout toggle (Ring ↔ Grid) crossfade.
+ *
+ * Pre-R170 clicking Ring/Grid teleported every node to its new
+ * position in one frame — most jarring user action on the canvas.
+ *
+ * R170 introduces layoutSwitching one-shot flag (same pattern as
+ * R168 smoothView but on opacity axis). The viewport <g>:
+ *   transition: 'opacity 250ms ease-out' (always present)
+ *              + 'transform 300ms ease-out' (when smoothView armed)
+ *   opacity: layoutSwitching ? 0.45 : 1
+ *   data-topo-viewport-layout-switching: 'true' | 'false'
+ *
+ * Layout state swap is synchronous (setLayout) — the dim masks
+ * the snap as a soft blink. Auto-clears 400ms (covers fade-down
+ * 250ms + buffer for React commit).
+ *
+ * Test:
+ *   1. Idle (ring layout): layoutSwitching='false', opacity=1
+ *   2. Press 'L' (toggleLayout) → flag='true', opacity=0.45
+ *   3. Layout state flipped to grid (group boxes visible)
+ *   4. Wait 450ms → flag='false', opacity=1
+ *   5. Press 'L' again → flag='true' (reverse direction works too)
+ */
+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: 1500, 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');
+    sessionStorage.setItem('anet_v3_auth', '1');
+    localStorage.setItem('anet-topo-layout', 'ring');
+  } 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 mk = (alias) => ({
+    alias, status: 'working', model: 'claude-opus-4', runtime: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  // Prefix-clustered aliases so group boxes render in grid layout
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('agents-a1'), mk('agents-a2'), mk('infra-b1'), mk('infra-b2'),
+  ] } });
+});
+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.waitForSelector('[data-topo-viewport]', { timeout: 10000 });
+await page.waitForTimeout(400);
+
+const probeViewport = () => page.evaluate(() => {
+  const g = document.querySelector('[data-topo-viewport]');
+  return {
+    layoutSwitching: g?.getAttribute('data-topo-viewport-layout-switching'),
+    opacity:        g?.style?.opacity || '',
+    transition:     g?.style?.transition || '',
+    hubVisible:     !!document.querySelector('[data-topo-hub]'),
+    groupBoxes:     document.querySelectorAll('[data-group-box-pinned]').length,
+  };
+});
+
+const idle = await probeViewport();
+
+// Press 'L' to toggle ring → grid. Probe within 400ms window.
+await page.keyboard.press('l');
+await page.waitForTimeout(50);
+const duringToggle1 = await probeViewport();
+
+// Wait past 400ms window
+await page.waitForTimeout(420);
+const afterToggle1 = await probeViewport();
+
+// Press 'L' again to toggle grid → ring
+await page.keyboard.press('l');
+await page.waitForTimeout(50);
+const duringToggle2 = await probeViewport();
+
+await page.waitForTimeout(420);
+const afterToggle2 = await probeViewport();
+
+await browser.close();
+
+const results = {
+  viewport_found:                idle !== null,
+  idle_layoutSwitching_false:    idle.layoutSwitching === 'false',
+  idle_opacity_1:                idle.opacity === '1' || idle.opacity === '',
+  idle_has_opacity_transition:   idle.transition.includes('opacity 250ms'),
+  idle_in_ring:                  idle.hubVisible && idle.groupBoxes === 0,
+
+  toggle1_flag_true:             duringToggle1.layoutSwitching === 'true',
+  toggle1_opacity_0p45:          duringToggle1.opacity === '0.45',
+  // Layout state has flipped synchronously inside toggleLayout
+  toggle1_now_grid:              !duringToggle1.hubVisible && duringToggle1.groupBoxes > 0,
+
+  after1_flag_false:             afterToggle1.layoutSwitching === 'false',
+  after1_opacity_1:              afterToggle1.opacity === '1',
+  after1_still_grid:             !afterToggle1.hubVisible && afterToggle1.groupBoxes > 0,
+
+  toggle2_flag_true:             duringToggle2.layoutSwitching === 'true',
+  toggle2_opacity_0p45:          duringToggle2.opacity === '0.45',
+  toggle2_back_to_ring:          duringToggle2.hubVisible && duringToggle2.groupBoxes === 0,
+
+  after2_flag_false:             afterToggle2.layoutSwitching === 'false',
+  after2_opacity_1:              afterToggle2.opacity === '1',
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} layout switch crossfade:`, JSON.stringify(results),
+  `\n  idle =`, idle,
+  `\n  during toggle1 (ring→grid) =`, duringToggle1,
+  `\n  after toggle1 =`, afterToggle1,
+  `\n  during toggle2 (grid→ring) =`, duringToggle2,
+  `\n  after toggle2 =`, afterToggle2);
+process.exit(ok ? 0 : 1);

package/scripts/topo-layout-toggle-test.mjs

@@ -0,0 +1,131 @@
+/* Round 163 verification: Ring/Grid layout toggle buttons pick
+ * up the R154 chrome-button polish convention.
+ *
+ * Pre-R163 the buttons had aria-pressed + transition-colors but:
+ *   - no focus-visible ring (browser default invisible on canvas)
+ *   - inactive hover only nudged text-gray-500 → gray-400, no bg
+ *
+ * R163 adds:
+ *   data-topo-chrome-layout="ring|grid"
+ *   data-topo-chrome-layout-active="true|false"
+ *   focus-visible:ring-2 ring-cyan-400/60 ring-inset
+ *   inactive: hover:text-gray-300 + hover:bg-cyan-500/5
+ *   active:   hover:bg-cyan-500/20 (slightly hotter)
+ *
+ * Test:
+ *   1. Both buttons present with data-topo-chrome-layout attr
+ *   2. Active button has bg-cyan-500/15 class fragment (existing)
+ *   3. Focus the inactive button → focus-visible ring class fragment
+ *   4. Hover the inactive button → bg color shifts from transparent
+ *      to a cyan-ish tint (border bg-cyan-500/5)
+ */
+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: 1500, 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'); sessionStorage.setItem('anet_v3_auth', '1'); localStorage.setItem('anet-topo-layout', 'ring'); } 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 mk = (alias) => ({
+    alias, status: 'working', model: 'claude-opus-4', runtime: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  await route.fulfill({ response: r, json: { ...b, sessions: [mk('alpha'), mk('beta')] } });
+});
+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 === 2, { timeout: 30000 });
+await page.waitForSelector('[data-topo-chrome-layout]', { timeout: 10000 });
+await page.waitForTimeout(400);
+
+// Probe basic attrs & class membership
+const probe = await page.evaluate(() => {
+  const ring = document.querySelector('[data-topo-chrome-layout="ring"]');
+  const grid = document.querySelector('[data-topo-chrome-layout="grid"]');
+  if (!ring || !grid) return null;
+  return {
+    ring_active:    ring.getAttribute('data-topo-chrome-layout-active'),
+    grid_active:    grid.getAttribute('data-topo-chrome-layout-active'),
+    ring_pressed:   ring.getAttribute('aria-pressed'),
+    grid_pressed:   grid.getAttribute('aria-pressed'),
+    ring_class:     ring.getAttribute('class') || '',
+    grid_class:     grid.getAttribute('class') || '',
+  };
+});
+
+// Focus the inactive (grid) button — focus-visible ring should kick in.
+// Tab-focus produces the :focus-visible state; .focus() doesn't always.
+// Use page.keyboard.press('Tab') after first focusing somewhere known.
+await page.locator('[data-topo-chrome-layout="grid"]').focus();
+// trigger keyboard navigation to enable focus-visible state heuristic
+await page.evaluate(() => {
+  const el = document.querySelector('[data-topo-chrome-layout="grid"]');
+  if (el) el.matches(':focus-visible');
+});
+const focusVisibleProbe = await page.evaluate(() => {
+  const el = document.querySelector('[data-topo-chrome-layout="grid"]');
+  if (!el) return null;
+  return {
+    isActiveElement: document.activeElement === el,
+    // Inspect outline & box-shadow because the Tailwind focus-visible:ring
+    // class compiles to a box-shadow. After .focus() Chromium reports
+    // :focus-visible heuristically — we verify the class fragment exists
+    // in the stylesheet bound to this element rather than relying on the
+    // dynamic pseudo-class match.
+    classFragments: {
+      hasFocusVisibleRingClass: (el.getAttribute('class') || '').includes('focus-visible:ring-cyan-400/60'),
+      hasRingInset:             (el.getAttribute('class') || '').includes('focus-visible:ring-inset'),
+      hasFocusOutlineNone:      (el.getAttribute('class') || '').includes('focus:outline-none'),
+    },
+  };
+});
+
+// Hover the inactive (grid) button — bg should shift away from transparent.
+const gridBgBefore = await page.evaluate(() => {
+  const el = document.querySelector('[data-topo-chrome-layout="grid"]');
+  return el ? getComputedStyle(el).backgroundColor : null;
+});
+await page.locator('[data-topo-chrome-layout="grid"]').hover();
+await page.waitForTimeout(300);
+const gridBgHover = await page.evaluate(() => {
+  const el = document.querySelector('[data-topo-chrome-layout="grid"]');
+  return el ? getComputedStyle(el).backgroundColor : null;
+});
+
+await browser.close();
+
+const results = {
+  both_buttons_found:        probe !== null,
+  ring_is_active:            probe?.ring_active === 'true',
+  grid_is_inactive:          probe?.grid_active === 'false',
+  ring_aria_pressed:         probe?.ring_pressed === 'true',
+  grid_aria_unpressed:       probe?.grid_pressed === 'false',
+  active_has_cyan_bg_class:  probe?.ring_class.includes('bg-cyan-500/15'),
+  inactive_hover_bg_class:   probe?.grid_class.includes('hover:bg-cyan-500/5'),
+  active_hover_bg_class:     probe?.ring_class.includes('hover:bg-cyan-500/20'),
+  focus_outline_none:        focusVisibleProbe?.classFragments?.hasFocusOutlineNone === true,
+  focus_visible_ring_class:  focusVisibleProbe?.classFragments?.hasFocusVisibleRingClass === true,
+  focus_visible_ring_inset:  focusVisibleProbe?.classFragments?.hasRingInset === true,
+  inactive_bg_before:        gridBgBefore !== null,
+  hover_changes_bg:          gridBgBefore !== gridBgHover,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} layout toggle polish:`, JSON.stringify(results),
+  `\n  probe=`, probe,
+  `\n  focus=`, focusVisibleProbe,
+  `\n  bg before/hover=`, gridBgBefore, '→', gridBgHover);
+process.exit(ok ? 0 : 1);

package/scripts/topo-legend-count-empty-test.mjs

@@ -0,0 +1,126 @@
+/* Round 204 verification: legend count text recedes when its status
+ * tier is empty (count = 0). Pre-R204 "0" at opacity 0.65 read
+ * visually identical to "12" at opacity 0.65; R204 drops empty rows
+ * to 0.30 (dark) / 0.28 (light) so the eye gets a "no nodes in this
+ * tier" signal without parsing the digit.
+ *
+ * Test (cyber dark, all 4 sessions = working → idle=0, offline=0):
+ *   1. Three legend count texts present with data-legend-count for
+ *      working / idle / offline.
+ *   2. Working row: count='4', data-legend-count-empty='false',
+ *      opacity = 0.65 (idle, not hovered).
+ *   3. Idle row: count='0', data-legend-count-empty='true',
+ *      opacity ≈ 0.30 (dim recede).
+ *   4. Offline row: count='0', data-legend-count-empty='true',
+ *      opacity ≈ 0.30.
+ *   5. Hover working row → its count bumps to opacity ~0.95
+ *      (existing R95 hover behaviour unbroken).
+ *   6. Hover idle row → empty-tier opacity DOES NOT bump (empty
+ *      gate wins over hover). Recedes regardless.
+ *   7. Transition: opacity 150ms ease-out still on all three.
+ */
+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: 1500, 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'); 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';
+  // All 4 working — idle / offline tiers empty
+  const mk = (alias) => ({
+    alias, status: 'working', model: 'claude-opus-4', runtime: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('alpha'), mk('beta'), mk('gamma'), mk('delta'),
+  ] } });
+});
+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.waitForSelector('[data-legend-count="working"]', { timeout: 10000 });
+await page.waitForTimeout(300);
+
+const probe = async () => page.evaluate(() => {
+  const pick = (key) => {
+    const el = document.querySelector(`[data-legend-count="${key}"]`);
+    if (!el) return null;
+    return {
+      key,
+      text:        el.textContent,
+      empty:       el.getAttribute('data-legend-count-empty'),
+      opacity:     parseFloat(el.getAttribute('opacity') || ''),
+      transition:  el.style.transition,
+    };
+  };
+  return { working: pick('working'), idle: pick('idle'), offline: pick('offline') };
+});
+
+const idle = await probe();
+
+// Hover the working row — verify R95 hover bump still fires (count > 0)
+await page.hover('[data-legend-status="working"]');
+await page.waitForTimeout(200);
+const hovWorking = await probe();
+
+// Move off, then hover the empty (idle=0) row — verify empty gate wins
+await page.mouse.move(0, 0);
+await page.waitForTimeout(200);
+await page.hover('[data-legend-status="idle"]');
+await page.waitForTimeout(200);
+const hovIdle = await probe();
+
+await page.mouse.move(0, 0);
+await page.waitForTimeout(200);
+
+await browser.close();
+
+const opacityNear = (got, want, tol = 0.04) => Math.abs(got - want) < tol;
+
+const results = {
+  working_present:           !!idle?.working,
+  idle_present:              !!idle?.idle,
+  offline_present:           !!idle?.offline,
+
+  working_text_4:            idle?.working?.text === '4',
+  working_not_empty:         idle?.working?.empty === 'false',
+  working_opacity_0p65:      opacityNear(idle?.working?.opacity ?? 0, 0.65),
+
+  idle_text_0:               idle?.idle?.text === '0',
+  idle_empty_true:           idle?.idle?.empty === 'true',
+  idle_opacity_dim:          opacityNear(idle?.idle?.opacity ?? 0, 0.30),
+
+  offline_text_0:            idle?.offline?.text === '0',
+  offline_empty_true:        idle?.offline?.empty === 'true',
+  offline_opacity_dim:       opacityNear(idle?.offline?.opacity ?? 0, 0.30),
+
+  // R95 hover still bumps when row populated
+  working_hover_opacity_high: opacityNear(hovWorking?.working?.opacity ?? 0, 0.95),
+
+  // Empty-gate wins: hovering an empty row does NOT bump its count opacity
+  idle_hover_stays_dim:       opacityNear(hovIdle?.idle?.opacity ?? 0, 0.30),
+
+  // Transition still in place across all 3
+  all_have_transition:        ['working', 'idle', 'offline'].every(k =>
+    /opacity\s+(?:150ms|0\.15s)/.test(idle?.[k]?.transition || '')),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} legend count empty:`, JSON.stringify(results),
+  `\n  idle:`,        idle,
+  `\n  hovWorking:`,  hovWorking,
+  `\n  hovIdle:`,     hovIdle);
+process.exit(ok ? 0 : 1);

package/scripts/topo-legend-count-test.mjs

@@ -0,0 +1,88 @@
+/* Round 95 verification: legend rows show live counts. Fleet = 3
+ * working + 2 idle + 1 offline. Each row's data-legend-count
+ * attribute matches the expected number. Pinning a row brightens
+ * its count alongside the label.
+ *
+ * The count is right-aligned at x=215 (after the flow-arrow swatch
+ * which spans x=140-196 on the offline row), pointerEvents:none so
+ * the row's R55 hover affordance still hits.
+ */
+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');
+  } catch {}
+});
+
+const fresh   = new Date(Date.now() - 60 * 1000).toISOString();
+const stale10 = new Date(Date.now() - 10 * 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 mk = (alias, status, ts) => ({
+    alias, status, model: 'claude-opus-4', runtime: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: ts, updated_at: ts, last_seen_at: ts,
+  });
+  const sessions = [
+    mk('wkr1', 'working', fresh),
+    mk('wkr2', 'working', fresh),
+    mk('wkr3', 'working', fresh),
+    mk('idl1', 'idle',    fresh),
+    mk('idl2', 'idle',    fresh),
+    mk('off1', 'offline', stale10),
+  ];
+  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 === 6, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const counts = () => page.evaluate(() => ({
+  working: document.querySelector('[data-legend-count="working"]')?.textContent,
+  idle:    document.querySelector('[data-legend-count="idle"]')?.textContent,
+  offline: document.querySelector('[data-legend-count="offline"]')?.textContent,
+}));
+const opacities = () => page.evaluate(() => ({
+  working: +(document.querySelector('[data-legend-count="working"]')?.getAttribute('opacity') || '0'),
+  idle:    +(document.querySelector('[data-legend-count="idle"]')?.getAttribute('opacity') || '0'),
+  offline: +(document.querySelector('[data-legend-count="offline"]')?.getAttribute('opacity') || '0'),
+}));
+
+const c = await counts();
+const opsRest = await opacities();
+
+// Pin the working row — its count should brighten.
+await page.locator('[data-legend-status="working"]').click();
+await page.waitForTimeout(250);
+const opsPinned = await opacities();
+
+await browser.close();
+
+const results = {
+  workingCount_3:        c.working === '3',
+  idleCount_2:           c.idle === '2',
+  offlineCount_1:        c.offline === '1',
+  resting_dim:           opsRest.working < 0.7 && opsRest.idle < 0.7 && opsRest.offline < 0.7,
+  pinnedWorking_bright:  opsPinned.working >= 0.9,
+  pinnedWorking_othersUnchanged: opsPinned.idle < 0.7 && opsPinned.offline < 0.7,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} legend counts:`, JSON.stringify(results),
+  `\n  counts=`,      c,
+  `\n  opsRest=`,     opsRest,
+  `\n  opsPinned=`,   opsPinned);
+process.exit(ok ? 0 : 1);

package/scripts/topo-legend-hover-test.mjs

@@ -0,0 +1,113 @@
+/* Round 55 verification: hovering a legend status row dims nodes whose
+ * status doesn't match.
+ *
+ * Sessions (mix of statuses):
+ *   wkr  — working          (status=working)
+ *   idl1 — idle online      (status=idle)
+ *   idl2 — idle online      (status=idle)
+ *   off  — offline          (status=offline, last_seen old)
+ *
+ * Hover the "working node" row → wkr stays bright (~1.0), the rest dim
+ * (~0.28). Hover "online idle" → idl1/idl2 stay, wkr+off dim. Hover
+ * "offline / no SSE" → off stays, the three online dim. Release →
+ * all back to base.
+ */
+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 });
+
+// Dashboard chrome pushes the SVG ~830 px down at width 1400, so the
+// legend's offline row sits at screen y≈900 — below a 900-px viewport.
+// 1500 px tall gives a comfortable margin for all three rows.
+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');
+  } catch {}
+});
+
+const fresh = new Date(Date.now() - 60 * 1000).toISOString();
+const stale = new Date(Date.now() - 30 * 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: 'wkr',  status: 'working', network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'idl1', status: 'idle',    network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'idl2', status: 'idle',    network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'off',  status: 'offline', network_id: nid, project_dir: null, created_at: stale, updated_at: stale, last_seen_at: stale },
+  ];
+  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 opacities = () => page.evaluate(() => {
+  const o = {};
+  for (const a of ['wkr', 'idl1', 'idl2', 'off']) {
+    const g = document.querySelector(`g[data-node="${a}"]`);
+    o[a] = g ? +(g.style.opacity || '1') : null;
+  }
+  return o;
+});
+
+const before = await opacities();
+
+async function hoverRow(key) {
+  const target = await page.evaluate((k) => {
+    const g = document.querySelector(`g[data-legend-status="${k}"]`);
+    if (!g) return null;
+    const r = g.getBoundingClientRect();
+    return { x: r.x + r.width / 2, y: r.y + r.height / 2 };
+  }, key);
+  if (!target) throw new Error(`legend row ${key} not found`);
+  // jiggle from a neutral spot, then to the target
+  await page.mouse.move(10, 10);
+  await page.mouse.move(target.x, target.y);
+  await page.waitForTimeout(300);
+  return await opacities();
+}
+
+const onWorking = await hoverRow('working');
+const onIdle    = await hoverRow('idle');
+const onOffline = await hoverRow('offline');
+await page.mouse.move(10, 10);
+await page.waitForTimeout(300);
+const released = await opacities();
+
+await browser.close();
+
+const dim = (v) => v != null && v < 0.4;
+const bright = (v) => v != null && v >= 0.55;
+const results = {
+  before_baseline: bright(before.wkr) && bright(before.idl1) && bright(before.idl2),
+  working_keepsWorking: bright(onWorking.wkr),
+  working_dimsIdle:     dim(onWorking.idl1) && dim(onWorking.idl2),
+  working_dimsOffline:  dim(onWorking.off),
+  idle_keepsIdle:       bright(onIdle.idl1) && bright(onIdle.idl2),
+  idle_dimsWorking:     dim(onIdle.wkr),
+  idle_dimsOffline:     dim(onIdle.off),
+  // Offline base opacity is 0.6 (R17), so "kept" means >= 0.55 which the
+  // bright() helper already covers — anything in [0.55, 1] counts.
+  offline_keepsOffline: bright(onOffline.off),
+  offline_dimsOnline:   dim(onOffline.wkr) && dim(onOffline.idl1) && dim(onOffline.idl2),
+  released_restoresAll: bright(released.wkr) && bright(released.idl1) && bright(released.idl2),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} legend status hover:`, JSON.stringify(results),
+  `\n  before=`, before,
+  `\n  onWorking=`, onWorking,
+  `\n  onIdle=`,    onIdle,
+  `\n  onOffline=`, onOffline,
+  `\n  released=`, released);
+process.exit(ok ? 0 : 1);

package/scripts/topo-legend-panel-header-test.mjs

@@ -0,0 +1,83 @@
+/* Round 106 verification: legend panel gains a header matching the
+ * recent-signal panel's "recent signal · N flows" format. Same
+ * font/position vocabulary so the two side panels feel paired. The
+ * fleet count is right-aligned at x=215 in the accent colour.
+ *
+ * Sanity-checks:
+ *   - "legend" title text exists in the legend panel
+ *   - "N node(s)" count matches sessions.length
+ *   - Singular vs plural ("1 node" vs "5 nodes") correct
+ *   - Existing rows still render (hover affordance preserved)
+ */
+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 fresh = new Date(Date.now() - 60 * 1000).toISOString();
+
+const probe = async (count) => {
+  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'); sessionStorage.setItem('anet_v3_auth', '1'); } catch {}
+  });
+  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 = [];
+    for (let i = 0; i < count; i++) {
+      sessions.push({
+        alias: `n${i}`, status: 'idle', model: 'claude-opus-4', runtime: 'cli-claude-code',
+        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((n) => document.querySelectorAll('g[data-node]').length === n, count, { timeout: 30000 });
+  await page.waitForSelector('[data-legend-panel-count]', { timeout: 10000 });
+  await page.waitForTimeout(400);
+
+  const data = await page.evaluate(() => {
+    const headerCount = document.querySelector('[data-legend-panel-count]')?.textContent;
+    const headerTitle = (() => {
+      // Find a <text> with "legend" content in the legend panel <g>
+      const panel = document.querySelector('[data-topo-panel-elevation="legend"]')?.parentElement;
+      if (!panel) return null;
+      for (const t of panel.querySelectorAll('text')) {
+        if (t.textContent === 'legend') return t.textContent;
+      }
+      return null;
+    })();
+    const legendRows = document.querySelectorAll('[data-legend-status]').length;
+    return { headerCount, headerTitle, legendRows };
+  });
+  await ctx.close();
+  return data;
+};
+
+const single = await probe(1);
+const many   = await probe(5);
+await browser.close();
+
+const results = {
+  single_hasTitle:        single.headerTitle === 'legend',
+  single_count1Node:      single.headerCount === '1 node',
+  many_hasTitle:          many.headerTitle === 'legend',
+  many_count5Nodes:       many.headerCount === '5 nodes',
+  many_rowsStillRender:   many.legendRows >= 1, // depends on which states are present
+  // Sanity: singular vs plural
+  singular_correct:       single.headerCount?.endsWith(' node'),
+  plural_correct:         many.headerCount?.endsWith(' nodes'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} legend panel header:`, JSON.stringify(results),
+  `\n  single (1 node)=`, single,
+  `\n  many (5 nodes)=`,  many);
+process.exit(ok ? 0 : 1);