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	Jun 12, 2026 12:42pm
petrinaut	Ready	Preview, Comment	Jun 12, 2026 12:42pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hashdotdesign-tokens	Ignored	Preview	Jun 12, 2026 12:42pm

[cursor]

PR Summary

Medium Risk
New arbitrary query execution path against Postgres with configurable (including unbounded) compiler memory/thread pools; compilation and SQL generation bugs could affect availability or load even though inputs are not yet exposed.

Overview
Adds a POST /hashql REST API that accepts a JExpr-encoded query (plus a required but currently empty inputs array), runs the full HashQL pipeline (parse → HIR/MIR → Postgres codegen), executes via the eval orchestrator against a pooled Postgres client, and returns a structured success envelope or compiler diagnostics.

Server wiring: startup builds a shared CompilerContext (bounded/unbounded heap & scratch pools, LocalPoolHandle + spawn_pinned for !Send compilation/execution) from new CLI CompilerConfig / PoolSize env vars. The REST router now also injects a raw PostgresStorePool (alongside the existing fetching store pool) and the compiler context as Axum extensions.

Response options: optional Interactive (HTML-rendered errors) and Json-Compat (plain JSON values) headers; OpenAPI documents the new HashQL tag and HashQlRequest schema. Minor fixes: empty Temporal host strings are ignored; PostgresStore exposes AsRef<Client> for eval; lowering uses sym::main.

Tests: httpYac tests/hashql.http covers happy path, parse errors, validation, json-compat, and interactive HTML errors.

