Function _remove_source_from_frontmatter

openkb/agent/compiler.py:1140–1177

Remove ``source_file`` from the inline ``sources:`` list in YAML frontmatter. Returns ``(rewritten_text, sources_now_empty)``. ``sources_now_empty`` is True when ``source_file`` was the only remaining item in the list (callers can use this to decide whether to delete the page entirely).

(text: str, source_file: str)

def _remove_source_from_frontmatter(text: str, source_file: str) -> tuple[str, bool]:
    """Remove ``source_file`` from the inline ``sources:`` list in YAML frontmatter.

    Returns ``(rewritten_text, sources_now_empty)``. ``sources_now_empty`` is
    True when ``source_file`` was the only remaining item in the list (callers
    can use this to decide whether to delete the page entirely).

    If the frontmatter is missing, malformed, has no ``sources:`` line, or
    the source is not present in the list, returns ``(text, False)``.
    """
    if not text.startswith("---"):
        return text, False

    parts = frontmatter.split(text)
    if parts is None:
        return text, False

    fm_block, body = parts
    # See _prepend_source_to_frontmatter: the closing delimiter may be "\n---\n"
    # or a bare "\n---" (no trailing newline); strip whichever is present so the
    # existing frontmatter lines (and the sources: line we need) are preserved.
    closing = "\n---\n" if fm_block.endswith("\n---\n") else "\n---"
    fm_prefix = fm_block[: -len(closing)]
    fm_lines = fm_prefix.split("\n")

    for i, line in enumerate(fm_lines):
        if not line.lstrip().startswith("sources:"):
            continue
        items = _parse_yaml_list_value(line)
        if items is None:
            return text, False
        if source_file not in items:
            return text, False
        items.remove(source_file)
        fm_lines[i] = _yaml_list_line("sources", items)
        return "\n".join(fm_lines) + closing + body, len(items) == 0

    return text, False


def _add_related_link(