specweave 0.33.4 → 0.33.6

package/plugins/specweave/hooks/v2/guards/per-us-project-validator.test.sh

@@ -0,0 +1,406 @@
+#!/bin/bash
+# Comprehensive test suite for per-us-project-validator.sh
+# Tests that each User Story in spec.md has **Project**: (and **Board**: for 2-level)
+#
+# Usage: bash per-us-project-validator.test.sh
+#
+# v0.34.0 - Initial test suite with all US formats
+
+set -e
+
+GUARD="$(dirname "$0")/per-us-project-validator.sh"
+TEST_DIR=$(mktemp -d)
+PASS=0
+FAIL=0
+TOTAL=0
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+cleanup() {
+  rm -rf "$TEST_DIR"
+}
+trap cleanup EXIT
+
+# Test helper: should block
+test_should_block() {
+  local name="$1"
+  local spec_content="$2"
+  TOTAL=$((TOTAL + 1))
+
+  local file_path="$TEST_DIR/.specweave/increments/0001-test/spec.md"
+  mkdir -p "$(dirname "$file_path")"
+
+  # Build JSON input for the guard
+  # Use printf + jq -Rs to properly escape newlines in the content
+  local json_input
+  json_input=$(printf '%s' "$spec_content" | jq -Rs \
+    --arg tool_name "Write" \
+    --arg file_path "$file_path" \
+    '{tool_name: $tool_name, tool_input: {file_path: $file_path, content: .}}')
+
+  result=$(echo "$json_input" | bash "$GUARD" 2>&1; echo "EXIT:$?")
+  exit_code=$(echo "$result" | grep -o 'EXIT:[0-9]*' | cut -d: -f2)
+
+  if [[ "$exit_code" == "0" ]] && echo "$result" | grep -q '"decision".*"block"'; then
+    echo -e "${GREEN}✓ BLOCKED${NC}: $name"
+    PASS=$((PASS + 1))
+  else
+    echo -e "${RED}✗ NOT BLOCKED${NC}: $name"
+    echo "  Exit code: $exit_code"
+    echo "  Result: $(echo "$result" | head -3)"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# Test helper: should allow
+test_should_allow() {
+  local name="$1"
+  local spec_content="$2"
+  TOTAL=$((TOTAL + 1))
+
+  local file_path="$TEST_DIR/.specweave/increments/0001-test/spec.md"
+  mkdir -p "$(dirname "$file_path")"
+
+  # Build JSON input for the guard
+  # Use printf + jq -Rs to properly escape newlines in the content
+  local json_input
+  json_input=$(printf '%s' "$spec_content" | jq -Rs \
+    --arg tool_name "Write" \
+    --arg file_path "$file_path" \
+    '{tool_name: $tool_name, tool_input: {file_path: $file_path, content: .}}')
+
+  result=$(echo "$json_input" | bash "$GUARD" 2>&1; echo "EXIT:$?")
+  exit_code=$(echo "$result" | grep -o 'EXIT:[0-9]*' | cut -d: -f2)
+
+  if [[ "$exit_code" == "0" ]] && echo "$result" | grep -q '"decision".*"allow"'; then
+    echo -e "${GREEN}✓ ALLOWED${NC}: $name"
+    PASS=$((PASS + 1))
+  else
+    echo -e "${RED}✗ WRONGLY BLOCKED${NC}: $name"
+    echo "  Exit code: $exit_code"
+    echo "  Result: $(echo "$result" | head -5)"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+echo "========================================"
+echo "  PER-US PROJECT VALIDATOR - COMPREHENSIVE TESTS"
+echo "========================================"
+echo ""
+echo "Test directory: $TEST_DIR"
+echo ""
+
+echo -e "${YELLOW}=== SIMPLE US FORMAT (### US-001:) ===${NC}"
+
+test_should_allow "Simple US with Project field" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-001: Login Form
+**Project**: frontend-app
+
+**As a** user
+**I want** to log in
+**So that** I can access the app
+
+**Acceptance Criteria**:
+- [ ] **AC-US1-01**: Form exists
+'
+
+test_should_block "Simple US WITHOUT Project field" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-001: Login Form
+
+**As a** user
+**I want** to log in
+**So that** I can access the app
+'
+
+echo ""
+echo -e "${YELLOW}=== MULTI-PROJECT US FORMAT (#### US-FE-001:) ===${NC}"
+
+test_should_allow "Multi-project US-FE-001 with Project field" '---
+increment: 0001-test
+project: my-app
+multi_project: true
+---
+# Feature
+
+#### US-FE-001: Login Form UI
+**Project**: frontend-app
+
+**As a** user
+**I want** to see a login form
+
+#### US-BE-001: Auth API
+**Project**: backend-api
+
+**As a** frontend
+**I want** auth endpoints
+'
+
+test_should_block "Multi-project US-FE-001 WITHOUT Project field" '---
+increment: 0001-test
+project: my-app
+multi_project: true
+---
+# Feature
+
+#### US-FE-001: Login Form UI
+
+**As a** user
+**I want** to see a login form
+'
+
+echo ""
+echo -e "${YELLOW}=== MIXED FORMAT (### with prefixes) ===${NC}"
+
+test_should_allow "Mixed: ### US-FE-001 with Project" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-FE-001: Frontend Story
+**Project**: frontend
+
+### US-BE-001: Backend Story
+**Project**: backend
+'
+
+test_should_block "Mixed: ### US-FE-001 without Project" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-FE-001: Frontend Story
+
+### US-BE-001: Backend Story
+**Project**: backend
+'
+
+echo ""
+echo -e "${YELLOW}=== SHARED PROJECT PREFIX ===${NC}"
+
+test_should_allow "US-SHARED-001 with Project" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+#### US-SHARED-001: Shared Types
+**Project**: shared-lib
+
+**As a** developer
+**I want** shared types
+'
+
+test_should_block "US-SHARED-001 without Project" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+#### US-SHARED-001: Shared Types
+
+**As a** developer
+**I want** shared types
+'
+
+echo ""
+echo -e "${YELLOW}=== MULTIPLE PROJECTS (1:1 VIOLATION - COMMA SEPARATED) ===${NC}"
+
+test_should_block "Multiple projects (comma separated) - FORBIDDEN" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-001: Cross-cutting Story
+**Project**: frontend-app, backend-api
+
+**As a** user
+**I want** everything
+'
+
+test_should_block "Multiple projects with spaces" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-001: Cross-cutting Story
+**Project**: frontend-app,backend-api,shared
+
+**As a** user
+**I want** everything
+'
+
+echo ""
+echo -e "${YELLOW}=== NO USER STORIES (should allow) ===${NC}"
+
+test_should_allow "Spec without any User Stories" '---
+increment: 0001-test
+project: my-app
+---
+# Feature Overview
+
+This is just an overview document.
+
+## Goals
+
+- Goal 1
+- Goal 2
+'
+
+test_should_allow "Tasks-only spec (no US headings)" '---
+increment: 0001-test
+project: my-app
+---
+# Implementation Tasks
+
+## T-001: Setup
+
+Do setup stuff.
+'
+
+echo ""
+echo -e "${YELLOW}=== ALL USER STORIES HAVE PROJECT ===${NC}"
+
+test_should_allow "Multiple US, all with Project" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-001: First Story
+**Project**: app-a
+
+### US-002: Second Story
+**Project**: app-b
+
+### US-003: Third Story
+**Project**: app-c
+'
+
+test_should_block "Multiple US, one missing Project" '---
+increment: 0001-test
+project: my-app
+---
+# Feature
+
+### US-001: First Story
+**Project**: app-a
+
+### US-002: Second Story
+
+### US-003: Third Story
+**Project**: app-c
+'
+
+echo ""
+echo -e "${YELLOW}=== NON-WRITE TOOLS ===${NC}"
+
+# Test with Edit tool (should allow - no full content)
+TOTAL=$((TOTAL + 1))
+json_input=$(jq -n \
+  --arg tool_name "Edit" \
+  --arg file_path "$TEST_DIR/.specweave/increments/0001-test/spec.md" \
+  '{tool_name: $tool_name, tool_input: {file_path: $file_path}}')
+
+result=$(echo "$json_input" | bash "$GUARD" 2>&1; echo "EXIT:$?")
+exit_code=$(echo "$result" | grep -o 'EXIT:[0-9]*' | cut -d: -f2)
+if [[ "$exit_code" == "0" ]]; then
+  echo -e "${GREEN}✓ ALLOWED${NC}: Edit tool (no full content validation)"
+  PASS=$((PASS + 1))
+else
+  echo -e "${RED}✗ FAILED${NC}: Edit tool should be allowed"
+  FAIL=$((FAIL + 1))
+fi
+
+echo ""
+echo -e "${YELLOW}=== BYPASS MODES ===${NC}"
+
+# Test SPECWEAVE_FORCE_PROJECT bypass
+TOTAL=$((TOTAL + 1))
+spec_content='---
+increment: 0001-test
+---
+### US-001: No Project
+**As a** user
+**I want** something
+'
+json_input=$(jq -n \
+  --arg tool_name "Write" \
+  --arg file_path "$TEST_DIR/.specweave/increments/0001-test/spec.md" \
+  --arg content "$spec_content" \
+  '{tool_name: $tool_name, tool_input: {file_path: $file_path, content: $content}}')
+
+result=$(SPECWEAVE_FORCE_PROJECT=1 bash -c "echo '$json_input' | bash '$GUARD'" 2>&1; echo "EXIT:$?")
+exit_code=$(echo "$result" | grep -o 'EXIT:[0-9]*' | cut -d: -f2)
+if [[ "$exit_code" == "0" ]] && echo "$result" | grep -q "bypassed"; then
+  echo -e "${GREEN}✓ ALLOWED (bypass)${NC}: SPECWEAVE_FORCE_PROJECT=1"
+  PASS=$((PASS + 1))
+else
+  echo -e "${RED}✗ BYPASS FAILED${NC}: SPECWEAVE_FORCE_PROJECT=1"
+  FAIL=$((FAIL + 1))
+fi
+
+# Test SPECWEAVE_LEGACY_SPEC bypass
+TOTAL=$((TOTAL + 1))
+result=$(SPECWEAVE_LEGACY_SPEC=1 bash -c "echo '$json_input' | bash '$GUARD'" 2>&1; echo "EXIT:$?")
+exit_code=$(echo "$result" | grep -o 'EXIT:[0-9]*' | cut -d: -f2)
+if [[ "$exit_code" == "0" ]] && echo "$result" | grep -q "legacy"; then
+  echo -e "${GREEN}✓ ALLOWED (bypass)${NC}: SPECWEAVE_LEGACY_SPEC=1"
+  PASS=$((PASS + 1))
+else
+  echo -e "${RED}✗ BYPASS FAILED${NC}: SPECWEAVE_LEGACY_SPEC=1"
+  FAIL=$((FAIL + 1))
+fi
+
+echo ""
+echo -e "${YELLOW}=== FILES OUTSIDE INCREMENTS ===${NC}"
+
+# Test file outside increments folder
+TOTAL=$((TOTAL + 1))
+json_input=$(jq -n \
+  --arg tool_name "Write" \
+  --arg file_path "$TEST_DIR/other/spec.md" \
+  --arg content "no project" \
+  '{tool_name: $tool_name, tool_input: {file_path: $file_path, content: $content}}')
+
+result=$(echo "$json_input" | bash "$GUARD" 2>&1; echo "EXIT:$?")
+exit_code=$(echo "$result" | grep -o 'EXIT:[0-9]*' | cut -d: -f2)
+if [[ "$exit_code" == "0" ]] && echo "$result" | grep -q '"decision".*"allow"'; then
+  echo -e "${GREEN}✓ ALLOWED${NC}: spec.md outside increments folder"
+  PASS=$((PASS + 1))
+else
+  echo -e "${RED}✗ FAILED${NC}: Files outside increments should be allowed"
+  FAIL=$((FAIL + 1))
+fi
+
+echo ""
+echo "========================================"
+echo "  RESULTS"
+echo "========================================"
+echo -e "Total: $TOTAL"
+echo -e "${GREEN}Passed: $PASS${NC}"
+if [[ $FAIL -gt 0 ]]; then
+  echo -e "${RED}Failed: $FAIL${NC}"
+  exit 1
+else
+  echo -e "Failed: 0"
+  echo ""
+  echo -e "${GREEN}ALL TESTS PASSED!${NC}"
+fi

package/plugins/specweave/hooks/v2/handlers/github-sync-handler.sh

@@ -38,7 +38,7 @@ if [[ -f "$THROTTLE_FILE" ]]; then
   fi
   if [[ $AGE -lt $THROTTLE_WINDOW ]]; then
     REMAINING=$((THROTTLE_WINDOW - AGE))
-    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [github-sync] THROTTLED $INC_ID (wait ${REMAINING}s, use /specweave:sync-progress to bypass)" >> "$THROTTLE_LOG" 2>/dev/null
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] [github-sync] THROTTLED $INC_ID (wait ${REMAINING}s, use /sw:sync-progress to bypass)" >> "$THROTTLE_LOG" 2>/dev/null
     exit 0
   fi
 fi

package/plugins/specweave/lib/hooks/consolidated-sync.js

@@ -50,6 +50,9 @@ import { consoleLogger } from '../vendor/utils/logger.js';
 // Import US completion orchestrator (NEW in v0.25.0+)
 import { syncCompletedUserStories } from './us-completion-orchestrator.js';
 
+// Import auto-transition (NEW in v0.35.0+ - CRITICAL for preventing auto-completion bug)
+import { checkAndTransitionToReadyForReview } from '../vendor/core/increment/status-auto-transition.js';
+
 // ============================================================================
 // WRAPPER: UPDATE AC STATUS
 // ============================================================================
@@ -57,7 +60,7 @@ import { syncCompletedUserStories } from './us-completion-orchestrator.js';
 // So we replicate the core logic here using ACStatusManager
 async function updateACStatus(incrementId) {
   try {
-    console.log(`\n🔄 [3/5] Syncing AC status for increment ${incrementId}...`);
+    console.log(`\n🔄 [3/6] Syncing AC status for increment ${incrementId}...`);
 
     const projectRoot = process.cwd();
 
@@ -100,7 +103,7 @@ async function updateACStatus(incrementId) {
 // ============================================================================
 async function syncGitHub(incrementId) {
   try {
-    console.log(`\n🔗 [5/5] Syncing to GitHub...`);
+    console.log(`\n🔗 [5/6] Syncing to GitHub...`);
 
     const projectRoot = process.cwd();
 
@@ -137,8 +140,35 @@ async function runConsolidatedSync(incrementId) {
   const results = {};
 
   try {
+    // OPERATION 0 (v0.35.0+ - CRITICAL): Check for ACTIVE → READY_FOR_REVIEW transition
+    // This MUST run FIRST to prevent the auto-completion bug!
+    // When all tasks are done, increment transitions to READY_FOR_REVIEW (not COMPLETED).
+    // Only /sw:done can then transition to COMPLETED with user approval.
+    console.log('\n📋 [0/6] Checking for status auto-transition...');
+    try {
+      const transitionResult = checkAndTransitionToReadyForReview(incrementId);
+      if (transitionResult.transitioned) {
+        console.log(`\n🎉 ${transitionResult.message}`);
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log('📋 INCREMENT READY FOR REVIEW');
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+        console.log(`   Status: ACTIVE → READY_FOR_REVIEW`);
+        console.log(`   Tasks: ${transitionResult.taskStatus?.completedTasks}/${transitionResult.taskStatus?.totalTasks} completed`);
+        console.log('');
+        console.log('   To close this increment, run:');
+        console.log(`   /sw:done ${incrementId}`);
+        console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+      } else {
+        console.log(`   ${transitionResult.message}`);
+      }
+      results.autoTransition = { success: true, ...transitionResult };
+    } catch (error) {
+      console.error('❌ Error checking auto-transition:', error.message);
+      results.autoTransition = { success: false, error: error.message };
+    }
+
     // OPERATION 1: Update tasks.md (uses imported function)
-    console.log('\n🔄 [1/5] Updating tasks.md...');
+    console.log('\n🔄 [1/6] Updating tasks.md...');
     try {
       await updateTasksMd(incrementId);
       results.updateTasks = { success: true };
@@ -148,7 +178,7 @@ async function runConsolidatedSync(incrementId) {
     }
 
     // OPERATION 2: Sync living docs (uses imported function)
-    console.log('\n📚 [2/5] Syncing living docs...');
+    console.log('\n📚 [2/6] Syncing living docs...');
     try {
       await syncLivingDocs(incrementId);
       results.syncDocs = { success: true };
@@ -166,7 +196,7 @@ async function runConsolidatedSync(incrementId) {
     }
 
     // OPERATION 4: Translate living docs (uses imported function)
-    console.log('\n🌐 [4/5] Checking translation needs...');
+    console.log('\n🌐 [4/6] Checking translation needs...');
     try {
       await translateLivingDocs(incrementId);
       results.translate = { success: true };

package/plugins/specweave/lib/hooks/invoke-translator-skill.js

@@ -81,12 +81,12 @@ ${contentToTranslate}`,
   } else {
     console.error("\n\u26A0\uFE0F  AUTO-TRANSLATION REQUIRES ONE OF:");
     console.error("   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable");
-    console.error("   Option B: Run /specweave:translate <file-path>");
+    console.error("   Option B: Run /sw:translate <file-path>");
     console.error("   Option C: Manually translate the content\n");
     return postProcessTranslation(
       `<!-- \u26A0\uFE0F AUTO-TRANSLATION PENDING -->
 <!-- Set ANTHROPIC_API_KEY for automatic translation -->
-<!-- Or run: /specweave:translate to complete -->
+<!-- Or run: /sw:translate to complete -->
 <!-- Original content below -->
 
 ${contentToTranslate}`,

package/plugins/specweave/lib/hooks/invoke-translator-skill.ts

@@ -165,11 +165,11 @@ async function performTranslation(
     // Non-interactive environment - provide clear instructions
     console.error('\n⚠️  AUTO-TRANSLATION REQUIRES ONE OF:');
     console.error('   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable');
-    console.error('   Option B: Run /specweave:translate <file-path>');
+    console.error('   Option B: Run /sw:translate <file-path>');
     console.error('   Option C: Manually translate the content\n');
 
     return postProcessTranslation(
-      `<!-- ⚠️ AUTO-TRANSLATION PENDING -->\n<!-- Set ANTHROPIC_API_KEY for automatic translation -->\n<!-- Or run: /specweave:translate to complete -->\n<!-- Original content below -->\n\n${contentToTranslate}`,
+      `<!-- ⚠️ AUTO-TRANSLATION PENDING -->\n<!-- Set ANTHROPIC_API_KEY for automatic translation -->\n<!-- Or run: /sw:translate to complete -->\n<!-- Original content below -->\n\n${contentToTranslate}`,
       preserved
     );
   }

package/plugins/specweave/lib/hooks/prepare-reflection-context.js

@@ -97,7 +97,7 @@ if (require.main === module) {
   const contextFile = prepareReflectionContext(incrementId, taskId);
   if (contextFile) {
     console.log(`Reflection context prepared: ${contextFile}`);
-    console.log("\u2728 Reflection ready. Run /specweave:reflect to analyze your work.");
+    console.log("\u2728 Reflection ready. Run /sw:reflect to analyze your work.");
   } else {
     console.log("Reflection skipped (disabled or no changes).");
   }

package/plugins/specweave/lib/hooks/prepare-reflection-context.ts

@@ -171,7 +171,7 @@ if (require.main === module) {
 
   if (contextFile) {
     console.log(`Reflection context prepared: ${contextFile}`);
-    console.log('✨ Reflection ready. Run /specweave:reflect to analyze your work.');
+    console.log('✨ Reflection ready. Run /sw:reflect to analyze your work.');
   } else {
     console.log('Reflection skipped (disabled or no changes).');
   }

package/plugins/specweave/lib/hooks/sync-living-docs.js

@@ -107,10 +107,10 @@ async function syncLivingDocs(incrementId) {
       } catch (importErr) {
         // translate-file.js may not be compiled yet
         console.log(`   \u2139\uFE0F  Translation module not available (run 'npm run build')`);
-        console.log(`   \u{1F4A1} Tip: Run /specweave:translate to translate manually`);
+        console.log(`   \u{1F4A1} Tip: Run /sw:translate to translate manually`);
       }
     } else if (targetLang !== 'en' && !translationEnabled) {
-      console.log(`   \u2139\uFE0F  Translation disabled (use /specweave:translate manually)`);
+      console.log(`   \u2139\uFE0F  Translation disabled (use /sw:translate manually)`);
     }
 
     // ========================================================================
@@ -133,7 +133,7 @@ async function syncLivingDocs(incrementId) {
     // GATE 3: autoSyncOnCompletion (v0.24.0+ - Automatic vs Manual Sync)
     // ========================================================================
     // This setting controls whether sync to external tools happens automatically
-    // on increment completion or requires manual /specweave:sync-* commands.
+    // on increment completion or requires manual /sw:sync-* commands.
     // DEFAULT: true (automatic sync enabled for better UX)
     const autoSync = config.sync?.settings?.autoSyncOnCompletion ?? true;
 
@@ -170,7 +170,7 @@ async function hierarchicalDistribution(incrementId) {
     // Why this change:
     // - Old SpecDistributor.distribute() method no longer exists (removed in v3.0.0)
     // - LivingDocsSync is the official, stable API for syncing increments
-    // - Used by /specweave:sync-docs command - battle-tested and maintained
+    // - Used by /sw:sync-docs command - battle-tested and maintained
     // - Future-proof: Won't break when internal APIs change
     //
     // Architecture:
@@ -259,7 +259,7 @@ async function hierarchicalDistribution(incrementId) {
     console.error(`   \u274C Living docs sync failed: ${error}`);
     console.error(error.stack);
     console.error("   \u26A0\uFE0F  Living docs sync skipped due to error");
-    console.error("   \u{1F4A1} Tip: Run /specweave:sync-docs manually to retry");
+    console.error("   \u{1F4A1} Tip: Run /sw:sync-docs manually to retry");
     return {
       success: false,
       changedFiles: []

package/plugins/specweave/lib/hooks/translate-file.d.ts

@@ -7,7 +7,7 @@
  * This script is called from:
  * - Post-increment-planning hook (auto-translate spec.md, plan.md, tasks.md)
  * - Post-task-completion hook (auto-translate living docs)
- * - Manual /specweave:translate command
+ * - Manual /sw:translate command
  *
  * Usage:
  *   node translate-file.js <file-path> [--target-lang en] [--preview]

package/plugins/specweave/lib/hooks/translate-file.js

@@ -163,11 +163,11 @@ ${contentToTranslate}`;
     }
     console.error("\n\u26A0\uFE0F  AUTO-TRANSLATION REQUIRES MANUAL STEP:");
     console.error("   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable");
-    console.error("   Option B: Run /specweave:translate <file-path>");
+    console.error("   Option B: Run /sw:translate <file-path>");
     console.error("   Option C: Manually translate the content\n");
     return `<!-- \u26A0\uFE0F AUTO-TRANSLATION PENDING -->
 <!-- Set ANTHROPIC_API_KEY for automatic translation -->
-<!-- Or run: /specweave:translate to complete -->
+<!-- Or run: /sw:translate to complete -->
 <!-- Original content below -->
 
 ${contentToTranslate}`;

package/plugins/specweave/lib/hooks/translate-file.ts

@@ -7,7 +7,7 @@
  * This script is called from:
  * - Post-increment-planning hook (auto-translate spec.md, plan.md, tasks.md)
  * - Post-task-completion hook (auto-translate living docs)
- * - Manual /specweave:translate command
+ * - Manual /sw:translate command
  *
  * Usage:
  *   node translate-file.js <file-path> [--target-lang en] [--preview]
@@ -273,11 +273,11 @@ async function invokeLLMTranslation(prompt: string, verbose: boolean): Promise<s
 
     console.error('\n⚠️  AUTO-TRANSLATION REQUIRES MANUAL STEP:');
     console.error('   Option A (Recommended): Set ANTHROPIC_API_KEY environment variable');
-    console.error('   Option B: Run /specweave:translate <file-path>');
+    console.error('   Option B: Run /sw:translate <file-path>');
     console.error('   Option C: Manually translate the content\n');
 
     // Return original content with clear marker
-    return `<!-- ⚠️ AUTO-TRANSLATION PENDING -->\n<!-- Set ANTHROPIC_API_KEY for automatic translation -->\n<!-- Or run: /specweave:translate to complete -->\n<!-- Original content below -->\n\n${contentToTranslate}`;
+    return `<!-- ⚠️ AUTO-TRANSLATION PENDING -->\n<!-- Set ANTHROPIC_API_KEY for automatic translation -->\n<!-- Or run: /sw:translate to complete -->\n<!-- Original content below -->\n\n${contentToTranslate}`;
   }
 }
 

package/plugins/specweave/lib/hooks/us-completion-orchestrator.js

@@ -67,7 +67,7 @@ async function syncCompletedUserStories(incrementId) {
       const secondsRemaining = Math.ceil((6e4 - timeSinceLastSync) / 1e3);
       console.log(`\u23ED\uFE0F  US sync throttled (last sync ${Math.floor(timeSinceLastSync / 1e3)}s ago)`);
       console.log(`   \u2139\uFE0F  Sync will be available in ${secondsRemaining}s`);
-      console.log(`   \u{1F4A1} Manual sync: /specweave:sync-progress ${incrementId}`);
+      console.log(`   \u{1F4A1} Manual sync: /sw:sync-progress ${incrementId}`);
       return {
         success: true,
         message: "Sync throttled",

package/plugins/specweave/lib/hooks/us-completion-orchestrator.ts

@@ -163,7 +163,7 @@ export async function syncCompletedUserStories(incrementId: string): Promise<USS
     // Safety:
     // - fs.writeFile() confirmed to NOT trigger hooks (no infinite loop risk)
     // - SKIP_EXTERNAL_SYNC still guards external tool sync layer
-    // - Users can manually sync if needed: /specweave:sync-progress
+    // - Users can manually sync if needed: /sw:sync-progress
     //
     // Trade-off:
     // - Potential 60s delay for US completion visibility
@@ -177,7 +177,7 @@ export async function syncCompletedUserStories(incrementId: string): Promise<USS
 
       console.log(`⏭️  US sync throttled (last sync ${Math.floor(timeSinceLastSync / 1000)}s ago)`);
       console.log(`   ℹ️  Sync will be available in ${secondsRemaining}s`);
-      console.log(`   💡 Manual sync: /specweave:sync-progress ${incrementId}`);
+      console.log(`   💡 Manual sync: /sw:sync-progress ${incrementId}`);
 
       return {
         success: true,