Function _iter_h2_headings

openkb/agent/compiler.py:770–781

Return ``[(line_index, normalized_heading), ...]`` for every ATX H2. A line counts as H2 when it starts with ``"## "`` (two hashes + space). ``normalized_heading`` is the line with trailing whitespace stripped, so ``"## Documents "`` normalizes to ``"## Documents"`` — letting callers

(lines: list[str])

def _iter_h2_headings(lines: list[str]) -> list[tuple[int, str]]:
    """Return ``[(line_index, normalized_heading), ...]`` for every ATX H2.

    A line counts as H2 when it starts with ``"## "`` (two hashes + space).
    ``normalized_heading`` is the line with trailing whitespace stripped, so
    ``"## Documents "`` normalizes to ``"## Documents"`` — letting callers
    use exact-string comparison without tripping on stray whitespace.

    Used by ``_get_section_bounds`` so heading lookup and the next-section
    boundary share one scan and one normalization rule.
    """
    return [(i, line.rstrip()) for i, line in enumerate(lines) if line.startswith("## ")]


def _get_section_bounds(lines: list[str], heading: str) -> tuple[int, int] | None: