@trim21/personal-pi-extensions 0.0.406 → 0.0.408

package/package.json

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

package/src/aft/tools.ts

@@ -8,7 +8,7 @@
 import { readFileSync } from "node:fs";
 import { stat } from "node:fs/promises";
 import { homedir } from "node:os";
-import { basename, isAbsolute, join, resolve } from "node:path";
+import { isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import {
@@ -23,7 +23,7 @@ import {
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
-import { formatDisplayPath } from "../lib/path.js";
+import { formatDisplayPath, formatSubtitlePath } from "../lib/path.js";
 import { type ToolPendant } from "../lib/pendant.js";
 import { callAftTool, SEMANTIC_INDEX_WAIT_TIMEOUT_MS } from "./bridge.js";
 
@@ -51,16 +51,6 @@ export function resolvePathArg(cwd: string, input: string): string {
   return isAbsolute(input) ? input : resolve(cwd, input);
 }
 
-/** subtitle 中路径的最大显示长度，超过时退化为仅文件名。 */
-export const MAX_SUBTITLE_PATH_LENGTH = 20;
-
-/** subtitle 用的显示路径：优先 `./…` / `~/…` / 绝对路径，结果过长时只显示文件名。 */
-export function formatSubtitlePath(cwd: string, filePath: string): string {
-  const display = formatDisplayPath(cwd, filePath);
-  if (display.length <= MAX_SUBTITLE_PATH_LENGTH) return display;
-  return basename(filePath);
-}
-
 export interface AftToolContext {
   cwd: string;
   pool: AftTransportPool;
@@ -167,7 +157,7 @@ export function registerOutlineTool(pi: ExtensionAPI, ctx: AftToolContext): void
   });
 }
 
-/** 构建 aft_outline pendant 的 subtitle：`target="…"`（路径过长时只显示文件名）。 */
+/** 构建 aft_outline pendant 的 subtitle：`target="…"`（路径过长时显示上一级目录加文件名）。 */
 export function buildOutlineSubtitle(cwd: string, target: string): string {
   return `target="${formatSubtitlePath(cwd, resolvePathArg(cwd, target))}"`;
 }

package/src/claude-code/files.ts

@@ -14,7 +14,9 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import { appendLspDiagnosticText } from "../lib/lsp/diagnostic.js";
 import { type LspService, registerLsp } from "../lib/lsp/lsp.js";
+import { formatSubtitlePath } from "../lib/path.js";
 import { guardWriteAccess } from "../lib/write-guard.js";
 import {
   type ClaudeCodeState,
@@ -295,7 +297,13 @@ export function registerFileTools(
         const snapshot = snapshotOf(image, false);
         const key = await readStateKey(filePath);
         state.reads.set(key, snapshot);
-        return { content, details: { reads: { [key]: snapshot } } };
+        return {
+          content,
+          details: {
+            reads: { [key]: snapshot },
+            pendant: { subtitle: formatSubtitlePath(ctx.cwd, filePath) },
+          },
+        };
       }
 
       const offset = params.offset ?? 1;
@@ -313,7 +321,10 @@ export function registerFileTools(
         previous.limit === limit &&
         snapshotsEqual(previous, snapshotOf(buffer))
       ) {
-        return { content: [{ type: "text", text: FILE_UNCHANGED_STUB }], details: {} };
+        return {
+          content: [{ type: "text", text: FILE_UNCHANGED_STUB }],
+          details: { pendant: { subtitle: formatSubtitlePath(ctx.cwd, filePath) } },
+        };
       }
       if (isBinary(buffer.subarray(0, SAMPLE_BYTES)))
         throw new Error(`Cannot read binary file: ${filePath}`);
@@ -340,7 +351,10 @@ export function registerFileTools(
       });
       return {
         content: [{ type: "text", text: formatted.text }],
-        details: { reads: { [key]: snapshot } },
+        details: {
+          reads: { [key]: snapshot },
+          pendant: { subtitle: formatSubtitlePath(ctx.cwd, filePath) },
+        },
       };
     },
   });
@@ -381,159 +395,179 @@ export function registerFileTools(
           replaceAll: params.replace_all,
         },
       });
-      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 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.");
+      const [message, details, diagnosticText, errorCount, warningCount] =
+        await withFileMutationQueue<[string, FileToolDetails, string, number, number]>(
+          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("", convertLeadingTabsToSpaces(newString));
+              throwIfAborted(signal);
+              const {
+                text: diagnosticText,
+                errorCount,
+                warningCount,
+              } = await service.lspDiagnosticsForFile(filePath, ctx.cwd, {
+                notify: (message, level) => ctx.ui.notify(message, level),
+                signal,
+              });
+              return [
+                `The file ${filePath} has been updated successfully.`,
+                {
+                  diff: diff.diff,
+                  patch: generateUnifiedPatch(filePath, "", convertLeadingTabsToSpaces(newString)),
+                  firstChangedLine: diff.firstChangedLine,
+                  reads: { [key]: snapshot },
+                },
+                diagnosticText,
+                errorCount,
+                warningCount,
+              ];
             }
-          } catch (error) {
-            if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-              exists = false;
-            } else {
+            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 (!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("", convertLeadingTabsToSpaces(newString));
-          throwIfAborted(signal);
-          const diagnosticText = await service.lspDiagnosticsForFile(filePath, ctx.cwd, {
-            notify: (message, level) => ctx.ui.notify(message, level),
-            signal,
-          });
-          return [
-            `The file ${filePath} has been updated successfully.`,
-            {
-              diff: diff.diff,
-              patch: generateUnifiedPatch(filePath, "", convertLeadingTabsToSpaces(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);
-        // 删除场景（new_string 为空）：old_string 不以换行结尾且文件里是
-        // "old_string\n" 时连换行一起删，避免留下空行（对齐 Claude Code
-        // applyEditToFile 的 stripTrailingNewline 语义）
-        let searchString = actualOldString;
-        if (
-          actualNewString === "" &&
-          !actualOldString.endsWith("\n") &&
-          normalized.includes(actualOldString + "\n")
-        ) {
-          searchString = actualOldString + "\n";
-        }
-        // split/join 与函数替换：replacement 含 $ 时不会触发 $& 等特殊语义
-        const updated = replaceAll
-          ? normalized.split(searchString).join(actualNewString)
-          : normalized.replace(searchString, () => 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);
-        // patch/diff 仅供显示：前导 tab 转空格，避免 UI 渲染错位（对齐 Claude Code）
-        const diff = generateDiffString(
-          convertLeadingTabsToSpaces(original),
-          convertLeadingTabsToSpaces(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, {
-          notify: (message, level) => ctx.ui.notify(message, level),
-        });
-        return [
-          text,
-          {
-            diff: diff.diff,
-            patch: generateUnifiedPatch(
-              filePath,
+            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);
+            // 删除场景（new_string 为空）：old_string 不以换行结尾且文件里是
+            // "old_string\n" 时连换行一起删，避免留下空行（对齐 Claude Code
+            // applyEditToFile 的 stripTrailingNewline 语义）
+            let searchString = actualOldString;
+            if (
+              actualNewString === "" &&
+              !actualOldString.endsWith("\n") &&
+              normalized.includes(actualOldString + "\n")
+            ) {
+              searchString = actualOldString + "\n";
+            }
+            // split/join 与函数替换：replacement 含 $ 时不会触发 $& 等特殊语义
+            const updated = replaceAll
+              ? normalized.split(searchString).join(actualNewString)
+              : normalized.replace(searchString, () => 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);
+            // patch/diff 仅供显示：前导 tab 转空格，避免 UI 渲染错位（对齐 Claude Code）
+            const diff = generateDiffString(
               convertLeadingTabsToSpaces(original),
               convertLeadingTabsToSpaces(restored),
-            ),
-            firstChangedLine: diff.firstChangedLine,
-            reads: { [key]: snapshot },
+            );
+            const text = replaceAll
+              ? `The file ${filePath} has been updated. All occurrences were successfully replaced.`
+              : `The file ${filePath} has been updated successfully.`;
+            throwIfAborted(signal);
+            const {
+              text: diagnosticText,
+              errorCount,
+              warningCount,
+            } = await service.lspDiagnosticsForFile(filePath, ctx.cwd, {
+              notify: (message, level) => ctx.ui.notify(message, level),
+            });
+            return [
+              text,
+              {
+                diff: diff.diff,
+                patch: generateUnifiedPatch(
+                  filePath,
+                  convertLeadingTabsToSpaces(original),
+                  convertLeadingTabsToSpaces(restored),
+                ),
+                firstChangedLine: diff.firstChangedLine,
+                reads: { [key]: snapshot },
+              },
+              diagnosticText,
+              errorCount,
+              warningCount,
+            ];
           },
-          diagnosticText,
-        ];
-      });
+        );
 
-      const text = diagnosticText
-        ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
-        : message;
-      return { content: [{ type: "text" as const, text }], details };
+      const text = appendLspDiagnosticText(message, diagnosticText, errorCount);
+      return {
+        content: [{ type: "text" as const, text }],
+        details: {
+          ...details,
+          pendant: { subtitle: formatSubtitlePath(ctx.cwd, filePath, errorCount, warningCount) },
+        },
+      };
     },
   });
 
