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

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-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);

package/scripts/topo-legend-pin-ring-fade-test.mjs

@@ -0,0 +1,112 @@
+/* Round 181 verification: legend row pinned-state ring (R61) is
+ * now always-mounted with opacity-gated visibility + 150ms
+ * transition — smooth fade in/out on pin / unpin.
+ *
+ * Pre-R181 the ring mounted/unmounted conditionally, snapping
+ * on every state change. Same vocabulary as R165/R180 smooth-
+ * pin-mirror family, applied at the legend-row scope.
+ *
+ * Test:
+ *   1. Idle: ring exists in DOM but opacity=0
+ *   2. Click 'working' legend row → ring for working = opacity=1
+ *   3. Other rings (idle / offline) stay opacity=0
+ *   4. Re-click 'working' → unpin → opacity returns to 0
+ *   5. All rings carry 'opacity 150ms ease-out' transition
+ */
+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();
+const stale = 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, last) => ({
+    alias, status, model: 'claude-opus-4', runtime: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: last, updated_at: last, last_seen_at: last,
+  });
+  // Mix of statuses so all three legend rows render
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('w1', 'working', fresh), mk('w2', 'working', fresh),
+    mk('i1', 'idle',    fresh),
+    mk('o1', 'offline', stale),
+  ] } });
+});
+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-pin-ring]', { timeout: 10000 });
+await page.waitForTimeout(400);
+
+const probe = () => page.evaluate(() => {
+  const grab = (k) => {
+    const r = document.querySelector(`[data-legend-pin-ring="${k}"]`);
+    return r ? {
+      opacity:    parseFloat(r.getAttribute('opacity') || ''),
+      pinnedAttr: r.getAttribute('data-legend-pin-ring-pinned'),
+      transition: r.style.transition || getComputedStyle(r).transition,
+    } : null;
+  };
+  return {
+    working: grab('working'),
+    idle:    grab('idle'),
+    offline: grab('offline'),
+  };
+});
+
+const idle = await probe();
+
+// Pin 'working' status by clicking the legend row
+await page.locator('[data-legend-status="working"]').click();
+await page.waitForTimeout(250);
+const afterPin = await probe();
+
+// Re-click to unpin
+await page.locator('[data-legend-status="working"]').click();
+await page.waitForTimeout(250);
+const afterUnpin = await probe();
+
+await browser.close();
+
+const hasTransition = (s) =>
+  (s?.transition || '').includes('opacity 150ms') ||
+  /opacity\s+0\.15s|opacity\s+150ms/.test(s?.transition || '');
+
+const results = {
+  // Idle (no pin)
+  three_rings_present:       idle.working !== null && idle.idle !== null && idle.offline !== null,
+  idle_working_opacity_0:    idle.working?.opacity === 0,
+  idle_idle_opacity_0:       idle.idle?.opacity === 0,
+  idle_offline_opacity_0:    idle.offline?.opacity === 0,
+  all_have_transition:       hasTransition(idle.working) && hasTransition(idle.idle) && hasTransition(idle.offline),
+
+  // After pin working
+  pin_working_opacity_1:     afterPin.working?.opacity === 1,
+  pin_working_pinned_attr:   afterPin.working?.pinnedAttr === 'true',
+  pin_idle_stays_0:          afterPin.idle?.opacity === 0,
+  pin_offline_stays_0:       afterPin.offline?.opacity === 0,
+
+  // After unpin
+  unpin_working_opacity_0:   afterUnpin.working?.opacity === 0,
+  unpin_working_pinned_attr: afterUnpin.working?.pinnedAttr === 'false',
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} legend pin-ring fade:`, JSON.stringify(results),
+  `\n  idle =`, idle,
+  `\n  pinned =`, afterPin,
+  `\n  unpinned =`, afterUnpin);
+process.exit(ok ? 0 : 1);