@anura-gate/watcher-jira 0.2.4 → 0.2.6

package/lib/gate-watcher-jira.js

@@ -209,6 +209,97 @@ class GateJiraWatcher extends EventEmitter {
     this._jiraHeaders.Authorization = `Bearer ${accessToken}`;
   }
 
+  // -- Public: Direct Jira Actions ------------------------------------
+  // Convenience methods that call the Jira API directly (no GATE queue).
+  // Useful when you want the agent to act immediately.
+
+  /**
+   * Post a comment on a Jira issue.
+   * @param {string} issueKey — e.g. "PROJ-123"
+   * @param {string} text — Comment body (plain text)
+   */
+  async postComment(issueKey, text) {
+    const res = await this._jiraPost(`/rest/api/3/issue/${issueKey}/comment`, {
+      body: {
+        type: "doc",
+        version: 1,
+        content: [{ type: "paragraph", content: [{ type: "text", text }] }],
+      },
+    });
+    if (!res.ok) throw new Error(res.data?.errorMessages?.[0] || `Failed to post comment (${res.status})`);
+    return res.data;
+  }
+
+  /**
+   * Create a new Jira issue.
+   * @param {object} opts
+   * @param {string} opts.project — Project key (e.g. "PROJ")
+   * @param {string} opts.summary — Issue title
+   * @param {string} [opts.description] — Issue description (plain text)
+   * @param {string} [opts.issueType] — Issue type (default: "Task")
+   * @param {string} [opts.priority] — Priority name (e.g. "High")
+   * @param {string} [opts.assignee] — Atlassian account ID
+   * @param {string[]} [opts.labels] — Labels
+   */
+  async createIssue(opts) {
+    const fields = {
+      project: { key: opts.project },
+      summary: opts.summary,
+      issuetype: { name: opts.issueType || "Task" },
+    };
+    if (opts.description) {
+      fields.description = {
+        type: "doc",
+        version: 1,
+        content: [{ type: "paragraph", content: [{ type: "text", text: opts.description }] }],
+      };
+    }
+    if (opts.assignee) fields.assignee = { accountId: opts.assignee };
+    if (opts.priority) fields.priority = { name: opts.priority };
+    if (opts.labels) fields.labels = opts.labels;
+
+    const res = await this._jiraPost("/rest/api/3/issue", { fields });
+    if (!res.ok) throw new Error(res.data?.errorMessages?.[0] || `Failed to create issue (${res.status})`);
+    return res.data;
+  }
+
+  /**
+   * Transition a Jira issue to a new status.
+   * @param {string} issueKey — e.g. "PROJ-123"
+   * @param {string} transitionName — Target status name (e.g. "Done", "In Progress")
+   */
+  async transitionIssue(issueKey, transitionName) {
+    const transRes = await this._jiraGet(`/rest/api/3/issue/${issueKey}/transitions`);
+    if (!transRes.ok) throw new Error("Failed to fetch transitions");
+
+    const transition = transRes.data.transitions?.find(
+      (t) => t.name.toLowerCase() === transitionName.toLowerCase()
+    );
+    if (!transition) {
+      const available = (transRes.data.transitions || []).map((t) => t.name).join(", ");
+      throw new Error(`Transition "${transitionName}" not found. Available: ${available}`);
+    }
+
+    const res = await this._jiraPost(`/rest/api/3/issue/${issueKey}/transitions`, {
+      transition: { id: transition.id },
+    });
+    if (!res.ok) throw new Error(res.data?.errorMessages?.[0] || `Failed to transition (${res.status})`);
+    return { transitioned: true, to: transitionName };
+  }
+
+  /**
+   * Assign a Jira issue.
+   * @param {string} issueKey — e.g. "PROJ-123"
+   * @param {string|null} accountId — Atlassian account ID, or null to unassign
+   */
+  async assignIssue(issueKey, accountId) {
+    const res = await this._jiraPut(`/rest/api/3/issue/${issueKey}/assignee`, {
+      accountId: accountId || null,
+    });
+    if (!res.ok) throw new Error(res.data?.errorMessages?.[0] || `Failed to assign (${res.status})`);
+    return { assigned: true, assignee: accountId };
+  }
+
   // -- Internal: Jira API -------------------------------------------
 
   _jiraUrl(path) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anura-gate/watcher-jira",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "GATE Watcher — Self-hosted Jira event monitor with OAuth 2.0. Credentials never leave your machine.",
   "main": "index.js",
   "bin": {