shipwright-cli 1.7.0

package/scripts/cct-doctor.sh

@@ -0,0 +1,328 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  cct-doctor.sh — Validate Claude Code Teams setup                       ║
+# ║                                                                          ║
+# ║  Checks prerequisites, installed files, PATH, and common issues.        ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+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'
+
+# ─── Helpers ─────────────────────────────────────────────────────────────────
+info()    { echo -e "${CYAN}${BOLD}▸${RESET} $*"; }
+success() { echo -e "${GREEN}${BOLD}✓${RESET} $*"; }
+warn()    { echo -e "${YELLOW}${BOLD}⚠${RESET} $*"; }
+error()   { echo -e "${RED}${BOLD}✗${RESET} $*"; }
+
+PASS=0
+WARN=0
+FAIL=0
+
+check_pass() { success "$*"; PASS=$((PASS + 1)); }
+check_warn() { warn "$*"; WARN=$((WARN + 1)); }
+check_fail() { error "$*"; FAIL=$((FAIL + 1)); }
+
+# ─── Header ─────────────────────────────────────────────────────────────────
+echo ""
+echo -e "${CYAN}${BOLD}  Claude Code Teams — Doctor${RESET}"
+echo -e "${DIM}  $(date '+%Y-%m-%d %H:%M:%S')${RESET}"
+echo -e "${DIM}  ══════════════════════════════════════════${RESET}"
+echo ""
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 1. Prerequisites
+# ═════════════════════════════════════════════════════════════════════════════
+echo -e "${PURPLE}${BOLD}  PREREQUISITES${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+# tmux
+if command -v tmux &>/dev/null; then
+    TMUX_VERSION="$(tmux -V | grep -oE '[0-9]+\.[0-9a-z]+')"
+    TMUX_MAJOR="$(echo "$TMUX_VERSION" | cut -d. -f1)"
+    TMUX_MINOR="$(echo "$TMUX_VERSION" | cut -d. -f2 | tr -dc '0-9')"
+    if [[ "$TMUX_MAJOR" -ge 3 && "$TMUX_MINOR" -ge 2 ]] || [[ "$TMUX_MAJOR" -ge 4 ]]; then
+        check_pass "tmux ${TMUX_VERSION}"
+    else
+        check_warn "tmux ${TMUX_VERSION} — 3.2+ recommended for pane-border-format"
+    fi
+else
+    check_fail "tmux not installed"
+    echo -e "    ${DIM}brew install tmux  (macOS)${RESET}"
+    echo -e "    ${DIM}sudo apt install tmux  (Ubuntu/Debian)${RESET}"
+fi
+
+# jq
+if command -v jq &>/dev/null; then
+    check_pass "jq $(jq --version 2>&1 | tr -d 'jq-')"
+else
+    check_fail "jq not installed — required for template parsing"
+    echo -e "    ${DIM}brew install jq${RESET}  (macOS)"
+    echo -e "    ${DIM}sudo apt install jq${RESET}  (Ubuntu/Debian)"
+fi
+
+# Claude Code CLI
+if command -v claude &>/dev/null; then
+    check_pass "Claude Code CLI found"
+else
+    check_fail "Claude Code CLI not found"
+    echo -e "    ${DIM}npm install -g @anthropic-ai/claude-code${RESET}"
+fi
+
+# Node.js
+if command -v node &>/dev/null; then
+    NODE_VERSION="$(node -v | tr -d 'v')"
+    NODE_MAJOR="$(echo "$NODE_VERSION" | cut -d. -f1)"
+    if [[ "$NODE_MAJOR" -ge 20 ]]; then
+        check_pass "Node.js ${NODE_VERSION}"
+    else
+        check_warn "Node.js ${NODE_VERSION} — 20+ recommended"
+    fi
+else
+    check_fail "Node.js not found"
+fi
+
+# Git
+if command -v git &>/dev/null; then
+    check_pass "git $(git --version | grep -oE '[0-9]+\.[0-9]+\.[0-9]+')"
+else
+    check_fail "git not found"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 2. Installed Files
+# ═════════════════════════════════════════════════════════════════════════════
+echo ""
+echo -e "${PURPLE}${BOLD}  INSTALLED FILES${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+# tmux overlay
+if [[ -f "$HOME/.tmux/claude-teams-overlay.conf" ]]; then
+    check_pass "Overlay: ~/.tmux/claude-teams-overlay.conf"
+else
+    check_fail "Overlay not found: ~/.tmux/claude-teams-overlay.conf"
+    echo -e "    ${DIM}Re-run install.sh to install it${RESET}"
+fi
+
+# Overlay sourced in tmux.conf
+if [[ -f "$HOME/.tmux.conf" ]]; then
+    if grep -q "claude-teams-overlay" "$HOME/.tmux.conf" 2>/dev/null; then
+        check_pass "Overlay sourced in ~/.tmux.conf"
+    else
+        check_warn "Overlay not sourced in ~/.tmux.conf"
+        echo -e "    ${DIM}Add: source-file -q ~/.tmux/claude-teams-overlay.conf${RESET}"
+    fi
+else
+    check_warn "No ~/.tmux.conf found"
+fi
+
+# Claude settings
+if [[ -f "$HOME/.claude/settings.json" ]]; then
+    check_pass "Settings: ~/.claude/settings.json"
+else
+    check_warn "No ~/.claude/settings.json"
+    echo -e "    ${DIM}Copy from settings.json.template${RESET}"
+fi
+
+# Hooks directory
+HOOKS_DIR="$HOME/.claude/hooks"
+if [[ -d "$HOOKS_DIR" ]]; then
+    hook_count=0
+    non_exec=0
+    while IFS= read -r hook; do
+        [[ -z "$hook" ]] && continue
+        hook_count=$((hook_count + 1))
+        if [[ ! -x "$hook" ]]; then
+            non_exec=$((non_exec + 1))
+        fi
+    done < <(find "$HOOKS_DIR" -maxdepth 1 -name '*.sh' -type f 2>/dev/null)
+
+    if [[ $hook_count -gt 0 && $non_exec -eq 0 ]]; then
+        check_pass "Hooks: ${hook_count} scripts, all executable"
+    elif [[ $hook_count -gt 0 && $non_exec -gt 0 ]]; then
+        check_warn "Hooks: ${non_exec}/${hook_count} scripts not executable"
+        echo -e "    ${DIM}chmod +x ~/.claude/hooks/*.sh${RESET}"
+    else
+        check_warn "Hooks dir exists but no .sh scripts found"
+    fi
+else
+    check_warn "No hooks directory at ~/.claude/hooks/"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 3. PATH & CLI
+# ═════════════════════════════════════════════════════════════════════════════
+echo ""
+echo -e "${PURPLE}${BOLD}  PATH & CLI${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+BIN_DIR="$HOME/.local/bin"
+
+if echo "$PATH" | tr ':' '\n' | grep -q "$BIN_DIR"; then
+    check_pass "${BIN_DIR} is in PATH"
+else
+    check_warn "${BIN_DIR} is NOT in PATH"
+    echo -e "    ${DIM}Add to ~/.zshrc or ~/.bashrc:${RESET}"
+    echo -e "    ${DIM}export PATH=\"\$HOME/.local/bin:\$PATH\"${RESET}"
+fi
+
+# Check cct subcommands are installed alongside the router
+if command -v cct &>/dev/null; then
+    CCT_DIR="$(dirname "$(command -v cct)")"
+    check_pass "shipwright router found at ${CCT_DIR}/cct"
+
+    missing_subs=()
+    for sub in cct-session.sh cct-status.sh cct-cleanup.sh; do
+        if [[ ! -x "${CCT_DIR}/${sub}" ]]; then
+            missing_subs+=("$sub")
+        fi
+    done
+
+    if [[ ${#missing_subs[@]} -eq 0 ]]; then
+        check_pass "All core subcommands installed"
+    else
+        check_warn "Missing subcommands: ${missing_subs[*]}"
+        echo -e "    ${DIM}Re-run install.sh or shipwright upgrade --apply${RESET}"
+    fi
+else
+    check_fail "shipwright command not found in PATH"
+    echo -e "    ${DIM}Re-run install.sh to install the CLI${RESET}"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 4. Pane Display
+# ═════════════════════════════════════════════════════════════════════════════
+echo ""
+echo -e "${PURPLE}${BOLD}  PANE DISPLAY${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+# Check overlay file exists
+if [[ -f "$HOME/.tmux/claude-teams-overlay.conf" ]]; then
+    # Check for set-hook color enforcement
+    if grep -q "set-hook.*after-split-window" "$HOME/.tmux/claude-teams-overlay.conf" 2>/dev/null; then
+        check_pass "Overlay has color hooks (set-hook)"
+    else
+        check_warn "Overlay missing color hooks — new panes may flash white"
+        echo -e "    ${DIM}Run: shipwright upgrade --apply  or  shipwright init${RESET}"
+    fi
+else
+    check_fail "Overlay not found — pane display features unavailable"
+fi
+
+# Check if set-hook commands are active in tmux
+if [[ -n "${TMUX:-}" ]]; then
+    if tmux show-hooks -g 2>/dev/null | grep -q "after-split-window"; then
+        check_pass "set-hook commands active in tmux"
+    else
+        check_warn "set-hook commands not active — reload config: prefix + r"
+    fi
+
+    # Check default-terminal
+    TMUX_TERM="$(tmux show-option -gv default-terminal 2>/dev/null || echo "unknown")"
+    if [[ "$TMUX_TERM" == *"256color"* ]]; then
+        check_pass "default-terminal: $TMUX_TERM"
+    else
+        check_warn "default-terminal: $TMUX_TERM — 256color variant recommended"
+        echo -e "    ${DIM}set -g default-terminal 'tmux-256color'${RESET}"
+    fi
+
+    # Check pane border includes cyan accent
+    BORDER_FMT="$(tmux show-option -gv pane-border-format 2>/dev/null || echo "")"
+    if echo "$BORDER_FMT" | grep -q "#00d4ff"; then
+        check_pass "Pane border format includes cyan accent"
+    else
+        check_warn "Pane border format missing cyan accent — overlay may not be loaded"
+    fi
+else
+    info "Not in tmux session — skipping runtime display checks"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 5. Orphaned Sessions
+# ═════════════════════════════════════════════════════════════════════════════
+echo ""
+echo -e "${PURPLE}${BOLD}  ORPHAN CHECK${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+orphaned_teams=0
+TEAMS_DIR="$HOME/.claude/teams"
+if [[ -d "$TEAMS_DIR" ]]; then
+    while IFS= read -r team_dir; do
+        [[ -z "$team_dir" ]] && continue
+        team_name="$(basename "$team_dir")"
+        config_file="${team_dir}/config.json"
+        if [[ ! -f "$config_file" ]]; then
+            orphaned_teams=$((orphaned_teams + 1))
+            check_warn "Orphaned team dir: ${team_name} (no config.json)"
+        fi
+    done < <(find "$TEAMS_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null)
+fi
+
+if [[ $orphaned_teams -eq 0 ]]; then
+    check_pass "No orphaned team sessions"
+fi
+
+# ═════════════════════════════════════════════════════════════════════════════
+# 6. Terminal Compatibility
+# ═════════════════════════════════════════════════════════════════════════════
+echo ""
+echo -e "${PURPLE}${BOLD}  TERMINAL${RESET}"
+echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+
+TERM_PROGRAM="${TERM_PROGRAM:-unknown}"
+
+case "$TERM_PROGRAM" in
+    iTerm.app|iTerm2)
+        check_pass "iTerm2 — full support"
+        ;;
+    Apple_Terminal)
+        check_pass "Terminal.app — supported"
+        ;;
+    WezTerm)
+        check_pass "WezTerm — full support"
+        ;;
+    tmux)
+        check_pass "Running inside tmux (nested)"
+        ;;
+    vscode)
+        check_warn "VS Code integrated terminal"
+        echo -e "    ${DIM}Some pane border features may not render correctly.${RESET}"
+        echo -e "    ${DIM}Consider running tmux in an external terminal.${RESET}"
+        ;;
+    Ghostty)
+        check_warn "Ghostty — may have tmux rendering quirks"
+        echo -e "    ${DIM}If pane borders look wrong, try: set -g default-terminal 'xterm-256color'${RESET}"
+        ;;
+    *)
+        info "Terminal: ${TERM_PROGRAM}"
+        ;;
+esac
+
+# ═════════════════════════════════════════════════════════════════════════════
+# Summary
+# ═════════════════════════════════════════════════════════════════════════════
+echo ""
+echo -e "${DIM}  ══════════════════════════════════════════${RESET}"
+echo ""
+
+TOTAL=$((PASS + WARN + FAIL))
+
+echo -e "  ${GREEN}${BOLD}${PASS}${RESET} passed  ${YELLOW}${BOLD}${WARN}${RESET} warnings  ${RED}${BOLD}${FAIL}${RESET} failed  ${DIM}(${TOTAL} checks)${RESET}"
+echo ""
+
+if [[ $FAIL -gt 0 ]]; then
+    error "Some checks failed. Fix the issues above and re-run ${CYAN}shipwright doctor${RESET}"
+elif [[ $WARN -gt 0 ]]; then
+    warn "Setup mostly OK, but there are warnings above"
+else
+    success "Everything looks good!"
+fi
+echo ""