Skip to content

Turbopack: Fix polling watcher dropping rapid edits - #97339

Closed
marcoshernanz wants to merge 1 commit into
canaryfrom
codex/fix-polling-watcher-edits
Closed

Turbopack: Fix polling watcher dropping rapid edits#97339
marcoshernanz wants to merge 1 commit into
canaryfrom
codex/fix-polling-watcher-edits

Conversation

@marcoshernanz

Copy link
Copy Markdown
Contributor

What?

Fixes Turbopack polling mode permanently dropping rapid file edits by pinning a notify 8.2.0 backport that preserves subsecond file mtime precision.

Adds a deterministic turbo-tasks-fs regression test that advances a watched file's mtime twice within one second and verifies the task is invalidated.

Upstream dependency fix: notify-rs/notify#981

Why?

watchOptions.pollIntervalMs selects notify::PollWatcher. Released notify versions convert SystemTime to whole seconds before comparing snapshots. With content hashing disabled, two writes within the same second compare equal, so the second edit emits no event and remains stale until a later edit changes the truncated timestamp.

This is not Windows-only:

  • Issue repro on Windows: 22/25 edits detected; all 25 mtimes advanced.
  • Unmodified canary on Linux: one polling run detected 24/25 edits and never recovered within the 8-second observation window; native control detected 25/25.
  • The deterministic regression timed out after 5 seconds against released notify.

PR #96440 correctly handles WriteTime events once emitted, but cannot recover an event that PollWatcher never produces.

The behavior affects the intended Docker/WSL/network-filesystem polling escape hatch. Related reports include #80665, #80687, #71622, and #94146.

How?

The pinned dependency keeps nanosecond precision for ordinary files without enabling compare_contents, which would hash every watched file on every poll. It retains whole-second behavior for directories and content-hashed watchers to avoid additional directory events and preserve existing event classification.

The pin is based on stable notify 8.2.0 rather than 8.1.0, so it includes the intervening inotify fixes. A TODO links the upstream PR for removal after release.

Verification

  • Baseline, original reporter repo, current canary, Linux:
    • polling: 24/25, then 25/25
    • native controls: 25/25 and 25/25
  • Candidate, untouched reporter probe packaged from this branch:
    • polling: 25/25 and 25/25
    • interleaved native control: 25/25
  • notify 8.2.0 backport: 10 passed, 1 ignored; 5 doc tests passed
  • current upstream notify: 82 passed, 2 ignored; hashing/race/serialization integration tests and 8 doc tests passed
  • cargo test -p turbo-tasks-fs: 119 passed
  • cargo fmt --all -- --check
  • cargo clippy -p turbo-tasks-fs --tests -- -D warnings
  • Full local Next.js package and native binding build
  • Independent closeout review: no actionable findings

Fixes #96982

Co-Authored-By: Marcos Hernanz <96699542+marcoshernanz@users.noreply.github.com>
@github-actions

github-actions Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

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) 814ms 812ms █▂▇▂▂
Cold (Ready in log) 799ms 800ms █▁█▁▁
Cold (First Request) 1.318s 1.316s █▁█▁▁
Warm (Listen) 813ms 813ms █▁▇▁▁
Warm (Ready in log) 790ms 793ms █▁█▁▁
Warm (First Request) 1.296s 1.303s ▁▄█▄▄
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 812ms 810ms ▁▅█▆▆
Cold (Ready in log) 778ms 768ms ▁▂▇▄▄
Cold (First Request) 3.396s 3.314s ▂▁█▆▆
Warm (Listen) 811ms 811ms ▁▃▇▅█
Warm (Ready in log) 773ms 775ms ▁▂▃▁▂
Warm (First Request) 3.383s 3.352s ▁▂▆▂▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.907s 5.823s █▁█▁▁
Cached Build 2.981s 2.971s █▁▇▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 23.708s 23.943s ▂▁▂█▅
Cached Build 23.928s 23.945s ▁▁█▅▄
node_modules Size 554 MB 554 MB █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
03o8j4gdcreqe.js gzip 170 B N/A -
0405hwyamng46.js gzip 157 B N/A -
050icza-xjz0i.js gzip 5.73 kB N/A -
07jdby0ue616s.js gzip 450 B N/A -
0bjdc8muo74n5.js gzip 8.71 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0rci1f3or1a19.js gzip 13.3 kB N/A -
0xojv0e93ooua.js gzip 46.6 kB N/A -
1_2x714--ii1i.js gzip 8.76 kB N/A -
1-3y752pkth5-.js gzip 10 kB N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1ewkwfyqom2y8.js gzip 158 B N/A -
1gyf22uwo685a.js gzip 158 B N/A -
1k6dd7su4cfei.js gzip 3.57 kB N/A -
1pnnjwppyjvra.js gzip 71.5 kB N/A -
1tf1phijqlx9j.js gzip 220 B 220 B
1uzabyd1120a1.js gzip 8.71 kB N/A -
1vvaqv96pfhdm.js gzip 156 B N/A -
2-ufv8lc-g7gg.js gzip 10.6 kB N/A -
21kmjy_10x14f.js gzip 8.81 kB N/A -
28dhc6t85q1_p.js gzip 8.78 kB N/A -
2f-ilvczue-tp.js gzip 9.46 kB N/A -
2f1u17u5c8iny.js gzip 8.79 kB N/A -
2fklnf1x-tk68.js gzip 7.53 kB N/A -
2ifum2q5l9pnn.js gzip 155 B N/A -
2ikltg_8iegxw.js gzip 10.3 kB N/A -
2vxi673cz1-t4.js gzip 8.79 kB N/A -
2w4laifzt1o9q.js gzip 157 B N/A -
31dg94q7iv1fe.js gzip 160 B N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3j981cx6o_t11.js gzip 155 B N/A -
3ki92ksbh68ff.js gzip 152 B N/A -
3l9pr36yz-v2o.js gzip 161 B N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3nbojhxiy1qv_.js gzip 13.7 kB N/A -
3qn872h2wdhw7.js gzip 157 B N/A -
3ueg8wcmwx2u-.js gzip 156 B N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
445s_9hf8o7ao.js gzip 8.76 kB N/A -
44i244dmnulb-.js gzip 65.6 kB N/A -
turbopack-0d..9ejy.js gzip 3.74 kB 3.74 kB
0-6bcj16ji2wf.js gzip N/A 10.6 kB -
056018sbl3xxg.js gzip N/A 156 B -
05d0jzkhr4rde.js gzip N/A 46.6 kB -
07ryk0jced-sc.js gzip N/A 8.78 kB -
0a9npihj78qly.js gzip N/A 157 B -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0roh390ijzxa5.js gzip N/A 8.75 kB -
0rvbkygoup2y6.js gzip N/A 157 B -
0vex9w55ursqj.js gzip N/A 8.79 kB -
0z8h9xivq9k4i.js gzip N/A 156 B -
0zn9pf1bv9yel.js gzip N/A 156 B -
17oe55cu76cd7.js gzip N/A 450 B -
19om32e1m-0cq.js gzip N/A 160 B -
1din_zw2g87o2.js gzip N/A 168 B -
1drww5xikb-c-.js gzip N/A 9.46 kB -
1f2amrrz84mzg.js gzip N/A 151 B -
1g60xde_dv17t.js gzip N/A 8.79 kB -
1o20zijn7kx7u.js gzip N/A 155 B -
1uzv47btzam64.js gzip N/A 5.73 kB -
1vy7n7wxv_rh5.js gzip N/A 8.81 kB -
1x0gfa0ls84m6.js gzip N/A 65.6 kB -
1z2j53gqdechr.js gzip N/A 71.5 kB -
2-0i7pl900-ou.js gzip N/A 8.71 kB -
2-kcbngm7ik7y.js gzip N/A 8.75 kB -
29p5-xa4jmdhg.js gzip N/A 13.7 kB -
2jhbuzgq122u-.js gzip N/A 7.53 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2o4cibp3awtbw.js gzip N/A 3.56 kB -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
336mo8ag01xm6.js gzip N/A 156 B -
36dn8i-_3dnq5.js gzip N/A 10 kB -
3fljpmwcjxqhx.js gzip N/A 10.3 kB -
3gz44skqdlsrb.js gzip N/A 8.71 kB -
3q5e1j1558-w2.js gzip N/A 155 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
446udw0vqke67.js gzip N/A 157 B -
44zkt6f12xfx-.js gzip N/A 162 B -
Total 401 kB 401 kB ✅ -2 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.06 kB 1.06 kB
Total 1.06 kB 1.06 kB ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 878 B 878 B
Total 878 B 878 B
Build Cache
Canary PR Change
00000001.sst gzip 13.9 MB 15.3 MB 🔴 +1.38 MB (+10%)
00000002.sst gzip 14 MB 14.1 MB 🔴 +65.4 kB (+0%)
00000003.sst gzip 13.9 MB 13.6 MB 🟢 309 kB (-2%)
00000004.sst gzip 13.5 MB 12.3 MB 🟢 1.15 MB (-9%)
00000005.sst gzip 2.8 MB 10.2 MB 🔴 +7.41 MB (+264%)
00000006.sst gzip 10.2 MB 2.8 MB 🟢 7.42 MB (-73%)
00000007.sst gzip 59 B 59 B
00000008.meta gzip 89 B 89 B
00000009.meta gzip 298 kB 298 kB
00000010.meta gzip 298 kB 298 kB
00000011.meta gzip 298 kB 298 kB
00000012.sst gzip 51.8 kB 52.3 kB 🔴 +566 B (+1%)
00000013.sst gzip 1.87 MB 1.85 MB 🟢 20.2 kB (-1%)
00000014.sst gzip 59 B 59 B
00000015.meta gzip 116 B 116 B
00000016.meta gzip 326 kB 326 kB
00000017.meta gzip 406 kB 405 kB
00000018.sst gzip 52.8 kB 53.2 kB
00000019.sst gzip 1.4 MB 1.42 MB 🔴 +13.5 kB (+1%)
00000020.sst gzip 59 B 59 B
00000021.meta gzip 116 B 116 B
00000022.meta gzip 326 kB 326 kB
00000023.meta gzip 372 kB 372 kB
00000024.sst gzip 52.8 kB 53.1 kB
00000025.sst gzip 1.4 MB 1.42 MB 🔴 +14.1 kB (+1%)
00000026.sst gzip 59 B 59 B
00000027.meta gzip 116 B 116 B
00000028.meta gzip 326 kB 326 kB
00000029.meta gzip 372 kB 372 kB
00000030.sst gzip 51.9 kB 52.5 kB 🔴 +579 B (+1%)
00000031.sst gzip 1.4 MB 1.42 MB 🔴 +14.1 kB (+1%)
00000032.sst gzip 59 B 59 B
00000033.meta gzip 116 B 116 B
00000034.meta gzip 326 kB 326 kB
00000035.meta gzip 372 kB 372 kB
00000036.sst gzip 52.6 kB 52.9 kB
00000037.sst gzip 1.4 MB 1.42 MB 🔴 +13.9 kB (+1%)
00000038.sst gzip 59 B 59 B
00000039.meta gzip 116 B 116 B
00000040.meta gzip 326 kB 326 kB
00000041.meta gzip 372 kB 372 kB
CURRENT gzip 94 B 94 B
LOG gzip 663 B 667 B
Total 80.5 MB 80.5 MB ⚠️ +15.1 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 65.5 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.67 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63.4 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 253 B 253 B
main-HASH.js gzip 40.1 kB 40.1 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 66.2 kB -
8590-HASH.js gzip N/A 5.61 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.4 kB -
Total 241 kB 242 kB ⚠️ +591 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 181 B 182 B
css-HASH.js gzip 334 B 331 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 255 B 253 B
head-HASH.js gzip 349 B 351 B
hooks-HASH.js gzip 382 B 384 B
image-HASH.js gzip 581 B 582 B
index-HASH.js gzip 260 B 259 B
link-HASH.js gzip 2.48 kB 2.48 kB
routerDirect..HASH.js gzip 317 B 318 B
script-HASH.js gzip 384 B 386 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.95 kB 7.96 kB ⚠️ +4 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 129 kB
page.js gzip 294 kB 294 kB
Total 423 kB 423 kB ✅ -80 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 620 B 617 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 45.9 kB 45.5 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 47.5 kB 47.1 kB ✅ -380 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 717 B 718 B
Total 717 B 718 B ⚠️ +1 B
Build Cache
Canary PR Change
0.pack gzip 4.85 MB 4.84 MB 🟢 7.36 kB (0%)
index.pack gzip 122 kB 122 kB
index.pack.old gzip 121 kB 122 kB
Total 5.09 MB 5.09 MB ✅ -6.84 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 375 kB 375 kB
app-page-exp..prod.js gzip 207 kB 207 kB
app-page-tur...dev.js gzip 374 kB 374 kB
app-page-tur..prod.js gzip 206 kB 206 kB
app-page-tur...dev.js gzip 371 kB 371 kB
app-page-tur..prod.js gzip 204 kB 204 kB
app-page.run...dev.js gzip 371 kB 371 kB
app-page.run..prod.js gzip 204 kB 204 kB
app-route-ex...dev.js gzip 82.9 kB 82.9 kB
app-route-ex..prod.js gzip 56.1 kB 56.1 kB
app-route-tu...dev.js gzip 83 kB 83 kB
app-route-tu..prod.js gzip 56.1 kB 56.1 kB
app-route-tu...dev.js gzip 82.5 kB 82.5 kB
app-route-tu..prod.js gzip 55.9 kB 55.9 kB
app-route.ru...dev.js gzip 82.5 kB 82.5 kB
app-route.ru..prod.js gzip 55.8 kB 55.8 kB
dev-validati...dev.js gzip 134 kB 134 kB
dev-validati...dev.js gzip 134 kB 134 kB
dev-validati...dev.js gzip 132 kB 132 kB
dev-validati...dev.js gzip 132 kB 132 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 46.4 kB 46.4 kB
pages-api-tu..prod.js gzip 34.6 kB 34.6 kB
pages-api.ru...dev.js gzip 46.4 kB 46.4 kB
pages-api.ru..prod.js gzip 34.5 kB 34.5 kB
pages-turbo....dev.js gzip 55.2 kB 55.2 kB
pages-turbo...prod.js gzip 40.1 kB 40.1 kB
pages.runtim...dev.js gzip 55.1 kB 55.1 kB
pages.runtim..prod.js gzip 40.1 kB 40.1 kB
server.runti..prod.js gzip 67.1 kB 67.1 kB
use-cache-pr...dev.js gzip 72.6 kB 72.6 kB
use-cache-pr...dev.js gzip 72.6 kB 72.6 kB
use-cache-pr...dev.js gzip 70.8 kB 70.8 kB
use-cache-pr...dev.js gzip 70.8 kB 70.8 kB
Total 4.11 MB 4.11 MB
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/dfef8c723bf7dcefc6b0fb0294c8483a205532f5/next

Commit: dfef8c7

@github-actions

github-actions Bot commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: dfef8c7

@datadog-official

This comment has been minimized.

@bgw

bgw commented Aug 24, 2026

Copy link
Copy Markdown
Member

I don't think this feature is important enough to justify maintaining a notify-rs backport, but we can upgrade the notify-rs crate as soon as there's a new version available (and I'm fine upgrading us to an 9.x release candidate).

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Turbopack: watchOptions.pollIntervalMs permanently drops file edits on Windows

2 participants