Skip to content

turbo-tasks-backend: add TaskAccess (MaybeCreate/MustExist) to task lookups#96043

Draft
lukesandberg wants to merge 1 commit into
lukesandberg/gc-02-tombstone-plumbingfrom
lukesandberg/gc-025-task-access
Draft

turbo-tasks-backend: add TaskAccess (MaybeCreate/MustExist) to task lookups#96043
lukesandberg wants to merge 1 commit into
lukesandberg/gc-02-tombstone-plumbingfrom
lukesandberg/gc-025-task-access

Conversation

@lukesandberg

@lukesandberg lukesandberg commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Annotate each task access with an assertion whether or not we allow a task to be created

…ookups

Replace the implicit create-on-miss behavior of ExecuteContext::task with an
explicit TaskAccess argument so every call site declares intent:

- MaybeCreate: open-or-create (today's behavior) — creation and edge-follows.
- MustExist: the task must already exist (resident or on disk); fabricating a
  blank for a nonexistent task is a bug. The existence check is debug-only for
  now (panics in debug, falls back to create in release) and will be promoted
  once the call-site classification is proven.

lookup_data now reports DB-key presence and restore_task_data threads it through
so a MustExist open can refuse to fabricate. task_pair also takes TaskAccess.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: ee0a2e0

@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Stats from current PR

Warning

No stats were collected for Webpack because its stats job did not complete (it failed, was cancelled, or timed out). The results below only cover the bundlers that finished.

🟢 1 improvement

Metric Canary PR Change Trend
node_modules Size 527 MB 516 MB 🟢 11.2 MB (-2%) █████
📊 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) 810ms 811ms ▇▂▁▂▂
Cold (Ready in log) 767ms 770ms █▁▁▁▁
Cold (First Request) 1.288s 1.281s ▇▁▁▁▁
Warm (Listen) 811ms 809ms ▇▂▂▂▁
Warm (Ready in log) 771ms 768ms ▇▁▁▁▁
Warm (First Request) 1.263s 1.274s ▇▂▁▁▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.988s 4.911s ▇▃▂▁▁
Cached Build 5.057s 5.048s ▇▃▁▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
node_modules Size 527 MB 516 MB 🟢 11.2 MB (-2%) █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
03gmyxr7dukvs.js gzip 10.3 kB N/A -
040t1q17lo593.js gzip 8.77 kB N/A -
0bb0vtp8dwsez.js gzip 450 B N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0l0sr6gau5xjn.js gzip 3.53 kB N/A -
0nst2xc-t0y6v.js gzip 160 B N/A -
0nxqz3q165m2l.js gzip 220 B N/A -
0qr-1tnb7_hg5.js gzip 5.72 kB N/A -
0qtrl0m2m47zb.js gzip 155 B N/A -
0uilzvklme4ea.js gzip 8.76 kB N/A -
0z0y83mfx-l-h.js gzip 10 kB N/A -
1_dj4hrtb4p26.js gzip 7.4 kB N/A -
15ok8ydf274z0.js gzip 10.6 kB N/A -
16cqqcigykfea.js gzip 13.6 kB N/A -
17h18zxt1915l.js gzip 1.46 kB N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1fq1h7dxad4cv.js gzip 9.44 kB N/A -
1fym-adbk_69_.js gzip 13.1 kB N/A -
1gav7nfh4y8ln.js gzip 8.76 kB N/A -
1o34vh44ndvtu.js gzip 13.2 kB N/A -
2-u463-ditelp.js gzip 156 B N/A -
23rhpy3kbs-7u.js gzip 65.6 kB N/A -
2dvqqp3zqpnnq.js gzip 160 B N/A -
2guls-_0xkbp2.js gzip 153 B N/A -
2lcep9_t56iw5.js gzip 166 B N/A -
2rypqffktcxqh.js gzip 8.69 kB N/A -
2uqsizxtehgqf.js gzip 8.79 kB N/A -
2vzktdqwbijqc.js gzip 8.74 kB N/A -
2ydpbosxm0bih.js gzip 156 B N/A -
2zezpu-768ip-.js gzip 155 B N/A -
3_4kzn9ufgy-9.js gzip 45.2 kB N/A -
32874-2qs3sy7.js gzip 155 B N/A -
3a80mp1w6p7__.js gzip 153 B N/A -
3c244akvx_-be.js gzip 8.74 kB N/A -
3dmlemitx3ef3.js gzip 2.29 kB N/A -
3eqn7bfc1f1vc.js gzip 71.1 kB N/A -
3i1ah-rd8gyl6.js gzip 156 B N/A -
3kxmazxf0zw6v.js gzip 156 B N/A -
3za9ke3-tiboq.js gzip 153 B N/A -
4237vdj6eyslt.js gzip 8.7 kB N/A -
turbopack-0q..obj3.js gzip 3.8 kB N/A -
turbopack-0s..e00r.js gzip 3.79 kB N/A -
turbopack-10..kg69.js gzip 3.8 kB N/A -
turbopack-13..bkpr.js gzip 3.8 kB N/A -
turbopack-15..07mf.js gzip 3.8 kB N/A -
turbopack-1c..8d9x.js gzip 3.8 kB N/A -
turbopack-1g..5cux.js gzip 3.8 kB N/A -
turbopack-1i..0hfx.js gzip 3.8 kB N/A -
turbopack-20..mf5k.js gzip 3.8 kB N/A -
turbopack-2l..5n26.js gzip 3.8 kB N/A -
turbopack-2y..j_7q.js gzip 3.8 kB N/A -
turbopack-31..2tc1.js gzip 3.82 kB N/A -
turbopack-3f..g_b7.js gzip 3.8 kB N/A -
turbopack-3r..ik36.js gzip 3.8 kB N/A -
0_brf1o8xtfgw.js gzip N/A 156 B -
00tc16j5-eos9.js gzip N/A 1.46 kB -
0gaw1gmpwuwkn.js gzip N/A 8.8 kB -
0lfd6n4hnvfus.js gzip N/A 156 B -
0mwo2e6a43qd6.js gzip N/A 154 B -
0oxxm8ra6x40w.js gzip N/A 155 B -
12zyjjmq4oad1.js gzip N/A 5.72 kB -
1b_5lm2rb0cxg.js gzip N/A 65.6 kB -
1k9cc4-gpa2cx.js gzip N/A 13.1 kB -
1kfiwrcr725kl.js gzip N/A 13.2 kB -
1n59uogejo81s.js gzip N/A 10.3 kB -
1npei3hlexdv3.js gzip N/A 9.99 kB -
1q-0qyccjh4q3.js gzip N/A 158 B -
1ssuiwj_rnpc5.js gzip N/A 8.77 kB -
2-phc9obd3nyd.js gzip N/A 8.77 kB -
20z9kb96_57f4.js gzip N/A 164 B -
24utq57r3l1cw.js gzip N/A 8.7 kB -
29tie9lu2une4.js gzip N/A 71 kB -
2aw0kxkhyra0_.js gzip N/A 153 B -
2eemzo7z71a10.js gzip N/A 154 B -
2fhjq6ek3srmr.js gzip N/A 8.69 kB -
2g0t7upz_v-hf.js gzip N/A 10.6 kB -
2ia9qqy99aie9.js gzip N/A 13.6 kB -
2n5fp99a5xt9s.js gzip N/A 7.4 kB -
2oza28kdqvoay.js gzip N/A 8.74 kB -
2s1ku9sx60j5g.js gzip N/A 155 B -
2smk18o7qzte6.js gzip N/A 154 B -
2zh8-mmhujy8o.js gzip N/A 2.29 kB -
30h_m0irj-q6p.js gzip N/A 221 B -
37ejbfx1u9lpo.js gzip N/A 8.75 kB -
38c63ct4i1cy7.js gzip N/A 449 B -
38pfb-vjc58zl.js gzip N/A 160 B -
3jimpal3lvz5e.js gzip N/A 9.44 kB -
3q86bccmeq9ht.js gzip N/A 45.1 kB -
3su6a4l8jbfth.js gzip N/A 3.53 kB -
3vp18tbs9ie7b.js gzip N/A 156 B -
3wb4pe4z4-aim.js gzip N/A 8.77 kB -
43cuc9gzge2dj.js gzip N/A 151 B -
turbopack-0c..ceu6.js gzip N/A 3.76 kB -
turbopack-0r..o21k.js gzip N/A 3.77 kB -
turbopack-0v..6n4f.js gzip N/A 3.78 kB -
turbopack-12..bfke.js gzip N/A 3.77 kB -
turbopack-1a..ll78.js gzip N/A 3.77 kB -
turbopack-1j..lqtq.js gzip N/A 3.77 kB -
turbopack-1v..tzol.js gzip N/A 3.79 kB -
turbopack-1x..lsi3.js gzip N/A 3.78 kB -
turbopack-2i..bzur.js gzip N/A 3.77 kB -
turbopack-3_..wlef.js gzip N/A 3.77 kB -
turbopack-3-..hdvm.js gzip N/A 3.77 kB -
turbopack-3l..eco6.js gzip N/A 3.77 kB -
turbopack-3m..txtb.js gzip N/A 3.77 kB -
turbopack-3w..c3ex.js gzip N/A 3.78 kB -
Total 448 kB 447 kB ✅ -421 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 778 B 749 B 🟢 29 B (-4%)
Total 778 B 749 B ✅ -29 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 427 B 436 B 🔴 +9 B (+2%)
Total 427 B 436 B ⚠️ +9 B

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 366 kB 364 kB
app-page-exp..prod.js gzip 202 kB 201 kB
app-page-tur...dev.js gzip 365 kB 363 kB
app-page-tur..prod.js gzip 202 kB 201 kB
app-page-tur...dev.js gzip 362 kB 360 kB
app-page-tur..prod.js gzip 200 kB 199 kB
app-page.run...dev.js gzip 362 kB 360 kB
app-page.run..prod.js gzip 200 kB 199 kB
app-route-ex...dev.js gzip 81.7 kB 81.5 kB
app-route-ex..prod.js gzip 55.6 kB 55.4 kB
app-route-tu...dev.js gzip 81.8 kB 81.5 kB
app-route-tu..prod.js gzip 55.6 kB 55.4 kB
app-route-tu...dev.js gzip 81.4 kB 81.1 kB
app-route-tu..prod.js gzip 55.4 kB 55.1 kB
app-route.ru...dev.js gzip 81.3 kB 81.1 kB
app-route.ru..prod.js gzip 55.3 kB 55.1 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 45.4 kB 45.2 kB
pages-api-tu..prod.js gzip 34.1 kB 33.9 kB
pages-api.ru...dev.js gzip 45.4 kB 45.2 kB
pages-api.ru..prod.js gzip 34.1 kB 33.9 kB
pages-turbo....dev.js gzip 54.9 kB 54.6 kB
pages-turbo...prod.js gzip 39.7 kB 39.6 kB
pages.runtim...dev.js gzip 54.8 kB 54.6 kB
pages.runtim..prod.js gzip 39.7 kB 39.5 kB
server.runti..prod.js gzip 67.8 kB 67.5 kB
use-cache-pr...dev.js gzip 71.6 kB 71.4 kB
use-cache-pr...dev.js gzip 71.6 kB 71.4 kB
use-cache-pr...dev.js gzip 69.9 kB 69.7 kB
use-cache-pr...dev.js gzip 69.9 kB 69.7 kB
Total 3.51 MB 3.49 MB ✅ -15.6 kB
📝 Changed Files (29 files)

