drafted 1.17.14 → 1.17.16

package/mcp/server.mjs

@@ -2328,7 +2328,7 @@ tool('comment', {
   action: z.enum(['list', 'add', 'resolve', 'reopen', 'delete']).describe('list: read comments (paginated). add: post a comment or a reply. resolve/reopen: flip a comment\'s state. delete: remove one.'),
   target: z.string().optional().describe('[list, add] The frame: a path (/projects/<project>/<layer>/<lane>/<file>), a frame URL, or a frame UUID. Required for add. For list, omit it to read the whole project.'),
   projectId: z.string().optional().describe('[list] Project to read when no target is given — UUID, slug, or /projects/<name>. Defaults to the session\'s bound project.'),
-  body: z.string().optional().describe('[add] The comment text. Be specific and actionable: quote what you mean and say what should change. Prefix with [MUST] / [NICE] / [Q] so a reviewer can triage.'),
+  body: z.string().optional().describe('[add] The comment text. Be specific and actionable: quote what you mean and say what should change. Prefix with [MUST] / [NICE] / [Q] so a reviewer can triage. To notify a person, put their EMAIL ADDRESS after an @ — "@sam@acme.com". A bare "@sam" only works when exactly one person on the frame has that local-part; when two do, it is ignored rather than guessed at.'),
   replyTo: z.string().optional().describe('[add] Comment UUID this replies to. A reply cannot carry its own anchor — it inherits the thread\'s.'),
   anchorRef: z.string().optional().describe('[add] CSS selector for the element this comment is about, e.g. "h1" or ".email-body > p:nth-of-type(3)". The frame must load /vendor/frame-guide.js (markdown and HTML content frames get it automatically). Without it the comment lands on the whole frame.'),
   anchorText: z.string().optional().describe('[add] The text of the anchored element, stored as a snapshot. Supply it whenever you pass anchorRef: a selector is an nth-of-type path that breaks when the frame is re-authored, and this snapshot is the only way to re-find what you meant.'),
@@ -2812,7 +2812,12 @@ tool('fs', 'Navigate Drafted like a local filesystem. An org is the top folder:
         // OKF boundary rule: /a/b.md ≡ a/b — strip a trailing .md so both spellings work.
         const canonPath = wikiPath.replace(/\.md$/, '');
         const existing = await api('GET', `/api/wiki/page?path=${encodeURIComponent(canonPath)}`, undefined, orgHeader).catch(() => null);
-        const body = { path: canonPath, title: canonPath.split('/').pop(), content, type: existing?.type || 'Page' };
+        // Send ONLY { path, content }. An explicit `type`/`title` outranks the
+        // content preamble server-side (PATCH semantics), so defaulting them
+        // here silently forced every MCP-created page to type "Page" and a
+        // path-segment title, discarding the author's frontmatter. The server
+        // lifts both from the preamble and falls back to the path segment.
+        const body = { path: canonPath, content };
         const result = existing
           ? await api('PUT', `/api/wiki/page?path=${encodeURIComponent(canonPath)}`, { content }, orgHeader)
           : await api('POST', '/api/wiki/pages', body, orgHeader);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.17.14",
+  "version": "1.17.16",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [