State holds the open project (VFS project, watcher, watched directories)
and versioned buffers. New commands: project.open/close/children,
file.open/save/saveAll, buffer.get/edit/close. buffer.edit takes UTF-16
change sets based on a version and fails with the new stale_version code;
closing dirty buffers or projects without force fails with
unsaved_changes. Commands queue events (projectOpened, treeChanged,
bufferChanged, dirtyChanged, fileChangedOnDisk, ...) that the engine
returns in Outcome.events; Engine::pump_vfs maps changes on disk to
events and reloads clean buffers. project.children watches listed
directories, capped at 256 native / 32 polling, least recently listed
dropped first.
Control channel: events.subscribe streams {"event": ...} lines, with
bounded per-subscriber queues (lutra_control::Subscribers) and method docs
in methods.rs. testkit's EngineBackend and the desktop Host implement the
new Backend::subscribe. Verified with 14 engine integration tests, a TCP
events test and the running app over the control channel.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
44 lines
3.1 KiB
Markdown
44 lines
3.1 KiB
Markdown
# Gaps
|
||
|
||
> **Status:** M0 closed G1; G2 under way (text buffer, engine buffers) · **Last updated:** 2026-10-14
|
||
|
||
Every known shortfall, ranked. This is the work list: unless the owner gives a task, take the highest open gap. Hours are agent wall-clock hours for one agent, all estimated.
|
||
|
||
| # | Gap | Milestone | Estimate (one agent) |
|
||
|---|---|---|---|
|
||
| G1 | ~~Foundation: workspace, quality gate, command registry, guard, control channel~~ closed 2026-10-14 | M0 | done (~2 h measured) |
|
||
| G2 | Editor core: ~~engine buffers, save~~ (M1.3), editor UI, undo, multi-caret, recovery journal | M1 | ~25 h |
|
||
| G3 | Project model: ~~VFS~~ (M1.2: listing, ignore rules, native file watching with polling fallback, safe file IO), project tree (UI exists against a mocked engine, M1.5; engine side with `project.children` and tree events landed in M1.3; wiring in M1.4), tabs; command palette, settings, theme switching | M1 | ~27 h |
|
||
| G4 | Syntax and structure: tree-sitter PHP, Lezer highlighting, file structure | M2 | ~15 h |
|
||
| G5 | Search and navigation: find in files, go to file/class/symbol, first index | M2 | ~35 h |
|
||
| G6 | Language server: completion, diagnostics, definition, hover, rename via Phpactor | M3 | ~45 h |
|
||
| G7 | Terminal, `lutra` CLI and MCP server | M3 | ~35 h |
|
||
| G8 | Git integration | M4 | ~150 h |
|
||
| G9 | Debugger, test runner, Composer, run configurations | M5 | ~300 h |
|
||
| G10 | Own indexer, type inference, inspections, refactorings | M6 | ~800 h |
|
||
| G11 | Stability: crash-free operation on real projects and machines | ongoing | ~100 h |
|
||
| G12 | Performance budgets: start, open, type, search, index | ongoing | ~100 h |
|
||
| G13 | Frameworks: Symfony, Laravel, Shopware, WordPress | M6 | ~300 h |
|
||
| G14 | Localization: English and German interface | later | ~40 h |
|
||
| G15 | Database tools, HTTP client, Docker and remote | later | ~430 h |
|
||
| G16 | Plug-ins and ecosystem | later | ~120 h |
|
||
|
||
G2 progress: the engine text buffer landed (M1.1, `crates/text`: rope, UTF-16 and char positions, atomic edit batches, line ending policy). M1.3 added engine buffers with versions, the edit protocol, save and save all, and reloading on external changes. Still open: the editor UI, undo, multi-caret and the recovery journal; estimate lowered to ~25 h.
|
||
|
||
Known smaller items from M0:
|
||
|
||
- The CI workflow has never run: the repository has no remote until the owner decides on hosting.
|
||
- `ui.screenshot` captures the screen region of the window, so covering windows appear in the image; a webview-native capture would avoid that.
|
||
- `cargo xtask fixtures` needs Composer, which the M0 machine does not have.
|
||
|
||
## Revision history
|
||
|
||
| Date | Change | Summary |
|
||
|---|---|---|
|
||
| 2026-10-14 | minor | G2 shrunk, G3 note: engine workspace (M1.3) |
|
||
| 2026-10-14 | minor | G3 note: project tree UI (M1.5) |
|
||
| 2026-10-14 | minor | G2 note: text buffer landed (M1.1) |
|
||
| 2026-10-14 | minor | G3: native file watching (M1.2b); notify item resolved (CC0-1.0 approved for notify) |
|
||
| 2026-10-14 | minor | G3 shrunk by the VFS (M1.2); notify licence item |
|
||
| 2026-10-14 | minor | G1 closed; estimates for G2–G16; M0 follow-ups |
|
||
| 2026-10-13 | major | Initial gap list |
|