zero-workspace 0.0.2

package/dist/utils/devLog.d.ts

@@ -0,0 +1,43 @@
+interface LogContext {
+    [key: string]: unknown;
+}
+/**
+ * DEV 模式日志工具
+ * 仅在开发模式下输出，帮助调试难以定位的问题
+ */
+export declare const devLog: {
+    /**
+     * 调试信息
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * 警告信息
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * 错误信息（总是输出，但 DEV 模式下更详细）
+     */
+    error(message: string, error?: Error | unknown, context?: LogContext): void;
+    /**
+     * 文件操作错误（路径相关问题的关键日志）
+     */
+    fileError(operation: string, filePath: string, error: Error | unknown): void;
+    /**
+     * 归档路径决策日志
+     */
+    archivePath(workspaceId: string, isArchived: boolean, resolvedPath: string): void;
+    /**
+     * 工作区查找日志
+     */
+    workspaceLookup(workspaceId: string, found: boolean, status?: string): void;
+    /**
+     * Git 操作错误日志
+     */
+    gitError(operation: string, error: Error | unknown, context?: LogContext): void;
+    /**
+     * Git 操作调试日志
+     */
+    gitDebug(operation: string, context?: LogContext): void;
+};
+export {};
+//# sourceMappingURL=devLog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"devLog.d.ts","sourceRoot":"","sources":["../../src/utils/devLog.ts"],"names":[],"mappings":"AAOA,UAAU,UAAU;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;mBACY,MAAM,YAAY,UAAU,GAAG,IAAI;IAKlD;;OAEG;kBACW,MAAM,YAAY,UAAU,GAAG,IAAI;IAKjD;;OAEG;mBACY,MAAM,UAAU,KAAK,GAAG,OAAO,YAAY,UAAU,GAAG,IAAI;IAQ3E;;OAEG;yBACkB,MAAM,YAAY,MAAM,SAAS,KAAK,GAAG,OAAO,GAAG,IAAI;IAU5E;;OAEG;6BACsB,MAAM,cAAc,OAAO,gBAAgB,MAAM,GAAG,IAAI;IASjF;;OAEG;iCAC0B,MAAM,SAAS,OAAO,WAAW,MAAM,GAAG,IAAI;IAS3E;;OAEG;wBACiB,MAAM,SAAS,KAAK,GAAG,OAAO,YAAY,UAAU,GAAG,IAAI;IAW/E;;OAEG;wBACiB,MAAM,YAAY,UAAU,GAAG,IAAI;CAIxD,CAAC"}

package/dist/utils/devLog.js

