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,92 @@
+import base64, json, os, sys, urllib.parse, urllib.request, urllib.error
+
+
+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 main():
+    args = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+    board_id = str(args.get("board_id") or "").strip()
+    board_name = str(args.get("board_name") or "").strip()
+    project_key_id = str(args.get("project_key_id") or "").strip()
+    board_type = str(args.get("type") or "").strip()
+    limit = int(args.get("limit") or 50)
+    offset = int(args.get("offset") or 0)
+
+    if board_id:
+        res = request("GET", "/rest/agile/1.0/board/" + urllib.parse.quote(board_id, safe=""))
+        boards = [res]
+    else:
+        res = request("GET", "/rest/agile/1.0/board", params={
+            "name": board_name,
+            "projectKeyOrId": project_key_id,
+            "type": board_type,
+            "maxResults": limit,
+            "startAt": offset,
+        })
+        boards = res.get("values", []) or []
+
+    out = []
+    for b in boards:
+        loc = b.get("location") or {}
+        out.append({
+            "id": b.get("id") or "",
+            "name": b.get("name") or "",
+            "type": b.get("type") or "",
+            "project_id": loc.get("projectId", ""),
+            "project_name": loc.get("projectName", ""),
+        })
+
+    print(json.dumps({"boards": out}))
+
+
+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)