@cyperx/clawforge 1.2.0

package/tui/PRD.md

@@ -0,0 +1,106 @@
+# ClawForge TUI — Go + Bubble Tea Rewrite
+
+## Goal
+Replace the bash dashboard.sh with a flicker-free Go TUI using Bubble Tea v2 + Lipgloss v2 + Bubbles.
+
+## Architecture
+- Single Go binary: `clawforge-dashboard`
+- Lives in `tui/` directory within the clawforge repo
+- Reads data from clawforge registry (JSON files) + tmux + git
+
+## Data Sources
+- `registry/active-tasks.json` — task list with id, mode, status, branch, description
+- `registry/costs.jsonl` — per-task cost data (inputTokens, outputTokens, totalCost)
+- `registry/conflicts.jsonl` — conflict records
+- `tmux list-sessions -F "#{session_name} #{session_activity}"` — live session status
+- `git -C <worktree> log --oneline -1` — last commit per agent
+
+## File Structure
+```
+tui/
+├── main.go           # Entry point, tea.NewProgram
+├── model.go          # Model struct, Init, Update, View
+├── animation.go      # Forge startup animation frames + logic
+├── dashboard.go      # Main dashboard view rendering
+├── agent.go          # Agent data structures + loading from registry
+├── keybindings.go    # Key handling + help overlay
+├── styles.go         # Lipgloss styles (amber/orange forge theme)
+├── steer.go          # Steer input modal
+├── filter.go         # Filter input handling
+└── go.mod
+```
+
+## Phase 1: Animation (animation.go + styles.go)
+- 8-10 frames of ASCII forge art with hammering/sparks effect
+- Amber/orange color scheme via Lipgloss (colors: #FF8C00, #FF6600, #FFA500, #CC5500)
+- Frame cycle: 120ms per frame, ~1.5 seconds total
+- Transition: fade last frame → dashboard view
+- tea.Tick for frame timing
+- --no-anim flag skips directly to dashboard
+
+## Phase 2: Dashboard View (dashboard.go + agent.go)
+- Header: "ClawForge Dashboard" with forge emoji + version
+- Agent table columns:
+  | ID | Mode | Status | Branch | Task (truncated) | Cost | CI | Conflicts |
+- Selected row highlighted with reverse video + amber accent
+- Status indicators: 🟢 running, 🟡 idle, 🔴 failed, ⚪ done
+- Cost column: "$X.XX" or "-" if no cost data
+- CI column: ✅/❌/⏳/- 
+- Conflicts column: count or "-"
+- Footer status bar: "4 agents | 2 running | $3.42 total | ↑↓ navigate | ? help"
+- Auto-refresh: tea.Tick every 2 seconds triggers data reload
+- Only re-renders changed cells (Bubble Tea handles this automatically)
+
+## Phase 3: Vim Keybindings (keybindings.go)
+- j/k or ↑/↓: navigate agent list
+- Enter: attach to selected agent's tmux session (tea.ExecProcess)
+- s: open steer input modal
+- x: stop selected agent (confirm with y/n)
+- q or Ctrl+C: quit
+- /: open filter input
+- r: force refresh
+- ?: toggle help overlay
+- g: go to top
+- G: go to bottom
+- Esc: close any modal/overlay
+
+## Phase 4: Steer Modal (steer.go)
+- When 's' pressed: show text input at bottom
+- Prompt: "Steer agent #X: "
+- Enter submits: runs `clawforge steer <id> "<message>"`
+- Esc cancels
+- Use Bubbles textinput component
+
+## Phase 5: Filter (filter.go)
+- When '/' pressed: show filter input at top
+- Filters agent list by any column match (fuzzy)
+- Esc clears filter
+- Live filtering as you type
+
+## Phase 6: Help Overlay (keybindings.go)
+- Semi-transparent overlay listing all keybindings
+- Dismiss with ? or Esc
+- Styled with Lipgloss border + padding
+
+## Performance Requirements
+- Zero flicker (Bubble Tea cell-based diff handles this)
+- Startup to dashboard: < 500ms (excluding animation)
+- Data refresh: < 100ms (shell out to tmux/git in background)
+- Smooth animation: consistent 120ms frame timing
+- Handle terminal resize gracefully (tea.WindowSizeMsg)
+
+## Build
+- `go build -o bin/clawforge-dashboard ./tui/`
+- Update `bin/clawforge` to prefer Go binary when available
+- Keep dashboard.sh as fallback
+
+## Styling (Lipgloss)
+- Primary: #FF8C00 (dark orange / amber)
+- Secondary: #FFA500 (orange)
+- Accent: #FF6600 (red-orange)
+- Muted: #CC5500 (brown-orange)
+- Background: terminal default (transparent)
+- Selected row: reverse + amber foreground
+- Header: bold + amber
+- Status bar: dim + muted
+- Borders: rounded, amber

package/tui/agent.go

@@ -0,0 +1,266 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+)
+
+// Agent represents a single ClawForge agent with its current state.
+type Agent struct {
+	ID          string
+	ShortID     int
+	Preview     string
+	Mode        string
+	Model       string
+	Repo        string
+	Status      string
+	Branch      string
+	Task        string
+	Cost        string
+	CI          string
+	Conflicts   int
+	Description string
+	Worktree    string
+	TmuxSession string
+}
+
+// registryTask mirrors the JSON structure in active-tasks.json.
+type registryTask struct {
+	ID          string `json:"id"`
+	ShortID     int    `json:"short_id"`
+	Mode        string `json:"mode"`
+	Status      string `json:"status"`
+	Branch      string `json:"branch"`
+	Description string `json:"description"`
+	Worktree    string `json:"worktree"`
+	TmuxSession string `json:"tmux_session"`
+	Agent       string `json:"agent"`
+	Model       string `json:"model"`
+	Repo        string `json:"repo"`
+	CIStatus    string `json:"ci_status"`
+}
+
+type registryFile struct {
+	Tasks []registryTask `json:"tasks"`
+}
+
+// costEntry mirrors a line in costs.jsonl.
+type costEntry struct {
+	TaskID    string  `json:"taskId"`
+	TotalCost float64 `json:"totalCost"`
+}
+
+// conflictEntry mirrors a line in conflicts.jsonl.
+type conflictEntry struct {
+	TaskIDs  []string `json:"task_ids"`
+	Status   string   `json:"status"`
+	Resolved bool     `json:"resolved"`
+}
+
+// clawforgeDir returns the clawforge root directory.
+func clawforgeDir() string {
+	// Check CLAWFORGE_DIR env first, then walk up from executable.
+	if d := os.Getenv("CLAWFORGE_DIR"); d != "" {
+		return d
+	}
+	exe, err := os.Executable()
+	if err == nil {
+		dir := filepath.Dir(exe)
+		// If binary is in bin/, go up one level.
+		if filepath.Base(dir) == "bin" {
+			return filepath.Dir(dir)
+		}
+		// If binary is in tui/, go up one level.
+		if filepath.Base(dir) == "tui" {
+			return filepath.Dir(dir)
+		}
+		return filepath.Dir(dir)
+	}
+	return "."
+}
+
+// LoadAgents reads the registry, cost data, conflict data, and tmux state
+// to produce a full list of Agent records.
+func LoadAgents() []Agent {
+	root := clawforgeDir()
+	registryPath := filepath.Join(root, "registry", "active-tasks.json")
+
+	data, err := os.ReadFile(registryPath)
+	if err != nil {
+		return nil
+	}
+
+	var reg registryFile
+	if err := json.Unmarshal(data, &reg); err != nil {
+		return nil
+	}
+
+	// Load cost data.
+	costs := loadCosts(filepath.Join(root, "registry", "costs.jsonl"))
+
+	// Load conflict counts.
+	conflicts := loadConflictCounts(filepath.Join(root, "registry", "conflicts.jsonl"))
+
+	// Load tmux sessions.
+	tmuxSessions := loadTmuxSessions()
+
+	agents := make([]Agent, 0, len(reg.Tasks))
+	previewLines := 3
+	for _, t := range reg.Tasks {
+		a := Agent{
+			ID:          t.ID,
+			ShortID:     t.ShortID,
+			Mode:        t.Mode,
+			Model:       t.Model,
+			Repo:        t.Repo,
+			Status:      t.Status,
+			Branch:      t.Branch,
+			Description: t.Description,
+			Task:        t.Description,
+			Worktree:    t.Worktree,
+			TmuxSession: t.TmuxSession,
+			CI:          ciIndicator(t.CIStatus),
+			Cost:        costs[t.ID],
+			Conflicts:   conflicts[t.ID],
+		}
+
+		// Enrich status from tmux if task is "running".
+		if a.Status == "running" && a.TmuxSession != "" {
+			if _, ok := tmuxSessions[a.TmuxSession]; !ok {
+				a.Status = "failed"
+			} else {
+				a.Preview = captureTmuxPreview(a.TmuxSession, previewLines)
+			}
+		}
+
+		if a.Cost == "" {
+			a.Cost = "-"
+		}
+		if a.Mode == "" {
+			a.Mode = "—"
+		}
+		if a.Model == "" {
+			a.Model = "-"
+		}
+		if a.Repo == "" {
+			a.Repo = "-"
+		} else {
+			a.Repo = filepath.Base(a.Repo)
+		}
+
+		agents = append(agents, a)
+	}
+
+	return agents
+}
+
+// loadCosts reads costs.jsonl and sums cost per task.
+func loadCosts(path string) map[string]string {
+	result := make(map[string]string)
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return result
+	}
+
+	totals := make(map[string]float64)
+	for _, line := range strings.Split(strings.TrimSpace(string(data)), "\n") {
+		if line == "" {
+			continue
+		}
+		var entry costEntry
+		if json.Unmarshal([]byte(line), &entry) == nil && entry.TaskID != "" {
+			totals[entry.TaskID] += entry.TotalCost
+		}
+	}
+
+	for id, total := range totals {
+		result[id] = fmt.Sprintf("$%.2f", total)
+	}
+	return result
+}
+
+// loadConflictCounts reads conflicts.jsonl and counts unresolved conflicts per task.
+func loadConflictCounts(path string) map[string]int {
+	result := make(map[string]int)
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return result
+	}
+
+	for _, line := range strings.Split(strings.TrimSpace(string(data)), "\n") {
+		if line == "" {
+			continue
+		}
+		var entry conflictEntry
+		if json.Unmarshal([]byte(line), &entry) == nil && !entry.Resolved {
+			for _, id := range entry.TaskIDs {
+				result[id]++
+			}
+		}
+	}
+	return result
+}
+
+// loadTmuxSessions returns a set of active tmux session names.
+func loadTmuxSessions() map[string]bool {
+	sessions := make(map[string]bool)
+	out, err := exec.Command("tmux", "list-sessions", "-F", "#{session_name}").Output()
+	if err != nil {
+		return sessions
+	}
+	for _, line := range strings.Split(strings.TrimSpace(string(out)), "\n") {
+		if line != "" {
+			sessions[line] = true
+		}
+	}
+	return sessions
+}
+
+// ciIndicator converts a CI status string to a display indicator.
+func ciIndicator(status string) string {
+	switch strings.ToLower(status) {
+	case "pass", "passed", "success":
+		return "✅"
+	case "fail", "failed", "failure":
+		return "❌"
+	case "pending", "running", "in_progress":
+		return "⏳"
+	default:
+		return "-"
+	}
+}
+
+// statusIndicator returns the colored status emoji for an agent.
+func statusIndicator(status string) string {
+	switch strings.ToLower(status) {
+	case "running":
+		return "🟢"
+	case "idle":
+		return "🟡"
+	case "failed":
+		return "🔴"
+	case "done":
+		return "⚪"
+	default:
+		return "⚫"
+	}
+}
+
+// captureTmuxPreview grabs the last N lines from a tmux pane.
+func captureTmuxPreview(session string, lines int) string {
+	out, err := exec.Command("tmux", "capture-pane", "-t", session, "-p", "-S", fmt.Sprintf("-%d", lines)).Output()
+	if err != nil {
+		return ""
+	}
+	// Strip ANSI escape codes for clean display
+	result := strings.TrimSpace(string(out))
+	// Basic ANSI strip
+	for _, prefix := range []string{"\033[", "\x1b["} {
+		_ = prefix // handled by sed-like logic below
+	}
+	return result
+}

