@remnic/core 9.3.764 → 9.3.766

package/dist/chunk-WRFKZEO6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/search/meilisearch-backend.ts"],"sourcesContent":["import { log } from \"../logger.js\";\nimport {\n  resolveEnsureCollectionArgs,\n  type SearchBackend,\n  type SearchExecutionOptions,\n  type SearchQueryOptions,\n  type SearchResult,\n} from \"./port.js\";\nimport { scanMemoryDir } from \"./document-scanner.js\";\nimport { isSearchAborted, throwIfSearchAborted } from \"./abort.js\";\n\nexport interface MeilisearchBackendOptions {\n  host: string;\n  apiKey?: string;\n  collection: string;\n  timeoutMs?: number;\n  autoIndex?: boolean;\n  memoryDir?: string;\n}\n\n/**\n * Meilisearch search backend — server-based SDK client.\n *\n * Requires a running Meilisearch instance. Uses the official `meilisearch` SDK.\n * When `autoIndex` is true, update() pushes docs from the local memory directory.\n */\nexport class MeilisearchBackend implements SearchBackend {\n  private readonly host: string;\n  private readonly apiKey?: string;\n  private readonly collection: string;\n  private readonly timeoutMs: number;\n  private readonly autoIndex: boolean;\n  private readonly memoryDir?: string;\n  private available = false;\n  private client: any = null;\n  private meiliModule: any = null;\n\n  constructor(opts: MeilisearchBackendOptions) {\n    this.host = opts.host;\n    this.apiKey = opts.apiKey;\n    this.collection = opts.collection;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n    this.autoIndex = opts.autoIndex ?? false;\n    this.memoryDir = opts.memoryDir;\n  }\n\n  async probe(): Promise<boolean> {\n    try {\n      const client = await this.ensureClient();\n      await client.health();\n      this.available = true;\n      return true;\n    } catch (err) {\n      log.debug(`MeilisearchBackend probe failed: ${err}`);\n      this.available = false;\n      return false;\n    }\n  }\n\n  isAvailable(): boolean {\n    return this.available;\n  }\n\n  debugStatus(): string {\n    return `backend=meilisearch available=${this.available} host=${this.host}`;\n  }\n\n  async search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    _options?: SearchQueryOptions,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]> {\n    if (isSearchAborted(execution)) return [];\n    // Try hybrid first; fall back to plain FTS only if hybrid throws (e.g. no embedder configured)\n    try {\n      return await this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 0.5, embedder: \"default\" } }, collection, true, execution);\n    } catch {\n      if (isSearchAborted(execution)) return [];\n      return this.bm25Search(query, collection, maxResults, execution);\n    }\n  }\n\n  async searchGlobal(query: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    const limit = maxResults ?? 10;\n    if (!this.available) return [];\n\n    try {\n      throwIfSearchAborted(execution, \"MeilisearchBackend global search aborted\");\n      const client = await this.ensureClient();\n      const indexes = await client.getIndexes();\n      throwIfSearchAborted(execution, \"MeilisearchBackend global search aborted\");\n      const queries = (indexes.results ?? []).map((idx: any) => ({\n        indexUid: idx.uid,\n        q: query,\n        limit,\n        showRankingScore: true,\n      }));\n      if (queries.length === 0) return [];\n\n      const multiResult = await client.multiSearch({ queries });\n      throwIfSearchAborted(execution, \"MeilisearchBackend global search aborted\");\n      const allResults: SearchResult[] = [];\n      for (const result of multiResult.results ?? []) {\n        allResults.push(...this.mapHits(result.hits ?? []));\n      }\n      allResults.sort((a, b) => b.score - a.score);\n      return allResults.slice(0, limit);\n    } catch (err) {\n      log.debug(`MeilisearchBackend searchGlobal failed: ${err}`);\n      return [];\n    }\n  }\n\n  async bm25Search(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.doSearch(query, maxResults ?? 10, undefined, collection, false, execution);\n  }\n\n  async vectorSearch(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 1.0, embedder: \"default\" } }, collection, false, execution);\n  }\n\n  async hybridSearch(query: string, collection?: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]> {\n    return this.doSearch(query, maxResults ?? 10, { hybrid: { semanticRatio: 0.5, embedder: \"default\" } }, collection, false, execution);\n  }\n\n  async update(execution?: SearchExecutionOptions): Promise<void> {\n    await this.updateCollection(this.collection, execution);\n  }\n\n  async updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void> {\n    if (!this.memoryDir) return;\n    await this.updateCollectionFromDir(collection, this.memoryDir, execution);\n  }\n\n  async updateCollectionFromDir(collection: string, memoryDir: string, execution?: SearchExecutionOptions): Promise<void> {\n    if (!this.autoIndex) return;\n    if (!this.available) return;\n    if (isSearchAborted(execution)) return;\n\n    try {\n      const ensured = await this.ensureCollection(memoryDir, collection, execution);\n      if (ensured === \"skipped\" || ensured === \"missing\") return;\n      const client = await this.ensureClient();\n      if (isSearchAborted(execution)) return;\n      const docs = await scanMemoryDir(memoryDir);\n      if (isSearchAborted(execution)) return;\n      const index = client.index(collection);\n\n      const meilDocs = docs.map((d) => ({\n        id: d.docid,\n        path: d.path,\n        content: d.content,\n        snippet: d.snippet,\n      }));\n\n      // Upsert current docs and wait for the task to complete\n      if (isSearchAborted(execution)) return;\n      const addTask = await index.addDocuments(meilDocs, { primaryKey: \"id\" });\n      await client.waitForTask(addTask.taskUid, { timeOutMs: this.timeoutMs });\n      if (isSearchAborted(execution)) return;\n\n      // Remove docs that no longer exist on disk (paginated to handle large indexes)\n      const currentIds = new Set(docs.map((d) => d.docid));\n      try {\n        const PAGE_SIZE = 1000;\n        let offset = 0;\n        let staleIds: string[] = [];\n        let hasMore = true;\n        while (hasMore) {\n          if (isSearchAborted(execution)) return;\n          const page = await index.getDocuments({ limit: PAGE_SIZE, offset, fields: [\"id\"] });\n          const results = page.results ?? [];\n          for (const doc of results) {\n            const id = doc.id as string;\n            if (!currentIds.has(id)) staleIds.push(id);\n          }\n          offset += results.length;\n          hasMore = results.length === PAGE_SIZE;\n        }\n        if (staleIds.length > 0) {\n          if (isSearchAborted(execution)) return;\n          const delTask = await index.deleteDocuments(staleIds);\n          await client.waitForTask(delTask.taskUid, { timeOutMs: this.timeoutMs });\n        }\n      } catch {\n        // Deletion cleanup is best-effort\n      }\n    } catch (err) {\n      log.debug(`MeilisearchBackend update failed: ${err}`);\n    }\n  }\n\n  async embed(): Promise<void> {\n    // Meilisearch handles its own embedding when configured with an embedder\n  }\n\n  async embedCollection(collection: string): Promise<void> {\n    // Meilisearch handles its own embedding when configured with an embedder\n    // The collection parameter is accepted for interface compliance but Meilisearch\n    // manages embeddings server-side per index (collection).\n  }\n\n  async ensureCollection(\n    _memoryDir: string,\n    collectionOrExecution?: string | SearchExecutionOptions,\n    execution?: SearchExecutionOptions,\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\"> {\n    const { collection, execution: effectiveExecution } = resolveEnsureCollectionArgs(\n      collectionOrExecution,\n      execution,\n    );\n    if (!this.available) return \"skipped\";\n    if (isSearchAborted(effectiveExecution)) return \"skipped\";\n    const targetCollection = collection ?? this.collection;\n    try {\n      const client = await this.ensureClient();\n      if (isSearchAborted(effectiveExecution)) return \"skipped\";\n      try {\n        await client.getIndex(targetCollection);\n        return \"present\";\n      } catch (err) {\n        if (!isMeilisearchIndexNotFoundError(err)) {\n          log.debug(\n            `MeilisearchBackend collection check unavailable for \"${targetCollection}\" (will not skip update): ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          );\n          return \"unknown\";\n        }\n        // Index doesn't exist — create it\n        if (isSearchAborted(effectiveExecution)) return \"skipped\";\n        const createTask = await client.createIndex(targetCollection, { primaryKey: \"id\" });\n        if (isSearchAborted(effectiveExecution)) return \"skipped\";\n        if (createTask?.taskUid !== undefined && createTask?.taskUid !== null) {\n          await client.waitForTask(createTask.taskUid, { timeOutMs: this.timeoutMs });\n        }\n        return \"present\";\n      }\n    } catch (err) {\n      log.debug(\n        `MeilisearchBackend collection check failed for \"${targetCollection}\" (will not disable updates): ${\n          err instanceof Error ? err.message : String(err)\n        }`,\n      );\n      return \"unknown\";\n    }\n  }\n\n  private async ensureClient(): Promise<any> {\n    if (this.client) return this.client;\n    if (!this.meiliModule) {\n      this.meiliModule = await import(\"meilisearch\");\n    }\n    const MeiliSearch = this.meiliModule.MeiliSearch ?? this.meiliModule.default?.MeiliSearch;\n    this.client = new MeiliSearch({\n      host: this.host,\n      apiKey: this.apiKey,\n      timeout: this.timeoutMs,\n    });\n    return this.client;\n  }\n\n  private async doSearch(\n    query: string,\n    limit: number,\n    extra?: Record<string, unknown>,\n    collection?: string,\n    rethrow = false,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]> {\n    if (!this.available) return [];\n    if (isSearchAborted(execution)) return [];\n    try {\n      const client = await this.ensureClient();\n      throwIfSearchAborted(execution, \"MeilisearchBackend search aborted\");\n      const index = client.index(collection ?? this.collection);\n      const result = await index.search(query, { limit, showRankingScore: true, ...extra });\n      throwIfSearchAborted(execution, \"MeilisearchBackend search aborted\");\n      return this.mapHits(result.hits ?? []);\n    } catch (err) {\n      log.debug(`MeilisearchBackend search failed: ${err}`);\n      if (rethrow) throw err;\n      return [];\n    }\n  }\n\n  private mapHits(hits: any[]): SearchResult[] {\n    return hits.map((hit) => ({\n      docid: hit.id ?? \"\",\n      path: hit.path ?? \"\",\n      snippet: hit._formatted?.content ?? hit.snippet ?? hit.content?.slice(0, 200) ?? \"\",\n      score: hit._rankingScore ?? 0.5,\n    }));\n  }\n}\n\nfunction isMeilisearchIndexNotFoundError(err: unknown): boolean {\n  if (!err || typeof err !== \"object\") {\n    return false;\n  }\n  const record = err as Record<string, unknown>;\n  const code = typeof record.code === \"string\" ? record.code.toLowerCase() : \"\";\n  const type = typeof record.type === \"string\" ? record.type.toLowerCase() : \"\";\n  const status =\n    typeof record.status === \"number\"\n      ? record.status\n      : typeof record.statusCode === \"number\"\n        ? record.statusCode\n        : undefined;\n  const message = err instanceof Error\n    ? err.message.toLowerCase()\n    : typeof record.message === \"string\"\n      ? record.message.toLowerCase()\n      : \"\";\n\n  return (\n    code === \"index_not_found\"\n    || type === \"index_not_found\"\n    || status === 404\n    || message.includes(\"index_not_found\")\n    || /index .*not found/.test(message)\n    || /index .*does not exist/.test(message)\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-YNQ6DFSV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/search/port.ts"],"sourcesContent":["import type { QmdSearchResult } from \"../types.js\";\n\n/** Alias so consumers don't need to reference \"Qmd\" in a backend-agnostic context. */\nexport type SearchResult = QmdSearchResult;\n\nexport interface SearchQueryOptions {\n  intent?: string;\n  explain?: boolean;\n  candidateLimit?: number;\n  rerank?: boolean;\n  chunkStrategy?: \"auto\" | \"regex\";\n  structuredSearches?: Array<{ type: \"lex\" | \"vec\" | \"hyde\"; query: string }>;\n}\n\n/**\n * A search that returned empty (or partial) results because the backend was\n * unavailable, still loading, or timed out — cases that are otherwise\n * indistinguishable from a genuine \"no matches\" (issue #1536, CLAUDE.md\n * rule 34).\n */\nexport interface SearchDegradation {\n  backend: \"qmd\";\n  code:\n    | \"backend_unavailable\"\n    | \"daemon_timeout\"\n    | \"daemon_loading\"\n    | \"subprocess_error\"\n    | \"deadline_exceeded\";\n  detail?: string;\n}\n\nexport interface SearchExecutionOptions {\n  signal?: AbortSignal;\n  /**\n   * Observer invoked when the backend degrades during this call (#1536).\n   * Callers that need to distinguish empty-because-degraded from\n   * empty-because-no-matches (recall x-ray, fallback decisions) pass a\n   * collector here. Observer failures are swallowed by the notifier —\n   * observability must never break search.\n   */\n  onDegradation?: (degradation: SearchDegradation) => void;\n}\n\nexport function resolveEnsureCollectionArgs(\n  collectionOrExecution?: string | SearchExecutionOptions,\n  execution?: SearchExecutionOptions,\n): { collection?: string; execution?: SearchExecutionOptions } {\n  if (typeof collectionOrExecution === \"string\") {\n    return { collection: collectionOrExecution, execution };\n  }\n  return { collection: undefined, execution: collectionOrExecution ?? execution };\n}\n\n/**\n * Abstract search backend interface.\n *\n * Implementations:\n * - QmdClient (default, local hybrid BM25+vector+reranking)\n * - OramaBackend (embedded, pure JS, hybrid FTS+vector)\n * - LanceDbBackend (embedded, native Arrow bindings, RRF reranking)\n * - MeilisearchBackend (server-based SDK, hybrid search)\n * - RemoteSearchBackend (HTTP REST adapter)\n * - NoopSearchBackend (graceful degradation)\n *\n * See docs/writing-a-search-backend.md for the implementation guide.\n */\nexport interface SearchBackend {\n  // ── Lifecycle ──\n  probe(): Promise<boolean>;\n  /**\n   * Optional non-mutating availability probe for health/readiness checks.\n   * Implementations must avoid auto-upgrades, collection creation, daemon\n   * startup, or any other runtime-modifying side effects.\n   */\n  checkAvailability?(execution?: SearchExecutionOptions): Promise<boolean>;\n  isAvailable(): boolean;\n  debugStatus(): string;\n\n  // ── Search ──\n  search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    options?: SearchQueryOptions,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]>;\n  searchGlobal(query: string, maxResults?: number, execution?: SearchExecutionOptions): Promise<SearchResult[]>;\n  bm25Search(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]>;\n  vectorSearch(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]>;\n  hybridSearch(\n    query: string,\n    collection?: string,\n    maxResults?: number,\n    execution?: SearchExecutionOptions,\n  ): Promise<SearchResult[]>;\n\n  // ── Maintenance ──\n  update(execution?: SearchExecutionOptions): Promise<void>;\n  /**\n   * Optional strict refresh used by callers that must know whether the backend\n   * was actually refreshed before writing success markers. Ordinary update\n   * calls remain fail-open for migration/maintenance resilience.\n   */\n  updateStrict?(execution?: SearchExecutionOptions): Promise<void>;\n  updateCollection(collection: string, execution?: SearchExecutionOptions): Promise<void>;\n  updateCollectionFromDir?(collection: string, memoryDir: string, execution?: SearchExecutionOptions): Promise<void>;\n  /**\n   * True when update() refreshes every indexed collection, not just this\n   * backend's configured collection. Namespace routers use this to avoid\n   * repeating the same expensive global update once per namespace.\n   */\n  updatesAllCollections?(): boolean;\n  /**\n   * Optional strict refresh used by callers that must know whether a collection\n   * was actually refreshed before writing success markers. Ordinary update\n   * calls remain fail-open for migration/maintenance resilience.\n   */\n  updateCollectionStrict?(collection: string, execution?: SearchExecutionOptions): Promise<void>;\n  embed(): Promise<void>;\n  /**\n   * Optional strict embed used by callers that must know vectors were actually\n   * refreshed before writing success markers.\n   */\n  embedStrict?(): Promise<void>;\n  embedCollection(collection: string): Promise<void>;\n  /**\n   * Optional strict collection embed used by callers that must know vectors were\n   * actually refreshed before writing success markers.\n   */\n  embedCollectionStrict?(collection: string): Promise<void>;\n\n  // ── Collection management ──\n  /**\n   * Optional non-mutating collection probe. Backends that can distinguish a\n   * missing collection from a transient probe failure should implement this so\n   * callers can avoid auto-creating collections in unsafe layouts.\n   */\n  checkCollection?(\n    collectionOrExecution?: string | SearchExecutionOptions,\n    execution?: SearchExecutionOptions,\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n  ensureCollection(\n    memoryDir: string,\n    execution?: SearchExecutionOptions,\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n  ensureCollection(\n    memoryDir: string,\n    collection?: string,\n    execution?: SearchExecutionOptions,\n  ): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n}\n"],"mappings":";AA2CO,SAAS,4BACd,uBACA,WAC6D;AAC7D,MAAI,OAAO,0BAA0B,UAAU;AAC7C,WAAO,EAAE,YAAY,uBAAuB,UAAU;AAAA,EACxD;AACA,SAAO,EAAE,YAAY,QAAW,WAAW,yBAAyB,UAAU;AAChF;","names":[]}