@x12i/memorix-descriptors 1.4.5 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/dist/admin/create-admin.d.ts +10 -0
  2. package/dist/admin/create-admin.d.ts.map +1 -1
  3. package/dist/admin/create-admin.js +28 -2
  4. package/dist/admin/create-admin.js.map +1 -1
  5. package/dist/catalog/ids.d.ts +23 -0
  6. package/dist/catalog/ids.d.ts.map +1 -1
  7. package/dist/catalog/ids.js +42 -0
  8. package/dist/catalog/ids.js.map +1 -1
  9. package/dist/catalox/client.d.ts +3 -1
  10. package/dist/catalox/client.d.ts.map +1 -1
  11. package/dist/catalox/client.js +30 -3
  12. package/dist/catalox/client.js.map +1 -1
  13. package/dist/cli/index.js +7 -0
  14. package/dist/cli/index.js.map +1 -1
  15. package/dist/env/load-env-file.d.ts +7 -0
  16. package/dist/env/load-env-file.d.ts.map +1 -0
  17. package/dist/env/load-env-file.js +74 -0
  18. package/dist/env/load-env-file.js.map +1 -0
  19. package/dist/index.d.ts +10 -2
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +6 -1
  22. package/dist/index.js.map +1 -1
  23. package/dist/migration/apply.d.ts +21 -0
  24. package/dist/migration/apply.d.ts.map +1 -0
  25. package/dist/migration/apply.js +102 -0
  26. package/dist/migration/apply.js.map +1 -0
  27. package/dist/migration/backup.d.ts +8 -0
  28. package/dist/migration/backup.d.ts.map +1 -0
  29. package/dist/migration/backup.js +27 -0
  30. package/dist/migration/backup.js.map +1 -0
  31. package/dist/migration/classify.d.ts +6 -0
  32. package/dist/migration/classify.d.ts.map +1 -0
  33. package/dist/migration/classify.js +67 -0
  34. package/dist/migration/classify.js.map +1 -0
  35. package/dist/migration/ensure-canonical-catalogs.d.ts +4 -0
  36. package/dist/migration/ensure-canonical-catalogs.d.ts.map +1 -0
  37. package/dist/migration/ensure-canonical-catalogs.js +101 -0
  38. package/dist/migration/ensure-canonical-catalogs.js.map +1 -0
  39. package/dist/migration/generate-descriptors.d.ts +22 -0
  40. package/dist/migration/generate-descriptors.d.ts.map +1 -0
  41. package/dist/migration/generate-descriptors.js +234 -0
  42. package/dist/migration/generate-descriptors.js.map +1 -0
  43. package/dist/migration/index.d.ts +13 -0
  44. package/dist/migration/index.d.ts.map +1 -0
  45. package/dist/migration/index.js +12 -0
  46. package/dist/migration/index.js.map +1 -0
  47. package/dist/migration/inspect.d.ts +9 -0
  48. package/dist/migration/inspect.d.ts.map +1 -0
  49. package/dist/migration/inspect.js +57 -0
  50. package/dist/migration/inspect.js.map +1 -0
  51. package/dist/migration/load-snapshot.d.ts +15 -0
  52. package/dist/migration/load-snapshot.d.ts.map +1 -0
  53. package/dist/migration/load-snapshot.js +83 -0
  54. package/dist/migration/load-snapshot.js.map +1 -0
  55. package/dist/migration/mongo-inventory.d.ts +20 -0
  56. package/dist/migration/mongo-inventory.d.ts.map +1 -0
  57. package/dist/migration/mongo-inventory.js +95 -0
  58. package/dist/migration/mongo-inventory.js.map +1 -0
  59. package/dist/migration/object-type-specs.d.ts +17 -0
  60. package/dist/migration/object-type-specs.d.ts.map +1 -0
  61. package/dist/migration/object-type-specs.js +63 -0
  62. package/dist/migration/object-type-specs.js.map +1 -0
  63. package/dist/migration/plan.d.ts +4 -0
  64. package/dist/migration/plan.d.ts.map +1 -0
  65. package/dist/migration/plan.js +136 -0
  66. package/dist/migration/plan.js.map +1 -0
  67. package/dist/migration/reset.d.ts +17 -0
  68. package/dist/migration/reset.d.ts.map +1 -0
  69. package/dist/migration/reset.js +73 -0
  70. package/dist/migration/reset.js.map +1 -0
  71. package/dist/migration/types.d.ts +76 -0
  72. package/dist/migration/types.d.ts.map +1 -0
  73. package/dist/migration/types.js +17 -0
  74. package/dist/migration/types.js.map +1 -0
  75. package/dist/migration/validate-plan.d.ts +15 -0
  76. package/dist/migration/validate-plan.d.ts.map +1 -0
  77. package/dist/migration/validate-plan.js +112 -0
  78. package/dist/migration/validate-plan.js.map +1 -0
  79. package/dist/migration/verify.d.ts +15 -0
  80. package/dist/migration/verify.d.ts.map +1 -0
  81. package/dist/migration/verify.js +27 -0
  82. package/dist/migration/verify.js.map +1 -0
  83. package/dist/mutations/content-type.d.ts.map +1 -1
  84. package/dist/mutations/content-type.js +14 -10
  85. package/dist/mutations/content-type.js.map +1 -1
  86. package/dist/mutations/entity.d.ts +2 -0
  87. package/dist/mutations/entity.d.ts.map +1 -1
  88. package/dist/mutations/entity.js +53 -23
  89. package/dist/mutations/entity.js.map +1 -1
  90. package/dist/mutations/execute.d.ts.map +1 -1
  91. package/dist/mutations/execute.js +6 -3
  92. package/dist/mutations/execute.js.map +1 -1
  93. package/dist/mutations/property.d.ts.map +1 -1
  94. package/dist/mutations/property.js +11 -7
  95. package/dist/mutations/property.js.map +1 -1
  96. package/dist/mutations/relation.d.ts.map +1 -1
  97. package/dist/mutations/relation.js +13 -9
  98. package/dist/mutations/relation.js.map +1 -1
  99. package/dist/mutations/rename-entity.d.ts.map +1 -1
  100. package/dist/mutations/rename-entity.js +11 -8
  101. package/dist/mutations/rename-entity.js.map +1 -1
  102. package/dist/reconcile/index.d.ts +1 -1
  103. package/dist/reconcile/index.d.ts.map +1 -1
  104. package/dist/reconcile/index.js.map +1 -1
  105. package/dist/reconcile/inventory-types.d.ts +28 -12
  106. package/dist/reconcile/inventory-types.d.ts.map +1 -1
  107. package/dist/reconcile/inventory-types.js.map +1 -1
  108. package/dist/reconcile/types.d.ts +1 -1
  109. package/dist/reconcile/types.d.ts.map +1 -1
  110. package/dist/reconcile/unified-inventory.d.ts.map +1 -1
  111. package/dist/reconcile/unified-inventory.js +106 -21
  112. package/dist/reconcile/unified-inventory.js.map +1 -1
  113. package/dist/seeds/build-manifest.d.ts.map +1 -1
  114. package/dist/seeds/build-manifest.js +4 -15
  115. package/dist/seeds/build-manifest.js.map +1 -1
  116. package/dist/seeds/default-seed-spec.d.ts +4 -2
  117. package/dist/seeds/default-seed-spec.d.ts.map +1 -1
  118. package/dist/seeds/default-seed-spec.js +47 -31
  119. package/dist/seeds/default-seed-spec.js.map +1 -1
  120. package/dist/seeds/index.d.ts.map +1 -1
  121. package/dist/seeds/index.js +7 -4
  122. package/dist/seeds/index.js.map +1 -1
  123. package/dist/source/envelope.js +2 -2
  124. package/dist/source/envelope.js.map +1 -1
  125. package/dist/source/registry.d.ts +1 -3
  126. package/dist/source/registry.d.ts.map +1 -1
  127. package/dist/source/registry.js +13 -6
  128. package/dist/source/registry.js.map +1 -1
  129. package/dist/source/snapshot.js +2 -2
  130. package/dist/source/snapshot.js.map +1 -1
  131. package/dist/store/descriptor-lookup.d.ts +9 -0
  132. package/dist/store/descriptor-lookup.d.ts.map +1 -0
  133. package/dist/store/descriptor-lookup.js +21 -0
  134. package/dist/store/descriptor-lookup.js.map +1 -0
  135. package/dist/store/descriptor-normalize.d.ts +14 -0
  136. package/dist/store/descriptor-normalize.d.ts.map +1 -0
  137. package/dist/store/descriptor-normalize.js +141 -0
  138. package/dist/store/descriptor-normalize.js.map +1 -0
  139. package/dist/store/snapshot.d.ts.map +1 -1
  140. package/dist/store/snapshot.js +10 -6
  141. package/dist/store/snapshot.js.map +1 -1
  142. package/dist/tests/canonical-metadata.test.d.ts +2 -0
  143. package/dist/tests/canonical-metadata.test.d.ts.map +1 -0
  144. package/dist/tests/canonical-metadata.test.js +207 -0
  145. package/dist/tests/canonical-metadata.test.js.map +1 -0
  146. package/dist/tests/descriptor-lookup.test.d.ts +2 -0
  147. package/dist/tests/descriptor-lookup.test.d.ts.map +1 -0
  148. package/dist/tests/descriptor-lookup.test.js +44 -0
  149. package/dist/tests/descriptor-lookup.test.js.map +1 -0
  150. package/dist/tests/reconcile-unified.test.js +9 -0
  151. package/dist/tests/reconcile-unified.test.js.map +1 -1
  152. package/dist/tests/seeds.test.js +3 -3
  153. package/dist/tests/seeds.test.js.map +1 -1
  154. package/dist/tests/source-aware.test.js +10 -5
  155. package/dist/tests/source-aware.test.js.map +1 -1
  156. package/dist/tests/unified-inventory.test.js +9 -3
  157. package/dist/tests/unified-inventory.test.js.map +1 -1
  158. package/dist/tests/v2-fixtures.d.ts +4 -0
  159. package/dist/tests/v2-fixtures.d.ts.map +1 -0
  160. package/dist/tests/v2-fixtures.js +81 -0
  161. package/dist/tests/v2-fixtures.js.map +1 -0
  162. package/dist/types/canonical-v2.d.ts +164 -0
  163. package/dist/types/canonical-v2.d.ts.map +1 -0
  164. package/dist/types/canonical-v2.js +6 -0
  165. package/dist/types/canonical-v2.js.map +1 -0
  166. package/dist/validation/canonical-contamination.d.ts +6 -0
  167. package/dist/validation/canonical-contamination.d.ts.map +1 -0
  168. package/dist/validation/canonical-contamination.js +71 -0
  169. package/dist/validation/canonical-contamination.js.map +1 -0
  170. package/dist/validation/canonical-metadata-validation.d.ts +13 -0
  171. package/dist/validation/canonical-metadata-validation.d.ts.map +1 -0
  172. package/dist/validation/canonical-metadata-validation.js +248 -0
  173. package/dist/validation/canonical-metadata-validation.js.map +1 -0
  174. package/dist/validation/canonical-v2-validation.d.ts +8 -0
  175. package/dist/validation/canonical-v2-validation.d.ts.map +1 -0
  176. package/dist/validation/canonical-v2-validation.js +273 -0
  177. package/dist/validation/canonical-v2-validation.js.map +1 -0
  178. package/docs/METADATA-RELEASE-CHECKLIST.md +40 -0
  179. package/package.json +9 -1
@@ -0,0 +1,74 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { dirname, resolve } from "node:path";
3
+ import { fileURLToPath } from "node:url";
4
+ let loadedFrom;
5
+ function parseEnvLine(line) {
6
+ const trimmed = line.trim();
7
+ if (!trimmed || trimmed.startsWith("#"))
8
+ return null;
9
+ const eq = trimmed.indexOf("=");
10
+ if (eq <= 0)
11
+ return null;
12
+ const key = trimmed.slice(0, eq).trim();
13
+ let value = trimmed.slice(eq + 1).trim();
14
+ if ((value.startsWith('"') && value.endsWith('"')) ||
15
+ (value.startsWith("'") && value.endsWith("'"))) {
16
+ value = value.slice(1, -1);
17
+ }
18
+ return { key, value };
19
+ }
20
+ function applyEnvFile(path, processEnv) {
21
+ const content = readFileSync(path, "utf8");
22
+ for (const line of content.split("\n")) {
23
+ const parsed = parseEnvLine(line);
24
+ if (!parsed)
25
+ continue;
26
+ if (processEnv[parsed.key] === undefined || processEnv[parsed.key] === "") {
27
+ processEnv[parsed.key] = parsed.value;
28
+ }
29
+ }
30
+ }
31
+ function candidateEnvPaths() {
32
+ const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
33
+ return [resolve(process.cwd(), ".env"), resolve(packageRoot, ".env")];
34
+ }
35
+ /**
36
+ * Load `.env` from cwd or package root without overriding existing process env.
37
+ */
38
+ export function loadMemorixDescriptorsEnvFile(processEnv = process.env) {
39
+ if (loadedFrom)
40
+ return loadedFrom;
41
+ for (const path of candidateEnvPaths()) {
42
+ if (!existsSync(path))
43
+ continue;
44
+ applyEnvFile(path, processEnv);
45
+ loadedFrom = path;
46
+ break;
47
+ }
48
+ bridgeFirebaseProjectEnv(processEnv);
49
+ return loadedFrom;
50
+ }
51
+ export function bridgeFirebaseProjectEnv(processEnv = process.env) {
52
+ const projectId = processEnv.FIREBASE_PROJECT_ID?.trim();
53
+ if (!projectId)
54
+ return;
55
+ if (!processEnv.GOOGLE_CLOUD_PROJECT?.trim()) {
56
+ processEnv.GOOGLE_CLOUD_PROJECT = projectId;
57
+ }
58
+ if (!processEnv.GCLOUD_PROJECT?.trim()) {
59
+ processEnv.GCLOUD_PROJECT = projectId;
60
+ }
61
+ }
62
+ export function assertCataloxEnvConfigured(processEnv = process.env) {
63
+ loadMemorixDescriptorsEnvFile(processEnv);
64
+ const hasServiceAccount = Boolean(processEnv.GOOGLE_SERVICE_ACCOUNT_BASE64?.trim());
65
+ const hasProject = Boolean(processEnv.FIREBASE_PROJECT_ID?.trim() ||
66
+ processEnv.GOOGLE_CLOUD_PROJECT?.trim() ||
67
+ processEnv.GCLOUD_PROJECT?.trim());
68
+ if (!hasServiceAccount && !hasProject) {
69
+ const envPath = loadedFrom ?? candidateEnvPaths().join(" or ");
70
+ throw new Error(`Catalox Firestore is not configured. Set GOOGLE_SERVICE_ACCOUNT_BASE64 and FIREBASE_PROJECT_ID ` +
71
+ `(optional: FIRESTORE_DATABASE_ID) in your shell or in ${envPath}.`);
72
+ }
73
+ }
74
+ //# sourceMappingURL=load-env-file.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"load-env-file.js","sourceRoot":"","sources":["../../src/env/load-env-file.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,13 +1,20 @@
1
1
  export { createMemorixDescriptorAdmin, createMemorixDescriptorAdminFromEnv, type CreateMemorixDescriptorAdminOptions, type CreateMemorixDescriptorAdminFromEnvOptions, type MemorixDescriptorAdmin, } from "./admin/create-admin.js";
2
2
  export { createMemorixControlPlaneFromEnv, type CreateMemorixControlPlaneFromEnvOptions, type MemorixControlPlane, } from "./admin/control-plane.js";
3
3
  export { executeDescriptorMutation, type ExecuteDescriptorMutationRequest, } from "./admin/execute-mutation.js";
4
- export { MEMORIX_APP_ID, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_DESCRIPTOR_CATALOG_IDS, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_SYSTEM_CATALOG_IDS, allowedIdFieldsForTarget, defaultIdFieldForTarget, resolveMemorixAppId, } from "./catalog/ids.js";
4
+ export { MEMORIX_APP_ID, MEMORIX_CATALOG_IDS, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_DESCRIPTOR_CATALOG_IDS, MEMORIX_DESCRIPTOR_CATALOG_ID_VALUES, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, MEMORIX_SYSTEM_CATALOG_IDS, allowedIdFieldsForTarget, catalogIdForSnapshotSection, defaultIdFieldForTarget, isMemorixDescriptorCatalogId, resolveMemorixAppId, snapshotSectionForCatalogId, } from "./catalog/ids.js";
5
+ export type { MemorixDescriptorCatalogId, MemorixDescriptorSnapshotSection, } from "./catalog/ids.js";
5
6
  export type { CataloxWriteAction, ContentTypeInput, DescriptorIntegrityReport, DescriptorMutationOptions, DescriptorMutationResult, DescriptorMutationWarning, DescriptorSnapshot, IgnoredCollectionEntry, IgnoredCollectionReason, IntegrityIssue, MemorixCompletionMapping, MemorixIdField, MemorixInventoryPolicy, MemorixSeedScope, MemorixSliceDescriptor, MemorixSliceFilter, MemorixSliceFilterRule, MemorixTarget, MongoAction, PropertyInput, ReconcileDescriptorDraft, RegisterEntityDescriptorInput, SliceValidationIssue, SliceValidationReport, SourceAwareCataloxWrite, } from "./types/index.js";
6
7
  export { validateMemorixDescriptors, validateDescriptorSnapshot, } from "./integrity/validate.js";
8
+ export { validateCanonicalMemorixCataloxMetadata, validateCanonicalMemorixCataloxMetadataFromCatalox, FORBIDDEN_LEGACY_CATALOG_IDS, FORBIDDEN_LEGACY_ITEM_IDS, } from "./validation/canonical-metadata-validation.js";
9
+ export { validateMemorixObjectTypeDescriptorV2, validateMemorixListDescriptorV2, validateMemorixItemDescriptorV2, validateMemorixCompletionMappingV2, validateMemorixInventoryPolicyV1, } from "./validation/canonical-v2-validation.js";
10
+ export { buildMemorixCataloxMetadataFixPlan, inspectMemorixCataloxMetadata, validateMemorixCataloxMetadataFixPlan, applyMemorixCataloxMetadataFixPlan, cleanupLegacyMemorixCataloxMetadata, verifyMemorixCataloxMetadata, resetMemorixCataloxMetadata, buildCanonicalDescriptorSet, CANONICAL_OBJECT_TYPE_SPECS, } from "./migration/index.js";
11
+ export type { CanonicalMemorixCatalogSnapshot, CanonicalMetadataValidationReport, MemorixObjectTypeDescriptorV2, MemorixListDescriptorV2, MemorixItemDescriptorV2, MemorixCompletionMappingV2, MemorixInventoryPolicyV1, } from "./types/canonical-v2.js";
12
+ export type { MemorixCataloxMetadataFixPlan, MemorixMetadataInspectionReport, MemorixMetadataMigrationConfig, } from "./migration/types.js";
7
13
  export { buildDescriptorGraph, descriptorGraphToMermaid, type DescriptorGraph, type DescriptorGraphEdge, type DescriptorGraphNode, } from "./integrity/graph.js";
8
14
  export { assertListFieldsHumanReadable, defaultItemDescriptorId, defaultListDescriptorId, isKebabCase, parseDescriptorData, singularizeEntityName, validateMemorixEntityDescriptor, validateMemorixEntityListDescriptor, validateMemorixItemDescriptor, validateMemorixListDescriptor, validatePropertyDescriptor, DescriptorValidationError, } from "./validation/descriptor-validation.js";
