pi-patch-keeper 1.0.8 → 1.0.10

package/README.en.md

@@ -23,6 +23,13 @@ Prevents "force-typed" extensions from silently swallowing every section written
 | `/patch-keeper` | Show order, suspected force packages, fallback packages, codemode status |
 | `/patch-keeper fix` | Move known force-typed packages to the end (backup written first) |
 
+## Install
+
+```bash
+pi install npm:pi-patch-keeper
+pi install ./pi-patch-keeper
+```
+
 ## Defaults
 
 | Key | Default |
@@ -32,7 +39,13 @@ Prevents "force-typed" extensions from silently swallowing every section written
 | Notify | only on problems |
 | Scope | `npm:` packages |
 
-Optional config: `~/.pi/patch-keeper-state.json`
+Optional config: `~/.pi/patch-keeper.json`
+
+## Discipline
+
+- Never `return { systemPrompt }` — otherwise it becomes the problem it guards against.
+- Writes only two places: `packages` order in `settings.json` (backup first) and the fingerprint in `~/.pi/patch-keeper.json`; failures are reported, never thrown.
+- Any error is reported as a hint, never thrown; silent when clean.
 
 ## Limits
 

package/README.md

@@ -40,7 +40,7 @@ pi 的 system prompt 由各扩展写入的 section 拼装。若某扩展在 `bef
 ## 纪律
 
 - **绝不** `return { systemPrompt }` —— 否则自己就是它要防的问题。
-- 唯一的写操作是修 `settings.json` 的 `packages`，且写前备份。
+- 写操作两处：修 `settings.json` 的 `packages`（写前备份）与更新 `~/.pi/patch-keeper.json` 的指纹；失败都只提示。
 - 任何异常只提示、不抛错；无问题不打扰。
 
 ## 安装
@@ -52,6 +52,6 @@ pi install ./pi-patch-keeper
 
 ## 限制
 
-- 静态扫描只看扩展入口前 4000 字符内 `before_agent_start` 附近的写法，动态构造的 force 检测不到。
+- 静态扫描从各入口的 `before_agent_start` 命中处起看 4000 字符（只看前 3 个入口文件），动态构造的 force 检测不到。
 - user 扩展（不在 `packages` 数组里）不在扫描范围。
 - 只处理顺序问题；不修改任何第三方扩展的源码。

package/index.ts

@@ -93,7 +93,7 @@ export function normalizeForceOrder(packages: string[], tail: string[] = DEFAULT
 }
 
 /** 读扩展入口源码并分类：无条件 force / section 优先（旧宿主兜底）/ 无。 */
-function classifyPackages(packages: string[], tail: string[]): { force: string[]; fallback: string[] } {
+export function classifyForcePackages(packages: string[], tail: string[]): { force: string[]; fallback: string[] } {
   const force: string[] = [];
   const fallback: string[] = [];
   for (const name of packages) {
@@ -127,12 +127,12 @@ function classifyPackages(packages: string[], tail: string[]): { force: string[]
 
 /** 疑似无条件 force（会吞掉其后 section）。 */
 export function scanForcePackages(packages: string[], tail: string[] = DEFAULT_FORCE_TAIL): string[] {
-  return classifyPackages(packages, tail).force;
+  return classifyForcePackages(packages, tail).force;
 }
 
 /** 兼容兜底型（section 优先，仅旧宿主 force）。 */
 export function scanForceFallbacks(packages: string[], tail: string[] = DEFAULT_FORCE_TAIL): string[] {
-  return classifyPackages(packages, tail).fallback;
+  return classifyForcePackages(packages, tail).fallback;
 }
 
 /** codemode 单点检查：禁用 builtin:codemode 时必须有替代实现，反之亦然。 */
@@ -210,9 +210,8 @@ function report(): string[] {
   const lines: string[] = [];
   const fo = forceOrderIssues(packages, tail);
   lines.push(`force顺序 : ${fo.length ? fo[0] : "OK"}`);
-  const fe = scanForcePackages(packages, tail);
+  const { force: fe, fallback: fb } = classifyForcePackages(packages, tail);
   lines.push(`疑似force: ${fe.length ? fe.join(" / ") : "无（静态扫描）"}`);
-  const fb = scanForceFallbacks(packages, tail);
   lines.push(`兼容兜底 : ${fb.length ? fb.join(" / ") : "无"}`);
   const cm = consistencyCheck((s.extensions as string[]) ?? [], packages);
   lines.push(`codemode : ${cm.length ? cm[0] : "单点一致"}`);
@@ -244,7 +243,7 @@ export default function patchKeeper(pi: ExtensionAPI): void {
       const arg = (args || "").trim().toLowerCase();
       if (arg === "fix") {
         const r = fixForceOrder();
-        ctx.ui.notify(r ? `patch-keeper: ${r}` : "patch-keeper: force 顺序已正确，无需修复", r ? "info" : "info");
+        ctx.ui.notify(r ? `patch-keeper: ${r}` : "patch-keeper: force 顺序已正确，无需修复", "info");
         return;
       }
       ctx.ui.notify(`扩展加载顺序\n${report().join("\n")}`, "info");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-patch-keeper",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Detect and fix pi extension load-order hazards: force-typed extensions silently swallow later system-prompt sections.",
   "type": "module",
   "license": "MIT",