specweave 1.0.593 → 2.0.0

package/plugins/specweave/scripts/lsp-warmup.sh

@@ -1,144 +0,0 @@
-#!/usr/bin/env bash
-#
-# LSP Warm-up Script (Background Worker)
-#
-# Spawned by session-start.sh in background to pre-index the workspace
-# This prevents the first LSP query from timing out
-#
-# v1.0.197 - Initial version
-#
-# How it works:
-# 1. Checks if LSP server binary is available
-# 2. Starts the language server in background
-# 3. Sends initialize + workspace/symbol to trigger indexing
-# 4. Writes status to .specweave/state/lsp-warmup.json
-# 5. Keeps server running for subsequent queries (daemon mode)
-#
-# This script is POSIX-compatible (works on bash 3.2+, Linux, macOS, Git Bash)
-
-set +e  # CRITICAL: Never use set -e in background workers
-
-PROJECT_ROOT="$1"
-MODE="${2:-background}"  # "background" (daemon) or "foreground" (one-shot)
-
-# Validate project root
-if [ -z "$PROJECT_ROOT" ] || [ ! -f "$PROJECT_ROOT/.specweave/config.json" ]; then
-  exit 0  # Not a SpecWeave project
-fi
-
-STATE_DIR="${PROJECT_ROOT}/.specweave/state"
-STATE_FILE="${STATE_DIR}/lsp-warmup.json"
-LOG_FILE="${PROJECT_ROOT}/.specweave/logs/lsp-warmup.log"
-PID_FILE="${STATE_DIR}/lsp-warmup.pid"
-
-mkdir -p "$STATE_DIR"
-mkdir -p "$(dirname "$LOG_FILE")"
-
-# Logging function
-log() {
-  echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] $1" >> "$LOG_FILE"
-}
-
-# Write status to JSON
-write_status() {
-  local status="$1"
-  local message="$2"
-  local elapsed="$3"
-  cat > "$STATE_FILE" <<EOF
-{
-  "status": "$status",
-  "message": "$message",
-  "elapsedMs": $elapsed,
-  "timestamp": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
-  "projectRoot": "$PROJECT_ROOT"
-}
-EOF
-}
-
-log "=== LSP Warm-up started (mode: $MODE) ==="
-
-# Check if already running
-if [ -f "$PID_FILE" ]; then
-  OLD_PID=$(cat "$PID_FILE")
-  if kill -0 "$OLD_PID" 2>/dev/null; then
-    log "Warm-up already running (PID: $OLD_PID), skipping"
-    write_status "skipped" "Already running" 0
-    exit 0
-  fi
-fi
-
-# Save our PID
-echo $$ > "$PID_FILE"
-
-START_TIME=$(date +%s%3N 2>/dev/null || date +%s)
-
-# Detect TypeScript project
-detect_typescript() {
-  [ -f "$PROJECT_ROOT/tsconfig.json" ] || [ -f "$PROJECT_ROOT/package.json" ]
-}
-
-# Check if typescript-language-server is available
-has_ts_server() {
-  command -v typescript-language-server >/dev/null 2>&1
-}
-
-# Find entry files (src/index.ts, src/main.ts, etc.)
-find_entry_files() {
-  local files=""
-  for entry in "src/index.ts" "src/main.ts" "src/app.ts" "index.ts" "main.ts"; do
-    if [ -f "$PROJECT_ROOT/$entry" ]; then
-      files="$files $entry"
-    fi
-  done
-  echo "$files"
-}
-
-# Main warm-up logic
-if detect_typescript && has_ts_server; then
-  log "TypeScript project detected, starting warm-up..."
-
-  # Use Node.js to call the warmup API if available
-  # This is more reliable than trying to speak LSP protocol from bash
-  WARMUP_SCRIPT="$PROJECT_ROOT/node_modules/.bin/specweave"
-
-  if [ -x "$WARMUP_SCRIPT" ] || command -v specweave >/dev/null 2>&1; then
-    # Use specweave CLI to trigger warmup
-    log "Using specweave CLI for warm-up..."
-
-    # Call the warmup command (we'll add this to the CLI)
-    cd "$PROJECT_ROOT" || exit 1
-
-    # Run warmup with timeout
-    ENTRY_FILES=$(find_entry_files)
-
-    # For now, just trigger a simple workspace symbol query via the CLI
-    # This will be enhanced when we add the `specweave lsp warmup` command
-    if timeout 60 specweave lsp search "" >/dev/null 2>&1; then
-      END_TIME=$(date +%s%3N 2>/dev/null || date +%s)
-      ELAPSED=$((END_TIME - START_TIME))
-      log "Warm-up completed successfully in ${ELAPSED}ms"
-      write_status "ready" "Workspace indexed" "$ELAPSED"
-    else
-      log "Warm-up via CLI failed or timed out, will index on first query"
-      write_status "deferred" "Will index on first query" 0
-    fi
-  else
-    log "specweave CLI not found, warm-up deferred to first query"
-    write_status "deferred" "CLI not available" 0
-  fi
-else
-  if ! detect_typescript; then
-    log "No TypeScript project detected"
-  elif ! has_ts_server; then
-    log "typescript-language-server not installed"
-  fi
-  write_status "skipped" "No TypeScript project or server not installed" 0
-fi
-
-# Cleanup PID file if running in foreground mode
-if [ "$MODE" = "foreground" ]; then
-  rm -f "$PID_FILE"
-fi
-
-log "=== LSP Warm-up finished ==="
-exit 0

package/plugins/specweave/scripts/read-analytics.sh

@@ -1,286 +0,0 @@
-#!/bin/bash
-# read-analytics.sh - Display SpecWeave usage analytics dashboard
-#
-# Usage:
-#   bash read-analytics.sh [OPTIONS]
-#
-# Options:
-#   --since DATE      Start date (YYYY-MM-DD)
-#   --until DATE      End date (YYYY-MM-DD)
-#   --limit N         Number of items in top lists (default: 10)
-#   --type TYPE       Filter by type (command|skill|agent)
-#   --export FORMAT   Export to json or csv
-#
-# Performance: ~50ms for typical datasets
-
-set +e
-
-# Find project root
-PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
-  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
-done
-
-if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
-  echo "Not a SpecWeave project"
-  exit 0
-fi
-
-ANALYTICS_DIR="$PROJECT_ROOT/.specweave/state/analytics"
-EVENTS_FILE="$ANALYTICS_DIR/events.jsonl"
-
-# Parse arguments
-SINCE=""
-UNTIL=""
-LIMIT=10
-TYPE_FILTER=""
-EXPORT_FORMAT=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --since)
-      SINCE="$2"
-      shift 2
-      ;;
-    --until)
-      UNTIL="$2"
-      shift 2
-      ;;
-    --limit)
-      LIMIT="$2"
-      shift 2
-      ;;
-    --type)
-      TYPE_FILTER="$2"
-      shift 2
-      ;;
-    --export)
-      EXPORT_FORMAT="$2"
-      shift 2
-      ;;
-    *)
-      shift
-      ;;
-  esac
-done
-
-# Default to last 30 days if no since date
-if [[ -z "$SINCE" ]]; then
-  if [[ "$(uname)" == "Darwin" ]]; then
-    SINCE=$(date -v-30d +%Y-%m-%d)
-  else
-    SINCE=$(date -d "30 days ago" +%Y-%m-%d)
-  fi
-fi
-
-# Check if events file exists
-if [[ ! -f "$EVENTS_FILE" ]] || [[ ! -s "$EVENTS_FILE" ]]; then
-  echo ""
-  echo "📊 SpecWeave Usage Analytics"
-  echo "════════════════════════════════════════════════════════════════════"
-  echo ""
-  echo "No analytics data recorded yet."
-  echo ""
-  echo "Analytics will be collected as you use SpecWeave commands."
-  echo ""
-  exit 0
-fi
-
-# Read and filter events
-EVENTS=""
-while IFS= read -r line; do
-  [[ -z "$line" ]] && continue
-
-  # Extract timestamp for filtering
-  if command -v jq >/dev/null 2>&1; then
-    TS=$(echo "$line" | jq -r '.timestamp // ""' 2>/dev/null)
-    EVT_TYPE=$(echo "$line" | jq -r '.type // ""' 2>/dev/null)
-  else
-    TS=$(echo "$line" | grep -oP '"timestamp"\s*:\s*"\K[^"]+' 2>/dev/null || echo "")
-    EVT_TYPE=$(echo "$line" | grep -oP '"type"\s*:\s*"\K[^"]+' 2>/dev/null || echo "")
-  fi
-
-  # Date filter
-  [[ -n "$SINCE" ]] && [[ "$TS" < "${SINCE}T00:00:00" ]] && continue
-  [[ -n "$UNTIL" ]] && [[ "$TS" > "${UNTIL}T23:59:59" ]] && continue
-
-  # Type filter
-  [[ -n "$TYPE_FILTER" ]] && [[ "$EVT_TYPE" != "$TYPE_FILTER" ]] && continue
-
-  EVENTS="${EVENTS}${line}\n"
-done < "$EVENTS_FILE"
-
-# Count totals
-TOTAL_EVENTS=$(echo -e "$EVENTS" | grep -c '"type"' 2>/dev/null || echo "0")
-COMMAND_COUNT=$(echo -e "$EVENTS" | grep -c '"type":"command"' 2>/dev/null || echo "0")
-SKILL_COUNT=$(echo -e "$EVENTS" | grep -c '"type":"skill"' 2>/dev/null || echo "0")
-AGENT_COUNT=$(echo -e "$EVENTS" | grep -c '"type":"agent"' 2>/dev/null || echo "0")
-# Count explicit failures; events without success field default to success
-FAILURE_COUNT=$(echo -e "$EVENTS" | grep -c '"success":false' 2>/dev/null || echo "0")
-SUCCESS_COUNT=$((TOTAL_EVENTS - FAILURE_COUNT))
-
-# Calculate success rate
-if [[ "$TOTAL_EVENTS" -gt 0 ]]; then
-  SUCCESS_RATE=$((SUCCESS_COUNT * 100 / TOTAL_EVENTS))
-else
-  SUCCESS_RATE=100
-fi
-
-# Export if requested
-if [[ "$EXPORT_FORMAT" == "json" ]]; then
-  EXPORT_DIR="$ANALYTICS_DIR/exports"
-  mkdir -p "$EXPORT_DIR" 2>/dev/null
-  EXPORT_FILE="$EXPORT_DIR/analytics-$(date +%Y-%m-%d).json"
-
-  echo '{' > "$EXPORT_FILE"
-  echo "  \"exportedAt\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"," >> "$EXPORT_FILE"
-  echo "  \"since\": \"$SINCE\"," >> "$EXPORT_FILE"
-  echo "  \"until\": \"${UNTIL:-$(date +%Y-%m-%d)}\"," >> "$EXPORT_FILE"
-  echo "  \"totalEvents\": $TOTAL_EVENTS," >> "$EXPORT_FILE"
-  echo "  \"commands\": $COMMAND_COUNT," >> "$EXPORT_FILE"
-  echo "  \"skills\": $SKILL_COUNT," >> "$EXPORT_FILE"
-  echo "  \"agents\": $AGENT_COUNT," >> "$EXPORT_FILE"
-  echo "  \"successRate\": $SUCCESS_RATE" >> "$EXPORT_FILE"
-  echo '}' >> "$EXPORT_FILE"
-
-  echo ""
-  echo "✅ Analytics exported to: $EXPORT_FILE"
-  echo ""
-  exit 0
-fi
-
-if [[ "$EXPORT_FORMAT" == "csv" ]]; then
-  EXPORT_DIR="$ANALYTICS_DIR/exports"
-  mkdir -p "$EXPORT_DIR" 2>/dev/null
-  EXPORT_FILE="$EXPORT_DIR/analytics-$(date +%Y-%m-%d).csv"
-
-  echo "timestamp,type,name,plugin,increment,success,duration" > "$EXPORT_FILE"
-
-  echo -e "$EVENTS" | while IFS= read -r line; do
-    [[ -z "$line" ]] && continue
-    if command -v jq >/dev/null 2>&1; then
-      TS=$(echo "$line" | jq -r '.timestamp // ""')
-      TYPE=$(echo "$line" | jq -r '.type // ""')
-      NAME=$(echo "$line" | jq -r '.name // ""')
-      PLUGIN=$(echo "$line" | jq -r '.plugin // ""')
-      INC=$(echo "$line" | jq -r '.increment // ""')
-      SUCCESS=$(echo "$line" | jq -r '.success // true')
-      DUR=$(echo "$line" | jq -r '.duration // ""')
-      echo "$TS,$TYPE,$NAME,$PLUGIN,$INC,$SUCCESS,$DUR" >> "$EXPORT_FILE"
-    fi
-  done
-
-  echo ""
-  echo "✅ Analytics exported to: $EXPORT_FILE"
-  echo ""
-  exit 0
-fi
-
-# Display dashboard
-LINE68="════════════════════════════════════════════════════════════════════"
-LINE68_THIN="────────────────────────────────────────────────────────────────────"
-
-echo ""
-echo "📊 SpecWeave Usage Analytics"
-echo "$LINE68"
-echo ""
-echo "Period: $SINCE to ${UNTIL:-$(date +%Y-%m-%d)}"
-echo "Total Events: $TOTAL_EVENTS | Success Rate: ${SUCCESS_RATE}%"
-echo ""
-
-# Top Commands
-if [[ "$COMMAND_COUNT" -gt 0 ]]; then
-  echo "TOP COMMANDS                          Count    Success   Avg(ms)"
-  echo "$LINE68_THIN"
-
-  if command -v jq >/dev/null 2>&1; then
-    echo -e "$EVENTS" | grep '"type":"command"' | jq -r '.name' 2>/dev/null | sort | uniq -c | sort -rn | head -$LIMIT | while read -r count name; do
-      # Calculate success rate for this command
-      CMD_TOTAL=$(echo -e "$EVENTS" | grep "\"name\":\"$name\"" | wc -l | tr -d ' ')
-      CMD_SUCCESS=$(echo -e "$EVENTS" | grep "\"name\":\"$name\"" | grep '"success":true' | wc -l | tr -d ' ')
-      CMD_RATE=$((CMD_SUCCESS * 100 / CMD_TOTAL))
-
-      # Pad name with dots
-      PADDED_NAME=$(printf "%-35s" "$name" | tr ' ' '.')
-      printf "%s %8s %7s%%\n" "$PADDED_NAME" "$count" "$CMD_RATE"
-    done
-  else
-    echo -e "$EVENTS" | grep '"type":"command"' | grep -oP '"name"\s*:\s*"\K[^"]+' | sort | uniq -c | sort -rn | head -$LIMIT | while read -r count name; do
-      PADDED_NAME=$(printf "%-35s" "$name" | tr ' ' '.')
-      printf "%s %8s\n" "$PADDED_NAME" "$count"
-    done
-  fi
-  echo ""
-fi
-
-# Top Skills
-if [[ "$SKILL_COUNT" -gt 0 ]]; then
-  echo "TOP SKILLS                            Count    Success   Plugin"
-  echo "$LINE68_THIN"
-
-  if command -v jq >/dev/null 2>&1; then
-    echo -e "$EVENTS" | grep '"type":"skill"' | jq -r '.name' 2>/dev/null | sort | uniq -c | sort -rn | head -$LIMIT | while read -r count name; do
-      PADDED_NAME=$(printf "%-35s" "$name" | tr ' ' '.')
-      PLUGIN=$(echo -e "$EVENTS" | grep "\"name\":\"$name\"" | jq -r '.plugin // "-"' 2>/dev/null | head -1)
-      printf "%s %8s          %s\n" "$PADDED_NAME" "$count" "$PLUGIN"
-    done
-  else
-    echo -e "$EVENTS" | grep '"type":"skill"' | grep -oP '"name"\s*:\s*"\K[^"]+' | sort | uniq -c | sort -rn | head -$LIMIT
-  fi
-  echo ""
-fi
-
-# Top Agents
-if [[ "$AGENT_COUNT" -gt 0 ]]; then
-  echo "TOP AGENTS                            Count    Success   Plugin"
-  echo "$LINE68_THIN"
-
-  if command -v jq >/dev/null 2>&1; then
-    echo -e "$EVENTS" | grep '"type":"agent"' | jq -r '.name' 2>/dev/null | sort | uniq -c | sort -rn | head -$LIMIT | while read -r count name; do
-      PADDED_NAME=$(printf "%-35s" "$name" | tr ' ' '.')
-      PLUGIN=$(echo -e "$EVENTS" | grep "\"name\":\"$name\"" | jq -r '.plugin // "-"' 2>/dev/null | head -1)
-      printf "%s %8s          %s\n" "$PADDED_NAME" "$count" "$PLUGIN"
-    done
-  else
-    echo -e "$EVENTS" | grep '"type":"agent"' | grep -oP '"name"\s*:\s*"\K[^"]+' | sort | uniq -c | sort -rn | head -$LIMIT
-  fi
-  echo ""
-fi
-
-# Show summary if no events of specific types
-if [[ "$COMMAND_COUNT" -eq 0 ]] && [[ "$SKILL_COUNT" -eq 0 ]] && [[ "$AGENT_COUNT" -eq 0 ]]; then
-  echo "No events matching filters."
-  echo ""
-fi
-
-# Daily activity (last 7 days)
-echo "ACTIVITY (recent days)"
-echo "$LINE68_THIN"
-
-for i in 6 5 4 3 2 1 0; do
-  if [[ "$(uname)" == "Darwin" ]]; then
-    DAY=$(date -v-${i}d +%Y-%m-%d)
-    DAY_NAME=$(date -v-${i}d +%a)
-  else
-    DAY=$(date -d "$i days ago" +%Y-%m-%d)
-    DAY_NAME=$(date -d "$i days ago" +%a)
-  fi
-
-  DAY_COUNT=$(echo -e "$EVENTS" | grep "\"timestamp\":\"$DAY" | wc -l | tr -d ' ')
-
-  # Simple bar chart
-  BAR=""
-  BAR_LEN=$((DAY_COUNT / 3))  # Scale down for display
-  [[ $BAR_LEN -gt 10 ]] && BAR_LEN=10
-
-  for ((j=0; j<BAR_LEN; j++)); do
-    BAR="${BAR}█"
-  done
-  for ((j=BAR_LEN; j<10; j++)); do
-    BAR="${BAR}░"
-  done
-
-  printf "%s: %s %s\n" "$DAY_NAME" "$BAR" "$DAY_COUNT"
-done
-
-echo ""

