pi-ptc-meter 1.0.27 → 1.0.29

package/README.md

@@ -7,7 +7,7 @@
 
 # pi-ptc-meter
 
-> 适用 pi ≥ 0.74 · Node ≥ 20 · MIT · 无运行时依赖（仅 peer: @earendil-works/pi-coding-agent）
+> 适用 pi · Node ≥ 22.19 · MIT · 无运行时依赖（仅 peer: @earendil-works/pi-coding-agent）
 
 每轮工具调用计量：记录调用次数与耗时，与开工前声明的估算对比后，把实际值与偏差回灌给模型。
 
@@ -58,7 +58,7 @@ pi install npm:pi-ptc-meter
 
 - `tool_call`：顶层调用计数 +1（codemode 内层调用不另计；不拦截、不改调用）。
 - `turn_end`：记录本轮次数与耗时（不落盘）。
-- `agent_end`：每 run 落盘一行日志。
+- `agent_end`：每 run 落盘一行日志；goal 自动续轮共享同一 run 时，`turn_end` 超阈值即提示一次（每 run 一次），避免回路整段失效。
 - `before_agent_start`：结算上一轮并以 `nextTurn` 尾部消息回灌——计数、耗时、偏差、基线中位、**缓存命中率**（仅当该轮有 usage 数据时出现；< 90% 标「低」）——（`display: false`）。
 
 **注入样例（示意，字段可能随版本增删）**
@@ -165,7 +165,7 @@ Also: log `~/.pi/ptc-meter.jsonl` (1 MiB truncation, tail-preserving); no enviro
 
 - `tool_call`: increments the counter for top-level calls only (nested codemode calls are not counted separately; never intercepts or rewrites).
 - `turn_end`: records calls and duration (no disk write).
-- `agent_end`: writes one log line per run.
+- `agent_end`: writes one log line per run.; when goal auto-continuation shares one run, `turn_end` warns once above threshold (once per run) so the loop never goes dark.
 - `before_agent_start`: settles the previous turn and feeds back counts, duration, deviation, the baseline median and the **cache hit rate** (only when that turn reported usage; flagged low below 90%) as a `nextTurn` trailing message (`display: false`).
 
 **Sample injection (illustrative; fields may change between versions)**

package/index.ts

@@ -66,7 +66,9 @@ function threshold(): number {
 // 轮内计数（反馈回路：随注入回到上下文，见 before_agent_start）
 let callsThisTurn = 0;
 let lastCompletedCalls = -1; // 已完成轮的调用数（agent_end 落盘后置位；before_agent_start 缺席时仍可回灌）
-let injectedThisTurn = false; // 本轮是否已由 before_agent_start 注入（缺席时由 agent_end 补发）
+  let injectedThisTurn = false; // 本轮是否已由 before_agent_start 注入（缺席时由 agent_end 补发）
+  // goal 长跑：agent_end 可能整 run 不触发（续轮不发 user message）→ 超阈值即时补发一次，避免回路整段失效
+  let warnedThisRun = false; // 安全阀是否已在本 run 内提示过
 let lastTurnCalls = -1;
 let lastTurnMs = -1;
 let lastTurnEst: number | null = null;
@@ -299,6 +301,16 @@ export default function ptcMeter(pi: ExtensionAPI) {
         const ec = em ? parseInt(em[1], 10) : 0;
         if (ec > 0 && lastTurnEstCalls === null) lastTurnEstCalls = ec; // 同上：首个声明
       } catch { lastTurnEstCalls = null; }
+      // 安全阀：goal 自动续轮共享同一 run，agent_end 可能迟迟不触发——超阈值即提示一次
+      if (!injectedThisTurn && !warnedThisRun && callsThisTurn >= threshold()) {
+        try {
+          (pi as unknown as { sendMessage?: (m: unknown, o?: unknown) => void }).sendMessage?.(
+            { customType: SECTION_KEY, content: "PTC：本轮已 " + callsThisTurn + " 次（阈值 " + threshold() + "）→ 先合并可并调用，再继续。", display: false },
+            { deliverAs: "nextTurn" },
+          );
+          warnedThisRun = true;
+        } catch { /* 静默 */ }
+      }
     } catch { /* 静默 */ }
   });
 
@@ -318,6 +330,7 @@ export default function ptcMeter(pi: ExtensionAPI) {
       lastCompletedCalls = calls;
       callsThisTurn = 0;
       turnStartedAt = Date.now();
+      warnedThisRun = false;
       // D16：自动续轮下 before_agent_start 可能缺席——本轮未注入过则补发一次尾部回灌，保证反馈不断链（2026-10-17 实证：本轮无任何回灌行）。
       if (!injectedThisTurn && loadConf().inject !== false) {
         lastTurnCalls = calls;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ptc-meter",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "description": "Measures tool-call batching per turn and feeds the numbers back to the model.",
   "type": "module",
   "license": "MIT",