@x12i/memorix-descriptors 1.4.2 → 1.4.5

package/dist/source/aliases.js

@@ -0,0 +1,60 @@
+export function withObjectTypeAliases(descriptor) {
+    const entityName = typeof descriptor.entityName === "string"
+        ? descriptor.entityName
+        : typeof descriptor.entity === "string"
+            ? descriptor.entity
+            : typeof descriptor.entityType === "string"
+                ? descriptor.entityType
+                : undefined;
+    if (!entityName) {
+        return descriptor;
+    }
+    return {
+        ...descriptor,
+        objectType: entityName,
+        ...(typeof descriptor.entityName === "string"
+            ? { objectName: descriptor.entityName }
+            : {}),
+    };
+}
+export function withEntityDescriptorAliases(descriptor) {
+    return {
+        ...descriptor,
+        objectType: descriptor.entityName,
+        objectName: descriptor.entityName,
+    };
+}
+export function withListDescriptorAliases(descriptor) {
+    const entityRef = "entity" in descriptor && typeof descriptor.entity === "string"
+        ? descriptor.entity
+        : "entityName" in descriptor && typeof descriptor.entityName === "string"
+            ? descriptor.entityName
+            : undefined;
+    if (!entityRef) {
+        return descriptor;
+    }
+    return {
+        ...descriptor,
+        objectType: entityRef,
+    };
+}
+export function withItemDescriptorAliases(descriptor) {
+    return {
+        ...descriptor,
+        objectType: descriptor.entity,
+    };
+}
+export function withSliceDescriptorAliases(descriptor) {
+    return {
+        ...descriptor,
+        entity: descriptor.entityName,
+        objectType: descriptor.entityName,
+    };
+}
+export function withCompletionMappingAliases(mapping) {
+    return {
+        ...mapping,
+        objectType: mapping.entityType,
+    };
+}
+//# sourceMappingURL=aliases.js.map

package/dist/source/aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.js","sourceRoot":"","sources":["../../src/source/aliases.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,qBAAqB,CACnC,UAAa;IAEb,MAAM,UAAU,GACd,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;QACvC,CAAC,CAAC,UAAU,CAAC,UAAU;QACvB,CAAC,CAAC,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;YACrC,CAAC,CAAC,UAAU,CAAC,MAAM;YACnB,CAAC,CAAC,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;gBACzC,CAAC,CAAC,UAAU,CAAC,UAAU;gBACvB,CAAC,CAAC,SAAS,CAAC;IAEpB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,UAA8D,CAAC;IACxE,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,UAAU,EAAE,UAAU;QACtB,GAAG,CAAC,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;YAC3C,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE;YACvC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,UAAmC;IAEnC,OAAO;QACL,GAAG,UAAU;QACb,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAiC;IAEjC,MAAM,SAAS,GACb,QAAQ,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;QAC7D,CAAC,CAAC,UAAU,CAAC,MAAM;QACnB,CAAC,CAAC,YAAY,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ;YACvE,CAAC,CAAC,UAAU,CAAC,UAAU;YACvB,CAAC,CAAC,SAAS,CAAC;IAElB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO;QACL,GAAG,UAAU;QACb,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAiC;IAEjC,OAAO;QACL,GAAG,UAAU;QACb,UAAU,EAAE,UAAU,CAAC,MAAM;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,UAAkC;IAElC,OAAO;QACL,GAAG,UAAU;QACb,MAAM,EAAE,UAAU,CAAC,UAAU;QAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAAiC;IAEjC,OAAO;QACL,GAAG,OAAO;QACV,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;AACJ,CAAC"}

package/dist/source/catalog-health.d.ts

