H-6617: Create custom graph rendering pipeline inside frontend

[indietyp]

🌟 What is the purpose of this PR?

🔗 Related links

• ...

🚫 Blocked by

• ...

🔍 What does this change?

• ...

Pre-Merge Checklist 🚀

🚢 Has this modified a publishable library?

This PR:

• does not modify any publishable blocks or libraries, or modifications do not need publishing
• modifies an npm-publishable library and I have added a changeset file(s)
• modifies a Cargo-publishable library and I have amended the version
• modifies a Cargo-publishable library, but it is not yet ready to publish
• modifies a block that will need publishing via GitHub action once merged
• I am unsure / need advice

📜 Does this require a change to the docs?

The changes in this PR:

• are internal and do not require a docs change
• are in a state where docs changes are not yet required but will be
  • this is tracked in: Insert Link Here
• require changes to docs which are made as part of this PR
• require changes to docs which are not made in this PR
  • Provide more detail here
• I am unsure / need advice

🕸️ Does this require a change to the Turbo Graph?

The changes in this PR:

• do not affect the execution graph
• affected the execution graph, and the turbo.json's have been updated to reflect this
• I am unsure / need advice

⚠️ Known issues

🐾 Next steps

🛡 What tests cover this?

❓ How to test this?

1. Checkout the branch / view the deployment
2. Try X
3. Confirm that Y

📹 Demo

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview, Comment	Jul 3, 2026 4:46pm
petrinaut	Ready	Preview	Jul 3, 2026 4:46pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hashdotdesign-tokens	Ignored	Preview	Jul 3, 2026 4:46pm

[indietyp]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• H-6617: Create custom graph rendering pipeline inside frontend #8952 👈 (View in Graphite)
• BE-629: Add spherical k-means entity clustering endpoint via /entities/embeddings/clusters #8919
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[codspeed-hq]

Merging this PR will not alter performance

✅ 80 untouched benchmarks

---

_{Comparing bm/h-6617-experiment-with-graph-rendering-inside-of-hash-graph (f4af41d) with bm/be-629-implement-kmeans-clustering-in-the-hash-graph (7c7fadb)}

[semgrep-code-hashintel]

Detected possible formatted SQL query. Use parameterized queries instead.

🧼 Fixed in commit 2fbcafb 🧼

[codecov]

Codecov Report

❌ Patch coverage is 0% with 7 lines in your changes missing coverage. Please review.
✅ Project coverage is 28.74%. Comparing base (7c7fadb) to head (f4af41d).

Files with missing lines	Patch %	Lines
.../src/graph/knowledge/primitive/cluster-entities.ts	0.00%	7 Missing ⚠️

Additional details and impacted files

@@                                     Coverage Diff                                      @@
##           bm/be-629-implement-kmeans-clustering-in-the-hash-graph    #8952       +/-   ##
============================================================================================
- Coverage                                                    59.93%   28.74%   -31.19%     
============================================================================================
  Files                                                         1370      670      -700     
  Lines                                                       134209    52641    -81568     
  Branches                                                      6095     3480     -2615     
============================================================================================
- Hits                                                         80443    15134    -65309     
+ Misses                                                       52820    37317    -15503     
+ Partials                                                       946      190      -756     

Flag	Coverage Δ
apps.hash-ai-worker-py	?
apps.hash-api	6.38% <0.00%> (-0.01%)	⬇️
backend-integration-tests	?
blockprotocol.type-system	?
deer	?
error-stack	?
local.claude-hooks	?
local.harpc-client	?
local.hash-subgraph	?
rust.antsi	?
rust.deer	?
rust.error-stack	?
rust.harpc-codec	?
rust.harpc-net	?
rust.harpc-tower	?
rust.harpc-types	?
rust.harpc-wire-protocol	?
rust.hash-codec	?
rust.hash-graph-authorization	?
rust.hash-graph-temporal-versioning	?
rust.hash-graph-types	?
rust.hashql-ast	?
rust.hashql-core	?
rust.hashql-diagnostics	?
rust.hashql-hir	?
rust.hashql-mir	?
rust.hashql-syntax-jexpr	?
rust.sarif	?
sarif	?
tests.hash-backend-integration	?
unit-tests	?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

Benchmark results

@rust/hash-graph-benches – Integrations

policy_resolution_large

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2002	$$27.5 \mathrm{ms} \pm 216 \mathrm{μs}\left({\color{gray}-1.446 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$3.52 \mathrm{ms} \pm 24.2 \mathrm{μs}\left({\color{gray}2.18 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 1002	$$12.5 \mathrm{ms} \pm 101 \mathrm{μs}\left({\color{gray}-2.887 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 3314	$$43.7 \mathrm{ms} \pm 381 \mathrm{μs}\left({\color{gray}1.66 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$15.2 \mathrm{ms} \pm 128 \mathrm{μs}\left({\color{gray}4.74 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 1527	$$24.4 \mathrm{ms} \pm 247 \mathrm{μs}\left({\color{gray}1.03 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 2078	$$28.6 \mathrm{ms} \pm 198 \mathrm{μs}\left({\color{gray}0.332 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.85 \mathrm{ms} \pm 21.5 \mathrm{μs}\left({\color{gray}1.56 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 1033	$$14.2 \mathrm{ms} \pm 123 \mathrm{μs}\left({\color{gray}3.28 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_medium

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 102	$$3.81 \mathrm{ms} \pm 25.6 \mathrm{μs}\left({\color{gray}-0.367 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.98 \mathrm{ms} \pm 15.4 \mathrm{μs}\left({\color{gray}-1.161 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 52	$$3.34 \mathrm{ms} \pm 19.9 \mathrm{μs}\left({\color{gray}-2.102 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 269	$$5.21 \mathrm{ms} \pm 34.1 \mathrm{μs}\left({\color{gray}0.998 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.59 \mathrm{ms} \pm 27.1 \mathrm{μs}\left({\color{gray}1.02 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 108	$$4.16 \mathrm{ms} \pm 26.9 \mathrm{μs}\left({\color{gray}-0.931 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 133	$$4.36 \mathrm{ms} \pm 26.4 \mathrm{μs}\left({\color{gray}-0.506 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.43 \mathrm{ms} \pm 25.4 \mathrm{μs}\left({\color{gray}-1.376 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 63	$$4.04 \mathrm{ms} \pm 30.7 \mathrm{μs}\left({\color{gray}-0.685 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_none

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2	$$2.61 \mathrm{ms} \pm 18.5 \mathrm{μs}\left({\color{gray}1.29 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.48 \mathrm{ms} \pm 13.0 \mathrm{μs}\left({\color{gray}-2.060 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 2	$$2.57 \mathrm{ms} \pm 17.2 \mathrm{μs}\left({\color{gray}-0.073 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 8	$$2.83 \mathrm{ms} \pm 18.3 \mathrm{μs}\left({\color{gray}-1.028 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.66 \mathrm{ms} \pm 16.7 \mathrm{μs}\left({\color{gray}1.54 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 3	$$2.83 \mathrm{ms} \pm 14.4 \mathrm{μs}\left({\color{gray}-0.053 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_small

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 52	$$3.05 \mathrm{ms} \pm 22.5 \mathrm{μs}\left({\color{gray}0.217 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.73 \mathrm{ms} \pm 14.7 \mathrm{μs}\left({\color{gray}-1.015 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 26	$$3.00 \mathrm{ms} \pm 19.0 \mathrm{μs}\left({\color{gray}2.60 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 94	$$3.43 \mathrm{ms} \pm 20.9 \mathrm{μs}\left({\color{gray}1.05 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.02 \mathrm{ms} \pm 22.4 \mathrm{μs}\left({\color{gray}1.60 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 27	$$3.30 \mathrm{ms} \pm 19.7 \mathrm{μs}\left({\color{gray}2.47 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 66	$$3.40 \mathrm{ms} \pm 22.0 \mathrm{μs}\left({\color{gray}0.615 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.97 \mathrm{ms} \pm 20.5 \mathrm{μs}\left({\color{gray}-0.085 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 29	$$3.36 \mathrm{ms} \pm 22.8 \mathrm{μs}\left({\color{gray}2.28 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_complete

Function	Value	Mean	Flame graphs
entity_by_id;one_depth	1 entities	$$41.9 \mathrm{ms} \pm 254 \mathrm{μs}\left({\color{gray}-0.299 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	10 entities	$$33.4 \mathrm{ms} \pm 183 \mathrm{μs}\left({\color{gray}2.74 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	25 entities	$$35.2 \mathrm{ms} \pm 263 \mathrm{μs}\left({\color{gray}-0.555 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	5 entities	$$31.5 \mathrm{ms} \pm 197 \mathrm{μs}\left({\color{gray}-1.949 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	50 entities	$$40.9 \mathrm{ms} \pm 269 \mathrm{μs}\left({\color{gray}-2.948 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	1 entities	$$48.7 \mathrm{ms} \pm 274 \mathrm{μs}\left({\color{gray}-1.196 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	10 entities	$$39.3 \mathrm{ms} \pm 295 \mathrm{μs}\left({\color{gray}-2.466 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	25 entities	$$91.6 \mathrm{ms} \pm 570 \mathrm{μs}\left({\color{gray}-1.631 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	5 entities	$$33.1 \mathrm{ms} \pm 224 \mathrm{μs}\left({\color{gray}-1.396 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	50 entities	$$275 \mathrm{ms} \pm 1.01 \mathrm{ms}\left({\color{red}6.31 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	1 entities	$$10.6 \mathrm{ms} \pm 63.6 \mathrm{μs}\left({\color{gray}1.34 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	10 entities	$$10.8 \mathrm{ms} \pm 80.7 \mathrm{μs}\left({\color{gray}0.014 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	25 entities	$$10.9 \mathrm{ms} \pm 66.6 \mathrm{μs}\left({\color{gray}2.87 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	5 entities	$$10.5 \mathrm{ms} \pm 54.5 \mathrm{μs}\left({\color{gray}0.415 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	50 entities	$$10.6 \mathrm{ms} \pm 62.2 \mathrm{μs}\left({\color{gray}0.475 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_linkless

Function	Value	Mean	Flame graphs
entity_by_id	1 entities	$$10.5 \mathrm{ms} \pm 83.0 \mathrm{μs}\left({\color{gray}1.02 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10 entities	$$10.4 \mathrm{ms} \pm 81.6 \mathrm{μs}\left({\color{gray}0.910 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	100 entities	$$10.4 \mathrm{ms} \pm 67.3 \mathrm{μs}\left({\color{gray}0.224 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	1000 entities	$$10.6 \mathrm{ms} \pm 66.1 \mathrm{μs}\left({\color{gray}0.502 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10000 entities	$$11.0 \mathrm{ms} \pm 78.7 \mathrm{μs}\left({\color{gray}4.23 \mathrm{\%}}\right) $$	Flame Graph

representative_read_entity

Function	Value	Mean	Flame graphs
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/block/v/1	$$11.4 \mathrm{ms} \pm 82.4 \mathrm{μs}\left({\color{red}5.97 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/book/v/1	$$11.1 \mathrm{ms} \pm 66.0 \mathrm{μs}\left({\color{gray}3.95 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/building/v/1	$$11.2 \mathrm{ms} \pm 97.7 \mathrm{μs}\left({\color{gray}4.11 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/organization/v/1	$$11.1 \mathrm{ms} \pm 62.6 \mathrm{μs}\left({\color{gray}2.16 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/page/v/2	$$11.1 \mathrm{ms} \pm 81.3 \mathrm{μs}\left({\color{gray}4.41 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/person/v/1	$$11.3 \mathrm{ms} \pm 80.6 \mathrm{μs}\left({\color{gray}4.29 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/playlist/v/1	$$11.2 \mathrm{ms} \pm 82.6 \mathrm{μs}\left({\color{gray}3.85 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/song/v/1	$$11.0 \mathrm{ms} \pm 79.8 \mathrm{μs}\left({\color{gray}1.46 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/uk-address/v/1	$$11.2 \mathrm{ms} \pm 74.4 \mathrm{μs}\left({\color{gray}3.07 \mathrm{\%}}\right) $$	Flame Graph

representative_read_entity_type

Function	Value	Mean	Flame graphs
get_entity_type_by_id	Account ID: bf5a9ef5-dc3b-43cf-a291-6210c0321eba	$$8.70 \mathrm{ms} \pm 61.2 \mathrm{μs}\left({\color{gray}2.33 \mathrm{\%}}\right) $$	Flame Graph

representative_read_multiple_entities

Function	Value	Mean	Flame graphs
entity_by_property	traversal_paths=0	0	$$59.5 \mathrm{ms} \pm 447 \mathrm{μs}\left({\color{gray}-3.099 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$112 \mathrm{ms} \pm 679 \mathrm{μs}\left({\color{gray}-0.562 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$64.5 \mathrm{ms} \pm 334 \mathrm{μs}\left({\color{gray}-0.315 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$75.1 \mathrm{ms} \pm 586 \mathrm{μs}\left({\color{gray}1.17 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:2;links:1;link_dests:0;type:true	$$82.8 \mathrm{ms} \pm 540 \mathrm{μs}\left({\color{gray}0.291 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$89.0 \mathrm{ms} \pm 498 \mathrm{μs}\left({\color{gray}-0.823 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=0	0	$$45.7 \mathrm{ms} \pm 259 \mathrm{μs}\left({\color{gray}2.54 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$75.0 \mathrm{ms} \pm 455 \mathrm{μs}\left({\color{gray}1.06 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$51.8 \mathrm{ms} \pm 368 \mathrm{μs}\left({\color{gray}1.47 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$60.7 \mathrm{ms} \pm 488 \mathrm{μs}\left({\color{gray}-0.537 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:2;links:1;link_dests:0;type:true	$$64.4 \mathrm{ms} \pm 501 \mathrm{μs}\left({\color{gray}2.84 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$63.6 \mathrm{ms} \pm 342 \mathrm{μs}\left({\color{gray}1.73 \mathrm{\%}}\right) $$

scenarios

Function	Value	Mean	Flame graphs
full_test	query-limited	$$117 \mathrm{ms} \pm 698 \mathrm{μs}\left({\color{gray}-4.218 \mathrm{\%}}\right) $$	Flame Graph
full_test	query-unlimited	$$129 \mathrm{ms} \pm 682 \mathrm{μs}\left({\color{gray}-2.130 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-limited	$$18.9 \mathrm{ms} \pm 119 \mathrm{μs}\left({\color{lightgreen}-18.967 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-unlimited	$$526 \mathrm{ms} \pm 1.15 \mathrm{ms}\left({\color{gray}0.225 \mathrm{\%}}\right) $$	Flame Graph