apple-notes-mcp 2.9.7 → 2.9.9

package/README.md

@@ -1873,6 +1873,14 @@ fetched attachment bytes with the source before reporting success.
 that exact name. A mismatch is a warning (`filenameWarning`), not a failure,
 because the attachment and its bytes are already verified.
 
+On macOS 27, Notes' AppleScript does not list PDF attachments, so it cannot see
+a PDF this tool just added. When that happens and the server has Full Disk
+Access, it verifies through the read-only NoteStore database instead: success
+requires exactly one new attachment row on the note whose media file matches
+the source bytes, and the result carries `verifiedBy: "database"`. Without Full
+Disk Access a PDF attach reports "insertion outcome uncertain"; read the note
+before retrying, because the attachment was probably created.
+
 ---
 
 #### `create-note-with-attachment`
@@ -1979,6 +1987,35 @@ Saves Notes' rendered image of one Paper drawing or classic drawing to a new fil
 
 ---
 
+#### `analyze-svg`
+
+Analyzes one local SVG file and reports whether it can be represented as editable monoline strokes (a list of strokes, each a solid color, a width, and a polyline) and what that conversion would approximate or drop. It is a standalone preflight: it reads only the file, opens no Notes data, and makes no network request.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `path` | string | Yes | Absolute path of one `.svg` file: a regular file, not a symbolic link, at most 1 MiB of UTF-8, in home, temp, or `/Volumes` |
+| `includeDrawing` | boolean | No | Also return the normalized drawing. Off by default because it can be large |
+
+**Returns:** `classification`, `importable`, `defaultWriteAllowed`, `requiredLosses`, `issues` (each with a `code`, the `loss` it causes or `null`, an element `location` such as `svg/g[2]/path[1]#id`, and a message), `viewport`, `counts` (elements, references, path segments, output strokes and points, and the `geometryWork`, `dashWork`, and `scanWork` budgets as `{used, max}`), `source` (`sha256`, `bytes`), `drawingBytes`, and `analysisDigest`.
+
+| Classification | Meaning |
+|---|---|
+| `safe` | The output needs no reported approximation or omission. `defaultWriteAllowed` is true |
+| `lossy` | The output needs `geometry-approximation` or `paint-approximation` |
+| `unsupported` | Visible content would be dropped (`drop-content`), or nothing drawable remains (`importable: false`) |
+
+The loss modes:
+
+- `geometry-approximation`: non-round caps or joins are drawn round, a non-uniformly scaled stroke gets one width, or centerlines are clipped at a viewport. Curves are flattened to within 0.25 px, which is not reported as a loss.
+- `paint-approximation`: solid fills become overlapping strokes, group opacity is applied to each stroke, and blend modes or a non-default paint order are ignored.
+- `drop-content`: text, images, gradient and pattern paint, filters, masks, clip paths, markers, `<switch>`, and unknown elements are omitted.
+
+Supported input: `path`, `rect`, `circle`, `ellipse`, `line`, `polyline`, `polygon`; `g`, `a`, nested `svg`; local `defs`, `symbol`, and `use`; transforms; `viewBox` and `preserveAspectRatio`; solid named, hex, `rgb()`/`rgba()`, and `hsl()` colors, `currentColor`, opacity, fill rules, and dashes, from attributes or the `style` attribute. `analysisDigest` is a SHA-256 over the canonical analysis and normalized drawing, so equal digests mean the same result.
+
+**⚠️ Safety:** Read-only. Active or unsafe input is refused as an error with `code: "validation_error"` and an `svgCode`: `svg_unsafe` for scripts, event-handler attributes, `<style>` elements, animation, embedded objects, DOCTYPE or entity declarations, processing instructions, and any external reference (only local `#id` references and embedded raster images are allowed); `svg_invalid` for malformed XML; `svg_reference_invalid` for cyclic or duplicate-id references; `svg_complexity_limit` or `svg_geometry_invalid` when a limit is exceeded (16,384 elements, 100,000 path segments, 4,096 output strokes, 100,000 points, 5,000,000 fill scan checks); `svg_file_invalid` for a path or file that cannot be read.
+
+---
+
 #### `export-attachments`
 
 Copies a note's attachment files into a directory without opening Notes.app.