From bf9daa9810ad31e98cf548334c566b75a7f0cffc Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Sun, 16 Aug 2026 19:32:42 +0900
Subject: [PATCH 1/7] feat: show Our side / Counterparty on related-node person
 chips (v0.72.0)

Related chips still said "Ada West (Person)" even though the payload
already had person_side_code. Attach person_side_label from
common_lookup_value and use that caption (and accessible name) so the
buyer sees Our side / Counterparty, not the ontology class.
---
 ARCHITECTURE.md                |  4 +++-
 CHANGELOG.md                   | 12 ++++++++++
 backend/app/knowledge_graph.py |  8 ++++++-
 backend/tests/test_api.py      |  5 +++++
 frontend/package.json          |  2 +-
 frontend/src/App.test.tsx      | 41 +++++++++++++++++++++++++++-------
 frontend/src/App.tsx           | 16 +++++++++++--
 frontend/src/api.ts            |  1 +
 lineageweave/__init__.py       |  2 +-
 pyproject.toml                 |  2 +-
 uv.lock                        |  2 +-
 11 files changed, 79 insertions(+), 16 deletions(-)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 617b8b95d..37c10f5b9 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -320,7 +320,9 @@ is the same never-guess-a-parent rule
 `corporate_hierarchy_resolution` already applies. Entity levels and
 Keyman sides are labeled from `common_lookup_value` (`Our side`,
 `Plant`, `Company`) so the popup never shows raw `our_side` / `plant`
-codes when a label exists.
+codes when a label exists. Related-node person chips use the same
+side label (`Ada West (Our side)`), not the ontology class
+(`Ada West (Person)`).
 
 `GET /api/posts` and `GET /api/posts/{post_id}` include
 `voc_type_label` / `visibility_label` from `common_lookup_value` so
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0096828a2..67e87e9b3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,18 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.72.0] - 2026-08-16
+
+### Changed
+
+- Related-node person chips use the `person_side` lookup label instead
+  of the ontology class. After `make seed`, walking from Ada West
+  shows "Priya Nair (Counterparty)" and walking from Demo Corp shows
+  "Ada West (Our side)" -- not "Ada West (Person)". The payload
+  already had `person_side_code`; it now also carries
+  `person_side_label` from `common_lookup_value`. The same caption is
+  the button accessible name.
+
 ## [0.71.0] - 2026-08-14
 
 ### Added
diff --git a/backend/app/knowledge_graph.py b/backend/app/knowledge_graph.py
index bb398d141..6b7fc60d9 100644
--- a/backend/app/knowledge_graph.py
+++ b/backend/app/knowledge_graph.py
@@ -320,6 +320,10 @@ async def hydrate_related_nodes(
         )
     } if corp_ids else {}
 
