dsh-manage-session 0.5.7 → 2.0.4

package/src/client/search/platform.ts

@@ -1,136 +0,0 @@
-/**
- * Platform detection and the keyboard-label vocabulary, for the client half.
- *
- * Why this module exists
- * ----------------------
- * A shortcut hint is the one place where a single hard-coded string is wrong
- * for most users: `⌘K` is meaningless on Windows, `Ctrl K` is wrong on macOS.
- * The obvious implementation — one `navigator.platform` test — is also the
- * fragile one: that API is deprecated, and it returns an empty string in some
- * privacy configurations, which silently degrades every Mac user to the
- * Windows vocabulary without any error to notice.
- *
- * This module is the single owner of both the platform answer and every label
- * derived from it. The hint rendered in the sidebar, the hint rendered in the
- * panel footer, and the chord the keydown handler actually matches all read
- * from here — so a platform fix cannot land in one of them and miss another,
- * and the advertised key cannot drift away from the bound key.
- */
-
-/** The navigator fields the detection reads (all optional, all untrusted). */
-export interface NavigatorLike {
-  userAgentData?: { platform?: unknown }
-  platform?: unknown
-  userAgent?: unknown
-}
-
-/**
- * Resolve the running platform string, three tiers deep.
- *
- * 1. UA-CH (`navigator.userAgentData.platform`) — modern and precise.
- * 2. `navigator.platform` — broadly available, deprecated, and empty in some
- *    privacy modes.
- * 3. The UA string — last resort, still non-empty in practice.
- *
- * @param nav - the navigator to read; `undefined` is allowed (non-DOM host).
- * @returns a lower-cased platform string, or `''` when nothing could be read.
- */
-export function detectPlatform(nav: NavigatorLike | undefined): string {
-  const chPlatform = nav?.userAgentData?.platform
-  if (typeof chPlatform === 'string' && chPlatform !== '') return chPlatform.toLowerCase()
-  const legacy = nav?.platform
-  if (typeof legacy === 'string' && legacy !== '') return legacy.toLowerCase()
-  const agent = nav?.userAgent
-  if (typeof agent === 'string' && agent !== '') return agent.toLowerCase()
-  return ''
-}
-
-/** The keyboard vocabulary for one platform. */
-export interface PlatformLabels {
-  /** The lower-cased platform string these labels were derived from. */
-  platform: string
-  isMac: boolean
-  isWindows: boolean
-  /** Invoke-key modifier: `⌘` on macOS, `Ctrl` elsewhere. */
-  modLabel: string
-  /** Secondary modifier: `⌥` on macOS, `Alt` elsewhere. */
-  altLabel: string
-  /** Shift: `⇧` on macOS, `Shift` elsewhere. */
-  shiftLabel: string
-  /** Confirm: the arrow glyph is legible on every platform. */
-  enterLabel: string
-  /** Escape: `esc` is the macOS spelling, `Esc` the one everywhere else. */
-  escLabel: string
-  /**
-   * The whole invoke chord as one face, ready for a key chip: `⌘K` on macOS,
-   * `Ctrl K` on Windows and Linux. `Ctrl K` keeps the space because `CtrlK`
-   * reads as a word rather than as two keys.
-   */
-  invokeLabel: string
-}
-
-/**
- * Derive the label vocabulary from a platform string.
- *
- * An unrecognised platform — an empty string, or a UA that names neither
- * system — takes the non-Mac vocabulary on purpose: `Ctrl` is legible to
- * everyone, while `⌘` is opaque to anyone who has never used a Mac.
- *
- * @param platform - the string produced by {@link detectPlatform}.
- * @returns the label vocabulary for that platform.
- */
-export function platformLabels(platform: string): PlatformLabels {
-  const isMac = /mac|iphone|ipad|ipod/u.test(platform)
-  const isWindows = /win/u.test(platform)
-  const modLabel = isMac ? '⌘' : 'Ctrl'
-  return {
-    platform,
-    isMac,
-    isWindows,
-    modLabel,
-    altLabel: isMac ? '⌥' : 'Alt',
-    shiftLabel: isMac ? '⇧' : 'Shift',
-    enterLabel: '↵',
-    escLabel: isMac ? 'esc' : 'Esc',
-    invokeLabel: isMac ? `${modLabel}K` : `${modLabel} K`,
-  }
-}
-
-/** Read `globalThis.navigator` without assuming a DOM (or a DOM lib). */
-function currentNavigator(): NavigatorLike | undefined {
-  const candidate = (globalThis as { navigator?: unknown }).navigator
-  if (candidate === null || typeof candidate !== 'object') return undefined
-  return candidate as NavigatorLike
-}
-
-/** The labels for the platform this bundle is running on. */
-export const LABELS: PlatformLabels = platformLabels(detectPlatform(currentNavigator()))
-
-/** The minimal keydown face the chord test reads. */
-export interface KeyChordEvent {
-  key: string
-  ctrlKey: boolean
-  metaKey: boolean
-  altKey: boolean
-  shiftKey: boolean
-}
-
-/**
- * Whether a keydown event is the invoke chord advertised by
- * {@link PlatformLabels.invokeLabel}.
- *
- * The hint and the binding have to agree: a footer promising `⌘K` while the
- * handler matches `Ctrl+K` is worse than showing no hint at all. Both sides
- * call this, so neither can be changed alone. Requiring the other modifier to
- * be *absent* keeps the two chords distinct instead of letting either one
- * satisfy both platforms.
- *
- * @param event - the keydown payload.
- * @param isMac - the running platform's macOS-ness, from {@link LABELS}.
- * @returns `true` when the event is the invoke chord.
- */
-export function isInvokeChord(event: KeyChordEvent, isMac: boolean): boolean {
-  if (event.key !== 'k' && event.key !== 'K') return false
-  if (event.altKey || event.shiftKey) return false
-  return isMac ? event.metaKey && !event.ctrlKey : event.ctrlKey && !event.metaKey
-}

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

