specweave 0.9.0 → 0.10.0

package/plugins/specweave-jira/skills/jira-resource-validator/SKILL.md

@@ -0,0 +1,584 @@
+---
+name: jira-resource-validator
+description: Validates Jira projects and boards exist, creates missing resources automatically. Smart enough to prompt user to select existing or create new projects. For boards, accepts either IDs (validates existence) or names (creates boards and updates .env with IDs). Activates for jira setup, jira validation, jira configuration, missing jira project, missing jira boards, jira .env setup.
+allowed-tools: Read, Bash, Write, Edit
+---
+
+# Jira Resource Validator Skill
+
+**Purpose**: Validate and auto-create Jira projects and boards, ensuring .env configuration is correct.
+
+**Auto-Activation**: Triggers when Jira setup or validation is needed.
+
+## What This Skill Does
+
+This skill ensures your Jira configuration in `.env` is valid and all resources exist. It's **smart enough** to:
+
+1. **Validate Jira projects** - Check if `JIRA_PROJECT` exists
+2. **Prompt for action** - Select existing project or create new one
+3. **Validate Jira boards** - Check if boards exist (by ID or name)
+4. **Create missing boards** - If board names provided, create them automatically
+5. **Update .env with IDs** - Replace board names with actual board IDs after creation
+
+## When This Skill Activates
+
+✅ **Automatically activates when**:
+- You set up Jira integration for the first time
+- You run `/specweave-jira:sync` and resources are missing
+- Your `.env` has invalid Jira configuration
+- You mention "jira setup" or "jira validation"
+
+## Jira Configuration Structure
+
+### Required .env Variables
+
+```bash
+JIRA_API_TOKEN=your_token_here
+JIRA_EMAIL=your_email@company.com
+JIRA_DOMAIN=yourcompany.atlassian.net
+JIRA_STRATEGY=board-based
+JIRA_PROJECT=PROJECTKEY
+JIRA_BOARDS=1,2,3  # IDs (if exist) OR names (if creating)
+```
+
+### Two Modes for JIRA_BOARDS
+
+**Mode 1: Board IDs** (boards already exist):
+```bash
+JIRA_BOARDS=1,2,3
+```
+- System validates these IDs exist in Jira
+- If any ID doesn't exist, prompts to fix configuration
+
+**Mode 2: Board Names** (boards need to be created):
+```bash
+JIRA_BOARDS=Frontend,Backend,Mobile
+```
+- System detects names (non-numeric)
+- Creates boards automatically
+- Updates .env with actual IDs: `JIRA_BOARDS=101,102,103`
+
+## Validation Flow
+
+### Step 1: Project Validation
+
+**Check if project exists**:
+```bash
+# API call to Jira
+GET /rest/api/3/project/PROJECTKEY
+```
+
+**If project exists**:
+```
+✅ Project "PROJECTKEY" exists
+   ID: 10001
+   Name: My Project
+```
+
+**If project doesn't exist**:
+```
+⚠️  Project "PROJECTKEY" not found
+
+What would you like to do?
+1. Select an existing project
+2. Create a new project
+3. Cancel
+
+Your choice [1]:
+```
+
+**Option 1: Select Existing**:
+```
+Available projects:
+1. PROJ1 - Project One
+2. PROJ2 - Project Two
+3. PROJ3 - Project Three
+
+Select a project [1]:
+
+✅ Updated .env: JIRA_PROJECT=PROJ1
+```
+
+**Option 2: Create New**:
+```
+Enter project name: My New Project
+
+📦 Creating Jira project: PROJECTKEY (My New Project)...
+✅ Project created: PROJECTKEY (ID: 10005)
+```
+
+### Step 2: Board Validation
+
+**Scenario A: Board IDs Provided** (numeric values):
+```bash
+JIRA_BOARDS=1,2,3
+```
+
+**Validation**:
+```
+Checking boards: 1,2,3...
+
+Board 1: ✅ Exists (Frontend Board)
+Board 2: ✅ Exists (Backend Board)
+Board 3: ❌ Not found
+
+⚠️  Boards not found: 3
+
+Options:
+1. Remove board 3 from configuration
+2. Replace with correct board ID
+3. Create new board
+
+Your choice [1]:
+```
+
+**Scenario B: Board Names Provided** (non-numeric):
+```bash
+JIRA_BOARDS=Frontend,Backend,Mobile
+```
+
+**Auto-creation**:
+```
+📦 Creating boards from names...
+
+Creating board: Frontend in project PROJECTKEY...
+✅ Board created: Frontend (ID: 101)
+
+Creating board: Backend in project PROJECTKEY...
+✅ Board created: Backend (ID: 102)
+
+Creating board: Mobile in project PROJECTKEY...
+✅ Board created: Mobile (ID: 103)
+
+✅ Updated .env: JIRA_BOARDS=101,102,103
+```
+
+## Usage Examples
+
+### Example 1: Fresh Jira Setup
+
+**Scenario**: New project, no Jira resources exist yet
+
+**Action**: Run `/specweave-jira:sync`
+
+**What Happens**:
+```bash
+🔍 Validating Jira configuration...
+
+Checking project: MINIDOOM...
+⚠️  Project "MINIDOOM" not found
+
+What would you like to do?
+1. Select an existing project
+2. Create a new project
+3. Cancel
+
+Your choice [2]: 2
+
+Enter project name: Mini DOOM Tournament
+
+📦 Creating Jira project: MINIDOOM (Mini DOOM Tournament)...
+✅ Project created: MINIDOOM (ID: 10005)
+
+Checking boards: Frontend,Backend,Mobile...
+📦 Creating boards from names...
+
+Creating board: Frontend in project MINIDOOM...
+✅ Board created: Frontend (ID: 101)
+
+Creating board: Backend in project MINIDOOM...
+✅ Board created: Backend (ID: 102)
+
+Creating board: Mobile in project MINIDOOM...
+✅ Board created: Mobile (ID: 103)
+
+✅ Updated .env: JIRA_BOARDS=101,102,103
+
+🎉 Jira configuration complete! All resources ready.
+```
+
+**Result**: `.env` now has correct project and board IDs
+
+### Example 2: Select Existing Project
+
+**Scenario**: Project already exists in Jira
+
+**Action**: Run validation
+
+**What Happens**:
+```bash
+🔍 Validating Jira configuration...
+
+Checking project: PROJ...
+⚠️  Project "PROJ" not found
+
+What would you like to do?
+1. Select an existing project
+2. Create a new project
+3. Cancel
+
+Your choice [1]: 1
+
+Available projects:
+1. FRONTEND - Frontend Team
+2. BACKEND - Backend Team
+3. MOBILE - Mobile Team
+
+Select a project [1]: 2
+
+✅ Updated .env: JIRA_PROJECT=BACKEND
+✅ Project "BACKEND" exists
+
+Checking boards: 45,46...
+✅ All boards exist
+```
+
+### Example 3: Mixed Board IDs (Some Exist, Some Don't)
+
+**Scenario**: Some board IDs are invalid
+
+**Action**: Run validation
+
+**What Happens**:
+```bash
+🔍 Validating Jira configuration...
+
+Checking project: PROJECTKEY...
+✅ Project "PROJECTKEY" exists
+
+Checking boards: 1,2,999...
+
+Board 1: ✅ Exists (Frontend Board)
+Board 2: ✅ Exists (Backend Board)
+Board 999: ❌ Not found
+
+⚠️  Boards not found: 999
+
+Available boards in project PROJECTKEY:
+1. Frontend Board (ID: 1)
+2. Backend Board (ID: 2)
+3. QA Board (ID: 3)
+4. DevOps Board (ID: 4)
+
+Would you like to:
+1. Remove invalid board (999) from configuration
+2. Replace with correct board ID
+3. Create new board
+
+Your choice [2]: 2
+
+Enter correct board ID or name: 3
+
+✅ Updated .env: JIRA_BOARDS=1,2,3
+```
+
+## CLI Command
+
+**Manual validation**:
+```bash
+# From TypeScript
+npx tsx src/utils/external-resource-validator.ts
+
+# Or via skill activation
+"Can you validate my Jira configuration?"
+```
+
+**Validation output**:
+```typescript
+{
+  valid: true,
+  project: {
+    exists: true,
+    key: 'PROJECTKEY',
+    id: '10001',
+    name: 'My Project'
+  },
+  boards: {
+    valid: true,
+    existing: [1, 2, 3],
+    missing: [],
+    created: []
+  },
+  envUpdated: false
+}
+```
+
+## Smart Board Creation Logic
+
+### Detection Algorithm
+
+```typescript
+// Parse JIRA_BOARDS from .env
+const boardsConfig = "Frontend,Backend,Mobile";
+const boardIds = boardsConfig.split(',').map(b => b.trim());
+
+// Check if all values are numeric
+const isNumeric = boardIds.every(b => /^\d+$/.test(b));
+
+if (isNumeric) {
+  // Mode 1: Board IDs - validate existence
+  for (const boardId of boardIds) {
+    const exists = await checkBoard(parseInt(boardId));
+    if (!exists) {
+      console.error(`Board ${boardId} not found`);
+    }
+  }
+} else {
+  // Mode 2: Board names - create boards
+  const createdBoardIds = [];
+  for (const boardName of boardIds) {
+    const board = await createBoard(boardName, projectKey);
+    createdBoardIds.push(board.id);
+  }
+
+  // Update .env with actual IDs
+  updateEnv({ JIRA_BOARDS: createdBoardIds.join(',') });
+}
+```
+
+### Board Creation API
+
+**Jira REST API** (v3):
+```bash
+POST /rest/api/3/board
+Content-Type: application/json
+
+{
+  "name": "Frontend Board",
+  "type": "scrum",
+  "filterId": 10000  # Filter for project issues
+}
+
+Response:
+{
+  "id": 101,
+  "name": "Frontend Board",
+  "type": "scrum"
+}
+```
+
+**Filter creation** (required for board):
+```bash
+POST /rest/api/3/filter
+Content-Type: application/json
+
+{
+  "name": "PROJECTKEY Issues",
+  "jql": "project = PROJECTKEY"
+}
+
+Response:
+{
+  "id": 10000
+}
+```
+
+## Configuration Examples
+
+### Example 1: Create Boards by Name
+
+**Before** (`.env`):
+```bash
+JIRA_PROJECT=PROJ
+JIRA_BOARDS=Frontend,Backend,QA,DevOps
+```
+
+**After validation**:
+```bash
+JIRA_PROJECT=PROJ
+JIRA_BOARDS=101,102,103,104
+```
+
+**What happened**:
+- Detected non-numeric values (names)
+- Created 4 boards in Jira
+- Updated .env with actual board IDs
+
+### Example 2: Validate Existing Board IDs
+
+**Before** (`.env`):
+```bash
+JIRA_PROJECT=PROJ
+JIRA_BOARDS=1,2,3
+```
+
+**After validation**:
+```bash
+JIRA_PROJECT=PROJ
+JIRA_BOARDS=1,2,3
+```
+
+**What happened**:
+- Detected numeric values (IDs)
+- Validated all boards exist
+- No changes needed
+
+### Example 3: Fix Invalid Project
+
+**Before** (`.env`):
+```bash
+JIRA_PROJECT=NONEXISTENT
+JIRA_BOARDS=1,2
+```
+
+**After validation** (user selected existing project):
+```bash
+JIRA_PROJECT=EXISTINGPROJ
+JIRA_BOARDS=1,2
+```
+
+**What happened**:
+- Project NONEXISTENT not found
+- User selected EXISTINGPROJ from list
+- Updated .env with correct project key
+
+## Error Handling
+
+### Error 1: Invalid Credentials
+
+**Symptom**: API calls fail with 401 Unauthorized
+
+**Solution**:
+```
+❌ Jira API authentication failed
+
+Please check:
+1. JIRA_API_TOKEN is correct
+2. JIRA_EMAIL matches your Jira account
+3. JIRA_DOMAIN is correct (yourcompany.atlassian.net)
+
+Generate new token at:
+https://id.atlassian.com/manage-profile/security/api-tokens
+```
+
+### Error 2: Insufficient Permissions
+
+**Symptom**: Cannot create projects/boards (403 Forbidden)
+
+**Solution**:
+```
+❌ Insufficient permissions to create resources
+
+You need:
+- Project Creator permission (for projects)
+- Board Creator permission (for boards)
+
+Contact your Jira administrator to request permissions.
+```
+
+### Error 3: Project Key Already Taken
+
+**Symptom**: Project creation fails (key exists)
+
+**Solution**:
+```
+❌ Project key "PROJ" already exists
+
+Options:
+1. Use a different project key
+2. Select the existing project
+3. Cancel
+
+Your choice [2]:
+```
+
+### Error 4: Network/API Errors
+
+**Symptom**: API calls timeout or fail
+
+**Solution**:
+```
+❌ Jira API error: Request timeout
+
+Please check:
+1. Internet connection
+2. Jira domain is correct
+3. Jira is not down (check status.atlassian.com)
+
+Retry? [Y/n]:
+```
+
+## Integration with SpecWeave Workflow
+
+### Automatic Validation
+
+When using `/specweave-jira:sync`, validation runs automatically:
+
+```bash
+/specweave-jira:sync 0014
+
+# Internally calls:
+1. validateJiraResources()
+2. Fix missing project/boards
+3. Proceed with sync
+```
+
+### Manual Validation
+
+Run validation independently:
+
+```bash
+# Via skill
+"Validate my Jira configuration"
+
+# Via TypeScript
+npx tsx src/utils/external-resource-validator.ts
+
+# Via CLI (future)
+specweave validate-jira
+```
+
+## Best Practices
+
+✅ **Use board names for initial setup**:
+```bash
+JIRA_BOARDS=Sprint-1,Sprint-2,Backlog
+```
+- System creates boards automatically
+- Updates .env with IDs
+- One-time setup, then use IDs
+
+✅ **Use board IDs after creation**:
+```bash
+JIRA_BOARDS=101,102,103
+```
+- Faster validation (no creation needed)
+- More reliable (IDs don't change)
+
+✅ **Keep .env in version control** (gitignored tokens):
+```bash
+# Commit project/board structure
+JIRA_PROJECT=PROJ
+JIRA_BOARDS=101,102,103
+
+# Don't commit sensitive data
+JIRA_API_TOKEN=<redacted>
+JIRA_EMAIL=<redacted>
+```
+
+✅ **Document board mapping** (in README):
+```markdown
+## Jira Boards
+
+- Board 101: Frontend Team
+- Board 102: Backend Team
+- Board 103: QA Team
+```
+
+## Summary
+
+This skill ensures your Jira configuration is **always valid** by:
+
+1. ✅ **Validating projects** - Check if project exists, prompt to select or create
+2. ✅ **Validating boards** - Check if boards exist (IDs) or create them (names)
+3. ✅ **Auto-updating .env** - Replace board names with IDs after creation
+4. ✅ **Clear error messages** - Actionable guidance for all failures
+5. ✅ **Non-blocking** - Graceful degradation with manual fallback
+
+**Result**: Zero manual Jira setup - system handles everything!
+
+---
+
+**Skill Version**: 1.0.0
+**Introduced**: SpecWeave v0.9.5
+**Last Updated**: 2025-11-09

package/plugins/specweave-kubernetes/.claude-plugin/plugin.json

@@ -3,6 +3,18 @@
   "description": "Kubernetes deployment and management for SpecWeave projects. Generate K8s manifests, Helm charts, and GitOps workflows. Includes security policies (NetworkPolicy, RBAC) and best practices for production deployments.",
   "version": "1.0.0",
   "author": {
-    "name": "SpecWeave Team"
-  }
+    "name": "SpecWeave Team",
+    "url": "https://spec-weave.com"
+  },
+  "homepage": "https://spec-weave.com",
+  "repository": "https://github.com/anton-abyzov/specweave",
+  "license": "MIT",
+  "keywords": [
+    "kubernetes",
+    "k8s",
+    "helm",
+    "deployment",
+    "gitops",
+    "specweave"
+  ]
 }

