@x12i/memorix-descriptors 0.1.0 → 1.0.0

package/dist/tests/fixtures.js

@@ -0,0 +1,79 @@
+export const assetsEntityFixture = {
+    id: "assets",
+    entityName: "assets",
+    target: "entity",
+    defaultListDescriptorId: "assets-main-list",
+    defaultItemDescriptorId: "asset-detail-item",
+    collectionPrefix: "assets",
+    identity: {
+        allowedIdFields: ["entityId", "eventId"],
+        requiredExactlyOne: true,
+        defaultIdField: "entityId",
+    },
+    defaults: {
+        canonicalContentType: "snapshots",
+        dataRoot: "data",
+        effectiveDatePath: "capturedAt",
+        fallbackEffectiveDatePaths: [],
+    },
+    contentTypes: {
+        snapshots: {
+            postfix: "snapshots",
+            collection: "assets-snapshots",
+            isCanonical: true,
+        },
+        analysis: {
+            postfix: "analysis",
+            collection: "assets-analysis",
+            isCanonical: false,
+        },
+    },
+    properties: {
+        ipAddress: {
+            label: "IP Address",
+            source: { contentType: "snapshots", path: "data.ip_address" },
+            humanReadable: true,
+        },
+        hostName: {
+            label: "Host Name",
+            source: { contentType: "snapshots", path: "data.xdr.host_name" },
+            humanReadable: false,
+        },
+    },
+    relations: {},
+};
+export function sampleSnapshot() {
+    return {
+        entityDescriptors: {
+            assets: { ...assetsEntityFixture },
+        },
+        listDescriptors: {
+            "assets-main-list": {
+                id: "assets-main-list",
+                entity: "assets",
+                leadingContentType: "snapshots",
+                pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
+                fields: ["ipAddress"],
+            },
+        },
+        itemDescriptors: {
+            "asset-detail-item": {
+                id: "asset-detail-item",
+                entity: "assets",
+                identity: { idField: "entityId" },
+                contentTypes: [{ contentType: "snapshots", required: true }],
+                sections: [{ id: "summary", title: "Summary", fields: ["ipAddress"] }],
+            },
+        },
+        completionMappings: {},
+    };
+}
+export function emptySnapshot() {
+    return {
+        entityDescriptors: {},
+        listDescriptors: {},
+        itemDescriptors: {},
+        completionMappings: {},
+    };
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/tests/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/tests/fixtures.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,QAAQ;IACZ,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE,QAAQ;IAChB,uBAAuB,EAAE,kBAAkB;IAC3C,uBAAuB,EAAE,mBAAmB;IAC5C,gBAAgB,EAAE,QAAQ;IAC1B,QAAQ,EAAE;QACR,eAAe,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;QACxC,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,UAAU;KAC3B;IACD,QAAQ,EAAE;QACR,oBAAoB,EAAE,WAAW;QACjC,QAAQ,EAAE,MAAM;QAChB,iBAAiB,EAAE,YAAY;QAC/B,0BAA0B,EAAE,EAAE;KAC/B;IACD,YAAY,EAAE;QACZ,SAAS,EAAE;YACT,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,kBAAkB;YAC9B,WAAW,EAAE,IAAI;SAClB;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,iBAAiB;YAC7B,WAAW,EAAE,KAAK;SACnB;KACF;IACD,UAAU,EAAE;QACV,SAAS,EAAE;YACT,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,EAAE;YAC7D,aAAa,EAAE,IAAI;SACpB;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,WAAW;YAClB,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,EAAE;YAChE,aAAa,EAAE,KAAK;SACrB;KACF;IACD,SAAS,EAAE,EAAE;CACL,CAAC;AAEX,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,iBAAiB,EAAE;YACjB,MAAM,EAAE,EAAE,GAAG,mBAAmB,EAAE;SACnC;QACD,eAAe,EAAE;YACf,kBAAkB,EAAE;gBAClB,EAAE,EAAE,kBAAkB;gBACtB,MAAM,EAAE,QAAQ;gBAChB,kBAAkB,EAAE,WAAW;gBAC/B,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;gBAC9D,MAAM,EAAE,CAAC,WAAW,CAAC;aACtB;SACF;QACD,eAAe,EAAE;YACf,mBAAmB,EAAE;gBACnB,EAAE,EAAE,mBAAmB;gBACvB,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;gBACjC,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBAC5D,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;aACvE;SACF;QACD,kBAAkB,EAAE,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,iBAAiB,EAAE,EAAE;QACrB,eAAe,EAAE,EAAE;QACnB,eAAe,EAAE,EAAE;QACnB,kBAAkB,EAAE,EAAE;KACvB,CAAC;AACJ,CAAC"}

package/dist/tests/helpers/live.d.ts

@@ -0,0 +1,7 @@
+import type { MemorixDescriptorAdmin } from "../../admin/create-admin.js";
+export declare function isLiveTestsEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function liveSkipReason(env?: NodeJS.ProcessEnv): string | null;
+export declare function assertFirestoreReachable(): Promise<void>;
+export declare function createLiveAdmin(): Promise<MemorixDescriptorAdmin>;
+export declare function smokeEntityName(env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=live.d.ts.map

package/dist/tests/helpers/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../src/tests/helpers/live.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAKhF;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK9D;AAID,wBAAsB,eAAe,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAQvE;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE5E"}

package/dist/tests/helpers/live.js

@@ -0,0 +1,31 @@
+import { testFirestoreConnectionFromEnv } from "@x12i/catalox/firebase";
+import { createMemorixDescriptorAdminFromEnv } from "../../admin/create-admin.js";
+export function isLiveTestsEnabled(env = process.env) {
+    return (env.FIRESTORE_LIVE_TESTS === "1" ||
+        env.MEMORIX_DESCRIPTORS_LIVE_TESTS === "1");
+}
+export function liveSkipReason(env = process.env) {
+    if (isLiveTestsEnabled(env))
+        return null;
+    return "Set FIRESTORE_LIVE_TESTS=1 (or MEMORIX_DESCRIPTORS_LIVE_TESTS=1) in .env";
+}
+export async function assertFirestoreReachable() {
+    const probe = await testFirestoreConnectionFromEnv();
+    if (!probe.ok) {
+        throw probe.error ?? new Error("Firestore connectivity check failed");
+    }
+}
+let cachedAdmin;
+export async function createLiveAdmin() {
+    if (!cachedAdmin) {
+        await assertFirestoreReachable();
+        cachedAdmin = await createMemorixDescriptorAdminFromEnv({
+            xronox: undefined,
+        });
+    }
+    return cachedAdmin;
+}
+export function smokeEntityName(env = process.env) {
+    return env.MEMORIX_SMOKE_ENTITY?.trim() || "assets";
+}
+//# sourceMappingURL=live.js.map

package/dist/tests/helpers/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../../src/tests/helpers/live.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAGlF,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,OAAO,CACL,GAAG,CAAC,oBAAoB,KAAK,GAAG;QAChC,GAAG,CAAC,8BAA8B,KAAK,GAAG,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,IAAI,kBAAkB,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,0EAA0E,CAAC;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,KAAK,GAAG,MAAM,8BAA8B,EAAE,CAAC;IACrD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,IAAI,WAA+C,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,wBAAwB,EAAE,CAAC;QACjC,WAAW,GAAG,MAAM,mCAAmC,CAAC;YACtD,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,OAAO,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC;AACtD,CAAC"}

package/dist/tests/integrity.test.d.ts

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

package/dist/tests/integrity.test.d.ts.map

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

package/dist/tests/integrity.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vitest";
+import { validateDescriptorSnapshot } from "../integrity/validate.js";
+import { assetsEntityFixture, sampleSnapshot } from "./fixtures.js";
+describe("validateDescriptorSnapshot", () => {
+    it("accepts a connected minimal graph", () => {
+        const report = validateDescriptorSnapshot(sampleSnapshot());
+        expect(report.valid).toBe(true);
+        expect(report.errors).toHaveLength(0);
+    });
+    it("flags missing default list descriptor", () => {
+        const snapshot = sampleSnapshot();
+        snapshot.entityDescriptors.assets = {
+            ...assetsEntityFixture,
+            defaultListDescriptorId: "missing-list",
+        };
+        const report = validateDescriptorSnapshot(snapshot);
+        expect(report.valid).toBe(false);
+        expect(report.errors.some((e) => e.code === "MISSING_DEFAULT_LIST")).toBe(true);
+    });
+    it("flags non-human-readable list fields", () => {
+        const snapshot = sampleSnapshot();
+        snapshot.listDescriptors["assets-main-list"] = {
+            ...snapshot.listDescriptors["assets-main-list"],
+            fields: ["hostName"],
+        };
+        const report = validateDescriptorSnapshot(snapshot);
+        expect(report.valid).toBe(false);
+        expect(report.errors.some((e) => e.code === "NON_HUMAN_READABLE_LIST_FIELD" ||
+            e.code === "INVALID_LIST_DESCRIPTOR")).toBe(true);
+    });
+    it("flags unknown relation target", () => {
+        const snapshot = sampleSnapshot();
+        snapshot.entityDescriptors.assets = {
+            ...assetsEntityFixture,
+            relations: {
+                toMissing: {
+                    targetEntity: "not-real",
+                    type: "oneToMany",
+                    source: { contentType: "snapshots", path: "data.id" },
+                    target: { contentType: "snapshots", path: "data.id" },
+                },
+            },
+        };
+        const report = validateDescriptorSnapshot(snapshot);
+        expect(report.valid).toBe(false);
+        expect(report.orphans.danglingReferences.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=integrity.test.js.map

package/dist/tests/integrity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.test.js","sourceRoot":"","sources":["../../src/tests/integrity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpE,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,0BAA0B,CAAC,cAAc,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAClC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG;YAClC,GAAG,mBAAmB;YACtB,uBAAuB,EAAE,cAAc;SACxC,CAAC;QACF,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAClC,QAAQ,CAAC,eAAe,CAAC,kBAAkB,CAAC,GAAG;YAC7C,GAAG,QAAQ,CAAC,eAAe,CAAC,kBAAkB,CAAE;YAChD,MAAM,EAAE,CAAC,UAAU,CAAC;SACrB,CAAC;QACF,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CACJ,MAAM,CAAC,MAAM,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,+BAA+B;YAC1C,CAAC,CAAC,IAAI,KAAK,yBAAyB,CACvC,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAClC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,GAAG;YAClC,GAAG,mBAAmB;YACtB,SAAS,EAAE;gBACT,SAAS,EAAE;oBACT,YAAY,EAAE,UAAU;oBACxB,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;oBACrD,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;iBACtD;aACF;SACF,CAAC;QACF,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/live/catalox.live.test.d.ts

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

package/dist/tests/live/catalox.live.test.d.ts.map

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

package/dist/tests/live/catalox.live.test.js

@@ -0,0 +1,110 @@
+import { describe, expect, it } from "vitest";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../../catalog/ids.js";
+import { createLiveAdmin, isLiveTestsEnabled, liveSkipReason, smokeEntityName, } from "../helpers/live.js";
+import { createMemorixDescriptorAdminFromEnv } from "../../admin/create-admin.js";
+const live = isLiveTestsEnabled();
+const skipReason = liveSkipReason() ?? undefined;
+describe.runIf(live)("live catalox / memorix-descriptors", () => {
+    it("loads admin and validates deployed descriptor graph", async () => {
+        const admin = await createLiveAdmin();
+        const report = await admin.validateMemorixDescriptors();
+        expect(report.counts.entityDescriptors).toBeGreaterThan(0);
+        expect(report.counts.listDescriptors).toBeGreaterThan(0);
+        expect(report.counts.itemDescriptors).toBeGreaterThan(0);
+        if (!report.valid) {
+            console.warn("Integrity warnings/errors (graph may have known legacy issues):", JSON.stringify({ errorCount: report.errors.length, warningCount: report.warnings.length }, null, 2));
+        }
+        expect(report.counts.entityDescriptors).toBeGreaterThanOrEqual(3);
+    }, 120_000);
+    it("loads smoke entity descriptor from Catalox", async () => {
+        const admin = await createLiveAdmin();
+        const entityName = smokeEntityName();
+        const snapshot = await admin.loadSnapshot();
+        const entity = snapshot.entityDescriptors[entityName];
+        expect(entity, `entity descriptor "${entityName}"`).toBeDefined();
+        expect(entity?.defaultListDescriptorId).toBeTruthy();
+        expect(entity?.defaultItemDescriptorId).toBeTruthy();
+        const listId = String(entity?.defaultListDescriptorId);
+        const itemId = String(entity?.defaultItemDescriptorId);
+        expect(snapshot.listDescriptors[listId]).toBeDefined();
+        expect(snapshot.itemDescriptors[itemId]).toBeDefined();
+    }, 60_000);
+    it("lists catalog items for entity, list, and item descriptors", async () => {
+        const admin = await createLiveAdmin();
+        const entityPage = await admin.catalox.listCatalogItems(MEMORIX_ENTITY_DESCRIPTORS_CATALOG, { limit: 50 });
+        expect(entityPage.listOutcome).not.toBe("mapping_blocked");
+        expect(entityPage.items.length).toBeGreaterThan(0);
+        const listPage = await admin.catalox.listCatalogItems(MEMORIX_LIST_DESCRIPTORS_CATALOG, { limit: 50 });
+        expect(listPage.items.length).toBeGreaterThan(0);
+        const itemPage = await admin.catalox.listCatalogItems(MEMORIX_ITEM_DESCRIPTORS_CATALOG, { limit: 50 });
+        expect(itemPage.items.length).toBeGreaterThan(0);
+    }, 60_000);
+    it("builds descriptor graph with default-list edges", async () => {
+        const admin = await createLiveAdmin();
+        const graph = await admin.getDescriptorGraph();
+        const entityName = smokeEntityName();
+        expect(graph.nodes.some((n) => n.id === entityName && n.kind === "entity")).toBe(true);
+        expect(graph.edges.some((e) => e.from === entityName && e.kind === "default-list")).toBe(true);
+    }, 60_000);
+    it("resolves collection name for smoke entity canonical content type", async () => {
+        const admin = await createLiveAdmin();
+        const entityName = smokeEntityName();
+        const snapshot = await admin.loadSnapshot();
+        const entity = snapshot.entityDescriptors[entityName];
+        const canonical = String(entity.defaults?.canonicalContentType ??
+            "snapshots");
+        const collection = await admin.resolveCollection(entityName, canonical);
+        expect(collection).toBeTruthy();
+        expect(collection).toMatch(/^[a-z0-9-]+$/);
+    }, 60_000);
+    it("dry-run addProperty on smoke entity does not write", async () => {
+        const admin = await createLiveAdmin();
+        const entityName = smokeEntityName();
+        const snapshot = await admin.loadSnapshot();
+        const entity = snapshot.entityDescriptors[entityName];
+        const canonical = String(entity.defaults?.canonicalContentType ??
+            Object.keys(entity.contentTypes)[0] ??
+            "snapshots");
+        const propKey = `_live-test-prop-${Date.now()}`;
+        const result = await admin.addProperty(entityName, propKey, {
+            label: "Live Test Property",
+            source: { contentType: canonical, path: "data._live_test" },
+            humanReadable: true,
+        }, { dryRun: true, addToDefaultList: false, addToDefaultItem: false });
+        expect(result.dryRun).toBe(true);
+        expect(result.cataloxWrites.length).toBeGreaterThan(0);
+        expect(result.errors.some((e) => ["ENTITY_NOT_FOUND", "VALIDATION_FAILED", "UNKNOWN_CONTENT_TYPE"].includes(e.code))).toBe(false);
+    }, 60_000);
+    it("reconcileDescriptorsWithMongo returns inventory when xronox is configured", async () => {
+        if (!process.env.MONGO_URI?.trim()) {
+            console.warn("Skipping reconcile — MONGO_URI not set in .env");
+            return;
+        }
+        const admin = await createMemorixDescriptorAdminFromEnv();
+        try {
+            const result = await admin.reconcileDescriptorsWithMongo();
+            expect(result.inventory.entries).toBeDefined();
+            expect(Array.isArray(result.suggestions)).toBe(true);
+            expect(result.inventory.scannedAt).toBeTruthy();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes("data tier") ||
+                message.includes("xronox") ||
+                message.includes("Xronox")) {
+                console.warn("Skipping reconcile assertion — Xronox not configured:", message);
+                return;
+            }
+            throw err;
+        }
+    }, 180_000);
+});
+describe("live test gate", () => {
+    it.skipIf(live)("skipped — live tests disabled", () => {
+        expect(skipReason).toBeTruthy();
+    });
+    it.runIf(!live)("documents how to enable live tests", () => {
+        expect(liveSkipReason()).toMatch(/FIRESTORE_LIVE_TESTS/);
+    });
+});
+//# sourceMappingURL=catalox.live.test.js.map

package/dist/tests/live/catalox.live.test.js.map

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

package/dist/tests/mutations.test.d.ts

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

package/dist/tests/mutations.test.d.ts.map

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

package/dist/tests/mutations.test.js

@@ -0,0 +1,99 @@
+import { describe, expect, it } from "vitest";
+import { addContentType } from "../mutations/content-type.js";
+import { addProperty, removeProperty } from "../mutations/property.js";
+import { registerEntityDescriptor } from "../mutations/entity.js";
+import { emptySnapshot, sampleSnapshot } from "./fixtures.js";
+function mockCtx(snapshot = sampleSnapshot()) {
+    return {
+        catalox: {},
+        env: process.env,
+        loadSnapshot: async () => snapshot,
+    };
+}
+describe("content type mutations (dry-run)", () => {
+    it("rejects duplicate content type keys", async () => {
+        const result = await addContentType(mockCtx(), "assets", { key: "snapshots", postfix: "snapshots" }, { dryRun: true });
+        expect(result.ok).toBe(false);
+        expect(result.errors[0]?.code).toBe("CONTENT_TYPE_EXISTS");
+    });
+    it("plans add of a new content type", async () => {
+        const result = await addContentType(mockCtx(), "assets", { key: "enrichment", postfix: "enrichment" }, { dryRun: true, skipMongo: true });
+        expect(result.ok).toBe(true);
+        expect(result.cataloxWrites).toHaveLength(1);
+        expect(result.data?.key).toBe("enrichment");
+    });
+    it("blocks removal when content type is referenced by a property", async () => {
+        const snapshot = sampleSnapshot();
+        const assets = snapshot.entityDescriptors.assets;
+        snapshot.entityDescriptors.assets = {
+            ...assets,
+            properties: {
+                ...assets.properties,
+                enrichmentFlag: {
+                    label: "Enrichment",
+                    source: { contentType: "analysis", path: "data.flag" },
+                    humanReadable: true,
+                },
+            },
+        };
+        const result = await import("../mutations/content-type.js").then((m) => m.removeContentType(mockCtx(snapshot), "assets", "analysis", { dryRun: true }));
+        expect(result.ok).toBe(false);
+        expect(result.errors[0]?.code).toBe("CONTENT_TYPE_IN_USE");
+    });
+});
+describe("property mutations (dry-run)", () => {
+    it("adds a property and cascades to default list/item", async () => {
+        const result = await addProperty(mockCtx(), "assets", "agentType", {
+            label: "Agent Type",
+            source: { contentType: "snapshots", path: "data.agent_type" },
+            humanReadable: true,
+        }, { dryRun: true, addToDefaultList: true, addToDefaultItem: true });
+        expect(result.ok).toBe(true);
+        expect(result.cataloxWrites.length).toBeGreaterThanOrEqual(1);
+    });
+    it("blocks removal when property path is used in a relation", async () => {
+        const snapshot = sampleSnapshot();
+        snapshot.entityDescriptors.assets = {
+            ...snapshot.entityDescriptors.assets,
+            relations: {
+                linked: {
+                    targetEntity: "assets",
+                    type: "oneToMany",
+                    source: { contentType: "snapshots", path: "data.ipAddress" },
+                    target: { contentType: "snapshots", path: "data.id" },
+                },
+            },
+        };
+        const result = await removeProperty(mockCtx(snapshot), "assets", "ipAddress", { dryRun: true });
+        expect(result.ok).toBe(false);
+        expect(result.errors[0]?.code).toBe("PROPERTY_IN_RELATION");
+    });
+});
+describe("registerEntityDescriptor (dry-run)", () => {
+    it("rejects duplicate entity registration", async () => {
+        const result = await registerEntityDescriptor(mockCtx(), {
+            entityName: "assets",
+            target: "entity",
+            collectionPrefix: "assets",
+            canonicalContentType: { key: "snapshots", postfix: "snapshots" },
+        }, { dryRun: true });
+        expect(result.ok).toBe(false);
+        expect(result.errors[0]?.code).toBe("ENTITY_EXISTS");
+    });
+    it("registers a new knowledge entity graph in dry-run", async () => {
+        const result = await registerEntityDescriptor(mockCtx(emptySnapshot()), {
+            entityName: "impact-stories",
+            target: "knowledge",
+            collectionPrefix: "impact-stories",
+            canonicalContentType: {
+                key: "narratives",
+                postfix: "narratives",
+                collection: "impact-stories-narratives",
+            },
+            identity: { idField: "knowledgeId" },
+        }, { dryRun: true });
+        expect(result.ok).toBe(true);
+        expect(result.cataloxWrites).toHaveLength(3);
+    });
+});
+//# sourceMappingURL=mutations.test.js.map

package/dist/tests/mutations.test.js.map

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

package/dist/tests/seeds.test.d.ts

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

package/dist/tests/seeds.test.d.ts.map

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

package/dist/tests/seeds.test.js

@@ -0,0 +1,57 @@
+import { describe, expect, it } from "vitest";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildDescriptorSeedManifest } from "../seeds/index.js";
+import { sampleSnapshot } from "./fixtures.js";
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const retrievalInputs = resolve(packageRoot, "..", "memorix-retrieval", "catalox-seeds", "inputs");
+describe("buildDescriptorSeedManifest", () => {
+    it("builds manifest items from an in-memory snapshot", async () => {
+        const manifest = await buildDescriptorSeedManifest(sampleSnapshot(), {
+            domains: ["network"],
+            agents: ["neo"],
+        });
+        expect(manifest.items.length).toBeGreaterThanOrEqual(3);
+        expect(manifest.items.some((i) => i.catalogId.includes("entity"))).toBe(true);
+        expect(manifest.catalogs.some((c) => c.catalogId.includes("entity"))).toBe(true);
+    });
+    it.skipIf(!existsSync(retrievalInputs))("round-trips memorix-retrieval catalox-seeds/inputs when sibling repo exists", async () => {
+        const { createSeedInputsReader, loadMemorixRetrievalSeedScopeFromInputs } = await import("@x12i/memorix-retrieval");
+        const readJson = createSeedInputsReader(retrievalInputs);
+        const scope = await loadMemorixRetrievalSeedScopeFromInputs(retrievalInputs);
+        const snapshot = {
+            entityDescriptors: {},
+            listDescriptors: {},
+            itemDescriptors: {},
+            completionMappings: {},
+        };
+        for (const file of [
+            "entity-descriptors/assets.json",
+            "entity-descriptors/vulnerabilities.json",
+            "entity-descriptors/variabilities-groups.json",
+            "list-descriptors/assets-main-list.json",
+            "item-descriptors/asset-detail-item.json",
+        ]) {
+            const data = await readJson(file);
+            const id = String(data.id);
+            if (file.startsWith("entity-descriptors/")) {
+                snapshot.entityDescriptors[id] = data;
+            }
+            else if (file.startsWith("list-descriptors/")) {
+                snapshot.listDescriptors[id] = data;
+            }
+            else {
+                snapshot.itemDescriptors[id] = data;
+            }
+        }
+        const manifest = await buildDescriptorSeedManifest(snapshot, scope);
+        expect(manifest.items.length).toBeGreaterThanOrEqual(5);
+        const entityIds = manifest.items
+            .filter((i) => i.catalogId.includes("entity"))
+            .map((i) => String(i.data.id));
+        expect(entityIds).toContain("assets");
+        expect(entityIds).toContain("vulnerabilities");
+    });
+});
+//# sourceMappingURL=seeds.test.js.map

package/dist/tests/seeds.test.js.map

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

package/dist/tests/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/tests/setup.d.ts.map

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

package/dist/tests/setup.js

@@ -0,0 +1,6 @@
+import { config } from "dotenv";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+config({ path: resolve(packageRoot, ".env") });
+//# sourceMappingURL=setup.js.map

package/dist/tests/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/tests/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACjF,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/dist/tests/validation.test.js

@@ -2,62 +2,8 @@ import { describe, expect, it } from "vitest";
 import { defaultItemDescriptorId, defaultListDescriptorId, isKebabCase, singularizeEntityName, validateMemorixEntityDescriptor, validateMemorixEntityListDescriptor, validateMemorixItemDescriptor, } from "../validation/descriptor-validation.js";
 import { validateDescriptorSnapshot } from "../integrity/validate.js";
 import { buildDescriptorGraph } from "../integrity/graph.js";
-const sampleSnapshot = () => ({
-    entityDescriptors: {
-        assets: {
-            id: "assets",
-            entityName: "assets",
-            target: "entity",
-            defaultListDescriptorId: "assets-main-list",
-            defaultItemDescriptorId: "asset-detail-item",
-            collectionPrefix: "assets",
-            identity: {
-                allowedIdFields: ["entityId", "eventId"],
-                requiredExactlyOne: true,
-                defaultIdField: "entityId",
-            },
-            defaults: {
-                canonicalContentType: "snapshots",
-                dataRoot: "data",
-                effectiveDatePath: "capturedAt",
-                fallbackEffectiveDatePaths: [],
-            },
-            contentTypes: {
-                snapshots: {
-                    postfix: "snapshots",
-                    collection: "assets-snapshots",
-                    isCanonical: true,
-                },
-            },
-            properties: {
-                ipAddress: {
-                    label: "IP Address",
-                    source: { contentType: "snapshots", path: "data.ip_address" },
-                    humanReadable: true,
-                },
-            },
-        },
-    },
-    listDescriptors: {
-        "assets-main-list": {
-            id: "assets-main-list",
-            entity: "assets",
-            leadingContentType: "snapshots",
-            pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
-            fields: ["ipAddress"],
-        },
-    },
-    itemDescriptors: {
-        "asset-detail-item": {
-            id: "asset-detail-item",
-            entity: "assets",
-            identity: { idField: "entityId" },
-            contentTypes: [{ contentType: "snapshots", required: true }],
-            sections: [{ id: "summary", title: "Summary", fields: ["ipAddress"] }],
-        },
-    },
-    completionMappings: {},
-});
+import { emptySnapshot, sampleSnapshot } from "./fixtures.js";
+import { registerEntityDescriptor } from "../mutations/entity.js";
 describe("descriptor validation helpers", () => {
     it("validates kebab-case entity names", () => {
         expect(isKebabCase("impact-stories")).toBe(true);
@@ -86,15 +32,10 @@ describe("descriptor validation helpers", () => {
 });
 describe("register entity plan", () => {
     it("projects entity + default list/item writes", async () => {
-        const { registerEntityDescriptor } = await import("../mutations/entity.js");
-        const snapshot = sampleSnapshot();
-        snapshot.entityDescriptors = {};
-        snapshot.listDescriptors = {};
-        snapshot.itemDescriptors = {};
         const result = await registerEntityDescriptor({
             catalox: {},
             env: process.env,
-            loadSnapshot: async () => snapshot,
+            loadSnapshot: async () => emptySnapshot(),
         }, {
             entityName: "impact-stories",
             target: "knowledge",