mdkg 0.5.0 → 0.5.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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "tool": "mdkg",
4
- "package_version": "0.5.0",
4
+ "package_version": "0.5.2",
5
5
  "source": {
6
6
  "help_targets": "scripts/cli_help_targets.js",
7
7
  "command_matrix": "CLI_COMMAND_MATRIX.md"
@@ -25,7 +25,7 @@
25
25
  " mdkg archive list [--kind source|artifact] [--visibility private|internal|public] [--json]",
26
26
  " mdkg archive show <id-or-archive-uri> [--json]",
27
27
  " mdkg archive verify [id-or-archive-uri] [--json]",
28
- " mdkg archive compress <id-or-archive-uri|--all> [--json]"
28
+ " mdkg archive compress <id-or-archive-uri-or-qid|--all> [--ws <local-alias>] [--json]"
29
29
  ],
30
30
  "args": [
31
31
  {
@@ -39,9 +39,9 @@
39
39
  "source": "<id-or-archive-uri>"
40
40
  },
41
41
  {
42
- "name": "id-or-archive-uri|--all",
42
+ "name": "id-or-archive-uri-or-qid|--all",
43
43
  "required": true,
44
- "source": "<id-or-archive-uri|--all>"
44
+ "source": "<id-or-archive-uri-or-qid|--all>"
45
45
  }
46
46
  ],
47
47
  "flags": [
@@ -51,6 +51,24 @@
51
51
  "required": false,
52
52
  "description": "--help, -h Show help"
53
53
  },
54
+ {
55
+ "name": "--id",
56
+ "value": "<archive.id>",
57
+ "required": false,
58
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--json]"
59
+ },
60
+ {
61
+ "name": "--json",
62
+ "value": null,
63
+ "required": false,
64
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--json]"
65
+ },
66
+ {
67
+ "name": "--kind",
68
+ "value": "source|artifact",
69
+ "required": false,
70
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--json]"
71
+ },
54
72
  {
55
73
  "name": "--root",
56
74
  "value": null,
@@ -62,6 +80,18 @@
62
80
  "value": null,
63
81
  "required": false,
64
82
  "description": "--version, -V Show version"
83
+ },
84
+ {
85
+ "name": "--visibility",
86
+ "value": "private|internal|public",
87
+ "required": false,
88
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--json]"
89
+ },
90
+ {
91
+ "name": "--ws",
92
+ "value": "<local-alias>",
93
+ "required": false,
94
+ "description": "mdkg archive compress <id-or-archive-uri-or-qid|--all> [--ws <local-alias>] [--json]"
65
95
  }
66
96
  ],
67
97
  "output_formats": [
@@ -136,17 +166,59 @@
136
166
  "required": false,
137
167
  "description": "--help, -h Show help"
138
168
  },
169
+ {
170
+ "name": "--id",
171
+ "value": "<archive.id>",
172
+ "required": false,
173
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
174
+ },
175
+ {
176
+ "name": "--json",
177
+ "value": null,
178
+ "required": false,
179
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
180
+ },
181
+ {
182
+ "name": "--kind",
183
+ "value": "source|artifact",
184
+ "required": false,
185
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
186
+ },
187
+ {
188
+ "name": "--refs",
189
+ "value": "<...>",
190
+ "required": false,
191
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
192
+ },
193
+ {
194
+ "name": "--relates",
195
+ "value": "<...>",
196
+ "required": false,
197
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
198
+ },
139
199
  {
140
200
  "name": "--root",
141
201
  "value": null,
142
202
  "required": false,
143
203
  "description": "--root, -r <path> Run against a specific repo root"
144
204
  },
205
+ {
206
+ "name": "--title",
207
+ "value": "<title>",
208
+ "required": false,
209
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
210
+ },
145
211
  {
146
212
  "name": "--version",
147
213
  "value": null,
148
214
  "required": false,
149
215
  "description": "--version, -V Show version"
216
+ },
217
+ {
218
+ "name": "--visibility",
219
+ "value": "private|internal|public",
220
+ "required": false,
221
+ "description": "mdkg archive add <file> [--id <archive.id>] [--kind source|artifact] [--visibility private|internal|public] [--title <title>] [--refs <...>] [--relates <...>] [--json]"
150
222
  }
151
223
  ],
152
224
  "output_formats": [
@@ -203,22 +275,22 @@
203
275
  "visibility": "public",
204
276
  "summary": "mdkg archive compress command",
205
277
  "usage": [
206
- " mdkg archive compress <id-or-archive-uri> [--ws <alias>] [--json]",
207
- " mdkg archive compress --all [--json]"
278
+ " mdkg archive compress <id-or-archive-uri-or-qid> [--ws <local-alias>] [--json]",
279
+ " mdkg archive compress --all [--ws <local-alias>] [--json]"
208
280
  ],
209
281
  "args": [
210
282
  {
211
- "name": "id-or-archive-uri",
283
+ "name": "id-or-archive-uri-or-qid",
212
284
  "required": true,
213
- "source": "<id-or-archive-uri>"
285
+ "source": "<id-or-archive-uri-or-qid>"
214
286
  }
215
287
  ],
216
288
  "flags": [
217
289
  {
218
290
  "name": "--all",
219
- "value": "[--json]",
291
+ "value": "[--ws <local-alias>]",
220
292
  "required": false,
221
- "description": "mdkg archive compress --all [--json]"
293
+ "description": "mdkg archive compress --all [--ws <local-alias>] [--json]"
222
294
  },
223
295
  {
224
296
  "name": "--help",
@@ -226,6 +298,12 @@
226
298
  "required": false,
227
299
  "description": "--help, -h Show help"
228
300
  },
301
+ {
302
+ "name": "--json",
303
+ "value": null,
304
+ "required": false,
305
+ "description": "mdkg archive compress <id-or-archive-uri-or-qid> [--ws <local-alias>] [--json]"
306
+ },
229
307
  {
230
308
  "name": "--root",
231
309
  "value": null,
@@ -237,6 +315,12 @@
237
315
  "value": null,
238
316
  "required": false,
239
317
  "description": "--version, -V Show version"
318
+ },
319
+ {
320
+ "name": "--ws",
321
+ "value": "<local-alias>",
322
+ "required": false,
323
+ "description": "mdkg archive compress <id-or-archive-uri-or-qid> [--ws <local-alias>] [--json]"
240
324
  }
241
325
  ],
242
326
  "output_formats": [
@@ -245,7 +329,7 @@
245
329
  ],
246
330
  "json_schema_ref": "mdkg.command_output.v1",
247
331
  "side_effects": [
248
- "refresh-archive-zip-cache"
332
+ "refresh-local-workspace-archive-zip-caches"
249
333
  ],
250
334
  "read_paths": [
251
335
  ".mdkg/**"
@@ -258,9 +342,11 @@
258
342
  "supported": false
259
343
  },
260
344
  "lock_policy": "mutation-lock-required",
261
- "atomic_write_policy": "zip-temp-rename",
345
+ "atomic_write_policy": "full-selection-preflight-then-per-file-atomic-replacement",
262
346
  "receipts": [
263
- "archive-compress-receipt"
347
+ "archive-compress-receipt",
348
+ "archive-workspace-selection-receipt",
349
+ "read-only-exclusion-receipt"
264
350
  ],
265
351
  "danger_level": "moderate",
266
352
  "aliases": [],
@@ -275,8 +361,8 @@
275
361
  }
276
362
  ],
277
363
  "examples": [
278
- " mdkg archive compress --all [--json]",
279
- " mdkg archive compress <id-or-archive-uri> [--ws <alias>] [--json]"
364
+ " mdkg archive compress --all [--ws <local-alias>] [--json]",
365
+ " mdkg archive compress <id-or-archive-uri-or-qid> [--ws <local-alias>] [--json]"
280
366
  ],
281
367
  "docs": {
282
368
  "help_target": "mdkg help archive compress",
@@ -304,6 +390,18 @@
304
390
  "required": false,
305
391
  "description": "--help, -h Show help"
306
392
  },
393
+ {
394
+ "name": "--json",
395
+ "value": null,
396
+ "required": false,
397
+ "description": "mdkg archive list [--kind source|artifact] [--visibility private|internal|public] [--ws <alias>] [--json]"
398
+ },
399
+ {
400
+ "name": "--kind",
401
+ "value": "source|artifact",
402
+ "required": false,
403
+ "description": "mdkg archive list [--kind source|artifact] [--visibility private|internal|public] [--ws <alias>] [--json]"
404
+ },
307
405
  {
308
406
  "name": "--root",
309
407
  "value": null,
@@ -315,6 +413,18 @@
315
413
  "value": null,
316
414
  "required": false,
317
415
  "description": "--version, -V Show version"
416
+ },
417
+ {
418
+ "name": "--visibility",
419
+ "value": "private|internal|public",
420
+ "required": false,
421
+ "description": "mdkg archive list [--kind source|artifact] [--visibility private|internal|public] [--ws <alias>] [--json]"
422
+ },
423
+ {
424
+ "name": "--ws",
425
+ "value": "<alias>",
426
+ "required": false,
427
+ "description": "mdkg archive list [--kind source|artifact] [--visibility private|internal|public] [--ws <alias>] [--json]"
318
428
  }
319
429
  ],
320
430
  "output_formats": [
@@ -382,6 +492,12 @@
382
492
  "required": false,
383
493
  "description": "--help, -h Show help"
384
494
  },
495
+ {
496
+ "name": "--json",
497
+ "value": null,
498
+ "required": false,
499
+ "description": "mdkg archive show <id-or-archive-uri> [--ws <alias>] [--json]"
500
+ },
385
501
  {
386
502
  "name": "--root",
387
503
  "value": null,
@@ -393,6 +509,12 @@
393
509
  "value": null,
394
510
  "required": false,
395
511
  "description": "--version, -V Show version"
512
+ },
513
+ {
514
+ "name": "--ws",
515
+ "value": "<alias>",
516
+ "required": false,
517
+ "description": "mdkg archive show <id-or-archive-uri> [--ws <alias>] [--json]"
396
518
  }
397
519
  ],
398
520
  "output_formats": [
@@ -460,6 +582,12 @@
460
582
  "required": false,
461
583
  "description": "--help, -h Show help"
462
584
  },
585
+ {
586
+ "name": "--json",
587
+ "value": null,
588
+ "required": false,
589
+ "description": "mdkg archive verify [id-or-archive-uri] [--ws <alias>] [--json]"
590
+ },
463
591
  {
464
592
  "name": "--root",
465
593
  "value": null,
@@ -471,6 +599,12 @@
471
599
  "value": null,
472
600
  "required": false,
473
601
  "description": "--version, -V Show version"
602
+ },
603
+ {
604
+ "name": "--ws",
605
+ "value": "<alias>",
606
+ "required": false,
607
+ "description": "mdkg archive verify [id-or-archive-uri] [--ws <alias>] [--json]"
474
608
  }
475
609
  ],
476
610
  "output_formats": [
@@ -540,6 +674,24 @@
540
674
  "required": false,
541
675
  "description": "--help, -h Show help"
542
676
  },
677
+ {
678
+ "name": "--json",
679
+ "value": null,
680
+ "required": false,
681
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
682
+ },
683
+ {
684
+ "name": "--output",
685
+ "value": "<path>",
686
+ "required": false,
687
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
688
+ },
689
+ {
690
+ "name": "--profile",
691
+ "value": "private|public",
692
+ "required": false,
693
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
694
+ },
543
695
  {
544
696
  "name": "--root",
545
697
  "value": null,
@@ -551,6 +703,12 @@
551
703
  "value": null,
552
704
  "required": false,
553
705
  "description": "--version, -V Show version"
706
+ },
707
+ {
708
+ "name": "--ws",
709
+ "value": "<alias|all>",
710
+ "required": false,
711
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
554
712
  }
555
713
  ],
556
714
  "output_formats": [
@@ -619,6 +777,24 @@
619
777
  "required": false,
620
778
  "description": "--help, -h Show help"
621
779
  },
780
+ {
781
+ "name": "--json",
782
+ "value": null,
783
+ "required": false,
784
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
785
+ },
786
+ {
787
+ "name": "--output",
788
+ "value": "<path>",
789
+ "required": false,
790
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
791
+ },
792
+ {
793
+ "name": "--profile",
794
+ "value": "private|public",
795
+ "required": false,
796
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
797
+ },
622
798
  {
623
799
  "name": "--root",
624
800
  "value": null,
@@ -630,6 +806,12 @@
630
806
  "value": null,
631
807
  "required": false,
632
808
  "description": "--version, -V Show version"
809
+ },
810
+ {
811
+ "name": "--ws",
812
+ "value": "<alias|all>",
813
+ "required": false,
814
+ "description": "mdkg bundle create [--profile private|public] [--ws <alias|all>] [--output <path>] [--json]"
633
815
  }
634
816
  ],
635
817
  "output_formats": [
@@ -773,6 +955,12 @@
773
955
  "required": false,
774
956
  "description": "--help, -h Show help"
775
957
  },
958
+ {
959
+ "name": "--json",
960
+ "value": null,
961
+ "required": false,
962
+ "description": "mdkg bundle list [--json]"
963
+ },
776
964
  {
777
965
  "name": "--root",
778
966
  "value": null,
@@ -851,6 +1039,12 @@
851
1039
  "required": false,
852
1040
  "description": "--help, -h Show help"
853
1041
  },
1042
+ {
1043
+ "name": "--json",
1044
+ "value": null,
1045
+ "required": false,
1046
+ "description": "mdkg bundle show <bundle-path> [--json]"
1047
+ },
854
1048
  {
855
1049
  "name": "--root",
856
1050
  "value": null,
@@ -929,6 +1123,12 @@
929
1123
  "required": false,
930
1124
  "description": "--help, -h Show help"
931
1125
  },
1126
+ {
1127
+ "name": "--json",
1128
+ "value": null,
1129
+ "required": false,
1130
+ "description": "mdkg bundle verify [bundle-path] [--json]"
1131
+ },
932
1132
  {
933
1133
  "name": "--root",
934
1134
  "value": null,
@@ -1008,12 +1208,36 @@
1008
1208
  }
1009
1209
  ],
1010
1210
  "flags": [
1211
+ {
1212
+ "name": "--fresh-only",
1213
+ "value": null,
1214
+ "required": false,
1215
+ "description": "mdkg capability resolve [query] [--requires <capability>] [--fresh-only] [--json]"
1216
+ },
1011
1217
  {
1012
1218
  "name": "--help",
1013
1219
  "value": null,
1014
1220
  "required": false,
1015
1221
  "description": "--help, -h Show help"
1016
1222
  },
1223
+ {
1224
+ "name": "--json",
1225
+ "value": null,
1226
+ "required": false,
1227
+ "description": "mdkg capability list [--kind <kind>] [--visibility <level>] [--json]"
1228
+ },
1229
+ {
1230
+ "name": "--kind",
1231
+ "value": "<kind>",
1232
+ "required": false,
1233
+ "description": "mdkg capability list [--kind <kind>] [--visibility <level>] [--json]"
1234
+ },
1235
+ {
1236
+ "name": "--requires",
1237
+ "value": "<capability>",
1238
+ "required": false,
1239
+ "description": "mdkg capability resolve [query] [--requires <capability>] [--fresh-only] [--json]"
1240
+ },
1017
1241
  {
1018
1242
  "name": "--root",
1019
1243
  "value": null,
@@ -1025,6 +1249,12 @@
1025
1249
  "value": null,
1026
1250
  "required": false,
1027
1251
  "description": "--version, -V Show version"
1252
+ },
1253
+ {
1254
+ "name": "--visibility",
1255
+ "value": "<level>",
1256
+ "required": false,
1257
+ "description": "mdkg capability list [--kind <kind>] [--visibility <level>] [--json]"
1028
1258
  }
1029
1259
  ],
1030
1260
  "output_formats": [
@@ -1088,6 +1318,18 @@
1088
1318
  "required": false,
1089
1319
  "description": "--help, -h Show help"
1090
1320
  },
1321
+ {
1322
+ "name": "--json",
1323
+ "value": null,
1324
+ "required": false,
1325
+ "description": "mdkg capability list [--kind <kind>] [--visibility <level>] [--json]"
1326
+ },
1327
+ {
1328
+ "name": "--kind",
1329
+ "value": "<kind>",
1330
+ "required": false,
1331
+ "description": "mdkg capability list [--kind <kind>] [--visibility <level>] [--json]"
1332
+ },
1091
1333
  {
1092
1334
  "name": "--root",
1093
1335
  "value": null,
@@ -1099,6 +1341,12 @@
1099
1341
  "value": null,
1100
1342
  "required": false,
1101
1343
  "description": "--version, -V Show version"
1344
+ },
1345
+ {
1346
+ "name": "--visibility",
1347
+ "value": "<level>",
1348
+ "required": false,
1349
+ "description": "mdkg capability list [--kind <kind>] [--visibility <level>] [--json]"
1102
1350
  }
1103
1351
  ],
1104
1352
  "output_formats": [
@@ -1166,6 +1414,18 @@
1166
1414
  "required": false,
1167
1415
  "description": "--help, -h Show help"
1168
1416
  },
1417
+ {
1418
+ "name": "--json",
1419
+ "value": null,
1420
+ "required": false,
1421
+ "description": "mdkg capability search \"<query>\" [--kind <kind>] [--visibility <level>] [--json]"
1422
+ },
1423
+ {
1424
+ "name": "--kind",
1425
+ "value": "<kind>",
1426
+ "required": false,
1427
+ "description": "mdkg capability search \"<query>\" [--kind <kind>] [--visibility <level>] [--json]"
1428
+ },
1169
1429
  {
1170
1430
  "name": "--root",
1171
1431
  "value": null,
@@ -1177,6 +1437,12 @@
1177
1437
  "value": null,
1178
1438
  "required": false,
1179
1439
  "description": "--version, -V Show version"
1440
+ },
1441
+ {
1442
+ "name": "--visibility",
1443
+ "value": "<level>",
1444
+ "required": false,
1445
+ "description": "mdkg capability search \"<query>\" [--kind <kind>] [--visibility <level>] [--json]"
1180
1446
  }
1181
1447
  ],
1182
1448
  "output_formats": [
@@ -1244,6 +1510,12 @@
1244
1510
  "required": false,
1245
1511
  "description": "--help, -h Show help"
1246
1512
  },
1513
+ {
1514
+ "name": "--json",
1515
+ "value": null,
1516
+ "required": false,
1517
+ "description": "mdkg capability show <id-or-qid-or-slug> [--json]"
1518
+ },
1247
1519
  {
1248
1520
  "name": "--root",
1249
1521
  "value": null,
@@ -1321,17 +1593,59 @@
1321
1593
  "required": false,
1322
1594
  "description": "--help, -h Show help"
1323
1595
  },
1596
+ {
1597
+ "name": "--json",
1598
+ "value": null,
1599
+ "required": false,
1600
+ "description": "mdkg checkpoint new <title> [--kind implementation|test-proof|goal-closeout|audit|handoff] [--ws <alias>] [--json]"
1601
+ },
1602
+ {
1603
+ "name": "--kind",
1604
+ "value": "implementation|test-proof|goal-closeout|audit|handoff",
1605
+ "required": false,
1606
+ "description": "mdkg checkpoint new <title> [--kind implementation|test-proof|goal-closeout|audit|handoff] [--ws <alias>] [--json]"
1607
+ },
1608
+ {
1609
+ "name": "--note",
1610
+ "value": "\"<text>\"",
1611
+ "required": false,
1612
+ "description": "[--relates <id,id,...>] [--scope <id,id,...>] [--run-id <id>] [--note \"<text>\"]"
1613
+ },
1614
+ {
1615
+ "name": "--relates",
1616
+ "value": "<id,id,...>",
1617
+ "required": false,
1618
+ "description": "[--relates <id,id,...>] [--scope <id,id,...>] [--run-id <id>] [--note \"<text>\"]"
1619
+ },
1324
1620
  {
1325
1621
  "name": "--root",
1326
1622
  "value": null,
1327
1623
  "required": false,
1328
1624
  "description": "--root, -r <path> Run against a specific repo root"
1329
1625
  },
1626
+ {
1627
+ "name": "--run-id",
1628
+ "value": "<id>",
1629
+ "required": false,
1630
+ "description": "[--relates <id,id,...>] [--scope <id,id,...>] [--run-id <id>] [--note \"<text>\"]"
1631
+ },
1632
+ {
1633
+ "name": "--scope",
1634
+ "value": "<id,id,...>",
1635
+ "required": false,
1636
+ "description": "[--relates <id,id,...>] [--scope <id,id,...>] [--run-id <id>] [--note \"<text>\"]"
1637
+ },
1330
1638
  {
1331
1639
  "name": "--version",
1332
1640
  "value": null,
1333
1641
  "required": false,
1334
1642
  "description": "--version, -V Show version"
1643
+ },
1644
+ {
1645
+ "name": "--ws",
1646
+ "value": "<alias>",
1647
+ "required": false,
1648
+ "description": "mdkg checkpoint new <title> [--kind implementation|test-proof|goal-closeout|audit|handoff] [--ws <alias>] [--json]"
1335
1649
  }
1336
1650
  ],
1337
1651
  "output_formats": [
@@ -1436,6 +1750,12 @@
1436
1750
  "required": false,
1437
1751
  "description": "--help, -h Show help"
1438
1752
  },
1753
+ {
1754
+ "name": "--json",
1755
+ "value": null,
1756
+ "required": false,
1757
+ "description": "mdkg db index rebuild [--tolerant] [--json]"
1758
+ },
1439
1759
  {
1440
1760
  "name": "--lease-ms",
1441
1761
  "value": "<ms>",
@@ -1448,6 +1768,18 @@
1448
1768
  "required": false,
1449
1769
  "description": "mdkg db queue claim <queue> --lease-owner <owner> --lease-ms <ms> [--json]"
1450
1770
  },
1771
+ {
1772
+ "name": "--output",
1773
+ "value": "<path>",
1774
+ "required": false,
1775
+ "description": "mdkg db snapshot dump [--snapshot <path>] [--output <path>] [--json]"
1776
+ },
1777
+ {
1778
+ "name": "--paused",
1779
+ "value": null,
1780
+ "required": false,
1781
+ "description": "mdkg db queue create <queue> [--paused] [--reason <text>] [--json]"
1782
+ },
1451
1783
  {
1452
1784
  "name": "--payload-json",
1453
1785
  "value": "<json>",
@@ -1455,14 +1787,38 @@
1455
1787
  "description": "mdkg db queue enqueue <queue> <message-id> --payload-json <json>|--payload-file <path> [--json]"
1456
1788
  },
1457
1789
  {
1458
- "name": "--root",
1459
- "value": null,
1790
+ "name": "--queue-policy",
1791
+ "value": "drain|paused",
1460
1792
  "required": false,
1461
- "description": "--root, -r <path> Run against a specific repo root"
1793
+ "description": "mdkg db snapshot seal [--queue-policy drain|paused] [--json]"
1462
1794
  },
1463
1795
  {
1464
- "name": "--version",
1465
- "value": null,
1796
+ "name": "--reason",
1797
+ "value": "<text>",
1798
+ "required": false,
1799
+ "description": "mdkg db queue create <queue> [--paused] [--reason <text>] [--json]"
1800
+ },
1801
+ {
1802
+ "name": "--root",
1803
+ "value": null,
1804
+ "required": false,
1805
+ "description": "--root, -r <path> Run against a specific repo root"
1806
+ },
1807
+ {
1808
+ "name": "--snapshot",
1809
+ "value": "<path>",
1810
+ "required": false,
1811
+ "description": "mdkg db snapshot dump [--snapshot <path>] [--output <path>] [--json]"
1812
+ },
1813
+ {
1814
+ "name": "--tolerant",
1815
+ "value": null,
1816
+ "required": false,
1817
+ "description": "mdkg db index rebuild [--tolerant] [--json]"
1818
+ },
1819
+ {
1820
+ "name": "--version",
1821
+ "value": null,
1466
1822
  "required": false,
1467
1823
  "description": "--version, -V Show version"
1468
1824
  }
@@ -1537,12 +1893,24 @@
1537
1893
  "required": false,
1538
1894
  "description": "--help, -h Show help"
1539
1895
  },
1896
+ {
1897
+ "name": "--json",
1898
+ "value": null,
1899
+ "required": false,
1900
+ "description": "mdkg db index rebuild [--tolerant] [--json]"
1901
+ },
1540
1902
  {
1541
1903
  "name": "--root",
1542
1904
  "value": null,
1543
1905
  "required": false,
1544
1906
  "description": "--root, -r <path> Run against a specific repo root"
1545
1907
  },
1908
+ {
1909
+ "name": "--tolerant",
1910
+ "value": null,
1911
+ "required": false,
1912
+ "description": "mdkg db index rebuild [--tolerant] [--json]"
1913
+ },
1546
1914
  {
1547
1915
  "name": "--version",
1548
1916
  "value": null,
@@ -1632,6 +2000,18 @@
1632
2000
  }
1633
2001
  ],
1634
2002
  "flags": [
2003
+ {
2004
+ "name": "--available-at-ms",
2005
+ "value": "<ms>",
2006
+ "required": false,
2007
+ "description": "mdkg db queue enqueue <queue> <message-id> --payload-json <json>|--payload-file <path> [--dedupe-key <key>] [--available-at-ms <ms>] [--max-attempts <n>] [--json]"
2008
+ },
2009
+ {
2010
+ "name": "--dedupe-key",
2011
+ "value": "<key>",
2012
+ "required": false,
2013
+ "description": "mdkg db queue enqueue <queue> <message-id> --payload-json <json>|--payload-file <path> [--dedupe-key <key>] [--available-at-ms <ms>] [--max-attempts <n>] [--json]"
2014
+ },
1635
2015
  {
1636
2016
  "name": "--error",
1637
2017
  "value": "<text>",
@@ -1644,6 +2024,12 @@
1644
2024
  "required": false,
1645
2025
  "description": "--help, -h Show help"
1646
2026
  },
2027
+ {
2028
+ "name": "--json",
2029
+ "value": null,
2030
+ "required": false,
2031
+ "description": "mdkg db queue create <queue> [--paused] [--reason <text>] [--json]"
2032
+ },
1647
2033
  {
1648
2034
  "name": "--lease-ms",
1649
2035
  "value": "<ms>",
@@ -1656,18 +2042,54 @@
1656
2042
  "required": false,
1657
2043
  "description": "mdkg db queue claim <queue> --lease-owner <owner> --lease-ms <ms> [--json]"
1658
2044
  },
2045
+ {
2046
+ "name": "--limit",
2047
+ "value": "<n>",
2048
+ "required": false,
2049
+ "description": "mdkg db queue list <queue> [--status ready|leased|acked|dead_letter|all] [--limit <n>] [--json]"
2050
+ },
2051
+ {
2052
+ "name": "--max-attempts",
2053
+ "value": "<n>",
2054
+ "required": false,
2055
+ "description": "mdkg db queue enqueue <queue> <message-id> --payload-json <json>|--payload-file <path> [--dedupe-key <key>] [--available-at-ms <ms>] [--max-attempts <n>] [--json]"
2056
+ },
2057
+ {
2058
+ "name": "--paused",
2059
+ "value": null,
2060
+ "required": false,
2061
+ "description": "mdkg db queue create <queue> [--paused] [--reason <text>] [--json]"
2062
+ },
1659
2063
  {
1660
2064
  "name": "--payload-json",
1661
2065
  "value": "<json>",
1662
2066
  "required": false,
1663
2067
  "description": "mdkg db queue enqueue <queue> <message-id> --payload-json <json>|--payload-file <path> [--dedupe-key <key>] [--available-at-ms <ms>] [--max-attempts <n>] [--json]"
1664
2068
  },
2069
+ {
2070
+ "name": "--reason",
2071
+ "value": "<text>",
2072
+ "required": false,
2073
+ "description": "mdkg db queue create <queue> [--paused] [--reason <text>] [--json]"
2074
+ },
2075
+ {
2076
+ "name": "--retry-after-ms",
2077
+ "value": "<ms>",
2078
+ "required": false,
2079
+ "description": "mdkg db queue fail <queue> <message-id> --lease-owner <owner> --error <text> [--retry-after-ms <ms>] [--json]"
2080
+ },
1665
2081
  {
1666
2082
  "name": "--root",
1667
2083
  "value": null,
1668
2084
  "required": false,
1669
2085
  "description": "--root, -r <path> Run against a specific repo root"
1670
2086
  },
2087
+ {
2088
+ "name": "--status",
2089
+ "value": "ready|leased|acked|dead_letter|all",
2090
+ "required": false,
2091
+ "description": "mdkg db queue list <queue> [--status ready|leased|acked|dead_letter|all] [--limit <n>] [--json]"
2092
+ },
1671
2093
  {
1672
2094
  "name": "--version",
1673
2095
  "value": null,
@@ -1757,12 +2179,36 @@
1757
2179
  "required": false,
1758
2180
  "description": "--help, -h Show help"
1759
2181
  },
2182
+ {
2183
+ "name": "--json",
2184
+ "value": null,
2185
+ "required": false,
2186
+ "description": "mdkg db snapshot seal [--queue-policy drain|paused] [--json]"
2187
+ },
2188
+ {
2189
+ "name": "--output",
2190
+ "value": "<path>",
2191
+ "required": false,
2192
+ "description": "mdkg db snapshot dump [--snapshot <path>] [--output <path>] [--json]"
2193
+ },
2194
+ {
2195
+ "name": "--queue-policy",
2196
+ "value": "drain|paused",
2197
+ "required": false,
2198
+ "description": "mdkg db snapshot seal [--queue-policy drain|paused] [--json]"
2199
+ },
1760
2200
  {
1761
2201
  "name": "--root",
1762
2202
  "value": null,
1763
2203
  "required": false,
1764
2204
  "description": "--root, -r <path> Run against a specific repo root"
1765
2205
  },
2206
+ {
2207
+ "name": "--snapshot",
2208
+ "value": "<path>",
2209
+ "required": false,
2210
+ "description": "mdkg db snapshot dump [--snapshot <path>] [--output <path>] [--json]"
2211
+ },
1766
2212
  {
1767
2213
  "name": "--version",
1768
2214
  "value": null,
@@ -1838,7 +2284,7 @@
1838
2284
  "name": "--json",
1839
2285
  "value": null,
1840
2286
  "required": false,
1841
- "description": "--json Emit machine-readable JSON output"
2287
+ "description": "mdkg doctor [--strict] [--json]"
1842
2288
  },
1843
2289
  {
1844
2290
  "name": "--root",
@@ -1850,7 +2296,7 @@
1850
2296
  "name": "--strict",
1851
2297
  "value": null,
1852
2298
  "required": false,
1853
- "description": "--strict Fail on stale selected-goal, DB, and generated cache health issues"
2299
+ "description": "mdkg doctor [--strict] [--json]"
1854
2300
  },
1855
2301
  {
1856
2302
  "name": "--version",
@@ -1924,6 +2370,12 @@
1924
2370
  "required": false,
1925
2371
  "description": "--help, -h Show help"
1926
2372
  },
2373
+ {
2374
+ "name": "--json",
2375
+ "value": null,
2376
+ "required": false,
2377
+ "description": "mdkg event enable [--ws <alias>] [--json]"
2378
+ },
1927
2379
  {
1928
2380
  "name": "--kind",
1929
2381
  "value": "<kind>",
@@ -1953,6 +2405,12 @@
1953
2405
  "value": null,
1954
2406
  "required": false,
1955
2407
  "description": "--version, -V Show version"
2408
+ },
2409
+ {
2410
+ "name": "--ws",
2411
+ "value": "<alias>",
2412
+ "required": false,
2413
+ "description": "mdkg event enable [--ws <alias>] [--json]"
1956
2414
  }
1957
2415
  ],
1958
2416
  "output_formats": [
@@ -2013,22 +2471,46 @@
2013
2471
  ],
2014
2472
  "args": [],
2015
2473
  "flags": [
2474
+ {
2475
+ "name": "--agent",
2476
+ "value": "<name>",
2477
+ "required": false,
2478
+ "description": "[--agent <name>] [--skill <slug>] [--tool <id>]"
2479
+ },
2480
+ {
2481
+ "name": "--artifacts",
2482
+ "value": "<a,...>",
2483
+ "required": false,
2484
+ "description": "[--ws <alias>] [--artifacts <a,...>] [--notes \"<text>\"] [--run-id <id>] [--json]"
2485
+ },
2016
2486
  {
2017
2487
  "name": "--help",
2018
2488
  "value": null,
2019
2489
  "required": false,
2020
2490
  "description": "--help, -h Show help"
2021
2491
  },
2492
+ {
2493
+ "name": "--json",
2494
+ "value": null,
2495
+ "required": false,
2496
+ "description": "[--ws <alias>] [--artifacts <a,...>] [--notes \"<text>\"] [--run-id <id>] [--json]"
2497
+ },
2022
2498
  {
2023
2499
  "name": "--kind",
2024
2500
  "value": "<kind>",
2025
- "required": false,
2501
+ "required": true,
2026
2502
  "description": "mdkg event append --kind <kind> --status <ok|error|retry|skipped> --refs <id,...>"
2027
2503
  },
2504
+ {
2505
+ "name": "--notes",
2506
+ "value": "\"<text>\"",
2507
+ "required": false,
2508
+ "description": "[--ws <alias>] [--artifacts <a,...>] [--notes \"<text>\"] [--run-id <id>] [--json]"
2509
+ },
2028
2510
  {
2029
2511
  "name": "--refs",
2030
2512
  "value": "<id,...>",
2031
- "required": false,
2513
+ "required": true,
2032
2514
  "description": "mdkg event append --kind <kind> --status <ok|error|retry|skipped> --refs <id,...>"
2033
2515
  },
2034
2516
  {
@@ -2037,17 +2519,41 @@
2037
2519
  "required": false,
2038
2520
  "description": "--root, -r <path> Run against a specific repo root"
2039
2521
  },
2522
+ {
2523
+ "name": "--run-id",
2524
+ "value": "<id>",
2525
+ "required": false,
2526
+ "description": "[--ws <alias>] [--artifacts <a,...>] [--notes \"<text>\"] [--run-id <id>] [--json]"
2527
+ },
2528
+ {
2529
+ "name": "--skill",
2530
+ "value": "<slug>",
2531
+ "required": false,
2532
+ "description": "[--agent <name>] [--skill <slug>] [--tool <id>]"
2533
+ },
2040
2534
  {
2041
2535
  "name": "--status",
2042
2536
  "value": "<ok|error|retry|skipped>",
2043
- "required": false,
2537
+ "required": true,
2044
2538
  "description": "mdkg event append --kind <kind> --status <ok|error|retry|skipped> --refs <id,...>"
2045
2539
  },
2540
+ {
2541
+ "name": "--tool",
2542
+ "value": "<id>",
2543
+ "required": false,
2544
+ "description": "[--agent <name>] [--skill <slug>] [--tool <id>]"
2545
+ },
2046
2546
  {
2047
2547
  "name": "--version",
2048
2548
  "value": null,
2049
2549
  "required": false,
2050
2550
  "description": "--version, -V Show version"
2551
+ },
2552
+ {
2553
+ "name": "--ws",
2554
+ "value": "<alias>",
2555
+ "required": false,
2556
+ "description": "[--ws <alias>] [--artifacts <a,...>] [--notes \"<text>\"] [--run-id <id>] [--json]"
2051
2557
  }
2052
2558
  ],