+    side_labels = await labels_for_codes(
+        conn, [row["person_side_code"] for row in people.values()]
+    )
+
     payload: list[dict[str, Any]] = []
     for node_type_code, node_id, score in parsed:
         item: dict[str, Any] = {
@@ -329,8 +333,10 @@ async def hydrate_related_nodes(
             **ontology_annotations(node_type_code),
         }
         if node_type_code == NODE_PERSON and node_id in people:
+            side = people[node_id]["person_side_code"]
             item["label"] = people[node_id]["person_name"]
-            item["person_side_code"] = people[node_id]["person_side_code"]
+            item["person_side_code"] = side
+            item["person_side_label"] = side_labels.get(side, side)
         elif node_type_code == NODE_POST and node_id in posts:
             item["label"] = posts[node_id]["post_title"]
         elif node_type_code == NODE_CORPORATE_ENTITY and node_id in corps:
diff --git a/backend/tests/test_api.py b/backend/tests/test_api.py
index 74ab44701..1abca6b49 100644
--- a/backend/tests/test_api.py
+++ b/backend/tests/test_api.py
@@ -883,6 +883,8 @@ def test_related_keymen_use_rwr_and_hide_invisible_posts(client, demo_analyst_to
     counterpart = by_id[seeded_db["counterpart_person_id"]]
     assert counterpart["ontology_label"] == "Person"
     assert counterpart["ontology_iri"].endswith("#Person")
+    assert counterpart["person_side_code"] == "counterparty"
+    assert counterpart["person_side_label"] == "Counterparty"
     own_post = by_id[seeded_db["own_private_post_id"]]
     assert own_post["ontology_label"] == "Post"
 
@@ -902,6 +904,9 @@ def test_related_corporate_entity_uses_rwr_and_hides_invisible_posts(
     assert body["entity_name"] == "Test Corp"
     related_ids = {node["node_id"] for node in body["related"]}
     assert seeded_db["our_person_id"] in related_ids
+    our_person = next(node for node in body["related"] if node["node_id"] == seeded_db["our_person_id"])
+    assert our_person["person_side_code"] == "our_side"
+    assert our_person["person_side_label"] == "Our side"
     assert seeded_db["other_private_post_id"] not in related_ids
     assert seeded_db["hidden_person_id"] not in related_ids
 
diff --git a/frontend/package.json b/frontend/package.json
index 9c84795d9..0f1fa4ce8 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "0.71.0",
+  "version": "0.72.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx
index 415e1419f..72e7c72f1 100644
--- a/frontend/src/App.test.tsx
+++ b/frontend/src/App.test.tsx
@@ -514,6 +514,8 @@ describe("App, authenticated", () => {
                 ontology_iri: "https://contextualwisdomlab.github.io/lineageweave/ontology#Person",
                 ontology_label: "Person",
                 label: "Ada West",
+                person_side_code: "our_side",
+                person_side_label: "Our side",
                 relevance: 0.4,
               },
             ],
@@ -533,6 +535,8 @@ describe("App, authenticated", () => {
                 ontology_iri: "https://contextualwisdomlab.github.io/lineageweave/ontology#Person",
                 ontology_label: "Person",
                 label: "Priya Nair",
+                person_side_code: "counterparty",
+                person_side_label: "Counterparty",
                 relevance: 0.4,
               },
               {
@@ -567,6 +571,8 @@ describe("App, authenticated", () => {
                 ontology_iri: "https://contextualwisdomlab.github.io/lineageweave/ontology#Person",
                 ontology_label: "Person",
                 label: "Ada West",
+                person_side_code: "our_side",
+                person_side_label: "Our side",
                 relevance: 0.5,
               },
             ],
@@ -969,7 +975,12 @@ describe("App, authenticated", () => {
 
     await userEvent.click(screen.getByRole("button", { name: "Related nodes for Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
-    expect(screen.getByText("Priya Nair (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Priya Nair (Counterparty)" }),
+    ).toBeInTheDocument();
+    expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
+      "Priya Nair (Person)",
+    );
     await userEvent.click(screen.getByRole("button", { name: "Open related post: Linked post" }));
     await waitFor(() =>
       expect(screen.getByText("The evidence panel should show exactly this text.")).toBeInTheDocument(),
@@ -982,7 +993,9 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(await screen.findByRole("button", { name: "R&R Keyman: Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
-    expect(screen.getByText("Priya Nair (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Priya Nair (Counterparty)" }),
+    ).toBeInTheDocument();
   });
 
   it("opens related nodes from a related corporate entity", async () => {
@@ -993,7 +1006,9 @@ describe("App, authenticated", () => {
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
     await userEvent.click(screen.getByRole("button", { name: "Related nodes for Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
-    expect(screen.getByText("Ada West (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+    ).toBeInTheDocument();
   });
 
   it("shows the VOC excerpt under its counterparty, not a detached list", async () => {
@@ -1022,7 +1037,9 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(await screen.findByRole("button", { name: "VOC Keyman: Northridge Grid" }));
     await waitFor(() => expect(screen.getByText("Related to Priya Nair")).toBeInTheDocument());
-    expect(screen.getByText("Ada West (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+    ).toBeInTheDocument();
   });
 
   it("opens related Keyman nodes from an affiliate-tree person", async () => {
@@ -1031,7 +1048,9 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(await screen.findByRole("button", { name: "Affiliate Keyman: Priya Nair" }));
     await waitFor(() => expect(screen.getByText("Related to Priya Nair")).toBeInTheDocument());
-    expect(screen.getByText("Ada West (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+    ).toBeInTheDocument();
   });
 
   it("opens related nodes from a Keyman affiliation organization", async () => {
@@ -1040,7 +1059,9 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(await screen.findByRole("button", { name: "Keyman affiliation: Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
-    expect(screen.getByText("Ada West (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+    ).toBeInTheDocument();
   });
 
   it("opens related nodes from an affiliate-tree organization", async () => {
@@ -1049,7 +1070,9 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(await screen.findByRole("button", { name: "Affiliate org: Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
-    expect(screen.getByText("Ada West (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+    ).toBeInTheDocument();
     expect(screen.queryByRole("button", { name: "Affiliate org: Northridge Grid" })).not.toBeInTheDocument();
   });
 
@@ -1059,7 +1082,9 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(await screen.findByRole("button", { name: "Counterparty org: Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
-    expect(screen.getByText("Ada West (Person)")).toBeInTheDocument();
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+    ).toBeInTheDocument();
     expect(screen.queryByRole("button", { name: "Counterparty org: Northridge Grid" })).not.toBeInTheDocument();
   });
 
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 1e39a9253..57f5a5185 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -466,6 +466,18 @@ function VocEvidenceSection({
 }
 
 const NODE_PERSON = "node_person";
+
+function relatedNodeCaption(node: RelatedNode): string {
+  const name = node.label ?? node.node_id;
+  if (node.node_type_code === NODE_PERSON) {
+    const side = node.person_side_label ?? node.person_side_code;
+    if (side) {
+      return `${name} (${side})`;
+    }
+  }
+  return `${name} (${node.ontology_label ?? node.node_type_code})`;
+}
+
 const NODE_POST = "node_post";
 const NODE_CORPORATE_ENTITY = "node_corporate_entity";
 
@@ -677,7 +689,7 @@ function KeymanPanel({
           ) : (
             <ul>
               {related.map((node) => {
-                const caption = `${node.label ?? node.node_id} (${node.ontology_label ?? node.node_type_code})`;
+                const caption = relatedNodeCaption(node);
                 if (node.node_type_code === NODE_POST && onSelectPost) {
                   return (
                     <li key={`${node.node_type_code}:${node.node_id}`}>
@@ -696,7 +708,7 @@ function KeymanPanel({
                     <li key={`${node.node_type_code}:${node.node_id}`}>
                       <button
                         className="keyman-select"
-                        aria-label={`Related nodes for ${node.label ?? node.node_id}`}
+                        aria-label={`Related nodes for ${caption}`}
                         onClick={() => handleSelect(node.node_id, node.label ?? node.node_id)}
                       >
                         {caption}
diff --git a/frontend/src/api.ts b/frontend/src/api.ts
index 2b6692776..fc5c1cf30 100644
--- a/frontend/src/api.ts
+++ b/frontend/src/api.ts
@@ -78,6 +78,7 @@ export interface RelatedNode {
   relevance: number;
   label?: string;
   person_side_code?: string;
+  person_side_label?: string;
   ontology_iri?: string;
   ontology_label?: string;
 }
diff --git a/lineageweave/__init__.py b/lineageweave/__init__.py
index 0ac8e50fe..07f5c5c58 100644
--- a/lineageweave/__init__.py
+++ b/lineageweave/__init__.py
@@ -35,4 +35,4 @@
     "sentence_excerpts",
 ]
 
-__version__ = "0.71.0"
+__version__ = "0.72.0"
diff --git a/pyproject.toml b/pyproject.toml
index 9a2272d3a..e3a80b99b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "lineageweave"
-version = "0.71.0"
+version = "0.72.0"
 description = "Reconstructs git-branch-style lineage DAGs from scattered short records using multi-channel score fusion and LLM adjudication."
 readme = "README.md"
 license = { text = "MIT" }
diff --git a/uv.lock b/uv.lock
index 1964f34b9..e7cfaab48 100644
--- a/uv.lock
+++ b/uv.lock
@@ -355,7 +355,7 @@ wheels = [
 
 [[package]]
 name = "lineageweave"
-version = "0.71.0"
+version = "0.72.0"
 source = { virtual = "." }
 dependencies = [
     { name = "certifi" },

From 86969db6dc633327ce0f4065d79c04e001743a01 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Sun, 16 Aug 2026 19:53:01 +0900
Subject: [PATCH 2/7] feat: show Company / Group on related-node org chips
 (v0.73.0) (#93)

Buyer gap: after person chips used Our side / Counterparty, org chips
still said Demo Corp (Organization). Hydrate entity_level_label from
common_lookup_value so the walk reads Demo Corp (Company). Missing
lookups fall back to the code. Never invents a level.
---
 ARCHITECTURE.md                |  3 ++-
 CHANGELOG.md                   | 11 +++++++++++
 backend/app/knowledge_graph.py |  9 ++++++++-
 backend/tests/test_api.py      |  9 +++++++++
 frontend/package.json          |  2 +-
 frontend/src/App.test.tsx      | 10 +++++++++-
 frontend/src/App.tsx           | 13 +++++++++----
 frontend/src/api.ts            |  2 ++
 lineageweave/__init__.py       |  2 +-
 pyproject.toml                 |  2 +-
 uv.lock                        |  2 +-
 11 files changed, 54 insertions(+), 11 deletions(-)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 37c10f5b9..032659fcc 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -322,7 +322,8 @@ Keyman sides are labeled from `common_lookup_value` (`Our side`,
 `Plant`, `Company`) so the popup never shows raw `our_side` / `plant`
 codes when a label exists. Related-node person chips use the same
 side label (`Ada West (Our side)`), not the ontology class
-(`Ada West (Person)`).
+(`Ada West (Person)`). Related-node organization chips use the
+entity-level label (`Demo Corp (Company)`), not `Organization`.
 
 `GET /api/posts` and `GET /api/posts/{post_id}` include
 `voc_type_label` / `visibility_label` from `common_lookup_value` so
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 67e87e9b3..9d23cbdff 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,17 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.73.0] - 2026-08-16
+
+### Changed
+
+- Related-node organization chips use the `entity_level` lookup
+  label instead of the ontology class. After `make seed`, walking
+  from Ada West shows "Demo Corp (Company)" -- not "Demo Corp
+  (Organization)". The payload now carries `entity_level_label`
+  from `common_lookup_value`. Missing lookups fall back to the
+  code. The same caption is the button accessible name.
+
 ## [0.72.0] - 2026-08-16
 
 ### Changed
diff --git a/backend/app/knowledge_graph.py b/backend/app/knowledge_graph.py
index 6b7fc60d9..32a3b1b2e 100644
--- a/backend/app/knowledge_graph.py
+++ b/backend/app/knowledge_graph.py
@@ -315,7 +315,8 @@ async def hydrate_related_nodes(
     corps = {
         str(row["corporate_entity_id"]): row
         for row in await conn.fetch(
-            "select corporate_entity_id, entity_name from corporate_entity where corporate_entity_id = any($1::uuid[])",
+            "select corporate_entity_id, entity_name, entity_level_code "
+            "from corporate_entity where corporate_entity_id = any($1::uuid[])",
             corp_ids,
         )
     } if corp_ids else {}
@@ -323,6 +324,9 @@ async def hydrate_related_nodes(
     side_labels = await labels_for_codes(
         conn, [row["person_side_code"] for row in people.values()]
     )
+    level_labels = await labels_for_codes(
+        conn, [row["entity_level_code"] for row in corps.values()]
+    )
 
     payload: list[dict[str, Any]] = []
     for node_type_code, node_id, score in parsed:
@@ -340,7 +344,10 @@ async def hydrate_related_nodes(
         elif node_type_code == NODE_POST and node_id in posts:
             item["label"] = posts[node_id]["post_title"]
         elif node_type_code == NODE_CORPORATE_ENTITY and node_id in corps:
+            level = corps[node_id]["entity_level_code"]
             item["label"] = corps[node_id]["entity_name"]
+            item["entity_level_code"] = level
+            item["entity_level_label"] = level_labels.get(level, level)
         else:
             continue
         payload.append(item)
diff --git a/backend/tests/test_api.py b/backend/tests/test_api.py
index 1abca6b49..00cf78b47 100644
--- a/backend/tests/test_api.py
+++ b/backend/tests/test_api.py
@@ -887,6 +887,15 @@ def test_related_keymen_use_rwr_and_hide_invisible_posts(client, demo_analyst_to
     assert counterpart["person_side_label"] == "Counterparty"
     own_post = by_id[seeded_db["own_private_post_id"]]
     assert own_post["ontology_label"] == "Post"
+    corp_nodes = [
+        node for node in body["related"] if node["node_type_code"] == "node_corporate_entity"
+    ]
+    assert corp_nodes
+    assert all(node.get("entity_level_label") for node in corp_nodes)
+    if seeded_db["own_corp_id"] in related_ids:
+        own_corp = by_id[seeded_db["own_corp_id"]]
+        assert own_corp["entity_level_code"] == "company"
+        assert own_corp["entity_level_label"] == "Company"
 
 
 def test_related_corporate_entity_uses_rwr_and_hides_invisible_posts(
diff --git a/frontend/package.json b/frontend/package.json
index 0f1fa4ce8..4bd6a4c6e 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "0.72.0",
+  "version": "0.73.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx
index 72e7c72f1..2816927e2 100644
--- a/frontend/src/App.test.tsx
+++ b/frontend/src/App.test.tsx
@@ -553,6 +553,8 @@ describe("App, authenticated", () => {
                 ontology_iri: "https://contextualwisdomlab.github.io/lineageweave/ontology#Organization",
                 ontology_label: "Organization",
                 label: "Demo Corp",
+                entity_level_code: "company",
+                entity_level_label: "Company",
                 relevance: 0.2,
               },
             ],
@@ -1004,7 +1006,13 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "View post: Public post" }));
     await userEvent.click(screen.getByRole("button", { name: "Related nodes for Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
-    await userEvent.click(screen.getByRole("button", { name: "Related nodes for Demo Corp" }));
+    expect(
+      screen.getByRole("button", { name: "Related nodes for Demo Corp (Company)" }),
+    ).toBeInTheDocument();
+    expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
+      "Demo Corp (Organization)",
+    );
+    await userEvent.click(screen.getByRole("button", { name: "Related nodes for Demo Corp (Company)" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
     expect(
       screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 57f5a5185..37316da51 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -466,6 +466,8 @@ function VocEvidenceSection({
 }
 
 const NODE_PERSON = "node_person";
+const NODE_POST = "node_post";
+const NODE_CORPORATE_ENTITY = "node_corporate_entity";
 
 function relatedNodeCaption(node: RelatedNode): string {
   const name = node.label ?? node.node_id;
@@ -475,12 +477,15 @@ function relatedNodeCaption(node: RelatedNode): string {
       return `${name} (${side})`;
     }
   }
+  if (node.node_type_code === NODE_CORPORATE_ENTITY) {
+    const level = node.entity_level_label ?? node.entity_level_code;
+    if (level) {
+      return `${name} (${level})`;
+    }
+  }
   return `${name} (${node.ontology_label ?? node.node_type_code})`;
 }
 
-const NODE_POST = "node_post";
-const NODE_CORPORATE_ENTITY = "node_corporate_entity";
-
 const VERIFICATION_BADGE: Record<string, string> = {
   verify_pending: "Not yet checked",
   verify_corroborated: "Corroborated",
@@ -721,7 +726,7 @@ function KeymanPanel({
                     <li key={`${node.node_type_code}:${node.node_id}`}>
                       <button
                         className="keyman-select"
-                        aria-label={`Related nodes for ${node.label ?? node.node_id}`}
+                        aria-label={`Related nodes for ${caption}`}
                         onClick={() => handleSelectEntity(node.node_id, node.label ?? node.node_id)}
                       >
                         {caption}
diff --git a/frontend/src/api.ts b/frontend/src/api.ts
index fc5c1cf30..9ec00dd47 100644
--- a/frontend/src/api.ts
+++ b/frontend/src/api.ts
@@ -79,6 +79,8 @@ export interface RelatedNode {
   label?: string;
   person_side_code?: string;
   person_side_label?: string;
+  entity_level_code?: string;
+  entity_level_label?: string;
   ontology_iri?: string;
   ontology_label?: string;
 }
diff --git a/lineageweave/__init__.py b/lineageweave/__init__.py
index 07f5c5c58..a24d86838 100644
--- a/lineageweave/__init__.py
+++ b/lineageweave/__init__.py
@@ -35,4 +35,4 @@
     "sentence_excerpts",
 ]
 
-__version__ = "0.72.0"
+__version__ = "0.73.0"
diff --git a/pyproject.toml b/pyproject.toml
index e3a80b99b..f8ae2a958 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "lineageweave"
-version = "0.72.0"
+version = "0.73.0"
 description = "Reconstructs git-branch-style lineage DAGs from scattered short records using multi-channel score fusion and LLM adjudication."
 readme = "README.md"
 license = { text = "MIT" }
diff --git a/uv.lock b/uv.lock
index e7cfaab48..0115d4243 100644
--- a/uv.lock
+++ b/uv.lock
@@ -355,7 +355,7 @@ wheels = [
 
 [[package]]
 name = "lineageweave"
-version = "0.72.0"
+version = "0.73.0"
 source = { virtual = "." }
 dependencies = [
     { name = "certifi" },

From f6695098f312f05156484fb1ef0dd1ded0eb425e Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Sun, 16 Aug 2026 20:52:39 +0900
Subject: [PATCH 3/7] feat: show related-node post chips as the title only
 (v0.74.0) (#97)

Buyer gap: person chips say Our side / Counterparty and org chips
say Company, but post chips still appended (Post). The related
walk now shows the post title only.
---
 ARCHITECTURE.md           | 1 +
 CHANGELOG.md              | 8 ++++++++
 frontend/package.json     | 2 +-
 frontend/src/App.test.tsx | 3 +++
 frontend/src/App.tsx      | 3 +++
 lineageweave/__init__.py  | 2 +-
 pyproject.toml            | 2 +-
 uv.lock                   | 2 +-
 8 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 032659fcc..879e55537 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -324,6 +324,7 @@ codes when a label exists. Related-node person chips use the same
 side label (`Ada West (Our side)`), not the ontology class
 (`Ada West (Person)`). Related-node organization chips use the
 entity-level label (`Demo Corp (Company)`), not `Organization`.
+Related-node post chips show the post title only, not `(Post)`.
 
 `GET /api/posts` and `GET /api/posts/{post_id}` include
 `voc_type_label` / `visibility_label` from `common_lookup_value` so
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9d23cbdff..070e28620 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,14 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.74.0] - 2026-08-16
+
+### Changed
+
+- Related-node post chips show the post title only, not
+  "Linked post (Post)". Person and org chips already use business
+  labels; the ontology class on a post title was noise.
+
 ## [0.73.0] - 2026-08-16
 
 ### Changed
diff --git a/frontend/package.json b/frontend/package.json
index 4bd6a4c6e..3c4d979ad 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "0.73.0",
+  "version": "0.74.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx
index 2816927e2..1b1a8fe39 100644
--- a/frontend/src/App.test.tsx
+++ b/frontend/src/App.test.tsx
@@ -983,6 +983,9 @@ describe("App, authenticated", () => {
     expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
       "Priya Nair (Person)",
     );
+    const relatedPanel = screen.getByText("Related to Ada West").closest(".related-keymen");
+    expect(relatedPanel).toHaveTextContent("Linked post");
+    expect(relatedPanel).not.toHaveTextContent("Linked post (Post)");
     await userEvent.click(screen.getByRole("button", { name: "Open related post: Linked post" }));
     await waitFor(() =>
       expect(screen.getByText("The evidence panel should show exactly this text.")).toBeInTheDocument(),
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 37316da51..58e085538 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -483,6 +483,9 @@ function relatedNodeCaption(node: RelatedNode): string {
       return `${name} (${level})`;
     }
   }
+  if (node.node_type_code === NODE_POST) {
+    return name;
+  }
   return `${name} (${node.ontology_label ?? node.node_type_code})`;
 }
 
diff --git a/lineageweave/__init__.py b/lineageweave/__init__.py
index a24d86838..9c249405a 100644
--- a/lineageweave/__init__.py
+++ b/lineageweave/__init__.py
@@ -35,4 +35,4 @@
     "sentence_excerpts",
 ]
 
-__version__ = "0.73.0"
+__version__ = "0.74.0"
diff --git a/pyproject.toml b/pyproject.toml
index f8ae2a958..61e982c3a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "lineageweave"
-version = "0.73.0"
+version = "0.74.0"
 description = "Reconstructs git-branch-style lineage DAGs from scattered short records using multi-channel score fusion and LLM adjudication."
 readme = "README.md"
 license = { text = "MIT" }
diff --git a/uv.lock b/uv.lock
index 0115d4243..3f4889126 100644
--- a/uv.lock
+++ b/uv.lock
@@ -355,7 +355,7 @@ wheels = [
 
 [[package]]
 name = "lineageweave"
-version = "0.73.0"
+version = "0.74.0"
 source = { virtual = "." }
 dependencies = [
     { name = "certifi" },

From 2fb74bce45317f7d81359278426ce108d0b1d44d Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Sun, 16 Aug 2026 21:33:35 +0900
Subject: [PATCH 4/7] feat: show affiliation on related-node person chips
 (v0.75.0)

Related person chips use the primary affiliation organization when one exists. After make seed, Ada West walks to Priya Nair, Northridge Grid (Counterparty) and Demo Corp walks to Ada West, Demo Corp (Our side). Missing affiliations stay omitted.
---
 ARCHITECTURE.md                |  6 ++++--
 CHANGELOG.md                   | 11 +++++++++++
 backend/app/knowledge_graph.py | 24 ++++++++++++++++++++++++
 backend/tests/test_api.py      |  8 ++++++++
 frontend/package.json          |  2 +-
 frontend/src/App.test.tsx      | 22 ++++++++++++++--------
 frontend/src/App.tsx           |  4 ++++
 frontend/src/api.ts            |  1 +
 lineageweave/__init__.py       |  2 +-
 pyproject.toml                 |  2 +-
 uv.lock                        |  2 +-
 11 files changed, 70 insertions(+), 14 deletions(-)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 879e55537..ccfd338ad 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -321,8 +321,10 @@ is the same never-guess-a-parent rule
 Keyman sides are labeled from `common_lookup_value` (`Our side`,
 `Plant`, `Company`) so the popup never shows raw `our_side` / `plant`
 codes when a label exists. Related-node person chips use the same
-side label (`Ada West (Our side)`), not the ontology class
-(`Ada West (Person)`). Related-node organization chips use the
+side label plus the primary affiliation when one exists
+(`Ada West, Demo Corp (Our side)`), not the ontology class
+(`Ada West (Person)`). A missing affiliation is omitted, never
+guessed. Related-node organization chips use the
 entity-level label (`Demo Corp (Company)`), not `Organization`.
 Related-node post chips show the post title only, not `(Post)`.
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 070e28620..1fe719dc1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,17 @@ All notable changes to this project are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.75.0] - 2026-08-16
+
+### Changed
+
+- Related-node person chips include the primary affiliation
+  organization when one exists. After `make seed`, walking from Ada
+  West shows "Priya Nair, Northridge Grid (Counterparty)" and walking
+  from Demo Corp shows "Ada West, Demo Corp (Our side)". A person with
+  no affiliation keeps the side-only caption -- the org is never
+  guessed. Resolved catalog orgs win over unresolved names.
+
 ## [0.74.0] - 2026-08-16
 
 ### Changed
diff --git a/backend/app/knowledge_graph.py b/backend/app/knowledge_graph.py
index 32a3b1b2e..1d37981c4 100644
--- a/backend/app/knowledge_graph.py
+++ b/backend/app/knowledge_graph.py
@@ -283,6 +283,8 @@ async def hydrate_related_nodes(
 
     Unknown ids are dropped. Ontology fields are omitted (not faked)
     when ``node_type_code`` has no term in lineageweave-kg.ttl.
+    Person nodes carry the primary affiliation organization when one
+    exists; a missing affiliation is omitted, never invented.
     """
     person_ids: list[str] = []
     post_ids: list[str] = []
@@ -305,6 +307,25 @@ async def hydrate_related_nodes(
             person_ids,
         )
     } if person_ids else {}
+    affiliations: dict[str, str] = {}
+    if person_ids:
+        affiliation_rows = await conn.fetch(
+            """
+            select person_id, affiliated_organization_name, affiliated_corporate_entity_id
+            from person_affiliation
+            where person_id = any($1::uuid[])
+            order by
+              (affiliated_corporate_entity_id is not null) desc,
+              affiliated_organization_name
+            """,
+            person_ids,
+        )
+        for row in affiliation_rows:
+            person_id = str(row["person_id"])
+            org = (row["affiliated_organization_name"] or "").strip()
+            if person_id in affiliations or not org:
+                continue
+            affiliations[person_id] = org
     posts = {
         str(row["post_id"]): row
         for row in await conn.fetch(
@@ -341,6 +362,9 @@ async def hydrate_related_nodes(
             item["label"] = people[node_id]["person_name"]
             item["person_side_code"] = side
             item["person_side_label"] = side_labels.get(side, side)
+            org = affiliations.get(node_id)
+            if org:
+                item["affiliation_organization_name"] = org
         elif node_type_code == NODE_POST and node_id in posts:
             item["label"] = posts[node_id]["post_title"]
         elif node_type_code == NODE_CORPORATE_ENTITY and node_id in corps:
diff --git a/backend/tests/test_api.py b/backend/tests/test_api.py
index 00cf78b47..6f2b42ca2 100644
--- a/backend/tests/test_api.py
+++ b/backend/tests/test_api.py
@@ -885,6 +885,13 @@ def test_related_keymen_use_rwr_and_hide_invisible_posts(client, demo_analyst_to
     assert counterpart["ontology_iri"].endswith("#Person")
     assert counterpart["person_side_code"] == "counterparty"
     assert counterpart["person_side_label"] == "Counterparty"
+    assert counterpart["affiliation_organization_name"] == "Northridge Grid"
+    for node in body["related"]:
+        if node["node_type_code"] != "node_person":
+            continue
+        org = node.get("affiliation_organization_name")
+        if org is not None:
+            assert org.strip()
     own_post = by_id[seeded_db["own_private_post_id"]]
     assert own_post["ontology_label"] == "Post"
     corp_nodes = [
@@ -916,6 +923,7 @@ def test_related_corporate_entity_uses_rwr_and_hides_invisible_posts(
     our_person = next(node for node in body["related"] if node["node_id"] == seeded_db["our_person_id"])
     assert our_person["person_side_code"] == "our_side"
     assert our_person["person_side_label"] == "Our side"
+    assert our_person["affiliation_organization_name"] == "Test Corp"
     assert seeded_db["other_private_post_id"] not in related_ids
     assert seeded_db["hidden_person_id"] not in related_ids
 
diff --git a/frontend/package.json b/frontend/package.json
index 3c4d979ad..575b7c586 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,7 +1,7 @@
 {
   "name": "frontend",
   "private": true,
-  "version": "0.74.0",
+  "version": "0.75.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx
index 1b1a8fe39..0ec540338 100644
--- a/frontend/src/App.test.tsx
+++ b/frontend/src/App.test.tsx
@@ -516,6 +516,7 @@ describe("App, authenticated", () => {
                 label: "Ada West",
                 person_side_code: "our_side",
                 person_side_label: "Our side",
+                affiliation_organization_name: "Demo Corp",
                 relevance: 0.4,
               },
             ],
@@ -537,6 +538,7 @@ describe("App, authenticated", () => {
                 label: "Priya Nair",
                 person_side_code: "counterparty",
                 person_side_label: "Counterparty",
+                affiliation_organization_name: "Northridge Grid",
                 relevance: 0.4,
               },
               {
@@ -575,6 +577,7 @@ describe("App, authenticated", () => {
                 label: "Ada West",
                 person_side_code: "our_side",
                 person_side_label: "Our side",
+                affiliation_organization_name: "Demo Corp",
                 relevance: 0.5,
               },
             ],
@@ -978,11 +981,14 @@ describe("App, authenticated", () => {
     await userEvent.click(screen.getByRole("button", { name: "Related nodes for Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Priya Nair (Counterparty)" }),
+      screen.getByRole("button", { name: "Related nodes for Priya Nair, Northridge Grid (Counterparty)" }),
     ).toBeInTheDocument();
     expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
       "Priya Nair (Person)",
     );
+    expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
+      "Priya Nair (Counterparty)",
+    );
     const relatedPanel = screen.getByText("Related to Ada West").closest(".related-keymen");
     expect(relatedPanel).toHaveTextContent("Linked post");
     expect(relatedPanel).not.toHaveTextContent("Linked post (Post)");
@@ -999,7 +1005,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "R&R Keyman: Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Priya Nair (Counterparty)" }),
+      screen.getByRole("button", { name: "Related nodes for Priya Nair, Northridge Grid (Counterparty)" }),
     ).toBeInTheDocument();
   });
 
@@ -1018,7 +1024,7 @@ describe("App, authenticated", () => {
     await userEvent.click(screen.getByRole("button", { name: "Related nodes for Demo Corp (Company)" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+      screen.getByRole("button", { name: "Related nodes for Ada West, Demo Corp (Our side)" }),
     ).toBeInTheDocument();
   });
 
@@ -1049,7 +1055,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "VOC Keyman: Northridge Grid" }));
     await waitFor(() => expect(screen.getByText("Related to Priya Nair")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+      screen.getByRole("button", { name: "Related nodes for Ada West, Demo Corp (Our side)" }),
     ).toBeInTheDocument();
   });
 
@@ -1060,7 +1066,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "Affiliate Keyman: Priya Nair" }));
     await waitFor(() => expect(screen.getByText("Related to Priya Nair")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+      screen.getByRole("button", { name: "Related nodes for Ada West, Demo Corp (Our side)" }),
     ).toBeInTheDocument();
   });
 
@@ -1071,7 +1077,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "Keyman affiliation: Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+      screen.getByRole("button", { name: "Related nodes for Ada West, Demo Corp (Our side)" }),
     ).toBeInTheDocument();
   });
 
@@ -1082,7 +1088,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "Affiliate org: Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+      screen.getByRole("button", { name: "Related nodes for Ada West, Demo Corp (Our side)" }),
     ).toBeInTheDocument();
     expect(screen.queryByRole("button", { name: "Affiliate org: Northridge Grid" })).not.toBeInTheDocument();
   });
@@ -1094,7 +1100,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "Counterparty org: Demo Corp" }));
     await waitFor(() => expect(screen.getByText("Related to Demo Corp")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Ada West (Our side)" }),
+      screen.getByRole("button", { name: "Related nodes for Ada West, Demo Corp (Our side)" }),
     ).toBeInTheDocument();
     expect(screen.queryByRole("button", { name: "Counterparty org: Northridge Grid" })).not.toBeInTheDocument();
   });
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index 58e085538..af3d9e348 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -473,6 +473,10 @@ function relatedNodeCaption(node: RelatedNode): string {
   const name = node.label ?? node.node_id;
   if (node.node_type_code === NODE_PERSON) {
     const side = node.person_side_label ?? node.person_side_code;
+    const org = node.affiliation_organization_name?.trim();
+    if (side && org) {
+      return `${name}, ${org} (${side})`;
+    }
     if (side) {
       return `${name} (${side})`;
     }
diff --git a/frontend/src/api.ts b/frontend/src/api.ts
index 9ec00dd47..960bf9157 100644
--- a/frontend/src/api.ts
+++ b/frontend/src/api.ts
@@ -79,6 +79,7 @@ export interface RelatedNode {
   label?: string;
   person_side_code?: string;
   person_side_label?: string;
+  affiliation_organization_name?: string;
   entity_level_code?: string;
   entity_level_label?: string;
   ontology_iri?: string;
diff --git a/lineageweave/__init__.py b/lineageweave/__init__.py
index 9c249405a..1710c009e 100644
--- a/lineageweave/__init__.py
+++ b/lineageweave/__init__.py
@@ -35,4 +35,4 @@
     "sentence_excerpts",
 ]
 
-__version__ = "0.74.0"
+__version__ = "0.75.0"
diff --git a/pyproject.toml b/pyproject.toml
index 61e982c3a..764ebad72 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "lineageweave"
-version = "0.74.0"
+version = "0.75.0"
 description = "Reconstructs git-branch-style lineage DAGs from scattered short records using multi-channel score fusion and LLM adjudication."
 readme = "README.md"
 license = { text = "MIT" }
diff --git a/uv.lock b/uv.lock
index 3f4889126..08eab7768 100644
--- a/uv.lock
+++ b/uv.lock
@@ -355,7 +355,7 @@ wheels = [
 
 [[package]]
 name = "lineageweave"
-version = "0.74.0"
+version = "0.75.0"
 source = { virtual = "." }
 dependencies = [
     { name = "certifi" },

From ab7cda7be78ea2ea9f4cfaa6e2ab69b25875b865 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Sun, 16 Aug 2026 23:59:09 +0900
Subject: [PATCH 5/7] test(ui): reject invented primary affiliation captions

---
 ...test_related_node_affiliation_ambiguity.py | 64 +++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 backend/tests/test_related_node_affiliation_ambiguity.py

diff --git a/backend/tests/test_related_node_affiliation_ambiguity.py b/backend/tests/test_related_node_affiliation_ambiguity.py
new file mode 100644
index 000000000..60d23b15a
--- /dev/null
+++ b/backend/tests/test_related_node_affiliation_ambiguity.py
@@ -0,0 +1,64 @@
+"""Regression tests for related-node affiliation display authority."""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+from backend.app.knowledge_graph import hydrate_related_nodes
+from lineageweave.knowledge_graph import NODE_PERSON, node_key
+
+
+_PERSON_ID = "11111111-1111-4111-8111-111111111111"
+
+
+class _FakeConnection:
+    """Return the minimum query results needed by ``hydrate_related_nodes``."""
+
+    def __init__(self, affiliations: list[str]) -> None:
+        self._affiliations = affiliations
+
+    async def fetch(self, query: str, *args: Any) -> list[dict[str, Any]]:
+        if "from cataloged_person" in query:
+            return [
+                {
+                    "person_id": _PERSON_ID,
+                    "person_name": "Priya Nair",
+                    "person_side_code": "counterparty",
+                }
+            ]
+        if "from person_affiliation" in query:
+            return [
+                {
+                    "person_id": _PERSON_ID,
+                    "affiliated_organization_name": organization_name,
+                    "affiliated_corporate_entity_id": None,
+                }
+                for organization_name in self._affiliations
+            ]
+        if "from common_lookup_value" in query:
+            return [{"lookup_code": "counterparty", "lookup_label": "Counterparty"}]
+        raise AssertionError(f"unexpected query: {query}")
+
+
+def _hydrate(affiliations: list[str]) -> dict[str, Any]:
+    payload = asyncio.run(
+        hydrate_related_nodes(
+            _FakeConnection(affiliations),  # type: ignore[arg-type]
+            [(node_key(NODE_PERSON, _PERSON_ID), 0.8)],
+        )
+    )
+    assert len(payload) == 1
+    return payload[0]
+
+
+def test_related_person_exposes_one_unambiguous_affiliation() -> None:
+    """A single known affiliation is safe to use as compact display context."""
+    node = _hydrate(["Northridge Grid"])
+    assert node["affiliation_organization_name"] == "Northridge Grid"
+
+
+def test_related_person_omits_affiliation_when_multiple_are_known() -> None:
+    """Multiple affiliations must not be collapsed into an invented primary one."""
+    node = _hydrate(["Northridge Grid", "Northridge Holdings"])
+    assert "affiliation_organization_name" not in node

From c72317cc288b811969ae2d107fcfa9d8054245a8 Mon Sep 17 00:00:00 2001
From: Seongho Bae <me@seonghobae.me>
Date: Mon, 17 Aug 2026 00:00:53 +0900
Subject: [PATCH 6/7] fix(ui): omit ambiguous person affiliations

---
 backend/app/knowledge_graph.py | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/backend/app/knowledge_graph.py b/backend/app/knowledge_graph.py
index 1d37981c4..ce51b4c3c 100644
--- a/backend/app/knowledge_graph.py
+++ b/backend/app/knowledge_graph.py
@@ -283,8 +283,9 @@ async def hydrate_related_nodes(
 
     Unknown ids are dropped. Ontology fields are omitted (not faked)
     when ``node_type_code`` has no term in lineageweave-kg.ttl.
-    Person nodes carry the primary affiliation organization when one
-    exists; a missing affiliation is omitted, never invented.
+    Person nodes carry compact affiliation context only when exactly one
+    distinct non-empty affiliation is known; ambiguous affiliations are
+    omitted rather than collapsed into an invented primary organization.
     """
     person_ids: list[str] = []
     post_ids: list[str] = []
@@ -307,25 +308,28 @@ async def hydrate_related_nodes(
             person_ids,
         )
     } if person_ids else {}
-    affiliations: dict[str, str] = {}
+    affiliation_names_by_person: dict[str, set[str]] = {}
     if person_ids:
         affiliation_rows = await conn.fetch(
             """
-            select person_id, affiliated_organization_name, affiliated_corporate_entity_id
+            select person_id, affiliated_organization_name
             from person_affiliation
             where person_id = any($1::uuid[])
-            order by
-              (affiliated_corporate_entity_id is not null) desc,
-              affiliated_organization_name
+            order by person_id, affiliated_organization_name
             """,
             person_ids,
         )
         for row in affiliation_rows:
             person_id = str(row["person_id"])
             org = (row["affiliated_organization_name"] or "").strip()
-            if person_id in affiliations or not org:
+            if not org:
                 continue
-            affiliations[person_id] = org
+            affiliation_names_by_person.setdefault(person_id, set()).add(org)
+    affiliations = {
+        person_id: next(iter(organization_names))
+        for person_id, organization_names in affiliation_names_by_person.items()
+        if len(organization_names) == 1
+    }
     posts = {
         str(row["post_id"]): row
         for row in await conn.fetch(

From e41e5bfc4deb0b0e31546c7283b796d7a96d41ce Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Sun, 16 Aug 2026 15:13:36 +0000
Subject: [PATCH 7/7] fix(ui): resolve unique catalog affiliations, omit
 distinct multiples

Related-node chips now treat a resolved corporate_entity as one
identity and display its catalog name. Distinct unresolved orgs stay
omitted so the seeded Priya path is side-only, matching the 0.75.0
contract.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
---
 ARCHITECTURE.md                               | 10 ++-
 CHANGELOG.md                                  | 15 ++--
 backend/app/knowledge_graph.py                | 86 +++++++++++++-----
 backend/tests/test_api.py                     |  2 +-
 ...test_related_node_affiliation_ambiguity.py | 90 +++++++++++++++++--
 frontend/src/App.test.tsx                     |  7 +-
 frontend/src/App.tsx                          |  4 +-
 7 files changed, 171 insertions(+), 43 deletions(-)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index ccfd338ad..b52654517 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -321,10 +321,14 @@ is the same never-guess-a-parent rule
 Keyman sides are labeled from `common_lookup_value` (`Our side`,
 `Plant`, `Company`) so the popup never shows raw `our_side` / `plant`
 codes when a label exists. Related-node person chips use the same
-side label plus the primary affiliation when one exists
+side label plus compact affiliation context when exactly one
+distinct organization identity is known
 (`Ada West, Demo Corp (Our side)`), not the ontology class
-(`Ada West (Person)`). A missing affiliation is omitted, never
-guessed. Related-node organization chips use the
+(`Ada West (Person)`). Multiple distinct affiliations are omitted,
+never collapsed into a guessed primary (`Priya Nair (Counterparty)`
+after `make seed`). A resolved catalog org supplies `entity_name`;
+unresolved aliases of that same org collapse into it. Related-node
+organization chips use the
 entity-level label (`Demo Corp (Company)`), not `Organization`.
 Related-node post chips show the post title only, not `(Post)`.
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1fe719dc1..17dfe0ed7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,12 +8,15 @@ All notable changes to this project are documented here. Format follows
 
 ### Changed
 
-- Related-node person chips include the primary affiliation
-  organization when one exists. After `make seed`, walking from Ada
-  West shows "Priya Nair, Northridge Grid (Counterparty)" and walking
-  from Demo Corp shows "Ada West, Demo Corp (Our side)". A person with
-  no affiliation keeps the side-only caption -- the org is never
-  guessed. Resolved catalog orgs win over unresolved names.
+- Related-node person chips include the affiliation organization when
+  exactly one distinct identity is known. After `make seed`, walking
+  from Demo Corp shows "Ada West, Demo Corp (Our side)". Priya Nair
+  has two unresolved orgs (Northridge Grid and Northridge Holdings),
+  so the chip stays "Priya Nair (Counterparty)" -- a second org is
+  never collapsed into an invented primary. When the one identity is
+  a resolved `corporate_entity`, the catalog `entity_name` is shown
+  rather than the raw extraction string. A person with no affiliation
+  keeps the side-only caption.
 
 ## [0.74.0] - 2026-08-16
 
diff --git a/backend/app/knowledge_graph.py b/backend/app/knowledge_graph.py
index ce51b4c3c..7ed6897b1 100644
--- a/backend/app/knowledge_graph.py
+++ b/backend/app/knowledge_graph.py
@@ -8,6 +8,7 @@
 
 from __future__ import annotations
 
+from collections.abc import Mapping
 from typing import Any
 from uuid import UUID
 
@@ -275,6 +276,55 @@ async def load_visible_subgraph(
     return [edge_spec_from_row(row) for row in rows]
 
 
+def compact_affiliation_display_names(
+    rows: list[Mapping[str, Any]],
+) -> dict[str, str]:
+    """Return at most one display organization per person.
+
+    A resolved ``corporate_entity`` is one identity, labeled with
+    ``catalog_entity_name`` (falling back to the raw extraction
+    string). Unresolved names that casefold-match that catalog label
+    collapse into it -- the catalog name wins. Distinct unresolved
+    names stay distinct. A person with more than one remaining
+    identity is omitted so the chip never invents a primary org.
+    """
+    catalog_ids: dict[str, set[str]] = {}
+    catalog_labels: dict[str, dict[str, str]] = {}
+    unresolved_names: dict[str, set[str]] = {}
+    for row in rows:
+        person_id = str(row["person_id"])
+        raw_name = (row["affiliated_organization_name"] or "").strip()
+        catalog_id = row["affiliated_corporate_entity_id"]
+        catalog_name = (row["catalog_entity_name"] or "").strip()
+        if catalog_id is not None:
+            identity = str(catalog_id)
+            catalog_ids.setdefault(person_id, set()).add(identity)
+            label = catalog_name or raw_name
+            if label:
+                catalog_labels.setdefault(person_id, {})[identity] = label
+            continue
+        if raw_name:
+            unresolved_names.setdefault(person_id, set()).add(raw_name)
+
+    display_names: dict[str, str] = {}
+    for person_id in set(catalog_ids) | set(unresolved_names):
+        labels_by_id = catalog_labels.get(person_id, {})
+        catalog_name_fold = {name.casefold() for name in labels_by_id.values()}
+        leftover_names = {
+            name
+            for name in unresolved_names.get(person_id, set())
+            if name.casefold() not in catalog_name_fold
+        }
+        identity_count = len(catalog_ids.get(person_id, set())) + len(leftover_names)
+        if identity_count != 1:
+            continue
+        if leftover_names:
+            display_names[person_id] = next(iter(leftover_names))
+        elif labels_by_id:
+            display_names[person_id] = next(iter(labels_by_id.values()))
+    return display_names
+
+
 async def hydrate_related_nodes(
     conn: asyncpg.Connection,
     related: list[tuple[str, float]],
@@ -284,8 +334,10 @@ async def hydrate_related_nodes(
     Unknown ids are dropped. Ontology fields are omitted (not faked)
     when ``node_type_code`` has no term in lineageweave-kg.ttl.
     Person nodes carry compact affiliation context only when exactly one
-    distinct non-empty affiliation is known; ambiguous affiliations are
-    omitted rather than collapsed into an invented primary organization.
+    distinct organization identity is known. A resolved catalog org
+    supplies ``entity_name``; aliases of that same org collapse into it.
+    Multiple distinct affiliations are omitted rather than collapsed
+    into an invented primary organization.
     """
     person_ids: list[str] = []
     post_ids: list[str] = []
@@ -308,28 +360,22 @@ async def hydrate_related_nodes(
             person_ids,
         )
     } if person_ids else {}
-    affiliation_names_by_person: dict[str, set[str]] = {}
-    if person_ids:
-        affiliation_rows = await conn.fetch(
+    affiliations = compact_affiliation_display_names(
+        await conn.fetch(
             """
-            select person_id, affiliated_organization_name
-            from person_affiliation
-            where person_id = any($1::uuid[])
-            order by person_id, affiliated_organization_name
+            select
+                pa.person_id,
+                pa.affiliated_organization_name,
+                pa.affiliated_corporate_entity_id,
+                ce.entity_name as catalog_entity_name
+            from person_affiliation pa
+            left join corporate_entity ce
+                on ce.corporate_entity_id = pa.affiliated_corporate_entity_id
+            where pa.person_id = any($1::uuid[])
             """,
             person_ids,
         )
-        for row in affiliation_rows:
-            person_id = str(row["person_id"])
-            org = (row["affiliated_organization_name"] or "").strip()
-            if not org:
-                continue
-            affiliation_names_by_person.setdefault(person_id, set()).add(org)
-    affiliations = {
-        person_id: next(iter(organization_names))
-        for person_id, organization_names in affiliation_names_by_person.items()
-        if len(organization_names) == 1
-    }
+    ) if person_ids else {}
     posts = {
         str(row["post_id"]): row
         for row in await conn.fetch(
diff --git a/backend/tests/test_api.py b/backend/tests/test_api.py
index 6f2b42ca2..62c7356fe 100644
--- a/backend/tests/test_api.py
+++ b/backend/tests/test_api.py
@@ -885,7 +885,7 @@ def test_related_keymen_use_rwr_and_hide_invisible_posts(client, demo_analyst_to
     assert counterpart["ontology_iri"].endswith("#Person")
     assert counterpart["person_side_code"] == "counterparty"
     assert counterpart["person_side_label"] == "Counterparty"
-    assert counterpart["affiliation_organization_name"] == "Northridge Grid"
+    assert "affiliation_organization_name" not in counterpart
     for node in body["related"]:
         if node["node_type_code"] != "node_person":
             continue
diff --git a/backend/tests/test_related_node_affiliation_ambiguity.py b/backend/tests/test_related_node_affiliation_ambiguity.py
index 60d23b15a..8819c1251 100644
--- a/backend/tests/test_related_node_affiliation_ambiguity.py
+++ b/backend/tests/test_related_node_affiliation_ambiguity.py
@@ -10,12 +10,13 @@
 
 
 _PERSON_ID = "11111111-1111-4111-8111-111111111111"
+_CATALOG_ID = "22222222-2222-4222-8222-222222222222"
 
 
 class _FakeConnection:
     """Return the minimum query results needed by ``hydrate_related_nodes``."""
 
-    def __init__(self, affiliations: list[str]) -> None:
+    def __init__(self, affiliations: list[dict[str, Any]]) -> None:
         self._affiliations = affiliations
 
     async def fetch(self, query: str, *args: Any) -> list[dict[str, Any]]:
@@ -31,17 +32,18 @@ async def fetch(self, query: str, *args: Any) -> list[dict[str, Any]]:
             return [
                 {
                     "person_id": _PERSON_ID,
-                    "affiliated_organization_name": organization_name,
-                    "affiliated_corporate_entity_id": None,
+                    "affiliated_organization_name": row.get("affiliated_organization_name"),
+                    "affiliated_corporate_entity_id": row.get("affiliated_corporate_entity_id"),
+                    "catalog_entity_name": row.get("catalog_entity_name"),
                 }
-                for organization_name in self._affiliations
+                for row in self._affiliations
             ]
         if "from common_lookup_value" in query:
             return [{"lookup_code": "counterparty", "lookup_label": "Counterparty"}]
         raise AssertionError(f"unexpected query: {query}")
 
 
-def _hydrate(affiliations: list[str]) -> dict[str, Any]:
+def _hydrate(affiliations: list[dict[str, Any]]) -> dict[str, Any]:
     payload = asyncio.run(
         hydrate_related_nodes(
             _FakeConnection(affiliations),  # type: ignore[arg-type]
@@ -54,11 +56,85 @@ def _hydrate(affiliations: list[str]) -> dict[str, Any]:
 
 def test_related_person_exposes_one_unambiguous_affiliation() -> None:
     """A single known affiliation is safe to use as compact display context."""
-    node = _hydrate(["Northridge Grid"])
+    node = _hydrate([{"affiliated_organization_name": "Northridge Grid"}])
     assert node["affiliation_organization_name"] == "Northridge Grid"
 
 
 def test_related_person_omits_affiliation_when_multiple_are_known() -> None:
     """Multiple affiliations must not be collapsed into an invented primary one."""
-    node = _hydrate(["Northridge Grid", "Northridge Holdings"])
+    node = _hydrate(
+        [
+            {"affiliated_organization_name": "Northridge Grid"},
+            {"affiliated_organization_name": "Northridge Holdings"},
+        ]
+    )
+    assert "affiliation_organization_name" not in node
+
+
+def test_related_person_omits_blank_affiliation() -> None:
+    """Whitespace-only extraction strings are missing evidence, not a name."""
+    node = _hydrate([{"affiliated_organization_name": "   "}])
+    assert "affiliation_organization_name" not in node
+
+
+def test_related_person_uses_catalog_name_for_one_resolved_org() -> None:
+    """A resolved catalog org supplies entity_name, not the raw extraction."""
+    node = _hydrate(
+        [
+            {
+                "affiliated_organization_name": "Demo Corp Inc.",
+                "affiliated_corporate_entity_id": _CATALOG_ID,
+                "catalog_entity_name": "Demo Corp",
+            }
+        ]
+    )
+    assert node["affiliation_organization_name"] == "Demo Corp"
+
+
+def test_related_person_collapses_aliases_of_one_catalog_org() -> None:
+    """Two raw strings for the same corporate_entity_id are one identity."""
+    node = _hydrate(
+        [
+            {
+                "affiliated_organization_name": "Demo Corp Inc.",
+                "affiliated_corporate_entity_id": _CATALOG_ID,
+                "catalog_entity_name": "Demo Corp",
+            },
+            {
+                "affiliated_organization_name": "Demo Corp",
+                "affiliated_corporate_entity_id": _CATALOG_ID,
+                "catalog_entity_name": "Demo Corp",
+            },
+        ]
+    )
+    assert node["affiliation_organization_name"] == "Demo Corp"
+
+
+def test_related_person_collapses_unresolved_name_matching_catalog() -> None:
+    """An unresolved alias of the catalog label is not a second org."""
+    node = _hydrate(
+        [
+            {
+                "affiliated_organization_name": "Demo Corp",
+                "affiliated_corporate_entity_id": _CATALOG_ID,
+                "catalog_entity_name": "Demo Corp",
+            },
+            {"affiliated_organization_name": "demo corp"},
+        ]
+    )
+    assert node["affiliation_organization_name"] == "Demo Corp"
+
+
+def test_related_person_omits_resolved_plus_distinct_unresolved() -> None:
+    """A catalog org plus a different unresolved name stays ambiguous."""
+    node = _hydrate(
+        [
+            {
+                "affiliated_organization_name": "Demo Corp",
+                "affiliated_corporate_entity_id": _CATALOG_ID,
+                "catalog_entity_name": "Demo Corp",
+            },
+            {"affiliated_organization_name": "Northridge Holdings"},
+        ]
+    )
     assert "affiliation_organization_name" not in node
diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx
index 0ec540338..049cbf99e 100644
--- a/frontend/src/App.test.tsx
+++ b/frontend/src/App.test.tsx
@@ -538,7 +538,6 @@ describe("App, authenticated", () => {
                 label: "Priya Nair",
                 person_side_code: "counterparty",
                 person_side_label: "Counterparty",
-                affiliation_organization_name: "Northridge Grid",
                 relevance: 0.4,
               },
               {
@@ -981,13 +980,13 @@ describe("App, authenticated", () => {
     await userEvent.click(screen.getByRole("button", { name: "Related nodes for Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Priya Nair, Northridge Grid (Counterparty)" }),
+      screen.getByRole("button", { name: "Related nodes for Priya Nair (Counterparty)" }),
     ).toBeInTheDocument();
     expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
       "Priya Nair (Person)",
     );
     expect(screen.getByText("Related to Ada West").closest(".related-keymen")).not.toHaveTextContent(
-      "Priya Nair (Counterparty)",
+      "Priya Nair, Northridge Grid (Counterparty)",
     );
     const relatedPanel = screen.getByText("Related to Ada West").closest(".related-keymen");
     expect(relatedPanel).toHaveTextContent("Linked post");
@@ -1005,7 +1004,7 @@ describe("App, authenticated", () => {
     await userEvent.click(await screen.findByRole("button", { name: "R&R Keyman: Ada West" }));
     await waitFor(() => expect(screen.getByText("Related to Ada West")).toBeInTheDocument());
     expect(
-      screen.getByRole("button", { name: "Related nodes for Priya Nair, Northridge Grid (Counterparty)" }),
+      screen.getByRole("button", { name: "Related nodes for Priya Nair (Counterparty)" }),
     ).toBeInTheDocument();
   });
 
diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx
index af3d9e348..b973228c6 100644
--- a/frontend/src/App.tsx
+++ b/frontend/src/App.tsx
@@ -472,7 +472,7 @@ const NODE_CORPORATE_ENTITY = "node_corporate_entity";
 function relatedNodeCaption(node: RelatedNode): string {
   const name = node.label ?? node.node_id;
   if (node.node_type_code === NODE_PERSON) {
-    const side = node.person_side_label ?? node.person_side_code;
+    const side = node.person_side_label?.trim() || node.person_side_code?.trim();
     const org = node.affiliation_organization_name?.trim();
     if (side && org) {
       return `${name}, ${org} (${side})`;
@@ -482,7 +482,7 @@ function relatedNodeCaption(node: RelatedNode): string {
     }
   }
   if (node.node_type_code === NODE_CORPORATE_ENTITY) {
-    const level = node.entity_level_label ?? node.entity_level_code;
+    const level = node.entity_level_label?.trim() || node.entity_level_code?.trim();
     if (level) {
       return `${name} (${level})`;
     }