@aaronsb/jira-cloud-mcp 0.2.7 → 0.3.1

package/build/utils/next-steps.js

@@ -0,0 +1,124 @@
+/**
+ * Generates contextual next-step suggestions for LLM callers.
+ * Appended to handler responses to guide multi-step workflows.
+ */
+function formatSteps(steps) {
+    const lines = ['\n---\n**Next steps:**'];
+    for (const step of steps) {
+        const tool = step.tool ? `\`${step.tool}\`` : '';
+        const example = step.example ? ` — \`${JSON.stringify(step.example)}\`` : '';
+        lines.push(`- ${step.description}${tool ? ` using ${tool}` : ''}${example}`);
+    }
+    return lines.join('\n');
+}
+export function issueNextSteps(operation, issueKey) {
+    const steps = [];
+    switch (operation) {
+        case 'create':
+            steps.push({ description: 'Transition to a new status', tool: 'manage_jira_issue', example: { operation: 'transition', issueKey, expand: ['transitions'] } }, { description: 'Add to a sprint', tool: 'manage_jira_sprint', example: { operation: 'manage_issues', sprintId: '<id>', add: [issueKey] } }, { description: 'Link to a related issue', tool: 'manage_jira_issue', example: { operation: 'link', issueKey, linkedIssueKey: '<key>', linkType: 'relates to' } }, { description: 'Read jira://custom-fields to discover available custom fields for this instance' });
+            break;
+        case 'get':
+            steps.push({ description: 'Update fields', tool: 'manage_jira_issue', example: { operation: 'update', issueKey } }, { description: 'Add a comment', tool: 'manage_jira_issue', example: { operation: 'comment', issueKey, comment: '<text>' } }, { description: 'View available transitions', tool: 'manage_jira_issue', example: { operation: 'get', issueKey, expand: ['transitions'] } });
+            break;
+        case 'update':
+            steps.push({ description: 'View the updated issue', tool: 'manage_jira_issue', example: { operation: 'get', issueKey } }, { description: 'Transition to a new status', tool: 'manage_jira_issue', example: { operation: 'get', issueKey, expand: ['transitions'] } }, { description: 'Read jira://custom-fields to discover available custom fields for this instance' });
+            break;
+        case 'transition':
+            steps.push({ description: 'Add a comment about the status change', tool: 'manage_jira_issue', example: { operation: 'comment', issueKey, comment: '<text>' } }, { description: 'View available transitions', tool: 'manage_jira_issue', example: { operation: 'get', issueKey, expand: ['transitions'] } });
+            break;
+        case 'comment':
+            steps.push({ description: 'Transition the issue', tool: 'manage_jira_issue', example: { operation: 'get', issueKey, expand: ['transitions'] } }, { description: 'Update issue fields', tool: 'manage_jira_issue', example: { operation: 'update', issueKey } });
+            break;
+        case 'delete':
+            steps.push({ description: 'Search for related issues', tool: 'manage_jira_filter', example: { operation: 'execute_jql', jql: `issue in linkedIssues("${issueKey}")` } });
+            break;
+        case 'move':
+            steps.push({ description: 'View the moved issue', tool: 'manage_jira_issue', example: { operation: 'get', issueKey } }, { description: 'Update fields for the new project context', tool: 'manage_jira_issue', example: { operation: 'update', issueKey } });
+            break;
+        case 'link':
+            steps.push({ description: 'View the linked issue', tool: 'manage_jira_issue', example: { operation: 'get', issueKey } }, { description: 'Read available link types from jira://issue-link-types resource' });
+            break;
+    }
+    return steps.length > 0 ? formatSteps(steps) : '';
+}
+export function filterNextSteps(operation, filterId, jql) {
+    const steps = [];
+    switch (operation) {
+        case 'execute_jql':
+        case 'execute_filter':
+            steps.push({ description: 'Get details on a specific issue', tool: 'manage_jira_issue', example: { operation: 'get', issueKey: '<key>', expand: ['transitions'] } }, { description: 'Refine the search with additional JQL clauses', tool: 'manage_jira_filter', example: { operation: 'execute_jql', jql: '<refined query>' } });
+            if (operation === 'execute_jql' && jql) {
+                steps.push({ description: 'Save this query as a filter', tool: 'manage_jira_filter', example: { operation: 'create', name: '<name>', jql } });
+            }
+            break;
+        case 'get':
+            steps.push({ description: 'Run this filter', tool: 'manage_jira_filter', example: { operation: 'execute_filter', filterId } }, { description: 'Update the filter', tool: 'manage_jira_filter', example: { operation: 'update', filterId } });
+            break;
+        case 'list':
+            steps.push({ description: 'Run a filter', tool: 'manage_jira_filter', example: { operation: 'execute_filter', filterId: '<id>' } }, { description: 'Search with JQL directly', tool: 'manage_jira_filter', example: { operation: 'execute_jql', jql: '<query>' } });
+            break;
+        case 'create':
+            steps.push({ description: 'Execute the new filter', tool: 'manage_jira_filter', example: { operation: 'execute_filter', filterId } });
+            break;
+    }
+    return steps.length > 0 ? formatSteps(steps) : '';
+}
+export function sprintNextSteps(operation, sprintId, boardId, state) {
+    const steps = [];
+    switch (operation) {
+        case 'create':
+            steps.push({ description: 'Add issues to the sprint', tool: 'manage_jira_sprint', example: { operation: 'manage_issues', sprintId, add: ['<issueKey>'] } }, { description: 'Start the sprint', tool: 'manage_jira_sprint', example: { operation: 'update', sprintId, state: 'active' } });
+            break;
+        case 'list':
+            steps.push({ description: 'Get sprint details', tool: 'manage_jira_sprint', example: { operation: 'get', sprintId: '<id>', expand: ['issues'] } }, { description: 'Create a new sprint', tool: 'manage_jira_sprint', example: { operation: 'create', boardId, name: '<name>' } });
+            break;
+        case 'get':
+            steps.push({ description: 'Add or remove issues', tool: 'manage_jira_sprint', example: { operation: 'manage_issues', sprintId, add: ['<issueKey>'] } });
+            if (state === 'future') {
+                steps.push({ description: 'Start the sprint', tool: 'manage_jira_sprint', example: { operation: 'update', sprintId, state: 'active' } });
+            }
+            else if (state === 'active') {
+                steps.push({ description: 'Close the sprint', tool: 'manage_jira_sprint', example: { operation: 'update', sprintId, state: 'closed' } });
+            }
+            break;
+        case 'manage_issues':
+            steps.push({ description: 'View sprint issues', tool: 'manage_jira_sprint', example: { operation: 'get', sprintId, expand: ['issues'] } });
+            if (state === 'future') {
+                steps.push({ description: 'Start the sprint', tool: 'manage_jira_sprint', example: { operation: 'update', sprintId, state: 'active' } });
+            }
+            break;
+        case 'update':
+            if (state === 'active') {
+                steps.push({ description: 'View sprint issues', tool: 'manage_jira_sprint', example: { operation: 'get', sprintId, expand: ['issues'] } }, { description: 'Close the sprint when done', tool: 'manage_jira_sprint', example: { operation: 'update', sprintId, state: 'closed' } });
+            }
+            else if (state === 'closed') {
+                steps.push({ description: 'Create the next sprint', tool: 'manage_jira_sprint', example: { operation: 'create', boardId, name: '<name>' } });
+            }
+            break;
+    }
+    return steps.length > 0 ? formatSteps(steps) : '';
+}
+export function projectNextSteps(operation, projectKey) {
+    const steps = [];
+    switch (operation) {
+        case 'list':
+            steps.push({ description: 'Get project details', tool: 'manage_jira_project', example: { operation: 'get', projectKey: '<key>' } }, { description: 'Search issues in a project', tool: 'manage_jira_filter', example: { operation: 'execute_jql', jql: `project = <key>` } });
+            break;
+        case 'get':
+            steps.push({ description: 'Search issues in this project', tool: 'manage_jira_filter', example: { operation: 'execute_jql', jql: `project = ${projectKey}` } }, { description: 'View project boards', tool: 'manage_jira_board', example: { operation: 'list' } }, { description: `Read jira://projects/${projectKey}/overview for additional context` });
+            break;
+    }
+    return steps.length > 0 ? formatSteps(steps) : '';
+}
+export function boardNextSteps(operation, boardId) {
+    const steps = [];
+    switch (operation) {
+        case 'list':
+            steps.push({ description: 'Get board details', tool: 'manage_jira_board', example: { operation: 'get', boardId: '<id>', expand: ['sprints'] } });
+            break;
+        case 'get':
+            steps.push({ description: 'View board sprints', tool: 'manage_jira_sprint', example: { operation: 'list', boardId } }, { description: `Read board overview resource at jira://boards/${boardId}/overview` });
+            break;
+    }
+    return steps.length > 0 ? formatSteps(steps) : '';
+}

