shipwright-cli 3.1.0 → 3.3.0

package/scripts/lib/pipeline-cli.sh

@@ -0,0 +1,336 @@
+#!/usr/bin/env bash
+# Module: pipeline-cli
+# CLI parsing, config loading, help display
+set -euo pipefail
+
+# Module guard
+[[ -n "${_MODULE_PIPELINE_CLI_LOADED:-}" ]] && return 0; _MODULE_PIPELINE_CLI_LOADED=1
+
+# ─── Defaults (needed if sourced independently) ──────────────────────────────
+SCRIPT_DIR="${SCRIPT_DIR:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
+REPO_DIR="${REPO_DIR:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+PROJECT_ROOT="${PROJECT_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
+STATE_DIR="${STATE_DIR:-$PROJECT_ROOT/.claude}"
+STATE_FILE="${STATE_FILE:-$STATE_DIR/pipeline-state.md}"
+ARTIFACTS_DIR="${ARTIFACTS_DIR:-$STATE_DIR/pipeline-artifacts}"
+EVENTS_FILE="${EVENTS_FILE:-$HOME/.shipwright/events.jsonl}"
+
+# Ensure helpers are loaded
+[[ -f "$SCRIPT_DIR/lib/helpers.sh" ]] && source "$SCRIPT_DIR/lib/helpers.sh" 2>/dev/null || true
+[[ "$(type -t info 2>/dev/null)" == "function" ]] || info() { echo "$*"; }
+[[ "$(type -t error 2>/dev/null)" == "function" ]] || error() { echo "$*" >&2; }
+[[ "$(type -t emit_event 2>/dev/null)" == "function" ]] || emit_event() { true; }
+[[ "$(type -t _config_get_int 2>/dev/null)" == "function" ]] || _config_get_int() { echo "${3:-$2}"; }
+[[ "$(type -t file_mtime 2>/dev/null)" == "function" ]] || file_mtime() { stat -f "%m" "$1" 2>/dev/null || echo "0"; }
+[[ "$(type -t now_epoch 2>/dev/null)" == "function" ]] || now_epoch() { date +%s; }
+
+# ─── Help ──────────────────────────────────────────────────────────
+show_help() {
+    echo -e "${CYAN}${BOLD}shipwright pipeline${RESET} — Autonomous Feature Delivery"
+    echo ""
+    echo -e "${BOLD}USAGE${RESET}"
+    echo -e "  ${CYAN}shipwright pipeline${RESET} <command> [options]"
+    echo ""
+    echo -e "${BOLD}COMMANDS${RESET}"
+    echo -e "  ${CYAN}start${RESET}   --goal \"...\"    Start a new pipeline"
+    echo -e "  ${CYAN}resume${RESET}                  Continue from last completed stage"
+    echo -e "  ${CYAN}status${RESET}                  Show pipeline progress dashboard"
+    echo -e "  ${CYAN}abort${RESET}                   Stop pipeline and mark aborted"
+    echo -e "  ${CYAN}list${RESET}                    Show available pipeline templates"
+    echo -e "  ${CYAN}show${RESET}    <name>          Display pipeline stages"
+    echo ""
+    echo -e "${BOLD}START OPTIONS${RESET}"
+    echo -e "  ${DIM}--goal \"description\"${RESET}     What to build (required unless --issue)"
+    echo -e "  ${DIM}--issue <number>${RESET}          Fetch goal from GitHub issue"
+    echo -e "  ${DIM}--repo <path>${RESET}             Change to directory before running (must be a git repo)"
+    echo -e "  ${DIM}--local${RESET}                   Alias for --no-github --no-github-label (local-only mode)"
+    echo -e "  ${DIM}--pipeline <name>${RESET}         Pipeline template (default: standard)"
+    echo -e "  ${DIM}--test-cmd \"command\"${RESET}     Override test command (auto-detected if omitted)"
+    echo -e "  ${DIM}--model <model>${RESET}           Override AI model (opus, sonnet, haiku)"
+    echo -e "  ${DIM}--agents <n>${RESET}              Override agent count"
+    echo -e "  ${DIM}--skip-gates${RESET}              Auto-approve all gates (fully autonomous)"
+    echo -e "  ${DIM}--headless${RESET}                Full headless mode (skip gates, no prompts)"
+    echo -e "  ${DIM}--base <branch>${RESET}           Base branch for PR (default: main)"
+    echo -e "  ${DIM}--reviewers \"a,b\"${RESET}        Request PR reviewers (auto-detected if omitted)"
+    echo -e "  ${DIM}--labels \"a,b\"${RESET}            Add labels to PR (inherited from issue if omitted)"
+    echo -e "  ${DIM}--no-github${RESET}               Disable GitHub integration"
+    echo -e "  ${DIM}--no-github-label${RESET}         Don't modify issue labels"
+    echo -e "  ${DIM}--ci${RESET}                      CI mode (skip gates, non-interactive)"
+    echo -e "  ${DIM}--ignore-budget${RESET}           Skip budget enforcement checks"
+    echo -e "  ${DIM}--worktree [=name]${RESET}         Run in isolated git worktree (parallel-safe)"
+    echo -e "  ${DIM}--dry-run${RESET}                 Show what would happen without executing"
+    echo -e "  ${DIM}--slack-webhook <url>${RESET}     Send notifications to Slack"
+    echo -e "  ${DIM}--self-heal <n>${RESET}            Build→test retry cycles on failure (default: 2)"
+    echo -e "  ${DIM}--max-iterations <n>${RESET}       Override max build loop iterations"
+    echo -e "  ${DIM}--max-restarts <n>${RESET}         Max session restarts in build loop"
+    echo -e "  ${DIM}--fast-test-cmd <cmd>${RESET}      Fast/subset test for build loop"
+    echo -e "  ${DIM}--tdd${RESET}                     Test-first: generate tests before implementation"
+    echo -e "  ${DIM}--completed-stages \"a,b\"${RESET}   Skip these stages (CI resume)"
+    echo ""
+    echo -e "${BOLD}STAGES${RESET}  ${DIM}(configurable per pipeline template)${RESET}"
+    echo -e "  intake → plan → design → build → test → review → pr → deploy → validate → monitor"
+    echo ""
+    echo -e "${BOLD}GITHUB INTEGRATION${RESET}  ${DIM}(automatic when gh CLI available)${RESET}"
+    echo -e "  • Issue intake: fetch metadata, labels, milestone, self-assign"
+    echo -e "  • Progress tracking: live updates posted as issue comments"
+    echo -e "  • Task checklist: plan posted as checkbox list on issue"
+    echo -e "  • PR creation: labels, milestone, reviewers auto-propagated"
+    echo -e "  • Issue lifecycle: labeled in-progress → closed on completion"
+    echo ""
+    echo -e "${BOLD}SELF-HEALING${RESET}  ${DIM}(autonomous error recovery)${RESET}"
+    echo -e "  • Build→test feedback loop: failures feed back as build context"
+    echo -e "  • Configurable retry cycles (--self-heal N, default: 2)"
+    echo -e "  • Auto-rebase before PR: handles base branch drift"
+    echo -e "  • Signal-safe: Ctrl+C saves state for clean resume"
+    echo -e "  • Git stash/restore: protects uncommitted work"
+    echo ""
+    echo -e "${BOLD}AUTO-DETECTION${RESET}  ${DIM}(zero-config for common setups)${RESET}"
+    echo -e "  • Test command: package.json, Makefile, Cargo.toml, go.mod, etc."
+    echo -e "  • Branch prefix: feat/, fix/, refactor/ based on task type"
+    echo -e "  • Reviewers: from CODEOWNERS or recent git contributors"
+    echo -e "  • Project type: language and framework detection"
+    echo ""
+    echo -e "${BOLD}NOTIFICATIONS${RESET}  ${DIM}(team awareness)${RESET}"
+    echo -e "  • Slack: --slack-webhook <url>"
+    echo -e "  • Custom webhook: set SHIPWRIGHT_WEBHOOK_URL env var"
+    echo -e "  • Events: start, stage complete, failure, self-heal, done"
+    echo ""
+    echo -e "${BOLD}EXAMPLES${RESET}"
+    echo -e "  ${DIM}# From GitHub issue (fully autonomous)${RESET}"
+    echo -e "  ${DIM}shipwright pipeline start --issue 123 --skip-gates${RESET}"
+    echo ""
+    echo -e "  ${DIM}# From inline goal${RESET}"
+    echo -e "  ${DIM}shipwright pipeline start --goal \"Add JWT authentication\"${RESET}"
+    echo ""
+    echo -e "  ${DIM}# Hotfix with custom test command${RESET}"
+    echo -e "  ${DIM}shipwright pipeline start --issue 456 --pipeline hotfix --test-cmd \"pytest\"${RESET}"
+    echo ""
+    echo -e "  ${DIM}# Full deployment pipeline with 3 agents${RESET}"
+    echo -e "  ${DIM}shipwright pipeline start --goal \"Build payment flow\" --pipeline full --agents 3${RESET}"
+    echo ""
+    echo -e "  ${DIM}# Parallel pipeline in isolated worktree${RESET}"
+    echo -e "  ${DIM}shipwright pipeline start --issue 42 --worktree${RESET}"
+    echo ""
+    echo -e "  ${DIM}# Resume / monitor / abort${RESET}"
+    echo -e "  ${DIM}shipwright pipeline resume${RESET}"
+    echo -e "  ${DIM}shipwright pipeline status${RESET}"
+    echo -e "  ${DIM}shipwright pipeline abort${RESET}"
+    echo ""
+}
+
+# ─── Argument Parsing ──────────────────────────────────────────────
+parse_args() {
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --goal)        GOAL="$2"; shift 2 ;;
+            --issue)       ISSUE_NUMBER="$2"; shift 2 ;;
+            --repo)        REPO_OVERRIDE="$2"; shift 2 ;;
+            --local)       NO_GITHUB=true; NO_GITHUB_LABEL=true; shift ;;
+            --pipeline|--template) PIPELINE_NAME="$2"; shift 2 ;;
+            --test-cmd)    TEST_CMD="$2"; shift 2 ;;
+            --model)       MODEL="$2"; shift 2 ;;
+            --agents)      AGENTS="$2"; shift 2 ;;
+            --skip-gates)  SKIP_GATES=true; shift ;;
+            --headless)    HEADLESS=true; SKIP_GATES=true; shift ;;
+            --base)        BASE_BRANCH="$2"; shift 2 ;;
+            --reviewers)   REVIEWERS="$2"; shift 2 ;;
+            --labels)      LABELS="$2"; shift 2 ;;
+            --no-github)   NO_GITHUB=true; shift ;;
+            --no-github-label) NO_GITHUB_LABEL=true; shift ;;
+            --ci)          CI_MODE=true; SKIP_GATES=true; shift ;;
+            --ignore-budget) IGNORE_BUDGET=true; shift ;;
+            --max-iterations) MAX_ITERATIONS_OVERRIDE="$2"; shift 2 ;;
+            --completed-stages) COMPLETED_STAGES="$2"; shift 2 ;;
+            --resume) RESUME_FROM_CHECKPOINT=true; shift ;;
+            --worktree=*) AUTO_WORKTREE=true; WORKTREE_NAME="${1#--worktree=}"; WORKTREE_NAME="${WORKTREE_NAME//[^a-zA-Z0-9_-]/}"; if [[ -z "$WORKTREE_NAME" ]]; then error "Invalid worktree name (alphanumeric, hyphens, underscores only)"; exit 1; fi; shift ;;
+            --worktree)   AUTO_WORKTREE=true; shift ;;
+            --dry-run)     DRY_RUN=true; shift ;;
+            --slack-webhook) SLACK_WEBHOOK="$2"; shift 2 ;;
+            --self-heal)   BUILD_TEST_RETRIES="${2:-3}"; shift 2 ;;
+            --max-restarts)
+                MAX_RESTARTS_OVERRIDE="$2"
+                if ! [[ "$MAX_RESTARTS_OVERRIDE" =~ ^[0-9]+$ ]]; then
+                    error "--max-restarts must be numeric (got: $MAX_RESTARTS_OVERRIDE)"
+                    exit 1
+                fi
+                shift 2 ;;
+
+            --fast-test-cmd) FAST_TEST_CMD_OVERRIDE="$2"; shift 2 ;;
+            --tdd)         TDD_ENABLED=true; shift ;;
+            --effort)
+                EFFORT_LEVEL_OVERRIDE="${2:-}"
+                [[ -z "$EFFORT_LEVEL_OVERRIDE" ]] && { error "Missing value for --effort"; exit 1; }
+                shift 2 ;;
+            --effort=*) EFFORT_LEVEL_OVERRIDE="${1#--effort=}"; shift ;;
+            --fallback-model)
+                PIPELINE_FALLBACK_MODEL="${2:-}"
+                [[ -z "$PIPELINE_FALLBACK_MODEL" ]] && { error "Missing value for --fallback-model"; exit 1; }
+                shift 2 ;;
+            --fallback-model=*) PIPELINE_FALLBACK_MODEL="${1#--fallback-model=}"; shift ;;
+            --help|-h)     show_help; exit 0 ;;
+            *)
+                if [[ -z "$PIPELINE_NAME_ARG" ]]; then
+                    PIPELINE_NAME_ARG="$1"
+                fi
+                shift ;;
+        esac
+    done
+}
+
+# ─── Directory Setup ───────────────────────────────────────────────
+setup_dirs() {
+    PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+    STATE_DIR="$PROJECT_ROOT/.claude"
+    STATE_FILE="$STATE_DIR/pipeline-state.md"
+    ARTIFACTS_DIR="$STATE_DIR/pipeline-artifacts"
+    export ARTIFACTS_DIR  # Export so child processes (sw-loop.sh) can write audit events
+    TASKS_FILE="$STATE_DIR/pipeline-tasks.md"
+    mkdir -p "$STATE_DIR" "$ARTIFACTS_DIR"
+    export SHIPWRIGHT_PIPELINE_ID="pipeline-$$-${ISSUE_NUMBER:-0}"
+}
+
+# ─── Pipeline Config Loading ───────────────────────────────────────
+find_pipeline_config() {
+    local name="$1"
+    local locations=(
+        "$REPO_DIR/templates/pipelines/${name}.json"
+        "${PROJECT_ROOT:-}/templates/pipelines/${name}.json"
+        "$HOME/.shipwright/pipelines/${name}.json"
+    )
+    for loc in "${locations[@]}"; do
+        if [[ -n "$loc" && -f "$loc" ]]; then
+            echo "$loc"
+            return 0
+        fi
+    done
+    return 1
+}
+
+load_pipeline_config() {
+    # Check for intelligence-composed pipeline first
+    local composed_pipeline="${ARTIFACTS_DIR}/composed-pipeline.json"
+    if [[ -f "$composed_pipeline" ]] && type composer_validate_pipeline >/dev/null 2>&1; then
+        # Use composed pipeline if fresh (within cache TTL)
+        local composed_cache_ttl
+        composed_cache_ttl=$(_config_get_int "pipeline.composed_cache_ttl" 3600 2>/dev/null || echo 3600)
+        local composed_age=99999
+        local composed_mtime
+        composed_mtime=$(file_mtime "$composed_pipeline")
+        if [[ "$composed_mtime" -gt 0 ]]; then
+            composed_age=$(( $(now_epoch) - composed_mtime ))
+        fi
+        if [[ "$composed_age" -lt "$composed_cache_ttl" ]]; then
+            local validate_json
+            validate_json=$(cat "$composed_pipeline" 2>/dev/null || echo "")
+            if [[ -n "$validate_json" ]] && composer_validate_pipeline "$validate_json" 2>/dev/null; then
+                PIPELINE_CONFIG="$composed_pipeline"
+                info "Pipeline: ${BOLD}composed${RESET} ${DIM}(intelligence-driven)${RESET}"
+                emit_event "pipeline.composed_loaded" "issue=${ISSUE_NUMBER:-0}"
+                return
+            fi
+        fi
+    fi
+
+    PIPELINE_CONFIG=$(find_pipeline_config "$PIPELINE_NAME") || {
+        error "Pipeline template not found: $PIPELINE_NAME"
+        echo -e "  Available templates: ${DIM}shipwright pipeline list${RESET}"
+        exit 1
+    }
+    info "Pipeline: ${BOLD}$PIPELINE_NAME${RESET} ${DIM}($PIPELINE_CONFIG)${RESET}"
+    # TDD from template (overridable by --tdd)
+    [[ "$(jq -r '.tdd // false' "$PIPELINE_CONFIG" 2>/dev/null)" == "true" ]] && PIPELINE_TDD=true
+    return 0
+}
+
+# ─── Composed Pipeline Loading ─────────────────────────────────────
+load_composed_pipeline() {
+    local spec_file="$1"
+    [[ ! -f "$spec_file" ]] && return 1
+
+    # Read enabled stages from composed spec
+    local composed_stages
+    composed_stages=$(jq -r '.stages // [] | .[] | .id' "$spec_file" 2>/dev/null) || return 1
+    [[ -z "$composed_stages" ]] && return 1
+
+    # Override enabled stages
+    COMPOSED_STAGES="$composed_stages"
+
+    # Override per-stage settings
+    local build_max
+    build_max=$(jq -r '.stages[] | select(.id=="build") | .max_iterations // ""' "$spec_file" 2>/dev/null) || true
+    [[ -n "$build_max" && "$build_max" != "null" ]] && COMPOSED_BUILD_ITERATIONS="$build_max"
+
+    emit_event "pipeline.composed_loaded" "stages=$(echo "$composed_stages" | wc -l | tr -d ' ')"
+    return 0
+}
+
+# ─── List & Show Commands ──────────────────────────────────────────
+pipeline_list() {
+    local locations=(
+        "$REPO_DIR/templates/pipelines"
+        "$HOME/.shipwright/pipelines"
+    )
+
+    echo ""
+    echo -e "${PURPLE}${BOLD}━━━ Pipeline Templates ━━━${RESET}"
+    echo ""
+
+    local found=false
+    for dir in "${locations[@]}"; do
+        if [[ -d "$dir" ]]; then
+            for f in "$dir"/*.json; do
+                [[ -f "$f" ]] || continue
+                found=true
+                local name desc stages_enabled gate_count
+                name=$(jq -r '.name' "$f" 2>/dev/null)
+                desc=$(jq -r '.description' "$f" 2>/dev/null)
+                stages_enabled=$(jq -r '[.stages[] | select(.enabled == true) | .id] | join(" → ")' "$f" 2>/dev/null)
+                gate_count=$(jq '[.stages[] | select(.gate == "approve" and .enabled == true)] | length' "$f" 2>/dev/null)
+                echo -e "  ${CYAN}${BOLD}$name${RESET}"
+                echo -e "    $desc"
+                echo -e "    ${DIM}$stages_enabled${RESET}"
+                echo -e "    ${DIM}(${gate_count} approval gates)${RESET}"
+                echo ""
+            done
+        fi
+    done
+
+    if [[ "$found" != "true" ]]; then
+        warn "No pipeline templates found."
+        echo -e "  Expected at: ${DIM}templates/pipelines/*.json${RESET}"
+    fi
+}
+
+pipeline_show() {
+    local name="${PIPELINE_NAME_ARG:-$PIPELINE_NAME}"
+
+    local config_file
+    config_file=$(find_pipeline_config "$name") || {
+        error "Pipeline template not found: $name"
+        echo -e "  Available: ${DIM}shipwright pipeline list${RESET}"
+        exit 1
+    }
+
+    echo ""
+    echo -e "${PURPLE}${BOLD}━━━ Pipeline: $(jq -r '.name' "$config_file") ━━━${RESET}"
+    echo -e "  $(jq -r '.description' "$config_file")"
+    echo ""
+
+    echo -e "${BOLD}  Defaults:${RESET}"
+    jq -r '.defaults | to_entries[] | "    \(.key): \(.value)"' "$config_file" 2>/dev/null
+    echo ""
+
+    echo -e "${BOLD}  Stages:${RESET}"
+    jq -r '.stages[] |
+        (if .enabled then "    ✓" else "    ○" end) +
+        " \(.id)" +
+        (if .gate == "approve" then "  [gate: approve]" elif .gate == "skip" then "  [skip]" else "" end)
+    ' "$config_file" 2>/dev/null
+    echo ""
+
+    echo -e "${BOLD}  GitHub Integration:${RESET}"
+    echo -e "    • Issue: self-assign, label lifecycle, progress comments"
+    echo -e "    • PR: labels, milestone, reviewers auto-propagated"
+    echo -e "    • Validation: auto-close issue on completion"
+    echo ""
+}