zero-workspace 0.0.2

package/dist/storage/FileSystemAdapter.js

@@ -0,0 +1,384 @@
+// src/storage/FileSystemAdapter.ts
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { devLog } from "../utils/devLog.js";
+/**
+ * 判断是否为开发模式
+ */
+function isDevelopment() {
+    return process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+}
+/**
+ * 文件系统适配器
+ * 负责底层文件操作，封装路径管理
+ *
+ * 架构：
+ * - 全局索引：~/.zero-workspace[-dev]/index.json
+ * - 项目数据：{projectRoot}/.zero-workspace[-dev]/{wsDirName}/
+ *
+ * 目录命名规范（v2）：
+ * - 工作区目录：{名称}_{短ID}，如 "UI优化_mjb65az5"
+ * - 节点目录：{标题}_{短ID}，如 "功能分析_mjb6mj4h"
+ * - 根节点目录固定为 "root"
+ */
+export class FileSystemAdapter {
+    globalBasePath;
+    localDirName;
+    constructor() {
+        // 根据环境选择目录名
+        const suffix = isDevelopment() ? "-dev" : "";
+        this.localDirName = `.zero-workspace${suffix}`;
+        // 全局索引目录（用户主目录下）
+        this.globalBasePath = path.join(os.homedir(), this.localDirName);
+    }
+    /**
+     * 是否为开发模式
+     */
+    isDev() {
+        return isDevelopment();
+    }
+    /**
+     * 获取目录名（供外部使用）
+     */
+    getDirName() {
+        return this.localDirName;
+    }
+    // ========== 全局路径方法 ==========
+    /**
+     * 获取全局基础路径
+     */
+    getGlobalBasePath() {
+        return this.globalBasePath;
+    }
+    /**
+     * 获取全局索引文件路径
+     */
+    getIndexPath() {
+        return path.join(this.globalBasePath, "index.json");
+    }
+    // ========== 项目级路径方法 ==========
+    /**
+     * 获取项目内工作区根目录路径 (包含所有工作区)
+     */
+    getWorkspaceRootPath(projectRoot) {
+        return path.join(projectRoot, this.localDirName);
+    }
+    /**
+     * 获取特定工作区目录路径
+     * @param wsDirName 工作区目录名（如 "UI优化_mjb65az5"）
+     */
+    getWorkspacePath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName);
+    }
+    /**
+     * 获取工作区配置文件路径
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceConfigPath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "workspace.json");
+    }
+    /**
+     * 获取节点图文件路径
+     * @param wsDirName 工作区目录名
+     */
+    getGraphPath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "graph.json");
+    }
+    /**
+     * 获取工作区 Markdown 文件路径
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceMdPath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "Workspace.md");
+    }
+    /**
+     * 获取工作区日志文件路径
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceLogPath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "Log.md");
+    }
+    /**
+     * 获取工作区问题文件路径
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceProblemPath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "Problem.md");
+    }
+    /**
+     * 获取节点目录路径
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名（如 "功能分析_mjb6mj4h" 或 "root"）
+     */
+    getNodePath(projectRoot, wsDirName, nodeDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "nodes", nodeDirName);
+    }
+    /**
+     * 获取节点 Info.md 文件路径
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名
+     */
+    getNodeInfoPath(projectRoot, wsDirName, nodeDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "nodes", nodeDirName, "Info.md");
+    }
+    /**
+     * 获取节点日志文件路径
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名
+     */
+    getNodeLogPath(projectRoot, wsDirName, nodeDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "nodes", nodeDirName, "Log.md");
+    }
+    /**
+     * 获取节点问题文件路径
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名
+     */
+    getNodeProblemPath(projectRoot, wsDirName, nodeDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "nodes", nodeDirName, "Problem.md");
+    }
+    /**
+     * 获取节点目录路径 (nodes/)
+     * @param wsDirName 工作区目录名
+     */
+    getNodesDir(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "nodes");
+    }
+    // ========== 备忘路径方法 ==========
+    /**
+     * 获取备忘目录路径
+     * @param wsDirName 工作区目录名
+     * @param memoDirName 备忘目录名（格式：{title}_{shortId}）
+     */
+    getMemoDir(projectRoot, wsDirName, memoDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "memos", memoDirName);
+    }
+    /**
+     * 获取备忘内容文件路径
+     * @param wsDirName 工作区目录名
+     * @param memoDirName 备忘目录名（格式：{title}_{shortId}）
+     */
+    getMemoContentPath(projectRoot, wsDirName, memoDirName) {
+        return path.join(projectRoot, this.localDirName, wsDirName, "memos", memoDirName, "Content.md");
+    }
+    // ========== 归档路径方法 ==========
+    /**
+     * 获取归档目录路径
+     */
+    getArchiveDir(projectRoot) {
+        return path.join(projectRoot, this.localDirName, "archive");
+    }
+    /**
+     * 获取归档工作区目录路径
+     * @param wsDirName 工作区目录名
+     */
+    getArchivePath(projectRoot, wsDirName) {
+        return path.join(projectRoot, this.localDirName, "archive", wsDirName);
+    }
+    /**
+     * 获取工作区基础路径（根据归档状态返回正确路径）
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceBasePath(projectRoot, wsDirName, isArchived) {
+        if (isArchived) {
+            return this.getArchivePath(projectRoot, wsDirName);
+        }
+        return this.getWorkspacePath(projectRoot, wsDirName);
+    }
+    /**
+     * 获取节点图文件路径（支持归档）
+     * @param wsDirName 工作区目录名
+     */
+    getGraphPathWithArchive(projectRoot, wsDirName, isArchived) {
+        const basePath = this.getWorkspaceBasePath(projectRoot, wsDirName, isArchived);
+        return path.join(basePath, "graph.json");
+    }
+    /**
+     * 获取工作区 Markdown 文件路径（支持归档）
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceMdPathWithArchive(projectRoot, wsDirName, isArchived) {
+        const basePath = this.getWorkspaceBasePath(projectRoot, wsDirName, isArchived);
+        return path.join(basePath, "Workspace.md");
+    }
+    /**
+     * 获取节点 Info.md 文件路径（支持归档）
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名
+     */
+    getNodeInfoPathWithArchive(projectRoot, wsDirName, nodeDirName, isArchived) {
+        const basePath = this.getWorkspaceBasePath(projectRoot, wsDirName, isArchived);
+        return path.join(basePath, "nodes", nodeDirName, "Info.md");
+    }
+    /**
+     * 获取节点日志文件路径（支持归档）
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名
+     */
+    getNodeLogPathWithArchive(projectRoot, wsDirName, nodeDirName, isArchived) {
+        const basePath = this.getWorkspaceBasePath(projectRoot, wsDirName, isArchived);
+        return path.join(basePath, "nodes", nodeDirName, "Log.md");
+    }
+    /**
+     * 获取节点问题文件路径（支持归档）
+     * @param wsDirName 工作区目录名
+     * @param nodeDirName 节点目录名
+     */
+    getNodeProblemPathWithArchive(projectRoot, wsDirName, nodeDirName, isArchived) {
+        const basePath = this.getWorkspaceBasePath(projectRoot, wsDirName, isArchived);
+        return path.join(basePath, "nodes", nodeDirName, "Problem.md");
+    }
+    /**
+     * 获取工作区问题文件路径（支持归档）
+     * @param wsDirName 工作区目录名
+     */
+    getWorkspaceProblemPathWithArchive(projectRoot, wsDirName, isArchived) {
+        const basePath = this.getWorkspaceBasePath(projectRoot, wsDirName, isArchived);
+        return path.join(basePath, "Problem.md");
+    }
+    // ========== 文件操作 ==========
+    /**
+     * 检查路径是否存在
+     */
+    async exists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 创建目录（递归）
+     */
+    async mkdir(dirPath) {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    /**
+     * 删除目录（递归）
+     */
+    async rmdir(dirPath) {
+        await fs.rm(dirPath, { recursive: true, force: true });
+    }
+    /**
+     * 读取文件内容
+     */
+    async readFile(filePath) {
+        try {
+            return await fs.readFile(filePath, "utf-8");
+        }
+        catch (error) {
+            devLog.fileError("readFile", filePath, error);
+            throw error;
+        }
+    }
+    /**
+     * 读取目录内容
+     */
+    async readdir(dirPath) {
+        try {
+            return await fs.readdir(dirPath);
+        }
+        catch (error) {
+            devLog.fileError("readdir", dirPath, error);
+            throw error;
+        }
+    }
+    /**
+     * 写入文件（原子写入：先写临时文件再重命名）
+     */
+    async writeFile(filePath, content) {
+        const dir = path.dirname(filePath);
+        await this.mkdir(dir);
+        const tempPath = `${filePath}.tmp`;
+        await fs.writeFile(tempPath, content, "utf-8");
+        await fs.rename(tempPath, filePath);
+    }
+    /**
+     * 删除文件
+     */
+    async deleteFile(filePath) {
+        await fs.unlink(filePath);
+    }
+    /**
+     * 确保目录存在（通用方法）
+     */
+    async ensureDir(dirPath) {
+        await this.mkdir(dirPath);
+    }
+    /**
+     * 删除目录或文件（通用方法）
+     */
+    async remove(targetPath) {
+        await this.rmdir(targetPath);
+    }
+    // ========== 初始化 ==========
+    /**
+     * 确保全局基础目录存在
+     */
+    async ensureGlobalDir() {
+        await this.mkdir(this.globalBasePath);
+    }
+    /**
+     * 确保项目内工作区根目录存在
+     */
+    async ensureProjectDir(projectRoot) {
+        await this.mkdir(this.getWorkspaceRootPath(projectRoot));
+    }
+    /**
+     * 确保特定工作区目录存在
+     * @param wsDirName 工作区目录名
+     */
+    async ensureWorkspaceDir(projectRoot, wsDirName) {
+        await this.mkdir(this.getWorkspacePath(projectRoot, wsDirName));
+    }
+    /**
+     * 确保归档目录存在
+     */
+    async ensureArchiveDir(projectRoot) {
+        await this.mkdir(this.getArchiveDir(projectRoot));
+    }
+    /**
+     * 移动目录
+     */
+    async moveDir(src, dest) {
+        await fs.rename(src, dest);
+    }
+    /**
+     * 安全重命名目录（处理名称冲突）
+     * @returns 实际使用的新目录名（可能带序号后缀）
+     */
+    async safeRenameDir(src, destDir, newName) {
+        let finalName = newName;
+        let destPath = path.join(destDir, finalName);
+        let counter = 1;
+        // 如果目标已存在且不是源目录本身，添加序号
+        while (await this.exists(destPath) && destPath !== src) {
+            finalName = `${newName}_${counter}`;
+            destPath = path.join(destDir, finalName);
+            counter++;
+        }
+        // 如果源和目标相同，无需操作
+        if (destPath === src) {
+            return finalName;
+        }
+        await fs.rename(src, destPath);
+        return finalName;
+    }
+    /**
+     * 初始化空的全局索引文件（如果不存在）
+     */
+    async ensureIndex() {
+        await this.ensureGlobalDir();
+        const indexPath = this.getIndexPath();
+        if (!(await this.exists(indexPath))) {
+            await this.writeFile(indexPath, JSON.stringify({
+                version: "2.0",
+                workspaces: []
+            }, null, 2));
+        }
+    }
+}
+//# sourceMappingURL=FileSystemAdapter.js.map

