@x12i/memorix-retrieval 1.2.0 → 1.5.0

package/dist/seeds/check-needs-seed.d.ts

@@ -0,0 +1,10 @@
+import type { MemorixRetrievalClient } from "../client/types.js";
+import type { MemorixRetrievalSeedCheckResult } from "./seed-types.js";
+export type CheckMemorixRetrievalSeedNeedsOptions = {
+    expected?: Array<{
+        catalogId: string;
+        itemIds: string[];
+    }>;
+};
+export declare function checkMemorixRetrievalSeedNeeds(client: MemorixRetrievalClient, options?: CheckMemorixRetrievalSeedNeedsOptions): Promise<MemorixRetrievalSeedCheckResult>;
+//# sourceMappingURL=check-needs-seed.d.ts.map

package/dist/seeds/check-needs-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-needs-seed.d.ts","sourceRoot":"","sources":["../../src/seeds/check-needs-seed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AA6BvE,MAAM,MAAM,qCAAqC,GAAG;IAClD,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC;AAEF,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,+BAA+B,CAAC,CA+C1C"}

package/dist/seeds/check-needs-seed.js

@@ -0,0 +1,66 @@
+import { throwRetrievalError } from "../errors/errors.js";
+import { listExpectedMemorixRetrievalSeedItemIds } from "./default-seed-spec.js";
+async function listCatalogItemIds(client, catalogId) {
+    const listFn = client.catalox.listCatalogItems;
+    if (!listFn) {
+        throwRetrievalError("CATALOX_LIST_UNSUPPORTED", "Catalox client must support listCatalogItems to check seed status");
+    }
+    const ids = [];
+    let offset = 0;
+    const pageSize = 200;
+    for (;;) {
+        const page = await listFn({ appId: client.appId }, catalogId, {
+            limit: pageSize,
+            offset,
+        });
+        ids.push(...page.items.map((item) => item.id));
+        if (!page.hasMore || page.items.length === 0)
+            break;
+        offset += page.items.length;
+        if (offset > 10_000)
+            break;
+    }
+    return ids;
+}
+export async function checkMemorixRetrievalSeedNeeds(client, options = {}) {
+    const expected = options.expected ?? listExpectedMemorixRetrievalSeedItemIds();
+    const catalogs = [];
+    let needed = false;
+    const reasons = [];
+    for (const { catalogId, itemIds } of expected) {
+        let presentItemIds = [];
+        try {
+            presentItemIds = await listCatalogItemIds(client, catalogId);
+        }
+        catch (e) {
+            needed = true;
+            const msg = e instanceof Error ? e.message : String(e);
+            reasons.push(`${catalogId}: ${msg}`);
+            catalogs.push({
+                catalogId,
+                expectedItemIds: itemIds,
+                presentItemIds: [],
+                missingItemIds: itemIds,
+            });
+            continue;
+        }
+        const presentSet = new Set(presentItemIds);
+        const missingItemIds = itemIds.filter((id) => !presentSet.has(id));
+        if (missingItemIds.length) {
+            needed = true;
+            reasons.push(`${catalogId}: missing ${missingItemIds.join(", ")}`);
+        }
+        catalogs.push({
+            catalogId,
+            expectedItemIds: itemIds,
+            presentItemIds,
+            missingItemIds,
+        });
+    }
+    return {
+        needed,
+        reason: reasons.length ? reasons.join("; ") : undefined,
+        catalogs,
+    };
+}
+//# sourceMappingURL=check-needs-seed.js.map

