kalup 0.1.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 (145) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +4 -0
  3. package/README.md +68 -0
  4. package/bin/kalup.mjs +13 -0
  5. package/dist/commands-C--Xsk1p.mjs +16145 -0
  6. package/dist/commands.d.mts +191 -0
  7. package/dist/commands.mjs +2 -0
  8. package/dist/context-D10Syqfd.d.mts +1265 -0
  9. package/dist/host-BJWvo3sX.mjs +390 -0
  10. package/dist/host.d.mts +44 -0
  11. package/dist/host.mjs +2 -0
  12. package/dist/index.d.mts +1 -0
  13. package/dist/index.mjs +14 -0
  14. package/dist/schemas/blueprint-1.schema.json +151 -0
  15. package/dist/schemas/blueprints-lock-1.schema.json +76 -0
  16. package/dist/schemas/ir-1.schema.json +379 -0
  17. package/dist/schemas/plan-1.schema.json +868 -0
  18. package/dist/schemas/state-1.schema.json +98 -0
  19. package/docs/apply.md +64 -0
  20. package/docs/blueprints.md +86 -0
  21. package/docs/compare.md +73 -0
  22. package/docs/config.md +88 -0
  23. package/docs/dictionary.md +43 -0
  24. package/docs/errors/E_ACCEPT_UNMATCHED.md +17 -0
  25. package/docs/errors/E_APPROVAL_REQUIRED.md +17 -0
  26. package/docs/errors/E_APPROVE_CREDENTIAL.md +17 -0
  27. package/docs/errors/E_APPROVE_MISMATCH.md +17 -0
  28. package/docs/errors/E_AUTH.md +17 -0
  29. package/docs/errors/E_BAD_CHAIN.md +21 -0
  30. package/docs/errors/E_BINDING_CHANGED.md +17 -0
  31. package/docs/errors/E_BIOME_CONFIG.md +17 -0
  32. package/docs/errors/E_BLUEPRINT_ADDED.md +17 -0
  33. package/docs/errors/E_BLUEPRINT_COLLISION.md +17 -0
  34. package/docs/errors/E_BLUEPRINT_INTEGRITY.md +17 -0
  35. package/docs/errors/E_BLUEPRINT_LOCK.md +17 -0
  36. package/docs/errors/E_BLUEPRINT_ORIGINAL.md +17 -0
  37. package/docs/errors/E_BLUEPRINT_REF.md +17 -0
  38. package/docs/errors/E_BLUEPRINT_REQUIRES.md +17 -0
  39. package/docs/errors/E_BLUEPRINT_SCHEMA.md +17 -0
  40. package/docs/errors/E_BLUEPRINT_SOURCE.md +17 -0
  41. package/docs/errors/E_BLUEPRINT_UNKNOWN.md +17 -0
  42. package/docs/errors/E_BUDGET.md +17 -0
  43. package/docs/errors/E_CANCELLED.md +21 -0
  44. package/docs/errors/E_CONFIG_EXISTS.md +17 -0
  45. package/docs/errors/E_DAILY_LIMIT.md +17 -0
  46. package/docs/errors/E_DEFAULT_TARGET.md +17 -0
  47. package/docs/errors/E_DUPLICATE_ADDRESS.md +17 -0
  48. package/docs/errors/E_DUPLICATE_ALIAS.md +24 -0
  49. package/docs/errors/E_DUPLICATE_KEY.md +24 -0
  50. package/docs/errors/E_DUPLICATE_OPTION.md +25 -0
  51. package/docs/errors/E_DUPLICATE_PORTAL.md +24 -0
  52. package/docs/errors/E_FIRST_PULL.md +18 -0
  53. package/docs/errors/E_HS_PREFIX.md +21 -0
  54. package/docs/errors/E_HTTP.md +17 -0
  55. package/docs/errors/E_INCOMPLETE.md +23 -0
  56. package/docs/errors/E_IR_SCHEMA.md +18 -0
  57. package/docs/errors/E_JOURNAL_WRITE.md +17 -0
  58. package/docs/errors/E_KEY_COLLISION.md +22 -0
  59. package/docs/errors/E_KEY_INVALID.md +19 -0
  60. package/docs/errors/E_LIFECYCLE.md +23 -0
  61. package/docs/errors/E_LOCKED.md +17 -0
  62. package/docs/errors/E_LOCK_DIR.md +17 -0
  63. package/docs/errors/E_MISSING_EXPORT.md +17 -0
  64. package/docs/errors/E_MISSING_KEY.md +17 -0
  65. package/docs/errors/E_NOT_DATA.md +21 -0
  66. package/docs/errors/E_NO_CONFIG.md +17 -0
  67. package/docs/errors/E_NO_TARGETS.md +17 -0
  68. package/docs/errors/E_OVERRIDE_AMBIGUOUS.md +21 -0
  69. package/docs/errors/E_OVERRIDE_DEFINITION.md +26 -0
  70. package/docs/errors/E_OVERRIDE_NAME.md +23 -0
  71. package/docs/errors/E_PLAN_DELETE.md +17 -0
  72. package/docs/errors/E_PLAN_DESTINATION.md +17 -0
  73. package/docs/errors/E_PLAN_DIGEST.md +17 -0
  74. package/docs/errors/E_PLAN_INVALID.md +17 -0
  75. package/docs/errors/E_PLAN_RISK.md +17 -0
  76. package/docs/errors/E_PLAN_SCHEMA.md +17 -0
  77. package/docs/errors/E_PLAN_STALE.md +17 -0
  78. package/docs/errors/E_PLAN_VERSION.md +18 -0
  79. package/docs/errors/E_POLICY_CHANGED.md +17 -0
  80. package/docs/errors/E_PORTAL_ID.md +17 -0
  81. package/docs/errors/E_PREVENT_DESTROY.md +17 -0
  82. package/docs/errors/E_PROJECT_WRITE.md +17 -0
  83. package/docs/errors/E_PROTECTED_SAVED_PLAN.md +17 -0
  84. package/docs/errors/E_PULL_INVALID.md +20 -0
  85. package/docs/errors/E_RATE_LIMIT.md +17 -0
  86. package/docs/errors/E_REBIND_STANDARD.md +17 -0
  87. package/docs/errors/E_REFERENCE_DEFINITION.md +21 -0
  88. package/docs/errors/E_RM_DEPENDENTS.md +17 -0
  89. package/docs/errors/E_SCOPE.md +17 -0
  90. package/docs/errors/E_SETTING_LEVEL.md +21 -0
  91. package/docs/errors/E_SETTING_VALUE.md +23 -0
  92. package/docs/errors/E_SNAPSHOT.md +17 -0
  93. package/docs/errors/E_STANDARD_OBJECT.md +21 -0
  94. package/docs/errors/E_STATE_CHANGED.md +19 -0
  95. package/docs/errors/E_STATE_CONFLICT.md +17 -0
  96. package/docs/errors/E_STATE_INVALID.md +17 -0
  97. package/docs/errors/E_STATE_SCHEMA.md +17 -0
  98. package/docs/errors/E_STATE_WRITE.md +19 -0
  99. package/docs/errors/E_STRICT_WITHOUT_OPTIONS.md +21 -0
  100. package/docs/errors/E_TAKE_UNMATCHED.md +19 -0
  101. package/docs/errors/E_TARGET_NAME.md +17 -0
  102. package/docs/errors/E_TARGET_PORTAL_MISMATCH.md +19 -0
  103. package/docs/errors/E_TARGET_REQUIRED.md +17 -0
  104. package/docs/errors/E_TOMBSTONE_ADDRESS.md +23 -0
  105. package/docs/errors/E_TOMBSTONE_CONFLICT.md +17 -0
  106. package/docs/errors/E_TYPE_FIELDTYPE.md +21 -0
  107. package/docs/errors/E_UNCERTAIN_WRITE.md +17 -0
  108. package/docs/errors/E_UNEXPECTED.md +17 -0
  109. package/docs/errors/E_UNKNOWN_BUILDER.md +21 -0
  110. package/docs/errors/E_UNKNOWN_GROUP.md +21 -0
  111. package/docs/errors/E_UNKNOWN_INCLUDE.md +17 -0
  112. package/docs/errors/E_UNKNOWN_OBJECT.md +17 -0
  113. package/docs/errors/E_UNKNOWN_OVERRIDE.md +17 -0
  114. package/docs/errors/E_UNKNOWN_TARGET.md +17 -0
  115. package/docs/errors/E_UNREACHABLE.md +17 -0
  116. package/docs/errors/E_UNSUPPORTED_FILE.md +17 -0
  117. package/docs/errors/E_USAGE.md +17 -0
  118. package/docs/errors/E_WRITE_IN_READ_MODE.md +17 -0
  119. package/docs/errors/E_WRITE_NOT_ALLOWED.md +17 -0
  120. package/docs/errors/W_BLUEPRINT_DOWNGRADE.md +17 -0
  121. package/docs/errors/W_CODEC_MISMATCH.md +18 -0
  122. package/docs/errors/W_INCOMPLETE.md +19 -0
  123. package/docs/errors/W_JSON_FIELDTYPE.md +17 -0
  124. package/docs/errors/W_KEY_COLLISION.md +17 -0
  125. package/docs/errors/W_LARGE_SCOPE.md +23 -0
  126. package/docs/errors/W_LIMIT_HEADROOM.md +19 -0
  127. package/docs/errors/W_LIMIT_UNREADABLE.md +17 -0
  128. package/docs/errors/W_MODE_SHADOWED.md +17 -0
  129. package/docs/errors/W_OVERRIDE_OPTION.md +17 -0
  130. package/docs/errors/W_PIN_EXPIRES.md +17 -0
  131. package/docs/errors/W_PREFIX.md +17 -0
  132. package/docs/errors/W_RATE_HEADERS.md +21 -0
  133. package/docs/errors/W_RATE_LIMIT.md +17 -0
  134. package/docs/errors/W_UNADDRESSABLE_NAME.md +21 -0
  135. package/docs/errors/W_UNFINISHED_APPLY.md +19 -0
  136. package/docs/errors/W_UNRESOLVED.md +17 -0
  137. package/docs/errors/W_UNSUPPORTED_TYPE.md +19 -0
  138. package/docs/errors/W_UNVERIFIED.md +17 -0
  139. package/docs/plan.md +85 -0
  140. package/docs/pull.md +83 -0
  141. package/docs/rm.md +44 -0
  142. package/docs/snapshot.md +52 -0
  143. package/docs/state.md +37 -0
  144. package/docs/targets.md +58 -0
  145. package/package.json +86 -0
