feat(cli): agent-relay drive <name> interactive take-over client (#864 sub-3)

.trajectories/active/traj_v87cyrs8dke9.json

@@ -6,8 +6,47 @@
   },
   "status": "active",
   "startedAt": "2026-05-14T14:28:34.155Z",
-  "agents": [],
-  "chapters": [],
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-05-18T04:01:59.334Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_alw03jfffmtf",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-05-18T04:01:59.334Z",
+      "events": [
+        {
+          "ts": 1779076919335,
+          "type": "decision",
+          "content": "Factored broker-connection discovery into src/cli/lib/broker-connection.ts",
+          "raw": {
+            "question": "Factored broker-connection discovery into src/cli/lib/broker-connection.ts",
+            "chosen": "Factored broker-connection discovery into src/cli/lib/broker-connection.ts",
+            "alternatives": [],
+            "reasoning": "Drive and view both need the same flag/env/connection.json fallback chain; pulling it out keeps both verbs aligned and unblocks future relay/new/run verbs from sub-PR 4."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1779076919835,
+          "type": "decision",
+          "content": "Hand-rolled keybind state machine in drive.ts instead of pulling in readline.emitKeypressEvents",
+          "raw": {
+            "question": "Hand-rolled keybind state machine in drive.ts instead of pulling in readline.emitKeypressEvents",
+            "chosen": "Hand-rolled keybind state machine in drive.ts instead of pulling in readline.emitKeypressEvents",
+            "alternatives": [],
+            "reasoning": "All bindings are ASCII control chars (Ctrl+G/Ctrl+C/Ctrl+B prefix). Tiny stateful parser handles cross-chunk Ctrl+B prefix cleanly and is trivially testable."
+          },
+          "significance": "high"
+        }
+      ]
+    }
+  ],
   "commits": [],
   "filesChanged": [],
   "projectId": "/Users/will/Projects/AgentWorkforce/relay",
@@ -16,4 +55,4 @@
     "startRef": "83ecfbca9cd87540629ae0a9b2f155cd2c3070cf",
     "endRef": "83ecfbca9cd87540629ae0a9b2f155cd2c3070cf"
   }
-}
+}

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

@@ -48,7 +48,7 @@
   },
   "commits": [],
   "filesChanged": [],
-  "projectId": "/Users/will/Projects/AgentWorkforce/relay/.claude/worktrees/agent-aff3649a00a0f36ab",
+  "projectId": "<repo-root>",
   "tags": [],
   "_trace": {
     "startRef": "a30e5c89ae5b80bf733a407590643d51f4c998b4",

.trajectories/index.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "lastUpdated": "2026-05-18T03:02:35.347Z",
+  "lastUpdated": "2026-05-18T04:01:59.836Z",
   "trajectories": {
     "traj_9gq96irkj00s": {
       "title": "Update relay to use published relaycast Rust reclaim fix",
@@ -414,7 +414,7 @@
       "title": "Upgrade .agentworkforce personas to latest 3.x shape",
       "status": "active",
       "startedAt": "2026-05-14T14:28:34.155Z",
-      "path": "/Users/will/Projects/AgentWorkforce/relay/.trajectories/active/traj_v87cyrs8dke9.json"
+      "path": ".trajectories/active/traj_v87cyrs8dke9.json"
     },
     "traj_v1wexlfur5zr": {
       "title": "Fix broker headless reliability doc",

src/cli/bootstrap.test.ts

@@ -38,6 +38,7 @@ const expectedLeafCommands = [
   'run',
   'connect',
   'view',
+  'drive',
   'dlq list',
   'dlq inspect',
   'dlq replay',

src/cli/bootstrap.ts

@@ -27,6 +27,7 @@ import { registerConnectCommands } from './commands/connect.js';
 import { registerOnCommands } from './commands/on.js';
 import { registerDlqCommands } from './commands/dlq.js';
 import { registerViewCommands } from './commands/view.js';
+import { registerDriveCommands } from './commands/drive.js';
 
 dotenvConfig({ quiet: true });
 
@@ -283,6 +284,7 @@ export function createProgram(options: { name?: string } = {}): Command {
   registerConnectCommands(program);
   registerDlqCommands(program);
   registerViewCommands(program);
+  registerDriveCommands(program);
 
   return program;
 }