Function run_knowledge_lint

openkb/agent/linter.py:92–119

Run the semantic knowledge lint agent against the wiki. Args: kb_dir: Root of the knowledge base. model: LLM model name. Returns: The agent's lint report as a Markdown string.

(kb_dir: Path, model: str)

async def run_knowledge_lint(kb_dir: Path, model: str) -> str:
    """Run the semantic knowledge lint agent against the wiki.

    Args:
        kb_dir: Root of the knowledge base.
        model: LLM model name.

    Returns:
        The agent's lint report as a Markdown string.
    """
    from openkb.config import load_config

    openkb_dir = kb_dir / ".openkb"
    config = load_config(openkb_dir / "config.yaml")
    language: str = config.get("language", "en")

    wiki_root = str(kb_dir / "wiki")
    agent = build_lint_agent(wiki_root, model, language=language)

    prompt = (
        "Please audit this knowledge base wiki for semantic quality issues: "
        "contradictions, gaps, staleness, redundancy, and missing concept and "
        "entity pages. Start with index.md, then read summaries, concepts, and "
        "entities as needed. Produce a structured Markdown report."
    )

    result = await Runner.run(agent, prompt, max_turns=MAX_TURNS)
    return result.final_output or "Knowledge lint completed. No output produced."