@sleep2agi/agent-network-dashboard 0.4.6 → 0.5.0

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

@@ -0,0 +1,81 @@
+/* Round 137 verification: HelpOverlay catches up on R136 — the
+ * "N active links" chip in the chip row got a real onClick →
+ * /messages navigation (R136 fixed the cursor-pointer-lying bug:
+ * cursor:pointer existed since R77, but no click handler).
+ *
+ * Pairs with R134's footer-nav entry at a different surface:
+ *   R133 footer-nav: canvas-side panel, only when flowLinks > 3
+ *   R136 chip-nav:   chip row, whenever flowLinks > 0 (broader)
+ *
+ * Stacks 13 docs generations now: R137 → R134 → R123 → R118 →
+ * R109 → R91 → R87 → R81 → R78 → R74 → R70 → R65 → R59. Any
+ * regression that drops an entry is caught by one of these.
+ */
+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 = {
+  r137_clickChip:      has('See all flows — click the "N active links" chip in the chip row (R136)'),
+  // R134 prior
+  r134_clickFooter:    has('See all flows — click "+ N more flows" in the recent-signal panel (R133)'),
+  // R123 prior
+  r123_clickBadge:     has('Pin a flow filter from the canvas — click an edge midpoint count badge (R121)'),
+  // R118 priors
+  r118_rowClickPin:    has('Pin a flow filter — click a recent-signal row to lock the edge (R116)'),
+  r118_cmdkClearEdge:  has('Clear edge pin only via palette → "Clear topology edge pin" (R117)'),
+  // R109 prior
+  r109_pinVendor:      has('Pin vendor: Anthropic/OpenAI/书生 via palette → "Pin topology filter…" (R108)'),
+  // R91 prior
+  r91_clickVendor:     has('Pin a vendor filter — click A/O/书/? in the chip row (R88)'),
+  // R87 prior
+  r87_segHover:        has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  // R81 prior
+  r81_vendorChip:      has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 prior
+  r78_pillBodyClick:   has('Clear filter — click anywhere on the pill body (R73)'),
+  // R74 prior
+  r74_cmdkLayout:      has('Toggle layout / Fit canvas via palette (R74)'),
+  // R70 prior
+  r70_cmdkPin:         has('(R69)'),
+  // R65 prior
+  r65_groupClick:      has('Pin a team focus (R63)'),
+  // R59 prior
+  r59_clickHub:        has('Fit topology to canvas (R52)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R137:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,86 @@
+/* Round 141 verification: HelpOverlay catches up on R139 + R140 —
+ * two new chip-row gestures landed since R137's last docs update.
+ *
+ *   R139: click "N working" chip → pin pinnedStatus='working'
+ *         (composes with R60 pressure-bar + R61 legend)
+ *   R140: click "N online" chip → /nodes
+ *         (pin 'idle' would misrepresent the chip semantically)
+ *
+ * Two entries added this round — usually one, but two gestures
+ * landed in consecutive rounds R139/R140.
+ *
+ * Stacks 14 docs generations now: R141 (×2) → R137 → R134 → R123
+ * → R118 → R109 → 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 = {
+  // R141 NEW
+  r141_workingPin:     has('Pin "working" status — click "N working" in the chip row (R139)'),
+  r141_onlineNav:      has('Open the agent list — click "N online" in the chip row (R140)'),
+  // R137 prior
+  r137_clickChip:      has('See all flows — click the "N active links" chip in the chip row (R136)'),
+  // R134 prior
+  r134_clickFooter:    has('See all flows — click "+ N more flows" in the recent-signal panel (R133)'),
+  // R123 prior
+  r123_clickBadge:     has('Pin a flow filter from the canvas — click an edge midpoint count badge (R121)'),
+  // R118 priors
+  r118_rowClickPin:    has('Pin a flow filter — click a recent-signal row to lock the edge (R116)'),
+  r118_cmdkClearEdge:  has('Clear edge pin only via palette → "Clear topology edge pin" (R117)'),
+  // R109 prior
+  r109_pinVendor:      has('Pin vendor: Anthropic/OpenAI/书生 via palette → "Pin topology filter…" (R108)'),
+  // R91 prior
+  r91_clickVendor:     has('Pin a vendor filter — click A/O/书/? in the chip row (R88)'),
+  // R87 prior
+  r87_segHover:        has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  // R81 prior
+  r81_vendorChip:      has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 prior
+  r78_pillBodyClick:   has('Clear filter — click anywhere on the pill body (R73)'),
+  // R74 prior
+  r74_cmdkLayout:      has('Toggle layout / Fit canvas via palette (R74)'),
+  // R70 prior
+  r70_cmdkPin:         has('(R69)'),
+  // R65 prior
+  r65_groupClick:      has('Pin a team focus (R63)'),
+  // R59 prior
+  r59_clickHub:        has('Fit topology to canvas (R52)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R141:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,85 @@
+/* Round 153 verification: HelpOverlay catches up on R151 — keyboard
+ * chat-open on a focused node. First true new gesture since R141's
+ * R139/R140 chip catch-up (R142 / R143 / R144 / R145 / R146 / R147 /
+ * R148 / R149 / R150 were visual / motion / hover-tooltip refinements
+ * with no new user gestures; R152 added an onKeyDown to the group
+ * label but that's just the keyboard parallel of the existing R63
+ * click-group entry, so it doesn't earn its own line).
+ *
+ * Stacks 15 docs generations now: R153 → R141 (×2) → R137 → R134 →
+ * R123 → R118 → R109 → 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 = {
+  // R153 NEW — keyboard chat-open
+  r153_tabEnter:       has('Open chat on a focused node (also Space) — keyboard parallel of click-to-chat (R151)'),
+  // R141 priors (2 entries)
+  r141_workingPin:     has('Pin "working" status — click "N working" in the chip row (R139)'),
+  r141_onlineNav:      has('Open the agent list — click "N online" in the chip row (R140)'),
+  // R137 prior
+  r137_clickChip:      has('See all flows — click the "N active links" chip in the chip row (R136)'),
+  // R134 prior
+  r134_clickFooter:    has('See all flows — click "+ N more flows" in the recent-signal panel (R133)'),
+  // R123 prior
+  r123_clickBadge:     has('Pin a flow filter from the canvas — click an edge midpoint count badge (R121)'),
+  // R118 priors
+  r118_rowClickPin:    has('Pin a flow filter — click a recent-signal row to lock the edge (R116)'),
+  r118_cmdkClearEdge:  has('Clear edge pin only via palette → "Clear topology edge pin" (R117)'),
+  // R109 prior
+  r109_pinVendor:      has('Pin vendor: Anthropic/OpenAI/书生 via palette → "Pin topology filter…" (R108)'),
+  // R91 prior
+  r91_clickVendor:     has('Pin a vendor filter — click A/O/书/? in the chip row (R88)'),
+  // R87 prior
+  r87_segHover:        has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  // R81 prior
+  r81_vendorChip:      has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 prior
+  r78_pillBodyClick:   has('Clear filter — click anywhere on the pill body (R73)'),
+  // R74 prior
+  r74_cmdkLayout:      has('Toggle layout / Fit canvas via palette (R74)'),
+  // R70 prior
+  r70_cmdkPin:         has('(R69)'),
+  // R65 prior
+  r65_groupClick:      has('Pin a team focus (R63)'),
+  // R59 prior
+  r59_clickHub:        has('Fit topology to canvas (R52)'),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} help overlay R153:`, 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);