dsh-reference-session-collector 0.2.0 → 0.2.2

package/README.de.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — Sitzungs-Projektionssynchronisierer
+# dsh-reference-session-collector (DRSC) — Sitzungs-Projektionssynchronisierer
 
 **DeepSeek-Harness(DSH)-Plugin**: Liest die Sitzungsprotokolle unter
 `~/.dsh/sessions/**` **nur lesend**, dekodiert sie und projiziert sie in eine
@@ -50,7 +50,7 @@ Memory-Anker-Rückfüllung) und Effizienz-Benchmark T9.1.
   `~/.dsh-reference-session-collector/projection.db`;
 - pro Sitzung vollständiger Neu-Schreib-Ersatz (DELETE+INSERT in einer
   Transaktion), idempotent;
-- **Maskierung liegt nicht bei DRS**: Rohtext-Speicherung,
+- **Maskierung liegt nicht bei DRSC**: Rohtext-Speicherung,
   Expositionsfläche = die Sitzungsdateien selbst.
 
 ## Umgebungsvariablen

package/README.en.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS)
+# dsh-reference-session-collector (DRSC)
 
 **Session reference projection synchronizer** — a DeepSeek Harness (DSH) plugin.
 
@@ -9,8 +9,8 @@ replacement markers, recall pointers, and an FTS5 full-text index — so context
 compression (cci), the session steward, and prime-memory all read the same
 projection instead of each decoding logs on their own.
 
-> Naming: `dsh-reference-session-collector` abbreviates to **DRS**, which is also the
-> first three letters of drscrewdriver.
+> Naming: `dsh-reference-session-collector` abbreviates to **DRSC** — the initials of
+> dsh-**R**eference-**S**ession-**C**ollector.
 
 ## Status
 
@@ -69,7 +69,7 @@ missing (fail-soft).
 and it has no write counterpart — ever. The plugin writes only to
 `~/.dsh-reference-session-collector/projection.db`. That database holds **unsanitized
 original text**; its exposure equals the session files themselves. Any
-"sanitized corpus" requirement belongs to consumers, not DRS.
+"sanitized corpus" requirement belongs to consumers, not DRSC.
 
 ## Configuration (v0)
 
@@ -83,16 +83,16 @@ No settings face yet (lands with phase-2 wiring). Environment variables:
 
 ## Roadmap
 
-1. **Phase 1 · cci reconciliation**: monitor/verify gains a DRS recall column —
+1. **Phase 1 · cci reconciliation**: monitor/verify gains a DRSC recall column —
    claims vs formula vs projection, three-column accounting (read-only HTTP).
 2. **Phase 2 · steward corpus switch**: the steward's inlined search engine
-   reads DRS (segments.time/on_surface/search_text + last_time_ms/archived
+   reads DRSC (segments.time/on_surface/search_text + last_time_ms/archived
    cover its whole hit face; field mapping in
    `.agents/plans/drs-start/findings.md`).
 3. **Phase 3 · memory history projection (read-only)**: the l0 write path does
    **not** move (sanitization/redaction/record_id ownership stays in memory's
    capture side; it is semantically incompatible with full-session rewrite).
-   DRS only serves historical anchor backfill and corpus. Vector layer
+   DRSC only serves historical anchor backfill and corpus. Vector layer
    (BGE-M3 int8) is a separate optional batch job.
 
 ## Development

package/README.es.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — sincronizador de proyección de sesiones
+# dsh-reference-session-collector (DRSC) — sincronizador de proyección de sesiones
 
 **Complemento de DeepSeek Harness (DSH)**: escanea **solo en lectura** los
 registros de sesión en `~/.dsh/sessions/**`, los decodifica y los proyecta
@@ -49,7 +49,7 @@ fase 3 relleno de anclas de memory) y banco de pruebas de eficiencia T9.1.
   `~/.dsh-reference-session-collector/projection.db`;
 - reemplazo de reescritura completa por sesión (DELETE+INSERT en una
   transacción), idempotente;
