docs(scripting): T starts at the run's start but is wall clock from there; document the late-notice, ceiling and counter rules (#827 review F4)

The proto comment, VirtualTags.md and CLAUDE.md said the soft deadline
measures the script's own execution and that starvation never counts. Only
the time before the run STARTS is excluded; from the start it is wall-clock
time, as in process, so a GC pause or a starved / suspended worker during
the run still counts. A mid-run freeze test is not added: it races the
script's own return against the watchdog's notice; documented as not covered.
Also documents F2 (late notice cancels and counts), F3 (progress ceiling,
killed_unresponsive) and F5 (answer = stalled | retrigger).
This commit is contained in:
Joseph Doherty
2026-11-11 02:26:28 -05:00
parent f50209082e
commit 5962cc3d41
5 changed files with 40 additions and 26 deletions
@@ -12,9 +12,10 @@ using ZB.MOM.WW.OtOpcUa.Core.Scripting.Protocol.V1;
namespace ZB.MOM.WW.OtOpcUa.ScriptWorker.Tests;
/// <summary>
/// lmxopcua#827: the soft deadline T measures the script's OWN execution — the worker runs it from the moment an
/// evaluation thread starts the run — so the pipe round trip and the time a starved worker waits to be scheduled
/// no longer count against the script. The host keeps a transport deadline (T + G from submit) and reports passing
/// lmxopcua#827: the soft deadline T starts when an evaluation thread starts the run — the worker runs that clock —
/// so the pipe round trip and the time a starved worker takes to START the run no longer count against the script.
/// From the start it is wall-clock time, as in process: a pause DURING the run still counts, and is not tested
/// here (a mid-run freeze races the script's own return against the watchdog's notice). The host keeps a transport deadline (T + G from submit) and reports passing
/// it as a runner fault (<see cref="ScriptRunOutcome.WorkerUnresponsiveReason"/>, BadResourceUnavailable), never as a
/// script timeout. The starved worker is made real here: its process is suspended (SIGSTOP / NtSuspendProcess)
/// while a trivial script is submitted.