Lutra/docs/gaps.md
danny d12a517009
Some checks are pending
ci / ci (macos-15) (push) Waiting to run
ci / ci (ubuntu-24.04) (push) Waiting to run
ci / ci (windows-2025) (push) Waiting to run
PM: review cycle 2
M1 done in ~5.6 h measured agent time (C1 2.5 h, C2 3.1 h);
C2 factor 0.10 confirms the x0.1 calibration.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 21:19:27 +02:00

6 KiB
Raw Blame History

Gaps

Status: M0 closed G1; G2 under way (text buffer, engine buffers, tabs and editor in the app, recovery journal); G3 M1 part done (project tree, palette, settings dialog, themes); G14 English UI catalog in place · Last updated: 2026-10-16

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 with tabs, undo, multi-caret (M1.6, CodeMirror basics), recovery journal (M1.7), tab management (preview, pin, split, close others, reopen), conflict UI for files changed on disk, autosave option M1 ~16 h
G3 Project model: VFS (M1.2: listing, ignore rules, native file watching with polling fallback, safe file IO), project tree wiring (M1.5 UI, M1.3 engine, M1.4 bridge: folder picker, live tree), tree toolbar and options, showing truncated listings (M1.13), error notifications for the folder picker (M1.12), tabs (M1.6), command palette (M1.8: commands only, global keymap, UI commands over the control channel); settings (backend: M1.9a; dialog with search: M1.9b), theme switching (M1.10: light/dark, live, system mode; picker in the dialog, M1.9b) M1 ~24 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 (recovery journal, M1.7) ongoing ~95 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: English message catalog for UI strings (M1.11), engine messages (EngineError.message) as message keys, language switch, plurals, German catalog later ~38 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. M1.6 added tabs and a CodeMirror 6 editor synced to engine buffers (version-based edits with resync, CRLF-aware offsets), save and save all by engine shortcuts, the Save / Don't Save / Cancel question and a notice for files changed on disk. M1.7 added the crash-recovery journal (debounced atomic entries per dirty buffer, recovery.* commands, restore dialog; not yet checked in the running app). M1.13 made re-opening an open file switch to its tab and keeps the folders of open files watched. Still open: tab management beyond open/close, a conflict UI (compare and merge with the disk version), autosave, editor settings (font size, soft wrap); estimate lowered to ~16 h.

G11 progress: M1.7 added the crash-recovery journal: unsaved buffers are written atomically about 1 s after the last edit and offered back after a crash; corrupt entries are skipped with a warning. Covered by a property test (random edits, crash, restore equals the buffer) and a headless control-channel test; not yet checked by killing the running app (gaming mode). Open: journal writes run under the engine lock (8.5 ms for 1 MiB, release), two instances on one project share a journal, local history.

G14 progress: M1.11 moved every UI string in ui/src into the English catalog ui/src/i18n/en.json behind t(key, params?), enforced by vue/no-bare-strings-in-template and a catalog test. Messages the engine sends (EngineError.message, the slogan from app.about) are still English text; they need message keys with params before a second language can cover them.

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-16 minor G3: settings dialog, theme picker (M1.9b)
2026-10-16 minor G3: command palette, global keymap, UI commands (M1.8)
2026-10-16 minor G2/G3: re-open focuses the tab, open buffers' folders watched, truncated listings shown (M1.13)
2026-10-15 minor G14 note: English message catalog (M1.11)
2026-10-15 minor G2 shrunk: tabs and editor (M1.6)
2026-10-16 minor G3: folder-picker error notifications (M1.12)
2026-10-16 minor G2 shrunk, G11 note: recovery journal (M1.7)
2026-10-16 minor G3: theme switching (M1.10)
2026-10-16 minor G3: settings backend (M1.9a)
2026-10-15 minor G3 shrunk: project tree wired to the engine (M1.4)
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