Skip to content

Conversation

@lukesandberg
Copy link
Contributor

@lukesandberg lukesandberg commented Feb 2, 2026

What?

Optimizes the change tracking mechanism used for persistent cache snapshots in turbo-tasks-backend.

Why?

The previous implementation used a FxDashMap<TaskId, ModifiedState> to track modified tasks, where ModifiedState was an enum with Modified and Snapshot(Option<Box<TaskStorage>>) variants. This had several inefficiencies:

  1. Memory overhead: The ModifiedState enum was 16 bytes to account for the rare 'snapshot race' case
  2. Datastructure overhead: the DashMap for the modified map was highly sharded leading to large amounts of memory overhead. Most acquisitions were extremely short lived and so this isn't necessary.
  3. Separate task cache log: New task types were tracked in a separate TaskCacheLog structure (Sharded<ChunkedVec<...>>), requiring additional synchronization and a separate persistence path.

How?

Restructured change tracking into two separate data structures:

  1. modified: Sharded<Vec<TaskId>> - A sharded append-only list for tracking modified task IDs. Since modifications are guarded by a transition in the any_modified flag on TaskStorage, each task is only added once, avoiding duplicates without additional synchronization.

  2. snapshots: FxDashMap<TaskId, Option<Box<TaskStorage>>> - A small, rarely-used map for the uncommon case where a task is modified during an active snapshot operation. Uses only 16 shards since this is rare (only during dev mode idle-callback persistence races).

Unified task cache persistence:

  • Removed the separate TaskCacheLog and ChunkedVec infrastructure
  • New tasks now include their task_type directly in the SnapshotItem struct
  • Task cache entries are written inline with task data during persistence, simplifying the write path

Other optimizations:

  • SmallVec::into_boxed_slice() now called directly instead of into_vec().into_boxed_slice() (avoids intermediate allocation)
  • Removed swap_retain utility (no longer needed)
  • Simplified snapshot iteration using scope_and_block with chunked shards, this reduces the number of 'scratch buffers' allocated to 'one per chunk' instead of 'one per original shard'

Results on vercel-site

I ran a sequence of builds on vercel-site comparing canary and this branch

Cold Cache Builds

Metric Optimization (87071fe) Canary (479877d) Difference
Duration (avg) 82.98s 82.56s +0.51%
Duration (min) 82.44s 80.39s
Duration (max) 83.20s 87.24s
Duration (std dev) 0.27s 2.22s
Peak Memory (avg) 21.92 GB 23.07 GB -4.98%
Peak Memory (min) 21.83 GB 22.64 GB
Peak Memory (max) 22.06 GB 23.78 GB
Sample Size n=6 n=6

Warm Cache Builds

Metric Optimization (87071fe) Canary (479877d) Difference
Duration (avg) 13.71s 14.75s -7.02%
Duration (min) 10.65s 11.41s
Duration (max) 17.77s 19.84s
Peak Memory (avg) 11.10 GB 11.39 GB -2.49%
Peak Memory (min) 10.76 GB 10.68 GB
Peak Memory (max) 11.48 GB 12.06 GB
Sample Size n=12 n=12

The latency deltas are in the noise but there are substantial memory wins from this change

@nextjs-bot nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. Turbopack Related to Turbopack with Next.js. labels Feb 2, 2026
Copy link
Contributor Author

lukesandberg commented Feb 2, 2026

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

@codspeed-hq
Copy link

codspeed-hq bot commented Feb 2, 2026

CodSpeed Performance Report

Merging this PR will improve performance by 3.65%

Comparing optimized_change_tracking (b3d4105) with canary (a5f6590)

Summary

⚡ 1 improved benchmark
✅ 16 untouched benchmarks
⏩ 3 skipped benchmarks1

Performance Changes

