lacy 1.8.10 → 1.8.12

package/CHANGELOG.md

@@ -0,0 +1,366 @@
+# Changelog
+
+All notable changes to Lacy will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.7.0] - 2026-02-07
+
+### Added
+
+- **Bash 4+ adapter** — Lacy Shell now works in Bash 4+ in addition to ZSH. Uses `bind -x` for Enter override, `PROMPT_COMMAND` for post-execution hooks, and `PS1` badge for mode display. Requires Bash 4+ (macOS: `brew install bash`); shows a clear error on Bash 3.2
+- **Standalone CLI** (`bin/lacy`) — pure-bash CLI with zero dependencies. Commands: `lacy setup`, `lacy status`, `lacy doctor`, `lacy update`, `lacy uninstall`, `lacy reinstall`, `lacy config`, `lacy version`, `lacy help`. Delegates to `npx lacy@latest` for rich UI when Node is available, falls back to bash
+- **Multi-shell architecture** — `lib/core/*.sh` (portable Bash 4+/ZSH shared logic), `lib/zsh/*.zsh` (ZLE widgets, `region_highlight`, `print -P`), `lib/bash/*.bash` (`bind -x`, `PROMPT_COMMAND`, `printf` ANSI). Old `lib/*.zsh` files are thin backward-compat wrappers
+- `lacy.plugin.bash` entry point — sets `LACY_SHELL_TYPE=bash`, `_LACY_ARR_OFFSET=0`, loads bash adapter modules
+- `tests/test_bash.bash` — 16 Bash-specific integration tests (detection, prompt, modes, command functions)
+- `tests/test_core.sh` — 81 cross-shell tests (runs under both ZSH and Bash 4+)
+- **Layer 1: Shell reserved word filtering** — words like `do`, `done`, `then`, `else`, `in`, `select`, `function` that pass `command -v` but are never standalone commands are now routed directly to the agent
+- **Layer 2: Post-execution natural language detection** — `lacy_shell_detect_natural_language()` analyzes failed command output against 17 error patterns and checks for NL signals
+- `LACY_SHELL_RESERVED_WORDS`, `LACY_SHELL_ERROR_PATTERNS` constants
+- Expanded `LACY_NL_MARKERS` from 14 to ~108 common English words
+- `NATURAL_LANGUAGE_DETECTION.md` — shared spec for NL detection (synced with lash)
+- npm installer (`packages/lacy/index.mjs`) rewritten with `@clack/prompts` — interactive setup, tool selection, mode picker, doctor diagnostics
+
+### Changed
+
+- Reorganized `lib/` into `lib/core/` (shared), `lib/zsh/`, `lib/bash/` with backward-compat wrappers in old `lib/*.zsh` locations
+- `lacy_shell_classify_input()` now checks `LACY_SHELL_RESERVED_WORDS` before `command -v`
+- `install.sh` now detects Bash vs ZSH and sources the appropriate plugin file
+- `uninstall.sh` cleans up both `~/.lacy` and legacy `~/.lacy-shell` paths
+
+### Fixed
+
+- **Tool invocation with special characters** — replaced `eval` with array-based `_lacy_run_tool_cmd()` so queries containing double quotes (e.g. `what does "map" do`) no longer break command parsing
+- **Ctrl+Space history pollution** (Bash) — the injected `_lacy_mode_toggle_` command is now removed from history immediately
+- **Config cache freshness check inverted** — `config.yaml -nt cache` was incorrectly using the stale cache; now correctly checks `! -nt` so config changes take effect
+- **Config cache write injection** — cache values are now written with `printf %q` instead of raw single-quote interpolation
+- **`bin/lacy setup_tool` crash on non-numeric input** — added regex validation before numeric comparison
+- **`bin/lacy reinstall` destroys user config** — config.yaml is now backed up and restored across reinstall
+- **`yaml_write` sed injection** — sed special characters (`\`, `|`, `&`) in values are now escaped
+- **`commandExists` shell injection** (Node installer) — command names are validated against `/^[a-zA-Z0-9._-]+$/` before `execSync`
+- **PROMPT_COMMAND not restored on cleanup** (Bash) — `lacy_shell_cleanup()` now restores `_LACY_ORIGINAL_PROMPT_COMMAND`
+- **Reroute candidate fires when disabled** — moved disabled/quitting guard before reroute check in both `execute.bash` and `execute.zsh`
+- **`python3` subprocess on every Ctrl+C** (macOS Bash) — replaced with `$(( $(date +%s) * 1000 ))` fallback for second-precision timestamps
+- **`(( PASS++ ))` in tests** — replaced with `PASS=$(( PASS + 1 ))` to avoid exit code 1 when counter is 0
+- Removed dead `lacy_shell_detect_mode()` function from `detection.sh`
+
+---
+
+## [1.4.0] - 2026-02-04
+
+### Added
+
+- Post-execution error fallback for smart command routing — when a valid command has 3+ bare words with natural language markers (e.g. `kill the process on localhost:3000`), shell executes first; if it fails, input is automatically re-routed to the agent
+- `lacy_shell_has_nl_markers()` — NL detection function that counts bare words (excluding flags, paths, numbers, variables) and checks for strong markers (articles, pronouns, question words, "please")
+- First-word syntax highlighting via ZSH `region_highlight` — the first word is highlighted green for shell commands and magenta for agent queries in real-time as you type
+
+### Changed
+
+- `lacy_shell_precmd()` now captures `$?` as its first operation to support exit code checking for reroute candidates
+- Exit codes >= 128 (signal-based: Ctrl+C, SIGKILL) are excluded from reroute triggering
+- Explicit `mode shell` never triggers rerouting — only auto mode
+
+---
+
+## [1.3.0] - 2026-02-03
+
+### Added
+
+- Agent preheating to reduce per-query latency
+- Background server mode for lash and opencode — starts `lash serve` / `opencode serve` in background, routes queries via local REST API to eliminate cold-start
+- Claude session reuse — captures `session_id` from `--output-format json` and passes `--resume` on subsequent queries for conversation continuity
+- New `preheat` config section with `eager` (start server on plugin load) and `server_port` (default 4096) options
+- Automatic server lifecycle management: lazy start on first query, health checks, crash recovery, cleanup on quit or tool switch
+
+### Fixed
+
+- Fixed JSON output parsing in zsh — replaced `echo` with `printf '%s
+'` to prevent zsh from interpreting escape sequences (`
+`, `\"`) in JSON strings
+
+---
+
+## [1.1.1] - 2026-02-03
+
+### Fixed
+
+- Leading whitespace no longer misroutes input to agent (`  ls -la` now correctly executes in shell)
+- Spinner no longer permanently disables job control (`fg`/`bg` work after AI queries)
+- Spinner no longer leaves cursor hidden after Ctrl+C interrupts
+- `exit` no longer shadowed by alias — passes through to shell builtin in shell mode, quits lacy in auto/agent mode
+
+### Changed
+
+- Centralized detection logic into single `lacy_shell_classify_input()` function — indicator and execution can no longer disagree
+- Added single-entry cache for `command -v` lookups to reduce input lag with large PATH
+
+---
+
+## [1.1.0] - 2024-12-19 - SMART AUTO MODE 🧠
+
+### ⚡ Major Enhancement: Intelligent Auto Mode
+
+**Smart Command Execution**: Auto mode now executes real commands first, then falls back to AI
+
+- **Command-First Strategy**: Real shell commands execute immediately without AI overhead
+- **Natural Language Detection**: Obvious questions go directly to AI (no failed shell attempts)
+- **Smart Fallback**: Unknown commands try shell first, then automatically ask AI for help
+- **Better Performance**: Eliminates unnecessary AI calls for standard commands
+
+### 🎯 New Smart Auto Mode Features
+
+- `lacy_shell_execute_smart_auto()` - Core smart execution logic
+- `lacy_shell_command_exists()` - Robust command existence checking (includes builtins)
+- `lacy_shell_is_obvious_natural_language()` - Natural language pattern detection
+- Smart routing indicators: 💻 for commands, 🤖 for AI, ❓ for fallback attempts
+
+### 🧪 Testing & Validation
+
+- `test-smart-auto.sh` - Comprehensive test suite for smart auto mode
+- `test_smart_auto` alias for quick function testing
+- Real-world test cases covering edge cases and common scenarios
+
+### 📈 Performance Improvements
+
+- ⚡ Real commands execute instantly (no AI delay)
+- 🧠 Natural language bypasses shell attempts
+- 🔄 Graceful fallback maintains workflow continuity
+- 📚 Educational feedback when introducing new tools
+
+### 🔄 Breaking Changes
+
+- Auto mode behavior significantly improved (backwards compatible)
+- Detection logic now optimized for performance over pattern matching
+- Mode descriptions updated to reflect new "try shell first" behavior
+
+---
+
+## [1.0.1] - 2024-12-19 - PRODUCTION HARDENING 🛡️
+
+### 🚨 Critical Fixes
+
+- **Fixed Input "Swallowing" Issue**: Resolved commands disappearing with no feedback
+- **MCP Server Error Handling**: Added proper startup validation and error reporting
+- **Emergency Recovery System**: Multiple escape routes when things go wrong
+- **API Timeout Protection**: 30-second timeout prevents hanging on AI calls
+
+### 🔧 New Emergency Commands
+
+- `!command` - Emergency bypass prefix for direct shell execution
+- `disable_lacy` - Disable input interception entirely (alias: `lacy_shell_disable_interception`)
+- `enable_lacy` - Re-enable input interception (alias: `lacy_shell_enable_interception`)
+- `mcp_check` - Verify MCP package dependencies with installation instructions
+- `mode status` - Show detailed mode information including persistence state
+
+### 🛡️ Reliability Improvements
+
+- Pre-flight API key validation before agent execution
+- Process validation for MCP servers with PID checking
+- Clear error messages with actionable troubleshooting steps
+- Graceful fallback to shell execution when AI services unavailable
+- Enhanced error logging for MCP server diagnostics
+
+### 📚 Documentation Updates
+
+- Comprehensive troubleshooting section in README
+- Emergency recovery procedures in all docs
+- API documentation for new diagnostic functions
+- Architecture docs updated with error handling patterns
+
+### 🎯 Mode Persistence Enhancement
+
+- **Persistent Mode Memory**: Your preferred mode is saved across shell sessions
+- Mode state file: `~/.lacy-shell/current_mode`
+- Enhanced `mode status` command shows current, default, and saved modes
+- Graceful handling of invalid saved modes with fallback to default
+
+## [1.0.0] - 2024-12-19
+
+### 🎉 Initial Release
+
+#### Added
+
+- **Three intelligent modes**: Shell, Agent, and Auto
+- **Smart mode switching** with `Ctrl+Space` keybinding
+- **AI integration** with OpenAI and Anthropic APIs
+- **Streaming responses** with typewriter effect
+- **Persistent conversation history** across sessions
+- **MCP (Model Context Protocol) support** for extensible AI capabilities
+- **Auto-detection engine** for command vs. query classification
+- **Visual mode indicators** in shell prompt
+- **Comprehensive configuration system** via YAML
+- **Zero-configuration setup** with sensible defaults
+
+#### Features
+
+**Core Functionality:**
+
+- 🐚 **Shell Mode** (`$`) - Pure shell execution
+- 🤖 **Agent Mode** (`?`) - AI-powered assistance
+- ⚡ **Auto Mode** (`~`) - Smart routing between shell and agent
+
+**User Interface:**
+
+- Single-character mode indicators on prompt right side
+- Clean, minimal visual design
+- Real-time streaming AI responses
+- Context-aware help system
+
+**AI Integration:**
+
+- Support for OpenAI GPT-4 and Anthropic Claude models
+- Conversation memory and context preservation
+- Streaming responses for real-time feedback
+- MCP server integration framework
+
+**Smart Detection:**
+
+- Keyword-based classification (help, how, what, etc.)
+- Command pattern recognition (git, npm, docker, etc.)
+- Natural language query detection
+- Customizable detection rules
+
+**Configuration:**
+
+- YAML-based configuration with fallback parsing
+- API key management
+- MCP server configuration
+- Custom detection keywords and commands
+
+**Keybindings:**
+
+- `Ctrl+Space` - Primary mode toggle (universal compatibility)
+- `Ctrl+T` - Alternative mode toggle
+- `Ctrl+X` prefix commands for direct mode switching
+- Compatible with Mac, VS Code, and all major terminals
+
+**Developer Features:**
+
+- Modular architecture with clear separation of concerns
+- Comprehensive test suite
+- Debug and troubleshooting commands
+- Extension points for custom functionality
+
+#### Technical Implementation
+
+**Architecture:**
+
+- ZSH plugin with widget-based input interception
+- Modular design with 7 core components
+- Hook-based integration with existing shell setups
+- Thread-safe mode management
+
+**Performance:**
+
+- Lazy loading for fast startup
+- Minimal memory footprint
+- Efficient detection algorithms
+- API response caching
+
+**Compatibility:**
+
+- Works with zsh, starship, oh-my-zsh
+- MacOS, Linux, and WSL support
+- VS Code terminal integration
+- Compatible with existing shell configurations
+
+**Security:**
+
+- Local API key storage
+- No automatic command execution from AI
+- Sandboxed execution environment
+- User-controlled data sharing
+
+#### Installation & Setup
+
+**Installation Methods:**
+
+- Automated installer script
+- Manual plugin installation
+- Package manager support (planned)
+
+**Dependencies:**
+
+- zsh shell
+- Python 3.x for configuration parsing
+- curl for API communication
+- Optional: Node.js for MCP servers
+
+#### Documentation
+
+**Comprehensive Documentation:**
+
+- User guide with examples
+- API documentation for developers
+- Architecture deep dive
+- Contributing guidelines
+- Troubleshooting guide
+
+**Example Workflows:**
+
+- Development assistance scenarios
+- System administration tasks
+- Learning and exploration use cases
+- Debugging and problem-solving
+
+### Known Issues
+
+- JSON escaping edge cases in complex queries (workaround available)
+- MCP server integration is framework-only (servers not auto-started)
+
+### Breaking Changes
+
+None (initial release)
+
+### Migration Guide
+
+None (initial release)
+
+---
+
+## [Unreleased]
+
+### Added
+
+- feat: add GitHub Copilot CLI as a supported backend (LAC-1144)
+
+### Planned Features
+
+- **Fish shell support**
+- **Real MCP server auto-startup**
+- **Plugin ecosystem support**
+
+---
+
+## Version History Summary
+
+| Version | Release Date | Key Features                                                               |
+| ------- | ------------ | -------------------------------------------------------------------------- |
+| 1.7.0   | 2026-02-07   | Bash 4+ adapter, standalone CLI, multi-shell architecture, security fixes  |
+| 1.5.0   | 2026-02-07   | NL detection layers 1 & 2, reserved word filtering, error pattern matching |
+| 1.4.0   | 2026-02-04   | Post-exec reroute, NL markers, first-word syntax highlighting              |
+| 1.3.0   | 2026-02-03   | Agent preheating, background server, claude session reuse                  |
+| 1.1.1   | 2026-02-03   | Centralized detection, spinner/cursor fixes, whitespace handling           |
+| 1.1.0   | 2024-12-19   | Smart auto mode, command-first strategy, NL detection                      |
+| 1.0.1   | 2024-12-19   | Production hardening: error handling, emergency recovery, mode persistence |
+| 1.0.0   | 2024-12-19   | Initial release with three modes, AI integration, MCP support              |
+
+## Contributors
+
+- **Initial Development**: Lacy Shell Team
+- **Architecture Design**: Core development team
+- **Documentation**: Community contributors
+- **Testing**: Beta user community
+
+## Acknowledgments
+
+- Inspired by Warp Terminal's AI integration
+- Built on the Model Context Protocol (MCP) standard
+- Thanks to the zsh and shell scripting community
+- OpenAI and Anthropic for AI API access
+
+---
+
+_For detailed technical changes, see the git commit history._
+_For upgrade instructions, see the [README.md](README.md) file._