@x12i/memorix-retrieval 1.11.2 → 1.13.0

package/README.md

@@ -113,6 +113,34 @@ Legacy Catalox catalogs (`memorix-entities`, `memorix_entity_content_types`, `kn
 
 Both lenses use the same `MemorixUnifiedInventory` shape.
 
+## Graph-run filters (`_graphRuns`) — MRX-FRS-001
+
+Planning queries for Exellix jobs over reserved `_graphRuns.<graphId>` paths:
+
+```typescript
+import {
+  fetchMemorixListForEntity,
+  compileGraphRunFilter,
+} from "@x12i/memorix-retrieval";
+
+const list = await fetchMemorixListForEntity(client, {
+  entityName: "assets",
+  graphRunFilter: { graphRunNotDone: { graphId: "graph-qcrbz6t" } },
+  includeGraphRuns: true, // optional; default false on lists
+  page: { limit: 100, offset: 0 },
+});
+```
+
+| Facet | Use case |
+|-------|----------|
+| `graphRunNotDone` | Records needing processing |
+| `graphRunStatus` | Filter by `in_progress` / `done` / `failed` |
+| `graphRunCompletedBefore` | Stale results |
+| `graphRunFailed` | Retry candidates |
+| `graphRunStaleVersion` | Graph version invalidation |
+
+Item reads include `_graphRuns` by default (`includeGraphRuns` defaults to true). Writer APIs: `@x12i/memorix-writer` — see [memorix-writer/docs/GRAPH-RUNS.md](../memorix-writer/docs/GRAPH-RUNS.md).
+
 ## Last-dash collection parsing
 
 Collection names follow `<objectName>-<contentType>` where the **last** dash is the separator (object names may contain dashes):

package/catalox-seeds/inputs/entity-descriptors/knowledge-playbooks.json

@@ -0,0 +1,49 @@
+{
+  "id": "knowledge-playbooks",
+  "entityName": "knowledge-playbooks",
+  "defaultListDescriptorId": "knowledge-playbooks-main-list",
+  "defaultItemDescriptorId": "knowledge-playbook-detail-item",
+  "target": "knowledge",
+  "collectionPrefix": "knowledge-playbooks",
+  "identity": {
+    "allowedIdFields": ["knowledgeId"],
+    "requiredExactlyOne": true,
+    "defaultIdField": "knowledgeId"
+  },
+  "defaults": {
+    "canonicalContentType": "snapshots",
+    "dataRoot": "data",
+    "effectiveDatePath": "capturedAt"
+  },
+  "contentTypes": {
+    "snapshots": {
+      "postfix": "snapshots",
+      "collection": "knowledge-playbooks-snapshots",
+      "dataRoot": "data",
+      "isCanonical": true,
+      "effectiveDatePath": "capturedAt"
+    }
+  },
+  "properties": {
+    "title": {
+      "label": "Title",
+      "source": { "contentType": "snapshots", "path": "data.title" },
+      "humanReadable": true,
+      "sortable": true,
+      "filterable": true,
+      "list": true,
+      "item": true,
+      "valueType": "string"
+    },
+    "summary": {
+      "label": "Summary",
+      "source": { "contentType": "snapshots", "path": "data.summary" },
+      "humanReadable": true,
+      "sortable": false,
+      "filterable": false,
+      "list": true,
+      "item": true,
+      "valueType": "string"
+    }
+  }
+}

package/catalox-seeds/inputs/item-descriptors/knowledge-playbook-detail-item.json

@@ -0,0 +1,25 @@
+{
+  "id": "knowledge-playbook-detail-item",
+  "entity": "knowledge-playbooks",
+  "title": "Knowledge Playbook Detail",
+  "identity": {
+    "idField": "knowledgeId"
+  },
+  "contentTypes": [
+    {
+      "contentType": "snapshots",
+      "required": true,
+      "multiMatch": {
+        "strategy": "last",
+        "effectiveDatePath": "capturedAt"
+      }
+    }
+  ],
+  "sections": [
+    {
+      "id": "summary",
+      "title": "Summary",
+      "fields": ["title", "summary"]
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "filter": {
+    "mode": "basic",
+    "combinator": "and",
+    "rules": []
+  },
+  "schemaVersion": "memorix.listDescriptor.v2",
+  "pagination": {
+    "maxLimit": 200,
+    "defaultLimit": 50,
+    "enabled": true
+  },
+  "kind": "slice",
+  "id": "critical-vulnerabilities-slice",
+  "sort": [
+    {
+      "direction": "desc",
+      "path": "capturedAt"
+    }
+  ],
+  "fields": [
+    "recordId"
+  ],
+  "title": "Critical vulnerabilities",
+  "contentType": "snapshots",
+  "defaultItemDescriptorId": "vulnerability-detail-item",
+  "objectType": "vulnerabilities",
+  "entityName": "vulnerabilities",
+  "target": "event"
+}

package/catalox-seeds/inputs/list-descriptors/knowledge-playbooks-main-list.json

@@ -0,0 +1,17 @@
+{
+  "id": "knowledge-playbooks-main-list",
+  "entity": "knowledge-playbooks",
+  "title": "Knowledge Playbooks",
+  "leadingContentType": "snapshots",
+  "pagination": {
+    "enabled": true,
+    "defaultLimit": 50,
+    "maxLimit": 200
+  },
+  "filters": [],
+  "fields": ["title", "summary"],
+  "extensions": [],
+  "includeRelations": [],
+  "allowedSorts": ["title"],
+  "defaultSort": { "field": "title", "direction": "asc" }
+}

package/catalox-seeds/inputs/manifest.json

@@ -3,7 +3,7 @@
   "sourceFile": "Pasted text(100).txt",
   "appId": "memorix",
   "catalogs": {
-    "memorix-entity-descriptors": [
+    "memorix-object-type-descriptors": [
       "assets",
       "vulnerabilities",
       "variabilities-groups"
@@ -35,8 +35,8 @@
     "list-descriptors/memorix-workspace-records-list.json",
     "memorix-catalog-ids.json",
     "memorix-descriptors.bundle.json",
-    "memorix-entity-descriptors.catalog.json",
-    "memorix-entity-descriptors.items.json",
+    "memorix-object-type-descriptors.catalog.json",
+    "memorix-object-type-descriptors.items.json",
     "memorix-item-descriptors.catalog.json",
     "memorix-item-descriptors.items.json",
     "memorix-list-descriptors.catalog.json",

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

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

package/catalox-seeds/inputs/memorix-descriptors.bundle.json

@@ -2,7 +2,7 @@
   "appId": "memorix",
   "catalogs": {
     "entityDescriptors": {
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "items": [
         {
           "id": "assets",

package/catalox-seeds/inputs/{memorix-entity-descriptors.catalog.json → memorix-object-type-descriptors.catalog.json}

@@ -1,5 +1,5 @@
 {
-  "catalogId": "memorix-entity-descriptors",
+  "catalogId": "memorix-object-type-descriptors",
   "items": [
     {
       "id": "assets",

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

@@ -5,7 +5,7 @@
   "description": "Entity, list, and item descriptors for @x12i/memorix-retrieval (from catalox-seeds/inputs/). assets and variabilities-groups target memorix-entities; vulnerabilities target memorix-events. All items share scope.domains/network+vulnerabilities and scope.agents/neo.",
   "catalogs": [
     {
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "name": "Memorix entity descriptors",
       "catalogType": "memorix",
       "sourceMode": "native",
@@ -37,11 +37,11 @@
   ],
   "descriptors": [
     {
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "descriptorVersion": "1",
       "mode": "replace",
       "descriptor": {
-        "catalogId": "memorix-entity-descriptors",
+        "catalogId": "memorix-object-type-descriptors",
         "label": "Memorix entity descriptors",
         "sourceMode": "native",
         "status": "active",
@@ -211,7 +211,7 @@
   "bindings": [
     {
       "appId": "memorix",
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "access": {
         "canRead": true,
         "canWrite": true
@@ -236,7 +236,7 @@
   ],
   "items": [
     {
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "scope": {
         "domains": [
           "network",
@@ -546,7 +546,7 @@
       }
     },
     {
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "scope": {
         "domains": [
           "network",
@@ -872,7 +872,7 @@
       }
     },
     {
-      "catalogId": "memorix-entity-descriptors",
+      "catalogId": "memorix-object-type-descriptors",
       "scope": {
         "domains": [
           "network",

package/dist/client/types.d.ts

@@ -66,6 +66,10 @@ export type FetchMemorixListRequest = {
         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[];
+    /** Include reserved `_graphRuns` on list rows (default: false). */
+    includeGraphRuns?: boolean;
     /** Case-insensitive match across human-readable list fields on the driver content type. */
     searchText?: string;
     includeTotal?: boolean;
@@ -116,6 +120,10 @@ export type FetchMemorixWorkspaceListRequest = {
         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[];
+    /** Include reserved `_graphRuns` on list rows (default: false). */
+    includeGraphRuns?: boolean;
     searchText?: string;
     includeTotal?: boolean;
     includeExtensions?: string[];
@@ -158,6 +166,8 @@ export type FetchMemorixItemRequest = {
     };
     includeRelations?: string[];
     includeSourceRefs?: boolean;
+    /** Include reserved `_graphRuns` on item response (default: true). */
+    includeGraphRuns?: boolean;
 };
 export type FetchMemorixItemResponse = {
     itemDescriptorId: string;
@@ -172,6 +182,8 @@ export type FetchMemorixItemResponse = {
         fields: Record<string, unknown>;
     }>;
     relations?: Record<string, unknown>;
+    /** Reserved system field when `includeGraphRuns` is enabled. */
+    _graphRuns?: import("@x12i/memorix-descriptors/types").GraphRunsField;
     issues?: import("../errors/issues.js").MemorixRetrievalIssue[];
     source?: import("../runtime/source-provenance.js").MemorixRuntimeSourceRef;
     sources?: import("../runtime/source-provenance.js").MemorixRuntimeSourceRef[];

package/dist/client/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}

package/dist/descriptors/catalog-ids.d.ts

@@ -1,5 +1,10 @@
 export declare const MEMORIX_APP_ID = "memorix";
-export declare const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export declare const MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG = "memorix-object-type-descriptors";
+export declare const MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
 export declare const MEMORIX_LIST_DESCRIPTORS_CATALOG = "memorix-list-descriptors";
 export declare const MEMORIX_ITEM_DESCRIPTORS_CATALOG = "memorix-item-descriptors";
+/** @deprecated Use MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG */
+export declare const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export declare function resolveEntityDescriptorCatalogId(processEnv?: NodeJS.ProcessEnv): string;
+export declare function isLegacyEntityDescriptorCatalogId(catalogId: string): boolean;
 //# sourceMappingURL=catalog-ids.d.ts.map

package/dist/descriptors/catalog-ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-ids.d.ts","sourceRoot":"","sources":["../../src/descriptors/catalog-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAC/E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAC3E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC"}
+{"version":3,"file":"catalog-ids.d.ts","sourceRoot":"","sources":["../../src/descriptors/catalog-ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,uCAAuC,oCAAoC,CAAC;AACzF,eAAO,MAAM,yCAAyC,+BAA+B,CAAC;AACtF,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAC3E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAE3E,8DAA8D;AAC9D,eAAO,MAAM,kCAAkC,+BAA4C,CAAC;AAE5F,wBAAgB,gCAAgC,CAC9C,UAAU,GAAE,MAAM,CAAC,UAAwB,GAC1C,MAAM,CAKR;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE5E"}

package/dist/descriptors/catalog-ids.js

@@ -1,5 +1,17 @@
 export const MEMORIX_APP_ID = "memorix";
-export const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export const MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG = "memorix-object-type-descriptors";
+export const MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
 export const MEMORIX_LIST_DESCRIPTORS_CATALOG = "memorix-list-descriptors";
 export const MEMORIX_ITEM_DESCRIPTORS_CATALOG = "memorix-item-descriptors";
+/** @deprecated Use MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG */
+export const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG;
+export function resolveEntityDescriptorCatalogId(processEnv = process.env) {
+    if (processEnv.MEMORIX_DESCRIPTOR_CATALOG_COMPAT === "legacy") {
+        return MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG;
+    }
+    return MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG;
+}
+export function isLegacyEntityDescriptorCatalogId(catalogId) {
+    return catalogId === MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG;
+}
 //# sourceMappingURL=catalog-ids.js.map

package/dist/descriptors/catalog-ids.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-ids.js","sourceRoot":"","sources":["../../src/descriptors/catalog-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,kCAAkC,GAAG,4BAA4B,CAAC;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC"}
+{"version":3,"file":"catalog-ids.js","sourceRoot":"","sources":["../../src/descriptors/catalog-ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,uCAAuC,GAAG,iCAAiC,CAAC;AACzF,MAAM,CAAC,MAAM,yCAAyC,GAAG,4BAA4B,CAAC;AACtF,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC;AAE3E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kCAAkC,GAAG,yCAAyC,CAAC;AAE5F,MAAM,UAAU,gCAAgC,CAC9C,aAAgC,OAAO,CAAC,GAAG;IAE3C,IAAI,UAAU,CAAC,iCAAiC,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO,yCAAyC,CAAC;IACnD,CAAC;IACD,OAAO,uCAAuC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,SAAiB;IACjE,OAAO,SAAS,KAAK,yCAAyC,CAAC;AACjE,CAAC"}

package/dist/descriptors/discover-entities.d.ts

@@ -1,6 +1,5 @@
 import type { MemorixRetrievalClient } from "../client/types.js";
 import type { MemorixEntityDescriptor } from "./descriptor-types.js";
-import { validateMemorixEntityDescriptor } from "./validate-descriptor.js";
 export type MemorixEntityDescriptorSummary = {
     id: string;
     entityName: string;
@@ -14,6 +13,7 @@ export type DiscoverMemorixEntitiesResult = {
     source: "catalox" | "none";
     catalogId: string;
     hint?: string;
+    catalogFallback?: "legacy-catalog-fallback";
 };
 export declare function discoverMemorixEntities(client: MemorixRetrievalClient): Promise<DiscoverMemorixEntitiesResult>;
 export declare function loadMemorixEntityDescriptorByName(client: MemorixRetrievalClient, entityName: string): Promise<MemorixEntityDescriptor>;
@@ -24,5 +24,5 @@ export declare function entityDescriptorConnections(entity: MemorixEntityDescrip
     sourceProperty: string;
     targetProperty: string;
 }>;
-export { validateMemorixEntityDescriptor };
+export { validateMemorixEntityDescriptor } from "./validate-descriptor.js";
 //# sourceMappingURL=discover-entities.d.ts.map

package/dist/descriptors/discover-entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-entities.d.ts","sourceRoot":"","sources":["../../src/descriptors/discover-entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAKjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAEL,+BAA+B,EAChC,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,8BAA8B,EAAE,CAAC;IAC5C,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAmCF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,6BAA6B,CAAC,CAoCxC;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAalC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,uBAAuB,GAC9B,KAAK,CAAC;IACP,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAkBD;AAED,OAAO,EAAE,+BAA+B,EAAE,CAAC"}
+{"version":3,"file":"discover-entities.d.ts","sourceRoot":"","sources":["../../src/descriptors/discover-entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAOrE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,8BAA8B,EAAE,CAAC;IAC5C,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C,CAAC;AAQF,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,6BAA6B,CAAC,CAmDxC;AAED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAclC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,uBAAuB,GAC9B,KAAK,CAAC;IACP,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC,CAkBD;AAED,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/descriptors/discover-entities.js

@@ -1,5 +1,4 @@
-import { throwRetrievalError } from "../errors/errors.js";
-import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, } from "./catalog-ids.js";
+import { listEntityDescriptorCatalogItems } from "./entity-catalog-loader.js";
 import { parseDescriptorData, validateMemorixEntityDescriptor, } from "./validate-descriptor.js";
 function entityLabel(entityName, title) {
     if (title?.trim())
@@ -8,32 +7,10 @@ function entityLabel(entityName, title) {
         return entityName;
     return entityName[0].toUpperCase() + entityName.slice(1).replace(/-/g, " ");
 }
-async function listAllCatalogItems(client, catalogId) {
-    const listFn = client.catalox.listCatalogItems;
-    if (!listFn) {
-        throwRetrievalError("CATALOX_LIST_UNSUPPORTED", "Catalox client must support listCatalogItems (use createCataloxAdapterFromBound)");
-    }
-    const out = [];
-    let offset = 0;
-    const pageSize = 200;
-    for (;;) {
-        const page = await listFn({ appId: client.appId }, catalogId, {
-            limit: pageSize,
-            offset,
-        });
-        out.push(...page.items);
-        if (!page.hasMore || page.items.length === 0)
-            break;
-        offset += page.items.length;
-        if (offset > 10_000)
-            break;
-    }
-    return out;
-}
 export async function discoverMemorixEntities(client) {
-    const catalogId = MEMORIX_ENTITY_DESCRIPTORS_CATALOG;
     try {
-        const items = await listAllCatalogItems(client, catalogId);
+        const listed = await listEntityDescriptorCatalogItems(client);
+        const { catalogId, items, catalogFallback } = listed;
         const summaries = [];
         for (const item of items) {
             const data = parseDescriptorData(item.data);
@@ -47,17 +24,29 @@ export async function discoverMemorixEntities(client) {
                 target: entity.target,
             });
         }
+        const fallbackHint = catalogFallback === "legacy-catalog-fallback"
+            ? `Entity descriptors loaded from legacy catalog "${catalogId}" because canonical catalog is empty. Migrate to memorix-object-type-descriptors.`
+            : undefined;
         if (summaries.length === 0) {
             return {
                 source: "none",
                 catalogId,
                 summaries: [],
                 hint: `No entity descriptors in Catalox catalog "${catalogId}" for app ${client.appId}. Run memorix-retrieval catalox seed apply.`,
+                ...(catalogFallback ? { catalogFallback } : {}),
             };
         }
-        return { source: "catalox", catalogId, summaries };
+        return {
+            source: "catalox",
+            catalogId,
+            summaries,
+            ...(fallbackHint ? { hint: fallbackHint, catalogFallback } : {}),
+        };
     }
     catch (e) {
+        const catalogId = client.processEnv?.MEMORIX_DESCRIPTOR_CATALOG_COMPAT === "legacy"
+            ? "memorix-entity-descriptors"
+            : "memorix-object-type-descriptors";
         const msg = e instanceof Error ? e.message : String(e);
         return {
             source: "none",
@@ -72,6 +61,7 @@ export async function loadMemorixEntityDescriptorByName(client, entityName) {
     const match = discovery.summaries.find((s) => s.entityName === entityName) ??
         discovery.summaries.find((s) => s.id === entityName);
     if (!match) {
+        const { throwRetrievalError } = await import("../errors/errors.js");
         throwRetrievalError("UNKNOWN_ENTITY_DESCRIPTOR", `No entity descriptor for "${entityName}"`);
     }
     const { loadMemorixEntityDescriptor } = await import("./load-entity-descriptor.js");
@@ -90,5 +80,5 @@ export function entityDescriptorConnections(entity) {
     }
     return connections;
 }
-export { validateMemorixEntityDescriptor };
+export { validateMemorixEntityDescriptor } from "./validate-descriptor.js";
 //# sourceMappingURL=discover-entities.js.map

package/dist/descriptors/discover-entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"discover-entities.js","sourceRoot":"","sources":["../../src/descriptors/discover-entities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"discover-entities.js","sourceRoot":"","sources":["../../src/descriptors/discover-entities.ts"],"names":[],"mappings":"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"}

package/dist/descriptors/entity-catalog-loader.d.ts

@@ -0,0 +1,18 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixEntityDescriptor } from "./descriptor-types.js";
+export type EntityCatalogListResult = {
+    catalogId: string;
+    items: Array<{
+        id: string;
+        data: Record<string, unknown>;
+        title?: string;
+    }>;
+    catalogFallback?: "legacy-catalog-fallback";
+};
+export declare function listEntityDescriptorCatalogItems(client: MemorixRetrievalClient): Promise<EntityCatalogListResult>;
+export declare function loadEntityDescriptorFromCatalog(client: MemorixRetrievalClient, entityDescriptorId: string): Promise<{
+    entity: MemorixEntityDescriptor;
+    catalogId: string;
+    catalogFallback?: "legacy-catalog-fallback";
+}>;
+//# sourceMappingURL=entity-catalog-loader.d.ts.map

package/dist/descriptors/entity-catalog-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-catalog-loader.d.ts","sourceRoot":"","sources":["../../src/descriptors/entity-catalog-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAOjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMrE,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C,CAAC;AA6BF,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAkBlC;AAED,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,sBAAsB,EAC9B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC;IAAE,MAAM,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,yBAAyB,CAAA;CAAE,CAAC,CAkC9G"}

package/dist/descriptors/entity-catalog-loader.js

@@ -0,0 +1,64 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, resolveEntityDescriptorCatalogId, } from "./catalog-ids.js";
+import { parseDescriptorData, validateMemorixEntityDescriptor, } from "./validate-descriptor.js";
+async function listAllCatalogItems(client, catalogId) {
+    const listFn = client.catalox.listCatalogItems;
+    if (!listFn) {
+        throwRetrievalError("CATALOX_LIST_UNSUPPORTED", "Catalox client must support listCatalogItems (use createCataloxAdapterFromBound)");
+    }
+    const out = [];
+    let offset = 0;
+    const pageSize = 200;
+    for (;;) {
+        const page = await listFn({ appId: client.appId }, catalogId, {
+            limit: pageSize,
+            offset,
+        });
+        out.push(...page.items);
+        if (!page.hasMore || page.items.length === 0)
+            break;
+        offset += page.items.length;
+        if (offset > 10_000)
+            break;
+    }
+    return out;
+}
+export async function listEntityDescriptorCatalogItems(client) {
+    const primaryCatalogId = resolveEntityDescriptorCatalogId(client.processEnv);
+    const primaryItems = await listAllCatalogItems(client, primaryCatalogId);
+    if (primaryItems.length > 0 || primaryCatalogId === MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG) {
+        return { catalogId: primaryCatalogId, items: primaryItems };
+    }
+    const legacyItems = await listAllCatalogItems(client, MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG);
+    if (legacyItems.length > 0) {
+        return {
+            catalogId: MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG,
+            items: legacyItems,
+            catalogFallback: "legacy-catalog-fallback",
+        };
+    }
+    return { catalogId: primaryCatalogId, items: [] };
+}
+export async function loadEntityDescriptorFromCatalog(client, entityDescriptorId) {
+    const primaryCatalogId = resolveEntityDescriptorCatalogId(client.processEnv);
+    const catalogs = primaryCatalogId === MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG
+        ? [MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG]
+        : [MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, MEMORIX_LEGACY_ENTITY_DESCRIPTORS_CATALOG];
+    for (let i = 0; i < catalogs.length; i++) {
+        const catalogId = catalogs[i];
+        const result = await client.catalox.getCatalogItem({ appId: client.appId }, catalogId, entityDescriptorId);
+        if (result.outcome === "mapping_blocked") {
+            throwRetrievalError("DESCRIPTOR_MAPPING_BLOCKED", `Entity descriptor mapping blocked: ${entityDescriptorId}`);
+        }
+        if (result.outcome === "found") {
+            const data = parseDescriptorData(result.item.data);
+            return {
+                entity: validateMemorixEntityDescriptor(data),
+                catalogId,
+                ...(i > 0 ? { catalogFallback: "legacy-catalog-fallback" } : {}),
+            };
+        }
+    }
+    throwRetrievalError("UNKNOWN_ENTITY_DESCRIPTOR", `Unknown entity descriptor: ${entityDescriptorId}`);
+}
+//# sourceMappingURL=entity-catalog-loader.js.map

package/dist/descriptors/entity-catalog-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-catalog-loader.js","sourceRoot":"","sources":["../../src/descriptors/entity-catalog-loader.ts"],"names":[],"mappings":"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"}

package/dist/descriptors/load-entity-descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-entity-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/load-entity-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAMrE,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAoBlC"}
+{"version":3,"file":"load-entity-descriptor.d.ts","sourceRoot":"","sources":["../../src/descriptors/load-entity-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGrE,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,sBAAsB,EAC9B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAGlC"}