@x12i/memorix-retrieval 1.22.0 → 1.24.0

package/README.md

@@ -450,6 +450,37 @@ npm run catalox:seed:memorix-retrieval:apply
 npm run catalox:seed:ensure
 ```
 
+## Lists catalog (`lists`)
+
+The list descriptor catalog id is **`lists`** (legacy: `memorix-list-descriptors`). Migrate existing Catalox data with `memorix-descriptors/scripts/migrate-list-descriptors-catalog.mjs`.
+
+## Compound sort
+
+`fetchMemorixList` accepts `sort: [{ property, direction }, ...]`. Secondary sort keys must resolve to the **same content type** as the primary key. Ensure a matching compound index exists on the driver collection — there is no automatic index provisioning.
+
+## Analytics fields on lists
+
+List descriptors may declare `analytics[]` with `{ field, collection, joinBy, metric }`. Values are merged into rows per page via scoped aggregation (`groupMemorixRecords`).
+
+## Full record fetch
+
+```ts
+import { fetchMemorixFullRecord } from "@x12i/memorix-retrieval";
+
+const full = await fetchMemorixFullRecord(client, {
+  entityName: "assets",
+  entityId: "abc-123",
+  // contentTypes: ["snapshots", "analysis"], // optional subset
+});
+// full.contentTypes — raw document(s) per content type
+```
+
+Unlike `fetchMemorixItemForEntity`, this bypasses item descriptors and returns uncurated documents.
+
+## List filters
+
+Request filters use `MemorixFilterInput[]`. A property is authorized when it is `filterable: true` on the entity descriptor and belongs to the list's **leading** content type. The list descriptor's `filters[]` array supplies pinned defaults only — it is not an allow-list for ad-hoc filters.
+
 ## Build, test, and live smoke
 
 ```bash

package/catalox-seeds/inputs/entity-descriptors/assets.json

