@sleep2agi/agent-network-dashboard 0.4.6-preview.27 → 0.4.6-preview.271

package/scripts/topo-halo-breath-ease-test.mjs

@@ -0,0 +1,92 @@
+/* Round 244 verification: hub grounding halo (R84) AND node working
+ * halos (R112/R226) both pick up ease-in-out keySplines on their
+ * SMIL breath animates. The three breath surfaces on canvas — hub
+ * (R84+R244) + active-node pulse (R243) + working halos (R226+R244)
+ * — now share the same curve shape and feel.
+ *
+ * Test scope:
+ *   - hub grounding halo: probe [data-hub-busyness] → child
+ *     <animate> has calcMode='spline', keyTimes='0;0.5;1',
+ *     keySplines='0.42 0 0.58 1;0.42 0 0.58 1'
+ *   - working halos: probe all [data-node-halo-breath='on'] →
+ *     each child <animate> has same calcMode/keyTimes/keySplines
+ *
+ * Scenario: 4 working agents (hub busy bucket > 0 → halo breath
+ * is present; all 4 nodes are working → 4 halo breath animates).
+ */
+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*', (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-hub-busyness]', { timeout: 10000, state: 'attached' });
+await page.waitForTimeout(300);
+
+const out = await page.evaluate(() => {
+  const probeAnimate = (parent) => {
+    const a = parent?.querySelector('animate');
+    if (!a) return null;
+    return {
+      attr:       a.getAttribute('attributeName'),
+      calcMode:   a.getAttribute('calcMode'),
+      keyTimes:   a.getAttribute('keyTimes'),
+      keySplines: a.getAttribute('keySplines'),
+      dur:        a.getAttribute('dur'),
+    };
+  };
+  const hub = document.querySelector('[data-hub-busyness]');
+  const halos = Array.from(document.querySelectorAll('[data-node-halo-breath="on"]'));
+  return {
+    hub: probeAnimate(hub),
+    halos: halos.map(h => probeAnimate(h)),
+  };
+});
+await browser.close();
+
+const EASE_INOUT = '0.42 0 0.58 1;0.42 0 0.58 1';
+const KEY_TIMES = '0;0.5;1';
+
+const animateOK = (a) =>
+  a &&
+  a.attr === 'opacity' &&
+  a.calcMode === 'spline' &&
+  a.keyTimes === KEY_TIMES &&
+  a.keySplines === EASE_INOUT;
+
+const results = {
+  hub_animate_present:   out.hub !== null,
+  hub_ease_in_out:       animateOK(out.hub),
+  halos_count_4:         out.halos.length === 4,
+  halos_all_present:     out.halos.every(h => h !== null),
+  halos_all_ease_in_out: out.halos.every(animateOK),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} halo breath ease:`, JSON.stringify(results),
+  '\n  hub:  ', out.hub,
+  '\n  halos:', out.halos);
+process.exit(ok ? 0 : 1);

package/scripts/topo-halo-breath-stagger-test.mjs

@@ -0,0 +1,89 @@
+/* Round 226 verification: working-halo breath gets per-node phase
+ * stagger via SMIL `begin="-{nodeIdx * 0.37 % 3}s"`. Pre-R226 all
+ * working halos pulsed in lockstep at the same instant; R226 desyncs
+ * them organically.
+ *
+ * Test: 4 working agents → probe each [data-node-halo-breath='on']
+ * circle for its `<animate>` child's `begin` attribute. Expect:
+ *   - Each animate has a `begin` matching '-N.NNNs'
+ *   - All four offsets are distinct (no two halos start at the
+ *     same phase)
+ *   - The data-node-halo-breath-offset attribute matches the
+ *     `begin` magnitude (post-strip of '-' and 's')
+ *   - The dur stays '3s' (period unchanged, only phase shifts)
+ *   - Reduced-motion test scope unchanged (gate still keeps SMIL
+ *     out for prefers-reduced-motion users)
+ */
+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*', (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('[data-node-halo-breath="on"]').length === 4, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const out = await page.evaluate(() => {
+  const halos = Array.from(document.querySelectorAll('[data-node-halo-breath="on"]'));
+  return halos.map((h) => {
+    const anim = h.querySelector('animate');
+    return {
+      offsetAttr: h.getAttribute('data-node-halo-breath-offset'),
+      begin:      anim?.getAttribute('begin') || null,
+      dur:        anim?.getAttribute('dur') || null,
+      attrName:   anim?.getAttribute('attributeName') || null,
+    };
+  });
+});
+await browser.close();
+
+const beginRe = /^-(\d+\.\d{3})s$/;
+const parsed = out.map((h) => {
+  const m = (h.begin || '').match(beginRe);
+  return {
+    ...h,
+    beginNum: m ? parseFloat(m[1]) : NaN,
+  };
+});
+
+// Expected: 4 halos, offsets (0 * 0.37) % 3, (1 * 0.37) % 3, etc.
+// = 0.000, 0.370, 0.740, 1.110 (each .toFixed(3))
+const expected = [0, 0.37, 0.74, 1.11];
+const close = (a, b) => Math.abs(a - b) < 0.005;
+
+const results = {
+  four_halos:           parsed.length === 4,
+  all_have_begin:       parsed.every(p => !Number.isNaN(p.beginNum)),
+  all_have_dur_3s:      parsed.every(p => p.dur === '3s'),
+  all_attr_opacity:     parsed.every(p => p.attrName === 'opacity'),
+  all_offsets_distinct: new Set(parsed.map(p => p.beginNum)).size === 4,
+  offsets_match_golden: parsed.every((p, i) => close(p.beginNum, expected[i])),
+  attr_matches_begin:   parsed.every((p) => p.offsetAttr === p.beginNum.toFixed(3)),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} halo breath stagger:`, JSON.stringify(results),
+  '\n  parsed:', parsed);
+process.exit(ok ? 0 : 1);

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-r118-test.mjs

