Release v0.5.0: CodeMirror 6 file editor, Push-to-Talk STT, session compaction, AI plans, named terminals & UI Enhancements!

[iptoux]

Summary

This PR merges the v0.5.0 release staging branch into main. It collects every change currently listed under ## [Unreleased] in CHANGELOG.md, plus the accompanying documentation, plan, and screenshot updates that ship with them.

The release is anchored by five headline areas:

• CodeMirror 6 file editor — preview and edit now share one editor (read-only mount for preview, full editor for edit), removing the vendored highlight.js bundle and its heuristic fold model.
• Push-to-Talk speech-to-text — local-first STT via a warm whisper.cpp engine with a managed model catalog (downloads with resume / progress / speed, sha256-verified, Use / Delete), and an optional cloud mode that reuses the existing OpenAI / OpenRouter STT providers. New collision state machine keeps PTT from clashing with the agent voice orb or TTS playback.
• Session compaction & context-window tooling — context-window usage meter in the chat header, configurable tool-loop limit, and a Compact button plus auto-compact once the meter crosses a threshold.
• AI-generated plans & tasks — new AI Plan / AI Tasks header buttons in the Plans panel, backed by the existing one-shot oneshot::complete_text provider path.
• Named terminals & 10 new light themes — editable terminal name pool with per-slot overrides (the BLXCode Agent knows the names), plus ten new light themes (five brand counterparts and five custom designs) and a new "Claude Code" dark theme.

It also bundles a set of editor/UX refactors (unified Send/Stop toggle, merged thinking blocks, off-main-thread memory indexing), small bugfixes, a documentation pass (User + Developer guides, release notes, plans, screenshot rename), and the removal of the highlight.js dependency.

---

What's included

Added

• Push-to-Talk speech-to-text (Settings → Voice → Push-to-Talk, new ShortcutAction::PushToTalk with default Ctrl+Shift+Space) — hold a key, speak, transcript is routed to agent composer / terminal / active input / clipboard; remember target at PTT start; live partial transcript (default on) via a throttled re-decode worker; VoiceRuntimeState collision machine (TTS = Stop / Pause / Block); backend under src-tauri/src/voice/{ptt,models,stt}; commands ptt_start/partial/finalize/cancel, voice_tts_playing, voice_agent_input_active. Closes feat(voice): Push-to-Talk speech-to-text (local whisper.cpp + cloud) #49.
• Whisper model manager (in the Push-to-Talk section, local mode) — filterable catalog of whisper.cpp GGML weights (filter tabs: All / Standard / Quantized / Turbo / Large), per-model size, language, speed / accuracy ratings and "best for" hint, resumable downloads with live progress + transfer speed (MB/s), sha256-verified atomic install, Use / Delete per installed model, models stored under <app-data>/voice/models/<id>.bin. Local engine compiled behind the local-whisper cargo feature (default build is cloud-only). Covered by feat(voice): Push-to-Talk speech-to-text (local whisper.cpp + cloud) #49.
• AI-generated plans & tasks — AI Plan (LuSparkles) and AI Tasks (LuListPlus) header buttons open a dialog that turns a short prompt into a full Markdown plan via the agent tab's configured provider/model; reuses the existing one-shot oneshot::complete_text path; Skill-conformant system prompt; Save / Regenerate / Cancel; toggle for creating tasks alongside the plan (forced on in AI Tasks mode); shimmer loading animation; themed scrollable Markdown preview. Closes feat(plans): AI-generated plans & tasks dialog #48.
• Configurable tool-loop limit — number field in Settings → Agent (range 1–500, default 36) replaces the hard-coded MAX_ROUNDS = 36; clamped on save and at the call site; drives both the OpenAI-compatible and Anthropic coordinator loops. Closes feat(agent): Configurable tool-loop limit (Settings → Agent) #32.
• Context-window usage meter — used / max · NN% bar in the chat header, color-shifts past 70% (warning) and 85% (danger); max resolved from the provider's model metadata with a static fallback table for direct providers; tracks the newest main-agent round's prompt size (true window occupancy), not the cumulative cost-sum, and excludes subagent rounds. Closes feat(agent): Context-window usage meter in chat header #33.
• Session compaction — new Compact button in the chat header summarizes the conversation into a dense briefing and starts fresh from it; auto-compact (on by default, configurable threshold 50–95%) runs the same path automatically once occupancy crosses the threshold; fires only between turns, re-arms only after occupancy falls back below. Closes feat(agent): Session compaction with auto-compact threshold #34.
• Plan card quick actions — collapsed plan card header gains Load into BLXCode Agent (LuBot), Rename (LuFilePenLine), and Remove (LuTrash2, danger) directly; hidden when the card is expanded; disabled on the PLANS.md index entry. Closes feat(plans): Plan card quick actions (Load / Rename / Remove) #35.
• Ten new light themes — catalog grows from 20 to 30: Tokyo Night Light, Nord Light, GitHub Light, Ayu Light, Atom One Light, plus Winter Light, Paper Light, Alpine Light, Frost Light, Lilac Light; every theme ships a complete token set. Closes feat(themes): Ten new light themes (catalog 20 → 30) #36.
• Collapsible plan status groups with descriptions — every status group in the Plans All view (Blocked / In progress / Pending / Completed / Cancelled / Empty) is now a toggle button with a chevron and a one-line description; PLANS.md index file is no longer listed as a plan card. Closes feat(plans): Collapsible plan status groups with descriptions #37.
• Named terminals — Settings → Workspace → Terminal naming with a global toggle, editable name pool, and deterministic collision-free assignment keyed by slot_id; double-click the titlebar or use the right-click Rename / Reset name menu to override; harness.list_terminals returns name + namingMode, and harness.send_terminal_keys / send_agent_context / read_terminal_output accept a name argument (case-insensitive). Closes feat(terminal): Named terminals with editable name pool and per-slot overrides #38.
• "Claude Code" dark theme — warm-charcoal dark theme with Claude's signature coral accent #d97757; replaces the near-redundant github-dark slot. Closes feat(themes): Claude Code dark theme (replaces github-dark) #39.
• Rules, Skills, and Plans filtering — Rules and Skills panels share a category filter row, themed separator, and live search (filter by title, description, source/category metadata, and category selection); Plans panel mirrors the search with a field below the status filter tabs. Skills tab is now scoped to user/workspace skills under .agents/skills only (internal core harness skills are hidden from the UI but stay available to the agent backend). Closes feat(panels): Rules, Skills, and Plans filtering #50.

Changed

• File preview now uses the same CodeMirror 6 editor as edit mode, mounted read-only — reading and editing are now visually identical (same syntax highlighting, line-number gutter, code folding, selection); the right-click handoff menu works in both modes. Closes refactor(editor): Unify file preview and edit mode on CodeMirror 6 #40.
• Chat Send / Stop is now a single toggle button — flips between Send (sparkles) while idle and Stop (square, abort styling) while a turn is running. Closes refactor(chat): Unified Send / Stop toggle button #41.
• Thinking blocks now merge into the following model-round line — when a finished Thinking block is immediately followed by a tool-bearing MODEL ROUND, the two collapse into one row; rounds without groupable tools, and still-streaming thinking, keep their standalone rows. Closes refactor(agent): Merge thinking blocks into following model-round line #42.
• Architecture / memory indexing runs off the main thread — first-touch architecture rebuild and memory_rebuild_architecture / memory_lint_architecture are now async commands that offload CPU/IO-bound work to spawn_blocking, so the window keeps pumping events. Closes refactor(memory): Move architecture/memory indexing off the main thread #43.
• Rules and skills share the same category model — each rule or skill can declare one optional category in Markdown frontmatter and its .agents/*/index.json entry (multiple entries can share the same category); legacy rule tags arrays are migrated at read time by taking the first tag as the category; rule and skill cards show the category in the same compact chip style in collapsed and expanded states. Closes refactor(meta): Rules and skills use category instead of tags #51.
• Remote (SSH) settings redesigned as a master/detail view — saved presets now render as a grid of compact connection cards (RemoteConnectionCard) inside a framed section card, each showing the name, user@host:port, auth method, session-resume mode, a masked Stored / Not set secret badge, and the default remote directory (no secret values ever leave the backend). Clicking a card (or the new top-right Add connection button) opens a dedicated editor view (RemoteConnectionEditor) with a Back to connections header and a New connection / Edit connection title; Save and Delete return to the refreshed list. The 670-line module was split per the repo's component rules into mod.rs (orchestration + shared helpers) / connection_card.rs / connection_editor.rs with co-located, token-only CSS. Four new i18n keys (RemoteNewConnection, RemoteEditConnection, RemoteBackToList, RemoteCardEditHint) are translated across all 14 locales. Closes refactor(remote): Redesign SSH settings pane as master/detail view #54.

Fixed

• Plan card quick Remove button border no longer stands out — the quick variant keeps the subtle icon-button border at rest and only resolves to a danger tint on hover. Closes fix(plans): Plan card quick Remove button border styling #44.
• Model-round rows show sequential line numbers — display line number is decoupled from the stable_index hash key and threaded through explicitly. Closes fix(agent): Model-round rows show nonsensical line numbers #45.
• Per-message Play (TTS) button only appears when voice chat is configured — visible only when TTS is enabled and the selected TTS provider actually has an API key set. Closes fix(voice): Per-message TTS Play button visibility tied to provider key #46.
• Rules panel descriptions and sidebar typography now line up with the rest of the workbench — rule summaries skip YAML frontmatter and correctly use the paragraph below ## Ziel instead of rendering the heading itself, while the File Diff and Git Commits sidebar sections use the same compact font sizing as the Project Files tree. Closes fix(rules): Rules panel descriptions and sidebar typography alignment #52.
• Push-to-Talk errors are now surfaced as localized toasts — PTT start failures show the existing microphone error, busy/TTS-collision rejects show the same message as the indicator hint, finalize failures map to no-model / model-load / generic transcription messages, and failed transcript insertion into the clipboard, active terminal, or active text input now reports VoicePttInsertFailed. Closes fix(voice): Push-to-Talk errors surfaced as localized toasts #53.

Removed

• highlight.js dependency removed — the file preview no longer ships or lazy-loads the vendored highlight.js bundle (~127 KiB); the heuristic Rust fold model is gone; a single CodeMirror 6 bundle drives both preview and edit. Closes chore(deps): Remove highlight.js dependency from file preview #47.

---

Documentation

• User docs — docs/user/voice.md Push-to-Talk section (Settings → Voice, model manager, target routing, collision behaviour, troubleshooting); docs/user/file-preview.md updates for the CodeMirror 6 editor; docs/user/workspaces.md Center-tabs section, terminal naming section; docs/user/plans.md AI Plan / AI Tasks dialog, quick actions, collapsible groups; docs/user/settings.md Agent pane updates (tool-loop limit, context meter, auto-compact); docs/user/getting-started.md boot loading screen; docs/user/appearance-themes.md new light themes + Claude Code dark; docs/user/remote.md Remote settings master/detail view + connection card / editor.
• Developer docs — docs/developer/voice.md backend architecture, VoiceRuntimeState state machine, local-whisper feature flag, PttSettings envelope, command surface, event channel, model catalog + download pipeline, resume-range logic, key-chord migration.
• Plans & release notes — .agents/plans/voice-push-to-talk-stt.md (status: done), .agents/plans/voice-ptt-concurrency-error-review.md (follow-up), .agents/plans/PLANS.md index updated, docs/releases/v0.3.3.md finalized.
• Screenshots — renamed 21 screenshot-*.png / Screenshot *.png files in docs/images/ to meaningful names; removed 9 md5-identical duplicates; references updated across README.md and docs/.

Notes

See CHANGELOG.md [Unreleased] for the full detailed change list. Companion plan files live under .agents/plans/. This PR resolves the v0.5.0 milestone (#32 through #49) and five follow-up [Unreleased] items filed in this release window (#50 through #54) — 23 issues in total.

[iptoux]

Latest implementations on stage (not yet linked in this PR)

The stage branch carries four changes from CHANGELOG.md → [Unreleased] that are not covered by the Closes #N lines in this PR's description. The corresponding issues are open and already labeled done + pr-pending — i.e. they are part of the v0.5.0 scope in practice but are not linked here.

Issue	CHANGELOG bucket	Title
#50	Added	Rules, Skills, and Plans filtering (shared category filter row, themed separator, live search)
#51	Changed	Rules and skills use category instead of tags (frontmatter + index.json, legacy tags migrated)
#52	Fixed	Rules panel descriptions and sidebar typography alignment (## Ziel paragraph + File Diff / Git Commits sizing)
#53	Fixed	Push-to-Talk errors surfaced as localized toasts (start / busy-TTS / finalize / insertion)

All four are already merged on stage. If they should ride with this release, please add Closes #50, Closes #51, Closes #52, Closes #53 to the PR description (or push them as a follow-up); otherwise they will be left behind when this PR merges.

Details

#50 — Rules, Skills, and Plans filtering

• Rules and Skills share the same category filter row, themed separator, and live search structure; entries are filtered by title, description, source/category metadata, and category selection.
• Skills tab is now scoped to user/workspace skills under .agents/skills only (hides the internal core harness skills from the UI while keeping them available to the agent backend).
• Plans panel mirrors the interaction with its own live search field below the status filter tabs, combining text search with the active status filter.

#51 — Rules and skills use category instead of tags

• Each rule or skill can declare one optional category in Markdown frontmatter and in its .agents/*/index.json entry; multiple entries can share the same category.
• Legacy rule tags arrays are migrated at read time by taking the first tag as the category.
• Rule and skill cards show the category in the same compact chip style in both collapsed and expanded states.

