shipwright-cli 1.10.0 → 2.0.0

package/scripts/sw-triage.sh

@@ -0,0 +1,603 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  shipwright triage — Intelligent Issue Labeling & Prioritization        ║
+# ║  Auto-analyze issues, assign labels, score priority, recommend team size ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+set -euo pipefail
+trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
+
+VERSION="2.0.0"
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# ─── Colors (matches Seth's tmux theme) ─────────────────────────────────────
+CYAN='\033[38;2;0;212;255m'     # #00d4ff — primary accent
+PURPLE='\033[38;2;124;58;237m'  # #7c3aed — secondary
+BLUE='\033[38;2;0;102;255m'     # #0066ff — tertiary
+GREEN='\033[38;2;74;222;128m'   # success
+YELLOW='\033[38;2;250;204;21m'  # warning
+RED='\033[38;2;248;113;113m'    # error
+DIM='\033[2m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+# ─── Cross-platform compatibility ──────────────────────────────────────────
+# shellcheck source=lib/compat.sh
+[[ -f "$SCRIPT_DIR/lib/compat.sh" ]] && source "$SCRIPT_DIR/lib/compat.sh"
+
+# ─── 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; }
+
+now_iso() { date -u +"%Y-%m-%dT%H:%M:%SZ"; }
+
+# ─── Structured Event Log ──────────────────────────────────────────────────
+
+emit_event() {
+    local event_type="$1"; shift
+    local events_file="${HOME}/.shipwright/events.jsonl"
+    mkdir -p "$(dirname "$events_file")"
+    local payload="{\"ts\":\"$(now_iso)\",\"type\":\"$event_type\""
+    while [[ $# -gt 0 ]]; do
+        local key="${1%%=*}" val="${1#*=}"
+        val="${val//\"/\\\"}"
+        payload="${payload},\"${key}\":\"${val}\""
+        shift
+    done
+    payload="${payload}}"
+    echo "$payload" >> "$events_file"
+}
+
+# ─── GitHub API (safe when NO_GITHUB set) ──────────────────────────────────
+
+check_gh() {
+    if [[ "${NO_GITHUB:-}" == "1" ]]; then
+        error "GitHub access disabled (NO_GITHUB=1)"
+        exit 1
+    fi
+    if ! command -v gh &>/dev/null; then
+        error "gh CLI not found. Install: https://cli.github.com"
+        exit 1
+    fi
+}
+
+# ─── Analysis Functions ────────────────────────────────────────────────────
+
+# analyze_type <issue_body>
+# Detects issue type from title/body keywords
+analyze_type() {
+    local body="$1"
+    local lower_body
+    lower_body=$(echo "$body" | tr '[:upper:]' '[:lower:]')
+
+    if echo "$lower_body" | grep -qE "(security|vulnerability|cve|exploit|breach)"; then
+        echo "security"
+    elif echo "$lower_body" | grep -qE "(performance|speed|latency|slow|optimize|memory)"; then
+        echo "performance"
+    elif echo "$lower_body" | grep -qE "(bug|broken|crash|error|fail|issue)"; then
+        echo "bug"
+    elif echo "$lower_body" | grep -qE "(refactor|reorgan|rewrite|clean|improve)"; then
+        echo "refactor"
+    elif echo "$lower_body" | grep -qE "(doc|guide|readme|tutorial|howto)"; then
+        echo "docs"
+    elif echo "$lower_body" | grep -qE "(chore|maintain|update|bump|dependencies)"; then
+        echo "chore"
+    else
+        echo "feature"
+    fi
+}
+
+# analyze_complexity <issue_body>
+# Estimates complexity from body length, keywords, mentions
+analyze_complexity() {
+    local body="$1"
+    local score=0
+
+    # Longer issues = more complex (rough heuristic)
+    local body_lines
+    body_lines=$(echo "$body" | wc -l)
+    if [[ $body_lines -gt 50 ]]; then
+        score=$((score + 2))
+    elif [[ $body_lines -gt 20 ]]; then
+        score=$((score + 1))
+    fi
+
+    local lower_body
+    lower_body=$(echo "$body" | tr '[:upper:]' '[:lower:]')
+
+    # Complexity keywords
+    if echo "$lower_body" | grep -qE "(epic|major|rewrite|redesign|architecture)"; then
+        score=$((score + 3))
+    elif echo "$lower_body" | grep -qE "(multiple|several|cascade|dependencies|breaking)"; then
+        score=$((score + 2))
+    fi
+
+    # Mentions of tests/specs suggest complexity
+    if echo "$lower_body" | grep -qE "(test|spec|coverage|validation)"; then
+        score=$((score + 1))
+    fi
+
+    case $score in
+        0) echo "trivial" ;;
+        1) echo "simple" ;;
+        2|3) echo "moderate" ;;
+        4|5) echo "complex" ;;
+        *) echo "epic" ;;
+    esac
+}
+
+# analyze_risk <issue_body>
+# Assesses risk from keywords and scope
+analyze_risk() {
+    local body="$1"
+    local score=0
+    local lower_body
+    lower_body=$(echo "$body" | tr '[:upper:]' '[:lower:]')
+
+    if echo "$lower_body" | grep -qE "(security|vulnerability|exploit|critical)"; then
+        score=$((score + 3))
+    elif echo "$lower_body" | grep -qE "(breaking|migration|deprecat)"; then
+        score=$((score + 2))
+    elif echo "$lower_body" | grep -qE "(production|staging|database)"; then
+        score=$((score + 1))
+    fi
+
+    if echo "$lower_body" | grep -qE "(infrastructure|deploy|release)"; then
+        score=$((score + 1))
+    fi
+
+    case $score in
+        0) echo "low" ;;
+        1|2) echo "medium" ;;
+        3) echo "high" ;;
+        *) echo "critical" ;;
+    esac
+}
+
+# analyze_effort <complexity> <risk>
+# Maps complexity+risk → effort estimate
+analyze_effort() {
+    local complexity="$1"
+    local risk="$2"
+
+    case "${complexity}-${risk}" in
+        trivial-low) echo "xs" ;;
+        trivial-*|simple-low) echo "s" ;;
+        simple-medium|moderate-low) echo "m" ;;
+        moderate-*|complex-low) echo "l" ;;
+        complex-*|epic-*) echo "xl" ;;
+        *) echo "m" ;;
+    esac
+}
+
+# suggest_labels <type> <complexity> <risk> <effort>
+# Generates label recommendations
+suggest_labels() {
+    local type="$1"
+    local complexity="$2"
+    local risk="$3"
+    local effort="$4"
+    local labels=""
+
+    # Type label
+    labels="${labels}type:${type}"
+
+    # Complexity label
+    labels="${labels} complexity:${complexity}"
+
+    # Priority label (derived from risk)
+    case "$risk" in
+        critical) labels="${labels} priority:urgent" ;;
+        high) labels="${labels} priority:high" ;;
+        medium) labels="${labels} priority:medium" ;;
+        *) labels="${labels} priority:low" ;;
+    esac
+
+    # Effort label
+    labels="${labels} effort:${effort}"
+
+    # Risk label
+    labels="${labels} risk:${risk}"
+
+    echo "$labels"
+}
+
+# ─── Subcommand: analyze ──────────────────────────────────────────────────
+
+cmd_analyze() {
+    local issue="${1:-}"
+    [[ -z "$issue" ]] && { error "Usage: triage analyze <issue>"; exit 1; }
+
+    check_gh
+
+    info "Analyzing issue ${CYAN}${issue}${RESET}..."
+
+    # Fetch issue via gh CLI
+    local issue_json
+    issue_json=$(gh issue view "$issue" --json title,body,labels --format json 2>/dev/null || echo "{}")
+
+    if [[ "$issue_json" == "{}" ]]; then
+        error "Failed to fetch issue ${CYAN}${issue}${RESET}"
+        exit 1
+    fi
+
+    local title body existing_labels
+    title=$(echo "$issue_json" | jq -r '.title')
+    body=$(echo "$issue_json" | jq -r '.body // ""')
+    existing_labels=$(echo "$issue_json" | jq -r '.labels[].name' | tr '\n' ',' | sed 's/,$//')
+
+    local combined_text="${title} ${body}"
+
+    # Analyze
+    local type complexity risk effort labels
+    type=$(analyze_type "$combined_text")
+    complexity=$(analyze_complexity "$combined_text")
+    risk=$(analyze_risk "$combined_text")
+    effort=$(analyze_effort "$complexity" "$risk")
+    labels=$(suggest_labels "$type" "$complexity" "$risk" "$effort")
+
+    # Output as structured JSON
+    cat << EOF
+{
+  "issue": "$issue",
+  "title": $(jq -R . <<< "$title"),
+  "type": "$type",
+  "complexity": "$complexity",
+  "risk": "$risk",
+  "effort": "$effort",
+  "suggested_labels": $(echo "$labels" | jq -R 'split(" ")'),
+  "existing_labels": $(echo "$existing_labels" | jq -R 'split(",")')
+}
+EOF
+
+    emit_event "triage_analyzed" "issue=$issue" "type=$type" "complexity=$complexity" "risk=$risk"
+}
+
+# ─── Subcommand: label ────────────────────────────────────────────────────
+
+cmd_label() {
+    local issue="${1:-}"
+    [[ -z "$issue" ]] && { error "Usage: triage label <issue>"; exit 1; }
+
+    check_gh
+
+    info "Labeling issue ${CYAN}${issue}${RESET}..."
+
+    # Get suggested labels
+    local analysis
+    analysis=$(cmd_analyze "$issue" 2>/dev/null)
+
+    local labels_str
+    labels_str=$(echo "$analysis" | jq -r '.suggested_labels | join(" ")')
+
+    # Apply labels via gh CLI
+    local label_array
+    mapfile -t label_array <<< "$(echo "$labels_str" | tr ' ' '\n')"
+
+    for label in "${label_array[@]}"; do
+        [[ -z "$label" ]] && continue
+        gh label create "$label" --repo "$(gh repo view --json nameWithOwner -q)" 2>/dev/null || true
+        gh issue edit "$issue" --add-label "$label" 2>/dev/null || true
+        success "Applied label: ${CYAN}${label}${RESET}"
+    done
+
+    emit_event "triage_labeled" "issue=$issue" "label_count=${#label_array[@]}"
+}
+
+# ─── Subcommand: prioritize ───────────────────────────────────────────────
+
+cmd_prioritize() {
+    check_gh
+
+    info "Scoring open issues..."
+
+    local output_json="[]"
+
+    # Fetch all open issues
+    local issues_json
+    issues_json=$(gh issue list --state open --json number,title,body,labels,createdAt,reactions --limit 100 2>/dev/null || echo "[]")
+
+    local issue_count
+    issue_count=$(echo "$issues_json" | jq 'length')
+    info "Found ${CYAN}${issue_count}${RESET} open issues"
+
+    # Score each issue
+    while IFS= read -r issue_json; do
+        local number title body labels
+        number=$(echo "$issue_json" | jq -r '.number')
+        title=$(echo "$issue_json" | jq -r '.title')
+        body=$(echo "$issue_json" | jq -r '.body // ""')
+        labels=$(echo "$issue_json" | jq -r '.labels[].name' | tr '\n' ',' | sed 's/,$//')
+
+        local combined="${title} ${body}"
+        local type complexity risk
+        type=$(analyze_type "$combined")
+        complexity=$(analyze_complexity "$combined")
+        risk=$(analyze_risk "$combined")
+
+        # Score calculation: (Impact × 3) + (Urgency × 2) − (Effort × 0.5)
+        # Impact: risk level (0-3)
+        # Urgency: 1 if labeled urgent/blocking, else 0.5
+        # Effort: trivial=1, simple=2, moderate=3, complex=4, epic=5
+        local impact urgency effort_score
+        case "$risk" in
+            critical) impact=3 ;;
+            high) impact=2 ;;
+            medium) impact=1 ;;
+            *) impact=0 ;;
+        esac
+
+        if echo "$labels" | grep -qE "(urgent|blocking|critical)"; then
+            urgency=1
+        else
+            urgency=0.5
+        fi
+
+        case "$complexity" in
+            trivial) effort_score=1 ;;
+            simple) effort_score=2 ;;
+            moderate) effort_score=3 ;;
+            complex) effort_score=4 ;;
+            epic) effort_score=5 ;;
+            *) effort_score=3 ;;
+        esac
+
+        local score
+        score=$(awk "BEGIN {printf \"%.1f\", ($impact * 3) + ($urgency * 2) - ($effort_score * 0.5)}")
+
+        local item
+        item=$(jq -n \
+            --arg number "$number" \
+            --arg title "$title" \
+            --arg type "$type" \
+            --arg complexity "$complexity" \
+            --arg risk "$risk" \
+            --arg score "$score" \
+            '{number: $number, title: $title, type: $type, complexity: $complexity, risk: $risk, score: ($score | tonumber)}')
+
+        output_json=$(echo "$output_json" | jq ". += [$item]")
+    done < <(echo "$issues_json" | jq -c '.[]')
+
+    # Sort by score descending
+    output_json=$(echo "$output_json" | jq 'sort_by(.score) | reverse')
+
+    # Pretty print
+    echo ""
+    echo -e "${BOLD}Prioritized Backlog${RESET}"
+    echo "─────────────────────────────────────────────────────────────────"
+    echo ""
+    echo "$output_json" | jq -r '.[] | "\(.number | tostring | @json) \(.score | tostring): \(.title) [type:\(.type) complexity:\(.complexity) risk:\(.risk)]"' | while IFS= read -r line; do
+        local number score rest
+        number=$(echo "$line" | jq -r 'split(" ")[0]' <<< "$line")
+        score=$(echo "$line" | cut -d: -f2 | cut -d' ' -f1)
+        rest=$(echo "$line" | cut -d' ' -f3-)
+
+        echo -e "  ${CYAN}#${number}${RESET} ${BOLD}${score}${RESET}  ${rest}"
+    done
+
+    echo ""
+    info "Output: $(echo "$output_json" | jq 'length') issues ranked"
+
+    emit_event "triage_prioritized" "issue_count=$(echo "$output_json" | jq 'length')"
+}
+
+# ─── Subcommand: team ─────────────────────────────────────────────────────
+
+cmd_team() {
+    local issue="${1:-}"
+    [[ -z "$issue" ]] && { error "Usage: triage team <issue>"; exit 1; }
+
+    check_gh
+
+    info "Recommending team setup for issue ${CYAN}${issue}${RESET}..."
+
+    # Get analysis
+    local analysis
+    analysis=$(cmd_analyze "$issue" 2>/dev/null)
+
+    local complexity risk effort
+    complexity=$(echo "$analysis" | jq -r '.complexity')
+    risk=$(echo "$analysis" | jq -r '.risk')
+    effort=$(echo "$analysis" | jq -r '.effort')
+
+    # Recommend based on complexity/risk
+    local template model max_iterations agents
+    case "${complexity}-${risk}" in
+        trivial-low|simple-low)
+            template="fast"
+            model="haiku"
+            max_iterations=2
+            agents=1
+            ;;
+        simple-*|moderate-low)
+            template="standard"
+            model="sonnet"
+            max_iterations=5
+            agents=2
+            ;;
+        moderate-*|complex-low)
+            template="standard"
+            model="sonnet"
+            max_iterations=8
+            agents=3
+            ;;
+        complex-*|epic-*)
+            template="full"
+            model="opus"
+            max_iterations=15
+            agents=4
+            ;;
+        *)
+            template="standard"
+            model="sonnet"
+            max_iterations=5
+            agents=2
+            ;;
+    esac
+
+    cat << EOF
+{
+  "issue": "$issue",
+  "complexity": "$complexity",
+  "risk": "$risk",
+  "effort": "$effort",
+  "recommendation": {
+    "pipeline_template": "$template",
+    "model": "$model",
+    "max_iterations": $max_iterations,
+    "agents": $agents
+  }
+}
+EOF
+
+    emit_event "triage_team_recommended" "issue=$issue" "template=$template" "agents=$agents"
+}
+
+# ─── Subcommand: batch ────────────────────────────────────────────────────
+
+cmd_batch() {
+    check_gh
+
+    info "Batch analyzing and labeling unlabeled open issues..."
+
+    # Fetch unlabeled open issues
+    local issues_json
+    issues_json=$(gh issue list --state open --search "no:label" --json number --limit 50 2>/dev/null || echo "[]")
+
+    local issue_count
+    issue_count=$(echo "$issues_json" | jq 'length')
+    info "Found ${CYAN}${issue_count}${RESET} unlabeled issues"
+
+    local success_count=0
+    echo "$issues_json" | jq -r '.[] | .number' | while IFS= read -r number; do
+        if cmd_label "$number" >/dev/null 2>&1; then
+            success_count=$((success_count + 1))
+        fi
+    done
+
+    success "Labeled ${CYAN}${issue_count}${RESET} issues"
+    emit_event "triage_batch_complete" "issue_count=$issue_count"
+}
+
+# ─── Subcommand: report ───────────────────────────────────────────────────
+
+cmd_report() {
+    check_gh
+
+    info "Generating triage statistics..."
+
+    # Fetch labeled issues
+    local issues_json
+    issues_json=$(gh issue list --state open --json labels,title,number --limit 100 2>/dev/null || echo "[]")
+
+    local type_counts complexity_counts priority_counts
+    type_counts='{}'
+    complexity_counts='{}'
+    priority_counts='{}'
+
+    echo "$issues_json" | jq -c '.[]' | while IFS= read -r issue_json; do
+        local labels
+        labels=$(echo "$issue_json" | jq -r '.labels[].name' | tr '\n' ',')
+
+        # Extract type
+        local type
+        type=$(echo "$labels" | grep -oE "type:[a-z-]+" | cut -d: -f2 | head -1 || echo "unknown")
+        type_counts=$(echo "$type_counts" | jq --arg t "$type" '.[$t] = (.[$t] // 0) + 1')
+
+        # Extract complexity
+        local complexity
+        complexity=$(echo "$labels" | grep -oE "complexity:[a-z-]+" | cut -d: -f2 | head -1 || echo "unknown")
+        complexity_counts=$(echo "$complexity_counts" | jq --arg c "$complexity" '.[$c] = (.[$c] // 0) + 1')
+
+        # Extract priority
+        local priority
+        priority=$(echo "$labels" | grep -oE "priority:[a-z-]+" | cut -d: -f2 | head -1 || echo "unknown")
+        priority_counts=$(echo "$priority_counts" | jq --arg p "$priority" '.[$p] = (.[$p] // 0) + 1')
+    done
+
+    # Output report
+    echo ""
+    echo -e "${BOLD}Triage Report${RESET}"
+    echo "─────────────────────────────────────────────────────────────────"
+    echo ""
+    echo -e "${BOLD}By Type:${RESET}"
+    echo "$type_counts" | jq -r 'to_entries[] | "  \(.key): \(.value)"'
+    echo ""
+    echo -e "${BOLD}By Complexity:${RESET}"
+    echo "$complexity_counts" | jq -r 'to_entries[] | "  \(.key): \(.value)"'
+    echo ""
+    echo -e "${BOLD}By Priority:${RESET}"
+    echo "$priority_counts" | jq -r 'to_entries[] | "  \(.key): \(.value)"'
+
+    emit_event "triage_report_generated"
+}
+
+# ─── Subcommand: help ────────────────────────────────────────────────────
+
+cmd_help() {
+    echo -e "${BOLD}shipwright triage${RESET} — Intelligent Issue Labeling & Prioritization"
+    echo ""
+    echo -e "${BOLD}USAGE${RESET}"
+    echo -e "  ${CYAN}shipwright triage${RESET} <subcommand> [options]"
+    echo ""
+    echo -e "${BOLD}SUBCOMMANDS${RESET}"
+    echo -e "  ${CYAN}analyze <issue>${RESET}        Analyze issue and suggest labels (outputs JSON)"
+    echo -e "  ${CYAN}label <issue>${RESET}          Apply suggested labels to issue"
+    echo -e "  ${CYAN}prioritize${RESET}            Score and rank all open issues by priority"
+    echo -e "  ${CYAN}team <issue>${RESET}           Recommend team size & pipeline template"
+    echo -e "  ${CYAN}batch${RESET}                  Analyze + label all unlabeled open issues"
+    echo -e "  ${CYAN}report${RESET}                 Show triage statistics (type, complexity, priority)"
+    echo -e "  ${CYAN}help${RESET}                   Show this help message"
+    echo ""
+    echo -e "${BOLD}EXAMPLES${RESET}"
+    echo -e "  ${DIM}shipwright triage analyze 42${RESET}"
+    echo -e "  ${DIM}shipwright triage label 42${RESET}"
+    echo -e "  ${DIM}shipwright triage prioritize${RESET}"
+    echo -e "  ${DIM}shipwright triage team 42${RESET}"
+    echo -e "  ${DIM}shipwright triage batch${RESET}"
+    echo -e "  ${DIM}shipwright triage report${RESET}"
+    echo ""
+}
+
+# ─── Main ──────────────────────────────────────────────────────────────────
+
+main() {
+    local cmd="${1:-help}"
+    shift 2>/dev/null || true
+
+    case "$cmd" in
+        analyze)
+            cmd_analyze "$@"
+            ;;
+        label)
+            cmd_label "$@"
+            ;;
+        prioritize)
+            cmd_prioritize "$@"
+            ;;
+        team)
+            cmd_team "$@"
+            ;;
+        batch)
+            cmd_batch "$@"
+            ;;
+        report)
+            cmd_report "$@"
+            ;;
+        help|--help|-h)
+            cmd_help
+            ;;
+        *)
+            error "Unknown subcommand: ${cmd}"
+            cmd_help
+            exit 1
+            ;;
+    esac
+}
+
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+    main "$@"
+fi

package/scripts/sw-upgrade.sh

@@ -2,7 +2,7 @@
 # ╔═══════════════════════════════════════════════════════════════════════════╗
 # ║  sw upgrade — Detect and apply updates from the repo                   ║
 # ╚═══════════════════════════════════════════════════════════════════════════╝
-VERSION="1.10.0"
+VERSION="2.0.0"
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR