pi-think-anchor 1.0.29 → 1.0.30

package/README.md

@@ -7,6 +7,8 @@
 
 # pi-think-anchor
 
+> 适用 pi ≥ 0.74 · Node ≥ 20 · MIT · 无运行时依赖（仅 peer: @earendil-works/pi-coding-agent）
+
 思维链锚定监测：读取 thinking 的词频指纹，判定专注 / 过渡 / 发散，发散时分级提示。
 
 ## 快速事实
@@ -14,7 +16,7 @@
 | 项 | 说明 |
 | --- | --- |
 | 配置文件 | ~/.pi/think-anchor.json（可省略） |
-| 命令行 | /think-anchor [on|off|reset|stats] |
+| 命令行 | /think-anchor [on, off, reset, stats] |
 | 调用方式 | **全自动**：turn_end 评估 + 条件注入。on/off 只改当前会话内存（不写文件），重启后回到配置文件的值 |
 
 ## 安装
@@ -139,7 +141,13 @@ pi install npm:pi-think-anchor
 ## 作用（源码事实）
 
 - `turn_end`：取 assistant 消息 thinking → 指纹（pos/neg/neu）→ 滑窗聚合 → 判波段；本轮命中 < `minHits` 时只推进窗口。
-- 状态机 `healthy → warning → critical`；L1/L2 干预以 `nextTurn` 尾部消息注入。
+- 状态机 `healthy → warning → critical`；L1/L2 干预以 `nextTurn` 尾部消息回灌（`display: false`），文本里带当前比率、命中量与触发阈值（如「比率 0.48 · 命中 22；react<0.5」）——让模型看到依据，而不是只收到一句指令。
+**注入样例（示意，字段可能随版本增删）**
+
+```text
+think-anchor 信号（词频启发式，非判据）：连续偏离。动作：停止探索，立即执行一个具体动作。（比率 0.48 · 命中 22；L2 1/2）
+```
+
 - 无效不升级：上次 `eff >= 0` 时 L2 降为 L1。
 - `session_start`：重置状态机，仅保留最近 3 条与 pending（跨会话结算）。
 
@@ -194,7 +202,7 @@ Chain-of-thought drift monitor: reads a word-frequency fingerprint from thinking
 | Item | Description |
 | --- | --- |
 | Config file | ~/.pi/think-anchor.json (optional) |
-| Commands | /think-anchor [on|off|reset|stats] |
+| Commands | /think-anchor [on, off, reset, stats] |
 | Automation | **Fully automatic**: evaluated on turn_end, injects only when needed. on/off changes in-memory state only (not written to disk); a restart falls back to the config file |
 
 Full config (all keys and defaults):
@@ -321,7 +329,13 @@ Full config (copy-paste ready, includes the default lexicon):
 ## What it does (source facts)
 
 - `turn_end`: reads assistant thinking -> fingerprint (pos/neg/neu) -> sliding window -> band; when hits < `minHits` it only advances the window.
-- State machine `healthy -> warning -> critical`; L1/L2 nudges are injected as `nextTurn` trailing messages.
+- State machine `healthy -> warning -> critical`; L1/L2 nudges are fed back as `nextTurn` trailing messages (`display: false`), carrying the current ratio, hit count and the triggering threshold (e.g. ratio 0.48, 22 hits, react<0.5) so the model sees the evidence, not just an order.
+**Sample injection (illustrative; fields may change between versions)**
+
+```text
+think-anchor signal (heuristic, not a verdict): sustained drift. Action: stop exploring, execute one concrete step. (ratio 0.48 · 22 hits; L2 1/2)
+```
+
 - No escalation: when the previous `eff >= 0`, L2 degrades to L1.
 - `session_start`: resets state, keeping only the last 3 samples and pending (cross-session settlement).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-think-anchor",
-  "version": "1.0.29",
+  "version": "1.0.30",
   "description": "Monitors thinking focus drift and nudges the model back on track.",
   "type": "module",
   "license": "MIT",
@@ -8,7 +8,11 @@
     "pi",
     "pi-extension",
     "pi-coding-agent",
-    "pi-package"
+    "pi-package",
+    "chain-of-thought",
+    "focus",
+    "monitoring",
+    "drift"
   ],
   "pi": {
     "extensions": [
@@ -25,7 +29,7 @@
     "@earendil-works/pi-coding-agent": "*"
   },
   "author": "15066212pp",
-  "homepage": "https://github.com/op15066212/pi-plugins-publish/tree/main/pi-think-anchor",
+  "homepage": "https://github.com/op15066212/pi-plugins-publish/tree/main/pi-think-anchor#readme",
   "bugs": {
     "url": "https://github.com/op15066212/pi-plugins-publish/issues"
   },
@@ -36,5 +40,8 @@
   },
   "scripts": {
     "prepublishOnly": "node ../publish-check.mjs"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }