acdev 1.0.0

package/src/afterPrRules.js

@@ -0,0 +1,116 @@
+/**
+ * Best-effort post-PR ticket rules (Jira transition / GitHub label or close).
+ * Failures must never undo a successful PR open.
+ */
+
+import { normalizeGithubRules, normalizeJiraRules } from './config.js';
+import { addIssueLabel, closeIssue } from './github.js';
+import { resolveJiraCredentials, transitionJiraIssue } from './jira.js';
+
+/**
+ * @param {{
+ *   job: {
+ *     id: string,
+ *     ticketSource?: string,
+ *     jiraKey?: string,
+ *     issueNumber?: number,
+ *     worktreePath?: string,
+ *   },
+ *   config: object,
+ *   repoRoot: string,
+ *   appendLog: (job: object, type: string, payload: string) => object,
+ *   deps?: {
+ *     transitionJiraIssue?: typeof transitionJiraIssue,
+ *     addIssueLabel?: typeof addIssueLabel,
+ *     closeIssue?: typeof closeIssue,
+ *     resolveJiraCredentials?: typeof resolveJiraCredentials,
+ *   },
+ * }} params
+ * @returns {Promise<{ applied: boolean, message?: string }>}
+ */
+export async function applyAfterPrOpenedRules({
+  job,
+  config,
+  repoRoot,
+  appendLog,
+  deps = {},
+}) {
+  const doTransition = deps.transitionJiraIssue || transitionJiraIssue;
+  const doAddLabel = deps.addIssueLabel || addIssueLabel;
+  const doClose = deps.closeIssue || closeIssue;
+  const doResolveCreds = deps.resolveJiraCredentials || resolveJiraCredentials;
+
+  const source = job.ticketSource === 'jira' || job.jiraKey ? 'jira' : 'github';
+
+  try {
+    if (source === 'jira') {
+      const rules = normalizeJiraRules(config.jiraRules);
+      const rule = rules.afterPrOpened;
+      if (!rule.enabled) {
+        return { applied: false };
+      }
+      if (!job.jiraKey) {
+        const msg = 'Post-PR Jira rule skipped: job has no jiraKey';
+        console.warn(`[acdev] ${msg}`);
+        appendLog(job, 'warn', msg);
+        return { applied: false, message: msg };
+      }
+
+      const creds = doResolveCreds({ configBaseUrl: config.jiraBaseUrl });
+      if ('error' in creds) {
+        const msg = `Post-PR Jira transition failed: ${creds.error}`;
+        console.warn(`[acdev] ${msg}`);
+        appendLog(job, 'warn', msg);
+        return { applied: false, message: msg };
+      }
+
+      const result = await doTransition(job.jiraKey, rule.targetStatus, creds);
+      const msg = `Moved Jira ${result.key} to "${result.statusName}" after PR opened`;
+      appendLog(job, 'info', msg);
+      return { applied: true, message: msg };
+    }
+
+    const rules = normalizeGithubRules(config.githubRules);
+    const rule = rules.afterPrOpened;
+    if (!rule.enabled || rule.action === 'none') {
+      return { applied: false };
+    }
+
+    if (job.issueNumber == null) {
+      const msg = 'Post-PR GitHub rule skipped: job has no issueNumber';
+      console.warn(`[acdev] ${msg}`);
+      appendLog(job, 'warn', msg);
+      return { applied: false, message: msg };
+    }
+
+    const cwd = job.worktreePath || repoRoot;
+
+    if (rule.action === 'add_label') {
+      if (!rule.label) {
+        const msg = 'Post-PR GitHub rule skipped: add_label requires a label name';
+        console.warn(`[acdev] ${msg}`);
+        appendLog(job, 'warn', msg);
+        return { applied: false, message: msg };
+      }
+      await doAddLabel(job.issueNumber, rule.label, cwd);
+      const msg = `Added label "${rule.label}" to GitHub issue #${job.issueNumber} after PR opened`;
+      appendLog(job, 'info', msg);
+      return { applied: true, message: msg };
+    }
+
+    if (rule.action === 'close_issue') {
+      await doClose(job.issueNumber, cwd);
+      const msg = `Closed GitHub issue #${job.issueNumber} after PR opened`;
+      appendLog(job, 'info', msg);
+      return { applied: true, message: msg };
+    }
+
+    return { applied: false };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const msg = `Post-PR ticket rule failed (PR still opened): ${message}`;
+    console.warn(`[acdev] ${msg}`);
+    appendLog(job, 'warn', msg);
+    return { applied: false, message: msg };
+  }
+}