v0.1.4

Author: codeitlikemiley

Cargo.toml

@@ -36,7 +36,7 @@ chrono = { version = "0.4", features = ["serde"] }
 fuzzy-matcher = "0.3"
 
 # Validation system dependencies
-raz-validation = { path = "raz-validation", version = "0.1.3" }
+raz-validation = { path = "raz-validation", version = "0.1.4" }
 
 [profile.release]
 opt-level = 3

raz-adapters/cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "raz-cli"
-version = "0.1.3"
+version = "0.1.4"
 edition = "2024"
 description = "Universal command runner for Rust - Run any Rust file from anywhere with cursor-aware test targeting and override persistence"
 license = "MIT"
@@ -18,10 +18,10 @@ name = "raz"
 path = "src/main.rs"
 
 [dependencies]
-raz-common = { path = "../../raz-common", version = "0.1.3" }
-raz-core = { path = "../../raz-core", version = "0.1.3" }
-raz-config = { path = "../../raz-config", version = "0.1.3" }
-raz-override = { path = "../../raz-override", version = "0.1.3" }
+raz-common = { path = "../../raz-common", version = "0.1.4" }
+raz-core = { path = "../../raz-core", version = "0.1.4" }
+raz-config = { path = "../../raz-config", version = "0.1.4" }
+raz-override = { path = "../../raz-override", version = "0.1.4" }
 clap = { workspace = true }
 tokio = { workspace = true }
 serde_json = { workspace = true }

raz-adapters/vscode/CHANGELOG.md

