@x12i/memorix-descriptors 1.4.2 → 1.5.0

package/dist/tests/source-aware.test.js

@@ -0,0 +1,227 @@
+import { describe, expect, it } from "vitest";
+import { getMemorixCatalogSourceRegistry, resolveCatalogRegistryEntry, isEditableSourceClass, isKnownCatalogId, LEGACY_SCHEMA_INFERENCE_CATALOG, buildObjectTypeSourceRef, buildDerivedGraphSourceRef, wrapSourceAware, withEntityDescriptorAliases, withListDescriptorAliases, withCompletionMappingAliases, classifyUnprovenJson, rejectMutationForUnprovenSource, assertSourceEditable, createSourceNotEditableError, listSliceDescriptors, buildDescriptorActionDraftFromOrphanCollection, toDescriptorActionDraft, } from "../source/index.js";
+import { MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, MEMORIX_COMPLETION_MAPPINGS_CATALOG, } from "../catalog/ids.js";
+import { validateMemorixEntityDescriptor } from "../validation/descriptor-validation.js";
+import { assetsEntityFixture, sampleSnapshot } from "./fixtures.js";
+describe("catalog source registry", () => {
+    it("classifies canonical descriptor catalogs", () => {
+        const registry = getMemorixCatalogSourceRegistry();
+        expect(registry.appIdDefault).toBe("memorix");
+        expect(registry.catalogs[MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG]).toMatchObject({
+            sourceClass: "canonical-catalox-descriptor",
+            canonicalStatus: "canonical",
+            editable: "editable",
+            managedByDescriptors: true,
+        });
+        expect(registry.catalogs[MEMORIX_ENTITY_DESCRIPTORS_CATALOG]).toMatchObject({
+            sourceClass: "legacy-catalox-catalog",
+            canonicalStatus: "legacy",
+            editable: "not-editable",
+        });
+    });
+    it("classifies legacy catalogs as not editable", () => {
+        const entry = resolveCatalogRegistryEntry(LEGACY_SCHEMA_INFERENCE_CATALOG);
+        expect(entry.sourceClass).toBe("legacy-catalox-catalog");
+        expect(entry.canonicalStatus).toBe("legacy");
+        expect(entry.editable).toBe("not-editable");
+        expect(entry.replacementCatalogId).toBe(MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG);
+    });
+    it("classifies unknown catalog ids", () => {
+        const entry = resolveCatalogRegistryEntry("some-random-catalog");
+        expect(entry.sourceClass).toBe("unknown-source");
+        expect(entry.canonicalStatus).toBe("unknown");
+        expect(isKnownCatalogId("some-random-catalog")).toBe(false);
+    });
+    it("allows mutations only for editable source classes", () => {
+        expect(isEditableSourceClass("canonical-catalox-descriptor")).toBe(true);
+        expect(isEditableSourceClass("catalox-control-plane")).toBe(true);
+        expect(isEditableSourceClass("legacy-catalox-catalog")).toBe(false);
+        expect(isEditableSourceClass("local-ui-state")).toBe(false);
+    });
+});
+describe("source envelope creation", () => {
+    it("creates canonical descriptor source refs", () => {
+        const source = buildObjectTypeSourceRef("assets", "memorix", "2026-01-01T00:00:00.000Z", "assets", "entity");
+        expect(source).toMatchObject({
+            sourceClass: "canonical-catalox-descriptor",
+            canonicalStatus: "canonical",
+            catalogId: MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+            itemId: "assets",
+            objectType: "assets",
+            entityName: "assets",
+            editable: "editable",
+        });
+    });
+    it("creates control-plane source refs", () => {
+        const source = buildObjectTypeSourceRef("mapping-1", "memorix");
+        source.catalogId = MEMORIX_COMPLETION_MAPPINGS_CATALOG;
+        source.descriptorKind = "completion-mapping";
+        source.sourceClass = "catalox-control-plane";
+        source.canonicalStatus = "control-plane";
+        expect(source.descriptorKind).toBe("completion-mapping");
+    });
+    it("marks derived graph as runtime projection", () => {
+        const source = buildDerivedGraphSourceRef();
+        expect(source.sourceClass).toBe("runtime-projection");
+        expect(source.canonicalStatus).toBe("derived");
+        expect(source.editable).toBe("not-editable");
+    });
+});
+describe("object type aliases", () => {
+    it("adds objectType and objectName to entity descriptors", () => {
+        const entity = withEntityDescriptorAliases(validateMemorixEntityDescriptor({ ...assetsEntityFixture }));
+        expect(entity.entityName).toBe("assets");
+        expect(entity.objectType).toBe("assets");
+        expect(entity.objectName).toBe("assets");
+    });
+    it("adds objectType alias to list descriptors", () => {
+        const list = withListDescriptorAliases({
+            id: "assets-main-list",
+            entity: "assets",
+            leadingContentType: "snapshots",
+            pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
+            fields: ["ipAddress"],
+        });
+        expect("entity" in list && list.entity).toBe("assets");
+        expect(list.objectType).toBe("assets");
+    });
+    it("adds objectType alias to completion mappings", () => {
+        const mapping = withCompletionMappingAliases({
+            id: "m1",
+            name: "Test",
+            entityType: "assets",
+            target: "entity",
+            targetCollection: "assets-snapshots",
+            targetSelector: { sourceCollection: "ext", idField: "entityId" },
+            source: { databaseName: "db", collection: "ext" },
+            match: { targetPath: "data.x", sourcePath: "x" },
+            writeRoot: "data",
+            fields: [],
+        });
+        expect(mapping.entityType).toBe("assets");
+        expect(mapping.objectType).toBe("assets");
+    });
+});
+describe("source-aware snapshot shape", () => {
+    it("separates slices from lists in canonical group", () => {
+        const loadedAt = "2026-01-01T00:00:00.000Z";
+        const snapshot = {
+            appId: "memorix",
+            loadedAt,
+            catalogs: [],
+            canonical: {
+                objectTypes: [
+                    wrapSourceAware(withEntityDescriptorAliases(validateMemorixEntityDescriptor({ ...assetsEntityFixture })), buildObjectTypeSourceRef("assets", "memorix", loadedAt, "assets", "entity")),
+                ],
+                lists: [],
+                items: [],
+                slices: [
+                    wrapSourceAware({
+                        id: "assets-open-slice",
+                        kind: "slice",
+                        title: "Open",
+                        entityName: "assets",
+                        objectType: "assets",
+                        target: "entity",
+                        contentType: "snapshots",
+                        fields: ["ipAddress"],
+                    }, buildObjectTypeSourceRef("assets-open-slice", "memorix", loadedAt, "assets", "entity")),
+                ],
+            },
+            controlPlane: { completionMappings: [], inventoryPolicies: [] },
+            warnings: [],
+            errors: [],
+        };
+        const slices = listSliceDescriptors(snapshot);
+        expect(slices).toHaveLength(1);
+        expect(slices[0]?.data.kind).toBe("slice");
+        expect(slices[0]?.source.sourceClass).toBe("canonical-catalox-descriptor");
+    });
+});
+describe("source-aware validation issue shape", () => {
+    it("includes source on integrity-derived issues via snapshot assembly", async () => {
+        const snapshot = sampleSnapshot();
+        delete snapshot.listDescriptors["assets-main-list"];
+        expect(Object.keys(snapshot.listDescriptors)).toHaveLength(0);
+        expect(snapshot.entityDescriptors.assets).toBeDefined();
+    });
+});
+describe("mutation guard rejects non-editable sources", () => {
+    it("rejects legacy catalog source mutations", () => {
+        const source = resolveCatalogRegistryEntry(LEGACY_SCHEMA_INFERENCE_CATALOG);
+        const ref = {
+            sourceClass: source.sourceClass,
+            canonicalStatus: source.canonicalStatus,
+            catalogId: LEGACY_SCHEMA_INFERENCE_CATALOG,
+            loadedAt: new Date().toISOString(),
+            editable: source.editable,
+        };
+        expect(() => assertSourceEditable(ref)).toThrow();
+        const error = createSourceNotEditableError(ref);
+        expect(error.code).toBe("SOURCE_NOT_EDITABLE");
+    });
+});
+describe("does-not-classify-runtime-narratives-ui-framework-json-as-canonical-descriptor", () => {
+    it("classifies narratives-ui-framework JSON as local UI state", () => {
+        const json = {
+            framework: "narratives-ui-framework",
+            mode: "operational",
+            graphType: "entities",
+            nodes: [],
+        };
+        const source = classifyUnprovenJson(json);
+        expect(source.sourceClass).toBe("local-ui-state");
+        expect(source.canonicalStatus).toBe("local");
+        expect(source.editable).toBe("not-editable");
+    });
+    it("rejects mutation for unproven narratives JSON", () => {
+        const json = {
+            framework: "narratives-ui-framework",
+            mode: "operational",
+            graphType: "entities",
+            nodes: [],
+        };
+        const rejection = rejectMutationForUnprovenSource(json);
+        expect(rejection?.code).toBe("SOURCE_NOT_EDITABLE");
+        expect(rejection?.source.sourceClass).toBe("local-ui-state");
+    });
+    it("classifies runtime graph projection separately from canonical descriptors", () => {
+        const json = {
+            mode: "operational",
+            graphType: "entities",
+            nodes: [{ id: "n1" }],
+        };
+        const source = classifyUnprovenJson(json);
+        expect(source.sourceClass).toBe("runtime-projection");
+        expect(source.editable).toBe("not-editable");
+    });
+});
+describe("draft builders with requiredUserInputs", () => {
+    it("returns requiredUserInputs for unparseable orphan collections", () => {
+        const draft = buildDescriptorActionDraftFromOrphanCollection({
+            target: "entity",
+            collectionName: "invalid",
+        });
+        expect(draft.action).toBe("manual-review");
+        expect(draft.requiredUserInputs?.some((i) => i.key === "objectType")).toBe(true);
+        expect(draft.dryRunAvailable).toBe(false);
+    });
+    it("wraps reconcile drafts with source refs", () => {
+        const draft = toDescriptorActionDraft({
+            suggestedAction: "registerEntityDescriptor",
+            draft: { entityName: "assets", target: "entity" },
+            warnings: [],
+        });
+        expect(draft.status).toBe("draft");
+        expect(draft.source.sourceClass).toBe("runtime-projection");
+        expect(draft.proposedMutation.method).toBe("registerEntityDescriptor");
+    });
+});
+describe("source-aware graph node shape", () => {
+    it("wraps canonical descriptors with source refs", () => {
+        const source = buildObjectTypeSourceRef("assets", "memorix");
+        expect(source.catalogId).toBe(MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG);
+        expect(source.itemId).toBe("assets");
+    });
+});
+//# sourceMappingURL=source-aware.test.js.map

