@x12i/memorix-descriptors 1.4.2 → 1.4.5
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.
- package/README.md +17 -10
- package/dist/admin/create-admin.d.ts +15 -0
- package/dist/admin/create-admin.d.ts.map +1 -1
- package/dist/admin/create-admin.js +27 -0
- package/dist/admin/create-admin.js.map +1 -1
- package/dist/cli/index.js +139 -3
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/mutations/common.d.ts +7 -4
- package/dist/mutations/common.d.ts.map +1 -1
- package/dist/mutations/common.js +54 -3
- package/dist/mutations/common.js.map +1 -1
- package/dist/mutations/entity.d.ts.map +1 -1
- package/dist/mutations/entity.js +5 -1
- package/dist/mutations/entity.js.map +1 -1
- package/dist/mutations/execute.d.ts.map +1 -1
- package/dist/mutations/execute.js +9 -1
- package/dist/mutations/execute.js.map +1 -1
- package/dist/mutations/item.d.ts.map +1 -1
- package/dist/mutations/item.js +5 -1
- package/dist/mutations/item.js.map +1 -1
- package/dist/mutations/list.js +8 -1
- package/dist/mutations/list.js.map +1 -1
- package/dist/source/action-drafts.d.ts +17 -0
- package/dist/source/action-drafts.d.ts.map +1 -0
- package/dist/source/action-drafts.js +191 -0
- package/dist/source/action-drafts.js.map +1 -0
- package/dist/source/aliases.d.ts +23 -0
- package/dist/source/aliases.d.ts.map +1 -0
- package/dist/source/aliases.js +60 -0
- package/dist/source/aliases.js.map +1 -0
- package/dist/source/catalog-health.d.ts +17 -0
- package/dist/source/catalog-health.d.ts.map +1 -0
- package/dist/source/catalog-health.js +87 -0
- package/dist/source/catalog-health.js.map +1 -0
- package/dist/source/envelope.d.ts +29 -0
- package/dist/source/envelope.d.ts.map +1 -0
- package/dist/source/envelope.js +125 -0
- package/dist/source/envelope.js.map +1 -0
- package/dist/source/graph.d.ts +12 -0
- package/dist/source/graph.d.ts.map +1 -0
- package/dist/source/graph.js +148 -0
- package/dist/source/graph.js.map +1 -0
- package/dist/source/guards.d.ts +7 -0
- package/dist/source/guards.d.ts.map +1 -0
- package/dist/source/guards.js +74 -0
- package/dist/source/guards.js.map +1 -0
- package/dist/source/index.d.ts +14 -0
- package/dist/source/index.d.ts.map +1 -0
- package/dist/source/index.js +14 -0
- package/dist/source/index.js.map +1 -0
- package/dist/source/inspectable.d.ts +11 -0
- package/dist/source/inspectable.d.ts.map +1 -0
- package/dist/source/inspectable.js +167 -0
- package/dist/source/inspectable.js.map +1 -0
- package/dist/source/reconcile-source.d.ts +10 -0
- package/dist/source/reconcile-source.d.ts.map +1 -0
- package/dist/source/reconcile-source.js +40 -0
- package/dist/source/reconcile-source.js.map +1 -0
- package/dist/source/registry.d.ts +11 -0
- package/dist/source/registry.d.ts.map +1 -0
- package/dist/source/registry.js +114 -0
- package/dist/source/registry.js.map +1 -0
- package/dist/source/snapshot.d.ts +15 -0
- package/dist/source/snapshot.d.ts.map +1 -0
- package/dist/source/snapshot.js +160 -0
- package/dist/source/snapshot.js.map +1 -0
- package/dist/source/types.d.ts +222 -0
- package/dist/source/types.d.ts.map +1 -0
- package/dist/source/types.js +2 -0
- package/dist/source/types.js.map +1 -0
- package/dist/source/validation.d.ts +12 -0
- package/dist/source/validation.d.ts.map +1 -0
- package/dist/source/validation.js +229 -0
- package/dist/source/validation.js.map +1 -0
- package/dist/tests/source-aware.test.d.ts +2 -0
- package/dist/tests/source-aware.test.d.ts.map +1 -0
- package/dist/tests/source-aware.test.js +222 -0
- package/dist/tests/source-aware.test.js.map +1 -0
- package/dist/types/index.d.ts +25 -2
- package/dist/types/index.d.ts.map +1 -1
- package/docs/MEMORIX-CATALOX-CATALOG-MAP.md +589 -0
- package/docs/MEMORIX-CATALOX-CONTRACTS.md +17 -10
- package/docs/MEMORIX-DATABASE-CONVENTIONS.md +10 -7
- package/docs/MEMORIX-OBJECT-TYPES-AND-TARGETS.md +207 -0
- package/package.json +1 -1
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
import type { MemorixCompletionMapping, MemorixEntityDescriptor, MemorixInventoryPolicy, MemorixItemDescriptor, MemorixListDescriptor, MemorixSliceDescriptor, MemorixTarget } from "../types/index.js";
|
|
2
|
+
export type MemorixSourceClass = "canonical-catalox-descriptor" | "catalox-control-plane" | "legacy-catalox-catalog" | "parallel-catalox-catalog" | "runtime-projection" | "mongo-payload" | "local-ui-state" | "unknown-source";
|
|
3
|
+
export type MemorixCanonicalStatus = "canonical" | "control-plane" | "legacy" | "parallel" | "derived" | "local" | "unknown";
|
|
4
|
+
export type MemorixEditability = "editable" | "read-only" | "not-editable" | "draft-only" | "unknown";
|
|
5
|
+
export type MemorixDescriptorKind = "object-type" | "list" | "item" | "slice" | "completion-mapping" | "inventory-policy" | "legacy-schema-inference" | "legacy-content-type" | "knowledge-artifact";
|
|
6
|
+
export type MemorixSourceRef = {
|
|
7
|
+
sourceClass: MemorixSourceClass;
|
|
8
|
+
canonicalStatus: MemorixCanonicalStatus;
|
|
9
|
+
appId?: string;
|
|
10
|
+
catalogId?: string;
|
|
11
|
+
itemId?: string;
|
|
12
|
+
firestoreCollection?: string;
|
|
13
|
+
descriptorKind?: MemorixDescriptorKind;
|
|
14
|
+
objectType?: string;
|
|
15
|
+
entityName?: string;
|
|
16
|
+
target?: MemorixTarget;
|
|
17
|
+
databaseName?: string;
|
|
18
|
+
collectionName?: string;
|
|
19
|
+
contentType?: string;
|
|
20
|
+
loadedAt: string;
|
|
21
|
+
generatedAt?: string;
|
|
22
|
+
generatedBy?: string;
|
|
23
|
+
editable: MemorixEditability;
|
|
24
|
+
trustWarning?: string;
|
|
25
|
+
};
|
|
26
|
+
export type SourceAware<T> = {
|
|
27
|
+
data: T;
|
|
28
|
+
source: MemorixSourceRef;
|
|
29
|
+
};
|
|
30
|
+
export type MemorixCatalogSourceRegistryEntry = {
|
|
31
|
+
catalogId: string;
|
|
32
|
+
sourceClass: MemorixSourceClass;
|
|
33
|
+
canonicalStatus: MemorixCanonicalStatus;
|
|
34
|
+
descriptorKind: MemorixDescriptorKind;
|
|
35
|
+
editable: MemorixEditability;
|
|
36
|
+
managedByDescriptors: boolean;
|
|
37
|
+
trustWarning?: string;
|
|
38
|
+
replacementCatalogId?: string;
|
|
39
|
+
};
|
|
40
|
+
export type MemorixCatalogSourceRegistry = {
|
|
41
|
+
appIdDefault: "memorix";
|
|
42
|
+
catalogs: Record<string, MemorixCatalogSourceRegistryEntry>;
|
|
43
|
+
};
|
|
44
|
+
export type SourceAwareCatalogHealth = {
|
|
45
|
+
catalogId: string;
|
|
46
|
+
sourceClass: MemorixSourceClass;
|
|
47
|
+
canonicalStatus: MemorixCanonicalStatus;
|
|
48
|
+
descriptorKind?: MemorixDescriptorKind;
|
|
49
|
+
exists: boolean;
|
|
50
|
+
readable: boolean;
|
|
51
|
+
itemCount?: number;
|
|
52
|
+
error?: {
|
|
53
|
+
code: string;
|
|
54
|
+
message: string;
|
|
55
|
+
};
|
|
56
|
+
editable: MemorixEditability;
|
|
57
|
+
};
|
|
58
|
+
export type SourceAwareDescriptorSnapshot = {
|
|
59
|
+
appId: string;
|
|
60
|
+
loadedAt: string;
|
|
61
|
+
catalogs: SourceAwareCatalogHealth[];
|
|
62
|
+
canonical: {
|
|
63
|
+
objectTypes: Array<SourceAware<MemorixEntityDescriptor>>;
|
|
64
|
+
lists: Array<SourceAware<MemorixListDescriptor>>;
|
|
65
|
+
items: Array<SourceAware<MemorixItemDescriptor>>;
|
|
66
|
+
slices: Array<SourceAware<MemorixSliceDescriptor>>;
|
|
67
|
+
};
|
|
68
|
+
controlPlane: {
|
|
69
|
+
completionMappings: Array<SourceAware<MemorixCompletionMapping>>;
|
|
70
|
+
inventoryPolicies: Array<SourceAware<MemorixInventoryPolicy>>;
|
|
71
|
+
};
|
|
72
|
+
legacy?: {
|
|
73
|
+
schemaInferenceCatalog?: Array<SourceAware<unknown>>;
|
|
74
|
+
globalContentTypeCatalog?: Array<SourceAware<unknown>>;
|
|
75
|
+
};
|
|
76
|
+
parallel?: {
|
|
77
|
+
knowledgeArtifacts?: Array<SourceAware<unknown>>;
|
|
78
|
+
};
|
|
79
|
+
warnings: Array<{
|
|
80
|
+
code: string;
|
|
81
|
+
message: string;
|
|
82
|
+
source?: MemorixSourceRef;
|
|
83
|
+
}>;
|
|
84
|
+
errors: Array<{
|
|
85
|
+
code: string;
|
|
86
|
+
message: string;
|
|
87
|
+
source?: MemorixSourceRef;
|
|
88
|
+
}>;
|
|
89
|
+
};
|
|
90
|
+
export type SourceAwareValidationFixability = "auto-fixable" | "draft-available" | "manual-edit" | "not-fixable" | "unknown";
|
|
91
|
+
export type SourceAwareValidationSuggestedAction = "open-descriptor" | "edit-descriptor" | "add-content-type" | "create-list" | "create-item" | "fix-relation" | "ignore-legacy" | "inspect-source" | "ask-user";
|
|
92
|
+
export type SourceAwareValidationIssue = {
|
|
93
|
+
severity: "info" | "warning" | "error";
|
|
94
|
+
code: string;
|
|
95
|
+
message: string;
|
|
96
|
+
path?: string;
|
|
97
|
+
source: MemorixSourceRef;
|
|
98
|
+
fixability: SourceAwareValidationFixability;
|
|
99
|
+
suggestedAction?: SourceAwareValidationSuggestedAction;
|
|
100
|
+
};
|
|
101
|
+
export type SourceAwareReferenceGraph = {
|
|
102
|
+
generatedAt: string;
|
|
103
|
+
graphKind: "reference-graph";
|
|
104
|
+
sourceClass: "runtime-projection";
|
|
105
|
+
canonicalStatus: "derived";
|
|
106
|
+
nodes: Array<{
|
|
107
|
+
id: string;
|
|
108
|
+
label: string;
|
|
109
|
+
kind: string;
|
|
110
|
+
source: MemorixSourceRef;
|
|
111
|
+
}>;
|
|
112
|
+
edges: Array<{
|
|
113
|
+
id: string;
|
|
114
|
+
from: string;
|
|
115
|
+
to: string;
|
|
116
|
+
kind: string;
|
|
117
|
+
source: MemorixSourceRef;
|
|
118
|
+
path?: string;
|
|
119
|
+
}>;
|
|
120
|
+
};
|
|
121
|
+
export type SourceAwareDescriptorValidationReport = {
|
|
122
|
+
ok: boolean;
|
|
123
|
+
graphValid: boolean;
|
|
124
|
+
loadedAt: string;
|
|
125
|
+
summary: {
|
|
126
|
+
canonicalDescriptorCount: number;
|
|
127
|
+
controlPlaneItemCount: number;
|
|
128
|
+
legacyItemCount?: number;
|
|
129
|
+
errors: number;
|
|
130
|
+
warnings: number;
|
|
131
|
+
};
|
|
132
|
+
issues: SourceAwareValidationIssue[];
|
|
133
|
+
references: SourceAwareReferenceGraph;
|
|
134
|
+
};
|
|
135
|
+
export type SourceAwareDescriptorGraph = {
|
|
136
|
+
generatedAt: string;
|
|
137
|
+
graphKind: "descriptor-graph";
|
|
138
|
+
sourceClass: "runtime-projection";
|
|
139
|
+
canonicalStatus: "derived";
|
|
140
|
+
nodes: Array<{
|
|
141
|
+
id: string;
|
|
142
|
+
label: string;
|
|
143
|
+
kind: "object-type-descriptor" | "list-descriptor" | "item-descriptor" | "slice-descriptor" | "relation" | "completion-mapping" | "inventory-policy";
|
|
144
|
+
source: MemorixSourceRef;
|
|
145
|
+
objectType?: string;
|
|
146
|
+
target?: MemorixTarget;
|
|
147
|
+
catalogId?: string;
|
|
148
|
+
itemId?: string;
|
|
149
|
+
validationStatus?: "valid" | "warning" | "error" | "unknown";
|
|
150
|
+
}>;
|
|
151
|
+
edges: Array<{
|
|
152
|
+
id: string;
|
|
153
|
+
kind: "default-list" | "default-item" | "list-of-object-type" | "item-of-object-type" | "slice-of-object-type" | "relation-target" | "mapping-target" | "policy-target";
|
|
154
|
+
from: string;
|
|
155
|
+
to: string;
|
|
156
|
+
source: MemorixSourceRef;
|
|
157
|
+
path?: string;
|
|
158
|
+
}>;
|
|
159
|
+
issues: SourceAwareValidationIssue[];
|
|
160
|
+
};
|
|
161
|
+
export type MemorixInspectableSources = {
|
|
162
|
+
groups: Array<{
|
|
163
|
+
groupId: "canonical-descriptors" | "control-plane" | "legacy-catalogs" | "parallel-catalogs" | "unknown";
|
|
164
|
+
title: string;
|
|
165
|
+
description: string;
|
|
166
|
+
sources: Array<{
|
|
167
|
+
source: MemorixSourceRef;
|
|
168
|
+
title: string;
|
|
169
|
+
subtitle?: string;
|
|
170
|
+
itemCount?: number;
|
|
171
|
+
warnings?: string[];
|
|
172
|
+
}>;
|
|
173
|
+
}>;
|
|
174
|
+
};
|
|
175
|
+
export type DescriptorActionDraft = {
|
|
176
|
+
draftId: string;
|
|
177
|
+
action: "register-object-type" | "add-content-type" | "fix-collection-binding" | "ignore-collection" | "ensure-collection" | "update-list" | "update-item" | "manual-review";
|
|
178
|
+
status: "draft";
|
|
179
|
+
source: MemorixSourceRef;
|
|
180
|
+
targetSource?: MemorixSourceRef;
|
|
181
|
+
proposedMutation: {
|
|
182
|
+
method: "registerEntityDescriptor";
|
|
183
|
+
input: unknown;
|
|
184
|
+
} | {
|
|
185
|
+
method: "addContentType";
|
|
186
|
+
input: unknown;
|
|
187
|
+
} | {
|
|
188
|
+
method: "updateContentType";
|
|
189
|
+
input: unknown;
|
|
190
|
+
} | {
|
|
191
|
+
method: "ignoreCollection";
|
|
192
|
+
input: unknown;
|
|
193
|
+
};
|
|
194
|
+
explanation: string;
|
|
195
|
+
warnings: Array<{
|
|
196
|
+
code: string;
|
|
197
|
+
message: string;
|
|
198
|
+
}>;
|
|
199
|
+
requiredUserInputs?: Array<{
|
|
200
|
+
key: string;
|
|
201
|
+
label: string;
|
|
202
|
+
reason: string;
|
|
203
|
+
options?: string[];
|
|
204
|
+
required: boolean;
|
|
205
|
+
}>;
|
|
206
|
+
dryRunAvailable: boolean;
|
|
207
|
+
};
|
|
208
|
+
export type SourceAwareReconcileReport = {
|
|
209
|
+
loadedAt: string;
|
|
210
|
+
inventory: import("../reconcile/types.js").MemorixUnifiedInventory;
|
|
211
|
+
suggestions: import("../reconcile/types.js").ReconcileSuggestion[];
|
|
212
|
+
issues: import("../reconcile/types.js").MemorixInventoryIssue[];
|
|
213
|
+
applied: import("../reconcile/types.js").ReconcileDescriptorsResult["applied"];
|
|
214
|
+
drafts: DescriptorActionDraft[];
|
|
215
|
+
source: MemorixSourceRef;
|
|
216
|
+
};
|
|
217
|
+
export type SourceNotEditableError = {
|
|
218
|
+
code: "SOURCE_NOT_EDITABLE";
|
|
219
|
+
message: string;
|
|
220
|
+
source: MemorixSourceRef;
|
|
221
|
+
};
|
|
222
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/source/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/source/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { CataloxBoundClient } from "../catalox/client.js";
|
|
2
|
+
import { sourceRefForCataloxWrite } from "./envelope.js";
|
|
3
|
+
import type { SourceAwareDescriptorValidationReport } from "./types.js";
|
|
4
|
+
export type ValidateSourceAwareMemorixDescriptorsOptions = {
|
|
5
|
+
appId?: string;
|
|
6
|
+
includeCatalogHealth?: boolean;
|
|
7
|
+
includeLegacyWarnings?: boolean;
|
|
8
|
+
includeFixHints?: boolean;
|
|
9
|
+
};
|
|
10
|
+
export declare function validateSourceAwareMemorixDescriptors(catalox: CataloxBoundClient, options?: ValidateSourceAwareMemorixDescriptorsOptions): Promise<SourceAwareDescriptorValidationReport>;
|
|
11
|
+
export { sourceRefForCataloxWrite };
|
|
12
|
+
//# sourceMappingURL=validation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
|
|
2
|
+
import { buildDescriptorGraph } from "../integrity/graph.js";
|
|
3
|
+
import { validateDescriptorSnapshot } from "../integrity/validate.js";
|
|
4
|
+
import { buildDerivedGraphSourceRef, buildInventoryPolicySourceRef, buildItemSourceRef, buildListSourceRef, buildMappingSourceRef, buildObjectTypeSourceRef, nowIso, sourceRefForCataloxWrite, } from "./envelope.js";
|
|
5
|
+
import { loadSourceAwareDescriptorSnapshot } from "./snapshot.js";
|
|
6
|
+
const FIXABILITY_BY_CODE = {
|
|
7
|
+
MISSING_DEFAULT_LIST: "manual-edit",
|
|
8
|
+
MISSING_DEFAULT_ITEM: "manual-edit",
|
|
9
|
+
UNKNOWN_ENTITY: "manual-edit",
|
|
10
|
+
UNKNOWN_TARGET_ENTITY: "manual-edit",
|
|
11
|
+
UNKNOWN_CONTENT_TYPE: "draft-available",
|
|
12
|
+
UNKNOWN_LEADING_CONTENT_TYPE: "draft-available",
|
|
13
|
+
UNKNOWN_EXTENSION_CONTENT_TYPE: "draft-available",
|
|
14
|
+
UNKNOWN_FIELD: "manual-edit",
|
|
15
|
+
NON_HUMAN_READABLE_ITEM_FIELD: "manual-edit",
|
|
16
|
+
UNKNOWN_RELATION: "manual-edit",
|
|
17
|
+
UNKNOWN_TARGET_COLLECTION: "manual-edit",
|
|
18
|
+
TARGET_MISMATCH: "manual-edit",
|
|
19
|
+
LEGACY_CATALOG_PRESENT: "not-fixable",
|
|
20
|
+
INVALID_ENTITY_DESCRIPTOR: "manual-edit",
|
|
21
|
+
INVALID_LIST_DESCRIPTOR: "manual-edit",
|
|
22
|
+
INVALID_ITEM_DESCRIPTOR: "manual-edit",
|
|
23
|
+
INVALID_SLICE_DESCRIPTOR: "manual-edit",
|
|
24
|
+
EMPTY_LIST_FIELDS: "manual-edit",
|
|
25
|
+
FORBIDDEN_ENV_REFERENCE: "not-fixable",
|
|
26
|
+
POSSIBLE_CREDENTIALS: "manual-edit",
|
|
27
|
+
};
|
|
28
|
+
const SUGGESTED_ACTION_BY_CODE = {
|
|
29
|
+
MISSING_DEFAULT_LIST: "create-list",
|
|
30
|
+
MISSING_DEFAULT_ITEM: "create-item",
|
|
31
|
+
UNKNOWN_ENTITY: "edit-descriptor",
|
|
32
|
+
UNKNOWN_TARGET_ENTITY: "fix-relation",
|
|
33
|
+
UNKNOWN_CONTENT_TYPE: "add-content-type",
|
|
34
|
+
UNKNOWN_LEADING_CONTENT_TYPE: "add-content-type",
|
|
35
|
+
UNKNOWN_EXTENSION_CONTENT_TYPE: "add-content-type",
|
|
36
|
+
UNKNOWN_FIELD: "edit-descriptor",
|
|
37
|
+
NON_HUMAN_READABLE_ITEM_FIELD: "edit-descriptor",
|
|
38
|
+
UNKNOWN_RELATION: "fix-relation",
|
|
39
|
+
UNKNOWN_TARGET_COLLECTION: "edit-descriptor",
|
|
40
|
+
TARGET_MISMATCH: "edit-descriptor",
|
|
41
|
+
LEGACY_CATALOG_PRESENT: "ignore-legacy",
|
|
42
|
+
INVALID_ENTITY_DESCRIPTOR: "open-descriptor",
|
|
43
|
+
INVALID_LIST_DESCRIPTOR: "open-descriptor",
|
|
44
|
+
INVALID_ITEM_DESCRIPTOR: "open-descriptor",
|
|
45
|
+
INVALID_SLICE_DESCRIPTOR: "open-descriptor",
|
|
46
|
+
EMPTY_LIST_FIELDS: "edit-descriptor",
|
|
47
|
+
FORBIDDEN_ENV_REFERENCE: "inspect-source",
|
|
48
|
+
POSSIBLE_CREDENTIALS: "inspect-source",
|
|
49
|
+
};
|
|
50
|
+
function catalogForPath(path, snapshot) {
|
|
51
|
+
const itemId = path?.split("/")[0] ?? "unknown";
|
|
52
|
+
if (!snapshot) {
|
|
53
|
+
return { catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG, itemId };
|
|
54
|
+
}
|
|
55
|
+
if (snapshot.entityDescriptors[itemId]) {
|
|
56
|
+
return { catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG, itemId, descriptorKind: "object-type" };
|
|
57
|
+
}
|
|
58
|
+
if (snapshot.listDescriptors[itemId]) {
|
|
59
|
+
const raw = snapshot.listDescriptors[itemId];
|
|
60
|
+
return {
|
|
61
|
+
catalogId: MEMORIX_LIST_DESCRIPTORS_CATALOG,
|
|
62
|
+
itemId,
|
|
63
|
+
descriptorKind: raw.kind === "slice" ? "slice" : "list",
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
if (snapshot.itemDescriptors[itemId]) {
|
|
67
|
+
return { catalogId: MEMORIX_ITEM_DESCRIPTORS_CATALOG, itemId, descriptorKind: "item" };
|
|
68
|
+
}
|
|
69
|
+
if (snapshot.completionMappings[itemId]) {
|
|
70
|
+
return {
|
|
71
|
+
catalogId: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
|
|
72
|
+
itemId,
|
|
73
|
+
descriptorKind: "completion-mapping",
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
return { catalogId: MEMORIX_ENTITY_DESCRIPTORS_CATALOG, itemId };
|
|
77
|
+
}
|
|
78
|
+
function issueToSourceAware(issue, loadedAt, appId, snapshot, includeFixHints) {
|
|
79
|
+
const { catalogId, itemId, descriptorKind } = catalogForPath(issue.path, snapshot);
|
|
80
|
+
const entityRaw = snapshot.entityDescriptors[itemId];
|
|
81
|
+
const objectType = entityRaw && typeof entityRaw.entityName === "string"
|
|
82
|
+
? entityRaw.entityName
|
|
83
|
+
: undefined;
|
|
84
|
+
const target = entityRaw && typeof entityRaw.target === "string"
|
|
85
|
+
? entityRaw.target
|
|
86
|
+
: undefined;
|
|
87
|
+
const source = buildObjectTypeSourceRef(itemId, appId, loadedAt, objectType, target);
|
|
88
|
+
source.catalogId = catalogId;
|
|
89
|
+
source.itemId = itemId;
|
|
90
|
+
source.descriptorKind = descriptorKind;
|
|
91
|
+
if (catalogId === MEMORIX_LIST_DESCRIPTORS_CATALOG) {
|
|
92
|
+
Object.assign(source, buildListSourceRef(itemId, appId, loadedAt, objectType, descriptorKind === "slice" ? "slice" : "list"));
|
|
93
|
+
}
|
|
94
|
+
else if (catalogId === MEMORIX_ITEM_DESCRIPTORS_CATALOG) {
|
|
95
|
+
Object.assign(source, buildItemSourceRef(itemId, appId, loadedAt, objectType));
|
|
96
|
+
}
|
|
97
|
+
else if (catalogId === MEMORIX_COMPLETION_MAPPINGS_CATALOG) {
|
|
98
|
+
Object.assign(source, buildMappingSourceRef(itemId, appId, loadedAt, objectType, target));
|
|
99
|
+
}
|
|
100
|
+
return {
|
|
101
|
+
severity: issue.severity === "warning" ? "warning" : "error",
|
|
102
|
+
code: issue.code,
|
|
103
|
+
message: issue.message,
|
|
104
|
+
path: issue.path,
|
|
105
|
+
source,
|
|
106
|
+
fixability: includeFixHints
|
|
107
|
+
? (FIXABILITY_BY_CODE[issue.code] ?? "unknown")
|
|
108
|
+
: "unknown",
|
|
109
|
+
suggestedAction: includeFixHints
|
|
110
|
+
? SUGGESTED_ACTION_BY_CODE[issue.code]
|
|
111
|
+
: undefined,
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
function buildReferenceGraph(snapshot, appId, loadedAt) {
|
|
115
|
+
const graph = buildDescriptorGraph(snapshot);
|
|
116
|
+
const graphSource = buildDerivedGraphSourceRef("memorix-descriptors", loadedAt);
|
|
117
|
+
return {
|
|
118
|
+
generatedAt: loadedAt,
|
|
119
|
+
graphKind: "reference-graph",
|
|
120
|
+
sourceClass: "runtime-projection",
|
|
121
|
+
canonicalStatus: "derived",
|
|
122
|
+
nodes: graph.nodes.map((node) => ({
|
|
123
|
+
id: node.id,
|
|
124
|
+
label: node.label,
|
|
125
|
+
kind: node.kind,
|
|
126
|
+
source: {
|
|
127
|
+
...graphSource,
|
|
128
|
+
catalogId: node.kind === "entity"
|
|
129
|
+
? MEMORIX_ENTITY_DESCRIPTORS_CATALOG
|
|
130
|
+
: node.kind === "list"
|
|
131
|
+
? MEMORIX_LIST_DESCRIPTORS_CATALOG
|
|
132
|
+
: node.kind === "item"
|
|
133
|
+
? MEMORIX_ITEM_DESCRIPTORS_CATALOG
|
|
134
|
+
: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
|
|
135
|
+
itemId: node.id,
|
|
136
|
+
objectType: node.kind === "entity" ? node.label : undefined,
|
|
137
|
+
target: node.target,
|
|
138
|
+
},
|
|
139
|
+
})),
|
|
140
|
+
edges: graph.edges.map((edge, index) => ({
|
|
141
|
+
id: `edge-${index}`,
|
|
142
|
+
from: edge.from,
|
|
143
|
+
to: edge.to,
|
|
144
|
+
kind: edge.kind,
|
|
145
|
+
source: graphSource,
|
|
146
|
+
path: edge.kind,
|
|
147
|
+
})),
|
|
148
|
+
};
|
|
149
|
+
}
|
|
150
|
+
export async function validateSourceAwareMemorixDescriptors(catalox, options = {}) {
|
|
151
|
+
const loadedAt = nowIso();
|
|
152
|
+
const appId = options.appId ?? "memorix";
|
|
153
|
+
const includeFixHints = options.includeFixHints ?? true;
|
|
154
|
+
const includeLegacyWarnings = options.includeLegacyWarnings ?? true;
|
|
155
|
+
const sourceSnapshot = await loadSourceAwareDescriptorSnapshot(catalox, {
|
|
156
|
+
appId,
|
|
157
|
+
includeCatalogHealth: options.includeCatalogHealth ?? true,
|
|
158
|
+
includeLegacyCatalogs: includeLegacyWarnings,
|
|
159
|
+
includeParallelCatalogs: false,
|
|
160
|
+
});
|
|
161
|
+
const snapshot = {
|
|
162
|
+
entityDescriptors: Object.fromEntries(sourceSnapshot.canonical.objectTypes.map((e) => [e.source.itemId, e.data])),
|
|
163
|
+
listDescriptors: Object.fromEntries([
|
|
164
|
+
...sourceSnapshot.canonical.lists.map((l) => [l.source.itemId, l.data]),
|
|
165
|
+
...sourceSnapshot.canonical.slices.map((s) => [s.source.itemId, s.data]),
|
|
166
|
+
]),
|
|
167
|
+
itemDescriptors: Object.fromEntries(sourceSnapshot.canonical.items.map((i) => [i.source.itemId, i.data])),
|
|
168
|
+
completionMappings: Object.fromEntries(sourceSnapshot.controlPlane.completionMappings.map((m) => [m.source.itemId, m.data])),
|
|
169
|
+
inventoryPolicy: sourceSnapshot.controlPlane.inventoryPolicies[0]?.data ?? null,
|
|
170
|
+
};
|
|
171
|
+
const report = validateDescriptorSnapshot(snapshot);
|
|
172
|
+
const issues = [
|
|
173
|
+
...report.errors.map((issue) => issueToSourceAware(issue, loadedAt, appId, snapshot, includeFixHints)),
|
|
174
|
+
...report.warnings.map((issue) => issueToSourceAware(issue, loadedAt, appId, snapshot, includeFixHints)),
|
|
175
|
+
];
|
|
176
|
+
for (const warning of sourceSnapshot.warnings) {
|
|
177
|
+
issues.push({
|
|
178
|
+
severity: "warning",
|
|
179
|
+
code: warning.code,
|
|
180
|
+
message: warning.message,
|
|
181
|
+
source: warning.source ?? buildInventoryPolicySourceRef(appId, loadedAt),
|
|
182
|
+
fixability: FIXABILITY_BY_CODE[warning.code] ?? "unknown",
|
|
183
|
+
suggestedAction: SUGGESTED_ACTION_BY_CODE[warning.code],
|
|
184
|
+
});
|
|
185
|
+
}
|
|
186
|
+
for (const error of sourceSnapshot.errors) {
|
|
187
|
+
issues.push({
|
|
188
|
+
severity: "error",
|
|
189
|
+
code: error.code,
|
|
190
|
+
message: error.message,
|
|
191
|
+
source: error.source ?? buildObjectTypeSourceRef("unknown", appId, loadedAt),
|
|
192
|
+
fixability: "manual-edit",
|
|
193
|
+
suggestedAction: "inspect-source",
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
if (includeLegacyWarnings && sourceSnapshot.legacy?.schemaInferenceCatalog?.length) {
|
|
197
|
+
issues.push({
|
|
198
|
+
severity: "warning",
|
|
199
|
+
code: "LEGACY_CATALOG_PRESENT",
|
|
200
|
+
message: "Legacy memorix-entities catalog is present and potentially confusing.",
|
|
201
|
+
source: sourceSnapshot.legacy.schemaInferenceCatalog[0].source,
|
|
202
|
+
fixability: "not-fixable",
|
|
203
|
+
suggestedAction: "ignore-legacy",
|
|
204
|
+
});
|
|
205
|
+
}
|
|
206
|
+
const errorCount = issues.filter((i) => i.severity === "error").length;
|
|
207
|
+
const warningCount = issues.filter((i) => i.severity === "warning").length;
|
|
208
|
+
return {
|
|
209
|
+
ok: errorCount === 0,
|
|
210
|
+
graphValid: report.valid,
|
|
211
|
+
loadedAt,
|
|
212
|
+
summary: {
|
|
213
|
+
canonicalDescriptorCount: sourceSnapshot.canonical.objectTypes.length +
|
|
214
|
+
sourceSnapshot.canonical.lists.length +
|
|
215
|
+
sourceSnapshot.canonical.items.length +
|
|
216
|
+
sourceSnapshot.canonical.slices.length,
|
|
217
|
+
controlPlaneItemCount: sourceSnapshot.controlPlane.completionMappings.length +
|
|
218
|
+
sourceSnapshot.controlPlane.inventoryPolicies.length,
|
|
219
|
+
legacyItemCount: (sourceSnapshot.legacy?.schemaInferenceCatalog?.length ?? 0) +
|
|
220
|
+
(sourceSnapshot.legacy?.globalContentTypeCatalog?.length ?? 0),
|
|
221
|
+
errors: errorCount,
|
|
222
|
+
warnings: warningCount,
|
|
223
|
+
},
|
|
224
|
+
issues,
|
|
225
|
+
references: buildReferenceGraph(snapshot, appId, loadedAt),
|
|
226
|
+
};
|
|
227
|
+
}
|
|
228
|
+
export { sourceRefForCataloxWrite };
|
|
229
|
+
//# sourceMappingURL=validation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/source/validation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"source-aware.test.d.ts","sourceRoot":"","sources":["../../src/tests/source-aware.test.ts"],"names":[],"mappings":""}
|