@sleep2agi/agent-network-dashboard 0.4.6-preview.31 → 0.4.6-preview.310

package/scripts/topo-html-overlay-padding-unify-test.mjs

@@ -0,0 +1,120 @@
+/* Round 261 verification: HTML overlay padding aligned with SVG corner
+ * panel padding — chrome strip + minimap both at 16 CSS px from canvas
+ * edges, matching the SVG corner panels at (16, 16) panel-translate.
+ *
+ * Pre-R261:
+ *   SVG panels: 16 SVG units from edges (≈ 15 CSS px @ ~0.94× scale)
+ *   chrome:     12 CSS px (bottom-3 right-3) — ~3px optical asymmetry
+ *   minimap:    12 CSS px (right-3)         — same asymmetry
+ *
+ * Post-R261:
+ *   chrome:  bottom-4 right-4 → 16 CSS px from container edges
+ *   minimap: right-4          → 16 CSS px from container right edge
+ *
+ * 16 CSS px ≈ 17 SVG units, slightly tighter than the SVG 16-unit
+ * inset due to render-scale rounding, but visually matches the SVG
+ * panel padding so HTML overlays and SVG panels speak one inset
+ * vocabulary.
+ *
+ * Test scope:
+ *   1. Chrome strip's right edge sits at ~16 CSS px from container
+ *      right edge (allow ±2 px sub-pixel slop).
+ *   2. Chrome strip's bottom edge sits at ~16 CSS px from container
+ *      bottom edge (±2 slop).
+ *   3. Minimap (mounted after zoom-in × 3): right edge at ~16 CSS px.
+ *   4. R255 chrome-strip semantic gap intact: fleet→view gap still ≥ 11.
+ */
+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]',         { timeout: 10000 });
+await page.waitForSelector('[data-topo-wrapper]',        { timeout: 10000 });
+await page.waitForTimeout(300);
+
+const beforeMinimap = await page.evaluate(() => {
+  const wrapper = document.querySelector('[data-topo-wrapper]');
+  const chrome  = document.querySelector('[data-topo-chrome]');
+  const fleet   = document.querySelector('[data-topo-chrome-fleet-group-trailer]');
+  const view    = document.querySelector('[data-topo-chrome-view-group-leader]');
+  const wrR = wrapper?.getBoundingClientRect() ?? null;
+  const chR = chrome?.getBoundingClientRect()  ?? null;
+  return {
+    wrapperRight:  wrR ? wrR.right  : null,
+    wrapperBottom: wrR ? wrR.bottom : null,
+    chromeRight:   chR ? chR.right  : null,
+    chromeBottom:  chR ? chR.bottom : null,
+    fleetRight:    fleet ? fleet.getBoundingClientRect().right : null,
+    viewLeft:      view  ? view.getBoundingClientRect().left   : null,
+  };
+});
+
+// Zoom in to force minimap mount
+for (let i = 0; i < 3; i++) {
+  await page.locator('[data-topo-chrome-zoom-in]').click();
+  await page.waitForTimeout(120);
+}
+await page.waitForSelector('[data-topo-minimap]', { timeout: 5000 });
+await page.waitForTimeout(300);
+
+const minimapProbe = await page.evaluate(() => {
+  const wrapper = document.querySelector('[data-topo-wrapper]');
+  const mm      = document.querySelector('[data-topo-minimap]');
+  const wrR = wrapper?.getBoundingClientRect() ?? null;
+  const mmR = mm?.getBoundingClientRect()      ?? null;
+  return {
+    wrapperRight: wrR ? wrR.right : null,
+    minimapRight: mmR ? mmR.right : null,
+  };
+});
+await browser.close();
+
+const chromeRightOffset  = (beforeMinimap.wrapperRight  != null && beforeMinimap.chromeRight  != null)
+  ? (beforeMinimap.wrapperRight - beforeMinimap.chromeRight) : null;
+const chromeBottomOffset = (beforeMinimap.wrapperBottom != null && beforeMinimap.chromeBottom != null)
+  ? (beforeMinimap.wrapperBottom - beforeMinimap.chromeBottom) : null;
+const minimapRightOffset = (minimapProbe.wrapperRight   != null && minimapProbe.minimapRight  != null)
+  ? (minimapProbe.wrapperRight - minimapProbe.minimapRight) : null;
+const fleetToViewGap     = (beforeMinimap.fleetRight    != null && beforeMinimap.viewLeft     != null)
+  ? (beforeMinimap.viewLeft - beforeMinimap.fleetRight) : null;
+
+const inWindow = (v, target, slop) => v != null && Math.abs(v - target) <= slop;
+
+const results = {
+  chrome_right_at_16:         inWindow(chromeRightOffset,  16, 2),
+  chrome_bottom_at_16:        inWindow(chromeBottomOffset, 16, 2),
+  minimap_right_at_16:        inWindow(minimapRightOffset, 16, 2),
+  r255_fleet_view_gap_intact: fleetToViewGap != null && fleetToViewGap >= 11,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} HTML overlay padding unify:`, JSON.stringify(results),
+  '\n  chrome right offset:',  chromeRightOffset,  '/ bottom:', chromeBottomOffset,
+  '\n  minimap right offset:', minimapRightOffset,
+  '\n  R255 fleet→view gap:',  fleetToViewGap);
+process.exit(ok ? 0 : 1);

package/scripts/topo-hub-a11y-test.mjs

@@ -0,0 +1,112 @@
+/* Round 159 verification: hub <g> gains keyboard a11y.
+ *
+ * R151-R157 a11y sweep covered nodes, group labels, edge badges,
+ * recent rows, legend rows, chrome buttons, minimap, chip-row.
+ * R158 named the canvas root. The hub <g> — the most visually
+ * prominent interactive element on the canvas (R39 enlarged,
+ * R43 tooltip, R52 click-to-fitView, R115 hover ring) — was the
+ * only major interactive R151-R157 skipped.
+ *
+ * R159 closes that gap with the same standard pattern:
+ *   role="button"
+ *   tabIndex={0}
+ *   aria-label="Network hub · N online · K working · M links — Enter to fit view"
+ *   className="anet-topo-svg-focus" (R156 cyan focus ring)
+ *   onKeyDown(Enter/Space) → fitView() + ripple
+ *
+ * Test:
+ *   1. Mock 3 working + 2 idle sessions + zoom in (so fit-to-view
+ *      has a visible effect — zoom level moves away from 100%)
+ *   2. Assert role / tabIndex / aria-label / className on hub
+ *   3. Focus hub + Enter → zoom resets to 100%
+ *   4. Confirm aria-label mentions counts + Enter
+ */
+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');
+    sessionStorage.setItem('anet_v3_auth', '1');
+    // R159 hub is gated to layout === 'ring' (line 2946 — grid uses
+    // group boxes, no central hub). Force ring.
+    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, status) => ({
+    alias, status, 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('agents-a1', 'working'), mk('agents-a2', 'working'), mk('agents-a3', 'working'),
+    mk('infra-b1', 'idle'), mk('infra-b2', 'idle'),
+  ] } });
+});
+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 === 5, { timeout: 30000 });
+await page.waitForSelector('[data-topo-hub]', { timeout: 10000 });
+await page.waitForTimeout(400);
+
+// Probe ARIA before any interaction
+const probe = await page.evaluate(() => {
+  const el = document.querySelector('[data-topo-hub]');
+  if (!el) return null;
+  return {
+    tagName:   el.tagName.toLowerCase(),
+    role:      el.getAttribute('role'),
+    tabIndex:  el.getAttribute('tabindex'),
+    ariaLabel: el.getAttribute('aria-label'),
+    className: el.getAttribute('class') || '',
+  };
+});
+
+// Zoom in twice so fitView has a visible effect
+await page.keyboard.press('+');
+await page.keyboard.press('+');
+await page.waitForTimeout(250);
+const zoomBefore = await page.evaluate(() =>
+  document.querySelector('[data-topo-chrome-zoom-level]')?.textContent?.trim());
+
+// Focus hub + Enter → fitView resets zoom to 100%
+await page.locator('[data-topo-hub]').focus();
+await page.keyboard.press('Enter');
+await page.waitForTimeout(350);
+const zoomAfter = await page.evaluate(() =>
+  document.querySelector('[data-topo-chrome-zoom-level]')?.textContent?.trim());
+
+await browser.close();
+
+const label = probe?.ariaLabel || '';
+const results = {
+  hub_found:               probe !== null,
+  is_g:                    probe?.tagName === 'g',
+  role_button:             probe?.role === 'button',
+  tabIndex_0:              probe?.tabIndex === '0',
+  label_mentions_online:   /5 online/.test(label),
+  label_mentions_working:  /3 working/.test(label),
+  label_mentions_enter:    /Enter to fit view/.test(label),
+  has_focus_class:         (probe?.className || '').includes('anet-topo-svg-focus'),
+  zoomedBefore:            zoomBefore !== '100%',
+  enter_resetsZoom:        zoomAfter === '100%',
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} hub a11y:`, JSON.stringify(results),
+  `\n  probe=`, probe,
+  `\n  zoomBefore=${zoomBefore}  zoomAfter=${zoomAfter}`);
+process.exit(ok ? 0 : 1);

