dsh-reference-session-collector 0.2.0-beta.0 → 0.2.1

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.1",
   "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

@@ -388,6 +388,12 @@ interface GroupedSearchRequest {
   limit?: number;
   /** R3：true=snippet 取材切 redacted_search_text（命中/排序不变，fts 仍原文）。 */
   redact?: boolean;
+  /**
+   * 命中展开（steward「分开显示」开关，wire `expand=1`）：true=每条候选行
+   * 各自成命中（同会话多行按全局分数序出现）；缺省 false=会话分组各取
+   * 最强命中（既有聚合臂行为零改动，limit 语义随之从会话数变行数）。
+   */
+  expand?: boolean;
 }
 /** 分组命中（wire 蛇形，会话级最强命中）。 */
 interface GroupedSearchHit {

package/lib/index.js

@@ -385,18 +385,20 @@ function searchGrouped(ctx, request) {
     WHERE segments_fts MATCH ?
       AND seg.kind IN (${placeholders}) ${surfaceClause} ${archivedClause} ${dateClause}
     ORDER BY rank LIMIT ?`;
-	const docs = ctx.store.db.prepare(sql).all(match, ...kinds, ...dateParams, SEARCH_SCAN_LIMIT);
-	const bestBySession = /* @__PURE__ */ new Map();
-	for (const doc of docs) {
-		const weight = SEARCH_TYPE_WEIGHT[doc.kind] ?? 1;
-		const score = -Number(doc.rank) * weight;
-		const best = bestBySession.get(doc.session_id);
-		if (best === void 0 || score > best.score) bestBySession.set(doc.session_id, {
-			doc,
-			score
-		});
+	const scored = ctx.store.db.prepare(sql).all(match, ...kinds, ...dateParams, SEARCH_SCAN_LIMIT).map((doc) => ({
+		doc,
+		score: -Number(doc.rank) * (SEARCH_TYPE_WEIGHT[doc.kind] ?? 1)
+	}));
+	let grouped;
+	if (request.expand === true) grouped = scored;
+	else {
+		const bestBySession = /* @__PURE__ */ new Map();
+		for (const entry of scored) {
+			const best = bestBySession.get(entry.doc.session_id);
+			if (best === void 0 || entry.score > best.score) bestBySession.set(entry.doc.session_id, entry);
+		}
+		grouped = [...bestBySession.values()];
 	}
-	const grouped = [...bestBySession.values()];
 	if (request.sortBy === "time") grouped.sort((a, b) => b.doc.updated_at - a.doc.updated_at || b.score - a.score);
 	else grouped.sort((a, b) => b.score - a.score);
 	const hits = grouped.slice(0, limit).map(({ doc }) => ({
@@ -2388,6 +2390,7 @@ async function handleDrsRequest(deps, req, res) {
 						...url.searchParams.get("surface") === "0" ? { surfaceOnly: false } : {},
 						...url.searchParams.get("sort") === "time" ? { sortBy: "time" } : {},
 						...limitRaw !== null && Number.isFinite(Number(limitRaw)) ? { limit: Number(limitRaw) } : {},
+						...url.searchParams.get("expand") === "1" ? { expand: true } : {},
 						...redact ? { redact: true } : {}
 					})
 				});

package/package.json

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

@@ -309,6 +309,7 @@ export async function handleDrsRequest(deps: DrsHandlerDeps, req: IncomingMessag
           ...(url.searchParams.get('surface') === '0' ? { surfaceOnly: false } : {}),
           ...(url.searchParams.get('sort') === 'time' ? { sortBy: 'time' as const } : {}),
           ...(limitRaw !== null && Number.isFinite(Number(limitRaw)) ? { limit: Number(limitRaw) } : {}),
+          ...(url.searchParams.get('expand') === '1' ? { expand: true } : {}),
           ...(redact ? { redact: true } : {}),
         })
         writeJson(res, 200, { ok: true, ...grouped })

package/src/surface.ts

@@ -379,6 +379,12 @@ export interface GroupedSearchRequest {
   limit?: number
   /** R3：true=snippet 取材切 redacted_search_text（命中/排序不变，fts 仍原文）。 */
   redact?: boolean
+  /**
+   * 命中展开（steward「分开显示」开关，wire `expand=1`）：true=每条候选行
+   * 各自成命中（同会话多行按全局分数序出现）；缺省 false=会话分组各取
+   * 最强命中（既有聚合臂行为零改动，limit 语义随之从会话数变行数）。
+   */
+  expand?: boolean
 }
 
 /** 分组命中（wire 蛇形，会话级最强命中）。 */
@@ -445,14 +451,19 @@ export function searchGrouped(ctx: QueryContext, request: GroupedSearchRequest):
       title: string
       updated_at: number
     }[]
-  const bestBySession = new Map<string, { doc: typeof docs[number]; score: number }>()
-  for (const doc of docs) {
-    const weight = SEARCH_TYPE_WEIGHT[doc.kind] ?? 1
-    const score = -Number(doc.rank) * weight
-    const best = bestBySession.get(doc.session_id)
-    if (best === undefined || score > best.score) bestBySession.set(doc.session_id, { doc, score })
+  const scored = docs.map(doc => ({ doc, score: -Number(doc.rank) * (SEARCH_TYPE_WEIGHT[doc.kind] ?? 1) }))
+  let grouped: typeof scored
+  if (request.expand === true) {
+    // 命中展开：不折叠，每条候选行都是命中（同会话多行各自显示）。
+    grouped = scored
+  } else {
+    const bestBySession = new Map<string, { doc: typeof docs[number]; score: number }>()
+    for (const entry of scored) {
+      const best = bestBySession.get(entry.doc.session_id)
+      if (best === undefined || entry.score > best.score) bestBySession.set(entry.doc.session_id, entry)
+    }
+    grouped = [...bestBySession.values()]
   }
-  const grouped = [...bestBySession.values()]
   if (request.sortBy === 'time') {
     grouped.sort((a, b) => (b.doc.updated_at - a.doc.updated_at) || (b.score - a.score))
   } else {