[wan9chi]

Motivation

Every directory listing skips an entry named dist. #181 added the skip so that a lint task listing the package root stays a cache hit when another task's build creates dist there. It helps no other folder name and hides a dist that does matter. A dist folder appearing in a folder the task listed goes unseen, and the next run replays stale output: oxlint, for example, passes from the cache after a dist folder with lint errors appears.

Changes

Listings skip only ., .. and .DS_Store. A task that should ignore another task's dist gets that back with "!dist/**" in its input, which keeps the entry out of its listings since #941. A task's own dist doesn't need the skip, since #915 makes a rebuildable folder an ignored entry. The cache schema version is bumped, so entries recorded with the skip aren't reused. No other snapshot changes.

E2E cases: dist_appears_in_listed_folder (synthetic, vtt list-dir) and oxlint_dist (oxlint -D no-debugger, with oxlint's rule count redacted). Both are false hits today and correct misses after.

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 cache fingerprint semantics for any task that lists directories, which can increase cache misses but fixes incorrect hits; schema bump invalidates existing local cache entries for the new version directory.

Overview
Directory listings for cache fingerprints no longer always omit a dist entry. Only ., .., and .DS_Store are skipped when fingerprinting folder contents, so a dist folder appearing or disappearing in a listed directory now triggers a cache miss instead of replaying stale results (e.g. oxlint passing after bad code lands in a committed dist/).

To keep ignoring another task’s dist, tasks can use "!dist/**" in input (listing exclusions from #941). A task’s own output dist still doesn’t affect listings when it only holds rebuildable outputs (#915). CACHE_SCHEMA_VERSION is bumped 22 → 23 so old fingerprints aren’t reused.

E2E coverage adds dist_appears_in_listed_folder and oxlint_dist snapshots for the new miss behavior.

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

[github-actions]

fspy benchmark

linux

dynamic/launch             change  +0.00%  [ -3.35% ..  +4.82%]  overhead   +60.53%
dynamic/access             change  -0.82%  [ -3.98% ..  +5.12%]  overhead   +18.02%
dynamic/access-relative    change  +0.59%  [ -2.50% ..  +3.24%]  overhead   +70.72%
dynamic/access-contended   change  +5.54%  [ -3.49% ..  +9.68%]  overhead   +36.06%
static/launch              change  +0.16%  [ -4.03% ..  +5.14%]  overhead  +199.83%
static/access              change  -0.35%  [ -3.69% ..  +2.18%]  overhead +1459.71%
static/access-relative     change  -0.55%  [ -2.55% ..  +1.21%]  overhead +1946.87%
static/access-contended    change  +0.59%  [ -3.31% ..  +2.80%]  overhead +1658.63%

macos

dynamic/launch             change  -0.54%  [ -4.90% ..  +4.68%]  overhead  +247.72%
dynamic/access             change  +2.25%  [-10.22% .. +142.98%]  overhead    +6.34%
dynamic/access-relative    change  +0.49%  [-12.26% .. +16.00%]  overhead  +230.90%
dynamic/access-contended   change  +1.16%  [ -7.15% ..  +9.83%]  overhead    +4.53%

windows

dynamic/launch             change  -0.73%  [ -4.60% ..  +3.67%]  overhead   +26.66%
dynamic/access             change  +0.19%  [ -1.13% ..  +1.31%]  overhead    +0.93%
dynamic/access-relative    change  +0.19%  [ -0.55% ..  +0.76%]  overhead    +0.58%
dynamic/access-contended   change  +0.00%  [ -0.74% ..  +0.74%]  overhead    +1.28%