From c1ae73fda39f752f4a8dd6b986b91f0c29d0c068 Mon Sep 17 00:00:00 2001
From: Thomas Petersen <thomasp@squareup.com>
Date: Tue, 4 Aug 2026 16:58:05 +0200
Subject: [PATCH] feat(desktop): preview cross-network passport signals with
 sample data
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Cross-server presence and full duplication counts need relay support
(adoption events, portable attestations), but their look shouldn't wait
for the protocol. Dev and e2e builds render a "Network record" block in
the catalog passport — other servers running the persona, network-wide
duplication, outside operators — clearly labelled Sample data and
deterministic per persona id. Production builds never show it.

Signed-off-by: Thomas Petersen <thomasp@squareup.com>
---
 .../agents/ui/PersonaCatalogPassport.tsx      |  7 ++
 .../ui/PersonaCatalogPassportPreview.tsx      | 97 +++++++++++++++++++
 desktop/src/features/passport/BADGES.md       |  5 +-
 .../e2e/persona-catalog-passport.spec.ts      |  8 ++
 4 files changed, 116 insertions(+), 1 deletion(-)
 create mode 100644 desktop/src/features/agents/ui/PersonaCatalogPassportPreview.tsx

diff --git a/desktop/src/features/agents/ui/PersonaCatalogPassport.tsx b/desktop/src/features/agents/ui/PersonaCatalogPassport.tsx
index afd3ee515f..74e2a2c2f4 100644
--- a/desktop/src/features/agents/ui/PersonaCatalogPassport.tsx
+++ b/desktop/src/features/agents/ui/PersonaCatalogPassport.tsx
@@ -9,6 +9,10 @@ import {
 import { countCatalogRepublishers } from "@/features/agents/lib/personaAdoption";
 import { usePersonaCatalogQuery } from "@/features/agents/lib/usePersonaCatalogRelay";
 import { useCommunities } from "@/features/communities/useCommunities";
+import {
+  isPassportNetworkPreviewEnabled,
+  PersonaCatalogPassportPreview,
+} from "@/features/agents/ui/PersonaCatalogPassportPreview";
 import { useAgentPassportBadges } from "@/features/passport/hooks/useAgentPassportBadges";
 import { PassportBadgeList } from "@/features/passport/ui/PassportBadges";
 import {
@@ -230,6 +234,9 @@ export function PersonaCatalogPassport({
               this community’s catalog.
             </p>
           ) : null}
+          {isPassportNetworkPreviewEnabled() ? (
+            <PersonaCatalogPassportPreview personaId={persona.id} />
+          ) : null}
           {publisherPubkey ? (
             <div>
               <Button
diff --git a/desktop/src/features/agents/ui/PersonaCatalogPassportPreview.tsx b/desktop/src/features/agents/ui/PersonaCatalogPassportPreview.tsx
new file mode 100644
index 0000000000..27a95c9529
--- /dev/null
+++ b/desktop/src/features/agents/ui/PersonaCatalogPassportPreview.tsx
@@ -0,0 +1,97 @@
+import { CopyPlus, Globe, Users } from "lucide-react";
+
+/**
+ * SAMPLE-DATA preview of the cross-network passport signals we cannot read
+ * from a single relay yet: which other servers run this persona, how many
+ * times it has been duplicated network-wide, and how many operators use it.
+ * See BADGES.md § "Wants relay support first" for what the real signals need
+ * (adoption event kind, portable attestations or a relay directory).
+ *
+ * Rendered only in dev and e2e builds, and visually labelled as sample data,
+ * so the mock numbers can never be mistaken for a real record. The values are
+ * derived deterministically from the persona id, so each entry keeps a stable,
+ * distinct-looking record across renders and app restarts.
+ */
+
+const SAMPLE_SERVERS = [
+  { host: "atlas.buzzmesh.dev", since: "Nov 2025" },
+  { host: "foundry-collective.net", since: "Jan 2026" },
+  { host: "relay.oss-hive.org", since: "Feb 2026" },
+  { host: "buzz.nightshift.team", since: "Mar 2026" },
+  { host: "commons.protolab.io", since: "Apr 2026" },
+  { host: "hivemind.builders", since: "Jun 2026" },
+] as const;
+
+/** FNV-1a, so the sample record is a stable function of the persona id. */
+function hashPersonaId(personaId: string): number {
+  let hash = 0x811c9dc5;
+  for (let index = 0; index < personaId.length; index += 1) {
+    hash ^= personaId.charCodeAt(index);
+    hash = Math.imul(hash, 0x01000193);
+  }
+  return hash >>> 0;
+}
+
+export function isPassportNetworkPreviewEnabled(): boolean {
+  return import.meta.env.DEV || import.meta.env.MODE === "e2e";
+}
+
+export function PersonaCatalogPassportPreview({
+  personaId,
+}: {
+  personaId: string;
+}) {
+  const seed = hashPersonaId(personaId);
+  const serverCount = 2 + (seed % 3);
+  const firstServer = seed % SAMPLE_SERVERS.length;
+  const servers = Array.from(
+    { length: serverCount },
+    (_, index) => SAMPLE_SERVERS[(firstServer + index) % SAMPLE_SERVERS.length],
+  );
+  const duplicateCount = 5 + ((seed >>> 8) % 24);
+  const operatorCount = serverCount + 1 + ((seed >>> 16) % 9);
+
+  return (
+    <div
+      className="space-y-2 rounded-xl border border-dashed border-border/70 p-3"
+      data-testid="persona-catalog-passport-preview"
+    >
+      <p className="flex items-center gap-2 text-3xs font-medium tracking-[0.25em] text-muted-foreground uppercase">
+        Network record
+        <span className="rounded-full border border-chart-4/60 px-1.5 py-px tracking-normal text-chart-4">
+          Sample data
+        </span>
+      </p>
+      <div className="flex items-center gap-2 text-sm text-muted-foreground">
+        <Globe className="h-3.5 w-3.5 shrink-0" />
+        <span>
+          Also running on {servers.length} other{" "}
+          {servers.length === 1 ? "server" : "servers"}
+        </span>
+      </div>
+      <div className="flex flex-wrap gap-1.5">
+        {servers.map((server) => (
+          <span
+            className="inline-flex items-baseline gap-1.5 rounded-lg border border-border bg-muted/40 px-2 py-1"
+            key={server.host}
+          >
+            <span className="font-mono text-2xs text-foreground">
+              {server.host}
+            </span>
+            <span className="text-3xs text-muted-foreground">
+              since {server.since}
+            </span>
+          </span>
+        ))}
+      </div>
+      <div className="flex items-center gap-2 text-sm text-muted-foreground">
+        <CopyPlus className="h-3.5 w-3.5 shrink-0" />
+        <span>Duplicated {duplicateCount} times across the network</span>
+      </div>
+      <div className="flex items-center gap-2 text-sm text-muted-foreground">
+        <Users className="h-3.5 w-3.5 shrink-0" />
+        <span>Run by {operatorCount} operators outside this community</span>
+      </div>
+    </div>
+  );
+}
diff --git a/desktop/src/features/passport/BADGES.md b/desktop/src/features/passport/BADGES.md
index 62f55f3d9c..de85d91cf5 100644
--- a/desktop/src/features/passport/BADGES.md
+++ b/desktop/src/features/passport/BADGES.md
@@ -81,7 +81,10 @@ the count is an honest lower bound, like everything else here. Engine:
 
 ## Wants relay support first
 
-Signals that belong here but aren't attributable to a pubkey on the relay yet:
+Signals that belong here but aren't attributable to a pubkey on the relay yet.
+Dev and e2e builds render a mocked "Network record" block (labelled *Sample
+data*, `PersonaCatalogPassportPreview.tsx`) in the catalog passport to preview
+how the first two would look; production builds never show it:
 
 - **Adopted** — the full duplication count (every add, not just re-shares).
   Catalog copies are local-only today (`catalogSource` on the adopter's
diff --git a/desktop/tests/e2e/persona-catalog-passport.spec.ts b/desktop/tests/e2e/persona-catalog-passport.spec.ts
index b8f90d3ae7..e05cfd7577 100644
--- a/desktop/tests/e2e/persona-catalog-passport.spec.ts
+++ b/desktop/tests/e2e/persona-catalog-passport.spec.ts
@@ -116,6 +116,14 @@ test("catalog entry shows the deployed agent's passport record", async ({
     .getByTestId("persona-catalog-detail-pane")
     .screenshot({ path: `${OUTDIR}/01-catalog-passport.png` });
 
+  // Sample-data network record (dev/e2e builds only, labelled as such).
+  const preview = passportSection.getByTestId(
+    "persona-catalog-passport-preview",
+  );
+  await preview.scrollIntoViewIfNeeded();
+  await expect(preview).toBeVisible();
+  await preview.screenshot({ path: `${OUTDIR}/03-network-preview.png` });
+
   // The chip closes the dialog and lands on the agent's full passport.
   await passportSection.getByTestId("passport-agent-chip").click();
   await expect(page.getByTestId("persona-catalog-dialog")).toHaveCount(0);