Functions

f
path(projectRoot: string): string

Returns the on-disk cache path for projectRoot. The path embeds a SHA-1 tag of the absolute project root so projects that share a hoisted/symlinked node_modules (pnpm workspaces, monorepos, integration test fixtures) write to distinct files. 12 hex chars is far below collision risk for the scale of "projects on one machine."

f
read(projectRoot: string): Task<MetafileCachePayload | null, never>

Reads the cached metafile. Returns null on miss or corruption.

f
write(
projectRoot: string,
esbuildCwd: string,
metafile: AffectedMetafile
): Promise<void>

Best-effort write; failures are swallowed because a cache miss on the next read just degrades to "run all tests."

Interfaces

I
MetafileCachePayload

Persistent on-disk cache of the most recent successful esbuild metafile, used by --changed / --since to compute the reverse-dependency graph without re-running esbuild. Lives under node_modules/.cache/ (npm convention, gitignored, survives rm -rf tmp/).