@x12i/memorix-descriptors 1.4.2 → 1.5.0

package/dist/source/graph.js

@@ -0,0 +1,148 @@
+import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
+import { buildDescriptorGraph } from "../integrity/graph.js";
+import { buildDerivedGraphSourceRef, nowIso } from "./envelope.js";
+import { loadSourceAwareDescriptorSnapshot } from "./snapshot.js";
+import { validateSourceAwareMemorixDescriptors, } from "./validation.js";
+function nodeKindFromGraphKind(kind, edgeKind) {
+    if (edgeKind?.startsWith("relation:"))
+        return "relation";
+    if (kind === "entity")
+        return "object-type-descriptor";
+    if (kind === "list") {
+        if (edgeKind === "slice")
+            return "slice-descriptor";
+        return "list-descriptor";
+    }
+    if (kind === "item")
+        return "item-descriptor";
+    if (kind === "mapping")
+        return "completion-mapping";
+    return "list-descriptor";
+}
+function catalogForNodeKind(kind) {
+    switch (kind) {
+        case "object-type-descriptor":
+            return MEMORIX_ENTITY_DESCRIPTORS_CATALOG;
+        case "list-descriptor":
+        case "slice-descriptor":
+            return MEMORIX_LIST_DESCRIPTORS_CATALOG;
+        case "item-descriptor":
+            return MEMORIX_ITEM_DESCRIPTORS_CATALOG;
+        case "completion-mapping":
+            return MEMORIX_COMPLETION_MAPPINGS_CATALOG;
+        case "inventory-policy":
+            return MEMORIX_INVENTORY_POLICIES_CATALOG;
+        default:
+            return MEMORIX_ENTITY_DESCRIPTORS_CATALOG;
+    }
+}
+function mapEdgeKind(kind) {
+    if (kind === "default-list")
+        return "default-list";
+    if (kind === "default-item")
+        return "default-item";
+    if (kind === "entity-list")
+        return "list-of-object-type";
+    if (kind === "slice")
+        return "slice-of-object-type";
+    if (kind === "entity-item")
+        return "item-of-object-type";
+    if (kind === "mapping-entity")
+        return "mapping-target";
+    if (kind.startsWith("relation:"))
+        return "relation-target";
+    return "list-of-object-type";
+}
+export async function getSourceAwareDescriptorGraph(catalox, options = {}) {
+    const loadedAt = nowIso();
+    const appId = options.appId ?? "memorix";
+    const includeValidation = options.includeValidation ?? true;
+    const sourceSnapshot = await loadSourceAwareDescriptorSnapshot(catalox, { appId });
+    const snapshot = {
+        entityDescriptors: Object.fromEntries(sourceSnapshot.canonical.objectTypes.map((e) => [e.source.itemId, e.data])),
+        listDescriptors: Object.fromEntries([
+            ...sourceSnapshot.canonical.lists.map((l) => [l.source.itemId, l.data]),
+            ...sourceSnapshot.canonical.slices.map((s) => [s.source.itemId, s.data]),
+        ]),
+        itemDescriptors: Object.fromEntries(sourceSnapshot.canonical.items.map((i) => [i.source.itemId, i.data])),
+        completionMappings: Object.fromEntries(sourceSnapshot.controlPlane.completionMappings.map((m) => [m.source.itemId, m.data])),
+        inventoryPolicy: sourceSnapshot.controlPlane.inventoryPolicies[0]?.data ?? null,
+    };
+    const graph = buildDescriptorGraph(snapshot);
+    const graphSource = buildDerivedGraphSourceRef("memorix-descriptors", loadedAt);
+    const issueCodesByNode = new Map();
+    let validationIssues = [];
+    if (includeValidation) {
+        const validation = await validateSourceAwareMemorixDescriptors(catalox, {
+            appId,
+            includeCatalogHealth: false,
+            includeLegacyWarnings: false,
+        });
+        validationIssues = validation.issues;
+        for (const issue of validation.issues) {
+            const nodeId = issue.path?.split("/")[0] ?? issue.source.itemId;
+            if (!nodeId)
+                continue;
+            const current = issueCodesByNode.get(nodeId) ?? "valid";
+            if (issue.severity === "error") {
+                issueCodesByNode.set(nodeId, "error");
+            }
+            else if (issue.severity === "warning" && current !== "error") {
+                issueCodesByNode.set(nodeId, "warning");
+            }
+        }
+    }
+    const sliceIds = new Set(sourceSnapshot.canonical.slices.map((s) => s.source.itemId));
+    const nodes = graph.nodes.map((node) => {
+        const isSlice = sliceIds.has(node.id);
+        const nodeKind = nodeKindFromGraphKind(node.kind, isSlice ? "slice" : undefined);
+        const catalogId = catalogForNodeKind(nodeKind);
+        const entityEntry = sourceSnapshot.canonical.objectTypes.find((e) => e.source.itemId === node.id);
+        return {
+            id: node.id,
+            label: node.label,
+            kind: nodeKind,
+            source: {
+                ...graphSource,
+                catalogId,
+                itemId: node.id,
+                descriptorKind: nodeKind === "object-type-descriptor"
+                    ? "object-type"
+                    : nodeKind === "slice-descriptor"
+                        ? "slice"
+                        : nodeKind === "list-descriptor"
+                            ? "list"
+                            : nodeKind === "item-descriptor"
+                                ? "item"
+                                : nodeKind === "completion-mapping"
+                                    ? "completion-mapping"
+                                    : undefined,
+                objectType: entityEntry?.data.entityName ?? (node.kind === "entity" ? node.label : undefined),
+                target: (entityEntry?.data.target ?? node.target),
+            },
+            objectType: entityEntry?.data.entityName,
+            target: (entityEntry?.data.target ?? node.target),
+            catalogId,
+            itemId: node.id,
+            validationStatus: issueCodesByNode.get(node.id) ?? "valid",
+        };
+    });
+    const edges = graph.edges.map((edge, index) => ({
+        id: `edge-${index}`,
+        kind: mapEdgeKind(edge.kind),
+        from: edge.from,
+        to: edge.to,
+        source: graphSource,
+        path: edge.kind,
+    }));
+    return {
+        generatedAt: loadedAt,
+        graphKind: "descriptor-graph",
+        sourceClass: "runtime-projection",
+        canonicalStatus: "derived",
+        nodes,
+        edges,
+        issues: validationIssues,
+    };
+}
+//# sourceMappingURL=graph.js.map

package/dist/source/graph.js.map

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

package/dist/source/guards.d.ts

@@ -0,0 +1,7 @@
+import type { MemorixSourceRef, SourceNotEditableError } from "./types.js";
+export declare function assertSourceEditable(source: MemorixSourceRef): void;
+export declare function createSourceNotEditableError(source: MemorixSourceRef): SourceNotEditableError & Error;
+export declare function isSourceEditable(source: MemorixSourceRef): boolean;
+export declare function classifyUnprovenJson(value: unknown, loadedAt?: string): MemorixSourceRef;
+export declare function rejectMutationForUnprovenSource(value: unknown, loadedAt?: string): SourceNotEditableError | null;
+//# sourceMappingURL=guards.d.ts.map

package/dist/source/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/source/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG3E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAQnE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,gBAAgB,GACvB,sBAAsB,GAAG,KAAK,CAQhC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAOlE;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,CA+ClB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI,CAM/B"}

package/dist/source/guards.js

@@ -0,0 +1,74 @@
+import { isEditableSourceClass } from "./registry.js";
+export function assertSourceEditable(source) {
+    if (source.editable === "editable") {
+        return;
+    }
+    if (isEditableSourceClass(source.sourceClass) && source.editable !== "not-editable") {
+        return;
+    }
+    throw createSourceNotEditableError(source);
+}
+export function createSourceNotEditableError(source) {
+    const error = new Error("This source is not editable by memorix-descriptors.");
+    error.code = "SOURCE_NOT_EDITABLE";
+    error.message = "This source is not editable by memorix-descriptors.";
+    error.source = source;
+    return error;
+}
+export function isSourceEditable(source) {
+    try {
+        assertSourceEditable(source);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function classifyUnprovenJson(value, loadedAt) {
+    const at = loadedAt ?? new Date().toISOString();
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return {
+            sourceClass: "unknown-source",
+            canonicalStatus: "unknown",
+            loadedAt: at,
+            editable: "not-editable",
+            trustWarning: "Value is not a descriptor catalog item object.",
+        };
+    }
+    const record = value;
+    if (record.framework === "narratives-ui-framework") {
+        return {
+            sourceClass: "local-ui-state",
+            canonicalStatus: "local",
+            loadedAt: at,
+            editable: "not-editable",
+            trustWarning: "Explorer canvas / narratives-ui-framework document. Not canonical descriptor metadata.",
+        };
+    }
+    if (record.graphType !== undefined &&
+        record.nodes !== undefined &&
+        record.mode !== undefined) {
+        return {
+            sourceClass: "runtime-projection",
+            canonicalStatus: "derived",
+            loadedAt: at,
+            editable: "not-editable",
+            trustWarning: "Runtime graph projection JSON. Not canonical Catalox descriptor metadata.",
+        };
+    }
+    return {
+        sourceClass: "unknown-source",
+        canonicalStatus: "unknown",
+        loadedAt: at,
+        editable: "not-editable",
+        trustWarning: "Source cannot be proven as a descriptor catalog item.",
+    };
+}
+export function rejectMutationForUnprovenSource(value, loadedAt) {
+    const source = classifyUnprovenJson(value, loadedAt);
+    if (isSourceEditable(source)) {
+        return null;
+    }
+    return createSourceNotEditableError(source);
+}
+//# sourceMappingURL=guards.js.map

package/dist/source/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/source/guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,UAAU,oBAAoB,CAAC,MAAwB;IAC3D,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,cAAc,EAAE,CAAC;QACpF,OAAO;IACT,CAAC;IACD,MAAM,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,MAAwB;IAExB,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,qDAAqD,CACpB,CAAC;IACpC,KAAK,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,KAAK,CAAC,OAAO,GAAG,qDAAqD,CAAC;IACtE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,IAAI,CAAC;QACH,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,QAAiB;IAEjB,MAAM,EAAE,GAAG,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO;YACL,WAAW,EAAE,gBAAgB;YAC7B,eAAe,EAAE,SAAS;YAC1B,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,cAAc;YACxB,YAAY,EAAE,gDAAgD;SAC/D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAEhD,IAAI,MAAM,CAAC,SAAS,KAAK,yBAAyB,EAAE,CAAC;QACnD,OAAO;YACL,WAAW,EAAE,gBAAgB;YAC7B,eAAe,EAAE,OAAO;YACxB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,cAAc;YACxB,YAAY,EACV,wFAAwF;SAC3F,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,SAAS,KAAK,SAAS;QAC9B,MAAM,CAAC,KAAK,KAAK,SAAS;QAC1B,MAAM,CAAC,IAAI,KAAK,SAAS,EACzB,CAAC;QACD,OAAO;YACL,WAAW,EAAE,oBAAoB;YACjC,eAAe,EAAE,SAAS;YAC1B,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,cAAc;YACxB,YAAY,EACV,2EAA2E;SAC9E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,gBAAgB;QAC7B,eAAe,EAAE,SAAS;QAC1B,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,cAAc;QACxB,YAAY,EAAE,uDAAuD;KACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAc,EACd,QAAiB;IAEjB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/dist/source/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./types.js";
+export * from "./registry.js";
+export * from "./envelope.js";
+export * from "./aliases.js";
+export * from "./guards.js";
+export * from "./catalog-health.js";
+export * from "./snapshot.js";
+export * from "./validation.js";
+export * from "./graph.js";
+export * from "./inspectable.js";
+export * from "./action-drafts.js";
+export * from "./reconcile-source.js";
+export { listSliceDescriptorsFromSnapshot as listSliceDescriptors, } from "./snapshot.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EACL,gCAAgC,IAAI,oBAAoB,GACzD,MAAM,eAAe,CAAC"}

package/dist/source/index.js

@@ -0,0 +1,14 @@
+export * from "./types.js";
+export * from "./registry.js";
+export * from "./envelope.js";
+export * from "./aliases.js";
+export * from "./guards.js";
+export * from "./catalog-health.js";
+export * from "./snapshot.js";
+export * from "./validation.js";
+export * from "./graph.js";
+export * from "./inspectable.js";
+export * from "./action-drafts.js";
+export * from "./reconcile-source.js";
+export { listSliceDescriptorsFromSnapshot as listSliceDescriptors, } from "./snapshot.js";
+//# sourceMappingURL=index.js.map

package/dist/source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EACL,gCAAgC,IAAI,oBAAoB,GACzD,MAAM,eAAe,CAAC"}

package/dist/source/inspectable.d.ts

@@ -0,0 +1,11 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { MemorixInspectableSources } from "./types.js";
+export type ListInspectableMemorixSourcesOptions = {
+    appId?: string;
+    includeCanonical?: boolean;
+    includeControlPlane?: boolean;
+    includeLegacy?: boolean;
+    includeParallel?: boolean;
+};
+export declare function listInspectableMemorixSources(catalox: CataloxBoundClient, options?: ListInspectableMemorixSourcesOptions): Promise<MemorixInspectableSources>;
+//# sourceMappingURL=inspectable.d.ts.map

