@trim21/personal-pi-extensions 0.0.314 → 0.0.316

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.0.314",
+  "version": "0.0.316",
   "type": "module",
   "description": "Custom pi coding-agent extensions: bwrap sandbox, workspace guard, opencode edit, and more",
   "keywords": [

package/src/claude-code/files.ts

@@ -15,7 +15,6 @@ import {
 import { Type } from "typebox";
 
 import { createLspService, initLsp, type LspService } from "../lib/lsp/lsp.js";
-import { type ToolPendant } from "../lib/pendant.js";
 import { guardWriteAccess } from "../lib/write-guard.js";
 import {
   type ClaudeCodeState,
@@ -46,43 +45,6 @@ function formatFileSize(bytes: number): string {
   return `${(bytes / 1024 / 1024 / 1024).toFixed(1)} GB`;
 }
 
-/** Edit/Write 结果的可折叠面板：diff（```diff 代码块）+ LSP errors（有则显示）。 */
-export function buildEditPendant(options: {
-  filePath: string;
-  diff: string;
-  diagnosticText: string;
-}): ToolPendant {
-  const lines = [`## Diff — \`${options.filePath}\``, "", "```diff", options.diff, "```"];
-  if (options.diagnosticText !== "") {
-    lines.push("", "## LSP errors", "", "```text", options.diagnosticText, "```");
-  }
-  return { markdown: lines.join("\n"), expanded: true };
-}
-
-/** Read 结果的可折叠面板：路径、总行数、读取范围与文件大小。 */
-export function buildReadPendant(options: {
-  filePath: string;
-  byteSize: number;
-  offset?: number;
-  limit?: number;
-  totalLines?: number;
-  type?: string;
-}): ToolPendant {
-  const lines = ["## Read", "", `- **Path**: \`${options.filePath}\``];
-  if (options.type) lines.push(`- **Type**: ${options.type}`);
-  if (options.totalLines !== undefined) {
-    const start = options.offset ?? 1;
-    const end = Math.min(
-      options.limit === undefined ? options.totalLines : start + options.limit - 1,
-      options.totalLines,
-    );
-    lines.push(`- **Total lines**: ${options.totalLines}`);
-    if (start <= end) lines.push(`- **Range**: ${start}-${end}`);
-  }
-  lines.push(`- **Size**: ${formatFileSize(options.byteSize)}`);
-  return { markdown: lines.join("\n"), expanded: false };
-}
-
 /** Tool guidance, kept in markdown so it reads like documentation. */
 const READ_PROMPT = readFileSync(fileURLToPath(new URL("read.md", import.meta.url)), "utf8").trim();
 const EDIT_PROMPT = readFileSync(fileURLToPath(new URL("edit.md", import.meta.url)), "utf8").trim();
@@ -107,8 +69,6 @@ export interface FileToolDetails {
    * session 文件，resume 后由 session_start 重建 reads state。
    */
   reads?: Record<string, FileSnapshot>;
-  /** 可折叠的 diff / LSP 结果面板（pi TUI 渲染）。 */
-  pendant?: ToolPendant;
 }
 
 function snapshotOf(content: Uint8Array | string, textEditable = true): FileSnapshot {
@@ -326,17 +286,7 @@ export function registerFileTools(
         const snapshot = snapshotOf(image, false);
         const key = await readStateKey(filePath);
         state.reads.set(key, snapshot);
-        return {
-          content,
-          details: {
-            reads: { [key]: snapshot },
-            pendant: buildReadPendant({
-              filePath,
-              byteSize: image.length,
-              type: imageMime,
-            }),
-          },
-        };
+        return { content, details: { reads: { [key]: snapshot } } };
       }
 
       const buffer = await readFile(filePath);
@@ -366,16 +316,7 @@ export function registerFileTools(
       });
       return {
         content: [{ type: "text", text: formatted.text }],
-        details: {
-          reads: { [key]: snapshot },
-          pendant: buildReadPendant({
-            filePath,
-            byteSize: buffer.length,
-            offset: params.offset ?? 1,
-            limit: params.limit,
-            totalLines: formatted.totalLines,
-          }),
-        },
+        details: { reads: { [key]: snapshot } },
       };
     },
   });
@@ -416,143 +357,135 @@ export function registerFileTools(
           replaceAll: params.replace_all,
         },
       });
-      const [message, details] = await withFileMutationQueue<[string, FileToolDetails]>(
-        filePath,
-        async () => {
-          const oldString = params.old_string;
-          const newString = params.new_string;
-          if (oldString === newString) {
-            throw new Error("No changes to make: old_string and new_string are exactly the same.");
-          }
-          // 空 old_string：创建新文件或填充空文件（不需要先 Read，对齐 Claude Code）
-          if (oldString === "") {
-            let exists = true;
-            try {
-              const value = await stat(filePath);
-              if (value.isFile()) {
-                const content = await readFile(filePath, "utf8");
-                if (content.trim() !== "") {
-                  throw new Error("Cannot create new file - file already exists.");
-                }
-              }
-            } catch (error) {
-              if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-                exists = false;
-              } else {
-                throw error;
-              }
-            }
-            if (!exists) await mkdir(dirname(filePath), { recursive: true });
-            await writeFile(filePath, newString, "utf8");
-            const snapshot = snapshotOf(newString);
-            const key = await readStateKey(filePath);
-            state.reads.set(key, snapshot);
-            const diff = generateDiffString("", newString);
-            return [
-              `The file ${filePath} has been updated successfully.`,
-              {
-                diff: diff.diff,
-                patch: generateUnifiedPatch(filePath, "", newString),
-                firstChangedLine: diff.firstChangedLine,
-                reads: { [key]: snapshot },
-              },
-            ];
-          }
-          const replaceAll = params.replace_all ?? false;
-          // 防止 OOM 的大文件检查（对齐 Claude Code）
+      const [message, details, diagnosticText] = await withFileMutationQueue<
+        [string, FileToolDetails, string]
+      >(filePath, async () => {
+        const oldString = params.old_string;
+        const newString = params.new_string;
+        if (oldString === newString) {
+          throw new Error("No changes to make: old_string and new_string are exactly the same.");
+        }
+        // 空 old_string：创建新文件或填充空文件（不需要先 Read，对齐 Claude Code）
+        if (oldString === "") {
+          let exists = true;
           try {
-            const { size } = await stat(filePath);
-            if (size > MAX_EDIT_FILE_SIZE) {
-              throw new Error(
-                `File is too large to edit (${formatFileSize(size)}). Maximum editable file size is ${formatFileSize(MAX_EDIT_FILE_SIZE)}.`,
-              );
-            }
-          } catch (error) {
-            if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
-              throw error;
+            const value = await stat(filePath);
+            if (value.isFile()) {
+              const content = await readFile(filePath, "utf8");
+              if (content.trim() !== "") {
+                throw new Error("Cannot create new file - file already exists.");
+              }
             }
-          }
-          let content: Buffer;
-          try {
-            content = await readFile(filePath);
           } catch (error) {
             if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-              const suggestion = await didYouMean(filePath, ctx.cwd);
-              throw new Error(
-                `File does not exist. Note: your current working directory is ${ctx.cwd}.${suggestion ? ` Did you mean ${suggestion}?` : ""}`,
-                { cause: error },
-              );
+              exists = false;
+            } else {
+              throw error;
             }
-            throw error;
-          }
-          if (extname(filePath).toLowerCase() === ".ipynb") {
-            throw new Error(
-              "File is a Jupyter Notebook. Use the NotebookEditTool to edit this file.",
-            );
           }
+          if (!exists) await mkdir(dirname(filePath), { recursive: true });
+          await writeFile(filePath, newString, "utf8");
+          const snapshot = snapshotOf(newString);
           const key = await readStateKey(filePath);
-          requireCurrentRead(state, key, filePath, content);
-          await access(filePath, constants.R_OK | constants.W_OK);
-          throwIfAborted(signal);
-          const original = content.toString("utf8");
-
-          // CRLF 规范化后匹配（old_string 不需要带 \r），写回时恢复原行尾
-          const crlfCount = (original.match(/\r\n/g) ?? []).length;
-          const lfCount = (original.match(/(?<!\r)\n/g) ?? []).length;
-          const lineEnding = crlfCount > lfCount ? "\r\n" : "\n";
-          const normalized = original.replaceAll("\r\n", "\n");
-          const actualOldString = findActualString(normalized, oldString) ?? oldString;
-          const matches = normalized.split(actualOldString).length - 1;
-          if (matches === 0) {
-            throw new Error(`String to replace not found in file.\nString: ${oldString}`);
-          }
-          if (!replaceAll && matches > 1) {
-            throw new Error(
-              `Found ${matches} matches of the string to replace, but replace_all is false. To replace all occurrences, set replace_all to true. To replace only one occurrence, please provide more context to uniquely identify the instance.\nString: ${oldString}`,
-            );
-          }
-          const actualNewString = preserveQuoteStyle(oldString, actualOldString, newString);
-          // split/join 与函数替换：replacement 含 $ 时不会触发 $& 等特殊语义
-          const updated = replaceAll
-            ? normalized.split(actualOldString).join(actualNewString)
-            : normalized.replace(actualOldString, () => actualNewString);
-          const restored = lineEnding === "\r\n" ? updated.replaceAll("\n", "\r\n") : updated;
-          await writeFile(filePath, restored, "utf8");
-          const snapshot = snapshotOf(restored);
           state.reads.set(key, snapshot);
-          const diff = generateDiffString(original, restored);
-          const text = replaceAll
-            ? `The file ${filePath} has been updated. All occurrences were successfully replaced.`
-            : `The file ${filePath} has been updated successfully.`;
+          const diff = generateDiffString("", newString);
+          throwIfAborted(signal);
+          const diagnosticText = await service.lspDiagnosticsForFile(filePath, ctx.cwd);
           return [
-            text,
+            `The file ${filePath} has been updated successfully.`,
             {
               diff: diff.diff,
-              patch: generateUnifiedPatch(filePath, original, restored),
+              patch: generateUnifiedPatch(filePath, "", newString),
               firstChangedLine: diff.firstChangedLine,
               reads: { [key]: snapshot },
             },
+            diagnosticText,
           ];
-        },
-      );
+        }
+        const replaceAll = params.replace_all ?? false;
+        // 防止 OOM 的大文件检查（对齐 Claude Code）
+        try {
+          const { size } = await stat(filePath);
+          if (size > MAX_EDIT_FILE_SIZE) {
+            throw new Error(
+              `File is too large to edit (${formatFileSize(size)}). Maximum editable file size is ${formatFileSize(MAX_EDIT_FILE_SIZE)}.`,
+            );
+          }
+        } catch (error) {
+          if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
+            throw error;
+          }
+        }
+        let content: Buffer;
+        try {
+          content = await readFile(filePath);
+        } catch (error) {
+          if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            const suggestion = await didYouMean(filePath, ctx.cwd);
+            throw new Error(
+              `File does not exist. Note: your current working directory is ${ctx.cwd}.${suggestion ? ` Did you mean ${suggestion}?` : ""}`,
+              { cause: error },
+            );
+          }
+          throw error;
+        }
+        if (extname(filePath).toLowerCase() === ".ipynb") {
+          throw new Error(
+            "File is a Jupyter Notebook. Use the NotebookEditTool to edit this file.",
+          );
+        }
+        const key = await readStateKey(filePath);
+        requireCurrentRead(state, key, filePath, content);
+        await access(filePath, constants.R_OK | constants.W_OK);
+        throwIfAborted(signal);
+        const original = content.toString("utf8");
+
+        // CRLF 规范化后匹配（old_string 不需要带 \r），写回时恢复原行尾
+        const crlfCount = (original.match(/\r\n/g) ?? []).length;
+        const lfCount = (original.match(/(?<!\r)\n/g) ?? []).length;
+        const lineEnding = crlfCount > lfCount ? "\r\n" : "\n";
+        const normalized = original.replaceAll("\r\n", "\n");
+        const actualOldString = findActualString(normalized, oldString) ?? oldString;
+        const matches = normalized.split(actualOldString).length - 1;
+        if (matches === 0) {
+          throw new Error(`String to replace not found in file.\nString: ${oldString}`);
+        }
+        if (!replaceAll && matches > 1) {
+          throw new Error(
+            `Found ${matches} matches of the string to replace, but replace_all is false. To replace all occurrences, set replace_all to true. To replace only one occurrence, please provide more context to uniquely identify the instance.\nString: ${oldString}`,
+          );
+        }
+        const actualNewString = preserveQuoteStyle(oldString, actualOldString, newString);
+        // split/join 与函数替换：replacement 含 $ 时不会触发 $& 等特殊语义
+        const updated = replaceAll
+          ? normalized.split(actualOldString).join(actualNewString)
+          : normalized.replace(actualOldString, () => actualNewString);
+        const restored = lineEnding === "\r\n" ? updated.replaceAll("\n", "\r\n") : updated;
+        await writeFile(filePath, restored, "utf8");
+        const snapshot = snapshotOf(restored);
+        state.reads.set(key, snapshot);
+        const diff = generateDiffString(original, restored);
+        const text = replaceAll
+          ? `The file ${filePath} has been updated. All occurrences were successfully replaced.`
+          : `The file ${filePath} has been updated successfully.`;
+        throwIfAborted(signal);
+        const diagnosticText = await service.lspDiagnosticsForFile(filePath, ctx.cwd);
+        return [
+          text,
+          {
+            diff: diff.diff,
+            patch: generateUnifiedPatch(filePath, original, restored),
+            firstChangedLine: diff.firstChangedLine,
+            reads: { [key]: snapshot },
+          },
+          diagnosticText,
+        ];
+      });
 