9
15
  export { applyDescriptorSeedManifest, buildDescriptorSeedManifest, exportDescriptorSeedInputs, exportDescriptorSeedInputsFromCatalox, importDescriptorSeedInputs, type DescriptorSeedManifest, } from "./seeds/index.js";
10
- export { reconcileDescriptorsWithMongo, applyReconcileDraft, buildReconcileDraftForSuggestion, buildReconcileSuggestionsFromUnifiedInventory, buildMemorixUnifiedInventory, type ReconcileDescriptorsResult, type ReconcileSuggestion, type MemorixUnifiedInventory, type MemorixInventoryIssue, type BuildMemorixUnifiedInventoryOptions, type UnifiedInventoryContext, type MemorixInventoryRow, type MemorixInventoryMappingStatus, type MemorixInventorySourceLens, type MemorixTargetInventory, } from "./reconcile/index.js";
16
+ export { reconcileDescriptorsWithMongo, applyReconcileDraft, buildReconcileDraftForSuggestion, buildReconcileSuggestionsFromUnifiedInventory, buildMemorixUnifiedInventory, type ReconcileDescriptorsResult, type ReconcileSuggestion, type MemorixUnifiedInventory, type MemorixInventoryIssue, type BuildMemorixUnifiedInventoryOptions, type UnifiedInventoryContext, type MemorixInventoryRow, type MemorixInventoryMappingStatus, type MemorixInventorySourceLens, type MemorixInventoryDisplayStatus, type MemorixTargetConnectionStatus, type MemorixTargetInventory, type MemorixUnifiedInventoryMetadata, type MemorixUnifiedInventorySummary, } from "./reconcile/index.js";
17
+ export { registerEntityDescriptor, registerObjectTypeDescriptor, } from "./mutations/entity.js";
11
18
  export { buildAddContentTypeDraftFromCollection, buildDescriptorDraftFromOrphanCollection, buildFixCollectionBindingDraft, buildIgnoreCollectionDraft, type AddContentTypeDraftInput, type FixCollectionBindingDraftInput, type IgnoreCollectionDraftInput, type OrphanCollectionDraftInput, } from "./reconcile/drafts.js";
12
19
  export { parseMemorixCollectionName, type MemorixCollectionNameParseResult, } from "./collections/parse.js";
13
20
  export { resolveMemorixCollectionName, resolveMemorixCollectionNameFromDescriptor, resolveEntityTarget, type MemorixContentTypeDescriptor, type MemorixEntityCollectionSource, } from "./collections/collection-name.js";