package/dist/seeds/check-needs-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-needs-seed.js","sourceRoot":"","sources":["../../src/seeds/check-needs-seed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,uCAAuC,EAAE,MAAM,wBAAwB,CAAC;AAGjF,KAAK,UAAU,kBAAkB,CAC/B,MAA8B,EAC9B,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,mBAAmB,CACjB,0BAA0B,EAC1B,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,QAAQ,GAAG,GAAG,CAAC;IACrB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE;YAC5D,KAAK,EAAE,QAAQ;YACf,MAAM;SACP,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;QACpD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,MAAM,GAAG,MAAM;YAAE,MAAM;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAA8B,EAC9B,UAAiD,EAAE;IAEnD,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ,IAAI,uCAAuC,EAAE,CAAC;IAEhE,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC9C,IAAI,cAAc,GAAa,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,cAAc,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,KAAK,GAAG,EAAE,CAAC,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS;gBACT,eAAe,EAAE,OAAO;gBACxB,cAAc,EAAE,EAAE;gBAClB,cAAc,EAAE,OAAO;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACnE,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,CAAC,IAAI,CACV,GAAG,SAAS,aAAa,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrD,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS;YACT,eAAe,EAAE,OAAO;YACxB,cAAc;YACd,cAAc;SACf,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/seeds/default-seed-spec.d.ts

@@ -0,0 +1,12 @@
+import type { MemorixSeedCatalogSpec, MemorixSeedScope } from "./seed-types.js";
+export declare const MEMORIX_RETRIEVAL_SEED_PRESET_ID = "memorix-retrieval-descriptors";
+export declare const MEMORIX_RETRIEVAL_DEFAULT_SCOPE: MemorixSeedScope;
+/** Entity descriptor id → Memorix target database role (applied at seed build). */
+export declare const MEMORIX_RETRIEVAL_ENTITY_TARGETS: Record<string, "entity" | "event">;
+export declare const MEMORIX_RETRIEVAL_SEED_CATALOGS: MemorixSeedCatalogSpec[];
+export declare const MEMORIX_RETRIEVAL_SEED_APP_ID = "memorix";
+export declare function listExpectedMemorixRetrievalSeedItemIds(): Array<{
+    catalogId: string;
+    itemIds: string[];
+}>;
+//# sourceMappingURL=default-seed-spec.d.ts.map

package/dist/seeds/default-seed-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-seed-spec.d.ts","sourceRoot":"","sources":["../../src/seeds/default-seed-spec.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEhF,eAAO,MAAM,gCAAgC,kCAAkC,CAAC;AAEhF,eAAO,MAAM,+BAA+B,EAAE,gBAG7C,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAI/E,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,sBAAsB,EAkEnE,CAAC;AAEF,eAAO,MAAM,6BAA6B,YAAiB,CAAC;AAE5D,wBAAgB,uCAAuC,IAAI,KAAK,CAAC;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAQD"}

package/dist/seeds/default-seed-spec.js

@@ -0,0 +1,90 @@
+import { MEMORIX_APP_ID, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../descriptors/catalog-ids.js";
+export const MEMORIX_RETRIEVAL_SEED_PRESET_ID = "memorix-retrieval-descriptors";
+export const MEMORIX_RETRIEVAL_DEFAULT_SCOPE = {
+    domains: ["network", "vulnerabilities"],
+    agents: ["neo"],
+};
+/** Entity descriptor id → Memorix target database role (applied at seed build). */
+export const MEMORIX_RETRIEVAL_ENTITY_TARGETS = {
+    assets: "entity",
+    "variabilities-groups": "entity",
+    vulnerabilities: "event",
+};
+export const MEMORIX_RETRIEVAL_SEED_CATALOGS = [
+    {
+        catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+        name: "Memorix entity descriptors",
+        catalogType: "memorix",
+        sourceMode: "native",
+        native: { itemIdField: "id", titleField: "entityName" },
+        descriptor: {
+            itemIdField: "id",
+            titleField: "entityName",
+            queryableFields: [
+                { key: "id", label: "Id" },
+                { key: "entityName", label: "Entity name" },
+                { key: "target", label: "Target" },
+            ],
+        },
+        inputFiles: [
+            "entity-descriptors/assets.json",
+            "entity-descriptors/variabilities-groups.json",
+            "entity-descriptors/vulnerabilities.json",
+        ],
+    },
+    {
+        catalogId: MEMORIX_LIST_DESCRIPTORS_CATALOG,
+        name: "Memorix list descriptors",
+        catalogType: "memorix",
+        sourceMode: "native",
+        native: { itemIdField: "id", titleField: "title" },
+        descriptor: {
+            itemIdField: "id",
+            titleField: "title",
+            queryableFields: [
+                { key: "id", label: "Id" },
+                { key: "entity", label: "Entity" },
+                { key: "title", label: "Title" },
+            ],
+        },
+        inputFiles: [
+            "list-descriptors/assets-main-list.json",
+            "list-descriptors/vulnerabilities-main-list.json",
+            "list-descriptors/critical-vulnerabilities-list.json",
+            "list-descriptors/variabilities-groups-main-list.json",
+            "list-descriptors/memorix-workspace-records-list.json",
+        ],
+    },
+    {
+        catalogId: MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+        name: "Memorix item descriptors",
+        catalogType: "memorix",
+        sourceMode: "native",
+        native: { itemIdField: "id", titleField: "title" },
+        descriptor: {
+            itemIdField: "id",
+            titleField: "title",
+            queryableFields: [
+                { key: "id", label: "Id" },
+                { key: "entity", label: "Entity" },
+                { key: "title", label: "Title" },
+            ],
+        },
+        inputFiles: [
+            "item-descriptors/asset-detail-item.json",
+            "item-descriptors/vulnerability-detail-item.json",
+            "item-descriptors/variabilities-group-detail-item.json",
+        ],
+    },
+];
+export const MEMORIX_RETRIEVAL_SEED_APP_ID = MEMORIX_APP_ID;
+export function listExpectedMemorixRetrievalSeedItemIds() {
+    return MEMORIX_RETRIEVAL_SEED_CATALOGS.map((spec) => ({
+        catalogId: spec.catalogId,
+        itemIds: spec.inputFiles.map((file) => {
+            const base = file.split("/").pop() ?? file;
+            return base.replace(/\.json$/i, "");
+        }),
+    }));
+}
+//# sourceMappingURL=default-seed-spec.js.map

package/dist/seeds/default-seed-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-seed-spec.js","sourceRoot":"","sources":["../../src/seeds/default-seed-spec.ts"],"names":[],"mappings":"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"}

package/dist/seeds/merge-for-apply.d.ts

@@ -0,0 +1,28 @@
+import type { MemorixRetrievalSeedManifest, MemorixSeedScope } from "./seed-types.js";
+/**
+ * Catalox seed apply upserts `row.data` only; merge scope into data for native items.
+ */
+export declare function mergeSeedItemScopeIntoUpsertData(data: Record<string, unknown>, scope: MemorixSeedScope | undefined): Record<string, unknown>;
+export declare function prepareSeedManifestItemForApply(item: {
+    catalogId: string;
+    data: Record<string, unknown>;
+    scope?: MemorixSeedScope;
+}): {
+    catalogId: string;
+    data: Record<string, unknown>;
+};
+export declare function prepareMemorixRetrievalSeedManifestForApply(manifest: MemorixRetrievalSeedManifest): MemorixRetrievalSeedManifest;
+/** Shape expected by {@link applyCataloxSeedPreset} after scope merge into item data. */
+export declare function prepareMemorixRetrievalSeedManifestForCataloxApply(manifest: Omit<MemorixRetrievalSeedManifest, "items"> & {
+    items: Array<{
+        catalogId: string;
+        data: Record<string, unknown>;
+        scope?: MemorixSeedScope;
+    }>;
+}): Omit<MemorixRetrievalSeedManifest, "items"> & {
+    items: Array<{
+        catalogId: string;
+        data: Record<string, unknown>;
+    }>;
+};
+//# sourceMappingURL=merge-for-apply.d.ts.map

package/dist/seeds/merge-for-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-for-apply.d.ts","sourceRoot":"","sources":["../../src/seeds/merge-for-apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAE5B,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAKvD;AAED,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,4BAA4B,GACrC,4BAA4B,CAQ9B;AAED,yFAAyF;AACzF,wBAAgB,kDAAkD,CAChE,QAAQ,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GAAG;IACtD,KAAK,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;KAC1B,CAAC,CAAC;CACJ,GACA,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GAAG;IAC/C,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CACpE,CAKA"}

package/dist/seeds/merge-for-apply.js

@@ -0,0 +1,31 @@
+/**
+ * Catalox seed apply upserts `row.data` only; merge scope into data for native items.
+ */
+export function mergeSeedItemScopeIntoUpsertData(data, scope) {
+    if (scope == null)
+        return data;
+    return { ...data, scope };
+}
+export function prepareSeedManifestItemForApply(item) {
+    return {
+        catalogId: item.catalogId,
+        data: mergeSeedItemScopeIntoUpsertData(item.data, item.scope),
+    };
+}
+export function prepareMemorixRetrievalSeedManifestForApply(manifest) {
+    return {
+        ...manifest,
+        items: manifest.items.map((item) => ({
+            ...item,
+            data: mergeSeedItemScopeIntoUpsertData(item.data, item.scope),
+        })),
+    };
+}
+/** Shape expected by {@link applyCataloxSeedPreset} after scope merge into item data. */
+export function prepareMemorixRetrievalSeedManifestForCataloxApply(manifest) {
+    return {
+        ...manifest,
+        items: manifest.items.map(prepareSeedManifestItemForApply),
+    };
+}
+//# sourceMappingURL=merge-for-apply.js.map

package/dist/seeds/merge-for-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-for-apply.js","sourceRoot":"","sources":["../../src/seeds/merge-for-apply.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAA6B,EAC7B,KAAmC;IAEnC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAI/C;IACC,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,gCAAgC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2CAA2C,CACzD,QAAsC;IAEtC,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnC,GAAG,IAAI;YACP,IAAI,EAAE,gCAAgC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,kDAAkD,CAChE,QAMC;IAID,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/seeds/paths.d.ts

@@ -0,0 +1,10 @@
+import type { MemorixRetrievalSeedManifest } from "./seed-types.js";
+/** Package root (memorix-retrieval/) when running from compiled `dist/seeds/`. */
+export declare function resolveMemorixRetrievalPackageRoot(): string;
+export declare function resolveMemorixRetrievalSeedInputsDir(packageRoot?: string): string;
+export declare function resolveMemorixRetrievalSeedManifestPath(packageRoot?: string): string;
+export declare function createSeedInputsReader(inputsDir: string): (relativePath: string) => Promise<Record<string, unknown>>;
+export declare function loadMemorixRetrievalSeedScopeFromInputs(inputsDir?: string): Promise<import("./seed-types.js").MemorixSeedScope>;
+export declare function buildMemorixRetrievalSeedManifestFromInputs(inputsDir?: string): Promise<MemorixRetrievalSeedManifest>;
+export declare function writeMemorixRetrievalSeedManifest(manifest: MemorixRetrievalSeedManifest, manifestPath?: string): Promise<void>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/seeds/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/seeds/paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAIpE,kFAAkF;AAClF,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED,wBAAgB,oCAAoC,CAClD,WAAW,SAAuC,GACjD,MAAM,CAER;AAED,wBAAgB,uCAAuC,CACrD,WAAW,SAAuC,GACjD,MAAM,CAMR;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,IACxC,cAAc,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAItE;AAED,wBAAsB,uCAAuC,CAC3D,SAAS,SAAyC,GACjD,OAAO,CAAC,OAAO,iBAAiB,EAAE,gBAAgB,CAAC,CAUrD;AAED,wBAAsB,2CAA2C,CAC/D,SAAS,SAAyC,GACjD,OAAO,CAAC,4BAA4B,CAAC,CAIvC;AAED,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,4BAA4B,EACtC,YAAY,SAA4C,GACvD,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/seeds/paths.js

@@ -0,0 +1,40 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildMemorixRetrievalSeedManifest } from "./build-manifest.js";
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+/** Package root (memorix-retrieval/) when running from compiled `dist/seeds/`. */
+export function resolveMemorixRetrievalPackageRoot() {
+    return join(moduleDir, "..", "..");
+}
+export function resolveMemorixRetrievalSeedInputsDir(packageRoot = resolveMemorixRetrievalPackageRoot()) {
+    return join(packageRoot, "catalox-seeds", "inputs");
+}
+export function resolveMemorixRetrievalSeedManifestPath(packageRoot = resolveMemorixRetrievalPackageRoot()) {
+    return join(packageRoot, "catalox-seeds", "memorix-retrieval-descriptors.manifest.json");
+}
+export function createSeedInputsReader(inputsDir) {
+    return async (relativePath) => {
+        const raw = await readFile(join(inputsDir, relativePath), "utf8");
+        return JSON.parse(raw);
+    };
+}
+export async function loadMemorixRetrievalSeedScopeFromInputs(inputsDir = resolveMemorixRetrievalSeedInputsDir()) {
+    try {
+        const raw = await readFile(join(inputsDir, "scope.json"), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        const { MEMORIX_RETRIEVAL_DEFAULT_SCOPE } = await import("./default-seed-spec.js");
+        return MEMORIX_RETRIEVAL_DEFAULT_SCOPE;
+    }
+}
+export async function buildMemorixRetrievalSeedManifestFromInputs(inputsDir = resolveMemorixRetrievalSeedInputsDir()) {
+    const readJson = createSeedInputsReader(inputsDir);
+    const scope = await loadMemorixRetrievalSeedScopeFromInputs(inputsDir);
+    return buildMemorixRetrievalSeedManifest({ readJson, scope });
+}
+export async function writeMemorixRetrievalSeedManifest(manifest, manifestPath = resolveMemorixRetrievalSeedManifestPath()) {
+    await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=paths.js.map

package/dist/seeds/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/seeds/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAGxE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,kFAAkF;AAClF,MAAM,UAAU,kCAAkC;IAChD,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,WAAW,GAAG,kCAAkC,EAAE;IAElD,OAAO,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,WAAW,GAAG,kCAAkC,EAAE;IAElD,OAAO,IAAI,CACT,WAAW,EACX,eAAe,EACf,6CAA6C,CAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,KAAK,EAAE,YAAoB,EAAoC,EAAE;QACtE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uCAAuC,CAC3D,SAAS,GAAG,oCAAoC,EAAE;IAElD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,+BAA+B,EAAE,GAAG,MAAM,MAAM,CACtD,wBAAwB,CACzB,CAAC;QACF,OAAO,+BAA+B,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2CAA2C,CAC/D,SAAS,GAAG,oCAAoC,EAAE;IAElD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,uCAAuC,CAAC,SAAS,CAAC,CAAC;IACvE,OAAO,iCAAiC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,QAAsC,EACtC,YAAY,GAAG,uCAAuC,EAAE;IAExD,MAAM,SAAS,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClF,CAAC"}

package/dist/seeds/seed-types.d.ts

@@ -0,0 +1,57 @@
+export type MemorixSeedScope = {
+    domains: string[];
+    agents: string[];
+};
+export type MemorixSeedCatalogSpec = {
+    catalogId: string;
+    name: string;
+    catalogType: "memorix";
+    sourceMode: "native";
+    native: {
+        itemIdField: string;
+        titleField: string;
+    };
+    descriptor: {
+        itemIdField: string;
+        titleField: string;
+        queryableFields: Array<{
+            key: string;
+            label: string;
+        }>;
+    };
+    inputFiles: string[];
+};
+export type MemorixRetrievalSeedManifestItem = {
+    catalogId: string;
+    scope: MemorixSeedScope;
+    data: Record<string, unknown>;
+};
+export type MemorixRetrievalSeedManifest = {
+    presetVersion: 1;
+    id: string;
+    name: string;
+    description: string;
+    catalogs: Array<Omit<MemorixSeedCatalogSpec, "descriptor" | "inputFiles">>;
+    descriptors: unknown[];
+    bindings: Array<{
+        appId: string;
+        catalogId: string;
+        access: {
+            canRead: boolean;
+            canWrite: boolean;
+        };
+    }>;
+    items: MemorixRetrievalSeedManifestItem[];
+};
+export type MemorixRetrievalSeedCatalogPresence = {
+    catalogId: string;
+    expectedItemIds: string[];
+    presentItemIds: string[];
+    missingItemIds: string[];
+};
+export type MemorixRetrievalSeedCheckResult = {
+    needed: boolean;
+    reason?: string;
+    catalogs: MemorixRetrievalSeedCatalogPresence[];
+};
+//# sourceMappingURL=seed-types.d.ts.map

package/dist/seeds/seed-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-types.d.ts","sourceRoot":"","sources":["../../src/seeds/seed-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,QAAQ,CAAC;IACrB,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,UAAU,EAAE;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxD,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC;IAC3E,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAA;SAAE,CAAC;KACjD,CAAC,CAAC;IACH,KAAK,EAAE,gCAAgC,EAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mCAAmC,EAAE,CAAC;CACjD,CAAC"}

package/dist/seeds/seed-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=seed-types.js.map

package/dist/seeds/seed-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-types.js","sourceRoot":"","sources":["../../src/seeds/seed-types.ts"],"names":[],"mappings":""}

package/dist/tests/descriptor-validation.test.js

@@ -7,6 +7,21 @@ describe("descriptor validation", () => {
         const d = validateMemorixEntityDescriptor(assetsEntity);
         expect(d.id).toBe("assets");
     });
+    it("requires default list and item descriptor ids", () => {
+        expect(() => validateMemorixEntityDescriptor({
+            ...assetsEntity,
+            defaultListDescriptorId: "",
+        })).toThrow(MemorixRetrievalError);
+    });
+    it("requires exactly one isCanonical content type", () => {
+        expect(() => validateMemorixEntityDescriptor({
+            ...assetsEntity,
+            contentTypes: {
+                ...assetsEntity.contentTypes,
+                extra: { postfix: "extra", isCanonical: true },
+            },
+        })).toThrow(MemorixRetrievalError);
+    });
     it("rejects non-human-readable list fields", () => {
         const badList = {
             ...assetsMainList,

package/dist/tests/descriptor-validation.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"descriptor-validation.test.js","sourceRoot":"","sources":["../../src/tests/descriptor-validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7D,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,+BAA+B,CACvC,YAAkD,CACnD,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG;YACd,GAAG,cAAc;YACjB,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;SAClC,CAAC;QACF,MAAM,MAAM,GAAG;YACb,GAAG,YAAY;YACf,UAAU,EAAE;gBACV,GAAG,YAAY,CAAC,UAAU;gBAC1B,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE;aACxE;SACF,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CACV,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,CAC/C,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"descriptor-validation.test.js","sourceRoot":"","sources":["../../src/tests/descriptor-validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,6BAA6B,EAC7B,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7D,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,+BAA+B,CACvC,YAAkD,CACnD,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,EAAE,CACV,+BAA+B,CAAC;YAC9B,GAAI,YAAmD;YACvD,uBAAuB,EAAE,EAAE;SAC5B,CAAC,CACH,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,EAAE,CACV,+BAA+B,CAAC;YAC9B,GAAI,YAAmD;YACvD,YAAY,EAAE;gBACZ,GAAI,YAAY,CAAC,YAAwC;gBACzD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE;aAC/C;SACF,CAAC,CACH,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG;YACd,GAAG,cAAc;YACjB,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;SAClC,CAAC;QACF,MAAM,MAAM,GAAG;YACb,GAAG,YAAY;YACf,UAAU,EAAE;gBACV,GAAG,YAAY,CAAC,UAAU;gBAC1B,QAAQ,EAAE,EAAE,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE;aACxE;SACF,CAAC;QACF,MAAM,CAAC,GAAG,EAAE,CACV,6BAA6B,CAAC,OAAO,EAAE,MAAM,CAAC,CAC/C,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/fetch-workspace-list.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fetch-workspace-list.test.d.ts.map

package/dist/tests/fetch-workspace-list.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-workspace-list.test.d.ts","sourceRoot":"","sources":["../../src/tests/fetch-workspace-list.test.ts"],"names":[],"mappings":""}

package/dist/tests/fetch-workspace-list.test.js

@@ -0,0 +1,187 @@
+import { describe, expect, it, vi } from "vitest";
+import { createMemorixRetrieval } from "../client/create-client.js";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../descriptors/catalog-ids.js";
+import { fetchMemorixWorkspaceList, DEFAULT_WORKSPACE_LIST_ID, } from "../retrieval/fetch-workspace-list.js";
+import { assetsEntity, assetsMainList, vulnerabilitiesEntity, vulnerabilitiesMainList, workspaceRecordsList, } from "./fixtures.js";
+function mockWorkspaceCatalox() {
+    const entityItems = [
+        { id: "assets", data: assetsEntity, title: "Assets" },
+        { id: "vulnerabilities", data: vulnerabilitiesEntity, title: "Vulnerabilities" },
+    ];
+    return {
+        getCatalogItem: vi.fn(async (_ctx, catalogId, itemId) => {
+            if (catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG &&
+                itemId === "assets-main-list") {
+                return { outcome: "found", item: { data: assetsMainList } };
+            }
+            if (catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG &&
+                itemId === "vulnerabilities-main-list") {
+                return {
+                    outcome: "found",
+                    item: { data: vulnerabilitiesMainList },
+                };
+            }
+            if (catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG &&
+                itemId === DEFAULT_WORKSPACE_LIST_ID) {
+                return {
+                    outcome: "found",
+                    item: { data: workspaceRecordsList },
+                };
+            }
+            if (catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG && itemId === "assets") {
+                return { outcome: "found", item: { data: assetsEntity } };
+            }
+            if (catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG &&
+                itemId === "vulnerabilities") {
+                return {
+                    outcome: "found",
+                    item: { data: vulnerabilitiesEntity },
+                };
+            }
+            return { outcome: "not_found" };
+        }),
+        listCatalogItems: vi.fn(async () => ({
+            items: entityItems,
+            hasMore: false,
+        })),
+    };
+}
+function mockXronox() {
+    return vi.fn(async (params) => {
+        if (params.source === "assets-snapshots") {
+            return [
+                {
+                    entityId: "10.0.0.1",
+                    modifiedAt: "2026-01-01",
+                    data: { ip_address: "10.0.0.1", xdr: { host_name: "host-a" } },
+                },
+                {
+                    entityId: "10.0.0.2",
+                    modifiedAt: "2026-01-02",
+                    data: { ip_address: "10.0.0.2", xdr: { host_name: "host-b" } },
+                },
+            ];
+        }
+        if (params.source === "vulnerabilities-snapshots") {
+            return [
+                {
+                    entityId: "vuln-1",
+                    modifiedAt: "2026-02-01",
+                    data: {
+                        vulnerabilityId: "vuln-1",
+                        pluginName: "SSL",
+                        priorityScore: 95,
+                    },
+                },
+                {
+                    entityId: "vuln-2",
+                    modifiedAt: "2026-03-01",
+                    data: {
+                        vulnerabilityId: "vuln-2",
+                        pluginName: "SSH",
+                        priorityScore: 50,
+                    },
+                },
+            ];
+        }
+        return [];
+    });
+}
+describe("fetchMemorixWorkspaceList", () => {
+    it("merges rows from all discovered entities with entityName", async () => {
+        const xronoxRead = mockXronox();
+        const client = createMemorixRetrieval({
+            catalox: mockWorkspaceCatalox(),
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+        });
+        const res = await fetchMemorixWorkspaceList(client, {
+            page: { limit: 10, offset: 0 },
+        });
+        expect(res.workspaceListDescriptorId).toBe(DEFAULT_WORKSPACE_LIST_ID);
+        expect(res.discovery.source).toBe("catalox");
+        expect(res.includedEntities).toEqual(["assets", "vulnerabilities"]);
+        expect(res.rows.length).toBeGreaterThanOrEqual(2);
+        expect(res.rows.every((r) => typeof r.entityName === "string")).toBe(true);
+        const entityNames = new Set(res.rows.map((r) => r.entityName));
+        expect(entityNames.has("assets")).toBe(true);
+        expect(entityNames.has("vulnerabilities")).toBe(true);
+    });
+    it("paginates merged workspace rows", async () => {
+        const xronoxRead = mockXronox();
+        const client = createMemorixRetrieval({
+            catalox: mockWorkspaceCatalox(),
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+        });
+        const res = await fetchMemorixWorkspaceList(client, {
+            page: { limit: 2, offset: 0 },
+        });
+        expect(res.rows).toHaveLength(2);
+        expect(res.page.limit).toBe(2);
+        expect(res.page.hasMore).toBe(true);
+    });
+    it("sorts merged rows globally by workspace defaultSort", async () => {
+        const xronoxRead = mockXronox();
+        const client = createMemorixRetrieval({
+            catalox: mockWorkspaceCatalox(),
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+        });
+        const res = await fetchMemorixWorkspaceList(client, {
+            page: { limit: 10, offset: 0 },
+        });
+        const scores = res.rows
+            .map((r) => r.priorityScore)
+            .filter((v) => typeof v === "number");
+        if (scores.length >= 2) {
+            expect(scores[0]).toBeGreaterThanOrEqual(scores[1]);
+        }
+    });
+    it("delegates to per-entity list when entityName is set", async () => {
+        const xronoxRead = mockXronox();
+        const client = createMemorixRetrieval({
+            catalox: mockWorkspaceCatalox(),
+            xronox: { read: xronoxRead, readArray: xronoxRead },
+        });
+        const res = await fetchMemorixWorkspaceList(client, {
+            entityName: "assets",
+            page: { limit: 10, offset: 0 },
+        });
+        expect(res.includedEntities).toEqual(["assets"]);
+        expect(res.rows.every((r) => r.entityName === "assets")).toBe(true);
+        expect(res.rows[0]).toMatchObject({
+            entityName: "assets",
+            entityId: "10.0.0.1",
+            ipAddress: "10.0.0.1",
+        });
+    });
+    it("returns empty result when discovery finds no entities", async () => {
+        const client = createMemorixRetrieval({
+            catalox: {
+                getCatalogItem: vi.fn(async (_ctx, catalogId, itemId) => {
+                    if (catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG &&
+                        itemId === DEFAULT_WORKSPACE_LIST_ID) {
+                        return {
+                            outcome: "found",
+                            item: { data: workspaceRecordsList },
+                        };
+                    }
+                    return { outcome: "not_found" };
+                }),
+                listCatalogItems: vi.fn(async () => ({ items: [], hasMore: false })),
+            },
+            xronox: { read: async () => [] },
+        });
+        const res = await fetchMemorixWorkspaceList(client);
+        expect(res.rows).toHaveLength(0);
+        expect(res.discovery.source).toBe("none");
+        expect(res.includedEntities).toEqual([]);
+    });
+});
+describe("workspace list descriptor validation", () => {
+    it("accepts workspace kind", async () => {
+        const { validateMemorixWorkspaceListDescriptor } = await import("../descriptors/validate-descriptor.js");
+        const result = validateMemorixWorkspaceListDescriptor(workspaceRecordsList);
+        expect(result.kind).toBe("workspace");
+        expect(result.id).toBe(DEFAULT_WORKSPACE_LIST_ID);
+    });
+});
+//# sourceMappingURL=fetch-workspace-list.test.js.map