@downcity/agent 1.1.287 → 1.1.310

package/bin/workspace/WorkspacePaths.js

@@ -0,0 +1,102 @@
+/**
+ * Workspace 项目路径规则模块。
+ *
+ * 职责说明（中文）
+ * - 统一管理单个 agent 项目根目录下的静态文件、`.downcity` 目录与运行时状态文件路径。
+ * - 负责把“路径协议”集中到一个模块，避免各领域模块自行拼接字符串。
+ * - 为初始化、日志、任务与调试文件等非 Store 子系统提供一致的路径入口。
+ *
+ * 边界说明（中文）
+ * - 这里只负责路径计算，不负责目录创建、文件读写或存在性校验。
+ * - 这里描述的是单项目约定，不涉及平台级全局目录布局。
+ */
+import path from "path";
+/**
+ * 返回项目运行时状态根目录 `.downcity` 的路径。
+ */
+export function get_downcity_dir_path(cwd) {
+    return path.join(cwd, ".downcity");
+}
+/**
+ * 返回项目日志目录路径。
+ */
+export function get_logs_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), "logs");
+}
+/**
+ * 返回项目缓存目录路径。
+ *
+ * 关键点（中文）
+ * - 当前使用隐藏命名 `.cache`，避免与用户业务目录混淆。
+ */
+export function get_cache_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), ".cache");
+}
+/**
+ * 返回 profile 运行态目录路径。
+ *
+ * 关键点（中文）
+ * - 初始化流程会统一创建该目录，并在其中写入 profile 相关文件。
+ * - 单独保留目录级 API，避免调用方散落 `path.join(..., "profile")`。
+ */
+export function get_downcity_profile_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), "profile");
+}
+/**
+ * 返回 profile 主记忆文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件通常承载主画像或核心长期 profile 信息。
+ */
+export function get_downcity_profile_primary_path(cwd) {
+    return path.join(get_downcity_profile_dir_path(cwd), "Primary.md");
+}
+/**
+ * 返回 profile 补充记忆文件路径。
+ *
+ * 关键点（中文）
+ * - 该文件用于存放不适合进入主 profile 的补充材料。
+ */
+export function get_downcity_profile_other_path(cwd) {
+    return path.join(get_downcity_profile_dir_path(cwd), "other.md");
+}
+/**
+ * Plugin Schedule JSONL 路径。
+ *
+ * 关键点（中文）
+ * - 调度任务属于项目 runtime 本地状态，因此放在项目 `.downcity/` 下。
+ */
+export function get_downcity_schedule_db_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), "schedule.jsonl");
+}
+/**
+ * 返回项目运行时数据目录路径。
+ */
+export function get_downcity_data_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), "data");
+}
+/**
+ * 返回项目公开静态资源目录路径。
+ */
+export function get_downcity_public_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), "public");
+}
+/**
+ * 返回项目任务目录路径。
+ *
+ * 关键点（中文）
+ * - 该目录用于存放任务相关的本地文件与运行时数据。
+ */
+export function get_downcity_tasks_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), "task");
+}
+/**
+ * 返回项目调试目录路径。
+ *
+ * 关键点（中文）
+ * - 当前使用隐藏目录 `.debug`，避免与用户显式业务目录冲突。
+ */
+export function get_downcity_debug_dir_path(cwd) {
+    return path.join(get_downcity_dir_path(cwd), ".debug");
+}
+//# sourceMappingURL=WorkspacePaths.js.map

package/bin/workspace/WorkspacePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspacePaths.js","sourceRoot":"","sources":["../../src/workspace/WorkspacePaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,GAAW;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AACrE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,GAAW;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC"}

package/bin/workspace/file/FileActionRuntime.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 文件 action 运行时。
+ *
+ * 关键点（中文）
+ * - 三个 action 共用项目根目录校验、编码识别和结构化错误协议。
+ * - write/edit 都通过同目录临时文件实现原子替换。
+ * - edit 的全部匹配基于原始文件，并从后向前一次应用。
+ */
+import type { FileToolActionRequest, FileToolActionResult } from "../../types/workspace/FileTool.js";
+/** 执行一个文件 action。 */
+export declare function run_file_action(context: {
+    readonly rootPath: string;
+}, request: FileToolActionRequest): Promise<FileToolActionResult>;
+//# sourceMappingURL=FileActionRuntime.d.ts.map

