dsh-reference-session-collector 0.2.1 → 0.2.3

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-reference-session-collector",
   "name": "dsh-reference-session-collector",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": {
     "en": "Session reference projector (DRS): read-only scan of ~/.dsh/sessions logs, decoded into a private SQLite (segments/replaces/FTS5) with surface flags, recall-pair accounting and a Chinese-capable search face, served via /api/dsh-reference-session-collector. Never writes session files.",
     "zh": "会话原文投影同步器（DRS）：只读扫描 ~/.dsh/sessions 会话日志，解码后投影进自有 SQLite（segments/replaces/FTS5），经 /api/dsh-reference-session-collector 提供 surface 标记、召回对账与中文可用的内容检索面。绝不写会话文件。"
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
   },
   "components": {
     "host": "lib/index.js",

package/lib/index.d.ts

@@ -690,12 +690,14 @@ interface DrsHandlerDeps {
   trustedHosts?: readonly string[];
 }
 /**
- * op 分发：GET `?op=…`；POST `{op:'sync'}` 触发后台同步。
+ * op 分发：GET `?op=…`；POST `?op=sync` 触发后台同步。
+ * POST 的 op 只从 **query** 读（`{op:'sync'}` 落进 body 会 400 unknown POST op）。
  * 未知 op / 缺参 → 400（不留空壳）。
  */
 declare function handleDrsRequest(deps: DrsHandlerDeps, req: IncomingMessage, res: ServerResponse): Promise<void>;
 /**
- * 插件主体：开库 → 装配 sync（启动延迟首轮 + interval 轮）→ 双通道注册路由。
+ * 插件主体：apply() 立即返回，重活（开库/建 sync/注册路由）推迟到 setImmediate。
+ * 宿主插件装载串行同步——apply 不返回则整列插件都装不上，前端一直 Loading plugins…。
  * @param ctx - host 插件上下文（webServer 声明注入；webStartup/webRuntime 回退臂）。
  */
 declare function apply(ctx: Context): void;

package/lib/index.js

@@ -2234,7 +2234,8 @@ function parseTail(url) {
 	return Math.floor(parsed);
 }
 /**
-* op 分发：GET `?op=…`；POST `{op:'sync'}` 触发后台同步。
+* op 分发：GET `?op=…`；POST `?op=sync` 触发后台同步。
+* POST 的 op 只从 **query** 读（`{op:'sync'}` 落进 body 会 400 unknown POST op）。
 * 未知 op / 缺参 → 400（不留空壳）。
 */
 async function handleDrsRequest(deps, req, res) {
@@ -2245,6 +2246,13 @@ async function handleDrsRequest(deps, req, res) {
 		});
 		return;
 	}
