pi-patch-keeper 1.0.9 → 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 |
@@ -34,6 +41,12 @@ Prevents "force-typed" extensions from silently swallowing every section written
 
 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
 
 - Detects static forms only; dynamic `systemPrompt` construction is not detected.

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] : "单点一致"}`);

package/package.json

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