mdkg 0.4.1 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "schema_version": 1,
3
3
  "tool": "mdkg",
4
- "package_version": "0.4.1",
4
+ "package_version": "0.4.2",
5
5
  "source": {
6
6
  "help_targets": "scripts/cli_help_targets.js",
7
7
  "command_matrix": "CLI_COMMAND_MATRIX.md"
@@ -2665,6 +2665,630 @@
2665
2665
  "command_matrix": "CLI_COMMAND_MATRIX.md"
2666
2666
  }
2667
2667
  },
2668
+ {
2669
+ "key": "git",
2670
+ "path": [
2671
+ "git"
2672
+ ],
2673
+ "category": "git",
2674
+ "status": "stable",
2675
+ "visibility": "public",
2676
+ "summary": "mdkg git command",
2677
+ "usage": [
2678
+ " mdkg git inspect [--json]",
2679
+ " mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]",
2680
+ " mdkg git fetch [--remote <name>] [--branch <name>] [--json]",
2681
+ " mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]",
2682
+ " mdkg git push-ready --remote <name> --branch <name> [--json]",
2683
+ " mdkg git push --remote <name> --branch <name> [--stage-all --message <text>] [--json]"
2684
+ ],
2685
+ "args": [
2686
+ {
2687
+ "name": "repository-ref",
2688
+ "required": true,
2689
+ "source": "<repository-ref>"
2690
+ }
2691
+ ],
2692
+ "flags": [
2693
+ {
2694
+ "name": "--branch",
2695
+ "value": "<name>",
2696
+ "required": false,
2697
+ "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
2698
+ },
2699
+ {
2700
+ "name": "--help",
2701
+ "value": null,
2702
+ "required": false,
2703
+ "description": "--help, -h Show help"
2704
+ },
2705
+ {
2706
+ "name": "--message",
2707
+ "value": "<text>",
2708
+ "required": false,
2709
+ "description": "mdkg git push --remote <name> --branch <name> [--stage-all --message <text>] [--json]"
2710
+ },
2711
+ {
2712
+ "name": "--remote",
2713
+ "value": "<name>",
2714
+ "required": false,
2715
+ "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
2716
+ },
2717
+ {
2718
+ "name": "--root",
2719
+ "value": null,
2720
+ "required": false,
2721
+ "description": "--root, -r <path> Run against a specific repo root"
2722
+ },
2723
+ {
2724
+ "name": "--target",
2725
+ "value": "<path>",
2726
+ "required": false,
2727
+ "description": "mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
2728
+ },
2729
+ {
2730
+ "name": "--version",
2731
+ "value": null,
2732
+ "required": false,
2733
+ "description": "--version, -V Show version"
2734
+ }
2735
+ ],
2736
+ "output_formats": [
2737
+ "text",
2738
+ "json"
2739
+ ],
2740
+ "json_schema_ref": "mdkg.command_output.v1",
2741
+ "side_effects": [
2742
+ "inspect-or-mutate-git-backed-mdkg-project-lifecycle"
2743
+ ],
2744
+ "read_paths": [
2745
+ ".mdkg/**"
2746
+ ],
2747
+ "write_paths": [
2748
+ ".mdkg/db/**",
2749
+ ".mdkg/git/**",
2750
+ ".mdkg/index/**"
2751
+ ],
2752
+ "dry_run": {
2753
+ "supported": false
2754
+ },
2755
+ "lock_policy": "mutation-lock-required-for-closeout-and-stage-all-push",
2756
+ "atomic_write_policy": "atomic-file-writes-for-closeout-receipts",
2757
+ "receipts": [
2758
+ "git-closeout-receipt",
2759
+ "git-inspect-receipt",
2760
+ "git-push-ready-receipt",
2761
+ "git-push-receipt"
2762
+ ],
2763
+ "danger_level": "mixed",
2764
+ "aliases": [],
2765
+ "exit_codes": [
2766
+ {
2767
+ "code": 0,
2768
+ "meaning": "success"
2769
+ },
2770
+ {
2771
+ "code": 1,
2772
+ "meaning": "validation-or-runtime-error"
2773
+ }
2774
+ ],
2775
+ "examples": [
2776
+ " mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]",
2777
+ " mdkg git fetch [--remote <name>] [--branch <name>] [--json]",
2778
+ " mdkg git inspect [--json]"
2779
+ ],
2780
+ "docs": {
2781
+ "help_target": "mdkg help git",
2782
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
2783
+ }
2784
+ },
2785
+ {
2786
+ "key": "git clone",
2787
+ "path": [
2788
+ "git",
2789
+ "clone"
2790
+ ],
2791
+ "category": "git",
2792
+ "status": "stable",
2793
+ "visibility": "public",
2794
+ "summary": "mdkg git clone command",
2795
+ "usage": [
2796
+ " mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
2797
+ ],
2798
+ "args": [
2799
+ {
2800
+ "name": "repository-ref",
2801
+ "required": true,
2802
+ "source": "<repository-ref>"
2803
+ }
2804
+ ],
2805
+ "flags": [
2806
+ {
2807
+ "name": "--help",
2808
+ "value": null,
2809
+ "required": false,
2810
+ "description": "--help, -h Show help"
2811
+ },
2812
+ {
2813
+ "name": "--root",
2814
+ "value": null,
2815
+ "required": false,
2816
+ "description": "--root, -r <path> Run against a specific repo root"
2817
+ },
2818
+ {
2819
+ "name": "--target",
2820
+ "value": "<path>",
2821
+ "required": false,
2822
+ "description": "mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
2823
+ },
2824
+ {
2825
+ "name": "--version",
2826
+ "value": null,
2827
+ "required": false,
2828
+ "description": "--version, -V Show version"
2829
+ }
2830
+ ],
2831
+ "output_formats": [
2832
+ "text",
2833
+ "json"
2834
+ ],
2835
+ "json_schema_ref": "mdkg.command_output.v1",
2836
+ "side_effects": [
2837
+ "clone-remote-git-repository-into-contained-target"
2838
+ ],
2839
+ "read_paths": [
2840
+ ".mdkg/**"
2841
+ ],
2842
+ "write_paths": [
2843
+ "<target>/**"
2844
+ ],
2845
+ "dry_run": {
2846
+ "supported": false
2847
+ },
2848
+ "lock_policy": "not-required-for-contained-target",
2849
+ "atomic_write_policy": "delegated-to-system-git",
2850
+ "receipts": [
2851
+ "git-clone-receipt"
2852
+ ],
2853
+ "danger_level": "moderate",
2854
+ "aliases": [],
2855
+ "exit_codes": [
2856
+ {
2857
+ "code": 0,
2858
+ "meaning": "success"
2859
+ },
2860
+ {
2861
+ "code": 1,
2862
+ "meaning": "validation-or-runtime-error"
2863
+ }
2864
+ ],
2865
+ "examples": [
2866
+ " mdkg git clone <repository-ref> --target <path> [--branch <name>] [--json]"
2867
+ ],
2868
+ "docs": {
2869
+ "help_target": "mdkg help git clone",
2870
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
2871
+ }
2872
+ },
2873
+ {
2874
+ "key": "git closeout",
2875
+ "path": [
2876
+ "git",
2877
+ "closeout"
2878
+ ],
2879
+ "category": "git",
2880
+ "status": "stable",
2881
+ "visibility": "public",
2882
+ "summary": "mdkg git closeout command",
2883
+ "usage": [
2884
+ " mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
2885
+ ],
2886
+ "args": [],
2887
+ "flags": [
2888
+ {
2889
+ "name": "--help",
2890
+ "value": null,
2891
+ "required": false,
2892
+ "description": "--help, -h Show help"
2893
+ },
2894
+ {
2895
+ "name": "--root",
2896
+ "value": null,
2897
+ "required": false,
2898
+ "description": "--root, -r <path> Run against a specific repo root"
2899
+ },
2900
+ {
2901
+ "name": "--version",
2902
+ "value": null,
2903
+ "required": false,
2904
+ "description": "--version, -V Show version"
2905
+ }
2906
+ ],
2907
+ "output_formats": [
2908
+ "text",
2909
+ "json"
2910
+ ],
2911
+ "json_schema_ref": "mdkg.command_output.v1",
2912
+ "side_effects": [
2913
+ "write-static-git-closeout-receipts-and-optional-db-snapshot"
2914
+ ],
2915
+ "read_paths": [
2916
+ ".mdkg/**"
2917
+ ],
2918
+ "write_paths": [
2919
+ ".mdkg/db/**",
2920
+ ".mdkg/git/**",
2921
+ ".mdkg/index/**"
2922
+ ],
2923
+ "dry_run": {
2924
+ "supported": false
2925
+ },
2926
+ "lock_policy": "mutation-lock-required",
2927
+ "atomic_write_policy": "atomic-file-writes-and-sqlite-vacuum-into",
2928
+ "receipts": [
2929
+ "git-closeout-receipt"
2930
+ ],
2931
+ "danger_level": "moderate",
2932
+ "aliases": [],
2933
+ "exit_codes": [
2934
+ {
2935
+ "code": 0,
2936
+ "meaning": "success"
2937
+ },
2938
+ {
2939
+ "code": 1,
2940
+ "meaning": "validation-or-runtime-error"
2941
+ }
2942
+ ],
2943
+ "examples": [
2944
+ " mdkg git closeout [--queue-policy drain|paused] [--output <path>] [--json]"
2945
+ ],
2946
+ "docs": {
2947
+ "help_target": "mdkg help git closeout",
2948
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
2949
+ }
2950
+ },
2951
+ {
2952
+ "key": "git fetch",
2953
+ "path": [
2954
+ "git",
2955
+ "fetch"
2956
+ ],
2957
+ "category": "git",
2958
+ "status": "stable",
2959
+ "visibility": "public",
2960
+ "summary": "mdkg git fetch command",
2961
+ "usage": [
2962
+ " mdkg git fetch [--remote <name>] [--branch <name>] [--json]"
2963
+ ],
2964
+ "args": [],
2965
+ "flags": [
2966
+ {
2967
+ "name": "--help",
2968
+ "value": null,
2969
+ "required": false,
2970
+ "description": "--help, -h Show help"
2971
+ },
2972
+ {
2973
+ "name": "--root",
2974
+ "value": null,
2975
+ "required": false,
2976
+ "description": "--root, -r <path> Run against a specific repo root"
2977
+ },
2978
+ {
2979
+ "name": "--version",
2980
+ "value": null,
2981
+ "required": false,
2982
+ "description": "--version, -V Show version"
2983
+ }
2984
+ ],
2985
+ "output_formats": [
2986
+ "text",
2987
+ "json"
2988
+ ],
2989
+ "json_schema_ref": "mdkg.command_output.v1",
2990
+ "side_effects": [
2991
+ "fetch-remote-git-refs"
2992
+ ],
2993
+ "read_paths": [
2994
+ ".mdkg/**"
2995
+ ],
2996
+ "write_paths": [
2997
+ ".git/**"
2998
+ ],
2999
+ "dry_run": {
3000
+ "supported": false
3001
+ },
3002
+ "lock_policy": "delegated-to-system-git",
3003
+ "atomic_write_policy": "delegated-to-system-git",
3004
+ "receipts": [
3005
+ "git-fetch-receipt"
3006
+ ],
3007
+ "danger_level": "moderate",
3008
+ "aliases": [],
3009
+ "exit_codes": [
3010
+ {
3011
+ "code": 0,
3012
+ "meaning": "success"
3013
+ },
3014
+ {
3015
+ "code": 1,
3016
+ "meaning": "validation-or-runtime-error"
3017
+ }
3018
+ ],
3019
+ "examples": [
3020
+ " mdkg git fetch [--remote <name>] [--branch <name>] [--json]"
3021
+ ],
3022
+ "docs": {
3023
+ "help_target": "mdkg help git fetch",
3024
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
3025
+ }
3026
+ },
3027
+ {
3028
+ "key": "git inspect",
3029
+ "path": [
3030
+ "git",
3031
+ "inspect"
3032
+ ],
3033
+ "category": "git",
3034
+ "status": "stable",
3035
+ "visibility": "public",
3036
+ "summary": "mdkg git inspect command",
3037
+ "usage": [
3038
+ " mdkg git inspect [--json]"
3039
+ ],
3040
+ "args": [],
3041
+ "flags": [
3042
+ {
3043
+ "name": "--help",
3044
+ "value": null,
3045
+ "required": false,
3046
+ "description": "--help, -h Show help"
3047
+ },
3048
+ {
3049
+ "name": "--root",
3050
+ "value": null,
3051
+ "required": false,
3052
+ "description": "--root, -r <path> Run against a specific repo root"
3053
+ },
3054
+ {
3055
+ "name": "--version",
3056
+ "value": null,
3057
+ "required": false,
3058
+ "description": "--version, -V Show version"
3059
+ }
3060
+ ],
3061
+ "output_formats": [
3062
+ "text",
3063
+ "json"
3064
+ ],
3065
+ "json_schema_ref": "mdkg.command_output.v1",
3066
+ "side_effects": [
3067
+ "none"
3068
+ ],
3069
+ "read_paths": [
3070
+ ".mdkg/**"
3071
+ ],
3072
+ "write_paths": [],
3073
+ "dry_run": {
3074
+ "supported": false
3075
+ },
3076
+ "lock_policy": "none-read-only",
3077
+ "atomic_write_policy": "none-read-only",
3078
+ "receipts": [
3079
+ "git-inspect-receipt"
3080
+ ],
3081
+ "danger_level": "read-only",
3082
+ "aliases": [],
3083
+ "exit_codes": [
3084
+ {
3085
+ "code": 0,
3086
+ "meaning": "success"
3087
+ },
3088
+ {
3089
+ "code": 1,
3090
+ "meaning": "validation-or-runtime-error"
3091
+ }
3092
+ ],
3093
+ "examples": [
3094
+ " mdkg git inspect [--json]"
3095
+ ],
3096
+ "docs": {
3097
+ "help_target": "mdkg help git inspect",
3098
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
3099
+ }
3100
+ },
3101
+ {
3102
+ "key": "git push",
3103
+ "path": [
3104
+ "git",
3105
+ "push"
3106
+ ],
3107
+ "category": "git",
3108
+ "status": "stable",
3109
+ "visibility": "public",
3110
+ "summary": "mdkg git push command",
3111
+ "usage": [
3112
+ " mdkg git push --remote <name> --branch <name> [--json]",
3113
+ " mdkg git push --remote <name> --branch <name> --stage-all --message <text> [--queue-policy drain|paused] [--json]"
3114
+ ],
3115
+ "args": [],
3116
+ "flags": [
3117
+ {
3118
+ "name": "--branch",
3119
+ "value": "<name>",
3120
+ "required": false,
3121
+ "description": "mdkg git push --remote <name> --branch <name> [--json]"
3122
+ },
3123
+ {
3124
+ "name": "--help",
3125
+ "value": null,
3126
+ "required": false,
3127
+ "description": "--help, -h Show help"
3128
+ },
3129
+ {
3130
+ "name": "--message",
3131
+ "value": null,
3132
+ "required": false,
3133
+ "description": "- --stage-all writes closeout evidence, stages all changes, commits with --message, then runs push-ready before pushing"
3134
+ },
3135
+ {
3136
+ "name": "--remote",
3137
+ "value": "<name>",
3138
+ "required": false,
3139
+ "description": "mdkg git push --remote <name> --branch <name> [--json]"
3140
+ },
3141
+ {
3142
+ "name": "--root",
3143
+ "value": null,
3144
+ "required": false,
3145
+ "description": "--root, -r <path> Run against a specific repo root"
3146
+ },
3147
+ {
3148
+ "name": "--stage-all",
3149
+ "value": null,
3150
+ "required": false,
3151
+ "description": "mdkg git push --remote <name> --branch <name> --stage-all --message <text> [--queue-policy drain|paused] [--json]"
3152
+ },
3153
+ {
3154
+ "name": "--version",
3155
+ "value": null,
3156
+ "required": false,
3157
+ "description": "--version, -V Show version"
3158
+ }
3159
+ ],
3160
+ "output_formats": [
3161
+ "text",
3162
+ "json"
3163
+ ],
3164
+ "json_schema_ref": "mdkg.command_output.v1",
3165
+ "side_effects": [
3166
+ "optional-closeout-stage-commit-and-real-git-push"
3167
+ ],
3168
+ "read_paths": [
3169
+ ".mdkg/**"
3170
+ ],
3171
+ "write_paths": [
3172
+ ".git/**",
3173
+ ".mdkg/db/**",
3174
+ ".mdkg/git/**",
3175
+ "repo-files/**"
3176
+ ],
3177
+ "dry_run": {
3178
+ "supported": false
3179
+ },
3180
+ "lock_policy": "mutation-lock-required",
3181
+ "atomic_write_policy": "atomic-file-writes-plus-system-git",
3182
+ "receipts": [
3183
+ "git-push-receipt"
3184
+ ],
3185
+ "danger_level": "high",
3186
+ "aliases": [],
3187
+ "exit_codes": [
3188
+ {
3189
+ "code": 0,
3190
+ "meaning": "success"
3191
+ },
3192
+ {
3193
+ "code": 1,
3194
+ "meaning": "validation-or-runtime-error"
3195
+ }
3196
+ ],
3197
+ "examples": [
3198
+ " mdkg git push --remote <name> --branch <name> --stage-all --message <text> [--queue-policy drain|paused] [--json]",
3199
+ " mdkg git push --remote <name> --branch <name> [--json]"
3200
+ ],
3201
+ "docs": {
3202
+ "help_target": "mdkg help git push",
3203
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
3204
+ }
3205
+ },
3206
+ {
3207
+ "key": "git push-ready",
3208
+ "path": [
3209
+ "git",
3210
+ "push-ready"
3211
+ ],
3212
+ "category": "git",
3213
+ "status": "stable",
3214
+ "visibility": "public",
3215
+ "summary": "mdkg git push-ready command",
3216
+ "usage": [
3217
+ " mdkg git push-ready --remote <name> --branch <name> [--json]"
3218
+ ],
3219
+ "args": [],
3220
+ "flags": [
3221
+ {
3222
+ "name": "--branch",
3223
+ "value": "<name>",
3224
+ "required": false,
3225
+ "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3226
+ },
3227
+ {
3228
+ "name": "--help",
3229
+ "value": null,
3230
+ "required": false,
3231
+ "description": "--help, -h Show help"
3232
+ },
3233
+ {
3234
+ "name": "--remote",
3235
+ "value": "<name>",
3236
+ "required": false,
3237
+ "description": "mdkg git push-ready --remote <name> --branch <name> [--json]"
3238
+ },
3239
+ {
3240
+ "name": "--root",
3241
+ "value": null,
3242
+ "required": false,
3243
+ "description": "--root, -r <path> Run against a specific repo root"
3244
+ },
3245
+ {
3246
+ "name": "--version",
3247
+ "value": null,
3248
+ "required": false,
3249
+ "description": "--version, -V Show version"
3250
+ }
3251
+ ],
3252
+ "output_formats": [
3253
+ "text",
3254
+ "json"
3255
+ ],
3256
+ "json_schema_ref": "mdkg.command_output.v1",
3257
+ "side_effects": [
3258
+ "none"
3259
+ ],
3260
+ "read_paths": [
3261
+ ".mdkg/**"
3262
+ ],
3263
+ "write_paths": [],
3264
+ "dry_run": {
3265
+ "supported": false
3266
+ },
3267
+ "lock_policy": "none-read-only",
3268
+ "atomic_write_policy": "none-read-only",
3269
+ "receipts": [
3270
+ "git-push-ready-receipt"
3271
+ ],
3272
+ "danger_level": "read-only",
3273
+ "aliases": [],
3274
+ "exit_codes": [
3275
+ {
3276
+ "code": 0,
3277
+ "meaning": "success"
3278
+ },
3279
+ {
3280
+ "code": 1,
3281
+ "meaning": "validation-or-runtime-error"
3282
+ }
3283
+ ],
3284
+ "examples": [
3285
+ " mdkg git push-ready --remote <name> --branch <name> [--json]"
3286
+ ],
3287
+ "docs": {
3288
+ "help_target": "mdkg help git push-ready",
3289
+ "command_matrix": "CLI_COMMAND_MATRIX.md"
3290
+ }
3291
+ },
2668
3292
  {
2669
3293
  "key": "global",
2670
3294
  "path": [
@@ -9170,5 +9794,5 @@
9170
9794
  }
9171
9795
  }
9172
9796
  ],
9173
- "contract_hash": "65408d40dd065dfadcaa9bfe3626df5703dce2fe08ce1dd500e371899a8c4f7a"
9797
+ "contract_hash": "b6ce5590f19cd90b00820a9488c5773f2824c6525730d83d5f32d6e04612327c"
9174
9798
  }