feat: implement parentRulesMaxDepth setting

This commit implements the parentRulesMaxDepth setting which controls how many parent directories are searched for .roo/rules files. The setting is accessible from the Modes view and persists across sessions.

Key changes:
- Added parentRulesMaxDepth to the global settings schema
- Added UI component in ModesView.tsx with improved styling
- Updated state management to properly persist the setting

Signed-off-by: Eric Wheeler <[email protected]>

Author: Eric Wheeler

packages/types/src/global-settings.ts

@@ -48,6 +48,7 @@ export const globalSettingsSchema = z.object({
 	allowedCommands: z.array(z.string()).optional(),
 	allowedMaxRequests: z.number().nullish(),
 	autoCondenseContext: z.boolean().optional(),
+	parentRulesMaxDepth: z.number().min(1).optional(),
 	autoCondenseContextPercent: z.number().optional(),
 	maxConcurrentFileReads: z.number().optional(),
 

src/core/webview/ClineProvider.ts

@@ -1402,6 +1402,7 @@ export class ClineProvider
 			terminalCompressProgressBar,
 			historyPreviewCollapsed,
 			cloudUserInfo,
+			parentRulesMaxDepth,
 			cloudIsAuthenticated,
 			sharingEnabled,
 			organizationAllowList,
@@ -1490,6 +1491,7 @@ export class ClineProvider
 			maxOpenTabsContext: maxOpenTabsContext ?? 20,
 			maxWorkspaceFiles: maxWorkspaceFiles ?? 200,
 			cwd,
+			parentRulesMaxDepth: parentRulesMaxDepth ?? 1,
 			browserToolEnabled: browserToolEnabled ?? true,
 			telemetrySetting,
 			telemetryKey,
@@ -1654,6 +1656,7 @@ export class ClineProvider
 			showRooIgnoredFiles: stateValues.showRooIgnoredFiles ?? true,
 			maxReadFileLine: stateValues.maxReadFileLine ?? -1,
 			maxConcurrentFileReads: stateValues.maxConcurrentFileReads ?? 5,
+			parentRulesMaxDepth: stateValues.parentRulesMaxDepth ?? 1,
 			historyPreviewCollapsed: stateValues.historyPreviewCollapsed ?? false,
 			cloudUserInfo,
 			cloudIsAuthenticated,

src/core/webview/webviewMessageHandler.ts

@@ -193,6 +193,10 @@ export const webviewMessageHandler = async (
 			await updateGlobalState("autoCondenseContextPercent", message.value)
 			await provider.postStateToWebview()
 			break
+		case "parentRulesMaxDepth":
+			await updateGlobalState("parentRulesMaxDepth", Math.max(1, message.value ?? 1))
+			await provider.postStateToWebview()
+			break
 		case "terminalOperation":
 			if (message.terminalOperation) {
 				provider.getCurrentCline()?.handleTerminalOperation(message.terminalOperation)

src/services/roo-config/index.ts

@@ -1,6 +1,8 @@
 import * as path from "path"
 import * as os from "os"
 import fs from "fs/promises"
+import { string } from "zod"
+import { dir } from "console"
 
 /**
  * Gets the global .roo directory path based on the current platform
@@ -145,15 +147,48 @@ export async function readFileIfExists(filePath: string): Promise<string | null>
  * ```
  */
 export function getRooDirectoriesForCwd(cwd: string): string[] {
-	const directories: string[] = []
+	const directories: Set<string> = new Set<string>()
 
 	// Add global directory first
-	directories.push(getGlobalRooDirectory())
+	directories.add(getGlobalRooDirectory())
 
-	// Add project-local directory second
-	directories.push(getProjectRooDirectoryForCwd(cwd))
+	// Add project and any parent directories
+	let currentCwd = path.resolve(cwd)
+	const rootDir = path.parse(currentCwd).root
 
-	return directories
+	// Get parentRulesMaxDepth from global state
+	let maxDepth = 1
+	try {
+		const { ContextProxy } = require("../../core/config/ContextProxy")
+		maxDepth = ContextProxy.instance?.getValue("parentRulesMaxDepth") ?? 1
+		console.log("Using parentRulesMaxDepth:", maxDepth)
+	} catch (error) {
+		// In test environments, ContextProxy might not be initialized
+		// Fall back to default value of 1
+		console.error("Using default parentRulesMaxDepth: 1", error)
+	}
+
+	let currentDepth = 0
+
+	// Loop from initialCwd up to root or until max depth is reached
+	while (currentDepth < maxDepth) {
+		directories.add(getProjectRooDirectoryForCwd(currentCwd))
+
+		// Stop if we've reached the root directory
+		if (currentCwd === rootDir) {
+			break
+		}
+		const parentCwd = path.resolve(currentCwd, "..")
+
+		// Safety break if path.resolve doesn't change currentCwd (e.g., already at root)
+		if (parentCwd === currentCwd) {
+			break
+		}
+		currentCwd = parentCwd
+		currentDepth++
+	}
+
+	return Array.from(directories).sort()
 }
 
 /**

src/shared/ExtensionMessage.ts

@@ -203,6 +203,7 @@ export type ExtensionState = Pick<
 	| "fuzzyMatchThreshold"
 	// | "experiments" // Optional in GlobalSettings, required here.
 	| "language"
+	| "parentRulesMaxDepth"
 	// | "telemetrySetting" // Optional in GlobalSettings, required here.
 	// | "mcpEnabled" // Optional in GlobalSettings, required here.
 	// | "enableMcpServerCreation" // Optional in GlobalSettings, required here.

src/shared/WebviewMessage.ts

@@ -100,6 +100,7 @@ export interface WebviewMessage {
 		| "enhancePrompt"
 		| "enhancedPrompt"
 		| "draggedImages"
+		| "parentRulesMaxDepth"
 		| "deleteMessage"
 		| "terminalOutputLineLimit"
 		| "terminalShellIntegrationTimeout"

webview-ui/src/components/modes/ModesView.tsx

@@ -73,6 +73,8 @@ const ModesView = ({ onDone }: ModesViewProps) => {
 		customInstructions,
 		setCustomInstructions,
 		customModes,
+		parentRulesMaxDepth,
+		setParentRulesMaxDepth,
 	} = useExtensionState()
 
 	// Use a local state to track the visually active mode
@@ -1032,6 +1034,30 @@ const ModesView = ({ onDone }: ModesViewProps) => {
 					</div>
 				</div>
 
+				{/* Parent Rules Max Depth Setting */}
+				<div className="mt-4 mb-4">
+					<div className="font-bold mb-1">{t("settings:prompts.parentRulesMaxDepth.label")}</div>
+					<div className="flex items-center gap-2 mt-1">
+						<input
+							type="number"
+							className="w-16 bg-vscode-input-background text-vscode-input-foreground border border-vscode-input-border px-2 py-1 rounded text-right disabled:opacity-50"
+							min="1"
+							value={parentRulesMaxDepth ?? 1}
+							onChange={(e) => {
+								const value = Math.max(1, parseInt(e.target.value) || 1)
+								setParentRulesMaxDepth(value)
+								vscode.postMessage({
+									type: "parentRulesMaxDepth",
+									value: value,
+								})
+							}}
+						/>
+					</div>
+					<div className="text-xs text-vscode-descriptionForeground mt-1">
+						{t("settings:prompts.parentRulesMaxDepth.description")}
+					</div>
+				</div>
+
 				<div className="pb-4 border-b border-vscode-input-border">
 					<div className="flex gap-2">
 						<Button

webview-ui/src/context/ExtensionStateContext.tsx

@@ -40,6 +40,8 @@ export interface ExtensionStateContextType extends ExtensionState {
 	mdmCompliant?: boolean
 	hasOpenedModeSelector: boolean // New property to track if user has opened mode selector
 	setHasOpenedModeSelector: (value: boolean) => void // Setter for the new property
+	parentRulesMaxDepth?: number
+	setParentRulesMaxDepth: (value: number) => void
 	condensingApiConfigId?: string
 	setCondensingApiConfigId: (value: string) => void
 	customCondensingPrompt?: string
@@ -205,6 +207,7 @@ export const ExtensionStateContextProvider: React.FC<{ children: React.ReactNode
 		sharingEnabled: false,
 		organizationAllowList: ORGANIZATION_ALLOW_ALL,
 		autoCondenseContext: true,
+		parentRulesMaxDepth: 1, // Default value for parentRulesMaxDepth
 		autoCondenseContextPercent: 100,
 		profileThresholds: {},
 		codebaseIndexConfig: {
@@ -438,6 +441,8 @@ export const ExtensionStateContextProvider: React.FC<{ children: React.ReactNode
 		setCustomCondensingPrompt: (value) =>
 			setState((prevState) => ({ ...prevState, customCondensingPrompt: value })),
 		setProfileThresholds: (value) => setState((prevState) => ({ ...prevState, profileThresholds: value })),
+		setParentRulesMaxDepth: (value: number) =>
+			setState((prevState) => ({ ...prevState, parentRulesMaxDepth: value })),
 	}
 
 	return <ExtensionStateContext.Provider value={contextValue}>{children}</ExtensionStateContext.Provider>

webview-ui/src/i18n/locales/en/settings.json

@@ -34,7 +34,11 @@
 		"about": "About Roo Code"
 	},
 	"prompts": {
-		"description": "Configure support prompts that are used for quick actions like enhancing prompts, explaining code, and fixing issues. These prompts help Roo provide better assistance for common development tasks."
+		"description": "Configure support prompts that are used for quick actions like enhancing prompts, explaining code, and fixing issues. These prompts help Roo provide better assistance for common development tasks.",
+		"parentRulesMaxDepth": {
+			"label": "Parent Rule Search Levels",
+			"description": "Maximum directory levels to search upward for .roo/rules. Default: 1 (workspace directory only). Higher values enable hierarchical loading from parent directories (feature, repository, organization, user-global, etc, …), where large values search to the filesystem root."
+		}
 	},
 	"codeIndex": {
 		"title": "Codebase Indexing",