Lutra/docs
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
..
architecture.md M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
development.md M0.5: Tauri desktop shell with themed main window 2026-10-14 18:39:49 +02:00
framework-parity.md M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
gaps.md M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
language-parity.md M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
localization-parity.md M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
roadmap.md M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
target-app-parity.md M1.3: engine workspace, file and buffer commands, event stream 2026-10-14 20:24:44 +02:00
tooling-parity.md M0: import starter package (rules, roadmap, progress docs) 2026-10-13 20:22:22 +02:00
ui-parity.md M1.5: main window layout and project tree against mocked engine events 2026-10-14 19:24:23 +02:00