zero-workspace 0.0.2

package/dist/utils/processManager.d.ts

@@ -0,0 +1,53 @@
+export interface PidInfo {
+    pid: number;
+    port: number;
+    version: string;
+    startedAt: string;
+}
+/**
+ * 获取 PID 文件路径
+ */
+export declare function getPidFilePath(): string;
+/**
+ * 读取 PID 信息
+ */
+export declare function readPidInfo(): PidInfo | null;
+/**
+ * 写入 PID 信息
+ */
+export declare function writePidInfo(info: PidInfo): void;
+/**
+ * 删除 PID 文件
+ */
+export declare function removePidFile(): void;
+/**
+ * 检查进程是否存活
+ */
+export declare function isProcessRunning(pid: number): boolean;
+/**
+ * 检查端口占用并获取占用进程的 PID
+ */
+export declare function getPortProcess(port: number): number | null;
+/**
+ * 终止进程
+ */
+export declare function killProcess(pid: number): boolean;
+/**
+ * 检查进程命令行是否包含指定关键词
+ */
+export declare function getProcessCommand(pid: number): string | null;
+/**
+ * 检查并清理旧版本端口上的进程
+ * @param logger 日志函数
+ * @returns 是否执行了迁移
+ */
+export declare function migrateLegacyPorts(logger?: (msg: string) => void): boolean;
+/**
+ * 检查并处理旧版本进程
+ * @param port 要使用的端口
+ * @param currentVersion 当前版本
+ * @param logger 日志函数
+ * @returns true 表示可以继续启动，false 表示应该跳过（相同版本已在运行）
+ */
+export declare function handleOldProcess(port: number, currentVersion: string, logger?: (msg: string) => void): boolean;
+//# sourceMappingURL=processManager.d.ts.map

package/dist/utils/processManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processManager.d.ts","sourceRoot":"","sources":["../../src/utils/processManager.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,GAAG,IAAI,CAW5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAOhD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB1D;AAaD;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA0BhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe5D;AAOD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAoB,GAAG,OAAO,CA4BzF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,MAAM,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAoB,GAC5C,OAAO,CA6DT"}

package/dist/utils/processManager.js

