mindin

CHEAP — start here. Full-text search over the local SQLite index of the vault; it never downloads the whole vault. Matches file stem, title, summary, tags and body, folds diacritics, expands synonyms and accepts "quoted phrases". A bare commit sha looks up the notes that mention it. A query that is exactly a note's stem, or its [[stem]] wikilink, puts that note first wherever it lives. Every term is required; when no note has them all, it returns the notes matching the most terms and says so in the header. Inflected forms match through stemming in the vault's languages. Search in the vault's language first; when nothing matches, translate the terms into the vault's other languages and search again, and the reply names them. Excludes the archive and superseded notes unless you ask for them, and reports how many it hid.

MODERATE — one round trip to storage. Returns the note with an `etag:` first line; pass that etag back to write_file to refuse a write over someone else's change. Search first. `.vault/schema.yml` reads the vault's schema.

WRITE — validates the frontmatter against the vault schema and refuses the write if it does not hold. Stamps `updated` with today and fills `date` when missing. Pass expected_etag from read_file to make the write conditional, or "*" to create a note that must not exist yet.

WRITE — appends to an existing note and bumps `updated`; the note must still satisfy the schema. A missing note is refused: create it with write_file.

WRITE — moves or renames a note; the note must satisfy the schema at the destination. Use `close` to archive finished work.

WRITE — deletes a note for good. Prefer `close`, which keeps it.

CHEAP — paths only, no metadata and no bodies. `search` answers context questions better.

WRITE — changes a note's status without rewriting it: backlog (with a priority: urgent, high, medium, low) parks it, active picks it up again, draft. The triage list at session start is settled with this, append_file or close.

WRITE — finishes a note: sets status complete (or superseded with superseded_by when merged_into is given) and moves it into the archive. Run it in the same pass as the last commit of the work; a note left open is what makes the vault drift.

WRITE — files an idea as a backlog note in the task folder: title, area (stem or [[stem]]), one line saying what and why, optional priority (urgent, high, medium, low) and source (who said it and when, or a sha). Call it the moment something is deferred, in so many words or in passing; picking the idea up later is setting its status to active.

CHEAP — the backlog sorted by priority then age. Filter by area (a stem, or the prefix a family of stems shares) and by priority.

WRITE — appends one dated line to the repo log, with the commits it produced. Run once at the end of a session per repo. Creates the log note when it is missing. repo is the main checkout's name, also from a worktree; branch is the branch the commits were made on. area is the stem of the system note (or [[stem]]); it defaults to the repo name.

CHEAP — the session-start call. Returns the system notes covering the code at `path`, the open tasks for it, the reference notes and the tail of the repo log, in one answer. Use it before searching blind. format "json" adds the system notes' paths and dates and the triage keys, for hooks that read it.

CHEAP — who this connection signs in as and whether it may write. Answers JSON.

Takes no parameters.

MODERATE — reads every note to report drift: broken frontmatter, missing required fields, missing area, unresolved wikilinks, orphans, stale open tasks, archived notes still marked active, duplicate stems and superseded targets that do not exist.

Takes no parameters.

WRITE — sets a vault up: writes `.vault/schema.yml` and the Obsidian Bases views into the vault root. Run once per vault, right after installing. preset picks the layout of a vault without a schema: default, para, simple, journal, custom; without it, the vault gets default. On a vault that has a schema, it only writes the views that are missing and keeps the rest; a layout is switched with the CLI (`init --preset <name> --force`) or on the account page, never through this tool.