HKUDS/DeepTutor · error · VaultError

Note {_with_md_suffix(rel_path)!r} already exists; use appen

Error message

Note {_with_md_suffix(rel_path)!r} already exists; use append instead.

What it means

Error "Note {_with_md_suffix(rel_path)!r} already exists; use append instead." thrown in HKUDS/DeepTutor.

Source

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

    return [{"tag": tag, "count": count} for tag, count in ranked[:limit]]


# --- write operations (additive only) ---------------------------------------


def create_note(
    root: Path,
    rel_path: str,
    content: str,
    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."""

View on GitHub (pinned to 3e82f13042)

When it happens

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