@@ -0,0 +1,17 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { SourceAwareCatalogHealth } from "./types.js";
+export type CatalogProbeResult = {
+    exists: boolean;
+    readable: boolean;
+    items: Array<{
+        id: string;
+        data: Record<string, unknown>;
+    }>;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+export declare function probeCatalogItems(catalox: CataloxBoundClient, catalogId: string): Promise<CatalogProbeResult>;
+export declare function buildCatalogHealth(catalogId: string, probe: CatalogProbeResult): SourceAwareCatalogHealth;
+//# sourceMappingURL=catalog-health.d.ts.map

package/dist/source/catalog-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-health.d.ts","sourceRoot":"","sources":["../../src/source/catalog-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAY3D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAmE7B;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,wBAAwB,CAa1B"}

package/dist/source/catalog-health.js

@@ -0,0 +1,87 @@
+import { MEMORIX_COMPLETION_MAPPINGS_CATALOG } from "../catalog/ids.js";
+import { resolveCatalogRegistryEntry } from "./registry.js";
+function isCatalogNotFoundError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return message.includes("Catalog not found");
+}
+function isCatalogAdapterError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return message.includes("Catalog adapter error");
+}
+export async function probeCatalogItems(catalox, catalogId) {
+    const items = [];
+    let offset = 0;
+    const limit = 200;
+    for (;;) {
+        let page;
+        try {
+            page = await catalox.listCatalogItems(catalogId, { limit, offset });
+        }
+        catch (err) {
+            if (isCatalogNotFoundError(err)) {
+                return { exists: false, readable: false, items: [] };
+            }
+            if (catalogId === MEMORIX_COMPLETION_MAPPINGS_CATALOG &&
+                isCatalogAdapterError(err)) {
+                return {
+                    exists: true,
+                    readable: false,
+                    items: [],
+                    error: {
+                        code: "CATALOG_LIST_FAILED",
+                        message: "Catalog exists but items could not be listed.",
+                    },
+                };
+            }
+            return {
+                exists: true,
+                readable: false,
+                items: [],
+                error: {
+                    code: "CATALOG_LIST_FAILED",
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            };
+        }
+        if (page.listOutcome === "mapping_blocked") {
+            return {
+                exists: true,
+                readable: false,
+                items: [],
+                error: {
+                    code: "CATALOG_LIST_BLOCKED",
+                    message: "Catalog listing blocked by mapping configuration.",
+                },
+            };
+        }
+        for (const item of page.items) {
+            items.push({
+                id: String(item.itemId),
+                data: (item.data ?? {}),
+            });
+        }
+        if (!page.nextCursor && page.items.length < limit) {
+            break;
+        }
+        offset += page.items.length;
+        if (page.items.length === 0) {
+            break;
+        }
+    }
+    return { exists: true, readable: true, items };
+}
+export function buildCatalogHealth(catalogId, probe) {
+    const entry = resolveCatalogRegistryEntry(catalogId);
+    return {
+        catalogId,
+        sourceClass: entry.sourceClass,
+        canonicalStatus: entry.canonicalStatus,
+        descriptorKind: entry.descriptorKind,
+        exists: probe.exists,
+        readable: probe.readable,
+        itemCount: probe.readable ? probe.items.length : undefined,
+        error: probe.error,
+        editable: entry.editable,
+    };
+}
+//# sourceMappingURL=catalog-health.js.map

package/dist/source/catalog-health.js.map

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

package/dist/source/envelope.d.ts

@@ -0,0 +1,29 @@
+import type { MemorixTarget } from "../types/index.js";
+import type { MemorixDescriptorKind, MemorixSourceRef, SourceAware } from "./types.js";
+export declare function nowIso(): string;
+export declare function buildCatalogItemSourceRef(options: {
+    catalogId: string;
+    itemId: string;
+    appId?: string;
+    loadedAt?: string;
+    objectType?: string;
+    entityName?: string;
+    target?: MemorixTarget;
+    contentType?: string;
+    descriptorKind?: MemorixDescriptorKind;
+}): MemorixSourceRef;
+export declare function buildObjectTypeSourceRef(itemId: string, appId?: string, loadedAt?: string, objectType?: string, target?: MemorixTarget): MemorixSourceRef;
+export declare function buildListSourceRef(itemId: string, appId?: string, loadedAt?: string, objectType?: string, kind?: "list" | "slice"): MemorixSourceRef;
+export declare function buildItemSourceRef(itemId: string, appId?: string, loadedAt?: string, objectType?: string): MemorixSourceRef;
+export declare function buildMappingSourceRef(itemId: string, appId?: string, loadedAt?: string, objectType?: string, target?: MemorixTarget): MemorixSourceRef;
+export declare function buildInventoryPolicySourceRef(appId?: string, loadedAt?: string): MemorixSourceRef;
+export declare function buildDerivedGraphSourceRef(generatedBy?: string, loadedAt?: string): MemorixSourceRef;
+export declare function buildLocalUiStateSourceRef(loadedAt?: string, trustWarning?: string): MemorixSourceRef;
+export declare function buildUnknownSourceRef(loadedAt?: string, trustWarning?: string): MemorixSourceRef;
+export declare function wrapSourceAware<T>(data: T, source: MemorixSourceRef): SourceAware<T>;
+export declare function sourceRefForCataloxWrite(write: {
+    catalogId: string;
+    itemId: string;
+    action: string;
+}, appId?: string, loadedAt?: string): MemorixSourceRef;
+//# sourceMappingURL=envelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/source/envelope.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIvD,OAAO,KAAK,EACV,qBAAqB,EACrB,gBAAgB,EAChB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,qBAAqB,CAAC;CACxC,GAAG,gBAAgB,CAmBnB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,aAAa,GACrB,gBAAgB,CAYlB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GACtB,gBAAgB,CAUlB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAUlB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,aAAa,GACrB,gBAAgB,CAWlB;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,CAQlB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,SAAwB,EACnC,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,CAYlB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAUlB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAUlB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,gBAAgB,GACvB,WAAW,CAAC,CAAC,CAAC,CAEhB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5D,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,CAOlB"}

package/dist/source/envelope.js

@@ -0,0 +1,125 @@
+import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
+import { resolveCatalogRegistryEntry, } from "./registry.js";
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function buildCatalogItemSourceRef(options) {
+    const loadedAt = options.loadedAt ?? nowIso();
+    const entry = resolveCatalogRegistryEntry(options.catalogId);
+    return {
+        sourceClass: entry.sourceClass,
+        canonicalStatus: entry.canonicalStatus,
+        appId: options.appId,
+        catalogId: options.catalogId,
+        itemId: options.itemId,
+        firestoreCollection: options.catalogId,
+        descriptorKind: options.descriptorKind ?? entry.descriptorKind,
+        objectType: options.objectType,
+        entityName: options.entityName ?? options.objectType,
+        target: options.target,
+        contentType: options.contentType,
+        loadedAt,
+        editable: entry.editable,
+        trustWarning: entry.trustWarning,
+    };
+}
+export function buildObjectTypeSourceRef(itemId, appId, loadedAt, objectType, target) {
+    const ot = objectType ?? itemId;
+    return buildCatalogItemSourceRef({
+        catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+        itemId,
+        appId,
+        loadedAt,
+        objectType: ot,
+        entityName: ot,
+        target,
+        descriptorKind: "object-type",
+    });
+}
+export function buildListSourceRef(itemId, appId, loadedAt, objectType, kind) {
+    return buildCatalogItemSourceRef({
+        catalogId: MEMORIX_LIST_DESCRIPTORS_CATALOG,
+        itemId,
+        appId,
+        loadedAt,
+        objectType,
+        entityName: objectType,
+        descriptorKind: kind === "slice" ? "slice" : "list",
+    });
+}
+export function buildItemSourceRef(itemId, appId, loadedAt, objectType) {
+    return buildCatalogItemSourceRef({
+        catalogId: MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+        itemId,
+        appId,
+        loadedAt,
+        objectType,
+        entityName: objectType,
+        descriptorKind: "item",
+    });
+}
+export function buildMappingSourceRef(itemId, appId, loadedAt, objectType, target) {
+    return buildCatalogItemSourceRef({
+        catalogId: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+        itemId,
+        appId,
+        loadedAt,
+        objectType,
+        entityName: objectType,
+        target,
+        descriptorKind: "completion-mapping",
+    });
+}
+export function buildInventoryPolicySourceRef(appId, loadedAt) {
+    return buildCatalogItemSourceRef({
+        catalogId: MEMORIX_INVENTORY_POLICIES_CATALOG,
+        itemId: MEMORIX_INVENTORY_POLICY_ITEM_ID,
+        appId,
+        loadedAt,
+        descriptorKind: "inventory-policy",
+    });
+}
+export function buildDerivedGraphSourceRef(generatedBy = "memorix-descriptors", loadedAt) {
+    const at = loadedAt ?? nowIso();
+    return {
+        sourceClass: "runtime-projection",
+        canonicalStatus: "derived",
+        loadedAt: at,
+        generatedAt: at,
+        generatedBy,
+        editable: "not-editable",
+        trustWarning: "Derived descriptor graph projection. Not canonical Catalox metadata.",
+    };
+}
+export function buildLocalUiStateSourceRef(loadedAt, trustWarning) {
+    return {
+        sourceClass: "local-ui-state",
+        canonicalStatus: "local",
+        loadedAt: loadedAt ?? nowIso(),
+        editable: "not-editable",
+        trustWarning: trustWarning ??
+            "Local Explorer UI state. Not canonical descriptor metadata.",
+    };
+}
+export function buildUnknownSourceRef(loadedAt, trustWarning) {
+    return {
+        sourceClass: "unknown-source",
+        canonicalStatus: "unknown",
+        loadedAt: loadedAt ?? nowIso(),
+        editable: "not-editable",
+        trustWarning: trustWarning ??
+            "Source cannot be proven as descriptor catalog metadata.",
+    };
+}
+export function wrapSourceAware(data, source) {
+    return { data, source };
+}
+export function sourceRefForCataloxWrite(write, appId, loadedAt) {
+    return buildCatalogItemSourceRef({
+        catalogId: write.catalogId,
+        itemId: write.itemId,
+        appId,
+        loadedAt,
+    });
+}
+//# sourceMappingURL=envelope.js.map

package/dist/source/envelope.js.map

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

package/dist/source/graph.d.ts

@@ -0,0 +1,12 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { SourceAwareDescriptorGraph } from "./types.js";
+import { type ValidateSourceAwareMemorixDescriptorsOptions } from "./validation.js";
+export type GetSourceAwareDescriptorGraphOptions = {
+    appId?: string;
+    includeSourceRefs?: boolean;
+    includeValidation?: boolean;
+    includeReferences?: boolean;
+};
+export declare function getSourceAwareDescriptorGraph(catalox: CataloxBoundClient, options?: GetSourceAwareDescriptorGraphOptions): Promise<SourceAwareDescriptorGraph>;
+export type { ValidateSourceAwareMemorixDescriptorsOptions };
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/source/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAEL,KAAK,4CAA4C,EAClD,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,oCAAoC,GAAG;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAgDF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,oCAAyC,GACjD,OAAO,CAAC,0BAA0B,CAAC,CAqHrC;AAED,YAAY,EAAE,4CAA4C,EAAE,CAAC"}

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