@@ -7,16 +7,16 @@
   "collectionPrefix": "assets",
   "identity": {
     "allowedIdFields": [
-      "identity.recordId",
-      "identity.targetId"
+      "recordId",
+      "recordId"
     ],
     "requiredExactlyOne": true,
-    "defaultIdField": "identity.recordId"
+    "defaultIdField": "recordId"
   },
   "defaults": {
     "canonicalContentType": "snapshots",
     "dataRoot": "data",
-    "effectiveDatePath": "lifecycle.capturedAt",
+    "effectiveDatePath": "data.lastSeen",
     "fallbackEffectiveDatePaths": [
       "capturedAt",
       "snapshot.capturedAt",
@@ -29,7 +29,7 @@
       "collection": "assets-snapshots",
       "dataRoot": "data",
       "isCanonical": true,
-      "effectiveDatePath": "lifecycle.capturedAt",
+      "effectiveDatePath": "data.lastSeen",
       "fallbackEffectiveDatePaths": [
         "capturedAt",
         "snapshot.capturedAt",
@@ -81,7 +81,7 @@
       "label": "Source",
       "source": {
         "contentType": "snapshots",
-        "path": "sourceFacts.values._source.rawValue"
+        "path": "data.source"
       },
       "humanReadable": true,
       "sortable": true,
@@ -276,7 +276,7 @@
       "label": "Raw XDR",
       "source": {
         "contentType": "snapshots",
-        "path": "sourceFacts.values.xdrRaw.rawValue"
+        "path": "data.agentId"
       },
       "humanReadable": false,
       "sortable": false,

package/catalox-seeds/inputs/entity-descriptors/vulnerabilities.json

@@ -7,16 +7,16 @@
   "collectionPrefix": "vulnerabilities",
   "identity": {
     "allowedIdFields": [
-      "identity.recordId",
-      "identity.targetId"
+      "recordId",
+      "recordId"
     ],
     "requiredExactlyOne": true,
-    "defaultIdField": "identity.recordId"
+    "defaultIdField": "recordId"
   },
   "defaults": {
     "canonicalContentType": "snapshots",
     "dataRoot": "data",
-    "effectiveDatePath": "lifecycle.capturedAt",
+    "effectiveDatePath": "data.lastSeen",
     "fallbackEffectiveDatePaths": [
       "capturedAt",
       "snapshot.capturedAt",
@@ -29,7 +29,7 @@
       "collection": "vulnerabilities-snapshots",
       "dataRoot": "data",
       "isCanonical": true,
-      "effectiveDatePath": "lifecycle.capturedAt",
+      "effectiveDatePath": "data.lastSeen",
       "fallbackEffectiveDatePaths": [
         "capturedAt",
         "snapshot.capturedAt",
@@ -42,7 +42,7 @@
       "label": "Vulnerability ID",
       "source": {
         "contentType": "snapshots",
-        "path": "sourceFacts.values.vulnerabilityId.rawValue"
+        "path": "data.vulnerabilityId"
       },
       "humanReadable": true,
       "sortable": true,
@@ -107,7 +107,7 @@
       "label": "Plugin ID",
       "source": {
         "contentType": "snapshots",
-        "path": "sourceFacts.values.pluginId.rawValue"
+        "path": "data.pluginId"
       },
       "humanReadable": true,
       "sortable": true,

package/catalox-seeds/inputs/item-descriptors/asset-detail-item.json

@@ -3,7 +3,7 @@
   "entity": "assets",
   "title": "Asset Detail",
   "identity": {
-    "idField": "identity.recordId"
+    "idField": "recordId"
   },
   "contentTypes": [
     {
@@ -11,7 +11,7 @@
       "required": true,
       "multiMatch": {
         "strategy": "last",
-        "effectiveDatePath": "lifecycle.capturedAt",
+        "effectiveDatePath": "data.lastSeen",
         "fallbackEffectiveDatePaths": [
           "capturedAt",
           "snapshot.capturedAt",

package/catalox-seeds/inputs/item-descriptors/topology-subnet-detail-item.json

@@ -3,7 +3,7 @@
   "entity": "topology-subnets",
   "title": "Topology Subnet Detail",
   "identity": {
-    "idField": "identity.recordId"
+    "idField": "recordId"
   },
   "contentTypes": [
     {
@@ -11,7 +11,7 @@
       "required": true,
       "multiMatch": {
         "strategy": "last",
-        "effectiveDatePath": "lifecycle.capturedAt",
+        "effectiveDatePath": "data.lastSeen",
         "fallbackEffectiveDatePaths": [
           "capturedAt",
           "snapshot.capturedAt"

package/catalox-seeds/inputs/item-descriptors/vulnerability-detail-item.json

@@ -3,7 +3,7 @@
   "entity": "vulnerabilities",
   "title": "Vulnerability Detail",
   "identity": {
-    "idField": "identity.recordId"
+    "idField": "recordId"
   },
   "contentTypes": [
     {
@@ -11,7 +11,7 @@
       "required": true,
       "multiMatch": {
         "strategy": "last",
-        "effectiveDatePath": "lifecycle.capturedAt",
+        "effectiveDatePath": "data.lastSeen",
         "fallbackEffectiveDatePaths": [
           "capturedAt",
           "snapshot.capturedAt",

package/catalox-seeds/inputs/list-descriptors/critical-vulnerabilities-slice.json

@@ -19,7 +19,7 @@
     }
   ],
   "fields": [
-    "identity.recordId"
+    "recordId"
   ],
   "title": "Critical vulnerabilities",
   "contentType": "snapshots",

package/catalox-seeds/inputs/manifest.json

@@ -8,7 +8,7 @@
       "topology-subnets",
       "vulnerabilities"
     ],
-    "memorix-list-descriptors": [
+    "lists": [
       "assets-main-list",
       "topology-subnets-main-list",
       "vulnerabilities-main-list",

package/catalox-seeds/inputs/memorix-catalog-ids.json

@@ -2,7 +2,7 @@
   "appId": "memorix",
   "catalogs": {
     "entityDescriptors": "memorix-object-type-descriptors",
-    "listDescriptors": "memorix-list-descriptors",
+    "listDescriptors": "lists",
     "itemDescriptors": "memorix-item-descriptors"
   }
 }

package/catalox-seeds/memorix-retrieval-descriptors.manifest.json

@@ -15,7 +15,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "name": "Memorix list descriptors",
       "catalogType": "memorix",
       "sourceMode": "native",
@@ -94,11 +94,11 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "descriptorVersion": "1",
       "mode": "replace",
       "descriptor": {
-        "catalogId": "memorix-list-descriptors",
+        "catalogId": "lists",
         "label": "Memorix list descriptors",
         "sourceMode": "native",
         "status": "active",
@@ -219,7 +219,7 @@
     },
     {
       "appId": "memorix",
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "access": {
         "canRead": true,
         "canWrite": true
@@ -254,16 +254,16 @@
         "collectionPrefix": "assets",
         "identity": {
           "allowedIdFields": [
-            "identity.recordId",
-            "identity.targetId"
+            "recordId",
+            "recordId"
           ],
           "requiredExactlyOne": true,
-          "defaultIdField": "identity.recordId"
+          "defaultIdField": "recordId"
         },
         "defaults": {
           "canonicalContentType": "snapshots",
           "dataRoot": "data",
-          "effectiveDatePath": "lifecycle.capturedAt",
+          "effectiveDatePath": "data.lastSeen",
           "fallbackEffectiveDatePaths": [
             "capturedAt",
             "snapshot.capturedAt",
@@ -276,7 +276,7 @@
             "collection": "assets-snapshots",
             "dataRoot": "data",
             "isCanonical": true,
-            "effectiveDatePath": "lifecycle.capturedAt",
+            "effectiveDatePath": "data.lastSeen",
             "fallbackEffectiveDatePaths": [
               "capturedAt",
               "snapshot.capturedAt",
@@ -328,7 +328,7 @@
             "label": "Source",
             "source": {
               "contentType": "snapshots",
-              "path": "sourceFacts.values._source.rawValue"
+              "path": "data.source"
             },
             "humanReadable": true,
             "sortable": true,
@@ -523,7 +523,7 @@
             "label": "Raw XDR",
             "source": {
               "contentType": "snapshots",
-              "path": "sourceFacts.values.xdrRaw.rawValue"
+              "path": "data.agentId"
             },
             "humanReadable": false,
             "sortable": false,
@@ -740,16 +740,16 @@
         "collectionPrefix": "vulnerabilities",
         "identity": {
           "allowedIdFields": [
-            "identity.recordId",
-            "identity.targetId"
+            "recordId",
+            "recordId"
           ],
           "requiredExactlyOne": true,
-          "defaultIdField": "identity.recordId"
+          "defaultIdField": "recordId"
         },
         "defaults": {
           "canonicalContentType": "snapshots",
           "dataRoot": "data",
-          "effectiveDatePath": "lifecycle.capturedAt",
+          "effectiveDatePath": "data.lastSeen",
           "fallbackEffectiveDatePaths": [
             "capturedAt",
             "snapshot.capturedAt",
@@ -762,7 +762,7 @@
             "collection": "vulnerabilities-snapshots",
             "dataRoot": "data",
             "isCanonical": true,
-            "effectiveDatePath": "lifecycle.capturedAt",
+            "effectiveDatePath": "data.lastSeen",
             "fallbackEffectiveDatePaths": [
               "capturedAt",
               "snapshot.capturedAt",
@@ -775,7 +775,7 @@
             "label": "Vulnerability ID",
             "source": {
               "contentType": "snapshots",
-              "path": "sourceFacts.values.vulnerabilityId.rawValue"
+              "path": "data.vulnerabilityId"
             },
             "humanReadable": true,
             "sortable": true,
@@ -840,7 +840,7 @@
             "label": "Plugin ID",
             "source": {
               "contentType": "snapshots",
-              "path": "sourceFacts.values.pluginId.rawValue"
+              "path": "data.pluginId"
             },
             "humanReadable": true,
             "sortable": true,
@@ -1331,7 +1331,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1393,7 +1393,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1428,7 +1428,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1487,7 +1487,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1543,7 +1543,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1574,7 +1574,7 @@
           }
         ],
         "fields": [
-          "identity.recordId"
+          "recordId"
         ],
         "title": "Critical vulnerabilities",
         "contentType": "snapshots",
@@ -1585,7 +1585,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1619,7 +1619,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1656,7 +1656,7 @@
       }
     },
     {
-      "catalogId": "memorix-list-descriptors",
+      "catalogId": "lists",
       "scope": {
         "domains": [
           "network",
@@ -1711,7 +1711,7 @@
         "entity": "assets",
         "title": "Asset Detail",
         "identity": {
-          "idField": "identity.recordId"
+          "idField": "recordId"
         },
         "contentTypes": [
           {
@@ -1719,7 +1719,7 @@
             "required": true,
             "multiMatch": {
               "strategy": "last",
-              "effectiveDatePath": "lifecycle.capturedAt",
+              "effectiveDatePath": "data.lastSeen",
               "fallbackEffectiveDatePaths": [
                 "capturedAt",
                 "snapshot.capturedAt",
@@ -1822,7 +1822,7 @@
         "entity": "topology-subnets",
         "title": "Topology Subnet Detail",
         "identity": {
-          "idField": "identity.recordId"
+          "idField": "recordId"
         },
         "contentTypes": [
           {
@@ -1830,7 +1830,7 @@
             "required": true,
             "multiMatch": {
               "strategy": "last",
-              "effectiveDatePath": "lifecycle.capturedAt",
+              "effectiveDatePath": "data.lastSeen",
               "fallbackEffectiveDatePaths": [
                 "capturedAt",
                 "snapshot.capturedAt"
@@ -1875,7 +1875,7 @@
         "entity": "vulnerabilities",
         "title": "Vulnerability Detail",
         "identity": {
-          "idField": "identity.recordId"
+          "idField": "recordId"
         },
         "contentTypes": [
           {
@@ -1883,7 +1883,7 @@
             "required": true,
             "multiMatch": {
               "strategy": "last",
-              "effectiveDatePath": "lifecycle.capturedAt",
+              "effectiveDatePath": "data.lastSeen",
               "fallbackEffectiveDatePaths": [
                 "capturedAt",
                 "snapshot.capturedAt",

package/dist/client/catalox-mongo-bootstrap.d.ts

@@ -0,0 +1,13 @@
+import type { Catalox } from "@x12i/catalox";
+import { MongoStore } from "@x12i/catalox/mongo";
+export type CreateMemorixCataloxFromEnvOptions = {
+    processEnv?: NodeJS.ProcessEnv;
+    dbName?: string;
+    mongoUri?: string;
+};
+export type CreateMemorixCataloxFromEnvResult = {
+    catalox: Catalox;
+    mongoStore: MongoStore;
+};
+export declare function createMemorixCataloxFromEnv(options?: CreateMemorixCataloxFromEnvOptions): Promise<CreateMemorixCataloxFromEnvResult>;
+//# sourceMappingURL=catalox-mongo-bootstrap.d.ts.map

package/dist/client/catalox-mongo-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-mongo-bootstrap.d.ts","sourceRoot":"","sources":["../../src/client/catalox-mongo-bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAA6B,MAAM,qBAAqB,CAAC;AAK5E,MAAM,MAAM,kCAAkC,GAAG;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAqBF,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,iCAAiC,CAAC,CAO5C"}

package/dist/client/catalox-mongo-bootstrap.js

@@ -0,0 +1,22 @@
+import { createRequire } from "node:module";
+import { MongoStore, wireCataloxFromMongoStore } from "@x12i/catalox/mongo";
+import { resolveMemorixCataloxDbName, resolveMongoUri } from "../mongo/env.js";
+const require = createRequire(import.meta.url);
+async function initMongoStore(options) {
+    const { initMongoDb } = require("@x12i/helpers/mongo");
+    const api = await initMongoDb({
+        mongoUri: options.mongoUri,
+        dbName: options.dbName,
+        singleton: false,
+    });
+    return new MongoStore(api);
+}
+export async function createMemorixCataloxFromEnv(options = {}) {
+    const env = options.processEnv ?? process.env;
+    const mongoUri = options.mongoUri ?? resolveMongoUri(env);
+    const dbName = options.dbName ?? resolveMemorixCataloxDbName(env);
+    const mongoStore = await initMongoStore({ mongoUri, dbName });
+    const catalox = wireCataloxFromMongoStore({ mongo: mongoStore, mongoUri });
+    return { catalox, mongoStore };
+}
+//# sourceMappingURL=catalox-mongo-bootstrap.js.map

package/dist/client/catalox-mongo-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-mongo-bootstrap.js","sourceRoot":"","sources":["../../src/client/catalox-mongo-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE/E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAa/C,KAAK,UAAU,cAAc,CAAC,OAG7B;IACC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,qBAAqB,CAMpD,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IACH,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAA8C,EAAE;IAEhD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,2BAA2B,CAAC,GAAG,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,yBAAyB,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC"}

package/dist/client/create-stack-from-env.d.ts

@@ -17,7 +17,8 @@ export type CreateMemorixRetrievalStackFromEnvOptions = MemorixRetrievalLoggingO
     processEnv?: NodeJS.ProcessEnv;
 };
 /**
- * One-shot wiring: Catalox from env → bound context → adapter → retrieval client.
+ * One-shot wiring: Mongo Catalox from env → bound context → adapter → retrieval client.
+ * Catalox metadata lives in `MEMORIX_CATALOX_DB` (default `memorix-catalox`) on `MONGO_URI`.
  * Use this in host apps (e.g. memorix-explorer API) to avoid duplicating Catalox setup.
  */
 export declare function createMemorixRetrievalStackFromEnv(options?: CreateMemorixRetrievalStackFromEnvOptions): Promise<MemorixRetrievalStack>;

package/dist/client/create-stack-from-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-stack-from-env.d.ts","sourceRoot":"","sources":["../../src/client/create-stack-from-env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIlE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EACtB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,yCAAyC,GACnD,8BAA8B,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAEJ;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,GAAE,yCAA8C,GACtD,OAAO,CAAC,qBAAqB,CAAC,CAuChC"}
+{"version":3,"file":"create-stack-from-env.d.ts","sourceRoot":"","sources":["../../src/client/create-stack-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKlE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EACtB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,2FAA2F;IAC3F,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,yCAAyC,GACnD,8BAA8B,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAEJ;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,GAAE,yCAA8C,GACtD,OAAO,CAAC,qBAAqB,CAAC,CAuChC"}

package/dist/client/create-stack-from-env.js

@@ -1,11 +1,12 @@
-import { createCataloxFromEnv } from "@x12i/catalox";
+import { createMemorixCataloxFromEnv } from "./catalox-mongo-bootstrap.js";
 import { DebugLogAbstract } from "@x12i/logxer";
 import { resolveMemorixAppId } from "../descriptors/resolve-app-id.js";
 import { memorixRetrievalLogger } from "../logging/logger.js";
 import { createCataloxAdapterFromBound } from "./catalox-adapter.js";
 import { createMemorixRetrievalFromEnv } from "./create-from-env.js";
 /**
- * One-shot wiring: Catalox from env → bound context → adapter → retrieval client.
+ * One-shot wiring: Mongo Catalox from env → bound context → adapter → retrieval client.
+ * Catalox metadata lives in `MEMORIX_CATALOX_DB` (default `memorix-catalox`) on `MONGO_URI`.
  * Use this in host apps (e.g. memorix-explorer API) to avoid duplicating Catalox setup.
  */
 export async function createMemorixRetrievalStackFromEnv(options = {}) {
@@ -13,7 +14,7 @@ export async function createMemorixRetrievalStackFromEnv(options = {}) {
     const appId = resolveMemorixAppId({
         appId: options.appId?.trim() || options.cataloxContext?.appId?.trim(),
     }, processEnv);
-    const { catalox } = createCataloxFromEnv();
+    const { catalox } = await createMemorixCataloxFromEnv({ processEnv });
     const ctx = {
         ...(options.cataloxContext ?? {}),
         appId,

package/dist/client/create-stack-from-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-stack-from-env.js","sourceRoot":"","sources":["../../src/client/create-stack-from-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAuBrE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,UAAqD,EAAE;IAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAErD,MAAM,KAAK,GAAG,mBAAmB,CAC/B;QACE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE;KACtE,EACD,UAAU,CACX,CAAC;IAEF,MAAM,EAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAmB;QAC1B,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;QACjC,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,IAAI;YACtC,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,mBAAmB;SACxB;KACF,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC;QACjD,KAAK;QACL,OAAO,EAAE,cAAc;QACvB,UAAU;KACX,CAAC,CAAC;IAEH,sBAAsB,CAAC,IAAI,CAAC,qCAAqC,EAAE;QACjE,KAAK;QACL,SAAS,EAAE,gBAAgB,CAAC,KAAK;KAClC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,YAAY;QACZ,OAAO,EAAE,cAAc;QACvB,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-stack-from-env.js","sourceRoot":"","sources":["../../src/client/create-stack-from-env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAuBrE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,UAAqD,EAAE;IAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAErD,MAAM,KAAK,GAAG,mBAAmB,CAC/B;QACE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE;KACtE,EACD,UAAU,CACX,CAAC;IAEF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,2BAA2B,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACtE,MAAM,GAAG,GAAmB;QAC1B,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;QACjC,KAAK;QACL,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,IAAI;YACtC,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,mBAAmB;SACxB;KACF,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,cAAc,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC;QACjD,KAAK;QACL,OAAO,EAAE,cAAc;QACvB,UAAU;KACX,CAAC,CAAC;IAEH,sBAAsB,CAAC,IAAI,CAAC,qCAAqC,EAAE;QACjE,KAAK;QACL,SAAS,EAAE,gBAAgB,CAAC,KAAK;KAClC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,YAAY;QACZ,OAAO,EAAE,cAAc;QACvB,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/dist/client/types.d.ts

@@ -1,6 +1,7 @@
 import type { MongoClient } from "mongodb";
 import type { createGcsClient } from "@x12i/helpers/gcs";
 import type { createS3Client } from "@x12i/helpers/s3";
+import type { MemorixConcept } from "@x12i/memorix-descriptors";
 import type { CataloxLike } from "./catalox-like.js";
 import type { XronoxLike } from "./xronox-like.js";
 import type { MemorixTarget } from "../mongo/types.js";
@@ -68,10 +69,10 @@ export type FetchMemorixListRequest = {
         limit?: number;
         offset?: number;
     };
-    sort?: {
+    sort?: Array<{
         property: string;
         direction: "asc" | "desc";
-    };
+    }>;
     filters?: Array<import("../descriptors/descriptor-types.js").MemorixFilterInput>;
     /** Graph-run planning filters on reserved `_graphRuns.<graphId>` paths (MRX-FRS-001). */
     graphRunFilter?: import("../retrieval/graph-run-filters.js").GraphRunFilterInput | import("../retrieval/graph-run-filters.js").GraphRunFilterInput[];
@@ -93,6 +94,7 @@ export type FetchMemorixListRequest = {
 export type MemorixRecordDisplayFields = {
     recordId?: string;
     displayName?: string;
+    concept?: MemorixConcept;
 };
 export type FetchMemorixListResponse = {
     listId: string;
@@ -105,11 +107,11 @@ export type FetchMemorixListResponse = {
         hasMore: boolean;
         total?: number;
     };
-    sort?: {
+    sort?: Array<{
         property: string;
         direction: "asc" | "desc";
         contentType: string;
-    };
+    }>;
     rows: Array<Record<string, unknown> & MemorixRecordDisplayFields>;
     issues?: import("../errors/issues.js").MemorixRetrievalIssue[];
     source?: import("../runtime/source-provenance.js").MemorixRuntimeSourceRef;
@@ -132,10 +134,10 @@ export type FetchMemorixWorkspaceListRequest = {
         limit?: number;
         offset?: number;
     };
-    sort?: {
+    sort?: Array<{
         property: string;
         direction: "asc" | "desc";
-    };
+    }>;
     filters?: Array<import("../descriptors/descriptor-types.js").MemorixFilterInput>;
     /** Graph-run planning filters on reserved `_graphRuns.<graphId>` paths (MRX-FRS-001). */
     graphRunFilter?: import("../retrieval/graph-run-filters.js").GraphRunFilterInput | import("../retrieval/graph-run-filters.js").GraphRunFilterInput[];
@@ -159,11 +161,11 @@ export type FetchMemorixWorkspaceListResponse = {
         hasMore: boolean;
         total?: number;
     };
-    sort?: {
+    sort?: Array<{
         property: string;
         direction: "asc" | "desc";
         contentType?: string;
-    };
+    }>;
     issues?: import("../errors/issues.js").MemorixRetrievalIssue[];
     includedEntities: string[];
     discovery: {
@@ -196,6 +198,7 @@ export type FetchMemorixItemResponse = {
     eventId?: string;
     knowledgeId?: string;
     displayName?: string;
+    concept?: MemorixConcept;
     sections: Array<{
         id: string;
         title: string;