@memberjunction/core-entities 5.30.0 → 5.31.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/core-entities",
   "type": "module",
-  "version": "5.30.0",
+  "version": "5.31.0",
   "description": "Entity subclasses for the metadata layer of MemberJunction defined in the MJ_CORE schema (usually '__mj'), distributed as part of each release of MemberJunction",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,10 +21,10 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/ai": "5.30.0",
-    "@memberjunction/core": "5.30.0",
-    "@memberjunction/global": "5.30.0",
-    "@memberjunction/interactive-component-types": "5.30.0",
+    "@memberjunction/ai": "5.31.0",
+    "@memberjunction/core": "5.31.0",
+    "@memberjunction/global": "5.31.0",
+    "@memberjunction/interactive-component-types": "5.31.0",
     "rxjs": "^7.8.2",
     "zod": "~3.24.4"
   },

package/readme.md

@@ -66,6 +66,20 @@ CodeGen scans the MemberJunction database schema and produces:
 
 There are currently **272 generated entity classes** covering approximately 78,000 lines of code in a single `entity_subclasses.ts` file.
 
+#### AIAgentNote Consolidation Schema (v5.30.x+)
+
+Migration `V202604260056__v5.30.x__Memory_Consolidation_Schema.sql` adds five columns to `AIAgentNote` to support the Memory Manager consolidation pipeline. The generated `MJAIAgentNoteEntity` getters/setters reflect these in `entity_subclasses.ts`:
+
+| Column | Type | Purpose |
+|---|---|---|
+| `ConsolidatedIntoNoteID` | uniqueidentifier (FK → AIAgentNote.ID, nullable) | When this note has been folded into a successor consolidation, points at the successor — preserves provenance after revocation |
+| `ConsolidationCount` | int | Number of times this note has itself absorbed clusters; capped at `maxConsolidationCount=3` for drift prevention |
+| `DerivedFromNoteIDs` | nvarchar(max) JSON array of UUIDs, nullable | For consolidated notes, the list of original sources the LLM merged into this one — enables anchored-mode drilling when a cluster reaches the cap |
+| `ProtectionTier` | nvarchar (Immutable / Protected / Standard / Ephemeral) | Modulates decay rate and consolidation eligibility |
+| `ImportanceScore` | float | Composite score driving Ebbinghaus decay and outlier auto-promotion |
+
+Server-side persistence and vector-store invariant maintenance for these fields lives in [`@memberjunction/core-entities-server`](../MJCoreEntitiesServer/README.md#mjaiagentnoteentityserver-v530x). The pipeline that produces them is documented in [`@memberjunction/ai-agents`](../AI/Agents/README.md#consolidation-pipeline) and [`specs/001-memory-consolidation/spec.md`](../../specs/001-memory-consolidation/spec.md).
+
 ### Extended Entity Classes
 
 Several entities require custom business logic beyond what CodeGen can generate. Extended classes use `@RegisterClass` to override the generated base class in MJ's class factory: