Lutra/docs/roadmap.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

1.9 KiB
Raw Blame History

Milestones

Status: M0 done, M1 in progress · Last updated: 2026-10-14

Hours are agent wall-clock hours for one agent; M0 is measured, the rest estimated.

Milestone Goal State Hours
M0 Foundation: workspace, lints, quality gate, command registry, control channel, empty window done 2026-10-14 (CI workflow written, not yet run: no remote) ~2 (measured)
M1 Editor and project: open folder, tree, tabs, editor, save, recovery, palette, settings, themes in progress (M1.1 text, M1.2 VFS, M1.5 tree UI, M1.3 engine workspace) ~60
M2 Syntax and search: highlighting, structure, find in files, go to file/class/symbol not started ~50
M3 LSP, terminal, CLI: completion, diagnostics, go to definition, hover, rename; terminal; lutra CLI and MCP — MVP not started ~80
M4 Git: status, diff, commit, branches, log, blame, conflicts not started ~150
M5 Debugger (Xdebug via DAP), PHPUnit/Pest runner, Composer, run configurations not started ~300
M6 Own indexer and inspections; Symfony, Laravel, Shopware, WordPress support not started ~1,100

Alpha gate

Alpha is reached when these six core workflows work end to end on macOS, Windows and Linux, with save and reopen:

  1. Open a project, browse and edit files, save, recover after a crash.
  2. Navigate: go to file, class, symbol and definition; find in files.
  3. Write code with completion and diagnostics.
  4. Run commands in the integrated terminal.
  5. Commit, diff and switch branches with Git.
  6. Drive all of the above from the CLI, the control channel and MCP.

By the estimates above the alpha gate needs M1–M4 plus cross-platform verification, about 350 h.

Revision history

Date Change Summary
2026-10-14 minor M1 in progress
2026-10-14 minor M0 done; hours per milestone
2026-10-13 major Initial milestones