@@ -0,0 +1,94 @@
+// src/utils/devLog.ts
+// DEV 模式详细日志工具
+const IS_DEV = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+/**
+ * DEV 模式日志工具
+ * 仅在开发模式下输出，帮助调试难以定位的问题
+ */
+export const devLog = {
+    /**
+     * 调试信息
+     */
+    debug(message, context) {
+        if (!IS_DEV)
+            return;
+        console.error(`[DEV:DEBUG] ${message}`, context ? JSON.stringify(context, null, 2) : "");
+    },
+    /**
+     * 警告信息
+     */
+    warn(message, context) {
+        if (!IS_DEV)
+            return;
+        console.error(`[DEV:WARN] ${message}`, context ? JSON.stringify(context, null, 2) : "");
+    },
+    /**
+     * 错误信息（总是输出，但 DEV 模式下更详细）
+     */
+    error(message, error, context) {
+        const errorInfo = error instanceof Error
+            ? { name: error.name, message: error.message, stack: IS_DEV ? error.stack : undefined }
+            : { raw: String(error) };
+        console.error(`[DEV:ERROR] ${message}`, JSON.stringify({ error: errorInfo, ...context }, null, 2));
+    },
+    /**
+     * 文件操作错误（路径相关问题的关键日志）
+     */
+    fileError(operation, filePath, error) {
+        if (!IS_DEV)
+            return;
+        const code = error?.code;
+        console.error(`[DEV:FILE] ${operation} failed`, JSON.stringify({
+            path: filePath,
+            errorCode: code,
+            message: error instanceof Error ? error.message : String(error),
+        }, null, 2));
+    },
+    /**
+     * 归档路径决策日志
+     */
+    archivePath(workspaceId, isArchived, resolvedPath) {
+        if (!IS_DEV)
+            return;
+        console.error(`[DEV:ARCHIVE] Path resolved`, JSON.stringify({
+            workspaceId,
+            isArchived,
+            resolvedPath,
+        }, null, 2));
+    },
+    /**
+     * 工作区查找日志
+     */
+    workspaceLookup(workspaceId, found, status) {
+        if (!IS_DEV)
+            return;
+        console.error(`[DEV:WORKSPACE] Lookup`, JSON.stringify({
+            workspaceId,
+            found,
+            status: status || "N/A",
+        }, null, 2));
+    },
+    /**
+     * Git 操作错误日志
+     */
+    gitError(operation, error, context) {
+        if (!IS_DEV)
+            return;
+        const errorInfo = error instanceof Error
+            ? { message: error.message, code: error.code }
+            : { raw: String(error) };
+        console.error(`[DEV:GIT] ${operation} failed`, JSON.stringify({
+            ...errorInfo,
+            ...context,
+        }, null, 2));
+    },
+    /**
+     * Git 操作调试日志
+     */
+    gitDebug(operation, context) {
+        if (!IS_DEV)
+            return;
+        console.error(`[DEV:GIT] ${operation}`, context ? JSON.stringify(context, null, 2) : "");
+    },
+};
+//# sourceMappingURL=devLog.js.map

package/dist/utils/devLog.js.map

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

package/dist/utils/errorLogger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 错误类型
+ */
+export type ErrorType = "dir_missing" | "config_corrupted" | "graph_corrupted" | "index_corrupted" | "node_corrupted" | "version_too_high" | "unknown";
+/**
+ * 记录错误日志
+ * @param errorType 错误类型
+ * @param workspaceId 工作区 ID（可选）
+ * @param message 详细错误信息
+ * @param extra 额外信息
+ */
+export declare function logError(errorType: ErrorType, workspaceId: string | undefined, message: string, extra?: Record<string, unknown>): void;
+/**
+ * 读取错误日志（用于排查）
+ * @param limit 最多返回多少行，默认 100
+ */
+export declare function readErrorLog(limit?: number): string[];
+/**
+ * 获取错误日志路径
+ */
+export declare function getErrorLogPath(): string;
+export declare const errorLogger: {
+    logError: typeof logError;
+    readErrorLog: typeof readErrorLog;
+    getErrorLogPath: typeof getErrorLogPath;
+};
+//# sourceMappingURL=errorLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errorLogger.d.ts","sourceRoot":"","sources":["../../src/utils/errorLogger.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,SAAS,CAAC;AA+Cd;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,IAAI,CAgBN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAM,GAAG,MAAM,EAAE,CAYlD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,eAAO,MAAM,WAAW;;;;CAIvB,CAAC"}

package/dist/utils/errorLogger.js

