@xiaobuyu/nodesign 0.0.6 → 0.0.8

package/server/engine/mcp/tools/arrange-on-board.js

@@ -1,124 +0,0 @@
-/**
- * mcp/tools/arrange-on-board.js —— arrange_on_board（2026-08-14，agent 摆位批·写侧）
- *
- * 语义摆位，**不给裸坐标**（用户拍板）：agent 说的是"把 A 摆到 B 旁边"这种
- * 人话，坐标由这里算出来、写进跟用户拖拽**同一个 layout 权威**（board.objects
- * 的 x/y）—— 布局引擎、用户、agent 三方从此不打架。撞上已有的卡就往下让
- * （跟入座避让同一个精神），落盘带 by:'agent' 出处。
- *
- * feature/unfeature 立/撤主角：写 board.hero，前端 pickHero 的推断被它压过。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { readBoard, patchBoard } from '../../../projects/board-store.js';
-import { estimateSizeOn } from '../../../lib/board-kind-sizes.js';
-import { normalizeCanvasId, layerOf } from '../../../lib/canvas-id.js';
-
-const GAP_X = 24;
-const GAP_Y = 16;
-
-const hit = (a, b) => !(a.x + a.w <= b.x || b.x + b.w <= a.x || a.y + a.h <= b.y || b.y + b.h <= a.y);
-
-/** 撞卡往下让：同一层的既有条目当障碍（subject 自己除外） */
-function nudgeDown(pos, size, obstacles) {
-  const r = { ...pos, ...size };
-  for (let guard = 0; guard < 60; guard += 1) {
-    const blocker = obstacles.find(o => hit(r, o));
-    if (!blocker) return { x: r.x, y: r.y };
-    r.y = blocker.y + blocker.h + GAP_Y;
-  }
-  return { x: r.x, y: r.y };
-}
-
-export function makeArrangeOnBoardTool({ projectId, ctx }) {
-  return tool(
-    'arrange_on_board',
-    `Move things on the canvas by MEANING, not pixels. Read the chart first (read_board).
-
-Actions:
-- beside:   put subject immediately right of anchor (same row)
-- below:    put subject under anchor (same column)
-- feature:  make subject THE hero of the desktop (rendered one size up); no anchor
-- unfeature: drop the explicit hero, back to automatic judgment; no subject needed
-
-Rules the tool enforces: subject and anchor must live in the same folder layer
-(move files with mv first); collisions push the subject downward; your placements
-are marked by:'agent' so the user can tell who seated what. The user can always
-drag things afterwards — their move wins, do not fight it.`,
-    {
-      action: z.enum(['beside', 'below', 'feature', 'unfeature'])
-        .describe('What to do (see list above)'),
-      subject: z.string().min(1).max(300).optional()
-        .describe('Canvas id of the thing to move / feature (required except for unfeature)'),
-      anchor: z.string().min(1).max(300).optional()
-        .describe('Canvas id to place the subject relative to (required for beside/below)'),
-    },
-    async ({ action, subject: rawSubject, anchor: rawAnchor }) => {
-      if (!projectId) {
-        return { content: [{ type: 'text', text: 'No project bound.' }], isError: true };
-      }
-      const err = (t) => ({ content: [{ type: 'text', text: t }], isError: true });
-
-      if (action === 'unfeature') {
-        await patchBoard(projectId, { hero: null });
-        try { ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: '撤了显式主角' }); } catch { /* fail-soft */ }
-        return { content: [{ type: 'text', text: 'Hero override cleared — automatic judgment resumes.' }] };
-      }
-
-      const subject = normalizeCanvasId(rawSubject);
-      if (!subject) return err('subject id 不合法。');
-
-      if (action === 'feature') {
-        await patchBoard(projectId, { hero: subject });
-        try { ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: `立了主角：${subject}` }); } catch { /* fail-soft */ }
-        return { content: [{ type: 'text', text: `Featured: ${subject} now renders as the hero.` }] };
-      }
-
-      const anchor = normalizeCanvasId(rawAnchor);
-      if (!anchor) return err('beside/below 需要 anchor。');
-      if (anchor === subject) return err('subject 和 anchor 是同一件东西。');
-
-      const board = await readBoard(projectId);
-      const anchorEntry = board.objects?.[anchor];
-      if (!anchorEntry || !Number.isFinite(anchorEntry.x)) {
-        return err(`锚点 ${anchor} 还没有座位（read_board 里看不到的东西没法当锚）。`);
-      }
-      const known = new Set(Object.keys(board.zones || {}));
-      const subjectEntry = board.objects?.[subject] || null;
-      const anchorLayer = layerOf(anchor, anchorEntry, known);
-      if (subjectEntry) {
-        const subjectLayer = layerOf(subject, subjectEntry, known);
-        if (subjectLayer !== anchorLayer) {
-          return err(`不同层（${subjectLayer || '根'} vs ${anchorLayer || '根'}）：先 mv 文件到同一个文件夹，画布跟着走。`);
-        }
-      }
-
-      const aSize = estimateSizeOn(board, anchor, anchorEntry);
-      const sSize = estimateSizeOn(board, subject, subjectEntry);
-      const want = action === 'beside'
-        ? { x: Math.round(anchorEntry.x + aSize.w + GAP_X), y: Math.round(anchorEntry.y) }
-        : { x: Math.round(anchorEntry.x), y: Math.round(anchorEntry.y + aSize.h + GAP_Y) };
-
-      const obstacles = Object.entries(board.objects || {})
-        .filter(([id, e]) => id !== subject && Number.isFinite(e?.x)
-          && layerOf(id, e, known) === anchorLayer)
-        .map(([id, e]) => ({ ...estimateSizeOn(board, id, e), x: e.x, y: e.y }));
-      const pos = nudgeDown(want, sSize, obstacles);
-
-      await patchBoard(projectId, {
-        objects: { [subject]: { ...(subjectEntry || {}), x: pos.x, y: pos.y, by: 'agent' } },
-      });
-      try {
-        ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: `摆了 ${subject}` });
-      } catch { /* fail-soft */ }
-      return {
-        content: [{
-          type: 'text',
-          text: `Placed ${subject} ${action} ${anchor} at (${pos.x},${pos.y})`
-            + (pos.y !== want.y ? ' (nudged down to avoid overlap)' : '') + '.',
-        }],
-      };
-    },
-  );
-}

package/server/engine/mcp/tools/create-on-board.js

@@ -1,152 +0,0 @@
-/**
- * mcp/tools/create-on-board.js —— create_on_board（2026-08-14，agent 建元素批）
- *
- * 让 agent 落**用户级的画布原生物件**。v1 只开手写字（text）：便签是留档不是
- * 聊天，agent 值得写下来的是"这一版为什么这么改"这类一句话，不是回复的搬运。
- * 涂鸦不开 —— agent 画矢量笔迹没有意义，它要画图走生图。
- *
- * 设计对齐用户侧：
- *   - near 锚定 = 用户"标注"的同构（落在锚右侧空白，关系线可选一步带上）——
- *     一次调用 = 一段字 + 一条线，跟 keepAnnotation 落的东西一模一样
- *   - 字体/字号走 board-store 同一份白名单（TEXT_FONTS）
- *   - 尺寸估算抄前端 handleCreateText 同款公式（约 26 全角字/行）
- *   - by:'agent' 出处，用户一眼分得出谁写的
- *
- * 护栏：每回合上限 08-23 按用户意思撤了（只记数）；画布不是弹幕区这条写在 prelude 里。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { readBoard, patchBoard, TEXT_FONTS } from '../../../projects/board-store.js';
-import { estimateSizeOn } from '../../../lib/board-kind-sizes.js';
-import { normalizeCanvasId, layerOf } from '../../../lib/canvas-id.js';
-
-const SIZE_PX = { sm: 13, md: 16, lg: 22, xl: 30 };
-
-let seq = 0;
-const nextTextId = () => `text:a${Date.now().toString(36)}${(seq++ % 1000).toString(36)}`;
-const nextBindingId = () => `b:a${Date.now().toString(36)}n${(seq++ % 1000).toString(36)}`;
-
-/** 前端 handleCreateText 同款身位估算（约 26 全角字/行，行高 1.6） */
-function textBox(t, sizeKey) {
-  const px = SIZE_PX[sizeKey] || 16;
-  const cols = Math.min(26, Math.max(6, t.length));
-  const lines = Math.ceil(t.length / cols) + (t.match(/\n/g)?.length || 0);
-  return { w: Math.round(cols * px * 1.05) + 12, h: Math.round(lines * px * 1.6) + 10 };
-}
-
-export function makeCreateOnBoardTool({ projectId, ctx }) {
-  const turnStamp = { turn: -1, count: 0 };
-  return tool(
-    'create_on_board',
-    `Write a handwritten note directly on the canvas — the same kind the user writes.
-
-Use it for remarks worth KEEPING on the board: why a version went this way, what
-to compare, a caption for a group. Not for conversation (that goes in your reply)
-and not for documents (write a .md instead).
-
-- near: anchor it beside a thing (and usually pass relation to draw the line —
-  that is exactly the user's "annotation" gesture: a note + an annotates edge)
-- omit near: the note lands under the desktop's current content`,
-    {
-      text: z.string().min(1).max(200).describe('The note text (≤200 chars, one thought)'),
-      near: z.string().max(300).optional()
-        .describe('Canvas id to place the note next to (right side, auto-avoids overlap)'),
-      relation: z.object({
-        type: z.enum(['annotates', 'link']).describe('annotates = the note is ABOUT it; link = loosely related'),
-        to: z.string().min(1).max(300).describe('Canvas id the line connects to (usually = near)'),
-        label: z.string().max(60).optional().describe('Optional words on the line (link only usually)'),
-      }).optional().describe('Draw a relation line from the note in the same call'),
-      font: z.enum(['pen', 'kai', 'sans', 'serif', 'mono']).optional()
-        .describe('Handwriting style (default pen — same as the user\'s default)'),
-      size: z.enum(['sm', 'md', 'lg', 'xl']).optional().describe('Text size (default md)'),
-    },
-    async ({ text, near: rawNear, relation, font, size }) => {
-      if (!projectId) {
-        return { content: [{ type: 'text', text: 'No project bound.' }], isError: true };
-      }
-      const err = (t) => ({ content: [{ type: 'text', text: t }], isError: true });
-
-      // 回合闸 08-23 用户拍板先不设：只记数不拦
-      const turn = ctx?.runId ?? -1;
-      if (turnStamp.turn !== turn) { turnStamp.turn = turn; turnStamp.count = 0; }
-
-      const t = String(text).trim();
-      if (!t) return err('空字不落板。');
-      const sizeKey = SIZE_PX[size] ? size : 'md';
-      const box = textBox(t, sizeKey);
-
-      const board = await readBoard(projectId);
-      const known = new Set(Object.keys(board.zones || {}));
-      let pos; let zone = '';
-      if (rawNear) {
-        const near = normalizeCanvasId(rawNear);
-        const anchorEntry = near ? board.objects?.[near] : null;
-        if (!anchorEntry || !Number.isFinite(anchorEntry.x)) {
-          return err(`锚点 ${rawNear} 还没有座位（read_board 里看不到就锚不上）。`);
-        }
-        zone = layerOf(near, anchorEntry, known);
-        const aSize = estimateSizeOn(board, near, anchorEntry);
-        pos = { x: Math.round(anchorEntry.x + aSize.w + 24), y: Math.round(anchorEntry.y) };
-        // 撞卡往下让（同 arrange 的避让）
-        const obstacles = Object.entries(board.objects || {})
-          .filter(([id, e]) => Number.isFinite(e?.x) && layerOf(id, e, known) === zone)
-          .map(([id, e]) => ({ ...estimateSizeOn(board, id, e), x: e.x, y: e.y }));
-        for (let g = 0; g < 40; g += 1) {
-          const blocker = obstacles.find(o =>
-            !(pos.x + box.w <= o.x || o.x + o.w <= pos.x || pos.y + box.h <= o.y || o.y + o.h <= pos.y));
-          if (!blocker) break;
-          pos.y = blocker.y + blocker.h + 16;
-        }
-      } else {
-        // 桌面根层内容最低边下面（跟新物件入座同一条起排线精神）
-        let bottom = 0;
-        for (const [id, e] of Object.entries(board.objects || {})) {
-          if (!Number.isFinite(e?.y) || layerOf(id, e, known) !== '') continue;
-          bottom = Math.max(bottom, e.y + estimateSizeOn(board, id, e).h);
-        }
-        for (const zz of Object.values(board.zones || {})) {
-          if (Number.isFinite(zz?.y)) bottom = Math.max(bottom, zz.y + 150);
-        }
-        pos = { x: 10, y: Math.round(bottom) + 16 };
-      }
-
-      const textId = nextTextId();
-      const patch = {
-        objects: {
-          [textId]: {
-            x: pos.x, y: pos.y, z: 1, w: box.w, h: box.h,
-            kind: 'text',
-            data: { t, font: TEXT_FONTS.includes(font) ? font : 'pen', size: sizeKey, color: 'ink' },
-            zone, by: 'agent',
-          },
-        },
-      };
-      if (relation) {
-        const to = normalizeCanvasId(relation.to);
-        if (to && to !== textId) {
-          patch.bindings = {
-            [nextBindingId()]: {
-              type: relation.type, from: textId, to, by: 'agent',
-              ...(relation.label ? { label: relation.label } : {}),
-            },
-          };
-        }
-      }
-
-      const saved = await patchBoard(projectId, patch);
-      if (!saved.objects?.[textId]) return err('便签被 board 拒了（内容或字段不合法）。');
-      turnStamp.count += 1;
-      try {
-        ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: '写了一条画布便签' });
-      } catch { /* fail-soft */ }
-      return {
-        content: [{
-          type: 'text',
-          text: `Note on board at (${pos.x},${pos.y})${relation ? ' with a line' : ''} (id: ${textId}).`
-            + '',
-        }],
-      };
-    },
-  );
-}

