feat: add Diagnostics Integration documentation and related feature, 3.23.7 to .12 (#253)

hannesrudolph · web-flow · commit b52a76b9e586 · 2025-07-16T15:09:28.000-06:00
diff --git a/docs/basic-usage/context-mentions.md b/docs/basic-usage/context-mentions.md
@@ -63,6 +63,8 @@ Context mentions are a powerful way to provide Roo Code with specific informatio
 | **Groups** | Problems organized by file for better clarity |
 | **Best for** | Fixing errors without manual copying |
 
+For comprehensive details on how Roo Code integrates with VSCode's diagnostics system, see [Diagnostics Integration](/features/diagnostics-integration).
+
 ### Terminal Mention
 <img src="/img/context-mentions/context-mentions-4.png" alt="Terminal mention example showing terminal output being included in Roo's context" width="600" />
 
@@ -129,4 +131,11 @@ The dropdown automatically filters out common directories like `node_modules`, `
 | **`.gitignore` bypass** | Similarly, file and folder `@mentions` do not respect `.gitignore` rules when fetching content. |
 | **Git command respect** | Git-related mentions (`@git-changes`, `@commit-hash`) do respect `.gitignore` since they rely on Git commands. |
 
+---
+
+## Related Features
+
+- [Diagnostics Integration](/features/diagnostics-integration) - Learn about automatic error detection and smart severity filtering
+- [Code Actions](/features/code-actions) - Discover quick fixes and AI assistance directly in your editor
+- [Shell Integration](/features/shell-integration) - Understand how terminal mentions work with shell integration
 
diff --git a/docs/features/code-actions.md b/docs/features/code-actions.md
@@ -41,6 +41,8 @@ The lightbulb menu intelligently shows different actions based on your code's cu
 - **Improve Code** - Receive optimization suggestions and best practices
 - **Add to Context** - Add the code to Roo's context for further work
 
+For more details on how diagnostics are integrated with Code Actions, see [Diagnostics Integration](/features/diagnostics-integration).
+
 ### Add to Context Deep Dive
 
 The **Add to Context** action is listed first in the Code Actions menu so you can quickly add code snippets to your conversation. When you use it, Roo Code includes the filename and line numbers along with the code.
@@ -124,7 +126,7 @@ You can customize the prompts used for each Code Action by modifying the "Suppor
 3. **Edit the Prompts:** Modify the text in the text area for the prompt you want to customize. The prompts use placeholders in the format `${placeholder}`:
     - `${filePath}` - The path of the current file
     - `${selectedText}` - The currently selected text
-    - `${diagnostics}` - Any error or warning messages (for Fix Code)
+    - `${diagnostics}` - Any error or warning messages (for Fix Code) - see [Diagnostics Integration](/features/diagnostics-integration) for details
 4. **Click "Done":** Save your changes.
 
 ### Example Prompt Template
@@ -135,3 +137,10 @@ ${selectedText}
 ```
 
 By using Roo Code's Code Actions, you can quickly get AI-powered assistance directly within your coding workflow. This can save you time and help you write better code.
+
+---
+
+## Related Features
+
+- [Diagnostics Integration](/features/diagnostics-integration) - Learn how Roo Code integrates with VSCode's Problems panel
+- [Context Mentions](/basic-usage/context-mentions) - Discover other ways to provide context to Roo Code
diff --git a/docs/features/diagnostics-integration.md b/docs/features/diagnostics-integration.md
@@ -0,0 +1,149 @@
+# Diagnostics Integration
+
+Roo Code provides intelligent integration with VSCode's Problems panel, allowing the AI assistant to understand and help fix code errors, warnings, and other issues detected by language servers, linters, and other diagnostic providers.
+
+---
+
+## Overview
+
+The diagnostics feature seamlessly integrates with VSCode's diagnostic system to provide context-aware assistance for code issues. When you make edits or encounter problems in your code, Roo Code can automatically detect and help resolve them.
+
+### Key Capabilities
+- **Automatic Error Detection**: Captures new errors introduced during code edits
+- **Context-Aware Fixes**: Provides targeted fixes based on diagnostic information
+- **Workspace Problems Mention**: Access all workspace diagnostics through a simple mention
+- **Smart Filtering**: Uses predefined severity levels for different contexts
+
+---
+
+## Key Features
+
+### 1. Automatic Error Detection
+When Roo Code makes edits to files, it automatically:
+- Captures diagnostics before editing
+- Waits for diagnostics to update after editing
+- Detects new problems introduced by the changes
+- Only reports new errors (not pre-existing ones)
+
+This ensures you're immediately aware of any issues introduced by code changes, allowing for quick resolution.
+
+### 2. Workspace Problems Mention
+Users can include `@problems` in their messages to:
+- Get a complete list of workspace errors and warnings
+- Provide context for debugging tasks
+- Request fixes for specific issues
+
+Example usage:
+```
+@problems Fix all TypeScript errors in my project
+```
+
+For more details on using `@problems`, see [Context Mentions](/basic-usage/context-mentions#problems-mention).
+
+### 3. Code Actions Integration
+When diagnostics exist at a cursor position:
+- "Fix with Roo Code" action appears in quick fix menu
+- Includes diagnostic details in the fix request
+- Provides targeted solutions based on error context
+
+Learn more about this integration in [Code Actions](/features/code-actions#context-aware-actions).
+
+### 4. Smart Severity Filtering
+Different features use different severity filters to provide the most relevant information:
+- **Workspace Problems mention**: Shows errors and warnings
+- **Automatic detection**: Shows only errors (to avoid distraction)
+- **Context-Aware**: Different features use different hardcoded severity filters
+
+---
+
+## Severity Levels
+
+The diagnostics system recognizes four severity levels from VSCode:
+
+| Level | Value | Description | Workspace Problems | Auto-detection |
+|-------|-------|-------------|-------------------|----------------|
+| Error | 0 | Syntax errors, type errors, breaking issues | ✅ Included | ✅ Included |
+| Warning | 1 | Code quality issues, deprecations, style violations | ✅ Included | ❌ Not included |
+| Information | 2 | Suggestions, hints, informational messages | ❌ Not included | ❌ Not included |
+| Hint | 3 | Minor suggestions, refactoring opportunities | ❌ Not included | ❌ Not included |
+
+### Why Different Filters?
+
+- **Workspace Problems (`@problems`)**: Includes both errors and warnings to give you a complete picture of code health when explicitly requested
+- **Automatic Detection**: Only includes errors to avoid interrupting your workflow with non-critical issues
+
+---
+
+## Using Diagnostics Effectively
+
+### For Debugging Sessions
+When starting a debugging session, include `@problems` to give Roo Code full context:
+```
+@problems Help me debug why my application is crashing
+```
+
+### For Code Reviews
+Use diagnostics to ensure code quality:
+```
+@problems Review my code and fix any linting issues
+```
+
+### For Refactoring
+Let diagnostics guide safe refactoring:
+```
+I want to refactor this function. @problems shows current issues to address.
+```
+
+---
+
+## Integration with Other Features
+
+### Code Actions
+Diagnostics power the context-aware [Code Actions](/features/code-actions) that appear in VSCode's lightbulb menu. When errors are present, you'll see "Fix Code" options that include the specific diagnostic information.
+
+### Context Mentions
+The [`@problems` mention](/basic-usage/context-mentions#problems-mention) provides a convenient way to include all workspace diagnostics in your conversation without manually copying error messages.
+
+### Automatic Error Reporting
+When Roo Code edits files, any new errors introduced are automatically reported in the response, helping maintain code quality throughout the editing process.
+
+---
+
+## Best Practices
+
+1. **Use `@problems` for Context**: When debugging, always include `@problems` to give Roo Code full visibility into current issues
+
+2. **Address Errors First**: Focus on fixing errors before warnings, as errors typically prevent code from running
+
+3. **Leverage Code Actions**: Use the quick fix menu for targeted fixes to specific diagnostics
+
+4. **Monitor Auto-Detection**: Pay attention to new errors reported after edits to catch issues early
+
+5. **Combine with Other Tools**: Use diagnostics alongside other Roo Code features like codebase search and file mentions for comprehensive problem-solving
+
+---
+
+## Troubleshooting
+
+### Diagnostics Not Appearing
+- Ensure your language server or linter is properly configured and running
+- Check that the file type is supported by your diagnostic providers
+- Verify that VSCode's Problems panel shows the issues
+
+### `@problems` Shows Nothing
+- Confirm there are actually problems in the Problems panel
+- Check that you're in the correct workspace
+- Some diagnostic providers may take time to initialize
+
+### Auto-Detection Missing Errors
+- Only new errors (introduced by edits) are reported
+- Pre-existing errors won't be shown in auto-detection
+- Use `@problems` to see all current issues
+
+---
+
+## Related Features
+
+- [Context Mentions](/basic-usage/context-mentions) - Learn about all mention types including `@problems`
+- [Code Actions](/features/code-actions) - Discover how diagnostics integrate with quick fixes
+- [Codebase Search](/features/codebase-indexing) - Find code related to specific errors
diff --git a/docs/update-notes/index.md b/docs/update-notes/index.md
@@ -5,6 +5,12 @@ This section contains notes about recent updates to Roo Code, listed by version
 
 ## Version 3.23
 
+*   [3.23.12](/update-notes/v3.23.12) (2025-01-13)
+*   [3.23.11](/update-notes/v3.23.11) (2025-01-13)
+*   [3.23.10](/update-notes/v3.23.10) (2025-01-13)
+*   [3.23.9](/update-notes/v3.23.9) (2025-01-13)
+*   [3.23.8](/update-notes/v3.23.8) (2025-01-13)
+*   [3.23.7](/update-notes/v3.23.7) (2025-01-13)
 *   [3.23.6](/update-notes/v3.23.6) (2025-07-10)
 *   [3.23.5](/update-notes/v3.23.5) (2025-07-10)
 *   [3.23.4](/update-notes/v3.23.4) (2025-07-10)
diff --git a/docs/update-notes/v3.23.10.mdx b/docs/update-notes/v3.23.10.mdx
@@ -0,0 +1,11 @@
+# Roo Code 3.23.10 Release Notes (2025-01-13)
+
+This release improves codebase indexing reliability and enhances the user interface.
+
+## Bug Fixes
+
+* **Code Indexing**: Fixed code indexing to use optimal model dimensions, improving indexing reliability and performance (thanks daniel-lxs!) ([#5705](https://github.com/RooCodeInc/Roo-Code/pull/5705))
+
+## QOL Improvements
+
+* **Model Selection Interface**: Improved visual appearance and spacing in the code index model selection interface for better usability
diff --git a/docs/update-notes/v3.23.11.mdx b/docs/update-notes/v3.23.11.mdx
@@ -0,0 +1,15 @@
+# Roo Code 3.23.11 Release Notes (2025-01-13)
+
+This release adds new provider options and improves mode navigation.
+
+## Provider Updates
+
+* **Groq Kimi K2**: Added Kimi K2 model option for Groq users with improved token handling reliability for models with equal max tokens and context window
+
+## QOL Improvements
+
+* **Mode Navigation**: Added bidirectional mode cycling with Cmd+Shift+. keyboard shortcut to switch to previous mode, making mode navigation more efficient when you overshoot your target mode (thanks mkdir700!) ([#5695](https://github.com/RooCodeInc/Roo-Code/pull/5695))
+
+## Misc Improvements
+
+* **GitHub Actions**: Fixed GitHub Actions workflow warnings by removing invalid parameters from CI/CD configuration (thanks hamirmahal!) ([#5676](https://github.com/RooCodeInc/Roo-Code/pull/5676))
diff --git a/docs/update-notes/v3.23.12.mdx b/docs/update-notes/v3.23.12.mdx
@@ -0,0 +1,7 @@
+# Roo Code 3.23.12 Release Notes (2025-01-13)
+
+This release improves token handling consistency across API providers.
+
+## Misc Improvements
+
+* **Token Handling**: Improved consistency in token handling across API providers with centralized max-token calculation logic for better reliability
diff --git a/docs/update-notes/v3.23.7.mdx b/docs/update-notes/v3.23.7.mdx
@@ -0,0 +1,33 @@
+# Roo Code 3.23.7 Release Notes (2025-01-13)
+
+This release improves codebase indexing reliability, adds new provider options, and enhances the user interface.
+
+## Provider Updates
+
+* **Devstral Medium**: Added support for Mistral's Devstral Medium model with 131,000 token context window and image support capabilities
+* **Claude Code**: Added configurable maximum output tokens setting (8,000-64,000 tokens) for complex code generation tasks
+* **Vertex AI**: Expanded region configuration to include all available GCP Vertex AI regions for better compliance and access to third-party models like Anthropic Claude (thanks shubhamgupta731!) ([#5557](https://github.com/RooCodeInc/Roo-Code/pull/5557))
+
+## Bug Fixes
+
+* **Context Token Display**: Fixed inflated context token count displays by excluding cache tokens from calculation, showing accurate context window usage (thanks daniel-lxs!) ([#5603](https://github.com/RooCodeInc/Roo-Code/pull/5603))
+* **Codebase Indexing Errors**: Fixed cryptic error messages when configuring codebase indexing - users now see clear, understandable error messages instead of translation keys (thanks daniel-lxs, nikhil-swamix!) ([#5574](https://github.com/RooCodeInc/Roo-Code/pull/5574))
+* **Embedding Model Switching**: Fixed issues when switching between embedding models with different vector dimensions, allowing use of models beyond 1536 dimensions like Google Gemini's text-embedding-004 (thanks daniel-lxs, mkdir700!) ([#5565](https://github.com/RooCodeInc/Roo-Code/pull/5565))
+* **Mermaid Diagrams**: Fixed Mermaid diagram rendering issues in architect mode by preventing common syntax errors (thanks MuriloFP, joshmouch!) ([#5530](https://github.com/RooCodeInc/Roo-Code/pull/5530))
+* **UI Button Overlap**: Fixed overlapping enhancement and text-to-speech buttons, making both features accessible when text-to-speech is enabled (thanks sensei-woo!) ([#5586](https://github.com/RooCodeInc/Roo-Code/pull/5586))
+
+## QOL Improvements
+
+* **Marketplace Access**: Added Marketplace buttons to both MCP and modes tabs for easier discovery and access
+* **MCP Interface**: Improved MCP UI with toggle switches instead of eye buttons for enabling/disabling tools and servers, providing clearer visual feedback
+* **Codebase Search**: Cleaner and more readable codebase search results with improved visual styling and better internationalization
+* **Error Messages**: Friendlier error messages when API configuration profiles aren't compatible with organization settings
+* **Architect Mode**: Intelligently selects the best available tools for context discovery, including semantic search when available
+
+## Misc Improvements
+
+* **Error Telemetry**: Improved debugging capabilities for better reliability and faster issue resolution, with enhanced privacy protection through hashed file paths (thanks daniel-lxs!) ([#5595](https://github.com/RooCodeInc/Roo-Code/pull/5595))
+
+## Documentation Updates
+
+* **Typo Fixes**: Improved accuracy and clarity of documentation and code comments across multiple files (thanks noritaka1166!) ([#5569](https://github.com/RooCodeInc/Roo-Code/pull/5569))
diff --git a/docs/update-notes/v3.23.8.mdx b/docs/update-notes/v3.23.8.mdx
@@ -0,0 +1,24 @@
+# Roo Code 3.23.8 Release Notes (2025-01-13)
+
+This release adds command workflow controls and improves the user interface.
+
+## Command Denylist
+
+We've added the ability to automatically reject unwanted commands in your workflows (thanks hannesrudolph!) ([#5614](https://github.com/RooCodeInc/Roo-Code/pull/5614)):
+
+- **Always Reject**: Mark commands as "always reject" to prevent accidental execution
+- **Time Saving**: No need to manually reject the same commands repeatedly  
+- **Workflow Control**: Complements existing auto-approval functionality with "always reject" option
+
+This gives you better control over command execution in automated workflows.
+
+## QOL Improvements
+
+* **Codebase Indexing Toggle**: Added enable/disable checkbox for codebase indexing in settings with state persistence across sessions (thanks daniel-lxs, elasticdotventures!) ([#5599](https://github.com/RooCodeInc/Roo-Code/pull/5599))
+* **Chat Interface**: Improved chat layout with better organization and increased task history visibility (3 tasks instead of 2)
+* **Command Messaging**: Clearer messaging when command prefixes are denied - users now see that denial is due to their settings rather than automatic system behavior
+* **History Navigation**: Added "View all history" link to the HistoryPreview component for easier access to full task history when the history tab is hidden
+
+## Misc Improvements
+
+* **Type Definitions**: Updated internal type definitions for improved compatibility and development experience
diff --git a/docs/update-notes/v3.23.9.mdx b/docs/update-notes/v3.23.9.mdx
@@ -0,0 +1,28 @@
+# Roo Code 3.23.9 Release Notes (2025-01-13)
+
+This release adds Windows support for Claude Code, introduces configurable command timeouts, and fixes critical workflow issues.
+
+## Windows Support
+
+We've added native Windows support for the Claude Code provider (thanks SannidhyaSah, kwk9892!) ([#5615](https://github.com/RooCodeInc/Roo-Code/pull/5615)):
+
+- **Fixed Windows Compatibility**: Claude Code provider no longer gets stuck on Windows systems
+- **Improved Input Handling**: Uses stdin-based input to eliminate command-line length limitations
+- **Cross-Platform**: Works reliably across Windows, macOS, and Linux
+
+## Command Execution Improvements
+
+We've added configurable timeout settings for command execution:
+
+- **Timeout Control**: Set timeouts from 0-600 seconds to prevent long-running commands from blocking workflows
+- **Clear Error Messages**: Commands that timeout display helpful error messages
+- **Better Visual Feedback**: Timeout errors now appear in red for better visibility
+
+## Bug Fixes
+
+* **Directory Tracking**: Fixed command execution directory tracking - Roo Code now properly maintains awareness of the current working directory when executing commands, preventing issues where subsequent commands would run in the wrong location after using `cd` commands (thanks chris-garrett!) ([#5667](https://github.com/RooCodeInc/Roo-Code/pull/5667))
+* **Embedding Model Switching**: Fixed vector dimension mismatch errors when switching between embedding models with different dimensions, allowing successful transitions from high-dimensional models to lower-dimensional models like Google Gemini (thanks hubeizys!) ([#5617](https://github.com/RooCodeInc/Roo-Code/pull/5617))
+
+## Provider Updates
+
+* **Google Gemini**: Added support for Google's new gemini-embedding-001 model with improved performance and higher dimensional embeddings (3072 vs 768) for better codebase indexing and search (thanks daniel-lxs!) ([#5698](https://github.com/RooCodeInc/Roo-Code/pull/5698))
diff --git a/docs/update-notes/v3.23.mdx b/docs/update-notes/v3.23.mdx
diff --git a/sidebars.ts b/sidebars.ts
