@x12i/memorix-descriptors 1.4.5 → 1.6.0

package/dist/migration/generate-descriptors.js

@@ -0,0 +1,234 @@
+import { COMPLETION_MAPPING_SCHEMA_V2, INVENTORY_POLICY_SCHEMA_V1, ITEM_DESCRIPTOR_SCHEMA_V2, LIST_DESCRIPTOR_SCHEMA_V2, OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2, } from "../types/canonical-v2.js";
+import { allowedIdFieldsForTarget, CANONICAL_OBJECT_TYPE_IDS, CANONICAL_OBJECT_TYPE_SPECS, collectionNameFor, defaultIdFieldForTarget, defaultItemDescriptorIdFor, defaultListDescriptorIdFor, titleCaseFromKebab, } from "./object-type-specs.js";
+function minimalRecordIdProperty(identityPath, contentType) {
+    return {
+        recordId: {
+            label: "Record ID",
+            source: {
+                contentType,
+                path: identityPath,
+            },
+            humanReadable: true,
+            sortable: true,
+            filterable: true,
+            list: true,
+            item: true,
+            valueType: "string",
+        },
+    };
+}
+export function buildObjectTypeDescriptor(spec, identityField = "recordId") {
+    const canonicalContentType = "snapshots";
+    const contentTypes = {};
+    for (const contentType of spec.contentTypes) {
+        contentTypes[contentType] = {
+            postfix: contentType,
+            collection: collectionNameFor(spec.objectType, contentType),
+            dataRoot: "data",
+            isCanonical: contentType === canonicalContentType,
+        };
+    }
+    const identityPath = identityField === "recordId"
+        ? "recordId"
+        : identityField === "_id"
+            ? "_id"
+            : identityField;
+    return {
+        schemaVersion: OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2,
+        id: spec.objectType,
+        objectType: spec.objectType,
+        target: spec.target,
+        collectionPrefix: spec.objectType,
+        defaultListDescriptorId: defaultListDescriptorIdFor(spec.objectType),
+        defaultItemDescriptorId: defaultItemDescriptorIdFor(spec.objectType),
+        identity: {
+            allowedIdFields: allowedIdFieldsForTarget(spec.target),
+            requiredExactlyOne: false,
+            defaultIdField: defaultIdFieldForTarget(spec.target),
+        },
+        defaults: {
+            canonicalContentType,
+            dataRoot: "data",
+            effectiveDatePath: "capturedAt",
+            fallbackEffectiveDatePaths: ["modifiedAt", "createdAt"],
+        },
+        contentTypes,
+        properties: minimalRecordIdProperty(identityPath, canonicalContentType),
+        relations: {},
+    };
+}
+export function buildObjectListDescriptor(spec) {
+    return {
+        schemaVersion: LIST_DESCRIPTOR_SCHEMA_V2,
+        id: defaultListDescriptorIdFor(spec.objectType),
+        kind: "object-list",
+        title: titleCaseFromKebab(spec.objectType),
+        objectType: spec.objectType,
+        leadingContentType: "snapshots",
+        fields: ["recordId"],
+        pagination: {
+            enabled: true,
+            defaultLimit: 50,
+            maxLimit: 200,
+        },
+        defaultSort: {
+            property: "recordId",
+            direction: "asc",
+        },
+    };
+}
+export function buildWorkspaceListDescriptor(objectTypes) {
+    return {
+        schemaVersion: LIST_DESCRIPTOR_SCHEMA_V2,
+        id: "memorix-workspace-records-list",
+        kind: "workspace",
+        title: "Workspace records",
+        objectTypes,
+        fields: [
+            "objectType",
+            "recordTitle",
+            "recordId",
+            "target",
+            "source",
+            "lastUpdated",
+            "status",
+        ],
+        pagination: {
+            enabled: true,
+            defaultLimit: 50,
+            maxLimit: 200,
+        },
+    };
+}
+export function buildCriticalVulnerabilitiesSlice() {
+    return {
+        schemaVersion: LIST_DESCRIPTOR_SCHEMA_V2,
+        id: "critical-vulnerabilities-slice",
+        kind: "slice",
+        title: "Critical vulnerabilities",
+        objectType: "vulnerabilities",
+        target: "event",
+        contentType: "snapshots",
+        fields: ["recordId"],
+        filter: {
+            mode: "basic",
+            combinator: "and",
+            rules: [],
+        },
+        sort: [
+            {
+                path: "capturedAt",
+                direction: "desc",
+            },
+        ],
+        defaultItemDescriptorId: "vulnerability-detail-item",
+        pagination: {
+            enabled: true,
+            defaultLimit: 50,
+            maxLimit: 200,
+        },
+    };
+}
+export function buildItemDescriptor(spec) {
+    return {
+        schemaVersion: ITEM_DESCRIPTOR_SCHEMA_V2,
+        id: defaultItemDescriptorIdFor(spec.objectType),
+        title: `${titleCaseFromKebab(spec.objectType)} detail`,
+        objectType: spec.objectType,
+        identity: {
+            idField: defaultIdFieldForTarget(spec.target),
+        },
+        contentTypes: [
+            {
+                contentType: "snapshots",
+                required: true,
+                multiMatch: {
+                    strategy: "last",
+                    effectiveDatePath: "capturedAt",
+                },
+            },
+        ],
+        sections: [
+            {
+                id: "summary",
+                title: "Summary",
+                fields: ["recordId"],
+            },
+            {
+                id: "raw",
+                title: "Raw data",
+                fields: [],
+            },
+        ],
+        includeRelations: [],
+    };
+}
+export function buildDefaultInventoryPolicy() {
+    return {
+        schemaVersion: INVENTORY_POLICY_SCHEMA_V1,
+        id: "default",
+        ignoredCollections: [],
+    };
+}
+export function migrateCompletionMappingToV2(raw) {
+    if (raw.schemaVersion === COMPLETION_MAPPING_SCHEMA_V2 && raw.objectType) {
+        return raw;
+    }
+    const objectType = String(raw.objectType ?? raw.entityType ?? "");
+    if (!objectType)
+        return null;
+    return {
+        schemaVersion: COMPLETION_MAPPING_SCHEMA_V2,
+        id: raw.id,
+        name: raw.name,
+        objectType,
+        target: raw.target,
+        targetCollection: raw.targetCollection,
+        targetSelector: raw.targetSelector,
+        source: raw.source,
+        match: raw.match,
+        writeRoot: raw.writeRoot ?? "data",
+        fields: raw.fields ?? [],
+        onlyFillMissing: raw.onlyFillMissing,
+        overwriteExisting: raw.overwriteExisting,
+    };
+}
+export function buildCanonicalDescriptorSet(options = {}) {
+    const objectTypes = {};
+    const lists = {};
+    const items = {};
+    for (const spec of CANONICAL_OBJECT_TYPE_SPECS) {
+        const identityField = options.identityFieldByObjectType?.[spec.objectType] ?? "recordId";
+        objectTypes[spec.objectType] = buildObjectTypeDescriptor(spec, identityField);
+        lists[defaultListDescriptorIdFor(spec.objectType)] = buildObjectListDescriptor(spec);
+        items[defaultItemDescriptorIdFor(spec.objectType)] = buildItemDescriptor(spec);
+    }
+    lists["memorix-workspace-records-list"] = buildWorkspaceListDescriptor(CANONICAL_OBJECT_TYPE_IDS);
+    lists["critical-vulnerabilities-slice"] = buildCriticalVulnerabilitiesSlice();
+    const completionMappings = {};
+    for (const raw of options.preserveCompletionMappings ?? []) {
+        const migrated = migrateCompletionMappingToV2(raw);
+        if (migrated?.id) {
+            completionMappings[String(migrated.id)] = migrated;
+        }
+    }
+    return {
+        objectTypes,
+        lists,
+        items,
+        inventoryPolicy: buildDefaultInventoryPolicy(),
+        completionMappings,
+    };
+}
+export function expectedCollectionsForSpecs(specs = CANONICAL_OBJECT_TYPE_SPECS) {
+    const byTarget = new Map();
+    for (const spec of specs) {
+        const set = byTarget.get(spec.target) ?? new Set();
+        for (const contentType of spec.contentTypes) {
+            set.add(collectionNameFor(spec.objectType, contentType));
+        }
+        byTarget.set(spec.target, set);
+    }
+    return byTarget;
+}
+//# sourceMappingURL=generate-descriptors.js.map

package/dist/migration/generate-descriptors.js.map

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

package/dist/migration/index.d.ts

@@ -0,0 +1,13 @@
+export { buildMemorixCataloxMetadataFixPlan, } from "./plan.js";
+export { inspectMemorixCataloxMetadata, type InspectMemorixMetadataOptions, } from "./inspect.js";
+export { validateMemorixCataloxMetadataFixPlan, readMemorixCataloxMetadataFixPlan, } from "./validate-plan.js";
+export { applyMemorixCataloxMetadataFixPlan, cleanupLegacyMemorixCataloxMetadata, } from "./apply.js";
+export { exportMemorixMetadataBackup } from "./backup.js";
+export { verifyMemorixCataloxMetadata } from "./verify.js";
+export { resetMemorixCataloxMetadata } from "./reset.js";
+export { loadCanonicalMemorixCatalogSnapshot, loadAllMemorixCatalogItems, } from "./load-snapshot.js";
+export { loadMongoInventory } from "./mongo-inventory.js";
+export { buildCanonicalDescriptorSet, buildObjectTypeDescriptor, } from "./generate-descriptors.js";
+export { CANONICAL_OBJECT_TYPE_SPECS, CANONICAL_OBJECT_TYPE_IDS, } from "./object-type-specs.js";
+export type { MemorixCataloxMetadataFixPlan, MemorixMetadataInspectionReport, MemorixMetadataMigrationConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/migration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,GACnC,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qCAAqC,EACrC,iCAAiC,GAClC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,mCAAmC,EACnC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/migration/index.js

@@ -0,0 +1,12 @@
+export { buildMemorixCataloxMetadataFixPlan, } from "./plan.js";
+export { inspectMemorixCataloxMetadata, } from "./inspect.js";
+export { validateMemorixCataloxMetadataFixPlan, readMemorixCataloxMetadataFixPlan, } from "./validate-plan.js";
+export { applyMemorixCataloxMetadataFixPlan, cleanupLegacyMemorixCataloxMetadata, } from "./apply.js";
+export { exportMemorixMetadataBackup } from "./backup.js";
+export { verifyMemorixCataloxMetadata } from "./verify.js";
+export { resetMemorixCataloxMetadata } from "./reset.js";
+export { loadCanonicalMemorixCatalogSnapshot, loadAllMemorixCatalogItems, } from "./load-snapshot.js";
+export { loadMongoInventory } from "./mongo-inventory.js";
+export { buildCanonicalDescriptorSet, buildObjectTypeDescriptor, } from "./generate-descriptors.js";
+export { CANONICAL_OBJECT_TYPE_SPECS, CANONICAL_OBJECT_TYPE_IDS, } from "./object-type-specs.js";
+//# sourceMappingURL=index.js.map

package/dist/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,GACnC,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,6BAA6B,GAE9B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,qCAAqC,EACrC,iCAAiC,GAClC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EACL,mCAAmC,EACnC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC"}

package/dist/migration/inspect.d.ts

@@ -0,0 +1,9 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { MemorixMetadataInspectionReport } from "./types.js";
+export type InspectMemorixMetadataOptions = {
+    appId?: string;
+    env?: NodeJS.ProcessEnv;
+    includeMongo?: boolean;
+};
+export declare function inspectMemorixCataloxMetadata(catalox: CataloxBoundClient, options?: InspectMemorixMetadataOptions): Promise<MemorixMetadataInspectionReport>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/migration/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/migration/inspect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAS/D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,+BAA+B,CAAC,CA4D1C"}

package/dist/migration/inspect.js

@@ -0,0 +1,57 @@
+import { resolveMemorixAppId } from "../catalog/ids.js";
+import { classifyMemorixCatalog, countContamination, detectLegacyFields, detectNamingConflicts, } from "./classify.js";
+import { loadAllMemorixCatalogItems } from "./load-snapshot.js";
+import { loadMongoInventory } from "./mongo-inventory.js";
+export async function inspectMemorixCataloxMetadata(catalox, options = {}) {
+    const env = options.env ?? process.env;
+    const appId = resolveMemorixAppId({ appId: options.appId }, env);
+    const snapshot = await loadAllMemorixCatalogItems(catalox, { appId });
+    const generatedAt = new Date().toISOString();
+    const catalogs = Object.entries(snapshot.catalogs).map(([catalogId, items]) => {
+        const legacyFieldHits = items.flatMap((item) => detectLegacyFields(item.data));
+        const contaminationCount = items.reduce((sum, item) => sum + countContamination(item.data), 0);
+        return {
+            catalogId,
+            classification: classifyMemorixCatalog(catalogId),
+            itemCount: items.length,
+            itemIds: items.map((item) => item.id),
+            contaminationCount,
+            legacyFieldHits,
+            namingConflicts: detectNamingConflicts(items.map((item) => item.id)),
+        };
+    });
+    const listItems = snapshot.catalogs["memorix-list-descriptors"] ?? [];
+    const listIds = listItems.map((item) => item.id);
+    let mongo;
+    if (options.includeMongo !== false) {
+        const inventory = await loadMongoInventory(env);
+        mongo = {
+            connected: inventory.connected,
+            entityCollections: inventory.entityCollections,
+            eventCollections: inventory.eventCollections,
+            knowledgeCollections: inventory.knowledgeCollections,
+            unmatchedCollections: inventory.unmatchedCollections,
+        };
+    }
+    return {
+        version: "memorix.metadataInspection.v1",
+        generatedAt,
+        appId,
+        catalogs,
+        mongo,
+        references: {
+            variabilitiesGroupsPresent: catalogs.some((catalog) => catalog.itemIds.includes("variabilities-groups")),
+            criticalVulnerabilitiesListPresent: listIds.includes("critical-vulnerabilities-list"),
+            criticalVulnerabilitiesSlicePresent: listIds.includes("critical-vulnerabilities-slice"),
+        },
+        environmentSummary: {
+            CATALOX_APP_ID: env.CATALOX_APP_ID,
+            MEMORIX_APP_ID: env.MEMORIX_APP_ID,
+            MEMORIX_ENTITIES_DB: env.MEMORIX_ENTITIES_DB,
+            MEMORIX_EVENTS_DB: env.MEMORIX_EVENTS_DB,
+            MEMORIX_KNOWLEDGE_DB: env.MEMORIX_KNOWLEDGE_DB,
+            MONGO_URI: env.MONGO_URI ? "[set]" : undefined,
+        },
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/migration/inspect.js.map

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

package/dist/migration/load-snapshot.d.ts

@@ -0,0 +1,15 @@
+import { type CataloxBoundClient } from "../catalox/client.js";
+import type { CanonicalMemorixCatalogSnapshot } from "../types/canonical-v2.js";
+import type { CanonicalSnapshotLoadOptions } from "./types.js";
+export declare function listMemorixRelatedCatalogIds(catalox: CataloxBoundClient): Promise<string[]>;
+export declare function loadCanonicalMemorixCatalogSnapshot(catalox: CataloxBoundClient, options?: CanonicalSnapshotLoadOptions): Promise<CanonicalMemorixCatalogSnapshot>;
+export declare function loadAllMemorixCatalogItems(catalox: CataloxBoundClient, options?: CanonicalSnapshotLoadOptions): Promise<CanonicalMemorixCatalogSnapshot>;
+export declare function inventoryPolicyItems(snapshot: CanonicalMemorixCatalogSnapshot): Array<{
+    id: string;
+    data: Record<string, unknown>;
+}>;
+export declare function defaultInventoryPolicyItem(snapshot: CanonicalMemorixCatalogSnapshot): {
+    id: string;
+    data: Record<string, unknown>;
+} | undefined;
+//# sourceMappingURL=load-snapshot.d.ts.map

package/dist/migration/load-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-snapshot.d.ts","sourceRoot":"","sources":["../../src/migration/load-snapshot.ts"],"names":[],"mappings":"AAcA,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAc/D,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,+BAA+B,CAAC,CA2C1C;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,+BAA+B,CAAC,CAO1C;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,+BAA+B,GACxC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAEtD;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,+BAA+B,GACxC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,CAE3D"}

package/dist/migration/load-snapshot.js

@@ -0,0 +1,83 @@
+import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, PARALLEL_KNOWLEDGE_CATALOG, resolveMemorixAppId, } from "../catalog/ids.js";
+import { listAllCatalogItems } from "../catalox/client.js";
+const KNOWN_CATALOG_IDS = [
+    MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+    MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+    MEMORIX_LIST_DESCRIPTORS_CATALOG,
+    MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+    MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+    MEMORIX_INVENTORY_POLICIES_CATALOG,
+    LEGACY_SCHEMA_INFERENCE_CATALOG,
+    LEGACY_GLOBAL_CONTENT_TYPE_CATALOG,
+    PARALLEL_KNOWLEDGE_CATALOG,
+];
+export async function listMemorixRelatedCatalogIds(catalox) {
+    const discovered = new Set(KNOWN_CATALOG_IDS);
+    try {
+        const listCatalogs = catalox.listCatalogs;
+        if (listCatalogs) {
+            const page = await listCatalogs({ limit: 500 });
+            for (const catalog of page.catalogs ?? []) {
+                const catalogId = String(catalog.catalogId ?? catalog.id ?? "").trim();
+                if (catalogId)
+                    discovered.add(catalogId);
+            }
+        }
+    }
+    catch {
+        // optional API
+    }
+    return [...discovered];
+}
+export async function loadCanonicalMemorixCatalogSnapshot(catalox, options = {}) {
+    const appId = resolveMemorixAppId({ appId: options.appId });
+    const includeLegacy = options.includeLegacy ?? true;
+    const includeParallel = options.includeParallel ?? true;
+    const includeAllKnown = options.includeAllKnown ?? true;
+    const catalogIds = includeAllKnown
+        ? await listMemorixRelatedCatalogIds(catalox)
+        : [...MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS];
+    const filtered = catalogIds.filter((catalogId) => {
+        if (!includeLegacy) {
+            if (catalogId === LEGACY_SCHEMA_INFERENCE_CATALOG ||
+                catalogId === LEGACY_GLOBAL_CONTENT_TYPE_CATALOG ||
+                catalogId === MEMORIX_ENTITY_DESCRIPTORS_CATALOG) {
+                return false;
+            }
+        }
+        if (!includeParallel && catalogId === PARALLEL_KNOWLEDGE_CATALOG) {
+            return false;
+        }
+        return true;
+    });
+    const catalogs = {};
+    for (const catalogId of filtered) {
+        const items = await listAllCatalogItems(catalox, catalogId);
+        if (items.length === 0 && !MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS.includes(catalogId)) {
+            continue;
+        }
+        catalogs[catalogId] = items.map((item) => ({
+            id: item.id,
+            data: item.data,
+        }));
+    }
+    if (!catalogs[MEMORIX_INVENTORY_POLICIES_CATALOG]) {
+        catalogs[MEMORIX_INVENTORY_POLICIES_CATALOG] = [];
+    }
+    return { appId, catalogs };
+}
+export async function loadAllMemorixCatalogItems(catalox, options = {}) {
+    return loadCanonicalMemorixCatalogSnapshot(catalox, {
+        ...options,
+        includeLegacy: true,
+        includeParallel: true,
+        includeAllKnown: true,
+    });
+}
+export function inventoryPolicyItems(snapshot) {
+    return snapshot.catalogs[MEMORIX_INVENTORY_POLICIES_CATALOG] ?? [];
+}
+export function defaultInventoryPolicyItem(snapshot) {
+    return inventoryPolicyItems(snapshot).find((item) => item.id === MEMORIX_INVENTORY_POLICY_ITEM_ID);
+}
+//# sourceMappingURL=load-snapshot.js.map

package/dist/migration/load-snapshot.js.map

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

package/dist/migration/mongo-inventory.d.ts

@@ -0,0 +1,20 @@
+import type { MemorixTarget } from "../types/index.js";
+export type MongoInventoryReport = {
+    connected: boolean;
+    error?: string;
+    entityCollections: string[];
+    eventCollections: string[];
+    knowledgeCollections: string[];
+    unmatchedCollections: Array<{
+        target: MemorixTarget;
+        collection: string;
+    }>;
+    variabilitiesGroupsSnapshotExists: boolean;
+    vulnerabilitiesGroupsSnapshotExists: boolean;
+};
+export declare function loadMongoInventory(env?: NodeJS.ProcessEnv): Promise<MongoInventoryReport>;
+export declare function parseObjectTypeFromCollection(collection: string): {
+    objectType: string;
+    contentType: string;
+} | null;
+//# sourceMappingURL=mongo-inventory.d.ts.map

package/dist/migration/mongo-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-inventory.d.ts","sourceRoot":"","sources":["../../src/migration/mongo-inventory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,oBAAoB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,iCAAiC,EAAE,OAAO,CAAC;IAC3C,mCAAmC,EAAE,OAAO,CAAC;CAC9C,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,oBAAoB,CAAC,CA+D/B;AA2BD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAOP"}

package/dist/migration/mongo-inventory.js

@@ -0,0 +1,95 @@
+import { MongoClient } from "mongodb";
+import { parseMemorixCollectionName } from "../collections/parse.js";
+import { resolveMemorixDbName, resolveMongoUri } from "../collections/mongo-env.js";
+import { CANONICAL_OBJECT_TYPE_SPECS, collectionNameFor, } from "./object-type-specs.js";
+export async function loadMongoInventory(env = process.env) {
+    const empty = {
+        connected: false,
+        entityCollections: [],
+        eventCollections: [],
+        knowledgeCollections: [],
+        unmatchedCollections: [],
+        variabilitiesGroupsSnapshotExists: false,
+        vulnerabilitiesGroupsSnapshotExists: false,
+    };
+    let uri;
+    try {
+        uri = resolveMongoUri(env);
+    }
+    catch (err) {
+        return {
+            ...empty,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    const client = new MongoClient(uri);
+    try {
+        await client.connect();
+        const entityDb = resolveMemorixDbName("entity", env);
+        const eventDb = resolveMemorixDbName("event", env);
+        const knowledgeDb = resolveMemorixDbName("knowledge", env);
+        const entityCollections = await listDbCollections(client, entityDb);
+        const eventCollections = await listDbCollections(client, eventDb);
+        const knowledgeCollections = await listDbCollections(client, knowledgeDb);
+        const expected = new Map();
+        for (const spec of CANONICAL_OBJECT_TYPE_SPECS) {
+            const set = expected.get(spec.target) ?? new Set();
+            for (const contentType of spec.contentTypes) {
+                set.add(collectionNameFor(spec.objectType, contentType));
+            }
+            expected.set(spec.target, set);
+        }
+        const unmatchedCollections = [];
+        collectUnmatched("entity", entityCollections, expected.get("entity") ?? new Set(), unmatchedCollections);
+        collectUnmatched("event", eventCollections, expected.get("event") ?? new Set(), unmatchedCollections);
+        return {
+            connected: true,
+            entityCollections,
+            eventCollections,
+            knowledgeCollections,
+            unmatchedCollections,
+            variabilitiesGroupsSnapshotExists: entityCollections.includes("variabilities-groups-snapshots"),
+            vulnerabilitiesGroupsSnapshotExists: entityCollections.includes("vulnerabilities-groups-snapshots"),
+        };
+    }
+    catch (err) {
+        return {
+            ...empty,
+            connected: true,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        await client.close().catch(() => undefined);
+    }
+}
+async function listDbCollections(client, dbName) {
+    try {
+        const db = client.db(dbName);
+        const collections = await db.listCollections({}, { nameOnly: true }).toArray();
+        return collections.map((entry) => String(entry.name)).sort();
+    }
+    catch {
+        return [];
+    }
+}
+function collectUnmatched(target, collections, expected, out) {
+    for (const collection of collections) {
+        if (expected.has(collection))
+            continue;
+        const parsed = parseMemorixCollectionName(collection);
+        if (parsed.parseStatus === "parsed") {
+            out.push({ target, collection });
+        }
+    }
+}
+export function parseObjectTypeFromCollection(collection) {
+    const parsed = parseMemorixCollectionName(collection);
+    if (parsed.parseStatus !== "parsed")
+        return null;
+    return {
+        objectType: parsed.objectName,
+        contentType: parsed.contentType,
+    };
+}
+//# sourceMappingURL=mongo-inventory.js.map

package/dist/migration/mongo-inventory.js.map

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

package/dist/migration/object-type-specs.d.ts

@@ -0,0 +1,17 @@
+import type { MemorixTarget } from "../types/index.js";
+export type CanonicalObjectTypeSpec = {
+    objectType: string;
+    target: MemorixTarget;
+    contentTypes: string[];
+};
+/** Canonical object types for the Memorix metadata reset. */
+export declare const CANONICAL_OBJECT_TYPE_SPECS: CanonicalObjectTypeSpec[];
+export declare const CANONICAL_OBJECT_TYPE_IDS: string[];
+export declare function collectionNameFor(objectType: string, contentType: string): string;
+export declare function titleCaseFromKebab(value: string): string;
+export declare function singularizeObjectType(objectType: string): string;
+export declare function defaultListDescriptorIdFor(objectType: string): string;
+export declare function defaultItemDescriptorIdFor(objectType: string): string;
+export declare function defaultIdFieldForTarget(target: MemorixTarget): "entityId" | "eventId" | "knowledgeId";
+export declare function allowedIdFieldsForTarget(target: MemorixTarget): Array<"entityId" | "eventId" | "knowledgeId" | "recordId" | "_id">;
+//# sourceMappingURL=object-type-specs.d.ts.map

package/dist/migration/object-type-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-type-specs.d.ts","sourceRoot":"","sources":["../../src/migration/object-type-specs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,EAAE,uBAAuB,EAkBhE,CAAC;AAEF,eAAO,MAAM,yBAAyB,UAErC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWhE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAIrG;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,GACpB,KAAK,CAAC,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,KAAK,CAAC,CAIpE"}