@sleep2agi/agent-network-dashboard 0.4.6 → 0.5.0

package/scripts/topo-vendor-chip-threshold-test.mjs

@@ -0,0 +1,78 @@
+/* Round 281 verification: vendor letters chip threshold tightened
+ * from `vendorDist.length > 1` to `vendorDist.length > 2`.
+ *
+ * Pre-R281: chip rendered whenever ≥2 vendor types existed in the
+ * fleet. For a typical Twitter demo (claude + gpt = 2 types), the
+ * chip rendered "A:N O:M" adding ~50-80px to the chip-row width.
+ *
+ * Post-R281: chip only renders when ≥3 vendor types. The typical
+ * 1-2 vendor case (most demos) hides the chip; only fleets with
+ * actual diverse multi-vendor composition (3+ vendor types) show it.
+ *
+ * Scenario A: 2 vendor types (claude + gpt) — chip should be ABSENT
+ * Scenario B: 3 vendor types (claude + gpt + InternLM) — chip PRESENT
+ */
+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 probeForScenario(sessions) {
+  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, model) => ({
+      alias, status: 'working', model, 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: sessions.map(s => mk(s.alias, s.model)) } });
+  });
+  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((n) => document.querySelectorAll('g[data-node]').length === n, sessions.length, { timeout: 30000 });
+  await page.waitForTimeout(400);
+  const result = await page.evaluate(() => {
+    const chips = document.querySelectorAll('[data-vendor-letter]');
+    return { chipCount: chips.length };
+  });
+  await ctx.close();
+  return result;
+}
+
+const twoVendors = await probeForScenario([
+  { alias: 'alpha', model: 'claude-opus-4' },
+  { alias: 'beta',  model: 'claude-sonnet-4' },
+  { alias: 'gamma', model: 'gpt-4o' },
+  { alias: 'delta', model: 'gpt-4' },
+]);
+
+const threeVendors = await probeForScenario([
+  { alias: 'alpha', model: 'claude-opus-4' },
+  { alias: 'beta',  model: 'gpt-4o' },
+  { alias: 'gamma', model: 'internlm/internlm2' },
+  { alias: 'delta', model: 'some-unknown' },
+]);
+
+await browser.close();
+
+const results = {
+  two_vendor_chip_absent:     twoVendors.chipCount === 0,
+  three_vendor_chip_present:  threeVendors.chipCount >= 3,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} vendor chip threshold:`, JSON.stringify(results),
+  '\n  2-vendor scenario chip count (expect 0):', twoVendors.chipCount,
+  '\n  3-vendor scenario chip count (expect >=3):', threeVendors.chipCount);
+process.exit(ok ? 0 : 1);

package/scripts/topo-vendor-chip-weight-test.mjs

@@ -0,0 +1,87 @@
+/* Round 314 verification: vendor letter chips (e.g. 'A:N', 'O:N')
+ * pick up font-medium (500), completing the R312-R313 'HTML-context
+ * data chip = font-medium' family. R313 covered the 3 main chips
+ * (working/online/active-links); R314 closes the chip-row weight
+ * sweep at the vendor letters.
+ *
+ * Test fixture: 3 vendor types (claude + gpt + intern) to surface
+ * the chip row per R281 threshold (vendorDist.length > 2).
+ *
+ * Contract:
+ *   - All [data-vendor-letter] chips have className containing
+ *     'font-medium' + 'tabular-nums'.
+ *   - Computed font-weight === 500 for each.
+ *   - R313 working/online/active chips still font-medium.
+ *   - R312 chrome zoom still font-medium.
+ *   - R311 recent count fw=600 + R309 row counts fw=600 + R294
+ *     pulse absent all preserved.
+ */
+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, model) => ({
+    alias, status: 'working', model, runtime: 'claude-code-cli',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  // 3 vendor types → R281 vendorDist.length > 2 threshold → chips render.
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('alpha', 'claude-opus-4'),
+    mk('beta',  'gpt-4o'),
+    mk('gamma', 'internlm/internlm2'),
+  ] } });
+});
+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.waitForSelector('[data-vendor-letter]', { timeout: 15000 });
+await page.waitForTimeout(300);
+
+const probe = await page.evaluate(() => {
+  const sel = (s) => document.querySelector(s);
+  const chips = [...document.querySelectorAll('[data-vendor-letter]')];
+  const samples = chips.map(c => ({
+    initial:    c.getAttribute('data-vendor-letter'),
+    className:  c.className,
+    fontWeight: getComputedStyle(c).fontWeight,
+  }));
+  return {
+    samples,
+    workingChipCls: sel('[data-working-chip]')?.className ?? '',
+    chromeZoomCls:  sel('[data-topo-chrome-zoom-level]')?.className ?? '',
+    recentCountFw:  sel('[data-recent-panel-count]')?.getAttribute('font-weight') ?? null,
+    rowWorkingFw:   sel('[data-legend-count="working"]')?.getAttribute('font-weight') ?? null,
+    pulseCount:     document.querySelectorAll('[data-pulse-wrapper]').length,
+  };
+});
+await browser.close();
+
+const results = {
+  vendor_chips_present:        probe.samples.length >= 3,
+  all_have_font_medium_cls:    probe.samples.every(s => s.className.includes('font-medium')),
+  all_have_tabular_nums_cls:   probe.samples.every(s => s.className.includes('tabular-nums')),
+  all_computed_fw_500:         probe.samples.every(s => String(s.fontWeight) === '500'),
+  r313_working_chip_fw_500:    probe.workingChipCls.includes('font-medium'),
+  r312_chrome_zoom_fw_500:     probe.chromeZoomCls.includes('font-medium'),
+  r311_recent_count_fw_600:    probe.recentCountFw === '600',
+  r309_row_working_fw_600:     probe.rowWorkingFw === '600',
+  r294_pulse_absent:           probe.pulseCount === 0,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} vendor chip weight:`, JSON.stringify(results),
+  '\n  vendor chips:', probe.samples.map(s => `${s.initial}=fw${s.fontWeight}`).join(', '));
+process.exit(ok ? 0 : 1);

