@x12i/memorix-descriptors 1.4.2 → 1.5.0

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":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAahC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,KAAK,GAAyB;QAClC,SAAS,EAAE,KAAK;QAChB,iBAAiB,EAAE,EAAE;QACrB,gBAAgB,EAAE,EAAE;QACpB,oBAAoB,EAAE,EAAE;QACxB,oBAAoB,EAAE,EAAE;QACxB,iCAAiC,EAAE,KAAK;QACxC,mCAAmC,EAAE,KAAK;KAC3C,CAAC;IAEF,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,GAAG,KAAK;YACR,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG,oBAAoB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAE3D,MAAM,iBAAiB,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpE,MAAM,gBAAgB,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,oBAAoB,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAE1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;QACvD,KAAK,MAAM,IAAI,IAAI,2BAA2B,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YAC3D,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC5C,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;YAC3D,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,oBAAoB,GAAyD,EAAE,CAAC;QACtF,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;QACzG,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAEtG,OAAO;YACL,SAAS,EAAE,IAAI;YACf,iBAAiB;YACjB,gBAAgB;YAChB,oBAAoB;YACpB,oBAAoB;YACpB,iCAAiC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YAC/F,mCAAmC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SACpG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,GAAG,KAAK;YACR,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,MAAmB,EAAE,MAAc;IAClE,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/E,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAqB,EACrB,WAAqB,EACrB,QAAqB,EACrB,GAAyD;IAEzD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACvC,MAAM,MAAM,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,UAAkB;IAI9D,MAAM,MAAM,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC"}

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,EAahE,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"}

package/dist/migration/object-type-specs.js

@@ -0,0 +1,58 @@
+/** Canonical object types for the Memorix metadata reset. */
+export const CANONICAL_OBJECT_TYPE_SPECS = [
+    { objectType: "assets", target: "entity", contentTypes: ["snapshots", "scoped"] },
+    { objectType: "subnets", target: "entity", contentTypes: ["snapshots", "scoped"] },
+    {
+        objectType: "topology-cidr-graphs",
+        target: "entity",
+        contentTypes: ["snapshots", "scoped"],
+    },
+    { objectType: "topology-subnets", target: "entity", contentTypes: ["snapshots"] },
+    { objectType: "topology-vrs", target: "entity", contentTypes: ["snapshots"] },
+    { objectType: "topology-zones", target: "entity", contentTypes: ["snapshots"] },
+    { objectType: "vulnerabilities-groups", target: "entity", contentTypes: ["snapshots"] },
+    { objectType: "vulnerabilities", target: "event", contentTypes: ["snapshots", "scoped"] },
+];
+export const CANONICAL_OBJECT_TYPE_IDS = CANONICAL_OBJECT_TYPE_SPECS.map((spec) => spec.objectType);
+export function collectionNameFor(objectType, contentType) {
+    return `${objectType}-${contentType}`;
+}
+export function titleCaseFromKebab(value) {
+    return value
+        .split("-")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+export function singularizeObjectType(objectType) {
+    if (objectType.endsWith("-groups")) {
+        return `${objectType.slice(0, -1)}`;
+    }
+    if (objectType.endsWith("ies")) {
+        return `${objectType.slice(0, -3)}y`;
+    }
+    if (objectType.endsWith("s") && !objectType.endsWith("ss")) {
+        return objectType.slice(0, -1);
+    }
+    return objectType;
+}
+export function defaultListDescriptorIdFor(objectType) {
+    return `${objectType}-main-list`;
+}
+export function defaultItemDescriptorIdFor(objectType) {
+    return `${singularizeObjectType(objectType)}-detail-item`;
+}
+export function defaultIdFieldForTarget(target) {
+    if (target === "event")
+        return "eventId";
+    if (target === "knowledge")
+        return "knowledgeId";
+    return "entityId";
+}
+export function allowedIdFieldsForTarget(target) {
+    if (target === "event")
+        return ["eventId", "recordId", "_id"];
+    if (target === "knowledge")
+        return ["knowledgeId", "recordId", "_id"];
+    return ["entityId", "recordId", "_id"];
+}
+//# sourceMappingURL=object-type-specs.js.map

package/dist/migration/object-type-specs.js.map

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

package/dist/migration/plan.d.ts

@@ -0,0 +1,4 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { MemorixCataloxMetadataFixPlan, MemorixMetadataMigrationConfig } from "./types.js";
+export declare function buildMemorixCataloxMetadataFixPlan(catalox: CataloxBoundClient, config?: MemorixMetadataMigrationConfig): Promise<MemorixCataloxMetadataFixPlan>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/migration/plan.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAepB,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,kBAAkB,EAC3B,MAAM,GAAE,8BAAmC,GAC1C,OAAO,CAAC,6BAA6B,CAAC,CA8IxC"}

package/dist/migration/plan.js

@@ -0,0 +1,136 @@
+import { resolveMemorixAppId } from "../catalog/ids.js";
+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, PARALLEL_KNOWLEDGE_CATALOG, } from "../catalog/ids.js";
+import { buildCanonicalDescriptorSet, migrateCompletionMappingToV2 } from "./generate-descriptors.js";
+import { inspectMemorixCataloxMetadata } from "./inspect.js";
+import { loadAllMemorixCatalogItems } from "./load-snapshot.js";
+import { loadMongoInventory } from "./mongo-inventory.js";
+const LEGACY_ITEM_IDS = [
+    "variabilities-groups",
+    "variabilities-group-detail-item",
+    "variabilities-groups-main-list",
+    "critical-vulnerabilities-list",
+];
+const LEGACY_CATALOGS_TO_DELETE = [
+    MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+    LEGACY_SCHEMA_INFERENCE_CATALOG,
+    LEGACY_GLOBAL_CONTENT_TYPE_CATALOG,
+];
+export async function buildMemorixCataloxMetadataFixPlan(catalox, config = {}) {
+    const env = process.env;
+    const appId = resolveMemorixAppId({ appId: config.appId }, env);
+    const inspection = await inspectMemorixCataloxMetadata(catalox, { appId, env });
+    const snapshot = await loadAllMemorixCatalogItems(catalox, { appId });
+    const mongo = await loadMongoInventory(env);
+    const blockedQuestions = [];
+    const warnings = [];
+    if (!config.knowledgeCatalogPolicy) {
+        const knowledgeItems = snapshot.catalogs[PARALLEL_KNOWLEDGE_CATALOG] ?? [];
+        if (knowledgeItems.length > 0) {
+            blockedQuestions.push({
+                key: "knowledgeCatalogPolicy",
+                question: "The catalog `knowledge` exists but is not a descriptor catalog. Should it be left untouched or moved out of app `memorix`?",
+                required: true,
+                options: ["leave-untouched", "move-out-of-memorix", "delete"],
+            });
+        }
+    }
+    if (mongo.connected && mongo.variabilitiesGroupsSnapshotExists && !mongo.vulnerabilitiesGroupsSnapshotExists) {
+        blockedQuestions.push({
+            key: "vulnerabilityGroupsCanonicalName",
+            question: "Mongo contains variabilities-groups-snapshots but not vulnerabilities-groups-snapshots. Confirm canonical object type naming.",
+            required: true,
+            options: ["vulnerabilities-groups", "variabilities-groups"],
+        });
+    }
+    if (mongo.connected && !mongo.vulnerabilitiesGroupsSnapshotExists) {
+        warnings.push("vulnerabilities-groups-snapshots collection was not found in entity DB; descriptor will still be planned from canonical spec.");
+    }
+    const preserveMappings = (snapshot.catalogs[MEMORIX_COMPLETION_MAPPINGS_CATALOG] ?? [])
+        .map((item) => migrateCompletionMappingToV2(item.data))
+        .filter((item) => item !== null);
+    const generated = buildCanonicalDescriptorSet({
+        preserveCompletionMappings: preserveMappings,
+    });
+    const upsertItems = [];
+    const deleteItems = [];
+    upsertItems.push(...Object.entries(generated.objectTypes).map(([itemId, data]) => ({
+        catalogId: MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+        itemId,
+        data,
+    })));
+    upsertItems.push(...Object.entries(generated.lists).map(([itemId, data]) => ({
+        catalogId: MEMORIX_LIST_DESCRIPTORS_CATALOG,
+        itemId,
+        data,
+    })));
+    upsertItems.push(...Object.entries(generated.items).map(([itemId, data]) => ({
+        catalogId: MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+        itemId,
+        data,
+    })));
+    upsertItems.push(...Object.entries(generated.completionMappings).map(([itemId, data]) => ({
+        catalogId: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+        itemId,
+        data,
+    })));
+    upsertItems.push({
+        catalogId: MEMORIX_INVENTORY_POLICIES_CATALOG,
+        itemId: MEMORIX_INVENTORY_POLICY_ITEM_ID,
+        data: generated.inventoryPolicy,
+    });
+    for (const catalogId of Object.keys(snapshot.catalogs)) {
+        for (const item of snapshot.catalogs[catalogId] ?? []) {
+            if (LEGACY_ITEM_IDS.includes(item.id)) {
+                deleteItems.push({ catalogId, itemId: item.id });
+            }
+            const contamination = item.data.framework || item.data.canvas || item.data.nodes;
+            if (contamination &&
+                [
+                    MEMORIX_LIST_DESCRIPTORS_CATALOG,
+                    MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+                    MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+                    MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+                    MEMORIX_INVENTORY_POLICIES_CATALOG,
+                ].includes(catalogId)) {
+                deleteItems.push({ catalogId, itemId: item.id });
+                warnings.push(`Marked contaminated item ${catalogId}/${item.id} for deletion.`);
+            }
+        }
+    }
+    for (const catalogId of LEGACY_CATALOGS_TO_DELETE) {
+        for (const item of snapshot.catalogs[catalogId] ?? []) {
+            deleteItems.push({ catalogId, itemId: item.id });
+        }
+    }
+    if (inspection.references.criticalVulnerabilitiesListPresent) {
+        deleteItems.push({
+            catalogId: MEMORIX_LIST_DESCRIPTORS_CATALOG,
+            itemId: "critical-vulnerabilities-list",
+        });
+    }
+    return {
+        version: "memorix.cataloxMetadataFixPlan.v1",
+        appId,
+        mode: "breaking-reset",
+        createCatalogs: [
+            {
+                catalogId: MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+                name: "Memorix object type descriptors",
+            },
+            {
+                catalogId: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+                name: "Memorix completion mappings",
+            },
+            {
+                catalogId: MEMORIX_INVENTORY_POLICIES_CATALOG,
+                name: "Memorix inventory policies",
+            },
+        ],
+        upsertItems,
+        deleteItems,
+        deleteCatalogs: LEGACY_CATALOGS_TO_DELETE,
+        blockedQuestions,
+        warnings,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/migration/plan.js.map

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

package/dist/migration/reset.d.ts

@@ -0,0 +1,17 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { MemorixMetadataMigrationConfig } from "./types.js";
+export type ResetMemorixMetadataOptions = MemorixMetadataMigrationConfig & {
+    confirmBreakingReset?: boolean;
+    confirmDeleteLegacy?: boolean;
+    catalox?: CataloxBoundClient;
+};
+export type ResetMemorixMetadataResult = {
+    ok: boolean;
+    steps: Array<{
+        step: string;
+        ok: boolean;
+        detail?: string;
+    }>;
+};
+export declare function resetMemorixCataloxMetadata(options?: ResetMemorixMetadataOptions): Promise<ResetMemorixMetadataResult>;
+//# sourceMappingURL=reset.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../src/migration/reset.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ/D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,GAAG;IACzE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D,CAAC;AAkBF,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CA8DrC"}

package/dist/migration/reset.js

@@ -0,0 +1,73 @@
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createMemorixDescriptorAdminFromEnv } from "../admin/create-admin.js";
+import { applyMemorixCataloxMetadataFixPlan, cleanupLegacyMemorixCataloxMetadata, } from "./apply.js";
+import { exportMemorixMetadataBackup } from "./backup.js";
+import { inspectMemorixCataloxMetadata } from "./inspect.js";
+import { buildMemorixCataloxMetadataFixPlan } from "./plan.js";
+import { validateMemorixCataloxMetadataFixPlan } from "./validate-plan.js";
+import { verifyMemorixCataloxMetadata } from "./verify.js";
+function resolveConfig(config) {
+    return {
+        appId: config.appId ?? process.env.MEMORIX_APP_ID ?? process.env.CATALOX_APP_ID,
+        knowledgeCatalogPolicy: config.knowledgeCatalogPolicy ??
+            process.env.MEMORIX_METADATA_KNOWLEDGE_CATALOG_POLICY,
+        propertyGenerationDepth: config.propertyGenerationDepth ??
+            process.env.MEMORIX_METADATA_PROPERTY_DEPTH ??
+            "minimal",
+        planFile: config.planFile,
+        backupDir: config.backupDir,
+        outputDir: config.outputDir ?? process.cwd(),
+    };
+}
+export async function resetMemorixCataloxMetadata(options = {}) {
+    const steps = [];
+    const config = resolveConfig(options);
+    const env = process.env;
+    const admin = options.catalox
+        ? { catalox: options.catalox }
+        : await createMemorixDescriptorAdminFromEnv({ skipXronox: true, appId: config.appId, processEnv: env });
+    const catalox = admin.catalox;
+    const outputDir = config.outputDir ?? process.cwd();
+    const inspection = await inspectMemorixCataloxMetadata(catalox, { appId: config.appId });
+    await writeFile(join(outputDir, "memorix-metadata-inspection.json"), JSON.stringify(inspection, null, 2));
+    steps.push({ step: "inspect", ok: true });
+    const plan = await buildMemorixCataloxMetadataFixPlan(catalox, config);
+    const planPath = join(outputDir, "memorix-catalox-metadata-fix.plan.json");
+    await writeFile(planPath, JSON.stringify(plan, null, 2));
+    steps.push({ step: "plan", ok: plan.blockedQuestions.length === 0, detail: planPath });
+    const planValidation = await validateMemorixCataloxMetadataFixPlan(plan, { planPath });
+    steps.push({ step: "validate-plan", ok: planValidation.ok });
+    if (!planValidation.ok || plan.blockedQuestions.length > 0) {
+        return { ok: false, steps };
+    }
+    const backupDir = await exportMemorixMetadataBackup(catalox, {
+        backupDir: config.backupDir,
+        appId: config.appId,
+        plan,
+    });
+    steps.push({ step: "backup", ok: true, detail: backupDir });
+    const applyResult = await applyMemorixCataloxMetadataFixPlan(catalox, plan, {
+        confirmBreakingReset: options.confirmBreakingReset,
+        backupDir: config.backupDir,
+    });
+    steps.push({ step: "apply", ok: applyResult.ok, detail: applyResult.errors.join("; ") || undefined });
+    if (!applyResult.ok) {
+        return { ok: false, steps };
+    }
+    const cleanupResult = await cleanupLegacyMemorixCataloxMetadata(catalox, plan, {
+        confirmDeleteLegacy: options.confirmDeleteLegacy,
+    });
+    steps.push({
+        step: "cleanup-legacy",
+        ok: cleanupResult.ok,
+        detail: cleanupResult.errors.join("; ") || undefined,
+    });
+    const verifyResult = await verifyMemorixCataloxMetadata(catalox, { appId: config.appId });
+    steps.push({ step: "verify", ok: verifyResult.ok });
+    return {
+        ok: verifyResult.ok && cleanupResult.ok,
+        steps,
+    };
+}
+//# sourceMappingURL=reset.js.map

package/dist/migration/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../src/migration/reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EACL,kCAAkC,EAClC,mCAAmC,GACpC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,kCAAkC,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,qCAAqC,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAa3D,SAAS,aAAa,CAAC,MAAmC;IACxD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAC/E,sBAAsB,EACpB,MAAM,CAAC,sBAAsB;YAC5B,OAAO,CAAC,GAAG,CAAC,yCAAmD;QAClE,uBAAuB,EACrB,MAAM,CAAC,uBAAuB;YAC7B,OAAO,CAAC,GAAG,CAAC,+BAAyC;YACtD,SAAS;QACX,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAuC,EAAE;IAEzC,MAAM,KAAK,GAAwC,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO;QAC3B,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;QAC9B,CAAC,CAAC,MAAM,mCAAmC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEpD,MAAM,UAAU,GAAG,MAAM,6BAA6B,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzF,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,kCAAkC,CAAC,EACnD,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CACpC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,MAAM,kCAAkC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,wCAAwC,CAAC,CAAC;IAC3E,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEvF,MAAM,cAAc,GAAG,MAAM,qCAAqC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7D,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,OAAO,EAAE;QAC3D,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI;KACL,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAE5D,MAAM,WAAW,GAAG,MAAM,kCAAkC,CAAC,OAAO,EAAE,IAAI,EAAE;QAC1E,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IAEtG,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;QACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,mCAAmC,CAAC,OAAO,EAAE,IAAI,EAAE;QAC7E,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,EAAE,EAAE,aAAa,CAAC,EAAE;QACpB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;KACrD,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,4BAA4B,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpD,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,EAAE,IAAI,aAAa,CAAC,EAAE;QACvC,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/migration/types.d.ts

@@ -0,0 +1,76 @@
+import type { CanonicalMemorixCatalogSnapshot } from "../types/canonical-v2.js";
+export type MemorixMetadataBlockedQuestion = {
+    key: string;
+    question: string;
+    required: boolean;
+    options: string[];
+};
+export type MemorixCataloxMetadataFixPlan = {
+    version: "memorix.cataloxMetadataFixPlan.v1";
+    appId: string;
+    mode: "breaking-reset";
+    createCatalogs: Array<{
+        catalogId: string;
+        name: string;
+    }>;
+    upsertItems: Array<{
+        catalogId: string;
+        itemId: string;
+        data: Record<string, unknown>;
+    }>;
+    deleteItems: Array<{
+        catalogId: string;
+        itemId: string;
+    }>;
+    deleteCatalogs: string[];
+    blockedQuestions: MemorixMetadataBlockedQuestion[];
+    warnings: string[];
+};
+export type MemorixMetadataCatalogClassification = "canonical" | "current" | "legacy" | "parallel" | "unknown";
+export type MemorixMetadataInspectionCatalog = {
+    catalogId: string;
+    classification: MemorixMetadataCatalogClassification;
+    itemCount: number;
+    itemIds: string[];
+    contaminationCount: number;
+    legacyFieldHits: string[];
+    namingConflicts: string[];
+};
+export type MemorixMetadataInspectionReport = {
+    version: "memorix.metadataInspection.v1";
+    generatedAt: string;
+    appId: string;
+    catalogs: MemorixMetadataInspectionCatalog[];
+    mongo?: {
+        connected: boolean;
+        entityCollections?: string[];
+        eventCollections?: string[];
+        knowledgeCollections?: string[];
+        unmatchedCollections?: Array<{
+            target: string;
+            collection: string;
+        }>;
+    };
+    references: {
+        variabilitiesGroupsPresent: boolean;
+        criticalVulnerabilitiesListPresent: boolean;
+        criticalVulnerabilitiesSlicePresent: boolean;
+    };
+    environmentSummary: Record<string, string | undefined>;
+};
+export type MemorixMetadataMigrationConfig = {
+    appId?: string;
+    knowledgeCatalogPolicy?: "leave-untouched" | "move-out-of-memorix" | "delete";
+    propertyGenerationDepth?: "minimal" | "infer-from-sample" | "explicit-config-file";
+    planFile?: string;
+    backupDir?: string;
+    outputDir?: string;
+};
+export type CanonicalSnapshotLoadOptions = {
+    appId?: string;
+    includeLegacy?: boolean;
+    includeParallel?: boolean;
+    includeAllKnown?: boolean;
+};
+export declare function snapshotFromPlanUpserts(appId: string, plan: MemorixCataloxMetadataFixPlan): CanonicalMemorixCatalogSnapshot;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/migration/types.js

@@ -0,0 +1,17 @@
+export function snapshotFromPlanUpserts(appId, plan) {
+    const catalogs = {};
+    for (const upsert of plan.upsertItems) {
+        const bucket = catalogs[upsert.catalogId] ?? [];
+        const existingIndex = bucket.findIndex((item) => item.id === upsert.itemId);
+        const entry = { id: upsert.itemId, data: upsert.data };
+        if (existingIndex >= 0) {
+            bucket[existingIndex] = entry;
+        }
+        else {
+            bucket.push(entry);
+        }
+        catalogs[upsert.catalogId] = bucket;
+    }
+    return { appId, catalogs };
+}
+//# sourceMappingURL=types.js.map

package/dist/migration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/migration/types.ts"],"names":[],"mappings":"AA8EA,MAAM,UAAU,uBAAuB,CACrC,KAAa,EACb,IAAmC;IAEnC,MAAM,QAAQ,GAAgD,EAAE,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC"}

package/dist/migration/validate-plan.d.ts

@@ -0,0 +1,15 @@
+import { type MemorixCataloxMetadataFixPlan } from "./types.js";
+export type ValidatePlanResult = {
+    ok: boolean;
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+    warnings: string[];
+};
+export declare function validateMemorixCataloxMetadataFixPlan(plan: MemorixCataloxMetadataFixPlan, options?: {
+    env?: NodeJS.ProcessEnv;
+    planPath?: string;
+}): Promise<ValidatePlanResult>;
+export declare function readMemorixCataloxMetadataFixPlan(planPath: string): Promise<MemorixCataloxMetadataFixPlan>;
+//# sourceMappingURL=validate-plan.d.ts.map

package/dist/migration/validate-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../src/migration/validate-plan.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAsB,qCAAqC,CACzD,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,kBAAkB,CAAC,CA+G7B;AAED,wBAAsB,iCAAiC,CACrD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,6BAA6B,CAAC,CAGxC"}