package/bin/workspace/file/FileActionRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileActionRuntime.d.ts","sourceRoot":"","sources":["../../../src/workspace/file/FileActionRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAIV,qBAAqB,EACrB,oBAAoB,EAKrB,MAAM,+BAA+B,CAAC;AAwYvC,qBAAqB;AACrB,wBAAsB,eAAe,CACnC,OAAO,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EACtC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAe/B"}

package/bin/workspace/file/FileActionRuntime.js

@@ -0,0 +1,386 @@
+/**
+ * 文件 action 运行时。
+ *
+ * 关键点（中文）
+ * - 三个 action 共用项目根目录校验、编码识别和结构化错误协议。
+ * - write/edit 都通过同目录临时文件实现原子替换。
+ * - edit 的全部匹配基于原始文件，并从后向前一次应用。
+ */
+import { lstat, mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolve_file_tool_path } from "../../workspace/file/FilePathPolicy.js";
+import { FileToolRuntimeError, to_file_tool_failure } from "../../workspace/file/FileToolError.js";
+import { count_text_lines, create_file_sha256, decode_text_file, detect_file_mime_type, detect_image_file_mime_type, encode_text_file, is_binary_file, normalize_text_to_lf, } from "../../workspace/file/FileEncoding.js";
+import { write_file_atomically } from "../../workspace/file/FileAtomicWriter.js";
+const DEFAULT_READ_LINES = 500;
+const MAX_READ_LINES = 2_000;
+const MAX_READ_OUTPUT_BYTES = 256 * 1024;
+const MAX_FILE_BYTES = 64 * 1024 * 1024;
+const MAX_WRITE_BYTES = 1024 * 1024;
+const MAX_EDITS = 10;
+const MAX_OLD_TEXT_CHARS = 10_000;
+const MAX_NEW_TEXT_CHARS = 50_000;
+/** 判断文件是否存在。 */
+async function file_exists(file_path) {
+    try {
+        await lstat(file_path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+/** 在内存读取前限制单文件大小。 */
+async function read_limited_file(file_path) {
+    const metadata = await lstat(file_path);
+    if (metadata.size > MAX_FILE_BYTES) {
+        throw new FileToolRuntimeError({
+            error_code: "file_too_large",
+            message: `File exceeds ${MAX_FILE_BYTES} byte processing limit: ${file_path}`,
+            file_path,
+        });
+    }
+    return await readFile(file_path);
+}
+/** 把文本拆为稳定的逻辑行。 */
+function split_text_lines(content) {
+    if (content.length === 0)
+        return [];
+    const normalized = normalize_text_to_lf(content);
+    const lines = normalized.split("\n");
+    if (normalized.endsWith("\n"))
+        lines.pop();
+    return lines;
+}
+/** 执行文件读取。 */
+async function read_file_action(context, input) {
+    let file_path = "";
+    try {
+        const resolved = await resolve_file_tool_path({
+            root_path: context.rootPath,
+            file_path: input.file_path,
+            allow_missing: false,
+        });
+        file_path = resolved.file_path;
+        const buffer = await read_limited_file(file_path);
+        const total_bytes = buffer.byteLength;
+        const sha256 = create_file_sha256(buffer);
+        const image_mime_type = detect_image_file_mime_type(buffer);
+        if (image_mime_type) {
+            return {
+                success: true,
+                file_path,
+                total_bytes,
+                total_lines: 0,
+                start_line: 0,
+                end_line: -1,
+                content: "",
+                truncated: false,
+                type: "image",
+                mime_type: image_mime_type,
+                sha256,
+            };
+        }
+        const mime_type = detect_file_mime_type(file_path);
+        if (is_binary_file(buffer)) {
+            return {
+                success: true,
+                file_path,
+                total_bytes,
+                total_lines: 0,
+                start_line: 0,
+                end_line: -1,
+                content: "",
+                truncated: false,
+                type: "binary",
+                ...(mime_type ? { mime_type } : {}),
+                sha256,
+            };
+        }
+        const decoded = decode_text_file(buffer);
+        const lines = split_text_lines(decoded.content);
+        const total_lines = lines.length;
+        const offset = Math.max(0, Math.floor(input.offset ?? 0));
+        const limit = Math.min(MAX_READ_LINES, Math.max(1, Math.floor(input.limit ?? DEFAULT_READ_LINES)));
+        const selected_lines = [];
+        let output_bytes = 0;
+        const requested_end = Math.min(total_lines, offset + limit);
+        for (let index = offset; index < requested_end; index += 1) {
+            const line = lines[index] ?? "";
+            const separator_bytes = selected_lines.length > 0 ? 1 : 0;
+            const line_bytes = Buffer.byteLength(line, "utf8") + separator_bytes;
+            if (selected_lines.length === 0 && line_bytes > MAX_READ_OUTPUT_BYTES) {
+                throw new FileToolRuntimeError({
+                    error_code: "line_too_large",
+                    message: `Line ${index} exceeds the ${MAX_READ_OUTPUT_BYTES} byte read limit`,
+                    file_path,
+                });
+            }
+            if (output_bytes + line_bytes > MAX_READ_OUTPUT_BYTES)
+                break;
+            selected_lines.push(line);
+            output_bytes += line_bytes;
+        }
+        const start_line = offset;
+        const end_line = selected_lines.length > 0
+            ? offset + selected_lines.length - 1
+            : offset - 1;
+        const truncated = end_line + 1 < total_lines;
+        return {
+            success: true,
+            file_path,
+            total_bytes,
+            total_lines,
+            start_line,
+            end_line,
+            content: selected_lines.join("\n"),
+            truncated,
+            ...(truncated ? { next_offset: end_line + 1 } : {}),
+            type: "text",
+            ...(mime_type ? { mime_type } : {}),
+            encoding: decoded.encoding,
+            sha256,
+        };
+    }
+    catch (error) {
+        return to_file_tool_failure(error, file_path || undefined);
+    }
+}
+/** 执行文件写入。 */
+async function write_file_action(context, input) {
+    let file_path = "";
+    try {
+        const resolved = await resolve_file_tool_path({
+            root_path: context.rootPath,
+            file_path: input.file_path,
+            allow_missing: true,
+        });
+        file_path = resolved.file_path;
+        const normalized_content = normalize_text_to_lf(input.content);
+        const content = Buffer.from(normalized_content, "utf8");
+        if (content.byteLength > MAX_WRITE_BYTES) {
+            throw new FileToolRuntimeError({
+                error_code: "content_too_large",
+                message: `Write content exceeds ${MAX_WRITE_BYTES} bytes`,
+                file_path,
+            });
+        }
+        const existed = await file_exists(file_path);
+        if (existed && input.overwrite !== true) {
+            throw new FileToolRuntimeError({
+                error_code: "file_exists",
+                message: `File already exists; pass overwrite=true to replace it: ${file_path}`,
+                file_path,
+            });
+        }
+        const mode = existed ? (await lstat(file_path)).mode & 0o7777 : undefined;
+        await mkdir(path.dirname(file_path), { recursive: true });
+        await write_file_atomically({
+            file_path,
+            content,
+            overwrite: existed,
+            ...(typeof mode === "number" ? { mode } : {}),
+        });
+        return {
+            success: true,
+            file_path,
+            bytes_written: content.byteLength,
+            lines_written: count_text_lines(normalized_content),
+            overwritten: existed,
+            timestamp: new Date().toISOString(),
+            sha256: create_file_sha256(content),
+        };
+    }
+    catch (error) {
+        return to_file_tool_failure(error, file_path || undefined);
+    }
+}
+/** 返回字面量在文本中的全部起始位置，包含潜在重叠匹配。 */
+function find_literal_matches(content, target) {
+    const matches = [];
+    let cursor = 0;
+    while (cursor <= content.length - target.length) {
+        const position = content.indexOf(target, cursor);
+        if (position < 0)
+            break;
+        matches.push(position);
+        cursor = position + 1;
+    }
+    return matches;
+}
+/** 识别原文件使用的主要换行符。 */
+function detect_text_eol(content) {
+    if (content.includes("\r\n"))
+        return "\r\n";
+    if (content.includes("\r"))
+        return "\r";
+    return "\n";
+}
+/** 把编辑文本适配为原文件的主要换行符。 */
+function normalize_edit_eol(content, eol) {
+    return normalize_text_to_lf(content).replace(/\n/g, eol);
+}
+/** 计算字符位置对应的 0-based 行号。 */
+function resolve_line_number(content, position) {
+    return count_text_lines(content.slice(0, position));
+}
+/** 执行文件精确编辑。 */
+async function edit_file_action(context, input) {
+    let file_path = "";
+    try {
+        const resolved = await resolve_file_tool_path({
+            root_path: context.rootPath,
+            file_path: input.file_path,
+            allow_missing: false,
+        });
+        file_path = resolved.file_path;
+        if (!Array.isArray(input.edits) || input.edits.length === 0) {
+            throw new FileToolRuntimeError({
+                error_code: "no_edits",
+                message: "edits must contain at least one operation",
+                file_path,
+            });
+        }
+        if (input.edits.length > MAX_EDITS) {
+            throw new FileToolRuntimeError({
+                error_code: "too_many_edits",
+                message: `A single edit call supports at most ${MAX_EDITS} operations`,
+                file_path,
+            });
+        }
+        for (const edit of input.edits) {
+            if (edit.old_text.length === 0 ||
+                edit.old_text.length > MAX_OLD_TEXT_CHARS ||
+                edit.new_text.length > MAX_NEW_TEXT_CHARS) {
+                throw new FileToolRuntimeError({
+                    error_code: "edit_too_large",
+                    message: `Each old_text must contain 1-${MAX_OLD_TEXT_CHARS} characters and new_text at most ${MAX_NEW_TEXT_CHARS} characters`,
+                    file_path,
+                });
+            }
+        }
+        const buffer = await read_limited_file(file_path);
+        if (is_binary_file(buffer)) {
+            throw new FileToolRuntimeError({
+                error_code: "binary_file",
+                message: `Cannot edit a binary file: ${file_path}`,
+                file_path,
+            });
+        }
+        const previous_sha256 = create_file_sha256(buffer);
+        const expected_sha256 = String(input.expected_sha256 || "").trim().toLowerCase();
+        if (expected_sha256 && expected_sha256 !== previous_sha256) {
+            throw new FileToolRuntimeError({
+                error_code: "file_changed",
+                message: `File changed since it was read: ${file_path}`,
+                file_path,
+            });
+        }
+        const decoded = decode_text_file(buffer);
+        const original_content = decoded.content;
+        const eol = detect_text_eol(original_content);
+        const matches = input.edits.map((edit, index) => {
+            const old_text = normalize_edit_eol(edit.old_text, eol);
+            const new_text = normalize_edit_eol(edit.new_text, eol);
+            const positions = find_literal_matches(original_content, old_text);
+            const detail = {
+                index,
+                status: positions.length === 0
+                    ? "not_found"
+                    : positions.length > 1
+                        ? "duplicate"
+                        : "applied",
+                match_count: positions.length,
+                ...(positions.length === 1
+                    ? { line_start: resolve_line_number(original_content, positions[0]) }
+                    : {}),
+            };
+            return {
+                index,
+                old_text,
+                new_text,
+                start: positions[0] ?? -1,
+                end: positions.length === 1 ? positions[0] + old_text.length : -1,
+                detail,
+            };
+        });
+        const invalid_match = matches.find((item) => item.detail.status !== "applied");
+        if (invalid_match) {
+            throw new FileToolRuntimeError({
+                error_code: invalid_match.detail.status === "duplicate"
+                    ? "duplicate_match"
+                    : "not_found",
+                message: invalid_match.detail.status === "duplicate"
+                    ? `edits[${invalid_match.index}].old_text matched ${invalid_match.detail.match_count} times`
+                    : `edits[${invalid_match.index}].old_text was not found`,
+                file_path,
+                details: matches.map((item) => item.detail),
+            });
+        }
+        const sorted_matches = [...matches].sort((left, right) => left.start - right.start);
+        for (let index = 0; index < sorted_matches.length - 1; index += 1) {
+            if (sorted_matches[index].end > sorted_matches[index + 1].start) {
+                throw new FileToolRuntimeError({
+                    error_code: "overlapping_edits",
+                    message: "Edit regions overlap; merge nearby changes into one edit",
+                    file_path,
+                    details: matches.map((item) => item.detail),
+                });
+            }
+        }
+        let next_content = original_content;
+        for (const match of [...sorted_matches].reverse()) {
+            next_content =
+                next_content.slice(0, match.start) +
+                    match.new_text +
+                    next_content.slice(match.end);
+        }
+        const next_buffer = encode_text_file(next_content, decoded.encoding);
+        if (next_buffer.byteLength > MAX_FILE_BYTES) {
+            throw new FileToolRuntimeError({
+                error_code: "content_too_large",
+                message: `Edited file exceeds ${MAX_FILE_BYTES} bytes`,
+                file_path,
+            });
+        }
+        const mode = (await lstat(file_path)).mode & 0o7777;
+        await write_file_atomically({
+            file_path,
+            content: next_buffer,
+            overwrite: true,
+            mode,
+        });
+        return {
+            success: true,
+            file_path,
+            applied: matches.length,
+            details: matches.map((item) => item.detail),
+            new_total_lines: count_text_lines(next_content),
+            previous_sha256,
+            sha256: create_file_sha256(next_buffer),
+        };
+    }
+    catch (error) {
+        return to_file_tool_failure(error, file_path || undefined);
+    }
+}
+/** 执行一个文件 action。 */
+export async function run_file_action(context, request) {
+    switch (request.action) {
+        case "read":
+            return await read_file_action(context, request.input);
+        case "write":
+            return await write_file_action(context, request.input);
+        case "edit":
+            return await edit_file_action(context, request.input);
+        default:
+            return {
+                success: false,
+                error_code: "internal_error",
+                message: `Unknown file action: ${String(request.action)}`,
+            };
+    }
+}
+//# sourceMappingURL=FileActionRuntime.js.map

package/bin/workspace/file/FileActionRuntime.js.map

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

package/bin/workspace/file/FileAtomicWriter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 文件工具原子写入器。
+ *
+ * 关键点（中文）
+ * - 新文件使用 `wx` 保证不会覆盖并发创建的文件。
+ * - 覆盖文件时在同目录写临时文件，再通过 rename 原子替换。
+ * - 临时文件写入后执行 fsync，并尽力清理失败残留。
+ */
+/** 将字节内容安全写入目标文件。 */
+export declare function write_file_atomically(params: {
+    /** 已通过路径策略校验的目标绝对路径。 */
+    file_path: string;
+    /** 要写入的完整字节内容。 */
+    content: Buffer;
+    /** 是否允许替换已有文件。 */
+    overwrite: boolean;
+    /** 覆盖时需要保留的原文件权限位。 */
+    mode?: number;
+}): Promise<void>;
+//# sourceMappingURL=FileAtomicWriter.d.ts.map

package/bin/workspace/file/FileAtomicWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileAtomicWriter.d.ts","sourceRoot":"","sources":["../../../src/workspace/file/FileAtomicWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,qBAAqB;AACrB,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChB"}

package/bin/workspace/file/FileAtomicWriter.js

@@ -0,0 +1,50 @@
+/**
+ * 文件工具原子写入器。
+ *
+ * 关键点（中文）
+ * - 新文件使用 `wx` 保证不会覆盖并发创建的文件。
+ * - 覆盖文件时在同目录写临时文件，再通过 rename 原子替换。
+ * - 临时文件写入后执行 fsync，并尽力清理失败残留。
+ */
+import path from "node:path";
+import crypto from "node:crypto";
+import { chmod, open, rename, unlink } from "node:fs/promises";
+/** 将字节内容安全写入目标文件。 */
+export async function write_file_atomically(params) {
+    if (!params.overwrite) {
+        const file_handle = await open(params.file_path, "wx", params.mode ?? 0o666);
+        try {
+            await file_handle.writeFile(params.content);
+            await file_handle.sync();
+        }
+        finally {
+            await file_handle.close();
+        }
+        return;
+    }
+    const directory_path = path.dirname(params.file_path);
+    const temporary_path = path.join(directory_path, `.${path.basename(params.file_path)}.${process.pid}.${crypto.randomUUID()}.tmp`);
+    let temporary_exists = false;
+    try {
+        const file_handle = await open(temporary_path, "wx", params.mode ?? 0o666);
+        temporary_exists = true;
+        try {
+            await file_handle.writeFile(params.content);
+            await file_handle.sync();
+        }
+        finally {
+            await file_handle.close();
+        }
+        if (typeof params.mode === "number") {
+            await chmod(temporary_path, params.mode);
+        }
+        await rename(temporary_path, params.file_path);
+        temporary_exists = false;
+    }
+    finally {
+        if (temporary_exists) {
+            await unlink(temporary_path).catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=FileAtomicWriter.js.map

package/bin/workspace/file/FileAtomicWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileAtomicWriter.js","sourceRoot":"","sources":["../../../src/workspace/file/FileAtomicWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/D,qBAAqB;AACrB,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAS3C;IACC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QAC7E,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAC9B,cAAc,EACd,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,MAAM,CAChF,CAAC;IACF,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QAC3E,gBAAgB,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,gBAAgB,GAAG,KAAK,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC"}

package/bin/workspace/file/FileEncoding.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 文件内容检测与编码辅助。
+ *
+ * 关键点（中文）
+ * - 二进制检测只把 NUL 和低位控制字符视为高风险，避免误判 UTF-8 中文。
+ * - 文本解码使用 fatal 模式，禁止静默插入替换字符。
+ * - 第一版仅接受 UTF-8 和带 BOM 的 UTF-16 文本。
+ */
+/** 支持的文本编码。 */
+export type SupportedFileEncoding = "utf-8" | "utf-16le" | "utf-16be";
+/** 计算文件内容的 SHA-256。 */
+export declare function create_file_sha256(content: Uint8Array | string): string;
+/** 根据 BOM 判断文本编码。 */
+export declare function detect_text_encoding(buffer: Buffer): SupportedFileEncoding;
+/** 保守判断一个文件是否为二进制。 */
+export declare function is_binary_file(buffer: Buffer): boolean;
+/** 根据文件签名识别模型可直接读取的静态图片 MIME。 */
+export declare function detect_image_file_mime_type(buffer: Buffer): string | undefined;
+/** 严格解码文本文件。 */
+export declare function decode_text_file(buffer: Buffer): {
+    /** 解码后的文本。 */
+    content: string;
+    /** 实际采用的文本编码。 */
+    encoding: SupportedFileEncoding;
+};
+/** 按原文本编码重新编码内容，并保留 UTF-16 BOM。 */
+export declare function encode_text_file(content: string, encoding: SupportedFileEncoding): Buffer;
+/** 把调用方文本统一为 LF 换行。 */
+export declare function normalize_text_to_lf(content: string): string;
+/** 统计可见文本行数，不把尾随换行后的空位置计为新行。 */
+export declare function count_text_lines(content: string): number;
+/** 根据扩展名识别常见 MIME 类型。 */
+export declare function detect_file_mime_type(file_path: string): string | undefined;
+//# sourceMappingURL=FileEncoding.d.ts.map

package/bin/workspace/file/FileEncoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileEncoding.d.ts","sourceRoot":"","sources":["../../../src/workspace/file/FileEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,eAAe;AACf,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;AAEtE,uBAAuB;AACvB,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAEvE;AAED,qBAAqB;AACrB,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAQ1E;AAED,sBAAsB;AACtB,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAatD;AAED,iCAAiC;AACjC,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkC9E;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAChD,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,QAAQ,EAAE,qBAAqB,CAAC;CACjC,CAcA;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,CAaR;AAED,uBAAuB;AACvB,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,yBAAyB;AACzB,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+B3E"}