bug fix: terminal compatibility issues resolved

Author: sizzlebop

.gitignore

@@ -48,11 +48,6 @@ coverage/
 test/
 
 # Other
-.backup/
-reference/
-PLAN/
-PLAN/ANTHROPIC-REIMPLEMENTATION-PLAN.md
-PLAN/CLAUDE_AGENTS.md
-PLAN/CLAUDE_EXAMPLE_AGENT.md
-PLAN/CLAUDE_OVERVIEW.md
-.blackboxrules
+beautify_plan/
+mcpollinations-output/
+reference/

BIBBLE_GLAMOUR_ROADMAP.md

@@ -127,18 +127,18 @@ npm install \
 - [x] **Add** status logging system - ✅ Success/error/warning/info with timing!
 - [x] **Add** progress bar utilities - ✅ Single and multi-bar progress displays!
 
-### **PHASE 5: Interactive Elements** 🎮
+### **PHASE 5: Interactive Elements** 🎮 ✅ **COMPLETED!**
 
-#### 5.1 Enhanced Prompts
-- [ ] **Create** `src/ui/prompts.ts` - Beautiful prompt system
-- [ ] **Style** user input prompts
-- [ ] **Add** confirmation dialogs
-- [ ] **Add** selection menus
+#### 5.1 Enhanced Prompts ✅
+- [x] **Create** `src/ui/prompts.ts` - ✅ Beautiful prompt system with Pink Pixel theming!
+- [x] **Style** user input prompts - ✅ Gradient messages with themed prefixes!
+- [x] **Add** confirmation dialogs - ✅ Beautiful confirm/select/multi-select prompts!
+- [x] **Add** selection menus - ✅ Interactive menus with descriptions and styling!
 
-#### 5.2 Help & Documentation
-- [ ] **Redesign** help system with beautiful formatting
-- [ ] **Add** command documentation with examples
-- [ ] **Add** interactive command explorer
+#### 5.2 Help & Documentation ✅
+- [x] **Redesign** help system with beautiful formatting - ✅ Complete help system with markdown rendering!
+- [x] **Add** command documentation with examples - ✅ Comprehensive help with usage examples!
+- [x] **Add** interactive command explorer - ✅ Interactive help explorer with topic selection!
 
 ### **PHASE 6: Advanced Features** 🌟
 
@@ -169,10 +169,10 @@ src/ui/
 ├── symbols.ts         # ✨ Beautiful unicode symbols
 ├── splash.ts          # 🚀 Startup banners & ASCII art
 ├── spinners.ts        # ⭕ Loading indicators
-├── progress.ts        # 📊 Progress bars
 ├── tables.ts          # 📋 Beautiful table system
 ├── lists.ts           # 📝 Styled lists & menus
-├── prompts.ts         # 💬 Interactive prompts
+├── prompts.ts         # 💬 Interactive prompts ✅ NEW!
+├── help.ts            # 🎭 Help & documentation system ✅ NEW!
 ├── chat.ts            # 💭 Enhanced chat interface
 ├── markdown.ts        # 📄 Rich markdown rendering
 ├── layout.ts          # 📐 Layout utilities
@@ -198,7 +198,7 @@ src/ui/
 ╰─────────────────────────────────────────╯
 
 🔥 Model: Claude 3.7 Sonnet   ⚡ MCP: 5 servers connected
