@x12i/memorix-descriptors 1.4.2 → 1.5.0

package/dist/source/registry.js

@@ -0,0 +1,121 @@
+import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, } from "../catalog/ids.js";
+export { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, } from "../catalog/ids.js";
+const KNOWN_CATALOGS = {
+    [MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG]: {
+        sourceClass: "canonical-catalox-descriptor",
+        canonicalStatus: "canonical",
+        descriptorKind: "object-type",
+        editable: "editable",
+        managedByDescriptors: true,
+    },
+    [MEMORIX_ENTITY_DESCRIPTORS_CATALOG]: {
+        sourceClass: "legacy-catalox-catalog",
+        canonicalStatus: "legacy",
+        descriptorKind: "object-type",
+        editable: "not-editable",
+        managedByDescriptors: false,
+        replacementCatalogId: MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+        trustWarning: "Legacy entity descriptor catalog. Use memorix-object-type-descriptors.",
+    },
+    [MEMORIX_LIST_DESCRIPTORS_CATALOG]: {
+        sourceClass: "canonical-catalox-descriptor",
+        canonicalStatus: "canonical",
+        descriptorKind: "list",
+        editable: "editable",
+        managedByDescriptors: true,
+    },
+    [MEMORIX_ITEM_DESCRIPTORS_CATALOG]: {
+        sourceClass: "canonical-catalox-descriptor",
+        canonicalStatus: "canonical",
+        descriptorKind: "item",
+        editable: "editable",
+        managedByDescriptors: true,
+    },
+    [MEMORIX_COMPLETION_MAPPINGS_CATALOG]: {
+        sourceClass: "catalox-control-plane",
+        canonicalStatus: "control-plane",
+        descriptorKind: "completion-mapping",
+        editable: "editable",
+        managedByDescriptors: true,
+    },
+    [MEMORIX_INVENTORY_POLICIES_CATALOG]: {
+        sourceClass: "catalox-control-plane",
+        canonicalStatus: "control-plane",
+        descriptorKind: "inventory-policy",
+        editable: "editable",
+        managedByDescriptors: true,
+    },
+    [LEGACY_SCHEMA_INFERENCE_CATALOG]: {
+        sourceClass: "legacy-catalox-catalog",
+        canonicalStatus: "legacy",
+        descriptorKind: "legacy-schema-inference",
+        editable: "not-editable",
+        managedByDescriptors: false,
+        replacementCatalogId: MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG,
+        trustWarning: "Legacy schema inference catalog. Not canonical.",
+    },
+    [LEGACY_GLOBAL_CONTENT_TYPE_CATALOG]: {
+        sourceClass: "legacy-catalox-catalog",
+        canonicalStatus: "legacy",
+        descriptorKind: "legacy-content-type",
+        editable: "not-editable",
+        managedByDescriptors: false,
+        trustWarning: "Legacy global content-type registry. Use contentTypes on object type descriptors.",
+    },
+    [PARALLEL_KNOWLEDGE_CATALOG]: {
+        sourceClass: "parallel-catalox-catalog",
+        canonicalStatus: "parallel",
+        descriptorKind: "knowledge-artifact",
+        editable: "not-editable",
+        managedByDescriptors: false,
+        trustWarning: "Knowledge artifacts are not object type descriptors.",
+    },
+};
+export function getMemorixCatalogSourceRegistry() {
+    const catalogs = {};
+    for (const [catalogId, entry] of Object.entries(KNOWN_CATALOGS)) {
+        catalogs[catalogId] = { catalogId, ...entry };
+    }
+    return {
+        appIdDefault: "memorix",
+        catalogs,
+    };
+}
+export function resolveCatalogRegistryEntry(catalogId) {
+    const known = KNOWN_CATALOGS[catalogId];
+    if (known) {
+        return { catalogId, ...known };
+    }
+    return {
+        catalogId,
+        sourceClass: "unknown-source",
+        canonicalStatus: "unknown",
+        descriptorKind: "object-type",
+        editable: "unknown",
+        managedByDescriptors: false,
+        trustWarning: "Unknown catalog id. Source cannot be classified as canonical descriptor metadata.",
+    };
+}
+export function isEditableSourceClass(sourceClass) {
+    return (sourceClass === "canonical-catalox-descriptor" || sourceClass === "catalox-control-plane");
+}
+export function isKnownCatalogId(catalogId) {
+    return catalogId in KNOWN_CATALOGS;
+}
+export function listKnownCatalogIds() {
+    return Object.keys(KNOWN_CATALOGS);
+}
+export function buildUnknownCatalogSourceRef(catalogId, loadedAt, appId) {
+    const entry = resolveCatalogRegistryEntry(catalogId);
+    return {
+        sourceClass: entry.sourceClass,
+        canonicalStatus: entry.canonicalStatus,
+        appId,
+        catalogId,
+        descriptorKind: entry.descriptorKind,
+        loadedAt,
+        editable: entry.editable,
+        trustWarning: entry.trustWarning,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/source/registry.js.map

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

package/dist/source/snapshot.d.ts

@@ -0,0 +1,15 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { SourceAwareDescriptorSnapshot } from "./types.js";
+export type LoadSourceAwareDescriptorSnapshotOptions = {
+    appId?: string;
+    includeControlPlane?: boolean;
+    includeLegacyCatalogs?: boolean;
+    includeParallelCatalogs?: boolean;
+    includeCatalogHealth?: boolean;
+};
+export declare function loadSourceAwareDescriptorSnapshot(catalox: CataloxBoundClient, options?: LoadSourceAwareDescriptorSnapshotOptions): Promise<SourceAwareDescriptorSnapshot>;
+export declare function listSliceDescriptorsFromSnapshot(snapshot: SourceAwareDescriptorSnapshot, filter?: {
+    objectType?: string;
+    contentType?: string;
+}): Array<SourceAwareDescriptorSnapshot["canonical"]["slices"][number]>;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/source/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAiD/D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,wCAAwC,GAAG;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAaF,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,wCAA6C,GACrD,OAAO,CAAC,6BAA6B,CAAC,CA4NxC;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,6BAA6B,EACvC,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,KAAK,CAAC,6BAA6B,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAarE"}

package/dist/source/snapshot.js

@@ -0,0 +1,160 @@
+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 { loadDescriptorSnapshot } from "../store/snapshot.js";
+import { validateMemorixEntityDescriptor } from "../validation/descriptor-validation.js";
+import { DEFAULT_INVENTORY_POLICY, validateMemorixInventoryPolicy, } from "../validation/inventory-policy-validation.js";
+import { parseDescriptorData } from "../validation/descriptor-validation.js";
+import { isMemorixSliceDescriptor } from "../validation/slice-validation.js";
+import { withCompletionMappingAliases, withEntityDescriptorAliases, withItemDescriptorAliases, withListDescriptorAliases, withSliceDescriptorAliases, } from "./aliases.js";
+import { buildCatalogHealth, probeCatalogItems } from "./catalog-health.js";
+import { buildInventoryPolicySourceRef, buildItemSourceRef, buildListSourceRef, buildMappingSourceRef, buildObjectTypeSourceRef, nowIso, wrapSourceAware, } from "./envelope.js";
+import { LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, resolveCatalogRegistryEntry, buildUnknownCatalogSourceRef, } from "./registry.js";
+const CANONICAL_CATALOGS = [
+    MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+    MEMORIX_LIST_DESCRIPTORS_CATALOG,
+    MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+];
+const CONTROL_PLANE_CATALOGS = [
+    MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+    MEMORIX_INVENTORY_POLICIES_CATALOG,
+];
+export async function loadSourceAwareDescriptorSnapshot(catalox, options = {}) {
+    const loadedAt = nowIso();
+    const appId = options.appId ?? "memorix";
+    const includeControlPlane = options.includeControlPlane ?? true;
+    const includeLegacy = options.includeLegacyCatalogs ?? false;
+    const includeParallel = options.includeParallelCatalogs ?? false;
+    const includeCatalogHealth = options.includeCatalogHealth ?? true;
+    const snapshot = await loadDescriptorSnapshot(catalox);
+    const warnings = [];
+    const errors = [];
+    const catalogs = [];
+    if (includeCatalogHealth) {
+        const healthCatalogIds = [
+            ...CANONICAL_CATALOGS,
+            ...(includeControlPlane ? CONTROL_PLANE_CATALOGS : []),
+            ...(includeLegacy
+                ? [LEGACY_SCHEMA_INFERENCE_CATALOG, LEGACY_GLOBAL_CONTENT_TYPE_CATALOG]
+                : []),
+            ...(includeParallel ? [PARALLEL_KNOWLEDGE_CATALOG] : []),
+        ];
+        const probes = await Promise.all(healthCatalogIds.map(async (catalogId) => ({
+            catalogId,
+            probe: await probeCatalogItems(catalox, catalogId),
+        })));
+        for (const { catalogId, probe } of probes) {
+            catalogs.push(buildCatalogHealth(catalogId, probe));
+            if (probe.error) {
+                const entry = resolveCatalogRegistryEntry(catalogId);
+                const issue = {
+                    code: probe.error.code,
+                    message: probe.error.message,
+                    source: buildUnknownCatalogSourceRef(catalogId, loadedAt, appId),
+                };
+                if (entry.managedByDescriptors) {
+                    warnings.push(issue);
+                }
+                else {
+                    warnings.push(issue);
+                }
+            }
+        }
+    }
+    const objectTypes = [];
+    for (const [itemId, raw] of Object.entries(snapshot.entityDescriptors)) {
+        try {
+            const entity = withEntityDescriptorAliases(validateMemorixEntityDescriptor(raw));
+            objectTypes.push(wrapSourceAware(entity, buildObjectTypeSourceRef(itemId, appId, loadedAt, entity.entityName, entity.target)));
+        }
+        catch (err) {
+            errors.push({
+                code: "INVALID_ENTITY_DESCRIPTOR",
+                message: err instanceof Error ? err.message : String(err),
+                source: buildObjectTypeSourceRef(itemId, appId, loadedAt),
+            });
+        }
+    }
+    const lists = [];
+    const slices = [];
+    for (const [itemId, raw] of Object.entries(snapshot.listDescriptors)) {
+        if (isMemorixSliceDescriptor(raw)) {
+            const slice = withSliceDescriptorAliases(raw);
+            slices.push(wrapSourceAware(slice, buildListSourceRef(itemId, appId, loadedAt, slice.entityName, "slice")));
+            continue;
+        }
+        const list = withListDescriptorAliases(raw);
+        const objectType = "entity" in list && typeof list.entity === "string" ? list.entity : undefined;
+        lists.push(wrapSourceAware(list, buildListSourceRef(itemId, appId, loadedAt, objectType, "list")));
+    }
+    const items = [];
+    for (const [itemId, raw] of Object.entries(snapshot.itemDescriptors)) {
+        const item = withItemDescriptorAliases(raw);
+        items.push(wrapSourceAware(item, buildItemSourceRef(itemId, appId, loadedAt, item.entity)));
+    }
+    const completionMappings = [];
+    const inventoryPolicies = [];
+    if (includeControlPlane) {
+        for (const [itemId, mapping] of Object.entries(snapshot.completionMappings)) {
+            const withAliases = withCompletionMappingAliases(mapping);
+            completionMappings.push(wrapSourceAware(withAliases, buildMappingSourceRef(itemId, appId, loadedAt, mapping.entityType, mapping.target)));
+        }
+        const policy = snapshot.inventoryPolicy ?? DEFAULT_INVENTORY_POLICY;
+        try {
+            inventoryPolicies.push(wrapSourceAware(validateMemorixInventoryPolicy(policy), buildInventoryPolicySourceRef(appId, loadedAt)));
+        }
+        catch (err) {
+            warnings.push({
+                code: "INVALID_INVENTORY_POLICY",
+                message: err instanceof Error ? err.message : String(err),
+                source: buildInventoryPolicySourceRef(appId, loadedAt),
+            });
+            inventoryPolicies.push(wrapSourceAware(DEFAULT_INVENTORY_POLICY, buildInventoryPolicySourceRef(appId, loadedAt)));
+        }
+    }
+    const result = {
+        appId,
+        loadedAt,
+        catalogs,
+        canonical: { objectTypes, lists, items, slices },
+        controlPlane: { completionMappings, inventoryPolicies },
+        warnings,
+        errors,
+    };
+    if (includeLegacy) {
+        result.legacy = {};
+        const schemaProbe = await probeCatalogItems(catalox, LEGACY_SCHEMA_INFERENCE_CATALOG);
+        if (schemaProbe.exists && schemaProbe.readable) {
+            result.legacy.schemaInferenceCatalog = schemaProbe.items.map((item) => wrapSourceAware(parseDescriptorData(item.data), buildUnknownCatalogSourceRef(LEGACY_SCHEMA_INFERENCE_CATALOG, loadedAt, appId)));
+            if (schemaProbe.items.length > 0) {
+                warnings.push({
+                    code: "LEGACY_CATALOG_PRESENT",
+                    message: "Legacy memorix-entities catalog is present and may be confused with canonical descriptors.",
+                    source: buildUnknownCatalogSourceRef(LEGACY_SCHEMA_INFERENCE_CATALOG, loadedAt, appId),
+                });
+            }
+        }
+        const contentTypeProbe = await probeCatalogItems(catalox, LEGACY_GLOBAL_CONTENT_TYPE_CATALOG);
+        if (contentTypeProbe.exists && contentTypeProbe.readable) {
+            result.legacy.globalContentTypeCatalog = contentTypeProbe.items.map((item) => wrapSourceAware(parseDescriptorData(item.data), buildUnknownCatalogSourceRef(LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, loadedAt, appId)));
+        }
+    }
+    if (includeParallel) {
+        result.parallel = {};
+        const knowledgeProbe = await probeCatalogItems(catalox, PARALLEL_KNOWLEDGE_CATALOG);
+        if (knowledgeProbe.exists && knowledgeProbe.readable) {
+            result.parallel.knowledgeArtifacts = knowledgeProbe.items.map((item) => wrapSourceAware(parseDescriptorData(item.data), buildUnknownCatalogSourceRef(PARALLEL_KNOWLEDGE_CATALOG, loadedAt, appId)));
+        }
+    }
+    return result;
+}
+export function listSliceDescriptorsFromSnapshot(snapshot, filter) {
+    let slices = snapshot.canonical.slices;
+    if (filter?.objectType) {
+        slices = slices.filter((entry) => entry.data.entityName === filter.objectType ||
+            entry.data.objectType === filter.objectType);
+    }
+    if (filter?.contentType) {
+        slices = slices.filter((entry) => entry.data.contentType === filter.contentType);
+    }
+    return slices;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/source/snapshot.js.map

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

package/dist/source/types.d.ts

@@ -0,0 +1,222 @@
+import type { MemorixCompletionMapping, MemorixEntityDescriptor, MemorixInventoryPolicy, MemorixItemDescriptor, MemorixListDescriptor, MemorixSliceDescriptor, MemorixTarget } from "../types/index.js";
+export type MemorixSourceClass = "canonical-catalox-descriptor" | "catalox-control-plane" | "legacy-catalox-catalog" | "parallel-catalox-catalog" | "runtime-projection" | "mongo-payload" | "local-ui-state" | "unknown-source";
+export type MemorixCanonicalStatus = "canonical" | "control-plane" | "legacy" | "parallel" | "derived" | "local" | "unknown";
+export type MemorixEditability = "editable" | "read-only" | "not-editable" | "draft-only" | "unknown";
+export type MemorixDescriptorKind = "object-type" | "list" | "item" | "slice" | "completion-mapping" | "inventory-policy" | "legacy-schema-inference" | "legacy-content-type" | "knowledge-artifact";
+export type MemorixSourceRef = {
+    sourceClass: MemorixSourceClass;
+    canonicalStatus: MemorixCanonicalStatus;
+    appId?: string;
+    catalogId?: string;
+    itemId?: string;
+    firestoreCollection?: string;
+    descriptorKind?: MemorixDescriptorKind;
+    objectType?: string;
+    entityName?: string;
+    target?: MemorixTarget;
+    databaseName?: string;
+    collectionName?: string;
+    contentType?: string;
+    loadedAt: string;
+    generatedAt?: string;
+    generatedBy?: string;
+    editable: MemorixEditability;
+    trustWarning?: string;
+};
+export type SourceAware<T> = {
+    data: T;
+    source: MemorixSourceRef;
+};
+export type MemorixCatalogSourceRegistryEntry = {
+    catalogId: string;
+    sourceClass: MemorixSourceClass;
+    canonicalStatus: MemorixCanonicalStatus;
+    descriptorKind: MemorixDescriptorKind;
+    editable: MemorixEditability;
+    managedByDescriptors: boolean;
+    trustWarning?: string;
+    replacementCatalogId?: string;
+};
+export type MemorixCatalogSourceRegistry = {
+    appIdDefault: "memorix";
+    catalogs: Record<string, MemorixCatalogSourceRegistryEntry>;
+};
+export type SourceAwareCatalogHealth = {
+    catalogId: string;
+    sourceClass: MemorixSourceClass;
+    canonicalStatus: MemorixCanonicalStatus;
+    descriptorKind?: MemorixDescriptorKind;
+    exists: boolean;
+    readable: boolean;
+    itemCount?: number;
+    error?: {
+        code: string;
+        message: string;
+    };
+    editable: MemorixEditability;
+};
+export type SourceAwareDescriptorSnapshot = {
+    appId: string;
+    loadedAt: string;
+    catalogs: SourceAwareCatalogHealth[];
+    canonical: {
+        objectTypes: Array<SourceAware<MemorixEntityDescriptor>>;
+        lists: Array<SourceAware<MemorixListDescriptor>>;
+        items: Array<SourceAware<MemorixItemDescriptor>>;
+        slices: Array<SourceAware<MemorixSliceDescriptor>>;
+    };
+    controlPlane: {
+        completionMappings: Array<SourceAware<MemorixCompletionMapping>>;
+        inventoryPolicies: Array<SourceAware<MemorixInventoryPolicy>>;
+    };
+    legacy?: {
+        schemaInferenceCatalog?: Array<SourceAware<unknown>>;
+        globalContentTypeCatalog?: Array<SourceAware<unknown>>;
+    };
+    parallel?: {
+        knowledgeArtifacts?: Array<SourceAware<unknown>>;
+    };
+    warnings: Array<{
+        code: string;
+        message: string;
+        source?: MemorixSourceRef;
+    }>;
+    errors: Array<{
+        code: string;
+        message: string;
+        source?: MemorixSourceRef;
+    }>;
+};
+export type SourceAwareValidationFixability = "auto-fixable" | "draft-available" | "manual-edit" | "not-fixable" | "unknown";
+export type SourceAwareValidationSuggestedAction = "open-descriptor" | "edit-descriptor" | "add-content-type" | "create-list" | "create-item" | "fix-relation" | "ignore-legacy" | "inspect-source" | "ask-user";
+export type SourceAwareValidationIssue = {
+    severity: "info" | "warning" | "error";
+    code: string;
+    message: string;
+    path?: string;
+    source: MemorixSourceRef;
+    fixability: SourceAwareValidationFixability;
+    suggestedAction?: SourceAwareValidationSuggestedAction;
+};
+export type SourceAwareReferenceGraph = {
+    generatedAt: string;
+    graphKind: "reference-graph";
+    sourceClass: "runtime-projection";
+    canonicalStatus: "derived";
+    nodes: Array<{
+        id: string;
+        label: string;
+        kind: string;
+        source: MemorixSourceRef;
+    }>;
+    edges: Array<{
+        id: string;
+        from: string;
+        to: string;
+        kind: string;
+        source: MemorixSourceRef;
+        path?: string;
+    }>;
+};
+export type SourceAwareDescriptorValidationReport = {
+    ok: boolean;
+    graphValid: boolean;
+    loadedAt: string;
+    summary: {
+        canonicalDescriptorCount: number;
+        controlPlaneItemCount: number;
+        legacyItemCount?: number;
+        errors: number;
+        warnings: number;
+    };
+    issues: SourceAwareValidationIssue[];
+    references: SourceAwareReferenceGraph;
+};
+export type SourceAwareDescriptorGraph = {
+    generatedAt: string;
+    graphKind: "descriptor-graph";
+    sourceClass: "runtime-projection";
+    canonicalStatus: "derived";
+    nodes: Array<{
+        id: string;
+        label: string;
+        kind: "object-type-descriptor" | "list-descriptor" | "item-descriptor" | "slice-descriptor" | "relation" | "completion-mapping" | "inventory-policy";
+        source: MemorixSourceRef;
+        objectType?: string;
+        target?: MemorixTarget;
+        catalogId?: string;
+        itemId?: string;
+        validationStatus?: "valid" | "warning" | "error" | "unknown";
+    }>;
+    edges: Array<{
+        id: string;
+        kind: "default-list" | "default-item" | "list-of-object-type" | "item-of-object-type" | "slice-of-object-type" | "relation-target" | "mapping-target" | "policy-target";
+        from: string;
+        to: string;
+        source: MemorixSourceRef;
+        path?: string;
+    }>;
+    issues: SourceAwareValidationIssue[];
+};
+export type MemorixInspectableSources = {
+    groups: Array<{
+        groupId: "canonical-descriptors" | "control-plane" | "legacy-catalogs" | "parallel-catalogs" | "unknown";
+        title: string;
+        description: string;
+        sources: Array<{
+            source: MemorixSourceRef;
+            title: string;
+            subtitle?: string;
+            itemCount?: number;
+            warnings?: string[];
+        }>;
+    }>;
+};
+export type DescriptorActionDraft = {
+    draftId: string;
+    action: "register-object-type" | "add-content-type" | "fix-collection-binding" | "ignore-collection" | "ensure-collection" | "update-list" | "update-item" | "manual-review";
+    status: "draft";
+    source: MemorixSourceRef;
+    targetSource?: MemorixSourceRef;
+    proposedMutation: {
+        method: "registerEntityDescriptor";
+        input: unknown;
+    } | {
+        method: "addContentType";
+        input: unknown;
+    } | {
+        method: "updateContentType";
+        input: unknown;
+    } | {
+        method: "ignoreCollection";
+        input: unknown;
+    };
+    explanation: string;
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    requiredUserInputs?: Array<{
+        key: string;
+        label: string;
+        reason: string;
+        options?: string[];
+        required: boolean;
+    }>;
+    dryRunAvailable: boolean;
+};
+export type SourceAwareReconcileReport = {
+    loadedAt: string;
+    inventory: import("../reconcile/types.js").MemorixUnifiedInventory;
+    suggestions: import("../reconcile/types.js").ReconcileSuggestion[];
+    issues: import("../reconcile/types.js").MemorixInventoryIssue[];
+    applied: import("../reconcile/types.js").ReconcileDescriptorsResult["applied"];
+    drafts: DescriptorActionDraft[];
+    source: MemorixSourceRef;
+};
+export type SourceNotEditableError = {
+    code: "SOURCE_NOT_EDITABLE";
+    message: string;
+    source: MemorixSourceRef;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/source/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/source/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/source/types.ts"],"names":[],"mappings":""}

package/dist/source/validation.d.ts

@@ -0,0 +1,12 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import { sourceRefForCataloxWrite } from "./envelope.js";
+import type { SourceAwareDescriptorValidationReport } from "./types.js";
+export type ValidateSourceAwareMemorixDescriptorsOptions = {
+    appId?: string;
+    includeCatalogHealth?: boolean;
+    includeLegacyWarnings?: boolean;
+    includeFixHints?: boolean;
+};
+export declare function validateSourceAwareMemorixDescriptors(catalox: CataloxBoundClient, options?: ValidateSourceAwareMemorixDescriptorsOptions): Promise<SourceAwareDescriptorValidationReport>;
+export { sourceRefForCataloxWrite };
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/source/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAW/D,OAAO,EAQL,wBAAwB,EACzB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,qCAAqC,EAKtC,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,4CAA4C,GAAG;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AA0KF,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,4CAAiD,GACzD,OAAO,CAAC,qCAAqC,CAAC,CAmGhD;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}