feat(cli): agent-relay view <name> read-only stream client (#864 sub-1)

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

@@ -0,0 +1,93 @@
+{
+  "id": "traj_ybcrij9wg8m1",
+  "version": 1,
+  "task": {
+    "title": "Implement agent-relay view <name> read-only stream client (#864 sub-1)",
+    "source": {
+      "system": "plain",
+      "id": "ENG-864"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-05-18T02:02:07.524Z",
+  "completedAt": "2026-05-18T02:05:41.120Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-05-18T02:05:33.493Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_t9njxz16mexd",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-05-18T02:05:33.493Z",
+      "endedAt": "2026-05-18T02:05:41.120Z",
+      "events": [
+        {
+          "ts": 1779069933494,
+          "type": "decision",
+          "content": "Reuse 'ws' npm package — already a dep: Reuse 'ws' npm package — already a dep",
+          "raw": {
+            "question": "Reuse 'ws' npm package — already a dep",
+            "chosen": "Reuse 'ws' npm package — already a dep",
+            "alternatives": [],
+            "reasoning": "The SDK already uses 'ws' v8.18.3 for the broker WebSocket transport. No new deps needed."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1779069934149,
+          "type": "decision",
+          "content": "DI-style command module with onSignal-based teardown: DI-style command module with onSignal-based teardown",
+          "raw": {
+            "question": "DI-style command module with onSignal-based teardown",
+            "chosen": "DI-style command module with onSignal-based teardown",
+            "alternatives": [],
+            "reasoning": "Matches the project's testing.md convention; ExitSignal pattern lets us cleanly drive SIGINT in tests without actually exiting."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1779069934808,
+          "type": "decision",
+          "content": "Pure-function chunk filter (extractMatchingChunk) exported separately: Pure-function chunk filter (extractMatchingChunk) exported separately",
+          "raw": {
+            "question": "Pure-function chunk filter (extractMatchingChunk) exported separately",
+            "chosen": "Pure-function chunk filter (extractMatchingChunk) exported separately",
+            "alternatives": [],
+            "reasoning": "Allows unit-testing the worker_stream filter without standing up a WebSocket or any I/O."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1779069935286,
+          "type": "decision",
+          "content": "Skip fresh-attach snapshot rendering: Skip fresh-attach snapshot rendering",
+          "raw": {
+            "question": "Skip fresh-attach snapshot rendering",
+            "chosen": "Skip fresh-attach snapshot rendering",
+            "alternatives": [],
+            "reasoning": "Issue says nice-to-have; ship in follow-up. dump-pty already covers the use case manually."
+          },
+          "significance": "high"
+        }
+      ]
+    }
+  ],
+  "retrospective": {
+    "summary": "Added agent-relay view <name> read-only PTY stream CLI. WS-based with worker_stream filter, ANSI preserved, Ctrl+C clean exit. 24 unit tests. Reused 'ws' SDK dep.",
+    "approach": "Standard approach",
+    "confidence": 0.85
+  },
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/will/Projects/AgentWorkforce/relay/.claude/worktrees/agent-a65b9343cd7dbadb3",
+  "tags": [],
+  "_trace": {
+    "startRef": "5fc8a131561feedfe990fc265f224101f6f267c4",
+    "endRef": "5fc8a131561feedfe990fc265f224101f6f267c4"
+  }
+}

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

@@ -0,0 +1,52 @@
+# Trajectory: Implement agent-relay view <name> read-only stream client (#864 sub-1)
+
+> **Status:** ✅ Completed
+> **Task:** ENG-864
+> **Confidence:** 85%
+> **Started:** May 17, 2026 at 10:02 PM
+> **Completed:** May 17, 2026 at 10:05 PM
+
+---
+
+## Summary
+
+Added agent-relay view <name> read-only PTY stream CLI. WS-based with worker_stream filter, ANSI preserved, Ctrl+C clean exit. 24 unit tests. Reused 'ws' SDK dep.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Reuse 'ws' npm package — already a dep
+
+- **Chose:** Reuse 'ws' npm package — already a dep
+- **Reasoning:** The SDK already uses 'ws' v8.18.3 for the broker WebSocket transport. No new deps needed.
+
+### DI-style command module with onSignal-based teardown
+
+- **Chose:** DI-style command module with onSignal-based teardown
+- **Reasoning:** Matches the project's testing.md convention; ExitSignal pattern lets us cleanly drive SIGINT in tests without actually exiting.
+
+### Pure-function chunk filter (extractMatchingChunk) exported separately
+
+- **Chose:** Pure-function chunk filter (extractMatchingChunk) exported separately
+- **Reasoning:** Allows unit-testing the worker_stream filter without standing up a WebSocket or any I/O.
+
+### Skip fresh-attach snapshot rendering
+
+- **Chose:** Skip fresh-attach snapshot rendering
+- **Reasoning:** Issue says nice-to-have; ship in follow-up. dump-pty already covers the use case manually.
+
+---
+
+## Chapters
+
+### 1. Work
+
+_Agent: default_
+
+- Reuse 'ws' npm package — already a dep: Reuse 'ws' npm package — already a dep
+- DI-style command module with onSignal-based teardown: DI-style command module with onSignal-based teardown
+- Pure-function chunk filter (extractMatchingChunk) exported separately: Pure-function chunk filter (extractMatchingChunk) exported separately
+- Skip fresh-attach snapshot rendering: Skip fresh-attach snapshot rendering

.trajectories/index.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "lastUpdated": "2026-05-18T02:01:50.133Z",
+  "lastUpdated": "2026-05-18T02:05:41.270Z",
   "trajectories": {
     "traj_9gq96irkj00s": {
       "title": "Update relay to use published relaycast Rust reclaim fix",
@@ -592,6 +592,13 @@
       "completedAt": "2026-05-17T14:33:32.293Z",
       "path": ".trajectories/completed/2026-05/traj_cbmwd07phhm2.json"
     },
+    "traj_ybcrij9wg8m1": {
+      "title": "Implement agent-relay view <name> read-only stream client (#864 sub-1)",
+      "status": "completed",
+      "startedAt": "2026-05-18T02:02:07.524Z",
+      "completedAt": "2026-05-18T02:05:41.120Z",
+      "path": "/Users/will/Projects/AgentWorkforce/relay/.claude/worktrees/agent-a65b9343cd7dbadb3/.trajectories/completed/2026-05/traj_ybcrij9wg8m1.json"
+    },
     "traj_piik8r6zu3i7": {
       "title": "Issue 867: RelayEventListener",
       "status": "completed",

src/cli/bootstrap.test.ts

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

src/cli/bootstrap.ts

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