@x12i/memorix-descriptors 1.4.2 → 1.5.0

package/dist/source/action-drafts.js

@@ -0,0 +1,191 @@
+import { randomUUID } from "node:crypto";
+import { buildAddContentTypeDraftFromCollection, buildDescriptorDraftFromOrphanCollection, buildFixCollectionBindingDraft, buildIgnoreCollectionDraft, } from "../reconcile/drafts.js";
+import { buildDerivedGraphSourceRef, nowIso } from "./envelope.js";
+function draftActionFromSuggested(suggestedAction) {
+    switch (suggestedAction) {
+        case "registerEntityDescriptor":
+            return "register-object-type";
+        case "addContentType":
+            return "add-content-type";
+        case "updateContentType":
+            return "fix-collection-binding";
+        case "ignoreCollection":
+            return "ignore-collection";
+        case "manualReview":
+            return "manual-review";
+        default:
+            return "manual-review";
+    }
+}
+function proposedMutationFromDraft(draft) {
+    switch (draft.suggestedAction) {
+        case "registerEntityDescriptor":
+            return { method: "registerEntityDescriptor", input: draft.draft };
+        case "addContentType":
+            return { method: "addContentType", input: draft.draft };
+        case "updateContentType":
+            return { method: "updateContentType", input: draft.draft };
+        case "ignoreCollection":
+            return { method: "ignoreCollection", input: draft.draft };
+        default:
+            return { method: "registerEntityDescriptor", input: draft.draft };
+    }
+}
+function requiredUserInputsFromDraft(draft) {
+    if (draft.suggestedAction !== "manualReview") {
+        return undefined;
+    }
+    const inputs = [];
+    if (!draft.draft.entityName && !draft.draft.objectType) {
+        inputs.push({
+            key: "objectType",
+            label: "Object type",
+            reason: "Collection name could not be safely parsed.",
+            required: true,
+        });
+    }
+    if (draft.warnings.some((w) => w.includes("does not match"))) {
+        inputs.push({
+            key: "confirmObjectType",
+            label: "Confirm object type",
+            reason: "Parsed object type does not match the expected entity.",
+            required: true,
+        });
+    }
+    return inputs.length > 0 ? inputs : undefined;
+}
+export function toDescriptorActionDraft(draft, options = {}) {
+    const loadedAt = nowIso();
+    const source = buildDerivedGraphSourceRef("reconcile-draft-builder", loadedAt);
+    source.sourceClass = "runtime-projection";
+    source.canonicalStatus = "derived";
+    source.collectionName = options.targetCollection;
+    source.databaseName = options.target;
+    return {
+        draftId: randomUUID(),
+        action: draftActionFromSuggested(draft.suggestedAction),
+        status: "draft",
+        source,
+        proposedMutation: proposedMutationFromDraft(draft),
+        explanation: draft.suggestedAction === "manualReview"
+            ? "Manual review required before applying this change."
+            : `Suggested ${draft.suggestedAction} based on inventory reconcile.`,
+        warnings: draft.warnings.map((message, index) => ({
+            code: `DRAFT_WARNING_${index + 1}`,
+            message,
+        })),
+        requiredUserInputs: requiredUserInputsFromDraft(draft),
+        dryRunAvailable: draft.suggestedAction !== "manualReview",
+    };
+}
+export function buildDescriptorActionDraftFromOrphanCollection(input) {
+    const draft = buildDescriptorDraftFromOrphanCollection(input);
+    return toDescriptorActionDraft(draft, {
+        targetCollection: input.collectionName,
+        target: input.target,
+    });
+}
+export function buildAddContentTypeActionDraft(input, snapshot) {
+    const draft = buildAddContentTypeDraftFromCollection(input, snapshot);
+    return toDescriptorActionDraft(draft, {
+        targetCollection: input.collectionName,
+        target: input.target,
+    });
+}
+export function buildFixCollectionBindingActionDraft(input, snapshot, env) {
+    const draft = buildFixCollectionBindingDraft(input, snapshot, env);
+    return toDescriptorActionDraft(draft, {
+        targetCollection: input.collectionName,
+    });
+}
+export function buildIgnoreCollectionActionDraft(input) {
+    const draft = buildIgnoreCollectionDraft(input);
+    return toDescriptorActionDraft(draft, {
+        targetCollection: input.collectionName,
+        target: input.target,
+    });
+}
+export function buildDescriptorActionDraftForSuggestion(suggestion, snapshot, env = process.env) {
+    let draft = null;
+    switch (suggestion.kind) {
+        case "create-descriptor-for-orphan":
+            draft = buildDescriptorDraftFromOrphanCollection({
+                target: suggestion.target,
+                collectionName: suggestion.collection,
+            });
+            break;
+        case "add-content-type-for-orphan":
+            draft = buildAddContentTypeDraftFromCollection({
+                entityName: suggestion.parsedObject ?? "",
+                collectionName: suggestion.collection,
+                target: suggestion.target,
+            }, snapshot);
+            break;
+        case "fix-collection-binding":
+            draft = buildFixCollectionBindingDraft({
+                entityName: suggestion.entityName,
+                contentTypeKey: suggestion.contentType,
+                collectionName: suggestion.actualCollection,
+            }, snapshot, env);
+            break;
+        case "ignore-collection":
+            draft = buildIgnoreCollectionDraft({
+                target: suggestion.target,
+                collectionName: suggestion.collectionName,
+                reason: "not-memorix",
+            });
+            break;
+        default:
+            return null;
+    }
+    return toDescriptorActionDraft(draft);
+}
+export async function applyDescriptorActionDraft(ctx, draft, options = {}) {
+    const { applyReconcileDraft } = await import("../reconcile/apply.js");
+    const { assertSourceEditable, createSourceNotEditableError } = await import("./guards.js");
+    const { mutationFailure } = await import("../mutations/common.js");
+    try {
+        assertSourceEditable(draft.source);
+        if (draft.targetSource) {
+            assertSourceEditable(draft.targetSource);
+        }
+    }
+    catch (err) {
+        const sourceError = createSourceNotEditableError(err && typeof err === "object" && "source" in err
+            ? err.source
+            : draft.source);
+        return mutationFailure([
+            {
+                code: sourceError.code,
+                message: sourceError.message,
+                source: sourceError.source,
+            },
+        ], options);
+    }
+    const legacyDraft = {
+        suggestedAction: draft.action === "register-object-type"
+            ? "registerEntityDescriptor"
+            : draft.action === "add-content-type"
+                ? "addContentType"
+                : draft.action === "fix-collection-binding"
+                    ? "updateContentType"
+                    : draft.action === "ignore-collection"
+                        ? "ignoreCollection"
+                        : "manualReview",
+        draft: draft.proposedMutation.input && typeof draft.proposedMutation.input === "object"
+            ? draft.proposedMutation.input
+            : {},
+        warnings: draft.warnings.map((w) => w.message),
+    };
+    if (draft.requiredUserInputs?.some((input) => input.required)) {
+        const { mutationFailure } = await import("../mutations/common.js");
+        return mutationFailure([
+            {
+                code: "REQUIRED_USER_INPUTS",
+                message: "Draft has unresolved required user inputs.",
+            },
+        ], options);
+    }
+    return applyReconcileDraft(ctx, legacyDraft, options);
+}
+//# sourceMappingURL=action-drafts.js.map

