What's Changed

Added

• Interactive TUI for Spec Management (spec 369) - Terminal UI built with Ratatui; sidebar navigation, keyboard shortcuts, markdown rendering
• GitHub Repo Import UI - Import specs from GitHub repositories in the cloud deployment interface
• GitHub Integration (specs 361-366) - Detect and manage specs from connected GitHub repos with cloud deployment readiness checks
• Extended CLI Flags - --content, --file, --assignee for create; --description and --expected-hash for update
• Docker Deployment (spec 317) - Self-hosted leanspec UI; multi-arch builds (amd64 + ARM64), non-root execution, data persistence

Changed

• Artifacts Sub-Tree - Deprecates flat subspec display in favor of an artifacts sub-tree concept
• Skill Architecture - Removes lean-spec skill subcommand and project-scoped skill install; leanspec-sdd skill now CLI-only (no MCP dependency)
• Skills Reorganization - Consolidates and reorganizes agent skills layout

Fixed

• GitHub Project Import - Corrects field naming mismatch and adds missing UI entry points
• Label Component - Adds missing Label component to the UI library
• Session Completion - Improves session completion handling and worktree management
• Railway Deployment - Fixes healthcheck endpoint, timeout, build base image, and deploy configs
• Docker - Removes hardcoded --project flag; non-root user and data persistence

Technical

• Migrates database layer from rusqlite to sqlx (Phase 2)
• Multi-arch Docker CI with native ARM64 runner, decoupled from npm publish
• Bumps Docker runtime base to Debian 13 (trixie)

Highlights

• Git Worktree Session Isolation — Parallel agent sessions in isolated Git worktrees with merge strategies and lifecycle management
• Shell-Based Runner Execution — Protocol overrides (ACP/shell) and model specifications per runner
• Dynamic Runner Model Discovery — model_providers replaces hardcoded model lists; fetches agentic-capable models from models.dev
• KaTeX Math Rendering — LaTeX math in spec markdown
• Model Selection UI — Searchable model popover with preference persistence per runner
• Smart Skill Installation — Auto-detects installed AI tools and installs selectively
• Progressive Spec Rendering — Deferred rendering for large spec lists

See CHANGELOG.md for full details.

Added

• Sessions UX Overhaul (spec 348) - New SessionsPopover with model selection, status indicators, and toast notifications
• Spec Search Backend - Backend-driven search with relevance ranking and enriched query support
• Prompt Input Refactor - Splits monolithic prompt input into modular core, context, hooks, and compound components
• Generated TypeScript Bindings - Expands generated API types for sessions, runners, stats, and validation with pre-push verification
• Runner Research Skill - Dedicated skill for tracking runner ecosystem changes and compatibility
• MCP Tooling Expansion - Adds view, update, validate, tokens, stats, and search MCP tools

Changed

• Rust Crate Modularity - Reorganizes core, HTTP, and MCP crates into domain-focused modules (spec_ops, compute, io)
• CLI Argument Architecture - Moves CLI argument parsing into dedicated cli_args module
• Spec Detail and Navigation UI - Modular spec detail sections, sub-spec tabs, and improved sidebar filtering

Fixed

• Tool Error Feedback - Clearer error messages for missing fields and structured HTTP error logging
• UI Responsiveness - Fixes status badge and tool header layout on constrained widths
• Context Prompt Test - Fixes missing created field in build_context_prompt test frontmatter

Highlights

• Prompt-First Session Creation — Redesigned session creation as a prompt-first experience with spec context attachments
• Sessions Management UI — Comprehensive session browsing with status badges, nav sidebar, filtering, and structured log viewing
• ACP Native Event Passthrough — Removed double translation of ACP JSON-RPC data for streamlined event handling
• Spec Hierarchy Management — Parent assignment validation with cache invalidation
• Legacy Database Migration — Automated migration from legacy databases with optimized spec loading
• CLI Relationship Commands — New children, deps commands and --parent/--depends-on options
• ACP Sessions Integration — Human-in-the-loop permissions, resume sessions, real-time streaming
• Files Page — Full-featured file browser with search, syntax highlighting, and tree navigation
• Session Context Redesign — Multi-spec and multi-prompt session support
• Runner Enhancements — Dynamic prompt injection via prompt_flag, version retrieval API
• Advanced Search Refactoring — Modular search architecture in Rust

See CHANGELOG.md for full details.

[0.2.24] - 2026-02-23

Added

• Tool Registry for LeanSpec AI - New hook infrastructure for AI tool management

  • useChatConfig and models registry hooks

• Auto Title Generation - Automatic title generation for chat conversations

  • Conversations now auto-generate titles based on first message

• Models Settings Enhancements - Enhanced model configuration and management

  • Clear API key functionality
  • Improved toast notifications for model operations
  • Renamed AI settings to Models settings for clarity

