Skip to content

Routa Desktop v0.18.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 22 Apr 12:29
· 563 commits to main since this release
v0.18.0
fbf5f0f
This commit was signed with the committer’s verified signature.
phodal Fengda Huang
GPG key ID: 770FD3BF11730CC7
Verified
Learn about vigilant mode.

🎉 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

Assets 8
Loading