Defensive: if the API payload lacks 'frontmatter' entirely, treat it as no-frontmatter rather than KeyError.

The API can return frontmatter: null for some edge cases — wrapper must coerce to {}.

A note without YAML frontmatter must yield {} — never an error and never None.

The server returns frontmatter pre-parsed; the wrapper hands it through verbatim, including nested structures.

Must request the Local REST API's NoteJson view, not the plain text view.

For target_type='block' or 'frontmatter', a 40080 error must propagate as-is.

PATCH endpoint rejects charset in Content-Type (error 40012), so we send the body as utf-8 bytes but keep the header plain 'text/markdown'.

Two consecutive put_content calls each send their own full body — the second is not appended to the first. This is the overwrite contract.

End-to-end shape: put_content(c) → get_file_contents() returns c. Uses two independent mocks since the real API stores state between calls; he

The entire content arg must arrive as the request body — this is the contract that makes put_content suitable for full-file overwrites.

put_content must hit PUT /vault/{filepath} — not POST (append) or PATCH.

A target already containing '::' must skip the fallback entirely.

The wrapper extracts just the filename list from the API's {filename,result} objects — callers don't need the result column.

Trailing slash on dirpath must not produce 'work/projects//*'.

Without dirpath, the query is the plain 'tag in tags' JsonLogic predicate.

With dirpath, the query becomes an 'and' of the tag predicate and a glob on path.