specweave 0.33.5 → 0.34.0

package/plugins/specweave-github/commands/close.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-github:close
+name: sw-github:close
 description: Close GitHub issue for completed SpecWeave increment. Posts completion summary with final stats, deliverables, and closes the issue. Links closure in increment metadata.
 ---
 
@@ -7,10 +7,10 @@ description: Close GitHub issue for completed SpecWeave increment. Posts complet
 
 Close the GitHub issue associated with a completed SpecWeave increment.
 
-**Usage**: `/specweave-github:close <increment-id>`
+**Usage**: `/sw-github:close <increment-id>`
 
 ```bash
-/specweave:github:close-issue <increment-id> [options]
+/sw:github:close-issue <increment-id> [options]
 ```
 
 ## Arguments
@@ -28,16 +28,16 @@ Close the GitHub issue associated with a completed SpecWeave increment.
 
 ```bash
 # Basic usage (auto-generates completion summary)
-/specweave:github:close-issue 0004
+/sw:github:close-issue 0004
 
 # With custom comment
-/specweave:github:close-issue 0004 --comment "Merged to main, deploying to production"
+/sw:github:close-issue 0004 --comment "Merged to main, deploying to production"
 
 # Force close (skip validation)
-/specweave:github:close-issue 0004 --force
+/sw:github:close-issue 0004 --force
 
 # Reopen closed issue
-/specweave:github:close-issue 0004 --reopen
+/sw:github:close-issue 0004 --reopen
 ```
 
 ## What This Command Does
@@ -45,7 +45,7 @@ Close the GitHub issue associated with a completed SpecWeave increment.
 1. **Validates Increment Completion**
    - All tasks completed (48/48)
    - All tests passing
-   - PM gates passed (from `/specweave:done`)
+   - PM gates passed (from `/sw:done`)
    - Documentation updated
 
 2. **Generates Completion Summary**
@@ -205,19 +205,19 @@ Issues:
   - TC-127: E2E sync test
 
 ✗ PM Gates: Not run yet
-  - Run /specweave:done 0004 first
+  - Run /sw:done 0004 first
 
 Fix these issues, then retry:
-  /specweave:github:close-issue 0004
+  /sw:github:close-issue 0004
 
 Or force close (not recommended):
-  /specweave:github:close-issue 0004 --force
+  /sw:github:close-issue 0004 --force
 ```
 
 ## Requirements
 
 - GitHub CLI (`gh`) installed and authenticated
-- Increment marked as complete (via `/specweave:done`)
+- Increment marked as complete (via `/sw:done`)
 - Valid GitHub issue exists for increment
 
 ## Error Handling
@@ -229,10 +229,10 @@ Or force close (not recommended):
 Status: in_progress (should be: completed)
 
 Complete the increment first:
-  /specweave:done 0004
+  /sw:done 0004
 
 Then close the issue:
-  /specweave:github:close-issue 0004
+  /sw:github:close-issue 0004
 ```
 
 **Issue not found**:
@@ -242,7 +242,7 @@ Then close the issue:
 Check .metadata.yaml for issue number.
 
 Create issue first:
-  /specweave:github:create-issue 0004
+  /sw:github:create-issue 0004
 ```
 
 **Issue already closed**:
@@ -266,15 +266,15 @@ Contact repository admin for access.
 
 ## Related Commands
 
-- `/specweave:done <increment-id>`: Mark increment complete (run this first)
-- `/specweave:github:sync <increment-id>`: Sync final progress before closing
-- `/specweave:github:status <increment-id>`: Check issue status
+- `/sw:done <increment-id>`: Mark increment complete (run this first)
+- `/sw:github:sync <increment-id>`: Sync final progress before closing
+- `/sw:github:status <increment-id>`: Check issue status
 
 ## Tips
 
-1. **Auto-Close**: Enable `auto_close_issue: true` for automatic closing when running `/specweave:done`
+1. **Auto-Close**: Enable `auto_close_issue: true` for automatic closing when running `/sw:done`
 
-2. **Final Sync**: Always run `/specweave:github:sync` before closing to ensure latest progress is posted
+2. **Final Sync**: Always run `/sw:github:sync` before closing to ensure latest progress is posted
 
 3. **Validation**: Don't skip validation (`--force`) unless absolutely necessary - it ensures quality
 
@@ -383,11 +383,11 @@ Close multiple completed increments:
 
 ```bash
 # Close all completed increments