package/plugins/specweave/scripts/read-costs.sh

@@ -1,132 +0,0 @@
-#!/usr/bin/env bash
-# read-costs.sh - Pure bash reader for /sw:costs
-#
-# Shows cost/token tracking dashboard.
-# Reads from pre-computed dashboard cache for <10ms response time.
-#
-# Usage: bash read-costs.sh [incrementId]
-#
-# Compatible with bash 3.x (macOS default)
-
-set -e
-
-INCREMENT_ID="${1:-}"
-
-# Find project root
-PROJECT_ROOT="$PWD"
-while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; do
-  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
-done
-
-if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
-  echo "No SpecWeave project found (missing .specweave/)"
-  exit 0
-fi
-
-CACHE_FILE="$PROJECT_ROOT/.specweave/state/dashboard.json"
-SCRIPTS_DIR="$(dirname "${BASH_SOURCE[0]}")"
-
-# Check if jq is available
-if ! command -v jq >/dev/null 2>&1; then
-  echo "❌ jq required for costs command. Install with: brew install jq"
-  exit 1
-fi
-
-# If cache doesn't exist or is corrupted, rebuild it
-NEED_REBUILD=false
-if [[ ! -f "$CACHE_FILE" ]]; then
-  NEED_REBUILD=true
-elif ! jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
-  # Cache exists but is corrupted (invalid JSON)
-  NEED_REBUILD=true
-fi
-
-if [[ "$NEED_REBUILD" == "true" ]]; then
-  bash "$SCRIPTS_DIR/rebuild-dashboard-cache.sh" --quiet 2>/dev/null || true
-fi
-
-if [[ ! -f "$CACHE_FILE" ]] || ! jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
-  echo "❌ Cache unavailable. Try: bash plugins/specweave/scripts/rebuild-dashboard-cache.sh"
-  exit 1
-fi
-
-echo ""
-echo "💰 SpecWeave Cost Dashboard"
-echo ""
-
-# Read costs from cache
-TOTAL_TOKENS=$(jq '.costs.totalTokens // 0' "$CACHE_FILE")
-TOTAL_COST=$(jq '.costs.totalCost // 0' "$CACHE_FILE")
-TOTAL_SAVINGS=$(jq '.costs.totalSavings // 0' "$CACHE_FILE")
-
-if [[ "$TOTAL_TOKENS" -eq 0 ]] && [[ "$TOTAL_COST" == "0" ]]; then
-  echo "📊 No cost data yet"
-  echo ""
-  echo "Cost tracking starts when you run agents with model hints."
-  echo ""
-  echo "💡 Tips:"
-  echo "   • Use ⚡ haiku for simple tasks (3x faster, 20x cheaper)"
-  echo "   • Use 💎 opus for complex reasoning (default, best quality)"
-  echo "   • Use 🧠 sonnet only for legacy compatibility (rarely needed)"
-  echo ""
-  echo "Model hints in tasks.md:"
-  echo "   ### T-001: Setup project structure ⚡"
-  echo "   ### T-002: Design architecture 💎"
-  exit 0
-fi
-
-# Format numbers
-format_tokens() {
-  local tokens=$1
-  if [[ "$tokens" -ge 1000000 ]]; then
-    echo "$((tokens / 1000000))M"
-  elif [[ "$tokens" -ge 1000 ]]; then
-    echo "$((tokens / 1000))k"
-  else
-    echo "$tokens"
-  fi
-}
-
-format_cost() {
-  local cost=$1
-  if [[ "${cost%.*}" -ge 100 ]]; then
-    printf "\$%.0f" "$cost"
-  else
-    printf "\$%.2f" "$cost"
-  fi
-}
-
-# Display totals
-echo "📈 Totals:"
-echo "   Tokens: $(format_tokens "$TOTAL_TOKENS")"
-echo "   Cost: $(format_cost "$TOTAL_COST")"
-echo "   Savings: $(format_cost "$TOTAL_SAVINGS") (vs all-Sonnet)"
-echo ""
-
-# If specific increment requested
-if [[ -n "$INCREMENT_ID" ]]; then
-  INC_COSTS=$(jq --arg id "$INCREMENT_ID" '.costs.byIncrement[$id] // empty' "$CACHE_FILE" 2>/dev/null)
-  if [[ -n "$INC_COSTS" ]]; then
-    INC_TOKENS=$(echo "$INC_COSTS" | jq -r '.tokens // 0')
-    INC_COST=$(echo "$INC_COSTS" | jq -r '.cost // 0')
-    INC_SAVINGS=$(echo "$INC_COSTS" | jq -r '.savings // 0')
-    echo "📦 Increment: $INCREMENT_ID"
-    echo "   Tokens: $(format_tokens "$INC_TOKENS")"
-    echo "   Cost: $(format_cost "$INC_COST")"
-    echo "   Savings: $(format_cost "$INC_SAVINGS")"
-    echo ""
-  else
-    echo "No cost data for increment: $INCREMENT_ID"
-    echo ""
-  fi
-fi
-
-# Show top increments by cost
-echo "📊 Cost by Increment (top 5):"
-jq -r '.costs.byIncrement | to_entries | sort_by(-.value.cost) | .[0:5][] |
-  "   \(.key): $\(.value.cost | tostring | .[0:6])"' "$CACHE_FILE" 2>/dev/null || echo "   (no data)"
-echo ""
-
-echo "💡 Commands:"
-echo "   /sw:costs <id>     View increment costs"
-echo "   /sw:progress       View task progress"