Function remove_doc_from_index

openkb/agent/compiler.py:1448–1481

Remove the document's entry from ``index.md`` along with any concept and entity entries for pages that were deleted as a side effect. No-op when ``index.md`` doesn't exist. Section headings are kept even when their last entry is removed — adding a new doc later repopulates them.

(
    wiki_dir: Path,
    doc_name: str,
    concept_slugs_deleted: list[str],
    entity_slugs_deleted: list[str] | None = None,
)

def remove_doc_from_index(
    wiki_dir: Path,
    doc_name: str,
    concept_slugs_deleted: list[str],
    entity_slugs_deleted: list[str] | None = None,
) -> None:
    """Remove the document's entry from ``index.md`` along with any concept
    and entity entries for pages that were deleted as a side effect.

    No-op when ``index.md`` doesn't exist. Section headings are kept even
    when their last entry is removed — adding a new doc later repopulates
    them.
    """
    index_path = wiki_dir / "index.md"
    if not index_path.exists():
        return

    lines = index_path.read_text(encoding="utf-8").split("\n")

    doc_link = f"[[summaries/{doc_name}]]"
    while _remove_section_entry(lines, "## Documents", doc_link):
        pass

    for slug in concept_slugs_deleted:
        concept_link = f"[[concepts/{slug}]]"
        while _remove_section_entry(lines, "## Concepts", concept_link):
            pass

    for slug in entity_slugs_deleted or []:
        entity_link = f"[[entities/{slug}]]"
        while _remove_section_entry(lines, "## Entities", entity_link):
            pass

    atomic_write_text(index_path, "\n".join(lines))


def _update_index(