@nightpainters/dsh-ling 1.5.3 → 1.6.0

package/lib/host/lifecycle.js

@@ -1,4 +1,4 @@
-// dsh-ling host — lifecycle wiring (REPORT-02 / DESIGN §4.4):
+// dsh-ling host — lifecycle wiring(事件的接线层;DESIGN.md §4.4 有本节的结构说明):
 //   session events → freeze gate state, snapshot freeze, incremental capture.
 // Every handler is defensive (payload shapes verified at M1b live probe).
 import { svc, pick, isMemoryEligibleHeader, sessionKind, utcIso } from './util.js';
@@ -8,6 +8,38 @@ import { summarizeDsh } from './summarizer.js';
 import { extractMessageText, messageSourceKind } from './snapshot.js';
 import { currentMode } from './mode.js';
 
+// ── 丢弃计数(2026-10-04,P1 第三件)──────────────────────────────────────────────
+//   病灶:两条写入路径的**过滤全是静默的** —— 只记"写进去了多少",不记"丢掉了多少、为什么丢"。
+//   于是"库里为什么只有 1.8% 的现场"这个问题,只能靠事后拿磁盘日志逐事件重放才答得出来
+//   (2026-10-04 的 P1 侦察就是这么干的,花了一整路子代理)。主人拍板"P1 三件做",这是其中的可观测项。
+//
+//   落点 `dbg.event_stats` = 本轮(重启以来)扫过多少、按类型/来源/空正文/无会话/子代理各丢多少。
+//   ⚠️ Path A 是**逐事件**回调 ⇒ 计数先在内存累加,每 `EV_STATS_FLUSH_EVERY` 次或 `EV_STATS_FLUSH_MS`
+//   才落一次 kv —— 否则会给每个事件加两次 sqlite 往返,而这条路径在每个会话里都极高频。
+const EV_STATS_FLUSH_EVERY = 20;
+const EV_STATS_FLUSH_MS = 5000;
+const evStats = { seen: 0, kept: 0, dropType: 0, dropSource: 0, dropEmpty: 0, dropNoSession: 0, dropSubagent: 0, types: {}, lastSid: '' };
+let evStatsDirty = 0;
+let evStatsAt = 0;
+/** 落盘(节流)。`force` 用于收尾/关键点。写不进去不影响主流程 —— 它只是诊断。 */
+function flushEventStats(memory, force = false) {
+  evStatsDirty += 1;
+  const nowMs = Date.now();
+  if (!force && evStatsDirty < EV_STATS_FLUSH_EVERY && nowMs - evStatsAt < EV_STATS_FLUSH_MS) return;
+  evStatsDirty = 0;
+  evStatsAt = nowMs;
+  try {
+    const types = Object.entries(evStats.types).sort((a, b) => b[1] - a[1]).slice(0, 12);
+    memory.kvSet('dbg.event_stats', JSON.stringify({
+      at: new Date(nowMs).toISOString(),
+      seen: evStats.seen, kept: evStats.kept,
+      dropType: evStats.dropType, dropSource: evStats.dropSource, dropEmpty: evStats.dropEmpty,
+      dropNoSession: evStats.dropNoSession, dropSubagent: evStats.dropSubagent,
+      lastSid: evStats.lastSid, types: Object.fromEntries(types),
+    }).slice(0, 1500));
+  } catch { /* 诊断写不进去不影响主流程 */ }
+}
+
 export function wireLifecycle(ctx, gate, memory, settings, config) {
   const disposers = [];
   const wrap = (label, fn) => {
@@ -23,6 +55,7 @@ export function wireLifecycle(ctx, gate, memory, settings, config) {
   // 清掉上次的诊断残留,保证每次重启后诊断只反映本轮真实情况
   memory.kvSet('dbg.first_event_sample', '');
   memory.kvSet('dbg.event_no_session', '');
+  memory.kvSet('dbg.event_stats', '');
   memory.kvSet('lifecycle.wired', '1');
 
   const inTrackedWorkspace = () => {
@@ -141,6 +174,12 @@ export function wireLifecycle(ctx, gate, memory, settings, config) {
   disposers.push(
     ctx.on('session/event', wrap('event-capture', (session, event) => {
       const type = event?.type;
+      // 丢弃计数(2026-10-04,P1 第三件):每个早返回都记一笔 —— 这些 return 以前是静默的。
+      evStats.seen += 1;
+      if (type) {
+        evStats.types[type] = (evStats.types[type] || 0) + 1;
+        evStats.lastSid = String(session?.id ?? session?.header?.id ?? evStats.lastSid);
+      }
       if (!event) {
         if (!memory.kvGet('dbg.first_event_sample')) {
           try {
@@ -149,6 +188,7 @@ export function wireLifecycle(ctx, gate, memory, settings, config) {
             }).slice(0, 300));
           } catch {}
         }
+        flushEventStats(memory, true);
         return;
       }
       // U7(2026-10-01):feedback/* 是平台消息反馈事件 —— 早先在这里被一并丢掉,
@@ -156,25 +196,27 @@ export function wireLifecycle(ctx, gate, memory, settings, config) {
       // registerFeedbackListener 处理(它订阅同一个 session/event);本 handler 自己
       // 只用 user/assistant 消息,下面照旧过滤,互不干扰。
       const isFeedback = type === 'feedback/message-put' || type === 'feedback/message-delete';
-      if (!isFeedback && type !== 'user/message' && type !== 'assistant/message') return;
-      if (isFeedback) return; // 放行到下游订阅后,本 handler 不再往下走(免得写 dbg 诊断噪声)
+      if (!isFeedback && type !== 'user/message' && type !== 'assistant/message') { evStats.dropType += 1; flushEventStats(memory); return; }
+      if (isFeedback) { flushEventStats(memory); return; } // 放行到下游订阅后,本 handler 不再往下走(免得写 dbg 诊断噪声)
       // 只留真人消息(排除 plugin/skill-catalog/goal 注入)
-      if (type === 'user/message' && messageSourceKind(event) !== 'user') return;
+      if (type === 'user/message' && messageSourceKind(event) !== 'user') { evStats.dropSource += 1; flushEventStats(memory); return; }
       const sessionId = pick(
         () => session?.id,
         () => session?.header?.id,
         () => session?.sessionId,
       );
       if (!sessionId) {
+        evStats.dropNoSession += 1;
         if (!memory.kvGet('dbg.event_no_session')) {
           memory.kvSet('dbg.event_no_session', JSON.stringify({ type, eventKeys: Object.keys(event).slice(0, 10) }).slice(0, 300));
         }
+        flushEventStats(memory, true);
         return;
       }
       const header = pick(() => session?.header, () => session?.headerMeta);
-      if (header && !isMemoryEligibleHeader(header)) return; // 子代理/嵌套不入库(D9-a:分叉会话入枝)
+      if (header && !isMemoryEligibleHeader(header)) { evStats.dropSubagent += 1; flushEventStats(memory); return; } // 子代理/嵌套不入库(D9-a:分叉会话入枝)
       const text = extractMessageText(event);
-      if (!text) return;
+      if (!text) { evStats.dropEmpty += 1; flushEventStats(memory); return; }
       const seq = Number(event?.seq ?? (memory.rawTurnCount(sessionId) + 1));
       const time = Number(event?.time);
       const isUser = type.startsWith('user');
@@ -188,6 +230,8 @@ export function wireLifecycle(ctx, gate, memory, settings, config) {
         // 不靠"id 里有没有冒号"推断:将来若宿主会话 id 形态变了(带冒号/带前缀),这一行仍然如实可读。
         source: RAW_SOURCE_DSH,
       });
+      evStats.kept += 1;
+      flushEventStats(memory);
       if (isUser) stampModeIfFirstInput(memory, settings, String(sessionId));
     })),
   );
@@ -333,13 +377,14 @@ export function captureSessionDiff(memory, session, settings = null) {
   let added = 0;
   let userAdded = 0;
   const typeCount = {};
+  const drop = { type: 0, source: 0, empty: 0 };   // P1 第三件:丢弃计数(以前这三处 continue 全是静默的)
   const msgLike = [];
   for (const ev of events) {
     const s = Number(ev?.seq ?? 0);
     if (s > lastSeq) lastSeq = s;
     if (!s || s <= wm) continue;
     const type = ev?.type;
-    if (!type) continue;
+    if (!type) { drop.type += 1; continue; }
     typeCount[type] = (typeCount[type] || 0) + 1;
     if (String(type).includes('message') && msgLike.length < 3) {
       const data = ev?.data ?? {};
@@ -349,11 +394,11 @@ export function captureSessionDiff(memory, session, settings = null) {
         msgKeys: data?.message && typeof data.message === 'object' ? Object.keys(data.message).slice(0, 8) : null,
       });
     }
-    if (type !== 'user/message' && type !== 'assistant/message') continue;
+    if (type !== 'user/message' && type !== 'assistant/message') { drop.type += 1; continue; }
     // 只留真人消息
-    if (type === 'user/message' && messageSourceKind(ev) !== 'user') continue;
+    if (type === 'user/message' && messageSourceKind(ev) !== 'user') { drop.source += 1; continue; }
     const text = extractMessageText(ev);
-    if (!text) continue;
+    if (!text) { drop.empty += 1; continue; }
     const time = Number(ev?.time);
     memory.appendRawTurn(String(sid), {
       seq: s,
@@ -369,6 +414,16 @@ export function captureSessionDiff(memory, session, settings = null) {
   }
   if (lastSeq > wm) memory.kvSet(key, String(lastSeq));
   if (userAdded > 0 && settings) stampModeIfFirstInput(memory, settings, sid);
+  // P1 第三件(2026-10-04):把本轮的**丢弃画像**记下来 —— 以前只在 `added === 0` 且第一次时才写一条
+  //   `dbg.diff_types`,于是"正常路径上丢了多少"完全不可见(2026-10-04 的 P1 侦察就是卡在这一条上)。
+  //   现在每轮都覆盖写,并带上水位与已写/已丢的对照。
+  try {
+    memory.kvSet('dbg.diff_stats', JSON.stringify({
+      at: new Date().toISOString(), sid: String(sid), wm, lastSeq,
+      scanned: typeCount ? Object.values(typeCount).reduce((a, b) => a + b, 0) : 0,
+      added, userAdded, dropped: drop, types: Object.fromEntries(Object.entries(typeCount).sort((a, b) => b[1] - a[1]).slice(0, 12)),
+    }).slice(0, 1500));
+  } catch { /* 诊断写不进去不影响主流程 */ }
   if (added === 0 && !memory.kvGet('dbg.diff_types') && Object.keys(typeCount).length) {
     try {
       memory.kvSet('dbg.diff_types', JSON.stringify({ types: typeCount, msgLike }).slice(0, 900));