M0.9: first estimates for M1-M3 and full parity
MVP (M1-M3) about 190 agent hours, full parity about 3,300 hours (range 2,000-5,000), all marked estimated. M0 measured at about 2 hours of active agent time. Hours per area in target-app-parity, per gap in gaps.md and per milestone in roadmap.md; ROADMAP and README status updated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
03cea63143
commit
b2bf769188
5 changed files with 128 additions and 97 deletions
43
docs/gaps.md
43
docs/gaps.md
|
|
@ -1,30 +1,37 @@
|
|||
# Gaps
|
||||
|
||||
> **Status:** initial list · **Last updated:** 2026-10-13
|
||||
> **Status:** M0 closed G1; estimates added · **Last updated:** 2026-10-14
|
||||
|
||||
Every known shortfall, ranked. This is the work list: unless the owner gives a task, take the highest open gap.
|
||||
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 | M0 | after M0 planning |
|
||||
| G2 | Editor core: buffers, undo, multi-caret, save, recovery journal | M1 | — |
|
||||
| G3 | Project model: VFS, file watching, project tree, tabs | M1 | — |
|
||||
| G4 | Syntax and structure: tree-sitter PHP, highlighting, file structure | M2 | — |
|
||||
| G5 | Search and navigation: find in files, go to file/class/symbol | M2 | — |
|
||||
| G6 | Language server: completion, diagnostics, definition, hover, rename via Phpactor | M3 | — |
|
||||
| G7 | Terminal and `lutra` CLI | M3 | — |
|
||||
| G8 | Git integration | M4 | — |
|
||||
| G9 | Debugger, test runner, Composer, run configurations | M5 | — |
|
||||
| G10 | Own indexer, inspections, refactorings | M6 | — |
|
||||
| G11 | Stability: crash-free operation on real projects and machines | ongoing | — |
|
||||
| G12 | Performance budgets: start, open, type, search, index | ongoing | — |
|
||||
| G13 | Frameworks: Symfony, Laravel, Shopware, WordPress | M6 | — |
|
||||
| G14 | Localization: English and German interface | later | — |
|
||||
| G15 | Database tools, HTTP client, Docker and remote | later | — |
|
||||
| G16 | Plug-ins and ecosystem | later | — |
|
||||
| G1 | ~~Foundation: workspace, quality gate, command registry, guard, control channel~~ closed 2026-10-14 | M0 | done (~2 h measured) |
|
||||
| G2 | Editor core: buffers, undo, multi-caret, save, recovery journal | M1 | ~30 h |
|
||||
| G3 | Project model: VFS, file watching, project tree, tabs; command palette, settings, theme switching | M1 | ~30 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 | ongoing | ~100 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 | later | ~40 h |
|
||||
| G15 | Database tools, HTTP client, Docker and remote | later | ~430 h |
|
||||
| G16 | Plug-ins and ecosystem | later | ~120 h |
|
||||
|
||||
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-14 | minor | G1 closed; estimates for G2–G16; M0 follow-ups |
|
||||
| 2026-10-13 | major | Initial gap list |
|
||||
|
|
|
|||
|
|
@ -1,16 +1,18 @@
|
|||
# Milestones
|
||||
|
||||
> **Status:** current focus M0 · **Last updated:** 2026-10-13
|
||||
> **Status:** M0 done, current focus M1 · **Last updated:** 2026-10-14
|
||||
|
||||
| Milestone | Goal | State |
|
||||
|---|---|---|
|
||||
| M0 | Foundation: workspace, lints, quality gate, command registry, control channel, empty window | not started |
|
||||
| M1 | Editor and project: open folder, tree, tabs, editor, save, recovery, palette, settings, themes | not started |
|
||||
| M2 | Syntax and search: highlighting, structure, find in files, go to file/class/symbol | not started |
|
||||
| M3 | LSP, terminal, CLI: completion, diagnostics, go to definition, hover, rename; terminal; `lutra` CLI — **MVP** | not started |
|
||||
| M4 | Git: status, diff, commit, branches, log, blame, conflicts | not started |
|
||||
| M5 | Debugger (Xdebug via DAP), PHPUnit/Pest runner, Composer, run configurations | not started |
|
||||
| M6 | Own indexer and inspections; Symfony, Laravel, Shopware, WordPress support | not started |
|
||||
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 | not started | ~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
|
||||
|
||||
|
|
@ -23,8 +25,11 @@ Alpha is reached when these six core workflows work end to end on macOS, Windows
|
|||
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 | M0 done; hours per milestone |
|
||||
| 2026-10-13 | major | Initial milestones |
|
||||
|
|
|
|||
|
|
@ -1,42 +1,56 @@
|
|||
# Target-app parity
|
||||
|
||||
> **Status:** baseline, nothing ships · **Last updated:** 2026-10-13 · **Target:** PhpStorm 2026.x
|
||||
> **Status:** baseline after M0, no PHP feature ships · **Last updated:** 2026-10-14 · **Target:** PhpStorm 2026.x
|
||||
|
||||
## How this is measured
|
||||
|
||||
Each feature area gets a weight (how much a typical PHP developer uses it) and a score (how much of the documented behaviour Lutra has, judged by behaviour, not by menu items). The headline depth is the weighted sum. Every score is marked measured or estimated and must point to evidence (tests, commands, screenshots of Lutra). Behaviour references come from public PhpStorm documentation only, noted with URLs in `plan/phpstorm/`.
|
||||
|
||||
Hours are the estimated agent wall-clock hours for one agent to reach behaviour parity in the area, from zero. They are first estimates made at the end of M0 and are recalibrated after each milestone from merged-commit timestamps.
|
||||
|
||||
## Feature areas
|
||||
|
||||
| Area | Weight | Score | Missing | Hours (one agent) | Evidence |
|
||||
|---|---:|---:|---|---:|---|
|
||||
| Editor core | 12 | 0% | everything | — | — |
|
||||
| Project view, VFS | 6 | 0% | everything | — | — |
|
||||
| Navigation | 10 | 0% | everything | — | — |
|
||||
| Search and replace | 6 | 0% | everything | — | — |
|
||||
| Code completion | 10 | 0% | everything | — | — |
|
||||
| Inspections and quick-fixes | 8 | 0% | everything | — | — |
|
||||
| Refactoring | 7 | 0% | everything | — | — |
|
||||
| Code style and formatting | 4 | 0% | everything | — | — |
|
||||
| Git | 8 | 0% | everything | — | — |
|
||||
| Terminal | 3 | 0% | everything | — | — |
|
||||
| Run configurations | 2 | 0% | everything | — | — |
|
||||
| Debugger | 5 | 0% | everything | — | — |
|
||||
| Testing | 4 | 0% | everything | — | — |
|
||||
| Composer and interpreters | 2 | 0% | everything | — | — |
|
||||
| Frameworks | 5 | 0% | everything | — | — |
|
||||
| Database tools | 3 | 0% | everything | — | — |
|
||||
| HTTP client | 1 | 0% | everything | — | — |
|
||||
| Web languages | 2 | 0% | everything | — | — |
|
||||
| Docker and remote | 1 | 0% | everything | — | — |
|
||||
| Settings, keymaps, themes | 1 | 0% | everything | — | — |
|
||||
| Plug-ins | 0.5 | 0% | everything | — | — |
|
||||
| AI features | 0.5 | 0% | everything | — | — |
|
||||
| Editor core | 12 | 0% | everything | ~120 (est.) | — |
|
||||
| Project view, VFS | 6 | 0% | everything | ~40 (est.) | — |
|
||||
| Navigation | 10 | 0% | everything | ~120 (est.) | — |
|
||||
| Search and replace | 6 | 0% | everything | ~80 (est.) | — |
|
||||
| Code completion | 10 | 0% | everything | ~250 (est.) | — |
|
||||
| Inspections and quick-fixes | 8 | 0% | everything | ~300 (est.) | — |
|
||||
| Refactoring | 7 | 0% | everything | ~250 (est.) | — |
|
||||
| Code style and formatting | 4 | 0% | everything | ~120 (est.) | — |
|
||||
| Git | 8 | 0% | everything | ~150 (est.) | — |
|
||||
| Terminal | 3 | 0% | everything | ~30 (est.) | — |
|
||||
| Run configurations | 2 | 0% | everything | ~50 (est.) | — |
|
||||
| Debugger | 5 | 0% | everything | ~120 (est.) | — |
|
||||
| Testing | 4 | 0% | everything | ~80 (est.) | — |
|
||||
| Composer and interpreters | 2 | 0% | everything | ~50 (est.) | — |
|
||||
| Frameworks | 5 | 0% | everything | ~300 (est.) | — |
|
||||
| Database tools | 3 | 0% | everything | ~250 (est.) | — |
|
||||
| HTTP client | 1 | 0% | everything | ~60 (est.) | — |
|
||||
| Web languages | 2 | 0% | everything | ~200 (est.) | — |
|
||||
| Docker and remote | 1 | 0% | everything | ~120 (est.) | — |
|
||||
| Settings, keymaps, themes | 1 | 0% | settings UI, keymaps, theme switching (theme tokens exist in `lutra_engine::theme`) | ~60 (est.) | — |
|
||||
| Plug-ins | 0.5 | 0% | everything | ~120 (est.) | — |
|
||||
| AI features | 0.5 | 0% | everything | ~60 (est.) | — |
|
||||
|
||||
Weights are a first estimate and are reviewed at the end of M0.
|
||||
Sum: about 2,930 h. Adding UI fidelity (~150 h), localization (~40 h), performance (~100 h) and stability hardening (~100 h) gives the ROADMAP's ~3,300 h to full parity. The range is wide (2,000–5,000 h): completion, inspections, refactoring and frameworks depend on an own type-inference engine whose size is hard to judge before M6.
|
||||
|
||||
Weights were reviewed at the end of M0 and kept: nothing built so far gives a reason to change them.
|
||||
|
||||
## What ships (M0, 2026-10-14)
|
||||
|
||||
No PHP feature. The foundation, verified on Windows 11:
|
||||
|
||||
- `cargo xtask ci` passes all 13 steps (fmt, clippy with no-panic lints, tests, lints self-test, layers, assets, clean-room, cargo-deny licences, pnpm install, ESLint, vue-tsc, Vitest, frontend licences).
|
||||
- Commands `app.about` and `app.quit` with unit tests; a panicking command is caught by the guard (`crates/engine/src/engine.rs` tests).
|
||||
- Control channel: `app.ping`, `engine.execute`, `engine.listCommands`, `ui.screenshot`, with proptests and a TCP integration test (`crates/control`), and checked against the running app.
|
||||
- The desktop window opens themed from Rust tokens and shows the product name and version that the frontend gets from `app.about` over IPC.
|
||||
|
||||
## Revision history
|
||||
|
||||
| Date | Change | Summary |
|
||||
|---|---|---|
|
||||
| 2026-10-14 | minor | Hours per area, weights reviewed, M0 evidence |
|
||||
| 2026-10-13 | major | Baseline |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue