@paysdoc/devplatform 1.0.0

package/dist/providers/jira/adfConverter.js

@@ -0,0 +1,144 @@
+/**
+ * Lightweight converters between Markdown and Atlassian Document Format (ADF).
+ * Supports the most common markdown elements without external dependencies.
+ */
+/**
+ * Parses inline markdown marks (bold, italic, links) into ADF text nodes.
+ */
+function parseInlineMarks(text) {
+    const nodes = [];
+    const inlinePattern = /(\*\*(.+?)\*\*|__(.+?)__|_(.+?)_|\*(.+?)\*|\[([^\]]+)\]\(([^)]+)\))/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = inlinePattern.exec(text)) !== null) {
+        // Add plain text before the match
+        if (match.index > lastIndex) {
+            nodes.push({ type: 'text', text: text.slice(lastIndex, match.index) });
+        }
+        if (match[2] || match[3]) {
+            // Bold: **text** or __text__
+            nodes.push({ type: 'text', text: match[2] || match[3], marks: [{ type: 'strong' }] });
+        }
+        else if (match[4] || match[5]) {
+            // Italic: _text_ or *text*
+            nodes.push({ type: 'text', text: match[4] || match[5], marks: [{ type: 'em' }] });
+        }
+        else if (match[6] && match[7]) {
+            // Link: [text](url)
+            nodes.push({
+                type: 'text',
+                text: match[6],
+                marks: [{ type: 'link', attrs: { href: match[7] } }],
+            });
+        }
+        lastIndex = match.index + match[0].length;
+    }
+    // Add remaining plain text
+    if (lastIndex < text.length) {
+        nodes.push({ type: 'text', text: text.slice(lastIndex) });
+    }
+    return nodes.length > 0 ? nodes : [{ type: 'text', text }];
+}
+/**
+ * Converts a single line of markdown into ADF paragraph content nodes.
+ */
+function lineToParagraph(line) {
+    return {
+        type: 'paragraph',
+        content: parseInlineMarks(line),
+    };
+}
+/**
+ * Converts markdown text to a minimal ADF document structure.
+ * Supports paragraphs, code blocks, bold, italic, headings, bullet lists, and links.
+ */
+export function markdownToAdf(markdown) {
+    if (!markdown) {
+        return { version: 1, type: 'doc', content: [{ type: 'paragraph', content: [] }] };
+    }
+    const lines = markdown.split('\n');
+    const content = [];
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Code block: ```...```
+        if (line.startsWith('```')) {
+            const language = line.slice(3).trim() || undefined;
+            const codeLines = [];
+            i++;
+            while (i < lines.length && !lines[i].startsWith('```')) {
+                codeLines.push(lines[i]);
+                i++;
+            }
+            i++; // Skip closing ```
+            content.push({
+                type: 'codeBlock',
+                attrs: language ? { language } : {},
+                content: [{ type: 'text', text: codeLines.join('\n') }],
+            });
+            continue;
+        }
+        // Heading: # ... (h1-h6)
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            content.push({
+                type: 'heading',
+                attrs: { level: headingMatch[1].length },
+                content: parseInlineMarks(headingMatch[2]),
+            });
+            i++;
+            continue;
+        }
+        // Bullet list item: - ... or * ...
+        if (/^[-*]\s+/.test(line)) {
+            const listItems = [];
+            while (i < lines.length && /^[-*]\s+/.test(lines[i])) {
+                const itemText = lines[i].replace(/^[-*]\s+/, '');
+                listItems.push({
+                    type: 'listItem',
+                    content: [lineToParagraph(itemText)],
+                });
+                i++;
+            }
+            content.push({ type: 'bulletList', content: listItems });
+            continue;
+        }
+        // Empty line
+        if (line.trim() === '') {
+            i++;
+            continue;
+        }
+        // Default: paragraph
+        content.push(lineToParagraph(line));
+        i++;
+    }
+    if (content.length === 0) {
+        content.push({ type: 'paragraph', content: [] });
+    }
+    return { version: 1, type: 'doc', content };
+}
+/**
+ * Extracts plain text from an ADF document by recursively walking content arrays.
+ * Falls back to empty string for unknown or malformed structures.
+ */
+export function adfToPlainText(adf) {
+    if (adf === null || adf === undefined) {
+        return '';
+    }
+    if (typeof adf !== 'object') {
+        return '';
+    }
+    const node = adf;
+    // Extract text from text nodes
+    if (node.type === 'text' && typeof node.text === 'string') {
+        return node.text;
+    }
+    // Recursively process content arrays
+    if (Array.isArray(node.content)) {
+        const parts = node.content.map(child => adfToPlainText(child));
+        const separator = node.type === 'doc' || node.type === 'bulletList' ? '\n' : '';
+        return parts.join(separator);
+    }
+    return '';
+}
+//# sourceMappingURL=adfConverter.js.map

package/dist/providers/jira/adfConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adfConverter.js","sourceRoot":"","sources":["../../../src/providers/jira/adfConverter.ts"],"names":[],"mappings":"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"}

package/dist/providers/jira/index.d.ts

@@ -0,0 +1,8 @@
+export { JiraIssueTracker, createJiraIssueTracker } from './jiraIssueTracker.js';
+export type { JiraConfig } from './jiraIssueTracker.js';
+export { createJiraBoardManager } from './jiraBoardManager.js';
+export { JiraApiClient } from './jiraApiClient.js';
+export type { JiraCloudAuth, JiraDataCenterAuth, JiraAuth } from './jiraApiClient.js';
+export { markdownToAdf, adfToPlainText } from './adfConverter.js';
+export type { JiraIssueResponse, JiraCommentResponse, JiraTransition, JiraStatusCategory, JiraUser, JiraApiError, } from './jiraTypes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/jira/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/jira/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACjF,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/providers/jira/index.js

@@ -0,0 +1,5 @@
+export { JiraIssueTracker, createJiraIssueTracker } from './jiraIssueTracker.js';
+export { createJiraBoardManager } from './jiraBoardManager.js';
+export { JiraApiClient } from './jiraApiClient.js';
+export { markdownToAdf, adfToPlainText } from './adfConverter.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/jira/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/jira/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/providers/jira/jiraApiClient.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Low-level Jira REST API v3 client using native fetch().
+ * Handles authentication, request building, and error handling.
+ *
+ * Configuration is INJECTED (#818) — never read from the environment. Logs via the
+ * `Logger` port (adws/gitContext/types.ts), defaulting to `consoleLogger`.
+ * `fetchFn` is the hermetic transport test seam; production uses global fetch.
+ */
+import type { Logger } from '../../git/types.js';
+import type { JiraIssueResponse, JiraCommentResponse, JiraTransition } from './jiraTypes.js';
+export interface JiraCloudAuth {
+    readonly email: string;
+    readonly apiToken: string;
+}
+export interface JiraDataCenterAuth {
+    readonly pat: string;
+}
+export type JiraAuth = JiraCloudAuth | JiraDataCenterAuth;
+export declare function isCloudAuth(auth: JiraAuth): auth is JiraCloudAuth;
+/** Runs a fetch request, returning its Response. Production default calls global fetch; tests inject a recorder. */
+export type FetchFn = (url: string, init: RequestInit) => Promise<Response>;
+/** Deps idiom: both optional so a consumer that injects nothing gets `consoleLogger` and real `fetch`. */
+export interface JiraApiClientDeps {
+    readonly logger?: Logger;
+    readonly fetchFn?: FetchFn;
+}
+export declare class JiraApiClient {
+    private readonly instanceUrl;
+    private readonly auth;
+    private readonly logger;
+    private readonly fetchFn;
+    constructor(instanceUrl: string, auth: JiraAuth, deps?: JiraApiClientDeps);
+    private buildHeaders;
+    private request;
+    getIssue(issueKey: string): Promise<JiraIssueResponse>;
+    addComment(issueKey: string, adfBody: object): Promise<JiraCommentResponse>;
+    deleteComment(issueKey: string, commentId: string): Promise<void>;
+    getComments(issueKey: string): Promise<readonly JiraCommentResponse[]>;
+    getTransitions(issueKey: string): Promise<readonly JiraTransition[]>;
+    doTransition(issueKey: string, transitionId: string): Promise<void>;
+}
+//# sourceMappingURL=jiraApiClient.d.ts.map

package/dist/providers/jira/jiraApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraApiClient.d.ts","sourceRoot":"","sources":["../../../src/providers/jira/jiraApiClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAmB,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAEvI,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAE1D,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,aAAa,CAEjE;AAED,oHAAoH;AACpH,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5E,0GAA0G;AAC1G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAE,iBAAsB;IAO7E,OAAO,CAAC,YAAY;YAgBN,OAAO;IAgCf,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAItD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI3E,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAKtE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAKpE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1E"}

package/dist/providers/jira/jiraApiClient.js

@@ -0,0 +1,84 @@
+/**
+ * Low-level Jira REST API v3 client using native fetch().
+ * Handles authentication, request building, and error handling.
+ *
+ * Configuration is INJECTED (#818) — never read from the environment. Logs via the
+ * `Logger` port (adws/gitContext/types.ts), defaulting to `consoleLogger`.
+ * `fetchFn` is the hermetic transport test seam; production uses global fetch.
+ */
+import { consoleLogger } from '../../git/consoleLogger.js';
+export function isCloudAuth(auth) {
+    return 'email' in auth && 'apiToken' in auth;
+}
+const defaultFetch = (url, init) => fetch(url, init);
+export class JiraApiClient {
+    instanceUrl;
+    auth;
+    logger;
+    fetchFn;
+    constructor(instanceUrl, auth, deps = {}) {
+        this.instanceUrl = instanceUrl.replace(/\/+$/, '');
+        this.auth = auth;
+        this.logger = deps.logger ?? consoleLogger;
+        this.fetchFn = deps.fetchFn ?? defaultFetch;
+    }
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        };
+        if (isCloudAuth(this.auth)) {
+            const credentials = btoa(`${this.auth.email}:${this.auth.apiToken}`);
+            headers['Authorization'] = `Basic ${credentials}`;
+        }
+        else {
+            headers['Authorization'] = `Bearer ${this.auth.pat}`;
+        }
+        return headers;
+    }
+    async request(method, path, body) {
+        const url = `${this.instanceUrl}/rest/api/3/${path}`;
+        const headers = this.buildHeaders();
+        const options = { method, headers };
+        if (body !== undefined) {
+            options.body = JSON.stringify(body);
+        }
+        const response = await this.fetchFn(url, options);
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => '');
+            const message = `Jira API ${method} ${path} failed with ${response.status}: ${errorBody}`;
+            if (response.status === 429) {
+                const retryAfter = response.headers.get('Retry-After');
+                this.logger(`Jira API rate limited. Retry-After: ${retryAfter ?? 'unknown'}`, 'warn');
+            }
+            this.logger(message, 'error');
+            throw new Error(message);
+        }
+        // DELETE returns 204 with no content
+        if (response.status === 204) {
+            return undefined;
+        }
+        return response.json();
+    }
+    async getIssue(issueKey) {
+        return this.request('GET', `issue/${issueKey}?expand=renderedFields`);
+    }
+    async addComment(issueKey, adfBody) {
+        return this.request('POST', `issue/${issueKey}/comment`, { body: adfBody });
+    }
+    async deleteComment(issueKey, commentId) {
+        return this.request('DELETE', `issue/${issueKey}/comment/${commentId}`);
+    }
+    async getComments(issueKey) {
+        const page = await this.request('GET', `issue/${issueKey}/comment`);
+        return page.comments;
+    }
+    async getTransitions(issueKey) {
+        const result = await this.request('GET', `issue/${issueKey}/transitions`);
+        return result.transitions;
+    }
+    async doTransition(issueKey, transitionId) {
+        return this.request('POST', `issue/${issueKey}/transitions`, { transition: { id: transitionId } });
+    }
+}
+//# sourceMappingURL=jiraApiClient.js.map