-      throwIfAborted(signal);
-      // 写后等待文档诊断，ERROR 级错误追加到输出让模型可见
-      const diagnosticText = await service.lspDiagnosticsForFile(filePath, ctx.cwd);
       const text = diagnosticText
         ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
         : message;
-      return {
-        content: [{ type: "text" as const, text }],
-        details: {
-          ...details,
-          pendant: buildEditPendant({
-            filePath,
-            diff: details.diff ?? "",
-            diagnosticText,
-          }),
-        },
-      };
+      return { content: [{ type: "text" as const, text }], details };
     },
   });
 
@@ -583,65 +516,54 @@ export function registerFileTools(
         absolutePath: filePath,
         change: { oldText: "", newText: params.content },
       });
-      const [message, details] = await withFileMutationQueue<[string, FileToolDetails]>(
-        filePath,
-        async () => {
-          let original: string | undefined;
-          let key: string | undefined;
-          try {
-            const value = await stat(filePath);
-            if (value.isFile()) {
-              const content = await readFile(filePath);
-              key = await readStateKey(filePath);
-              requireCurrentRead(state, key, filePath, content);
-              original = content.toString("utf8");
-            }
-          } catch (error) {
-            if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
-              throw error;
-            }
+      const [message, details, diagnosticText] = await withFileMutationQueue<
+        [string, FileToolDetails, string]
+      >(filePath, async () => {
+        let original: string | undefined;
+        let key: string | undefined;
+        try {
+          const value = await stat(filePath);
+          if (value.isFile()) {
+            const content = await readFile(filePath);
+            key = await readStateKey(filePath);
+            requireCurrentRead(state, key, filePath, content);
+            original = content.toString("utf8");
           }
-          throwIfAborted(signal);
-          await mkdir(dirname(filePath), { recursive: true });
-          await writeFile(filePath, params.content, "utf8");
-          const snapshot = snapshotOf(params.content);
-          // 新建文件：writeFile 之后 realpath 才能解析；覆盖写则复用上面的 key
-          const resolvedKey = key ?? (await readStateKey(filePath));
-          state.reads.set(resolvedKey, snapshot);
-          const diff = generateDiffString(original ?? "", params.content);
-          const text =
-            original === undefined
-              ? `File created successfully at: ${filePath}`
-              : `The file ${filePath} has been updated successfully.`;
-          return [
-            text,
-            {
-              diff: diff.diff,
-              patch: generateUnifiedPatch(filePath, original ?? "", params.content),
-              firstChangedLine: diff.firstChangedLine,
-              reads: { [resolvedKey]: snapshot },
-            },
-          ];
-        },
-      );
+        } catch (error) {
+          if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
+            throw error;
+          }
+        }
+        throwIfAborted(signal);
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, params.content, "utf8");
+        const snapshot = snapshotOf(params.content);
+        // 新建文件：writeFile 之后 realpath 才能解析；覆盖写则复用上面的 key
+        const resolvedKey = key ?? (await readStateKey(filePath));
+        state.reads.set(resolvedKey, snapshot);
+        const diff = generateDiffString(original ?? "", params.content);
+        const text =
+          original === undefined
+            ? `File created successfully at: ${filePath}`
+            : `The file ${filePath} has been updated successfully.`;
+        throwIfAborted(signal);
+        const diagnosticText = await service.lspDiagnosticsForFile(filePath, ctx.cwd);
+        return [
+          text,
+          {
+            diff: diff.diff,
+            patch: generateUnifiedPatch(filePath, original ?? "", params.content),
+            firstChangedLine: diff.firstChangedLine,
+            reads: { [resolvedKey]: snapshot },
+          },
+          diagnosticText,
+        ];
+      });
 
