agent-relay 1.2.0 → 1.3.0

package/.trajectories/completed/2026-01/traj_hpungyhoj6v5.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_hpungyhoj6v5",
+  "version": 1,
+  "task": {
+    "title": "Fix tmux-wrapper.ts spawn CLI optional",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-453"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T15:47:17.137Z",
+  "agents": [
+    {
+      "name": "Investigator",
+      "role": "lead",
+      "joinedAt": "2026-01-03T15:47:17.139Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_83317qieq1jj",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T15:49:40.607Z",
+      "events": [
+        {
+          "ts": 1767455380608,
+          "type": "decision",
+          "content": "Applied same fix pattern as pty-wrapper.ts: Applied same fix pattern as pty-wrapper.ts",
+          "raw": {
+            "question": "Applied same fix pattern as pty-wrapper.ts",
+            "chosen": "Applied same fix pattern as pty-wrapper.ts",
+            "alternatives": [],
+            "reasoning": "Made CLI optional in both fenced and single-line spawn regex patterns, defaulting to 'claude' when not specified"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T15:50:12.155Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T15:50:12.155Z",
+  "retrospective": {
+    "summary": "Fixed tmux-wrapper.ts spawn commands to make CLI optional, defaulting to claude. Applied same pattern as pty-wrapper.ts.",
+    "approach": "Standard approach",
+    "confidence": 0.95
+  }
+}

package/.trajectories/completed/2026-01/traj_hpungyhoj6v5.md

@@ -0,0 +1,32 @@
+# Trajectory: Fix tmux-wrapper.ts spawn CLI optional
+
+> **Status:** ✅ Completed
+> **Task:** agent-relay-453
+> **Confidence:** 95%
+> **Started:** January 3, 2026 at 04:47 PM
+> **Completed:** January 3, 2026 at 04:50 PM
+
+---
+
+## Summary
+
+Fixed tmux-wrapper.ts spawn commands to make CLI optional, defaulting to claude. Applied same pattern as pty-wrapper.ts.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Applied same fix pattern as pty-wrapper.ts
+- **Chose:** Applied same fix pattern as pty-wrapper.ts
+- **Reasoning:** Made CLI optional in both fenced and single-line spawn regex patterns, defaulting to 'claude' when not specified
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Applied same fix pattern as pty-wrapper.ts: Applied same fix pattern as pty-wrapper.ts

package/.trajectories/completed/2026-01/traj_lq450ly148uw.json

@@ -0,0 +1,49 @@
+{
+  "id": "traj_lq450ly148uw",
+  "version": 1,
+  "task": {
+    "title": "Dashboard UI fixes, billing improvements, and settings alignment"
+  },
+  "status": "completed",
+  "startedAt": "2026-01-07T10:07:46.226Z",
+  "agents": [
+    {
+      "name": "default",
+      "role": "lead",
+      "joinedAt": "2026-01-07T10:07:57.932Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_pfmti13b184h",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-07T10:07:57.932Z",
+      "events": [
+        {
+          "ts": 1767780477933,
+          "type": "decision",
+          "content": "Fixed Docker build - copy only specific docs snippet files: Fixed Docker build - copy only specific docs snippet files",
+          "raw": {
+            "question": "Fixed Docker build - copy only specific docs snippet files",
+            "chosen": "Fixed Docker build - copy only specific docs snippet files",
+            "alternatives": [],
+            "reasoning": ".dockerignore excluded docs/ but Dockerfile needed relay snippets. Selective copy cleaner than broad .dockerignore change"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-07T10:07:58.979Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-07T10:07:58.979Z",
+  "retrospective": {
+    "summary": "Previous session work",
+    "approach": "Standard approach",
+    "confidence": 0.5
+  }
+}

package/.trajectories/completed/2026-01/traj_lq450ly148uw.md

@@ -0,0 +1,31 @@
+# Trajectory: Dashboard UI fixes, billing improvements, and settings alignment
+
+> **Status:** ✅ Completed
+> **Confidence:** 50%
+> **Started:** January 7, 2026 at 11:07 AM
+> **Completed:** January 7, 2026 at 11:07 AM
+
+---
+
+## Summary
+
+Previous session work
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Fixed Docker build - copy only specific docs snippet files
+- **Chose:** Fixed Docker build - copy only specific docs snippet files
+- **Reasoning:** .dockerignore excluded docs/ but Dockerfile needed relay snippets. Selective copy cleaner than broad .dockerignore change
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Fixed Docker build - copy only specific docs snippet files: Fixed Docker build - copy only specific docs snippet files

package/.trajectories/completed/2026-01/traj_m2xkjv0w2sq7.json

@@ -0,0 +1,25 @@
+{
+  "id": "traj_m2xkjv0w2sq7",
+  "version": 1,
+  "task": {
+    "title": "Review GitHub OAuth login logic",
+    "source": {
+      "system": "plain",
+      "id": "github-oauth-review"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T12:06:12.855Z",
+  "agents": [],
+  "chapters": [],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T12:06:18.137Z",
+  "retrospective": {
+    "summary": "Implemented HookEmitter with async handlers, stop propagation, config loading; added tests",
+    "approach": "Standard approach",
+    "confidence": 0.88
+  }
+}

package/.trajectories/completed/2026-01/traj_m2xkjv0w2sq7.md

@@ -0,0 +1,15 @@
+# Trajectory: Review GitHub OAuth login logic
+
+> **Status:** ✅ Completed
+> **Task:** github-oauth-review
+> **Confidence:** 88%
+> **Started:** January 3, 2026 at 01:06 PM
+> **Completed:** January 3, 2026 at 01:06 PM
+
+---
+
+## Summary
+
+Implemented HookEmitter with async handlers, stop propagation, config loading; added tests
+
+**Approach:** Standard approach

package/.trajectories/completed/2026-01/traj_multi_server_arch.md

@@ -0,0 +1,101 @@
+# Trajectory: Multi-server architecture document
+
+> **Status:** Completed
+> **Task:** PR-8-update
+> **Started:** January 7, 2026 at 06:00 AM
+> **Completed:** January 7, 2026 at 06:30 AM
+> **Confidence:** 0.9
+
+---
+
+## Summary
+
+Created comprehensive multi-server architecture document that supersedes PR #8's federation proposal with realistic current state analysis, detailed implementation roadmap, and agent-actionable specifications.
+
+---
+
+## Key Decisions
+
+### 1. Cloud as authoritative registry vs quorum consensus
+- **Reasoning:** Simpler than Lamport timestamps/quorum, leverages existing PostgreSQL with atomic INSERT ON CONFLICT
+
+### 2. API keys + TLS vs Ed25519 per-message signing
+- **Reasoning:** Simpler to implement, adequate security for initial deployment, can add per-message signing in v2
+
+### 3. Hybrid topology (Hub discovery + P2P messaging)
+- **Reasoning:** Best of both worlds - hub provides registry sync, P2P provides low latency, hub failure doesn't break existing P2P connections
+
+### 4. Organization-centric model vs user-centric
+- **Reasoning:** Enables team billing ($49/user/month) while maintaining backwards compatibility
+
+---
+
+## Learnings
+
+1. **PR #8 over-engineered some aspects** - Cloud-mediated routing works fine for current scale, P2P is the real gap
+
+2. **Cloud as source of truth eliminates consensus complexity** - No need for Lamport timestamps when you have atomic DB operations
+
+3. **E2E delivery confirmation via capture-pane** is critical - Peer ACKs alone don't confirm agent received message
+
+4. **Bounded queues with drop policies** prevent OOM from slow peers
+
+5. **Hybrid topology is the sweet spot** - Hub for discovery, P2P for messaging, cloud as fallback
+
+---
+
+## Chapters
+
+### 1. Research
+*Agent: default*
+
+- Explored codebase to document what's actually built today
+- Identified CloudSyncService, MultiProjectClient, project groups as existing cross-server capabilities
+- Documented current limitations: cloud-mediated routing (~100-300ms), no P2P, user-centric billing
+
+### 2. Gap Analysis
+*Agent: default*
+
+- Compared PR #8's proposals vs current implementation
+- Identified P2P as main real gap (other proposals over-engineered)
+- Listed 6 gaps with effort estimates totaling 9 weeks
+
+### 3. PR #8 Integration
+*Agent: default*
+
+- Reviewed FEDERATION_PROPOSAL.md and FEDERATION_PROPOSAL_REVIEW.md from PR #8
+- Adopted critical insights: E2E delivery confirmation, message deduplication, backpressure
+- Preserved protocol specification (PEER_HELLO, PEER_ROUTE, etc.)
+
+### 4. Agent Implementation Guide
+*Agent: default*
+
+- Added Section 8 with directly actionable specifications
+- Provided file paths to create/modify for each phase
+- Included complete code examples (database migrations, service classes)
+- Documented edge cases with resolution code
+
+---
+
+## Edge Cases Handled
+
+| Edge Case | Resolution |
+|-----------|------------|
+| User leaves org | Workspaces suspended with 30-day grace period |
+| Org owner tries to leave | Must promote admin first, auto-promote if available |
+| Org deleted | Cascade: cancel Stripe, deregister agents, suspend workspaces, soft delete |
+| Agent name collision | Return helpful error with suggested alternative name |
+| Daemon disconnects | Mark all its agents offline |
+| Cloud unavailable during P2P discovery | Fall back to cached peer list, then cloud-only routing |
+| Both peers connect simultaneously | Deterministic winner by daemon ID comparison |
+| Message in flight when connection drops | Re-queue for P2P retry or cloud fallback |
+
+---
+
+## Files Changed
+
+- `docs/MULTI_SERVER_ARCHITECTURE.md` - Created (1200+ lines)
+
+---
+
+*Trajectory completed 2026-01-07*

package/.trajectories/completed/2026-01/traj_noq5zbvnrdvz.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_noq5zbvnrdvz",
+  "version": 1,
+  "task": {
+    "title": "Improve trajectory viewer design",
+    "source": {
+      "system": "plain",
+      "id": "dashboard-ui"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T13:58:14.470Z",
+  "agents": [
+    {
+      "name": "Lead",
+      "role": "lead",
+      "joinedAt": "2026-01-03T13:58:14.471Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_lklqclk0nh4u",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T13:58:34.470Z",
+      "events": [
+        {
+          "ts": 1767448714471,
+          "type": "decision",
+          "content": "Redesigning trajectory viewer with distinctive aesthetic: Redesigning trajectory viewer with distinctive aesthetic",
+          "raw": {
+            "question": "Redesigning trajectory viewer with distinctive aesthetic",
+            "chosen": "Redesigning trajectory viewer with distinctive aesthetic",
+            "alternatives": [],
+            "reasoning": "Following frontend design skill - choosing a refined, futuristic aesthetic with timeline visualization"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T14:01:47.410Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T14:01:47.410Z",
+  "retrospective": {
+    "summary": "Redesigned trajectory viewer with futuristic aesthetic, centered modal placement, and unique header icon",
+    "approach": "Standard approach",
+    "confidence": 0.85
+  }
+}

package/.trajectories/completed/2026-01/traj_noq5zbvnrdvz.md

@@ -0,0 +1,32 @@
+# Trajectory: Improve trajectory viewer design
+
+> **Status:** ✅ Completed
+> **Task:** dashboard-ui
+> **Confidence:** 85%
+> **Started:** January 3, 2026 at 02:58 PM
+> **Completed:** January 3, 2026 at 03:01 PM
+
+---
+
+## Summary
+
+Redesigned trajectory viewer with futuristic aesthetic, centered modal placement, and unique header icon
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Redesigning trajectory viewer with distinctive aesthetic
+- **Chose:** Redesigning trajectory viewer with distinctive aesthetic
+- **Reasoning:** Following frontend design skill - choosing a refined, futuristic aesthetic with timeline visualization
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Redesigning trajectory viewer with distinctive aesthetic: Redesigning trajectory viewer with distinctive aesthetic

package/.trajectories/completed/2026-01/traj_ntbs6ppopf46.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_ntbs6ppopf46",
+  "version": 1,
+  "task": {
+    "title": "Re-review backend fixes",
+    "source": {
+      "system": "plain",
+      "id": "backend-rereview"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T14:42:57.213Z",
+  "agents": [
+    {
+      "name": "CodeReviewer",
+      "role": "lead",
+      "joinedAt": "2026-01-03T14:42:57.214Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_qstje9ozbhc0",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T14:43:11.143Z",
+      "events": [
+        {
+          "ts": 1767451391144,
+          "type": "decision",
+          "content": "Re-review backend fixes resolved: Re-review backend fixes resolved",
+          "raw": {
+            "question": "Re-review backend fixes resolved",
+            "chosen": "Re-review backend fixes resolved",
+            "alternatives": [],
+            "reasoning": "startTrajectory no longer passes --json and regex parses ID; mapEventStatus now maps active->running and abandoned->error"
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T14:43:14.756Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T14:43:14.756Z",
+  "retrospective": {
+    "summary": "Re-reviewed backend fixes: confirmed startTrajectory removes --json and parses ID; mapEventStatus maps active->running and abandoned->error",
+    "approach": "Standard approach",
+    "confidence": 0.92
+  }
+}

package/.trajectories/completed/2026-01/traj_ntbs6ppopf46.md

@@ -0,0 +1,32 @@
+# Trajectory: Re-review backend fixes
+
+> **Status:** ✅ Completed
+> **Task:** backend-rereview
+> **Confidence:** 92%
+> **Started:** January 3, 2026 at 03:42 PM
+> **Completed:** January 3, 2026 at 03:43 PM
+
+---
+
+## Summary
+
+Re-reviewed backend fixes: confirmed startTrajectory removes --json and parses ID; mapEventStatus maps active->running and abandoned->error
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Re-review backend fixes resolved
+- **Chose:** Re-review backend fixes resolved
+- **Reasoning:** startTrajectory no longer passes --json and regex parses ID; mapEventStatus now maps active->running and abandoned->error
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Re-review backend fixes resolved: Re-review backend fixes resolved

package/.trajectories/completed/2026-01/traj_ozd98si6a7ns.json

@@ -0,0 +1,48 @@
+{
+  "id": "traj_ozd98si6a7ns",
+  "version": 1,
+  "task": {
+    "title": "Fix thinking indicator showing on all messages",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-406"
+    }
+  },
+  "status": "abandoned",
+  "startedAt": "2026-01-02T10:19:46.895Z",
+  "agents": [],
+  "chapters": [
+    {
+      "id": "chap_gx5gejuu2xep",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-02T10:20:15.127Z",
+      "events": [
+        {
+          "ts": 1767349215128,
+          "type": "decision",
+          "content": "Track latest message per recipient in a Map and only pass processingState for that message: Track latest message per recipient in a Map and only pass processingState for that message",
+          "raw": {
+            "question": "Track latest message per recipient in a Map and only pass processingState for that message",
+            "chosen": "Track latest message per recipient in a Map and only pass processingState for that message",
+            "alternatives": [],
+            "reasoning": "The bug was that thinking indicator showed on ALL messages from user to a processing agent. Fix tracks the latest message ID per recipient and only shows indicator on that one."
+          },
+          "significance": "high"
+        },
+        {
+          "ts": 1767349348822,
+          "type": "note",
+          "content": "Abandoned: Switching to new task: optimistic delivery",
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-02T10:22:28.822Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-02T10:22:28.822Z"
+}

package/.trajectories/completed/2026-01/traj_ozd98si6a7ns.md

@@ -0,0 +1,24 @@
+# Trajectory: Fix thinking indicator showing on all messages
+
+> **Status:** ❌ Abandoned
+> **Task:** agent-relay-406
+> **Started:** January 2, 2026 at 11:19 AM
+> **Completed:** January 2, 2026 at 11:22 AM
+
+---
+
+## Key Decisions
+
+### Track latest message per recipient in a Map and only pass processingState for that message
+- **Chose:** Track latest message per recipient in a Map and only pass processingState for that message
+- **Reasoning:** The bug was that thinking indicator showed on ALL messages from user to a processing agent. Fix tracks the latest message ID per recipient and only shows indicator on that one.
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Track latest message per recipient in a Map and only pass processingState for that message: Track latest message per recipient in a Map and only pass processingState for that message
+- Abandoned: Switching to new task: optimistic delivery

package/.trajectories/completed/2026-01/traj_prdza7a5cxp5.json

@@ -0,0 +1,53 @@
+{
+  "id": "traj_prdza7a5cxp5",
+  "version": 1,
+  "task": {
+    "title": "Fix notification filtering to use dynamic user",
+    "source": {
+      "system": "plain",
+      "id": "agent-relay-319"
+    }
+  },
+  "status": "completed",
+  "startedAt": "2026-01-03T15:51:54.280Z",
+  "agents": [
+    {
+      "name": "UIFixer",
+      "role": "lead",
+      "joinedAt": "2026-01-03T15:51:54.281Z"
+    }
+  ],
+  "chapters": [
+    {
+      "id": "chap_4obkwzzt0c75",
+      "title": "Work",
+      "agentName": "default",
+      "startedAt": "2026-01-03T15:54:40.502Z",
+      "events": [
+        {
+          "ts": 1767455680503,
+          "type": "decision",
+          "content": "Used effectiveSenderName variable for consistent user identity: Used effectiveSenderName variable for consistent user identity",
+          "raw": {
+            "question": "Used effectiveSenderName variable for consistent user identity",
+            "chosen": "Used effectiveSenderName variable for consistent user identity",
+            "alternatives": [],
+            "reasoning": "Created a single source of truth for the current user name, used in both unread count filtering and optimistic messages. Falls back to 'Dashboard' when senderName prop is not provided (local mode)."
+          },
+          "significance": "high"
+        }
+      ],
+      "endedAt": "2026-01-03T15:55:06.279Z"
+    }
+  ],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-03T15:55:06.279Z",
+  "retrospective": {
+    "summary": "Fixed notification filtering to use dynamic current user. Created effectiveSenderName variable that uses senderName prop (authenticated user) with fallback to 'Dashboard' for local mode.",
+    "approach": "Standard approach",
+    "confidence": 0.9
+  }
+}

package/.trajectories/completed/2026-01/traj_prdza7a5cxp5.md

@@ -0,0 +1,32 @@
+# Trajectory: Fix notification filtering to use dynamic user
+
+> **Status:** ✅ Completed
+> **Task:** agent-relay-319
+> **Confidence:** 90%
+> **Started:** January 3, 2026 at 04:51 PM
+> **Completed:** January 3, 2026 at 04:55 PM
+
+---
+
+## Summary
+
+Fixed notification filtering to use dynamic current user. Created effectiveSenderName variable that uses senderName prop (authenticated user) with fallback to 'Dashboard' for local mode.
+
+**Approach:** Standard approach
+
+---
+
+## Key Decisions
+
+### Used effectiveSenderName variable for consistent user identity
+- **Chose:** Used effectiveSenderName variable for consistent user identity
+- **Reasoning:** Created a single source of truth for the current user name, used in both unread count filtering and optimistic messages. Falls back to 'Dashboard' when senderName prop is not provided (local mode).
+
+---
+
+## Chapters
+
+### 1. Work
+*Agent: default*
+
+- Used effectiveSenderName variable for consistent user identity: Used effectiveSenderName variable for consistent user identity

package/.trajectories/completed/2026-01/traj_psd9ob0j2ru3.json

@@ -0,0 +1,27 @@
+{
+  "id": "traj_psd9ob0j2ru3",
+  "version": 1,
+  "task": {
+    "title": "Clarify codex rule file location and spawn behavior"
+  },
+  "status": "completed",
+  "startedAt": "2026-01-07T12:37:16.374Z",
+  "agents": [
+    {
+      "name": "khaliqgant",
+      "role": "lead",
+      "joinedAt": "2026-01-07T12:37:16.389Z"
+    }
+  ],
+  "chapters": [],
+  "commits": [],
+  "filesChanged": [],
+  "projectId": "/Users/khaliqgant/Projects/agent-workforce/relay",
+  "tags": [],
+  "completedAt": "2026-01-07T12:40:48.197Z",
+  "retrospective": {
+    "summary": "Clarified codex config location and upgrade cause",
+    "approach": "Standard approach",
+    "confidence": 0.68
+  }
+}