@xiaobuyu/nodesign 0.0.7 → 0.0.8

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/relate-on-board.js

@@ -1,150 +0,0 @@
-/**
- * mcp/tools/relate-on-board.js — relate_on_board MCP tool（2026-08-07）
- *
- * 让 agent 在画布上**画出产物之间的关系**。
- *
- * ## 为什么这个工具重要
- *
- * 北极星是「任务文件夹能排出登录墙那种版面」。手摆之所以好看，是因为每张纸的
- * 位置在回答「它和旁边那张什么关系」—— 而系统此前只知道每个产物的尺寸和
- * mtime。**关系数据不到位，再好的布局算法也只能排出「错落有致的网格」。**
- *
- * 关键洞察是：**关系不需要推断，agent 手里本来就有**。它知道 proto-暖调 和
- * proto-冷调 是同一拍的两个试作、知道哪张图是哪次批注的结果、知道这版改自那版。
- * 这些信息现在全在会话里，一落到画布就只剩文件名。这个工具就是那条落差。
- *
- * 线不存坐标：端点是物件 id 或工作区 id，端点一移动线自己跟着走。
- */
-
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { patchBoard, readBoard } from '../../../projects/board-store.js';
-import { BINDING_TYPES, BINDING_TYPE_IDS, BINDING_MATERIALS } from '../../../lib/binding-types.js';
-import { normalizeCanvasId } from '../../../lib/canvas-id.js';
-
-/**
- * 端点校验（08-23 案：不是 canvas id 的字符串照收，board.json 留悬空线）。
- * 合法端点 = 板上有座位的 id，或者真实存在的工作区路径（带不带 kind 前缀都行）。
- * write_on_board 的锚点早就这么查了，同一件事两个工具一个查一个不查是口径病。
- */
-async function endpointExists(id, board, sharedRoot) {
-  if (board.objects?.[id]) return true;
-  if (/^doc:/.test(id)) return true;                       // 项目文档：固定名额
-  const bare = id.replace(/^(deck|site|docx|text|scribble):/, '');
-  if (!bare || bare.includes('..')) return false;
-  try { await fs.access(path.join(sharedRoot, bare)); return true; } catch { return false; }
-}
-
-/** 词汇表渲染成工具描述里的一段表，免得两处各写各的 */
-const VOCAB = BINDING_TYPE_IDS
-  .map(id => `- ${id} (${BINDING_TYPES[id].label})${BINDING_TYPES[id].directed ? '' : ' — undirected'}`)
-  .join('\n');
-
-let seq = 0;
-const nextId = () => `b:a${Date.now().toString(36)}${(seq++ % 1000).toString(36)}`;
-
-export function makeRelateOnBoardTool({ sharedRoot, projectId, ctx }) {
-  return tool(
-    'relate_on_board',
-    `Draw a relationship line between two things on the workbench canvas.
-
-The canvas knows *what* each artifact is, but not *how they relate*. You are
-the only one who knows that — you made them. Recording it lets the user see
-lineage at a glance, and lets layout put related things near each other.
-
-Relationship types:
-${VOCAB}
-
-Endpoints are canvas ids — a kind prefix plus the workspace-relative path,
-exactly as the file sits on disk:
-- a file: 'assets/generated/x.webp', 'notes/灵感.md'
-- a deck: 'deck:海报/proto-暖调.html'
-- a site: 'site:伊蕾娜手账研究站'
-- a folder: just its path, '海报' or '海报/初稿'
-
-Use it right after you produce something that relates to earlier work:
-- made v2 of a poster → derives-from, from the new one to the old one
-- produced two variants to compare → contrast between them
-- storyboard panels in order → flow, each to the next
-- used a reference image in a deck → ref, from the deck to the image
-
-Do NOT use it for "these are all in the same folder" — that is what the
-folder already says. Only record relationships that are not obvious from
-where the files live.`,
-    {
-      type: z.enum(BINDING_TYPE_IDS).describe('Relationship kind (see list above)'),
-      from: z.string().min(1).max(300).describe('Source canvas id — see forms above'),
-      to: z.string().min(1).max(300).describe('Target canvas id — see forms above'),
-      label: z.string().max(60).optional()
-        .describe('Optional short words on the line. Omit to use the default for the type.'),
-      material: z.enum(BINDING_MATERIALS).optional()
-        .describe('How the line is drawn (orthogonal to type): ink = quiet archive line (default); pencil = hand-drawn; yarn = detective red string with pins, for hypotheses/evidence while reasoning. The whole canvas is a detective board — use yarn when the relation is still being argued, ink when it is settled.'),
-    },
-    async ({ type, from, to, label, material }) => {
-      if (!projectId) {
-        return { content: [{ type: 'text', text: 'No project bound; cannot draw relationships.' }], isError: true };
-      }
-      if (from === to) {
-        return {
-          content: [{ type: 'text', text: 'from and to are the same thing — a relationship needs two ends.' }],
-          isError: true,
-        };
-      }
-      // 端点先归一再校验：不存在的端点会在 board.json 里留一条悬空线，
-      // 画布上凭空多出从无到有的线（08-23 录 GIF 时真踩）
-      const nFrom = normalizeCanvasId(from);
-      const nTo = normalizeCanvasId(to);
-      if (!nFrom || !nTo) {
-        return { content: [{ type: 'text', text: `Bad endpoint id: ${!nFrom ? from : to}` }], isError: true };
-      }
-      const board = await readBoard(projectId);
-      for (const [raw, nid] of [[from, nFrom], [to, nTo]]) {
-        if (!(await endpointExists(nid, board, sharedRoot))) {
-          const seats = Object.keys(board.objects || {}).slice(0, 20);
-          return {
-            content: [{
-              type: 'text',
-              text: `端点 ${raw} 不在板上，也不是存在的工作区路径 —— 线没画。`
-                + `（read_board 可看全部；现有座位举例：${seats.join(', ') || '无'}）`,
-            }],
-            isError: true,
-          };
-        }
-      }
-      from = nFrom; to = nTo;
-      const id = nextId();
-      // by:'agent' 不只是记录出处 —— 用户画的线 agent 不该擅自删，反过来也一样
-      const binding = { type, from, to, by: 'agent', ...(label ? { label } : {}), ...(material && material !== 'ink' ? { material } : {}) };
-      const patched = await patchBoard(projectId, { bindings: { [id]: binding } });
-
-      // 服务端会丢掉非法的线（未知 type / 自环）。**丢了要说**，否则 agent 以为
-      // 画上了，用户看不到，两边都不知道发生了什么。
-      if (!patched.bindings?.[id]) {
-        return {
-          content: [{ type: 'text', text: `Relationship rejected by the board (bad type or endpoints): ${type} ${from} -> ${to}` }],
-          isError: true,
-        };
-      }
-
-      // 广播：前端整份重拉。**sessionId 必须显式给 null** —— ctx 会把自己的
-      // sessionId 补进事件，那样只有当前会话的连接收得到，别的 tab 看不见。
-      try {
-        ctx?.emit?.({
-          type: 'board.updated',
-          sessionId: null,
-          summary: `已画一条「${BINDING_TYPES[type].label}」关系`,
-        });
-      } catch { /* emit fail-safe：广播失败不该让工具报错，线已经落盘了 */ }
-
-      const arrow = BINDING_TYPES[type].directed ? '->' : '<->';
-      return {
-        content: [{
-          type: 'text',
-          text: `Drew ${type} (${BINDING_TYPES[type].label}): ${from} ${arrow} ${to}`,
-        }],
-      };
-    },
-  );
-}