@@ -0,0 +1,1265 @@
1
+ import "@kalup/core";
2
+ //#region ../engine/dist/index.d.mts
3
+ //#region src/issues.d.ts
4
+ declare const issues: {
5
+ E_ACCEPT_UNMATCHED: {
6
+ exit: string;
7
+ title: string;
8
+ summary: string;
9
+ when: string[];
10
+ fix: string[];
11
+ example: {
12
+ output: string[];
13
+ };
14
+ };
15
+ E_APPROVAL_REQUIRED: {
16
+ exit: string;
17
+ title: string;
18
+ summary: string;
19
+ when: string[];
20
+ fix: string[];
21
+ example: {
22
+ output: string[];
23
+ };
24
+ };
25
+ E_APPROVE_CREDENTIAL: {
26
+ exit: string;
27
+ title: string;
28
+ summary: string;
29
+ when: string[];
30
+ fix: string[];
31
+ example: {
32
+ output: string[];
33
+ };
34
+ };
35
+ E_APPROVE_MISMATCH: {
36
+ exit: string;
37
+ title: string;
38
+ summary: string;
39
+ when: string[];
40
+ fix: string[];
41
+ example: {
42
+ output: string[];
43
+ };
44
+ };
45
+ E_AUTH: {
46
+ exit: string;
47
+ title: string;
48
+ summary: string;
49
+ when: string[];
50
+ fix: string[];
51
+ example: {
52
+ output: string[];
53
+ };
54
+ };
55
+ E_BAD_CHAIN: {
56
+ exit: string;
57
+ title: string;
58
+ summary: string;
59
+ when: string[];
60
+ fix: string[];
61
+ example: {
62
+ config: string[];
63
+ output: string[];
64
+ };
65
+ };
66
+ E_BINDING_CHANGED: {
67
+ exit: string;
68
+ title: string;
69
+ summary: string;
70
+ when: string[];
71
+ fix: string[];
72
+ example: {
73
+ output: string[];
74
+ };
75
+ };
76
+ E_BIOME_CONFIG: {
77
+ exit: string;
78
+ title: string;
79
+ summary: string;
80
+ when: string[];
81
+ fix: string[];
82
+ example: {
83
+ output: string[];
84
+ };
85
+ };
86
+ E_BLUEPRINT_ADDED: {
87
+ exit: string;
88
+ title: string;
89
+ summary: string;
90
+ when: string[];
91
+ fix: string[];
92
+ example: {
93
+ output: string[];
94
+ };
95
+ };
96
+ E_BLUEPRINT_COLLISION: {
97
+ exit: string;
98
+ title: string;
99
+ summary: string;
100
+ when: string[];
101
+ fix: string[];
102
+ example: {
103
+ output: string[];
104
+ };
105
+ };
106
+ E_BLUEPRINT_INTEGRITY: {
107
+ exit: string;
108
+ title: string;
109
+ summary: string;
110
+ when: string[];
111
+ fix: string[];
112
+ example: {
113
+ output: string[];
114
+ };
115
+ };
116
+ E_BLUEPRINT_LOCK: {
117
+ exit: string;
118
+ title: string;
119
+ summary: string;
120
+ when: string[];
121
+ fix: string[];
122
+ example: {
123
+ output: string[];
124
+ };
125
+ };
126
+ E_BLUEPRINT_ORIGINAL: {
127
+ exit: string;
128
+ title: string;
129
+ summary: string;
130
+ when: string[];
131
+ fix: string[];
132
+ example: {
133
+ output: string[];
134
+ };
135
+ };
136
+ E_BLUEPRINT_REF: {
137
+ exit: string;
138
+ title: string;
139
+ summary: string;
140
+ when: string[];
141
+ fix: string[];
142
+ example: {
143
+ output: string[];
144
+ };
145
+ };
146
+ E_BLUEPRINT_REQUIRES: {
147
+ exit: string;
148
+ title: string;
149
+ summary: string;
150
+ when: string[];
151
+ fix: string[];
152
+ example: {
153
+ output: string[];
154
+ };
155
+ };
156
+ E_BLUEPRINT_SCHEMA: {
157
+ exit: string;
158
+ title: string;
159
+ summary: string;
160
+ when: string[];
161
+ fix: string[];
162
+ example: {
163
+ output: string[];
164
+ };
165
+ };
166
+ E_BLUEPRINT_SOURCE: {
167
+ exit: string;
168
+ title: string;
169
+ summary: string;
170
+ when: string[];
171
+ fix: string[];
172
+ example: {
173
+ output: string[];
174
+ };
175
+ };
176
+ E_BLUEPRINT_UNKNOWN: {
177
+ exit: string;
178
+ title: string;
179
+ summary: string;
180
+ when: string[];
181
+ fix: string[];
182
+ example: {
183
+ output: string[];
184
+ };
185
+ };
186
+ E_BUDGET: {
187
+ exit: string;
188
+ title: string;
189
+ summary: string;
190
+ when: string[];
191
+ fix: string[];
192
+ example: {
193
+ output: string[];
194
+ };
195
+ };
196
+ E_CANCELLED: {
197
+ exit: string;
198
+ title: string;
199
+ summary: string;
200
+ when: string[];
201
+ fix: string[];
202
+ example: {
203
+ output: string[];
204
+ };
205
+ };
206
+ E_CONFIG_EXISTS: {
207
+ exit: string;
208
+ title: string;
209
+ summary: string;
210
+ when: string[];
211
+ fix: string[];
212
+ example: {
213
+ output: string[];
214
+ };
215
+ };
216
+ E_DAILY_LIMIT: {
217
+ exit: string;
218
+ title: string;
219
+ summary: string;
220
+ when: string[];
221
+ fix: string[];
222
+ example: {
223
+ output: string[];
224
+ };
225
+ };
226
+ E_DEFAULT_TARGET: {
227
+ exit: string;
228
+ title: string;
229
+ summary: string;
230
+ when: string[];
231
+ fix: string[];
232
+ example: {
233
+ output: string[];
234
+ };
235
+ };
236
+ E_DUPLICATE_ADDRESS: {
237
+ exit: string;
238
+ title: string;
239
+ summary: string;
240
+ when: string[];
241
+ fix: string[];
242
+ example: {
243
+ output: string[];
244
+ };
245
+ };
246
+ E_DUPLICATE_ALIAS: {
247
+ exit: string;
248
+ title: string;
249
+ summary: string;
250
+ when: string[];
251
+ fix: string[];
252
+ example: {
253
+ config: string[];
254
+ output: string[];
255
+ };
256
+ };
257
+ E_DUPLICATE_KEY: {
258
+ exit: string;
259
+ title: string;
260
+ summary: string;
261
+ when: string[];
262
+ fix: string[];
263
+ example: {
264
+ config: string[];
265
+ output: string[];
266
+ };
267
+ };
268
+ E_DUPLICATE_OPTION: {
269
+ exit: string;
270
+ title: string;
271
+ summary: string;
272
+ when: string[];
273
+ fix: string[];
274
+ example: {
275
+ config: string[];
276
+ output: string[];
277
+ };
278
+ };
279
+ E_DUPLICATE_PORTAL: {
280
+ exit: string;
281
+ title: string;
282
+ summary: string;
283
+ when: string[];
284
+ fix: string[];
285
+ example: {
286
+ config: string[];
287
+ output: string[];
288
+ };
289
+ };
290
+ E_FIRST_PULL: {
291
+ exit: string;
292
+ title: string;
293
+ summary: string;
294
+ when: string[];
295
+ fix: string[];
296
+ example: {
297
+ output: string[];
298
+ };
299
+ };
300
+ E_HS_PREFIX: {
301
+ exit: string;
302
+ title: string;
303
+ summary: string;
304
+ when: string[];
305
+ fix: string[];
306
+ example: {
307
+ config: string[];
308
+ output: string[];
309
+ };
310
+ };
311
+ E_HTTP: {
312
+ exit: string;
313
+ title: string;
314
+ summary: string;
315
+ when: string[];
316
+ fix: string[];
317
+ example: {
318
+ output: string[];
319
+ };
320
+ };
321
+ E_INCOMPLETE: {
322
+ exit: string;
323
+ title: string;
324
+ summary: string;
325
+ when: string[];
326
+ fix: string[];
327
+ example: {
328
+ output: string[];
329
+ };
330
+ };
331
+ E_IR_SCHEMA: {
332
+ exit: string;
333
+ title: string;
334
+ summary: string;
335
+ when: string[];
336
+ fix: string[];
337
+ example: {
338
+ output: string[];
339
+ };
340
+ };
341
+ E_JOURNAL_WRITE: {
342
+ exit: string;
343
+ title: string;
344
+ summary: string;
345
+ when: string[];
346
+ fix: string[];
347
+ example: {
348
+ output: string[];
349
+ };
350
+ };
351
+ E_KEY_COLLISION: {
352
+ exit: string;
353
+ title: string;
354
+ summary: string;
355
+ when: string[];
356
+ fix: string[];
357
+ example: {
358
+ config: string[];
359
+ output: string[];
360
+ };
361
+ };
362
+ E_KEY_INVALID: {
363
+ exit: string;
364
+ title: string;
365
+ summary: string;
366
+ when: string[];
367
+ fix: string[];
368
+ example: {
369
+ output: string[];
370
+ };
371
+ };
372
+ E_LIFECYCLE: {
373
+ exit: string;
374
+ title: string;
375
+ summary: string;
376
+ when: string[];
377
+ fix: string[];
378
+ example: {
379
+ config: string[];
380
+ output: string[];
381
+ };
382
+ };
383
+ E_LOCKED: {
384
+ exit: string;
385
+ title: string;
386
+ summary: string;
387
+ when: string[];
388
+ fix: string[];
389
+ example: {
390
+ output: string[];
391
+ };
392
+ };
393
+ E_LOCK_DIR: {
394
+ exit: string;
395
+ title: string;
396
+ summary: string;
397
+ when: string[];
398
+ fix: string[];
399
+ example: {
400
+ output: string[];
401
+ };
402
+ };
403
+ E_MISSING_EXPORT: {
404
+ exit: string;
405
+ title: string;
406
+ summary: string;
407
+ when: string[];
408
+ fix: string[];
409
+ example: {
410
+ output: string[];
411
+ };
412
+ };
413
+ E_MISSING_KEY: {
414
+ exit: string;
415
+ title: string;
416
+ summary: string;
417
+ when: string[];
418
+ fix: string[];
419
+ example: {
420
+ output: string[];
421
+ };
422
+ };
423
+ E_NOT_DATA: {
424
+ exit: string;
425
+ title: string;
426
+ summary: string;
427
+ when: string[];
428
+ fix: string[];
429
+ example: {
430
+ config: string[];
431
+ output: string[];
432
+ };
433
+ };
434
+ E_NO_CONFIG: {
435
+ exit: string;
436
+ title: string;
437
+ summary: string;
438
+ when: string[];
439
+ fix: string[];
440
+ example: {
441
+ output: string[];
442
+ };
443
+ };
444
+ E_NO_TARGETS: {
445
+ exit: string;
446
+ title: string;
447
+ summary: string;
448
+ when: string[];
449
+ fix: string[];
450
+ example: {
451
+ output: string[];
452
+ };
453
+ };
454
+ E_OVERRIDE_AMBIGUOUS: {
455
+ exit: string;
456
+ title: string;
457
+ summary: string;
458
+ when: string[];
459
+ fix: string[];
460
+ example: {
461
+ config: string[];
462
+ output: string[];
463
+ };
464
+ };
465
+ E_OVERRIDE_DEFINITION: {
466
+ exit: string;
467
+ title: string;
468
+ summary: string;
469
+ when: string[];
470
+ fix: string[];
471
+ example: {
472
+ config: string[];
473
+ output: string[];
474
+ };
475
+ };
476
+ E_OVERRIDE_NAME: {
477
+ exit: string;
478
+ title: string;
479
+ summary: string;
480
+ when: string[];
481
+ fix: string[];
482
+ example: {
483
+ config: string[];
484
+ output: string[];
485
+ };
486
+ };
487
+ E_PLAN_DELETE: {
488
+ exit: string;
489
+ title: string;
490
+ summary: string;
491
+ when: string[];
492
+ fix: string[];
493
+ example: {
494
+ output: string[];
495
+ };
496
+ };
497
+ E_PLAN_DESTINATION: {
498
+ exit: string;
499
+ title: string;
500
+ summary: string;
501
+ when: string[];
502
+ fix: string[];
503
+ example: {
504
+ output: string[];
505
+ };
506
+ };
507
+ E_PLAN_DIGEST: {
508
+ exit: string;
509
+ title: string;
510
+ summary: string;
511
+ when: string[];
512
+ fix: string[];
513
+ example: {
514
+ output: string[];
515
+ };
516
+ };
517
+ E_PLAN_INVALID: {
518
+ exit: string;
519
+ title: string;
520
+ summary: string;
521
+ when: string[];
522
+ fix: string[];
523
+ example: {
524
+ output: string[];
525
+ };
526
+ };
527
+ E_PLAN_RISK: {
528
+ exit: string;
529
+ title: string;
530
+ summary: string;
531
+ when: string[];
532
+ fix: string[];
533
+ example: {
534
+ output: string[];
535
+ };
536
+ };
537
+ E_PLAN_SCHEMA: {
538
+ exit: string;
539
+ title: string;
540
+ summary: string;
541
+ when: string[];
542
+ fix: string[];
543
+ example: {
544
+ output: string[];
545
+ };
546
+ };
547
+ E_PLAN_STALE: {
548
+ exit: string;
549
+ title: string;
550
+ summary: string;
551
+ when: string[];
552
+ fix: string[];
553
+ example: {
554
+ output: string[];
555
+ };
556
+ };
557
+ E_PLAN_VERSION: {
558
+ exit: string;
559
+ title: string;
560
+ summary: string;
561
+ when: string[];
562
+ fix: string[];
563
+ example: {
564
+ output: string[];
565
+ };
566
+ };
567
+ E_POLICY_CHANGED: {
568
+ exit: string;
569
+ title: string;
570
+ summary: string;
571
+ when: string[];
572
+ fix: string[];
573
+ example: {
574
+ output: string[];
575
+ };
576
+ };
577
+ E_PORTAL_ID: {
578
+ exit: string;
579
+ title: string;
580
+ summary: string;
581
+ when: string[];
582
+ fix: string[];
583
+ example: {
584
+ output: string[];
585
+ };
586
+ };
587
+ E_PREVENT_DESTROY: {
588
+ exit: string;
589
+ title: string;
590
+ summary: string;
591
+ when: string[];
592
+ fix: string[];
593
+ example: {
594
+ output: string[];
595
+ };
596
+ };
597
+ E_PROJECT_WRITE: {
598
+ exit: string;
599
+ title: string;
600
+ summary: string;
601
+ when: string[];
602
+ fix: string[];
603
+ example: {
604
+ output: string[];
605
+ };
606
+ };
607
+ E_PROTECTED_SAVED_PLAN: {
608
+ exit: string;
609
+ title: string;
610
+ summary: string;
611
+ when: string[];
612
+ fix: string[];
613
+ example: {
614
+ output: string[];
615
+ };
616
+ };
617
+ E_PULL_INVALID: {
618
+ exit: string;
619
+ title: string;
620
+ summary: string;
621
+ when: string[];
622
+ fix: string[];
623
+ example: {
624
+ output: string[];
625
+ };
626
+ };
627
+ E_RATE_LIMIT: {
628
+ exit: string;
629
+ title: string;
630
+ summary: string;
631
+ when: string[];
632
+ fix: string[];
633
+ example: {
634
+ output: string[];
635
+ };
636
+ };
637
+ E_REBIND_STANDARD: {
638
+ exit: string;
639
+ title: string;
640
+ summary: string;
641
+ when: string[];
642
+ fix: string[];
643
+ example: {
644
+ output: string[];
645
+ };
646
+ };
647
+ E_REFERENCE_DEFINITION: {
648
+ exit: string;
649
+ title: string;
650
+ summary: string;
651
+ when: string[];
652
+ fix: string[];
653
+ example: {
654
+ config: string[];
655
+ output: string[];
656
+ };
657
+ };
658
+ E_RM_DEPENDENTS: {
659
+ exit: string;
660
+ title: string;
661
+ summary: string;
662
+ when: string[];
663
+ fix: string[];
664
+ example: {
665
+ output: string[];
666
+ };
667
+ };
668
+ E_SCOPE: {
669
+ exit: string;
670
+ title: string;
671
+ summary: string;
672
+ when: string[];
673
+ fix: string[];
674
+ example: {
675
+ output: string[];
676
+ };
677
+ };
678
+ E_SETTING_LEVEL: {
679
+ exit: string;
680
+ title: string;
681
+ summary: string;
682
+ when: string[];
683
+ fix: string[];
684
+ example: {
685
+ config: string[];
686
+ output: string[];
687
+ };
688
+ };
689
+ E_SETTING_VALUE: {
690
+ exit: string;
691
+ title: string;
692
+ summary: string;
693
+ when: string[];
694
+ fix: string[];
695
+ example: {
696
+ config: string[];
697
+ output: string[];
698
+ };
699
+ };
700
+ E_SNAPSHOT: {
701
+ exit: string;
702
+ title: string;
703
+ summary: string;
704
+ when: string[];
705
+ fix: string[];
706
+ example: {
707
+ output: string[];
708
+ };
709
+ };
710
+ E_STANDARD_OBJECT: {
711
+ exit: string;
712
+ title: string;
713
+ summary: string;
714
+ when: string[];
715
+ fix: string[];
716
+ example: {
717
+ config: string[];
718
+ output: string[];
719
+ };
720
+ };
721
+ E_STATE_CHANGED: {
722
+ exit: string;
723
+ title: string;
724
+ summary: string;
725
+ when: string[];
726
+ fix: string[];
727
+ example: {
728
+ output: string[];
729
+ };
730
+ };
731
+ E_STATE_CONFLICT: {
732
+ exit: string;
733
+ title: string;
734
+ summary: string;
735
+ when: string[];
736
+ fix: string[];
737
+ example: {
738
+ output: string[];
739
+ };
740
+ };
741
+ E_STATE_INVALID: {
742
+ exit: string;
743
+ title: string;
744
+ summary: string;
745
+ when: string[];
746
+ fix: string[];
747
+ example: {
748
+ output: string[];
749
+ };
750
+ };
751
+ E_STATE_SCHEMA: {
752
+ exit: string;
753
+ title: string;
754
+ summary: string;
755
+ when: string[];
756
+ fix: string[];
757
+ example: {
758
+ output: string[];
759
+ };
760
+ };
761
+ E_STATE_WRITE: {
762
+ exit: string;
763
+ title: string;
764
+ summary: string;
765
+ when: string[];
766
+ fix: string[];
767
+ example: {
768
+ output: string[];
769
+ };
770
+ };
771
+ E_STRICT_WITHOUT_OPTIONS: {
772
+ exit: string;
773
+ title: string;
774
+ summary: string;
775
+ when: string[];
776
+ fix: string[];
777
+ example: {
778
+ config: string[];
779
+ output: string[];
780
+ };
781
+ };
782
+ E_TAKE_UNMATCHED: {
783
+ exit: string;
784
+ title: string;
785
+ summary: string;
786
+ when: string[];
787
+ fix: string[];
788
+ example: {
789
+ output: string[];
790
+ };
791
+ };
792
+ E_TARGET_NAME: {
793
+ exit: string;
794
+ title: string;
795
+ summary: string;
796
+ when: string[];
797
+ fix: string[];
798
+ example: {
799
+ output: string[];
800
+ };
801
+ };
802
+ E_TARGET_PORTAL_MISMATCH: {
803
+ exit: string;
804
+ title: string;
805
+ summary: string;
806
+ when: string[];
807
+ fix: string[];
808
+ example: {
809
+ output: string[];
810
+ };
811
+ };
812
+ E_TARGET_REQUIRED: {
813
+ exit: string;
814
+ title: string;
815
+ summary: string;
816
+ when: string[];
817
+ fix: string[];
818
+ example: {
819
+ output: string[];
820
+ };
821
+ };
822
+ E_TOMBSTONE_ADDRESS: {
823
+ exit: string;
824
+ title: string;
825
+ summary: string;
826
+ when: string[];
827
+ fix: string[];
828
+ example: {
829
+ config: string[];
830
+ output: string[];
831
+ };
832
+ };
833
+ E_TOMBSTONE_CONFLICT: {
834
+ exit: string;
835
+ title: string;
836
+ summary: string;
837
+ when: string[];
838
+ fix: string[];
839
+ example: {
840
+ output: string[];
841
+ };
842
+ };
843
+ E_TYPE_FIELDTYPE: {
844
+ exit: string;
845
+ title: string;
846
+ summary: string;
847
+ when: string[];
848
+ fix: string[];
849
+ example: {
850
+ config: string[];
851
+ output: string[];
852
+ };
853
+ };
854
+ E_UNCERTAIN_WRITE: {
855
+ exit: string;
856
+ title: string;
857
+ summary: string;
858
+ when: string[];
859
+ fix: string[];
860
+ example: {
861
+ output: string[];
862
+ };
863
+ };
864
+ E_UNEXPECTED: {
865
+ exit: string;
866
+ title: string;
867
+ summary: string;
868
+ when: string[];
869
+ fix: string[];
870
+ example: {
871
+ output: string[];
872
+ };
873
+ };
874
+ E_UNKNOWN_BUILDER: {
875
+ exit: string;
876
+ title: string;
877
+ summary: string;
878
+ when: string[];
879
+ fix: string[];
880
+ example: {
881
+ config: string[];
882
+ output: string[];
883
+ };
884
+ };
885
+ E_UNKNOWN_GROUP: {
886
+ exit: string;
887
+ title: string;
888
+ summary: string;
889
+ when: string[];
890
+ fix: string[];
891
+ example: {
892
+ config: string[];
893
+ output: string[];
894
+ };
895
+ };
896
+ E_UNKNOWN_INCLUDE: {
897
+ exit: string;
898
+ title: string;
899
+ summary: string;
900
+ when: string[];
901
+ fix: string[];
902
+ example: {
903
+ output: string[];
904
+ };
905
+ };
906
+ E_UNKNOWN_OBJECT: {
907
+ exit: string;
908
+ title: string;
909
+ summary: string;
910
+ when: string[];
911
+ fix: string[];
912
+ example: {
913
+ output: string[];
914
+ };
915
+ };
916
+ E_UNKNOWN_OVERRIDE: {
917
+ exit: string;
918
+ title: string;
919
+ summary: string;
920
+ when: string[];
921
+ fix: string[];
922
+ example: {
923
+ output: string[];
924
+ };
925
+ };
926
+ E_UNKNOWN_TARGET: {
927
+ exit: string;
928
+ title: string;
929
+ summary: string;
930
+ when: string[];
931
+ fix: string[];
932
+ example: {
933
+ output: string[];
934
+ };
935
+ };
936
+ E_UNREACHABLE: {
937
+ exit: string;
938
+ title: string;
939
+ summary: string;
940
+ when: string[];
941
+ fix: string[];
942
+ example: {
943
+ output: string[];
944
+ };
945
+ };
946
+ E_UNSUPPORTED_FILE: {
947
+ exit: string;
948
+ title: string;
949
+ summary: string;
950
+ when: string[];
951
+ fix: string[];
952
+ example: {
953
+ output: string[];
954
+ };
955
+ };
956
+ E_USAGE: {
957
+ exit: string;
958
+ title: string;
959
+ summary: string;
960
+ when: string[];
961
+ fix: string[];
962
+ example: {
963
+ output: string[];
964
+ };
965
+ };
966
+ E_WRITE_IN_READ_MODE: {
967
+ exit: string;
968
+ title: string;
969
+ summary: string;
970
+ when: string[];
971
+ fix: string[];
972
+ example: {
973
+ output: string[];
974
+ };
975
+ };
976
+ E_WRITE_NOT_ALLOWED: {
977
+ exit: string;
978
+ title: string;
979
+ summary: string;
980
+ when: string[];
981
+ fix: string[];
982
+ example: {
983
+ output: string[];
984
+ };
985
+ };
986
+ W_BLUEPRINT_DOWNGRADE: {
987
+ exit: string;
988
+ title: string;
989
+ summary: string;
990
+ when: string[];
991
+ fix: string[];
992
+ example: {
993
+ output: string[];
994
+ };
995
+ };
996
+ W_CODEC_MISMATCH: {
997
+ exit: string;
998
+ title: string;
999
+ summary: string;
1000
+ when: string[];
1001
+ fix: string[];
1002
+ example: {
1003
+ output: string[];
1004
+ };
1005
+ };
1006
+ W_INCOMPLETE: {
1007
+ exit: string;
1008
+ title: string;
1009
+ summary: string;
1010
+ when: string[];
1011
+ fix: string[];
1012
+ example: {
1013
+ output: string[];
1014
+ };
1015
+ };
1016
+ W_JSON_FIELDTYPE: {
1017
+ exit: string;
1018
+ title: string;
1019
+ summary: string;
1020
+ when: string[];
1021
+ fix: string[];
1022
+ example: {
1023
+ output: string[];
1024
+ };
1025
+ };
1026
+ W_KEY_COLLISION: {
1027
+ exit: string;
1028
+ title: string;
1029
+ summary: string;
1030
+ when: string[];
1031
+ fix: string[];
1032
+ example: {
1033
+ output: string[];
1034
+ };
1035
+ };
1036
+ W_LARGE_SCOPE: {
1037
+ exit: string;
1038
+ title: string;
1039
+ summary: string;
1040
+ when: string[];
1041
+ fix: string[];
1042
+ example: {
1043
+ config: string[];
1044
+ output: string[];
1045
+ };
1046
+ };
1047
+ W_LIMIT_HEADROOM: {
1048
+ exit: string;
1049
+ title: string;
1050
+ summary: string;
1051
+ when: string[];
1052
+ fix: string[];
1053
+ example: {
1054
+ output: string[];
1055
+ };
1056
+ };
1057
+ W_LIMIT_UNREADABLE: {
1058
+ exit: string;
1059
+ title: string;
1060
+ summary: string;
1061
+ when: string[];
1062
+ fix: string[];
1063
+ example: {
1064
+ output: string[];
1065
+ };
1066
+ };
1067
+ W_MODE_SHADOWED: {
1068
+ exit: string;
1069
+ title: string;
1070
+ summary: string;
1071
+ when: string[];
1072
+ fix: string[];
1073
+ example: {
1074
+ output: string[];
1075
+ };
1076
+ };
1077
+ W_OVERRIDE_OPTION: {
1078
+ exit: string;
1079
+ title: string;
1080
+ summary: string;
1081
+ when: string[];
1082
+ fix: string[];
1083
+ example: {
1084
+ output: string[];
1085
+ };
1086
+ };
1087
+ W_PIN_EXPIRES: {
1088
+ exit: string;
1089
+ title: string;
1090
+ summary: string;
1091
+ when: string[];
1092
+ fix: string[];
1093
+ example: {
1094
+ output: string[];
1095
+ };
1096
+ };
1097
+ W_PREFIX: {
1098
+ exit: string;
1099
+ title: string;
1100
+ summary: string;
1101
+ when: string[];
1102
+ fix: string[];
1103
+ example: {
1104
+ output: string[];
1105
+ };
1106
+ };
1107
+ W_RATE_HEADERS: {
1108
+ exit: string;
1109
+ title: string;
1110
+ summary: string;
1111
+ when: string[];
1112
+ fix: string[];
1113
+ example: {
1114
+ output: string[];
1115
+ };
1116
+ };
1117
+ W_RATE_LIMIT: {
1118
+ exit: string;
1119
+ title: string;
1120
+ summary: string;
1121
+ when: string[];
1122
+ fix: string[];
1123
+ example: {
1124
+ output: string[];
1125
+ };
1126
+ };
1127
+ W_UNADDRESSABLE_NAME: {
1128
+ exit: string;
1129
+ title: string;
1130
+ summary: string;
1131
+ when: string[];
1132
+ fix: string[];
1133
+ example: {
1134
+ output: string[];
1135
+ };
1136
+ };
1137
+ W_UNFINISHED_APPLY: {
1138
+ exit: string;
1139
+ title: string;
1140
+ summary: string;
1141
+ when: string[];
1142
+ fix: string[];
1143
+ example: {
1144
+ output: string[];
1145
+ };
1146
+ };
1147
+ W_UNRESOLVED: {
1148
+ exit: string;
1149
+ title: string;
1150
+ summary: string;
1151
+ when: string[];
1152
+ fix: string[];
1153
+ example: {
1154
+ output: string[];
1155
+ };
1156
+ };
1157
+ W_UNSUPPORTED_TYPE: {
1158
+ exit: string;
1159
+ title: string;
1160
+ summary: string;
1161
+ when: string[];
1162
+ fix: string[];
1163
+ example: {
1164
+ output: string[];
1165
+ };
1166
+ };
1167
+ W_UNVERIFIED: {
1168
+ exit: string;
1169
+ title: string;
1170
+ summary: string;
1171
+ when: string[];
1172
+ fix: string[];
1173
+ example: {
1174
+ output: string[];
1175
+ };
1176
+ };
1177
+ };
1178
+ type IssueCode = keyof typeof issues;
1179
+ /** One entry of a command's issues[], as the envelope contract defines it. */
1180
+ interface Issue {
1181
+ code: IssueCode;
1182
+ configPath?: string;
1183
+ docs?: string;
1184
+ file?: string;
1185
+ fix?: string;
1186
+ humanRequired?: boolean;
1187
+ line?: number;
1188
+ message: string;
1189
+ }
1190
+ //#endregion
1191
+ //#region src/lib/errors.d.ts
1192
+ declare const exitCodes: {
1193
+ readonly done: 0;
1194
+ readonly error: 1;
1195
+ readonly differences: 2;
1196
+ readonly invalid: 3;
1197
+ readonly humanRequired: 4;
1198
+ readonly partial: 5;
1199
+ };
1200
+ type ExitCode = (typeof exitCodes)[keyof typeof exitCodes];
1201
+ //#endregion
1202
+ //#region src/commands/context.d.ts
1203
+ /** The parsed flags. A command's adapter declares which of them it accepts; the rest stay unset. */
1204
+ interface Flags {
1205
+ /** `--accept <address[#unit]>`, repeatable: pull takes the portal side of a kept config change or a conflict. */
1206
+ accept?: string[];
1207
+ /** `--approve <writesHash>`: a reviewed CI job's approval of a saved plan. */
1208
+ approve?: string;
1209
+ check: boolean;
1210
+ discover: boolean;
1211
+ /** `add` and `blueprint upgrade --dry-run`: report what would change and write nothing. */
1212
+ dryRun: boolean;
1213
+ exitCode: boolean;
1214
+ objects?: string;
1215
+ only?: string;
1216
+ out?: string;
1217
+ portal?: string;
1218
+ /** `add --prefix <p>`: the prefix for one add, over config's `prefix`. */
1219
+ prefix?: string;
1220
+ /** `rm --release`: stop managing the resource and leave it in the portal. */
1221
+ release: boolean;
1222
+ /** `--take`, repeatable: a side, then selectors, as plan and blueprint upgrade read them. */
1223
+ take?: string[];
1224
+ target?: string;
1225
+ /** `state rebuild --write`: replace the state file, at a terminal only. */
1226
+ write: boolean;
1227
+ yes: boolean;
1228
+ }
1229
+ /** Asks the person at the terminal. Only an interactive host provides one; handlers never read stdin themselves. */
1230
+ interface Prompter {
1231
+ /** What the person typed, or undefined when they cancelled or the input ended. */
1232
+ ask: (question: string) => Promise<string | undefined>;
1233
+ /** The value of the choice the person picked, or undefined when they cancelled or gave no valid answer. */
1234
+ choose: (question: string, choices: {
1235
+ label: string;
1236
+ value: string;
1237
+ }[]) => Promise<string | undefined>;
1238
+ /** Shows lines to the person before a question, each sanitized. */
1239
+ tell: (lines: string[]) => void;
1240
+ }
1241
+ interface Context {
1242
+ /** The positional arguments, in the order the command declares them. */
1243
+ args: string[];
1244
+ cwd: string;
1245
+ flags: Flags;
1246
+ /** Writes one line about a long wait to stderr; absent under --json. */
1247
+ progress?: (line: string) => void;
1248
+ /** Present only when a person is at a terminal: stdin and stderr are terminals, no --json and no CI. */
1249
+ prompt?: Prompter;
1250
+ /** Aborted on SIGINT or SIGTERM, for a command the host lets stop cleanly (apply). */
1251
+ signal?: AbortSignal;
1252
+ }
1253
+ /**
1254
+ * What a command returns. `issues` on a zero exit are warnings, or an E_SCOPE gap the command recorded and went on past
1255
+ * (status, plan, snapshot). `text` is the human output, ignored with --json.
1256
+ */
1257
+ interface Result<T = unknown> {
1258
+ data?: T;
1259
+ exitCode?: ExitCode;
1260
+ issues?: Issue[];
1261
+ text?: string;
1262
+ }
1263
+ type Handler = (ctx: Context) => Result | Promise<Result>;
1264
+ //#endregion
1265
+ export { ExitCode as i, Prompter as n, Result as r, Handler as t };