@zhushanwen/pi-cw-tool 0.5.3 → 0.5.5

package/README.md

@@ -1,11 +1,11 @@
 # @zhushanwen/pi-cw-tool
 
-cw 2.0 的 pi extension 薄封装（Phase 2-B 适配）：
+cw 2.0 的 pi extension 薄封装：
 
 - **cw_query 工具**：只读查询透传（`status` / `frontier` / `tree` / `report`，参数面 `--unit` / `--root` / `--json` 按 cw 2.0 修正）。写命令（create / evidence submit / review submit / verify / run）不在工具面——经 bash 调 `cw`，用法以 cw-cli skill 为 SSOT。
 - **pi-cw skill**：runner 实操指南（多 unit 任务 `cw run --spawn pi` 的后台运行、监控、escalation 处置、收尾回流）。
 
-1.x 形态（cw_planning / cw_wave / cw_dev / cw_review 四个角色受限工具 + planning/wave/dev/review/merge 五个编排 agent + 四层递归编排 skill）已随 cw 1.x 命令面退役：cw 2.0 把编排智能收进引擎（runner + 账本 gate），「层主不能自审」由账本层硬保证，不再需要工具白名单承载。
+编排智能收在 cw 2.0 引擎（runner + 账本 gate），「层主不能自审」由账本层硬保证。
 
 ## 环境要求
 
@@ -18,4 +18,4 @@ pnpm typecheck   # tsc --noEmit（含 test 配置）
 pnpm test        # vitest run
 ```
 
-变更经 xyz-agent 仓的 extensions 流程校验（`pnpm extensions:typecheck && pnpm extensions:lint && pnpm extensions:test`）。
+变更经 taiji 仓的 extensions 流程校验（`pnpm extensions:typecheck && pnpm extensions:lint && pnpm extensions:test`）。

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@zhushanwen/pi-cw-tool",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "Pi extension for cw 2.0: a read-only cw_query tool (status / frontier / tree / report passthrough) + the pi-cw skill (runner practical guide for multi-unit tasks: background run, monitoring, escalation, merge back).",
   "type": "module",
   "main": "index.ts",
-  "xyz-agent": {
+  "taiji": {
     "role": "universal"
   },
   "pi": {
@@ -41,6 +41,9 @@
       "optional": true
     }
   },
+  "dependencies": {
+    "@zhushanwen/pi-ext-guards": "0.4.1"
+  },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",
     "vitest": "^4.1.8"

package/src/cw-runner.ts

@@ -14,6 +14,8 @@
  * 与 Pi SDK 解耦（不 import pi 类型），纯逻辑 + 可注入 spawner，便于单测。
  * 所有错误路径返回 `{ ok: false, error }`，不抛异常（由调用方映射为 tool 返回）。
  */
+import { toErrorMessage } from "@zhushanwen/pi-ext-guards";
+
 import type { CwSpawner } from "./cw-spawn.ts";
 
 /**
@@ -187,7 +189,7 @@ export async function executeCwAction(
 	try {
 		result = await spawner(args, undefined, cwd, combined.signal);
 	} catch (err) {
-		const msg = err instanceof Error ? err.message : String(err);
+		const msg = toErrorMessage(err);
 		return { ok: false, ...base, error: `cw spawn 失败: ${msg}` };
 	} finally {
 		if (timer) clearTimeout(timer);

package/src/cw-spawn.ts

@@ -15,6 +15,8 @@
 import { existsSync } from "node:fs";
 import { spawn } from "node:child_process";
 
+import { isEnoentError } from "@zhushanwen/pi-ext-guards";
+
 /**
  * cwd 不存在时的可操作错误文案（错误 → 权威源 worktrees.json → 重试闭环）。
  * @param cwd 不存在的路径
@@ -122,8 +124,8 @@ export const defaultCwSpawner: CwSpawner = (args, input, cwd, signal) =>
 			// [worktree-reaper-fix] 拼 cwd 进错误消息：ENOENT 的 err.message 只有 command 名，
 			// 无 cwd 线索会导致误诊（2026-08-11 事故 AI 误判"node 被卸载"）。
 			// exitCode=-1 区分于正常退出码。
-			const errCwd = err.code === "ENOENT" ? `\ncwd: ${cwd}` : "";
-			const hint = err.code === "ENOENT" && !existsSync(cwd) ? `\n${cwdMissingError(cwd)}` : "";
+			const errCwd = isEnoentError(err) ? `\ncwd: ${cwd}` : "";
+			const hint = isEnoentError(err) && !existsSync(cwd) ? `\n${cwdMissingError(cwd)}` : "";
 			finish({ stdout, stderr: `${stderr}\n[spawn error] ${err.message}${errCwd}${hint}`, exitCode: -1 });
 		});
 		child.on("close", (code: number | null) => {