package/plugins/specweave-payments/.claude-plugin/plugin.json

@@ -3,6 +3,18 @@
   "description": "Payment processing integration for Stripe, PayPal, and billing automation. Includes checkout flows, subscription lifecycle management, PCI DSS compliance guidance, and recurring billing. Focus on production-ready payment systems.",
   "version": "1.0.0",
   "author": {
-    "name": "SpecWeave Team"
-  }
+    "name": "SpecWeave Team",
+    "url": "https://spec-weave.com"
+  },
+  "homepage": "https://spec-weave.com",
+  "repository": "https://github.com/anton-abyzov/specweave",
+  "license": "MIT",
+  "keywords": [
+    "payments",
+    "stripe",
+    "paypal",
+    "billing",
+    "pci-compliance",
+    "specweave"
+  ]
 }

package/plugins/specweave-testing/.claude-plugin/plugin.json

@@ -3,6 +3,18 @@
   "description": "End-to-end browser testing with Playwright. Validates user flows, captures screenshots, checks accessibility, and visual regression. Test execution infrastructure for SpecWeave increments.",
   "version": "1.0.0",
   "author": {
-    "name": "SpecWeave Team"
-  }
+    "name": "SpecWeave Team",
+    "url": "https://spec-weave.com"
+  },
+  "homepage": "https://spec-weave.com",
+  "repository": "https://github.com/anton-abyzov/specweave",
+  "license": "MIT",
+  "keywords": [
+    "testing",
+    "playwright",
+    "e2e",
+    "browser-automation",
+    "visual-regression",
+    "specweave"
+  ]
 }

package/plugins/specweave-tooling/.claude-plugin/plugin.json

@@ -3,6 +3,17 @@
   "description": "SpecWeave skill development and orchestration tools. Create new skills with proper structure, test cases, and activation triggers. Includes skill router for intelligent skill activation based on context. Meta-tooling for extending SpecWeave.",
   "version": "1.0.0",
   "author": {
-    "name": "SpecWeave Team"
-  }
+    "name": "SpecWeave Team",
+    "url": "https://spec-weave.com"
+  },
+  "homepage": "https://spec-weave.com",
+  "repository": "https://github.com/anton-abyzov/specweave",
+  "license": "MIT",
+  "keywords": [
+    "tooling",
+    "skills",
+    "skill-creation",
+    "development",
+    "specweave"
+  ]
 }