Module WorkspaceProvider 

WorkspaceProvider: exposes workspace folders, trust state, and edits.

WorkspaceProvider (Environment)

Implements WorkspaceProvider and [WorkspaceEditApplier] traits for MountainEnvironment, exposing workspace-level functionality to the frontend via gRPC through AirService.

Responsibilities

• Multi-root workspace folder enumeration and URI matching
• Workspace trust management (IsWorkspaceTrusted / RequestWorkspaceTrust)
• File discovery (FindFilesInWorkspace) with LRU cache + single-flight dedup (see inline doc on that method)
• Workspace edit application - two-tier: emit Sky event for open documents; atomic on-disk splice for closed files

VS Code reference

• vs/workbench/services/workspace/browser/workspaceService.ts
• vs/platform/workspace/common/workspace.ts

Structs

FindFilesCacheEntry 🔒

FindFilesCacheKey 🔒

Constants

FIND_FILES_CACHE_CAPACITY 🔒

FIND_FILES_CACHE_TTL 🔒

Process-wide LRU cache for FindFilesInWorkspace. Cache key folds every input that influences the walk; TTL is short so we never serve a stale result after a file-system mutation. Entry budget is small to bound memory across many workspace folders + glob shapes.

Functions

ApplyEditsToDisk 🔒

Splice a list of TextEditDTO-shaped edits into the file at UriString. Edits are applied in descending start offset so each subsequent edit’s offsets stay valid. Errors propagate as CommonError::FromStandardIOError for read/write failures and CommonError::InvalidArgument for malformed edits.

ClearFindFilesCache

Drop every cached find-files result. Callers: workspace folder add/remove (UpdateWorkspaceFolders), file system watcher events from Mountain’s notifier, explicit refresh from the renderer. Cache holds for at most FIND_FILES_CACHE_TTL anyway, so missing an invalidation point here is bounded latency, not correctness.

ComputeLineOffsets 🔒

Pre-compute the byte offset of the start of every line.

ExtractGlobPattern 🔒

Extract a glob string from any of the shapes a caller can hand us:

ExtractRelativeBase 🔒

Extract a base directory from a RelativePattern-shaped value. VS Code’s RelativePattern carries { base, pattern } (or { baseUri, pattern }); when present, the walk must be restricted to base. Returns None for plain glob strings.

FindFilesCache 🔒

FindFilesCacheGet 🔒

FindFilesCachePut 🔒

Insert into the cache with simple bounded-size eviction. When the table reaches capacity we drop the oldest half in one pass; this avoids tracking access order per entry while still keeping memory bounded under sustained workbench traffic.

FindFilesInFlight 🔒

Single-flight registry: keys with a walk currently in progress share the same Notify so concurrent callers awaiting the same (folders, include, exclude, cap, flags) don’t each kick off their own filesystem walk.

HexDigit 🔒

LinePosToOffset 🔒

Resolve (line, character) to an absolute byte offset. Character is counted in UTF-16 code units to match VS Code’s Range/Position semantics. Falls back gracefully when line/char is past EOF.

percent_decode 🔒

Minimal percent-decode for file:// URI paths. Reuses the project’s existing helpers when possible; this self-contained version avoids an extra crate import.