specweave 0.30.19 → 0.32.0

package/plugins/specweave/commands/specweave-external.md

@@ -0,0 +1,150 @@
+---
+name: specweave:external
+description: View external items dashboard - open issues from GitHub, JIRA, and Azure DevOps
+usage: /specweave:external [--refresh]
+---
+
+# External Items Dashboard
+
+**Usage**: `/specweave:external [--refresh]`
+
+---
+
+## Purpose
+
+Display a comprehensive dashboard of open external items from all configured providers:
+- **GitHub Issues** - Open issues in linked repository
+- **JIRA Tickets** - Open issues in configured project
+- **Azure DevOps Work Items** - Open work items in configured project
+
+Helps you stay aware of pending work and unaddressed items across all tools.
+
+---
+
+## Output Format
+
+```
+═══════════════════════════════════════════════════════════════
+                    External Items Dashboard
+═══════════════════════════════════════════════════════════════
+
+GitHub Issues (4 open, 2 stale)
+───────────────────────────────────────────────────────────────
+  #779     DORA Metrics Workflow Failed                  10h ago
+  #778     DORA Metrics Workflow Failed                  1d ago
+  #777     DORA Metrics Workflow Failed                  1d ago   ⚠️ stale
+  #776     DORA Metrics Workflow Failed                  3d ago   ⚠️ stale
+
+JIRA: not configured
+
+ADO: not configured
+
+───────────────────────────────────────────────────────────────
+Total: 4 open (2 stale >7d)
+Last updated: 2 minutes ago (use --refresh to update)
+```
+
+---
+
+## Options
+
+### --refresh
+
+Force refresh the cache and fetch latest data from all providers.
+
+```bash
+/specweave:external --refresh
+```
+
+---
+
+## Implementation
+
+When this command is invoked, execute the following:
+
+```typescript
+import { ExternalItemsCounter, displayDetailedDashboard } from '../src/core/external-tools/index';
+
+// Parse options
+const refresh = args.includes('--refresh');
+
+// Create counter
+const counter = new ExternalItemsCounter({
+  projectRoot: process.cwd(),
+  forceRefresh: refresh,
+});
+
+// Get summary
+const summary = await counter.getSummary();
+
+// Display dashboard
+displayDetailedDashboard(summary);
+```
+
+---
+
+## Stale Detection
+
+Items older than 7 days are marked as "stale" with ⚠️ indicator:
+
+- **Stale** = created more than 7 days ago and still open
+- Review stale items regularly to avoid accumulating technical debt
+- Close or address items promptly
+
+---
+
+## Caching
+
+- Default TTL: 15 minutes
+- Uses `.specweave/cache/external-items-summary.json`
+- Use `--refresh` to force update from APIs
+- Stale cache is used as fallback when rate limited
+
+---
+
+## Provider Configuration
+
+### GitHub
+
+Auto-detected from git remote. Requires:
+- GitHub CLI (`gh`) installed
+- Authenticated: `gh auth login`
+
+### JIRA
+
+Set environment variables:
+- `JIRA_BASE_URL` - JIRA instance URL
+- `JIRA_EMAIL` - Your email
+- `JIRA_API_TOKEN` - API token
+- `JIRA_PROJECT_KEY` - Project key (optional)
+
+### Azure DevOps
+
+Set environment variables:
+- `ADO_ORG_URL` or `AZURE_DEVOPS_ORG_URL` - Organization URL
+- `ADO_PROJECT` or `AZURE_DEVOPS_PROJECT` - Project name
+- `ADO_PAT` or `AZURE_DEVOPS_PAT` - Personal Access Token
+
+---
+
+## Integration Points
+
+External items are also shown in:
+- `/specweave:status` - Summary section at bottom
+- `/specweave:increment` - Notification after planning
+- `/specweave:progress` - Footer line
+
+---
+
+## Related Commands
+
+- `/specweave:status` - Show increment status with external items summary
+- `/specweave:progress` - Show detailed progress with external items footer
+- `/specweave:import-external` - Import external items as increments
+
+---
+
+**Command**: `/specweave:external`
+**Plugin**: specweave (core)
+**Version**: v0.31.0+
+**Part of**: Increment 0109 - External Items Dashboard

