md-feedback 0.9.5 → 0.9.8

package/dist/mcp-server.js

@@ -21129,10 +21129,11 @@ var FEEDBACK_NOTES_RE = /^<!-- \/?(USER_FEEDBACK_NOTES|@\/?feedback-notes)\b.*--
 var RESPONSE_OPEN_RE = /^<!-- REVIEW_RESPONSE\s+to="([^"]+)"\s*-->$/;
 var RESPONSE_CLOSE_RE = /^<!-- \/REVIEW_RESPONSE\s*-->$/;
 function parseAttrs(lines) {
+  const unesc = (s) => s.replace(/&#10;/g, "\n").replace(/&quot;/g, '"');
   const attrs = {};
   for (const line of lines) {
     const m = line.trim().match(/^(\w+)="([^"]*)"$/);
-    if (m) attrs[m[1]] = m[2];
+    if (m) attrs[m[1]] = unesc(m[2]);
   }
   return attrs;
 }
@@ -21321,6 +21322,17 @@ function splitDocument(markdown) {
     openResponse.bodyEndIdx = bodyLines.length - 1;
     responses.push(openResponse);
   }
+  for (const memo of memos) {
+    if (memo.status === "done") {
+      memo.status = "answered";
+    }
+  }
+  const respondedMemoIds = new Set(responses.map((r) => r.to));
+  for (const memo of memos) {
+    if (memo.status === "open" && respondedMemoIds.has(memo.id)) {
+      memo.status = "answered";
+    }
+  }
   return {
     frontmatter,
     body: bodyLines.join("\n"),
@@ -21351,7 +21363,7 @@ function mergeDocument(parts) {
   return sections.join("\n\n") + "\n";
 }
 function serializeMemoV2(memo) {
-  const esc2 = (s) => s.replace(/"/g, "&quot;");
+  const esc2 = (s) => s.replace(/"/g, "&quot;").replace(/\n/g, "&#10;");
   return [
     "<!-- USER_MEMO",
     `  id="${esc2(memo.id)}"`,
@@ -21587,11 +21599,12 @@ function extractMemos(annotatedMarkdown) {
   while (cleanLines.length > 0 && cleanLines[cleanLines.length - 1].trim() === "") cleanLines.pop();
   return { markdown: cleanLines.join("\n"), memos };
 }
-var CHECKPOINT_RE2 = /<!-- CHECKPOINT id="([^"]+)" time="([^"]+)" note="([^"]*)" fixes=(\d+) questions=(\d+) highlights=(\d+) sections="([^"]*)" -->/g;
+var CHECKPOINT_PATTERN = /<!-- CHECKPOINT id="([^"]+)" time="([^"]+)" note="([^"]*)" fixes=(\d+) questions=(\d+) highlights=(\d+) sections="([^"]*)" -->/g;
 function extractCheckpoints(markdown) {
   const checkpoints = [];
+  const re = new RegExp(CHECKPOINT_PATTERN.source, CHECKPOINT_PATTERN.flags);
   let match;
-  while ((match = CHECKPOINT_RE2.exec(markdown)) !== null) {
+  while ((match = re.exec(markdown)) !== null) {
     checkpoints.push({
       id: match[1],
       timestamp: match[2],
@@ -21602,7 +21615,6 @@ function extractCheckpoints(markdown) {
       sectionsReviewed: match[7] ? match[7].split(",") : []
     });
   }
-  CHECKPOINT_RE2.lastIndex = 0;
   return checkpoints;
 }
 function serializeCheckpoint2(cp) {
@@ -22215,7 +22227,7 @@ function registerTools(server2) {
         const reviewedSections = getSectionsWithAnnotations(markdown);
         const gates = evaluateAllGates(parts.gates, parts.memos);
         const open = parts.memos.filter((m) => m.status === "open").length;
-        const done = parts.memos.filter((m) => m.status === "done" || m.status === "answered" || m.status === "wontfix").length;
+        const done = parts.memos.filter((m) => m.status !== "open").length;
         const blocked = gates.filter((g) => g.status === "blocked").length;
         const structure = {
           version: "0.4.0",
@@ -22295,7 +22307,7 @@ function registerTools(server2) {
         const lineNum = anchorLine + 1;
         const color = type === "fix" ? "red" : type === "question" ? "blue" : "yellow";
         const memo = {
-          id: `memo-${Date.now().toString(36)}`,
+          id: `memo-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`,
           type,
           status: "open",
           owner: "agent",
@@ -22346,13 +22358,127 @@ function registerTools(server2) {
       }
     }
   );
+  server2.tool(
+    "respond_to_memo",
+    `Add an AI response to a memo annotation. Inserts a REVIEW_RESPONSE block into the markdown file directly below the memo's anchor text. Automatically sets the memo status to "answered".`,
+    {
+      file: external_exports.string().describe("Path to the annotated markdown file"),
+      memoId: external_exports.string().describe("The memo ID to respond to"),
+      response: external_exports.string().describe("The response text (markdown supported)")
+    },
+    async ({ file, memoId, response }) => {
+      try {
+        const markdown = readMarkdownFile(file);
+        const parts = splitDocument(markdown);
+        const memo = parts.memos.find((m) => m.id === memoId);
+        if (!memo) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({ error: `Memo not found: ${memoId}` })
+            }],
+            isError: true
+          };
+        }
+        const existingResponse = parts.responses.find((r) => r.to === memoId);
+        if (existingResponse) {
+          const bodyLines = parts.body.split("\n");
+          const newResponseLines = response.split("\n");
+          const start = existingResponse.bodyStartIdx;
+          const end = existingResponse.bodyEndIdx;
+          const count = end >= start ? end - start + 1 : 0;
+          bodyLines.splice(start, count, ...newResponseLines);
+          existingResponse.bodyEndIdx = start + newResponseLines.length - 1;
+          parts.body = bodyLines.join("\n");
+        } else {
+          const bodyLines = parts.body.split("\n");
+          let insertAfter = -1;
+          if (memo.anchor) {
+            const anchorMatch = memo.anchor.match(/^L(\d+)(?::L\d+)?\|(.+)$/);
+            if (anchorMatch) {
+              const lineNum = parseInt(anchorMatch[1], 10) - 1;
+              const expectedHash = computeLineHash(bodyLines[lineNum] || "");
+              if (lineNum >= 0 && lineNum < bodyLines.length && expectedHash === anchorMatch[2]) {
+                insertAfter = lineNum;
+              } else {
+                for (let delta = 1; delta <= 10; delta++) {
+                  for (const d of [lineNum - delta, lineNum + delta]) {
+                    if (d >= 0 && d < bodyLines.length && computeLineHash(bodyLines[d]) === anchorMatch[2]) {
+                      insertAfter = d;
+                      break;
+                    }
+                  }
+                  if (insertAfter >= 0) break;
+                }
+              }
+            }
+          }
+          if (insertAfter === -1 && memo.anchorText) {
+            for (let i = 0; i < bodyLines.length; i++) {
+              if (bodyLines[i].includes(memo.anchorText)) {
+                insertAfter = i;
+                break;
+              }
+            }
+          }
+          if (insertAfter === -1) {
+            insertAfter = bodyLines.length - 1;
+          }
+          const responseLines = response.split("\n");
+          const insertIdx = insertAfter + 1;
+          bodyLines.splice(insertIdx, 0, ...responseLines);
+          for (const r of parts.responses) {
+            if (r.bodyStartIdx >= insertIdx) {
+              r.bodyStartIdx += responseLines.length;
+              r.bodyEndIdx += responseLines.length;
+            }
+          }
+          parts.body = bodyLines.join("\n");
+          parts.responses.push({
+            id: `resp_${memoId}`,
+            to: memoId,
+            bodyStartIdx: insertIdx,
+            bodyEndIdx: insertIdx + responseLines.length - 1
+          });
+        }
+        if (memo.status === "open") {
+          memo.status = "answered";
+          memo.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+        }
+        if (parts.gates.length > 0) {
+          parts.gates = evaluateAllGates(parts.gates, parts.memos);
+        }
+        const updated = mergeDocument(parts);
+        writeMarkdownFile(file, updated);
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              memoId,
+              status: memo.status,
+              responseInserted: true,
+              totalResponses: parts.responses.length
+            }, null, 2)
+          }]
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) })
+          }],
+          isError: true
+        };
+      }
+    }
+  );
   server2.tool(
     "update_memo_status",
     "Update the status of a memo annotation. Writes the change back to the markdown file. Returns the updated memo.",
     {
       file: external_exports.string().describe("Path to the annotated markdown file"),
       memoId: external_exports.string().describe("The memo ID to update"),
-      status: external_exports.enum(["open", "answered", "done", "wontfix"]).describe("New status"),
+      status: external_exports.enum(["open", "answered", "wontfix"]).describe("New status"),
       owner: external_exports.enum(["human", "agent", "tool"]).optional().describe("Optionally change the owner")
     },
     async ({ file, memoId, status, owner }) => {
@@ -22552,13 +22678,13 @@ function log(msg) {
 }
 var server = new McpServer({
   name: "md-feedback",
-  version: "0.9.5"
+  version: "0.9.8"
 });
 registerTools(server);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  log(`v${"0.9.5"} ready (stdio)`);
+  log(`v${"0.9.8"} ready (stdio)`);
 }
 main().catch((err) => {
   log(`fatal: ${err}`);

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "md-feedback",
-  "version": "0.9.5",
-  "description": "MCP server for AI plan review — agents read your markdown annotations, mark tasks done, evaluate gates, and generate handoffs.",
-  "license": "SUL-1.0",
-  "author": "Yeomin Seon",
-  "type": "commonjs",
-  "bin": {
-    "md-feedback": "./bin/md-feedback.cjs"
-  },
-  "files": [
-    "dist/mcp-server.js",
-    "bin/md-feedback.cjs",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "node esbuild.mjs"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "esbuild": "^0.24.2",
-    "typescript": "^5.7.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/yeominux/md-feedback"
-  },
-  "homepage": "https://github.com/yeominux/md-feedback#mcp-server",
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "markdown",
-    "feedback",
-    "ai",
-    "annotation",
-    "review",
-    "plan-review",
-    "ai-agent",
-    "coding-workflow",
-    "handoff",
-    "session-handoff",
-    "structured-feedback",
-    "checkpoint",
-    "ai-context",
-    "ai-coding",
-    "claude-code",
-    "cursor-ai",
-    "vibe-coding",
-    "context-engineering",
-    "gates",
-    "plan-review-tool"
-  ]
-}
+{
+  "name": "md-feedback",
+  "version": "0.9.8",
+  "description": "MCP server for AI plan review — agents read your markdown annotations, mark tasks done, evaluate gates, and generate handoffs.",
+  "license": "SUL-1.0",
+  "author": "Yeomin Seon",
+  "type": "commonjs",
+  "bin": {
+    "md-feedback": "./bin/md-feedback.cjs"
+  },
+  "files": [
+    "dist/mcp-server.js",
+    "bin/md-feedback.cjs",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node esbuild.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.2",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yeominux/md-feedback"
+  },
+  "homepage": "https://github.com/yeominux/md-feedback#mcp-server",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "markdown",
+    "feedback",
+    "ai",
+    "annotation",
+    "review",
+    "plan-review",
+    "ai-agent",
+    "coding-workflow",
+    "handoff",
+    "session-handoff",
+    "structured-feedback",
+    "checkpoint",
+    "ai-context",
+    "ai-coding",
+    "claude-code",
+    "cursor-ai",
+    "vibe-coding",
+    "context-engineering",
+    "gates",
+    "plan-review-tool"
+  ]
+}