BE-537, BE-537: hgraph: REST /hashql endpoint with E2E tests

[indietyp]

🌟 What is the purpose of this PR?

Add first-class /hashql POST endpoint. HashQlResource with OpenApi integration. CompilerContext with HeapPool/ScratchPool for memory management. CLI-configurable pool sizes via CompilerConfig with PoolSize newtype. PostgresStorePool extraction pattern. Interactive and Json-Compat header support. E2E tests via httpYac.

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

📜 Does this require a change to the docs?

The changes in this PR:

• are internal and do not require a docs change

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

The changes in this PR:

• do not affect the execution graph

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
hash	Ready	Preview, Comment	Jul 6, 2026 9:53am

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
hashdotdesign-tokens	Ignored	Preview	Jul 6, 2026 9:53am
petrinaut	Skipped	Comment	Jul 6, 2026 9:53am

[cursor]

PR Summary

Medium Risk
New user-facing query execution path hits Postgres with configurable concurrency and memory pools; misconfiguration or compiler bugs could affect DB load and availability, though inputs are restricted and errors are structured.

Overview
Adds a POST /hashql route on the graph REST API so clients can submit HashQL as JSON, run it through the full compiler pipeline (JExpr parse → AST/HIR/MIR → Postgres codegen), execute via the existing orchestrator, and get structured results or diagnostics.

API layer: New hashql REST module with shared CompilerContext (bounded/unbounded heap and scratch pools plus a pinned thread pool for !Send compilation). Request body is query + inputs (inputs must be empty until BE-41). Optional Interactive renders compile errors as HTML; Json-Compat strips HashQL value wrappers to plain JSON. Errors map compiler stages into a unified diagnostic category with source spans.

Server wiring: CompilerConfig / PoolSize CLI env vars (HASH_GRAPH_COMPILER_MEMORY_POOL_SIZE, HASH_GRAPH_COMPILER_EXEC_POOL_SIZE) configure pools at startup. The router now also injects a dedicated PostgresStorePool clone (alongside the fetching store pool) for query execution. Temporal client creation ignores empty host strings.

Supporting changes: hash-graph-api depends on the HashQL crates; OpenAPI documents the endpoint; PostgresStore exposes AsRef<Client> for eval; httpYac E2E tests cover success, 400 diagnostics, json-compat, and interactive HTML errors.

^{Reviewed by Cursor Bugbot for commit 2a72e57. Bugbot is set up for automated code reviews on this repo. Configure here.}

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 1 comment.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit 90037e8. Configure here.}

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 14 out of 16 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 43 out of 45 changed files in this pull request and generated 1 comment.

[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 269 \mathrm{μs}\left({\color{gray}-0.422 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$3.41 \mathrm{ms} \pm 20.8 \mathrm{μs}\left({\color{gray}-3.970 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 1002	$$12.3 \mathrm{ms} \pm 92.2 \mathrm{μs}\left({\color{gray}-1.085 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 3314	$$43.8 \mathrm{ms} \pm 426 \mathrm{μs}\left({\color{gray}-0.743 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$14.2 \mathrm{ms} \pm 118 \mathrm{μs}\left({\color{gray}-3.109 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 1527	$$24.0 \mathrm{ms} \pm 183 \mathrm{μs}\left({\color{gray}-2.386 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 2078	$$28.3 \mathrm{ms} \pm 225 \mathrm{μs}\left({\color{gray}-0.516 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.78 \mathrm{ms} \pm 27.6 \mathrm{μs}\left({\color{gray}-1.782 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 1033	$$13.6 \mathrm{ms} \pm 134 \mathrm{μs}\left({\color{gray}1.34 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_medium

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 102	$$3.83 \mathrm{ms} \pm 24.0 \mathrm{μs}\left({\color{gray}-1.461 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$3.01 \mathrm{ms} \pm 17.0 \mathrm{μs}\left({\color{gray}-1.034 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 52	$$3.41 \mathrm{ms} \pm 23.1 \mathrm{μs}\left({\color{gray}-2.326 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 269	$$5.22 \mathrm{ms} \pm 38.5 \mathrm{μs}\left({\color{gray}-4.744 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.55 \mathrm{ms} \pm 23.9 \mathrm{μs}\left({\color{gray}-1.543 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 108	$$4.14 \mathrm{ms} \pm 26.5 \mathrm{μs}\left({\color{gray}-4.651 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 133	$$4.47 \mathrm{ms} \pm 32.3 \mathrm{μs}\left({\color{gray}0.198 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.51 \mathrm{ms} \pm 23.2 \mathrm{μs}\left({\color{gray}-0.087 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 63	$$4.13 \mathrm{ms} \pm 27.4 \mathrm{μs}\left({\color{gray}-1.089 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_none

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2	$$2.70 \mathrm{ms} \pm 18.6 \mathrm{μs}\left({\color{gray}-0.263 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.54 \mathrm{ms} \pm 15.1 \mathrm{μs}\left({\color{gray}0.177 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 2	$$2.69 \mathrm{ms} \pm 14.6 \mathrm{μs}\left({\color{gray}1.52 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 8	$$2.99 \mathrm{ms} \pm 20.2 \mathrm{μs}\left({\color{gray}3.19 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.76 \mathrm{ms} \pm 17.0 \mathrm{μs}\left({\color{gray}2.05 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 3	$$2.99 \mathrm{ms} \pm 18.3 \mathrm{μs}\left({\color{gray}3.54 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_small

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 52	$$3.09 \mathrm{ms} \pm 18.0 \mathrm{μs}\left({\color{gray}-0.682 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.80 \mathrm{ms} \pm 18.1 \mathrm{μs}\left({\color{gray}0.591 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 26	$$3.03 \mathrm{ms} \pm 20.2 \mathrm{μs}\left({\color{gray}0.135 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 94	$$3.46 \mathrm{ms} \pm 19.8 \mathrm{μs}\left({\color{gray}-2.898 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.02 \mathrm{ms} \pm 17.3 \mathrm{μs}\left({\color{gray}0.825 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 27	$$3.35 \mathrm{ms} \pm 24.9 \mathrm{μs}\left({\color{gray}0.381 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 66	$$3.42 \mathrm{ms} \pm 24.5 \mathrm{μs}\left({\color{gray}0.317 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.98 \mathrm{ms} \pm 17.8 \mathrm{μs}\left({\color{gray}-0.156 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 29	$$3.36 \mathrm{ms} \pm 21.4 \mathrm{μs}\left({\color{gray}-0.710 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_complete

Function	Value	Mean	Flame graphs
entity_by_id;one_depth	1 entities	$$42.2 \mathrm{ms} \pm 220 \mathrm{μs}\left({\color{gray}0.352 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	10 entities	$$32.6 \mathrm{ms} \pm 219 \mathrm{μs}\left({\color{gray}-0.009 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	25 entities	$$35.5 \mathrm{ms} \pm 211 \mathrm{μs}\left({\color{gray}-3.234 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	5 entities	$$42.6 \mathrm{ms} \pm 1.38 \mathrm{ms}\left({\color{red}33.7 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	50 entities	$$41.8 \mathrm{ms} \pm 253 \mathrm{μs}\left({\color{gray}-1.963 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	1 entities	$$49.4 \mathrm{ms} \pm 305 \mathrm{μs}\left({\color{gray}-0.295 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	10 entities	$$40.6 \mathrm{ms} \pm 204 \mathrm{μs}\left({\color{gray}-0.943 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	25 entities	$$91.1 \mathrm{ms} \pm 610 \mathrm{μs}\left({\color{gray}-1.486 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	5 entities	$$42.7 \mathrm{ms} \pm 3.64 \mathrm{ms}\left({\color{red}22.5 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	50 entities	$$260 \mathrm{ms} \pm 964 \mathrm{μs}\left({\color{lightgreen}-6.455 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	1 entities	$$10.6 \mathrm{ms} \pm 61.6 \mathrm{μs}\left({\color{gray}-1.960 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	10 entities	$$10.8 \mathrm{ms} \pm 72.0 \mathrm{μs}\left({\color{gray}-0.157 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	25 entities	$$11.1 \mathrm{ms} \pm 63.1 \mathrm{μs}\left({\color{gray}2.36 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	5 entities	$$10.5 \mathrm{ms} \pm 58.8 \mathrm{μs}\left({\color{gray}-1.117 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	50 entities	$$10.6 \mathrm{ms} \pm 56.0 \mathrm{μs}\left({\color{gray}-0.578 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_linkless

Function	Value	Mean	Flame graphs
entity_by_id	1 entities	$$10.6 \mathrm{ms} \pm 69.3 \mathrm{μs}\left({\color{gray}0.162 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10 entities	$$10.5 \mathrm{ms} \pm 48.7 \mathrm{μs}\left({\color{gray}-2.230 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	100 entities	$$10.7 \mathrm{ms} \pm 57.4 \mathrm{μs}\left({\color{gray}-1.877 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	1000 entities	$$10.7 \mathrm{ms} \pm 65.8 \mathrm{μs}\left({\color{gray}-0.671 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10000 entities	$$10.8 \mathrm{ms} \pm 79.9 \mathrm{μs}\left({\color{gray}-1.393 \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.6 \mathrm{ms} \pm 113 \mathrm{μs}\left({\color{gray}2.31 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/book/v/1	$$11.3 \mathrm{ms} \pm 95.9 \mathrm{μs}\left({\color{gray}-1.123 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/building/v/1	$$10.8 \mathrm{ms} \pm 66.8 \mathrm{μs}\left({\color{gray}-1.245 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/organization/v/1	$$10.9 \mathrm{ms} \pm 75.6 \mathrm{μs}\left({\color{gray}-2.071 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/page/v/2	$$10.9 \mathrm{ms} \pm 59.7 \mathrm{μs}\left({\color{gray}-3.912 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/person/v/1	$$11.0 \mathrm{ms} \pm 60.4 \mathrm{μs}\left({\color{gray}-2.767 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/playlist/v/1	$$11.0 \mathrm{ms} \pm 67.9 \mathrm{μs}\left({\color{gray}-3.102 \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.9 \mathrm{μs}\left({\color{gray}-2.019 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/uk-address/v/1	$$10.9 \mathrm{ms} \pm 65.7 \mathrm{μs}\left({\color{gray}-2.099 \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.88 \mathrm{ms} \pm 53.9 \mathrm{μs}\left({\color{gray}2.32 \mathrm{\%}}\right) $$	Flame Graph

representative_read_multiple_entities

Function	Value	Mean	Flame graphs
entity_by_property	traversal_paths=0	0	$$59.9 \mathrm{ms} \pm 724 \mathrm{μs}\left({\color{gray}-2.883 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$109 \mathrm{ms} \pm 903 \mathrm{μs}\left({\color{gray}-4.323 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$65.4 \mathrm{ms} \pm 696 \mathrm{μs}\left({\color{gray}-3.080 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$70.4 \mathrm{ms} \pm 459 \mathrm{μs}\left({\color{lightgreen}-6.654 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:2;links:1;link_dests:0;type:true	$$79.1 \mathrm{ms} \pm 464 \mathrm{μs}\left({\color{lightgreen}-7.022 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$86.2 \mathrm{ms} \pm 533 \mathrm{μs}\left({\color{lightgreen}-7.246 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=0	0	$$43.9 \mathrm{ms} \pm 358 \mathrm{μs}\left({\color{gray}-2.770 \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	$$76.6 \mathrm{ms} \pm 526 \mathrm{μs}\left({\color{gray}-1.256 \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	$$50.3 \mathrm{ms} \pm 391 \mathrm{μs}\left({\color{gray}-3.450 \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.1 \mathrm{ms} \pm 474 \mathrm{μs}\left({\color{gray}-0.956 \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	$$65.2 \mathrm{ms} \pm 461 \mathrm{μs}\left({\color{gray}3.29 \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	$$62.7 \mathrm{ms} \pm 392 \mathrm{μs}\left({\color{gray}-2.181 \mathrm{\%}}\right) $$

scenarios

Function	Value	Mean	Flame graphs
full_test	query-limited	$$118 \mathrm{ms} \pm 638 \mathrm{μs}\left({\color{lightgreen}-8.786 \mathrm{\%}}\right) $$	Flame Graph
full_test	query-unlimited	$$132 \mathrm{ms} \pm 769 \mathrm{μs}\left({\color{gray}-4.769 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-limited	$$18.4 \mathrm{ms} \pm 134 \mathrm{μs}\left({\color{gray}0.361 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-unlimited	$$526 \mathrm{ms} \pm 1.48 \mathrm{ms}\left({\color{gray}-0.473 \mathrm{\%}}\right) $$	Flame Graph