@x12i/memorix-descriptors 1.3.0 → 1.4.0

package/dist/tests/reconcile-unified.test.js

@@ -0,0 +1,214 @@
+import { describe, expect, it } from "vitest";
+import { buildReconcileDraftForSuggestion, buildReconcileSuggestionsFromUnifiedInventory, } from "../reconcile/index.js";
+import { applyReconcileDraft } from "../reconcile/apply.js";
+import { sampleSnapshot } from "./fixtures.js";
+function emptyTargetInventory() {
+    return {
+        databaseName: "entities",
+        declaredCollections: 0,
+        mappedCollections: 0,
+        missingCollections: 0,
+        orphanCollections: 0,
+        emptyDeclaredCollections: 0,
+        mongoCollections: 0,
+    };
+}
+function unifiedInventory(issues, rows = []) {
+    return {
+        sourceLens: "catalox-first",
+        summary: {
+            cataloxObjects: 1,
+            mongoCollections: 1,
+            declaredCollections: 1,
+            mappedCollections: 0,
+            missingCollections: 0,
+            orphanCollections: 0,
+            emptyDeclaredCollections: 0,
+            issueCount: issues.length,
+        },
+        targets: {
+            entity: emptyTargetInventory(),
+            event: { ...emptyTargetInventory(), databaseName: "events" },
+            knowledge: { ...emptyTargetInventory(), databaseName: "knowledge" },
+        },
+        rows,
+        issues,
+        generatedAt: "2026-05-23T00:00:00.000Z",
+    };
+}
+describe("buildReconcileSuggestionsFromUnifiedInventory", () => {
+    it("maps unified inventory issues to reconcile suggestion kinds", () => {
+        const inventory = unifiedInventory([
+            {
+                issueId: "issue-1",
+                severity: "error",
+                kind: "missing-collection",
+                objectName: "assets",
+                contentType: "snapshots",
+                message: "missing",
+                suggestedActions: ["inspect", "fix-binding"],
+            },
+            {
+                issueId: "issue-2",
+                severity: "info",
+                kind: "empty-declared-collection",
+                objectName: "assets",
+                contentType: "snapshots",
+                message: "empty",
+                suggestedActions: ["inspect"],
+            },
+            {
+                issueId: "issue-3",
+                severity: "warning",
+                kind: "orphan-collection",
+                target: "entity",
+                collectionName: "legacy-assets",
+                message: "orphan",
+                suggestedActions: ["create-descriptor"],
+            },
+            {
+                issueId: "issue-4",
+                severity: "warning",
+                kind: "content-type-missing",
+                target: "entity",
+                objectName: "assets",
+                contentType: "enrichment",
+                collectionName: "assets-enrichment",
+                message: "missing ct",
+                suggestedActions: ["add-content-type"],
+            },
+            {
+                issueId: "issue-5",
+                severity: "warning",
+                kind: "collection-mismatch",
+                target: "entity",
+                objectName: "assets",
+                contentType: "snapshots",
+                collectionName: "assets-live",
+                message: "mismatch",
+                suggestedActions: ["fix-binding"],
+            },
+            {
+                issueId: "issue-6",
+                severity: "warning",
+                kind: "unparseable-collection",
+                target: "entity",
+                collectionName: "legacydata",
+                message: "unparseable",
+                suggestedActions: ["inspect", "ignore"],
+            },
+        ], [
+            {
+                rowId: "row-1",
+                target: "entity",
+                databaseName: "entities",
+                objectName: "assets",
+                contentType: "snapshots",
+                collectionName: "assets-live",
+                expectedCollectionName: "assets-snapshots",
+                source: "merged",
+                mappingStatus: "collection-mismatch",
+                counts: { countMode: "none" },
+                actions: ["fix-binding"],
+                issueIds: ["issue-5"],
+            },
+        ]);
+        const suggestions = buildReconcileSuggestionsFromUnifiedInventory(inventory);
+        expect(suggestions).toEqual([
+            {
+                kind: "ensure-collection",
+                entityName: "assets",
+                contentType: "snapshots",
+            },
+            {
+                kind: "empty-declared-collection",
+                entityName: "assets",
+                contentType: "snapshots",
+            },
+            {
+                kind: "create-descriptor-for-orphan",
+                collection: "legacy-assets",
+                target: "entity",
+            },
+            {
+                kind: "add-content-type-for-orphan",
+                target: "entity",
+                collection: "assets-enrichment",
+                parsedObject: "assets",
+                parsedContentType: "enrichment",
+            },
+            {
+                kind: "fix-collection-binding",
+                entityName: "assets",
+                contentType: "snapshots",
+                expectedCollection: "assets-snapshots",
+                actualCollection: "assets-live",
+            },
+            {
+                kind: "unparseable-collection",
+                target: "entity",
+                collectionName: "legacydata",
+            },
+            {
+                kind: "ignore-collection",
+                target: "entity",
+                collectionName: "legacydata",
+            },
+        ]);
+    });
+});
+describe("buildReconcileDraftForSuggestion", () => {
+    it("builds apply-ready drafts for draft-backed suggestions", () => {
+        const snapshot = sampleSnapshot();
+        const addDraft = buildReconcileDraftForSuggestion({
+            kind: "add-content-type-for-orphan",
+            target: "entity",
+            collection: "assets-enrichment",
+            parsedObject: "assets",
+            parsedContentType: "enrichment",
+        }, snapshot);
+        expect(addDraft?.suggestedAction).toBe("addContentType");
+        const fixDraft = buildReconcileDraftForSuggestion({
+            kind: "fix-collection-binding",
+            entityName: "assets",
+            contentType: "snapshots",
+            expectedCollection: "assets-snapshots",
+            actualCollection: "assets-live",
+        }, snapshot);
+        expect(fixDraft?.suggestedAction).toBe("updateContentType");
+    });
+});
+describe("applyReconcileDraft", () => {
+    it("applies add-content-type drafts in dry-run", async () => {
+        const snapshot = sampleSnapshot();
+        const draft = buildReconcileDraftForSuggestion({
+            kind: "add-content-type-for-orphan",
+            target: "entity",
+            collection: "assets-enrichment",
+            parsedObject: "assets",
+            parsedContentType: "enrichment",
+        }, snapshot);
+        expect(draft).toBeTruthy();
+        const result = await applyReconcileDraft({
+            catalox: {},
+            env: process.env,
+            loadSnapshot: async () => snapshot,
+        }, draft, { dryRun: true });
+        expect(result.ok).toBe(true);
+        expect(result.cataloxWrites).toHaveLength(1);
+    });
+    it("rejects manualReview drafts", async () => {
+        const result = await applyReconcileDraft({
+            catalox: {},
+            env: process.env,
+            loadSnapshot: async () => sampleSnapshot(),
+        }, {
+            suggestedAction: "manualReview",
+            draft: { collectionName: "bad" },
+            warnings: ["needs review"],
+        }, { dryRun: true });
+        expect(result.ok).toBe(false);
+        expect(result.errors[0]?.code).toBe("MANUAL_REVIEW_REQUIRED");
+    });
+});
+//# sourceMappingURL=reconcile-unified.test.js.map

package/dist/tests/reconcile-unified.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-descriptors",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Manage Memorix entity, list, and item descriptors in Catalox",
   "type": "module",
   "main": "./dist/index.js",