@nebutra/knowledge-rag 0.2.2 → 3.0.0

package/README.md

@@ -69,8 +69,8 @@ All thrown errors are `KnowledgeRagError` and carry an actionable
 ## How it wraps existing Sailor infra (no reinvention)
 
 - **Keyword leg → `@nebutra/search`.** `SearchKeywordIndex` wraps the existing
-  provider-agnostic search abstraction (`getSearch()` →
-  Meilisearch / Typesense / Algolia / pgvector-BM25). Each chunk is indexed as
+  search abstraction (`getSearch()` → Postgres pgvector/FTS, the single kept
+  search provider per ADR 2026-09-24). Each chunk is indexed as
   a `SearchDocument` carrying `tenantId`; every keyword query passes
   `filters: { tenantId }` and results are re-filtered by tenant, so the keyword
   leg has the same isolation guarantee as the vector leg. `@nebutra/search` is

package/dist/keyword.d.ts

@@ -25,11 +25,10 @@ export declare class SearchKeywordIndex implements KeywordIndex {
     private constructor();
     /**
      * Returns a live keyword index, or `null` when no @nebutra/search backend
-     * is genuinely reachable. The default provider auto-detects to Meilisearch
-     * even with no env; it only fails on the first network call. So we probe
-     * with a real createIndex/search call and degrade to vector-only on any
-     * failure — the zero-config path must NEVER break because a search server
-     * happens to be absent.
+     * is genuinely reachable. The default (pgvector) provider only fails on
+     * the first network call, so we probe with a real createIndex/search call
+     * and degrade to vector-only on any failure — the zero-config path must
+     * NEVER break because a search server happens to be absent.
      */
     static tryCreate(indexName: string): Promise<SearchKeywordIndex | null>;
     index(chunks: KnowledgeChunk[]): Promise<void>;

package/dist/keyword.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyword.d.ts","sourceRoot":"","sources":["../src/keyword.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAErD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAGnC,OAAO;IAKP;;;;;;;OAOG;WACU,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA0BvE,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6B5E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAWzD"}
+{"version":3,"file":"keyword.d.ts","sourceRoot":"","sources":["../src/keyword.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAErD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAGnC,OAAO;IAKP;;;;;;OAMG;WACU,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA0BvE,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6B5E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAWzD"}

package/dist/keyword.js

@@ -2,10 +2,9 @@
 // @nebutra/knowledge-rag — Keyword leg (wraps @nebutra/search)
 // =============================================================================
 // Rather than reinventing a keyword index, this WRAPS the existing
-// provider-agnostic @nebutra/search abstraction (Meilisearch / Typesense /
-// Algolia / pgvector-BM25). Each chunk is indexed as a SearchDocument carrying
-// tenantId; every query filters by { tenantId } so the keyword leg has the
-// same tenant-isolation guarantee as the vector leg.
+// @nebutra/search abstraction (pgvector-BM25). Each chunk is indexed as a
+// SearchDocument carrying tenantId; every query filters by { tenantId } so
+// the keyword leg has the same tenant-isolation guarantee as the vector leg.
 //
 // @nebutra/search is imported lazily so the zero-config path (keyword
 // disabled, no search backend) never needs it at module load.
@@ -27,11 +26,10 @@ export class SearchKeywordIndex {
     }
     /**
      * Returns a live keyword index, or `null` when no @nebutra/search backend
-     * is genuinely reachable. The default provider auto-detects to Meilisearch
-     * even with no env; it only fails on the first network call. So we probe
-     * with a real createIndex/search call and degrade to vector-only on any
-     * failure — the zero-config path must NEVER break because a search server
-     * happens to be absent.
+     * is genuinely reachable. The default (pgvector) provider only fails on
+     * the first network call, so we probe with a real createIndex/search call
+     * and degrade to vector-only on any failure — the zero-config path must
+     * NEVER break because a search server happens to be absent.
      */
     static async tryCreate(indexName) {
         try {
@@ -92,7 +90,7 @@ export class SearchKeywordIndex {
             throw new KnowledgeRagError(`Keyword search failed: ${err?.message ?? String(err)}`, {
                 code: "E_KEYWORD_SEARCH",
                 cause: err,
-                suggestion: "Check the @nebutra/search backend (MEILISEARCH_URL / TYPESENSE_URL / ALGOLIA_APP_ID), or set { disableKeyword: true } for vector-only retrieval.",
+                suggestion: "Check the @nebutra/search backend (DATABASE_URL for the pgvector provider), or set { disableKeyword: true } for vector-only retrieval.",
             });
         }
     }

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@nebutra/knowledge-rag",
-  "version": "0.2.2",
+  "version": "3.0.0",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "graph": "core",
     "status": "foundation",
     "productionReady": false,
     "requires": [
       "(none) — zero-config: in-memory vector store + deterministic local embedder",
       "optional: OPENAI_API_KEY or OPENROUTER_API_KEY (real embeddings via @nebutra/agents)",
-      "optional: MEILISEARCH_URL / TYPESENSE_URL / ALGOLIA_APP_ID (keyword leg via @nebutra/search)",
-      "optional: DATABASE_URL (pgvector store)"
+      "optional: DATABASE_URL (pgvector store; also powers the keyword leg via @nebutra/search)"
     ],
     "gaps": [
       "pgvector store is interface-only (Prisma snippet in README, not migrated)",
@@ -37,13 +37,13 @@
   "dependencies": {
     "p-timeout": "^7.0.1",
     "zod": "^4.3.6",
-    "@nebutra/ai-primitives": "0.1.2",
-    "@nebutra/agents": "1.1.2",
-    "@nebutra/errors": "0.1.2",
-    "@nebutra/local-embedding": "0.1.2",
-    "@nebutra/logger": "0.1.2",
-    "@nebutra/search": "0.1.2",
-    "@nebutra/tenant-store": "0.2.2"
+    "@nebutra/agents": "3.0.0",
+    "@nebutra/ai-primitives": "0.1.3",
+    "@nebutra/errors": "3.0.0",
+    "@nebutra/local-embedding": "0.1.4",
+    "@nebutra/logger": "3.0.0",
+    "@nebutra/search": "3.0.0",
+    "@nebutra/tenant-store": "3.0.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3",