2053
2559
  "output_formats": [
@@ -2113,6 +2619,12 @@
2113
2619
  "required": false,
2114
2620
  "description": "--help, -h Show help"
2115
2621
  },
2622
+ {
2623
+ "name": "--json",
2624
+ "value": null,
2625
+ "required": false,
2626
+ "description": "mdkg event enable [--ws <alias>] [--json]"
2627
+ },
2116
2628
  {
2117
2629
  "name": "--root",
2118
2630
  "value": null,
@@ -2124,6 +2636,12 @@
2124
2636
  "value": null,
2125
2637
  "required": false,
2126
2638
  "description": "--version, -V Show version"
2639
+ },
2640
+ {
2641
+ "name": "--ws",
2642
+ "value": "<alias>",
2643
+ "required": false,
2644
+ "description": "mdkg event enable [--ws <alias>] [--json]"
2127
2645
  }
2128
2646
  ],
2129
2647
  "output_formats": [
@@ -2184,18 +2702,48 @@
2184
2702
  ],
2185
2703
  "args": [],
2186
2704
  "flags": [
2705
+ {
2706
+ "name": "--apply",
2707
+ "value": null,
2708
+ "required": false,
2709
+ "description": "mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
2710
+ },
2711
+ {
2712
+ "name": "--base-ref",
2713
+ "value": "<ref>",
2714
+ "required": false,
2715
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2716
+ },
2717
+ {
2718
+ "name": "--family",
2719
+ "value": "index|refs|ids|all",
2720
+ "required": false,
2721
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2722
+ },
2187
2723
  {
2188
2724
  "name": "--help",
2189
2725
  "value": null,
2190
2726
  "required": false,
2191
2727
  "description": "--help, -h Show help"
2192
2728
  },
2729
+ {
2730
+ "name": "--json",
2731
+ "value": null,
2732
+ "required": false,
2733
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2734
+ },
2193
2735
  {
2194
2736
  "name": "--root",
2195
2737
  "value": null,
2196
2738
  "required": false,
2197
2739
  "description": "--root, -r <path> Run against a specific repo root"
2198
2740
  },
2741
+ {
2742
+ "name": "--target",
2743
+ "value": "<id-or-qid>",
2744
+ "required": false,
2745
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2746
+ },
2199
2747
  {
2200
2748
  "name": "--version",
2201
2749
  "value": null,
@@ -2262,13 +2810,13 @@
2262
2810
  "name": "--base-ref",
2263
2811
  "value": "<ref>",
2264
2812
  "required": false,
2265
- "description": "--base-ref <ref> Prefer IDs that already exist at a Git base ref"
2813
+ "description": "mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2266
2814
  },
2267
2815
  {
2268
2816
  "name": "--family",
2269
2817
  "value": "ids",
2270
2818
  "required": false,
2271
- "description": "--family ids Explicit apply family; ids is the only supported apply family"
2819
+ "description": "mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2272
2820
  },
2273
2821
  {
2274
2822
  "name": "--help",
@@ -2280,7 +2828,7 @@
2280
2828
  "name": "--json",
2281
2829
  "value": null,
2282
2830
  "required": false,
2283
- "description": "--json Emit machine-readable JSON output"
2831
+ "description": "mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2284
2832
  },
2285
2833
  {
2286
2834
  "name": "--root",
@@ -2292,7 +2840,7 @@
2292
2840
  "name": "--target",
2293
2841
  "value": "<id-or-qid>",
2294
2842
  "required": false,
2295
- "description": "--target <id-or-qid> Optional duplicate ID target"
2843
+ "description": "mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2296
2844
  },
2297
2845
  {
2298
2846
  "name": "--version",
@@ -2364,15 +2912,15 @@
2364
2912
  "flags": [
2365
2913
  {
2366
2914
  "name": "--apply",
2367
- "value": "it",
2915
+ "value": null,
2368
2916
  "required": false,
2369
- "description": "- without --apply it is equivalent to `mdkg fix plan --family ids`"
2917
+ "description": "mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
2370
2918
  },
2371
2919
  {
2372
2920
  "name": "--base-ref",
2373
2921
  "value": "<ref>",
2374
2922
  "required": false,
2375
- "description": "--base-ref <ref> Prefer IDs that already exist at a Git base ref"
2923
+ "description": "mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
2376
2924
  },
2377
2925
  {
2378
2926
  "name": "--family",
@@ -2390,7 +2938,7 @@
2390
2938
  "name": "--json",
2391
2939
  "value": null,
2392
2940
  "required": false,
2393
- "description": "--json Emit machine-readable JSON output"
2941
+ "description": "mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
2394
2942
  },
2395
2943
  {
2396
2944
  "name": "--root",
@@ -2402,7 +2950,7 @@
2402
2950
  "name": "--target",
2403
2951
  "value": "<id-or-qid>",
2404
2952
  "required": false,
2405
- "description": "--target <id-or-qid> Optional duplicate ID target"
2953
+ "description": "mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
2406
2954
  },
2407
2955
  {
2408
2956
  "name": "--version",
@@ -2479,13 +3027,13 @@
2479
3027
  "name": "--base-ref",
2480
3028
  "value": "<ref>",
2481
3029
  "required": false,
2482
- "description": "--base-ref <ref> Prefer IDs that already exist at a Git base ref"
3030
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2483
3031
  },
2484
3032
  {
2485
3033
  "name": "--family",
2486
- "value": "ids`",
3034
+ "value": "index|refs|ids|all",
2487
3035
  "required": false,
2488
- "description": "- ids-family duplicate-id repairs can be applied with `mdkg fix apply --family ids`"
3036
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2489
3037
  },
2490
3038
  {
2491
3039
  "name": "--help",
@@ -2497,7 +3045,7 @@
2497
3045
  "name": "--json",
2498
3046
  "value": null,
2499
3047
  "required": false,
2500
- "description": "--json Emit machine-readable JSON output"
3048
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2501
3049
  },
2502
3050
  {
2503
3051
  "name": "--root",
@@ -2509,7 +3057,7 @@
2509
3057
  "name": "--target",
2510
3058
  "value": "<id-or-qid>",
2511
3059
  "required": false,
2512
- "description": "--target <id-or-qid> Optional node target for family planners"
3060
+ "description": "mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
2513
3061
  },
2514
3062
  {
2515
3063
  "name": "--version",
@@ -2594,11 +3142,17 @@
2594
3142
  "required": false,
2595
3143
  "description": "--help, -h Show help"
2596
3144
  },
3145
+ {
3146
+ "name": "--json",
3147
+ "value": null,
3148
+ "required": false,
3149
+ "description": "mdkg format --headings [--dry-run|--apply] [--summary] [--limit <n>] [--json]"
3150
+ },
2597
3151
  {
2598
3152
  "name": "--limit",
2599
- "value": "controls",
3153
+ "value": "<n>",
2600
3154
  "required": false,
2601
- "description": "--summary emits bounded heading-change samples for agent/CI logs; --limit controls the sample size."
3155
+ "description": "mdkg format --headings [--dry-run|--apply] [--summary] [--limit <n>] [--json]"
2602
3156
  },
2603
3157
  {
2604
3158
  "name": "--root",
@@ -2608,9 +3162,9 @@
2608
3162
  },
2609
3163
  {
2610
3164
  "name": "--summary",
2611
- "value": "emits",
3165
+ "value": null,
2612
3166
  "required": false,
2613
- "description": "--summary emits bounded heading-change samples for agent/CI logs; --limit controls the sample size."
3167
+ "description": "mdkg format --headings [--dry-run|--apply] [--summary] [--limit <n>] [--json]"
2614
3168
  },
2615
3169
  {
2616
3170
  "name": "--version",
@@ -2676,6 +3230,7 @@
2676
3230
  "summary": "mdkg git command",
2677
3231
  "usage": [
2678
3232
  " mdkg git inspect [--json]",
3233
+ " mdkg git materialize --request <file|-> [--json]",
2679
3234
  " mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]",
2680
3235
  " mdkg git fetch [--remote <name>] [--branch <name>] [--json]",
2681
3236
  " mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]",
@@ -2694,7 +3249,7 @@
2694
3249
  "name": "--branch",
2695
3250
  "value": "<name>",
2696
3251
  "required": false,
2697
- "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3252
+ "description": "mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
2698
3253
  },
2699
3254
  {
2700
3255
  "name": "--help",
@@ -2703,16 +3258,34 @@
2703
3258
  "description": "--help, -h Show help"
2704
3259
  },
2705
3260
  {
2706
- "name": "--message",
2707
- "value": "<text>",
3261
+ "name": "--json",
3262
+ "value": null,
2708
3263
  "required": false,
2709
- "description": "mdkg git push --remote <name> --branch <name> [--stage-all --message <text>] [--json]"
3264
+ "description": "mdkg git inspect [--json]"
3265
+ },
3266
+ {
3267
+ "name": "--output",
3268
+ "value": "<path>",
3269
+ "required": false,
3270
+ "description": "mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
3271
+ },
3272
+ {
3273
+ "name": "--queue-policy",
3274
+ "value": "drain|paused",
3275
+ "required": false,
3276
+ "description": "mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
2710
3277
  },
2711
3278
  {
2712
3279
  "name": "--remote",
2713
3280
  "value": "<name>",
2714
3281
  "required": false,
2715
- "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3282
+ "description": "mdkg git fetch [--remote <name>] [--branch <name>] [--json]"
3283
+ },
3284
+ {
3285
+ "name": "--request",
3286
+ "value": "<file|->",
3287
+ "required": false,
3288
+ "description": "mdkg git materialize --request <file|-> [--json]"
2716
3289
  },
2717
3290
  {
2718
3291
  "name": "--root",
@@ -2720,6 +3293,12 @@
2720
3293
  "required": false,
2721
3294
  "description": "--root, -r <path> Run against a specific repo root"
2722
3295
  },
3296
+ {
3297
+ "name": "--stage-all",
3298
+ "value": null,
3299
+ "required": false,
3300
+ "description": "mdkg git push --remote <name> --branch <name> [--stage-all --message <text>] [--json]"
3301
+ },
2723
3302
  {
2724
3303
  "name": "--target",
2725
3304
  "value": "<path>",
@@ -2774,8 +3353,8 @@
2774
3353
  ],
2775
3354
  "examples": [
2776
3355
  " mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]",
2777
- " mdkg git fetch [--remote <name>] [--branch <name>] [--json]",
2778
- " mdkg git inspect [--json]"
3356
+ " mdkg git inspect [--json]",
3357
+ " mdkg git materialize --request <file|-> [--json]"
2779
3358
  ],
2780
3359
  "docs": {
2781
3360
  "help_target": "mdkg help git",
@@ -2803,12 +3382,24 @@
2803
3382
  }
2804
3383
  ],
2805
3384
  "flags": [
3385
+ {
3386
+ "name": "--branch",
3387
+ "value": "<name>",
3388
+ "required": false,
3389
+ "description": "mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
3390
+ },
2806
3391
  {
2807
3392
  "name": "--help",
2808
3393
  "value": null,
2809
3394
  "required": false,
2810
3395
  "description": "--help, -h Show help"
2811
3396
  },
3397
+ {
3398
+ "name": "--json",
3399
+ "value": null,
3400
+ "required": false,
3401
+ "description": "mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
3402
+ },
2812
3403
  {
2813
3404
  "name": "--root",
2814
3405
  "value": null,
@@ -2818,7 +3409,7 @@
2818
3409
  {
2819
3410
  "name": "--target",
2820
3411
  "value": "<path>",
2821
- "required": false,
3412
+ "required": true,
2822
3413
  "description": "mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
2823
3414
  },
2824
3415
  {
@@ -2891,6 +3482,24 @@
2891
3482
  "required": false,
2892
3483
  "description": "--help, -h Show help"
2893
3484
  },
3485
+ {
3486
+ "name": "--json",
3487
+ "value": null,
3488
+ "required": false,
3489
+ "description": "mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
3490
+ },
3491
+ {
3492
+ "name": "--output",
3493
+ "value": "<path>",
3494
+ "required": false,
3495
+ "description": "mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
3496
+ },
3497
+ {
3498
+ "name": "--queue-policy",
3499
+ "value": "drain|paused",
3500
+ "required": false,
3501
+ "description": "mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
3502
+ },
2894
3503
  {
2895
3504
  "name": "--root",
2896
3505
  "value": null,
@@ -2963,12 +3572,30 @@
2963
3572
  ],
2964
3573
  "args": [],
2965
3574
  "flags": [
3575
+ {
3576
+ "name": "--branch",
3577
+ "value": "<name>",
3578
+ "required": false,
3579
+ "description": "mdkg git fetch [--remote <name>] [--branch <name>] [--json]"
3580
+ },
2966
3581
  {
2967
3582
  "name": "--help",
2968
3583
  "value": null,
2969
3584
  "required": false,
2970
3585
  "description": "--help, -h Show help"
2971
3586
  },
3587
+ {
3588
+ "name": "--json",
3589
+ "value": null,
3590
+ "required": false,
3591
+ "description": "mdkg git fetch [--remote <name>] [--branch <name>] [--json]"
3592
+ },
3593
+ {
3594
+ "name": "--remote",
3595
+ "value": "<name>",
3596
+ "required": false,
3597
+ "description": "mdkg git fetch [--remote <name>] [--branch <name>] [--json]"
3598
+ },
2972
3599
  {
2973
3600
  "name": "--root",
2974
3601
  "value": null,
@@ -3045,6 +3672,12 @@
3045
3672
  "required": false,
3046
3673
  "description": "--help, -h Show help"
3047
3674
  },
3675
+ {
3676
+ "name": "--json",
3677
+ "value": null,
3678
+ "required": false,
3679
+ "description": "mdkg git inspect [--json]"
3680
+ },
3048
3681
  {
3049
3682
  "name": "--root",
3050
3683
  "value": null,
@@ -3099,17 +3732,106 @@
3099
3732
  }
3100
3733
  },
3101
3734
  {
3102
- "key": "git push",
3735
+ "key": "git materialize",
3103
3736
  "path": [
3104
3737
  "git",
3105
- "push"
3738
+ "materialize"
3106
3739
  ],
3107
3740
  "category": "git",
3108
3741
  "status": "stable",
3109
3742
  "visibility": "public",
3110
- "summary": "mdkg git push command",
3743
+ "summary": "mdkg git materialize command",
3111
3744
  "usage": [
3112
- " mdkg git push --remote <name> --branch <name> [--json]",
3745
+ " mdkg git materialize --request <file|-> [--json]"
3746
+ ],
3747
+ "args": [],
3748
+ "flags": [
3749
+ {
3750
+ "name": "--help",
3751
+ "value": null,
3752
+ "required": false,
3753
+ "description": "--help, -h Show help"
3754
+ },
3755
+ {
3756
+ "name": "--json",
3757
+ "value": null,
3758
+ "required": false,
3759
+ "description": "mdkg git materialize --request <file|-> [--json]"
3760
+ },
3761
+ {
3762
+ "name": "--request",
3763
+ "value": "<file|->",
3764
+ "required": true,
3765
+ "description": "mdkg git materialize --request <file|-> [--json]"
3766
+ },
3767
+ {
3768
+ "name": "--root",
3769
+ "value": null,
3770
+ "required": false,
3771
+ "description": "--root, -r <path> Run against a specific repo root"
3772
+ },
3773
+ {
3774
+ "name": "--version",
3775
+ "value": null,
3776
+ "required": false,
3777
+ "description": "--version, -V Show version"
3778
+ }
3779
+ ],
3780
+ "output_formats": [
3781
+ "text",
3782
+ "json"
3783
+ ],
3784
+ "json_schema_ref": "mdkg.git.materialize.receipt.v1",
3785
+ "side_effects": [
3786
+ "materialize-verified-git-source-into-contained-destination"
3787
+ ],
3788
+ "read_paths": [
3789
+ "<remote-git-objects>",
3790
+ "<request-file-or-stdin>"
3791
+ ],
3792
+ "write_paths": [
3793
+ "<destination>/**"
3794
+ ],
3795
+ "dry_run": {
3796
+ "supported": false
3797
+ },
3798
+ "lock_policy": "not-required-for-contained-destination",
3799
+ "atomic_write_policy": "same-parent-temporary-tree-rename-after-verification",
3800
+ "receipts": [
3801
+ "mdkg.git.materialize.receipt.v1"
3802
+ ],
3803
+ "danger_level": "moderate",
3804
+ "aliases": [],
3805
+ "exit_codes": [
3806
+ {
3807
+ "code": 0,
3808
+ "meaning": "success"
3809
+ },
3810
+ {
3811
+ "code": 1,
3812
+ "meaning": "validation-or-runtime-error"
3813
+ }
3814
+ ],
3815
+ "examples": [
3816
+ " mdkg git materialize --request <file|-> [--json]"
3817
+ ],
3818
+ "docs": {
3819
+ "help_target": "mdkg help git materialize",
3820
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
3821
+ }
3822
+ },
3823
+ {
3824
+ "key": "git push",
3825
+ "path": [
3826
+ "git",
3827
+ "push"
3828
+ ],
3829
+ "category": "git",
3830
+ "status": "stable",
3831
+ "visibility": "public",
3832
+ "summary": "mdkg git push command",
3833
+ "usage": [
3834
+ " mdkg git push --remote <name> --branch <name> [--json]",
3113
3835
  " mdkg git push --remote <name> --branch <name> --stage-all --message <text> [--queue-policy drain|paused] [--json]"
3114
3836
  ],
3115
3837
  "args": [],
@@ -3117,7 +3839,7 @@
3117
3839
  {
3118
3840
  "name": "--branch",
3119
3841
  "value": "<name>",
3120
- "required": false,
3842
+ "required": true,
3121
3843
  "description": "mdkg git push --remote <name> --branch <name> [--json]"
3122
3844
  },
3123
3845
  {
@@ -3126,16 +3848,28 @@
3126
3848
  "required": false,
3127
3849
  "description": "--help, -h Show help"
3128
3850
  },
3851
+ {
3852
+ "name": "--json",
3853
+ "value": null,
3854
+ "required": false,
3855
+ "description": "mdkg git push --remote <name> --branch <name> [--json]"
3856
+ },
3129
3857
  {
3130
3858
  "name": "--message",
3131
3859
  "value": null,
3132
3860
  "required": false,
3133
3861
  "description": "- --stage-all writes closeout evidence, stages all changes, commits with --message, then runs push-ready before pushing"
3134
3862
  },
3863
+ {
3864
+ "name": "--queue-policy",
3865
+ "value": "drain|paused",
3866
+ "required": false,
3867
+ "description": "mdkg git push --remote <name> --branch <name> --stage-all --message <text> [--queue-policy drain|paused] [--json]"
3868
+ },
3135
3869
  {
3136
3870
  "name": "--remote",
3137
3871
  "value": "<name>",
3138
- "required": false,
3872
+ "required": true,
3139
3873
  "description": "mdkg git push --remote <name> --branch <name> [--json]"
3140
3874
  },
3141
3875
  {
@@ -3221,7 +3955,7 @@
3221
3955
  {
3222
3956
  "name": "--branch",
3223
3957
  "value": "<name>",
3224
- "required": false,
3958
+ "required": true,
3225
3959
  "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3226
3960
  },
3227
3961
  {
@@ -3230,10 +3964,16 @@
3230
3964
  "required": false,
3231
3965
  "description": "--help, -h Show help"
3232
3966
  },
3967
+ {
3968
+ "name": "--json",
3969
+ "value": null,
3970
+ "required": false,
3971
+ "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3972
+ },
3233
3973
  {
3234
3974
  "name": "--remote",
3235
3975
  "value": "<name>",
3236
- "required": false,
3976
+ "required": true,
3237
3977
  "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3238
3978
  },
3239
3979
  {
@@ -3464,6 +4204,12 @@
3464
4204
  "required": false,
3465
4205
  "description": "--help, -h Show help"
3466
4206
  },
4207
+ {
4208
+ "name": "--json",
4209
+ "value": null,
4210
+ "required": false,
4211
+ "description": "mdkg goal show <goal-id-or-qid> [--json]"
4212
+ },
3467
4213
  {
3468
4214
  "name": "--root",
3469
4215
  "value": null,
@@ -3549,6 +4295,12 @@
3549
4295
  "required": false,
3550
4296
  "description": "--help, -h Show help"
3551
4297
  },
4298
+ {
4299
+ "name": "--json",
4300
+ "value": null,
4301
+ "required": false,
4302
+ "description": "mdkg goal activate <goal-id-or-qid> [--ws <alias>] [--json]"
4303
+ },
3552
4304
  {
3553
4305
  "name": "--root",
3554
4306
  "value": null,
@@ -3560,6 +4312,12 @@
3560
4312
  "value": null,
3561
4313
  "required": false,
3562
4314
  "description": "--version, -V Show version"
4315
+ },
4316
+ {
4317
+ "name": "--ws",
4318
+ "value": "<alias>",
4319
+ "required": false,
4320
+ "description": "mdkg goal activate <goal-id-or-qid> [--ws <alias>] [--json]"
3563
4321
  }
3564
4322
  ],
3565
4323
  "output_formats": [
@@ -3632,6 +4390,12 @@
3632
4390
  "required": false,
3633
4391
  "description": "--help, -h Show help"
3634
4392
  },
4393
+ {
4394
+ "name": "--json",
4395
+ "value": null,
4396
+ "required": false,
4397
+ "description": "mdkg goal archive <goal-id-or-qid> [--ws <alias>] [--json]"
4398
+ },
3635
4399
  {
3636
4400
  "name": "--root",
3637
4401
  "value": null,
@@ -3643,6 +4407,12 @@
3643
4407
  "value": null,
3644
4408
  "required": false,
3645
4409
  "description": "--version, -V Show version"
4410
+ },
4411
+ {
4412
+ "name": "--ws",
4413
+ "value": "<alias>",
4414
+ "required": false,
4415
+ "description": "mdkg goal archive <goal-id-or-qid> [--ws <alias>] [--json]"
3646
4416
  }
3647
4417
  ],
3648
4418
  "output_formats": [
@@ -3721,6 +4491,12 @@
3721
4491
  "required": false,
3722
4492
  "description": "--help, -h Show help"
3723
4493
  },
4494
+ {
4495
+ "name": "--json",
4496
+ "value": null,
4497
+ "required": false,
4498
+ "description": "mdkg goal claim <work-id-or-qid> [--ws <alias>] [--json]"
4499
+ },
3724
4500
  {
3725
4501
  "name": "--root",
3726
4502
  "value": null,
@@ -3732,6 +4508,12 @@
3732
4508
  "value": null,
3733
4509
  "required": false,
3734
4510
  "description": "--version, -V Show version"
4511
+ },
4512
+ {
4513
+ "name": "--ws",
4514
+ "value": "<alias>",
4515
+ "required": false,
4516
+ "description": "mdkg goal claim <work-id-or-qid> [--ws <alias>] [--json]"
3735
4517
  }
3736
4518
  ],
3737
4519
  "output_formats": [
@@ -3799,6 +4581,12 @@
3799
4581
  "required": false,
3800
4582
  "description": "--help, -h Show help"
3801
4583
  },
4584
+ {
4585
+ "name": "--json",
4586
+ "value": null,
4587
+ "required": false,
4588
+ "description": "mdkg goal clear [--json]"
4589
+ },
3802
4590
  {
3803
4591
  "name": "--root",
3804
4592
  "value": null,
@@ -3876,6 +4664,12 @@
3876
4664
  "required": false,
3877
4665
  "description": "--help, -h Show help"
3878
4666
  },
4667
+ {
4668
+ "name": "--json",
4669
+ "value": null,
4670
+ "required": false,
4671
+ "description": "mdkg goal current [--ws <alias>] [--json]"
4672
+ },
3879
4673
  {
3880
4674
  "name": "--root",
3881
4675
  "value": null,
@@ -3887,6 +4681,12 @@
3887
4681
  "value": null,
3888
4682
  "required": false,
3889
4683
  "description": "--version, -V Show version"
4684
+ },
4685
+ {
4686
+ "name": "--ws",
4687
+ "value": "<alias>",
4688
+ "required": false,
4689
+ "description": "mdkg goal current [--ws <alias>] [--json]"
3890
4690
  }
3891
4691
  ],
3892
4692
  "output_formats": [
@@ -3954,6 +4754,12 @@
3954
4754
  "required": false,
3955
4755
  "description": "--help, -h Show help"
3956
4756
  },
4757
+ {
4758
+ "name": "--json",
4759
+ "value": null,
4760
+ "required": false,
4761
+ "description": "mdkg goal done <goal-id-or-qid> [--ws <alias>] [--json]"
4762
+ },
3957
4763
  {
3958
4764
  "name": "--root",
3959
4765
  "value": null,
@@ -3965,6 +4771,12 @@
3965
4771
  "value": null,
3966
4772
  "required": false,
3967
4773
  "description": "--version, -V Show version"
4774
+ },
4775
+ {
4776
+ "name": "--ws",
4777
+ "value": "<alias>",
4778
+ "required": false,
4779
+ "description": "mdkg goal done <goal-id-or-qid> [--ws <alias>] [--json]"
3968
4780
  }
3969
4781
  ],
3970
4782
  "output_formats": [
@@ -4037,6 +4849,12 @@
4037
4849
  "required": false,
4038
4850
  "description": "--help, -h Show help"
4039
4851
  },
4852
+ {
4853
+ "name": "--json",
4854
+ "value": null,
4855
+ "required": false,
4856
+ "description": "mdkg goal evaluate <goal-id-or-qid> [--ws <alias>] [--json]"
4857
+ },
4040
4858
  {
4041
4859
  "name": "--root",
4042
4860
  "value": null,
@@ -4048,6 +4866,12 @@
4048
4866
  "value": null,
4049
4867
  "required": false,
4050
4868
  "description": "--version, -V Show version"
4869
+ },
4870
+ {
4871
+ "name": "--ws",
4872
+ "value": "<alias>",
4873
+ "required": false,
4874
+ "description": "mdkg goal evaluate <goal-id-or-qid> [--ws <alias>] [--json]"
4051
4875
  }
4052
4876
  ],
4053
4877
  "output_formats": [
@@ -4115,6 +4939,12 @@
4115
4939
  "required": false,
4116
4940
  "description": "--help, -h Show help"
4117
4941
  },
4942
+ {
4943
+ "name": "--json",
4944
+ "value": null,
4945
+ "required": false,
4946
+ "description": "mdkg goal next [goal-id-or-qid] [--ws <alias>] [--json]"
4947
+ },
4118
4948
  {
4119
4949
  "name": "--root",
4120
4950
  "value": null,
@@ -4126,6 +4956,12 @@
4126
4956
  "value": null,
4127
4957
  "required": false,
4128
4958
  "description": "--version, -V Show version"
4959
+ },
4960
+ {
4961
+ "name": "--ws",
4962
+ "value": "<alias>",
4963
+ "required": false,
4964
+ "description": "mdkg goal next [goal-id-or-qid] [--ws <alias>] [--json]"
4129
4965
  }
4130
4966
  ],
4131
4967
  "output_formats": [
@@ -4193,6 +5029,12 @@
4193
5029
  "required": false,
4194
5030
  "description": "--help, -h Show help"
4195
5031
  },
5032
+ {
5033
+ "name": "--json",
5034
+ "value": null,
5035
+ "required": false,
5036
+ "description": "mdkg goal pause <goal-id-or-qid> [--ws <alias>] [--json]"
5037
+ },
4196
5038
  {
4197
5039
  "name": "--root",
4198
5040
  "value": null,
@@ -4204,6 +5046,12 @@
4204
5046
  "value": null,
4205
5047
  "required": false,
4206
5048
  "description": "--version, -V Show version"
5049
+ },
5050
+ {
5051
+ "name": "--ws",
5052
+ "value": "<alias>",
5053
+ "required": false,
5054
+ "description": "mdkg goal pause <goal-id-or-qid> [--ws <alias>] [--json]"
4207
5055
  }
4208
5056
  ],
4209
5057
  "output_formats": [
@@ -4276,6 +5124,12 @@
4276
5124
  "required": false,
4277
5125
  "description": "--help, -h Show help"
4278
5126
  },
5127
+ {
5128
+ "name": "--json",
5129
+ "value": null,
5130
+ "required": false,
5131
+ "description": "mdkg goal resume <goal-id-or-qid> [--ws <alias>] [--json]"
5132
+ },
4279
5133
  {
4280
5134
  "name": "--root",
4281
5135
  "value": null,
@@ -4287,6 +5141,12 @@
4287
5141
  "value": null,
4288
5142
  "required": false,
4289
5143
  "description": "--version, -V Show version"
5144
+ },
5145
+ {
5146
+ "name": "--ws",
5147
+ "value": "<alias>",
5148
+ "required": false,
5149
+ "description": "mdkg goal resume <goal-id-or-qid> [--ws <alias>] [--json]"
4290
5150
  }
4291
5151
  ],
4292
5152
  "output_formats": [
@@ -4359,6 +5219,12 @@
4359
5219
  "required": false,
4360
5220
  "description": "--help, -h Show help"
4361
5221
  },
5222
+ {
5223
+ "name": "--json",
5224
+ "value": null,
5225
+ "required": false,
5226
+ "description": "mdkg goal select <goal-id-or-qid> [--ws <alias>] [--json]"
5227
+ },
4362
5228
  {
4363
5229
  "name": "--root",
4364
5230
  "value": null,
@@ -4370,6 +5236,12 @@
4370
5236
  "value": null,
4371
5237
  "required": false,
4372
5238
  "description": "--version, -V Show version"
5239
+ },
5240
+ {
5241
+ "name": "--ws",
5242
+ "value": "<alias>",
5243
+ "required": false,
5244
+ "description": "mdkg goal select <goal-id-or-qid> [--ws <alias>] [--json]"
4373
5245
  }
4374
5246
  ],
4375
5247
  "output_formats": [
@@ -4442,6 +5314,12 @@
4442
5314
  "required": false,
4443
5315
  "description": "--help, -h Show help"
4444
5316
  },
5317
+ {
5318
+ "name": "--json",
5319
+ "value": null,
5320
+ "required": false,
5321
+ "description": "mdkg goal show <goal-id-or-qid> [--ws <alias>] [--json]"
5322
+ },
4445
5323
  {
4446
5324
  "name": "--root",
4447
5325
  "value": null,
@@ -4453,6 +5331,12 @@
4453
5331
  "value": null,
4454
5332
  "required": false,
4455
5333
  "description": "--version, -V Show version"
5334
+ },
5335
+ {
5336
+ "name": "--ws",
5337
+ "value": "<alias>",
5338
+ "required": false,
5339
+ "description": "mdkg goal show <goal-id-or-qid> [--ws <alias>] [--json]"
4456
5340
  }
4457
5341
  ],
4458
5342
  "output_formats": [
@@ -4521,18 +5405,54 @@
4521
5405
  }
4522
5406
  ],
4523
5407
  "flags": [
5408
+ {
5409
+ "name": "--apply",
5410
+ "value": null,
5411
+ "required": false,
5412
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5413
+ },
5414
+ {
5415
+ "name": "--dry-run",
5416
+ "value": null,
5417
+ "required": false,
5418
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5419
+ },
4524
5420
  {
4525
5421
  "name": "--help",
4526
5422
  "value": null,
4527
5423
  "required": false,
4528
5424
  "description": "--help, -h Show help"
4529
5425
  },
5426
+ {
5427
+ "name": "--id-prefix",
5428
+ "value": "<prefix>",
5429
+ "required": false,
5430
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5431
+ },
5432
+ {
5433
+ "name": "--json",
5434
+ "value": null,
5435
+ "required": false,
5436
+ "description": "mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
5437
+ },
4530
5438
  {
4531
5439
  "name": "--root",
4532
5440
  "value": null,
4533
5441
  "required": false,
4534
5442
  "description": "--root, -r <path> Run against a specific repo root"
4535
5443
  },
5444
+ {
5445
+ "name": "--select-goal",
5446
+ "value": null,
5447
+ "required": false,
5448
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5449
+ },
5450
+ {
5451
+ "name": "--start-goal",
5452
+ "value": "<goal-id>",
5453
+ "required": false,
5454
+ "description": "mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
5455
+ },
4536
5456
  {
4537
5457
  "name": "--target",
4538
5458
  "value": "<path>",
@@ -4544,6 +5464,12 @@
4544
5464
  "value": null,
4545
5465
  "required": false,
4546
5466
  "description": "--version, -V Show version"
5467
+ },
5468
+ {
5469
+ "name": "--ws",
5470
+ "value": "<alias>",
5471
+ "required": false,
5472
+ "description": "mdkg graph refs <id-or-qid> [--ws <alias>] [--json]"
4547
5473
  }
4548
5474
  ],
