fix: invalidate workspace entry cache after turn completion and revert

[binbandit]

Summary

Fixes #791 — newly created files were not visible in the @-mention file picker until the workspace entry cache expired (up to 15 seconds on both server and client).

Problem

The @-mention file picker is backed by two layers of caching:

1. Server-side: workspaceEntries.ts caches the full workspace file index in-memory with a 15-second TTL (WORKSPACE_CACHE_TTL_MS).
2. Client-side: React Query marks workspace entry queries as stale after 15 seconds (DEFAULT_SEARCH_ENTRIES_STALE_TIME).

When the LLM creates, modifies, or deletes files during a turn, neither cache is invalidated. The user must wait up to 30 seconds (or trigger a query by running a command) before the @-mention dropdown reflects the new filesystem state.

Fix

• Server: Export clearWorkspaceIndexCache(cwd) from workspaceEntries.ts and call it in CheckpointReactor after:
  • Turn completion (turn.completed) — files may have been created/deleted by the agent
  • Checkpoint revert (restoreCheckpoint) — filesystem was rolled back to a prior state
• Client: Invalidate projectQueryKeys.all in the EventRouter when thread.turn-diff-completed or thread.reverted domain events arrive (alongside the existing providerQueryKeys.all invalidation), so React Query refetches workspace entries on the next @-mention query.

Testing

• bun lint passes (only pre-existing warning)
• bun typecheck passes (only pre-existing @dnd-kit errors in Sidebar.tsx)
• bun run test passes (only pre-existing terminalStateStore.test.ts localStorage failures)
• Workspace entry tests (workspaceEntries.test.ts) all pass

Note

Invalidate workspace entry cache after checkpoint capture and revert

• Adds clearWorkspaceIndexCache(cwd) to workspaceEntries.ts, which removes the given cwd from both workspaceIndexCache and inFlightWorkspaceIndexBuilds.
• Calls clearWorkspaceIndexCache in CheckpointReactor.ts after checkpoint capture and after successful filesystem restore, so subsequent lookups rebuild from disk.
• Also invalidates projectQueryKeys.all React Query cache in __root.tsx alongside provider queries when domain events flush, keeping project data fresh after turns complete.

^{Macroscope summarized d8909dc.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2bc9eb84-d725-430f-8562-269e5495f747

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[binbandit]

@juliusmarminge Nice little quick win. It makes it so newly created files can be referenced straight away within the chat