@open-mercato/search 0.6.7-develop.6842.1.8cd8a8883c → 0.6.7-develop.6859.1.e4727b568a

package/src/modules/search/i18n/de.json

@@ -214,6 +214,8 @@
   "search.settings.vector.sectionTitle": "Vektorsuche",
   "search.settings.vector.setEnvVar": "Umgebungsvariable setzen",
   "search.settings.vector.store": "Vektorspeicher",
+  "search.settings.vector.storeUnavailable": "Vektorspeicher ist nicht verfügbar",
+  "search.settings.vector.storeUnavailableHint": "Vektorindizierung und semantische Suche werden übersprungen, bis der Speicher erreichbar ist. Installieren Sie die pgvector-Erweiterung auf Ihrem PostgreSQL-Server; der Status wird etwa einmal pro Minute neu geprüft.",
   "search.settings.vector.usingTenantConfig": "Dieser Mandant verwendet eigene Embedding-Einstellungen.",
   "search.settings.vectorDocumentsLabel": "Vektordokumente",
   "search.settings.vectorNotConfigured": "Vektorsuche ist nicht konfiguriert.",

package/src/modules/search/i18n/en.json

@@ -214,6 +214,8 @@
   "search.settings.vector.sectionTitle": "Vector Search",
   "search.settings.vector.setEnvVar": "Set environment variable",
   "search.settings.vector.store": "Vector store",
+  "search.settings.vector.storeUnavailable": "Vector store is not available",
+  "search.settings.vector.storeUnavailableHint": "Vector indexing and semantic search are skipped until the store is reachable. Install the pgvector extension on your PostgreSQL server; the status is rechecked about once a minute.",
   "search.settings.vector.usingTenantConfig": "This tenant is using its own embedding settings.",
   "search.settings.vectorDocumentsLabel": "Vector documents",
   "search.settings.vectorNotConfigured": "Vector search is not configured.",

package/src/modules/search/i18n/es.json

@@ -214,6 +214,8 @@
   "search.settings.vector.sectionTitle": "Búsqueda vectorial",
   "search.settings.vector.setEnvVar": "Configurar variable de entorno",
   "search.settings.vector.store": "Almacén vectorial",
+  "search.settings.vector.storeUnavailable": "El almacén vectorial no está disponible",
+  "search.settings.vector.storeUnavailableHint": "La indexación vectorial y la búsqueda semántica se omiten hasta que el almacén esté disponible. Instala la extensión pgvector en tu servidor PostgreSQL; el estado se vuelve a comprobar aproximadamente cada minuto.",
   "search.settings.vector.usingTenantConfig": "Este inquilino usa su propia configuración de incrustaciones.",
   "search.settings.vectorDocumentsLabel": "Documentos vectoriales",
   "search.settings.vectorNotConfigured": "La búsqueda vectorial no está configurada.",

package/src/modules/search/i18n/ko.json

@@ -214,6 +214,8 @@
   "search.settings.vector.sectionTitle": "벡터 검색",
   "search.settings.vector.setEnvVar": "환경 변수 설정",
   "search.settings.vector.store": "벡터 저장소",
+  "search.settings.vector.storeUnavailable": "벡터 저장소를 사용할 수 없습니다",
+  "search.settings.vector.storeUnavailableHint": "저장소에 연결할 수 있을 때까지 벡터 인덱싱과 의미 기반 검색은 건너뜁니다. PostgreSQL 서버에 pgvector 확장을 설치하세요. 상태는 약 1분마다 다시 확인됩니다.",
   "search.settings.vector.usingTenantConfig": "이 테넌트는 자체 임베딩 설정을 사용하고 있습니다.",
   "search.settings.vectorDocumentsLabel": "벡터 문서",
   "search.settings.vectorNotConfigured": "벡터 검색이 구성되지 않았습니다.",

package/src/modules/search/i18n/pl.json

@@ -214,6 +214,8 @@
   "search.settings.vector.sectionTitle": "Wyszukiwanie wektorowe",
   "search.settings.vector.setEnvVar": "Ustaw zmienną środowiskową",
   "search.settings.vector.store": "Magazyn wektorów",
+  "search.settings.vector.storeUnavailable": "Magazyn wektorów jest niedostępny",
+  "search.settings.vector.storeUnavailableHint": "Indeksowanie wektorowe i wyszukiwanie semantyczne są pomijane, dopóki magazyn nie będzie dostępny. Zainstaluj rozszerzenie pgvector na serwerze PostgreSQL; status jest sprawdzany ponownie mniej więcej co minutę.",
   "search.settings.vector.usingTenantConfig": "Ten najemca używa własnych ustawień osadzania.",
   "search.settings.vectorDocumentsLabel": "Dokumenty wektorowe",
   "search.settings.vectorNotConfigured": "Wyszukiwanie wektorowe nie jest skonfigurowane.",

package/src/strategies/vector.strategy.ts

@@ -59,7 +59,13 @@ export class VectorSearchStrategy implements SearchStrategy {
   }
 
   async isAvailable(): Promise<boolean> {
-    return this.embeddingService.available
+    if (!this.embeddingService.available) return false
+    // A configured embedding provider says nothing about the vector store. When the
+    // store cannot serve writes (pgvector extension missing), reporting availability
+    // here makes SearchService call ensureReady() for every record and fail the whole
+    // index/delete operation. Drivers without a probe keep the previous behavior.
+    if (!this.vectorDriver.isHealthy) return true
+    return this.vectorDriver.isHealthy()
   }
 
   async ensureReady(): Promise<void> {

package/src/vector/drivers/pgvector/index.ts

@@ -1,5 +1,5 @@
 import { Pool } from 'pg'
-import { searchDebugWarn } from '../../../lib/debug'
+import { searchDebugWarn, searchWarn } from '../../../lib/debug'
 
 type PgPoolQueryResult<T> = { rows: T[]; rowCount?: number }
 type PgPoolClient = {
@@ -22,6 +22,7 @@ import type {
   VectorDriverRemoveOrphansParams,
   VectorResultPresenter,
   VectorLinkDescriptor,
+  VectorDriverStatus,
 } from '../../types'
 
 type PgVectorDriverOptions = {
@@ -38,6 +39,16 @@ const DEFAULT_MIGRATIONS_TABLE = 'vector_search_migrations'
 const DEFAULT_DIMENSION = 1536
 const DRIVER_ID = 'pgvector' as const
 
+// `undefined_file` is what Postgres raises for `extension "vector" is not available`
+// (the pgvector shared library is not installed on the server); `feature_not_supported`
+// covers managed providers that refuse the extension outright, and `undefined_object`
+// the case where the extension record is missing. None of these can be resolved by
+// retrying, so the driver reports itself unhealthy instead of failing every record.
+const EXTENSION_MISSING_CODES = new Set(['58P01', '0A000', '42704'])
+const EXTENSION_UNAVAILABLE_REASON = 'extension "vector" is not available on this PostgreSQL server'
+// Re-probe occasionally so installing pgvector recovers without restarting the process.
+const UNAVAILABLE_RECHECK_MS = 60_000
+
 function assertIdentifier(name: string, defaultName: string): string {
   const candidate = name ?? defaultName
   if (!candidate || !/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(candidate)) return defaultName
@@ -102,8 +113,60 @@ export function createPgVectorDriver(opts: PgVectorDriverOptions = {}): VectorDr
     })()
 
   let ready: Promise<void> | null = null
+  let status: { value: VectorDriverStatus; at: number } | null = null
+  let reportedReason: string | null = null
+
+  const cacheStatus = (value: VectorDriverStatus): VectorDriverStatus => {
+    status = { value, at: Date.now() }
+    if (value.available) {
+      reportedReason = null
+    } else if (value.reason && value.reason !== reportedReason) {
+      reportedReason = value.reason
+      // Always visible: replacing a per-record error storm with silence would hide the fact
+      // that vector indexing has stopped until someone opens Settings > Search.
+      searchWarn('vector.pgvector', `vector store unavailable — skipping vector indexing and search (${value.reason})`)
+    }
+    return value
+  }
+
+  // The operator-facing reason is curated rather than the raw Postgres message, which the
+  // settings API surfaces to the browser.
+  const markExtensionMissing = () => {
+    cacheStatus({ available: false, reason: EXTENSION_UNAVAILABLE_REASON })
+  }
+
+  const readCachedStatus = (): VectorDriverStatus | null => {
+    if (!status) return null
+    return Date.now() - status.at < UNAVAILABLE_RECHECK_MS ? status.value : null
+  }
+
+  const getStatus = async (): Promise<VectorDriverStatus> => {
+    const cached = readCachedStatus()
+    if (cached) return cached
+    try {
+      const res = await pool.query<{ installed: boolean; installable: boolean }>(
+        `SELECT
+           EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'vector') AS installed,
+           EXISTS (SELECT 1 FROM pg_available_extensions WHERE name = 'vector') AS installable`,
+      )
+      const row = res.rows[0]
+      if (row?.installed || row?.installable) return cacheStatus({ available: true })
+      return cacheStatus({ available: false, reason: EXTENSION_UNAVAILABLE_REASON })
+    } catch {
+      // A probe that cannot run (connection refused, permissions on the catalogs)
+      // says nothing about pgvector itself — stay optimistic so genuinely transient
+      // database problems keep their existing retry semantics.
+      return { available: true }
+    }
+  }
+
+  const isHealthy = async (): Promise<boolean> => (await getStatus()).available
 
   const ensureReady = async () => {
+    const cached = readCachedStatus()
+    if (cached && !cached.available) {
+      throw new Error(`[vector.pgvector] ${cached.reason ?? 'vector store unavailable'}`)
+    }
     if (!ready) {
       ready = withClient(pool, async (client) => {
         const ensureExtension = async (extension: 'pgcrypto' | 'vector') => {
@@ -116,6 +179,9 @@ export function createPgVectorDriver(opts: PgVectorDriverOptions = {}): VectorDr
               searchDebugWarn('vector.pgvector', `skipping ${extension} extension creation; requires superuser${details}`)
               return
             }
+            if (extension === 'vector' && pgError?.code && EXTENSION_MISSING_CODES.has(pgError.code)) {
+              markExtensionMissing()
+            }
             throw error
           }
         }
@@ -219,8 +285,16 @@ export function createPgVectorDriver(opts: PgVectorDriverOptions = {}): VectorDr
           `INSERT INTO ${migrationsIdent} (id, applied_at) VALUES ($1, now()) ON CONFLICT (id) DO NOTHING`,
           ['0001_init'],
         )
+      }).then(() => {
+        cacheStatus({ available: true })
       }).catch((err) => {
         ready = null
+        const pgError = err as { code?: string; message?: string }
+        // Without the extension the `vector` column type does not exist either, so the
+        // table DDL fails even when `CREATE EXTENSION` was skipped rather than raised.
+        if (pgError?.code === '42704' && /\bvector\b/.test(pgError.message ?? '')) {
+          markExtensionMissing()
+        }
         throw err
       })
     }
