From 90898cfd63ff01ca78878910c0a016328339152c Mon Sep 17 00:00:00 2001
From: Andraxion <administrator@andraxion.net>
Date: Fri, 24 Jul 2026 22:09:02 -0400
Subject: [PATCH] Allow explicit viewer lifecycle owner

---
 src/docforge/visualization.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/docforge/visualization.py b/src/docforge/visualization.py
index 653fab7..c059e10 100644
--- a/src/docforge/visualization.py
+++ b/src/docforge/visualization.py
@@ -669,11 +669,15 @@ class DetachedVisualizationRunner:
         self,
         index: ProjectIndex,
         *,
+        owner_pid: int | None = None,
         initial_grace_seconds: float = DEFAULT_INITIAL_GRACE_SECONDS,
         lease_seconds: float = DEFAULT_LEASE_SECONDS,
         monitor_interval_seconds: float = LEASE_MONITOR_INTERVAL_SECONDS,
     ) -> None:
+        if owner_pid is not None and owner_pid <= 1:
+            raise ValueError("Visualization owner PID must identify a live user process")
         self.index = index
+        self.owner_pid = owner_pid if owner_pid is not None else os.getppid()
         self.initial_grace_seconds = initial_grace_seconds
         self.lease_seconds = lease_seconds
         self.monitor_interval_seconds = monitor_interval_seconds
@@ -729,7 +733,7 @@ class DetachedVisualizationRunner:
                 "initial_grace_seconds": self.initial_grace_seconds,
                 "lease_seconds": self.lease_seconds,
                 "monitor_interval_seconds": self.monitor_interval_seconds,
-                "owner_pid": os.getppid(),
+                "owner_pid": self.owner_pid,
                 "target": {
                     "node_id": node_id,
                     "query": query,