specweave 1.0.593 → 2.0.0

package/plugins/specweave/scripts/analyze-standards.sh

@@ -1,315 +0,0 @@
-#!/usr/bin/env bash
-# ---
-# name: specweave-analyze-standards
-# description: Analyze and document coding standards from codebase. Detects naming conventions, import patterns, type usage, and anti-patterns. Generates evidence-based standards documentation with confidence levels. Supports full analysis, drift detection, and standards updates.
-# usage: /sw:analyze-standards [--drift] [--update] [--verbose]
-# ---
-
-set -e
-
-# Detect project root (where .specweave/ is located)
-PROJECT_ROOT="$(pwd)"
-while [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]] && [[ "$PROJECT_ROOT" != "/" ]]; do
-  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
-done
-
-if [[ ! -f "$PROJECT_ROOT/.specweave/config.json" ]]; then
-  echo "❌ Error: Not in a SpecWeave project (no .specweave/ directory found)"
-  exit 1
-fi
-
-cd "$PROJECT_ROOT"
-
-# Parse arguments
-MODE="full"
-VERBOSE=false
-
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --drift)
-      MODE="drift"
-      shift
-      ;;
-    --update)
-      MODE="update"
-      shift
-      ;;
-    --verbose)
-      VERBOSE=true
-      shift
-      ;;
-    *)
-      echo "❌ Unknown option: $1"
-      echo "Usage: /sw:analyze-standards [--drift] [--update] [--verbose]"
-      exit 1
-      ;;
-  esac
-done
-
-# Ensure governance directory exists
-GOVERNANCE_DIR="$PROJECT_ROOT/.specweave/docs/internal/governance"
-mkdir -p "$GOVERNANCE_DIR"
-
-# Display banner
-echo "🔍 Code Standards Analysis"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-case $MODE in
-  full)
-    echo "Mode: Full Analysis"
-    echo "Output: $GOVERNANCE_DIR/coding-standards-analysis.md"
-    echo ""
-    echo "📊 Analyzing codebase..."
-    echo ""
-
-    # Launch code-standards-detective agent
-    cat <<'AGENT_PROMPT'
-You are the code-standards-detective agent. Perform a complete coding standards analysis:
-
-## Your Mission
-
-Analyze this codebase and generate comprehensive coding standards documentation.
-
-## Steps
-
-### Phase 1: Explicit Standards (5 seconds)
-1. Check for existing `.specweave/docs/internal/governance/coding-standards.md`
-2. Parse ESLint config (`.eslintrc.json`, `.eslintrc.js`)
-3. Parse Prettier config (`.prettierrc`, `.prettierrc.json`)
-4. Parse TypeScript config (`tsconfig.json`)
-5. Extract standards from `CLAUDE.md`, `CONTRIBUTING.md`
-
-### Phase 2: Implicit Standards (30 seconds)
-1. Find all source files: `src/**/*.{ts,js,tsx,jsx}`
-2. Analyze naming conventions (variables, functions, classes, constants)
-3. Detect import patterns (extensions, ordering)
-4. Measure function characteristics (length, style)
-5. Assess type usage (any, interfaces vs types)
-6. Identify error handling patterns
-
-### Phase 3: Anti-Pattern Detection (15 seconds)
-1. Detect console.* usage in src/
-2. Find hardcoded secrets (API keys, passwords)
-3. Identify large files (>500 lines)
-4. Find long functions (>100 lines)
-5. Check error handling coverage
-6. Detect N+1 query patterns
-
-### Phase 4: Documentation Generation (10 seconds)
-1. Merge explicit + implicit standards
-2. Calculate confidence levels
-3. Extract real code examples
-4. Highlight inconsistencies
-5. Provide recommendations
-
-## Output
-
-Write comprehensive analysis to:
-`.specweave/docs/internal/governance/coding-standards-analysis.md`
-
-Include:
-- Summary with confidence levels
-- Naming conventions with examples
-- Import patterns
-- Function guidelines
-- Type safety assessment
-- Error handling analysis
-- Anti-patterns and security issues
-- Actionable recommendations
-
-## Console Summary
-
-Print summary to stdout:
-```
-✅ Analysis complete!
-
-📊 Summary:
-- Files: X
-- LOC: Y
-- Confidence: Z%
-
-✅ Strengths: [list]
-⚠️ Issues: [list]
-
-📄 Full report: .specweave/docs/internal/governance/coding-standards-analysis.md
-```
-
-Execute the analysis now.
-AGENT_PROMPT
-    ;;
-
-  drift)
-    echo "Mode: Drift Detection"
-    echo ""
-
-    # Check if standards exist
-    if [[ ! -f "$GOVERNANCE_DIR/coding-standards.md" ]]; then
-      echo "❌ Error: No coding standards found at:"
-      echo "   $GOVERNANCE_DIR/coding-standards.md"
-      echo ""
-      echo "💡 Tip: Run /sw:analyze-standards first to generate baseline standards"
-      exit 1
-    fi
-
-    echo "📊 Comparing declared standards vs actual code..."
-    echo ""
-
-    # Launch agent in drift-detection mode
-    cat <<'AGENT_PROMPT'
-You are the code-standards-detective agent in DRIFT DETECTION mode.
-
-## Your Mission
-
-Compare declared coding standards against actual codebase to detect drift.
-
-## Steps
-
-1. Read existing standards:
-   `.specweave/docs/internal/governance/coding-standards.md`
-
-2. Analyze current codebase (same as Phase 2-3 in full analysis)
-
-3. Compare declared vs actual:
-   - For each declared standard, check compliance percentage
-   - Identify violations
-   - Calculate drift score
-
-4. Report findings:
-   - Standards with high compliance (90%+) ✅
-   - Standards with drift (70-89%) ⚠️
-   - Standards violated (<70%) 🔴
-
-## Output Format
-
-```markdown
-# Standards Drift Report
-
-**Date**: {timestamp}
-**Overall Compliance**: {percentage}%
-
-## ✅ Compliant Standards (90%+)
-- Naming conventions: 98% compliant
-- Import extensions: 100% compliant
-
-## ⚠️ Drift Detected (70-89%)
-- Constant naming: 85% compliant (15% use camelCase instead of UPPER_SNAKE_CASE)
-  - Recommendation: Update 8 files or relax standard
-
-## 🔴 Violations (<70%)
-- Function length: 65% compliant (35% have functions >100 lines)
-  - Critical: src/core/orchestrator.ts:processIncrement() - 156 lines
-  - Recommendation: Refactor large functions or update standard
-
-## New Patterns Detected
-- Pattern: Using Zod for validation (34% of files)
-  - Not documented in standards
-  - Recommendation: Add to official standards
-```
-
-Write to: `.specweave/docs/internal/governance/coding-standards-drift.md`
-
-Print summary to stdout.
-
-Execute drift detection now.
-AGENT_PROMPT
-    ;;
-
-  update)
-    echo "Mode: Update Standards"
-    echo ""
-
-    # Check if analysis exists
-    if [[ ! -f "$GOVERNANCE_DIR/coding-standards-analysis.md" ]]; then
-      echo "⚠️  No analysis found. Running full analysis first..."
-      echo ""
-      MODE="full"
-      # Re-run in full mode (recursive call avoided by changing MODE)
-    fi
-
-    echo "📊 Generating updated standards..."
-    echo ""
-
-    # Launch agent in update mode
-    cat <<'AGENT_PROMPT'
-You are the code-standards-detective agent in UPDATE mode.
-
-## Your Mission
-
-Update official coding standards based on latest analysis.
-
-## Steps
-
-1. Read existing standards (if exist):
-   `.specweave/docs/internal/governance/coding-standards.md`
-
-2. Read latest analysis:
-   `.specweave/docs/internal/governance/coding-standards-analysis.md`
-
-3. Merge intelligently:
-   - Keep manually curated sections
-   - Update statistics from analysis
-   - Add new patterns if high confidence (>90%)
-   - Flag conflicts for human review
-
-4. Generate updated standards document
-
-## Important Rules
-
-- NEVER remove manually written content without asking
-- Mark auto-generated sections clearly
-- Add "Last Updated" timestamp
-- Preserve human rationale/explanations
-- Flag breaking changes
-
-## Output
-
-Write to: `.specweave/docs/internal/governance/coding-standards.md`
-
-Also write summary to: `.specweave/docs/internal/governance/coding-standards-history.md`
-- Append entry with timestamp
-- List what changed
-- Explain why
-
-Execute update now.
-AGENT_PROMPT
-    ;;
-esac
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "✅ Code standards analysis complete!"
-echo ""
-echo "📂 Files generated:"
-case $MODE in
-  full)
-    echo "   - $GOVERNANCE_DIR/coding-standards-analysis.md"
-    ;;
-  drift)
-    echo "   - $GOVERNANCE_DIR/coding-standards-drift.md"
-    ;;
-  update)
-    echo "   - $GOVERNANCE_DIR/coding-standards.md (updated)"
-    echo "   - $GOVERNANCE_DIR/coding-standards-history.md (appended)"
-    ;;
-esac
-echo ""
-echo "🎯 Next steps:"
-case $MODE in
-  full)
-    echo "   1. Review the analysis report"
-    echo "   2. Fix critical issues (hardcoded secrets, etc.)"
-    echo "   3. Run /sw:analyze-standards --update to formalize"
-    ;;
-  drift)
-    echo "   1. Review drift report"
-    echo "   2. Fix violations or update standards"
-    echo "   3. Re-run analysis to verify"
-    ;;
-  update)
-    echo "   1. Review updated standards"
-    echo "   2. Commit to git if satisfied"
-    echo "   3. Share with team"
-    ;;
-esac
-echo ""

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

@@ -1,283 +0,0 @@
-#!/bin/bash
-# auto-status.sh - Show Auto Session Status
-#
-# Usage: auto-status.sh [OPTIONS]
-#
-# Options:
-#   --json     Output in JSON format
-#   --simple   Minimal output
-#   -h, --help Show this help
-
-set -e
-
-# Options
-JSON_OUTPUT=false
-SIMPLE_OUTPUT=false
-
-while [[ $# -gt 0 ]]; do
-    case $1 in
-        --json)
-            JSON_OUTPUT=true
-            shift
-            ;;
-        --simple)
-            SIMPLE_OUTPUT=true
-            shift
-            ;;
-        -h|--help)
-            grep '^#' "$0" | grep -v '!/bin/bash' | sed 's/^# //'
-            exit 0
-            ;;
-        *)
-            shift
-            ;;
-    esac
-done
-
-# Project root detection
-PROJECT_ROOT="${PROJECT_ROOT:-$(pwd)}"
-STATE_DIR="$PROJECT_ROOT/.specweave/state"
-SESSION_FILE="$STATE_DIR/auto-session.json"
-INCREMENTS_DIR="$PROJECT_ROOT/.specweave/increments"
-
-# Check if session exists
-if [ ! -f "$SESSION_FILE" ]; then
-    if [ "$JSON_OUTPUT" = "true" ]; then
-        echo '{"active": false, "message": "No auto session found"}'
-    else
-        echo "Auto Session: Not Active"
-        echo ""
-
-        # Check for last session in logs
-        LAST_LOG=$(ls -t "$PROJECT_ROOT/.specweave/logs/auto-"*"-summary.md" 2>/dev/null | head -1)
-        if [ -n "$LAST_LOG" ] && [ -f "$LAST_LOG" ]; then
-            LAST_ID=$(basename "$LAST_LOG" | sed 's/-summary.md$//')
-            echo "Last Session: $LAST_ID"
-            # Show first 3 lines of summary if available
-            head -3 "$LAST_LOG" 2>/dev/null | sed 's/^/  /'
-            echo ""
-        fi
-
-        # Check for active increments that could be auto'd
-        # Priority: active/in-progress > planning > ready_for_review > backlog
-        ACTIVE_INC=""
-        PLANNING_INC=""
-        REVIEW_INC=""
-        for dir in "$INCREMENTS_DIR"/[0-9][0-9][0-9][0-9]-*/; do
-            if [ -d "$dir" ]; then
-                META_FILE="$dir/metadata.json"
-                if [ -f "$META_FILE" ]; then
-                    INC_STATUS=$(jq -r '.status' "$META_FILE" 2>/dev/null || echo "")
-                    case "$INC_STATUS" in
-                        active|in-progress)
-                            ACTIVE_INC=$(basename "$dir")
-                            break
-                            ;;
-                        planning)
-                            [ -z "$PLANNING_INC" ] && PLANNING_INC=$(basename "$dir")
-                            ;;
-                        ready_for_review)
-                            [ -z "$REVIEW_INC" ] && REVIEW_INC=$(basename "$dir")
-                            ;;
-                    esac
-                fi
-            fi
-        done
-        # Fall back to planning or review if no active
-        [ -z "$ACTIVE_INC" ] && [ -n "$PLANNING_INC" ] && ACTIVE_INC="$PLANNING_INC"
-        [ -z "$ACTIVE_INC" ] && [ -n "$REVIEW_INC" ] && ACTIVE_INC="$REVIEW_INC"
-
-        if [ -n "$ACTIVE_INC" ]; then
-            echo "Available increment: $ACTIVE_INC"
-            echo ""
-            echo "Start auto mode:"
-            echo "  /sw:auto              # Use this increment"
-            echo "  /sw:auto $ACTIVE_INC  # Explicit"
-        else
-            echo "No workable increments found."
-            echo ""
-            echo "Start auto mode:"
-            echo "  /sw:auto <increment-id>"
-            echo "  /sw:auto --all-backlog"
-        fi
-    fi
-    exit 0
-fi
-
-# Read session
-SESSION=$(cat "$SESSION_FILE")
-STATUS=$(echo "$SESSION" | jq -r '.status')
-SESSION_ID=$(echo "$SESSION" | jq -r '.sessionId')
-ITERATION=$(echo "$SESSION" | jq -r '.iteration')
-MAX_ITERATIONS=$(echo "$SESSION" | jq -r '.maxIterations')
-CURRENT_INC=$(echo "$SESSION" | jq -r '.currentIncrement // empty')
-START_TIME=$(echo "$SESSION" | jq -r '.startTime')
-SIMPLE=$(echo "$SESSION" | jq -r '.simple // false')
-
-# Calculate duration
-START_EPOCH=$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$START_TIME" "+%s" 2>/dev/null || date -d "$START_TIME" "+%s" 2>/dev/null || echo "0")
-NOW_EPOCH=$(date "+%s")
-DURATION_SECS=$((NOW_EPOCH - START_EPOCH))
-DURATION_MINS=$((DURATION_SECS / 60))
-DURATION_HOURS=$((DURATION_MINS / 60))
-REMAINING_MINS=$((DURATION_MINS % 60))
-
-if [ $DURATION_HOURS -gt 0 ]; then
-    DURATION="${DURATION_HOURS}h ${REMAINING_MINS}m"
-else
-    DURATION="${DURATION_MINS}m"
-fi
-
-# Count increments
-QUEUE_LENGTH=$(echo "$SESSION" | jq '.incrementQueue // [] | length')
-COMPLETED_COUNT=$(echo "$SESSION" | jq '.completedIncrements // [] | length')
-FAILED_COUNT=$(echo "$SESSION" | jq '.failedIncrements // [] | length')
-
-# Get current increment progress
-TASKS_COMPLETED=0
-TASKS_TOTAL=0
-if [ -n "$CURRENT_INC" ]; then
-    INC_DIR="$INCREMENTS_DIR/$CURRENT_INC"
-    if [ ! -d "$INC_DIR" ]; then
-        # Try prefix match
-        INC_DIR=$(find "$INCREMENTS_DIR" -maxdepth 1 -type d -name "${CURRENT_INC}*" | head -1)
-    fi
-
-    if [ -d "$INC_DIR" ]; then
-        TASKS_FILE="$INC_DIR/tasks.md"
-        if [ -f "$TASKS_FILE" ]; then
-            TASKS_TOTAL=$(grep -c "^### T-" "$TASKS_FILE" 2>/dev/null || echo "0")
-            TASKS_COMPLETED=$(grep -c "\*\*Status\*\*: \[x\]" "$TASKS_FILE" 2>/dev/null || echo "0")
-        fi
-    fi
-fi
-
-# Check human gates
-PENDING_GATE=$(echo "$SESSION" | jq -r '.humanGates.pending // empty')
-HAS_PENDING_GATE=false
-if [ -n "$PENDING_GATE" ] && [ "$PENDING_GATE" != "null" ]; then
-    HAS_PENDING_GATE=true
-    GATE_OPERATION=$(echo "$PENDING_GATE" | jq -r '.operation // "unknown"')
-fi
-
-# Check circuit breakers (handle missing field)
-OPEN_BREAKERS=$(echo "$SESSION" | jq 'if .circuitBreakers then [.circuitBreakers | to_entries[] | select(.value.state == "open")] | length else 0 end')
-
-# JSON output
-if [ "$JSON_OUTPUT" = "true" ]; then
-    cat <<EOF
-{
-  "active": $([ "$STATUS" = "running" ] && echo "true" || echo "false"),
-  "sessionId": "$SESSION_ID",
-  "status": "$STATUS",
-  "iteration": $ITERATION,
-  "maxIterations": $MAX_ITERATIONS,
-  "duration": "$DURATION",
-  "currentIncrement": "$CURRENT_INC",
-  "incrementQueue": {
-    "total": $QUEUE_LENGTH,
-    "completed": $COMPLETED_COUNT,
-    "failed": $FAILED_COUNT
-  },
-  "currentProgress": {
-    "tasksCompleted": $TASKS_COMPLETED,
-    "tasksTotal": $TASKS_TOTAL
-  },
-  "humanGatePending": $HAS_PENDING_GATE,
-  "openCircuitBreakers": $OPEN_BREAKERS,
-  "simpleMode": $SIMPLE
-}
-EOF
-    exit 0
-fi
-
-# Simple output
-if [ "$SIMPLE_OUTPUT" = "true" ]; then
-    if [ "$STATUS" = "running" ]; then
-        echo "🤖 Auto: RUNNING"
-        echo "   Iteration: $ITERATION/$MAX_ITERATIONS"
-        echo "   Current: $CURRENT_INC ($TASKS_COMPLETED/$TASKS_TOTAL tasks)"
-    else
-        echo "ℹ️ Auto: $STATUS"
-    fi
-    exit 0
-fi
-
-# Full output
-echo "🤖 Auto Session Status"
-echo ""
-
-# Status indicator
-case $STATUS in
-    running)
-        echo "Status: 🟢 RUNNING"
-        ;;
-    completed)
-        echo "Status: ✅ COMPLETED"
-        ;;
-    cancelled)
-        echo "Status: 🛑 CANCELLED"
-        ;;
-    paused)
-        echo "Status: ⏸️ PAUSED"
-        ;;
-    *)
-        echo "Status: ❓ $STATUS"
-        ;;
-esac
-
-echo ""
-echo "Session ID: $SESSION_ID"
-echo "Duration: $DURATION"
-echo "Iteration: $ITERATION / $MAX_ITERATIONS"
-[ "$SIMPLE" = "true" ] && echo "Mode: Simple"
-echo ""
-
-# Progress bar
-PROGRESS=0
-if [ $MAX_ITERATIONS -gt 0 ]; then
-    PROGRESS=$((ITERATION * 100 / MAX_ITERATIONS))
-fi
-BAR_WIDTH=30
-FILLED=$((PROGRESS * BAR_WIDTH / 100))
-EMPTY=$((BAR_WIDTH - FILLED))
-BAR=$(printf "%${FILLED}s" | tr ' ' '█')$(printf "%${EMPTY}s" | tr ' ' '░')
-echo "Progress: [$BAR] $PROGRESS%"
-echo ""
-
-# Increment queue
-echo "📋 Increment Queue"
-echo "   Total: $QUEUE_LENGTH | Completed: $COMPLETED_COUNT | Failed: $FAILED_COUNT"
-echo ""
-
-# Current increment
-if [ -n "$CURRENT_INC" ]; then
-    echo "📌 Current Increment: $CURRENT_INC"
-    if [ $TASKS_TOTAL -gt 0 ]; then
-        TASK_PROGRESS=$((TASKS_COMPLETED * 100 / TASKS_TOTAL))
-        echo "   Tasks: $TASKS_COMPLETED / $TASKS_TOTAL ($TASK_PROGRESS%)"
-    fi
-    echo ""
-fi
-
-# Warnings
-if [ "$HAS_PENDING_GATE" = "true" ]; then
-    echo "⚠️ HUMAN GATE PENDING"
-    echo "   Operation: $GATE_OPERATION"
-    echo "   Session is waiting for approval"
-    echo "   Approve with: /sw:approve-gate"
-    echo ""
-fi
-
-if [ "$OPEN_BREAKERS" -gt 0 ]; then
-    echo "⚠️ CIRCUIT BREAKERS OPEN: $OPEN_BREAKERS"
-    echo "   Some external services are temporarily unavailable"
-    echo ""
-fi
-
-# Actions
-if [ "$STATUS" = "running" ]; then
-    echo "💡 Actions:"
-    echo "   Cancel: /sw:cancel-auto"
-    echo "   Let it run: Close this tab, work will continue"
-fi