@@ -0,0 +1,73 @@
+# Changelog
+
+All notable changes to the RAZ VS Code extension 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).
+
+## [0.1.4-pre] - 2025-01-05 (Pre-release)
+
+### 🐛 Added - Intelligent Debugging Integration
+
+- **Breakpoint-Driven Debugging**: Automatic detection of breakpoints in symbol ranges
+- **Seamless rust-analyzer Integration**: Uses rust-analyzer's debug codelens when breakpoints are detected
+- **Smart Mode Switching**: Automatically switches between debug and run modes based on breakpoint presence
+- **Symbol-Aware Detection**: Intelligently finds the most relevant symbol at cursor position
+- **Zero Configuration**: No debug setup required - just set breakpoints and run
+
+### 🔧 New Features
+
+- **New Commands**:
+  - `raz.toggleBreakpointDetection` - Toggle automatic breakpoint detection
+  - `raz.showDebugInfo` - Show debugging information for current cursor position
+- **New Configuration Options**:
+  - `raz.enableBreakpointDetection` - Enable/disable breakpoint detection (default: true)
+  - `raz.useRustAnalyzerCodeLens` - Use rust-analyzer codelens for debugging (default: true)
+  - `raz.prioritySymbolKinds` - Configure symbol types for debugging context
+  - `raz.logLevel` - Set logging level for debugging features
+
+### 🚀 Improvements
+
+- **Enhanced User Experience**: Single `Cmd+R` now intelligently chooses between debug and run modes
+- **Performance**: Fast RAZ execution when no breakpoints are present
+- **Reliability**: Fallback to RAZ execution if rust-analyzer debugging fails
+- **Symbol Priority**: Configurable symbol type priorities for better context detection
+
+### 🧠 Technical Details
+
+- Implemented breakpoint range detection using VSCode's debugging API
+- Added symbol traversal with priority-based filtering
+- Integrated with rust-analyzer's codelens system for debugging
+- Added comprehensive error handling and fallback mechanisms
+
+### 📚 Documentation
+
+- Updated README.md with debugging integration documentation
+- Enhanced INSTALL.md with debugging setup instructions
+- Added configuration examples for debugging features
+
+## [0.1.3] - Previous Release
+
+### Features
+- Override system with deferred save mechanism
+- Task runner integration
+- Cross-IDE override persistence
+- Smart test detection
+- Framework-aware command generation
+
+## [0.1.2] - Previous Release
+
+### Features
+- Basic command execution
+- Binary management
+- Configuration system
+
+## [0.1.1] - Previous Release
+
+### Features
+- Initial VS Code extension release
+- Basic Rust file execution
+
+---
+
+For more details, see the [README.md](README.md) and [project repository](https://github.com/codeitlikemiley/raz).

raz-adapters/vscode/INSTALL.md

@@ -42,7 +42,7 @@ npm run vscode:prepublish
 vsce package
 ```
 
-This creates a `.vsix` file (e.g., `raz-vscode-0.1.0.vsix`) in the vscode directory.
+This creates a `.vsix` file (e.g., `raz-vscode-0.1.4.vsix`) in the vscode directory.
 
 ## Installing the Extension
 
@@ -51,14 +51,14 @@ This creates a `.vsix` file (e.g., `raz-vscode-0.1.0.vsix`) in the vscode direct
 1. Open VS Code
 2. Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux)
 3. Type: `Extensions: Install from VSIX...`
-4. Navigate to and select: `/path/to/raz/raz-adapters/vscode/raz-vscode-0.1.0.vsix`
+4. Navigate to and select: `/path/to/raz/raz-adapters/vscode/raz-vscode-0.1.4.vsix`
 5. Click "Install"
 6. Reload VS Code when prompted
 
 ### Method 2: Using Command Line
 
 ```bash
-code --install-extension /path/to/raz/raz-adapters/vscode/raz-vscode-0.1.0.vsix
+code --install-extension /path/to/raz/raz-adapters/vscode/raz-vscode-0.1.4.vsix
 ```
 
 ### Method 3: Using Extensions View
@@ -79,6 +79,12 @@ code --install-extension /path/to/raz/raz-adapters/vscode/raz-vscode-0.1.0.vsix
    - Open any `.rs` file
    - Press `Cmd+R` (Mac) or `Ctrl+R` (Windows/Linux)
    - RAZ should analyze the file and run the appropriate command
+   
+3. **Test Debugging Integration**
+   - Open a Rust file with a test function
+   - Set a breakpoint by clicking in the gutter
+   - Press `Cmd+R` - should automatically enter debug mode
+   - Remove breakpoint and press `Cmd+R` - should use fast execution
 
 ## Uninstalling
 
@@ -144,4 +150,8 @@ After installation, configure the extension:
 2. Search for "raz"
 3. Available settings:
    - `raz.showOutput`: Show output in terminal (default: true)
-   - `raz.useTaskRunner`: Use VS Code tasks for better concurrency (default: true)
+   - `raz.useTaskRunner`: Use VS Code tasks for better concurrency (default: true)
+   - `raz.enableBreakpointDetection`: Enable automatic debugging when breakpoints are detected (default: true)
+   - `raz.useRustAnalyzerCodeLens`: Use rust-analyzer codelens for debugging (default: true)
+   - `raz.prioritySymbolKinds`: Symbol types to prioritize for debugging context
+   - `raz.logLevel`: Logging level for debugging features

raz-adapters/vscode/README.md

@@ -15,7 +15,7 @@
 - **Framework Aware**: Specialized commands for Leptos, Dioxus, Tauri, Bevy, Yew, and more
 - **Task Runner Support**: Run multiple commands concurrently using VS Code's task system
 - **🔥 Cross-IDE Override Persistence**: Save overrides in VS Code, use them in terminal, Vim, IntelliJ, or anywhere!
-- **🐛 Intelligent Debugging**: Automatic LLDB integration with breakpoint detection and debug mode switching
+- **🐛 Intelligent Debugging**: Automatic rust-analyzer debug integration with breakpoint detection and seamless debug/run mode switching
 - **Zero Configuration**: Works immediately without any setup
 
 ## Usage
@@ -26,18 +26,27 @@
 2. Press **Cmd+R** (Mac) or **Ctrl+R** (Windows/Linux)
 3. RAZ will:
    - Detect the file type and project context
-   - Generate appropriate commands
+   - **Check for breakpoints** in the current symbol's range
    - **Automatically switch to debug mode** if breakpoints are detected
-   - Execute the top priority command automatically
+   - Use rust-analyzer's debug codelens for debugging or fallback to RAZ execution
 
-### Debug Mode (Cmd+Shift+D)
+### Intelligent Debugging (Automatic)
 
-1. Set breakpoints in your Rust code
-2. Press **Cmd+Shift+D** (Mac) or **Ctrl+Shift+D** (Windows/Linux) to force debug mode
-3. RAZ will:
-   - Build your code in debug mode
-   - Launch CodeLLDB debugger
-   - Stop at your breakpoints for inspection
+RAZ v0.1.4 introduces **breakpoint-driven debugging** that seamlessly integrates with rust-analyzer:
+
+1. **Set breakpoints** in your Rust code by clicking in the gutter
+2. **Press Cmd+R** as normal - RAZ automatically detects breakpoints
+3. **Debug mode activates** when breakpoints are found in the current symbol
+4. **Run mode** is used when no breakpoints are present
+
+#### How It Works
+
+- **Symbol Detection**: RAZ finds the symbol at your cursor position
+- **Breakpoint Scanning**: Checks for breakpoints within that symbol's range  
+- **Smart Switching**: 
+  - ✅ **Breakpoints found** → Executes rust-analyzer's "Debug" codelens command
+  - ⚡ **No breakpoints** → Uses fast RAZ execution
+- **Zero Configuration**: Leverages existing rust-analyzer + CodeLLDB setup
 
 ### Override Usage (Cmd+Shift+R)
 
@@ -94,6 +103,8 @@ To see all available commands:
 Additional commands available through the Command Palette:
 - **"RAZ: Open RAZ Settings"**: Open VS Code settings for RAZ
 - **"RAZ: Setup RAZ Binary"**: Guided setup for RAZ binary installation
+- **"RAZ: Toggle Breakpoint Detection"**: Enable/disable automatic breakpoint detection
+- **"RAZ: Show Debug Info"**: Show debugging information for current cursor position
 
 ## Override Persistence with Deferred Save
 
@@ -151,8 +162,8 @@ For CLI-based management, see the [Override Management Guide](https://github.com
   // Use VS Code tasks for better concurrency (default: true)
   "raz.useTaskRunner": true,
 
-  // Automatically start debugging when breakpoints are detected (default: true)
-  "raz.autoDebugOnBreakpoints": true,
+  // Enable automatic breakpoint detection for debugging (default: true)
+  "raz.enableBreakpointDetection": true,
 
   // Custom path to RAZ binary (optional)
   // If not set, the extension will automatically download and manage the binary
@@ -169,14 +180,15 @@ RAZ automatically downloads and manages the binary for your platform:
 - **Custom Path**: Set `raz.path` to use your own RAZ installation
 - **Lightweight Extension**: No bundled binaries - smaller download size
 
-### Debugging Requirements
+### Debugging Integration
 
-For debugging support, RAZ integrates with CodeLLDB:
+RAZ v0.1.4 seamlessly integrates with rust-analyzer and CodeLLDB for debugging:
 
-- **CodeLLDB Extension**: Automatically installs `vadimcn.vscode-lldb` as a dependency
-- **Debug Configuration**: RAZ automatically creates debug configurations for your Rust binaries
-- **Breakpoint Detection**: Automatically switches to debug mode when breakpoints are present
-- **Test Debugging**: Supports debugging individual tests, benchmarks, and examples
+- **Direct Codelens Execution**: Simply executes rust-analyzer's "Debug" codelens command when breakpoints are found
+- **Automatic Detection**: Detects breakpoints within symbol ranges automatically  
+- **Zero Configuration**: Leverages your existing rust-analyzer + CodeLLDB setup
+- **Fallback Support**: Falls back to fast RAZ execution when no breakpoints are detected
+- **Extension Dependencies**: Automatically installs rust-analyzer and CodeLLDB extensions
 
 ## Common Overrides
 
@@ -206,10 +218,11 @@ For debugging support, RAZ integrates with CodeLLDB:
 Place your cursor on a test function and press Cmd+R:
 ```rust
 #[test]
-fn test_auth() { // <- Cursor here + Cmd+R
-    assert!(true);
+fn test_auth() { // <- Cursor here + Cmd+R + Breakpoint = Debug mode!
+    assert!(true);  // <- Set breakpoint here for automatic debugging
 }
-// Executes: cargo test -- tests::test_auth --exact
+// Without breakpoints: cargo test -- tests::test_auth --exact
+// With breakpoints: rust-analyzer debug mode with full debugging support
 ```
 
 ### Running Binaries
@@ -282,7 +295,7 @@ See [INSTALL.md](INSTALL.md) for detailed installation instructions.
    ```
 4. Install the extension:
    ```bash
-   code --install-extension raz-vscode-0.1.3.vsix
+   code --install-extension raz-vscode-0.1.4.vsix
    ```
 
 ### For Development/Contributing

raz-adapters/vscode/RELEASE_NOTES.md

@@ -0,0 +1,104 @@
+# RAZ VS Code Extension v0.1.4-pre Release Notes
+
+## 🚨 Pre-release Version
+
+This is a **pre-release** version to test the new features, especially the binary auto-download functionality. Please report any issues at [GitHub Issues](https://github.com/codeitlikemiley/raz/issues).
+
+## 🎯 Highlights
+
+### 🐛 Intelligent Debugging Integration (NEW!)
+- **Automatic Breakpoint Detection**: Set a breakpoint and press `Cmd+R` - RAZ automatically switches to debug mode
+- **Seamless Mode Switching**: No breakpoints? Get instant RAZ execution. With breakpoints? Launch the debugger
+- **Zero Configuration**: Works out of the box with rust-analyzer and CodeLLDB
+- **Opt-in Feature**: Can be disabled via `raz.enableBreakpointDetection` setting
+
+### 📦 Binary Auto-Download (NEEDS TESTING!)
+- **Automatic Platform Detection**: Downloads the correct binary for your OS and architecture
+- **No Manual Setup**: Extension manages RAZ binary installation automatically
+- **Fallback Options**: Can still use system-installed RAZ or custom binary path
+- **Lightweight Extension**: No bundled binaries means smaller download size
+
+### 🔧 Enhanced Features
+- **Task Runner Integration**: Better concurrency with VS Code's task system
+- **Override Persistence**: Save custom command configurations that persist across sessions
+- **Deferred Save**: Overrides only saved after successful execution
+- **Extension Dependencies**: Automatically installs rust-analyzer and CodeLLDB
+
+## 📋 Testing Checklist for Pre-release
+
+Please help test these features:
+
+### Binary Auto-Download
+- [ ] Extension downloads binary on first use
+- [ ] Platform detection works correctly (Linux/macOS/Windows)
+- [ ] Binary has correct permissions
+- [ ] Fallback to system RAZ works
+- [ ] Custom binary path setting works
+
+### Debugging Integration
+- [ ] Breakpoint detection works inside functions
+- [ ] Debug mode launches with breakpoints
+- [ ] Run mode executes without breakpoints
+- [ ] Cursor position detection is accurate
+- [ ] Works with tests, benchmarks, and regular functions
+
+### General Functionality
+- [ ] `Cmd+R` executes correctly
+- [ ] `Cmd+Shift+R` shows override dialog
+- [ ] Task runner executes commands
+- [ ] Override persistence works
+- [ ] Error messages are helpful
+
+## 🔄 Upgrade Instructions
+
+1. **Backup your settings** if you have custom RAZ configurations
+2. **Uninstall previous version** (optional but recommended)
+3. **Install pre-release**:
+   ```bash
+   code --install-extension raz-vscode-0.1.4.vsix
+   ```
+4. **Test the features** and report issues
+
+## ⚙️ Configuration
+
+### New Settings
+```json
+{
+  // Enable automatic debugging when breakpoints detected (default: true)
+  "raz.enableBreakpointDetection": true,
+  
+  // Path to RAZ binary (leave empty for auto-download)
+  "raz.path": "",
+  
+  // Use VS Code tasks for better concurrency (default: true)
+  "raz.useTaskRunner": true,
+  
+  // Show output in terminal (default: true)
+  "raz.showOutput": true
+}
+```
+
+## 🐞 Known Issues
+
+1. **Binary auto-download not tested in production** - This is why it's a pre-release
+2. **Debugging may not work outside functions** - By design, but may be confusing
+3. **Some codelens edge cases** - Complex macro-generated tests might not detect properly
+
+## 📝 Feedback
+
+Please report issues with:
+- Your OS and architecture
+- VS Code version
+- Rust toolchain version
+- Specific error messages
+- Steps to reproduce
+
+Report at: https://github.com/codeitlikemiley/raz/issues
+
+## 🙏 Thank You
+
+Thank you for testing the pre-release! Your feedback helps make RAZ better for everyone.
+
+---
+
+**Note**: Once testing is complete and issues are resolved, we'll release the stable v0.1.4.