@x12i/memorix-retrieval 1.2.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (129) hide show
  1. package/README.md +64 -24
  2. package/catalox-seeds/inputs/entity-descriptors/assets.json +2 -0
  3. package/catalox-seeds/inputs/entity-descriptors/variabilities-groups.json +2 -0
  4. package/catalox-seeds/inputs/entity-descriptors/vulnerabilities.json +2 -0
  5. package/catalox-seeds/inputs/list-descriptors/memorix-workspace-records-list.json +22 -0
  6. package/catalox-seeds/inputs/manifest.json +3 -1
  7. package/catalox-seeds/inputs/memorix-list-descriptors.catalog.json +22 -0
  8. package/catalox-seeds/inputs/memorix-list-descriptors.items.json +22 -0
  9. package/catalox-seeds/memorix-retrieval-descriptors.manifest.json +40 -0
  10. package/dist/client/create-client.js +2 -2
  11. package/dist/client/create-client.js.map +1 -1
  12. package/dist/client/create-stack-from-env.js +4 -6
  13. package/dist/client/create-stack-from-env.js.map +1 -1
  14. package/dist/client/types.d.ts +48 -0
  15. package/dist/client/types.d.ts.map +1 -1
  16. package/dist/descriptors/descriptor-types.d.ts +35 -10
  17. package/dist/descriptors/descriptor-types.d.ts.map +1 -1
  18. package/dist/descriptors/discover-entities.d.ts +3 -1
  19. package/dist/descriptors/discover-entities.d.ts.map +1 -1
  20. package/dist/descriptors/discover-entities.js +14 -43
  21. package/dist/descriptors/discover-entities.js.map +1 -1
  22. package/dist/descriptors/load-list-descriptor.d.ts +5 -1
  23. package/dist/descriptors/load-list-descriptor.d.ts.map +1 -1
  24. package/dist/descriptors/load-list-descriptor.js +23 -3
  25. package/dist/descriptors/load-list-descriptor.js.map +1 -1
  26. package/dist/descriptors/resolve-app-id.d.ts +4 -0
  27. package/dist/descriptors/resolve-app-id.d.ts.map +1 -0
  28. package/dist/descriptors/resolve-app-id.js +8 -0
  29. package/dist/descriptors/resolve-app-id.js.map +1 -0
  30. package/dist/descriptors/resolve-default-descriptors.d.ts +11 -0
  31. package/dist/descriptors/resolve-default-descriptors.d.ts.map +1 -0
  32. package/dist/descriptors/resolve-default-descriptors.js +22 -0
  33. package/dist/descriptors/resolve-default-descriptors.js.map +1 -0
  34. package/dist/descriptors/validate-descriptor.d.ts +6 -2
  35. package/dist/descriptors/validate-descriptor.d.ts.map +1 -1
  36. package/dist/descriptors/validate-descriptor.js +42 -5
  37. package/dist/descriptors/validate-descriptor.js.map +1 -1
  38. package/dist/explorer/entity-graph.d.ts +3 -1
  39. package/dist/explorer/entity-graph.d.ts.map +1 -1
  40. package/dist/explorer/entity-graph.js +4 -0
  41. package/dist/explorer/entity-graph.js.map +1 -1
  42. package/dist/index.d.ts +16 -6
  43. package/dist/index.d.ts.map +1 -1
  44. package/dist/index.js +13 -4
  45. package/dist/index.js.map +1 -1
  46. package/dist/retrieval/compose-row.d.ts +2 -2
  47. package/dist/retrieval/compose-row.d.ts.map +1 -1
  48. package/dist/retrieval/compose-row.js.map +1 -1
  49. package/dist/retrieval/fetch-for-entity.d.ts +18 -0
  50. package/dist/retrieval/fetch-for-entity.d.ts.map +1 -0
  51. package/dist/retrieval/fetch-for-entity.js +21 -0
  52. package/dist/retrieval/fetch-for-entity.js.map +1 -0
  53. package/dist/retrieval/fetch-list.d.ts.map +1 -1
  54. package/dist/retrieval/fetch-list.js +18 -3
  55. package/dist/retrieval/fetch-list.js.map +1 -1
  56. package/dist/retrieval/fetch-workspace-list.d.ts +4 -0
  57. package/dist/retrieval/fetch-workspace-list.d.ts.map +1 -0
  58. package/dist/retrieval/fetch-workspace-list.js +164 -0
  59. package/dist/retrieval/fetch-workspace-list.js.map +1 -0
  60. package/dist/retrieval/resolve-filters.d.ts +4 -2
  61. package/dist/retrieval/resolve-filters.d.ts.map +1 -1
  62. package/dist/retrieval/resolve-filters.js +24 -3
  63. package/dist/retrieval/resolve-filters.js.map +1 -1
  64. package/dist/retrieval/resolve-list-search.d.ts +6 -0
  65. package/dist/retrieval/resolve-list-search.d.ts.map +1 -0
  66. package/dist/retrieval/resolve-list-search.js +25 -0
  67. package/dist/retrieval/resolve-list-search.js.map +1 -0
  68. package/dist/retrieval/resolve-pagination-driver.d.ts +2 -2
  69. package/dist/retrieval/resolve-pagination-driver.d.ts.map +1 -1
  70. package/dist/retrieval/resolve-pagination-driver.js.map +1 -1
  71. package/dist/retrieval/resolve-sort.d.ts +2 -2
  72. package/dist/retrieval/resolve-sort.d.ts.map +1 -1
  73. package/dist/retrieval/resolve-sort.js.map +1 -1
  74. package/dist/seeds/build-manifest.d.ts +8 -0
  75. package/dist/seeds/build-manifest.d.ts.map +1 -0
  76. package/dist/seeds/build-manifest.js +83 -0
  77. package/dist/seeds/build-manifest.js.map +1 -0
  78. package/dist/seeds/check-needs-seed.d.ts +10 -0
  79. package/dist/seeds/check-needs-seed.d.ts.map +1 -0
  80. package/dist/seeds/check-needs-seed.js +66 -0
  81. package/dist/seeds/check-needs-seed.js.map +1 -0
  82. package/dist/seeds/default-seed-spec.d.ts +12 -0
  83. package/dist/seeds/default-seed-spec.d.ts.map +1 -0
  84. package/dist/seeds/default-seed-spec.js +90 -0
  85. package/dist/seeds/default-seed-spec.js.map +1 -0
  86. package/dist/seeds/merge-for-apply.d.ts +28 -0
  87. package/dist/seeds/merge-for-apply.d.ts.map +1 -0
  88. package/dist/seeds/merge-for-apply.js +31 -0
  89. package/dist/seeds/merge-for-apply.js.map +1 -0
  90. package/dist/seeds/paths.d.ts +10 -0
  91. package/dist/seeds/paths.d.ts.map +1 -0
  92. package/dist/seeds/paths.js +40 -0
  93. package/dist/seeds/paths.js.map +1 -0
  94. package/dist/seeds/seed-types.d.ts +57 -0
  95. package/dist/seeds/seed-types.d.ts.map +1 -0
  96. package/dist/seeds/seed-types.js +2 -0
  97. package/dist/seeds/seed-types.js.map +1 -0
  98. package/dist/tests/descriptor-validation.test.js +15 -0
  99. package/dist/tests/descriptor-validation.test.js.map +1 -1
  100. package/dist/tests/fetch-workspace-list.test.d.ts +2 -0
  101. package/dist/tests/fetch-workspace-list.test.d.ts.map +1 -0
  102. package/dist/tests/fetch-workspace-list.test.js +187 -0
  103. package/dist/tests/fetch-workspace-list.test.js.map +1 -0
  104. package/dist/tests/fixtures.d.ts +5 -2
  105. package/dist/tests/fixtures.d.ts.map +1 -1
  106. package/dist/tests/fixtures.js +79 -0
  107. package/dist/tests/fixtures.js.map +1 -1
  108. package/dist/tests/relations.test.js +3 -0
  109. package/dist/tests/relations.test.js.map +1 -1
  110. package/dist/tests/resolve-app-id.test.d.ts +2 -0
  111. package/dist/tests/resolve-app-id.test.d.ts.map +1 -0
  112. package/dist/tests/resolve-app-id.test.js +19 -0
  113. package/dist/tests/resolve-app-id.test.js.map +1 -0
  114. package/dist/tests/resolve-filters.test.d.ts +2 -0
  115. package/dist/tests/resolve-filters.test.d.ts.map +1 -0
  116. package/dist/tests/resolve-filters.test.js +47 -0
  117. package/dist/tests/resolve-filters.test.js.map +1 -0
  118. package/dist/tests/seed-check.test.d.ts +2 -0
  119. package/dist/tests/seed-check.test.d.ts.map +1 -0
  120. package/dist/tests/seed-check.test.js +47 -0
  121. package/dist/tests/seed-check.test.js.map +1 -0
  122. package/dist/tests/seed-manifest.test.d.ts +2 -0
  123. package/dist/tests/seed-manifest.test.d.ts.map +1 -0
  124. package/dist/tests/seed-manifest.test.js +80 -0
  125. package/dist/tests/seed-manifest.test.js.map +1 -0
  126. package/docs/DATA-TIER-CONTRACT.md +141 -0
  127. package/docs/EXPLORER-HOST-APIS.md +19 -7
  128. package/docs/MEMORIX-CATALOX-CONTRACTS.md +587 -0
  129. package/package.json +5 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fetch-workspace-list.test.js","sourceRoot":"","sources":["../../src/tests/fetch-workspace-list.test.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,8 @@
1
- import type { MemorixEntityDescriptor, MemorixItemDescriptor, MemorixListDescriptor } from "../descriptors/descriptor-types.js";
1
+ import type { MemorixEntityDescriptor, MemorixEntityListDescriptor, MemorixItemDescriptor, MemorixWorkspaceListDescriptor } from "../descriptors/descriptor-types.js";
2
2
  export declare const assetsEntity: MemorixEntityDescriptor;
3
- export declare const assetsMainList: MemorixListDescriptor;
3
+ export declare const assetsMainList: MemorixEntityListDescriptor;
4
4
  export declare const assetDetailItem: MemorixItemDescriptor;
5
+ export declare const vulnerabilitiesEntity: MemorixEntityDescriptor;
6
+ export declare const vulnerabilitiesMainList: MemorixEntityListDescriptor;
7
+ export declare const workspaceRecordsList: MemorixWorkspaceListDescriptor;
5
8
  //# sourceMappingURL=fixtures.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/tests/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,uBAuF1B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,qBAmB5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,qBA2B7B,CAAC"}
1
+ {"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/tests/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,8BAA8B,EAC/B,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,YAAY,EAAE,uBAyF1B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,2BAmB5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,qBA2B7B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,uBA0DnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,2BASrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,8BAOlC,CAAC"}
@@ -1,6 +1,8 @@
1
1
  export const assetsEntity = {
2
2
  id: "assets",
3
3
  entityName: "assets",
4
+ defaultListDescriptorId: "assets-main-list",
5
+ defaultItemDescriptorId: "asset-detail-item",
4
6
  target: "entity",
5
7
  collectionPrefix: "assets",
6
8
  identity: {
@@ -134,4 +136,81 @@ export const assetDetailItem = {
134
136
  maxBytes: 5242880,
135
137
  },
136
138
  };
139
+ export const vulnerabilitiesEntity = {
140
+ id: "vulnerabilities",
141
+ entityName: "vulnerabilities",
142
+ defaultListDescriptorId: "vulnerabilities-main-list",
143
+ defaultItemDescriptorId: "vulnerability-detail-item",
144
+ target: "event",
145
+ collectionPrefix: "vulnerabilities",
146
+ identity: {
147
+ allowedIdFields: ["entityId", "eventId"],
148
+ requiredExactlyOne: true,
149
+ defaultIdField: "entityId",
150
+ },
151
+ defaults: {
152
+ canonicalContentType: "snapshots",
153
+ dataRoot: "data",
154
+ effectiveDatePath: "modifiedAt",
155
+ fallbackEffectiveDatePaths: ["capturedAt"],
156
+ },
157
+ contentTypes: {
158
+ snapshots: {
159
+ postfix: "snapshots",
160
+ collection: "vulnerabilities-snapshots",
161
+ dataRoot: "data",
162
+ isCanonical: true,
163
+ },
164
+ },
165
+ properties: {
166
+ vulnerabilityId: {
167
+ label: "Vulnerability ID",
168
+ source: { contentType: "snapshots", path: "data.vulnerabilityId" },
169
+ humanReadable: true,
170
+ sortable: true,
171
+ filterable: true,
172
+ list: true,
173
+ item: true,
174
+ valueType: "string",
175
+ },
176
+ pluginName: {
177
+ label: "Plugin Name",
178
+ source: { contentType: "snapshots", path: "data.pluginName" },
179
+ humanReadable: true,
180
+ sortable: true,
181
+ filterable: true,
182
+ list: true,
183
+ item: true,
184
+ valueType: "string",
185
+ },
186
+ priorityScore: {
187
+ label: "Priority Score",
188
+ source: { contentType: "snapshots", path: "data.priorityScore" },
189
+ humanReadable: true,
190
+ sortable: true,
191
+ filterable: true,
192
+ list: true,
193
+ item: true,
194
+ valueType: "number",
195
+ },
196
+ },
197
+ };
198
+ export const vulnerabilitiesMainList = {
199
+ id: "vulnerabilities-main-list",
200
+ entity: "vulnerabilities",
201
+ title: "Vulnerabilities",
202
+ leadingContentType: "snapshots",
203
+ pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
204
+ fields: ["vulnerabilityId", "pluginName", "priorityScore"],
205
+ allowedSorts: ["vulnerabilityId", "pluginName", "priorityScore"],
206
+ defaultSort: { property: "priorityScore", direction: "desc" },
207
+ };
208
+ export const workspaceRecordsList = {
209
+ id: "memorix-workspace-records-list",
210
+ kind: "workspace",
211
+ title: "Workspace records",
212
+ fields: ["entityName", "recordTitle", "recordId", "source"],
213
+ pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
214
+ defaultSort: { property: "priorityScore", direction: "desc" },
215
+ };
137
216
  //# sourceMappingURL=fixtures.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/tests/fixtures.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/tests/fixtures.ts"],"names":[],"mappings":"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"}
@@ -26,12 +26,15 @@ describe("relations", () => {
26
26
  ...entityWithRelation,
27
27
  id: "users",
28
28
  entityName: "users",
29
+ defaultListDescriptorId: "users-main-list",
30
+ defaultItemDescriptorId: "user-detail-item",
29
31
  collectionPrefix: "users",
30
32
  contentTypes: {
31
33
  snapshots: {
32
34
  postfix: "snapshots",
33
35
  collection: "users-snapshots",
34
36
  dataRoot: "data",
37
+ isCanonical: true,
35
38
  },
36
39
  },
37
40
  properties: {},
@@ -1 +1 @@
1
- {"version":3,"file":"relations.test.js","sourceRoot":"","sources":["../../src/tests/relations.test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"relations.test.js","sourceRoot":"","sources":["../../src/tests/relations.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=resolve-app-id.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-app-id.test.d.ts","sourceRoot":"","sources":["../../src/tests/resolve-app-id.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,19 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { resolveMemorixAppId } from "../descriptors/resolve-app-id.js";
3
+ import { MEMORIX_APP_ID } from "../descriptors/catalog-ids.js";
4
+ describe("resolveMemorixAppId", () => {
5
+ it("prefers explicit option", () => {
6
+ expect(resolveMemorixAppId({ appId: "custom" }, {})).toBe("custom");
7
+ });
8
+ it("reads CATALOX_APP_ID then MEMORIX_APP_ID", () => {
9
+ expect(resolveMemorixAppId(undefined, {
10
+ CATALOX_APP_ID: "from-catalox",
11
+ MEMORIX_APP_ID: "from-memorix",
12
+ })).toBe("from-catalox");
13
+ expect(resolveMemorixAppId(undefined, { MEMORIX_APP_ID: "from-memorix" })).toBe("from-memorix");
14
+ });
15
+ it("defaults to memorix", () => {
16
+ expect(resolveMemorixAppId(undefined, {})).toBe(MEMORIX_APP_ID);
17
+ });
18
+ });
19
+ //# sourceMappingURL=resolve-app-id.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-app-id.test.js","sourceRoot":"","sources":["../../src/tests/resolve-app-id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CACJ,mBAAmB,CAAC,SAAS,EAAE;YAC7B,cAAc,EAAE,cAAc;YAC9B,cAAc,EAAE,cAAc;SAC/B,CAAC,CACH,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvB,MAAM,CACJ,mBAAmB,CAAC,SAAS,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CACnE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=resolve-filters.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-filters.test.d.ts","sourceRoot":"","sources":["../../src/tests/resolve-filters.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,47 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { mergeListDescriptorFilters, resolveMemorixFilters, } from "../retrieval/resolve-filters.js";
3
+ import { assetsEntity } from "./fixtures.js";
4
+ describe("resolveMemorixFilters", () => {
5
+ it("applies list descriptor default filters when request has none", () => {
6
+ const list = {
7
+ id: "filtered-assets-list",
8
+ entity: "assets",
9
+ leadingContentType: "snapshots",
10
+ pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
11
+ filters: [
12
+ { property: "ipAddress", operator: "eq", value: "10.0.0.1" },
13
+ ],
14
+ fields: ["ipAddress"],
15
+ };
16
+ const query = resolveMemorixFilters(assetsEntity, list, undefined, "snapshots");
17
+ expect(query).toEqual({ "data.ip_address": "10.0.0.1" });
18
+ });
19
+ it("merges request filters over list defaults on the same property", () => {
20
+ const list = {
21
+ id: "critical-vulnerabilities-list",
22
+ entity: "assets",
23
+ leadingContentType: "snapshots",
24
+ pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
25
+ filters: [
26
+ { property: "ipAddress", operator: "eq", value: "10.0.0.1" },
27
+ ],
28
+ fields: ["ipAddress"],
29
+ };
30
+ const query = resolveMemorixFilters(assetsEntity, list, [{ property: "ipAddress", operator: "eq", value: "10.0.0.2" }], "snapshots");
31
+ expect(query).toEqual({ "data.ip_address": "10.0.0.2" });
32
+ });
33
+ it("mergeListDescriptorFilters keeps allowlist-only entries out of defaults", () => {
34
+ const merged = mergeListDescriptorFilters({
35
+ id: "x",
36
+ entity: "assets",
37
+ leadingContentType: "snapshots",
38
+ pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
39
+ filters: [{ property: "ipAddress" }],
40
+ fields: ["ipAddress"],
41
+ }, [{ property: "ipAddress", operator: "eq", value: "1.2.3.4" }]);
42
+ expect(merged).toEqual([
43
+ { property: "ipAddress", operator: "eq", value: "1.2.3.4" },
44
+ ]);
45
+ });
46
+ });
47
+ //# sourceMappingURL=resolve-filters.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve-filters.test.js","sourceRoot":"","sources":["../../src/tests/resolve-filters.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,IAAI,GAAG;YACX,EAAE,EAAE,sBAAsB;YAC1B,MAAM,EAAE,QAAQ;YAChB,kBAAkB,EAAE,WAAW;YAC/B,UAAU,EAAE,EAAE,OAAO,EAAE,IAAa,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;YACvE,OAAO,EAAE;gBACP,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAa,EAAE,KAAK,EAAE,UAAU,EAAE;aACtE;YACD,MAAM,EAAE,CAAC,WAAW,CAAC;SACtB,CAAC;QAEF,MAAM,KAAK,GAAG,qBAAqB,CACjC,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,WAAW,CACZ,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,IAAI,GAAG;YACX,EAAE,EAAE,+BAA+B;YACnC,MAAM,EAAE,QAAQ;YAChB,kBAAkB,EAAE,WAAW;YAC/B,UAAU,EAAE,EAAE,OAAO,EAAE,IAAa,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;YACvE,OAAO,EAAE;gBACP,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAa,EAAE,KAAK,EAAE,UAAU,EAAE;aACtE;YACD,MAAM,EAAE,CAAC,WAAW,CAAC;SACtB,CAAC;QAEF,MAAM,KAAK,GAAG,qBAAqB,CACjC,YAAY,EACZ,IAAI,EACJ,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAC9D,WAAW,CACZ,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,MAAM,GAAG,0BAA0B,CACvC;YACE,EAAE,EAAE,GAAG;YACP,MAAM,EAAE,QAAQ;YAChB,kBAAkB,EAAE,WAAW;YAC/B,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;YAC9D,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;YACpC,MAAM,EAAE,CAAC,WAAW,CAAC;SACtB,EACD,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAC9D,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;SAC5D,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=seed-check.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seed-check.test.d.ts","sourceRoot":"","sources":["../../src/tests/seed-check.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,47 @@
1
+ import { describe, expect, it, vi } from "vitest";
2
+ import { createMemorixRetrieval } from "../client/create-client.js";
3
+ import { checkMemorixRetrievalSeedNeeds } from "../seeds/check-needs-seed.js";
4
+ import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG } from "../descriptors/catalog-ids.js";
5
+ describe("checkMemorixRetrievalSeedNeeds", () => {
6
+ it("reports missing catalog items", async () => {
7
+ const client = createMemorixRetrieval({
8
+ catalox: {
9
+ getCatalogItem: vi.fn(),
10
+ listCatalogItems: vi.fn(async (_ctx, catalogId) => {
11
+ if (catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG) {
12
+ return { items: [{ id: "assets", data: {} }], hasMore: false };
13
+ }
14
+ return { items: [], hasMore: false };
15
+ }),
16
+ },
17
+ });
18
+ const result = await checkMemorixRetrievalSeedNeeds(client, {
19
+ expected: [
20
+ {
21
+ catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
22
+ itemIds: ["assets", "vulnerabilities"],
23
+ },
24
+ ],
25
+ });
26
+ expect(result.needed).toBe(true);
27
+ expect(result.catalogs[0]?.missingItemIds).toEqual(["vulnerabilities"]);
28
+ });
29
+ it("reports ok when all expected items exist", async () => {
30
+ const client = createMemorixRetrieval({
31
+ catalox: {
32
+ getCatalogItem: vi.fn(),
33
+ listCatalogItems: vi.fn(async () => ({
34
+ items: [{ id: "assets", data: {} }],
35
+ hasMore: false,
36
+ })),
37
+ },
38
+ });
39
+ const result = await checkMemorixRetrievalSeedNeeds(client, {
40
+ expected: [
41
+ { catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG, itemIds: ["assets"] },
42
+ ],
43
+ });
44
+ expect(result.needed).toBe(false);
45
+ });
46
+ });
47
+ //# sourceMappingURL=seed-check.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seed-check.test.js","sourceRoot":"","sources":["../../src/tests/seed-check.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAEnF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,OAAO,EAAE;gBACP,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;gBACvB,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;oBAChD,IAAI,SAAS,KAAK,kCAAkC,EAAE,CAAC;wBACrD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;oBACjE,CAAC;oBACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;gBACvC,CAAC,CAAC;aACH;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC,MAAM,EAAE;YAC1D,QAAQ,EAAE;gBACR;oBACE,SAAS,EAAE,kCAAkC;oBAC7C,OAAO,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC;iBACvC;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,OAAO,EAAE;gBACP,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;gBACvB,gBAAgB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;oBACnC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;oBACnC,OAAO,EAAE,KAAK;iBACf,CAAC,CAAC;aACJ;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC,MAAM,EAAE;YAC1D,QAAQ,EAAE;gBACR,EAAE,SAAS,EAAE,kCAAkC,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE;aACvE;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=seed-manifest.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seed-manifest.test.d.ts","sourceRoot":"","sources":["../../src/tests/seed-manifest.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,80 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { buildMemorixRetrievalSeedManifest } from "../seeds/build-manifest.js";
3
+ import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../descriptors/catalog-ids.js";
4
+ import { mergeSeedItemScopeIntoUpsertData, prepareMemorixRetrievalSeedManifestForCataloxApply, } from "../seeds/merge-for-apply.js";
5
+ import { listExpectedMemorixRetrievalSeedItemIds, MEMORIX_RETRIEVAL_SEED_CATALOGS, } from "../seeds/default-seed-spec.js";
6
+ import { buildMemorixRetrievalSeedManifestFromInputs } from "../seeds/paths.js";
7
+ describe("buildMemorixRetrievalSeedManifest", () => {
8
+ it("builds preset from input json", async () => {
9
+ const manifest = await buildMemorixRetrievalSeedManifest({
10
+ scope: { domains: ["network"], agents: ["neo"] },
11
+ readJson: async (path) => {
12
+ const base = path.split("/").pop()?.replace(/\.json$/i, "") ?? path;
13
+ if (path.startsWith("entity-descriptors/")) {
14
+ return { id: base, entityName: base };
15
+ }
16
+ if (path.startsWith("list-descriptors/")) {
17
+ return { id: base, entity: "assets", title: base };
18
+ }
19
+ if (path.startsWith("item-descriptors/")) {
20
+ return { id: base, entity: "assets", title: base };
21
+ }
22
+ throw new Error(`unexpected ${path}`);
23
+ },
24
+ });
25
+ expect(manifest.presetVersion).toBe(1);
26
+ expect(manifest.items).toHaveLength(MEMORIX_RETRIEVAL_SEED_CATALOGS.flatMap((c) => c.inputFiles).length);
27
+ const assetsEntity = manifest.items.find((i) => i.catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG && i.data.id === "assets");
28
+ expect(assetsEntity).toMatchObject({
29
+ scope: { domains: ["network"], agents: ["neo"] },
30
+ data: { id: "assets", entityName: "assets", target: "entity" },
31
+ });
32
+ expect(manifest.items.some((i) => i.catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG)).toBe(true);
33
+ });
34
+ it("builds full manifest from shipped catalox-seeds/inputs", async () => {
35
+ const manifest = await buildMemorixRetrievalSeedManifestFromInputs();
36
+ expect(manifest.items).toHaveLength(11);
37
+ expect(manifest.items.every((i) => i.scope.domains.length > 0)).toBe(true);
38
+ });
39
+ });
40
+ describe("seed merge for apply", () => {
41
+ it("merges scope into upsert data", () => {
42
+ expect(mergeSeedItemScopeIntoUpsertData({ id: "assets" }, {
43
+ domains: ["network"],
44
+ agents: ["neo"],
45
+ })).toEqual({
46
+ id: "assets",
47
+ scope: { domains: ["network"], agents: ["neo"] },
48
+ });
49
+ });
50
+ it("prepares manifest items for catalox apply", () => {
51
+ const prepared = prepareMemorixRetrievalSeedManifestForCataloxApply({
52
+ presetVersion: 1,
53
+ id: "x",
54
+ name: "x",
55
+ description: "x",
56
+ catalogs: [],
57
+ descriptors: [],
58
+ bindings: [],
59
+ items: [
60
+ {
61
+ catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
62
+ scope: { domains: ["network"], agents: ["neo"] },
63
+ data: { id: "assets" },
64
+ },
65
+ ],
66
+ });
67
+ expect(prepared.items[0]?.data.scope).toEqual({
68
+ domains: ["network"],
69
+ agents: ["neo"],
70
+ });
71
+ });
72
+ });
73
+ describe("listExpectedMemorixRetrievalSeedItemIds", () => {
74
+ it("lists all shipped catalog item ids", () => {
75
+ const expected = listExpectedMemorixRetrievalSeedItemIds();
76
+ expect(expected.find((c) => c.catalogId.includes("entity"))?.itemIds).toContain("assets");
77
+ expect(expected.flatMap((c) => c.itemIds)).toHaveLength(11);
78
+ });
79
+ });
80
+ //# sourceMappingURL=seed-manifest.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seed-manifest.test.js","sourceRoot":"","sources":["../../src/tests/seed-manifest.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,141 @@
1
+ # Memorix data tier contract
2
+
3
+ **Reference only** — indexes the public API of `@x12i/memorix-retrieval`. It does not define new runtime behavior; see implementation in `src/index.ts`.
4
+
5
+ Public API surface for **`@x12i/memorix-retrieval`**. Host apps (Explorer, APIs, tools) should call these exports only — not ad hoc Mongo or env-based entity discovery.
6
+
7
+ See also:
8
+
9
+ - [MEMORIX-CATALOX-CONTRACTS.md](./MEMORIX-CATALOX-CONTRACTS.md) — descriptor catalogs and JSON formats
10
+ - [MEMORIX-DATABASE-CONVENTIONS.md](./MEMORIX-DATABASE-CONVENTIONS.md) — Mongo layout and env vars
11
+ - [EXPLORER-HOST-APIS.md](./EXPLORER-HOST-APIS.md) — graph, raw reads, scoped workspace (Explorer-oriented)
12
+
13
+ ---
14
+
15
+ ## Bootstrap
16
+
17
+ | Export | Purpose |
18
+ |--------|---------|
19
+ | `createMemorixRetrieval(options)` | Build client with Catalox (+ lazy Mongo from `MONGO_URI`) |
20
+ | `createMemorixRetrievalFromEnv(options)` | Same, connects Mongo up front |
21
+ | `createMemorixRetrievalStackFromEnv(options?)` | Catalox from env + adapter + retrieval client (recommended for hosts) |
22
+ | `createCataloxAdapterFromBound(bound)` | Wrap a bound Catalox client for descriptor loads |
23
+ | `resolveMemorixAppId(options?, processEnv?)` | Resolve app id: option → `CATALOX_APP_ID` → `MEMORIX_APP_ID` → `memorix` |
24
+
25
+ **Required env (simple mode):** `MONGO_URI`. Catalox credentials per `@x12i/catalox` when using the stack helper.
26
+
27
+ ---
28
+
29
+ ## Descriptor-driven reads (primary)
30
+
31
+ | Export | Purpose |
32
+ |--------|---------|
33
+ | `fetchMemorixList(client, request)` | Paginated list by list descriptor id |
34
+ | `fetchMemorixItem(client, request)` | Record detail by item descriptor id |
35
+ | `fetchMemorixListForEntity(client, { entityName, ... })` | List using entity `defaultListDescriptorId` |
36
+ | `fetchMemorixWorkspaceList(client, request?)` | Cross-entity workspace list (descriptor-driven merge) |
37
+ | `fetchMemorixItemForEntity(client, { entityName, entityId \| eventId, ... })` | Item using entity `defaultItemDescriptorId` |
38
+
39
+ List requests support `filters`, `searchText`, `sort`, `page`, `includeExtensions`.
40
+
41
+ Workspace list requests support `workspaceListId` (default `memorix-workspace-records-list`), optional `entityName` slice, `searchText`, `sort`, `page`, `includeTotal`. Rows include `entityName` plus per-entity composed fields.
42
+
43
+ List descriptor `filters` with `operator` + `value` are **always applied**; request filters merge on top (same property: request wins).
44
+
45
+ ---
46
+
47
+ ## Discovery and defaults
48
+
49
+ | Export | Purpose |
50
+ |--------|---------|
51
+ | `discoverMemorixEntities(client)` | List entity descriptors from Catalox (`source: "catalox" \| "none"`) |
52
+ | `loadMemorixEntityDescriptorByName(client, entityName)` | Load full entity descriptor by `entityName` |
53
+ | `loadMemorixEntityDescriptor` / `loadMemorixListDescriptor` / `loadMemorixItemDescriptor` | Load by catalog item id |
54
+ | `resolveDefaultListDescriptorForEntity` / `resolveDefaultItemDescriptorForEntity` | Resolve Option A defaults |
55
+ | `entityDescriptorConnections(entity)` | Relation edges from entity descriptor |
56
+
57
+ **Forbidden:** env entity lists (`MEMORIX_ENTITY_NAMES`, etc.). Discovery is Catalox-only.
58
+
59
+ ---
60
+
61
+ ## Explorer / graph (optional)
62
+
63
+ | Export | Purpose |
64
+ |--------|---------|
65
+ | `buildMemorixEntityGraph(client, options?)` | Discovery + counts + relation graph |
66
+ | `buildMemorixEntitySlices(client, entityName)` | Per–content-type counts for drill-down |
67
+ | `getMemorixRetrievalHealth(client)` | Mongo ping + discovery sample |
68
+ | `countMemorixEntityContentTypeDocuments` | Count by entity + content type (descriptor-resolved collection) |
69
+ | `listMemorixEntityContentTypeDocuments` | Paginated raw documents (descriptor-resolved) |
70
+ | `getMemorixEntityContentTypeDocument` | Single document by record id |
71
+ | `listScopedWorkspaceEntityTypes` / `listScopedWorkspaceDocuments` / `countScopedWorkspaceDocuments` | Namespace-scoped cross-entity reads |
72
+ | `resolveScopedWorkspaceNamespace` / `resolveScopedNamespaceFieldPaths` | Scoped workspace env helpers |
73
+
74
+ Raw reads resolve **entity name + content type** to Mongo via descriptors — they do not accept arbitrary collection names.
75
+
76
+ ---
77
+
78
+ ## Content objects
79
+
80
+ | Export | Purpose |
81
+ |--------|---------|
82
+ | `fetchMemorixContentObject(client, ...)` | Fetch full content from GCS/S3 via host-injected `contentReaders` |
83
+ | `resolveMemorixContentObject` / `shapeContentForList` / `shapeContentForItem` | Content object parsing and shaping |
84
+
85
+ ---
86
+
87
+ ## Catalox seed helpers (library)
88
+
89
+ Build/apply logic for default descriptors lives in **`src/seeds/`** and is exported for scripts and host tooling. Runtime retrieval does not seed Catalox automatically.
90
+
91
+ | Export | Purpose |
92
+ |--------|---------|
93
+ | `buildMemorixRetrievalSeedManifest` | Build preset manifest from `readJson` + scope |
94
+ | `buildMemorixRetrievalSeedManifestFromInputs` | Build from `catalox-seeds/inputs/` on disk |
95
+ | `checkMemorixRetrievalSeedNeeds` | Compare expected vs present catalog item ids |
96
+ | `prepareMemorixRetrievalSeedManifestForCataloxApply` | Merge `scope` into item `data` for Catalox upsert |
97
+ | `listExpectedMemorixRetrievalSeedItemIds` | Expected ids per catalog (11 items shipped) |
98
+ | `MEMORIX_RETRIEVAL_SEED_CATALOGS` | Catalog spec (ids, input files, native fields) |
99
+
100
+ Scripts (not imported by hosts at runtime):
101
+
102
+ | Script | Purpose |
103
+ |--------|---------|
104
+ | `scripts/build-seed-manifest.mjs` | Write `catalox-seeds/memorix-retrieval-descriptors.manifest.json` |
105
+ | `scripts/apply-seed-manifest.mjs` | Apply manifest to Catalox |
106
+ | `scripts/ensure-catalox-seed.mjs` | Check + apply only when items missing (`--dry-run`, `--force`, `--build`) |
107
+
108
+ ---
109
+
110
+ ## Advanced / escape hatches
111
+
112
+ | Export | Purpose |
113
+ |--------|---------|
114
+ | `memorixRead` | Low-level read with entity context (Mongo default; optional Xronox) |
115
+ | `readMemorixCollection` / `countMemorixCollection` / `connectMemorixMongo` | Direct Mongo helpers |
116
+ | `resolveMemorixCollectionName` / `resolveMemorixDbNameForEntity` | Resolution utilities |
117
+ | Env helpers: `resolveMemorixDbName`, `resolveMongoUri`, `targetCollectionEnvKey` | Advanced overrides |
118
+
119
+ Pass `xronox` to `createMemorixRetrieval` only when injecting a pre-configured Xronox client.
120
+
121
+ ---
122
+
123
+ ## Catalog constants
124
+
125
+ | Export | Value |
126
+ |--------|-------|
127
+ | `MEMORIX_APP_ID` | `memorix` |
128
+ | `MEMORIX_ENTITY_DESCRIPTORS_CATALOG` | `memorix-entity-descriptors` |
129
+ | `MEMORIX_LIST_DESCRIPTORS_CATALOG` | `memorix-list-descriptors` |
130
+ | `MEMORIX_ITEM_DESCRIPTORS_CATALOG` | `memorix-item-descriptors` |
131
+
132
+ ---
133
+
134
+ ## Host rules
135
+
136
+ 1. **Entity existence** — from `discoverMemorixEntities` only.
137
+ 2. **List columns / detail layout** — from list/item descriptors only.
138
+ 3. **Mongo targeting** — from entity descriptor `target` + content types; override via env only when documented as advanced.
139
+ 4. **No credentials in descriptors** — inject storage clients via `contentReaders`.
140
+
141
+ Types: `MemorixEntityDescriptor`, `MemorixListDescriptor`, `MemorixEntityListDescriptor`, `MemorixWorkspaceListDescriptor`, `MemorixItemDescriptor`, `MemorixRetrievalClient`, `FetchMemorixListRequest`, `FetchMemorixWorkspaceListRequest`, `FetchMemorixItemRequest`, `MemorixRetrievalIssue`.
@@ -1,6 +1,8 @@
1
- # Explorer host APIs (v1.2)
1
+ # Explorer host APIs
2
2
 
3
- Optional exports for host applications such as **memorix-explorer** that need graph/count/list operations without going through list/item descriptors.
3
+ Optional exports from **`@x12i/memorix-retrieval`** for host applications such as **memorix-explorer** that need graph, count, or namespace-scoped reads in addition to descriptor-driven list/item APIs.
4
+
5
+ Full export list: [DATA-TIER-CONTRACT.md](./DATA-TIER-CONTRACT.md).
4
6
 
5
7
  ## Stack bootstrap
6
8
 
@@ -12,23 +14,34 @@ const { client, cataloxBound, appId } = await createMemorixRetrievalStackFromEnv
12
14
  });
13
15
  ```
14
16
 
15
- Uses `createCataloxFromEnv` + `createCataloxAdapterFromBound` + `createMemorixRetrievalFromEnv` in one call.
17
+ Uses `createCataloxFromEnv` + `createCataloxAdapterFromBound` + `createMemorixRetrievalFromEnv` in one call. App id resolves from option → `CATALOX_APP_ID` → `MEMORIX_APP_ID` → `memorix`.
16
18
 
17
19
  ## Entity discovery
18
20
 
19
- - `discoverMemorixEntities(client)` — lists `memorix-entity-descriptors` via Catalox, or `MEMORIX_ENTITY_NAMES` env override.
21
+ - `discoverMemorixEntities(client)` — lists `memorix-entity-descriptors` via Catalox only (`source: "catalox" | "none"`). No env entity list fallback.
20
22
  - `buildMemorixEntityGraph(client)` — discovery + per–content-type counts + **relations from entity descriptors**.
21
23
  - `buildMemorixEntitySlices(client, entityName)` — slice counts for canvas drill-down.
22
24
 
23
25
  ## Raw collection reads (Explorer compatibility)
24
26
 
27
+ Descriptor-resolved reads by **entity name + content type** (not arbitrary collection names):
28
+
25
29
  - `countMemorixEntityContentTypeDocuments`
26
30
  - `listMemorixEntityContentTypeDocuments`
27
31
  - `getMemorixEntityContentTypeDocument`
28
32
 
29
- Resolve collection names and DB targets from entity descriptors.
33
+ ## Descriptor-driven workspace list
34
+
35
+ Cross-entity **Records** workspace (no entity filter) uses descriptor composition, not raw Mongo fan-out:
36
+
37
+ - `fetchMemorixWorkspaceList(client, request?)` — merges per-entity list rows from Catalox-discovered entities.
38
+ - Default workspace list id: `memorix-workspace-records-list` (`kind: "workspace"` in `memorix-list-descriptors`).
39
+ - Optional `entityName` on the request delegates to `fetchMemorixListForEntity` (entity slice).
40
+ - Each row includes `entityName` plus fields composed from that entity's list descriptor.
41
+
42
+ Supports `page`, `includeTotal`, `searchText`, and global `sort` (v1: in-memory merge across entities).
30
43
 
31
- ## Scoped workspace
44
+ ## Scoped workspace (namespace)
32
45
 
33
46
  - `listScopedWorkspaceEntityTypes` / `listScopedWorkspaceDocuments` / `countScopedWorkspaceDocuments`
34
47
  - Requires `TARGET_NAMESPACE` (or `MEMORIX_SCOPED_NAMESPACE` / `XMEMORY_NAMESPACE`).
@@ -44,5 +57,4 @@ Only three native catalogs. Relations belong on **entity descriptors** (`relatio
44
57
  Future additions (not required for Explorer v1):
45
58
 
46
59
  - `listMemorixListDescriptorIds` for UI list-picker
47
- - Descriptor-driven scoped lists replacing raw cross-entity pagination
48
60
  - Optional `memorix-entity-relations` catalog if you need edges that are not tied to a single source entity descriptor