[wan9chi]

Motivation

An exclusion in a task's input, like "!build/**", leaves out only the paths the task reads. When the task lists a folder, every entry still counts, so an excluded folder appearing there is a cache miss: a lint task listing the package root misses once another task's build output appears in it. That is the case the hard-coded dist skip was added for (#181). #919 removes the skip, so users need a setting to get it back, and today "!dist/**", which docs/inputs.md recommends, doesn't help.

Changes

Listings leave out what the input config excludes, after the entries the task can rebuild (#915):

• An entry whose path the input negative globs match. A folder entry is matched by its own path; wax's ** matches zero or more components, so build/** leaves out build, while build/* keeps it. The globs are part of the cache key, so validation applies the same ones to the current listing, and an entry that appears after the run is left out too.
• An entry that a tool-reported ignoreInput path names. Those paths are known only after the run, so the names are recorded in the listing's ignored_entries, including entries that aren't there yet.

The cache schema version is bumped. docs/inputs.md now says negatives also keep entries out of listings.

E2E cases: negative_glob_hides_listing_entry (synthetic, vtt list-dir with "!out/**"; an unrelated new file still misses) and oxlint_negative_build (oxlint -D no-debugger with a gitignored build/ and "!build/**"). Both miss today and hit after. A unit test covers ignoreInput.

Part of a stack that lets automatic tracking cache tasks which read their own outputs and list the folders holding them, so they also hit on a clean checkout.

🤖 Generated with Claude Code

---

Note

Medium Risk
Changes post-run fingerprint semantics and cache validation for any task that lists directories with input negatives or ignoreInput; incorrect glob matching could cause stale cache hits, mitigated by schema bump and targeted tests.

Overview
Input exclusions now apply to directory listings, not only to paths the task reads. Tasks that list a folder (e.g. a linter scanning the package root) no longer miss the cache when an excluded entry appears—such as another task’s build/ folder after "!build/**"—as long as nothing else in the listing changed.

Post-run fingerprints omit listing entries matched by the task’s input negative globs (same rules as reads: build/** drops the build folder entry; build/* does not) and by tool ignoreInput paths (names recorded in ignored_entries for validation). Cache hits recompile those globs from the entry key and apply the same filters when comparing listings.

Cache schema version is bumped to v22 (fresh cache). Docs and changelog describe the behavior; e2e covers !out/** with list-dir and an oxlint + !build/** scenario, plus a unit test for globs and ignoreInput.

^{Reviewed by Cursor Bugbot for commit 0655edb. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

fspy benchmark

linux

dynamic/launch             change  +0.41%  [ -2.58% ..  +4.68%]  overhead   +58.06%
dynamic/access             change  +0.43%  [ -4.43% ..  +5.45%]  overhead   +20.68%
dynamic/access-relative    change  -0.31%  [ -3.56% ..  +2.17%]  overhead   +70.01%
dynamic/access-contended   change  +0.53%  [-11.21% ..  +7.48%]  overhead   +34.68%
static/launch              change  -0.05%  [ -5.31% ..  +6.59%]  overhead  +199.04%
static/access              change  -0.55%  [ -2.12% ..  +2.37%]  overhead +1460.03%
static/access-relative     change  -0.58%  [ -2.63% ..  +1.27%]  overhead +1972.82%
static/access-contended    change  -0.33%  [ -2.26% ..  +0.73%]  overhead +1771.40%

macos

dynamic/launch             change  +0.26%  [ -5.11% ..  +5.70%]  overhead  +253.12%
dynamic/access             change  -2.08%  [-60.11% .. +41.18%]  overhead    +1.97%
dynamic/access-relative    change  +1.77%  [ -8.14% .. +75.98%]  overhead  +243.83%
dynamic/access-contended   change  -0.58%  [ -6.93% ..  +9.95%]  overhead    +3.85%

windows

dynamic/launch             change  -0.18%  [ -1.82% ..  +1.45%]  overhead   +26.17%
dynamic/access             change  +0.19%  [ -0.74% ..  +0.74%]  overhead    +0.94%
dynamic/access-relative    change  +0.00%  [ -0.72% ..  +0.55%]  overhead    +1.11%
dynamic/access-contended   change  +0.00%  [ -0.52% ..  +0.70%]  overhead    +1.25%