@zhushanwen/pi-agent-ext 1.1.1 → 1.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhushanwen/pi-agent-ext",
-  "version": "1.1.1",
-  "description": "xyz-agent extension for Pi — session tree navigation and internal reload command",
+  "version": "1.2.0",
+  "description": "xyz-agent extension for Pi — internal host commands for extension reload and system prompt fetch",
   "type": "module",
   "main": "src/index.ts",
   "xyz-agent": {
@@ -16,7 +16,6 @@
     "pi-package",
     "extension",
     "agent",
-    "navigate",
     "reload"
   ],
   "license": "MIT",
@@ -25,7 +24,7 @@
     "index.ts"
   ],
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.84.1"
+    "@earendil-works/pi-coding-agent": "^0.84.4"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/agent-ext.test.ts

@@ -3,18 +3,19 @@
  *
  * 复用 system-prompt-trace index-wiring.test.ts 的 Proxy 假体模式：
  * - pi 用 Proxy 假体：捕获 registerCommand 注册的命令定义 + appendEntry 落点
- * - ctx 只需 index.ts 实际消费的字段（reload / navigateTree / getSystemPrompt），
+ * - ctx 只需 index.ts 实际消费的字段（reload / getSystemPrompt），
  *   以 ExtensionCommandContext 最小形状驱动 handler（SDK 双参契约 (args, ctx)）
  * - index.ts 对 @earendil-works/pi-coding-agent 是 type-only import（运行时擦除），
  *   无需 vi.mock SDK 模块
  *
- * 锚定三命令注册面 + handler 行为：
+ * 锚定两命令注册面 + handler 行为：
  * - __xyz_reload__（host 触发的 skill/extension 重载内部命令）→ ctx.reload()
- * - xyz-navigate（session tree 导航）→ 空 entryId 早退；有效 entryId →
- *   ctx.navigateTree(entryId, { summarize: false })
  * - __xyz_get_system_prompt__（Trace 视图「现取当前值」通道）→ pi.appendEntry
  *   写 xyz:current-system-prompt custom entry（fullText/charCount/fetchedAt 形状）
  *
+ * [HISTORICAL] xyz-navigate（session tree 导航）命令及其测试随命令删除一并移除
+ * （2026-08-31，桥接对端 runtime 消费端已在 monorepo 时代删除）。
+ *
  * 运行：cd extensions/taiji/agent-ext && npx vitest run
  */
 import { describe, it, expect, vi } from "vitest";
@@ -62,23 +63,20 @@ function createWiringHarness(): WiringHarness {
   return { pi, commands, entries };
 }
 
-/** ctx 假体（index.ts 实际消费：reload / navigateTree / getSystemPrompt；vi.fn 捕获调用）。 */
+/** ctx 假体（index.ts 实际消费：reload / getSystemPrompt；vi.fn 捕获调用）。 */
 function createCtx(prompt = "current system prompt"): {
   ctx: ExtensionCommandContext;
   reload: ReturnType<typeof vi.fn>;
-  navigateTree: ReturnType<typeof vi.fn>;
   getSystemPrompt: ReturnType<typeof vi.fn>;
 } {
   const reload = vi.fn();
-  const navigateTree = vi.fn();
   const getSystemPrompt = vi.fn(() => prompt);
   const ctx = {
     cwd: "/home/user/project",
     reload,
-    navigateTree,
     getSystemPrompt,
   } as unknown as ExtensionCommandContext;
-  return { ctx, reload, navigateTree, getSystemPrompt };
+  return { ctx, reload, getSystemPrompt };
 }
 
 /** 以 SDK 双参契约 (args, ctx) 驱动已注册命令 handler。 */
@@ -100,14 +98,13 @@ async function loadExtension(): Promise<(pi: ExtensionAPI) => void> {
 }
 
 describe("index.ts wiring SDK 契约", () => {
-  it("注册恰好三个命令（__xyz_reload__ / xyz-navigate / __xyz_get_system_prompt__），各带非空 description", async () => {
+  it("注册恰好两个命令（__xyz_reload__ / __xyz_get_system_prompt__），各带非空 description", async () => {
     const ext = await loadExtension();
     const h = createWiringHarness();
     ext(h.pi);
     expect([...h.commands.keys()].sort()).toEqual([
       "__xyz_get_system_prompt__",
       "__xyz_reload__",
-      "xyz-navigate",
     ]);
     for (const def of h.commands.values()) {
       expect(typeof def.description).toBe("string");
@@ -126,26 +123,6 @@ describe("index.ts wiring SDK 契约", () => {
     expect(reload).toHaveBeenCalledWith();
   });
 
-  it("xyz-navigate 空 entryId（空串/纯空白）→ 早退，不调 ctx.navigateTree", async () => {
-    const ext = await loadExtension();
-    const h = createWiringHarness();
-    ext(h.pi);
-    const { ctx, navigateTree } = createCtx();
-    await runCommand(h, "xyz-navigate", "", ctx);
-    await runCommand(h, "xyz-navigate", "   ", ctx);
-    expect(navigateTree).not.toHaveBeenCalled();
-  });
-
-  it("xyz-navigate 有效 entryId → ctx.navigateTree(entryId, { summarize: false })（args 去首尾空白）", async () => {
-    const ext = await loadExtension();
-    const h = createWiringHarness();
-    ext(h.pi);
-    const { ctx, navigateTree } = createCtx();
-    await runCommand(h, "xyz-navigate", " 0198f-entry-1  ", ctx);
-    expect(navigateTree).toHaveBeenCalledTimes(1);
-    expect(navigateTree).toHaveBeenCalledWith("0198f-entry-1", { summarize: false });
-  });
-
   it("__xyz_get_system_prompt__ → appendEntry 写 xyz:current-system-prompt（fullText/charCount/fetchedAt 形状，不写其他 customType）", async () => {
     const ext = await loadExtension();
     const h = createWiringHarness();

package/src/index.ts

@@ -1,12 +1,14 @@
 /**
- * xyz-agent extension for Pi — session tree navigation.
+ * xyz-agent extension for Pi — internal commands for the host.
  *
- * Registers the `/xyz-navigate` command. The command handler calls
- * `ctx.navigateTree()` to move the session leaf.
- *
- * Also registers `/__xyz_reload__` internal command for host-triggered
+ * Registers `/__xyz_reload__` internal command for host-triggered
  * skill/extension reload, and `/__xyz_get_system_prompt__` for the Trace
  * view fetch-current button.
+ *
+ * [HISTORICAL] The former `/xyz-navigate` session tree command was removed
+ * (2026-08-31): its bridge consumer on the runtime side was deleted in the
+ * monorepo era, so the command had no reachable caller. See
+ * docs/adr/0008-extension-bridge-for-navigate-tree.md for the original design.
  */
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
@@ -22,16 +24,6 @@ export default function (pi: ExtensionAPI): void {
     },
   });
 
-  pi.registerCommand("xyz-navigate", {
-    description: "Navigate the session tree to a specified entry",
-    handler: async (args: string, ctx: ExtensionCommandContext) => {
-      const entryId = args.trim();
-      if (!entryId) return;
-
-      await ctx.navigateTree(entryId, { summarize: false });
-    },
-  });
-
   // [fetch-current-system-prompt] Trace 视图「现取当前值」通道（session-trace design §3.1
   // 失败路径 / D2）：pi RPC 无 get_system_prompt 命令、getSystemPrompt() 只在 extension
   // API，且现取不能依赖可禁的留痕包（system-prompt-trace 是 feature tier）——挂本