@softspark/jira-mcp 1.2.0 → 1.3.0

package/hooks/jira-mcp-hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "mcp__.*__add_task_comment|mcp__.*__add_templated_comment",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "jira-mcp hook comment-approval"
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softspark/jira-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP server for Jira integration — multi-instance routing, ADF formatting, task caching, and comment templates via the Model Context Protocol.",
   "keywords": [
     "mcp",
@@ -40,6 +40,8 @@
   "files": [
     "dist/*.js",
     "dist/*.d.ts",
+    "hooks/**/*.json",
+    "templates-system/**/*.md",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"

package/templates-system/comments/blocker-notification.md

@@ -0,0 +1,26 @@
+---
+{
+  "kind": "comment",
+  "id": "blocker-notification",
+  "name": "Blocker Notification",
+  "description": "Notify about a blocking issue with impact and needed action",
+  "category": "communication",
+  "variables": [
+    { "name": "blocked_by", "description": "What is causing the blockage", "required": true, "example": "Missing database credentials for staging" },
+    { "name": "impact", "description": "Impact if blocker is not resolved", "required": true, "example": "Cannot proceed with integration testing" },
+    { "name": "needed_action", "description": "What action is needed to unblock", "required": true, "example": "DevOps to provision staging DB credentials" },
+    { "name": "deadline", "description": "When this needs to be resolved", "required": false, "default": "ASAP", "example": "2026-04-15" }
+  ]
+}
+---
+## Blocker
+
+**Blocked by:** {{blocked_by}}
+
+### Impact
+{{impact}}
+
+### Action Needed
+{{needed_action}}
+
+**Deadline:** {{deadline}}

package/templates-system/comments/bug-report.md

@@ -0,0 +1,28 @@
+---
+{
+  "kind": "comment",
+  "id": "bug-report",
+  "name": "Bug Report",
+  "description": "Structured bug report with reproduction steps",
+  "category": "development",
+  "variables": [
+    { "name": "steps", "description": "Steps to reproduce", "required": true, "example": "1. Login as admin\\n2. Navigate to /settings\\n3. Click Save" },
+    { "name": "expected", "description": "Expected behavior", "required": true, "example": "Settings should be saved" },
+    { "name": "actual", "description": "Actual behavior", "required": true, "example": "Error 500 returned" },
+    { "name": "environment", "description": "Environment details", "required": false, "example": "Chrome 120, macOS 14.2" }
+  ]
+}
+---
+## Bug Report
+
+### Steps to Reproduce
+{{steps}}
+
+### Expected
+{{expected}}
+
+### Actual
+{{actual}}
+
+{{#environment}}### Environment
+{{environment}}{{/environment}}

package/templates-system/comments/deployment-note.md

@@ -0,0 +1,24 @@
+---
+{
+  "kind": "comment",
+  "id": "deployment-note",
+  "name": "Deployment Note",
+  "description": "Document a deployment with changes and rollback plan",
+  "category": "development",
+  "variables": [
+    { "name": "changes", "description": "What was deployed", "required": true, "example": "User auth module v2.1" },
+    { "name": "rollback_plan", "description": "How to rollback if needed", "required": true, "example": "Revert to tag v2.0.3" },
+    { "name": "monitoring", "description": "What to monitor after deploy", "required": false, "example": "Watch error rate on /api/auth/*" }
+  ]
+}
+---
+## Deployment Note
+
+### Changes
+{{changes}}
+
+### Rollback Plan
+{{rollback_plan}}
+
+{{#monitoring}}### Monitoring
+{{monitoring}}{{/monitoring}}

package/templates-system/comments/handoff-transition.md

@@ -0,0 +1,28 @@
+---
+{
+  "kind": "comment",
+  "id": "handoff-transition",
+  "name": "Task Handoff",
+  "description": "Provide context when handing off a task to another person",
+  "category": "workflow",
+  "variables": [
+    { "name": "from_person", "description": "Person handing off", "required": true, "example": "John" },
+    { "name": "to_person", "description": "Person receiving", "required": true, "example": "Jane" },
+    { "name": "context", "description": "Current state and context", "required": true, "example": "Auth module is 80% complete, all tests passing" },
+    { "name": "remaining_work", "description": "What still needs to be done", "required": true, "example": "Add OAuth2 provider support" },
+    { "name": "decisions", "description": "Key decisions already made", "required": false, "example": "Using JWT for session management" }
+  ]
+}
+---
+## Task Handoff
+
+**From:** {{from_person}} **To:** {{to_person}}
+
+### Context
+{{context}}
+
+### Remaining Work
+{{remaining_work}}
+
+{{#decisions}}### Key Decisions Made
+{{decisions}}{{/decisions}}

package/templates-system/comments/review-request.md

@@ -0,0 +1,26 @@
+---
+{
+  "kind": "comment",
+  "id": "review-request",
+  "name": "Review Request",
+  "description": "Request a code review with context and focus areas",
+  "category": "communication",
+  "variables": [
+    { "name": "reviewer", "description": "Who should review", "required": true, "example": "Jane" },
+    { "name": "summary", "description": "Summary of changes", "required": true, "example": "Added user authentication with JWT" },
+    { "name": "link", "description": "PR or branch link", "required": true, "example": "https://github.com/org/repo/pull/123" },
+    { "name": "focus_areas", "description": "What to focus the review on", "required": false, "example": "Security of token generation" }
+  ]
+}
+---
+## Review Request
+
+**Reviewer:** {{reviewer}}
+
+### Changes
+{{summary}}
+
+**Link:** {{link}}
+
+{{#focus_areas}}### Focus Areas
+{{focus_areas}}{{/focus_areas}}

package/templates-system/comments/sprint-update.md

@@ -0,0 +1,24 @@
+---
+{
+  "kind": "comment",
+  "id": "sprint-update",
+  "name": "Sprint Update",
+  "description": "Sprint progress report with risks and decisions needed",
+  "category": "reporting",
+  "variables": [
+    { "name": "progress", "description": "Sprint progress summary", "required": true, "example": "7 of 10 stories completed" },
+    { "name": "risks", "description": "Current risks to sprint goal", "required": true, "example": "Auth integration may slip to next sprint" },
+    { "name": "decisions_needed", "description": "Decisions that need to be made", "required": false, "example": "Should we de-scope OAuth2 support?" }
+  ]
+}
+---
+## Sprint Update
+
+### Progress
+{{progress}}
+
+### Risks
+{{risks}}
+
+{{#decisions_needed}}### Decisions Needed
+{{decisions_needed}}{{/decisions_needed}}

package/templates-system/comments/status-update.md

@@ -0,0 +1,24 @@
+---
+{
+  "kind": "comment",
+  "id": "status-update",
+  "name": "Status Update",
+  "description": "Standard status update with completed work, next steps, and blockers",
+  "category": "workflow",
+  "variables": [
+    { "name": "completed", "description": "Work completed since last update", "required": true, "example": "Implemented user authentication flow" },
+    { "name": "next_steps", "description": "Planned next steps", "required": true, "example": "Add unit tests for auth module" },
+    { "name": "blockers", "description": "Current blockers or impediments", "required": false, "default": "None", "example": "Waiting for API credentials" }
+  ]
+}
+---
+## Status Update
+
+### Completed
+{{completed}}
+
+### Next Steps
+{{next_steps}}
+
+{{#blockers}}### Blockers
+{{blockers}}{{/blockers}}

package/templates-system/comments/time-log-summary.md

@@ -0,0 +1,19 @@
+---
+{
+  "kind": "comment",
+  "id": "time-log-summary",
+  "name": "Time Log Summary",
+  "description": "Summary of work performed with time spent",
+  "category": "reporting",
+  "variables": [
+    { "name": "duration", "description": "Time spent", "required": true, "example": "2h 30m" },
+    { "name": "work_description", "description": "What was done", "required": true, "example": "Refactored authentication middleware" }
+  ]
+}
+---
+## Time Logged
+
+**Duration:** {{duration}}
+
+### Work Performed
+{{work_description}}

package/templates-system/task-templates/bug-task.md

@@ -0,0 +1,31 @@
+---
+{
+  "kind": "task",
+  "id": "bug-task",
+  "name": "Bug Task",
+  "description": "Bug issue template with structured reproduction details",
+  "summary": "Bug: {{title}}",
+  "issue_type": "Bug",
+  "priority": "High",
+  "labels": ["bug"],
+  "variables": [
+    { "name": "title", "description": "Short bug title", "required": true, "example": "Save button returns 500" },
+    { "name": "steps", "description": "Steps to reproduce", "required": true, "example": "1. Open settings\\n2. Click Save" },
+    { "name": "expected", "description": "Expected behavior", "required": true, "example": "Settings should be saved" },
+    { "name": "actual", "description": "Actual behavior", "required": true, "example": "Request fails with HTTP 500" },
+    { "name": "environment", "description": "Environment details", "required": false, "example": "Production, Chrome 123" }
+  ]
+}
+---
+## Steps To Reproduce
+{{steps}}
+
+## Expected
+{{expected}}
+
+## Actual
+{{actual}}
+
+{{#environment}}## Environment
+{{environment}}
+{{/environment}}

package/templates-system/task-templates/default-task.md

@@ -0,0 +1,23 @@
+---
+{
+  "kind": "task",
+  "id": "default-task",
+  "name": "Default Task",
+  "description": "Generic task template with summary and optional context",
+  "summary": "{{summary}}",
+  "issue_type": "Task",
+  "priority": "Medium",
+  "variables": [
+    { "name": "summary", "description": "Task summary", "required": true, "example": "Prepare April admin report" },
+    { "name": "context", "description": "Extra context for the task", "required": false, "example": "Use the latest export from Finance" },
+    { "name": "acceptance_criteria", "description": "Acceptance criteria", "required": false, "example": "- Report shared with stakeholders" }
+  ]
+}
+---
+{{#context}}## Context
+{{context}}
+{{/context}}
+
+{{#acceptance_criteria}}## Acceptance Criteria
+{{acceptance_criteria}}
+{{/acceptance_criteria}}

package/templates-system/task-templates/review-follow-up.md

@@ -0,0 +1,23 @@
+---
+{
+  "kind": "task",
+  "id": "review-follow-up",
+  "name": "Review Follow-up",
+  "description": "Follow-up task created from review findings or technical debt",
+  "summary": "Follow-up: {{summary}}",
+  "issue_type": "Task",
+  "priority": "Medium",
+  "labels": ["follow-up"],
+  "variables": [
+    { "name": "summary", "description": "Short task summary", "required": true, "example": "Harden token validation" },
+    { "name": "problem", "description": "Observed problem or risk", "required": true, "example": "Token claims are not validated consistently" },
+    { "name": "done_when", "description": "Completion criteria", "required": false, "example": "- Validation shared in one module\\n- Tests added" }
+  ]
+}
+---
+## Problem
+{{problem}}
+
+{{#done_when}}## Done When
+{{done_when}}
+{{/done_when}}