@zhushanwen/pi-agent-ext 1.2.1 → 1.3.0

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@zhushanwen/pi-agent-ext",
-  "version": "1.2.1",
-  "description": "xyz-agent extension for Pi — internal host commands for extension reload and system prompt fetch",
+  "version": "1.3.0",
+  "description": "taiji extension for Pi — internal host commands for extension reload and system prompt fetch",
   "type": "module",
   "main": "src/index.ts",
-  "xyz-agent": {
+  "taiji": {
     "role": "taiji"
   },
   "pi": {

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 / getSystemPrompt），
+ * - ctx 只需 index.ts 实际消费的字段（getSystemPrompt），
  *   以 ExtensionCommandContext 最小形状驱动 handler（SDK 双参契约 (args, ctx)）
  * - index.ts 对 @earendil-works/pi-coding-agent 是 type-only import（运行时擦除），
  *   无需 vi.mock SDK 模块
  *
- * 锚定两命令注册面 + handler 行为：
- * - __xyz_reload__（host 触发的 skill/extension 重载内部命令）→ ctx.reload()
- * - __xyz_get_system_prompt__（Trace 视图「现取当前值」通道）→ pi.appendEntry
- *   写 xyz:current-system-prompt custom entry（fullText/charCount/fetchedAt 形状）
+ * 锚定命令注册面 + handler 行为：
+ * - __taiji_get_system_prompt__（Trace 视图「现取当前值」通道）→ pi.appendEntry
+ *   写 taiji:current-system-prompt custom entry（fullText/charCount/fetchedAt 形状）
  *
- * [HISTORICAL] xyz-navigate（session tree 导航）命令及其测试随命令删除一并移除
+ * [HISTORICAL] session tree 导航命令（旧品牌时期命名）及其测试随命令删除一并移除
  * （2026-08-31，桥接对端 runtime 消费端已在 monorepo 时代删除）。
+ * [HISTORICAL] __taiji_reload__ 及其测试随 W5 skill 变更→pi reload 编排退役一并移除
+ * （2026-09-25，消费端已 D7 切源 taiji SkillRegistry，pi 侧列表滞后归 ADR-0050 降级）。
  *
  * 运行：cd extensions/taiji/agent-ext && npx vitest run
  */
@@ -63,20 +64,17 @@ function createWiringHarness(): WiringHarness {
   return { pi, commands, entries };
 }
 
-/** ctx 假体（index.ts 实际消费：reload / getSystemPrompt；vi.fn 捕获调用）。 */
+/** ctx 假体（index.ts 实际消费：getSystemPrompt；vi.fn 捕获调用）。 */
 function createCtx(prompt = "current system prompt"): {
   ctx: ExtensionCommandContext;
-  reload: ReturnType<typeof vi.fn>;
   getSystemPrompt: ReturnType<typeof vi.fn>;
 } {
-  const reload = vi.fn();
   const getSystemPrompt = vi.fn(() => prompt);
   const ctx = {
     cwd: "/home/user/project",
-    reload,
     getSystemPrompt,
   } as unknown as ExtensionCommandContext;
-  return { ctx, reload, getSystemPrompt };
+  return { ctx, getSystemPrompt };
 }
 
 /** 以 SDK 双参契约 (args, ctx) 驱动已注册命令 handler。 */
@@ -98,14 +96,11 @@ async function loadExtension(): Promise<(pi: ExtensionAPI) => void> {
 }
 
 describe("index.ts wiring SDK 契约", () => {
-  it("注册恰好两个命令（__xyz_reload__ / __xyz_get_system_prompt__），各带非空 description", async () => {
+  it("注册恰好一个命令（__taiji_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__",
-    ]);
+    expect([...h.commands.keys()]).toEqual(["__taiji_get_system_prompt__"]);
     for (const def of h.commands.values()) {
       expect(typeof def.description).toBe("string");
       expect(def.description.length).toBeGreaterThan(0);
@@ -113,27 +108,17 @@ describe("index.ts wiring SDK 契约", () => {
     }
   });
 
-  it("__xyz_reload__ handler → 调 ctx.reload()（host 触发的 skill/extension 重载，无参）", async () => {
-    const ext = await loadExtension();
-    const h = createWiringHarness();
-    ext(h.pi);
-    const { ctx, reload } = createCtx();
-    await runCommand(h, "__xyz_reload__", "", ctx);
-    expect(reload).toHaveBeenCalledTimes(1);
-    expect(reload).toHaveBeenCalledWith();
-  });
-
-  it("__xyz_get_system_prompt__ → appendEntry 写 xyz:current-system-prompt（fullText/charCount/fetchedAt 形状，不写其他 customType）", async () => {
+  it("__taiji_get_system_prompt__ → appendEntry 写 taiji:current-system-prompt（fullText/charCount/fetchedAt 形状，不写其他 customType）", async () => {
     const ext = await loadExtension();
     const h = createWiringHarness();
     ext(h.pi);
     const prompt = "prompt body\nline-1";
     const { ctx, getSystemPrompt } = createCtx(prompt);
-    await runCommand(h, "__xyz_get_system_prompt__", "", ctx);
+    await runCommand(h, "__taiji_get_system_prompt__", "", ctx);
 
     expect(getSystemPrompt).toHaveBeenCalledTimes(1);
     expect(h.entries).toHaveLength(1);
-    expect(h.entries[0]?.customType).toBe("xyz:current-system-prompt");
+    expect(h.entries[0]?.customType).toBe("taiji:current-system-prompt");
     const data = h.entries[0]?.data as Record<string, unknown>;
     expect(data.fullText).toBe(prompt);
     expect(data.charCount).toBe(prompt.length);

package/src/index.ts

@@ -1,45 +1,40 @@
 /**
- * xyz-agent extension for Pi — internal commands for the host.
+ * taiji extension for Pi — internal commands for the host.
  *
- * Registers `/__xyz_reload__` internal command for host-triggered
- * skill/extension reload, and `/__xyz_get_system_prompt__` for the Trace
+ * Registers `/__taiji_get_system_prompt__` for the Trace
  * view fetch-current button.
  *
- * [HISTORICAL] The former `/xyz-navigate` session tree command was removed
+ * [HISTORICAL] The former session tree navigation 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.
+ * monorepo era, so the command had no reachable caller. See the ADR-0008
+ * note in the retired-decisions genealogy of docs/adr/decisions.md for the
+ * original design.
+ * [HISTORICAL] `/__taiji_reload__` was removed (2026-09-25): the W5
+ * skill-change→pi-reload orchestration was retired — slash menu and composer
+ * injection resolve skills from the taiji SkillRegistry (D7 source switch),
+ * so a full pi reload (extension ctx invalidate + clearExtensionCache, which
+ * broke background-task completion notifications in the stale module world)
+ * bought nothing but stale-pi-side lists, accepted per ADR-0050 degradation.
  */
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 
 export default function (pi: ExtensionAPI): void {
-  // W5: builtin internal reload command. `/__xyz_reload__` 由 host 在 skill 文件变动时
-  // 经 client.prompt 发起（不经 LLM），handler 调 pi ctx.reload() 重扫 skill + 重建 runtime。
-  // 双下划线前缀 = 内部命令（前端 W4 internal-command-filter 过滤 `/__` 前缀不显示）。
-  pi.registerCommand('__xyz_reload__', {
-    description: 'Internal: reload skills/extensions/prompts (triggered by host on skill file change)',
-    handler: async (_args: string, ctx: ExtensionCommandContext) => {
-      await ctx.reload();
-    },
-  });
-
   // [fetch-current-system-prompt] Trace 视图「现取当前值」通道（session-trace design §3.1
   // 失败路径 / D2）：pi RPC 无 get_system_prompt 命令、getSystemPrompt() 只在 extension
   // API，且现取不能依赖可禁的留痕包（system-prompt-trace 是 feature tier）——挂本
-  // infrastructure 包（builtin 不可禁，原根目录 xyz-agent-extension.js 常驻文件随 main
-  // 的 agent-ext 包化迁移至此）。host 经 client.prompt 发 /__xyz_get_system_prompt__
+  // infrastructure 包（builtin 不可禁）。host 经 client.prompt 发 /__taiji_get_system_prompt__
   // （双下划线 = 内部命令，前端过滤 /__ 前缀不显示），handler 取当前 system prompt 写
-  // xyz:current-system-prompt custom entry（不进 LLM context，零模型侧影响——pi
+  // taiji:current-system-prompt custom entry（不进 LLM context，零模型侧影响——pi
   // sessionEntryToContextMessages 对 type=custom 落入末尾 return []，session-manager.ts:383-413），
   // runtime 轮询 get_entries(since) 拉到后返回前端（同条 entry 也会作为 DATA 行出现在 trace
   // 台账里，留下取值痕迹）。
-  pi.registerCommand("__xyz_get_system_prompt__", {
+  pi.registerCommand("__taiji_get_system_prompt__", {
     description:
       "Internal: append a custom entry with the current system prompt (host-initiated for the Trace view fetch-current button)",
     handler: async (_args: string, ctx: ExtensionCommandContext) => {
       const fullText = ctx.getSystemPrompt();
-      pi.appendEntry("xyz:current-system-prompt", {
+      pi.appendEntry("taiji:current-system-prompt", {
         fullText,
         charCount: fullText.length,
         fetchedAt: new Date().toISOString(),