shipwright-cli 2.3.1 → 3.0.0

package/scripts/adapters/docker-deploy.sh

@@ -38,7 +38,7 @@ get_rollback_cmd() {
 }
 
 get_health_url() {
-    echo "http://localhost:3000/health"
+    echo "http://localhost:8767/health"
 }
 
 get_smoke_cmd() {

package/scripts/adapters/tmux-adapter.sh

@@ -14,9 +14,14 @@
 # Track spawned panes by agent name → pane ID (file-based for bash 3.2 compat)
 _TMUX_PANE_MAP="${TMPDIR:-/tmp}/shipwright-tmux-pane-map.$$"
 : > "$_TMUX_PANE_MAP"
-trap 'rm -f "$_TMUX_PANE_MAP"' EXIT
+trap '
+    if [[ -f "$_TMUX_PANE_MAP" ]] && [[ ! -s "$_TMUX_PANE_MAP" ]]; then
+        rm -f "$_TMUX_PANE_MAP"
+    fi
+' EXIT
 
 spawn_agent() {
+    [[ -z "${WINDOW_NAME:-}" ]] && { echo "ERROR: WINDOW_NAME not set" >&2; return 1; }
     local name="$1"
     local working_dir="${2:-#{pane_current_path}}"
     local command="${3:-}"
@@ -32,6 +37,11 @@ spawn_agent() {
         new_pane_id=$(tmux split-window -t "$WINDOW_NAME" -c "$working_dir" -P -F '#{pane_id}')
     fi
 
+    if [[ -z "$new_pane_id" ]]; then
+        echo "ERROR: Failed to create tmux pane for agent '$name'" >&2
+        return 1
+    fi
+
     # Record the mapping: name → pane_id
     echo "${name}=${new_pane_id}" >> "$_TMUX_PANE_MAP"
 

package/scripts/adapters/wezterm-adapter.sh

@@ -9,7 +9,7 @@
 # ╚═══════════════════════════════════════════════════════════════════════════╝
 
 # Verify wezterm CLI is available
-if ! command -v wezterm &>/dev/null; then
+if ! command -v wezterm >/dev/null 2>&1; then
     echo -e "\033[38;2;248;113;113m\033[1m✗\033[0m wezterm CLI not found. Install WezTerm first." >&2
     exit 1
 fi

package/scripts/check-version-consistency.sh

@@ -11,7 +11,7 @@ REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 
 CANONICAL=""
 if [[ -f "$REPO_ROOT/package.json" ]]; then
-  if command -v jq &>/dev/null; then
+  if command -v jq >/dev/null 2>&1; then
     CANONICAL="$(jq -r .version "$REPO_ROOT/package.json")"
   else
     CANONICAL="$(grep -oE '"version":\s*"[^"]+"' "$REPO_ROOT/package.json" | head -1 | sed 's/.*"\([^"]*\)".*/\1/')"

package/scripts/lib/architecture.sh

@@ -0,0 +1,126 @@
+# architecture.sh — Gather call-graph and dependency context for plan/design stages
+# Source from pipeline-stages. Requires compat (detect_primary_language).
+[[ -n "${_ARCHITECTURE_CONTEXT_LOADED:-}" ]] && return 0
+_ARCHITECTURE_CONTEXT_LOADED=1
+
+# Gather rich architecture context: structure, imports, modules, entry points, test map
+gather_architecture_context() {
+    local repo_root="${1:-.}"
+    local context=""
+
+    # 1. File structure
+    context="## Project Structure
+$(find "$repo_root" -type f \( -name '*.ts' -o -name '*.js' -o -name '*.py' -o -name '*.sh' -o -name '*.go' -o -name '*.rs' \) 2>/dev/null | grep -v node_modules | grep -v .git | head -100 | sort)
+
+"
+
+    # 2. Import/dependency graph (language-specific)
+    local lang=""
+    if type detect_primary_language >/dev/null 2>&1; then
+        lang=$(detect_primary_language "$repo_root" 2>/dev/null || echo "unknown")
+    else
+        lang="unknown"
+    fi
+
+    case "$lang" in
+        typescript|javascript|nodejs)
+            context="${context}## Import Graph (Top Dependencies)
+"
+            local imports=""
+            for dir in "$repo_root/src" "$repo_root/lib" "$repo_root/app"; do
+                [[ -d "$dir" ]] || continue
+                imports=$(grep -rh "^import .* from\|require(" "$dir" 2>/dev/null | \
+                    grep -oE "from ['\"]([^'\"]+)['\"]|require\\(['\"]([^'\"]+)['\"]\\)" | \
+                    sed "s/from ['\"]//;s/['\"]//g;s/require(//;s/)//g" | \
+                    sort | uniq -c | sort -rn | head -20)
+                [[ -n "$imports" ]] && context="${context}${imports}
+"
+            done
+            [[ -z "$imports" ]] && context="${context}(none detected)
+"
+
+            context="${context}## Module Export Counts
+"
+            local f
+            while IFS= read -r f; do
+                [[ -f "$f" ]] || continue
+                local exports=0
+                exports=$(grep -c "^export " "$f" 2>/dev/null || echo "0")
+                [[ "$exports" -gt 2 ]] 2>/dev/null && context="${context}  $(basename "$f"): $exports exports
+"
+            done < <(find "$repo_root/src" "$repo_root/lib" -name "*.ts" -o -name "*.js" 2>/dev/null | head -30)
+            ;;
+
+        python)
+            context="${context}## Import Graph (Top Dependencies)
+"
+            local py_imports=""
+            py_imports=$(find "$repo_root" -name "*.py" -type f 2>/dev/null | \
+                xargs grep -h "^from \|^import " 2>/dev/null | \
+                grep -v __pycache__ | sort | uniq -c | sort -rn | head -20)
+            context="${context}${py_imports}
+"
+            ;;
+
+        bash|shell)
+            context="${context}## Source Dependencies
+"
+            local sh_imports=""
+            [[ -d "$repo_root/scripts" ]] && \
+                sh_imports=$(grep -rh "^source \|^\. " "$repo_root/scripts" --include="*.sh" 2>/dev/null | \
+                    sort | uniq -c | sort -rn | head -20)
+            context="${context}${sh_imports}
+"
+            ;;
+        *)
+            context="${context}## Dependencies
+(Language: $lang — no specific import analysis)
+"
+            ;;
+    esac
+
+    # 3. Module boundaries (directories with >2 files = modules)
+    context="${context}## Module Boundaries
+"
+    local dir
+    while IFS= read -r dir; do
+        [[ -d "$dir" ]] || continue
+        local count=0
+        count=$(find "$dir" -maxdepth 1 -type f \( -name "*.ts" -o -name "*.js" -o -name "*.py" -o -name "*.sh" \) 2>/dev/null | wc -l | tr -d ' ')
+        [[ "$count" -gt 2 ]] 2>/dev/null && context="${context}  $(basename "$dir")/: $count files
+"
+    done < <(find "$repo_root/src" "$repo_root/lib" "$repo_root/scripts" -maxdepth 2 -type d 2>/dev/null | head -30)
+
+    # 4. Entry points
+    context="${context}## Entry Points
+"
+    if [[ -f "$repo_root/package.json" ]] && command -v jq >/dev/null 2>&1; then
+        local main
+        main=$(jq -r '.main // .bin // "index.js" | if type == "object" then (. | keys[0]) else . end' "$repo_root/package.json" 2>/dev/null || echo "")
+        [[ -n "$main" && "$main" != "null" ]] && context="${context}  package.json: $main
+"
+    fi
+    if [[ -f "$repo_root/Makefile" ]]; then
+        local targets
+        targets=$(grep '^[a-zA-Z][a-zA-Z0-9_-]*:' "$repo_root/Makefile" 2>/dev/null | cut -d: -f1 | head -10 | tr '\n' ', ')
+        [[ -n "$targets" ]] && context="${context}  Makefile targets: $targets
+"
+    fi
+
+    # 5. Test-to-source mapping
+    context="${context}## Test Coverage Map
+"
+    local test_file
+    while IFS= read -r test_file; do
+        [[ -f "$test_file" ]] || continue
+        local base
+        base=$(basename "$test_file" | sed 's/[-.]test//;s/[-.]spec//;s/__tests__//;s/\..*$//' | head -c 50)
+        [[ -z "$base" ]] && continue
+        local source
+        source=$(find "$repo_root/src" "$repo_root/lib" "$repo_root/scripts" -name "${base}.*" -type f 2>/dev/null | head -1)
+        [[ -n "$source" ]] && context="${context}  $test_file -> $source
+"
+    done < <(find "$repo_root" -path "*node_modules" -prune -o -path "*/.git" -prune -o \( -name "*test*" -o -name "*spec*" \) -type f -print 2>/dev/null | head -20)
+
+    echo "$context"
+}

package/scripts/lib/bootstrap.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  shipwright bootstrap — Cold-start initialization for optimization data  ║
+# ║  Creates sensible defaults when no historical data exists (new installs)  ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+
+# bootstrap_optimization — create default iteration model, template weights, model routing
+bootstrap_optimization() {
+    local opt_dir="$HOME/.shipwright/optimization"
+    mkdir -p "$opt_dir"
+
+    # Default iteration model based on common patterns
+    if [[ ! -f "$opt_dir/iteration-model.json" ]]; then
+        cat > "$opt_dir/iteration-model.json" << 'JSON'
+{
+    "low": {"mean": 5, "stddev": 2, "samples": 0, "source": "bootstrap"},
+    "medium": {"mean": 12, "stddev": 4, "samples": 0, "source": "bootstrap"},
+    "high": {"mean": 25, "stddev": 8, "samples": 0, "source": "bootstrap"}
+}
+JSON
+    fi
+
+    # Default template weights
+    if [[ ! -f "$opt_dir/template-weights.json" ]]; then
+        cat > "$opt_dir/template-weights.json" << 'JSON'
+{
+    "standard": 1.0,
+    "hotfix": 1.0,
+    "docs": 1.0,
+    "refactor": 1.0,
+    "source": "bootstrap"
+}
+JSON
+    fi
+
+    # Default model routing
+    if [[ ! -f "$opt_dir/model-routing.json" ]]; then
+        cat > "$opt_dir/model-routing.json" << 'JSON'
+{
+    "routes": {
+        "plan": {"recommended": "opus", "source": "bootstrap"},
+        "design": {"recommended": "opus", "source": "bootstrap"},
+        "build": {"recommended": "sonnet", "source": "bootstrap"},
+        "test": {"recommended": "sonnet", "source": "bootstrap"},
+        "review": {"recommended": "sonnet", "source": "bootstrap"}
+    },
+    "default": "sonnet",
+    "source": "bootstrap"
+}
+JSON
+    fi
+}
+
+# bootstrap_memory — create initial memory patterns based on project type
+bootstrap_memory() {
+    local mem_dir="$HOME/.shipwright/memory"
+    mkdir -p "$mem_dir"
+
+    if [[ ! -f "$mem_dir/patterns.json" ]]; then
+        # Detect project type and create initial patterns
+        local project_type="unknown"
+        [[ -f "package.json" ]] && project_type="nodejs"
+        [[ -f "requirements.txt" || -f "pyproject.toml" ]] && project_type="python"
+        [[ -f "Cargo.toml" ]] && project_type="rust"
+        [[ -f "go.mod" ]] && project_type="go"
+
+        cat > "$mem_dir/patterns.json" << JSON
+{
+    "project_type": "$project_type",
+    "detected_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+    "source": "bootstrap"
+}
+JSON
+    fi
+}

package/scripts/lib/compat.sh

@@ -9,11 +9,14 @@
 #
 # Provides:
 #   - NO_COLOR / dumb terminal / non-tty detection (auto-blanks color vars)
+#   - _to_lower() / _to_upper() — bash 3.2 compat (${var,,}/${var^^} require bash 4+)
+#   - file_mtime() — cross-platform file modification time (epoch)
 #   - sed_i()    — cross-platform sed in-place editing
 #   - open_url() — cross-platform browser open
 #   - tmp_dir()  — returns best temp directory for platform
 #   - is_wsl()   — detect WSL environment
 #   - is_macos() / is_linux() — platform checks
+#   - _timeout() — run command with timeout (timeout/gtimeout or no-op on macOS)
 
 # ─── NO_COLOR support (https://no-color.org/) ─────────────────────────────
 # Blanks standard color variables when:
@@ -30,6 +33,11 @@ _COMPAT_UNAME="${_COMPAT_UNAME:-$(uname -s 2>/dev/null || echo "Unknown")}"
 
 is_macos() { [[ "$_COMPAT_UNAME" == "Darwin" ]]; }
 is_linux() { [[ "$_COMPAT_UNAME" == "Linux" ]]; }
+
+# ─── Bash 3.2 compat (macOS ships bash 3.2) ───────────────────────────────
+# Case conversion: ${var,,} and ${var^^} require bash 4+. Use these instead:
+_to_lower() { echo "$1" | tr '[:upper:]' '[:lower:]'; }
+_to_upper() { echo "$1" | tr '[:lower:]' '[:upper:]'; }
 is_wsl()   { is_linux && [[ -n "${WSL_DISTRO_NAME:-}" || -f /proc/version ]] && grep -qi microsoft /proc/version 2>/dev/null; }
 
 # ─── sed -i (macOS vs GNU) ────────────────────────────────────────────────
@@ -49,14 +57,14 @@ open_url() {
         open "$url"
     elif is_wsl; then
         # WSL: use wslview (from wslu) or powershell
-        if command -v wslview &>/dev/null; then
+        if command -v wslview >/dev/null 2>&1; then
             wslview "$url"
-        elif command -v powershell.exe &>/dev/null; then
+        elif command -v powershell.exe >/dev/null 2>&1; then
             powershell.exe -Command "Start-Process '$url'" 2>/dev/null
         else
             return 1
         fi
-    elif command -v xdg-open &>/dev/null; then
+    elif command -v xdg-open >/dev/null 2>&1; then
         xdg-open "$url"
     else
         return 1
@@ -83,7 +91,7 @@ sw_valid_error_category() {
     local category="${1:-}"
     local custom_file="$HOME/.shipwright/optimization/error-taxonomy.json"
     # Check custom taxonomy first
-    if [[ -f "$custom_file" ]] && command -v jq &>/dev/null; then
+    if [[ -f "$custom_file" ]] && command -v jq >/dev/null 2>&1; then
         local custom_cats
         custom_cats=$(jq -r '.categories[]? // empty' "$custom_file" 2>/dev/null || true)
         if [[ -n "$custom_cats" ]]; then
@@ -113,7 +121,7 @@ complexity_bucket() {
     local config_file="$HOME/.shipwright/optimization/complexity-clusters.json"
     local low_boundary=3
     local high_boundary=6
-    if [[ -f "$config_file" ]] && command -v jq &>/dev/null; then
+    if [[ -f "$config_file" ]] && command -v jq >/dev/null 2>&1; then
         local lb hb
         lb=$(jq -r '.low_boundary // 3' "$config_file" 2>/dev/null || echo "3")
         hb=$(jq -r '.high_boundary // 6' "$config_file" 2>/dev/null || echo "6")
@@ -156,7 +164,7 @@ detect_primary_language() {
 
 detect_test_framework() {
     local dir="${1:-.}"
-    if [[ -f "$dir/package.json" ]] && command -v jq &>/dev/null; then
+    if [[ -f "$dir/package.json" ]] && command -v jq >/dev/null 2>&1; then
         local runner
         runner=$(jq -r '
             if .devDependencies.vitest then "vitest"
@@ -184,6 +192,81 @@ detect_test_framework() {
     fi
 }
 
+# ─── Cross-platform file modification time (epoch) ────────────────────────
+# macOS/BSD: stat -f %m; Linux: stat -c '%Y'
+file_mtime() {
+    local file="$1"
+    stat -f %m "$file" 2>/dev/null || stat -c '%Y' "$file" 2>/dev/null || echo "0"
+}
+
+# ─── Timeout command (macOS may lack timeout; gtimeout from coreutils) ─────
+# Usage: _timeout <seconds> <command> [args...]
+_timeout() {
+    local secs="$1"
+    shift
+    if command -v timeout >/dev/null 2>&1; then
+        timeout "$secs" "$@"
+    elif command -v gtimeout >/dev/null 2>&1; then
+        gtimeout "$secs" "$@"
+    else
+        # Fallback: run without timeout (e.g. on older macOS)
+        "$@"
+    fi
+}
+
+# ─── Cross-platform date helpers (GNU date -d vs BSD date -j/-v) ──────────
+# date_to_epoch: convert date string to Unix epoch
+# date_days_ago: YYYY-MM-DD for N days ago
+# date_add_days: YYYY-MM-DD for base_date + N days
+# epoch_to_iso: convert epoch to ISO 8601
+date_to_epoch() {
+    local datestr="$1"
+    local fmt=""
+    if [[ "$datestr" == *"T"* ]]; then
+        fmt="%Y-%m-%dT%H:%M:%SZ"
+    else
+        fmt="%Y-%m-%d"
+    fi
+    if date -u -d "$datestr" +%s 2>/dev/null; then
+        return
+    fi
+    # BSD date: -j = don't set date, -f = format
+    date -u -j -f "$fmt" "$datestr" +%s 2>/dev/null || echo "0"
+}
+
+date_days_ago() {
+    local days="$1"
+    if date -u -d "$days days ago" +%Y-%m-%d 2>/dev/null; then
+        return
+    fi
+    date -u -v-${days}d +%Y-%m-%d 2>/dev/null || echo "1970-01-01"
+}
+
+date_add_days() {
+    local base_date="$1"
+    local days="$2"
+    if date -u -d "${base_date} + ${days} days" +%Y-%m-%d 2>/dev/null; then
+        return
+    fi
+    # BSD: compute via epoch arithmetic
+    local base_epoch
+    base_epoch=$(date_to_epoch "$base_date")
+    if [[ -n "$base_epoch" && "$base_epoch" != "0" ]]; then
+        local result_epoch=$((base_epoch + (days * 86400)))
+        date -u -r "$result_epoch" +%Y-%m-%d 2>/dev/null || date -u -d "@$result_epoch" +%Y-%m-%d 2>/dev/null || echo "1970-01-01"
+    else
+        echo "1970-01-01"
+    fi
+}
+
+epoch_to_iso() {
+    local epoch="$1"
+    date -u -r "$epoch" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || \
+    date -u -d "@$epoch" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || \
+    python3 -c "import datetime; print(datetime.datetime.utcfromtimestamp($epoch).strftime('%Y-%m-%dT%H:%M:%SZ'))" 2>/dev/null || \
+    echo "1970-01-01T00:00:00Z"
+}
+
 # ─── Cross-platform MD5 ──────────────────────────────────────────────────
 # Usage:
 #   compute_md5 --string "some text"   → md5 hash of string

package/scripts/lib/config.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# config.sh — Centralized configuration reader for Shipwright
+# Precedence: SHIPWRIGHT_* env var > daemon-config.json > policy.json > defaults.json
+# Usage: source "$SCRIPT_DIR/lib/config.sh"
+#        val=$(_config_get "daemon.poll_interval")
+[[ -n "${_SW_CONFIG_LOADED:-}" ]] && return 0
+_SW_CONFIG_LOADED=1
+
+_CONFIG_SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+_CONFIG_REPO_DIR="$(cd "$_CONFIG_SCRIPT_DIR/../.." 2>/dev/null && pwd || echo "")"
+
+_DEFAULTS_FILE="${_CONFIG_REPO_DIR}/config/defaults.json"
+_POLICY_FILE="${_CONFIG_REPO_DIR}/config/policy.json"
+_DAEMON_CONFIG_FILE=".claude/daemon-config.json"
+
+# Resolve daemon config relative to git root or cwd
+if [[ ! -f "$_DAEMON_CONFIG_FILE" ]]; then
+    local_root="$(git rev-parse --show-toplevel 2>/dev/null || echo ".")"
+    _DAEMON_CONFIG_FILE="${local_root}/.claude/daemon-config.json"
+fi
+
+# _config_get "section.key" [default]
+# Reads config with full precedence chain
+_config_get() {
+    local dotpath="$1"
+    local fallback="${2:-}"
+
+    # 1. Check env var: daemon.poll_interval -> SHIPWRIGHT_DAEMON_POLL_INTERVAL
+    local env_name="SHIPWRIGHT_$(echo "$dotpath" | tr '[:lower:].' '[:upper:]_')"
+    local env_val="${!env_name:-}"
+    if [[ -n "$env_val" ]]; then
+        echo "$env_val"
+        return 0
+    fi
+
+    # Convert dotpath to jq path: "daemon.poll_interval" -> ".daemon.poll_interval"
+    local jq_path=".${dotpath}"
+
+    # 2. Check daemon-config.json
+    if [[ -f "$_DAEMON_CONFIG_FILE" ]]; then
+        local val
+        val=$(jq -r "${jq_path} // \"\"" "$_DAEMON_CONFIG_FILE" 2>/dev/null || echo "")
+        if [[ -n "$val" && "$val" != "null" ]]; then
+            echo "$val"
+            return 0
+        fi
+    fi
+
+    # 3. Check policy.json
+    if [[ -f "$_POLICY_FILE" ]]; then
+        local val
+        val=$(jq -r "${jq_path} // \"\"" "$_POLICY_FILE" 2>/dev/null || echo "")
+        if [[ -n "$val" && "$val" != "null" ]]; then
+            echo "$val"
+            return 0
+        fi
+    fi
+
+    # 4. Check defaults.json
+    if [[ -f "$_DEFAULTS_FILE" ]]; then
+        local val
+        val=$(jq -r "${jq_path} // \"\"" "$_DEFAULTS_FILE" 2>/dev/null || echo "")
+        if [[ -n "$val" && "$val" != "null" ]]; then
+            echo "$val"
+            return 0
+        fi
+    fi
+
+    # 5. Return fallback
+    echo "$fallback"
+}
+
+# _config_get_int "section.key" [default]
+# Same as _config_get but ensures integer output
+_config_get_int() {
+    local val
+    val=$(_config_get "$1" "${2:-0}")
+    # Strip non-numeric
+    echo "${val//[!0-9-]/}"
+}
+
+# _config_get_bool "section.key" [default]
+# Returns 0 (true) or 1 (false) for use in conditionals
+_config_get_bool() {
+    local val
+    val=$(_config_get "$1" "${2:-false}")
+    case "$val" in
+        true|1|yes|on) return 0 ;;
+        *) return 1 ;;
+    esac
+}

package/scripts/lib/daemon-adaptive.sh

@@ -85,9 +85,9 @@ get_adaptive_heartbeat_timeout() {
 
     # Stage-specific defaults (daemon-health.sh when sourced, else policy_get, else literal)
     local default_timeout="${HEALTH_HEARTBEAT_TIMEOUT:-120}"
-    if type daemon_health_timeout_for_stage &>/dev/null 2>&1; then
+    if type daemon_health_timeout_for_stage >/dev/null 2>&1; then
         default_timeout=$(daemon_health_timeout_for_stage "$stage" "$default_timeout")
-    elif type policy_get &>/dev/null 2>&1; then
+    elif type policy_get >/dev/null 2>&1; then
         local policy_stage
         policy_stage=$(policy_get ".daemon.stage_timeouts.$stage" "")
         [[ -n "$policy_stage" && "$policy_stage" =~ ^[0-9]+$ ]] && default_timeout="$policy_stage"
@@ -385,7 +385,7 @@ daemon_assess_progress() {
         ' "$progress_file" > "$tmp_progress" 2>/dev/null && mv "$tmp_progress" "$progress_file"
 
     # ── Vitals-based verdict (preferred over static thresholds) ──
-    if type pipeline_compute_vitals &>/dev/null 2>&1 && type pipeline_health_verdict &>/dev/null 2>&1; then
+    if type pipeline_compute_vitals >/dev/null 2>&1 && type pipeline_health_verdict >/dev/null 2>&1; then
         # Compute vitals using the worktree's pipeline state if available
         local _worktree_state=""
         local _worktree_artifacts=""