package/plugins/specweave/hooks/universal/hook-wrapper.cmd

@@ -1,26 +1,26 @@
-@echo off
-REM hook-wrapper.cmd - Windows resilient hook launcher
-REM Prevents crashes when dispatcher.mjs is temporarily unavailable
-
-setlocal enabledelayedexpansion
-
-set "HOOK_TYPE=%~1"
-if "%HOOK_TYPE%"=="" set "HOOK_TYPE=unknown"
-
-set "SCRIPT_DIR=%~dp0"
-set "DISPATCHER=%SCRIPT_DIR%dispatcher.mjs"
-
-REM Check if dispatcher exists
-if not exist "%DISPATCHER%" (
-    echo {"continue":true,"systemMessage":"Hook skipped: dispatcher.mjs not found"}
-    exit /b 0
-)
-
-REM Run dispatcher with error suppression
-node "%DISPATCHER%" "%HOOK_TYPE%" 2>nul
-if errorlevel 1 (
-    echo {"continue":true,"systemMessage":"Hook error, continuing"}
-    exit /b 0
-)
-
-exit /b 0
+@echo off
+REM hook-wrapper.cmd - Windows resilient hook launcher
+REM Prevents crashes when dispatcher.mjs is temporarily unavailable
+
+setlocal enabledelayedexpansion
+
+set "HOOK_TYPE=%~1"
+if "%HOOK_TYPE%"=="" set "HOOK_TYPE=unknown"
+
+set "SCRIPT_DIR=%~dp0"
+set "DISPATCHER=%SCRIPT_DIR%dispatcher.mjs"
+
+REM Check if dispatcher exists
+if not exist "%DISPATCHER%" (
+    echo {"continue":true,"systemMessage":"Hook skipped: dispatcher.mjs not found"}
+    exit /b 0
+)
+
+REM Run dispatcher with error suppression
+node "%DISPATCHER%" "%HOOK_TYPE%" 2>nul
+if errorlevel 1 (
+    echo {"continue":true,"systemMessage":"Hook error, continuing"}
+    exit /b 0
+)
+
+exit /b 0

package/plugins/specweave/hooks/universal/session-start.cmd

@@ -1,16 +1,16 @@
-@echo off
-:: Universal Session Start Hook for Windows
-:: Calls the Node.js dispatcher
-
-:: Find node.exe
-where node >nul 2>&1
-if %ERRORLEVEL% neq 0 (
-    echo {"continue": true, "error": "Node.js not found"}
-    exit /b 0
-)
-
-:: Get the directory of this script
-set "SCRIPT_DIR=%~dp0"
-
-:: Run the dispatcher
-node "%SCRIPT_DIR%dispatcher.mjs" session-start
+@echo off
+:: Universal Session Start Hook for Windows
+:: Calls the Node.js dispatcher
+
+:: Find node.exe
+where node >nul 2>&1
+if %ERRORLEVEL% neq 0 (
+    echo {"continue": true, "error": "Node.js not found"}
+    exit /b 0
+)
+
+:: Get the directory of this script
+set "SCRIPT_DIR=%~dp0"
+
+:: Run the dispatcher
+node "%SCRIPT_DIR%dispatcher.mjs" session-start

package/plugins/specweave/hooks/universal/session-start.ps1

@@ -1,16 +1,16 @@
-# Universal Session Start Hook for Windows PowerShell
-# Calls the Node.js dispatcher for cross-platform compatibility
-
-# Find node.exe
-$nodePath = Get-Command node -ErrorAction SilentlyContinue
-
-if (-not $nodePath) {
-    Write-Host '{"continue": true, "error": "Node.js not found"}'
-    exit 0
-}
-
-# Get script directory
-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-
-# Run the dispatcher
-& node "$scriptDir\dispatcher.mjs" session-start
+# Universal Session Start Hook for Windows PowerShell
+# Calls the Node.js dispatcher for cross-platform compatibility
+
+# Find node.exe
+$nodePath = Get-Command node -ErrorAction SilentlyContinue
+
+if (-not $nodePath) {
+    Write-Host '{"continue": true, "error": "Node.js not found"}'
+    exit 0
+}
+
+# Get script directory
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Run the dispatcher
+& node "$scriptDir\dispatcher.mjs" session-start