write_note: replace now keeps page properties (no separate wipe mode)

mode="replace" previously wiped the whole page including its property block, so an
agent updating a page's text silently lost page properties (find_tasks scoping and
Logseq filtering depend on them). Now replace swaps the content but preserves page
properties (captured from the first block, re-applied to the new content). To
remove a property, use set_page_properties with a null value — no ambiguous
"replace_without_properties" mode. Bump 0.2.1. Smoke-tested live + 46 unit tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: mandanya

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-server-logseq"
-version = "0.2.0"
+version = "0.2.1"
 description = "An MCP server for LogSeq API"
 readme = "README.md"
 requires-python = ">=3.11"

src/mcp_server_logseq/guide.py

@@ -80,6 +80,9 @@
   Passing an already-prefixed subpath is fine (no double prefix). You cannot edit
   pages outside `{prefix}/` — an unprefixed subpath is rewritten into it. Content
   starting with a task marker is rejected — use `create_task` for tasks.
+- `mode`: `append` adds a block; `replace` swaps the page content but **keeps page
+  properties** (to remove a property use `set_page_properties` with a null value).
+  write_note appends a block to a page — it never edits one block in place.
 """
 
 

src/mcp_server_logseq/server.py

@@ -381,7 +381,7 @@ async def read_block(
 async def write_note(
     subpath: Annotated[str, Field(description="Page path within the agent namespace")],
     content: Annotated[Optional[str], Field(description="Block content to add (markdown)")] = None,
-    mode: Annotated[str, Field(description="append | replace")] = "append",
+    mode: Annotated[str, Field(description="append | replace (swaps page content, keeps page properties; remove a property via set_page_properties null)")] = "append",
     properties: Annotated[Optional[dict], Field(description="Page properties (set on creation)")] = None,
 ) -> dict:
     """Create or update a page in the agent's namespace."""

src/mcp_server_logseq/writes.py

@@ -76,8 +76,13 @@ async def write_note(
         client, name, properties, create_first_block=bool(properties)
     )
 
+    preserved: dict = {}
     if mode == "replace" and existed:
         tree = await client.call("logseq.Editor.getPageBlocksTree", [name]) or []
+        # Replace swaps content but keeps page properties (they live on the first
+        # block); to remove a property, use set_page_properties(..., {prop: null}).
+        if tree:
+            preserved = tree[0].get("properties") or {}
         for blk in tree:
             uuid = blk.get("uuid")
             if uuid:
@@ -89,10 +94,21 @@ async def write_note(
         if isinstance(block, dict):
             appended_uuid = block.get("uuid")
 
+    # Re-attach preserved page properties to the new first block (mode="replace").
+    if preserved:
+        holder = appended_uuid
+        if holder is None:
+            block = await client.call("logseq.Editor.appendBlockInPage", [name, ""])
+            holder = block.get("uuid") if isinstance(block, dict) else None
+        if holder:
+            for key, value in preserved.items():
+                await client.call("logseq.Editor.upsertBlockProperty", [holder, key, value])
+
     return {
         "page": name,
         "already_existed": existed,
         "appended_uuid": appended_uuid,
+        "kept_properties": list(preserved.keys()),
     }