relic-mcp 0.4.0 → 0.5.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "relic",
       "description": "Publish a file from your machine as an encrypted, shareable link. The agent encrypts locally, uploads only ciphertext, and hands back a URL whose fragment holds the key, so the service stores something it cannot read.",
-      "version": "0.4.0",
+      "version": "0.5.0",
       "source": "./",
       "author": {
         "name": "The Bushido Collective",
@@ -21,6 +21,6 @@
     }
   ],
   "metadata": {
-    "version": "0.4.0"
+    "version": "0.5.0"
   }
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "relic",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Publish a file from your machine as an encrypted, shareable link. The agent encrypts locally, uploads only ciphertext, and hands back a URL whose fragment holds the key, so the service stores something it cannot read.",
   "mcpServers": "./mcp-servers.json",
   "author": {

package/dist/relic-mcp.js

@@ -1317,6 +1317,7 @@ async function readComments(relicId, deps) {
         created_at: createdAt,
         display_name: null,
         body: null,
+        anchor: null,
         readable: false,
         unreadable_reason: "the row carried no ciphertext"
       });
@@ -1330,6 +1331,7 @@ async function readComments(relicId, deps) {
         created_at: createdAt,
         display_name: plaintext.display_name,
         body: plaintext.body,
+        anchor: plaintext.anchor ?? null,
         readable: true,
         unreadable_reason: null
       });
@@ -1341,6 +1343,7 @@ async function readComments(relicId, deps) {
         created_at: createdAt,
         display_name: null,
         body: null,
+        anchor: null,
         readable: false,
         unreadable_reason: `it did not decrypt under this relic's comment key: ${error.message}`
       });
@@ -1673,6 +1676,16 @@ var READ_COMMENTS_TOOL_DEFINITION = {
             created_at: { type: "string" },
             display_name: { type: ["string", "null"] },
             body: { type: ["string", "null"] },
+            anchor: {
+              type: ["object", "null"],
+              description: "What the comment marks, or null for a freeform one. " + '`{kind:"text", quote}` is a passage the reader selected, so ' + 'the quote names the line to act on. `{kind:"pin", x, y}` is ' + "a point on the rendered page in unit coordinates.",
+              properties: {
+                kind: { type: "string", enum: ["text", "pin"] },
+                quote: { type: "string" },
+                x: { type: "number" },
+                y: { type: "number" }
+              }
+            },
             readable: { type: "boolean" },
             unreadable_reason: { type: ["string", "null"] }
           },
@@ -1682,6 +1695,7 @@ var READ_COMMENTS_TOOL_DEFINITION = {
             "created_at",
             "display_name",
             "body",
+            "anchor",
             "readable",
             "unreadable_reason"
           ],
@@ -1738,7 +1752,7 @@ var DESCRIBE_TOOL_DEFINITION = {
     additionalProperties: false
   }
 };
-var SERVER_VERSION = "0.4.0";
+var SERVER_VERSION = "0.5.0";
 var SERVER_INFO = {
   name: "relic",
   title: "Relic",
@@ -2035,15 +2049,29 @@ async function callComment(id2, params, deps) {
     return { jsonrpc: "2.0", id: id2, result: toolError(error) };
   }
 }
