@decantr/verifier 2.5.1 → 3.0.0-next.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.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@decantr/verifier",
3
- "version": "2.5.1",
4
- "description": "Shared verification, critique, Project Health, and report-schema engine for Decantr",
3
+ "version": "3.0.0-next.0",
4
+ "description": "Shared verification, typed findings, graph anchors, Project Health, and evidence schemas for Decantr",
5
5
  "keywords": [
6
6
  "decantr",
7
7
  "decantr-ai",
@@ -9,7 +9,9 @@
9
9
  "ui-verification",
10
10
  "drift-detection",
11
11
  "design-governance",
12
- "ai-generated-ui",
12
+ "ai-frontend-governance",
13
+ "typed-findings",
14
+ "graph-anchors",
13
15
  "ci",
14
16
  "critique"
15
17
  ],
@@ -53,9 +55,10 @@
53
55
  "access": "public"
54
56
  },
55
57
  "dependencies": {
58
+ "entities": "^6.0.1",
56
59
  "typescript": "^6.0.3",
57
- "@decantr/core": "2.1.0",
58
- "@decantr/essence-spec": "2.0.1"
60
+ "@decantr/core": "3.0.0-next.0",
61
+ "@decantr/essence-spec": "3.0.0-next.0"
59
62
  },
60
63
  "devDependencies": {
61
64
  "ajv": "^8.20.0",
@@ -64,11 +64,23 @@
64
64
  },
65
65
  "provenance": {
66
66
  "type": "object",
67
- "required": ["essence", "packManifest", "reviewPack"],
67
+ "required": [
68
+ "essence",
69
+ "packManifest",
70
+ "reviewPack",
71
+ "graphSnapshot",
72
+ "graphManifest",
73
+ "graphDiff",
74
+ "contractCapsule"
75
+ ],
68
76
  "properties": {
69
77
  "essence": { "$ref": "#/$defs/provenanceEntry" },
70
78
  "packManifest": { "$ref": "#/$defs/provenanceEntry" },
71
79
  "reviewPack": { "$ref": "#/$defs/provenanceEntry" },
80
+ "graphSnapshot": { "$ref": "#/$defs/provenanceEntry" },
81
+ "graphManifest": { "$ref": "#/$defs/provenanceEntry" },
82
+ "graphDiff": { "$ref": "#/$defs/provenanceEntry" },
83
+ "contractCapsule": { "$ref": "#/$defs/provenanceEntry" },
72
84
  "workspaceConfig": { "$ref": "#/$defs/provenanceEntry" },
73
85
  "designTokens": { "$ref": "#/$defs/provenanceEntry" }
74
86
  },
@@ -166,6 +178,9 @@
166
178
  ],
