pi-patch-keeper 1.2.6 → 1.2.7

package/README.md

@@ -39,9 +39,18 @@ pi install npm:pi-patch-keeper
 - `before_agent_start`：比对注入手册版本与磁盘版本；不一致时通知并以 `nextTurn` 尾部消息提示模型以磁盘为准；**不返回 `systemPrompt`**。
 - 写盘用临时文件 + rename；修复前备份。
 
-## 不在本包内
 
-PiDeck builtin 补丁恢复、asar 只读检测、pi-lens / pi-memory / pi-tactician 源码补丁、本机快照恢复 —— 依赖 PiDeck 安装目录与第三方包内部实现，只在本机模块 `patch-keeper-local` 中，不发布。
+```mermaid
+flowchart TD
+    A[factory] --> B[读 settings.json 建指纹]
+    B --> C[session_start]
+    C --> D{指纹变化?}
+    D -->|是| E[通知：手册/结论可能过期]
+    C --> F{force 顺序错?}
+    F -->|是| G[备份 + 重排 packages]
+    C --> H[before_agent_start<br/>比对注入手册版本与磁盘]
+    H -->|不一致| I[通知 + nextTurn 尾部消息<br/>以磁盘为准]
+```
 
 ## License
 
@@ -85,9 +94,18 @@ No config file (only reads `settings.json` and `APPEND_SYSTEM.md`); no environme
 - `before_agent_start`: compares the injected manual version with disk; on mismatch it notifies and sends a `nextTurn` message telling the model to trust disk; **never returns `systemPrompt`**.
 - Writes are atomic (temp file + rename); a backup precedes any repair.
 
-## Not in this package
 
-PiDeck builtin patch restore, read-only asar checks, pi-lens / pi-memory / pi-tactician source patches, local snapshot restore — they depend on the PiDeck install dir and third-party internals, and live only in the local module `patch-keeper-local` (not published).
+```mermaid
+flowchart TD
+    A[factory] --> B[read settings.json, build fingerprint]
+    B --> C[session_start]
+    C --> D{fingerprint changed?}
+    D -->|yes| E[notify: manuals may be stale]
+    C --> F{force order wrong?}
+    F -->|yes| G[backup + reorder packages]
+    C --> H[before_agent_start<br/>compare injected manual vs disk]
+    H -->|mismatch| I[notify + nextTurn message<br/>trust disk]
+```
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "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",