@happyvertical/smrt-facts 0.40.69 → 0.41.0

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-facts",
-  "packageVersion": "0.40.69",
+  "packageVersion": "0.41.0",
   "objects": {
     "@happyvertical/smrt-facts:FactContent": {
       "name": "factcontent",
@@ -226,12 +226,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_contents_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_contents_fact_id_content_id_idx",
             "columns": [
@@ -240,6 +234,26 @@
               "relationship"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_contents_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_contents_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "fact_contents_content_id_idx",
+            "columns": [
+              "content_id"
+            ]
           }
         ],
         "version": "e74eafde"
@@ -437,12 +451,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_content_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_content_collections_slug_context_idx",
             "columns": [
@@ -450,6 +458,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_content_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "22be8f54"
@@ -524,7 +538,7 @@
           "default": ""
         },
         "confidence": {
-          "type": "integer",
+          "type": "decimal",
           "required": false,
           "default": 0
         },
@@ -646,7 +660,7 @@
       ],
       "schema": {
         "tableName": "fact_evidences",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"fact_evidences\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"fact_id\" UUID NOT NULL,\n  \"evidence_key\" TEXT NOT NULL DEFAULT '',\n  \"status\" TEXT NOT NULL DEFAULT 'supports',\n  \"source_kind\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"source_url\" TEXT DEFAULT '',\n  \"source_title\" TEXT DEFAULT '',\n  \"quote\" TEXT DEFAULT '',\n  \"locator\" TEXT DEFAULT '',\n  \"extraction_method\" TEXT DEFAULT '',\n  \"confidence\" INTEGER DEFAULT 0,\n  \"metadata\" TEXT DEFAULT '',\n  \"tenant_id\" UUID\n);",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"fact_evidences\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"fact_id\" UUID NOT NULL,\n  \"evidence_key\" TEXT NOT NULL DEFAULT '',\n  \"status\" TEXT NOT NULL DEFAULT 'supports',\n  \"source_kind\" TEXT DEFAULT '',\n  \"source_id\" TEXT DEFAULT '',\n  \"source_url\" TEXT DEFAULT '',\n  \"source_title\" TEXT DEFAULT '',\n  \"quote\" TEXT DEFAULT '',\n  \"locator\" TEXT DEFAULT '',\n  \"extraction_method\" TEXT DEFAULT '',\n  \"confidence\" REAL DEFAULT 0,\n  \"metadata\" TEXT DEFAULT '',\n  \"tenant_id\" UUID\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -734,7 +748,7 @@
             "default": ""
           },
           "confidence": {
-            "type": "INTEGER",
+            "type": "REAL",
             "notNull": false,
             "unique": false,
             "default": 0
@@ -753,12 +767,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_evidences_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_evidences_fact_id_evidence_key_idx",
             "columns": [
@@ -766,9 +774,23 @@
               "evidence_key"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_evidences_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_evidences_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
-        "version": "46bab2ba"
+        "version": "5554e681"
       }
     },
     "@happyvertical/smrt-facts:FactEvidenceCollection": {
@@ -923,12 +945,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_evidences_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_evidences_slug_context_idx",
             "columns": [
@@ -936,6 +952,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_evidences_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "80329e4f"
@@ -1576,7 +1598,13 @@
         "cli": true,
         "tenantScoped": {
           "mode": "optional"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context",
+          "_meta_type"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "FactSource",
@@ -1666,15 +1694,10 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_sources_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_sources_slug_context_meta_type_idx",
             "columns": [
+              "tenant_id",
               "slug",
               "context",
               "_meta_type"
@@ -1686,6 +1709,19 @@
             "columns": [
               "_meta_type"
             ]
+          },
+          {
+            "name": "fact_sources_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "fact_sources_fact_id_idx",
+            "columns": [
+              "fact_id"
+            ]
           }
         ],
         "version": "7f9f04b2"
@@ -1843,12 +1879,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_source_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_source_collections_slug_context_idx",
             "columns": [
@@ -1856,6 +1886,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_source_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "36f4adef"
@@ -2097,12 +2133,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_subjects_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_subjects_fact_id_entity_type_idx",
             "columns": [
@@ -2111,6 +2141,20 @@
               "entity_id"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_subjects_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_subjects_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
         "version": "979731eb"
@@ -2318,12 +2362,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_subject_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_subject_collections_slug_context_idx",
             "columns": [
@@ -2331,6 +2369,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_subject_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "0ce73db4"
@@ -2533,12 +2577,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_tags_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_tags_fact_id_tag_slug_idx",
             "columns": [
@@ -2546,6 +2584,20 @@
               "tag_slug"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_tags_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_tags_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
           }
         ],
         "version": "ebb242b1"
@@ -2713,12 +2765,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_tag_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_tag_collections_slug_context_idx",
             "columns": [
@@ -2726,6 +2772,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_tag_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "4bac3c1d"
@@ -3473,7 +3525,13 @@
         "cli": true,
         "tenantScoped": {
           "mode": "optional"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context",
+          "_meta_type"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "Fact",
@@ -3589,15 +3647,10 @@
           }
         },
         "indexes": [
-          {
-            "name": "facts_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "facts_slug_context_meta_type_idx",
             "columns": [
+              "tenant_id",
               "slug",
               "context",
               "_meta_type"
@@ -3609,6 +3662,19 @@
             "columns": [
               "_meta_type"
             ]
+          },
+          {
+            "name": "facts_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "facts_previous_fact_id_idx",
+            "columns": [
+              "previous_fact_id"
+            ]
           }
         ],
         "version": "b48d7b97"
@@ -3983,12 +4049,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_collections_slug_context_idx",
             "columns": [
@@ -3996,6 +4056,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "3008a4e3"

package/dist/smrt-knowledge.json

@@ -3,13 +3,13 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-facts",
-  "packageVersion": "0.40.69",
+  "packageVersion": "0.41.0",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "6e9c3fcb2280655dd74a8ef5c753ae6575ba1e85268a937f6406c7f7bc9c50e2",
-    "packageJson": "3c7484f9e35eee6c38a804207de0c2a8dc6bdd0883b7605785822616705660f6",
-    "agents": "f44effcb7b1f7689941d072f09ebeccbadedcbc1c207555f8a5481a94ef0a350"
+    "manifest": "33aa9f4a697cb056fc93fe2bded9f245095b000cac4ff98dd31bb78efd812261",
+    "packageJson": "06310d91b5a8fa2b5b16fa5c461a985ef287f78fbefc70f3259dad8f25840d3e",
+    "agents": "3dff097c8282b094889f06247bdab664e75e54c85c4025219c82007f57b3a1bd"
   },
   "exports": [
     ".",
@@ -432,9 +432,9 @@
         },
         {
           "name": "confidence",
-          "type": "integer",
+          "type": "decimal",
           "required": false,
-          "columnType": "INTEGER",
+          "columnType": "REAL",
           "default": 0
         },
         {
@@ -1111,6 +1111,12 @@
         "field": "tenantId"
       },
       "tableStrategy": "sti",
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context",
+        "_meta_type"
+      ],
       "surfaces": [
         {
           "kind": "api",
@@ -2385,6 +2391,12 @@
         "field": "tenantId"
       },
       "tableStrategy": "sti",
+      "conflictColumns": [
+        "tenant_id",
+        "slug",
+        "context",
+        "_meta_type"
+      ],
       "surfaces": [
         {
           "kind": "api",
@@ -3207,5 +3219,5 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 25
   },
-  "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"
+  "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-facts",
-  "version": "0.40.69",
+  "version": "0.41.0",
   "description": "Distributed memory and knowledge management with provenance tracking for SMRT framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,16 +24,16 @@
     "@happyvertical/logger": "^0.88.0",
     "@happyvertical/sql": "^0.88.0",
     "@happyvertical/utils": "^0.88.0",
-    "@happyvertical/smrt-core": "0.40.69",
-    "@happyvertical/smrt-prompts": "0.40.69",
-    "@happyvertical/smrt-tenancy": "0.40.69"
+    "@happyvertical/smrt-core": "0.41.0",
+    "@happyvertical/smrt-prompts": "0.41.0",
+    "@happyvertical/smrt-tenancy": "0.41.0"
   },
   "devDependencies": {
     "@types/node": "24.13.2",
     "typescript": "5.9.3",
     "vite": "8.1.4",
     "vitest": "4.1.10",
-    "@happyvertical/smrt-vitest": "0.40.69"
+    "@happyvertical/smrt-vitest": "0.41.0"
   },
   "keywords": [
     "ai",
@@ -62,6 +62,7 @@
     "dev": "vite dev",
     "pretest": "[ -f ../cli/dist/index.js ] && node ../cli/dist/index.js test --manifest-only || true",
     "test": "vitest run",
+    "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run src/__tests__/confidence-fields.postgres.test.ts",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "verify:pack": "node ../../scripts/verify-package-types-exports.js ."