Function write_page

skills/mini-context-graph/scripts/tools/wiki_store.py:123–176

Write (or overwrite) a wiki page. The agent provides the full markdown content. This method handles: - Writes the .md file to the appropriate category subfolder. - Updates index.md with a one-line entry. - Appends an entry to log.md. Args: category: One of "entity"

(
    category: str,
    title: str,
    content: str,
    summary: str = "",
)

# ---------------------------------------------------------------------------

def write_page(
    category: str,
    title: str,
    content: str,
    summary: str = "",
) -> str:
    """
    Write (or overwrite) a wiki page.

    The agent provides the full markdown content. This method handles:
    - Writes the .md file to the appropriate category subfolder.
    - Updates index.md with a one-line entry.
    - Appends an entry to log.md.

    Args:
        category: One of "entity", "summary", "topic".
        title:    Human-readable page title (used for slug + index).
        content:  Full markdown content the agent wrote.
        summary:  One-line summary for the index (optional; auto-extracted if empty).

    Returns:
        Relative path from wiki root (e.g. "entities/memory-leak.md").
    """
    _ensure_dirs()
    slug = _slug(title)
    path = _page_path(category, slug)

    # Auto-extract first non-heading, non-empty line as summary if not provided
    if not summary:
        for line in content.splitlines():
            stripped = line.strip()
            if stripped and not stripped.startswith("#"):
                summary = stripped[:100]
                break

    path.write_text(content)

    # Update index
    entries = _load_index()
    existing = next((e for e in entries if e["slug"] == slug), None)
    if existing:
        existing["summary"] = summary
        existing["date"] = _now_iso()
    else:
        entries.append({
            "slug": slug,
            "category": category,
            "summary": summary,
            "date": _now_iso(),
        })
    _save_index(entries)
    _append_log("write", title)

    return str(path.relative_to(_WIKI_DIR))


def read_page(category: str, title: str) -> str | None: