Skip to content

turbo-persistence: add key-value tombstones for MultiValue families - #96929

Draft
lukesandberg wants to merge 1 commit into
lukesandberg/gc-01-scope-self-feedingfrom
lukesandberg/gc-015-valued-tombstones
Draft

turbo-persistence: add key-value tombstones for MultiValue families#96929
lukesandberg wants to merge 1 commit into
lukesandberg/gc-01-scope-self-feedingfrom
lukesandberg/gc-015-valued-tombstones

Conversation

@lukesandberg

Copy link
Copy Markdown
Contributor

No description provided.

@github-actions

github-actions Bot commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 187f9dd

@github-actions

github-actions Bot commented Aug 7, 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) 812ms 811ms ▂▂▂▁█
Cold (Ready in log) 782ms 788ms ▁▂▂▁█
Cold (First Request) 1.275s 1.295s ▁▂▂▁█
Warm (Listen) 811ms 812ms ▁▂▁▁█
Warm (Ready in log) 770ms 791ms ▁▂▂▁█
Warm (First Request) 1.240s 1.306s ▁▃▃▁█
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 813ms 811ms █████
Cold (Ready in log) 779ms 776ms ▅▃▆▇▅
Cold (First Request) 3.298s 3.322s ▅▃▅▆▄
Warm (Listen) 813ms 813ms ▅▁▅▅▅
Warm (Ready in log) 776ms 784ms ▅▂▅▆▄
Warm (First Request) 3.318s 3.410s ▇▂▇▅▂

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.643s 5.645s ▂▂▂▁█
Cached Build 2.856s 2.912s ▂▂▄▁█
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.189s 24.122s ▄▂▅▇▂
Cached Build 24.483s 24.110s ▄▂▇▆▁
node_modules Size 553 MB 553 MB ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
07jdby0ue616s.js gzip 450 B N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0im0vz0lo815s.js gzip 8.77 kB N/A -
0mhgqgnwke2ly.js gzip 157 B N/A -
0rci1f3or1a19.js gzip 13.3 kB N/A -
0vvgkp57zpfgd.js gzip 159 B N/A -
133405p6ewydx.js gzip 10 kB N/A -
14cc00_n9zs8k.js gzip 156 B N/A -
17p50_vq5-xc5.js gzip 8.71 kB N/A -
19xzn89g-pvj8.js gzip 9.45 kB N/A -
1c1wxc9_-vy_e.js gzip 158 B N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1ey-k8tr3q-bs.js gzip 10.6 kB N/A -
1k4lgcmwwg4hq.js gzip 155 B N/A -
1t0gxseet6rkl.js gzip 158 B N/A -
1tf1phijqlx9j.js gzip 220 B 220 B
1wd1e9uuc4euy.js gzip 8.76 kB N/A -
1yxn3i6a40rcg.js gzip 157 B N/A -
2-w5wamautz2c.js gzip 65.6 kB N/A -
203768r3plkuz.js gzip 153 B N/A -
219oe54sobbj5.js gzip 8.81 kB N/A -
22alyybqz5_09.js gzip 3.57 kB N/A -
22wf46m76ktxw.js gzip 159 B N/A -
28p1njha-2ovo.js gzip 13.6 kB N/A -
2b-nvb0ybzif_.js gzip 8.7 kB N/A -
2j5mn0ng9x-8y.js gzip 71.5 kB N/A -
2n4u-h4qpegt-.js gzip 169 B N/A -
2oks0a7s7ajem.js gzip 10.3 kB N/A -
2ufosov1toup-.js gzip 157 B N/A -
31r35oy32u7ag.js gzip 46.7 kB N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3fw39x1tg924h.js gzip 8.79 kB N/A -
3kfiy2dr7a5m3.js gzip 5.72 kB N/A -
3l2c-qzlafpi-.js gzip 8.78 kB N/A -
3m64-4oqpxh9f.js gzip 157 B N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3rdf0zyd2dgxs.js gzip 8.76 kB N/A -
3tfvhhy7vbzhb.js gzip 157 B N/A -
41jfc8g2x7su6.js gzip 7.54 kB N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
turbopack-07..49nq.js gzip 3.87 kB N/A -
turbopack-0h..mzs8.js gzip 3.86 kB N/A -
turbopack-12..4sxb.js gzip 3.86 kB N/A -
turbopack-18..a0wp.js gzip 3.86 kB N/A -
turbopack-1k..sy8-.js gzip 3.86 kB N/A -
turbopack-1l..dz4k.js gzip 3.86 kB N/A -
turbopack-1v..vk8d.js gzip 3.86 kB N/A -
turbopack-2_..1f58.js gzip 3.86 kB N/A -
turbopack-29..7o98.js gzip 3.86 kB N/A -
turbopack-2d..r8zj.js gzip 3.84 kB N/A -
turbopack-2d..xiuu.js gzip 3.86 kB N/A -
turbopack-2j..stgx.js gzip 3.86 kB N/A -
turbopack-2p..4-e8.js gzip 3.86 kB N/A -
turbopack-3r..qqhu.js gzip 3.86 kB N/A -
0b3yd3wyn3bfz.js gzip N/A 155 B -
0b87lr4cig17b.js gzip N/A 8.75 kB -
0e1qkafcsotw-.js gzip N/A 8.7 kB -
0j64ls9v56hnd.js gzip N/A 3.56 kB -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0masaz6qt9sws.js gzip N/A 10 kB -
0n2f4y98eckf4.js gzip N/A 8.78 kB -
0r_tfwh185cwx.js gzip N/A 155 B -
1234ksg9gdne_.js gzip N/A 8.77 kB -
17oe55cu76cd7.js gzip N/A 450 B -
18ehgajg6-37l.js gzip N/A 46.7 kB -
1hi2ytaglt1ta.js gzip N/A 155 B -
1ko45a632uro6.js gzip N/A 8.79 kB -
1ovh5czvtp9dc.js gzip N/A 157 B -
1tn3m9f3j0cu6.js gzip N/A 152 B -
1u5hjpgv9qkjy.js gzip N/A 9.45 kB -
2d_wvcq8ytz-8.js gzip N/A 71.5 kB -
2dt81h56uyprs.js gzip N/A 8.75 kB -
2g2f64lmg3m7w.js gzip N/A 5.73 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
2uile-vrx5c0g.js gzip N/A 8.81 kB -
2xhyauod8lfuk.js gzip N/A 8.71 kB -
2z-2x1ptpwnb3.js gzip N/A 10.3 kB -
33mvbyt1q5m2m.js gzip N/A 156 B -
36lwn7padaock.js gzip N/A 65.6 kB -
3cqsjdnv36mdd.js gzip N/A 157 B -
3i1epwuzay7-v.js gzip N/A 154 B -
3l44kpbwzy-2x.js gzip N/A 154 B -
3oqnzh8zgdxwz.js gzip N/A 168 B -
3rodp-hyqw7n0.js gzip N/A 13.6 kB -
3t7v1ffjrnh9r.js gzip N/A 7.55 kB -
3tep4rtbo0q4_.js gzip N/A 159 B -
3wo9xxs3t0k6j.js gzip N/A 153 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
408odw3u2fa2k.js gzip N/A 151 B -
40fek9ngcsppd.js gzip N/A 10.6 kB -
turbopack-03..8ax0.js gzip N/A 3.86 kB -
turbopack-0c..kifv.js gzip N/A 3.84 kB -
turbopack-0c..ok82.js gzip N/A 3.86 kB -
turbopack-0i..7bx5.js gzip N/A 3.86 kB -
turbopack-0l..y18s.js gzip N/A 3.88 kB -
turbopack-0n..gnae.js gzip N/A 3.86 kB -
turbopack-1c..vddi.js gzip N/A 3.86 kB -
turbopack-1h..o38f.js gzip N/A 3.86 kB -
turbopack-1z..3wmx.js gzip N/A 3.86 kB -
turbopack-2r..3ggg.js gzip N/A 3.86 kB -
turbopack-2z..cfkn.js gzip N/A 3.86 kB -
turbopack-3i..ian3.js gzip N/A 3.86 kB -
turbopack-3j..toh0.js gzip N/A 3.86 kB -
turbopack-3l..yym7.js gzip N/A 3.86 kB -
Total 451 kB 451 kB ✅ -14 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 775 B 778 B
Total 775 B 778 B ⚠️ +3 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 434 B 431 B
Total 434 B 431 B ✅ -3 B
Build Cache
Canary PR Change
00000001.sst gzip 13 MB 15.2 MB 🔴 +2.15 MB (+17%)
00000002.sst gzip 14.5 MB 14.7 MB 🔴 +201 kB (+1%)
00000003.sst gzip 13.2 MB 12 MB 🟢 1.14 MB (-9%)
00000004.sst gzip 14.4 MB 13.3 MB 🟢 1.13 MB (-8%)
00000005.sst gzip 2.81 MB 2.81 MB
00000006.sst gzip 10.2 MB 10.2 MB
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.5 kB 50.6 kB 🟢 947 B (-2%)
00000013.sst gzip 1.87 MB 1.87 MB 🟢 2.59 kB (0%)
00000014.sst gzip 59 B 59 B
00000015.meta gzip 116 B 116 B
00000016.meta gzip 325 kB 326 kB
00000017.meta gzip 405 kB 406 kB
00000018.sst gzip 52.2 kB 51.2 kB 🟢 1.02 kB (-2%)
00000019.sst gzip 1.36 MB 1.38 MB 🔴 +20.3 kB (+1%)
00000020.sst gzip 59 B 59 B
00000021.meta gzip 116 B 116 B
00000022.meta gzip 325 kB 326 kB
00000023.meta gzip 371 kB 371 kB
00000024.sst gzip 52.4 kB 51.3 kB 🟢 1.03 kB (-2%)
00000025.sst gzip 1.36 MB 1.38 MB 🔴 +19.8 kB (+1%)
00000026.sst gzip 59 B 59 B
00000027.meta gzip 116 B 116 B
00000028.meta gzip 325 kB 326 kB
00000029.meta gzip 371 kB 371 kB
00000030.sst gzip 51.7 kB 50.6 kB 🟢 1.12 kB (-2%)
00000031.sst gzip 1.36 MB 1.38 MB 🔴 +19.7 kB (+1%)
00000032.sst gzip 59 B 59 B
00000033.meta gzip 116 B 116 B
00000034.meta gzip 325 kB 326 kB
00000035.meta gzip 371 kB 371 kB
00000036.sst gzip 52.3 kB 51.1 kB 🟢 1.2 kB (-2%)
00000037.sst gzip 1.36 MB 1.38 MB 🔴 +19.7 kB (+1%)
00000038.sst gzip 59 B 59 B
00000039.meta gzip 116 B 116 B
00000040.meta gzip 325 kB 326 kB
00000041.meta gzip 371 kB 371 kB
CURRENT gzip 24 B 24 B
LOG gzip 679 B 666 B 🟢 13 B (-2%)
Total 80.1 MB 80.3 MB ⚠️ +155 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 65.7 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.2 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 253 B 252 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.4 kB -
8590-HASH.js gzip N/A 5.6 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.2 kB -
Total 241 kB 242 kB ⚠️ +651 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.95 kB ⚠️ +1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 128 kB
page.js gzip 294 kB 295 kB
Total 423 kB 423 kB ⚠️ +678 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 616 B 618 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 45.4 kB 45.2 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 47.1 kB 46.8 kB ✅ -253 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 718 B 718 B
Total 718 B 718 B
Build Cache
Canary PR Change
0.pack gzip 4.8 MB 4.79 MB 🟢 6.01 kB (0%)
index.pack gzip 123 kB 123 kB
index.pack.old gzip 123 kB 123 kB
Total 5.05 MB 5.04 MB ✅ -6.1 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 207 kB 207 kB
app-page-tur...dev.js gzip 370 kB 370 kB
app-page-tur..prod.js gzip 205 kB 205 kB
app-page.run...dev.js gzip 371 kB 371 kB
app-page.run..prod.js gzip 205 kB 205 kB
app-route-ex...dev.js gzip 83.3 kB 83.3 kB
app-route-ex..prod.js gzip 56.4 kB 56.4 kB
app-route-tu...dev.js gzip 83.3 kB 83.3 kB
app-route-tu..prod.js gzip 56.4 kB 56.4 kB
app-route-tu...dev.js gzip 82.9 kB 82.9 kB
app-route-tu..prod.js gzip 56.2 kB 56.2 kB
app-route.ru...dev.js gzip 82.8 kB 82.8 kB
app-route.ru..prod.js gzip 56.2 kB 56.2 kB
dev-validati...dev.js gzip 133 kB 133 kB
dev-validati...dev.js gzip 133 kB 133 kB
dev-validati...dev.js gzip 131 kB 131 kB
dev-validati...dev.js gzip 131 kB 131 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 kB 46 kB
pages-api-tu..prod.js gzip 34.3 kB 34.3 kB
pages-api.ru...dev.js gzip 46 kB 46 kB
pages-api.ru..prod.js gzip 34.3 kB 34.3 kB
pages-turbo....dev.js gzip 54.8 kB 54.8 kB
pages-turbo...prod.js gzip 39.9 kB 39.9 kB
pages.runtim...dev.js gzip 54.8 kB 54.8 kB
pages.runtim..prod.js gzip 39.9 kB 39.9 kB
server.runti..prod.js gzip 67 kB 67 kB
use-cache-pr...dev.js gzip 72.3 kB 72.3 kB
use-cache-pr...dev.js gzip 72.4 kB 72.4 kB
use-cache-pr...dev.js gzip 70.6 kB 70.6 kB
use-cache-pr...dev.js gzip 70.6 kB 70.6 kB
Total 4.1 MB 4.1 MB
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/187f9dd53fead6388272e816dc990ba46c50f730/next