#52 — Rules panel descriptions and sidebar typography

• Rule summaries skip YAML frontmatter and now use the paragraph below ## Ziel instead of rendering the heading itself.
• File Diff and Git Commits sidebar sections now use the same compact font sizing as the Project Files tree.

#53 — Push-to-Talk errors surfaced as localized toasts

• Start failures show the existing microphone error.
• Busy / TTS-collision rejects show the same message as the indicator hint.
• Finalize failures map to no-model / model-load / generic transcription messages.
• Failed transcript insertion into the clipboard, active terminal, or active text input now reports VoicePttInsertFailed.

[iptoux]

Follow-up: new ticket filed and PR description updated

A new [Unreleased] entry landed on stage after the previous comment — the Remote (SSH) settings master/detail view redesign (commits 7017bfd + e32b349): saved presets now render as a grid of compact connection cards inside a framed section card, and clicking one (or Add connection) opens a dedicated editor view. The 670-line module was split per the repo's component rules into mod.rs / connection_card.rs / connection_editor.rs with co-located, token-only CSS, and four new i18n keys are translated across all 14 locales.

It did not have a tracking ticket, so I filed one:

• refactor(remote): Redesign SSH settings pane as master/detail view #54 — refactor(remote): Redesign SSH settings pane as master/detail view — labeled done + pr-pending + refactor. Body cross-references CHANGELOG.md → [Unreleased] / Changed.

PR description

While I was at it, I also wired up the four issues called out in the previous comment (#50, #51, #52, #53) so they auto-close on merge, and added a matching bullet for the new #54. The PR description now Closes-links all 23 issues in this release window:

Section	Closes
Added	#32, #33, #34, #35, #36, #37, #38, #39, #48, #49, #50
Changed	#40, #41, #42, #43, #51, #54
Fixed	#44, #45, #46, #52, #53
Removed	#47

What's included gained five new bullets (one per added issue) in the right sections, and the Notes line now reads:

This PR resolves the v0.5.0 milestone (#32 through #49) and five follow-up [Unreleased] items filed in this release window (#50 through #54) — 23 issues in total.

Documentation also picked up a docs/user/remote.md line for the new connection card / editor view, matching the existing per-area user-doc convention.

No code changes — description and tracking only.