M0: import starter package (rules, roadmap, progress docs)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-10-13 20:22:22 +02:00
commit 1fc46daa8e
22 changed files with 790 additions and 0 deletions

83
ROADMAP.md Normal file
View file

@ -0,0 +1,83 @@
# Lutra Roadmap
**Stage: pre-alpha (planning)** · next: 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-13 · **Last updated:** 2026-10-13 · **Change:** major (initial roadmap) · **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:** nothing is built yet. Milestone M0 creates the workspace, the quality gate and an empty window; M1–M3 deliver the MVP.
## Headline numbers
| | Value | Kind |
|---|---|---|
| **Feature breadth** (PhpStorm's actions, tool windows, languages, integrations exist) | **0%** | measured |
| **Feature depth** (weighted by use, scored by behaviour) | **0%** | measured |
| **To MVP (M3)** | to be estimated after M0 | — |
| **To full parity** | to be estimated after M0 | — |
Hours are agent wall-clock hours. They are first estimated at the end of M0 and calibrated from merged-commit timestamps after that. 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 | % | One agent (h) | Doc |
|---|---:|---:|---|
| Features (depth) | 0% | — | [target-app-parity.md](docs/target-app-parity.md) |
| UI/UX fidelity | 0% | — | [ui-parity.md](docs/ui-parity.md) |
| PHP language support | 0% | — | [language-parity.md](docs/language-parity.md) |
| Frameworks (Symfony, Laravel, Shopware, WordPress) | 0% | — | [framework-parity.md](docs/framework-parity.md) |
| Tooling (Git, terminal, debugger, tests, Composer, DB) | 0% | — | [tooling-parity.md](docs/tooling-parity.md) |
| Localization (en, de) | 0% | — | [localization-parity.md](docs/localization-parity.md) |
| Performance | 0% | — | [gaps.md › G12](docs/gaps.md) |
| Stability | 0% | — | [gaps.md › G11](docs/gaps.md) |
| Agent automation | 0% | — | AGENTS.md |
## Features
| Area | % | One agent (h) |
|---|---:|---:|
| Editor core (buffers, undo, multi-caret, folding, soft wrap) | 0% | — |
| Project view, VFS, file watching | 0% | — |
| Navigation (go to class/file/symbol, recent files, structure) | 0% | — |
| Search and replace (in file, in project, structural) | 0% | — |
| Code completion | 0% | — |
| Inspections and quick-fixes | 0% | — |
| Refactoring | 0% | — |
| Code style and formatting | 0% | — |
| Version control (Git) | 0% | — |
| Terminal | 0% | — |
| Run configurations | 0% | — |
| Debugger (Xdebug) | 0% | — |
| Testing (PHPUnit, Pest) | 0% | — |
| Composer and PHP interpreters | 0% | — |
| Frameworks | 0% | — |
| Database tools | 0% | — |
| HTTP client | 0% | — |
| Web languages (JS/TS, Vue, CSS, Twig, Blade) | 0% | — |
| Docker and remote | 0% | — |
| Settings, keymaps, themes | 0% | — |
| Plug-ins and ecosystem | 0% | — |
| AI features | 0% | — |
Weights, evidence and the missing items per area: [target-app-parity.md](docs/target-app-parity.md).
## Upcoming
1. **M0 foundation:** workspace, lints, quality gate, command registry, control channel, empty window.
2. **M1 editor and project:** open folder, project tree, tabs, editor, save and recovery, command palette, themes.
3. **M2 syntax and search:** highlighting, file structure, find in files, go to file/class/symbol.
4. **M3 language server, terminal and CLI:** completion, diagnostics, go to definition via Phpactor; terminal; `lutra` CLI. **MVP.**
5. **Then:** Git (M4), debugger, tests and Composer (M5), own indexer and frameworks (M6).
## Progress log
| Date | What landed |
|---|---|
| 2026-10-13 | Project started: name, conventions, agent rules and progress docs. |
## Revision history
| Date | Change | Summary |
|---|---|---|
| 2026-10-13 | major | Initial roadmap |