167
179
  "properties": {
168
180
  "id": { "type": "string" },
181
+ "code": {
182
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
183
+ },
169
184
  "source": {
170
185
  "type": "string",
171
186
  "enum": [
@@ -175,6 +190,8 @@
175
190
  "check",
176
191
  "brownfield",
177
192
  "design-token",
193
+ "style-bridge",
194
+ "graph",
178
195
  "runtime",
179
196
  "pack",
180
197
  "interaction"
@@ -187,11 +204,92 @@
187
204
  "target": { "type": "string" },
188
205
  "rule": { "type": "string" },
189
206
  "suggestedFix": { "type": "string" },
207
+ "graph": {
208
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/graphAnchor"
209
+ },
210
+ "repair": {
211
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/repairAction"
212
+ },
213
+ "repairPlan": { "$ref": "#/$defs/repairPlan" },
190
214
  "remediationSummary": { "type": "string" },
191
215
  "commands": { "type": "array", "items": { "type": "string" } },
192
216
  "promptCommand": { "type": "string" }
193
217
  },
194
218
  "additionalProperties": false
219
+ },
220
+ "repairPlan": {
221
+ "type": "object",
222
+ "required": [
223
+ "id",
224
+ "findingId",
225
+ "severity",
226
+ "source",
227
+ "category",
228
+ "actions",
229
+ "evidence",
230
+ "readTargets",
231
+ "preserve",
232
+ "avoid",
233
+ "commands"
234
+ ],
235
+ "properties": {
236
+ "id": { "type": "string" },
237
+ "findingId": { "type": "string" },
238
+ "diagnosticCode": { "type": ["string", "null"] },
239
+ "repairId": { "type": ["string", "null"] },
240
+ "severity": { "type": "string", "enum": ["error", "warn", "info"] },
241
+ "source": {
242
+ "type": "string",
243
+ "enum": [
244
+ "audit",
245
+ "assertion",
246
+ "browser",
247
+ "check",
248
+ "brownfield",
249
+ "design-token",
250
+ "style-bridge",
251
+ "graph",
252
+ "runtime",
253
+ "pack",
254
+ "interaction"
255
+ ]
256
+ },
257
+ "category": { "type": "string" },
258
+ "graphAnchor": {
259
+ "anyOf": [
260
+ { "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/graphAnchor" },
261
+ { "type": "null" }
262
+ ]
263
+ },
264
+ "actions": { "type": "array", "items": { "$ref": "#/$defs/repairPlanAction" } },
265
+ "evidence": { "type": "array", "items": { "$ref": "#/$defs/repairPlanEvidence" } },
266
+ "readTargets": { "type": "array", "items": { "type": "string" } },
267
+ "preserve": { "type": "array", "items": { "type": "string" } },
268
+ "avoid": { "type": "array", "items": { "type": "string" } },
269
+ "commands": { "type": "array", "items": { "type": "string" } }
270
+ },
271
+ "additionalProperties": false
272
+ },
273
+ "repairPlanAction": {
274
+ "type": "object",
275
+ "required": ["id", "kind", "description"],
276
+ "properties": {
277
+ "id": { "type": "string" },
278
+ "kind": { "type": "string" },
279
+ "target": { "type": ["string", "null"] },
280
+ "description": { "type": "string" },
281
+ "payload": { "type": "object", "additionalProperties": true }
282
+ },
283
+ "additionalProperties": false
284
+ },
285
+ "repairPlanEvidence": {
286
+ "type": "object",
287
+ "required": ["id", "text"],
288
+ "properties": {
289
+ "id": { "type": "string" },
290
+ "text": { "type": "string" }
291
+ },
292
+ "additionalProperties": false
195
293
  }
196
294
  }
197
295
  }
@@ -12,6 +12,7 @@
12
12
  "summary",
13
13
  "routes",
14
14
  "packs",
15
+ "graph",
15
16
  "ci",
16
17
  "findings"
17
18
  ],
@@ -167,6 +168,48 @@
167
168
  },
168
169
  "additionalProperties": false
169
170
  },
171
+ "graph": {
172
+ "type": "object",
173
+ "required": [
174
+ "present",
175
+ "ready",
176
+ "current",
177
+ "snapshotPresent",
178
+ "manifestPresent",
179
+ "diffPresent",
180
+ "capsulePresent",
181
+ "snapshotId",
182
+ "sourceHash",
183
+ "contractHash",
184
+ "contractCacheKey",
185
+ "sourceArtifactCount",
186
+ "capsuleSourceArtifactLimit",
187
+ "capsuleSourceArtifactsTruncated",
188
+ "staleArtifacts",
189
+ "error"
190
+ ],
191
+ "properties": {
192
+ "present": { "type": "boolean" },
193
+ "ready": { "type": "boolean" },
194
+ "current": { "type": ["boolean", "null"] },
195
+ "snapshotPresent": { "type": "boolean" },
196
+ "manifestPresent": { "type": "boolean" },
197
+ "diffPresent": { "type": "boolean" },
198
+ "capsulePresent": { "type": "boolean" },
199
+ "snapshotId": { "type": ["string", "null"] },
200
+ "sourceHash": { "type": ["string", "null"] },
201
+ "contractHash": { "type": ["string", "null"] },
202
+ "contractCacheKey": { "type": ["string", "null"] },
203
+ "sourceArtifactCount": { "type": "integer", "minimum": 0 },
204
+ "capsuleSourceArtifactLimit": { "type": ["integer", "null"], "minimum": 0 },
205
+ "capsuleSourceArtifactsTruncated": { "type": ["boolean", "null"] },
206
+ "staleArtifacts": {
207
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/stringArray"
208
+ },
209
+ "error": { "type": ["string", "null"] }
210
+ },
211
+ "additionalProperties": false
212
+ },
170
213
  "ci": {
171
214
  "type": "object",
172
215
  "required": ["recommendedCommand", "failOn"],
@@ -205,6 +248,9 @@
205
248
  "id": {
206
249
  "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
207
250
  },
251
+ "code": {
252
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
253
+ },
208
254
  "source": {
209
255
  "type": "string",
210
256
  "enum": [
@@ -214,6 +260,8 @@
214
260
  "check",
215
261
  "brownfield",
216
262
  "design-token",
263
+ "style-bridge",
264
+ "graph",
217
265
  "runtime",
218
266
  "pack",
219
267
  "interaction"
@@ -244,6 +292,13 @@
244
292
  "suggestedFix": {
245
293
  "type": "string"
246
294
  },
295
+ "graph": {
296
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/graphAnchor"
297
+ },
298
+ "repair": {
299
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/repairAction"
300
+ },
301
+ "repairPlan": { "$ref": "#/$defs/repairPlan" },
247
302
  "remediation": {
248
303
  "type": "object",
249
304
  "required": ["summary", "prompt", "commands"],
@@ -262,6 +317,80 @@
262
317
  }
263
318
  },
264
319
  "additionalProperties": false
320
+ },
321
+ "repairPlan": {
322
+ "type": "object",
323
+ "required": [
324
+ "id",
325
+ "findingId",
326
+ "severity",
327
+ "source",
328
+ "category",
329
+ "actions",
330
+ "evidence",
331
+ "readTargets",
332
+ "preserve",
333
+ "avoid",
334
+ "commands"
335
+ ],
336
+ "properties": {
337
+ "id": { "type": "string" },
338
+ "findingId": { "type": "string" },
339
+ "diagnosticCode": { "type": ["string", "null"] },
340
+ "repairId": { "type": ["string", "null"] },
341
+ "severity": { "type": "string", "enum": ["error", "warn", "info"] },
342
+ "source": {
343
+ "type": "string",
344
+ "enum": [
345
+ "audit",
346
+ "assertion",
347
+ "browser",
348
+ "check",
349
+ "brownfield",
350
+ "design-token",
351
+ "style-bridge",
352
+ "graph",
353
+ "runtime",
354
+ "pack",
355
+ "interaction"
356
+ ]
357
+ },
358
+ "category": { "type": "string" },
359
+ "graphAnchor": {
360
+ "anyOf": [
361
+ { "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/graphAnchor" },
362
+ { "type": "null" }
363
+ ]
364
+ },
365
+ "actions": { "type": "array", "items": { "$ref": "#/$defs/repairPlanAction" } },
366
+ "evidence": { "type": "array", "items": { "$ref": "#/$defs/repairPlanEvidence" } },
367
+ "readTargets": { "type": "array", "items": { "type": "string" } },
368
+ "preserve": { "type": "array", "items": { "type": "string" } },
369
+ "avoid": { "type": "array", "items": { "type": "string" } },
370
+ "commands": { "type": "array", "items": { "type": "string" } }
371
+ },
372
+ "additionalProperties": false
373
+ },
374
+ "repairPlanAction": {
375
+ "type": "object",
376
+ "required": ["id", "kind", "description"],
377
+ "properties": {
378
+ "id": { "type": "string" },
379
+ "kind": { "type": "string" },
380
+ "target": { "type": ["string", "null"] },
381
+ "description": { "type": "string" },
382
+ "payload": { "type": "object", "additionalProperties": true }
383
+ },
384
+ "additionalProperties": false
385
+ },
386
+ "repairPlanEvidence": {
387
+ "type": "object",
388
+ "required": ["id", "text"],
389
+ "properties": {
390
+ "id": { "type": "string" },
391
+ "text": { "type": "string" }
392
+ },
393
+ "additionalProperties": false
265
394
  }
266
395
  }