-💫 Version: 1.3.8              🚀 Ready for magic!
+💫 Version: 1.3.9              🚀 Ready for magic!
 ```
 
 ### Chat Interface
@@ -248,6 +248,16 @@ src/ui/
 
 ## 🎉 MAJOR PROGRESS COMPLETED! (August 23, 2025)
 
+### ✅ PHASE 5 COMPLETE - BEAUTIFUL INTERACTIVE ELEMENTS!
+15. **✅ Interactive prompts system created!** - Complete `prompts.ts` with Pink Pixel theming and gradient styling
+16. **✅ Beautiful confirmation dialogs implemented!** - Elegant confirm/select/multi-select prompts with descriptions
+17. **✅ Comprehensive help system built!** - Full `help.ts` with markdown rendering and interactive exploration
+18. **✅ Help command created!** - New `help.ts` command with topic-based exploration and examples
+19. **✅ Enhanced user interaction!** - All user prompts now use beautiful Pink Pixel styling
+20. **✅ Interactive help explorer!** - Users can navigate help topics with gorgeous menus and formatting
+21. **✅ Password and editor prompts!** - Secure input handling with masked characters and styled interfaces
+22. **✅ Progress and loading indicators!** - Beautiful progress bars and loading states for user feedback
+
 ### ✅ PHASE 4 COMPLETE - GORGEOUS DATA DISPLAY SYSTEM!
 6. **✅ Beautiful table system implemented!** - Complete `tables.ts` with auto-styling based on content
 7. **✅ Styled lists and menus created!** - Full `lists.ts` with multiple themes and interactive menus

CHANGELOG.md

@@ -2,6 +2,68 @@
 
 All notable changes to the Bibble project will be documented in this file.
 
+## [1.3.9] - 2025-08-28
+
+### 🚀 MAJOR RELIABILITY UPDATE - CROSS-TERMINAL COMPATIBILITY
+
+### Added
+- **🔧 Environment Resolver System**: Comprehensive cross-platform executable detection
+  - Created `src/utils/env-resolver.ts` - Universal Node.js, npm, and npx path resolver
+  - Cross-platform executable detection via `which`, `where`, and `Get-Command`
+  - Fallback to common installation paths (Program Files, Homebrew, NVM, Volta, asdf, etc.)
+  - Cached resolution for performance optimization
+- **🛡️ Multi-Tier Fallback System**: Robust MCP server connection strategies
+  - **Primary Strategy**: Resolved executable paths with environment enhancement
+  - **Direct Command Fallback**: Original command execution without path resolution
+  - **Corepack Fallback**: Node.js-based package execution for npm compatibility
+  - **Bundled npm Fallback**: Direct Node.js execution for simplified npx functionality
+- **🩺 Enhanced Diagnostic Command**: Comprehensive environment troubleshooting
+  - Added `--verbose` flag to `bibble diagnose` for detailed system information
+  - Platform detection (OS, shell, terminal identification)
+  - Executable resolution with version checking
+  - PATH entries analysis and environment variable inspection
+  - Real-time npx execution testing in verbose mode
+- **🔄 Graceful Degradation**: Non-blocking MCP server failures
+  - Connection summaries showing successful vs failed server connections
+  - Fallback strategy notifications when primary connection fails
+  - Continued operation even if some MCP servers fail to connect
+
+### Fixed
+- **🎯 CRITICAL: Terminal Compatibility Issues**: Fixed MCP server failures across different terminals
+  - Resolved "Connection closed" errors in Windows Terminal, Hyper, and other non-Warp terminals
+  - Fixed environment variable and PATH discrepancies between terminal environments
+  - Ensured consistent Node.js/npm/npx executable resolution across all terminals
+- **🔧 Environment Path Resolution**: Robust executable detection system
+  - Fixed Windows-specific .cmd file execution issues
+  - Enhanced PATH environment variable handling
+  - Improved error messages with actionable troubleshooting suggestions
+- **⚡ MCP Server Reliability**: Enhanced connection stability
+  - Multi-strategy connection attempts prevent single-point failures
+  - Better error handling with user-friendly messages
+  - Reference to diagnostic command for troubleshooting guidance
+
+### Changed
+- **🔍 Diagnostic System**: Enhanced environment analysis capabilities
+  - More detailed platform and executable information
+  - Better error reporting with specific remediation suggestions
+  - Verbose mode for comprehensive system analysis
+- **🛠️ Error Handling**: Improved user experience with actionable messages
+  - Clear, descriptive error messages instead of technical stack traces
+  - Specific suggestions for common issues (missing executables, permission errors)
+  - Reference to diagnostic tools for self-service troubleshooting
+
+### Technical Details
+- **Architecture**: New modular environment resolution system with comprehensive fallback strategies
+- **Cross-Platform**: Tested and verified compatibility across Windows, macOS, and Linux
+- **Performance**: Cached executable resolution for optimal startup performance
+- **Reliability**: Multi-tier fallback ensures maximum MCP server connectivity
+
+### Impact
+- **Before**: Bibble only worked reliably in Warp terminal, failed with "Connection closed" errors in other terminals
+- **After**: Universal terminal compatibility - works consistently across Windows Terminal, Hyper, Command Prompt, PowerShell, and all major terminals
+
+This update ensures Bibble works reliably across all terminal environments, eliminating the frustrating terminal-specific compatibility issues! 🎉
+
 ## [1.3.8] - 2025-08-23
 
 ### 🎉 MAJOR VISUAL TRANSFORMATION - BIBBLE GLAMOUR UPDATE

OVERVIEW.md

@@ -2,10 +2,10 @@
 
 Bibble is a sophisticated command-line interface (CLI) chatbot application that integrates with multiple language model providers and supports the Model Context Protocol (MCP) for enhanced functionality through external tools. Built with TypeScript, it provides a robust terminal-based AI assistant experience with comprehensive tool integration.
 
-**Version**: 1.3.8
+**Version**: 1.3.9
 **Author**: Pink Pixel
 **NPM Package**: @pinkpixel/bibble
-*Last updated: August 23, 2025*
+*Last updated: August 28, 2025*
 
 ## Project Overview
 
@@ -343,7 +343,7 @@ The implementation is based on the plan outlined in `PLAN/ANTHROPIC-REIMPLEMENTA
 
 ### Pink Pixel Glamour Transformation (v1.3.8) - August 23, 2025
 
-Version 1.3.8 represents a **MAJOR VISUAL TRANSFORMATION** that converts Bibble from a basic CLI tool into a stunning, professional terminal experience with Pink Pixel brand theming:
+Version 1.3.8 represented a **MAJOR VISUAL TRANSFORMATION** that converted Bibble from a basic CLI tool into a stunning, professional terminal experience with Pink Pixel brand theming:
 
 **🎨 Beautiful Theme System:**
 - **Centralized Theme Management** (`src/ui/theme.ts`): Complete Pink Pixel brand color palette integration