package/scripts/topo-hub-busyness-test.mjs

@@ -0,0 +1,100 @@
+/* Round 84 verification: hub-halo breath amplitude + tempo reflect
+ * `workingCount`. Buckets: 0 / 1-2 / 3-5 / 6+. An idle fleet keeps
+ * the original 0.32→0.52 (light) / 0.08→0.16 (dark) cycle over 4s;
+ * a busy fleet pulses faster with a higher peak. Pure visual breath
+ * — geometry unchanged, overlap test untouched.
+ *
+ * Drive workingCount via mocked /api/hub/status sessions, then read
+ * the SMIL `<animate>` attributes off the hub halo. The bucket gets
+ * surfaced as `data-hub-busyness=0..3` for stable assertion without
+ * parsing values strings.
+ */
+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 (workers) => {
+  const ctx = await browser.newContext({ viewport: { width: 1400, height: 1200 } });
+  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 {}
+  });
+  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 < workers; i++) {
+      sessions.push({ alias: `wkr${i}`, 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 });
+    }
+    sessions.push({ alias: 'idl', 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,
+    workers + 1, { timeout: 30000 });
+  await page.waitForTimeout(400);
+
+  const data = await page.evaluate(() => {
+    const halo = document.querySelector('[data-hub-busyness]');
+    const ani  = halo?.querySelector('animate');
+    return {
+      busy:    halo?.getAttribute('data-hub-busyness'),
+      values:  ani?.getAttribute('values') || null,
+      dur:     ani?.getAttribute('dur') || null,
+    };
+  });
+  await ctx.close();
+  return data;
+};
+
+// Helper: parse "trough;peak;trough" into [trough, peak].
+const parseValues = (v) => v ? v.split(';').map(Number) : [];
+const peakOf = (v) => Math.max(...parseValues(v));
+const durOf  = (s) => s ? parseFloat(s.replace('s', '')) : 0;
+
+const b0 = await probe(0);   // idle only
+const b1 = await probe(1);   // 1 worker → bucket 1
+const b2 = await probe(4);   // 4 workers → bucket 2
+const b3 = await probe(7);   // 7 workers → bucket 3
+await browser.close();
+
+const results = {
+  b0_bucket:        b0.busy === '0',
+  b1_bucket:        b1.busy === '1',
+  b2_bucket:        b2.busy === '2',
+  b3_bucket:        b3.busy === '3',
+  // Peak climbs with bucket — dark theme values.
+  peak_monotonic:   peakOf(b0.values) < peakOf(b1.values) &&
+                    peakOf(b1.values) < peakOf(b2.values) &&
+                    peakOf(b2.values) < peakOf(b3.values),
+  // Duration shortens with bucket.
+  dur_monotonic:    durOf(b0.dur) > durOf(b1.dur) &&
+                    durOf(b1.dur) > durOf(b2.dur) &&
+                    durOf(b2.dur) > durOf(b3.dur),
+  // Idle baseline preserved.
+  b0_idleDur_4s:    durOf(b0.dur) === 4,
+  // Busy cap respected.
+  b3_capped_24s:    durOf(b3.dur) === 2.4,
+  // All have the same trough (preserving the rest baseline).
+  trough_constant:  parseValues(b0.values)[0] === parseValues(b3.values)[0],
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} hub busyness:`, JSON.stringify(results),
+  `\n  b0=`, b0,
+  `\n  b1=`, b1,
+  `\n  b2=`, b2,
+  `\n  b3=`, b3);
+process.exit(ok ? 0 : 1);

package/scripts/topo-hub-center-crossfade-test.mjs

@@ -0,0 +1,124 @@
+/* Round 213 verification: hub centre crossfades the workingCount
+ * digit and the decorative highlight when count crosses zero,
+ * instead of mount/unmount snap.
+ *
+ * Pre-R213 a fleet going workingCount 0 → 1 swapped highlight
+ * circle (R130 decorative) ↔ digit text in a single frame —
+ * visible flash at the canvas's focal point. R213 always-mounts
+ * both, opacity-gates them, and adds `transition: opacity 300ms
+ * ease-out` so they crossfade. Same R181/R182/R183 always-mount
+ * pattern applied at the hub-center scope.
+ *
+ * Test scenarios (cyber dark):
+ *   A. 4 working sessions (workingCount=4):
+ *      · digit visible (opacity 1), data-...-visible='true'
+ *      · highlight hidden (opacity 0), data-...-visible='false'
+ *      · BOTH elements present in DOM (always-mount)
+ *      · Both have inline transition with 'opacity 300ms'
+ *   B. 4 idle sessions (workingCount=0):
+ *      · digit hidden (opacity 0), data-...-visible='false'
+ *      · highlight visible (opacity 0.9), data-...-visible='true'
+ *      · BOTH still in DOM
+ */
+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 pageFor(allStatus) {
+  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: allStatus, 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.waitForTimeout(300);
+  return page;
+}
+
+const probe = async (page) => page.evaluate(() => {
+  const digit = document.querySelector('[data-topo-hub-working-count]');
+  const high  = document.querySelector('[data-topo-hub-highlight]');
+  function px(el) {
+    if (!el) return null;
+    const cs = getComputedStyle(el);
+    return {
+      visible:    el.getAttribute(el === document.querySelector('[data-topo-hub-working-count]')
+                  ? 'data-topo-hub-working-count-visible'
+                  : 'data-topo-hub-highlight-visible'),
+      opacity:    parseFloat(cs.opacity),
+      transition: el.style.transition,
+    };
+  }
+  return {
+    digitPresent: !!digit,
+    highlightPresent: !!high,
+    digit:     px(digit),
+    highlight: px(high),
+    digitText: digit?.textContent,
+  };
+});
+
+// Scenario A: all working → digit visible, highlight hidden
+const pageA = await pageFor('working');
+const probeA = await probe(pageA);
+await pageA.close();
+
+// Scenario B: all idle (workingCount=0) → highlight visible, digit hidden
+const pageB = await pageFor('idle');
+const probeB = await probe(pageB);
+await pageB.close();
+await browser.close();
+
+const near = (got, want, tol = 0.05) => Math.abs(got - want) < tol;
+const hasOpacityT = (s) => /opacity\s+(?:300ms|0\.3s)/.test(s || '');
+
+const results = {
+  // A: working
+  A_digit_in_dom:           probeA.digitPresent,
+  A_highlight_in_dom:       probeA.highlightPresent,
+  A_digit_visible:          probeA.digit?.visible === 'true',
+  A_digit_opacity_1:        near(probeA.digit?.opacity ?? 0, 1),
+  A_highlight_hidden:       probeA.highlight?.visible === 'false',
+  A_highlight_opacity_0:    near(probeA.highlight?.opacity ?? 1, 0),
+  A_digit_text_4:           probeA.digitText === '4',
+
+  // B: idle (workingCount=0)
+  B_digit_in_dom:           probeB.digitPresent,
+  B_highlight_in_dom:       probeB.highlightPresent,
+  B_digit_hidden:           probeB.digit?.visible === 'false',
+  B_digit_opacity_0:        near(probeB.digit?.opacity ?? 1, 0),
+  B_highlight_visible:      probeB.highlight?.visible === 'true',
+  B_highlight_opacity_0p9:  near(probeB.highlight?.opacity ?? 0, 0.9),
+  B_digit_text_0:           probeB.digitText === '0',
+
+  // Both transitions present
+  A_digit_transition:       hasOpacityT(probeA.digit?.transition),
+  A_highlight_transition:   hasOpacityT(probeA.highlight?.transition),
+  B_digit_transition:       hasOpacityT(probeB.digit?.transition),
+  B_highlight_transition:   hasOpacityT(probeB.highlight?.transition),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} hub-center crossfade:`, JSON.stringify(results),
+  `\n  probeA (working=4):`, probeA,
+  `\n  probeB (working=0):`, probeB);
+process.exit(ok ? 0 : 1);

