specweave 1.0.593 → 2.0.3

package/plugins/specweave/scripts/read-grill-context.sh

@@ -1,149 +0,0 @@
-#!/usr/bin/env bash
-# read-grill-context.sh - Load increment context for /sw:grill code review
-#
-# Executed by UserPromptSubmit hook when /sw:grill is detected.
-# Outputs structured context + review instructions that get injected
-# into the LLM's conversation via additionalContext.
-#
-# Usage: bash read-grill-context.sh [incrementId]
-#
-# If no incrementId given, auto-detects from active-increment.json.
-# Supports partial ID matching (e.g., "0042" matches "0042-auth-feature").
-#
-# 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 1
-fi
-
-INCREMENTS_DIR="$PROJECT_ROOT/.specweave/increments"
-STATE_DIR="$PROJECT_ROOT/.specweave/state"
-
-# Auto-detect active increment if no ID given
-if [[ -z "$INCREMENT_ID" ]]; then
-  if [[ -f "$STATE_DIR/active-increment.json" ]] && command -v jq >/dev/null 2>&1; then
-    INCREMENT_ID=$(jq -r '.ids[0] // empty' "$STATE_DIR/active-increment.json" 2>/dev/null)
-  fi
-
-  if [[ -z "$INCREMENT_ID" ]]; then
-    echo "No increment ID provided and no active increment found."
-    echo "Usage: /sw:grill <incrementId>"
-    exit 1
-  fi
-fi
-
-# Find increment folder (exact or partial match)
-FOUND_DIR=""
-if [[ -d "$INCREMENTS_DIR/$INCREMENT_ID" ]]; then
-  FOUND_DIR="$INCREMENTS_DIR/$INCREMENT_ID"
-else
-  # Partial match
-  for dir in "$INCREMENTS_DIR"/[0-9]*/; do
-    dirname=$(basename "$dir")
-    if [[ "$dirname" == "$INCREMENT_ID"* ]]; then
-      FOUND_DIR="${dir%/}"  # Strip trailing slash from glob
-      INCREMENT_ID="$dirname"
-      break
-    fi
-  done
-fi
-
-if [[ -z "$FOUND_DIR" ]] || [[ ! -d "$FOUND_DIR" ]]; then
-  echo "Increment not found: ${1:-$INCREMENT_ID}"
-  exit 1
-fi
-
-# Read metadata
-STATUS="unknown"
-TYPE="feature"
-PRIORITY="P1"
-if [[ -f "$FOUND_DIR/metadata.json" ]] && command -v jq >/dev/null 2>&1; then
-  STATUS=$(jq -r '.status // "unknown"' "$FOUND_DIR/metadata.json" 2>/dev/null)
-  TYPE=$(jq -r '.type // "feature"' "$FOUND_DIR/metadata.json" 2>/dev/null)
-  PRIORITY=$(jq -r '.priority // "P1"' "$FOUND_DIR/metadata.json" 2>/dev/null)
-fi
-
-# Count tasks
-# NOTE: grep -c exits 1 on zero matches but still outputs "0".
-# Using || true prevents set -e from killing the script without doubling output.
-TASK_TOTAL=0
-TASK_COMPLETED=0
-TASK_PCT=0
-if [[ -f "$FOUND_DIR/tasks.md" ]]; then
-  TASK_TOTAL=$(grep -c '### T-[0-9]' "$FOUND_DIR/tasks.md" 2>/dev/null) || true
-  TASK_COMPLETED=$(grep -ci '\*\*Status\*\*:\s*\[x\]' "$FOUND_DIR/tasks.md" 2>/dev/null) || true
-  [[ -z "$TASK_TOTAL" ]] && TASK_TOTAL=0
-  [[ -z "$TASK_COMPLETED" ]] && TASK_COMPLETED=0
-  if [[ "$TASK_TOTAL" -gt 0 ]]; then
-    TASK_PCT=$((TASK_COMPLETED * 100 / TASK_TOTAL))
-  fi
-fi
-
-# Count ACs from spec.md
-AC_TOTAL=0
-AC_COMPLETED=0
-AC_PCT=0
-if [[ -f "$FOUND_DIR/spec.md" ]]; then
-  AC_TOTAL=$(grep -cE '^\s*- \[[ x]\] \*\*AC-' "$FOUND_DIR/spec.md" 2>/dev/null) || true
-  AC_COMPLETED=$(grep -cE '^\s*- \[x\] \*\*AC-' "$FOUND_DIR/spec.md" 2>/dev/null) || true
-  [[ -z "$AC_TOTAL" ]] && AC_TOTAL=0
-  [[ -z "$AC_COMPLETED" ]] && AC_COMPLETED=0
-  if [[ "$AC_TOTAL" -gt 0 ]]; then
-    AC_PCT=$((AC_COMPLETED * 100 / AC_TOTAL))
-  fi
-fi
-
-# Output structured grill context
-cat <<GRILL_CONTEXT
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-GRILL MODE ACTIVATED — ${INCREMENT_ID}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-CONTEXT:
-  Status: ${STATUS} | Type: ${TYPE} | Priority: ${PRIORITY}
-  Tasks: ${TASK_COMPLETED}/${TASK_TOTAL} (${TASK_PCT}%)
-  ACs:   ${AC_COMPLETED}/${AC_TOTAL} (${AC_PCT}%)
-
-INCREMENT FILES:
-  spec.md:  ${FOUND_DIR}/spec.md
-  tasks.md: ${FOUND_DIR}/tasks.md
-  plan.md:  ${FOUND_DIR}/plan.md
-
-INSTRUCTIONS — You are now in GRILL MODE. Act as a demanding senior engineer:
-
-1. Read the increment's spec.md to understand WHAT should have been built
-2. Read tasks.md to understand WHAT was done
-3. Find all changed files:
-   git diff --name-only \$(git merge-base HEAD main 2>/dev/null || git merge-base HEAD develop 2>/dev/null || echo HEAD~10)..HEAD 2>/dev/null
-   If git is not available, read the tasks for file references.
-4. For EACH significant changed file, check:
-   - Correctness: Does it satisfy the ACs? Edge cases? Null handling?
-   - Security: Injection? XSS? Auth bypass? Secrets in code?
-   - Performance: O(n²)? N+1 queries? Memory leaks? Blocking ops?
-   - Maintainability: God functions? Magic numbers? Inconsistent patterns?
-5. Categorize every issue found:
-   BLOCKER  — Production will break, MUST fix
-   CRITICAL — Security/data risk, MUST fix
-   MAJOR    — Significant gap, should fix
-   MINOR    — Code quality, can fix later
-   SUGGESTION — Nice to have improvement
-
-OUTPUT FORMAT:
-  For each issue: [{SEVERITY}] Title | File:line | Problem | Fix
-  End with: VERDICT: PASS (no blockers/criticals) or FAIL (has blockers/criticals)
-
-If FAIL: List blocking issues and stop. Do NOT proceed with /sw:done.
-If PASS: Code is ready for closure.
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-GRILL_CONTEXT

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

