specweave 0.33.4 → 0.33.6

package/plugins/specweave/scripts/README.md

@@ -6,15 +6,15 @@ These scripts provide instant (<100ms) output for status queries that don't requ
 
 ## Why These Exist
 
-Status commands (`/specweave:status`, `/specweave:progress`, `/specweave:jobs`) were taking 3+ minutes because they expanded as prompts requiring LLM processing. These commands need NO reasoning - they just read JSON and format output.
+Status commands (`/sw:status`, `/sw:progress`, `/sw:jobs`) were taking 3+ minutes because they expanded as prompts requiring LLM processing. These commands need NO reasoning - they just read JSON and format output.
 
 **Performance comparison:**
 
 | Command | Before | After |
 |---------|--------|-------|
-| `/specweave:status` | 3+ min | <100ms |
-| `/specweave:progress` | 2+ min | <100ms |
-| `/specweave:jobs` | 3+ min | <100ms |
+| `/sw:status` | 3+ min | <100ms |
+| `/sw:progress` | 2+ min | <100ms |
+| `/sw:jobs` | 3+ min | <100ms |
 
 ## Scripts
 
@@ -59,7 +59,7 @@ These scripts work across all contexts through a layered architecture:
 
 | Layer | Context | Speed | How It Works |
 |-------|---------|-------|--------------|
-| **Hook** | Claude Code | <100ms | `UserPromptSubmit` intercepts `/specweave:*`, runs script, blocks prompt |
+| **Hook** | Claude Code | <100ms | `UserPromptSubmit` intercepts `/sw:*`, runs script, blocks prompt |
 | **Skill** | Any LLM | ~2s | Skill instructs LLM to run script via Bash |
 | **CLI** | Terminal | ~500ms | `specweave status` / direct `node scripts/*.js` |
 
@@ -68,7 +68,7 @@ These scripts work across all contexts through a layered architecture:
 In Claude Code, the `UserPromptSubmit` hook automatically intercepts status commands:
 
 ```
-User types: /specweave:status
+User types: /sw:status
 Hook runs: bash plugins/specweave/scripts/read-status.sh
 Output appears instantly (<10ms)
 LLM never processes the prompt
@@ -79,7 +79,7 @@ LLM never processes the prompt
 In Cursor, Windsurf, Copilot, or API usage, the `instant-status` skill provides instructions:
 
 ```
-User types: /specweave:status
+User types: /sw:status
 Skill activates and instructs LLM to run the script
 LLM executes: bash plugins/specweave/scripts/read-status.sh
 Output appears (~2s)
@@ -103,7 +103,7 @@ bash plugins/specweave/scripts/read-progress.sh 0045
 
 | Situation | Recommended Path |
 |-----------|------------------|
-| Quick status check in Claude Code | Just type `/specweave:status` |
+| Quick status check in Claude Code | Just type `/sw:status` |
 | Using Cursor/Windsurf/Copilot | Let skill guide execution |
 | Terminal/scripting | `specweave status` or `node scripts/*.js` |
 | CI/CD pipelines | Direct `node scripts/*.js` |
@@ -145,7 +145,7 @@ DESCRIPTION
   What this command does...
 
 EXECUTION PATHS
