mdkg 0.3.2 → 0.3.4

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.3.2",
4
+ "package_version": "0.3.4",
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 plan [--family index|refs|ids|all] [--target <id-or-qid>] [--json]"
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": "<family>",
2358
+ "value": "ids`",
2132
2359
  "required": false,
2133
- "description": "--family <family> Select index, refs, ids, or all (default all)"
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": false
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",
@@ -2430,12 +2658,13 @@
2430
2658
  "usage": [
2431
2659
  " mdkg goal show <goal-id-or-qid> [--json]",
2432
2660
  " mdkg goal select <goal-id-or-qid> [--json]",
2661
+ " mdkg goal activate <goal-id-or-qid> [--json]",
2433
2662
  " mdkg goal current [--json]",
2434
2663
  " mdkg goal next [goal-id-or-qid] [--json]",
2435
2664
  " mdkg goal claim [goal-id-or-qid] <work-id-or-qid> [--json]",
2436
2665
  " mdkg goal evaluate <goal-id-or-qid> [--json]",
2437
2666
  " mdkg goal clear [--json]",
2438
- " mdkg goal pause|resume|done <goal-id-or-qid> [--json]"
2667
+ " mdkg goal pause|resume|done|archive <goal-id-or-qid> [--json]"
2439
2668
  ],
2440
2669
  "args": [
2441
2670
  {
@@ -2505,7 +2734,7 @@
2505
2734
  }
2506
2735
  ],
2507
2736
  "examples": [
2508
- " mdkg goal current [--json]",
2737
+ " mdkg goal activate <goal-id-or-qid> [--json]",
2509
2738
  " mdkg goal select <goal-id-or-qid> [--json]",
2510
2739
  " mdkg goal show <goal-id-or-qid> [--json]"
2511
2740
  ],
@@ -2514,6 +2743,172 @@
2514
2743
  "command_matrix": "CLI_COMMAND_MATRIX.md"
2515
2744
  }
2516
2745
  },
