Lutra/docs/roadmap.md
danny 0b40eb90f8 M1.7: crash-recovery journal and restore dialog
Dirty buffers are written atomically to <data_dir>/recovery/<project-id>/
about 1 s after the last edit (at most 2 s while typing), from pump_vfs,
never per keystroke. Entries are removed on save, close (also force),
forced project close/open and recovery.discard. project.open emits
recoveryAvailable; recovery.list/restore/discard; restored buffers are
dirty and keep line ending and BOM. Corrupt entries are moved aside and
reported as warning notifications.

UI: restore dialog in ui/src/components/recovery (Restore all, Restore
selected, Discard, time, changed-on-disk hint), catalog keys and runtime
allow-list. Tests: crash/restore with CRLF + BOM, corrupt entries, removal
paths, property test of random edits, headless control-channel test,
Vitest for the dialog. Docs: architecture, parity, gaps, ROADMAP.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 15:56:41 +02:00

2.7 KiB
Raw Blame History

Milestones

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

Hours are agent wall-clock hours for one agent; M0 and M1 so far are measured, the rest estimated. Since cycle C1 (factor 0.07) M1–M3 are scaled ×0.1; M4–M6 keep their first raw estimates (multiply by ~0.1 for the calibrated value).

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: hosted on Forgejo, runners unknown) ~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, M1.4 desktop bridge, M1.6 tabs and editor, M1.11 message catalog, M1.9a settings backend, M1.10 themes, M1.7 recovery journal) ~6 (2.5 measured for M1.1–M1.6)
M2 Syntax and search: highlighting, structure, find in files, go to file/class/symbol not started ~5
M3 LSP, terminal, CLI: completion, diagnostics, go to definition, hover, rename; terminal; lutra CLI and MCP — MVP not started ~8
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 raw estimates the alpha gate needs M1–M4 plus cross-platform verification, about 350 h; calibrated with cycle C1's factor, about 35 h of agent time. Calendar time is dominated by reviews and owner decisions, not agent time.

Revision history

Date Change Summary
2026-10-16 minor M1.7 recovery journal
2026-10-16 minor M1.9a settings backend, M1.10 themes
2026-10-15 minor M1.11 message catalog
2026-10-15 minor Cycle C1 review: M1–M3 hours recalibrated ×0.1, M0 CI note
2026-10-15 minor M1.6 tabs and editor
2026-10-15 minor M1.4 desktop bridge
2026-10-14 minor M1 in progress
2026-10-14 minor M0 done; hours per milestone
2026-10-13 major Initial milestones