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>

integrations/jira/scripts/edit_issue.py

@@ -0,0 +1,159 @@
+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 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 build_fields(inputs):
+    fields = {}
+
+    summary = str(inputs.get("summary") or "").strip()
+    if summary:
+        fields["summary"] = summary
+
+    description = str(inputs.get("description") or "").strip()
+    if description:
+        fields["description"] = adf(description)
+
+    priority = str(inputs.get("priority") or "").strip()
+    if priority:
+        fields["priority"] = {"name": priority}
+
+    labels = str(inputs.get("labels") or "").strip()
+    if labels:
+        fields["labels"] = [x.strip() for x in labels.split(",") if x.strip()]
+
+    components = str(inputs.get("components") or "").strip()
+    if components:
+        fields["components"] = [{"name": c.strip()} for c in components.split(",") if c.strip()]
+
+    due_date = str(inputs.get("due_date") or "").strip()
+    if due_date:
+        fields["duedate"] = due_date
+
+    assignee_id = str(inputs.get("assignee_id") or "").strip()
+    assignee = str(inputs.get("assignee") or "").strip()
+    if assignee_id:
+        fields["assignee"] = {"accountId": assignee_id}
+    elif assignee:
+        fields["assignee"] = {"name": assignee}
+
+    fields_json = str(inputs.get("fields_json") or "").strip()
+    if fields_json:
+        extra = json.loads(fields_json)
+        if not isinstance(extra, dict):
+            raise Exception("fields_json must be a JSON object")
+        fields.update(extra)
+
+    return fields
+
+
+def find_transition(ref, status, transition):
+    res = request("GET", "/rest/api/" + _api() + "/issue/" + ref + "/transitions")
+    transitions = res.get("transitions") or []
+    if transition:
+        wanted = transition.lower()
+        for t in transitions:
+            if str(t.get("name") or "").lower() == wanted:
+                return t.get("id")
+        names = [str(t.get("name") or "") for t in transitions]
+        raise Exception("transition not found: " + transition + " — valid transitions: " + ", ".join(names))
+    wanted = status.lower()
+    for t in transitions:
+        if str((t.get("to") or {}).get("name") or "").lower() == wanted:
+            return t.get("id")
+    names = [str((t.get("to") or {}).get("name") or "") for t in transitions]
+    raise Exception("status not reachable: " + status + " — valid statuses: " + ", ".join(names))
+
+
+def main():
+    inputs = json.loads(os.environ.get("INTEGRATION_INPUTS", "{}"))
+    ref = issue_ref(inputs)
+
+    status = str(inputs.get("status") or "").strip()
+    transition = str(inputs.get("transition") or "").strip()
+    if status and transition:
+        raise Exception("provide only one of status or transition")
+
+    fields = build_fields(inputs)
+
+    if status or transition:
+        tid = find_transition(ref, status, transition)
+        body = {"transition": {"id": str(tid)}}
+        if fields:
+            body["fields"] = fields
+        request("POST", "/rest/api/" + _api() + "/issue/" + ref + "/transitions", body=body)
+    elif fields:
+        request("PUT", "/rest/api/" + _api() + "/issue/" + ref, body={"fields": fields})
+    else:
+        raise Exception("nothing to update")
+
+    res = request("GET", "/rest/api/" + _api() + "/issue/" + ref)
+    print(json.dumps(res))
+
+
+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)