-- **la desensibilización no es responsabilidad de DRS**: almacena texto
+- **la desensibilización no es responsabilidad de DRSC**: almacena texto
   original; la superficie de exposición son los propios archivos de sesión.
 
 ## Variables de entorno

package/README.fr.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — Synchroniseur de projection de sessions
+# dsh-reference-session-collector (DRSC) — Synchroniseur de projection de sessions
 
 **Plugin DeepSeek Harness (DSH)** : balaie les journaux de session sous
 `~/.dsh/sessions/**` en **lecture seule**, les décode et les projette dans
@@ -49,7 +49,7 @@ d'efficacité T9.1.
   `~/.dsh-reference-session-collector/projection.db` ;
 - remplacement réécriture-complète par session (DELETE+INSERT dans une
   transaction), idempotent ;
-- **l'anonymisation n'est pas la responsabilité de DRS** : texte brut
+- **l'anonymisation n'est pas la responsabilité de DRSC** : texte brut
   stocké, surface d'exposition = les fichiers de session eux-mêmes.
 
 ## Variables d'environnement

package/README.it.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — sincronizzatore di proiezione delle sessioni
+# dsh-reference-session-collector (DRSC) — sincronizzatore di proiezione delle sessioni
 
 **Plugin DeepSeek Harness (DSH)**: scansisce **in sola lettura** i log di
 sessione in `~/.dsh/sessions/**`, li decodifica e li proietta in una
@@ -49,7 +49,7 @@ steward, fase 3 riempimento ancore memory) e benchmark di efficienza T9.1.
   `~/.dsh-reference-session-collector/projection.db`;
 - sostituzione con riscrittura completa per sessione (DELETE+INSERT in una
   transazione), idempotente;
-- **la sanitizzazione non è responsabilità di DRS**: memorizza testo grezzo,
+- **la sanitizzazione non è responsabilità di DRSC**: memorizza testo grezzo,
   superficie di esposizione = i file di sessione stessi.
 
 ## Variabili d'ambiente

package/README.ja.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — セッション原文プロジェクション同期器
+# dsh-reference-session-collector (DRSC) — セッション原文プロジェクション同期器
 
 **DeepSeek Harness (DSH) プラグイン**: `~/.dsh/sessions/**` のセッション
 ログを**読み取り専用**で走査し、復号後に独自 SQLite プロジェクション
@@ -44,7 +44,7 @@ HTTP ルート。ゲートチェーン `pnpm check` 全緑（9スイート / 66
 - セッションファイルと `workspace.json` は常時読み取り専用;
 - 本プラグインの全書き込みは `~/.dsh-reference-session-collector/projection.db` にのみ;
 - セッション単位の全量書換式置換（トランザクション内 DELETE+INSERT）、冪等;
-- **マスキング責任は DRS にない**: 原文を保存、露出面=セッションファイル自体。
+- **マスキング責任は DRSC にない**: 原文を保存、露出面=セッションファイル自体。
 
 ## 環境変数
 

package/README.ko.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — 세션 원문 투영 동기화기
+# dsh-reference-session-collector (DRSC) — 세션 원문 투영 동기화기
 
 **DeepSeek Harness(DSH) 플러그인**: `~/.dsh/sessions/**` 세션 로그를
 **읽기 전용**으로 스캔하여 디코딩 후 자체 SQLite 투영
@@ -44,7 +44,7 @@
 - 세션 파일과 `workspace.json`은 상시 읽기 전용;
 - 모든 기록은 `~/.dsh-reference-session-collector/projection.db`에만;
 - 세션 단위 전체 재작성 치환(트랜잭션 내 DELETE+INSERT), 멱등;
-- **마스킹 책임은 DRS에 없음**: 원문 저장, 노출면=세션 파일 자체.
+- **마스킹 책임은 DRSC에 없음**: 원문 저장, 노출면=세션 파일 자체.
 
 ## 환경 변수
 

