Merge pull request #109 from PHOENIXCONTACT/feature/process-report-broken-removed

Extend the `IProcessControl` facade to support direct process reporting (Broken, Removed)

Author: 1nf0rmagician

src/Moryx.ControlSystem/Processes/IProcessControlReporting.cs

@@ -0,0 +1,43 @@
+// Copyright (c) 2025, Phoenix Contact GmbH & Co. KG
+// Licensed under the Apache License, Version 2.0
+
+using Moryx.AbstractionLayer;
+
+namespace Moryx.ControlSystem.Processes
+{
+    /// <summary>
+    /// Actions to report a running process
+    /// </summary>
+    public enum ReportAction
+    {
+        /// <summary>
+        /// The process is broken or damaged
+        /// </summary>
+        Broken,
+        /// <summary>
+        /// The process was physically removed
+        /// </summary>
+        Removed
+    }
+
+    /// <summary>
+    /// Facade interface to get more information from the control system.
+    /// </summary>
+    public interface IProcessControlReporting : IProcessControl
+    {
+
+        /// <summary>
+        /// Report a specific <see cref="ReportAction"/> to have been executed on the <paramref name="process"/>
+        /// </summary>
+        /// <param name="process">The process to report</param>
+        /// <param name="action">The action to perform</param>
+        void Report(IProcess process, ReportAction action);
+
+        /// <summary>
+        /// Get the running process with the given <paramref name="processId"/>
+        /// </summary>
+        /// <param name="processId">Id of the running process</param>
+        /// <returns><see cref="IProcess"/></returns>
+        IProcess GetProcess(long processId);
+    }
+}