HKUDS/DeepTutor · error · VaultError

Note {ref!r} not found; create it first.

Error message

Note {ref!r} not found; create it first.

What it means

Error "Note {ref!r} not found; create it first." thrown in HKUDS/DeepTutor.

Source

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

    frontmatter: dict[str, Any] | None = None,
) -> str:
    """Create a new ``.md`` note. Refuses to overwrite an existing file."""
    rel_path = (rel_path or "").strip()
    if not rel_path:
        raise VaultError("create_note needs a non-empty path.")
    path = _safe_join(root, _with_md_suffix(rel_path))
    if path.exists():
        raise VaultError(f"Note {_with_md_suffix(rel_path)!r} already exists; use append instead.")
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(_compose_note(frontmatter or {}, content or ""), encoding="utf-8")
    return _rel(root, path)


def append_note(root: Path, ref: str, content: str) -> str:
    """Append text to the end of an existing note."""
    path = resolve_note(root, ref)
    if path is None:
        raise VaultError(f"Note {ref!r} not found; create it first.")
    existing = _read_text_exact(path)
    separator = "" if existing.endswith("\n") or not existing else "\n"
    path.write_text(existing + separator + (content or ""), encoding="utf-8")
    return _rel(root, path)


def set_property(root: Path, ref: str, key: str, value: Any) -> str:
    """Set a single frontmatter property on an existing note."""
    key = (key or "").strip()
    if not key:
        raise VaultError("set_property needs a non-empty key.")
    path = resolve_note(root, ref)
    if path is None:
        raise VaultError(f"Note {ref!r} not found; create it first.")
    frontmatter, body = split_frontmatter(_read_text_exact(path))
    frontmatter[key] = value
    path.write_text(_compose_note(frontmatter, body), encoding="utf-8")
    return _rel(root, path)

View on GitHub (pinned to 3e82f13042)

When it happens

Trigger: Thrown at deeptutor/capabilities/obsidian/vault.py:289 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/fd0ea7afbcd310f7. Report an issue: GitHub.