Files with changes:

  • app-page-exp..ntime.dev.js
  • app-page-exp..time.prod.js
  • app-page-tur..ntime.dev.js
  • app-page-tur..time.prod.js
  • app-page-tur..ntime.dev.js
  • app-page-tur..time.prod.js
  • app-page.runtime.dev.js
  • app-page.runtime.prod.js
  • app-route-ex..ntime.dev.js
  • app-route-ex..time.prod.js
  • app-route-tu..ntime.dev.js
  • app-route-tu..time.prod.js
  • app-route-tu..ntime.dev.js
  • app-route-tu..time.prod.js
  • app-route.runtime.dev.js
  • app-route.ru..time.prod.js
  • pages-api-tu..ntime.dev.js
  • pages-api-tu..time.prod.js
  • pages-api.runtime.dev.js
  • pages-api.ru..time.prod.js
  • ... and 9 more
View diffs
app-page-exp..ntime.dev.js
failed to diff
app-page-exp..time.prod.js
failed to diff
app-page-tur..ntime.dev.js
failed to diff
app-page-tur..time.prod.js
failed to diff
app-page-tur..ntime.dev.js
failed to diff
app-page-tur..time.prod.js
failed to diff
app-page.runtime.dev.js
failed to diff
app-page.runtime.prod.js
failed to diff
app-route-ex..ntime.dev.js

Diff too large to display

app-route-ex..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route.runtime.dev.js

Diff too large to display

app-route.ru..time.prod.js

Diff too large to display

pages-api-tu..ntime.dev.js

Diff too large to display

pages-api-tu..time.prod.js

Diff too large to display

pages-api.runtime.dev.js

Diff too large to display

pages-api.ru..time.prod.js

Diff too large to display

pages-turbo...ntime.dev.js

Diff too large to display

pages-turbo...time.prod.js

Diff too large to display

pages.runtime.dev.js

Diff too large to display

pages.runtime.prod.js

Diff too large to display

server.runtime.prod.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/ee0a2e057574e79dfc648fa54008a5cafc109586/next

Commit: ee0a2e0

category: TaskDataCategory,
access: TaskAccess,
) -> (Self::TaskGuardImpl, Self::TaskGuardImpl) {
// `access` is consumed by the GC layer above this branch

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

task_pair discards its TaskAccess parameter with a comment referencing a non-existent "GC layer", so the debug-only MustExist existence check that open performs is silently not applied to the two-task locking path.

Fix on Vercel

let task_id = chain.last().unwrap();
let error = {
let task = ctx.task(*task_id, TaskDataCategory::Meta);
let task = ctx.task(*task_id, TaskDataCategory::Meta, TaskAccess::MaybeCreate);

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be MustExist, we a recovering an error referencing a task id for a task that previously failed

Comment on lines 649 to +656

for (child_task_id, count) in children {
let task_description = ctx
.task(child_task_id, TaskDataCategory::Data)
.task(
child_task_id,
TaskDataCategory::Data,
TaskAccess::MaybeCreate,
)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Re: lines +594 to +656]

these two should be MustExist

See this comment inline on Graphite.

let dependent = ctx.task(
dependent_task_id,
TaskDataCategory::All,
TaskAccess::MaybeCreate,

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dependents must exist

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.

1 participant