diff --git a/internal/lua/plugin_runtime.go b/internal/lua/plugin_runtime.go
index 382fd5e..7a8ded2 100644
--- a/internal/lua/plugin_runtime.go
+++ b/internal/lua/plugin_runtime.go
@@ -53,8 +53,10 @@ type ScheduledTask struct {
 	// many replicas) do not all hit the same upstream at :00.
 	Jitter int `json:"jitter,omitempty"`
 	// Timeout, in seconds, bounds one execution. 0 uses defaultTaskTimeout.
-	// A task that exceeds it is interrupted at the Lua instruction level — the
-	// only way to stop a runaway script on the C stack.
+	// NOTE: a running Lua call CANNOT be interrupted in this LuaJIT build (see
+	// the capability note in checkWedged). The timeout is therefore enforced at
+	// the generation level — a task that overruns wedgedAfter has its whole VM
+	// abandoned — not by stopping the script mid-instruction.
 	Timeout int `json:"timeout,omitempty"`
 }