@sleep2agi/agent-network-dashboard 0.4.6 → 0.5.0

package/scripts/topo-edge-stroke-ease-test.mjs

@@ -0,0 +1,100 @@
+/* Round 245 verification: edge surface (visible flow path + flow
+ * rail dashed underline) picks up stroke-color transitions so
+ * theme toggle eases instead of snapping.
+ *
+ * Pre-R245:
+ *   - [data-edge-visible]: transition = 'opacity 300ms ease-out,
+ *     stroke-width 300ms ease-out' (R166)
+ *   - [data-edge-flow-rail]: Tailwind className 'transition-opacity
+ *     duration-300' (opacity only, no stroke)
+ *
+ * Post-R245:
+ *   - [data-edge-visible]: transition list adds 'stroke 300ms ease-
+ *     out' alongside the existing two
+ *   - [data-edge-flow-rail]: inline style with both 'opacity' and
+ *     'stroke' at 300ms ease-out; Tailwind className dropped
+ *
+ * Scenario: 4 working agents + 5-msg alpha→beta flow → at least
+ * one visible flow + flow-rail pair.
+ */
+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'),
+  ] } });
+});
+const now = Date.now();
+const msgs = [];
+for (let i = 0; i < 5; i++) {
+  msgs.push({
+    id: `m${i}`, from_alias: 'alpha', to_alias: 'beta', content: 'hi',
+    network_id: 'default', created_at: new Date(now - (1000 + i * 50)).toISOString(),
+  });
+}
+await ctx.route('**/api/hub/messages*', (r2) => r2.fulfill({ json: { messages: msgs } }));
+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-edge-visible]', { timeout: 10000, state: 'attached' });
+await page.waitForSelector('[data-edge-flow-rail]', { timeout: 10000, state: 'attached' });
+await page.waitForTimeout(300);
+
+const out = await page.evaluate(() => {
+  const probe = (sel) => {
+    const el = document.querySelector(sel);
+    if (!el) return null;
+    return {
+      transition: getComputedStyle(el).transition,
+      className:  el.getAttribute('class') || '',
+      stroke:     el.getAttribute('stroke'),
+    };
+  };
+  return {
+    visible: probe('[data-edge-visible]'),
+    rail:    probe('[data-edge-flow-rail]'),
+  };
+});
+await browser.close();
+
+const hasProp = (s, prop) => new RegExp(`${prop}\\s+(?:300ms|0\\.3s)`).test(s || '');
+
+const results = {
+  visible_present:                  out.visible !== null,
+  visible_has_opacity_300ms:        hasProp(out.visible?.transition, 'opacity'),
+  visible_has_stroke_width_300ms:   hasProp(out.visible?.transition, 'stroke-width'),
+  visible_has_stroke_300ms:         hasProp(out.visible?.transition, 'stroke'),
+
+  rail_present:                     out.rail !== null,
+  rail_has_opacity_300ms:           hasProp(out.rail?.transition, 'opacity'),
+  rail_has_stroke_300ms:            hasProp(out.rail?.transition, 'stroke'),
+  // Tailwind 'transition-opacity duration-300' className dropped
+  // (the inline transition list replaces it; Tailwind would
+  // otherwise OVERRIDE the inline stroke transition with its
+  // opacity-only declaration)
+  rail_no_tailwind_class:           !/transition-opacity/.test(out.rail?.className || ''),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} edge stroke ease:`, JSON.stringify(results),
+  '\n  visible:', out.visible,
+  '\n  rail:   ', out.rail);
+process.exit(ok ? 0 : 1);

package/scripts/topo-edge-stroke-transition-test.mjs

@@ -0,0 +1,132 @@
+/* Round 166 verification: visible flow edge path picks up
+ * stroke-width transition.
+ *
+ * R50 thickens hovered edges to 1.4× (renderWidth = width * 1.4)
+ * but pre-R166 only opacity transitioned — width snapped. R166
+ * adds stroke-width to the transition list so the edge thickens
+ * smoothly on hover, pairing with R164 edge-badge r-lift for
+ * coordinated 300ms ease-out across the edge surface.
+ *
+ * Test:
+ *   1. Mock 4 sessions + 1 flow alpha→beta
+ *   2. Probe visible path before hover → strokeWidth=base
+ *   3. Probe transition string includes both opacity and
+ *      stroke-width
+ *   4. Hover edge hitbox → wait 350ms (past transition)
+ *   5. Probe strokeWidth → should be ≈ base * 1.4
+ *   6. mouse away → strokeWidth back to base
+ */
+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: 'cli-claude-code',
+    network_id: nid, project_dir: null,
+    created_at: fresh, updated_at: fresh, last_seen_at: fresh,
+  });
+  // 4 sessions so alpha + beta are 90° apart (not 180° — that
+  // would put their edge midpoint on the hub, where the hub
+  // <g> intercepts pointer events). gamma + delta are filler.
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('alpha'), mk('beta'), mk('gamma'), mk('delta'),
+  ] } });
+});
+
+const now = Date.now();
+// 4 msgs so:
+//   - width = Math.min(2+4, 7) = 6
+//   - hover renderWidth = Math.min(6*1.4, 10) = 8.4
+// AND the edge midpoint count badge renders (R100 threshold
+// count >= 3) so we can use it as the hover surface. The
+// visible path has pointerEvents:none; the R48 hitbox is a
+// thin stroke that Playwright's .hover() can't reliably land
+// on. The badge is a r=9 circle with pointerEvents:all and
+// propagates hover to hoveredEdgeKey (R122) — most reliable
+// target for triggering the visible-path transition.
+const msgs = [];
+for (let i = 0; i < 4; i++) {
+  msgs.push({ id: `m${i}`, from_alias: 'alpha', to_alias: 'beta', content: 'hi',
+    network_id: 'default', created_at: new Date(now - (10000 + i * 500)).toISOString() });
+}
+await ctx.route('**/api/hub/messages*', (route) => route.fulfill({ json: { messages: msgs } }));
+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.waitForSelector('[data-edge-visible]', { timeout: 10000 });
+await page.waitForTimeout(400);
+
+const idle = await page.evaluate(() => {
+  const el = document.querySelector('[data-edge-visible]');
+  if (!el) return null;
+  return {
+    strokeWidth: parseFloat(el.getAttribute('stroke-width')),
+    inlineTransition: el.style.transition || '',
+    computedTransition: getComputedStyle(el).transition || '',
+  };
+});
+
+// Hover the edge midpoint badge (R164 r=9 circle, pointerEvents:all,
+// propagates to hoveredEdgeKey via R122). The visible path has
+// pointerEvents:none; the R48 hitbox is a thin stroke that
+// Playwright .hover() can't reliably land on.
+await page.locator('[data-edge-count-badge]').hover();
+// Wait for transition to settle.
+await page.waitForTimeout(400);
+const hovered = await page.evaluate(() => {
+  const el = document.querySelector('[data-edge-visible]');
+  if (!el) return null;
+  return {
+    strokeWidth: parseFloat(el.getAttribute('stroke-width')),
+  };
+});
+
+// Move cursor away
+await page.mouse.move(10, 10);
+await page.waitForTimeout(400);
+const idleAgain = await page.evaluate(() => {
+  const el = document.querySelector('[data-edge-visible]');
+  if (!el) return null;
+  return {
+    strokeWidth: parseFloat(el.getAttribute('stroke-width')),
+  };
+});
+
+await browser.close();
+
+const hasOpacity = (idle?.inlineTransition || '').includes('opacity 300ms') ||
+                   /opacity\s+0\.3s|opacity\s+300ms/.test(idle?.computedTransition || '');
+const hasStrokeWidth = (idle?.inlineTransition || '').includes('stroke-width 300ms') ||
+                       /stroke-width\s+0\.3s|stroke-width\s+300ms/.test(idle?.computedTransition || '');
+
+// Expected: width=Math.min(2+4, 7)=6. Hover renderWidth=Math.min(6*1.4, 10)=8.4.
+const results = {
+  edge_found:                idle !== null,
+  has_opacity_transition:    hasOpacity,
+  has_stroke_width_transition: hasStrokeWidth,
+  idle_width_6:              idle && Math.abs(idle.strokeWidth - 6) < 0.05,
+  hover_width_8p4:           hovered && Math.abs(hovered.strokeWidth - 8.4) < 0.1,
+  hover_width_thicker:       hovered && idle && hovered.strokeWidth > idle.strokeWidth,
+  idle_again_width_6:        idleAgain && Math.abs(idleAgain.strokeWidth - 6) < 0.05,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} edge stroke transition:`, JSON.stringify(results),
+  `\n  idle =`, idle,
+  `\n  hovered =`, hovered,
+  `\n  idleAgain =`, idleAgain);
+process.exit(ok ? 0 : 1);

