HKUDS/DeepTutor · error · VaultError

Note {ref!r} not found in the vault.

Error message

Note {ref!r} not found in the vault.

What it means

Error "Note {ref!r} not found in the vault." thrown in HKUDS/DeepTutor.

Source

Thrown at deeptutor/capabilities/obsidian/vault.py:167

def _snippet(body: str, query: str, width: int = 160) -> str:
    lowered = body.lower()
    idx = lowered.find(query.lower())
    if idx < 0:
        return body[:width].strip().replace("\n", " ")
    start = max(0, idx - width // 3)
    return ("…" if start else "") + body[start : start + width].strip().replace("\n", " ") + "…"


# --- read operations --------------------------------------------------------


def read_note(root: Path, ref: str) -> dict[str, Any]:
    """Return ``{path, frontmatter, body}`` for a note, or raise ``VaultError``."""
    path = resolve_note(root, ref)
    if path is None:
        raise VaultError(f"Note {ref!r} not found in the vault.")
    text = _read_text(path)
    frontmatter, body = split_frontmatter(text)
    return {"path": _rel(root, path), "frontmatter": frontmatter, "body": body}


def search_notes(root: Path, query: str, limit: int = 20) -> list[dict[str, str]]:
    """Case-insensitive substring search over note titles and bodies."""
    query = (query or "").strip()
    if not query:
        return []
    needle = query.lower()
    hits: list[dict[str, str]] = []
    for path in _iter_markdown(root):
        try:
            text = _read_text(path)
        except OSError:
            continue
        if needle in path.stem.lower() or needle in text.lower():

View on GitHub (pinned to 3e82f13042)

When it happens

Trigger: Thrown at deeptutor/capabilities/obsidian/vault.py:167 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/a32cec543f7bf3a5. Report an issue: GitHub.