-/specweave:github:close-issue --status completed --all
+/sw:github:close-issue --status completed --all
 
 # Close specific increments
 for i in 0004 0005 0006; do
-  /specweave:github:close-issue $i
+  /sw:github:close-issue $i
 done
 ```
 
@@ -396,7 +396,7 @@ done
 Reopen issue with explanation:
 
 ```bash
-/specweave:github:close-issue 0004 --reopen \
+/sw:github:close-issue 0004 --reopen \
   --comment "Reopening: Critical bug found in production (issue #140). Need to add rollback mechanism."
 ```
 
@@ -405,13 +405,13 @@ Reopen issue with explanation:
 Close and lock issue to prevent further comments:
 
 ```bash
-/specweave:github:close-issue 0004 --lock \
+/sw:github:close-issue 0004 --lock \
   --lock-reason "resolved"  # or "off-topic", "spam", "too heated"
 ```
 
 ---
 
-**Command**: `/specweave:github:close-issue`
+**Command**: `/sw:github:close-issue`
 **Plugin**: specweave-github
 **Agent**: github-manager
 **Version**: 1.0.0

package/plugins/specweave-github/commands/create.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-github:create
+name: sw-github:create
 description: Create a GitHub issue for a SpecWeave increment. Generates issue from increment specs with task checklist, labels, and milestone. Links issue to increment metadata.
 ---
 
@@ -7,10 +7,10 @@ description: Create a GitHub issue for a SpecWeave increment. Generates issue fr
 
 Create a GitHub issue for the specified SpecWeave increment.
 
-**Usage**: `/specweave-github:create <increment-id>`
+**Usage**: `/sw-github:create <increment-id>`
 
 ```bash
-/specweave:github:create-issue <increment-id> [options]
+/sw:github:create-issue <increment-id> [options]
 ```
 
 ## Arguments
@@ -29,19 +29,19 @@ Create a GitHub issue for the specified SpecWeave increment.
 
 ```bash
 # Basic usage
-/specweave:github:create-issue 0004
+/sw:github:create-issue 0004
 
 # With custom labels
-/specweave:github:create-issue 0004 --labels "urgent,backend"
+/sw:github:create-issue 0004 --labels "urgent,backend"
 
 # Assign to developer
-/specweave:github:create-issue 0004 --assignee @developer1
+/sw:github:create-issue 0004 --assignee @developer1
 
 # Add to project
-/specweave:github:create-issue 0004 --project 3
+/sw:github:create-issue 0004 --project 3
 
 # Force recreate
-/specweave:github:create-issue 0004 --force
+/sw:github:create-issue 0004 --force
 ```
 
 ## What This Command Does
@@ -195,18 +195,18 @@ Options:
 1. Wait 30 minutes
 2. Use authenticated token (higher limit)
 
-Run /specweave:github:status 0004 to check sync state.
+Run /sw:github:status 0004 to check sync state.
 ```
 
 ## Related Commands
 
-- `/specweave:github:sync <increment-id>`: Update existing issue
-- `/specweave:github:close-issue <increment-id>`: Close issue
-- `/specweave:github:status <increment-id>`: Check sync status
+- `/sw:github:sync <increment-id>`: Update existing issue
+- `/sw:github:close-issue <increment-id>`: Close issue
+- `/sw:github:status <increment-id>`: Check sync status
 
 ## Tips
 
-1. **Auto-Create**: Enable `auto_create_issue: true` in config to auto-create issues when running `/specweave:inc`
+1. **Auto-Create**: Enable `auto_create_issue: true` in config to auto-create issues when running `/sw:inc`
 
 2. **Templates**: Customize issue template in `.specweave/github/issue-template.md`
 
@@ -251,7 +251,7 @@ Create issues for multiple increments:
 
 ```bash
 for i in 0004 0005 0006; do
-  /specweave:github:create-issue $i
+  /sw:github:create-issue $i
 done
 ```
 
@@ -260,7 +260,7 @@ Or using a script:
 ```bash
 # Create issues for all increments in backlog
 ls .specweave/increments/_backlog/ | while read inc; do
-  /specweave:github:create-issue $inc
+  /sw:github:create-issue $inc
 done
 ```
 
@@ -269,7 +269,7 @@ done
 Preview issue body before creating:
 
 ```bash
-/specweave:github:create-issue 0004 --dry-run
+/sw:github:create-issue 0004 --dry-run
 ```
 
 Output:
@@ -300,7 +300,7 @@ Run without --dry-run to create this issue.
 
 ---
 
-**Command**: `/specweave:github:create-issue`
+**Command**: `/sw:github:create-issue`
 **Plugin**: specweave-github
 **Agent**: github-manager
 **Version**: 1.0.0

package/plugins/specweave-github/commands/pull.md

@@ -1,11 +1,11 @@
 ---
-name: specweave-github:pull
+name: sw-github:pull
 description: Pull latest changes from GitHub Issues (like git pull). Imports comments, labels, and status changes.
 ---
 
 # GitHub Pull Command
 
-**Usage**: `/specweave-github:pull [increment-id]`
+**Usage**: `/sw-github:pull [increment-id]`
 
 **Purpose**: Pull latest changes from GitHub Issues to your local increment (like `git pull`)
 
@@ -15,10 +15,10 @@ description: Pull latest changes from GitHub Issues (like git pull). Imports com
 
 ```bash
 # Pull for current/active increment
-/specweave-github:pull
+/sw-github:pull
 
 # Pull for specific increment
-/specweave-github:pull 0005
+/sw-github:pull 0005
 ```
 
 ---
@@ -50,7 +50,7 @@ const metadata = JSON.parse(await fs.readFile(
 
 const issueNumber = metadata?.external_sync?.github?.issue;
 if (!issueNumber) {
-  console.log(`Not linked to GitHub. Run: /specweave-github:create ${incrementId}`);
+  console.log(`Not linked to GitHub. Run: /sw-github:create ${incrementId}`);
   return;
 }
 ```
@@ -106,7 +106,7 @@ URL: https://github.com/owner/repo/issues/123
 ### Example 1: Simple Pull
 
 ```
-User: /specweave-github:pull
+User: /sw-github:pull
 
 Claude:
 Pulling from GitHub...
@@ -122,12 +122,12 @@ Pull complete!
 ### Example 2: Not Linked
 
 ```
-User: /specweave-github:pull 0005
+User: /sw-github:pull 0005
 
 Claude:
 Increment 0005 not linked to GitHub yet.
 
-To link: /specweave-github:create 0005
+To link: /sw-github:create 0005
 ```
 
 ---
@@ -136,7 +136,7 @@ To link: /specweave-github:create 0005
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-github:push` | Push local changes to GitHub |
-| `/specweave-github:sync` | Two-way sync (pull + push) |
-| `/specweave-github:status` | Check sync status |
-| `/specweave-github:create` | Create GitHub issue |
+| `/sw-github:push` | Push local changes to GitHub |
+| `/sw-github:sync` | Two-way sync (pull + push) |
+| `/sw-github:status` | Check sync status |
+| `/sw-github:create` | Create GitHub issue |

package/plugins/specweave-github/commands/push.md

@@ -1,11 +1,11 @@
 ---
-name: specweave-github:push
+name: sw-github:push
 description: Push local progress to GitHub Issues (like git push). Updates issue with task completion checklist.
 ---
 
 # GitHub Push Command
 
-**Usage**: `/specweave-github:push [increment-id]`
+**Usage**: `/sw-github:push [increment-id]`
 
 **Purpose**: Push local progress to GitHub Issues (like `git push`)
 
@@ -15,10 +15,10 @@ description: Push local progress to GitHub Issues (like git push). Updates issue
 
 ```bash
 # Push current/active increment
-/specweave-github:push
+/sw-github:push
 
 # Push specific increment
-/specweave-github:push 0005
+/sw-github:push 0005
 ```
 
 ---
@@ -50,7 +50,7 @@ Permission Denied: GitHub writes disabled
 
 To enable: Set sync.settings.canUpdateExternalItems = true
 
-Or use read-only: /specweave-github:pull ${incrementId}
+Or use read-only: /sw-github:pull ${incrementId}
 `);
   return;
 }