package/dist/tests/source-aware.test.js.map

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

package/dist/types/canonical-v2.d.ts

@@ -0,0 +1,164 @@
+import type { MemorixContentTypeDescriptor, MemorixListPagination, MemorixListSort, MemorixMultiMatchRule, MemorixPropertyDescriptor } from "./descriptors.js";
+import type { MemorixIdField, MemorixSliceFilter, MemorixTarget } from "./index.js";
+export declare const OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2 = "memorix.objectTypeDescriptor.v2";
+export declare const LIST_DESCRIPTOR_SCHEMA_V2 = "memorix.listDescriptor.v2";
+export declare const ITEM_DESCRIPTOR_SCHEMA_V2 = "memorix.itemDescriptor.v2";
+export declare const COMPLETION_MAPPING_SCHEMA_V2 = "memorix.completionMapping.v2";
+export declare const INVENTORY_POLICY_SCHEMA_V1 = "memorix.inventoryPolicy.v1";
+export type MemorixObjectTypeRelationDescriptorV2 = {
+    targetObjectType: string;
+    type: "oneToOne" | "oneToMany" | "manyToOne" | "manyToMany";
+    source: {
+        contentType: string;
+        path: string;
+    };
+    target: {
+        contentType: string;
+        path: string;
+    };
+    defaultMode?: "extendFields" | "array";
+    defaultArrayProperty?: string;
+    targetFields?: string[];
+};
+export type MemorixObjectTypeDescriptorV2 = {
+    schemaVersion: typeof OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2;
+    id: string;
+    objectType: string;
+    target: MemorixTarget;
+    collectionPrefix: string;
+    defaultListDescriptorId: string;
+    defaultItemDescriptorId: string;
+    identity: {
+        allowedIdFields: Array<MemorixIdField | "recordId" | "_id">;
+        requiredExactlyOne: boolean;
+        defaultIdField: MemorixIdField;
+    };
+    defaults: {
+        canonicalContentType: string;
+        dataRoot: string;
+        effectiveDatePath: string;
+        fallbackEffectiveDatePaths: string[];
+    };
+    contentTypes: Record<string, MemorixContentTypeDescriptor>;
+    properties: Record<string, MemorixPropertyDescriptor>;
+    relations?: Record<string, MemorixObjectTypeRelationDescriptorV2>;
+};
+export type MemorixObjectListDescriptorV2 = {
+    schemaVersion: typeof LIST_DESCRIPTOR_SCHEMA_V2;
+    id: string;
+    kind: "object-list";
+    title: string;
+    objectType: string;
+    leadingContentType: string;
+    fields: string[];
+    pagination: MemorixListPagination;
+    defaultSort?: MemorixListSort;
+};
+export type MemorixWorkspaceListDescriptorV2 = {
+    schemaVersion: typeof LIST_DESCRIPTOR_SCHEMA_V2;
+    id: string;
+    kind: "workspace";
+    title: string;
+    objectTypes: string[];
+    fields: string[];
+    pagination: MemorixListPagination;
+    defaultSort?: MemorixListSort;
+};
+export type MemorixSliceListDescriptorV2 = {
+    schemaVersion: typeof LIST_DESCRIPTOR_SCHEMA_V2;
+    id: string;
+    kind: "slice";
+    title: string;
+    objectType: string;
+    target: MemorixTarget;
+    contentType: string;
+    fields: string[];
+    filter?: MemorixSliceFilter;
+    sort?: Array<{
+        path: string;
+        direction: "asc" | "desc";
+    }>;
+    defaultItemDescriptorId?: string;
+    pagination?: MemorixListPagination;
+};
+export type MemorixListDescriptorV2 = MemorixObjectListDescriptorV2 | MemorixWorkspaceListDescriptorV2 | MemorixSliceListDescriptorV2;
+export type MemorixItemDescriptorV2 = {
+    schemaVersion: typeof ITEM_DESCRIPTOR_SCHEMA_V2;
+    id: string;
+    title: string;
+    objectType: string;
+    identity: {
+        idField: MemorixIdField;
+    };
+    contentTypes: Array<{
+        contentType: string;
+        required: boolean;
+        multiMatch?: MemorixMultiMatchRule;
+    }>;
+    sections: Array<{
+        id: string;
+        title: string;
+        fields: string[];
+    }>;
+    includeRelations?: string[];
+};
+export type MemorixCompletionMappingV2 = {
+    schemaVersion: typeof COMPLETION_MAPPING_SCHEMA_V2;
+    id: string;
+    name: string;
+    objectType: string;
+    target: MemorixTarget;
+    targetCollection: string;
+    targetSelector: {
+        sourceCollection: string;
+        idField: string;
+    };
+    source: {
+        databaseName: string;
+        collection: string;
+    };
+    match: {
+        targetPath: string;
+        sourcePath: string;
+    };
+    writeRoot: "data";
+    fields: Array<{
+        sourcePath: string;
+        targetPath: string;
+    }>;
+    onlyFillMissing?: boolean;
+    overwriteExisting?: boolean;
+};
+export type MemorixInventoryPolicyV1 = {
+    schemaVersion: typeof INVENTORY_POLICY_SCHEMA_V1;
+    id: "default";
+    ignoredCollections: Array<{
+        target: MemorixTarget;
+        databaseName?: string;
+        collectionName: string;
+        reason: "legacy" | "external" | "reserved" | "temporary" | "not-memorix" | "pending-mapping" | "other";
+        note?: string;
+        createdAt?: string;
+        createdBy?: string;
+    }>;
+};
+export type CanonicalMemorixCatalogSnapshot = {
+    appId: string;
+    catalogs: Record<string, Array<{
+        id: string;
+        data: Record<string, unknown>;
+    }>>;
+};
+export type CanonicalMetadataValidationIssue = {
+    code: string;
+    message: string;
+    catalogId?: string;
+    itemId?: string;
+    path?: string;
+};
+export type CanonicalMetadataValidationReport = {
+    ok: boolean;
+    errors: CanonicalMetadataValidationIssue[];
+    warnings: CanonicalMetadataValidationIssue[];
+};
+//# sourceMappingURL=canonical-v2.d.ts.map

