Skip to content

docs: Update Geistdocs to 1.20.4 - #3654

Merged
VaguelySerious merged 1 commit into
mainfrom
richard/update-geistdocs-1.20.4
Aug 21, 2026
Merged

docs: Update Geistdocs to 1.20.4#3654
VaguelySerious merged 1 commit into
mainfrom
richard/update-geistdocs-1.20.4

Conversation

@molebox

Copy link
Copy Markdown
Contributor

Updates Geistdocs so link-preview bots receive HTML and preserve rich unfurls instead of being served Markdown.

@molebox
molebox requested review from a team, fantix and msullivan as code ownersAugust 19, 2026 13:38
@changeset-bot

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: f79ea80

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel

vercelBot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
example-nextjs-workflow-turbopackReadyReadyPreviewAug 19, 2026 1:38pm
example-nextjs-workflow-webpackReadyReadyPreviewAug 19, 2026 1:38pm
example-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-astro-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-express-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-fastify-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-hono-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-nestjs-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-nitro-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-nuxt-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-python-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-sveltekit-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-tanstack-start-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workbench-vite-workflowReadyReadyPreviewAug 19, 2026 1:38pm
workflow-swc-playgroundReadyReadyPreviewAug 19, 2026 1:38pm
workflow-tarballsReadyReadyPreviewAug 19, 2026 1:38pm
workflow-webReadyReadyPreviewAug 19, 2026 1:38pm

@github-actions

github-actionsBot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

📊 Workflow Benchmarks

commit f79ea80 · Wed, 19 Aug 2026 13:57:19 GMT · run logs

Backend: vercel · app: nextjs-turbopack

MetricScenarioBest (ms)P75 (ms)P90 (ms)P99 (ms)Samples
TTFSstep1272 (+27%) 🔻1380 🔴 (+24%) 🔻1398 🔴 (+23%) 🔻1641 🔴 (+38%) 🔻30
TTFSstream297 (+34%) 🔻1370 🔴 (+28%) 🔻1391 🔴 (+23%) 🔻1446 🔴 (-80%) 💚30
TTFShook + stream1556 (+198%) 🔻1661 🔴 (+16%) 🔻1715 🔴 (+8.8%)1965 🔴 (-69%) 💚30
Fan-out TTFSPromise.all(100 steps)1089 (-8.7%)2471 (+34%) 🔻2562 (+0.9%)3092 (+18%) 🔻10
Fan-out TTLSPromise.all(100 steps)5013 (-5.0%)6371 (-35%) 💚9050 (-20%) 💚15442 (+25%) 🔻10
STSO1020 steps (inline)124 (+6.9%)229 (-11%)252 (-18%) 💚309 (-27%) 💚1019
WO1020 steps215821 (-11%)215821 (-11%)215821 (-11%)215821 (-11%)1
CRTTfirst chunk (pooled)82 (-22%) 💚111 (-31%) 💚125 (-70%) 💚138 (-82%) 💚28

Streams

Scenariowr c/srd c/swr KiB/srd KiB/sCRTT 1stp75p90p99CDV maxiters
paced control (100/s, 60B)100 (±0%)100 (-1%)5 (±0%)5 (-1%)95.5 (-32%)132 (-37%)200 (-57%)621 (-17%)116 (-16%)10
size sweep (100/s, 160B-12KB)100 (±0%)100 (±0%)334 (±0%)335 (±0%)94.5 (-35%)113 (-44%)151 (-73%)670 (-15%)92 (-50%)10
replay gateway-gpt-5.4-nano-2000t (1x)89.2 (±0%)89.1 (±0%)16.2 (±0%)16.2 (-1%)110 (-30%)363 (+116%)2820 (+837%)4431 (+788%)374 (+39%)3
replay eve-gpt-5.6-sol-2000t (1x)54.7 (±0%)54.7 (±0%)355 (±0%)355 (±0%)93.5 (-66%)107 (-26%)133 (-28%)662 (+103%)412 (+36%)2
replay eve-gpt-5.6-sol-2000t (2x)109 (±0%)109 (±0%)710 (±0%)709 (±0%)108 (-8%)151 (-24%)269 (+1%)685 (+9%)602 (+30%)3
📈 STSO distribution vs main (inline / queue-hop histograms)

1020 steps (inline)

Cumulative STSO time: main 240925ms → this run 215657ms (Δ -25268ms, -10%)

100-150 ms ┃ main 9 this 26 +17
150-200 ms ██████████░░░░░░┃ main 225 this 366 +141
200-250 ms ██████████████████████░┃ main 484 this 518 +34
250-300 ms ███┃█████ main 184 this 88 -96
300-350 ms ┃███ main 78 this 17 -61
350-400 ms ┃ main 25 this 3 -22
400-450 ms ┃ main 8 this 0 -8
450-500 ms ┃ main 1 this 0 -1
500-550 ms ┃ main 0 this 1 +1
550-600 ms ┃ main 2 this 0 -2
600-650 ms ┃ main 2 this 0 -2
650-700 ms ┃ main 1 this 0 -1
📈 CRTT drill-down vs main (RTT distributions & profiles)
variant RTT 1ms→5s+ avg p50 p90 p99 n
control ······█▇▁▁··· 111.6 (-32%) 101 (-22%) 200 (-57%) 621 (-17%) 3000
sweep ······█▅▁▁··· 106.4 (-38%) 93 (-29%) 151 (-73%) 670 (-15%) 3000
gw 1x ·····▁█▄▁▁▁▁· 290.2 (+110%) 93 (-24%) 2820 (+837%) 4431 (+788%) 5295
eve 1x ·····▁█▅▁▁··· 96.7 (-21%) 86 (-23%) 133 (-28%) 662 (+103%) 5186
eve 2x ·····▁██▂▁··· 125.8 (-24%) 104 (-29%) 269 (+1%) 685 (+9%) 7779

RTT over stream progress (avg per tenth of stream, bars scaled min→max):

control █▇▂▁▂▃▂▂▃▃ 94–146ms
sweep █▂▁▂▁▄█▄▁▁ 92–136ms
gw 1x ▁▁▁▁▁▁█▆▂▁ 89–1148ms
eve 1x █▁▃▂▁▁▃▄▂▁ 84–141ms
eve 2x ▆▁▂▂▁▃▃█▃▄ 93–195ms

RTT by chunk size (avg per log size bin, ~160B → ~12KB serialized, bars scaled min→max):

sweep ██▆▃▁▁▁ 104–109ms

Delivery jitter over stream progress (avg positive CDV per tenth of stream, bars scaled min→max):

control ▇▂▅▃▇▄▁▃█▄ 25–36ms
sweep ▂▃▃▄▄█▃▃▂▁ 32–53ms
gw 1x ▁▁▂▁▂▁█▁▂▁ 24–77ms
eve 1x █▂▃▁▄▂▅▁▂▁ 19–24ms
eve 2x █▂▁▂▂▅▅▆▂▇ 16–25ms
ℹ️ Metric definitions & methodology

Streams: writer/reader sustained rates (steady window, 10% trimmed each side), first-chunk RTT (the stream-open path, before any buffering/backpressure), CRTT percentiles, and worst delivery stall (CDV max). Cells are medians across iterations; per-run values in the artifacts. No 🔴/🟢 marks until targets attach.

The collapsed STSO distribution section above buckets every step gap, split inline (same warm process — pure framework overhead) vs queue-hop (fresh process — dispatch, reinit, replay). = main, = this run, = fill.

The collapsed CRTT drill-down: per-variant RTT histograms (fixed log bins, · = empty) and mean RTT/positive-CDV profile lines over stream progress and chunk size. Histograms, avgs, and profiles merge exactly across runs; p50–p99 are percentile-of-percentiles. Per-index rows live in the artifacts.

Best/P75/P90/P99 deltas compare against the most recent benchmark run on main at the time of this run. 🔻 flags a delta worse than +15%, 💚 one better than −15%.

Metrics — TTFS: time to first step body (in-deployment start() → first step body) · Fan-out TTFS: fan-out time to first step (in-deployment start() → first of the parallel step bodies to complete) · Fan-out TTLS: fan-out time to last step (in-deployment start() → last of the parallel step bodies to complete, i.e. when the Promise.all resolves) · STSO: step-to-step overhead (gap between consecutive step bodies) · WO: workflow overhead (whole-run time outside step bodies, in-deployment anchored) · CRTT: chunk round-trip time (per-chunk write → read latency, one clock domain: deployment → stream backend → same deployment) · CDV: chunk delay variation / delivery jitter (inter-arrival gap minus inter-write gap per seq-adjacent pair; skew-free; the row is each run's MAX positive value, so one stall moves it)

Scenarios — step: one trivial no-op step, no stream; no hooks, so the run stays in turbo mode (in-process fast path) · stream: one streaming step; no hooks, so the run stays in turbo mode (in-process fast path) · hook + stream: registers a hook before one step, which exits turbo mode (dispatch path) · 1020 steps: 1020 trivial sequential steps; STSO is measured between consecutive steps in the given step ranges, and WO is the whole-run overhead outside step bodies · Promise.all(100 steps): 100 trivial no-op steps started together in a single Promise.all; Fan-out TTFS is the first of them to complete and Fan-out TTLS the last, both from the in-deployment clientStart, so their gap is the spread the runtime adds across the fan-out · paced control (100/s, 60B): the control: 300 tiny (~60B) deltas metronome-paced at 100/s — zero workload structure, so it reads the transport floor and flush cadence, and disambiguates transport-wide vs workload-specific when a replay row moves · size sweep (100/s, 160B-12KB): same pacing as the control with deltas padded in rotation across seven log-spaced sizes (~160B–12KB) — rotation decouples size from stream position, so it isolates whether chunk size causes latency · replay gateway-gpt-5.4-nano-2000t (1x): raw provider SSE cadence captured at the AI gateway boundary (gpt-5.4-nano, the most popular gateway model; per-token deltas p50 208B = the modal production chunk size), replayed exactly as measured — the typical customer's workload; its CDV is the typical customer's real delivery jitter · replay eve-gpt-5.6-sol-2000t (1x): a captured eve turn (gpt-5.6-sol, the most-used demanding eve model; ~2000 output tokens = production p50 turn length) replayed exactly as measured — eve's envelope protocol re-ships the cumulative message so sizes ramp 142B→13KB; the demanding outlier tenant's reality · replay eve-gpt-5.6-sol-2000t (2x): the same eve capture at 2x — the headroom/stress row; real fast-tier models emit the same chunk sizes at proportionally higher rate, so time compression is a faithful speed model · first chunk (pooled): every run's seq-0 RTT pooled across all stream scenarios — the first chunk precedes any workload differentiation, so pooling samples one shared stream-open path with exact percentiles

Replay cadences (semantic sha256) — eve-gpt-5.6-sol-2000teaf22f5946e7c61f3c65c7006d550df180cfabd4e706254a09f22aec0cfb420d · gateway-gpt-5.4-nano-2000t6f24ac518b6b83ff1d0e85a5fe78230db192716d66a7fc6b2fe022752001d041

🔴 marks a percentile over its target (within target is left unmarked). Targets (p75/p90/p99, ms) — TTFS 200/300/600

All timestamps are deployment-side; runs are triggered in-deployment, so the CI runner and api.vercel.com sit outside every measured window. TTFS = start() → first step body (includes dispatch + any cold start); Fan-out TTFS/TTLS = first/last step completion of one Promise.all from the same anchor (the gap is the runtime’s fan-out spread); STSO/WO between step bodies; CRTT inside the workflow (excludes the api.vercel.com read path).

Cold starts stay in the numbers (real bursty-workload latency, inflates P75+); Best is the warm floor.

@github-actions

github-actionsBot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

🧪 E2E Test Results

All tests passed

🛠 Infra Events (absorbed by the harness)

Platform anomalies the e2e harness detected and worked around (e.g. a run the queue never picked up, replaced by a fresh run). Clustered timestamps indicate a backend blip; a steady drip indicates a platform issue worth escalating.

  • cold-start-warmup · suite warmup (tanstack-start) · at 13:42:45Z · abandoned wrun_01M0D449TD00FKYC73A0MWF0AK

E2E Test Summary

Summary
PassedFailedSkippedTotal
✅ ▲ Vercel Production347407384212
✅ 💻 Local Development381005584368
✅ 📦 Local Production381005584368
✅ 🐘 Local Postgres381005584368
✅ 🪟 Windows31200312
✅ 🌐 Cross-language Conformance90128137
✅ vercel-multi-region270027
Total152520254017792
Details by Category

✅ ▲ Vercel Production

AppPassedFailedSkipped
✅ astro-node128028
✅ astro-quickjs128028
✅ example-node128028
✅ example-quickjs128028
✅ express-node128028
✅ express-quickjs128028
✅ fastify-node128028
✅ fastify-quickjs128028
✅ hono-node128028
✅ hono-quickjs128028
✅ nest-node128028
✅ nest-quickjs128028
✅ nextjs-turbopack-node15303
✅ nextjs-turbopack-quickjs15303
✅ nextjs-webpack-node15303
✅ nextjs-webpack-quickjs15303
✅ nitro-node128028
✅ nitro-quickjs128028
✅ nuxt-node128028
✅ nuxt-quickjs128028
✅ python-node80148
✅ sveltekit-node14709
✅ sveltekit-quickjs14709
✅ tanstack-start-node128028
✅ tanstack-start-quickjs128028
✅ vite-node128028
✅ vite-quickjs128028

✅ 💻 Local Development

AppPassedFailedSkipped
✅ astro-stable-node130026
✅ astro-stable-quickjs130026
✅ express-stable-node130026
✅ express-stable-quickjs130026
✅ fastify-stable-node130026
✅ fastify-stable-quickjs130026
✅ hono-stable-node130026
✅ hono-stable-quickjs130026
✅ nest-stable-node130026
✅ nest-stable-quickjs130026
✅ nextjs-turbopack-canary-node137019
✅ nextjs-turbopack-canary-quickjs137019
✅ nextjs-turbopack-stable-node15600
✅ nextjs-turbopack-stable-quickjs15600
✅ nextjs-webpack-canary-node137019
✅ nextjs-webpack-canary-quickjs137019
✅ nextjs-webpack-stable-node15600
✅ nextjs-webpack-stable-quickjs15600
✅ nitro-stable-node130026
✅ nitro-stable-quickjs130026
✅ nuxt-stable-node130026
✅ nuxt-stable-quickjs130026
✅ sveltekit-stable-node14907
✅ sveltekit-stable-quickjs14907
✅ tanstack-start-node130026
✅ tanstack-start-quickjs130026
✅ vite-stable-node130026
✅ vite-stable-quickjs130026

✅ 📦 Local Production

AppPassedFailedSkipped
✅ astro-stable-node130026
✅ astro-stable-quickjs130026
✅ express-stable-node130026
✅ express-stable-quickjs130026
✅ fastify-stable-node130026
✅ fastify-stable-quickjs130026
✅ hono-stable-node130026
✅ hono-stable-quickjs130026
✅ nest-stable-node130026
✅ nest-stable-quickjs130026
✅ nextjs-turbopack-canary-node137019
✅ nextjs-turbopack-canary-quickjs137019
✅ nextjs-turbopack-stable-node15600
✅ nextjs-turbopack-stable-quickjs15600
✅ nextjs-webpack-canary-node137019
✅ nextjs-webpack-canary-quickjs137019
✅ nextjs-webpack-stable-node15600
✅ nextjs-webpack-stable-quickjs15600
✅ nitro-stable-node130026
✅ nitro-stable-quickjs130026
✅ nuxt-stable-node130026
✅ nuxt-stable-quickjs130026
✅ sveltekit-stable-node14907
✅ sveltekit-stable-quickjs14907
✅ tanstack-start-node130026
✅ tanstack-start-quickjs130026
✅ vite-stable-node130026
✅ vite-stable-quickjs130026

✅ 🐘 Local Postgres

AppPassedFailedSkipped
✅ astro-stable-node130026
✅ astro-stable-quickjs130026
✅ express-stable-node130026
✅ express-stable-quickjs130026
✅ fastify-stable-node130026
✅ fastify-stable-quickjs130026
✅ hono-stable-node130026
✅ hono-stable-quickjs130026
✅ nest-stable-node130026
✅ nest-stable-quickjs130026
✅ nextjs-turbopack-canary-node137019
✅ nextjs-turbopack-canary-quickjs137019
✅ nextjs-turbopack-stable-node15600
✅ nextjs-turbopack-stable-quickjs15600
✅ nextjs-webpack-canary-node137019
✅ nextjs-webpack-canary-quickjs137019
✅ nextjs-webpack-stable-node15600
✅ nextjs-webpack-stable-quickjs15600
✅ nitro-stable-node130026
✅ nitro-stable-quickjs130026
✅ nuxt-stable-node130026
✅ nuxt-stable-quickjs130026
✅ sveltekit-stable-node14907
✅ sveltekit-stable-quickjs14907
✅ tanstack-start-node130026
✅ tanstack-start-quickjs130026
✅ vite-stable-node130026
✅ vite-stable-quickjs130026

✅ 🪟 Windows

AppPassedFailedSkipped
✅ nextjs-turbopack-node15600
✅ nextjs-turbopack-quickjs15600

✅ 🌐 Cross-language Conformance

AppPassedFailedSkipped
✅ python90128

✅ vercel-multi-region

AppPassedFailedSkipped
✅ nextjs-turbopack2700

📋 View full workflow run

@socket-security

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

DiffPackageSupply Chain
Security
VulnerabilityQualityMaintenanceLicense
Addednpm/​@​vercel/​geistdocs@​1.20.4961007499100

View full report

@github-actions

Copy link
Copy Markdown
Contributor

Sim World

Simulated world deterministic testing for races. Traces

🟠 world-sim scenario book — 1 fail of 41 total

fence=per-spec

scenariooutcomeeventsvirtreplayviolations
smoke-no-stepscompleted30msok0
smoke-one-stepcompleted60msok0
hook-at-step-startedcompleted120msok0
hook-at-step-completedcompleted120msok0
hook-at-hook-createdcompleted120msok0
deadline-hook-winscompleted71.0hok0
deadline-expirescompleted71.0hok0
long-sleepcompleted1130.0dok0
hook-never-arrivesstalled30msskipped0
step-retries-twicecompleted102.0sok0
parallel-stepscompleted90msok0
hook-on-execution-statecompleted120msok0
peek-hook-before-branchcompleted120msok0
peek-hook-after-branchcompleted120msok0
peek-hook-at-registrationcompleted120msok0
race-hook-before-probecompleted120msok0
race-hook-after-probecompleted120msok0
race-duplicate-deliverycompleted130msok0
attr-hook-before-stepcompleted110msok0
attr-hook-after-stepcompleted110msok0
attr-from-step-bodycompleted130msok0
fork-hook-after-timeoutcompleted141.0mok0
fork-hook-before-timeoutcompleted141.0mok0
count-hook-after-timeoutcompleted171.0mok0
count-hook-before-timeoutcompleted201.0mok0
stale-read-step-count-forkcompleted201.0mok0
stale-read-equal-step-countscompleted141.0mok0
step-vs-step-forkcompleted120msok0
step-vs-step-fork-fencedcompleted120msok0
fence-catches-benign-directioncompleted125msok0
in-flight-before-decisioncompleted171.0mok0
in-flight-before-decision-countedcompleted171.0mok0
in-flight-after-decisioncompleted192.0mok0
stale-read-step-count-fork-fencedcompleted201.0mok0
fork-hook-winscompleted131.0mok0
fork-timeout-winscompleted131.0mok0
unclaimed-payload-under-forkcompleted171.0mok0
claimed-payload-under-forkcompleted171.0mok0
writers-independent-step-bodiescompleted120msok0
writers-scripted-tempocompleted120msok0
cancel-mid-stepcancelled70msskipped0

Full trace: world-sim.txt

@VaguelySerious
VaguelySerious merged commit d5d19fc into mainAug 21, 2026
170 of 172 checks passed
@VaguelySerious
VaguelySerious deleted the richard/update-geistdocs-1.20.4 branch August 21, 2026 18:43
@github-actions

Copy link
Copy Markdown
Contributor

Backport to stable failed for d5d19fc due to a workflow error (backport job run).

This is usually an infrastructure problem (e.g. the configured AI model could not be found, an AI Gateway error, or an opencode crash) rather than a merge conflict. Check the job logs linked above for details.

Once the underlying issue is fixed, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

d5d19fc8d51cd0ea51ae237a3f3447141c9fb992

Sign up for freeto 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.

3 participants

@molebox@VaguelySerious@christopherkindl