package/tui/animation.go

@@ -0,0 +1,192 @@
+package main
+
+import (
+	"time"
+
+	tea "charm.land/bubbletea/v2"
+	"charm.land/lipgloss/v2"
+)
+
+// AnimationTickMsg advances the forge startup animation by one frame.
+type AnimationTickMsg time.Time
+
+// AnimationDoneMsg signals that the startup animation has completed.
+type AnimationDoneMsg struct{}
+
+const frameDuration = 120 * time.Millisecond
+
+// forgeFrames contains the ASCII art frames for the forge startup animation.
+// 10 frames of a hammering/sparks effect at ~120ms each = ~1.2s total.
+var forgeFrames = [...]string{
+	// Frame 0: Forge cold
+	`
+        _______________
+       /               \
+      /   C L A W       \
+     /    F O R G E      \
+    /                     \
+   /_______________________\
+          |       |
+          |       |
+          |  ___  |
+          | |   | |
+   _______|_|___|_|________
+  |________________________|
+`,
+	// Frame 1: Embers glow
+	`
+        _______________
+       /               \
+      /   C L A W       \
+     /    F O R G E      \
+    /         .           \
+   /_______________________\
+          |       |
+          |   *   |
+          |  ___  |
+          | |   | |
+   _______|_|___|_|________
+  |_______.....____________|
+`,
+	// Frame 2: Fire rising
+	`
+        _______________
+       /               \
+      /   C L A W       \
+     /    F O R G E      \
+    /        . .          \
+   /_______________________\
+          |  * *  |
+          |  /|\  |
+          |  ___  |
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 3: Hammer up
+	`
+        _______________
+       /               \    _____
+      /   C L A W       \  |     |
+     /    F O R G E      \ | ))) |
+    /       * . *         \|_____|
+   /_______________________\  |
+          | *** * |           |
+          |  /|\  |          /
+          |  ___  |         /
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 4: Hammer strike!
+	`
+        _______________
+       /               \
+      /   C L A W       \
+     /    F O R G E      \  _____
+    /     * * . * *       \ |     |
+   /________________________| ))) |
+          | ***** |         |_____|
+          |  /|\  |
+          |  ___  |
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 5: SPARKS!
+	`
+        _______________
+       /    *      *    \
+      /   C L A W    *   \
+     /    F O R G E   *   \  _____
+    /   *  * * . * *  *    \ |     |
+   /________________________\| ))) |
+       *  | ***** |  *      |_____|
+      *   |  /|\  |   *
+          |  ___  |
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 6: Sparks fade, hammer lifts
+	`
+        _______________
+       /       *        \
+      /   C L A W        \
+     /    F O R G E       \  _____
+    /      * . . *         \ |     |
+   /_______________________\ | ))) |
+          | * * * |          |_____|
+          |  /|\  |            |
+          |  ___  |           /
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 7: Second strike!
+	`
+        _______________
+       /               \
+      /   C L A W       \
+     /    F O R G E      \  _____
+    /     * * . * *       \ |     |
+   /________________________| ))) |
+          | ***** |         |_____|
+          |  /|\  |
+          |  ___  |
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 8: BIG SPARKS!
+	`
+     *  _______________  *
+    *  /  *   *    *    \  *
+      /   C L A W   * *  \
+   * /    F O R G E  *    \  _____
+    / * *  * * . * *  * *  \ |     |
+   /________________________\| ))) |
+    *  *  | ***** |  *  *   |_____|
+   *   *  |  /|\  |  *   *
+      *   |  ___  |   *
+          | |^^^| |
+   _______|_|___|_|________
+  |______*..^^^..*_________|
+`,
+	// Frame 9: Forge ready — blade forged
+	`
+        _______________
+       /               \
+      /   C L A W       \
+     /    F O R G E      \
+    /       READY          \
+   /_______________________\
+          |       |
+          |  ---  |
+          |  ___  |
+          | |===| |
+   _______|_|___|_|________
+  |_______ FORGED _________|
+`,
+}
+
+// animationTick returns a command that sends an AnimationTickMsg after frameDuration.
+func animationTick() tea.Cmd {
+	return tea.Tick(frameDuration, func(t time.Time) tea.Msg {
+		return AnimationTickMsg(t)
+	})
+}
+
+// renderAnimation renders the current animation frame centered in the terminal.
+func renderAnimation(frame int, width, height int) string {
+	if frame < 0 || frame >= len(forgeFrames) {
+		return ""
+	}
+
+	content := animFrameStyle.Render(forgeFrames[frame])
+
+	if width > 0 && height > 0 {
+		return lipgloss.Place(width, height, lipgloss.Center, lipgloss.Center, content)
+	}
+	return content
+}