dsh-manage-session 0.5.4 → 0.5.7

package/src/config.ts

@@ -21,6 +21,12 @@ export interface StewardConfig {
   healthCheck?: boolean
   /** 搜索索引子域（`index-*` 路由与侧栏搜索入口）。关闭后索引子域整体停摆。 */
   search?: boolean
+  /**
+   * 直接删除入口（2026-10-20 用户定标）：开启后搜索面板结果行出现行内
+   * 「删除」按钮（两步确认,走管理端同款 session-history-purge 链路）。
+   * **缺省关**——破坏性入口不默认铺开;管理端批量删除不受本开关限制。
+   */
+  directDelete?: boolean
 }
 
 /** 缺省值。 */
@@ -29,6 +35,7 @@ export const DEFAULT_CONFIG: Required<StewardConfig> = {
   historyFiles: true,
   healthCheck: true,
   search: true,
+  directDelete: false,
 }
 
 /** host 半身注册的设置命名空间（与 src/index.ts 保持一致）。 */
@@ -69,6 +76,14 @@ export interface SwitchSearchConfig {
   archiveKeep?: number
   /** 独立索引文件的可选绝对目录。 */
   indexDir?: string
+  /**
+   * 语料源(T7.1):`'native'`=sessionQuery 服务 + 转录文件兜底(缺省);
+   * `'drs'`=dsh-reference-session-collector 投影库(docs 直插;DRS 不可达时整轮
+   * 回退 native 链路,水位语义切换的首轮会全量重灌一次)。
+   */
+  corpusSource?: 'native' | 'drs'
+  /** DRS 投影库 API 基址;空=自动(首个 trustedHosts 条目,再退 http://127.0.0.1:8080)。 */
+  drsBaseUrl?: string
 }
 
 /** 搜索子域缺省值。 */
@@ -79,4 +94,6 @@ export const SWITCH_DEFAULT_CONFIG: Required<SwitchSearchConfig> = {
   syncIntervalMs: 30_000,
   archiveKeep: 2,
   indexDir: '',
+  corpusSource: 'native',
+  drsBaseUrl: '',
 }

package/src/host/history/tombstones.ts

@@ -0,0 +1,100 @@
+/**
+ * 退场墓碑台账（2026-10-20 用户定标）：任何 purge 成功路径都往
+ * `~/.dsh-switch-search/retired-tombstones.jsonl` 追加一行
+ * `{sessionId, retiredAt, source}`，作为离线清残脚本
+ * （scripts/cleanup-retired.mjs）的驱动清单。
+ *
+ * 为什么需要：宿主 `registry.deleteSession` 与 `purgeHistory` 各自覆盖 4 处
+ * 实体（转录目录/projcache/workspace.json 两处 id），但任一路径中途失败、
+ * 索引联动（onPurged）进程崩溃、或 collector 同步轮未跑，都会留下残行/残
+ * 目录。墓碑 = 「这个 id 已被判退场」的持久凭证，DSH 关闭后脚本据此兜底
+ * 清扫，不靠现场推断。
+ *
+ * 纪律：
+ * - **append-only、best-effort**：写台账失败绝不影响删除结果返回（try/catch
+ *   吞错并 log），台账是副账不是主账；
+ * - 每行一个 JSON（JSONL），读侧跳过畸形行——半行（进程崩在 append 中间）
+ *   不致命；
+ * - 幂等消费：脚本按 id 集合去重，重复墓碑无害；台账只增不删（体积可忽略，
+ *   每行 ~120B）。
+ */
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+/** 台账文件名（固定；脚本以默认路径发现）。 */
+export const TOMBSTONE_FILE = 'retired-tombstones.jsonl'
+
+/** 一条退场墓碑。 */
+export interface RetiredTombstone {
+  sessionId: string
+  /** ISO 时间串（写入时刻）。 */
+  retiredAt: string
+  /** 落账来源：内存全痕删除 / 文件兜底删除 / 测试注入。 */
+  source: string
+}
+
+/** 默认台账目录 = 索引缺省落点（与 rebuild.ts 的 ~/.dsh-switch-search 同根）。 */
+export function defaultTombstoneDir(): string {
+  return join(homedir(), '.dsh-switch-search')
+}
+
+/** 台账文件绝对路径。 */
+export function tombstonePathFor(dir: string): string {
+  return join(dir, TOMBSTONE_FILE)
+}
+
+/**
+ * 追加一批墓碑（一次 purge 成功的 id 集）。best-effort：目录不可建/盘不可写
+ * 只经 `log` 报一行，绝不抛——删除动作的成败判定先于本调用完成。
+ * @returns 实际写出的行数（0 = 静默失败或空入参）。
+ */
+export function appendRetiredTombstones(
+  sessionIds: readonly string[],
+  opts: { dir?: string; source: string; now?: () => Date; log?: (msg: string) => void },
+): number {
+  const ids = [...new Set(sessionIds.filter((id) => typeof id === 'string' && id !== ''))]
+  if (ids.length === 0) return 0
+  const dir = opts.dir ?? defaultTombstoneDir()
+  const now = opts.now ?? (() => new Date())
+  try {
+    mkdirSync(dir, { recursive: true })
+    const stamp = now().toISOString()
+    const lines = ids.map((id) => JSON.stringify({ sessionId: id, retiredAt: stamp, source: opts.source } satisfies RetiredTombstone) + '\n')
+    appendFileSync(join(dir, TOMBSTONE_FILE), lines.join(''), 'utf8')
+    return lines.length
+  } catch (err) {
+    opts.log?.(`tombstone append failed (deletion itself succeeded): ${String(err instanceof Error ? err.message : err)}`)
+    return 0
+  }
+}
+
+/**
+ * 读台账（脚本与单测共用）：畸形行/半行跳过，缺文件回空数组。
+ */
+export function readRetiredTombstones(file: string): RetiredTombstone[] {
+  let raw: string
+  try {
+    raw = readFileSync(file, 'utf8')
+  } catch {
+    return []
+  }
+  const out: RetiredTombstone[] = []
+  for (const line of raw.split(/\r?\n/)) {
+    const trimmed = line.trim()
+    if (trimmed === '') continue
+    try {
+      const record = JSON.parse(trimmed) as Record<string, unknown>
+      if (typeof record['sessionId'] === 'string' && record['sessionId'] !== '') {
+        out.push({
+          sessionId: record['sessionId'],
+          retiredAt: typeof record['retiredAt'] === 'string' ? record['retiredAt'] : '',
+          source: typeof record['source'] === 'string' ? record['source'] : '',
+        })
+      }
+    } catch {
+      /* 半行/脏行：跳过（append 撕裂的预期形态） */
+    }
+  }
+  return out
+}

package/src/host/index/drs-source.ts

