docs: re-point PROJECT_STATE.md and PLAN.md at what is actually current

[JDonaghy]

Why

CLAUDE.md's Session Start Protocol tells every new agent to read PROJECT_STATE.md and PLAN.md first. Both were describing waves that closed months ago, so a session following that protocol rebuilt a picture from May and planned against it.

• PROJECT_STATE.md (last updated May 19) said "Active milestone: Cross-Platform UI Crate" and tracked the Migrate GTK widget tree to quadraui AppShell + run_with_shell() #447 → Full GTK run_with_shell migration: collapse 14 DAs to 1, strip Relm4 #493 → Migrate GTK event dispatch to ShellApp::handle(UiEvent) #448 → Migrate GTK click dispatch to FrameHitMap #449 GTK convergence chain as in-flight. That chain closed 2026-08-26.
• PLAN.md (last updated Jul 23) said "Current wave: TUI → ShellApp, pick up at Stage 3." TUI: migrate to quadraui ShellApp + run_with_shell (mirrors #493's GTK migration) #595 closed with all ten stages landed and event_loop() deleted.

What changed

PROJECT_STATE.md — active milestone is now #7 Platform-Neutral, with GOALS.md named as the north star and the #5-supply / #7-consume split spelled out. Adds the 2026-09-01 audit:

• Done — Migrate GTK event dispatch to ShellApp::handle(UiEvent) #448/TUI: migrate to quadraui ShellApp + run_with_shell (mirrors #493's GTK migration) #595, #592-A: GTK live path — paint the five editor overlay popups (completion, hover, editor_hover, diff_peek, signature_help) #669–#592-D: register GTK scroll surfaces + hit-test caches on the live path, then delete src/gtk/draw.rs #672 + draw.rs deletion, GTK: the VS Code-style Command Center (nav arrows + search box) was dropped by the #540 Relm4→ShellApp cutover and never re-wired #676, the vimcode: delete local fuzzy_score/fuzzy_score_with_positions — quadraui::text_util now ships equivalent logic (quadraui#474) #621/Adopt promoted quadraui helpers: driver tab geometry + SidebarSystem reveal #659/Retire four vimcode duplicates of logic quadraui already ships (tab scroll, measure, hit shim, split tree) #660/Migrate activity-bar keyboard nav onto quadraui AppShell (retire hand-rolled toolbar_selected arithmetic) — consume quadraui#386 #536 dedup sweep. Milestone Release v0.3.4 — bug fixes #7 at 29 closed / 4 open.
• Open, and what actually gates each — GTK live render path silently drops 13 populated ScreenLayout fields (rest of #587's blast radius) #592 is 13 of 14, not done (ai_panel is still unpainted on GTK; #592-B: GTK live path — paint the panel surfaces (quickfix, bottom_tabs, debug_toolbar, panel_hover, ai_panel) #670 deferred it to a follow-up that was never filed, src/gtk/mod.rs:9364-9369). Ctrl+V paste silently does nothing on GTK — quadraui swallows the key, vimcode has no ClipboardPaste handler #593 unblocked. Adopt quadraui's shared preview-tab tier; delete vimcode's private copy #658 is the only supply-blocked item (quadraui#596/#480: TUI: Migrate Source Control panel (commit row, branch picker, help dialog) to shared primitives #597). Extend Lua plugin API to expose quadraui primitives #146 needs re-triage.
• Untracked residual — production line counts over time. The two backends have been flat since 2026-07-01 (23,693 → 23,723) while render.rs grew +2,420: new work is going shared, the existing per-backend mass is not coming down. Names the four pockets — mouse routing (~4,800 lines), the GTK Msg bus (124 variants / 301 sites), frame composition (~4,500), and 22 orphaned Relm4-era widget handles.
• Trust gate — Put vimcode on the oracle loop: promote gtk/render/tui_main into vimcode_core, then seal a tests/acceptance/ suite #657, including the false blocker recorded in its own body.

The cross-backend coverage table is unchanged (still accurate); its status paragraph now says what remains is not paint.

PLAN.md — the current-wave section now says there is no wave in flight and points at GOALS.md. The TUI→ShellApp wave is kept as a completed-work entry with its scoping lesson (render_content/handle only ever receive &mut dyn Backend, never a raw Frame — the reason both backend-runner migrations came in an order of magnitude over estimate), because that generalises to the next one. −226/+93 lines; the Phase B/C history below is untouched.

Testing

Docs-only (pure .md), so exempt from the black-box driver bar per CLAUDE.md.

cargo test --no-fail-fast on develop at e02a824: green, 0 failures across all 46 test binaries.

🤖 Generated with Claude Code

https://claude.ai/code/session_016N1UjBkNdxrm4YEd6oYJAz