ci: cache Vite Task output for docs builds by wan9chi · Pull Request #2006 · voidzero-dev/vite-plus

wan9chi · 2026-07-01T10:26:59Z

Summary

Keep the root docs:build script as pnpm -C docs build.
Move the cacheable docs build inside docs/: docs now runs installer asset copying first, then delegates vitepress build to the cacheable Vite Task build:site.
Configure build:site in docs/vite.config.ts with automatic input tracking, necessary generated-file exclusions, and explicit .vitepress/dist/** output tracking.
Add Vite Task cache restore/save steps to deploy-docs.yml and deploy-docs-preview.yml using docs/node_modules/.vite/task-cache.
Keep Netlify on pnpm build:netlify, which runs vitepress build directly without vp.
Use the released Vite+ package through setup-vp now that the task-cache behavior is available in v0.2.2.

Time Saved

The cache-hit verification run reported 23.14s saved for replaying vitepress build.

Cache restored: ~13 MB (13,374,673 B).
Restore/download/extract overhead: ~0.41s.
Net saving after restore overhead: ~22.73s.
Save/upload overhead for the new PR-scoped key: ~0.69s.
Net saving including download & upload overhead: ~22.04s.

Cache Verification

Scenario	Run	Result
Relevant docs task config change	Deploy Docs Preview run 28558655161, job 84671537096	Restored the previous PR cache, then `vitepress build` missed with `cache miss: output configuration changed, executing`; saved a new PR cache key for `96913ac2`.
Irrelevant workflow-only change	Deploy Docs Preview run 28559033970, job 84672667814	Restored the PR cache from `96913ac2`, then `vitepress build` hit with `cache hit, replaying`; saved a new PR cache key for `0bfe9c6e`. This verification commit was later dropped from branch history.
Rewritten current PR head	Deploy Docs Preview run 28559971286, job 84675438841	Restored the prior PR cache, replayed `vitepress build`, and saved the current PR-head cache key for `893293ac`.

Validation

Verified the relevant-change push misses and updates the PR cache.
Verified an irrelevant change restores the previous PR cache and hits vitepress build.
Verified the post-rewrite PR head still restores the prior PR cache and hits vitepress build.
Latest PR checks are green: 12 passed, 16 skipped, 2 neutral, 0 pending, 0 failed.

Notes

The generated input exclusions remain necessary because VitePress reads and writes generated .vitepress and node_modules/.vite-temp files during the cacheable build. Explicit output is included so cached builds restore .vitepress/dist reliably.

netlify · 2026-07-01T10:27:05Z

✅ Deploy Preview for viteplus-preview ready!

Name	Link
🔨 Latest commit	`a8e3267`
🔍 Latest deploy log	https://app.netlify.com/projects/viteplus-preview/deploys/6a463f0f2726ca00085344b5
😎 Deploy Preview	https://deploy-preview-2006--viteplus-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

github-actions · 2026-07-01T10:30:06Z

✅ Staging deployment successful!

Preview: https://viteplus-staging.void.app/
Commit: a8e3267

wan9chi · 2026-07-02T02:29:19Z

ci: cache Vite Task output for docs builds #2006 👈 (View in Graphite)
ci: skip full CI for docs deploy config #2015
main

How to use the Graphite Merge Queue

Add the label auto-merge to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

_{An organization admin has enabled the Graphite Merge Queue in this repository.} _{Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.}

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

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1fb09521a7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@liangmiQwQ

…xes (#2081) Release vite-plus v0.2.3: config extraction, create, and `vp run` reliability fixes. A patch release that restores static config extraction for projects importing `defineConfig` from `vite`, fixes `vp create` for org templates on registries that strip custom package fields, cleans up terminal output after Ctrl-C during `vp run`, and updates bundled Vite to 8.1.3. ### Highlights - **Custom `VP_HOME` is honored on every run**: the global `vp` now respects a user-set `VP_HOME` for its home directory instead of falling back to `~/.vite-plus`, and persists it in the generated env files, so a custom install location no longer produces multiple instances or unusable packages ([#2029](#2029)), by @liangmiQwQ ### Features - Upgrade bundled Vite from `8.1.2` to `8.1.3` (inlined CSS after the shebang line, CSS preload for nested dynamic imports, SSR stacktrace column fix) ([#2042](#2042)), by @voidzero-guard[bot] ### Fixes & Enhancements - `vp run` no longer misreads a `vite.config.ts` when its `defineConfig` comes from a preset or a custom wrapper instead of `vite-plus` or `vite`. Such configs are now evaluated at runtime rather than assumed to be Vite+'s own, so projects that use them no longer wrongly report `Task "build" not found` ([#2060](#2060), [#2075](#2075)), by @liangmiQwQ and @fengmk2 - Killing a `vp run` task with Ctrl-C no longer leaves odd OSC escape sequences in the terminal; `vp` defers its own Ctrl-C handling until the child process exits ([#2079](#2079)), by @forehalo - `vp migrate`: rewriting a `package.json` prettier script now emits a single `--check`, so scripts that combined `--check` with `--list-different` / `-l` / `-c` no longer produce a duplicated `vp fmt --check --check` ([#2044](#2044)), by @shulaoda - `vp create @org:name`: read the org template catalog (`createConfig`) from the published tarball when the registry (e.g. GitHub Packages) strips custom fields from packument metadata ([#2063](#2063)), by @hiro-daikin - `vp run`: missing env vars requested through `@voidzero-dev/vite-task-client` now return `undefined` instead of `null`, preserving Vite production `NODE_ENV` semantics when builds run through `vp run` ([vite-task#508](voidzero-dev/vite-task#508), via [#2076](#2076)), by @wan9chi ### Refactor - `static_config`: drop the unreachable `vite.config.json` branch ([#2045](#2045)), and remove unused exported CLI helpers ([#2046](#2046)), by @shulaoda ### Docs - Update the announcement links and callout for the beta release ([#2027](#2027)), remove the stale `Dockerfile.alpine` comment ([#2068](#2068)), by @fengmk2 - Add the missing `pnpm-workspace.yaml` to the docs Dockerfile ([#2059](#2059)), by @wan-kong - Refresh the root agent guide ([#2072](#2072)), by @jong-kyung ### Chore - Cross-compile Windows tests and CLI binaries on Linux with cargo-xwin ([#1824](#1824)), install local vite-plus builds through a local npm registry ([#2021](#2021)), fast docs format check for docs-only PRs ([#2028](#2028)), pack local dirs for the registry bridge instead of pkg.pr.new ([#2038](#2038)), remove the stale create workflow updater ([#2061](#2061)), and add PTY-based interactive CLI snapshot tests ([#2052](#2052)), by @fengmk2 - Cache `vp run` output for docs builds ([#2006](#2006)), by @wan9chi - Remove legacy completion cleanup ([#2050](#2050)), by @nekomoyi - Update the crate-ci/typos action ([#2039](#2039)) and GitHub Actions ([#2055](#2055), [#1905](#1905)), by @renovate[bot] - Refresh the Node.js release keyring ([#2058](#2058)) and the docs trusted-stack stats ([#2064](#2064)), by @voidzero-guard[bot] ### Bundled Versions | Tool | Version | Source | | --- | --- | --- | | vite | `8.1.3` | [`578ffb8`](vitejs/vite@578ffb8) | | rolldown | `1.1.4` | [`6cbd233`](rolldown/rolldown@6cbd233) | | tsdown | `0.22.3` | [npm](https://npmx.dev/package/tsdown/v/0.22.3) | | vitest | `4.1.9` | [npm](https://npmx.dev/package/vitest/v/4.1.9) | | oxlint | `1.72.0` | [npm](https://npmx.dev/package/oxlint/v/1.72.0) | | oxlint-tsgolint | `0.24.0` | [npm](https://npmx.dev/package/oxlint-tsgolint/v/0.24.0) | | oxfmt | `0.57.0` | [npm](https://npmx.dev/package/oxfmt/v/0.57.0) | ### Upgrade ```bash vp upgrade ``` ### New Contributors @wan-kong and @hiro-daikin made their first contributions. **Full Changelog**: v0.2.2...v0.2.3 --- Merging this PR will trigger the release workflow. --------- Co-authored-by: voidzero-guard[bot] <278573678+voidzero-guard[bot]@users.noreply.github.com> Co-authored-by: wan9chi <dk4rest@gmail.com>

wan9chi force-pushed the codex/docs-build-cache branch from 837109b to b76ce04 Compare July 1, 2026 10:27

wan9chi force-pushed the codex/docs-build-cache branch 5 times, most recently from e7e21a9 to 069097f Compare July 1, 2026 12:17

wan9chi changed the title ~~[codex] Enable cached docs build task~~ ci: cache Vite Task output for docs builds Jul 1, 2026

wan9chi force-pushed the codex/docs-build-cache branch from 0bfe9c6 to 893293a Compare July 2, 2026 01:55

wan9chi changed the base branch from main to graphite-base/2006 July 2, 2026 02:28

wan9chi force-pushed the codex/docs-build-cache branch from 893293a to 16f8d05 Compare July 2, 2026 02:29

wan9chi changed the base branch from graphite-base/2006 to skip-docs-deploy-workflows-ci July 2, 2026 02:29

wan9chi mentioned this pull request Jul 2, 2026

ci: skip full CI for docs deploy config #2015

Merged

wan9chi force-pushed the skip-docs-deploy-workflows-ci branch from 6792ba6 to a0e4b7a Compare July 2, 2026 02:30

wan9chi force-pushed the codex/docs-build-cache branch from 16f8d05 to 1fb0952 Compare July 2, 2026 02:30

wan9chi marked this pull request as ready for review July 2, 2026 02:32

wan9chi marked this pull request as draft July 2, 2026 02:32

wan9chi requested a review from fengmk2 July 2, 2026 02:33

wan9chi marked this pull request as ready for review July 2, 2026 02:33

chatgpt-codex-connector Bot reviewed Jul 2, 2026

View reviewed changes

Comment thread .github/workflows/deploy-docs.yml Outdated

Comment thread docs/vite.config.ts

Base automatically changed from skip-docs-deploy-workflows-ci to main July 2, 2026 03:19

wan9chi force-pushed the codex/docs-build-cache branch from 1fb0952 to 7ac4c51 Compare July 2, 2026 03:23

fengmk2 reviewed Jul 2, 2026

View reviewed changes

Comment thread .github/workflows/deploy-docs-preview.yml Outdated

wan9chi force-pushed the codex/docs-build-cache branch from 7ac4c51 to 8013cb0 Compare July 2, 2026 06:09

fengmk2 approved these changes Jul 2, 2026

View reviewed changes

wan9chi added 3 commits July 2, 2026 18:35

ci(docs): enable cached docs build task

3edb0c8

build(netlify): remove Node version override

ea8ea96

build(docs): trim build cache inputs

d410ab0

wan9chi added 12 commits July 2, 2026 18:35

build(docs): restore Vite temp cache exclusion

5fa8b84

build(docs): rely on tracked build outputs

43c4292

ci(docs): cache task builds in Actions

4ed06e0

ci(docs): run deploy build once

a0ffeef

build(docs): ignore Vite temp directory listing

b5b5bd7

ci(docs): clarify task cache steps

a129dfd

build(docs): restore build output tracking

1b66ae6

ci(docs): document task cache restore order

f89f484

build(docs): remove redundant Vite temp input

83d4429

ci(docs): use pkg.pr.new Vite+ for docs cache

79ffad1

build(docs): set explicit build output

7b7f75f

ci(docs): use released Vite+ for deploy builds

a8e3267

wan9chi force-pushed the codex/docs-build-cache branch from 43ced42 to a8e3267 Compare July 2, 2026 10:35

fengmk2 merged commit 7575a95 into main Jul 2, 2026
30 checks passed

fengmk2 deleted the codex/docs-build-cache branch July 2, 2026 11:52

wan9chi mentioned this pull request Jul 7, 2026

release: v0.2.3: config extraction, create, and vp run reliability fixes #2081

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

ci: cache Vite Task output for docs builds#2006

ci: cache Vite Task output for docs builds#2006
fengmk2 merged 15 commits into
mainfrom
codex/docs-build-cache

wan9chi commented Jul 1, 2026 •

edited

Loading

Uh oh!

netlify Bot commented Jul 1, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 1, 2026 •

edited

Loading

Uh oh!

wan9chi commented Jul 2, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

wan9chi commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Time Saved

Cache Verification

Validation

Notes

Uh oh!

netlify Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for viteplus-preview ready!

Uh oh!

github-actions Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wan9chi commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

How to use the Graphite Merge Queue

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

wan9chi commented Jul 1, 2026 •

edited

Loading

netlify Bot commented Jul 1, 2026 •

edited

Loading

github-actions Bot commented Jul 1, 2026 •

edited

Loading

wan9chi commented Jul 2, 2026 •

edited

Loading