@@ -0,0 +1,211 @@
+/**
+ * DRS 语料源:dsh-reference-session-collector 投影库的 HTTP 只读客户端(T7.1)。
+ *
+ * 语料契约 = DRS 单条 fenced 路由 `GET /api/dsh-reference-session-collector`:
+ * - `op=sessions&offset=&limit=` → `{ok, total, rows:[sessions 行]}`(分页);
+ * - `op=session&session=<id>&fields=search` → `{ok, session, rows:[检索臂]}`。
+ *
+ * 字段对照(T7.0,DRS wire snake → steward 引擎列):
+ *   sessions.version ← artifact_mtime_ms(水位代理:日志重写必 bump mtime);
+ *   sessions.updated_at ← last_time_ms;title/cwd/archived ← 同名列;
+ *   docs.type ← kind;docs.surface ← on_surface(1='current'/0='shadowed');
+ *   docs.time ← time;docs.text ← search_text;index_text 由本引擎
+ *   segmentForIndex 重算(自有切分面不动)。
+ *
+ * 自调用信任面:DRS 的 Host 门是精确匹配(trustedHosts 全小写比对),本客户
+ * 端可带 hostHeader 显式回显首个 trustedHosts 条目,规避「条目省略端口而
+ * URL 带端口」的精确匹配失配;loopback + 无 trustedHosts 的老宿主天然放行。
+ */
+/** DRS API 路径(与 dsh-reference-session-collector 的 DRS_API_PATH 字面一致;不跨包 import)。 */
+export const DRS_API_PATH = '/api/dsh-reference-session-collector'
+
+/** 语料列表分页大小(百会话级一轮 1-2 页;DRS 侧 offset/limit 透传)。 */
+export const DRS_CORPUS_PAGE = 500
+
+/** 一个 DRS 会话头(watermark 代理 + 检索排序字段)。 */
+export interface DrsCorpusHead {
+  sessionId: string
+  version: number
+  title: string
+  cwd: string
+  updatedAt: number
+  archived: boolean
+}
+
+/** 一个 DRS 检索臂文档(surface 已折算成引擎列的字符串域)。 */
+export interface DrsCorpusDoc {
+  seq: number
+  type: string
+  surface: 'current' | 'shadowed'
+  time: number
+  text: string
+}
+
+/** 一个 DRS 会话的完整语料(头 + docs)。 */
+export interface DrsCorpusSession {
+  head: DrsCorpusHead
+  docs: DrsCorpusDoc[]
+}
+
+export interface DrsCorpusSourceOptions {
+  /** DRS API 基址(http://host[:port];解析序见 resolveDrsBaseUrl)。 */
+  baseUrl: string
+  /** 注入面(单测);缺省全局 fetch。 */
+  fetchImpl?: typeof fetch
+  /** 显式 Host 头(trustedHosts 首条回显;缺省不覆盖)。 */
+  hostHeader?: string
+  log?: (message: string) => void
+}
+
+/**
+ * 基址解析:显式配置 > 首个 trustedHosts 条目(补 http:// 前缀)>
+ * `http://127.0.0.1:8080`(宿主默认口;trustedHosts 缺席的老线 DRS 门本就放行)。
+ */
+export function resolveDrsBaseUrl(explicit: string | undefined, trustedHosts?: readonly string[]): string {
+  const trimmed = explicit?.trim() ?? ''
+  const pick = trimmed !== '' ? trimmed : trustedHosts?.find(entry => entry.trim() !== '')?.trim()
+  if (pick === undefined || pick === '') return 'http://127.0.0.1:8080'
+  return /^https?:\/\//u.test(pick) ? pick : `http://${pick}`
+}
+
+export class DrsCorpusSource {
+  private readonly fetchImpl: typeof fetch
+
+  constructor(private readonly options: DrsCorpusSourceOptions) {
+    this.fetchImpl = options.fetchImpl ?? fetch
+  }
+
+  /** 一个 GET 的 JSON 包络(ok!==true 或非 2xx 一律抛,由调用方回退 native)。 */
+  private async getJson(query: string, atHost?: string): Promise<Record<string, unknown>> {
+    // atHost=同源转发臂（调用方请求的 Host 头）：宿主端口动态分配时
+    // 配置缺省口(8080)猜不中——同源直连以请求 Host 优先。
+    const source = atHost !== undefined && atHost !== '' ? `http://${atHost}` : this.options.baseUrl
+    const base = source.replace(/\/+$/u, '')
+    const url = `${base}${DRS_API_PATH}${query}`
+    let response: Response
+    try {
+      response = await this.fetchImpl(url, {
+        headers: {
+          accept: 'application/json',
+          ...(this.options.hostHeader === undefined ? {} : { host: this.options.hostHeader }),
+        },
+      })
+    } catch (err) {
+      throw new Error(`DRS ${query}: ${String(err instanceof Error ? err.message : err)}`)
+    }
+    if (!response.ok) throw new Error(`DRS ${query} → HTTP ${String(response.status)}`)
+    const body = await response.json() as unknown
+    if (typeof body !== 'object' || body === null) throw new Error(`DRS ${query}: 响应非 JSON 对象`)
+    const record = body as Record<string, unknown>
+    if (record['ok'] !== true) {
+      throw new Error(`DRS ${query}: ok=false(${String(record['error'] ?? 'unknown')})`)
+    }
+    return record
+  }
+
+  private static headOf(row: Record<string, unknown>, fallbackId: string): DrsCorpusHead {
+    return {
+      sessionId: String(row['session_id'] ?? fallbackId),
+      version: Number(row['artifact_mtime_ms'] ?? 0),
+      title: String(row['title'] ?? ''),
+      cwd: String(row['cwd'] ?? ''),
+      updatedAt: Number(row['last_time_ms'] ?? 0),
+      archived: Number(row['archived'] ?? 0) === 1,
+    }
+  }
+
+  /** 全量语料头(内部翻页;rows 空或凑满 total 即止)。 */
+  async listSessions(): Promise<DrsCorpusHead[]> {
+    const heads: DrsCorpusHead[] = []
+    let offset = 0
+    for (;;) {
+      const page = await this.getJson(`?op=sessions&offset=${String(offset)}&limit=${String(DRS_CORPUS_PAGE)}`)
+      const rows = Array.isArray(page['rows']) ? page['rows'] as Record<string, unknown>[] : []
+      for (const row of rows) {
+        const head = DrsCorpusSource.headOf(row, '')
+        if (head.sessionId !== '') heads.push(head)
+      }
+      offset += rows.length
+      const total = Number(page['total'] ?? heads.length)
+      if (rows.length === 0 || offset >= total) break
+    }
+    return heads
+  }
+
+  /** 一个会话的检索臂 docs；DRS 无此会话（session:null）返回 undefined。 */
+  async readSession(sessionId: string): Promise<DrsCorpusSession | undefined> {
+    const body = await this.getJson(`?op=session&session=${encodeURIComponent(sessionId)}&fields=search`)
+    if (body['session'] === null || body['session'] === undefined) return undefined
+    const head = DrsCorpusSource.headOf(body['session'] as Record<string, unknown>, sessionId)
+    const docs = (Array.isArray(body['rows']) ? body['rows'] as Record<string, unknown>[] : []).map(row => ({
+      seq: Number(row['seq'] ?? 0),
+      type: String(row['kind'] ?? ''),
+      surface: Number(row['on_surface'] ?? 1) === 1 ? 'current' as const : 'shadowed' as const,
+      time: Number(row['time'] ?? 0),
+      text: String(row['search_text'] ?? ''),
+    }))
+    return { head, docs }
+  }
+
+  /**
+   * 分组内容搜索直连臂（op=search&group=session，DRS surface.searchGrouped 同构）：
+   * 会话分组/加权/过滤/锚定节选全部在 DRS 侧完成，本方法只搬 wire →
+   * 引擎命中形状（SwitchSearchHit 字段同名）。失败（网络/非 2xx/包络）直抛，
+   * 调用侧按硬依赖语义显式报错——**不回退本地索引**。
+   */
+  async searchGrouped(request: {
+    query: string
+    /** 原事件 type 列表（调用方展开粗类）；空=DRS 缺省 user+assistant。 */
+    kinds?: readonly string[]
+    archived?: 'active' | 'archived' | 'all'
+    from?: number
+    to?: number
+    sortBy?: 'relevance' | 'time'
+    limit?: number
+    /** 命中展开（wire `expand=1`）：同会话多命中各自成行；缺省聚合。 */
+    expand?: boolean
+    /** 同源 Host 覆盖（转发调用方请求头；优先于装配 baseUrl）。 */
+    atHost?: string
+  }): Promise<{
+    sessionId: string
+    title: string
+    seq: number
+    type: string
+    time: number
+    updatedAt: number
+    snippet: string
+  }[]> {
+    const params = new URLSearchParams()
+    params.set('op', 'search')
+    params.set('group', 'session')
+    params.set('q', request.query)
+    if (request.kinds !== undefined && request.kinds.length > 0) params.set('kinds', request.kinds.join(','))
+    if (request.archived !== undefined) params.set('archived', request.archived)
+    if (request.from !== undefined) params.set('from', String(request.from))
+    if (request.to !== undefined) params.set('to', String(request.to))
+    if (request.sortBy === 'time') params.set('sort', 'time')
+    if (request.limit !== undefined) params.set('limit', String(request.limit))
+    if (request.expand === true) params.set('expand', '1')
+    const body = await this.getJson(`?${params.toString()}`, request.atHost)
+    const hits = Array.isArray(body['hits']) ? body['hits'] as Record<string, unknown>[] : []
+    return hits.map(row => ({
+      sessionId: String(row['session_id'] ?? ''),
+      title: String(row['title'] ?? ''),
+      seq: Number(row['seq'] ?? 0),
+      type: String(row['type'] ?? ''),
+      time: Number(row['time'] ?? 0),
+      updatedAt: Number(row['updated_at'] ?? 0),
+      snippet: String(row['snippet'] ?? ''),
+    }))
+  }
+
+  /** 可性探针（op=status）：硬依赖预检/降级提示用；失败返回 false。 */
+  async probe(atHost?: string): Promise<boolean> {
+    try {
+      await this.getJson('?op=status', atHost)
+      return true
+    } catch {
+      return false
+    }
+  }
+}