swarph-cli 0.69.8__tar.gz → 0.69.9__tar.gz

{swarph_cli-0.69.8/src/swarph_cli.egg-info → swarph_cli-0.69.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swarph-cli
-Version: 0.69.8
+Version: 0.69.9
 Summary: The `swarph` binary — a multi-LLM CLI and mesh-gateway client + bundled server (`swarph gateway`): one-shot prompts across providers, interactive `chat`, multi-provider `spawn` (claude/codex/antigravity via a ProviderMembrane with subprocess billing-scrub), `mesh` send/inbox/register, `brain-ask` over the swarph-brain (gbrain) semantic memory, git-backed `assisted_memory`, per-invocation `gh` identity routing, a silent DM-wake hook, session `import`, and a stranded-session `watchdog`.
 Author: Pierre Samson, Claude Opus
 License: MIT

{swarph_cli-0.69.8 → swarph_cli-0.69.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "swarph-cli"
-version = "0.69.8"
+version = "0.69.9"
 description = "The `swarph` binary — a multi-LLM CLI and mesh-gateway client + bundled server (`swarph gateway`): one-shot prompts across providers, interactive `chat`, multi-provider `spawn` (claude/codex/antigravity via a ProviderMembrane with subprocess billing-scrub), `mesh` send/inbox/register, `brain-ask` over the swarph-brain (gbrain) semantic memory, git-backed `assisted_memory`, per-invocation `gh` identity routing, a silent DM-wake hook, session `import`, and a stranded-session `watchdog`."
 readme = "README.md"
 license = { text = "MIT" }

{swarph_cli-0.69.8 → swarph_cli-0.69.9}/src/swarph_cli/__init__.py

@@ -16,6 +16,6 @@ The architecture splits CLI from substrate so:
 
 from __future__ import annotations
 
-__version__ = "0.69.8"
+__version__ = "0.69.9"
 
 __all__ = ["__version__"]

{swarph_cli-0.69.8 → swarph_cli-0.69.9}/src/swarph_cli/commands/monitor.py

@@ -326,6 +326,34 @@ def _read_cgroup(pid: int) -> "str | None":
         return None
 
 
+def _service_leaf(text: "str | None") -> "str | None":
+    """The .service leaf of a cgroup, or None.
+
+    user@<uid>.service is the session manager, not a supervisor. The leaf
+    keeps its .service suffix so a later reader can name the unit after
+    this process is gone.
+    """
+    if not text:
+        return None
+    for line in text.splitlines():
+        leaf = line.rsplit("/", 1)[-1].strip()
+        if leaf.endswith(".service") and not leaf.startswith("user@"):
+            return leaf
+    return None
+
+
+def _supervisor_for_pidfile(explicit: "str | None") -> "str | None":
+    """What start writes into monitor.pid.
+
+    An explicit claim wins. Otherwise read this process's own cgroup now,
+    while the pid is still ours. A later status must not open /proc/<pid>
+    for a dead monitor: that pid may have been reused.
+    """
+    if explicit:
+        return explicit
+    return _service_leaf(_read_cgroup(os.getpid()))
+
+
 def _derive_systemd_unit(pid: "int | None") -> "str | None":
     """The supervisor Linux already knows (#344 review): Windows has no
     pid→task map so the pidfile CLAIM is the whole answer there, but on
@@ -589,10 +617,11 @@ def _cmd_start(args: argparse.Namespace) -> int:
         )
         return 0
 
+    recorded = _supervisor_for_pidfile(supervisor)
     if args.once:
         mesh.write_pidfile(
             pidfile, self_name=self_name, sinks=sinks, poll_s=args.poll_s,
-            supervisor=supervisor,
+            supervisor=recorded,
         )
         mesh._monitor_iteration(state)
         return 0
@@ -602,10 +631,10 @@ def _cmd_start(args: argparse.Namespace) -> int:
             print("swarph monitor: no fork() on this platform — running in the "
                   "foreground", file=sys.stderr)
         return _run_pinned(state, pidfile, self_name, sinks, args.poll_s,
-                           supervisor=supervisor)
+                           supervisor=recorded)
 
     return _start_detached(state, pidfile, self_name, sinks, args.poll_s,
-                           supervisor=supervisor)
+                           supervisor=recorded)
 
 
 def _run_pinned(state, pidfile: Path, self_name: str, sinks: list, poll_s: int,

swarph_cli-0.69.9/src/swarph_cli/scripts/wake_watchdog.py

@@ -0,0 +1,385 @@
+"""Card #729. Every pass, a cell with nobody reading its inbox is an outage.
+
+One DM per outage. A live watcher clears it, so the next gap can alert again.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import subprocess
+import sys
+import time
+from pathlib import Path
+from typing import Iterable
+
+GAP_SECONDS = 60
+
+
+def writer_verdict(*, reader_alive: bool, monitor_rc: int) -> str:
+    """The heartbeat is the reader. The pull monitor is the writer of inbox.log.
+
+    A live reader with monitor status 2 is writer-down. A live monitor with a
+    fresh heartbeat is healthy. This does not start a process.
+    """
+    if not reader_alive:
+        return "reader-down"
+    if monitor_rc == 2:
+        return "writer-down"
+    return "healthy"
+
+
+def writer_transition(down: bool, rec: dict) -> bool:
+    """True only on the edge into writer-down.
+
+    A healthy pass clears the flag. A down pass does not set it: the caller
+    marks the alert only after the DM returns 0, so a lost send is retried.
+    """
+    if not down:
+        rec["writer_down"] = False
+        return False
+    return not bool(rec.get("writer_down"))
+
+
+def supervisor_from_cgroup(text: str | None) -> str:
+    """The unit leaf of a cgroup listing, the same rule monitor status uses.
+
+    A swarph-monitor service, including the non-template names
+    swarph-monitor.service and swarph-monitor-<cell>.service, is the
+    supervisor. user@<uid>.service is the session manager, not one.
+    Anything else is unsupervised.
+    """
+    if not text:
+        return "unsupervised"
+    for line in text.splitlines():
+        leaf = line.rsplit("/", 1)[-1].strip()
+        if not leaf.endswith(".service") or leaf.startswith("user@"):
+            continue
+        if leaf.startswith("swarph-monitor"):
+            return leaf
+    return "unsupervised"
+
+
+def writer_alert(cell: str, recorded: str | None, *, owned: bool = False) -> str:
+    """Name the supervisor recorded at start, or the enabled template unit."""
+    who = _alert_supervisor(recorded)
+    if who == "unsupervised" and owned:
+        who = f"swarph-monitor@{cell}.service"
+    if who == "unsupervised":
+        return f"{cell}: writer-down, unsupervised"
+    return f"{cell}: writer-down, supervised by {who}"
+
+
+def systemd_owns_monitor(cell: str, run=None) -> bool:
+    """True when either scope has an enabled swarph-monitor@<cell> unit.
+
+    That result is part of the writer-down alert when the cgroup names no
+    swarph-monitor leaf. This function does not start a process.
+    """
+    unit = f"swarph-monitor@{cell}.service"
+    runner = run if run is not None else subprocess.run
+    owned = False
+    for argv in (
+        ["systemctl", "is-enabled", unit],
+        ["systemctl", "--user", "is-enabled", unit],
+    ):
+        try:
+            proc = runner(argv, capture_output=True, text=True,
+                          encoding="utf-8", errors="replace", check=False)
+        except FileNotFoundError:
+            continue
+        if proc.returncode == 0:
+            owned = True
+    return owned
+
+
+def enforce_writers(cells: dict[str, str], *, status, run=None,
+                    state: dict | None = None) -> list[str]:
+    """Cells that just transitioned to writer-down.
+
+    Both systemd scopes are still checked. Nothing here starts a monitor.
+    Supervision stays with the unit. One name is returned per down edge.
+    """
+    alert = []
+    state = state if state is not None else {}
+    for name, inbox in cells.items():
+        if not _channel_alive(inbox):
+            continue
+        try:
+            rc = int(status(name))
+        except (TypeError, ValueError, OSError):
+            continue
+        rec_owned = systemd_owns_monitor(name, run=run)
+        verdict = writer_verdict(reader_alive=True, monitor_rc=rc)
+        rec = state.setdefault(name, {})
+        rec["systemd_owned"] = rec_owned
+        if writer_transition(verdict == "writer-down", rec):
+            alert.append(name)
+    return alert
+
+
+def _channel_alive(inbox: str, now: float | None = None) -> bool:
+    """A channel server writes channel_heartbeat.json beside the inbox every 60 s.
+
+    `swarph channel-serve` takes no inbox argument, so no command line names the
+    path; a fresh heartbeat is the only evidence the channel is reading.
+    """
+    hb = Path(inbox).parent / "channel_heartbeat.json"
+    try:
+        ts = float(json.loads(hb.read_text(encoding="utf-8")).get("ts") or 0)
+    except (OSError, ValueError, TypeError, AttributeError):
+        return False
+    return (time.time() if now is None else now) - ts < 180
+
+
+def _watching(inbox: str, cmdlines: Iterable[str]) -> bool:
+    """A reader is tail or dm_notify_filter with the inbox path as its own argument,
+    or a channel server whose heartbeat is fresh.
+
+    A process that merely mentions the path (a prompt, a log line) is not a reader.
+    """
+    if _channel_alive(inbox):
+        return True
+    for cmd in cmdlines:
+        parts = cmd.split()
+        if inbox not in parts:
+            continue
+        if any(os.path.basename(p) == "tail" for p in parts):
+            return True
+        if any(p.endswith("dm_notify_filter") or p.endswith("dm_notify_filter.py") for p in parts):
+            return True
+    return False
+
+
+def _cron_watched(name: str, crontab: str) -> bool:
+    """An active crontab line that runs dm_wake.py for this cell is its poller."""
+    for line in crontab.splitlines():
+        body = line.strip()
+        if not body or body.startswith("#"):
+            continue
+        if name in body and "dm_wake.py" in body:
+            return True
+    return False
+
+
+def _timer_watched(name: str, timers: Iterable[str]) -> bool:
+    needle = f"swarph-codex-waker@{name}.timer"
+    return any(needle in line for line in timers)
+
+
+def scan(cells: dict[str, str], cmdlines: Iterable[str], state: dict,
+         now: float, *, gap: float = GAP_SECONDS,
+         timers: Iterable[str] = (), crontab: str = "") -> list[str]:
+    """Return the cells that should get the one DM for this outage."""
+    alert = []
+    timers = list(timers)
+    for name, inbox in cells.items():
+        rec = state.setdefault(name, {})
+        if (_watching(inbox, cmdlines) or _timer_watched(name, timers)
+                or _cron_watched(name, crontab)):
+            rec["missing_since"] = None
+            rec["outage"] = False
+            continue
+        since = rec.get("missing_since")
+        if since is None:
+            rec["missing_since"] = now
+            continue
+        if now - since > gap and not rec.get("outage"):
+            alert.append(name)
+    return alert
+
+
+def cells_under(root: Path) -> dict[str, str]:
+    found = {}
+    if not root.is_dir():
+        return found
+    for child in sorted(root.iterdir()):
+        inbox = child / "mesh-sidecar" / "inbox.log"
+        if inbox.is_file():
+            found[child.name] = str(inbox)
+    return found
+
+
+def load_state(path: Path) -> dict:
+    try:
+        return json.loads(path.read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return {}
+
+
+def save_state(path: Path, state: dict) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(state), encoding="utf-8")
+
+
+def _listing(argv: list[str]) -> str:
+    """A missing binary is an empty listing, which is also a host with no timers."""
+    try:
+        listed = subprocess.run(
+            argv, capture_output=True, text=True,
+            encoding="utf-8", errors="replace", check=False)
+    except FileNotFoundError:
+        return ""
+    return listed.stdout or ""
+
+
+def _crontab() -> str:
+    return _listing(["crontab", "-l"])
+
+
+def _timer_lines() -> list[str]:
+    return _listing(
+        ["systemctl", "--user", "list-timers", "--all", "--no-legend"]).splitlines()
+
+
+def _alert_supervisor(recorded: str | None) -> str:
+    """A unit name recorded at start, or a cgroup blob from an older test.
+
+    A plain unit name is trusted: the monitor wrote it from its own cgroup
+    while the pid was still its own. Cgroup text is parsed the same way.
+    """
+    if not recorded or not str(recorded).strip():
+        return "unsupervised"
+    text = str(recorded).strip()
+    if "/" in text or "\n" in text:
+        return supervisor_from_cgroup(text)
+    if text.startswith("user@"):
+        return "unsupervised"
+    return text
+
+
+def recorded_supervisor(root: Path, cell: str) -> str | None:
+    """The supervisor field of monitor.pid.
+
+    The pid in that file may be dead, and a dead pid can be reused by an
+    unrelated process. The field was written at start and still answers.
+    This function does not open a process listing.
+    """
+    pidfile = root / cell / "mesh-sidecar" / "monitor.pid"
+    try:
+        rec = json.loads(pidfile.read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return None
+    if not isinstance(rec, dict):
+        return None
+    who = rec.get("supervisor")
+    if isinstance(who, str) and who.strip():
+        return who.strip()
+    return None
+
+
+def mesh_send(swarph: str, to: str, sender: str, content: str,
+             token_file: str = "") -> int:
+    """Send one FYI. A self-send is refused and logged. The token is a path."""
+    if sender and to and sender == to:
+        print(f"wake_watchdog: refusing self-send to {to}", file=sys.stderr)
+        return 2
+    argv = [swarph, "mesh", "send", to, "--as", sender, "--kind", "fyi",
+            "--content", content]
+    if token_file:
+        argv.extend(["--token-file", token_file])
+    proc = subprocess.run(argv, check=False)
+    return proc.returncode
+
+
+def _swarph_bin() -> str:
+    explicit = os.environ.get("SWARPH_BIN", "")
+    if explicit:
+        return explicit
+    home = os.path.expanduser("~/.local/bin/swarph")
+    if os.path.isfile(home):
+        return home
+    return "swarph"
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(prog="wake_watchdog")
+    p.add_argument("--dry-run", action="store_true",
+                   help="write state and list unwatched cells; do not send")
+    p.add_argument("--as", dest="sender", default="",
+                   help="cell the alert is sent as; the unit sets this")
+    p.add_argument("--escalate",
+                   default=os.environ.get("WAKE_WATCHDOG_ESCALATE", "drop-on-meta-edge"),
+                   help="awake peer who also gets the outage DM (default: drop-on-meta-edge)")
+    p.add_argument("--token-file", default="",
+                   help="bearer token file for the service identity; the path is passed through, never the value")
+    args = p.parse_args(argv)
+    root = Path(os.environ.get("SWARPH_STATE_ROOT", os.path.expanduser("~/swarph_state")))
+    state_path = Path(os.environ.get(
+        "WAKE_WATCHDOG_STATE",
+        os.path.expanduser("~/.local/state/wake-watchdog.json")))
+    import time
+    cmdlines = _listing(["ps", "-eo", "args"]).splitlines()
+    timers = _timer_lines()
+    crontab = _crontab()
+    cells = cells_under(root)
+    state = load_state(state_path)
+    alert = scan(cells, cmdlines, state, time.time(), timers=timers, crontab=crontab)
+    sender = args.sender.strip()
+    escalate = (args.escalate or "").strip()
+    if not args.dry_run and escalate and sender and escalate == sender:
+        print("wake_watchdog: escalation peer equals the sender; refusing to send",
+              file=sys.stderr)
+        return 2
+    swarph = _swarph_bin()
+
+    def _status(name: str, _sw: str = swarph) -> int:
+        proc = subprocess.run(
+            [_sw, "monitor", "status", "--as", name],
+            capture_output=True, text=True, encoding="utf-8", errors="replace",
+            check=False)
+        return proc.returncode
+
+    reported = enforce_writers(cells, status=_status, state=state)
+    save_state(state_path, state)
+    token_file = (args.token_file or "").strip()
+    for name in reported:
+        print(f"writer-down {name}", flush=True)
+        if args.dry_run or not sender:
+            continue
+        owned = bool(state.get(name, {}).get("systemd_owned"))
+        sent = mesh_send(
+            swarph, escalate or "", sender,
+            writer_alert(name, recorded_supervisor(root, name), owned=owned),
+            "")
+        if sent == 0:
+            state.setdefault(name, {})["writer_down"] = True
+            save_state(state_path, state)
+    if args.dry_run:
+        for name, inbox in cells.items():
+            if not (_watching(inbox, cmdlines) or _timer_watched(name, timers)
+                    or _cron_watched(name, crontab)):
+                print(name, flush=True)
+        return 0
+    sender = args.sender.strip()
+    if not sender:
+        print("wake_watchdog: --as is empty; not marking any cell alerted", file=sys.stderr)
+        return 2
+    swarph = _swarph_bin()
+    rc = 0
+    for name in alert:
+        print(f"outage {name}", flush=True)
+        dm_rc = mesh_send(
+            swarph, name, sender, "your DM wake is dead, re-arm", token_file)
+        dm_ok = dm_rc == 0
+        card_argv = [swarph, "board", "cards", "say", "729", "--as", sender,
+                     "--to", name, "--content", f"{name}: DM wake is dead, re-arm"]
+        if token_file:
+            card_argv.extend(["--token-file", token_file])
+        card = subprocess.run(card_argv, check=False)
+        esc_ok = True
+        if escalate and escalate != name:
+            esc_rc = mesh_send(
+                swarph, escalate, sender, f"{name}: DM wake is dead, re-arm",
+                token_file)
+            esc_ok = esc_rc == 0
+        if dm_ok and card.returncode == 0 and esc_ok:
+            state[name]["outage"] = True
+            save_state(state_path, state)
+        else:
+            rc = 1
+    return rc
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{swarph_cli-0.69.8 → swarph_cli-0.69.9/src/swarph_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: swarph-cli
-Version: 0.69.8
+Version: 0.69.9
 Summary: The `swarph` binary — a multi-LLM CLI and mesh-gateway client + bundled server (`swarph gateway`): one-shot prompts across providers, interactive `chat`, multi-provider `spawn` (claude/codex/antigravity via a ProviderMembrane with subprocess billing-scrub), `mesh` send/inbox/register, `brain-ask` over the swarph-brain (gbrain) semantic memory, git-backed `assisted_memory`, per-invocation `gh` identity routing, a silent DM-wake hook, session `import`, and a stranded-session `watchdog`.
 Author: Pierre Samson, Claude Opus
 License: MIT

{swarph_cli-0.69.8 → swarph_cli-0.69.9}/src/swarph_cli.egg-info/SOURCES.txt

@@ -230,6 +230,7 @@ tests/test_729_dm_once.py
 tests/test_729_wake_watchdog.py
 tests/test_734_dreaming_enrich_degrade.py
 tests/test_735_dm_mcp_tools.py
+tests/test_739_wake_writer.py
 tests/test_740_edit_project.py
 tests/test_762_cards_edit_priority.py
 tests/test_764_enrich_collapse.py

{swarph_cli-0.69.8 → swarph_cli-0.69.9}/tests/test_644_monitor_supervision.py

@@ -76,6 +76,38 @@ def test_pidfile_records_supervisor_when_given(tmp_path):
     assert rec["supervisor"] == "task:Swarph cursor-win Monitor"
 
 
+def test_start_records_the_cgroup_unit_and_keeps_it_after_the_process(monkeypatch, tmp_path):
+    """A scratch transient unit is written at start from this process's cgroup.
+
+    The pidfile is what a later watchdog reads. The key stays when the
+    process is gone; this test does not open another process's listing.
+    """
+    _env(monkeypatch)
+    monkeypatch.setattr(monitor, "_verify_self_is_registered",
+                        lambda *a, **k: (True, "registered"))
+    monkeypatch.setattr(mesh, "_monitor_iteration", lambda state: None)
+    monkeypatch.setattr(
+        monitor, "_read_cgroup",
+        lambda pid: "0::/user.slice/scratch-761.service\n")
+    assert _run(["start", "--once"], tmp_path) == 0
+    rec = json.loads((tmp_path / "monitor.pid").read_text(encoding="utf-8"))
+    assert rec["supervisor"] == "scratch-761.service"
+    assert rec["pid"] == os.getpid()
+
+
+def test_start_does_not_record_the_session_manager(monkeypatch, tmp_path):
+    _env(monkeypatch)
+    monkeypatch.setattr(monitor, "_verify_self_is_registered",
+                        lambda *a, **k: (True, "registered"))
+    monkeypatch.setattr(mesh, "_monitor_iteration", lambda state: None)
+    monkeypatch.setattr(
+        monitor, "_read_cgroup",
+        lambda pid: "0::/user.slice/user@1000.service\n")
+    assert _run(["start", "--once"], tmp_path) == 0
+    rec = json.loads((tmp_path / "monitor.pid").read_text(encoding="utf-8"))
+    assert "supervisor" not in rec
+
+
 def test_pidfile_omits_supervisor_key_when_not_given(tmp_path):
     """Absent means ORPHAN — a MISSING key, not an empty string, so a reader
     never has to guess whether '' is a claim."""

{swarph_cli-0.69.8 → swarph_cli-0.69.9}/tests/test_729_wake_watchdog.py

@@ -78,6 +78,8 @@ def test_main_guard_is_required():
     unit = Path("deploy/wake-watchdog.service").read_text(encoding="utf-8")
     assert "PYTHONPATH" not in unit
     assert "--as lab-ovh" in unit
+    assert "--escalate drop-on-meta-edge" in unit
+    assert "token-file" not in unit
     assert "Environment=MESH_GATEWAY_URL=http://100.64.189.91:8788" in unit