Skip to content

Turbopack: snapshot the ModuleGraph to avoid (eventual) inconsistent graphs #88340

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
sokra merged 8 commits into from
Jan 16, 2026
Merged

Turbopack: snapshot the ModuleGraph to avoid (eventual) inconsistent graphs #88340

sokra merged 8 commits into from
Jan 16, 2026
+434 −349

Conversation

@sokra
Copy link
Member

@sokra sokra commented Jan 9, 2026 •
edited
Loading

What?

Refactor ModuleGraph to be a strongly consistent snapshot of the module graph. This should avoid eventually consistency problems where different versions of single module graphs do not fit together.

@nextjs-bot nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js. labels Jan 9, 2026
This was referenced Jan 9, 2026
Merged
Merged
Merged
Merged
Merged
Merged
Merged
Merged
Merged
@sokra Graphite App
Copy link
Member Author

sokra commented Jan 9, 2026 •
edited
Loading

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

@sokra sokra mentioned this pull request Jan 9, 2026
Draft
@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Jan 9, 2026

Allow CI Workflow Run

  • approve CI run for commit: 52d9dd0

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

@sokra sokra changed the title Turbopack: pass binding info as operation to module graph Turbopack: snapshot the ModuleGraph to avoid (eventual) inconsistent graphs Jan 9, 2026
@sokra sokra marked this pull request as ready for review January 9, 2026 17:57
@sokra sokra requested a review from mischnic January 9, 2026 17:57
@sokra sokra force-pushed the sokra/parallel-backend branch from 9b8b94f to e70e940 Compare January 12, 2026 09:23
@sokra sokra force-pushed the sokra/module-graph-consistency branch from 52d9dd0 to 965d41d Compare January 12, 2026 09:23
This was referenced Jan 12, 2026
Merged
Merged
Merged
vercel[bot]
vercel bot reviewed Jan 12, 2026
View reviewed changes
@codspeed-hq
Copy link

codspeed-hq bot commented Jan 12, 2026 •
edited
Loading

CodSpeed Performance Report

Merging this PR will not alter performance

Comparing sokra/module-graph-consistency (236485f) with canary (fcfcbce)

Summary

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks1

Footnotes

  1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Jan 12, 2026 •
edited
Loading

Failing test suites

Commit: 236485f | About building and testing Next.js

@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Jan 12, 2026 •
edited
Loading

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 455ms 455ms ✓ ▁▁▁▁▁
Cold (Ready in log) 436ms 436ms ✓ ▆▆▆▆▁
Cold (First Request) 1.141s 1.170s ✓ █▇█▇▁
Warm (Listen) 457ms 456ms ✓ ▁▁▁▁▁
Warm (Ready in log) 440ms 441ms ✓ ▁▁▁▁▁
Warm (First Request) 340ms 335ms ✓ ▆▆▂▃▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 456ms 456ms ✓ ▁▁▁▁▁
Cold (Ready in log) 444ms 444ms ✓ ▄▄▁▄▄
Cold (First Request) 1.848s 1.839s ✓ ▂▂▁▂▂
Warm (Listen) 456ms 456ms ✓ ▁▁▁▁▁
Warm (Ready in log) 443ms 442ms ✓ ▅▄▁▃▃
Warm (First Request) 1.861s 1.834s ✓ ▃▂▁▂▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.389s 4.410s ✓ ▂▁▁▁▂
Cached Build 4.322s 4.387s ✓ ▁▁▁▁▂
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 14.095s 14.111s ✓ ▁▁▁▁▁
Cached Build 14.146s 14.209s ✓ ▁▁▁▁▁
node_modules Size 458 MB 458 MB ✓ ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **430 kB** → **430 kB** ✅ -81 B

82 files with content-based hashes (individual files not comparable between builds)

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 790 B 785 B ✓
Total 790 B 785 B ✅ -5 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 449 B 450 B ✓
Total 449 B 450 B ⚠️ +1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
2086.HASH.js gzip 169 B N/A -
2161-HASH.js gzip 5.41 kB N/A -
2747-HASH.js gzip 4.48 kB N/A -
4322-HASH.js gzip 52.3 kB N/A -
ec793fe8-HASH.js gzip 62.3 kB N/A -
framework-HASH.js gzip 59.8 kB 59.8 kB ✓
main-app-HASH.js gzip 251 B 252 B ✓
main-HASH.js gzip 38.6 kB 38.9 kB ✓
webpack-HASH.js gzip 1.68 kB 1.68 kB ✓
1596.HASH.js gzip N/A 169 B -
2658-HASH.js gzip N/A 51.9 kB -
6349-HASH.js gzip N/A 4.46 kB -
7019-HASH.js gzip N/A 5.43 kB -
b17a3386-HASH.js gzip N/A 62.3 kB -
Total 225 kB 225 kB ✅ -12 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB ✓
Total 39.4 kB 39.4 kB ✓
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B ✓
_error-HASH.js gzip 182 B 182 B ✓
css-HASH.js gzip 336 B 335 B ✓
dynamic-HASH.js gzip 1.8 kB 1.8 kB ✓
edge-ssr-HASH.js gzip 256 B 256 B ✓
head-HASH.js gzip 352 B 349 B ✓
hooks-HASH.js gzip 385 B 384 B ✓
image-HASH.js gzip 580 B 580 B ✓
index-HASH.js gzip 259 B 258 B ✓
link-HASH.js gzip 2.5 kB 2.51 kB ✓
routerDirect..HASH.js gzip 319 B 317 B ✓
script-HASH.js gzip 385 B 387 B ✓
withRouter-HASH.js gzip 316 B 315 B ✓
1afbb74e6ecf..834.css gzip 106 B 106 B ✓
Total 7.97 kB 7.96 kB ✅ -8 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB ✓
page.js gzip 242 kB 237 kB 🟢 4.85 kB (-2%)
Total 366 kB 362 kB ✅ -4.84 kB
Middleware
Canary PR Change
middleware-b..fest.js gzip 654 B 653 B ✓
middleware-r..fest.js gzip 155 B 156 B ✓
middleware.js gzip 33.2 kB 33.3 kB ✓
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 34.8 kB 34.9 kB ⚠️ +104 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 738 B 738 B ✓
Total 738 B 738 B ✓
Build Cache
Canary PR Change
0.pack gzip 3.66 MB 3.67 MB 🔴 +8.15 kB (+0%)
index.pack gzip 99.8 kB 99.1 kB ✓
index.pack.old gzip 99.9 kB 99 kB ✓
Total 3.86 MB 3.86 MB ⚠️ +6.57 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 303 kB 303 kB ✓
app-page-exp..prod.js gzip 158 kB 158 kB ✓
app-page-tur...dev.js gzip 303 kB 303 kB ✓
app-page-tur..prod.js gzip 158 kB 158 kB ✓
app-page-tur...dev.js gzip 300 kB 300 kB ✓
app-page-tur..prod.js gzip 156 kB 156 kB ✓
app-page.run...dev.js gzip 300 kB 300 kB ✓
app-page.run..prod.js gzip 156 kB 156 kB ✓
app-route-ex...dev.js gzip 68.8 kB 68.8 kB ✓
app-route-ex..prod.js gzip 47.6 kB 47.6 kB ✓
app-route-tu...dev.js gzip 68.8 kB 68.8 kB ✓
app-route-tu..prod.js gzip 47.6 kB 47.6 kB ✓
app-route-tu...dev.js gzip 68.4 kB 68.4 kB ✓
app-route-tu..prod.js gzip 47.4 kB 47.4 kB ✓
app-route.ru...dev.js gzip 68.4 kB 68.4 kB ✓
app-route.ru..prod.js gzip 47.3 kB 47.3 kB ✓
dist_client_...dev.js gzip 324 B 324 B ✓
dist_client_...dev.js gzip 326 B 326 B ✓
dist_client_...dev.js gzip 318 B 318 B ✓
dist_client_...dev.js gzip 317 B 317 B ✓
pages-api-tu...dev.js gzip 41.2 kB 41.2 kB ✓
pages-api-tu..prod.js gzip 31.3 kB 31.3 kB ✓
pages-api.ru...dev.js gzip 41.1 kB 41.1 kB ✓
pages-api.ru..prod.js gzip 31.2 kB 31.2 kB ✓
pages-turbo....dev.js gzip 50.8 kB 50.8 kB ✓
pages-turbo...prod.js gzip 38.2 kB 38.2 kB ✓
pages.runtim...dev.js gzip 50.7 kB 50.7 kB ✓
pages.runtim..prod.js gzip 38.2 kB 38.2 kB ✓
server.runti..prod.js gzip 62.2 kB 62.2 kB ✓
Total 2.69 MB 2.69 MB ⚠️ +1 B

mischnic
mischnic reviewed Jan 12, 2026
View reviewed changes
@sokra sokra changed the base branch from sokra/parallel-backend to graphite-base/88340 January 13, 2026 14:31
@sokra sokra force-pushed the sokra/module-graph-consistency branch from 965d41d to f872016 Compare January 13, 2026 15:43
@sokra sokra force-pushed the graphite-base/88340 branch from e70e940 to afefad3 Compare January 13, 2026 15:43
@sokra sokra force-pushed the sokra/module-graph-consistency branch from cc11d10 to d8ab648 Compare January 15, 2026 07:59
@sokra sokra force-pushed the sokra/eventual-consistency-no-remove-cells branch from 244302b to 642c1ae Compare January 15, 2026 07:59
@sokra sokra changed the base branch from sokra/eventual-consistency-no-remove-cells to graphite-base/88340 January 15, 2026 10:51
@sokra sokra force-pushed the graphite-base/88340 branch from 642c1ae to e3ccc40 Compare January 15, 2026 10:51
@sokra sokra force-pushed the sokra/module-graph-consistency branch from d8ab648 to b53ac2f Compare January 15, 2026 10:51
@sokra sokra changed the base branch from graphite-base/88340 to sokra/eventual-consistency-no-remove-cells January 15, 2026 10:51
@sokra sokra force-pushed the sokra/module-graph-consistency branch from b53ac2f to bf897af Compare January 15, 2026 18:37
@sokra sokra force-pushed the sokra/eventual-consistency-no-remove-cells branch 3 times, most recently from 5853953 to f51ffd1 Compare January 15, 2026 19:19
@sokra sokra force-pushed the sokra/module-graph-consistency branch from bf897af to cea0b88 Compare January 15, 2026 19:19
@sokra sokra changed the base branch from sokra/eventual-consistency-no-remove-cells to graphite-base/88340 January 16, 2026 05:43
@sokra sokra force-pushed the sokra/module-graph-consistency branch from cea0b88 to 3b98426 Compare January 16, 2026 05:44
@sokra sokra force-pushed the graphite-base/88340 branch from f51ffd1 to fcfcbce Compare January 16, 2026 05:44
@sokra sokra force-pushed the sokra/module-graph-consistency branch from 3b98426 to 92471c6 Compare January 16, 2026 05:44
@graphite-app graphite-app bot changed the base branch from graphite-base/88340 to canary January 16, 2026 05:44
@sokra sokra force-pushed the sokra/module-graph-consistency branch 2 times, most recently from e21693e to ab71fe2 Compare January 16, 2026 05:45
@sokra sokra force-pushed the sokra/module-graph-consistency branch from ab71fe2 to 236485f Compare January 16, 2026 07:03
@sokra sokra merged commit cfe29f9 into canary Jan 16, 2026
549 of 559 checks passed
@sokra sokra deleted the sokra/module-graph-consistency branch January 16, 2026 08:59
wyattjoh pushed a commit that referenced this pull request Jan 16, 2026
@sokra @wyattjoh
Turbopack: snapshot the ModuleGraph to avoid (eventual) inconsistent …
b92e7e6 
…graphs (#88340)

### What?

Refactor ModuleGraph to be a strongly consistent snapshot of the module graph. This should avoid eventually consistency problems where different versions of single module graphs do not fit together.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@vercel vercel[bot] vercel[bot] left review comments

@mischnic mischnic mischnic approved these changes

Assignees

No one assigned

Labels

created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@sokra @nextjs-bot @mischnic