-      throwIfAborted(signal);
-      // 写后等待文档诊断，ERROR 级错误追加到输出让模型可见
-      const diagnosticText = await service.lspDiagnosticsForFile(filePath, ctx.cwd);
       const text = diagnosticText
         ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
         : message;
-      return {
-        content: [{ type: "text" as const, text }],
-        details: {
-          ...details,
-          pendant: buildEditPendant({
-            filePath,
-            diff: details.diff ?? "",
-            diagnosticText,
-          }),
-        },
-      };
+      return { content: [{ type: "text" as const, text }], details };
     },
   });
 }
@@ -685,6 +607,7 @@ export default function claudeCodeFileTools(pi: ExtensionAPI): void {
   // 若文件在此期间被外部修改，Edit/Write 时的指纹对比仍会要求重新 Read，
   // 防呆语义不因重建而弱化。
   pi.on("session_start", (_event, ctx) => {
+    service.setUi(ctx.ui);
     restoreFileReads(state, ctx.sessionManager);
   });
 
@@ -692,6 +615,7 @@ export default function claudeCodeFileTools(pi: ExtensionAPI): void {
   // session_start，扩展实例也不重建。这里同样重放当前分支，丢弃被抛弃分支
   // 的记账，避免 state 与当前分支脱节。
   pi.on("session_tree", (_event, ctx) => {
+    service.setUi(ctx.ui);
     restoreFileReads(state, ctx.sessionManager);
   });
 

package/src/lib/lsp/lsp.ts

@@ -16,7 +16,7 @@ import { readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { extname, join, normalize, sep } from "node:path";
 
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, ExtensionUIContext } from "@earendil-works/pi-coding-agent";
 import { type Static, Type } from "typebox";
 import { Value } from "typebox/value";
 
@@ -137,6 +137,8 @@ export interface LspService {
   diagnostics(): Promise<Record<string, Diagnostic[]>>;
   lspDiagnosticsForFile(file: string, cwd: string): Promise<string>;
   shutdownAll(): Promise<void>;
+  /** 绑定当前会话的 UI 上下文，LSP 服务器启动失败时用它发错误通知（传 undefined 解绑）。 */
+  setUi(ui?: Pick<ExtensionUIContext, "notify">): void;
 }
 
 /** 文件必须在工作目录内才启用 LSP（对齐 opencode 的 containsPath）。 */
@@ -161,6 +163,7 @@ export function createLspService(
     broken: new Set(),
     spawning: new Map(),
   };
+  let ui: Pick<ExtensionUIContext, "notify"> | undefined;
 
   async function getClients(file: string, cwd: string): Promise<LspClient[]> {
     if (!containsPath(file, cwd)) return [];
@@ -195,6 +198,10 @@ export function createLspService(
           const handle = await adapter.spawn(root, cwd);
           if (!handle) {
             state.broken.add(key);
+            ui?.notify(
+              `LSP server "${adapter.id}" is not available for ${root} (binary not found)`,
+              "error",
+            );
             return;
           }
           const client = await create({
@@ -214,8 +221,14 @@ export function createLspService(
           }
           state.clients.push(client);
           return client;
-        } catch {
+        } catch (error) {
           state.broken.add(key);
+          ui?.notify(
+            `LSP server "${adapter.id}" failed to start for ${root}: ${
+              error instanceof Error ? error.message : String(error)
+            }`,
+            "error",
+          );
           return;
         }
       })();
@@ -284,7 +297,15 @@ export function createLspService(
     state.broken.clear();
   }
 
-  return { touchFile, diagnostics, lspDiagnosticsForFile, shutdownAll };
+  return {
+    touchFile,
+    diagnostics,
+    lspDiagnosticsForFile,
+    shutdownAll,
+    setUi(nextUi) {
+      ui = nextUi;
+    },
+  };
 }
 
 /** 注册进程级生命周期：session_shutdown 时清理全部服务器进程。 */

package/src/opencode/files.ts

@@ -506,79 +506,84 @@ function registerEditTool(pi: ExtensionAPI, service: LspService): void {
         if (signal?.aborted) throw new Error("Operation aborted");
       };
 
-      const [message, details] = await withFileMutationQueue(absolutePath, async () => {
-        throwIfAborted();
+      const [message, details, diagnosticText] = await withFileMutationQueue(
+        absolutePath,
+        async () => {
+          throwIfAborted();
 
-        // opencode: 前置校验，先于空 oldString 分支
-        if (oldString === newString) {
-          throw new Error("No changes to apply: oldString and newString are identical.");
-        }
+          // opencode: 前置校验，先于空 oldString 分支
+          if (oldString === newString) {
+            throw new Error("No changes to apply: oldString and newString are identical.");
+          }
+
+          // opencode: 空 oldString + 文件不存在 → 创建新文件；文件存在 → 报错
+          if (oldString === "") {
+            let exists = true;
+            try {
+              await access(absolutePath, constants.F_OK);
+            } catch {
+              exists = false;
+            }
+            throwIfAborted();
+            if (exists) {
+              throw new Error(
+                "oldString cannot be empty when editing an existing file. Provide the exact text to replace, or use write for an intentional full-file replacement.",
+              );
+            }
+            // opencode: writeWithDirs 自动创建父目录；newString 开头的 BOM 原样保留
+            await mkdir(dirname(absolutePath), { recursive: true });
+            throwIfAborted();
+            await writeFile(absolutePath, newString, "utf8");
+            throwIfAborted();
+            const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd);
+            return [
+              "Edit applied successfully.",
+              { diff: "", patch: "", firstChangedLine: 0 },
+              diagnosticText,
+            ] as const;
+          }
 
-        // opencode: 空 oldString + 文件不存在 → 创建新文件；文件存在 → 报错
-        if (oldString === "") {
-          let exists = true;
           try {
-            await access(absolutePath, constants.F_OK);
-          } catch {
-            exists = false;
+            await access(absolutePath, constants.R_OK | constants.W_OK);
+          } catch (error: unknown) {
+            throwIfAborted();
+            const msg =
+              error instanceof Error && "code" in error && typeof error.code === "string"
+                ? `Error code: ${error.code}`
+                : String(error);
+            throw new Error(`Could not edit file: ${filePath}. ${msg}.`, { cause: error });
           }
           throwIfAborted();
-          if (exists) {
-            throw new Error(
-              "oldString cannot be empty when editing an existing file. Provide the exact text to replace, or use write for an intentional full-file replacement.",
-            );
-          }
-          // opencode: writeWithDirs 自动创建父目录；newString 开头的 BOM 原样保留
-          await mkdir(dirname(absolutePath), { recursive: true });
+
+          const buffer = await readFile(absolutePath);
+          const rawContent = buffer.toString("utf8");
           throwIfAborted();
-          await writeFile(absolutePath, newString, "utf8");
+
+          // Strip BOM then normalize line endings to LF.
+          // The opencode replacers split on \n and expect only LF.
+          const { bom, text: content } = stripBom(rawContent);
+          const originalEnding = detectLineEnding(content);
+          const normalizedContent = normalizeToLF(content);
+
+          const newContent = replace(normalizedContent, oldString, newString, replaceAll);
           throwIfAborted();
-          return [
-            "Edit applied successfully.",
-            { diff: "", patch: "", firstChangedLine: 0 },
-          ] as const;
-        }
 
-        try {
-          await access(absolutePath, constants.R_OK | constants.W_OK);
-        } catch (error: unknown) {
+          const finalContent = bom + restoreLineEndings(newContent, originalEnding);
+          await writeFile(absolutePath, finalContent, "utf8");
           throwIfAborted();
-          const msg =
-            error instanceof Error && "code" in error && typeof error.code === "string"
-              ? `Error code: ${error.code}`
-              : String(error);
-          throw new Error(`Could not edit file: ${filePath}. ${msg}.`, { cause: error });
-        }
-        throwIfAborted();
 
-        const buffer = await readFile(absolutePath);
-        const rawContent = buffer.toString("utf8");
-        throwIfAborted();
-
-        // Strip BOM then normalize line endings to LF.
-        // The opencode replacers split on \n and expect only LF.
-        const { bom, text: content } = stripBom(rawContent);
-        const originalEnding = detectLineEnding(content);
-        const normalizedContent = normalizeToLF(content);
-
-        const newContent = replace(normalizedContent, oldString, newString, replaceAll);
-        throwIfAborted();
-
-        const finalContent = bom + restoreLineEndings(newContent, originalEnding);
-        await writeFile(absolutePath, finalContent, "utf8");
-        throwIfAborted();
-
-        const diffResult = generateDiffString(normalizedContent, newContent);
-        const patch = generateUnifiedPatch(filePath, normalizedContent, newContent);
-        return [
-          "Edit applied successfully.",
-          { diff: diffResult.diff, patch, firstChangedLine: diffResult.firstChangedLine },
-        ] as const;
-      });
+          const diffResult = generateDiffString(normalizedContent, newContent);
+          const patch = generateUnifiedPatch(filePath, normalizedContent, newContent);
+          throwIfAborted();
+          const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd);
+          return [
+            "Edit applied successfully.",
+            { diff: diffResult.diff, patch, firstChangedLine: diffResult.firstChangedLine },
+            diagnosticText,
+          ] as const;
+        },
+      );
 
-      throwIfAborted();
-      // opencode: 写后等待文档诊断，ERROR 级错误追加到输出让模型可见
-      const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd);
       const text = diagnosticText
         ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
         : message;
@@ -639,38 +644,39 @@ function registerWriteTool(pi: ExtensionAPI, service: LspService): void {
         if (signal?.aborted) throw new Error("Operation aborted");
       };
 
-      const [message, details] = await withFileMutationQueue(absolutePath, async () => {
-        throwIfAborted();
+      const [message, details, diagnosticText] = await withFileMutationQueue(
+        absolutePath,
+        async () => {
+          throwIfAborted();
 
-        // opencode: desiredBom = source.bom || next.bom —— 保留原文件 BOM，
-        // 否则用新内容自带的 BOM
-        let existing: Buffer | undefined;
-        try {
-          const fh = await open(absolutePath, "r");
+          // opencode: desiredBom = source.bom || next.bom —— 保留原文件 BOM，
+          // 否则用新内容自带的 BOM
+          let existing: Buffer | undefined;
           try {
-            existing = Buffer.alloc(3);
-            const { bytesRead } = await fh.read(existing, 0, 3, 0);
-            if (bytesRead < 3) existing = undefined;
-          } finally {
-            await fh.close();
+            const fh = await open(absolutePath, "r");
+            try {
+              existing = Buffer.alloc(3);
+              const { bytesRead } = await fh.read(existing, 0, 3, 0);
+              if (bytesRead < 3) existing = undefined;
+            } finally {
+              await fh.close();
+            }
+          } catch {
+            // 文件不存在：无旧 BOM
           }
-        } catch {
-          // 文件不存在：无旧 BOM
-        }
-        throwIfAborted();
-        const { bom: desiredBom, text: nextText } = resolveBom(existing, content);
+          throwIfAborted();
+          const { bom: desiredBom, text: nextText } = resolveBom(existing, content);
 
-        await mkdir(dir, { recursive: true });
-        throwIfAborted();
-        await writeFile(absolutePath, desiredBom + nextText, "utf8");
-        throwIfAborted();
+          await mkdir(dir, { recursive: true });
+          throwIfAborted();
+          await writeFile(absolutePath, desiredBom + nextText, "utf8");
+          throwIfAborted();
+          const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd);
 
-        return ["Wrote file successfully.", undefined] as const;
-      });
+          return ["Wrote file successfully.", undefined, diagnosticText] as const;
+        },
+      );
 
-      throwIfAborted();
-      // opencode: 写后等待文档诊断，ERROR 级错误追加到输出让模型可见
-      const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd);
       const text = diagnosticText
         ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
         : message;