-  1. Claude Code:  /specweave:newcmd  (hook intercepts)
+  1. Claude Code:  /sw:newcmd  (hook intercepts)
   2. Any LLM:      Skill instructs to run this script
   3. Terminal:     specweave newcmd
 `);

package/plugins/specweave/scripts/cleanup-state.sh

@@ -134,7 +134,7 @@ echo "✅ Cleanup complete!"
 echo ""
 echo "Next steps:"
 echo "  1. Restart Claude Code"
-echo "  2. Run /specweave:progress to check status"
+echo "  2. Run /sw:progress to check status"
 echo ""
 echo "If MCP issues persist:"
 echo "  • Update Claude Code VS Code extension"

package/plugins/specweave/scripts/jobs.js

@@ -2,7 +2,7 @@
 /**
  * Instant Background Jobs Status
  *
- * Executed by UserPromptSubmit hook for /specweave:jobs
+ * Executed by UserPromptSubmit hook for /sw:jobs
  * Bypasses LLM entirely - output shown directly to user
  *
  * Usage: node jobs.js [--all] [--id <jobId>] [--help]
@@ -30,7 +30,7 @@ DESCRIPTION
   This script bypasses LLM processing for instant results (<100ms).
 
 EXECUTION PATHS
-  1. Claude Code:  /specweave:jobs  (hook intercepts, <100ms)
+  1. Claude Code:  /sw:jobs  (hook intercepts, <100ms)
   2. Any LLM:      Skill instructs to run this script (~2s)
   3. Terminal:     specweave jobs (~500ms)
 

package/plugins/specweave/scripts/progress.js

@@ -2,7 +2,7 @@
 /**
  * Instant Increment Progress
  *
- * Executed by UserPromptSubmit hook for /specweave:progress
+ * Executed by UserPromptSubmit hook for /sw:progress
  * Bypasses LLM entirely - output shown directly to user
  *
  * Usage: node progress.js [incrementId] [--help]
@@ -29,7 +29,7 @@ DESCRIPTION
   This script bypasses LLM processing for instant results (<100ms).
 
 EXECUTION PATHS
-  1. Claude Code:  /specweave:progress  (hook intercepts, <100ms)
+  1. Claude Code:  /sw:progress  (hook intercepts, <100ms)
   2. Any LLM:      Skill instructs to run this script (~2s)
   3. Terminal:     specweave status --verbose (~500ms)
 
@@ -131,7 +131,7 @@ if (readyForReview.length > 0) {
     const bar = createProgressBar(inc.percentage, 15);
     console.log(`  ${inc.id}`);
     console.log(`     ${bar} ${inc.completedTasks}/${inc.totalTasks} (${inc.percentage}%)`);
-    console.log(`     → /specweave:done ${inc.id}`);
+    console.log(`     → /sw:done ${inc.id}`);
   }
   console.log('');
 }
@@ -165,9 +165,9 @@ if (readyForReview.length > 0 || active.length > 0 || paused.length > 0) {
   console.log('');
 
   if (readyForReview.length > 0) {
-    console.log('💡 Run /specweave:done <id> to close reviewed increments');
+    console.log('💡 Run /sw:done <id> to close reviewed increments');
   } else {
-    console.log('💡 For details: /specweave:progress <incrementId>');
+    console.log('💡 For details: /sw:progress <incrementId>');
   }
 } else {
   console.log('No active increments.');
@@ -176,7 +176,7 @@ if (readyForReview.length > 0 || active.length > 0 || paused.length > 0) {
     console.log(`${completed.length} completed increment(s).`);
   }
   console.log('');
-  console.log('💡 Run /specweave:increment to start new work');
+  console.log('💡 Run /sw:increment to start new work');
 }
 
 // Helpers

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# read-costs.sh - Pure bash reader for /specweave:costs
+# read-costs.sh - Pure bash reader for /sw:costs
 #
 # Shows cost/token tracking dashboard.
 # Reads from pre-computed dashboard cache for <10ms response time.
@@ -128,5 +128,5 @@ jq -r '.costs.byIncrement | to_entries | sort_by(-.value.cost) | .[0:5][] |
 echo ""
 
 echo "💡 Commands:"
-echo "   /specweave:costs <id>     View increment costs"
-echo "   /specweave:progress       View task progress"
+echo "   /sw:costs <id>     View increment costs"
+echo "   /sw:progress       View task progress"

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# read-jobs.sh - Pure bash reader for /specweave:jobs
+# 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.
@@ -185,7 +185,7 @@ if [[ -f "$CACHE_FILE" ]] && jq -e '.' "$CACHE_FILE" >/dev/null 2>&1; then
 else
   echo ""
   echo "   No increment data available (cache not found)."
-  echo "   Run /specweave:status to rebuild cache."
+  echo "   Run /sw:status to rebuild cache."
 fi
 
 echo ""
@@ -215,7 +215,7 @@ if [[ "$HAS_JOBS" == "false" ]]; then
   echo "   • Brownfield analysis (documentation gap detection)"
   echo ""
   echo "   Start jobs with:"
-  echo "   • /specweave:import-external  - Import from external tools"
+  echo "   • /sw:import-external  - Import from external tools"
   echo "   • specweave init              - May spawn background jobs"
 else
   echo ""
@@ -316,9 +316,9 @@ echo ""
 echo "────────────────────────────────────────"
 echo ""
 echo "💡 Commands:"
-echo "   /specweave:do               Execute current tasks"
-echo "   /specweave:progress         Show task progress details"
-echo "   /specweave:done <id>        Close increment"
-echo "   /specweave:jobs --id <id>   View background job details"
-echo "   /specweave:jobs --all       Show completed jobs"
+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 ""

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# read-progress.sh - Pure bash reader for /specweave:progress
+# read-progress.sh - Pure bash reader for /sw:progress
 #
 # Reads from pre-computed dashboard cache for <10ms response time.
 # Falls back to Node.js script if jq is not available.
@@ -73,7 +73,7 @@ progress_bar() {
 format_status() {
   case "$1" in
     active) echo "🔄 active" ;;
-    planning) echo "📝 planning" ;;
+    planning|planned) echo "📝 planning" ;;
     paused) echo "⏸️ paused" ;;
     completed) echo "✅ completed" ;;
     abandoned) echo "❌ abandoned" ;;
@@ -147,22 +147,23 @@ if [[ -n "$READY_FOR_REVIEW" ]]; then
     bar=$(progress_bar "$pct" 15)
     echo "  $id"
     echo "     $bar $completed/$total ($pct%)"
-    echo "     → /specweave:done $id"
+    echo "     → /sw:done $id"
   done <<< "$READY_FOR_REVIEW"
   echo ""
 fi
 
 # Get active increments (excluding ready_for_review)
+# Note: "planned" is a legacy typo for "planning" - support both for backwards compatibility
 ACTIVE=$(jq -r '
   .increments | to_entries[] |
-  select(.value.status == "active" or .value.status == "planning" or .value.status == "backlog") |
-  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)"
+  select(.value.status == "active" or .value.status == "planning" or .value.status == "planned" or .value.status == "backlog") |
+  "\(.key)|\(.value.tasks.completed)|\(.value.tasks.total)|\(.value.status)"
 ' "$CACHE_FILE" 2>/dev/null)
 
 ACTIVE_COUNT=0
 if [[ -n "$ACTIVE" ]]; then
   echo "🔄 Active:"
-  while IFS='|' read -r id completed total; do
+  while IFS='|' read -r id completed total inc_status; do
     [[ -z "$id" ]] && continue
     ACTIVE_COUNT=$((ACTIVE_COUNT + 1))
     if [[ "$total" -gt 0 ]]; then
@@ -171,7 +172,13 @@ if [[ -n "$ACTIVE" ]]; then
       pct=0
     fi
     bar=$(progress_bar "$pct" 15)
-    echo "  $id"
+    # Show status indicator if not "active"
+    status_indicator=""
+    case "$inc_status" in
+      planning|planned) status_indicator=" (📝 planning)" ;;
+      backlog) status_indicator=" (📋 backlog)" ;;
+    esac
+    echo "  $id$status_indicator"
     echo "     $bar $completed/$total ($pct%)"
   done <<< "$ACTIVE"
   echo ""
@@ -222,9 +229,9 @@ fi
 
 echo ""
 if [[ "$REVIEW_COUNT" -gt 0 ]]; then
-  echo "💡 Run /specweave:done <id> to close reviewed increments"
+  echo "💡 Run /sw:done <id> to close reviewed increments"
 elif [[ "$ACTIVE_COUNT" -eq 0 ]]; then
-  echo "💡 Run /specweave:increment to start new work"
+  echo "💡 Run /sw:increment to start new work"
 else
-  echo "💡 For details: /specweave:progress <incrementId>"
+  echo "💡 For details: /sw:progress <incrementId>"
 fi

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# read-status.sh - Pure bash reader for /specweave:status
+# read-status.sh - Pure bash reader for /sw:status
 #
 # Reads from pre-computed dashboard cache for <10ms response time.
 # Falls back to Node.js script if jq is not available.
@@ -58,14 +58,14 @@ echo "📋 SpecWeave Status Overview"
 echo ""
 
 # Status display order and icons
+# Note: "planned" is a legacy typo for "planning" - both are handled
 declare -a STATUS_ORDER
-STATUS_ORDER=("active" "planning" "in-progress" "ready_for_review" "paused" "backlog" "completed" "abandoned")
+STATUS_ORDER=("active" "planning" "planned" "ready_for_review" "paused" "backlog" "completed" "abandoned")
 
 status_icon() {
   case "$1" in
     active) echo "🔄" ;;
-    planning) echo "📝" ;;
-    in-progress) echo "⚙️" ;;
+    planning|planned) echo "📝" ;;
     ready_for_review) echo "👀" ;;
     paused) echo "⏸️" ;;
     backlog) echo "📋" ;;
@@ -141,6 +141,6 @@ fi
 
 echo ""
 echo "💡 Commands:"
-echo "   /specweave:progress        Show task progress"
-echo "   /specweave:do              Execute current tasks"
-echo "   /specweave:done <id>       Close increment"
+echo "   /sw:progress        Show task progress"
+echo "   /sw:do              Execute current tasks"
+echo "   /sw:done <id>       Close increment"

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# read-workflow.sh - Pure bash reader for /specweave:workflow
+# read-workflow.sh - Pure bash reader for /sw:workflow
 #
 # Shows current phase, suggests next actions based on increment state.
 # Reads from pre-computed dashboard cache for <10ms response time.
@@ -79,13 +79,13 @@ if [[ -z "$ACTIVE_ID" ]]; then
   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 "   Resume with: /sw:resume <id>"
     echo ""
   fi
 
   echo "💡 Suggestions:"
-  echo "   • /specweave:increment \"feature name\"  - Plan new work"
-  echo "   • /specweave:status                     - View all increments"
+  echo "   • /sw:increment \"feature name\"  - Plan new work"
+  echo "   • /sw:status                     - View all increments"
   exit 0
 fi
 
@@ -117,37 +117,37 @@ SUGGESTIONS=""
 
 if [[ "$STATUS" == "backlog" ]] || [[ "$STATUS" == "planned" ]]; then
   PHASE="📝 Planning"
-  SUGGESTIONS="• /specweave:do     - Start implementation
-• /specweave:plan   - Generate plan.md and tasks.md"
+  SUGGESTIONS="• /sw:do     - Start implementation
+• /sw: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"
+  SUGGESTIONS="• /sw:do     - Execute first task
+• /sw: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"
+  SUGGESTIONS="• /sw:do         - Continue implementation
+• /sw: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"
+  SUGGESTIONS="• /sw:do         - Complete remaining tasks
+• /sw:validate   - Early quality check"
 
 elif [[ "$STATUS" == "ready_for_review" ]]; then
   PHASE="👀 Review"
-  SUGGESTIONS="• /specweave:validate   - Full validation
-• /specweave:done       - Close increment (PM approval)"
+  SUGGESTIONS="• /sw:validate   - Full validation
+• /sw: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"
+  SUGGESTIONS="• /sw:validate   - Run quality checks
+• /sw:done       - Close increment"
 
 else
   PHASE="❓ Unknown"
-  SUGGESTIONS="• /specweave:status     - Check status"
+  SUGGESTIONS="• /sw:status     - Check status"
 fi
 
 # Display
@@ -168,6 +168,6 @@ 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 "ℹ️  $PAUSED_COUNT paused increment(s) - /sw:resume to continue"
   echo ""
 fi

package/plugins/specweave/scripts/rebuild-dashboard-cache.sh

@@ -47,7 +47,7 @@ log "🔄 Rebuilding dashboard cache..."
 
 # Initialize counters using simple variables (bash 3.x compatible)
 status_backlog=0
-status_planned=0
+status_planning=0
 status_active=0
 status_paused=0
 status_ready_for_review=0
@@ -197,9 +197,10 @@ for increment_dir in "$INCREMENTS_DIR"/[0-9]*/; do
     '.[$id] = { metadata: $meta, tasks: $tasks, spec: $spec }')
 
   # Update status counters (bash 3.x compatible)
+  # Note: "planned" is a legacy typo for "planning" - both map to planning counter
   case "$status" in
     backlog) status_backlog=$((status_backlog + 1)) ;;
-    planned) status_planned=$((status_planned + 1)) ;;
+    planning|planned) status_planning=$((status_planning + 1)) ;;
     active) status_active=$((status_active + 1)) ;;
     paused) status_paused=$((status_paused + 1)) ;;
     ready_for_review) status_ready_for_review=$((status_ready_for_review + 1)) ;;
@@ -266,7 +267,7 @@ cache_json=$(jq -n \
   --argjson active "$status_active" \
   --argjson paused "$status_paused" \
   --argjson backlog "$status_backlog" \
-  --argjson planned "$status_planned" \
+  --argjson planning "$status_planning" \
   --argjson ready_for_review "$status_ready_for_review" \
   --argjson completed "$status_completed" \
   --argjson abandoned "$status_abandoned" \
@@ -293,7 +294,7 @@ cache_json=$(jq -n \
       active: $active,
       paused: $paused,
       backlog: $backlog,
-      planned: $planned,
+      planning: $planning,
       ready_for_review: $ready_for_review,
       completed: $completed,
       abandoned: $abandoned,
@@ -323,5 +324,5 @@ echo "$cache_json" > "$TEMP_FILE"
 mv "$TEMP_FILE" "$CACHE_FILE"
 
 log "✅ Dashboard cache rebuilt"
-log "   📊 $total_count increments | $status_active active | $status_completed completed"
+log "   📊 $total_count increments | $status_active active | $status_planning planning | $status_completed completed"
 log "   📁 Cache: $CACHE_FILE"

package/plugins/specweave/scripts/session-watchdog.sh

@@ -6,7 +6,7 @@
 # - ELIMINATED FALSE POSITIVES: No longer triggers on stale files alone
 # - SMART DETECTION: Verifies actual stuck processes, not just file ages
 # - SEVERITY LEVELS: Only CRITICAL issues trigger notifications
-# - DIAGNOSTICS: Writes detailed logs for /specweave:jobs to display
+# - DIAGNOSTICS: Writes detailed logs for /sw:jobs to display
 #
 # Usage: bash session-watchdog.sh [--daemon] [--interval=60] [--threshold=300]
 
@@ -77,15 +77,21 @@ send_notification() {
     return
   fi
 
-  # macOS notification
+  # macOS notification - use "Submarine" for warnings (not alarming like "Basso")
+  # Per CLAUDE.md section 11: Basso = ONLY critical errors requiring IMMEDIATE action
+  # Zombie detection is recoverable - user can run cleanup script when convenient
   if command -v osascript &> /dev/null; then
-    osascript -e "display notification \"$message\" with title \"$title\" sound name \"Basso\""
+    osascript -e "display notification \"$message\" with title \"$title\" sound name \"Submarine\""
   fi
 
-  # Linux notification (if available)
+  # Linux notification (if available) - use "normal" urgency (not "critical")
+  # Critical urgency can bypass Do Not Disturb, which is too aggressive
   if command -v notify-send &> /dev/null; then
-    notify-send "$title" "$message" --urgency=critical
+    notify-send "$title" "$message" --urgency=normal
   fi
+
+  # Windows: notifications sent via PowerShell toast don't have urgency levels
+  # They're always non-alarming by design
 }
 
 get_file_age_seconds() {
@@ -251,7 +257,7 @@ check_orphaned_jobs() {
   fi
 
   if [[ "$orphaned_count" -gt 0 ]]; then
-    result_message="$orphaned_count orphaned job(s) found (run /specweave:jobs to see details)"
+    result_message="$orphaned_count orphaned job(s) found (run /sw:jobs to see details)"
   fi
 
   echo "orphaned_jobs=$orphaned_count" >> "$DIAGNOSTICS_FILE.tmp"
@@ -260,7 +266,7 @@ check_orphaned_jobs() {
   return $result_severity
 }
 
-# Write diagnostics file for /specweave:jobs to read
+# Write diagnostics file for /sw:jobs to read
 write_diagnostics() {
   local overall_severity="$1"
   local overall_status="$2"
@@ -345,7 +351,7 @@ check_session_health() {
     CONSECUTIVE_WARNINGS=0  # Reset on healthy check
   fi
 
-  # Write diagnostics for /specweave:jobs
+  # Write diagnostics for /sw:jobs
   write_diagnostics "$max_severity" "$overall_status"
 
   # Only alert if CRITICAL and seen multiple consecutive times

package/plugins/specweave/scripts/status.js

@@ -2,7 +2,7 @@
 /**
  * Instant Increment Status Overview
  *
- * Executed by UserPromptSubmit hook for /specweave:status
+ * Executed by UserPromptSubmit hook for /sw:status
  * Bypasses LLM entirely - output shown directly to user
  *
  * Usage: node status.js [--help]
@@ -28,7 +28,7 @@ DESCRIPTION
   This script bypasses LLM processing for instant results (<100ms).
 
 EXECUTION PATHS
-  1. Claude Code:  /specweave:status  (hook intercepts, <100ms)
+  1. Claude Code:  /sw:status  (hook intercepts, <100ms)
   2. Any LLM:      Skill instructs to run this script (~2s)
   3. Terminal:     specweave status (~500ms)
 
@@ -113,7 +113,7 @@ for (const status of statusOrder) {
       console.log(`   ${item}`);
       // Add action hint for ready_for_review
       if (status === 'ready_for_review') {
-        console.log(`      → /specweave:done ${item}`);
+        console.log(`      → /sw:done ${item}`);
       }
     }
     if (items.length > 5) {
@@ -161,11 +161,11 @@ console.log('');
 
 // Context-aware command hints
 if (reviewCount > 0) {
-  console.log('💡 Next step: /specweave:done <id> to close reviewed increment(s)');
+  console.log('💡 Next step: /sw:done <id> to close reviewed increment(s)');
 } else if (activeCount > 0) {
   console.log('💡 Commands:');
-  console.log('   /specweave:progress        Show task progress');
-  console.log('   /specweave:do              Execute current tasks');
+  console.log('   /sw:progress        Show task progress');
+  console.log('   /sw:do              Execute current tasks');
 } else {
-  console.log('💡 Run /specweave:increment to start new work');
+  console.log('💡 Run /sw:increment to start new work');
 }

package/plugins/specweave/scripts/update-dashboard-cache.sh

@@ -83,6 +83,15 @@ for dir in "$INCREMENTS_DIR"/*"$INCREMENT_ID"*/; do
   fi
 done
 
+# Helper to normalize status for counter keys (planned → planning)
+# Defined early so it can be used in removal section
+normalize_status_key() {
+  case "$1" in
+    planned) echo "planning" ;;  # Legacy typo - map to planning counter
+    *) echo "$1" ;;
+  esac
+}
+
 if [[ -z "$INCREMENT_DIR" ]] || [[ ! -d "$INCREMENT_DIR" ]]; then
   # Increment might have been archived or deleted
   # Remove from cache if it exists
@@ -90,18 +99,19 @@ if [[ -z "$INCREMENT_DIR" ]] || [[ ! -d "$INCREMENT_DIR" ]]; then
   if jq -e --arg id "$INCREMENT_ID" '.increments[$id]' "$CACHE_FILE" >/dev/null 2>&1; then
     # Get old status for counter updates
     old_status=$(jq -r --arg id "$INCREMENT_ID" '.increments[$id].status // "backlog"' "$CACHE_FILE")
+    old_status_key=$(normalize_status_key "$old_status")
     old_type=$(jq -r --arg id "$INCREMENT_ID" '.increments[$id].type // "feature"' "$CACHE_FILE")
     old_priority=$(jq -r --arg id "$INCREMENT_ID" '.increments[$id].priority // "P1"' "$CACHE_FILE")
 
-    # Remove increment and update counters
+    # Remove increment and update counters (use normalized status key)
     jq --arg id "$INCREMENT_ID" \
-       --arg old_status "$old_status" \
+       --arg old_status_key "$old_status_key" \
        --arg old_type "$old_type" \
        --arg old_priority "$old_priority" '
       del(.increments[$id]) |
       del(.mtimes[$id]) |
       .summary.total -= 1 |
-      .summary[$old_status] -= 1 |
+      .summary[$old_status_key] -= 1 |
       .summary.byType[$old_type] -= 1 |
       .summary.byPriority[$old_priority] -= 1 |
       .updatedAt = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))
@@ -122,6 +132,10 @@ fi
 
 # Read current values
 status=$(jq -r '.status // "backlog"' "$metadata_file" 2>/dev/null)
+# Normalize status for counter keys (planned → planning for backwards compatibility)
+# The raw status is preserved in increment data, but counters use normalized key
+status_key=$(normalize_status_key "$status")
+
 type=$(jq -r '.type // "feature"' "$metadata_file" 2>/dev/null)
 priority=$(jq -r '.priority // "P1"' "$metadata_file" 2>/dev/null)
 title=$(jq -r '.title // ""' "$metadata_file" 2>/dev/null)
@@ -232,36 +246,40 @@ mtime_json=$(jq -n \
 # Apply incremental update
 if [[ "$is_new" == "true" ]]; then
   # New increment - add to cache and increment counters
+  # Note: Use status_key for counter updates (normalizes planned → planning)
   jq --arg id "$INCREMENT_ID" \
      --argjson inc "$increment_json" \
      --argjson mtime "$mtime_json" \
-     --arg status "$status" \
+     --arg status_key "$status_key" \
      --arg type "$type" \
      --arg priority "$priority" '
     .increments[$id] = $inc |
     .mtimes[$id] = $mtime |
     .summary.total += 1 |
-    .summary[$status] += 1 |
+    .summary[$status_key] += 1 |
     .summary.byType[$type] += 1 |
     .summary.byPriority[$priority] += 1 |
     .updatedAt = (now | strftime("%Y-%m-%dT%H:%M:%SZ"))
   ' "$CACHE_FILE" > "$TEMP_FILE"
 else
   # Existing increment - update and adjust counters if status/type/priority changed
+  # Normalize old_status for counter lookup (planned → planning)
+  old_status_key=$(normalize_status_key "$old_status")
+
   jq --arg id "$INCREMENT_ID" \
      --argjson inc "$increment_json" \
      --argjson mtime "$mtime_json" \
-     --arg old_status "$old_status" \
-     --arg new_status "$status" \
+     --arg old_status_key "$old_status_key" \
+     --arg new_status_key "$status_key" \
      --arg old_type "$old_type" \
      --arg new_type "$type" \
      --arg old_priority "$old_priority" \
      --arg new_priority "$priority" '
     .increments[$id] = $inc |
     .mtimes[$id] = $mtime |
-    (if $old_status != $new_status then
-      .summary[$old_status] -= 1 |
-      .summary[$new_status] += 1
+    (if $old_status_key != $new_status_key then
+      .summary[$old_status_key] -= 1 |
+      .summary[$new_status_key] += 1
     else . end) |
     (if $old_type != $new_type then
       .summary.byType[$old_type] -= 1 |