patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.31

package/dist/connectors/jira.js

@@ -0,0 +1,379 @@
+/**
+ * Jira connector — read/write Jira issues via Atlassian REST API v3.
+ *
+ * Auth: OAuth 2.0 (cloud) or API token + email (server/data center)
+ * Tools: fetchIssue, searchIssues, listProjects, createIssue, updateStatus, addComment
+ *
+ * Extends BaseConnector for unified auth, retry, error handling.
+ */
+import { existsSync, readFileSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { BaseConnector, } from "./baseConnector.js";
+import { getSecretJsonSync, storeSecretJsonSync } from "./tokenStorage.js";
+const JIRA_CLOUD_API = "/rest/api/3";
+const JIRA_SERVER_API = "/rest/api/2";
+export class JiraConnector extends BaseConnector {
+    providerName = "jira";
+    tokens = null;
+    getOAuthConfig() {
+        return null;
+    }
+    async authenticate() {
+        // Try loading from file first
+        const tokens = loadTokens();
+        if (!tokens) {
+            throw new Error("Jira not connected. Run: patchwork-os connect jira or set JIRA_API_TOKEN");
+        }
+        this.tokens = tokens;
+        return {
+            token: tokens.accessToken,
+            scopes: ["read:jira-work", "write:jira-work"],
+        };
+    }
+    async healthCheck() {
+        try {
+            // Lightweight check: get my permissions
+            const result = await this.apiCall(async (token) => {
+                const api = this.getApiPath();
+                const url = `${this.tokens?.instanceUrl}${api}/mypermissions`;
+                const res = await fetch(url, {
+                    headers: this.buildHeaders(token),
+                });
+                if (!res.ok)
+                    throw new Error(`HTTP ${res.status}`);
+                return res.json();
+            });
+            if ("error" in result) {
+                return { ok: false, error: result.error };
+            }
+            return { ok: true };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: this.normalizeError(err),
+            };
+        }
+    }
+    normalizeError(error) {
+        if (error instanceof Response) {
+            const status = error.status;
+            if (status === 401) {
+                return {
+                    code: "auth_expired",
+                    message: "Jira authentication expired or invalid",
+                    retryable: false,
+                    suggestedAction: "Reconnect Jira: patchwork-os connect jira",
+                };
+            }
+            if (status === 403) {
+                return {
+                    code: "permission_denied",
+                    message: "Insufficient permissions for this Jira operation",
+                    retryable: false,
+                    suggestedAction: "Check project permissions in Jira",
+                };
+            }
+            if (status === 404) {
+                return {
+                    code: "not_found",
+                    message: "Jira issue or project not found",
+                    retryable: false,
+                };
+            }
+            if (status === 429) {
+                return {
+                    code: "rate_limited",
+                    message: "Jira API rate limit exceeded",
+                    retryable: true,
+                    suggestedAction: "Wait and retry",
+                };
+            }
+            return {
+                code: "provider_error",
+                message: `Jira API error: HTTP ${status}`,
+                retryable: status >= 500,
+            };
+        }
+        if (error instanceof Error) {
+            if (error.message.includes("ENOTFOUND") ||
+                error.message.includes("ECONNREFUSED")) {
+                return {
+                    code: "network_error",
+                    message: `Cannot connect to Jira: ${error.message}`,
+                    retryable: true,
+                };
+            }
+        }
+        return {
+            code: "provider_error",
+            message: error instanceof Error ? error.message : String(error),
+            retryable: false,
+        };
+    }
+    getStatus() {
+        const tokens = loadTokens();
+        return {
+            id: "jira",
+            status: tokens ? "connected" : "disconnected",
+            lastSync: tokens?.connected_at,
+            workspace: tokens?.instanceUrl,
+        };
+    }
+    // ── API Methods ────────────────────────────────────────────────────────────
+    async fetchIssue(issueIdOrKey) {
+        const result = await this.apiCall(async (token) => {
+            const api = this.getApiPath();
+            const url = `${this.tokens?.instanceUrl}${api}/issue/${issueIdOrKey}`;
+            const res = await fetch(url, {
+                headers: this.buildHeaders(token),
+            });
+            this.updateRateLimitFromHeaders({
+                "x-ratelimit-remaining": res.headers.get("x-ratelimit-remaining") ?? undefined,
+                "retry-after": res.headers.get("retry-after") ?? undefined,
+            });
+            if (res.status === 404)
+                return null;
+            if (!res.ok)
+                throw res;
+            return res.json();
+        });
+        if ("error" in result) {
+            throw new Error(result.error.message);
+        }
+        return result.data;
+    }
+    async searchIssues(jql, maxResults = 50) {
+        const result = await this.apiCall(async (token) => {
+            const api = this.getApiPath();
+            const params = new URLSearchParams({
+                jql,
+                maxResults: String(maxResults),
+                fields: "summary,status,issuetype,priority,assignee,reporter,created,updated,labels",
+            });
+            const url = `${this.tokens?.instanceUrl}${api}/search?${params}`;
+            const res = await fetch(url, {
+                headers: this.buildHeaders(token),
+            });
+            if (!res.ok)
+                throw res;
+            return res.json();
+        });
+        if ("error" in result) {
+            throw new Error(result.error.message);
+        }
+        return result.data;
+    }
+    async listProjects() {
+        const result = await this.apiCall(async (token) => {
+            const api = this.getApiPath();
+            const url = `${this.tokens?.instanceUrl}${api}/project`;
+            const res = await fetch(url, {
+                headers: this.buildHeaders(token),
+            });
+            if (!res.ok)
+                throw res;
+            return res.json();
+        });
+        if ("error" in result) {
+            throw new Error(result.error.message);
+        }
+        return result.data;
+    }
+    async createIssue(params) {
+        const result = await this.apiCall(async (token) => {
+            const api = this.getApiPath();
+            const url = `${this.tokens?.instanceUrl}${api}/issue`;
+            const body = {
+                fields: {
+                    project: { key: params.projectKey },
+                    summary: params.summary,
+                    issuetype: { name: params.issueType ?? "Bug" },
+                },
+            };
+            if (params.description) {
+                // Atlassian Document Format (ADF) for cloud, plain text for server
+                if (this.tokens?.isCloud) {
+                    body.fields.description = {
+                        type: "doc",
+                        version: 1,
+                        content: [
+                            {
+                                type: "paragraph",
+                                content: [{ type: "text", text: params.description }],
+                            },
+                        ],
+                    };
+                }
+                else {
+                    body.fields.description =
+                        params.description;
+                }
+            }
+            if (params.priority) {
+                body.fields.priority = {
+                    name: params.priority,
+                };
+            }
+            if (params.labels) {
+                body.fields.labels = params.labels;
+            }
+            if (params.assignee) {
+                if (this.tokens?.isCloud) {
+                    body.fields.assignee = {
+                        accountId: params.assignee,
+                    };
+                }
+                else {
+                    body.fields.assignee = {
+                        name: params.assignee,
+                    };
+                }
+            }
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    ...this.buildHeaders(token),
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+            if (!res.ok)
+                throw res;
+            return res.json();
+        });
+        if ("error" in result) {
+            throw new Error(result.error.message);
+        }
+        return result.data;
+    }
+    async updateStatus(issueIdOrKey, transitionId) {
+        const result = await this.apiCall(async (token) => {
+            const api = this.getApiPath();
+            const url = `${this.tokens?.instanceUrl}${api}/issue/${issueIdOrKey}/transitions`;
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    ...this.buildHeaders(token),
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ transition: { id: transitionId } }),
+            });
+            if (!res.ok)
+                throw res;
+            return { ok: true };
+        });
+        if ("error" in result) {
+            throw new Error(result.error.message);
+        }
+    }
+    async addComment(issueIdOrKey, body) {
+        const result = await this.apiCall(async (token) => {
+            const api = this.getApiPath();
+            const url = `${this.tokens?.instanceUrl}${api}/issue/${issueIdOrKey}/comment`;
+            let commentBody;
+            if (this.tokens?.isCloud) {
+                commentBody = {
+                    type: "doc",
+                    version: 1,
+                    content: [
+                        { type: "paragraph", content: [{ type: "text", text: body }] },
+                    ],
+                };
+            }
+            else {
+                commentBody = body;
+            }
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    ...this.buildHeaders(token),
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ body: commentBody }),
+            });
+            if (!res.ok)
+                throw res;
+            return { ok: true };
+        });
+        if ("error" in result) {
+            throw new Error(result.error.message);
+        }
+    }
+    // ── Helpers ────────────────────────────────────────────────────────────────
+    getApiPath() {
+        return this.tokens?.isCloud ? JIRA_CLOUD_API : JIRA_SERVER_API;
+    }
+    buildHeaders(token) {
+        if (this.tokens?.isCloud) {
+            return {
+                Authorization: `Bearer ${token}`,
+                Accept: "application/json",
+            };
+        }
+        else {
+            // Server/Data Center uses Basic auth with email:token
+            const email = this.tokens?.email ?? "api";
+            const basic = Buffer.from(`${email}:${token}`).toString("base64");
+            return {
+                Authorization: `Basic ${basic}`,
+                Accept: "application/json",
+            };
+        }
+    }
+}
+// ── Token persistence ────────────────────────────────────────────────────────
+function getLegacyTokenPath() {
+    const patchworkHome = process.env.PATCHWORK_HOME ?? path.join(homedir(), ".patchwork");
+    return path.join(patchworkHome, "tokens", "jira.json");
+}
+export function loadTokens() {
+    // Environment variable override
+    const envToken = process.env.JIRA_API_TOKEN;
+    const envUrl = process.env.JIRA_INSTANCE_URL;
+    if (envToken && envUrl) {
+        return {
+            accessToken: envToken,
+            instanceUrl: envUrl.replace(/\/$/, ""), // strip trailing slash
+            isCloud: envUrl.includes("atlassian.net"),
+            connected_at: new Date().toISOString(),
+            email: process.env.JIRA_EMAIL,
+        };
+    }
+    const secure = getSecretJsonSync("jira");
+    if (secure) {
+        return secure;
+    }
+    const legacyTokenPath = getLegacyTokenPath();
+    if (!existsSync(legacyTokenPath))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(legacyTokenPath, "utf-8"));
+        saveTokens(data);
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveTokens(tokens) {
+    storeSecretJsonSync("jira", tokens);
+    const legacyTokenPath = getLegacyTokenPath();
+    if (existsSync(legacyTokenPath)) {
+        try {
+            unlinkSync(legacyTokenPath);
+        }
+        catch { }
+    }
+}
+// ── Singleton instance ───────────────────────────────────────────────────────
+let _instance = null;
+export function getJiraConnector() {
+    if (!_instance) {
+        _instance = new JiraConnector();
+    }
+    return _instance;
+}
+export { getJiraConnector as jira };
+//# sourceMappingURL=jira.js.map

package/dist/connectors/jira.js.map

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

package/dist/connectors/linear.d.ts

@@ -1,14 +1,17 @@
 /**
- * Linear connector.
+ * Linear connector — routes through Linear's official MCP server.
  *
- * Uses Linear's GraphQL API with a personal API key (no OAuth app required).
- * Token stored at ~/.patchwork/tokens/linear.json (mode 0600).
- * Env var: LINEAR_API_KEY
+ * Endpoint: https://mcp.linear.app/mcp
+ * Auth:     OAuth 2.1 w/ PKCE; dynamic client registration (RFC 7591).
  *
- * HTTP routes registered in server.ts:
- *   POST   /connections/linear/connect   — store token + verify
- *   POST   /connections/linear/test      — verify stored token works
- *   DELETE /connections/linear           — delete stored token
+ * HTTP routes (wired in src/server.ts):
+ *   GET    /connections/linear/authorize — returns { url } for popup
+ *   GET    /connections/linear/callback  — token exchange
+ *   POST   /connections/linear/test      — ping MCP server
+ *   DELETE /connections/linear           — revoke + delete token
+ *
+ * Back-compat: loadTokens() returns a shape compatible with legacy code
+ * that expected { api_key }. Set LINEAR_API_KEY to bypass OAuth for CI/headless.
  */
 export interface LinearTokens {
     api_key: string;
@@ -21,9 +24,14 @@ export interface ConnectorStatus {
     lastSync?: string;
     workspace?: string;
 }
+export interface ConnectorHandlerResult {
+    status: number;
+    body: string;
+    contentType?: string;
+    redirect?: string;
+}
 export declare function loadTokens(): LinearTokens | null;
 export declare function getStatus(): ConnectorStatus;
-export declare function linearQuery<T>(query: string, variables: Record<string, unknown>, apiKey: string, signal?: AbortSignal): Promise<T>;
 export interface LinearIssue {
     id: string;
     identifier: string;
@@ -52,16 +60,58 @@ export interface LinearIssue {
         }>;
     };
 }
