refactor: remove bd mail commands - mail moves to Gas Town

Mail is orchestration, not data plane. The bd mail commands were just
sugar over bd create/list/show with type=message. Gas Town (gt) now
owns mail routing and delivery.

Removed:
- cmd/bd/mail.go - all mail subcommands (send, inbox, read, ack, reply)
- cmd/bd/mail_test.go - mail command tests
- docs/messaging.md - dedicated mail documentation
- EventMessage hook - no longer triggered

Kept (data plane):
- type=message as valid issue type
- Sender, Ephemeral fields on issues
- replies_to dependency type for threading

Coordination: gt-9xg implements native mail in Gas Town.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-20 17:56:46 -08:00
parent 79191bf7d1
commit 4fa0866fcf
8 changed files with 31 additions and 1447 deletions

View File

@@ -9,7 +9,8 @@ Beads supports several types of links between issues to create a knowledge graph
Creates message threads, similar to email or chat conversations.
**Created by:**
- `bd mail reply <id>` command
- `gt mail reply <id>` command (Gas Town handles messaging)
- `bd dep add <new-id> <original-id> --type replies_to` (manual linking)
**Use cases:**
- Agent-to-agent message threads
@@ -19,19 +20,19 @@ Creates message threads, similar to email or chat conversations.
**Example:**
```bash
# Original message
bd mail send worker-1 -s "Review needed" -m "Please review bd-xyz"
# Creates: bd-a1b2
# Original message (via Gas Town)
gt mail send gastown/worker -s "Review needed" -m "Please review gt-xyz"
# Creates: gt-a1b2
# Reply (automatically sets replies_to: bd-a1b2)
bd mail reply bd-a1b2 -m "Done! Approved with minor comments."
# Creates: bd-c3d4 with replies_to: bd-a1b2
# Reply (automatically sets replies_to)
gt mail reply gt-a1b2 -m "Done! Approved with minor comments."
# Creates: gt-c3d4 with replies_to: gt-a1b2
```
**Viewing threads:**
```bash
bd show bd-a1b2 --thread
bd show gt-a1b2 --thread
```
### relates_to - Loose Associations
@@ -255,12 +256,12 @@ bd supersede bd-rfc2 --with bd-rfc3
### Message Threading
Build conversation chains:
Build conversation chains (via Gas Town):
```bash
bd mail send dev -s "Question" -m "How does X work?"
bd mail reply bd-q1 -m "X works by..."
bd mail reply bd-q1.reply -m "Thanks!"
gt mail send gastown/dev -s "Question" -m "How does X work?"
gt mail reply gt-q1 -m "X works by..."
gt mail reply gt-q1.reply -m "Thanks!"
```
## Best Practices