specweave 0.32.0 → 0.32.3

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

@@ -0,0 +1,185 @@
+#!/usr/bin/env bash
+# read-progress.sh - Pure bash reader for /specweave:progress
+#
+# Reads from pre-computed dashboard cache for <10ms response time.
+# Falls back to Node.js script if jq is not available.
+#
+# Usage: bash read-progress.sh [incrementId]
+#
+# Compatible with bash 3.x (macOS default)
+
+set -e
+
+INCREMENT_ID="${1:-}"
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+
+if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+  echo "No SpecWeave project found (missing .specweave/)"
+  exit 0
+fi
+
+CACHE_FILE="$PROJECT_ROOT/.specweave/state/dashboard.json"
+SCRIPTS_DIR="$PROJECT_ROOT/plugins/specweave/scripts"
+
+# Check if jq is available, fall back to Node if not
+if ! command -v jq >/dev/null 2>&1; then
+  if [[ -f "$SCRIPTS_DIR/progress.js" ]]; then
+    echo "⚠️  Install jq for instant status commands: brew install jq"
+    exec node "$SCRIPTS_DIR/progress.js" "$@"
+  else
+    echo "❌ jq not found and no fallback script available"
+    exit 1
+  fi
+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 still no cache, fall back to Node
+if [[ ! -f "$CACHE_FILE" ]] || ! jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
+  exec node "$SCRIPTS_DIR/progress.js" "$@"
+fi
+
+# Helper: create progress bar
+progress_bar() {
+  local pct="$1"
+  local width="${2:-20}"
+  local filled=$((pct * width / 100))
+  local empty=$((width - filled))
+
+  local bar="["
+  for ((i=0; i<filled; i++)); do bar+="█"; done
+  for ((i=0; i<empty; i++)); do bar+="░"; done
+  bar+="]"
+  echo "$bar"
+}
+
+# Helper: format status with icon
+format_status() {
+  case "$1" in
+    active) echo "🔄 active" ;;
+    planning) echo "📝 planning" ;;
+    paused) echo "⏸️ paused" ;;
+    completed) echo "✅ completed" ;;
+    abandoned) echo "❌ abandoned" ;;
+    ready_for_review) echo "👀 ready for review" ;;
+    backlog) echo "📋 backlog" ;;
+    *) echo "$1" ;;
+  esac
+}
+
+# If specific increment requested
+if [[ -n "$INCREMENT_ID" ]]; then
+  # Find increment (partial match)
+  FULL_ID=$(jq -r --arg id "$INCREMENT_ID" '
+    .increments | keys[] | select(. == $id or startswith($id))
+  ' "$CACHE_FILE" | head -1)
+
+  if [[ -z "$FULL_ID" ]]; then
+    echo "Increment not found: $INCREMENT_ID"
+    exit 1
+  fi
+
+  # Read increment data
+  INC_DATA=$(jq --arg id "$FULL_ID" '.increments[$id]' "$CACHE_FILE")
+  STATUS=$(echo "$INC_DATA" | jq -r '.status // "unknown"')
+  TYPE=$(echo "$INC_DATA" | jq -r '.type // "feature"')
+  TOTAL=$(echo "$INC_DATA" | jq -r '.tasks.total // 0')
+  COMPLETED=$(echo "$INC_DATA" | jq -r '.tasks.completed // 0')
+
+  if [[ "$TOTAL" -gt 0 ]]; then
+    PCT=$((COMPLETED * 100 / TOTAL))
+  else
+    PCT=0
+  fi
+
+  BAR=$(progress_bar "$PCT")
+  STATUS_FMT=$(format_status "$STATUS")
+
+  echo ""
+  echo "📊 Progress: $FULL_ID"
+  echo ""
+  echo "Status: $STATUS_FMT"
+  echo "Type: $TYPE"
+  echo "Tasks: $COMPLETED/$TOTAL ($PCT%)"
+  echo "Progress: $BAR"
+  exit 0
+fi
+
+# Show all active increments
+echo ""
+echo "📊 Increment Progress"
+echo ""
+
+# Get active increments
+ACTIVE=$(jq -r '
+  .increments | to_entries[] |
+  select(.value.status == "active" or .value.status == "planning" or .value.status == "in-progress") |
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)"
+' "$CACHE_FILE" 2>/dev/null)
+
+ACTIVE_COUNT=0
+if [[ -n "$ACTIVE" ]]; then
+  echo "🔄 Active:"
+  while IFS='|' read -r id completed total; do
+    [[ -z "$id" ]] && continue
+    ACTIVE_COUNT=$((ACTIVE_COUNT + 1))
+    if [[ "$total" -gt 0 ]]; then
+      pct=$((completed * 100 / total))
+    else
+      pct=0
+    fi
+    bar=$(progress_bar "$pct" 15)
+    echo "  $id"
+    echo "     $bar $completed/$total ($pct%)"
+  done <<< "$ACTIVE"
+  echo ""
+fi
+
+# Get paused increments
+PAUSED=$(jq -r '
+  .increments | to_entries[] |
+  select(.value.status == "paused") |
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)"
+' "$CACHE_FILE" 2>/dev/null)
+
+if [[ -n "$PAUSED" ]]; then
+  PAUSED_COUNT=$(echo "$PAUSED" | wc -l | tr -d ' ')
+  echo "⏸️  Paused ($PAUSED_COUNT):"
+  while IFS='|' read -r id completed total; do
+    [[ -z "$id" ]] && continue
+    if [[ "$total" -gt 0 ]]; then
+      pct=$((completed * 100 / total))
+    else
+      pct=0
+    fi
+    echo "  $id - $pct%"
+  done <<< "$PAUSED"
+  echo ""
+fi
+
+# If no active/paused
+if [[ "$ACTIVE_COUNT" -eq 0 ]] && [[ -z "$PAUSED" ]]; then
+  echo "No active increments."
+  COMPLETED_COUNT=$(jq '.summary.completed // 0' "$CACHE_FILE")
+  if [[ "$COMPLETED_COUNT" -gt 0 ]]; then
+    echo "$COMPLETED_COUNT completed increment(s)."
+  fi
+fi
+
+echo "💡 For details: /specweave:progress <incrementId>"

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

@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+# read-status.sh - Pure bash reader for /specweave:status
+#
+# Reads from pre-computed dashboard cache for <10ms response time.
+# Falls back to Node.js script if jq is not available.
+#
+# Usage: bash read-status.sh
+#
+# Compatible with bash 3.x (macOS default)
+
+set -e
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+
+if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; then
+  echo "No SpecWeave project found (missing .specweave/)"
+  exit 0
+fi
+
+CACHE_FILE="$PROJECT_ROOT/.specweave/state/dashboard.json"
+SCRIPTS_DIR="$PROJECT_ROOT/plugins/specweave/scripts"
+
+# Check if jq is available, fall back to Node if not
+if ! command -v jq >/dev/null 2>&1; then
+  if [[ -f "$SCRIPTS_DIR/status.js" ]]; then
+    echo "⚠️  Install jq for instant status commands: brew install jq"
+    exec node "$SCRIPTS_DIR/status.js" "$@"
+  else
+    echo "❌ jq not found and no fallback script available"
+    exit 1
+  fi
+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 still no cache, fall back to Node
+if [[ ! -f "$CACHE_FILE" ]] || ! jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
+  exec node "$SCRIPTS_DIR/status.js" "$@"
+fi
+
+echo ""
+echo "📋 SpecWeave Status Overview"
+echo ""
+
+# Status display order and icons
+declare -a STATUS_ORDER
+STATUS_ORDER=("active" "planning" "in-progress" "ready_for_review" "paused" "backlog" "completed" "abandoned")
+
+status_icon() {
+  case "$1" in
+    active) echo "🔄" ;;
+    planning) echo "📝" ;;
+    in-progress) echo "⚙️" ;;
+    ready_for_review) echo "👀" ;;
+    paused) echo "⏸️" ;;
+    backlog) echo "📋" ;;
+    completed) echo "✅" ;;
+    abandoned) echo "❌" ;;
+    *) echo "•" ;;
+  esac
+}
+
+HAS_OUTPUT=false
+
+for status in "${STATUS_ORDER[@]}"; do
+  # Get increments with this status
+  ITEMS=$(jq -r --arg s "$status" '
+    .increments | to_entries[] |
+    select(.value.status == $s) | .key
+  ' "$CACHE_FILE" 2>/dev/null)
+
+  if [[ -n "$ITEMS" ]]; then
+    HAS_OUTPUT=true
+    COUNT=$(echo "$ITEMS" | wc -l | tr -d ' ')
+    ICON=$(status_icon "$status")
+    DISPLAY_STATUS="${status//_/ }"
+
+    echo "$ICON $DISPLAY_STATUS ($COUNT):"
+
+    # Show first 5
+    SHOWN=0
+    while read -r item; do
+      [[ -z "$item" ]] && continue
+      if [[ $SHOWN -lt 5 ]]; then
+        echo "   $item"
+        SHOWN=$((SHOWN + 1))
+      fi
+    done <<< "$ITEMS"
+
+    if [[ $COUNT -gt 5 ]]; then
+      echo "   ... and $((COUNT - 5)) more"
+    fi
+    echo ""
+  fi
+done
+
+if [[ "$HAS_OUTPUT" == "false" ]]; then
+  echo "No increments found."
+fi
+
+# Summary line
+TOTAL=$(jq '.summary.total // 0' "$CACHE_FILE")
+ACTIVE=$(jq '.summary.active // 0' "$CACHE_FILE")
+COMPLETED=$(jq '.summary.completed // 0' "$CACHE_FILE")
+ARCHIVED=$(jq '.summary.archived // 0' "$CACHE_FILE")
+
+echo "────────────────────────────────────────"
+echo "Total: $TOTAL increment(s) | Active: $ACTIVE | Completed: $COMPLETED | Archived: $ARCHIVED"
+
+# Show cache age in debug mode
+if [[ "${DEBUG:-}" == "1" ]] || [[ "${SPECWEAVE_DEBUG:-}" == "1" ]]; then
+  CACHE_MTIME=$(stat -f %m "$CACHE_FILE" 2>/dev/null || stat -c %Y "$CACHE_FILE" 2>/dev/null)
+  NOW=$(date +%s)
+  AGE_SECONDS=$((NOW - CACHE_MTIME))
+  if [[ $AGE_SECONDS -lt 60 ]]; then
+    AGE_STR="${AGE_SECONDS}s ago"
+  elif [[ $AGE_SECONDS -lt 3600 ]]; then
+    AGE_STR="$((AGE_SECONDS / 60))m ago"
+  else
+    AGE_STR="$((AGE_SECONDS / 3600))h ago"
+  fi
+  CACHE_VERSION=$(jq -r '.version // "?"' "$CACHE_FILE")
+  echo ""
+  echo "🔧 Debug: Cache v${CACHE_VERSION}, updated ${AGE_STR}"
+fi
+
+echo ""
+echo "💡 Commands:"
+echo "   /specweave:progress        Show task progress"
+echo "   /specweave:do              Execute current tasks"
+echo "   /specweave:done <id>       Close increment"

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

@@ -0,0 +1,173 @@
+#!/usr/bin/env bash
+# read-workflow.sh - Pure bash reader for /specweave:workflow
+#
+# Shows current phase, suggests next actions based on increment state.
+# Reads from pre-computed dashboard cache for <10ms response time.
+#
+# Usage: bash read-workflow.sh [incrementId]
+#
+# Compatible with bash 3.x (macOS default)
+
+set -e
+
+INCREMENT_ID="${1:-}"
+
+# Find project root
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+
+if [[ ! -d "$PROJECT_ROOT/.specweave" ]]; 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 workflow 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 Workflow Navigator"
+echo ""
+
+# Get active increment (or use provided ID)
+if [[ -n "$INCREMENT_ID" ]]; then
+  # Find full ID
+  ACTIVE_ID=$(jq -r --arg id "$INCREMENT_ID" '
+    .increments | keys[] | select(. == $id or startswith($id))
+  ' "$CACHE_FILE" | head -1)
+else
+  # Find first active increment
+  ACTIVE_ID=$(jq -r '
+    .increments | to_entries[] |
+    select(.value.status == "active" or .value.status == "in-progress") |
+    .key
+  ' "$CACHE_FILE" 2>/dev/null | head -1)
+fi
+
+if [[ -z "$ACTIVE_ID" ]]; then
+  echo "📭 No Active Increment"
+  echo ""
+  echo "Ready to start something new!"
+  echo ""
+
+  # Check for backlog items
+  BACKLOG_COUNT=$(jq '.summary.backlog // 0' "$CACHE_FILE")
+  if [[ "$BACKLOG_COUNT" -gt 0 ]]; then
+    echo "📋 Backlog: $BACKLOG_COUNT item(s) waiting"
+    echo "   Resume with: /specweave:resume <id>"
+    echo ""
+  fi
+
+  echo "💡 Suggestions:"
+  echo "   • /specweave:increment \"feature name\"  - Plan new work"
+  echo "   • /specweave:status                     - View all increments"
+  exit 0
+fi
+
+# Get increment data
+INC_DATA=$(jq --arg id "$ACTIVE_ID" '.increments[$id]' "$CACHE_FILE")
+STATUS=$(echo "$INC_DATA" | jq -r '.status // "unknown"')
+TYPE=$(echo "$INC_DATA" | jq -r '.type // "feature"')
+TASKS_TOTAL=$(echo "$INC_DATA" | jq -r '.tasks.total // 0')
+TASKS_COMPLETED=$(echo "$INC_DATA" | jq -r '.tasks.completed // 0')
+ACS_TOTAL=$(echo "$INC_DATA" | jq -r '.acs.total // 0')
+ACS_COMPLETED=$(echo "$INC_DATA" | jq -r '.acs.completed // 0')
+
+# Calculate percentages
+if [[ "$TASKS_TOTAL" -gt 0 ]]; then
+  TASK_PCT=$((TASKS_COMPLETED * 100 / TASKS_TOTAL))
+else
+  TASK_PCT=0
+fi
+
+if [[ "$ACS_TOTAL" -gt 0 ]]; then
+  AC_PCT=$((ACS_COMPLETED * 100 / ACS_TOTAL))
+else
+  AC_PCT=0
+fi
+
+# Determine phase and suggestions
+PHASE=""
+SUGGESTIONS=""
+
+if [[ "$STATUS" == "backlog" ]] || [[ "$STATUS" == "planned" ]]; then
+  PHASE="📝 Planning"
+  SUGGESTIONS="• /specweave:do     - Start implementation
+• /specweave:plan   - Generate plan.md and tasks.md"
+
+elif [[ "$TASKS_COMPLETED" -eq 0 ]]; then
+  PHASE="🚀 Starting"
+  SUGGESTIONS="• /specweave:do     - Execute first task
+• /specweave:pause  - Pause if not ready"
+
+elif [[ "$TASK_PCT" -lt 50 ]]; then
+  PHASE="🔨 In Progress (Early)"
+  SUGGESTIONS="• /specweave:do         - Continue implementation
+• /specweave:progress   - Check task details"
+
+elif [[ "$TASK_PCT" -lt 100 ]]; then
+  PHASE="⚙️ In Progress (Late)"
+  SUGGESTIONS="• /specweave:do         - Complete remaining tasks
+• /specweave:validate   - Early quality check"
+
+elif [[ "$STATUS" == "ready_for_review" ]]; then
+  PHASE="👀 Review"
+  SUGGESTIONS="• /specweave:validate   - Full validation
+• /specweave:done       - Close increment (PM approval)"
+
+elif [[ "$TASKS_COMPLETED" -eq "$TASKS_TOTAL" ]]; then
+  PHASE="✅ Tasks Complete"
+  SUGGESTIONS="• /specweave:validate   - Run quality checks
+• /specweave:done       - Close increment"
+
+else
+  PHASE="❓ Unknown"
+  SUGGESTIONS="• /specweave:status     - Check status"
+fi
+
+# Display
+echo "📍 Current Increment: $ACTIVE_ID"
+echo ""
+echo "Status: $STATUS"
+echo "Type: $TYPE"
+echo "Phase: $PHASE"
+echo ""
+echo "Progress:"
+echo "  Tasks: $TASKS_COMPLETED/$TASKS_TOTAL ($TASK_PCT%)"
+echo "  ACs:   $ACS_COMPLETED/$ACS_TOTAL ($AC_PCT%)"
+echo ""
+echo "💡 Next Actions:"
+echo "$SUGGESTIONS"
+echo ""
+
+# Additional context
+PAUSED_COUNT=$(jq '.summary.paused // 0' "$CACHE_FILE")
+if [[ "$PAUSED_COUNT" -gt 0 ]]; then
+  echo "ℹ️  $PAUSED_COUNT paused increment(s) - /specweave:resume to continue"
+  echo ""
+fi