package/scripts/topo-vendor-count-suffix-test.mjs

@@ -0,0 +1,95 @@
+/* Round 333 verification: vendor letter chip count suffix `:{N}`
+ * picks up two polishes:
+ *   1. text-gray-500 → text-gray-400 (R317 subordinate-text-lift family)
+ *   2. tabular-nums (digit width-lock when count crosses 9→10 etc)
+ *
+ * Both surface a new test attr `data-vendor-letter-count` on the
+ * suffix span.
+ *
+ * Contract:
+ *   - [data-vendor-letter-count-suffix] present (at least one vendor row).
+ *   - Its className contains both 'text-gray-400' and 'tabular-nums'.
+ *   - Computed fontVariantNumeric === 'tabular-nums'.
+ *   - R332 minimap rounded-lg + R330 wrapper rounded-xl regressions.
+ *   - R317 / R318 / R294 chrome + pulse regressions intact.
+ */
+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, model) => ({
+    alias, status: 'working', model, runtime: 'claude-code-cli',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  // R281 vendorDist threshold is `vendorDist.length > 2` — need 3+
+  // distinct vendor types to surface the vendor letter chip row.
+  // Anthropic + OpenAI + internlm = 3 distinct vendors (matches the
+  // pre-existing topo-vendor-chip-weight-test fixture pattern).
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('alpha', 'claude-opus-4'),
+    mk('beta',  'gpt-4o'),
+    mk('gamma', 'internlm/internlm2'),
+  ] } });
+});
+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' });
+// Wait for at least one data-vendor-letter (the parent chip) — the
+// child count suffix lands as a child whether or not the chip is in
+// the visible viewport. Use `state: attached` so the test passes when
+// the vendor chip exists in the DOM (chip-row rendered) even if any
+// individual responsive class hides one specific vendor.
+await page.waitForSelector('[data-vendor-letter]', { timeout: 15000, state: 'attached' });
+await page.waitForSelector('[data-vendor-letter-count-suffix]', { timeout: 5000, state: 'attached' });
+await page.waitForTimeout(300);
+
+const probe = await page.evaluate(() => {
+  const suffixes = Array.from(document.querySelectorAll('[data-vendor-letter-count-suffix]'));
+  return {
+    suffixCount:        suffixes.length,
+    suffixClasses:      suffixes.map(s => s.className),
+    suffixTabulars:     suffixes.map(s => getComputedStyle(s).fontVariantNumeric),
+    suffixTexts:        suffixes.map(s => s.textContent),
+    layoutInactiveCls:  document.querySelector('[data-topo-chrome-layout="grid"]')?.className ?? '',
+    layoutActiveCls:    document.querySelector('[data-topo-chrome-layout="ring"]')?.className ?? '',
+    pulseCount:         document.querySelectorAll('[data-pulse-wrapper]').length,
+    wrapperClass:       document.querySelector('[data-topo-wrapper]')?.className ?? '',
+  };
+});
+await browser.close();
+
+const hasTab = (s) => /tabular-nums/.test(s || '');
+const hasGray400 = (cls) => /(^|\s)text-gray-400(\s|$)/.test(cls || '');
+const hasTabClass = (cls) => /(^|\s)tabular-nums(\s|$)/.test(cls || '');
+
+const results = {
+  suffix_at_least_one:         probe.suffixCount >= 1,
+  all_have_gray_400:           probe.suffixClasses.every(hasGray400),
+  all_have_tabular_class:      probe.suffixClasses.every(hasTabClass),
+  all_have_computed_tabular:   probe.suffixTabulars.every(hasTab),
+  // R330 wrapper regression.
+  r330_wrapper_rounded_xl:     probe.wrapperClass.includes('rounded-xl'),
+  // R317 / R318 chrome regression.
+  r317_inactive_gray_400:      probe.layoutInactiveCls.includes('text-gray-400'),
+  r318_active_font_medium:     probe.layoutActiveCls.includes('font-medium'),
+  r294_pulse_absent:           probe.pulseCount === 0,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} vendor count suffix gray-400+tabular:`, JSON.stringify(results),
+  '\n  suffix texts:', probe.suffixTexts,
+  '\n  suffix tabular:', probe.suffixTabulars);
+process.exit(ok ? 0 : 1);

package/scripts/topo-vendor-letter-tooltip-test.mjs

@@ -0,0 +1,92 @@
+/* Round 101 verification: vendor-letter chip <span>s carry an alias-
+ * list tooltip. Completes the R97/R98/R99 info-density sweep — every
+ * surface that shows "X:N" should hover-explain which N.
+ *
+ * Fleet: 2 Claude (alpha, gamma), 2 GPT (beta, delta). Vendor chip
+ * shows "A:2 O:2". A letter's tooltip should list alpha, gamma;
+ * O letter's should list beta, delta. Pin state flips the trailing
+ * action hint ("click to pin" → "click again or Esc to clear").
+ */
+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');
+    sessionStorage.removeItem('anet-topo-pinned-vendor');
+  } 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, model) => ({
+    alias, status: 'idle', model, 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('alpha', 'claude-opus-4'),
+    mk('beta',  'gpt-5'),
+    mk('gamma', 'claude-opus-4'),
+    mk('delta', 'gpt-5'),
+  ] } });
+});
+await ctx.route('**/api/hub/messages*', (route) => route.fulfill({ json: { messages: [] } }));
+await ctx.route('**/api/hub/tasks*', (route) => route.fulfill({ json: { tasks: [] } }));
+const page = await ctx.newPage();
+await page.goto('http://127.0.0.1:3000/', { waitUntil: 'domcontentloaded' });
+await page.waitForFunction(() => document.querySelectorAll('g[data-node]').length === 4, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const read = (initial) => page.evaluate((i) => {
+  const el = document.querySelector(`[data-vendor-letter="${i}"]`);
+  if (!el) return null;
+  return {
+    title:   el.getAttribute('title') || '',
+    aliases: el.getAttribute('data-vendor-aliases') || '',
+    pinned:  el.getAttribute('data-vendor-pinned') || '',
+  };
+}, initial);
+
+const aSnap = await read('A');
+const oSnap = await read('O');
+
+// Pin A — title should flip.
+await page.locator('[data-vendor-letter="A"]').click();
+await page.mouse.move(10, 10);
+await page.waitForTimeout(250);
+const aPinned = await read('A');
+
+await browser.close();
+
+const sameSet = (csv, expected) => {
+  const got = new Set(csv.split(',').filter(Boolean));
+  const exp = new Set(expected);
+  return got.size === exp.size && [...exp].every(x => got.has(x));
+};
+
+const results = {
+  a_aliasesMatch:     sameSet(aSnap?.aliases || '', ['alpha', 'gamma']),
+  a_titleListsThem:   /alpha.*gamma|gamma.*alpha/.test(aSnap?.title || ''),
+  a_titleClickToPin:  /click to pin/.test(aSnap?.title || ''),
+  o_aliasesMatch:     sameSet(oSnap?.aliases || '', ['beta', 'delta']),
+  o_titleListsThem:   /beta.*delta|delta.*beta/.test(oSnap?.title || ''),
+  pinnedA_aliasesUnchanged: sameSet(aPinned?.aliases || '', ['alpha', 'gamma']),
+  pinnedA_titleHintFlipped: /click again or Esc to clear/.test(aPinned?.title || ''),
+  pinnedA_pinnedAttrTrue:   aPinned?.pinned === 'true',
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} vendor-letter tooltip:`, JSON.stringify(results),
+  `\n  A:`,       aSnap,
+  `\n  O:`,       oSnap,
+  `\n  A-pinned:`, aPinned);
+process.exit(ok ? 0 : 1);

package/scripts/topo-vendor-pill-test.mjs

@@ -0,0 +1,125 @@
+/* Round 89 verification: pinning a vendor renders a "filter: X · N ×"
+ * pill in the chip-row, mirroring R64 status + group pills. R88 added
+ * the pin but the affordance lived only on the letter — body-click /
+ * × button on a dedicated pill was missing. R89 closes that.
+ *
+ * Also verifies the stale-purge useEffect: if the fleet's vendor
+ * distribution loses the pinned vendor (last node disconnects), the
+ * pin clears automatically so the pill doesn't show "filter: A · 0"
+ * forever. Same defensive pattern pinnedGroup uses.
+ */
+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: 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');
+    sessionStorage.removeItem('anet-topo-pinned-status');
+    sessionStorage.removeItem('anet-topo-pinned-group');
+    sessionStorage.removeItem('anet-topo-pinned-vendor');
+  } catch {}
+});
+
+const fresh = new Date(Date.now() - 60 * 1000).toISOString();
+let dropGPT = false;
+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, model) => ({
+    alias, status: 'idle', model, runtime: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  const sessions = [
+    mk('alpha', 'claude-opus-4'),
+    mk('gamma', 'claude-opus-4'),
+  ];
+  if (!dropGPT) sessions.splice(1, 0, mk('beta', 'gpt-5'));
+  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('g[data-node]').length === 3, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const pill = () => page.evaluate(() => {
+  const p = document.querySelector('[data-active-filter="vendor"]');
+  if (!p) return null;
+  return {
+    text:  (p.textContent || '').trim(),
+    count: p.getAttribute('data-filter-match-count'),
+    color: getComputedStyle(p).color,
+  };
+});
+const storage = () => page.evaluate(() => sessionStorage.getItem('anet-topo-pinned-vendor'));
+
+// Pin O (gpt-5 → OpenAI) via click.
+const before = await pill();
+await page.locator('[data-vendor-letter="O"]').click();
+await page.mouse.move(10, 10);
+await page.waitForTimeout(250);
+const afterPinO = await pill();
+const afterPinOStorage = await storage();
+
+// Clicking the pill body clears the pin.
+await page.locator('[data-active-filter="vendor"]').click();
+await page.waitForTimeout(250);
+const afterBodyClick = await pill();
+
+// Pin A (Anthropic) — verify the × button works.
+await page.locator('[data-vendor-letter="A"]').click();
+await page.mouse.move(10, 10);
+await page.waitForTimeout(250);
+const afterPinA = await pill();
+await page.locator('[data-active-filter="vendor"] button').click();
+await page.waitForTimeout(250);
+const afterXButton = await pill();
+
+// Pin O again, then mock the GPT node away → stale-purge fires.
+await page.locator('[data-vendor-letter="O"]').click();
+await page.waitForTimeout(250);
+const beforePurge = await pill();
+dropGPT = true;
+// Force a refetch via swr revalidation — easiest is page.reload, but
+// that wipes sessionStorage. Instead, just await the next swr cycle
+// (5s by default). To speed things up, dispatch a focus event which
+// triggers swr revalidateOnFocus. We expect the pin to clear once
+// the vendor leaves the distribution.
+await page.evaluate(() => window.dispatchEvent(new Event('focus')));
+await page.waitForFunction(() => document.querySelectorAll('g[data-node]').length === 2, { timeout: 30000 });
+await page.waitForTimeout(400);
+const afterPurge = await pill();
+const afterPurgeStorage = await storage();
+
+await browser.close();
+
+const results = {
+  before_noPill:        before === null,
+  pinO_pillRendered:    afterPinO !== null && /filter:?\s*O/.test(afterPinO.text),
+  pinO_countCorrect:    afterPinO?.count === '1',
+  pinO_storage:         afterPinOStorage === 'O',
+  bodyClick_clears:     afterBodyClick === null,
+  pinA_pillRendered:    afterPinA !== null && /filter:?\s*A/.test(afterPinA.text),
+  pinA_countCorrect:    afterPinA?.count === '2',
+  xButton_clears:       afterXButton === null,
+  beforePurge_present:  beforePurge !== null && /filter:?\s*O/.test(beforePurge.text),
+  purge_pillGone:       afterPurge === null,
+  purge_storageGone:    afterPurgeStorage === null,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} vendor pill:`, JSON.stringify(results),
+  `\n  afterPinO=`,       afterPinO,
+  `\n  afterPinA=`,       afterPinA,
+  `\n  beforePurge=`,     beforePurge,
+  `\n  afterPurge=`,      afterPurge);
+process.exit(ok ? 0 : 1);

package/scripts/topo-vendor-pin-test.mjs

@@ -0,0 +1,125 @@
+/* Round 88 verification: clicking a vendor letter in the distribution
+ * chip toggles a sticky pin — closes the only filter dimension that
+ * still released on mouseleave (R60 status, R63 group, R69 Cmd+K all
+ * support pin). Composes via activeVendor = hoveredVendor ??
+ * pinnedVendor so hover still wins for spot comparison.
+ *
+ * Fleet: 2 Claude (alpha, gamma) + 1 GPT (beta). Click A → alpha + gamma
+ * stay bright across mouseleave; pinned-style boxShadow on the A
+ * letter; aria-pressed="true". Hover O while A pinned → transient O
+ * preview (alpha/gamma dim, beta lit); mouseleave → A pin restores.
+ * Esc clears the pin (R62/R63 universal-cancel extends to vendor).
+ * SessionStorage round-trips.
+ */
+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: 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');
+    sessionStorage.removeItem('anet-topo-pinned-status');
+    sessionStorage.removeItem('anet-topo-pinned-group');
+    sessionStorage.removeItem('anet-topo-pinned-vendor');
+  } 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 = [
+    { alias: 'alpha', 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 },
+    { alias: 'beta',  status: 'idle', model: 'gpt-5',         runtime: 'codex-cli',
+      network_id: nid, project_dir: null, created_at: fresh, updated_at: fresh, last_seen_at: fresh },
+    { alias: 'gamma', 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(() => document.querySelectorAll('g[data-node]').length === 3, { timeout: 30000 });
+await page.waitForTimeout(400);
+
+const ops = () => page.evaluate(() => {
+  const o = {};
+  for (const a of ['alpha', 'beta', 'gamma']) {
+    const g = document.querySelector(`g[data-node="${a}"]`);
+    o[a] = g ? +(g.style.opacity || '1') : null;
+  }
+  return o;
+});
+const meta = () => page.evaluate(() => {
+  const a = document.querySelector('[data-vendor-letter="A"]');
+  const o = document.querySelector('[data-vendor-letter="O"]');
+  return {
+    A: { pinned: a?.getAttribute('data-vendor-pinned'), aria: a?.getAttribute('aria-pressed'), shadow: (a?.getAttribute('style') || '').includes('inset') },
+    O: { pinned: o?.getAttribute('data-vendor-pinned'), aria: o?.getAttribute('aria-pressed'), shadow: (o?.getAttribute('style') || '').includes('inset') },
+  };
+});
+const storage = () => page.evaluate(() => sessionStorage.getItem('anet-topo-pinned-vendor'));
+
+const before     = await ops();
+const beforeMeta = await meta();
+
+// Click A to pin. Mouse moves away — pin survives.
+await page.locator('[data-vendor-letter="A"]').click();
+await page.mouse.move(10, 10);
+await page.waitForTimeout(300);
+const afterClickA    = await ops();
+const afterClickAMeta = await meta();
+const afterClickAStorage = await storage();
+
+// Hover O while A pinned — transient O preview wins.
+await page.locator('[data-vendor-letter="O"]').hover();
+await page.waitForTimeout(250);
+const hoverOWhilePinA = await ops();
+
+// Leave — A pin restores.
+await page.mouse.move(10, 10);
+await page.waitForTimeout(250);
+const leaveOWhilePinA = await ops();
+
+// Esc clears the vendor pin.
+await page.keyboard.press('Escape');
+await page.waitForTimeout(250);
+const afterEsc        = await ops();
+const afterEscMeta    = await meta();
+const afterEscStorage = await storage();
+
+await browser.close();
+
+const bright = (v) => v != null && v >= 0.55;
+const dim    = (v) => v != null && v < 0.4;
+const results = {
+  before_baseline:          bright(before.alpha) && bright(before.beta) && bright(before.gamma),
+  before_noPinMeta:         beforeMeta.A.pinned === 'false' && beforeMeta.A.aria === 'false' && !beforeMeta.A.shadow,
+  pinA_keepsClaudes:        bright(afterClickA.alpha) && bright(afterClickA.gamma),
+  pinA_dimsGPT:             dim(afterClickA.beta),
+  pinA_metaSet:             afterClickAMeta.A.pinned === 'true' && afterClickAMeta.A.aria === 'true' && afterClickAMeta.A.shadow,
+  pinA_storagePersisted:    afterClickAStorage === 'A',
+  hoverOPinA_transientO:    bright(hoverOWhilePinA.beta) && dim(hoverOWhilePinA.alpha) && dim(hoverOWhilePinA.gamma),
+  leaveOPinA_aRestored:     bright(leaveOWhilePinA.alpha) && bright(leaveOWhilePinA.gamma) && dim(leaveOWhilePinA.beta),
+  esc_releasesPin:          bright(afterEsc.alpha) && bright(afterEsc.beta) && bright(afterEsc.gamma),
+  esc_metaCleared:          afterEscMeta.A.pinned === 'false' && afterEscMeta.A.aria === 'false' && !afterEscMeta.A.shadow,
+  esc_storageCleared:       afterEscStorage === null,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} vendor pin:`, JSON.stringify(results),
+  `\n  before=`,           before,
+  `\n  afterClickA=`,      afterClickA,
+  `\n  hoverOPinA=`,       hoverOWhilePinA,
+  `\n  leaveOPinA=`,       leaveOWhilePinA,
+  `\n  afterEsc=`,         afterEsc);
+process.exit(ok ? 0 : 1);