@@ -0,0 +1,69 @@
+/* Round 118 verification: HelpOverlay catches up on R116 (recent-
+ * signal row click pins the edge) + R117 (Cmd+K clear-edge command).
+ * Continues the R59/R62/R65/R70/R78/R81/R87/R91/R109 cadence (~5-8
+ * rounds between syncs).
+ *
+ * Nine generations of help-overlay assertions stacked here — any
+ * future regression that drops an entry is caught by one of:
+ *   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 = {
+  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 priors
+  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)'),
+  // R81 priors
+  r81_vendorChip:      has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  // R78 / R74 / R70 / R65 / R59 priors — 10 generations
+  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 R118:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,69 @@
+/* Round 123 verification: HelpOverlay catches up on R121 — edge
+ * midpoint count badge became click-to-pin. R122's badge hover
+ * is the natural partner of R121 click; doesn't need its own
+ * entry. Continues the R59/R62/R65/R70/R78/R81/R87/R91/R109/R118
+ * cadence.
+ *
+ * Ten generations of help-overlay assertions stacked here — any
+ * future regression that drops an entry is caught by one of:
+ *   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 = {
+  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 priors
+  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)'),
+  // R87 / R81 / R78 / R74 / R70 / R65 / R59 priors — 11 generations
+  r87_segHover:        has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  r81_vendorChip:      has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  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 R123:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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

@@ -0,0 +1,74 @@
+/* Round 134 verification: HelpOverlay catches up on R133 — the
+ * recent-signal panel's "+ N more flows" truncation footer (R128)
+ * became a clickable navigation to /messages. First TopoGraph
+ * affordance that reaches OUT of the canvas, so it gets its own
+ * Help-overlay entry.
+ *
+ * R124-R132 were all passive visuals / motion / readouts with no
+ * new gestures, so R133 is the only entry since R123.
+ *
+ * Stacks 12 docs generations to catch any future regression that
+ * drops an entry: 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 = {
+  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 / R81 / R78 / R74 / R70 / R65 / R59 priors
+  r87_segHover:        has('Preview a status filter — hover a pressure-bar segment (R83)'),
+  r81_vendorChip:      has('Highlight one vendor — hover A/O/书/? in the chip row (R80)'),
+  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 R134:`, JSON.stringify(results),
+  `\n  items=`, items);
+process.exit(ok ? 0 : 1);

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