@sleep2agi/agent-network-dashboard 0.5.3 → 0.5.4

package/app/layout.tsx

@@ -13,6 +13,12 @@ const geistMono = Geist_Mono({
 export const metadata: Metadata = {
   title: "Agent Network Dashboard",
   description: "Real-time monitoring dashboard for Agent Network nodes via CommHub",
+  manifest: "/manifest.webmanifest",
+  appleWebApp: {
+    capable: true,
+    statusBarStyle: "black-translucent",
+    title: "Agent Network",
+  },
   icons: { icon: '/favicon.svg' },
   openGraph: {
     title: "Agent Network Dashboard",

package/app/lib/serverDedupe.ts

@@ -0,0 +1,122 @@
+/**
+ * #157 RC#2 — host telemetry row dedup for the Servers panel.
+ *
+ * The CommHub /api/servers endpoint keys host telemetry by (hostname,
+ * ip): a machine whose agents report over more than one interface
+ * yields one row per IP. Live data caught `iZrj93pr2rcf5r2y9uo1oyZ`
+ * twice — once at the Docker-bridge IP (carrying cpu/mem telemetry)
+ * and once at loopback (telemetry null) — so the panel showed the same
+ * physical host as two cards with split agent counts.
+ *
+ * Extracted from the /api/hub/servers route handler so the merge can
+ * be unit-tested against a mock fixture independently of the proxy.
+ */
+
+export interface HubServerRow {
+  hostname: string;
+  ip?: string | null;
+  agent_count?: number;
+  cpu_load_1min?: number | null;
+  cpu_cores?: number | null;
+  mem_used_gb?: number | null;
+  mem_total_gb?: number | null;
+  mem_avail_gb?: number | null;
+  disk_used_gb?: number | null;
+  disk_total_gb?: number | null;
+  cpu_history?: number[];
+  mem_history?: number[];
+  agents?: unknown[];
+  last_seen?: string | null;
+  status?: 'online' | 'offline';
+  note?: string;
+}
+
+/**
+ * Parse a hub timestamp to epoch ms. CommHub reports last_seen as
+ * "YYYY-MM-DD HH:MM:SS" (space-separated, no timezone) — treat as UTC
+ * so all clients agree regardless of local zone. ISO 8601 with an
+ * explicit offset also parses cleanly (the +'Z' is only appended when
+ * no zone is present). Returns NaN for missing / unparseable input.
+ */
+export function parseHubTime(ts: string | null | undefined): number {
+  if (!ts) return NaN;
+  const iso = ts.includes('T') ? ts : ts.replace(' ', 'T');
+  const withTz = /[zZ]|[+-]\d{2}:?\d{2}$/.test(iso) ? iso : iso + 'Z';
+  return Date.parse(withTz);
+}
+
+/**
+ * Collapse rows that share a hostname into one card.
+ *
+ * Dedup keys on hostname, not IP: a hostname is the machine identity,
+ * whereas an IP can be shared across hosts behind NAT (two distinct
+ * hostnames can surface as the same public IP) or differ per interface
+ * on one host. Merge rule for a multi-row hostname:
+ *   - agent_count  = sum across rows (one host's total fan-out)
+ *   - telemetry    = freshest-non-null per field — walk rows newest
+ *                    last_seen first, take the first row that actually
+ *                    reports each field, so a stale-but-telemetried row
+ *                    still contributes cpu/mem when the freshest row's
+ *                    values are null
+ *   - last_seen    = newest across rows
+ *   - agents[]     = union, dedup by alias
+ *
+ * Sentinel hostnames that are not real identities — empty or the
+ * literal "unknown" the hub emits when an agent never resolved its
+ * host — are passed through untouched: merging two distinct unknown
+ * machines into one card would be worse than showing both.
+ */
+export function dedupeByHostname(rows: HubServerRow[]): HubServerRow[] {
+  const groups = new Map<string, HubServerRow[]>();
+  const passthrough: HubServerRow[] = [];
+  for (const row of rows) {
+    const h = row.hostname;
+    if (!h || h === 'unknown') { passthrough.push(row); continue; }
+    const bucket = groups.get(h) ?? [];
+    bucket.push(row);
+    groups.set(h, bucket);
+  }
+  const merged: HubServerRow[] = [];
+  for (const bucket of groups.values()) {
+    if (bucket.length === 1) { merged.push(bucket[0]); continue; }
+    // Freshest last_seen first. NaN (missing timestamp) sorts last.
+    const sorted = [...bucket].sort((a, b) => {
+      const ta = parseHubTime(a.last_seen), tb = parseHubTime(b.last_seen);
+      return (Number.isNaN(tb) ? -Infinity : tb) - (Number.isNaN(ta) ? -Infinity : ta);
+    });
+    const coalesce = <K extends keyof HubServerRow>(key: K): HubServerRow[K] | undefined => {
+      for (const r of sorted) {
+        const v = r[key];
+        if (v != null) return v;
+      }
+      return undefined;
+    };
+    const agentMap = new Map<string, unknown>();
+    for (const r of sorted) {
+      if (!Array.isArray(r.agents)) continue;
+      for (const a of r.agents) {
+        const key = (a as { alias?: string })?.alias ?? JSON.stringify(a);
+        if (!agentMap.has(key)) agentMap.set(key, a);
+      }
+    }
+    merged.push({
+      hostname: sorted[0].hostname,
+      ip: coalesce('ip') ?? null,
+      agent_count: bucket.reduce((sum, r) => sum + (r.agent_count ?? 0), 0),
+      cpu_load_1min: coalesce('cpu_load_1min') ?? null,
+      cpu_cores: coalesce('cpu_cores') ?? null,
+      mem_used_gb: coalesce('mem_used_gb') ?? null,
+      mem_total_gb: coalesce('mem_total_gb') ?? null,
+      mem_avail_gb: coalesce('mem_avail_gb') ?? null,
+      disk_used_gb: coalesce('disk_used_gb') ?? null,
+      disk_total_gb: coalesce('disk_total_gb') ?? null,
+      cpu_history: coalesce('cpu_history'),
+      mem_history: coalesce('mem_history'),
+      agents: agentMap.size > 0 ? [...agentMap.values()] : undefined,
+      last_seen: coalesce('last_seen') ?? null,
+      status: coalesce('status'),
+      note: coalesce('note'),
+    });
+  }
+  return [...merged, ...passthrough];
+}

package/app/lib/vendorIdentity.ts

@@ -33,70 +33,88 @@ const UNKNOWN_VENDOR: VendorIdentity = {
   logo: null,
 };
 
+// Vendor identities, named so both the model-prefix rules and the
+// runtime fallback map below can reference the same object.
+const INTERN_VENDOR: VendorIdentity = {
+  id: 'intern',
+  label: '书生 · 上海 AI 实验室',
+  mono: { bg: 'hsl(28 38% 24%)', ring: 'hsl(32 45% 52%)', text: 'hsl(34 60% 82%)' },
+  initial: '书',
+  // #79 shipped this asset — reuse it as the 书生 vendor logo.
+  logo: '/intern_avatar.png',
+};
+const MINIMAX_VENDOR: VendorIdentity = {
+  id: 'minimax',
+  label: 'MiniMax',
+  mono: { bg: 'hsl(18 50% 26%)', ring: 'hsl(18 65% 52%)', text: 'hsl(20 80% 82%)' },
+  initial: 'M',
+  // Official MiniMax mark (simple-icons set, CC0) on a warm-red tinted
+  // badge. Vincent-authorized 2026-05-21 to use real vendor marks.
+  logo: '/vendors/minimax.svg',
+};
+const ANTHROPIC_VENDOR: VendorIdentity = {
+  id: 'anthropic',
+  label: 'Anthropic',
+  mono: { bg: 'hsl(16 32% 26%)', ring: 'hsl(16 48% 54%)', text: 'hsl(18 60% 84%)' },
+  initial: 'A',
+  // Official Anthropic mark (simple-icons set, CC0) on a warm-orange
+  // tinted badge. Vincent-authorized 2026-05-21 to use real vendor marks.
+  logo: '/vendors/claude.svg',
+};
+const OPENAI_VENDOR: VendorIdentity = {
+  id: 'openai',
+  label: 'OpenAI',
+  mono: { bg: 'hsl(165 26% 22%)', ring: 'hsl(165 40% 44%)', text: 'hsl(165 45% 80%)' },
+  initial: 'O',
+  // Official OpenAI mark (simple-icons set, CC0) on a teal tinted
+  // badge. Vincent-authorized 2026-05-21 to use real vendor marks.
+  logo: '/vendors/openai.svg',
+};
+
 // Ordered prefix rules — first match wins. `test` runs against a lowercased
 // model id. Keep the most specific prefixes first.
 const VENDOR_RULES: Array<{ test: (m: string) => boolean; vendor: VendorIdentity }> = [
-  {
-    test: (m) => m.startsWith('intern'),
-    vendor: {
-      id: 'intern',
-      label: '书生 · 上海 AI 实验室',
-      mono: { bg: 'hsl(28 38% 24%)', ring: 'hsl(32 45% 52%)', text: 'hsl(34 60% 82%)' },
-      initial: '书',
-      // #79 shipped this asset — reuse it as the 书生 vendor logo.
-      logo: '/intern_avatar.png',
-    },
-  },
-  {
-    test: (m) => m.startsWith('minimax'),
-    vendor: {
-      id: 'minimax',
-      label: 'MiniMax',
-      mono: { bg: 'hsl(18 50% 26%)', ring: 'hsl(18 65% 52%)', text: 'hsl(20 80% 82%)' },
-      initial: 'M',
-      // P0 (Vincent 5222) custom-designed vendor badge — NOT a copy of
-      // the MiniMax trademark; geometric min/max zigzag in their warm-
-      // red palette. Replaces plain-letter "M" fallback.
-      logo: '/vendors/minimax.svg',
-    },
-  },
-  {
-    test: (m) => m.startsWith('claude'),
-    vendor: {
-      id: 'anthropic',
-      label: 'Anthropic',
-      mono: { bg: 'hsl(16 32% 26%)', ring: 'hsl(16 48% 54%)', text: 'hsl(18 60% 84%)' },
-      initial: 'A',
-      // P0 (Vincent 5222) custom-designed vendor badge — NOT a copy of
-      // the Anthropic trademark; 4-pointed sparkle in their warm-orange
-      // palette evokes AI/Claude without imitating the official mark.
-      // Real Anthropic logo still pending Vincent-direct asset OK.
-      logo: '/vendors/claude.svg',
-    },
-  },
+  { test: (m) => m.startsWith('intern'), vendor: INTERN_VENDOR },
+  { test: (m) => m.startsWith('minimax'), vendor: MINIMAX_VENDOR },
+  { test: (m) => m.startsWith('claude'), vendor: ANTHROPIC_VENDOR },
   {
     test: (m) => m.startsWith('gpt') || m.startsWith('codex') || m.startsWith('o1') || m.startsWith('o3') || m.startsWith('o4'),
-    vendor: {
-      id: 'openai',
-      label: 'OpenAI',
-      mono: { bg: 'hsl(165 26% 22%)', ring: 'hsl(165 40% 44%)', text: 'hsl(165 45% 80%)' },
-      initial: 'O',
-      // P0 (Vincent 5222) custom-designed vendor badge — NOT a copy of
-      // the OpenAI trademark; hexagonal frame + center dot in their
-      // teal palette evokes geometric AI lattice without imitating the
-      // knot. Real OpenAI logo still pending Vincent-direct asset OK.
-      logo: '/vendors/openai.svg',
-    },
+    vendor: OPENAI_VENDOR,
   },
 ];
 
-/** Resolve a model id to its vendor identity. `null` / unmatched → UNKNOWN. */
-export function vendorForModel(model: string | null | undefined): VendorIdentity {
-  if (!model) return UNKNOWN_VENDOR;
-  const m = model.toLowerCase();
-  for (const rule of VENDOR_RULES) {
-    if (rule.test(m)) return rule.vendor;
+/* Runtime → vendor fallback. Used only when the `model` field can't
+ * resolve a vendor (null or unmatched).
+ *
+ * Why this exists: live hub /api/status probe (2026-05-21) showed 62%
+ * of sessions report `model: null` — including ALL claude-code-cli
+ * nodes — so the avatar fell back to the dark "unknown vendor"
+ * monogram for most of the fleet. The `runtime` field, by contrast,
+ * is reliably populated. A claude-code-cli / claude-agent-sdk node is
+ * an Anthropic shell; codex-sdk is OpenAI's. Deriving the vendor from
+ * runtime when the model is silent lights up the vendor logo for the
+ * whole fleet instead of leaving it grey. The model still wins when
+ * present — runtime is strictly the fallback. */
+const RUNTIME_VENDOR: Record<string, VendorIdentity> = {
+  'claude-code-cli': ANTHROPIC_VENDOR,
+  'claude-agent-sdk': ANTHROPIC_VENDOR,
+  'codex-sdk': OPENAI_VENDOR,
+};
+
+/** Resolve a node's vendor identity. Model id wins; when the model is
+ *  null or unmatched, fall back to the execution runtime. Both silent
+ *  → UNKNOWN. */
+export function vendorForModel(
+  model: string | null | undefined,
+  runtime?: string | null | undefined,
+): VendorIdentity {
+  if (model) {
+    const m = model.toLowerCase();
+    for (const rule of VENDOR_RULES) {
+      if (rule.test(m)) return rule.vendor;
+    }
   }
+  if (runtime && RUNTIME_VENDOR[runtime]) return RUNTIME_VENDOR[runtime];
   return UNKNOWN_VENDOR;
 }
 
@@ -146,7 +164,7 @@ export function runtimeIdentity(runtime: string | null | undefined): RuntimeIden
 /** Compact one-line identity for hover / detail surfaces:
  *  "Anthropic · claude-opus-4 · Claude Code CLI". Pieces with no data drop. */
 export function identityLine(model: string | null | undefined, runtime: string | null | undefined): string {
-  const v = vendorForModel(model);
+  const v = vendorForModel(model, runtime);
   const r = runtimeIdentity(runtime);
   const parts: string[] = [];
   if (v.id !== 'unknown') parts.push(v.label);

package/app/manifest.ts

@@ -0,0 +1,23 @@
+import type { MetadataRoute } from 'next';
+
+export default function manifest(): MetadataRoute.Manifest {
+  return {
+    name: 'Agent Network Dashboard',
+    short_name: 'AgentNet',
+    description: 'Mobile command surface for Agent Network and CommHub',
+    start_url: '/',
+    scope: '/',
+    display: 'standalone',
+    background_color: '#0a0a1a',
+    theme_color: '#0a0a1a',
+    orientation: 'portrait',
+    icons: [
+      {
+        src: '/favicon.svg',
+        sizes: 'any',
+        type: 'image/svg+xml',
+        purpose: 'any',
+      },
+    ],
+  };
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@sleep2agi/agent-network-dashboard",
-  "version": "0.5.3",
-  "description": "Agent Network Dashboard \u2014 Web UI for managing AI Agent networks",
+  "version": "0.5.4",
+  "description": "Agent Network Dashboard — Web UI for managing AI Agent networks",
   "scripts": {
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
     "lint": "eslint",
-    "prepublishOnly": "[ -f .next/BUILD_ID ] || (echo 'prepublishOnly: .next/BUILD_ID missing \u2014 run npm run build first (see commit 05c1ebf body for R224 chunk-500 root cause)' >&2 && exit 1)"
+    "prepublishOnly": "[ -f .next/BUILD_ID ] || (echo 'prepublishOnly: .next/BUILD_ID missing — run npm run build first (see commit 05c1ebf body for R224 chunk-500 root cause)' >&2 && exit 1)"
   },
   "bin": {
     "agent-network-dashboard": "./bin/start.js"
@@ -44,4 +44,4 @@
     "tailwindcss": "^4",
     "typescript": "^5"
   }
-}
+}

package/public/vendors/claude.svg

@@ -1,11 +1,10 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
-  <!-- Anthropic / Claude vendor mark.
-       NOT a copy of the Anthropic trademark — custom designed badge
-       in warm-orange palette. 4-rayed sparkle = "AI spark of insight".
-       Real Anthropic logo asset still gated on Vincent-direct. -->
-  <circle cx="32" cy="32" r="32" fill="hsl(16 32% 22%)" />
-  <circle cx="32" cy="32" r="30" fill="none" stroke="hsl(16 48% 54%)" stroke-width="2" />
-  <g fill="hsl(20 80% 78%)" transform="translate(32 32)">
-    <path d="M 0 -18 L 4 -4 L 18 0 L 4 4 L 0 18 L -4 4 L -18 0 L -4 -4 Z" />
+  <!-- Anthropic vendor mark — official Anthropic logo (simple-icons set, CC0).
+       Vincent-authorized 2026-05-21 to use real vendor marks. Tinted circular
+       badge frames the official mark for the dashboard node-avatar context. -->
+  <circle cx="32" cy="32" r="32" fill="hsl(16 32% 22%)"/>
+  <circle cx="32" cy="32" r="30" fill="none" stroke="hsl(16 48% 54%)" stroke-width="2"/>
+  <g transform="translate(16 16) scale(1.333)" fill="hsl(20 80% 82%)">
+    <path d="M17.3041 3.541h-3.6718l6.696 16.918H24Zm-10.6082 0L0 20.459h3.7442l1.3693-3.5527h7.0052l1.3693 3.5528h3.7442L10.5363 3.5409Zm-.3712 10.2232 2.2914-5.9456 2.2914 5.9456Z"/>
   </g>
 </svg>

package/public/vendors/minimax.svg

@@ -1,11 +1,10 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
-  <!-- MiniMax vendor mark. NOT a copy of the MiniMax trademark —
-       custom designed badge: angular min/max zigzag in warm-red
-       palette evokes the function-shape without imitating the official
-       mark. Real MiniMax logo asset still gated on Vincent-direct. -->
-  <circle cx="32" cy="32" r="32" fill="hsl(18 50% 22%)" />
-  <circle cx="32" cy="32" r="30" fill="none" stroke="hsl(18 65% 52%)" stroke-width="2" />
-  <polyline points="14,42 22,22 32,42 42,22 50,42"
-            fill="none" stroke="hsl(20 80% 80%)" stroke-width="4"
-            stroke-linecap="round" stroke-linejoin="round" />
+  <!-- MiniMax vendor mark — official MiniMax logo (simple-icons set, CC0).
+       Vincent-authorized 2026-05-21 to use real vendor marks. Tinted circular
+       badge frames the official mark for the dashboard node-avatar context. -->
+  <circle cx="32" cy="32" r="32" fill="hsl(18 50% 22%)"/>
+  <circle cx="32" cy="32" r="30" fill="none" stroke="hsl(18 65% 52%)" stroke-width="2"/>
+  <g transform="translate(16 16) scale(1.333)" fill="hsl(20 80% 84%)">
+    <path d="M11.43 3.92a.86.86 0 1 0-1.718 0v14.236a1.999 1.999 0 0 1-3.997 0V9.022a.86.86 0 1 0-1.718 0v3.87a1.999 1.999 0 0 1-3.997 0V11.49a.57.57 0 0 1 1.139 0v1.404a.86.86 0 0 0 1.719 0V9.022a1.999 1.999 0 0 1 3.997 0v9.134a.86.86 0 0 0 1.719 0V3.92a1.998 1.998 0 1 1 3.996 0v11.788a.57.57 0 1 1-1.139 0zm10.572 3.105a2 2 0 0 0-1.999 1.997v7.63a.86.86 0 0 1-1.718 0V3.923a1.999 1.999 0 0 0-3.997 0v16.16a.86.86 0 0 1-1.719 0V18.08a.57.57 0 1 0-1.138 0v2a1.998 1.998 0 0 0 3.996 0V3.92a.86.86 0 0 1 1.719 0v12.73a1.999 1.999 0 0 0 3.996 0V9.023a.86.86 0 1 1 1.72 0v6.686a.57.57 0 0 0 1.138 0V9.022a2 2 0 0 0-1.998-1.997"/>
+  </g>
 </svg>

package/public/vendors/openai.svg

@@ -1,12 +1,10 @@
 <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
-  <!-- OpenAI / GPT / Codex vendor mark. NOT a copy of the OpenAI
-       trademark — custom designed badge: hexagonal frame + center dot
-       in teal palette evokes "geometric AI lattice" without imitating
-       the OpenAI knot. Real OpenAI logo asset still gated on Vincent-
-       direct. -->
-  <circle cx="32" cy="32" r="32" fill="hsl(165 26% 20%)" />
-  <circle cx="32" cy="32" r="30" fill="none" stroke="hsl(165 40% 44%)" stroke-width="2" />
-  <polygon points="32,12 47,21 47,43 32,52 17,43 17,21"
-           fill="none" stroke="hsl(165 50% 78%)" stroke-width="3" stroke-linejoin="round" />
-  <circle cx="32" cy="32" r="4" fill="hsl(165 50% 78%)" />
+  <!-- OpenAI vendor mark — official OpenAI logo (simple-icons set, CC0).
+       Vincent-authorized 2026-05-21 to use real vendor marks. Tinted circular
+       badge frames the official mark for the dashboard node-avatar context. -->
+  <circle cx="32" cy="32" r="32" fill="hsl(165 26% 20%)"/>
+  <circle cx="32" cy="32" r="30" fill="none" stroke="hsl(165 40% 44%)" stroke-width="2"/>
+  <g transform="translate(16 16) scale(1.333)" fill="hsl(165 50% 82%)">
+    <path d="M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z"/>
+  </g>
 </svg>

package/scripts/p157-rc2-dedup-test.mjs

@@ -0,0 +1,110 @@
+/* #157 RC#2 verification — Servers panel hostname dedup.
+ *
+ * Bug (Vincent 5560 + live re-probe 2026-05-20): the hub /api/servers
+ * endpoint keys host telemetry by (hostname, ip), so a machine whose
+ * agents report over more than one interface surfaces as multiple
+ * rows. `iZrj93pr2rcf5r2y9uo1oyZ` appeared twice — Docker-bridge IP
+ * (telemetry-bearing) + loopback (telemetry null) — splitting its
+ * agent count across two cards.
+ *
+ * Fix: `dedupeByHostname` in app/lib/serverDedupe.ts, applied in the
+ * /api/hub/servers proxy before normalizeServer.
+ *
+ * Two legs:
+ *   A. mock fixture — compile serverDedupe.ts, run a crafted payload
+ *      that exercises every branch (multi-row merge, telemetry
+ *      coalesce, NAT-shared IP NOT merged, `unknown` passthrough,
+ *      agents[] union).
+ *   B. real payload — GET the running dashboard proxy and assert no
+ *      hostname appears twice + counts are summed.
+ */
+import { execSync } from 'node:child_process';
+import { readFileSync, renameSync, mkdirSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+
+let failed = 0;
+const ok = (name, cond, detail = '') => {
+  if (cond) { console.log(`  ✅ ${name}`); }
+  else { console.log(`  ❌ ${name}${detail ? ' — ' + detail : ''}`); failed++; }
+};
+
+// ── Leg A: mock fixture against the real dedup module ──────────────
+console.log('Leg A — mock fixture (compiled serverDedupe.ts):');
+const OUT = '/tmp/p157-rc2-dedupe';
+mkdirSync(OUT, { recursive: true });
+execSync(
+  `npx tsc app/lib/serverDedupe.ts --outDir ${OUT} --module es2022 --target es2022 --moduleResolution bundler --skipLibCheck`,
+  { stdio: 'inherit' },
+);
+renameSync(`${OUT}/serverDedupe.js`, `${OUT}/serverDedupe.mjs`);
+const { dedupeByHostname } = await import(pathToFileURL(`${OUT}/serverDedupe.mjs`).href);
+
+const fixture = [
+  // same hostname, two interfaces — bridge row fresh + telemetried,
+  // loopback row staler + telemetry null
+  { hostname: 'host-A', ip: '172.17.0.2', agent_count: 29, last_seen: '2026-05-20 04:41:46',
+    cpu_load_1min: 1.49, cpu_cores: 8, mem_used_gb: 22.6, mem_total_gb: 32,
+    agents: [{ alias: 'a1' }, { alias: 'a2' }] },
+  { hostname: 'host-A', ip: '127.0.0.1', agent_count: 38, last_seen: '2026-05-20 04:41:43',
+    cpu_load_1min: null, mem_used_gb: null,
+    agents: [{ alias: 'a2' }, { alias: 'a3' }] },
+  // NAT-shared public IP, distinct hostnames — must NOT merge
+  { hostname: 'host-B', ip: '223.167.142.73', agent_count: 5, last_seen: '2026-05-18 02:34:16' },
+  { hostname: 'host-C', ip: '223.167.142.73', agent_count: 2, last_seen: '2026-05-13 16:44:41' },
+  // sentinel hostname — two distinct unknown machines, pass through both
+  { hostname: 'unknown', ip: '127.0.0.1', agent_count: 2, last_seen: '2026-05-16 08:40:14' },
+  { hostname: 'unknown', ip: '10.0.0.9', agent_count: 1, last_seen: '2026-05-16 09:00:00' },
+];
+const out = dedupeByHostname(fixture);
+const byHost = (h) => out.filter(r => r.hostname === h);
+const hostA = byHost('host-A')[0];
+
+ok('host-A collapses 2 rows → 1', byHost('host-A').length === 1, `got ${byHost('host-A').length}`);
+ok('host-A agent_count summed 29+38=67', hostA?.agent_count === 67, `got ${hostA?.agent_count}`);
+ok('host-A telemetry coalesced from bridge row (cpu 1.49)', hostA?.cpu_load_1min === 1.49, `got ${hostA?.cpu_load_1min}`);
+ok('host-A mem coalesced (22.6)', hostA?.mem_used_gb === 22.6, `got ${hostA?.mem_used_gb}`);
+ok('host-A last_seen = freshest (04:41:46)', hostA?.last_seen === '2026-05-20 04:41:46', `got ${hostA?.last_seen}`);
+ok('host-A agents[] unioned + dedup by alias (a1,a2,a3)',
+  hostA?.agents?.length === 3 &&
+  new Set(hostA.agents.map(a => a.alias)).size === 3,
+  `got ${JSON.stringify(hostA?.agents)}`);
+ok('host-B + host-C NOT merged despite shared IP', byHost('host-B').length === 1 && byHost('host-C').length === 1);
+ok('two `unknown` rows both pass through (not merged)', byHost('unknown').length === 2, `got ${byHost('unknown').length}`);
+ok('total rows: 1 (A) + 1 (B) + 1 (C) + 2 (unknown) = 5', out.length === 5, `got ${out.length}`);
+
+// idempotency — running dedup on already-deduped output is a no-op
+const twice = dedupeByHostname(out);
+ok('idempotent — dedup(dedup(x)) === dedup(x)', twice.length === out.length);
+
+// ── Leg B: real payload through the running dashboard proxy ─────────
+console.log('\nLeg B — real payload (live /api/hub/servers proxy):');
+let TOKEN;
+try {
+  TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+} catch {
+  console.log('  ⚠️  no anet config — skipping live leg');
+}
+if (TOKEN) {
+  const res = await fetch('http://127.0.0.1:3000/api/hub/servers', {
+    headers: { cookie: `anet_dashboard_session=v3:${TOKEN}` },
+  });
+  ok('proxy returns 200', res.status === 200, `status ${res.status}`);
+  const body = await res.json();
+  const servers = body.servers ?? [];
+  ok('proxy returns servers[]', Array.isArray(servers) && servers.length > 0, `got ${servers.length}`);
+  const counts = {};
+  for (const s of servers) counts[s.hostname] = (counts[s.hostname] ?? 0) + 1;
+  const dups = Object.entries(counts).filter(([h, n]) => n > 1 && h !== 'unknown' && h !== '');
+  ok('no real hostname appears twice', dups.length === 0, `dups: ${JSON.stringify(dups)}`);
+  const izrj = servers.find(s => s.hostname?.startsWith('iZrj93pr'));
+  if (izrj) {
+    ok('iZrj93pr… host present as single card', true);
+    ok('iZrj93pr… has telemetry after coalesce (cpu non-null)', izrj.cpu_load_1min != null, `cpu ${izrj.cpu_load_1min}`);
+    console.log(`  ℹ️  iZrj93pr… merged: agent_count=${izrj.agent_count}, cpu=${izrj.cpu_load_1min}, ip=${izrj.ip}`);
+  } else {
+    console.log('  ℹ️  iZrj93pr… not in current live payload (hub state changed) — structural dup check still authoritative');
+  }
+}
+
+console.log(`\n${failed === 0 ? '✅ ALL GREEN' : `❌ ${failed} FAILED`}`);
+process.exit(failed === 0 ? 0 : 1);

package/scripts/topo-a11y-titles-catalog-test.mjs

@@ -0,0 +1,132 @@
+/* Round 732 — a11y titles catalog on canvas root. 7TH orthogonal
+ * meta-doc axis. The introspection layer crosses families:
+ *
+ *   Breath family (6 meta-docs):
+ *     R710 data-topo-respiratory-rolodex              (cadences)
+ *     R716 data-topo-respiratory-dual-axis-surfaces   (axes)
+ *     R717 data-topo-respiratory-patterns             (patterns)
+ *     R720 data-topo-respiratory-tiers                (tiers)
+ *     R723 data-topo-respiratory-triple-axis-surfaces (triple-axis)
+ *     R729 data-topo-respiratory-axis-count-stats     (stats)
+ *
+ *   A11y sub-family (1 meta-doc):
+ *     R732 data-topo-a11y-titles                      (accessible names) ← this round
+ *
+ * Each entry maps surface → DOM selector → accessible name. The test
+ * resolves each selector at runtime and verifies the element's direct
+ * <title> child textContent matches the catalog's accessible_name.
+ *
+ * Assertions:
+ *   - attr present on root <svg>
+ *   - JSON parses to Array of 5 entries (R730: 3, R731: 2)
+ *   - Each entry has {surface, selector, accessible_name} shape with
+ *     non-empty string values
+ *   - Each accessible_name follows canonical "<name> · <role>" format
+ *   - Each selector resolves at runtime to an element (or null IF
+ *     conditionally rendered, treated as pass for the cross-check)
+ *   - When element exists, its direct <title> child's textContent
+ *     equals catalog's accessible_name (STRICT cross-check)
+ *   - All 5 surfaces are present in the expected anchor set
+ */
+import { chromium } from 'playwright';
+import { readFileSync } from 'node:fs';
+
+const TOKEN = JSON.parse(readFileSync('/home/vansin/.anet/config.json', 'utf8')).token;
+const fresh = new Date(Date.now() - 60 * 1000).toISOString();
+
+const browser = await chromium.launch({ headless: true });
+const ctx = await browser.newContext({ viewport: { width: 1500, 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');
+  } catch {}
+});
+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: 'idle', 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('a·1'), mk('a·2')] } });
+});
+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: 'networkidle' });
+await page.waitForSelector('[data-topo-canvas-aria]', { timeout: 15000, state: 'attached' });
+await page.waitForTimeout(300);
+
+const result = await page.evaluate(() => {
+  const svg = document.querySelector('[data-topo-canvas-aria]');
+  const catalogAttr = svg?.getAttribute('data-topo-a11y-titles') ?? null;
+  let catalog = null;
+  try { catalog = JSON.parse(catalogAttr ?? ''); } catch {}
+
+  /* Direct child <title> only — skip nested titles in mask defs etc. */
+  const directTitleText = (el) => {
+    if (!el) return null;
+    for (const child of el.children) {
+      if (child.tagName.toLowerCase() === 'title') return child.textContent;
+    }
+    return null;
+  };
+
+  const crossChecks = Array.isArray(catalog)
+    ? catalog.map(entry => {
+        const el = document.querySelector(entry.selector);
+        return {
+          surface: entry.surface,
+          element_present: !!el,
+          actual_title: directTitleText(el),
+          matches: !el || directTitleText(el) === entry.accessible_name,
+        };
+      })
+    : [];
+
+  return { catalogAttr, catalog, crossChecks };
+});
+
+await browser.close();
+
+const { catalog, crossChecks } = result;
+
+const validShape = Array.isArray(catalog) && catalog.every(e =>
+  typeof e?.surface === 'string' && e.surface.length > 0
+  && typeof e?.selector === 'string' && e.selector.length > 0
+  && typeof e?.accessible_name === 'string' && e.accessible_name.length > 0
+);
+
+/* R733 relaxed canonical-format from "exactly 2 parts" to ">=2 parts"
+ * to admit the new hub-highlight entry's 3-part name ("hub · network
+ * center · idle indicator"). All earlier entries still match. */
+const canonicalFormat = (s) => typeof s === 'string' && /^[^·]+( · [^·]+)+$/.test(s);
+const allCanonical = Array.isArray(catalog) && catalog.every(e => canonicalFormat(e.accessible_name));
+
+const expectedSurfaces = ['canvas scan beam', 'canvas scan beam diagonal', 'canvas scan beam vertical', 'canvas-corner crescent', 'hub-highlight disc', 'legend panel title', 'recent panel title', 'title-block brand logo', 'watermark text'];
+const actualSurfaces = Array.isArray(catalog) ? catalog.map(e => e.surface).sort() : [];
+const surfacesMatch = JSON.stringify(actualSurfaces) === JSON.stringify(expectedSurfaces);
+
+const allCrossChecks = crossChecks.every(c => c.matches);
+
+const results = {
+  attr_present:                       !!result.catalogAttr,
+  json_parses:                        catalog !== null,
+  is_array:                           Array.isArray(catalog),
+  has_9_entries:                      Array.isArray(catalog) && catalog.length === 9,
+  shape_valid:                        validShape,
+  all_accessible_names_canonical:     allCanonical,
+  surfaces_match_expected_set:        surfacesMatch,
+  all_cross_checks_pass:              allCrossChecks,
+};
+const ok = Object.values(results).every(Boolean);
+console.log(`${ok ? '✅' : '❌'} R732 a11y titles catalog (7th meta-doc — pentagon→hexagon→HEPTAGON, cross-family):`,
+  JSON.stringify(results, null, 2),
+  `\n  catalog: ${JSON.stringify(catalog)}`,
+  `\n  cross-checks: ${JSON.stringify(crossChecks)}`);
+process.exit(ok ? 0 : 1);