@@ -0,0 +1,105 @@
+// src/utils/errorLogger.ts
+// 错误日志记录器 - 记录运行时严重错误，方便排查
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+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 ERROR_LOG_PATH = path.join(ZERO_HOME, "error.log");
+const MAX_LOG_SIZE = 500 * 1024; // 500KB
+/**
+ * 确保日志目录存在
+ */
+function ensureLogDir() {
+    try {
+        if (!fs.existsSync(ZERO_HOME)) {
+            fs.mkdirSync(ZERO_HOME, { recursive: true });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 格式化时间戳
+ */
+function formatTimestamp() {
+    return new Date().toISOString().replace("T", " ").slice(0, 19);
+}
+/**
+ * 检查并轮转日志文件
+ * 当文件超过 MAX_LOG_SIZE 时，保留最后 50% 的内容
+ */
+function rotateLogIfNeeded() {
+    try {
+        if (!fs.existsSync(ERROR_LOG_PATH))
+            return;
+        const stats = fs.statSync(ERROR_LOG_PATH);
+        if (stats.size <= MAX_LOG_SIZE)
+            return;
+        // 读取文件，保留后半部分
+        const content = fs.readFileSync(ERROR_LOG_PATH, "utf-8");
+        const lines = content.split("\n");
+        const keepLines = lines.slice(Math.floor(lines.length / 2));
+        // 写回文件，添加轮转标记
+        const rotatedContent = `--- Log rotated at ${formatTimestamp()} ---\n${keepLines.join("\n")}`;
+        fs.writeFileSync(ERROR_LOG_PATH, rotatedContent, "utf-8");
+    }
+    catch {
+        // 轮转失败不影响主流程
+    }
+}
+/**
+ * 记录错误日志
+ * @param errorType 错误类型
+ * @param workspaceId 工作区 ID（可选）
+ * @param message 详细错误信息
+ * @param extra 额外信息
+ */
+export function logError(errorType, workspaceId, message, extra) {
+    if (!ensureLogDir())
+        return;
+    try {
+        const timestamp = formatTimestamp();
+        const wsId = workspaceId || "-";
+        const extraStr = extra ? ` | ${JSON.stringify(extra)}` : "";
+        const logLine = `${timestamp} | ${errorType} | ${wsId} | ${message}${extraStr}\n`;
+        fs.appendFileSync(ERROR_LOG_PATH, logLine, "utf-8");
+        // 检查是否需要轮转
+        rotateLogIfNeeded();
+    }
+    catch {
+        // 静默失败，不影响主流程
+    }
+}
+/**
+ * 读取错误日志（用于排查）
+ * @param limit 最多返回多少行，默认 100
+ */
+export function readErrorLog(limit = 100) {
+    try {
+        if (!fs.existsSync(ERROR_LOG_PATH))
+            return [];
+        const content = fs.readFileSync(ERROR_LOG_PATH, "utf-8");
+        const lines = content.split("\n").filter(line => line.trim());
+        // 返回最后 limit 行
+        return lines.slice(-limit);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 获取错误日志路径
+ */
+export function getErrorLogPath() {
+    return ERROR_LOG_PATH;
+}
+export const errorLogger = {
+    logError,
+    readErrorLog,
+    getErrorLogPath,
+};
+//# sourceMappingURL=errorLogger.js.map

package/dist/utils/errorLogger.js.map

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

package/dist/utils/git.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 检查当前目录是否是 git 仓库
+ */
+export declare function isGitRepo(cwd?: string): Promise<boolean>;
+/**
+ * 确保 ZeroWorkspace 目录被 git 排除
+ * 通过添加到 .git/info/exclude（不影响项目的 .gitignore）
+ */
+export declare function ensureGitExclude(cwd?: string): Promise<void>;
+/**
+ * 获取当前分支名
+ */
+export declare function getCurrentBranch(cwd?: string): Promise<string>;
+/**
+ * 检查是否有未提交的修改（包括未跟踪文件）
+ */
+export declare function hasUncommittedChanges(cwd?: string): Promise<boolean>;
+/**
+ * 检查是否有已暂存但未提交的修改
+ */
+export declare function hasStagedChanges(cwd?: string): Promise<boolean>;
+/**
+ * 列出匹配模式的分支
+ * @param pattern - 分支名模式，如 "zero_workspace/process/*"
+ */
+export declare function listBranches(pattern: string, cwd?: string): Promise<string[]>;
+/**
+ * 创建备份分支（用于保存未提交内容）
+ * 分支名格式: zero_workspace/backup/{workspaceId}/{timestamp}
+ * @returns 备份分支名
+ */
+export declare function createBackupBranch(workspaceId: string, cwd?: string): Promise<string>;
+/**
+ * 创建并切换到派发分支
+ * 分支名格式: zero_workspace/process/{workspaceId}
+ */
+export declare function createProcessBranch(workspaceId: string, cwd?: string): Promise<string>;
+/**
+ * 切换到派发分支
+ */
+export declare function checkoutProcessBranch(workspaceId: string, cwd?: string): Promise<void>;
+/**
+ * 切换到指定分支
+ */
+export declare function checkoutBranch(branchName: string, cwd?: string): Promise<void>;
+/**
+ * 获取当前 commit hash
+ */
+export declare function getCurrentCommit(cwd?: string): Promise<string>;
+/**
+ * 提交派发修改
+ * @returns commit hash
+ */
+export declare function commitDispatch(nodeId: string, title: string, cwd?: string): Promise<string>;
+/**
+ * 回滚到指定 commit
+ */
+export declare function resetToCommit(commitHash: string, cwd?: string): Promise<void>;
+/**
+ * 合并派发分支到目标分支（使用 --no-ff）
+ */
+export declare function mergeProcessBranch(workspaceId: string, targetBranch: string, cwd?: string): Promise<void>;
+/**
+ * 删除派发分支
+ */
+export declare function deleteProcessBranch(workspaceId: string, cwd?: string): Promise<void>;
+/**
+ * 删除备份分支
+ * @param timestamp - 可选，指定时间戳删除特定备份；不指定则删除该工作区所有备份
+ */
+export declare function deleteBackupBranch(workspaceId: string, timestamp?: string, cwd?: string): Promise<void>;
+/**
+ * 删除工作区相关的所有分支（备份 + 派发）
+ */
+export declare function deleteAllWorkspaceBranches(workspaceId: string, cwd?: string): Promise<void>;
+/**
+ * 检查是否有派发分支存在（用于并发检查）
+ * @returns 如果存在派发分支，返回工作区 ID；否则返回 null
+ */
+export declare function getActiveDispatchWorkspace(cwd?: string): Promise<string | null>;
+/**
+ * 获取派发分支名
+ */
+export declare function getProcessBranchName(workspaceId: string): string;
+/**
+ * 检查当前是否在派发分支上
+ */
+export declare function isOnProcessBranch(workspaceId: string, cwd?: string): Promise<boolean>;
+/**
+ * 获取两个提交之间的提交列表
+ * @returns 提交列表，每项包含 hash 和 message
+ */
+export declare function getCommitsBetween(fromCommit: string, toCommit: string, cwd?: string): Promise<Array<{
+    hash: string;
+    message: string;
+}>>;
+/**
+ * 获取未提交修改的摘要
+ */
+export declare function getUncommittedChangesSummary(cwd?: string): Promise<{
+    files: number;
+    insertions: number;
+    deletions: number;
+} | null>;
+/**
+ * Squash 合并派发分支到目标分支
+ * @returns 新的 commit hash
+ */
+export declare function squashMergeProcessBranch(workspaceId: string, targetBranch: string, commitMessage: string, cwd?: string): Promise<string>;
+/**
+ * Rebase 合并派发分支（保留独立提交，线性历史）
+ */
+export declare function rebaseMergeProcessBranch(workspaceId: string, targetBranch: string, cwd?: string): Promise<void>;
+/**
+ * Cherry-pick 派发分支的提交到工作区（不提交）
+ * @param fromCommit - 起始提交（不包含）
+ */
+export declare function cherryPickToWorkingTree(workspaceId: string, targetBranch: string, fromCommit: string, cwd?: string): Promise<void>;
+/**
+ * 获取备份分支名（最新的一个）
+ */
+export declare function getLatestBackupBranch(workspaceId: string, cwd?: string): Promise<string | null>;
+//# sourceMappingURL=git.d.ts.map

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

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