fix(automate): add success object level (#3657)

Automate/Speckle.Automate.Sdk/AutomationContext.cs

@@ -369,6 +369,20 @@ public void AttachInfoToObjects(
     Dictionary<string, object>? visualOverrides = null
   ) => AttachResultToObjects(ObjectResultLevel.Info, category, objectIds, message, metadata, visualOverrides);
 
+  /// <summary>
+  /// Add a new success case to the run results.
+  /// If the success cause has already created a success case,
+  /// the case will be extended with a new case referring to the causing objects.
+  /// </summary>
+  /// <inheritdoc cref="AttachErrorToObjects"/>
+  public void AttachSuccessToObjects(
+    string category,
+    IEnumerable<string> objectIds,
+    string? message = null,
+    Dictionary<string, object>? metadata = null,
+    Dictionary<string, object>? visualOverrides = null
+  ) => AttachResultToObjects(ObjectResultLevel.Success, category, objectIds, message, metadata, visualOverrides);
+
   /// <summary>
   /// Add a new case to the run results.
   /// If the cause has already created an case with equal level,

Automate/Speckle.Automate.Sdk/Schema/ObjectResultLevel.cs

@@ -2,6 +2,7 @@ namespace Speckle.Automate.Sdk.Schema;
 
 public enum ObjectResultLevel
 {
+  Success,
   Info,
   Warning,
   Error

Automate/Speckle.Automate.Sdk/Schema/ObjectResultLevelMapping.cs

@@ -2,6 +2,7 @@ namespace Speckle.Automate.Sdk.Schema;
 
 public abstract class ObjectResultLevelMapping
 {
+  private const string SUCCESS = "SUCCESS";
   private const string INFO = "INFO";
   private const string WARNING = "WARNING";
   private const string ERROR = "ERROR";
@@ -12,6 +13,7 @@ public static string Get(ObjectResultLevel level) =>
       ObjectResultLevel.Error => ERROR,
       ObjectResultLevel.Warning => WARNING,
       ObjectResultLevel.Info => INFO,
+      ObjectResultLevel.Success => SUCCESS,
       _ => throw new ArgumentOutOfRangeException($"Not valid value for enum {level}")
     };
 }