@@ -16,6 +23,7 @@ export type { XronoxLike, XronoxReadParams, XronoxListCollectionsParams, XronoxL
16
23
  export { validateMemorixSliceDescriptorShape, validateSliceDescriptorAgainstSnapshot, buildSlicePreview, isMemorixSliceDescriptor, } from "./validation/slice-validation.js";
17
24
  export { DEFAULT_INVENTORY_POLICY, validateMemorixInventoryPolicy, validateIgnoredCollectionEntry, ignoredCollectionKey, isCollectionIgnored, } from "./validation/inventory-policy-validation.js";
18
25
  export { loadDescriptorSnapshot } from "./store/snapshot.js";
26
+ export { getDescriptorFromSnapshot, getEntityDescriptorFromSnapshot, getItemDescriptorFromSnapshot, getListDescriptorFromSnapshot, listDescriptorIdsFromSnapshot, } from "./store/descriptor-lookup.js";
19
27
  export { getMemorixCatalogSourceRegistry, resolveCatalogRegistryEntry, isEditableSourceClass, isKnownCatalogId, LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, loadSourceAwareDescriptorSnapshot, validateSourceAwareMemorixDescriptors, getSourceAwareDescriptorGraph, listInspectableMemorixSources, listSliceDescriptors, reconcileDescriptorsWithMongoSourceAware, buildDescriptorActionDraftFromOrphanCollection, buildAddContentTypeActionDraft, buildFixCollectionBindingActionDraft, buildIgnoreCollectionActionDraft, buildDescriptorActionDraftForSuggestion, applyDescriptorActionDraft, toDescriptorActionDraft, classifyUnprovenJson, rejectMutationForUnprovenSource, assertSourceEditable, isSourceEditable, createSourceNotEditableError, withObjectTypeAliases, withEntityDescriptorAliases, withListDescriptorAliases, withItemDescriptorAliases, withSliceDescriptorAliases, withCompletionMappingAliases, wrapSourceAware, buildCatalogItemSourceRef, buildObjectTypeSourceRef, buildDerivedGraphSourceRef, buildLocalUiStateSourceRef, buildUnknownSourceRef, } from "./source/index.js";
20
28
  export type { MemorixSourceClass, MemorixCanonicalStatus, MemorixEditability, MemorixSourceRef, MemorixDescriptorKind, SourceAware, MemorixCatalogSourceRegistry, MemorixCatalogSourceRegistryEntry, SourceAwareCatalogHealth, SourceAwareDescriptorSnapshot, SourceAwareDescriptorValidationReport, SourceAwareValidationIssue, SourceAwareReferenceGraph, SourceAwareDescriptorGraph, MemorixInspectableSources, DescriptorActionDraft, SourceAwareReconcileReport, SourceNotEditableError, } from "./source/index.js";
21
29
  export { ensureMemorixDescriptorCatalogs } from "./catalog/ensure-catalogs.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -1,12 +1,16 @@
1
1
  export { createMemorixDescriptorAdmin, createMemorixDescriptorAdminFromEnv, } from "./admin/create-admin.js";
2
2
  export { createMemorixControlPlaneFromEnv, } from "./admin/control-plane.js";
3
3
  export { executeDescriptorMutation, } from "./admin/execute-mutation.js";
4
- export { MEMORIX_APP_ID, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_DESCRIPTOR_CATALOG_IDS, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_SYSTEM_CATALOG_IDS, allowedIdFieldsForTarget, defaultIdFieldForTarget, resolveMemorixAppId, } from "./catalog/ids.js";
4
+ export { MEMORIX_APP_ID, MEMORIX_CATALOG_IDS, MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_DESCRIPTOR_CATALOG_IDS, MEMORIX_DESCRIPTOR_CATALOG_ID_VALUES, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_INVENTORY_POLICY_ITEM_ID, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, MEMORIX_SYSTEM_CATALOG_IDS, allowedIdFieldsForTarget, catalogIdForSnapshotSection, defaultIdFieldForTarget, isMemorixDescriptorCatalogId, resolveMemorixAppId, snapshotSectionForCatalogId, } from "./catalog/ids.js";
5
5
  export { validateMemorixDescriptors, validateDescriptorSnapshot, } from "./integrity/validate.js";
6
+ export { validateCanonicalMemorixCataloxMetadata, validateCanonicalMemorixCataloxMetadataFromCatalox, FORBIDDEN_LEGACY_CATALOG_IDS, FORBIDDEN_LEGACY_ITEM_IDS, } from "./validation/canonical-metadata-validation.js";
7
+ export { validateMemorixObjectTypeDescriptorV2, validateMemorixListDescriptorV2, validateMemorixItemDescriptorV2, validateMemorixCompletionMappingV2, validateMemorixInventoryPolicyV1, } from "./validation/canonical-v2-validation.js";
8
+ export { buildMemorixCataloxMetadataFixPlan, inspectMemorixCataloxMetadata, validateMemorixCataloxMetadataFixPlan, applyMemorixCataloxMetadataFixPlan, cleanupLegacyMemorixCataloxMetadata, verifyMemorixCataloxMetadata, resetMemorixCataloxMetadata, buildCanonicalDescriptorSet, CANONICAL_OBJECT_TYPE_SPECS, } from "./migration/index.js";
6
9
  export { buildDescriptorGraph, descriptorGraphToMermaid, } from "./integrity/graph.js";
7
10
  export { assertListFieldsHumanReadable, defaultItemDescriptorId, defaultListDescriptorId, isKebabCase, parseDescriptorData, singularizeEntityName, validateMemorixEntityDescriptor, validateMemorixEntityListDescriptor, validateMemorixItemDescriptor, validateMemorixListDescriptor, validatePropertyDescriptor, DescriptorValidationError, } from "./validation/descriptor-validation.js";
8
11
  export { applyDescriptorSeedManifest, buildDescriptorSeedManifest, exportDescriptorSeedInputs, exportDescriptorSeedInputsFromCatalox, importDescriptorSeedInputs, } from "./seeds/index.js";
9
12
  export { reconcileDescriptorsWithMongo, applyReconcileDraft, buildReconcileDraftForSuggestion, buildReconcileSuggestionsFromUnifiedInventory, buildMemorixUnifiedInventory, } from "./reconcile/index.js";
13
+ export { registerEntityDescriptor, registerObjectTypeDescriptor, } from "./mutations/entity.js";
10
14
  export { buildAddContentTypeDraftFromCollection, buildDescriptorDraftFromOrphanCollection, buildFixCollectionBindingDraft, buildIgnoreCollectionDraft, } from "./reconcile/drafts.js";
11
15
  export { parseMemorixCollectionName, } from "./collections/parse.js";
12
16
  export { resolveMemorixCollectionName, resolveMemorixCollectionNameFromDescriptor, resolveEntityTarget, } from "./collections/collection-name.js";
@@ -14,6 +18,7 @@ export { resolveMemorixDbName, targetCollectionEnvKey, } from "./collections/mon
14
18
  export { validateMemorixSliceDescriptorShape, validateSliceDescriptorAgainstSnapshot, buildSlicePreview, isMemorixSliceDescriptor, } from "./validation/slice-validation.js";
15
19
  export { DEFAULT_INVENTORY_POLICY, validateMemorixInventoryPolicy, validateIgnoredCollectionEntry, ignoredCollectionKey, isCollectionIgnored, } from "./validation/inventory-policy-validation.js";
16
20
  export { loadDescriptorSnapshot } from "./store/snapshot.js";
21
+ export { getDescriptorFromSnapshot, getEntityDescriptorFromSnapshot, getItemDescriptorFromSnapshot, getListDescriptorFromSnapshot, listDescriptorIdsFromSnapshot, } from "./store/descriptor-lookup.js";
17
22
  export { getMemorixCatalogSourceRegistry, resolveCatalogRegistryEntry, isEditableSourceClass, isKnownCatalogId, LEGACY_GLOBAL_CONTENT_TYPE_CATALOG, LEGACY_SCHEMA_INFERENCE_CATALOG, PARALLEL_KNOWLEDGE_CATALOG, loadSourceAwareDescriptorSnapshot, validateSourceAwareMemorixDescriptors, getSourceAwareDescriptorGraph, listInspectableMemorixSources, listSliceDescriptors, reconcileDescriptorsWithMongoSourceAware, buildDescriptorActionDraftFromOrphanCollection, buildAddContentTypeActionDraft, buildFixCollectionBindingActionDraft, buildIgnoreCollectionActionDraft, buildDescriptorActionDraftForSuggestion, applyDescriptorActionDraft, toDescriptorActionDraft, classifyUnprovenJson, rejectMutationForUnprovenSource, assertSourceEditable, isSourceEditable, createSourceNotEditableError, withObjectTypeAliases, withEntityDescriptorAliases, withListDescriptorAliases, withItemDescriptorAliases, withSliceDescriptorAliases, withCompletionMappingAliases, wrapSourceAware, buildCatalogItemSourceRef, buildObjectTypeSourceRef, buildDerivedGraphSourceRef, buildLocalUiStateSourceRef, buildUnknownSourceRef, } from "./source/index.js";
18
23
  export { ensureMemorixDescriptorCatalogs } from "./catalog/ensure-catalogs.js";
19
24
  export { renameEntityDescriptor } from "./mutations/rename-entity.js";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import { type CataloxBoundClient } from "../catalox/client.js";
2
+ import type { MemorixCataloxMetadataFixPlan } from "./types.js";
3
+ export type ApplyPlanOptions = {
4
+ confirmBreakingReset?: boolean;
5
+ backupDir?: string;
6
+ };
7
+ export type ApplyPlanResult = {
8
+ ok: boolean;
9
+ backupDir?: string;
10
+ errors: string[];
11
+ upserted: number;
12
+ };
13
+ export declare function applyMemorixCataloxMetadataFixPlan(catalox: CataloxBoundClient, plan: MemorixCataloxMetadataFixPlan, options?: ApplyPlanOptions): Promise<ApplyPlanResult>;
14
+ export declare function cleanupLegacyMemorixCataloxMetadata(catalox: CataloxBoundClient, plan: MemorixCataloxMetadataFixPlan, options?: {
15
+ confirmDeleteLegacy?: boolean;
16
+ }): Promise<{
17
+ ok: boolean;
18
+ deleted: number;
19
+ errors: string[];
20
+ }>;
21
+ //# sourceMappingURL=apply.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/migration/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAgBhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAgE1B;AAED,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgC7D"}
@@ -0,0 +1,102 @@
1
+ import { deleteCatalogItem, upsertCatalogItem, } from "../catalox/client.js";
2
+ import { MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, } from "../catalog/ids.js";
3
+ import { validateCanonicalMemorixCataloxMetadata } from "../validation/canonical-metadata-validation.js";
4
+ import { exportMemorixMetadataBackup } from "./backup.js";
5
+ import { ensureCanonicalMigrationCatalogs } from "./ensure-canonical-catalogs.js";
6
+ import { loadCanonicalMemorixCatalogSnapshot } from "./load-snapshot.js";
7
+ import { snapshotFromPlanUpserts } from "./types.js";
8
+ import { validateMemorixCataloxMetadataFixPlan } from "./validate-plan.js";
9
+ const FORBIDDEN_UPSERT_KEYS = ["entity", "entityName", "entityType", "targetEntity"];
10
+ function stripForbiddenLegacyUpsertFields(data) {
11
+ const cleaned = { ...data };
12
+ for (const key of FORBIDDEN_UPSERT_KEYS) {
13
+ delete cleaned[key];
14
+ }
15
+ return cleaned;
16
+ }
17
+ export async function applyMemorixCataloxMetadataFixPlan(catalox, plan, options = {}) {
18
+ if (!options.confirmBreakingReset) {
19
+ return {
20
+ ok: false,
21
+ errors: ["Missing required flag --confirm-breaking-reset"],
22
+ upserted: 0,
23
+ };
24
+ }
25
+ const validation = await validateMemorixCataloxMetadataFixPlan(plan);
26
+ if (!validation.ok) {
27
+ return {
28
+ ok: false,
29
+ errors: validation.errors.map((error) => `${error.code}: ${error.message}`),
30
+ upserted: 0,
31
+ };
32
+ }
33
+ if (plan.blockedQuestions.some((question) => question.required)) {
34
+ return {
35
+ ok: false,
36
+ errors: ["Plan has unresolved blockedQuestions"],
37
+ upserted: 0,
38
+ };
39
+ }
40
+ const backupDir = await exportMemorixMetadataBackup(catalox, {
41
+ backupDir: options.backupDir,
42
+ appId: plan.appId,
43
+ plan,
44
+ });
45
+ await ensureCanonicalMigrationCatalogs(catalox, plan);
46
+ let upserted = 0;
47
+ for (const item of plan.upsertItems) {
48
+ const data = stripForbiddenLegacyUpsertFields({ ...item.data, id: item.itemId });
49
+ await deleteCatalogItem(catalox, item.catalogId, item.itemId);
50
+ await upsertCatalogItem(catalox, item.catalogId, data);
51
+ upserted += 1;
52
+ }
53
+ const projected = snapshotFromPlanUpserts(plan.appId, plan);
54
+ for (const catalogId of MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS) {
55
+ if (!(catalogId in projected.catalogs)) {
56
+ projected.catalogs[catalogId] = [];
57
+ }
58
+ }
59
+ const postWriteValidation = validateCanonicalMemorixCataloxMetadata(projected);
60
+ if (!postWriteValidation.ok) {
61
+ return {
62
+ ok: false,
63
+ backupDir,
64
+ errors: postWriteValidation.errors.map((error) => `${error.code}: ${error.message}`),
65
+ upserted,
66
+ };
67
+ }
68
+ return {
69
+ ok: true,
70
+ backupDir,
71
+ errors: [],
72
+ upserted,
73
+ };
74
+ }
75
+ export async function cleanupLegacyMemorixCataloxMetadata(catalox, plan, options = {}) {
76
+ if (!options.confirmDeleteLegacy) {
77
+ return {
78
+ ok: false,
79
+ deleted: 0,
80
+ errors: ["Missing required flag --confirm-delete-legacy"],
81
+ };
82
+ }
83
+ let deleted = 0;
84
+ for (const item of plan.deleteItems) {
85
+ await deleteCatalogItem(catalox, item.catalogId, item.itemId);
86
+ deleted += 1;
87
+ }
88
+ const validation = validateCanonicalMemorixCataloxMetadata(await loadCanonicalMemorixCatalogSnapshot(catalox, {
89
+ appId: plan.appId,
90
+ includeLegacy: false,
91
+ includeParallel: true,
92
+ }), { allowLegacyCatalogs: true });
93
+ if (!validation.ok) {
94
+ return {
95
+ ok: false,
96
+ deleted,
97
+ errors: validation.errors.map((error) => `${error.code}: ${error.message}`),
98
+ };
99
+ }
100
+ return { ok: true, deleted, errors: [] };
101
+ }
102
+ //# sourceMappingURL=apply.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/migration/apply.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { CataloxBoundClient } from "../catalox/client.js";
2
+ import type { MemorixCataloxMetadataFixPlan } from "./types.js";
3
+ export declare function exportMemorixMetadataBackup(catalox: CataloxBoundClient, options?: {
4
+ backupDir?: string;
5
+ appId?: string;
6
+ plan?: MemorixCataloxMetadataFixPlan;
7
+ }): Promise<string>;
8
+ //# sourceMappingURL=backup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/migration/backup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEhE,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,6BAA6B,CAAC;CACjC,GACL,OAAO,CAAC,MAAM,CAAC,CA4BjB"}
@@ -0,0 +1,27 @@
1
+ import { mkdir, writeFile } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ import { inspectMemorixCataloxMetadata } from "./inspect.js";
4
+ import { loadAllMemorixCatalogItems } from "./load-snapshot.js";
5
+ export async function exportMemorixMetadataBackup(catalox, options = {}) {
6
+ const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
7
+ const backupRoot = options.backupDir ?? join(process.cwd(), "backups");
8
+ const dir = join(backupRoot, `memorix-catalox-before-reset-${timestamp}`);
9
+ await mkdir(dir, { recursive: true });
10
+ const snapshot = await loadAllMemorixCatalogItems(catalox, { appId: options.appId });
11
+ const inspection = await inspectMemorixCataloxMetadata(catalox, { appId: options.appId });
12
+ await writeFile(join(dir, "catalog-registry.json"), JSON.stringify(Object.keys(snapshot.catalogs), null, 2));
13
+ await writeFile(join(dir, "environment-summary.json"), JSON.stringify(inspection.environmentSummary, null, 2));
14
+ await writeFile(join(dir, "memorix-metadata-inspection.json"), JSON.stringify(inspection, null, 2));
15
+ if (options.plan) {
16
+ await writeFile(join(dir, "memorix-catalox-metadata-fix.plan.json"), JSON.stringify(options.plan, null, 2));
17
+ }
18
+ for (const [catalogId, items] of Object.entries(snapshot.catalogs)) {
19
+ const catalogDir = join(dir, "catalogs", catalogId);
20
+ await mkdir(catalogDir, { recursive: true });
21
+ for (const item of items) {
22
+ await writeFile(join(catalogDir, `${item.id}.json`), JSON.stringify(item.data, null, 2));
23
+ }
24
+ }
25
+ return dir;
26
+ }
27
+ //# sourceMappingURL=backup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/migration/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAA2B,EAC3B,UAII,EAAE;IAEN,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,gCAAgC,SAAS,EAAE,CAAC,CAAC;IAC1E,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,MAAM,6BAA6B,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAE1F,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7G,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/G,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,kCAAkC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,wCAAwC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9G,CAAC;IAED,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,CACb,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC,EACnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { MemorixMetadataCatalogClassification } from "./types.js";
2
+ export declare function classifyMemorixCatalog(catalogId: string): MemorixMetadataCatalogClassification;
3
+ export declare function detectLegacyFields(data: Record<string, unknown>): string[];
4
+ export declare function detectNamingConflicts(itemIds: string[]): string[];
5
+ export declare function countContamination(data: Record<string, unknown>): number;
6
+ //# sourceMappingURL=classify.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/migration/classify.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,YAAY,CAAC;AAiBvE,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAChB,oCAAoC,CAYtC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAI1E;AAmBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}
@@ -0,0 +1,67 @@
1
+ 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, MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS, PARALLEL_KNOWLEDGE_CATALOG, } from "../catalog/ids.js";
2
+ import { findContaminationInDescriptorData } from "../validation/canonical-contamination.js";
3
+ const LEGACY_CATALOGS = new Set([
4
+ MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
5
+ LEGACY_SCHEMA_INFERENCE_CATALOG,
6
+ LEGACY_GLOBAL_CONTENT_TYPE_CATALOG,
7
+ ]);
8
+ const CURRENT_CATALOGS = new Set([
9
+ MEMORIX_LIST_DESCRIPTORS_CATALOG,
10
+ MEMORIX_ITEM_DESCRIPTORS_CATALOG,
11
+ MEMORIX_COMPLETION_MAPPINGS_CATALOG,
12
+ MEMORIX_INVENTORY_POLICIES_CATALOG,
13
+ ]);
14
+ const LEGACY_FIELD_KEYS = ["entityName", "entityType", "targetEntity", "entity"];
15
+ export function classifyMemorixCatalog(catalogId) {
16
+ if (catalogId === MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG)
17
+ return "canonical";
18
+ if (LEGACY_CATALOGS.has(catalogId))
19
+ return "legacy";
20
+ if (CURRENT_CATALOGS.has(catalogId))
21
+ return "current";
22
+ if (catalogId === PARALLEL_KNOWLEDGE_CATALOG)
23
+ return "parallel";
24
+ if (MEMORIX_REQUIRED_CANONICAL_CATALOG_IDS.includes(catalogId)) {
25
+ return "canonical";
26
+ }
27
+ if (catalogId.startsWith("memorix-") || catalogId.startsWith("memorix_")) {
28
+ return "unknown";
29
+ }
30
+ return "unknown";
31
+ }
32
+ export function detectLegacyFields(data) {
33
+ const hits = [];
34
+ scanLegacyFields(data, "", hits);
35
+ return hits;
36
+ }
37
+ function scanLegacyFields(value, path, hits) {
38
+ if (!value || typeof value !== "object")
39
+ return;
40
+ if (Array.isArray(value)) {
41
+ value.forEach((entry, index) => {
42
+ scanLegacyFields(entry, path ? `${path}[${index}]` : `[${index}]`, hits);
43
+ });
44
+ return;
45
+ }
46
+ for (const [key, child] of Object.entries(value)) {
47
+ const childPath = path ? `${path}.${key}` : key;
48
+ if (LEGACY_FIELD_KEYS.includes(key)) {
49
+ hits.push(childPath);
50
+ }
51
+ scanLegacyFields(child, childPath, hits);
52
+ }
53
+ }
54
+ export function detectNamingConflicts(itemIds) {
55
+ const conflicts = [];
56
+ if (itemIds.includes("variabilities-groups")) {
57
+ conflicts.push("variabilities-groups");
58
+ }
59
+ if (itemIds.includes("critical-vulnerabilities-list")) {
60
+ conflicts.push("critical-vulnerabilities-list");
61
+ }
62
+ return conflicts;
63
+ }
64
+ export function countContamination(data) {
65
+ return findContaminationInDescriptorData(data).length;
66
+ }
67
+ //# sourceMappingURL=classify.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/migration/classify.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { CataloxBoundClient } from "../catalox/client.js";
2
+ import type { MemorixCataloxMetadataFixPlan } from "./types.js";
3
+ export declare function ensureCanonicalMigrationCatalogs(catalox: CataloxBoundClient, plan: MemorixCataloxMetadataFixPlan): Promise<void>;
4
+ //# sourceMappingURL=ensure-canonical-catalogs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ensure-canonical-catalogs.d.ts","sourceRoot":"","sources":["../../src/migration/ensure-canonical-catalogs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAyEhE,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,IAAI,CAAC,CAuCf"}
@@ -0,0 +1,101 @@
1
+ import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_INVENTORY_POLICIES_CATALOG, MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
2
+ const CATALOG_DESCRIPTOR_SEEDS = {
3
+ [MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG]: {
4
+ itemIdField: "id",
5
+ titleField: "objectType",
6
+ queryableFields: [
7
+ { key: "id", label: "Id" },
8
+ { key: "objectType", label: "Object type" },
9
+ { key: "target", label: "Target" },
10
+ ],
11
+ },
12
+ [MEMORIX_COMPLETION_MAPPINGS_CATALOG]: {
13
+ itemIdField: "id",
14
+ titleField: "name",
15
+ queryableFields: [
16
+ { key: "id", label: "Id" },
17
+ { key: "name", label: "Name" },
18
+ { key: "objectType", label: "Object type" },
19
+ ],
20
+ },
21
+ [MEMORIX_INVENTORY_POLICIES_CATALOG]: {
22
+ itemIdField: "id",
23
+ titleField: "id",
24
+ queryableFields: [{ key: "id", label: "Id" }],
25
+ },
26
+ };
27
+ function buildCatalogDescriptor(catalogId, label, seed) {
28
+ return {
29
+ descriptorVersion: "1",
30
+ mode: "replace",
31
+ descriptor: {
32
+ catalogId,
33
+ label,
34
+ sourceMode: "native",
35
+ status: "active",
36
+ capabilities: {
37
+ canList: true,
38
+ canGet: true,
39
+ canCreate: true,
40
+ canEdit: true,
41
+ canDelete: true,
42
+ canImport: true,
43
+ canExport: true,
44
+ canSync: false,
45
+ canValidate: true,
46
+ canViewReferences: true,
47
+ },
48
+ queryableFields: seed.queryableFields.map((field) => ({
49
+ key: field.key,
50
+ label: field.label,
51
+ type: "string",
52
+ indexed: true,
53
+ filterable: true,
54
+ listVisible: true,
55
+ detailVisible: true,
56
+ })),
57
+ identity: {
58
+ itemIdStrategy: "natural",
59
+ itemIdField: seed.itemIdField,
60
+ titleField: seed.titleField,
61
+ },
62
+ },
63
+ };
64
+ }
65
+ export async function ensureCanonicalMigrationCatalogs(catalox, plan) {
66
+ for (const catalog of plan.createCatalogs) {
67
+ const catalogId = catalog.catalogId;
68
+ const existing = await catalox.getCatalog(catalogId);
69
+ if (!existing) {
70
+ if (catalogId === MEMORIX_OBJECT_TYPE_DESCRIPTORS_CATALOG) {
71
+ await catalox.createCatalog({
72
+ catalogId,
73
+ name: catalog.name,
74
+ catalogType: "memorix",
75
+ sourceMode: "native",
76
+ native: { type: "native" },
77
+ });
78
+ }
79
+ else {
80
+ await catalox.ensureCatalog({
81
+ catalogId,
82
+ name: catalog.name,
83
+ status: "active",
84
+ });
85
+ }
86
+ }
87
+ const seed = CATALOG_DESCRIPTOR_SEEDS[catalogId];
88
+ if (seed) {
89
+ const current = await catalox.getCatalogDescriptor(catalogId);
90
+ if (!current) {
91
+ await catalox.upsertCatalogDescriptor(catalogId, buildCatalogDescriptor(catalogId, catalog.name, seed));
92
+ }
93
+ }
94
+ await catalox.ensureBinding({
95
+ appId: plan.appId,
96
+ catalogId,
97
+ access: { canRead: true, canWrite: true, canAdmin: true },
98
+ });
99
+ }
100
+ }
101
+ //# sourceMappingURL=ensure-canonical-catalogs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ensure-canonical-catalogs.js","sourceRoot":"","sources":["../../src/migration/ensure-canonical-catalogs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mCAAmC,EACnC,kCAAkC,EAClC,uCAAuC,GACxC,MAAM,mBAAmB,CAAC;AAU3B,MAAM,wBAAwB,GAA0C;IACtE,CAAC,uCAAuC,CAAC,EAAE;QACzC,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,YAAY;QACxB,eAAe,EAAE;YACf,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;YAC1B,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE;YAC3C,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;SACnC;KACF;IACD,CAAC,mCAAmC,CAAC,EAAE;QACrC,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,MAAM;QAClB,eAAe,EAAE;YACf,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;YAC1B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;YAC9B,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE;SAC5C;KACF;IACD,CAAC,kCAAkC,CAAC,EAAE;QACpC,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KAC9C;CACF,CAAC;AAEF,SAAS,sBAAsB,CAAC,SAAiB,EAAE,KAAa,EAAE,IAA2B;IAC3F,OAAO;QACL,iBAAiB,EAAE,GAAG;QACtB,IAAI,EAAE,SAAkB;QACxB,UAAU,EAAE;YACV,SAAS;YACT,KAAK;YACL,UAAU,EAAE,QAAiB;YAC7B,MAAM,EAAE,QAAiB;YACzB,YAAY,EAAE;gBACZ,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,IAAI;gBACjB,iBAAiB,EAAE,IAAI;aACxB;YACD,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACpD,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,QAAiB;gBACvB,OAAO,EAAE,IAAI;gBACb,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;YACH,QAAQ,EAAE;gBACR,cAAc,EAAE,SAAkB;gBAClC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,OAA2B,EAC3B,IAAmC;IAEnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,SAAS,KAAK,uCAAuC,EAAE,CAAC;gBAC1D,MAAM,OAAO,CAAC,aAAa,CAAC;oBAC1B,SAAS;oBACT,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,WAAW,EAAE,SAAS;oBACtB,UAAU,EAAE,QAAQ;oBACpB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,CAAC,aAAa,CAAC;oBAC1B,SAAS;oBACT,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,MAAM,EAAE,QAAQ;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,OAAO,CAAC,uBAAuB,CACnC,SAAS,EACT,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CACtD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,OAAO,CAAC,aAAa,CAAC;YAC1B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS;YACT,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC1D,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
@@ -0,0 +1,22 @@
1
+ import type { MemorixTarget } from "../types/index.js";
2
+ import { type CanonicalObjectTypeSpec } from "./object-type-specs.js";
3
+ export type GenerateDescriptorsOptions = {
4
+ identityFieldByObjectType?: Record<string, string>;
5
+ preserveCompletionMappings?: Array<Record<string, unknown>>;
6
+ };
7
+ export declare function buildObjectTypeDescriptor(spec: CanonicalObjectTypeSpec, identityField?: string): Record<string, unknown>;
8
+ export declare function buildObjectListDescriptor(spec: CanonicalObjectTypeSpec): Record<string, unknown>;
9
+ export declare function buildWorkspaceListDescriptor(objectTypes: string[]): Record<string, unknown>;
10
+ export declare function buildCriticalVulnerabilitiesSlice(): Record<string, unknown>;
11
+ export declare function buildItemDescriptor(spec: CanonicalObjectTypeSpec): Record<string, unknown>;
12
+ export declare function buildDefaultInventoryPolicy(): Record<string, unknown>;
13
+ export declare function migrateCompletionMappingToV2(raw: Record<string, unknown>): Record<string, unknown> | null;
14
+ export declare function buildCanonicalDescriptorSet(options?: GenerateDescriptorsOptions): {
15
+ objectTypes: Record<string, Record<string, unknown>>;
16
+ lists: Record<string, Record<string, unknown>>;
17
+ items: Record<string, Record<string, unknown>>;
18
+ inventoryPolicy: Record<string, unknown>;
19
+ completionMappings: Record<string, Record<string, unknown>>;
20
+ };
21
+ export declare function expectedCollectionsForSpecs(specs?: CanonicalObjectTypeSpec[]): Map<MemorixTarget, Set<string>>;
22
+ //# sourceMappingURL=generate-descriptors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-descriptors.d.ts","sourceRoot":"","sources":["../../src/migration/generate-descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQvD,OAAO,EASL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,0BAA0B,GAAG;IACvC,yBAAyB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,0BAA0B,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D,CAAC;AAoBF,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,uBAAuB,EAC7B,aAAa,SAAa,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0CzB;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBhG;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsB3F;AAED,wBAAgB,iCAAiC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4B3E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiC1F;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMrE;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAqBhC;AAED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,0BAA+B,GACvC;IACD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D,CA8BA;AAED,wBAAgB,2BAA2B,CACzC,KAAK,GAAE,uBAAuB,EAAgC,GAC7D,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAUjC"}