@jacklika/dsh-memory-mcp 0.1.4-alpha.0 → 0.1.4-alpha.1

package/README.md

@@ -16,7 +16,7 @@ npx dsh-memory-mcp --vault /path/to/vault
 
 ## Surface
 
-Tools: `wiki_read`, `wiki_search`, `wiki_write`, `wiki_graph` — same contract as `@jacklika/dsh-tool-memory-filesystem` / `-graph`, including `baseVersion` optimistic concurrency on writes. Resources: `note:///<id>` over `resources/list` / `resources/read`.
+Tools: `wiki_read`, `wiki_search`, `wiki_write`, `wiki_graph` — same contract as `@jacklika/dsh-tool-memory-filesystem` / `-graph`, including `baseVersion` optimistic concurrency on writes, `mtime` + `modifiedExternally` on reads, and `+08:00` `created`/`updated` normalization on writes. Resources: `note:///<id>` over `resources/list` / `resources/read`.
 
 ## Client configuration
 

package/README.zh.md

@@ -16,7 +16,7 @@ npx dsh-memory-mcp --vault /path/to/vault
 
 ## 暴露面
 
-工具：`wiki_read`、`wiki_search`、`wiki_write`、`wiki_graph` —— 与 `@jacklika/dsh-tool-memory-filesystem` / `-graph` 的契约相同，写操作带 `baseVersion` 乐观并发控制。资源：通过 `resources/list` / `resources/read` 访问 `note:///<id>`。
+工具：`wiki_read`、`wiki_search`、`wiki_write`、`wiki_graph` —— 与 `@jacklika/dsh-tool-memory-filesystem` / `-graph` 的契约相同，写操作带 `baseVersion` 乐观并发控制，读操作返回 `mtime` + `modifiedExternally`，写入归一化 `created`/`updated` 为 `+08:00`。资源：通过 `resources/list` / `resources/read` 访问 `note:///<id>`。
 
 ## 客户端配置
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jacklika/dsh-memory-mcp",
   "description": "MCP stdio server exposing the memory vault to any MCP client — one process owns all writes.",
-  "version": "0.1.4-alpha.0",
+  "version": "0.1.4-alpha.1",
   "publishConfig": {
     "access": "public"
   },

package/src/server.mjs

@@ -8,7 +8,7 @@
  *   --vault defaults to <cwd>/.plugins/memory/ to match the Bundle default.
  */
 import { createHash, randomUUID } from 'node:crypto'
-import { mkdir, readdir, readFile, realpath, rename, rm, writeFile } from 'node:fs/promises'
+import { mkdir, readdir, readFile, realpath, rename, rm, stat, writeFile } from 'node:fs/promises'
 import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'
 import process from 'node:process'
 import readline from 'node:readline'
@@ -93,6 +93,45 @@ function noteVersion(text) {
   return createHash('sha1').update(text).digest('hex')
 }
 
+// Mirrors the mtime tracking and timestamp normalization in
+// @jacklika/dsh-tool-memory-filesystem so MCP clients see the same
+// modifiedExternally flag and +08:00 write normalization as the dsh tools.
+const observedMtimes = new Map()
+const OBSERVED_MTIME_LIMIT = 256
+
+function recordMtime(path, mtimeMs) {
+  observedMtimes.delete(path)
+  observedMtimes.set(path, mtimeMs)
+  if (observedMtimes.size > OBSERVED_MTIME_LIMIT) {
+    const oldest = observedMtimes.keys().next().value
+    if (oldest !== undefined) observedMtimes.delete(oldest)
+  }
+}
+
+function detectExternalChange(path, mtimeMs) {
+  const seen = observedMtimes.get(path)
+  recordMtime(path, mtimeMs)
+  return seen !== undefined && seen !== mtimeMs
+}
+
+function normalizeNoteTimestamps(frontmatter) {
+  for (const key of ['created', 'updated']) {
+    const value = frontmatter[key]
+    if (typeof value !== 'string') continue
+    const parsed = new Date(value)
+    if (Number.isNaN(parsed.getTime())) continue
+    const normalized = formatBeijingTime(parsed)
+    if (normalized !== value) frontmatter[key] = normalized
+  }
+}
+
+function normalizeTextTimestamps(text) {
+  const { frontmatter, body } = splitFrontmatter(text)
+  if (Object.keys(frontmatter).length === 0) return text
+  normalizeNoteTimestamps(frontmatter)
+  return `---\n${yaml.dump(frontmatter).trim()}\n---\n${body}`
+}
+
 function extractLinks(text) {
   const links = []
   for (const m of stripCode(text).matchAll(/\[\[([^\]|]+)(?:\|[^\]]*)?\]\]/g)) links.push(m[1].trim())
@@ -295,9 +334,10 @@ async function writeNote(id, content, mode = 'append', baseVersion) {
   }
   let finalBody
   if (mode === 'overwrite') {
-    finalBody = content
+    finalBody = normalizeTextTimestamps(content)
   } else {
     const { frontmatter, body } = splitFrontmatter(existing ?? '')
+    normalizeNoteTimestamps(frontmatter)
     const fm = Object.keys(frontmatter).length > 0
       ? `---\n${yaml.dump(frontmatter).trimEnd()}\n---\n\n`
       : ''
@@ -311,6 +351,7 @@ async function writeNote(id, content, mode = 'append', baseVersion) {
     await rm(tmp, { force: true }).catch(() => undefined)
     throw error
   }
+  recordMtime(absolutePath, (await stat(absolutePath)).mtimeMs)
   return { id: vaultRelativeId(absolutePath), mode, bytes: Buffer.byteLength(finalBody, 'utf8') }
 }
 
@@ -360,7 +401,7 @@ async function buildGraph(id, depth = 1, maxNodes = 200) {
 const TOOLS = [
   {
     name: 'wiki_read',
-    description: 'Read one Markdown note from the wiki vault, following Obsidian-style [[link]] references up to the configured depth.',
+    description: 'Read one Markdown note from the wiki vault, following Obsidian-style [[link]] references up to the configured depth. Returns mtime and modifiedExternally alongside frontmatter, body, links, and version.',
     inputSchema: {
       type: 'object',
       properties: { id: { type: 'string', description: 'Vault-relative path of the note (e.g. "concepts/RAG.md").' } },
@@ -405,8 +446,16 @@ const TOOLS = [
 
 async function callTool(name, a = {}) {
   switch (name) {
-    case 'wiki_read':
-      return readNote(await containedPathReal(a.id), MAX_LINK_DEPTH)
+    case 'wiki_read': {
+      const absolutePath = await containedPathReal(a.id)
+      const note = await readNote(absolutePath, MAX_LINK_DEPTH)
+      const info = await stat(absolutePath)
+      return {
+        ...note,
+        mtime: formatBeijingTime(info.mtime),
+        modifiedExternally: detectExternalChange(absolutePath, info.mtimeMs),
+      }
+    }
     case 'wiki_search':
       return searchNotes(a.query ?? '')
     case 'wiki_write':