Function _backlink_summary_pages

openkb/agent/compiler.py:1211–1238

Append missing ``[[{page_dir}/slug]]`` wikilinks to the summary page. Closes the bidirectional link the pages already hold toward the summary, inserting them under ``section`` (created if absent). Shared by the concept and entity summary-backlink wrappers below.

(
    wiki_dir: Path,
    doc_name: str,
    slugs: list[str],
    *,
    page_dir: str,
    section: str,
)

def _backlink_summary_pages(
    wiki_dir: Path,
    doc_name: str,
    slugs: list[str],
    *,
    page_dir: str,
    section: str,
) -> None:
    """Append missing ``[[{page_dir}/slug]]`` wikilinks to the summary page.

    Closes the bidirectional link the pages already hold toward the summary,
    inserting them under ``section`` (created if absent). Shared by the
    concept and entity summary-backlink wrappers below.
    """
    summary_path = wiki_dir / "summaries" / f"{doc_name}.md"
    if not summary_path.exists():
        return

    text = summary_path.read_text(encoding="utf-8")
    missing = [slug for slug in slugs if f"[[{page_dir}/{slug}]]" not in text]
    if not missing:
        return

    lines = text.split("\n")
    _ensure_h2_section(lines, section, quiet=True)
    for slug in reversed(missing):
        _insert_section_entry(lines, section, f"- [[{page_dir}/{slug}]]")
    atomic_write_text(summary_path, "\n".join(lines))


def _backlink_pages(