@@ -633,6 +707,8 @@ export function createPgVectorDriver(opts: PgVectorDriverOptions = {}): VectorDr
   return {
     id: 'pgvector',
     ensureReady,
+    isHealthy,
+    getStatus,
     upsert,
     delete: remove,
     getChecksum,

package/src/vector/types.ts

@@ -96,9 +96,23 @@ export type VectorDriverRemoveOrphansParams = {
   olderThan: Date
 }
 
+export type VectorDriverStatus = {
+  available: boolean
+  reason?: string
+}
+
 export interface VectorDriver {
   readonly id: VectorDriverId
   ensureReady(): Promise<void>
+  /**
+   * Cheap, cached probe answering whether the backing store can serve reads and
+   * writes at all. Drivers that cannot satisfy their hard requirements (for
+   * pgvector: the `vector` extension) MUST report `false` here so callers skip
+   * the strategy instead of failing every record. Optional for backward
+   * compatibility — an absent implementation is treated as available.
+   */
+  isHealthy?(): Promise<boolean>
+  getStatus?(): Promise<VectorDriverStatus>
   upsert(doc: VectorDriverDocument): Promise<void>
   delete(entityId: EntityId, recordId: string, tenantId: string): Promise<void>
   query(input: VectorDriverQuery): Promise<VectorDriverQueryResult[]>