refactor(broker): split main entrypoint

.trajectories/completed/2026-05/traj_47akjihewlow.json

@@ -0,0 +1,73 @@
+{
+  "id": "traj_47akjihewlow",
+  "version": 1,
+  "task": {
+    "title": "Further split broker runtime module for issue 875",
+    "source": {
+      "system": "plain",
+      "id": "#875"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-05-19T01:28:35.746Z",
+  "completedAt": "2026-05-19T01:38:29.105Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-05-19T01:36:08.629Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_t1myrcwsr9k7",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-05-19T01:36:08.629Z",
+      "endedAt": "2026-05-19T01:38:29.105Z",
+      "events": [
+        {
+          "ts": 1779154568630,
+          "type": "decision",
+          "content": "Split broker runtime by responsibility: Split broker runtime by responsibility",
+          "raw": {
+            "question": "Split broker runtime by responsibility",
+            "chosen": "Split broker runtime by responsibility",
+            "alternatives": [],
+            "reasoning": "Kept the CLI-facing runtime API stable while moving cohesive concerns into runtime submodules: init loop, session setup, pending delivery, headless worker, connection discovery, paths, terminal/system helpers, message/thread helpers, frame IO, and spawn spec parsing."
+          },
+          "significance": "high"
+        }
+      ]
+    }
+  ],
+  "retrospective": {
+    "summary": "Split broker runtime into focused modules for session setup, init loop, pending delivery, headless workers, connection discovery, paths, frame I/O, message/thread helpers, system helpers, spawn spec parsing, and tests.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  },
+  "commits": ["7182810c"],
+  "filesChanged": [
+    "crates/broker/src/runtime.rs",
+    "crates/broker/src/runtime/connection.rs",
+    "crates/broker/src/runtime/delivery.rs",
+    "crates/broker/src/runtime/headless.rs",
+    "crates/broker/src/runtime/init.rs",
+    "crates/broker/src/runtime/io.rs",
+    "crates/broker/src/runtime/messages.rs",
+    "crates/broker/src/runtime/mod.rs",
+    "crates/broker/src/runtime/paths.rs",
+    "crates/broker/src/runtime/session.rs",
+    "crates/broker/src/runtime/spawn_spec.rs",
+    "crates/broker/src/runtime/system.rs",
+    "crates/broker/src/runtime/tests.rs",
+    "crates/broker/src/runtime/util.rs"
+  ],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay",
+  "tags": [],
+  "_trace": {
+    "startRef": "d52c1476dc8b28f8504cf9d60dce10b1719b8c59",
+    "endRef": "7182810ce4863543c825d747a8f159644981d485",
+    "traceId": "c271dee5-bc34-4695-8fb1-bb228ded699f"
+  }
+}

.trajectories/completed/2026-05/traj_47akjihewlow.md

@@ -0,0 +1,41 @@
+# Trajectory: Further split broker runtime module for issue 875
+
+> **Status:** ✅ Completed
+> **Task:** #875
+> **Confidence:** 90%
+> **Started:** May 18, 2026 at 09:28 PM
+> **Completed:** May 18, 2026 at 09:38 PM
+
+---
+
+## Summary
+
+Split broker runtime into focused modules for session setup, init loop, pending delivery, headless workers, connection discovery, paths, frame I/O, message/thread helpers, system helpers, spawn spec parsing, and tests.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Split broker runtime by responsibility
+
+- **Chose:** Split broker runtime by responsibility
+- **Reasoning:** Kept the CLI-facing runtime API stable while moving cohesive concerns into runtime submodules: init loop, session setup, pending delivery, headless worker, connection discovery, paths, terminal/system helpers, message/thread helpers, frame IO, and spawn spec parsing.
+
+---
+
+## Chapters
+
+### 1. Work
+
+_Agent: default_
+
+- Split broker runtime by responsibility: Split broker runtime by responsibility
+
+---
+
+## Artifacts
+
+**Commits:** 7182810c
+**Files changed:** 14

.trajectories/completed/2026-05/traj_47akjihewlow.trace.json

@@ -0,0 +1,234 @@
+{
+  "version": "1.0.0",
+  "id": "c271dee5-bc34-4695-8fb1-bb228ded699f",
+  "timestamp": "2026-05-19T01:38:29.210Z",
+  "trajectory": "traj_47akjihewlow",
+  "files": [
+    {
+      "path": "crates/broker/src/runtime/connection.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 193,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/delivery.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 455,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/headless.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 387,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/init.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 4,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            },
+            {
+              "start_line": 3207,
+              "end_line": 3209,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/io.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 70,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/messages.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 572,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/mod.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 89,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/paths.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 184,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/session.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 264,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/spawn_spec.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 68,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/system.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 94,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/tests.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 1743,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "path": "crates/broker/src/runtime/util.rs",
+      "conversations": [
+        {
+          "contributor": {
+            "type": "ai"
+          },
+          "ranges": [
+            {
+              "start_line": 1,
+              "end_line": 211,
+              "revision": "7182810ce4863543c825d747a8f159644981d485"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}