BE-756: Set up hash-graph-authentication crate

[TimDiekmann]

🌟 What is the purpose of this PR?

Sets up the crate, no further changes.

[vercel]

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

3 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
hash	Ignored	Preview	Aug 12, 2026 3:46pm
hashdotdesign-tokens	Ignored	Preview	Aug 12, 2026 3:46pm
petrinaut	Skipped		Aug 12, 2026 3:46pm

[github-advanced-security]

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

• The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
• Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
• You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out the documentation.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 59.63%. Comparing base (38ab9fd) to head (a9d7b51).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #9209   +/-   ##
=======================================
  Coverage   59.63%   59.63%           
=======================================
  Files        1420     1421    +1     
  Lines      138767   138770    +3     
  Branches     6555     6555           
=======================================
+ Hits        82753    82755    +2     
- Misses      54950    54951    +1     
  Partials     1064     1064           

Flag	Coverage Δ
rust.hash-graph-authentication	100.00% <100.00%> (?)

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.

[codspeed-hq]

Merging this PR will degrade performance by 15.38%

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

❌ 2 regressed benchmarks
✅ 96 untouched benchmarks

Warning

Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

	Benchmark	BASE	HEAD	Efficiency
❌	bit_matrix/dense/iter_row[64]	140.8 ns	170 ns	-17.16%
❌	bit_matrix/dense/iter_row[200]	185.8 ns	215 ns	-13.57%

Tip

Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing t/be-756-set-up-graph-authentication-crate (a9d7b51) with main (38ab9fd)¹}

Footnotes

1. No successful run was found on main (7d02529) during the generation of this report, so 38ab9fd was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

[cursor]

PR Summary

^{Cursor Bugbot is generating a summary for commit a9d7b51. Configure here.}

[Copilot]

Pull request overview

Sets up the hash-graph-authentication Rust crate for future Graph credential validation.

Changes:

• Adds the crate scaffold, metadata, documentation, and tooling.
• Registers the crate in Cargo and Yarn workspaces.
• Updates generated lockfiles and dependency documentation.

Reviewed changes

