# Lutra Roadmap **Stage: pre-alpha (M1 done)** · next: M2 syntax and search; alpha when the six core workflows work end to end (see [docs/roadmap.md › Alpha gate](docs/roadmap.md#alpha-gate)) > **Last reviewed:** 2026-10-15 · **Last updated:** 2026-10-16 · **Change:** minor (M2.2: syntax highlighting, `editor.reveal`) · **Target:** JetBrains PhpStorm 2026.x, described from public documentation only Lutra is a clean-room, open-source PHP IDE with a Rust core and a Tauri + Vue interface, targeting the PhpStorm workflow. Agents can drive all of it over MCP, the `lutra` CLI and a JSON control channel. This page is the summary; the evidence is in [`docs/target-app-parity.md`](docs/target-app-parity.md) and the work list in [`docs/gaps.md`](docs/gaps.md). **Why pre-alpha:** M0 built the foundation (workspace, quality gate, command registry with panic guard, control channel, a themed window). M1 lets you open a folder, browse it in the project tree, edit and save files in tabs, get unsaved text back after a crash, run every command from a palette and change settings and the theme in a settings dialog, but as plain text: no PHP feature (highlighting, completion, navigation) exists yet. M1–M3 deliver the MVP. ## Headline numbers | | Value | Kind | |---|---|---| | **Feature breadth** (PhpStorm's actions, tool windows, languages, integrations exist) | **<1%** (project tool window, editor tabs; no inventory to count against yet) | estimated | | **Feature depth** (weighted by use, scored by behaviour) | **~1.7%** (Editor core 10% × weight 12, Project view 8% × weight 6, Settings 7% × weight 1, of 101) | estimated | | **To MVP (M3)** | **~13 h left** (M1 done in ~5.6 h measured: C1 2.5 h, C2 3.1 h; M2 ~5 h, M3 ~8 h); was ~190 h before calibration | estimated (×0.1; C1 factor 0.07, C2 factor 0.10) | | **To full parity** | **~330 h** if the speed of cycles C1 and C2 holds (range 300–3,300 h; deep areas such as type inference and inspections have no data yet) | estimated | Hours are agent wall-clock hours for one agent. M0 took about 2 h of active agent time (measured from the session, excluding toolchain installation and waiting for owner decisions). Later milestones are estimated far more conservatively per line of code, because editor, language and UI work need integration, debugging and visual checks that the foundation did not. Estimates are recalibrated after each cycle from task start times and commit timestamps. Cycle C1 (M1.1–M1.6) took 2.5 h of agent time for 37 h estimated (factor 0.07); M1–M3 hours are scaled by ×0.1 since then, and the per-area hours below are the raw first estimates (multiply by ~0.1 for the calibrated value). PhpStorm is **not** inspected: the clean-room rule in [`AGENTS.md`](AGENTS.md) forbids it, so everything is measured from our code against public documentation. ## By dimension Dimension hours overlap: language, framework and tooling hours are part of the feature total. | Dimension | % | One agent (h) | Doc | |---|---:|---:|---| | Features (depth) | ~1.6% | ~2,920 | [target-app-parity.md](docs/target-app-parity.md) | | UI/UX fidelity | 1% (est.) | ~150 on top of features | [ui-parity.md](docs/ui-parity.md) | | PHP language support | 0% | ~920 (in features) | [language-parity.md](docs/language-parity.md) | | Frameworks (Symfony, Laravel, Shopware, WordPress) | 0% | ~300 (in features) | [framework-parity.md](docs/framework-parity.md) | | Tooling (Git, terminal, debugger, tests, Composer, DB) | 0% | ~730 (in features) | [tooling-parity.md](docs/tooling-parity.md) | | Localization (en, de) | 5% | ~38 | [localization-parity.md](docs/localization-parity.md) | | Performance | 0% | ~100 | [gaps.md › G12](docs/gaps.md) | | Stability | 8% | ~95 | [gaps.md › G11](docs/gaps.md) | | Agent automation | 10% | ~60 | AGENTS.md | Stability 8%: no-panic lints, the engine guard, a fuzzed control protocol and a crash-recovery journal for unsaved buffers (property-tested: random edits, crash, restore) exist; the journal is not yet checked in the running app. Agent automation 10%: the control channel (ping, execute, listCommands, screenshot) works, and since M1.8 it also reaches the frontend's UI commands (opening the palette, toggling the project tree) through the `uiCommand` event; MCP and the CLI do not exist yet. Both are estimated. Localization 5% (estimated): every UI string comes from an English catalog enforced by lint; engine messages, the language switch and German are missing. UI/UX fidelity 1% (estimated): light and dark themes switch live and pass a WCAG AA contrast test; the rest of the ui-parity checklist is open. ## Features | Area | % | One agent (h) | |---|---:|---:| | Editor core (buffers, undo, multi-caret, folding, soft wrap) | 10% (est.) | ~104 | | Project view, VFS, file watching | 8% (est.) | ~40 | | Navigation (go to class/file/symbol, recent files, structure) | 0% | ~120 | | Search and replace (in file, in project, structural) | 0% | ~80 | | Code completion | 0% | ~250 | | Inspections and quick-fixes | 0% | ~300 | | Refactoring | 0% | ~250 | | Code style and formatting | 0% | ~120 | | Version control (Git) | 0% | ~150 | | Terminal | 0% | ~30 | | Run configurations | 0% | ~50 | | Debugger (Xdebug) | 0% | ~120 | | Testing (PHPUnit, Pest) | 0% | ~80 | | Composer and PHP interpreters | 0% | ~50 | | Frameworks | 0% | ~300 | | Database tools | 0% | ~250 | | HTTP client | 0% | ~60 | | Web languages (JS/TS, Vue, CSS, Twig, Blade) | 0% | ~200 | | Docker and remote | 0% | ~120 | | Settings, keymaps, themes | 7% (est.) | ~60 | | Plug-ins and ecosystem | 0% | ~120 | | AI features | 0% | ~60 | All hours estimated. Weights, evidence and the missing items per area: [target-app-parity.md](docs/target-app-parity.md). ## Upcoming 1. **M2 syntax and search (~5 h):** highlighting, file structure, find in files, go to file/class/symbol. 2. **M3 language server, terminal and CLI (~8 h):** completion, diagnostics, go to definition via Phpactor; terminal; `lutra` CLI and MCP. **MVP.** 3. **Then:** Git (M4), debugger, tests and Composer (M5), own indexer and frameworks (M6). ## Progress log | Date | What landed | |---|---| | 2026-10-16 | M2.2: PHP files are highlighted (with the HTML around `