package/dist/providers/jira/jiraApiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraApiClient.js","sourceRoot":"","sources":["../../../src/providers/jira/jiraApiClient.ts"],"names":[],"mappings":"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"}

package/dist/providers/jira/jiraBoardManager.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Jira stub implementation of the BoardManager provider interface.
+ * All methods throw — Jira board management is not yet supported.
+ */
+import type { BoardManager } from '../types.js';
+/**
+ * Factory function to create a Jira BoardManager stub.
+ * @returns A BoardManager instance that throws for all operations.
+ */
+export declare function createJiraBoardManager(): BoardManager;
+//# sourceMappingURL=jiraBoardManager.d.ts.map

package/dist/providers/jira/jiraBoardManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraBoardManager.d.ts","sourceRoot":"","sources":["../../../src/providers/jira/jiraBoardManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoBhD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAErD"}

package/dist/providers/jira/jiraBoardManager.js

@@ -0,0 +1,27 @@
+/**
+ * Jira stub implementation of the BoardManager provider interface.
+ * All methods throw — Jira board management is not yet supported.
+ */
+/**
+ * Stub BoardManager for Jira.
+ * Throws "not implemented" for all methods.
+ */
+class JiraBoardManager {
+    async findBoard() {
+        throw new Error('BoardManager not implemented for Jira');
+    }
+    async createBoard(_name) {
+        throw new Error('BoardManager not implemented for Jira');
+    }
+    async ensureColumns(_boardId) {
+        throw new Error('BoardManager not implemented for Jira');
+    }
+}
+/**
+ * Factory function to create a Jira BoardManager stub.
+ * @returns A BoardManager instance that throws for all operations.
+ */
+export function createJiraBoardManager() {
+    return new JiraBoardManager();
+}
+//# sourceMappingURL=jiraBoardManager.js.map

package/dist/providers/jira/jiraBoardManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraBoardManager.js","sourceRoot":"","sources":["../../../src/providers/jira/jiraBoardManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,gBAAgB;IACpB,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa;QAC7B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}

package/dist/providers/jira/jiraIssueTracker.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Jira IssueTracker implementation.
+ * Maps ADW's IssueTracker interface to Jira REST API v3 via JiraApiClient.
+ *
+ * Configuration is INJECTED (#818) — never read from the environment. Logs via
+ * the `Logger` port, defaulting to `consoleLogger`.
+ */
+import type { Logger } from '../../git/types.js';
+import type { IssueTracker, Issue, IssueComment, IssueSummary, IssueListEntry } from '../types.js';
+import { BoardStatus } from '../types.js';
+import { JiraApiClient, type JiraAuth, type JiraApiClientDeps } from './jiraApiClient.js';
+/** The injected configuration `createJiraIssueTracker` takes (#818); ADW's wiring supplies `auth` from `jiraAuthFromEnv()`; `instanceUrl`/`projectKey` come from the caller's own configuration, wired by `adws/core/forgeWiring.ts`. */
+export interface JiraConfig {
+    readonly instanceUrl: string;
+    readonly projectKey: string;
+    readonly auth: JiraAuth;
+}
+export declare class JiraIssueTracker implements IssueTracker {
+    private readonly client;
+    private readonly projectKey;
+    private readonly logger;
+    private readonly commentIssueMap;
+    constructor(client: JiraApiClient, projectKey: string, logger?: Logger);
+    private toJiraKey;
+    private mapStatusCategory;
+    private toIssueComment;
+    private toIssue;
+    fetchIssue(issueNumber: number): Promise<Issue>;
+    commentOnIssue(issueNumber: number, body: string): void;
+    deleteComment(commentId: string): void;
+    closeIssue(issueNumber: number, comment?: string): Promise<boolean>;
+    getIssueState(issueNumber: number): string;
+    fetchComments(issueNumber: number): IssueComment[];
+    moveToStatus(issueNumber: number, status: BoardStatus): Promise<boolean>;
+    fetchLabels(): readonly string[];
+    addLabel(): void;
+    applyLabel(): void;
+    ensureLabel(): void;
+    createIssue(): number;
+    updateIssueBody(): void;
+    searchOpenIssues(): readonly IssueSummary[];
+    findOpenUpgradeIssue(): number | null;
+    listIssues(): readonly IssueListEntry[];
+    getIssueTitle(): string;
+}
+/**
+ * Creates a JiraIssueTracker from INJECTED configuration (#818). Reads no
+ * environment; the ADW wiring in `repoContext.ts` derives `auth` from
+ * JIRA_EMAIL + JIRA_API_TOKEN (Cloud) or JIRA_PAT (Data Center/Server).
+ * `deps.logger` defaults to `consoleLogger`, `deps.fetchFn` to global fetch.
+ */
+export declare function createJiraIssueTracker(config: JiraConfig, deps?: JiraApiClientDeps): IssueTracker;
+//# sourceMappingURL=jiraIssueTracker.d.ts.map

package/dist/providers/jira/jiraIssueTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jiraIssueTracker.d.ts","sourceRoot":"","sources":["../../../src/providers/jira/jiraIssueTracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAe,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIvG,yOAAyO;AACzO,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AA0BD,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;gBAEjD,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,MAAsB;IAMrF,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,OAAO;IAiBT,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAMrD,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAYvD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAehC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCzE,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAgB1C,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IAe5C,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IA8B9E,WAAW,IAAI,SAAS,MAAM,EAAE;IAIhC,QAAQ,IAAI,IAAI;IAIhB,UAAU,IAAI,IAAI;IAIlB,WAAW,IAAI,IAAI;IAInB,WAAW,IAAI,MAAM;IAIrB,eAAe,IAAI,IAAI;IAIvB,gBAAgB,IAAI,SAAS,YAAY,EAAE;IAI3C,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAIrC,UAAU,IAAI,SAAS,cAAc,EAAE;IAIvC,aAAa,IAAI,MAAM;CAGxB;AAmBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,iBAAsB,GAAG,YAAY,CAIrG"}

package/dist/providers/jira/jiraIssueTracker.js

@@ -0,0 +1,231 @@
+/**
+ * Jira IssueTracker implementation.
+ * Maps ADW's IssueTracker interface to Jira REST API v3 via JiraApiClient.
+ *
+ * Configuration is INJECTED (#818) — never read from the environment. Logs via
+ * the `Logger` port, defaulting to `consoleLogger`.
+ */
+import { consoleLogger } from '../../git/consoleLogger.js';
+import { JiraApiClient, isCloudAuth } from './jiraApiClient.js';
+import { markdownToAdf, adfToPlainText } from './adfConverter.js';
+/** Maps Jira status category keys to ADW state strings. */
+const STATUS_CATEGORY_MAP = {
+    new: 'OPEN',
+    indeterminate: 'IN_PROGRESS',
+    done: 'CLOSED',
+};
+/**
+ * Matches a target status name against available transition names using fuzzy logic.
+ * Exact match takes priority, then substring match.
+ */
+function matchTransition(targetStatus, transitions) {
+    const target = targetStatus.toLowerCase();
+    const exact = transitions.find(t => t.name.toLowerCase() === target);
+    if (exact)
+        return exact;
+    const fuzzy = transitions.find(t => t.name.toLowerCase().includes(target));
+    return fuzzy ?? null;
+}
+export class JiraIssueTracker {
+    client;
+    projectKey;
+    logger;
+    commentIssueMap = new Map();
+    constructor(client, projectKey, logger = consoleLogger) {
+        this.client = client;
+        this.projectKey = projectKey;
+        this.logger = logger;
+    }
+    toJiraKey(issueNumber) {
+        return `${this.projectKey}-${issueNumber}`;
+    }
+    mapStatusCategory(statusCategoryKey) {
+        return STATUS_CATEGORY_MAP[statusCategoryKey] ?? statusCategoryKey.toUpperCase();
+    }
+    toIssueComment(jiraComment, issueKey) {
+        this.commentIssueMap.set(jiraComment.id, issueKey);
+        return {
+            id: jiraComment.id,
+            body: adfToPlainText(jiraComment.body),
+            author: jiraComment.author.displayName,
+            createdAt: jiraComment.created,
+        };
+    }
+    toIssue(jiraIssue) {
+        const comments = (jiraIssue.fields.comment?.comments ?? []).map(c => this.toIssueComment(c, jiraIssue.key));
+        return {
+            id: jiraIssue.key,
+            number: parseInt(jiraIssue.key.split('-').pop() ?? '0', 10),
+            title: jiraIssue.fields.summary,
+            body: adfToPlainText(jiraIssue.fields.description),
+            state: this.mapStatusCategory(jiraIssue.fields.status.statusCategory.key),
+            author: jiraIssue.fields.creator.displayName,
+            labels: [...jiraIssue.fields.labels],
+            comments,
+        };
+    }
+    async fetchIssue(issueNumber) {
+        const issueKey = this.toJiraKey(issueNumber);
+        const jiraIssue = await this.client.getIssue(issueKey);
+        return this.toIssue(jiraIssue);
+    }
+    commentOnIssue(issueNumber, body) {
+        const issueKey = this.toJiraKey(issueNumber);
+        const adfBody = markdownToAdf(body);
+        this.client.addComment(issueKey, adfBody).then(comment => {
+            this.commentIssueMap.set(comment.id, issueKey);
+            this.logger(`Commented on Jira issue ${issueKey}`, 'success');
+        }).catch(error => {
+            this.logger(`Failed to comment on Jira issue ${issueKey}: ${error}`, 'error');
+        });
+    }
+    deleteComment(commentId) {
+        const issueKey = this.commentIssueMap.get(commentId);
+        if (!issueKey) {
+            this.logger(`Cannot delete Jira comment ${commentId}: issue key not found in cache. Fetch comments first.`, 'warn');
+            return;
+        }
+        this.client.deleteComment(issueKey, commentId).then(() => {
+            this.commentIssueMap.delete(commentId);
+            this.logger(`Deleted Jira comment ${commentId} on ${issueKey}`, 'success');
+        }).catch(error => {
+            this.logger(`Failed to delete Jira comment ${commentId}: ${error}`, 'error');
+        });
+    }
+    async closeIssue(issueNumber, comment) {
+        const issueKey = this.toJiraKey(issueNumber);
+        try {
+            const jiraIssue = await this.client.getIssue(issueKey);
+            if (jiraIssue.fields.status.statusCategory.key === 'done') {
+                this.logger(`Jira issue ${issueKey} is already done, skipping`, 'info');
+                return false;
+            }
+            if (comment) {
+                const adfBody = markdownToAdf(comment);
+                await this.client.addComment(issueKey, adfBody);
+            }
+            const transitions = await this.client.getTransitions(issueKey);
+            const doneTransition = transitions.find(t => t.to.statusCategory.key === 'done');
+            if (!doneTransition) {
+                this.logger(`No "Done" transition available for Jira issue ${issueKey}`, 'warn');
+                return false;
+            }
+            await this.client.doTransition(issueKey, doneTransition.id);
+            this.logger(`Closed Jira issue ${issueKey}`, 'success');
+            return true;
+        }
+        catch (error) {
+            this.logger(`Failed to close Jira issue ${issueKey}: ${error}`, 'error');
+            return false;
+        }
+    }
+    getIssueState(issueNumber) {
+        // The interface is synchronous, but Jira requires an API call.
+        // This is a limitation — callers should use fetchIssue().state instead.
+        // For compatibility, we trigger a background fetch and return a placeholder.
+        const issueKey = this.toJiraKey(issueNumber);
+        let state = 'UNKNOWN';
+        this.client.getIssue(issueKey).then(issue => {
+            state = this.mapStatusCategory(issue.fields.status.statusCategory.key);
+        }).catch(error => {
+            this.logger(`Failed to get state for Jira issue ${issueKey}: ${error}`, 'error');
+        });
+        return state;
+    }
+    fetchComments(issueNumber) {
+        const issueKey = this.toJiraKey(issueNumber);
+        const comments = [];
+        this.client.getComments(issueKey).then(jiraComments => {
+            for (const jc of jiraComments) {
+                comments.push(this.toIssueComment(jc, issueKey));
+            }
+        }).catch(error => {
+            this.logger(`Failed to fetch comments for Jira issue ${issueKey}: ${error}`, 'error');
+        });
+        return comments;
+    }
+    async moveToStatus(issueNumber, status) {
+        const issueKey = this.toJiraKey(issueNumber);
+        try {
+            const jiraIssue = await this.client.getIssue(issueKey);
+            const currentStatus = jiraIssue.fields.status.name;
+            if (currentStatus.toLowerCase() === status.toLowerCase()) {
+                this.logger(`Jira issue ${issueKey} already in "${currentStatus}", skipping`, 'info');
+                return true;
+            }
+            const transitions = await this.client.getTransitions(issueKey);
+            const matched = matchTransition(status, transitions);
+            if (!matched) {
+                const available = transitions.map(t => t.name).join(', ');
+                this.logger(`Status "${status}" not found in available transitions for ${issueKey}. Available: ${available}`, 'warn');
+                return false;
+            }
+            await this.client.doTransition(issueKey, matched.id);
+            this.logger(`Moved Jira issue ${issueKey} to "${matched.name}"`, 'success');
+            return true;
+        }
+        catch (error) {
+            this.logger(`Failed to move Jira issue ${issueKey} to "${status}": ${error}`, 'error');
+            return false;
+        }
+    }
+    fetchLabels() {
+        throw new Error('JiraIssueTracker.fetchLabels is not implemented');
+    }
+    addLabel() {
+        throw new Error('JiraIssueTracker.addLabel is not implemented');
+    }
+    applyLabel() {
+        throw new Error('JiraIssueTracker.applyLabel is not implemented');
+    }
+    ensureLabel() {
+        throw new Error('JiraIssueTracker.ensureLabel is not implemented');
+    }
+    createIssue() {
+        throw new Error('JiraIssueTracker.createIssue is not implemented');
+    }
+    updateIssueBody() {
+        throw new Error('JiraIssueTracker.updateIssueBody is not implemented');
+    }
+    searchOpenIssues() {
+        throw new Error('JiraIssueTracker.searchOpenIssues is not implemented');
+    }
+    findOpenUpgradeIssue() {
+        throw new Error('JiraIssueTracker.findOpenUpgradeIssue is not implemented');
+    }
+    listIssues() {
+        throw new Error('JiraIssueTracker.listIssues is not implemented');
+    }
+    getIssueTitle() {
+        throw new Error('JiraIssueTracker.getIssueTitle is not implemented');
+    }
+}
+/** Throws a library-facing message when `config` is missing a required field or carries an unusable auth shape. The env-flavoured operator message lives in ADW's wiring (`repoContext.ts`), not here. */
+function validateJiraConfig(config) {
+    if (!config.instanceUrl?.trim()) {
+        throw new Error('Jira issue tracker requires a non-empty instanceUrl');
+    }
+    if (!config.projectKey?.trim()) {
+        throw new Error('Jira issue tracker requires a non-empty projectKey');
+    }
+    if (isCloudAuth(config.auth)) {
+        if (!config.auth.email?.trim() || !config.auth.apiToken?.trim()) {
+            throw new Error('Jira Cloud auth requires email and apiToken');
+        }
+    }
+    else if (!config.auth.pat?.trim()) {
+        throw new Error('Jira Data Center auth requires a pat');
+    }
+}
+/**
+ * Creates a JiraIssueTracker from INJECTED configuration (#818). Reads no
+ * environment; the ADW wiring in `repoContext.ts` derives `auth` from
+ * JIRA_EMAIL + JIRA_API_TOKEN (Cloud) or JIRA_PAT (Data Center/Server).
+ * `deps.logger` defaults to `consoleLogger`, `deps.fetchFn` to global fetch.
+ */
+export function createJiraIssueTracker(config, deps = {}) {
+    validateJiraConfig(config);
+    const client = new JiraApiClient(config.instanceUrl, config.auth, deps);
+    return new JiraIssueTracker(client, config.projectKey, deps.logger ?? consoleLogger);
+}
+//# sourceMappingURL=jiraIssueTracker.js.map