Commit: 187f9dd

@lukesandberg
lukesandberg force-pushed the lukesandberg/gc-015-valued-tombstones branch 2 times, most recently from d1c86a5 to 846b01e Compare August 7, 2026 19:03
.map(|&i| ssts_with_ranges[i].seq)
.min()
.unwrap_or(0);
let older_filters = ssts_with_ranges

@vercel vercel Bot Aug 7, 2026

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.

During compaction, tombstone_is_dead uses a seq < min(job seq) cut that can drop a still-needed key/key-value tombstone while an intervening overlapping SST outside the merge job still holds the deleted value, resurrecting it on lookup.

Fix on Vercel

Removing one value from a MultiValue key currently requires a
read-modify-write: `delete` tombstones the whole hash bucket, so the caller
must first read the bucket back and re-insert every surviving value. At GC
scale that is one synchronous bucket read per deleted key.

Add `WriteBatch::delete_value`, which writes a tombstone carrying the value
being deleted. The delete is optimistic: nothing is read at write time, and
the tombstone is applied lazily by reads and by compaction. Deleting N pairs
costs N buffered writes instead of N read-modify-write cycles.

The two tombstone kinds now sit at opposite ends of a key group. Key-value
tombstones sort first, so a reader collects them on entering the group and
filters the values that follow in one forward pass. Key tombstones keep
sorting last, because they mean "everything older than me is gone" including
same-SST entries: a batch doing `put(A); delete; put(B)` must still keep A
and B while shadowing older SSTs.

Knowing when a tombstone can be dropped was already an unsolved problem for
key tombstones -- today they are simply kept forever -- and key-value
tombstones inherit it. Rather than require a full-family rewrite to prove no
older layer holds the key, compaction now probes the AMQF filters of the SSTs
older than the job. The filter's error is one-sided (`false` means definitely
absent), so a false positive only retains a tombstone for another round and
the resurrection direction is unreachable. Filters are already resident and
range-pruned, so this is in-memory work on the entries that need it.

This reclaims tombstones incrementally, with no full-compaction cycle, no new
metadata, and no unchecked caller obligation. Only SSTs older than the whole
job are consulted: within the job, MergeIter already yields newest-first and
drops the older values a tombstone shadows. It applies to both kinds, so key
tombstones become reclaimable too.

The on-disk format is unchanged apart from the new key-value tombstone entry
type, which takes a previously unused tag, so existing databases stay
readable.
@lukesandberg
lukesandberg force-pushed the lukesandberg/gc-015-valued-tombstones branch from 846b01e to 187f9dd Compare August 7, 2026 20:28
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