@jira-deploy/core 1.0.14 → 1.0.16

package/constants/config.js

@@ -28,6 +28,7 @@ const DEFAULT_DEPLOY_CONFIG = {
       deptManagerSign: 'customfield_dept_manager_sign',
       authManagerSign: 'customfield_auth_manager_sign',
       releaseInfo: 'customfield_release_info',
+      buildResult: 'customfield_build_result',
     },
     cd: {
       systemSubmodule: 'customfield_system_submodule',
@@ -49,12 +50,12 @@ const DEFAULT_DEPLOY_CONFIG = {
       antiScanRequired: 'customfield_anti_scan_required',
       ciNotes: 'customfield_ci_notes',
       releaseVersion: 'customfield_release_version',
+      uploadResult: 'customfield_13452',
     },
     grayRelease: {
       grayReleaseVersion: 'customfield_grayrelease_version',
       clusterList: 'customfield_cluster_list',
       grayReleaseNotes: 'customfield_grayrelease_notes',
-      buildResult: 'customfield_build_result',
       deployResult: 'customfield_deploy_result',
     },
   },
@@ -112,11 +113,22 @@ const DEFAULT_DEPLOY_CONFIG = {
   },
   release: {
     managerSubCalendarId: '',
+    birthdayCalendarId: '',
+    leaveCalendarId: '',
     dryRunManager: { name: 'Demo User', accountId: 'demo-user' },
     grayReleaseUatApprovers: {
       commentReviewerAlias: 'uat-comment-reviewer',
       finalApproverAlias: 'uat-final-approver',
     },
+    managerSubstitutes: {},
+    cdApprovers: {
+      prd: {
+        leadReviewerAliases: [],
+        secondReviewerAlias: '',
+        thirdReviewerAlias: '',
+        finalApproverAlias: '',
+      },
+    },
   },
   jabber: {
     domain: 'example.internal',

package/index.js

@@ -3,4 +3,4 @@ export {Notifier} from './notifier.js';
 export {Poller} from './poller.js';
 export {getPlatformConfig, PLATFORM_TO_SYSTEM_CODE, PLATFORMS} from './platform-config.js';
 export {getToolDefinitions, executeTool} from './tools/index.js';
-export {getClusterList, ok, error, today} from './tools/helpers.js';
+export {getServerList, ok, error, today} from './tools/helpers.js';

package/jira-client.js

@@ -1,13 +1,13 @@
 import axios from 'axios';
 import https from 'https';
 
-const httpsAgent = new https.Agent({rejectUnauthorized: false});
+const httpsAgent = new https.Agent({ rejectUnauthorized: false });
 
 const DRY_RUN = process.env.DRY_RUN === 'true';
 
 export class JiraClient {
   constructor() {
-    const {JIRA_BASE_URL, JIRA_API_TOKEN} = process.env;
+    const { JIRA_BASE_URL, JIRA_API_TOKEN } = process.env;
     if (!JIRA_BASE_URL || !JIRA_API_TOKEN) {
       throw new Error('Missing required Jira env vars: JIRA_BASE_URL, JIRA_API_TOKEN');
     }
@@ -28,9 +28,9 @@ export class JiraClient {
   async createIssue(fields) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.createIssue', JSON.stringify(fields).slice(0, 1000));
-      return {id: 'DRY-RUN', key: 'DRY-RUN', self: ''};
+      return { id: 'DRY-RUN', key: 'DRY-RUN', self: '' };
     }
-    const res = await this.http.post('/issue', {fields}).catch((err) => {
+    const res = await this.http.post('/issue', { fields }).catch((err) => {
       const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
       throw new Error(`Create issue failed: ${detail}`);
     });
@@ -45,22 +45,22 @@ export class JiraClient {
         issueKey,
         JSON.stringify(fields).slice(0, 1000),
       );
-      return {issueKey, updated: Object.keys(fields)};
+      return { issueKey, updated: Object.keys(fields) };
     }
-    await this.http.put(`/issue/${issueKey}`, {fields});
-    return {issueKey, updated: Object.keys(fields)};
+    await this.http.put(`/issue/${issueKey}`, { fields });
+    return { issueKey, updated: Object.keys(fields) };
   }
 
   // 更新 Assignee（使用專用 endpoint，Jira Server 相容）
   async updateAssignee(issueKey, accountId) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.updateAssignee', issueKey, accountId);
-      return {issueKey, accountId};
+      return { issueKey, accountId };
     }
-    await this.http.put(`/issue/${issueKey}/assignee`, {name: accountId}).catch(async (err) => {
+    await this.http.put(`/issue/${issueKey}/assignee`, { name: accountId }).catch(async (err) => {
       // 若 name 格式失敗，改試 accountId 格式（Jira Cloud）
       if (err.response?.status === 400) {
-        await this.http.put(`/issue/${issueKey}/assignee`, {accountId}).catch((e) => {
+        await this.http.put(`/issue/${issueKey}/assignee`, { accountId }).catch((e) => {
           const detail = e.response?.data ? JSON.stringify(e.response.data) : e.message;
           throw new Error(`updateAssignee failed: ${detail}`);
         });
@@ -69,18 +69,18 @@ export class JiraClient {
         throw new Error(`updateAssignee failed: ${detail}`);
       }
     });
-    return {issueKey, accountId};
+    return { issueKey, accountId };
   }
 
   // 查詢 issue 目前狀態
   async getIssue(issueKey) {
     const res = await this.http.get(`/issue/${issueKey}`, {
-      params: {fields: 'status,summary,assignee,comment'},
+      params: { fields: 'status,summary,assignee,comment' },
     });
     return res.data;
   }
 
-  // 取得可執行的 transitions
+  // 取得當前狀態可執行的 transitions (可以執行的狀態切換列表)
   async getTransitions(issueKey) {
     const res = await this.http.get(`/issue/${issueKey}/transitions`);
     return res.data.transitions; // [{ id, name, to: { name } }]
@@ -89,7 +89,7 @@ export class JiraClient {
   // 查詢 issue 的指定欄位（例如取得 CI 單的 CID_release_version）
   async getIssueFields(issueKey, fields = []) {
     const res = await this.http.get(`/issue/${issueKey}`, {
-      params: {fields: fields.join(',')},
+      params: { fields: fields.join(',') },
     });
     return res.data.fields;
   }
@@ -110,24 +110,24 @@ export class JiraClient {
   async transitionById(issueKey, transitionId) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.transitionById', issueKey, transitionId);
-      return {issueKey, transitionId};
+      return { issueKey, transitionId };
     }
     await this.http
       .post(`/issue/${issueKey}/transitions`, {
-        transition: {id: transitionId},
+        transition: { id: transitionId },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
         throw new Error(`Transition id=${transitionId} failed: ${detail}`);
       });
-    return {issueKey, transitionId};
+    return { issueKey, transitionId };
   }
 
   // 依名稱切換狀態（不用記 id）
   async transitionByName(issueKey, transitionName) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.transitionByName', issueKey, transitionName);
-      return {issueKey, transitioned: transitionName, toStatus: 'DRY'};
+      return { issueKey, transitioned: transitionName, toStatus: 'DRY' };
     }
     const transitions = await this.getTransitions(issueKey);
     const match = transitions.find((t) => t.name.toLowerCase() === transitionName.toLowerCase());
@@ -137,34 +137,34 @@ export class JiraClient {
     }
     await this.http
       .post(`/issue/${issueKey}/transitions`, {
-        transition: {id: match.id},
+        transition: { id: match.id },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
         throw new Error(`Transition "${match.name}" failed: ${detail}`);
       });
-    return {issueKey, transitioned: match.name, toStatus: match.to.name};
+    return { issueKey, transitioned: match.name, toStatus: match.to.name };
   }
 
   // 新增 issue link（relates to / blocks / is blocked by 等）
   async linkIssue(inwardKey, outwardKey, linkTypeName = 'Relates') {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.linkIssue', inwardKey, outwardKey, linkTypeName);
-      return {inwardKey, outwardKey, linkType: linkTypeName};
+      return { inwardKey, outwardKey, linkType: linkTypeName };
     }
     await this.http.post('/issueLink', {
-      type: {name: linkTypeName},
-      inwardIssue: {key: inwardKey},
-      outwardIssue: {key: outwardKey},
+      type: { name: linkTypeName },
+      inwardIssue: { key: inwardKey },
+      outwardIssue: { key: outwardKey },
     });
-    return {inwardKey, outwardKey, linkType: linkTypeName};
+    return { inwardKey, outwardKey, linkType: linkTypeName };
   }
 
   // 新增 comment（/rest/api/2 用純文字 body）
   async addComment(issueKey, text) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.addComment', issueKey, text);
-      return {issueKey, body: text};
+      return { issueKey, body: text };
     }
     const res = await this.http.post(`/issue/${issueKey}/comment`, {
       body: text,
@@ -176,11 +176,11 @@ export class JiraClient {
   async addRemoteLink(issueKey, url, title) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.addRemoteLink', issueKey, url, title);
-      return {issueKey, url, title};
+      return { issueKey, url, title };
     }
     const res = await this.http
       .post(`/issue/${issueKey}/remotelink`, {
-        object: {url, title},
+        object: { url, title },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -197,7 +197,7 @@ export class JiraClient {
   //
   // status: 'unreleased'
   // query:  相當於 UI 的 contains 參數（版本名稱包含此字串，不分大小寫）
-  async getProjectVersions(projectKey, {name = {}}) {
+  async getProjectVersions(projectKey, { name = {} }) {
     const res = await this.http.get(`/project/${projectKey}/versions`);
     let versions = res.data ?? [];
 
@@ -231,7 +231,7 @@ export class JiraClient {
   async getSubTasks(issueKey) {
     const res = await this.http
       .get(`/issue/${issueKey}`, {
-        params: {fields: 'subtasks,issuetype'},
+        params: { fields: 'subtasks,issuetype' },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -244,7 +244,7 @@ export class JiraClient {
   async searchIssues(jql, fields = [], maxResults = 10) {
     const res = await this.http
       .get('/search', {
-        params: {jql, fields: fields.join(','), maxResults},
+        params: { jql, fields: fields.join(','), maxResults },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -265,7 +265,7 @@ export class JiraClient {
           Accept: 'text/plain',
           Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
         },
-        params: {at: branch},
+        params: { at: branch },
         responseType: 'text',
       })
       .catch((err) => {
@@ -279,7 +279,7 @@ export class JiraClient {
   async getBitbucketTags(
     project,
     repo,
-    {filterValue = '', orderBy = 'MODIFICATION', limit = 1} = {},
+    { filterValue = '', orderBy = 'MODIFICATION', limit = 1 } = {},
   ) {
     const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
     if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
@@ -292,7 +292,7 @@ export class JiraClient {
           Accept: 'application/json',
           Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
         },
-        params: {filterValue, orderBy, limit},
+        params: { filterValue, orderBy, limit },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -305,7 +305,7 @@ export class JiraClient {
   async getBitbucketBranches(
     project,
     repo,
-    {filterValue = '', orderBy = 'MODIFICATION', limit = 1} = {},
+    { filterValue = '', orderBy = 'MODIFICATION', limit = 1 } = {},
   ) {
     const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
     if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
@@ -318,7 +318,7 @@ export class JiraClient {
           Accept: 'application/json',
           Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
         },
-        params: {filterValue, orderBy, limit},
+        params: { filterValue, orderBy, limit },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -326,4 +326,35 @@ export class JiraClient {
       });
     return res.data?.values ?? [];
   }
+
+  // 取得 Bitbucket repo 的 pull requests（Bitbucket REST API 1.0）
+  async getBitbucketPullRequests(
+    project,
+    repo,
+    { branch = '', state = 'OPEN', limit = 100 } = {},
+  ) {
+    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
+    const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/pull-requests`;
+    const res = await axios
+      .get(url, {
+        httpsAgent,
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: 'application/json',
+          Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
+        },
+        params: {
+          state,
+          limit,
+          direction: 'OUTGOING',
+          ...(branch ? { at: `refs/heads/${branch}` } : {}),
+        },
+      })
+      .catch((err) => {
+        const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
+        throw new Error(`getBitbucketPullRequests failed: ${detail}`);
+      });
+    return res.data?.values ?? [];
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jira-deploy/core",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "type": "module",
   "main": "./index.js",
   "repository": {
@@ -16,19 +16,25 @@
     "./poller": "./poller.js",
     "./platform-config": "./platform-config.js",
     "./tools": "./tools/index.js",
+    "./tools/build": "./tools/build.js",
     "./tools/helpers": "./tools/helpers.js",
     "./tools/library": "./tools/library.js"
   },
   "files": [
     "constants/**/*.js",
     "scripts/jabber_notify.py",
+    "tools/branch-prs.js",
+    "tools/build.js",
     "tools/cd.js",
     "tools/ci.js",
+    "tools/deployment.js",
+    "tools/deployment-helpers.js",
     "tools/grayrelease.js",
     "tools/helpers.js",
     "tools/index.js",
     "tools/jabber.js",
     "tools/library.js",
+    "tools/transition-helpers.js",
     "tools/release.js",
     "tools/workflows.js",
     "index.js",
@@ -42,6 +48,6 @@
     "dotenv": "^16.3.0"
   },
   "scripts": {
-    "test": "node --import ./test-env.js --test tools.test.js tools/jabber.test.js config.test.js"
+    "test": "node --import ./test-env.js --test tools.test.js tools/jabber.test.js tools/transition-helpers.test.js config.test.js"
   }
 }

package/tools/branch-prs.js

@@ -0,0 +1,164 @@
+import {
+  MODULE_TO_REPO_MAP,
+  REPO_MAPS,
+  SYSTEM_TO_CI_REPO_MAP,
+} from '../constants/index.js';
+import { error, ok } from './helpers.js';
+
+const SUPPORTED_TICKET_TYPES = ['library', 'grayrelease', 'ci'];
+
+export function getBranchPRToolDefinitions() {
+  return [
+    {
+      name: 'validate_branch_no_open_pr',
+      description:
+        '檢查開 Library、GrayRelease 或 CI 單前，對應 Bitbucket branch 是否有尚未 merge 的 OPEN pull request。Library/GrayRelease 使用輸入 branch；CI 固定檢查 master。CD 與 Deployment 不需要使用。',
+      inputSchema: {
+        type: 'object',
+        required: ['ticketType', 'systemCode'],
+        properties: {
+          ticketType: {
+            type: 'string',
+            enum: SUPPORTED_TICKET_TYPES,
+            description: '要檢查的開單類型：library / grayrelease / ci。',
+          },
+          systemCode: {
+            type: 'string',
+            description: '系統代碼，例如 IBK、CWA。CI 會用 systemCode 找 Golden Image repo。',
+          },
+          module: {
+            type: 'string',
+            description: 'Library 或 GrayRelease 模組名稱，例如 ssr、cwa。CI 不需要。',
+          },
+          branch: {
+            type: 'string',
+            description: 'Library / GrayRelease 要檢查的 Git branch。CI 會忽略此值並固定檢查 master。',
+          },
+        },
+      },
+    },
+  ];
+}
+
+export async function handleValidateBranchNoOpenPR(args, { jira }) {
+  try {
+    const result = await validateBranchNoOpenPR(args, { jira });
+    return ok(result);
+  } catch (err) {
+    return error(`validate_branch_no_open_pr 失敗: ${err.message}`);
+  }
+}
+
+export async function assertNoOpenPRBeforeCreate(args, { jira }) {
+  const result = await validateBranchNoOpenPR(args, { jira });
+  if (result.blocked) {
+    throw new Error(formatOpenPRBlockMessage(result));
+  }
+  return result;
+}
+
+export async function validateBranchNoOpenPR(args, { jira }) {
+  const target = resolveBranchPRCheckTarget(args);
+  const pullRequests = await jira.getBitbucketPullRequests(target.project, target.repo, {
+    branch: target.branch,
+    state: 'OPEN',
+    limit: 100,
+  });
+  const openPullRequests = normalizePullRequests(pullRequests, target.branch);
+
+  return {
+    ok: openPullRequests.length === 0,
+    blocked: openPullRequests.length > 0,
+    reason: openPullRequests.length > 0 ? 'branch_has_open_pull_requests' : null,
+    ticketType: target.ticketType,
+    systemCode: target.systemCode,
+    module: target.module,
+    repo: target.repo,
+    project: target.project,
+    branch: target.branch,
+    openPullRequests,
+    message: openPullRequests.length > 0
+      ? `${target.branch} 仍有尚未 merge 的 PR，請先完成 merge 後再開單。`
+      : `${target.branch} 沒有尚未 merge 的 OPEN PR，可繼續開單。`,
+  };
+}
+
+export function resolveBranchPRCheckTarget(args) {
+  const ticketType = String(args.ticketType ?? '').trim().toLowerCase();
+  const systemCode = String(args.systemCode ?? '').trim().toUpperCase();
+  const module = String(args.module ?? '').trim().toLowerCase();
+  const branch = ticketType === 'ci'
+    ? 'master'
+    : String(args.branch ?? args.gitBranch ?? '').trim();
+
+  if (!SUPPORTED_TICKET_TYPES.includes(ticketType)) {
+    throw new Error(`不支援的 PR 檢查類型：${args.ticketType}，僅支援 ${SUPPORTED_TICKET_TYPES.join(' / ')}`);
+  }
+  if (!systemCode) {
+    throw new Error('缺少 systemCode');
+  }
+  if (ticketType !== 'ci' && !module) {
+    throw new Error(`${ticketType} PR 檢查缺少 module`);
+  }
+  if (!branch) {
+    throw new Error(`${ticketType} PR 檢查缺少 branch`);
+  }
+
+  const repo = ticketType === 'ci'
+    ? SYSTEM_TO_CI_REPO_MAP[systemCode]
+    : MODULE_TO_REPO_MAP[module];
+  if (!repo) {
+    throw new Error(ticketType === 'ci'
+      ? `找不到系統 "${systemCode}" 的 CI repo 對應，請確認 SYSTEM_TO_CI_REPO_MAP`
+      : `找不到模組 "${module}" 的 repo 對應，請確認 MODULE_TO_REPO_MAP`);
+  }
+
+  const repoMeta = REPO_MAPS[repo];
+  if (!repoMeta?.project) {
+    throw new Error(`找不到 repo "${repo}" 的 Bitbucket 設定`);
+  }
+
+  return {
+    ticketType,
+    systemCode,
+    module: module || null,
+    repo,
+    project: repoMeta.project,
+    branch,
+  };
+}
+
+function normalizePullRequests(pullRequests, branch) {
+  return (pullRequests ?? [])
+    .filter((pr) => isOpenPullRequestFromBranch(pr, branch))
+    .map((pr) => ({
+      id: pr.id,
+      title: pr.title ?? '',
+      state: pr.state ?? '',
+      fromRef: pr.fromRef?.displayId ?? normalizeRefId(pr.fromRef?.id),
+      toRef: pr.toRef?.displayId ?? normalizeRefId(pr.toRef?.id),
+      author: pr.author?.user?.displayName ?? pr.author?.user?.name ?? '',
+      url: pr.links?.self?.[0]?.href ?? pr.link?.url ?? '',
+    }));
+}
+
+function isOpenPullRequestFromBranch(pr, branch) {
+  if (String(pr.state ?? '').toUpperCase() !== 'OPEN') {
+    return false;
+  }
+  const expectedRef = `refs/heads/${branch}`;
+  return pr.fromRef?.displayId === branch
+    || pr.fromRef?.id === expectedRef
+    || normalizeRefId(pr.fromRef?.id) === branch;
+}
+
+function normalizeRefId(refId) {
+  return String(refId ?? '').replace(/^refs\/heads\//, '');
+}
+
+function formatOpenPRBlockMessage(result) {
+  const prLines = result.openPullRequests
+    .map((pr) => `#${pr.id} ${pr.title}${pr.url ? ` ${pr.url}` : ''}`)
+    .join('; ');
+  return `${result.branch} 仍有尚未 merge 的 PR，請先完成 merge 後再開單。${prLines ? ` (${prLines})` : ''}`;
+}

package/tools/build.js

@@ -0,0 +1,117 @@
+/**
+ * Build 相關共用 tools
+ *   - wait_build_result
+ */
+import { SHARED_FIELD_IDS } from '../constants/index.js';
+import {
+  error,
+  getPollIntervalMs,
+  getPollTimeoutMs,
+  isFailingResult,
+  isPassingResult,
+  ok,
+} from './helpers.js';
+
+function progress(ctx, event) {
+  if (typeof ctx.progress === 'function') {
+    ctx.progress(event);
+  }
+}
+
+// ── Schema definitions ───────────────────────────────────────────
+export function getBuildToolDefinitions() {
+  return [
+    {
+      name: 'wait_build_result',
+      description:
+        '輪詢等待 Jira issue 的共用 Build 結果欄位變成 pass 或 fail。支援 CI、Library、GrayRelease；通常接在 build_ci、build_library 或 build_grayrelease 成功觸發 Jenkins build 後使用。',
+      inputSchema: {
+        type: 'object',
+        required: ['issueKey'],
+        properties: {
+          issueKey: {
+            type: 'string',
+            description: '要等待 build 結果的 issue key，例如 CI、Library 或 GrayRelease 單 CID-822',
+          },
+          resultFieldId: {
+            type: 'string',
+            description: '(選填) Build 結果欄位 ID，預設 customfield_13432',
+            default: SHARED_FIELD_IDS.buildResult,
+          },
+          pollIntervalMs: {
+            type: 'number',
+            description: '輪詢間隔毫秒，預設讀 POLL_INTERVAL_MS',
+          },
+          timeoutMs: {
+            type: 'number',
+            description: '最長等待毫秒，預設讀 POLL_TIMEOUT_MS',
+          },
+        },
+      },
+    },
+  ];
+}
+
+// ── Handlers ─────────────────────────────────────────────────────
+export async function handleWaitBuildResult(args, ctx) {
+  const { issueKey } = args;
+  const { jira } = ctx;
+  const fieldId = args.resultFieldId ?? SHARED_FIELD_IDS.buildResult;
+  const intervalMs = args.pollIntervalMs ?? getPollIntervalMs();
+  const timeoutMs = args.timeoutMs ?? getPollTimeoutMs();
+  const startedAt = Date.now();
+  const deadline = Date.now() + timeoutMs;
+  let attempts = 0;
+  let lastValue;
+  let currentStatus;
+
+  try {
+    while (true) {
+      attempts++;
+      const issue = await jira.getIssue(issueKey);
+      currentStatus = issue.fields.status?.name;
+      const fields = await jira.getIssueFields(issueKey, [fieldId]);
+      const raw = fields[fieldId];
+      lastValue = raw?.value ?? raw;
+
+      progress(ctx, {
+        phase: 'polling',
+        title: '等待 Build 結果',
+        detail: `${fieldId}: ${lastValue ?? 'empty'}`,
+        issueKey,
+        currentStatus,
+        attempts,
+        elapsedMs: Date.now() - startedAt,
+        timeoutMs,
+        nextPollMs: intervalMs,
+      });
+
+      if (isPassingResult(lastValue)) {
+        return ok({
+          issueKey,
+          fieldId,
+          result: lastValue,
+          buildResult: lastValue,
+          currentStatus,
+          attempts,
+        });
+      }
+
+      if (isFailingResult(lastValue)) {
+        return error(`Build 失敗，${fieldId}: ${lastValue}`);
+      }
+
+      if (Date.now() >= deadline) {
+        return error(`Build 結果等待逾時，${fieldId}: ${lastValue ?? 'empty'}`);
+      }
+
+      await sleep(intervalMs);
+    }
+  } catch (err) {
+    return error(`wait_build_result 失敗: ${err.message}`);
+  }
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}