feat(jira): new Atlassian Jira integration

Jira Cloud and On-Prem/Data Center (27 commands): JQL ingestion with an OCSF mapper and JQL query, full issue lifecycle (create/get/edit/delete, transitions, assign), comments, remote web links and issue links, attachments (upload/download/delete), field and user lookups, and agile boards/sprints/epics. Basic (email + API token) or Personal Access Token authentication; API v3 + ADF bodies on Cloud, v2 on On-Prem. Stdlib-only, no extra Python dependencies. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 21:56:52 +02:00
parent da3909e79d
commit 306581e70b
30 changed files with 3207 additions and 0 deletions
@@ -0,0 +1,138 @@
+import base64, json, os, sys, urllib.parse, urllib.request, urllib.error
+import re
+
+
+def _cfg():
+    return json.loads(os.environ.get("INTEGRATION_SECRETS", "{}"))
+
+
+def _is_cloud():
+    return bool(str(_cfg().get("cloud_id") or "").strip())
+
+
+def _api():
+    return "3" if _is_cloud() else "2"
+
+
+def _base():
+    cfg = _cfg()
+    root = str(cfg.get("server_url") or "https://api.atlassian.com/ex/jira").rstrip("/")
+    cloud_id = str(cfg.get("cloud_id") or "").strip()
+    return root + "/" + cloud_id if cloud_id else root
+
+
+def _auth():
+    cfg = _cfg()
+    pat = str(cfg.get("pat") or "")
+    if pat:
+        return "Bearer " + pat
+    cred = (str(cfg.get("username") or "") + ":" + str(cfg.get("api_key") or "")).encode("utf-8")
+    return "Basic " + base64.b64encode(cred).decode("ascii")
+
+
+def request(method, path, params=None, body=None, full_url=None, raw=False):
+    url = full_url or (_base() + path)
+    q = {k: str(x) for k, x in (params or {}).items() if x not in (None, "")}
+    if q:
+        url += ("&" if "?" in url else "?") + urllib.parse.urlencode(q)
+    data = json.dumps(body).encode("utf-8") if body is not None else None
+    headers = {"Accept": "application/json", "Authorization": _auth()}
+    if data is not None:
+        headers["Content-Type"] = "application/json"
+    req = urllib.request.Request(url, data=data, headers=headers, method=method)
+    with urllib.request.urlopen(req, timeout=90) as r:
+        content = r.read()
+        if raw:
+            return content
+        return json.loads(content) if content else {}
+
+
+def issue_ref(inputs):
+    ref = str(inputs.get("issue_id") or "") or str(inputs.get("issue_key") or "")
+    if not ref:
+        raise Exception("issue_id or issue_key is required")
+    return urllib.parse.quote(ref, safe="")
+
+
+def adf(text):
+    # Jira Cloud (API v3) expects Atlassian Document Format for rich text; On-Prem (v2) takes plain text.
+    if not _is_cloud():
+        return text
+    return {"type": "doc", "version": 1,
+            "content": [{"type": "paragraph", "content": [{"type": "text", "text": text}]}]}
+
+
+def flatten_issue(issue):
+    f = issue.get("fields") or {}
+    rendered = issue.get("renderedFields") or {}
+
+    def user(u):
+        u = u or {}
+        return u.get("displayName") or u.get("name") or u.get("emailAddress") or ""
+
+    desc = rendered.get("description") or ""
+    if desc:
+        desc = re.sub(r"<[^>]+>", "", desc)
+    else:
+        d = f.get("description")
+        desc = d if isinstance(d, str) else ""
+    return {
+        "id": issue.get("id") or "",
+        "key": issue.get("key") or "",
+        "summary": f.get("summary") or "",
+        "description": desc,
+        "status": (f.get("status") or {}).get("name") or "",
+        "resolution": (f.get("resolution") or {}).get("name") or "",
+        "priority": (f.get("priority") or {}).get("name") or "",
+        "project": (f.get("project") or {}).get("name") or "",
+        "issue_type": (f.get("issuetype") or {}).get("name") or "",
+        "created": f.get("created") or "",
+        "updated": f.get("updated") or "",
+        "due_date": f.get("duedate") or "",
+        "labels": f.get("labels") or [],
+        "assignee": user(f.get("assignee")),
+        "reporter": user(f.get("reporter")),
+        "creator": user(f.get("creator")),
+        "attachments": [{"id": a.get("id"), "filename": a.get("filename"), "size": a.get("size")}
+                        for a in (f.get("attachment") or [])],
+        "url": issue.get("self") or "",
+    }
+
+
+def search_issues(jql, max_results, next_page_token=None, start_at=None):
+    params = {"jql": jql, "maxResults": max_results, "fields": "*all", "expand": "renderedFields,names"}
+    if _is_cloud() and not start_at:
+        if next_page_token:
+            params["nextPageToken"] = next_page_token
+        return request("GET", "/rest/api/3/search/jql", params=params)
+    if start_at:
+        params["startAt"] = start_at
+    return request("GET", "/rest/api/" + _api() + "/search", params=params)
+
+
+def main():
+    inputs = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+    query = str(inputs.get("query") or "").strip()
+    if not query:
+        raise Exception("query is required")
+    max_results = int(inputs.get("max_results") or 50)
+    next_page_token = str(inputs.get("next_page_token") or "") or None
+    start_at = inputs.get("start_at")
+    start_at = int(start_at) if str(start_at or "").strip() != "" else None
+
+    res = search_issues(query, max_results, next_page_token=next_page_token, start_at=start_at)
+    print(json.dumps({
+        "result": [flatten_issue(i) for i in res.get("issues", [])],
+        "next_page_token": res.get("nextPageToken", ""),
+        "total": res.get("total", 0),
+    }))
+
+
+try:
+    main()
+except urllib.error.HTTPError as e:
+    print(json.dumps({"error": "HTTP " + str(e.code), "detail": e.read().decode("utf-8", "replace")}))
+    sys.exit(1)
+except Exception as e:
+    print(json.dumps({"error": str(e)}))
+    sys.exit(1)