Routa Desktop v0.19.0

Routa Desktop v0.19.0

Desktop application release. Release notes will be added manually.

Routa Desktop v0.18.1

Routa Desktop v0.18.1

Desktop application release. Release notes will be added manually.

Routa Desktop v0.18.0

🎉 Routa v0.18.0 — Task-Adaptive Intelligence & Enhanced Performance

🚀 Highlights

This release brings significant improvements to task-adaptive intelligence, performance optimization, and user experience across web and desktop platforms.

---

✨ Major Features

🧠 Task-Adaptive Intelligence & JIT Context (#515, #516, #517)

• JIT Context System: Automatic inference and loading of task-relevant context from search hints, feature trees, and file sessions
• History Memory Snapshots: Persist and reuse structured retrospective analysis for faster planning
• Task-Adaptive Harness: Dynamically surface relevant friction profiles, file signals, and feature candidates based on current task
• Session Transcript Analysis: Extract evidence-backed context summaries from agent execution traces
• MCP Integration: New tools for feature tree preload, file session summaries, and history analyst capabilities

Key Components:

• Just-in-time context inference from task metadata
• Automatic hotspot retrospective memory for task-adaptive friction profiles
• Preload history memory for planning prompts
• Feature tree context preload tool
• Structured JIT analysis snapshots

⚡ Performance & Fitness Optimization (#482)

Harness Fitness Acceleration — Comprehensive speed improvements:

• Hard-gate Fast-Fail: Exit early when critical checks fail, reducing wall-time by 40-60% in failure scenarios
• METRIC Output Format: PI-autoresearch compatible output for automated optimization loops
• Dynamic Test Mapping Degradation: Auto-downgrade expensive full graph analysis when latency exceeds thresholds
• Native Speed Profiling: Replace shell-based profiling with native Rust runtime

Performance Impact:

• fitness_ms reduction of 20%+ in typical runs
• Zero hot-path overhead for METRIC formatting (pure function)
• Automatic optimization based on historical performance data

🎯 Kanban & Workflow Enhancements (#466, #493, #499, #503)

Enhanced CLI Workflow:

• routa kanban status — Board status overview
• routa kanban list — Card list with filters
• routa kanban card-detail — Detailed card inspection
• GitHub issue workflows integration
• Desktop RPC as default backend

Global Flow Learning (#466, #499):

• AI specialist-driven analysis and actionable guidance
• Automatic detection of workflow bottlenecks
• Evidence-backed improvement suggestions

Automation & Intelligence:

• Fallback agent chain for card-level agent selection
• Lane automation with A2A (Agent-to-Agent) handoffs
• Automatic delegation for blocked cards
• Persist disabled lane automation preferences
• Save minimal history memory from analysis

🖥️ Desktop Platform Improvements (#500)

Workspace-First Tray Mode (macOS ready):

• macOS template tray icon
• Workspace-first menu bar design
• Hide background server windows on Windows (#457)
• Open markdown links via Tauri opener

Desktop Stability:

• Fix tauri sidebar spawned terminal windows
• Persist GitHub token in Rust desktop
• Respect workspace database and port configuration

📊 Feature Explorer & Spec System (#502, #516)

Agent-First Feature Tree:

• Route generation through Rust CLI for consistency
• Agent-driven feature tree generation workflow
• Quick-scan drawer with success feedback
• Preflight/commit routes with multi-root scanning
• Security: validate scanRoot inside repoRoot, resolve symlink traversal

Spec Visualization:

• Status board for local issues
• Sidebar entry with toolbar filters
• Improved repo switching and refresh feedback

---

🐛 Bug Fixes

Core Stability

• SQLite Schema: Repair worktrees table bootstrap for legacy databases (#443)
• Git Workflows: Isolate unrelated worktree dirt before review
• Session Persistence: Harden PR #506 memory persistence with retry fallbacks
• File Budget: Stop file budget panic on unicode boundaries (#entrix)
• Codex ACP: Normalize MCP injection, fix permission bubble semantics

Kanban Fixes

• Preserve detail tabs across remounts
• Gate backlog history memory on confirmed context (#521)
• Dedupe JIT context repeated signals
• Fix lane automation stalls and blocked lane convergence
• Refresh JIT context when hints change
• Persist and reuse structured history analysis (#517)

Feature Explorer Fixes

• Commit agent feature tree output
• Stop infinite applying-agent-result retry
• Sync inspector with active file
• Hide prompt context for surface selections
• Handle multibyte prompt previews safely

Desktop Fixes

• Tolerate stale repo path context in Rust API
• Dedupe repo picker, harden Safari wrapping
• Preserve Codex kanban MCP profile on resume
• Keep feature explorer file signals in routa-server

---

🔧 Technical Improvements

Architecture & Refactoring

• Extract Rust kanban board metadata helpers
• Extract A2A lane automation flow
• Satisfy Clippy warnings across harness-monitor, entrix, watchdog
• Respect gitignore in graph file walk
• Bound harness-monitor child lifetime
• Format Rust source files

Testing & Quality

• Cover A2A automation helpers and lane move-card flows
• Stabilize commit diff shadow-root assertions
• Point feature explorer signal e2e at active features
• Carry task IDs through adaptive prompts
• Cover history memory prompt preload
• Fix transcript candidate fixtures

Documentation

• Overhaul documentation system for complete sidebar coverage
• Close resolved issue trackers (#478, desktop tray, Windows sidebar, spec viz)
• Sync local tracker hygiene
• Record verification notes for JIT context, history memory, task-adaptive features

---

📦 Distribution

npm Packages (15 total)

CLI Tools:

• routa-cli@0.18.0 + 4 platform packages (darwin-arm64, darwin-x64, linux-x64, windows-x64)
• entrix@0.18.0 + 4 platform packages
• harness-monitor@0.18.0 + 4 platform packages

Rust Crates (7 total)

• routa-core@0.18.0
• routa-rpc@0.18.0
• routa-scanner@0.18.0
• routa-server@0.18.0
• routa-cli@0.18.0
• entrix@0.18.0
• harness-monitor@0.18.0

Desktop Installers

• macOS: .dmg (Intel & Apple Silicon)
• Windows: .msi installer, .exe setup
• Linux: .deb package, .AppImage

---

🔗 Installation

via npm

npm install -g routa-cli@0.18.0
npm install -g entrix@0.18.0
npm install -g harness-monitor@0.18.0

via Cargo

cargo install routa-cli@0.18.0
cargo install entrix@0.18.0
cargo install harness-monitor@0.18.0

Desktop Application

Download the appropriate installer for your platform from the Assets section below.

---

📝 Migration Notes

SQLite Schema

Legacy databases missing the worktrees table will be automatically migrated during initialization.

Kanban CLI

Kanban commands now default to desktop RPC backend. Use explicit flags if you need web backend.

JIT Context

The new JIT context system is opt-in through task search hints and feature selection. No breaking changes to existing workflows.

---

🙏 Acknowledgments

This release represents collaborative work across multiple AI agents and human contributors:

• Task-adaptive intelligence foundations
• Performance optimization research and implementation
• Desktop platform stability improvements
• Extensive testing and documentation updates

---

📚 Related Issues & PRs

Major Feature Tracks:

• #294 — Trace Learning (foundation)
• #315 — Harness Evolution Agent
• #466 — Global Flow Learning
• #482 — Harness Fitness Speed Optimization
• #515, #516, #517 — Task-Adaptive Intelligence
• #493, #499, #503 — Kanban CLI & Workflows
• #500 — Desktop Workspace-First Tray
• #502 — Feature Tree Generation

Bug Fixes:

• #443 — SQLite Schema Bootstrap
• #457 — Windows Terminal Windows
• #514 — Danger Token Contract
• #521 — Backlog History Memory Gating

Full changelog: v0.17.1...v0.18.0

Routa Desktop v0.17.2

Routa Desktop v0.17.2

Summary

Routa Desktop v0.17.2 includes 44 non-merge commits from v0.17.1..a6a9dd4fbbe7d820368458afc1ece993301c5234.

Highlights

• Desktop and release: Desktop, CI, and release workflow changes improve packaging, optional signing, release verification, and cross-platform runtime behavior.
• Kanban and task delivery: Kanban and task delivery changes make cards, reviews, PRs, diffs, and worktree-driven handoffs easier to inspect.
• CLI and developer tooling: CLI and developer-tooling updates expand graph analysis, repository safety checks, skills, hooks, and diagnostics.
• Harness and architecture: Harness and architecture work adds stronger repository analysis, fitness checks, generated playbooks, and evolution history.
• Sessions and agent runtime: Session and agent-runtime updates improve transcript recovery, provider behavior, streaming, and long-running agent execution.

Changed top-level areas: .gitignore, apps, crates, docs, docusaurus.config.js, resources, scripts, sidebars.js.

Upgrade Notes

• No breaking changes were identified from conventional commit markers.
• Review release, installer, signing, package, migration, or schema-related technical changelog entries before publishing.

Technical Changelog

Added

• cli: add kanban card detail command (e36b9f29)
• harness: add hard-gate fast-fail, test-mapping degradation, and METRIC output (#482) (6031e2cf)
• cli: add kanban GitHub issue workflows (7fd7d305)
• desktop: make tray workspace-first and macOS-ready (#500) (b7e8ce67)
• kanban: implement global flow learning with analysis and guidance (#466) (#499) (0e488dd6)
• kanban: enhanced CLI workflow — board status, card list filters, and automation commands (#493) (cba70fb3)
• feature-explorer: add agent-first feature tree generation (b7d8eac8)
• feature-tree: add preflight/commit routes and multi-root scanning (4cdf62e0)

Changed

• harness: format native speed-profile module (#482) (a6a9dd4f)
• issue: record final kanban cli verification (#503) (2f19607d)
• cli: clarify kanban default board behavior (#503) (3584c735)
• trace-parser: fix transcript candidate fixtures (96f1f58e)
• routa-cli: satisfy kanban clippy checks (9d9782dc)
• rust-api: satisfy clippy for feature explorer (d7ec3f9e)
• cli: extract kanban command wiring (e4f16978)
• feature-explorer: remove learned prompt context panel (b3983360)
• rust: apply formatting cleanup (a9643847)
• feature-tree: route generation through rust cli (#502) (761972ca)
• issues: sync closure for #478 (ebe0fe6f)
• overhaul documentation system for complete sidebar coverage (0f6b7df3)

Fixed

• harness: replace shell speed-profile with native metrics runtime (#482) (2be4ab15)
• core: make kanban default-board switching atomic (#503) (2410a88d)
• cli: default kanban commands to desktop rpc (#503) (e6fa02be)
• feature-explorer: align rust transcript candidate filtering (204313fa)
• rust-api: tighten feature explorer file signals (b087b6fb)
• rust-api: tighten feature explorer signal matching (65c67cb9)
• rust-api: enrich feature explorer file signals (12995abb)
• feature-explorer: stop infinite applying-agent-result retry (72d15d73)
• feature-explorer: hide prompt context for surface selections (507f618b)
• rust-api: return feature explorer file signals (2012eb52)
• feature-explorer: sync inspector with active file (5a6bd908)
• frontend: dedupe repo picker and harden safari wrapping (2bf2ef10)
• desktop: add macOS tray template icon (2227af3a)
• rust-api: tolerate stale repo path context (a1135349)
• feature-explorer: avoid panic on multibyte prompt previews (bb31d599)
• feature-explorer: close quick-scan drawer on success (a5b24db2)
• feature-explorer: polish repo switching and refresh feedback (67c55c2a)
• feature-explorer: handle usage-update agent completion (eaac9e19)
• security: resolve symlink traversal and validate metadata in commit route (d46fc8ae)
• security: validate scanRoot is inside repoRoot in commit route (5253765f)
• commit orchestrator tool manifest and skip preflight for explicit scanRoot (89e1c0a7)
• specialists: add feature-tree-orchestrator locale overlays (f8e750b5)
• test: relax frameworksDetected assertion for multi-framework repos (1492e1e3)
• test: update feature-tree route test for preflightFeatureTree (7e32bf4f)

Install

Download the desktop installer for your platform from the release assets.

CLI install:

• npm install -g routa-cli
• npx -p routa-cli routa --help

Release Metadata

• Range: v0.17.1..a6a9dd4fbbe7d820368458afc1ece993301c5234
• Commits: 44

Routa Desktop v0.17.1

Routa Desktop v0.17.1

Desktop application release. Release notes will be added manually.

Routa Desktop v0.17.0

Routa Desktop v0.17.0

Desktop application release. Release notes will be added manually.

Routa Desktop v0.16.0

Routa Desktop v0.16.0

Desktop application release. Release notes will be added manually.

Routa Desktop v0.15.1

Routa Desktop v0.15.1

Desktop application release. Release notes will be added manually.

Routa Desktop v0.15.0

Routa Desktop v0.15.0

Desktop application release. Release notes will be added manually.

Routa Desktop v0.14.2

Routa Desktop v0.14.2

Desktop application release. Release notes will be added manually.