Extract project/workspace related functionality to Effect services

[juliusmarminge]

Summary

• Move workspace entry indexing into a dedicated project service layer.
• Wire workspace cache invalidation through the new service from checkpoint/orchestration flows.
• Extend Git core support for worktree detection, workspace file listing, ignore filtering, and stdin-backed commands.
• Add coverage for workspace indexing, ignore filtering, chunking, and updated Git core behavior.

Testing

• bun fmt
• bun lint
• bun typecheck
• bun run test

---

Note

Medium Risk
Refactors core workspace indexing, file writes, and favicon handling into new Effect services and changes GitCore.execute output/truncation semantics (plus stdin support), which could affect multiple call sites and runtime wiring if any consumer assumptions were missed.

Overview
Extracts workspace/project helpers into Effect services and rewires server consumers. Introduces WorkspaceEntries (TTL-cached workspace index + ranked search with git-aware ignore filtering), WorkspacePaths (workspace root normalization + safe relative path resolution), and WorkspaceFileSystem (workspace-root-relative writes that invalidate the entry cache), and updates WebSocket handlers to use these services instead of ad-hoc helpers.

Moves favicon discovery into a dedicated resolver. Adds ProjectFaviconResolver and converts tryHandleProjectFaviconRequest to an Effect-based handler backed by the resolver and FileSystem.

Extends GitCore to support workspace indexing workflows. Adds stdin support to execute, returns explicit stdoutTruncated/stderrTruncated flags (instead of embedding a marker), and adds isInsideWorkTree, listWorkspaceFiles, and chunked filterIgnoredPaths to safely handle large path lists.

Wiring + tests updated. CheckpointReactor now invalidates via WorkspaceEntries.invalidate; server/runtime layers and integration tests are updated accordingly; new test suites cover the new services and git ignore chunking, and legacy workspaceEntries modules/tests are removed.

^{Written by Cursor Bugbot for commit c6d0fb7. This will update automatically on new commits. Configure here.}

Note

Extract workspace entry indexing into dedicated service layer

• Introduces WorkspaceEntries, WorkspaceFileSystem, and WorkspacePaths as injected Effect services, replacing module-level functions and inline logic in wsServer.ts.
• WorkspaceEntries builds a cached (TTL 15s, capacity 4) index of up to 25,000 entries using git when available or a bounded filesystem walk (32 concurrent reads), with fuzzy ranking and truncation tracking.
• WorkspaceFileSystem.writeFile resolves and validates paths within the workspace root, creates parent directories, and invalidates the WorkspaceEntries cache after writing.
• WorkspacePaths handles workspace root normalization (including ~ expansion) and safe in-root path resolution, rejecting escape attempts.
• GitCore gains isInsideWorkTree, listWorkspaceFiles, and filterIgnoredPaths (chunked via NUL-separated stdin) and now reports stdout/stderr truncation via flags on ExecuteGitResult.
• CheckpointReactor now calls workspaceEntries.invalidate(cwd) via the injected service instead of a direct module-level function.
• Risk: error messages for projects.writeFile and workspace root validation in project.create/project.meta.update change to domain-specific strings from the new services.

^{Macroscope summarized c6d0fb7.}

[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: 51f9f43b-a4fc-4256-9da8-372e1d58fdd5

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
• Commit unit tests in branch t3code/effect-workspace-service

---

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