@xiaobuyu/nodesign 0.0.6 → 0.0.8

package/server/engine/mcp/tools/write-on-board-role-anchor.js

@@ -0,0 +1,48 @@
+/**
+ * mcp/tools/write-on-board-role-anchor.js —— 角色板书的缺省锚（2026-08-28；08-29 泛化成「这一拍」）
+ *
+ * 角色不带任何落位线索（reply_to/near/at/open_lane）时，机器替它选锚。两级：
+ *
+ * 1. **属于它的那条线**（预制摆位，用户拍板）：主持人用 open_lane 以角色名（slug 或
+ *    展示名）开过线 → 自动接在自己那条线上（reply_to 线内最新一条 + 着线的 tag）。
+ *    摆位和延伸方向是主持人预制的，角色的工作退化成「补一段话」。
+ * 2. **这一拍**（08-29）：角色没有专属线时，它这一段就是在回应**主持人最新写的那一条**
+ *    —— reply_to 它，再经侧挂直觉落到它身侧。「章节竖着走、同一拍的几个人横着排」
+ *    是从「在回应谁」这个语义里自己长出来的，不硬编版式。
+ *
+ *    08-28 时这一级只在 rounds 模式下开；模式概念 08-29 整个退役（谁接这一拍由主持人
+ *    每拍决定，不再是一个服务端状态），所以这一级对所有角色一律成立。
+ *
+ * 角色明确给了落位（比如回用户那条）时它的手优先，这里不抢。
+ */
+import { CHALK_DIR } from '../../../lib/chalk.js';
+import { listRoleNames } from '../../agent/role-card.js';
+
+/**
+ * @returns {Promise<{replyTo: string|null, tag: string|null}>}
+ *   replyTo 非空 = 用它当缺省锚；tag 非空 = 这条板书顺带着线的 tag（仅专属线路径给）。
+ */
+export async function roleDefaultAnchor({ board, by, sharedRoot }) {
+  // 属于它的那条线优先
+  if (board.lanes) {
+    let laneTag = board.lanes[by] ? by : null;
+    if (!laneTag) {
+      try {
+        const nm = (await listRoleNames(sharedRoot)).get(by);
+        if (nm && board.lanes[nm]) laneTag = nm;
+      } catch { /* 展示名查不到就只认 slug 线 */ }
+    }
+    if (laneTag) {
+      const inLane = Object.entries(board.objects)
+        .filter(([id, e]) => id.startsWith(`${CHALK_DIR}/`) && Number.isFinite(e?.x) && e.tag === laneTag)
+        .map(([id]) => id).sort();
+      if (inLane.length) return { replyTo: inLane[inLane.length - 1], tag: laneTag };
+    }
+  }
+  // 这一拍 = 主持人最新写的那一条
+  const beats = Object.entries(board.objects)
+    .filter(([id, e]) => id.startsWith(`${CHALK_DIR}/`) && Number.isFinite(e?.x) && (e.by || 'agent') === 'agent')
+    .map(([id]) => id).sort();   // 板书文件名以时间戳开头，路径序即时间序
+  if (beats.length) return { replyTo: beats[beats.length - 1], tag: null };
+  return { replyTo: null, tag: null };
+}

package/server/engine/mcp/tools/write-on-board-schema.js

@@ -0,0 +1,125 @@
+/**
+ * write_on_board 的图形入参 schema（2026-08-28 从 write-on-board.js 拆出 —— 行数棘轮；
+ * 纯数据，跟落板逻辑零耦合）。上限是失控兜底不是风格闸：zod 硬拒（-32602 整调用作废）
+ * 是最贵的失败模式，可读性走返回值里的软提醒（08-25 用户拍板「移除画板上限」）。
+ */
+
+import { z } from 'zod';
+import { BINDING_TYPE_IDS, BINDING_MATERIALS } from '../../../lib/binding-types.js';
+import { TAG_RE } from '../../../projects/board-sanitize.js';
+import { CHALK_DIR } from '../../../lib/chalk.js';
+import { STENCIL_NAMES } from '../../../lib/sketch-stencils.js';
+
+const MAX_NODES = 200;
+const MAX_SHAPES = 120;
+const MAX_EDGES = 400;
+
+const LOCAL_ID = z.string().regex(/^[A-Za-z0-9_-]{1,48}$/, 'local id: letters/digits/_/-');
+const GRID_PT = z.object({ x: z.number().min(-2000).max(2000), y: z.number().min(-2000).max(2000) });
+export const WORLD_PT = z.object({ x: z.number().min(-1e6).max(1e6), y: z.number().min(-1e6).max(1e6) });
+/**
+ * 纸内坐标（2026-08-29 纸范式）：以当前纸版心左上角为原点的像素。越界**钳住不拒收**
+ * （schema 整单拒是最贵的失败模式；钳过在返回里如实报）。preprocess 在给模型看的
+ * JSON schema 里隐形 —— 文档照旧严格，垫片只当安全网。
+ */
+const clampN = (lo, hi) => (v) => (typeof v === 'number' && Number.isFinite(v) ? Math.max(lo, Math.min(hi, v)) : v);
+export const SHEET_PT = z.object({
+  x: z.preprocess(clampN(0, 12000), z.number().min(0).max(12000)),
+  y: z.preprocess(clampN(0, 12000), z.number().min(0).max(12000)),
+});
+
+export const NODES = z.array(z.object({
+  id: LOCAL_ID.describe('Local id to reference from edges/shapes'),
+  text: z.string().min(1).max(8000),
+  format: z.enum(['plain', 'md']).optional().describe('Default: md when the text carries markdown marks, else plain'),
+  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: GRID_PT.optional().describe('Grid position (layout free); top-left of the node'),
+  w: z.number().min(3).max(120).optional().describe('Width in grid units (prefer ≤22 = 528px: paragraphs read better growing down than wide)'),
+})).max(MAX_NODES);
+
+export const SHAPES = z.array(z.object({
+  id: LOCAL_ID.optional(),
+  kind: z.enum(['rect', 'ellipse', 'circle', 'line', 'arrow', 'underline', 'path', 'stencil']),
+  at: GRID_PT.optional(),
+  name: z.enum(STENCIL_NAMES).optional()
+    .describe('stencil kind: which pictogram — a hand-tuned little drawing placed at at, scaled to w (h optional, defaults to its natural aspect). Use these instead of drawing common things stroke by stroke'),
+  flip: z.boolean().optional().describe('stencil: mirror horizontally (facing the other way)'),
+  around: LOCAL_ID.optional().describe('rect/ellipse/circle/underline: wrap this node instead of at/w/h'),
+  w: z.number().min(0).max(200).optional(),
+  h: z.number().min(0).max(200).optional(),
+  to: GRID_PT.optional(),
+  toNode: LOCAL_ID.optional(),
+  d: z.string().max(8000).optional().describe('path kind: SVG path, UPPERCASE absolute M/L/Q/C/Z only. Coordinates are in the SAME GRID UNITS as at/w/h (1 unit = 24px; decimals fine) — one coordinate space for the whole sketch. Hand-drawn wobble is applied for you; Q/C curves are how you draw anything smooth (a crescent moon, a wave, a sail)'),
+  color: z.enum(['ink', 'red', 'pencil', 'brass']).optional(),
+  width: z.number().min(1).max(12).optional(),
+  fill: z.enum(['hatch']).optional()
+    .describe('Shade the inside with hand-drawn 45° hatching — the line-art way to darken an area (a shadow side, water, a filled banner). Closed shapes only (rect/ellipse/circle, a path whose subpaths end with Z, closable stencils)'),
+  // ── 算子（一次挂一个；等距/对称/播撒这类算术归机器，每份笔迹各自抖）──
+  repeat: z.object({ n: z.number().int().min(2).max(24), dx: z.number().min(-200).max(200).optional(), dy: z.number().min(-200).max(200).optional() }).optional()
+    .describe('LINEAR ARRAY: n copies stepped by (dx,dy) grid units — a fence, windows, steps. Copies are re-inked, not stamped'),
+  ring: z.object({ n: z.number().int().min(2).max(24), cx: z.number().min(-2000).max(2000), cy: z.number().min(-2000).max(2000), upright: z.boolean().optional() }).optional()
+    .describe('CIRCULAR ARRAY: n copies around grid point (cx,cy). Draw ONE at its 12-o-clock spot. Default ROTATES each copy (petals, clock marks, top-down chairs facing a table); upright:true keeps them unrotated and just seats them round the circle (side-view things with gravity — tents or people round a fire)'),
+  mirror: z.object({ axis: z.enum(['x', 'y']), at: z.number().min(-2000).max(2000) }).optional()
+    .describe("SYMMETRY: adds a mirrored copy across the axis at grid position `at` (axis:'x' = vertical mirror line). Draw half a butterfly, get the whole one"),
+  scatter: z.object({ n: z.number().int().min(2).max(40), in: z.object({ x: z.number(), y: z.number(), w: z.number().min(1), h: z.number().min(1) }) }).optional()
+    .describe('SPRINKLE: n copies at seeded-random spots inside the grid rect, with slight size jitter — a starry sky, grass, pebbles. Same call replays identically'),
+})).max(MAX_SHAPES);
+
+export const EDGES = z.array(z.object({
+  from: z.string().min(1).max(300).describe('local node id or canvas id'),
+  to: z.string().min(1).max(300).describe('local node id or canvas id'),
+  type: z.enum(BINDING_TYPE_IDS).optional().describe('default link'),
+  material: z.enum(BINDING_MATERIALS).optional().describe('default pencil'),
+  label: z.string().max(60).optional(),
+})).max(MAX_EDGES);
+
+/**
+ * ⚠️ 字段顺序有意义（2026-08-29 占位契约刀 C）：模型是按 schema 声明顺序生成
+ * JSON 的，而入参是**流式**到达前端的 —— 位置字段排在 text 前面，画布才能在
+ * 第一个字到达时就把框立在真位置上，让正文流进去（排在后面的话，字已经流完了
+ * 位置才到，只能先画在一块空地上再跳过去 —— 那正是这一刀要治的）。
+ * 抽取规则在 agent-shared.js 的 TOOL_INPUT_STREAM_FIELDS.spot。
+ */
+export const WRITE_SCHEMA = {
+  slot: z.string().regex(TAG_RE).optional()
+    .describe('Drop this into a PLANNED BLOCK of the current sheet (names come from open_sheet{plan}). The block decides the width and where it lands; notes stack downward inside it. If it does not fit, the write is REFUSED with how much room is left — split the content or re-plan. Prefer this over at: plan the page first, then fill it.'),
+  at: SHEET_PT.optional()
+    .describe("Where on the CURRENT SHEET, in pixels from its top-left writable corner (x→right, y→down). Clamped into the sheet — the return says if it was. Omit it to flow top-to-bottom"),
+  sheet: z.string().regex(TAG_RE).optional()
+    .describe('Write on this sheet instead of the current one (names from open_sheet / read_board)'),
+  width: z.number().min(8).max(60).optional().describe('Single note width in grid units (24px). Default: the width the user last dragged chalk blocks to, else by content. Omit it unless this one block needs a different measure - the default already follows the user.'),
+  near: z.string().max(300).optional()
+    .describe('Canvas id or #tag this is ABOUT — draws an annotates line to it. Placement itself is by sheet (at / flow), not by near'),
+  side: z.enum(['right', 'left', 'above', 'below']).optional()
+    .describe('ONLY with near, when the SEMANTICS demand a side (e.g. a caption must sit above): exact placement beside the anchor. Normally omit — sheets flow downward'),
+  reply_to: z.string().max(300).optional().describe(`Thread: path of a board note (${CHALK_DIR}/…md) to answer under (lands right below it; a full sheet turns the page)`),
+  text: z.string().min(1).max(8000).optional()
+    .describe('The one-note shorthand: a short Markdown note (= a 1-piece board write). Give text OR nodes/shapes, not both'),
+  flow: z.boolean().optional()
+    .describe('Lazy FALLBACK for a ready-made long text: the machine splits it at paragraph breaks into a chain of card-sized notes, packs them as far as they fit, and returns the rest untouched (never squeezed, dropped, or auto-paged). PREFER carving slots yourself (open_sheet{plan}/replan, omit at to stack) and filling them one note each — you keep control of where each part breaks.'),
+  h: z.number().min(24).max(2000).optional()
+    .describe('Reserve this HEIGHT in pixels for the note box, placed before the text settles (plan the box, then fill it). Shorter content keeps the box; longer content overrides it. Ignored with flow.'),
+  relation: z.enum(BINDING_TYPE_IDS).optional()
+    .describe('Line type for the near line of a single note (default annotates; flow reads anchor→note)'),
+  chain: z.boolean().optional()
+    .describe('Single note: auto reply_to the latest board note of the same tag WRITTEN BY YOU (threads never cross authors — continuation rights)'),
+  open_lane: z.string().max(300).optional()
+    .describe("Open a NEW thread line named by tag: lays a fresh sheet for it and lands this note at its head. Value: a canvas id/#tag to BRANCH from (draws a flow line from it), or 'fresh' for a brand-new topic. Requires tag; continue with {tag, chain:true}."),
+  tag: z.string().regex(TAG_RE).optional()
+    .describe('Group tag. A 1-piece write stays untagged unless you pass one; ≥2 pieces auto-tag sk-<stamp>'),
+  ink: z.enum(['chalk', 'hand']).optional()
+    .describe("Single note body: 'chalk' (default) = a real file under notes/板书 (Read/Edit later; chain/reply threads live on these); 'hand' = canvas-native handwritten text — a light remark like the user's own handwriting, no file, no threading"),
+  font: z.enum(['pen', 'kai', 'sans', 'serif', 'mono']).optional().describe("Single note font (ink:'hand'; default kai)"),
+  color: z.enum(['ink', 'red', 'pencil', 'brass']).optional().describe("Single note color (ink:'hand')"),
+  size: z.enum(['sm', 'md', 'lg', 'xl']).optional().describe("Single note text size. Real for ink:'hand'; for chalk notes it only sizes the placement box (chalk renders at a fixed size)"),
+  title: z.string().max(60).optional().describe('Sketch: optional heading written at the top'),
+  layout: z.enum(['auto', 'free', 'column', 'row', 'grid', 'mindmap', 'flow']).optional()
+    .describe('Sketch layout. auto FOLLOWS YOUR EDGES: with edges it lays out in flow layers (roots on top, children below — give edges and placement is structure); mindmap picks the hub by degree. free needs at on EVERY node'),
+  cols: z.number().int().min(1).max(8).optional().describe('grid columns'),
+  staging: z.boolean().optional().describe('Sketch only: default true (translucent until commit/turn end). Ignored for single notes — they always land solid'),
+  nodes: NODES.optional(),
+  shapes: SHAPES.optional(),
+  edges: EDGES.optional(),
+};