package/dist/storage/FileSystemAdapter.js.map

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

package/dist/storage/JsonStorage.d.ts

@@ -0,0 +1,158 @@
+import type { FileSystemAdapter } from "./FileSystemAdapter.js";
+import type { WorkspaceIndex, WorkspaceConfig, WorkspaceEntry } from "../types/workspace.js";
+import type { NodeGraph } from "../types/node.js";
+/**
+ * JSON 存储封装
+ * 提供类型安全的 JSON 文件读写
+ *
+ * 架构：
+ * - 全局索引：~/.zero-workspace[-dev]/index.json
+ * - 项目数据：{projectRoot}/.zero-workspace[-dev]/{wsDirName}/
+ *
+ * 目录命名规范（v2）：
+ * - 工作区目录：{名称}_{短ID}，如 "UI优化_mjb65az5"
+ * - 节点目录：{标题}_{短ID}，如 "功能分析_mjb6mj4h"
+ * - 根节点目录固定为 "root"
+ */
+export declare class JsonStorage {
+    private fs;
+    private currentCodeVersion;
+    constructor(fs: FileSystemAdapter);
+    /**
+     * 获取当前代码版本（从 package.json 读取）
+     * ESM 兼容写法
+     */
+    getCurrentCodeVersion(): string;
+    /**
+     * 统一存储版本（index.json 和 graph.json 共享）
+     * - 1.0: 初始版本
+     * - 2.0: index 添加 projectRoot
+     * - 3.0: 添加节点 type 字段
+     * - 4.0: 添加 dirName 字段（UUID 格式）
+     * - 5.0: dirName 改为可读格式（名称_短ID）
+     */
+    static readonly STORAGE_VERSION = "5.0";
+    /**
+     * 读取全局工作区索引
+     */
+    readIndex(): Promise<WorkspaceIndex>;
+    /**
+     * 备份高版本 index 并重置
+     */
+    private backupAndResetIndex;
+    /**
+     * 比较版本号
+     * @returns >0 表示 a > b, <0 表示 a < b, =0 表示相等
+     */
+    private compareVersion;
+    /**
+     * 全量迁移：index + 所有工作区的 graph.json + 目录重命名
+     * 在 readIndex 时一次性完成，避免分散迁移导致遗漏
+     */
+    private migrateAll;
+    /**
+     * 迁移工作区目录名（UUID → 可读名称）
+     * @returns 新的目录名，如果无需迁移返回 undefined
+     */
+    private migrateWorkspaceDir;
+    /**
+     * 迁移单个工作区的 graph.json（包括节点目录重命名）
+     */
+    private migrateWorkspaceGraph;
+    /**
+     * 迁移节点目录名（UUID → 可读名称）
+     */
+    private migrateNodeDirs;
+    /**
+     * 从 Info.md 读取节点标题
+     */
+    private readNodeTitle;
+    /**
+     * 在目录中查找包含指定短 ID 的子目录
+     * 按优先级尝试多种匹配模式，提高兼容性
+     */
+    private findDirBySuffix;
+    /**
+     * 迁移 index 数据（纯数据操作）
+     * 注意：dirName 已在 migrateWorkspaceDir 中设置为可读名称
+     */
+    private migrateIndexData;
+    /**
+     * 写入全局工作区索引
+     */
+    writeIndex(index: WorkspaceIndex): Promise<void>;
+    /**
+     * 根据 workspaceId 查找工作区条目
+     */
+    findWorkspaceEntry(workspaceId: string): Promise<WorkspaceEntry | null>;
+    /**
+     * 根据 workspaceId 获取 projectRoot
+     */
+    getProjectRoot(workspaceId: string): Promise<string | null>;
+    /**
+     * 根据 workspaceId 获取 projectRoot 和 dirName
+     */
+    getWorkspaceLocation(workspaceId: string): Promise<{
+        projectRoot: string;
+        dirName: string;
+    } | null>;
+    /**
+     * 验证索引中的工作区路径是否有效
+     * 返回无效的工作区列表
+     */
+    validateIndexPaths(): Promise<WorkspaceEntry[]>;
+    /**
+     * 清理索引中无效的工作区条目
+     */
+    cleanupInvalidEntries(): Promise<string[]>;
+    /**
+     * 检查特定项目下是否存在同名工作区
+     */
+    hasWorkspaceByName(projectRoot: string, name: string): Promise<boolean>;
+    /**
+     * 获取工作区配置文件路径（根据是否归档）
+     * @param wsDirName 工作区目录名
+     */
+    private getConfigPath;
+    /**
+     * 读取工作区配置
+     * @param projectRoot 项目根目录
+     * @param wsDirName 工作区目录名
+     * @param isArchived 是否从归档目录读取
+     */
+    readWorkspaceConfig(projectRoot: string, wsDirName: string, isArchived?: boolean): Promise<WorkspaceConfig>;
+    /**
+     * 写入工作区配置
+     * @param projectRoot 项目根目录
+     * @param wsDirName 工作区目录名
+     * @param config 工作区配置
+     * @param isArchived 是否写入归档目录
+     */
+    writeWorkspaceConfig(projectRoot: string, wsDirName: string, config: WorkspaceConfig, isArchived?: boolean): Promise<void>;
+    /**
+     * 检查特定工作区是否存在
+     * @param wsDirName 工作区目录名
+     */
+    hasWorkspace(projectRoot: string, wsDirName: string): Promise<boolean>;
+    /**
+     * 读取节点图
+     * @param projectRoot 项目根目录
+     * @param wsDirName 工作区目录名
+     * @param isArchived 是否为归档工作区
+     */
+    readGraph(projectRoot: string, wsDirName: string, isArchived?: boolean): Promise<NodeGraph>;
+    /**
+     * 迁移 graph 数据（纯数据操作）
+     * - 1.0/2.0 节点没有 type 字段，需要推断
+     * - 3.0 节点没有 dirName 字段，需要从 id 推导
+     */
+    private migrateGraphData;
+    /**
+     * 写入节点图
+     * @param projectRoot 项目根目录
+     * @param wsDirName 工作区目录名
+     * @param graph 节点图
+     */
+    writeGraph(projectRoot: string, wsDirName: string, graph: NodeGraph): Promise<void>;
+}
+//# sourceMappingURL=JsonStorage.d.ts.map

package/dist/storage/JsonStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonStorage.d.ts","sourceRoot":"","sources":["../../src/storage/JsonStorage.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,EAAE;IAFtB,OAAO,CAAC,kBAAkB,CAAuB;gBAE7B,EAAE,EAAE,iBAAiB;IAEzC;;;OAGG;IACH,qBAAqB,IAAI,MAAM;IAgB/B;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,eAAe,SAAS;IAExC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAiC1C;;OAEG;YACW,mBAAmB;IAqBjC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB;;;OAGG;YACW,UAAU;IA4CxB;;;OAGG;YACW,mBAAmB;IA8CjC;;OAEG;YACW,qBAAqB;IAiCnC;;OAEG;YACW,eAAe;IAgF7B;;OAEG;YACW,aAAa;IAkB3B;;;OAGG;YACW,eAAe;IAkC7B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK7E;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKjE;;OAEG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IASzG;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBrD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYhD;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS7E;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;IAM/G;;;;;;OAMG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9H;;;OAGG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO5E;;;;;OAKG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAqD/F;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;;;;OAKG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB1F"}