docs: add v3.27.0 release notes; update index and sidebar (#334)

Author: hannesrudolph

.roo/tmp/release-notes/docs_followups_v3.27.0.md

@@ -0,0 +1,57 @@
+# v3.27.0 Documentation Follow-ups
+
+Tracking doc updates stemming from the 3.27.0 release. When done, open a PR referencing these items and the related PRs: #7447, #7713, #7701, #6904.
+
+## 1) Edit/Delete Message feature + Auto Checkpoints
+
+Target files:
+- [docs/features/checkpoints.mdx](docs/features/checkpoints.mdx)
+- [docs/basic-usage/the-chat-interface.md](docs/basic-usage/the-chat-interface.md)
+
+Required updates:
+- [ ] Describe automatic checkpoint creation on every user message
+  - Runs in background and suppresses extra chat messages
+  - Allows immediate rollback even when no file diffs exist
+- [ ] Add a short “rollback after edit/delete” example flow
+  - Edit or delete a message
+  - Open Checkpoint Restore dialog
+  - Preview and confirm rollback
+- [ ] Cross-link from The Chat Interface to Checkpoints (and vice versa)
+
+Notes:
+- Feature PRs: #7447 (Edit/Delete), #7713 (Auto checkpoint creation)
+
+## 2) Chutes provider model update: Kimi K2-0905
+
+Target file:
+- [docs/providers/chutes.md](docs/providers/chutes.md)
+
+Required updates:
+- [ ] Add Kimi K2-0905 model to the supported models list
+  - Context window: 256k
+  - Max tokens: 32,768
+  - Images: unsupported
+  - Prompt cache: unsupported
+  - Pricing: include current pricing table row if maintained here
+- [ ] Brief note on how to select this model in configuration
+
+Notes:
+- Provider PR: #7701 (linked issue #7700)
+
+## 3) Multi-root workspaces: MCP and Slash Command paths
+
+Target files:
+- [docs/features/slash-commands.mdx](docs/features/slash-commands.mdx)
+- [docs/features/mcp/overview.md](docs/features/mcp/overview.md)
+
+Required updates:
+- [ ] Clarify that Roo resolves configuration paths using the active folder’s CWD in multi-folder workspaces
+- [ ] Mention expected .roo directory location resolution per active folder
+
+Notes:
+- Fix PR: #6904
+
+## Nice-to-haves (optional now)
+
+- [ ] Add a short tip in Checkpoints about background saves and reduced chat noise
+- [ ] Consider a snippet in The Chat Interface showing message-level actions (edit/delete) UI

.roomodes

@@ -1,6 +1,6 @@
 customModes:
   - slug: release-notes-writer
-    name: Release Notes Writer
+    name: 📝 Release Notes Writer
     roleDefinition: "You are a technical writer for Roo Code release notes. Your job is to: - Automate release note creation. - Fetch and analyze GitHub pull requests. - Convert technical changes into user benefits. - Ensure updates align with documentation standards. - Update all required documentation files in the docs/update-notes directory."
     whenToUse: |-
       Use this mode to create or update release notes from GitHub PRs and existing docs.
@@ -47,7 +47,7 @@ customModes:
       - mcp
     source: project
   - slug: documentation-writer
-    name: 📝 Documentation Writer
+    name: 📖 Documentation Writer
     roleDefinition: You are a technical documentation writer for the Roo Code project. Your writing is direct, concise, and technical. You write for a developer audience and follow the instructions in the .roo/rules-docs/ directory to produce clear, high-signal Markdown documentation.
     whenToUse: Use this mode for creating or updating documentation in Markdown (.md, .mdx) files.
     description: Creates and maintains Roo technical docs.

docs/basic-usage/the-chat-interface.md

@@ -29,11 +29,11 @@ The chat interface consists of the following main elements:
 
 4. **Send Button:** This looks like a small plane and it's located to the far right of the input field. This sends messages to Roo after you've typed them.
 
-5. **Plus Button:** The plus button is located at the top in the header, and it resets the current session.
+5. **Plus Button:** The plus button is located at the top in the header. It switches to the Chat tab and focuses the input. To reset the session, start a new task or clear the current task.
 
 6. **Settings Button:** The settings button is a gear, and it's used for opening the settings to customize features or behavior.
 
-7. **Mode Selector:** The mode selector is a dropdown located to the left of the chat input field. It is used for selecting which mode Roo should use for your tasks.
+7. **Mode Selector:** The mode selector is a dropdown located to the left of the chat input field. It is used for selecting which mode Roo should use for your tasks. Its settings gear opens the Modes tab, not general settings.
 
 <img src="/img/the-chat-interface/the-chat-interface-1.png" alt="Chat interface components labeled with numbered callouts" width="900" />
 

docs/features/checkpoints.mdx

@@ -61,7 +61,7 @@ Access checkpoint settings in Roo Code settings under the "Checkpoints" section:
 
 ## How Checkpoints Work
 
-Roo Code captures snapshots of your project's state using a shadow Git repository, separate from your main version control system. These snapshots, called checkpoints, are automatically created **before** file modifications occur, ensuring you can always undo unwanted changes. Checkpoints are recorded throughout your AI-assisted workflow—when tasks begin, before files change, and before commands run.
+Roo Code captures snapshots of your project's state using a shadow Git repository, separate from your main version control system. These snapshots, called checkpoints, are automatically created **before** file modifications occur, ensuring you can always undo unwanted changes. Checkpoints are recorded when tasks begin and before file modifications. They are not automatically created before command execution.
 
 Checkpoints are stored as Git commits in the shadow repository, capturing:
 
@@ -82,7 +82,7 @@ Checkpoints appear directly in your chat history:
 - **Task checkpoint** marks your starting project state
    <img src="/img/checkpoints/checkpoints-1.png" alt="Task checkpoint indicator in chat" width="500" />
 
-- **Regular checkpoints** are created before file modifications or command execution, allowing easy undo of any changes
+- **Regular checkpoints** are created before file modifications, allowing easy undo of any changes
    <img src="/img/checkpoints/checkpoints-2.png" alt="Regular checkpoint indicator in chat" width="500" />
 
 Each checkpoint provides two primary functions:
@@ -100,7 +100,7 @@ To compare your current workspace with a previous checkpoint:
    - Added lines are highlighted in green
    - Removed lines are highlighted in red
    - Modified files are listed with detailed changes
-   - Renamed and moved files are tracked with their path changes
+   - Renames may not always be detected; diffs reflect per-file changes between commits
    - New or deleted files are clearly marked
 
 <img src="/img/checkpoints/checkpoints-3.png" alt="View differences option for checkpoints" width="800" />
@@ -164,7 +164,7 @@ Checkpoints are task-scoped, meaning they are specific to a single task.
 Checkpoint comparison uses Git's underlying diff capabilities to produce structured file differences:
 - Modified files show line-by-line changes
 - Binary files are properly detected and handled
-- Renamed and moved files are tracked correctly
+- Rename detection may be limited; diffs focus on file content changes between checkpoints
 - File creation and deletion are clearly identified
 
 ### File Exclusion and Ignore Patterns
@@ -190,6 +190,10 @@ The checkpoint system respects `.gitignore` patterns in your workspace:
 - Excluded files won't appear in checkpoint diffs
 - Standard Git ignore rules apply when staging file changes
 
+#### Git LFS Patterns
+
+Patterns defined in your workspace's `.gitattributes` for Git LFS are read and added to checkpoint exclusions. This helps avoid tracking large LFS-managed assets in the shadow repository.
+
 #### .rooignore Behavior
 
 The `.rooignore` file (which controls AI access to files) is separate from checkpoint tracking:
@@ -200,15 +204,11 @@ This separation is intentional, as `.rooignore` limits which files the AI can ac
 
 #### Nested Git Repositories
 
-The checkpoint system includes special handling for nested Git repositories:
-- Temporarily renames nested `.git` directories to `.git_disabled` during operations
-- Restores them after operations complete
-- Allows proper tracking of files in nested repositories
-- Ensures nested repositories remain functional and unaffected
+If nested Git repositories are detected in your workspace, checkpoints are disabled. Remove or relocate nested repositories to enable checkpoints.
 
 ### Concurrency Control
 
-Operations are queued to prevent concurrent Git operations that might corrupt repository state. This ensures that rapid checkpoint operations complete safely even when requested in quick succession.
+The extension prevents duplicate checkpointing within a single streaming operation. There is no dedicated Git operation queue.
 
 ---
 

docs/update-notes/index.md

@@ -15,6 +15,13 @@ image: /img/social-share.jpg
 # Update Notes
 
 
+---
+ 
+### Version 3.27
+
+*   [3.27.0](/update-notes/v3.27.0) (2025-09-05)
+
+---
 ---
 
 ### Version 3.26

docs/update-notes/v3.27.0.mdx

@@ -0,0 +1,59 @@
+---
+description: Edit or delete messages with instant rollback checkpoints, Kimi K2-0905 provider update, and stability fixes across indexing, grounding, and multi-root workspaces.
+keywords:
+  - roo code 3.27.0
+  - release notes
+  - edit messages
+  - delete messages
+  - checkpoints
+  - auto checkpoints
+  - rollback
+  - chutes provider
+  - kimi k2-0905
+  - 256k context
+  - provider update
+  - codebase indexing
+  - multi-root workspace
+  - mcp config
+  - slash commands
+  - gemini grounding
+  - citations
+  - openai responses api
+  - previous_response_id
+  - vscode terminal profiles
+  - ci e2e
+image: /img/social-share.jpg
+---
+
+# Roo Code 3.27.0 Release Notes (2025-09-05)
+
+This release adds message editing and deletion with instant rollback checkpoints, updates the Chutes provider with Kimi K2-0905, and improves reliability across indexing, grounding, and multi-root workspaces.
+
+## Edit and delete messages with instant rollback checkpoints
+
+Edit or delete any chat message and quickly recover from mistakes using automatic checkpoints (thanks NaccOll!) ([#7447](https://github.com/RooCodeInc/Roo-Code/pull/7447), [#7713](https://github.com/RooCodeInc/Roo-Code/pull/7713)):
+
+- Edit or delete past messages to correct prompts without restarting the session.
+- Automatic checkpoint on every user message enables instant rollback, even when no file diffs exist.
+- Review changes with a Checkpoint Restore dialog before applying them.
+- Runs in the background and suppresses extra chat noise.
+
+> 📚 Documentation: See [Checkpoints](/features/checkpoints) and [The Chat Interface](/basic-usage/the-chat-interface).
+
+## QOL Improvements
+
+* Welcome screen readability and spacing improvements for faster scanning (#[7682](https://github.com/RooCodeInc/Roo-Code/pull/7682))
+
+## Bug Fixes
+
+* Fixes an issue where indexing very large projects could hit a stack overflow (thanks StarTrai1!) (#[7712](https://github.com/RooCodeInc/Roo-Code/pull/7712))
+* Fixes an issue where terminal launch sometimes failed when VS Code provided the shell path as an array (thanks Amosvcc!) (#[7697](https://github.com/RooCodeInc/Roo-Code/pull/7697))
+* Fixes cases where MCP and slash-command paths in multi-root workspaces resolved to the wrong folder (now uses the active folder CWD) (thanks NaccOll, kfuglsang!) (#[6904](https://github.com/RooCodeInc/Roo-Code/pull/6904))
+* Fixes an issue where Gemini grounding citations sometimes leaked or duplicated (thanks HahaBill!) (#[7434](https://github.com/RooCodeInc/Roo-Code/pull/7434))
+* Fixes an issue where conversation context could be lost when previous_response_id became invalid (now retries with full history) (#[7714](https://github.com/RooCodeInc/Roo-Code/pull/7714))
+* Fixes a CI issue where e2e runs sometimes timed out while downloading VS Code (#[7583](https://github.com/RooCodeInc/Roo-Code/pull/7583))
+
+## Provider Updates
+
+* Chutes: Adds Kimi K2-0905 model with a 256k context window and pricing metadata (thanks pwilkin!) (#[7701](https://github.com/RooCodeInc/Roo-Code/pull/7701))  
+  > 📚 Documentation: See [Chutes](/providers/chutes)

sidebars.ts

@@ -217,6 +217,13 @@ const sidebars: SidebarsConfig = {
       label: 'Update Notes',
       items: [
         'update-notes/index',
+        {
+          type: 'category',
+          label: '3.27',
+          items: [
+            { type: 'doc', id: 'update-notes/v3.27.0', label: '3.27.0' },
+          ],
+        },
         {
           type: 'category',
           label: '3.26',