@skyelight/mcp 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyelight/mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for Skyelight \u2014 read feedback items from your project as an agent",
   "type": "module",
   "bin": {

package/src/tools.js

@@ -172,7 +172,7 @@ export function toolDefinitions(opts = {}) {
       description:
         "Move an item to open, deferred or resolved. Use it to close the loop after you have " +
         "fixed something and said so \u2014 post_update first, so the person who reported it " +
-        "reads what changed, then set_status. \"deferred\" is for work that is real but not now.",
+        'reads what changed, then set_status. "deferred" is for work that is real but not now.',
       inputSchema: {
         type: "object",
         properties: {
@@ -398,6 +398,41 @@ export function renderItem(item) {
         ? `Written by ${where}, in ${from.join(" on ")}.`
         : `Written by ${where}.`,
     );
+    // The permalink, when the project names a repository. Pinned to the
+    // commit the page carried rather than to a branch, so it opens the code
+    // the person was actually looking at.
+    if (item.sourceUrl) lines.push(item.sourceUrl);
+  }
+
+  // The stamps read in both directions.
+  //
+  // Separated from the one-line `Written by` above because they answer a
+  // different question. That line says where the pinned element came from;
+  // this says which component it lives in, and which of its parts a request
+  // is likely to be about. A person points at a row and means the text
+  // inside it far more often than they mean the row.
+  const path = item.sourcePath;
+  if (path && (path.above.length || path.below.length)) {
+    if (path.above.length) {
+      lines.push("");
+      lines.push("Nested inside");
+      // Outermost first, so a repeated file reads as one component and a
+      // change of file reads as a boundary between two.
+      for (const step of path.above) {
+        lines.push(`  ${step.file}:${step.line ?? "?"}  <${step.tag}>`);
+      }
+    }
+    if (path.below.length) {
+      lines.push("");
+      lines.push("Contains");
+      for (const step of path.below) {
+        const indent = "  ".repeat((step.depth ?? 0) + 1);
+        const text = step.text ? `  "${step.text}"` : "";
+        lines.push(
+          `${indent}<${step.tag}> ${step.file}:${step.line ?? "?"}${text}`,
+        );
+      }
+    }
   }
 
   return lines.join("\n");