package/server/engine/mcp/tools/edit-sketch.js

@@ -1,167 +0,0 @@
-/**
- * mcp/tools/edit-sketch.js —— edit_sketch（2026-08-23 黑板二期）
- *
- * 改已有的图，不重画。原则抄用户自己的 AI-Annotation-demo 里那条「引用，不吐坐标」：
- * agent 只引用画布 id，位置用**相对关系**表达（在某件东西的右边/下面/上面/左边、
- * 或网格位移），像素由服务端解析 —— 让模型吐绝对坐标必幻觉。
- *
- * 一次调用一批操作（按序执行，一条坏了其余照做并在返回里报）：
- *   set_text   改字（文字节点：内容/格式/字号/颜色）
- *   move       挪一件：to {ref, side, gap?} 或 {dx, dy}（网格单位）
- *   move_group 挪一组（同 tag 的全部，保持相对位置）：to 同上
- *   remove     删一件画布原生物件（text/scribble）；产物卡不删（只能摘标签）
- *   add_node   加一个文字节点，位置 at {ref, side, gap?}，归进 tag
- *   add_edge / set_edge / remove_edge   线的增改删（线 id 见 read_board）
- * 改完前端按 board.updated 整份重拉；默认不进 staging（改的是已落定的图）。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { readBoard, patchBoard, TEXT_FONTS } from '../../../projects/board-store.js';
-import { estimateSizeOn } from '../../../lib/board-kind-sizes.js';
-import { layerOf, normalizeCanvasId } from '../../../lib/canvas-id.js';
-import { BINDING_TYPE_IDS, BINDING_MATERIALS } from '../../../lib/binding-types.js';
-import { UNIT, textBox } from '../../../lib/sketch-layout.js';
-
-const MAX_OPS = 40;
-let seq = 0;
-const stamp = () => `${Date.now().toString(36)}${(seq++ % 1000).toString(36)}`;
-
-const REL = z.object({
-  ref: z.string().min(1).max(300).describe('canvas id to place relative to'),
-  side: z.enum(['right', 'left', 'above', 'below']),
-  gap: z.number().min(0).max(40).optional().describe('grid units (default 1)'),
-});
-const DELTA = z.object({ dx: z.number().min(-200).max(200), dy: z.number().min(-200).max(200) }).describe('grid units');
-const TO = z.union([REL, DELTA]);
-
-const OP = z.discriminatedUnion('op', [
-  z.object({ op: z.literal('set_text'), id: z.string().min(1).max(300), text: z.string().min(1).max(4000).optional(), format: z.enum(['plain', 'md']).optional(), size: z.enum(['sm', 'md', 'lg', 'xl']).optional(), color: z.enum(['ink', 'red', 'pencil', 'brass']).optional(), font: z.enum(['pen', 'kai', 'sans', 'serif', 'mono']).optional() }),
-  z.object({ op: z.literal('move'), id: z.string().min(1).max(300), to: TO }),
-  z.object({ op: z.literal('move_group'), tag: z.string().min(1).max(40), to: TO }),
-  z.object({ op: z.literal('remove'), id: z.string().min(1).max(300) }),
-  z.object({ op: z.literal('add_node'), id: z.string().regex(/^[A-Za-z0-9_-]{1,24}$/).optional().describe('local handle to reference in later ops of this call'), text: z.string().min(1).max(4000), format: z.enum(['plain', 'md']).optional(), size: z.enum(['sm', 'md', 'lg', 'xl']).optional(), font: z.enum(['pen', 'kai', 'sans', 'serif', 'mono']).optional(), color: z.enum(['ink', 'red', 'pencil', 'brass']).optional(), at: REL, tag: z.string().max(40).optional() }),
-  z.object({ op: z.literal('add_edge'), from: z.string().min(1).max(300), to: z.string().min(1).max(300), type: z.enum(BINDING_TYPE_IDS).optional(), material: z.enum(BINDING_MATERIALS).optional(), label: z.string().max(60).optional(), tag: z.string().max(40).optional() }),
-  z.object({ op: z.literal('set_edge'), id: z.string().min(1).max(300), label: z.string().max(60).optional(), type: z.enum(BINDING_TYPE_IDS).optional(), material: z.enum(BINDING_MATERIALS).optional() }),
-  z.object({ op: z.literal('remove_edge'), id: z.string().min(1).max(300) }),
-]);
-
-export function makeEditSketchTool({ projectId, ctx }) {
-  return tool(
-    'edit_sketch',
-    `Edit what is already on the board — by id, without redrawing. Positions are RELATIVE
-(to {ref, side, gap} = beside/above/below another canvas id) or grid deltas ({dx,dy},
-1 cell = ${UNIT}px); you never give absolute coordinates. ids come from read_board
-(nodes: text:…/scribble:…, cards: deck:…/site:…/paths; lines: b:…).
-ops (run in order; a failing op is reported, the rest still apply):
- set_text{id,text?,format?,size?,color?,font?} · move{id,to} · move_group{tag,to} ·
- remove{id} · add_node{id?,text,at:{ref,side,gap?},…} · add_edge{from,to,type?,material?,label?} ·
- set_edge{id,label?,type?,material?} · remove_edge{id}
-Use this for "move A under B", "rephrase that note", "add a branch", "delete the
-wrong line". For a brand-new diagram use sketch_on_board.`,
-    {
-      tag: z.string().max(40).optional().describe('Default tag for add_node/add_edge (the sketch you are editing)'),
-      ops: z.array(OP).min(1).max(MAX_OPS),
-    },
-    async ({ tag: defaultTag, ops }) => {
-      const err = (t) => ({ content: [{ type: 'text', text: t }], isError: true });
-      if (!projectId) return err('No project bound.');
-      const board = await readBoard(projectId);
-      const known = new Set(Object.keys(board.zones || {}));
-      const objects = {}; const bindings = {};      // 增量 patch
-      const live = { ...board.objects };             // 本次调用内的"当前态"（让后一条 op 看见前一条的结果）
-      const local = new Map();                       // add_node 的本地句柄 → canvas id
-      const rid = (raw) => { if (local.has(raw)) return local.get(raw); const c = normalizeCanvasId(raw); return c && live[c] ? c : null; };
-      const rectOf = (id) => { const e = live[id]; return e ? { x: e.x, y: e.y, ...estimateSizeOn(board, id, e) } : null; };
-      const placeRel = (box, rel) => {
-        const r = rectOf(rid(rel.ref));
-        if (!r) return null;
-        const g = (rel.gap ?? 1) * UNIT;
-        if (rel.side === 'right') return { x: r.x + r.w + g, y: r.y };
-        if (rel.side === 'left') return { x: r.x - g - box.w, y: r.y };
-        if (rel.side === 'below') return { x: r.x, y: r.y + r.h + g };
-        return { x: r.x, y: r.y - g - box.h };
-      };
-      const report = []; let ok = 0;
-      const setObj = (id, e) => { live[id] = e; objects[id] = e; };
-
-      for (let i = 0; i < ops.length; i += 1) {
-        const o = ops[i];
-        const fail = (why) => report.push(`✗ #${i + 1} ${o.op}: ${why}`);
-        try {
-          if (o.op === 'set_text') {
-            const id = rid(o.id); const e = id && live[id];
-            if (!e || e.kind !== 'text') { fail(`${o.id} 不是文字节点`); continue; }
-            const data = { ...e.data };
-            if (o.text) data.t = o.text;
-            if (o.format) { if (o.format === 'md') data.format = 'md'; else delete data.format; }
-            if (o.size) data.size = o.size; if (o.color) data.color = o.color; if (o.font && TEXT_FONTS.includes(o.font)) data.font = o.font;
-            const box = textBox(data.t, data.size || 'md', { md: data.format === 'md' });
-            setObj(id, { ...e, data, w: box.w, h: box.h }); ok += 1;
-          } else if (o.op === 'move') {
-            const id = rid(o.id); const e = id && live[id];
-            if (!e) { fail(`${o.id} 不在板上`); continue; }
-            const box = rectOf(id);
-            const p = 'ref' in o.to ? placeRel(box, o.to) : { x: e.x + o.to.dx * UNIT, y: e.y + o.to.dy * UNIT };
-            if (!p) { fail(`参照 ${o.to.ref} 不在板上`); continue; }
-            setObj(id, { ...e, x: Math.round(p.x), y: Math.round(p.y) }); ok += 1;
-          } else if (o.op === 'move_group') {
-            const members = Object.entries(live).filter(([, e]) => e.tag === o.tag && Number.isFinite(e?.x));
-            if (!members.length) { fail(`没有 #${o.tag} 的东西`); continue; }
-            const bb = { x: Math.min(...members.map(([, e]) => e.x)), y: Math.min(...members.map(([, e]) => e.y)) };
-            const rects = members.map(([id]) => rectOf(id));
-            const w = Math.max(...rects.map(r => r.x + r.w)) - bb.x; const h = Math.max(...rects.map(r => r.y + r.h)) - bb.y;
-            const p = 'ref' in o.to ? placeRel({ w, h }, o.to) : { x: bb.x + o.to.dx * UNIT, y: bb.y + o.to.dy * UNIT };
-            if (!p) { fail(`参照 ${o.to.ref} 不在板上`); continue; }
-            const dx = Math.round(p.x - bb.x); const dy = Math.round(p.y - bb.y);
-            for (const [id, e] of members) setObj(id, { ...e, x: e.x + dx, y: e.y + dy });
-            ok += 1;
-          } else if (o.op === 'remove') {
-            const id = rid(o.id); const e = id && live[id];
-            if (!e) { fail(`${o.id} 不在板上`); continue; }
-            if (!e.kind) { fail(`${id} 是产物卡，不能从黑板删；要摘标签用 finish_sketch erase`); continue; }
-            delete live[id]; objects[id] = null; ok += 1;
-          } else if (o.op === 'add_node') {
-            const size = (o.size === 'sm' && o.text.length > 40) ? 'md' : (o.size || 'md');
-            const box = textBox(o.text, size, { md: o.format === 'md' });
-            const p = placeRel(box, o.at);
-            if (!p) { fail(`参照 ${o.at.ref} 不在板上`); continue; }
-            const refId = rid(o.at.ref);
-            const zone = layerOf(refId, live[refId], known);
-            const id = `text:a${stamp()}`;
-            const tag = o.tag || defaultTag || live[refId]?.tag || null;
-            setObj(id, {
-              x: Math.round(p.x), y: Math.round(p.y), z: 1, w: box.w, h: box.h, kind: 'text',
-              data: { t: o.text, ...(o.format === 'md' ? { format: 'md' } : {}), font: TEXT_FONTS.includes(o.font) ? o.font : 'pen', size, color: o.color || 'ink' },
-              zone, by: 'agent', ...(tag ? { tag } : {}),
-            });
-            if (o.id) local.set(o.id, id);
-            report.push(`+ node ${o.id ? `${o.id}=` : ''}${id}`); ok += 1;
-          } else if (o.op === 'add_edge') {
-            const from = rid(o.from); const to = rid(o.to);
-            if (!from || !to || from === to) { fail(`端点不在板上：${o.from} → ${o.to}`); continue; }
-            const id = `b:a${stamp()}`;
-            const tag = o.tag || defaultTag || live[from]?.tag || live[to]?.tag || null;
-            bindings[id] = { type: o.type || 'link', from, to, by: 'agent', ...(o.material && o.material !== 'ink' ? { material: o.material } : {}), ...(o.label ? { label: o.label } : {}), ...(tag ? { tag } : {}) };
-            report.push(`+ edge ${id}`); ok += 1;
-          } else if (o.op === 'set_edge') {
-            const b = board.bindings?.[o.id];
-            if (!b) { fail(`线 ${o.id} 不存在`); continue; }
-            const nb = { ...b };
-            if (o.label !== undefined) { if (o.label) nb.label = o.label; else delete nb.label; }
-            if (o.type) nb.type = o.type;
-            if (o.material) { if (o.material === 'ink') delete nb.material; else nb.material = o.material; }
-            bindings[o.id] = nb; ok += 1;
-          } else if (o.op === 'remove_edge') {
-            if (!board.bindings?.[o.id]) { fail(`线 ${o.id} 不存在`); continue; }
-            bindings[o.id] = null; ok += 1;
-          }
-        } catch (e) { fail(String(e?.message || e).slice(0, 120)); }
-      }
-      if (!ok) return err(`没有一条操作成功：\n${report.join('\n')}`);
-      await patchBoard(projectId, { objects, bindings });
-      try { ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: `改了黑板（${ok} 处）` }); } catch { /* */ }
-      return { content: [{ type: 'text', text: `Applied ${ok}/${ops.length} op(s).${report.length ? `\n${report.join('\n')}` : ''}` }] };
-    },
-  );
-}

