specweave 0.33.4 → 0.33.6

package/plugins/specweave/commands/{specweave-fix-duplicates.md → fix-duplicates.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:fix-duplicates
+name: sw:fix-duplicates
 description: Automatically detect and resolve duplicate increments with smart conflict resolution
 ---
 
@@ -20,19 +20,19 @@ description: Automatically detect and resolve duplicate increments with smart co
 
 ```bash
 # Detect and fix all duplicates interactively
-/specweave:fix-duplicates
+/sw:fix-duplicates
 
 # Preview what would be done (dry-run)
-/specweave:fix-duplicates --dry-run
+/sw:fix-duplicates --dry-run
 
 # Auto-fix with content merging
-/specweave:fix-duplicates --merge
+/sw:fix-duplicates --merge
 
 # Force fix without confirmation (use with caution!)
-/specweave:fix-duplicates --force --merge
+/sw:fix-duplicates --force --merge
 
 # Fix specific increment number
-/specweave:fix-duplicates 0031
+/sw:fix-duplicates 0031
 ```
 
 ## Options
@@ -135,7 +135,7 @@ Loser 2: .specweave/increments/_abandoned/0031-old-attempt/
 ### Example 1: Interactive Fix (Recommended)
 
 ```bash
-/specweave:fix-duplicates
+/sw:fix-duplicates
 ```
 
 **Output**:
@@ -182,7 +182,7 @@ Space freed: 2.3 MB
 ### Example 2: Dry-Run Preview
 
 ```bash
-/specweave:fix-duplicates --dry-run
+/sw:fix-duplicates --dry-run
 ```
 
 **Output**:
@@ -205,13 +205,13 @@ Summary:
   Would free: 2.5 MB
 
 Run without --dry-run to proceed:
-  /specweave:fix-duplicates --merge
+  /sw:fix-duplicates --merge
 ```
 
 ### Example 3: Auto-Fix with Merge
 
 ```bash
-/specweave:fix-duplicates --merge --force
+/sw:fix-duplicates --merge --force
 ```
 
 **Output**:
@@ -244,7 +244,7 @@ Summary:
 ### Example 4: Fix Specific Increment
 
 ```bash
-/specweave:fix-duplicates 0031
+/sw:fix-duplicates 0031
 ```
 
 **Output**:
@@ -314,7 +314,7 @@ Recommendation:
 
 **Increment**: 0031-external-tool-status-sync
 **Resolved**: 2025-11-15 07:00:00 UTC
-**Command**: /specweave:fix-duplicates --merge
+**Command**: /sw:fix-duplicates --merge
 
 ## Detected Duplicates
 
@@ -461,7 +461,7 @@ task.run(async () => {
       console.log(`Would merge: ${totalMerged} file${totalMerged > 1 ? 's' : ''}`);
     }
     console.log('\nRun without --dry-run to proceed:');
-    console.log('  /specweave:fix-duplicates --merge');
+    console.log('  /sw:fix-duplicates --merge');
   } else {
     console.log(`\nDuplicates resolved: ${results.length}`);
     console.log(`Paths deleted: ${totalDeleted}`);
@@ -484,9 +484,9 @@ No configuration needed - all options are provided via command-line flags.
 
 ## Related Commands
 
-- `/specweave:archive <id>` - Archive specific increment (prevents duplicates)
-- `/specweave:restore <id>` - Restore increment from archive
-- `/specweave:status` - View all increment statuses
+- `/sw:archive <id>` - Archive specific increment (prevents duplicates)
+- `/sw:restore <id>` - Restore increment from archive
+- `/sw:status` - View all increment statuses
 
 ## Safety Notes
 

package/plugins/specweave/commands/{specweave-import-docs.md → import-docs.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:import-docs
+name: sw:import-docs
 description: Import brownfield documentation from Notion exports, Confluence, GitHub Wiki, or any markdown folder. Automatically classifies files as specs, modules, team docs, or legacy.
 ---
 
@@ -22,7 +22,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ## Usage
 
 ```bash
-/specweave:import-docs <source-path> [options]
+/sw:import-docs <source-path> [options]
 ```
 
 ### Options
@@ -40,7 +40,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 # Export Notion workspace to /tmp/notion-export/
 # Then import:
 
-/specweave:import-docs /tmp/notion-export/ --source=notion
+/sw:import-docs /tmp/notion-export/ --source=notion
 
 # Result:
 # 📊 Analysis Results:
@@ -55,7 +55,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ### Example 2: Confluence Export
 
 ```bash
-/specweave:import-docs /path/to/confluence/ --source=confluence --project=web-app
+/sw:import-docs /path/to/confluence/ --source=confluence --project=web-app
 
 # Imports to: projects/web-app/specs/, modules/, team/, legacy/confluence/
 ```
@@ -63,7 +63,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ### Example 3: Dry Run (Preview)
 
 ```bash
-/specweave:import-docs /tmp/docs/ --source=custom --dry-run
+/sw:import-docs /tmp/docs/ --source=custom --dry-run
 
 # Shows classification without importing files
 # Use this to preview results before actual import
@@ -72,7 +72,7 @@ Import existing documentation from Notion exports, Confluence, GitHub Wiki, or a
 ### Example 4: Preserve Structure
 
 ```bash
-/specweave:import-docs /path/to/wiki/ --source=wiki --preserve-structure
+/sw:import-docs /path/to/wiki/ --source=wiki --preserve-structure
 
 # Preserves original folder structure:
 # legacy/wiki/engineering/backend/auth.md
@@ -203,7 +203,7 @@ Import history is tracked in `.specweave/config.json`:
 
 ## See Also
 
-- `/specweave:init-multiproject` - Set up multi-project mode first
+- `/sw:init-multiproject` - Set up multi-project mode first
 - [Brownfield Import Guide](https://docs.spec-weave.com/guides/brownfield-import)
 - [Migration Best Practices](https://docs.spec-weave.com/guides/migration-best-practices)
 

package/plugins/specweave/commands/{specweave-import-external.md → import-external.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:import-external
+name: sw:import-external
 description: AUTO-EXECUTE import of external work items (GitHub/JIRA/ADO) since last import. NO PROMPTS - immediately runs with defaults. Creates READ-ONLY references in living docs. Options available but NOT required.
 ---
 
@@ -11,7 +11,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 
 ## CRITICAL: Default Behavior (NO PROMPTS!)
 
-**When user runs `/specweave:import-external` with NO arguments:**
+**When user runs `/sw:import-external` with NO arguments:**
 1. **IMMEDIATELY execute** with default settings - DO NOT show menus or ask questions
 2. **Default = "since last import"** - auto-detects from `.specweave/sync-metadata.json`
 3. **If first import ever** - defaults to last 1 month
@@ -45,7 +45,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ## Usage
 
 ```bash
-/specweave:import-external [options]
+/sw:import-external [options]
 ```
 
 ### Options (ALL OPTIONAL - defaults work without them)
@@ -65,7 +65,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 1: Import New Items (Default - NO PROMPTS!)
 
 ```bash
-/specweave:import-external
+/sw:import-external
 
 # IMMEDIATELY executes with defaults:
 # - Since last import (or 1 month if first import)
@@ -90,7 +90,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 2: GitHub Only (Last 3 Months)
 
 ```bash
-/specweave:import-external --github-only --since=3m
+/sw:import-external --github-only --since=3m
 
 # Imports only from GitHub
 # Items created in last 3 months
@@ -99,7 +99,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 3: Dry Run (Preview)
 
 ```bash
-/specweave:import-external --dry-run --since=1m
+/sw:import-external --dry-run --since=1m
 
 # Shows what would be imported without creating files
 # Useful for checking item counts before actual import
@@ -116,7 +116,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Example 4: JIRA Only (All Items)
 
 ```bash
-/specweave:import-external --jira-only --since=all
+/sw:import-external --jira-only --since=all
 
 # Imports all JIRA items (no time filter)
 # ⚠️  Warning shown if > 100 items detected
@@ -127,7 +127,7 @@ Import work items from GitHub (issues/milestones), JIRA (epics/stories), or Azur
 ### Since Last Import (Default)
 
 ```bash
-/specweave:import-external
+/sw:import-external
 
 # Reads last import timestamp from:
 # .specweave/sync-metadata.json
@@ -382,7 +382,7 @@ No tasks defined.
 
 ## Differences from `specweave init`
 
-| Feature | `specweave init` | `/specweave:import-external` |
+| Feature | `specweave init` | `/sw:import-external` |
 |---------|------------------|------------------------------|
 | When to use | First-time setup | Ongoing imports after init |
 | User prompts | Interactive setup | **NONE** (auto-execute with defaults) |

package/plugins/specweave/commands/{specweave-increment.md → increment.md}

@@ -1,5 +1,5 @@
 ---
-name: specweave:increment
+name: sw:increment
 description: Plan new Product Increment - PM-led process (market research, spec, plan, auto-generate tasks). Auto-closes previous increment if PM gates pass.
 ---
 
@@ -26,7 +26,7 @@ if ! specweave check-discipline; then
   echo "💡 What would you like to do?"
   echo ""
   echo "1️⃣  Close incomplete increments:"
-  echo "   /specweave:done <id>"
+  echo "   /sw:done <id>"
   echo ""
   echo "2️⃣  Check status:"
   echo "   specweave check-discipline --verbose"
@@ -52,7 +52,7 @@ echo "✅ Discipline check passed"
 - ❌ NO options to defer - close previous first
 - ❌ NO auto-closing gates - explicit closure required
 - ✅ HARD BLOCK - cannot proceed without closing previous
-- ✅ Clear next steps - use `/specweave:close`
+- ✅ Clear next steps - use `/sw:close`
 - ✅ Safety valve - `--force` flag for emergencies (logged)
 
 **Rationale**:
@@ -178,8 +178,8 @@ if (activeCount >= limits.hardCap) {
   });
 
   console.log(chalk.blue('\n💡 Options:\n'));
-  console.log(chalk.white('1️⃣  Complete an increment: /specweave:done <id>'));
-  console.log(chalk.white('2️⃣  Pause an increment: /specweave:pause <id>'));
+  console.log(chalk.white('1️⃣  Complete an increment: /sw:done <id>'));
+  console.log(chalk.white('2️⃣  Pause an increment: /sw:pause <id>'));
   console.log(chalk.white('3️⃣  Increase limit: Edit .specweave/config.json limits.hardCap'));
   console.log(chalk.white('4️⃣  Continue anyway (confirm below)\n'));
 
@@ -246,7 +246,7 @@ if (activeCount >= limits.maxActiveIncrements) {
 
     if (choice === 'complete') {
       console.log(chalk.green('\n✅ Smart choice! Finish current work first.\n'));
-      console.log(chalk.dim('Use /specweave:do to continue work\n'));
+      console.log(chalk.dim('Use /sw:do to continue work\n'));
       process.exit(0);
     } else if (choice === 'pause') {
       console.log(chalk.blue('\n⏸️  Pausing current increment...\n'));
@@ -290,13 +290,13 @@ Active increments:
 💡 You MUST complete or pause existing work first:
 
 1️⃣  Complete an increment:
-   /specweave:done <id>
+   /sw:done <id>
 
 2️⃣  Pause an increment:
-   /specweave:pause <id> --reason="..."
+   /sw:pause <id> --reason="..."
 
 3️⃣  Check status:
-   /specweave:status
+   /sw:status
 
 📝 Multiple hotfixes? Combine them into ONE increment!
    Example: 0009-security-fixes (SQL + XSS + CSRF)
@@ -332,7 +332,7 @@ Choose an option: 1
 
 ✅ Smart choice! Finish current work first.
 
-Use /specweave:do to continue work
+Use /sw:do to continue work
 ```
 
 **Example Output - Emergency Interrupt (hotfix)**:
@@ -899,10 +899,10 @@ After the increment-planner skill completes, verify:
 📝 Now syncing strategic documentation to living docs...
 ```
 
-**Run `/specweave:sync-docs update` to create initial documentation**:
+**Run `/sw:sync-docs update` to create initial documentation**:
 
 ```bash
-/specweave:sync-docs update
+/sw:sync-docs update
 ```
 
 This will:
@@ -913,7 +913,7 @@ This will:
 - Update security docs in `.specweave/docs/internal/security/`
 - May prompt for conflict resolution if needed
 
-**After `/specweave:sync-docs update` completes**:
+**After `/sw:sync-docs update` completes**:
 
 ```
 ✅ Strategic documentation synchronized!
@@ -933,7 +933,7 @@ This will:
 You MUST invoke the sync-specs command using the SlashCommand tool:
 
 ```
-SlashCommand(command: "/specweave:sync-specs {increment-id}")
+SlashCommand(command: "/sw:sync-specs {increment-id}")
 ```
 
 **DO NOT** just mention the command in output - you MUST actually execute it!
@@ -1004,7 +1004,7 @@ External tool sync failures are **NON-BLOCKING** (increment creation succeeds):
 
 ```
 ⚠️ External sync failed: Rate limit exceeded
-💡 Run /specweave:sync-specs {increment-id} to retry
+💡 Run /sw:sync-specs {increment-id} to retry
 ```
 
 **After Step 10 completes:**
@@ -1014,8 +1014,8 @@ External tool sync failures are **NON-BLOCKING** (increment creation succeeds):
 
 Next steps:
 1. Review the increment plan and strategic docs
-2. Start implementation: /specweave:do {increment-id}
-3. Monitor external tool status: /specweave:status {increment-id}
+2. Start implementation: /sw:do {increment-id}
+3. Monitor external tool status: /sw:status {increment-id}
 ```
 
 ## Frontmatter Format (spec.md):

package/plugins/specweave/commands/{specweave-jobs.md → jobs.md}

@@ -1,12 +1,12 @@
 ---
-name: specweave:jobs
+name: sw:jobs
 description: Show current work status (active increments, progress) and background jobs (imports, cloning). Even with no jobs, shows increment summary and helpful context.
-usage: /specweave:jobs [--all] [--id <job-id>] [--resume <job-id>] [--kill <job-id>] [--follow <job-id>] [--logs <job-id>] [--diagnostics]
+usage: /sw:jobs [--all] [--id <job-id>] [--resume <job-id>] [--kill <job-id>] [--follow <job-id>] [--logs <job-id>] [--diagnostics]
 ---
 
 # Background Jobs Monitor
 
-**Usage**: `/specweave:jobs [options]`
+**Usage**: `/sw:jobs [options]`
 
 ---
 
@@ -22,7 +22,7 @@ Monitor and manage long-running background operations:
 **ASYNC ARCHITECTURE (2025-12-01)**:
 - Jobs run as **detached processes** that survive terminal close
 - Progress tracked via filesystem (`.specweave/state/jobs/`)
-- Can check status anytime with `/specweave:jobs`
+- Can check status anytime with `/sw:jobs`
 
 ---
 
@@ -78,7 +78,7 @@ STATE_FILE=".specweave/state/background-jobs.json"
   [def67890] import-issues (GitHub)
      Progress: 1,234/10,000 (12%)
      Reason: Rate limited (resumes in 45s)
-     Resume: /specweave:jobs --resume def67890
+     Resume: /sw:jobs --resume def67890
 
 ✅ Completed (3):
   [ghi11111] import-issues - 4,500 items - 5 mins ago
@@ -86,13 +86,13 @@ STATE_FILE=".specweave/state/background-jobs.json"
   [bfa88001] brownfield-analysis - 127 discrepancies - 2 hours ago
 
 💡 Commands:
-   /specweave:jobs --id abc12345     → Details for specific job
-   /specweave:jobs --follow abc12345 → Follow progress live
-   /specweave:jobs --logs abc12345   → View worker logs
-   /specweave:jobs --resume def67890 → Resume paused job
-   /specweave:jobs --kill abc12345   → Kill running job
-   /specweave:jobs --diagnostics     → Show watchdog diagnostics
-   /specweave:jobs --all             → Show all jobs (including old)
+   /sw:jobs --id abc12345     → Details for specific job
+   /sw:jobs --follow abc12345 → Follow progress live
+   /sw:jobs --logs abc12345   → View worker logs
+   /sw:jobs --resume def67890 → Resume paused job
+   /sw:jobs --kill abc12345   → Kill running job
+   /sw:jobs --diagnostics     → Show watchdog diagnostics
+   /sw:jobs --all             → Show all jobs (including old)
 ```
 
 ---
@@ -102,7 +102,7 @@ STATE_FILE=".specweave/state/background-jobs.json"
 ### View Specific Job Details
 
 ```
-/specweave:jobs --id abc12345
+/sw:jobs --id abc12345
 
 📦 Job Details: abc12345
 
@@ -130,7 +130,7 @@ Files:
 Watch job progress in real-time (like `tail -f`):
 
 ```
-/specweave:jobs --follow abc12345
+/sw:jobs --follow abc12345
 
 📦 Following job abc12345 (Ctrl+C to stop)
 
@@ -148,7 +148,7 @@ Watch job progress in real-time (like `tail -f`):
 Show detailed worker output:
 
 ```
-/specweave:jobs --logs abc12345
+/sw:jobs --logs abc12345
 
 📋 Worker Logs for abc12345 (last 50 lines):
 
@@ -168,7 +168,7 @@ Show detailed worker output:
 Stop a background job:
 
 ```
-/specweave:jobs --kill abc12345
+/sw:jobs --kill abc12345
 
 ⚠️  Killing job abc12345...
    Type: import-issues
@@ -176,7 +176,7 @@ Stop a background job:
    Progress: 2,500/10,000 (25%)
 
 ✅ Job killed. Status changed to 'paused'.
-   Resume later: /specweave:jobs --resume abc12345
+   Resume later: /sw:jobs --resume abc12345
 ```
 
 **Implementation**:
@@ -194,7 +194,7 @@ if (success) {
 When a job is paused (rate limited, killed, or user requested), resume it:
 
 ```
-/specweave:jobs --resume def67890
+/sw:jobs --resume def67890
 
 🔄 Resuming job def67890...
    Type: import-issues
@@ -205,7 +205,7 @@ When a job is paused (rate limited, killed, or user requested), resume it:
    New PID: 45679
 
 ✅ Job resumed in background.
-   Check progress: /specweave:jobs --follow def67890
+   Check progress: /sw:jobs --follow def67890
 ```
 
 **Implementation**:
@@ -293,9 +293,9 @@ interface SessionHealth {
 ## Integration Points
 
 - Called after `specweave init` with background clone
-- Called after `/specweave:import-external` starts background import
-- Called after `/specweave-github:sync` for large syncs
-- Called after `/specweave-jira:sync` for large syncs
+- Called after `/sw:import-external` starts background import
+- Called after `/sw-github:sync` for large syncs
+- Called after `/sw-jira:sync` for large syncs
 - Called after `specweave init` brownfield analysis prompt
 
 ---
@@ -327,9 +327,9 @@ When a brownfield-analysis job completes, it shows a summary:
      🟢 Low:        32
 
 💡 Next Steps:
-   /specweave:discrepancies           → View all pending discrepancies
-   /specweave:discrepancies --module auth → Filter by module
-   /specweave:discrepancy-to-increment DISC-0001 DISC-0002 → Create increment
+   /sw:discrepancies           → View all pending discrepancies
+   /sw:discrepancies --module auth → Filter by module
+   /sw:discrepancy-to-increment DISC-0001 DISC-0002 → Create increment
 ```
 
 ---
@@ -342,14 +342,14 @@ If job failed:
   [xyz99999] import-issues
      Error: Rate limit exceeded (retry after 60s)
      Failed at: item 5,000 of 10,000
-     Resume: /specweave:jobs --resume xyz99999
+     Resume: /sw:jobs --resume xyz99999
 ```
 
 ---
 
 ## Session Health & Watchdog Diagnostics (v2.0)
 
-The `/specweave:jobs` command now includes session health monitoring. The watchdog runs in the background and writes diagnostics that help explain any alerts you may have received.
+The `/sw:jobs` command now includes session health monitoring. The watchdog runs in the background and writes diagnostics that help explain any alerts you may have received.
 
 ### Display Format (with health status)
 
@@ -390,7 +390,7 @@ The watchdog writes diagnostics to `.specweave/state/.watchdog-diagnostics.json`
 ### View Detailed Diagnostics
 
 ```
-/specweave:jobs --diagnostics
+/sw:jobs --diagnostics
 
 🩺 Watchdog Diagnostics