@@ -1,90 +0,0 @@
-/**
- * Official archive-set source resolution.
- *
- * Primary: the in-process `workspaceRegistry` service (the same fact the UI
- * filters by). Fallback: read the canonical storage hub file directly — the
- * workspace domain persists `archivedSessionIds` under the `global` segment
- * (storage-json: `~/.dsh/storages/workspace.json`; storage-sqlite variant
- * exists but the JSON fallback file is what stock web profiles ship).
- * Resolution order is decided per read; failures degrade to "no archive set"
- * and are reported through the diagnostics face.
- *
- * READ-ONLY by contract. The archive set is WRITTEN by dsh-manage-session
- * (会话管家 → 病案室); this package only consumes it to keep archived sessions
- * out of the index. Format contract: `dsh-归档文件格式契约-20260914.md`.
- */
-import { existsSync, readFileSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
-
-/** One resolved archive read: ids plus which source served them. */
-export interface SwitchArchiveRead {
-  ids: readonly string[]
-  source: 'registry' | 'storage-file' | 'none'
-}
-
-/** The workspaceRegistry mirror face (getter only). */
-export interface SwitchRegistryFace {
-  readonly archivedSessionIds: readonly string[]
-}
-
-/** Diagnostics describing how the archive set is being resolved. */
-export interface SwitchArchiveDiagnostics {
-  source: 'registry' | 'storage-file' | 'none'
-  ids: number
-  error?: string
-}
-
-/** DSH storage hub candidates for the workspace domain (json backend). */
-function storageFileCandidates(): string[] {
-  return [
-    join(homedir(), '.dsh', 'storages', 'workspace.json'),
-  ]
-}
-
-/** Parse the storage hub file's global.archivedSessionIds; throw on malformed content. */
-function readStorageFile(path: string): readonly string[] {
-  const parsed = JSON.parse(readFileSync(path, 'utf8')) as {
-    global?: { archivedSessionIds?: unknown }
-  }
-  const ids = parsed.global?.archivedSessionIds
-  if (!Array.isArray(ids)) throw new Error(`storage hub "${path}" holds no global.archivedSessionIds array`)
-  return ids.filter((id): id is string => typeof id === 'string')
-}
-
-/**
- * Resolve the official archive set once.
- * @param registry - lazy workspaceRegistry face (may be absent or throw).
- * @returns the archive ids plus which source served them.
- */
-export function readArchiveSet(registry?: SwitchRegistryFace): SwitchArchiveRead {
-  if (registry !== undefined) {
-    try {
-      const ids = registry.archivedSessionIds
-      if (Array.isArray(ids)) return { ids, source: 'registry' }
-    } catch { /* registry not started yet — fall through to the file */ }
-  }
-  for (const path of storageFileCandidates()) {
-    if (!existsSync(path)) continue
-    try {
-      return { ids: readStorageFile(path), source: 'storage-file' }
-    } catch { /* malformed file — try the next candidate */ }
-  }
-  return { ids: [], source: 'none' }
-}
-
-/** Build the lazy source face the syncer expects, with diagnostics capture. */
-export function createArchiveSource(getRegistry: () => SwitchRegistryFace | undefined): {
-  read: () => SwitchArchiveRead
-  diagnostics: () => SwitchArchiveDiagnostics
-} {
-  let last: SwitchArchiveDiagnostics = { source: 'none', ids: 0 }
-  return {
-    read: () => {
-      const read = readArchiveSet(getRegistry())
-      last = { source: read.source, ids: read.ids.length }
-      return read
-    },
-    diagnostics: () => ({ ...last }),
-  }
-}

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

@@ -1,211 +0,0 @@
-/**
- * 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
-    }
-  }
-}