docs/references/file/README.md
The file domain covers persistent managed entries, filesystem-backed IPC, live directory trees, background cleanup, and the legacy directory-listing/search surface. Start with the module architecture for ownership and transport selection; use the narrower documents for implementation contracts.
| Document | What it covers |
|---|---|
| File Module Architecture | Ownership, current shared types, DataApi/IpcApi split, legacy preload surface, and business references |
| FileManager Architecture | Storage, entry lifecycle, atomic writes, external liveness, watcher, caches, and orphan sweeps |
| Directory Tree Architecture | Builder/manager ownership, snapshot activation, mutation stream, renderer mirror, and cleanup |
| File Entry Cleanup | Policy-based scan that reclaims old unreferenced automatic entries |
| Fuzzy Search for Directory Listings | Legacy listing modes, ripgrep-backed fuzzy matching, ranking, exclusions, and errors |