feat(site-runtime): stuck-script watchdog names the script holding a scheduler thread past timeout (S2)

2026-07-08 23:46:48 -04:00
parent dddafc025e
commit 467edd74ac
3 changed files with 105 additions and 0 deletions
@@ -65,4 +65,14 @@ public class SiteRuntimeOptions
    /// Reserved — consumed by the standby replication fetch in a later task; not yet wired.
    /// </summary>
    public int ConfigFetchRetryCount { get; set; } = 3;
+
+    /// <summary>
+    /// Grace period (ms) after a script's execution timeout elapses before the
+    /// stuck-script watchdog declares the script's dedicated thread blocked and
+    /// emits a loud site event naming it (S2). The CTS timeout only requests
+    /// cooperative cancellation; a script blocked in synchronous I/O never
+    /// observes it, so this watchdog is the only operator signal that one of the
+    /// bounded script-execution threads is gone. Default: 30000ms.
+    /// </summary>
+    public int StuckScriptGraceMs { get; set; } = 30000;
 }