Mode Benchmark BASE HEAD Efficiency
Simulation jsonwebtoken.js[tracing] 280.8 ms 270.9 ms +3.65%

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 Feb 2, 2026

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) 435ms 435ms ▂▂▂▂▂
Cold (First Request) 1.190s 1.141s ▄▄▂▅▅
Warm (Listen) 456ms 456ms ▁▁▁▁▁
Warm (Ready in log) 439ms 440ms ▁▁▁▁▁
Warm (First Request) 332ms 337ms ▁▂▂▁▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 455ms 455ms ▅▅▅▁█
Cold (Ready in log) 435ms 434ms ▆▅▁▇▆
Cold (First Request) 1.829s 1.839s ▃▄▁▄▃
Warm (Listen) 456ms 456ms ▅▅▅▅▅
Warm (Ready in log) 434ms 436ms ▃▄▁▇▆
Warm (First Request) 1.857s 1.853s ▃▃▁▅▄

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 3.918s 3.910s ▁▁▃▁▁
Cached Build 4.019s 3.949s ▁▁▃▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 13.582s 13.654s ▁▂▁▁▁
Cached Build 13.761s 13.729s ▁▂▁▁▁
node_modules Size 464 MB 464 MB █▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **434 kB** → **434 kB** ✅ -2 B

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

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 762 B 768 B
Total 762 B 768 B ⚠️ +6 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 450 B 451 B
Total 450 B 451 B ⚠️ +1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.47 kB N/A -
6280-HASH.js gzip 54.5 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.53 kB N/A -
e8aec2e4-HASH.js gzip 62.5 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 256 B 254 B
main-HASH.js gzip 39 kB 39 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
262-HASH.js gzip N/A 4.52 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.48 kB -
6948ada0-HASH.js gzip N/A 62.5 kB -
9544-HASH.js gzip N/A 55.2 kB -
Total 228 kB 228 kB ⚠️ +671 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 194 B
_error-HASH.js gzip 183 B 180 B 🟢 3 B (-2%)
css-HASH.js gzip 331 B 330 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 351 B 352 B
hooks-HASH.js gzip 384 B 383 B
image-HASH.js gzip 580 B 581 B
index-HASH.js gzip 260 B 260 B
link-HASH.js gzip 2.49 kB 2.49 kB
routerDirect..HASH.js gzip 320 B 319 B
script-HASH.js gzip 386 B 386 B
withRouter-HASH.js gzip 315 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.97 kB 7.97 kB ✅ -1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 126 kB 126 kB
page.js gzip 249 kB 249 kB
Total 375 kB 375 kB ⚠️ +130 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 616 B 613 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 32.9 kB 33.2 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 34.5 kB 34.8 kB ⚠️ +255 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 732 B 736 B
Total 732 B 736 B ⚠️ +4 B
Build Cache
Canary PR Change
0.pack gzip 3.8 MB 3.8 MB
index.pack gzip 102 kB 103 kB
index.pack.old gzip 102 kB 104 kB 🔴 +1.58 kB (+2%)
Total 4 MB 4.01 MB ⚠️ +3.13 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 311 kB 311 kB
app-page-exp..prod.js gzip 166 kB 166 kB
app-page-tur...dev.js gzip 311 kB 311 kB
app-page-tur..prod.js gzip 166 kB 166 kB
app-page-tur...dev.js gzip 308 kB 308 kB
app-page-tur..prod.js gzip 164 kB 164 kB
app-page.run...dev.js gzip 308 kB 308 kB
app-page.run..prod.js gzip 164 kB 164 kB
app-route-ex...dev.js gzip 70.4 kB 70.4 kB
app-route-ex..prod.js gzip 48.9 kB 48.9 kB
app-route-tu...dev.js gzip 70.4 kB 70.4 kB
app-route-tu..prod.js gzip 49 kB 49 kB
app-route-tu...dev.js gzip 70 kB 70 kB
app-route-tu..prod.js gzip 48.7 kB 48.7 kB
app-route.ru...dev.js gzip 70 kB 70 kB
app-route.ru..prod.js gzip 48.7 kB 48.7 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 43.1 kB 43.1 kB
pages-api-tu..prod.js gzip 32.9 kB 32.9 kB
pages-api.ru...dev.js gzip 43.1 kB 43.1 kB
pages-api.ru..prod.js gzip 32.8 kB 32.8 kB
pages-turbo....dev.js gzip 52.4 kB 52.4 kB
pages-turbo...prod.js gzip 39.4 kB 39.4 kB
pages.runtim...dev.js gzip 52.4 kB 52.4 kB
pages.runtim..prod.js gzip 39.3 kB 39.3 kB
server.runti..prod.js gzip 62.6 kB 62.6 kB
Total 2.77 MB 2.77 MB

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants