threadkeeper 0.6.0__tar.gz → 0.6.1__tar.gz

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: threadkeeper
-Version: 0.6.0
+Version: 0.6.1
 Summary: Multi-agent shared brain across Claude Code/Desktop, Codex, Gemini, Copilot, VS Code. Cross-session memory, self-improving skill loops, inter-agent signaling — one local MCP server.
 Author: thread-keeper contributors
 License: MIT
@@ -432,6 +432,7 @@ The most-used env knobs (full list in `threadkeeper/config.py`):
 | `THREADKEEPER_MEMORY_GUARD_RECLAIM_MB` | 1024 | local RSS floor before warn-triggered self trim |
 | `THREADKEEPER_MEMORY_GUARD_TARGET_SERVERS` | 1 | aggregate-pressure target after retiring stale idle servers |
 | `THREADKEEPER_MEMORY_GUARD_RETIRE_IDLE_S` | 900 | heartbeat age before a non-self server is retireable |
+| `THREADKEEPER_MEMORY_GUARD_RETIRE_LIVE` | "" (off) | allow retiring parent-alive MCP servers; off protects live clients |
 | `THREADKEEPER_MEMORY_GUARD_NOTIFY` | "1" | send macOS desktop notification when possible |
 | `THREADKEEPER_INGEST_INTERVAL_S` | 3 | transcript ingest tick (s) |
 | `THREADKEEPER_NO_EMBEDDINGS` | "" | force-disable sentence-transformers |

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/README.md

@@ -398,6 +398,7 @@ The most-used env knobs (full list in `threadkeeper/config.py`):
 | `THREADKEEPER_MEMORY_GUARD_RECLAIM_MB` | 1024 | local RSS floor before warn-triggered self trim |
 | `THREADKEEPER_MEMORY_GUARD_TARGET_SERVERS` | 1 | aggregate-pressure target after retiring stale idle servers |
 | `THREADKEEPER_MEMORY_GUARD_RETIRE_IDLE_S` | 900 | heartbeat age before a non-self server is retireable |
+| `THREADKEEPER_MEMORY_GUARD_RETIRE_LIVE` | "" (off) | allow retiring parent-alive MCP servers; off protects live clients |
 | `THREADKEEPER_MEMORY_GUARD_NOTIFY` | "1" | send macOS desktop notification when possible |
 | `THREADKEEPER_INGEST_INTERVAL_S` | 3 | transcript ingest tick (s) |
 | `THREADKEEPER_NO_EMBEDDINGS` | "" | force-disable sentence-transformers |

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "threadkeeper"
-version = "0.6.0"
+version = "0.6.1"
 description = "Multi-agent shared brain across Claude Code/Desktop, Codex, Gemini, Copilot, VS Code. Cross-session memory, self-improving skill loops, inter-agent signaling — one local MCP server."
 requires-python = ">=3.11"
 authors = [{ name = "thread-keeper contributors" }]

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/tests/test_memory_guard.py

@@ -195,6 +195,7 @@ def test_check_apply_retires_idle_candidate_on_aggregate_pressure(mp_with_cid, m
     monkeypatch.setattr(memory_guard, "MEMORY_GUARD_AGG_KILL_MB", 3000)
     monkeypatch.setattr(memory_guard, "MEMORY_GUARD_TARGET_SERVERS", 1)
     monkeypatch.setattr(memory_guard, "MEMORY_GUARD_RETIRE_IDLE_S", 900)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_RETIRE_LIVE", False)
     monkeypatch.setattr(memory_guard, "reclaim_memory", lambda reason="": {
         "before_mb": 900, "after_mb": 800, "freed_mb": 100,
         "pid": os.getpid(), "actions": ["fake"],
@@ -203,7 +204,12 @@ def test_check_apply_retires_idle_candidate_on_aggregate_pressure(mp_with_cid, m
     def scan():
         return [
             _proc(os.getpid(), 900),
-            _proc(1001, 1200, ppid=os.getpid()) | {"heartbeat_age_s": None},
+            _proc(1001, 1200, ppid=1) | {
+                "heartbeat_age_s": None,
+                "parent_alive": False,
+                "is_orphaned": True,
+                "orphan_reason": "parent_gone + no_heartbeat",
+            },
             _proc(1002, 800, ppid=os.getpid()) | {"heartbeat_age_s": 5},
         ]
 
@@ -217,3 +223,33 @@ def test_check_apply_retires_idle_candidate_on_aggregate_pressure(mp_with_cid, m
     out = memory_guard.check_once(dry_run=False, notify=False)
     assert out["retired"] == [1001]
     assert calls == [(1001, _sig.SIGTERM)]
+
+
+def test_aggregate_retire_skips_live_parent_without_opt_in(mp_with_cid, monkeypatch):
+    mp_with_cid(_FAKE_CID)
+    from threadkeeper import memory_guard, process_health
+
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_WARN_MB", 5000)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_KILL_MB", 6000)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_AGG_WARN_MB", 2000)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_AGG_KILL_MB", 3000)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_TARGET_SERVERS", 1)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_RETIRE_IDLE_S", 900)
+    monkeypatch.setattr(memory_guard, "MEMORY_GUARD_RETIRE_LIVE", False)
+    monkeypatch.setattr(memory_guard, "reclaim_memory", lambda reason="": {
+        "before_mb": 900, "after_mb": 800, "freed_mb": 100,
+        "pid": os.getpid(), "actions": ["fake"],
+    })
+    monkeypatch.setattr(process_health, "scan", lambda: [
+        _proc(os.getpid(), 900),
+        _proc(1001, 1200, ppid=os.getpid()) | {"heartbeat_age_s": None},
+    ])
+    calls: list[tuple[int, int]] = []
+    monkeypatch.setattr(
+        "os.kill",
+        lambda pid, sig: calls.append((pid, sig)) if sig != 0 else None,
+    )
+
+    out = memory_guard.check_once(dry_run=False, notify=False)
+    assert out["retired"] == []
+    assert calls == []

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/threadkeeper/config.py

@@ -183,6 +183,9 @@ MEMORY_GUARD_TARGET_SERVERS: int = int(
 MEMORY_GUARD_RETIRE_IDLE_S: int = int(
     os.environ.get("THREADKEEPER_MEMORY_GUARD_RETIRE_IDLE_S", "900")
 )
+MEMORY_GUARD_RETIRE_LIVE: bool = os.environ.get(
+    "THREADKEEPER_MEMORY_GUARD_RETIRE_LIVE", ""
+).lower() in {"1", "true", "yes", "on"}
 MEMORY_GUARD_NOTIFY: bool = os.environ.get(
     "THREADKEEPER_MEMORY_GUARD_NOTIFY", "1"
 ).lower() in {"1", "true", "yes", "on"}

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/threadkeeper/memory_guard.py

@@ -28,6 +28,7 @@ from .config import (
     MEMORY_GUARD_POLL_S,
     MEMORY_GUARD_RECLAIM_MB,
     MEMORY_GUARD_RETIRE_IDLE_S,
+    MEMORY_GUARD_RETIRE_LIVE,
     MEMORY_GUARD_TARGET_SERVERS,
     MEMORY_GUARD_WARN_MB,
     TASK_LOG_DIR,
@@ -288,6 +289,7 @@ def _aggregate_state(procs: list[dict]) -> dict:
         "kill_mb": MEMORY_GUARD_AGG_KILL_MB,
         "target_servers": MEMORY_GUARD_TARGET_SERVERS,
         "retire_idle_s": MEMORY_GUARD_RETIRE_IDLE_S,
+        "retire_live": MEMORY_GUARD_RETIRE_LIVE,
     }
 
 
@@ -296,6 +298,8 @@ def _idle_retire_candidates(procs: list[dict]) -> list[dict]:
     for p in procs:
         if p.get("is_self"):
             continue
+        if p.get("parent_alive") and not MEMORY_GUARD_RETIRE_LIVE:
+            continue
         hb = p.get("heartbeat_age_s")
         if hb is None or hb >= MEMORY_GUARD_RETIRE_IDLE_S:
             candidates.append(dict(p, rss_mb=_rss_mb(p)))

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/threadkeeper/tools/memory_guard.py

@@ -32,6 +32,7 @@ def memory_guard_status() -> str:
         f"warn_mb={result['warn_mb']} kill_mb={result['kill_mb']} "
         f"agg_warn_mb={agg['warn_mb']} agg_kill_mb={agg['kill_mb']} "
         f"target_servers={agg['target_servers']} "
+        f"retire_live={'on' if agg['retire_live'] else 'off'} "
         f"notify={'on' if result['notify'] else 'off'}",
         f"processes={len(procs)} rss_total={total_mb}MB aggregate={agg_marker}",
     ]

{threadkeeper-0.6.0 → threadkeeper-0.6.1}/threadkeeper.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: threadkeeper
-Version: 0.6.0
+Version: 0.6.1
 Summary: Multi-agent shared brain across Claude Code/Desktop, Codex, Gemini, Copilot, VS Code. Cross-session memory, self-improving skill loops, inter-agent signaling — one local MCP server.
 Author: thread-keeper contributors
 License: MIT
@@ -432,6 +432,7 @@ The most-used env knobs (full list in `threadkeeper/config.py`):
 | `THREADKEEPER_MEMORY_GUARD_RECLAIM_MB` | 1024 | local RSS floor before warn-triggered self trim |
 | `THREADKEEPER_MEMORY_GUARD_TARGET_SERVERS` | 1 | aggregate-pressure target after retiring stale idle servers |
 | `THREADKEEPER_MEMORY_GUARD_RETIRE_IDLE_S` | 900 | heartbeat age before a non-self server is retireable |
+| `THREADKEEPER_MEMORY_GUARD_RETIRE_LIVE` | "" (off) | allow retiring parent-alive MCP servers; off protects live clients |
 | `THREADKEEPER_MEMORY_GUARD_NOTIFY` | "1" | send macOS desktop notification when possible |
 | `THREADKEEPER_INGEST_INTERVAL_S` | 3 | transcript ingest tick (s) |
 | `THREADKEEPER_NO_EMBEDDINGS` | "" | force-disable sentence-transformers |