2746
+ {
2747
+ "key": "goal activate",
2748
+ "path": [
2749
+ "goal",
2750
+ "activate"
2751
+ ],
2752
+ "category": "goal",
2753
+ "status": "stable",
2754
+ "visibility": "public",
2755
+ "summary": "mdkg goal activate command",
2756
+ "usage": [
2757
+ " mdkg goal activate <goal-id-or-qid> [--ws <alias>] [--json]"
2758
+ ],
2759
+ "args": [
2760
+ {
2761
+ "name": "goal-id-or-qid",
2762
+ "required": true,
2763
+ "source": "<goal-id-or-qid>"
2764
+ }
2765
+ ],
2766
+ "flags": [
2767
+ {
2768
+ "name": "--help",
2769
+ "value": null,
2770
+ "required": false,
2771
+ "description": "--help, -h Show help"
2772
+ },
2773
+ {
2774
+ "name": "--root",
2775
+ "value": null,
2776
+ "required": false,
2777
+ "description": "--root, -r <path> Run against a specific repo root"
2778
+ },
2779
+ {
2780
+ "name": "--version",
2781
+ "value": null,
2782
+ "required": false,
2783
+ "description": "--version, -V Show version"
2784
+ }
2785
+ ],
2786
+ "output_formats": [
2787
+ "text",
2788
+ "json"
2789
+ ],
2790
+ "json_schema_ref": "mdkg.command_output.v1",
2791
+ "side_effects": [
2792
+ "activate-goal-and-pause-competing-goals"
2793
+ ],
2794
+ "read_paths": [
2795
+ ".mdkg/**"
2796
+ ],
2797
+ "write_paths": [
2798
+ ".mdkg/**/*.md",
2799
+ ".mdkg/index/**"
2800
+ ],
2801
+ "dry_run": {
2802
+ "supported": false
2803
+ },
2804
+ "lock_policy": "mutation-lock-required",
2805
+ "atomic_write_policy": "atomic-file-writes",
2806
+ "receipts": [
2807
+ "goal-state-receipt"
2808
+ ],
2809
+ "danger_level": "moderate",
2810
+ "aliases": [],
2811
+ "exit_codes": [
2812
+ {
2813
+ "code": 0,
2814
+ "meaning": "success"
2815
+ },
2816
+ {
2817
+ "code": 1,
2818
+ "meaning": "validation-or-runtime-error"
2819
+ }
2820
+ ],
2821
+ "examples": [
2822
+ " mdkg goal activate <goal-id-or-qid> [--ws <alias>] [--json]"
2823
+ ],
2824
+ "docs": {
2825
+ "help_target": "mdkg help goal activate",
2826
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
2827
+ }
2828
+ },
2829
+ {
2830
+ "key": "goal archive",
2831
+ "path": [
2832
+ "goal",
2833
+ "archive"
2834
+ ],
2835
+ "category": "goal",
2836
+ "status": "stable",
2837
+ "visibility": "public",
2838
+ "summary": "mdkg goal archive command",
2839
+ "usage": [
2840
+ " mdkg goal archive <goal-id-or-qid> [--ws <alias>] [--json]"
2841
+ ],
2842
+ "args": [
2843
+ {
2844
+ "name": "goal-id-or-qid",
2845
+ "required": true,
2846
+ "source": "<goal-id-or-qid>"
2847
+ }
2848
+ ],
2849
+ "flags": [
2850
+ {
2851
+ "name": "--help",
2852
+ "value": null,
2853
+ "required": false,
2854
+ "description": "--help, -h Show help"
2855
+ },
2856
+ {
2857
+ "name": "--root",
2858
+ "value": null,
2859
+ "required": false,
2860
+ "description": "--root, -r <path> Run against a specific repo root"
2861
+ },
2862
+ {
2863
+ "name": "--version",
2864
+ "value": null,
2865
+ "required": false,
2866
+ "description": "--version, -V Show version"
2867
+ }
2868
+ ],
2869
+ "output_formats": [
2870
+ "text",
2871
+ "json"
2872
+ ],
2873
+ "json_schema_ref": "mdkg.command_output.v1",
2874
+ "side_effects": [
2875
+ "archive-goal"
2876
+ ],
2877
+ "read_paths": [
2878
+ ".mdkg/**"
2879
+ ],
2880
+ "write_paths": [
2881
+ ".mdkg/**/*.md",
2882
+ ".mdkg/index/**"
2883
+ ],
2884
+ "dry_run": {
2885
+ "supported": false
2886
+ },
2887
+ "lock_policy": "mutation-lock-required",
2888
+ "atomic_write_policy": "atomic-file-writes",
2889
+ "receipts": [
2890
+ "goal-state-receipt"
2891
+ ],
2892
+ "danger_level": "moderate",
2893
+ "aliases": [],
2894
+ "exit_codes": [
2895
+ {
2896
+ "code": 0,
2897
+ "meaning": "success"
2898
+ },
2899
+ {
2900
+ "code": 1,
2901
+ "meaning": "validation-or-runtime-error"
2902
+ }
2903
+ ],
2904
+ "examples": [
2905
+ " mdkg goal archive <goal-id-or-qid> [--ws <alias>] [--json]"
2906
+ ],
2907
+ "docs": {
2908
+ "help_target": "mdkg help goal archive",
2909
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
2910
+ }
2911
+ },
2517
2912
  {
2518
2913
  "key": "goal claim",
2519
2914
  "path": [
@@ -7469,5 +7864,5 @@
7469
7864
  }
7470
7865
  }
7471
7866
  ],
7472
- "contract_hash": "226793aa87d0fd57e187936a5ab17a86413149cbd2d52674324921b1e5051ff7"
7867
+ "contract_hash": "a2e027cdfdb590f3882cb824b9c8b1cf153e39ba63738ab0fad2d92277794325"
7473
7868
  }