feat(swarm): launch live swarm worker daemon under tmux supervisor

bin/swarm_worker/reporter.py

@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+"""Result reporter for swarm workers (Bridge Builder 3/5).
+
+Posts worker results back so the box state (and harvester) picks them up.
+
+Discovered result path (do not guess — verified against live code):
+  `box swarm-report <swarm-id> <slot>` with JSON on stdin:
+      {"ok": bool, "result": "<text>"}
+  Implemented by act_swarm_report() in bin/box-ctl.py. Sets the slot to
+  "done" (ok=True) or "failed" (ok=False) and records the result text.
+
+  The response-harvester ALSO bridges sidechat "[RESULT <swarm_id>/<slot>]"
+  markers into swarm-report (response-harvester.py ~L773), but calling
+  swarm-report directly is the reliable path: no harvester-scan dependency,
+  no dm.py sidechat round-trip. The result text we store carries the
+  "[RESULT <swarm_id>/<slot>]" marker in the harvester's expected format,
+  so both paths stay compatible.
+
+Runs on bl; calls bin/box-ctl.py directly (no container relay).
+"""
+
+import json
+import logging
+import subprocess
+import sys
+
+log = logging.getLogger("swarm_worker.reporter")
+
+BOX_CTL = "/home/super/Projects/NetVM/bin/box-ctl.py"
+SUMMARY_CHARS = 500
+
+
+def format_result(swarm_id, slot_index, result_dict):
+    """Build the result marker text and payload.
+
+    Returns (marker_text, payload_dict).
+    """
+    ok = bool(result_dict.get("ok", False))
+    output = result_dict.get("output") or result_dict.get("error") or ""
+    summary = str(output)[:SUMMARY_CHARS]
+    verb = "OK" if ok else "FAIL"
+    marker = "[RESULT %s/%s] %s %s" % (swarm_id, slot_index, verb, summary)
+    payload = {"ok": ok, "result": marker}
+    return marker, payload
+
+
+def post_result(swarm_id, slot_index, result_dict, dry_run=False):
+    """Post a worker result for a swarm slot.
+
+    Args:
+        swarm_id: e.g. "sw-20261005-151307-a222"
+        slot_index: int slot number
+        result_dict: {"ok": bool, "output": str} on success, or
+                     {"ok": False, "error": str} on failure.
+        dry_run: if True, print what WOULD be posted without posting.
+
+    Returns:
+        True on success, False on failure (error is logged, not raised).
+    """
+    marker, payload = format_result(swarm_id, slot_index, result_dict)
+
+    if dry_run:
+        print("DRY-RUN would run: %s swarm-report %s %s"
+              % (BOX_CTL, swarm_id, slot_index))
+        print("DRY-RUN stdin JSON: %s" % json.dumps(payload)[:700])
+        return True
+
+    try:
+        proc = subprocess.run(
+            [sys.executable, BOX_CTL, "swarm-report",
+             str(swarm_id), str(slot_index)],
+            input=json.dumps(payload).encode("utf-8"),
+            stdout=subprocess.PIPE, stderr=subprocess.PIPE,
+            timeout=60,
+        )
+    except Exception as e:  # noqa: BLE001 - report, don't raise
+        log.error("post_result %s/%s failed to invoke box-ctl: %s",
+                  swarm_id, slot_index, e)
+        return False
+
+    if proc.returncode != 0:
+        err = proc.stderr.decode("utf-8", "replace")[:500]
+        # Slot already closed (done/failed/killed) is a known benign case.
+        log.error("post_result %s/%s box-ctl rc=%d: %s",
+                  swarm_id, slot_index, proc.returncode, err)
+        return False
+
+    try:
+        resp = json.loads(proc.stdout.decode("utf-8", "replace"))
+    except ValueError:
+        log.error("post_result %s/%s: box-ctl returned non-JSON output",
+                  swarm_id, slot_index)
+        return False
+
+    if not resp.get("ok"):
+        log.error("post_result %s/%s: box-ctl ok=false: %s",
+                  swarm_id, slot_index, str(resp)[:500])
+        return False
+
+    return True
+
+
+if __name__ == "__main__":
+    # Manual dry-run smoke test: python3 reporter.py
+    # (Never posts real results from this entry point.)
+    logging.basicConfig(level=logging.DEBUG)
+    fake_ok = {"ok": True, "output": "did the thing\nline2\n" + "x" * 900}
+    fake_fail = {"ok": False, "error": "boom: something broke"}
+    print("== dry-run OK case ==")
+    assert post_result("sw-TEST-0000-dryrun", 0, fake_ok, dry_run=True)
+    print("== dry-run FAIL case ==")
+    assert post_result("sw-TEST-0000-dryrun", 1, fake_fail, dry_run=True)
+    m, p = format_result("sw-TEST-0000-dryrun", 0, fake_ok)
+    assert m.startswith("[RESULT sw-TEST-0000-dryrun/0] OK ")
+    assert len(m) <= len("[RESULT sw-TEST-0000-dryrun/0] OK ") + SUMMARY_CHARS
+    m2, _ = format_result("sw-TEST-0000-dryrun", 1, fake_fail)
+    assert m2.startswith("[RESULT sw-TEST-0000-dryrun/1] FAIL boom:")
+    print("dry-run smoke test PASSED")