@zhushanwen/pi-ext-guards 0.4.2 → 0.4.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/pi-ext-guards",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Shared runtime-environment guards for Pi extensions — oncePerProcess(key, fn) dedupes cross-session side-effect operations against pi factory re-invocation and handler accumulation (shared library, not a Pi extension, zero dependencies).",
   "type": "module",
   "main": "src/index.ts",

package/src/__tests__/predicates.test.ts

@@ -1,14 +1,16 @@
 // src/__tests__/predicates.test.ts
 //
-// isRecord / isEnoentError / isSubagentProcess 单测（ext-simplify-17 D3/D2/D4 新导出）：
+// isRecord / isEnoentError / isErrnoWithCode / isSubagentProcess 单测
+//（ext-simplify-17 D3/D2/D4 新导出 + isErrnoWithCode errno 守卫上收）：
 //   - isRecord 排数组严版：数组必须 false（钉值，防回退到允数组宽版）
 //   - isEnoentError scheduler 严版：仅 Error 子类 + code === "ENOENT" 才 true，
 //     非 Error 对象带 code 是宽版才接受的形态，严版必须 false
+//   - isErrnoWithCode：isEnoentError 的 code 参数化形态，收窄纪律同源
 //   - isSubagentProcess 三态 + env 注入隔离 + 旧键宁缺勿污钉值（D4 重锚定）
 
 import { describe, expect, it } from "vitest";
 
-import { isEnoentError, isRecord, isSubagentProcess } from "../index.ts";
+import { isEnoentError, isErrnoWithCode, isRecord, isSubagentProcess } from "../index.ts";
 
 describe("isRecord", () => {
 	it("对象 true", () => {
@@ -58,6 +60,32 @@ describe("isEnoentError", () => {
 	});
 });
 
+describe("isErrnoWithCode", () => {
+	it("Error 带 code=期望值 true（Node fs 错误的构造形态）", () => {
+		expect(isErrnoWithCode(Object.assign(new Error("exists"), { code: "EEXIST" }), "EEXIST")).toBe(
+			true,
+		);
+	});
+
+	it("code 为其他值 false", () => {
+		expect(isErrnoWithCode(Object.assign(new Error("exists"), { code: "EEXIST" }), "EACCES")).toBe(
+			false,
+		);
+	});
+
+	it("普通 Error false（无 code 属性）", () => {
+		expect(isErrnoWithCode(new Error("x"), "EEXIST")).toBe(false);
+	});
+
+	it("非 Error 对象带同名 code false（与 isEnoentError 同一严版口径）", () => {
+		expect(isErrnoWithCode({ code: "EEXIST" }, "EEXIST")).toBe(false);
+	});
+
+	it("undefined false", () => {
+		expect(isErrnoWithCode(undefined, "EEXIST")).toBe(false);
+	});
+});
+
 describe("isSubagentProcess", () => {
 	it("TAIJI_AGENT_SUBAGENT=1 命中（引擎 spawn 链恒注入的现行标记）", () => {
 		expect(isSubagentProcess({ TAIJI_AGENT_SUBAGENT: "1" })).toBe(true);

package/src/index.ts

@@ -116,6 +116,18 @@ export function isEnoentError(err: unknown): boolean {
 	return err instanceof Error && "code" in err && err.code === "ENOENT";
 }
 
+/**
+ * 判断 error 是否为带指定 errno code 的 Node 系统调用错误（`Error` 实例且
+ * `code === 期望值`）。
+ *
+ * 与 isEnoentError 同一收窄纪律（`"code" in err` 零断言——taste/no-unsafe-cast），
+ * code 参数化：isEnoentError = code 钉死 "ENOENT" 的特化形态。非 Error 对象即使带
+ * 同名 code 也 false（与 isEnoentError 的严版口径一致——Node fs 抛错恒为 Error 实例）。
+ */
+export function isErrnoWithCode(error: unknown, code: string): boolean {
+	return error instanceof Error && "code" in error && error.code === code;
+}
+
 // ── subagent 进程判据（isSubagentProcess，ext-simplify-17 D4）────────────
 //
 // 背景：extension 需要知道「当前 pi 进程是否引擎链上的 subagent 子进程」来决定降级
@@ -163,9 +175,10 @@ export function isSubagentProcess(
 /**
  * pi ExtensionRunner 在 session 替换后标记 stale ctx 的错误文案片段。
  *
- * pi 语义断言（0.84.4 实装：runner.js `invalidate()` 默认 message + `assertActive()`
- * `throw new Error(this.staleMessage)`），登记于 docs/pi-semantics.json PS-30
- * （探针：extensions/shared/ext-guards/src/__tests__/pi-semantics-stale-ctx-wording.test.ts），
+ * pi 语义断言（语义登记 docs/pi-semantics.json PS-30，verifiedWith 以该登记为准：
+ * runner.js `invalidate()` 默认 message + `assertActive()`
+ * `throw new Error(this.staleMessage)`；
+ * 探针：extensions/shared/ext-guards/src/__tests__/pi-semantics-stale-ctx-wording.test.ts），
  * 随 C-proc-08 pi 版本门禁自动重验。文案变更时守卫退化为「全部上抛」（回到现状崩溃链路，
  * 有 pi-crash log 取证，不更危险），门禁报红提示更新分诊词。
  */