-/**
- * Fetch a Linear issue by ID or URL.
- * Accepts: "LIN-123", "abc123def456...", "https://linear.app/.../issue/LIN-123/..."
- */
 export declare function fetchIssue(issueIdOrUrl: string, signal?: AbortSignal): Promise<LinearIssue>;
-export interface ConnectorHandlerResult {
-    status: number;
-    body: string;
-    contentType?: string;
+export interface ListLinearIssuesOpts {
+    team?: string;
+    assigneeMe?: boolean;
+    states?: string[];
+    limit?: number;
 }
-export declare function handleLinearConnect(body: unknown): Promise<ConnectorHandlerResult>;
+export declare function listIssues(opts?: ListLinearIssuesOpts, signal?: AbortSignal): Promise<Record<string, unknown>[]>;
+export declare function handleLinearAuthorize(): Promise<ConnectorHandlerResult>;
+export declare function handleLinearCallback(code: string | null, state: string | null, error: string | null): Promise<ConnectorHandlerResult>;
 export declare function handleLinearTest(): Promise<ConnectorHandlerResult>;
-export declare function handleLinearDisconnect(): ConnectorHandlerResult;
+export declare function handleLinearDisconnect(): Promise<ConnectorHandlerResult>;
+export interface LinearTeam {
+    id: string;
+    key: string;
+    name: string;
+}
+export declare function listTeams(signal?: AbortSignal): Promise<LinearTeam[]>;
+export declare function listLabels(signal?: AbortSignal): Promise<Array<{
+    id: string;
+    name: string;
+}>>;
+export interface CreateIssueInput {
+    team: string;
+    title: string;
+    description?: string;
+    priority?: number;
+    labels?: string[];
+}
+export interface UpdateIssueInput {
+    id: string;
+    title?: string;
+    description?: string;
+    priority?: number;
+    state?: string;
+    assignee?: string;
+    labels?: string[];
+}
+type SaveIssueResult = {
+    id: string;
+    identifier: string;
+    title: string;
+    url: string;
+    state?: {
+        name: string;
+    };
+};
+export declare function createIssue(input: CreateIssueInput, signal?: AbortSignal): Promise<SaveIssueResult>;
+export declare function updateIssue(input: UpdateIssueInput, signal?: AbortSignal): Promise<SaveIssueResult>;
+export declare function addComment(issueId: string, body: string, signal?: AbortSignal): Promise<{
+    id: string;
+    body: string;
+    url?: string;
+}>;
+export {};