postmd-mcp-server 2.2.0 → 3.0.0

package/README.md

@@ -49,6 +49,22 @@ Each of the first three also accepts `controlToken` instead of a key, for a docu
 | `postmd_create_documents_from_files` | Bulk-publish several `.md` files in one call |
 | `postmd_move_document_to_group` | Move a document into a group / folder |
 
+### Replacing content on a document that has notes
+
+Notes are located by the text they quote, not by a stored position. Replacing a
+document's body therefore moves or loses where they point: a note whose quote is
+gone loses its place in the body, and one whose quote now appears elsewhere points
+there instead. The note itself, including the quoted text, is kept either way.
+
+Both update tools require `notesOnReplace` whenever new content is sent.
+
+| Value | Effect |
+|-------|--------|
+| `keep` | Replaces the content and leaves the notes as they are |
+| `abort` | Refuses when the document has notes anchored to its text, and says how many |
+
+Metadata-only updates do not take it.
+
 Notes and highlights — key with `documents:read` / `documents:write`. A note is
 text anchored to a quoted passage; a highlight is the same object carrying only
 a colour. Visibility comes from ownership: on the key member's own document a note

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postmd-mcp-server",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "description": "MCP server for PostMD — publish Markdown, get a shareable web page",
   "mcpName": "io.github.reinlainer/postmd-mcp-server",
   "type": "module",

package/scripts/smoke-test.mjs

@@ -90,6 +90,22 @@ if (docCode) {
   const meta2 = await callJson(`/documents/${docCode}/meta`);
   check("password cleared", meta2.json?.data?.hasPassword === false, meta2.text);
 
+  // 5b. 본문을 갈아 끼울 때는 붙어 있는 메모를 어떻게 할지 골라야 한다
+  const bodyOnly = new FormData();
+  bodyOnly.append("file", new Blob([`# ${MARKER} v2\n\n다른 문장\n`], { type: "text/markdown" }), "v2.md");
+  const undecided = await callJson(`/documents/${docCode}/update`, { method: "POST", body: bodyOnly });
+  check(
+    "replacing content without notesOnReplace is refused",
+    undecided.json?.resultCode === "E_DOC_0009",
+    undecided.text,
+  );
+
+  const decided = new FormData();
+  decided.append("file", new Blob([`# ${MARKER} v2\n\n다른 문장\n`], { type: "text/markdown" }), "v2.md");
+  decided.append("notesOnReplace", "keep");
+  const replaced = await callJson(`/documents/${docCode}/update`, { method: "POST", body: decided });
+  check("replacing content with keep succeeds", replaced.json?.resultCode === "200", replaced.text);
+
   // 6. 그룹 목록에 보이는지
   if (groupId != null) {
     const listed = await callJson(`/groups/${groupId}/documents?q=smoke`);

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.reinlainer/postmd-mcp-server",
   "description": "Publish Markdown to PostMD and get a shareable web page",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "repository": {
     "url": "https://github.com/reinlainer/postmd-mcp-server",
     "source": "github"
@@ -11,7 +11,7 @@
     {
       "registryType": "npm",
       "identifier": "postmd-mcp-server",
-      "version": "2.2.0",
+      "version": "3.0.0",
       "transport": {
         "type": "stdio"
       },

package/src/index.js

@@ -223,6 +223,21 @@ async function updateDocument(ctx, a, markdownBuffer) {
   if ([...form.keys()].length === 0) {
     return textErr("Nothing to update: pass new markdown, or at least one metadata field.");
   }
+  /*
+    Replacing the content needs a decision about the notes anchored to it. Checked here so the
+    caller reads it as a missing argument rather than an HTTP error from the server.
+  */
+  if (markdownBuffer !== null) {
+    if (a.notesOnReplace !== "keep" && a.notesOnReplace !== "abort") {
+      return textErr(
+        "notesOnReplace is required when replacing the content: keep or abort. " +
+          "Notes are located by the text they quote, so replacing the body moves or loses " +
+          "where they point. keep replaces anyway; abort refuses when the document has notes " +
+          "anchored to its text.",
+      );
+    }
+    form.append("notesOnReplace", a.notesOnReplace);
+  }
   const r = await apiFetch(ctx, `/documents/${encodeURIComponent(a.docCode)}/update`, {
     method: "POST",
     headers: tokenHeader(a),
@@ -237,6 +252,17 @@ async function updateDocument(ctx, a, markdownBuffer) {
  * 키를 대신하는 것이 아니라 그 문서 하나에만 듣는다. 그래서 키가 없어도 이 값이 있으면
  * 도구를 부를 수 있고, 키가 있어도 남의 익명 문서에는 이 값이 있어야 한다.
  */
+const NOTES_ON_REPLACE_PROP = {
+  type: "string",
+  enum: ["keep", "abort"],
+  description:
+    "Required when replacing the content. Notes are located by the text they quote, so " +
+    "replacing the body moves or loses where they point: a note whose quote is gone loses " +
+    "its place in the body, and one whose quote now appears elsewhere points there. " +
+    "keep replaces anyway and leaves the notes. abort refuses when the document has notes " +
+    "anchored to its text, and the answer says how many.",
+};
+
 const CONTROL_TOKEN_PROP = {
   type: "string",
   description:
@@ -378,7 +404,7 @@ const TOOL_DEFS = [
       "or `controlToken` for an anonymously published one. Include `markdown` to replace " +
       "the stored content; any metadata field replaces that field. clearPassword / " +
       "clearShareEndDate remove the password / end date. Updating does not push back the " +
-      "deletion date of an anonymous document.",
+      "deletion date of an anonymous document. Replacing the content requires notesOnReplace.",
     inputSchema: {
       type: "object",
       properties: {
@@ -392,6 +418,7 @@ const TOOL_DEFS = [
         ...DOC_META_PROPS,
         clearPassword: { type: "boolean", description: "true removes the password." },
         clearShareEndDate: { type: "boolean", description: "true removes the end date, making sharing open-ended." },
+        notesOnReplace: NOTES_ON_REPLACE_PROP,
         controlToken: CONTROL_TOKEN_PROP,
       },
       required: ["docCode"],
@@ -415,9 +442,10 @@ const TOOL_DEFS = [
         ...DOC_META_PROPS,
         clearPassword: { type: "boolean", description: "true removes the password." },
         clearShareEndDate: { type: "boolean", description: "true removes the end date, making sharing open-ended." },
+        notesOnReplace: NOTES_ON_REPLACE_PROP,
         controlToken: CONTROL_TOKEN_PROP,
       },
-      required: ["docCode", "filePath"],
+      required: ["docCode", "filePath", "notesOnReplace"],
     },
   },
   {