^{Reviewed by Cursor Bugbot for commit c541263. 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 3 comments.

[cursor]

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

There are 2 total unresolved issues (including 1 from previous review).

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

^{Reviewed by Cursor Bugbot for commit 93fb60f. 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 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	$$26.6 \mathrm{ms} \pm 258 \mathrm{μs}\left({\color{gray}1.49 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$3.38 \mathrm{ms} \pm 15.4 \mathrm{μs}\left({\color{lightgreen}-6.315 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 1001	$$12.9 \mathrm{ms} \pm 90.3 \mathrm{μs}\left({\color{gray}1.82 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 3314	$$43.4 \mathrm{ms} \pm 370 \mathrm{μs}\left({\color{gray}-0.065 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$14.7 \mathrm{ms} \pm 99.8 \mathrm{μs}\left({\color{lightgreen}-6.061 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 1526	$$24.5 \mathrm{ms} \pm 159 \mathrm{μs}\left({\color{gray}-1.791 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 2078	$$26.8 \mathrm{ms} \pm 164 \mathrm{μs}\left({\color{gray}-1.081 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.75 \mathrm{ms} \pm 20.0 \mathrm{μs}\left({\color{gray}-4.900 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 1033	$$14.2 \mathrm{ms} \pm 145 \mathrm{μs}\left({\color{gray}2.00 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_medium

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 102	$$3.70 \mathrm{ms} \pm 23.4 \mathrm{μs}\left({\color{gray}-0.244 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.97 \mathrm{ms} \pm 15.2 \mathrm{μs}\left({\color{gray}-0.787 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 51	$$3.31 \mathrm{ms} \pm 18.5 \mathrm{μs}\left({\color{gray}-1.627 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 269	$$5.12 \mathrm{ms} \pm 35.0 \mathrm{μs}\left({\color{gray}-0.449 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.55 \mathrm{ms} \pm 26.1 \mathrm{μs}\left({\color{gray}0.170 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 107	$$4.06 \mathrm{ms} \pm 22.1 \mathrm{μs}\left({\color{gray}-0.879 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 133	$$4.32 \mathrm{ms} \pm 29.0 \mathrm{μs}\left({\color{gray}0.710 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.48 \mathrm{ms} \pm 23.2 \mathrm{μs}\left({\color{gray}0.754 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 63	$$4.11 \mathrm{ms} \pm 35.5 \mathrm{μs}\left({\color{gray}1.29 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_none

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2	$$2.59 \mathrm{ms} \pm 18.5 \mathrm{μs}\left({\color{gray}-0.558 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.48 \mathrm{ms} \pm 12.1 \mathrm{μs}\left({\color{gray}-2.410 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 1	$$2.60 \mathrm{ms} \pm 24.1 \mathrm{μs}\left({\color{gray}1.55 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 8	$$2.85 \mathrm{ms} \pm 15.0 \mathrm{μs}\left({\color{gray}-1.140 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.63 \mathrm{ms} \pm 12.4 \mathrm{μs}\left({\color{gray}-0.164 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 3	$$2.85 \mathrm{ms} \pm 18.2 \mathrm{μs}\left({\color{gray}0.269 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_small

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 52	$$2.99 \mathrm{ms} \pm 19.3 \mathrm{μs}\left({\color{gray}0.411 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.71 \mathrm{ms} \pm 17.4 \mathrm{μs}\left({\color{gray}-1.209 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 25	$$2.96 \mathrm{ms} \pm 19.9 \mathrm{μs}\left({\color{gray}-0.574 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 94	$$3.34 \mathrm{ms} \pm 18.1 \mathrm{μs}\left({\color{gray}-0.915 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$2.95 \mathrm{ms} \pm 15.0 \mathrm{μs}\left({\color{gray}-1.230 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 26	$$3.25 \mathrm{ms} \pm 17.2 \mathrm{μs}\left({\color{gray}-0.684 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 66	$$3.31 \mathrm{ms} \pm 21.7 \mathrm{μs}\left({\color{gray}-0.250 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.93 \mathrm{ms} \pm 15.4 \mathrm{μs}\left({\color{gray}-0.921 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 29	$$3.30 \mathrm{ms} \pm 18.3 \mathrm{μs}\left({\color{gray}-0.965 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_complete

Function	Value	Mean	Flame graphs
entity_by_id;one_depth	1 entities	$$54.1 \mathrm{ms} \pm 334 \mathrm{μs}\left({\color{gray}-2.846 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	10 entities	$$47.0 \mathrm{ms} \pm 318 \mathrm{μs}\left({\color{gray}0.026 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	25 entities	$$51.6 \mathrm{ms} \pm 283 \mathrm{μs}\left({\color{gray}-0.635 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	5 entities	$$44.2 \mathrm{ms} \pm 215 \mathrm{μs}\left({\color{gray}-2.013 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	50 entities	$$62.4 \mathrm{ms} \pm 368 \mathrm{μs}\left({\color{gray}-2.977 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	1 entities	$$62.8 \mathrm{ms} \pm 399 \mathrm{μs}\left({\color{gray}0.384 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	10 entities	$$57.1 \mathrm{ms} \pm 388 \mathrm{μs}\left({\color{gray}-0.720 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	25 entities	$$105 \mathrm{ms} \pm 625 \mathrm{μs}\left({\color{gray}0.214 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	5 entities	$$46.9 \mathrm{ms} \pm 225 \mathrm{μs}\left({\color{gray}-1.337 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	50 entities	$$294 \mathrm{ms} \pm 870 \mathrm{μs}\left({\color{gray}0.549 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	1 entities	$$19.1 \mathrm{ms} \pm 96.2 \mathrm{μs}\left({\color{gray}-2.617 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	10 entities	$$20.0 \mathrm{ms} \pm 115 \mathrm{μs}\left({\color{gray}-1.585 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	25 entities	$$20.8 \mathrm{ms} \pm 107 \mathrm{μs}\left({\color{gray}-0.221 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	5 entities	$$19.3 \mathrm{ms} \pm 98.6 \mathrm{μs}\left({\color{gray}-4.921 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	50 entities	$$24.6 \mathrm{ms} \pm 245 \mathrm{μs}\left({\color{gray}-4.935 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_linkless

Function	Value	Mean	Flame graphs
entity_by_id	1 entities	$$19.1 \mathrm{ms} \pm 108 \mathrm{μs}\left({\color{gray}-1.352 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10 entities	$$19.7 \mathrm{ms} \pm 118 \mathrm{μs}\left({\color{gray}-0.806 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	100 entities	$$19.6 \mathrm{ms} \pm 132 \mathrm{μs}\left({\color{gray}-0.512 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	1000 entities	$$20.4 \mathrm{ms} \pm 120 \mathrm{μs}\left({\color{gray}-0.487 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10000 entities	$$26.5 \mathrm{ms} \pm 267 \mathrm{μs}\left({\color{gray}-2.394 \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	$$35.6 \mathrm{ms} \pm 298 \mathrm{μs}\left({\color{gray}2.28 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/book/v/1	$$35.2 \mathrm{ms} \pm 305 \mathrm{μs}\left({\color{gray}2.41 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/building/v/1	$$35.5 \mathrm{ms} \pm 296 \mathrm{μs}\left({\color{gray}2.68 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/organization/v/1	$$34.4 \mathrm{ms} \pm 265 \mathrm{μs}\left({\color{gray}-2.758 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/page/v/2	$$34.8 \mathrm{ms} \pm 295 \mathrm{μs}\left({\color{gray}-3.186 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/person/v/1	$$34.7 \mathrm{ms} \pm 309 \mathrm{μs}\left({\color{gray}0.262 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/playlist/v/1	$$36.2 \mathrm{ms} \pm 301 \mathrm{μs}\left({\color{gray}2.27 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/song/v/1	$$35.7 \mathrm{ms} \pm 276 \mathrm{μs}\left({\color{gray}2.89 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/uk-address/v/1	$$35.5 \mathrm{ms} \pm 259 \mathrm{μs}\left({\color{gray}0.818 \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.42 \mathrm{ms} \pm 41.3 \mathrm{μs}\left({\color{gray}-1.378 \mathrm{\%}}\right) $$	Flame Graph

representative_read_multiple_entities

Function	Value	Mean	Flame graphs
entity_by_property	traversal_paths=0	0	$$92.3 \mathrm{ms} \pm 665 \mathrm{μs}\left({\color{gray}-0.301 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$148 \mathrm{ms} \pm 863 \mathrm{μs}\left({\color{gray}-0.997 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$99.7 \mathrm{ms} \pm 643 \mathrm{μs}\left({\color{gray}-0.431 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$111 \mathrm{ms} \pm 634 \mathrm{μs}\left({\color{gray}-0.299 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:2;links:1;link_dests:0;type:true	$$117 \mathrm{ms} \pm 600 \mathrm{μs}\left({\color{gray}-1.247 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$125 \mathrm{ms} \pm 635 \mathrm{μs}\left({\color{gray}-1.635 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=0	0	$$103 \mathrm{ms} \pm 452 \mathrm{μs}\left({\color{gray}-0.551 \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	$$133 \mathrm{ms} \pm 636 \mathrm{μs}\left({\color{gray}-1.451 \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	$$111 \mathrm{ms} \pm 575 \mathrm{μs}\left({\color{gray}-0.228 \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	$$120 \mathrm{ms} \pm 644 \mathrm{μs}\left({\color{gray}-0.417 \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	$$122 \mathrm{ms} \pm 664 \mathrm{μs}\left({\color{gray}-0.514 \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	$$121 \mathrm{ms} \pm 606 \mathrm{μs}\left({\color{gray}-0.793 \mathrm{\%}}\right) $$

scenarios

Function	Value	Mean	Flame graphs
full_test	query-limited	$$189 \mathrm{ms} \pm 777 \mathrm{μs}\left({\color{gray}0.133 \mathrm{\%}}\right) $$	Flame Graph
full_test	query-unlimited	$$150 \mathrm{ms} \pm 603 \mathrm{μs}\left({\color{gray}-3.399 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-limited	$$40.5 \mathrm{ms} \pm 201 \mathrm{μs}\left({\color{gray}-2.510 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-unlimited	$$582 \mathrm{ms} \pm 1.06 \mathrm{ms}\left({\color{gray}1.75 \mathrm{\%}}\right) $$	Flame Graph

[Copilot]

Pull request overview

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