package/scripts/topo-empty-hint-tracking-test.mjs

@@ -0,0 +1,84 @@
+/* Round 302 verification: recent-signal panel empty-state hint
+ * ('no flow yet') gains letterSpacing="0.2" for editorial parity
+ * with R301 panel titles (0.3) + R285 kicker tracking-widest +
+ * R289 watermark letterSpacing.
+ *
+ * Contract:
+ *   - [data-recent-signal-empty] attr letter-spacing === '0.2'.
+ *   - Text content still 'no flow yet'.
+ *   - opacity 0.65 + fontStyle italic preserved.
+ *   - R301 panel-title letter-spacings (0.3) still in place.
+ *   - R300 kicker font-medium + R295 swatch r=6 + R294 pulse absent
+ *     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,
+  });
+  await route.fulfill({ response: r, json: { ...b, sessions: [
+    mk('alpha', 'claude-opus-4'),
+    mk('beta',  'gpt-4o'),
+  ] } });
+});
+// Empty messages → "no flow yet" hint visible.
+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-recent-signal-empty]', { timeout: 15000 });
+await page.waitForTimeout(300);
+
+const probe = await page.evaluate(() => {
+  const empty = document.querySelector('[data-recent-signal-empty]');
+  const recentTitle = document.querySelector('[data-recent-panel-title]');
+  const legendTitle = document.querySelector('[data-legend-panel-title]');
+  const kicker = document.querySelector('[data-topo-section-kicker]');
+  const swatch = document.querySelector('[data-legend-swatch="working"]');
+  return {
+    emptyLs:       empty?.getAttribute('letter-spacing') ?? null,
+    emptyText:     empty?.textContent?.trim() ?? null,
+    emptyOpacity:  empty?.getAttribute('opacity') ?? null,
+    emptyStyle:    empty?.getAttribute('font-style') ?? null,
+    recentTitleLs: recentTitle?.getAttribute('letter-spacing') ?? null,
+    legendTitleLs: legendTitle?.getAttribute('letter-spacing') ?? null,
+    kickerFw:      kicker ? getComputedStyle(kicker).fontWeight : null,
+    swatchR:       swatch?.getAttribute('r') ?? null,
+    pulseCount:    document.querySelectorAll('[data-pulse-wrapper]').length,
+  };
+});
+await browser.close();
+
+const results = {
+  empty_hint_ls_0_2:       probe.emptyLs === '0.2',
+  empty_hint_text_kept:    (probe.emptyText || '').startsWith('no flow yet'),
+  empty_opacity_0_65:      String(probe.emptyOpacity) === '0.65',
+  empty_italic_kept:       probe.emptyStyle === 'italic',
+  r301_recent_title_ls:    probe.recentTitleLs === '0.3',
+  r301_legend_title_ls:    probe.legendTitleLs === '0.3',
+  r300_kicker_fw_500:      String(probe.kickerFw) === '500',
+  r295_swatch_r_6:         probe.swatchR === '6',
+  r294_pulse_absent:       probe.pulseCount === 0,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} empty-hint tracking:`, JSON.stringify(results),
+  '\n  empty hint letter-spacing:', probe.emptyLs,
+  '\n  empty hint text:', JSON.stringify(probe.emptyText),
+  '\n  R301 panel titles ls:', probe.recentTitleLs, '/', probe.legendTitleLs);
+process.exit(ok ? 0 : 1);

package/scripts/topo-empty-state-breath-test.mjs

@@ -0,0 +1,150 @@
+/* Round 200 verification (milestone): recent-signal panel empty-
+ * state texts breathe in opacity. The two lines "no flow yet" and
+ * "send a message between agents" each get a SMIL <animate> child
+ * cycling opacity ~0.55 ↔ 0.78 (main) and 0.36 ↔ 0.58 (sub) over
+ * 4.4s. Sub-line is phase-shifted -1.5s so the two read as
+ * inhale-exhale, not synchronised pulse.
+ *
+ * Pre-R200 both texts sat at fixed opacity 0.65 / 0.45 — visually
+ * identical to "frozen" or "broken" first-impression. Slow breath
+ * = "waiting, listening" while staying calm.
+ *
+ * Test:
+ *   1. Mock 0 messages → flowLinks.length === 0 → empty state fires.
+ *   2. data-recent-signal-empty + data-recent-signal-empty-hint
+ *      both present.
+ *   3. data-recent-signal-empty-breathes='true'
+ *      data-recent-signal-empty-hint-breathes='true'
+ *   4. Both texts contain an <animate> child with:
+ *      - attributeName='opacity'
+ *      - dur='4.4s'
+ *      - repeatCount='indefinite'
+ *      - values cover a range (not a single value)
+ *   5. Sub-line <animate> has begin='-1.5s' (phase-shift).
+ *   6. Main <animate> begin is unset / '0s' (no phase shift).
+ *   7. Captured opacity values shift over time (sample twice, ~2s
+ *      apart): same element should produce different rendered
+ *      opacity values because SMIL is animating.
+ */
+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: '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'), mk('beta'), mk('gamma'), mk('delta'),
+  ] } });
+});
+// 0 messages → empty state fires
+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.waitForSelector('[data-recent-signal-empty]', { timeout: 10000 });
+await page.waitForTimeout(300);
+
+const probeStructure = async () => page.evaluate(() => {
+  const main = document.querySelector('[data-recent-signal-empty]');
+  const sub  = document.querySelector('[data-recent-signal-empty-hint]');
+  function pickAnim(textEl) {
+    if (!textEl) return null;
+    const a = textEl.querySelector('animate');
+    if (!a) return { found: false };
+    return {
+      found:       true,
+      attribute:   a.getAttribute('attributeName'),
+      values:      a.getAttribute('values'),
+      dur:         a.getAttribute('dur'),
+      begin:       a.getAttribute('begin'),
+      repeatCount: a.getAttribute('repeatCount'),
+    };
+  }
+  return {
+    mainText:    main?.textContent?.trim(),
+    mainBreathes:main?.getAttribute('data-recent-signal-empty-breathes'),
+    mainAnim:    pickAnim(main),
+    subText:     sub?.textContent?.trim(),
+    subBreathes: sub?.getAttribute('data-recent-signal-empty-hint-breathes'),
+    subAnim:     pickAnim(sub),
+  };
+});
+
+const s = await probeStructure();
+
+// Sample rendered opacity twice ~2s apart to verify SMIL is actually
+// animating in the browser, not just declared.
+async function sampleOpacities() {
+  return page.evaluate(() => {
+    const main = document.querySelector('[data-recent-signal-empty]');
+    const sub  = document.querySelector('[data-recent-signal-empty-hint]');
+    // SMIL renders into the SVG-internal opacity (DOM attr stays
+    // static at the React-rendered value; computed style reads the
+    // animated current value).
+    return {
+      mainComputed: parseFloat(getComputedStyle(main).opacity),
+      subComputed:  parseFloat(getComputedStyle(sub).opacity),
+    };
+  });
+}
+const sample1 = await sampleOpacities();
+await page.waitForTimeout(2000);
+const sample2 = await sampleOpacities();
+
+await browser.close();
+
+const parseValues = (v) => (v || '').split(/[;,]/).map(parseFloat).filter(Number.isFinite);
+const mainVals = parseValues(s.mainAnim?.values);
+const subVals  = parseValues(s.subAnim?.values);
+
+const results = {
+  empty_state_visible:           s.mainText === 'no flow yet',
+  hint_visible:                  s.subText === 'send a message between agents',
+  main_breathes_attr:            s.mainBreathes === 'true',
+  hint_breathes_attr:            s.subBreathes === 'true',
+
+  main_anim_found:               s.mainAnim?.found === true,
+  main_anim_opacity:             s.mainAnim?.attribute === 'opacity',
+  main_anim_dur_4p4s:            s.mainAnim?.dur === '4.4s',
+  main_anim_indefinite:          s.mainAnim?.repeatCount === 'indefinite',
+  main_anim_values_range:        mainVals.length >= 3 && (Math.max(...mainVals) - Math.min(...mainVals)) > 0.1,
+  main_anim_no_phase_shift:      !s.mainAnim?.begin || s.mainAnim?.begin === '0s' || s.mainAnim?.begin === '',
+
+  sub_anim_found:                s.subAnim?.found === true,
+  sub_anim_opacity:              s.subAnim?.attribute === 'opacity',
+  sub_anim_dur_4p4s:             s.subAnim?.dur === '4.4s',
+  sub_anim_phase_shift:          s.subAnim?.begin === '-1.5s',
+  sub_anim_values_range:         subVals.length >= 3 && (Math.max(...subVals) - Math.min(...subVals)) > 0.1,
+
+  // SMIL actually animates — sampling at different cycle phases yields
+  // different rendered opacities. With 4.4s period and 2s gap, the two
+  // samples are at distinct phases and should diverge by at least 0.04
+  // unless we landed on symmetric cycle points (extremely rare given
+  // mock timing variance — re-check loose bound).
+  main_opacity_animating:        Math.abs(sample1.mainComputed - sample2.mainComputed) > 0.02,
+  sub_opacity_animating:         Math.abs(sample1.subComputed - sample2.subComputed) > 0.02,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} empty-state breath:`, JSON.stringify(results),
+  `\n  structure:`, s,
+  `\n  sample1:`, sample1,
+  `\n  sample2:`, sample2);
+process.exit(ok ? 0 : 1);

package/scripts/topo-empty-state-crossfade-test.mjs

@@ -0,0 +1,130 @@
+/* Round 222 verification: recent-signal panel empty state always-
+ * mounts; visibility crossfades via wrapper <g> opacity instead of
+ * conditional mount/unmount on flowLinks.length === 0.
+ *
+ * Pre-R222 the first flow arriving snap-removed the empty state
+ * (R45 + R200) in one frame while R203 rows simultaneously faded
+ * IN — half-smooth, half-snap. R222 closes the snap so the empty-
+ * to-populated transition crossfades both directions cleanly.
+ *
+ * Test scenarios:
+ *   A. 0 flows (empty):
+ *      · wrapper visible='true', opacity=1
+ *      · both empty texts present, R200 SMIL <animate> still on
+ *      · rows NOT mounted (rows path returns null)
+ *   B. 3 flows (populated):
+ *      · wrapper visible='false', opacity=0
+ *      · both empty texts STILL in DOM (always-mount)
+ *      · R200 SMIL <animate> still in place (just invisible due
+ *        to parent opacity 0)
+ *      · rows present
+ *   Both: inline transition includes 'opacity 300ms'
+ */
+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 setup(messages) {
+  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-recent-signal-empty-wrapper]', { timeout: 10000, state: 'attached' });
+  await page.waitForTimeout(400);
+  return page;
+}
+
+const probe = async (page) => page.evaluate(() => {
+  const wrapper = document.querySelector('[data-recent-signal-empty-wrapper]');
+  if (!wrapper) return null;
+  const cs = getComputedStyle(wrapper);
+  const main = wrapper.querySelector('[data-recent-signal-empty]');
+  const hint = wrapper.querySelector('[data-recent-signal-empty-hint]');
+  const mainAnim = main?.querySelector('animate');
+  const hintAnim = hint?.querySelector('animate');
+  const rowCount = document.querySelectorAll('[data-recent-row]').length;
+  return {
+    visible:     wrapper.getAttribute('data-recent-signal-empty-visible'),
+    opacity:     parseFloat(cs.opacity),
+    transition:  wrapper.style.transition,
+    mainPresent: !!main,
+    hintPresent: !!hint,
+    mainText:    main?.textContent?.trim().split(/\s+/)[0] + ' ' + main?.textContent?.trim().split(/\s+/)[1]
+                 + ' ' + main?.textContent?.trim().split(/\s+/)[2],
+    mainAnimAttr: mainAnim?.getAttribute('attributeName'),
+    hintAnimAttr: hintAnim?.getAttribute('attributeName'),
+    rowCount,
+  };
+});
+
+// Scenario A: 0 flows (empty)
+const pageA = await setup([]);
+const probeA = await probe(pageA);
+await pageA.close();
+
+// Scenario B: 3 flows (populated)
+const now = Date.now();
+const pageB = await setup([
+  { id: '1', from_alias: 'alpha', to_alias: 'beta',  content: 'hi',
+    network_id: 'default', created_at: new Date(now - 1000).toISOString() },
+  { id: '2', from_alias: 'beta',  to_alias: 'gamma', content: 'hi',
+    network_id: 'default', created_at: new Date(now - 2000).toISOString() },
+  { id: '3', from_alias: 'gamma', to_alias: 'delta', content: 'hi',
+    network_id: 'default', created_at: new Date(now - 3000).toISOString() },
+]);
+const probeB = await probe(pageB);
+await pageB.close();
+await browser.close();
+
+const results = {
+  // Scenario A — empty
+  A_present_in_dom:        !!probeA,
+  A_visible_true:          probeA?.visible === 'true',
+  A_opacity_1:             probeA?.opacity === 1,
+  A_main_present:          probeA?.mainPresent === true,
+  A_hint_present:          probeA?.hintPresent === true,
+  A_main_anim_opacity:     probeA?.mainAnimAttr === 'opacity',
+  A_hint_anim_opacity:     probeA?.hintAnimAttr === 'opacity',
+  A_no_rows:               probeA?.rowCount === 0,
+
+  // Scenario B — populated (empty still in DOM)
+  B_present_in_dom:        !!probeB,
+  B_visible_false:         probeB?.visible === 'false',
+  B_opacity_0:             probeB?.opacity === 0,
+  B_main_still_in_dom:     probeB?.mainPresent === true,
+  B_hint_still_in_dom:     probeB?.hintPresent === true,
+  B_main_anim_still_on:    probeB?.mainAnimAttr === 'opacity',
+  B_hint_anim_still_on:    probeB?.hintAnimAttr === 'opacity',
+  B_three_rows:            probeB?.rowCount === 3,
+
+  // Transitions present in both
+  A_has_transition:        /opacity\s+(?:300ms|0\.3s)/.test(probeA?.transition || ''),
+  B_has_transition:        /opacity\s+(?:300ms|0\.3s)/.test(probeB?.transition || ''),
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} empty-state crossfade:`, JSON.stringify(results),
+  `\n  probeA (0 flows empty):`, probeA,
+  `\n  probeB (3 flows populated):`, probeB);
+process.exit(ok ? 0 : 1);