@unrdf/kgc-runtime 26.4.2

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 (70) hide show
  1. package/IMPLEMENTATION_SUMMARY.json +150 -0
  2. package/PLUGIN_SYSTEM_SUMMARY.json +149 -0
  3. package/README.md +98 -0
  4. package/TRANSACTION_IMPLEMENTATION.json +119 -0
  5. package/capability-map.md +93 -0
  6. package/docs/api-stability.md +269 -0
  7. package/docs/extensions/plugin-development.md +382 -0
  8. package/package.json +40 -0
  9. package/plugins/registry.json +35 -0
  10. package/src/admission-gate.mjs +414 -0
  11. package/src/api-version.mjs +373 -0
  12. package/src/atomic-admission.mjs +310 -0
  13. package/src/bounds.mjs +289 -0
  14. package/src/bulkhead-manager.mjs +280 -0
  15. package/src/capsule.mjs +524 -0
  16. package/src/crdt.mjs +361 -0
  17. package/src/enhanced-bounds.mjs +614 -0
  18. package/src/executor.mjs +73 -0
  19. package/src/freeze-restore.mjs +521 -0
  20. package/src/index.mjs +62 -0
  21. package/src/materialized-views.mjs +371 -0
  22. package/src/merge.mjs +472 -0
  23. package/src/plugin-isolation.mjs +392 -0
  24. package/src/plugin-manager.mjs +441 -0
  25. package/src/projections-api.mjs +336 -0
  26. package/src/projections-cli.mjs +238 -0
  27. package/src/projections-docs.mjs +300 -0
  28. package/src/projections-ide.mjs +278 -0
  29. package/src/receipt.mjs +340 -0
  30. package/src/rollback.mjs +258 -0
  31. package/src/saga-orchestrator.mjs +355 -0
  32. package/src/schemas.mjs +1330 -0
  33. package/src/storage-optimization.mjs +359 -0
  34. package/src/tool-registry.mjs +272 -0
  35. package/src/transaction.mjs +466 -0
  36. package/src/validators.mjs +485 -0
  37. package/src/work-item.mjs +449 -0
  38. package/templates/plugin-template/README.md +58 -0
  39. package/templates/plugin-template/index.mjs +162 -0
  40. package/templates/plugin-template/plugin.json +19 -0
  41. package/test/admission-gate.test.mjs +583 -0
  42. package/test/api-version.test.mjs +74 -0
  43. package/test/atomic-admission.test.mjs +155 -0
  44. package/test/bounds.test.mjs +341 -0
  45. package/test/bulkhead-manager.test.mjs +236 -0
  46. package/test/capsule.test.mjs +625 -0
  47. package/test/crdt.test.mjs +215 -0
  48. package/test/enhanced-bounds.test.mjs +487 -0
  49. package/test/freeze-restore.test.mjs +472 -0
  50. package/test/materialized-views.test.mjs +243 -0
  51. package/test/merge.test.mjs +665 -0
  52. package/test/plugin-isolation.test.mjs +109 -0
  53. package/test/plugin-manager.test.mjs +208 -0
  54. package/test/projections-api.test.mjs +293 -0
  55. package/test/projections-cli.test.mjs +204 -0
  56. package/test/projections-docs.test.mjs +173 -0
  57. package/test/projections-ide.test.mjs +230 -0
  58. package/test/receipt.test.mjs +295 -0
  59. package/test/rollback.test.mjs +132 -0
  60. package/test/saga-orchestrator.test.mjs +279 -0
  61. package/test/schemas.test.mjs +716 -0
  62. package/test/storage-optimization.test.mjs +503 -0
  63. package/test/tool-registry.test.mjs +341 -0
  64. package/test/transaction.test.mjs +189 -0
  65. package/test/validators.test.mjs +463 -0
  66. package/test/work-item.test.mjs +548 -0
  67. package/test/work-item.test.mjs.bak +548 -0
  68. package/var/kgc/test-atomic-log.json +519 -0
  69. package/var/kgc/test-cascading-log.json +145 -0
  70. package/vitest.config.mjs +18 -0
@@ -0,0 +1,519 @@
1
+ [
2
+ {
3
+ "transaction_id": "tx_1766831572937_aivd6s",
4
+ "operations": [
5
+ {
6
+ "id": "undo_admit_c1",
7
+ "type": "remove_capsule",
8
+ "data": {
9
+ "capsule_id": "c1"
10
+ }
11
+ },
12
+ {
13
+ "id": "undo_admit_c2",
14
+ "type": "remove_capsule",
15
+ "data": {
16
+ "capsule_id": "c2"
17
+ }
18
+ },
19
+ {
20
+ "id": "undo_admit_c3",
21
+ "type": "remove_capsule",
22
+ "data": {
23
+ "capsule_id": "c3"
24
+ }
25
+ }
26
+ ],
27
+ "timestamp": "2025-12-27T10:32:52.948Z"
28
+ },
29
+ {
30
+ "transaction_id": "tx_1766831572987_r9lmo",
31
+ "operations": [
32
+ {
33
+ "id": "undo_admit_c1",
34
+ "type": "remove_capsule",
35
+ "data": {
36
+ "capsule_id": "c1"
37
+ }
38
+ },
39
+ {
40
+ "id": "undo_admit_c2",
41
+ "type": "remove_capsule",
42
+ "data": {
43
+ "capsule_id": "c2"
44
+ }
45
+ }
46
+ ],
47
+ "timestamp": "2025-12-27T10:32:52.991Z"
48
+ },
49
+ {
50
+ "transaction_id": "tx_1766831630568_tgpofp",
51
+ "operations": [
52
+ {
53
+ "id": "undo_admit_c1",
54
+ "type": "remove_capsule",
55
+ "data": {
56
+ "capsule_id": "c1"
57
+ }
58
+ },
59
+ {
60
+ "id": "undo_admit_c2",
61
+ "type": "remove_capsule",
62
+ "data": {
63
+ "capsule_id": "c2"
64
+ }
65
+ },
66
+ {
67
+ "id": "undo_admit_c3",
68
+ "type": "remove_capsule",
69
+ "data": {
70
+ "capsule_id": "c3"
71
+ }
72
+ }
73
+ ],
74
+ "timestamp": "2025-12-27T10:33:50.592Z"
75
+ },
76
+ {
77
+ "transaction_id": "tx_1766831630613_momjdr",
78
+ "operations": [
79
+ {
80
+ "id": "undo_admit_c1",
81
+ "type": "remove_capsule",
82
+ "data": {
83
+ "capsule_id": "c1"
84
+ }
85
+ },
86
+ {
87
+ "id": "undo_admit_c2",
88
+ "type": "remove_capsule",
89
+ "data": {
90
+ "capsule_id": "c2"
91
+ }
92
+ }
93
+ ],
94
+ "timestamp": "2025-12-27T10:33:50.616Z"
95
+ },
96
+ {
97
+ "transaction_id": "tx_1766831642751_dr4eb",
98
+ "operations": [
99
+ {
100
+ "id": "undo_admit_c1",
101
+ "type": "remove_capsule",
102
+ "data": {
103
+ "capsule_id": "c1"
104
+ }
105
+ },
106
+ {
107
+ "id": "undo_admit_c2",
108
+ "type": "remove_capsule",
109
+ "data": {
110
+ "capsule_id": "c2"
111
+ }
112
+ },
113
+ {
114
+ "id": "undo_admit_c3",
115
+ "type": "remove_capsule",
116
+ "data": {
117
+ "capsule_id": "c3"
118
+ }
119
+ }
120
+ ],
121
+ "timestamp": "2025-12-27T10:34:02.767Z"
122
+ },
123
+ {
124
+ "transaction_id": "tx_1766831642788_0gst9k",
125
+ "operations": [
126
+ {
127
+ "id": "undo_admit_c1",
128
+ "type": "remove_capsule",
129
+ "data": {
130
+ "capsule_id": "c1"
131
+ }
132
+ },
133
+ {
134
+ "id": "undo_admit_c2",
135
+ "type": "remove_capsule",
136
+ "data": {
137
+ "capsule_id": "c2"
138
+ }
139
+ }
140
+ ],
141
+ "timestamp": "2025-12-27T10:34:02.790Z"
142
+ },
143
+ {
144
+ "transaction_id": "tx_1766831663850_i63vll",
145
+ "operations": [
146
+ {
147
+ "id": "undo_admit_c1",
148
+ "type": "remove_capsule",
149
+ "data": {
150
+ "capsule_id": "c1"
151
+ }
152
+ },
153
+ {
154
+ "id": "undo_admit_c2",
155
+ "type": "remove_capsule",
156
+ "data": {
157
+ "capsule_id": "c2"
158
+ }
159
+ },
160
+ {
161
+ "id": "undo_admit_c3",
162
+ "type": "remove_capsule",
163
+ "data": {
164
+ "capsule_id": "c3"
165
+ }
166
+ }
167
+ ],
168
+ "timestamp": "2025-12-27T10:34:23.870Z"
169
+ },
170
+ {
171
+ "transaction_id": "tx_1766831663895_znigkj",
172
+ "operations": [
173
+ {
174
+ "id": "undo_admit_c1",
175
+ "type": "remove_capsule",
176
+ "data": {
177
+ "capsule_id": "c1"
178
+ }
179
+ },
180
+ {
181
+ "id": "undo_admit_c2",
182
+ "type": "remove_capsule",
183
+ "data": {
184
+ "capsule_id": "c2"
185
+ }
186
+ }
187
+ ],
188
+ "timestamp": "2025-12-27T10:34:23.898Z"
189
+ },
190
+ {
191
+ "transaction_id": "tx_1766831728436_nfqemp",
192
+ "operations": [
193
+ {
194
+ "id": "undo_admit_c1",
195
+ "type": "remove_capsule",
196
+ "data": {
197
+ "capsule_id": "c1"
198
+ }
199
+ },
200
+ {
201
+ "id": "undo_admit_c2",
202
+ "type": "remove_capsule",
203
+ "data": {
204
+ "capsule_id": "c2"
205
+ }
206
+ },
207
+ {
208
+ "id": "undo_admit_c3",
209
+ "type": "remove_capsule",
210
+ "data": {
211
+ "capsule_id": "c3"
212
+ }
213
+ }
214
+ ],
215
+ "timestamp": "2025-12-27T10:35:28.472Z"
216
+ },
217
+ {
218
+ "transaction_id": "tx_1766831728496_ty0o9w",
219
+ "operations": [
220
+ {
221
+ "id": "undo_admit_c1",
222
+ "type": "remove_capsule",
223
+ "data": {
224
+ "capsule_id": "c1"
225
+ }
226
+ },
227
+ {
228
+ "id": "undo_admit_c2",
229
+ "type": "remove_capsule",
230
+ "data": {
231
+ "capsule_id": "c2"
232
+ }
233
+ }
234
+ ],
235
+ "timestamp": "2025-12-27T10:35:28.499Z"
236
+ },
237
+ {
238
+ "transaction_id": "tx_1766831807866_ekd7od",
239
+ "operations": [
240
+ {
241
+ "id": "undo_admit_c1",
242
+ "type": "remove_capsule",
243
+ "data": {
244
+ "capsule_id": "c1"
245
+ }
246
+ },
247
+ {
248
+ "id": "undo_admit_c2",
249
+ "type": "remove_capsule",
250
+ "data": {
251
+ "capsule_id": "c2"
252
+ }
253
+ },
254
+ {
255
+ "id": "undo_admit_c3",
256
+ "type": "remove_capsule",
257
+ "data": {
258
+ "capsule_id": "c3"
259
+ }
260
+ }
261
+ ],
262
+ "timestamp": "2025-12-27T10:36:47.887Z"
263
+ },
264
+ {
265
+ "transaction_id": "tx_1766831807908_tn2re",
266
+ "operations": [
267
+ {
268
+ "id": "undo_admit_c1",
269
+ "type": "remove_capsule",
270
+ "data": {
271
+ "capsule_id": "c1"
272
+ }
273
+ },
274
+ {
275
+ "id": "undo_admit_c2",
276
+ "type": "remove_capsule",
277
+ "data": {
278
+ "capsule_id": "c2"
279
+ }
280
+ }
281
+ ],
282
+ "timestamp": "2025-12-27T10:36:47.912Z"
283
+ },
284
+ {
285
+ "transaction_id": "tx_1766831868361_k4e7kb",
286
+ "operations": [
287
+ {
288
+ "id": "undo_admit_c1",
289
+ "type": "remove_capsule",
290
+ "data": {
291
+ "capsule_id": "c1"
292
+ }
293
+ },
294
+ {
295
+ "id": "undo_admit_c2",
296
+ "type": "remove_capsule",
297
+ "data": {
298
+ "capsule_id": "c2"
299
+ }
300
+ },
301
+ {
302
+ "id": "undo_admit_c3",
303
+ "type": "remove_capsule",
304
+ "data": {
305
+ "capsule_id": "c3"
306
+ }
307
+ }
308
+ ],
309
+ "timestamp": "2025-12-27T10:37:48.374Z"
310
+ },
311
+ {
312
+ "transaction_id": "tx_1766831868395_s727z5",
313
+ "operations": [
314
+ {
315
+ "id": "undo_admit_c1",
316
+ "type": "remove_capsule",
317
+ "data": {
318
+ "capsule_id": "c1"
319
+ }
320
+ },
321
+ {
322
+ "id": "undo_admit_c2",
323
+ "type": "remove_capsule",
324
+ "data": {
325
+ "capsule_id": "c2"
326
+ }
327
+ }
328
+ ],
329
+ "timestamp": "2025-12-27T10:37:48.399Z"
330
+ },
331
+ {
332
+ "transaction_id": "tx_1766831945710_iy2hw",
333
+ "operations": [
334
+ {
335
+ "id": "undo_admit_c1",
336
+ "type": "remove_capsule",
337
+ "data": {
338
+ "capsule_id": "c1"
339
+ }
340
+ },
341
+ {
342
+ "id": "undo_admit_c2",
343
+ "type": "remove_capsule",
344
+ "data": {
345
+ "capsule_id": "c2"
346
+ }
347
+ },
348
+ {
349
+ "id": "undo_admit_c3",
350
+ "type": "remove_capsule",
351
+ "data": {
352
+ "capsule_id": "c3"
353
+ }
354
+ }
355
+ ],
356
+ "timestamp": "2025-12-27T10:39:05.723Z"
357
+ },
358
+ {
359
+ "transaction_id": "tx_1766831945744_nvwdfa",
360
+ "operations": [
361
+ {
362
+ "id": "undo_admit_c1",
363
+ "type": "remove_capsule",
364
+ "data": {
365
+ "capsule_id": "c1"
366
+ }
367
+ },
368
+ {
369
+ "id": "undo_admit_c2",
370
+ "type": "remove_capsule",
371
+ "data": {
372
+ "capsule_id": "c2"
373
+ }
374
+ }
375
+ ],
376
+ "timestamp": "2025-12-27T10:39:05.746Z"
377
+ },
378
+ {
379
+ "transaction_id": "tx_1766831965638_8bdw1",
380
+ "operations": [
381
+ {
382
+ "id": "undo_admit_c1",
383
+ "type": "remove_capsule",
384
+ "data": {
385
+ "capsule_id": "c1"
386
+ }
387
+ },
388
+ {
389
+ "id": "undo_admit_c2",
390
+ "type": "remove_capsule",
391
+ "data": {
392
+ "capsule_id": "c2"
393
+ }
394
+ },
395
+ {
396
+ "id": "undo_admit_c3",
397
+ "type": "remove_capsule",
398
+ "data": {
399
+ "capsule_id": "c3"
400
+ }
401
+ }
402
+ ],
403
+ "timestamp": "2025-12-27T10:39:25.662Z"
404
+ },
405
+ {
406
+ "transaction_id": "tx_1766831965688_937op",
407
+ "operations": [
408
+ {
409
+ "id": "undo_admit_c1",
410
+ "type": "remove_capsule",
411
+ "data": {
412
+ "capsule_id": "c1"
413
+ }
414
+ },
415
+ {
416
+ "id": "undo_admit_c2",
417
+ "type": "remove_capsule",
418
+ "data": {
419
+ "capsule_id": "c2"
420
+ }
421
+ }
422
+ ],
423
+ "timestamp": "2025-12-27T10:39:25.692Z"
424
+ },
425
+ {
426
+ "transaction_id": "tx_1766832031102_wcdwe4",
427
+ "operations": [
428
+ {
429
+ "id": "undo_admit_c1",
430
+ "type": "remove_capsule",
431
+ "data": {
432
+ "capsule_id": "c1"
433
+ }
434
+ },
435
+ {
436
+ "id": "undo_admit_c2",
437
+ "type": "remove_capsule",
438
+ "data": {
439
+ "capsule_id": "c2"
440
+ }
441
+ },
442
+ {
443
+ "id": "undo_admit_c3",
444
+ "type": "remove_capsule",
445
+ "data": {
446
+ "capsule_id": "c3"
447
+ }
448
+ }
449
+ ],
450
+ "timestamp": "2025-12-27T10:40:31.114Z"
451
+ },
452
+ {
453
+ "transaction_id": "tx_1766832031139_15pj8p",
454
+ "operations": [
455
+ {
456
+ "id": "undo_admit_c1",
457
+ "type": "remove_capsule",
458
+ "data": {
459
+ "capsule_id": "c1"
460
+ }
461
+ },
462
+ {
463
+ "id": "undo_admit_c2",
464
+ "type": "remove_capsule",
465
+ "data": {
466
+ "capsule_id": "c2"
467
+ }
468
+ }
469
+ ],
470
+ "timestamp": "2025-12-27T10:40:31.143Z"
471
+ },
472
+ {
473
+ "transaction_id": "tx_1766832415693_9ww4nq",
474
+ "operations": [
475
+ {
476
+ "id": "undo_admit_c1",
477
+ "type": "remove_capsule",
478
+ "data": {
479
+ "capsule_id": "c1"
480
+ }
481
+ },
482
+ {
483
+ "id": "undo_admit_c2",
484
+ "type": "remove_capsule",
485
+ "data": {
486
+ "capsule_id": "c2"
487
+ }
488
+ },
489
+ {
490
+ "id": "undo_admit_c3",
491
+ "type": "remove_capsule",
492
+ "data": {
493
+ "capsule_id": "c3"
494
+ }
495
+ }
496
+ ],
497
+ "timestamp": "2025-12-27T10:46:55.705Z"
498
+ },
499
+ {
500
+ "transaction_id": "tx_1766832415725_p3xcee",
501
+ "operations": [
502
+ {
503
+ "id": "undo_admit_c1",
504
+ "type": "remove_capsule",
505
+ "data": {
506
+ "capsule_id": "c1"
507
+ }
508
+ },
509
+ {
510
+ "id": "undo_admit_c2",
511
+ "type": "remove_capsule",
512
+ "data": {
513
+ "capsule_id": "c2"
514
+ }
515
+ }
516
+ ],
517
+ "timestamp": "2025-12-27T10:46:55.727Z"
518
+ }
519
+ ]
@@ -0,0 +1,145 @@
1
+ [
2
+ {
3
+ "transaction_id": "tx_1766831572995_o8r3l",
4
+ "operations": [
5
+ {
6
+ "id": "undo_admit_c1",
7
+ "type": "remove_capsule",
8
+ "data": {
9
+ "capsule_id": "c1"
10
+ }
11
+ }
12
+ ],
13
+ "timestamp": "2025-12-27T10:32:52.997Z"
14
+ },
15
+ {
16
+ "transaction_id": "tx_1766831630620_2xk58i",
17
+ "operations": [
18
+ {
19
+ "id": "undo_admit_c1",
20
+ "type": "remove_capsule",
21
+ "data": {
22
+ "capsule_id": "c1"
23
+ }
24
+ }
25
+ ],
26
+ "timestamp": "2025-12-27T10:33:50.628Z"
27
+ },
28
+ {
29
+ "transaction_id": "tx_1766831642793_1rbgwr",
30
+ "operations": [
31
+ {
32
+ "id": "undo_admit_c1",
33
+ "type": "remove_capsule",
34
+ "data": {
35
+ "capsule_id": "c1"
36
+ }
37
+ }
38
+ ],
39
+ "timestamp": "2025-12-27T10:34:02.795Z"
40
+ },
41
+ {
42
+ "transaction_id": "tx_1766831663902_j4477k",
43
+ "operations": [
44
+ {
45
+ "id": "undo_admit_c1",
46
+ "type": "remove_capsule",
47
+ "data": {
48
+ "capsule_id": "c1"
49
+ }
50
+ }
51
+ ],
52
+ "timestamp": "2025-12-27T10:34:23.911Z"
53
+ },
54
+ {
55
+ "transaction_id": "tx_1766831728502_3pdow",
56
+ "operations": [
57
+ {
58
+ "id": "undo_admit_c1",
59
+ "type": "remove_capsule",
60
+ "data": {
61
+ "capsule_id": "c1"
62
+ }
63
+ }
64
+ ],
65
+ "timestamp": "2025-12-27T10:35:28.505Z"
66
+ },
67
+ {
68
+ "transaction_id": "tx_1766831807915_n9mbn9",
69
+ "operations": [
70
+ {
71
+ "id": "undo_admit_c1",
72
+ "type": "remove_capsule",
73
+ "data": {
74
+ "capsule_id": "c1"
75
+ }
76
+ }
77
+ ],
78
+ "timestamp": "2025-12-27T10:36:47.926Z"
79
+ },
80
+ {
81
+ "transaction_id": "tx_1766831868403_slf2f5",
82
+ "operations": [
83
+ {
84
+ "id": "undo_admit_c1",
85
+ "type": "remove_capsule",
86
+ "data": {
87
+ "capsule_id": "c1"
88
+ }
89
+ }
90
+ ],
91
+ "timestamp": "2025-12-27T10:37:48.406Z"
92
+ },
93
+ {
94
+ "transaction_id": "tx_1766831945749_ocvri5k",
95
+ "operations": [
96
+ {
97
+ "id": "undo_admit_c1",
98
+ "type": "remove_capsule",
99
+ "data": {
100
+ "capsule_id": "c1"
101
+ }
102
+ }
103
+ ],
104
+ "timestamp": "2025-12-27T10:39:05.751Z"
105
+ },
106
+ {
107
+ "transaction_id": "tx_1766831965696_1bmgsn",
108
+ "operations": [
109
+ {
110
+ "id": "undo_admit_c1",
111
+ "type": "remove_capsule",
112
+ "data": {
113
+ "capsule_id": "c1"
114
+ }
115
+ }
116
+ ],
117
+ "timestamp": "2025-12-27T10:39:25.716Z"
118
+ },
119
+ {
120
+ "transaction_id": "tx_1766832031147_n0kpg9",
121
+ "operations": [
122
+ {
123
+ "id": "undo_admit_c1",
124
+ "type": "remove_capsule",
125
+ "data": {
126
+ "capsule_id": "c1"
127
+ }
128
+ }
129
+ ],
130
+ "timestamp": "2025-12-27T10:40:31.151Z"
131
+ },
132
+ {
133
+ "transaction_id": "tx_1766832415731_964ni",
134
+ "operations": [
135
+ {
136
+ "id": "undo_admit_c1",
137
+ "type": "remove_capsule",
138
+ "data": {
139
+ "capsule_id": "c1"
140
+ }
141
+ }
142
+ ],
143
+ "timestamp": "2025-12-27T10:46:55.735Z"
144
+ }
145
+ ]
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @file Vitest configuration for KGC Runtime
3
+ */
4
+
5
+ import { defineConfig } from 'vitest/config';
6
+
7
+ export default defineConfig({
8
+ test: {
9
+ globals: true,
10
+ environment: 'node',
11
+ coverage: {
12
+ provider: 'v8',
13
+ reporter: ['text', 'json', 'html'],
14
+ exclude: ['**/node_modules/**', '**/test/**'],
15
+ },
16
+ testTimeout: 5000,
17
+ },
18
+ });