@@ -0,0 +1,267 @@
+// src/utils/processManager.ts
+// 进程管理工具 - 版本检测和旧进程替换
+import { execSync } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+const IS_DEV = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+const baseDir = IS_DEV ? ".zero-workspace-dev" : ".zero-workspace";
+/**
+ * 获取 PID 文件路径
+ */
+export function getPidFilePath() {
+    return path.join(os.homedir(), baseDir, "webui.pid");
+}
+/**
+ * 读取 PID 信息
+ */
+export function readPidInfo() {
+    try {
+        const pidFile = getPidFilePath();
+        if (fs.existsSync(pidFile)) {
+            const content = fs.readFileSync(pidFile, "utf-8");
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // 忽略
+    }
+    return null;
+}
+/**
+ * 写入 PID 信息
+ */
+export function writePidInfo(info) {
+    const pidFile = getPidFilePath();
+    const dir = path.dirname(pidFile);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(pidFile, JSON.stringify(info, null, 2));
+}
+/**
+ * 删除 PID 文件
+ */
+export function removePidFile() {
+    try {
+        const pidFile = getPidFilePath();
+        if (fs.existsSync(pidFile)) {
+            fs.unlinkSync(pidFile);
+        }
+    }
+    catch {
+        // 忽略
+    }
+}
+/**
+ * 检查进程是否存活
+ */
+export function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查端口占用并获取占用进程的 PID
+ */
+export function getPortProcess(port) {
+    try {
+        if (process.platform === "win32") {
+            // Windows: netstat -ano | findstr :PORT
+            const result = execSync(`netstat -ano | findstr :${port}`, { encoding: "utf-8" });
+            const lines = result.trim().split("\n").filter(Boolean);
+            for (const line of lines) {
+                // 匹配 LISTENING 状态的行
+                if (line.includes("LISTENING")) {
+                    const parts = line.trim().split(/\s+/);
+                    const pid = parseInt(parts[parts.length - 1], 10);
+                    if (!isNaN(pid))
+                        return pid;
+                }
+            }
+            return null;
+        }
+        else {
+            // Unix: lsof
+            const result = execSync(`lsof -ti:${port} 2>/dev/null || true`, { encoding: "utf-8" });
+            const pids = result.trim().split("\n").filter(Boolean);
+            return pids.length > 0 ? parseInt(pids[0], 10) : null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 跨平台等待
+ */
+function sleep(ms) {
+    if (process.platform === "win32") {
+        execSync(`ping -n 1 127.0.0.1 > nul`, { timeout: ms + 1000 });
+    }
+    else {
+        execSync(`sleep ${ms / 1000}`);
+    }
+}
+/**
+ * 终止进程
+ */
+export function killProcess(pid) {
+    try {
+        if (process.platform === "win32") {
+            // Windows: taskkill
+            execSync(`taskkill /PID ${pid} /F 2>nul`, { encoding: "utf-8" });
+        }
+        else {
+            process.kill(pid, "SIGTERM");
+        }
+        // 等待进程终止
+        let attempts = 0;
+        while (isProcessRunning(pid) && attempts < 10) {
+            sleep(100);
+            attempts++;
+        }
+        // 如果还在运行，强制终止
+        if (isProcessRunning(pid)) {
+            if (process.platform === "win32") {
+                execSync(`taskkill /PID ${pid} /F 2>nul`, { encoding: "utf-8" });
+            }
+            else {
+                process.kill(pid, "SIGKILL");
+            }
+        }
+        return !isProcessRunning(pid);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 检查进程命令行是否包含指定关键词
+ */
+export function getProcessCommand(pid) {
+    try {
+        if (process.platform === "win32") {
+            // Windows: wmic
+            const result = execSync(`wmic process where processid=${pid} get commandline 2>nul`, {
+                encoding: "utf-8",
+            });
+            const lines = result.trim().split("\n").filter(Boolean);
+            return lines.length > 1 ? lines[1].trim() : null;
+        }
+        else {
+            return execSync(`ps -p ${pid} -o command= 2>/dev/null || true`, { encoding: "utf-8" }).trim();
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 旧版本使用的端口（用于迁移检测）
+ */
+const LEGACY_PORTS = [3000, 3001];
+/**
+ * 检查并清理旧版本端口上的进程
+ * @param logger 日志函数
+ * @returns 是否执行了迁移
+ */
+export function migrateLegacyPorts(logger = console.error) {
+    let migrated = false;
+    for (const legacyPort of LEGACY_PORTS) {
+        const portPid = getPortProcess(legacyPort);
+        if (portPid) {
+            const cmdline = getProcessCommand(portPid);
+            // 检查是否是 zero-workspace 相关进程
+            if (cmdline && (cmdline.includes("zero-workspace") || cmdline.includes("dist/http") || cmdline.includes("dist/index"))) {
+                logger(`[迁移] 检测到旧版本服务在端口 ${legacyPort} 运行 (PID: ${portPid})`);
+                logger(`[迁移] 端口已从 ${legacyPort} 迁移到 19540/19541`);
+                logger(`[迁移] 正在关闭旧服务...`);
+                if (killProcess(portPid)) {
+                    logger(`[迁移] 旧服务已关闭`);
+                    migrated = true;
+                }
+                else {
+                    logger(`[迁移] 无法关闭旧服务，请手动关闭后重试`);
+                }
+            }
+        }
+    }
+    if (migrated) {
+        logger(`[迁移] 提示：新版本 WebUI 地址为 http://localhost:19540`);
+        logger(`[迁移] 请更新浏览器书签`);
+    }
+    return migrated;
+}
+/**
+ * 检查并处理旧版本进程
+ * @param port 要使用的端口
+ * @param currentVersion 当前版本
+ * @param logger 日志函数
+ * @returns true 表示可以继续启动，false 表示应该跳过（相同版本已在运行）
+ */
+export function handleOldProcess(port, currentVersion, logger = console.error) {
+    // 首先检查并迁移旧版本端口
+    migrateLegacyPorts(logger);
+    const pidInfo = readPidInfo();
+    // 情况1：有 PID 记录且进程存活
+    if (pidInfo && isProcessRunning(pidInfo.pid)) {
+        // 检查端口是否匹配
+        const samePort = pidInfo.port === port;
+        if (pidInfo.version !== currentVersion) {
+            // 版本不同，需要替换
+            logger(`检测到旧版本进程 (v${pidInfo.version} → v${currentVersion})`);
+            logger(`正在终止旧进程 (PID: ${pidInfo.pid})...`);
+            if (killProcess(pidInfo.pid)) {
+                logger(`旧进程已终止`);
+                removePidFile();
+                return true;
+            }
+            else {
+                const killCmd = process.platform === "win32" ? `taskkill /PID ${pidInfo.pid} /F` : `kill ${pidInfo.pid}`;
+                logger(`无法终止旧进程，请手动执行: ${killCmd}`);
+                return false;
+            }
+        }
+        else if (samePort) {
+            // 相同版本且相同端口，跳过启动
+            logger(`服务已在运行 (PID: ${pidInfo.pid}, 端口: ${pidInfo.port}, 版本: ${pidInfo.version})`);
+            return false;
+        }
+        else {
+            // 相同版本但不同端口，允许启动（旧进程在不同端口运行）
+            logger(`注意: 旧进程在端口 ${pidInfo.port} 运行，当前请求端口 ${port}`);
+            // 继续检查当前端口是否被占用
+        }
+    }
+    // 清理无效的 PID 记录
+    if (pidInfo && !isProcessRunning(pidInfo.pid)) {
+        removePidFile();
+    }
+    // 情况2：端口被占用
+    const portPid = getPortProcess(port);
+    if (portPid) {
+        const cmdline = getProcessCommand(portPid);
+        // 检查是否是 zero-workspace 相关进程
+        if (cmdline && (cmdline.includes("zero-workspace") || cmdline.includes("dist/http"))) {
+            logger(`端口 ${port} 被旧进程占用 (PID: ${portPid})`);
+            logger(`正在终止...`);
+            if (killProcess(portPid)) {
+                logger(`进程已终止`);
+                return true;
+            }
+            else {
+                logger(`无法终止进程`);
+                return false;
+            }
+        }
+        // 其他进程占用端口，返回 false 但不报错（由调用方处理）
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=processManager.js.map

package/dist/utils/processManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processManager.js","sourceRoot":"","sources":["../../src/utils/processManager.ts"],"names":[],"mappings":"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"}

package/dist/utils/sessionLogger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 设置当前会话 ID
+ */
+export declare function setCurrentSessionId(sessionId: string | undefined): void;
+/**
+ * 获取当前会话 ID
+ */
+export declare function getCurrentSessionId(): string | undefined;
+/**
+ * 记录 MCP 工具调用开始
+ */
+export declare function logMcpStart(toolName: string, params?: Record<string, unknown>): void;
+/**
+ * 记录 MCP 工具调用结束
+ */
+export declare function logMcpEnd(toolName: string, success: boolean, result: unknown, durationMs?: number): void;
+/**
+ * 记录错误
+ */
+export declare function logMcpError(toolName: string, error: Error | string): void;
+export declare const sessionLogger: {
+    setCurrentSessionId: typeof setCurrentSessionId;
+    getCurrentSessionId: typeof getCurrentSessionId;
+    logMcpStart: typeof logMcpStart;
+    logMcpEnd: typeof logMcpEnd;
+    logMcpError: typeof logMcpError;
+};
+//# sourceMappingURL=sessionLogger.d.ts.map

package/dist/utils/sessionLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionLogger.d.ts","sourceRoot":"","sources":["../../src/utils/sessionLogger.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI,CAmBxF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAE,MAAU,GAAG,IAAI,CA2B3G;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAoBzE;AAED,eAAO,MAAM,aAAa;;;;;;CAMzB,CAAC"}

package/dist/utils/sessionLogger.js

@@ -0,0 +1,142 @@
+// src/utils/sessionLogger.ts
+// 会话级别日志记录器
+// - 有 sessionId：写入 {sessionId}.log
+// - 无 sessionId：写入 system.log
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { logger } from "./logger.js";
+const IS_DEV = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+const DIR_SUFFIX = IS_DEV ? "-dev" : "";
+const ZERO_HOME = path.join(os.homedir(), `.zero-workspace${DIR_SUFFIX}`);
+const LOGS_DIR = path.join(ZERO_HOME, "logs");
+// 当前活跃的 sessionId（从 session_bind/session_status 调用中提取）
+let currentSessionId;
+/**
+ * 确保日志目录存在
+ */
+function ensureLogsDir() {
+    try {
+        if (!fs.existsSync(LOGS_DIR)) {
+            fs.mkdirSync(LOGS_DIR, { recursive: true });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 写入会话专属日志
+ */
+function writeToSessionLog(sessionId, type, event, data) {
+    if (!ensureLogsDir())
+        return;
+    try {
+        const logPath = path.join(LOGS_DIR, `${sessionId}.log`);
+        const timestamp = new Date().toISOString();
+        const line = `[${timestamp}] [${type}] ${event}: ${JSON.stringify(data)}\n`;
+        fs.appendFileSync(logPath, line, "utf-8");
+    }
+    catch {
+        // 静默失败
+    }
+}
+/**
+ * 设置当前会话 ID
+ */
+export function setCurrentSessionId(sessionId) {
+    currentSessionId = sessionId;
+}
+/**
+ * 获取当前会话 ID
+ */
+export function getCurrentSessionId() {
+    return currentSessionId;
+}
+/**
+ * 记录 MCP 工具调用开始
+ */
+export function logMcpStart(toolName, params = {}) {
+    // 尝试从参数中提取 sessionId
+    if (params.sessionId && typeof params.sessionId === "string") {
+        currentSessionId = params.sessionId;
+    }
+    const data = {
+        event: "start",
+        tool: toolName,
+        params,
+    };
+    if (currentSessionId) {
+        // 有 sessionId：写入会话日志
+        writeToSessionLog(currentSessionId, "MCP", `${toolName}:start`, { params });
+    }
+    else {
+        // 无 sessionId：写入 system.log
+        logger.info("mcp", { ...data, sessionId: undefined });
+    }
+}
+/**
+ * 记录 MCP 工具调用结束
+ */
+export function logMcpEnd(toolName, success, result, durationMs = 0) {
+    const resultStr = typeof result === "object" ? JSON.stringify(result) : String(result);
+    const truncatedResult = resultStr.length > 500 ? resultStr.slice(0, 500) + "..." : resultStr;
+    if (currentSessionId) {
+        // 有 sessionId：写入会话日志
+        writeToSessionLog(currentSessionId, "MCP", `${toolName}:end`, {
+            success,
+            result: truncatedResult,
+            durationMs,
+        });
+    }
+    else {
+        // 无 sessionId：写入 system.log
+        const data = {
+            event: "end",
+            tool: toolName,
+            sessionId: undefined,
+            success,
+            result: truncatedResult,
+            durationMs,
+        };
+        if (success) {
+            logger.info("mcp", data);
+        }
+        else {
+            logger.error("mcp", data);
+        }
+    }
+}
+/**
+ * 记录错误
+ */
+export function logMcpError(toolName, error) {
+    const errorMsg = error instanceof Error ? error.message : String(error);
+    const errorStack = error instanceof Error ? error.stack : undefined;
+    if (currentSessionId) {
+        // 有 sessionId：写入会话日志
+        writeToSessionLog(currentSessionId, "MCP", `${toolName}:error`, {
+            error: errorMsg,
+            stack: errorStack,
+        });
+    }
+    else {
+        // 无 sessionId：写入 system.log
+        logger.error("mcp", {
+            event: "error",
+            tool: toolName,
+            sessionId: undefined,
+            error: errorMsg,
+            stack: errorStack,
+        });
+    }
+}
+export const sessionLogger = {
+    setCurrentSessionId,
+    getCurrentSessionId,
+    logMcpStart,
+    logMcpEnd,
+    logMcpError,
+};
+//# sourceMappingURL=sessionLogger.js.map

package/dist/utils/sessionLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionLogger.js","sourceRoot":"","sources":["../../src/utils/sessionLogger.ts"],"names":[],"mappings":"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"}

package/dist/utils/time.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 获取当前时间的 ISO 8601 格式字符串
+ */
+export declare function now(): string;
+/**
+ * 格式化时间为简短格式 (用于日志显示)
+ * 例如: "2024-01-15 14:30:25"
+ */
+export declare function formatShort(isoString: string): string;
+/**
+ * 格式化时间为 HH:mm 格式 (用于日志记录)
+ * 例如: "14:30"
+ */
+export declare function formatHHmm(isoString?: string): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/utils/time.js

@@ -0,0 +1,32 @@
+// src/utils/time.ts
+/**
+ * 获取当前时间的 ISO 8601 格式字符串
+ */
+export function now() {
+    return new Date().toISOString();
+}
+/**
+ * 格式化时间为简短格式 (用于日志显示)
+ * 例如: "2024-01-15 14:30:25"
+ */
+export function formatShort(isoString) {
+    const date = new Date(isoString);
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    const hours = String(date.getHours()).padStart(2, "0");
+    const minutes = String(date.getMinutes()).padStart(2, "0");
+    const seconds = String(date.getSeconds()).padStart(2, "0");
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`;
+}
+/**
+ * 格式化时间为 HH:mm 格式 (用于日志记录)
+ * 例如: "14:30"
+ */
+export function formatHHmm(isoString) {
+    const date = isoString ? new Date(isoString) : new Date();
+    const hours = String(date.getHours()).padStart(2, "0");
+    const minutes = String(date.getMinutes()).padStart(2, "0");
+    return `${hours}:${minutes}`;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,oBAAoB;AAEpB;;GAEG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,SAAkB;IAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 验证工作区名称
+ * @throws ZeroError 如果名称不合法
+ */
+export declare function validateWorkspaceName(name: string): void;
+/**
+ * 验证节点标题
+ * @throws ZeroError 如果标题不合法
+ */
+export declare function validateNodeTitle(title: string): void;
+/**
+ * 验证 ID 是否为空
+ */
+export declare function validateId(id: string | undefined | null, type: "workspace" | "node"): void;
+/**
+ * 验证并规范化项目根目录路径
+ * @param inputPath 用户输入的路径
+ * @param basePath 基准路径（默认为 cwd），用于解析相对路径
+ * @returns 规范化后的绝对路径
+ * @throws ZeroError 如果路径不安全或不存在
+ */
+export declare function validateProjectRoot(inputPath: string, basePath?: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAOrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAQ1F;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAsB,GAAG,MAAM,CAyC/F"}