Skip to content

Commit 94871ae

Browse files
3.21 (#231)
* 3.21 * fix: update links in release notes for consistency * fix: correct spelling of 'referred' and 'changelog' in completion criteria
1 parent 1e7d360 commit 94871ae

File tree

9 files changed

+253
-99
lines changed

9 files changed

+253
-99
lines changed

.roo/rules-release-notes-writer/1_workflow.xml

Lines changed: 83 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -25,92 +25,105 @@
2525
</step>
2626
</initialization_steps>
2727

28-
<main_workflow>
29-
<phase name="gather_technical_information">
30-
<description>Collect PR data from GitHub</description>
31-
<steps>
32-
<step number="1">
33-
<action>Fetch commit SHAs</action>
34-
<tool>github.get_tag</tool>
35-
<details>Get commit SHAs for both new and previous version tags</details>
36-
</step>
37-
38-
<step number="2">
39-
<action>List commits and extract PR numbers</action>
40-
<tool>github.list_commits</tool>
41-
<details>
42-
Use start and end SHAs to get all commits in the release range.
43-
Parse commit messages to extract PR numbers (format: "Merge pull request #1234...")
28+
<main_workflow>
29+
<phase name="gather_technical_information">
30+
<description>Collect PR data from GitHub. This phase is skipped if the user provides a list of PR numbers.</description>
31+
<steps>
32+
<step number="1">
33+
<action>Check for user-provided PR list</action>
34+
<details>If the user provides a list of PR numbers with the version, skip to the 'process_each_pr' phase.</details>
35+
</step>
36+
<step number="2">
37+
<action>Fetch release dates</action>
38+
<tool>github.get_tag</tool>
39+
<details>Get the commit dates for both new and previous version tags to establish a date range.</details>
40+
</step>
41+
<step number="3">
42+
<action>Search for merged PRs within the date range</action>
43+
<tool>github.search_issues</tool>
44+
<details>
45+
Use the release date range to search for all merged PRs.
46+
Example query: `is:pr is:merged repo:RooCodeInc/Roo-Code merged:YYYY-MM-DD..YYYY-MM-DD`
47+
</details>
48+
</step>
49+
</steps>
50+
</phase>
51+
<phase name="process_each_pr">
52+
<description>For each PR, follow a micro-workflow to gather, analyze, and write to a temporary file.</description>
53+
<micro_workflow>
54+
<step number="1">
55+
<action>Gather comprehensive PR details</action>
56+
<tools>
57+
<tool>github.get_pull_request - Title, author, description</tool>
58+
<tool>github.get_pull_request_files - Changed files</tool>
59+
<tool>github.get_pull_request_diff - Code changes</tool>
60+
<tool>github.get_pull_request_comments - Additional context if needed</tool>
61+
</tools>
62+
</step>
63+
<step number="2">
64+
<action>Gather related issue details</action>
65+
<tools>
66+
<tool>github.get_issue</tool>
67+
</tools>
68+
<details>From the PR description, extract the issue number and retrieve details.</details>
69+
</step>
70+
<step number="3">
71+
<action>Append analysis to temporary file</action>
72+
<details>
73+
Analyze the gathered information for a single PR and append the summary
74+
to a temporary file. This builds a comprehensive dataset incrementally.
4475
</details>
45-
</step>
46-
47-
<step number="3">
48-
<action>Gather comprehensive PR details</action>
49-
<tools>
50-
<tool>github.get_pull_request - Title, author, description</tool>
51-
<tool>github.get_pull_request_files - Changed files</tool>
52-
<tool>github.get_pull_request_diff - Code changes</tool>
53-
<tool>github.get_pull_request_comments - Additional context if needed</tool>
54-
</tools>
55-
<details>
56-
For each PR number, gather all relevant information.
57-
Store in a temporary file for analysis.
58-
</details>
59-
</step>
60-
</steps>
61-
</phase>
62-
63-
<phase name="transform_to_user_benefits">
64-
<description>Analyze technical changes and convert to user-facing benefits</description>
65-
<steps>
66-
<step>Identify what changed (core functionality/feature)</step>
67-
<step>Understand why it changed (problem being solved)</step>
68-
<step>Determine user impact (benefits in plain language)</step>
69-
<step>Categorize changes (features, fixes, improvements)</step>
70-
</steps>
71-
</phase>
72-
73-
<phase name="generate_documentation">
74-
<description>Create and update all necessary documentation files</description>
75-
<steps>
76-
<step number="1">
77-
<action>Create release notes file</action>
78-
<details>
76+
</step>
77+
</micro_workflow>
78+
</phase>
79+
<phase name="transform_to_user_benefits">
80+
<description>Analyze technical changes from the temporary file and convert to user-facing benefits based on the official changelog</description>
81+
<steps>
82+
<step>Identify what changed (core functionality/feature)</step>
83+
<step>Understand why it changed (problem being solved)</step>
84+
<step>Determine user impact (benefits in plain language)</step>
85+
<step>Categorize changes (features, fixes, improvements)</step>
86+
</steps>
87+
</phase>
88+
<phase name="generate_documentation">
89+
<description>Create and update all necessary documentation files</description>
90+
<steps>
91+
<step number="1">
92+
<action>Create release notes file</action>
93+
<details>
7994
Create docs/update-notes/vX.Y.Z.mdx with proper formatting,
8095
title, date, and organized sections
8196
</details>
82-
</step>
83-
84-
<step number="2">
85-
<action>Update index.md</action>
86-
<details>
97+
</step>
98+
<step number="2">
99+
<action>Update index.md</action>
100+
<details>
87101
Add new release entry to the chronological list with proper link format
88102
</details>
89-
</step>
90-
91-
<step number="3">
92-
<action>Update sidebars.ts</action>
93-
<details>
103+
</step>
104+
<step number="3">
105+
<action>Update sidebars.ts</action>
106+
<details>
94107
Add the new release to the Update Notes section in the sidebar configuration
95108
</details>
96-
</step>
97-
98-
<step number="4">
99-
<action>Update combined release notes</action>
100-
<details>
109+
</step>
110+
<step number="4">
111+
<action>Update combined release notes</action>
112+
<details>
101113
For patch releases, update the corresponding minor/major release file
102114
(e.g., update v3.20.mdx when creating v3.20.3.mdx)
103115
</details>
104-
</step>
105-
</steps>
106-
</phase>
107-
</main_workflow>
116+
</step>
117+
</steps>
118+
</phase>
119+
</main_workflow>
108120

109121
<completion_criteria>
110122
<criterion>Release notes file created with proper formatting</criterion>
111123
<criterion>All PRs analyzed and converted to user benefits</criterion>
112124
<criterion>Index and sidebar files updated</criterion>
113125
<criterion>Combined release notes updated (for patch releases)</criterion>
114126
<criterion>All links and references are correct</criterion>
127+
<criterion>The final release notes need to specifically include only the items (or groups) referred to in the changelog for the version we are working on</criterion>
115128
</completion_criteria>
116-
</workflow_instructions>
129+
</workflow_instructions>

.roo/rules-release-notes-writer/4_tool_usage.xml

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
<github_tools>
88
<tool name="github.get_tag">
9-
<purpose>Fetch commit SHA for a specific version tag</purpose>
9+
<purpose>Fetch release date for a specific version tag</purpose>
1010
<usage><![CDATA[
1111
<use_mcp_tool>
1212
<server_name>github</server_name>
@@ -20,28 +20,26 @@
2020
</arguments>
2121
</use_mcp_tool>
2222
]]></usage>
23-
<output>Returns commit SHA associated with the tag</output>
23+
<output>Returns commit date associated with the tag, which is used to establish the date range for the PR search.</output>
2424
</tool>
2525

26-
<tool name="github.list_commits">
27-
<purpose>Get all commits between two SHAs</purpose>
26+
<tool name="github.search_issues">
27+
<purpose>Get all merged PRs between two dates</purpose>
2828
<usage><![CDATA[
2929
<use_mcp_tool>
3030
<server_name>github</server_name>
31-
<tool_name>list_commits</tool_name>
31+
<tool_name>search_issues</tool_name>
3232
<arguments>
3333
{
3434
"owner": "RooCodeInc",
3535
"repo": "Roo-Code",
36-
"sha": "end_commit_sha",
37-
"since": "start_commit_sha"
36+
"q": "is:pr is:merged repo:RooCodeInc/Roo-Code merged:2025-01-10..2025-01-13"
3837
}
3938
</arguments>
4039
</use_mcp_tool>
4140
]]></usage>
4241
<parsing_tip>
43-
Extract PR numbers from commit messages that match pattern:
44-
"Merge pull request #XXXX from ..."
42+
The search query returns a list of PRs. The PR numbers can be extracted directly from the results.
4543
</parsing_tip>
4644
</tool>
4745

.roo/rules-release-notes-writer/5_complete_example.xml

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@
2222
</step>
2323

2424
<step number="2">
25-
<description>Get commit SHAs for version tags</description>
25+
<description>Get release dates for version tags</description>
2626
<tool_use><![CDATA[
2727
<use_mcp_tool>
2828
<server_name>github</server_name>
@@ -36,21 +36,23 @@
3636
</arguments>
3737
</use_mcp_tool>
3838
]]></tool_use>
39-
<result>SHA: abc123...</result>
39+
<result>
40+
- v3.20.3 date: 2025-01-13
41+
- v3.20.2 date: 2025-01-10
42+
</result>
4043
</step>
4144

4245
<step number="3">
43-
<description>List commits and extract PR numbers</description>
46+
<description>Search for merged PRs and extract numbers</description>
4447
<tool_use><![CDATA[
4548
<use_mcp_tool>
4649
<server_name>github</server_name>
47-
<tool_name>list_commits</tool_name>
50+
<tool_name>search_issues</tool_name>
4851
<arguments>
4952
{
5053
"owner": "RooCodeInc",
5154
"repo": "Roo-Code",
52-
"sha": "abc123...",
53-
"since": "def456..."
55+
"q": "is:pr is:merged repo:RooCodeInc/Roo-Code merged:2025-01-10..2025-01-13"
5456
}
5557
</arguments>
5658
</use_mcp_tool>

docs/features/experimental/experimental-features.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,6 @@ The following experimental features are currently available:
2323
- [Codebase Indexing](/features/experimental/codebase-indexing) - Semantic search through AI-powered codebase indexing
2424
- [Concurrent File Edits](/features/experimental/concurrent-file-edits) - Edit multiple files in a single operation
2525
- [Power Steering](/features/experimental/power-steering)
26-
- [Marketplace](/features/marketplace) - Discover and install modes and MCP servers to extend Roo Code
2726

2827
---
2928

docs/features/marketplace.mdx

Lines changed: 18 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,24 @@ import Codicon from '@site/src/components/Codicon';
66

77
# Roo Code Marketplace
88

9+
<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
10+
<iframe
11+
src="https://www.youtube.com/embed/WatooxMlW0U"
12+
style={{
13+
position: 'absolute',
14+
top: 0,
15+
left: 0,
16+
width: '100%',
17+
height: '100%',
18+
}}
19+
frameBorder="0"
20+
allow="autoplay; encrypted-media"
21+
allowFullScreen
22+
></iframe>
23+
</div>
24+
25+
<div style={{ marginTop: '20px' }}></div>
26+
927
---
1028

1129
## Overview
@@ -24,18 +42,6 @@ The Roo Code Marketplace is a central hub for discovering and installing communi
2442

2543
The Roo Code Marketplace is available directly within the Roo Code extension in VS Code. Access it by clicking the marketplace icon <Codicon name="extensions" /> in the top menu bar.
2644

27-
:::warning Experimental Feature
28-
The Marketplace is an experimental feature and must be enabled in settings.
29-
30-
1. Open Roo Code settings (<Codicon name="gear" />).
31-
2. Navigate to **Roo Code > Experimental Settings**.
32-
3. Enable the **Marketplace** option.
33-
34-
<img src="/img/marketplace/marketplace-7.png" alt="Enable Marketplace toggle in experimental settings" width="400" />
35-
36-
See the main [Experimental Features](/features/experimental/experimental-features) page for more information.
37-
:::
38-
3945
---
4046

4147

docs/update-notes/index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,12 @@
33
This section contains notes about recent updates to Roo Code, listed by version number.
44
---
55

6+
## Version 3.21
7+
8+
* [3.21.0](/update-notes/v3.21.0) (2025-06-17)
9+
10+
---
11+
612
## Version 3.20
713

814
* [3.20.3](/update-notes/v3.20.3) (2025-06-14)

docs/update-notes/v3.21.0.mdx

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Roo Code 3.21.0 Release Notes (2025-06-17)
2+
3+
This release launches the Roo Marketplace, adds support for the latest Gemini 2.5 models, and introduces Excel file support along with numerous improvements and fixes.
4+
5+
## [Roo Marketplace Launch](/features/marketplace)
6+
7+
We're excited to announce the official launch of the [Roo Marketplace](/features/marketplace) ([#4788](https://github.com/RooCodeInc/Roo-Code/pull/4788)):
8+
9+
- **Discover Great MCPs and Modes**: Browse and install community-created Model Context Protocol servers and custom modes directly from within Roo Code
10+
- **Seamless Integration**: The marketplace is now available to all users without needing experimental features
11+
- **Easy Installation**: Find and install the tools you need with just a few clicks
12+
13+
The Roo Marketplace makes it easy to extend Roo Code's functionality with powerful integrations created by our vibrant community.
14+
15+
## [Gemini 2.5 Models Support](https://blog.google/products/gemini/gemini-2-5-model-family-expands/)
16+
17+
We've added support for [Google's latest Gemini 2.5 models](https://blog.google/products/gemini/gemini-2-5-model-family-expands/) (thanks @daniel-lxs!) ([#4762](https://github.com/RooCodeInc/Roo-Code/pull/4762), [#4770](https://github.com/RooCodeInc/Roo-Code/pull/4770), [#4767](https://github.com/RooCodeInc/Roo-Code/pull/4767)):
18+
19+
- **Gemini 2.5 Pro**: Enhanced capabilities for complex coding tasks
20+
- **Gemini 2.5 Flash**: Fast model with improved performance
21+
- **Gemini 2.5 Flash Lite**: Lightweight model perfect for quick tasks
22+
23+
These new models bring enhanced reasoning capabilities and better performance across various coding tasks.
24+
25+
## Excel File Support
26+
27+
Added support for reading Excel (.xlsx) files in tools (thanks @chrarnoldus!) ([#4751](https://github.com/RooCodeInc/Roo-Code/pull/4751)). You can now:
28+
29+
- **Read Excel Files**: Directly analyze and work with Excel spreadsheets
30+
- **Extract Data**: Access cell values, formulas, and sheet information
31+
- **Seamless Integration**: Works with all existing Roo Code tools and features
32+
33+
## QOL Improvements
34+
35+
* **OpenAI Compatible Max Tokens**: Added checkbox option for max tokens in OpenAI compatible provider settings (thanks @AlexandruSmirnov!) ([#4600](https://github.com/RooCodeInc/Roo-Code/pull/4600), [#4623](https://github.com/RooCodeInc/Roo-Code/pull/4623))
36+
* **Provider Updates**: Updated model lists and pricing for Groq & Mistral (thanks @KanTakahiro!) ([#4798](https://github.com/RooCodeInc/Roo-Code/pull/4798), [#4797](https://github.com/RooCodeInc/Roo-Code/pull/4797))
37+
* **Terminal Details**: Now includes current working directory for better context awareness ([#4783](https://github.com/RooCodeInc/Roo-Code/pull/4783))
38+
* **Multi-file Diff**: Encourages use of start_line parameter to match legacy diff behavior ([#4777](https://github.com/RooCodeInc/Roo-Code/pull/4777))
39+
40+
## UI/UX Improvements
41+
42+
* **Marketplace Branding**: Updated to show "Roo Marketplace" for consistent branding (thanks @SannidhyaSah!) ([#4718](https://github.com/RooCodeInc/Roo-Code/pull/4718))
43+
* **History UI**: Refactored to more consistent and modern interface (thanks @elianiva!) ([#4598](https://github.com/RooCodeInc/Roo-Code/pull/4598))
44+
* **Context Menu**: Adjusted positioning to be near GitHub Copilot for easier access ([#4306](https://github.com/RooCodeInc/Roo-Code/pull/4306))
45+
* **Panel Focus**: Always focus the panel when clicked to ensure menu buttons are visible (thanks @hassoncs!) ([#4312](https://github.com/RooCodeInc/Roo-Code/pull/4312))
46+
47+
## Bug Fixes
48+
49+
* **API Conversation History**: Added proper error handling for conversation history issues (thanks @KJ7LNW!) ([#4741](https://github.com/RooCodeInc/Roo-Code/pull/4741), [#4738](https://github.com/RooCodeInc/Roo-Code/pull/4738))
50+
* **Model ID Errors**: Fixed ambiguous model ID error messages (thanks @elianiva!) ([#4709](https://github.com/RooCodeInc/Roo-Code/pull/4709), [#4710](https://github.com/RooCodeInc/Roo-Code/pull/4710))
51+
* **Prompt Settings**: Fixed save/discard/revert flow for Prompt Settings (thanks @hassoncs!) ([#4623](https://github.com/RooCodeInc/Roo-Code/pull/4623), [#4312](https://github.com/RooCodeInc/Roo-Code/pull/4312))
52+
* **Codebase Indexing**: Fixed alignment with list-files hidden directory filtering (thanks @daniel-lxs!) ([#4684](https://github.com/RooCodeInc/Roo-Code/pull/4684))
53+
* **Subtask Completion**: Fixed mismatch between subtask and overall task completion (thanks @feifei325!) ([#4656](https://github.com/RooCodeInc/Roo-Code/pull/4656))
54+
* **Windows MCP Configuration**: Fixed path normalization in MCP variable injection on Windows (thanks @daniel-lxs!) ([#4607](https://github.com/RooCodeInc/Roo-Code/pull/4607))
55+
56+
## Misc Improvements
57+
58+
* **Test Mode Update**: Updated test mode to support Vitest testing framework ([#4778](https://github.com/RooCodeInc/Roo-Code/pull/4778))
59+
* **Working Directory Warning**: Removed unnecessary warning about working directory changes ([#4795](https://github.com/RooCodeInc/Roo-Code/pull/4795))
60+
* **Telemetry**: Added marketplace tab view and install click tracking ([#4781](https://github.com/RooCodeInc/Roo-Code/pull/4781))
61+
* **Windows Docker**: Updated evals Docker setup to work on Windows (thanks @StevenTCramer!) ([#4467](https://github.com/RooCodeInc/Roo-Code/pull/4467))

0 commit comments

Comments
 (0)