pi-patch-keeper 1.3.1 → 1.3.3

package/README.en.md

@@ -1,41 +1,9 @@
 # pi-patch-keeper
 
-pi configuration guards: codemode consistency, force order, settings fingerprint drift, injected-manual alignment. **No PiDeck or third-party source patching.**
+pi configuration guards: codemode consistency, force order, settings fingerprint drift, manual alignment.
 
-## Install
+**English documentation:** [open the English section](README.md#english) · **中文文档：** [中文](README.md#zh)
 
-```bash
-pi install npm:pi-patch-keeper
-```
+    pi install npm:pi-patch-keeper
 
-## Configuration
-
-No config file (only reads `settings.json` and `APPEND_SYSTEM.md`); no environment variables.
-
-| State file | Description |
-| --- | --- |
-| `~/.pi/patch-keeper.json` | Settings fingerprint from the previous start (drift compare) |
-| `~/.pi/patch-keeper-manual.json` | Manual version + content signature |
-| `~/.pi/agent/settings.json.bak-force-order-*` | Backup before a force-order repair |
-
-## Commands
-
-| Command | Purpose |
-| --- | --- |
-| `/patch-keeper` | codemode / force / fingerprint / injection-alignment status |
-| `/patch-keeper fix` | Repair force order in `packages` (with backup) |
-
-## What it does (source facts)
-
-- factory: builds the fingerprint from `settings.json`.
-- `session_start`: compares the fingerprint, repairs force order, reports drift and manual drift (notification only).
-- `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).
-
-## License
-
-MIT
+Source: https://github.com/op15066212/pi-plugins-publish

package/README.md

@@ -7,6 +7,8 @@
 
 # pi-patch-keeper
 
+> 适用 pi ≥ 0.74 · Node ≥ 20 · MIT · 无运行时依赖（仅 peer: @earendil-works/pi-coding-agent）
+
 pi 配置守卫：codemode 一致性、force 顺序、环境指纹漂移、注入手册对齐。**不含 PiDeck 与第三方源码补丁。**
 
 ## 快速事实
@@ -56,7 +58,13 @@ pi install npm:pi-patch-keeper
 
 - factory：读 `settings.json` 建指纹。
 - `session_start`：比对指纹 → 修复 force 顺序 → 报漂移与手册漂移（只通知）。
-- `before_agent_start`：比对注入手册版本与磁盘版本；不一致时通知并以 `nextTurn` 尾部消息提示模型以磁盘为准；**不返回 `systemPrompt`**。
+- `before_agent_start`：比对注入手册版本与磁盘版本；不一致时通知并以 `nextTurn` 尾部消息回灌提示模型以磁盘为准（`display: false`）；**不返回 `systemPrompt`**。
+**注入样例（示意，字段可能随版本增删）**
+
+```text
+注入对齐：注入 v22.172 ≠ 磁盘 v22.173（观察者 = 磁盘版）→ 注入版不可作判断依据；动作：读回全文后执行，重启后自愈。
+```
+
 - 写盘用临时文件 + rename；修复前备份。
 
 ## 原理（专业）
@@ -125,6 +133,15 @@ Config file `~/.pi/patch-keeper.json` (optional); no environment variables.
 | `~/.pi/patch-keeper-manual.json` | Manual version + content signature |
 | `~/.pi/agent/settings.json.bak-force-order-*` | Backup before a force-order repair |
 
+Full config:
+
+```json
+{
+  "forceTail": ["npm:pi-rtk-optimizer", "npm:pi-cache-optimizer"]
+}
+```
+
+
 ## Commands
 
 | Command | Purpose |
@@ -136,7 +153,13 @@ Config file `~/.pi/patch-keeper.json` (optional); no environment variables.
 
 - factory: builds the fingerprint from `settings.json`.
 - `session_start`: compares the fingerprint, repairs force order, reports drift and manual drift (notification only).
-- `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`**.
+- `before_agent_start`: compares the injected manual version with disk; on mismatch it notifies and feeds back a `nextTurn` message (`display: false`) telling the model to trust disk; **never returns `systemPrompt`**.
+**Sample injection (illustrative; fields may change between versions)**
+
+```text
+Injection mismatch: injected v22.172 != disk v22.173 (disk wins) -> the injected copy is not evidence; action: read the full file and continue; self-heals after restart.
+```
+
 - Writes are atomic (temp file + rename); a backup precedes any repair.
 
 ## How it works (technical)

package/index.ts

@@ -9,6 +9,7 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 
 import { existsSync, readFileSync, writeFileSync, copyFileSync, renameSync } from "node:fs";
 
+import { createHash } from "node:crypto";
 import * as os from "node:os";
 
 import * as path from "node:path";
@@ -39,7 +40,6 @@ function manualVer(text: string): string | null {
 }
 
 
-type Result = { ok: boolean; detail: string };
 
 
 /** 读文件；失败返回 null（永不抛）。 */
@@ -54,12 +54,6 @@ function writeAtomic(file: string, data: string | Buffer): void {
   renameSync(tmp, file);
 }
 
-/** 统计 needle 在原串里的出现次数。 */
-function count(hay: string, needle: string): number {
-  let n = 0, i = 0;
-  while ((i = hay.indexOf(needle, i)) >= 0) { n += 1; i += needle.length; }
-  return n;
-}
 
 
 // ── 环境指纹：settings 关键字段漂移 → 提示「手册 / 验证结论可能过期」

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "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",
@@ -11,7 +11,9 @@
     "pi-coding-agent",
     "pi-extension",
     "pi-package",
-    "pideck"
+    "pideck",
+    "config-guard",
+    "load-order"
   ],
   "pi": {
     "extensions": [
@@ -28,7 +30,7 @@
     "@earendil-works/pi-coding-agent": "*"
   },
   "author": "15066212pp",
-  "homepage": "https://github.com/op15066212/pi-plugins-publish/tree/main/pi-patch-keeper",
+  "homepage": "https://github.com/op15066212/pi-plugins-publish/tree/main/pi-patch-keeper#readme",
   "bugs": {
     "url": "https://github.com/op15066212/pi-plugins-publish/issues"
   },
@@ -39,5 +41,8 @@
   },
   "scripts": {
     "prepublishOnly": "node ../publish-check.mjs"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }