@happyvertical/smrt-facts 0.49.3 → 0.49.4

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-facts",
-  "packageVersion": "0.49.3",
+  "packageVersion": "0.49.4",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "47a440c7504a1a24e82efc9e014cabedcdf131699a3bd375126637730268c7c6",
-    "packageJson": "b54e34b04dbb5846ca81939584789ab2c6d35d4153be6358ca320c54a74526c8",
+    "manifest": "8314b8775e8f20cb502ba30d1b19b580bb8c6c572bea3699b7a7369dc9ab167a",
+    "packageJson": "dbc23f9a82d8e89f5c787df3b7c0cf803949376225020611a912fd7a6d8684f2",
     "agents": "3dff097c8282b094889f06247bdab664e75e54c85c4025219c82007f57b3a1bd"
   },
   "exports": [
@@ -325,7 +325,7 @@
       "name": "FactContentCollection",
       "qualifiedName": "@happyvertical/smrt-facts:FactContentCollection",
       "collection": "factcontents",
-      "tableName": "fact_content_collections",
+      "tableName": "fact_contents",
       "packageName": "@happyvertical/smrt-facts",
       "extends": "SmrtJunction",
       "fields": [],
@@ -1349,7 +1349,7 @@
       "name": "FactSourceCollection",
       "qualifiedName": "@happyvertical/smrt-facts:FactSourceCollection",
       "collection": "factsources",
-      "tableName": "fact_source_collections",
+      "tableName": "fact_sources",
       "packageName": "@happyvertical/smrt-facts",
       "extends": "SmrtCollection",
       "fields": [],
@@ -1872,7 +1872,7 @@
       "name": "FactSubjectCollection",
       "qualifiedName": "@happyvertical/smrt-facts:FactSubjectCollection",
       "collection": "factsubjects",
-      "tableName": "fact_subject_collections",
+      "tableName": "fact_subjects",
       "packageName": "@happyvertical/smrt-facts",
       "extends": "SmrtCollection",
       "fields": [],
@@ -2398,7 +2398,7 @@
       "name": "FactTagCollection",
       "qualifiedName": "@happyvertical/smrt-facts:FactTagCollection",
       "collection": "facttags",
-      "tableName": "fact_tag_collections",
+      "tableName": "fact_tags",
       "packageName": "@happyvertical/smrt-facts",
       "extends": "SmrtCollection",
       "fields": [],
@@ -3133,13 +3133,14 @@
       "name": "FactCollection",
       "qualifiedName": "@happyvertical/smrt-facts:FactCollection",
       "collection": "facts",
-      "tableName": "fact_collections",
+      "tableName": "facts",
       "packageName": "@happyvertical/smrt-facts",
       "extends": "SmrtCollection",
       "fields": [],
       "relationships": [],
       "methods": [
         "assessClaimSupport",
+        "backfillCatalogSearch",
         "branch",
         "browseCatalog",
         "extractArticleClaims",
@@ -3172,6 +3173,14 @@
           ],
           "returns": "Promise<FactClaimSupportAssessment>"
         },
+        {
+          "name": "backfillCatalogSearch",
+          "async": true,
+          "params": [
+            "batchSize?: any"
+          ],
+          "returns": "Promise<object>"
+        },
         {
           "name": "branch",
           "async": true,
@@ -3412,6 +3421,14 @@
           "path": "/facts/browseCatalog",
           "method": "POST"
         },
+        {
+          "kind": "api",
+          "name": "facts.backfillCatalogSearch",
+          "operation": "backfillCatalogSearch",
+          "objectName": "@happyvertical/smrt-facts:FactCollection",
+          "path": "/facts/backfillCatalogSearch",
+          "method": "POST"
+        },
         {
           "kind": "api",
           "name": "facts.getForContent",
@@ -3560,6 +3577,12 @@
           "operation": "browseCatalog",
           "objectName": "@happyvertical/smrt-facts:FactCollection"
         },
+        {
+          "kind": "cli",
+          "name": "factcollection_backfillCatalogSearch",
+          "operation": "backfillCatalogSearch",
+          "objectName": "@happyvertical/smrt-facts:FactCollection"
+        },
         {
           "kind": "cli",
           "name": "factcollection_getForContent",
@@ -3686,6 +3709,12 @@
           "operation": "browseCatalog",
           "objectName": "@happyvertical/smrt-facts:FactCollection"
         },
+        {
+          "kind": "mcp",
+          "name": "factcollection_backfillcatalogsearch",
+          "operation": "backfillCatalogSearch",
+          "objectName": "@happyvertical/smrt-facts:FactCollection"
+        },
         {
           "kind": "mcp",
           "name": "factcollection_getforcontent",
@@ -5319,6 +5348,14 @@
       "path": "/facts/browseCatalog",
       "method": "POST"
     },
+    {
+      "kind": "api",
+      "name": "facts.backfillCatalogSearch",
+      "operation": "backfillCatalogSearch",
+      "objectName": "@happyvertical/smrt-facts:FactCollection",
+      "path": "/facts/backfillCatalogSearch",
+      "method": "POST"
+    },
     {
       "kind": "api",
       "name": "facts.getForContent",
@@ -5467,6 +5504,12 @@
       "operation": "browseCatalog",
       "objectName": "@happyvertical/smrt-facts:FactCollection"
     },