package/dist/source/inspectable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectable.d.ts","sourceRoot":"","sources":["../../src/source/inspectable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAkB/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,oCAAoC,GAAG;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AA0BF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,oCAAyC,GACjD,OAAO,CAAC,yBAAyB,CAAC,CAwJpC"}

package/dist/source/inspectable.js

@@ -0,0 +1,167 @@
+import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
+import { nowIso } from "./envelope.js";
+import { probeCatalogItems } from "./catalog-health.js";
+import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, getMemorixCatalogSourceRegistry, resolveCatalogRegistryEntry, buildUnknownCatalogSourceRef, } from "./registry.js";
+const GROUP_META = {
+    "canonical-descriptors": {
+        title: "Canonical descriptors",
+        description: "Canonical Catalox descriptor catalogs managed by memorix-descriptors.",
+    },
+    "control-plane": {
+        title: "Control-plane metadata",
+        description: "Completion mappings and inventory policies.",
+    },
+    "legacy-catalogs": {
+        title: "Legacy catalogs",
+        description: "Deprecated Catalox catalogs. Not canonical descriptor sources.",
+    },
+    "parallel-catalogs": {
+        title: "Parallel catalogs",
+        description: "Separate product tracks that are not object type descriptors.",
+    },
+    unknown: {
+        title: "Unknown",
+        description: "Unregistered catalog ids detected during listing.",
+    },
+};
+export async function listInspectableMemorixSources(catalox, options = {}) {
+    const loadedAt = nowIso();
+    const appId = options.appId ?? "memorix";
+    const includeCanonical = options.includeCanonical ?? true;
+    const includeControlPlane = options.includeControlPlane ?? true;
+    const includeLegacy = options.includeLegacy ?? true;
+    const includeParallel = options.includeParallel ?? true;
+    const groups = [];
+    if (includeCanonical) {
+        const catalogIds = [
+            MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+            MEMORIX_LIST_DESCRIPTORS_CATALOG,
+            MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+        ];
+        const sources = await Promise.all(catalogIds.map(async (catalogId) => {
+            const probe = await probeCatalogItems(catalox, catalogId);
+            const entry = resolveCatalogRegistryEntry(catalogId);
+            return {
+                source: {
+                    sourceClass: entry.sourceClass,
+                    canonicalStatus: entry.canonicalStatus,
+                    appId,
+                    catalogId,
+                    firestoreCollection: catalogId,
+                    descriptorKind: entry.descriptorKind,
+                    loadedAt,
+                    editable: entry.editable,
+                    trustWarning: entry.trustWarning,
+                },
+                title: catalogId,
+                subtitle: entry.descriptorKind,
+                itemCount: probe.readable ? probe.items.length : undefined,
+                warnings: probe.error ? [probe.error.message] : undefined,
+            };
+        }));
+        groups.push({
+            groupId: "canonical-descriptors",
+            ...GROUP_META["canonical-descriptors"],
+            sources,
+        });
+    }
+    if (includeControlPlane) {
+        const catalogIds = [
+            MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+            MEMORIX_INVENTORY_POLICIES_CATALOG,
+        ];
+        const sources = await Promise.all(catalogIds.map(async (catalogId) => {
+            const probe = await probeCatalogItems(catalox, catalogId);
+            const entry = resolveCatalogRegistryEntry(catalogId);
+            return {
+                source: {
+                    sourceClass: entry.sourceClass,
+                    canonicalStatus: entry.canonicalStatus,
+                    appId,
+                    catalogId,
+                    firestoreCollection: catalogId,
+                    descriptorKind: entry.descriptorKind,
+                    loadedAt,
+                    editable: entry.editable,
+                },
+                title: catalogId,
+                subtitle: entry.descriptorKind,
+                itemCount: probe.readable ? probe.items.length : undefined,
+                warnings: probe.error ? [probe.error.message] : undefined,
+            };
+        }));
+        groups.push({
+            groupId: "control-plane",
+            ...GROUP_META["control-plane"],
+            sources,
+        });
+    }
+    if (includeLegacy) {
+        const catalogIds = [LEGACY_SCHEMA_INFERENCE_CATALOG, LEGACY_GLOBAL_CONTENT_TYPE_CATALOG];
+        const sources = await Promise.all(catalogIds.map(async (catalogId) => {
+            const probe = await probeCatalogItems(catalox, catalogId);
+            const entry = resolveCatalogRegistryEntry(catalogId);
+            return {
+                source: buildUnknownCatalogSourceRef(catalogId, loadedAt, appId),
+                title: catalogId,
+                subtitle: entry.descriptorKind,
+                itemCount: probe.readable ? probe.items.length : undefined,
+                warnings: entry.trustWarning ? [entry.trustWarning] : undefined,
+            };
+        }));
+        groups.push({
+            groupId: "legacy-catalogs",
+            ...GROUP_META["legacy-catalogs"],
+            sources,
+        });
+    }
+    if (includeParallel) {
+        const probe = await probeCatalogItems(catalox, PARALLEL_KNOWLEDGE_CATALOG);
+        const entry = resolveCatalogRegistryEntry(PARALLEL_KNOWLEDGE_CATALOG);
+        groups.push({
+            groupId: "parallel-catalogs",
+            ...GROUP_META["parallel-catalogs"],
+            sources: [
+                {
+                    source: buildUnknownCatalogSourceRef(PARALLEL_KNOWLEDGE_CATALOG, loadedAt, appId),
+                    title: PARALLEL_KNOWLEDGE_CATALOG,
+                    subtitle: entry.descriptorKind,
+                    itemCount: probe.readable ? probe.items.length : undefined,
+                    warnings: entry.trustWarning ? [entry.trustWarning] : undefined,
+                },
+            ],
+        });
+    }
+    const registry = getMemorixCatalogSourceRegistry();
+    const knownIds = new Set(Object.keys(registry.catalogs));
+    const unknownSources = [];
+    try {
+        const listCatalogs = catalox.listCatalogs;
+        if (listCatalogs) {
+            const page = await listCatalogs({ limit: 500 });
+            for (const catalog of page.catalogs ?? []) {
+                const catalogId = String(catalog.catalogId ?? catalog.id ?? "");
+                if (!catalogId || knownIds.has(catalogId))
+                    continue;
+                unknownSources.push({
+                    source: buildUnknownCatalogSourceRef(catalogId, loadedAt, appId),
+                    title: catalogId,
+                    subtitle: "unknown-source",
+                    warnings: ["Unregistered catalog id detected."],
+                });
+            }
+        }
+    }
+    catch {
+        // listing all catalogs may not be supported — skip unknown group
+    }
+    if (unknownSources.length > 0) {
+        groups.push({
+            groupId: "unknown",
+            ...GROUP_META.unknown,
+            sources: unknownSources,
+        });
+    }
+    return { groups };
+}
+//# sourceMappingURL=inspectable.js.map