package/dist/types/canonical-v2.d.ts.map

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

package/dist/types/canonical-v2.js

@@ -0,0 +1,6 @@
+export const OBJECT_TYPE_DESCRIPTOR_SCHEMA_V2 = "memorix.objectTypeDescriptor.v2";
+export const LIST_DESCRIPTOR_SCHEMA_V2 = "memorix.listDescriptor.v2";
+export const ITEM_DESCRIPTOR_SCHEMA_V2 = "memorix.itemDescriptor.v2";
+export const COMPLETION_MAPPING_SCHEMA_V2 = "memorix.completionMapping.v2";
+export const INVENTORY_POLICY_SCHEMA_V1 = "memorix.inventoryPolicy.v1";
+//# sourceMappingURL=canonical-v2.js.map

package/dist/types/canonical-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-v2.js","sourceRoot":"","sources":["../../src/types/canonical-v2.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,gCAAgC,GAAG,iCAAiC,CAAC;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AACrE,MAAM,CAAC,MAAM,4BAA4B,GAAG,8BAA8B,CAAC;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC"}

package/dist/types/index.d.ts

@@ -58,18 +58,41 @@ export type DescriptorMutationError = {
     code: string;
     message: string;
     path?: string;
+    source?: import("../source/types.js").MemorixSourceRef;
+};
+export type DescriptorMutationWarning = {
+    code: string;
+    message: string;
+    path?: string;
+    source?: import("../source/types.js").MemorixSourceRef;
+};
+export type SourceAwareCataloxWrite = CataloxWriteAction & {
+    source: import("../source/types.js").MemorixSourceRef;
 };
 export type DescriptorMutationResult<T = unknown> = {
     ok: boolean;
     /** Whether the projected full descriptor graph passes integrity validation. */
     graphValid: boolean;
     dryRun: boolean;
+    /** Mutation payload (backward compatible). */
     data?: T;
-    warnings: string[];
+    /** Source-aware wrapper when provenance is available. */
+    sourceAwareData?: import("../source/types.js").SourceAware<T>;
+    warnings: DescriptorMutationWarning[];
     errors: DescriptorMutationError[];
-    cataloxWrites: CataloxWriteAction[];
+    cataloxWrites: SourceAwareCataloxWrite[];
     mongoActions?: MongoAction[];
     integrity: DescriptorIntegrityReport;
+    audit?: {
+        actor?: unknown;
+        reason?: string;
+        changeSetId?: string;
+        writtenTo?: string;
+    };
+    version?: {
+        expectedVersion?: string | number;
+        actualVersion?: string | number;
+    };
     rollbackPlan?: CataloxWriteAction[];
 };
 export type PropertyInput = {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE;QACN,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE;QACP,WAAW,EAAE,KAAK,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,aAAa,CAAC;SACvB,CAAC,CAAC;QACH,kBAAkB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvE,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,GAAG;IACzD,MAAM,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,GAAG,OAAO,IAAI;IAClD,EAAE,EAAE,OAAO,CAAC;IACZ,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,oBAAoB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,EAAE,yBAAyB,EAAE,CAAC;IACtC,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAClC,aAAa,EAAE,uBAAuB,EAAE,CAAC;IACzC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,SAAS,EAAE,yBAAyB,CAAC;IACrC,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACjC,CAAC;IACF,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE;QAClB,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;QAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;KACvD,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EACJ,QAAQ,GACR,WAAW,GACX,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,UAAU,GACV,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,SAAS,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3B,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEN,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;KAC3B,CAAC,CAAC;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,KAAK,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;QACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,IAAI,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,EAAE,CAAC,EAAE;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,QAAQ,GACR,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,OAAO,CAAC;AAEZ,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,uBAAuB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;IAC7D,eAAe,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAChD,CAAC;AAEF,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,kBAAkB,CAAC"}

package/dist/validation/canonical-contamination.d.ts

@@ -0,0 +1,6 @@
+export type ContaminationHit = {
+    path: string;
+    reason: string;
+};
+export declare function findContaminationInDescriptorData(data: Record<string, unknown>, basePath?: string): ContaminationHit[];
+//# sourceMappingURL=canonical-contamination.d.ts.map

package/dist/validation/canonical-contamination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-contamination.d.ts","sourceRoot":"","sources":["../../src/validation/canonical-contamination.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,SAAK,GACZ,gBAAgB,EAAE,CAiCpB"}

package/dist/validation/canonical-contamination.js

@@ -0,0 +1,71 @@
+const FORBIDDEN_FIELD_KEYS = new Set([
+    "entityName",
+    "entityType",
+    "targetEntity",
+    "entity",
+    "MemorixEntityDescriptor",
+    "framework",
+    "narratives-ui-framework",
+    "graphType",
+    "nodes",
+    "canvas",
+]);
+const FORBIDDEN_KIND_VALUES = new Set(["entity"]);
+const FORBIDDEN_MODE_VALUES = new Set(["operational", "design"]);
+const V1_SCHEMA_PREFIXES = [
+    "memorix.entity-descriptor.v1",
+    "memorix.list-descriptor.v1",
+    "memorix.item-descriptor.v1",
+    "memorix.completion-mapping.v1",
+];
+const ALLOWED_V1_SCHEMA_VERSIONS = new Set(["memorix.inventoryPolicy.v1"]);
+export function findContaminationInDescriptorData(data, basePath = "") {
+    const hits = [];
+    if (typeof data.schemaVersion === "string") {
+        const version = data.schemaVersion;
+        if (ALLOWED_V1_SCHEMA_VERSIONS.has(version)) {
+            // inventory policy intentionally remains v1 in canonical metadata
+        }
+        else if (V1_SCHEMA_PREFIXES.some((prefix) => version.startsWith(prefix) || version.endsWith(".v1"))) {
+            hits.push({
+                path: basePath ? `${basePath}.schemaVersion` : "schemaVersion",
+                reason: `Legacy schema version "${version}" is forbidden in canonical metadata`,
+            });
+        }
+    }
+    if (data.kind === "entity" || FORBIDDEN_KIND_VALUES.has(String(data.kind))) {
+        hits.push({
+            path: basePath ? `${basePath}.kind` : "kind",
+            reason: 'List kind "entity" is forbidden; use "object-list"',
+        });
+    }
+    if (FORBIDDEN_MODE_VALUES.has(String(data.mode))) {
+        hits.push({
+            path: basePath ? `${basePath}.mode` : "mode",
+            reason: `Runtime/UI mode "${String(data.mode)}" is forbidden in descriptor metadata`,
+        });
+    }
+    scanObject(data, basePath, hits);
+    return hits;
+}
+function scanObject(value, path, hits) {
+    if (!value || typeof value !== "object")
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((entry, index) => {
+            scanObject(entry, path ? `${path}[${index}]` : `[${index}]`, hits);
+        });
+        return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const childPath = path ? `${path}.${key}` : key;
+        if (FORBIDDEN_FIELD_KEYS.has(key)) {
+            hits.push({
+                path: childPath,
+                reason: `Forbidden legacy or runtime field "${key}"`,
+            });
+        }
+        scanObject(child, childPath, hits);
+    }
+}
+//# sourceMappingURL=canonical-contamination.js.map