package/build/utils/normalize-args.js

@@ -0,0 +1,12 @@
+/**
+ * Converts snake_case keys to camelCase.
+ * Used by all handlers to accept both naming conventions from LLM callers.
+ */
+export function normalizeArgs(args) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(args)) {
+        const camelKey = key.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+        normalized[camelKey] = value;
+    }
+    return normalized;
+}

package/build/utils/text-processing.js

@@ -2,7 +2,11 @@ import MarkdownIt from 'markdown-it';
 export class TextProcessor {
     static md = new MarkdownIt();
     static markdownToAdf(markdown) {
-        const tokens = TextProcessor.md.parse(markdown, {});
+        // Replace literal \n sequences with actual newlines so markdown-it
+        // correctly splits paragraphs. MCP JSON transport may deliver these
+        // as escaped two-character sequences rather than real newline chars.
+        const normalized = markdown.replace(/\\n/g, '\n');
+        const tokens = TextProcessor.md.parse(normalized, {});
         const content = [];
         let currentListItems = [];
         let isInList = false;

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@aaronsb/jira-cloud-mcp",
-  "version": "0.2.7",
+  "version": "0.3.1",
+  "mcpName": "io.github.aaronsb/jira-cloud",
   "description": "Model Context Protocol (MCP) server for Jira Cloud - enables AI assistants to interact with Jira",
   "type": "module",
   "bin": {
@@ -36,7 +37,7 @@
     "build": "tsc",
     "postbuild": "node --eval \"import('fs').then(fs => fs.chmodSync('build/index.js', '755'))\"",
     "prepare": "npm run build",
-    "test": "echo \"Tests will be implemented in the future\" && exit 0",
+    "test": "vitest run",
     "lint": "eslint --ext .ts src/",
     "lint:fix": "eslint --ext .ts src/ --fix",
     "watch": "tsc --watch",
@@ -46,7 +47,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
-    "jira.js": "5.2.2",
+    "jira.js": "5.3.1",
     "jsdom": "^27.3.0",
     "markdown-it": "^14.1.0"
   },
@@ -60,6 +61,7 @@
     "eslint": "^8.57.0",
     "eslint-plugin-import": "^2.32.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }