Lutra/docs/gaps.md
danny f1976c7d67 M1.3: engine workspace, file and buffer commands, event stream
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>
2026-10-14 20:24:44 +02:00

3.1 KiB
Raw Blame History

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