package/dist/source/inspectable.js.map

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

package/dist/source/reconcile-source.d.ts

@@ -0,0 +1,10 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { EntityMutationContext } from "../mutations/entity.js";
+import { type ReconcileDescriptorsOptions } from "../reconcile/index.js";
+import type { SourceAwareReconcileReport } from "./types.js";
+export declare function reconcileDescriptorsWithMongoSourceAware(options: ReconcileDescriptorsOptions): Promise<SourceAwareReconcileReport>;
+export declare function reconcileDescriptorsWithMongoFromAdmin(ctx: EntityMutationContext & {
+    appId: string;
+}, reconcileOptions?: Omit<ReconcileDescriptorsOptions, "catalox" | "appId" | "processEnv" | "xronox">): Promise<SourceAwareReconcileReport>;
+export declare function loadSourceAwareDescriptorSnapshotFromAdmin(catalox: CataloxBoundClient, appId: string, options?: import("./snapshot.js").LoadSourceAwareDescriptorSnapshotOptions): Promise<import("./types.js").SourceAwareDescriptorSnapshot>;
+//# sourceMappingURL=reconcile-source.d.ts.map

package/dist/source/reconcile-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-source.d.ts","sourceRoot":"","sources":["../../src/source/reconcile-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAuBrC;AAED,wBAAsB,sCAAsC,CAC1D,GAAG,EAAE,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9C,gBAAgB,GAAE,IAAI,CACpB,2BAA2B,EAC3B,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,QAAQ,CACzC,GACL,OAAO,CAAC,0BAA0B,CAAC,CAQrC;AAED,wBAAsB,0CAA0C,CAC9D,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO,eAAe,EAAE,wCAAwC,+DAI3E"}

package/dist/source/reconcile-source.js

@@ -0,0 +1,40 @@
+import { loadDescriptorSnapshot } from "../store/snapshot.js";
+import { reconcileDescriptorsWithMongo, } from "../reconcile/index.js";
+import { buildDerivedGraphSourceRef, nowIso } from "./envelope.js";
+import { buildDescriptorActionDraftForSuggestion, } from "./action-drafts.js";
+export async function reconcileDescriptorsWithMongoSourceAware(options) {
+    const loadedAt = nowIso();
+    const result = await reconcileDescriptorsWithMongo(options);
+    const snapshot = await loadDescriptorSnapshot(options.catalox);
+    const env = options.processEnv ?? process.env;
+    const drafts = [];
+    for (const suggestion of result.suggestions) {
+        const draft = buildDescriptorActionDraftForSuggestion(suggestion, snapshot, env);
+        if (draft) {
+            drafts.push(draft);
+        }
+    }
+    return {
+        loadedAt,
+        inventory: result.inventory,
+        suggestions: result.suggestions,
+        issues: result.issues,
+        applied: result.applied,
+        drafts,
+        source: buildDerivedGraphSourceRef("reconcileDescriptorsWithMongo", loadedAt),
+    };
+}
+export async function reconcileDescriptorsWithMongoFromAdmin(ctx, reconcileOptions = {}) {
+    return reconcileDescriptorsWithMongoSourceAware({
+        catalox: ctx.catalox,
+        appId: ctx.appId,
+        processEnv: ctx.env,
+        xronox: ctx.xronox,
+        ...reconcileOptions,
+    });
+}
+export async function loadSourceAwareDescriptorSnapshotFromAdmin(catalox, appId, options) {
+    const { loadSourceAwareDescriptorSnapshot } = await import("./snapshot.js");
+    return loadSourceAwareDescriptorSnapshot(catalox, { appId, ...options });
+}
+//# sourceMappingURL=reconcile-source.js.map

package/dist/source/reconcile-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-source.js","sourceRoot":"","sources":["../../src/source/reconcile-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EACL,6BAA6B,GAE9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,uCAAuC,GACxC,MAAM,oBAAoB,CAAC;AAI5B,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,OAAoC;IAEpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAE9C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,uCAAuC,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjF,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM;QACN,MAAM,EAAE,0BAA0B,CAAC,+BAA+B,EAAE,QAAQ,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,GAA8C,EAC9C,mBAGI,EAAE;IAEN,OAAO,wCAAwC,CAAC;QAC9C,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,GAAG;QACnB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,gBAAgB;KACpB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0CAA0C,CAC9D,OAA2B,EAC3B,KAAa,EACb,OAA0E;IAE1E,MAAM,EAAE,iCAAiC,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC5E,OAAO,iCAAiC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/source/registry.d.ts

@@ -0,0 +1,9 @@
+import type { MemorixCatalogSourceRegistry, MemorixCatalogSourceRegistryEntry, MemorixSourceClass, MemorixSourceRef } from "./types.js";
+export { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, } from "../catalog/ids.js";
+export declare function getMemorixCatalogSourceRegistry(): MemorixCatalogSourceRegistry;
+export declare function resolveCatalogRegistryEntry(catalogId: string): MemorixCatalogSourceRegistryEntry;
+export declare function isEditableSourceClass(sourceClass: MemorixSourceClass): boolean;
+export declare function isKnownCatalogId(catalogId: string): boolean;
+export declare function listKnownCatalogIds(): string[];
+export declare function buildUnknownCatalogSourceRef(catalogId: string, loadedAt: string, appId?: string): MemorixSourceRef;
+//# sourceMappingURL=registry.d.ts.map

package/dist/source/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/source/registry.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,4BAA4B,EAC5B,iCAAiC,EACjC,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kCAAkC,EAClC,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AA2E3B,wBAAgB,+BAA+B,IAAI,4BAA4B,CAS9E;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,GAChB,iCAAiC,CAcnC;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAI9E;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,gBAAgB,CAYlB"}