shipwright-cli 1.7.0

package/scripts/cct-init.sh

@@ -0,0 +1,282 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  shipwright init — One-command tmux setup + optional deploy configuration      ║
+# ║                                                                          ║
+# ║  Installs tmux config, overlay, and templates. No interactive prompts,  ║
+# ║  no hooks, no Claude Code settings — just tmux config.                  ║
+# ║                                                                          ║
+# ║  --deploy  Detect platform and generate deployed.json template          ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+ADAPTERS_DIR="$SCRIPT_DIR/adapters"
+
+# ─── Colors ──────────────────────────────────────────────────────────────────
+CYAN='\033[38;2;0;212;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'
+
+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; }
+
+# ─── Flag parsing ───────────────────────────────────────────────────────────
+DEPLOY_SETUP=false
+DEPLOY_PLATFORM=""
+SKIP_CLAUDE_MD=false
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --deploy)
+            DEPLOY_SETUP=true
+            shift
+            ;;
+        --platform)
+            DEPLOY_PLATFORM="${2:-}"
+            [[ -z "$DEPLOY_PLATFORM" ]] && { error "Missing value for --platform"; exit 1; }
+            shift 2
+            ;;
+        --no-claude-md)
+            SKIP_CLAUDE_MD=true
+            shift
+            ;;
+        --help|-h)
+            echo "Usage: shipwright init [--deploy] [--platform vercel|fly|railway|docker] [--no-claude-md]"
+            echo ""
+            echo "Options:"
+            echo "  --deploy             Detect deploy platform and generate deployed.json"
+            echo "  --platform PLATFORM  Skip detection, use specified platform"
+            echo "  --no-claude-md       Skip creating .claude/CLAUDE.md"
+            echo "  --help, -h           Show this help"
+            exit 0
+            ;;
+        *)
+            warn "Unknown option: $1"
+            shift
+            ;;
+    esac
+done
+
+echo ""
+echo -e "${CYAN}${BOLD}shipwright init${RESET} — Quick tmux setup"
+echo -e "${DIM}══════════════════════════════════════════${RESET}"
+echo ""
+
+# ─── tmux.conf ────────────────────────────────────────────────────────────────
+if [[ -f "$HOME/.tmux.conf" ]]; then
+    cp "$HOME/.tmux.conf" "$HOME/.tmux.conf.bak"
+    warn "Backed up existing ~/.tmux.conf → ~/.tmux.conf.bak"
+fi
+cp "$REPO_DIR/tmux/tmux.conf" "$HOME/.tmux.conf"
+success "Installed ~/.tmux.conf"
+
+# ─── Overlay ──────────────────────────────────────────────────────────────────
+mkdir -p "$HOME/.tmux"
+cp "$REPO_DIR/tmux/claude-teams-overlay.conf" "$HOME/.tmux/claude-teams-overlay.conf"
+success "Installed ~/.tmux/claude-teams-overlay.conf"
+
+# ─── Templates ────────────────────────────────────────────────────────────────
+mkdir -p "$HOME/.claude-teams/templates"
+for tpl in "$REPO_DIR"/tmux/templates/*.json; do
+    [[ -f "$tpl" ]] || continue
+    cp "$tpl" "$HOME/.claude-teams/templates/$(basename "$tpl")"
+done
+success "Installed templates → ~/.claude-teams/templates/"
+
+# ─── CLAUDE.md — Agent instructions ──────────────────────────────────────────
+CLAUDE_MD_SRC="$REPO_DIR/claude-code/CLAUDE.md.shipwright"
+CLAUDE_MD_DST=".claude/CLAUDE.md"
+
+if [[ "$SKIP_CLAUDE_MD" == "false" && -f "$CLAUDE_MD_SRC" ]]; then
+    if [[ -f "$CLAUDE_MD_DST" ]]; then
+        # Check if it already contains Shipwright instructions
+        if grep -q "Shipwright" "$CLAUDE_MD_DST" 2>/dev/null; then
+            info "CLAUDE.md already contains Shipwright instructions — skipping"
+        else
+            # Append Shipwright section to existing CLAUDE.md
+            {
+                echo ""
+                echo "---"
+                echo ""
+                cat "$CLAUDE_MD_SRC"
+            } >> "$CLAUDE_MD_DST"
+            success "Appended Shipwright instructions to ${CLAUDE_MD_DST}"
+        fi
+    else
+        mkdir -p ".claude"
+        cp "$CLAUDE_MD_SRC" "$CLAUDE_MD_DST"
+        success "Created ${CLAUDE_MD_DST} with Shipwright agent instructions"
+    fi
+fi
+
+# ─── Reload tmux if inside a session ──────────────────────────────────────────
+if [[ -n "${TMUX:-}" ]]; then
+    tmux source-file "$HOME/.tmux.conf" 2>/dev/null && \
+        success "Reloaded tmux config" || \
+        warn "Could not reload tmux config (reload manually with prefix + r)"
+fi
+
+# ─── Quick-start instructions ─────────────────────────────────────────────────
+echo ""
+echo -e "${BOLD}Done!${RESET} tmux is configured for Claude Code Teams."
+echo ""
+echo -e "${BOLD}Quick start:${RESET}"
+if [[ -z "${TMUX:-}" ]]; then
+    echo -e "  ${DIM}1.${RESET} tmux new -s dev"
+    echo -e "  ${DIM}2.${RESET} shipwright session my-feature --template feature-dev"
+else
+    echo -e "  ${DIM}1.${RESET} shipwright session my-feature --template feature-dev"
+fi
+echo ""
+echo -e "${BOLD}Layout keybindings:${RESET}"
+echo -e "  ${CYAN}prefix + M-1${RESET}  main-horizontal (leader 65% left)"
+echo -e "  ${CYAN}prefix + M-2${RESET}  main-vertical (leader 60% top)"
+echo -e "  ${CYAN}prefix + M-3${RESET}  tiled (equal sizes)"
+echo ""
+
+# ─── Deploy setup (--deploy) ─────────────────────────────────────────────────
+[[ "$DEPLOY_SETUP" == "false" ]] && exit 0
+
+echo -e "${CYAN}${BOLD}Deploy Setup${RESET}"
+echo -e "${DIM}══════════════════════════════════════════${RESET}"
+echo ""
+
+# Platform detection
+detect_deploy_platform() {
+    local detected=""
+
+    for adapter_file in "$ADAPTERS_DIR"/*-deploy.sh; do
+        [[ -f "$adapter_file" ]] || continue
+        # Source the adapter in a subshell to get detection
+        if ( source "$adapter_file" && detect_platform ); then
+            local name
+            name=$(basename "$adapter_file" | sed 's/-deploy\.sh$//')
+            if [[ -n "$detected" ]]; then
+                detected="$detected $name"
+            else
+                detected="$name"
+            fi
+        fi
+    done
+
+    echo "$detected"
+}
+
+if [[ -n "$DEPLOY_PLATFORM" ]]; then
+    # User specified --platform, validate it
+    if [[ ! -f "$ADAPTERS_DIR/${DEPLOY_PLATFORM}-deploy.sh" ]]; then
+        error "Unknown platform: $DEPLOY_PLATFORM"
+        echo -e "  Available: vercel, fly, railway, docker"
+        exit 1
+    fi
+    info "Using specified platform: ${BOLD}${DEPLOY_PLATFORM}${RESET}"
+else
+    info "Detecting deploy platform..."
+    detected=$(detect_deploy_platform)
+
+    if [[ -z "$detected" ]]; then
+        warn "No platform detected in current directory"
+        echo ""
+        echo -e "  Supported platforms:"
+        echo -e "    ${CYAN}vercel${RESET}   — vercel.json or .vercel/"
+        echo -e "    ${CYAN}fly${RESET}      — fly.toml"
+        echo -e "    ${CYAN}railway${RESET}  — railway.toml or .railway/"
+        echo -e "    ${CYAN}docker${RESET}   — Dockerfile or docker-compose.yml"
+        echo ""
+        echo -e "  Specify manually: ${DIM}shipwright init --deploy --platform vercel${RESET}"
+        exit 1
+    fi
+
+    # If multiple platforms detected, use the first and warn
+    platform_count=$(echo "$detected" | wc -w | tr -d ' ')
+    DEPLOY_PLATFORM=$(echo "$detected" | awk '{print $1}')
+
+    if [[ "$platform_count" -gt 1 ]]; then
+        warn "Multiple platforms detected: ${BOLD}${detected}${RESET}"
+        info "Using: ${BOLD}${DEPLOY_PLATFORM}${RESET}"
+        echo -e "  ${DIM}Override with: shipwright init --deploy --platform <name>${RESET}"
+        echo ""
+    else
+        success "Detected platform: ${BOLD}${DEPLOY_PLATFORM}${RESET}"
+    fi
+
+    # Confirm with user
+    read -rp "$(echo -e "${CYAN}${BOLD}▸${RESET} Configure deploy for ${BOLD}${DEPLOY_PLATFORM}${RESET}? [Y/n] ")" confirm
+    if [[ "${confirm,,}" == "n" ]]; then
+        info "Aborted. Use --platform to specify manually."
+        exit 0
+    fi
+fi
+
+# Source the adapter to get command values
+ADAPTER_FILE="$ADAPTERS_DIR/${DEPLOY_PLATFORM}-deploy.sh"
+source "$ADAPTER_FILE"
+
+staging_cmd=$(get_staging_cmd)
+production_cmd=$(get_production_cmd)
+rollback_cmd=$(get_rollback_cmd)
+health_url=$(get_health_url)
+smoke_cmd=$(get_smoke_cmd)
+
+# Generate deployed.json from template
+TEMPLATE_SRC="$REPO_DIR/templates/pipelines/deployed.json"
+TEMPLATE_DST=".claude/pipeline-templates/deployed.json"
+
+if [[ ! -f "$TEMPLATE_SRC" ]]; then
+    error "Template not found: $TEMPLATE_SRC"
+    exit 1
+fi
+
+mkdir -p ".claude/pipeline-templates"
+
+# Use jq to properly fill in the template values
+jq --arg staging "$staging_cmd" \
+   --arg production "$production_cmd" \
+   --arg rollback "$rollback_cmd" \
+   --arg health "$health_url" \
+   --arg smoke "$smoke_cmd" \
+   --arg platform "$DEPLOY_PLATFORM" \
+   '
+   .name = "deployed-" + $platform |
+   .description = "Autonomous pipeline with " + $platform + " deploy — generated by shipwright init --deploy" |
+   (.stages[] | select(.id == "deploy") | .config) |= {
+       staging_cmd: $staging,
+       production_cmd: $production,
+       rollback_cmd: $rollback
+   } |
+   (.stages[] | select(.id == "validate") | .config) |= {
+       smoke_cmd: $smoke,
+       health_url: $health,
+       close_issue: true
+   } |
+   (.stages[] | select(.id == "monitor") | .config) |= (
+       .health_url = $health |
+       .rollback_cmd = $rollback
+   )
+   ' "$TEMPLATE_SRC" > "$TEMPLATE_DST"
+
+success "Generated ${BOLD}${TEMPLATE_DST}${RESET}"
+
+echo ""
+echo -e "${BOLD}Deploy configured for ${DEPLOY_PLATFORM}!${RESET}"
+echo ""
+echo -e "${BOLD}Commands configured:${RESET}"
+echo -e "  ${DIM}staging:${RESET}    $staging_cmd"
+echo -e "  ${DIM}production:${RESET} $production_cmd"
+echo -e "  ${DIM}rollback:${RESET}   $rollback_cmd"
+if [[ -n "$health_url" ]]; then
+    echo -e "  ${DIM}health:${RESET}     $health_url"
+fi
+echo ""
+echo -e "${BOLD}Usage:${RESET}"
+echo -e "  ${DIM}shipwright pipeline start --issue 42 --template .claude/pipeline-templates/deployed.json${RESET}"
+echo ""
+echo -e "${DIM}Edit ${TEMPLATE_DST} to customize deploy commands, gates, or thresholds.${RESET}"
+echo ""

package/scripts/cct-logs.sh

@@ -0,0 +1,273 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  cct-logs.sh — View and search agent pane logs                          ║
+# ║                                                                          ║
+# ║  Captures tmux pane scrollback and provides log browsing/search.        ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+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} $*" >&2; }
+
+LOGS_DIR="$HOME/.claude-teams/logs"
+
+show_usage() {
+    echo -e "${CYAN}${BOLD}shipwright logs${RESET} — View agent pane logs"
+    echo ""
+    echo -e "${BOLD}USAGE${RESET}"
+    echo -e "  ${CYAN}shipwright logs${RESET}                              List available log directories"
+    echo -e "  ${CYAN}shipwright logs${RESET} <team>                       Show logs for a team (captures live)"
+    echo -e "  ${CYAN}shipwright logs${RESET} <team> ${DIM}--pane <agent>${RESET}         Show specific agent's log"
+    echo -e "  ${CYAN}shipwright logs${RESET} <team> ${DIM}--follow${RESET}              Tail logs in real-time"
+    echo -e "  ${CYAN}shipwright logs${RESET} <team> ${DIM}--grep <pattern>${RESET}      Search logs for a pattern"
+    echo -e "  ${CYAN}shipwright logs${RESET} ${DIM}--capture${RESET}                    Capture all team pane scrollback now"
+    echo ""
+    echo -e "${BOLD}OPTIONS${RESET}"
+    echo -e "  ${DIM}--pane <name>${RESET}     Filter to a specific agent pane by title"
+    echo -e "  ${DIM}--follow, -f${RESET}      Tail the most recent log file"
+    echo -e "  ${DIM}--grep <pat>${RESET}      Search across log files with a pattern"
+    echo -e "  ${DIM}--capture${RESET}         Capture current scrollback from all team panes"
+    echo ""
+}
+
+# ─── Capture scrollback from all claude-* windows ────────────────────────────
+capture_logs() {
+    local timestamp
+    timestamp="$(date +%Y%m%d-%H%M%S)"
+    local captured=0
+
+    while IFS='|' read -r session_window window_name pane_id pane_title; do
+        [[ -z "$window_name" ]] && continue
+        echo "$window_name" | grep -qi "claude" || continue
+
+        # Sanitize names for filesystem
+        local safe_window safe_title
+        safe_window="$(echo "$window_name" | tr '/' '-')"
+        safe_title="$(echo "${pane_title:-pane-$pane_id}" | tr '/' '-')"
+
+        local log_dir="${LOGS_DIR}/${safe_window}"
+        mkdir -p "$log_dir"
+
+        local log_file="${log_dir}/${safe_title}-${timestamp}.log"
+        tmux capture-pane -t "$pane_id" -pS - > "$log_file" 2>/dev/null || continue
+        captured=$((captured + 1))
+    done < <(tmux list-panes -a -F '#{session_name}:#{window_index}|#{window_name}|#{pane_id}|#{pane_title}' 2>/dev/null || true)
+
+    if [[ $captured -gt 0 ]]; then
+        success "Captured ${captured} pane(s) to ${LOGS_DIR}/"
+    else
+        warn "No Claude team panes found to capture"
+    fi
+}
+
+# ─── List available logs ────────────────────────────────────────────────────
+list_logs() {
+    echo ""
+    echo -e "${CYAN}${BOLD}  Agent Logs${RESET}"
+    echo -e "${DIM}  ══════════════════════════════════════════${RESET}"
+    echo ""
+
+    if [[ ! -d "$LOGS_DIR" ]]; then
+        echo -e "  ${DIM}No logs directory yet.${RESET}"
+        echo -e "  ${DIM}Capture logs with: ${CYAN}shipwright logs --capture${RESET}"
+        echo ""
+        return
+    fi
+
+    local has_logs=false
+    while IFS= read -r team_dir; do
+        [[ -z "$team_dir" ]] && continue
+        has_logs=true
+        local team_name
+        team_name="$(basename "$team_dir")"
+        local file_count
+        file_count="$(find "$team_dir" -name '*.log' -type f 2>/dev/null | wc -l | tr -d ' ')"
+        local latest=""
+        latest="$(find "$team_dir" -name '*.log' -type f -print0 2>/dev/null | xargs -0 ls -t 2>/dev/null | head -1)"
+        local latest_time=""
+        if [[ -n "$latest" ]]; then
+            latest_time="$(stat -f '%Sm' -t '%Y-%m-%d %H:%M' "$latest" 2>/dev/null || stat --format='%y' "$latest" 2>/dev/null | cut -d. -f1)"
+        fi
+
+        echo -e "  ${BLUE}●${RESET} ${BOLD}${team_name}${RESET}  ${DIM}${file_count} logs${RESET}"
+        if [[ -n "$latest_time" ]]; then
+            echo -e "    ${DIM}└─ latest: ${latest_time}${RESET}"
+        fi
+    done < <(find "$LOGS_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+    if ! $has_logs; then
+        echo -e "  ${DIM}No log directories found.${RESET}"
+        echo -e "  ${DIM}Capture logs with: ${CYAN}shipwright logs --capture${RESET}"
+    fi
+    echo ""
+}
+
+# ─── Show logs for a team ────────────────────────────────────────────────────
+show_team_logs() {
+    local team="$1"
+    local pane_filter="${2:-}"
+    local grep_pattern="${3:-}"
+    local follow="${4:-false}"
+
+    # Try exact match first, then prefix match on claude-*
+    local team_dir="${LOGS_DIR}/${team}"
+    if [[ ! -d "$team_dir" ]]; then
+        team_dir="${LOGS_DIR}/claude-${team}"
+    fi
+
+    if [[ ! -d "$team_dir" ]]; then
+        # Capture live first if no logs exist
+        info "No saved logs for '${team}'. Capturing live scrollback..."
+        capture_logs
+
+        # Re-check
+        team_dir="${LOGS_DIR}/${team}"
+        [[ ! -d "$team_dir" ]] && team_dir="${LOGS_DIR}/claude-${team}"
+        if [[ ! -d "$team_dir" ]]; then
+            error "No team panes matching '${team}' found"
+            exit 1
+        fi
+    fi
+
+    local team_name
+    team_name="$(basename "$team_dir")"
+
+    echo ""
+    echo -e "${CYAN}${BOLD}  Logs — ${team_name}${RESET}"
+    echo -e "${DIM}  ══════════════════════════════════════════${RESET}"
+    echo ""
+
+    # Build file list, optionally filtered by pane
+    local log_files=()
+    while IFS= read -r f; do
+        [[ -z "$f" ]] && continue
+        if [[ -n "$pane_filter" ]]; then
+            local base
+            base="$(basename "$f")"
+            echo "$base" | grep -qi "$pane_filter" || continue
+        fi
+        log_files+=("$f")
+    done < <(find "$team_dir" -name '*.log' -type f -print0 2>/dev/null | xargs -0 ls -t 2>/dev/null)
+
+    if [[ ${#log_files[@]} -eq 0 ]]; then
+        if [[ -n "$pane_filter" ]]; then
+            warn "No logs matching pane '${pane_filter}' in ${team_name}"
+        else
+            warn "No log files in ${team_name}"
+        fi
+        return
+    fi
+
+    # --follow: tail the most recent file
+    if [[ "$follow" == "true" ]]; then
+        local latest="${log_files[0]}"
+        info "Tailing: $(basename "$latest")"
+        echo -e "${DIM}  (Ctrl+C to stop)${RESET}"
+        echo ""
+        tail -f "$latest"
+        return
+    fi
+
+    # --grep: search across all files
+    if [[ -n "$grep_pattern" ]]; then
+        info "Searching for '${grep_pattern}' in ${#log_files[@]} log file(s)..."
+        echo ""
+        local found=false
+        for f in "${log_files[@]}"; do
+            local matches
+            matches="$(grep -n --color=always "$grep_pattern" "$f" 2>/dev/null || true)"
+            if [[ -n "$matches" ]]; then
+                found=true
+                echo -e "  ${BLUE}──${RESET} ${BOLD}$(basename "$f")${RESET}"
+                echo "$matches" | while IFS= read -r line; do
+                    echo -e "    ${line}"
+                done
+                echo ""
+            fi
+        done
+        if ! $found; then
+            warn "No matches for '${grep_pattern}'"
+        fi
+        return
+    fi
+
+    # Default: list files then show the most recent
+    info "${#log_files[@]} log file(s):"
+    for f in "${log_files[@]}"; do
+        local size
+        size="$(wc -l < "$f" | tr -d ' ')"
+        echo -e "  ${DIM}•${RESET} $(basename "$f")  ${DIM}(${size} lines)${RESET}"
+    done
+
+    echo ""
+    local latest="${log_files[0]}"
+    info "Most recent: ${BOLD}$(basename "$latest")${RESET}"
+    echo -e "${DIM}  ──────────────────────────────────────────${RESET}"
+    cat "$latest"
+}
+
+# ─── Parse Arguments ─────────────────────────────────────────────────────────
+TEAM=""
+PANE=""
+GREP_PATTERN=""
+FOLLOW=false
+DO_CAPTURE=false
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --help|-h)
+            show_usage
+            exit 0
+            ;;
+        --capture)
+            DO_CAPTURE=true
+            shift
+            ;;
+        --pane)
+            PANE="${2:-}"
+            [[ -z "$PANE" ]] && { error "--pane requires an agent name"; exit 1; }
+            shift 2
+            ;;
+        --follow|-f)
+            FOLLOW=true
+            shift
+            ;;
+        --grep)
+            GREP_PATTERN="${2:-}"
+            [[ -z "$GREP_PATTERN" ]] && { error "--grep requires a pattern"; exit 1; }
+            shift 2
+            ;;
+        -*)
+            error "Unknown option: $1"
+            show_usage
+            exit 1
+            ;;
+        *)
+            TEAM="$1"
+            shift
+            ;;
+    esac
+done
+
+# ─── Dispatch ────────────────────────────────────────────────────────────────
+if $DO_CAPTURE; then
+    capture_logs
+elif [[ -z "$TEAM" ]]; then
+    list_logs
+else
+    show_team_logs "$TEAM" "$PANE" "$GREP_PATTERN" "$FOLLOW"
+fi