package/scripts/topo-hub-click-fit-test.mjs

@@ -0,0 +1,137 @@
+/* Round 52 verification: clicking the central hub triggers fitView() and
+ * shows a click-ripple. The hub was previously decoration; now it's the
+ * "re-center" affordance for users who don't know the `f` shortcut.
+ *
+ * Steps:
+ *  - Zoom + pan the topology to a non-default view (Cmd+= twice + drag).
+ *    Confirm the zoom group's transform shifted off identity.
+ *  - Click the hub. Assert:
+ *      1. the zoom group's transform returns to a fitted state (zoom and
+ *         translate change), i.e. the view changed back toward identity-
+ *         or-fit;
+ *      2. a transient ripple <circle> shows up at the hub center, then
+ *         vanishes within ~800ms.
+ *  - Confirm the hub's <title> mentions "click to fit view".
+ */
+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: 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();
+await ctx.route('**/api/hub/status*', async (route) => {
+  const r = await route.fetch();
+  const b = await r.json();
+  const nid = (b.sessions || [])[0]?.network_id || 'default';
+  const sessions = ['alpha', 'beta', 'gamma'].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/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.waitForSelector('g[data-topo-hub]', { timeout: 30000 });
+await page.waitForTimeout(500);
+
+// Read the hub <title> to verify the hint text.
+const hubTitle = await page.evaluate(() => {
+  return document.querySelector('g[data-topo-hub] title')?.textContent || '';
+});
+
+// Find the zoom/pan wrapper <g> (the one whose transform attribute holds
+// the scale + translate string). The TopoGraph wraps all canvas content
+// in a <g> with transform="translate(x, y) scale(zoom)" at the panel root.
+// Grab the first child <g> under the SVG that carries a `transform` with
+// a `scale(` token — that's our zoom group.
+const readTransform = () => page.evaluate(() => {
+  const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+  for (const g of svg.querySelectorAll(':scope > g')) {
+    const t = g.getAttribute('transform') || '';
+    if (t.includes('scale(')) return t;
+  }
+  return null;
+});
+
+const baseTransform = await readTransform();
+
+// Nudge zoom by simulating Ctrl+= twice via keyboard shortcut. The
+// keymap maps '+' to zoomBy; press 'Equal' with the right modifier so
+// browsers see '+'.
+await page.keyboard.press('+');
+await page.keyboard.press('+');
+await page.keyboard.press('+');
+await page.waitForTimeout(150);
+const zoomedTransform = await readTransform();
+
+// Confirm the zoom transform actually changed.
+const zoomChanged = baseTransform !== zoomedTransform;
+
+// Click the hub center. Locator-based click hits the union bbox edge and
+// gets intercepted by the SVG panel rect (which must keep pointer events
+// for canvas pan). Sample the inner core circle (r=10 at viewBox 500,330)
+// via getScreenCTM and click that on-screen point directly.
+const hubCenter = await page.evaluate(() => {
+  const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+  const core = [...svg.querySelectorAll('g[data-topo-hub] circle')].find(
+    c => c.getAttribute('r') === '10'
+  );
+  if (!core) return null;
+  const ctm = core.getScreenCTM();
+  const cx = +core.getAttribute('cx');
+  const cy = +core.getAttribute('cy');
+  return { x: cx * ctm.a + cy * ctm.c + ctm.e, y: cx * ctm.b + cy * ctm.d + ctm.f };
+});
+if (!hubCenter) { console.log('❌ hub core circle not found'); process.exit(1); }
+await page.mouse.click(hubCenter.x, hubCenter.y);
+await page.waitForTimeout(150);
+const afterClickTransform = await readTransform();
+const ripplePresent = await page.evaluate(() => {
+  const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+  // The click ripple is a <circle> with stroke-width="2" + an <animate>.
+  const ripples = [...svg.querySelectorAll('circle')].filter(c => {
+    const sw = c.getAttribute('stroke-width');
+    return sw === '2' && c.querySelector('animate[attributeName="r"]');
+  });
+  return ripples.length > 0;
+});
+
+await page.waitForTimeout(800);
+const rippleGone = await page.evaluate(() => {
+  const svg = document.querySelector('svg[viewBox="0 0 1000 680"]');
+  const ripples = [...svg.querySelectorAll('circle')].filter(c => {
+    const sw = c.getAttribute('stroke-width');
+    return sw === '2' && c.querySelector('animate[attributeName="r"]');
+  });
+  return ripples.length === 0;
+});
+
+await browser.close();
+
+const results = {
+  hubTitleHasFitHint: /click to fit view/i.test(hubTitle),
+  zoomShifted: zoomChanged,
+  hubClickRestoredView: afterClickTransform !== zoomedTransform,
+  ripplePresentDuringClick: ripplePresent,
+  rippleClearsAfter600ms: rippleGone,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} hub click fit:`, JSON.stringify(results),
+  `\n  hubTitle=${JSON.stringify(hubTitle)}`,
+  `\n  base    =${baseTransform}`,
+  `\n  zoomed  =${zoomedTransform}`,
+  `\n  fitBack =${afterClickTransform}`);
+process.exit(ok ? 0 : 1);