267
396
  }
@@ -200,6 +200,9 @@
200
200
  },
201
201
  "additionalProperties": false
202
202
  },
203
+ "graphPreview": {
204
+ "$ref": "#/$defs/graphPreview"
205
+ },
203
206
  "pagesProbe": {
204
207
  "anyOf": [
205
208
  { "$ref": "#/$defs/publishedSiteProbe" },
@@ -339,6 +342,125 @@
339
342
  },
340
343
  "additionalProperties": false
341
344
  },
345
+ "graphPreview": {
346
+ "type": "object",
347
+ "required": [
348
+ "status",
349
+ "canPreview",
350
+ "readOnly",
351
+ "message",
352
+ "nextCommand",
353
+ "staleArtifacts",
354
+ "snapshot",
355
+ "capsule",
356
+ "diff"
357
+ ],
358
+ "properties": {
359
+ "status": {
360
+ "type": "string",
361
+ "enum": ["not_attached", "current", "stale", "needs_migration", "unavailable"]
362
+ },
363
+ "canPreview": { "type": "boolean" },
364
+ "readOnly": { "const": true },
365
+ "message": {
366
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
367
+ },
368
+ "nextCommand": { "type": ["string", "null"] },
369
+ "staleArtifacts": {
370
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/stringArray"
371
+ },
372
+ "snapshot": {
373
+ "anyOf": [
374
+ { "$ref": "#/$defs/graphPreviewSnapshot" },
375
+ { "type": "null" }
376
+ ]
377
+ },
378
+ "capsule": {
379
+ "anyOf": [
380
+ { "$ref": "#/$defs/graphPreviewCapsule" },
381
+ { "type": "null" }
382
+ ]
383
+ },
384
+ "diff": {
385
+ "anyOf": [
386
+ { "$ref": "#/$defs/graphPreviewDiff" },
387
+ { "type": "null" }
388
+ ]
389
+ }
390
+ },
391
+ "additionalProperties": false
392
+ },
393
+ "graphPreviewSnapshot": {
394
+ "type": "object",
395
+ "required": [
396
+ "id",
397
+ "schemaVersion",
398
+ "sourceHash",
399
+ "nodes",
400
+ "edges",
401
+ "findings",
402
+ "evidence",
403
+ "sourceArtifacts"
404
+ ],
405
+ "properties": {
406
+ "id": {
407
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
408
+ },
409
+ "schemaVersion": {
410
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
411
+ },
412
+ "sourceHash": {
413
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
414
+ },
415
+ "nodes": { "type": "integer", "minimum": 0 },
416
+ "edges": { "type": "integer", "minimum": 0 },
417
+ "findings": { "type": "integer", "minimum": 0 },
418
+ "evidence": { "type": "integer", "minimum": 0 },
419
+ "sourceArtifacts": { "type": "integer", "minimum": 0 }
420
+ },
421
+ "additionalProperties": false
422
+ },
423
+ "graphPreviewDiff": {
424
+ "type": "object",
425
+ "required": ["ops", "findingsAdded", "findingsResolved", "evidenceAdded"],
426
+ "properties": {
427
+ "ops": { "type": "integer", "minimum": 0 },
428
+ "findingsAdded": { "type": "integer", "minimum": 0 },
429
+ "findingsResolved": { "type": "integer", "minimum": 0 },
430
+ "evidenceAdded": { "type": "integer", "minimum": 0 }
431
+ },
432
+ "additionalProperties": false
433
+ },
434
+ "graphPreviewCapsule": {
435
+ "type": "object",
436
+ "required": [
437
+ "cacheKey",
438
+ "routes",
439
+ "components",
440
+ "tokens",
441
+ "localRules",
442
+ "styleBridge",
443
+ "sourceArtifacts",
444
+ "sourceArtifactLimit",
445
+ "sourceArtifactsTruncated",
446
+ "openFindings"
447
+ ],
448
+ "properties": {
449
+ "cacheKey": {
450
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
451
+ },
452
+ "routes": { "type": "integer", "minimum": 0 },
453
+ "components": { "type": "integer", "minimum": 0 },
454
+ "tokens": { "type": "integer", "minimum": 0 },
455
+ "localRules": { "type": "integer", "minimum": 0 },
456
+ "styleBridge": { "type": "integer", "minimum": 0 },
457
+ "sourceArtifacts": { "type": "integer", "minimum": 0 },
458
+ "sourceArtifactLimit": { "type": "integer", "minimum": 0 },
459
+ "sourceArtifactsTruncated": { "type": "boolean" },
460
+ "openFindings": { "type": "integer", "minimum": 0 }
461
+ },
462
+ "additionalProperties": false
463
+ },
342
464
  "finding": {
343
465
  "type": "object",
344
466
  "required": ["id", "severity", "title", "message", "evidence"],
@@ -13,6 +13,56 @@
13
13
  "type": "string"
14
14
  }
