seekstone 0.13.0 → 0.14.0

package/README.md

@@ -135,7 +135,7 @@ Other MCP clients (Windsurf, Cline, …) take the Option 3 JSON block in their o
 | `replace_in_note` | Find and replace text in the note body — literal or regex, whole-word, case sensitivity, optional `limit` (replaces **all** occurrences by default), dry-run preview. |
 | `append_periodic_note` | Append to today's periodic note, creating it from a template if it doesn't yet exist. |
 
-The content-editing tools (`append_note`, `patch_note`, `patch_frontmatter`, `replace_in_note`, `append_periodic_note`, and `create_note` with `overwrite: true`) support optional **compare-and-swap**: pass the `contentHash` you got from `read_note` as `prevHash` and the write fails cleanly if the note changed underneath you, instead of silently discarding the concurrent edit.
+Every write tool (`append_note`, `patch_note`, `patch_frontmatter`, `replace_in_note`, `rename_heading`, `move_note`, `delete_note`, `append_periodic_note`, and `create_note` with `overwrite: true`) supports optional **compare-and-swap**: pass the `contentHash` you got from `read_note` as `prevHash` and the call fails cleanly if the note changed underneath you — no silently discarded concurrent edit, no moving or deleting content you haven't seen. Every mutating result returns the new `contentHash`, so chained edits need no re-reads.
 
 ---
 

package/dist/index.js

@@ -701,7 +701,7 @@ ${stringifyYaml(input.frontmatter, { lineWidth: 0 })}---
 }
 
 // src/tools/delete_note.ts
-import { access as access2, mkdir as mkdir2, rename as rename2, rm } from "fs/promises";
+import { access as access2, mkdir as mkdir2, readFile as readFile3, rename as rename2, rm } from "fs/promises";
 import { basename as basename2, extname as extname2, join } from "path";
 import { z as z5 } from "zod";
 