4549
5475
  "output_formats": [
@@ -4614,15 +5540,21 @@
4614
5540
  "description": "--help, -h Show help"
4615
5541
  },
4616
5542
  {
4617
- "name": "--root",
5543
+ "name": "--json",
4618
5544
  "value": null,
4619
5545
  "required": false,
4620
- "description": "--root, -r <path> Run against a specific repo root"
5546
+ "description": "mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
5547
+ },
5548
+ {
5549
+ "name": "--root",
5550
+ "value": null,
5551
+ "required": false,
5552
+ "description": "--root, -r <path> Run against a specific repo root"
4621
5553
  },
4622
5554
  {
4623
5555
  "name": "--target",
4624
5556
  "value": "<path>",
4625
- "required": false,
5557
+ "required": true,
4626
5558
  "description": "mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
4627
5559
  },
4628
5560
  {
@@ -4697,16 +5629,28 @@
4697
5629
  "required": false,
4698
5630
  "description": "--help, -h Show help"
4699
5631
  },
5632
+ {
5633
+ "name": "--json",
5634
+ "value": null,
5635
+ "required": false,
5636
+ "description": "mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
5637
+ },
4700
5638
  {
4701
5639
  "name": "--root",
4702
5640
  "value": null,
4703
5641
  "required": false,
4704
5642
  "description": "--root, -r <path> Run against a specific repo root"
4705
5643
  },
5644
+ {
5645
+ "name": "--start-goal",
5646
+ "value": "<goal-id>",
5647
+ "required": false,
5648
+ "description": "mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
5649
+ },
4706
5650
  {
4707
5651
  "name": "--target",
4708
5652
  "value": "<path>",
4709
- "required": false,
5653
+ "required": true,
4710
5654
  "description": "mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
4711
5655
  },
4712
5656
  {
@@ -4777,9 +5721,15 @@
4777
5721
  "flags": [
4778
5722
  {
4779
5723
  "name": "--apply",
4780
- "value": "is",
5724
+ "value": null,
5725
+ "required": false,
5726
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5727
+ },
5728
+ {
5729
+ "name": "--dry-run",
5730
+ "value": null,
4781
5731
  "required": false,
4782
- "description": "- defaults to dry-run unless --apply is supplied"
5732
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
4783
5733
  },
4784
5734
  {
4785
5735
  "name": "--help",
@@ -4787,6 +5737,18 @@
4787
5737
  "required": false,
4788
5738
  "description": "--help, -h Show help"
4789
5739
  },
5740
+ {
5741
+ "name": "--id-prefix",
5742
+ "value": "<prefix>",
5743
+ "required": false,
5744
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5745
+ },
5746
+ {
5747
+ "name": "--json",
5748
+ "value": null,
5749
+ "required": false,
5750
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
5751
+ },
4790
5752
  {
4791
5753
  "name": "--root",
4792
5754
  "value": null,
@@ -4795,15 +5757,15 @@
4795
5757
  },
4796
5758
  {
4797
5759
  "name": "--select-goal",
4798
- "value": "requires",
5760
+ "value": null,
4799
5761
  "required": false,
4800
- "description": "- --select-goal requires --start-goal; on apply it activates the imported start goal, pauses competing active root goals, validates, then writes selected-goal state"
5762
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
4801
5763
  },
4802
5764
  {
4803
5765
  "name": "--start-goal",
4804
- "value": null,
5766
+ "value": "<goal-id>",
4805
5767
  "required": false,
4806
- "description": "- --select-goal requires --start-goal; on apply it activates the imported start goal, pauses competing active root goals, validates, then writes selected-goal state"
5768
+ "description": "mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
4807
5769
  },
4808
5770
  {
4809
5771
  "name": "--version",
@@ -4877,6 +5839,12 @@
4877
5839
  "required": false,
4878
5840
  "description": "--help, -h Show help"
4879
5841
  },
5842
+ {
5843
+ "name": "--json",
5844
+ "value": null,
5845
+ "required": false,
5846
+ "description": "mdkg graph refs <id-or-qid> [--ws <alias>] [--json]"
5847
+ },
4880
5848
  {
4881
5849
  "name": "--root",
4882
5850
  "value": null,
@@ -4888,6 +5856,12 @@
4888
5856
  "value": null,
4889
5857
  "required": false,
4890
5858
  "description": "--version, -V Show version"
5859
+ },
5860
+ {
5861
+ "name": "--ws",
5862
+ "value": "<alias>",
5863
+ "required": false,
5864
+ "description": "mdkg graph refs <id-or-qid> [--ws <alias>] [--json]"
4891
5865
  }
4892
5866
  ],
4893
5867
  "output_formats": [
@@ -5020,17 +5994,29 @@
5020
5994
  }
5021
5995
  ],
5022
5996
  "flags": [
5997
+ {
5998
+ "name": "--depth",
5999
+ "value": "<n>",
6000
+ "required": false,
6001
+ "description": "mdkg handoff create <id-or-qid> [--ws <alias>] [--depth <n>] [--out <path>] [--json]"
6002
+ },
5023
6003
  {
5024
6004
  "name": "--help",
5025
6005
  "value": null,
5026
6006
  "required": false,
5027
6007
  "description": "--help, -h Show help"
5028
6008
  },
6009
+ {
6010
+ "name": "--json",
6011
+ "value": null,
6012
+ "required": false,
6013
+ "description": "mdkg handoff create <id-or-qid> [--ws <alias>] [--depth <n>] [--out <path>] [--json]"
6014
+ },
5029
6015
  {
5030
6016
  "name": "--out",
5031
- "value": "must",
6017
+ "value": "<path>",
5032
6018
  "required": false,
5033
- "description": "- --out must stay inside the repo root"
6019
+ "description": "mdkg handoff create <id-or-qid> [--ws <alias>] [--depth <n>] [--out <path>] [--json]"
5034
6020
  },
5035
6021
  {
5036
6022
  "name": "--root",
@@ -5043,6 +6029,12 @@
5043
6029
  "value": null,
5044
6030
  "required": false,
5045
6031
  "description": "--version, -V Show version"
6032
+ },
6033
+ {
6034
+ "name": "--ws",
6035
+ "value": "<alias>",
6036
+ "required": false,
6037
+ "description": "mdkg handoff create <id-or-qid> [--ws <alias>] [--depth <n>] [--out <path>] [--json]"
5046
6038
  }
5047
6039
  ],
5048
6040
  "output_formats": [
@@ -5113,6 +6105,12 @@
5113
6105
  "required": false,
5114
6106
  "description": "--root, -r <path> Run against a specific repo root"
5115
6107
  },
6108
+ {
6109
+ "name": "--tolerant",
6110
+ "value": null,
6111
+ "required": false,
6112
+ "description": "mdkg index [--tolerant]"
6113
+ },
5116
6114
  {
5117
6115
  "name": "--version",
5118
6116
  "value": null,
@@ -5296,23 +6294,77 @@
5296
6294
  ],
5297
6295
  "args": [],
5298
6296
  "flags": [
6297
+ {
6298
+ "name": "--blocked",
6299
+ "value": null,
6300
+ "required": false,
6301
+ "description": "[--priority <n>] [--blocked] [--tags <tag,tag,...>] [--tags-mode any|all]"
6302
+ },
6303
+ {
6304
+ "name": "--epic",
6305
+ "value": "<id>",
6306
+ "required": false,
6307
+ "description": "mdkg list [--type <type>] [--status <status>] [--ws <alias>] [--epic <id>]"
6308
+ },
5299
6309
  {
5300
6310
  "name": "--help",
5301
6311
  "value": null,
5302
6312
  "required": false,
5303
6313
  "description": "--help, -h Show help"
5304
6314
  },
6315
+ {
6316
+ "name": "--json",
6317
+ "value": null,
6318
+ "required": false,
6319
+ "description": "[--json|--xml|--toon|--md]"
6320
+ },
6321
+ {
6322
+ "name": "--priority",
6323
+ "value": "<n>",
6324
+ "required": false,
6325
+ "description": "[--priority <n>] [--blocked] [--tags <tag,tag,...>] [--tags-mode any|all]"
6326
+ },
5305
6327
  {
5306
6328
  "name": "--root",
5307
6329
  "value": null,
5308
6330
  "required": false,
5309
6331
  "description": "--root, -r <path> Run against a specific repo root"
5310
6332
  },
6333
+ {
6334
+ "name": "--status",
6335
+ "value": "<status>",
6336
+ "required": false,
6337
+ "description": "mdkg list [--type <type>] [--status <status>] [--ws <alias>] [--epic <id>]"
6338
+ },
6339
+ {
6340
+ "name": "--tags",
6341
+ "value": "<tag,tag,...>",
6342
+ "required": false,
6343
+ "description": "[--priority <n>] [--blocked] [--tags <tag,tag,...>] [--tags-mode any|all]"
6344
+ },
6345
+ {
6346
+ "name": "--tags-mode",
6347
+ "value": "any|all",
6348
+ "required": false,
6349
+ "description": "[--priority <n>] [--blocked] [--tags <tag,tag,...>] [--tags-mode any|all]"
6350
+ },
6351
+ {
6352
+ "name": "--type",
6353
+ "value": "<type>",
6354
+ "required": false,
6355
+ "description": "mdkg list [--type <type>] [--status <status>] [--ws <alias>] [--epic <id>]"
6356
+ },
5311
6357
  {
5312
6358
  "name": "--version",
5313
6359
  "value": null,
5314
6360
  "required": false,
5315
6361
  "description": "--version, -V Show version"
6362
+ },
6363
+ {
6364
+ "name": "--ws",
6365
+ "value": "<alias>",
6366
+ "required": false,
6367
+ "description": "mdkg list [--type <type>] [--status <status>] [--ws <alias>] [--epic <id>]"
5316
6368
  }
5317
6369
  ],
5318
6370
  "output_formats": [
@@ -6138,6 +7190,12 @@
6138
7190
  "required": false,
6139
7191
  "description": "--help, -h Show help"
6140
7192
  },
7193
+ {
7194
+ "name": "--json",
7195
+ "value": null,
7196
+ "required": false,
7197
+ "description": "mdkg manifest list [--json]"
7198
+ },
6141
7199
  {
6142
7200
  "name": "--root",
6143
7201
  "value": null,
@@ -6212,6 +7270,12 @@
6212
7270
  "required": false,
6213
7271
  "description": "--help, -h Show help"
6214
7272
  },
7273
+ {
7274
+ "name": "--json",
7275
+ "value": null,
7276
+ "required": false,
7277
+ "description": "mdkg manifest list [--json]"
7278
+ },
6215
7279
  {
6216
7280
  "name": "--root",
6217
7281
  "value": null,
@@ -6290,6 +7354,12 @@
6290
7354
  "required": false,
6291
7355
  "description": "--help, -h Show help"
6292
7356
  },
7357
+ {
7358
+ "name": "--json",
7359
+ "value": null,
7360
+ "required": false,
7361
+ "description": "mdkg manifest show <id-or-qid-or-alias> [--json]"
7362
+ },
6293
7363
  {
6294
7364
  "name": "--root",
6295
7365
  "value": null,
@@ -6368,6 +7438,12 @@
6368
7438
  "required": false,
6369
7439
  "description": "--help, -h Show help"
6370
7440
  },
7441
+ {
7442
+ "name": "--json",
7443
+ "value": null,
7444
+ "required": false,
7445
+ "description": "mdkg manifest validate [<id-or-qid-or-alias>] [--json]"
7446
+ },
6371
7447
  {
6372
7448
  "name": "--root",
6373
7449
  "value": null,
@@ -6448,7 +7524,7 @@
6448
7524
  {
6449
7525
  "name": "--stdio",
6450
7526
  "value": null,
6451
- "required": false,
7527
+ "required": true,
6452
7528
  "description": "mdkg mcp serve --stdio"
6453
7529
  },
6454
7530
  {
@@ -6525,7 +7601,7 @@
6525
7601
  {
6526
7602
  "name": "--stdio",
6527
7603
  "value": null,
6528
- "required": false,
7604
+ "required": true,
6529
7605
  "description": "mdkg mcp serve --stdio"
6530
7606
  },
6531
7607
  {
@@ -6638,6 +7714,12 @@
6638
7714
  "required": false,
6639
7715
  "description": "Use --id <portable-id> with these types for semantic ids like agent.image-worker."
6640
7716
  },
7717
+ {
7718
+ "name": "--json",
7719
+ "value": null,
7720
+ "required": false,
7721
+ "description": "mdkg new <type> \"<title>\" [options] [--json]"
7722
+ },
6641
7723
  {
6642
7724
  "name": "--links",
6643
7725
  "value": null,
@@ -6827,6 +7909,12 @@
6827
7909
  "value": null,
6828
7910
  "required": false,
6829
7911
  "description": "--version, -V Show version"
7912
+ },
7913
+ {
7914
+ "name": "--ws",
7915
+ "value": "<alias>",
7916
+ "required": false,
7917
+ "description": "mdkg next [<id-or-qid>] [--ws <alias>]"
6830
7918
  }
6831
7919
  ],
6832
7920
  "output_formats": [
@@ -7077,17 +8165,59 @@
7077
8165
  "required": false,
7078
8166
  "description": "--help, -h Show help"
7079
8167
  },
8168
+ {
8169
+ "name": "--json",
8170
+ "value": null,
8171
+ "required": false,
8172
+ "description": "[--tags <tag,tag,...>] [--tags-mode any|all] [--limit <n>] [--json|--xml|--toon|--md]"
8173
+ },
8174
+ {
8175
+ "name": "--limit",
8176
+ "value": "<n>",
8177
+ "required": false,
8178
+ "description": "[--tags <tag,tag,...>] [--tags-mode any|all] [--limit <n>] [--json|--xml|--toon|--md]"
8179
+ },
7080
8180
  {
7081
8181
  "name": "--root",
7082
8182
  "value": null,
7083
8183
  "required": false,
7084
8184
  "description": "--root, -r <path> Run against a specific repo root"
7085
8185
  },
8186
+ {
8187
+ "name": "--status",
8188
+ "value": "<status>",
8189
+ "required": false,
8190
+ "description": "mdkg search \"<query>\" [--type <type>] [--status <status>] [--ws <alias>]"
8191
+ },
8192
+ {
8193
+ "name": "--tags",
8194
+ "value": "<tag,tag,...>",
8195
+ "required": false,
8196
+ "description": "[--tags <tag,tag,...>] [--tags-mode any|all] [--limit <n>] [--json|--xml|--toon|--md]"
8197
+ },
8198
+ {
8199
+ "name": "--tags-mode",
8200
+ "value": "any|all",
8201
+ "required": false,
8202
+ "description": "[--tags <tag,tag,...>] [--tags-mode any|all] [--limit <n>] [--json|--xml|--toon|--md]"
8203
+ },
8204
+ {
8205
+ "name": "--type",
8206
+ "value": "<type>",
8207
+ "required": false,
8208
+ "description": "mdkg search \"<query>\" [--type <type>] [--status <status>] [--ws <alias>]"
8209
+ },
7086
8210
  {
7087
8211
  "name": "--version",
7088
8212
  "value": null,
7089
8213
  "required": false,
7090
8214
  "description": "--version, -V Show version"
8215
+ },
8216
+ {
8217
+ "name": "--ws",
8218
+ "value": "<alias>",
8219
+ "required": false,
8220
+ "description": "mdkg search \"<query>\" [--type <type>] [--status <status>] [--ws <alias>]"
7091
8221
  }
7092
8222
  ],
7093
8223
  "output_formats": [
@@ -7157,11 +8287,17 @@
7157
8287
  "required": false,
7158
8288
  "description": "--help, -h Show help"
7159
8289
  },
8290
+ {
8291
+ "name": "--json",
8292
+ "value": null,
8293
+ "required": false,
8294
+ "description": "mdkg show <id-or-qid> [--ws <alias>] [--meta] [--json|--xml|--toon|--md]"
8295
+ },
7160
8296
  {
7161
8297
  "name": "--meta",
7162
- "value": "for",
8298
+ "value": null,
7163
8299
  "required": false,
7164
- "description": "Shows full body content. Use --meta for card + metadata only."
8300
+ "description": "mdkg show <id-or-qid> [--ws <alias>] [--meta] [--json|--xml|--toon|--md]"
7165
8301
  },
7166
8302
  {
7167
8303
  "name": "--root",
@@ -7174,6 +8310,12 @@
7174
8310
  "value": null,
7175
8311
  "required": false,
7176
8312
  "description": "--version, -V Show version"
8313
+ },
8314
+ {
8315
+ "name": "--ws",
8316
+ "value": "<alias>",
8317
+ "required": false,
8318
+ "description": "mdkg show <id-or-qid> [--ws <alias>] [--meta] [--json|--xml|--toon|--md]"
7177
8319
  }
7178
8320
  ],
7179
8321
  "output_formats": [
@@ -7268,12 +8410,30 @@
7268
8410
  "required": false,
7269
8411
  "description": "mdkg skill new <slug> \"<name>\" --description \"<description>\" [options] [--json]"
7270
8412
  },