package/dist/source/action-drafts.js.map

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

package/dist/source/aliases.d.ts

@@ -0,0 +1,23 @@
+import type { MemorixCompletionMapping, MemorixEntityDescriptor, MemorixItemDescriptor, MemorixListDescriptor, MemorixSliceDescriptor } from "../types/index.js";
+export declare function withObjectTypeAliases<T extends Record<string, unknown>>(descriptor: T): T & {
+    objectType?: string;
+    objectName?: string;
+};
+export declare function withEntityDescriptorAliases(descriptor: MemorixEntityDescriptor): MemorixEntityDescriptor & {
+    objectType: string;
+    objectName: string;
+};
+export declare function withListDescriptorAliases(descriptor: MemorixListDescriptor): MemorixListDescriptor & {
+    objectType?: string;
+};
+export declare function withItemDescriptorAliases(descriptor: MemorixItemDescriptor): MemorixItemDescriptor & {
+    objectType: string;
+};
+export declare function withSliceDescriptorAliases(descriptor: MemorixSliceDescriptor): MemorixSliceDescriptor & {
+    objectType: string;
+    entity?: string;
+};
+export declare function withCompletionMappingAliases(mapping: MemorixCompletionMapping): MemorixCompletionMapping & {
+    objectType: string;
+};
+//# sourceMappingURL=aliases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../../src/source/aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,UAAU,EAAE,CAAC,GACZ,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAqBlD;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,uBAAuB,GAClC,uBAAuB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAMtE;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,qBAAqB,GAChC,qBAAqB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBjD;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,qBAAqB,GAChC,qBAAqB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAKhD;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,sBAAsB,GACjC,sBAAsB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAMlE;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAKnD"}

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_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_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_OBJECT_TYPE_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"}