mustflow 2.22.13 → 2.22.14
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/README.md +1 -1
- package/dist/cli/commands/explain-verify.js +8 -1
- package/dist/cli/commands/explain.js +269 -2
- package/dist/cli/commands/run.js +109 -77
- package/dist/cli/commands/verify.js +16 -1
- package/dist/cli/lib/run-plan.js +31 -5
- package/dist/core/active-run-locks.js +294 -0
- package/dist/core/check-issues.js +8 -0
- package/dist/core/command-contract-validation.js +179 -2
- package/dist/core/command-explanation.js +5 -3
- package/dist/core/command-preconditions.js +261 -0
- package/dist/core/skill-route-explanation.js +115 -9
- package/package.json +1 -1
- package/schemas/README.md +6 -3
- package/schemas/change-verification-report.schema.json +52 -0
- package/schemas/commands.schema.json +41 -0
- package/schemas/explain-report.schema.json +152 -4
- package/templates/default/manifest.toml +1 -1
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"properties": {
|
|
15
15
|
"schema_version": { "const": "1" },
|
|
16
16
|
"command": { "const": "explain" },
|
|
17
|
-
"topic": { "enum": ["anchor", "asset-optimization", "authority", "command", "retention", "skill", "skills", "surface", "verify"] },
|
|
17
|
+
"topic": { "enum": ["anchor", "asset-optimization", "authority", "command", "retention", "skill", "skills", "surface", "verify", "why"] },
|
|
18
18
|
"mustflow_root": { "type": "string" },
|
|
19
19
|
"decision": {
|
|
20
20
|
"oneOf": [
|
|
@@ -25,7 +25,8 @@
|
|
|
25
25
|
{ "$ref": "#/$defs/skillRouteAlignmentDecision" },
|
|
26
26
|
{ "$ref": "#/$defs/publicSurfaceDecision" },
|
|
27
27
|
{ "$ref": "#/$defs/sourceAnchorDecision" },
|
|
28
|
-
{ "$ref": "#/$defs/verificationDecision" }
|
|
28
|
+
{ "$ref": "#/$defs/verificationDecision" },
|
|
29
|
+
{ "$ref": "#/$defs/latestFailureDecision" }
|
|
29
30
|
]
|
|
30
31
|
}
|
|
31
32
|
},
|
|
@@ -350,6 +351,10 @@
|
|
|
350
351
|
"requiredAfter": {
|
|
351
352
|
"type": "array",
|
|
352
353
|
"items": { "type": "string" }
|
|
354
|
+
},
|
|
355
|
+
"preconditions": {
|
|
356
|
+
"type": "array",
|
|
357
|
+
"items": { "$ref": "#/$defs/commandPrecondition" }
|
|
353
358
|
}
|
|
354
359
|
}
|
|
355
360
|
},
|
|
@@ -869,7 +874,7 @@
|
|
|
869
874
|
"destructive",
|
|
870
875
|
"successExitCodes",
|
|
871
876
|
"requiredAfter"
|
|
872
|
-
|
|
877
|
+
],
|
|
873
878
|
"properties": {
|
|
874
879
|
"name": { "type": "string" },
|
|
875
880
|
"status": { "type": ["string", "null"] },
|
|
@@ -892,6 +897,110 @@
|
|
|
892
897
|
"requiredAfter": {
|
|
893
898
|
"type": "array",
|
|
894
899
|
"items": { "type": "string" }
|
|
900
|
+
},
|
|
901
|
+
"preconditions": {
|
|
902
|
+
"type": "array",
|
|
903
|
+
"items": { "$ref": "#/$defs/commandPrecondition" }
|
|
904
|
+
}
|
|
905
|
+
}
|
|
906
|
+
},
|
|
907
|
+
"commandPrecondition": {
|
|
908
|
+
"type": "object",
|
|
909
|
+
"additionalProperties": false,
|
|
910
|
+
"required": [
|
|
911
|
+
"kind",
|
|
912
|
+
"label",
|
|
913
|
+
"status",
|
|
914
|
+
"detail",
|
|
915
|
+
"path",
|
|
916
|
+
"artifact",
|
|
917
|
+
"sources",
|
|
918
|
+
"newestSource",
|
|
919
|
+
"satisfyIntent"
|
|
920
|
+
],
|
|
921
|
+
"properties": {
|
|
922
|
+
"kind": { "type": "string" },
|
|
923
|
+
"label": { "type": ["string", "null"] },
|
|
924
|
+
"status": { "enum": ["satisfied", "missing", "stale", "unknown", "invalid"] },
|
|
925
|
+
"detail": { "type": "string" },
|
|
926
|
+
"path": { "type": ["string", "null"] },
|
|
927
|
+
"artifact": { "type": ["string", "null"] },
|
|
928
|
+
"sources": {
|
|
929
|
+
"type": "array",
|
|
930
|
+
"items": { "type": "string" }
|
|
931
|
+
},
|
|
932
|
+
"newestSource": { "type": ["string", "null"] },
|
|
933
|
+
"satisfyIntent": {
|
|
934
|
+
"anyOf": [
|
|
935
|
+
{ "type": "null" },
|
|
936
|
+
{ "$ref": "#/$defs/preconditionSatisfyIntent" }
|
|
937
|
+
]
|
|
938
|
+
}
|
|
939
|
+
}
|
|
940
|
+
},
|
|
941
|
+
"preconditionSatisfyIntent": {
|
|
942
|
+
"type": "object",
|
|
943
|
+
"additionalProperties": false,
|
|
944
|
+
"required": ["intent", "declared", "runnable", "status", "lifecycle", "runPolicy", "detail"],
|
|
945
|
+
"properties": {
|
|
946
|
+
"intent": { "type": "string" },
|
|
947
|
+
"declared": { "type": "boolean" },
|
|
948
|
+
"runnable": { "type": "boolean" },
|
|
949
|
+
"status": { "type": ["string", "null"] },
|
|
950
|
+
"lifecycle": { "type": ["string", "null"] },
|
|
951
|
+
"runPolicy": { "type": ["string", "null"] },
|
|
952
|
+
"detail": { "type": ["string", "null"] }
|
|
953
|
+
}
|
|
954
|
+
},
|
|
955
|
+
"latestFailureDecision": {
|
|
956
|
+
"type": "object",
|
|
957
|
+
"additionalProperties": false,
|
|
958
|
+
"required": [
|
|
959
|
+
"kind",
|
|
960
|
+
"decision",
|
|
961
|
+
"reason",
|
|
962
|
+
"effectiveAction",
|
|
963
|
+
"countsAsMustflowVerification",
|
|
964
|
+
"sourceFiles",
|
|
965
|
+
"latestFailure"
|
|
966
|
+
],
|
|
967
|
+
"properties": {
|
|
968
|
+
"kind": { "const": "latest_failure" },
|
|
969
|
+
"decision": { "type": "string" },
|
|
970
|
+
"reason": { "type": "string" },
|
|
971
|
+
"effectiveAction": { "type": "string" },
|
|
972
|
+
"countsAsMustflowVerification": { "const": false },
|
|
973
|
+
"sourceFiles": {
|
|
974
|
+
"type": "array",
|
|
975
|
+
"items": { "type": "string" }
|
|
976
|
+
},
|
|
977
|
+
"latestFailure": {
|
|
978
|
+
"type": "object",
|
|
979
|
+
"additionalProperties": false,
|
|
980
|
+
"required": [
|
|
981
|
+
"path",
|
|
982
|
+
"present",
|
|
983
|
+
"valid",
|
|
984
|
+
"failed",
|
|
985
|
+
"status",
|
|
986
|
+
"intent",
|
|
987
|
+
"exitCode",
|
|
988
|
+
"errorKind",
|
|
989
|
+
"durationMs",
|
|
990
|
+
"summary"
|
|
991
|
+
],
|
|
992
|
+
"properties": {
|
|
993
|
+
"path": { "const": ".mustflow/state/runs/latest.json" },
|
|
994
|
+
"present": { "type": "boolean" },
|
|
995
|
+
"valid": { "type": "boolean" },
|
|
996
|
+
"failed": { "type": "boolean" },
|
|
997
|
+
"status": { "type": ["string", "null"] },
|
|
998
|
+
"intent": { "type": ["string", "null"] },
|
|
999
|
+
"exitCode": { "type": ["integer", "null"] },
|
|
1000
|
+
"errorKind": { "type": ["string", "null"] },
|
|
1001
|
+
"durationMs": { "type": ["integer", "null"] },
|
|
1002
|
+
"summary": { "type": "string" }
|
|
1003
|
+
}
|
|
895
1004
|
}
|
|
896
1005
|
}
|
|
897
1006
|
},
|
|
@@ -950,7 +1059,8 @@
|
|
|
950
1059
|
"effectiveAction",
|
|
951
1060
|
"countsAsMustflowVerification",
|
|
952
1061
|
"sourceFiles",
|
|
953
|
-
"route"
|
|
1062
|
+
"route",
|
|
1063
|
+
"selectionEvidence"
|
|
954
1064
|
],
|
|
955
1065
|
"properties": {
|
|
956
1066
|
"kind": { "const": "skill_route" },
|
|
@@ -994,6 +1104,44 @@
|
|
|
994
1104
|
"items": { "type": "string" }
|
|
995
1105
|
}
|
|
996
1106
|
}
|
|
1107
|
+
},
|
|
1108
|
+
"selectionEvidence": {
|
|
1109
|
+
"type": "object",
|
|
1110
|
+
"additionalProperties": false,
|
|
1111
|
+
"required": [
|
|
1112
|
+
"matchedBy",
|
|
1113
|
+
"requiredInputs",
|
|
1114
|
+
"missingInputs",
|
|
1115
|
+
"candidateAdjuncts",
|
|
1116
|
+
"unmatchedPaths",
|
|
1117
|
+
"gapNotes"
|
|
1118
|
+
],
|
|
1119
|
+
"properties": {
|
|
1120
|
+
"matchedBy": {
|
|
1121
|
+
"type": "array",
|
|
1122
|
+
"items": { "type": "string" }
|
|
1123
|
+
},
|
|
1124
|
+
"requiredInputs": {
|
|
1125
|
+
"type": "array",
|
|
1126
|
+
"items": { "type": "string" }
|
|
1127
|
+
},
|
|
1128
|
+
"missingInputs": {
|
|
1129
|
+
"type": "array",
|
|
1130
|
+
"items": { "type": "string" }
|
|
1131
|
+
},
|
|
1132
|
+
"candidateAdjuncts": {
|
|
1133
|
+
"type": "array",
|
|
1134
|
+
"items": { "type": "string" }
|
|
1135
|
+
},
|
|
1136
|
+
"unmatchedPaths": {
|
|
1137
|
+
"type": "array",
|
|
1138
|
+
"items": { "type": "string" }
|
|
1139
|
+
},
|
|
1140
|
+
"gapNotes": {
|
|
1141
|
+
"type": "array",
|
|
1142
|
+
"items": { "type": "string" }
|
|
1143
|
+
}
|
|
1144
|
+
}
|
|
997
1145
|
}
|
|
998
1146
|
}
|
|
999
1147
|
},
|