8413
+ {
8414
+ "name": "--force",
8415
+ "value": null,
8416
+ "required": false,
8417
+ "description": "mdkg skill sync [--force] [--json]"
8418
+ },
7271
8419
  {
7272
8420
  "name": "--help",
7273
8421
  "value": null,
7274
8422
  "required": false,
7275
8423
  "description": "--help, -h Show help"
7276
8424
  },
8425
+ {
8426
+ "name": "--json",
8427
+ "value": null,
8428
+ "required": false,
8429
+ "description": "mdkg skill new <slug> \"<name>\" --description \"<description>\" [options] [--json]"
8430
+ },
8431
+ {
8432
+ "name": "--meta",
8433
+ "value": null,
8434
+ "required": false,
8435
+ "description": "mdkg skill show <slug> [--meta] [--json|--xml|--toon|--md]"
8436
+ },
7277
8437
  {
7278
8438
  "name": "--root",
7279
8439
  "value": null,
@@ -7282,9 +8442,15 @@
7282
8442
  },
7283
8443
  {
7284
8444
  "name": "--tags",
7285
- "value": null,
8445
+ "value": "<tag,tag,...>",
8446
+ "required": false,
8447
+ "description": "mdkg skill list [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8448
+ },
8449
+ {
8450
+ "name": "--tags-mode",
8451
+ "value": "any|all",
7286
8452
  "required": false,
7287
- "description": "Use stage tags like `stage:plan`, `stage:execute`, and `stage:review` with --tags."
8453
+ "description": "mdkg skill list [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
7288
8454
  },
7289
8455
  {
7290
8456
  "name": "--version",
@@ -7364,12 +8530,30 @@
7364
8530
  "required": false,
7365
8531
  "description": "--help, -h Show help"
7366
8532
  },
8533
+ {
8534
+ "name": "--json",
8535
+ "value": null,
8536
+ "required": false,
8537
+ "description": "mdkg skill list [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8538
+ },
7367
8539
  {
7368
8540
  "name": "--root",
7369
8541
  "value": null,
7370
8542
  "required": false,
7371
8543
  "description": "--root, -r <path> Run against a specific repo root"
7372
8544
  },
8545
+ {
8546
+ "name": "--tags",
8547
+ "value": "<tag,tag,...>",
8548
+ "required": false,
8549
+ "description": "mdkg skill list [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8550
+ },
8551
+ {
8552
+ "name": "--tags-mode",
8553
+ "value": "any|all",
8554
+ "required": false,
8555
+ "description": "mdkg skill list [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8556
+ },
7373
8557
  {
7374
8558
  "name": "--version",
7375
8559
  "value": null,
@@ -7463,7 +8647,7 @@
7463
8647
  {
7464
8648
  "name": "--description",
7465
8649
  "value": "\"<description>\"",
7466
- "required": false,
8650
+ "required": true,
7467
8651
  "description": "mdkg skill new <slug> \"<name>\" --description \"<description>\" [options] [--json]"
7468
8652
  },
7469
8653
  {
@@ -7478,6 +8662,12 @@
7478
8662
  "required": false,
7479
8663
  "description": "--help, -h Show help"
7480
8664
  },
8665
+ {
8666
+ "name": "--json",
8667
+ "value": null,
8668
+ "required": false,
8669
+ "description": "mdkg skill new <slug> \"<name>\" --description \"<description>\" [options] [--json]"
8670
+ },
7481
8671
  {
7482
8672
  "name": "--links",
7483
8673
  "value": "<url,url,...>",
@@ -7587,12 +8777,30 @@
7587
8777
  "required": false,
7588
8778
  "description": "--help, -h Show help"
7589
8779
  },
8780
+ {
8781
+ "name": "--json",
8782
+ "value": null,
8783
+ "required": false,
8784
+ "description": "mdkg skill search \"<query>\" [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8785
+ },
7590
8786
  {
7591
8787
  "name": "--root",
7592
8788
  "value": null,
7593
8789
  "required": false,
7594
8790
  "description": "--root, -r <path> Run against a specific repo root"
7595
8791
  },
8792
+ {
8793
+ "name": "--tags",
8794
+ "value": "<tag,tag,...>",
8795
+ "required": false,
8796
+ "description": "mdkg skill search \"<query>\" [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8797
+ },
8798
+ {
8799
+ "name": "--tags-mode",
8800
+ "value": "any|all",
8801
+ "required": false,
8802
+ "description": "mdkg skill search \"<query>\" [--tags <tag,tag,...>] [--tags-mode any|all] [--json|--xml|--toon|--md]"
8803
+ },
7596
8804
  {
7597
8805
  "name": "--version",
7598
8806
  "value": null,
@@ -7668,6 +8876,18 @@
7668
8876
  "required": false,
7669
8877
  "description": "--help, -h Show help"
7670
8878
  },
8879
+ {
8880
+ "name": "--json",
8881
+ "value": null,
8882
+ "required": false,
8883
+ "description": "mdkg skill show <slug> [--meta] [--json|--xml|--toon|--md]"
8884
+ },
8885
+ {
8886
+ "name": "--meta",
8887
+ "value": null,
8888
+ "required": false,
8889
+ "description": "mdkg skill show <slug> [--meta] [--json|--xml|--toon|--md]"
8890
+ },
7671
8891
  {
7672
8892
  "name": "--root",
7673
8893
  "value": null,
@@ -7737,12 +8957,24 @@
7737
8957
  ],
7738
8958
  "args": [],
7739
8959
  "flags": [
8960
+ {
8961
+ "name": "--force",
8962
+ "value": null,
8963
+ "required": false,
8964
+ "description": "mdkg skill sync [--force] [--json]"
8965
+ },
7740
8966
  {
7741
8967
  "name": "--help",
7742
8968
  "value": null,
7743
8969
  "required": false,
7744
8970
  "description": "--help, -h Show help"
7745
8971
  },
8972
+ {
8973
+ "name": "--json",
8974
+ "value": null,
8975
+ "required": false,
8976
+ "description": "mdkg skill sync [--force] [--json]"
8977
+ },
7746
8978
  {
7747
8979
  "name": "--root",
7748
8980
  "value": null,
@@ -7828,6 +9060,12 @@
7828
9060
  "required": false,
7829
9061
  "description": "--help, -h Show help"
7830
9062
  },
9063
+ {
9064
+ "name": "--json",
9065
+ "value": null,
9066
+ "required": false,
9067
+ "description": "mdkg skill validate [<slug>] [--json]"
9068
+ },
7831
9069
  {
7832
9070
  "name": "--root",
7833
9071
  "value": null,
@@ -7907,6 +9145,12 @@
7907
9145
  "required": false,
7908
9146
  "description": "--help, -h Show help"
7909
9147
  },
9148
+ {
9149
+ "name": "--json",
9150
+ "value": null,
9151
+ "required": false,
9152
+ "description": "mdkg spec list [--json]"
9153
+ },
7910
9154
  {
7911
9155
  "name": "--root",
7912
9156
  "value": null,
@@ -7981,6 +9225,12 @@
7981
9225
  "required": false,
7982
9226
  "description": "--help, -h Show help"
7983
9227
  },
9228
+ {
9229
+ "name": "--json",
9230
+ "value": null,
9231
+ "required": false,
9232
+ "description": "mdkg spec list [--json]"
9233
+ },
7984
9234
  {
7985
9235
  "name": "--root",
7986
9236
  "value": null,
@@ -8059,6 +9309,12 @@
8059
9309
  "required": false,
8060
9310
  "description": "--help, -h Show help"
8061
9311
  },
9312
+ {
9313
+ "name": "--json",
9314
+ "value": null,
9315
+ "required": false,
9316
+ "description": "mdkg spec show <id-or-qid-or-alias> [--json]"
9317
+ },
8062
9318
  {
8063
9319
  "name": "--root",
8064
9320
  "value": null,
@@ -8137,6 +9393,12 @@
8137
9393
  "required": false,
8138
9394
  "description": "--help, -h Show help"
8139
9395
  },
9396
+ {
9397
+ "name": "--json",
9398
+ "value": null,
9399
+ "required": false,
9400
+ "description": "mdkg spec validate [<id-or-qid-or-alias>] [--json]"
9401
+ },
8140
9402
  {
8141
9403
  "name": "--root",
8142
9404
  "value": null,
@@ -8212,7 +9474,7 @@
8212
9474
  "name": "--json",
8213
9475
  "value": null,
8214
9476
  "required": false,
8215
- "description": "--json Emit machine-readable JSON output"
9477
+ "description": "mdkg status [--json]"
8216
9478
  },
8217
9479
  {
8218
9480
  "name": "--root",
@@ -8303,29 +9565,89 @@
8303
9565
  }
8304
9566
  ],
8305
9567
  "flags": [
9568
+ {
9569
+ "name": "--allow-dirty",
9570
+ "value": null,
9571
+ "required": false,
9572
+ "description": "mdkg subgraph sync [alias|--all] [--dry-run] [--allow-dirty] [--json]"
9573
+ },
9574
+ {
9575
+ "name": "--clean",
9576
+ "value": null,
9577
+ "required": false,
9578
+ "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
9579
+ },
9580
+ {
9581
+ "name": "--dry-run",
9582
+ "value": null,
9583
+ "required": false,
9584
+ "description": "mdkg subgraph sync [alias|--all] [--dry-run] [--allow-dirty] [--json]"
9585
+ },
9586
+ {
9587
+ "name": "--gitignore",
9588
+ "value": null,
9589
+ "required": false,
9590
+ "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
9591
+ },
8306
9592
  {
8307
9593
  "name": "--help",
8308
9594
  "value": null,
8309
9595
  "required": false,
8310
9596
  "description": "--help, -h Show help"
8311
9597
  },
9598
+ {
9599
+ "name": "--json",
9600
+ "value": null,
9601
+ "required": false,
9602
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9603
+ },
9604
+ {
9605
+ "name": "--max-stale-seconds",
9606
+ "value": "<seconds>",
9607
+ "required": false,
9608
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9609
+ },
9610
+ {
9611
+ "name": "--profile",
9612
+ "value": "private|public",
9613
+ "required": false,
9614
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9615
+ },
8312
9616
  {
8313
9617
  "name": "--root",
8314
9618
  "value": null,
8315
9619
  "required": false,
8316
9620
  "description": "--root, -r <path> Run against a specific repo root"
8317
9621
  },
9622
+ {
9623
+ "name": "--source-path",
9624
+ "value": "<path>",
9625
+ "required": false,
9626
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9627
+ },
9628
+ {
9629
+ "name": "--source-repo",
9630
+ "value": "<ref>",
9631
+ "required": false,
9632
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9633
+ },
8318
9634
  {
8319
9635
  "name": "--target",
8320
9636
  "value": "<path>",
8321
9637
  "required": false,
8322
- "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
9638
+ "description": "mdkg subgraph audit [alias|--all] [--target <path>] [--json]"
8323
9639
  },
8324
9640
  {
8325
9641
  "name": "--version",
8326
9642
  "value": null,
8327
9643
  "required": false,
8328
9644
  "description": "--version, -V Show version"
9645
+ },
9646
+ {
9647
+ "name": "--visibility",
9648
+ "value": "private|internal|public",
9649
+ "required": false,
9650
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
8329
9651
  }
8330
9652
  ],
8331
9653
  "output_formats": [
@@ -8412,17 +9734,53 @@
8412
9734
  "required": false,
8413
9735
  "description": "--help, -h Show help"
8414
9736
  },
9737
+ {
9738
+ "name": "--json",
9739
+ "value": null,
9740
+ "required": false,
9741
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9742
+ },
9743
+ {
9744
+ "name": "--max-stale-seconds",
9745
+ "value": "<seconds>",
9746
+ "required": false,
9747
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9748
+ },
9749
+ {
9750
+ "name": "--profile",
9751
+ "value": "private|public",
9752
+ "required": false,
9753
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9754
+ },
8415
9755
  {
8416
9756
  "name": "--root",
8417
9757
  "value": null,
8418
9758
  "required": false,
8419
9759
  "description": "--root, -r <path> Run against a specific repo root"
8420
9760
  },
9761
+ {
9762
+ "name": "--source-path",
9763
+ "value": "<path>",
9764
+ "required": false,
9765
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9766
+ },
9767
+ {
9768
+ "name": "--source-repo",
9769
+ "value": "<ref>",
9770
+ "required": false,
9771
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
9772
+ },
8421
9773
  {
8422
9774
  "name": "--version",
8423
9775
  "value": null,
8424
9776
  "required": false,
8425
9777
  "description": "--version, -V Show version"
9778
+ },
9779
+ {
9780
+ "name": "--visibility",
9781
+ "value": "private|internal|public",
9782
+ "required": false,
9783
+ "description": "mdkg subgraph add <alias> <bundle-path> [--visibility private|internal|public] [--profile private|public] [--source-path <path>] [--source-repo <ref>] [--max-stale-seconds <seconds>] [--json]"
8426
9784
  }
8427
9785
  ],
8428
9786
  "output_formats": [
@@ -8496,6 +9854,12 @@
8496
9854
  "required": false,
8497
9855
  "description": "--help, -h Show help"
8498
9856
  },
9857
+ {
9858
+ "name": "--json",
9859
+ "value": null,
9860
+ "required": false,
9861
+ "description": "mdkg subgraph disable <alias> [--json]"
9862
+ },
8499
9863
  {
8500
9864
  "name": "--root",
8501
9865
  "value": null,
@@ -8580,6 +9944,12 @@
8580
9944
  "required": false,
8581
9945
  "description": "--help, -h Show help"
8582
9946
  },
9947
+ {
9948
+ "name": "--json",
9949
+ "value": null,
9950
+ "required": false,
9951
+ "description": "mdkg subgraph enable <alias> [--json]"
9952
+ },
8583
9953
  {
8584
9954
  "name": "--root",
8585
9955
  "value": null,
@@ -8658,6 +10028,12 @@
8658
10028
  "required": false,
8659
10029
  "description": "--help, -h Show help"
8660
10030
  },
10031
+ {
10032
+ "name": "--json",
10033
+ "value": null,
10034
+ "required": false,
10035
+ "description": "mdkg subgraph list [--json]"
10036
+ },
8661
10037
  {
8662
10038
  "name": "--root",
8663
10039
  "value": null,
@@ -8724,12 +10100,30 @@
8724
10100
  ],
8725
10101
  "args": [],
