apple-notes-mcp 2.5.1 → 2.5.2

package/build/services/appleNotesManager.js

@@ -2436,19 +2436,21 @@ export class AppleNotesManager {
      * Simple HTML to plaintext conversion for export.
      */
     htmlToPlaintext(html) {
-        return html
+        return (html
             .replace(/<br\s*\/?>/gi, "\n")
             .replace(/<\/div>/gi, "\n")
             .replace(/<\/p>/gi, "\n")
             .replace(/<[^>]+>/g, "")
             .replace(/&nbsp;/g, " ")
-            .replace(/&amp;/g, "&")
             .replace(/&lt;/g, "<")
             .replace(/&gt;/g, ">")
             .replace(/&quot;/g, '"')
             .replace(/&#92;/g, "\\")
+            // Decode &amp; LAST so an encoded entity like "&amp;lt;" round-trips to the
+            // literal "&lt;" instead of being double-unescaped to "<".
+            .replace(/&amp;/g, "&")
             .replace(/\n{3,}/g, "\n\n")
-            .trim();
+            .trim());
     }
     /**
      * Exports all notes as a JSON structure for backup/migration.

package/build/services/appleNotesManager.test.js

@@ -2373,3 +2373,33 @@ describe("AppleNotesManager", () => {
         });
     });
 });
+describe("htmlToPlaintext (export helper)", () => {
+    // htmlToPlaintext is a private, pure string transform used by exportNote; it
+    // touches no AppleScript, so we exercise it directly through a cast.
+    const toPlaintext = (html) => new AppleNotesManager().htmlToPlaintext(html);
+    it("decodes the basic HTML entities", () => {
+        expect(toPlaintext("a & b")).toBe("a & b");
+        expect(toPlaintext("&lt;tag&gt;")).toBe("<tag>");
+        expect(toPlaintext("say &quot;hi&quot;")).toBe('say "hi"');
+        expect(toPlaintext("path&#92;file")).toBe("path\\file");
+        expect(toPlaintext("a&nbsp;b")).toBe("a b");
+    });
+    it("decodes &amp; last so encoded entities round-trip (no double-unescape)", () => {
+        // The literal text "&lt;" is stored in HTML as "&amp;lt;" and must decode
+        // back to "&lt;", NOT be double-unescaped to "<".
+        expect(toPlaintext("&amp;lt;")).toBe("&lt;");
+        expect(toPlaintext("&amp;gt;")).toBe("&gt;");
+        expect(toPlaintext("&amp;amp;")).toBe("&amp;");
+        expect(toPlaintext("&amp;nbsp;")).toBe("&nbsp;");
+    });
+    it("converts block/line tags to newlines and strips other tags", () => {
+        expect(toPlaintext("one<br>two")).toBe("one\ntwo");
+        expect(toPlaintext("<div>a</div><div>b</div>")).toBe("a\nb");
+        expect(toPlaintext("<p>x</p><p>y</p>")).toBe("x\ny");
+        expect(toPlaintext("<b>bold</b>")).toBe("bold");
+    });
+    it("collapses 3+ newlines and trims surrounding whitespace", () => {
+        expect(toPlaintext("a<br><br><br><br>b")).toBe("a\n\nb");
+        expect(toPlaintext("  <div>x</div>  ")).toBe("x");
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-notes-mcp",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "description": "MCP server for Apple Notes - create, search, update, and manage notes via Claude and other AI assistants",
   "type": "module",
   "main": "build/index.js",