@@ -111,7 +111,7 @@ URL: https://github.com/owner/repo/issues/123
 ### Example 1: Simple Push
 
 ```
-User: /specweave-github:push
+User: /sw-github:push
 
 Claude:
 Pushing to GitHub...
@@ -127,7 +127,7 @@ Push complete!
 ### Example 2: 100% Complete
 
 ```
-User: /specweave-github:push 0005
+User: /sw-github:push 0005
 
 Claude:
 Pushing to GitHub...
@@ -139,7 +139,7 @@ Updates:
   Comment: "All tasks complete!"
   Issue: CLOSED
 
-Ready for next: /specweave:done 0005
+Ready for next: /sw:done 0005
 ```
 
 ---
@@ -148,7 +148,7 @@ Ready for next: /specweave:done 0005
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-github:pull` | Pull changes from GitHub |
-| `/specweave-github:sync` | Two-way sync (pull + push) |
-| `/specweave-github:status` | Check sync status |
-| `/specweave-github:close` | Close issue with summary |
+| `/sw-github:pull` | Pull changes from GitHub |
+| `/sw-github:sync` | Two-way sync (pull + push) |
+| `/sw-github:status` | Check sync status |
+| `/sw-github:close` | Close issue with summary |

package/plugins/specweave-github/commands/reconcile.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-github:reconcile
+name: sw-github:reconcile
 description: Reconcile GitHub issue states with increment statuses. Fixes drift by closing issues for completed increments and reopening issues for resumed increments.
 ---
 
@@ -10,7 +10,7 @@ Scan all increments and fix any drift between local metadata.json status and Git
 ## Usage
 
 ```bash
-/specweave-github:reconcile [options]
+/sw-github:reconcile [options]
 ```
 
 ## Options