8726
10102
  "flags": [
10103
+ {
10104
+ "name": "--clean",
10105
+ "value": null,
10106
+ "required": false,
10107
+ "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
10108
+ },
10109
+ {
10110
+ "name": "--gitignore",
10111
+ "value": null,
10112
+ "required": false,
10113
+ "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
10114
+ },
8727
10115
  {
8728
10116
  "name": "--help",
8729
10117
  "value": null,
8730
10118
  "required": false,
8731
10119
  "description": "--help, -h Show help"
8732
10120
  },
10121
+ {
10122
+ "name": "--json",
10123
+ "value": null,
10124
+ "required": false,
10125
+ "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
10126
+ },
8733
10127
  {
8734
10128
  "name": "--root",
8735
10129
  "value": null,
@@ -8739,7 +10133,7 @@
8739
10133
  {
8740
10134
  "name": "--target",
8741
10135
  "value": "<path>",
8742
- "required": false,
10136
+ "required": true,
8743
10137
  "description": "mdkg subgraph materialize [alias|--all] --target <path> [--clean] [--gitignore] [--json]"
8744
10138
  },
8745
10139
  {
@@ -8813,6 +10207,12 @@
8813
10207
  "required": false,
8814
10208
  "description": "--help, -h Show help"
8815
10209
  },
10210
+ {
10211
+ "name": "--json",
10212
+ "value": null,
10213
+ "required": false,
10214
+ "description": "mdkg subgraph refresh [alias|--all] [--json]"
10215
+ },
8816
10216
  {
8817
10217
  "name": "--root",
8818
10218
  "value": null,
@@ -8897,6 +10297,12 @@
8897
10297
  "required": false,
8898
10298
  "description": "--help, -h Show help"
8899
10299
  },
10300
+ {
10301
+ "name": "--json",
10302
+ "value": null,
10303
+ "required": false,
10304
+ "description": "mdkg subgraph rm <alias> [--json]"
10305
+ },
8900
10306
  {
8901
10307
  "name": "--root",
8902
10308
  "value": null,
@@ -8981,6 +10387,12 @@
8981
10387
  "required": false,
8982
10388
  "description": "--help, -h Show help"
8983
10389
  },
10390
+ {
10391
+ "name": "--json",
10392
+ "value": null,
10393
+ "required": false,
10394
+ "description": "mdkg subgraph show <alias> [--json]"
10395
+ },
8984
10396
  {
8985
10397
  "name": "--root",
8986
10398
  "value": null,
@@ -9047,12 +10459,30 @@
9047
10459
  ],
9048
10460
  "args": [],
9049
10461
  "flags": [
10462
+ {
10463
+ "name": "--allow-dirty",
10464
+ "value": null,
10465
+ "required": false,
10466
+ "description": "mdkg subgraph sync [alias|--all] [--dry-run] [--allow-dirty] [--json]"
10467
+ },
10468
+ {
10469
+ "name": "--dry-run",
10470
+ "value": null,
10471
+ "required": false,
10472
+ "description": "mdkg subgraph sync [alias|--all] [--dry-run] [--allow-dirty] [--json]"
10473
+ },
9050
10474
  {
9051
10475
  "name": "--help",
9052
10476
  "value": null,
9053
10477
  "required": false,
9054
10478
  "description": "--help, -h Show help"
9055
10479
  },
10480
+ {
10481
+ "name": "--json",
10482
+ "value": null,
10483
+ "required": false,
10484
+ "description": "mdkg subgraph sync [alias|--all] [--dry-run] [--allow-dirty] [--json]"
10485
+ },
9056
10486
  {
9057
10487
  "name": "--root",
9058
10488
  "value": null,
@@ -9133,6 +10563,12 @@
9133
10563
  "required": false,
9134
10564
  "description": "--help, -h Show help"
9135
10565
  },
10566
+ {
10567
+ "name": "--json",
10568
+ "value": null,
10569
+ "required": false,
10570
+ "description": "mdkg subgraph verify [alias|--all] [--json]"
10571
+ },
9136
10572
  {
9137
10573
  "name": "--root",
9138
10574
  "value": null,
@@ -9221,23 +10657,59 @@
9221
10657
  }
9222
10658
  ],
9223
10659
  "flags": [
10660
+ {
10661
+ "name": "--checkpoint",
10662
+ "value": "\"<title>\"",
10663
+ "required": false,
10664
+ "description": "mdkg task done <id-or-qid> [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [options] [--json]"
10665
+ },
10666
+ {
10667
+ "name": "--checkpoint-kind",
10668
+ "value": "implementation|test-proof|goal-closeout|audit|handoff",
10669
+ "required": false,
10670
+ "description": "mdkg task done <id-or-qid> [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [options] [--json]"
10671
+ },
9224
10672
  {
9225
10673
  "name": "--help",
9226
10674
  "value": null,
9227
10675
  "required": false,
9228
10676
  "description": "--help, -h Show help"
9229
10677
  },
10678
+ {
10679
+ "name": "--json",
10680
+ "value": null,
10681
+ "required": false,
10682
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
10683
+ },
10684
+ {
10685
+ "name": "--note",
10686
+ "value": "\"<text>\"",
10687
+ "required": false,
10688
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
10689
+ },
9230
10690
  {
9231
10691
  "name": "--root",
9232
10692
  "value": null,
9233
10693
  "required": false,
9234
10694
  "description": "--root, -r <path> Run against a specific repo root"
9235
10695
  },
10696
+ {
10697
+ "name": "--run-id",
10698
+ "value": "<id>",
10699
+ "required": false,
10700
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
10701
+ },
9236
10702
  {
9237
10703
  "name": "--version",
9238
10704
  "value": null,
9239
10705
  "required": false,
9240
10706
  "description": "--version, -V Show version"
10707
+ },
10708
+ {
10709
+ "name": "--ws",
10710
+ "value": "<alias>",
10711
+ "required": false,
10712
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
9241
10713
  }
9242
10714
  ],
9243
10715
  "output_formats": [
@@ -9306,23 +10778,77 @@
9306
10778
  }
9307
10779
  ],
9308
10780
  "flags": [
10781
+ {
10782
+ "name": "--add-artifacts",
10783
+ "value": "<a,...>",
10784
+ "required": false,
10785
+ "description": "mdkg task done <id-or-qid> [--ws <alias>] [--add-artifacts <a,...>] [--add-links <l,...>]"
10786
+ },
10787
+ {
10788
+ "name": "--add-links",
10789
+ "value": "<l,...>",
10790
+ "required": false,
10791
+ "description": "mdkg task done <id-or-qid> [--ws <alias>] [--add-artifacts <a,...>] [--add-links <l,...>]"
10792
+ },
10793
+ {
10794
+ "name": "--add-refs",
10795
+ "value": "<id,...>",
10796
+ "required": false,
10797
+ "description": "[--add-refs <id,...>] [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [--run-id <id>] [--note \"<text>\"] [--json]"
10798
+ },
10799
+ {
10800
+ "name": "--checkpoint",
10801
+ "value": "\"<title>\"",
10802
+ "required": false,
10803
+ "description": "[--add-refs <id,...>] [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [--run-id <id>] [--note \"<text>\"] [--json]"
10804
+ },
10805
+ {
10806
+ "name": "--checkpoint-kind",
10807
+ "value": "implementation|test-proof|goal-closeout|audit|handoff",
10808
+ "required": false,
10809
+ "description": "[--add-refs <id,...>] [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [--run-id <id>] [--note \"<text>\"] [--json]"
10810
+ },
9309
10811
  {
9310
10812
  "name": "--help",
9311
10813
  "value": null,
9312
10814
  "required": false,
9313
10815
  "description": "--help, -h Show help"
9314
10816
  },
10817
+ {
10818
+ "name": "--json",
10819
+ "value": null,
10820
+ "required": false,
10821
+ "description": "[--add-refs <id,...>] [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [--run-id <id>] [--note \"<text>\"] [--json]"
10822
+ },
10823
+ {
10824
+ "name": "--note",
10825
+ "value": "\"<text>\"",
10826
+ "required": false,
10827
+ "description": "[--add-refs <id,...>] [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [--run-id <id>] [--note \"<text>\"] [--json]"
10828
+ },
9315
10829
  {
9316
10830
  "name": "--root",
9317
10831
  "value": null,
9318
10832
  "required": false,
9319
10833
  "description": "--root, -r <path> Run against a specific repo root"
9320
10834
  },
10835
+ {
10836
+ "name": "--run-id",
10837
+ "value": "<id>",
10838
+ "required": false,
10839
+ "description": "[--add-refs <id,...>] [--checkpoint \"<title>\"] [--checkpoint-kind implementation|test-proof|goal-closeout|audit|handoff] [--run-id <id>] [--note \"<text>\"] [--json]"
10840
+ },
9321
10841
  {
9322
10842
  "name": "--version",
9323
10843
  "value": null,
9324
10844
  "required": false,
9325
10845
  "description": "--version, -V Show version"
10846
+ },
10847
+ {
10848
+ "name": "--ws",
10849
+ "value": "<alias>",
10850
+ "required": false,
10851
+ "description": "mdkg task done <id-or-qid> [--ws <alias>] [--add-artifacts <a,...>] [--add-links <l,...>]"
9326
10852
  }
9327
10853
  ],
9328
10854
  "output_formats": [
@@ -9400,17 +10926,41 @@
9400
10926
  "required": false,
9401
10927
  "description": "--help, -h Show help"
9402
10928
  },
10929
+ {
10930
+ "name": "--json",
10931
+ "value": null,
10932
+ "required": false,
10933
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
10934
+ },
10935
+ {
10936
+ "name": "--note",
10937
+ "value": "\"<text>\"",
10938
+ "required": false,
10939
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
10940
+ },
9403
10941
  {
9404
10942
  "name": "--root",
9405
10943
  "value": null,
9406
10944
  "required": false,
9407
10945
  "description": "--root, -r <path> Run against a specific repo root"
9408
10946
  },
10947
+ {
10948
+ "name": "--run-id",
10949
+ "value": "<id>",
10950
+ "required": false,
10951
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
10952
+ },
9409
10953
  {
9410
10954
  "name": "--version",
9411
10955
  "value": null,
9412
10956
  "required": false,
9413
10957
  "description": "--version, -V Show version"
10958
+ },
10959
+ {
10960
+ "name": "--ws",
10961
+ "value": "<alias>",
10962
+ "required": false,
10963
+ "description": "mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note \"<text>\"] [--json]"
9414
10964
  }
9415
10965
  ],
9416
10966
  "output_formats": [
@@ -9478,32 +11028,110 @@
9478
11028
  ],
9479
11029
  "flags": [
9480
11030
  {
9481
- "name": "--help",
9482
- "value": null,
11031
+ "name": "--add-artifacts",
11032
+ "value": "<a,...>",
9483
11033
  "required": false,
9484
- "description": "--help, -h Show help"
11034
+ "description": "[--add-artifacts <a,...>] [--add-links <l,...>] [--add-refs <id,...>]"
9485
11035
  },
9486
11036
  {
9487
- "name": "--root",
9488
- "value": null,
11037
+ "name": "--add-blocked-by",
11038
+ "value": "<id,...>",
9489
11039
  "required": false,
9490
- "description": "--root, -r <path> Run against a specific repo root"
11040
+ "description": "[--add-skills <slug,...>] [--add-tags <tag,...>] [--add-blocked-by <id,...>]"
9491
11041
  },
9492
11042
  {
9493
- "name": "--version",
9494
- "value": null,
11043
+ "name": "--add-links",
11044
+ "value": "<l,...>",
9495
11045
  "required": false,
9496
- "description": "--version, -V Show version"
9497
- }
9498
- ],
9499
- "output_formats": [
9500
- "text",
9501
- "json"
9502
- ],
9503
- "json_schema_ref": "mdkg.command_output.v1",
9504
- "side_effects": [
9505
- "update-task"
9506
- ],
11046
+ "description": "[--add-artifacts <a,...>] [--add-links <l,...>] [--add-refs <id,...>]"
11047
+ },
11048
+ {
11049
+ "name": "--add-refs",
11050
+ "value": "<id,...>",
11051
+ "required": false,
11052
+ "description": "[--add-artifacts <a,...>] [--add-links <l,...>] [--add-refs <id,...>]"
11053
+ },
11054
+ {
11055
+ "name": "--add-skills",
11056
+ "value": "<slug,...>",
11057
+ "required": false,
11058
+ "description": "[--add-skills <slug,...>] [--add-tags <tag,...>] [--add-blocked-by <id,...>]"
11059
+ },
11060
+ {
11061
+ "name": "--add-tags",
11062
+ "value": "<tag,...>",
11063
+ "required": false,
11064
+ "description": "[--add-skills <slug,...>] [--add-tags <tag,...>] [--add-blocked-by <id,...>]"
11065
+ },
11066
+ {
11067
+ "name": "--clear-blocked-by",
11068
+ "value": null,
11069
+ "required": false,
11070
+ "description": "[--clear-blocked-by] [--run-id <id>] [--note \"<text>\"] [--json]"
11071
+ },
11072
+ {
11073
+ "name": "--help",
11074
+ "value": null,
11075
+ "required": false,
11076
+ "description": "--help, -h Show help"
11077
+ },
11078
+ {
11079
+ "name": "--json",
11080
+ "value": null,
11081
+ "required": false,
11082
+ "description": "[--clear-blocked-by] [--run-id <id>] [--note \"<text>\"] [--json]"
11083
+ },
11084
+ {
11085
+ "name": "--note",
11086
+ "value": "\"<text>\"",
11087
+ "required": false,
11088
+ "description": "[--clear-blocked-by] [--run-id <id>] [--note \"<text>\"] [--json]"
11089
+ },
11090
+ {
11091
+ "name": "--priority",
11092
+ "value": "<n>",
11093
+ "required": false,
11094
+ "description": "mdkg task update <id-or-qid> [--ws <alias>] [--status <status>] [--priority <n>]"
11095
+ },
11096
+ {
11097
+ "name": "--root",
11098
+ "value": null,
11099
+ "required": false,
11100
+ "description": "--root, -r <path> Run against a specific repo root"
11101
+ },
11102
+ {
11103
+ "name": "--run-id",
11104
+ "value": "<id>",
11105
+ "required": false,
11106
+ "description": "[--clear-blocked-by] [--run-id <id>] [--note \"<text>\"] [--json]"
11107
+ },
11108
+ {
11109
+ "name": "--status",
11110
+ "value": "<status>",
11111
+ "required": false,
11112
+ "description": "mdkg task update <id-or-qid> [--ws <alias>] [--status <status>] [--priority <n>]"
11113
+ },
11114
+ {
11115
+ "name": "--version",
11116
+ "value": null,
11117
+ "required": false,
11118
+ "description": "--version, -V Show version"
11119
+ },
11120
+ {
11121
+ "name": "--ws",
11122
+ "value": "<alias>",
11123
+ "required": false,
11124
+ "description": "mdkg task update <id-or-qid> [--ws <alias>] [--status <status>] [--priority <n>]"
11125
+ }
11126
+ ],
11127
+ "output_formats": [
11128
+ "text",
11129
+ "json"
11130
+ ],
11131
+ "json_schema_ref": "mdkg.command_output.v1",
11132
+ "side_effects": [
11133
+ "update-task"
11134
+ ],
9507
11135
  "read_paths": [
9508
11136
  ".mdkg/**"
9509
11137
  ],
@@ -9557,13 +11185,13 @@
9557
11185
  "name": "--apply",
9558
11186
  "value": null,
9559
11187
  "required": false,
9560
- "description": "--apply Apply safe managed init asset upgrades"
11188
+ "description": "mdkg upgrade [--dry-run] [--apply] [--json]"
9561
11189
  },
9562
11190
  {
9563
11191
  "name": "--dry-run",
9564
11192
  "value": null,
9565
11193
  "required": false,
9566
- "description": "--dry-run Preview upgrade changes without writing files (default)"
11194
+ "description": "mdkg upgrade [--dry-run] [--apply] [--json]"
9567
11195
  },
9568
11196
  {
9569
11197
  "name": "--help",
@@ -9575,7 +11203,7 @@
9575
11203
  "name": "--json",
9576
11204
  "value": null,
9577
11205
  "required": false,
9578
- "description": "--json Emit machine-readable upgrade receipt"
11206
+ "description": "mdkg upgrade [--dry-run] [--apply] [--json]"
9579
11207
  },
9580
11208
  {
9581
11209
  "name": "--root",
@@ -9656,9 +11284,9 @@
9656
11284
  "flags": [
9657
11285
  {
9658
11286
  "name": "--changed-only",
9659
- "value": "filters",
11287
+ "value": null,
9660
11288
  "required": false,
9661
- "description": "--changed-only filters warning presentation to changed .mdkg files while full graph errors still run."
11289
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
9662
11290
  },
9663
11291
  {
9664
11292
  "name": "--help",
@@ -9666,29 +11294,41 @@
9666
11294
  "required": false,
9667
11295
  "description": "--help, -h Show help"
9668
11296
  },
11297
+ {
11298
+ "name": "--json",
11299
+ "value": null,
11300
+ "required": false,
11301
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
11302
+ },
9669
11303
  {
9670
11304
  "name": "--json-out",
9671
- "value": "writes",
11305
+ "value": "<path>",
9672
11306
  "required": false,
9673
- "description": "--out writes the compatibility text report; --json-out writes a clean full JSON receipt."
11307
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
9674
11308
  },
9675
11309
  {
9676
11310
  "name": "--limit",
9677
- "value": "controls",
11311
+ "value": "<n>",
9678
11312
  "required": false,
9679
- "description": "--summary emits bounded warning samples for agent/CI logs; --limit controls the sample size."
11313
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
9680
11314
  },
9681
11315
  {
9682
11316
  "name": "--out",
9683
- "value": "writes",
11317
+ "value": "<path>",
9684
11318
  "required": false,
9685
- "description": "--out writes the compatibility text report; --json-out writes a clean full JSON receipt."
11319
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
9686
11320
  },
9687
11321
  {
9688
11322
  "name": "--profile",
9689
- "value": "omni-room",
11323
+ "value": "<name>",
11324
+ "required": false,
11325
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
11326
+ },
11327
+ {
11328
+ "name": "--quiet",
11329
+ "value": null,
9690
11330
  "required": false,
9691
- "description": "--profile omni-room applies explicit contract-profile validation after generic validation; this is separate from mdkg pack --profile."
11331
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
9692
11332
  },
9693
11333
  {
9694
11334
  "name": "--root",
@@ -9698,9 +11338,9 @@
9698
11338
  },
9699
11339
  {
9700
11340
  "name": "--summary",
9701
- "value": "emits",
11341
+ "value": null,
9702
11342
  "required": false,
9703
- "description": "--summary emits bounded warning samples for agent/CI logs; --limit controls the sample size."
11343
+ "description": "mdkg validate [--out <path>] [--json-out <path>] [--quiet] [--changed-only] [--summary] [--limit <n>] [--profile <name>] [--json]"
9704
11344
  },
9705
11345
  {
9706
11346
  "name": "--version",
@@ -9783,12 +11423,30 @@
9783
11423
  "required": false,
9784
11424
  "description": "--help, -h Show help"
9785
11425
  },
11426
+ {
11427
+ "name": "--json",
11428
+ "value": null,
11429
+ "required": false,
11430
+ "description": "mdkg work validate [<id-or-qid>] [--type <workflow-type>] [--profile <name>] [--json]"
11431
+ },
11432
+ {
11433
+ "name": "--profile",
11434
+ "value": "<name>",
11435
+ "required": false,
11436
+ "description": "mdkg work validate [<id-or-qid>] [--type <workflow-type>] [--profile <name>] [--json]"
11437
+ },
9786
11438
  {
9787
11439
  "name": "--root",
9788
11440
  "value": null,
9789
11441
  "required": false,
9790
11442
  "description": "--root, -r <path> Run against a specific repo root"
9791
11443
  },
11444
+ {
11445
+ "name": "--type",
11446
+ "value": "<workflow-type>",
11447
+ "required": false,
11448
+ "description": "mdkg work validate [<id-or-qid>] [--type <workflow-type>] [--profile <name>] [--json]"
11449
+ },
9792
11450
  {
9793
11451
  "name": "--version",
9794
11452
  "value": null,
@@ -9875,6 +11533,24 @@
9875
11533
  "required": false,
9876
11534
  "description": "--help, -h Show help"
9877
11535
  },
11536
+ {
11537
+ "name": "--id",
11538
+ "value": "<archive.id>",
11539
+ "required": false,
11540
+ "description": "mdkg work artifact add <order-or-receipt-id-or-qid> <file> [--id <archive.id>] [--kind source|artifact] [--json]"
11541
+ },
11542
+ {
11543
+ "name": "--json",
11544
+ "value": null,
11545
+ "required": false,
11546
+ "description": "mdkg work artifact add <order-or-receipt-id-or-qid> <file> [--id <archive.id>] [--kind source|artifact] [--json]"
11547
+ },
11548
+ {
11549
+ "name": "--kind",
11550
+ "value": "source|artifact",
11551
+ "required": false,
11552
+ "description": "mdkg work artifact add <order-or-receipt-id-or-qid> <file> [--id <archive.id>] [--kind source|artifact] [--json]"
11553
+ },
9878
11554
  {
9879
11555
  "name": "--root",
9880
11556
  "value": null,
@@ -9955,6 +11631,12 @@
9955
11631
  {
9956
11632
  "name": "--agent-id",
9957
11633
  "value": "<agent.id>",
11634
+ "required": true,
11635
+ "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
11636
+ },
11637
+ {
11638
+ "name": "--contract-profile",
11639
+ "value": "<name>",
9958
11640
  "required": false,
9959
11641
  "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
9960
11642
  },
@@ -9967,24 +11649,42 @@
9967
11649
  {
9968
11650
  "name": "--id",
9969
11651
  "value": "<work.id>",
9970
- "required": false,
11652
+ "required": true,
9971
11653
  "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
9972
11654
  },
9973
11655
  {
9974
11656
  "name": "--inputs",
9975
11657
  "value": "<...>",
11658
+ "required": true,
11659
+ "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
11660
+ },
11661
+ {
11662
+ "name": "--json",
11663
+ "value": null,
9976
11664
  "required": false,
9977
11665
  "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
9978
11666
  },
9979
11667
  {
9980
11668
  "name": "--kind",
9981
11669
  "value": "<kind>",
9982
- "required": false,
11670
+ "required": true,
9983
11671
  "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
9984
11672
  },
9985
11673
  {
9986
11674
  "name": "--outputs",
9987
11675
  "value": "<...>",
11676
+ "required": true,
11677
+ "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
11678
+ },
11679
+ {
11680
+ "name": "--pricing-model",
11681
+ "value": "<...>",
11682
+ "required": false,
11683
+ "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
11684
+ },
11685
+ {
11686
+ "name": "--required-capabilities",
11687
+ "value": "<...>",
9988
11688
  "required": false,
9989
11689
  "description": "mdkg work contract new \"<title>\" --id <work.id> --agent-id <agent.id> --kind <kind> --inputs <...> --outputs <...> [--contract-profile <name>] [--required-capabilities <...>] [--pricing-model <...>] [--json]"
9990
11690
  },
@@ -10072,6 +11772,36 @@
10072
11772
  }
10073
11773
  ],
10074
11774
  "flags": [
11775
+ {
11776
+ "name": "--add-artifacts",
11777
+ "value": "<...>",
11778
+ "required": false,
11779
+ "description": "mdkg work order update <id-or-qid> [--status <status>] [--add-input-refs <...>] [--add-queue-refs <...>] [--add-artifacts <...>] [--json]"
11780
+ },
11781
+ {
11782
+ "name": "--add-input-refs",
11783
+ "value": "<...>",
11784
+ "required": false,
11785
+ "description": "mdkg work order update <id-or-qid> [--status <status>] [--add-input-refs <...>] [--add-queue-refs <...>] [--add-artifacts <...>] [--json]"
11786
+ },
11787
+ {
11788
+ "name": "--add-queue-refs",
11789
+ "value": "<...>",
11790
+ "required": false,
11791
+ "description": "mdkg work order update <id-or-qid> [--status <status>] [--add-input-refs <...>] [--add-queue-refs <...>] [--add-artifacts <...>] [--json]"
11792
+ },
11793
+ {
11794
+ "name": "--contract-profile",
11795
+ "value": "<name>",
11796
+ "required": false,
11797
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11798
+ },
11799
+ {
11800
+ "name": "--evidence-policy-ref",
11801
+ "value": "<ref>",
11802
+ "required": false,
11803
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11804
+ },
10075
11805
  {
10076
11806
  "name": "--help",
10077
11807
  "value": null,
@@ -10084,6 +11814,42 @@
10084
11814
  "required": false,
10085
11815
  "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
10086
11816
  },
11817
+ {
11818
+ "name": "--input-refs",
11819
+ "value": "<...>",
11820
+ "required": false,
11821
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11822
+ },
11823
+ {
11824
+ "name": "--json",
11825
+ "value": null,
11826
+ "required": false,
11827
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11828
+ },
11829
+ {
11830
+ "name": "--payload-hash",
11831
+ "value": "<sha256:...>",
11832
+ "required": false,
11833
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11834
+ },
11835
+ {
11836
+ "name": "--queue-refs",
11837
+ "value": "<...>",
11838
+ "required": false,
11839
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11840
+ },
11841
+ {
11842
+ "name": "--request-ref",
11843
+ "value": "<ref>",
11844
+ "required": false,
11845
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11846
+ },
11847
+ {
11848
+ "name": "--requested-outputs",
11849
+ "value": "<...>",
11850
+ "required": false,
11851
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11852
+ },
10087
11853
  {
10088
11854
  "name": "--requester",
10089
11855
  "value": "<ref>",
@@ -10096,6 +11862,24 @@
10096
11862
  "required": false,
10097
11863
  "description": "--root, -r <path> Run against a specific repo root"
10098
11864
  },
11865
+ {
11866
+ "name": "--status",
11867
+ "value": "<status>",
11868
+ "required": false,
11869
+ "description": "mdkg work order update <id-or-qid> [--status <status>] [--add-input-refs <...>] [--add-queue-refs <...>] [--add-artifacts <...>] [--json]"
11870
+ },
11871
+ {
11872
+ "name": "--trigger-ref",
11873
+ "value": "<ref>",
11874
+ "required": false,
11875
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11876
+ },
11877
+ {
11878
+ "name": "--validation-policy-ref",
11879
+ "value": "<ref>",
11880
+ "required": false,
11881
+ "description": "mdkg work order new \"<title>\" --id <order.id> --work-id <work.id> --requester <ref> [--contract-profile <name>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--request-ref <ref>] [--trigger-ref <ref>] [--payload-hash <sha256:...>] [--input-refs <...>] [--queue-refs <...>] [--requested-outputs <...>] [--json]"
11882
+ },
10099
11883
  {
10100
11884
  "name": "--version",
10101
11885
  "value": null,
@@ -10177,6 +11961,48 @@
10177
11961
  }
10178
11962
  ],
10179
11963
  "flags": [
11964
+ {
11965
+ "name": "--add-artifacts",
11966
+ "value": "<...>",
11967
+ "required": false,
11968
+ "description": "mdkg work receipt update <id-or-qid> [--receipt-status <status>] [--add-artifacts <...>] [--add-proof-refs <...>] [--add-attestation-refs <...>] [--add-evidence-hashes <sha256:...>] [--json]"
11969
+ },
11970
+ {
11971
+ "name": "--add-attestation-refs",
11972
+ "value": "<...>",
11973
+ "required": false,
11974
+ "description": "mdkg work receipt update <id-or-qid> [--receipt-status <status>] [--add-artifacts <...>] [--add-proof-refs <...>] [--add-attestation-refs <...>] [--add-evidence-hashes <sha256:...>] [--json]"
11975
+ },
11976
+ {
11977
+ "name": "--add-evidence-hashes",
11978
+ "value": "<sha256:...>",
11979
+ "required": false,
11980
+ "description": "mdkg work receipt update <id-or-qid> [--receipt-status <status>] [--add-artifacts <...>] [--add-proof-refs <...>] [--add-attestation-refs <...>] [--add-evidence-hashes <sha256:...>] [--json]"
11981
+ },
11982
+ {
11983
+ "name": "--add-proof-refs",
11984
+ "value": "<...>",
11985
+ "required": false,
11986
+ "description": "mdkg work receipt update <id-or-qid> [--receipt-status <status>] [--add-artifacts <...>] [--add-proof-refs <...>] [--add-attestation-refs <...>] [--add-evidence-hashes <sha256:...>] [--json]"
11987
+ },
11988
+ {
11989
+ "name": "--contract-profile",
11990
+ "value": "<name>",
11991
+ "required": false,
11992
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
11993
+ },
11994
+ {
11995
+ "name": "--evidence-hashes",
11996
+ "value": "<sha256:...>",
11997
+ "required": false,
11998
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
11999
+ },
12000
+ {
12001
+ "name": "--evidence-policy-ref",
12002
+ "value": "<ref>",
12003
+ "required": false,
12004
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12005
+ },
10180
12006
  {
10181
12007
  "name": "--help",
10182
12008
  "value": null,
@@ -10189,18 +12015,54 @@
10189
12015
  "required": false,
10190
12016
  "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
10191
12017
  },
12018
+ {
12019
+ "name": "--json",
12020
+ "value": null,
12021
+ "required": false,
12022
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12023
+ },
10192
12024
  {
10193
12025
  "name": "--outcome",
10194
12026
  "value": "success|partial|failure",
10195
12027
  "required": false,
10196
12028
  "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
10197
12029
  },
12030
+ {
12031
+ "name": "--receipt-kind",
12032
+ "value": "<kind>",
12033
+ "required": false,
12034
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12035
+ },
12036
+ {
12037
+ "name": "--receipt-status",
12038
+ "value": "recorded|verified|rejected|superseded",
12039
+ "required": false,
12040
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12041
+ },
12042
+ {
12043
+ "name": "--redaction-class",
12044
+ "value": "<class>",
12045
+ "required": false,
12046
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12047
+ },
12048
+ {
12049
+ "name": "--redaction-policy",
12050
+ "value": "refs_and_hashes_only|redacted_summary|external_private",
12051
+ "required": false,
12052
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12053
+ },
10198
12054
  {
10199
12055
  "name": "--root",
10200
12056
  "value": null,
10201
12057
  "required": false,
10202
12058
  "description": "--root, -r <path> Run against a specific repo root"
10203
12059
  },
12060
+ {
12061
+ "name": "--validation-policy-ref",
12062
+ "value": "<ref>",
12063
+ "required": false,
12064
+ "description": "mdkg work receipt new \"<title>\" --id <receipt.id> --work-order-id <order.id> --outcome success|partial|failure [--receipt-status recorded|verified|rejected|superseded] [--redaction-policy refs_and_hashes_only|redacted_summary|external_private] [--contract-profile <name>] [--receipt-kind <kind>] [--redaction-class <class>] [--validation-policy-ref <ref>] [--evidence-policy-ref <ref>] [--evidence-hashes <sha256:...>] [--json]"
12065
+ },
10204
12066
  {
10205
12067
  "name": "--version",
10206
12068
  "value": null,
@@ -10286,6 +12148,12 @@
10286
12148
  }
10287
12149
  ],
10288
12150
  "flags": [
12151
+ {
12152
+ "name": "--enqueue",
12153
+ "value": "<queue>",
12154
+ "required": false,
12155
+ "description": "mdkg work trigger <work-or-capability-ref> [--id <order.id>] [--title \"<title>\"] [--requester <ref>] [--enqueue <queue>] [--json]"
12156
+ },
10289
12157
  {
10290
12158
  "name": "--help",
10291
12159
  "value": null,
@@ -10294,21 +12162,21 @@
10294
12162
  },
10295
12163
  {
10296
12164
  "name": "--id",
10297
- "value": "order.example-1",
12165
+ "value": "<order.id>",
10298
12166
  "required": false,
10299
- "description": "mdkg work trigger work.example --id order.example-1 --requester user://example --json"
12167
+ "description": "mdkg work trigger <work-or-capability-ref> [--id <order.id>] [--title \"<title>\"] [--requester <ref>] [--enqueue <queue>] [--json]"
10300
12168
  },
10301
12169
  {
10302
12170
  "name": "--json",
10303
12171
  "value": null,
10304
12172
  "required": false,
10305
- "description": "mdkg work trigger work.example --id order.example-1 --requester user://example --json"
12173
+ "description": "mdkg work trigger <work-or-capability-ref> [--id <order.id>] [--title \"<title>\"] [--requester <ref>] [--enqueue <queue>] [--json]"
10306
12174
  },
10307
12175
  {
10308
12176
  "name": "--requester",
10309
- "value": "user://example",
12177
+ "value": "<ref>",
10310
12178
  "required": false,
10311
- "description": "mdkg work trigger work.example --id order.example-1 --requester user://example --json"
12179
+ "description": "mdkg work trigger <work-or-capability-ref> [--id <order.id>] [--title \"<title>\"] [--requester <ref>] [--enqueue <queue>] [--json]"
10312
12180
  },
10313
12181
  {
10314
12182
  "name": "--root",
@@ -10316,6 +12184,12 @@
10316
12184
  "required": false,
10317
12185
  "description": "--root, -r <path> Run against a specific repo root"
10318
12186
  },
12187
+ {
12188
+ "name": "--title",
12189
+ "value": "\"<title>\"",
12190
+ "required": false,
12191
+ "description": "mdkg work trigger <work-or-capability-ref> [--id <order.id>] [--title \"<title>\"] [--requester <ref>] [--enqueue <queue>] [--json]"
12192
+ },
10319
12193
  {
10320
12194
  "name": "--version",
10321
12195
  "value": null,
@@ -10394,11 +12268,17 @@
10394
12268
  "required": false,
10395
12269
  "description": "--help, -h Show help"
10396
12270
  },
12271
+ {
12272
+ "name": "--json",
12273
+ "value": null,
12274
+ "required": false,
12275
+ "description": "mdkg work validate [<id-or-qid>] [--type manifest|spec|work|work_order|receipt|feedback|dispute|proposal] [--profile <name>] [--json]"
12276
+ },
10397
12277
  {
10398
12278
  "name": "--profile",
10399
- "value": "omni-room",
12279
+ "value": "<name>",
10400
12280
  "required": false,
10401
- "description": "--profile omni-room applies explicit contract-profile validation after generic mirror validation; this is separate from mdkg pack --profile."
12281
+ "description": "mdkg work validate [<id-or-qid>] [--type manifest|spec|work|work_order|receipt|feedback|dispute|proposal] [--profile <name>] [--json]"
10402
12282
  },
10403
12283
  {
10404
12284
  "name": "--root",
@@ -10406,6 +12286,12 @@
10406
12286
  "required": false,
10407
12287
  "description": "--root, -r <path> Run against a specific repo root"
10408
12288
  },
12289
+ {
12290
+ "name": "--type",
12291
+ "value": "manifest|spec|work|work_order|receipt|feedback|dispute|proposal",
12292
+ "required": false,
12293
+ "description": "mdkg work validate [<id-or-qid>] [--type manifest|spec|work|work_order|receipt|feedback|dispute|proposal] [--profile <name>] [--json]"
12294
+ },
10409
12295
  {
10410
12296
  "name": "--version",
10411
12297
  "value": null,
@@ -10488,6 +12374,18 @@
10488
12374
  "required": false,
10489
12375
  "description": "--help, -h Show help"
10490
12376
  },
12377
+ {
12378
+ "name": "--json",
12379
+ "value": null,
12380
+ "required": false,
12381
+ "description": "mdkg workspace ls [--json]"
12382
+ },
12383
+ {
12384
+ "name": "--mdkg-dir",
12385
+ "value": "<dir>",
12386
+ "required": false,
12387
+ "description": "mdkg workspace add <alias> <path> [--mdkg-dir <dir>] [--visibility <level>] [--json]"
12388
+ },
10491
12389
  {
10492
12390
  "name": "--root",
10493
12391
  "value": null,
@@ -10499,6 +12397,12 @@
10499
12397
  "value": null,
10500
12398
  "required": false,
10501
12399
  "description": "--version, -V Show version"
12400
+ },
12401
+ {
12402
+ "name": "--visibility",
12403
+ "value": "<level>",
12404
+ "required": false,
12405
+ "description": "mdkg workspace add <alias> <path> [--mdkg-dir <dir>] [--visibility <level>] [--json]"
10502
12406
  }
10503
12407
  ],
10504
12408
  "output_formats": [
@@ -10548,5 +12452,5 @@
10548
12452
  }
10549
12453
  }
10550
12454
  ],
10551
- "contract_hash": "e9bd2d82d340887bc58d518c7e67541996f4b7744b2d1981763060575265aa29"
12455
+ "contract_hash": "0ab5c4cc2288334720c20a27f7d141776d7e9b92420a1592bc4ffabbb508701d"
10552
12456
  }