@happyvertical/smrt-facts 0.40.70 → 0.41.0

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-facts",
-  "packageVersion": "0.40.70",
+  "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": [
@@ -242,9 +236,23 @@
             "unique": true
           },
           {
-            "name": "fact_contents_tenant_id_idx",
+            "name": "fact_contents_slug_context_idx",
             "columns": [
-              "tenant_id"
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_contents_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "fact_contents_content_id_idx",
+            "columns": [
+              "content_id"
             ]
           }
         ],
@@ -443,12 +451,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_content_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_content_collections_slug_context_idx",
             "columns": [
@@ -456,6 +458,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_content_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "22be8f54"
@@ -530,7 +538,7 @@
           "default": ""
         },
         "confidence": {
-          "type": "integer",
+          "type": "decimal",
           "required": false,
           "default": 0
         },
@@ -652,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",
@@ -740,7 +748,7 @@
             "default": ""
           },
           "confidence": {
-            "type": "INTEGER",
+            "type": "REAL",
             "notNull": false,
             "unique": false,
             "default": 0
@@ -759,12 +767,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_evidences_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_evidences_fact_id_evidence_key_idx",
             "columns": [
@@ -774,13 +776,21 @@
             "unique": true
           },
           {
-            "name": "fact_evidences_tenant_id_idx",
+            "name": "fact_evidences_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_evidences_tenant_id_created_at_idx",
             "columns": [
-              "tenant_id"
+              "tenant_id",
+              "created_at"
             ]
           }
         ],
-        "version": "46bab2ba"
+        "version": "5554e681"
       }
     },
     "@happyvertical/smrt-facts:FactEvidenceCollection": {
@@ -935,12 +945,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_evidences_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_evidences_slug_context_idx",
             "columns": [
@@ -948,6 +952,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_evidences_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "80329e4f"
@@ -1588,7 +1598,13 @@
         "cli": true,
         "tenantScoped": {
           "mode": "optional"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context",
+          "_meta_type"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "FactSource",
@@ -1678,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"
@@ -1700,9 +1711,16 @@
             ]
           },
           {
-            "name": "fact_sources_tenant_id_idx",
+            "name": "fact_sources_tenant_id_created_at_idx",
             "columns": [
-              "tenant_id"
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "fact_sources_fact_id_idx",
+            "columns": [
+              "fact_id"
             ]
           }
         ],
@@ -1861,12 +1879,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_source_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_source_collections_slug_context_idx",
             "columns": [
@@ -1874,6 +1886,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_source_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "36f4adef"
@@ -2115,12 +2133,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_subjects_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_subjects_fact_id_entity_type_idx",
             "columns": [
@@ -2131,9 +2143,17 @@
             "unique": true
           },
           {
-            "name": "fact_subjects_tenant_id_idx",
+            "name": "fact_subjects_slug_context_idx",
             "columns": [
-              "tenant_id"
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_subjects_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
             ]
           }
         ],
@@ -2342,12 +2362,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_subject_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_subject_collections_slug_context_idx",
             "columns": [
@@ -2355,6 +2369,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_subject_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "0ce73db4"
@@ -2557,12 +2577,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_tags_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_tags_fact_id_tag_slug_idx",
             "columns": [
@@ -2572,9 +2586,17 @@
             "unique": true
           },
           {
-            "name": "fact_tags_tenant_id_idx",
+            "name": "fact_tags_slug_context_idx",
             "columns": [
-              "tenant_id"
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "fact_tags_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
             ]
           }
         ],
@@ -2743,12 +2765,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_tag_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_tag_collections_slug_context_idx",
             "columns": [
@@ -2756,6 +2772,12 @@
               "context"
             ],
             "unique": true
+          },
+          {
+            "name": "fact_tag_collections_created_at_idx",
+            "columns": [
+              "created_at"
+            ]
           }
         ],
         "version": "4bac3c1d"
@@ -3503,7 +3525,13 @@
         "cli": true,
         "tenantScoped": {
           "mode": "optional"
-        }
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context",
+          "_meta_type"
+        ]
       },
       "extends": "SmrtObject",
       "exportName": "Fact",
@@ -3619,15 +3647,10 @@
           }
         },
         "indexes": [
-          {
-            "name": "facts_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "facts_slug_context_meta_type_idx",
             "columns": [
+              "tenant_id",
               "slug",
               "context",
               "_meta_type"
@@ -3641,9 +3664,16 @@
             ]
           },
           {
-            "name": "facts_tenant_id_idx",
+            "name": "facts_tenant_id_created_at_idx",
             "columns": [
-              "tenant_id"
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "facts_previous_fact_id_idx",
+            "columns": [
+              "previous_fact_id"
             ]
           }
         ],
@@ -4019,12 +4049,6 @@
           }
         },
         "indexes": [
-          {
-            "name": "fact_collections_id_idx",
-            "columns": [
-              "id"
-            ]
-          },
           {
             "name": "fact_collections_slug_context_idx",
             "columns": [
@@ -4032,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.70",
+  "packageVersion": "0.41.0",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "b77d36a3936621a60bf75b859919fb9bfc6cac5e984e0dbb72d2e07d89deda0b",
-    "packageJson": "dfb14fed1fd92ec8b092d38b44659a43a0068f98b310901b52d6bb41e76cdc78",
-    "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.70",
+  "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.70",
-    "@happyvertical/smrt-prompts": "0.40.70",
-    "@happyvertical/smrt-tenancy": "0.40.70"
+    "@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.70"
+    "@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 ."