[code-simplifier] parser: add doc comment and assertion message to normalizeAdditionalPropertyList

pkg/parser/schema_errors.go

@@ -225,6 +225,9 @@ func rewriteAdditionalPropertiesError(message string) string {
 	return message
 }
 
+// normalizeAdditionalPropertyList strips quotes, trims whitespace, and sorts the
+// comma-separated property names so that diagnostics are deterministic regardless
+// of the order in which the schema validator emits them.
 func normalizeAdditionalPropertyList(raw string) string {
 	raw = strings.ReplaceAll(raw, "'", "")
 	parts := strings.Split(raw, ",")

pkg/parser/schema_errors_test.go

@@ -301,7 +301,8 @@ func TestRewriteAdditionalPropertiesErrorOrdering(t *testing.T) {
 	for _, tt := range tests {
 		t.Run(tt.name, func(t *testing.T) {
 			got := rewriteAdditionalPropertiesError(tt.in)
-			assert.Equal(t, tt.want, got)
+			assert.Equal(t, tt.want, got,
+				"rewriteAdditionalPropertiesError(%q) = %q, want %q", tt.in, got, tt.want)
 		})
 	}
 }