@@ -1,371 +0,0 @@
-#!/usr/bin/env bash
-# read-jobs.sh - Pure bash reader for /sw:jobs
-#
-# Shows current work status (increments) + background jobs + helpful context.
-# Reads from pre-computed dashboard cache for <10ms response time.
-#
-# Usage: bash read-jobs.sh [--all] [--id <jobId>]
-#
-# Compatible with bash 3.x (macOS default)
-
-set -e
-
-# Parse arguments
-SHOW_ALL=true  # Changed: Show all jobs by default (including completed)
-SPECIFIC_ID=""
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --all) SHOW_ALL=true; shift ;;
-    --id) SPECIFIC_ID="$2"; shift 2 ;;
-    *) shift ;;
-  esac
-done
-
-# 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"
-JOBS_FILE="$PROJECT_ROOT/.specweave/state/background-jobs.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/jobs.js" ]]; then
-    echo "⚠️  Install jq for instant status commands: brew install jq"
-    exec node "$SCRIPTS_DIR/jobs.js" "$@"
-  else
-    echo "❌ jq not found and no fallback script available"
-    exit 1
-  fi
-fi
-
-# ============================================================================
-# If specific job ID requested, show details and exit
-# ============================================================================
-
-if [[ -n "$SPECIFIC_ID" ]] && [[ -f "$JOBS_FILE" ]]; then
-  JOB=$(jq --arg id "$SPECIFIC_ID" '
-    .jobs[] | select(.id == $id or (.id | startswith($id)))
-  ' "$JOBS_FILE" 2>/dev/null)
-
-  if [[ -z "$JOB" ]]; then
-    echo "Job not found: $SPECIFIC_ID"
-    exit 1
-  fi
-
-  ID=$(echo "$JOB" | jq -r '.id')
-  TYPE=$(echo "$JOB" | jq -r '.type')
-  STATUS=$(echo "$JOB" | jq -r '.status')
-  STARTED=$(echo "$JOB" | jq -r '.startedAt')
-  UPDATED=$(echo "$JOB" | jq -r '.updatedAt')
-  CURRENT=$(echo "$JOB" | jq -r '.progress.current // 0')
-  TOTAL=$(echo "$JOB" | jq -r '.progress.total // 0')
-  ERROR=$(echo "$JOB" | jq -r '.error // empty')
-
-  if [[ "$TOTAL" -gt 0 ]]; then
-    PCT=$((CURRENT * 100 / TOTAL))
-  else
-    PCT=0
-  fi
-
-  echo ""
-  echo "📦 Job Details: $ID"
-  echo ""
-  echo "Type: $TYPE"
-  echo "Status: $STATUS"
-  echo "Started: $STARTED"
-  echo "Updated: $UPDATED"
-  echo "Progress: $CURRENT/$TOTAL ($PCT%)"
-
-  if [[ -n "$ERROR" ]]; then
-    echo "Error: $ERROR"
-  fi
-  exit 0
-fi
-
-# ============================================================================
-# SECTION 1: Current Work Status (from dashboard cache)
-# ============================================================================
-
-echo ""
-echo "📊 Current Work Status"
-echo "────────────────────────────────────────"
-
-# Rebuild cache if needed
-if [[ ! -f "$CACHE_FILE" ]] || ! jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
-  if [[ -f "$SCRIPTS_DIR/rebuild-dashboard-cache.sh" ]]; then
-    bash "$SCRIPTS_DIR/rebuild-dashboard-cache.sh" --quiet 2>/dev/null || true
-  fi
-fi
-
-if [[ -f "$CACHE_FILE" ]] && jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
-  # Show active increments
-  ACTIVE=$(jq -r '
-    .increments | to_entries[] |
-    select(.value.status == "active" or .value.status == "planning" or .value.status == "backlog" or .value.status == "ready_for_review") |
-    "\(.key)|\(.value.status)|\(.value.tasks.completed)|\(.value.tasks.total)"
-  ' "$CACHE_FILE" 2>/dev/null)
-
-  if [[ -n "$ACTIVE" ]]; then
-    echo ""
-    echo "🔄 In Progress:"
-    while IFS='|' read -r id status completed total; do
-      [[ -z "$id" ]] && continue
-      if [[ "$total" -gt 0 ]]; then
-        pct=$((completed * 100 / total))
-      else
-        pct=0
-      fi
-      echo "   $id ($status)"
-      echo "      Tasks: $completed/$total ($pct%)"
-    done <<< "$ACTIVE"
-  fi
-
-  # Show paused increments
-  PAUSED_INC=$(jq -r '
-    .increments | to_entries[] |
-    select(.value.status == "paused") |
-    "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)"
-  ' "$CACHE_FILE" 2>/dev/null)
-
-  if [[ -n "$PAUSED_INC" ]]; then
-    echo ""
-    PAUSED_INC_COUNT=$(echo "$PAUSED_INC" | wc -l | tr -d ' ')
-    echo "⏸️  Paused Increments ($PAUSED_INC_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"
-    done <<< "$PAUSED_INC"
-  fi
-
-  # Show ready for review
-  READY=$(jq -r '
-    .increments | to_entries[] |
-    select(.value.status == "ready_for_review") |
-    .key
-  ' "$CACHE_FILE" 2>/dev/null)
-
-  if [[ -n "$READY" ]]; then
-    echo ""
-    echo "👀 Ready for Review:"
-    while read -r id; do
-      [[ -z "$id" ]] && continue
-      echo "   $id"
-    done <<< "$READY"
-  fi
-
-  # Summary stats
-  TOTAL_INC=$(jq '.summary.total // 0' "$CACHE_FILE")
-  ACTIVE_COUNT=$(jq '.summary.active // 0' "$CACHE_FILE")
-  COMPLETED_INC_COUNT=$(jq '.summary.completed // 0' "$CACHE_FILE")
-
-  if [[ -z "$ACTIVE" ]] && [[ -z "$PAUSED_INC" ]] && [[ -z "$READY" ]]; then
-    echo ""
-    echo "   No active increments."
-    if [[ "$COMPLETED_INC_COUNT" -gt 0 ]]; then
-      echo "   $COMPLETED_INC_COUNT increment(s) completed."
-    fi
-  fi
-
-  echo ""
-  echo "   Summary: $TOTAL_INC total | $ACTIVE_COUNT active | $COMPLETED_INC_COUNT completed"
-else
-  echo ""
-  echo "   No increment data available (cache not found)."
-  echo "   Run /sw:status to rebuild cache."
-fi
-
-echo ""
-echo "────────────────────────────────────────"
-
-# ============================================================================
-# SECTION 1.5: Auto Session Status (if running)
-# ============================================================================
-
-AUTO_SESSION="$PROJECT_ROOT/.specweave/state/auto-session.json"
-if [[ -f "$AUTO_SESSION" ]] && jq -e '.status == "running"' "$AUTO_SESSION" >/dev/null 2>&1; then
-  ITER=$(jq -r '.iteration // 0' "$AUTO_SESSION")
-  MAX_ITER=$(jq -r '.maxIterations // 100' "$AUTO_SESSION")
-  CURRENT_INC=$(jq -r '.currentIncrement // "unknown"' "$AUTO_SESSION")
-  SESSION_ID=$(jq -r '.sessionId // "unknown"' "$AUTO_SESSION")
-  echo ""
-  echo "🤖 Auto Mode: RUNNING"
-  echo "   Session: $SESSION_ID"
-  echo "   Iteration: $ITER / $MAX_ITER"
-  echo "   Current: $CURRENT_INC"
-  echo ""
-  echo "   Details: /sw:auto-status"
-  echo "   Cancel: /sw:cancel-auto"
-  echo ""
-  echo "────────────────────────────────────────"
-fi
-
-# ============================================================================
-# SECTION 2: Background Jobs
-# ============================================================================
-
-echo ""
-echo "⚙️  Background Jobs"
-echo "────────────────────────────────────────"
-
-# Check if jobs file exists and has jobs
-HAS_JOBS=false
-if [[ -f "$JOBS_FILE" ]] && jq -e '.jobs | length > 0' "$JOBS_FILE" >/dev/null 2>&1; then
-  HAS_JOBS=true
-fi
-
-if [[ "$HAS_JOBS" == "false" ]]; then
-  echo ""
-  echo "   No background jobs."
-  echo ""
-  echo "   Background jobs are created for:"
-  echo "   • Large issue imports (1000+ items from GitHub/JIRA/ADO)"
-  echo "   • Multi-repository cloning (umbrella setup)"
-  echo "   • Brownfield analysis (documentation gap detection)"
-  echo ""
-  echo "   Start jobs with:"
-  echo "   • /sw:import-external  - Import from external tools"
-  echo "   • specweave init              - May spawn background jobs"
-else
-  echo ""
-
-  # Running jobs
-  RUNNING=$(jq -r '.jobs[] | select(.status == "running") | "\(.id)|\(.type)|\(.progress.current)|\(.progress.total)|\(.startedAt)"' "$JOBS_FILE" 2>/dev/null)
-
-  if [[ -n "$RUNNING" ]]; then
-    RUNNING_COUNT=$(echo "$RUNNING" | wc -l | tr -d ' ')
-    echo "🔄 Running ($RUNNING_COUNT):"
-    while IFS='|' read -r id type current total started; do
-      [[ -z "$id" ]] && continue
-      if [[ "$total" -gt 0 ]]; then
-        pct=$((current * 100 / total))
-      else
-        pct=0
-      fi
-      echo "   [${id:0:8}] $type"
-      echo "      Progress: $current/$total ($pct%)"
-    done <<< "$RUNNING"
-    echo ""
-  fi
-
-  # Paused jobs
-  PAUSED=$(jq -r '.jobs[] | select(.status == "paused") | "\(.id)|\(.type)|\(.progress.current)|\(.progress.total)"' "$JOBS_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 type current total; do
-      [[ -z "$id" ]] && continue
-      if [[ "$total" -gt 0 ]]; then
-        pct=$((current * 100 / total))
-      else
-        pct=0
-      fi
-      echo "   [${id:0:8}] $type - $pct%"
-    done <<< "$PAUSED"
-    echo ""
-  fi
-
-  # Failed jobs
-  FAILED=$(jq -r '.jobs[] | select(.status == "failed") | "\(.id)|\(.type)|\(.error // "unknown")"' "$JOBS_FILE" 2>/dev/null)
-
-  if [[ -n "$FAILED" ]]; then
-    FAILED_COUNT=$(echo "$FAILED" | wc -l | tr -d ' ')
-    echo "❌ Failed ($FAILED_COUNT):"
-    while IFS='|' read -r id type error; do
-      [[ -z "$id" ]] && continue
-      echo "   [${id:0:8}] $type"
-      if [[ -n "$error" ]] && [[ "$error" != "null" ]]; then
-        echo "      Error: $error"
-      fi
-    done <<< "$FAILED"
-    echo ""
-  fi
-
-  # Completed jobs (only with --all)
-  if [[ "$SHOW_ALL" == "true" ]]; then
-    COMPLETED=$(jq -r '.jobs[] | select(.status == "completed") | "\(.id)|\(.type)|\(.progress.current)|\(.completedAt)"' "$JOBS_FILE" 2>/dev/null)
-
-    if [[ -n "$COMPLETED" ]]; then
-      COMPLETED_COUNT=$(echo "$COMPLETED" | wc -l | tr -d ' ')
-      echo "✅ Completed ($COMPLETED_COUNT):"
-      COUNT=0
-      while IFS='|' read -r id type items completed_at; do
-        [[ -z "$id" ]] && continue
-        if [[ $COUNT -lt 10 ]]; then
-          # Calculate time ago
-          if [[ -n "$completed_at" ]] && [[ "$completed_at" != "null" ]]; then
-            NOW=$(date +%s)
-            COMPLETED_TS=$(date -j -f "%Y-%m-%dT%H:%M:%S" "$(echo "$completed_at" | cut -d'.' -f1)" +%s 2>/dev/null || echo "$NOW")
-            DIFF=$((NOW - COMPLETED_TS))
-            DAYS=$((DIFF / 86400))
-            HOURS=$(((DIFF % 86400) / 3600))
-
-            if [[ $DAYS -gt 0 ]]; then
-              TIME_AGO="${DAYS} day$([ $DAYS -ne 1 ] && echo 's') ago"
-            elif [[ $HOURS -gt 0 ]]; then
-              TIME_AGO="${HOURS} hour$([ $HOURS -ne 1 ] && echo 's') ago"
-            else
-              TIME_AGO="recently"
-            fi
-          else
-            TIME_AGO=""
-          fi
-
-          if [[ -n "$TIME_AGO" ]]; then
-            echo "   [${id:0:8}] $type - $items items - $TIME_AGO"
-          else
-            echo "   [${id:0:8}] $type - $items items"
-          fi
-          COUNT=$((COUNT + 1))
-        fi
-      done <<< "$COMPLETED"
-      if [[ $COMPLETED_COUNT -gt 10 ]]; then
-        echo "   ... and $((COMPLETED_COUNT - 10)) more"
-      fi
-      echo ""
-    fi
-  fi
-
-  # Summary if no active jobs AND not showing all
-  if [[ "$SHOW_ALL" != "true" ]]; then
-    RUNNING_COUNT=$(jq '[.jobs[] | select(.status == "running")] | length' "$JOBS_FILE" 2>/dev/null || echo "0")
-    PAUSED_COUNT=$(jq '[.jobs[] | select(.status == "paused")] | length' "$JOBS_FILE" 2>/dev/null || echo "0")
-    FAILED_COUNT=$(jq '[.jobs[] | select(.status == "failed")] | length' "$JOBS_FILE" 2>/dev/null || echo "0")
-    COMPLETED_COUNT=$(jq '[.jobs[] | select(.status == "completed")] | length' "$JOBS_FILE" 2>/dev/null || echo "0")
-
-    if [[ "$RUNNING_COUNT" -eq 0 ]] && [[ "$PAUSED_COUNT" -eq 0 ]] && [[ "$FAILED_COUNT" -eq 0 ]]; then
-      if [[ "$COMPLETED_COUNT" -gt 0 ]]; then
-        echo "   No active jobs. $COMPLETED_COUNT completed (use --all to see)."
-      fi
-    fi
-  fi
-fi
-
-# ============================================================================
-# SECTION 3: Commands Help
-# ============================================================================
-
-echo ""
-echo "────────────────────────────────────────"
-echo ""
-echo "💡 Commands:"
-echo "   /sw:do               Execute current tasks"
-echo "   /sw:progress         Show task progress details"
-echo "   /sw:done <id>        Close increment"
-echo "   /sw:jobs --id <id>   View background job details"
-echo "   /sw:jobs --all       Show completed jobs"
-echo ""