package/dist/validation/canonical-contamination.js.map

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

package/dist/validation/canonical-metadata-validation.d.ts

@@ -0,0 +1,13 @@
+import type { CanonicalMemorixCatalogSnapshot, CanonicalMetadataValidationReport } from "../types/canonical-v2.js";
+export declare const FORBIDDEN_LEGACY_CATALOG_IDS: readonly ["memorix-entity-descriptors", "memorix-entities", "memorix_entity_content_types"];
+export declare const FORBIDDEN_LEGACY_ITEM_IDS: readonly ["variabilities-groups", "variabilities-group-detail-item", "variabilities-groups-main-list", "critical-vulnerabilities-list"];
+export type ValidateCanonicalMetadataOptions = {
+    /** When true, legacy catalogs may still be present (post-apply, pre-cleanup). */
+    allowLegacyCatalogs?: boolean;
+};
+export declare function validateCanonicalMemorixCataloxMetadata(snapshot: CanonicalMemorixCatalogSnapshot, options?: ValidateCanonicalMetadataOptions): CanonicalMetadataValidationReport;
+export declare function validateCanonicalMemorixCataloxMetadataFromCatalox(catalox: import("../catalox/client.js").CataloxBoundClient, options?: {
+    appId?: string;
+    allowLegacyCatalogs?: boolean;
+}): Promise<CanonicalMetadataValidationReport>;
+//# sourceMappingURL=canonical-metadata-validation.d.ts.map

package/dist/validation/canonical-metadata-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-metadata-validation.d.ts","sourceRoot":"","sources":["../../src/validation/canonical-metadata-validation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,+BAA+B,EAE/B,iCAAiC,EAElC,MAAM,0BAA0B,CAAC;AAYlC,eAAO,MAAM,4BAA4B,6FAI/B,CAAC;AAEX,eAAO,MAAM,yBAAyB,yIAK5B,CAAC;AAiDX,MAAM,MAAM,gCAAgC,GAAG;IAC7C,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,+BAA+B,EACzC,OAAO,GAAE,gCAAqC,GAC7C,iCAAiC,CA2MnC;AAED,wBAAsB,kDAAkD,CACtE,OAAO,EAAE,OAAO,sBAAsB,EAAE,kBAAkB,EAC1D,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9D,OAAO,CAAC,iCAAiC,CAAC,CAI5C"}