Function readWithIndentation

src/integrations/misc/indentation-reader.ts:288–424

(content: string, options: IndentationReadOptions)

 * @returns The extracted content with metadata
 */
export function readWithIndentation(content: string, options: IndentationReadOptions): IndentationReadResult {
	const {
		anchorLine,
		maxLevels = DEFAULT_MAX_LEVELS,
		includeSiblings = false,
		includeHeader = true,
		limit = DEFAULT_LINE_LIMIT,
		maxLines,
	} = options

	const lines = parseLines(content)
	const totalLines = lines.length

	// Validate anchor line
	if (anchorLine < 1 || anchorLine > totalLines) {
		return {
			content: `Error: anchor_line ${anchorLine} is out of range (1-${totalLines})`,
			includedRanges: [],
			totalLines,
			returnedLines: 0,
			wasTruncated: false,
		}
	}

	const anchorIdx = anchorLine - 1 // Convert to 0-based
	const effectiveIndents = computeEffectiveIndents(lines)
	const anchorIndent = effectiveIndents[anchorIdx]

	// Calculate minimum indent threshold
	// maxLevels = 0 means unlimited (minIndent = 0)
	// maxLevels > 0 means limit to that many levels above anchor
	let minIndent: number
	if (maxLevels === 0) {
		minIndent = 0
	} else {
		// Each "level" is INDENT_SIZE spaces worth of indentation
		// We subtract maxLevels from the anchor's indent level
		minIndent = Math.max(0, anchorIndent - maxLevels)
	}

	// Calculate final limit (use maxLines as hard cap if provided)
	const guardLimit = maxLines ?? limit
	const finalLimit = Math.min(limit, guardLimit, totalLines)

	// Edge case: if limit is 1, just return the anchor line
	if (finalLimit === 1) {
		const singleLine = [lines[anchorIdx]]
		return {
			content: formatWithLineNumbers(singleLine),
			includedRanges: [[anchorLine, anchorLine]],
			totalLines,
			returnedLines: 1,
			wasTruncated: totalLines > 1,
		}
	}

	// Bidirectional expansion from anchor (Codex algorithm)
	const result: LineRecord[] = [lines[anchorIdx]]