@devo-bmad-custom/agent-orchestration 1.0.6 → 1.0.7

package/src/docs/dev/tmux/tmux-test.sh

@@ -0,0 +1,255 @@
+#!/usr/bin/env bash
+# tmux-test.sh — Automated test suite for tmux agent orchestration commands
+#
+# Tests the verified command library from .agents/skills/tmux-commands/SKILL.md
+# Run from inside a tmux session:
+#   bash docs/dev/tmux-test.sh
+#
+# Tests:
+#   1. Pane creation (split-window + sleep + capture ID)
+#   2. Pane verification (list-panes grep)
+#   3. Message sending with delivery verification
+#   4. Pane naming (select-pane -T)
+#   5. Layout rebalance (main-vertical)
+#   6. Multi-pane spawn + rebalance
+#   7. Graceful kill (kill-pane + cleanup)
+#
+# Exit codes: 0 = all pass, 1 = failures
+
+set -uo pipefail
+
+PASS=0
+FAIL=0
+TESTS=()
+
+pass() { PASS=$((PASS + 1)); TESTS+=("PASS: $1"); echo "  PASS: $1"; }
+fail() { FAIL=$((FAIL + 1)); TESTS+=("FAIL: $1"); echo "  FAIL: $1"; }
+
+# Cleanup function — kill any test panes on exit
+TEST_PANES_TO_CLEAN=()
+cleanup() {
+  for p in "${TEST_PANES_TO_CLEAN[@]}"; do
+    tmux kill-pane -t "$p" 2>/dev/null || true
+  done
+}
+trap cleanup EXIT
+
+echo "========================================"
+echo "  Tmux Command Library Test Suite"
+echo "========================================"
+echo ""
+
+# Pre-check: must be inside tmux
+if [ -z "${TMUX:-}" ]; then
+  echo "ERROR: Not inside a tmux session. Run this from within tmux."
+  exit 1
+fi
+
+MASTER_PANE=$(tmux display-message -p "#{pane_id}")
+SESSION_NAME=$(tmux display-message -p "#{session_name}")
+WINDOW_ID=$(tmux display-message -p "#{window_id}")
+echo "Master pane: $MASTER_PANE"
+echo "Session: $SESSION_NAME"
+echo "Window: $WINDOW_ID"
+echo ""
+
+# ─── Test 1: Split + Sleep + Capture ID ──────────────────────────────────────
+echo "--- Test 1: Pane creation with sleep guards ---"
+
+PANES_BEFORE=$(tmux list-panes -F "#{pane_id}" | wc -l)
+sleep 10
+# Use interactive bash so send-keys works in later tests
+# WSL bash needs ~15s to fully load .bashrc (nvm, etc) before accepting input
+tmux split-window -h -c "#{pane_current_path}" "bash"
+sleep 15
+
+PANES_AFTER=$(tmux list-panes -F "#{pane_id}" | wc -l)
+TEST_PANE=$(tmux list-panes -F "#{pane_id}" | tail -1)
+TEST_PANES_TO_CLEAN+=("$TEST_PANE")
+
+if [ "$PANES_AFTER" -gt "$PANES_BEFORE" ] && [ -n "$TEST_PANE" ]; then
+  pass "Split-window created pane $TEST_PANE (before: $PANES_BEFORE, after: $PANES_AFTER)"
+else
+  fail "Split-window did not create a new pane"
+fi
+
+# ─── Test 2: Pane verification ───────────────────────────────────────────────
+echo ""
+echo "--- Test 2: Pane verification ---"
+
+sleep 10
+VERIFIED=$(tmux list-panes -a -F "#{pane_id} #{session_name} #{window_id}" \
+  | grep "^$TEST_PANE ")
+
+if [ -n "$VERIFIED" ]; then
+  pass "Pane $TEST_PANE verified: $VERIFIED"
+else
+  fail "Pane $TEST_PANE not found in list-panes output"
+fi
+
+# Negative test: verify non-existent pane fails
+FAKE_VERIFIED=$(tmux list-panes -a -F "#{pane_id}" | grep -Fx "%99999")
+if [ -z "$FAKE_VERIFIED" ]; then
+  pass "Non-existent pane %99999 correctly not found"
+else
+  fail "Non-existent pane %99999 incorrectly found"
+fi
+
+# ─── Test 3: Message sending with delivery verification ──────────────────────
+echo ""
+echo "--- Test 3: Message sending ---"
+
+TEST_TOKEN="TMUX_TEST_MSG_$(date +%s)"
+sleep 10
+tmux send-keys -t "$TEST_PANE" "echo $TEST_TOKEN" Enter
+sleep 15
+
+BUFFER=$(tmux capture-pane -t "$TEST_PANE" -p -S -)
+if echo "$BUFFER" | grep -qF "$TEST_TOKEN"; then
+  pass "Message '$TEST_TOKEN' delivered and verified in pane buffer"
+else
+  # Retry once (per protocol)
+  echo "  WARN: First delivery not found, retrying..."
+  sleep 10
+  tmux send-keys -t "$TEST_PANE" "echo $TEST_TOKEN" Enter
+  sleep 15
+  BUFFER2=$(tmux capture-pane -t "$TEST_PANE" -p -S -)
+  if echo "$BUFFER2" | grep -qF "$TEST_TOKEN"; then
+    pass "Message delivered on retry"
+  else
+    fail "Message '$TEST_TOKEN' not found in pane buffer after retry"
+  fi
+fi
+
+# ─── Test 4: Pane naming ─────────────────────────────────────────────────────
+echo ""
+echo "--- Test 4: Pane naming (border title) ---"
+
+TITLE="test-agent-${TEST_PANE}"
+sleep 10
+tmux set-option -t "$TEST_PANE" -p allow-rename off
+sleep 10
+tmux select-pane -t "$TEST_PANE" -T "$TITLE"
+sleep 10
+
+ACTUAL_TITLE=$(tmux display-message -t "$TEST_PANE" -p "#{pane_title}")
+if [ "$ACTUAL_TITLE" = "$TITLE" ]; then
+  pass "Pane title set to '$TITLE'"
+else
+  fail "Expected title '$TITLE', got '$ACTUAL_TITLE'"
+fi
+
+# ─── Test 5: Layout rebalance ────────────────────────────────────────────────
+echo ""
+echo "--- Test 5: Layout rebalance (main-vertical) ---"
+
+sleep 10
+tmux select-pane -t "$MASTER_PANE"
+sleep 10
+tmux select-layout main-vertical 2>/dev/null
+LAYOUT_EXIT=$?
+sleep 10
+
+if [ $LAYOUT_EXIT -eq 0 ]; then
+  pass "main-vertical layout applied successfully"
+else
+  fail "select-layout main-vertical failed with exit code $LAYOUT_EXIT"
+fi
+
+# ─── Test 6: Spawn a second pane and rebalance ───────────────────────────────
+echo ""
+echo "--- Test 6: Multi-pane spawn + rebalance ---"
+
+sleep 10
+# Split from the test pane (not LAST_PANE which could be stale)
+tmux split-window -v -t "$TEST_PANE" -c "#{pane_current_path}" "bash"
+sleep 15
+
+TEST_PANE_2=$(tmux list-panes -F "#{pane_id}" | tail -1)
+TEST_PANES_TO_CLEAN+=("$TEST_PANE_2")
+PANE_COUNT=$(tmux list-panes -F "#{pane_id}" | wc -l)
+
+if [ "$PANE_COUNT" -ge 3 ]; then
+  pass "Second test pane $TEST_PANE_2 created (total: $PANE_COUNT panes)"
+else
+  fail "Expected 3+ panes, got $PANE_COUNT"
+fi
+
+sleep 10
+tmux select-pane -t "$MASTER_PANE"
+sleep 10
+tmux select-layout main-vertical 2>/dev/null
+sleep 10
+
+pass "Rebalanced with $PANE_COUNT panes"
+
+# ─── Test 7: Graceful kill ────────────────────────────────────────────────────
+echo ""
+echo "--- Test 7: Graceful pane kill ---"
+
+# Kill test pane 2 first (check it exists before trying)
+sleep 10
+if tmux list-panes -a -F "#{pane_id}" | grep -qFx "$TEST_PANE_2"; then
+  tmux kill-pane -t "$TEST_PANE_2" 2>/dev/null
+  sleep 10
+  STILL_EXISTS=$(tmux list-panes -a -F "#{pane_id}" | grep -Fx "$TEST_PANE_2")
+  if [ -z "$STILL_EXISTS" ]; then
+    pass "Pane $TEST_PANE_2 killed successfully"
+  else
+    fail "Pane $TEST_PANE_2 still exists after kill"
+  fi
+else
+  fail "Pane $TEST_PANE_2 already gone before kill test"
+fi
+
+# Kill test pane 1
+sleep 10
+if tmux list-panes -a -F "#{pane_id}" | grep -qFx "$TEST_PANE"; then
+  tmux kill-pane -t "$TEST_PANE" 2>/dev/null
+  sleep 10
+  STILL_EXISTS_1=$(tmux list-panes -a -F "#{pane_id}" | grep -Fx "$TEST_PANE")
+  if [ -z "$STILL_EXISTS_1" ]; then
+    pass "Pane $TEST_PANE killed successfully"
+  else
+    fail "Pane $TEST_PANE still exists after kill"
+  fi
+else
+  fail "Pane $TEST_PANE already gone before kill test"
+fi
+
+# Clear cleanup list since we already killed them
+TEST_PANES_TO_CLEAN=()
+
+# Rebalance after kills
+sleep 10
+tmux select-pane -t "$MASTER_PANE"
+sleep 10
+tmux select-layout main-vertical 2>/dev/null
+sleep 10
+
+FINAL_COUNT=$(tmux list-panes -F "#{pane_id}" | wc -l)
+if [ "$FINAL_COUNT" -eq 1 ]; then
+  pass "Back to 1 pane after cleanup"
+else
+  # Not a failure — other panes may exist from user activity
+  pass "Final pane count: $FINAL_COUNT (master pane intact)"
+fi
+
+# ─── Summary ─────────────────────────────────────────────────────────────────
+echo ""
+echo "========================================"
+echo "  Results: $PASS passed, $FAIL failed"
+echo "========================================"
+echo ""
+for t in "${TESTS[@]}"; do
+  echo "  $t"
+done
+echo ""
+
+if [ $FAIL -gt 0 ]; then
+  echo "SOME TESTS FAILED"
+  exit 1
+else
+  echo "ALL TESTS PASSED"
+  exit 0
+fi

package/src/docs/dev/tmux/tmux.conf

@@ -0,0 +1,127 @@
+# General
+set -g mouse on
+set -g base-index 1
+setw -g pane-base-index 1
+set -g default-terminal "tmux-256color"
+set -ga terminal-overrides ",*256col*:Tc"
+set -ga terminal-overrides ",*256col*:RGB"
+set -ga terminal-overrides ",*:U8=0"
+set -s escape-time 0
+# allow-passthrough off: must stay off — "on" causes Claude Code's OSC 2 title sequences
+# to pass through to Windows Terminal instead of tmux intercepting them, which breaks
+# pane-title-changed hook and all session/window auto-naming.
+set -g allow-passthrough off
+set -g status-interval 1
+
+# Copy & Paste (vi mode)
+set -g set-clipboard on
+setw -g mode-keys vi
+bind -T copy-mode-vi v   send-keys -X begin-selection
+bind -T copy-mode-vi C-v send-keys -X rectangle-toggle
+bind -T copy-mode-vi C-c send-keys -X copy-pipe-and-cancel 'clip.exe'
+bind -T copy-mode-vi y   send-keys -X copy-pipe-and-cancel 'clip.exe'
+bind -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel 'clip.exe'
+
+# Alt+V pastes image/file/text from clipboard — saves to /tmp, types path into pane instantly
+bind -n M-v run-shell "bash ~/.config/tmux/bin/paste_image_wrapper.sh '#{pane_id}'"
+# Alt+F opens resizable float terminal (Ctrl+Up/Down to resize inside)
+bind -n M-f run-shell -b "bash ~/.config/tmux/bin/float_term.sh '#{pane_id}'"
+
+# Colors
+if-shell '[ -f ~/.config/tmux/colors.conf ]' "source-file ~/.config/tmux/colors.conf"
+
+# Plugins
+set -g @plugin 'tmux-plugins/tpm'
+set -g @plugin 'tmux-plugins/tmux-sensible'
+set -g @plugin 'tmux-plugins/tmux-resurrect'
+set -g @plugin 'tmux-plugins/tmux-continuum'
+set -g @plugin 'tmux-plugins/tmux-yank'
+set -g @plugin 'bjesus/muxile'
+set -g @plugin 'lloydbond/tmux-floating-terminal'
+set -g @plugin 'tmux-plugins/tmux-open'
+# Plugin config
+set -g @open 'wslview'
+set -g @floating_scratch_term 'M-i'
+
+# Appearance
+set -g window-style 'default'
+set -g window-active-style 'default'
+
+# ── Pane borders (hidden with 1 pane, shown with 2+) ────────────────────────────
+setw -g pane-border-status off
+setw -g pane-border-lines single
+setw -g pane-border-style 'fg=#414559'
+setw -g pane-active-border-style 'fg=#{?#{==:#{pane_index},1},#3d6095,#{?#{==:#{pane_index},2},#4a6e38,#{?#{==:#{pane_index},3},#783a3c,#{?#{==:#{pane_index},4},#5c3c78,#784828}}}}'
+# Cap styles: rounded    |  pointed    (swap chars in format below to change)
+setw -g pane-border-format '#{?pane_active,#[align=centre]#[fg=#{?#{==:#{pane_index},1},#3d6095,#{?#{==:#{pane_index},2},#4a6e38,#{?#{==:#{pane_index},3},#783a3c,#{?#{==:#{pane_index},4},#5c3c78,#784828}}}}]#[bg=default]#[fg=#d8ddf0]#[bg=#{?#{==:#{pane_index},1},#3d6095,#{?#{==:#{pane_index},2},#4a6e38,#{?#{==:#{pane_index},3},#783a3c,#{?#{==:#{pane_index},4},#5c3c78,#784828}}}}]#[bold] #{?#{@pane-hash},#{@pane-hash},#{pane_title}} ID #{s/%//:pane_id} #[fg=#{?#{==:#{pane_index},1},#3d6095,#{?#{==:#{pane_index},2},#4a6e38,#{?#{==:#{pane_index},3},#783a3c,#{?#{==:#{pane_index},4},#5c3c78,#784828}}}}]#[bg=default]#[nobold],#[align=centre]#[fg=#414559]#[bg=default]#[fg=#c6d0f5]#[bg=#414559] #{?#{@pane-hash},#{@pane-hash},#{pane_title}} ID #{s/%//:pane_id} #[fg=#414559]#[bg=default]}'
+
+# Toggle borders on/off based on pane count
+set-hook -g after-split-window 'if "[ #{window_panes} -gt 1 ]" "setw pane-border-status top" "setw pane-border-status off" ; run-shell "tmux set-option -pt #{pane_id} @pane-hash #{s/%//:pane_id}"'
+set-hook -g pane-exited 'if "[ #{window_panes} -gt 1 ]" "setw pane-border-status top" "setw pane-border-status off"'
+# Sync active pane title → window name, and session name (with cwd basename) if first window
+# Session name = "<pane title> · <cwd basename>" so multiple Claude Code sessions stay unique
+# pane-title-changed fires on every OSC 2 update (primary trigger)
+set-hook -wg pane-title-changed 'run-shell "bash ~/.config/tmux/bin/title_sync.sh #{pane_id} #{pane_active} #{window_index} \"#{pane_title}\" \"#{b:pane_current_path}\""'
+# Fallback: re-sync on pane/window/client focus so stale titles catch up even without a title change
+set-hook -g after-select-pane 'run-shell "bash ~/.config/tmux/bin/title_sync.sh #{pane_id} #{pane_active} #{window_index} \"#{pane_title}\" \"#{b:pane_current_path}\""'
+set-hook -g after-select-window 'run-shell "bash ~/.config/tmux/bin/title_sync.sh #{pane_id} #{pane_active} #{window_index} \"#{pane_title}\" \"#{b:pane_current_path}\""'
+set-hook -g client-focus-in 'run-shell "bash ~/.config/tmux/bin/title_sync.sh #{pane_id} #{pane_active} #{window_index} \"#{pane_title}\" \"#{b:pane_current_path}\""'
+set -g automatic-rename off
+
+# ── Status bar ────────────────────────────────────────────────────────────────────────────────
+set -g status on
+set -g status-position bottom
+set -g status-style 'bg=#232634'
+set -g status-justify left
+set -g window-status-format ''
+set -g window-status-current-format ''
+set -g window-status-separator ''
+set -g status-right '#[fg=#3d6095]#[bg=#232634]#[fg=#d8ddf0]#[bg=#3d6095]#[bold]💻 ID #{s/[$]//:session_id} #[fg=#685820]#[bg=#3d6095]#[fg=#d8ddf0]#[bg=#685820]#[bold]🪟  ID #{s/@//:window_id} #[fg=#4a6e38]#[bg=#685820]#[fg=#d8ddf0]#[bg=#4a6e38]#[bold]📁 #{b:pane_current_path}#[fg=#784828]#[bg=#4a6e38]#[fg=#d8ddf0]#[bg=#784828]#[bold]🧮 #(~/.config/tmux/bin/cpu_usage.sh) #[fg=#783a3c]#[bg=#784828]#[fg=#d8ddf0]#[bg=#783a3c]#[bold]💾 #(~/.config/tmux/bin/ram_usage.sh) #[fg=#5c3c78]#[bg=#783a3c]#[fg=#d8ddf0]#[bg=#5c3c78]#[bold]⏰ %I:%M %p  %a %d %b #[none]'
+set -g status-left-length 500
+set -g status-right-length 300
+set -gu 'status-format[1]'
+set -g status-left '  #{?client_prefix,#[fg=#783a3c]#[bg=#232634]#[fg=#d8ddf0]#[bg=#783a3c]#[bold]⌨ CTRL+B #[fg=#783a3c]#[bg=#232634]#[none] ,#[fg=#414559]#[bg=#232634]#[fg=#c6d0f5]#[bg=#414559]#[bold]▶#[fg=#414559]#[bg=#232634]#[none] }#[range=user|actions]#[fg=#3d6095]#[bg=#232634]#[fg=#d8ddf0]#[bg=#3d6095]#[bold]⚙ Actions#[fg=#3d6095]#[bg=#232634]#[none]#[norange] #[range=user|reload]#[fg=#685820]#[bg=#232634]#[fg=#d8ddf0]#[bg=#685820]#[bold]🔄 Reload#[fg=#685820]#[bg=#232634]#[none]#[norange] '
+
+# ── Rename new session to cwd basename as initial placeholder ─────────────────────────
+set-hook -g session-created "run-shell 'tmux rename-session \"#{b:pane_current_path}\" 2>/dev/null || true'"
+
+# Hash-name new windows until Claude sets a real title
+set-hook -g after-new-window 'run-shell "tmux rename-window #{window_id}; tmux set-option -pt #{pane_id} @pane-hash #{s/%//:pane_id}"'
+
+# ── Load TPM ────────────────────────────────────────────────────────────────────────────────
+run '~/.tmux/plugins/tpm/tpm'
+# Override tmux-yank mouse drag: copy to tmux buffer only, not Windows clipboard
+bind -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-selection-and-cancel
+
+# ── Remove / replace stale bindings ───────────────────────────────────────────────────
+# C-v: paste Windows clipboard text into active pane (bracketed paste — works with Claude Code)
+bind -T root C-v run-shell "bash ~/.config/tmux/bin/paste_claude.sh '#{pane_id}'"
+unbind -T root MouseDown2Status
+unbind -T root MouseDown3Status
+# Suppress tmux default right-click menu (shows split options — opens panes accidentally)
+bind -T root MouseDown3Pane select-pane -t=
+bind -T root MouseDown1Pane select-pane -t = \; send-keys -M -t =
+bind -T root MouseUp1Pane   select-pane -t = \; send-keys -M -t =
+bind -T root M-n new-window
+bind -T root M-N new-window
+bind -T root MouseDown3Border display-menu -T "Pane Actions" -x M -y M \
+  "Split Vertical"      "|" "split-window -h -c '#{pane_current_path}'" \
+  "Split Horizontal"    "-" "split-window -v -c '#{pane_current_path}'" \
+  "" "" "" \
+  "Break to New Window" "b" "break-pane" \
+  "Swap Up"             "u" "swap-pane -U" \
+  "Swap Down"           "d" "swap-pane -D" \
+  "" "" "" \
+  "Kill Pane"           "x" "confirm-before -p 'Kill pane? (y/n)' kill-pane"
+
+# ── Mouse binding ─────────────────────────────────────────────────────────────────────────────
+bind -T root MouseDown1Status {
+  if -F '#{==:#{mouse_status_range},actions}' {
+    display-popup -E -d '#{pane_current_path}' -xC -yS -w 92 -h 22 "python3 ~/.config/tmux/bin/actions_popup.py '#{pane_id}'"
+  }
+}
+bind -T root MouseUp1Status {
+  if -F '#{!=:#{mouse_status_range},actions}' {
+    run-shell -b "~/.config/tmux/bin/dispatch.sh '#{mouse_status_range}' '#{pane_id}'"
+  }
+}

package/src/docs/dev/tmux/xclip

@@ -0,0 +1,18 @@
+#!/bin/bash
+# WSL2 xclip shim — routes xclip calls to the Windows clipboard.
+# Supports the common usage patterns that tmux-yank and other tools expect.
+#   Read (stdout):  xclip -selection clipboard -o
+#   Write (stdin):  xclip -selection clipboard
+
+OUT=0
+for arg in "$@"; do
+    [ "$arg" = "-o" ] || [ "$arg" = "-out" ] && OUT=1
+done
+
+if [ "$OUT" -eq 1 ]; then
+    powershell.exe -NoProfile -Command \
+        "[Console]::OutputEncoding=[System.Text.Encoding]::UTF8; Get-Clipboard" \
+        2>/dev/null | tr -d '\r'
+else
+    clip.exe
+fi