shipwright-cli 2.4.0 → 3.1.0

package/scripts/sw-daemon.sh

@@ -9,7 +9,7 @@ trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 # Allow spawning Claude CLI from within a Claude Code session (daemon, fleet, etc.)
 unset CLAUDECODE 2>/dev/null || true
 
-VERSION="2.4.0"
+VERSION="3.1.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
@@ -20,6 +20,7 @@ REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 # Canonical helpers (colors, output, events)
 # shellcheck source=lib/helpers.sh
 [[ -f "$SCRIPT_DIR/lib/helpers.sh" ]] && source "$SCRIPT_DIR/lib/helpers.sh"
+[[ -f "$SCRIPT_DIR/lib/config.sh" ]] && source "$SCRIPT_DIR/lib/config.sh"
 # 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 $*"; }
@@ -29,23 +30,6 @@ 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
-CYAN="${CYAN:-\033[38;2;0;212;255m}"
-PURPLE="${PURPLE:-\033[38;2;124;58;237m}"
-BLUE="${BLUE:-\033[38;2;0;102;255m}"
-GREEN="${GREEN:-\033[38;2;74;222;128m}"
-YELLOW="${YELLOW:-\033[38;2;250;204;21m}"
-RED="${RED:-\033[38;2;248;113;113m}"
-DIM="${DIM:-\033[2m}"
-BOLD="${BOLD:-\033[1m}"
-RESET="${RESET:-\033[0m}"
 
 # Policy (config/policy.json) — daemon defaults when daemon-config.json missing or silent
 [[ -f "$SCRIPT_DIR/lib/policy.sh" ]] && source "$SCRIPT_DIR/lib/policy.sh"
@@ -109,28 +93,6 @@ format_duration() {
     fi
 }
 
-# ─── Structured Event Log ──────────────────────────────────────────────────
-EVENTS_FILE="${HOME}/.shipwright/events.jsonl"
-
-emit_event() {
-    local event_type="$1"
-    shift
-    local json_fields=""
-    for kv in "$@"; do
-        local key="${kv%%=*}"
-        local val="${kv#*=}"
-        if [[ "$val" =~ ^-?[0-9]+\.?[0-9]*$ ]]; then
-            json_fields="${json_fields},\"${key}\":${val}"
-        else
-            local escaped_val
-            escaped_val=$(printf '%s' "$val" | jq -Rs '.' 2>/dev/null || printf '"%s"' "${val//\"/\\\"}")
-            json_fields="${json_fields},\"${key}\":${escaped_val}"
-        fi
-    done
-    mkdir -p "${HOME}/.shipwright"
-    echo "{\"ts\":\"$(now_iso)\",\"ts_epoch\":$(now_epoch),\"type\":\"${event_type}\"${json_fields}}" >> "$EVENTS_FILE"
-}
-
 # ─── Event Log Rotation ─────────────────────────────────────────────────────
 rotate_event_log() {
     local max_size=$((50 * 1024 * 1024))  # 50MB
@@ -167,8 +129,8 @@ rotate_event_log() {
 daemon_github_context() {
     # Skip if no GitHub
     [[ "${NO_GITHUB:-false}" == "true" ]] && return 0
-    type gh_repo_context &>/dev/null 2>&1 || return 0
-    type _gh_detect_repo &>/dev/null 2>&1 || return 0
+    type gh_repo_context >/dev/null 2>&1 || return 0
+    type _gh_detect_repo >/dev/null 2>&1 || return 0
 
     _gh_detect_repo 2>/dev/null || return 0
     local owner="${GH_OWNER:-}" repo="${GH_REPO:-}"
@@ -192,8 +154,8 @@ gh_retry() {
 
     while [[ $attempt -lt $max_retries ]]; do
         attempt=$((attempt + 1))
-        # Run the gh command; capture exit code
-        if output=$("$@" 2>&1); then
+        # Run the gh command with per-call timeout; capture exit code
+        if output=$(_timeout "$(_config_get_int "network.gh_timeout" 30 2>/dev/null || echo 30)" "$@" 2>&1); then
             echo "$output"
             return 0
         fi
@@ -227,17 +189,18 @@ LOG_DIR=""
 WORKTREE_DIR=""
 
 # Config defaults (overridden by daemon-config.json; policy overrides when present)
-WATCH_LABEL="ready-to-build"
-POLL_INTERVAL=60
-if type policy_get &>/dev/null 2>&1; then
+WATCH_LABEL="$(_config_get "labels.watch" "shipwright" 2>/dev/null || echo "shipwright")"
+POLL_INTERVAL=$(_config_get_int "daemon.poll_interval" 60 2>/dev/null || echo 60)
+if type policy_get >/dev/null 2>&1; then
     POLL_INTERVAL=$(policy_get ".daemon.poll_interval_seconds" "60")
 fi
-MAX_PARALLEL=2
+MAX_PARALLEL=$(_config_get_int "daemon.max_parallel" 4 2>/dev/null || echo 4)
+ISSUE_LIMIT=$(_config_get_int "daemon.issue_limit" 100 2>/dev/null || echo 100)
 PIPELINE_TEMPLATE="autonomous"
 SKIP_GATES=true
 MODEL="opus"
 BASE_BRANCH="main"
-ON_SUCCESS_REMOVE_LABEL="ready-to-build"
+ON_SUCCESS_REMOVE_LABEL="shipwright"
 ON_SUCCESS_ADD_LABEL="pipeline/complete"
 ON_SUCCESS_CLOSE_ISSUE=false
 ON_FAILURE_ADD_LABEL="pipeline/failed"
@@ -257,7 +220,7 @@ REPO_FILTER=""
 # Auto-scaling defaults (policy overrides when present)
 AUTO_SCALE=false
 AUTO_SCALE_INTERVAL=5
-if type policy_get &>/dev/null 2>&1; then
+if type policy_get >/dev/null 2>&1; then
     AUTO_SCALE_INTERVAL=$(policy_get ".daemon.auto_scale_interval_cycles" "5")
 fi
 MAX_WORKERS=8
@@ -280,7 +243,7 @@ PATROL_RETRY_THRESHOLD=2
 LAST_PATROL_EPOCH=0
 
 # Team dashboard coordination
-DASHBOARD_URL="${DASHBOARD_URL:-http://localhost:8767}"
+DASHBOARD_URL="${DASHBOARD_URL:-$(_config_get "dashboard.url" "http://localhost:8767" 2>/dev/null || echo "http://localhost:8767")}"
 
 # Runtime
 NO_GITHUB=false
@@ -370,7 +333,7 @@ show_help() {
     echo -e "  ${DIM}shipwright daemon patrol --once${RESET}               # Run patrol once and exit"
     echo ""
     echo -e "${BOLD}CONFIG FILE${RESET}  ${DIM}(.claude/daemon-config.json)${RESET}"
-    echo -e "  ${DIM}watch_label${RESET}         GitHub label to watch for         ${DIM}(default: ready-to-build)${RESET}"
+    echo -e "  ${DIM}watch_label${RESET}         GitHub label to watch for         ${DIM}(default: shipwright)${RESET}"
     echo -e "  ${DIM}poll_interval${RESET}       Seconds between polls             ${DIM}(default: 60)${RESET}"
     echo -e "  ${DIM}max_parallel${RESET}        Max concurrent pipeline jobs      ${DIM}(default: 2)${RESET}"
     echo -e "  ${DIM}pipeline_template${RESET}   Pipeline template to use          ${DIM}(default: autonomous)${RESET}"
@@ -411,16 +374,17 @@ load_config() {
 
     info "Loading config: ${DIM}${config_file}${RESET}"
 
-    WATCH_LABEL=$(jq -r '.watch_label // "ready-to-build"' "$config_file")
-    POLL_INTERVAL=$(jq -r '.poll_interval // '"$(type policy_get &>/dev/null 2>&1 && policy_get ".daemon.poll_interval_seconds" "60" || echo "60")"'' "$config_file")
+    WATCH_LABEL=$(jq -r '.watch_label // "shipwright"' "$config_file")
+    POLL_INTERVAL=$(jq -r '.poll_interval // '"$(type policy_get >/dev/null 2>&1 && policy_get ".daemon.poll_interval_seconds" "60" || echo "60")"'' "$config_file")
     MAX_PARALLEL=$(jq -r '.max_parallel // 2' "$config_file")
+    ISSUE_LIMIT=$(jq -r '.issue_limit // 100' "$config_file")
     PIPELINE_TEMPLATE=$(jq -r '.pipeline_template // "autonomous"' "$config_file")
     SKIP_GATES=$(jq -r '.skip_gates // true' "$config_file")
     MODEL=$(jq -r '.model // "opus"' "$config_file")
     BASE_BRANCH=$(jq -r '.base_branch // "main"' "$config_file")
 
     # on_success settings
-    ON_SUCCESS_REMOVE_LABEL=$(jq -r '.on_success.remove_label // "ready-to-build"' "$config_file")
+    ON_SUCCESS_REMOVE_LABEL=$(jq -r '.on_success.remove_label // "shipwright"' "$config_file")
     ON_SUCCESS_ADD_LABEL=$(jq -r '.on_success.add_label // "pipeline/complete"' "$config_file")
     ON_SUCCESS_CLOSE_ISSUE=$(jq -r '.on_success.close_issue // false' "$config_file")
 
@@ -472,12 +436,41 @@ load_config() {
 
     # self-optimization
     SELF_OPTIMIZE=$(jq -r '.self_optimize // false' "$config_file")
-    OPTIMIZE_INTERVAL=$(jq -r '.optimize_interval // '"$(type policy_get &>/dev/null 2>&1 && policy_get ".daemon.optimize_interval_cycles" "10" || echo "10")"'' "$config_file")
+    OPTIMIZE_INTERVAL=$(jq -r '.optimize_interval // '"$(type policy_get >/dev/null 2>&1 && policy_get ".daemon.optimize_interval_cycles" "10" || echo "10")"'' "$config_file")
 
-    # intelligence engine settings
-    INTELLIGENCE_ENABLED=$(jq -r '.intelligence.enabled // false' "$config_file")
+    # intelligence engine settings (default "auto" = enable when Claude CLI available)
+    INTELLIGENCE_ENABLED=$(jq -r '.intelligence.enabled // "auto"' "$config_file")
     INTELLIGENCE_CACHE_TTL=$(jq -r '.intelligence.cache_ttl_seconds // 3600' "$config_file")
-    COMPOSER_ENABLED=$(jq -r '.intelligence.composer_enabled // false' "$config_file")
+    COMPOSER_ENABLED=$(jq -r '.intelligence.composer_enabled // "auto"' "$config_file")
+
+    # Auto-enable intelligence when Claude is available (unless explicitly disabled)
+    if [[ "${INTELLIGENCE_ENABLED}" == "false" && "${INTELLIGENCE_EXPLICIT_DISABLE:-false}" != "true" ]]; then
+        if command -v claude &>/dev/null; then
+            INTELLIGENCE_ENABLED=true
+            type daemon_log &>/dev/null && daemon_log INFO "Intelligence auto-enabled (Claude CLI detected). Disable with intelligence.enabled=false in daemon-config.json"
+        fi
+    elif [[ "${INTELLIGENCE_ENABLED}" == "auto" ]]; then
+        if command -v claude &>/dev/null; then
+            INTELLIGENCE_ENABLED=true
+            type daemon_log &>/dev/null && daemon_log INFO "Intelligence enabled (auto: Claude CLI detected)"
+        else
+            INTELLIGENCE_ENABLED=false
+        fi
+    fi
+
+    # Auto-enable composer when Claude is available (unless explicitly disabled)
+    if [[ "${COMPOSER_ENABLED}" == "false" && "${COMPOSER_EXPLICIT_DISABLE:-false}" != "true" ]]; then
+        if command -v claude &>/dev/null; then
+            COMPOSER_ENABLED=true
+            type daemon_log &>/dev/null && daemon_log INFO "Composer auto-enabled (Claude CLI detected). Disable with intelligence.composer_enabled=false in daemon-config.json"
+        fi
+    elif [[ "${COMPOSER_ENABLED}" == "auto" ]]; then
+        if command -v claude &>/dev/null; then
+            COMPOSER_ENABLED=true
+        else
+            COMPOSER_ENABLED=false
+        fi
+    fi
     OPTIMIZATION_ENABLED=$(jq -r '.intelligence.optimization_enabled // false' "$config_file")
     PREDICTION_ENABLED=$(jq -r '.intelligence.prediction_enabled // false' "$config_file")
     ANOMALY_THRESHOLD=$(jq -r '.intelligence.anomaly_threshold // 3.0' "$config_file")
@@ -491,7 +484,7 @@ load_config() {
 
     # stale state reaper: clean old worktrees, artifacts, state entries
     STALE_REAPER_ENABLED=$(jq -r '.stale_reaper // true' "$config_file")
-    STALE_REAPER_INTERVAL=$(jq -r '.stale_reaper_interval // '"$(type policy_get &>/dev/null 2>&1 && policy_get ".daemon.stale_reaper_interval_cycles" "10" || echo "10")"'' "$config_file")
+    STALE_REAPER_INTERVAL=$(jq -r '.stale_reaper_interval // '"$(type policy_get >/dev/null 2>&1 && policy_get ".daemon.stale_reaper_interval_cycles" "10" || echo "10")"'' "$config_file")
     STALE_REAPER_AGE_DAYS=$(jq -r '.stale_reaper_age_days // 7' "$config_file")
 
     # priority lane settings
@@ -508,21 +501,21 @@ load_config() {
 
     # auto-scaling
     AUTO_SCALE=$(jq -r '.auto_scale // false' "$config_file")
-    AUTO_SCALE_INTERVAL=$(jq -r '.auto_scale_interval // '"$(type policy_get &>/dev/null 2>&1 && policy_get ".daemon.auto_scale_interval_cycles" "5" || echo "5")"'' "$config_file")
+    AUTO_SCALE_INTERVAL=$(jq -r '.auto_scale_interval // '"$(type policy_get >/dev/null 2>&1 && policy_get ".daemon.auto_scale_interval_cycles" "5" || echo "5")"'' "$config_file")
     MAX_WORKERS=$(jq -r '.max_workers // 8' "$config_file")
     MIN_WORKERS=$(jq -r '.min_workers // 1' "$config_file")
     WORKER_MEM_GB=$(jq -r '.worker_mem_gb // 4' "$config_file")
     EST_COST_PER_JOB=$(jq -r '.estimated_cost_per_job_usd // 5.0' "$config_file")
 
     # heartbeat + checkpoint recovery (policy fallback when config silent)
-    HEALTH_HEARTBEAT_TIMEOUT=$(jq -r '.health.heartbeat_timeout_s // '"$(type policy_get &>/dev/null 2>&1 && policy_get ".daemon.health_heartbeat_timeout" "120" || echo "120")"'' "$config_file")
+    HEALTH_HEARTBEAT_TIMEOUT=$(jq -r '.health.heartbeat_timeout_s // '"$(type policy_get >/dev/null 2>&1 && policy_get ".daemon.health_heartbeat_timeout" "120" || echo "120")"'' "$config_file")
     CHECKPOINT_ENABLED=$(jq -r '.health.checkpoint_enabled // true' "$config_file")
 
     # progress-based health monitoring (replaces static timeouts)
     PROGRESS_MONITORING=$(jq -r '.health.progress_based // true' "$config_file")
     PROGRESS_CHECKS_BEFORE_WARN=$(jq -r '.health.stale_checks_before_warn // 20' "$config_file")
     PROGRESS_CHECKS_BEFORE_KILL=$(jq -r '.health.stale_checks_before_kill // 120' "$config_file")
-    PROGRESS_HARD_LIMIT_S=$(jq -r '.health.hard_limit_s // 0' "$config_file")  # 0 = disabled (no hard kill)
+    PROGRESS_HARD_LIMIT_S=$(jq -r '.health.hard_limit_s // 21600' "$config_file")  # 21600s = 6h default; 0 = disabled
     NUDGE_ENABLED=$(jq -r '.health.nudge_enabled // true' "$config_file")
     NUDGE_AFTER_CHECKS=$(jq -r '.health.nudge_after_checks // 40' "$config_file")
 
@@ -603,6 +596,18 @@ cleanup_on_exit() {
                 done <<< "$child_pids"
             fi
         fi
+
+        # Release claims on active issues before exit
+        local active_issues
+        active_issues=$(jq -r '.active_jobs[].issue // empty' "$STATE_FILE" 2>/dev/null || true)
+        if [[ -n "$active_issues" ]]; then
+            local machine_name
+            machine_name=$(jq -r '.machines[] | select(.role == "primary") | .name' "$HOME/.shipwright/machines.json" 2>/dev/null || hostname -s)
+            for issue_num in $active_issues; do
+                [[ -z "$issue_num" ]] && continue
+                release_claim "$issue_num" "$machine_name" 2>/dev/null || true
+            done
+        fi
     fi
 
     rm -f "$PID_FILE" "$SHUTDOWN_FLAG"
@@ -647,7 +652,7 @@ daemon_start() {
 
     # Detach mode: re-exec in a tmux session
     if [[ "$DETACH" == "true" ]]; then
-        if ! command -v tmux &>/dev/null; then
+        if ! command -v tmux >/dev/null 2>&1; then
             error "tmux required for --detach mode"
             exit 1
         fi
@@ -689,7 +694,7 @@ daemon_start() {
     rm -f "$SHUTDOWN_FLAG"
 
     # Initialize SQLite database (if available)
-    if type init_schema &>/dev/null; then
+    if type init_schema >/dev/null 2>&1; then
         init_schema 2>/dev/null || true
     fi
 
@@ -761,7 +766,7 @@ daemon_start() {
         if [[ -f "$STATE_FILE" ]]; then
             if ! jq '.' "$STATE_FILE" >/dev/null 2>&1; then
                 daemon_log WARN "Watchdog: state file corrupt — recovering from backup"
-                type validate_json &>/dev/null 2>&1 && validate_json "$STATE_FILE" || true
+                type validate_json >/dev/null 2>&1 && validate_json "$STATE_FILE" || true
             fi
         fi
     done
@@ -931,7 +936,7 @@ daemon_init() {
 
     cat > "$config_file" << 'CONFIGEOF'
 {
-  "watch_label": "ready-to-build",
+  "watch_label": "shipwright",
   "poll_interval": 60,
   "max_parallel": 2,
   "pipeline_template": "autonomous",
@@ -939,7 +944,7 @@ daemon_init() {
   "model": "opus",
   "base_branch": "main",
   "on_success": {
-    "remove_label": "ready-to-build",
+    "remove_label": "shipwright",
     "add_label": "pipeline/complete",
     "close_issue": false
   },
@@ -993,9 +998,9 @@ daemon_init() {
   "worker_mem_gb": 4,
   "estimated_cost_per_job_usd": 5.0,
   "intelligence": {
-    "enabled": true,
+    "enabled": "auto",
     "cache_ttl_seconds": 3600,
-    "composer_enabled": true,
+    "composer_enabled": "auto",
     "optimization_enabled": true,
     "prediction_enabled": true,
     "adversarial_enabled": false,
@@ -1052,7 +1057,7 @@ daemon_metrics() {
         exit 1
     fi
 
-    if ! command -v jq &>/dev/null; then
+    if ! command -v jq >/dev/null 2>&1; then
         error "jq is required for metrics. Install: brew install jq"
         exit 1
     fi

package/scripts/sw-dashboard.sh

@@ -6,7 +6,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="2.4.0"
+VERSION="3.1.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -16,6 +16,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # Canonical helpers (colors, output, events)
 # shellcheck source=lib/helpers.sh
 [[ -f "$SCRIPT_DIR/lib/helpers.sh" ]] && source "$SCRIPT_DIR/lib/helpers.sh"
+[[ -f "$SCRIPT_DIR/lib/config.sh" ]] && source "$SCRIPT_DIR/lib/config.sh"
 # 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 $*"; }
@@ -33,15 +34,6 @@ if [[ "$(type -t emit_event 2>/dev/null)" != "function" ]]; then
     echo "${payload}}" >> "${HOME}/.shipwright/events.jsonl"
   }
 fi
-CYAN="${CYAN:-\033[38;2;0;212;255m}"
-PURPLE="${PURPLE:-\033[38;2;124;58;237m}"
-BLUE="${BLUE:-\033[38;2;0;102;255m}"
-GREEN="${GREEN:-\033[38;2;74;222;128m}"
-YELLOW="${YELLOW:-\033[38;2;250;204;21m}"
-RED="${RED:-\033[38;2;248;113;113m}"
-DIM="${DIM:-\033[2m}"
-BOLD="${BOLD:-\033[1m}"
-RESET="${RESET:-\033[0m}"
 UNDERLINE='\033[4m'
 
 # ─── Paths ──────────────────────────────────────────────────────────────────
@@ -50,7 +42,7 @@ PID_FILE="${TEAMS_DIR}/dashboard.pid"
 LOG_DIR="${TEAMS_DIR}/logs"
 LOG_FILE="${LOG_DIR}/dashboard.log"
 EVENTS_FILE="${TEAMS_DIR}/events.jsonl"
-DEFAULT_PORT=8767
+DEFAULT_PORT=$(_config_get_int "dashboard.port" 8767 2>/dev/null || echo 8767)
 
 # ─── Header ────────────────────────────────────────────────────────────────
 dashboard_header() {
@@ -78,6 +70,7 @@ show_help() {
     echo -e "${BOLD}OPTIONS${RESET}"
     echo -e "  ${CYAN}--port${RESET} <N>         Port to run on ${DIM}(default: ${DEFAULT_PORT})${RESET}"
     echo -e "  ${CYAN}--foreground${RESET}       Run in foreground ${DIM}(don't daemonize)${RESET}"
+    echo -e "  ${CYAN}--no-build${RESET}         Skip build check; start immediately"
     echo ""
     echo -e "${BOLD}EXAMPLES${RESET}"
     echo -e "  ${DIM}shipwright dashboard${RESET}                # Start in foreground"
@@ -91,13 +84,47 @@ show_help() {
 
 # ─── Prerequisite Check ────────────────────────────────────────────────────
 check_bun() {
-    if ! command -v bun &>/dev/null; then
+    if ! command -v bun >/dev/null 2>&1; then
         error "Bun is required but not installed"
         info "Install Bun: ${UNDERLINE}https://bun.sh${RESET}"
         exit 1
     fi
 }
 
+# ─── Build Check (before serve) ─────────────────────────────────────────────
+ensure_dashboard_built() {
+    local server_ts="$1"
+    local repo_root
+    repo_root=$(dirname "$(dirname "$server_ts")")
+    local dist_dir="$repo_root/dashboard/public/dist"
+    local src_dir="$repo_root/dashboard/src"
+
+    # Check if dist exists and has main.js
+    if [[ ! -d "$dist_dir" ]] || [[ ! -f "$dist_dir/main.js" ]]; then
+        echo "Dashboard not built. Building..."
+        if command -v bun &>/dev/null; then
+            (cd "$repo_root" && bun run dashboard:build)
+        elif command -v npx &>/dev/null; then
+            (cd "$repo_root" && npx esbuild dashboard/src/main.ts --bundle --outdir=dashboard/public/dist --target=esnext)
+        else
+            warn "Cannot build dashboard: neither bun nor npx available"
+            return 1
+        fi
+    else
+        # Check if source is newer than build
+        local src_mtime
+        src_mtime=$(find "$src_dir" -name "*.ts" -newer "$dist_dir/main.js" 2>/dev/null | head -1)
+        if [[ -n "$src_mtime" ]]; then
+            echo "Dashboard source changed. Rebuilding..."
+            if command -v bun &>/dev/null; then
+                (cd "$repo_root" && bun run dashboard:build)
+            elif command -v npx &>/dev/null; then
+                (cd "$repo_root" && npx esbuild dashboard/src/main.ts --bundle --outdir=dashboard/public/dist --target=esnext)
+            fi
+        fi
+    fi
+}
+
 # ─── Find Server ───────────────────────────────────────────────────────────
 find_server() {
     # Look for dashboard/server.ts relative to the script's repo location
@@ -161,6 +188,10 @@ dashboard_start_bg() {
     local server_ts
     server_ts=$(find_server)
 
+    if [[ "$NO_BUILD" != "true" ]]; then
+        ensure_dashboard_built "$server_ts" || exit 1
+    fi
+
     # Ensure directories exist
     mkdir -p "$LOG_DIR" "$TEAMS_DIR"
 
@@ -217,6 +248,10 @@ dashboard_start_fg() {
     local server_ts
     server_ts=$(find_server)
 
+    if [[ "$NO_BUILD" != "true" ]]; then
+        ensure_dashboard_built "$server_ts" || exit 1
+    fi
+
     mkdir -p "$TEAMS_DIR"
 
     info "Starting dashboard server on port ${CYAN}${port}${RESET} ${DIM}(foreground)${RESET}"
@@ -294,7 +329,7 @@ dashboard_status() {
 
         # Try to get port from /proc or lsof
         local port=""
-        if command -v lsof &>/dev/null; then
+        if command -v lsof >/dev/null 2>&1; then
             port=$(lsof -nP -iTCP -sTCP:LISTEN -a -p "$pid" 2>/dev/null | grep -oE ':\d+' | head -1 | tr -d ':' || true)
         fi
 
@@ -309,7 +344,7 @@ dashboard_status() {
         if [[ -f "$PID_FILE" ]]; then
             local pid_mtime
             if [[ "$(uname)" == "Darwin" ]]; then
-                pid_mtime=$(stat -f %m "$PID_FILE" 2>/dev/null || echo "0")
+                pid_mtime=$(file_mtime "$PID_FILE")
             else
                 pid_mtime=$(stat -c %Y "$PID_FILE" 2>/dev/null || echo "0")
             fi
@@ -331,7 +366,7 @@ dashboard_status() {
         if [[ -n "$port" ]]; then
             local health
             health=$(curl -s --max-time 2 "http://localhost:${port}/api/health" 2>/dev/null || true)
-            if [[ -n "$health" ]] && command -v jq &>/dev/null; then
+            if [[ -n "$health" ]] && command -v jq >/dev/null 2>&1; then
                 local connections
                 connections=$(echo "$health" | jq -r '.connections // empty' 2>/dev/null || true)
                 if [[ -n "$connections" ]]; then
@@ -361,7 +396,7 @@ dashboard_open() {
     if is_running; then
         local pid
         pid=$(get_pid)
-        if command -v lsof &>/dev/null; then
+        if command -v lsof >/dev/null 2>&1; then
             local detected_port
             detected_port=$(lsof -nP -iTCP -sTCP:LISTEN -a -p "$pid" 2>/dev/null | grep -oE ':\d+' | head -1 | tr -d ':' || true)
             if [[ -n "$detected_port" ]]; then
@@ -379,7 +414,7 @@ dashboard_open() {
 
     if open_url "$url" 2>/dev/null; then
         : # opened via compat.sh
-    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
         error "No browser opener found"
@@ -392,6 +427,7 @@ dashboard_open() {
 SUBCOMMAND=""
 PORT="$DEFAULT_PORT"
 FOREGROUND=false
+NO_BUILD=false
 
 while [[ $# -gt 0 ]]; do
     case "$1" in
@@ -427,6 +463,10 @@ while [[ $# -gt 0 ]]; do
             FOREGROUND=true
             shift
             ;;
+        --no-build)
+            NO_BUILD=true
+            shift
+            ;;
         --version|-v)
             echo "shipwright dashboard v${VERSION}"
             exit 0