@mcp-monorepo/jira 1.2.0 → 1.4.0

package/README.md

@@ -1,12 +1,12 @@
 <!--
   DO NOT EDIT THIS FILE DIRECTLY.
   IT IS AUTOMATICALLY GENERATED.
-  Last generated: 2026-01-02T22:37:30.993Z
+  Last generated: 2026-02-18T12:57:56.494Z
 -->
 
 # @mcp-monorepo/jira
 
-![version](https://img.shields.io/badge/version-1.1.3-blue) ![repo](https://img.shields.io/badge/monorepo-source-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FCaesar2011%2Fmcp-monorepo%2Ftree%2Fmain%2Fpackages%2Fjira)
+![version](https://img.shields.io/badge/version-1.3.0-blue) ![repo](https://img.shields.io/badge/monorepo-source-blue?logo=github&link=https%3A%2F%2Fgithub.com%2FCaesar2011%2Fmcp-monorepo%2Ftree%2Fmain%2Fpackages%2Fjira)
 
 MCP server for Jira tools (JQL, issue management, etc.).
 
@@ -19,6 +19,13 @@ This package provides a set of tools for interacting with a Jira instance. It al
 - **Discovery**: List available status transitions for an issue and find recently created projects.
 - **User Information**: Retrieve the profile details of the currently authenticated user.
 
+### Authentication
+
+Two authentication modes are supported. Exactly one must be configured:
+
+- **Personal Access Token (PAT)**: Set `JIRA_TOKEN` with a valid Jira PAT.
+- **Cookie-based authentication**: Set `JIRA_COOKIE` with the raw Cookie header value from an authenticated Jira session.
+
 
 ## Usage
 
@@ -42,6 +49,8 @@ To integrate this server with a compatible AI model (like Claude), provide the f
       "env": {
         "JIRA_BASE_URL": "<Your JIRA_BASE_URL Here>",
         "JIRA_TOKEN": "<Your JIRA_TOKEN Here>",
+        "JIRA_COOKIE": "<Your JIRA_COOKIE Here>",
+        "JIRA_API_VERSION": "2",
         "JIRA_INSECURE_SKIP_VERIFY": "false"
       }
     }
@@ -54,7 +63,9 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 | Variable | Description | Default |
 | :--- | :--- | :--- |
 | `JIRA_BASE_URL` | The base URL for your Jira instance (e.g., https://your-company.atlassian.net). | `<required>` |
-| `JIRA_TOKEN` | A Jira Personal Access Token (PAT) with appropriate permissions to read and modify issues. | `<required>` |
+| `JIRA_TOKEN` | A Jira Personal Access Token (PAT) with appropriate permissions to read and modify issues. Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set. | `<optional>` |
+| `JIRA_COOKIE` | A Jira session cookie value (e.g., the full Cookie header string). Useful for environments where a PAT is not available. Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set. | `<optional>` |
+| `JIRA_API_VERSION` | The Jira REST API version to use: '2' (default) or '3'. API v3 includes: (1) Issue descriptions in Atlassian Document Format (ADF) which are automatically converted to Markdown, (2) User emailAddress may be null due to GDPR privacy settings, (3) Enhanced JQL search endpoint with nextPageToken-based pagination for better performance with large result sets. Use v3 to access newer features and ADF support for rich text formatting in issue descriptions. | `2` |
 | `JIRA_INSECURE_SKIP_VERIFY` | Set to 'true' to disable TLS certificate validation. Use with caution, as this is a security risk. Recommended only for self-hosted Jira instances with self-signed certificates. | `false` |
 
 ## Tools
@@ -72,7 +83,7 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 
 ### `execute-jql`
 
-**Execute Jira JQL** - Execute a Jira Query Language (JQL) search and return issues.
+**Execute Jira JQL** - Execute a Jira Query Language (JQL) search and return issues. In API v3, uses enhanced search with nextPageToken pagination. In API v2, uses legacy search with startAt pagination.
 
 **Input Schema**
 
@@ -80,7 +91,8 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 | :--- | :--- | :--- |
 | `jql` | `string` | JQL query string |
 | `maxResults` | `integer` | Maximum number of results to return (default: 50) |
-| `startAt` | `integer` | Index of first result for pagination (default: 0) |
+| `startAt` | `integer` | Index of first result for pagination (v2 only, default: 0) |
+| `nextPageToken` | `string` | Token for next page of results (v3 only) |
 | `fields` | `array of string` | Fields to include in results (default: [summary, status, assignee]) |
 
 
@@ -141,6 +153,75 @@ To integrate this server with a compatible AI model (like Claude), provide the f
 | `issueIdOrKey` | `string` | Jira issue key or numeric ID |
 
 
+---
+
+### `get-create-metadata`
+
+**Get Jira Create Issue Metadata** - Get metadata about fields required to create issues in a project. Returns issue types, priorities, and field requirements. Use this to find valid issueTypeId and priorityId values for creating issues.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `projectKey` | `string` | Filter by project key (e.g., "PROJ") |
+| `issueTypeId` | `string` | Filter by specific issue type ID |
+
+
+---
+
+### `create-issue`
+
+**Create Jira Issue** - Create a new Jira issue. Use get-create-metadata to find valid issueTypeId and priorityId values for your project.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `projectKey` | `string` | Project key (e.g., "PROJ") |
+| `issueTypeId` | `string` | Issue type ID (use get-create-metadata to find valid IDs) |
+| `summary` | `string` | Issue title/summary |
+| `description` | `string` | Issue description (supports Markdown formatting in API v3, plain text in v2) |
+| `assigneeId` | `string` | Assignee account ID (leave empty for unassigned) |
+| `priorityId` | `string` | Priority ID (use get-create-metadata to find valid IDs) |
+| `labels` | `array of string` | Labels for the issue |
+| `parentKey` | `string` | Parent issue key (required for creating subtasks) |
+
+
+---
+
+### `update-issue`
+
+**Update Jira Issue** - Update fields of an existing Jira issue. Only provided fields will be updated, others remain unchanged.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `issueIdOrKey` | `string` | Issue key or ID (e.g., "PROJ-123") |
+| `summary` | `string` | New issue title/summary |
+| `description` | `string` | New description (supports Markdown formatting in API v3, plain text in v2) |
+| `assigneeId` | `any` | Assignee account ID (null to unassign, undefined to leave unchanged) |
+| `priorityId` | `string` | New priority ID |
+| `labels` | `array of string` | New labels (replaces existing labels) |
+
+
+---
+
+### `add-comment`
+
+**Add Comment to Jira Issue** - Add a comment to an existing Jira issue.
+
+**Input Schema**
+
+| Property | Type | Description |
+| :--- | :--- | :--- |
+| `issueIdOrKey` | `string` | Issue key or ID (e.g., "PROJ-123") |
+| `comment` | `string` | Comment text (supports Markdown formatting in API v3, plain text in v2) |
+| `visibility` | `object` | Restrict comment visibility to a specific role or group (optional) |
+| `visibility.type` | `string` | Visibility type: role or group |
+| `visibility.value` | `string` | Role name or group name |
+
+
 ## Other MCP Servers
 
 This monorepo contains several other MCP server packages available on npm. Each provides a distinct set of tools for use with the Model Context Protocol.
@@ -150,6 +231,7 @@ This monorepo contains several other MCP server packages available on npm. Each
 - **[@mcp-monorepo/ics](https://www.npmjs.com/package/@mcp-monorepo/ics)**: MCP server for calendar tools using ICS/ical feeds
 - **[@mcp-monorepo/location](https://www.npmjs.com/package/@mcp-monorepo/location)**: MCP server for location-based tools using IP address lookup
 - **[@mcp-monorepo/mail](https://www.npmjs.com/package/@mcp-monorepo/mail)**: MCP server for mail tools (fetch, read, search, mark as seen).
+- **[@mcp-monorepo/maps](https://www.npmjs.com/package/@mcp-monorepo/maps)**: MCP server providing geospatial tools powered by the Stadia Maps API.
 - **[@mcp-monorepo/notion-query](https://www.npmjs.com/package/@mcp-monorepo/notion-query)**: MCP server for querying Notion data sources.
 - **[@mcp-monorepo/npm](https://www.npmjs.com/package/@mcp-monorepo/npm)**: MCP server for npm command tools (run scripts, install packages, list scripts)
 - **[@mcp-monorepo/slack](https://www.npmjs.com/package/@mcp-monorepo/slack)**: Slack MCP to access workspace without bot account or app
@@ -157,17 +239,17 @@ This monorepo contains several other MCP server packages available on npm. Each
 
 ## Recent Changes
 
-### Version 1.1.3
+### Version 1.3.0
 
-- fd22b00: Fixed yarn versioning during publish
+- 397cff4: add cookie-based authentication and require exactly one of JIRA_TOKEN or JIRA_COOKIE
 
-### Version 1.1.2
+### Version 1.2.0
 
-- Updated dependencies [7929a55]
+- 7f6ee0a: generate READMEs for packages via MCP introspection, add docgen and scripts, bump zod to v4 with schema fixes, improve syslog/logger graceful shutdown
 
-### Version 1.1.1
+### Version 1.1.3
 
-- 75e8973: migrate monorepo to yarn 4, update CI/husky/scripts and run-on-changed, add yarnrc and packageManager, switch internal deps to workspace:\* and simplify bin fields
+- fd22b00: Fixed yarn versioning during publish
 
 ---
 ## Authors

package/dist/index.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env node
 import { createMcpServer, logger } from '@mcp-monorepo/shared';
-import { getJiraBaseUrl, getJiraToken } from './lib/jira-env.js';
+import { getJiraApiVersion, getJiraAuthMode, getJiraBaseUrl } from './lib/jira-env.js';
 import { getCurrentProfile } from './lib/jira.service.js';
+import { registerAddCommentTool } from './tools/add-comment.js';
+import { registerCreateIssueTool } from './tools/create-issue.js';
 import { registerExecuteJqlTool } from './tools/execute-jql.js';
+import { registerGetCreateMetadataTool } from './tools/get-create-metadata.js';
 import { registerGetCurrentProfileTool } from './tools/get-current-profile.js';
 import { registerGetIssueTool } from './tools/get-issue.js';
 import { registerGetLatestProjectsTool } from './tools/get-latest-projects.js';
 import { registerGetTicketTransitionsTool } from './tools/get-ticket-transitions.js';
 import { registerSetIssueStatusTool } from './tools/set-issue-status.js';
+import { registerUpdateIssueTool } from './tools/update-issue.js';
 createMcpServer({
     name: 'jira',
     importMetaPath: import.meta.filename,
@@ -19,6 +23,10 @@ createMcpServer({
         registerGetIssueTool,
         registerSetIssueStatusTool,
         registerGetTicketTransitionsTool,
+        registerGetCreateMetadataTool,
+        registerCreateIssueTool,
+        registerUpdateIssueTool,
+        registerAddCommentTool,
     ],
     async onReady() {
         if (process.env.JIRA_INSECURE_SKIP_VERIFY === 'true') {
@@ -27,16 +35,24 @@ createMcpServer({
         }
         // Eagerly validate environment variables to fail fast on startup.
         getJiraBaseUrl();
-        getJiraToken();
+        const auth = getJiraAuthMode();
+        const apiVersion = getJiraApiVersion();
+        logger.info(`Using Jira REST API version ${apiVersion}`);
+        logger.info(`Using Jira authentication mode: ${auth.type}`);
+        if (apiVersion === '3') {
+            logger.info('API v3 features: Issue descriptions are converted from Atlassian Document Format (ADF) to Markdown. ' +
+                'User emailAddress may be null due to GDPR privacy settings. ' +
+                'JQL search uses enhanced endpoint with nextPageToken pagination.');
+        }
         // Perform a test API call to ensure credentials are valid and the service is reachable.
         try {
             logger.info('Verifying Jira connection and credentials...');
             const profile = await getCurrentProfile();
-            logger.info(`Successfully connected to Jira as "${profile.displayName}" (${profile.emailAddress}).`);
+            const emailDisplay = profile.emailAddress || '<email hidden>';
+            logger.info(`Successfully connected to Jira as "${profile.displayName}" (${emailDisplay}).`);
         }
         catch (error) {
-            logger.error('Failed to connect to Jira. Please check JIRA_BASE_URL, JIRA_TOKEN, and TLS settings.', error);
-            // Re-throw to prevent the server from starting in a bad state.
+            logger.error('Failed to connect to Jira. Please check JIRA_BASE_URL, JIRA_TOKEN/JIRA_COOKIE, and TLS settings.', error);
             throw new Error('Jira connection verification failed.');
         }
     },

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAExE,eAAe,CAAC;IACd,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE;QACL,6BAA6B;QAC7B,sBAAsB;QACtB,6BAA6B;QAC7B,oBAAoB;QACpB,0BAA0B;QAC1B,gCAAgC;KACjC;IACD,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,GAAG,CAAA;YAC9C,MAAM,CAAC,IAAI,CACT,mLAAmL,CACpL,CAAA;QACH,CAAC;QAED,kEAAkE;QAClE,cAAc,EAAE,CAAA;QAChB,YAAY,EAAE,CAAA;QAEd,wFAAwF;QACxF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAA;YACzC,MAAM,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,YAAY,IAAI,CAAC,CAAA;QACtG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sFAAsF,EAAE,KAAK,CAAC,CAAA;YAC3G,+DAA+D;YAC/D,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;CACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAA;AACpF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,eAAe,CAAC;IACd,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;IACpC,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE;QACL,6BAA6B;QAC7B,sBAAsB;QACtB,6BAA6B;QAC7B,oBAAoB;QACpB,0BAA0B;QAC1B,gCAAgC;QAChC,6BAA6B;QAC7B,uBAAuB;QACvB,uBAAuB;QACvB,sBAAsB;KACvB;IACD,KAAK,CAAC,OAAO;QACX,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,MAAM,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,GAAG,CAAA;YAC9C,MAAM,CAAC,IAAI,CACT,mLAAmL,CACpL,CAAA;QACH,CAAC;QAED,kEAAkE;QAClE,cAAc,EAAE,CAAA;QAChB,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;QAC9B,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAA;QAEtC,MAAM,CAAC,IAAI,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAA;QACxD,MAAM,CAAC,IAAI,CAAC,mCAAmC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAE3D,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,sGAAsG;gBACpG,8DAA8D;gBAC9D,kEAAkE,CACrE,CAAA;QACH,CAAC;QAED,wFAAwF;QACxF,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAA;YAC3D,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAA;YACzC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,gBAAgB,CAAA;YAC7D,MAAM,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,WAAW,MAAM,YAAY,IAAI,CAAC,CAAA;QAC9F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,kGAAkG,EAClG,KAAK,CACN,CAAA;YACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;CACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC,CAAA"}

package/dist/lib/adf-utils.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Utility functions for converting between Atlassian Document Format (ADF) and Markdown
+ */
+import { type ADFDocument } from 'extended-markdown-adf-parser';
+/**
+ * Convert ADF to Markdown string
+ * Returns undefined if input is undefined, empty string if conversion fails
+ */
+export declare function adfToMd(adf: ADFDocument | string | undefined): string | undefined;
+/**
+ * Convert Markdown string to ADF
+ * Returns undefined if input is undefined
+ */
+export declare function mdToAdf(markdown: string | undefined): ADFDocument | undefined;
+/**
+ * Check if a value is an ADF object
+ */
+export declare function isAdf(value: unknown): value is ADFDocument;
+//# sourceMappingURL=adf-utils.d.ts.map

package/dist/lib/adf-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-utils.d.ts","sourceRoot":"","sources":["../../src/lib/adf-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,KAAK,WAAW,EAA4C,MAAM,8BAA8B,CAAA;AAKzG;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUjF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAS7E;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAU1D"}

package/dist/lib/adf-utils.js

@@ -0,0 +1,52 @@
+/**
+ * Utility functions for converting between Atlassian Document Format (ADF) and Markdown
+ */
+import { logger } from '@mcp-monorepo/shared';
+import { AdfToMarkdownEngine, MarkdownToAdfEngine } from 'extended-markdown-adf-parser';
+const adfToMarkdownEngine = new AdfToMarkdownEngine();
+const markdownToAdfEngine = new MarkdownToAdfEngine();
+/**
+ * Convert ADF to Markdown string
+ * Returns undefined if input is undefined, empty string if conversion fails
+ */
+export function adfToMd(adf) {
+    if (!adf)
+        return undefined;
+    if (typeof adf === 'string')
+        return adf; // Already a string (v2 format)
+    try {
+        return adfToMarkdownEngine.convert(adf);
+    }
+    catch (error) {
+        logger.error('Failed to convert ADF to Markdown:', error);
+        return ''; // Return empty string on error
+    }
+}
+/**
+ * Convert Markdown string to ADF
+ * Returns undefined if input is undefined
+ */
+export function mdToAdf(markdown) {
+    if (!markdown)
+        return undefined;
+    try {
+        return markdownToAdfEngine.convert(markdown);
+    }
+    catch (error) {
+        logger.error('Failed to convert Markdown to ADF:', error);
+        return undefined;
+    }
+}
+/**
+ * Check if a value is an ADF object
+ */
+export function isAdf(value) {
+    return (typeof value === 'object' &&
+        // eslint-disable-next-line no-restricted-syntax
+        value != null &&
+        'type' in value &&
+        value.type === 'doc' &&
+        'version' in value &&
+        'content' in value);
+}
+//# sourceMappingURL=adf-utils.js.map

package/dist/lib/adf-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adf-utils.js","sourceRoot":"","sources":["../../src/lib/adf-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAC7C,OAAO,EAAoB,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAEzG,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA;AACrD,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAqC;IAC3D,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA,CAAC,+BAA+B;IAEvE,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,EAAE,CAAA,CAAC,+BAA+B;IAC3C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,QAA4B;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAA;IAE/B,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAgB,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,gDAAgD;QAChD,KAAK,IAAI,IAAI;QACb,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,KAAK;QACpB,SAAS,IAAI,KAAK;QAClB,SAAS,IAAI,KAAK,CACnB,CAAA;AACH,CAAC"}

package/dist/lib/jira-env.d.ts

@@ -1,7 +1,16 @@
 /**
- * Jira environment variable helpers
- * Fetches JIRA_BASE_URL and JIRA_TOKEN from process.env and throws if missing.
+ * Jira environment variable helpers.
+ * Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set.
  */
+export type JiraAuthMode = {
+    type: 'token';
+    value: string;
+} | {
+    type: 'cookie';
+    value: string;
+};
+export type JiraApiVersion = '2' | '3';
 export declare function getJiraBaseUrl(): string;
-export declare function getJiraToken(): string;
+export declare function getJiraAuthMode(): JiraAuthMode;
+export declare function getJiraApiVersion(): JiraApiVersion;
 //# sourceMappingURL=jira-env.d.ts.map

package/dist/lib/jira-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jira-env.d.ts","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAIrC"}
+{"version":3,"file":"jira-env.d.ts","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/F,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,CAAA;AAEtC,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,eAAe,IAAI,YAAY,CAY9C;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD"}

package/dist/lib/jira-env.js

@@ -1,17 +1,29 @@
 /**
- * Jira environment variable helpers
- * Fetches JIRA_BASE_URL and JIRA_TOKEN from process.env and throws if missing.
+ * Jira environment variable helpers.
+ * Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set.
  */
 export function getJiraBaseUrl() {
     const url = process.env.JIRA_BASE_URL;
     if (!url)
         throw new Error('JIRA_BASE_URL env variable is required');
-    return url.replace(/\/$/, ''); // Remove trailing slash
+    return url.replace(/\/$/, '');
 }
-export function getJiraToken() {
+export function getJiraAuthMode() {
     const token = process.env.JIRA_TOKEN;
-    if (!token)
-        throw new Error('JIRA_TOKEN env variable is required');
-    return token;
+    const cookie = process.env.JIRA_COOKIE;
+    if (token && cookie) {
+        throw new Error('Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set, but both are defined.');
+    }
+    if (!token && !cookie) {
+        throw new Error('Exactly one of JIRA_TOKEN or JIRA_COOKIE must be set, but neither is defined.');
+    }
+    return token ? { type: 'token', value: token } : { type: 'cookie', value: cookie };
+}
+export function getJiraApiVersion() {
+    const version = process.env.JIRA_API_VERSION;
+    if (version && version !== '2' && version !== '3') {
+        throw new Error('JIRA_API_VERSION must be either "2" or "3"');
+    }
+    return (version || '2'); // Default: v2
 }
 //# sourceMappingURL=jira-env.js.map

package/dist/lib/jira-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"jira-env.js","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA,CAAC,wBAAwB;AACxD,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;IACpC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IAClE,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"jira-env.js","sourceRoot":"","sources":["../../src/lib/jira-env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACnE,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAA;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;IAEtC,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;IAChG,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAgB,EAAE,CAAA;AAC9F,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAA;IAC5C,IAAI,OAAO,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,CAAC,OAAO,IAAI,GAAG,CAAmB,CAAA,CAAC,cAAc;AAC1D,CAAC"}

package/dist/lib/jira.service.d.ts

@@ -1,9 +1,36 @@
-import type { JiraIssue, JiraJqlResponse, JiraProfileResponse, JiraProjectsListResponse, JiraTransitionsResponse } from './types.js';
+import type { JiraComment, JiraCreateIssueResponse, JiraCreateMetadata, JiraEnhancedJqlResponse, JiraIssue, JiraJqlResponse, JiraProfileResponse, JiraProjectsListResponse, JiraTransitionsResponse } from './types.js';
 export declare const getIssue: (issueIdOrKey: string, fields?: string[], expand?: string[]) => Promise<JiraIssue>;
-export declare const executeJql: (jql: string, maxResults?: number, startAt?: number, fields?: string[]) => Promise<JiraJqlResponse>;
+/**
+ * Execute JQL search using enhanced search endpoint (v3) or legacy search (v2)
+ * In v3, uses /rest/api/3/search/jql with nextPageToken pagination
+ * In v2, uses /rest/api/2/search with startAt pagination
+ */
+export declare const executeJql: (jql: string, maxResults?: number, startAt?: number, fields?: string[], nextPageToken?: string) => Promise<JiraEnhancedJqlResponse> | Promise<JiraJqlResponse>;
 export declare const getLatestProjects: (maxResults?: number) => Promise<JiraProjectsListResponse>;
 export declare const getCurrentProfile: () => Promise<JiraProfileResponse>;
 export declare const getTicketTransitions: (issueIdOrKey: string) => Promise<JiraTransitionsResponse>;
 export declare const setIssueStatus: (issueIdOrKey: string, transitionId: string, comment?: string) => Promise<void>;
 export declare const findTransitionIdByName: (issueIdOrKey: string, statusName: string) => Promise<string | undefined>;
+export declare const getCreateMetadata: (projectKey?: string, issueTypeId?: string) => Promise<JiraCreateMetadata>;
+export declare const createIssue: (params: {
+    projectKey: string;
+    issueTypeId: string;
+    summary: string;
+    description?: string;
+    assigneeId?: string;
+    priorityId?: string;
+    labels?: string[];
+    parentKey?: string;
+}) => Promise<JiraCreateIssueResponse>;
+export declare const updateIssue: (issueIdOrKey: string, updates: {
+    summary?: string;
+    description?: string;
+    assigneeId?: string | null;
+    priorityId?: string;
+    labels?: string[];
+}) => Promise<void>;
+export declare const addComment: (issueIdOrKey: string, commentText: string, visibility?: {
+    type: "role" | "group";
+    value: string;
+}) => Promise<JiraComment>;
 //# sourceMappingURL=jira.service.d.ts.map

package/dist/lib/jira.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jira.service.d.ts","sourceRoot":"","sources":["../../src/lib/jira.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AA2BnB,eAAO,MAAM,QAAQ,GAAI,cAAc,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,uBAKlF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,mBAAe,EAAE,gBAAW,EAAE,SAAS,MAAM,EAAE,6BAKtF,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,mBAAe,sCAEhD,CAAA;AAED,eAAO,MAAM,iBAAiB,oCAE7B,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,qCAExD,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,EAAE,cAAc,MAAM,EAAE,UAAU,MAAM,kBAShG,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,cAAc,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAIjH,CAAA"}
+{"version":3,"file":"jira.service.d.ts","sourceRoot":"","sources":["../../src/lib/jira.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAkEnB,eAAO,MAAM,QAAQ,GAAI,cAAc,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,uBAKlF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,mBAAe,EAAE,gBAAW,EAAE,SAAS,MAAM,EAAE,EAAE,gBAAgB,MAAM,gEAqB9G,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,mBAAe,sCAIhD,CAAA;AAED,eAAO,MAAM,iBAAiB,oCAE7B,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,qCAExD,CAAA;AAED,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,EAAE,cAAc,MAAM,EAAE,UAAU,MAAM,kBAShG,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,cAAc,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAIjH,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,EAAE,cAAc,MAAM,gCAOhF,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,QAAQ;IACxC,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAG,OAAO,CAAC,uBAAuB,CA6ClC,CAAA;AAED,eAAO,MAAM,WAAW,GACtB,cAAc,MAAM,EACpB,SAAS;IACP,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB,KACA,OAAO,CAAC,IAAI,CAqCd,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,cAAc,MAAM,EACpB,aAAa,MAAM,EACnB,aAAa;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KACrD,OAAO,CAAC,WAAW,CAerB,CAAA"}