feat(auditlog): site script-side emitters stamp ParentExecutionId

src/ScadaLink.SiteRuntime/Scripts/AuditingDbConnection.cs

@@ -37,11 +37,21 @@ internal sealed class AuditingDbConnection : DbConnection
     private readonly string _instanceName;
     private readonly string? _sourceScript;
     private readonly Guid _executionId;
+
+    /// <summary>
+    /// Audit Log #23 (ParentExecutionId): the spawning execution's id when this
+    /// run was inbound-API-routed; <c>null</c> for non-routed runs. Threaded
+    /// alongside <see cref="_executionId"/> into the
+    /// <see cref="AuditingDbCommand"/> so its <c>DbWrite</c> row stamps it.
+    /// </summary>
+    private readonly Guid? _parentExecutionId;
+
     private readonly ILogger _logger;
 
     // Parameter ordering: executionId sits immediately after the ILogger,
     // consistent with the other three audit-threaded ctors (ExternalSystemHelper,
-    // DatabaseHelper, AuditingDbCommand).
+    // DatabaseHelper, AuditingDbCommand). parentExecutionId is a trailing
+    // optional param so existing positional callers stay source-compatible.
     public AuditingDbConnection(
         DbConnection inner,
         IAuditWriter auditWriter,
@@ -50,7 +60,8 @@ internal sealed class AuditingDbConnection : DbConnection
         string instanceName,
         string? sourceScript,
         ILogger logger,
-        Guid executionId)
+        Guid executionId,
+        Guid? parentExecutionId = null)
     {
         _inner = inner ?? throw new ArgumentNullException(nameof(inner));
         _auditWriter = auditWriter ?? throw new ArgumentNullException(nameof(auditWriter));
@@ -60,6 +71,7 @@ internal sealed class AuditingDbConnection : DbConnection
         _sourceScript = sourceScript;
         _logger = logger ?? throw new ArgumentNullException(nameof(logger));
         _executionId = executionId;
+        _parentExecutionId = parentExecutionId;
     }
 
     // ConnectionString is settable on DbConnection — forward both halves.
@@ -99,7 +111,10 @@ internal sealed class AuditingDbConnection : DbConnection
             _instanceName,
             _sourceScript,
             _logger,
-            _executionId);
+            _executionId,
+            // Audit Log #23 (ParentExecutionId): the spawning execution's id,
+            // threaded alongside _executionId. Null for non-routed runs.
+            _parentExecutionId);
     }
 
     protected override void Dispose(bool disposing)