apple-notes-mcp 2.9.28 → 2.9.30

package/README.md

@@ -2409,7 +2409,7 @@ listed under the tool itself:
 |-----------|------|----------|-------------|
 | `id` | string | Yes | Exact note ID: x-coredata id, Notes UUID, or numeric key (see [Identifier forms](#identifier-forms)) |
 | `expectedContentHash` | string | Yes | `contentHash` (`sha256:…`) from a fresh read of the note |
-| `scopeText` | string | Yes | Distinctive phrase already in the note, 12–500 characters, that Notes search can find. Prefer plain words without punctuation, hashtags, or paths |
+| `scopeText` | string | Yes | Distinctive phrase already in the note below its title line, 12–500 characters, that Notes search can find. Prefer plain words without punctuation, hashtags, or paths |
 
 When the Shortcut refuses a request (its Find Notes step did not return
 exactly one note with that exact title and `scopeText`) or stops with its own

package/build/index.js

@@ -48723,6 +48723,12 @@ function describeTransportFailure(error2) {
   if (detail?.refused) return `${named} ${detail.message}`;
   return detail?.code === "ETIMEDOUT" ? `Shortcuts timed out waiting for ${named}. ${shortcutConsentHint(detail.shortcut)}` : `${named} failed: ${String(detail?.stderr || detail?.message || "no output").trim().slice(0, 400)}`;
 }
+function textBelowTitle(text2, title) {
+  const lineEnd = text2.indexOf("\n");
+  const firstLine = lineEnd < 0 ? text2 : text2.slice(0, lineEnd);
+  if (firstLine.trim() !== title.trim()) return text2;
+  return lineEnd < 0 ? "" : text2.slice(lineEnd + 1);
+}
 function mutateBackground(request, operation, data, verify, deps) {
   if (request.scopeText.length < 12 || request.scopeText.length > 500 || /[\r\n\0]/u.test(request.scopeText))
     throw new Error("Use a distinctive existing single-line scope of 12\u2013500 characters");
@@ -48731,6 +48737,11 @@ function mutateBackground(request, operation, data, verify, deps) {
     throw new Error("Note revision changed; read it again");
   if (!before.rich.text.includes(request.scopeText))
     throw new Error("Scope is absent from exact note");
+  if (!textBelowTitle(before.rich.text, before.title).includes(request.scopeText))
+    throw new CodedError(
+      "scopeText appears only in the note's title line. The bridge's Find Notes step matches it against the body below the title, so it would refuse; pass a phrase from below the title. Nothing changed",
+      { code: "validation_error", committed: false, indeterminate: false }
+    );
   const candidates = deps.candidates(before.title, request.scopeText);
   if (candidates.length !== 1 || candidates[0] !== request.id)
     throw new Error("Ambiguous note selection; nothing changed");
@@ -57108,7 +57119,7 @@ var common = {
   id,
   expectedContentHash: revision3,
   scopeText: external_exports.string().min(12).max(500).describe(
-    "Distinctive existing phrase used by Notes search. Prefer plain words without punctuation, hashtags, or paths."
+    "Distinctive existing phrase from below the title line, used by Notes search. Prefer plain words without punctuation, hashtags, or paths."
   )
 };
 var EMPTY_TABLE_ROWS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-notes-mcp",
-  "version": "2.9.28",
+  "version": "2.9.30",
   "description": "MCP server for Apple Notes - read, search, create, edit, organize, and export notes on macOS via Claude and other AI assistants",
   "type": "module",
   "main": "build/index.js",