+    {
+      "kind": "cli",
+      "name": "factcollection_backfillCatalogSearch",
+      "operation": "backfillCatalogSearch",
+      "objectName": "@happyvertical/smrt-facts:FactCollection"
+    },
     {
       "kind": "cli",
       "name": "factcollection_getForContent",
@@ -5593,6 +5636,12 @@
       "operation": "browseCatalog",
       "objectName": "@happyvertical/smrt-facts:FactCollection"
     },
+    {
+      "kind": "mcp",
+      "name": "factcollection_backfillcatalogsearch",
+      "operation": "backfillCatalogSearch",
+      "objectName": "@happyvertical/smrt-facts:FactCollection"
+    },
     {
       "kind": "mcp",
       "name": "factcollection_getforcontent",
@@ -5671,7 +5720,7 @@
     "junctionCollections": 1,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 25
+    "uuidColumns": 38
   },
   "agentDoc": "# @happyvertical/smrt-facts\n\nDistributed knowledge base with semantic deduplication, provenance tracking, and evolution chains.\n\n## Models\n\n- **Fact**: atomic knowledge unit with `textRefined`, auto-generated embeddings, status (active/pending/superseded), confidence score. Evolution via `previousFactId` (predecessor→successor with corrections/contradictions/refinements). NOT a structural hierarchy — Fact deliberately does not extend `SmrtHierarchical`; `parentId` is reserved for true structural parents elsewhere in the framework.\n- **FactSource**: provenance — URL, type, `credibility` (0-1), extraction timestamp.\n- **FactSubject**: polymorphic entity linking — `entityType` + `entityId` (no FK, string-based). `conflictColumns: ['fact_id', 'entity_type', 'entity_id']`.\n- **FactContent**: join table linking facts to Content. `conflictColumns: ['fact_id', 'content_id', 'relationship']`.\n\n## Semantic Reconciliation\n\n`reconcile()` uses three zones:\n- **≥0.85 similarity**: auto-merge (same fact, update metadata)\n- **0.60–0.85**: AI disambiguation — asks model to decide create/merge/branch\n- **<0.60**: new fact (no match)\n\n## Evolution Chains\n\n`getEvolutionChain()` (root→current), `getLatestInChain()` (highest confidence leaf), `getEvolutionTree()` (BFS all descendants). All traversals use `visited` Set for cycle detection.\n\n## Confidence Scoring\n\n`recalculateConfidence()`: weighted formula from `sourceCount`, `avgSourceCredibility`, `daysSinceLastSource`, `corroborationScore`.\n\n## Gotchas\n\n- **Embedding failures non-fatal**: try/catch with silent fail — doesn't block fact creation\n- **Metadata auto-stringify**: constructor `JSON.stringify`s objects; getters return parsed objects\n- **AI disambiguation fallback**: if AI fails, defaults to branch (safer than merge)\n- **Embeddings config**: `fields: ['textRefined'], autoGenerate: true, combinedField: {...}`\n- **Optional tenancy** with nullable tenantId. `findWithGlobals(tenantId)` for tenant + global facts\n- **Confidence/credibility must initialize `0.0`, never `0`**: they are rates, not money — inherently fractional. An integer literal compiles to an INTEGER column and a `[0, 1]` score becomes unstorable, so PostgreSQL raises `22P02` while SQLite silently accepts it. `FactEvidence.confidence` carried that bug until #2361; `pnpm --filter @happyvertical/smrt-facts test:postgres` is the lane that holds the line. (Money elsewhere in the framework goes the other way — integer minor units.)\n"
 }

package/dist/types.d.ts

@@ -22,6 +22,8 @@ export declare type EvolutionType = 'original' | 'correction' | 'refinement' | '
 declare class Fact extends SmrtObject {
     textRefined: string;
     textRaw: string;
+    /** Derived search storage. NULL requires the explicit catalog backfill. */
+    catalogSearch: string | null;
     type: string;
     status: string;
     domain: string;
@@ -42,6 +44,8 @@ declare class Fact extends SmrtObject {
     createdAt: Date;
     updatedAt: Date;
     constructor(options?: FactOptions);
+    protected getPersistenceDerivedColumns(): readonly string[];
+    protected normalizePersistenceData(data: Readonly<Record<string, unknown>>): Record<string, unknown>;
     getMetadata(): FactMetadata;
     setMetadata(data: FactMetadata): void;
     updateMetadata(updates: Partial<FactMetadata>): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-facts",
-  "version": "0.49.3",
+  "version": "0.49.4",
   "description": "Distributed memory and knowledge management with provenance tracking for SMRT framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,14 +22,14 @@
     "@happyvertical/ai": "^0.89.6",
     "@happyvertical/files": "^0.89.6",
     "@happyvertical/logger": "^0.89.6",
-    "@happyvertical/smrt-core": "0.49.3",
-    "@happyvertical/smrt-prompts": "0.49.3",
-    "@happyvertical/smrt-tenancy": "0.49.3",
+    "@happyvertical/smrt-core": "0.49.4",
+    "@happyvertical/smrt-prompts": "0.49.4",
+    "@happyvertical/smrt-tenancy": "0.49.4",
     "@happyvertical/sql": "^0.89.6",
     "@happyvertical/utils": "^0.89.6"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.49.3",
+    "@happyvertical/smrt-vitest": "0.49.4",
     "@types/node": "24.13.2",
     "typescript": "5.9.3",
     "vite": "8.1.4",