+function markLine(anchor) {
+  if (anchor === null)
+    return "";
+  if (anchor.kind === "text")
+    return `on "${anchor.quote}"
+`;
+  const percent = (value) => Math.round(value * 100);
+  return `at ${percent(anchor.x)}% across, ${percent(anchor.y)}% down
+`;
+}
 function commentTranscript(result) {
   if (result.count === 0) {
     return `No comments on relic ${result.relic_id} yet.`;
   }
   const lines = result.comments.map((comment) => {
     const who = comment.display_name === null ? comment.author : `${comment.display_name} (${comment.author})`;
-    return comment.readable ? `${comment.created_at} ${who}:
-${comment.body}` : `${comment.created_at} ${who}:
+    if (!comment.readable) {
+      return `${comment.created_at} ${who}:
 [unreadable: ${comment.unreadable_reason}]`;
+    }
+    const mark = markLine(comment.anchor);
+    return `${comment.created_at} ${who}:
+${mark}${comment.body}`;
   });
   const header = result.unreadable_count === 0 ? `${result.count} comment(s) on relic ${result.relic_id}, oldest first.` : `${result.count} comment(s) on relic ${result.relic_id}, oldest ` + `first. ${result.unreadable_count} did not decrypt and are shown as ` + "unreadable rather than dropped, so treat this conversation as " + "partially unread.";
   return `${header}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relic-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Publish a file as an encrypted relic. The key is generated on your machine and never sent to the service.",
   "license": "MIT",
   "type": "module",

package/src/comments.ts

@@ -30,6 +30,7 @@
 import {
   COMMENT_BODY_LIMIT_BYTES,
   COMMENT_DISPLAY_NAME_LIMIT_BYTES,
+  type CommentAnchor,
   decodeKey,
   decryptComment,
   deriveCommentKey,
@@ -59,6 +60,16 @@ export interface CommentRecord {
   readonly display_name: string | null;
   /** Null exactly when `readable` is false. */
   readonly body: string | null;
+  /**
+   * What the comment is a mark on, or null for a freeform one.
+   *
+   * Dropping this was a defect rather than an omission. A reviewer's "this
+   * line is wrong" is not actionable without the line, and an agent reading a
+   * thread back could not tell a mark from a general remark, which is the
+   * difference between fixing the right sentence and guessing. It lives inside
+   * the encrypted envelope, so it arrives with the body or not at all.
+   */
+  readonly anchor: CommentAnchor | null;
   readonly readable: boolean;
   /** Null exactly when `readable` is true. */
   readonly unreadable_reason: string | null;
@@ -138,6 +149,7 @@ export async function readComments(
         created_at: createdAt,
         display_name: null,
         body: null,
+        anchor: null,
         readable: false,
         unreadable_reason: 'the row carried no ciphertext',
       });
@@ -152,6 +164,9 @@ export async function readComments(
         created_at: createdAt,
         display_name: plaintext.display_name,
         body: plaintext.body,
+        // Absent and null both mean freeform. One shape crosses to the agent,
+        // so a caller never has to distinguish two ways of saying no mark.
+        anchor: plaintext.anchor ?? null,
         readable: true,
         unreadable_reason: null,
       });
@@ -165,6 +180,7 @@ export async function readComments(
         created_at: createdAt,
         display_name: null,
         body: null,
+        anchor: null,
         readable: false,
         unreadable_reason: `it did not decrypt under this relic's comment key: ${
           (error as Error).message

package/src/server.ts

@@ -393,6 +393,20 @@ export const READ_COMMENTS_TOOL_DEFINITION = {
             created_at: { type: 'string' },
             display_name: { type: ['string', 'null'] },
             body: { type: ['string', 'null'] },
+            anchor: {
+              type: ['object', 'null'],
+              description:
+                'What the comment marks, or null for a freeform one. ' +
+                '`{kind:"text", quote}` is a passage the reader selected, so ' +
+                'the quote names the line to act on. `{kind:"pin", x, y}` is ' +
+                'a point on the rendered page in unit coordinates.',
+              properties: {
+                kind: { type: 'string', enum: ['text', 'pin'] },
+                quote: { type: 'string' },
+                x: { type: 'number' },
+                y: { type: 'number' },
+              },
+            },
             readable: { type: 'boolean' },
             unreadable_reason: { type: ['string', 'null'] },
           },
@@ -402,6 +416,7 @@ export const READ_COMMENTS_TOOL_DEFINITION = {
             'created_at',
             'display_name',
             'body',
+            'anchor',
             'readable',
             'unreadable_reason',
           ],
@@ -1013,6 +1028,21 @@ async function callComment(
   }
 }
 
+/**
+ * The one line that says what a comment is attached to.
+ *
+ * A quote is printed verbatim, because the reader selected those exact words
+ * and an agent's next move is usually to find them. A pin has no words, so it
+ * gets its position rounded to whole percent: more precision than that is
+ * noise a person cannot act on.
+ */
+function markLine(anchor: CommentRecord['anchor']): string {
+  if (anchor === null) return '';
+  if (anchor.kind === 'text') return `on "${anchor.quote}"\n`;
+  const percent = (value: number): number => Math.round(value * 100);
+  return `at ${percent(anchor.x)}% across, ${percent(anchor.y)}% down\n`;
+}
+
 /**
  * The comments as a person would read them, because a JSON array of rows is
  * not a conversation.
@@ -1037,9 +1067,14 @@ function commentTranscript(result: {
       comment.display_name === null
         ? comment.author
         : `${comment.display_name} (${comment.author})`;
-    return comment.readable
-      ? `${comment.created_at} ${who}:\n${comment.body}`
-      : `${comment.created_at} ${who}:\n[unreadable: ${comment.unreadable_reason}]`;
+    if (!comment.readable) {
+      return `${comment.created_at} ${who}:\n[unreadable: ${comment.unreadable_reason}]`;
+    }
+    // The mark goes above the body, because it is what the body is about. A
+    // transcript that printed the remark and withheld the line it points at
+    // would be the same defect this fixed, one layer up.
+    const mark = markLine(comment.anchor);
+    return `${comment.created_at} ${who}:\n${mark}${comment.body}`;
   });
 
   const header =