zero-workspace 0.0.2

package/dist/utils/git.js

@@ -0,0 +1,400 @@
+// src/utils/git.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+import { promises as fs } from "fs";
+import path from "path";
+import { devLog } from "./devLog.js";
+const execAsync = promisify(exec);
+/**
+ * 需要从 git 跟踪中排除的目录
+ */
+const EXCLUDED_DIRS = [".zero-workspace/", ".zero-workspace-dev/"];
+/**
+ * 分支命名常量
+ */
+const BRANCH_PREFIX = "zero_workspace";
+const BACKUP_PREFIX = `${BRANCH_PREFIX}/backup`;
+const PROCESS_PREFIX = `${BRANCH_PREFIX}/process`;
+/**
+ * 执行 git 命令
+ */
+async function execGit(command, cwd) {
+    const options = cwd ? { cwd } : {};
+    return execAsync(`git ${command}`, options);
+}
+/**
+ * 检查当前目录是否是 git 仓库
+ */
+export async function isGitRepo(cwd) {
+    try {
+        await execGit("rev-parse --is-inside-work-tree", cwd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 确保 ZeroWorkspace 目录被 git 排除
+ * 通过添加到 .git/info/exclude（不影响项目的 .gitignore）
+ */
+export async function ensureGitExclude(cwd) {
+    const workDir = cwd || process.cwd();
+    try {
+        // 获取 git 仓库根目录
+        const { stdout } = await execGit("rev-parse --git-dir", workDir);
+        const gitDir = path.resolve(workDir, stdout.trim());
+        const excludePath = path.join(gitDir, "info", "exclude");
+        // 读取现有内容
+        let content = "";
+        try {
+            content = await fs.readFile(excludePath, "utf-8");
+        }
+        catch {
+            // 文件不存在，使用空内容
+        }
+        // 检查并添加缺失的排除项
+        const lines = content.split("\n");
+        let modified = false;
+        for (const dir of EXCLUDED_DIRS) {
+            if (!lines.includes(dir)) {
+                lines.push(dir);
+                modified = true;
+            }
+        }
+        // 只在有修改时写入
+        if (modified) {
+            await fs.writeFile(excludePath, lines.join("\n"), "utf-8");
+        }
+    }
+    catch (error) {
+        // 记录错误但不抛出（可能不是 git 仓库或权限问题）
+        devLog.gitError("ensureGitExclude", error, { cwd: workDir });
+    }
+}
+/**
+ * 获取当前分支名
+ */
+export async function getCurrentBranch(cwd) {
+    const { stdout } = await execGit("rev-parse --abbrev-ref HEAD", cwd);
+    return stdout.trim();
+}
+/**
+ * 检查是否有未提交的修改（包括未跟踪文件）
+ */
+export async function hasUncommittedChanges(cwd) {
+    const { stdout } = await execGit("status --porcelain", cwd);
+    return stdout.trim().length > 0;
+}
+/**
+ * 检查是否有已暂存但未提交的修改
+ */
+export async function hasStagedChanges(cwd) {
+    const { stdout } = await execGit("diff --cached --name-only", cwd);
+    return stdout.trim().length > 0;
+}
+/**
+ * 列出匹配模式的分支
+ * @param pattern - 分支名模式，如 "zero_workspace/process/*"
+ */
+export async function listBranches(pattern, cwd) {
+    try {
+        const { stdout } = await execGit(`branch --list "${pattern}"`, cwd);
+        return stdout
+            .split("\n")
+            .map((line) => line.trim().replace(/^\*\s*/, ""))
+            .filter((line) => line.length > 0);
+    }
+    catch (error) {
+        devLog.gitDebug("listBranches", { pattern, error: error instanceof Error ? error.message : String(error) });
+        return [];
+    }
+}
+/**
+ * 创建备份分支（用于保存未提交内容）
+ * 分支名格式: zero_workspace/backup/{workspaceId}/{timestamp}
+ * @returns 备份分支名
+ */
+export async function createBackupBranch(workspaceId, cwd) {
+    const timestamp = Date.now();
+    const branchName = `${BACKUP_PREFIX}/${workspaceId}/${timestamp}`;
+    // 创建并切换到备份分支
+    await execGit(`checkout -b "${branchName}"`, cwd);
+    // 添加所有文件并提交
+    await execGit("add -A", cwd);
+    await execGit(`commit -m "zero: 派发前自动备份 - ${workspaceId}" --allow-empty`, cwd);
+    return branchName;
+}
+/**
+ * 创建并切换到派发分支
+ * 分支名格式: zero_workspace/process/{workspaceId}
+ */
+export async function createProcessBranch(workspaceId, cwd) {
+    const branchName = `${PROCESS_PREFIX}/${workspaceId}`;
+    // 检查分支是否已存在
+    const existingBranches = await listBranches(branchName, cwd);
+    if (existingBranches.length > 0) {
+        // 检查是否当前在该分支上
+        const currentBranch = await getCurrentBranch(cwd);
+        if (currentBranch === branchName) {
+            // 当前在目标分支上，先切换到 detached HEAD
+            await execGit("checkout --detach", cwd);
+        }
+        // 删除已存在的分支
+        await execGit(`branch -D "${branchName}"`, cwd);
+    }
+    await execGit(`checkout -b "${branchName}"`, cwd);
+    return branchName;
+}
+/**
+ * 切换到派发分支
+ */
+export async function checkoutProcessBranch(workspaceId, cwd) {
+    const branchName = `${PROCESS_PREFIX}/${workspaceId}`;
+    await execGit(`checkout "${branchName}"`, cwd);
+}
+/**
+ * 切换到指定分支
+ */
+export async function checkoutBranch(branchName, cwd) {
+    await execGit(`checkout "${branchName}"`, cwd);
+}
+/**
+ * 获取当前 commit hash
+ */
+export async function getCurrentCommit(cwd) {
+    const { stdout } = await execGit("rev-parse HEAD", cwd);
+    return stdout.trim();
+}
+/**
+ * 提交派发修改
+ * @returns commit hash
+ */
+export async function commitDispatch(nodeId, title, cwd) {
+    await execGit("add -A", cwd);
+    // 检查是否有内容需要提交
+    const hasChanges = await hasStagedChanges(cwd);
+    if (!hasChanges) {
+        // 没有修改，返回当前 commit
+        return getCurrentCommit(cwd);
+    }
+    const message = `zero: ${nodeId} - ${title}`;
+    await execGit(`commit -m "${message}"`, cwd);
+    return getCurrentCommit(cwd);
+}
+/**
+ * 回滚到指定 commit
+ */
+export async function resetToCommit(commitHash, cwd) {
+    await execGit(`reset --hard "${commitHash}"`, cwd);
+}
+/**
+ * 合并派发分支到目标分支（使用 --no-ff）
+ */
+export async function mergeProcessBranch(workspaceId, targetBranch, cwd) {
+    const processBranch = `${PROCESS_PREFIX}/${workspaceId}`;
+    // 切换到目标分支
+    await execGit(`checkout "${targetBranch}"`, cwd);
+    // 合并派发分支
+    await execGit(`merge --no-ff "${processBranch}" -m "zero: 完成工作区 ${workspaceId} 任务"`, cwd);
+}
+/**
+ * 删除派发分支
+ */
+export async function deleteProcessBranch(workspaceId, cwd) {
+    const branchName = `${PROCESS_PREFIX}/${workspaceId}`;
+    try {
+        await execGit(`branch -D "${branchName}"`, cwd);
+    }
+    catch (error) {
+        // 分支不存在，忽略错误
+        devLog.gitDebug("deleteProcessBranch", { branchName, error: error instanceof Error ? error.message : String(error) });
+    }
+}
+/**
+ * 删除备份分支
+ * @param timestamp - 可选，指定时间戳删除特定备份；不指定则删除该工作区所有备份
+ */
+export async function deleteBackupBranch(workspaceId, timestamp, cwd) {
+    if (timestamp) {
+        const branchName = `${BACKUP_PREFIX}/${workspaceId}/${timestamp}`;
+        try {
+            await execGit(`branch -D "${branchName}"`, cwd);
+        }
+        catch (error) {
+            // 分支不存在，忽略错误
+            devLog.gitDebug("deleteBackupBranch", { branchName, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    else {
+        // 删除该工作区所有备份分支
+        const pattern = `${BACKUP_PREFIX}/${workspaceId}/*`;
+        const branches = await listBranches(pattern, cwd);
+        for (const branch of branches) {
+            try {
+                await execGit(`branch -D "${branch}"`, cwd);
+            }
+            catch (error) {
+                // 忽略错误
+                devLog.gitDebug("deleteBackupBranch:loop", { branch, error: error instanceof Error ? error.message : String(error) });
+            }
+        }
+    }
+}
+/**
+ * 删除工作区相关的所有分支（备份 + 派发）
+ */
+export async function deleteAllWorkspaceBranches(workspaceId, cwd) {
+    await deleteProcessBranch(workspaceId, cwd);
+    await deleteBackupBranch(workspaceId, undefined, cwd);
+}
+/**
+ * 检查是否有派发分支存在（用于并发检查）
+ * @returns 如果存在派发分支，返回工作区 ID；否则返回 null
+ */
+export async function getActiveDispatchWorkspace(cwd) {
+    const pattern = `${PROCESS_PREFIX}/*`;
+    const branches = await listBranches(pattern, cwd);
+    if (branches.length === 0) {
+        return null;
+    }
+    // 从分支名提取工作区 ID
+    const match = branches[0].match(/zero_workspace\/process\/(.+)$/);
+    return match ? match[1] : null;
+}
+/**
+ * 获取派发分支名
+ */
+export function getProcessBranchName(workspaceId) {
+    return `${PROCESS_PREFIX}/${workspaceId}`;
+}
+/**
+ * 检查当前是否在派发分支上
+ */
+export async function isOnProcessBranch(workspaceId, cwd) {
+    const currentBranch = await getCurrentBranch(cwd);
+    return currentBranch === `${PROCESS_PREFIX}/${workspaceId}`;
+}
+/**
+ * 获取两个提交之间的提交列表
+ * @returns 提交列表，每项包含 hash 和 message
+ */
+export async function getCommitsBetween(fromCommit, toCommit, cwd) {
+    try {
+        const { stdout } = await execGit(`log --oneline ${fromCommit}..${toCommit}`, cwd);
+        return stdout
+            .trim()
+            .split("\n")
+            .filter((line) => line.length > 0)
+            .map((line) => {
+            const [hash, ...messageParts] = line.split(" ");
+            return { hash, message: messageParts.join(" ") };
+        });
+    }
+    catch (error) {
+        devLog.gitError("getCommitsBetween", error, { fromCommit, toCommit });
+        return [];
+    }
+}
+/**
+ * 获取未提交修改的摘要
+ */
+export async function getUncommittedChangesSummary(cwd) {
+    try {
+        const { stdout: statusOutput } = await execGit("status --porcelain", cwd);
+        if (!statusOutput.trim()) {
+            return null;
+        }
+        const files = statusOutput.trim().split("\n").length;
+        // 尝试获取 diff 统计，但对于未跟踪文件可能不准确
+        try {
+            const { stdout: diffOutput } = await execGit("diff --stat HEAD", cwd);
+            const match = diffOutput.match(/(\d+) insertions?.*?(\d+) deletions?/);
+            if (match) {
+                return {
+                    files,
+                    insertions: parseInt(match[1], 10),
+                    deletions: parseInt(match[2], 10),
+                };
+            }
+        }
+        catch (error) {
+            devLog.gitError("getUncommittedChangesSummary:diff", error);
+        }
+        return { files, insertions: 0, deletions: 0 };
+    }
+    catch (error) {
+        devLog.gitError("getUncommittedChangesSummary", error);
+        return null;
+    }
+}
+/**
+ * Squash 合并派发分支到目标分支
+ * @returns 新的 commit hash
+ */
+export async function squashMergeProcessBranch(workspaceId, targetBranch, commitMessage, cwd) {
+    const processBranch = `${PROCESS_PREFIX}/${workspaceId}`;
+    // 切换到目标分支
+    await execGit(`checkout "${targetBranch}"`, cwd);
+    // Squash 合并（不自动提交）
+    await execGit(`merge --squash "${processBranch}"`, cwd);
+    // 提交
+    await execGit(`commit -m "${commitMessage}"`, cwd);
+    return getCurrentCommit(cwd);
+}
+/**
+ * Rebase 合并派发分支（保留独立提交，线性历史）
+ */
+export async function rebaseMergeProcessBranch(workspaceId, targetBranch, cwd) {
+    const processBranch = `${PROCESS_PREFIX}/${workspaceId}`;
+    // 切换到目标分支
+    await execGit(`checkout "${targetBranch}"`, cwd);
+    // Fast-forward 合并（如果可能）或 rebase
+    try {
+        await execGit(`merge --ff-only "${processBranch}"`, cwd);
+    }
+    catch (error) {
+        // 如果不能 fast-forward，使用 rebase
+        devLog.gitDebug("rebaseMergeProcessBranch:ff-failed", { processBranch, targetBranch, error: error instanceof Error ? error.message : String(error) });
+        await execGit(`rebase "${processBranch}"`, cwd);
+    }
+}
+/**
+ * Cherry-pick 派发分支的提交到工作区（不提交）
+ * @param fromCommit - 起始提交（不包含）
+ */
+export async function cherryPickToWorkingTree(workspaceId, targetBranch, fromCommit, cwd) {
+    const processBranch = `${PROCESS_PREFIX}/${workspaceId}`;
+    // 切换到目标分支
+    await execGit(`checkout "${targetBranch}"`, cwd);
+    // 获取要 cherry-pick 的提交
+    const commits = await getCommitsBetween(fromCommit, processBranch, cwd);
+    if (commits.length === 0) {
+        return;
+    }
+    // 从旧到新 cherry-pick（不提交）
+    const commitHashes = commits.map((c) => c.hash).reverse();
+    for (const hash of commitHashes) {
+        try {
+            await execGit(`cherry-pick --no-commit ${hash}`, cwd);
+        }
+        catch (error) {
+            // 如果有冲突，保持当前状态让用户处理
+            devLog.gitDebug("cherryPickToWorkingTree:conflict", { hash, error: error instanceof Error ? error.message : String(error) });
+            break;
+        }
+    }
+}
+/**
+ * 获取备份分支名（最新的一个）
+ */
+export async function getLatestBackupBranch(workspaceId, cwd) {
+    const pattern = `${BACKUP_PREFIX}/${workspaceId}/*`;
+    const branches = await listBranches(pattern, cwd);
+    if (branches.length === 0) {
+        return null;
+    }
+    // 按时间戳排序，返回最新的
+    return branches.sort().reverse()[0];
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

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

package/dist/utils/hash.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 计算内容的 MD5 hash
+ * @param content 要计算 hash 的内容
+ * @returns 32 位十六进制字符串
+ */
+export declare function computeContentHash(content: string): string;
+/**
+ * 计算节点多字段组合的 hash
+ * @param fields 包含 title, requirement, note, conclusion 的对象
+ * @returns 32 位十六进制字符串
+ */
+export declare function computeNodeHash(fields: {
+    title: string;
+    requirement: string;
+    note: string;
+    conclusion: string;
+}): string;
+/**
+ * 子节点结论项（用于 conclusionsHash 计算）
+ */
+export interface ChildConclusionForHash {
+    nodeId: string;
+    conclusion: string;
+}
+/**
+ * 计算子节点结论的 conclusionsHash
+ * 用于检测子节点结论是否发生变化，确保"先读后写"
+ * @param childConclusions 子节点结论列表
+ * @returns 32 位十六进制字符串
+ */
+export declare function computeConclusionsHash(childConclusions: ChildConclusionForHash[]): string;
+//# sourceMappingURL=hash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAQT;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,GAAG,MAAM,CAMzF"}

package/dist/utils/hash.js

@@ -0,0 +1,37 @@
+import { createHash } from 'crypto';
+/**
+ * 计算内容的 MD5 hash
+ * @param content 要计算 hash 的内容
+ * @returns 32 位十六进制字符串
+ */
+export function computeContentHash(content) {
+    return createHash('md5').update(content, 'utf8').digest('hex');
+}
+/**
+ * 计算节点多字段组合的 hash
+ * @param fields 包含 title, requirement, note, conclusion 的对象
+ * @returns 32 位十六进制字符串
+ */
+export function computeNodeHash(fields) {
+    const combined = [
+        fields.title,
+        fields.requirement,
+        fields.note,
+        fields.conclusion,
+    ].join('\n---\n');
+    return computeContentHash(combined);
+}
+/**
+ * 计算子节点结论的 conclusionsHash
+ * 用于检测子节点结论是否发生变化，确保"先读后写"
+ * @param childConclusions 子节点结论列表
+ * @returns 32 位十六进制字符串
+ */
+export function computeConclusionsHash(childConclusions) {
+    const data = childConclusions
+        .filter(c => c.conclusion) // 只包含有结论的子节点
+        .map(c => `${c.nodeId}:${c.conclusion}`)
+        .join('|');
+    return computeContentHash(data);
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAK/B;IACC,MAAM,QAAQ,GAAG;QACf,MAAM,CAAC,KAAK;QACZ,MAAM,CAAC,WAAW;QAClB,MAAM,CAAC,IAAI;QACX,MAAM,CAAC,UAAU;KAClB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClB,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,gBAA0C;IAC/E,MAAM,IAAI,GAAG,gBAAgB;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAE,aAAa;SACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;SACvC,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/id.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 生成唯一 ID
+ * 使用时间戳 + 随机字符串的组合
+ */
+export declare function generateId(): string;
+/**
+ * 生成工作区 ID
+ */
+export declare function generateWorkspaceId(): string;
+/**
+ * 生成节点 ID
+ */
+export declare function generateNodeId(): string;
+/**
+ * 生成备忘 ID
+ */
+export declare function generateMemoId(): string;
+/**
+ * 从 ID 中提取短 ID（时间戳部分，8位）
+ * @param id 完整 ID（如 ws-mjb65az5-0wcjuu 或 node-mjb6mj4h-a60yht 或 memo-mjktac6h-49y2xe）
+ * @returns 短 ID（如 mjb65az5）
+ */
+export declare function extractShortId(id: string): string;
+/**
+ * 清理名称，移除文件系统不安全的字符
+ * 保留中文、字母、数字、下划线、短横线、空格
+ */
+export declare function sanitizeName(name: string): string;
+/**
+ * 生成工作区目录名
+ * 格式：{sanitized_name}_{short_id}
+ * 示例：UI优化_mjb65az5
+ */
+export declare function generateWorkspaceDirName(name: string, workspaceId: string): string;
+/**
+ * 生成节点目录名
+ * 格式：{sanitized_title}_{short_id}
+ * 示例：功能分析_mjb6mj4h
+ * 注意：根节点 "root" 保持不变
+ */
+export declare function generateNodeDirName(title: string, nodeId: string): string;
+/**
+ * 生成备忘目录名
+ * 格式：{sanitized_title}_{short_id}
+ * 示例：长备忘_mjktac6h
+ */
+export declare function generateMemoDirName(title: string, memoId: string): string;
+/**
+ * 从目录名中提取短 ID
+ * @param dirName 目录名（如 UI优化_mjb65az5）
+ * @returns 短 ID（如 mjb65az5）或 null
+ */
+export declare function extractShortIdFromDirName(dirName: string): string | null;
+//# sourceMappingURL=id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxE"}

package/dist/utils/id.js

@@ -0,0 +1,96 @@
+// src/utils/id.ts
+/**
+ * 生成唯一 ID
+ * 使用时间戳 + 随机字符串的组合
+ */
+export function generateId() {
+    const timestamp = Date.now().toString(36);
+    const randomPart = Math.random().toString(36).substring(2, 8);
+    return `${timestamp}-${randomPart}`;
+}
+/**
+ * 生成工作区 ID
+ */
+export function generateWorkspaceId() {
+    return `ws-${generateId()}`;
+}
+/**
+ * 生成节点 ID
+ */
+export function generateNodeId() {
+    return `node-${generateId()}`;
+}
+/**
+ * 生成备忘 ID
+ */
+export function generateMemoId() {
+    return `memo-${generateId()}`;
+}
+/**
+ * 从 ID 中提取短 ID（时间戳部分，8位）
+ * @param id 完整 ID（如 ws-mjb65az5-0wcjuu 或 node-mjb6mj4h-a60yht 或 memo-mjktac6h-49y2xe）
+ * @returns 短 ID（如 mjb65az5）
+ */
+export function extractShortId(id) {
+    // 移除前缀（ws-、node- 或 memo-），取时间戳部分
+    const withoutPrefix = id.replace(/^(ws-|node-|memo-)/, "");
+    return withoutPrefix.split("-")[0];
+}
+/**
+ * 清理名称，移除文件系统不安全的字符
+ * 保留中文、字母、数字、下划线、短横线、空格
+ */
+export function sanitizeName(name) {
+    return name
+        .replace(/[\/\\:*?"<>|]/g, "_") // 替换不安全字符为下划线
+        .replace(/\s+/g, " ") // 合并连续空格
+        .trim()
+        .substring(0, 50); // 限制长度，避免目录名过长
+}
+/**
+ * 生成工作区目录名
+ * 格式：{sanitized_name}_{short_id}
+ * 示例：UI优化_mjb65az5
+ */
+export function generateWorkspaceDirName(name, workspaceId) {
+    const shortId = extractShortId(workspaceId);
+    const safeName = sanitizeName(name);
+    return `${safeName}_${shortId}`;
+}
+/**
+ * 生成节点目录名
+ * 格式：{sanitized_title}_{short_id}
+ * 示例：功能分析_mjb6mj4h
+ * 注意：根节点 "root" 保持不变
+ */
+export function generateNodeDirName(title, nodeId) {
+    if (nodeId === "root") {
+        return "root";
+    }
+    const shortId = extractShortId(nodeId);
+    const safeTitle = sanitizeName(title);
+    return `${safeTitle}_${shortId}`;
+}
+/**
+ * 生成备忘目录名
+ * 格式：{sanitized_title}_{short_id}
+ * 示例：长备忘_mjktac6h
+ */
+export function generateMemoDirName(title, memoId) {
+    const shortId = extractShortId(memoId);
+    const safeTitle = sanitizeName(title);
+    return `${safeTitle}_${shortId}`;
+}
+/**
+ * 从目录名中提取短 ID
+ * @param dirName 目录名（如 UI优化_mjb65az5）
+ * @returns 短 ID（如 mjb65az5）或 null
+ */
+export function extractShortIdFromDirName(dirName) {
+    const lastUnderscore = dirName.lastIndexOf("_");
+    if (lastUnderscore === -1) {
+        return null;
+    }
+    return dirName.substring(lastUnderscore + 1);
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,OAAO,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,UAAU,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,iCAAiC;IACjC,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI;SACR,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAE,cAAc;SAC9C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa,SAAS;SAC1C,IAAI,EAAE;SACN,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAgB,eAAe;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,WAAmB;IACxE,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAAc;IAC/D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAAc;IAC/D,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./id.js";
+export * from "./time.js";
+export * from "./validation.js";
+export * from "./devLog.js";
+export * from "./git.js";
+export * from "./errorLogger.js";
+export * from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}