@@ -564,56 +598,68 @@ export function registerFileTools(
         absolutePath: filePath,
         change: { oldText: "", newText: params.content },
       });
-      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");
-          }
-        } 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, {
-          notify: (message, level) => ctx.ui.notify(message, level),
-        });
-        return [
-          text,
-          {
-            diff: diff.diff,
-            patch: generateUnifiedPatch(filePath, original ?? "", params.content),
-            firstChangedLine: diff.firstChangedLine,
-            reads: { [resolvedKey]: snapshot },
+      const [message, details, diagnosticText, errorCount, warningCount] =
+        await withFileMutationQueue<[string, FileToolDetails, string, number, number]>(
+          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;
+              }
+            }
+            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 {
+              text: diagnosticText,
+              errorCount,
+              warningCount,
+            } = await service.lspDiagnosticsForFile(filePath, ctx.cwd, {
+              notify: (message, level) => ctx.ui.notify(message, level),
+            });
+            return [
+              text,
+              {
+                diff: diff.diff,
+                patch: generateUnifiedPatch(filePath, original ?? "", params.content),
+                firstChangedLine: diff.firstChangedLine,
+                reads: { [resolvedKey]: snapshot },
+              },
+              diagnosticText,
+              errorCount,
+              warningCount,
+            ];
           },
-          diagnosticText,
-        ];
-      });
+        );
 
-      const text = diagnosticText
-        ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
-        : message;
-      return { content: [{ type: "text" as const, text }], details };
+      const text = appendLspDiagnosticText(message, diagnosticText, errorCount);
+      return {
+        content: [{ type: "text" as const, text }],
+        details: {
+          ...details,
+          pendant: { subtitle: formatSubtitlePath(ctx.cwd, filePath, errorCount, warningCount) },
+        },
+      };
     },
   });
 }

package/src/lib/lsp/diagnostic.ts

@@ -1,6 +1,5 @@
 /**
- * 诊断报告格式化（移植自 opencode lsp/diagnostic.ts）：只报告 ERROR
- * 级诊断，每个文件最多 20 条。
+ * 诊断报告格式化：报告 ERROR 与 WARN，每个文件最多 20 条。
  */
 
 import type { Diagnostic } from "./client.js";
@@ -14,8 +13,12 @@ const SEVERITY_LABELS: Record<number, string> = {
   4: "HINT",
 };
 
+function severityOf(diagnostic: Diagnostic): number {
+  return diagnostic.severity ?? 1;
+}
+
 export function prettyDiagnostic(diagnostic: Diagnostic): string {
-  const severity = SEVERITY_LABELS[diagnostic.severity || 1] ?? "ERROR";
+  const severity = SEVERITY_LABELS[severityOf(diagnostic)] ?? "ERROR";
   const line = diagnostic.range.start.line + 1;
   const col = diagnostic.range.start.character + 1;
   // 3.18 起 message 可能是 MarkupContent（客户端未声明 markupMessageSupport 时不会出现）
@@ -24,12 +27,25 @@ export function prettyDiagnostic(diagnostic: Diagnostic): string {
   return `${severity} [${line}:${col}] ${message}`;
 }
 
-/** 返回空字符串表示没有 ERROR 级诊断。 */
+/** 返回空字符串表示没有 ERROR / WARN。ERROR 在前，WARN 在后。 */
 export function report(file: string, issues: Diagnostic[]): string {
-  const errors = issues.filter((item) => item.severity === 1);
-  if (errors.length === 0) return "";
-  const limited = errors.slice(0, MAX_PER_FILE);
-  const more = errors.length - MAX_PER_FILE;
+  const errors = issues.filter((item) => severityOf(item) === 1);
+  const warnings = issues.filter((item) => item.severity === 2);
+  const relevant = [...errors, ...warnings];
+  if (relevant.length === 0) return "";
+  const limited = relevant.slice(0, MAX_PER_FILE);
+  const more = relevant.length - MAX_PER_FILE;
   const suffix = more > 0 ? `\n... and ${more} more` : "";
   return `<diagnostics file="${file}">\n${limited.map((d) => prettyDiagnostic(d)).join("\n")}${suffix}\n</diagnostics>`;
 }
+
+/** 把 LSP 诊断块接到工具成功文案后面；无诊断时原样返回。 */
+export function appendLspDiagnosticText(
+  message: string,
+  diagnosticText: string,
+  errorCount: number,
+): string {
+  if (!diagnosticText) return message;
+  const kind = errorCount > 0 ? "errors" : "warnings";
+  return `${message}\n\nLSP ${kind} detected in this file:\n${diagnosticText}`;
+}

package/src/lib/lsp/lsp.ts

@@ -208,7 +208,11 @@ export interface LspService {
     options?: LspRequestOptions,
   ): Promise<void>;
   diagnostics(): Promise<Record<string, Diagnostic[]>>;
-  lspDiagnosticsForFile(file: string, cwd: string, options?: LspRequestOptions): Promise<string>;
+  lspDiagnosticsForFile(
+    file: string,
+    cwd: string,
+    options?: LspRequestOptions,
+  ): Promise<{ text: string; errorCount: number; warningCount: number }>;
   shutdownAll(): Promise<void>;
   /** 注入 status 渲染回调；传入 undefined 表示不再渲染。 */
   attachStatus(render: StatusRenderer | undefined): void;
@@ -404,19 +408,22 @@ export function createLspService(
   }
 
   /**
-   * edit/write 用：等待文档诊断并返回该文件的 ERROR 报告（空串表示无错误）。
-   * 内部所有 LSP 失败都会被吞掉，不干扰写操作本身。
+   * edit/write 用：等待文档诊断并返回该文件的 ERROR / WARN 报告（text 空串表示无此类诊断）
+   * 与数量。内部所有 LSP 失败都会被吞掉，不干扰写操作本身。
    */
   async function lspDiagnosticsForFile(
     file: string,
     cwd: string,
     options?: LspRequestOptions,
-  ): Promise<string> {
-    if (options?.signal?.aborted) return "";
+  ): Promise<{ text: string; errorCount: number; warningCount: number }> {
+    if (options?.signal?.aborted) return { text: "", errorCount: 0, warningCount: 0 };
     await touchFile(file, cwd, "document", options);
     const all = await diagnostics();
     const normalized = normalize(file);
-    return report(normalized, all[normalized] ?? []);
+    const issues = all[normalized] ?? [];
+    const errorCount = issues.filter((item) => (item.severity ?? 1) === 1).length;
+    const warningCount = issues.filter((item) => item.severity === 2).length;
+    return { text: report(normalized, issues), errorCount, warningCount };
   }
 
   /** 终止全部服务器进程（session_shutdown 时调用）。 */

package/src/lib/path.ts

@@ -4,7 +4,7 @@
 
 import { stat } from "node:fs/promises";
 import { homedir } from "node:os";
-import { isAbsolute, join, relative, resolve } from "node:path";
+import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 
 /**
  * Expand a leading `~` to the user's home directory.
@@ -59,3 +59,34 @@ export function formatDisplayPath(cwd: string, filePath: string): string {
   }
   return filePath;
 }
+
+/** subtitle 中路径的最大显示长度，超过时退化为 `parent/basename`。 */
+export const MAX_SUBTITLE_PATH_LENGTH = 20;
+
+function shortenSubtitlePath(filePath: string, display: string): string {
+  if (display.length <= MAX_SUBTITLE_PATH_LENGTH) return display;
+  const name = basename(filePath);
+  const parentDir = dirname(filePath);
+  const parentName = basename(parentDir);
+  if (parentName === "" || parentName === "." || parentDir === parentName) return name;
+  return join(parentName, name);
+}
+
+function formatSubtitleCounts(errorCount?: number, warningCount?: number): string {
+  const parts: string[] = [];
+  if (errorCount) parts.push(`ⓧ ${errorCount}`);
+  if (warningCount) parts.push(`⚠ ${warningCount}`);
+  return parts.join(" ");
+}
+
+/** subtitle 用的显示路径：优先 `./…` / `~/…` / 绝对路径，过长时显示上一级目录加文件名。 */
+export function formatSubtitlePath(
+  cwd: string,
+  filePath: string,
+  errorCount?: number,
+  warningCount?: number,
+): string {
+  const pathText = shortenSubtitlePath(filePath, formatDisplayPath(cwd, filePath));
+  const counts = formatSubtitleCounts(errorCount, warningCount);
+  return counts ? `${pathText} (${counts})` : pathText;
+}

package/src/opencode/files.ts

@@ -29,7 +29,9 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 
+import { appendLspDiagnosticText } from "../lib/lsp/diagnostic.js";
 import { type LspService, registerLsp } from "../lib/lsp/lsp.js";
+import { formatSubtitlePath } from "../lib/path.js";
 import { guardWriteAccess } from "../lib/write-guard.js";
 import { applyEdit, normalizeToLF, stripBom } from "./edit-engine.js";
 
@@ -356,7 +358,7 @@ function registerReadTool(pi: ExtensionAPI, service: LspService): void {
 
         return {
           content: [{ type: "text", text: output }],
-          details: undefined,
+          details: { pendant: { subtitle: formatSubtitlePath(ctx.cwd, absolutePath) } },
         };
       }
 
@@ -384,7 +386,10 @@ function registerReadTool(pi: ExtensionAPI, service: LspService): void {
           { type: "text", text: "Image read successfully" },
           { type: "image", data: base64, mimeType },
         ];
-        return { content, details: undefined };
+        return {
+          content,
+          details: { pendant: { subtitle: formatSubtitlePath(ctx.cwd, absolutePath) } },
+        };
       }
 
       if (isBinaryExtension(absolutePath) || isBinaryFileBySample(await readSample(absolutePath))) {
@@ -431,7 +436,13 @@ function registerReadTool(pi: ExtensionAPI, service: LspService): void {
         // 后台 warm-up 失败不影响读取
       });
 