@@ -81,7 +81,7 @@ if (result.errors.length > 0) {
 ## Dry Run Mode
 
 ```bash
-/specweave-github:reconcile --dry-run
+/sw-github:reconcile --dry-run
 ```
 
 Shows what would be changed without making any modifications:
@@ -104,7 +104,7 @@ Shows what would be changed without making any modifications:
 
 ## Related Commands
 
-- `/specweave-github:status`: View sync status for increments
-- `/specweave-github:sync`: Manual sync to GitHub
-- `/specweave:done`: Close increment (triggers auto-close)
-- `/specweave:resume`: Resume increment (now triggers auto-reopen)
+- `/sw-github:status`: View sync status for increments
+- `/sw-github:sync`: Manual sync to GitHub
+- `/sw:done`: Close increment (triggers auto-close)
+- `/sw:resume`: Resume increment (now triggers auto-reopen)

package/plugins/specweave-github/commands/status.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-github:status
+name: sw-github:status
 description: Check GitHub sync status for SpecWeave increment. Shows issue number, sync state, progress, last update, and any sync issues. Useful for troubleshooting and monitoring.
 ---
 
@@ -10,7 +10,7 @@ Display the current GitHub sync status for a SpecWeave increment.
 ## Usage
 
 ```bash
-/specweave:github:status [increment-id] [options]
+/sw:github:status [increment-id] [options]
 ```
 
 ## Arguments
@@ -28,22 +28,22 @@ Display the current GitHub sync status for a SpecWeave increment.
 
 ```bash
 # Check current increment
-/specweave:github:status
+/sw:github:status
 
 # Check specific increment
-/specweave:github:status 0004
+/sw:github:status 0004
 
 # Check all increments
-/specweave:github:status --all
+/sw:github:status --all
 
 # Verbose output with full details
-/specweave:github:status 0004 --verbose
+/sw:github:status 0004 --verbose
 
 # JSON output for scripting
-/specweave:github:status 0004 --json
+/sw:github:status 0004 --json
 
 # Health check
-/specweave:github:status --check-health
+/sw:github:status --check-health
 ```
 
 ## Output Format
@@ -238,7 +238,7 @@ Summary:
 - Closed Issues: 2
 
 Issues:
-⚠️  Increment 0005: Not synced to GitHub (run /specweave:github:create-issue 0005)
+⚠️  Increment 0005: Not synced to GitHub (run /sw:github:create-issue 0005)
 ```
 
 ### JSON Output
@@ -359,7 +359,7 @@ plugins:
 ### 1. Quick Progress Check
 
 ```bash
-/specweave:github:status 0004
+/sw:github:status 0004
 ```
 
 See current sync state, progress, and last update time.
@@ -367,7 +367,7 @@ See current sync state, progress, and last update time.
 ### 2. Troubleshooting Sync Issues
 
 ```bash
-/specweave:github:status 0004 --verbose
+/sw:github:status 0004 --verbose
 ```
 
 Get detailed sync information to diagnose problems.
@@ -375,7 +375,7 @@ Get detailed sync information to diagnose problems.
 ### 3. Monitoring All Increments
 
 ```bash
-/specweave:github:status --all
+/sw:github:status --all
 ```
 
 Dashboard view of all increments and their sync state.
@@ -383,7 +383,7 @@ Dashboard view of all increments and their sync state.
 ### 4. CI/CD Integration
 
 ```bash
-/specweave:github:status 0004 --json | jq '.sync.status'
+/sw:github:status 0004 --json | jq '.sync.status'
 ```
 
 Check sync status in scripts/automation.
@@ -391,7 +391,7 @@ Check sync status in scripts/automation.
 ### 5. Health Monitoring
 
 ```bash
-/specweave:github:status --check-health
+/sw:github:status --check-health
 ```
 
 Verify all sync components are working correctly.
@@ -419,7 +419,7 @@ Local changes not synced to GitHub:
 - Task T-008 completed (1 hour ago)
 - Task T-009 started (30 minutes ago)
 
-Action: Run /specweave:github:sync 0004
+Action: Run /sw:github:sync 0004
 ```
 
 **Sync Failed**:
@@ -439,7 +439,7 @@ Action: Wait for rate limit reset, then retry
 No GitHub issue found for increment 0004.
 
 Action: Create issue first
-  /specweave:github:create-issue 0004
+  /sw:github:create-issue 0004
 ```
 
 ## Requirements
@@ -450,14 +450,14 @@ Action: Create issue first
 
 ## Related Commands
 
-- `/specweave:github:create-issue`: Create GitHub issue
-- `/specweave:github:sync`: Sync increment with GitHub
-- `/specweave:github:close-issue`: Close GitHub issue
-- `/specweave:progress`: Check increment progress (local only)
+- `/sw:github:create-issue`: Create GitHub issue
+- `/sw:github:sync`: Sync increment with GitHub
+- `/sw:github:close-issue`: Close GitHub issue
+- `/sw:progress`: Check increment progress (local only)
 
 ## Tips
 
-1. **Quick Check**: Run `/specweave:github:status` before syncing to see if sync is needed
+1. **Quick Check**: Run `/sw:github:status` before syncing to see if sync is needed
 
 2. **Verbose Mode**: Use `--verbose` when troubleshooting sync issues
 
@@ -475,7 +475,7 @@ Monitor sync status in real-time:
 
 ```bash
 # Refresh every 30 seconds
-watch -n 30 '/specweave:github:status 0004'
+watch -n 30 '/sw:github:status 0004'
 ```
 
 ### Custom Health Checks
@@ -520,13 +520,13 @@ plugins:
 Generate HTML dashboard:
 
 ```bash
-/specweave:github:status --all --format html > status.html
+/sw:github:status --all --format html > status.html
 open status.html
 ```
 
 ---
 
-**Command**: `/specweave:github:status`
+**Command**: `/sw:github:status`
 **Plugin**: specweave-github
 **Agent**: github-manager
 **Version**: 1.0.0