@trim21/personal-pi-extensions 0.0.354 → 0.0.356

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trim21/personal-pi-extensions",
-  "version": "0.0.354",
+  "version": "0.0.356",
   "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 { isAbsolute, join, relative, resolve } from "node:path";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import {
@@ -63,6 +63,16 @@ export function formatDisplayPath(cwd: string, filePath: string): string {
   return filePath;
 }
 
+/** 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;
@@ -150,6 +160,8 @@ export function registerOutlineTool(pi: ExtensionAPI, ctx: AftToolContext): void
       if (filesMode) rawArgs.files = true;
       if (params.includeTests !== undefined) rawArgs.includeTests = params.includeTests;
 
+      const subtitle = buildOutlineSubtitle(extCtx.cwd, target);
+
       const { text, response } = await callAftTool(bridgeFor(ctx), "outline", rawArgs, extCtx);
       const truncated = response.truncated === true;
       return {
@@ -157,12 +169,21 @@ export function registerOutlineTool(pi: ExtensionAPI, ctx: AftToolContext): void
         details: {
           truncated,
           params,
+          pendant: {
+            title: "aft_outline",
+            subtitle,
+          } satisfies ToolPendant,
         },
       };
     },
   });
 }
 
+/** 构建 aft_outline pendant 的 subtitle：`target="…"`（路径过长时只显示文件名）。 */
+export function buildOutlineSubtitle(cwd: string, target: string): string {
+  return `target="${formatSubtitlePath(cwd, resolvePathArg(cwd, target))}"`;
+}
+
 const ZoomParams = Type.Object(
   {
     path: Type.String({ description: "文件路径（绝对或相对项目根）" }),

package/src/lib/lsp/client.ts

@@ -210,6 +210,8 @@ export async function create(input: CreateInput): Promise<LspClient> {
   const diagnosticRegistrations = new Map<string, CapabilityRegistration>();
   const registrationListeners = new Set<() => void>();
   const diagnosticListeners = new Set<(input: { path: string; serverID: string }) => void>();
+  /** resolvedPath → 客户端已发送的最新文档版本（didOpen=0，didChange 递增）。 */
+  const documentVersions = new Map<string, number>();
   const mergedDiagnostics = (filePath: string): Diagnostic[] =>
     dedupeDiagnostics([
       ...(pushDiagnostics.get(filePath) ?? []),
@@ -234,6 +236,14 @@ export async function create(input: CreateInput): Promise<LspClient> {
     (params: { uri: string; version?: number; diagnostics: Diagnostic[] }) => {
       const filePath = getFilePath(params.uri);
       if (!filePath) return;
+      // 服务器版本滞后于已发送版本时，该 push 对应的是旧内容（重算未完成时的
+      // 迟到结果）。忽略它，避免与 pull 通道的当前结果合并出 stale 诊断。
+      const currentVersion = documentVersions.get(filePath);
+      const isStalePush =
+        typeof params.version === "number" &&
+        currentVersion !== undefined &&
+        params.version !== currentVersion;
+      if (isStalePush) return;
       published.set(filePath, {
         at: Date.now(),
         version: typeof params.version === "number" ? params.version : undefined,
@@ -652,6 +662,7 @@ export async function create(input: CreateInput): Promise<LspClient> {
 
           const next = document.version + 1;
           files[resolvedPath] = { version: next, text };
+          documentVersions.set(resolvedPath, next);
           await connection.sendNotification("textDocument/didChange", {
             textDocument: { uri, version: next },
             contentChanges:
@@ -677,6 +688,7 @@ export async function create(input: CreateInput): Promise<LspClient> {
           textDocument: { uri, languageId, version: 0, text },
         });
         files[resolvedPath] = { version: 0, text };
+        documentVersions.set(resolvedPath, 0);
         return 0;
       },
     },