🧪 experimental: decayed + banded scoring (#3466)

These will be added in cnspec, keywords need to be defined in cnquery

Signed-off-by: Dominik Richter <[email protected]>

explorer/cnquery_explorer.proto

@@ -179,6 +179,18 @@ enum ScoringSystem {
   AVERAGE = 3;
   DATA_ONLY = 4;
   IGNORE_SCORE = 5;
+  // Experimental: BANDED scoring mechanism which creates a score based on
+  // the 4 categories of criticality (critical, high, medium, low) and
+  // positions scores so that:
+  // 1. Any critical/high issues won't generate a high score (upper limit)
+  // 2. Lower scoring categories can have an impact on the score
+  //    (e.g. 1 crit + 200 medium failures will be lower than 1 crit only)
+  // 3. A large collection of medium findings won't generate a critical score
+  BANDED = 6;
+  // Experimental: DECAYED scoring uses a scaled decay function to estimate a
+  // score value. This means that a few critical findings will quickly reduce
+  // the resulting score, but it won't just drop it to the lowest value.
+  DECAYED = 7;
 }
 
 // Impact explains how important certain queries are. They are especially useful

explorer/impact.go

@@ -125,6 +125,10 @@ func (s *ScoringSystem) UnmarshalJSON(data []byte) error {
 			*s = ScoringSystem_WEIGHTED
 		case "average", "":
 			*s = ScoringSystem_AVERAGE
+		case "banded":
+			*s = ScoringSystem_BANDED
+		case "decayed":
+			*s = ScoringSystem_DECAYED
 		default:
 			return errors.New("unknown scoring system: " + string(data))
 		}
@@ -149,6 +153,10 @@ func (s *ScoringSystem) UnmarshalYAML(node *yaml.Node) error {
 			*s = ScoringSystem_WEIGHTED
 		case "average", "":
 			*s = ScoringSystem_AVERAGE
+		case "banded":
+			*s = ScoringSystem_BANDED
+		case "decayed":
+			*s = ScoringSystem_DECAYED
 		default:
 			return errors.New("unknown scoring system: " + string(name))
 		}
@@ -164,6 +172,10 @@ func (s *ScoringSystem) MarshalYAML() (interface{}, error) {
 		return "weighted", nil
 	case ScoringSystem_AVERAGE:
 		return "average", nil
+	case ScoringSystem_BANDED:
+		return "banded", nil
+	case ScoringSystem_DECAYED:
+		return "decayed", nil
 	default:
 		return *s, nil
 	}