@sleep2agi/agent-network-dashboard 0.4.6-preview.3 → 0.4.6-preview.301

package/scripts/topo-label-card-theme-ease-test.mjs

@@ -0,0 +1,85 @@
+/* Round 246 verification: node label card chrome rect picks up
+ * fill + opacity transitions to coordinate with the existing
+ * filter (R142) + stroke (R217) easing on the same element.
+ *
+ * Pre-R246 the rect transition list was 'filter 220ms ease-out,
+ * stroke 220ms ease-out'. fill (pal.labelBox.fill: cyber dark ↔
+ * light white) and opacity (cyber 0.94, light 1) snapped on theme
+ * toggle. Surrounding elements already ease theme:
+ *   R211 alias/sub text fill (same card)
+ *   R242 chat-target ring filter + stroke
+ *   R244 hub + halo opacity
+ *   R245 edge stroke
+ *
+ * R246 closes the label-card chrome — adds fill + opacity to the
+ * existing transition list so the whole card (background + text)
+ * eases as one unit through theme switches and any future
+ * fill/opacity state changes.
+ *
+ * Test scope per visible label card:
+ *   - element present at [data-node-label-card]
+ *   - style.transition contains filter, stroke, fill, AND opacity
+ *     each at 220ms (or 0.22s browser-normalised)
+ */
+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: 'claude-code-cli',
+    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*', (r2) => r2.fulfill({ json: { messages: [] } }));
+await ctx.route('**/api/hub/tasks*', (r2) => r2.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-node-label-card]', { timeout: 10000, state: 'attached' });
+await page.waitForTimeout(300);
+
+const probe = await page.evaluate(() => {
+  const cards = Array.from(document.querySelectorAll('[data-node-label-card]'));
+  return cards.map((r) => ({
+    alias:      r.getAttribute('data-node-label-card'),
+    elevation:  r.getAttribute('data-node-label-card-elevation'),
+    transition: r.style.transition,
+  }));
+});
+await browser.close();
+
+const hasProp = (s, prop) => new RegExp(`${prop}\\s+(?:220ms|0\\.22s)`).test(s || '');
+
+const results = {
+  four_cards:                probe.length === 4,
+  all_have_alias:            probe.every(p => typeof p.alias === 'string'),
+  all_idle_elevation:        probe.every(p => p.elevation === 'idle'),
+  all_have_filter_220:       probe.every(p => hasProp(p.transition, 'filter')),
+  all_have_stroke_220:       probe.every(p => hasProp(p.transition, 'stroke')),
+  all_have_fill_220:         probe.every(p => hasProp(p.transition, 'fill')),
+  all_have_opacity_220:      probe.every(p => hasProp(p.transition, 'opacity')),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} label card theme ease:`, JSON.stringify(results),
+  '\n  cards:', probe.map(p => ({ a: p.alias, e: p.elevation, t: (p.transition || '').slice(0, 100) })));
+process.exit(ok ? 0 : 1);

package/scripts/topo-label-lift-test.mjs

@@ -0,0 +1,119 @@
+/* Round 26 verification: hovering a node lifts its label group up by
+ * 1.5 px (CSS transform stacked on the SVG positioning translate). Both
+ * the full-card path (sparse fleet) and the dense plain-text path
+ * (large fleet) should respond. */
+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 probe(fleetSize) {
+  const ctx = await browser.newContext({ viewport: { width: 1280, height: 1600 } });
+  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');
+      localStorage.setItem('anet-topo-nodescale', '1');
+      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 = Array.from({ length: fleetSize }, (_, i) => ({
+      alias: `lab${i + 1}`, 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/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) => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    return !!svg && svg.querySelectorAll('g[data-node]').length === n;
+  }, fleetSize, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(500);
+
+  // Re-query the label element fresh each sample — React re-renders on
+  // hover (hoveredAlias state change) so any element handle captured
+  // before the hover would be detached/stale by the time we read its
+  // post-hover position.
+  const readLabelTop = () => page.evaluate(() => {
+    const node = document.querySelector('g[data-node="lab1"]');
+    if (!node) return null;
+    const full = [...node.querySelectorAll('g')].find(g => /group-hover:-translate-y/.test(g.getAttribute('class') || ''));
+    const el = full || [...node.querySelectorAll('text')].find(t => /group-hover:-translate-y/.test(t.getAttribute('class') || ''));
+    return el ? el.getBoundingClientRect().top : null;
+  });
+
+  const beforeY = await readLabelTop();
+  await page.locator('g[data-node="lab1"]').hover();
+  await page.waitForTimeout(300);
+  const afterY = await readLabelTop();
+
+  await ctx.close();
+  return { beforeY, afterY };
+}
+
+const sparse = await probe(4);
+// Note: in dense mode the same alias's hover triggers `showFullLabel`,
+// which swaps the plain-text element for the full-card <g>. That path
+// switch makes a same-element before/after comparison meaningless.
+// The plain-text element still carries the same hover-lift class, so
+// the lift wiring is verified at the DOM level via the second probe.
+const denseClassPresent = await (async () => {
+  const ctx = await browser.newContext({ viewport: { width: 1280, height: 1600 } });
+  const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+  await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+  await ctx.addInitScript(() => {
+    localStorage.setItem('anet-topo-layout', 'grid');
+    localStorage.setItem('anet-topo-nodescale', '1');
+    sessionStorage.setItem('anet_v3_auth', '1');
+  });
+  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 = Array.from({ length: 28 }, (_, i) => ({
+      alias: `lab${i + 1}`, 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/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 === 28, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(500);
+  const has = await page.evaluate(() => {
+    const node = document.querySelector('g[data-node="lab2"]'); // not the one we'd hover
+    if (!node) return false;
+    const t = [...node.querySelectorAll('text')].find(x => /group-hover:-translate-y/.test(x.getAttribute('class') || ''));
+    return !!t;
+  });
+  await ctx.close();
+  return has;
+})();
+
+await browser.close();
+
+// R26 contributes label-only -1.5px lift; R51 (preview.58) adds -2px on the
+// parent <g data-node> on hover, so the label's total measured movement
+// when the node is hovered is ~3.5px. Widen the upper bound to 4 so the
+// two lifts compose without flagging this as a regression.
+const lifted = (m) => m.beforeY != null && m.afterY != null && m.beforeY - m.afterY >= 1 && m.beforeY - m.afterY <= 4;
+
+const results = {
+  sparseLabelLifts: lifted(sparse),
+  densePlainTextHasLiftClass: denseClassPresent,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} label hover lift:`, JSON.stringify(results),
+  `sparse=Δ${(sparse.beforeY - sparse.afterY)?.toFixed(2)}px`);
+process.exit(ok ? 0 : 1);

package/scripts/topo-label-scale-test.mjs

@@ -0,0 +1,78 @@
+/* Round 15 verification: at nodeScale=S the label card + fonts step down
+ * one tier (rect 100×42 → 88×36, alias 12 → 11, sub 9 → 8); M and L keep
+ * the existing sizes. */
+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 measure(scaleVal) {
+  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((s) => {
+    try {
+      localStorage.setItem('anet-theme', 'cyber');
+      localStorage.removeItem('anet-brand');
+      localStorage.removeItem('anet-topo-view');
+      localStorage.setItem('anet-topo-layout', 'grid');
+      localStorage.setItem('anet-topo-nodescale', s);
+      sessionStorage.setItem('anet_v3_auth', '1');
+    } catch {}
+  }, scaleVal);
+  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';
+    // 4 nodes only → sparse, so the full-card label path renders.
+    const sessions = ['lab1', 'lab2', 'lab3', 'lab4'].map(a => ({
+      alias: a, status: 'idle', network_id: nid, project_dir: null,
+      created_at: '2026-05-15T00:00:00Z', updated_at: '2026-05-15T00:00:00Z',
+      last_seen_at: new Date().toISOString(),
+    }));
+    await route.fulfill({ response: r, json: { ...b, 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.waitForFunction(() => {
+    const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+    return !!svg && svg.querySelectorAll('g[data-node]').length === 4;
+  }, { timeout: 30000 }).catch(() => {});
+  await page.waitForTimeout(400);
+  const m = await page.$eval('g[data-node="lab1"]', g => {
+    // label card = the <g transform="translate(...)" > inside the node <g>
+    // that contains the rect+two texts; pick the rect we just changed.
+    const labelG = [...g.querySelectorAll('g')].find(x => x.querySelector('rect') && x.querySelectorAll('text').length === 2);
+    if (!labelG) return null;
+    const rect = labelG.querySelector('rect');
+    const texts = labelG.querySelectorAll('text');
+    return {
+      w: +rect.getAttribute('width'),
+      h: +rect.getAttribute('height'),
+      aliasFs: +texts[0].getAttribute('font-size'),
+      subFs: +texts[1].getAttribute('font-size'),
+    };
+  });
+  await ctx.close();
+  return m;
+}
+
+const S = await measure('0.7');
+const M = await measure('0.84');
+const L = await measure('1');
+await browser.close();
+
+const results = {
+  smallCardW: S?.w === 88,
+  smallCardH: S?.h === 36,
+  smallAliasFs: S?.aliasFs === 11,
+  smallSubFs: S?.subFs === 8,
+  mediumKeepsW: M?.w === 100,
+  mediumKeepsAliasFs: M?.aliasFs === 12,
+  largeKeepsW: L?.w === 100,
+  largeKeepsAliasFs: L?.aliasFs === 12,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} label scale:`, JSON.stringify(results), 'S=', S, 'M=', M, 'L=', L);
+process.exit(ok ? 0 : 1);

package/scripts/topo-lastseen-tooltip-test.mjs

@@ -0,0 +1,59 @@
+/* Round 34 verification: offline node tooltip carries "last seen: <relative>";
+ * online nodes skip the line. SQL-style timestamp parsing is exercised in
+ * production (CommHub format) but the existing isGhost filter has a
+ * separate TZ-sensitivity issue that ghosts SQL-without-Z entries on
+ * non-UTC browsers — out of Round 34 scope. The helper supports both
+ * formats; the SQL path is covered by manual inspection. */
+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 {
+    localStorage.setItem('anet-theme', 'cyber');
+    localStorage.setItem('anet-topo-layout', 'grid');
+    sessionStorage.setItem('anet_v3_auth', '1');
+  } catch {}
+});
+// One online, two offline at different ages (both ISO).
+const now = Date.now();
+const isoMin = (m) => new Date(now - m * 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 fresh = isoMin(0.1);
+  const sessions = [
+    { alias: 'live',    status: 'idle',    network_id: nid, project_dir: null,
+      created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'off6m',   status: 'offline', network_id: nid, project_dir: null,
+      created_at: fresh, updated_at: fresh, last_seen_at: isoMin(6) },
+    { alias: 'off45m',  status: 'offline', network_id: nid, project_dir: null,
+      created_at: fresh, updated_at: fresh, last_seen_at: isoMin(45) },
+  ];
+  await route.fulfill({ response: r, json: { ...b, 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.waitForFunction(() => document.querySelectorAll('g[data-node]').length === 3, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const titleOf = alias => page.$eval(`g[data-node="${alias}"] title`, el => el.textContent);
+const live = await titleOf('live');
+const off6m = await titleOf('off6m');
+const off45m = await titleOf('off45m');
+
+await browser.close();
+const results = {
+  liveSkipsLastSeen: !/last seen:/.test(live),
+  off6mShows6mAgo: /last seen: [56]m ago/.test(off6m),    // 6m exactly, ±1 minute slack
+  off45mShows45mAgo: /last seen: 4[45]m ago/.test(off45m), // 45m exactly, ±1 minute slack
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} last-seen tooltip:`, JSON.stringify(results),
+  `\n  live=${JSON.stringify(live)}\n  off6m=${JSON.stringify(off6m)}\n  off45m=${JSON.stringify(off45m)}`);
+process.exit(ok ? 0 : 1);

package/scripts/topo-layout-hover-text-preview-test.mjs

@@ -0,0 +1,101 @@
+/* Round 273 verification: Layout toggle inactive buttons hover-text
+ * now previews active text color (cyan-300), completing R163's
+ * "hover previews active state" pattern.
+ *
+ * Pre-R273 the inactive Ring/Grid buttons used:
+ *   text-gray-500 hover:text-gray-300 hover:bg-cyan-500/5 active:bg-cyan-500/15
+ *
+ * The bg part previewed the active cyan-500/15 ghost via cyan-500/5,
+ * but the text just brightened gray-500→gray-300. Half-preview:
+ * cyan ghost bg + gray text. Active state was cyan-500/15 bg + cyan-300
+ * text — so hovering inactive didn't visually preview the active text
+ * color.
+ *
+ * Post-R273:
+ *   text-gray-500 hover:text-cyan-300 hover:bg-cyan-500/5 active:bg-cyan-500/15
+ *
+ * Hover state now previews BOTH the active bg (cyan ghost) AND text
+ * (cyan-300). Bg /5 vs /15 still distinguishes hover-preview from
+ * active-real.
+ *
+ * Test scope:
+ *   1. Ring inactive button (default state has Ring active; toggle to
+ *      Grid first so Ring becomes inactive) classlist contains
+ *      'hover:text-cyan-300' and does NOT contain 'hover:text-gray-300'.
+ *   2. Grid inactive button (default state) classlist contains
+ *      'hover:text-cyan-300'.
+ *   3. R163 invariant: hover:bg-cyan-500/5 still present on inactive.
+ *   4. R272 freshness chip text starts with 'live · ' (regression).
+ */
+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';
+  const mk = (alias) => ({
+    alias, status: 'working', model: 'claude-opus-4', runtime: 'claude-code-cli',
+    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*', (r) => r.fulfill({ json: { messages: [] } }));
+await ctx.route('**/api/hub/tasks*', (r) => r.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-chrome-layout="ring"]', { timeout: 10000 });
+await page.waitForSelector('[data-topo-chrome-layout="grid"]', { timeout: 10000 });
+await page.waitForSelector('[data-freshness-chip]',            { timeout: 10000 });
+await page.waitForTimeout(300);
+
+const probe = await page.evaluate(() => {
+  // Default localStorage = ring is active, grid is inactive.
+  const ring = document.querySelector('[data-topo-chrome-layout="ring"]');
+  const grid = document.querySelector('[data-topo-chrome-layout="grid"]');
+  const freshness = document.querySelector('[data-freshness-chip]');
+  return {
+    ringClasses:    ring ? ring.className.toString() : null,
+    ringActive:     ring ? ring.getAttribute('data-topo-chrome-layout-active') : null,
+    gridClasses:    grid ? grid.className.toString() : null,
+    gridActive:     grid ? grid.getAttribute('data-topo-chrome-layout-active') : null,
+    freshnessText:  freshness ? freshness.textContent.trim() : null,
+  };
+});
+await browser.close();
+
+const has = (s, cls) => (s || '').includes(cls);
+
+// Ring is default-active (true). Grid is default-inactive (false).
+// Grid (inactive) should have hover:text-cyan-300.
+// Ring (active) uses 'bg-cyan-500/15 text-cyan-300 hover:bg-cyan-500/20 active:bg-cyan-500/25'
+//   — no hover:text-cyan-300 (it's already cyan-300 at rest) — UNCHANGED.
+
+const results = {
+  ring_is_active:                       probe.ringActive === 'true',
+  grid_is_inactive:                     probe.gridActive === 'false',
+  grid_inactive_has_hover_cyan_text:    has(probe.gridClasses, 'hover:text-cyan-300'),
+  grid_inactive_no_hover_gray_text:     !has(probe.gridClasses, 'hover:text-gray-300'),
+  grid_inactive_keeps_cyan_bg_hover:    has(probe.gridClasses, 'hover:bg-cyan-500/5'),
+  ring_active_has_cyan_text_base:       has(probe.ringClasses, 'text-cyan-300'),
+  r272_freshness_starts_with_live:      probe.freshnessText != null && probe.freshnessText.startsWith('live · '),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} layout hover text preview:`, JSON.stringify(results),
+  '\n  ring classes:', probe.ringClasses,
+  '\n  grid classes:', probe.gridClasses,
+  '\n  freshness:',    probe.freshnessText);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,91 @@
+/* Round 32 verification: `l` (and `L`) keyboard shortcut toggles
+ * ring ↔ grid; titles + Help overlay surface the hint; input-focus
+ * suppression still blocks it. */
+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: 1600 } });
+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'); // start on 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 = ['a', 'b', 'c'].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 } });
+});
+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('button[aria-label="Topology layout"], button[title*="Ring layout"]', { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const layoutPressed = () => page.evaluate(() => {
+  const ring = document.querySelector('button[title^="Ring layout"]');
+  const grid = document.querySelector('button[title^="Grid layout"]');
+  return { ring: ring?.getAttribute('aria-pressed'), grid: grid?.getAttribute('aria-pressed') };
+});
+
+const initial = await layoutPressed();
+
+// Press `l` → should toggle to ring
+await page.keyboard.press('l');
+await page.waitForTimeout(150);
+const afterL = await layoutPressed();
+
+// Press `L` (shift+l) → toggle back to grid
+await page.keyboard.press('Shift+L');
+await page.waitForTimeout(150);
+const afterShiftL = await layoutPressed();
+
+// Titles carry the hint
+const titles = await page.evaluate(() => ({
+  ring: document.querySelector('button[title^="Ring layout"]')?.getAttribute('title') || '',
+  grid: document.querySelector('button[title^="Grid layout"]')?.getAttribute('title') || '',
+}));
+
+// Help overlay lists the shortcut
+await page.keyboard.press('?');
+await page.waitForTimeout(200);
+const helpHasLayout = await page.evaluate(() => {
+  const heading = [...document.querySelectorAll('[role="dialog"] div')].find(el => el.textContent === 'Topology canvas');
+  if (!heading) return false;
+  return /Toggle layout/i.test(heading.parentElement?.textContent || '');
+});
+
+// Input-focus suppression — Cmd+K input, press l, no toggle
+await page.keyboard.press('Escape');
+await page.keyboard.press('Meta+k');
+await page.waitForTimeout(200);
+const palette = page.locator('input[placeholder*="Search"], input[type="search"], [role="dialog"] input').first();
+await palette.focus().catch(() => {});
+const beforeFocusToggle = await layoutPressed();
+await page.keyboard.press('l');
+await page.waitForTimeout(150);
+const afterFocusToggle = await layoutPressed();
+await page.keyboard.press('Escape');
+
+await browser.close();
+const results = {
+  startsGrid: initial.grid === 'true' && initial.ring === 'false',
+  lTogglesToRing: afterL.ring === 'true' && afterL.grid === 'false',
+  shiftLTogglesBack: afterShiftL.grid === 'true' && afterShiftL.ring === 'false',
+  titlesPresent: /l to toggle/i.test(titles.ring) && /l to toggle/i.test(titles.grid),
+  helpListsLayout: helpHasLayout,
+  inputFocusSuppressed: beforeFocusToggle.grid === afterFocusToggle.grid && beforeFocusToggle.ring === afterFocusToggle.ring,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} layout key:`, JSON.stringify(results), `titles=`, titles);
+process.exit(ok ? 0 : 1);

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