docs: v3.31.3 release notes (patch notes, index/sidebar, combined updates) (#409)

Author: hannesrudolph

docs/update-notes/index.md

@@ -20,6 +20,7 @@ image: /img/social-share.jpg
 ### Version 3.31
 
 *   [3.31](/update-notes/v3.31) (Combined)
+*   [3.31.3](/update-notes/v3.31.3) (2025-11-13)
 *   [3.31.2](/update-notes/v3.31.2) (2025-11-13)
 *   [3.31.1](/update-notes/v3.31.1) (2025-11-12)
 *   [3.31.0](/update-notes/v3.31.0) (2025-11-08)

docs/update-notes/v3.31.3.mdx

@@ -0,0 +1,23 @@
+---
+description: Patch fixes for OpenAI native encrypted reasoning and Anthropic token normalization, plus terminology cleanup for context management.
+keywords:
+  - roo code 3.31.3
+  - new features
+  - bug fixes
+image: /img/v3.31.3/v3.31.3.png
+---
+
+# Roo Code 3.31.3 Release Notes (2025-11-13)
+
+This patch fixes OpenAI native encrypted reasoning handling, corrects Anthropic input token normalization, and cleans up context management terminology.
+
+<img src="/img/v3.31.3/v3.31.3.png" alt="Roo Code v3.31.3 Release" width="600" />
+
+## Bug Fixes
+
+* OpenAI native encrypted reasoning parameters: Restores usability of gpt-5-chat-latest by including encrypted reasoning only when a reasoning effort is set and enforcing medium-only verbosity to prevent invalid parameter errors (thanks politsin!) ([#9231](https://github.com/RooCodeInc/Roo-Code/pull/9231))
+* Roo Anthropic token normalization: Prevents double-counting cached tokens so usage metrics, cost estimates, and context calculations are accurate across providers ([#9224](https://github.com/RooCodeInc/Roo-Code/pull/9224))
+
+## Misc Improvements
+
+* Terminology cleanup for context handling: Rename "sliding window" to "context management" and unify the code path under a single entry point, manageContext, for clearer behavior and documentation alignment ([#9206](https://github.com/RooCodeInc/Roo-Code/pull/9206))

docs/update-notes/v3.31.mdx

@@ -41,11 +41,14 @@ The task header and to-do list now work together so you can see progress at a gl
 - **API Profiles apply immediately when provider/model unchanged** ([#9210](https://github.com/RooCodeInc/Roo-Code/pull/9210)): Updates headers, baseUrl, service tier, and reasoning budgets without requiring a model change.
 - **Auto‑approval honors MCP server state** ([#9199](https://github.com/RooCodeInc/Roo-Code/pull/9199)): Restores expected tool auto‑approval behavior (thanks bozoweed!).
 - **Issue Fixer reliability via REST + ProjectsV2** ([#9207](https://github.com/RooCodeInc/Roo-Code/pull/9207)): Resolves sync errors and restores dependable triage.
+- **OpenAI (native) encrypted reasoning handling** ([#9231](https://github.com/RooCodeInc/Roo-Code/pull/9231)): Includes encrypted reasoning only when a reasoning effort is set and enforces medium‑only verbosity for gpt‑5‑chat‑latest to prevent invalid parameter errors (thanks politsin!).
+- **Roo Anthropic input token normalization** ([#9224](https://github.com/RooCodeInc/Roo-Code/pull/9224)): Prevents double‑counting cached tokens so usage metrics, cost estimates, and context calculations are accurate across providers.
 
 ## Misc Improvements
 
 - **Roo Code Cloud error logging** ([#9098](https://github.com/RooCodeInc/Roo-Code/pull/9098)): Captures richer context for failed requests (status codes, response bodies, and request details), making it easier to understand and resolve provider and configuration issues.
 - **IPC: send messages to the current task** ([#9149](https://github.com/RooCodeInc/Roo-Code/pull/9149)): Programmatically post text and images into an active task for automations and richer context.
+- **Context management terminology** ([#9206](https://github.com/RooCodeInc/Roo-Code/pull/9206)): Rename “sliding window” to “context management” and unify handling under a single entry point for clearer behavior and documentation alignment.
 
 ## Provider Updates
 

sidebars.ts

@@ -223,6 +223,7 @@ const sidebars: SidebarsConfig = {
           label: '3.31',
           items: [
             { type: 'doc', id: 'update-notes/v3.31', label: '3.31 Combined' },
+            { type: 'doc', id: 'update-notes/v3.31.3', label: '3.31.3' },
             { type: 'doc', id: 'update-notes/v3.31.2', label: '3.31.2' },
             { type: 'doc', id: 'update-notes/v3.31.1', label: '3.31.1' },
             { type: 'doc', id: 'update-notes/v3.31.0', label: '3.31.0' },