shipwright-cli 3.1.0 → 3.3.0

package/scripts/skills/validation-thoroughness.md

@@ -0,0 +1,55 @@
+## Validation Thoroughness: Prove It Works in Production
+
+Smoke tests are necessary but not sufficient. Validate the actual user experience.
+
+### Smoke Test Design
+- Test the critical user path end-to-end (not just health endpoints)
+- Verify the SPECIFIC functionality from this issue works
+- Include authentication flow if the feature requires auth
+- Test with realistic data, not just empty/default states
+
+### Health Check Layers
+1. **Liveness** — Is the process running? (HTTP 200 on /health)
+2. **Readiness** — Can it serve traffic? (dependencies connected, workers initialized)
+3. **Functional** — Does the new feature actually work? (feature-specific endpoint test)
+
+### Regression Detection
+- Run the full test suite against the deployed environment (not just smoke)
+- Compare response times to baseline — >20% regression is a red flag
+- Verify existing features still work (not just the new one)
+- Check error rates in logs for the first 100 requests
+
+### Production Readiness Checklist
+- [ ] Health endpoint returns 200
+- [ ] Key feature endpoint returns expected response
+- [ ] Error rate is below baseline threshold
+- [ ] Response latency is within acceptable range (p95 < SLO)
+- [ ] No new error patterns in logs
+- [ ] Database connections are healthy
+- [ ] External service integrations are working
+
+### Issue Closure Criteria
+Before automatically closing the issue:
+1. Smoke tests pass
+2. Health checks pass (5 consecutive successes)
+3. No error rate spike in first 5 minutes
+4. Feature-specific validation passes
+5. PR is merged and deployed
+
+### Failure Response
+If validation fails:
+1. Do NOT close the issue
+2. Create an incident issue with validation failure details
+3. Trigger rollback if auto-rollback is configured
+4. Preserve deploy logs and smoke test output for debugging
+
+### Required Output (Mandatory)
+
+Your output MUST include these sections when this skill is active:
+
+1. **Smoke Test Specification**: Explicit test cases covering the critical user path with realistic data (not just health endpoints)
+2. **Health Check Results**: Liveness check (process running), Readiness check (dependencies connected), Functional check (feature works)
+3. **Regression Detection**: Comparison of response times to baseline, error rate against baseline threshold, log analysis for new error patterns
+4. **Issue Closure Decision**: PASS/FAIL verdict with supporting evidence (all health checks passed, no error rate spike, feature-specific validation passed)
+
+If any section is not applicable, explicitly state why it's skipped.

package/scripts/sw

@@ -5,7 +5,7 @@
 # ╚═══════════════════════════════════════════════════════════════════════════╝
 set -euo pipefail
 
-VERSION="3.1.0"
+VERSION="3.3.0"
 
 # Resolve symlinks (required for npm global install where bin/ symlinks to node_modules/)
 SOURCE="${BASH_SOURCE[0]}"
@@ -19,6 +19,7 @@ SCRIPT_DIR="$(cd "$(dirname "$SOURCE")" && 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
+# shellcheck disable=SC2034
 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
@@ -36,6 +37,7 @@ _sw_github_repo() {
         echo "${SHIPWRIGHT_GITHUB_REPO:-sethdford/shipwright}"
     fi
 }
+# shellcheck disable=SC2155
 _sw_github_owner() { local r="$(_sw_github_repo)"; echo "${r%%/*}"; }
 _sw_docs_url() { echo "${SHIPWRIGHT_DOCS_URL:-https://$(_sw_github_owner).github.io/shipwright}"; }
 _sw_github_url() { echo "https://github.com/$(_sw_github_repo)"; }