-      return { content, details };
+      return {
+        content,
+        details: {
+          ...details,
+          pendant: { subtitle: formatSubtitlePath(ctx.cwd, absolutePath) },
+        },
+      };
     },
   });
 }
@@ -482,9 +493,8 @@ function registerEditTool(pi: ExtensionAPI, service: LspService): void {
         change: { oldText: oldString, newText: newString, replaceAll },
       });
 
-      const [message, details, diagnosticText] = await withFileMutationQueue(
-        absolutePath,
-        async () => {
+      const [message, details, diagnosticText, errorCount, warningCount] =
+        await withFileMutationQueue(absolutePath, async () => {
           signal?.throwIfAborted();
 
           // opencode: 前置校验，先于空 oldString 分支
@@ -509,13 +519,17 @@ function registerEditTool(pi: ExtensionAPI, service: LspService): void {
             await mkdir(dirname(absolutePath), { recursive: true });
             signal?.throwIfAborted();
             await writeFile(absolutePath, newString, "utf8");
-            const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd, {
-              signal,
-            });
+            const {
+              text: diagnosticText,
+              errorCount,
+              warningCount,
+            } = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd, { signal });
             return [
               "Edit applied successfully.",
               { diff: "", patch: "", firstChangedLine: 0 },
               diagnosticText,
+              errorCount,
+              warningCount,
             ] as const;
           }
 
@@ -547,21 +561,30 @@ function registerEditTool(pi: ExtensionAPI, service: LspService): void {
           const diffNew = normalizeToLF(applied.contentNew);
           const diffResult = generateDiffString(diffOld, diffNew);
           const patch = generateUnifiedPatch(filePath, diffOld, diffNew);
-          const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd, {
-            signal,
-          });
+          const {
+            text: diagnosticText,
+            errorCount,
+            warningCount,
+          } = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd, { signal });
           return [
             "Edit applied successfully.",
             { diff: diffResult.diff, patch, firstChangedLine: diffResult.firstChangedLine },
             diagnosticText,
+            errorCount,
+            warningCount,
           ] as const;
+        });
+
+      const text = appendLspDiagnosticText(message, diagnosticText, errorCount);
+      return {
+        content: [{ type: "text" as const, text }],
+        details: {
+          ...details,
+          pendant: {
+            subtitle: formatSubtitlePath(ctx.cwd, absolutePath, errorCount, warningCount),
+          },
         },
-      );
-
-      const text = diagnosticText
-        ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
-        : message;
-      return { content: [{ type: "text" as const, text }], details };
+      };
     },
   });
 }
@@ -614,9 +637,8 @@ function registerWriteTool(pi: ExtensionAPI, service: LspService): void {
       });
       const dir = dirname(absolutePath);
 
-      const [message, details, diagnosticText] = await withFileMutationQueue(
-        absolutePath,
-        async () => {
+      const [message, details, diagnosticText, errorCount, warningCount] =
+        await withFileMutationQueue(absolutePath, async () => {
           signal?.throwIfAborted();
 
           // opencode: desiredBom = source.bom || next.bom —— 保留原文件 BOM，
@@ -639,18 +661,31 @@ function registerWriteTool(pi: ExtensionAPI, service: LspService): void {
           await mkdir(dir, { recursive: true });
           signal?.throwIfAborted();
           await writeFile(absolutePath, desiredBom + nextText, "utf8");
-          const diagnosticText = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd, {
-            signal,
-          });
+          const {
+            text: diagnosticText,
+            errorCount,
+            warningCount,
+          } = await service.lspDiagnosticsForFile(absolutePath, ctx.cwd, { signal });
 
-          return ["Wrote file successfully.", undefined, diagnosticText] as const;
+          return [
+            "Wrote file successfully.",
+            {},
+            diagnosticText,
+            errorCount,
+            warningCount,
+          ] as const;
+        });
+
+      const text = appendLspDiagnosticText(message, diagnosticText, errorCount);
+      return {
+        content: [{ type: "text" as const, text }],
+        details: {
+          ...details,
+          pendant: {
+            subtitle: formatSubtitlePath(ctx.cwd, absolutePath, errorCount, warningCount),
+          },
         },
-      );
-
-      const text = diagnosticText
-        ? `${message}\n\nLSP errors detected in this file, please fix:\n${diagnosticText}`
-        : message;
-      return { content: [{ type: "text" as const, text }], details };
+      };
     },
   });
 }