Function _read_entity_briefs

openkb/agent/compiler.py:738–767

Read existing entity pages as compact lines for the plan call. Formats each as ``- {slug} ({type}, {n} sources) — {brief}``. The source count is the cross-document recurrence signal the LLM uses to decide create-vs-update and salience. Returns "(none yet)" when empty.

(wiki_dir: Path)

def _read_entity_briefs(wiki_dir: Path) -> str:
    """Read existing entity pages as compact lines for the plan call.

    Formats each as ``- {slug} ({type}, {n} sources) — {brief}``. The source
    count is the cross-document recurrence signal the LLM uses to decide
    create-vs-update and salience. Returns "(none yet)" when empty.
    """
    entities_dir = wiki_dir / "entities"
    if not entities_dir.exists():
        return "(none yet)"

    md_files = sorted(entities_dir.glob("*.md"))
    if not md_files:
        return "(none yet)"

    lines: list[str] = []
    for path in md_files:
        text = path.read_text(encoding="utf-8")
        fm_dict = frontmatter.parse(text)
        brief = _resolve_description(fm_dict)
        etype = str(fm_dict.get("type") or "").strip().lower() or "other"
        n_sources = len(fm_dict["sources"]) if isinstance(fm_dict.get("sources"), list) else 0
        if not brief:
            parts = frontmatter.split(text)
            body = parts[1] if parts is not None else text
            brief = body.strip().replace("\n", " ")[:150]
        suffix = f" — {brief}" if brief else ""
        lines.append(f"- {path.stem} ({etype}, {n_sources} sources){suffix}")

    return "\n".join(lines) or "(none yet)"


def _iter_h2_headings(lines: list[str]) -> list[tuple[int, str]]: