From 4e309ee91a1b246ede1f8ada494ed35cb2d4f465 Mon Sep 17 00:00:00 2001
From: Vito Sansevero <vito.sansevero@gmail.com>
Date: Sat, 17 Oct 2026 13:28:25 -0700
Subject: [PATCH] docs(inspector): explain the subprocess cleanup race

---
 utils/prompt_inspector.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/utils/prompt_inspector.py b/utils/prompt_inspector.py
index 7ea2d00..e54fbb2 100644
--- a/utils/prompt_inspector.py
+++ b/utils/prompt_inspector.py
@@ -134,6 +134,7 @@ def _video_metadata(path: Path) -> dict:
             try:
                 process.kill()
             except OSError:
+                # Timeout and final cleanup can race with the process exiting.
                 pass
 
     timer = threading.Timer(3, stop)