• Draft Spec Status - New draft status for specs to represent work-in-progress items

  • Full support in UI with status badges and filtering

• Customizable Workflow Enums - Configurable status, priority, and field enums per project

  • Enables teams to define custom values that fit their workflow

• Tool Call Result Rendering - Rich result display for AI tool calls in chat

  • Specialized renderers for different result types
  • JSON truncation for large payloads to keep UI readable

• Reasoning Support in Chat - Streaming reasoning/thinking steps in AI chat responses

  • Enhanced tool event handling with dynamic reasoning flag

• UmbrellaBadge Component - New badge for displaying spec hierarchy in the UI

  • Visual indicator for umbrella parent-child relationships

• Chat Keyboard Shortcuts - Enhanced keyboard shortcut handling across chat interface

  • Enhanced Markdown rendering components for chat messages

• Chat Auto-Focus - ChatContainer and ChatSidebar input auto-focus on open

• Organize Prompt - New AI prompt for managing specs relationships, status, and priority

• Docker Deployment - Support and documentation for deploying LeanSpec UI via Docker

  • Vite favicon plugin for development build support

Changed

• UI Components Consolidation (spec 314) - Major refactoring of UI package

  • Phase 1: DRY elimination with consolidated badge config and removed duplicates
  • Phase 2: Renamed 80 component files to kebab-case naming convention
  • Removed @leanspec/ui-components package entirely
  • Updated all import paths to use @/library instead of @leanspec/ui-components

• Chat Transport Enhancements - Dynamic body values and improved provider compatibility

• Project-Scoped Storage - Project-scoped localStorage for user preferences and chat settings

  • Zustand store synchronization improvements
  • Models registry fetching optimizations

• Skill Installation - Enhanced to target detected AI tools and streamline MCP configuration

• Chat Sidebar Global Store - Refactored to use global chat preferences store; removed deprecated standalone chat page

• Chat Message Handling - Enhanced with parts and metadata support for richer message structures

  • Human-readable title field in tool input structs for better action clarity

• PriorityBadge / StatusBadge - Added outline variant for flexible display options

• TerminalStatus Component - Now displays "Running..." message when no child content is provided

• Completion Verification - Archived child specs are now considered when verifying spec completion

Fixed

• lean-spec ui Path Issue - Fixed "specs/specs" doubled path when launching lean-spec ui command
  • Passes project root instead of specs directory to HTTP server
• CI/CD Linux Build - Pinned Linux build runner to ubuntu-22.04 for GLIBC 2.35 compatibility
• CI Rust Target Cache - Dropped failing rust target cache step in CI workflow
• Chat Sidebar Conversation History - Fixed layout sidebar race conditions
• TypeScript Deprecation - Removed deprecated ignoreDeprecations option from tsconfig
• Spec Prompt Clarity - Clarified spec loading instructions and dependency checks
• Clippy Warnings - Added allowance for too many arguments in stream_openai_round function
• Linux arm64 Error Messages - Removed misleading linux-arm64 support claims from error output

Technical

• Consolidated script references and updated skill documentation
• Removed Makefile, updated build scripts for Rust binaries
• Refactored merge_frontmatter function to use input struct for better readability
• Added development logos and dev-build navigation support

Full Changelog: v0.2.22...v0.2.23

Full Changelog: v0.2.21...v0.2.22

Bug Fixes

• tailwind: Add typography plugin and update animation plugin import to fix missing prose class issue on spec detail page

What's New in v0.2.20

AI Chat Configuration Improvements (Spec 224)

• Multi-provider support with configuration via ~/.leanspec/chat-config.json
• Support for OpenAI, Anthropic, Deepseek, OpenRouter, and any OpenAI-compatible API
• ModelPicker component for quick provider/model selection
• Full Settings page with CRUD operations for providers and models
• Config hot-reload without server restart
• i18n support (English and Chinese)

IPC-Based AI Chat Bridge (Spec 237)

• Unified Rust HTTP server with Node.js AI worker via IPC
• JSON Lines protocol for efficient communication
• Automatic worker spawning on first chat request
• Node.js version detection with tiered warnings

UI Component Consolidation (Spec 238)

• All shadcn/ui components consolidated into @leanspec/ui-components
• 48 ai-elements wrappers integrated into @leanspec/ui-components
• Cleaner architecture with better separation of concerns

Other Improvements

• HTTP Server Auto-Installation for seamless UI startup
• Mermaid diagram theme enhancements
• Dependency graph self-references filtering
• Settings page layout improvements

See CHANGELOG.md for full details.

Bug Fixes

• http-server: Fixed critical bug where all platform binaries were incorrectly published as macOS arm64 binaries in v0.2.18

Notes

v0.2.18 has been deprecated due to the binary issue. Please use v0.2.19 or later.