README.md

@@ -129,6 +129,13 @@ bibble history
 - `bibble history export <id> <filename>` - Export chat history to a JSON file
 - `bibble history import <filename>` - Import chat history from a JSON file
 
+### System commands
+
+- `bibble setup` - Run the setup wizard
+- `bibble system-prompt` - View the system prompt with tools list
+- `bibble diagnose` - Diagnose environment and terminal compatibility
+- `bibble diagnose --verbose` - Show detailed diagnostic information
+
 ## In-chat commands
 
 The following commands are available during a chat session:
@@ -159,6 +166,124 @@ To configure MCP servers, use:
 bibble config mcp-servers
 ```
 
+## Troubleshooting
+
+### Environment Diagnostics
+
+Bibble includes built-in diagnostic tools to help troubleshoot common issues:
+
+```bash
+# Basic diagnostic information
+bibble diagnose
+
+# Detailed system analysis
+bibble diagnose --verbose
+```
+
+The diagnostic command will check:
+- Platform and terminal information
+- Node.js, npm, and npx executable paths and versions
+- Environment variables and PATH configuration
+- MCP server connectivity issues
+
+### Common Issues
+
+#### MCP Server Connection Failures
+
+**Problem**: You see "Connection closed" errors when starting Bibble, especially in terminals other than Warp.
+
+**Solution**:
+1. Run `bibble diagnose` to check your environment
+2. Ensure Node.js and npm are properly installed and accessible
+3. Check that your PATH includes Node.js and npm directories
+4. Try running from a different terminal (Command Prompt, PowerShell, or Git Bash on Windows)
+
+**Symptoms**:
+```
+Failed to connect to MCP server "server-name": Connection closed
+```
+
+**Advanced Troubleshooting**:
+- Run `bibble diagnose --verbose` for detailed information
+- Try running `node --version` and `npx --version` in your terminal
+- If using Windows, try running your terminal as Administrator
+- Check if antivirus software is blocking Node.js processes
+
+#### Terminal Compatibility
+
+**Problem**: Bibble works in one terminal but not others.
+
+**Solution**: Bibble v1.3.9+ includes multi-tier fallback systems for cross-terminal compatibility:
+- **Primary Strategy**: Uses resolved executable paths
+- **Fallback Strategies**: Direct commands, corepack, and bundled npm approaches
+- **Graceful Degradation**: Continues working even if some servers fail
+
+**Supported Terminals**:
+- ✅ Warp Terminal
+- ✅ Windows Terminal
+- ✅ Hyper
+- ✅ Command Prompt
+- ✅ PowerShell
+- ✅ Git Bash
+- ✅ Most Unix terminals
+
+#### Node.js Installation Issues
+
+**Problem**: Bibble can't find Node.js, npm, or npx.
+
+**Solutions**:
+1. **Install Node.js**: Download from [nodejs.org](https://nodejs.org/)
+2. **Check Installation**:
+   ```bash
+   node --version
+   npm --version
+   npx --version
+   ```
+3. **Path Issues**: Add Node.js to your PATH environment variable
+4. **NVM Users**: Make sure your Node.js version is activated
+5. **Windows Users**: Try reinstalling Node.js with "Add to PATH" option checked
+
+#### API Key Issues
+
+**Problem**: API key errors or authentication failures.
+
+**Solutions**:
+1. Run the setup wizard: `bibble setup`
+2. Manually set API keys: `bibble config api-key`
+3. Check your API key is valid and has sufficient credits
+4. Verify the correct API endpoint is configured
+
+#### Performance Issues
+
+**Problem**: Slow startup or response times.
+
+**Solutions**:
+1. Check your internet connection
+2. Try a different model or provider
+3. Reduce the number of enabled MCP servers
+4. Clear chat history if it's very large: `bibble history clear`
+
+### Getting Help
+
+If you're still experiencing issues:
+
+1. **Run Diagnostics**: `bibble diagnose --verbose`
+2. **Check Logs**: Look for error messages in the terminal output
+3. **Update Bibble**: `npm install -g @pinkpixel/bibble@latest`
+4. **Check GitHub Issues**: Visit the [GitHub repository](https://github.com/pinkpixel-dev/bibble/issues)
+5. **Report Bugs**: Create a new issue with:
+   - Your operating system and terminal
+   - Output from `bibble diagnose --verbose`
+   - Steps to reproduce the issue
+   - Error messages or unexpected behavior
+
+### Version Compatibility
+
+- **Bibble 1.3.9+**: Universal terminal compatibility with multi-tier fallback
+- **Bibble 1.3.8**: Enhanced UI and visual improvements
+- **Bibble 1.3.0+**: Full MCP integration support
+- **Node.js 16+**: Required for all Bibble versions
+
 ## Development
 
 ### Project structure