drafted 1.19.48 → 1.19.49

package/mcp/server.mjs

@@ -3308,6 +3308,7 @@ tool('fs', 'Navigate Drafted like a local filesystem. A FOLDER is the single con
   recursive: z.boolean().optional().describe('[ls] recurse into subdirectories'),
   lines: z.string().optional().describe('[read] line range (e.g. "1-50") — partial read; content is hashline-annotated so a later edit stays surgical'),
   pattern: z.string().optional().describe('[ls] filter filenames (e.g. "*.html")'),
+  readonly: z.boolean().optional().describe('[link] read-only frame link (symlink): mirror the SOURCE frame named by `to` (a frame UUID or /projects/<other-project>/<layer>/<lane>/<file>) into the CURRENT project, displayed read-only. The source project stays the single writer.'),
   org: z.string().optional().describe('Org (id or name) for bare /wiki and /skills paths (org-scoped /o/<org>/... paths don\'t need it). Per-request only; project paths self-derive org from the project row.'),
   projectId: PROJECT_OVERRIDE_PARAM,
 }, async (args) => {
@@ -4215,6 +4216,31 @@ tool('fs', 'Navigate Drafted like a local filesystem. A FOLDER is the single con
           if (!filePath) return err(new Error(`${action} requires a source file path: /projects/<project>/<layer>/<lane>/<file>`));
           const from = lane ? `/${layer}/${lane}/${filename}` : `/${layer}/${filename}`;
           const body = { from };
+          if (action === 'link' && args.readonly) {
+            // Read-only frame link (symlink): mirror the frame INTO the current
+            // project read-only. `to` names the SOURCE frame — a frame UUID or an
+            // fs path in another project (/projects/<slug>/<layer>/<lane>/<file>).
+            if (!to) return err(new Error('readonly link requires to=<source frame path in another project, or a frame UUID>'));
+            const t = String(to);
+            let sourceId;
+            if (/^[0-9a-f-]{36}$/.test(t)) {
+              sourceId = t;
+            } else if (t.startsWith('/o/') && t.includes('/projects/')) {
+              // Absolute path — the server mirror route parses it directly.
+              sourceId = t;
+            } else {
+              let dest;
+              try { dest = await resolveProjectsDestination(t); }
+              catch (e) { return err(e); }
+              if (!dest || !dest.meta || !dest.meta.id || dest.rest.length < 2) {
+                return err(new Error('readonly link requires to=/projects/<project>/<layer>/<lane>/<file> or a frame UUID'));
+              }
+              const src = await api('GET', `/api/fs/${dest.rest.join('/')}?projectId=${dest.meta.id}`, undefined, orgHeader);
+              if (!src?.id) return err(new Error(`Source frame not found: ${t}`));
+              sourceId = src.id;
+            }
+            return ok(await api('POST', '/api/fs/link', { mirror: true, from: sourceId }, orgHeader));
+          }
           if (args.url) {
             body.url = args.url;
           } else if (to) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.19.48",
+  "version": "1.19.49",
   "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": [