15
15
  },
16
+ "graphAnchor": {
17
+ "type": "object",
18
+ "required": [
19
+ "snapshot_id",
20
+ "source_hash",
21
+ "node_id",
22
+ "node_type",
23
+ "confidence",
24
+ "reason"
25
+ ],
26
+ "properties": {
27
+ "snapshot_id": {
28
+ "$ref": "#/$defs/nonEmptyString"
29
+ },
30
+ "source_hash": {
31
+ "$ref": "#/$defs/nonEmptyString"
32
+ },
33
+ "node_id": {
34
+ "$ref": "#/$defs/nonEmptyString"
35
+ },
36
+ "node_type": {
37
+ "$ref": "#/$defs/nonEmptyString"
38
+ },
39
+ "route": {
40
+ "type": "string"
41
+ },
42
+ "confidence": {
43
+ "type": "string",
44
+ "enum": ["exact", "inferred", "fallback"]
45
+ },
46
+ "reason": {
47
+ "$ref": "#/$defs/nonEmptyString"
48
+ }
49
+ },
50
+ "additionalProperties": false
51
+ },
52
+ "repairAction": {
53
+ "type": "object",
54
+ "required": ["id"],
55
+ "properties": {
56
+ "id": {
57
+ "$ref": "#/$defs/nonEmptyString"
58
+ },
59
+ "payload": {
60
+ "type": "object",
61
+ "additionalProperties": true
62
+ }
63
+ },
64
+ "additionalProperties": false
65
+ },
16
66
  "verificationFinding": {
17
67
  "type": "object",
18
68
  "required": ["id", "category", "severity", "message", "evidence"],
@@ -20,6 +70,9 @@
20
70
  "id": {
21
71
  "$ref": "#/$defs/nonEmptyString"
22
72
  },
73
+ "code": {
74
+ "$ref": "#/$defs/nonEmptyString"
75
+ },
23
76
  "category": {
24
77
  "$ref": "#/$defs/nonEmptyString"
25
78
  },
@@ -44,6 +97,12 @@
44
97
  },
45
98
  "suggestedFix": {
46
99
  "type": "string"
100
+ },
101
+ "graph": {
102
+ "$ref": "#/$defs/graphAnchor"
103
+ },
104
+ "repair": {
105
+ "$ref": "#/$defs/repairAction"
47
106
  }
48
107
  },
49
108
  "additionalProperties": false