package/README.md

@@ -1,12 +1,12 @@
-# dsh-reference-session-collector (DRS) — 会话原文投影同步器
+# dsh-reference-session-collector (DRSC) — 会话原文投影同步器
 
 > 只读扫描 `~/.dsh/sessions/**` 会话日志，解码后投影进插件自有 SQLite
 > （segments / replaces / FTS5），经单条 fenced HTTP 路由对外提供
 > surface 标记、召回对账与中文可用的内容检索面。**绝不写会话文件。**
 
-# Session Reference Projector (DRS) — English summary
+# Session Reference Projector (DRSC) — English summary
 
-DRS is a read-only projector over the host's session logs. It walks
+DRSC is a read-only projector over the host's session logs. It walks
 `~/.dsh/sessions/**`, decodes zstd/teiled-frame logs with a vendored leaf
 decoder, and rewrites per-session projections into
 `~/.dsh-reference-session-collector/projection.db` (SQLite via `node:sqlite`, four
@@ -15,12 +15,12 @@ tables + one FTS5 virtual table). A single fenced HTTP route
 per-session segment windows, the surface ledger, recall/compress pair
 accounting and full-text search. Token counts share the exact same
 DeepSeek-V4 tokenizer and formula as CCI's `verify`, falling back to a
-labelled `chars/4` basis when assets are absent. DRS never writes to any
+labelled `chars/4` basis when assets are absent. DRSC never writes to any
 session file; its only writes land in its own data directory.
 
 ## 定位 / Positioning
 
-| 消费方 | 用 DRS 做什么 | 分期 |
+| 消费方 | 用 DRSC 做什么 | 分期 |
 |---|---|---|
 | CCI（context-compression） | surface 标记（compressed/surface_text/replaced_by）、召回对账（Σb 回吐、Σ(a−b) 毛节省）、verify 免全量解码 | 一期 |
 | steward（会话管家） | 内容搜索语料源切换（search_text/time/on_surface 检索面） | 二期 |
@@ -68,7 +68,7 @@ session file; its only writes land in its own data directory.
 - 会话文件（`~/.dsh/sessions/**`）与 `workspace.json` 一律只读；
 - 插件的全部写入落在 `~/.dsh-reference-session-collector/projection.db`；
 - 每 session 全量重写式替换（事务内 DELETE+INSERT），幂等可重放；
-- **脱敏责任不在 DRS**：projection.db 存原文，泄露面=会话文件本身。
+- **脱敏责任不在 DRSC**：projection.db 存原文，泄露面=会话文件本身。
 
 ## 分期路线
 

package/README.ru.md

@@ -1,4 +1,4 @@
-# dsh-reference-session-collector (DRS) — синхронизатор проекции сессий
+# dsh-reference-session-collector (DRSC) — синхронизатор проекции сессий
 
 **Плагин DeepSeek Harness (DSH)**: сканирует **только на чтение** журналы
 сессий в `~/.dsh/sessions/**`, декодирует их и проецирует в собственную
@@ -48,7 +48,7 @@ SQLite-проекцию (segments / replaces / FTS5). Одна защищённ
 - все записи плагина идут исключительно в
   `~/.dsh-reference-session-collector/projection.db`;
 - полная перезапись-замена на сессию (DELETE+INSERT в транзакции), идемпотентно;
-- **ответственность за обезличивание не на DRS**: хранится исходный текст,
+- **ответственность за обезличивание не на DRSC**: хранится исходный текст,
   площадь утечки = сами файлы сессий.
 
 ## Переменные окружения

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-reference-session-collector",
   "name": "dsh-reference-session-collector",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.2",
   "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"
+    "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"
   },
   "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.0",
+  "version": "0.2.2",
   "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"
+    "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"
   },
   "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))
+    }
+  })
 }