dsh-mindmap 0.3.0 → 0.5.0

package/index.js

@@ -14,8 +14,8 @@
 //   namespace 可在设置面板运行时切换（见 SETTINGS_NAMESPACE/Config）。
 // - 依赖：仅 @deepseek-ai/schemastery（settings schema；发布包正常解析，
 //   link 开发需先 npm i）。工具参数 schema 仍手写 JSON Schema（003 偏差 1）。
-import { access, opendir, readFile, rename, writeFile } from 'node:fs/promises'
-import { dirname, isAbsolute, join, relative, resolve as resolvePath } from 'node:path'
+import { access, opendir, readFile, rename, stat, writeFile } from 'node:fs/promises'
+import { dirname, isAbsolute, join, relative, resolve as resolvePath, sep } from 'node:path'
 import Schema from '@deepseek-ai/schemastery'
 
 export const name = 'mindmap'
@@ -31,6 +31,7 @@ export const Config = Schema.object({
   lineStyle: Schema.union(['curve', 'elbow']).default('elbow').description('Connector line style between nodes: curve (bezier) or elbow (orthogonal).'),
   cardStyle: Schema.union(['rounded', 'square']).default('rounded').description('Node card corner style.'),
   colorTheme: Schema.union(['ocean', 'sunset', 'forest']).default('ocean').description('Node color theme.'),
+  growthAnimation: Schema.boolean().default(true).description('Progressive growth animation: newly added/changed nodes fade in one by one after each update (total capped at ~2s). Turn off for instant full render.'),
 })
 
 const MAX_CONTENT_BYTES = 2 * 1024 * 1024
@@ -53,7 +54,8 @@ Markdown mapping (the panel's parser): headings nest by level (H1 are root child
 
 Behavior rules:
 - When the user asks to create a mindmap, call mindmap_create. When the user asks to open, view, show, or switch to an existing mindmap, call mindmap_open (do not use mindmap_get alone). Both operations bring that document to the visible mindmap panel automatically.
-- Always mindmap_get before editing, then send the complete updated document to mindmap_update. One tool call per step so the panel follows along live.
+- Always mindmap_get before editing, then send the complete updated document to mindmap_update. Every call must carry the FULL document, never a fragment.
+- Update step by step: whenever the request involves several parts, call mindmap_update as soon as each part is ready — several small updates beat one giant update at the end. The panel plays a growth animation on newly added/changed nodes, so step-by-step updates make the tree visibly grow while you work. Do not call mindmap_update twice in a row with identical content.
 - Never delete the whole document or restructure it without an explicit user request. Make the smallest change that answers the request.
 - When the user steps away or pauses (e.g. "我去买咖啡"), stop all mindmap edits immediately and wait — never continue autonomously.
 - Never run any git command for these files. The user commits themselves.
@@ -105,6 +107,12 @@ function sessionCwdOf(sessions, sessionId) {
   return typeof cwd === 'string' && cwd ? cwd : null
 }
 
+/** 相对路径是否越出 base（`..` 本身或以 `..` + 分隔符开头；不能只看 `..` 前缀——
+ *  `..notes.md` 这类文件名会被误判）。 */
+function escapesBase(rel) {
+  return rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)
+}
+
 /** 请求路径校验：缺省 = 根 cwd；显式路径必须绝对且落在 cwd 内。 */
 function resolveTreePath(cwd, input) {
   if (!cwd) throw httpError(400, 'no-cwd', 'session has no working directory')
@@ -113,7 +121,7 @@ function resolveTreePath(cwd, input) {
   if (!isAbsolute(p)) throw httpError(400, 'bad-request', `path must be absolute: ${JSON.stringify(p)}`)
   const resolved = resolvePath(p)
   const rel = relative(cwd, resolved)
-  if (rel.startsWith('..') || isAbsolute(rel)) {
+  if (escapesBase(rel)) {
     throw httpError(400, 'bad-request', `path must stay inside the session working directory (${cwd})`)
   }
   return resolved
@@ -206,7 +214,7 @@ function resolveMindmapPath(cwd, input) {
   }
   const resolved = resolvePath(cwd, p)
   const rel = relative(cwd, resolved)
-  if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) {
+  if (rel === '' || escapesBase(rel)) {
     throw new Error(`mindmap path must stay inside the session working directory (${cwd}).`)
   }
   return resolved
@@ -221,6 +229,20 @@ async function pathExists(p) {
   }
 }
 
+/**
+ * 两个路径是否指向同一个文件（dev + inode 比较）。大小写不敏感 FS（macOS/
+ * Windows）上仅大小写不同的路径命中同一文件——case-only 改名时据此区分
+ * 「目标就是自己」（放行）与「真有另一个同名文件」（碰撞报错）。
+ */
+async function sameFile(a, b) {
+  try {
+    const [sa, sb] = await Promise.all([stat(a), stat(b)])
+    return sa.dev === sb.dev && sa.ino === sb.ino
+  } catch {
+    return false
+  }
+}
+
 function byteLength(value) {
   return new TextEncoder().encode(value).byteLength
 }
@@ -238,7 +260,16 @@ function defineTool(spec) {
 }
 
 export function apply(ctx, config = {}) {
-  const entryConfig = { requireApproval: config.requireApproval === true, defaultPanelWidth: 42 }
+  // 入口配置作为 settings 组合层的 base：视觉三件套与默认宽度在这里
+  // 透传（带 schema 同款默认值），用户设置层仍可在设置面板覆盖。
+  const entryConfig = {
+    requireApproval: config.requireApproval === true,
+    defaultPanelWidth: typeof config.defaultPanelWidth === 'number' ? config.defaultPanelWidth : 42,
+    lineStyle: config.lineStyle === 'curve' ? 'curve' : 'elbow',
+    cardStyle: config.cardStyle === 'square' ? 'square' : 'rounded',
+    colorTheme: config.colorTheme === 'sunset' || config.colorTheme === 'forest' ? config.colorTheme : 'ocean',
+    growthAnimation: config.growthAnimation !== false,
+  }
 
   // 015 设置面板：settings 服务可用时以命名空间解析值为准
   // （schema 默认 → 组合层 base → 用户设置层），否则回退入口配置
@@ -288,8 +319,15 @@ export function apply(ctx, config = {}) {
       if (!cwd) throw new Error('The session has no working directory; cannot create a mindmap.')
       const stem = sanitizeStem(args?.name)
       const path = resolveMindmapPath(cwd, `${stem}.md`)
-      if (await pathExists(path)) throw new Error(`Mindmap already exists: ${JSON.stringify(path)}. Open it with mindmap_open instead.`)
-      await writeFile(path, '', 'utf8')
+      // wx = 不存在才创建：原子拒绝已存在（含并发竞态）与同名目录，无 TOCTOU 窗口。
+      try {
+        await writeFile(path, '', { encoding: 'utf8', flag: 'wx' })
+      } catch (error) {
+        if (error && (error.code === 'EEXIST' || error.code === 'EISDIR')) {
+          throw new Error(`Mindmap already exists: ${JSON.stringify(path)}. Open it with mindmap_open instead.`)
+        }
+        throw error
+      }
       return buildResult('create', path, { content: '', created: true })
     },
   }))
@@ -334,7 +372,7 @@ export function apply(ctx, config = {}) {
 
   ctx.tools.register(defineTool({
     name: 'mindmap_update',
-    description: 'Write the FULL updated markdown of a mindmap document. Call mindmap_get first, then send the complete new content so the panel updates in one step. Optionally renameRoot to change the root title (renames the file; fails on name collision).',
+    description: 'Write the FULL updated markdown of a mindmap document. Call mindmap_get first, then send the complete new content. When the edit has several parts, call once per finished part (always full content) so the panel grows the new nodes step by step. Optionally renameRoot to change the root title (renames the file; fails on name collision).',
     parameters: {
       type: 'object',
       properties: {
@@ -366,7 +404,9 @@ export function apply(ctx, config = {}) {
         // cwd 缺失的绝对路径场景同样成立）。
         const target = resolvePath(dirname(path), `${stem}.md`)
         if (target !== path) {
-          if (await pathExists(target)) {
+          // case-only 改名（如 Plan → plan）在大小写不敏感 FS 上 pathExists(target)
+          // 命中的就是自己——用 sameFile 放行；真碰撞（不同文件）才报错。
+          if (await pathExists(target) && !(await sameFile(path, target))) {
             throw new Error(`Cannot rename root: ${JSON.stringify(target)} already exists. Pick another name.`)
           }
           await rename(path, target)
@@ -398,7 +438,7 @@ export function apply(ctx, config = {}) {
       }
       try {
         const method = new URL(req.url ?? '/', 'http://dsh.internal').pathname.slice('/mindmap/api/'.length)
-        if (method !== 'tree' || method.includes('/')) {
+        if (method !== 'tree') {
           sendJson(res, 404, { ok: false, error: { code: 'not-found', message: `unknown mindmap API method ${JSON.stringify(method)}` } })
           return
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mindmap",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Mindmap plugin for DeepSeek Harness: a plain markdown file in the working directory IS the mindmap; the chat edits it step by step and the right-side panel follows live.",
   "repository": {
     "type": "git",
@@ -13,6 +13,8 @@
   "publishConfig": {
     "access": "public"
   },
+  "author": "guhanfei-ai",
+  "license": "MIT",
   "type": "module",
   "main": "index.js",
   "scripts": {