paintress 0.6.0 → 0.7.1

package/dist/server-DZRNNWac.js

@@ -1,1599 +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, m as expandRefs, qt as VERSION, t as renderDocument, v as get, x as query, y as insert } from "./render-BSf62388.js";
-import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { homedir, tmpdir } from "node:os";
-import { basename, dirname, join, relative, resolve, sep } from "node:path";
-import { z } from "zod";
-import { randomUUID } from "node:crypto";
-import { chromium } from "playwright-core";
-import { connect } from "node:net";
-import { spawn } from "node:child_process";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-// \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, flags) => {
-	let target = Object.setPrototypeOf({}, null);
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!(flags & 1)) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return flags & 2 ? target : Object.preventExtensions(target);
-};
-// 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/doc/project.ts
-/**
-* 项目级预设与组件库（规格见 specs/project-presets.md、specs/components.md）。
-*
-* 约定：项目根 = 从设计稿所在目录向上找、最近的含 `__preset.ptr` / `__components.ptr` 的目录。
-* 两个文件都是**普通设计稿**：预设值走原生 `variables`，组件走 `reusable`；项目级语义只放在
-* `x-paintress` 扩展位里。因此 pen 读取器看到它们仍是合法文档。
-*/
-const PRESET_FILE = "__preset.ptr";
-const COMPONENTS_FILE = "__components.ptr";
-function isPresetType(v) {
-	return v === "color" || v === "radius";
-}
-/** 拼出设计稿旁边那份笔记的绝对路径（只认 .ptr / .pen，其余扩展名返回 null） */
-function notePathFor(designAbsPath) {
-	if (!/\.(ptr|pen)$/i.test(designAbsPath)) return null;
-	return designAbsPath.replace(/\.(ptr|pen)$/i, ".md");
-}
-function isRecord(v) {
-	return typeof v === "object" && v !== null && !Array.isArray(v);
-}
-/** 目录 → 项目根（最近的含预设/组件文件的祖先目录）；找不到返回 null */
-function findProjectRoot(from) {
-	let dir = resolve(from);
-	try {
-		if (!statSync(dir).isDirectory()) dir = dirname(dir);
-	} catch {
-		dir = dirname(dir);
-	}
-	for (;;) {
-		if (existsSync(join(dir, "__preset.ptr")) || existsSync(join(dir, "__components.ptr"))) return dir;
-		const parent = dirname(dir);
-		if (parent === dir || !parent.startsWith(sep)) return null;
-		dir = parent;
-	}
-}
-/** 传入文件 → 其所在目录；传入目录 → 自身 */
-function projectDirOf(from) {
-	const abs = resolve(from);
-	try {
-		return statSync(abs).isDirectory() ? abs : dirname(abs);
-	} catch {
-		return dirname(abs);
-	}
-}
-/** 从设计稿 / 目录定位预设文件（存在才算命中） */
-function presetPathFor(from) {
-	const root = findProjectRoot(from);
-	if (root === null) return null;
-	const p = join(root, PRESET_FILE);
-	return existsSync(p) ? p : null;
-}
-function componentsPathFor(from) {
-	const root = findProjectRoot(from);
-	if (root === null) return null;
-	const p = join(root, COMPONENTS_FILE);
-	return existsSync(p) ? p : null;
-}
-function presetKindOf(key, doc) {
-	const meta = doc["x-paintress"];
-	const items = isRecord(meta) && isRecord(meta["presets"]) ? meta["presets"]["items"] : void 0;
-	const declared = isRecord(items) && isRecord(items[key]) ? items[key]["type"] : void 0;
-	if (isPresetType(declared)) return declared;
-	const def = doc.variables?.[key];
-	const t = isRecord(def) ? def["type"] : void 0;
-	if (t === "color") return "color";
-	if (t === "number") return "radius";
-	return null;
-}
-/** 读预设文件；不存在返回 null。结构错误直接抛出（带路径上下文） */
-function readPresetFile(path) {
-	if (!existsSync(path)) return null;
-	const loaded = loadDoc(path);
-	const items = [];
-	for (const [key, def] of Object.entries(loaded.doc.variables ?? {})) {
-		if (!isRecord(def)) continue;
-		const type = presetKindOf(key, loaded.doc);
-		if (type === null) continue;
-		const raw = def["value"];
-		if (Array.isArray(raw)) continue;
-		const meta = loaded.doc["x-paintress"];
-		const metaItems = isRecord(meta) && isRecord(meta["presets"]) ? meta["presets"]["items"] : void 0;
-		const declared = isRecord(metaItems) && isRecord(metaItems[key]) ? metaItems[key] : void 0;
-		items.push({
-			key,
-			type,
-			name: typeof declared?.["name"] === "string" && declared["name"] !== "" ? declared["name"] : key,
-			value: String(raw)
-		});
-	}
-	items.sort((a, b) => a.type === b.type ? a.key.localeCompare(b.key) : a.type.localeCompare(b.type));
-	return {
-		path,
-		doc: loaded.doc,
-		mtimeMs: loaded.mtimeMs,
-		items
-	};
-}
-/** 项目预设（从任意设计稿/目录出发）；没有项目或没有文件都返回空列表 */
-function listPresets(from) {
-	const path = presetPathFor(from);
-	if (path === null) return {
-		path: null,
-		items: []
-	};
-	return {
-		path,
-		items: readPresetFile(path)?.items ?? []
-	};
-}
-/**
-* 渲染/校验用的副本：预设打底，文档本地同名变量优先。
-* **绝不能拿去保存** —— 否则一次写入就把预设值烤进了设计稿。
-*/
-function withProjectPresets(doc, presetDoc) {
-	const vars = presetDoc?.variables;
-	if (!vars || Object.keys(vars).length === 0) return doc;
-	return {
-		...doc,
-		variables: {
-			...vars,
-			...doc.variables ?? {}
-		}
-	};
-}
-/**
-* 渲染 / 校验用：按设计稿所在项目的预设补全变量，返回**副本**（绝不可拿去保存）。
-* 这是「预设只在项目里存一份」的唯一兑付点：渲染、截图、校验、写前检查都走这里。
-*/
-function applyProjectPresets(doc, filePath) {
-	const p = presetPathFor(filePath);
-	const presetDoc = p === null ? null : readPresetFile(p)?.doc ?? null;
-	return {
-		doc: withProjectPresets(doc, presetDoc),
-		presetNames: presetVarNames(presetDoc)
-	};
-}
-/** 项目预设提供的变量名（校验用；只读名字，不做合并） */
-function projectPresetNames(filePath) {
-	const p = presetPathFor(filePath);
-	if (p === null) return /* @__PURE__ */ new Set();
-	return presetVarNames(readPresetFile(p)?.doc ?? null);
-}
-/** 预设文件对应的变量名集合（校验时用来区分「未定义」与「来自项目预设」） */
-function presetVarNames(presetDoc) {
-	return new Set(Object.keys(presetDoc?.variables ?? {}));
-}
-const COLOR_RE = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
-/** 值归一：对外字串 → 落盘值；类型不合法时抛出可读错误 */
-function normalizePresetValue(type, value) {
-	const raw = value.trim();
-	if (type === "color") {
-		if (!COLOR_RE.test(raw)) throw new Error(`颜色预设只接受 #RGB / #RRGGBB / #RRGGBBAA，收到：${value}`);
-		return raw.toUpperCase();
-	}
-	const n = Number(raw);
-	if (!Number.isFinite(n) || n < 0) throw new Error(`倒角预设只接受非负数，收到：${value}`);
-	return n;
-}
-/** 变量表里的 type：color → color，radius → number */
-function varTypeOf(type) {
-	return type === "color" ? "color" : "number";
-}
-function presetMetaItems(doc) {
-	const meta = doc["x-paintress"];
-	const presets = isRecord(meta) ? meta["presets"] : void 0;
-	const items = isRecord(presets) ? presets["items"] : void 0;
-	return isRecord(items) ? items : {};
-}
-function emptyDoc() {
-	return {
-		version: PEN_DOC_VERSION,
-		fileToken: randomUUID(),
-		variables: {},
-		children: []
-	};
-}
-/** 注册项目时确保两个文件存在；已存在则一个字都不动 */
-function ensureProjectScaffold(root) {
-	const created = [];
-	const targets = [{
-		file: PRESET_FILE,
-		doc: {
-			...emptyDoc(),
-			["x-paintress"]: {
-				spec: "1",
-				presets: {
-					version: 1,
-					items: {}
-				}
-			}
-		}
-	}, {
-		file: COMPONENTS_FILE,
-		doc: {
-			...emptyDoc(),
-			["x-paintress"]: {
-				spec: "1",
-				components: { version: 1 }
-			}
-		}
-	}];
-	for (const t of targets) {
-		const path = join(root, t.file);
-		if (existsSync(path)) continue;
-		try {
-			saveDoc(path, t.doc, {
-				flavor: "ptr",
-				createOnly: true
-			});
-			created.push(path);
-		} catch (cause) {
-			if (existsSync(path)) continue;
-			throw cause;
-		}
-	}
-	return { created };
-}
-/** 写一条预设（新建或改值）；返回最新列表。from 可以是设计稿、预设文件或目录 */
-function setPreset(from, input) {
-	const key = input.key.trim();
-	if (key === "") throw new Error("预设 key 不能为空");
-	if (!/^[A-Za-z0-9._-]+$/.test(key)) throw new Error(`预设 key 只允许字母数字与 . _ -，收到：${key}`);
-	let path = presetPathFor(from);
-	if (path === null) {
-		const root = findProjectRoot(from) ?? projectDirOf(from);
-		ensureProjectScaffold(root);
-		path = join(root, PRESET_FILE);
-	}
-	const file = readPresetFile(path);
-	const doc = file?.doc ?? emptyDoc();
-	const value = normalizePresetValue(input.type, input.value);
-	const variables = { ...doc.variables ?? {} };
-	variables[key] = {
-		type: varTypeOf(input.type),
-		value
-	};
-	const metaItems = { ...presetMetaItems(doc) };
-	metaItems[key] = {
-		type: input.type,
-		...input.name !== void 0 && input.name !== "" ? { name: input.name } : {}
-	};
-	const next = {
-		...doc,
-		variables,
-		["x-paintress"]: {
-			...doc["x-paintress"],
-			spec: "1",
-			presets: {
-				version: 1,
-				items: metaItems
-			}
-		}
-	};
-	saveDoc(path, next, {
-		flavor: "ptr",
-		...file !== null ? { expectedMtimeMs: file.mtimeMs } : {}
-	});
-	return readPresetFile(path)?.items ?? [];
-}
-/** 删一条预设；返回最新列表（不存在时什么都不做） */
-function removePreset(from, key) {
-	const path = presetPathFor(from);
-	if (path === null) return [];
-	const file = readPresetFile(path);
-	if (file === null) return [];
-	const variables = { ...file.doc.variables ?? {} };
-	if (!(key in variables)) return file.items;
-	delete variables[key];
-	const metaItems = { ...presetMetaItems(file.doc) };
-	delete metaItems[key];
-	const next = {
-		...file.doc,
-		variables,
-		["x-paintress"]: {
-			...file.doc["x-paintress"],
-			spec: "1",
-			presets: {
-				version: 1,
-				items: metaItems
-			}
-		}
-	};
-	saveDoc(path, next, {
-		flavor: "ptr",
-		expectedMtimeMs: file.mtimeMs
-	});
-	return readPresetFile(path)?.items ?? [];
-}
-/** 全树按 id 找节点（组件库、复制插入、画廊都用这一处） */
-function findNodeIn(nodes, id) {
-	for (const n of nodes) {
-		if (!n || typeof n !== "object") continue;
-		const rec = n;
-		if (rec["id"] === id) return rec;
-		const kids = rec["children"];
-		if (Array.isArray(kids)) {
-			const hit = findNodeIn(kids, id);
-			if (hit !== null) return hit;
-		}
-	}
-	return null;
-}
-/** 组件库里的所有 reusable 节点（全树扫描） */
-function listComponents(componentsPath) {
-	const doc = readPresetFile(componentsPath)?.doc ?? loadDoc(componentsPath).doc;
-	const out = [];
-	const walk = (nodes) => {
-		for (const n of nodes) {
-			if (!isRecord(n)) continue;
-			if (n["reusable"] === true && typeof n["id"] === "string") out.push({
-				id: n["id"],
-				name: typeof n["name"] === "string" && n["name"] !== "" ? n["name"] : n["id"],
-				type: typeof n["type"] === "string" ? n["type"] : "?",
-				...typeof n["width"] === "number" ? { width: n["width"] } : {},
-				...typeof n["height"] === "number" ? { height: n["height"] } : {}
-			});
-			const kids = n["children"];
-			if (Array.isArray(kids)) walk(kids);
-		}
-	};
-	walk(doc.children ?? []);
-	return out;
-}
-/** 读组件库文件（含 mtime，供乐观并发写入用） */
-function readComponentsFile(path) {
-	if (!existsSync(path)) return null;
-	const loaded = loadDoc(path);
-	return {
-		doc: loaded.doc,
-		mtimeMs: loaded.mtimeMs
-	};
-}
-/** 备注：`readFileSync` 保留给调用方做小文件快读（笔记接口用） */
-function readTextIfExists(path, maxBytes = 524288) {
-	if (!existsSync(path)) return null;
-	const st = statSync(path);
-	if (!st.isFile()) return null;
-	if (st.size > maxBytes) throw new Error(`文件过大（${st.size} 字节，上限 ${maxBytes}）：${path}`);
-	return readFileSync(path, "utf8");
-}
-// 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(applyProjectPresets(loaded.doc, penPath).doc);
-	const target = opts.board !== void 0 ? selectBoard(rendered.boards, opts.board) : void 0;
-	const tmpDir = mkdtempSync(join(tmpdir(), "paintress-shot-"));
-	const htmlPath = join(tmpDir, "page.html");
-	writeFileSync(htmlPath, rendered.html, "utf8");
-	let clip;
-	let measuredBoard;
-	try {
-		const browser = await chromium.launch({
-			executablePath: browserPath,
-			args: ["--no-sandbox", "--disable-dev-shm-usage"]
-		});
-		try {
-			const page = await browser.newPage({
-				viewport: {
-					width: Math.max(800, rendered.canvas.width, target !== void 0 ? Math.ceil(target.x + 3200) : 0),
-					height: Math.max(600, rendered.canvas.height, target !== void 0 ? Math.ceil(target.y + 3200) : 0)
-				},
-				deviceScaleFactor: opts.scale ?? 2
-			});
-			await page.goto(`file://${htmlPath}`);
-			await page.waitForTimeout(opts.settleMs ?? 120);
-			const measured = await page.evaluate(`(() => {
-        const canvasEl = document.querySelector('.ptr-canvas');
-        const cr = canvasEl ? canvasEl.getBoundingClientRect() : null;
-        const nodes = Array.from(document.querySelectorAll('[data-board]'));
-        const boards = nodes.map((el) => {
-          const r = el.getBoundingClientRect();
-          return {
-            id: el.getAttribute('data-node-id') || '',
-            name: el.getAttribute('data-board-name') || undefined,
-            x: cr ? r.left - cr.left : 0,
-            y: cr ? r.top - cr.top : 0,
-            w: r.width,
-            h: r.height
-          };
-        });
-        // 自动尺寸的设计稿常常撑出 .ptr-canvas 的固定宽高：以真实内容盒为准
-        let contentW = cr ? cr.width : 0;
-        let contentH = cr ? cr.height : 0;
-        for (const b of boards) {
-          contentW = Math.max(contentW, b.x + b.w);
-          contentH = Math.max(contentH, b.y + b.h);
-        }
-        return { width: Math.ceil(contentW), height: Math.ceil(contentH), boards };
-      })()`);
-			const realTarget = target === void 0 ? void 0 : measured.boards.find((b) => b.id === target.id) ?? void 0;
-			if (realTarget !== void 0 && target !== void 0) {
-				if (realTarget.w <= 0 || realTarget.h <= 0) throw new Error(`画板 ${boardLabel(target)} 尺寸为 0（${realTarget.w}×${realTarget.h}），无法截图`);
-				measuredBoard = {
-					id: target.id,
-					...target.name !== void 0 ? { name: target.name } : {},
-					x: Math.round(realTarget.x),
-					y: Math.round(realTarget.y),
-					w: realTarget.w,
-					h: realTarget.h
-				};
-			} else if (target !== void 0) {
-				if (target.w <= 0 || target.h <= 0) throw new Error(`画板 ${boardLabel(target)} 尺寸为 0（${target.w}×${target.h}），无法截图`);
-				measuredBoard = {
-					id: target.id,
-					...target.name !== void 0 ? { name: target.name } : {},
-					x: target.x,
-					y: target.y,
-					w: target.w,
-					h: target.h
-				};
-			}
-			const box = measuredBoard ?? {
-				x: 0,
-				y: 0,
-				w: measured.width,
-				h: measured.height
-			};
-			clip = {
-				x: Math.max(0, Math.floor(box.x)),
-				y: Math.max(0, Math.floor(box.y)),
-				width: Math.max(1, Math.ceil(box.w)),
-				height: Math.max(1, Math.ceil(box.h))
-			};
-			const vp = page.viewportSize();
-			const needW = clip.x + clip.width;
-			const needH = clip.y + clip.height;
-			if (vp === null || vp.width < needW || vp.height < needH) {
-				await page.setViewportSize({
-					width: Math.max(vp?.width ?? 0, needW),
-					height: Math.max(vp?.height ?? 0, needH)
-				});
-				await page.waitForTimeout(20);
-			}
-			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: {
-			width: Math.max(rendered.canvas.width, clip.x + clip.width),
-			height: Math.max(rendered.canvas.height, clip.y + clip.height)
-		},
-		warnings: rendered.warnings,
-		browser: browserPath
-	};
-	if (measuredBoard !== void 0) result.board = {
-		id: measuredBoard.id,
-		...measuredBoard.name !== void 0 ? { name: measuredBoard.name } : {},
-		x: measuredBoard.x,
-		y: measuredBoard.y,
-		width: measuredBoard.w,
-		height: measuredBoard.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 后缀。
-* 允许 `/` 表达目录层级：默认项目名就是 `父目录/自身`（如 `c-thun/raybend`）。
-*/
-function sanitizeProjectName(name) {
-	const cleaned = name.replace(/[^A-Za-z0-9._/-]/g, "-").replace(/\.{2,}/g, ".").replace(/\/{2,}/g, "/").replace(/^[./-]+|[./-]+$/g, "");
-	return cleaned === "" ? "project" : cleaned;
-}
-/**
-* 由目录推导默认项目名：`父目录/自身`（适配 repos/<org>/<project> 结构）。
-* key 里直接带 `/`，URL 与展示都无需再转义。
-*/
-function deriveProjectName(dir) {
-	const abs = resolve(dir);
-	const parent = basename(dirname(abs));
-	const self = basename(abs);
-	return sanitizeProjectName(parent && parent !== "/" ? `${parent}/${self}` : self);
-}
-/** 校验并解析注册目录：必须存在且是目录；返回真实路径（供穿越校验基准） */
-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());
-}
-/**
-* 查询运行中的 daemon：未运行、socket 残留、daemon 无响应都返回 null。
-* 调用方拿到 null 就可以安全地走「启动」分支 —— 幂等的判据只有这一处。
-*/
-async function queryDaemon(timeoutMs = 2e3) {
-	if (!isDaemonRunning()) return null;
-	try {
-		const res = await sendRequest({ kind: "ping" }, timeoutMs);
-		if (res.ok && "pong" in res) return {
-			pid: res.pid,
-			port: res.port,
-			uptimeMs: res.uptimeMs
-		};
-	} catch {}
-	return null;
-}
-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();
-						},
-						isClosed: () => closed,
-						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
-		}));
-	});
-}
-function daemonPid() {
-	try {
-		const raw = readFileSync(pidPath(), "utf8").trim();
-		const pid = Number(raw);
-		return Number.isInteger(pid) && pid > 0 ? pid : null;
-	} catch {
-		return null;
-	}
-}
-// src/web/spawn.ts
-const START_TIMEOUT_MS = 6e3;
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-/**
-* 复用已在运行的 daemon；显式指定了端口且与运行中的不一致时抛错
-* （幂等不等于「悄悄忽略你的参数」：要换端口得先 `paintress stop`）。
-*/
-async function reuseDaemon(port) {
-	const info = await queryDaemon();
-	if (info === null) return null;
-	if (port !== void 0 && port !== info.port) throw new Error(`paintress web 已在运行（pid ${info.pid}，端口 ${info.port}），与请求的端口 ${port} 不同；如需换端口请先 paintress stop`);
-	return info;
-}
-/** 启动超时的诊断信息：区分「进程没起来」与「进程在但控制面不通」 */
-function timeoutHint() {
-	const pid = daemonPid();
-	if (pid !== null) try {
-		process.kill(pid, 0);
-		return `；进程 ${pid} 仍在运行但控制面无响应，先运行 paintress stop（或 kill ${pid}）后重试`;
-	} catch {}
-	return "；可能是锁或端口残留，先 paintress ping 看状态，或前台跑 paintress web 看报错";
-}
-async function ensureDaemon(opts = {}) {
-	const running = await reuseDaemon(opts.port);
-	if (running !== null) return {
-		started: false,
-		pid: running.pid,
-		port: running.port
-	};
-	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));
-	if (opts.noOpen === true) args.push("--no-open");
-	const child = spawn(process.execPath, args, {
-		detached: true,
-		stdio: "ignore"
-	});
-	child.unref();
-	let exitCode = null;
-	child.once("exit", (code) => {
-		exitCode = code;
-	});
-	const deadline = Date.now() + START_TIMEOUT_MS;
-	while (Date.now() < deadline) {
-		const info = await queryDaemon(500);
-		if (info !== null) {
-			if (opts.port !== void 0 && info.port !== opts.port) throw new Error(`daemon 起在端口 ${info.port} 而不是请求的 ${opts.port}；先 paintress stop 再重试`);
-			return {
-				started: true,
-				pid: info.pid,
-				port: info.port
-			};
-		}
-		if (exitCode !== null) throw new Error(`后台 daemon 启动失败（退出码 ${exitCode}）${timeoutHint()}`);
-		await sleep(100);
-	}
-	throw new Error(`后台启动 daemon 超时（${START_TIMEOUT_MS}ms）${timeoutHint()}`);
-}
-// src/web/open-browser.ts
-var open_browser_exports = /* @__PURE__ */ __exportAll({ openBrowser: () => openBrowser });
-/**
-* 在宿主机上打开浏览器。
-*
-* 设计前提（operator 2026-11-13）：界面状态由 agent 侧驱动，
-* 人不需要去记「进程起没起、项目绑没绑」—— agent 第一次把项目交给 web 时，
-* 浏览器就该自己弹出来，并且直接落在那个项目上。
-*
-* 关闭方式：`PAINTRESS_NO_OPEN=1`（CI、远程服务器、或在 SSH 里跑 agent 时用）。
-* 无图形环境（Linux 无 DISPLAY / WAYLAND_DISPLAY）自动跳过，不报错。
-*/
-function openBrowser(url) {
-	if (process.env["PAINTRESS_NO_OPEN"] === "1") return false;
-	if (process.env["CI"] === "1" || process.env["CI"] === "true") return false;
-	const platform = process.platform;
-	if (platform === "linux" && !process.env["DISPLAY"] && !process.env["WAYLAND_DISPLAY"]) return false;
-	const [cmd, args] = platform === "darwin" ? ["open", [url]] : platform === "win32" ? ["cmd", [
-		"/c",
-		"start",
-		"",
-		url
-	]] : ["xdg-open", [url]];
-	try {
-		const child = spawn(cmd, args, {
-			detached: true,
-			stdio: "ignore"
-		});
-		child.on("error", () => {});
-		child.unref();
-		return true;
-	} catch {
-		return false;
-	}
-}
-/** 顶层页面地址（项目列表）；项目深链见 projectUrl */
-function baseUrl(port) {
-	return `http://localhost:${port}/`;
-}
-/** 项目深链：项目 key 本身就带 `/`（`c-thun/raybend`），URL 里不需要转义 */
-function projectUrl(port, project, file) {
-	if (!project) return baseUrl(port);
-	return `http://localhost:${port}/${project.split("/").filter((s) => s !== "").map(encodeURIComponent).join("/")}${file ? `?file=${encodeURIComponent(file)}` : ""}`;
-}
-// src/web/autoregister.ts
-/**
-* 每个项目的 attach 连接必须被持有：daemon 用「连接是否还在」判定 agent 是否活着。
-* 连接一断，agent 自动注册的项目会在宽限期后退场。
-*/
-const handles = /* @__PURE__ */ new Map();
-/** 进程退出时释放连接（daemon 立刻看到 agent 走了，比等 OS 回收快） */
-function closeViewerHandles() {
-	for (const handle of handles.values()) try {
-		handle.close();
-	} catch {}
-	handles.clear();
-}
-function autoWebDisabled() {
-	return process.env["PAINTRESS_NO_AUTO_WEB"] === "1";
-}
-/** 幂等入口：确保 daemon 在跑、项目已注册、本进程持有存活连接，返回可分享的 URL */
-async function ensureViewer(opts = {}) {
-	if (autoWebDisabled()) throw new Error("PAINTRESS_NO_AUTO_WEB=1：已关闭自动查看器，需要手动运行 paintress web");
-	const dir = resolve(opts.dir ?? process.cwd());
-	const project = opts.project !== void 0 ? sanitizeProjectName(opts.project) : deriveProjectName(dir);
-	const running = await queryDaemon();
-	const attached = handles.get(project);
-	if (running !== null && attached !== void 0 && !attached.isClosed()) return {
-		project,
-		pid: running.pid,
-		port: running.port,
-		url: projectUrl(running.port, project),
-		startedDaemon: false,
-		openedBrowser: false
-	};
-	const { started, pid, port } = await ensureDaemon();
-	const watched = await sendRequest({
-		kind: "watch",
-		project,
-		dir,
-		owner: "agent",
-		...opts.depth !== void 0 ? { depth: opts.depth } : {}
-	}, 8e3);
-	if (!watched.ok) throw new Error(watched.error);
-	attached?.close();
-	handles.set(project, await attachPersistent(project));
-	const openedBrowser = started && openBrowser(projectUrl(port, project));
-	return {
-		project,
-		pid,
-		port,
-		url: projectUrl(port, project),
-		startedDaemon: started,
-		openedBrowser
-	};
-}
-/**
-* MCP server 启动时自动注册自身（best-effort，失败不阻断 MCP）。
-* 与 ensureViewer 同一条路径 —— 启动时注册和「开始画之前补一次」是同一件事。
-*/
-async function autoRegister(cwd = process.cwd()) {
-	if (autoWebDisabled()) return null;
-	try {
-		return await ensureViewer({ dir: cwd });
-	} catch (cause) {
-		process.stderr.write(`paintress: web 自动注册失败（${cause instanceof Error ? cause.message : String(cause)}），MCP 工具不受影响\n`);
-		return null;
-	}
-}
-// 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 presetNames = projectPresetNames(path);
-	const v = validateDoc(loaded.doc, {
-		knownVars: presetNames,
-		presetVars: presetNames
-	});
-	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 不带扩展名时补默认扩展名；调用方显式写 `.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
-	};
-}
-/** 复制进设计稿前给整棵子树换新 id：组件库与目标文件的 id 空间互不相干 */
-function remapIds(node, taken) {
-	if (!node || typeof node !== "object") return;
-	const rec = node;
-	if (typeof rec["id"] === "string") {
-		const fresh = genId(taken);
-		taken.add(fresh);
-		rec["id"] = fresh;
-	}
-	const kids = rec["children"];
-	if (Array.isArray(kids)) for (const k of kids) remapIds(k, taken);
-}
-const TOOLS = {
-	paintress_viewer: {
-		description: "确保本地查看器在运行，并把当前项目注册进去，返回人可以打开的 URL。幂等：已在运行就直接复用（返回现有 pid/端口，绝不起第二个进程），可以在开始画/改/展示设计稿之前无条件调用。**开始作画前先调它，不要等人提醒**",
-		inputSchema: {
-			dir: z.string().optional().describe("要注册的目录，默认当前工作目录"),
-			project: z.string().optional().describe("项目名（URL 里那一段），默认取「父目录/目录名」"),
-			depth: z.number().int().min(1).max(6).optional().describe("列举设计稿的最大深度，默认 3")
-		},
-		run: async (a) => {
-			const dir = optStr(a, "dir");
-			const project = optStr(a, "project");
-			const depth = optNum(a, "depth");
-			const info = await ensureViewer({
-				...dir !== void 0 ? { dir } : {},
-				...project !== void 0 ? { project } : {},
-				...depth !== void 0 ? { depth } : {}
-			});
-			return {
-				ok: true,
-				project: info.project,
-				url: info.url,
-				pid: info.pid,
-				port: info.port,
-				started: info.startedDaemon,
-				openedBrowser: info.openedBrowser,
-				hint: `把人指向 ${info.url}（单份设计稿加深链 ?file=<相对路径>）`
-			};
-		}
-	},
-	paintress_new: {
-		description: "新建一份设计稿：创建一个带空 board 的最小可用文档，可直接 render/screenshot 再逐层 insert；已存在同名文件时报错，除非 overwrite=true。path 不带扩展名时自动补默认扩展名",
-		inputSchema: {
-			path: z.string().describe("新文档路径；不带扩展名时自动补默认扩展名"),
-			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) : [],
-			projectPresets: (() => {
-				const { path: presetPath, items } = listPresets(reqStr(a, "path"));
-				return {
-					path: presetPath,
-					count: items.length
-				};
-			})(),
-			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) => {
-			const path = reqStr(a, "path");
-			const loaded = loadDoc(path);
-			const presetNames = projectPresetNames(path);
-			return validateDoc(loaded.doc, {
-				knownVars: presetNames,
-				presetVars: presetNames
-			});
-		}
-	},
-	paintress_preset: {
-		description: "项目预设：颜色 / 倒角这类会反复微调的值在项目里存一份（__preset.ptr），设计稿里写 $key 引用。作画前先把颜色与倒角定下来注册成预设；人在查看器里改预设值，画布实时变，不用一句句说「红一点」。action=list 查看，set 新建/改值，remove 删除",
-		inputSchema: {
-			action: z.enum([
-				"list",
-				"set",
-				"remove"
-			]),
-			path: z.string().optional().describe("设计稿或项目目录，默认当前工作目录"),
-			key: z.string().optional().describe("变量名，设计稿里写 $key；set / remove 必填"),
-			type: z.enum(["color", "radius"]).optional().describe("预设类型；set 必填"),
-			name: z.string().optional().describe("人看的名称，默认同 key"),
-			value: z.string().optional().describe("值：颜色写 #RRGGBB（或 #RGB / #RRGGBBAA），倒角写非负数字，如 '8'；set 必填")
-		},
-		run: (a) => {
-			const from = resolve(optStr(a, "path") ?? process.cwd());
-			const action = optStr(a, "action") ?? "list";
-			if (action === "list") {
-				const { path, items } = listPresets(from);
-				return {
-					ok: true,
-					path,
-					items
-				};
-			}
-			const key = reqStr(a, "key");
-			if (action === "remove") return {
-				ok: true,
-				path: presetPathFor(from),
-				items: removePreset(from, key)
-			};
-			const type = optStr(a, "type");
-			if (!isPresetType(type)) throw new Error("type 必须是 color 或 radius");
-			const name = optStr(a, "name");
-			const items = setPreset(from, {
-				key,
-				type,
-				value: reqStr(a, "value"),
-				...name !== void 0 ? { name } : {}
-			});
-			return {
-				ok: true,
-				path: presetPathFor(from),
-				items
-			};
-		}
-	},
-	paintress_component: {
-		description: "项目组件库：先查已有组件再动手，避免重复造轮子。action=list 列出可复用组件（__components.ptr 里 reusable 节点）；action=insert 把某个组件复制进设计稿——复制件自带新 id、内部 ref 已展开，可独立渲染（只复制，不做联动编辑）",
-		inputSchema: {
-			action: z.enum(["list", "insert"]),
-			path: z.string().optional().describe("设计稿或项目目录；insert 时是目标设计稿"),
-			id: z.string().optional().describe("组件 id；insert 必填"),
-			parent: z.string().optional().describe("插到哪个父节点，默认 'root'"),
-			index: z.number().int().min(0).optional()
-		},
-		run: (a) => {
-			const action = optStr(a, "action") ?? "list";
-			const from = resolve(optStr(a, "path") ?? process.cwd());
-			if (action === "list") {
-				const compPath = componentsPathFor(from);
-				if (compPath === null) return {
-					ok: true,
-					path: null,
-					items: []
-				};
-				return {
-					ok: true,
-					path: compPath,
-					items: listComponents(compPath)
-				};
-			}
-			const target = reqStr(a, "path");
-			const compId = reqStr(a, "id");
-			const compPath = componentsPathFor(resolve(target));
-			if (compPath === null) throw new Error("找不到项目组件库 __components.ptr（先在项目里注册）");
-			const compLoaded = readComponentsFile(compPath);
-			if (compLoaded === null) throw new Error(`组件库不可读：${compPath}`);
-			const warnings = [];
-			const node = findNodeIn(expandRefs(applyProjectPresets(compLoaded.doc, compPath).doc, warnings), compId);
-			if (node === null) throw new Error(`组件不存在：${compId}（先 paintress_component list 看有哪些）`);
-			const copy = structuredClone(node);
-			const stripReusable = (n) => {
-				if (!n || typeof n !== "object") return;
-				const rec = n;
-				delete rec["reusable"];
-				const kids = rec["children"];
-				if (Array.isArray(kids)) for (const k of kids) stripReusable(k);
-			};
-			stripReusable(copy);
-			return write(target, (doc, mark) => {
-				remapIds(copy, new Set(collectIds(doc.children)));
-				const newId = insert(doc, optStr(a, "parent") ?? "root", copy, optNum(a, "index"));
-				mark([newId]);
-				return {
-					id: newId,
-					from: compId,
-					componentPath: compPath,
-					warnings
-				};
-			});
-		}
-	},
-	paintress_render: {
-		description: "渲染设计稿为 HTML 文件（每节点带 data-node-id）；返回输出路径与画布尺寸",
-		inputSchema: {
-			path: z.string(),
-			out: z.string().describe("输出 .html 路径")
-		},
-		run: (a) => {
-			const out = reqStr(a, "out");
-			const path = reqStr(a, "path");
-			const loaded = loadDoc(path);
-			const r = renderDocument(applyProjectPresets(loaded.doc, path).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_viewer（或运行 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/mcp/server.ts
-const SERVER_NAME = "paintress";
-const SERVER_VERSION = VERSION;
-/**
-* 连接时交给客户端模型的使用说明（MCP initialize 的 instructions）。
-* 头号规则是「作画前把查看器拉起来」——人看不到进程状态，agent 不等提醒就该做。
-*/
-const INSTRUCTIONS = `paintress is a design tool for AI agents: design files are JSON, edited through tools and rendered by a local viewer.
-
-VIEWER — the human only sees your work in the viewer, so keep it running:
-- Call \`paintress_viewer\` before the first write of a drawing session (creating, editing or showing a design) — do not wait to be asked.
-- It is idempotent: if the viewer is already up it returns the existing pid/port/URL and starts nothing; calling it again is always safe and never starts a second process.
-- CLI equivalent, same idempotence: \`paintress web --daemon\` returns immediately with the URL. Never block on plain \`paintress web\`.
-- Hand the returned URL to the human (append \`?file=<relative path>\` to deep-link one document). Never ask them to start the viewer or run \`watch\`.
-
-WORKFLOW: \`paintress_new\` → \`paintress_query\`/\`paintress_get\` for real node ids (never invent them) → \`paintress_update\`/\`insert\`/\`move\`/\`delete\` or \`paintress_batch\` → \`paintress_validate\` → \`paintress_screenshot\` to check the result with your own eyes.
-\`#1\` in the conversation is a click marker from the viewer: resolve it with \`paintress_marks\`.`;
-/** 写操作前补一次查看器：这是「光画不开 web」的兜底网，不靠 agent 自觉 */
-const WRITE_TOOLS = /* @__PURE__ */ new Set([
-	"paintress_new",
-	"paintress_update",
-	"paintress_insert",
-	"paintress_delete",
-	"paintress_move",
-	"paintress_batch"
-]);
-/** 构建 MCP server：把共享工具注册到 stdio 协议上 */
-function createMcpServer(opts = {}) {
-	const server = new McpServer({
-		name: SERVER_NAME,
-		version: SERVER_VERSION
-	}, { instructions: INSTRUCTIONS });
-	for (const [name, def] of Object.entries(TOOLS)) server.registerTool(name, {
-		description: def.description,
-		inputSchema: def.inputSchema
-	}, async (args) => {
-		try {
-			if (opts.ensureViewerBeforeWrite === true && WRITE_TOOLS.has(name)) await ensureViewerQuiet();
-			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 连接引用：由 autoregister 持有（ensureViewer 每次调用都会复用/刷新）。
-* 退出时显式关闭——比等 OS 回收更快让 daemon 看到 we're gone。
-*/
-function exitClean(code = 0) {
-	closeViewerHandles();
-	process.exit(code);
-}
-/** 写之前补一次查看器：best-effort，失败不阻断写入（人看不到图，但文件还是要改） */
-async function ensureViewerQuiet() {
-	try {
-		await ensureViewer();
-	} catch (cause) {
-		process.stderr.write(`paintress: 写操作前自动拉起查看器失败（${cause instanceof Error ? cause.message : String(cause)}）\n`);
-	}
-}
-/** 自动注册自身（best-effort，失败不阻断 MCP） */
-async function registerSelf() {
-	const res = await autoRegister();
-	if (res) process.stderr.write(`paintress: 已注册项目 "${res.project}"，浏览器打开 ${res.url}\n`);
-}
-/** CLI `paintress mcp` 入口：stdio transport + 自动注册 */
-async function runStdioServer() {
-	const server = createMcpServer({ ensureViewerBeforeWrite: true });
-	const transport = new StdioServerTransport();
-	await server.connect(transport);
-	installParentWatchdog();
-	registerSelf();
-}
-export { isPresetType as C, presetPathFor as D, notePathFor as E, readTextIfExists as O, findNodeIn as S, listPresets as T, LineDecoder as _, ensureDaemon as a, componentsPathFor as b, isDaemonRunning as c, lockPath as d, pidPath as f, socketPath as g, sanitizeProjectName as h, open_browser_exports as i, setPreset as k, queryDaemon as l, safeJoin as m, runStdioServer as n, reuseDaemon as o, resolveProjectDir as p, TOOLS as r, attachPersistent as s, createMcpServer as t, sendRequest as u, encodeLine as v, listComponents as w, ensureProjectScaffold as x, applyProjectPresets as y };