review fixes

Author: navedmerchant

.roo/commands/release.md

@@ -36,16 +36,9 @@ mode: code
     - Do not manually edit `src/README.md`; the extension bundle step copies root `README.md` into `src/README.md`.
     - Check for stale upstream Roo Code wording that should now say Zoo Code.
 
-6. Create the release notes as a changeset file at `.changeset/v[version].md`, then run `pnpm changeset:version` on the release branch before opening the PR.
-
-    ```md
-    ---
-    "zoo-code": patch|minor|major
-    ---
-
-    [list of changes]
-    ```
+6. Write the release notes directly into `CHANGELOG.md` on the release branch.
 
+    - Use the heading format `## [version]` (with square brackets) — e.g. `## [3.58.1]`. The publish workflow at `.github/workflows/marketplace-publish.yml` extracts release notes by matching this exact pattern; headings without brackets will be missed and the GitHub release will fall back to a generic message.
     - Always include contributor attribution and the PR number: use `(PR #<prNumber> by @username)`.
     - For PRs that close issues, include both issue and PR authors: `- Fix: Description (#123 by @reporter, PR #456 by @contributor)`.
     - For PRs without linked issues, include the PR number and author: `- Add support for feature (PR #456 by @contributor)`.
@@ -67,13 +60,10 @@ mode: code
     git checkout -b release/v[version]
     ```
 
-9. Generate the final release state on that branch:
-
-    ```bash
-    pnpm changeset:version
-    ```
+9. Bump the version in `src/package.json` to the target release version and ensure `CHANGELOG.md` and `src/CHANGELOG.md` are up to date.
 
-    - This should update `src/package.json`, `CHANGELOG.md`, and `src/CHANGELOG.md`, then consume the `.changeset` file.
+    - Verify the `CHANGELOG.md` heading uses `## [version]` (with brackets).
+    - Copy or sync `CHANGELOG.md` to `src/CHANGELOG.md` if the project keeps both.
     - Review the generated version and changelog before opening the PR.
 
 10. Open a single release PR with the fully generated release state.

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Zoo Code Changelog
 
-## 3.58.1
+## [3.58.1]
 
 ### Patch Changes
 

README.md

@@ -53,7 +53,7 @@
 You can find a quick guide for migrating from Roo Code to Zoo Code in the [Roo→Zoo migration guide](https://docs.zoocode.dev/roo-to-zoo-migration). We plan to try and help users as they transition over, we have our [Reddit](https://www.reddit.com/r/ZooCode) and [Discord](https://discord.gg/VxfP4Vx3gX)
 for this exact support, so if you are having problems or if you have question, jump on and ask.
 
-## What's New in v3.58.1
+## What's New in v3.58.0
 
 - **Zoo Gateway** — connect through a managed gateway with multi-profile auth support
 - **Gemini 3.5 Flash** — a fast, capable Google model now available from your provider settings
@@ -65,7 +65,6 @@ for this exact support, so if you are having problems or if you have question, j
 - Fix React crash from malformed follow-up suggestion mode
 - Fix OpenAI temperature being omitted when no custom value is set
 - Handle per-key failures during settings import
-- Fix: Remove unsupported `--no-absolute-filenames` tar argument (#491 by @kazenshi, PR #492 by @kazenshi)
 - Security updates: mermaid v11.15.0, axios v1.16.0
 
 <details>
@@ -81,14 +80,16 @@ for this exact support, so if you are having problems or if you have question, j
 - [Italiano](locales/it/README.md)
 - [日本語](locales/ja/README.md)
 - [한국어](locales/ko/README.md)
-- Security updates: mermaid v11.15.0, axios v1.16.0
-
-<details>
-@@ -89,7 +90,7 @@ for this exact support, so if you are having problems or if you have question, j
+- [Nederlands](locales/nl/README.md)
+- [Polski](locales/pl/README.md)
+- [Português (BR)](locales/pt-BR/README.md)
+- [Русский](locales/ru/README.md)
+- [Türkçe](locales/tr/README.md)
+- [Tiếng Việt](locales/vi/README.md)
 - [简体中文](locales/zh-CN/README.md)
 - [繁體中文](locales/zh-TW/README.md)
 - ...
-</details>
+  </details>
 
 ---