shipwright-cli 2.3.1 → 3.0.0

package/scripts/sw-replay.sh

@@ -6,7 +6,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="2.3.1"
+VERSION="3.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 EVENTS_FILE="${HOME}/.shipwright/events.jsonl"
 
@@ -17,6 +17,9 @@ EVENTS_FILE="${HOME}/.shipwright/events.jsonl"
 # Canonical helpers (colors, output, events)
 # shellcheck source=lib/helpers.sh
 [[ -f "$SCRIPT_DIR/lib/helpers.sh" ]] && source "$SCRIPT_DIR/lib/helpers.sh"
+# DB layer for dual-read (SQLite + JSONL fallback)
+# shellcheck source=sw-db.sh
+[[ -f "$SCRIPT_DIR/sw-db.sh" ]] && source "$SCRIPT_DIR/sw-db.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 $*"; }
@@ -34,19 +37,9 @@ 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}"
-
 # Check if jq is available
 check_jq() {
-    if ! command -v jq &>/dev/null; then
+    if ! command -v jq >/dev/null 2>&1; then
         error "jq is required. Install with: brew install jq"
         exit 1
     fi
@@ -85,22 +78,23 @@ color_status() {
 cmd_list() {
     check_jq
 
-    if [[ ! -f "$EVENTS_FILE" ]]; then
-        warn "No pipeline runs recorded yet (events file not found)"
+    local events_json
+    events_json=$(db_query_events "" 5000 2>/dev/null || echo "[]")
+    if [[ "$events_json" == "[]" ]] || [[ -z "$events_json" ]]; then
+        warn "No pipeline runs recorded yet (events not found)"
         exit 0
     fi
 
-    info "Pipeline runs (${DIM}from $EVENTS_FILE${RESET})"
+    info "Pipeline runs (${DIM}DB + JSONL${RESET})"
     echo ""
 
     # Extract unique pipeline runs, sorted by start time
-    # Use --slurpfile to handle parsing errors gracefully
-    jq -r 'select(.type == "pipeline.started") | [.ts, .issue, .pipeline, .model, .goal] | @tsv' "$EVENTS_FILE" 2>/dev/null | \
+    echo "$events_json" | jq -r '.[] | select(.type == "pipeline.started") | [.ts, .issue, .pipeline, .model, .goal] | @tsv' 2>/dev/null | \
     sort -r | \
     while IFS=$'\t' read -r ts issue pipeline model goal; do
         # Find corresponding completion event
         local completion
-        completion=$(jq -r "select(.type == \"pipeline.completed\" and .issue == $issue) | .result, .duration_s" "$EVENTS_FILE" 2>/dev/null | head -2)
+        completion=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.completed\" and .issue == $issue) | .result, .duration_s" 2>/dev/null | head -2)
 
         if [[ -n "$completion" ]]; then
             local result duration
@@ -137,14 +131,16 @@ cmd_show() {
         exit 1
     fi
 
-    if [[ ! -f "$EVENTS_FILE" ]]; then
+    local events_json
+    events_json=$(db_query_events "" 5000 2>/dev/null || echo "[]")
+    if [[ "$events_json" == "[]" ]] || [[ -z "$events_json" ]]; then
         error "No events recorded yet"
         exit 1
     fi
 
     # Find pipeline run for this issue
     local pipeline_start
-    pipeline_start=$(jq -r "select(.type == \"pipeline.started\" and .issue == $issue) | [.ts, .pipeline, .model, .goal] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    pipeline_start=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.started\" and .issue == $issue) | [.ts, .pipeline, .model, .goal] | @tsv" 2>/dev/null | head -1)
 
     if [[ -z "$pipeline_start" ]]; then
         error "No pipeline run found for issue #$issue"
@@ -166,7 +162,7 @@ cmd_show() {
 
     # Find all stage events for this issue
     echo -e "  ${BOLD}Stages:${RESET}"
-    jq -r "select(.issue == $issue and .type == \"stage.completed\") | [.ts, .stage, .duration_s // 0, .result // \"success\"] | @tsv" "$EVENTS_FILE" 2>/dev/null | \
+    echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"stage.completed\") | [.ts, .stage, .duration_s // 0, .result // \"success\"] | @tsv" 2>/dev/null | \
     while IFS=$'\t' read -r ts stage duration result; do
         local status_icon
         case "$result" in
@@ -185,7 +181,7 @@ cmd_show() {
 
     # Find pipeline completion
     local completion
-    completion=$(jq -r "select(.type == \"pipeline.completed\" and .issue == $issue) | [.result // \"unknown\", .duration_s // 0, .input_tokens // 0, .output_tokens // 0] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    completion=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.completed\" and .issue == $issue) | [.result // \"unknown\", .duration_s // 0, .input_tokens // 0, .output_tokens // 0] | @tsv" 2>/dev/null | head -1)
 
     if [[ -n "$completion" ]]; then
         echo ""
@@ -214,13 +210,15 @@ cmd_narrative() {
         exit 1
     fi
 
-    if [[ ! -f "$EVENTS_FILE" ]]; then
+    local events_json
+    events_json=$(db_query_events "" 5000 2>/dev/null || echo "[]")
+    if [[ "$events_json" == "[]" ]] || [[ -z "$events_json" ]]; then
         error "No events recorded yet"
         exit 1
     fi
 
     local pipeline_start
-    pipeline_start=$(jq -r "select(.type == \"pipeline.started\" and .issue == $issue) | [.ts, .goal // \"\", .pipeline // \"standard\"] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    pipeline_start=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.started\" and .issue == $issue) | [.ts, .goal // \"\", .pipeline // \"standard\"] | @tsv" 2>/dev/null | head -1)
 
     if [[ -z "$pipeline_start" ]]; then
         error "No pipeline run found for issue #$issue"
@@ -234,7 +232,7 @@ cmd_narrative() {
 
     # Get pipeline completion
     local completion
-    completion=$(jq -r "select(.type == \"pipeline.completed\" and .issue == $issue) | [.result // \"unknown\", .duration_s // 0, .input_tokens // 0, .output_tokens // 0] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    completion=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.completed\" and .issue == $issue) | [.result // \"unknown\", .duration_s // 0, .input_tokens // 0, .output_tokens // 0] | @tsv" 2>/dev/null | head -1)
 
     local result duration input_tokens output_tokens
     if [[ -n "$completion" ]]; then
@@ -251,7 +249,7 @@ cmd_narrative() {
 
     # Count stages
     local stage_count
-    stage_count=$(jq -r "select(.issue == $issue and .type == \"stage.completed\") | .stage" "$EVENTS_FILE" 2>/dev/null | wc -l)
+    stage_count=$(echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"stage.completed\") | .stage" 2>/dev/null | wc -l)
 
     # Build narrative
     info "Pipeline Narrative"
@@ -267,9 +265,9 @@ cmd_narrative() {
 
     # Key events
     local retry_count build_iterations test_failures
-    retry_count=$(jq -r "select(.issue == $issue and .type == \"stage.completed\" and .result == \"retry\") | .stage" "$EVENTS_FILE" 2>/dev/null | wc -l)
-    build_iterations=$(jq -r "select(.issue == $issue and .type == \"build.iteration\") | .iteration" "$EVENTS_FILE" 2>/dev/null | tail -1)
-    test_failures=$(jq -r "select(.issue == $issue and .type == \"test.failed\") | .test" "$EVENTS_FILE" 2>/dev/null | wc -l)
+    retry_count=$(echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"stage.completed\" and .result == \"retry\") | .stage" 2>/dev/null | wc -l)
+    build_iterations=$(echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"build.iteration\") | .iteration" 2>/dev/null | tail -1)
+    test_failures=$(echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"test.failed\") | .test" 2>/dev/null | wc -l)
 
     echo "Key Events:"
     [[ $retry_count -gt 0 ]] && echo "  • $retry_count stage retries"
@@ -290,19 +288,21 @@ cmd_diff() {
         exit 1
     fi
 
-    if ! command -v git &>/dev/null; then
+    if ! command -v git >/dev/null 2>&1; then
         error "git is required for diff subcommand"
         exit 1
     fi
 
-    if [[ ! -f "$EVENTS_FILE" ]]; then
+    local events_json
+    events_json=$(db_query_events "" 5000 2>/dev/null || echo "[]")
+    if [[ "$events_json" == "[]" ]] || [[ -z "$events_json" ]]; then
         error "No events recorded yet"
         exit 1
     fi
 
     # Check if issue was processed
     local found
-    found=$(jq -r "select(.issue == $issue and .type == \"pipeline.completed\") | .issue" "$EVENTS_FILE" | head -1)
+    found=$(echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"pipeline.completed\") | .issue" 2>/dev/null | head -1)
 
     if [[ -z "$found" ]]; then
         error "No pipeline run found for issue #$issue"
@@ -317,7 +317,7 @@ cmd_diff() {
 
     # Also try to find by branch name pattern
     local branch_pattern="issue-${issue}"
-    if git show-ref --verify "refs/heads/$branch_pattern" &>/dev/null; then
+    if git show-ref --verify "refs/heads/$branch_pattern" >/dev/null 2>&1; then
         echo ""
         info "Commits on branch '$branch_pattern':"
         git log "$branch_pattern" --oneline || true
@@ -337,13 +337,15 @@ cmd_export() {
         exit 1
     fi
 
-    if [[ ! -f "$EVENTS_FILE" ]]; then
+    local events_json
+    events_json=$(db_query_events "" 5000 2>/dev/null || echo "[]")
+    if [[ "$events_json" == "[]" ]] || [[ -z "$events_json" ]]; then
         error "No events recorded yet"
         exit 1
     fi
 
     local pipeline_start
-    pipeline_start=$(jq -r "select(.type == \"pipeline.started\" and .issue == $issue) | [.ts, .goal // \"\", .pipeline // \"standard\"] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    pipeline_start=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.started\" and .issue == $issue) | [.ts, .goal // \"\", .pipeline // \"standard\"] | @tsv" 2>/dev/null | head -1)
 
     if [[ -z "$pipeline_start" ]]; then
         error "No pipeline run found for issue #$issue"
@@ -356,7 +358,7 @@ cmd_export() {
     pipeline_type=$(echo "$pipeline_start" | cut -f3)
 
     local completion
-    completion=$(jq -r "select(.type == \"pipeline.completed\" and .issue == $issue) | [.result // \"unknown\", .duration_s // 0] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    completion=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.completed\" and .issue == $issue) | [.result // \"unknown\", .duration_s // 0] | @tsv" 2>/dev/null | head -1)
 
     local result duration
     if [[ -n "$completion" ]]; then
@@ -386,7 +388,7 @@ $goal
 EOF
 
     # Add stage rows
-    jq -r "select(.issue == $issue and .type == \"stage.completed\") | [.stage, .duration_s // 0, .result // \"success\"] | @tsv" "$EVENTS_FILE" 2>/dev/null | \
+    echo "$events_json" | jq -r ".[] | select(.issue == $issue and .type == \"stage.completed\") | [.stage, .duration_s // 0, .result // \"success\"] | @tsv" 2>/dev/null | \
     while IFS=$'\t' read -r stage duration result; do
         printf "| %s | %s | %s |\n" "$stage" "$(format_duration "$duration")" "$result"
     done
@@ -402,7 +404,7 @@ EOF
 
 ## Events
 
-$(jq -r "select(.issue == $issue) | [.ts, .type] | @tsv" "$EVENTS_FILE" 2>/dev/null | awk '{print "- " $1 " — " $2}')
+$(echo "$events_json" | jq -r ".[] | select(.issue == $issue) | [.ts, .type] | @tsv" 2>/dev/null | awk '{print "- " $1 " — " $2}')
 
 EOF
 
@@ -420,7 +422,9 @@ cmd_compare() {
         exit 1
     fi
 
-    if [[ ! -f "$EVENTS_FILE" ]]; then
+    local events_json
+    events_json=$(db_query_events "" 5000 2>/dev/null || echo "[]")
+    if [[ "$events_json" == "[]" ]] || [[ -z "$events_json" ]]; then
         error "No events recorded yet"
         exit 1
     fi
@@ -430,8 +434,8 @@ cmd_compare() {
 
     # Get both runs
     local run1 run2
-    run1=$(jq -r "select(.type == \"pipeline.started\" and .issue == $issue1) | [.goal // \"\", .pipeline, .model] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
-    run2=$(jq -r "select(.type == \"pipeline.started\" and .issue == $issue2) | [.goal // \"\", .pipeline, .model] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    run1=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.started\" and .issue == $issue1) | [.goal // \"\", .pipeline, .model] | @tsv" 2>/dev/null | head -1)
+    run2=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.started\" and .issue == $issue2) | [.goal // \"\", .pipeline, .model] | @tsv" 2>/dev/null | head -1)
 
     if [[ -z "$run1" || -z "$run2" ]]; then
         error "Could not find both pipeline runs"
@@ -451,8 +455,8 @@ cmd_compare() {
 
     # Get completions
     local comp1 comp2
-    comp1=$(jq -r "select(.type == \"pipeline.completed\" and .issue == $issue1) | [.result // \"unknown\", .duration_s // 0] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
-    comp2=$(jq -r "select(.type == \"pipeline.completed\" and .issue == $issue2) | [.result // \"unknown\", .duration_s // 0] | @tsv" "$EVENTS_FILE" 2>/dev/null | head -1)
+    comp1=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.completed\" and .issue == $issue1) | [.result // \"unknown\", .duration_s // 0] | @tsv" 2>/dev/null | head -1)
+    comp2=$(echo "$events_json" | jq -r ".[] | select(.type == \"pipeline.completed\" and .issue == $issue2) | [.result // \"unknown\", .duration_s // 0] | @tsv" 2>/dev/null | head -1)
 
     local result1 duration1 result2 duration2
     result1=$(echo "$comp1" | cut -f1)
@@ -497,7 +501,7 @@ ${BOLD}EXAMPLES${RESET}
   shipwright replay export 42                        # Markdown report for #42
   shipwright replay compare 42 43                    # Compare two runs
 
-${DIM}Pipeline events are read from: $EVENTS_FILE${RESET}
+${DIM}Pipeline events are read from: DB + JSONL fallback${RESET}
 
 EOF
 }

package/scripts/sw-retro.sh

@@ -6,7 +6,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="2.3.1"
+VERSION="3.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 # ─── Cross-platform compatibility ──────────────────────────────────────────
@@ -16,6 +16,9 @@ _COMPAT="$SCRIPT_DIR/lib/compat.sh"
 # Canonical helpers (colors, output, events)
 # shellcheck source=lib/helpers.sh
 [[ -f "$SCRIPT_DIR/lib/helpers.sh" ]] && source "$SCRIPT_DIR/lib/helpers.sh"
+# DB layer for dual-read (SQLite + JSONL fallback)
+# shellcheck source=sw-db.sh
+[[ -f "$SCRIPT_DIR/sw-db.sh" ]] && source "$SCRIPT_DIR/sw-db.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 $*"; }
@@ -25,24 +28,7 @@ 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}"
-
+# epoch_to_iso from compat.sh (cross-platform: BSD date -r first, then GNU -d)
 epoch_to_iso() {
     local epoch="$1"
     date -u -r "$epoch" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || \
@@ -74,11 +60,9 @@ get_sprint_dates() {
     local to_date="${2:-}"
 
     if [[ -z "$from_date" ]]; then
-        # Default: last 7 days
+        # Default: last 7 days (cross-platform: date_days_ago from compat.sh)
         to_date=$(date -u +"%Y-%m-%d")
-        from_date=$(date -u -v-7d +"%Y-%m-%d" 2>/dev/null || \
-                   date -u -d "7 days ago" +"%Y-%m-%d" 2>/dev/null || \
-                   python3 -c "from datetime import datetime, timedelta; print((datetime.utcnow() - timedelta(days=7)).strftime('%Y-%m-%d'))")
+        from_date=$(date_days_ago 7 2>/dev/null || python3 -c "from datetime import datetime, timedelta; print((datetime.utcnow() - timedelta(days=7)).strftime('%Y-%m-%d'))")
     elif [[ -z "$to_date" ]]; then
         to_date=$(date -u +"%Y-%m-%d")
     fi
@@ -91,26 +75,19 @@ analyze_sprint_data() {
     local from_date="$1"
     local to_date="$2"
 
-    local events_file="${HOME}/.shipwright/events.jsonl"
-    if [[ ! -f "$events_file" ]]; then
-        echo '{"pipelines":0,"succeeded":0,"failed":0,"retries":0,"avg_duration":0,"avg_stages":0,"slowest_stage":"","quality_score":0}'
-        return 0
-    fi
-
-    if ! command -v jq &>/dev/null; then
+    if ! command -v jq >/dev/null 2>&1; then
         error "jq is required for sprint analysis"
         return 1
     fi
 
-    # Convert dates to epoch
+    # Convert dates to epoch (cross-platform: date_to_epoch from compat.sh)
     local from_epoch to_epoch
-    from_epoch=$(date -u -d "${from_date}T00:00:00Z" +%s 2>/dev/null || \
-                date -u -r "$(date -d "${from_date}T00:00:00Z" +%s 2>/dev/null || echo 0)" +%s || echo 0)
-    to_epoch=$(date -u -d "${to_date}T23:59:59Z" +%s 2>/dev/null || \
-              date -u -r "$(date -d "${to_date}T23:59:59Z" +%s 2>/dev/null || echo 0)" +%s || echo 0)
+    from_epoch=$(date_to_epoch "${from_date}T00:00:00Z")
+    to_epoch=$(date_to_epoch "${to_date}T23:59:59Z")
 
-    jq -s --argjson from "$from_epoch" --argjson to "$to_epoch" '
-        [.[] | select(.ts_epoch >= $from and .ts_epoch <= $to)] as $events |
+    # Use db_query_events_since (SQLite + JSONL fallback)
+    db_query_events_since "$from_epoch" "" "$to_epoch" | jq --argjson from "$from_epoch" --argjson to "$to_epoch" '
+        (if type == "array" then . else [] end) as $events |
         [$events[] | select(.type == "pipeline.completed")] as $completed |
         ($completed | length) as $total_pipelines |
         [$completed[] | select(.result == "success")] as $successes |
@@ -132,7 +109,7 @@ analyze_sprint_data() {
             slowest_stage: $slowest,
             quality_score: $quality
         }
-    ' "$events_file" 2>/dev/null || echo '{"pipelines":0,"succeeded":0,"failed":0,"retries":0,"avg_duration":0,"avg_stages":0,"slowest_stage":"","quality_score":0}'
+    ' 2>/dev/null || echo '{"pipelines":0,"succeeded":0,"failed":0,"retries":0,"avg_duration":0,"avg_stages":0,"slowest_stage":"","quality_score":0}'
 }
 
 # ─── Agent Performance Analysis ─────────────────────────────────────────────
@@ -140,23 +117,17 @@ analyze_agent_performance() {
     local from_date="$1"
     local to_date="$2"
 
-    local events_file="${HOME}/.shipwright/events.jsonl"
-    if [[ ! -f "$events_file" ]]; then
-        echo '{"agents":[]}'
-        return 0
-    fi
-
-    if ! command -v jq &>/dev/null; then
+    if ! command -v jq >/dev/null 2>&1; then
         echo '{"agents":[]}'
         return 0
     fi
 
     local from_epoch to_epoch
-    from_epoch=$(date -u -d "${from_date}T00:00:00Z" +%s 2>/dev/null || echo 0)
-    to_epoch=$(date -u -d "${to_date}T23:59:59Z" +%s 2>/dev/null || echo 0)
+    from_epoch=$(date_to_epoch "${from_date}T00:00:00Z")
+    to_epoch=$(date_to_epoch "${to_date}T23:59:59Z")
 
-    jq -s --argjson from "$from_epoch" --argjson to "$to_epoch" '
-        [.[] | select(.ts_epoch >= $from and .ts_epoch <= $to)] as $events |
+    db_query_events_since "$from_epoch" "" "$to_epoch" | jq --argjson from "$from_epoch" --argjson to "$to_epoch" '
+        (if type == "array" then . else [] end) as $events |
         [$events[] | select(.type == "pipeline.completed" and (.agent_id // .agent))] as $completions |
         $completions | group_by(.agent_id // .agent) | map({
             agent: .[0].agent_id // .[0].agent,
@@ -166,7 +137,7 @@ analyze_agent_performance() {
             avg_duration: (([.[].duration_s // 0] | add / length) | floor)
         }) | sort_by(-.completed) as $agent_stats |
         { agents: $agent_stats }
-    ' "$events_file" 2>/dev/null || echo '{"agents":[]}'
+    ' 2>/dev/null || echo '{"agents":[]}'
 }
 
 # ─── Velocity & Trends ──────────────────────────────────────────────────────
@@ -174,21 +145,15 @@ analyze_velocity() {
     local from_date="$1"
     local to_date="$2"
 
-    local events_file="${HOME}/.shipwright/events.jsonl"
-    if [[ ! -f "$events_file" ]]; then
+    if ! command -v jq >/dev/null 2>&1; then
         echo '{"current":0,"previous":0,"trend":"→"}'
         return 0
     fi
 
-    if ! command -v jq &>/dev/null; then
-        echo '{"current":0,"previous":0,"trend":"→"}'
-        return 0
-    fi
-
-    # Get current period
+    # Get current period (cross-platform: date_to_epoch from compat.sh)
     local from_epoch to_epoch prev_from_epoch prev_to_epoch
-    from_epoch=$(date -u -d "${from_date}T00:00:00Z" +%s 2>/dev/null || echo 0)
-    to_epoch=$(date -u -d "${to_date}T23:59:59Z" +%s 2>/dev/null || echo 0)
+    from_epoch=$(date_to_epoch "${from_date}T00:00:00Z")
+    to_epoch=$(date_to_epoch "${to_date}T23:59:59Z")
 
     # Get previous period (same duration before current)
     local duration_days
@@ -196,24 +161,26 @@ analyze_velocity() {
     prev_to_epoch=$from_epoch
     prev_from_epoch=$((from_epoch - (duration_days * 86400)))
 
-    jq -s --argjson curr_from "$from_epoch" --argjson curr_to "$to_epoch" \
+    # Need full event range for current + previous; use db_query_events since prev_from may be before from
+    db_query_events "" 10000 | jq --argjson curr_from "$from_epoch" --argjson curr_to "$to_epoch" \
            --argjson prev_from "$prev_from_epoch" --argjson prev_to "$prev_to_epoch" '
-        [.[] | select(.ts_epoch >= $curr_from and .ts_epoch <= $curr_to and .type == "pipeline.completed" and .result == "success")] | length as $current |
-        [.[] | select(.ts_epoch >= $prev_from and .ts_epoch <= $prev_to and .type == "pipeline.completed" and .result == "success")] | length as $previous |
+        (if type == "array" then . else [] end) as $all |
+        [$all[] | select(.ts_epoch >= $curr_from and .ts_epoch <= $curr_to and .type == "pipeline.completed" and .result == "success")] | length as $current |
+        [$all[] | select(.ts_epoch >= $prev_from and .ts_epoch <= $prev_to and .type == "pipeline.completed" and .result == "success")] | length as $previous |
         (if $previous > 0 and $current > $previous then "↑" elif $current < $previous then "↓" else "→" end) as $trend |
         {
             current: $current,
             previous: $previous,
             trend: $trend
         }
-    ' "$events_file" 2>/dev/null || echo '{"current":0,"previous":0,"trend":"→"}'
+    ' 2>/dev/null || echo '{"current":0,"previous":0,"trend":"→"}'
 }
 
 # ─── Generate Insights & Actions ────────────────────────────────────────────
 generate_improvement_actions() {
     local analysis_json="$1"
 
-    if ! command -v jq &>/dev/null; then
+    if ! command -v jq >/dev/null 2>&1; then
         echo '{"actions":[]}'
         return 0
     fi
@@ -253,18 +220,18 @@ generate_improvement_actions() {
 create_action_issues() {
     local actions_json="$1"
 
-    if ! command -v gh &>/dev/null; then
+    if ! command -v gh >/dev/null 2>&1; then
         warn "GitHub CLI (gh) not found. Skipping issue creation."
         return 1
     fi
 
-    if ! command -v jq &>/dev/null; then
+    if ! command -v jq >/dev/null 2>&1; then
         warn "jq not found. Skipping issue creation."
         return 1
     fi
 
     local action_count
-    action_count=$(echo "$actions_json" | jq '.actions | length')
+    action_count=$(echo "$actions_json" | jq '.actions | length' 2>/dev/null || echo "0")
 
     for ((i = 0; i < action_count; i++)); do
         local title description label priority
@@ -367,7 +334,7 @@ generate_retro_report() {
     } > "$report_file"
 
     # Add agent stats
-    if command -v jq &>/dev/null; then
+    if command -v jq >/dev/null 2>&1; then
         local agent_count
         agent_count=$(echo "$agent_json" | jq '.agents | length' 2>/dev/null || echo 0)
         for ((i = 0; i < agent_count; i++)); do
@@ -446,12 +413,12 @@ cmd_run() {
 
     # Display summary
     echo -e "${BOLD}Sprint Summary${RESET}"
-    if command -v jq &>/dev/null; then
+    if command -v jq >/dev/null 2>&1; then
         local pipelines succeeded failed quality_score
-        pipelines=$(echo "$analysis" | jq -r '.pipelines')
-        succeeded=$(echo "$analysis" | jq -r '.succeeded')
-        failed=$(echo "$analysis" | jq -r '.failed')
-        quality_score=$(echo "$analysis" | jq -r '.quality_score')
+        pipelines=$(echo "$analysis" | jq -r '.pipelines // 0')
+        succeeded=$(echo "$analysis" | jq -r '.succeeded // 0')
+        failed=$(echo "$analysis" | jq -r '.failed // 0')
+        quality_score=$(echo "$analysis" | jq -r '.quality_score // 0')
 
         echo "Pipelines: $pipelines total | ${GREEN}$succeeded succeeded${RESET} | ${RED}$failed failed${RESET}"
         echo "Success Rate: ${quality_score}%"
@@ -469,7 +436,7 @@ cmd_run() {
     [[ -f "$SCRIPT_DIR/sw-self-optimize.sh" ]] && "$SCRIPT_DIR/sw-self-optimize.sh" ingest-retro || true
 
     # Offer to create issues
-    if command -v gh &>/dev/null; then
+    if command -v gh >/dev/null 2>&1; then
         echo ""
         info "Create improvement issues? (y/n)"
         read -r -t 5 response || response="n"
@@ -492,7 +459,7 @@ cmd_summary() {
     local analysis
     analysis=$(analyze_sprint_data "$from_date" "$to_date")
 
-    if command -v jq &>/dev/null; then
+    if command -v jq >/dev/null 2>&1; then
         echo "$analysis" | jq '.'
     else
         echo "$analysis"
@@ -503,8 +470,9 @@ cmd_trends() {
     info "Multi-Sprint Trend Analysis"
     echo ""
 
-    local events_file="${HOME}/.shipwright/events.jsonl"
-    if [[ ! -f "$events_file" ]]; then
+    local event_check
+    event_check=$(db_query_events "" 1 2>/dev/null || echo "[]")
+    if [[ "$event_check" == "[]" ]] || [[ -z "$event_check" ]]; then
         error "No event data found. Run pipelines first."
         return 1
     fi
@@ -518,15 +486,13 @@ cmd_trends() {
         offset_end=$((i * 7))
         offset_start=$(((i + 1) * 7))
 
-        end_date=$(date -u -v-${offset_end}d +"%Y-%m-%d" 2>/dev/null || \
-                  date -u -d "${offset_end} days ago" +"%Y-%m-%d" 2>/dev/null || echo "$today")
-        start_date=$(date -u -v-${offset_start}d +"%Y-%m-%d" 2>/dev/null || \
-                    date -u -d "${offset_start} days ago" +"%Y-%m-%d" 2>/dev/null || echo "$today")
+        end_date=$(date_days_ago "$offset_end" 2>/dev/null || echo "$today")
+        start_date=$(date_days_ago "$offset_start" 2>/dev/null || echo "$today")
 
         local analysis
         analysis=$(analyze_sprint_data "$start_date" "$end_date")
 
-        if command -v jq &>/dev/null; then
+        if command -v jq >/dev/null 2>&1; then
             local quality pipelines
             quality=$(echo "$analysis" | jq -r '.quality_score')
             pipelines=$(echo "$analysis" | jq -r '.pipelines')
@@ -548,7 +514,7 @@ cmd_agents() {
     local agent_perf
     agent_perf=$(analyze_agent_performance "$from_date" "$to_date")
 
-    if command -v jq &>/dev/null; then
+    if command -v jq >/dev/null 2>&1; then
         echo "$agent_perf" | jq '.agents[] | "\(.agent): \(.completed) completed, \(.succeeded) succeeded, \(.failed) failed"' -r
     else
         echo "$agent_perf"
@@ -569,7 +535,7 @@ cmd_actions() {
     analysis=$(analyze_sprint_data "$from_date" "$to_date")
     improvements=$(generate_improvement_actions "$analysis")
 
-    if command -v jq &>/dev/null; then
+    if command -v jq >/dev/null 2>&1; then
         echo "$improvements" | jq '.actions[] | "\(.priority | ascii_upcase): \(.title)\n  \(.description)"' -r
     else
         echo "$improvements"
@@ -589,10 +555,10 @@ cmd_compare() {
     echo ""
 
     local analysis1 analysis2
-    analysis1=$(analyze_sprint_data "$period1" "$(date -u -d "${period1} + 7 days" +"%Y-%m-%d")")
-    analysis2=$(analyze_sprint_data "$period2" "$(date -u -d "${period2} + 7 days" +"%Y-%m-%d")")
+    analysis1=$(analyze_sprint_data "$period1" "$(date_add_days "$period1" 7)")
+    analysis2=$(analyze_sprint_data "$period2" "$(date_add_days "$period2" 7)")
 
-    if command -v jq &>/dev/null; then
+    if command -v jq >/dev/null 2>&1; then
         echo "Sprint 1 (${period1}):"
         echo "$analysis1" | jq '.'
         echo ""
@@ -623,12 +589,13 @@ Usage: shipwright retro <subcommand> [options]
 Subcommands:
   run [--from DATE] [--to DATE]  Run retrospective for sprint (default: last 7 days)
   summary [DATE1] [DATE2]         Quick sprint summary stats
-  trends                           Multi-sprint trend analysis (last 4 sprints)
+  trends                          Multi-sprint trend analysis (last 4 sprints)
   agents [DATE1] [DATE2]          Agent performance breakdown
   actions [DATE1] [DATE2]         List generated improvement actions
-  compare DATE1 DATE2              Compare two sprint periods
-  history                          Show past retrospective reports
-  help                             Show this help message
+  compare DATE1 DATE2             Compare two sprint periods
+  history                         Show past retrospective reports
+  quality                         Show quality index trend (longitudinal)
+  help                            Show this help message
 
 Options:
   --from DATE                      Start date (YYYY-MM-DD)
@@ -673,6 +640,17 @@ if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
         history)
             cmd_history "$@"
             ;;
+        quality)
+            if [[ -f "$SCRIPT_DIR/sw-self-optimize.sh" ]]; then
+                source "$SCRIPT_DIR/sw-self-optimize.sh" 2>/dev/null || true
+                cmd_quality_index 2>/dev/null || {
+                    echo "No quality data yet. Run some pipelines first."
+                }
+            else
+                error "sw-self-optimize.sh not found"
+                exit 1
+            fi
+            ;;
         help|--help|-h)
             cmd_help
             ;;