From 8ffeaed6f247febe59d3d37a6e6d24e421d0300f Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Thu, 13 Nov 2025 22:49:49 -0700
Subject: [PATCH 01/37] feat: task history retention purge uses provider delete
 path; checkpoint-only cleanup; quieter logging

---
 packages/types/src/global-settings.ts         |   2 +
 packages/types/src/vscode-extension-host.ts   |   1 +
 src/__tests__/extension.spec.ts               |  12 +
 src/__tests__/task-history-retention.spec.ts  | 141 +++++++++
 src/core/webview/ClineProvider.ts             |   5 +
 src/core/webview/webviewMessageHandler.ts     |   6 +
 src/extension.ts                              |  39 ++-
 src/package.json                              |  13 +
 src/package.nls.json                          |   3 +-
 src/utils/task-history-retention.ts           | 267 ++++++++++++++++++
 webview-ui/src/components/settings/About.tsx  |  49 +++-
 .../src/components/settings/SettingsView.tsx  |  15 +
 webview-ui/src/i18n/locales/en/settings.json  |  13 +
 13 files changed, 559 insertions(+), 7 deletions(-)
 create mode 100644 src/__tests__/task-history-retention.spec.ts
 create mode 100644 src/utils/task-history-retention.ts

diff --git a/packages/types/src/global-settings.ts b/packages/types/src/global-settings.ts
index 0f75e1d6107..d1266b34321 100644
--- a/packages/types/src/global-settings.ts
+++ b/packages/types/src/global-settings.ts
@@ -181,6 +181,8 @@ export const globalSettingsSchema = z.object({
 	customSupportPrompts: customSupportPromptsSchema.optional(),
 	enhancementApiConfigId: z.string().optional(),
 	includeTaskHistoryInEnhance: z.boolean().optional(),
+	// Auto-delete task history on extension reload. "never" | "90" | "60" | "30" | "7" | "3"
+	taskHistoryRetention: z.union([z.enum(["never", "90", "60", "30", "7", "3"]), z.number()]).optional(),
 	historyPreviewCollapsed: z.boolean().optional(),
 	reasoningBlockCollapsed: z.boolean().optional(),
 	/**
diff --git a/packages/types/src/vscode-extension-host.ts b/packages/types/src/vscode-extension-host.ts
index 49f9687f009..9e55fab1769 100644
--- a/packages/types/src/vscode-extension-host.ts
+++ b/packages/types/src/vscode-extension-host.ts
@@ -335,6 +335,7 @@ export type ExtensionState = Pick<
 	| "maxGitStatusFiles"
 	| "requestDelaySeconds"
 	| "showWorktreesInHomeScreen"
+	| "taskHistoryRetention"
 > & {
 	version: string
 	clineMessages: ClineMessage[]
diff --git a/src/__tests__/extension.spec.ts b/src/__tests__/extension.spec.ts
index 5b072672699..1d215493116 100644
--- a/src/__tests__/extension.spec.ts
+++ b/src/__tests__/extension.spec.ts
@@ -114,6 +114,8 @@ vi.mock("../core/config/ContextProxy", () => ({
 			setValue: vi.fn(),
 			getValues: vi.fn().mockReturnValue({}),
 			getProviderSettings: vi.fn().mockReturnValue({}),
+			// Needed by retention purge on activation
+			globalStorageUri: { fsPath: "/tmp/roo-retention-test" },
 		}),
 	},
 }))
@@ -157,6 +159,16 @@ vi.mock("../utils/autoImportSettings", () => ({
 	autoImportSettings: vi.fn().mockResolvedValue(undefined),
 }))
 
+// Avoid filesystem access during activation by stubbing purge
+vi.mock("../utils/task-history-retention", () => ({
+	purgeOldTasks: vi.fn().mockResolvedValue({ purgedCount: 0, cutoff: null }),
+}))
+
+// Ensure storage base path resolves to provided path to avoid touching VS Code config
+vi.mock("../utils/storage", () => ({
+	getStorageBasePath: (p: string) => Promise.resolve(p),
+}))
+
 vi.mock("../extension/api", () => ({
 	API: vi.fn().mockImplementation(() => ({})),
 }))
diff --git a/src/__tests__/task-history-retention.spec.ts b/src/__tests__/task-history-retention.spec.ts
new file mode 100644
index 00000000000..3bb4b2a55a2
--- /dev/null
+++ b/src/__tests__/task-history-retention.spec.ts
@@ -0,0 +1,141 @@
+// npx vitest run __tests__/task-history-retention.spec.ts
+import * as fs from "fs/promises"
+import * as path from "path"
+import * as os from "os"
+
+import { describe, it, expect } from "vitest"
+
+// Ensure purge uses the provided base path without touching VS Code config
+vi.mock("../utils/storage", () => ({
+	getStorageBasePath: (p: string) => Promise.resolve(p),
+}))
+
+import { purgeOldTasks } from "../utils/task-history-retention"
+import { GlobalFileNames } from "../shared/globalFileNames"
+
+// Helpers
+async function exists(p: string): Promise<boolean> {
+	try {
+		await fs.access(p)
+		return true
+	} catch {
+		return false
+	}
+}
+
+async function mkTempBase(): Promise<string> {
+	const base = await fs.mkdtemp(path.join(os.tmpdir(), "roo-retention-"))
+	// Ensure <base>/tasks exists
+	await fs.mkdir(path.join(base, "tasks"), { recursive: true })
+	return base
+}
+
+async function createTask(base: string, id: string, ts?: number | "invalid"): Promise<string> {
+	const dir = path.join(base, "tasks", id)
+	await fs.mkdir(dir, { recursive: true })
+	const metadataPath = path.join(dir, GlobalFileNames.taskMetadata)
+	const metadata = ts === "invalid" ? "{ invalid json" : JSON.stringify({ ts: ts ?? Date.now() }, null, 2)
+	await fs.writeFile(metadataPath, metadata, "utf8")
+	return dir
+}
+
+describe("utils/task-history-retention.ts purgeOldTasks()", () => {
+	it("purges tasks older than 7 days when retention is '7'", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			const old = await createTask(base, "task-8d", now - days(8))
+			const recent = await createTask(base, "task-6d", now - days(6))
+
+			const { purgedCount } = await purgeOldTasks("7", base, () => {}, false)
+			expect(purgedCount).toBe(1)
+			expect(await exists(old)).toBe(false)
+			expect(await exists(recent)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("purges tasks older than 3 days when retention is '3'", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			const old = await createTask(base, "task-4d", now - days(4))
+			const recent = await createTask(base, "task-2d", now - days(2))
+
+			const { purgedCount } = await purgeOldTasks("3", base, () => {}, false)
+			expect(purgedCount).toBe(1)
+			expect(await exists(old)).toBe(false)
+			expect(await exists(recent)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("does not delete anything in dry run mode but still reports purgedCount", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			const old = await createTask(base, "task-8d", now - days(8))
+			const recent = await createTask(base, "task-6d", now - days(6))
+
+			const { purgedCount } = await purgeOldTasks("7", base, () => {}, true)
+			expect(purgedCount).toBe(1)
+			// In dry run, nothing is deleted
+			expect(await exists(old)).toBe(true)
+			expect(await exists(recent)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("does nothing when retention is 'never'", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const oldTs = now - 45 * 24 * 60 * 60 * 1000 // 45 days ago
+			const t1 = await createTask(base, "task-old", oldTs)
+			const t2 = await createTask(base, "task-new", now)
+
+			const { purgedCount, cutoff } = await purgeOldTasks("never", base, () => {})
+
+			expect(purgedCount).toBe(0)
+			expect(cutoff).toBeNull()
+			expect(await exists(t1)).toBe(true)
+			expect(await exists(t2)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("purges tasks older than 30 days and keeps newer or invalid-metadata ones", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// One older than 30 days => delete
+			const old = await createTask(base, "task-31d", now - days(31))
+			// One newer than 30 days => keep
+			const recent = await createTask(base, "task-29d", now - days(29))
+			// Invalid metadata => skipped (kept)
+			const invalid = await createTask(base, "task-invalid", "invalid")
+
+			const { purgedCount, cutoff } = await purgeOldTasks("30", base, () => {})
+
+			expect(typeof cutoff).toBe("number")
+			expect(purgedCount).toBe(1)
+			expect(await exists(old)).toBe(false)
+			expect(await exists(recent)).toBe(true)
+			expect(await exists(invalid)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+})
diff --git a/src/core/webview/ClineProvider.ts b/src/core/webview/ClineProvider.ts
index fd70c41af09..64ad5a06403 100644
--- a/src/core/webview/ClineProvider.ts
+++ b/src/core/webview/ClineProvider.ts
@@ -2053,6 +2053,7 @@ export class ClineProvider
 			reasoningBlockCollapsed,
 			enterBehavior,
 			cloudUserInfo,
+			taskHistoryRetention,
 			cloudIsAuthenticated,
 			sharingEnabled,
 			publicSharingEnabled,
@@ -2236,6 +2237,8 @@ export class ClineProvider
 			includeDiagnosticMessages: includeDiagnosticMessages ?? true,
 			maxDiagnosticMessages: maxDiagnosticMessages ?? 50,
 			includeTaskHistoryInEnhance: includeTaskHistoryInEnhance ?? true,
+			// Task history retention setting for About tab dropdown
+			taskHistoryRetention: taskHistoryRetention ?? "never",
 			includeCurrentTime: includeCurrentTime ?? true,
 			includeCurrentCost: includeCurrentCost ?? true,
 			maxGitStatusFiles: maxGitStatusFiles ?? 0,
@@ -2451,6 +2454,8 @@ export class ClineProvider
 			organizationAllowList,
 			organizationSettingsVersion,
 			customCondensingPrompt: stateValues.customCondensingPrompt,
+			// Task history retention selection
+			taskHistoryRetention: stateValues.taskHistoryRetention ?? "never",
 			codebaseIndexModels: stateValues.codebaseIndexModels ?? EMBEDDING_MODEL_PROFILES,
 			codebaseIndexConfig: {
 				codebaseIndexEnabled: stateValues.codebaseIndexConfig?.codebaseIndexEnabled ?? false,
diff --git a/src/core/webview/webviewMessageHandler.ts b/src/core/webview/webviewMessageHandler.ts
index 2dc77d05027..9adbbbf0035 100644
--- a/src/core/webview/webviewMessageHandler.ts
+++ b/src/core/webview/webviewMessageHandler.ts
@@ -593,6 +593,12 @@ export const webviewMessageHandler = async (
 						await vscode.workspace
 							.getConfiguration(Package.name)
 							.update("deniedCommands", newValue, vscode.ConfigurationTarget.Global)
+					} else if (key === "taskHistoryRetention") {
+						const val = ((value ?? "never") as string).toString()
+						newValue = val
+						await vscode.workspace
+							.getConfiguration(Package.name)
+							.update("taskHistoryRetention", val, vscode.ConfigurationTarget.Global)
 					} else if (key === "ttsEnabled") {
 						newValue = value ?? true
 						setTtsEnabled(newValue as boolean)
diff --git a/src/extension.ts b/src/extension.ts
index bcfbe339932..b3184ecbdc5 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -1,6 +1,7 @@
 import * as vscode from "vscode"
 import * as dotenvx from "@dotenvx/dotenvx"
 import * as path from "path"
+import * as fs from "fs/promises"
 
 // Load environment variables from .env file
 try {
@@ -44,6 +45,7 @@ import {
 } from "./activate"
 import { initializeI18n } from "./i18n"
 import { flushModels, initializeModelCacheRefresh, refreshModels } from "./api/providers/fetchers/modelCache"
+import { purgeOldTasks } from "./utils/task-history-retention"
 
 /**
  * Built using https://github.com/microsoft/vscode-webview-ui-toolkit
@@ -163,6 +165,40 @@ export async function activate(context: vscode.ExtensionContext) {
 
 	const contextProxy = await ContextProxy.getInstance(context)
 
+	// Initialize the provider *before* the Roo Code Cloud service so we can reuse its task deletion logic.
+	const provider = new ClineProvider(context, outputChannel, "sidebar", contextProxy, mdmService)
+
+	// Task history retention purge (runs only on activation)
+	try {
+		const config = vscode.workspace.getConfiguration(Package.name)
+		const retention = config.get<string>("taskHistoryRetention", "never") ?? "never"
+
+		outputChannel.appendLine(`[Retention] Startup purge: setting=${retention}`)
+
+		const result = await purgeOldTasks(
+			retention as any,
+			contextProxy.globalStorageUri.fsPath,
+			(m) => {
+				outputChannel.appendLine(m)
+				console.log(m)
+			},
+			false,
+			async (taskId: string, _taskDirPath: string) => {
+				// Reuse the same internal deletion logic as the History view so that
+				// checkpoints, shadow repositories, and task state are cleaned up consistently.
+				await provider.deleteTaskWithId(taskId)
+			},
+		)
+
+		outputChannel.appendLine(
+			`[Retention] Startup purge complete: purged=${result.purgedCount}, cutoff=${result.cutoff ?? "none"}`,
+		)
+	} catch (error) {
+		outputChannel.appendLine(
+			`[Retention] Failed during startup purge: ${error instanceof Error ? error.message : String(error)}`,
+		)
+	}
+
 	// Initialize code index managers for all workspace folders.
 	const codeIndexManagers: CodeIndexManager[] = []
 
@@ -186,9 +222,6 @@ export async function activate(context: vscode.ExtensionContext) {
 		}
 	}
 
-	// Initialize the provider *before* the Roo Code Cloud service.
-	const provider = new ClineProvider(context, outputChannel, "sidebar", contextProxy, mdmService)
-
 	// Initialize Roo Code Cloud service.
 	const postStateListener = () => ClineProvider.getVisibleInstance()?.postStateToWebview()
 
diff --git a/src/package.json b/src/package.json
index e5ade27ed3d..7e4a8c21644 100644
--- a/src/package.json
+++ b/src/package.json
@@ -429,6 +429,19 @@
 					"default": false,
 					"description": "%settings.debugProxy.tlsInsecure.description%",
 					"markdownDescription": "%settings.debugProxy.tlsInsecure.description%"
+				},
+				"roo-cline.taskHistoryRetention": {
+					"type": "string",
+					"enum": [
+						"never",
+						"90",
+						"60",
+						"30",
+						"7",
+						"3"
+					],
+					"default": "never",
+					"description": "%settings.taskHistoryRetention.description%"
 				}
 			}
 		}
diff --git a/src/package.nls.json b/src/package.nls.json
index 177b392f775..94107aed14d 100644
--- a/src/package.nls.json
+++ b/src/package.nls.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Enable debug mode to show additional buttons for viewing API conversation history and UI messages as prettified JSON in temporary files.",
 	"settings.debugProxy.enabled.description": "**Enable Debug Proxy** — Route all outbound network requests through a proxy for MITM debugging. Only active when running in debug mode (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (e.g., `http://127.0.0.1:8888`). Only used when **Debug Proxy** is enabled.",
-	"settings.debugProxy.tlsInsecure.description": "Accept self-signed certificates from the proxy. **Required for MITM inspection.** ⚠️ Insecure — only use for local debugging."
+	"settings.debugProxy.tlsInsecure.description": "Accept self-signed certificates from the proxy. **Required for MITM inspection.** ⚠️ Insecure — only use for local debugging.",
+	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on plugin reload."
 }
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
new file mode 100644
index 00000000000..274033648ac
--- /dev/null
+++ b/src/utils/task-history-retention.ts
@@ -0,0 +1,267 @@
+import * as path from "path"
+import * as fs from "fs/promises"
+import type { Dirent } from "fs"
+
+import { getStorageBasePath } from "./storage"
+import { GlobalFileNames } from "../shared/globalFileNames"
+
+/**
+ * Supported values for the retention setting.
+ * - "never" or 0 disables purging
+ * - "90" | "60" | "30" | "7" | "3" (string) or 90 | 60 | 30 | 7 | 3 (number) specify days
+ */
+export type RetentionSetting = "never" | "90" | "60" | "30" | "7" | "3" | 90 | 60 | 30 | 7 | 3 | 0 | "0" | number
+
+export type PurgeResult = {
+	purgedCount: number
+	cutoff: number | null
+}
+
+/**
+ * Purge old task directories under <base>/tasks based on task_metadata.json ts value.
+ * Executes best-effort deletes; errors are logged and skipped.
+ *
+ * @param retention Retention setting: "never" | "90" | "60" | "30" | "7" | "3" or number of days
+ * @param globalStoragePath VS Code global storage fsPath (context.globalStorageUri.fsPath)
+ * @param log Optional logger
+ * @param dryRun When true, logs which tasks would be deleted but does not delete anything
+ * @returns PurgeResult with count and cutoff used
+ */
+export async function purgeOldTasks(
+	retention: RetentionSetting,
+	globalStoragePath: string,
+	log?: (message: string) => void,
+	dryRun: boolean = false,
+	deleteTaskById?: (taskId: string, taskDirPath: string) => Promise<void>,
+	verbose: boolean = false,
+): Promise<PurgeResult> {
+	const days = normalizeDays(retention)
+	if (!days) {
+		log?.("[Retention] No purge (setting is 'never' or not a positive number)")
+		return { purgedCount: 0, cutoff: null }
+	}
+
+	const cutoff = Date.now() - days * 24 * 60 * 60 * 1000
+	const logv = (msg: string) => {
+		if (verbose) log?.(msg)
+	}
+	logv(`[Retention] Starting purge with retention=${retention} (${days} day(s))${dryRun ? " (dry run)" : ""}`)
+
+	let basePath: string
+
+	try {
+		basePath = await getStorageBasePath(globalStoragePath)
+	} catch (e) {
+		log?.(
+			`[Retention] Failed to resolve storage base path: ${
+				e instanceof Error ? e.message : String(e)
+			}${dryRun ? " (dry run)" : ""}`,
+		)
+		return { purgedCount: 0, cutoff }
+	}
+
+	const tasksDir = path.join(basePath, "tasks")
+
+	let entries: Dirent[]
+	try {
+		entries = await fs.readdir(tasksDir, { withFileTypes: true })
+	} catch (e) {
+		// No tasks directory yet or unreadable; nothing to purge.
+		logv(`[Retention] Tasks directory not found or unreadable at ${tasksDir}${dryRun ? " (dry run)" : ""}`)
+		return { purgedCount: 0, cutoff }
+	}
+
+	const taskDirs = entries.filter((d) => d.isDirectory())
+
+	logv(`[Retention] Found ${taskDirs.length} task director${taskDirs.length === 1 ? "y" : "ies"} under ${tasksDir}`)
+
+	// Small helpers
+	const pathExists = async (p: string): Promise<boolean> => {
+		try {
+			await fs.access(p)
+			return true
+		} catch {
+			return false
+		}
+	}
+
+	const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))
+
+	// Aggressive recursive remove with retries; also directly clears checkpoints if needed
+	const removeDirAggressive = async (dir: string): Promise<boolean> => {
+		// Try up to 3 passes with short delays
+		for (let attempt = 1; attempt <= 3; attempt++) {
+			try {
+				await fs.rm(dir, { recursive: true, force: true })
+			} catch {
+				// ignore and try more targeted cleanup below
+			}
+
+			// Verify
+			if (!(await pathExists(dir))) return true
+
+			// Targeted cleanup for stubborn checkpoint-only directories
+			try {
+				await fs.rm(path.join(dir, "checkpoints"), { recursive: true, force: true })
+			} catch {
+				// ignore
+			}
+
+			// Remove children one by one in case some FS impls struggle with rm -r
+			try {
+				const entries = await fs.readdir(dir, { withFileTypes: true })
+				for (const entry of entries) {
+					const entryPath = path.join(dir, entry.name)
+					try {
+						if (entry.isDirectory()) {
+							await fs.rm(entryPath, { recursive: true, force: true })
+						} else {
+							await fs.unlink(entryPath)
+						}
+					} catch {
+						// ignore individual failures; we'll retry the parent
+					}
+				}
+			} catch {
+				// ignore
+			}
+
+			// Final attempt this pass
+			try {
+				await fs.rm(dir, { recursive: true, force: true })
+			} catch {
+				// ignore
+			}
+
+			if (!(await pathExists(dir))) return true
+
+			// Backoff a bit before next attempt
+			await sleep(50 * attempt)
+		}
+
+		return !(await pathExists(dir))
+	}
+
+	const results = await Promise.all(
+		taskDirs.map(async (d) => {
+			const taskDir = path.join(tasksDir, d.name)
+			const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+
+			let ts: number | null = null
+
+			// First try to get a timestamp from task_metadata.json (if present)
+			try {
+				const raw = await fs.readFile(metadataPath, "utf8")
+				const meta = JSON.parse(raw)
+				const maybeTs = Number((meta as any)?.ts)
+				if (Number.isFinite(maybeTs)) {
+					ts = maybeTs
+				}
+			} catch {
+				// Missing or invalid metadata; we'll fall back to directory mtime.
+			}
+
+			let shouldDelete = false
+			let reason = ""
+
+			// Check for checkpoint-only orphan directories (delete regardless of age)
+			try {
+				const childEntries = await fs.readdir(taskDir, { withFileTypes: true })
+				const visibleNames = childEntries.map((e) => e.name).filter((n) => !n.startsWith("."))
+				const hasCheckpointsDir = childEntries.some((e) => e.isDirectory() && e.name === "checkpoints")
+				const nonCheckpointVisible = visibleNames.filter((n) => n !== "checkpoints")
+				const hasMetadataFile = visibleNames.includes(GlobalFileNames.taskMetadata)
+				if (hasCheckpointsDir && nonCheckpointVisible.length === 0 && !hasMetadataFile) {
+					shouldDelete = true
+					reason = "orphan checkpoints_only"
+				}
+			} catch {
+				// Ignore errors while scanning children; proceed with normal logic
+			}
+
+			if (!shouldDelete && ts !== null && ts < cutoff) {
+				// Normal case: metadata has a valid ts older than cutoff
+				shouldDelete = true
+				reason = `ts=${ts}`
+			} else if (!shouldDelete) {
+				// Orphan/legacy case: no valid ts; fall back to directory mtime
+				try {
+					const stat = await fs.stat(taskDir)
+					const mtimeMs = stat.mtime.getTime()
+					if (mtimeMs < cutoff) {
+						shouldDelete = true
+						reason = `no valid ts, mtime=${stat.mtime.toISOString()}`
+					}
+				} catch {
+					// If we can't stat the directory, skip it.
+				}
+			}
+
+			if (!shouldDelete) {
+				return 0
+			}
+
+			if (dryRun) {
+				logv(`[Retention][DRY RUN] Would delete task ${d.name} (${reason}) @ ${taskDir}`)
+				return 1
+			}
+
+			// Attempt deletion using provider callback (for full cleanup) or direct rm
+			let deletionError: unknown | null = null
+			try {
+				if (deleteTaskById) {
+					logv(`[Retention] Deleting task ${d.name} via provider @ ${taskDir} (${reason})`)
+					await deleteTaskById(d.name, taskDir)
+				} else {
+					logv(`[Retention] Deleting task ${d.name} via fs.rm @ ${taskDir} (${reason})`)
+					await fs.rm(taskDir, { recursive: true, force: true })
+				}
+			} catch (e) {
+				deletionError = e
+			}
+
+			// Verify deletion; if still exists, attempt aggressive cleanup with retries
+			let deleted = await removeDirAggressive(taskDir)
+
+			if (!deleted) {
+				// Did not actually remove; report the most relevant error
+				if (deletionError) {
+					log?.(
+						`[Retention] Failed to delete task ${d.name} @ ${taskDir}: ${
+							deletionError instanceof Error ? deletionError.message : String(deletionError)
+						} (directory still present)`,
+					)
+				} else {
+					log?.(
+						`[Retention] Failed to delete task ${d.name} @ ${taskDir}: directory still present after cleanup attempts`,
+					)
+				}
+				return 0
+			}
+
+			logv(`[Retention] Deleted task ${d.name} (${reason}) @ ${taskDir}`)
+			return 1
+		}),
+	)
+
+	const purged = results.reduce<number>((sum, n) => sum + n, 0)
+
+	if (purged > 0) {
+		log?.(
+			`[Retention] Purged ${purged} task(s)${dryRun ? " (dry run)" : ""}; cutoff=${new Date(cutoff).toISOString()}`,
+		)
+	} else {
+		log?.(`[Retention] No tasks met purge criteria${dryRun ? " (dry run)" : ""}`)
+	}
+
+	return { purgedCount: purged, cutoff }
+}
+
+/**
+ * Normalize retention into a positive integer day count or 0 (no-op).
+ */
+function normalizeDays(value: RetentionSetting): number {
+	if (value === "never") return 0
+	const n = typeof value === "number" ? value : parseInt(String(value), 10)
+	return Number.isFinite(n) && n > 0 ? Math.trunc(n) : 0
+}
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index 17e3d6cfa95..f86414189c3 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -10,7 +10,7 @@ import { Package } from "@roo/package"
 
 import { vscode } from "@/utils/vscode"
 import { cn } from "@/lib/utils"
-import { Button } from "@/components/ui"
+import { Button, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui"
 
 import { SectionHeader } from "./SectionHeader"
 import { Section } from "./Section"
@@ -21,9 +21,20 @@ type AboutProps = HTMLAttributes<HTMLDivElement> & {
 	setTelemetrySetting: (setting: TelemetrySetting) => void
 	debug?: boolean
 	setDebug?: (debug: boolean) => void
+	taskHistoryRetention: "never" | "90" | "60" | "30" | "7" | "3"
+	setTaskHistoryRetention: (value: "never" | "90" | "60" | "30" | "7" | "3") => void
 }
 
-export const About = ({ telemetrySetting, setTelemetrySetting, debug, setDebug, className, ...props }: AboutProps) => {
+export const About = ({
+	telemetrySetting,
+	setTelemetrySetting,
+	debug,
+	setDebug,
+	taskHistoryRetention,
+	setTaskHistoryRetention,
+	className,
+	...props
+}: AboutProps) => {
 	const { t } = useAppTranslation()
 
 	return (
@@ -131,10 +142,42 @@ export const About = ({ telemetrySetting, setTelemetrySetting, debug, setDebug,
 			</Section>
 
 			<Section className="space-y-0">
+				<SearchableSetting
+					settingId="about-task-history-retention"
+					section="about"
+					label={t("settings:aboutRetention.label")}
+					className="mt-4">
+					<h3>{t("settings:aboutRetention.label")}</h3>
+					<div className="mt-2">
+						<Select
+							value={taskHistoryRetention}
+							onValueChange={(value: "never" | "90" | "60" | "30" | "7" | "3") => {
+								setTaskHistoryRetention(value)
+							}}>
+							<SelectTrigger className="w-64">
+								<SelectValue placeholder={t("settings:common.select")} />
+							</SelectTrigger>
+							<SelectContent>
+								<SelectItem value="never">{t("settings:aboutRetention.options.never")}</SelectItem>
+								<SelectItem value="90">{t("settings:aboutRetention.options.90")}</SelectItem>
+								<SelectItem value="60">{t("settings:aboutRetention.options.60")}</SelectItem>
+								<SelectItem value="30">{t("settings:aboutRetention.options.30")}</SelectItem>
+								<SelectItem value="7">{t("settings:aboutRetention.options.7")}</SelectItem>
+								<SelectItem value="3">{t("settings:aboutRetention.options.3")}</SelectItem>
+							</SelectContent>
+						</Select>
+						<div className="text-vscode-descriptionForeground text-sm mt-1">
+							{t("settings:aboutRetention.description")}
+						</div>
+						<div className="text-red-500 text-sm mt-1">{t("settings:aboutRetention.warning")}</div>
+					</div>
+				</SearchableSetting>
+
 				<SearchableSetting
 					settingId="about-manage-settings"
 					section="about"
-					label={t("settings:about.manageSettings")}>
+					label={t("settings:about.manageSettings")}
+					className="mt-4 pt-4 border-t border-vscode-settings-headerBorder">
 					<h3>{t("settings:about.manageSettings")}</h3>
 					<div className="flex flex-wrap items-center gap-2">
 						<Button onClick={() => vscode.postMessage({ type: "exportSettings" })} className="w-28">
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index bd58db79e6d..1dfa20daf62 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -213,6 +213,7 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 		includeCurrentTime,
 		includeCurrentCost,
 		maxGitStatusFiles,
+		taskHistoryRetention,
 	} = cachedState
 
 	const apiConfiguration = useMemo(() => cachedState.apiConfiguration ?? {}, [cachedState.apiConfiguration])
@@ -423,6 +424,7 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 					includeCurrentTime: includeCurrentTime ?? true,
 					includeCurrentCost: includeCurrentCost ?? true,
 					maxGitStatusFiles: maxGitStatusFiles ?? 0,
+					taskHistoryRetention: taskHistoryRetention ?? "never",
 					profileThresholds,
 					imageGenerationProvider,
 					openRouterImageApiKey,
@@ -615,6 +617,17 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 	// Determine which tab content to render (for indexing or active display)
 	const renderTab = isIndexing ? sectionNames[indexingTabIndex] : activeTab
 
+	type TaskHistoryRetentionSetting = React.ComponentProps<typeof About>["taskHistoryRetention"]
+	const normalizedTaskHistoryRetention: TaskHistoryRetentionSetting =
+		taskHistoryRetention === "never" ||
+		taskHistoryRetention === "90" ||
+		taskHistoryRetention === "60" ||
+		taskHistoryRetention === "30" ||
+		taskHistoryRetention === "7" ||
+		taskHistoryRetention === "3"
+			? taskHistoryRetention
+			: "never"
+
 	// Handle search navigation - switch to the correct tab and scroll to the element
 	const handleSearchNavigate = useCallback(
 		(section: SectionName, settingId: string) => {
@@ -947,6 +960,8 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 								setTelemetrySetting={setTelemetrySetting}
 								debug={cachedState.debug}
 								setDebug={setDebug}
+								taskHistoryRetention={normalizedTaskHistoryRetention}
+								setTaskHistoryRetention={(value) => setCachedStateField("taskHistoryRetention", value)}
 							/>
 						)}
 					</SearchIndexProvider>
diff --git a/webview-ui/src/i18n/locales/en/settings.json b/webview-ui/src/i18n/locales/en/settings.json
index 7045ef07d19..62f98a1da65 100644
--- a/webview-ui/src/i18n/locales/en/settings.json
+++ b/webview-ui/src/i18n/locales/en/settings.json
@@ -905,6 +905,19 @@
 		"useCustomModel": "Use custom: {{modelId}}",
 		"simplifiedExplanation": "You can adjust detailed model settings later."
 	},
+	"aboutRetention": {
+		"label": "Auto-delete task history",
+		"description": "Deletes tasks older than the selected period on extension reload.",
+		"warning": "Warning: This action permanently deletes tasks and only runs on plugin reload.",
+		"options": {
+			"never": "Never",
+			"90": "90 days",
+			"60": "60 days",
+			"30": "30 days",
+			"7": "7 days",
+			"3": "3 days"
+		}
+	},
 	"footer": {
 		"telemetry": {
 			"label": "Allow anonymous error and usage reporting",

From e6395f2af8d5c83548a1722e149aed7f7b253302 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 19 Nov 2025 01:59:33 -0700
Subject: [PATCH 02/37] fix: address race condition in task purge by processing
 deletions sequentially

---
 src/utils/task-history-retention.ts | 171 ++++++++++++++--------------
 1 file changed, 87 insertions(+), 84 deletions(-)

diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 274033648ac..3c9723dfa11 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -142,107 +142,110 @@ export async function purgeOldTasks(
 		return !(await pathExists(dir))
 	}
 
-	const results = await Promise.all(
-		taskDirs.map(async (d) => {
-			const taskDir = path.join(tasksDir, d.name)
-			const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+	const results: number[] = []
 
-			let ts: number | null = null
+	for (const d of taskDirs) {
+		const taskDir = path.join(tasksDir, d.name)
+		const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
 
-			// First try to get a timestamp from task_metadata.json (if present)
-			try {
-				const raw = await fs.readFile(metadataPath, "utf8")
-				const meta = JSON.parse(raw)
-				const maybeTs = Number((meta as any)?.ts)
-				if (Number.isFinite(maybeTs)) {
-					ts = maybeTs
-				}
-			} catch {
-				// Missing or invalid metadata; we'll fall back to directory mtime.
+		let ts: number | null = null
+
+		// First try to get a timestamp from task_metadata.json (if present)
+		try {
+			const raw = await fs.readFile(metadataPath, "utf8")
+			const meta = JSON.parse(raw)
+			const maybeTs = Number((meta as any)?.ts)
+			if (Number.isFinite(maybeTs)) {
+				ts = maybeTs
 			}
+		} catch {
+			// Missing or invalid metadata; we'll fall back to directory mtime.
+		}
 
-			let shouldDelete = false
-			let reason = ""
+		let shouldDelete = false
+		let reason = ""
 
-			// Check for checkpoint-only orphan directories (delete regardless of age)
+		// Check for checkpoint-only orphan directories (delete regardless of age)
+		try {
+			const childEntries = await fs.readdir(taskDir, { withFileTypes: true })
+			const visibleNames = childEntries.map((e) => e.name).filter((n) => !n.startsWith("."))
+			const hasCheckpointsDir = childEntries.some((e) => e.isDirectory() && e.name === "checkpoints")
+			const nonCheckpointVisible = visibleNames.filter((n) => n !== "checkpoints")
+			const hasMetadataFile = visibleNames.includes(GlobalFileNames.taskMetadata)
+			if (hasCheckpointsDir && nonCheckpointVisible.length === 0 && !hasMetadataFile) {
+				shouldDelete = true
+				reason = "orphan checkpoints_only"
+			}
+		} catch {
+			// Ignore errors while scanning children; proceed with normal logic
+		}
+
+		if (!shouldDelete && ts !== null && ts < cutoff) {
+			// Normal case: metadata has a valid ts older than cutoff
+			shouldDelete = true
+			reason = `ts=${ts}`
+		} else if (!shouldDelete) {
+			// Orphan/legacy case: no valid ts; fall back to directory mtime
 			try {
-				const childEntries = await fs.readdir(taskDir, { withFileTypes: true })
-				const visibleNames = childEntries.map((e) => e.name).filter((n) => !n.startsWith("."))
-				const hasCheckpointsDir = childEntries.some((e) => e.isDirectory() && e.name === "checkpoints")
-				const nonCheckpointVisible = visibleNames.filter((n) => n !== "checkpoints")
-				const hasMetadataFile = visibleNames.includes(GlobalFileNames.taskMetadata)
-				if (hasCheckpointsDir && nonCheckpointVisible.length === 0 && !hasMetadataFile) {
+				const stat = await fs.stat(taskDir)
+				const mtimeMs = stat.mtime.getTime()
+				if (mtimeMs < cutoff) {
 					shouldDelete = true
-					reason = "orphan checkpoints_only"
+					reason = `no valid ts, mtime=${stat.mtime.toISOString()}`
 				}
 			} catch {
-				// Ignore errors while scanning children; proceed with normal logic
-			}
-
-			if (!shouldDelete && ts !== null && ts < cutoff) {
-				// Normal case: metadata has a valid ts older than cutoff
-				shouldDelete = true
-				reason = `ts=${ts}`
-			} else if (!shouldDelete) {
-				// Orphan/legacy case: no valid ts; fall back to directory mtime
-				try {
-					const stat = await fs.stat(taskDir)
-					const mtimeMs = stat.mtime.getTime()
-					if (mtimeMs < cutoff) {
-						shouldDelete = true
-						reason = `no valid ts, mtime=${stat.mtime.toISOString()}`
-					}
-				} catch {
-					// If we can't stat the directory, skip it.
-				}
+				// If we can't stat the directory, skip it.
 			}
+		}
 
-			if (!shouldDelete) {
-				return 0
-			}
+		if (!shouldDelete) {
+			results.push(0)
+			continue
+		}
 
-			if (dryRun) {
-				logv(`[Retention][DRY RUN] Would delete task ${d.name} (${reason}) @ ${taskDir}`)
-				return 1
-			}
+		if (dryRun) {
+			logv(`[Retention][DRY RUN] Would delete task ${d.name} (${reason}) @ ${taskDir}`)
+			results.push(1)
+			continue
+		}
 
-			// Attempt deletion using provider callback (for full cleanup) or direct rm
-			let deletionError: unknown | null = null
-			try {
-				if (deleteTaskById) {
-					logv(`[Retention] Deleting task ${d.name} via provider @ ${taskDir} (${reason})`)
-					await deleteTaskById(d.name, taskDir)
-				} else {
-					logv(`[Retention] Deleting task ${d.name} via fs.rm @ ${taskDir} (${reason})`)
-					await fs.rm(taskDir, { recursive: true, force: true })
-				}
-			} catch (e) {
-				deletionError = e
+		// Attempt deletion using provider callback (for full cleanup) or direct rm
+		let deletionError: unknown | null = null
+		try {
+			if (deleteTaskById) {
+				logv(`[Retention] Deleting task ${d.name} via provider @ ${taskDir} (${reason})`)
+				await deleteTaskById(d.name, taskDir)
+			} else {
+				logv(`[Retention] Deleting task ${d.name} via fs.rm @ ${taskDir} (${reason})`)
+				await fs.rm(taskDir, { recursive: true, force: true })
 			}
+		} catch (e) {
+			deletionError = e
+		}
 
-			// Verify deletion; if still exists, attempt aggressive cleanup with retries
-			let deleted = await removeDirAggressive(taskDir)
-
-			if (!deleted) {
-				// Did not actually remove; report the most relevant error
-				if (deletionError) {
-					log?.(
-						`[Retention] Failed to delete task ${d.name} @ ${taskDir}: ${
-							deletionError instanceof Error ? deletionError.message : String(deletionError)
-						} (directory still present)`,
-					)
-				} else {
-					log?.(
-						`[Retention] Failed to delete task ${d.name} @ ${taskDir}: directory still present after cleanup attempts`,
-					)
-				}
-				return 0
+		// Verify deletion; if still exists, attempt aggressive cleanup with retries
+		let deleted = await removeDirAggressive(taskDir)
+
+		if (!deleted) {
+			// Did not actually remove; report the most relevant error
+			if (deletionError) {
+				log?.(
+					`[Retention] Failed to delete task ${d.name} @ ${taskDir}: ${
+						deletionError instanceof Error ? deletionError.message : String(deletionError)
+					} (directory still present)`,
+				)
+			} else {
+				log?.(
+					`[Retention] Failed to delete task ${d.name} @ ${taskDir}: directory still present after cleanup attempts`,
+				)
 			}
+			results.push(0)
+			continue
+		}
 
-			logv(`[Retention] Deleted task ${d.name} (${reason}) @ ${taskDir}`)
-			return 1
-		}),
-	)
+		logv(`[Retention] Deleted task ${d.name} (${reason}) @ ${taskDir}`)
+		results.push(1)
+	}
 
 	const purged = results.reduce<number>((sum, n) => sum + n, 0)
 

From 7b8555dd3e009376aadf4cd1dc5a2f52e555f699 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 19 Nov 2025 02:18:12 -0700
Subject: [PATCH 03/37] fix: update translations for task history retention
 settings

---
 src/package.nls.ca.json    | 3 ++-
 src/package.nls.de.json    | 3 ++-
 src/package.nls.es.json    | 3 ++-
 src/package.nls.fr.json    | 3 ++-
 src/package.nls.hi.json    | 3 ++-
 src/package.nls.id.json    | 3 ++-
 src/package.nls.it.json    | 3 ++-
 src/package.nls.ja.json    | 3 ++-
 src/package.nls.ko.json    | 3 ++-
 src/package.nls.nl.json    | 3 ++-
 src/package.nls.pl.json    | 3 ++-
 src/package.nls.pt-BR.json | 3 ++-
 src/package.nls.ru.json    | 3 ++-
 src/package.nls.tr.json    | 3 ++-
 src/package.nls.vi.json    | 3 ++-
 src/package.nls.zh-CN.json | 3 ++-
 src/package.nls.zh-TW.json | 3 ++-
 17 files changed, 34 insertions(+), 17 deletions(-)

diff --git a/src/package.nls.ca.json b/src/package.nls.ca.json
index 2781ed169cf..ece0ac3ab51 100644
--- a/src/package.nls.ca.json
+++ b/src/package.nls.ca.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Activa el mode de depuració per mostrar botons addicionals per veure l'historial de conversa de l'API i els missatges de la interfície d'usuari com a JSON embellert en fitxers temporals.",
 	"settings.debugProxy.enabled.description": "**Habilita el Debug Proxy** — Redirigeix totes les sol·licituds de xarxa sortints a través d'un proxy per a debugging MITM. Només està actiu quan s'executa en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ex., `http://127.0.0.1:8888`). Només s'utilitza quan el **Debug Proxy** està habilitat.",
-	"settings.debugProxy.tlsInsecure.description": "Accepta certificats auto-signats del proxy. **Requerit per a la inspecció MITM.** ⚠️ Insegur — utilitza-ho només per a debugging local."
+	"settings.debugProxy.tlsInsecure.description": "Accepta certificats auto-signats del proxy. **Requerit per a la inspecció MITM.** ⚠️ Insegur — utilitza-ho només per a debugging local.",
+	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar el connector."
 }
diff --git a/src/package.nls.de.json b/src/package.nls.de.json
index a77a253ef06..d7a6b4972c6 100644
--- a/src/package.nls.de.json
+++ b/src/package.nls.de.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Aktiviere den Debug-Modus, um zusätzliche Schaltflächen zum Anzeigen des API-Konversationsverlaufs und der UI-Nachrichten als formatiertes JSON in temporären Dateien anzuzeigen.",
 	"settings.debugProxy.enabled.description": "**Debug-Proxy aktivieren** — Leite alle ausgehenden Netzwerkanfragen über einen Proxy für MITM-Debugging. Nur aktiv, wenn du im Debug-Modus (F5) läufst.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (z. B. `http://127.0.0.1:8888`). Wird nur verwendet, wenn der **Debug-Proxy** aktiviert ist.",
-	"settings.debugProxy.tlsInsecure.description": "Akzeptiere selbstsignierte Zertifikate vom Proxy. **Erforderlich für MITM-Inspektion.** ⚠️ Unsicher – verwende das nur für lokales Debugging."
+	"settings.debugProxy.tlsInsecure.description": "Akzeptiere selbstsignierte Zertifikate vom Proxy. **Erforderlich für MITM-Inspektion.** ⚠️ Unsicher – verwende das nur für lokales Debugging.",
+	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Plugin-Neustart ausgeführt."
 }
diff --git a/src/package.nls.es.json b/src/package.nls.es.json
index a1c729080e2..3ffc5924611 100644
--- a/src/package.nls.es.json
+++ b/src/package.nls.es.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Activa el modo de depuración para mostrar botones adicionales para ver el historial de conversación de API y los mensajes de la interfaz de usuario como JSON embellecido en archivos temporales.",
 	"settings.debugProxy.enabled.description": "**Activar Debug Proxy** — Redirige todas las solicitudes de red salientes a través de un proxy para depuración MITM. Solo está activo cuando se ejecuta en modo depuración (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ej., `http://127.0.0.1:8888`). Solo se usa cuando **Debug Proxy** está activado.",
-	"settings.debugProxy.tlsInsecure.description": "Aceptar certificados autofirmados del proxy. **Necesario para la inspección MITM.** ⚠️ Inseguro: úsalo solo para depuración local."
+	"settings.debugProxy.tlsInsecure.description": "Aceptar certificados autofirmados del proxy. **Necesario para la inspección MITM.** ⚠️ Inseguro: úsalo solo para depuración local.",
+	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar el plugin."
 }
diff --git a/src/package.nls.fr.json b/src/package.nls.fr.json
index 2d009c0038d..884312e33f2 100644
--- a/src/package.nls.fr.json
+++ b/src/package.nls.fr.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Active le mode debug pour afficher des boutons supplémentaires permettant de visualiser l'historique de conversation de l'API et les messages de l'interface utilisateur sous forme de JSON formaté dans des fichiers temporaires.",
 	"settings.debugProxy.enabled.description": "**Activer le Debug Proxy** — Redirige toutes les requêtes réseau sortantes via un proxy pour le debug MITM. Actif uniquement quand tu es en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL du proxy (par ex. `http://127.0.0.1:8888`). Utilisée uniquement quand le **Debug Proxy** est activé.",
-	"settings.debugProxy.tlsInsecure.description": "Accepter les certificats auto-signés du proxy. **Requis pour l'inspection MITM.** ⚠️ Non sécurisé — à utiliser uniquement pour le debug local."
+	"settings.debugProxy.tlsInsecure.description": "Accepter les certificats auto-signés du proxy. **Requis pour l'inspection MITM.** ⚠️ Non sécurisé — à utiliser uniquement pour le debug local.",
+	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement du plugin."
 }
diff --git a/src/package.nls.hi.json b/src/package.nls.hi.json
index c51f3ee95ee..ed1998a4ff9 100644
--- a/src/package.nls.hi.json
+++ b/src/package.nls.hi.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "API conversation history और UI messages को temporary files में prettified JSON के रूप में देखने के लिए अतिरिक्त बटन दिखाने के लिए debug mode सक्षम करें।",
 	"settings.debugProxy.enabled.description": "**Debug Proxy सक्षम करो** — सभी आउटबाउंड network requests को MITM debugging के लिए proxy के ज़रिए route करो। सिर्फ तब active रहेगा जब तुम debug mode (F5) में चला रहे हो।",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (जैसे `http://127.0.0.1:8888`)। सिर्फ तब इस्तेमाल होती है जब **Debug Proxy** enabled हो।",
-	"settings.debugProxy.tlsInsecure.description": "Proxy से आने वाले self-signed certificates accept करो। **MITM inspection के लिए ज़रूरी।** ⚠️ Insecure — सिर्फ local debugging के लिए इस्तेमाल करो।"
+	"settings.debugProxy.tlsInsecure.description": "Proxy से आने वाले self-signed certificates accept करो। **MITM inspection के लिए ज़रूरी।** ⚠️ Insecure — सिर्फ local debugging के लिए इस्तेमाल करो।",
+	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल प्लगइन रीलोड पर चलता है।"
 }
diff --git a/src/package.nls.id.json b/src/package.nls.id.json
index 2a7607f3e7c..6ac015485dd 100644
--- a/src/package.nls.id.json
+++ b/src/package.nls.id.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Aktifkan mode debug untuk menampilkan tombol tambahan untuk melihat riwayat percakapan API dan pesan UI sebagai JSON yang diformat dalam file sementara.",
 	"settings.debugProxy.enabled.description": "**Aktifkan Debug Proxy** — Arahkan semua permintaan jaringan keluar lewat proxy untuk debugging MITM. Hanya aktif saat kamu berjalan dalam mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (mis. `http://127.0.0.1:8888`). Hanya digunakan ketika **Debug Proxy** diaktifkan.",
-	"settings.debugProxy.tlsInsecure.description": "Terima sertifikat self-signed dari proxy. **Diperlukan untuk inspeksi MITM.** ⚠️ Tidak aman — gunakan hanya untuk debugging lokal."
+	"settings.debugProxy.tlsInsecure.description": "Terima sertifikat self-signed dari proxy. **Diperlukan untuk inspeksi MITM.** ⚠️ Tidak aman — gunakan hanya untuk debugging lokal.",
+	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang plugin."
 }
diff --git a/src/package.nls.it.json b/src/package.nls.it.json
index c94471355d4..539ad9bb00c 100644
--- a/src/package.nls.it.json
+++ b/src/package.nls.it.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Abilita la modalità debug per mostrare pulsanti aggiuntivi per visualizzare la cronologia delle conversazioni API e i messaggi dell'interfaccia utente come JSON formattato in file temporanei.",
 	"settings.debugProxy.enabled.description": "**Abilita Debug Proxy** — Instrada tutte le richieste di rete in uscita tramite un proxy per il debugging MITM. Attivo solo quando esegui in modalità debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (ad es. `http://127.0.0.1:8888`). Usato solo quando **Debug Proxy** è abilitato.",
-	"settings.debugProxy.tlsInsecure.description": "Accetta certificati autofirmati dal proxy. **Necessario per l'ispezione MITM.** ⚠️ Non sicuro — usalo solo per il debugging locale."
+	"settings.debugProxy.tlsInsecure.description": "Accetta certificati autofirmati dal proxy. **Necessario per l'ispezione MITM.** ⚠️ Non sicuro — usalo solo per il debugging locale.",
+	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento del plugin."
 }
diff --git a/src/package.nls.ja.json b/src/package.nls.ja.json
index ff6040d7734..7e18fd13919 100644
--- a/src/package.nls.ja.json
+++ b/src/package.nls.ja.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "デバッグモードを有効にして、API会話履歴とUIメッセージをフォーマットされたJSONとして一時ファイルで表示するための追加ボタンを表示します。",
 	"settings.debugProxy.enabled.description": "**Debug Proxy を有効化** — すべての送信ネットワーク要求を MITM デバッグのためにプロキシ経由でルーティングします。デバッグモード (F5) で実行しているときだけ有効です。",
 	"settings.debugProxy.serverUrl.description": "プロキシ URL（例: `http://127.0.0.1:8888`）。**Debug Proxy** が有効なときにだけ使用されます。",
-	"settings.debugProxy.tlsInsecure.description": "プロキシからの自己署名証明書を許可します。**MITM インスペクションに必須です。** ⚠️ 危険な設定なので、ローカルでのデバッグにだけ使用してください。"
+	"settings.debugProxy.tlsInsecure.description": "プロキシからの自己署名証明書を許可します。**MITM インスペクションに必須です。** ⚠️ 危険な設定なので、ローカルでのデバッグにだけ使用してください。",
+	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、プラグインの再読み込み時にのみ実行されます。"
 }
diff --git a/src/package.nls.ko.json b/src/package.nls.ko.json
index f0912835b8b..eb64fbbcecb 100644
--- a/src/package.nls.ko.json
+++ b/src/package.nls.ko.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "디버그 모드를 활성화하여 API 대화 기록과 UI 메시지를 임시 파일에 포맷된 JSON으로 보기 위한 추가 버튼을 표시합니다.",
 	"settings.debugProxy.enabled.description": "**Debug Proxy 활성화** — 모든 아웃바운드 네트워크 요청을 MITM 디버깅을 위해 프록시를 통해 라우팅합니다. 디버그 모드(F5)로 실행 중일 때만 활성화됩니다.",
 	"settings.debugProxy.serverUrl.description": "프록시 URL(예: `http://127.0.0.1:8888`). **Debug Proxy** 가 활성화된 경우에만 사용됩니다.",
-	"settings.debugProxy.tlsInsecure.description": "프록시의 self-signed 인증서를 허용합니다. **MITM 검사에 필요합니다.** ⚠️ 안전하지 않으므로 로컬 디버깅에만 사용하세요."
+	"settings.debugProxy.tlsInsecure.description": "프록시의 self-signed 인증서를 허용합니다. **MITM 검사에 필요합니다.** ⚠️ 안전하지 않으므로 로컬 디버깅에만 사용하세요.",
+	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 플러그인 재로드 시에만 실행됩니다."
 }
diff --git a/src/package.nls.nl.json b/src/package.nls.nl.json
index fef3ca7219c..ffe34c57af3 100644
--- a/src/package.nls.nl.json
+++ b/src/package.nls.nl.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Schakel debug-modus in om extra knoppen te tonen voor het bekijken van API-conversatiegeschiedenis en UI-berichten als opgemaakte JSON in tijdelijke bestanden.",
 	"settings.debugProxy.enabled.description": "**Debug Proxy inschakelen** — Leid alle uitgaande netwerkverzoeken via een proxy voor MITM-debugging. Alleen actief wanneer je in debugmodus (F5) draait.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (bijv. `http://127.0.0.1:8888`). Wordt alleen gebruikt wanneer **Debug Proxy** is ingeschakeld.",
-	"settings.debugProxy.tlsInsecure.description": "Accepteer zelfondertekende certificaten van de proxy. **Vereist voor MITM-inspectie.** ⚠️ Onveilig — gebruik dit alleen voor lokale debugging."
+	"settings.debugProxy.tlsInsecure.description": "Accepteer zelfondertekende certificaten van de proxy. **Vereist voor MITM-inspectie.** ⚠️ Onveilig — gebruik dit alleen voor lokale debugging.",
+	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de plugin."
 }
diff --git a/src/package.nls.pl.json b/src/package.nls.pl.json
index 8c1f66450d1..4fc954d8be1 100644
--- a/src/package.nls.pl.json
+++ b/src/package.nls.pl.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Włącz tryb debugowania, aby wyświetlić dodatkowe przyciski do przeglądania historii rozmów API i komunikatów interfejsu użytkownika jako sformatowany JSON w plikach tymczasowych.",
 	"settings.debugProxy.enabled.description": "**Włącz Debug Proxy** — Kieruj wszystkie wychodzące żądania sieciowe przez proxy na potrzeby debugowania MITM. Aktywne tylko wtedy, gdy uruchamiasz w trybie debugowania (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (np. `http://127.0.0.1:8888`). Używany tylko wtedy, gdy **Debug Proxy** jest włączony.",
-	"settings.debugProxy.tlsInsecure.description": "Akceptuj certyfikaty self-signed z proxy. **Wymagane do inspekcji MITM.** ⚠️ Niezabezpieczone — używaj tylko do lokalnego debugowania."
+	"settings.debugProxy.tlsInsecure.description": "Akceptuj certyfikaty self-signed z proxy. **Wymagane do inspekcji MITM.** ⚠️ Niezabezpieczone — używaj tylko do lokalnego debugowania.",
+	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu wtyczki."
 }
diff --git a/src/package.nls.pt-BR.json b/src/package.nls.pt-BR.json
index 84cbf42c097..9f4de7f464e 100644
--- a/src/package.nls.pt-BR.json
+++ b/src/package.nls.pt-BR.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Ativa o modo de depuração para mostrar botões adicionais para visualizar o histórico de conversas da API e mensagens da interface como JSON formatado em arquivos temporários.",
 	"settings.debugProxy.enabled.description": "**Ativar Debug Proxy** — Redireciona todas as solicitações de rede de saída por meio de um proxy para depuração MITM. Só fica ativo quando você está executando em modo de depuração (F5).",
 	"settings.debugProxy.serverUrl.description": "URL do proxy (por exemplo, `http://127.0.0.1:8888`). Só é usada quando o **Debug Proxy** está ativado.",
-	"settings.debugProxy.tlsInsecure.description": "Aceitar certificados self-signed do proxy. **Necessário para inspeção MITM.** ⚠️ Inseguro — use apenas para depuração local."
+	"settings.debugProxy.tlsInsecure.description": "Aceitar certificados self-signed do proxy. **Necessário para inspeção MITM.** ⚠️ Inseguro — use apenas para depuração local.",
+	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar o plugin."
 }
diff --git a/src/package.nls.ru.json b/src/package.nls.ru.json
index be8df040323..61b81a5c5ef 100644
--- a/src/package.nls.ru.json
+++ b/src/package.nls.ru.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Включить режим отладки, чтобы отображать дополнительные кнопки для просмотра истории разговоров API и сообщений интерфейса в виде форматированного JSON во временных файлах.",
 	"settings.debugProxy.enabled.description": "**Включить Debug Proxy** — направлять все исходящие сетевые запросы через прокси для MITM-отладки. Активен только когда ты запускаешь расширение в режиме отладки (F5).",
 	"settings.debugProxy.serverUrl.description": "URL прокси (например, `http://127.0.0.1:8888`). Используется только если **Debug Proxy** включён.",
-	"settings.debugProxy.tlsInsecure.description": "Принимать self-signed сертификаты от прокси. **Требуется для MITM-инспекции.** ⚠️ Небезопасно — используй только для локальной отладки."
+	"settings.debugProxy.tlsInsecure.description": "Принимать self-signed сертификаты от прокси. **Требуется для MITM-инспекции.** ⚠️ Небезопасно — используй только для локальной отладки.",
+	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке плагина."
 }
diff --git a/src/package.nls.tr.json b/src/package.nls.tr.json
index a815188e8aa..d302f20f3c9 100644
--- a/src/package.nls.tr.json
+++ b/src/package.nls.tr.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "API konuşma geçmişini ve kullanıcı arayüzü mesajlarını geçici dosyalarda biçimlendirilmiş JSON olarak görüntülemek için ek düğmeler göstermek üzere hata ayıklama modunu etkinleştir.",
 	"settings.debugProxy.enabled.description": "**Debug Proxy'yi etkinleştir** — Tüm giden ağ isteklerini MITM hata ayıklaması için bir proxy üzerinden yönlendir. Yalnızca debug modunda (F5) çalıştırırken aktiftir.",
 	"settings.debugProxy.serverUrl.description": "Proxy URL'si (ör. `http://127.0.0.1:8888`). Yalnızca **Debug Proxy** etkin olduğunda kullanılır.",
-	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan."
+	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan.",
+	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca eklenti yeniden yüklendiğinde çalışır."
 }
diff --git a/src/package.nls.vi.json b/src/package.nls.vi.json
index 6052080dfa3..c467f07d2f0 100644
--- a/src/package.nls.vi.json
+++ b/src/package.nls.vi.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "Bật chế độ gỡ lỗi để hiển thị các nút bổ sung để xem lịch sử hội thoại API và thông điệp giao diện người dùng dưới dạng JSON được định dạng trong các tệp tạm thời.",
 	"settings.debugProxy.enabled.description": "**Bật Debug Proxy** — Chuyển hướng tất cả yêu cầu mạng đi ra qua một proxy để debug MITM. Chỉ hoạt động khi bạn chạy ở chế độ gỡ lỗi (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (vd: `http://127.0.0.1:8888`). Chỉ được dùng khi **Debug Proxy** được bật.",
-	"settings.debugProxy.tlsInsecure.description": "Chấp nhận chứng chỉ self-signed từ proxy. **Bắt buộc cho việc kiểm tra MITM.** ⚠️ Không an toàn — chỉ dùng cho debug cục bộ."
+	"settings.debugProxy.tlsInsecure.description": "Chấp nhận chứng chỉ self-signed từ proxy. **Bắt buộc cho việc kiểm tra MITM.** ⚠️ Không an toàn — chỉ dùng cho debug cục bộ.",
+	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại plugin."
 }
diff --git a/src/package.nls.zh-CN.json b/src/package.nls.zh-CN.json
index 9254d494d9b..62eb6b47f99 100644
--- a/src/package.nls.zh-CN.json
+++ b/src/package.nls.zh-CN.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "启用调试模式以显示额外按钮，用于在临时文件中以格式化 JSON 查看 API 对话历史和 UI 消息。",
 	"settings.debugProxy.enabled.description": "**启用 Debug Proxy** — 通过代理转发所有出站网络请求，用于 MITM 调试。只在调试模式 (F5) 运行时生效。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。仅在启用 **Debug Proxy** 时使用。",
-	"settings.debugProxy.tlsInsecure.description": "接受来自代理的 self-signed 证书。**MITM 检查所必需。** ⚠️ 不安全——只在本地调试时使用。"
+	"settings.debugProxy.tlsInsecure.description": "接受来自代理的 self-signed 证书。**MITM 检查所必需。** ⚠️ 不安全——只在本地调试时使用。",
+	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在插件重新加载时运行。"
 }
diff --git a/src/package.nls.zh-TW.json b/src/package.nls.zh-TW.json
index a8030d69141..abb425e5aec 100644
--- a/src/package.nls.zh-TW.json
+++ b/src/package.nls.zh-TW.json
@@ -45,5 +45,6 @@
 	"settings.debug.description": "啟用偵錯模式以顯示額外按鈕，用於在暫存檔案中以格式化 JSON 檢視 API 對話歷史紀錄和使用者介面訊息。",
 	"settings.debugProxy.enabled.description": "**啟用 Debug Proxy** — 將所有出站網路要求透過代理進行路由，以進行 MITM 偵錯。只有在除錯模式 (F5) 執行時才會啟用。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。只有在啟用 **Debug Proxy** 時才會使用。",
-	"settings.debugProxy.tlsInsecure.description": "接受來自代理的 self-signed 憑證。**MITM 檢查所必需。** ⚠️ 不安全——只在本機偵錯時使用。"
+	"settings.debugProxy.tlsInsecure.description": "接受來自代理的 self-signed 憑證。**MITM 檢查所必需。** ⚠️ 不安全——只在本機偵錯時使用。",
+	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在外掛程式重新載入時執行。"
 }

From 5f08421e40a4a3c3822ab0157471c96d3e944d10 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 19 Nov 2025 02:36:38 -0700
Subject: [PATCH 04/37] fix: update settings.json translations for task history
 retention

---
 webview-ui/src/i18n/locales/ca/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/de/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/es/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/fr/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/hi/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/id/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/it/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/ja/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/ko/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/nl/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/pl/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/pt-BR/settings.json | 13 +++++++++++++
 webview-ui/src/i18n/locales/ru/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/tr/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/vi/settings.json    | 13 +++++++++++++
 webview-ui/src/i18n/locales/zh-CN/settings.json | 13 +++++++++++++
 webview-ui/src/i18n/locales/zh-TW/settings.json | 13 +++++++++++++
 17 files changed, 221 insertions(+)

diff --git a/webview-ui/src/i18n/locales/ca/settings.json b/webview-ui/src/i18n/locales/ca/settings.json
index 1509137a902..7e4895f9a77 100644
--- a/webview-ui/src/i18n/locales/ca/settings.json
+++ b/webview-ui/src/i18n/locales/ca/settings.json
@@ -896,6 +896,19 @@
 		"useCustomModel": "Utilitzar personalitzat: {{modelId}}",
 		"simplifiedExplanation": "Pots ajustar la configuració detallada del model més tard."
 	},
+	"aboutRetention": {
+		"label": "Eliminar automàticament l'historial de tasques",
+		"description": "Elimina les tasques anteriors al període seleccionat en recarregar l'extensió.",
+		"warning": "Advertència: Aquesta acció elimina permanentment les tasques i només s'executa en recarregar el complement.",
+		"options": {
+			"never": "Mai",
+			"90": "90 dies",
+			"60": "60 dies",
+			"30": "30 dies",
+			"7": "7 dies",
+			"3": "3 dies"
+		}
+	},
 	"footer": {
 		"feedback": "Si teniu qualsevol pregunta o comentari, no dubteu a obrir un issue a <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unir-vos a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/de/settings.json b/webview-ui/src/i18n/locales/de/settings.json
index bc275a64e50..abf46799050 100644
--- a/webview-ui/src/i18n/locales/de/settings.json
+++ b/webview-ui/src/i18n/locales/de/settings.json
@@ -896,6 +896,19 @@
 		"useCustomModel": "Benutzerdefiniert verwenden: {{modelId}}",
 		"simplifiedExplanation": "Du kannst detaillierte Modelleinstellungen später anpassen."
 	},
+	"aboutRetention": {
+		"label": "Aufgabenverlauf automatisch löschen",
+		"description": "Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind, beim Neuladen der Erweiterung.",
+		"warning": "Warnung: Diese Aktion löscht Aufgaben dauerhaft und wird nur beim Plugin-Neustart ausgeführt.",
+		"options": {
+			"never": "Nie",
+			"90": "90 Tage",
+			"60": "60 Tage",
+			"30": "30 Tage",
+			"7": "7 Tage",
+			"3": "3 Tage"
+		}
+	},
 	"footer": {
 		"feedback": "Wenn du Fragen oder Feedback hast, kannst du gerne ein Issue auf <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> eröffnen oder <redditLink>reddit.com/r/RooCode</redditLink> oder <discordLink>discord.gg/roocode</discordLink> beitreten",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/es/settings.json b/webview-ui/src/i18n/locales/es/settings.json
index 36243b99be0..6c625e568ef 100644
--- a/webview-ui/src/i18n/locales/es/settings.json
+++ b/webview-ui/src/i18n/locales/es/settings.json
@@ -896,6 +896,19 @@
 		"useCustomModel": "Usar personalizado: {{modelId}}",
 		"simplifiedExplanation": "Puedes ajustar la configuración detallada del modelo más tarde."
 	},
+	"aboutRetention": {
+		"label": "Eliminar automáticamente el historial de tareas",
+		"description": "Elimina las tareas anteriores al período seleccionado al recargar la extensión.",
+		"warning": "Advertencia: Esta acción elimina permanentemente las tareas y solo se ejecuta al recargar el complemento.",
+		"options": {
+			"never": "Nunca",
+			"90": "90 días",
+			"60": "60 días",
+			"30": "30 días",
+			"7": "7 días",
+			"3": "3 días"
+		}
+	},
 	"footer": {
 		"feedback": "Si tiene alguna pregunta o comentario, no dude en abrir un issue en <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unirse a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/fr/settings.json b/webview-ui/src/i18n/locales/fr/settings.json
index 1c28b763077..2d2b5c92948 100644
--- a/webview-ui/src/i18n/locales/fr/settings.json
+++ b/webview-ui/src/i18n/locales/fr/settings.json
@@ -896,6 +896,19 @@
 		"useCustomModel": "Utiliser personnalisé : {{modelId}}",
 		"simplifiedExplanation": "Tu peux ajuster les paramètres détaillés du modèle ultérieurement."
 	},
+	"aboutRetention": {
+		"label": "Supprimer automatiquement l'historique des tâches",
+		"description": "Supprime les tâches antérieures à la période sélectionnée lors du rechargement de l'extension.",
+		"warning": "Avertissement : Cette action supprime définitivement les tâches et ne s'exécute qu'au rechargement du plugin.",
+		"options": {
+			"never": "Jamais",
+			"90": "90 jours",
+			"60": "60 jours",
+			"30": "30 jours",
+			"7": "7 jours",
+			"3": "3 jours"
+		}
+	},
 	"footer": {
 		"feedback": "Si vous avez des questions ou des commentaires, n'hésitez pas à ouvrir un problème sur <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> ou à rejoindre <redditLink>reddit.com/r/RooCode</redditLink> ou <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/hi/settings.json b/webview-ui/src/i18n/locales/hi/settings.json
index 4974ff706b4..ff044811715 100644
--- a/webview-ui/src/i18n/locales/hi/settings.json
+++ b/webview-ui/src/i18n/locales/hi/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "कस्टम उपयोग करें: {{modelId}}",
 		"simplifiedExplanation": "आप बाद में विस्तृत मॉडल सेटिंग्स समायोजित कर सकते हैं।"
 	},
+	"aboutRetention": {
+		"label": "कार्य इतिहास स्वचालित रूप से हटाएं",
+		"description": "एक्सटेंशन रीलोड पर चयनित अवधि से पुराने कार्यों को हटा देता है।",
+		"warning": "चेतावनी: यह क्रिया स्थायी रूप से कार्यों को हटा देती है और केवल प्लगइन रीलोड पर चलती है।",
+		"options": {
+			"never": "कभी नहीं",
+			"90": "90 दिन",
+			"60": "60 दिन",
+			"30": "30 दिन",
+			"7": "7 दिन",
+			"3": "3 दिन"
+		}
+	},
 	"footer": {
 		"feedback": "यदि आपके कोई प्रश्न या प्रतिक्रिया है, तो <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> पर एक मुद्दा खोलने या <redditLink>reddit.com/r/RooCode</redditLink> या <discordLink>discord.gg/roocode</discordLink> में शामिल होने में संकोच न करें",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/id/settings.json b/webview-ui/src/i18n/locales/id/settings.json
index 908c975a5b8..35141502473 100644
--- a/webview-ui/src/i18n/locales/id/settings.json
+++ b/webview-ui/src/i18n/locales/id/settings.json
@@ -926,6 +926,19 @@
 		"useCustomModel": "Gunakan kustom: {{modelId}}",
 		"simplifiedExplanation": "Anda dapat menyesuaikan pengaturan model terperinci nanti."
 	},
+	"aboutRetention": {
+		"label": "Hapus otomatis riwayat tugas",
+		"description": "Menghapus tugas yang lebih lama dari periode yang dipilih saat memuat ulang ekstensi.",
+		"warning": "Peringatan: Tindakan ini menghapus tugas secara permanen dan hanya berjalan saat memuat ulang plugin.",
+		"options": {
+			"never": "Tidak pernah",
+			"90": "90 hari",
+			"60": "60 hari",
+			"30": "30 hari",
+			"7": "7 hari",
+			"3": "3 hari"
+		}
+	},
 	"footer": {
 		"feedback": "Jika kamu punya pertanyaan atau feedback, jangan ragu untuk membuka issue di <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> atau bergabung <redditLink>reddit.com/r/RooCode</redditLink> atau <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/it/settings.json b/webview-ui/src/i18n/locales/it/settings.json
index 1c3c7e494d7..51969663c71 100644
--- a/webview-ui/src/i18n/locales/it/settings.json
+++ b/webview-ui/src/i18n/locales/it/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Usa personalizzato: {{modelId}}",
 		"simplifiedExplanation": "Puoi modificare le impostazioni dettagliate del modello in seguito."
 	},
+	"aboutRetention": {
+		"label": "Elimina automaticamente la cronologia delle attività",
+		"description": "Elimina le attività più vecchie del periodo selezionato al ricaricamento dell'estensione.",
+		"warning": "Avviso: Questa azione elimina permanentemente le attività e viene eseguita solo al ricaricamento del plugin.",
+		"options": {
+			"never": "Mai",
+			"90": "90 giorni",
+			"60": "60 giorni",
+			"30": "30 giorni",
+			"7": "7 giorni",
+			"3": "3 giorni"
+		}
+	},
 	"footer": {
 		"feedback": "Se hai domande o feedback, sentiti libero di aprire un issue su <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unirti a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/ja/settings.json b/webview-ui/src/i18n/locales/ja/settings.json
index b4af9d4033e..a58cfe3bea5 100644
--- a/webview-ui/src/i18n/locales/ja/settings.json
+++ b/webview-ui/src/i18n/locales/ja/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "カスタムを使用: {{modelId}}",
 		"simplifiedExplanation": "詳細なモデル設定は後で調整できます。"
 	},
+	"aboutRetention": {
+		"label": "タスク履歴を自動削除",
+		"description": "拡張機能の再読み込み時に、選択された期間より古いタスクを削除します。",
+		"warning": "警告：この操作はタスクを完全に削除し、プラグインの再読み込み時のみ実行されます。",
+		"options": {
+			"never": "削除しない",
+			"90": "90日",
+			"60": "60日",
+			"30": "30日",
+			"7": "7日",
+			"3": "3日"
+		}
+	},
 	"footer": {
 		"feedback": "質問やフィードバックがある場合は、<githubLink>github.com/RooCodeInc/Roo-Code</githubLink>で問題を開くか、<redditLink>reddit.com/r/RooCode</redditLink>や<discordLink>discord.gg/roocode</discordLink>に参加してください",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/ko/settings.json b/webview-ui/src/i18n/locales/ko/settings.json
index 2888d75bb0b..86077f638eb 100644
--- a/webview-ui/src/i18n/locales/ko/settings.json
+++ b/webview-ui/src/i18n/locales/ko/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "사용자 정의 사용: {{modelId}}",
 		"simplifiedExplanation": "나중에 자세한 모델 설정을 조정할 수 있습니다."
 	},
+	"aboutRetention": {
+		"label": "작업 기록 자동 삭제",
+		"description": "확장 프로그램 재로드 시 선택한 기간보다 오래된 작업을 삭제합니다.",
+		"warning": "경고: 이 작업은 작업을 영구적으로 삭제하며 플러그인 재로드 시에만 실행됩니다.",
+		"options": {
+			"never": "삭제 안 함",
+			"90": "90일",
+			"60": "60일",
+			"30": "30일",
+			"7": "7일",
+			"3": "3일"
+		}
+	},
 	"footer": {
 		"feedback": "질문이나 피드백이 있으시면 <githubLink>github.com/RooCodeInc/Roo-Code</githubLink>에서 이슈를 열거나 <redditLink>reddit.com/r/RooCode</redditLink> 또는 <discordLink>discord.gg/roocode</discordLink>에 가입하세요",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/nl/settings.json b/webview-ui/src/i18n/locales/nl/settings.json
index 83e1f4b7ab3..57c05d05cfb 100644
--- a/webview-ui/src/i18n/locales/nl/settings.json
+++ b/webview-ui/src/i18n/locales/nl/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Aangepast gebruiken: {{modelId}}",
 		"simplifiedExplanation": "Je kunt later gedetailleerde modelinstellingen aanpassen."
 	},
+	"aboutRetention": {
+		"label": "Taakgeschiedenis automatisch verwijderen",
+		"description": "Verwijdert taken ouder dan de geselecteerde periode bij het herladen van de extensie.",
+		"warning": "Waarschuwing: Deze actie verwijdert taken permanent en wordt alleen uitgevoerd bij het herladen van de plugin.",
+		"options": {
+			"never": "Nooit",
+			"90": "90 dagen",
+			"60": "60 dagen",
+			"30": "30 dagen",
+			"7": "7 dagen",
+			"3": "3 dagen"
+		}
+	},
 	"footer": {
 		"feedback": "Heb je vragen of feedback? Open gerust een issue op <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> of sluit je aan bij <redditLink>reddit.com/r/RooCode</redditLink> of <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/pl/settings.json b/webview-ui/src/i18n/locales/pl/settings.json
index 7c339f96a5b..00ed00a094d 100644
--- a/webview-ui/src/i18n/locales/pl/settings.json
+++ b/webview-ui/src/i18n/locales/pl/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Użyj niestandardowy: {{modelId}}",
 		"simplifiedExplanation": "Można dostosować szczegółowe ustawienia modelu później."
 	},
+	"aboutRetention": {
+		"label": "Automatyczne usuwanie historii zadań",
+		"description": "Usuwa zadania starsze niż wybrany okres przy ponownym ładowaniu rozszerzenia.",
+		"warning": "Ostrzeżenie: Ta akcja trwale usuwa zadania i działa tylko przy ponownym ładowaniu wtyczki.",
+		"options": {
+			"never": "Nigdy",
+			"90": "90 dni",
+			"60": "60 dni",
+			"30": "30 dni",
+			"7": "7 dni",
+			"3": "3 dni"
+		}
+	},
 	"footer": {
 		"feedback": "Jeśli masz jakiekolwiek pytania lub opinie, śmiało otwórz zgłoszenie na <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> lub dołącz do <redditLink>reddit.com/r/RooCode</redditLink> lub <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/pt-BR/settings.json b/webview-ui/src/i18n/locales/pt-BR/settings.json
index 04a786ab11e..bbc0f8074af 100644
--- a/webview-ui/src/i18n/locales/pt-BR/settings.json
+++ b/webview-ui/src/i18n/locales/pt-BR/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Usar personalizado: {{modelId}}",
 		"simplifiedExplanation": "Você pode ajustar as configurações detalhadas do modelo mais tarde."
 	},
+	"aboutRetention": {
+		"label": "Excluir automaticamente o histórico de tarefas",
+		"description": "Exclui tarefas mais antigas que o período selecionado ao recarregar a extensão.",
+		"warning": "Aviso: Esta ação exclui permanentemente as tarefas e só é executada ao recarregar o plugin.",
+		"options": {
+			"never": "Nunca",
+			"90": "90 dias",
+			"60": "60 dias",
+			"30": "30 dias",
+			"7": "7 dias",
+			"3": "3 dias"
+		}
+	},
 	"footer": {
 		"feedback": "Se tiver alguma dúvida ou feedback, sinta-se à vontade para abrir um problema em <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> ou juntar-se a <redditLink>reddit.com/r/RooCode</redditLink> ou <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/ru/settings.json b/webview-ui/src/i18n/locales/ru/settings.json
index ebdbc01b931..70a67bbbf0d 100644
--- a/webview-ui/src/i18n/locales/ru/settings.json
+++ b/webview-ui/src/i18n/locales/ru/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Использовать пользовательскую: {{modelId}}",
 		"simplifiedExplanation": "Ты сможешь настроить подробные параметры модели позже."
 	},
+	"aboutRetention": {
+		"label": "Автоматически удалять историю задач",
+		"description": "Удаляет задачи старше выбранного периода при перезагрузке расширения.",
+		"warning": "Внимание: Это действие безвозвратно удаляет задачи и выполняется только при перезагрузке плагина.",
+		"options": {
+			"never": "Никогда",
+			"90": "90 дней",
+			"60": "60 дней",
+			"30": "30 дней",
+			"7": "7 дней",
+			"3": "3 дня"
+		}
+	},
 	"footer": {
 		"feedback": "Если у вас есть вопросы или предложения, откройте issue на <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> или присоединяйтесь к <redditLink>reddit.com/r/RooCode</redditLink> или <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/tr/settings.json b/webview-ui/src/i18n/locales/tr/settings.json
index 5a7daeec1d7..6a8b29b06d6 100644
--- a/webview-ui/src/i18n/locales/tr/settings.json
+++ b/webview-ui/src/i18n/locales/tr/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Özel kullan: {{modelId}}",
 		"simplifiedExplanation": "Ayrıntılı model ayarlarını daha sonra ayarlayabilirsiniz."
 	},
+	"aboutRetention": {
+		"label": "Görev geçmişini otomatik sil",
+		"description": "Uzantı yeniden yüklendiğinde seçilen döneme göre daha eski görevleri siler.",
+		"warning": "Uyarı: Bu işlem görevleri kalıcı olarak siler ve yalnızca eklenti yeniden yüklendiğinde çalışır.",
+		"options": {
+			"never": "Asla",
+			"90": "90 gün",
+			"60": "60 gün",
+			"30": "30 gün",
+			"7": "7 gün",
+			"3": "3 gün"
+		}
+	},
 	"footer": {
 		"feedback": "Herhangi bir sorunuz veya geri bildiriminiz varsa, <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> adresinde bir konu açmaktan veya <redditLink>reddit.com/r/RooCode</redditLink> ya da <discordLink>discord.gg/roocode</discordLink>'a katılmaktan çekinmeyin",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/vi/settings.json b/webview-ui/src/i18n/locales/vi/settings.json
index 3e8e22d8f0c..d0d82122a30 100644
--- a/webview-ui/src/i18n/locales/vi/settings.json
+++ b/webview-ui/src/i18n/locales/vi/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "Sử dụng tùy chỉnh: {{modelId}}",
 		"simplifiedExplanation": "Bạn có thể điều chỉnh cài đặt mô hình chi tiết sau."
 	},
+	"aboutRetention": {
+		"label": "Tự động xóa lịch sử tác vụ",
+		"description": "Xóa các tác vụ cũ hơn khoảng thời gian đã chọn khi tải lại tiện ích.",
+		"warning": "Cảnh báo: Hành động này xóa vĩnh viễn các tác vụ và chỉ chạy khi tải lại plugin.",
+		"options": {
+			"never": "Không bao giờ",
+			"90": "90 ngày",
+			"60": "60 ngày",
+			"30": "30 ngày",
+			"7": "7 ngày",
+			"3": "3 ngày"
+		}
+	},
 	"footer": {
 		"feedback": "Nếu bạn có bất kỳ câu hỏi hoặc phản hồi nào, vui lòng mở một vấn đề tại <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> hoặc tham gia <redditLink>reddit.com/r/RooCode</redditLink> hoặc <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/zh-CN/settings.json b/webview-ui/src/i18n/locales/zh-CN/settings.json
index 85bc9bd431b..7f5fc792539 100644
--- a/webview-ui/src/i18n/locales/zh-CN/settings.json
+++ b/webview-ui/src/i18n/locales/zh-CN/settings.json
@@ -897,6 +897,19 @@
 		"useCustomModel": "使用自定义：{{modelId}}",
 		"simplifiedExplanation": "你可以稍后调整详细的模型设置。"
 	},
+	"aboutRetention": {
+		"label": "自动删除任务历史",
+		"description": "扩展重新加载时删除早于所选时段的任务。",
+		"warning": "警告：此操作永久删除任务，仅在插件重新加载时运行。",
+		"options": {
+			"never": "永不",
+			"90": "90天",
+			"60": "60天",
+			"30": "30天",
+			"7": "7天",
+			"3": "3天"
+		}
+	},
 	"footer": {
 		"feedback": "如果您有任何问题或反馈，请随时在 <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> 上提出问题或加入 <redditLink>reddit.com/r/RooCode</redditLink> 或 <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/zh-TW/settings.json b/webview-ui/src/i18n/locales/zh-TW/settings.json
index 47f614932b9..bf89dbc8e63 100644
--- a/webview-ui/src/i18n/locales/zh-TW/settings.json
+++ b/webview-ui/src/i18n/locales/zh-TW/settings.json
@@ -905,6 +905,19 @@
 		"useCustomModel": "使用自訂模型：{{modelId}}",
 		"simplifiedExplanation": "你可以稍後調整詳細的模型設定。"
 	},
+	"aboutRetention": {
+		"label": "自動刪除工作歷程記錄",
+		"description": "擴充功能重新載入時刪除早於所選時段的工作。",
+		"warning": "警告：此操作永久刪除工作，僅在外掛程式重新載入時執行。",
+		"options": {
+			"never": "永不",
+			"90": "90天",
+			"60": "60天",
+			"30": "30天",
+			"7": "7天",
+			"3": "3天"
+		}
+	},
 	"footer": {
 		"telemetry": {
 			"label": "允許匿名錯誤與使用情況回報",

From f7298a0fae3bfbbfa88aca58da155d412f06be6e Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 26 Nov 2025 13:17:13 -0700
Subject: [PATCH 05/37] fix: update task history retention descriptions for
 multiple languages

---
 src/package.nls.ca.json    | 3 ++-
 src/package.nls.de.json    | 3 ++-
 src/package.nls.es.json    | 3 ++-
 src/package.nls.fr.json    | 3 ++-
 src/package.nls.hi.json    | 3 ++-
 src/package.nls.id.json    | 3 ++-
 src/package.nls.it.json    | 3 ++-
 src/package.nls.ja.json    | 3 ++-
 src/package.nls.json       | 3 ++-
 src/package.nls.ko.json    | 3 ++-
 src/package.nls.nl.json    | 3 ++-
 src/package.nls.pl.json    | 3 ++-
 src/package.nls.pt-BR.json | 3 ++-
 src/package.nls.ru.json    | 3 ++-
 src/package.nls.tr.json    | 3 ++-
 src/package.nls.vi.json    | 3 ++-
 src/package.nls.zh-CN.json | 3 ++-
 src/package.nls.zh-TW.json | 3 ++-
 18 files changed, 36 insertions(+), 18 deletions(-)

diff --git a/src/package.nls.ca.json b/src/package.nls.ca.json
index ece0ac3ab51..fd1fa2f2c12 100644
--- a/src/package.nls.ca.json
+++ b/src/package.nls.ca.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Habilita el Debug Proxy** — Redirigeix totes les sol·licituds de xarxa sortints a través d'un proxy per a debugging MITM. Només està actiu quan s'executa en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ex., `http://127.0.0.1:8888`). Només s'utilitza quan el **Debug Proxy** està habilitat.",
 	"settings.debugProxy.tlsInsecure.description": "Accepta certificats auto-signats del proxy. **Requerit per a la inspecció MITM.** ⚠️ Insegur — utilitza-ho només per a debugging local.",
-	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar el connector."
+	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar el connector.",
+	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar l'extensió."
 }
diff --git a/src/package.nls.de.json b/src/package.nls.de.json
index d7a6b4972c6..1f5d9b07985 100644
--- a/src/package.nls.de.json
+++ b/src/package.nls.de.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Debug-Proxy aktivieren** — Leite alle ausgehenden Netzwerkanfragen über einen Proxy für MITM-Debugging. Nur aktiv, wenn du im Debug-Modus (F5) läufst.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (z. B. `http://127.0.0.1:8888`). Wird nur verwendet, wenn der **Debug-Proxy** aktiviert ist.",
 	"settings.debugProxy.tlsInsecure.description": "Akzeptiere selbstsignierte Zertifikate vom Proxy. **Erforderlich für MITM-Inspektion.** ⚠️ Unsicher – verwende das nur für lokales Debugging.",
-	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Plugin-Neustart ausgeführt."
+	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Plugin-Neustart ausgeführt.",
+	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Neuladen der Erweiterung ausgeführt."
 }
diff --git a/src/package.nls.es.json b/src/package.nls.es.json
index 3ffc5924611..1be664dbbbe 100644
--- a/src/package.nls.es.json
+++ b/src/package.nls.es.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Activar Debug Proxy** — Redirige todas las solicitudes de red salientes a través de un proxy para depuración MITM. Solo está activo cuando se ejecuta en modo depuración (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ej., `http://127.0.0.1:8888`). Solo se usa cuando **Debug Proxy** está activado.",
 	"settings.debugProxy.tlsInsecure.description": "Aceptar certificados autofirmados del proxy. **Necesario para la inspección MITM.** ⚠️ Inseguro: úsalo solo para depuración local.",
-	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar el plugin."
+	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar el plugin.",
+	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar la extensión."
 }
diff --git a/src/package.nls.fr.json b/src/package.nls.fr.json
index 884312e33f2..47c0f61f75e 100644
--- a/src/package.nls.fr.json
+++ b/src/package.nls.fr.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Activer le Debug Proxy** — Redirige toutes les requêtes réseau sortantes via un proxy pour le debug MITM. Actif uniquement quand tu es en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL du proxy (par ex. `http://127.0.0.1:8888`). Utilisée uniquement quand le **Debug Proxy** est activé.",
 	"settings.debugProxy.tlsInsecure.description": "Accepter les certificats auto-signés du proxy. **Requis pour l'inspection MITM.** ⚠️ Non sécurisé — à utiliser uniquement pour le debug local.",
-	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement du plugin."
+	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement du plugin.",
+	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement de l'extension."
 }
diff --git a/src/package.nls.hi.json b/src/package.nls.hi.json
index ed1998a4ff9..2b4350bfd43 100644
--- a/src/package.nls.hi.json
+++ b/src/package.nls.hi.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy सक्षम करो** — सभी आउटबाउंड network requests को MITM debugging के लिए proxy के ज़रिए route करो। सिर्फ तब active रहेगा जब तुम debug mode (F5) में चला रहे हो।",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (जैसे `http://127.0.0.1:8888`)। सिर्फ तब इस्तेमाल होती है जब **Debug Proxy** enabled हो।",
 	"settings.debugProxy.tlsInsecure.description": "Proxy से आने वाले self-signed certificates accept करो। **MITM inspection के लिए ज़रूरी।** ⚠️ Insecure — सिर्फ local debugging के लिए इस्तेमाल करो।",
-	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल प्लगइन रीलोड पर चलता है।"
+	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल प्लगइन रीलोड पर चलता है।",
+	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल एक्सटेंशन रीलोड पर चलता है।"
 }
diff --git a/src/package.nls.id.json b/src/package.nls.id.json
index 6ac015485dd..5c73affba4e 100644
--- a/src/package.nls.id.json
+++ b/src/package.nls.id.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Aktifkan Debug Proxy** — Arahkan semua permintaan jaringan keluar lewat proxy untuk debugging MITM. Hanya aktif saat kamu berjalan dalam mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (mis. `http://127.0.0.1:8888`). Hanya digunakan ketika **Debug Proxy** diaktifkan.",
 	"settings.debugProxy.tlsInsecure.description": "Terima sertifikat self-signed dari proxy. **Diperlukan untuk inspeksi MITM.** ⚠️ Tidak aman — gunakan hanya untuk debugging lokal.",
-	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang plugin."
+	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang plugin.",
+	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang ekstensi."
 }
diff --git a/src/package.nls.it.json b/src/package.nls.it.json
index 539ad9bb00c..25b193cb86e 100644
--- a/src/package.nls.it.json
+++ b/src/package.nls.it.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Abilita Debug Proxy** — Instrada tutte le richieste di rete in uscita tramite un proxy per il debugging MITM. Attivo solo quando esegui in modalità debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (ad es. `http://127.0.0.1:8888`). Usato solo quando **Debug Proxy** è abilitato.",
 	"settings.debugProxy.tlsInsecure.description": "Accetta certificati autofirmati dal proxy. **Necessario per l'ispezione MITM.** ⚠️ Non sicuro — usalo solo per il debugging locale.",
-	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento del plugin."
+	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento del plugin.",
+	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento dell'estensione."
 }
diff --git a/src/package.nls.ja.json b/src/package.nls.ja.json
index 7e18fd13919..a68ec973c70 100644
--- a/src/package.nls.ja.json
+++ b/src/package.nls.ja.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy を有効化** — すべての送信ネットワーク要求を MITM デバッグのためにプロキシ経由でルーティングします。デバッグモード (F5) で実行しているときだけ有効です。",
 	"settings.debugProxy.serverUrl.description": "プロキシ URL（例: `http://127.0.0.1:8888`）。**Debug Proxy** が有効なときにだけ使用されます。",
 	"settings.debugProxy.tlsInsecure.description": "プロキシからの自己署名証明書を許可します。**MITM インスペクションに必須です。** ⚠️ 危険な設定なので、ローカルでのデバッグにだけ使用してください。",
-	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、プラグインの再読み込み時にのみ実行されます。"
+	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、プラグインの再読み込み時にのみ実行されます。",
+	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、拡張機能の再読み込み時にのみ実行されます。"
 }
diff --git a/src/package.nls.json b/src/package.nls.json
index 94107aed14d..d28e8525b4b 100644
--- a/src/package.nls.json
+++ b/src/package.nls.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Enable Debug Proxy** — Route all outbound network requests through a proxy for MITM debugging. Only active when running in debug mode (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (e.g., `http://127.0.0.1:8888`). Only used when **Debug Proxy** is enabled.",
 	"settings.debugProxy.tlsInsecure.description": "Accept self-signed certificates from the proxy. **Required for MITM inspection.** ⚠️ Insecure — only use for local debugging.",
-	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on plugin reload."
+	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on plugin reload.",
+	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on extension reload."
 }
diff --git a/src/package.nls.ko.json b/src/package.nls.ko.json
index eb64fbbcecb..b942400d820 100644
--- a/src/package.nls.ko.json
+++ b/src/package.nls.ko.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy 활성화** — 모든 아웃바운드 네트워크 요청을 MITM 디버깅을 위해 프록시를 통해 라우팅합니다. 디버그 모드(F5)로 실행 중일 때만 활성화됩니다.",
 	"settings.debugProxy.serverUrl.description": "프록시 URL(예: `http://127.0.0.1:8888`). **Debug Proxy** 가 활성화된 경우에만 사용됩니다.",
 	"settings.debugProxy.tlsInsecure.description": "프록시의 self-signed 인증서를 허용합니다. **MITM 검사에 필요합니다.** ⚠️ 안전하지 않으므로 로컬 디버깅에만 사용하세요.",
-	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 플러그인 재로드 시에만 실행됩니다."
+	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 플러그인 재로드 시에만 실행됩니다.",
+	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 확장 프로그램 재로드 시에만 실행됩니다."
 }
diff --git a/src/package.nls.nl.json b/src/package.nls.nl.json
index ffe34c57af3..62d03daaf44 100644
--- a/src/package.nls.nl.json
+++ b/src/package.nls.nl.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy inschakelen** — Leid alle uitgaande netwerkverzoeken via een proxy voor MITM-debugging. Alleen actief wanneer je in debugmodus (F5) draait.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (bijv. `http://127.0.0.1:8888`). Wordt alleen gebruikt wanneer **Debug Proxy** is ingeschakeld.",
 	"settings.debugProxy.tlsInsecure.description": "Accepteer zelfondertekende certificaten van de proxy. **Vereist voor MITM-inspectie.** ⚠️ Onveilig — gebruik dit alleen voor lokale debugging.",
-	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de plugin."
+	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de plugin.",
+	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de extensie."
 }
diff --git a/src/package.nls.pl.json b/src/package.nls.pl.json
index 4fc954d8be1..0811a204898 100644
--- a/src/package.nls.pl.json
+++ b/src/package.nls.pl.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Włącz Debug Proxy** — Kieruj wszystkie wychodzące żądania sieciowe przez proxy na potrzeby debugowania MITM. Aktywne tylko wtedy, gdy uruchamiasz w trybie debugowania (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (np. `http://127.0.0.1:8888`). Używany tylko wtedy, gdy **Debug Proxy** jest włączony.",
 	"settings.debugProxy.tlsInsecure.description": "Akceptuj certyfikaty self-signed z proxy. **Wymagane do inspekcji MITM.** ⚠️ Niezabezpieczone — używaj tylko do lokalnego debugowania.",
-	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu wtyczki."
+	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu wtyczki.",
+	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu rozszerzenia."
 }
diff --git a/src/package.nls.pt-BR.json b/src/package.nls.pt-BR.json
index 9f4de7f464e..2cf8d2f8d98 100644
--- a/src/package.nls.pt-BR.json
+++ b/src/package.nls.pt-BR.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Ativar Debug Proxy** — Redireciona todas as solicitações de rede de saída por meio de um proxy para depuração MITM. Só fica ativo quando você está executando em modo de depuração (F5).",
 	"settings.debugProxy.serverUrl.description": "URL do proxy (por exemplo, `http://127.0.0.1:8888`). Só é usada quando o **Debug Proxy** está ativado.",
 	"settings.debugProxy.tlsInsecure.description": "Aceitar certificados self-signed do proxy. **Necessário para inspeção MITM.** ⚠️ Inseguro — use apenas para depuração local.",
-	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar o plugin."
+	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar o plugin.",
+	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar a extensão."
 }
diff --git a/src/package.nls.ru.json b/src/package.nls.ru.json
index 61b81a5c5ef..474427bf709 100644
--- a/src/package.nls.ru.json
+++ b/src/package.nls.ru.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Включить Debug Proxy** — направлять все исходящие сетевые запросы через прокси для MITM-отладки. Активен только когда ты запускаешь расширение в режиме отладки (F5).",
 	"settings.debugProxy.serverUrl.description": "URL прокси (например, `http://127.0.0.1:8888`). Используется только если **Debug Proxy** включён.",
 	"settings.debugProxy.tlsInsecure.description": "Принимать self-signed сертификаты от прокси. **Требуется для MITM-инспекции.** ⚠️ Небезопасно — используй только для локальной отладки.",
-	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке плагина."
+	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке плагина.",
+	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке расширения."
 }
diff --git a/src/package.nls.tr.json b/src/package.nls.tr.json
index d302f20f3c9..7ea90d183fb 100644
--- a/src/package.nls.tr.json
+++ b/src/package.nls.tr.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy'yi etkinleştir** — Tüm giden ağ isteklerini MITM hata ayıklaması için bir proxy üzerinden yönlendir. Yalnızca debug modunda (F5) çalıştırırken aktiftir.",
 	"settings.debugProxy.serverUrl.description": "Proxy URL'si (ör. `http://127.0.0.1:8888`). Yalnızca **Debug Proxy** etkin olduğunda kullanılır.",
 	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan.",
-	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca eklenti yeniden yüklendiğinde çalışır."
+	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca eklenti yeniden yüklendiğinde çalışır.",
+	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır."
 }
diff --git a/src/package.nls.vi.json b/src/package.nls.vi.json
index c467f07d2f0..2e2460f6b51 100644
--- a/src/package.nls.vi.json
+++ b/src/package.nls.vi.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**Bật Debug Proxy** — Chuyển hướng tất cả yêu cầu mạng đi ra qua một proxy để debug MITM. Chỉ hoạt động khi bạn chạy ở chế độ gỡ lỗi (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (vd: `http://127.0.0.1:8888`). Chỉ được dùng khi **Debug Proxy** được bật.",
 	"settings.debugProxy.tlsInsecure.description": "Chấp nhận chứng chỉ self-signed từ proxy. **Bắt buộc cho việc kiểm tra MITM.** ⚠️ Không an toàn — chỉ dùng cho debug cục bộ.",
-	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại plugin."
+	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại plugin.",
+	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại tiện ích mở rộng."
 }
diff --git a/src/package.nls.zh-CN.json b/src/package.nls.zh-CN.json
index 62eb6b47f99..83fb5823494 100644
--- a/src/package.nls.zh-CN.json
+++ b/src/package.nls.zh-CN.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**启用 Debug Proxy** — 通过代理转发所有出站网络请求，用于 MITM 调试。只在调试模式 (F5) 运行时生效。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。仅在启用 **Debug Proxy** 时使用。",
 	"settings.debugProxy.tlsInsecure.description": "接受来自代理的 self-signed 证书。**MITM 检查所必需。** ⚠️ 不安全——只在本地调试时使用。",
-	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在插件重新加载时运行。"
+	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在插件重新加载时运行。",
+	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在扩展重新加载时运行。"
 }
diff --git a/src/package.nls.zh-TW.json b/src/package.nls.zh-TW.json
index abb425e5aec..8d7b8d3dbe1 100644
--- a/src/package.nls.zh-TW.json
+++ b/src/package.nls.zh-TW.json
@@ -46,5 +46,6 @@
 	"settings.debugProxy.enabled.description": "**啟用 Debug Proxy** — 將所有出站網路要求透過代理進行路由，以進行 MITM 偵錯。只有在除錯模式 (F5) 執行時才會啟用。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。只有在啟用 **Debug Proxy** 時才會使用。",
 	"settings.debugProxy.tlsInsecure.description": "接受來自代理的 self-signed 憑證。**MITM 檢查所必需。** ⚠️ 不安全——只在本機偵錯時使用。",
-	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在外掛程式重新載入時執行。"
+	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在外掛程式重新載入時執行。",
+	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在擴充功能重新載入時執行。"
 }

From be916cab7d4a62d80ccfdd446bcc228b9ee60e3d Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 26 Nov 2025 13:27:17 -0700
Subject: [PATCH 06/37] fix: remove unused import and fix translation issues
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Remove unused fs/promises import in extension.ts
- Fix Turkish translation: replace Cyrillic 'д' with Turkish 'd' in süreden
- Fix Catalan translation: use consistent 'extensió' terminology
---
 src/extension.ts                             | 1 -
 src/package.nls.tr.json                      | 3 ++-
 webview-ui/src/i18n/locales/ca/settings.json | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/extension.ts b/src/extension.ts
index b3184ecbdc5..e058378f3e8 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -1,7 +1,6 @@
 import * as vscode from "vscode"
 import * as dotenvx from "@dotenvx/dotenvx"
 import * as path from "path"
-import * as fs from "fs/promises"
 
 // Load environment variables from .env file
 try {
diff --git a/src/package.nls.tr.json b/src/package.nls.tr.json
index 7ea90d183fb..09f58c9f7d8 100644
--- a/src/package.nls.tr.json
+++ b/src/package.nls.tr.json
@@ -47,5 +47,6 @@
 	"settings.debugProxy.serverUrl.description": "Proxy URL'si (ör. `http://127.0.0.1:8888`). Yalnızca **Debug Proxy** etkin olduğunda kullanılır.",
 	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan.",
 	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca eklenti yeniden yüklendiğinde çalışır.",
-	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır."
+	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır.",
+	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreden eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır."
 }
diff --git a/webview-ui/src/i18n/locales/ca/settings.json b/webview-ui/src/i18n/locales/ca/settings.json
index 7e4895f9a77..f17c2004241 100644
--- a/webview-ui/src/i18n/locales/ca/settings.json
+++ b/webview-ui/src/i18n/locales/ca/settings.json
@@ -899,7 +899,7 @@
 	"aboutRetention": {
 		"label": "Eliminar automàticament l'historial de tasques",
 		"description": "Elimina les tasques anteriors al període seleccionat en recarregar l'extensió.",
-		"warning": "Advertència: Aquesta acció elimina permanentment les tasques i només s'executa en recarregar el complement.",
+		"warning": "Advertència: Aquesta acció elimina permanentment les tasques i només s'executa en recarregar l'extensió.",
 		"options": {
 			"never": "Mai",
 			"90": "90 dies",

From fc04b9fc68dfe2663302fa7124513f5081b2f72b Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 26 Nov 2025 13:34:59 -0700
Subject: [PATCH 07/37] fix: add missing props to About.spec.tsx tests

---
 webview-ui/src/components/settings/__tests__/About.spec.tsx | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/webview-ui/src/components/settings/__tests__/About.spec.tsx b/webview-ui/src/components/settings/__tests__/About.spec.tsx
index 78c4981a80c..7d79fb73ca3 100644
--- a/webview-ui/src/components/settings/__tests__/About.spec.tsx
+++ b/webview-ui/src/components/settings/__tests__/About.spec.tsx
@@ -29,6 +29,8 @@ describe("About", () => {
 	const defaultProps = {
 		telemetrySetting: "enabled" as const,
 		setTelemetrySetting: vi.fn(),
+		taskHistoryRetention: "never",
+		setTaskHistoryRetention: vi.fn(),
 	}
 
 	beforeEach(() => {

From 8b30590665c9ad1ba1dd848220a8aad230768186 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 26 Nov 2025 14:26:23 -0700
Subject: [PATCH 08/37] fix: remove 'as any' type casts in retention feature

- Import and use RetentionSetting type instead of 'as any' in extension.ts
- Use proper type narrowing for metadata parsing instead of 'as any'
---
 src/extension.ts                    | 4 ++--
 src/utils/task-history-retention.ts | 6 ++++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/extension.ts b/src/extension.ts
index e058378f3e8..b37db5123a2 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -44,7 +44,7 @@ import {
 } from "./activate"
 import { initializeI18n } from "./i18n"
 import { flushModels, initializeModelCacheRefresh, refreshModels } from "./api/providers/fetchers/modelCache"
-import { purgeOldTasks } from "./utils/task-history-retention"
+import { purgeOldTasks, RetentionSetting } from "./utils/task-history-retention"
 
 /**
  * Built using https://github.com/microsoft/vscode-webview-ui-toolkit
@@ -175,7 +175,7 @@ export async function activate(context: vscode.ExtensionContext) {
 		outputChannel.appendLine(`[Retention] Startup purge: setting=${retention}`)
 
 		const result = await purgeOldTasks(
-			retention as any,
+			retention as RetentionSetting,
 			contextProxy.globalStorageUri.fsPath,
 			(m) => {
 				outputChannel.appendLine(m)
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 3c9723dfa11..0d64976e317 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -153,8 +153,10 @@ export async function purgeOldTasks(
 		// First try to get a timestamp from task_metadata.json (if present)
 		try {
 			const raw = await fs.readFile(metadataPath, "utf8")
-			const meta = JSON.parse(raw)
-			const maybeTs = Number((meta as any)?.ts)
+			const meta: unknown = JSON.parse(raw)
+			const maybeTs = Number(
+				typeof meta === "object" && meta !== null && "ts" in meta ? (meta as { ts: unknown }).ts : undefined,
+			)
 			if (Number.isFinite(maybeTs)) {
 				ts = maybeTs
 			}

From dbf47c259ec75afabd86c27c4732909a5dcbe0e4 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 26 Nov 2025 17:07:57 -0700
Subject: [PATCH 09/37] refactor(retention): narrow RetentionSetting type and
 optimize deletion flow

- Replace generic 'number' with explicit RetentionDays union type to prevent accidental misconfiguration
- Skip aggressive fs cleanup when deleteTaskById callback successfully removes the directory
- This avoids redundant filesystem work and log noise on stubborn paths
---
 src/utils/task-history-retention.ts | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 0d64976e317..98ce4b8e195 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -5,12 +5,17 @@ import type { Dirent } from "fs"
 import { getStorageBasePath } from "./storage"
 import { GlobalFileNames } from "../shared/globalFileNames"
 
+/**
+ * Allowed retention day values (as numbers).
+ */
+export type RetentionDays = 90 | 60 | 30 | 7 | 3
+
 /**
  * Supported values for the retention setting.
  * - "never" or 0 disables purging
  * - "90" | "60" | "30" | "7" | "3" (string) or 90 | 60 | 30 | 7 | 3 (number) specify days
  */
-export type RetentionSetting = "never" | "90" | "60" | "30" | "7" | "3" | 90 | 60 | 30 | 7 | 3 | 0 | "0" | number
+export type RetentionSetting = "never" | "0" | `${RetentionDays}` | RetentionDays | 0
 
 export type PurgeResult = {
 	purgedCount: number
@@ -213,20 +218,26 @@ export async function purgeOldTasks(
 
 		// Attempt deletion using provider callback (for full cleanup) or direct rm
 		let deletionError: unknown | null = null
+		let deleted = false
 		try {
 			if (deleteTaskById) {
 				logv(`[Retention] Deleting task ${d.name} via provider @ ${taskDir} (${reason})`)
 				await deleteTaskById(d.name, taskDir)
+				// Provider callback handles full cleanup; check if directory is gone
+				deleted = !(await pathExists(taskDir))
 			} else {
 				logv(`[Retention] Deleting task ${d.name} via fs.rm @ ${taskDir} (${reason})`)
 				await fs.rm(taskDir, { recursive: true, force: true })
+				deleted = !(await pathExists(taskDir))
 			}
 		} catch (e) {
 			deletionError = e
 		}
 
-		// Verify deletion; if still exists, attempt aggressive cleanup with retries
-		let deleted = await removeDirAggressive(taskDir)
+		// If directory still exists after initial attempt, try aggressive cleanup with retries
+		if (!deleted) {
+			deleted = await removeDirAggressive(taskDir)
+		}
 
 		if (!deleted) {
 			// Did not actually remove; report the most relevant error

From 8c142755be540fce194639e838184f02194aec23 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 18:41:26 -0700
Subject: [PATCH 10/37] test(webview): align About component test props with
 new retention union

---
 webview-ui/src/components/settings/__tests__/About.spec.tsx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/webview-ui/src/components/settings/__tests__/About.spec.tsx b/webview-ui/src/components/settings/__tests__/About.spec.tsx
index 7d79fb73ca3..92791b4ac53 100644
--- a/webview-ui/src/components/settings/__tests__/About.spec.tsx
+++ b/webview-ui/src/components/settings/__tests__/About.spec.tsx
@@ -1,3 +1,5 @@
+import type { ComponentProps } from "react"
+
 import { render, screen } from "@/utils/test-utils"
 
 import { TranslationProvider } from "@/i18n/__mocks__/TranslationContext"
@@ -26,7 +28,7 @@ vi.mock("@roo/package", () => ({
 }))
 
 describe("About", () => {
-	const defaultProps = {
+	const defaultProps: ComponentProps<typeof About> = {
 		telemetrySetting: "enabled" as const,
 		setTelemetrySetting: vi.fn(),
 		taskHistoryRetention: "never",

From d1bdbd56b883c310f6780b3e64b26116d14c69de Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 19:48:53 -0700
Subject: [PATCH 11/37] test: stabilize checkpoint service temp dir cleanup

---
 .../__tests__/ShadowCheckpointService.spec.ts | 23 +++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts b/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts
index ee8f7bbdc9c..07efa4ac2cb 100644
--- a/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts
+++ b/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts
@@ -12,7 +12,9 @@ import * as fileSearch from "../../../services/search/file-search"
 
 import { RepoPerTaskCheckpointService } from "../RepoPerTaskCheckpointService"
 
-const tmpDir = path.join(os.tmpdir(), "CheckpointService")
+// Use a unique tmp directory per test run to avoid collisions with other
+// Vitest workers/processes and to keep cleanup fast/reliable on Windows.
+const tmpDir = path.join(os.tmpdir(), `CheckpointService-${process.pid}-${Date.now()}`)
 
 const initWorkspaceRepo = async ({
 	workspaceDir,
@@ -55,10 +57,12 @@ describe.each([[RepoPerTaskCheckpointService, "RepoPerTaskCheckpointService"]])(
 		let workspaceGit: SimpleGit
 		let testFile: string
 		let service: RepoPerTaskCheckpointService
+		let shadowDir: string
+		let workspaceDir: string
 
 		beforeEach(async () => {
-			const shadowDir = path.join(tmpDir, `${prefix}-${Date.now()}`)
-			const workspaceDir = path.join(tmpDir, `workspace-${Date.now()}`)
+			shadowDir = path.join(tmpDir, `${prefix}-${Date.now()}`)
+			workspaceDir = path.join(tmpDir, `workspace-${Date.now()}`)
 			const repo = await initWorkspaceRepo({ workspaceDir })
 
 			workspaceGit = repo.git
@@ -70,10 +74,21 @@ describe.each([[RepoPerTaskCheckpointService, "RepoPerTaskCheckpointService"]])(
 
 		afterEach(async () => {
 			vitest.restoreAllMocks()
+
+			// Clean up per-test directories to prevent a huge accumulated tmp tree.
+			// This makes Windows CI much less likely to hit slow/blocked recursive deletes.
+			await Promise.all([
+				fs
+					.rm(shadowDir, { recursive: true, force: true, maxRetries: 10, retryDelay: 100 })
+					.catch(() => undefined),
+				fs
+					.rm(workspaceDir, { recursive: true, force: true, maxRetries: 10, retryDelay: 100 })
+					.catch(() => undefined),
+			])
 		})
 
 		afterAll(async () => {
-			await fs.rm(tmpDir, { recursive: true, force: true })
+			await fs.rm(tmpDir, { recursive: true, force: true, maxRetries: 10, retryDelay: 100 })
 		}, 60_000) // 60 second timeout for Windows cleanup
 
 		describe(`${klass.name}#getDiff`, () => {

From 06df1ca0689260c93b66163a837f5b78491978e5 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 20:15:09 -0700
Subject: [PATCH 12/37] Update src/extension.ts

Co-authored-by: Seth Miller <sethmillerp@gmail.com>
---
 src/extension.ts | 32 --------------------------------
 1 file changed, 32 deletions(-)

diff --git a/src/extension.ts b/src/extension.ts
index b37db5123a2..07636d2fb65 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -166,38 +166,6 @@ export async function activate(context: vscode.ExtensionContext) {
 
 	// Initialize the provider *before* the Roo Code Cloud service so we can reuse its task deletion logic.
 	const provider = new ClineProvider(context, outputChannel, "sidebar", contextProxy, mdmService)
-
-	// Task history retention purge (runs only on activation)
-	try {
-		const config = vscode.workspace.getConfiguration(Package.name)
-		const retention = config.get<string>("taskHistoryRetention", "never") ?? "never"
-
-		outputChannel.appendLine(`[Retention] Startup purge: setting=${retention}`)
-
-		const result = await purgeOldTasks(
-			retention as RetentionSetting,
-			contextProxy.globalStorageUri.fsPath,
-			(m) => {
-				outputChannel.appendLine(m)
-				console.log(m)
-			},
-			false,
-			async (taskId: string, _taskDirPath: string) => {
-				// Reuse the same internal deletion logic as the History view so that
-				// checkpoints, shadow repositories, and task state are cleaned up consistently.
-				await provider.deleteTaskWithId(taskId)
-			},
-		)
-
-		outputChannel.appendLine(
-			`[Retention] Startup purge complete: purged=${result.purgedCount}, cutoff=${result.cutoff ?? "none"}`,
-		)
-	} catch (error) {
-		outputChannel.appendLine(
-			`[Retention] Failed during startup purge: ${error instanceof Error ? error.message : String(error)}`,
-		)
-	}
-
 	// Initialize code index managers for all workspace folders.
 	const codeIndexManagers: CodeIndexManager[] = []
 

From 64b08fb1072de1df2ab7ea15535fbb9667b742a5 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 20:15:17 -0700
Subject: [PATCH 13/37] Update src/__tests__/task-history-retention.spec.ts

Co-authored-by: Seth Miller <sethmillerp@gmail.com>
---
 src/__tests__/task-history-retention.spec.ts | 124 +++++++++++++++++++
 1 file changed, 124 insertions(+)

diff --git a/src/__tests__/task-history-retention.spec.ts b/src/__tests__/task-history-retention.spec.ts
index 3bb4b2a55a2..0201c8fcc50 100644
--- a/src/__tests__/task-history-retention.spec.ts
+++ b/src/__tests__/task-history-retention.spec.ts
@@ -138,4 +138,128 @@ describe("utils/task-history-retention.ts purgeOldTasks()", () => {
 			await fs.rm(base, { recursive: true, force: true })
 		}
 	})
+
+	it("deletes orphan checkpoint-only directories regardless of age", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create a normal task that is recent (should be kept)
+			const normalTask = await createTask(base, "task-normal", now - days(1))
+
+			// Create an orphan checkpoint-only directory (only has checkpoints/ subdirectory, no metadata)
+			const orphanDir = path.join(base, "tasks", "task-orphan-checkpoints")
+			await fs.mkdir(orphanDir, { recursive: true })
+			const checkpointsDir = path.join(orphanDir, "checkpoints")
+			await fs.mkdir(checkpointsDir, { recursive: true })
+			// Add a dummy file inside checkpoints to make it realistic
+			await fs.writeFile(path.join(checkpointsDir, "checkpoint-1.json"), "{}", "utf8")
+
+			// Create another orphan with just checkpoints (no other files)
+			const orphanDir2 = path.join(base, "tasks", "task-orphan-empty")
+			await fs.mkdir(orphanDir2, { recursive: true })
+			const checkpointsDir2 = path.join(orphanDir2, "checkpoints")
+			await fs.mkdir(checkpointsDir2, { recursive: true })
+
+			// Run purge with 7 day retention - orphans should be deleted regardless of age
+			const { purgedCount } = await purgeOldTasks("7", base, () => {})
+
+			// Orphan directories should be deleted even though they're "recent"
+			expect(await exists(orphanDir)).toBe(false)
+			expect(await exists(orphanDir2)).toBe(false)
+			// Normal task should still exist (it's recent)
+			expect(await exists(normalTask)).toBe(true)
+			// Should have deleted 2 orphan directories
+			expect(purgedCount).toBe(2)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("does not delete directories with checkpoints AND other content", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create a task directory with both checkpoints and other files (but recent, so should be kept)
+			const taskDir = path.join(base, "tasks", "task-with-content")
+			await fs.mkdir(taskDir, { recursive: true })
+			const checkpointsDir = path.join(taskDir, "checkpoints")
+			await fs.mkdir(checkpointsDir, { recursive: true })
+			await fs.writeFile(path.join(checkpointsDir, "checkpoint-1.json"), "{}", "utf8")
+			// Add other files (not just checkpoints)
+			await fs.writeFile(path.join(taskDir, "some-file.txt"), "content", "utf8")
+			// Note: No metadata file, so it's technically invalid but has content
+
+			const { purgedCount } = await purgeOldTasks("7", base, () => {})
+
+			// Should NOT be deleted because it has content besides checkpoints
+			expect(await exists(taskDir)).toBe(true)
+			expect(purgedCount).toBe(0)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("falls back to directory mtime for legacy tasks without metadata", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create a legacy task directory without any metadata file
+			const oldLegacyDir = path.join(base, "tasks", "task-legacy-old")
+			await fs.mkdir(oldLegacyDir, { recursive: true })
+			// Add some content file
+			await fs.writeFile(path.join(oldLegacyDir, "content.txt"), "old task", "utf8")
+			// Manually set mtime to 10 days ago by touching the directory
+			const oldTime = new Date(now - days(10))
+			await fs.utimes(oldLegacyDir, oldTime, oldTime)
+
+			// Create another legacy task that is recent
+			const recentLegacyDir = path.join(base, "tasks", "task-legacy-recent")
+			await fs.mkdir(recentLegacyDir, { recursive: true })
+			await fs.writeFile(path.join(recentLegacyDir, "content.txt"), "recent task", "utf8")
+			// This one has recent mtime (now)
+
+			// Run purge with 7 day retention
+			const { purgedCount } = await purgeOldTasks("7", base, () => {})
+
+			// Old legacy task should be deleted based on mtime
+			expect(await exists(oldLegacyDir)).toBe(false)
+			// Recent legacy task should be kept
+			expect(await exists(recentLegacyDir)).toBe(true)
+			expect(purgedCount).toBe(1)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("prioritizes metadata timestamp over mtime when both exist", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create task with old metadata ts but recent mtime
+			const taskDir = path.join(base, "tasks", "task-priority-test")
+			await fs.mkdir(taskDir, { recursive: true })
+			const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+			// Metadata says it's 10 days old (should be deleted with 7 day retention)
+			const metadata = JSON.stringify({ ts: now - days(10) }, null, 2)
+			await fs.writeFile(metadataPath, metadata, "utf8")
+			// But directory mtime is recent (could happen after editing)
+			// (Directory mtime is automatically recent from mkdir/writeFile)
+
+			const { purgedCount } = await purgeOldTasks("7", base, () => {})
+
+			// Should be deleted based on metadata ts, not mtime
+			expect(await exists(taskDir)).toBe(false)
+			expect(purgedCount).toBe(1)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
 })

From f145a52de2da97d39cac08559df574254ff3fe3a Mon Sep 17 00:00:00 2001
From: daniel-lxs <ricciodaniel98@gmail.com>
Date: Mon, 19 Jan 2026 22:42:23 -0500
Subject: [PATCH 14/37] fix: clarify aboutRetention text - runs on extension
 activation, not plugin reload

- Updated description and warning text for aboutRetention in all 18 languages
- Changed 'plugin reload' to 'extension is activated' for clarity
- Changed 'deletes tasks' to 'deletes old tasks' to clarify it doesn't delete all tasks
---
 webview-ui/src/i18n/locales/ca/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/de/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/en/settings.json    | 13 +++++++++++--
 webview-ui/src/i18n/locales/es/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/fr/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/hi/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/id/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/it/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/ja/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/ko/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/nl/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/pl/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/pt-BR/settings.json |  4 ++--
 webview-ui/src/i18n/locales/ru/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/tr/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/vi/settings.json    |  4 ++--
 webview-ui/src/i18n/locales/zh-CN/settings.json |  4 ++--
 webview-ui/src/i18n/locales/zh-TW/settings.json |  4 ++--
 18 files changed, 45 insertions(+), 36 deletions(-)

diff --git a/webview-ui/src/i18n/locales/ca/settings.json b/webview-ui/src/i18n/locales/ca/settings.json
index f17c2004241..c835a6cf6bd 100644
--- a/webview-ui/src/i18n/locales/ca/settings.json
+++ b/webview-ui/src/i18n/locales/ca/settings.json
@@ -898,8 +898,8 @@
 	},
 	"aboutRetention": {
 		"label": "Eliminar automàticament l'historial de tasques",
-		"description": "Elimina les tasques anteriors al període seleccionat en recarregar l'extensió.",
-		"warning": "Advertència: Aquesta acció elimina permanentment les tasques i només s'executa en recarregar l'extensió.",
+		"description": "Elimina les tasques anteriors al període seleccionat quan s'activa l'extensió.",
+		"warning": "Advertència: Aquesta acció elimina permanentment les tasques antigues i s'executa quan s'activa l'extensió.",
 		"options": {
 			"never": "Mai",
 			"90": "90 dies",
diff --git a/webview-ui/src/i18n/locales/de/settings.json b/webview-ui/src/i18n/locales/de/settings.json
index abf46799050..8d21d6b425b 100644
--- a/webview-ui/src/i18n/locales/de/settings.json
+++ b/webview-ui/src/i18n/locales/de/settings.json
@@ -898,8 +898,8 @@
 	},
 	"aboutRetention": {
 		"label": "Aufgabenverlauf automatisch löschen",
-		"description": "Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind, beim Neuladen der Erweiterung.",
-		"warning": "Warnung: Diese Aktion löscht Aufgaben dauerhaft und wird nur beim Plugin-Neustart ausgeführt.",
+		"description": "Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind, wenn die Erweiterung aktiviert wird.",
+		"warning": "Warnung: Diese Aktion löscht alte Aufgaben dauerhaft und wird ausgeführt, wenn die Erweiterung aktiviert wird.",
 		"options": {
 			"never": "Nie",
 			"90": "90 Tage",
diff --git a/webview-ui/src/i18n/locales/en/settings.json b/webview-ui/src/i18n/locales/en/settings.json
index 62f98a1da65..a379414f513 100644
--- a/webview-ui/src/i18n/locales/en/settings.json
+++ b/webview-ui/src/i18n/locales/en/settings.json
@@ -907,8 +907,8 @@
 	},
 	"aboutRetention": {
 		"label": "Auto-delete task history",
-		"description": "Deletes tasks older than the selected period on extension reload.",
-		"warning": "Warning: This action permanently deletes tasks and only runs on plugin reload.",
+		"description": "Deletes tasks older than the selected period when the extension is activated.",
+		"warning": "Warning: This action permanently deletes old tasks and runs when the extension is activated.",
 		"options": {
 			"never": "Never",
 			"90": "90 days",
@@ -918,6 +918,15 @@
 			"3": "3 days"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Storage usage",
+		"calculating": "Calculating...",
+		"format": "{{size}} ({{count}} tasks)",
+		"formatSingular": "{{size}} (1 task)",
+		"empty": "No tasks stored",
+		"refresh": "Refresh",
+		"error": "Unable to calculate"
+	},
 	"footer": {
 		"telemetry": {
 			"label": "Allow anonymous error and usage reporting",
diff --git a/webview-ui/src/i18n/locales/es/settings.json b/webview-ui/src/i18n/locales/es/settings.json
index 6c625e568ef..3c8d7638e63 100644
--- a/webview-ui/src/i18n/locales/es/settings.json
+++ b/webview-ui/src/i18n/locales/es/settings.json
@@ -898,8 +898,8 @@
 	},
 	"aboutRetention": {
 		"label": "Eliminar automáticamente el historial de tareas",
-		"description": "Elimina las tareas anteriores al período seleccionado al recargar la extensión.",
-		"warning": "Advertencia: Esta acción elimina permanentemente las tareas y solo se ejecuta al recargar el complemento.",
+		"description": "Elimina las tareas anteriores al período seleccionado cuando se activa la extensión.",
+		"warning": "Advertencia: Esta acción elimina permanentemente las tareas antiguas y se ejecuta cuando se activa la extensión.",
 		"options": {
 			"never": "Nunca",
 			"90": "90 días",
diff --git a/webview-ui/src/i18n/locales/fr/settings.json b/webview-ui/src/i18n/locales/fr/settings.json
index 2d2b5c92948..0234af74b2d 100644
--- a/webview-ui/src/i18n/locales/fr/settings.json
+++ b/webview-ui/src/i18n/locales/fr/settings.json
@@ -898,8 +898,8 @@
 	},
 	"aboutRetention": {
 		"label": "Supprimer automatiquement l'historique des tâches",
-		"description": "Supprime les tâches antérieures à la période sélectionnée lors du rechargement de l'extension.",
-		"warning": "Avertissement : Cette action supprime définitivement les tâches et ne s'exécute qu'au rechargement du plugin.",
+		"description": "Supprime les tâches antérieures à la période sélectionnée lorsque l'extension est activée.",
+		"warning": "Avertissement : Cette action supprime définitivement les anciennes tâches et s'exécute lorsque l'extension est activée.",
 		"options": {
 			"never": "Jamais",
 			"90": "90 jours",
diff --git a/webview-ui/src/i18n/locales/hi/settings.json b/webview-ui/src/i18n/locales/hi/settings.json
index ff044811715..950403e8064 100644
--- a/webview-ui/src/i18n/locales/hi/settings.json
+++ b/webview-ui/src/i18n/locales/hi/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "कार्य इतिहास स्वचालित रूप से हटाएं",
-		"description": "एक्सटेंशन रीलोड पर चयनित अवधि से पुराने कार्यों को हटा देता है।",
-		"warning": "चेतावनी: यह क्रिया स्थायी रूप से कार्यों को हटा देती है और केवल प्लगइन रीलोड पर चलती है।",
+		"description": "एक्सटेंशन सक्रिय होने पर चयनित अवधि से पुराने कार्यों को हटा देता है।",
+		"warning": "चेतावनी: यह क्रिया स्थायी रूप से पुराने कार्यों को हटा देती है और एक्सटेंशन सक्रिय होने पर चलती है।",
 		"options": {
 			"never": "कभी नहीं",
 			"90": "90 दिन",
diff --git a/webview-ui/src/i18n/locales/id/settings.json b/webview-ui/src/i18n/locales/id/settings.json
index 35141502473..eedb8a8c05d 100644
--- a/webview-ui/src/i18n/locales/id/settings.json
+++ b/webview-ui/src/i18n/locales/id/settings.json
@@ -928,8 +928,8 @@
 	},
 	"aboutRetention": {
 		"label": "Hapus otomatis riwayat tugas",
-		"description": "Menghapus tugas yang lebih lama dari periode yang dipilih saat memuat ulang ekstensi.",
-		"warning": "Peringatan: Tindakan ini menghapus tugas secara permanen dan hanya berjalan saat memuat ulang plugin.",
+		"description": "Menghapus tugas yang lebih lama dari periode yang dipilih saat ekstensi diaktifkan.",
+		"warning": "Peringatan: Tindakan ini menghapus tugas lama secara permanen dan berjalan saat ekstensi diaktifkan.",
 		"options": {
 			"never": "Tidak pernah",
 			"90": "90 hari",
diff --git a/webview-ui/src/i18n/locales/it/settings.json b/webview-ui/src/i18n/locales/it/settings.json
index 51969663c71..b037283b317 100644
--- a/webview-ui/src/i18n/locales/it/settings.json
+++ b/webview-ui/src/i18n/locales/it/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Elimina automaticamente la cronologia delle attività",
-		"description": "Elimina le attività più vecchie del periodo selezionato al ricaricamento dell'estensione.",
-		"warning": "Avviso: Questa azione elimina permanentemente le attività e viene eseguita solo al ricaricamento del plugin.",
+		"description": "Elimina le attività più vecchie del periodo selezionato quando l'estensione viene attivata.",
+		"warning": "Avviso: Questa azione elimina permanentemente le attività vecchie e viene eseguita quando l'estensione viene attivata.",
 		"options": {
 			"never": "Mai",
 			"90": "90 giorni",
diff --git a/webview-ui/src/i18n/locales/ja/settings.json b/webview-ui/src/i18n/locales/ja/settings.json
index a58cfe3bea5..197a5917251 100644
--- a/webview-ui/src/i18n/locales/ja/settings.json
+++ b/webview-ui/src/i18n/locales/ja/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "タスク履歴を自動削除",
-		"description": "拡張機能の再読み込み時に、選択された期間より古いタスクを削除します。",
-		"warning": "警告：この操作はタスクを完全に削除し、プラグインの再読み込み時のみ実行されます。",
+		"description": "拡張機能が起動したときに、選択された期間より古いタスクを削除します。",
+		"warning": "警告：この操作は古いタスクを完全に削除し、拡張機能が起動したときに実行されます。",
 		"options": {
 			"never": "削除しない",
 			"90": "90日",
diff --git a/webview-ui/src/i18n/locales/ko/settings.json b/webview-ui/src/i18n/locales/ko/settings.json
index 86077f638eb..f07f5788927 100644
--- a/webview-ui/src/i18n/locales/ko/settings.json
+++ b/webview-ui/src/i18n/locales/ko/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "작업 기록 자동 삭제",
-		"description": "확장 프로그램 재로드 시 선택한 기간보다 오래된 작업을 삭제합니다.",
-		"warning": "경고: 이 작업은 작업을 영구적으로 삭제하며 플러그인 재로드 시에만 실행됩니다.",
+		"description": "확장 프로그램이 활성화될 때 선택한 기간보다 오래된 작업을 삭제합니다.",
+		"warning": "경고: 이 작업은 오래된 작업을 영구적으로 삭제하며 확장 프로그램이 활성화될 때 실행됩니다.",
 		"options": {
 			"never": "삭제 안 함",
 			"90": "90일",
diff --git a/webview-ui/src/i18n/locales/nl/settings.json b/webview-ui/src/i18n/locales/nl/settings.json
index 57c05d05cfb..974e6e9a041 100644
--- a/webview-ui/src/i18n/locales/nl/settings.json
+++ b/webview-ui/src/i18n/locales/nl/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Taakgeschiedenis automatisch verwijderen",
-		"description": "Verwijdert taken ouder dan de geselecteerde periode bij het herladen van de extensie.",
-		"warning": "Waarschuwing: Deze actie verwijdert taken permanent en wordt alleen uitgevoerd bij het herladen van de plugin.",
+		"description": "Verwijdert taken ouder dan de geselecteerde periode wanneer de extensie wordt geactiveerd.",
+		"warning": "Waarschuwing: Deze actie verwijdert oude taken permanent en wordt uitgevoerd wanneer de extensie wordt geactiveerd.",
 		"options": {
 			"never": "Nooit",
 			"90": "90 dagen",
diff --git a/webview-ui/src/i18n/locales/pl/settings.json b/webview-ui/src/i18n/locales/pl/settings.json
index 00ed00a094d..ad2260844f9 100644
--- a/webview-ui/src/i18n/locales/pl/settings.json
+++ b/webview-ui/src/i18n/locales/pl/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Automatyczne usuwanie historii zadań",
-		"description": "Usuwa zadania starsze niż wybrany okres przy ponownym ładowaniu rozszerzenia.",
-		"warning": "Ostrzeżenie: Ta akcja trwale usuwa zadania i działa tylko przy ponownym ładowaniu wtyczki.",
+		"description": "Usuwa zadania starsze niż wybrany okres po aktywacji rozszerzenia.",
+		"warning": "Ostrzeżenie: Ta akcja trwale usuwa stare zadania i działa po aktywacji rozszerzenia.",
 		"options": {
 			"never": "Nigdy",
 			"90": "90 dni",
diff --git a/webview-ui/src/i18n/locales/pt-BR/settings.json b/webview-ui/src/i18n/locales/pt-BR/settings.json
index bbc0f8074af..e924d329591 100644
--- a/webview-ui/src/i18n/locales/pt-BR/settings.json
+++ b/webview-ui/src/i18n/locales/pt-BR/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Excluir automaticamente o histórico de tarefas",
-		"description": "Exclui tarefas mais antigas que o período selecionado ao recarregar a extensão.",
-		"warning": "Aviso: Esta ação exclui permanentemente as tarefas e só é executada ao recarregar o plugin.",
+		"description": "Exclui tarefas mais antigas que o período selecionado quando a extensão é ativada.",
+		"warning": "Aviso: Esta ação exclui permanentemente as tarefas antigas e é executada quando a extensão é ativada.",
 		"options": {
 			"never": "Nunca",
 			"90": "90 dias",
diff --git a/webview-ui/src/i18n/locales/ru/settings.json b/webview-ui/src/i18n/locales/ru/settings.json
index 70a67bbbf0d..b34fa8ea525 100644
--- a/webview-ui/src/i18n/locales/ru/settings.json
+++ b/webview-ui/src/i18n/locales/ru/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Автоматически удалять историю задач",
-		"description": "Удаляет задачи старше выбранного периода при перезагрузке расширения.",
-		"warning": "Внимание: Это действие безвозвратно удаляет задачи и выполняется только при перезагрузке плагина.",
+		"description": "Удаляет задачи старше выбранного периода при активации расширения.",
+		"warning": "Внимание: Это действие безвозвратно удаляет старые задачи и выполняется при активации расширения.",
 		"options": {
 			"never": "Никогда",
 			"90": "90 дней",
diff --git a/webview-ui/src/i18n/locales/tr/settings.json b/webview-ui/src/i18n/locales/tr/settings.json
index 6a8b29b06d6..c1bbb3f6130 100644
--- a/webview-ui/src/i18n/locales/tr/settings.json
+++ b/webview-ui/src/i18n/locales/tr/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Görev geçmişini otomatik sil",
-		"description": "Uzantı yeniden yüklendiğinde seçilen döneme göre daha eski görevleri siler.",
-		"warning": "Uyarı: Bu işlem görevleri kalıcı olarak siler ve yalnızca eklenti yeniden yüklendiğinde çalışır.",
+		"description": "Uzantı etkinleştirildiğinde seçilen döneme göre daha eski görevleri siler.",
+		"warning": "Uyarı: Bu işlem eski görevleri kalıcı olarak siler ve uzantı etkinleştirildiğinde çalışır.",
 		"options": {
 			"never": "Asla",
 			"90": "90 gün",
diff --git a/webview-ui/src/i18n/locales/vi/settings.json b/webview-ui/src/i18n/locales/vi/settings.json
index d0d82122a30..7d6a3393777 100644
--- a/webview-ui/src/i18n/locales/vi/settings.json
+++ b/webview-ui/src/i18n/locales/vi/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "Tự động xóa lịch sử tác vụ",
-		"description": "Xóa các tác vụ cũ hơn khoảng thời gian đã chọn khi tải lại tiện ích.",
-		"warning": "Cảnh báo: Hành động này xóa vĩnh viễn các tác vụ và chỉ chạy khi tải lại plugin.",
+		"description": "Xóa các tác vụ cũ hơn khoảng thời gian đã chọn khi tiện ích được kích hoạt.",
+		"warning": "Cảnh báo: Hành động này xóa vĩnh viễn các tác vụ cũ và chạy khi tiện ích được kích hoạt.",
 		"options": {
 			"never": "Không bao giờ",
 			"90": "90 ngày",
diff --git a/webview-ui/src/i18n/locales/zh-CN/settings.json b/webview-ui/src/i18n/locales/zh-CN/settings.json
index 7f5fc792539..bcfb46ae3fc 100644
--- a/webview-ui/src/i18n/locales/zh-CN/settings.json
+++ b/webview-ui/src/i18n/locales/zh-CN/settings.json
@@ -899,8 +899,8 @@
 	},
 	"aboutRetention": {
 		"label": "自动删除任务历史",
-		"description": "扩展重新加载时删除早于所选时段的任务。",
-		"warning": "警告：此操作永久删除任务，仅在插件重新加载时运行。",
+		"description": "扩展激活时删除早于所选时段的任务。",
+		"warning": "警告：此操作永久删除旧任务，并在扩展激活时运行。",
 		"options": {
 			"never": "永不",
 			"90": "90天",
diff --git a/webview-ui/src/i18n/locales/zh-TW/settings.json b/webview-ui/src/i18n/locales/zh-TW/settings.json
index bf89dbc8e63..67b5f750ffd 100644
--- a/webview-ui/src/i18n/locales/zh-TW/settings.json
+++ b/webview-ui/src/i18n/locales/zh-TW/settings.json
@@ -907,8 +907,8 @@
 	},
 	"aboutRetention": {
 		"label": "自動刪除工作歷程記錄",
-		"description": "擴充功能重新載入時刪除早於所選時段的工作。",
-		"warning": "警告：此操作永久刪除工作，僅在外掛程式重新載入時執行。",
+		"description": "擴充功能啟動時刪除早於所選時段的工作。",
+		"warning": "警告：此操作永久刪除舊工作，並在擴充功能啟動時執行。",
 		"options": {
 			"never": "永不",
 			"90": "90天",

From b6f662f8523306ad7cff6c0d56d16a6298f25f82 Mon Sep 17 00:00:00 2001
From: daniel-lxs <ricciodaniel98@gmail.com>
Date: Mon, 19 Jan 2026 22:46:14 -0500
Subject: [PATCH 15/37] feat: add task storage size display to settings

- Add storage usage display showing total size and task count
- Add calculateTaskStorageSize utility to compute global storage folder sizes
- Add getTaskStorageSize message handler to communicate storage info to webview
- Update About settings section to display storage usage with refresh button
- Add taskHistoryStorage translations for all 18 supported languages
---
 packages/types/src/global-settings.ts         |   8 +
 packages/types/src/vscode-extension-host.ts   |  10 +
 src/core/webview/ClineProvider.ts             |   5 +
 src/core/webview/webviewMessageHandler.ts     |  21 ++
 src/utils/__tests__/task-storage-size.spec.ts | 237 ++++++++++++++++++
 src/utils/task-storage-size.ts                | 138 ++++++++++
 webview-ui/src/components/settings/About.tsx  |  85 ++++++-
 .../src/components/settings/SettingsView.tsx  |  11 +
 8 files changed, 513 insertions(+), 2 deletions(-)
 create mode 100644 src/utils/__tests__/task-storage-size.spec.ts
 create mode 100644 src/utils/task-storage-size.ts

diff --git a/packages/types/src/global-settings.ts b/packages/types/src/global-settings.ts
index d1266b34321..681324fe7a8 100644
--- a/packages/types/src/global-settings.ts
+++ b/packages/types/src/global-settings.ts
@@ -183,6 +183,14 @@ export const globalSettingsSchema = z.object({
 	includeTaskHistoryInEnhance: z.boolean().optional(),
 	// Auto-delete task history on extension reload. "never" | "90" | "60" | "30" | "7" | "3"
 	taskHistoryRetention: z.union([z.enum(["never", "90", "60", "30", "7", "3"]), z.number()]).optional(),
+	// Calculated task history storage size info for the Settings > About page
+	taskHistorySize: z
+		.object({
+			totalBytes: z.number(),
+			taskCount: z.number(),
+			formattedSize: z.string(),
+		})
+		.optional(),
 	historyPreviewCollapsed: z.boolean().optional(),
 	reasoningBlockCollapsed: z.boolean().optional(),
 	/**
diff --git a/packages/types/src/vscode-extension-host.ts b/packages/types/src/vscode-extension-host.ts
index 9e55fab1769..5a6bae36fe0 100644
--- a/packages/types/src/vscode-extension-host.ts
+++ b/packages/types/src/vscode-extension-host.ts
@@ -396,6 +396,15 @@ export type ExtensionState = Pick<
 	marketplaceInstalledMetadata?: { project: Record<string, any>; global: Record<string, any> }
 	profileThresholds: Record<string, number>
 	hasOpenedModeSelector: boolean
+	/** Task history storage size info for the Settings > About page */
+	taskHistorySize?: {
+		/** Total size in bytes */
+		totalBytes: number
+		/** Number of task directories */
+		taskCount: number
+		/** Formatted size string (e.g., "12.34 MB") */
+		formattedSize: string
+	}
 	openRouterImageApiKey?: string
 	messageQueue?: QueuedMessage[]
 	lastShownAnnouncementId?: string
@@ -593,6 +602,7 @@ export interface WebviewMessage {
 		| "requestModes"
 		| "switchMode"
 		| "debugSetting"
+		| "refreshTaskHistorySize"
 		// Worktree messages
 		| "listWorktrees"
 		| "createWorktree"
diff --git a/src/core/webview/ClineProvider.ts b/src/core/webview/ClineProvider.ts
index 64ad5a06403..bbe8d388a77 100644
--- a/src/core/webview/ClineProvider.ts
+++ b/src/core/webview/ClineProvider.ts
@@ -2054,6 +2054,7 @@ export class ClineProvider
 			enterBehavior,
 			cloudUserInfo,
 			taskHistoryRetention,
+			taskHistorySize,
 			cloudIsAuthenticated,
 			sharingEnabled,
 			publicSharingEnabled,
@@ -2239,6 +2240,8 @@ export class ClineProvider
 			includeTaskHistoryInEnhance: includeTaskHistoryInEnhance ?? true,
 			// Task history retention setting for About tab dropdown
 			taskHistoryRetention: taskHistoryRetention ?? "never",
+			// Task history storage size info for the Settings > About page
+			taskHistorySize,
 			includeCurrentTime: includeCurrentTime ?? true,
 			includeCurrentCost: includeCurrentCost ?? true,
 			maxGitStatusFiles: maxGitStatusFiles ?? 0,
@@ -2456,6 +2459,8 @@ export class ClineProvider
 			customCondensingPrompt: stateValues.customCondensingPrompt,
 			// Task history retention selection
 			taskHistoryRetention: stateValues.taskHistoryRetention ?? "never",
+			// Task history storage size info
+			taskHistorySize: stateValues.taskHistorySize,
 			codebaseIndexModels: stateValues.codebaseIndexModels ?? EMBEDDING_MODEL_PROFILES,
 			codebaseIndexConfig: {
 				codebaseIndexEnabled: stateValues.codebaseIndexConfig?.codebaseIndexEnabled ?? false,
diff --git a/src/core/webview/webviewMessageHandler.ts b/src/core/webview/webviewMessageHandler.ts
index 9adbbbf0035..2042ff2fb63 100644
--- a/src/core/webview/webviewMessageHandler.ts
+++ b/src/core/webview/webviewMessageHandler.ts
@@ -532,6 +532,9 @@ export const webviewMessageHandler = async (
 				TelemetryService.instance.updateTelemetryState(isOptedIn)
 			})
 
+			// Note: Task history storage size calculation is triggered on-demand when the About
+			// settings tab is opened (via "refreshTaskHistorySize" message), not on webview launch.
+
 			provider.isViewLaunched = true
 			break
 		case "newTask":
@@ -3343,6 +3346,24 @@ export const webviewMessageHandler = async (
 			break
 		}
 
+		case "refreshTaskHistorySize": {
+			// Refresh the task history storage size calculation
+			try {
+				const { calculateTaskStorageSize } = await import("../../utils/task-storage-size")
+				const globalStoragePath = provider.contextProxy.globalStorageUri.fsPath
+				const sizeInfo = await calculateTaskStorageSize(globalStoragePath)
+
+				// Update state and notify webview
+				await provider.contextProxy.setValue("taskHistorySize", sizeInfo)
+				await provider.postStateToWebview()
+			} catch (error) {
+				provider.log(
+					`Error refreshing task history size: ${error instanceof Error ? error.message : String(error)}`,
+				)
+			}
+			break
+		}
+
 		/**
 		 * Git Worktree Management
 		 */
diff --git a/src/utils/__tests__/task-storage-size.spec.ts b/src/utils/__tests__/task-storage-size.spec.ts
new file mode 100644
index 00000000000..f2ae2ad98f6
--- /dev/null
+++ b/src/utils/__tests__/task-storage-size.spec.ts
@@ -0,0 +1,237 @@
+import * as path from "path"
+import { calculateTaskStorageSize, formatBytes } from "../task-storage-size"
+
+// Mock fs/promises
+const mockReaddir = vi.fn()
+const mockStat = vi.fn()
+
+vi.mock("fs/promises", () => ({
+	readdir: (...args: unknown[]) => mockReaddir(...args),
+	stat: (...args: unknown[]) => mockStat(...args),
+}))
+
+describe("formatBytes", () => {
+	it("should format 0 bytes", () => {
+		expect(formatBytes(0)).toBe("0 B")
+	})
+
+	it("should format bytes less than 1 KB", () => {
+		expect(formatBytes(512)).toBe("512 B")
+		expect(formatBytes(1)).toBe("1 B")
+	})
+
+	it("should format kilobytes (0 decimal places)", () => {
+		expect(formatBytes(1024)).toBe("1 KB")
+		expect(formatBytes(2048)).toBe("2 KB")
+		expect(formatBytes(1536)).toBe("2 KB") // Rounds to nearest integer
+		expect(formatBytes(1280)).toBe("1 KB") // Rounds down
+	})
+
+	it("should format megabytes (2 decimal places)", () => {
+		expect(formatBytes(1048576)).toBe("1.00 MB")
+		expect(formatBytes(1572864)).toBe("1.50 MB")
+		expect(formatBytes(10485760)).toBe("10.00 MB")
+	})
+
+	it("should format gigabytes (2 decimal places)", () => {
+		expect(formatBytes(1073741824)).toBe("1.00 GB")
+		expect(formatBytes(2147483648)).toBe("2.00 GB")
+	})
+
+	it("should format terabytes (2 decimal places)", () => {
+		expect(formatBytes(1099511627776)).toBe("1.00 TB")
+	})
+
+	it("should handle decimal precision correctly", () => {
+		expect(formatBytes(1234567)).toBe("1.18 MB")
+		expect(formatBytes(123456789)).toBe("117.74 MB")
+	})
+})
+
+describe("calculateTaskStorageSize", () => {
+	beforeEach(() => {
+		vi.clearAllMocks()
+	})
+
+	it("should return zeros when tasks directory does not exist", async () => {
+		mockReaddir.mockRejectedValue(new Error("ENOENT: no such file or directory"))
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		expect(result).toEqual({
+			totalBytes: 0,
+			taskCount: 0,
+			formattedSize: "0 B",
+		})
+	})
+
+	it("should calculate size of empty tasks directory", async () => {
+		mockReaddir.mockResolvedValue([])
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		expect(result).toEqual({
+			totalBytes: 0,
+			taskCount: 0,
+			formattedSize: "0 B",
+		})
+	})
+
+	it("should count task directories correctly", async () => {
+		// Mock the tasks directory read
+		mockReaddir.mockImplementation((dirPath: string, options?: { withFileTypes: boolean }) => {
+			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
+			if (pathStr.endsWith("tasks")) {
+				// Return task directories
+				return Promise.resolve([
+					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+					{ name: "task-2", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+					{ name: "task-3", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+				])
+			}
+			// Task subdirectories are empty
+			return Promise.resolve([])
+		})
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		expect(result.taskCount).toBe(3)
+	})
+
+	it("should calculate total size including files", async () => {
+		// Mock the tasks directory read
+		mockReaddir.mockImplementation((dirPath: string) => {
+			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
+			if (pathStr.endsWith("tasks")) {
+				return Promise.resolve([
+					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+				])
+			}
+			if (pathStr.includes("task-1")) {
+				return Promise.resolve([
+					{ name: "file1.txt", isDirectory: () => false, isFile: () => true, isSymbolicLink: () => false },
+					{ name: "file2.json", isDirectory: () => false, isFile: () => true, isSymbolicLink: () => false },
+				])
+			}
+			return Promise.resolve([])
+		})
+
+		mockStat.mockImplementation((filePath: string) => {
+			if (filePath.includes("file1.txt")) {
+				return Promise.resolve({ size: 1024 })
+			}
+			if (filePath.includes("file2.json")) {
+				return Promise.resolve({ size: 2048 })
+			}
+			return Promise.resolve({ size: 0 })
+		})
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		expect(result.totalBytes).toBe(3072)
+		expect(result.formattedSize).toBe("3 KB")
+		expect(result.taskCount).toBe(1)
+	})
+
+	it("should handle nested directories (like checkpoints)", async () => {
+		mockReaddir.mockImplementation((dirPath: string) => {
+			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
+			if (pathStr.endsWith("tasks")) {
+				return Promise.resolve([
+					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+				])
+			}
+			if (pathStr.endsWith("task-1") && !pathStr.includes("checkpoints")) {
+				return Promise.resolve([
+					{
+						name: "api_conversation.json",
+						isDirectory: () => false,
+						isFile: () => true,
+						isSymbolicLink: () => false,
+					},
+					{ name: "checkpoints", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+				])
+			}
+			if (pathStr.includes("checkpoints")) {
+				return Promise.resolve([
+					{
+						name: "checkpoint-1.json",
+						isDirectory: () => false,
+						isFile: () => true,
+						isSymbolicLink: () => false,
+					},
+				])
+			}
+			return Promise.resolve([])
+		})
+
+		mockStat.mockImplementation((filePath: string) => {
+			if (filePath.includes("api_conversation.json")) {
+				return Promise.resolve({ size: 5000 })
+			}
+			if (filePath.includes("checkpoint-1.json")) {
+				return Promise.resolve({ size: 10000 })
+			}
+			return Promise.resolve({ size: 0 })
+		})
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		expect(result.totalBytes).toBe(15000)
+		expect(result.taskCount).toBe(1)
+	})
+
+	it("should handle stat errors gracefully", async () => {
+		mockReaddir.mockImplementation((dirPath: string) => {
+			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
+			if (pathStr.endsWith("tasks")) {
+				return Promise.resolve([
+					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+				])
+			}
+			return Promise.resolve([
+				{ name: "broken-file.txt", isDirectory: () => false, isFile: () => true, isSymbolicLink: () => false },
+			])
+		})
+
+		mockStat.mockRejectedValue(new Error("Permission denied"))
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		// Should still return a result, just with 0 bytes for the failed stat
+		expect(result.taskCount).toBe(1)
+		expect(result.totalBytes).toBe(0)
+	})
+
+	it("should handle mixed files and directories in tasks folder", async () => {
+		mockReaddir.mockImplementation((dirPath: string) => {
+			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
+			if (pathStr.endsWith("tasks")) {
+				return Promise.resolve([
+					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
+					{
+						name: "some-file.txt",
+						isDirectory: () => false,
+						isFile: () => true,
+						isSymbolicLink: () => false,
+					}, // Should not count as task
+				])
+			}
+			return Promise.resolve([])
+		})
+
+		mockStat.mockImplementation((filePath: string) => {
+			if (filePath.includes("some-file.txt")) {
+				return Promise.resolve({ size: 100 })
+			}
+			return Promise.resolve({ size: 0 })
+		})
+
+		const result = await calculateTaskStorageSize("/global/storage")
+
+		// Only directories count as tasks
+		expect(result.taskCount).toBe(1)
+		// But file size should be included
+		expect(result.totalBytes).toBe(100)
+	})
+})
diff --git a/src/utils/task-storage-size.ts b/src/utils/task-storage-size.ts
new file mode 100644
index 00000000000..669b6d733d1
--- /dev/null
+++ b/src/utils/task-storage-size.ts
@@ -0,0 +1,138 @@
+import * as path from "path"
+import * as fs from "fs/promises"
+import type { Dirent, Stats } from "fs"
+
+import { getStorageBasePath } from "./storage"
+
+/**
+ * Result of calculating task history storage size
+ */
+export interface TaskStorageSizeResult {
+	/** Total size in bytes */
+	totalBytes: number
+	/** Number of task directories found */
+	taskCount: number
+	/** Formatted size string (e.g., "12.34 MB") */
+	formattedSize: string
+}
+
+/**
+ * Formats bytes into a human-readable string with appropriate units.
+ * @param bytes Number of bytes
+ * @returns Formatted string (e.g., "12.34 MB", "5.67 GB")
+ */
+export function formatBytes(bytes: number): string {
+	if (bytes === 0) return "0 B"
+
+	const units = ["B", "KB", "MB", "GB", "TB"]
+	const k = 1024
+	const i = Math.min(Math.floor(Math.log(bytes) / Math.log(k)), units.length - 1)
+	const size = bytes / Math.pow(k, i)
+
+	// Use 2 decimal places for MB and above, 0 for B and KB
+	const decimals = i >= 2 ? 2 : 0
+	return `${size.toFixed(decimals)} ${units[i]}`
+}
+
+/**
+ * Recursively calculates the total size of a directory.
+ * @param dirPath Path to the directory
+ * @returns Total size in bytes
+ */
+async function getDirectorySize(dirPath: string, depth: number = 0): Promise<number> {
+	let totalSize = 0
+
+	// Safety check: prevent infinite recursion by limiting depth
+	if (depth > 50) {
+		return 0
+	}
+
+	try {
+		const entries: Dirent[] = await fs.readdir(dirPath, { withFileTypes: true })
+
+		// Process entries in parallel for better performance
+		const sizes = await Promise.all(
+			entries.map(async (entry) => {
+				const entryPath = path.join(dirPath, entry.name)
+
+				try {
+					// Check for symlinks to prevent infinite loops
+					if (entry.isSymbolicLink()) {
+						return 0
+					}
+
+					if (entry.isDirectory()) {
+						return await getDirectorySize(entryPath, depth + 1)
+					} else if (entry.isFile()) {
+						const stat: Stats = await fs.stat(entryPath)
+						return stat.size
+					}
+				} catch {
+					// Ignore errors for individual entries (permission issues, deleted files, etc.)
+				}
+
+				return 0
+			}),
+		)
+
+		totalSize = sizes.reduce((acc, size) => acc + size, 0)
+	} catch {
+		// Directory doesn't exist or can't be read
+	}
+
+	return totalSize
+}
+
+/**
+ * Calculates the total storage size used by task history.
+ * This includes all files in the tasks/ directory (task data, checkpoints, etc.).
+ *
+ * This function is designed to be non-blocking and safe for background execution.
+ * Errors are handled gracefully and will return 0 bytes if the directory doesn't exist
+ * or can't be read.
+ *
+ * @param globalStoragePath VS Code global storage fsPath (context.globalStorageUri.fsPath)
+ * @param log Optional logger function for debugging
+ * @returns TaskStorageSizeResult with size info
+ */
+export async function calculateTaskStorageSize(
+	globalStoragePath: string,
+	log?: (message: string) => void,
+): Promise<TaskStorageSizeResult> {
+	const defaultResult: TaskStorageSizeResult = {
+		totalBytes: 0,
+		taskCount: 0,
+		formattedSize: "0 B",
+	}
+
+	let basePath: string
+
+	try {
+		basePath = await getStorageBasePath(globalStoragePath)
+	} catch (e) {
+		log?.(`[TaskStorageSize] Failed to resolve storage base path: ${e instanceof Error ? e.message : String(e)}`)
+		return defaultResult
+	}
+
+	const tasksDir = path.join(basePath, "tasks")
+
+	// Count task directories
+	let taskCount = 0
+	try {
+		const entries = await fs.readdir(tasksDir, { withFileTypes: true })
+		taskCount = entries.filter((d) => d.isDirectory()).length
+	} catch {
+		// Tasks directory doesn't exist yet
+		log?.(`[TaskStorageSize] Tasks directory not found at ${tasksDir}`)
+		return defaultResult
+	}
+
+	// Calculate total size
+	const totalBytes = await getDirectorySize(tasksDir)
+
+	return {
+		totalBytes,
+		taskCount,
+		formattedSize: formatBytes(totalBytes),
+	}
+}
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index f86414189c3..77be9d22fbf 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -1,7 +1,19 @@
-import { HTMLAttributes } from "react"
+import { HTMLAttributes, useState, useCallback, useEffect } from "react"
 import { useAppTranslation } from "@/i18n/TranslationContext"
 import { Trans } from "react-i18next"
-import { Download, Upload, TriangleAlert, Bug, Lightbulb, Shield, MessageCircle, MessagesSquare } from "lucide-react"
+import {
+	Download,
+	Upload,
+	TriangleAlert,
+	Bug,
+	Lightbulb,
+	Shield,
+	MessageCircle,
+	MessagesSquare,
+	RefreshCw,
+	HardDrive,
+	Loader2,
+} from "lucide-react"
 import { VSCodeCheckbox, VSCodeLink } from "@vscode/webview-ui-toolkit/react"
 
 import type { TelemetrySetting } from "@roo-code/types"
@@ -16,6 +28,12 @@ import { SectionHeader } from "./SectionHeader"
 import { Section } from "./Section"
 import { SearchableSetting } from "./SearchableSetting"
 
+type TaskHistorySize = {
+	totalBytes: number
+	taskCount: number
+	formattedSize: string
+}
+
 type AboutProps = HTMLAttributes<HTMLDivElement> & {
 	telemetrySetting: TelemetrySetting
 	setTelemetrySetting: (setting: TelemetrySetting) => void
@@ -23,6 +41,7 @@ type AboutProps = HTMLAttributes<HTMLDivElement> & {
 	setDebug?: (debug: boolean) => void
 	taskHistoryRetention: "never" | "90" | "60" | "30" | "7" | "3"
 	setTaskHistoryRetention: (value: "never" | "90" | "60" | "30" | "7" | "3") => void
+	taskHistorySize?: TaskHistorySize
 }
 
 export const About = ({
@@ -32,10 +51,46 @@ export const About = ({
 	setDebug,
 	taskHistoryRetention,
 	setTaskHistoryRetention,
+	taskHistorySize,
 	className,
 	...props
 }: AboutProps) => {
 	const { t } = useAppTranslation()
+	const [isRefreshing, setIsRefreshing] = useState(false)
+	const [cachedSize, setCachedSize] = useState<TaskHistorySize | undefined>(taskHistorySize)
+
+	// Update cached size when taskHistorySize changes and reset refreshing state
+	useEffect(() => {
+		if (taskHistorySize) {
+			setCachedSize(taskHistorySize)
+			setIsRefreshing(false)
+		}
+	}, [taskHistorySize])
+
+	const handleRefreshStorageSize = useCallback(() => {
+		setIsRefreshing(true)
+		vscode.postMessage({ type: "refreshTaskHistorySize" })
+	}, [])
+
+	const getStorageDisplayText = (): string => {
+		// Use cached size if available, otherwise show "Calculating" only if no cached value
+		const displaySize = taskHistorySize || cachedSize
+		if (!displaySize) {
+			return t("settings:taskHistoryStorage.calculating")
+		}
+		if (displaySize.taskCount === 0) {
+			return t("settings:taskHistoryStorage.empty")
+		}
+		if (displaySize.taskCount === 1) {
+			return t("settings:taskHistoryStorage.formatSingular", {
+				size: displaySize.formattedSize,
+			})
+		}
+		return t("settings:taskHistoryStorage.format", {
+			size: displaySize.formattedSize,
+			count: displaySize.taskCount,
+		})
+	}
 
 	return (
 		<div className={cn("flex flex-col gap-2", className)} {...props}>
@@ -173,6 +228,32 @@ export const About = ({
 					</div>
 				</SearchableSetting>
 
+				<SearchableSetting
+					settingId="about-task-history-storage"
+					section="about"
+					label={t("settings:taskHistoryStorage.label")}
+					className="mt-4">
+					<div className="flex items-center gap-2">
+						<HardDrive className="size-4 text-vscode-descriptionForeground shrink-0" />
+						<span className="text-sm">
+							{t("settings:taskHistoryStorage.label")}: {getStorageDisplayText()}
+						</span>
+						<Button
+							variant="ghost"
+							size="sm"
+							onClick={handleRefreshStorageSize}
+							disabled={isRefreshing}
+							className="h-6 w-6 p-0"
+							title={t("settings:taskHistoryStorage.refresh")}>
+							{isRefreshing ? (
+								<Loader2 className="size-3.5 animate-spin" />
+							) : (
+								<RefreshCw className="size-3.5" />
+							)}
+						</Button>
+					</div>
+				</SearchableSetting>
+
 				<SearchableSetting
 					settingId="about-manage-settings"
 					section="about"
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index 1dfa20daf62..47b98c02dff 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -216,6 +216,9 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 		taskHistoryRetention,
 	} = cachedState
 
+	// taskHistorySize is read-only (not a saveable setting) so we use extensionState directly
+	const taskHistorySize = extensionState.taskHistorySize
+
 	const apiConfiguration = useMemo(() => cachedState.apiConfiguration ?? {}, [cachedState.apiConfiguration])
 
 	useEffect(() => {
@@ -561,6 +564,13 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 		scrollToActiveTab()
 	}, [activeTab, scrollToActiveTab])
 
+	// Effect to trigger task history size calculation when About tab is opened
+	useEffect(() => {
+		if (activeTab === "about") {
+			vscode.postMessage({ type: "refreshTaskHistorySize" })
+		}
+	}, [activeTab])
+
 	// Effect to scroll when the webview becomes visible
 	useLayoutEffect(() => {
 		const handleMessage = (event: MessageEvent) => {
@@ -962,6 +972,7 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 								setDebug={setDebug}
 								taskHistoryRetention={normalizedTaskHistoryRetention}
 								setTaskHistoryRetention={(value) => setCachedStateField("taskHistoryRetention", value)}
+								taskHistorySize={taskHistorySize}
 							/>
 						)}
 					</SearchIndexProvider>

From 86f29ec3a6f29e2658b89651ee29a09890fb64b7 Mon Sep 17 00:00:00 2001
From: daniel-lxs <ricciodaniel98@gmail.com>
Date: Mon, 19 Jan 2026 23:00:07 -0500
Subject: [PATCH 16/37] i18n: add taskHistoryStorage translations to all
 locales

---
 webview-ui/src/i18n/locales/ca/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/de/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/es/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/fr/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/hi/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/id/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/it/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/ja/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/ko/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/nl/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/pl/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/pt-BR/settings.json | 9 +++++++++
 webview-ui/src/i18n/locales/ru/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/tr/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/vi/settings.json    | 9 +++++++++
 webview-ui/src/i18n/locales/zh-CN/settings.json | 9 +++++++++
 webview-ui/src/i18n/locales/zh-TW/settings.json | 9 +++++++++
 17 files changed, 153 insertions(+)

diff --git a/webview-ui/src/i18n/locales/ca/settings.json b/webview-ui/src/i18n/locales/ca/settings.json
index c835a6cf6bd..46216a2f1e9 100644
--- a/webview-ui/src/i18n/locales/ca/settings.json
+++ b/webview-ui/src/i18n/locales/ca/settings.json
@@ -909,6 +909,15 @@
 			"3": "3 dies"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Ús d'emmagatzematge",
+		"calculating": "Calculant...",
+		"format": "{{size}} ({{count}} tasques)",
+		"formatSingular": "{{size}} (1 tasca)",
+		"empty": "Cap tasca emmagatzemada",
+		"refresh": "Actualitzar",
+		"error": "No es pot calcular"
+	},
 	"footer": {
 		"feedback": "Si teniu qualsevol pregunta o comentari, no dubteu a obrir un issue a <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unir-vos a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/de/settings.json b/webview-ui/src/i18n/locales/de/settings.json
index 8d21d6b425b..fe841dd5a38 100644
--- a/webview-ui/src/i18n/locales/de/settings.json
+++ b/webview-ui/src/i18n/locales/de/settings.json
@@ -909,6 +909,15 @@
 			"3": "3 Tage"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Speichernutzung",
+		"calculating": "Berechne...",
+		"format": "{{size}} ({{count}} Aufgaben)",
+		"formatSingular": "{{size}} (1 Aufgabe)",
+		"empty": "Keine Aufgaben gespeichert",
+		"refresh": "Aktualisieren",
+		"error": "Berechnung nicht möglich"
+	},
 	"footer": {
 		"feedback": "Wenn du Fragen oder Feedback hast, kannst du gerne ein Issue auf <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> eröffnen oder <redditLink>reddit.com/r/RooCode</redditLink> oder <discordLink>discord.gg/roocode</discordLink> beitreten",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/es/settings.json b/webview-ui/src/i18n/locales/es/settings.json
index 3c8d7638e63..2d8b6e4b659 100644
--- a/webview-ui/src/i18n/locales/es/settings.json
+++ b/webview-ui/src/i18n/locales/es/settings.json
@@ -909,6 +909,15 @@
 			"3": "3 días"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Uso de almacenamiento",
+		"calculating": "Calculando...",
+		"format": "{{size}} ({{count}} tareas)",
+		"formatSingular": "{{size}} (1 tarea)",
+		"empty": "No hay tareas almacenadas",
+		"refresh": "Actualizar",
+		"error": "No se puede calcular"
+	},
 	"footer": {
 		"feedback": "Si tiene alguna pregunta o comentario, no dude en abrir un issue en <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unirse a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/fr/settings.json b/webview-ui/src/i18n/locales/fr/settings.json
index 0234af74b2d..07b7222afdc 100644
--- a/webview-ui/src/i18n/locales/fr/settings.json
+++ b/webview-ui/src/i18n/locales/fr/settings.json
@@ -909,6 +909,15 @@
 			"3": "3 jours"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Utilisation du stockage",
+		"calculating": "Calcul en cours...",
+		"format": "{{size}} ({{count}} tâches)",
+		"formatSingular": "{{size}} (1 tâche)",
+		"empty": "Aucune tâche stockée",
+		"refresh": "Actualiser",
+		"error": "Impossible de calculer"
+	},
 	"footer": {
 		"feedback": "Si vous avez des questions ou des commentaires, n'hésitez pas à ouvrir un problème sur <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> ou à rejoindre <redditLink>reddit.com/r/RooCode</redditLink> ou <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/hi/settings.json b/webview-ui/src/i18n/locales/hi/settings.json
index 950403e8064..c2c162b8177 100644
--- a/webview-ui/src/i18n/locales/hi/settings.json
+++ b/webview-ui/src/i18n/locales/hi/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 दिन"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "स्टोरेज उपयोग",
+		"calculating": "गणना हो रही है...",
+		"format": "{{size}} ({{count}} कार्य)",
+		"formatSingular": "{{size}} (1 कार्य)",
+		"empty": "कोई कार्य संग्रहीत नहीं",
+		"refresh": "रिफ्रेश करें",
+		"error": "गणना करने में असमर्थ"
+	},
 	"footer": {
 		"feedback": "यदि आपके कोई प्रश्न या प्रतिक्रिया है, तो <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> पर एक मुद्दा खोलने या <redditLink>reddit.com/r/RooCode</redditLink> या <discordLink>discord.gg/roocode</discordLink> में शामिल होने में संकोच न करें",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/id/settings.json b/webview-ui/src/i18n/locales/id/settings.json
index eedb8a8c05d..3d753c2f4ac 100644
--- a/webview-ui/src/i18n/locales/id/settings.json
+++ b/webview-ui/src/i18n/locales/id/settings.json
@@ -939,6 +939,15 @@
 			"3": "3 hari"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Penggunaan penyimpanan",
+		"calculating": "Menghitung...",
+		"format": "{{size}} ({{count}} tugas)",
+		"formatSingular": "{{size}} (1 tugas)",
+		"empty": "Tidak ada tugas tersimpan",
+		"refresh": "Segarkan",
+		"error": "Tidak dapat menghitung"
+	},
 	"footer": {
 		"feedback": "Jika kamu punya pertanyaan atau feedback, jangan ragu untuk membuka issue di <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> atau bergabung <redditLink>reddit.com/r/RooCode</redditLink> atau <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/it/settings.json b/webview-ui/src/i18n/locales/it/settings.json
index b037283b317..2b4f5129ee7 100644
--- a/webview-ui/src/i18n/locales/it/settings.json
+++ b/webview-ui/src/i18n/locales/it/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 giorni"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Utilizzo dello spazio di archiviazione",
+		"calculating": "Calcolo in corso...",
+		"format": "{{size}} ({{count}} attività)",
+		"formatSingular": "{{size}} (1 attività)",
+		"empty": "Nessuna attività archiviata",
+		"refresh": "Aggiorna",
+		"error": "Impossibile calcolare"
+	},
 	"footer": {
 		"feedback": "Se hai domande o feedback, sentiti libero di aprire un issue su <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unirti a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/ja/settings.json b/webview-ui/src/i18n/locales/ja/settings.json
index 197a5917251..ba90931b53d 100644
--- a/webview-ui/src/i18n/locales/ja/settings.json
+++ b/webview-ui/src/i18n/locales/ja/settings.json
@@ -910,6 +910,15 @@
 			"3": "3日"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "ストレージ使用量",
+		"calculating": "計算中...",
+		"format": "{{size}} ({{count}} タスク)",
+		"formatSingular": "{{size}} (1 タスク)",
+		"empty": "保存されたタスクがありません",
+		"refresh": "更新",
+		"error": "計算できません"
+	},
 	"footer": {
 		"feedback": "質問やフィードバックがある場合は、<githubLink>github.com/RooCodeInc/Roo-Code</githubLink>で問題を開くか、<redditLink>reddit.com/r/RooCode</redditLink>や<discordLink>discord.gg/roocode</discordLink>に参加してください",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/ko/settings.json b/webview-ui/src/i18n/locales/ko/settings.json
index f07f5788927..c3c7490b979 100644
--- a/webview-ui/src/i18n/locales/ko/settings.json
+++ b/webview-ui/src/i18n/locales/ko/settings.json
@@ -910,6 +910,15 @@
 			"3": "3일"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "저장소 사용량",
+		"calculating": "계산 중...",
+		"format": "{{size}} ({{count}}개 작업)",
+		"formatSingular": "{{size}} (1개 작업)",
+		"empty": "저장된 작업 없음",
+		"refresh": "새로고침",
+		"error": "계산할 수 없음"
+	},
 	"footer": {
 		"feedback": "질문이나 피드백이 있으시면 <githubLink>github.com/RooCodeInc/Roo-Code</githubLink>에서 이슈를 열거나 <redditLink>reddit.com/r/RooCode</redditLink> 또는 <discordLink>discord.gg/roocode</discordLink>에 가입하세요",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/nl/settings.json b/webview-ui/src/i18n/locales/nl/settings.json
index 974e6e9a041..8eebef23905 100644
--- a/webview-ui/src/i18n/locales/nl/settings.json
+++ b/webview-ui/src/i18n/locales/nl/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 dagen"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Opslaggebruik",
+		"calculating": "Berekenen...",
+		"format": "{{size}} ({{count}} taken)",
+		"formatSingular": "{{size}} (1 taak)",
+		"empty": "Geen opgeslagen taken",
+		"refresh": "Vernieuwen",
+		"error": "Kan niet berekenen"
+	},
 	"footer": {
 		"feedback": "Heb je vragen of feedback? Open gerust een issue op <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> of sluit je aan bij <redditLink>reddit.com/r/RooCode</redditLink> of <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/pl/settings.json b/webview-ui/src/i18n/locales/pl/settings.json
index ad2260844f9..9b4ca5d4292 100644
--- a/webview-ui/src/i18n/locales/pl/settings.json
+++ b/webview-ui/src/i18n/locales/pl/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 dni"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Wykorzystanie pamięci",
+		"calculating": "Obliczanie...",
+		"format": "{{size}} ({{count}} zadań)",
+		"formatSingular": "{{size}} (1 zadanie)",
+		"empty": "Brak zapisanych zadań",
+		"refresh": "Odśwież",
+		"error": "Nie można obliczyć"
+	},
 	"footer": {
 		"feedback": "Jeśli masz jakiekolwiek pytania lub opinie, śmiało otwórz zgłoszenie na <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> lub dołącz do <redditLink>reddit.com/r/RooCode</redditLink> lub <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/pt-BR/settings.json b/webview-ui/src/i18n/locales/pt-BR/settings.json
index e924d329591..af7a27112c0 100644
--- a/webview-ui/src/i18n/locales/pt-BR/settings.json
+++ b/webview-ui/src/i18n/locales/pt-BR/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 dias"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Uso de armazenamento",
+		"calculating": "Calculando...",
+		"format": "{{size}} ({{count}} tarefas)",
+		"formatSingular": "{{size}} (1 tarefa)",
+		"empty": "Nenhuma tarefa armazenada",
+		"refresh": "Atualizar",
+		"error": "Não foi possível calcular"
+	},
 	"footer": {
 		"feedback": "Se tiver alguma dúvida ou feedback, sinta-se à vontade para abrir um problema em <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> ou juntar-se a <redditLink>reddit.com/r/RooCode</redditLink> ou <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/ru/settings.json b/webview-ui/src/i18n/locales/ru/settings.json
index b34fa8ea525..f6b471876b3 100644
--- a/webview-ui/src/i18n/locales/ru/settings.json
+++ b/webview-ui/src/i18n/locales/ru/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 дня"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Использование хранилища",
+		"calculating": "Подсчет...",
+		"format": "{{size}} ({{count}} задач)",
+		"formatSingular": "{{size}} (1 задача)",
+		"empty": "Нет сохраненных задач",
+		"refresh": "Обновить",
+		"error": "Невозможно подсчитать"
+	},
 	"footer": {
 		"feedback": "Если у вас есть вопросы или предложения, откройте issue на <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> или присоединяйтесь к <redditLink>reddit.com/r/RooCode</redditLink> или <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/tr/settings.json b/webview-ui/src/i18n/locales/tr/settings.json
index c1bbb3f6130..63d97b554fd 100644
--- a/webview-ui/src/i18n/locales/tr/settings.json
+++ b/webview-ui/src/i18n/locales/tr/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 gün"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Depolama kullanımı",
+		"calculating": "Hesaplanıyor...",
+		"format": "{{size}} ({{count}} görev)",
+		"formatSingular": "{{size}} (1 görev)",
+		"empty": "Depolanmış görev yok",
+		"refresh": "Yenile",
+		"error": "Hesaplanamıyor"
+	},
 	"footer": {
 		"feedback": "Herhangi bir sorunuz veya geri bildiriminiz varsa, <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> adresinde bir konu açmaktan veya <redditLink>reddit.com/r/RooCode</redditLink> ya da <discordLink>discord.gg/roocode</discordLink>'a katılmaktan çekinmeyin",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/vi/settings.json b/webview-ui/src/i18n/locales/vi/settings.json
index 7d6a3393777..4ab3fbb3b0e 100644
--- a/webview-ui/src/i18n/locales/vi/settings.json
+++ b/webview-ui/src/i18n/locales/vi/settings.json
@@ -910,6 +910,15 @@
 			"3": "3 ngày"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "Dung lượng lưu trữ",
+		"calculating": "Đang tính toán...",
+		"format": "{{size}} ({{count}} tác vụ)",
+		"formatSingular": "{{size}} (1 tác vụ)",
+		"empty": "Không có tác vụ được lưu trữ",
+		"refresh": "Làm mới",
+		"error": "Không thể tính toán"
+	},
 	"footer": {
 		"feedback": "Nếu bạn có bất kỳ câu hỏi hoặc phản hồi nào, vui lòng mở một vấn đề tại <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> hoặc tham gia <redditLink>reddit.com/r/RooCode</redditLink> hoặc <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/zh-CN/settings.json b/webview-ui/src/i18n/locales/zh-CN/settings.json
index bcfb46ae3fc..7dfa021917e 100644
--- a/webview-ui/src/i18n/locales/zh-CN/settings.json
+++ b/webview-ui/src/i18n/locales/zh-CN/settings.json
@@ -910,6 +910,15 @@
 			"3": "3天"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "存储使用量",
+		"calculating": "计算中...",
+		"format": "{{size}} ({{count}} 个任务)",
+		"formatSingular": "{{size}} (1 个任务)",
+		"empty": "无任务存储",
+		"refresh": "刷新",
+		"error": "无法计算"
+	},
 	"footer": {
 		"feedback": "如果您有任何问题或反馈，请随时在 <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> 上提出问题或加入 <redditLink>reddit.com/r/RooCode</redditLink> 或 <discordLink>discord.gg/roocode</discordLink>",
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/zh-TW/settings.json b/webview-ui/src/i18n/locales/zh-TW/settings.json
index 67b5f750ffd..2c64ae99774 100644
--- a/webview-ui/src/i18n/locales/zh-TW/settings.json
+++ b/webview-ui/src/i18n/locales/zh-TW/settings.json
@@ -918,6 +918,15 @@
 			"3": "3天"
 		}
 	},
+	"taskHistoryStorage": {
+		"label": "儲存空間使用量",
+		"calculating": "計算中...",
+		"format": "{{size}} ({{count}} 個工作)",
+		"formatSingular": "{{size}} (1 個工作)",
+		"empty": "無已儲存工作",
+		"refresh": "重新整理",
+		"error": "無法計算"
+	},
 	"footer": {
 		"telemetry": {
 			"label": "允許匿名錯誤與使用情況回報",

From 33b58beed04741735309dd58ac2cd0a67b031716 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 21:02:50 -0700
Subject: [PATCH 17/37] fix: add background purgeOldTasks call and remove
 duplicate NLS keys

- Add non-blocking background task history purge on extension activation
- Fire-and-forget pattern prevents blocking startup
- Skip purge entirely when retention is 'never' (default)
- Remove duplicate 'settings.taskHistoryRetention.description' keys from all 18 package.nls.*.json files
- Keep consistent 'extension reload' terminology (vs 'plugin reload')
---
 src/extension.ts           | 38 ++++++++++++++++++++++++++++++++++++++
 src/package.nls.ca.json    |  1 -
 src/package.nls.de.json    |  1 -
 src/package.nls.es.json    |  1 -
 src/package.nls.fr.json    |  1 -
 src/package.nls.hi.json    |  1 -
 src/package.nls.id.json    |  1 -
 src/package.nls.it.json    |  1 -
 src/package.nls.ja.json    |  1 -
 src/package.nls.json       |  1 -
 src/package.nls.ko.json    |  1 -
 src/package.nls.nl.json    |  1 -
 src/package.nls.pl.json    |  1 -
 src/package.nls.pt-BR.json |  1 -
 src/package.nls.ru.json    |  1 -
 src/package.nls.tr.json    |  2 --
 src/package.nls.vi.json    |  1 -
 src/package.nls.zh-CN.json |  1 -
 src/package.nls.zh-TW.json |  1 -
 19 files changed, 38 insertions(+), 19 deletions(-)

diff --git a/src/extension.ts b/src/extension.ts
index 07636d2fb65..ae188a0d5fe 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -388,6 +388,44 @@ export async function activate(context: vscode.ExtensionContext) {
 	// Allows other extensions to activate once Roo is ready.
 	vscode.commands.executeCommand(`${Package.name}.activationCompleted`)
 
+	// Task history retention purge (runs in background after activation)
+	// Fire-and-forget to avoid blocking extension startup
+	void (async () => {
+		try {
+			const config = vscode.workspace.getConfiguration(Package.name)
+			const retention = config.get<string>("taskHistoryRetention", "never") ?? "never"
+
+			// Skip if retention is disabled (default)
+			if (retention === "never") {
+				return
+			}
+
+			outputChannel.appendLine(`[Retention] Starting background purge: setting=${retention}`)
+
+			const result = await purgeOldTasks(
+				retention as RetentionSetting,
+				contextProxy.globalStorageUri.fsPath,
+				(m) => outputChannel.appendLine(m),
+				false,
+				async (taskId: string) => {
+					// Reuse the same internal deletion logic as the History view so that
+					// checkpoints, shadow repositories, and task state are cleaned up consistently.
+					await provider.deleteTaskWithId(taskId)
+				},
+			)
+
+			if (result.purgedCount > 0) {
+				outputChannel.appendLine(
+					`[Retention] Background purge complete: purged=${result.purgedCount}, cutoff=${result.cutoff ? new Date(result.cutoff).toISOString() : "none"}`,
+				)
+			}
+		} catch (error) {
+			outputChannel.appendLine(
+				`[Retention] Failed during background purge: ${error instanceof Error ? error.message : String(error)}`,
+			)
+		}
+	})()
+
 	// Implements the `RooCodeAPI` interface.
 	const socketPath = process.env.ROO_CODE_IPC_SOCKET_PATH
 	const enableLogging = typeof socketPath === "string"
diff --git a/src/package.nls.ca.json b/src/package.nls.ca.json
index fd1fa2f2c12..77d625144a7 100644
--- a/src/package.nls.ca.json
+++ b/src/package.nls.ca.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Habilita el Debug Proxy** — Redirigeix totes les sol·licituds de xarxa sortints a través d'un proxy per a debugging MITM. Només està actiu quan s'executa en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ex., `http://127.0.0.1:8888`). Només s'utilitza quan el **Debug Proxy** està habilitat.",
 	"settings.debugProxy.tlsInsecure.description": "Accepta certificats auto-signats del proxy. **Requerit per a la inspecció MITM.** ⚠️ Insegur — utilitza-ho només per a debugging local.",
-	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar el connector.",
 	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar l'extensió."
 }
diff --git a/src/package.nls.de.json b/src/package.nls.de.json
index 1f5d9b07985..ff96f6659eb 100644
--- a/src/package.nls.de.json
+++ b/src/package.nls.de.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Debug-Proxy aktivieren** — Leite alle ausgehenden Netzwerkanfragen über einen Proxy für MITM-Debugging. Nur aktiv, wenn du im Debug-Modus (F5) läufst.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (z. B. `http://127.0.0.1:8888`). Wird nur verwendet, wenn der **Debug-Proxy** aktiviert ist.",
 	"settings.debugProxy.tlsInsecure.description": "Akzeptiere selbstsignierte Zertifikate vom Proxy. **Erforderlich für MITM-Inspektion.** ⚠️ Unsicher – verwende das nur für lokales Debugging.",
-	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Plugin-Neustart ausgeführt.",
 	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Neuladen der Erweiterung ausgeführt."
 }
diff --git a/src/package.nls.es.json b/src/package.nls.es.json
index 1be664dbbbe..38fa197ba40 100644
--- a/src/package.nls.es.json
+++ b/src/package.nls.es.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Activar Debug Proxy** — Redirige todas las solicitudes de red salientes a través de un proxy para depuración MITM. Solo está activo cuando se ejecuta en modo depuración (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ej., `http://127.0.0.1:8888`). Solo se usa cuando **Debug Proxy** está activado.",
 	"settings.debugProxy.tlsInsecure.description": "Aceptar certificados autofirmados del proxy. **Necesario para la inspección MITM.** ⚠️ Inseguro: úsalo solo para depuración local.",
-	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar el plugin.",
 	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar la extensión."
 }
diff --git a/src/package.nls.fr.json b/src/package.nls.fr.json
index 47c0f61f75e..96654a0fed0 100644
--- a/src/package.nls.fr.json
+++ b/src/package.nls.fr.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Activer le Debug Proxy** — Redirige toutes les requêtes réseau sortantes via un proxy pour le debug MITM. Actif uniquement quand tu es en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL du proxy (par ex. `http://127.0.0.1:8888`). Utilisée uniquement quand le **Debug Proxy** est activé.",
 	"settings.debugProxy.tlsInsecure.description": "Accepter les certificats auto-signés du proxy. **Requis pour l'inspection MITM.** ⚠️ Non sécurisé — à utiliser uniquement pour le debug local.",
-	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement du plugin.",
 	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement de l'extension."
 }
diff --git a/src/package.nls.hi.json b/src/package.nls.hi.json
index 2b4350bfd43..857e83d3e2b 100644
--- a/src/package.nls.hi.json
+++ b/src/package.nls.hi.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy सक्षम करो** — सभी आउटबाउंड network requests को MITM debugging के लिए proxy के ज़रिए route करो। सिर्फ तब active रहेगा जब तुम debug mode (F5) में चला रहे हो।",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (जैसे `http://127.0.0.1:8888`)। सिर्फ तब इस्तेमाल होती है जब **Debug Proxy** enabled हो।",
 	"settings.debugProxy.tlsInsecure.description": "Proxy से आने वाले self-signed certificates accept करो। **MITM inspection के लिए ज़रूरी।** ⚠️ Insecure — सिर्फ local debugging के लिए इस्तेमाल करो।",
-	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल प्लगइन रीलोड पर चलता है।",
 	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल एक्सटेंशन रीलोड पर चलता है।"
 }
diff --git a/src/package.nls.id.json b/src/package.nls.id.json
index 5c73affba4e..d7d7073068a 100644
--- a/src/package.nls.id.json
+++ b/src/package.nls.id.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Aktifkan Debug Proxy** — Arahkan semua permintaan jaringan keluar lewat proxy untuk debugging MITM. Hanya aktif saat kamu berjalan dalam mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (mis. `http://127.0.0.1:8888`). Hanya digunakan ketika **Debug Proxy** diaktifkan.",
 	"settings.debugProxy.tlsInsecure.description": "Terima sertifikat self-signed dari proxy. **Diperlukan untuk inspeksi MITM.** ⚠️ Tidak aman — gunakan hanya untuk debugging lokal.",
-	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang plugin.",
 	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang ekstensi."
 }
diff --git a/src/package.nls.it.json b/src/package.nls.it.json
index 25b193cb86e..8e8d9274491 100644
--- a/src/package.nls.it.json
+++ b/src/package.nls.it.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Abilita Debug Proxy** — Instrada tutte le richieste di rete in uscita tramite un proxy per il debugging MITM. Attivo solo quando esegui in modalità debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (ad es. `http://127.0.0.1:8888`). Usato solo quando **Debug Proxy** è abilitato.",
 	"settings.debugProxy.tlsInsecure.description": "Accetta certificati autofirmati dal proxy. **Necessario per l'ispezione MITM.** ⚠️ Non sicuro — usalo solo per il debugging locale.",
-	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento del plugin.",
 	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento dell'estensione."
 }
diff --git a/src/package.nls.ja.json b/src/package.nls.ja.json
index a68ec973c70..3050943b5ae 100644
--- a/src/package.nls.ja.json
+++ b/src/package.nls.ja.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy を有効化** — すべての送信ネットワーク要求を MITM デバッグのためにプロキシ経由でルーティングします。デバッグモード (F5) で実行しているときだけ有効です。",
 	"settings.debugProxy.serverUrl.description": "プロキシ URL（例: `http://127.0.0.1:8888`）。**Debug Proxy** が有効なときにだけ使用されます。",
 	"settings.debugProxy.tlsInsecure.description": "プロキシからの自己署名証明書を許可します。**MITM インスペクションに必須です。** ⚠️ 危険な設定なので、ローカルでのデバッグにだけ使用してください。",
-	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、プラグインの再読み込み時にのみ実行されます。",
 	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、拡張機能の再読み込み時にのみ実行されます。"
 }
diff --git a/src/package.nls.json b/src/package.nls.json
index d28e8525b4b..3df82958ec4 100644
--- a/src/package.nls.json
+++ b/src/package.nls.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Enable Debug Proxy** — Route all outbound network requests through a proxy for MITM debugging. Only active when running in debug mode (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (e.g., `http://127.0.0.1:8888`). Only used when **Debug Proxy** is enabled.",
 	"settings.debugProxy.tlsInsecure.description": "Accept self-signed certificates from the proxy. **Required for MITM inspection.** ⚠️ Insecure — only use for local debugging.",
-	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on plugin reload.",
 	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on extension reload."
 }
diff --git a/src/package.nls.ko.json b/src/package.nls.ko.json
index b942400d820..a4b90526052 100644
--- a/src/package.nls.ko.json
+++ b/src/package.nls.ko.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy 활성화** — 모든 아웃바운드 네트워크 요청을 MITM 디버깅을 위해 프록시를 통해 라우팅합니다. 디버그 모드(F5)로 실행 중일 때만 활성화됩니다.",
 	"settings.debugProxy.serverUrl.description": "프록시 URL(예: `http://127.0.0.1:8888`). **Debug Proxy** 가 활성화된 경우에만 사용됩니다.",
 	"settings.debugProxy.tlsInsecure.description": "프록시의 self-signed 인증서를 허용합니다. **MITM 검사에 필요합니다.** ⚠️ 안전하지 않으므로 로컬 디버깅에만 사용하세요.",
-	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 플러그인 재로드 시에만 실행됩니다.",
 	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 확장 프로그램 재로드 시에만 실행됩니다."
 }
diff --git a/src/package.nls.nl.json b/src/package.nls.nl.json
index 62d03daaf44..19d744ad644 100644
--- a/src/package.nls.nl.json
+++ b/src/package.nls.nl.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy inschakelen** — Leid alle uitgaande netwerkverzoeken via een proxy voor MITM-debugging. Alleen actief wanneer je in debugmodus (F5) draait.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (bijv. `http://127.0.0.1:8888`). Wordt alleen gebruikt wanneer **Debug Proxy** is ingeschakeld.",
 	"settings.debugProxy.tlsInsecure.description": "Accepteer zelfondertekende certificaten van de proxy. **Vereist voor MITM-inspectie.** ⚠️ Onveilig — gebruik dit alleen voor lokale debugging.",
-	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de plugin.",
 	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de extensie."
 }
diff --git a/src/package.nls.pl.json b/src/package.nls.pl.json
index 0811a204898..6556259231f 100644
--- a/src/package.nls.pl.json
+++ b/src/package.nls.pl.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Włącz Debug Proxy** — Kieruj wszystkie wychodzące żądania sieciowe przez proxy na potrzeby debugowania MITM. Aktywne tylko wtedy, gdy uruchamiasz w trybie debugowania (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (np. `http://127.0.0.1:8888`). Używany tylko wtedy, gdy **Debug Proxy** jest włączony.",
 	"settings.debugProxy.tlsInsecure.description": "Akceptuj certyfikaty self-signed z proxy. **Wymagane do inspekcji MITM.** ⚠️ Niezabezpieczone — używaj tylko do lokalnego debugowania.",
-	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu wtyczki.",
 	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu rozszerzenia."
 }
diff --git a/src/package.nls.pt-BR.json b/src/package.nls.pt-BR.json
index 2cf8d2f8d98..3e96de94715 100644
--- a/src/package.nls.pt-BR.json
+++ b/src/package.nls.pt-BR.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Ativar Debug Proxy** — Redireciona todas as solicitações de rede de saída por meio de um proxy para depuração MITM. Só fica ativo quando você está executando em modo de depuração (F5).",
 	"settings.debugProxy.serverUrl.description": "URL do proxy (por exemplo, `http://127.0.0.1:8888`). Só é usada quando o **Debug Proxy** está ativado.",
 	"settings.debugProxy.tlsInsecure.description": "Aceitar certificados self-signed do proxy. **Necessário para inspeção MITM.** ⚠️ Inseguro — use apenas para depuração local.",
-	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar o plugin.",
 	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar a extensão."
 }
diff --git a/src/package.nls.ru.json b/src/package.nls.ru.json
index 474427bf709..b202a512c58 100644
--- a/src/package.nls.ru.json
+++ b/src/package.nls.ru.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Включить Debug Proxy** — направлять все исходящие сетевые запросы через прокси для MITM-отладки. Активен только когда ты запускаешь расширение в режиме отладки (F5).",
 	"settings.debugProxy.serverUrl.description": "URL прокси (например, `http://127.0.0.1:8888`). Используется только если **Debug Proxy** включён.",
 	"settings.debugProxy.tlsInsecure.description": "Принимать self-signed сертификаты от прокси. **Требуется для MITM-инспекции.** ⚠️ Небезопасно — используй только для локальной отладки.",
-	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке плагина.",
 	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке расширения."
 }
diff --git a/src/package.nls.tr.json b/src/package.nls.tr.json
index 09f58c9f7d8..b282f31fb6f 100644
--- a/src/package.nls.tr.json
+++ b/src/package.nls.tr.json
@@ -46,7 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Debug Proxy'yi etkinleştir** — Tüm giden ağ isteklerini MITM hata ayıklaması için bir proxy üzerinden yönlendir. Yalnızca debug modunda (F5) çalıştırırken aktiftir.",
 	"settings.debugProxy.serverUrl.description": "Proxy URL'si (ör. `http://127.0.0.1:8888`). Yalnızca **Debug Proxy** etkin olduğunda kullanılır.",
 	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan.",
-	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca eklenti yeniden yüklendiğinde çalışır.",
-	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreден eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır.",
 	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreden eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır."
 }
diff --git a/src/package.nls.vi.json b/src/package.nls.vi.json
index 2e2460f6b51..dc49f3215db 100644
--- a/src/package.nls.vi.json
+++ b/src/package.nls.vi.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**Bật Debug Proxy** — Chuyển hướng tất cả yêu cầu mạng đi ra qua một proxy để debug MITM. Chỉ hoạt động khi bạn chạy ở chế độ gỡ lỗi (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (vd: `http://127.0.0.1:8888`). Chỉ được dùng khi **Debug Proxy** được bật.",
 	"settings.debugProxy.tlsInsecure.description": "Chấp nhận chứng chỉ self-signed từ proxy. **Bắt buộc cho việc kiểm tra MITM.** ⚠️ Không an toàn — chỉ dùng cho debug cục bộ.",
-	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại plugin.",
 	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại tiện ích mở rộng."
 }
diff --git a/src/package.nls.zh-CN.json b/src/package.nls.zh-CN.json
index 83fb5823494..7cdb497f614 100644
--- a/src/package.nls.zh-CN.json
+++ b/src/package.nls.zh-CN.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**启用 Debug Proxy** — 通过代理转发所有出站网络请求，用于 MITM 调试。只在调试模式 (F5) 运行时生效。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。仅在启用 **Debug Proxy** 时使用。",
 	"settings.debugProxy.tlsInsecure.description": "接受来自代理的 self-signed 证书。**MITM 检查所必需。** ⚠️ 不安全——只在本地调试时使用。",
-	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在插件重新加载时运行。",
 	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在扩展重新加载时运行。"
 }
diff --git a/src/package.nls.zh-TW.json b/src/package.nls.zh-TW.json
index 8d7b8d3dbe1..847d22596ef 100644
--- a/src/package.nls.zh-TW.json
+++ b/src/package.nls.zh-TW.json
@@ -46,6 +46,5 @@
 	"settings.debugProxy.enabled.description": "**啟用 Debug Proxy** — 將所有出站網路要求透過代理進行路由，以進行 MITM 偵錯。只有在除錯模式 (F5) 執行時才會啟用。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。只有在啟用 **Debug Proxy** 時才會使用。",
 	"settings.debugProxy.tlsInsecure.description": "接受來自代理的 self-signed 憑證。**MITM 檢查所必需。** ⚠️ 不安全——只在本機偵錯時使用。",
-	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在外掛程式重新載入時執行。",
 	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在擴充功能重新載入時執行。"
 }

From 523abdb25d28ca1ee581de2f5e2becedbbe073fd Mon Sep 17 00:00:00 2001
From: daniel-lxs <ricciodaniel98@gmail.com>
Date: Mon, 19 Jan 2026 23:16:57 -0500
Subject: [PATCH 18/37] fix: resolve merge conflict, use
 startBackgroundRetentionPurge() for cleaner code

- Resolved merge conflict in extension.ts, keeping extracted function approach
- startBackgroundRetentionPurge() encapsulates all purge logic in task-history-retention.ts
- Added getStorageBasePath mock to task-storage-size tests (addresses roomote review)
---
 src/__tests__/extension.spec.ts               |  4 +-
 src/extension.ts                              | 48 +++----------
 src/utils/__tests__/task-storage-size.spec.ts |  5 ++
 src/utils/task-history-retention.ts           | 71 +++++++++++++++++++
 4 files changed, 89 insertions(+), 39 deletions(-)

diff --git a/src/__tests__/extension.spec.ts b/src/__tests__/extension.spec.ts
index 1d215493116..1803eb4d367 100644
--- a/src/__tests__/extension.spec.ts
+++ b/src/__tests__/extension.spec.ts
@@ -159,9 +159,9 @@ vi.mock("../utils/autoImportSettings", () => ({
 	autoImportSettings: vi.fn().mockResolvedValue(undefined),
 }))
 
-// Avoid filesystem access during activation by stubbing purge
+// Avoid filesystem access during activation by stubbing background purge
 vi.mock("../utils/task-history-retention", () => ({
-	purgeOldTasks: vi.fn().mockResolvedValue({ purgedCount: 0, cutoff: null }),
+	startBackgroundRetentionPurge: vi.fn(),
 }))
 
 // Ensure storage base path resolves to provided path to avoid touching VS Code config
diff --git a/src/extension.ts b/src/extension.ts
index ae188a0d5fe..cff5ea0d467 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -44,7 +44,7 @@ import {
 } from "./activate"
 import { initializeI18n } from "./i18n"
 import { flushModels, initializeModelCacheRefresh, refreshModels } from "./api/providers/fetchers/modelCache"
-import { purgeOldTasks, RetentionSetting } from "./utils/task-history-retention"
+import { startBackgroundRetentionPurge } from "./utils/task-history-retention"
 
 /**
  * Built using https://github.com/microsoft/vscode-webview-ui-toolkit
@@ -389,42 +389,16 @@ export async function activate(context: vscode.ExtensionContext) {
 	vscode.commands.executeCommand(`${Package.name}.activationCompleted`)
 
 	// Task history retention purge (runs in background after activation)
-	// Fire-and-forget to avoid blocking extension startup
-	void (async () => {
-		try {
-			const config = vscode.workspace.getConfiguration(Package.name)
-			const retention = config.get<string>("taskHistoryRetention", "never") ?? "never"
-
-			// Skip if retention is disabled (default)
-			if (retention === "never") {
-				return
-			}
-
-			outputChannel.appendLine(`[Retention] Starting background purge: setting=${retention}`)
-
-			const result = await purgeOldTasks(
-				retention as RetentionSetting,
-				contextProxy.globalStorageUri.fsPath,
-				(m) => outputChannel.appendLine(m),
-				false,
-				async (taskId: string) => {
-					// Reuse the same internal deletion logic as the History view so that
-					// checkpoints, shadow repositories, and task state are cleaned up consistently.
-					await provider.deleteTaskWithId(taskId)
-				},
-			)
-
-			if (result.purgedCount > 0) {
-				outputChannel.appendLine(
-					`[Retention] Background purge complete: purged=${result.purgedCount}, cutoff=${result.cutoff ? new Date(result.cutoff).toISOString() : "none"}`,
-				)
-			}
-		} catch (error) {
-			outputChannel.appendLine(
-				`[Retention] Failed during background purge: ${error instanceof Error ? error.message : String(error)}`,
-			)
-		}
-	})()
+	// By this point, provider is fully initialized and ready to handle deletions
+	startBackgroundRetentionPurge({
+		globalStoragePath: contextProxy.globalStorageUri.fsPath,
+		log: (m) => outputChannel.appendLine(m),
+		deleteTaskById: async (taskId: string) => {
+			// Reuse the same internal deletion logic as the History view so that
+			// checkpoints, shadow repositories, and task state are cleaned up consistently.
+			await provider.deleteTaskWithId(taskId)
+		},
+	})
 
 	// Implements the `RooCodeAPI` interface.
 	const socketPath = process.env.ROO_CODE_IPC_SOCKET_PATH
diff --git a/src/utils/__tests__/task-storage-size.spec.ts b/src/utils/__tests__/task-storage-size.spec.ts
index f2ae2ad98f6..cc7997b146d 100644
--- a/src/utils/__tests__/task-storage-size.spec.ts
+++ b/src/utils/__tests__/task-storage-size.spec.ts
@@ -1,6 +1,11 @@
 import * as path from "path"
 import { calculateTaskStorageSize, formatBytes } from "../task-storage-size"
 
+// Mock storage to avoid VS Code config access during tests
+vi.mock("../storage", () => ({
+	getStorageBasePath: (p: string) => Promise.resolve(p),
+}))
+
 // Mock fs/promises
 const mockReaddir = vi.fn()
 const mockStat = vi.fn()
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 98ce4b8e195..1b132f2174d 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -1,9 +1,11 @@
+import * as vscode from "vscode"
 import * as path from "path"
 import * as fs from "fs/promises"
 import type { Dirent } from "fs"
 
 import { getStorageBasePath } from "./storage"
 import { GlobalFileNames } from "../shared/globalFileNames"
+import { Package } from "../shared/package"
 
 /**
  * Allowed retention day values (as numbers).
@@ -281,3 +283,72 @@ function normalizeDays(value: RetentionSetting): number {
 	const n = typeof value === "number" ? value : parseInt(String(value), 10)
 	return Number.isFinite(n) && n > 0 ? Math.trunc(n) : 0
 }
+
+/**
+ * Options for starting the background retention purge.
+ */
+export interface BackgroundPurgeOptions {
+	/** VS Code global storage fsPath */
+	globalStoragePath: string
+	/** Logger function */
+	log: (message: string) => void
+	/** Function to delete a task by ID (should use ClineProvider.deleteTaskWithId for full cleanup) */
+	deleteTaskById: (taskId: string, taskDirPath: string) => Promise<void>
+}
+
+/**
+ * Starts the task history retention purge in the background.
+ * This function is designed to be called after extension activation completes,
+ * using a fire-and-forget pattern (void) to avoid blocking activation.
+ *
+ * It reads the retention setting from VS Code configuration, executes the purge,
+ * and shows a notification if tasks were deleted.
+ *
+ * @param options Configuration options for the background purge
+ */
+export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions): void {
+	const { globalStoragePath, log, deleteTaskById } = options
+
+	void (async () => {
+		try {
+			const config = vscode.workspace.getConfiguration(Package.name)
+			const retention = config.get<string>("taskHistoryRetention", "never") ?? "never"
+
+			// Skip if retention is disabled
+			if (retention === "never") {
+				log("[Retention] Background purge skipped: retention is set to 'never'")
+				return
+			}
+
+			log(`[Retention] Starting background purge: setting=${retention}`)
+
+			const result = await purgeOldTasks(
+				retention as RetentionSetting,
+				globalStoragePath,
+				log,
+				false,
+				deleteTaskById,
+			)
+
+			log(
+				`[Retention] Background purge complete: purged=${result.purgedCount}, cutoff=${result.cutoff ?? "none"}`,
+			)
+
+			// Show user notification if tasks were deleted
+			if (result.purgedCount > 0) {
+				const message = `Roo Code deleted ${result.purgedCount} task${result.purgedCount === 1 ? "" : "s"} older than ${retention} day${retention === "1" ? "" : "s"}`
+
+				vscode.window.showInformationMessage(message, "View Settings", "Dismiss").then((action) => {
+					if (action === "View Settings") {
+						vscode.commands.executeCommand(
+							"workbench.action.openSettings",
+							"roo-cline.taskHistoryRetention",
+						)
+					}
+				})
+			}
+		} catch (error) {
+			log(`[Retention] Failed during background purge: ${error instanceof Error ? error.message : String(error)}`)
+		}
+	})()
+}

From 7c0ce3ef66fdda18e544704201908d114859778f Mon Sep 17 00:00:00 2001
From: daniel-lxs <ricciodaniel98@gmail.com>
Date: Mon, 19 Jan 2026 23:50:35 -0500
Subject: [PATCH 19/37] fix: handle non-existent workspace repo in checkpoint
 cleanup

- Check if workspace repo directory exists before git operations in deleteTask()
- Reduce log verbosity - only log actual errors, not expected cases
- Add test case for non-existent directory handling
---
 src/core/webview/ClineProvider.ts             |  9 +++----
 .../checkpoints/ShadowCheckpointService.ts    | 15 ++++++-----
 .../__tests__/ShadowCheckpointService.spec.ts | 25 +++++++++++++++++++
 3 files changed, 36 insertions(+), 13 deletions(-)

diff --git a/src/core/webview/ClineProvider.ts b/src/core/webview/ClineProvider.ts
index bbe8d388a77..1567d4864a3 100644
--- a/src/core/webview/ClineProvider.ts
+++ b/src/core/webview/ClineProvider.ts
@@ -1802,8 +1802,8 @@ export class ClineProvider
 				try {
 					await ShadowCheckpointService.deleteTask({ taskId, globalStorageDir, workspaceDir })
 				} catch (error) {
-					console.error(
-						`[deleteTaskWithId${taskId}] failed to delete associated shadow repository or branch: ${error instanceof Error ? error.message : String(error)}`,
+					this.log(
+						`[deleteTaskWithId] failed to delete shadow repository for task ${taskId}: ${error instanceof Error ? error.message : String(error)}`,
 					)
 				}
 
@@ -1811,10 +1811,9 @@ export class ClineProvider
 				try {
 					const dirPath = await getTaskDirectoryPath(globalStoragePath, taskId)
 					await fs.rm(dirPath, { recursive: true, force: true })
-					console.log(`[deleteTaskWithId${taskId}] removed task directory`)
 				} catch (error) {
-					console.error(
-						`[deleteTaskWithId${taskId}] failed to remove task directory: ${error instanceof Error ? error.message : String(error)}`,
+					this.log(
+						`[deleteTaskWithId] failed to remove task directory for task ${taskId}: ${error instanceof Error ? error.message : String(error)}`,
 					)
 				}
 			}
diff --git a/src/services/checkpoints/ShadowCheckpointService.ts b/src/services/checkpoints/ShadowCheckpointService.ts
index fee08b2fa4b..417ba9d8870 100644
--- a/src/services/checkpoints/ShadowCheckpointService.ts
+++ b/src/services/checkpoints/ShadowCheckpointService.ts
@@ -449,22 +449,21 @@ export abstract class ShadowCheckpointService extends EventEmitter {
 		workspaceDir: string
 	}) {
 		const workspaceRepoDir = this.workspaceRepoDir({ globalStorageDir, workspaceDir })
-		const branchName = `roo-${taskId}`
-		const git = createSanitizedGit(workspaceRepoDir)
-		const success = await this.deleteBranch(git, branchName)
 
-		if (success) {
-			console.log(`[${this.name}#deleteTask.${taskId}] deleted branch ${branchName}`)
-		} else {
-			console.error(`[${this.name}#deleteTask.${taskId}] failed to delete branch ${branchName}`)
+		// Check if the workspace repo directory exists before attempting git operations
+		if (!(await fileExistsAtPath(workspaceRepoDir))) {
+			return
 		}
+
+		const branchName = `roo-${taskId}`
+		const git = createSanitizedGit(workspaceRepoDir)
+		await this.deleteBranch(git, branchName)
 	}
 
 	public static async deleteBranch(git: SimpleGit, branchName: string) {
 		const branches = await git.branchLocal()
 
 		if (!branches.all.includes(branchName)) {
-			console.error(`[${this.constructor.name}#deleteBranch] branch ${branchName} does not exist`)
 			return false
 		}
 
diff --git a/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts b/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts
index 07efa4ac2cb..7c531b6d3b6 100644
--- a/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts
+++ b/src/services/checkpoints/__tests__/ShadowCheckpointService.spec.ts
@@ -928,5 +928,30 @@ describe.each([[RepoPerTaskCheckpointService, "RepoPerTaskCheckpointService"]])(
 				}
 			})
 		})
+
+		describe(`${klass.name}#deleteTask`, () => {
+			it("handles non-existent workspace repo directory gracefully", async () => {
+				const nonExistentWorkspaceDir = path.join(tmpDir, `non-existent-workspace-${Date.now()}`)
+				const nonExistentGlobalStorageDir = path.join(tmpDir, `non-existent-storage-${Date.now()}`)
+				const taskIdToDelete = "non-existent-task"
+
+				// Verify the workspace repo directory doesn't exist
+				const workspaceRepoDir = path.join(
+					nonExistentGlobalStorageDir,
+					"checkpoints",
+					klass.hashWorkspaceDir(nonExistentWorkspaceDir),
+				)
+				expect(await fileExistsAtPath(workspaceRepoDir)).toBe(false)
+
+				// Should not throw when the directory doesn't exist
+				await expect(
+					klass.deleteTask({
+						taskId: taskIdToDelete,
+						globalStorageDir: nonExistentGlobalStorageDir,
+						workspaceDir: nonExistentWorkspaceDir,
+					}),
+				).resolves.not.toThrow()
+			})
+		})
 	},
 )

From 0ba7cdac5802cbda76a5f01254b7110ef87a5125 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 22:14:17 -0700
Subject: [PATCH 20/37] chore: move task history retention to app state

---
 src/core/webview/webviewMessageHandler.ts |  7 ++----
 src/extension.ts                          | 30 ++++++++++++++++-------
 src/package.json                          | 13 ----------
 src/package.nls.ca.json                   |  3 +--
 src/package.nls.de.json                   |  3 +--
 src/package.nls.es.json                   |  3 +--
 src/package.nls.fr.json                   |  3 +--
 src/package.nls.hi.json                   |  3 +--
 src/package.nls.id.json                   |  3 +--
 src/package.nls.it.json                   |  3 +--
 src/package.nls.ja.json                   |  3 +--
 src/package.nls.json                      |  3 +--
 src/package.nls.ko.json                   |  3 +--
 src/package.nls.nl.json                   |  3 +--
 src/package.nls.pl.json                   |  3 +--
 src/package.nls.pt-BR.json                |  3 +--
 src/package.nls.ru.json                   |  3 +--
 src/package.nls.tr.json                   |  3 +--
 src/package.nls.vi.json                   |  3 +--
 src/package.nls.zh-CN.json                |  3 +--
 src/package.nls.zh-TW.json                |  3 +--
 src/utils/task-history-retention.ts       | 28 +++++++--------------
 22 files changed, 50 insertions(+), 82 deletions(-)

diff --git a/src/core/webview/webviewMessageHandler.ts b/src/core/webview/webviewMessageHandler.ts
index 2042ff2fb63..24a9b9e4176 100644
--- a/src/core/webview/webviewMessageHandler.ts
+++ b/src/core/webview/webviewMessageHandler.ts
@@ -597,11 +597,8 @@ export const webviewMessageHandler = async (
 							.getConfiguration(Package.name)
 							.update("deniedCommands", newValue, vscode.ConfigurationTarget.Global)
 					} else if (key === "taskHistoryRetention") {
-						const val = ((value ?? "never") as string).toString()
-						newValue = val
-						await vscode.workspace
-							.getConfiguration(Package.name)
-							.update("taskHistoryRetention", val, vscode.ConfigurationTarget.Global)
+						// taskHistoryRetention is stored in Roo application state, not VS Code settings
+						newValue = ((value ?? "never") as string).toString()
 					} else if (key === "ttsEnabled") {
 						newValue = value ?? true
 						setTtsEnabled(newValue as boolean)
diff --git a/src/extension.ts b/src/extension.ts
index cff5ea0d467..11e3e702e73 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -390,15 +390,27 @@ export async function activate(context: vscode.ExtensionContext) {
 
 	// Task history retention purge (runs in background after activation)
 	// By this point, provider is fully initialized and ready to handle deletions
-	startBackgroundRetentionPurge({
-		globalStoragePath: contextProxy.globalStorageUri.fsPath,
-		log: (m) => outputChannel.appendLine(m),
-		deleteTaskById: async (taskId: string) => {
-			// Reuse the same internal deletion logic as the History view so that
-			// checkpoints, shadow repositories, and task state are cleaned up consistently.
-			await provider.deleteTaskWithId(taskId)
-		},
-	})
+	{
+		const retentionValue = contextProxy.getValue("taskHistoryRetention")
+		const retention =
+			retentionValue === "90" ||
+			retentionValue === "60" ||
+			retentionValue === "30" ||
+			retentionValue === "7" ||
+			retentionValue === "3"
+				? retentionValue
+				: "never"
+		startBackgroundRetentionPurge({
+			globalStoragePath: contextProxy.globalStorageUri.fsPath,
+			log: (m) => outputChannel.appendLine(m),
+			deleteTaskById: async (taskId: string) => {
+				// Reuse the same internal deletion logic as the History view so that
+				// checkpoints, shadow repositories, and task state are cleaned up consistently.
+				await provider.deleteTaskWithId(taskId)
+			},
+			retention,
+		})
+	}
 
 	// Implements the `RooCodeAPI` interface.
 	const socketPath = process.env.ROO_CODE_IPC_SOCKET_PATH
diff --git a/src/package.json b/src/package.json
index 7e4a8c21644..e5ade27ed3d 100644
--- a/src/package.json
+++ b/src/package.json
@@ -429,19 +429,6 @@
 					"default": false,
 					"description": "%settings.debugProxy.tlsInsecure.description%",
 					"markdownDescription": "%settings.debugProxy.tlsInsecure.description%"
-				},
-				"roo-cline.taskHistoryRetention": {
-					"type": "string",
-					"enum": [
-						"never",
-						"90",
-						"60",
-						"30",
-						"7",
-						"3"
-					],
-					"default": "never",
-					"description": "%settings.taskHistoryRetention.description%"
 				}
 			}
 		}
diff --git a/src/package.nls.ca.json b/src/package.nls.ca.json
index 77d625144a7..2781ed169cf 100644
--- a/src/package.nls.ca.json
+++ b/src/package.nls.ca.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Activa el mode de depuració per mostrar botons addicionals per veure l'historial de conversa de l'API i els missatges de la interfície d'usuari com a JSON embellert en fitxers temporals.",
 	"settings.debugProxy.enabled.description": "**Habilita el Debug Proxy** — Redirigeix totes les sol·licituds de xarxa sortints a través d'un proxy per a debugging MITM. Només està actiu quan s'executa en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ex., `http://127.0.0.1:8888`). Només s'utilitza quan el **Debug Proxy** està habilitat.",
-	"settings.debugProxy.tlsInsecure.description": "Accepta certificats auto-signats del proxy. **Requerit per a la inspecció MITM.** ⚠️ Insegur — utilitza-ho només per a debugging local.",
-	"settings.taskHistoryRetention.description": "Eliminar automàticament l'historial de tasques en recarregar l'extensió. Elimina les tasques més antigues que el període seleccionat. Opcions: Mai (per defecte), 90 dies, 60 dies, 30 dies, 7 dies o 3 dies. Advertència: Això no es pot desfer i només s'executa en recarregar l'extensió."
+	"settings.debugProxy.tlsInsecure.description": "Accepta certificats auto-signats del proxy. **Requerit per a la inspecció MITM.** ⚠️ Insegur — utilitza-ho només per a debugging local."
 }
diff --git a/src/package.nls.de.json b/src/package.nls.de.json
index ff96f6659eb..a77a253ef06 100644
--- a/src/package.nls.de.json
+++ b/src/package.nls.de.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Aktiviere den Debug-Modus, um zusätzliche Schaltflächen zum Anzeigen des API-Konversationsverlaufs und der UI-Nachrichten als formatiertes JSON in temporären Dateien anzuzeigen.",
 	"settings.debugProxy.enabled.description": "**Debug-Proxy aktivieren** — Leite alle ausgehenden Netzwerkanfragen über einen Proxy für MITM-Debugging. Nur aktiv, wenn du im Debug-Modus (F5) läufst.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (z. B. `http://127.0.0.1:8888`). Wird nur verwendet, wenn der **Debug-Proxy** aktiviert ist.",
-	"settings.debugProxy.tlsInsecure.description": "Akzeptiere selbstsignierte Zertifikate vom Proxy. **Erforderlich für MITM-Inspektion.** ⚠️ Unsicher – verwende das nur für lokales Debugging.",
-	"settings.taskHistoryRetention.description": "Aufgabenverlauf beim Neuladen der Erweiterung automatisch löschen. Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind. Optionen: Niemals (Standard), 90 Tage, 60 Tage, 30 Tage, 7 Tage oder 3 Tage. Warnung: Dies kann nicht rückgängig gemacht werden und wird nur beim Neuladen der Erweiterung ausgeführt."
+	"settings.debugProxy.tlsInsecure.description": "Akzeptiere selbstsignierte Zertifikate vom Proxy. **Erforderlich für MITM-Inspektion.** ⚠️ Unsicher – verwende das nur für lokales Debugging."
 }
diff --git a/src/package.nls.es.json b/src/package.nls.es.json
index 38fa197ba40..a1c729080e2 100644
--- a/src/package.nls.es.json
+++ b/src/package.nls.es.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Activa el modo de depuración para mostrar botones adicionales para ver el historial de conversación de API y los mensajes de la interfaz de usuario como JSON embellecido en archivos temporales.",
 	"settings.debugProxy.enabled.description": "**Activar Debug Proxy** — Redirige todas las solicitudes de red salientes a través de un proxy para depuración MITM. Solo está activo cuando se ejecuta en modo depuración (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (p. ej., `http://127.0.0.1:8888`). Solo se usa cuando **Debug Proxy** está activado.",
-	"settings.debugProxy.tlsInsecure.description": "Aceptar certificados autofirmados del proxy. **Necesario para la inspección MITM.** ⚠️ Inseguro: úsalo solo para depuración local.",
-	"settings.taskHistoryRetention.description": "Eliminar automáticamente el historial de tareas al recargar la extensión. Elimina tareas más antiguas que el período seleccionado. Opciones: Nunca (predeterminado), 90 días, 60 días, 30 días, 7 días o 3 días. Advertencia: Esto no se puede deshacer y solo se ejecuta al recargar la extensión."
+	"settings.debugProxy.tlsInsecure.description": "Aceptar certificados autofirmados del proxy. **Necesario para la inspección MITM.** ⚠️ Inseguro: úsalo solo para depuración local."
 }
diff --git a/src/package.nls.fr.json b/src/package.nls.fr.json
index 96654a0fed0..2d009c0038d 100644
--- a/src/package.nls.fr.json
+++ b/src/package.nls.fr.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Active le mode debug pour afficher des boutons supplémentaires permettant de visualiser l'historique de conversation de l'API et les messages de l'interface utilisateur sous forme de JSON formaté dans des fichiers temporaires.",
 	"settings.debugProxy.enabled.description": "**Activer le Debug Proxy** — Redirige toutes les requêtes réseau sortantes via un proxy pour le debug MITM. Actif uniquement quand tu es en mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL du proxy (par ex. `http://127.0.0.1:8888`). Utilisée uniquement quand le **Debug Proxy** est activé.",
-	"settings.debugProxy.tlsInsecure.description": "Accepter les certificats auto-signés du proxy. **Requis pour l'inspection MITM.** ⚠️ Non sécurisé — à utiliser uniquement pour le debug local.",
-	"settings.taskHistoryRetention.description": "Supprimer automatiquement l'historique des tâches lors du rechargement de l'extension. Supprime les tâches plus anciennes que la période sélectionnée. Options : Jamais (par défaut), 90 jours, 60 jours, 30 jours, 7 jours ou 3 jours. Attention : Cette action ne peut pas être annulée et ne s'exécute qu'au rechargement de l'extension."
+	"settings.debugProxy.tlsInsecure.description": "Accepter les certificats auto-signés du proxy. **Requis pour l'inspection MITM.** ⚠️ Non sécurisé — à utiliser uniquement pour le debug local."
 }
diff --git a/src/package.nls.hi.json b/src/package.nls.hi.json
index 857e83d3e2b..c51f3ee95ee 100644
--- a/src/package.nls.hi.json
+++ b/src/package.nls.hi.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "API conversation history और UI messages को temporary files में prettified JSON के रूप में देखने के लिए अतिरिक्त बटन दिखाने के लिए debug mode सक्षम करें।",
 	"settings.debugProxy.enabled.description": "**Debug Proxy सक्षम करो** — सभी आउटबाउंड network requests को MITM debugging के लिए proxy के ज़रिए route करो। सिर्फ तब active रहेगा जब तुम debug mode (F5) में चला रहे हो।",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (जैसे `http://127.0.0.1:8888`)। सिर्फ तब इस्तेमाल होती है जब **Debug Proxy** enabled हो।",
-	"settings.debugProxy.tlsInsecure.description": "Proxy से आने वाले self-signed certificates accept करो। **MITM inspection के लिए ज़रूरी।** ⚠️ Insecure — सिर्फ local debugging के लिए इस्तेमाल करो।",
-	"settings.taskHistoryRetention.description": "एक्सटेंशन रीलोड पर कार्य इतिहास को स्वचालित रूप से हटाएं। चयनित अवधि से पुराने कार्यों को हटाता है। विकल्प: कभी नहीं (डिफ़ॉल्ट), 90 दिन, 60 दिन, 30 दिन, 7 दिन, या 3 दिन। चेतावनी: इसे पूर्ववत नहीं किया जा सकता और यह केवल एक्सटेंशन रीलोड पर चलता है।"
+	"settings.debugProxy.tlsInsecure.description": "Proxy से आने वाले self-signed certificates accept करो। **MITM inspection के लिए ज़रूरी।** ⚠️ Insecure — सिर्फ local debugging के लिए इस्तेमाल करो।"
 }
diff --git a/src/package.nls.id.json b/src/package.nls.id.json
index d7d7073068a..2a7607f3e7c 100644
--- a/src/package.nls.id.json
+++ b/src/package.nls.id.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Aktifkan mode debug untuk menampilkan tombol tambahan untuk melihat riwayat percakapan API dan pesan UI sebagai JSON yang diformat dalam file sementara.",
 	"settings.debugProxy.enabled.description": "**Aktifkan Debug Proxy** — Arahkan semua permintaan jaringan keluar lewat proxy untuk debugging MITM. Hanya aktif saat kamu berjalan dalam mode debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (mis. `http://127.0.0.1:8888`). Hanya digunakan ketika **Debug Proxy** diaktifkan.",
-	"settings.debugProxy.tlsInsecure.description": "Terima sertifikat self-signed dari proxy. **Diperlukan untuk inspeksi MITM.** ⚠️ Tidak aman — gunakan hanya untuk debugging lokal.",
-	"settings.taskHistoryRetention.description": "Hapus otomatis riwayat tugas saat memuat ulang ekstensi. Menghapus tugas yang lebih lama dari periode yang dipilih. Opsi: Tidak Pernah (default), 90 hari, 60 hari, 30 hari, 7 hari, atau 3 hari. Peringatan: Ini tidak dapat dibatalkan dan hanya berjalan saat memuat ulang ekstensi."
+	"settings.debugProxy.tlsInsecure.description": "Terima sertifikat self-signed dari proxy. **Diperlukan untuk inspeksi MITM.** ⚠️ Tidak aman — gunakan hanya untuk debugging lokal."
 }
diff --git a/src/package.nls.it.json b/src/package.nls.it.json
index 8e8d9274491..c94471355d4 100644
--- a/src/package.nls.it.json
+++ b/src/package.nls.it.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Abilita la modalità debug per mostrare pulsanti aggiuntivi per visualizzare la cronologia delle conversazioni API e i messaggi dell'interfaccia utente come JSON formattato in file temporanei.",
 	"settings.debugProxy.enabled.description": "**Abilita Debug Proxy** — Instrada tutte le richieste di rete in uscita tramite un proxy per il debugging MITM. Attivo solo quando esegui in modalità debug (F5).",
 	"settings.debugProxy.serverUrl.description": "URL del proxy (ad es. `http://127.0.0.1:8888`). Usato solo quando **Debug Proxy** è abilitato.",
-	"settings.debugProxy.tlsInsecure.description": "Accetta certificati autofirmati dal proxy. **Necessario per l'ispezione MITM.** ⚠️ Non sicuro — usalo solo per il debugging locale.",
-	"settings.taskHistoryRetention.description": "Elimina automaticamente la cronologia delle attività al ricaricamento dell'estensione. Elimina le attività più vecchie del periodo selezionato. Opzioni: Mai (predefinito), 90 giorni, 60 giorni, 30 giorni, 7 giorni o 3 giorni. Attenzione: Questa operazione non può essere annullata e viene eseguita solo al ricaricamento dell'estensione."
+	"settings.debugProxy.tlsInsecure.description": "Accetta certificati autofirmati dal proxy. **Necessario per l'ispezione MITM.** ⚠️ Non sicuro — usalo solo per il debugging locale."
 }
diff --git a/src/package.nls.ja.json b/src/package.nls.ja.json
index 3050943b5ae..ff6040d7734 100644
--- a/src/package.nls.ja.json
+++ b/src/package.nls.ja.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "デバッグモードを有効にして、API会話履歴とUIメッセージをフォーマットされたJSONとして一時ファイルで表示するための追加ボタンを表示します。",
 	"settings.debugProxy.enabled.description": "**Debug Proxy を有効化** — すべての送信ネットワーク要求を MITM デバッグのためにプロキシ経由でルーティングします。デバッグモード (F5) で実行しているときだけ有効です。",
 	"settings.debugProxy.serverUrl.description": "プロキシ URL（例: `http://127.0.0.1:8888`）。**Debug Proxy** が有効なときにだけ使用されます。",
-	"settings.debugProxy.tlsInsecure.description": "プロキシからの自己署名証明書を許可します。**MITM インスペクションに必須です。** ⚠️ 危険な設定なので、ローカルでのデバッグにだけ使用してください。",
-	"settings.taskHistoryRetention.description": "拡張機能の再読み込み時にタスク履歴を自動削除します。選択した期間より古いタスクを削除します。オプション：なし（デフォルト）、90日、60日、30日、7日、または3日。警告：この操作は元に戻せず、拡張機能の再読み込み時にのみ実行されます。"
+	"settings.debugProxy.tlsInsecure.description": "プロキシからの自己署名証明書を許可します。**MITM インスペクションに必須です。** ⚠️ 危険な設定なので、ローカルでのデバッグにだけ使用してください。"
 }
diff --git a/src/package.nls.json b/src/package.nls.json
index 3df82958ec4..177b392f775 100644
--- a/src/package.nls.json
+++ b/src/package.nls.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Enable debug mode to show additional buttons for viewing API conversation history and UI messages as prettified JSON in temporary files.",
 	"settings.debugProxy.enabled.description": "**Enable Debug Proxy** — Route all outbound network requests through a proxy for MITM debugging. Only active when running in debug mode (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (e.g., `http://127.0.0.1:8888`). Only used when **Debug Proxy** is enabled.",
-	"settings.debugProxy.tlsInsecure.description": "Accept self-signed certificates from the proxy. **Required for MITM inspection.** ⚠️ Insecure — only use for local debugging.",
-	"settings.taskHistoryRetention.description": "Auto-delete task history on extension reload. Deletes tasks older than the selected period. Options: Never (default), 90 days, 60 days, 30 days, 7 days, or 3 days. Warning: This cannot be undone and only runs on extension reload."
+	"settings.debugProxy.tlsInsecure.description": "Accept self-signed certificates from the proxy. **Required for MITM inspection.** ⚠️ Insecure — only use for local debugging."
 }
diff --git a/src/package.nls.ko.json b/src/package.nls.ko.json
index a4b90526052..f0912835b8b 100644
--- a/src/package.nls.ko.json
+++ b/src/package.nls.ko.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "디버그 모드를 활성화하여 API 대화 기록과 UI 메시지를 임시 파일에 포맷된 JSON으로 보기 위한 추가 버튼을 표시합니다.",
 	"settings.debugProxy.enabled.description": "**Debug Proxy 활성화** — 모든 아웃바운드 네트워크 요청을 MITM 디버깅을 위해 프록시를 통해 라우팅합니다. 디버그 모드(F5)로 실행 중일 때만 활성화됩니다.",
 	"settings.debugProxy.serverUrl.description": "프록시 URL(예: `http://127.0.0.1:8888`). **Debug Proxy** 가 활성화된 경우에만 사용됩니다.",
-	"settings.debugProxy.tlsInsecure.description": "프록시의 self-signed 인증서를 허용합니다. **MITM 검사에 필요합니다.** ⚠️ 안전하지 않으므로 로컬 디버깅에만 사용하세요.",
-	"settings.taskHistoryRetention.description": "확장 프로그램 재로드 시 작업 기록을 자동 삭제합니다. 선택한 기간보다 오래된 작업을 삭제합니다. 옵션: 안 함(기본값), 90일, 60일, 30일, 7일 또는 3일. 경고: 이 작업은 취소할 수 없으며 확장 프로그램 재로드 시에만 실행됩니다."
+	"settings.debugProxy.tlsInsecure.description": "프록시의 self-signed 인증서를 허용합니다. **MITM 검사에 필요합니다.** ⚠️ 안전하지 않으므로 로컬 디버깅에만 사용하세요."
 }
diff --git a/src/package.nls.nl.json b/src/package.nls.nl.json
index 19d744ad644..fef3ca7219c 100644
--- a/src/package.nls.nl.json
+++ b/src/package.nls.nl.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Schakel debug-modus in om extra knoppen te tonen voor het bekijken van API-conversatiegeschiedenis en UI-berichten als opgemaakte JSON in tijdelijke bestanden.",
 	"settings.debugProxy.enabled.description": "**Debug Proxy inschakelen** — Leid alle uitgaande netwerkverzoeken via een proxy voor MITM-debugging. Alleen actief wanneer je in debugmodus (F5) draait.",
 	"settings.debugProxy.serverUrl.description": "Proxy-URL (bijv. `http://127.0.0.1:8888`). Wordt alleen gebruikt wanneer **Debug Proxy** is ingeschakeld.",
-	"settings.debugProxy.tlsInsecure.description": "Accepteer zelfondertekende certificaten van de proxy. **Vereist voor MITM-inspectie.** ⚠️ Onveilig — gebruik dit alleen voor lokale debugging.",
-	"settings.taskHistoryRetention.description": "Taakgeschiedenis automatisch verwijderen bij het herladen van de extensie. Verwijdert taken die ouder zijn dan de geselecteerde periode. Opties: Nooit (standaard), 90 dagen, 60 dagen, 30 dagen, 7 dagen of 3 dagen. Waarschuwing: Dit kan niet ongedaan worden gemaakt en wordt alleen uitgevoerd bij het herladen van de extensie."
+	"settings.debugProxy.tlsInsecure.description": "Accepteer zelfondertekende certificaten van de proxy. **Vereist voor MITM-inspectie.** ⚠️ Onveilig — gebruik dit alleen voor lokale debugging."
 }
diff --git a/src/package.nls.pl.json b/src/package.nls.pl.json
index 6556259231f..8c1f66450d1 100644
--- a/src/package.nls.pl.json
+++ b/src/package.nls.pl.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Włącz tryb debugowania, aby wyświetlić dodatkowe przyciski do przeglądania historii rozmów API i komunikatów interfejsu użytkownika jako sformatowany JSON w plikach tymczasowych.",
 	"settings.debugProxy.enabled.description": "**Włącz Debug Proxy** — Kieruj wszystkie wychodzące żądania sieciowe przez proxy na potrzeby debugowania MITM. Aktywne tylko wtedy, gdy uruchamiasz w trybie debugowania (F5).",
 	"settings.debugProxy.serverUrl.description": "URL proxy (np. `http://127.0.0.1:8888`). Używany tylko wtedy, gdy **Debug Proxy** jest włączony.",
-	"settings.debugProxy.tlsInsecure.description": "Akceptuj certyfikaty self-signed z proxy. **Wymagane do inspekcji MITM.** ⚠️ Niezabezpieczone — używaj tylko do lokalnego debugowania.",
-	"settings.taskHistoryRetention.description": "Automatyczne usuwanie historii zadań przy przeładowaniu rozszerzenia. Usuwa zadania starsze niż wybrany okres. Opcje: Nigdy (domyślnie), 90 dni, 60 dni, 30 dni, 7 dni lub 3 dni. Ostrzeżenie: Tej operacji nie można cofnąć i jest wykonywana tylko przy przeładowaniu rozszerzenia."
+	"settings.debugProxy.tlsInsecure.description": "Akceptuj certyfikaty self-signed z proxy. **Wymagane do inspekcji MITM.** ⚠️ Niezabezpieczone — używaj tylko do lokalnego debugowania."
 }
diff --git a/src/package.nls.pt-BR.json b/src/package.nls.pt-BR.json
index 3e96de94715..84cbf42c097 100644
--- a/src/package.nls.pt-BR.json
+++ b/src/package.nls.pt-BR.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Ativa o modo de depuração para mostrar botões adicionais para visualizar o histórico de conversas da API e mensagens da interface como JSON formatado em arquivos temporários.",
 	"settings.debugProxy.enabled.description": "**Ativar Debug Proxy** — Redireciona todas as solicitações de rede de saída por meio de um proxy para depuração MITM. Só fica ativo quando você está executando em modo de depuração (F5).",
 	"settings.debugProxy.serverUrl.description": "URL do proxy (por exemplo, `http://127.0.0.1:8888`). Só é usada quando o **Debug Proxy** está ativado.",
-	"settings.debugProxy.tlsInsecure.description": "Aceitar certificados self-signed do proxy. **Necessário para inspeção MITM.** ⚠️ Inseguro — use apenas para depuração local.",
-	"settings.taskHistoryRetention.description": "Excluir automaticamente o histórico de tarefas ao recarregar a extensão. Exclui tarefas mais antigas que o período selecionado. Opções: Nunca (padrão), 90 dias, 60 dias, 30 dias, 7 dias ou 3 dias. Aviso: Isso não pode ser desfeito e só é executado ao recarregar a extensão."
+	"settings.debugProxy.tlsInsecure.description": "Aceitar certificados self-signed do proxy. **Necessário para inspeção MITM.** ⚠️ Inseguro — use apenas para depuração local."
 }
diff --git a/src/package.nls.ru.json b/src/package.nls.ru.json
index b202a512c58..be8df040323 100644
--- a/src/package.nls.ru.json
+++ b/src/package.nls.ru.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Включить режим отладки, чтобы отображать дополнительные кнопки для просмотра истории разговоров API и сообщений интерфейса в виде форматированного JSON во временных файлах.",
 	"settings.debugProxy.enabled.description": "**Включить Debug Proxy** — направлять все исходящие сетевые запросы через прокси для MITM-отладки. Активен только когда ты запускаешь расширение в режиме отладки (F5).",
 	"settings.debugProxy.serverUrl.description": "URL прокси (например, `http://127.0.0.1:8888`). Используется только если **Debug Proxy** включён.",
-	"settings.debugProxy.tlsInsecure.description": "Принимать self-signed сертификаты от прокси. **Требуется для MITM-инспекции.** ⚠️ Небезопасно — используй только для локальной отладки.",
-	"settings.taskHistoryRetention.description": "Автоматически удалять историю задач при перезагрузке расширения. Удаляет задачи старше выбранного периода. Варианты: Никогда (по умолчанию), 90 дней, 60 дней, 30 дней, 7 дней или 3 дня. Предупреждение: Это действие нельзя отменить, и оно выполняется только при перезагрузке расширения."
+	"settings.debugProxy.tlsInsecure.description": "Принимать self-signed сертификаты от прокси. **Требуется для MITM-инспекции.** ⚠️ Небезопасно — используй только для локальной отладки."
 }
diff --git a/src/package.nls.tr.json b/src/package.nls.tr.json
index b282f31fb6f..a815188e8aa 100644
--- a/src/package.nls.tr.json
+++ b/src/package.nls.tr.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "API konuşma geçmişini ve kullanıcı arayüzü mesajlarını geçici dosyalarda biçimlendirilmiş JSON olarak görüntülemek için ek düğmeler göstermek üzere hata ayıklama modunu etkinleştir.",
 	"settings.debugProxy.enabled.description": "**Debug Proxy'yi etkinleştir** — Tüm giden ağ isteklerini MITM hata ayıklaması için bir proxy üzerinden yönlendir. Yalnızca debug modunda (F5) çalıştırırken aktiftir.",
 	"settings.debugProxy.serverUrl.description": "Proxy URL'si (ör. `http://127.0.0.1:8888`). Yalnızca **Debug Proxy** etkin olduğunda kullanılır.",
-	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan.",
-	"settings.taskHistoryRetention.description": "Uzantı yeniden yüklendiğinde görev geçmişini otomatik olarak sil. Seçilen süreden eski görevleri siler. Seçenekler: Asla (varsayılan), 90 gün, 60 gün, 30 gün, 7 gün veya 3 gün. Uyarı: Bu işlem geri alınamaz ve yalnızca uzantı yeniden yüklendiğinde çalışır."
+	"settings.debugProxy.tlsInsecure.description": "Proxy'den gelen self-signed sertifikaları kabul et. **MITM incelemesi için gerekli.** ⚠️ Güvensiz — yalnızca lokal debugging için kullan."
 }
diff --git a/src/package.nls.vi.json b/src/package.nls.vi.json
index dc49f3215db..6052080dfa3 100644
--- a/src/package.nls.vi.json
+++ b/src/package.nls.vi.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "Bật chế độ gỡ lỗi để hiển thị các nút bổ sung để xem lịch sử hội thoại API và thông điệp giao diện người dùng dưới dạng JSON được định dạng trong các tệp tạm thời.",
 	"settings.debugProxy.enabled.description": "**Bật Debug Proxy** — Chuyển hướng tất cả yêu cầu mạng đi ra qua một proxy để debug MITM. Chỉ hoạt động khi bạn chạy ở chế độ gỡ lỗi (F5).",
 	"settings.debugProxy.serverUrl.description": "Proxy URL (vd: `http://127.0.0.1:8888`). Chỉ được dùng khi **Debug Proxy** được bật.",
-	"settings.debugProxy.tlsInsecure.description": "Chấp nhận chứng chỉ self-signed từ proxy. **Bắt buộc cho việc kiểm tra MITM.** ⚠️ Không an toàn — chỉ dùng cho debug cục bộ.",
-	"settings.taskHistoryRetention.description": "Tự động xóa lịch sử nhiệm vụ khi tải lại tiện ích mở rộng. Xóa các nhiệm vụ cũ hơn khoảng thời gian đã chọn. Tùy chọn: Không bao giờ (mặc định), 90 ngày, 60 ngày, 30 ngày, 7 ngày hoặc 3 ngày. Cảnh báo: Thao tác này không thể hoàn tác và chỉ chạy khi tải lại tiện ích mở rộng."
+	"settings.debugProxy.tlsInsecure.description": "Chấp nhận chứng chỉ self-signed từ proxy. **Bắt buộc cho việc kiểm tra MITM.** ⚠️ Không an toàn — chỉ dùng cho debug cục bộ."
 }
diff --git a/src/package.nls.zh-CN.json b/src/package.nls.zh-CN.json
index 7cdb497f614..9254d494d9b 100644
--- a/src/package.nls.zh-CN.json
+++ b/src/package.nls.zh-CN.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "启用调试模式以显示额外按钮，用于在临时文件中以格式化 JSON 查看 API 对话历史和 UI 消息。",
 	"settings.debugProxy.enabled.description": "**启用 Debug Proxy** — 通过代理转发所有出站网络请求，用于 MITM 调试。只在调试模式 (F5) 运行时生效。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。仅在启用 **Debug Proxy** 时使用。",
-	"settings.debugProxy.tlsInsecure.description": "接受来自代理的 self-signed 证书。**MITM 检查所必需。** ⚠️ 不安全——只在本地调试时使用。",
-	"settings.taskHistoryRetention.description": "扩展重新加载时自动删除任务历史。删除早于所选时间段的任务。选项：从不（默认）、90天、60天、30天、7天或3天。警告：此操作不可逆，仅在扩展重新加载时运行。"
+	"settings.debugProxy.tlsInsecure.description": "接受来自代理的 self-signed 证书。**MITM 检查所必需。** ⚠️ 不安全——只在本地调试时使用。"
 }
diff --git a/src/package.nls.zh-TW.json b/src/package.nls.zh-TW.json
index 847d22596ef..a8030d69141 100644
--- a/src/package.nls.zh-TW.json
+++ b/src/package.nls.zh-TW.json
@@ -45,6 +45,5 @@
 	"settings.debug.description": "啟用偵錯模式以顯示額外按鈕，用於在暫存檔案中以格式化 JSON 檢視 API 對話歷史紀錄和使用者介面訊息。",
 	"settings.debugProxy.enabled.description": "**啟用 Debug Proxy** — 將所有出站網路要求透過代理進行路由，以進行 MITM 偵錯。只有在除錯模式 (F5) 執行時才會啟用。",
 	"settings.debugProxy.serverUrl.description": "代理 URL（例如 `http://127.0.0.1:8888`）。只有在啟用 **Debug Proxy** 時才會使用。",
-	"settings.debugProxy.tlsInsecure.description": "接受來自代理的 self-signed 憑證。**MITM 檢查所必需。** ⚠️ 不安全——只在本機偵錯時使用。",
-	"settings.taskHistoryRetention.description": "擴充功能重新載入時自動刪除工作歷程記錄。刪除早於所選時間段的工作。選項：永不（預設）、90天、60天、30天、7天或3天。警告：此操作無法復原，且僅在擴充功能重新載入時執行。"
+	"settings.debugProxy.tlsInsecure.description": "接受來自代理的 self-signed 憑證。**MITM 檢查所必需。** ⚠️ 不安全——只在本機偵錯時使用。"
 }
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 1b132f2174d..e7a7157f3e3 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -5,7 +5,6 @@ import type { Dirent } from "fs"
 
 import { getStorageBasePath } from "./storage"
 import { GlobalFileNames } from "../shared/globalFileNames"
-import { Package } from "../shared/package"
 
 /**
  * Allowed retention day values (as numbers).
@@ -294,6 +293,8 @@ export interface BackgroundPurgeOptions {
 	log: (message: string) => void
 	/** Function to delete a task by ID (should use ClineProvider.deleteTaskWithId for full cleanup) */
 	deleteTaskById: (taskId: string, taskDirPath: string) => Promise<void>
+	/** Retention setting value from Roo application state */
+	retention: RetentionSetting
 }
 
 /**
@@ -301,34 +302,25 @@ export interface BackgroundPurgeOptions {
  * This function is designed to be called after extension activation completes,
  * using a fire-and-forget pattern (void) to avoid blocking activation.
  *
- * It reads the retention setting from VS Code configuration, executes the purge,
+ * It reads the retention setting from Roo application state, executes the purge,
  * and shows a notification if tasks were deleted.
  *
  * @param options Configuration options for the background purge
  */
 export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions): void {
-	const { globalStoragePath, log, deleteTaskById } = options
+	const { globalStoragePath, log, deleteTaskById, retention } = options
 
 	void (async () => {
 		try {
-			const config = vscode.workspace.getConfiguration(Package.name)
-			const retention = config.get<string>("taskHistoryRetention", "never") ?? "never"
-
 			// Skip if retention is disabled
-			if (retention === "never") {
+			if (retention === "never" || retention === "0" || retention === 0) {
 				log("[Retention] Background purge skipped: retention is set to 'never'")
 				return
 			}
 
 			log(`[Retention] Starting background purge: setting=${retention}`)
 
-			const result = await purgeOldTasks(
-				retention as RetentionSetting,
-				globalStoragePath,
-				log,
-				false,
-				deleteTaskById,
-			)
+			const result = await purgeOldTasks(retention, globalStoragePath, log, false, deleteTaskById)
 
 			log(
 				`[Retention] Background purge complete: purged=${result.purgedCount}, cutoff=${result.cutoff ?? "none"}`,
@@ -336,14 +328,12 @@ export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions):
 
 			// Show user notification if tasks were deleted
 			if (result.purgedCount > 0) {
-				const message = `Roo Code deleted ${result.purgedCount} task${result.purgedCount === 1 ? "" : "s"} older than ${retention} day${retention === "1" ? "" : "s"}`
+				const message = `Roo Code deleted ${result.purgedCount} task${result.purgedCount === 1 ? "" : "s"} older than ${retention} days`
 
 				vscode.window.showInformationMessage(message, "View Settings", "Dismiss").then((action) => {
 					if (action === "View Settings") {
-						vscode.commands.executeCommand(
-							"workbench.action.openSettings",
-							"roo-cline.taskHistoryRetention",
-						)
+						// Navigate to Roo Code settings About tab
+						vscode.commands.executeCommand("roo-cline.settingsButtonClicked")
 					}
 				})
 			}

From bf483c92765e3afe924a0fd7c68cc285d9f913f8 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 22:35:17 -0700
Subject: [PATCH 21/37] fix: address mrubens review feedback for task history
 retention

---
 packages/types/src/global-settings.ts         | 13 ++++++++++--
 src/core/webview/webviewMessageHandler.ts     |  2 +-
 src/i18n/locales/en/common.json               |  8 ++++++++
 src/utils/formatBytes.ts                      | 18 +++++++++++++++++
 src/utils/task-history-retention.ts           | 13 +++++++++---
 src/utils/task-storage-size.ts                | 20 +++----------------
 webview-ui/src/components/settings/About.tsx  |  8 ++++----
 .../src/components/settings/SettingsView.tsx  | 17 +++++++---------
 8 files changed, 62 insertions(+), 37 deletions(-)
 create mode 100644 src/utils/formatBytes.ts

diff --git a/packages/types/src/global-settings.ts b/packages/types/src/global-settings.ts
index 681324fe7a8..f9b92857ff3 100644
--- a/packages/types/src/global-settings.ts
+++ b/packages/types/src/global-settings.ts
@@ -44,6 +44,14 @@ export const MAX_CHECKPOINT_TIMEOUT_SECONDS = 60
  */
 export const DEFAULT_CHECKPOINT_TIMEOUT_SECONDS = 15
 
+/**
+ * Allowed values for the task history retention setting.
+ * Stored as strings in most UI/extension flows.
+ */
+export const TASK_HISTORY_RETENTION_OPTIONS = ["never", "90", "60", "30", "7", "3"] as const
+
+export type TaskHistoryRetentionSetting = (typeof TASK_HISTORY_RETENTION_OPTIONS)[number]
+
 /**
  * GlobalSettings
  */
@@ -181,8 +189,9 @@ export const globalSettingsSchema = z.object({
 	customSupportPrompts: customSupportPromptsSchema.optional(),
 	enhancementApiConfigId: z.string().optional(),
 	includeTaskHistoryInEnhance: z.boolean().optional(),
-	// Auto-delete task history on extension reload. "never" | "90" | "60" | "30" | "7" | "3"
-	taskHistoryRetention: z.union([z.enum(["never", "90", "60", "30", "7", "3"]), z.number()]).optional(),
+	// Auto-delete task history on extension reload.
+	// Note: we accept `number` for backwards compatibility with older persisted state.
+	taskHistoryRetention: z.union([z.enum(TASK_HISTORY_RETENTION_OPTIONS), z.number()]).optional(),
 	// Calculated task history storage size info for the Settings > About page
 	taskHistorySize: z
 		.object({
diff --git a/src/core/webview/webviewMessageHandler.ts b/src/core/webview/webviewMessageHandler.ts
index 24a9b9e4176..14a469f5a38 100644
--- a/src/core/webview/webviewMessageHandler.ts
+++ b/src/core/webview/webviewMessageHandler.ts
@@ -597,7 +597,7 @@ export const webviewMessageHandler = async (
 							.getConfiguration(Package.name)
 							.update("deniedCommands", newValue, vscode.ConfigurationTarget.Global)
 					} else if (key === "taskHistoryRetention") {
-						// taskHistoryRetention is stored in Roo application state, not VS Code settings
+						// taskHistoryRetention is stored in Roo application state (global state), not VS Code settings.
 						newValue = ((value ?? "never") as string).toString()
 					} else if (key === "ttsEnabled") {
 						newValue = value ?? true
diff --git a/src/i18n/locales/en/common.json b/src/i18n/locales/en/common.json
index 636d26f76cb..89043321d66 100644
--- a/src/i18n/locales/en/common.json
+++ b/src/i18n/locales/en/common.json
@@ -252,5 +252,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code deleted {{count}} task older than {{days}} days",
+		"purgeNotification_plural": "Roo Code deleted {{count}} tasks older than {{days}} days",
+		"actions": {
+			"viewSettings": "View Settings",
+			"dismiss": "Dismiss"
+		}
 	}
 }
diff --git a/src/utils/formatBytes.ts b/src/utils/formatBytes.ts
new file mode 100644
index 00000000000..51a621fdd71
--- /dev/null
+++ b/src/utils/formatBytes.ts
@@ -0,0 +1,18 @@
+/**
+ * Formats bytes into a human-readable string with appropriate units.
+ *
+ * Note: This is intentionally simple (base-2 / 1024) and consistent with existing
+ * formatting expectations in tests and UI.
+ */
+export function formatBytes(bytes: number): string {
+	if (bytes === 0) return "0 B"
+
+	const units = ["B", "KB", "MB", "GB", "TB"]
+	const k = 1024
+	const i = Math.min(Math.floor(Math.log(bytes) / Math.log(k)), units.length - 1)
+	const size = bytes / Math.pow(k, i)
+
+	// Use 2 decimal places for MB and above, 0 for B and KB
+	const decimals = i >= 2 ? 2 : 0
+	return `${size.toFixed(decimals)} ${units[i]}`
+}
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index e7a7157f3e3..567b819e6b4 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -5,6 +5,7 @@ import type { Dirent } from "fs"
 
 import { getStorageBasePath } from "./storage"
 import { GlobalFileNames } from "../shared/globalFileNames"
+import { t } from "../i18n"
 
 /**
  * Allowed retention day values (as numbers).
@@ -328,10 +329,16 @@ export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions):
 
 			// Show user notification if tasks were deleted
 			if (result.purgedCount > 0) {
-				const message = `Roo Code deleted ${result.purgedCount} task${result.purgedCount === 1 ? "" : "s"} older than ${retention} days`
+				const message = t("common:taskHistoryRetention.purgeNotification", {
+					count: result.purgedCount,
+					days: retention,
+				})
+
+				const viewSettingsLabel = t("common:taskHistoryRetention.actions.viewSettings")
+				const dismissLabel = t("common:taskHistoryRetention.actions.dismiss")
 
-				vscode.window.showInformationMessage(message, "View Settings", "Dismiss").then((action) => {
-					if (action === "View Settings") {
+				vscode.window.showInformationMessage(message, viewSettingsLabel, dismissLabel).then((action) => {
+					if (action === viewSettingsLabel) {
 						// Navigate to Roo Code settings About tab
 						vscode.commands.executeCommand("roo-cline.settingsButtonClicked")
 					}
diff --git a/src/utils/task-storage-size.ts b/src/utils/task-storage-size.ts
index 669b6d733d1..cd16766735d 100644
--- a/src/utils/task-storage-size.ts
+++ b/src/utils/task-storage-size.ts
@@ -3,6 +3,7 @@ import * as fs from "fs/promises"
 import type { Dirent, Stats } from "fs"
 
 import { getStorageBasePath } from "./storage"
+import { formatBytes } from "./formatBytes"
 
 /**
  * Result of calculating task history storage size
@@ -16,23 +17,8 @@ export interface TaskStorageSizeResult {
 	formattedSize: string
 }
 
-/**
- * Formats bytes into a human-readable string with appropriate units.
- * @param bytes Number of bytes
- * @returns Formatted string (e.g., "12.34 MB", "5.67 GB")
- */
-export function formatBytes(bytes: number): string {
-	if (bytes === 0) return "0 B"
-
-	const units = ["B", "KB", "MB", "GB", "TB"]
-	const k = 1024
-	const i = Math.min(Math.floor(Math.log(bytes) / Math.log(k)), units.length - 1)
-	const size = bytes / Math.pow(k, i)
-
-	// Use 2 decimal places for MB and above, 0 for B and KB
-	const decimals = i >= 2 ? 2 : 0
-	return `${size.toFixed(decimals)} ${units[i]}`
-}
+// Re-export for backwards compatibility with existing imports/tests.
+export { formatBytes }
 
 /**
  * Recursively calculates the total size of a directory.
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index 77be9d22fbf..4899f43b3f4 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -16,7 +16,7 @@ import {
 } from "lucide-react"
 import { VSCodeCheckbox, VSCodeLink } from "@vscode/webview-ui-toolkit/react"
 
-import type { TelemetrySetting } from "@roo-code/types"
+import type { TelemetrySetting, TaskHistoryRetentionSetting } from "@roo-code/types"
 
 import { Package } from "@roo/package"
 
@@ -39,8 +39,8 @@ type AboutProps = HTMLAttributes<HTMLDivElement> & {
 	setTelemetrySetting: (setting: TelemetrySetting) => void
 	debug?: boolean
 	setDebug?: (debug: boolean) => void
-	taskHistoryRetention: "never" | "90" | "60" | "30" | "7" | "3"
-	setTaskHistoryRetention: (value: "never" | "90" | "60" | "30" | "7" | "3") => void
+	taskHistoryRetention: TaskHistoryRetentionSetting
+	setTaskHistoryRetention: (value: TaskHistoryRetentionSetting) => void
 	taskHistorySize?: TaskHistorySize
 }
 
@@ -206,7 +206,7 @@ export const About = ({
 					<div className="mt-2">
 						<Select
 							value={taskHistoryRetention}
-							onValueChange={(value: "never" | "90" | "60" | "30" | "7" | "3") => {
+							onValueChange={(value: TaskHistoryRetentionSetting) => {
 								setTaskHistoryRetention(value)
 							}}>
 							<SelectTrigger className="w-64">
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index 47b98c02dff..3dcb1581fcc 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -37,6 +37,8 @@ import {
 	type TelemetrySetting,
 	DEFAULT_CHECKPOINT_TIMEOUT_SECONDS,
 	ImageGenerationProvider,
+	TASK_HISTORY_RETENTION_OPTIONS,
+	type TaskHistoryRetentionSetting,
 } from "@roo-code/types"
 
 import { vscode } from "@src/utils/vscode"
@@ -627,16 +629,11 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 	// Determine which tab content to render (for indexing or active display)
 	const renderTab = isIndexing ? sectionNames[indexingTabIndex] : activeTab
 
-	type TaskHistoryRetentionSetting = React.ComponentProps<typeof About>["taskHistoryRetention"]
-	const normalizedTaskHistoryRetention: TaskHistoryRetentionSetting =
-		taskHistoryRetention === "never" ||
-		taskHistoryRetention === "90" ||
-		taskHistoryRetention === "60" ||
-		taskHistoryRetention === "30" ||
-		taskHistoryRetention === "7" ||
-		taskHistoryRetention === "3"
-			? taskHistoryRetention
-			: "never"
+	const normalizedTaskHistoryRetention: TaskHistoryRetentionSetting = TASK_HISTORY_RETENTION_OPTIONS.includes(
+		taskHistoryRetention as TaskHistoryRetentionSetting,
+	)
+		? (taskHistoryRetention as TaskHistoryRetentionSetting)
+		: "never"
 
 	// Handle search navigation - switch to the correct tab and scroll to the element
 	const handleSearchNavigate = useCallback(

From 7083b1a720cfcd9dcd779513661e3e8a61e3ffd6 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 22:54:50 -0700
Subject: [PATCH 22/37] fix: add missing task history retention translations

---
 src/i18n/locales/ca/common.json    | 8 ++++++++
 src/i18n/locales/de/common.json    | 8 ++++++++
 src/i18n/locales/es/common.json    | 8 ++++++++
 src/i18n/locales/fr/common.json    | 8 ++++++++
 src/i18n/locales/hi/common.json    | 8 ++++++++
 src/i18n/locales/id/common.json    | 8 ++++++++
 src/i18n/locales/it/common.json    | 8 ++++++++
 src/i18n/locales/ja/common.json    | 8 ++++++++
 src/i18n/locales/ko/common.json    | 8 ++++++++
 src/i18n/locales/nl/common.json    | 8 ++++++++
 src/i18n/locales/pl/common.json    | 8 ++++++++
 src/i18n/locales/pt-BR/common.json | 8 ++++++++
 src/i18n/locales/ru/common.json    | 8 ++++++++
 src/i18n/locales/tr/common.json    | 8 ++++++++
 src/i18n/locales/vi/common.json    | 8 ++++++++
 src/i18n/locales/zh-CN/common.json | 8 ++++++++
 src/i18n/locales/zh-TW/common.json | 8 ++++++++
 17 files changed, 136 insertions(+)

diff --git a/src/i18n/locales/ca/common.json b/src/i18n/locales/ca/common.json
index 9f8f961e73e..72ed59ff9f5 100644
--- a/src/i18n/locales/ca/common.json
+++ b/src/i18n/locales/ca/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code ha eliminat {{count}} tasca més antiga de {{days}} dies",
+		"purgeNotification_plural": "Roo Code ha eliminat {{count}} tasques més antigues de {{days}} dies",
+		"actions": {
+			"viewSettings": "Veure configuració",
+			"dismiss": "Descartar"
+		}
 	}
 }
diff --git a/src/i18n/locales/de/common.json b/src/i18n/locales/de/common.json
index 086372dda85..e814b30dc14 100644
--- a/src/i18n/locales/de/common.json
+++ b/src/i18n/locales/de/common.json
@@ -258,5 +258,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code hat {{count}} Aufgabe gelöscht, die älter als {{days}} Tage war",
+		"purgeNotification_plural": "Roo Code hat {{count}} Aufgaben gelöscht, die älter als {{days}} Tage waren",
+		"actions": {
+			"viewSettings": "Einstellungen anzeigen",
+			"dismiss": "Verwerfen"
+		}
 	}
 }
diff --git a/src/i18n/locales/es/common.json b/src/i18n/locales/es/common.json
index bc22040c6a8..dda28291787 100644
--- a/src/i18n/locales/es/common.json
+++ b/src/i18n/locales/es/common.json
@@ -258,5 +258,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code eliminó {{count}} tarea más antigua de {{days}} días",
+		"purgeNotification_plural": "Roo Code eliminó {{count}} tareas más antiguas de {{days}} días",
+		"actions": {
+			"viewSettings": "Ver configuración",
+			"dismiss": "Descartar"
+		}
 	}
 }
diff --git a/src/i18n/locales/fr/common.json b/src/i18n/locales/fr/common.json
index f7a76a53c12..e95b6313fc4 100644
--- a/src/i18n/locales/fr/common.json
+++ b/src/i18n/locales/fr/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code a supprimé {{count}} tâche datant de plus de {{days}} jours",
+		"purgeNotification_plural": "Roo Code a supprimé {{count}} tâches datant de plus de {{days}} jours",
+		"actions": {
+			"viewSettings": "Voir les paramètres",
+			"dismiss": "Ignorer"
+		}
 	}
 }
diff --git a/src/i18n/locales/hi/common.json b/src/i18n/locales/hi/common.json
index e51d177d946..85811b8bf4c 100644
--- a/src/i18n/locales/hi/common.json
+++ b/src/i18n/locales/hi/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code ने {{days}} दिनों से अधिक पुराना {{count}} कार्य हटा दिया",
+		"purgeNotification_plural": "Roo Code ने {{days}} दिनों से अधिक पुराने {{count}} कार्य हटा दिए",
+		"actions": {
+			"viewSettings": "सेटिंग्स देखें",
+			"dismiss": "खारिज करें"
+		}
 	}
 }
diff --git a/src/i18n/locales/id/common.json b/src/i18n/locales/id/common.json
index cfb165979d3..6fc394b952a 100644
--- a/src/i18n/locales/id/common.json
+++ b/src/i18n/locales/id/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code menghapus {{count}} tugas yang lebih lama dari {{days}} hari",
+		"purgeNotification_plural": "Roo Code menghapus {{count}} tugas yang lebih lama dari {{days}} hari",
+		"actions": {
+			"viewSettings": "Lihat Pengaturan",
+			"dismiss": "Tutup"
+		}
 	}
 }
diff --git a/src/i18n/locales/it/common.json b/src/i18n/locales/it/common.json
index e5fa6d68db3..6c04e108f7d 100644
--- a/src/i18n/locales/it/common.json
+++ b/src/i18n/locales/it/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code ha eliminato {{count}} attività più vecchia di {{days}} giorni",
+		"purgeNotification_plural": "Roo Code ha eliminato {{count}} attività più vecchie di {{days}} giorni",
+		"actions": {
+			"viewSettings": "Visualizza Impostazioni",
+			"dismiss": "Ignora"
+		}
 	}
 }
diff --git a/src/i18n/locales/ja/common.json b/src/i18n/locales/ja/common.json
index 7ebe0de597d..c572deb6a2e 100644
--- a/src/i18n/locales/ja/common.json
+++ b/src/i18n/locales/ja/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Codeは{{days}}日より古い{{count}}件のタスクを削除しました",
+		"purgeNotification_plural": "Roo Codeは{{days}}日より古い{{count}}件のタスクを削除しました",
+		"actions": {
+			"viewSettings": "設定を表示",
+			"dismiss": "閉じる"
+		}
 	}
 }
diff --git a/src/i18n/locales/ko/common.json b/src/i18n/locales/ko/common.json
index 0c1ed5ba518..52b1194b475 100644
--- a/src/i18n/locales/ko/common.json
+++ b/src/i18n/locales/ko/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code가 {{days}}일보다 오래된 작업 {{count}}개를 삭제했습니다",
+		"purgeNotification_plural": "Roo Code가 {{days}}일보다 오래된 작업 {{count}}개를 삭제했습니다",
+		"actions": {
+			"viewSettings": "설정 보기",
+			"dismiss": "닫기"
+		}
 	}
 }
diff --git a/src/i18n/locales/nl/common.json b/src/i18n/locales/nl/common.json
index 0bbf5695364..77ea9e718f2 100644
--- a/src/i18n/locales/nl/common.json
+++ b/src/i18n/locales/nl/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code heeft {{count}} taak verwijderd die ouder is dan {{days}} dagen",
+		"purgeNotification_plural": "Roo Code heeft {{count}} taken verwijderd die ouder zijn dan {{days}} dagen",
+		"actions": {
+			"viewSettings": "Instellingen Bekijken",
+			"dismiss": "Sluiten"
+		}
 	}
 }
diff --git a/src/i18n/locales/pl/common.json b/src/i18n/locales/pl/common.json
index 23bc09e4d78..3144aaff4a2 100644
--- a/src/i18n/locales/pl/common.json
+++ b/src/i18n/locales/pl/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code usunął {{count}} zadanie starsze niż {{days}} dni",
+		"purgeNotification_plural": "Roo Code usunął {{count}} zadań starszych niż {{days}} dni",
+		"actions": {
+			"viewSettings": "Zobacz Ustawienia",
+			"dismiss": "Zamknij"
+		}
 	}
 }
diff --git a/src/i18n/locales/pt-BR/common.json b/src/i18n/locales/pt-BR/common.json
index 737b322f78a..95f9b89b42e 100644
--- a/src/i18n/locales/pt-BR/common.json
+++ b/src/i18n/locales/pt-BR/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code excluiu {{count}} tarefa mais antiga que {{days}} dias",
+		"purgeNotification_plural": "Roo Code excluiu {{count}} tarefas mais antigas que {{days}} dias",
+		"actions": {
+			"viewSettings": "Ver Configurações",
+			"dismiss": "Dispensar"
+		}
 	}
 }
diff --git a/src/i18n/locales/ru/common.json b/src/i18n/locales/ru/common.json
index 7ac53199ba8..a7827a4506f 100644
--- a/src/i18n/locales/ru/common.json
+++ b/src/i18n/locales/ru/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code удалил {{count}} задачу старше {{days}} дней",
+		"purgeNotification_plural": "Roo Code удалил {{count}} задач старше {{days}} дней",
+		"actions": {
+			"viewSettings": "Посмотреть Настройки",
+			"dismiss": "Закрыть"
+		}
 	}
 }
diff --git a/src/i18n/locales/tr/common.json b/src/i18n/locales/tr/common.json
index fca268c0ff6..7e00f6cf077 100644
--- a/src/i18n/locales/tr/common.json
+++ b/src/i18n/locales/tr/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code, {{days}} günden eski {{count}} görevi sildi",
+		"purgeNotification_plural": "Roo Code, {{days}} günden eski {{count}} görevi sildi",
+		"actions": {
+			"viewSettings": "Ayarları Görüntüle",
+			"dismiss": "Kapat"
+		}
 	}
 }
diff --git a/src/i18n/locales/vi/common.json b/src/i18n/locales/vi/common.json
index bd9bb72b474..2e7b44fb474 100644
--- a/src/i18n/locales/vi/common.json
+++ b/src/i18n/locales/vi/common.json
@@ -270,5 +270,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code đã xóa {{count}} tác vụ cũ hơn {{days}} ngày",
+		"purgeNotification_plural": "Roo Code đã xóa {{count}} tác vụ cũ hơn {{days}} ngày",
+		"actions": {
+			"viewSettings": "Xem Cài Đặt",
+			"dismiss": "Đóng"
+		}
 	}
 }
diff --git a/src/i18n/locales/zh-CN/common.json b/src/i18n/locales/zh-CN/common.json
index 494c246d658..4fb885cd07a 100644
--- a/src/i18n/locales/zh-CN/common.json
+++ b/src/i18n/locales/zh-CN/common.json
@@ -268,5 +268,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code 已删除 {{count}} 个超过 {{days}} 天的任务",
+		"purgeNotification_plural": "Roo Code 已删除 {{count}} 个超过 {{days}} 天的任务",
+		"actions": {
+			"viewSettings": "查看设置",
+			"dismiss": "关闭"
+		}
 	}
 }
diff --git a/src/i18n/locales/zh-TW/common.json b/src/i18n/locales/zh-TW/common.json
index 572cdb46519..90c9ef05a37 100644
--- a/src/i18n/locales/zh-TW/common.json
+++ b/src/i18n/locales/zh-TW/common.json
@@ -263,5 +263,13 @@
 	"docsLink": {
 		"label": "Docs",
 		"url": "https://docs.roocode.com"
+	},
+	"taskHistoryRetention": {
+		"purgeNotification": "Roo Code 已刪除 {{count}} 個超過 {{days}} 天的工作",
+		"purgeNotification_plural": "Roo Code 已刪除 {{count}} 個超過 {{days}} 天的工作",
+		"actions": {
+			"viewSettings": "檢視設定",
+			"dismiss": "關閉"
+		}
 	}
 }

From 1eb887d763d8418f0f423f20ded17facb6ade6a0 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 19 Jan 2026 23:10:55 -0700
Subject: [PATCH 23/37] test(core): increase timeout for CustomToolRegistry
 clearCache test

---
 .../src/custom-tools/__tests__/custom-tool-registry.spec.ts     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/src/custom-tools/__tests__/custom-tool-registry.spec.ts b/packages/core/src/custom-tools/__tests__/custom-tool-registry.spec.ts
index c1838440c24..d1694f2effa 100644
--- a/packages/core/src/custom-tools/__tests__/custom-tool-registry.spec.ts
+++ b/packages/core/src/custom-tools/__tests__/custom-tool-registry.spec.ts
@@ -281,7 +281,7 @@ describe("CustomToolRegistry", () => {
 			const result = await registry.loadFromDirectory(TEST_FIXTURES_DIR)
 
 			expect(result.loaded).toContain("cached")
-		}, 30000)
+		}, 120_000)
 	})
 
 	describe.sequential("loadFromDirectories", () => {

From 56ac6ef9b9ec9b0fd4215353b05fccfbca906d2b Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Tue, 20 Jan 2026 18:16:17 -0700
Subject: [PATCH 24/37] Update
 webview-ui/src/components/settings/SettingsView.tsx

Co-authored-by: roomote[bot] <219738659+roomote[bot]@users.noreply.github.com>
---
 webview-ui/src/components/settings/SettingsView.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index 3dcb1581fcc..3a54a82ab15 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -429,7 +429,7 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 					includeCurrentTime: includeCurrentTime ?? true,
 					includeCurrentCost: includeCurrentCost ?? true,
 					maxGitStatusFiles: maxGitStatusFiles ?? 0,
-					taskHistoryRetention: taskHistoryRetention ?? "never",
+taskHistoryRetention: normalizedTaskHistoryRetention,
 					profileThresholds,
 					imageGenerationProvider,
 					openRouterImageApiKey,

From 18894daad2c31838a01f6cbec780c43f83966576 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Tue, 20 Jan 2026 18:58:04 -0700
Subject: [PATCH 25/37] fix: address mrubens review on retention types and
 settings navigation

---
 packages/types/src/global-settings.ts         |  3 +--
 src/activate/registerCommands.ts              |  8 ++++--
 src/extension.ts                              | 14 +++++------
 src/utils/task-history-retention.ts           | 25 ++++++++-----------
 webview-ui/src/components/settings/About.tsx  | 10 +++++++-
 .../src/components/settings/SettingsView.tsx  |  9 +------
 6 files changed, 34 insertions(+), 35 deletions(-)

diff --git a/packages/types/src/global-settings.ts b/packages/types/src/global-settings.ts
index f9b92857ff3..50811d0527f 100644
--- a/packages/types/src/global-settings.ts
+++ b/packages/types/src/global-settings.ts
@@ -190,8 +190,7 @@ export const globalSettingsSchema = z.object({
 	enhancementApiConfigId: z.string().optional(),
 	includeTaskHistoryInEnhance: z.boolean().optional(),
 	// Auto-delete task history on extension reload.
-	// Note: we accept `number` for backwards compatibility with older persisted state.
-	taskHistoryRetention: z.union([z.enum(TASK_HISTORY_RETENTION_OPTIONS), z.number()]).optional(),
+	taskHistoryRetention: z.enum(TASK_HISTORY_RETENTION_OPTIONS).optional(),
 	// Calculated task history storage size info for the Settings > About page
 	taskHistorySize: z
 		.object({
diff --git a/src/activate/registerCommands.ts b/src/activate/registerCommands.ts
index f02ee8309a3..18d7c512c03 100644
--- a/src/activate/registerCommands.ts
+++ b/src/activate/registerCommands.ts
@@ -105,7 +105,7 @@ const getCommandsMap = ({ context, outputChannel, provider }: RegisterCommandOpt
 		return openClineInNewTab({ context, outputChannel })
 	},
 	openInNewTab: () => openClineInNewTab({ context, outputChannel }),
-	settingsButtonClicked: () => {
+	settingsButtonClicked: (section?: string) => {
 		const visibleProvider = getVisibleProviderOrLog(outputChannel)
 
 		if (!visibleProvider) {
@@ -114,7 +114,11 @@ const getCommandsMap = ({ context, outputChannel, provider }: RegisterCommandOpt
 
 		TelemetryService.instance.captureTitleButtonClicked("settings")
 
-		visibleProvider.postMessageToWebview({ type: "action", action: "settingsButtonClicked" })
+		visibleProvider.postMessageToWebview({
+			type: "action",
+			action: "settingsButtonClicked",
+			values: section ? { section } : undefined,
+		})
 		// Also explicitly post the visibility message to trigger scroll reliably
 		visibleProvider.postMessageToWebview({ type: "action", action: "didBecomeVisible" })
 	},
diff --git a/src/extension.ts b/src/extension.ts
index 11e3e702e73..b46145e5789 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -45,6 +45,7 @@ import {
 import { initializeI18n } from "./i18n"
 import { flushModels, initializeModelCacheRefresh, refreshModels } from "./api/providers/fetchers/modelCache"
 import { startBackgroundRetentionPurge } from "./utils/task-history-retention"
+import { TASK_HISTORY_RETENTION_OPTIONS, type TaskHistoryRetentionSetting } from "@roo-code/types"
 
 /**
  * Built using https://github.com/microsoft/vscode-webview-ui-toolkit
@@ -392,14 +393,11 @@ export async function activate(context: vscode.ExtensionContext) {
 	// By this point, provider is fully initialized and ready to handle deletions
 	{
 		const retentionValue = contextProxy.getValue("taskHistoryRetention")
-		const retention =
-			retentionValue === "90" ||
-			retentionValue === "60" ||
-			retentionValue === "30" ||
-			retentionValue === "7" ||
-			retentionValue === "3"
-				? retentionValue
-				: "never"
+		const retention: TaskHistoryRetentionSetting = TASK_HISTORY_RETENTION_OPTIONS.includes(
+			retentionValue as TaskHistoryRetentionSetting,
+		)
+			? (retentionValue as TaskHistoryRetentionSetting)
+			: "never"
 		startBackgroundRetentionPurge({
 			globalStoragePath: contextProxy.globalStorageUri.fsPath,
 			log: (m) => outputChannel.appendLine(m),
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 567b819e6b4..d59b979bd0b 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -3,21 +3,13 @@ import * as path from "path"
 import * as fs from "fs/promises"
 import type { Dirent } from "fs"
 
+import { TASK_HISTORY_RETENTION_OPTIONS, type TaskHistoryRetentionSetting } from "@roo-code/types"
+
 import { getStorageBasePath } from "./storage"
 import { GlobalFileNames } from "../shared/globalFileNames"
 import { t } from "../i18n"
 
-/**
- * Allowed retention day values (as numbers).
- */
-export type RetentionDays = 90 | 60 | 30 | 7 | 3
-
-/**
- * Supported values for the retention setting.
- * - "never" or 0 disables purging
- * - "90" | "60" | "30" | "7" | "3" (string) or 90 | 60 | 30 | 7 | 3 (number) specify days
- */
-export type RetentionSetting = "never" | "0" | `${RetentionDays}` | RetentionDays | 0
+export type RetentionSetting = TaskHistoryRetentionSetting
 
 export type PurgeResult = {
 	purgedCount: number
@@ -280,7 +272,7 @@ export async function purgeOldTasks(
  */
 function normalizeDays(value: RetentionSetting): number {
 	if (value === "never") return 0
-	const n = typeof value === "number" ? value : parseInt(String(value), 10)
+	const n = parseInt(value, 10)
 	return Number.isFinite(n) && n > 0 ? Math.trunc(n) : 0
 }
 
@@ -314,11 +306,16 @@ export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions):
 	void (async () => {
 		try {
 			// Skip if retention is disabled
-			if (retention === "never" || retention === "0" || retention === 0) {
+			if (retention === "never") {
 				log("[Retention] Background purge skipped: retention is set to 'never'")
 				return
 			}
 
+			if (!TASK_HISTORY_RETENTION_OPTIONS.includes(retention)) {
+				log(`[Retention] Background purge skipped: invalid retention value '${retention}'`)
+				return
+			}
+
 			log(`[Retention] Starting background purge: setting=${retention}`)
 
 			const result = await purgeOldTasks(retention, globalStoragePath, log, false, deleteTaskById)
@@ -340,7 +337,7 @@ export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions):
 				vscode.window.showInformationMessage(message, viewSettingsLabel, dismissLabel).then((action) => {
 					if (action === viewSettingsLabel) {
 						// Navigate to Roo Code settings About tab
-						vscode.commands.executeCommand("roo-cline.settingsButtonClicked")
+						vscode.commands.executeCommand("roo-cline.settingsButtonClicked", "about")
 					}
 				})
 			}
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index 4899f43b3f4..e51df56ef5d 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -1,4 +1,4 @@
-import { HTMLAttributes, useState, useCallback, useEffect } from "react"
+import { HTMLAttributes, useState, useCallback, useEffect, useRef } from "react"
 import { useAppTranslation } from "@/i18n/TranslationContext"
 import { Trans } from "react-i18next"
 import {
@@ -58,6 +58,7 @@ export const About = ({
 	const { t } = useAppTranslation()
 	const [isRefreshing, setIsRefreshing] = useState(false)
 	const [cachedSize, setCachedSize] = useState<TaskHistorySize | undefined>(taskHistorySize)
+	const didRequestInitialSize = useRef(false)
 
 	// Update cached size when taskHistorySize changes and reset refreshing state
 	useEffect(() => {
@@ -67,6 +68,13 @@ export const About = ({
 		}
 	}, [taskHistorySize])
 
+	// Trigger initial task history size calculation when this tab mounts
+	useEffect(() => {
+		if (didRequestInitialSize.current) return
+		didRequestInitialSize.current = true
+		vscode.postMessage({ type: "refreshTaskHistorySize" })
+	}, [])
+
 	const handleRefreshStorageSize = useCallback(() => {
 		setIsRefreshing(true)
 		vscode.postMessage({ type: "refreshTaskHistorySize" })
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index 3a54a82ab15..9720119c8af 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -429,7 +429,7 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 					includeCurrentTime: includeCurrentTime ?? true,
 					includeCurrentCost: includeCurrentCost ?? true,
 					maxGitStatusFiles: maxGitStatusFiles ?? 0,
-taskHistoryRetention: normalizedTaskHistoryRetention,
+					taskHistoryRetention: normalizedTaskHistoryRetention,
 					profileThresholds,
 					imageGenerationProvider,
 					openRouterImageApiKey,
@@ -566,13 +566,6 @@ taskHistoryRetention: normalizedTaskHistoryRetention,
 		scrollToActiveTab()
 	}, [activeTab, scrollToActiveTab])
 
-	// Effect to trigger task history size calculation when About tab is opened
-	useEffect(() => {
-		if (activeTab === "about") {
-			vscode.postMessage({ type: "refreshTaskHistorySize" })
-		}
-	}, [activeTab])
-
 	// Effect to scroll when the webview becomes visible
 	useLayoutEffect(() => {
 		const handleMessage = (event: MessageEvent) => {

From b19ab45ba8586f75882da80a234318461e9ae25e Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 14:01:12 -0700
Subject: [PATCH 26/37] perf: replace storage size calculation with fast task
 count

- Remove expensive recursive getDirectorySize() that caused UI freeze with ~9000 tasks
- Now only counts top-level task directories via single fs.readdir() call
- Make task count on-demand (user must click refresh) instead of auto-trigger on settings load
- Update types, i18n strings, and tests accordingly
---
 packages/types/src/global-settings.ts         |   6 +-
 packages/types/src/vscode-extension-host.ts   |   9 +-
 src/utils/__tests__/task-storage-size.spec.ts | 144 ++++--------------
 src/utils/task-storage-size.ts                |  81 ++--------
 webview-ui/src/components/settings/About.tsx  |  38 ++---
 .../src/components/settings/SettingsView.tsx  |  14 ++
 webview-ui/src/i18n/locales/en/settings.json  |  11 +-
 7 files changed, 85 insertions(+), 218 deletions(-)

diff --git a/packages/types/src/global-settings.ts b/packages/types/src/global-settings.ts
index 50811d0527f..5f4cbf0cd3f 100644
--- a/packages/types/src/global-settings.ts
+++ b/packages/types/src/global-settings.ts
@@ -191,12 +191,12 @@ export const globalSettingsSchema = z.object({
 	includeTaskHistoryInEnhance: z.boolean().optional(),
 	// Auto-delete task history on extension reload.
 	taskHistoryRetention: z.enum(TASK_HISTORY_RETENTION_OPTIONS).optional(),
-	// Calculated task history storage size info for the Settings > About page
+	// Calculated task history count for the Settings > About page
+	// Note: Size calculation was removed for performance reasons - with large numbers of
+	// tasks (e.g., 9000+), recursively stat'ing every file caused significant delays.
 	taskHistorySize: z
 		.object({
-			totalBytes: z.number(),
 			taskCount: z.number(),
-			formattedSize: z.string(),
 		})
 		.optional(),
 	historyPreviewCollapsed: z.boolean().optional(),
diff --git a/packages/types/src/vscode-extension-host.ts b/packages/types/src/vscode-extension-host.ts
index 5a6bae36fe0..77f6c5e34b0 100644
--- a/packages/types/src/vscode-extension-host.ts
+++ b/packages/types/src/vscode-extension-host.ts
@@ -396,14 +396,13 @@ export type ExtensionState = Pick<
 	marketplaceInstalledMetadata?: { project: Record<string, any>; global: Record<string, any> }
 	profileThresholds: Record<string, number>
 	hasOpenedModeSelector: boolean
-	/** Task history storage size info for the Settings > About page */
+	/** Task history count for the Settings > About page
+	 * Note: Size calculation was removed for performance reasons - with large numbers of
+	 * tasks (e.g., 9000+), recursively stat'ing every file caused significant delays.
+	 */
 	taskHistorySize?: {
-		/** Total size in bytes */
-		totalBytes: number
 		/** Number of task directories */
 		taskCount: number
-		/** Formatted size string (e.g., "12.34 MB") */
-		formattedSize: string
 	}
 	openRouterImageApiKey?: string
 	messageQueue?: QueuedMessage[]
diff --git a/src/utils/__tests__/task-storage-size.spec.ts b/src/utils/__tests__/task-storage-size.spec.ts
index cc7997b146d..5d1a3463474 100644
--- a/src/utils/__tests__/task-storage-size.spec.ts
+++ b/src/utils/__tests__/task-storage-size.spec.ts
@@ -1,4 +1,3 @@
-import * as path from "path"
 import { calculateTaskStorageSize, formatBytes } from "../task-storage-size"
 
 // Mock storage to avoid VS Code config access during tests
@@ -8,13 +7,12 @@ vi.mock("../storage", () => ({
 
 // Mock fs/promises
 const mockReaddir = vi.fn()
-const mockStat = vi.fn()
 
 vi.mock("fs/promises", () => ({
 	readdir: (...args: unknown[]) => mockReaddir(...args),
-	stat: (...args: unknown[]) => mockStat(...args),
 }))
 
+// formatBytes is still exported for backwards compatibility but not used by calculateTaskStorageSize
 describe("formatBytes", () => {
 	it("should format 0 bytes", () => {
 		expect(formatBytes(0)).toBe("0 B")
@@ -58,33 +56,29 @@ describe("calculateTaskStorageSize", () => {
 		vi.clearAllMocks()
 	})
 
-	it("should return zeros when tasks directory does not exist", async () => {
+	it("should return zero count when tasks directory does not exist", async () => {
 		mockReaddir.mockRejectedValue(new Error("ENOENT: no such file or directory"))
 
 		const result = await calculateTaskStorageSize("/global/storage")
 
 		expect(result).toEqual({
-			totalBytes: 0,
 			taskCount: 0,
-			formattedSize: "0 B",
 		})
 	})
 
-	it("should calculate size of empty tasks directory", async () => {
+	it("should return zero count for empty tasks directory", async () => {
 		mockReaddir.mockResolvedValue([])
 
 		const result = await calculateTaskStorageSize("/global/storage")
 
 		expect(result).toEqual({
-			totalBytes: 0,
 			taskCount: 0,
-			formattedSize: "0 B",
 		})
 	})
 
 	it("should count task directories correctly", async () => {
 		// Mock the tasks directory read
-		mockReaddir.mockImplementation((dirPath: string, options?: { withFileTypes: boolean }) => {
+		mockReaddir.mockImplementation((dirPath: string) => {
 			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
 			if (pathStr.endsWith("tasks")) {
 				// Return task directories
@@ -94,7 +88,6 @@ describe("calculateTaskStorageSize", () => {
 					{ name: "task-3", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
 				])
 			}
-			// Task subdirectories are empty
 			return Promise.resolve([])
 		})
 
@@ -103,140 +96,69 @@ describe("calculateTaskStorageSize", () => {
 		expect(result.taskCount).toBe(3)
 	})
 
-	it("should calculate total size including files", async () => {
-		// Mock the tasks directory read
+	it("should only count directories, not files in tasks folder", async () => {
 		mockReaddir.mockImplementation((dirPath: string) => {
 			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
 			if (pathStr.endsWith("tasks")) {
 				return Promise.resolve([
 					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
-				])
-			}
-			if (pathStr.includes("task-1")) {
-				return Promise.resolve([
-					{ name: "file1.txt", isDirectory: () => false, isFile: () => true, isSymbolicLink: () => false },
-					{ name: "file2.json", isDirectory: () => false, isFile: () => true, isSymbolicLink: () => false },
-				])
-			}
-			return Promise.resolve([])
-		})
-
-		mockStat.mockImplementation((filePath: string) => {
-			if (filePath.includes("file1.txt")) {
-				return Promise.resolve({ size: 1024 })
-			}
-			if (filePath.includes("file2.json")) {
-				return Promise.resolve({ size: 2048 })
-			}
-			return Promise.resolve({ size: 0 })
-		})
-
-		const result = await calculateTaskStorageSize("/global/storage")
-
-		expect(result.totalBytes).toBe(3072)
-		expect(result.formattedSize).toBe("3 KB")
-		expect(result.taskCount).toBe(1)
-	})
-
-	it("should handle nested directories (like checkpoints)", async () => {
-		mockReaddir.mockImplementation((dirPath: string) => {
-			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
-			if (pathStr.endsWith("tasks")) {
-				return Promise.resolve([
-					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
-				])
-			}
-			if (pathStr.endsWith("task-1") && !pathStr.includes("checkpoints")) {
-				return Promise.resolve([
+					{ name: "task-2", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
 					{
-						name: "api_conversation.json",
+						name: "some-file.txt",
 						isDirectory: () => false,
 						isFile: () => true,
 						isSymbolicLink: () => false,
-					},
-					{ name: "checkpoints", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
-				])
-			}
-			if (pathStr.includes("checkpoints")) {
-				return Promise.resolve([
+					}, // Should not count as task
 					{
-						name: "checkpoint-1.json",
+						name: "another-file.json",
 						isDirectory: () => false,
 						isFile: () => true,
 						isSymbolicLink: () => false,
-					},
+					}, // Should not count as task
 				])
 			}
 			return Promise.resolve([])
 		})
 
-		mockStat.mockImplementation((filePath: string) => {
-			if (filePath.includes("api_conversation.json")) {
-				return Promise.resolve({ size: 5000 })
-			}
-			if (filePath.includes("checkpoint-1.json")) {
-				return Promise.resolve({ size: 10000 })
-			}
-			return Promise.resolve({ size: 0 })
-		})
-
 		const result = await calculateTaskStorageSize("/global/storage")
 
-		expect(result.totalBytes).toBe(15000)
-		expect(result.taskCount).toBe(1)
+		// Only directories count as tasks
+		expect(result.taskCount).toBe(2)
 	})
 
-	it("should handle stat errors gracefully", async () => {
+	it("should handle large task counts efficiently (does not recurse into subdirectories)", async () => {
+		// Simulate 9000 task directories - this should be fast since we don't recurse
+		const manyTasks = Array.from({ length: 9000 }, (_, i) => ({
+			name: `task-${i}`,
+			isDirectory: () => true,
+			isFile: () => false,
+			isSymbolicLink: () => false,
+		}))
+
 		mockReaddir.mockImplementation((dirPath: string) => {
 			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
 			if (pathStr.endsWith("tasks")) {
-				return Promise.resolve([
-					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
-				])
+				return Promise.resolve(manyTasks)
 			}
-			return Promise.resolve([
-				{ name: "broken-file.txt", isDirectory: () => false, isFile: () => true, isSymbolicLink: () => false },
-			])
+			return Promise.resolve([])
 		})
 
-		mockStat.mockRejectedValue(new Error("Permission denied"))
-
+		const startTime = Date.now()
 		const result = await calculateTaskStorageSize("/global/storage")
+		const elapsed = Date.now() - startTime
 
-		// Should still return a result, just with 0 bytes for the failed stat
-		expect(result.taskCount).toBe(1)
-		expect(result.totalBytes).toBe(0)
+		expect(result.taskCount).toBe(9000)
+		// Should complete quickly since we're not recursing into directories
+		expect(elapsed).toBeLessThan(100) // Should be nearly instant
 	})
 
-	it("should handle mixed files and directories in tasks folder", async () => {
-		mockReaddir.mockImplementation((dirPath: string) => {
-			const pathStr = typeof dirPath === "string" ? dirPath : String(dirPath)
-			if (pathStr.endsWith("tasks")) {
-				return Promise.resolve([
-					{ name: "task-1", isDirectory: () => true, isFile: () => false, isSymbolicLink: () => false },
-					{
-						name: "some-file.txt",
-						isDirectory: () => false,
-						isFile: () => true,
-						isSymbolicLink: () => false,
-					}, // Should not count as task
-				])
-			}
-			return Promise.resolve([])
-		})
-
-		mockStat.mockImplementation((filePath: string) => {
-			if (filePath.includes("some-file.txt")) {
-				return Promise.resolve({ size: 100 })
-			}
-			return Promise.resolve({ size: 0 })
-		})
+	it("should handle readdir errors gracefully", async () => {
+		mockReaddir.mockRejectedValue(new Error("Permission denied"))
 
 		const result = await calculateTaskStorageSize("/global/storage")
 
-		// Only directories count as tasks
-		expect(result.taskCount).toBe(1)
-		// But file size should be included
-		expect(result.totalBytes).toBe(100)
+		expect(result).toEqual({
+			taskCount: 0,
+		})
 	})
 })
diff --git a/src/utils/task-storage-size.ts b/src/utils/task-storage-size.ts
index cd16766735d..91544b55335 100644
--- a/src/utils/task-storage-size.ts
+++ b/src/utils/task-storage-size.ts
@@ -1,94 +1,42 @@
 import * as path from "path"
 import * as fs from "fs/promises"
-import type { Dirent, Stats } from "fs"
 
 import { getStorageBasePath } from "./storage"
 import { formatBytes } from "./formatBytes"
 
 /**
- * Result of calculating task history storage size
+ * Result of counting task history items.
+ * Note: Size calculation was removed for performance reasons - with large numbers of
+ * tasks (e.g., 9000+), recursively stat'ing every file caused significant delays.
  */
 export interface TaskStorageSizeResult {
-	/** Total size in bytes */
-	totalBytes: number
 	/** Number of task directories found */
 	taskCount: number
-	/** Formatted size string (e.g., "12.34 MB") */
-	formattedSize: string
 }
 
 // Re-export for backwards compatibility with existing imports/tests.
 export { formatBytes }
 
 /**
- * Recursively calculates the total size of a directory.
- * @param dirPath Path to the directory
- * @returns Total size in bytes
- */
-async function getDirectorySize(dirPath: string, depth: number = 0): Promise<number> {
-	let totalSize = 0
-
-	// Safety check: prevent infinite recursion by limiting depth
-	if (depth > 50) {
-		return 0
-	}
-
-	try {
-		const entries: Dirent[] = await fs.readdir(dirPath, { withFileTypes: true })
-
-		// Process entries in parallel for better performance
-		const sizes = await Promise.all(
-			entries.map(async (entry) => {
-				const entryPath = path.join(dirPath, entry.name)
-
-				try {
-					// Check for symlinks to prevent infinite loops
-					if (entry.isSymbolicLink()) {
-						return 0
-					}
-
-					if (entry.isDirectory()) {
-						return await getDirectorySize(entryPath, depth + 1)
-					} else if (entry.isFile()) {
-						const stat: Stats = await fs.stat(entryPath)
-						return stat.size
-					}
-				} catch {
-					// Ignore errors for individual entries (permission issues, deleted files, etc.)
-				}
-
-				return 0
-			}),
-		)
-
-		totalSize = sizes.reduce((acc, size) => acc + size, 0)
-	} catch {
-		// Directory doesn't exist or can't be read
-	}
-
-	return totalSize
-}
-
-/**
- * Calculates the total storage size used by task history.
- * This includes all files in the tasks/ directory (task data, checkpoints, etc.).
+ * Counts the number of task directories in task history storage.
  *
- * This function is designed to be non-blocking and safe for background execution.
- * Errors are handled gracefully and will return 0 bytes if the directory doesn't exist
- * or can't be read.
+ * This function is designed to be fast and non-blocking - it only counts
+ * top-level directories without recursively walking the file tree.
+ *
+ * Note: Size calculation was intentionally removed because with large task counts
+ * (e.g., 9000+), the recursive stat calls caused significant performance issues
+ * and blocked the extension UI.
  *
  * @param globalStoragePath VS Code global storage fsPath (context.globalStorageUri.fsPath)
  * @param log Optional logger function for debugging
- * @returns TaskStorageSizeResult with size info
+ * @returns TaskStorageSizeResult with task count
  */
 export async function calculateTaskStorageSize(
 	globalStoragePath: string,
 	log?: (message: string) => void,
 ): Promise<TaskStorageSizeResult> {
 	const defaultResult: TaskStorageSizeResult = {
-		totalBytes: 0,
 		taskCount: 0,
-		formattedSize: "0 B",
 	}
 
 	let basePath: string
@@ -102,7 +50,7 @@ export async function calculateTaskStorageSize(
 
 	const tasksDir = path.join(basePath, "tasks")
 
-	// Count task directories
+	// Count task directories - this is a fast O(1) readdir operation
 	let taskCount = 0
 	try {
 		const entries = await fs.readdir(tasksDir, { withFileTypes: true })
@@ -113,12 +61,7 @@ export async function calculateTaskStorageSize(
 		return defaultResult
 	}
 
-	// Calculate total size
-	const totalBytes = await getDirectorySize(tasksDir)
-
 	return {
-		totalBytes,
 		taskCount,
-		formattedSize: formatBytes(totalBytes),
 	}
 }
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index e51df56ef5d..f85582fc330 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -1,4 +1,4 @@
-import { HTMLAttributes, useState, useCallback, useEffect, useRef } from "react"
+import { HTMLAttributes, useState, useCallback, useEffect } from "react"
 import { useAppTranslation } from "@/i18n/TranslationContext"
 import { Trans } from "react-i18next"
 import {
@@ -11,7 +11,7 @@ import {
 	MessageCircle,
 	MessagesSquare,
 	RefreshCw,
-	HardDrive,
+	FolderOpen,
 	Loader2,
 } from "lucide-react"
 import { VSCodeCheckbox, VSCodeLink } from "@vscode/webview-ui-toolkit/react"
@@ -29,9 +29,7 @@ import { Section } from "./Section"
 import { SearchableSetting } from "./SearchableSetting"
 
 type TaskHistorySize = {
-	totalBytes: number
 	taskCount: number
-	formattedSize: string
 }
 
 type AboutProps = HTMLAttributes<HTMLDivElement> & {
@@ -58,7 +56,6 @@ export const About = ({
 	const { t } = useAppTranslation()
 	const [isRefreshing, setIsRefreshing] = useState(false)
 	const [cachedSize, setCachedSize] = useState<TaskHistorySize | undefined>(taskHistorySize)
-	const didRequestInitialSize = useRef(false)
 
 	// Update cached size when taskHistorySize changes and reset refreshing state
 	useEffect(() => {
@@ -68,34 +65,27 @@ export const About = ({
 		}
 	}, [taskHistorySize])
 
-	// Trigger initial task history size calculation when this tab mounts
-	useEffect(() => {
-		if (didRequestInitialSize.current) return
-		didRequestInitialSize.current = true
-		vscode.postMessage({ type: "refreshTaskHistorySize" })
-	}, [])
+	// NOTE: No auto-trigger on mount - user must click refresh button
+	// This is intentional for performance with large task counts (e.g., 9000+ tasks)
 
-	const handleRefreshStorageSize = useCallback(() => {
+	const handleRefreshTaskCount = useCallback(() => {
 		setIsRefreshing(true)
 		vscode.postMessage({ type: "refreshTaskHistorySize" })
 	}, [])
 
-	const getStorageDisplayText = (): string => {
-		// Use cached size if available, otherwise show "Calculating" only if no cached value
+	const getTaskCountDisplayText = (): string => {
+		// Use cached size if available, otherwise prompt user to click refresh
 		const displaySize = taskHistorySize || cachedSize
 		if (!displaySize) {
-			return t("settings:taskHistoryStorage.calculating")
+			return t("settings:taskHistoryStorage.clickToCount")
 		}
 		if (displaySize.taskCount === 0) {
 			return t("settings:taskHistoryStorage.empty")
 		}
 		if (displaySize.taskCount === 1) {
-			return t("settings:taskHistoryStorage.formatSingular", {
-				size: displaySize.formattedSize,
-			})
+			return t("settings:taskHistoryStorage.countSingular")
 		}
-		return t("settings:taskHistoryStorage.format", {
-			size: displaySize.formattedSize,
+		return t("settings:taskHistoryStorage.count", {
 			count: displaySize.taskCount,
 		})
 	}
@@ -237,19 +227,19 @@ export const About = ({
 				</SearchableSetting>
 
 				<SearchableSetting
-					settingId="about-task-history-storage"
+					settingId="about-task-history-count"
 					section="about"
 					label={t("settings:taskHistoryStorage.label")}
 					className="mt-4">
 					<div className="flex items-center gap-2">
-						<HardDrive className="size-4 text-vscode-descriptionForeground shrink-0" />
+						<FolderOpen className="size-4 text-vscode-descriptionForeground shrink-0" />
 						<span className="text-sm">
-							{t("settings:taskHistoryStorage.label")}: {getStorageDisplayText()}
+							{t("settings:taskHistoryStorage.label")}: {getTaskCountDisplayText()}
 						</span>
 						<Button
 							variant="ghost"
 							size="sm"
-							onClick={handleRefreshStorageSize}
+							onClick={handleRefreshTaskCount}
 							disabled={isRefreshing}
 							className="h-6 w-6 p-0"
 							title={t("settings:taskHistoryStorage.refresh")}>
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index 9720119c8af..73423516140 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -243,6 +243,20 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 		}
 	}, [settingsImportedAt, extensionState])
 
+	// Sync taskHistoryRetention from extensionState when it changes and the user
+	// hasn't made local changes yet. This handles the race condition where
+	// cachedState is initialized before the initial state message arrives.
+	useEffect(() => {
+		if (!isChangeDetected && extensionState.taskHistoryRetention !== undefined) {
+			setCachedState((prev) => {
+				if (prev.taskHistoryRetention === extensionState.taskHistoryRetention) {
+					return prev // No change needed
+				}
+				return { ...prev, taskHistoryRetention: extensionState.taskHistoryRetention }
+			})
+		}
+	}, [extensionState.taskHistoryRetention, isChangeDetected])
+
 	const setCachedStateField: SetCachedStateField<keyof ExtensionStateContextType> = useCallback((field, value) => {
 		setCachedState((prevState) => {
 			if (prevState[field] === value) {
diff --git a/webview-ui/src/i18n/locales/en/settings.json b/webview-ui/src/i18n/locales/en/settings.json
index a379414f513..6994f5fb912 100644
--- a/webview-ui/src/i18n/locales/en/settings.json
+++ b/webview-ui/src/i18n/locales/en/settings.json
@@ -919,13 +919,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Storage usage",
-		"calculating": "Calculating...",
-		"format": "{{size}} ({{count}} tasks)",
-		"formatSingular": "{{size}} (1 task)",
+		"label": "Task count",
+		"clickToCount": "Click refresh to count",
+		"count": "{{count}} tasks",
+		"countSingular": "1 task",
 		"empty": "No tasks stored",
-		"refresh": "Refresh",
-		"error": "Unable to calculate"
+		"refresh": "Count tasks"
 	},
 	"footer": {
 		"telemetry": {

From 1ee2ac9733e4572597dea424ed764eced63dc70b Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 14:13:50 -0700
Subject: [PATCH 27/37] chore: remove unnecessary backwards compat re-export

This PR was never merged, so no need for backwards compatibility.
Import formatBytes directly from its source file.
---
 src/utils/__tests__/task-storage-size.spec.ts | 4 ++--
 src/utils/task-storage-size.ts                | 4 ----
 2 files changed, 2 insertions(+), 6 deletions(-)

diff --git a/src/utils/__tests__/task-storage-size.spec.ts b/src/utils/__tests__/task-storage-size.spec.ts
index 5d1a3463474..f13922138aa 100644
--- a/src/utils/__tests__/task-storage-size.spec.ts
+++ b/src/utils/__tests__/task-storage-size.spec.ts
@@ -1,4 +1,5 @@
-import { calculateTaskStorageSize, formatBytes } from "../task-storage-size"
+import { calculateTaskStorageSize } from "../task-storage-size"
+import { formatBytes } from "../formatBytes"
 
 // Mock storage to avoid VS Code config access during tests
 vi.mock("../storage", () => ({
@@ -12,7 +13,6 @@ vi.mock("fs/promises", () => ({
 	readdir: (...args: unknown[]) => mockReaddir(...args),
 }))
 
-// formatBytes is still exported for backwards compatibility but not used by calculateTaskStorageSize
 describe("formatBytes", () => {
 	it("should format 0 bytes", () => {
 		expect(formatBytes(0)).toBe("0 B")
diff --git a/src/utils/task-storage-size.ts b/src/utils/task-storage-size.ts
index 91544b55335..46423c234f0 100644
--- a/src/utils/task-storage-size.ts
+++ b/src/utils/task-storage-size.ts
@@ -2,7 +2,6 @@ import * as path from "path"
 import * as fs from "fs/promises"
 
 import { getStorageBasePath } from "./storage"
-import { formatBytes } from "./formatBytes"
 
 /**
  * Result of counting task history items.
@@ -14,9 +13,6 @@ export interface TaskStorageSizeResult {
 	taskCount: number
 }
 
-// Re-export for backwards compatibility with existing imports/tests.
-export { formatBytes }
-
 /**
  * Counts the number of task directories in task history storage.
  *

From c9cb00eb4b5548daddd1a07a5a6920a6e006caa9 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 14:27:53 -0700
Subject: [PATCH 28/37] chore: remove unrelated formatBytes tests from
 task-storage-size

The formatBytes tests are not relevant since we no longer calculate size.
---
 src/utils/__tests__/task-storage-size.spec.ts | 39 -------------------
 1 file changed, 39 deletions(-)

diff --git a/src/utils/__tests__/task-storage-size.spec.ts b/src/utils/__tests__/task-storage-size.spec.ts
index f13922138aa..4ec7753be08 100644
--- a/src/utils/__tests__/task-storage-size.spec.ts
+++ b/src/utils/__tests__/task-storage-size.spec.ts
@@ -1,5 +1,4 @@
 import { calculateTaskStorageSize } from "../task-storage-size"
-import { formatBytes } from "../formatBytes"
 
 // Mock storage to avoid VS Code config access during tests
 vi.mock("../storage", () => ({
@@ -13,44 +12,6 @@ vi.mock("fs/promises", () => ({
 	readdir: (...args: unknown[]) => mockReaddir(...args),
 }))
 
-describe("formatBytes", () => {
-	it("should format 0 bytes", () => {
-		expect(formatBytes(0)).toBe("0 B")
-	})
-
-	it("should format bytes less than 1 KB", () => {
-		expect(formatBytes(512)).toBe("512 B")
-		expect(formatBytes(1)).toBe("1 B")
-	})
-
-	it("should format kilobytes (0 decimal places)", () => {
-		expect(formatBytes(1024)).toBe("1 KB")
-		expect(formatBytes(2048)).toBe("2 KB")
-		expect(formatBytes(1536)).toBe("2 KB") // Rounds to nearest integer
-		expect(formatBytes(1280)).toBe("1 KB") // Rounds down
-	})
-
-	it("should format megabytes (2 decimal places)", () => {
-		expect(formatBytes(1048576)).toBe("1.00 MB")
-		expect(formatBytes(1572864)).toBe("1.50 MB")
-		expect(formatBytes(10485760)).toBe("10.00 MB")
-	})
-
-	it("should format gigabytes (2 decimal places)", () => {
-		expect(formatBytes(1073741824)).toBe("1.00 GB")
-		expect(formatBytes(2147483648)).toBe("2.00 GB")
-	})
-
-	it("should format terabytes (2 decimal places)", () => {
-		expect(formatBytes(1099511627776)).toBe("1.00 TB")
-	})
-
-	it("should handle decimal precision correctly", () => {
-		expect(formatBytes(1234567)).toBe("1.18 MB")
-		expect(formatBytes(123456789)).toBe("117.74 MB")
-	})
-})
-
 describe("calculateTaskStorageSize", () => {
 	beforeEach(() => {
 		vi.clearAllMocks()

From 4c173af27536f17e2d386b9290fd0f62dce21064 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 15:12:53 -0700
Subject: [PATCH 29/37] fix: add taskHistoryRetention default to initial state
 to fix persistence race condition

---
 webview-ui/src/context/ExtensionStateContext.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/webview-ui/src/context/ExtensionStateContext.tsx b/webview-ui/src/context/ExtensionStateContext.tsx
index 26b3851c1be..72ce7677ca4 100644
--- a/webview-ui/src/context/ExtensionStateContext.tsx
+++ b/webview-ui/src/context/ExtensionStateContext.tsx
@@ -277,6 +277,7 @@ export const ExtensionStateContextProvider: React.FC<{ children: React.ReactNode
 		openRouterImageGenerationSelectedModel: "",
 		includeCurrentTime: true,
 		includeCurrentCost: true,
+		taskHistoryRetention: "never", // Default to never auto-delete
 	})
 
 	const [didHydrateState, setDidHydrateState] = useState(false)

From b5e3a3d898a8498304651c32e52cdfd8ef075fc6 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 15:32:36 -0700
Subject: [PATCH 30/37] perf: optimize task history retention purge with
 parallel processing

- Add parallel metadata reads with 50 concurrent operations
- Add parallel deletions with 10 concurrent operations
- Batch read all metadata first, then filter, then delete
- Reduce retry attempts from 3 to 1 (remove aggressive retries with sleeps)
- Extract helper functions for cleaner code (readTaskMetadata, pathExists, removeDir)

This significantly improves purge performance for users with many tasks (~9000+).
---
 src/utils/task-history-retention.ts | 366 ++++++++++++++++------------
 1 file changed, 204 insertions(+), 162 deletions(-)

diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index d59b979bd0b..6d17d5a6a20 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -2,6 +2,7 @@ import * as vscode from "vscode"
 import * as path from "path"
 import * as fs from "fs/promises"
 import type { Dirent } from "fs"
+import pLimit from "p-limit"
 
 import { TASK_HISTORY_RETENTION_OPTIONS, type TaskHistoryRetentionSetting } from "@roo-code/types"
 
@@ -16,8 +17,119 @@ export type PurgeResult = {
 	cutoff: number | null
 }
 
+/** Concurrency limit for parallel metadata reads */
+const METADATA_READ_CONCURRENCY = 50
+
+/** Concurrency limit for parallel task deletions */
+const DELETION_CONCURRENCY = 10
+
+/**
+ * Task metadata read result for batch processing
+ */
+interface TaskMetadata {
+	taskId: string
+	taskDir: string
+	ts: number | null
+	isOrphan: boolean
+	mtime: number | null
+}
+
+/**
+ * Read metadata for a single task directory.
+ * Returns null if the task directory should be skipped.
+ */
+async function readTaskMetadata(taskId: string, tasksDir: string): Promise<TaskMetadata | null> {
+	const taskDir = path.join(tasksDir, taskId)
+	const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+
+	let ts: number | null = null
+	let isOrphan = false
+	let mtime: number | null = null
+
+	// Try to read metadata file
+	try {
+		const raw = await fs.readFile(metadataPath, "utf8")
+		const meta: unknown = JSON.parse(raw)
+		const maybeTs = Number(
+			typeof meta === "object" && meta !== null && "ts" in meta ? (meta as { ts: unknown }).ts : undefined,
+		)
+		if (Number.isFinite(maybeTs)) {
+			ts = maybeTs
+		}
+	} catch {
+		// Missing or invalid metadata
+	}
+
+	// Check for orphan directories (checkpoint-only) - only if no valid timestamp
+	if (ts === null) {
+		try {
+			const childEntries = await fs.readdir(taskDir, { withFileTypes: true })
+			const visibleNames = childEntries.map((e) => e.name).filter((n) => !n.startsWith("."))
+			const hasCheckpointsDir = childEntries.some((e) => e.isDirectory() && e.name === "checkpoints")
+			const nonCheckpointVisible = visibleNames.filter((n) => n !== "checkpoints")
+			const hasMetadataFile = visibleNames.includes(GlobalFileNames.taskMetadata)
+			if (hasCheckpointsDir && nonCheckpointVisible.length === 0 && !hasMetadataFile) {
+				isOrphan = true
+			}
+		} catch {
+			// Ignore errors
+		}
+
+		// Get mtime as fallback for tasks without valid ts
+		if (!isOrphan) {
+			try {
+				const stat = await fs.stat(taskDir)
+				mtime = stat.mtime.getTime()
+			} catch {
+				// Can't stat - skip this task
+				return null
+			}
+		}
+	}
+
+	return { taskId, taskDir, ts, isOrphan, mtime }
+}
+
+/**
+ * Check if path exists
+ */
+async function pathExists(p: string): Promise<boolean> {
+	try {
+		await fs.access(p)
+		return true
+	} catch {
+		return false
+	}
+}
+
+/**
+ * Simplified directory removal - one attempt with fallback
+ * Removed aggressive retries and sleeps for performance
+ */
+async function removeDir(dir: string): Promise<boolean> {
+	// First attempt: standard recursive remove
+	try {
+		await fs.rm(dir, { recursive: true, force: true })
+	} catch {
+		// ignore
+	}
+
+	if (!(await pathExists(dir))) return true
+
+	// Fallback: try removing checkpoints first (common stubborn directory)
+	try {
+		await fs.rm(path.join(dir, "checkpoints"), { recursive: true, force: true })
+		await fs.rm(dir, { recursive: true, force: true })
+	} catch {
+		// ignore
+	}
+
+	return !(await pathExists(dir))
+}
+
 /**
  * Purge old task directories under <base>/tasks based on task_metadata.json ts value.
+ * Optimized for performance with parallel metadata reads and parallel deletions.
  * Executes best-effort deletes; errors are logged and skipped.
  *
  * @param retention Retention setting: "never" | "90" | "60" | "30" | "7" | "3" or number of days
@@ -44,7 +156,9 @@ export async function purgeOldTasks(
 	const logv = (msg: string) => {
 		if (verbose) log?.(msg)
 	}
-	logv(`[Retention] Starting purge with retention=${retention} (${days} day(s))${dryRun ? " (dry run)" : ""}`)
+	logv(
+		`[Retention] Starting optimized purge with retention=${retention} (${days} day(s))${dryRun ? " (dry run)" : ""}`,
+	)
 
 	let basePath: string
 
@@ -71,190 +185,118 @@ export async function purgeOldTasks(
 	}
 
 	const taskDirs = entries.filter((d) => d.isDirectory())
+	const totalTasks = taskDirs.length
 
-	logv(`[Retention] Found ${taskDirs.length} task director${taskDirs.length === 1 ? "y" : "ies"} under ${tasksDir}`)
-
-	// Small helpers
-	const pathExists = async (p: string): Promise<boolean> => {
-		try {
-			await fs.access(p)
-			return true
-		} catch {
-			return false
-		}
-	}
-
-	const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))
-
-	// Aggressive recursive remove with retries; also directly clears checkpoints if needed
-	const removeDirAggressive = async (dir: string): Promise<boolean> => {
-		// Try up to 3 passes with short delays
-		for (let attempt = 1; attempt <= 3; attempt++) {
-			try {
-				await fs.rm(dir, { recursive: true, force: true })
-			} catch {
-				// ignore and try more targeted cleanup below
-			}
-
-			// Verify
-			if (!(await pathExists(dir))) return true
-
-			// Targeted cleanup for stubborn checkpoint-only directories
-			try {
-				await fs.rm(path.join(dir, "checkpoints"), { recursive: true, force: true })
-			} catch {
-				// ignore
-			}
-
-			// Remove children one by one in case some FS impls struggle with rm -r
-			try {
-				const entries = await fs.readdir(dir, { withFileTypes: true })
-				for (const entry of entries) {
-					const entryPath = path.join(dir, entry.name)
-					try {
-						if (entry.isDirectory()) {
-							await fs.rm(entryPath, { recursive: true, force: true })
-						} else {
-							await fs.unlink(entryPath)
-						}
-					} catch {
-						// ignore individual failures; we'll retry the parent
-					}
-				}
-			} catch {
-				// ignore
-			}
-
-			// Final attempt this pass
-			try {
-				await fs.rm(dir, { recursive: true, force: true })
-			} catch {
-				// ignore
-			}
-
-			if (!(await pathExists(dir))) return true
+	logv(`[Retention] Found ${totalTasks} task director${totalTasks === 1 ? "y" : "ies"} under ${tasksDir}`)
 
-			// Backoff a bit before next attempt
-			await sleep(50 * attempt)
-		}
-
-		return !(await pathExists(dir))
+	if (totalTasks === 0) {
+		return { purgedCount: 0, cutoff }
 	}
 
-	const results: number[] = []
+	// Phase 1: Batch read all metadata in parallel
+	logv(`[Retention] Phase 1: Reading metadata for ${totalTasks} tasks (concurrency: ${METADATA_READ_CONCURRENCY})`)
+	const metadataLimit = pLimit(METADATA_READ_CONCURRENCY)
 
-	for (const d of taskDirs) {
-		const taskDir = path.join(tasksDir, d.name)
-		const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+	const metadataResults = await Promise.all(
+		taskDirs.map((d) => metadataLimit(() => readTaskMetadata(d.name, tasksDir))),
+	)
 
-		let ts: number | null = null
+	// Phase 2: Filter tasks that need deletion
+	const tasksToDelete: Array<{ metadata: TaskMetadata; reason: string }> = []
 
-		// First try to get a timestamp from task_metadata.json (if present)
-		try {
-			const raw = await fs.readFile(metadataPath, "utf8")
-			const meta: unknown = JSON.parse(raw)
-			const maybeTs = Number(
-				typeof meta === "object" && meta !== null && "ts" in meta ? (meta as { ts: unknown }).ts : undefined,
-			)
-			if (Number.isFinite(maybeTs)) {
-				ts = maybeTs
-			}
-		} catch {
-			// Missing or invalid metadata; we'll fall back to directory mtime.
-		}
+	for (const metadata of metadataResults) {
+		if (!metadata) continue
 
 		let shouldDelete = false
 		let reason = ""
 
-		// Check for checkpoint-only orphan directories (delete regardless of age)
-		try {
-			const childEntries = await fs.readdir(taskDir, { withFileTypes: true })
-			const visibleNames = childEntries.map((e) => e.name).filter((n) => !n.startsWith("."))
-			const hasCheckpointsDir = childEntries.some((e) => e.isDirectory() && e.name === "checkpoints")
-			const nonCheckpointVisible = visibleNames.filter((n) => n !== "checkpoints")
-			const hasMetadataFile = visibleNames.includes(GlobalFileNames.taskMetadata)
-			if (hasCheckpointsDir && nonCheckpointVisible.length === 0 && !hasMetadataFile) {
-				shouldDelete = true
-				reason = "orphan checkpoints_only"
-			}
-		} catch {
-			// Ignore errors while scanning children; proceed with normal logic
+		// Check orphan directories (delete regardless of age)
+		if (metadata.isOrphan) {
+			shouldDelete = true
+			reason = "orphan checkpoints_only"
 		}
-
-		if (!shouldDelete && ts !== null && ts < cutoff) {
-			// Normal case: metadata has a valid ts older than cutoff
+		// Check by timestamp
+		else if (metadata.ts !== null && metadata.ts < cutoff) {
 			shouldDelete = true
-			reason = `ts=${ts}`
-		} else if (!shouldDelete) {
-			// Orphan/legacy case: no valid ts; fall back to directory mtime
-			try {
-				const stat = await fs.stat(taskDir)
-				const mtimeMs = stat.mtime.getTime()
-				if (mtimeMs < cutoff) {
-					shouldDelete = true
-					reason = `no valid ts, mtime=${stat.mtime.toISOString()}`
-				}
-			} catch {
-				// If we can't stat the directory, skip it.
-			}
+			reason = `ts=${metadata.ts}`
 		}
-
-		if (!shouldDelete) {
-			results.push(0)
-			continue
+		// Check by mtime fallback
+		else if (metadata.ts === null && metadata.mtime !== null && metadata.mtime < cutoff) {
+			shouldDelete = true
+			reason = `no valid ts, mtime=${new Date(metadata.mtime).toISOString()}`
 		}
 
-		if (dryRun) {
-			logv(`[Retention][DRY RUN] Would delete task ${d.name} (${reason}) @ ${taskDir}`)
-			results.push(1)
-			continue
+		if (shouldDelete) {
+			tasksToDelete.push({ metadata, reason })
 		}
+	}
 
-		// Attempt deletion using provider callback (for full cleanup) or direct rm
-		let deletionError: unknown | null = null
-		let deleted = false
-		try {
-			if (deleteTaskById) {
-				logv(`[Retention] Deleting task ${d.name} via provider @ ${taskDir} (${reason})`)
-				await deleteTaskById(d.name, taskDir)
-				// Provider callback handles full cleanup; check if directory is gone
-				deleted = !(await pathExists(taskDir))
-			} else {
-				logv(`[Retention] Deleting task ${d.name} via fs.rm @ ${taskDir} (${reason})`)
-				await fs.rm(taskDir, { recursive: true, force: true })
-				deleted = !(await pathExists(taskDir))
-			}
-		} catch (e) {
-			deletionError = e
-		}
+	logv(`[Retention] Phase 2: ${tasksToDelete.length} of ${totalTasks} tasks marked for deletion`)
 
-		// If directory still exists after initial attempt, try aggressive cleanup with retries
-		if (!deleted) {
-			deleted = await removeDirAggressive(taskDir)
-		}
+	if (tasksToDelete.length === 0) {
+		log?.(`[Retention] No tasks met purge criteria${dryRun ? " (dry run)" : ""}`)
+		return { purgedCount: 0, cutoff }
+	}
 
-		if (!deleted) {
-			// Did not actually remove; report the most relevant error
-			if (deletionError) {
-				log?.(
-					`[Retention] Failed to delete task ${d.name} @ ${taskDir}: ${
-						deletionError instanceof Error ? deletionError.message : String(deletionError)
-					} (directory still present)`,
-				)
-			} else {
-				log?.(
-					`[Retention] Failed to delete task ${d.name} @ ${taskDir}: directory still present after cleanup attempts`,
-				)
-			}
-			results.push(0)
-			continue
+	// Phase 3: Delete tasks in parallel
+	if (dryRun) {
+		for (const { metadata, reason } of tasksToDelete) {
+			logv(`[Retention][DRY RUN] Would delete task ${metadata.taskId} (${reason}) @ ${metadata.taskDir}`)
 		}
-
-		logv(`[Retention] Deleted task ${d.name} (${reason}) @ ${taskDir}`)
-		results.push(1)
+		log?.(
+			`[Retention] Would purge ${tasksToDelete.length} task(s) (dry run); cutoff=${new Date(cutoff).toISOString()}`,
+		)
+		return { purgedCount: tasksToDelete.length, cutoff }
 	}
 
-	const purged = results.reduce<number>((sum, n) => sum + n, 0)
+	logv(`[Retention] Phase 3: Deleting ${tasksToDelete.length} tasks (concurrency: ${DELETION_CONCURRENCY})`)
+	const deleteLimit = pLimit(DELETION_CONCURRENCY)
+
+	const deleteResults = await Promise.all(
+		tasksToDelete.map(({ metadata, reason }) =>
+			deleteLimit(async (): Promise<boolean> => {
+				let deleted = false
+
+				try {
+					if (deleteTaskById) {
+						logv(
+							`[Retention] Deleting task ${metadata.taskId} via provider @ ${metadata.taskDir} (${reason})`,
+						)
+						await deleteTaskById(metadata.taskId, metadata.taskDir)
+						deleted = !(await pathExists(metadata.taskDir))
+					} else {
+						logv(`[Retention] Deleting task ${metadata.taskId} via fs.rm @ ${metadata.taskDir} (${reason})`)
+						await fs.rm(metadata.taskDir, { recursive: true, force: true })
+						deleted = !(await pathExists(metadata.taskDir))
+					}
+				} catch (e) {
+					// Primary deletion failed, try fallback
+					logv(
+						`[Retention] Primary deletion failed for ${metadata.taskId}: ${
+							e instanceof Error ? e.message : String(e)
+						}`,
+					)
+				}
+
+				// Fallback: simplified removal
+				if (!deleted) {
+					deleted = await removeDir(metadata.taskDir)
+				}
+
+				if (!deleted) {
+					log?.(
+						`[Retention] Failed to delete task ${metadata.taskId} @ ${metadata.taskDir}: directory still present`,
+					)
+				} else {
+					logv(`[Retention] Deleted task ${metadata.taskId} (${reason}) @ ${metadata.taskDir}`)
+				}
+
+				return deleted
+			}),
+		),
+	)
+
+	const purged = deleteResults.filter(Boolean).length
 
 	if (purged > 0) {
 		log?.(

From 19efb33e4d13b5ea4e32264ef778d6340b90a960 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 16:17:48 -0700
Subject: [PATCH 31/37] feat: add automatic checkpoint culling for inactive
 tasks

- Add purgeOldCheckpoints() function with hardcoded 30-day threshold
- Add startBackgroundCheckpointPurge() for fire-and-forget activation
- Culls only checkpoints/ subdirectory, preserves task history
- Runs silently on extension activation (no user notification)
- Coexists with existing taskHistoryRetention setting
- Add 6 new tests for checkpoint culling functionality
---
 src/__tests__/task-history-retention.spec.ts | 171 ++++++++++++++-
 src/extension.ts                             |   9 +-
 src/utils/task-history-retention.ts          | 211 +++++++++++++++++++
 3 files changed, 389 insertions(+), 2 deletions(-)

diff --git a/src/__tests__/task-history-retention.spec.ts b/src/__tests__/task-history-retention.spec.ts
index 0201c8fcc50..ced897697d6 100644
--- a/src/__tests__/task-history-retention.spec.ts
+++ b/src/__tests__/task-history-retention.spec.ts
@@ -10,7 +10,7 @@ vi.mock("../utils/storage", () => ({
 	getStorageBasePath: (p: string) => Promise.resolve(p),
 }))
 
-import { purgeOldTasks } from "../utils/task-history-retention"
+import { purgeOldTasks, purgeOldCheckpoints } from "../utils/task-history-retention"
 import { GlobalFileNames } from "../shared/globalFileNames"
 
 // Helpers
@@ -263,3 +263,172 @@ describe("utils/task-history-retention.ts purgeOldTasks()", () => {
 		}
 	})
 })
+
+// Helper to create task with checkpoints
+async function createTaskWithCheckpoints(
+	base: string,
+	id: string,
+	ts: number,
+): Promise<{ taskDir: string; checkpointsDir: string }> {
+	const taskDir = path.join(base, "tasks", id)
+	await fs.mkdir(taskDir, { recursive: true })
+	const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+	const metadata = JSON.stringify({ ts }, null, 2)
+	await fs.writeFile(metadataPath, metadata, "utf8")
+	const checkpointsDir = path.join(taskDir, "checkpoints")
+	await fs.mkdir(checkpointsDir, { recursive: true })
+	// Add some checkpoint content
+	await fs.writeFile(path.join(checkpointsDir, "checkpoint-1.json"), "{}", "utf8")
+	return { taskDir, checkpointsDir }
+}
+
+describe("utils/task-history-retention.ts purgeOldCheckpoints()", () => {
+	it("culls checkpoints from tasks older than 30 days", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Old task (31 days) - checkpoints should be culled
+			const old = await createTaskWithCheckpoints(base, "task-old", now - days(31))
+			// Recent task (29 days) - checkpoints should be kept
+			const recent = await createTaskWithCheckpoints(base, "task-recent", now - days(29))
+
+			const { culledCount } = await purgeOldCheckpoints(base, () => {}, false)
+
+			expect(culledCount).toBe(1)
+			// Old task checkpoints should be removed, but task dir should remain
+			expect(await exists(old.taskDir)).toBe(true)
+			expect(await exists(old.checkpointsDir)).toBe(false)
+			// Recent task should be completely intact
+			expect(await exists(recent.taskDir)).toBe(true)
+			expect(await exists(recent.checkpointsDir)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("does not delete checkpoints in dry run mode but reports count", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			const old = await createTaskWithCheckpoints(base, "task-old", now - days(31))
+
+			const { culledCount } = await purgeOldCheckpoints(base, () => {}, true)
+
+			expect(culledCount).toBe(1)
+			// In dry run, checkpoints should still exist
+			expect(await exists(old.checkpointsDir)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("skips tasks without checkpoints directory", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create an old task WITHOUT checkpoints
+			const taskDir = await createTask(base, "task-no-checkpoints", now - days(31))
+
+			const { culledCount } = await purgeOldCheckpoints(base, () => {}, false)
+
+			expect(culledCount).toBe(0)
+			// Task should be completely intact
+			expect(await exists(taskDir)).toBe(true)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("uses mtime fallback when no metadata timestamp", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create a task without metadata but with checkpoints
+			const taskDir = path.join(base, "tasks", "task-no-metadata")
+			await fs.mkdir(taskDir, { recursive: true })
+			const checkpointsDir = path.join(taskDir, "checkpoints")
+			await fs.mkdir(checkpointsDir, { recursive: true })
+			await fs.writeFile(path.join(checkpointsDir, "checkpoint.json"), "{}", "utf8")
+			// Set old mtime
+			const oldTime = new Date(now - days(31))
+			await fs.utimes(taskDir, oldTime, oldTime)
+
+			const { culledCount } = await purgeOldCheckpoints(base, () => {}, false)
+
+			expect(culledCount).toBe(1)
+			// Task dir should remain, checkpoints should be gone
+			expect(await exists(taskDir)).toBe(true)
+			expect(await exists(checkpointsDir)).toBe(false)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("always uses 30-day hardcoded cutoff", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Tasks at various ages around the 30-day boundary
+			const day29 = await createTaskWithCheckpoints(base, "task-29d", now - days(29))
+			const day30 = await createTaskWithCheckpoints(base, "task-30d", now - days(30))
+			const day31 = await createTaskWithCheckpoints(base, "task-31d", now - days(31))
+
+			const { culledCount, cutoff } = await purgeOldCheckpoints(base, () => {}, false)
+
+			// Check cutoff is approximately 30 days ago
+			const expectedCutoff = now - days(30)
+			expect(cutoff).toBeGreaterThan(expectedCutoff - 1000) // Allow 1 second margin
+			expect(cutoff).toBeLessThan(expectedCutoff + 1000)
+
+			// 29 day task should keep checkpoints (younger than 30 days)
+			expect(await exists(day29.checkpointsDir)).toBe(true)
+			// 30 and 31 day tasks should lose checkpoints (>= 30 days)
+			expect(await exists(day30.checkpointsDir)).toBe(false)
+			expect(await exists(day31.checkpointsDir)).toBe(false)
+			expect(culledCount).toBe(2)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+
+	it("preserves task metadata and other files when culling checkpoints", async () => {
+		const base = await mkTempBase()
+		try {
+			const now = Date.now()
+			const days = (n: number) => n * 24 * 60 * 60 * 1000
+
+			// Create task with checkpoints and other content
+			const taskDir = path.join(base, "tasks", "task-with-content")
+			await fs.mkdir(taskDir, { recursive: true })
+			const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+			await fs.writeFile(metadataPath, JSON.stringify({ ts: now - days(31) }), "utf8")
+			const checkpointsDir = path.join(taskDir, "checkpoints")
+			await fs.mkdir(checkpointsDir, { recursive: true })
+			await fs.writeFile(path.join(checkpointsDir, "checkpoint.json"), "{}", "utf8")
+			// Add conversation history
+			await fs.writeFile(path.join(taskDir, "conversation.json"), "[]", "utf8")
+
+			const { culledCount } = await purgeOldCheckpoints(base, () => {}, false)
+
+			expect(culledCount).toBe(1)
+			// Task dir and metadata should remain
+			expect(await exists(taskDir)).toBe(true)
+			expect(await exists(metadataPath)).toBe(true)
+			expect(await exists(path.join(taskDir, "conversation.json"))).toBe(true)
+			// Only checkpoints should be removed
+			expect(await exists(checkpointsDir)).toBe(false)
+		} finally {
+			await fs.rm(base, { recursive: true, force: true })
+		}
+	})
+})
diff --git a/src/extension.ts b/src/extension.ts
index b46145e5789..0d1af502836 100644
--- a/src/extension.ts
+++ b/src/extension.ts
@@ -44,7 +44,7 @@ import {
 } from "./activate"
 import { initializeI18n } from "./i18n"
 import { flushModels, initializeModelCacheRefresh, refreshModels } from "./api/providers/fetchers/modelCache"
-import { startBackgroundRetentionPurge } from "./utils/task-history-retention"
+import { startBackgroundRetentionPurge, startBackgroundCheckpointPurge } from "./utils/task-history-retention"
 import { TASK_HISTORY_RETENTION_OPTIONS, type TaskHistoryRetentionSetting } from "@roo-code/types"
 
 /**
@@ -410,6 +410,13 @@ export async function activate(context: vscode.ExtensionContext) {
 		})
 	}
 
+	// Checkpoint culling (runs in background after activation)
+	// Automatically removes checkpoints from tasks not touched in 30 days (non-configurable)
+	startBackgroundCheckpointPurge({
+		globalStoragePath: contextProxy.globalStorageUri.fsPath,
+		log: (m) => outputChannel.appendLine(m),
+	})
+
 	// Implements the `RooCodeAPI` interface.
 	const socketPath = process.env.ROO_CODE_IPC_SOCKET_PATH
 	const enableLogging = typeof socketPath === "string"
diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 6d17d5a6a20..461a3b63a1b 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -17,12 +17,20 @@ export type PurgeResult = {
 	cutoff: number | null
 }
 
+export type CheckpointPurgeResult = {
+	culledCount: number
+	cutoff: number
+}
+
 /** Concurrency limit for parallel metadata reads */
 const METADATA_READ_CONCURRENCY = 50
 
 /** Concurrency limit for parallel task deletions */
 const DELETION_CONCURRENCY = 10
 
+/** Hardcoded checkpoint retention: 30 days */
+const CHECKPOINT_RETENTION_DAYS = 30
+
 /**
  * Task metadata read result for batch processing
  */
@@ -388,3 +396,206 @@ export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions):
 		}
 	})()
 }
+
+/**
+ * Metadata result for checkpoint culling - simplified from TaskMetadata
+ */
+interface CheckpointTaskMetadata {
+	taskId: string
+	taskDir: string
+	checkpointsDir: string
+	lastActivity: number | null // ts or mtime
+}
+
+/**
+ * Read metadata for checkpoint culling - only needs task age, not orphan detection
+ */
+async function readCheckpointTaskMetadata(taskId: string, tasksDir: string): Promise<CheckpointTaskMetadata | null> {
+	const taskDir = path.join(tasksDir, taskId)
+	const checkpointsDir = path.join(taskDir, "checkpoints")
+
+	// First check if checkpoints directory exists
+	if (!(await pathExists(checkpointsDir))) {
+		return null // No checkpoints to cull
+	}
+
+	const metadataPath = path.join(taskDir, GlobalFileNames.taskMetadata)
+	let lastActivity: number | null = null
+
+	// Try to read timestamp from metadata file
+	try {
+		const raw = await fs.readFile(metadataPath, "utf8")
+		const meta: unknown = JSON.parse(raw)
+		const maybeTs = Number(
+			typeof meta === "object" && meta !== null && "ts" in meta ? (meta as { ts: unknown }).ts : undefined,
+		)
+		if (Number.isFinite(maybeTs)) {
+			lastActivity = maybeTs
+		}
+	} catch {
+		// Missing or invalid metadata
+	}
+
+	// Fallback to mtime if no valid ts
+	if (lastActivity === null) {
+		try {
+			const stat = await fs.stat(taskDir)
+			lastActivity = stat.mtime.getTime()
+		} catch {
+			// Can't determine age - skip this task
+			return null
+		}
+	}
+
+	return { taskId, taskDir, checkpointsDir, lastActivity }
+}
+
+/**
+ * Cull checkpoints from tasks that haven't been touched in CHECKPOINT_RETENTION_DAYS.
+ * This is a non-configurable, always-on feature that removes only the checkpoints/
+ * subdirectory while preserving the task itself (conversation history, metadata).
+ *
+ * @param globalStoragePath VS Code global storage fsPath
+ * @param log Optional logger
+ * @param dryRun When true, logs which checkpoints would be deleted but does not delete
+ * @returns CheckpointPurgeResult with count and cutoff used
+ */
+export async function purgeOldCheckpoints(
+	globalStoragePath: string,
+	log?: (message: string) => void,
+	dryRun: boolean = false,
+): Promise<CheckpointPurgeResult> {
+	const cutoff = Date.now() - CHECKPOINT_RETENTION_DAYS * 24 * 60 * 60 * 1000
+
+	log?.(`[Checkpoints] Starting checkpoint cull (${CHECKPOINT_RETENTION_DAYS} days)${dryRun ? " (dry run)" : ""}`)
+
+	let basePath: string
+
+	try {
+		basePath = await getStorageBasePath(globalStoragePath)
+	} catch (e) {
+		log?.(`[Checkpoints] Failed to resolve storage base path: ${e instanceof Error ? e.message : String(e)}`)
+		return { culledCount: 0, cutoff }
+	}
+
+	const tasksDir = path.join(basePath, "tasks")
+
+	let entries: Dirent[]
+	try {
+		entries = await fs.readdir(tasksDir, { withFileTypes: true })
+	} catch {
+		// No tasks directory yet or unreadable
+		log?.(`[Checkpoints] Tasks directory not found or unreadable`)
+		return { culledCount: 0, cutoff }
+	}
+
+	const taskDirs = entries.filter((d) => d.isDirectory())
+	const totalTasks = taskDirs.length
+
+	if (totalTasks === 0) {
+		return { culledCount: 0, cutoff }
+	}
+
+	// Phase 1: Read metadata for all tasks with checkpoints
+	const metadataLimit = pLimit(METADATA_READ_CONCURRENCY)
+	const metadataResults = await Promise.all(
+		taskDirs.map((d) => metadataLimit(() => readCheckpointTaskMetadata(d.name, tasksDir))),
+	)
+
+	// Phase 2: Filter tasks with checkpoints that need culling
+	const tasksToCull: CheckpointTaskMetadata[] = []
+
+	for (const metadata of metadataResults) {
+		if (!metadata) continue
+
+		// Check if task is older than cutoff
+		if (metadata.lastActivity !== null && metadata.lastActivity < cutoff) {
+			tasksToCull.push(metadata)
+		}
+	}
+
+	if (tasksToCull.length === 0) {
+		log?.(`[Checkpoints] No checkpoints met cull criteria`)
+		return { culledCount: 0, cutoff }
+	}
+
+	// Dry run mode
+	if (dryRun) {
+		for (const metadata of tasksToCull) {
+			log?.(
+				`[Checkpoints][DRY RUN] Would cull checkpoints for task ${metadata.taskId} (last activity: ${new Date(metadata.lastActivity!).toISOString()})`,
+			)
+		}
+		log?.(`[Checkpoints] Would cull checkpoints from ${tasksToCull.length} task(s) (dry run)`)
+		return { culledCount: tasksToCull.length, cutoff }
+	}
+
+	// Phase 3: Delete checkpoints directories in parallel
+	const deleteLimit = pLimit(DELETION_CONCURRENCY)
+	const deleteResults = await Promise.all(
+		tasksToCull.map((metadata) =>
+			deleteLimit(async (): Promise<boolean> => {
+				try {
+					await fs.rm(metadata.checkpointsDir, { recursive: true, force: true })
+					const stillExists = await pathExists(metadata.checkpointsDir)
+					if (!stillExists) {
+						return true
+					}
+				} catch {
+					// Ignore errors
+				}
+				return false
+			}),
+		),
+	)
+
+	const culled = deleteResults.filter(Boolean).length
+
+	if (culled > 0) {
+		log?.(`[Checkpoints] Culled checkpoints from ${culled} task(s); cutoff=${new Date(cutoff).toISOString()}`)
+	}
+
+	return { culledCount: culled, cutoff }
+}
+
+/**
+ * Options for starting the background checkpoint purge.
+ */
+export interface BackgroundCheckpointPurgeOptions {
+	/** VS Code global storage fsPath */
+	globalStoragePath: string
+	/** Logger function */
+	log: (message: string) => void
+}
+
+/**
+ * Starts the checkpoint culling in the background.
+ * This function is designed to be called after extension activation completes,
+ * using a fire-and-forget pattern (void) to avoid blocking activation.
+ *
+ * Checkpoints are culled from tasks that haven't been touched in 30 days.
+ * This is non-configurable and always runs.
+ *
+ * @param options Configuration options for the background checkpoint purge
+ */
+export function startBackgroundCheckpointPurge(options: BackgroundCheckpointPurgeOptions): void {
+	const { globalStoragePath, log } = options
+
+	void (async () => {
+		try {
+			log(`[Checkpoints] Starting background checkpoint cull (${CHECKPOINT_RETENTION_DAYS} days)`)
+
+			const result = await purgeOldCheckpoints(globalStoragePath, log, false)
+
+			log(
+				`[Checkpoints] Background checkpoint cull complete: culled=${result.culledCount}, cutoff=${new Date(result.cutoff).toISOString()}`,
+			)
+
+			// No user notification - silent operation as requested
+		} catch (error) {
+			log(
+				`[Checkpoints] Failed during background checkpoint cull: ${error instanceof Error ? error.message : String(error)}`,
+			)
+		}
+	})()
+}

From 0540d2711b32309b11ed5b53b3b7be91ce0c8718 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 16:26:23 -0700
Subject: [PATCH 32/37] fix: simplify retention purge notification - remove
 non-working View Settings button

---
 src/utils/task-history-retention.ts | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 461a3b63a1b..c838f22f0b4 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -381,15 +381,7 @@ export function startBackgroundRetentionPurge(options: BackgroundPurgeOptions):
 					days: retention,
 				})
 
-				const viewSettingsLabel = t("common:taskHistoryRetention.actions.viewSettings")
-				const dismissLabel = t("common:taskHistoryRetention.actions.dismiss")
-
-				vscode.window.showInformationMessage(message, viewSettingsLabel, dismissLabel).then((action) => {
-					if (action === viewSettingsLabel) {
-						// Navigate to Roo Code settings About tab
-						vscode.commands.executeCommand("roo-cline.settingsButtonClicked", "about")
-					}
-				})
+				vscode.window.showInformationMessage(message)
 			}
 		} catch (error) {
 			log(`[Retention] Failed during background purge: ${error instanceof Error ? error.message : String(error)}`)

From 69b6ba5712bdab3ac723bbf27a22246f04d7c0f5 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 16:42:12 -0700
Subject: [PATCH 33/37] feat: add progress logging to checkpoint culling

- Log number of tasks being scanned
- Log how many tasks have checkpoints
- Log how many need culling (older than 30 days)
- Log progress every 100 deletions during large culls
---
 src/utils/task-history-retention.ts | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index c838f22f0b4..824c2d28f06 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -485,15 +485,22 @@ export async function purgeOldCheckpoints(
 	const totalTasks = taskDirs.length
 
 	if (totalTasks === 0) {
+		log?.(`[Checkpoints] No tasks found`)
 		return { culledCount: 0, cutoff }
 	}
 
+	log?.(`[Checkpoints] Scanning ${totalTasks} tasks for old checkpoints...`)
+
 	// Phase 1: Read metadata for all tasks with checkpoints
 	const metadataLimit = pLimit(METADATA_READ_CONCURRENCY)
 	const metadataResults = await Promise.all(
 		taskDirs.map((d) => metadataLimit(() => readCheckpointTaskMetadata(d.name, tasksDir))),
 	)
 
+	// Count tasks that have checkpoints
+	const tasksWithCheckpoints = metadataResults.filter((m) => m !== null).length
+	log?.(`[Checkpoints] Found ${tasksWithCheckpoints} tasks with checkpoints`)
+
 	// Phase 2: Filter tasks with checkpoints that need culling
 	const tasksToCull: CheckpointTaskMetadata[] = []
 
@@ -507,10 +514,12 @@ export async function purgeOldCheckpoints(
 	}
 
 	if (tasksToCull.length === 0) {
-		log?.(`[Checkpoints] No checkpoints met cull criteria`)
+		log?.(`[Checkpoints] No checkpoints older than 30 days`)
 		return { culledCount: 0, cutoff }
 	}
 
+	log?.(`[Checkpoints] ${tasksToCull.length} tasks have checkpoints older than 30 days`)
+
 	// Dry run mode
 	if (dryRun) {
 		for (const metadata of tasksToCull) {
@@ -523,7 +532,10 @@ export async function purgeOldCheckpoints(
 	}
 
 	// Phase 3: Delete checkpoints directories in parallel
+	log?.(`[Checkpoints] Deleting checkpoints from ${tasksToCull.length} tasks...`)
 	const deleteLimit = pLimit(DELETION_CONCURRENCY)
+	let deletedCount = 0
+
 	const deleteResults = await Promise.all(
 		tasksToCull.map((metadata) =>
 			deleteLimit(async (): Promise<boolean> => {
@@ -531,6 +543,11 @@ export async function purgeOldCheckpoints(
 					await fs.rm(metadata.checkpointsDir, { recursive: true, force: true })
 					const stillExists = await pathExists(metadata.checkpointsDir)
 					if (!stillExists) {
+						deletedCount++
+						// Log progress every 100 deletions
+						if (deletedCount % 100 === 0) {
+							log?.(`[Checkpoints] Progress: ${deletedCount}/${tasksToCull.length} deleted`)
+						}
 						return true
 					}
 				} catch {
@@ -544,7 +561,7 @@ export async function purgeOldCheckpoints(
 	const culled = deleteResults.filter(Boolean).length
 
 	if (culled > 0) {
-		log?.(`[Checkpoints] Culled checkpoints from ${culled} task(s); cutoff=${new Date(cutoff).toISOString()}`)
+		log?.(`[Checkpoints] Culled checkpoints from ${culled} task(s)`)
 	}
 
 	return { culledCount: culled, cutoff }

From 739f6c1989ae101803d496304379f5328412e758 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 17:08:56 -0700
Subject: [PATCH 34/37] feat(history): move retention settings to history view
 with gear icon popover

- Add Settings gear icon in HistoryView header with popover for retention settings
- Retention dropdown allows configuring auto-delete task history (never, 3-90 days)
- Settings are saved immediately via vscode.postMessage updateSettings
- Remove retention settings from About.tsx (Settings View)
- Update About.tsx props and tests to remove taskHistoryRetention
---
 src/__tests__/extension.spec.ts               |  1 +
 .../src/components/history/HistoryView.tsx    | 98 ++++++++++++++++---
 webview-ui/src/components/settings/About.tsx  | 39 +-------
 .../src/components/settings/SettingsView.tsx  |  2 -
 .../settings/__tests__/About.spec.tsx         |  2 -
 5 files changed, 86 insertions(+), 56 deletions(-)

diff --git a/src/__tests__/extension.spec.ts b/src/__tests__/extension.spec.ts
index 1803eb4d367..31e72e66483 100644
--- a/src/__tests__/extension.spec.ts
+++ b/src/__tests__/extension.spec.ts
@@ -162,6 +162,7 @@ vi.mock("../utils/autoImportSettings", () => ({
 // Avoid filesystem access during activation by stubbing background purge
 vi.mock("../utils/task-history-retention", () => ({
 	startBackgroundRetentionPurge: vi.fn(),
+	startBackgroundCheckpointPurge: vi.fn(),
 }))
 
 // Ensure storage base path resolves to provided path to avoid touching VS Code config
diff --git a/webview-ui/src/components/history/HistoryView.tsx b/webview-ui/src/components/history/HistoryView.tsx
index 88b65518812..fb621f5ec0e 100644
--- a/webview-ui/src/components/history/HistoryView.tsx
+++ b/webview-ui/src/components/history/HistoryView.tsx
@@ -1,14 +1,21 @@
 import React, { memo, useState, useMemo } from "react"
-import { ArrowLeft } from "lucide-react"
+import { ArrowLeft, Settings } from "lucide-react"
 import { DeleteTaskDialog } from "./DeleteTaskDialog"
 import { BatchDeleteTaskDialog } from "./BatchDeleteTaskDialog"
 import { Virtuoso } from "react-virtuoso"
 
+import { TASK_HISTORY_RETENTION_OPTIONS, type TaskHistoryRetentionSetting } from "@roo-code/types"
+
 import { VSCodeTextField } from "@vscode/webview-ui-toolkit/react"
 
+import { vscode } from "@/utils/vscode"
+import { useExtensionState } from "@/context/ExtensionStateContext"
 import {
 	Button,
 	Checkbox,
+	Popover,
+	PopoverContent,
+	PopoverTrigger,
 	Select,
 	SelectContent,
 	SelectItem,
@@ -41,6 +48,7 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 		showAllWorkspaces,
 		setShowAllWorkspaces,
 	} = useTaskSearch()
+	const { taskHistoryRetention } = useExtensionState()
 	const { t } = useAppTranslation()
 
 	// Use grouped tasks hook
@@ -51,6 +59,19 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 	const [isSelectionMode, setIsSelectionMode] = useState(false)
 	const [selectedTaskIds, setSelectedTaskIds] = useState<string[]>([])
 	const [showBatchDeleteDialog, setShowBatchDeleteDialog] = useState<boolean>(false)
+	const [isRetentionPopoverOpen, setIsRetentionPopoverOpen] = useState(false)
+
+	// Normalize retention setting to ensure it's valid
+	const normalizedRetention: TaskHistoryRetentionSetting = TASK_HISTORY_RETENTION_OPTIONS.includes(
+		taskHistoryRetention as TaskHistoryRetentionSetting,
+	)
+		? (taskHistoryRetention as TaskHistoryRetentionSetting)
+		: "never"
+
+	// Handle retention setting change
+	const handleRetentionChange = (value: TaskHistoryRetentionSetting) => {
+		vscode.postMessage({ type: "updateSettings", updatedSettings: { taskHistoryRetention: value } })
+	}
 
 	// Get subtask count for a task
 	const getSubtaskCount = useMemo(() => {
@@ -116,20 +137,67 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 						</Button>
 						<h3 className="text-vscode-foreground m-0">{t("history:history")}</h3>
 					</div>
-					<StandardTooltip
-						content={
-							isSelectionMode ? `${t("history:exitSelectionMode")}` : `${t("history:enterSelectionMode")}`
-						}>
-						<Button
-							variant={isSelectionMode ? "primary" : "secondary"}
-							onClick={toggleSelectionMode}
-							data-testid="toggle-selection-mode-button">
-							<span
-								className={`codicon ${isSelectionMode ? "codicon-check-all" : "codicon-checklist"} mr-1`}
-							/>
-							{isSelectionMode ? t("history:exitSelection") : t("history:selectionMode")}
-						</Button>
-					</StandardTooltip>
+					<div className="flex items-center gap-2">
+						<Popover open={isRetentionPopoverOpen} onOpenChange={setIsRetentionPopoverOpen}>
+							<StandardTooltip content={t("settings:aboutRetention.label")}>
+								<PopoverTrigger asChild>
+									<Button variant="ghost" size="icon" data-testid="history-retention-settings-button">
+										<Settings className="size-4" />
+									</Button>
+								</PopoverTrigger>
+							</StandardTooltip>
+							<PopoverContent className="w-72" align="end">
+								<div className="space-y-3">
+									<h4 className="font-medium text-sm">{t("settings:aboutRetention.label")}</h4>
+									<Select
+										value={normalizedRetention}
+										onValueChange={(value: TaskHistoryRetentionSetting) => {
+											handleRetentionChange(value)
+										}}>
+										<SelectTrigger className="w-full">
+											<SelectValue placeholder={t("settings:common.select")} />
+										</SelectTrigger>
+										<SelectContent>
+											<SelectItem value="never">
+												{t("settings:aboutRetention.options.never")}
+											</SelectItem>
+											<SelectItem value="90">
+												{t("settings:aboutRetention.options.90")}
+											</SelectItem>
+											<SelectItem value="60">
+												{t("settings:aboutRetention.options.60")}
+											</SelectItem>
+											<SelectItem value="30">
+												{t("settings:aboutRetention.options.30")}
+											</SelectItem>
+											<SelectItem value="7">{t("settings:aboutRetention.options.7")}</SelectItem>
+											<SelectItem value="3">{t("settings:aboutRetention.options.3")}</SelectItem>
+										</SelectContent>
+									</Select>
+									<p className="text-vscode-descriptionForeground text-xs">
+										{t("settings:aboutRetention.description")}
+									</p>
+									<p className="text-red-500 text-xs">{t("settings:aboutRetention.warning")}</p>
+								</div>
+							</PopoverContent>
+						</Popover>
+						<StandardTooltip
+							content={
+								isSelectionMode
+									? `${t("history:exitSelectionMode")}`
+									: `${t("history:enterSelectionMode")}`
+							}>
+							<Button
+								variant={isSelectionMode ? "primary" : "secondary"}
+								onClick={toggleSelectionMode}
+								data-testid="toggle-selection-mode-button">
+								<span
+									className={`codicon ${isSelectionMode ? "codicon-check-all" : "codicon-checklist"} mr-1`}
+								/>
+								{isSelectionMode ? t("history:exitSelection") : t("history:selectionMode")}
+							</Button>
+						</StandardTooltip>
+					</div>
 				</div>
 				<div className="flex flex-col gap-2">
 					<VSCodeTextField
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index f85582fc330..c5345f8da1e 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -16,13 +16,13 @@ import {
 } from "lucide-react"
 import { VSCodeCheckbox, VSCodeLink } from "@vscode/webview-ui-toolkit/react"
 
-import type { TelemetrySetting, TaskHistoryRetentionSetting } from "@roo-code/types"
+import type { TelemetrySetting } from "@roo-code/types"
 
 import { Package } from "@roo/package"
 
 import { vscode } from "@/utils/vscode"
 import { cn } from "@/lib/utils"
-import { Button, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui"
+import { Button } from "@/components/ui"
 
 import { SectionHeader } from "./SectionHeader"
 import { Section } from "./Section"
@@ -37,8 +37,6 @@ type AboutProps = HTMLAttributes<HTMLDivElement> & {
 	setTelemetrySetting: (setting: TelemetrySetting) => void
 	debug?: boolean
 	setDebug?: (debug: boolean) => void
-	taskHistoryRetention: TaskHistoryRetentionSetting
-	setTaskHistoryRetention: (value: TaskHistoryRetentionSetting) => void
 	taskHistorySize?: TaskHistorySize
 }
 
@@ -47,8 +45,6 @@ export const About = ({
 	setTelemetrySetting,
 	debug,
 	setDebug,
-	taskHistoryRetention,
-	setTaskHistoryRetention,
 	taskHistorySize,
 	className,
 	...props
@@ -195,37 +191,6 @@ export const About = ({
 			</Section>
 
 			<Section className="space-y-0">
-				<SearchableSetting
-					settingId="about-task-history-retention"
-					section="about"
-					label={t("settings:aboutRetention.label")}
-					className="mt-4">
-					<h3>{t("settings:aboutRetention.label")}</h3>
-					<div className="mt-2">
-						<Select
-							value={taskHistoryRetention}
-							onValueChange={(value: TaskHistoryRetentionSetting) => {
-								setTaskHistoryRetention(value)
-							}}>
-							<SelectTrigger className="w-64">
-								<SelectValue placeholder={t("settings:common.select")} />
-							</SelectTrigger>
-							<SelectContent>
-								<SelectItem value="never">{t("settings:aboutRetention.options.never")}</SelectItem>
-								<SelectItem value="90">{t("settings:aboutRetention.options.90")}</SelectItem>
-								<SelectItem value="60">{t("settings:aboutRetention.options.60")}</SelectItem>
-								<SelectItem value="30">{t("settings:aboutRetention.options.30")}</SelectItem>
-								<SelectItem value="7">{t("settings:aboutRetention.options.7")}</SelectItem>
-								<SelectItem value="3">{t("settings:aboutRetention.options.3")}</SelectItem>
-							</SelectContent>
-						</Select>
-						<div className="text-vscode-descriptionForeground text-sm mt-1">
-							{t("settings:aboutRetention.description")}
-						</div>
-						<div className="text-red-500 text-sm mt-1">{t("settings:aboutRetention.warning")}</div>
-					</div>
-				</SearchableSetting>
-
 				<SearchableSetting
 					settingId="about-task-history-count"
 					section="about"
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index 73423516140..c235149356a 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -974,8 +974,6 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 								setTelemetrySetting={setTelemetrySetting}
 								debug={cachedState.debug}
 								setDebug={setDebug}
-								taskHistoryRetention={normalizedTaskHistoryRetention}
-								setTaskHistoryRetention={(value) => setCachedStateField("taskHistoryRetention", value)}
 								taskHistorySize={taskHistorySize}
 							/>
 						)}
diff --git a/webview-ui/src/components/settings/__tests__/About.spec.tsx b/webview-ui/src/components/settings/__tests__/About.spec.tsx
index 92791b4ac53..b62b7c13581 100644
--- a/webview-ui/src/components/settings/__tests__/About.spec.tsx
+++ b/webview-ui/src/components/settings/__tests__/About.spec.tsx
@@ -31,8 +31,6 @@ describe("About", () => {
 	const defaultProps: ComponentProps<typeof About> = {
 		telemetrySetting: "enabled" as const,
 		setTelemetrySetting: vi.fn(),
-		taskHistoryRetention: "never",
-		setTaskHistoryRetention: vi.fn(),
 	}
 
 	beforeEach(() => {

From fea999b3b5d7175a61cff08fe47996fe4a136dac Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 18:11:45 -0700
Subject: [PATCH 35/37] feat: improve retention UX with confirmation dialog and
 friendly messaging

- Add confirmation dialog before changing retention settings to prevent accidental changes
- Move task count display from About tab to History View settings popover
- Combine redundant description/warning into single, clear warning message
- Update task count display to be more human-friendly ('X tasks in history')
- Update all 18 locale files with consistent messaging
- Revert About.tsx to original state (no retention UI there)
---
 .../src/components/history/HistoryView.tsx    | 125 ++++++++++++++++--
 webview-ui/src/components/settings/About.tsx  |  95 +------------
 .../src/components/settings/SettingsView.tsx  |   4 -
 webview-ui/src/i18n/locales/ca/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/de/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/en/settings.json  |  25 ++--
 webview-ui/src/i18n/locales/es/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/fr/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/hi/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/id/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/it/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/ja/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/ko/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/nl/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/pl/settings.json  |  26 ++--
 .../src/i18n/locales/pt-BR/settings.json      |  26 ++--
 webview-ui/src/i18n/locales/ru/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/tr/settings.json  |  26 ++--
 webview-ui/src/i18n/locales/vi/settings.json  |  26 ++--
 .../src/i18n/locales/zh-CN/settings.json      |  26 ++--
 .../src/i18n/locales/zh-TW/settings.json      |  26 ++--
 21 files changed, 409 insertions(+), 282 deletions(-)

diff --git a/webview-ui/src/components/history/HistoryView.tsx b/webview-ui/src/components/history/HistoryView.tsx
index fb621f5ec0e..eba11ce581c 100644
--- a/webview-ui/src/components/history/HistoryView.tsx
+++ b/webview-ui/src/components/history/HistoryView.tsx
@@ -1,5 +1,5 @@
-import React, { memo, useState, useMemo } from "react"
-import { ArrowLeft, Settings } from "lucide-react"
+import React, { memo, useState, useMemo, useCallback, useEffect } from "react"
+import { ArrowLeft, Settings, FolderOpen, RefreshCw, Loader2 } from "lucide-react"
 import { DeleteTaskDialog } from "./DeleteTaskDialog"
 import { BatchDeleteTaskDialog } from "./BatchDeleteTaskDialog"
 import { Virtuoso } from "react-virtuoso"
@@ -11,6 +11,14 @@ import { VSCodeTextField } from "@vscode/webview-ui-toolkit/react"
 import { vscode } from "@/utils/vscode"
 import { useExtensionState } from "@/context/ExtensionStateContext"
 import {
+	AlertDialog,
+	AlertDialogAction,
+	AlertDialogCancel,
+	AlertDialogContent,
+	AlertDialogDescription,
+	AlertDialogFooter,
+	AlertDialogHeader,
+	AlertDialogTitle,
 	Button,
 	Checkbox,
 	Popover,
@@ -48,7 +56,7 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 		showAllWorkspaces,
 		setShowAllWorkspaces,
 	} = useTaskSearch()
-	const { taskHistoryRetention } = useExtensionState()
+	const { taskHistoryRetention, taskHistorySize } = useExtensionState()
 	const { t } = useAppTranslation()
 
 	// Use grouped tasks hook
@@ -60,6 +68,39 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 	const [selectedTaskIds, setSelectedTaskIds] = useState<string[]>([])
 	const [showBatchDeleteDialog, setShowBatchDeleteDialog] = useState<boolean>(false)
 	const [isRetentionPopoverOpen, setIsRetentionPopoverOpen] = useState(false)
+	const [pendingRetention, setPendingRetention] = useState<TaskHistoryRetentionSetting | null>(null)
+	const [showRetentionConfirmDialog, setShowRetentionConfirmDialog] = useState(false)
+	const [isRefreshingTaskCount, setIsRefreshingTaskCount] = useState(false)
+	const [cachedTaskCount, setCachedTaskCount] = useState<number | undefined>(taskHistorySize?.taskCount)
+
+	// Update cached task count when taskHistorySize changes
+	useEffect(() => {
+		if (taskHistorySize) {
+			setCachedTaskCount(taskHistorySize.taskCount)
+			setIsRefreshingTaskCount(false)
+		}
+	}, [taskHistorySize])
+
+	// Handle refresh task count
+	const handleRefreshTaskCount = useCallback(() => {
+		setIsRefreshingTaskCount(true)
+		vscode.postMessage({ type: "refreshTaskHistorySize" })
+	}, [])
+
+	// Get task count display text
+	const getTaskCountDisplayText = (): string => {
+		const count = taskHistorySize?.taskCount ?? cachedTaskCount
+		if (count === undefined) {
+			return t("settings:taskHistoryStorage.clickToCount")
+		}
+		if (count === 0) {
+			return t("settings:taskHistoryStorage.empty")
+		}
+		if (count === 1) {
+			return t("settings:taskHistoryStorage.countSingular")
+		}
+		return t("settings:taskHistoryStorage.count", { count })
+	}
 
 	// Normalize retention setting to ensure it's valid
 	const normalizedRetention: TaskHistoryRetentionSetting = TASK_HISTORY_RETENTION_OPTIONS.includes(
@@ -68,9 +109,31 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 		? (taskHistoryRetention as TaskHistoryRetentionSetting)
 		: "never"
 
-	// Handle retention setting change
+	// Handle retention setting change - show confirmation dialog first
 	const handleRetentionChange = (value: TaskHistoryRetentionSetting) => {
-		vscode.postMessage({ type: "updateSettings", updatedSettings: { taskHistoryRetention: value } })
+		// If selecting the same value, do nothing
+		if (value === normalizedRetention) {
+			return
+		}
+		// Show confirmation dialog for any change
+		setPendingRetention(value)
+		setShowRetentionConfirmDialog(true)
+	}
+
+	// Confirm retention change
+	const confirmRetentionChange = () => {
+		if (pendingRetention !== null) {
+			vscode.postMessage({ type: "updateSettings", updatedSettings: { taskHistoryRetention: pendingRetention } })
+		}
+		setShowRetentionConfirmDialog(false)
+		setPendingRetention(null)
+		setIsRetentionPopoverOpen(false)
+	}
+
+	// Cancel retention change
+	const cancelRetentionChange = () => {
+		setShowRetentionConfirmDialog(false)
+		setPendingRetention(null)
 	}
 
 	// Get subtask count for a task
@@ -148,7 +211,28 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 							</StandardTooltip>
 							<PopoverContent className="w-72" align="end">
 								<div className="space-y-3">
-									<h4 className="font-medium text-sm">{t("settings:aboutRetention.label")}</h4>
+									{/* Task count display */}
+									<div className="flex items-center gap-2">
+										<FolderOpen className="size-4 text-vscode-descriptionForeground shrink-0" />
+										<span className="text-sm">{getTaskCountDisplayText()}</span>
+										<Button
+											variant="ghost"
+											size="sm"
+											onClick={handleRefreshTaskCount}
+											disabled={isRefreshingTaskCount}
+											className="h-6 w-6 p-0 ml-auto"
+											title={t("settings:taskHistoryStorage.refresh")}>
+											{isRefreshingTaskCount ? (
+												<Loader2 className="size-3.5 animate-spin" />
+											) : (
+												<RefreshCw className="size-3.5" />
+											)}
+										</Button>
+									</div>
+
+									<div className="border-t border-vscode-settings-headerBorder pt-3">
+										<h4 className="font-medium text-sm">{t("settings:aboutRetention.label")}</h4>
+									</div>
 									<Select
 										value={normalizedRetention}
 										onValueChange={(value: TaskHistoryRetentionSetting) => {
@@ -175,9 +259,8 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 										</SelectContent>
 									</Select>
 									<p className="text-vscode-descriptionForeground text-xs">
-										{t("settings:aboutRetention.description")}
+										{t("settings:aboutRetention.warning")}
 									</p>
-									<p className="text-red-500 text-xs">{t("settings:aboutRetention.warning")}</p>
 								</div>
 							</PopoverContent>
 						</Popover>
@@ -421,6 +504,32 @@ const HistoryView = ({ onDone }: HistoryViewProps) => {
 					}}
 				/>
 			)}
+
+			{/* Retention change confirmation dialog */}
+			<AlertDialog open={showRetentionConfirmDialog} onOpenChange={setShowRetentionConfirmDialog}>
+				<AlertDialogContent>
+					<AlertDialogHeader>
+						<AlertDialogTitle>{t("settings:aboutRetention.confirmDialog.title")}</AlertDialogTitle>
+						<AlertDialogDescription>
+							{pendingRetention === "never"
+								? t("settings:aboutRetention.confirmDialog.descriptionNever")
+								: t("settings:aboutRetention.confirmDialog.description", {
+										period: pendingRetention,
+									})}
+						</AlertDialogDescription>
+					</AlertDialogHeader>
+					<AlertDialogFooter>
+						<AlertDialogCancel onClick={cancelRetentionChange}>
+							{t("settings:aboutRetention.confirmDialog.cancel")}
+						</AlertDialogCancel>
+						<AlertDialogAction onClick={confirmRetentionChange}>
+							{pendingRetention === "never"
+								? t("settings:aboutRetention.confirmDialog.confirmNever")
+								: t("settings:aboutRetention.confirmDialog.confirm")}
+						</AlertDialogAction>
+					</AlertDialogFooter>
+				</AlertDialogContent>
+			</AlertDialog>
 		</Tab>
 	)
 }
diff --git a/webview-ui/src/components/settings/About.tsx b/webview-ui/src/components/settings/About.tsx
index c5345f8da1e..17e3d6cfa95 100644
--- a/webview-ui/src/components/settings/About.tsx
+++ b/webview-ui/src/components/settings/About.tsx
@@ -1,19 +1,7 @@
-import { HTMLAttributes, useState, useCallback, useEffect } from "react"
+import { HTMLAttributes } from "react"
 import { useAppTranslation } from "@/i18n/TranslationContext"
 import { Trans } from "react-i18next"
-import {
-	Download,
-	Upload,
-	TriangleAlert,
-	Bug,
-	Lightbulb,
-	Shield,
-	MessageCircle,
-	MessagesSquare,
-	RefreshCw,
-	FolderOpen,
-	Loader2,
-} from "lucide-react"
+import { Download, Upload, TriangleAlert, Bug, Lightbulb, Shield, MessageCircle, MessagesSquare } from "lucide-react"
 import { VSCodeCheckbox, VSCodeLink } from "@vscode/webview-ui-toolkit/react"
 
 import type { TelemetrySetting } from "@roo-code/types"
@@ -28,63 +16,15 @@ import { SectionHeader } from "./SectionHeader"
 import { Section } from "./Section"
 import { SearchableSetting } from "./SearchableSetting"
 
-type TaskHistorySize = {
-	taskCount: number
-}
-
 type AboutProps = HTMLAttributes<HTMLDivElement> & {
 	telemetrySetting: TelemetrySetting
 	setTelemetrySetting: (setting: TelemetrySetting) => void
 	debug?: boolean
 	setDebug?: (debug: boolean) => void
-	taskHistorySize?: TaskHistorySize
 }
 
-export const About = ({
-	telemetrySetting,
-	setTelemetrySetting,
-	debug,
-	setDebug,
-	taskHistorySize,
-	className,
-	...props
-}: AboutProps) => {
+export const About = ({ telemetrySetting, setTelemetrySetting, debug, setDebug, className, ...props }: AboutProps) => {
 	const { t } = useAppTranslation()
-	const [isRefreshing, setIsRefreshing] = useState(false)
-	const [cachedSize, setCachedSize] = useState<TaskHistorySize | undefined>(taskHistorySize)
-
-	// Update cached size when taskHistorySize changes and reset refreshing state
-	useEffect(() => {
-		if (taskHistorySize) {
-			setCachedSize(taskHistorySize)
-			setIsRefreshing(false)
-		}
-	}, [taskHistorySize])
-
-	// NOTE: No auto-trigger on mount - user must click refresh button
-	// This is intentional for performance with large task counts (e.g., 9000+ tasks)
-
-	const handleRefreshTaskCount = useCallback(() => {
-		setIsRefreshing(true)
-		vscode.postMessage({ type: "refreshTaskHistorySize" })
-	}, [])
-
-	const getTaskCountDisplayText = (): string => {
-		// Use cached size if available, otherwise prompt user to click refresh
-		const displaySize = taskHistorySize || cachedSize
-		if (!displaySize) {
-			return t("settings:taskHistoryStorage.clickToCount")
-		}
-		if (displaySize.taskCount === 0) {
-			return t("settings:taskHistoryStorage.empty")
-		}
-		if (displaySize.taskCount === 1) {
-			return t("settings:taskHistoryStorage.countSingular")
-		}
-		return t("settings:taskHistoryStorage.count", {
-			count: displaySize.taskCount,
-		})
-	}
 
 	return (
 		<div className={cn("flex flex-col gap-2", className)} {...props}>
@@ -191,37 +131,10 @@ export const About = ({
 			</Section>
 
 			<Section className="space-y-0">
-				<SearchableSetting
-					settingId="about-task-history-count"
-					section="about"
-					label={t("settings:taskHistoryStorage.label")}
-					className="mt-4">
-					<div className="flex items-center gap-2">
-						<FolderOpen className="size-4 text-vscode-descriptionForeground shrink-0" />
-						<span className="text-sm">
-							{t("settings:taskHistoryStorage.label")}: {getTaskCountDisplayText()}
-						</span>
-						<Button
-							variant="ghost"
-							size="sm"
-							onClick={handleRefreshTaskCount}
-							disabled={isRefreshing}
-							className="h-6 w-6 p-0"
-							title={t("settings:taskHistoryStorage.refresh")}>
-							{isRefreshing ? (
-								<Loader2 className="size-3.5 animate-spin" />
-							) : (
-								<RefreshCw className="size-3.5" />
-							)}
-						</Button>
-					</div>
-				</SearchableSetting>
-
 				<SearchableSetting
 					settingId="about-manage-settings"
 					section="about"
-					label={t("settings:about.manageSettings")}
-					className="mt-4 pt-4 border-t border-vscode-settings-headerBorder">
+					label={t("settings:about.manageSettings")}>
 					<h3>{t("settings:about.manageSettings")}</h3>
 					<div className="flex flex-wrap items-center gap-2">
 						<Button onClick={() => vscode.postMessage({ type: "exportSettings" })} className="w-28">
diff --git a/webview-ui/src/components/settings/SettingsView.tsx b/webview-ui/src/components/settings/SettingsView.tsx
index c235149356a..60bbf355141 100644
--- a/webview-ui/src/components/settings/SettingsView.tsx
+++ b/webview-ui/src/components/settings/SettingsView.tsx
@@ -218,9 +218,6 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 		taskHistoryRetention,
 	} = cachedState
 
-	// taskHistorySize is read-only (not a saveable setting) so we use extensionState directly
-	const taskHistorySize = extensionState.taskHistorySize
-
 	const apiConfiguration = useMemo(() => cachedState.apiConfiguration ?? {}, [cachedState.apiConfiguration])
 
 	useEffect(() => {
@@ -974,7 +971,6 @@ const SettingsView = forwardRef<SettingsViewRef, SettingsViewProps>(({ onDone, t
 								setTelemetrySetting={setTelemetrySetting}
 								debug={cachedState.debug}
 								setDebug={setDebug}
-								taskHistorySize={taskHistorySize}
 							/>
 						)}
 					</SearchIndexProvider>
diff --git a/webview-ui/src/i18n/locales/ca/settings.json b/webview-ui/src/i18n/locales/ca/settings.json
index 46216a2f1e9..4b103b5996b 100644
--- a/webview-ui/src/i18n/locales/ca/settings.json
+++ b/webview-ui/src/i18n/locales/ca/settings.json
@@ -898,10 +898,17 @@
 	},
 	"aboutRetention": {
 		"label": "Eliminar automàticament l'historial de tasques",
-		"description": "Elimina les tasques anteriors al període seleccionat quan s'activa l'extensió.",
-		"warning": "Advertència: Aquesta acció elimina permanentment les tasques antigues i s'executa quan s'activa l'extensió.",
+		"warning": "Quan estigui activat, les tasques anteriors al període seleccionat s'eliminen permanentment en reiniciar VS Code.",
+		"confirmDialog": {
+			"title": "Activar l'eliminació automàtica?",
+			"description": "Això eliminarà permanentment les tasques de més de {{period}} dies cada vegada que es reiniciï VS Code. Aquesta acció no es pot desfer.",
+			"descriptionNever": "L'eliminació automàtica es desactivarà. El teu historial de tasques es conservarà.",
+			"confirm": "Activar eliminació automàtica",
+			"confirmNever": "Desactivar eliminació automàtica",
+			"cancel": "Cancel·lar"
+		},
 		"options": {
-			"never": "Mai",
+			"never": "Mai (per defecte)",
 			"90": "90 dies",
 			"60": "60 dies",
 			"30": "30 dies",
@@ -910,13 +917,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Ús d'emmagatzematge",
-		"calculating": "Calculant...",
-		"format": "{{size}} ({{count}} tasques)",
-		"formatSingular": "{{size}} (1 tasca)",
-		"empty": "Cap tasca emmagatzemada",
-		"refresh": "Actualitzar",
-		"error": "No es pot calcular"
+		"label": "Historial de tasques",
+		"clickToCount": "Clica per comptar",
+		"count": "{{count}} tasques a l'historial",
+		"countSingular": "1 tasca a l'historial",
+		"empty": "Encara no hi ha tasques",
+		"refresh": "Actualitzar"
 	},
 	"footer": {
 		"feedback": "Si teniu qualsevol pregunta o comentari, no dubteu a obrir un issue a <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unir-vos a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/de/settings.json b/webview-ui/src/i18n/locales/de/settings.json
index fe841dd5a38..8eef56ac82b 100644
--- a/webview-ui/src/i18n/locales/de/settings.json
+++ b/webview-ui/src/i18n/locales/de/settings.json
@@ -898,10 +898,17 @@
 	},
 	"aboutRetention": {
 		"label": "Aufgabenverlauf automatisch löschen",
-		"description": "Löscht Aufgaben, die älter als der ausgewählte Zeitraum sind, wenn die Erweiterung aktiviert wird.",
-		"warning": "Warnung: Diese Aktion löscht alte Aufgaben dauerhaft und wird ausgeführt, wenn die Erweiterung aktiviert wird.",
+		"warning": "Wenn aktiviert, werden Aufgaben, die älter als der ausgewählte Zeitraum sind, beim Neustart von VS Code dauerhaft gelöscht.",
+		"confirmDialog": {
+			"title": "Automatisches Löschen aktivieren?",
+			"description": "Dies löscht dauerhaft Aufgaben, die älter als {{period}} Tage sind, bei jedem Neustart von VS Code. Diese Aktion kann nicht rückgängig gemacht werden.",
+			"descriptionNever": "Das automatische Löschen wird deaktiviert. Dein Aufgabenverlauf bleibt erhalten.",
+			"confirm": "Automatisches Löschen aktivieren",
+			"confirmNever": "Automatisches Löschen deaktivieren",
+			"cancel": "Abbrechen"
+		},
 		"options": {
-			"never": "Nie",
+			"never": "Nie (Standard)",
 			"90": "90 Tage",
 			"60": "60 Tage",
 			"30": "30 Tage",
@@ -910,13 +917,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Speichernutzung",
-		"calculating": "Berechne...",
-		"format": "{{size}} ({{count}} Aufgaben)",
-		"formatSingular": "{{size}} (1 Aufgabe)",
-		"empty": "Keine Aufgaben gespeichert",
-		"refresh": "Aktualisieren",
-		"error": "Berechnung nicht möglich"
+		"label": "Aufgabenverlauf",
+		"clickToCount": "Klicken zum Zählen",
+		"count": "{{count}} Aufgaben im Verlauf",
+		"countSingular": "1 Aufgabe im Verlauf",
+		"empty": "Noch keine Aufgaben",
+		"refresh": "Aktualisieren"
 	},
 	"footer": {
 		"feedback": "Wenn du Fragen oder Feedback hast, kannst du gerne ein Issue auf <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> eröffnen oder <redditLink>reddit.com/r/RooCode</redditLink> oder <discordLink>discord.gg/roocode</discordLink> beitreten",
diff --git a/webview-ui/src/i18n/locales/en/settings.json b/webview-ui/src/i18n/locales/en/settings.json
index 6994f5fb912..106f7b631fe 100644
--- a/webview-ui/src/i18n/locales/en/settings.json
+++ b/webview-ui/src/i18n/locales/en/settings.json
@@ -907,10 +907,17 @@
 	},
 	"aboutRetention": {
 		"label": "Auto-delete task history",
-		"description": "Deletes tasks older than the selected period when the extension is activated.",
-		"warning": "Warning: This action permanently deletes old tasks and runs when the extension is activated.",
+		"warning": "When enabled, tasks older than the selected period are permanently deleted when VS Code restarts.",
+		"confirmDialog": {
+			"title": "Enable Auto-Delete?",
+			"description": "This will permanently delete tasks older than {{period}} days whenever VS Code restarts. This action cannot be undone.",
+			"descriptionNever": "Auto-delete will be disabled. Your task history will be preserved.",
+			"confirm": "Enable Auto-Delete",
+			"confirmNever": "Disable Auto-Delete",
+			"cancel": "Cancel"
+		},
 		"options": {
-			"never": "Never",
+			"never": "Never (default)",
 			"90": "90 days",
 			"60": "60 days",
 			"30": "30 days",
@@ -919,12 +926,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Task count",
-		"clickToCount": "Click refresh to count",
-		"count": "{{count}} tasks",
-		"countSingular": "1 task",
-		"empty": "No tasks stored",
-		"refresh": "Count tasks"
+		"label": "Task history",
+		"clickToCount": "Click to count tasks",
+		"count": "{{count}} tasks in history",
+		"countSingular": "1 task in history",
+		"empty": "No tasks yet",
+		"refresh": "Refresh count"
 	},
 	"footer": {
 		"telemetry": {
diff --git a/webview-ui/src/i18n/locales/es/settings.json b/webview-ui/src/i18n/locales/es/settings.json
index 2d8b6e4b659..39f2d3f657a 100644
--- a/webview-ui/src/i18n/locales/es/settings.json
+++ b/webview-ui/src/i18n/locales/es/settings.json
@@ -898,10 +898,17 @@
 	},
 	"aboutRetention": {
 		"label": "Eliminar automáticamente el historial de tareas",
-		"description": "Elimina las tareas anteriores al período seleccionado cuando se activa la extensión.",
-		"warning": "Advertencia: Esta acción elimina permanentemente las tareas antiguas y se ejecuta cuando se activa la extensión.",
+		"warning": "Cuando está habilitado, las tareas anteriores al período seleccionado se eliminan permanentemente al reiniciar VS Code.",
+		"confirmDialog": {
+			"title": "¿Activar eliminación automática?",
+			"description": "Esto eliminará permanentemente las tareas de más de {{period}} días cada vez que VS Code se reinicie. Esta acción no se puede deshacer.",
+			"descriptionNever": "La eliminación automática se desactivará. Tu historial de tareas se conservará.",
+			"confirm": "Activar eliminación automática",
+			"confirmNever": "Desactivar eliminación automática",
+			"cancel": "Cancelar"
+		},
 		"options": {
-			"never": "Nunca",
+			"never": "Nunca (predeterminado)",
 			"90": "90 días",
 			"60": "60 días",
 			"30": "30 días",
@@ -910,13 +917,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Uso de almacenamiento",
-		"calculating": "Calculando...",
-		"format": "{{size}} ({{count}} tareas)",
-		"formatSingular": "{{size}} (1 tarea)",
-		"empty": "No hay tareas almacenadas",
-		"refresh": "Actualizar",
-		"error": "No se puede calcular"
+		"label": "Historial de tareas",
+		"clickToCount": "Clic para contar",
+		"count": "{{count}} tareas en el historial",
+		"countSingular": "1 tarea en el historial",
+		"empty": "Sin tareas aún",
+		"refresh": "Actualizar"
 	},
 	"footer": {
 		"feedback": "Si tiene alguna pregunta o comentario, no dude en abrir un issue en <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unirse a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/fr/settings.json b/webview-ui/src/i18n/locales/fr/settings.json
index 07b7222afdc..365f73534cb 100644
--- a/webview-ui/src/i18n/locales/fr/settings.json
+++ b/webview-ui/src/i18n/locales/fr/settings.json
@@ -898,10 +898,17 @@
 	},
 	"aboutRetention": {
 		"label": "Supprimer automatiquement l'historique des tâches",
-		"description": "Supprime les tâches antérieures à la période sélectionnée lorsque l'extension est activée.",
-		"warning": "Avertissement : Cette action supprime définitivement les anciennes tâches et s'exécute lorsque l'extension est activée.",
+		"warning": "Si activé, les tâches antérieures à la période sélectionnée sont définitivement supprimées au redémarrage de VS Code.",
+		"confirmDialog": {
+			"title": "Activer la suppression automatique ?",
+			"description": "Cela supprimera définitivement les tâches de plus de {{period}} jours à chaque redémarrage de VS Code. Cette action ne peut pas être annulée.",
+			"descriptionNever": "La suppression automatique sera désactivée. Votre historique des tâches sera conservé.",
+			"confirm": "Activer la suppression automatique",
+			"confirmNever": "Désactiver la suppression automatique",
+			"cancel": "Annuler"
+		},
 		"options": {
-			"never": "Jamais",
+			"never": "Jamais (par défaut)",
 			"90": "90 jours",
 			"60": "60 jours",
 			"30": "30 jours",
@@ -910,13 +917,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Utilisation du stockage",
-		"calculating": "Calcul en cours...",
-		"format": "{{size}} ({{count}} tâches)",
-		"formatSingular": "{{size}} (1 tâche)",
-		"empty": "Aucune tâche stockée",
-		"refresh": "Actualiser",
-		"error": "Impossible de calculer"
+		"label": "Historique des tâches",
+		"clickToCount": "Cliquer pour compter",
+		"count": "{{count}} tâches dans l'historique",
+		"countSingular": "1 tâche dans l'historique",
+		"empty": "Aucune tâche pour l'instant",
+		"refresh": "Actualiser"
 	},
 	"footer": {
 		"feedback": "Si vous avez des questions ou des commentaires, n'hésitez pas à ouvrir un problème sur <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> ou à rejoindre <redditLink>reddit.com/r/RooCode</redditLink> ou <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/hi/settings.json b/webview-ui/src/i18n/locales/hi/settings.json
index c2c162b8177..24d910e3c11 100644
--- a/webview-ui/src/i18n/locales/hi/settings.json
+++ b/webview-ui/src/i18n/locales/hi/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "कार्य इतिहास स्वचालित रूप से हटाएं",
-		"description": "एक्सटेंशन सक्रिय होने पर चयनित अवधि से पुराने कार्यों को हटा देता है।",
-		"warning": "चेतावनी: यह क्रिया स्थायी रूप से पुराने कार्यों को हटा देती है और एक्सटेंशन सक्रिय होने पर चलती है।",
+		"warning": "सक्षम होने पर, चयनित अवधि से पुराने कार्य VS Code के पुनः आरंभ होने पर स्थायी रूप से हटा दिए जाते हैं।",
+		"confirmDialog": {
+			"title": "स्वचालित हटाना सक्षम करें?",
+			"description": "यह VS Code के हर पुनः आरंभ पर {{period}} दिनों से पुराने कार्यों को स्थायी रूप से हटा देगा। इस क्रिया को पूर्ववत नहीं किया जा सकता।",
+			"descriptionNever": "स्वचालित हटाना अक्षम किया जाएगा। आपका कार्य इतिहास संरक्षित रहेगा।",
+			"confirm": "स्वचालित हटाना सक्षम करें",
+			"confirmNever": "स्वचालित हटाना अक्षम करें",
+			"cancel": "रद्द करें"
+		},
 		"options": {
-			"never": "कभी नहीं",
+			"never": "कभी नहीं (डिफ़ॉल्ट)",
 			"90": "90 दिन",
 			"60": "60 दिन",
 			"30": "30 दिन",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "स्टोरेज उपयोग",
-		"calculating": "गणना हो रही है...",
-		"format": "{{size}} ({{count}} कार्य)",
-		"formatSingular": "{{size}} (1 कार्य)",
-		"empty": "कोई कार्य संग्रहीत नहीं",
-		"refresh": "रिफ्रेश करें",
-		"error": "गणना करने में असमर्थ"
+		"label": "कार्य इतिहास",
+		"clickToCount": "गिनने के लिए क्लिक करें",
+		"count": "इतिहास में {{count}} कार्य",
+		"countSingular": "इतिहास में 1 कार्य",
+		"empty": "अभी तक कोई कार्य नहीं",
+		"refresh": "रिफ्रेश करें"
 	},
 	"footer": {
 		"feedback": "यदि आपके कोई प्रश्न या प्रतिक्रिया है, तो <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> पर एक मुद्दा खोलने या <redditLink>reddit.com/r/RooCode</redditLink> या <discordLink>discord.gg/roocode</discordLink> में शामिल होने में संकोच न करें",
diff --git a/webview-ui/src/i18n/locales/id/settings.json b/webview-ui/src/i18n/locales/id/settings.json
index 3d753c2f4ac..0fe138cee7b 100644
--- a/webview-ui/src/i18n/locales/id/settings.json
+++ b/webview-ui/src/i18n/locales/id/settings.json
@@ -928,10 +928,17 @@
 	},
 	"aboutRetention": {
 		"label": "Hapus otomatis riwayat tugas",
-		"description": "Menghapus tugas yang lebih lama dari periode yang dipilih saat ekstensi diaktifkan.",
-		"warning": "Peringatan: Tindakan ini menghapus tugas lama secara permanen dan berjalan saat ekstensi diaktifkan.",
+		"warning": "Saat diaktifkan, tugas yang lebih lama dari periode yang dipilih akan dihapus secara permanen saat VS Code dimulai ulang.",
+		"confirmDialog": {
+			"title": "Aktifkan hapus otomatis?",
+			"description": "Ini akan menghapus tugas yang lebih lama dari {{period}} hari secara permanen setiap kali VS Code dimulai ulang. Tindakan ini tidak dapat dibatalkan.",
+			"descriptionNever": "Hapus otomatis akan dinonaktifkan. Riwayat tugas Anda akan dipertahankan.",
+			"confirm": "Aktifkan hapus otomatis",
+			"confirmNever": "Nonaktifkan hapus otomatis",
+			"cancel": "Batal"
+		},
 		"options": {
-			"never": "Tidak pernah",
+			"never": "Tidak pernah (default)",
 			"90": "90 hari",
 			"60": "60 hari",
 			"30": "30 hari",
@@ -940,13 +947,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Penggunaan penyimpanan",
-		"calculating": "Menghitung...",
-		"format": "{{size}} ({{count}} tugas)",
-		"formatSingular": "{{size}} (1 tugas)",
-		"empty": "Tidak ada tugas tersimpan",
-		"refresh": "Segarkan",
-		"error": "Tidak dapat menghitung"
+		"label": "Riwayat tugas",
+		"clickToCount": "Klik untuk menghitung",
+		"count": "{{count}} tugas dalam riwayat",
+		"countSingular": "1 tugas dalam riwayat",
+		"empty": "Belum ada tugas",
+		"refresh": "Segarkan"
 	},
 	"footer": {
 		"feedback": "Jika kamu punya pertanyaan atau feedback, jangan ragu untuk membuka issue di <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> atau bergabung <redditLink>reddit.com/r/RooCode</redditLink> atau <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/it/settings.json b/webview-ui/src/i18n/locales/it/settings.json
index 2b4f5129ee7..a912a59d3a9 100644
--- a/webview-ui/src/i18n/locales/it/settings.json
+++ b/webview-ui/src/i18n/locales/it/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Elimina automaticamente la cronologia delle attività",
-		"description": "Elimina le attività più vecchie del periodo selezionato quando l'estensione viene attivata.",
-		"warning": "Avviso: Questa azione elimina permanentemente le attività vecchie e viene eseguita quando l'estensione viene attivata.",
+		"warning": "Se abilitato, le attività più vecchie del periodo selezionato vengono eliminate permanentemente al riavvio di VS Code.",
+		"confirmDialog": {
+			"title": "Attivare l'eliminazione automatica?",
+			"description": "Questo eliminerà permanentemente le attività più vecchie di {{period}} giorni ogni volta che VS Code viene riavviato. Questa azione non può essere annullata.",
+			"descriptionNever": "L'eliminazione automatica sarà disattivata. La cronologia delle attività sarà conservata.",
+			"confirm": "Attiva eliminazione automatica",
+			"confirmNever": "Disattiva eliminazione automatica",
+			"cancel": "Annulla"
+		},
 		"options": {
-			"never": "Mai",
+			"never": "Mai (predefinito)",
 			"90": "90 giorni",
 			"60": "60 giorni",
 			"30": "30 giorni",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Utilizzo dello spazio di archiviazione",
-		"calculating": "Calcolo in corso...",
-		"format": "{{size}} ({{count}} attività)",
-		"formatSingular": "{{size}} (1 attività)",
-		"empty": "Nessuna attività archiviata",
-		"refresh": "Aggiorna",
-		"error": "Impossibile calcolare"
+		"label": "Cronologia attività",
+		"clickToCount": "Clicca per contare",
+		"count": "{{count}} attività nella cronologia",
+		"countSingular": "1 attività nella cronologia",
+		"empty": "Nessuna attività ancora",
+		"refresh": "Aggiorna"
 	},
 	"footer": {
 		"feedback": "Se hai domande o feedback, sentiti libero di aprire un issue su <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> o unirti a <redditLink>reddit.com/r/RooCode</redditLink> o <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/ja/settings.json b/webview-ui/src/i18n/locales/ja/settings.json
index ba90931b53d..7f4ebf8e70d 100644
--- a/webview-ui/src/i18n/locales/ja/settings.json
+++ b/webview-ui/src/i18n/locales/ja/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "タスク履歴を自動削除",
-		"description": "拡張機能が起動したときに、選択された期間より古いタスクを削除します。",
-		"warning": "警告：この操作は古いタスクを完全に削除し、拡張機能が起動したときに実行されます。",
+		"warning": "有効にすると、選択した期間より古いタスクはVS Code再起動時に完全に削除されます。",
+		"confirmDialog": {
+			"title": "自動削除を有効にしますか？",
+			"description": "VS Codeを再起動するたびに、{{period}}日以上経過したタスクが完全に削除されます。この操作は取り消せません。",
+			"descriptionNever": "自動削除が無効になります。タスク履歴は保持されます。",
+			"confirm": "自動削除を有効にする",
+			"confirmNever": "自動削除を無効にする",
+			"cancel": "キャンセル"
+		},
 		"options": {
-			"never": "削除しない",
+			"never": "削除しない（デフォルト）",
 			"90": "90日",
 			"60": "60日",
 			"30": "30日",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "ストレージ使用量",
-		"calculating": "計算中...",
-		"format": "{{size}} ({{count}} タスク)",
-		"formatSingular": "{{size}} (1 タスク)",
-		"empty": "保存されたタスクがありません",
-		"refresh": "更新",
-		"error": "計算できません"
+		"label": "タスク履歴",
+		"clickToCount": "クリックしてカウント",
+		"count": "履歴に{{count}}件のタスク",
+		"countSingular": "履歴に1件のタスク",
+		"empty": "タスクはまだありません",
+		"refresh": "更新"
 	},
 	"footer": {
 		"feedback": "質問やフィードバックがある場合は、<githubLink>github.com/RooCodeInc/Roo-Code</githubLink>で問題を開くか、<redditLink>reddit.com/r/RooCode</redditLink>や<discordLink>discord.gg/roocode</discordLink>に参加してください",
diff --git a/webview-ui/src/i18n/locales/ko/settings.json b/webview-ui/src/i18n/locales/ko/settings.json
index c3c7490b979..692e0c00861 100644
--- a/webview-ui/src/i18n/locales/ko/settings.json
+++ b/webview-ui/src/i18n/locales/ko/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "작업 기록 자동 삭제",
-		"description": "확장 프로그램이 활성화될 때 선택한 기간보다 오래된 작업을 삭제합니다.",
-		"warning": "경고: 이 작업은 오래된 작업을 영구적으로 삭제하며 확장 프로그램이 활성화될 때 실행됩니다.",
+		"warning": "활성화하면 선택한 기간보다 오래된 작업이 VS Code 재시작 시 영구적으로 삭제됩니다.",
+		"confirmDialog": {
+			"title": "자동 삭제를 활성화하시겠습니까?",
+			"description": "VS Code가 재시작될 때마다 {{period}}일 이상 된 작업이 영구적으로 삭제됩니다. 이 작업은 취소할 수 없습니다.",
+			"descriptionNever": "자동 삭제가 비활성화됩니다. 작업 기록이 보존됩니다.",
+			"confirm": "자동 삭제 활성화",
+			"confirmNever": "자동 삭제 비활성화",
+			"cancel": "취소"
+		},
 		"options": {
-			"never": "삭제 안 함",
+			"never": "삭제 안 함 (기본값)",
 			"90": "90일",
 			"60": "60일",
 			"30": "30일",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "저장소 사용량",
-		"calculating": "계산 중...",
-		"format": "{{size}} ({{count}}개 작업)",
-		"formatSingular": "{{size}} (1개 작업)",
-		"empty": "저장된 작업 없음",
-		"refresh": "새로고침",
-		"error": "계산할 수 없음"
+		"label": "작업 기록",
+		"clickToCount": "클릭하여 계산",
+		"count": "기록에 {{count}}개 작업",
+		"countSingular": "기록에 1개 작업",
+		"empty": "아직 작업 없음",
+		"refresh": "새로고침"
 	},
 	"footer": {
 		"feedback": "질문이나 피드백이 있으시면 <githubLink>github.com/RooCodeInc/Roo-Code</githubLink>에서 이슈를 열거나 <redditLink>reddit.com/r/RooCode</redditLink> 또는 <discordLink>discord.gg/roocode</discordLink>에 가입하세요",
diff --git a/webview-ui/src/i18n/locales/nl/settings.json b/webview-ui/src/i18n/locales/nl/settings.json
index 8eebef23905..3463f6ee049 100644
--- a/webview-ui/src/i18n/locales/nl/settings.json
+++ b/webview-ui/src/i18n/locales/nl/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Taakgeschiedenis automatisch verwijderen",
-		"description": "Verwijdert taken ouder dan de geselecteerde periode wanneer de extensie wordt geactiveerd.",
-		"warning": "Waarschuwing: Deze actie verwijdert oude taken permanent en wordt uitgevoerd wanneer de extensie wordt geactiveerd.",
+		"warning": "Wanneer ingeschakeld, worden taken ouder dan de geselecteerde periode permanent verwijderd bij het herstarten van VS Code.",
+		"confirmDialog": {
+			"title": "Automatisch verwijderen activeren?",
+			"description": "Dit verwijdert permanent taken ouder dan {{period}} dagen telkens wanneer VS Code opnieuw wordt gestart. Deze actie kan niet ongedaan worden gemaakt.",
+			"descriptionNever": "Automatisch verwijderen wordt uitgeschakeld. Je taakgeschiedenis wordt bewaard.",
+			"confirm": "Automatisch verwijderen activeren",
+			"confirmNever": "Automatisch verwijderen uitschakelen",
+			"cancel": "Annuleren"
+		},
 		"options": {
-			"never": "Nooit",
+			"never": "Nooit (standaard)",
 			"90": "90 dagen",
 			"60": "60 dagen",
 			"30": "30 dagen",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Opslaggebruik",
-		"calculating": "Berekenen...",
-		"format": "{{size}} ({{count}} taken)",
-		"formatSingular": "{{size}} (1 taak)",
-		"empty": "Geen opgeslagen taken",
-		"refresh": "Vernieuwen",
-		"error": "Kan niet berekenen"
+		"label": "Taakgeschiedenis",
+		"clickToCount": "Klik om te tellen",
+		"count": "{{count}} taken in geschiedenis",
+		"countSingular": "1 taak in geschiedenis",
+		"empty": "Nog geen taken",
+		"refresh": "Vernieuwen"
 	},
 	"footer": {
 		"feedback": "Heb je vragen of feedback? Open gerust een issue op <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> of sluit je aan bij <redditLink>reddit.com/r/RooCode</redditLink> of <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/pl/settings.json b/webview-ui/src/i18n/locales/pl/settings.json
index 9b4ca5d4292..3f2628ee643 100644
--- a/webview-ui/src/i18n/locales/pl/settings.json
+++ b/webview-ui/src/i18n/locales/pl/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Automatyczne usuwanie historii zadań",
-		"description": "Usuwa zadania starsze niż wybrany okres po aktywacji rozszerzenia.",
-		"warning": "Ostrzeżenie: Ta akcja trwale usuwa stare zadania i działa po aktywacji rozszerzenia.",
+		"warning": "Po włączeniu, zadania starsze niż wybrany okres są trwale usuwane przy ponownym uruchomieniu VS Code.",
+		"confirmDialog": {
+			"title": "Włączyć automatyczne usuwanie?",
+			"description": "To trwale usunie zadania starsze niż {{period}} dni przy każdym ponownym uruchomieniu VS Code. Tej akcji nie można cofnąć.",
+			"descriptionNever": "Automatyczne usuwanie zostanie wyłączone. Historia zadań zostanie zachowana.",
+			"confirm": "Włącz automatyczne usuwanie",
+			"confirmNever": "Wyłącz automatyczne usuwanie",
+			"cancel": "Anuluj"
+		},
 		"options": {
-			"never": "Nigdy",
+			"never": "Nigdy (domyślnie)",
 			"90": "90 dni",
 			"60": "60 dni",
 			"30": "30 dni",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Wykorzystanie pamięci",
-		"calculating": "Obliczanie...",
-		"format": "{{size}} ({{count}} zadań)",
-		"formatSingular": "{{size}} (1 zadanie)",
-		"empty": "Brak zapisanych zadań",
-		"refresh": "Odśwież",
-		"error": "Nie można obliczyć"
+		"label": "Historia zadań",
+		"clickToCount": "Kliknij, aby policzyć",
+		"count": "{{count}} zadań w historii",
+		"countSingular": "1 zadanie w historii",
+		"empty": "Brak zadań",
+		"refresh": "Odśwież"
 	},
 	"footer": {
 		"feedback": "Jeśli masz jakiekolwiek pytania lub opinie, śmiało otwórz zgłoszenie na <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> lub dołącz do <redditLink>reddit.com/r/RooCode</redditLink> lub <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/pt-BR/settings.json b/webview-ui/src/i18n/locales/pt-BR/settings.json
index af7a27112c0..fe631b50918 100644
--- a/webview-ui/src/i18n/locales/pt-BR/settings.json
+++ b/webview-ui/src/i18n/locales/pt-BR/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Excluir automaticamente o histórico de tarefas",
-		"description": "Exclui tarefas mais antigas que o período selecionado quando a extensão é ativada.",
-		"warning": "Aviso: Esta ação exclui permanentemente as tarefas antigas e é executada quando a extensão é ativada.",
+		"warning": "Quando ativado, tarefas mais antigas que o período selecionado são excluídas permanentemente ao reiniciar o VS Code.",
+		"confirmDialog": {
+			"title": "Ativar exclusão automática?",
+			"description": "Isso excluirá permanentemente tarefas com mais de {{period}} dias sempre que o VS Code for reiniciado. Esta ação não pode ser desfeita.",
+			"descriptionNever": "A exclusão automática será desativada. Seu histórico de tarefas será preservado.",
+			"confirm": "Ativar exclusão automática",
+			"confirmNever": "Desativar exclusão automática",
+			"cancel": "Cancelar"
+		},
 		"options": {
-			"never": "Nunca",
+			"never": "Nunca (padrão)",
 			"90": "90 dias",
 			"60": "60 dias",
 			"30": "30 dias",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Uso de armazenamento",
-		"calculating": "Calculando...",
-		"format": "{{size}} ({{count}} tarefas)",
-		"formatSingular": "{{size}} (1 tarefa)",
-		"empty": "Nenhuma tarefa armazenada",
-		"refresh": "Atualizar",
-		"error": "Não foi possível calcular"
+		"label": "Histórico de tarefas",
+		"clickToCount": "Clique para contar",
+		"count": "{{count}} tarefas no histórico",
+		"countSingular": "1 tarefa no histórico",
+		"empty": "Nenhuma tarefa ainda",
+		"refresh": "Atualizar"
 	},
 	"footer": {
 		"feedback": "Se tiver alguma dúvida ou feedback, sinta-se à vontade para abrir um problema em <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> ou juntar-se a <redditLink>reddit.com/r/RooCode</redditLink> ou <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/ru/settings.json b/webview-ui/src/i18n/locales/ru/settings.json
index f6b471876b3..a9fb4dcc55a 100644
--- a/webview-ui/src/i18n/locales/ru/settings.json
+++ b/webview-ui/src/i18n/locales/ru/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Автоматически удалять историю задач",
-		"description": "Удаляет задачи старше выбранного периода при активации расширения.",
-		"warning": "Внимание: Это действие безвозвратно удаляет старые задачи и выполняется при активации расширения.",
+		"warning": "При включении задачи старше выбранного периода безвозвратно удаляются при перезапуске VS Code.",
+		"confirmDialog": {
+			"title": "Включить автоудаление?",
+			"description": "Это безвозвратно удалит задачи старше {{period}} дней при каждом перезапуске VS Code. Это действие нельзя отменить.",
+			"descriptionNever": "Автоудаление будет отключено. История задач будет сохранена.",
+			"confirm": "Включить автоудаление",
+			"confirmNever": "Отключить автоудаление",
+			"cancel": "Отмена"
+		},
 		"options": {
-			"never": "Никогда",
+			"never": "Никогда (по умолчанию)",
 			"90": "90 дней",
 			"60": "60 дней",
 			"30": "30 дней",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Использование хранилища",
-		"calculating": "Подсчет...",
-		"format": "{{size}} ({{count}} задач)",
-		"formatSingular": "{{size}} (1 задача)",
-		"empty": "Нет сохраненных задач",
-		"refresh": "Обновить",
-		"error": "Невозможно подсчитать"
+		"label": "История задач",
+		"clickToCount": "Нажмите для подсчета",
+		"count": "{{count}} задач в истории",
+		"countSingular": "1 задача в истории",
+		"empty": "Задач пока нет",
+		"refresh": "Обновить"
 	},
 	"footer": {
 		"feedback": "Если у вас есть вопросы или предложения, откройте issue на <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> или присоединяйтесь к <redditLink>reddit.com/r/RooCode</redditLink> или <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/tr/settings.json b/webview-ui/src/i18n/locales/tr/settings.json
index 63d97b554fd..2c224cf7cef 100644
--- a/webview-ui/src/i18n/locales/tr/settings.json
+++ b/webview-ui/src/i18n/locales/tr/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Görev geçmişini otomatik sil",
-		"description": "Uzantı etkinleştirildiğinde seçilen döneme göre daha eski görevleri siler.",
-		"warning": "Uyarı: Bu işlem eski görevleri kalıcı olarak siler ve uzantı etkinleştirildiğinde çalışır.",
+		"warning": "Etkinleştirildiğinde, seçilen döneme göre daha eski görevler VS Code yeniden başlatıldığında kalıcı olarak silinir.",
+		"confirmDialog": {
+			"title": "Otomatik silmeyi etkinleştir?",
+			"description": "Bu, VS Code her yeniden başlatıldığında {{period}} günden eski görevleri kalıcı olarak silecek. Bu işlem geri alınamaz.",
+			"descriptionNever": "Otomatik silme devre dışı bırakılacak. Görev geçmişiniz korunacak.",
+			"confirm": "Otomatik silmeyi etkinleştir",
+			"confirmNever": "Otomatik silmeyi devre dışı bırak",
+			"cancel": "İptal"
+		},
 		"options": {
-			"never": "Asla",
+			"never": "Asla (varsayılan)",
 			"90": "90 gün",
 			"60": "60 gün",
 			"30": "30 gün",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Depolama kullanımı",
-		"calculating": "Hesaplanıyor...",
-		"format": "{{size}} ({{count}} görev)",
-		"formatSingular": "{{size}} (1 görev)",
-		"empty": "Depolanmış görev yok",
-		"refresh": "Yenile",
-		"error": "Hesaplanamıyor"
+		"label": "Görev geçmişi",
+		"clickToCount": "Saymak için tıklayın",
+		"count": "Geçmişte {{count}} görev",
+		"countSingular": "Geçmişte 1 görev",
+		"empty": "Henüz görev yok",
+		"refresh": "Yenile"
 	},
 	"footer": {
 		"feedback": "Herhangi bir sorunuz veya geri bildiriminiz varsa, <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> adresinde bir konu açmaktan veya <redditLink>reddit.com/r/RooCode</redditLink> ya da <discordLink>discord.gg/roocode</discordLink>'a katılmaktan çekinmeyin",
diff --git a/webview-ui/src/i18n/locales/vi/settings.json b/webview-ui/src/i18n/locales/vi/settings.json
index 4ab3fbb3b0e..70a5156275d 100644
--- a/webview-ui/src/i18n/locales/vi/settings.json
+++ b/webview-ui/src/i18n/locales/vi/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "Tự động xóa lịch sử tác vụ",
-		"description": "Xóa các tác vụ cũ hơn khoảng thời gian đã chọn khi tiện ích được kích hoạt.",
-		"warning": "Cảnh báo: Hành động này xóa vĩnh viễn các tác vụ cũ và chạy khi tiện ích được kích hoạt.",
+		"warning": "Khi được bật, các tác vụ cũ hơn khoảng thời gian đã chọn sẽ bị xóa vĩnh viễn khi VS Code khởi động lại.",
+		"confirmDialog": {
+			"title": "Bật tự động xóa?",
+			"description": "Điều này sẽ xóa vĩnh viễn các tác vụ cũ hơn {{period}} ngày mỗi khi VS Code khởi động lại. Hành động này không thể hoàn tác.",
+			"descriptionNever": "Tự động xóa sẽ bị tắt. Lịch sử tác vụ của bạn sẽ được bảo tồn.",
+			"confirm": "Bật tự động xóa",
+			"confirmNever": "Tắt tự động xóa",
+			"cancel": "Hủy"
+		},
 		"options": {
-			"never": "Không bao giờ",
+			"never": "Không bao giờ (mặc định)",
 			"90": "90 ngày",
 			"60": "60 ngày",
 			"30": "30 ngày",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "Dung lượng lưu trữ",
-		"calculating": "Đang tính toán...",
-		"format": "{{size}} ({{count}} tác vụ)",
-		"formatSingular": "{{size}} (1 tác vụ)",
-		"empty": "Không có tác vụ được lưu trữ",
-		"refresh": "Làm mới",
-		"error": "Không thể tính toán"
+		"label": "Lịch sử tác vụ",
+		"clickToCount": "Nhấp để đếm",
+		"count": "{{count}} tác vụ trong lịch sử",
+		"countSingular": "1 tác vụ trong lịch sử",
+		"empty": "Chưa có tác vụ nào",
+		"refresh": "Làm mới"
 	},
 	"footer": {
 		"feedback": "Nếu bạn có bất kỳ câu hỏi hoặc phản hồi nào, vui lòng mở một vấn đề tại <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> hoặc tham gia <redditLink>reddit.com/r/RooCode</redditLink> hoặc <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/zh-CN/settings.json b/webview-ui/src/i18n/locales/zh-CN/settings.json
index 7dfa021917e..278724a99c0 100644
--- a/webview-ui/src/i18n/locales/zh-CN/settings.json
+++ b/webview-ui/src/i18n/locales/zh-CN/settings.json
@@ -899,10 +899,17 @@
 	},
 	"aboutRetention": {
 		"label": "自动删除任务历史",
-		"description": "扩展激活时删除早于所选时段的任务。",
-		"warning": "警告：此操作永久删除旧任务，并在扩展激活时运行。",
+		"warning": "启用后，早于所选时段的任务将在VS Code重启时被永久删除。",
+		"confirmDialog": {
+			"title": "启用自动删除？",
+			"description": "每次VS Code重启时，将永久删除超过{{period}}天的任务。此操作无法撤销。",
+			"descriptionNever": "自动删除将被禁用。您的任务历史将被保留。",
+			"confirm": "启用自动删除",
+			"confirmNever": "禁用自动删除",
+			"cancel": "取消"
+		},
 		"options": {
-			"never": "永不",
+			"never": "永不（默认）",
 			"90": "90天",
 			"60": "60天",
 			"30": "30天",
@@ -911,13 +918,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "存储使用量",
-		"calculating": "计算中...",
-		"format": "{{size}} ({{count}} 个任务)",
-		"formatSingular": "{{size}} (1 个任务)",
-		"empty": "无任务存储",
-		"refresh": "刷新",
-		"error": "无法计算"
+		"label": "任务历史",
+		"clickToCount": "点击计数",
+		"count": "历史中有 {{count}} 个任务",
+		"countSingular": "历史中有 1 个任务",
+		"empty": "暂无任务",
+		"refresh": "刷新"
 	},
 	"footer": {
 		"feedback": "如果您有任何问题或反馈，请随时在 <githubLink>github.com/RooCodeInc/Roo-Code</githubLink> 上提出问题或加入 <redditLink>reddit.com/r/RooCode</redditLink> 或 <discordLink>discord.gg/roocode</discordLink>",
diff --git a/webview-ui/src/i18n/locales/zh-TW/settings.json b/webview-ui/src/i18n/locales/zh-TW/settings.json
index 2c64ae99774..b0ffab82e7e 100644
--- a/webview-ui/src/i18n/locales/zh-TW/settings.json
+++ b/webview-ui/src/i18n/locales/zh-TW/settings.json
@@ -907,10 +907,17 @@
 	},
 	"aboutRetention": {
 		"label": "自動刪除工作歷程記錄",
-		"description": "擴充功能啟動時刪除早於所選時段的工作。",
-		"warning": "警告：此操作永久刪除舊工作，並在擴充功能啟動時執行。",
+		"warning": "啟用後，早於所選時段的工作將在VS Code重新啟動時被永久刪除。",
+		"confirmDialog": {
+			"title": "啟用自動刪除？",
+			"description": "每次VS Code重新啟動時，將永久刪除超過{{period}}天的工作。此操作無法復原。",
+			"descriptionNever": "自動刪除將被停用。您的工作歷程記錄將被保留。",
+			"confirm": "啟用自動刪除",
+			"confirmNever": "停用自動刪除",
+			"cancel": "取消"
+		},
 		"options": {
-			"never": "永不",
+			"never": "永不（預設）",
 			"90": "90天",
 			"60": "60天",
 			"30": "30天",
@@ -919,13 +926,12 @@
 		}
 	},
 	"taskHistoryStorage": {
-		"label": "儲存空間使用量",
-		"calculating": "計算中...",
-		"format": "{{size}} ({{count}} 個工作)",
-		"formatSingular": "{{size}} (1 個工作)",
-		"empty": "無已儲存工作",
-		"refresh": "重新整理",
-		"error": "無法計算"
+		"label": "工作歷程",
+		"clickToCount": "點擊計數",
+		"count": "歷程中有 {{count}} 個工作",
+		"countSingular": "歷程中有 1 個工作",
+		"empty": "尚無工作",
+		"refresh": "重新整理"
 	},
 	"footer": {
 		"telemetry": {

From 9c92200cf277c6d64344eb2b398668943e3742d6 Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Mon, 26 Jan 2026 18:55:56 -0700
Subject: [PATCH 36/37] chore: remove unused formatBytes.ts file

The file was left over after size calculation was removed from
task-storage-size.ts for performance reasons. Knip correctly detected
it as unused.
---
 src/utils/formatBytes.ts | 18 ------------------
 1 file changed, 18 deletions(-)
 delete mode 100644 src/utils/formatBytes.ts

diff --git a/src/utils/formatBytes.ts b/src/utils/formatBytes.ts
deleted file mode 100644
index 51a621fdd71..00000000000
--- a/src/utils/formatBytes.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-/**
- * Formats bytes into a human-readable string with appropriate units.
- *
- * Note: This is intentionally simple (base-2 / 1024) and consistent with existing
- * formatting expectations in tests and UI.
- */
-export function formatBytes(bytes: number): string {
-	if (bytes === 0) return "0 B"
-
-	const units = ["B", "KB", "MB", "GB", "TB"]
-	const k = 1024
-	const i = Math.min(Math.floor(Math.log(bytes) / Math.log(k)), units.length - 1)
-	const size = bytes / Math.pow(k, i)
-
-	// Use 2 decimal places for MB and above, 0 for B and KB
-	const decimals = i >= 2 ? 2 : 0
-	return `${size.toFixed(decimals)} ${units[i]}`
-}

From 30f2aa254659aad9b4a4969112de61b78404a8bd Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 28 Jan 2026 17:51:12 -0700
Subject: [PATCH 37/37] fix: address roomote review concerns

- Improve calculateTaskStorageSize() logging to show actual error message
  instead of generic 'directory not found'
- Serialize task deletions when using provider-backed deleteTaskById to
  avoid taskHistory state race conditions (parallel deletion kept for
  filesystem-only operations)
---
 src/utils/task-history-retention.ts | 93 ++++++++++++++++-------------
 src/utils/task-storage-size.ts      |  8 ++-
 2 files changed, 56 insertions(+), 45 deletions(-)

diff --git a/src/utils/task-history-retention.ts b/src/utils/task-history-retention.ts
index 824c2d28f06..7cbe60851de 100644
--- a/src/utils/task-history-retention.ts
+++ b/src/utils/task-history-retention.ts
@@ -246,7 +246,7 @@ export async function purgeOldTasks(
 		return { purgedCount: 0, cutoff }
 	}
 
-	// Phase 3: Delete tasks in parallel
+	// Phase 3: Delete tasks
 	if (dryRun) {
 		for (const { metadata, reason } of tasksToDelete) {
 			logv(`[Retention][DRY RUN] Would delete task ${metadata.taskId} (${reason}) @ ${metadata.taskDir}`)
@@ -257,52 +257,61 @@ export async function purgeOldTasks(
 		return { purgedCount: tasksToDelete.length, cutoff }
 	}
 
-	logv(`[Retention] Phase 3: Deleting ${tasksToDelete.length} tasks (concurrency: ${DELETION_CONCURRENCY})`)
-	const deleteLimit = pLimit(DELETION_CONCURRENCY)
+	// Helper function to delete a single task
+	const deleteTask = async (metadata: TaskMetadata, reason: string): Promise<boolean> => {
+		let deleted = false
 
-	const deleteResults = await Promise.all(
-		tasksToDelete.map(({ metadata, reason }) =>
-			deleteLimit(async (): Promise<boolean> => {
-				let deleted = false
+		try {
+			if (deleteTaskById) {
+				logv(`[Retention] Deleting task ${metadata.taskId} via provider @ ${metadata.taskDir} (${reason})`)
+				await deleteTaskById(metadata.taskId, metadata.taskDir)
+				deleted = !(await pathExists(metadata.taskDir))
+			} else {
+				logv(`[Retention] Deleting task ${metadata.taskId} via fs.rm @ ${metadata.taskDir} (${reason})`)
+				await fs.rm(metadata.taskDir, { recursive: true, force: true })
+				deleted = !(await pathExists(metadata.taskDir))
+			}
+		} catch (e) {
+			// Primary deletion failed, try fallback
+			logv(
+				`[Retention] Primary deletion failed for ${metadata.taskId}: ${
+					e instanceof Error ? e.message : String(e)
+				}`,
+			)
+		}
 
-				try {
-					if (deleteTaskById) {
-						logv(
-							`[Retention] Deleting task ${metadata.taskId} via provider @ ${metadata.taskDir} (${reason})`,
-						)
-						await deleteTaskById(metadata.taskId, metadata.taskDir)
-						deleted = !(await pathExists(metadata.taskDir))
-					} else {
-						logv(`[Retention] Deleting task ${metadata.taskId} via fs.rm @ ${metadata.taskDir} (${reason})`)
-						await fs.rm(metadata.taskDir, { recursive: true, force: true })
-						deleted = !(await pathExists(metadata.taskDir))
-					}
-				} catch (e) {
-					// Primary deletion failed, try fallback
-					logv(
-						`[Retention] Primary deletion failed for ${metadata.taskId}: ${
-							e instanceof Error ? e.message : String(e)
-						}`,
-					)
-				}
+		// Fallback: simplified removal
+		if (!deleted) {
+			deleted = await removeDir(metadata.taskDir)
+		}
 
-				// Fallback: simplified removal
-				if (!deleted) {
-					deleted = await removeDir(metadata.taskDir)
-				}
+		if (!deleted) {
+			log?.(`[Retention] Failed to delete task ${metadata.taskId} @ ${metadata.taskDir}: directory still present`)
+		} else {
+			logv(`[Retention] Deleted task ${metadata.taskId} (${reason}) @ ${metadata.taskDir}`)
+		}
 
-				if (!deleted) {
-					log?.(
-						`[Retention] Failed to delete task ${metadata.taskId} @ ${metadata.taskDir}: directory still present`,
-					)
-				} else {
-					logv(`[Retention] Deleted task ${metadata.taskId} (${reason}) @ ${metadata.taskDir}`)
-				}
+		return deleted
+	}
 
-				return deleted
-			}),
-		),
-	)
+	let deleteResults: boolean[]
+
+	if (deleteTaskById) {
+		// Sequential deletion when using provider-backed deletion to avoid taskHistory state races
+		logv(`[Retention] Phase 3: Deleting ${tasksToDelete.length} tasks sequentially (provider-backed)`)
+		deleteResults = []
+		for (const { metadata, reason } of tasksToDelete) {
+			const result = await deleteTask(metadata, reason)
+			deleteResults.push(result)
+		}
+	} else {
+		// Parallel deletion for filesystem-only operations (no shared state)
+		logv(`[Retention] Phase 3: Deleting ${tasksToDelete.length} tasks (concurrency: ${DELETION_CONCURRENCY})`)
+		const deleteLimit = pLimit(DELETION_CONCURRENCY)
+		deleteResults = await Promise.all(
+			tasksToDelete.map(({ metadata, reason }) => deleteLimit(() => deleteTask(metadata, reason))),
+		)
+	}
 
 	const purged = deleteResults.filter(Boolean).length
 
diff --git a/src/utils/task-storage-size.ts b/src/utils/task-storage-size.ts
index 46423c234f0..0bb493588cf 100644
--- a/src/utils/task-storage-size.ts
+++ b/src/utils/task-storage-size.ts
@@ -51,9 +51,11 @@ export async function calculateTaskStorageSize(
 	try {
 		const entries = await fs.readdir(tasksDir, { withFileTypes: true })
 		taskCount = entries.filter((d) => d.isDirectory()).length
-	} catch {
-		// Tasks directory doesn't exist yet
-		log?.(`[TaskStorageSize] Tasks directory not found at ${tasksDir}`)
+	} catch (e) {
+		// Tasks directory doesn't exist yet (or is unreadable)
+		log?.(
+			`[TaskStorageSize] Failed to read tasks directory at ${tasksDir}: ${e instanceof Error ? e.message : String(e)}`,
+		)
 		return defaultResult
 	}