package/server/engine/mcp/tools/record-decision.js

@@ -1,140 +0,0 @@
-/**
- * mcp/tools/record-decision.js — record_decision MCP tool
- *
- * agent 在做关键设计决策时调，把"做了什么 + 为什么"写成共享便利贴
- * `notes/决策.md` 的一面（`---` 分面）。2026-07-30 起决策
- * 不再进 spec.json.decisions[]：便利贴是 agent 和用户的**共享层**——
- * 用户在画布上直接看到、能翻、能改；spec.json 只是 agent 自己的暗档案，
- * 用户看不见，头脑风暴根本进不来。旧会话已有的 spec.json decisions[]
- * 仍被 hooks 注入（只读遗产），新决策一律走这里。
- *
- * 便利贴格式约定（前端 NoteSticker 按此渲染）：
- *   - 一个 .md = 一张贴；`\n---\n` 分面，翻页看
- *   - 每面第一行 `# 标题`
- *
- * 落点：工作区 `notes/`（扁平模型，2026-08-08 起）—— 没有"任务归属"了，
- * 便利贴直接住项目桌面。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { Events } from '../../agent/events.js';
-
-const NOTE_FILE = '决策.md';
-
-/**
- * @param {object} deps
- * @param {string} deps.workspaceRoot
- * @param {string} [deps.sessionId]
- * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
- */
-export function makeRecordDecisionTool({ workspaceRoot, sessionId, ctx }) {
-  return tool(
-    'record_decision',
-    `Record a key design decision as a face of the project's decision sticky note
-(notes/决策.md). The note is SHARED with the user — it renders as
-a flippable sticky on their canvas, they can read and edit it. Use this to
-capture WHY you made a particular choice — color, type scale, layout metaphor,
-copy strategy — so the intent survives across sessions and the user can push
-back on it.
-
-Use this tool when:
-- You make a non-trivial choice that has multiple defensible alternatives
-  (e.g., picking a primary color, deciding deck length, choosing a layout)
-- The user gives feedback that changes a previous decision (record both)
-- You want to document a constraint discovered mid-work
-
-Do NOT use this tool for:
-- Trivial implementation details (CSS class names, file structure)
-- Things obvious from the canvas itself (the visible design speaks for itself)
-- Every change — over-recording bloats the note and dilutes signal
-
-For free-form shared notes (brainstorm material, reference digests, handoff
-context), just Write notes/<slug>.md directly — same sticky-note
-rendering, no tool needed.`,
-    {
-      title: z
-        .string()
-        .min(2)
-        .max(200)
-        .describe('Short decision title (e.g., "Primary color = #3366FF")'),
-      rationale: z
-        .string()
-        .min(2)
-        .max(2000)
-        .describe('Why this choice — connect to brief / user feedback / design principle'),
-      scope: z
-        .string()
-        .optional()
-        .describe('Where it applies (e.g., "Global", "Cover page", "All H1 headings")'),
-      alternatives: z
-        .array(z.string())
-        .optional()
-        .describe('Alternatives considered, briefly noting why rejected'),
-    },
-    async ({ title, rationale, scope, alternatives }) => {
-      try {
-        if (!workspaceRoot) {
-          return {
-            content: [{ type: 'text', text: 'No workspace bound; cannot record decision.' }],
-            isError: true,
-          };
-        }
-        const alts = Array.isArray(alternatives)
-          ? alternatives.map(s => String(s).trim()).filter(Boolean) : [];
-        const face = [
-          `# ${title.trim()}`,
-          '',
-          rationale.trim(),
-          ...(scope ? ['', `- 范围：${scope.trim()}`] : []),
-          ...(alts.length ? [`- 备选：${alts.join(' / ')}`] : []),
-          `- ${new Date().toISOString().slice(0, 10)}`,
-        ].join('\n');
-
-        const notesDir = path.join(workspaceRoot, 'notes');
-        await fs.mkdir(notesDir, { recursive: true });
-        const noteFile = path.join(notesDir, NOTE_FILE);
-        let prev = '';
-        try { prev = await fs.readFile(noteFile, 'utf8'); } catch { /* 首条 */ }
-        const next = prev.trim() ? `${prev.replace(/\s+$/, '')}\n\n---\n\n${face}\n` : `${face}\n`;
-        await fs.writeFile(noteFile, next, 'utf8');
-
-        const faceCount = next.split(/\n---\n/).length;
-        try {
-          // MCP 工具写盘不走 PostToolUse(Write/Edit) 那条 file_changed 直发，
-          // 自己补一发，前端便利贴才会当场刷新
-          // 工作区相对路径（fileChanged 正字法；曾发绝对路径=前端只吃到清单重拉，
-          // 寻址和版本 key 全失配。2026-08-14 普查改）
-          ctx?.emit?.(Events.fileChanged(`notes/${NOTE_FILE}`, 'change'));
-          ctx?.emit?.({
-            type: 'run.decision_recorded',
-            title: title.trim(),
-            scope: scope?.trim() || null,
-            decisionsCount: faceCount,
-          });
-        } catch { /* emit fail-safe */ }
-
-        return {
-          content: [{
-            type: 'text',
-            // ⚠️ 这里曾写 `tasks/${task}/...` —— 扁平化删掉 task 变量时漏了这行，
-            // `task` 成悬空引用：决策照写、事件照发，**返回时 ReferenceError 被
-            // 外层 catch 接住**，agent 每次调用都收到报错以为失败（还可能重试出
-            // 重复面）。悬空引用潜伏族第二案（第一案 reloadToken，2026-08-08）。
-            text: `Decision recorded as face ${faceCount} of notes/${NOTE_FILE}: "${title.trim()}"`,
-          }],
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: 'text',
-            text: `Record decision failed: ${err?.message || String(err)}`,
-          }],
-          isError: true,
-        };
-      }
-    },
-  );
-}