Copilot reviewed 7 out of 9 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
Cargo.toml	Registers the new workspace crate and dependency.
Cargo.lock	Records the new Rust package.
yarn.lock	Records the new workspace package.
libs/@local/graph/authentication/Cargo.toml	Defines crate metadata and dependencies.
libs/@local/graph/authentication/src/lib.rs	Adds the library entry point and scaffold test.
libs/@local/graph/authentication/package.json	Adds monorepo scripts and package metadata.
libs/@local/graph/authentication/README.md	Describes the crate’s intended role.
libs/@local/graph/authentication/LICENSE.md	Adds the AGPL license.
libs/@local/graph/authentication/docs/dependency-diagram.mmd	Adds the initial dependency diagram.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[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	$$25.4 \mathrm{ms} \pm 176 \mathrm{μs}\left({\color{gray}-0.935 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$3.39 \mathrm{ms} \pm 15.3 \mathrm{μs}\left({\color{gray}-0.050 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 1002	$$12.0 \mathrm{ms} \pm 93.0 \mathrm{μs}\left({\color{gray}-0.376 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 3314	$$42.0 \mathrm{ms} \pm 382 \mathrm{μs}\left({\color{gray}-0.908 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$14.3 \mathrm{ms} \pm 96.5 \mathrm{μs}\left({\color{gray}0.394 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 1527	$$23.5 \mathrm{ms} \pm 194 \mathrm{μs}\left({\color{gray}0.883 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 2078	$$26.5 \mathrm{ms} \pm 271 \mathrm{μs}\left({\color{gray}0.033 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.74 \mathrm{ms} \pm 19.4 \mathrm{μs}\left({\color{gray}1.04 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 1033	$$13.1 \mathrm{ms} \pm 87.3 \mathrm{μs}\left({\color{gray}0.027 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_medium

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 102	$$3.72 \mathrm{ms} \pm 18.8 \mathrm{μs}\left({\color{gray}0.058 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$3.01 \mathrm{ms} \pm 14.4 \mathrm{μs}\left({\color{gray}0.485 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 52	$$3.37 \mathrm{ms} \pm 20.4 \mathrm{μs}\left({\color{gray}0.423 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 269	$$5.11 \mathrm{ms} \pm 35.5 \mathrm{μs}\left({\color{gray}0.339 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.56 \mathrm{ms} \pm 22.2 \mathrm{μs}\left({\color{gray}0.891 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 108	$$4.13 \mathrm{ms} \pm 24.2 \mathrm{μs}\left({\color{gray}1.05 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 133	$$4.36 \mathrm{ms} \pm 33.1 \mathrm{μs}\left({\color{gray}1.09 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$3.44 \mathrm{ms} \pm 18.7 \mathrm{μs}\left({\color{gray}-0.683 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 63	$$4.02 \mathrm{ms} \pm 18.8 \mathrm{μs}\left({\color{gray}-1.257 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_none

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 2	$$2.58 \mathrm{ms} \pm 13.6 \mathrm{μs}\left({\color{gray}-3.429 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.50 \mathrm{ms} \pm 14.0 \mathrm{μs}\left({\color{gray}-2.080 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 2	$$2.58 \mathrm{ms} \pm 15.9 \mathrm{μs}\left({\color{gray}-3.976 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 8	$$2.86 \mathrm{ms} \pm 16.1 \mathrm{μs}\left({\color{gray}-2.946 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.64 \mathrm{ms} \pm 12.8 \mathrm{μs}\left({\color{gray}-3.824 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 3	$$2.83 \mathrm{ms} \pm 15.2 \mathrm{μs}\left({\color{gray}-3.465 \mathrm{\%}}\right) $$	Flame Graph

policy_resolution_small

Function	Value	Mean	Flame graphs
resolve_policies_for_actor	user: empty, selectivity: high, policies: 52	$$3.03 \mathrm{ms} \pm 21.7 \mathrm{μs}\left({\color{gray}-0.395 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: low, policies: 1	$$2.75 \mathrm{ms} \pm 12.8 \mathrm{μs}\left({\color{gray}0.148 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: empty, selectivity: medium, policies: 26	$$3.00 \mathrm{ms} \pm 20.1 \mathrm{μs}\left({\color{gray}1.01 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: high, policies: 94	$$3.40 \mathrm{ms} \pm 19.8 \mathrm{μs}\left({\color{gray}0.677 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: low, policies: 1	$$3.00 \mathrm{ms} \pm 17.7 \mathrm{μs}\left({\color{gray}0.249 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: seeded, selectivity: medium, policies: 27	$$3.31 \mathrm{ms} \pm 19.5 \mathrm{μs}\left({\color{gray}0.885 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: high, policies: 66	$$3.33 \mathrm{ms} \pm 17.5 \mathrm{μs}\left({\color{gray}-0.174 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: low, policies: 1	$$2.98 \mathrm{ms} \pm 15.0 \mathrm{μs}\left({\color{gray}-0.182 \mathrm{\%}}\right) $$	Flame Graph
resolve_policies_for_actor	user: system, selectivity: medium, policies: 29	$$3.32 \mathrm{ms} \pm 27.5 \mathrm{μs}\left({\color{gray}1.23 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_complete

Function	Value	Mean	Flame graphs
entity_by_id;one_depth	1 entities	$$42.1 \mathrm{ms} \pm 174 \mathrm{μs}\left({\color{gray}-0.640 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	10 entities	$$33.1 \mathrm{ms} \pm 152 \mathrm{μs}\left({\color{gray}-1.614 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	25 entities	$$35.3 \mathrm{ms} \pm 142 \mathrm{μs}\left({\color{gray}-1.643 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	5 entities	$$42.8 \mathrm{ms} \pm 1.21 \mathrm{ms}\left({\color{red}32.4 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;one_depth	50 entities	$$41.4 \mathrm{ms} \pm 283 \mathrm{μs}\left({\color{gray}-1.100 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	1 entities	$$49.3 \mathrm{ms} \pm 181 \mathrm{μs}\left({\color{gray}-0.086 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	10 entities	$$39.6 \mathrm{ms} \pm 204 \mathrm{μs}\left({\color{gray}-2.340 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	25 entities	$$89.7 \mathrm{ms} \pm 464 \mathrm{μs}\left({\color{gray}-0.463 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	5 entities	$$43.9 \mathrm{ms} \pm 3.62 \mathrm{ms}\left({\color{red}30.1 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;two_depth	50 entities	$$303 \mathrm{ms} \pm 980 \mathrm{μs}\left({\color{gray}2.15 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	1 entities	$$10.9 \mathrm{ms} \pm 69.6 \mathrm{μs}\left({\color{gray}0.032 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	10 entities	$$11.0 \mathrm{ms} \pm 51.1 \mathrm{μs}\left({\color{gray}-0.074 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	25 entities	$$11.0 \mathrm{ms} \pm 56.6 \mathrm{μs}\left({\color{gray}-0.576 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	5 entities	$$10.9 \mathrm{ms} \pm 65.1 \mathrm{μs}\left({\color{gray}-0.401 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id;zero_depth	50 entities	$$11.0 \mathrm{ms} \pm 67.6 \mathrm{μs}\left({\color{gray}-0.034 \mathrm{\%}}\right) $$	Flame Graph

read_scaling_linkless

Function	Value	Mean	Flame graphs
entity_by_id	1 entities	$$10.9 \mathrm{ms} \pm 58.7 \mathrm{μs}\left({\color{gray}-0.992 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10 entities	$$11.0 \mathrm{ms} \pm 43.5 \mathrm{μs}\left({\color{gray}-1.001 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	100 entities	$$11.0 \mathrm{ms} \pm 64.4 \mathrm{μs}\left({\color{gray}-0.510 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	1000 entities	$$11.0 \mathrm{ms} \pm 67.7 \mathrm{μs}\left({\color{gray}-0.240 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	10000 entities	$$11.2 \mathrm{ms} \pm 70.7 \mathrm{μs}\left({\color{gray}-0.609 \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 57.4 \mathrm{μs}\left({\color{gray}-1.240 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/book/v/1	$$11.4 \mathrm{ms} \pm 62.6 \mathrm{μs}\left({\color{gray}0.740 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/building/v/1	$$11.3 \mathrm{ms} \pm 62.4 \mathrm{μs}\left({\color{gray}-0.697 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/organization/v/1	$$11.4 \mathrm{ms} \pm 59.2 \mathrm{μs}\left({\color{gray}0.356 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/page/v/2	$$11.3 \mathrm{ms} \pm 54.1 \mathrm{μs}\left({\color{gray}-0.874 \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 59.0 \mathrm{μs}\left({\color{gray}-0.045 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/playlist/v/1	$$11.3 \mathrm{ms} \pm 48.4 \mathrm{μs}\left({\color{gray}-1.213 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/song/v/1	$$11.2 \mathrm{ms} \pm 46.0 \mathrm{μs}\left({\color{gray}-1.269 \mathrm{\%}}\right) $$	Flame Graph
entity_by_id	entity type ID: https://blockprotocol.org/@alice/types/entity-type/uk-address/v/1	$$11.3 \mathrm{ms} \pm 55.8 \mathrm{μs}\left({\color{gray}-0.674 \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.44 \mathrm{ms} \pm 48.8 \mathrm{μs}\left({\color{gray}-0.381 \mathrm{\%}}\right) $$	Flame Graph

representative_read_multiple_entities

Function	Value	Mean	Flame graphs
entity_by_property	traversal_paths=0	0	$$55.9 \mathrm{ms} \pm 275 \mathrm{μs}\left({\color{gray}-3.390 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=255	1,resolve_depths=inherit:1;values:255;properties:255;links:127;link_dests:126;type:true	$$107 \mathrm{ms} \pm 540 \mathrm{μs}\left({\color{gray}-2.048 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:0;link_dests:0;type:false	$$63.5 \mathrm{ms} \pm 412 \mathrm{μs}\left({\color{gray}-2.994 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:0;properties:0;links:1;link_dests:0;type:true	$$73.0 \mathrm{ms} \pm 409 \mathrm{μs}\left({\color{gray}-2.922 \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.0 \mathrm{ms} \pm 426 \mathrm{μs}\left({\color{gray}-2.096 \mathrm{\%}}\right) $$
entity_by_property	traversal_paths=2	1,resolve_depths=inherit:0;values:2;properties:2;links:1;link_dests:0;type:true	$$88.1 \mathrm{ms} \pm 515 \mathrm{μs}\left({\color{gray}-0.896 \mathrm{\%}}\right) $$
link_by_source_by_property	traversal_paths=0	0	$$42.6 \mathrm{ms} \pm 241 \mathrm{μs}\left({\color{gray}-1.097 \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	$$70.3 \mathrm{ms} \pm 373 \mathrm{μs}\left({\color{gray}-1.496 \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	$$48.5 \mathrm{ms} \pm 209 \mathrm{μs}\left({\color{gray}-1.345 \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	$$57.8 \mathrm{ms} \pm 321 \mathrm{μs}\left({\color{gray}-1.179 \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	$$60.2 \mathrm{ms} \pm 375 \mathrm{μs}\left({\color{gray}-1.253 \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	$$60.4 \mathrm{ms} \pm 458 \mathrm{μs}\left({\color{gray}-1.233 \mathrm{\%}}\right) $$

scenarios

Function	Value	Mean	Flame graphs
full_test	query-limited	$$126 \mathrm{ms} \pm 614 \mathrm{μs}\left({\color{gray}4.53 \mathrm{\%}}\right) $$	Flame Graph
full_test	query-unlimited	$$136 \mathrm{ms} \pm 419 \mathrm{μs}\left({\color{gray}2.36 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-limited	$$20.5 \mathrm{ms} \pm 289 \mathrm{μs}\left({\color{red}8.85 \mathrm{\%}}\right) $$	Flame Graph
linked_queries	query-unlimited	$$558 \mathrm{ms} \pm 1.06 \mathrm{ms}\left({\color{gray}2.64 \mathrm{\%}}\right) $$	Flame Graph