Enable preventFocusDisruption experiment by default

Set the PREVENT_FOCUS_DISRUPTION experiment to be enabled by default in experimentConfigsMap and updated related tests to reflect this change. Added a configuration reference documentation file to clarify where and how to modify key settings.

Author: HumbleBee14

extensions/roopik-roo/docs/CONFIGURATION_REFERENCE.md

@@ -0,0 +1,30 @@
+# Configuration Reference
+
+Quick reference for where to find and modify key configurations in the Roopik IDE and roopik-roo extension.
+
+## Experimental Settings (Dio Agent)
+
+### Background Editing (preventFocusDisruption)
+
+**Default:** `true` (enabled)
+
+Prevents editor focus disruption when Dio makes file edits. Files are edited in the background without opening diff views or stealing focus.
+
+**Files:**
+- `extensions/roopik-roo/src/shared/experiments.ts` - Default value in `experimentConfigsMap`
+- `extensions/roopik-roo/packages/types/src/experiment.ts` - Schema definition
+- `extensions/roopik-roo/webview-ui/src/i18n/locales/en/settings.json` - UI labels
+
+**Tests:**
+- `extensions/roopik-roo/src/shared/__tests__/experiments.spec.ts`
+- `extensions/roopik-roo/src/shared/__tests__/experiments-preventFocusDisruption.spec.ts`
+
+---
+
+## Tool Definitions (MCP & Native Tools)
+
+### Tool Descriptions and Parameters
+
+**Files:**
+- `extensions/roopik-roo/src/core/prompts/tools/native-tools/roopik.ts` - OpenAI-compatible tool schemas (component_add, project_start, etc.)
+- `extensions/roopik-roo/src/core/prompts/tools/roopik/roopik-tools.ts` - XML-style tool descriptions and workflow documentation

extensions/roopik-roo/src/shared/__tests__/experiments-preventFocusDisruption.spec.ts

@@ -7,24 +7,24 @@ describe("PREVENT_FOCUS_DISRUPTION experiment", () => {
 
 	it("should have PREVENT_FOCUS_DISRUPTION in experimentConfigsMap", () => {
 		expect(experimentConfigsMap.PREVENT_FOCUS_DISRUPTION).toBeDefined()
-		expect(experimentConfigsMap.PREVENT_FOCUS_DISRUPTION.enabled).toBe(false)
+		expect(experimentConfigsMap.PREVENT_FOCUS_DISRUPTION.enabled).toBe(true) // Enabled by default
 	})
 
 	it("should have PREVENT_FOCUS_DISRUPTION in experimentDefault", () => {
-		expect(experimentDefault.preventFocusDisruption).toBe(false)
+		expect(experimentDefault.preventFocusDisruption).toBe(true) // Enabled by default
 	})
 
 	it("should correctly check if PREVENT_FOCUS_DISRUPTION is enabled", () => {
-		// Test when experiment is disabled (default)
+		// Test when experiment is explicitly disabled
 		const disabledConfig = { preventFocusDisruption: false }
 		expect(experiments.isEnabled(disabledConfig, EXPERIMENT_IDS.PREVENT_FOCUS_DISRUPTION)).toBe(false)
 
 		// Test when experiment is enabled
 		const enabledConfig = { preventFocusDisruption: true }
 		expect(experiments.isEnabled(enabledConfig, EXPERIMENT_IDS.PREVENT_FOCUS_DISRUPTION)).toBe(true)
 
-		// Test when experiment is not in config (should use default)
+		// Test when experiment is not in config (should use default = true)
 		const emptyConfig = {}
-		expect(experiments.isEnabled(emptyConfig, EXPERIMENT_IDS.PREVENT_FOCUS_DISRUPTION)).toBe(false)
+		expect(experiments.isEnabled(emptyConfig, EXPERIMENT_IDS.PREVENT_FOCUS_DISRUPTION)).toBe(true)
 	})
 })

extensions/roopik-roo/src/shared/__tests__/experiments.spec.ts

@@ -9,7 +9,7 @@ describe("experiments", () => {
 		it("is configured correctly", () => {
 			expect(EXPERIMENT_IDS.PREVENT_FOCUS_DISRUPTION).toBe("preventFocusDisruption")
 			expect(experimentConfigsMap.PREVENT_FOCUS_DISRUPTION).toMatchObject({
-				enabled: false,
+				enabled: true, // Enabled by default
 			})
 		})
 	})

extensions/roopik-roo/src/shared/experiments.ts

@@ -17,7 +17,7 @@ interface ExperimentConfig {
 }
 
 export const experimentConfigsMap: Record<ExperimentKey, ExperimentConfig> = {
-	PREVENT_FOCUS_DISRUPTION: { enabled: false },
+	PREVENT_FOCUS_DISRUPTION: { enabled: true }, // Enabled by default - prevents editor focus disruption during AI edits
 	IMAGE_GENERATION: { enabled: false },
 	RUN_SLASH_COMMAND: { enabled: false },
 	MULTIPLE_NATIVE_TOOL_CALLS: { enabled: false },