mdkg 0.3.3 → 0.3.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +80 -0
- package/CLI_COMMAND_MATRIX.md +61 -10
- package/README.md +29 -4
- package/dist/cli.js +141 -8
- package/dist/command-contract.json +588 -9
- package/dist/commands/fix.js +468 -16
- package/dist/commands/graph.js +582 -0
- package/dist/commands/validate.js +16 -11
- package/dist/init/CLI_COMMAND_MATRIX.md +26 -3
- package/dist/init/README.md +25 -3
- package/dist/init/init-manifest.json +3 -3
- package/dist/util/argparse.js +3 -0
- package/package.json +4 -2
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schema_version": 1,
|
|
3
3
|
"tool": "mdkg",
|
|
4
|
-
"package_version": "0.3.
|
|
4
|
+
"package_version": "0.3.5",
|
|
5
5
|
"source": {
|
|
6
6
|
"help_targets": "scripts/cli_help_targets.js",
|
|
7
7
|
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
@@ -2050,7 +2050,9 @@
|
|
|
2050
2050
|
"visibility": "public",
|
|
2051
2051
|
"summary": "mdkg fix command",
|
|
2052
2052
|
"usage": [
|
|
2053
|
-
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--json]"
|
|
2053
|
+
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]",
|
|
2054
|
+
" mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]",
|
|
2055
|
+
" mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
|
|
2054
2056
|
],
|
|
2055
2057
|
"args": [],
|
|
2056
2058
|
"flags": [
|
|
@@ -2104,13 +2106,232 @@
|
|
|
2104
2106
|
}
|
|
2105
2107
|
],
|
|
2106
2108
|
"examples": [
|
|
2107
|
-
" mdkg fix
|
|
2109
|
+
" mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]",
|
|
2110
|
+
" mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]",
|
|
2111
|
+
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
|
|
2108
2112
|
],
|
|
2109
2113
|
"docs": {
|
|
2110
2114
|
"help_target": "mdkg help fix",
|
|
2111
2115
|
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
2112
2116
|
}
|
|
2113
2117
|
},
|
|
2118
|
+
{
|
|
2119
|
+
"key": "fix apply",
|
|
2120
|
+
"path": [
|
|
2121
|
+
"fix",
|
|
2122
|
+
"apply"
|
|
2123
|
+
],
|
|
2124
|
+
"category": "fix",
|
|
2125
|
+
"status": "stable",
|
|
2126
|
+
"visibility": "public",
|
|
2127
|
+
"summary": "mdkg fix apply command",
|
|
2128
|
+
"usage": [
|
|
2129
|
+
" mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
|
|
2130
|
+
],
|
|
2131
|
+
"args": [],
|
|
2132
|
+
"flags": [
|
|
2133
|
+
{
|
|
2134
|
+
"name": "--base-ref",
|
|
2135
|
+
"value": "<ref>",
|
|
2136
|
+
"required": false,
|
|
2137
|
+
"description": "--base-ref <ref> Prefer IDs that already exist at a Git base ref"
|
|
2138
|
+
},
|
|
2139
|
+
{
|
|
2140
|
+
"name": "--family",
|
|
2141
|
+
"value": "ids",
|
|
2142
|
+
"required": false,
|
|
2143
|
+
"description": "--family ids Explicit apply family; ids is the only supported apply family"
|
|
2144
|
+
},
|
|
2145
|
+
{
|
|
2146
|
+
"name": "--help",
|
|
2147
|
+
"value": null,
|
|
2148
|
+
"required": false,
|
|
2149
|
+
"description": "--help, -h Show help"
|
|
2150
|
+
},
|
|
2151
|
+
{
|
|
2152
|
+
"name": "--json",
|
|
2153
|
+
"value": null,
|
|
2154
|
+
"required": false,
|
|
2155
|
+
"description": "--json Emit machine-readable JSON output"
|
|
2156
|
+
},
|
|
2157
|
+
{
|
|
2158
|
+
"name": "--root",
|
|
2159
|
+
"value": null,
|
|
2160
|
+
"required": false,
|
|
2161
|
+
"description": "--root, -r <path> Run against a specific repo root"
|
|
2162
|
+
},
|
|
2163
|
+
{
|
|
2164
|
+
"name": "--target",
|
|
2165
|
+
"value": "<id-or-qid>",
|
|
2166
|
+
"required": false,
|
|
2167
|
+
"description": "--target <id-or-qid> Optional duplicate ID target"
|
|
2168
|
+
},
|
|
2169
|
+
{
|
|
2170
|
+
"name": "--version",
|
|
2171
|
+
"value": null,
|
|
2172
|
+
"required": false,
|
|
2173
|
+
"description": "--version, -V Show version"
|
|
2174
|
+
}
|
|
2175
|
+
],
|
|
2176
|
+
"output_formats": [
|
|
2177
|
+
"text",
|
|
2178
|
+
"json"
|
|
2179
|
+
],
|
|
2180
|
+
"json_schema_ref": "mdkg.fix_apply.v1",
|
|
2181
|
+
"side_effects": [
|
|
2182
|
+
"rebuild-derived-indexes",
|
|
2183
|
+
"rewrite-duplicate-node-ids"
|
|
2184
|
+
],
|
|
2185
|
+
"read_paths": [
|
|
2186
|
+
".mdkg/**"
|
|
2187
|
+
],
|
|
2188
|
+
"write_paths": [
|
|
2189
|
+
".mdkg/**/*.md",
|
|
2190
|
+
".mdkg/index/**"
|
|
2191
|
+
],
|
|
2192
|
+
"dry_run": {
|
|
2193
|
+
"supported": false,
|
|
2194
|
+
"apply_supported": true,
|
|
2195
|
+
"apply_family": "ids"
|
|
2196
|
+
},
|
|
2197
|
+
"lock_policy": "mutation-lock-required",
|
|
2198
|
+
"atomic_write_policy": "atomic-file-writes",
|
|
2199
|
+
"receipts": [
|
|
2200
|
+
"fix-apply-receipt"
|
|
2201
|
+
],
|
|
2202
|
+
"danger_level": "high",
|
|
2203
|
+
"aliases": [],
|
|
2204
|
+
"exit_codes": [
|
|
2205
|
+
{
|
|
2206
|
+
"code": 0,
|
|
2207
|
+
"meaning": "success"
|
|
2208
|
+
},
|
|
2209
|
+
{
|
|
2210
|
+
"code": 1,
|
|
2211
|
+
"meaning": "validation-or-runtime-error"
|
|
2212
|
+
}
|
|
2213
|
+
],
|
|
2214
|
+
"examples": [
|
|
2215
|
+
" mdkg fix apply [--family ids] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
|
|
2216
|
+
],
|
|
2217
|
+
"docs": {
|
|
2218
|
+
"help_target": "mdkg help fix apply",
|
|
2219
|
+
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
2220
|
+
}
|
|
2221
|
+
},
|
|
2222
|
+
{
|
|
2223
|
+
"key": "fix ids",
|
|
2224
|
+
"path": [
|
|
2225
|
+
"fix",
|
|
2226
|
+
"ids"
|
|
2227
|
+
],
|
|
2228
|
+
"category": "fix",
|
|
2229
|
+
"status": "stable",
|
|
2230
|
+
"visibility": "public",
|
|
2231
|
+
"summary": "mdkg fix ids command",
|
|
2232
|
+
"usage": [
|
|
2233
|
+
" mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
|
|
2234
|
+
],
|
|
2235
|
+
"args": [],
|
|
2236
|
+
"flags": [
|
|
2237
|
+
{
|
|
2238
|
+
"name": "--apply",
|
|
2239
|
+
"value": "it",
|
|
2240
|
+
"required": false,
|
|
2241
|
+
"description": "- without --apply it is equivalent to `mdkg fix plan --family ids`"
|
|
2242
|
+
},
|
|
2243
|
+
{
|
|
2244
|
+
"name": "--base-ref",
|
|
2245
|
+
"value": "<ref>",
|
|
2246
|
+
"required": false,
|
|
2247
|
+
"description": "--base-ref <ref> Prefer IDs that already exist at a Git base ref"
|
|
2248
|
+
},
|
|
2249
|
+
{
|
|
2250
|
+
"name": "--family",
|
|
2251
|
+
"value": "ids`",
|
|
2252
|
+
"required": false,
|
|
2253
|
+
"description": "- without --apply it is equivalent to `mdkg fix plan --family ids`"
|
|
2254
|
+
},
|
|
2255
|
+
{
|
|
2256
|
+
"name": "--help",
|
|
2257
|
+
"value": null,
|
|
2258
|
+
"required": false,
|
|
2259
|
+
"description": "--help, -h Show help"
|
|
2260
|
+
},
|
|
2261
|
+
{
|
|
2262
|
+
"name": "--json",
|
|
2263
|
+
"value": null,
|
|
2264
|
+
"required": false,
|
|
2265
|
+
"description": "--json Emit machine-readable JSON output"
|
|
2266
|
+
},
|
|
2267
|
+
{
|
|
2268
|
+
"name": "--root",
|
|
2269
|
+
"value": null,
|
|
2270
|
+
"required": false,
|
|
2271
|
+
"description": "--root, -r <path> Run against a specific repo root"
|
|
2272
|
+
},
|
|
2273
|
+
{
|
|
2274
|
+
"name": "--target",
|
|
2275
|
+
"value": "<id-or-qid>",
|
|
2276
|
+
"required": false,
|
|
2277
|
+
"description": "--target <id-or-qid> Optional duplicate ID target"
|
|
2278
|
+
},
|
|
2279
|
+
{
|
|
2280
|
+
"name": "--version",
|
|
2281
|
+
"value": null,
|
|
2282
|
+
"required": false,
|
|
2283
|
+
"description": "--version, -V Show version"
|
|
2284
|
+
}
|
|
2285
|
+
],
|
|
2286
|
+
"output_formats": [
|
|
2287
|
+
"text",
|
|
2288
|
+
"json"
|
|
2289
|
+
],
|
|
2290
|
+
"json_schema_ref": "mdkg.fix_ids.v1",
|
|
2291
|
+
"side_effects": [
|
|
2292
|
+
"plan-or-rewrite-duplicate-node-ids",
|
|
2293
|
+
"rebuild-derived-indexes-when-apply"
|
|
2294
|
+
],
|
|
2295
|
+
"read_paths": [
|
|
2296
|
+
".mdkg/**"
|
|
2297
|
+
],
|
|
2298
|
+
"write_paths": [
|
|
2299
|
+
".mdkg/**/*.md",
|
|
2300
|
+
".mdkg/index/**"
|
|
2301
|
+
],
|
|
2302
|
+
"dry_run": {
|
|
2303
|
+
"supported": true,
|
|
2304
|
+
"default": true,
|
|
2305
|
+
"apply_flag": "--apply",
|
|
2306
|
+
"apply_supported": true,
|
|
2307
|
+
"apply_family": "ids"
|
|
2308
|
+
},
|
|
2309
|
+
"lock_policy": "mutation-lock-required-when-apply",
|
|
2310
|
+
"atomic_write_policy": "atomic-file-writes-when-apply",
|
|
2311
|
+
"receipts": [
|
|
2312
|
+
"fix-apply-receipt",
|
|
2313
|
+
"fix-plan-receipt"
|
|
2314
|
+
],
|
|
2315
|
+
"danger_level": "high",
|
|
2316
|
+
"aliases": [],
|
|
2317
|
+
"exit_codes": [
|
|
2318
|
+
{
|
|
2319
|
+
"code": 0,
|
|
2320
|
+
"meaning": "success"
|
|
2321
|
+
},
|
|
2322
|
+
{
|
|
2323
|
+
"code": 1,
|
|
2324
|
+
"meaning": "validation-or-runtime-error"
|
|
2325
|
+
}
|
|
2326
|
+
],
|
|
2327
|
+
"examples": [
|
|
2328
|
+
" mdkg fix ids [--target <id-or-qid>] [--base-ref <ref>] [--apply] [--json]"
|
|
2329
|
+
],
|
|
2330
|
+
"docs": {
|
|
2331
|
+
"help_target": "mdkg help fix ids",
|
|
2332
|
+
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
2333
|
+
}
|
|
2334
|
+
},
|
|
2114
2335
|
{
|
|
2115
2336
|
"key": "fix plan",
|
|
2116
2337
|
"path": [
|
|
@@ -2122,15 +2343,21 @@
|
|
|
2122
2343
|
"visibility": "public",
|
|
2123
2344
|
"summary": "mdkg fix plan command",
|
|
2124
2345
|
"usage": [
|
|
2125
|
-
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--json]"
|
|
2346
|
+
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
|
|
2126
2347
|
],
|
|
2127
2348
|
"args": [],
|
|
2128
2349
|
"flags": [
|
|
2350
|
+
{
|
|
2351
|
+
"name": "--base-ref",
|
|
2352
|
+
"value": "<ref>",
|
|
2353
|
+
"required": false,
|
|
2354
|
+
"description": "--base-ref <ref> Prefer IDs that already exist at a Git base ref"
|
|
2355
|
+
},
|
|
2129
2356
|
{
|
|
2130
2357
|
"name": "--family",
|
|
2131
|
-
"value": "
|
|
2358
|
+
"value": "ids`",
|
|
2132
2359
|
"required": false,
|
|
2133
|
-
"description": "
|
|
2360
|
+
"description": "- ids-family duplicate-id repairs can be applied with `mdkg fix apply --family ids`"
|
|
2134
2361
|
},
|
|
2135
2362
|
{
|
|
2136
2363
|
"name": "--help",
|
|
@@ -2178,7 +2405,8 @@
|
|
|
2178
2405
|
"dry_run": {
|
|
2179
2406
|
"supported": true,
|
|
2180
2407
|
"default": true,
|
|
2181
|
-
"apply_supported":
|
|
2408
|
+
"apply_supported": true,
|
|
2409
|
+
"apply_family": "ids"
|
|
2182
2410
|
},
|
|
2183
2411
|
"lock_policy": "none-read-only",
|
|
2184
2412
|
"atomic_write_policy": "none-read-only",
|
|
@@ -2198,7 +2426,7 @@
|
|
|
2198
2426
|
}
|
|
2199
2427
|
],
|
|
2200
2428
|
"examples": [
|
|
2201
|
-
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--json]"
|
|
2429
|
+
" mdkg fix plan [--family index|refs|ids|all] [--target <id-or-qid>] [--base-ref <ref>] [--json]"
|
|
2202
2430
|
],
|
|
2203
2431
|
"docs": {
|
|
2204
2432
|
"help_target": "mdkg help fix plan",
|
|
@@ -3486,6 +3714,357 @@
|
|
|
3486
3714
|
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
3487
3715
|
}
|
|
3488
3716
|
},
|
|
3717
|
+
{
|
|
3718
|
+
"key": "graph",
|
|
3719
|
+
"path": [
|
|
3720
|
+
"graph"
|
|
3721
|
+
],
|
|
3722
|
+
"category": "graph",
|
|
3723
|
+
"status": "stable",
|
|
3724
|
+
"visibility": "public",
|
|
3725
|
+
"summary": "mdkg graph command",
|
|
3726
|
+
"usage": [
|
|
3727
|
+
" mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]",
|
|
3728
|
+
" mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]",
|
|
3729
|
+
" mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
|
|
3730
|
+
],
|
|
3731
|
+
"args": [
|
|
3732
|
+
{
|
|
3733
|
+
"name": "source-bundle-or-mdkg-dir",
|
|
3734
|
+
"required": true,
|
|
3735
|
+
"source": "<source-bundle-or-mdkg-dir>"
|
|
3736
|
+
}
|
|
3737
|
+
],
|
|
3738
|
+
"flags": [
|
|
3739
|
+
{
|
|
3740
|
+
"name": "--help",
|
|
3741
|
+
"value": null,
|
|
3742
|
+
"required": false,
|
|
3743
|
+
"description": "--help, -h Show help"
|
|
3744
|
+
},
|
|
3745
|
+
{
|
|
3746
|
+
"name": "--root",
|
|
3747
|
+
"value": null,
|
|
3748
|
+
"required": false,
|
|
3749
|
+
"description": "--root, -r <path> Run against a specific repo root"
|
|
3750
|
+
},
|
|
3751
|
+
{
|
|
3752
|
+
"name": "--target",
|
|
3753
|
+
"value": "<path>",
|
|
3754
|
+
"required": false,
|
|
3755
|
+
"description": "mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
|
|
3756
|
+
},
|
|
3757
|
+
{
|
|
3758
|
+
"name": "--version",
|
|
3759
|
+
"value": null,
|
|
3760
|
+
"required": false,
|
|
3761
|
+
"description": "--version, -V Show version"
|
|
3762
|
+
}
|
|
3763
|
+
],
|
|
3764
|
+
"output_formats": [
|
|
3765
|
+
"text",
|
|
3766
|
+
"json"
|
|
3767
|
+
],
|
|
3768
|
+
"json_schema_ref": "mdkg.command_output.v1",
|
|
3769
|
+
"side_effects": [
|
|
3770
|
+
"none"
|
|
3771
|
+
],
|
|
3772
|
+
"read_paths": [
|
|
3773
|
+
".mdkg/**"
|
|
3774
|
+
],
|
|
3775
|
+
"write_paths": [],
|
|
3776
|
+
"dry_run": {
|
|
3777
|
+
"supported": false
|
|
3778
|
+
},
|
|
3779
|
+
"lock_policy": "none-read-only",
|
|
3780
|
+
"atomic_write_policy": "none-read-only",
|
|
3781
|
+
"receipts": [],
|
|
3782
|
+
"danger_level": "read-only",
|
|
3783
|
+
"aliases": [],
|
|
3784
|
+
"exit_codes": [
|
|
3785
|
+
{
|
|
3786
|
+
"code": 0,
|
|
3787
|
+
"meaning": "success"
|
|
3788
|
+
},
|
|
3789
|
+
{
|
|
3790
|
+
"code": 1,
|
|
3791
|
+
"meaning": "validation-or-runtime-error"
|
|
3792
|
+
}
|
|
3793
|
+
],
|
|
3794
|
+
"examples": [
|
|
3795
|
+
" mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]",
|
|
3796
|
+
" mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]",
|
|
3797
|
+
" mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
|
|
3798
|
+
],
|
|
3799
|
+
"docs": {
|
|
3800
|
+
"help_target": "mdkg help graph",
|
|
3801
|
+
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
3802
|
+
}
|
|
3803
|
+
},
|
|
3804
|
+
{
|
|
3805
|
+
"key": "graph clone",
|
|
3806
|
+
"path": [
|
|
3807
|
+
"graph",
|
|
3808
|
+
"clone"
|
|
3809
|
+
],
|
|
3810
|
+
"category": "graph",
|
|
3811
|
+
"status": "stable",
|
|
3812
|
+
"visibility": "public",
|
|
3813
|
+
"summary": "mdkg graph clone command",
|
|
3814
|
+
"usage": [
|
|
3815
|
+
" mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
|
|
3816
|
+
],
|
|
3817
|
+
"args": [
|
|
3818
|
+
{
|
|
3819
|
+
"name": "source-bundle-or-mdkg-dir",
|
|
3820
|
+
"required": true,
|
|
3821
|
+
"source": "<source-bundle-or-mdkg-dir>"
|
|
3822
|
+
}
|
|
3823
|
+
],
|
|
3824
|
+
"flags": [
|
|
3825
|
+
{
|
|
3826
|
+
"name": "--help",
|
|
3827
|
+
"value": null,
|
|
3828
|
+
"required": false,
|
|
3829
|
+
"description": "--help, -h Show help"
|
|
3830
|
+
},
|
|
3831
|
+
{
|
|
3832
|
+
"name": "--root",
|
|
3833
|
+
"value": null,
|
|
3834
|
+
"required": false,
|
|
3835
|
+
"description": "--root, -r <path> Run against a specific repo root"
|
|
3836
|
+
},
|
|
3837
|
+
{
|
|
3838
|
+
"name": "--target",
|
|
3839
|
+
"value": "<path>",
|
|
3840
|
+
"required": false,
|
|
3841
|
+
"description": "mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
|
|
3842
|
+
},
|
|
3843
|
+
{
|
|
3844
|
+
"name": "--version",
|
|
3845
|
+
"value": null,
|
|
3846
|
+
"required": false,
|
|
3847
|
+
"description": "--version, -V Show version"
|
|
3848
|
+
}
|
|
3849
|
+
],
|
|
3850
|
+
"output_formats": [
|
|
3851
|
+
"text",
|
|
3852
|
+
"json"
|
|
3853
|
+
],
|
|
3854
|
+
"json_schema_ref": "mdkg.command_output.v1",
|
|
3855
|
+
"side_effects": [
|
|
3856
|
+
"none"
|
|
3857
|
+
],
|
|
3858
|
+
"read_paths": [
|
|
3859
|
+
".mdkg/**"
|
|
3860
|
+
],
|
|
3861
|
+
"write_paths": [],
|
|
3862
|
+
"dry_run": {
|
|
3863
|
+
"supported": false
|
|
3864
|
+
},
|
|
3865
|
+
"lock_policy": "none-read-only",
|
|
3866
|
+
"atomic_write_policy": "none-read-only",
|
|
3867
|
+
"receipts": [],
|
|
3868
|
+
"danger_level": "read-only",
|
|
3869
|
+
"aliases": [],
|
|
3870
|
+
"exit_codes": [
|
|
3871
|
+
{
|
|
3872
|
+
"code": 0,
|
|
3873
|
+
"meaning": "success"
|
|
3874
|
+
},
|
|
3875
|
+
{
|
|
3876
|
+
"code": 1,
|
|
3877
|
+
"meaning": "validation-or-runtime-error"
|
|
3878
|
+
}
|
|
3879
|
+
],
|
|
3880
|
+
"examples": [
|
|
3881
|
+
" mdkg graph clone <source-bundle-or-mdkg-dir> --target <path> [--json]"
|
|
3882
|
+
],
|
|
3883
|
+
"docs": {
|
|
3884
|
+
"help_target": "mdkg help graph clone",
|
|
3885
|
+
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
3886
|
+
}
|
|
3887
|
+
},
|
|
3888
|
+
{
|
|
3889
|
+
"key": "graph fork",
|
|
3890
|
+
"path": [
|
|
3891
|
+
"graph",
|
|
3892
|
+
"fork"
|
|
3893
|
+
],
|
|
3894
|
+
"category": "graph",
|
|
3895
|
+
"status": "stable",
|
|
3896
|
+
"visibility": "public",
|
|
3897
|
+
"summary": "mdkg graph fork command",
|
|
3898
|
+
"usage": [
|
|
3899
|
+
" mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
|
|
3900
|
+
],
|
|
3901
|
+
"args": [
|
|
3902
|
+
{
|
|
3903
|
+
"name": "source-bundle-or-mdkg-dir",
|
|
3904
|
+
"required": true,
|
|
3905
|
+
"source": "<source-bundle-or-mdkg-dir>"
|
|
3906
|
+
}
|
|
3907
|
+
],
|
|
3908
|
+
"flags": [
|
|
3909
|
+
{
|
|
3910
|
+
"name": "--help",
|
|
3911
|
+
"value": null,
|
|
3912
|
+
"required": false,
|
|
3913
|
+
"description": "--help, -h Show help"
|
|
3914
|
+
},
|
|
3915
|
+
{
|
|
3916
|
+
"name": "--root",
|
|
3917
|
+
"value": null,
|
|
3918
|
+
"required": false,
|
|
3919
|
+
"description": "--root, -r <path> Run against a specific repo root"
|
|
3920
|
+
},
|
|
3921
|
+
{
|
|
3922
|
+
"name": "--target",
|
|
3923
|
+
"value": "<path>",
|
|
3924
|
+
"required": false,
|
|
3925
|
+
"description": "mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
|
|
3926
|
+
},
|
|
3927
|
+
{
|
|
3928
|
+
"name": "--version",
|
|
3929
|
+
"value": null,
|
|
3930
|
+
"required": false,
|
|
3931
|
+
"description": "--version, -V Show version"
|
|
3932
|
+
}
|
|
3933
|
+
],
|
|
3934
|
+
"output_formats": [
|
|
3935
|
+
"text",
|
|
3936
|
+
"json"
|
|
3937
|
+
],
|
|
3938
|
+
"json_schema_ref": "mdkg.command_output.v1",
|
|
3939
|
+
"side_effects": [
|
|
3940
|
+
"none"
|
|
3941
|
+
],
|
|
3942
|
+
"read_paths": [
|
|
3943
|
+
".mdkg/**"
|
|
3944
|
+
],
|
|
3945
|
+
"write_paths": [],
|
|
3946
|
+
"dry_run": {
|
|
3947
|
+
"supported": false
|
|
3948
|
+
},
|
|
3949
|
+
"lock_policy": "none-read-only",
|
|
3950
|
+
"atomic_write_policy": "none-read-only",
|
|
3951
|
+
"receipts": [],
|
|
3952
|
+
"danger_level": "read-only",
|
|
3953
|
+
"aliases": [],
|
|
3954
|
+
"exit_codes": [
|
|
3955
|
+
{
|
|
3956
|
+
"code": 0,
|
|
3957
|
+
"meaning": "success"
|
|
3958
|
+
},
|
|
3959
|
+
{
|
|
3960
|
+
"code": 1,
|
|
3961
|
+
"meaning": "validation-or-runtime-error"
|
|
3962
|
+
}
|
|
3963
|
+
],
|
|
3964
|
+
"examples": [
|
|
3965
|
+
" mdkg graph fork <source-bundle-or-mdkg-dir> --target <path> [--start-goal <goal-id>] [--json]"
|
|
3966
|
+
],
|
|
3967
|
+
"docs": {
|
|
3968
|
+
"help_target": "mdkg help graph fork",
|
|
3969
|
+
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
3970
|
+
}
|
|
3971
|
+
},
|
|
3972
|
+
{
|
|
3973
|
+
"key": "graph import-template",
|
|
3974
|
+
"path": [
|
|
3975
|
+
"graph",
|
|
3976
|
+
"import-template"
|
|
3977
|
+
],
|
|
3978
|
+
"category": "graph",
|
|
3979
|
+
"status": "stable",
|
|
3980
|
+
"visibility": "public",
|
|
3981
|
+
"summary": "mdkg graph import-template command",
|
|
3982
|
+
"usage": [
|
|
3983
|
+
" mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
|
|
3984
|
+
],
|
|
3985
|
+
"args": [
|
|
3986
|
+
{
|
|
3987
|
+
"name": "source-bundle-or-mdkg-dir",
|
|
3988
|
+
"required": true,
|
|
3989
|
+
"source": "<source-bundle-or-mdkg-dir>"
|
|
3990
|
+
}
|
|
3991
|
+
],
|
|
3992
|
+
"flags": [
|
|
3993
|
+
{
|
|
3994
|
+
"name": "--apply",
|
|
3995
|
+
"value": "is",
|
|
3996
|
+
"required": false,
|
|
3997
|
+
"description": "- defaults to dry-run unless --apply is supplied"
|
|
3998
|
+
},
|
|
3999
|
+
{
|
|
4000
|
+
"name": "--help",
|
|
4001
|
+
"value": null,
|
|
4002
|
+
"required": false,
|
|
4003
|
+
"description": "--help, -h Show help"
|
|
4004
|
+
},
|
|
4005
|
+
{
|
|
4006
|
+
"name": "--root",
|
|
4007
|
+
"value": null,
|
|
4008
|
+
"required": false,
|
|
4009
|
+
"description": "--root, -r <path> Run against a specific repo root"
|
|
4010
|
+
},
|
|
4011
|
+
{
|
|
4012
|
+
"name": "--select-goal",
|
|
4013
|
+
"value": "requires",
|
|
4014
|
+
"required": false,
|
|
4015
|
+
"description": "- --select-goal requires --start-goal and writes selected-goal state only after apply validation"
|
|
4016
|
+
},
|
|
4017
|
+
{
|
|
4018
|
+
"name": "--start-goal",
|
|
4019
|
+
"value": "and",
|
|
4020
|
+
"required": false,
|
|
4021
|
+
"description": "- --select-goal requires --start-goal and writes selected-goal state only after apply validation"
|
|
4022
|
+
},
|
|
4023
|
+
{
|
|
4024
|
+
"name": "--version",
|
|
4025
|
+
"value": null,
|
|
4026
|
+
"required": false,
|
|
4027
|
+
"description": "--version, -V Show version"
|
|
4028
|
+
}
|
|
4029
|
+
],
|
|
4030
|
+
"output_formats": [
|
|
4031
|
+
"text",
|
|
4032
|
+
"json"
|
|
4033
|
+
],
|
|
4034
|
+
"json_schema_ref": "mdkg.command_output.v1",
|
|
4035
|
+
"side_effects": [
|
|
4036
|
+
"none"
|
|
4037
|
+
],
|
|
4038
|
+
"read_paths": [
|
|
4039
|
+
".mdkg/**"
|
|
4040
|
+
],
|
|
4041
|
+
"write_paths": [],
|
|
4042
|
+
"dry_run": {
|
|
4043
|
+
"supported": false
|
|
4044
|
+
},
|
|
4045
|
+
"lock_policy": "none-read-only",
|
|
4046
|
+
"atomic_write_policy": "none-read-only",
|
|
4047
|
+
"receipts": [],
|
|
4048
|
+
"danger_level": "read-only",
|
|
4049
|
+
"aliases": [],
|
|
4050
|
+
"exit_codes": [
|
|
4051
|
+
{
|
|
4052
|
+
"code": 0,
|
|
4053
|
+
"meaning": "success"
|
|
4054
|
+
},
|
|
4055
|
+
{
|
|
4056
|
+
"code": 1,
|
|
4057
|
+
"meaning": "validation-or-runtime-error"
|
|
4058
|
+
}
|
|
4059
|
+
],
|
|
4060
|
+
"examples": [
|
|
4061
|
+
" mdkg graph import-template <source-bundle-or-mdkg-dir> [--start-goal <goal-id>] [--select-goal] [--id-prefix <prefix>] [--dry-run] [--apply] [--json]"
|
|
4062
|
+
],
|
|
4063
|
+
"docs": {
|
|
4064
|
+
"help_target": "mdkg help graph import-template",
|
|
4065
|
+
"command_matrix": "CLI_COMMAND_MATRIX.md"
|
|
4066
|
+
}
|
|
4067
|
+
},
|
|
3489
4068
|
{
|
|
3490
4069
|
"key": "guide",
|
|
3491
4070
|
"path": [
|
|
@@ -7636,5 +8215,5 @@
|
|
|
7636
8215
|
}
|
|
7637
8216
|
}
|
|
7638
8217
|
],
|
|
7639
|
-
"contract_hash": "
|
|
8218
|
+
"contract_hash": "2fd862666a24adc363a0912822b639f7e437bf5fd31dea13e6f4d87bf0a57d60"
|
|
7640
8219
|
}
|