pi-patch-keeper 1.3.4 → 1.3.6

package/README.md

@@ -69,28 +69,30 @@ pi install npm:pi-patch-keeper
 
 ## 原理（专业）
 
-```mermaid
-flowchart TD
-    A[factory：读 settings.json 建指纹] --> B[session_start]
-    A --> C[before_agent_start]
-    B -->|指纹变化| D[通知：手册 / 结论可能过期]
-    B -->|force 顺序错| E[备份 + 重排 packages]
-    C -->|注入版本 vs 磁盘不一致| F[通知 + nextTurn 尾部消息<br/>以磁盘为准]
+```text
+factory ─ 读 settings.json 建指纹
+        ├─▶ session_start
+        └─▶ before_agent_start
+
+session_start
+        ├─ 指纹变化 ──▶ 通知：手册 / 结论可能过期
+        └─ force 顺序错 ──▶ 备份 + 重排 packages
+
+before_agent_start
+        └─ 注入版本 vs 磁盘不一致 ──▶ 通知 + nextTurn 尾部消息（以磁盘为准）
 ```
 
 ## 原理（小白）
 
 **像出门前的门卫**，检查三件事：开关是否一致、排队顺序对不对、手里的说明书是不是最新版；能顺手修的直接修，修不了就提醒你。
 
-```mermaid
-flowchart TD
-    A[启动] --> B[门卫三项检查]
-    B --> C{开关一致?}
-    B --> D{顺序对不对?}
-    B --> E{说明书最新?}
-    C -->|否| F[提醒]
-    D -->|否| G[直接调好]
-    E -->|否| H[提醒：以手上为准]
+```text
+启动
+        ↓
+门卫三项检查
+        ├─ 开关一致？否 ──▶ 提醒
+        ├─ 顺序对不对？否 ──▶ 直接调好
+        └─ 说明书最新？否 ──▶ 提醒：以手上为准
 ```
 
 ## License
@@ -164,28 +166,30 @@ Injection mismatch: injected v22.172 != disk v22.173 (disk wins) -> the injected
 
 ## How it works (technical)
 
-```mermaid
-flowchart TD
-    A[factory: build fingerprint from settings.json] --> B[session_start]
-    A --> C[before_agent_start]
-    B -->|fingerprint changed| D[notify: manuals may be stale]
-    B -->|force order wrong| E[backup + reorder packages]
-    C -->|injected vs disk mismatch| F[notify + nextTurn message<br/>trust disk]
+```text
+factory: build fingerprint from settings.json
+        ├─▶ session_start
+        └─▶ before_agent_start
+
+session_start
+        ├─ fingerprint changed ──▶ notify: manuals may be stale
+        └─ force order wrong ──▶ backup + reorder packages
+
+before_agent_start
+        └─ injected vs disk mismatch ──▶ notify + nextTurn message (trust disk)
 ```
 
 ## How it works (plain words)
 
 **Like a doorman** before you leave: checks three things — switches agree, queue order is right, the manual in hand is the latest version; fixes what it can and tells you the rest.
 
-```mermaid
-flowchart TD
-    A[startup] --> B[doorman: three checks]
-    B --> C{switches agree?}
-    B --> D{order right?}
-    B --> E{manual latest?}
-    C -->|no| F[notify]
-    D -->|no| G[fix directly]
-    E -->|no| H[notify: trust the copy in hand]
+```text
+startup
+        ↓
+doorman: three checks
+        ├─ switches agree? no ──▶ notify
+        ├─ order right? no ──▶ fix directly
+        └─ manual latest? no ──▶ notify: trust the copy in hand
 ```
 ## License
 

package/index.ts

@@ -7,7 +7,7 @@
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 
-import { existsSync, readFileSync, writeFileSync, copyFileSync, renameSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, copyFileSync, renameSync, rmSync } from "node:fs";
 
 import { createHash } from "node:crypto";
 import * as os from "node:os";
@@ -47,11 +47,33 @@ function safeRead(p: string): string | null {
   try { return readFileSync(p, "utf8"); } catch { return null; }
 }
 
-/** 原子写：临时文件 + rename（崩溃/被杀不留半写文件）。 */
+/** 原子写：临时文件 + rename（崩溃/被杀不留半写文件）。
+ * Windows 上 rename 覆盖**正被打开**的文件会抛 EPERM（实测：pi 落盘 / 杀软扫描期间）；
+ * 故对占用类错误退避重试（80ms 起，共 6 次），其它错误立即失败；仍失败清掉 tmp。 */
 function writeAtomic(file: string, data: string | Buffer): void {
   const tmp = file + ".tmp-" + process.pid;
-  writeFileSync(tmp, data);
-  renameSync(tmp, file);
+  try {
+    writeFileSync(tmp, data);
+    let lastErr: unknown = null;
+    for (let attempt = 0; attempt < 6; attempt++) {
+      try { renameSync(tmp, file); lastErr = null; break; }
+      catch (err) {
+        lastErr = err;
+        const code = (err as NodeJS.ErrnoException).code;
+        if (code !== "EPERM" && code !== "EBUSY" && code !== "EACCES") break;
+        sleepMs(80 * (attempt + 1));
+      }
+    }
+    if (lastErr) throw lastErr;
+  } catch (err) {
+    try { rmSync(tmp, { force: true }); } catch { /* ignore */ }
+    throw err;
+  }
+}
+
+/** 同步等待（writeAtomic 重试用）：同步上下文没有 await。 */
+function sleepMs(ms: number): void {
+  try { Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms); } catch { /* ignore */ }
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.3.4",
+  "version": "1.3.6",
   "description": "pi config guards: codemode single-source check, force-order guard (auto-fix), settings fingerprint drift, injected-manual alignment. (PiDeck / third-party source patches are a local-only module, not bundled.)",
   "type": "module",
   "license": "MIT",