shipwright-cli 1.7.0

package/scripts/cct-session.sh

@@ -0,0 +1,284 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  cct-session.sh — Launch a Claude Code team session in a new tmux window║
+# ║                                                                          ║
+# ║  Uses new-window (NOT split-window) to avoid the tmux send-keys race    ║
+# ║  condition that affects 4+ agents. See KNOWN-ISSUES.md for details.     ║
+# ║                                                                          ║
+# ║  Supports --template to scaffold from a team template and --terminal    ║
+# ║  to select a terminal adapter (tmux, iterm2, wezterm).                  ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# ─── Colors ──────────────────────────────────────────────────────────────────
+CYAN='\033[38;2;0;212;255m'
+PURPLE='\033[38;2;124;58;237m'
+GREEN='\033[38;2;74;222;128m'
+YELLOW='\033[38;2;250;204;21m'
+RED='\033[38;2;248;113;113m'
+DIM='\033[2m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+info()    { echo -e "${CYAN}${BOLD}▸${RESET} $*"; }
+success() { echo -e "${GREEN}${BOLD}✓${RESET} $*"; }
+warn()    { echo -e "${YELLOW}${BOLD}⚠${RESET} $*"; }
+error()   { echo -e "${RED}${BOLD}✗${RESET} $*" >&2; }
+
+# ─── Parse Arguments ────────────────────────────────────────────────────────
+
+TEAM_NAME=""
+TEMPLATE_NAME=""
+TERMINAL_ADAPTER=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --template|-t)
+            TEMPLATE_NAME="${2:-}"
+            [[ -z "$TEMPLATE_NAME" ]] && { error "Missing template name after --template"; exit 1; }
+            shift 2
+            ;;
+        --terminal)
+            TERMINAL_ADAPTER="${2:-}"
+            [[ -z "$TERMINAL_ADAPTER" ]] && { error "Missing adapter name after --terminal"; exit 1; }
+            shift 2
+            ;;
+        --help|-h)
+            echo -e "${CYAN}${BOLD}shipwright session${RESET} — Create a new team session"
+            echo ""
+            echo -e "${BOLD}USAGE${RESET}"
+            echo -e "  shipwright session [name] [--template <name>] [--terminal <adapter>]"
+            echo ""
+            echo -e "${BOLD}OPTIONS${RESET}"
+            echo -e "  ${CYAN}--template, -t${RESET} <name>   Use a team template (see: shipwright templates list)"
+            echo -e "  ${CYAN}--terminal${RESET} <adapter>    Terminal adapter: tmux (default), iterm2, wezterm"
+            echo ""
+            echo -e "${BOLD}EXAMPLES${RESET}"
+            echo -e "  ${DIM}shipwright session refactor${RESET}"
+            echo -e "  ${DIM}shipwright session my-feature --template feature-dev${RESET}"
+            echo -e "  ${DIM}shipwright session my-feature --terminal iterm2${RESET}"
+            exit 0
+            ;;
+        -*)
+            error "Unknown option: $1"
+            exit 1
+            ;;
+        *)
+            # Positional: team name
+            [[ -z "$TEAM_NAME" ]] && TEAM_NAME="$1" || { error "Unexpected argument: $1"; exit 1; }
+            shift
+            ;;
+    esac
+done
+
+TEAM_NAME="${TEAM_NAME:-team-$(date +%s)}"
+WINDOW_NAME="claude-${TEAM_NAME}"
+
+# ─── Template Loading ───────────────────────────────────────────────────────
+
+TEMPLATE_FILE=""
+TEMPLATE_LAYOUT=""
+TEMPLATE_LAYOUT_STYLE=""
+TEMPLATE_MAIN_PANE_PERCENT=""
+TEMPLATE_DESC=""
+TEMPLATE_AGENTS=()  # Populated as "name|role|focus" entries
+
+if [[ -n "$TEMPLATE_NAME" ]]; then
+    # Search for template: user dir first, then repo dir
+    USER_TEMPLATES_DIR="${HOME}/.claude-teams/templates"
+    REPO_TEMPLATES_DIR="$(cd "$SCRIPT_DIR/../tmux/templates" 2>/dev/null && pwd)" || REPO_TEMPLATES_DIR=""
+
+    TEMPLATE_NAME="${TEMPLATE_NAME%.json}"
+
+    if [[ -f "$USER_TEMPLATES_DIR/${TEMPLATE_NAME}.json" ]]; then
+        TEMPLATE_FILE="$USER_TEMPLATES_DIR/${TEMPLATE_NAME}.json"
+    elif [[ -n "$REPO_TEMPLATES_DIR" && -f "$REPO_TEMPLATES_DIR/${TEMPLATE_NAME}.json" ]]; then
+        TEMPLATE_FILE="$REPO_TEMPLATES_DIR/${TEMPLATE_NAME}.json"
+    else
+        error "Template '${TEMPLATE_NAME}' not found."
+        echo -e "  Run ${DIM}shipwright templates list${RESET} to see available templates."
+        exit 1
+    fi
+
+    info "Loading template: ${PURPLE}${BOLD}${TEMPLATE_NAME}${RESET}"
+
+    # Parse template — single jq call extracts all fields + agents in one pass
+    if command -v jq &>/dev/null; then
+        # Single jq call: outputs metadata lines then agent lines
+        # Format: META<tab>field<tab>value for metadata, AGENT<tab>name|role|focus for agents
+        while IFS=$'\t' read -r tag key value; do
+            case "$tag" in
+                META)
+                    case "$key" in
+                        description)       TEMPLATE_DESC="$value" ;;
+                        layout)            TEMPLATE_LAYOUT="$value" ;;
+                        layout_style)      TEMPLATE_LAYOUT_STYLE="$value" ;;
+                        main_pane_percent) TEMPLATE_MAIN_PANE_PERCENT="$value" ;;
+                    esac
+                    ;;
+                AGENT) [[ -n "$key" ]] && TEMPLATE_AGENTS+=("$key") ;;
+            esac
+        done < <(jq -r '
+            "META\tdescription\t\(.description // "")",
+            "META\tlayout\t\(.layout // "tiled")",
+            "META\tlayout_style\t\(.layout_style // "")",
+            "META\tmain_pane_percent\t\(.main_pane_percent // "")",
+            (.agents // [] | .[] | "AGENT\t\(.name)|\(.role // "")|\(.focus // "")\t")
+        ' "$TEMPLATE_FILE")
+    else
+        error "jq is required for template parsing."
+        echo -e "  ${DIM}brew install jq${RESET}"
+        exit 1
+    fi
+
+    echo -e "  ${DIM}${TEMPLATE_DESC}${RESET}"
+    echo -e "  ${DIM}Agents: ${#TEMPLATE_AGENTS[@]}  Layout: ${TEMPLATE_LAYOUT}${RESET}"
+fi
+
+# ─── Resolve Terminal Adapter ───────────────────────────────────────────────
+
+# Auto-detect if not specified
+if [[ -z "$TERMINAL_ADAPTER" ]]; then
+    TERMINAL_ADAPTER="tmux"
+fi
+
+ADAPTER_FILE="$SCRIPT_DIR/adapters/${TERMINAL_ADAPTER}-adapter.sh"
+if [[ -f "$ADAPTER_FILE" ]]; then
+    # shellcheck source=/dev/null
+    source "$ADAPTER_FILE"
+else
+    # Default to inline tmux behavior (backwards compatible)
+    if [[ "$TERMINAL_ADAPTER" != "tmux" ]]; then
+        error "Terminal adapter '${TERMINAL_ADAPTER}' not found."
+        echo -e "  Available: tmux (default), iterm2, wezterm"
+        echo -e "  Adapter dir: ${DIM}${SCRIPT_DIR}/adapters/${RESET}"
+        exit 1
+    fi
+fi
+
+# ─── Create Session (tmux default path) ─────────────────────────────────────
+
+if [[ "$TERMINAL_ADAPTER" == "tmux" && ! -f "$ADAPTER_FILE" ]]; then
+    # Inline tmux path — original behavior (adapter not required for tmux)
+
+    # Check if a window with this name already exists
+    if tmux list-windows -F '#W' 2>/dev/null | grep -qx "$WINDOW_NAME"; then
+        warn "Window '${WINDOW_NAME}' already exists. Switching to it."
+        tmux select-window -t "$WINDOW_NAME"
+        exit 0
+    fi
+
+    info "Creating team session: ${CYAN}${BOLD}${TEAM_NAME}${RESET}"
+
+    # Create a new window (not split-window — avoids race condition #23615)
+    tmux new-window -n "$WINDOW_NAME" -c "#{pane_current_path}"
+
+    # Force dark theme on the new pane (belt-and-suspenders with overlay hooks)
+    tmux select-pane -t "$WINDOW_NAME" -P 'bg=#1a1a2e,fg=#e4e4e7'
+
+    # Set the pane title so the overlay shows the team name
+    tmux send-keys -t "$WINDOW_NAME" "printf '\\033]2;${TEAM_NAME}-lead\\033\\\\'" Enter
+
+    sleep 0.2
+    tmux send-keys -t "$WINDOW_NAME" "clear" Enter
+
+    # ─── Template: Create Agent Panes ────────────────────────────────────────
+    if [[ ${#TEMPLATE_AGENTS[@]} -gt 0 ]]; then
+        info "Scaffolding ${#TEMPLATE_AGENTS[@]} agent panes..."
+
+        for agent_entry in "${TEMPLATE_AGENTS[@]}"; do
+            IFS='|' read -r aname arole afocus <<< "$agent_entry"
+
+            # Split the window to create a new pane
+            tmux split-window -t "$WINDOW_NAME" -c "#{pane_current_path}"
+            sleep 0.1
+
+            # Force dark theme on agent pane
+            tmux select-pane -t "$WINDOW_NAME" -P 'bg=#1a1a2e,fg=#e4e4e7'
+
+            # Set the pane title to the agent name
+            tmux send-keys -t "$WINDOW_NAME" "printf '\\033]2;${TEAM_NAME}-${aname}\\033\\\\'" Enter
+            sleep 0.1
+            tmux send-keys -t "$WINDOW_NAME" "clear" Enter
+        done
+
+        # Apply the layout from the template (layout_style takes precedence over layout)
+        if [[ -n "$TEMPLATE_LAYOUT_STYLE" ]]; then
+            tmux select-layout -t "$WINDOW_NAME" "$TEMPLATE_LAYOUT_STYLE" 2>/dev/null || \
+                tmux select-layout -t "$WINDOW_NAME" "${TEMPLATE_LAYOUT:-tiled}" 2>/dev/null || true
+        else
+            tmux select-layout -t "$WINDOW_NAME" "${TEMPLATE_LAYOUT:-tiled}" 2>/dev/null || true
+        fi
+
+        # Resize leader pane to desired percentage
+        if [[ -n "$TEMPLATE_MAIN_PANE_PERCENT" && -n "$TEMPLATE_LAYOUT_STYLE" ]]; then
+            case "$TEMPLATE_LAYOUT_STYLE" in
+                main-horizontal) tmux resize-pane -t "$WINDOW_NAME.0" -x "${TEMPLATE_MAIN_PANE_PERCENT}%" 2>/dev/null ;;
+                main-vertical)   tmux resize-pane -t "$WINDOW_NAME.0" -y "${TEMPLATE_MAIN_PANE_PERCENT}%" 2>/dev/null ;;
+            esac
+        fi
+
+        # Select the first pane (leader)
+        tmux select-pane -t "$WINDOW_NAME.0"
+    fi
+
+else
+    # ─── Adapter-based session creation ──────────────────────────────────────
+
+    if type -t spawn_agent &>/dev/null; then
+        info "Creating team session: ${CYAN}${BOLD}${TEAM_NAME}${RESET} ${DIM}(${TERMINAL_ADAPTER})${RESET}"
+
+        # Spawn leader
+        spawn_agent "${TEAM_NAME}-lead" "#{pane_current_path}" ""
+
+        # Spawn template agents if provided
+        if [[ ${#TEMPLATE_AGENTS[@]} -gt 0 ]]; then
+            info "Scaffolding ${#TEMPLATE_AGENTS[@]} agents..."
+            for agent_entry in "${TEMPLATE_AGENTS[@]}"; do
+                IFS='|' read -r aname arole afocus <<< "$agent_entry"
+                spawn_agent "${TEAM_NAME}-${aname}" "#{pane_current_path}" ""
+            done
+        fi
+    else
+        error "Adapter '${TERMINAL_ADAPTER}' loaded but spawn_agent() not found."
+        exit 1
+    fi
+fi
+
+# ─── Summary ────────────────────────────────────────────────────────────────
+
+echo ""
+success "Team session ${CYAN}${BOLD}${TEAM_NAME}${RESET} ready!"
+
+if [[ ${#TEMPLATE_AGENTS[@]} -gt 0 ]]; then
+    echo ""
+    echo -e "${BOLD}Team from template ${PURPLE}${TEMPLATE_NAME}${RESET}${BOLD}:${RESET}"
+    echo -e "  ${CYAN}${BOLD}lead${RESET}  ${DIM}— Team coordinator${RESET}"
+    for agent_entry in "${TEMPLATE_AGENTS[@]}"; do
+        IFS='|' read -r aname arole afocus <<< "$agent_entry"
+        echo -e "  ${PURPLE}${BOLD}${aname}${RESET}  ${DIM}— ${arole}${RESET}"
+    done
+    echo ""
+    echo -e "${BOLD}Next steps:${RESET}"
+    echo -e "  ${CYAN}1.${RESET} Switch to window ${DIM}${WINDOW_NAME}${RESET}"
+    echo -e "  ${CYAN}2.${RESET} Start ${DIM}claude${RESET} in the lead pane (top-left)"
+    echo -e "  ${CYAN}3.${RESET} Ask Claude to use the team — agents are ready in their panes"
+else
+    echo ""
+    echo -e "${BOLD}Next steps:${RESET}"
+    echo -e "  ${CYAN}1.${RESET} Switch to window ${DIM}${WINDOW_NAME}${RESET}  ${DIM}(prefix + $(tmux list-windows -F '#I #W' | grep "$WINDOW_NAME" | cut -d' ' -f1))${RESET}"
+    echo -e "  ${CYAN}2.${RESET} Start Claude Code:"
+    echo -e "     ${DIM}claude${RESET}"
+    echo -e "  ${CYAN}3.${RESET} Ask Claude to create a team:"
+    echo -e "     ${DIM}\"Create a team with 2 agents to refactor the auth module\"${RESET}"
+fi
+
+echo ""
+echo -e "${PURPLE}${BOLD}Tip:${RESET} For file isolation between agents, use git worktrees:"
+echo -e "  ${DIM}git worktree add ../project-${TEAM_NAME} -b ${TEAM_NAME}${RESET}"
+echo -e "  Then launch Claude inside the worktree directory."
+echo ""
+echo -e "${DIM}Settings: ~/.claude/settings.json (see settings.json.template)${RESET}"
+echo -e "${DIM}Keybinding: prefix + T re-runs this command${RESET}"

package/scripts/cct-status.sh

@@ -0,0 +1,169 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  cct-status.sh — Dashboard showing Claude Code team status               ║
+# ║                                                                          ║
+# ║  Shows running teams, agent windows, and task progress.                  ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+set -euo pipefail
+
+# ─── Colors ──────────────────────────────────────────────────────────────────
+CYAN='\033[38;2;0;212;255m'
+PURPLE='\033[38;2;124;58;237m'
+BLUE='\033[38;2;0;102;255m'
+GREEN='\033[38;2;74;222;128m'
+YELLOW='\033[38;2;250;204;21m'
+RED='\033[38;2;248;113;113m'
+DIM='\033[2m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+# ─── Header ──────────────────────────────────────────────────────────────────
+
+echo ""
+echo -e "${CYAN}${BOLD}  Claude Code Teams — Status Dashboard${RESET}"
+echo -e "${DIM}  $(date '+%Y-%m-%d %H:%M:%S')${RESET}"
+echo -e "${DIM}  ══════════════════════════════════════════${RESET}"
+echo ""
+
+# ─── 1. Tmux Windows ────────────────────────────────────────────────────────
+
+echo -e "${PURPLE}${BOLD}  TMUX WINDOWS${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+# Get all windows, highlight Claude-related ones
+HAS_CLAUDE_WINDOWS=false
+while IFS= read -r line; do
+    session_window="$(echo "$line" | cut -d'|' -f1)"
+    window_name="$(echo "$line" | cut -d'|' -f2)"
+    pane_count="$(echo "$line" | cut -d'|' -f3)"
+    active="$(echo "$line" | cut -d'|' -f4)"
+
+    if echo "$window_name" | grep -qi "claude"; then
+        HAS_CLAUDE_WINDOWS=true
+        if [[ "$active" == "1" ]]; then
+            status_icon="${GREEN}●${RESET}"
+            status_label="${GREEN}active${RESET}"
+        else
+            status_icon="${YELLOW}●${RESET}"
+            status_label="${YELLOW}idle${RESET}"
+        fi
+        echo -e "  ${status_icon} ${BOLD}${window_name}${RESET}  ${DIM}${session_window}${RESET}  panes:${pane_count}  ${status_label}"
+    fi
+done < <(tmux list-windows -a -F '#{session_name}:#{window_index}|#{window_name}|#{window_panes}|#{window_active}' 2>/dev/null || true)
+
+if ! $HAS_CLAUDE_WINDOWS; then
+    echo -e "  ${DIM}No Claude team windows found.${RESET}"
+    echo -e "  ${DIM}Start one with: ${CYAN}shipwright session <name>${RESET}"
+fi
+
+# ─── 2. Team Configurations ─────────────────────────────────────────────────
+
+echo ""
+echo -e "${PURPLE}${BOLD}  TEAM CONFIGS${RESET}  ${DIM}~/.claude/teams/${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+TEAMS_DIR="${HOME}/.claude/teams"
+HAS_TEAMS=false
+
+if [[ -d "$TEAMS_DIR" ]]; then
+    while IFS= read -r team_dir; do
+        [[ -z "$team_dir" ]] && continue
+        HAS_TEAMS=true
+        team_name="$(basename "$team_dir")"
+
+        # Try to read config.json for member info
+        config_file="${team_dir}/config.json"
+        if [[ -f "$config_file" ]]; then
+            # Count members from JSON (look for "name" keys in members array)
+            member_count=$(grep -c '"name"' "$config_file" 2>/dev/null || true)
+            member_count="${member_count:-0}"
+            # Extract member names
+            member_names=$(grep '"name"' "$config_file" 2>/dev/null | sed 's/.*"name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/' | tr '\n' ', ' | sed 's/,$//' | sed 's/,/, /g')
+
+            echo -e "  ${GREEN}●${RESET} ${BOLD}${team_name}${RESET}  ${DIM}members:${member_count}${RESET}"
+            if [[ -n "$member_names" ]]; then
+                echo -e "    ${DIM}└─ ${member_names}${RESET}"
+            fi
+        else
+            # Directory exists but no config — possibly orphaned
+            echo -e "  ${RED}●${RESET} ${BOLD}${team_name}${RESET}  ${DIM}(no config — possibly orphaned)${RESET}"
+        fi
+    done < <(find "$TEAMS_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+fi
+
+if ! $HAS_TEAMS; then
+    echo -e "  ${DIM}No team configs found.${RESET}"
+fi
+
+# ─── 3. Task Lists ──────────────────────────────────────────────────────────
+
+echo ""
+echo -e "${PURPLE}${BOLD}  TASK LISTS${RESET}  ${DIM}~/.claude/tasks/${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+TASKS_DIR="${HOME}/.claude/tasks"
+HAS_TASKS=false
+
+if [[ -d "$TASKS_DIR" ]]; then
+    while IFS= read -r task_dir; do
+        [[ -z "$task_dir" ]] && continue
+        HAS_TASKS=true
+        task_team="$(basename "$task_dir")"
+
+        # Count tasks by status
+        total=0
+        completed=0
+        in_progress=0
+        pending=0
+
+        while IFS= read -r task_file; do
+            [[ -z "$task_file" ]] && continue
+            total=$((total + 1))
+            status=$(grep -o '"status"[[:space:]]*:[[:space:]]*"[^"]*"' "$task_file" 2>/dev/null | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+            case "$status" in
+                completed)   completed=$((completed + 1)) ;;
+                in_progress) in_progress=$((in_progress + 1)) ;;
+                pending)     pending=$((pending + 1)) ;;
+            esac
+        done < <(find "$task_dir" -type f -name '*.json' 2>/dev/null)
+
+        # Build progress bar
+        if [[ $total -gt 0 ]]; then
+            pct=$((completed * 100 / total))
+            bar_width=20
+            filled=$((pct * bar_width / 100))
+            empty=$((bar_width - filled))
+            bar="${GREEN}"
+            for ((i=0; i<filled; i++)); do bar+="█"; done
+            bar+="${DIM}"
+            for ((i=0; i<empty; i++)); do bar+="░"; done
+            bar+="${RESET}"
+
+            echo -e "  ${BLUE}●${RESET} ${BOLD}${task_team}${RESET}  ${bar} ${pct}%  ${DIM}(${completed}/${total} done)${RESET}"
+
+            # Show breakdown if there are active tasks
+            details=""
+            [[ $in_progress -gt 0 ]] && details+="${GREEN}${in_progress} active${RESET}  "
+            [[ $pending -gt 0 ]]     && details+="${YELLOW}${pending} pending${RESET}  "
+            [[ $completed -gt 0 ]]   && details+="${DIM}${completed} done${RESET}"
+            [[ -n "$details" ]] && echo -e "    ${DIM}└─${RESET} ${details}"
+        else
+            echo -e "  ${DIM}●${RESET} ${BOLD}${task_team}${RESET}  ${DIM}(no tasks)${RESET}"
+        fi
+    done < <(find "$TASKS_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+fi
+
+if ! $HAS_TASKS; then
+    echo -e "  ${DIM}No task lists found.${RESET}"
+fi
+
+# ─── Footer ──────────────────────────────────────────────────────────────────
+
+echo ""
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+if $HAS_CLAUDE_WINDOWS || $HAS_TEAMS || $HAS_TASKS; then
+    echo -e "  ${DIM}Clean up:${RESET} ${CYAN}shipwright cleanup${RESET}  ${DIM}|${RESET}  ${DIM}New session:${RESET} ${CYAN}shipwright session <name>${RESET}"
+else
+    echo -e "  ${DIM}No active teams. Start one:${RESET} ${CYAN}shipwright session <name>${RESET}"
+fi
+echo ""