+	if (deps.query === void 0) {
+		writeJson(res, 503, {
+			ok: false,
+			error: "initializing"
+		});
+		return;
+	}
 	let url;
 	try {
 		url = new URL(req.url ?? "/api/dsh-reference-session-collector", "http://localhost");
@@ -2277,7 +2285,8 @@ async function handleDrsRequest(deps, req, res) {
 		case "status":
 			writeJson(res, 200, {
 				ok: true,
-				...status(deps.query, deps.sync.lastSyncResult ?? null)
+				...status(deps.query, deps.sync.lastSyncResult ?? null),
+				syncing: deps.sync.isSyncing
 			});
 			return;
 		case "sessions": {
@@ -2428,7 +2437,8 @@ function safeReadService(ctx, name) {
 	}
 }
 /**
-* 插件主体：开库 → 装配 sync（启动延迟首轮 + interval 轮）→ 双通道注册路由。
+* 插件主体：apply() 立即返回，重活（开库/建 sync/注册路由）推迟到 setImmediate。
+* 宿主插件装载串行同步——apply 不返回则整列插件都装不上，前端一直 Loading plugins…。
 * @param ctx - host 插件上下文（webServer 声明注入；webStartup/webRuntime 回退臂）。
 */
 function apply(ctx) {
@@ -2440,43 +2450,12 @@ function apply(ctx) {
 			else console[level]("[dsh-reference-session-collector]", message, ...args);
 		} catch {}
 	};
-	const storeDir = resolveIndexDir();
 	let store;
 	let query;
-	try {
-		store = openProjectionStore(storeDir);
-		query = createQueryContext(store);
-	} catch (error) {
-		log("warn", "projection store 不可用（node:sqlite 缺席/目录不可写）：插件停用—— %s", String(error?.message ?? error));
-		return;
-	}
-	const sync = new ProjectionSync({
-		store: createStorePort(store),
-		project: (events, options) => projectSessionEvents(events, {
-			dirId: options.dirId,
-			...options.header === void 0 ? {} : { header: options.header },
-			...options.exactCounter === void 0 ? {} : { exactCounter: (text) => {
-				const count = options.exactCounter?.(text);
-				return count !== void 0 && count.kind === "exact-tokenizer" ? count.tokens : Math.ceil(text.length / 4);
-			} }
-		}),
-		log: (level, message, ...args) => log(level, message, ...args)
-	});
+	let sync;
 	let bootTimer;
 	let disposeInterval = () => {};
-	ctx.effect(() => {
-		bootTimer = setTimeout(() => {
-			sync.syncAll().then((result) => {
-				log("info", "boot sync done: updated=%d skipped=%d basis=%s %dms", result.updated, result.skipped, result.basis, result.durationMs);
-			}).catch((error) => log("warn", "boot sync failed: %s", String(error?.message ?? error)));
-		}, BOOT_SYNC_DELAY_MS);
-		disposeInterval = startIntervalSync(sync);
-		return () => {
-			if (bootTimer !== void 0) clearTimeout(bootTimer);
-			disposeInterval();
-			store.close();
-		};
-	}, "dsh-reference-session-collector: projection lifecycle");
+	let registered = false;
 	const readStartupFace = () => {
 		const direct = safeReadService(ctx, "webStartup") ?? safeReadService(ctx, "webRuntime");
 		return direct !== null && typeof direct === "object" ? direct : void 0;
@@ -2489,7 +2468,6 @@ function apply(ctx) {
 			...startup?.trustedHosts !== void 0 ? { trustedHosts: startup.trustedHosts } : {}
 		};
 	};
-	let registered = false;
 	const register = (webServer, channel) => {
 		if (registered) return;
 		try {
@@ -2510,24 +2488,58 @@ function apply(ctx) {
 			log("warn", "drs api route registration failed (%s): %s", channel, String(error?.message ?? error));
 		}
 	};
-	const readService = (name) => safeReadService(ctx, name);
-	const active = asWebServer(readService("webServer"));
-	if (active !== void 0) {
-		register(active, "direct");
-		if (registered) return;
-	}
-	try {
-		ctx.inject(["webServer"], (injected) => {
-			const webServer = asWebServer(injected.webServer);
-			if (webServer === void 0) {
-				log("warn", "webServer exposes no register() — drs api route not registered (projection sync keeps running)");
-				return;
+	ctx.effect(() => {
+		return () => {
+			if (bootTimer !== void 0) clearTimeout(bootTimer);
+			disposeInterval();
+			store?.close();
+		};
+	}, "dsh-reference-session-collector: projection lifecycle");
+	setImmediate(() => {
+		try {
+			store = openProjectionStore(resolveIndexDir());
+			query = createQueryContext(store);
+			sync = new ProjectionSync({
+				store: createStorePort(store),
+				project: (events, options) => projectSessionEvents(events, {
+					dirId: options.dirId,
+					...options.header === void 0 ? {} : { header: options.header },
+					...options.exactCounter === void 0 ? {} : { exactCounter: (text) => {
+						const count = options.exactCounter?.(text);
+						return count !== void 0 && count.kind === "exact-tokenizer" ? count.tokens : Math.ceil(text.length / 4);
+					} }
+				}),
+				log: (level, message, ...args) => log(level, message, ...args)
+			});
+			bootTimer = setTimeout(() => {
+				sync.syncAll().then((result) => {
+					log("info", "boot sync done: updated=%d skipped=%d basis=%s %dms", result.updated, result.skipped, result.basis, result.durationMs);
+				}).catch((error) => log("warn", "boot sync failed: %s", String(error?.message ?? error)));
+			}, BOOT_SYNC_DELAY_MS);
+			disposeInterval = startIntervalSync(sync);
+			const readService = (name) => safeReadService(ctx, name);
+			const active = asWebServer(readService("webServer"));
+			if (active !== void 0) {
+				register(active, "direct");
+				if (registered) return;
 			}
-			register(webServer, "inject");
-		});
-	} catch (error) {
-		log("warn", "webServer inject arm unavailable: %s — HTTP 面缺席，同步本体照常", String(error?.message ?? error));
-	}
+			try {
+				ctx.inject(["webServer"], (injected) => {
+					const webServer = asWebServer(injected.webServer);
+					if (webServer === void 0) {
+						log("warn", "webServer exposes no register() — drs api route not registered (projection sync keeps running)");
+						return;
+					}
+					register(webServer, "inject");
+				});
+			} catch (error) {
+				log("warn", "webServer inject arm unavailable: %s — HTTP 面缺席，同步本体照常", String(error?.message ?? error));
+			}
+			log("info", "deferred init done (store opened, sync started, routes registered)");
+		} catch (error) {
+			log("warn", "deferred init failed — projection store 不可用（node:sqlite 缺席/目录不可写）：插件停用—— %s", String(error?.message ?? error));
+		}
+	});
 }
 //#endregion
 export { BOOT_SYNC_DELAY_MS, DEFAULT_SYNC_INTERVAL_MS, DISCOVERY_LIMIT, DRS_API_PATH, INJECTED_BLOCK_TAGS, LEDGER_LRU_CAP, LedgerCache, PROJECTION_SCHEMA_VERSION, ProjectionSync, SYNC_INTERVAL_ENV, apply, buildSearchSnippet, classifySessionHeader, createQueryContext, createStorePort, decodeSessionLogBytes, decodeSessionLogFile, discoverSessionLogs, extractSearchEventText, extractTitleFromEvents, generationLogFilename, handleDrsRequest, inject, listSessions, openProjectionStore, projectSessionEvents, readArchivedSessionIds, readSessionGenerations, recallReport, reloadSummaries, resolveDshHome, resolveExactCounter, resolveIndexDir, resolveSyncIntervalMs, sanitizeFtsQuery, search, searchGrouped, segmentForIndex, segmentQueryTerm, sessionDetail, startIntervalSync, status, stripInjectedBlocks, surfaceLedger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reference-session-collector",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "tag": "beta",
@@ -72,7 +72,7 @@
   ],
   "engines": {
     "node": ">=22",
-    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4"
   },
   "license": "MIT",
   "dependencies": {

package/src/index.ts

@@ -195,7 +195,8 @@ function parseTail(url: URL): number | undefined {
 }
 
 /**
- * op 分发：GET `?op=…`；POST `{op:'sync'}` 触发后台同步。
+ * op 分发：GET `?op=…`；POST `?op=sync` 触发后台同步。
+ * POST 的 op 只从 **query** 读（`{op:'sync'}` 落进 body 会 400 unknown POST op）。
  * 未知 op / 缺参 → 400（不留空壳）。
  */
 export async function handleDrsRequest(deps: DrsHandlerDeps, req: IncomingMessage, res: ServerResponse): Promise<void> {
@@ -203,6 +204,11 @@ export async function handleDrsRequest(deps: DrsHandlerDeps, req: IncomingMessag
     writeJson(res, 403, { ok: false, error: 'forbidden' })
     return
   }
+  // 延迟初始化未完成——投影面不可用（503）。
+  if (deps.query === undefined) {
+    writeJson(res, 503, { ok: false, error: 'initializing' })
+    return
+  }
   let url: URL
   try {
     url = new URL(req.url ?? DRS_API_PATH, 'http://localhost')
@@ -227,7 +233,9 @@ export async function handleDrsRequest(deps: DrsHandlerDeps, req: IncomingMessag
 
   switch (op) {
     case 'status': {
-      writeJson(res, 200, { ok: true, ...status(deps.query, deps.sync.lastSyncResult ?? null) })
+      // syncing：真实在跑旗标（单次触发即回、后台跑完才落 last_sync），
+      // 消费方（dsh-search-index 深度同步）靠它判断慢扫何时落定。
+      writeJson(res, 200, { ok: true, ...status(deps.query, deps.sync.lastSyncResult ?? null), syncing: deps.sync.isSyncing })
       return
     }
     case 'sessions': {
@@ -345,7 +353,8 @@ function safeReadService(ctx: Context, name: string): unknown {
 }
 
 /**
- * 插件主体：开库 → 装配 sync（启动延迟首轮 + interval 轮）→ 双通道注册路由。
+ * 插件主体：apply() 立即返回，重活（开库/建 sync/注册路由）推迟到 setImmediate。
+ * 宿主插件装载串行同步——apply 不返回则整列插件都装不上，前端一直 Loading plugins…。
  * @param ctx - host 插件上下文（webServer 声明注入；webStartup/webRuntime 回退臂）。
  */
 export function apply(ctx: Context): void {
@@ -358,53 +367,13 @@ export function apply(ctx: Context): void {
     } catch { /* 日志面永不致命 */ }
   }
 
-  const storeDir = resolveIndexDir()
-  let store: ProjectionStore
-  let query: QueryContext
-  try {
-    store = openProjectionStore(storeDir)
-    query = createQueryContext(store)
-  } catch (error) {
-    log('warn', 'projection store 不可用（node:sqlite 缺席/目录不可写）：插件停用—— %s',
-      String((error as Error)?.message ?? error))
-    return
-  }
-
-  const sync = new ProjectionSync({
-    store: createStorePort(store),
-    project: (events, options) => projectSessionEvents(events, {
-      dirId: options.dirId,
-      ...(options.header === undefined ? {} : { header: options.header }),
-      // 端口计数器返 TokenCount；投影只需数值臂（CCI verify 同款降级）。
-      ...(options.exactCounter === undefined ? {} : {
-        exactCounter: (text: string): number => {
-          const count = options.exactCounter?.(text)
-          return count !== undefined && count.kind === 'exact-tokenizer'
-            ? count.tokens
-            : Math.ceil(text.length / 4)
-        },
-      }),
-    }),
-    log: (level, message, ...args) => log(level, message, ...args),
-  })
-
-  // 生命周期：dispose 清定时器 + 关库。
+  // 延迟初始化状态（setImmediate 臂赋值；请求面兜底 503）。
+  let store: ProjectionStore | undefined
+  let query: QueryContext | undefined
+  let sync: ProjectionSync | undefined
   let bootTimer: ReturnType<typeof setTimeout> | undefined
   let disposeInterval: () => void = () => {}
-  ctx.effect(() => {
-    bootTimer = setTimeout(() => {
-      void sync.syncAll().then(result => {
-        log('info', 'boot sync done: updated=%d skipped=%d basis=%s %dms',
-          result.updated, result.skipped, result.basis, result.durationMs)
-      }).catch((error: unknown) => log('warn', 'boot sync failed: %s', String((error as Error)?.message ?? error)))
-    }, BOOT_SYNC_DELAY_MS)
-    disposeInterval = startIntervalSync(sync)
-    return () => {
-      if (bootTimer !== undefined) clearTimeout(bootTimer)
-      disposeInterval()
-      store.close()
-    }
-  }, 'dsh-reference-session-collector: projection lifecycle')
+  let registered = false
 
   // trustedHosts best-effort（双名回退链，属性/get 两层 safe；缺席=放行）。
   const readStartupFace = (): WebStartupLike | undefined => {
@@ -415,13 +384,12 @@ export function apply(ctx: Context): void {
   const depsFor = (): DrsHandlerDeps => {
     const startup = readStartupFace()
     return {
-      query,
-      sync,
+      query: query!,
+      sync: sync!,
       ...(startup?.trustedHosts !== undefined ? { trustedHosts: startup.trustedHosts } : {}),
     }
   }
 
-  let registered = false
   const register = (webServer: WebServerLike, channel: 'direct' | 'inject'): void => {
     if (registered) return
     try {
@@ -445,24 +413,72 @@ export function apply(ctx: Context): void {
     }
   }
 
-  const readService = (name: string): unknown => safeReadService(ctx, name)
+  // 生命周期：dispose 清定时器 + 关库（同步登记，cleanup 在 dispose 时执行）。
+  ctx.effect(() => {
+    return () => {
+      if (bootTimer !== undefined) clearTimeout(bootTimer)
+      disposeInterval()
+      store?.close()
+    }
+  }, 'dsh-reference-session-collector: projection lifecycle')
 
-  const active = asWebServer(readService('webServer'))
-  if (active !== undefined) {
-    register(active, 'direct')
-    if (registered) return
-  }
+  // 延迟初始化：开库/建 sync/注册路由全部推迟，保证 apply 立即返回。
+  setImmediate(() => {
+    try {
+      const storeDir = resolveIndexDir()
+      store = openProjectionStore(storeDir)
+      query = createQueryContext(store)
 
-  try {
-    ctx.inject(['webServer'], (injected) => {
-      const webServer = asWebServer((injected as { webServer?: unknown }).webServer)
-      if (webServer === undefined) {
-        log('warn', 'webServer exposes no register() — drs api route not registered (projection sync keeps running)')
-        return
+      sync = new ProjectionSync({
+        store: createStorePort(store),
+        project: (events, options) => projectSessionEvents(events, {
+          dirId: options.dirId,
+          ...(options.header === undefined ? {} : { header: options.header }),
+          ...(options.exactCounter === undefined ? {} : {
+            exactCounter: (text: string): number => {
+              const count = options.exactCounter?.(text)
+              return count !== undefined && count.kind === 'exact-tokenizer'
+                ? count.tokens
+                : Math.ceil(text.length / 4)
+            },
+          }),
+        }),
+        log: (level, message, ...args) => log(level, message, ...args),
+      })
+
+      // 启动延迟首轮 sync + interval 轮。
+      bootTimer = setTimeout(() => {
+        void sync!.syncAll().then(result => {
+          log('info', 'boot sync done: updated=%d skipped=%d basis=%s %dms',
+            result.updated, result.skipped, result.basis, result.durationMs)
+        }).catch((error: unknown) => log('warn', 'boot sync failed: %s', String((error as Error)?.message ?? error)))
+      }, BOOT_SYNC_DELAY_MS)
+      disposeInterval = startIntervalSync(sync)
+
+      // 双通道注册路由。
+      const readService = (name: string): unknown => safeReadService(ctx, name)
+      const active = asWebServer(readService('webServer'))
+      if (active !== undefined) {
+        register(active, 'direct')
+        if (registered) return
       }
-      register(webServer, 'inject')
-    })
-  } catch (error) {
-    log('warn', 'webServer inject arm unavailable: %s — HTTP 面缺席，同步本体照常', String((error as Error)?.message ?? error))
-  }
+      try {
+        ctx.inject(['webServer'], (injected) => {
+          const webServer = asWebServer((injected as { webServer?: unknown }).webServer)
+          if (webServer === undefined) {
+            log('warn', 'webServer exposes no register() — drs api route not registered (projection sync keeps running)')
+            return
+          }
+          register(webServer, 'inject')
+        })
+      } catch (error) {
+        log('warn', 'webServer inject arm unavailable: %s — HTTP 面缺席，同步本体照常', String((error as Error)?.message ?? error))
+      }
+
+      log('info', 'deferred init done (store opened, sync started, routes registered)')
+    } catch (error) {
+      log('warn', 'deferred init failed — projection store 不可用（node:sqlite 缺席/目录不可写）：插件停用—— %s',
+        String((error as Error)?.message ?? error))
+    }
+  })
 }