paintress 0.5.1 → 0.6.0

package/dist/server-vPylVJZf.js

@@ -1,854 +0,0 @@
-import { A as genId, C as update, E as saveDoc, M as DocumentSchema, N as PEN_DOC_VERSION, O as validateDoc, S as remove, T as loadDoc, b as move, g as batch, k as collectIds, qt as VERSION, t as renderDocument, v as get, x as query, y as insert } from "./render-CzpO1cOe.js";
-import { existsSync, mkdirSync, mkdtempSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
-import { z } from "zod";
-import { basename, dirname, join, relative, resolve, sep } from "node:path";
-import { randomUUID } from "node:crypto";
-import { chromium } from "playwright-core";
-import { connect } from "node:net";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { spawn } from "node:child_process";
-// src/doc/create.ts
-function createDoc(opts = {}) {
-	const boardId = opts.boardId ?? genId(/* @__PURE__ */ new Set());
-	const board = {
-		type: "frame",
-		id: boardId,
-		name: opts.name ?? "Board",
-		x: 0,
-		y: 0,
-		width: opts.width ?? 900,
-		height: opts.height ?? 600,
-		fill: opts.fill ?? "#FFFFFF"
-	};
-	const layout = opts.layout ?? "vertical";
-	if (layout !== "none") {
-		board["layout"] = layout;
-		board["gap"] = opts.gap ?? 0;
-		board["padding"] = opts.padding ?? 0;
-	}
-	return {
-		doc: DocumentSchema.parse({
-			version: PEN_DOC_VERSION,
-			fileToken: opts.fileToken ?? randomUUID(),
-			variables: {},
-			children: [board]
-		}),
-		boardId
-	};
-}
-// src/shot/screenshot.ts
-/**
-* 截图层：渲染 → 临时 HTML → headless Chromium → PNG（决策 3：两个消费者分开，AI 要 PNG）。
-* 浏览器探测：PTR_BROWSER 环境变量 → 系统 chrome → playwright 浏览器缓存。
-*/
-function findBrowser() {
-	const env = process.env["PTR_BROWSER"];
-	if (env && existsSync(env)) return env;
-	for (const c of [
-		"/usr/bin/google-chrome",
-		"/usr/bin/google-chrome-stable",
-		"/usr/bin/chromium",
-		"/usr/bin/chromium-browser"
-	]) if (existsSync(c)) return c;
-	const cacheDir = join(homedir(), ".cache", "ms-playwright");
-	if (existsSync(cacheDir)) {
-		const dirs = readdirSync(cacheDir).filter((d) => d.startsWith("chromium-")).sort((a, b) => b.localeCompare(a));
-		for (const d of dirs) for (const rel of [
-			"chrome-linux/chrome",
-			"chrome-linux64/chrome",
-			"chrome-headless-shell-linux64/chrome-headless-shell"
-		]) {
-			const p = join(cacheDir, d, rel);
-			if (existsSync(p)) return p;
-		}
-	}
-	return null;
-}
-function boardLabel(b) {
-	return b.name !== void 0 && b.name !== "" ? `${b.name}(id=${b.id})` : b.id;
-}
-/**
-* 画板选择子：id 精确 → name 精确 → name/id 模糊（不区分大小写）。
-* 模糊命中多个时报歧义并列出候选，不猜——猜错会让 AI 以为看到了另一页。
-*/
-function selectBoard(boards, query) {
-	if (boards.length === 0) throw new Error("设计稿没有画板（顶层节点为空），无法按画板截图");
-	const q = query.trim();
-	if (q === "") throw new Error("board 参数不能为空");
-	const byId = boards.filter((b) => b.id === q);
-	if (byId.length === 1) return byId[0];
-	const byName = boards.filter((b) => b.name === q);
-	if (byName.length === 1) return byName[0];
-	const lower = q.toLowerCase();
-	const fuzzy = boards.filter((b) => b.id.toLowerCase().includes(lower) || (b.name ?? "").toLowerCase().includes(lower));
-	if (fuzzy.length === 1) return fuzzy[0];
-	const all = boards.map(boardLabel).join("、");
-	if (fuzzy.length === 0) throw new Error(`没有匹配「${q}」的画板；可选：${all}`);
-	throw new Error(`「${q}」命中 ${fuzzy.length} 个画板，请写更精确的名字或 id：${fuzzy.map(boardLabel).join("、")}`);
-}
-/** 渲染并截图整张画布；指定 board 时只裁该画板（走同一套渲染与浏览器） */
-async function screenshotPen(penPath, outPng, opts = {}) {
-	const browserPath = findBrowser();
-	if (!browserPath) throw new Error("未找到可用浏览器：安装 Chromium/Chrome，或设置 PTR_BROWSER 指向可执行文件");
-	const loaded = loadDoc(penPath);
-	const rendered = renderDocument(loaded.doc);
-	const target = opts.board !== void 0 ? selectBoard(rendered.boards, opts.board) : void 0;
-	if (target !== void 0 && (target.w <= 0 || target.h <= 0)) throw new Error(`画板 ${boardLabel(target)} 尺寸为 0（${target.w}×${target.h}），无法截图`);
-	const viewport = {
-		width: Math.max(rendered.canvas.width, target !== void 0 ? Math.ceil(target.x + target.w) : 0),
-		height: Math.max(rendered.canvas.height, target !== void 0 ? Math.ceil(target.y + target.h) : 0)
-	};
-	const clip = target !== void 0 ? {
-		x: target.x,
-		y: target.y,
-		width: Math.ceil(target.w),
-		height: Math.ceil(target.h)
-	} : {
-		x: 0,
-		y: 0,
-		width: rendered.canvas.width,
-		height: rendered.canvas.height
-	};
-	const tmpDir = mkdtempSync(join(tmpdir(), "paintress-shot-"));
-	const htmlPath = join(tmpDir, "page.html");
-	writeFileSync(htmlPath, rendered.html, "utf8");
-	try {
-		const browser = await chromium.launch({
-			executablePath: browserPath,
-			args: ["--no-sandbox", "--disable-dev-shm-usage"]
-		});
-		try {
-			const page = await browser.newPage({
-				viewport,
-				deviceScaleFactor: opts.scale ?? 2
-			});
-			await page.goto(`file://${htmlPath}`);
-			await page.waitForTimeout(opts.settleMs ?? 120);
-			await page.screenshot({
-				path: outPng,
-				clip
-			});
-		} finally {
-			await browser.close();
-		}
-	} finally {
-		rmSync(tmpDir, {
-			recursive: true,
-			force: true
-		});
-	}
-	if (statSync(outPng).size === 0) throw new Error("截图产物为空文件");
-	const result = {
-		out: outPng,
-		canvas: rendered.canvas,
-		warnings: rendered.warnings,
-		browser: browserPath
-	};
-	if (target !== void 0) result.board = {
-		id: target.id,
-		...target.name !== void 0 ? { name: target.name } : {},
-		x: target.x,
-		y: target.y,
-		width: target.w,
-		height: target.h
-	};
-	return result;
-}
-// src/web/protocol.ts
-function encodeLine(msg) {
-	return `${JSON.stringify(msg)}\n`;
-}
-/** 逐行解析器：处理流式分片，容忍尾部不完整行 */
-var LineDecoder = class {
-	buf = "";
-	push(chunk) {
-		this.buf += chunk;
-		const out = [];
-		for (;;) {
-			const idx = this.buf.indexOf("\n");
-			if (idx < 0) break;
-			const line = this.buf.slice(0, idx);
-			this.buf = this.buf.slice(idx + 1);
-			if (line.trim() !== "") out.push(line);
-		}
-		return out;
-	}
-};
-// src/web/paths.ts
-/** 运行期文件位置：默认 ~/.paintress/；可用 PAINTRESS_HOME 覆盖（测试隔离用） */
-function runtimeDir() {
-	const dir = process.env["PAINTRESS_HOME"] ?? join(homedir(), ".paintress");
-	mkdirSync(dir, {
-		recursive: true,
-		mode: 448
-	});
-	return dir;
-}
-function socketPath() {
-	return join(runtimeDir(), "web.sock");
-}
-function lockPath() {
-	return join(runtimeDir(), "web.lock");
-}
-function pidPath() {
-	return join(runtimeDir(), "web.pid");
-}
-/** 项目名：URL 安全（字母数字点下划线连字符），冲突时加短 hash 后缀 */
-function sanitizeProjectName(name) {
-	const cleaned = name.replace(/[^A-Za-z0-9._-]/g, "-").replace(/^[.-]+/, "");
-	return cleaned === "" ? "project" : cleaned;
-}
-/**
-* 由目录推导默认项目名：`父目录/自身`（适配 repos/<org>/<project> 结构）。
-* 均为 URL 安全字符；保留两级可读性。
-*/
-function deriveProjectName(dir) {
-	const abs = resolve(dir);
-	const parent = basename(dirname(abs));
-	const self = basename(abs);
-	return sanitizeProjectName((parent && parent !== "/" ? `${parent}/${self}` : self).replace(/\//g, "-"));
-}
-/** 校验并解析注册目录：必须存在且是目录；返回真实路径（供穿越校验基准） */
-function resolveProjectDir(dir) {
-	const abs = resolve(dir);
-	if (!existsSync(abs)) throw new Error(`目录不存在：${abs}`);
-	if (!statSync(abs).isDirectory()) throw new Error(`不是目录：${abs}`);
-	return {
-		root: abs,
-		rootReal: realpathSync(abs)
-	};
-}
-/**
-* 路径穿越防护：把请求路径解析为真实绝对路径，并确认它仍在项目根内。
-* 失败返回 null（调用方回 404，不泄露真实路径）。
-*/
-function safeJoin(projectRootReal, requestPath) {
-	if (requestPath.includes("\0")) return null;
-	const normalized = requestPath.replace(/^\/+/, "");
-	const target = resolve(join(projectRootReal, normalized));
-	const relStr = relative(projectRootReal, target);
-	if (relStr === "" || relStr.startsWith("..") || relStr.includes(`..${sep}`)) return null;
-	if (!existsSync(target)) return null;
-	let real;
-	try {
-		real = realpathSync(target);
-	} catch {
-		return null;
-	}
-	const relReal = relative(projectRootReal, real);
-	if (relReal.startsWith("..") || relReal === "") return null;
-	return real;
-}
-// src/web/client.ts
-/** 控制面客户端：一次请求/响应，或保持长连接（attach 用） */
-function isDaemonRunning() {
-	return existsSync(socketPath());
-}
-function connectSocket() {
-	return new Promise((resolve, reject) => {
-		const sock = connect(socketPath());
-		const onError = (err) => {
-			sock.destroy();
-			reject(/* @__PURE__ */ new Error(`无法连接 paintress web（${socketPath()}）：${err.message}`));
-		};
-		sock.once("error", onError);
-		sock.once("connect", () => {
-			sock.off("error", onError);
-			sock.on("error", () => {});
-			resolve(sock);
-		});
-	});
-}
-/** 单次请求；超时默认 5s */
-async function sendRequest(req, timeoutMs = 5e3) {
-	const sock = await connectSocket();
-	return new Promise((resolve, reject) => {
-		const decoder = new LineDecoder();
-		const timer = setTimeout(() => {
-			sock.destroy();
-			reject(/* @__PURE__ */ new Error(`请求超时（${timeoutMs}ms）`));
-		}, timeoutMs);
-		sock.on("data", (chunk) => {
-			for (const line of decoder.push(chunk.toString("utf8"))) {
-				let parsed;
-				try {
-					parsed = JSON.parse(line);
-				} catch {
-					continue;
-				}
-				clearTimeout(timer);
-				sock.end();
-				resolve(parsed);
-				return;
-			}
-		});
-		sock.on("close", () => {
-			clearTimeout(timer);
-			reject(/* @__PURE__ */ new Error("daemon 在响应前关闭了连接"));
-		});
-		sock.on("error", (err) => {
-			clearTimeout(timer);
-			reject(err);
-		});
-		sock.write(encodeLine(req));
-	});
-}
-/**
-* 持久 attach：连接保持打开，进程退出时 OS 关闭连接 → daemon 立即感知。
-* 这取代了 PID 轮询（PID 会被内核复用，不可靠）。
-*/
-async function attachPersistent(project) {
-	const sock = await connectSocket();
-	const decoder = new LineDecoder();
-	let closed = false;
-	const closeCbs = [];
-	return new Promise((resolve, reject) => {
-		const timer = setTimeout(() => {
-			sock.destroy();
-			reject(/* @__PURE__ */ new Error("attach 超时"));
-		}, 5e3);
-		sock.on("data", (chunk) => {
-			for (const line of decoder.push(chunk.toString("utf8"))) {
-				let parsed;
-				try {
-					parsed = JSON.parse(line);
-				} catch {
-					continue;
-				}
-				if (parsed.ok && "attached" in parsed) {
-					clearTimeout(timer);
-					resolve({
-						close: () => {
-							if (closed) return;
-							closed = true;
-							sock.end();
-						},
-						onClose: (cb) => closeCbs.push(cb)
-					});
-				} else if (!parsed.ok) {
-					clearTimeout(timer);
-					sock.destroy();
-					reject(new Error(parsed.error));
-				}
-			}
-		});
-		sock.on("close", () => {
-			closed = true;
-			for (const cb of closeCbs) cb();
-		});
-		sock.on("error", (err) => {
-			clearTimeout(timer);
-			reject(err);
-		});
-		sock.write(encodeLine({
-			kind: "attach",
-			project
-		}));
-	});
-}
-// src/mcp/tools.ts
-function reqStr(args, key) {
-	const v = args[key];
-	if (typeof v !== "string" || v === "") throw new Error(`缺少必填参数：${key}`);
-	return v;
-}
-function optStr(args, key) {
-	const v = args[key];
-	return typeof v === "string" && v !== "" ? v : void 0;
-}
-function optNum(args, key) {
-	const v = args[key];
-	return typeof v === "number" && Number.isFinite(v) ? v : void 0;
-}
-function optBool(args, key) {
-	const v = args[key];
-	return typeof v === "boolean" ? v : void 0;
-}
-function objArg(args, key) {
-	const v = args[key];
-	if (!v || typeof v !== "object" || Array.isArray(v)) throw new Error(`参数 ${key} 必须是对象`);
-	return v;
-}
-/** 读：load 后执行，直接返回负载 */
-function read(path, fn) {
-	return fn(loadDoc(path));
-}
-/**
-* 把「本次写操作动到的节点 id」告知 daemon，供前端做变更高亮。
-* 先转绝对路径：daemon 的 cwd 未必与调用方一致，不能让 daemon 替我们 resolve 相对路径。
-* 非阻塞发送（写路径性能语义不变）；socket 默认有 ref，进程不会在响应前提前退出。
-*/
-function notifyChanges(path, ids) {
-	if (ids.length === 0 || !isDaemonRunning()) return;
-	sendRequest({
-		kind: "changes",
-		path: resolve(path),
-		ids
-	}, 2e3).catch(() => {});
-}
-/**
-* 写：load → 变更 → 校验（结构错误不落盘）→ 原子保存（保持原风味）。
-* fn 可通过 mark() 登记受影响的节点 id，写成功后统一通知 daemon。
-*/
-async function write(path, fn) {
-	const loaded = loadDoc(path);
-	const touched = [];
-	const mark = (ids) => {
-		touched.push(...ids);
-	};
-	const result = fn(loaded.doc, mark);
-	const v = validateDoc(loaded.doc);
-	if (!v.ok) throw new Error(`变更后结构校验失败，未落盘：\n${v.errors.map((e) => `  ${e.path}: ${e.message}`).join("\n")}`);
-	saveDoc(path, loaded.doc, {
-		expectedMtimeMs: loaded.mtimeMs,
-		flavor: loaded.flavor
-	});
-	notifyChanges(path, touched);
-	return {
-		ok: true,
-		result,
-		warnings: v.warnings
-	};
-}
-function countByType(children) {
-	const counts = {};
-	const walk = (nodes) => {
-		for (const n of nodes) {
-			if (!n || typeof n !== "object") continue;
-			const rec = n;
-			const t = typeof rec["type"] === "string" ? rec["type"] : "?";
-			counts[t] = (counts[t] ?? 0) + 1;
-			const kids = rec["children"];
-			if (Array.isArray(kids)) walk(kids);
-		}
-	};
-	walk(children);
-	return counts;
-}
-/**
-* 新建文档。path 不带扩展名时补 `.ptr`：新建一律默认标准格式，
-* `.pen` 只有在调用方显式写扩展名时才产出（兼容旧工具链）。
-*/
-function newDoc(args) {
-	const raw = reqStr(args, "path");
-	const path = /\.(pen|ptr)$/i.test(raw) ? raw : `${raw}.ptr`;
-	const flavor = path.toLowerCase().endsWith(".pen") ? "pen" : "ptr";
-	if (existsSync(path) && optBool(args, "overwrite") !== true) throw new Error(`文件已存在，未覆盖：${path}（确需覆盖传 overwrite=true）`);
-	const width = optNum(args, "width");
-	const height = optNum(args, "height");
-	if (width !== void 0 && width <= 0) throw new Error(`width 必须大于 0，收到：${width}`);
-	if (height !== void 0 && height <= 0) throw new Error(`height 必须大于 0，收到：${height}`);
-	const layoutArg = optStr(args, "layout");
-	if (layoutArg !== void 0 && ![
-		"vertical",
-		"horizontal",
-		"none"
-	].includes(layoutArg)) throw new Error(`layout 仅支持 vertical / horizontal / none，收到：${layoutArg}`);
-	const { doc, boardId } = createDoc({
-		name: optStr(args, "name"),
-		width,
-		height,
-		fill: optStr(args, "fill"),
-		layout: layoutArg === "vertical" || layoutArg === "horizontal" || layoutArg === "none" ? layoutArg : void 0,
-		padding: optNum(args, "padding"),
-		gap: optNum(args, "gap")
-	});
-	const check = validateDoc(doc);
-	if (!check.ok) throw new Error(`新建文档结构校验失败，未落盘：\n${check.errors.map((e) => `  ${e.path}: ${e.message}`).join("\n")}`);
-	mkdirSync(dirname(path), { recursive: true });
-	saveDoc(path, doc, {
-		flavor,
-		createOnly: optBool(args, "overwrite") !== true
-	});
-	const board = doc.children[0];
-	return {
-		ok: true,
-		path,
-		flavor,
-		version: doc.version,
-		boardId,
-		canvas: {
-			width: Number(board?.["width"] ?? 0),
-			height: Number(board?.["height"] ?? 0)
-		},
-		warnings: check.warnings
-	};
-}
-const TOOLS = {
-	paintress_new: {
-		description: "新建文档（.ptr 是 paintress 的标准格式；.pen 仅作兼容）。创建一个带空 board 的最小可用文档，可直接 render/screenshot 再逐层 insert；已存在同名文件时报错，除非 overwrite=true。path 不带扩展名时自动补 .ptr",
-		inputSchema: {
-			path: z.string().describe("新文档路径；不带扩展名时自动补 .ptr"),
-			name: z.string().optional().describe("board 名称（默认 Board）"),
-			width: z.number().positive().optional().describe("board 宽（默认 900）"),
-			height: z.number().positive().optional().describe("board 高（默认 600）"),
-			fill: z.string().optional().describe("board 背景色（默认 #FFFFFF）"),
-			layout: z.enum([
-				"vertical",
-				"horizontal",
-				"none"
-			]).optional().describe("子节点布局（默认 vertical）"),
-			padding: z.number().optional().describe("board 内边距（默认 0）"),
-			gap: z.number().optional().describe("主轴向间距（默认 0）"),
-			overwrite: z.boolean().optional().describe("已存在时覆盖（默认 false）")
-		},
-		run: (a) => newDoc(a)
-	},
-	paintress_doc_info: {
-		description: "文档摘要：版本、格式风味、节点统计、变量表、顶层节点",
-		inputSchema: { path: z.string().describe("设计稿路径") },
-		run: (a) => read(reqStr(a, "path"), (ctx) => ({
-			flavor: ctx.flavor,
-			version: ctx.doc.version,
-			fileToken: ctx.doc.fileToken,
-			variables: ctx.doc.variables ? Object.keys(ctx.doc.variables) : [],
-			topLevel: ctx.doc.children.map((c) => ({
-				id: c["id"],
-				name: c["name"],
-				type: c["type"]
-			})),
-			nodeCount: Object.values(countByType(ctx.doc.children)).reduce((s, n) => s + n, 0),
-			byType: countByType(ctx.doc.children),
-			warnings: ctx.validation.warnings
-		}))
-	},
-	paintress_query: {
-		description: "条件查询节点：type / name（精确或正则）/ id / reusable",
-		inputSchema: {
-			path: z.string(),
-			type: z.string().optional(),
-			name: z.string().optional(),
-			nameRegex: z.boolean().optional().describe("name 按正则解释"),
-			id: z.string().optional(),
-			reusable: z.boolean().optional()
-		},
-		run: (a) => read(reqStr(a, "path"), (ctx) => query(ctx.doc, {
-			type: optStr(a, "type"),
-			name: optStr(a, "name"),
-			nameRegex: optBool(a, "nameRegex"),
-			id: optStr(a, "id"),
-			reusable: optBool(a, "reusable")
-		}))
-	},
-	paintress_get: {
-		description: "取单个节点子树；depth 控制深度（0=仅本节点，children 省略为 …）",
-		inputSchema: {
-			path: z.string(),
-			id: z.string(),
-			depth: z.number().int().min(0).optional()
-		},
-		run: (a) => read(reqStr(a, "path"), (ctx) => {
-			const res = get(ctx.doc, reqStr(a, "id"), optNum(a, "depth") ?? Infinity);
-			if (!res) throw new Error(`节点不存在：${reqStr(a, "id")}`);
-			return res;
-		})
-	},
-	paintress_update: {
-		description: "浅合并更新节点属性（id 与 type 不可改）",
-		inputSchema: {
-			path: z.string(),
-			id: z.string(),
-			patch: z.record(z.unknown())
-		},
-		run: (a) => write(reqStr(a, "path"), (doc, mark) => {
-			const id = reqStr(a, "id");
-			const res = update(doc, id, objArg(a, "patch"));
-			mark([id]);
-			return res;
-		})
-	},
-	paintress_insert: {
-		description: "插入子节点（缺 id 自动生成；返回新 id）",
-		inputSchema: {
-			path: z.string(),
-			parent: z.string().describe("父节点 id，或 'root'"),
-			node: z.record(z.unknown()),
-			index: z.number().int().min(0).optional()
-		},
-		run: (a) => write(reqStr(a, "path"), (doc, mark) => {
-			const newId = insert(doc, reqStr(a, "parent"), objArg(a, "node"), optNum(a, "index"));
-			mark([newId]);
-			return newId;
-		})
-	},
-	paintress_delete: {
-		description: "删除节点（含子树）",
-		inputSchema: {
-			path: z.string(),
-			id: z.string()
-		},
-		run: (a) => write(reqStr(a, "path"), (doc, mark) => {
-			const id = reqStr(a, "id");
-			const node = remove(doc, id);
-			mark([id]);
-			return { deleted: {
-				id: node["id"],
-				name: node["name"],
-				type: node["type"]
-			} };
-		})
-	},
-	paintress_move: {
-		description: "移动/重排节点到新父（防环校验）",
-		inputSchema: {
-			path: z.string(),
-			id: z.string(),
-			parent: z.string(),
-			index: z.number().int().min(0).optional()
-		},
-		run: (a) => write(reqStr(a, "path"), (doc, mark) => {
-			const id = reqStr(a, "id");
-			move(doc, id, reqStr(a, "parent"), optNum(a, "index"));
-			mark([id]);
-			return {
-				moved: id,
-				to: reqStr(a, "parent")
-			};
-		})
-	},
-	paintress_batch: {
-		description: "批量原子操作：update/insert/delete/move 数组，任一步失败整体作废",
-		inputSchema: {
-			path: z.string(),
-			ops: z.array(z.record(z.unknown()))
-		},
-		run: (a) => write(reqStr(a, "path"), (doc, mark) => {
-			const raw = a["ops"];
-			if (!Array.isArray(raw)) throw new Error("ops 必须是数组");
-			const ops = raw.map((op, idx) => {
-				const rec = op;
-				const kind = rec["op"];
-				if (kind === "update") return {
-					op: "update",
-					id: String(rec["id"]),
-					patch: rec["patch"] ?? {}
-				};
-				if (kind === "insert") return {
-					op: "insert",
-					parent: String(rec["parent"]),
-					node: rec["node"],
-					index: typeof rec["index"] === "number" ? rec["index"] : void 0
-				};
-				if (kind === "delete") return {
-					op: "delete",
-					id: String(rec["id"])
-				};
-				if (kind === "move") return {
-					op: "move",
-					id: String(rec["id"]),
-					parent: String(rec["parent"]),
-					index: typeof rec["index"] === "number" ? rec["index"] : void 0
-				};
-				throw new Error(`ops[${idx}] 的 op 必须是 update|insert|delete|move`);
-			});
-			const before = new Set(collectIds(doc.children));
-			doc.children = batch(doc, ops).children;
-			const insertedIds = collectIds(doc.children).filter((id) => !before.has(id));
-			mark([...ops.flatMap((op) => op.op === "insert" ? [] : [op.id]), ...insertedIds]);
-			return {
-				applied: ops.length,
-				inserted: insertedIds.length
-			};
-		})
-	},
-	paintress_validate: {
-		description: "校验文档：结构错误 + 语义警告（重复 id、悬空 ref、未知类型、未定义变量）",
-		inputSchema: { path: z.string() },
-		run: (a) => read(reqStr(a, "path"), (ctx) => ctx.validation)
-	},
-	paintress_render: {
-		description: "渲染设计稿为 HTML 文件（每节点带 data-node-id）；返回输出路径与画布尺寸",
-		inputSchema: {
-			path: z.string(),
-			out: z.string().describe("输出 .html 路径")
-		},
-		run: (a) => {
-			const out = reqStr(a, "out");
-			const loaded = loadDoc(reqStr(a, "path"));
-			const r = renderDocument(loaded.doc);
-			writeFileSync(out, r.html, "utf8");
-			return {
-				ok: true,
-				out,
-				canvas: r.canvas,
-				warnings: r.warnings
-			};
-		}
-	},
-	paintress_screenshot: {
-		description: "渲染并截图为 PNG（默认 2x）；需要本机 Chromium/Chrome 或 PTR_BROWSER 指向的可执行文件。指定 board 时只截该画板（顶层 frame，即“一页”），而不是整张画布",
-		inputSchema: {
-			path: z.string(),
-			out: z.string().describe("输出 .png 路径"),
-			scale: z.number().int().min(1).max(4).optional().describe("像素倍率，默认 2"),
-			board: z.string().optional().describe("只截某个画板：id 或 name；模糊命中多个时会报错并列出候选")
-		},
-		run: async (a) => {
-			if (!findBrowser()) throw new Error("未找到可用浏览器：安装 Chromium/Chrome，或设置 PTR_BROWSER");
-			const board = typeof a["board"] === "string" ? a["board"] : "";
-			const res = await screenshotPen(reqStr(a, "path"), reqStr(a, "out"), {
-				...typeof a["scale"] === "number" ? { scale: a["scale"] } : {},
-				...board !== "" ? { board } : {}
-			});
-			return {
-				ok: true,
-				out: res.out,
-				canvas: res.canvas,
-				...res.board !== void 0 ? { board: res.board } : {},
-				browser: res.browser,
-				warnings: res.warnings
-			};
-		}
-	},
-	paintress_marks: {
-		description: "读取/清空当前会话的节点标记：用户在浏览器里点击的节点会分配短号 #1 #2…，返回短号 → 节点 id 映射，便于对话中指代（如“#1 改成蓝色”）",
-		inputSchema: {
-			project: z.string().optional().describe("项目名；缺省返回全部项目的标记"),
-			action: z.enum(["list", "clear"]).optional().describe("默认 list")
-		},
-		run: async (a) => {
-			if (!isDaemonRunning()) throw new Error("paintress web 未运行，无法读取标记；先运行 paintress web --daemon");
-			const project = optStr(a, "project") ?? "";
-			if ((optStr(a, "action") ?? "list") === "clear") return await sendRequest({
-				kind: "clear-marks",
-				project
-			});
-			return await sendRequest({
-				kind: "marks",
-				project
-			});
-		}
-	}
-};
-// src/web/spawn.ts
-const START_TIMEOUT_MS = 6e3;
-async function ensureDaemon(opts = {}) {
-	if (isDaemonRunning()) {
-		const res = await sendRequest({ kind: "ping" });
-		if (res.ok && "pong" in res) return {
-			started: false,
-			pid: res.pid
-		};
-	}
-	const entry = process.argv[1];
-	if (!entry) throw new Error("无法确定 CLI 入口路径，不能后台启动 daemon");
-	const args = [entry, "web"];
-	if (opts.port !== void 0) args.push("--port", String(opts.port));
-	if (opts.idleTimeoutMs !== void 0) args.push("--idle", String(opts.idleTimeoutMs));
-	spawn(process.execPath, args, {
-		detached: true,
-		stdio: "ignore"
-	}).unref();
-	const deadline = Date.now() + START_TIMEOUT_MS;
-	while (Date.now() < deadline) {
-		if (isDaemonRunning()) {
-			const res = await sendRequest({ kind: "ping" });
-			if (res.ok && "pong" in res) return {
-				started: true,
-				pid: res.pid
-			};
-		}
-		await new Promise((r) => setTimeout(r, 100));
-	}
-	throw new Error(`后台启动 daemon 超时（${START_TIMEOUT_MS}ms）`);
-}
-// src/web/autoregister.ts
-async function autoRegister(cwd = process.cwd()) {
-	if (process.env["PAINTRESS_NO_AUTO_WEB"] === "1") return null;
-	try {
-		const { started } = await ensureDaemon({ idleTimeoutMs: 36e5 });
-		const project = deriveProjectName(cwd);
-		const watched = await sendRequest({
-			kind: "watch",
-			project,
-			dir: cwd,
-			owner: "agent"
-		}, 8e3);
-		if (!watched.ok) throw new Error(watched.error);
-		return {
-			handle: await attachPersistent(project),
-			project,
-			startedDaemon: started
-		};
-	} catch (cause) {
-		process.stderr.write(`paintress: web 自动注册失败（${cause instanceof Error ? cause.message : String(cause)}），MCP 工具不受影响\n`);
-		return null;
-	}
-}
-// src/mcp/server.ts
-const SERVER_NAME = "paintress";
-const SERVER_VERSION = VERSION;
-/** 构建 MCP server：把共享工具注册到 stdio 协议上 */
-function createMcpServer() {
-	const server = new McpServer({
-		name: SERVER_NAME,
-		version: SERVER_VERSION
-	});
-	for (const [name, def] of Object.entries(TOOLS)) server.registerTool(name, {
-		description: def.description,
-		inputSchema: def.inputSchema
-	}, async (args) => {
-		try {
-			const payload = await def.run(args);
-			return { content: [{
-				type: "text",
-				text: JSON.stringify(payload, null, 2)
-			}] };
-		} catch (cause) {
-			return {
-				content: [{
-					type: "text",
-					text: cause instanceof Error ? cause.message : String(cause)
-				}],
-				isError: true
-			};
-		}
-	});
-	return server;
-}
-/**
-* 父进程看门狗：stdio MCP server 必须随宿主死亡而退出，否则变成孤儿进程
-* （MCP 生态的已知问题）。两道保险：ppid 变化 + stdin EOF。
-*/
-function installParentWatchdog() {
-	const parentPid = process.ppid;
-	setInterval(() => {
-		if (process.ppid !== parentPid) exitClean(0);
-		try {
-			process.kill(parentPid, 0);
-		} catch {
-			exitClean(0);
-		}
-	}, 5e3).unref();
-	process.stdin.on("end", () => exitClean(0));
-	process.stdin.on("close", () => exitClean(0));
-}
-/**
-* attach 连接引用：必须持有，否则 GC 关闭后 daemon 会误判 agent 已退出。
-* 退出时显式关闭——比等 OS 回收更快让 daemon 看到 we're gone。
-*/
-let registrar = null;
-/** 干净退出：断开 attach 连接后退出 */
-function exitClean(code = 0) {
-	try {
-		registrar?.handle.close();
-	} catch {}
-	process.exit(code);
-}
-/** 自动注册自身（best-effort，失败不阻断 MCP） */
-async function registerSelf() {
-	const res = await autoRegister();
-	registrar = res;
-	if (res) process.stderr.write(`paintress: 已注册项目 "${res.project}"，浏览器打开 http://localhost:3316/${encodeURIComponent(res.project)}\n`);
-}
-/** CLI `paintress mcp` 入口：stdio transport + 自动注册 */
-async function runStdioServer() {
-	const server = createMcpServer();
-	const transport = new StdioServerTransport();
-	await server.connect(transport);
-	installParentWatchdog();
-	registerSelf();
-}
-export { isDaemonRunning as a, pidPath as c, sanitizeProjectName as d, socketPath as f, attachPersistent as i, resolveProjectDir as l, encodeLine as m, runStdioServer as n, sendRequest as o, LineDecoder as p, TOOLS as r, lockPath as s, createMcpServer as t, safeJoin as u };