@@ -162,7 +164,7 @@ show_help_all() {
     echo -e "  ${CYAN}auth${RESET}          ${CYAN}webhook${RESET}       ${CYAN}eventbus${RESET}      ${CYAN}otel${RESET}          ${CYAN}context${RESET}"
     echo -e "  ${CYAN}trace${RESET}         ${CYAN}widgets${RESET}       ${CYAN}connect${RESET}       ${CYAN}remote${RESET}        ${CYAN}launchd${RESET}"
     echo -e "  ${CYAN}jira${RESET}          ${CYAN}linear${RESET}        ${CYAN}tracker${RESET}       ${CYAN}heartbeat${RESET}     ${CYAN}checkpoint${RESET}"
-    echo -e "  ${CYAN}durable${RESET}       ${CYAN}autonomous${RESET}    ${CYAN}pm${RESET}            ${CYAN}strategic${RESET}     ${CYAN}team-stages${RESET}"
+    echo -e "  ${CYAN}stall-detector${RESET} ${CYAN}durable${RESET}       ${CYAN}autonomous${RESET}    ${CYAN}pm${RESET}            ${CYAN}strategic${RESET}"
     echo -e "  ${CYAN}ux${RESET}            ${CYAN}mission-control${RESET}  ${CYAN}tmux${RESET}       ${CYAN}reaper${RESET}        ${CYAN}e2e${RESET}"
     echo -e "  ${CYAN}init${RESET}          ${CYAN}setup${RESET}         ${CYAN}doctor${RESET}        ${CYAN}cleanup${RESET}       ${CYAN}upgrade${RESET}"
     echo -e "  ${CYAN}templates${RESET}     ${CYAN}version${RESET}"
@@ -265,6 +267,7 @@ main() {
 
     shift 2>/dev/null || true
 
+    # shellcheck disable=SC2221,SC2222
     case "$cmd" in
         # Command groups
         agent)          route_agent "$@" ;;
@@ -402,6 +405,9 @@ main() {
         checkpoint)
             exec "$SCRIPT_DIR/sw-checkpoint.sh" "$@"
             ;;
+        stall-detector)
+            exec "$SCRIPT_DIR/sw-stall-detector.sh" "$@"
+            ;;
         durable)
             exec "$SCRIPT_DIR/sw-durable.sh" "$@"
             ;;
@@ -600,7 +606,7 @@ main() {
             show_version
             ;;
         hello)
-            echo "hello world"
+            exec "$SCRIPT_DIR/sw-hello.sh" "$@"
             ;;
         *)
             error "Unknown command: ${cmd}"

package/scripts/sw-activity.sh

@@ -6,7 +6,8 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+# shellcheck disable=SC2034
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -28,7 +29,8 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
-    local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
+    local payload
+    payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
   }
@@ -39,7 +41,9 @@ FILTER_TYPE=""
 FILTER_AGENT=""
 FILTER_TEAM=""
 FILTER_STAGE=""
+# shellcheck disable=SC2034
 FILTER_START=""
+# shellcheck disable=SC2034
 FILTER_END=""
 
 # Event type icons for terminal display (bash 3.2 compatible)
@@ -223,7 +227,9 @@ cmd_snapshot() {
 
     # Group by agent, show last event for each
     local last_agent=""
+    # shellcheck disable=SC2034
     local last_time=""
+    # shellcheck disable=SC2034
     local last_event=""
 
     tac "$EVENTS_FILE" 2>/dev/null | while IFS= read -r line; do
@@ -332,7 +338,6 @@ cmd_stats() {
     local end_time=""
 
     # Read directly to avoid subshell issues
-    echo "DEBUG: Starting read loop..." >&2
     while IFS= read -r line; do
         [ -z "$line" ] && continue
 
@@ -363,14 +368,9 @@ cmd_stats() {
         end_time="$ts"
     done < <(grep -v '^$' "$EVENTS_FILE" 2>/dev/null)
 
-    echo "DEBUG: Read complete, total=$total_events" >&2
-    echo "DEBUG: agents_seen length: ${#agents_seen}" >&2
     local unique_agents
-    echo "DEBUG: About to compute unique..." >&2
     unique_agents=$(sort -u <<< "$agents_seen" | grep -v '^$' | wc -l | tr -d ' ')
-    echo "DEBUG: unique_agents=$unique_agents" >&2
 
-    echo "DEBUG: About to print results..." >&2
     printf "${BOLD}Total Events:${RESET} %d\n" "$total_events"
     printf "${BOLD}Commits:${RESET} %d\n" "$commits"
     printf "${BOLD}Tests:${RESET} %d\n" "$tests"
@@ -449,6 +449,7 @@ main() {
     shift 2>/dev/null || true
 
     # Parse global options
+    # shellcheck disable=SC2034
     while [ $# -gt 0 ]; do
         case "$1" in
             --type)   FILTER_TYPE="$2"; shift 2 ;;

package/scripts/sw-adaptive.sh

@@ -1,12 +1,12 @@
 #!/usr/bin/env bash
 # ╔═══════════════════════════════════════════════════════════════════════════╗
 # ║  shipwright adaptive — data-driven pipeline tuning                       ║
-# ║  Replace 83+ hardcoded values with learned defaults from historical runs  ║
+# ║  Replace static defaults with learned values from historical runs         ║
 # ╚═══════════════════════════════════════════════════════════════════════════╝
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -31,6 +31,7 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
@@ -712,10 +713,10 @@ cmd_compare() {
         esac
     done
 
-    info "Learned vs Hardcoded Values for ${CYAN}${repo}${RESET}"
+    info "Learned vs Default Values for ${CYAN}${repo}${RESET}"
     echo ""
 
-    printf "%-25s %-15s %-15s %-15s\n" "Metric" "Hardcoded" "Learned" "Difference"
+    printf "%-25s %-15s %-15s %-15s\n" "Metric" "Default" "Learned" "Difference"
     printf "%s\n" "$(printf '%.0s─' {1..70})"
 
     # Timeout
@@ -841,7 +842,7 @@ ${BOLD}USAGE${RESET}
 
 ${BOLD}SUBCOMMANDS${RESET}
   ${CYAN}get${RESET} <metric> [--stage S] [--repo R] [--complexity C] [--default V]
-    Return adaptive value for a metric (replaces hardcoded defaults)
+    Return adaptive value for a metric (replaces static defaults)
     Metrics: timeout, iterations, model, team_size, template, poll_interval,
              retry_limit, quality_threshold, coverage_min
 
@@ -852,7 +853,7 @@ ${BOLD}SUBCOMMANDS${RESET}
     Rebuild models from events.jsonl (run after significant pipeline activity)
 
   ${CYAN}compare${RESET} [--repo REPO]
-    Side-by-side table: learned vs hardcoded values
+    Side-by-side table: learned vs default values
 
   ${CYAN}recommend${RESET} --issue N [--repo REPO]
     Full JSON recommendation for an issue (template, model, team_size, etc.)
@@ -876,7 +877,7 @@ ${BOLD}EXAMPLES${RESET}
   # Get complete recommendation for issue #42
   sw adaptive recommend --issue 42
 
-  # Compare learned vs hardcoded
+  # Compare learned vs defaults
   sw adaptive compare
 
 ${BOLD}STORAGE${RESET}

package/scripts/sw-adversarial.sh

@@ -6,7 +6,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
@@ -29,6 +29,7 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"

package/scripts/sw-architecture-enforcer.sh

@@ -6,7 +6,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
@@ -29,12 +29,14 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
   }
 fi
 # ─── Structured Event Log ────────────────────────────────────────────────
+# shellcheck disable=SC2034
 EVENTS_FILE="${HOME}/.shipwright/events.jsonl"
 
 # ─── Source Intelligence Core ─────────────────────────────────────────────

package/scripts/sw-auth.sh

@@ -6,8 +6,10 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+# shellcheck disable=SC2034
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC2034
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -30,7 +32,8 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
-    local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
+    local payload
+    payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
   }
@@ -40,6 +43,7 @@ AUTH_FILE="${HOME}/.shipwright/auth.json"
 DEVICE_FLOW_ENDPOINT="$(_config_get "urls.github_device_login" "https://github.com/login/device")"
 API_ENDPOINT="$(_config_get "urls.github_api" "https://api.github.com")"
 OAUTH_CLIENT_ID="${GITHUB_OAUTH_CLIENT_ID:-Iv1.d3f6a7e8c9b2a1d4}"  # Shipwright app ID
+# shellcheck disable=SC2034
 OAUTH_TIMEOUT=900  # 15 minutes
 
 # Ensure auth storage directory exists
@@ -202,6 +206,8 @@ store_user() {
 
     local temp_file
     temp_file=$(mktemp)
+    # shellcheck disable=SC2064
+    # shellcheck disable=SC2064
     trap "rm -f '$temp_file'" RETURN
 
     local updated
@@ -246,6 +252,8 @@ switch_user() {
 
     local temp_file
     temp_file=$(mktemp)
+    # shellcheck disable=SC2064
+    # shellcheck disable=SC2064
     trap "rm -f '$temp_file'" RETURN
 
     jq --arg login "$login" '.active_user = $login' "$AUTH_FILE" > "$temp_file"
@@ -261,6 +269,8 @@ remove_user() {
 
     local temp_file
     temp_file=$(mktemp)
+    # shellcheck disable=SC2064
+    # shellcheck disable=SC2064
     trap "rm -f '$temp_file'" RETURN
 
     jq --arg login "$login" \

package/scripts/sw-autonomous.sh

@@ -7,7 +7,8 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+# shellcheck disable=SC2034
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
@@ -29,6 +30,7 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
@@ -53,6 +55,7 @@ STATE_DIR="${HOME}/.shipwright/autonomous"
 STATE_FILE="${STATE_DIR}/state.json"
 HISTORY_FILE="${STATE_DIR}/history.jsonl"
 CONFIG_FILE="${STATE_DIR}/config.json"
+# shellcheck disable=SC2034
 CYCLE_COUNTER="${STATE_DIR}/cycle-counter.txt"
 AUTONOMOUS_OVERLAP_FILE="${HOME}/.shipwright/autonomous-state.json"
 
@@ -581,6 +584,7 @@ record_finding_pending() {
     local issue_num="$1"
     local finding_title="$2"
     ensure_state_dir
+    # shellcheck disable=SC2034
     local state_file="${STATE_DIR}/state.json"
     local pending_file="${STATE_DIR}/pending_findings.jsonl"
     [[ ! -f "$pending_file" ]] && touch "$pending_file"

package/scripts/sw-changelog.sh

@@ -7,7 +7,8 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+# shellcheck disable=SC2034
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
@@ -29,6 +30,7 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
@@ -109,6 +111,7 @@ parse_commits() {
     docs_changes=""
     chores=""
     local contributors=""
+    # shellcheck disable=SC2034
     local pr_links=""
 
     while IFS='|' read -r hash author email date subject body; do

package/scripts/sw-checkpoint.sh

@@ -8,7 +8,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -30,6 +30,7 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"

package/scripts/sw-ci.sh

@@ -6,8 +6,9 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="3.1.0"
+VERSION="3.3.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck disable=SC2034
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -29,6 +30,7 @@ fi
 if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
   emit_event() {
     local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
+    # shellcheck disable=SC2155
     local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
     while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
@@ -77,6 +79,7 @@ jobs:
         stage_config=$(jq ".stages[] | select(.id==\"$stage_id\")" "$pipeline_config" 2>/dev/null || echo "{}")
 
         local gate
+        # shellcheck disable=SC2034
         gate=$(jq -r '.gate // "auto"' <<< "$stage_config")
 
         yaml_content+="  ${stage_id}:
@@ -227,15 +230,20 @@ cmd_analyze() {
     info "Analyzing workflow efficiency"
 
     local job_count step_count matrix_enabled
-    job_count=$(grep -c "^  [a-z_-]*:" "$workflow_file" 2>/dev/null || echo "0")
-    step_count=$(grep -c "      - name:" "$workflow_file" 2>/dev/null || echo "0")
-    matrix_enabled=$(grep -c "matrix:" "$workflow_file" 2>/dev/null || echo "0")
+    job_count=$(grep -c "^  [a-z_-]*:" "$workflow_file" 2>/dev/null || true)
+    job_count="${job_count:-0}"
+    step_count=$(grep -c "      - name:" "$workflow_file" 2>/dev/null || true)
+    step_count="${step_count:-0}"
+    matrix_enabled=$(grep -c "matrix:" "$workflow_file" 2>/dev/null || true)
+    matrix_enabled="${matrix_enabled:-0}"
 
     local has_cache
-    has_cache=$(grep -c "actions/cache" "$workflow_file" 2>/dev/null || echo "0")
+    has_cache=$(grep -c "actions/cache" "$workflow_file" 2>/dev/null || true)
+    has_cache="${has_cache:-0}"
 
     local has_timeout
-    has_timeout=$(grep -c "timeout-minutes:" "$workflow_file" 2>/dev/null || echo "0")
+    has_timeout=$(grep -c "timeout-minutes:" "$workflow_file" 2>/dev/null || true)
+    has_timeout="${has_timeout:-0}"
 
     echo ""
     echo -e "${BOLD}Workflow Analysis: $(basename "$workflow_file")${RESET}"
@@ -296,6 +304,7 @@ cmd_secrets() {
             info "Checking secret availability in GitHub"
 
             local repo="${2:-.}"
+            # shellcheck disable=SC2034
             local owner org_name
 
             # Parse owner from git remote

package/scripts/sw-cleanup.sh

@@ -5,38 +5,16 @@
 # ║  Default: dry-run (shows what would be cleaned).                         ║
 # ║  Use --force to actually kill sessions and remove files.                 ║
 # ╚═══════════════════════════════════════════════════════════════════════════╝
-VERSION="3.1.0"
+# shellcheck disable=SC2034
+VERSION="3.3.0"
 set -euo pipefail
-trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/bootstrap.sh
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/lib/bootstrap.sh"
 
-# Canonical helpers (colors, output, events)
-# shellcheck source=lib/helpers.sh
-[[ -f "$SCRIPT_DIR/lib/helpers.sh" ]] && source "$SCRIPT_DIR/lib/helpers.sh"
-# shellcheck source=lib/compat.sh
-[[ -f "$SCRIPT_DIR/lib/compat.sh" ]] && source "$SCRIPT_DIR/lib/compat.sh"
 [[ -f "$SCRIPT_DIR/lib/config.sh" ]] && source "$SCRIPT_DIR/lib/config.sh"
 
 PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-
-# Fallbacks when helpers not loaded (e.g. test env with overridden SCRIPT_DIR)
-[[ "$(type -t info 2>/dev/null)" == "function" ]]    || info()    { echo -e "\033[38;2;0;212;255m\033[1m▸\033[0m $*"; }
-[[ "$(type -t success 2>/dev/null)" == "function" ]] || success() { echo -e "\033[38;2;74;222;128m\033[1m✓\033[0m $*"; }
-[[ "$(type -t warn 2>/dev/null)" == "function" ]]    || warn()    { echo -e "\033[38;2;250;204;21m\033[1m⚠\033[0m $*"; }
-[[ "$(type -t error 2>/dev/null)" == "function" ]]   || error()   { echo -e "\033[38;2;248;113;113m\033[1m✗\033[0m $*" >&2; }
-if [[ "$(type -t now_iso 2>/dev/null)" != "function" ]]; then
-  now_iso()   { date -u +"%Y-%m-%dT%H:%M:%SZ"; }
-  now_epoch() { date +%s; }
-fi
-if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
-  emit_event() {
-    local event_type="$1"; shift; mkdir -p "${HOME}/.shipwright"
-    local payload="{\"ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"type\":\"$event_type\""
-    while [[ $# -gt 0 ]]; do local key="${1%%=*}" val="${1#*=}"; payload="${payload},\"${key}\":\"${val}\""; shift; done
-    echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
-  }
-fi
 # ─── Parse Args ──────────────────────────────────────────────────────────────
 
 FORCE=false