Function _read_concept_briefs

openkb/agent/compiler.py:705–735

Read existing concept pages and return compact one-line summaries. For each concept, reads the ``description:`` field (falling back to legacy ``brief:``) from YAML frontmatter if present; otherwise falls back to truncating the first 150 chars of the body (newlines collapsed to spaces).

(wiki_dir: Path)

def _read_concept_briefs(wiki_dir: Path) -> str:
    """Read existing concept pages and return compact one-line summaries.

    For each concept, reads the ``description:`` field (falling back to legacy
    ``brief:``) from YAML frontmatter if present; otherwise falls back to
    truncating the first 150 chars of the body (newlines collapsed to spaces).
    Formats each as ``- {slug}: {description}``.

    Returns "(none yet)" if the concepts directory is missing or empty.
    """
    concepts_dir = wiki_dir / "concepts"
    if not concepts_dir.exists():
        return "(none yet)"

    md_files = sorted(concepts_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)
        if not brief:
            parts = frontmatter.split(text)
            body = parts[1] if parts is not None else text
            brief = body.strip().replace("\n", " ")[:150]
        if brief:
            lines.append(f"- {path.stem}: {brief}")

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


def _read_entity_briefs(wiki_dir: Path) -> str: