@sleep2agi/agent-network-dashboard 0.4.6-preview.12 → 0.4.6-preview.121

package/scripts/topo-group-status-pips-test.mjs

@@ -0,0 +1,103 @@
+/* Round 58 verification: group label includes a status-mix pip strip
+ * showing how many members are working / idle / offline.
+ *
+ * Sessions (mixed-status alpha team + singleton beta):
+ *   alpha1  — working
+ *   alpha2  — working
+ *   alpha3  — idle
+ *   alpha4  — offline
+ *   beta    — idle  (singleton, no group box)
+ *
+ * Grid layout draws a group box for alpha (4 members). Label should
+ * end in something like "alpha · 4 · 2w 1i 1o". Status pips render
+ * only when their count > 0, so a uniform group reads more simply.
+ */
+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(sessions) {
+  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', 'grid');
+      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 seeded = sessions.map(s => ({
+      alias: s.alias, status: s.status,
+      network_id: nid, project_dir: null,
+      created_at: s.status === 'offline' ? stale : fresh,
+      updated_at: s.status === 'offline' ? stale : fresh,
+      last_seen_at: s.status === 'offline' ? stale : fresh,
+    }));
+    await route.fulfill({ response: r, json: { ...b, sessions: seeded } });
+  });
+  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(c => document.querySelectorAll('g[data-node]').length === c, sessions.length, { timeout: 30000 });
+  await page.waitForTimeout(500);
+  const labels = await page.evaluate(() => {
+    const out = {};
+    for (const t of document.querySelectorAll('text[data-group-label]')) {
+      out[t.getAttribute('data-group-label')] = (t.textContent || '').trim();
+    }
+    return out;
+  });
+  await ctx.close();
+  return labels;
+}
+
+// Grouping is consecutive-run on the sorted [...online, ...offline] array,
+// so an offline member of the "alpha" prefix family ends up in a separate
+// band (it falls into the offline tier rather than joining the online
+// alpha group). All members that share a multi-member band are by
+// construction online, so the "offline pip" case is unreachable via the
+// group label and the test covers only the working/idle dimensions here.
+const mixed = await probe([
+  { alias: 'alpha1', status: 'working' },
+  { alias: 'alpha2', status: 'working' },
+  { alias: 'alpha3', status: 'idle' },
+  { alias: 'beta',   status: 'idle' },
+]);
+
+const allWorking = await probe([
+  { alias: 'gamma1', status: 'working' },
+  { alias: 'gamma2', status: 'working' },
+  { alias: 'gamma3', status: 'working' },
+  { alias: 'beta',   status: 'idle' },
+]);
+
+await browser.close();
+
+const alphaLabel = mixed.alpha || '';
+const gammaLabel = allWorking.gamma || '';
+
+const results = {
+  alpha_keyPresent:        /^alpha/.test(alphaLabel),
+  alpha_countCorrect:      /·\s*3/.test(alphaLabel),
+  alpha_workingPip:        /2w/.test(alphaLabel),
+  alpha_idlePip:           /1i/.test(alphaLabel),
+  alpha_noOfflinePip:      !/\d+o\b/.test(alphaLabel),
+  // Uniform-status group: only the working pip renders.
+  gamma_workingPip:        /3w/.test(gammaLabel),
+  gamma_noIdlePip:         !/\d+i\b/.test(gammaLabel),
+  gamma_noOfflinePip:      !/\d+o\b/.test(gammaLabel),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} group status pips:`, JSON.stringify(results),
+  `\n  alpha="${alphaLabel}"`,
+  `\n  gamma="${gammaLabel}"`);
+process.exit(ok ? 0 : 1);

package/scripts/topo-groupbox-live-test.mjs

@@ -0,0 +1,100 @@
+/* Round 85 verification: group-box perimeter "marches" when the group
+ * has at least one working member, and neither hover nor pin is
+ * active. Pin/hover already carry their own emphasis via solid stroke
+ * — adding marching ants on top would feel busy. So the live
+ * treatment is exclusive to the resting state of a working group.
+ *
+ * Drive 4 groups via mocked /api/hub/status:
+ *   alpha: 2 working    → live
+ *   beta:  2 idle       → static
+ *   gamma: 1 working + 1 idle → live
+ *   delta: 2 offline    → static
+ *
+ * Then verify pinning a live group drops it from the live class
+ * (mirrors R68 transient-priority ordering).
+ */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const browser = await chromium.launch({ headless: true });
+const ctx = await browser.newContext({ viewport: { width: 1400, height: 1500 } });
+await ctx.addCookies([{ name: 'anet_dashboard_session', value: `v3:${TOKEN}`, domain: '127.0.0.1', path: '/' }]);
+await ctx.addInitScript(() => {
+  try {
+    localStorage.setItem('anet-theme', 'cyber');
+    localStorage.setItem('anet-topo-layout', 'grid');
+    sessionStorage.setItem('anet_v3_auth', '1');
+    sessionStorage.removeItem('anet-topo-pinned-status');
+    sessionStorage.removeItem('anet-topo-pinned-group');
+  } 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('alpha1', 'working', fresh),
+    mk('alpha2', 'working', fresh),
+    mk('beta1',  'idle',    fresh),
+    mk('beta2',  'idle',    fresh),
+    mk('gamma1', 'working', fresh),
+    mk('gamma2', 'idle',    fresh),
+    mk('delta1', 'offline', stale10),
+    mk('delta2', '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('[data-group-box-live]').length >= 4, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const liveByGroup = () => page.evaluate(() => {
+  const out = {};
+  for (const g of document.querySelectorAll('g[data-group]')) {
+    const key  = g.getAttribute('data-group');
+    const rect = g.querySelector('rect[data-group-box-live]');
+    out[key] = {
+      live:   rect?.getAttribute('data-group-box-live'),
+      classy: !!rect?.classList.contains('anet-topo-groupbox-live'),
+    };
+  }
+  return out;
+});
+
+const before = await liveByGroup();
+
+// Pin alpha (which is currently live). After pinning, alpha should
+// drop the live class — R85 explicitly mutes the ambient marching
+// when a stronger emphasis (pin) is active.
+await page.locator('[data-group-label-hit="alpha"]').click();
+await page.waitForTimeout(250);
+const afterAlphaPin = await liveByGroup();
+
+await browser.close();
+
+const results = {
+  alpha_live:           before.alpha?.live === 'true' && before.alpha?.classy,
+  gamma_live:           before.gamma?.live === 'true' && before.gamma?.classy,
+  beta_static:          before.beta?.live  === 'false' && !before.beta?.classy,
+  delta_static:         before.delta?.live === 'false' && !before.delta?.classy,
+  alphaPin_dropsLive:   afterAlphaPin.alpha?.live  === 'false' && !afterAlphaPin.alpha?.classy,
+  alphaPin_gammaUnchanged: afterAlphaPin.gamma?.live === 'true' && afterAlphaPin.gamma?.classy,
+  alphaPin_betaUnchanged:  afterAlphaPin.beta?.live  === 'false',
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} groupbox-live:`, JSON.stringify(results),
+  `\n  before=`,        before,
+  `\n  afterAlphaPin=`, afterAlphaPin);
+process.exit(ok ? 0 : 1);

package/scripts/topo-groupbox-test.mjs

@@ -86,9 +86,11 @@ const results = {};
     return allGood;
   });
 
-  // label text present for each group
+  // label text present for each group. R19 appended " · N" and R58 appended
+  // status-mix pips ("2w 1i") to the same <text> element, so the textContent
+  // is now "A站· 4 2w 1i" rather than bare "A站". Match by prefix.
   const labels = await page.$$eval(`${svg} g[data-group] text`, els => els.map(e => (e.textContent || '').trim()));
-  results.gridLabels = ['A站', '书生', '通信'].every(g => labels.includes(g));
+  results.gridLabels = ['A站', '书生', '通信'].every(g => labels.some(l => l.startsWith(g)));
 
   await page.screenshot({ path: '/tmp/anet-issue-111/groupbox-grid-cyber.png' });
   await ctx.close();

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

@@ -0,0 +1,67 @@
+/* Round 109 verification: HelpOverlay catches up on R108 — palette
+ * gained pin-vendor commands (Anthropic/OpenAI/书生). Continues the
+ * R59/R62/R65/R70/R78/R81/R87/R91 docs-catch-up cadence.
+ *
+ * Stacks eight generations of help-overlay assertions — any future
+ * regression that drops an entry will be caught by one of:
+ *   R109 (this) → R91 → R87 → R81 → R78 → R74 → R70 → R65 → R59
+ */
+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'); sessionStorage.setItem('anet_v3_auth', '1'); } catch {}
+});
+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.waitForTimeout(800);
+
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const items = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  const groups = [...(dialog?.querySelectorAll('div') || [])];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  return active ? [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim()) : [];
+});
+
+await browser.close();
+
+const has = (s) => items.some(t => t.includes(s));
+const results = {
+  r109_pinVendor:       has('Pin vendor: Anthropic/OpenAI/书生 via palette → "Pin topology filter…" (R108)'),
+  // R91 priors
+  r91_clickVendor:      has('Pin a vendor filter — click A/O/书/? in the chip row (R88)'),
+  r91_clearVendor:      has('Clear vendor pin only via palette → "Clear topology vendor filter" (R90)'),
+  // R87 priors
+  r87_segHover:         has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  r87_groupLabelHover:  has('Preview a team focus — hover a group label (R86)'),
+  // R81 priors
+  r81_workingChip:      has('Highlight working nodes — chip-row sibling of legend (R79)'),
+  r81_vendorChip:       has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 / R74 / R70 / R65 / R59 priors — 8 generations now
+  r78_pillBodyClick:    has('Clear filter — click anywhere on the pill body (R73)'),
+  r74_cmdkLayout:       has('Toggle layout / Fit canvas via palette (R74)'),
+  r70_cmdkPin:          has('(R69)'),
+  r65_groupClick:       has('Pin a team focus (R63)'),
+  r62_pinChip:          has('Pin a status filter (R60/R61)'),
+  r59_clickHub:         has('Fit topology to canvas (R52)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R109:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,67 @@
+/* Round 59 verification: HelpOverlay topology section documents the new
+ * R52 (hub click → fit) / R55 (legend hover) / R56 (recent-signal hover)
+ * interactions. R41 dbl-click clarification is also expected.
+ *
+ *   Press "?" on the overview page → assert each of the three new entries
+ *   shows up under the "Topology canvas" group heading.
+ */
+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');
+    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();
+  await route.fulfill({ response: r, json: b });
+});
+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.waitForTimeout(800);
+
+// Open help overlay via `?` (Shift + /).
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const topology = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  if (!dialog) return null;
+  // Walk the group divs — each starts with the group title text. Pick the
+  // one that says "Topology canvas" and capture its `<li>` items.
+  const groups = [...dialog.querySelectorAll('div')];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  if (!active) return null;
+  return [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim());
+});
+
+await browser.close();
+if (!topology) { console.log('❌ topology group not found in help overlay'); process.exit(1); }
+
+const has = (s) => topology.some(t => t.includes(s));
+const results = {
+  hasHubClickEntry:     has('Fit topology to canvas (R52)'),
+  hasLegendHoverEntry:  has('Highlight nodes of a status (R55)'),
+  hasSignalHoverEntry:  has('Highlight one flow edge (R56)'),
+  hasDblClickClarified: has('(empty canvas only)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R59:`, JSON.stringify(results),
+  `\n  topology items=`, topology);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,64 @@
+/* Round 65 verification: HelpOverlay topology section catches up on
+ * R63 (group label pin) + R64 (active-filter pill ×).
+ *
+ *   Press "?" → assert both new entries render under "Topology canvas".
+ *   Also verify the R59/R62 prior entries still exist (no regression
+ *   in the section).
+ */
+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');
+    sessionStorage.setItem('anet_v3_auth', '1');
+  } catch {}
+});
+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.waitForTimeout(800);
+
+// Open help overlay via `?`.
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const items = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  if (!dialog) return [];
+  const groups = [...dialog.querySelectorAll('div')];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  if (!active) return [];
+  return [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim());
+});
+
+await browser.close();
+if (items.length === 0) { console.log('❌ topology section not found'); process.exit(1); }
+
+const has = (s) => items.some(t => t.includes(s));
+const results = {
+  r63_groupPin:      has('Pin a team focus (R63)'),
+  r64_clearOne:      has('Clear one filter (R64) — Esc clears all'),
+  // R59 priors still present (no regression in section)
+  r52_clickHub:      has('Fit topology to canvas (R52)'),
+  r55_legendHover:   has('Highlight nodes of a status (R55)'),
+  r56_signalHover:   has('Highlight one flow edge (R56)'),
+  r60_pinChip:       has('Pin a status filter (R60/R61)'),
+  r62_esc:           has('Clear pinned filter (R62)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R65:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,63 @@
+/* Round 70 verification: HelpOverlay topology section surfaces the R69
+ * Cmd+K palette pin actions. The 1 new entry sits alongside R65's R63
+ * + R64 entries; this test re-verifies the full chain so a future edit
+ * accidentally dropping any rung gets caught here.
+ */
+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');
+    sessionStorage.setItem('anet_v3_auth', '1');
+  } catch {}
+});
+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.waitForTimeout(800);
+
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const items = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  if (!dialog) return [];
+  const groups = [...dialog.querySelectorAll('div')];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  return active ? [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim()) : [];
+});
+
+await browser.close();
+if (items.length === 0) { console.log('❌ topology section not found'); process.exit(1); }
+
+const has = (s) => items.some(t => t.includes(s));
+const results = {
+  r70_cmdkPin:       has('Pin / clear filters via palette') && has('(R69)'),
+  // R65 priors
+  r63_groupPin:      has('Pin a team focus (R63)'),
+  r64_clearOne:      has('Clear one filter (R64)'),
+  // R62 priors
+  r60_pinChip:       has('Pin a status filter (R60/R61)'),
+  r62_esc:           has('Clear pinned filter (R62)'),
+  // R59 priors
+  r52_clickHub:      has('Fit topology to canvas (R52)'),
+  r55_legendHover:   has('Highlight nodes of a status (R55)'),
+  r56_signalHover:   has('Highlight one flow edge (R56)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R70:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,59 @@
+/* Round 78 verification: HelpOverlay surfaces the R73 (click pill body
+ * to clear) + R77 (hover N active links to brighten all flows) gestures.
+ * Both shipped as real user gestures but weren't in the discoverability
+ * surface.
+ */
+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'); sessionStorage.setItem('anet_v3_auth', '1'); } catch {}
+});
+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.waitForTimeout(800);
+
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const items = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  const groups = [...(dialog?.querySelectorAll('div') || [])];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  return active ? [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim()) : [];
+});
+
+await browser.close();
+
+const has = (s) => items.some(t => t.includes(s));
+const results = {
+  r78_pillBodyClick:   has('Clear filter — click anywhere on the pill body (R73)'),
+  r78_chipHover:       has('Brighten all active flows — hover'),
+  // R74 and R70 priors should still appear (no regression)
+  r74_cmdkLayout:      has('Toggle layout / Fit canvas via palette (R74)'),
+  r70_cmdkPin:         has('(R69)'),
+  // R65 priors
+  r63_groupPin:        has('Pin a team focus (R63)'),
+  r64_clearOne:        has('Clear one filter (R64)'),
+  // R59 priors
+  r52_clickHub:        has('Fit topology to canvas (R52)'),
+  r55_legendHover:     has('Highlight nodes of a status (R55)'),
+  r56_signalHover:     has('Highlight one flow edge (R56)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R78:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,58 @@
+/* Round 81 verification: HelpOverlay surfaces R79 (status chip hover) +
+ * R80 (vendor chip letter hover). Both gestures landed without entries
+ * in the discoverability surface. Continues the R59/R62/R65/R70/R78
+ * docs-catch-up cadence.
+ */
+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'); sessionStorage.setItem('anet_v3_auth', '1'); } catch {}
+});
+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.waitForTimeout(800);
+
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const items = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  const groups = [...(dialog?.querySelectorAll('div') || [])];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  return active ? [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim()) : [];
+});
+
+await browser.close();
+
+const has = (s) => items.some(t => t.includes(s));
+const results = {
+  r81_workingChip:    has('Highlight working nodes — chip-row sibling of legend (R79)'),
+  r81_vendorChip:     has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 priors
+  r73_pillBodyClick:  has('Clear filter — click anywhere on the pill body (R73)'),
+  r77_activeLinks:    has('Brighten all active flows — hover'),
+  // R74 / R70 / R65 / R59 priors
+  r74_cmdkLayout:     has('Toggle layout / Fit canvas via palette (R74)'),
+  r70_cmdkPin:        has('(R69)'),
+  r63_groupPin:       has('Pin a team focus (R63)'),
+  r60_pinChip:        has('Pin a status filter (R60/R61)'),
+  r52_clickHub:       has('Fit topology to canvas (R52)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R81:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,64 @@
+/* Round 87 verification: HelpOverlay catches up on R83 (pressure-bar
+ * segment hover preview) + R86 (group-label hover preview). Continues
+ * the R59/R62/R65/R70/R78/R81 docs-catch-up cadence (~5 rounds).
+ *
+ * Stacks five generations of help-overlay assertions — any future
+ * regression that drops an entry will be caught by one of:
+ *   R87 (this) → R81 → R78 → R74 → R70 → R65 → R59
+ */
+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'); sessionStorage.setItem('anet_v3_auth', '1'); } catch {}
+});
+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.waitForTimeout(800);
+
+await page.keyboard.press('?');
+await page.waitForSelector('[role="dialog"][aria-label="Keyboard shortcuts"]', { timeout: 5000 });
+
+const items = await page.evaluate(() => {
+  const dialog = document.querySelector('[role="dialog"][aria-label="Keyboard shortcuts"]');
+  const groups = [...(dialog?.querySelectorAll('div') || [])];
+  let active = null;
+  for (const g of groups) {
+    if (g.textContent && /^Topology canvas$/i.test(g.textContent.trim())) {
+      active = g.parentElement;
+      break;
+    }
+  }
+  return active ? [...active.querySelectorAll('li')].map(li => (li.textContent || '').trim()) : [];
+});
+
+await browser.close();
+
+const has = (s) => items.some(t => t.includes(s));
+const results = {
+  r87_segHover:       has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  r87_groupLabelHover: has('Preview a team focus — hover a group label (R86)'),
+  // R81 priors
+  r81_workingChip:    has('Highlight working nodes — chip-row sibling of legend (R79)'),
+  r81_vendorChip:     has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 priors
+  r78_pillBodyClick:  has('Clear filter — click anywhere on the pill body (R73)'),
+  r78_activeLinks:    has('Brighten all active flows — hover'),
+  // R74 / R70 / R65 / R59 priors — five generations of docs catch-up
+  r74_cmdkLayout:     has('Toggle layout / Fit canvas via palette (R74)'),
+  r70_cmdkPin:        has('(R69)'),
+  r65_groupClick:     has('Pin a team focus (R63)'),
+  r62_pinChip:        has('Pin a status filter (R60/R61)'),
+  r59_clickHub:       has('Fit topology to canvas (R52)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R87:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);