package cmd import ( "bytes" "crypto/rand" "encoding/base32" "encoding/json" "fmt" "os" "os/exec" "path/filepath" "strconv" "strings" "time" tea "github.com/charmbracelet/bubbletea" "github.com/spf13/cobra" "github.com/steveyegge/gastown/internal/style" "github.com/steveyegge/gastown/internal/tui/convoy" "github.com/steveyegge/gastown/internal/workspace" ) // generateShortID generates a short random ID (5 lowercase chars). func generateShortID() string { b := make([]byte, 3) rand.Read(b) return strings.ToLower(base32.StdEncoding.EncodeToString(b)[:5]) } // looksLikeIssueID checks if a string looks like a beads issue ID. // Issue IDs have the format: prefix-id (e.g., gt-abc, bd-xyz, hq-123). func looksLikeIssueID(s string) bool { // Common beads prefixes prefixes := []string{"gt-", "bd-", "hq-"} for _, prefix := range prefixes { if strings.HasPrefix(s, prefix) { return true } } // Also check for pattern: 2-3 lowercase letters followed by hyphen // This catches custom prefixes defined in routes.jsonl if len(s) >= 4 && s[2] == '-' || (len(s) >= 5 && s[3] == '-') { hyphenIdx := strings.Index(s, "-") if hyphenIdx >= 2 && hyphenIdx <= 3 { prefix := s[:hyphenIdx] // Check if prefix is all lowercase letters allLower := true for _, c := range prefix { if c < 'a' || c > 'z' { allLower = false break } } return allLower } } return false } // Convoy command flags var ( convoyMolecule string convoyNotify string convoyStatusJSON bool convoyListJSON bool convoyListStatus string convoyListAll bool convoyListTree bool convoyInteractive bool ) var convoyCmd = &cobra.Command{ Use: "convoy", GroupID: GroupWork, Short: "Track batches of work across rigs", RunE: func(cmd *cobra.Command, args []string) error { if convoyInteractive { return runConvoyTUI() } return requireSubcommand(cmd, args) }, Long: `Manage convoys - the primary unit for tracking batched work. A convoy is a persistent tracking unit that monitors related issues across rigs. When you kick off work (even a single issue), a convoy tracks it so you can see when it lands and what was included. WHAT IS A CONVOY: - Persistent tracking unit with an ID (hq-*) - Tracks issues across rigs (frontend+backend, beads+gastown, etc.) - Auto-closes when all tracked issues complete → notifies subscribers - Can be reopened by adding more issues WHAT IS A SWARM: - Ephemeral: "the workers currently assigned to a convoy's issues" - No separate ID - uses the convoy ID - Dissolves when work completes TRACKING SEMANTICS: - 'tracks' relation is non-blocking (tracked issues don't block convoy) - Cross-prefix capable (convoy in hq-* tracks issues in gt-*, bd-*) - Landed: all tracked issues closed → notification sent to subscribers COMMANDS: create Create a convoy tracking specified issues add Add issues to an existing convoy (reopens if closed) status Show convoy progress, tracked issues, and active workers list List convoys (the dashboard view)`, } var convoyCreateCmd = &cobra.Command{ Use: "create [issues...]", Short: "Create a new convoy", Long: `Create a new convoy that tracks the specified issues. The convoy is created in town-level beads (hq-* prefix) and can track issues across any rig. Examples: gt convoy create "Deploy v2.0" gt-abc bd-xyz gt convoy create "Release prep" gt-abc --notify # defaults to mayor/ gt convoy create "Release prep" gt-abc --notify ops/ # notify ops/ gt convoy create "Feature rollout" gt-a gt-b gt-c --molecule mol-release`, Args: cobra.MinimumNArgs(1), RunE: runConvoyCreate, } var convoyStatusCmd = &cobra.Command{ Use: "status [convoy-id]", Short: "Show convoy status", Long: `Show detailed status for a convoy. Displays convoy metadata, tracked issues, and completion progress. Without an ID, shows status of all active convoys.`, Args: cobra.MaximumNArgs(1), RunE: runConvoyStatus, } var convoyListCmd = &cobra.Command{ Use: "list", Short: "List convoys", Long: `List convoys, showing open convoys by default. Examples: gt convoy list # Open convoys only (default) gt convoy list --all # All convoys (open + closed) gt convoy list --status=closed # Recently landed gt convoy list --tree # Show convoy + child status tree gt convoy list --json`, RunE: runConvoyList, } var convoyAddCmd = &cobra.Command{ Use: "add [issue-id...]", Short: "Add issues to an existing convoy", Long: `Add issues to an existing convoy. If the convoy is closed, it will be automatically reopened. Examples: gt convoy add hq-cv-abc gt-new-issue gt convoy add hq-cv-abc gt-issue1 gt-issue2 gt-issue3`, Args: cobra.MinimumNArgs(2), RunE: runConvoyAdd, } var convoyCheckCmd = &cobra.Command{ Use: "check", Short: "Check and auto-close completed convoys", Long: `Check all open convoys and auto-close any where all tracked issues are complete. This handles cross-rig convoy completion: convoys in town beads tracking issues in rig beads won't auto-close via bd close alone. This command bridges that gap. Can be run manually or by deacon patrol to ensure convoys close promptly.`, RunE: runConvoyCheck, } func init() { // Create flags convoyCreateCmd.Flags().StringVar(&convoyMolecule, "molecule", "", "Associated molecule ID") convoyCreateCmd.Flags().StringVar(&convoyNotify, "notify", "", "Address to notify on completion (default: mayor/ if flag used without value)") convoyCreateCmd.Flags().Lookup("notify").NoOptDefVal = "mayor/" // Status flags convoyStatusCmd.Flags().BoolVar(&convoyStatusJSON, "json", false, "Output as JSON") // List flags convoyListCmd.Flags().BoolVar(&convoyListJSON, "json", false, "Output as JSON") convoyListCmd.Flags().StringVar(&convoyListStatus, "status", "", "Filter by status (open, closed)") convoyListCmd.Flags().BoolVar(&convoyListAll, "all", false, "Show all convoys (open and closed)") convoyListCmd.Flags().BoolVar(&convoyListTree, "tree", false, "Show convoy + child status tree") // Interactive TUI flag (on parent command) convoyCmd.Flags().BoolVarP(&convoyInteractive, "interactive", "i", false, "Interactive tree view") // Add subcommands convoyCmd.AddCommand(convoyCreateCmd) convoyCmd.AddCommand(convoyStatusCmd) convoyCmd.AddCommand(convoyListCmd) convoyCmd.AddCommand(convoyAddCmd) convoyCmd.AddCommand(convoyCheckCmd) rootCmd.AddCommand(convoyCmd) } // getTownBeadsDir returns the path to town-level beads directory. func getTownBeadsDir() (string, error) { townRoot, err := workspace.FindFromCwdOrError() if err != nil { return "", fmt.Errorf("not in a Gas Town workspace: %w", err) } return filepath.Join(townRoot, ".beads"), nil } func runConvoyCreate(cmd *cobra.Command, args []string) error { name := args[0] trackedIssues := args[1:] // If first arg looks like an issue ID (has beads prefix), treat all args as issues // and auto-generate a name from the first issue's title if looksLikeIssueID(name) { trackedIssues = args // All args are issue IDs // Get the first issue's title to use as convoy name if details := getIssueDetails(args[0]); details != nil && details.Title != "" { name = details.Title } else { name = fmt.Sprintf("Tracking %s", args[0]) } } townBeads, err := getTownBeadsDir() if err != nil { return err } // Create convoy issue in town beads description := fmt.Sprintf("Convoy tracking %d issues", len(trackedIssues)) if convoyNotify != "" { description += fmt.Sprintf("\nNotify: %s", convoyNotify) } if convoyMolecule != "" { description += fmt.Sprintf("\nMolecule: %s", convoyMolecule) } // Generate convoy ID with cv- prefix convoyID := fmt.Sprintf("hq-cv-%s", generateShortID()) createArgs := []string{ "create", "--type=convoy", "--id=" + convoyID, "--title=" + name, "--description=" + description, "--json", } createCmd := exec.Command("bd", createArgs...) createCmd.Dir = townBeads var stdout bytes.Buffer var stderr bytes.Buffer createCmd.Stdout = &stdout createCmd.Stderr = &stderr if err := createCmd.Run(); err != nil { return fmt.Errorf("creating convoy: %w (%s)", err, strings.TrimSpace(stderr.String())) } // Notify address is stored in description (line 166-168) and read from there // Add 'tracks' relations for each tracked issue trackedCount := 0 for _, issueID := range trackedIssues { // Use --type=tracks for non-blocking tracking relation depArgs := []string{"dep", "add", convoyID, issueID, "--type=tracks"} depCmd := exec.Command("bd", depArgs...) depCmd.Dir = townBeads if err := depCmd.Run(); err != nil { style.PrintWarning("couldn't track %s: %v", issueID, err) } else { trackedCount++ } } // Output fmt.Printf("%s Created convoy 🚚 %s\n\n", style.Bold.Render("✓"), convoyID) fmt.Printf(" Name: %s\n", name) fmt.Printf(" Tracking: %d issues\n", trackedCount) if len(trackedIssues) > 0 { fmt.Printf(" Issues: %s\n", strings.Join(trackedIssues, ", ")) } if convoyNotify != "" { fmt.Printf(" Notify: %s\n", convoyNotify) } if convoyMolecule != "" { fmt.Printf(" Molecule: %s\n", convoyMolecule) } fmt.Printf("\n %s\n", style.Dim.Render("Convoy auto-closes when all tracked issues complete")) return nil } func runConvoyAdd(cmd *cobra.Command, args []string) error { convoyID := args[0] issuesToAdd := args[1:] townBeads, err := getTownBeadsDir() if err != nil { return err } // Validate convoy exists and get its status showArgs := []string{"show", convoyID, "--json"} showCmd := exec.Command("bd", showArgs...) showCmd.Dir = townBeads var stdout bytes.Buffer showCmd.Stdout = &stdout if err := showCmd.Run(); err != nil { return fmt.Errorf("convoy '%s' not found", convoyID) } var convoys []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` Type string `json:"issue_type"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil { return fmt.Errorf("parsing convoy data: %w", err) } if len(convoys) == 0 { return fmt.Errorf("convoy '%s' not found", convoyID) } convoy := convoys[0] // Verify it's actually a convoy type if convoy.Type != "convoy" { return fmt.Errorf("'%s' is not a convoy (type: %s)", convoyID, convoy.Type) } // If convoy is closed, reopen it reopened := false if convoy.Status == "closed" { reopenArgs := []string{"update", convoyID, "--status=open"} reopenCmd := exec.Command("bd", reopenArgs...) reopenCmd.Dir = townBeads if err := reopenCmd.Run(); err != nil { return fmt.Errorf("couldn't reopen convoy: %w", err) } reopened = true fmt.Printf("%s Reopened convoy %s\n", style.Bold.Render("↺"), convoyID) } // Add 'tracks' relations for each issue addedCount := 0 for _, issueID := range issuesToAdd { depArgs := []string{"dep", "add", convoyID, issueID, "--type=tracks"} depCmd := exec.Command("bd", depArgs...) depCmd.Dir = townBeads if err := depCmd.Run(); err != nil { style.PrintWarning("couldn't add %s: %v", issueID, err) } else { addedCount++ } } // Output if reopened { fmt.Println() } fmt.Printf("%s Added %d issue(s) to convoy 🚚 %s\n", style.Bold.Render("✓"), addedCount, convoyID) if addedCount > 0 { fmt.Printf(" Issues: %s\n", strings.Join(issuesToAdd[:addedCount], ", ")) } return nil } func runConvoyCheck(cmd *cobra.Command, args []string) error { townBeads, err := getTownBeadsDir() if err != nil { return err } closed, err := checkAndCloseCompletedConvoys(townBeads) if err != nil { return err } if len(closed) == 0 { fmt.Println("No convoys ready to close.") } else { fmt.Printf("%s Auto-closed %d convoy(s):\n", style.Bold.Render("✓"), len(closed)) for _, c := range closed { fmt.Printf(" 🚚 %s: %s\n", c.ID, c.Title) } } return nil } // checkAndCloseCompletedConvoys finds open convoys where all tracked issues are closed // and auto-closes them. Returns the list of convoys that were closed. func checkAndCloseCompletedConvoys(townBeads string) ([]struct{ ID, Title string }, error) { var closed []struct{ ID, Title string } // List all open convoys listArgs := []string{"list", "--type=convoy", "--status=open", "--json"} listCmd := exec.Command("bd", listArgs...) listCmd.Dir = townBeads var stdout bytes.Buffer listCmd.Stdout = &stdout if err := listCmd.Run(); err != nil { return nil, fmt.Errorf("listing convoys: %w", err) } var convoys []struct { ID string `json:"id"` Title string `json:"title"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil { return nil, fmt.Errorf("parsing convoy list: %w", err) } // Check each convoy for _, convoy := range convoys { tracked := getTrackedIssues(townBeads, convoy.ID) if len(tracked) == 0 { continue // No tracked issues, nothing to check } // Check if all tracked issues are closed allClosed := true for _, t := range tracked { if t.Status != "closed" && t.Status != "tombstone" { allClosed = false break } } if allClosed { // Close the convoy closeArgs := []string{"close", convoy.ID, "-r", "All tracked issues completed"} closeCmd := exec.Command("bd", closeArgs...) closeCmd.Dir = townBeads if err := closeCmd.Run(); err != nil { style.PrintWarning("couldn't close convoy %s: %v", convoy.ID, err) continue } closed = append(closed, struct{ ID, Title string }{convoy.ID, convoy.Title}) // Check if convoy has notify address and send notification notifyConvoyCompletion(townBeads, convoy.ID, convoy.Title) } } return closed, nil } // notifyConvoyCompletion sends a notification if the convoy has a notify address. func notifyConvoyCompletion(townBeads, convoyID, title string) { // Get convoy description to find notify address showArgs := []string{"show", convoyID, "--json"} showCmd := exec.Command("bd", showArgs...) showCmd.Dir = townBeads var stdout bytes.Buffer showCmd.Stdout = &stdout if err := showCmd.Run(); err != nil { return } var convoys []struct { Description string `json:"description"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil || len(convoys) == 0 { return } // Parse notify address from description desc := convoys[0].Description for _, line := range strings.Split(desc, "\n") { if strings.HasPrefix(line, "Notify: ") { addr := strings.TrimPrefix(line, "Notify: ") if addr != "" { // Send notification via gt mail mailArgs := []string{"mail", "send", addr, "-s", fmt.Sprintf("🚚 Convoy landed: %s", title), "-m", fmt.Sprintf("Convoy %s has completed.\n\nAll tracked issues are now closed.", convoyID)} mailCmd := exec.Command("gt", mailArgs...) _ = mailCmd.Run() // Best effort, ignore errors } break } } } func runConvoyStatus(cmd *cobra.Command, args []string) error { townBeads, err := getTownBeadsDir() if err != nil { return err } // If no ID provided, show all active convoys if len(args) == 0 { return showAllConvoyStatus(townBeads) } convoyID := args[0] // Check if it's a numeric shortcut (e.g., "1" instead of "hq-cv-xyz") if n, err := strconv.Atoi(convoyID); err == nil && n > 0 { resolved, err := resolveConvoyNumber(townBeads, n) if err != nil { return err } convoyID = resolved } // Get convoy details showArgs := []string{"show", convoyID, "--json"} showCmd := exec.Command("bd", showArgs...) showCmd.Dir = townBeads var stdout bytes.Buffer showCmd.Stdout = &stdout if err := showCmd.Run(); err != nil { return fmt.Errorf("convoy '%s' not found", convoyID) } // Parse convoy data var convoys []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` Description string `json:"description"` CreatedAt string `json:"created_at"` ClosedAt string `json:"closed_at,omitempty"` DependsOn []string `json:"depends_on,omitempty"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil { return fmt.Errorf("parsing convoy data: %w", err) } if len(convoys) == 0 { return fmt.Errorf("convoy '%s' not found", convoyID) } convoy := convoys[0] // Get tracked issues by querying SQLite directly // (bd dep list doesn't properly show cross-rig external dependencies) type trackedIssue struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` Type string `json:"dependency_type"` IssueType string `json:"issue_type"` } tracked := getTrackedIssues(townBeads, convoyID) // Count completed completed := 0 for _, t := range tracked { if t.Status == "closed" { completed++ } } if convoyStatusJSON { type jsonStatus struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` Tracked []trackedIssueInfo `json:"tracked"` Completed int `json:"completed"` Total int `json:"total"` } out := jsonStatus{ ID: convoy.ID, Title: convoy.Title, Status: convoy.Status, Tracked: tracked, Completed: completed, Total: len(tracked), } enc := json.NewEncoder(os.Stdout) enc.SetIndent("", " ") return enc.Encode(out) } // Human-readable output fmt.Printf("🚚 %s %s\n\n", style.Bold.Render(convoy.ID+":"), convoy.Title) fmt.Printf(" Status: %s\n", formatConvoyStatus(convoy.Status)) fmt.Printf(" Progress: %d/%d completed\n", completed, len(tracked)) fmt.Printf(" Created: %s\n", convoy.CreatedAt) if convoy.ClosedAt != "" { fmt.Printf(" Closed: %s\n", convoy.ClosedAt) } if len(tracked) > 0 { fmt.Printf("\n %s\n", style.Bold.Render("Tracked Issues:")) for _, t := range tracked { // Status symbol: ✓ closed, ▶ in_progress/hooked, ○ other status := "○" switch t.Status { case "closed": status = "✓" case "in_progress", "hooked": status = "▶" } // Show assignee in brackets (extract short name from path like gastown/polecats/goose -> goose) bracketContent := t.IssueType if t.Assignee != "" { parts := strings.Split(t.Assignee, "/") bracketContent = parts[len(parts)-1] // Last part of path } else if bracketContent == "" { bracketContent = "unassigned" } line := fmt.Sprintf(" %s %s: %s [%s]", status, t.ID, t.Title, bracketContent) if t.Worker != "" { workerDisplay := "@" + t.Worker if t.WorkerAge != "" { workerDisplay += fmt.Sprintf(" (%s)", t.WorkerAge) } line += fmt.Sprintf(" %s", style.Dim.Render(workerDisplay)) } fmt.Println(line) } } return nil } func showAllConvoyStatus(townBeads string) error { // List all convoy-type issues listArgs := []string{"list", "--type=convoy", "--status=open", "--json"} listCmd := exec.Command("bd", listArgs...) listCmd.Dir = townBeads var stdout bytes.Buffer listCmd.Stdout = &stdout if err := listCmd.Run(); err != nil { return fmt.Errorf("listing convoys: %w", err) } var convoys []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil { return fmt.Errorf("parsing convoy list: %w", err) } if len(convoys) == 0 { fmt.Println("No active convoys.") fmt.Println("Create a convoy with: gt convoy create [issues...]") return nil } if convoyStatusJSON { enc := json.NewEncoder(os.Stdout) enc.SetIndent("", " ") return enc.Encode(convoys) } fmt.Printf("%s\n\n", style.Bold.Render("Active Convoys")) for _, c := range convoys { fmt.Printf(" 🚚 %s: %s\n", c.ID, c.Title) } fmt.Printf("\nUse 'gt convoy status ' for detailed status.\n") return nil } func runConvoyList(cmd *cobra.Command, args []string) error { townBeads, err := getTownBeadsDir() if err != nil { return err } // List convoy-type issues listArgs := []string{"list", "--type=convoy", "--json"} if convoyListStatus != "" { listArgs = append(listArgs, "--status="+convoyListStatus) } else if convoyListAll { listArgs = append(listArgs, "--all") } // Default (no flags) = open only (bd's default behavior) listCmd := exec.Command("bd", listArgs...) listCmd.Dir = townBeads var stdout bytes.Buffer listCmd.Stdout = &stdout if err := listCmd.Run(); err != nil { return fmt.Errorf("listing convoys: %w", err) } var convoys []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` CreatedAt string `json:"created_at"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil { return fmt.Errorf("parsing convoy list: %w", err) } if convoyListJSON { enc := json.NewEncoder(os.Stdout) enc.SetIndent("", " ") return enc.Encode(convoys) } if len(convoys) == 0 { fmt.Println("No convoys found.") fmt.Println("Create a convoy with: gt convoy create [issues...]") return nil } // Tree view: show convoys with their child issues if convoyListTree { return printConvoyTree(townBeads, convoys) } fmt.Printf("%s\n\n", style.Bold.Render("Convoys")) for i, c := range convoys { status := formatConvoyStatus(c.Status) fmt.Printf(" %d. 🚚 %s: %s %s\n", i+1, c.ID, c.Title, status) } fmt.Printf("\nUse 'gt convoy status ' or 'gt convoy status ' for detailed view.\n") return nil } // printConvoyTree displays convoys with their child issues in a tree format. func printConvoyTree(townBeads string, convoys []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` CreatedAt string `json:"created_at"` }) error { for _, c := range convoys { // Get tracked issues for this convoy tracked := getTrackedIssues(townBeads, c.ID) // Count completed completed := 0 for _, t := range tracked { if t.Status == "closed" { completed++ } } // Print convoy header with progress total := len(tracked) progress := "" if total > 0 { progress = fmt.Sprintf(" (%d/%d)", completed, total) } fmt.Printf("🚚 %s: %s%s\n", c.ID, c.Title, progress) // Print tracked issues as tree children for i, t := range tracked { // Determine tree connector isLast := i == len(tracked)-1 connector := "├──" if isLast { connector = "└──" } // Status symbol: ✓ closed, ▶ in_progress/hooked, ○ other status := "○" switch t.Status { case "closed": status = "✓" case "in_progress", "hooked": status = "▶" } fmt.Printf("%s %s %s: %s\n", connector, status, t.ID, t.Title) } // Add blank line between convoys fmt.Println() } return nil } func formatConvoyStatus(status string) string { switch status { case "open": return style.Warning.Render("●") case "closed": return style.Success.Render("✓") case "in_progress": return style.Info.Render("→") default: return status } } // trackedIssueInfo holds info about an issue being tracked by a convoy. type trackedIssueInfo struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` Type string `json:"dependency_type"` IssueType string `json:"issue_type"` Assignee string `json:"assignee,omitempty"` // Assigned agent (e.g., gastown/polecats/goose) Worker string `json:"worker,omitempty"` // Worker currently assigned (e.g., gastown/nux) WorkerAge string `json:"worker_age,omitempty"` // How long worker has been on this issue } // getTrackedIssues queries SQLite directly to get issues tracked by a convoy. // This is needed because bd dep list doesn't properly show cross-rig external dependencies. // Uses batched lookup to avoid N+1 subprocess calls. func getTrackedIssues(townBeads, convoyID string) []trackedIssueInfo { dbPath := filepath.Join(townBeads, "beads.db") // Query tracked dependencies from SQLite // Escape single quotes to prevent SQL injection safeConvoyID := strings.ReplaceAll(convoyID, "'", "''") queryCmd := exec.Command("sqlite3", "-json", dbPath, fmt.Sprintf(`SELECT depends_on_id, type FROM dependencies WHERE issue_id = '%s' AND type = 'tracks'`, safeConvoyID)) var stdout bytes.Buffer queryCmd.Stdout = &stdout if err := queryCmd.Run(); err != nil { return nil } var deps []struct { DependsOnID string `json:"depends_on_id"` Type string `json:"type"` } if err := json.Unmarshal(stdout.Bytes(), &deps); err != nil { return nil } // First pass: collect all issue IDs (normalized from external refs) issueIDs := make([]string, 0, len(deps)) idToDepType := make(map[string]string) for _, dep := range deps { issueID := dep.DependsOnID // Handle external reference format: external:rig:issue-id if strings.HasPrefix(issueID, "external:") { parts := strings.SplitN(issueID, ":", 3) if len(parts) == 3 { issueID = parts[2] // Extract the actual issue ID } } issueIDs = append(issueIDs, issueID) idToDepType[issueID] = dep.Type } // Single batch call to get all issue details detailsMap := getIssueDetailsBatch(issueIDs) // Get workers for these issues (only for non-closed issues) openIssueIDs := make([]string, 0, len(issueIDs)) for _, id := range issueIDs { if details, ok := detailsMap[id]; ok && details.Status != "closed" { openIssueIDs = append(openIssueIDs, id) } } workersMap := getWorkersForIssues(openIssueIDs) // Second pass: build result using the batch lookup var tracked []trackedIssueInfo for _, issueID := range issueIDs { info := trackedIssueInfo{ ID: issueID, Type: idToDepType[issueID], } if details, ok := detailsMap[issueID]; ok { info.Title = details.Title info.Status = details.Status info.IssueType = details.IssueType info.Assignee = details.Assignee } else { info.Title = "(external)" info.Status = "unknown" } // Add worker info if available if worker, ok := workersMap[issueID]; ok { info.Worker = worker.Worker info.WorkerAge = worker.Age } tracked = append(tracked, info) } return tracked } // issueDetails holds basic issue info. type issueDetails struct { ID string Title string Status string IssueType string Assignee string } // getIssueDetailsBatch fetches details for multiple issues in a single bd show call. // Returns a map from issue ID to details. Missing/invalid issues are omitted from the map. func getIssueDetailsBatch(issueIDs []string) map[string]*issueDetails { result := make(map[string]*issueDetails) if len(issueIDs) == 0 { return result } // Build args: bd show id1 id2 id3 ... --json args := append([]string{"show"}, issueIDs...) args = append(args, "--json") showCmd := exec.Command("bd", args...) var stdout bytes.Buffer showCmd.Stdout = &stdout if err := showCmd.Run(); err != nil { // Batch failed - fall back to individual lookups for robustness // This handles cases where some IDs are invalid/missing for _, id := range issueIDs { if details := getIssueDetails(id); details != nil { result[id] = details } } return result } var issues []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` IssueType string `json:"issue_type"` Assignee string `json:"assignee"` } if err := json.Unmarshal(stdout.Bytes(), &issues); err != nil { return result } for _, issue := range issues { result[issue.ID] = &issueDetails{ ID: issue.ID, Title: issue.Title, Status: issue.Status, IssueType: issue.IssueType, Assignee: issue.Assignee, } } return result } // getIssueDetails fetches issue details by trying to show it via bd. // Prefer getIssueDetailsBatch for multiple issues to avoid N+1 subprocess calls. func getIssueDetails(issueID string) *issueDetails { // Use bd show with routing - it should find the issue in the right rig showCmd := exec.Command("bd", "show", issueID, "--json") var stdout bytes.Buffer showCmd.Stdout = &stdout if err := showCmd.Run(); err != nil { return nil } var issues []struct { ID string `json:"id"` Title string `json:"title"` Status string `json:"status"` IssueType string `json:"issue_type"` Assignee string `json:"assignee"` } if err := json.Unmarshal(stdout.Bytes(), &issues); err != nil || len(issues) == 0 { return nil } return &issueDetails{ ID: issues[0].ID, Title: issues[0].Title, Status: issues[0].Status, IssueType: issues[0].IssueType, Assignee: issues[0].Assignee, } } // workerInfo holds info about a worker assigned to an issue. type workerInfo struct { Worker string // Agent identity (e.g., gastown/nux) Age string // How long assigned (e.g., "12m") } // getWorkersForIssues finds workers currently assigned to the given issues. // Returns a map from issue ID to worker info. func getWorkersForIssues(issueIDs []string) map[string]*workerInfo { result := make(map[string]*workerInfo) if len(issueIDs) == 0 { return result } // Query agent beads where hook_bead matches one of our issues // We need to check beads across all rigs, so query each potential rig // Find town root townRoot, err := workspace.FindFromCwd() if err != nil || townRoot == "" { return result } // Discover rigs rigDirs, _ := filepath.Glob(filepath.Join(townRoot, "*", "polecats")) for _, polecatsDir := range rigDirs { rigDir := filepath.Dir(polecatsDir) beadsDB := filepath.Join(rigDir, "mayor", "rig", ".beads", "beads.db") // Check if beads.db exists if _, err := os.Stat(beadsDB); err != nil { continue } // Query for agent beads with matching hook_bead for _, issueID := range issueIDs { if _, ok := result[issueID]; ok { continue // Already found a worker for this issue } // Query for agent bead with this hook_bead safeID := strings.ReplaceAll(issueID, "'", "''") query := fmt.Sprintf( `SELECT id, hook_bead, last_activity FROM issues WHERE issue_type = 'agent' AND status = 'open' AND hook_bead = '%s' LIMIT 1`, safeID) queryCmd := exec.Command("sqlite3", "-json", beadsDB, query) var stdout bytes.Buffer queryCmd.Stdout = &stdout if err := queryCmd.Run(); err != nil { continue } var agents []struct { ID string `json:"id"` HookBead string `json:"hook_bead"` LastActivity string `json:"last_activity"` } if err := json.Unmarshal(stdout.Bytes(), &agents); err != nil || len(agents) == 0 { continue } agent := agents[0] // Parse agent ID to get worker identity // Format: gt--- or gt-- workerID := parseWorkerFromAgentBead(agent.ID) if workerID == "" { continue } // Calculate age from last_activity age := "" if agent.LastActivity != "" { if t, err := time.Parse(time.RFC3339, agent.LastActivity); err == nil { age = formatWorkerAge(time.Since(t)) } } result[issueID] = &workerInfo{ Worker: workerID, Age: age, } } } return result } // parseWorkerFromAgentBead extracts worker identity from agent bead ID. // Input: "gt-gastown-polecat-nux" -> Output: "gastown/nux" // Input: "gt-beads-crew-amber" -> Output: "beads/crew/amber" func parseWorkerFromAgentBead(agentID string) string { // Remove prefix (gt-, bd-, etc.) parts := strings.Split(agentID, "-") if len(parts) < 3 { return "" } // Skip prefix parts = parts[1:] // Reconstruct as path return strings.Join(parts, "/") } // formatWorkerAge formats a duration as a short string (e.g., "5m", "2h", "1d") func formatWorkerAge(d time.Duration) string { if d < time.Minute { return "<1m" } if d < time.Hour { return fmt.Sprintf("%dm", int(d.Minutes())) } if d < 24*time.Hour { return fmt.Sprintf("%dh", int(d.Hours())) } return fmt.Sprintf("%dd", int(d.Hours()/24)) } // runConvoyTUI launches the interactive convoy TUI. func runConvoyTUI() error { townBeads, err := getTownBeadsDir() if err != nil { return err } m := convoy.New(townBeads) p := tea.NewProgram(m, tea.WithAltScreen()) _, err = p.Run() return err } // resolveConvoyNumber converts a numeric shortcut (1, 2, 3...) to a convoy ID. // Numbers correspond to the order shown in 'gt convoy list'. func resolveConvoyNumber(townBeads string, n int) (string, error) { // Get convoy list (same query as runConvoyList) listArgs := []string{"list", "--type=convoy", "--json"} listCmd := exec.Command("bd", listArgs...) listCmd.Dir = townBeads var stdout bytes.Buffer listCmd.Stdout = &stdout if err := listCmd.Run(); err != nil { return "", fmt.Errorf("listing convoys: %w", err) } var convoys []struct { ID string `json:"id"` } if err := json.Unmarshal(stdout.Bytes(), &convoys); err != nil { return "", fmt.Errorf("parsing convoy list: %w", err) } if n < 1 || n > len(convoys) { return "", fmt.Errorf("convoy %d not found (have %d convoys)", n, len(convoys)) } return convoys[n-1].ID, nil }