@jira-deploy/core 1.0.0

package/tools/jabber.js

@@ -0,0 +1,97 @@
+/**
+ * Jabber 通知工具
+ *   - send_jabber_message  發送訊息到 Jabber MUC 群組或個人
+ */
+import {execFile} from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import {error, ok} from './helpers.js';
+
+function getDefaultScriptPath() {
+  const candidates = [
+    path.resolve(process.cwd(), 'packages/jira-core/scripts/jabber_notify.py'),
+    path.resolve(process.cwd(), 'scripts/jabber_notify.py'),
+  ];
+  return candidates.find((candidate) => fs.existsSync(candidate)) ?? candidates[0];
+}
+
+// ── Schema definitions ───────────────────────────────────────────
+export function getJabberToolDefinitions() {
+  return [
+    {
+      name: 'send_jabber_message',
+      description:
+        '發送訊息到 Jabber。可傳給個人（to 參數，格式 BK00xxx@linebank.com.tw）或 MUC 群組（room 參數）。' +
+        '若 to/room 都未提供，則使用環境變數 JABBER_TO 或 JABBER_ROOM。' +
+        '用於上版通知、請主管簽單、上版完成公告等。',
+      inputSchema: {
+        type: 'object',
+        required: ['message'],
+        properties: {
+          message: {
+            type: 'string',
+            description: '要發送的訊息內容，支援純文字',
+          },
+          to: {
+            type: 'string',
+            description: '直接傳給個人的 JID，例如 BK00178@linebank.com.tw',
+          },
+          room: {
+            type: 'string',
+            description: 'MUC 群組 JID，例如 webqa@conference.linebank.com.tw',
+          },
+        },
+      },
+    },
+  ];
+}
+
+// ── Handler ───────────────────────────────────────────────────────
+
+export async function handleSendJabberMessage(args, _ctx) {
+  const scriptPath = process.env.JABBER_NOTIFY_SCRIPT ?? getDefaultScriptPath();
+
+  // dryRun 模式：不實際發送，直接回傳預覽
+  if (args.dryRun) {
+    return ok({
+      sent: false,
+      dryRun: true,
+      message: args.message,
+      to: args.to ?? process.env.JABBER_TO ?? '(JABBER_TO not set)',
+      room: args.room ?? process.env.JABBER_ROOM,
+      preview: `[DRY RUN] 將發送 Jabber 給 ${args.to ?? process.env.JABBER_TO ?? '?'}: ${args.message}`,
+    });
+  }
+
+  // 允許透過 tool 參數覆蓋 JABBER_TO / JABBER_ROOM
+  const env = {...process.env};
+  if (args.to) env.JABBER_TO = args.to;
+  if (args.room) env.JABBER_ROOM = args.room;
+
+  return new Promise((resolve) => {
+    execFile(
+      'python3',
+      [scriptPath, args.message],
+      {timeout: 30000, env},
+      (err, _stdout, stderr) => {
+        if (err) {
+          resolve(
+            error(
+              `Jabber 發送失敗: ${err.message}` +
+              (stderr ? ` (stderr: ${stderr.trim().slice(0, 200)})` : ''),
+            ),
+          );
+        } else {
+          resolve(
+            ok({
+              sent: true,
+              message: args.message,
+              to: args.to ?? env.JABBER_TO,
+              room: args.room ?? env.JABBER_ROOM,
+            }),
+          );
+        }
+      },
+    );
+  });
+}

package/tools/library.js

@@ -0,0 +1,225 @@
+/**
+ * Library Release 相關 tools
+ *   - create_library_ticket
+ */
+import {
+  SYSTEM_CODES,
+  ENV_CODES,
+  LIBRARY_MODULE_IDS,
+  ISSUE_TYPE_IDS,
+  JIRA_PROJECT_ID,
+  LIBRARY_FIELD_IDS,
+  SYSTEM_TO_DEPT_MAP,
+  DEPT_CODES,
+  SYSTEM_CODE_JIRA_IDS,
+  FIELD_OPTIONS,
+  MODULE_TO_REPO_MAP,
+  REPO_MAPS,
+  MODULE_MAP,
+  REPO_LABEL_MAP,
+} from '../constants/index.js';
+import {error, ok, today} from './helpers.js';
+
+export {REPO_MAPS, MODULE_MAP, REPO_LABEL_MAP};
+
+// ── Schema definitions ───────────────────────────────────────────
+export function getLibraryToolDefinitions() {
+  return [
+    {
+      name: 'create_library_ticket',
+      description:
+        '建立 Library Release 上版單。專用工具，提前驗證必填欄位。當使用者說「幫我開 Lib」、「開 Library」時優先使用這個 tool',
+      inputSchema: {
+        type: 'object',
+        required: ['systemCode', 'module', 'gitBranch'],
+        properties: {
+          systemCode: {
+            type: 'string',
+            enum: Object.values(SYSTEM_CODES),
+            description: '系統代碼',
+          },
+          module: {
+            type: 'string',
+            description: '模組名稱（選填，預設同 systemCode）',
+          },
+          gitBranch: {
+            type: 'string',
+            description: 'Git branch 或倉庫名稱（例如 release/v1.5.2.0）',
+          },
+          jenkinsBranch: {
+            type: 'string',
+            description: 'Jenkins branch 預設 master（選填）',
+          },
+          environment: {
+            type: 'string',
+            enum: Object.keys(ENV_CODES),
+            description: '部署環境，(選填，預設 stg)',
+          },
+          dryRun: {
+            type: 'boolean',
+            description: '(選填) 預覽模式，不實際建立 Jira 單，回傳會送出的 payload',
+          },
+        },
+      },
+    },
+  ];
+}
+
+// ── Handlers ─────────────────────────────────────────────────────
+
+/**
+ * 計算下一個 Library Release 版號
+ */
+export async function handleGetNextLibVersion(args, {jira}) {
+  const {module, branch} = args;
+
+  const repoName = MODULE_TO_REPO_MAP[module];
+  if (!repoName) {
+    return error(`找不到模組 "${module}" 的 repo 對應，請確認 MODULE_TO_REPO_MAP`);
+  }
+  const repoMeta = REPO_MAPS[repoName];
+  if (!repoMeta) {
+    return error(`找不到 repo "${repoName}" 的 Bitbucket 設定`);
+  }
+
+  let xmlVersion = null;
+  let xmlSerialFromXml = null;
+  try {
+    const xmlContent = await jira.getBitbucketFileContent(
+      repoMeta.project,
+      repoName,
+      `${module}.xml`,
+      branch,
+    );
+    // 格式：release-v1.5.2.0-0.0.1-SNAPSHOT  → base=release/v1.5.2.0, serial=0.0.1
+    const match = xmlContent.match(/<version>(.+?)-(\d+\.\d+\.\d+)(?:-[^<]+)?<\/version>/);
+    if (!match) {
+      return error(`${module}.xml 中找不到 <version> 標籤（branch: ${branch}）`);
+    }
+    xmlVersion = match[1].trim().replace('-', '/'); // e.g. "release/v1.5.2.0"
+    xmlSerialFromXml = match[2].trim(); // e.g. "0.0.1"
+  } catch (err) {
+    return error(`無法取得 ${module}.xml：${err.message}`);
+  }
+
+  const branchBase = branch.replace(/^release\//, '').replace(/^release-/, '');
+  const xmlBase = xmlVersion?.replace(/^release\//, '').replace(/^release-/, '');
+  let newBranch = branchBase;
+  let newSerial = '0.0.1';
+
+  if (xmlBase === branchBase && xmlSerialFromXml) {
+    const parts = xmlSerialFromXml.split('.').map(Number);
+    if (parts.length === 3 && parts.every(Number.isFinite)) {
+      parts[2] += 1;
+      newSerial = parts.join('.');
+    } else {
+      newSerial = xmlSerialFromXml;
+    }
+  }
+
+  const summaryVersion = `${newBranch}-${newSerial}`;
+  return ok({
+    module,
+    branch,
+    xmlVersion,
+    xmlSerial: xmlSerialFromXml,
+    serial: newSerial,
+    summaryVersion,
+    message: `✅ 下一個版本：${summaryVersion}（XML 現版：${xmlVersion}-${xmlSerialFromXml}）`,
+  });
+}
+
+/**
+ * 建立 Library Release 上版單
+ */
+export async function handleCreateLibraryTicket(args, {jira, notifier}) {
+  try {
+    const normalizedArgs = {
+      ...args,
+      module: args.module ?? args.moduleChild ?? args.systemCode?.toLowerCase(),
+      gitBranch: args.gitBranch ?? args.repo,
+    };
+    const parentId = SYSTEM_CODE_JIRA_IDS.library?.[normalizedArgs.systemCode];
+    const childId = LIBRARY_MODULE_IDS[normalizedArgs.systemCode]?.[normalizedArgs.module];
+    if (!parentId) return error(`找不到系統代碼 "${normalizedArgs.systemCode}" 的 Library ID`);
+    if (!childId) return error(`找不到模組 "${normalizedArgs.module}" 的 Library ID`);
+
+    const nextVersionResult = await handleGetNextLibVersion(
+      {module: normalizedArgs.module, branch: normalizedArgs.gitBranch},
+      {jira},
+    );
+    const nextVersionText = nextVersionResult.content[0].text;
+    let summaryVersion;
+    if (nextVersionText.startsWith('❌')) {
+      if (args.dryRun) {
+        // dryRun 下 Bitbucket 不通時，用 branch 名稱當 placeholder
+        summaryVersion = normalizedArgs.gitBranch?.replace('release/', '') ?? 'unknown';
+      } else {
+        return nextVersionResult;
+      }
+    } else {
+      summaryVersion = JSON.parse(nextVersionText).summaryVersion;
+    }
+    const autoSummary =
+      normalizedArgs.summary ?? `[${normalizedArgs.systemCode}][Lib] Release for ${summaryVersion}`;
+
+    const fields = {
+      project: {key: JIRA_PROJECT_ID},
+      issuetype: {id: ISSUE_TYPE_IDS.Library},
+      summary: autoSummary,
+      duedate: today(),
+      [LIBRARY_FIELD_IDS.libModuleParent]: {
+        id: parentId,
+        child: {id: childId},
+      },
+    };
+
+    // env（預設 stg）
+    const envCode = args.environment?.toLowerCase() ?? 'stg';
+    if (LIBRARY_FIELD_IDS.env && ENV_CODES[envCode]) {
+      fields[LIBRARY_FIELD_IDS.env] = {id: ENV_CODES[envCode]};
+    }
+
+    // dept_code（由 systemCode 推導）
+    const deptStr = SYSTEM_TO_DEPT_MAP[normalizedArgs.systemCode];
+    if (LIBRARY_FIELD_IDS.deptCode && deptStr && DEPT_CODES[deptStr]) {
+      fields[LIBRARY_FIELD_IDS.deptCode] = {id: DEPT_CODES[deptStr]};
+    }
+
+    // fortify_scan：預設 scanned
+    if (LIBRARY_FIELD_IDS.fortifyScan) {
+      fields[LIBRARY_FIELD_IDS.fortifyScan] = {
+        id: normalizedArgs.fortifyScan === false
+          ? FIELD_OPTIONS.fortifyScan.notScanned
+          : FIELD_OPTIONS.fortifyScan.scanned,
+      };
+    }
+
+    // CID_jenkinsfile_branch：預設 master
+    if (LIBRARY_FIELD_IDS.jenkinsBranch) {
+      fields[LIBRARY_FIELD_IDS.jenkinsBranch] = normalizedArgs.jenkinsBranch || 'master';
+    }
+
+    // CID_branch
+    if (LIBRARY_FIELD_IDS.gitBranch && normalizedArgs.gitBranch) {
+      fields[LIBRARY_FIELD_IDS.gitBranch] = normalizedArgs.gitBranch;
+    }
+
+    if (args.dryRun) return ok({dryRun: true, summary: autoSummary, fields});
+
+    const issue = await jira.createIssue(fields);
+    await notifier.notify(
+      issue.key,
+      `Library Release 單已建立。系統: ${args.systemCode}, 模組: ${args.module}, 環境: ${envCode}`,
+    );
+    return ok({
+      issueKey: issue.key,
+      issueId: issue.id,
+      url: `${process.env.JIRA_BASE_URL}/browse/${issue.key}`,
+      type: 'Library Release',
+      system: normalizedArgs.systemCode,
+    });
+  } catch (err) {
+    return error(`無法建立 Library 單: ${err.message}`);
+  }
+}

package/tools/release.js

@@ -0,0 +1,320 @@
+/**
+ * Release workflow 工具群
+ *   - get_unreleased_versions    查詢 LBPRJ unreleased 版本
+ *   - transition_to_wait_approval  CD 單切到 Wait Approval
+ *   - get_release_manager        查詢今日 STG 值班組長
+ *   - wait_for_comment           輪詢等待 comment 關鍵字
+ */
+import https from 'https';
+import http from 'http';
+import {error, getModuleName, ok, today} from './helpers.js';
+import {SYSTEM_CODES, SYSTEM_MODULES} from '../constants/index.js';
+
+// ── Schema definitions ───────────────────────────────────────────
+export function getReleaseToolDefinitions() {
+  return [
+    {
+      name: 'get_unreleased_versions',
+      description:
+        '查詢 LBPRJ 所有 unreleased versions。可依 systemCode 篩選，自動解析版本名稱為 module + branch。',
+      inputSchema: {
+        type: 'object',
+        required: [],
+        properties: {
+          systemCode: {
+            type: 'string',
+            enum: Object.values(SYSTEM_CODES),
+            description:
+              '(選填) 只列出此系統的版本，例如 IBK → 回傳 IBK_、IBK_ssr_、IBK_wealth_、IBK_accessibility_ 開頭的版本，並解析出 module 與 branch',
+          },
+          projectKey: {
+            type: 'string',
+            description: '(選填) Jira 專案 key，預設 LBPRJ',
+          },
+        },
+      },
+    },
+    {
+      name: 'transition_to_wait_approval',
+      description:
+        '將 CD 單執行 "Apply for approval" transition，切換到 Wait Approval 狀態（讓主管可以簽核）',
+      inputSchema: {
+        type: 'object',
+        required: ['cdIssueKey'],
+        properties: {
+          cdIssueKey: {
+            type: 'string',
+            description: 'CD 單 issue key，例如 CID-1710',
+          },
+        },
+      },
+    },
+    {
+      name: 'get_release_manager',
+      description:
+        '查詢指定日期的 STG release 值班組長（從 Confluence Team Calendar 讀取 Sign off staff 事件）。今日 4/26 是 Alvin Wang BK00236。',
+      inputSchema: {
+        type: 'object',
+        required: [],
+        properties: {
+          date: {
+            type: 'string',
+            description: '(選填) 查詢日期 YYYY-MM-DD，預設今天',
+          },
+        },
+      },
+    },
+    {
+      name: 'wait_for_comment',
+      description:
+        '輪詢等待 Jira issue 出現包含特定關鍵字的 comment。用於等待 James Yu (BK00178) 在 UAT CD 單留 "Approved" 等場景。',
+      inputSchema: {
+        type: 'object',
+        required: ['issueKey', 'keyword'],
+        properties: {
+          issueKey: {
+            type: 'string',
+            description: 'Jira issue key，例如 CID-1710',
+          },
+          keyword: {
+            type: 'string',
+            description: '等待出現的關鍵字，例如 "Approved"',
+          },
+          authorAccountId: {
+            type: 'string',
+            description: '(選填) 限定特定用戶的 comment，例如 BK00178（James Yu）',
+          },
+          timeoutMs: {
+            type: 'number',
+            description: '(選填) 最長等待毫秒，預設 3600000（1小時）',
+          },
+          intervalMs: {
+            type: 'number',
+            description: '(選填) 輪詢間隔毫秒，預設 30000（30秒）',
+          },
+        },
+      },
+    },
+  ];
+}
+
+// ── Handlers ─────────────────────────────────────────────────────
+
+export async function handleGetUnreleasedVersions(args, {jira}) {
+  try {
+    const projectKey = args.projectKey ?? 'LBPRJ';
+    const versions = await jira.getUnreleasedVersionsList(projectKey);
+
+    if (!args.systemCode) {
+      return ok({
+        projectKey,
+        total: versions.length,
+        versions: versions.map((v) => ({id: v.id, name: v.name})),
+      });
+    }
+
+    // 建立 module → prefix 對應表
+    const modules = SYSTEM_MODULES[args.systemCode] ?? [];
+    const prefixes = modules.map((m) => getModuleName(args.systemCode, m, ''));
+
+    // 篩選名稱以 prefix 開頭的版本（longest match 優先，避免 'IBK_' 誤匹配 'IBK_ssr_xxx'）
+    const filtered = versions.filter((v) => prefixes.some((p) => v.name.startsWith(p)));
+
+    // 解析版本名稱 → module + branch（取最長匹配的 prefix）
+    const parsed = filtered.map((v) => {
+      const matchedPrefix = prefixes
+        .filter((p) => v.name.startsWith(p))
+        .sort((a, b) => b.length - a.length)[0];
+      const module = modules[prefixes.indexOf(matchedPrefix)];
+      const versionSuffix = v.name.slice(matchedPrefix.length);
+      return {
+        id: v.id,
+        name: v.name,
+        module,
+        branch: `release/v${versionSuffix}`,
+      };
+    });
+
+    return ok({projectKey, systemCode: args.systemCode, total: parsed.length, versions: parsed});
+  } catch (err) {
+    return error(`無法查詢 unreleased versions: ${err.message}`);
+  }
+}
+
+export async function handleTransitionToWaitApproval(args, {jira, notifier}) {
+  try {
+    await jira.transitionByName(args.cdIssueKey, 'Apply for approval');
+    await notifier.notify(args.cdIssueKey, '已切換到 Wait Approval，等待主管簽核');
+    return ok({
+      issueKey: args.cdIssueKey,
+      transitioned: 'Apply for approval',
+      toStatus: 'Wait Approval',
+    });
+  } catch (err) {
+    return error(`無法切換到 Wait Approval: ${err.message}`);
+  }
+}
+
+export async function handleGetReleaseManager(args, _ctx) {
+  try {
+    const date = args.date ?? today();
+
+    // dryRun 模式：回傳 mock 資料
+    if (args.dryRun) {
+      return ok({
+        date,
+        found: true,
+        name: 'Alvin Wang',
+        dryRun: true,
+        event: {what: 'Sign off staff', who: 'Alvin Wang (BK00236)'},
+      });
+    }
+
+    const CONF_BASE_URL = process.env.CONF_BASE_URL;
+    const CONF_TOKEN = process.env.CONF_TOKEN;
+    if (!CONF_BASE_URL || !CONF_TOKEN) {
+      return error('缺少環境變數 CONF_BASE_URL 或 CONF_TOKEN');
+    }
+
+    // Release Manager 值班表的 sub-calendar ID（來自 wiki 頁 109861360）
+    const SUB_CALENDAR_ID = 'afcd2271-8dfa-410e-a922-454f1eec03c0';
+
+    const nextDay = new Date(date);
+    nextDay.setDate(nextDay.getDate() + 1);
+    const endDate = nextDay.toISOString().slice(0, 10);
+
+    const path =
+      `/rest/calendar-services/1.0/calendar/events.json` +
+      `?subCalendarId=${encodeURIComponent(SUB_CALENDAR_ID)}` +
+      `&start=${date}&end=${endDate}` +
+      `&userTimeZoneId=Asia%2FTaipei`;
+
+    const data = await calendarRequest(CONF_BASE_URL, path, CONF_TOKEN);
+    const events = data.events ?? [];
+
+    // 找 what 欄位（event title）包含 "Sign off staff" 的事件
+    const signOffEvent = events.find(
+      (e) =>
+        (e.what ?? '').toLowerCase().includes('sign off staff') ||
+        (e.title ?? '').toLowerCase().includes('sign off staff'),
+    );
+
+    if (!signOffEvent) {
+      return ok({
+        date,
+        found: false,
+        allEvents: events.map((e) => ({what: e.what, who: e.who})),
+        message: `${date} 找不到 Sign off staff 事件，請手動確認值班組長`,
+      });
+    }
+
+    // 回傳值班人員資訊
+    return ok({
+      date,
+      found: true,
+      name: signOffEvent.who ?? signOffEvent.what ?? '',
+      event: signOffEvent,
+    });
+  } catch (err) {
+    return error(`無法查詢 Release Manager: ${err.message}`);
+  }
+}
+
+export async function handleWaitForComment(args, {jira}) {
+  // dryRun 模式：直接回傳 mock 結果
+  if (args.dryRun) {
+    return ok({
+      found: true,
+      issueKey: args.issueKey,
+      keyword: args.keyword,
+      author: args.authorAccountId ?? '(any)',
+      comment: `[DRY RUN] ${args.keyword}`,
+      dryRun: true,
+      attempts: 1,
+      elapsedMs: 0,
+    });
+  }
+
+  const intervalMs = args.intervalMs ?? parseInt(process.env.POLL_INTERVAL_MS ?? '30000');
+  const timeoutMs = args.timeoutMs ?? parseInt(process.env.POLL_TIMEOUT_MS ?? '3600000');
+  const startTime = Date.now();
+  let attempts = 0;
+
+  console.error(
+    `[wait_for_comment] Waiting for keyword="${args.keyword}" in ${args.issueKey}` +
+    (args.authorAccountId ? ` from author=${args.authorAccountId}` : ''),
+  );
+
+  while (true) {
+    attempts++;
+    const comments = await jira.getComments(args.issueKey);
+
+    const match = comments.find((c) => {
+      const bodyMatch = (c.body ?? '').toLowerCase().includes(args.keyword.toLowerCase());
+      const authorMatch = !args.authorAccountId || (c.author?.name ?? '') === args.authorAccountId;
+      return bodyMatch && authorMatch;
+    });
+
+    if (match) {
+      return ok({
+        found: true,
+        issueKey: args.issueKey,
+        keyword: args.keyword,
+        author: match.author?.displayName ?? match.author?.name ?? '',
+        comment: (match.body ?? '').slice(0, 500),
+        attempts,
+        elapsedMs: Date.now() - startTime,
+      });
+    }
+
+    const elapsed = Date.now() - startTime;
+    if (elapsed >= timeoutMs) {
+      return error(
+        `Timeout：等待 "${args.keyword}" comment in ${args.issueKey}（${attempts} 次輪詢，${Math.round(elapsed / 1000)}s）`,
+      );
+    }
+
+    console.error(`[wait_for_comment] attempt #${attempts}, no match, sleeping ${intervalMs}ms`);
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+}
+
+// ── Private helpers ───────────────────────────────────────────────
+
+function calendarRequest(baseUrl, path, token) {
+  return new Promise((resolve, reject) => {
+    const url = new URL(path, baseUrl);
+    const lib = url.protocol === 'https:' ? https : http;
+    const req = lib.request(
+      {
+        hostname: url.hostname,
+        port: url.port || (url.protocol === 'https:' ? 443 : 80),
+        path: url.pathname + url.search,
+        method: 'GET',
+        rejectUnauthorized: false,
+        headers: {Authorization: `Bearer ${token}`, Accept: 'application/json'},
+      },
+      (res) => {
+        let data = '';
+        res.on('data', (c) => (data += c));
+        res.on('end', () => {
+          if (res.statusCode >= 200 && res.statusCode < 300) {
+            try {
+              resolve(JSON.parse(data));
+            } catch (e) {
+              reject(new Error(`JSON parse error: ${e.message}`));
+            }
+          } else {
+            reject(new Error(`HTTP ${res.statusCode}: ${data.slice(0, 200)}`));
+          }
+        });
+      },
+    );
+    req.on('error', reject);
+    req.setTimeout(15000, () => {
+      req.destroy();
+      reject(new Error('Request timeout'));
+    });
+    req.end();
+  });
+}