@@ -742,6 +742,9 @@ var DeleteNoteInput = z5.object({
   path: z5.string().describe("Vault-relative path of the note to delete."),
   permanent: z5.boolean().default(false).describe(
     "Permanently remove the note instead of moving it to the vault .trash/ folder. Defaults to false \u2014 deletes are recoverable."
+  ),
+  prevHash: z5.string().optional().describe(
+    "Optional compare-and-swap guard: the contentHash from a prior read. Fails with hash_conflict if the note changed since \u2014 so you never delete content you have not seen."
   )
 });
 async function freeTrashPath(vaultRoot2, noteBase) {
@@ -761,11 +764,12 @@ async function deleteNote(ctx2, rawInput) {
   const input = DeleteNoteInput.parse(rawInput);
   const absPath = resolveVaultPath(ctx2.vaultRoot, input.path);
   assertWritable(ctx2.policy, input.path);
+  const raw = await readFile3(absPath, "utf8");
+  if (input.prevHash !== void 0) assertHashMatch(raw, input.prevHash, input.path);
   let trashedTo;
   if (input.permanent) {
     await rm(absPath);
   } else {
-    await access2(absPath);
     await mkdir2(join(ctx2.vaultRoot, ".trash"), { recursive: true });
     trashedTo = await freeTrashPath(ctx2.vaultRoot, basename2(input.path));
     await rename2(absPath, join(ctx2.vaultRoot, trashedTo));
@@ -775,7 +779,11 @@ async function deleteNote(ctx2, rawInput) {
     ctx2.index.discard(input.path);
     ctx2.notes.delete(input.path);
   }
-  const result = { path: input.path, permanent: input.permanent };
+  const result = {
+    path: input.path,
+    permanent: input.permanent,
+    contentHash: contentHash(raw)
+  };
   if (trashedTo !== void 0) result.trashedTo = trashedTo;
   return result;
 }
@@ -903,7 +911,7 @@ function listTags(ctx2, input) {
 }
 
 // src/tools/move_note.ts
-import { access as access3, mkdir as mkdir3, rename as rename3 } from "fs/promises";
+import { access as access3, mkdir as mkdir3, readFile as readFile4, rename as rename3 } from "fs/promises";
 import { dirname as dirname2, join as join2 } from "path";
 import { z as z10 } from "zod";
 
@@ -1006,6 +1014,9 @@ var MoveNoteInput = z10.object({
   overwrite: z10.boolean().default(false).describe("Overwrite the destination if it exists. Defaults to false."),
   rewriteLinks: z10.boolean().default(true).describe(
     "Rewrite wikilinks and markdown links in other notes that point at the moved note, so nothing breaks. Defaults to true; pass false to move the file only."
+  ),
+  prevHash: z10.string().optional().describe(
+    "Optional compare-and-swap guard on the source note: the contentHash from a prior read. Fails with hash_conflict if the note changed since."
   )
 });
 async function moveNote(ctx2, rawInput) {
@@ -1014,11 +1025,13 @@ async function moveNote(ctx2, rawInput) {
   const absTo = resolveVaultPath(ctx2.vaultRoot, input.to);
   assertWritable(ctx2.policy, input.from);
   assertWritable(ctx2.policy, input.to);
+  let raw;
   try {
-    await access3(absFrom);
+    raw = await readFile4(absFrom, "utf8");
   } catch {
     throw new Error(`Note not found: ${input.from}`);
   }
+  if (input.prevHash !== void 0) assertHashMatch(raw, input.prevHash, input.from);
   if (!input.overwrite) {
     try {
       await access3(absTo);
@@ -1041,7 +1054,6 @@ async function moveNote(ctx2, rawInput) {
   }
   await mkdir3(dirname2(absTo), { recursive: true });
   await rename3(absFrom, absTo);
-  const raw = ctx2.notes.get(input.from)?.raw ?? "";
   removeNoteBacklinks(ctx2, input.from);
   if (ctx2.notes.has(input.from)) {
     ctx2.index.discard(input.from);
@@ -1079,13 +1091,19 @@ async function moveNote(ctx2, rawInput) {
     }
   }
   ctx2.backlinks.delete(input.from);
-  const result = { from: input.from, to: input.to, notesRewritten, linksRewritten };
+  const result = {
+    from: input.from,
+    to: input.to,
+    notesRewritten,
+    linksRewritten,
+    contentHash: contentHash(raw)
+  };
   if (skipped.length > 0) result.skipped = skipped;
   return result;
 }
 
 // src/tools/outline_note.ts
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile5 } from "fs/promises";
 
 // ../core/src/outline.ts
 var HEADING_RE = /^(#{1,6})\s+(.+)/;
@@ -1143,7 +1161,7 @@ var OutlineNoteInput = z11.object({
 });
 async function outlineNote(ctx2, input) {
   const absPath = resolveVaultPath(ctx2.vaultRoot, input.path);
-  const raw = await readFile3(absPath, "utf8");
+  const raw = await readFile5(absPath, "utf8");
   return buildOutline(raw, {
     includeBlocks: input.includeBlocks,
     includeSizes: input.includeSizes
@@ -1151,7 +1169,7 @@ async function outlineNote(ctx2, input) {
 }
 
 // src/tools/patch_frontmatter.ts
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile6 } from "fs/promises";
 import { parseDocument as parseDocument2 } from "yaml";
 import { z as z12 } from "zod";
 var PatchFrontmatterInput = z12.object({
@@ -1166,7 +1184,7 @@ var PatchFrontmatterInput = z12.object({
 async function patchFrontmatter(ctx2, input) {
   const absPath = resolveVaultPath(ctx2.vaultRoot, input.path);
   assertWritable(ctx2.policy, input.path);
-  const original = await readFile4(absPath, "utf8");
+  const original = await readFile6(absPath, "utf8");
   if (input.prevHash !== void 0) assertHashMatch(original, input.prevHash, input.path);
   const fm = parseFrontmatter(original);
   const keysChanged = [];
@@ -1226,7 +1244,7 @@ ${original}`;
 }
 
 // src/tools/patch_note.ts
-import { readFile as readFile5 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 import { z as z13 } from "zod";
 var PatchNoteInput = z13.object({
   path: z13.string().describe("Vault-relative path to the note."),
@@ -1257,7 +1275,7 @@ function lineStart(raw, offset) {
 async function patchNote(ctx2, input) {
   const absPath = resolveVaultPath(ctx2.vaultRoot, input.path);
   assertWritable(ctx2.policy, input.path);
-  const raw = await readFile5(absPath, "utf8");
+  const raw = await readFile7(absPath, "utf8");
   if (input.prevHash !== void 0) assertHashMatch(raw, input.prevHash, input.path);
   const fm = parseFrontmatter(raw);
   const originalFmRegion = raw.slice(0, fm.bodyStart);
@@ -1357,7 +1375,7 @@ ${input.content}${contentNl}`;
   };
 }
 async function verifyFrontmatter(absPath, originalFmRegion) {
-  const written = await readFile5(absPath, "utf8");
+  const written = await readFile7(absPath, "utf8");
   if (written.slice(0, originalFmRegion.length) !== originalFmRegion) {
     throw new Error("Write-safety violation: frontmatter region changed unexpectedly");
   }
@@ -1372,7 +1390,7 @@ function updateCache(ctx2, path2, newContent, bodyStart) {
 }
 
 // src/tools/periodic_note.ts
-import { access as access4, mkdir as mkdir4, readFile as readFile6 } from "fs/promises";
+import { access as access4, mkdir as mkdir4, readFile as readFile8 } from "fs/promises";
 import { dirname as dirname3, join as join3 } from "path";
 import { z as z14 } from "zod";
 var PERIOD = z14.enum(["daily", "weekly", "monthly", "quarterly", "yearly"]);
@@ -1385,7 +1403,7 @@ var DEFAULTS = {
 };
 async function readJson(absPath) {
   try {
-    return JSON.parse(await readFile6(absPath, "utf8"));
+    return JSON.parse(await readFile8(absPath, "utf8"));
   } catch {
     return null;
   }
@@ -1471,7 +1489,7 @@ async function getPeriodicNote(ctx2, rawInput) {
         ctx2.vaultRoot,
         cfg.template.endsWith(".md") ? cfg.template : `${cfg.template}.md`
       );
-      body = await readFile6(templateAbs, "utf8");
+      body = await readFile8(templateAbs, "utf8");
     } catch {
     }
   }
@@ -1498,7 +1516,7 @@ async function appendPeriodicNote(ctx2, rawInput) {
   assertWritable(ctx2.policy, path2);
   let original = "";
   try {
-    original = await readFile6(abs, "utf8");
+    original = await readFile8(abs, "utf8");
     if (input.prevHash !== void 0) assertHashMatch(original, input.prevHash, path2);
   } catch (err) {
     if (err.code !== "ENOENT") throw err;
@@ -1671,7 +1689,7 @@ function queryNotes(ctx2, input) {
 }
 
 // src/tools/read_note.ts
-import { readFile as readFile7 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 import { z as z16 } from "zod";
 var ReadNoteInput = z16.object({
   path: z16.string().describe('Vault-relative path to the note, e.g. "Daily Notes/2026-05-29.md".'),
@@ -1689,7 +1707,7 @@ var ReadNoteInput = z16.object({
 });
 async function readNote(ctx2, input) {
   const absPath = resolveVaultPath(ctx2.vaultRoot, input.path);
-  const raw = await readFile7(absPath, "utf8");
+  const raw = await readFile9(absPath, "utf8");
   const noteBytes = Buffer.byteLength(raw, "utf8");
   const hash = contentHash(raw);
   if (input.section === void 0 && input.block === void 0 && input.lines === void 0) {
@@ -1777,7 +1795,7 @@ async function readNote(ctx2, input) {
 }
 
 // src/tools/rename_heading.ts
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile10 } from "fs/promises";
 import { join as join4 } from "path";
 import { z as z17 } from "zod";
 var RenameHeadingInput = z17.object({
@@ -1818,7 +1836,7 @@ async function renameHeading(ctx2, rawInput) {
   assertWritable(ctx2.policy, input.path);
   let raw;
   try {
-    raw = await readFile8(absPath, "utf8");
+    raw = await readFile10(absPath, "utf8");
   } catch {
     throw new Error(`Note not found: ${input.path}`);
   }
@@ -1854,7 +1872,7 @@ async function renameHeading(ctx2, rawInput) {
   newRaw = newRaw.slice(0, fm.bodyStart) + selfRewrite.content;
   const originalFmRegion = raw.slice(0, fm.bodyStart);
   await atomicWrite(absPath, newRaw);
-  const written = await readFile8(absPath, "utf8");
+  const written = await readFile10(absPath, "utf8");
   if (written.slice(0, originalFmRegion.length) !== originalFmRegion) {
     throw new Error("Write-safety violation: frontmatter region changed unexpectedly");
   }
@@ -1900,7 +1918,7 @@ async function renameHeading(ctx2, rawInput) {
 }
 
 // src/tools/replace_in_note.ts
-import { readFile as readFile9 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 import { z as z18 } from "zod";
 var ReplaceInNoteInput = z18.object({
   path: z18.string().describe("Vault-relative path to the note."),
@@ -1937,7 +1955,7 @@ async function replaceInNote(ctx2, input) {
   } catch (err) {
     throw new Error(`Invalid regex: ${err instanceof Error ? err.message : String(err)}`);
   }
-  const raw = await readFile9(absPath, "utf8");
+  const raw = await readFile11(absPath, "utf8");
   if (input.prevHash !== void 0) assertHashMatch(raw, input.prevHash, input.path);
   const fm = parseFrontmatter(raw);
   const originalFmRegion = raw.slice(0, fm.bodyStart);
@@ -1954,7 +1972,10 @@ async function replaceInNote(ctx2, input) {
       path: input.path,
       replacements: toReplace.length,
       matches: matches2,
-      frontmatterUnchanged: true
+      frontmatterUnchanged: true,
+      // Nothing was written — hash the content as read, so chained edits can
+      // proceed from a dry run without a re-read.
+      contentHash: contentHash(raw)
     };
   }
   const singleRe = new RegExp(re.source, re.flags.replace("g", ""));
@@ -1969,7 +1990,7 @@ async function replaceInNote(ctx2, input) {
   newBody += body.slice(lastIndex);
   const newContent = `${originalFmRegion}${newBody}`;
   await atomicWrite(absPath, newContent);
-  const written = await readFile9(absPath, "utf8");
+  const written = await readFile11(absPath, "utf8");
   if (written.slice(0, originalFmRegion.length) !== originalFmRegion) {
     throw new Error("Write-safety violation: frontmatter region changed unexpectedly");
   }
@@ -2212,7 +2233,7 @@ async function run(ctx2, name, args) {
 }
 
 // src/index/build.ts
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile12 } from "fs/promises";
 import { basename as basename3, extname as extname4 } from "path";
 
 // ../core/src/walk.ts
@@ -2294,7 +2315,7 @@ async function buildIndex(vaultRoot2) {
   await Promise.all(
     noteEntries.map(async (entry) => {
       try {
-        const raw = await readFile10(entry.absPath, "utf8");
+        const raw = await readFile12(entry.absPath, "utf8");
         const fm = parseFrontmatter(raw);
         const inlineTags = extractInlineTags(fm.body);
         const fmTags = frontmatterTags(fm.data);
@@ -2347,7 +2368,7 @@ function buildBacklinks(notes2) {
 
 // src/init.ts
 import { execFileSync } from "child_process";
-import { access as access5, copyFile, mkdir as mkdir5, readdir, readFile as readFile11, stat as stat2, writeFile as writeFile2 } from "fs/promises";
+import { access as access5, copyFile, mkdir as mkdir5, readdir, readFile as readFile13, stat as stat2, writeFile as writeFile2 } from "fs/promises";
 import path, { dirname as dirname4, join as join6 } from "path";
 function parseInitArgs(argv) {
   const opts = { write: false, client: "desktop" };
@@ -2491,7 +2512,7 @@ async function runInit(opts, deps) {
       ]
     };
   }
-  const rf = deps.readFile ?? readFile11;
+  const rf = deps.readFile ?? readFile13;
   let vaultPath = opts.vault ?? deps.env.SEEKSTONE_VAULT;
   if (!vaultPath) {
     const registryPath = obsidianRegistryPath(deps.platform, {
@@ -2752,9 +2773,32 @@ function installProcessGuards(log2) {
 }
 
 // src/tool-list.ts
+var READ_ONLY_ANNOTATIONS = {
+  readOnlyHint: true,
+  openWorldHint: false
+};
+var ADDITIVE_WRITE_ANNOTATIONS = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: false,
+  openWorldHint: false
+};
+var DESTRUCTIVE_WRITE_ANNOTATIONS = {
+  readOnlyHint: false,
+  destructiveHint: true,
+  idempotentHint: false,
+  openWorldHint: false
+};
+var IDEMPOTENT_DESTRUCTIVE_WRITE_ANNOTATIONS = {
+  readOnlyHint: false,
+  destructiveHint: true,
+  idempotentHint: true,
+  openWorldHint: false
+};
 var ALL_TOOLS = [
   {
     name: "search",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "Full-text search across the vault. Returns ranked excerpts (~200 chars) \u2014 not full notes \u2014 to minimise context usage. Supports fuzzy matching and prefix search.",
     inputSchema: {
       type: "object",
@@ -2769,6 +2813,7 @@ var ALL_TOOLS = [
   },
   {
     name: "query_notes",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "Structured metadata query \u2014 filter notes by frontmatter key/value predicates, tag, folder, modified time, and size. Returns compact rows (path + title by default; opt into more via select), not note content. Use this instead of search when filtering by properties rather than text.",
     inputSchema: {
       type: "object",
@@ -2826,6 +2871,7 @@ var ALL_TOOLS = [
   },
   {
     name: "context_pack",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: 'Assemble everything needed to ANSWER a natural-language question in one call, under a strict byte budget (default 2048): ranked excerpts, linked neighbor notes (backlinks/outlinks) with one-line summaries, and follow-up source paths. Use search to locate notes and query_notes for metadata filters; use context_pack when you want answer-ready context without multiple round-trips. Empty excerpts with confidence "none" or "low" means the vault lacks coverage \u2014 do not infer content.',
     inputSchema: {
       type: "object",
@@ -2841,6 +2887,7 @@ var ALL_TOOLS = [
   },
   {
     name: "read_note",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "Read a note or a span of it \u2014 by heading section, block reference, or line range. Returns structured JSON with the content, bytes returned, total note size, and a contentHash to pass as prevHash to edit tools for compare-and-swap. Use search or outline_note first to find the right path and section names.",
     inputSchema: {
       type: "object",
@@ -2879,6 +2926,7 @@ var ALL_TOOLS = [
   },
   {
     name: "list_notes",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "List notes, optionally filtered by folder prefix or tag.",
     inputSchema: {
       type: "object",
@@ -2892,6 +2940,7 @@ var ALL_TOOLS = [
   },
   {
     name: "list_tags",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "List all tags in the vault with usage counts. Supports substring filtering, minimum count threshold, and sort order. Nested tags (e.g. area/work) include a parent field.",
     inputSchema: {
       type: "object",
@@ -2915,6 +2964,7 @@ var ALL_TOOLS = [
   },
   {
     name: "create_note",
+    annotations: DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Create a new note at a vault-relative path. Optionally sets frontmatter and body content. Parent directories are created automatically. Fails if the note already exists unless overwrite is true (prevHash may guard the overwrite).",
     inputSchema: {
       type: "object",
@@ -2943,6 +2993,7 @@ var ALL_TOOLS = [
   },
   {
     name: "delete_note",
+    annotations: DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Delete a note. By default it is moved to the vault .trash/ folder (recoverable by moving it back); pass permanent: true to remove it outright.",
     inputSchema: {
       type: "object",
@@ -2951,6 +3002,10 @@ var ALL_TOOLS = [
         permanent: {
           type: "boolean",
           description: "Permanently remove instead of moving to .trash/. Defaults to false."
+        },
+        prevHash: {
+          type: "string",
+          description: "Optional compare-and-swap guard: the contentHash from a prior read. Fails with hash_conflict if the note changed since \u2014 so you never delete content you have not seen."
         }
       },
       required: ["path"]
@@ -2958,6 +3013,7 @@ var ALL_TOOLS = [
   },
   {
     name: "move_note",
+    annotations: DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Move or rename a note to a new vault-relative path, rewriting wikilinks and markdown links in other notes that point at it so nothing breaks (links inside fenced code blocks are left alone). Parent directories at the destination are created automatically. Fails if the destination already exists unless overwrite is true.",
     inputSchema: {
       type: "object",
@@ -2971,6 +3027,10 @@ var ALL_TOOLS = [
         rewriteLinks: {
           type: "boolean",
           description: "Rewrite references in other notes to follow the move. Defaults to true; pass false to move the file only."
+        },
+        prevHash: {
+          type: "string",
+          description: "Optional compare-and-swap guard on the source note: the contentHash from a prior read. Fails with hash_conflict if the note changed since."
         }
       },
       required: ["from", "to"]
@@ -2978,6 +3038,7 @@ var ALL_TOOLS = [
   },
   {
     name: "rename_heading",
+    annotations: DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Rename a heading in a note and rewrite every [[note#heading]] wikilink and embed across the vault so references keep working \u2014 aliases preserved, fenced code blocks left alone. Served from the warm backlink index, no vault scan. Heading matching is case-insensitive; with duplicate headings the first match wins, mirroring Obsidian link resolution.",
     inputSchema: {
       type: "object",
@@ -3004,6 +3065,7 @@ var ALL_TOOLS = [
   },
   {
     name: "append_note",
+    annotations: ADDITIVE_WRITE_ANNOTATIONS,
     description: "Append text to a note body without touching the frontmatter. Safe for meeting notes, daily logs, and append-only workflows.",
     inputSchema: {
       type: "object",
@@ -3020,6 +3082,7 @@ var ALL_TOOLS = [
   },
   {
     name: "patch_frontmatter",
+    annotations: IDEMPOTENT_DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Set, update, or delete frontmatter keys without reordering existing keys or changing quote style. Pass null as a value to delete a key.",
     inputSchema: {
       type: "object",
@@ -3040,6 +3103,7 @@ var ALL_TOOLS = [
   },
   {
     name: "outline_note",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "Return a note's structure \u2014 heading tree with offsets, block-reference anchors, and frontmatter key list \u2014 without returning any prose. Use this before section reads or patches to discover what sections exist at a fraction of the cost of reading the full note.",
     inputSchema: {
       type: "object",
@@ -3059,6 +3123,7 @@ var ALL_TOOLS = [
   },
   {
     name: "patch_note",
+    annotations: DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Surgically edit a section of a note \u2014 targeted by heading or block reference \u2014 without rewriting the whole file. Operations: append (add after section), prepend (add after heading line), replace (swap section content). Frontmatter is never touched.",
     inputSchema: {
       type: "object",
@@ -3088,6 +3153,7 @@ var ALL_TOOLS = [
   },
   {
     name: "get_backlinks",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "Return every note that links to the target note, with the source line and an optional excerpt. Results come from the pre-built reverse-link index so this is a fast, pure index lookup. Sort order: source path ascending.",
     inputSchema: {
       type: "object",
@@ -3107,6 +3173,7 @@ var ALL_TOOLS = [
   },
   {
     name: "get_links",
+    annotations: READ_ONLY_ANNOTATIONS,
     description: "Return all outgoing wikilinks and embeds from a note. Each link is marked resolved (with target path) or unresolved. Duplicate targets are de-duplicated; results sorted by line number.",
     inputSchema: {
       type: "object",
@@ -3118,6 +3185,7 @@ var ALL_TOOLS = [
   },
   {
     name: "replace_in_note",
+    annotations: DESTRUCTIVE_WRITE_ANNOTATIONS,
     description: "Find and replace text within a note body. Supports literal and regex search, case sensitivity, whole-word matching, and a replacement limit. Frontmatter is never touched. Use dryRun to preview matches before writing.",
     inputSchema: {
       type: "object",
@@ -3158,6 +3226,7 @@ var ALL_TOOLS = [
   },
   {
     name: "get_periodic_note",
+    annotations: ADDITIVE_WRITE_ANNOTATIONS,
     description: "Get the path and existence status of a periodic note (daily, weekly, monthly, quarterly, or yearly) for a given date. Reads folder/format config from .obsidian/daily-notes.json (daily) or the periodic-notes plugin data.json. Optionally creates the note from the configured template if it is missing.",
     inputSchema: {
       type: "object",
@@ -3181,6 +3250,7 @@ var ALL_TOOLS = [
   },
   {
     name: "append_periodic_note",
+    annotations: ADDITIVE_WRITE_ANNOTATIONS,
     description: "Append text to a periodic note (daily, weekly, monthly, quarterly, or yearly). Preserves existing frontmatter exactly. Creates the note first (from template if configured) when createIfMissing is true (default).",
     inputSchema: {
       type: "object",
@@ -3218,7 +3288,7 @@ function visibleTools(policy2) {
 
 // src/watcher.ts
 import { realpathSync } from "fs";
-import { readFile as readFile12 } from "fs/promises";
+import { readFile as readFile14 } from "fs/promises";
 import { join as join7, relative as relative2, sep as sep3 } from "path";
 import chokidar from "chokidar";
 function startWatcher(ctx2, log2, opts) {
@@ -3231,7 +3301,7 @@ function startWatcher(ctx2, log2, opts) {
   const toRel = (abs) => relative2(vaultRoot2, abs).split(sep3).join("/");
   async function upsert(relPath, op) {
     try {
-      const raw = await readFile12(join7(vaultRoot2, relPath), "utf8");
+      const raw = await readFile14(join7(vaultRoot2, relPath), "utf8");
       removeNoteBacklinks(ctx2, relPath);
       upsertDoc(ctx2, buildDoc(relPath, raw));
       addNoteBacklinks(ctx2, relPath, raw);
@@ -3283,7 +3353,7 @@ function startWatcher(ctx2, log2, opts) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.13.0" : "0.0.0-dev";
+var VERSION = true ? "0.14.0" : "0.0.0-dev";
 var intent = parseCliIntent(process.argv.slice(2));
 if (intent === "version") {
   process.stdout.write(`${VERSION}