@jira-deploy/core 1.0.2 → 1.0.3

package/tools/index.js

@@ -17,6 +17,9 @@ import {
   getGrayReleaseToolDefinitions,
   handleCreateGrayReleaseTicket,
   handleLinkStgGrayRelease,
+  handleAutoGrayRelease,
+  handleGetGrayReleaseStatus,
+  handleContinueGrayRelease,
 } from './grayrelease.js';
 import {
   getReleaseToolDefinitions,
@@ -39,6 +42,7 @@ const READ_ONLY_TOOL_NAMES = new Set([
   'get_unreleased_versions',
   'get_release_manager',
   'wait_for_comment',
+  'get_grayrelease_status',
 ]);
 
 function withToolAnnotations(tools) {
@@ -185,6 +189,21 @@ export function getToolDefinitions() {
         },
       },
     },
+    {
+      name: 'wait_to_dev',
+      description:
+        'CI 單 build 完成後，自動走完掃描流程切到 Wait To DEV 狀態。流程：Compliance Scan → Upload Scan Report → Accept → Wait To DEV（不執行 Dev Done）',
+      inputSchema: {
+        type: 'object',
+        required: ['issueKey'],
+        properties: {
+          issueKey: {
+            type: 'string',
+            description: 'CI issue key，例如 CID-1668',
+          },
+        },
+      },
+    },
     {
       name: 'wait_to_stg',
       description:
@@ -377,6 +396,15 @@ export async function executeTool(name, args, deps) {
     case 'link_stg_grayrelease':
       return handleLinkStgGrayRelease(args, {jira, notifier});
 
+    case 'auto_grayrelease':
+      return handleAutoGrayRelease(args, {jira, notifier});
+
+    case 'get_grayrelease_status':
+      return handleGetGrayReleaseStatus(args, {jira});
+
+    case 'continue_grayrelease':
+      return handleContinueGrayRelease(args, {jira, notifier});
+
     case 'get_unreleased_versions':
       return handleGetUnreleasedVersions(args, {jira});
 
@@ -538,6 +566,48 @@ export async function executeTool(name, args, deps) {
       }
     }
 
+    case 'wait_to_dev': {
+      const {issueKey} = args;
+      const log = [];
+
+      const STEPS = [
+        {transition: 'Upload Scan Report', targetStatus: 'Upload Report'},
+        {transition: 'Accept', targetStatus: 'Wait To DEV'},
+      ];
+      const finalTargetStatus = STEPS.at(-1).targetStatus;
+
+      try {
+        for (const step of STEPS) {
+          const transitions = await jira.getTransitions(issueKey);
+          const t = transitions.find((t) => t.name.toLowerCase() === step.transition.toLowerCase());
+          if (!t) {
+            const issue = await jira.getIssue(issueKey);
+            const current = issue.fields.status.name;
+            if (current.toLowerCase() === step.targetStatus.toLowerCase()) {
+              log.push(`  已是 ${current}，跳過「${step.transition}」`);
+              continue;
+            }
+            if (current.toLowerCase() === finalTargetStatus.toLowerCase()) {
+              log.push(`  已是 ${current}，流程已完成`);
+              break;
+            }
+            return error(`找不到 transition「${step.transition}」，目前狀態：${current}`);
+          }
+          log.push(`執行「${t.name}」→ ${step.targetStatus}`);
+          await jira.transitionById(issueKey, t.id);
+        }
+
+        const issue = await jira.getIssue(issueKey);
+        const finalStatus = issue.fields.status.name;
+        log.push(`✅ 完成，目前狀態：${finalStatus}`);
+        await notifier.notify(issueKey, `已切換至 ${finalStatus}，可進行 DEV 部署`);
+
+        return ok({issueKey, status: finalStatus, steps: log});
+      } catch (err) {
+        return error(`wait_to_dev 失敗: ${err.message}`);
+      }
+    }
+
     case 'wait_to_stg': {
       const {issueKey} = args;
       const log = [];
@@ -790,19 +860,28 @@ export async function executeTool(name, args, deps) {
       const log = [];
 
       // CD 部署前置 transitions（依序嘗試，直到找到部署 transition 或完成申請流程）
-      // STG 完整流程：
+      // DEV 流程會跳過通知主管簽核，建立 deployment 後直接嘗試自助 Approved / To Wait Deploy。
+      // STG/UAT/PRD 完整流程：
       //   TO DO → (Accept) → Wait For Send Notice Email
       //         → (Prepare to create deployment ticket) → Prepare For Deploy  ← 建立 Deployment sub-task
       //         → (Apply for approval) → Wait Approval  ← 等 Reviewer 核准
       //         → Wait Deploy  ← 核准後自動切換，再呼叫 trigger_deployment
       // ⚠️ 不加 'Approved'：Approved 需要其他主管才能執行
-      const CD_PRE_TRANSITIONS = [
+      const CD_PRE_TRANSITIONS = envCode === 'dev' ? [
+        'Accept',
+      ] : [
         'Accept',
         'Prepare to create deployment ticket',
         'Apply for approval',
         'To Wait Deploy',
       ];
 
+      const DEV_SELF_SERVICE_TRANSITIONS = [
+        'Apply for approval',
+        'Approved',
+        'To Wait Deploy',
+      ];
+
       // 部署 transition 名稱（支援多種命名）
       const DEPLOY_TRANSITION_NAMES = [
         'Prepare to create deployment ticket', // 實際 Jira transition 名稱
@@ -839,6 +918,45 @@ export async function executeTool(name, args, deps) {
 
         let deployTrans = await findDeployTrans();
 
+        const getCurrentStatus = async () => {
+          const issue = await jira.getIssue(issueKey);
+          return issue.fields.status.name;
+        };
+
+        const runDevSelfServiceTransitions = async () => {
+          if (envCode !== 'dev') return;
+          for (const transitionName of DEV_SELF_SERVICE_TRANSITIONS) {
+            const currentStatus = await getCurrentStatus();
+            if (currentStatus.toLowerCase() === 'wait deploy') {
+              log.push('  DEV 自助流程已到 Wait Deploy，停止續跑');
+              break;
+            }
+
+            const transitions = await jira.getTransitions(issueKey);
+            const next = transitions.find(
+              (t) => t.name.toLowerCase() === transitionName.toLowerCase(),
+            );
+            if (!next) continue;
+
+            log.push(`  DEV 自助流程觸發「${next.name}」...`);
+            await jira.transitionById(issueKey, next.id);
+            await new Promise((r) => setTimeout(r, 2000));
+          }
+        };
+
+        if (envCode === 'dev') {
+          const currentStatus = await getCurrentStatus();
+          if (currentStatus.toLowerCase() === 'wait deploy') {
+            log.push('✅ CD 單已在 Wait Deploy，無需重複 prepare');
+            return ok({
+              issueKey,
+              environment: envCode,
+              status: currentStatus,
+              steps: log,
+            });
+          }
+        }
+
         if (!deployTrans) {
           log.push('未找到部署 transition，逐步觸發前置狀態...');
           for (const preName of CD_PRE_TRANSITIONS) {
@@ -858,6 +976,25 @@ export async function executeTool(name, args, deps) {
           }
         }
 
+        if (!deployTrans && envCode === 'dev') {
+          await runDevSelfServiceTransitions();
+          const currentStatus = await getCurrentStatus();
+          if (currentStatus.toLowerCase() === 'wait deploy') {
+            log.push(`✅ DEV 自助流程完成，目前狀態：${currentStatus}`);
+            await notifier.notify(
+              issueKey,
+              `CD 部署已觸發（環境: ${envCode.toUpperCase()}，狀態: ${currentStatus}）`,
+            );
+            return ok({
+              issueKey,
+              environment: envCode,
+              status: currentStatus,
+              steps: log,
+            });
+          }
+          deployTrans = await findDeployTrans();
+        }
+
         if (!deployTrans) {
           const issue = await jira.getIssue(issueKey);
           const transitions = await jira.getTransitions(issueKey);
@@ -871,21 +1008,37 @@ export async function executeTool(name, args, deps) {
 
         // Step 4: 觸发部署 transition
         log.push(`執行「${deployTrans.name}」transition（id: ${deployTrans.id}）...`);
-        await jira.transitionById(issueKey, deployTrans.id);
+        try {
+          await jira.transitionById(issueKey, deployTrans.id);
+        } catch (err) {
+          if (envCode === 'dev' && err.message.includes('Already create deployment ticket')) {
+            log.push('  Deployment ticket 已存在，繼續 DEV approval 續跑流程');
+          } else {
+            throw err;
+          }
+        }
 
         const issue = await jira.getIssue(issueKey);
         const newStatus = issue.fields.status.name;
         log.push(`✅ 部署已觸发，目前狀態：${newStatus}`);
 
+        await runDevSelfServiceTransitions();
+
+        const finalIssue = await jira.getIssue(issueKey);
+        const finalStatus = finalIssue.fields.status.name;
+        if (finalStatus !== newStatus) {
+          log.push(`✅ DEV 自助流程完成，目前狀態：${finalStatus}`);
+        }
+
         await notifier.notify(
           issueKey,
-          `CD 部署已觸發（環境: ${envCode.toUpperCase()}，狀態: ${newStatus}）`,
+          `CD 部署已觸發（環境: ${envCode.toUpperCase()}，狀態: ${finalStatus}）`,
         );
 
         return ok({
           issueKey,
           environment: envCode,
-          status: newStatus,
+          status: finalStatus,
           steps: log,
         });
       } catch (err) {

package/tools/library.js

@@ -210,7 +210,7 @@ export async function handleCreateLibraryTicket(args, {jira, notifier}) {
     const issue = await jira.createIssue(fields);
     await notifier.notify(
       issue.key,
-      `Library Release 單已建立。系統: ${args.systemCode}, 模組: ${args.module}, 環境: ${envCode}`,
+      `Library Release 單已建立。系統: ${normalizedArgs.systemCode}, 模組: ${normalizedArgs.module}, 環境: ${envCode}`,
     );
     return ok({
       issueKey: issue.key,
@@ -218,6 +218,7 @@ export async function handleCreateLibraryTicket(args, {jira, notifier}) {
       url: `${process.env.JIRA_BASE_URL}/browse/${issue.key}`,
       type: 'Library Release',
       system: normalizedArgs.systemCode,
+      module: normalizedArgs.module,
     });
   } catch (err) {
     return error(`無法建立 Library 單: ${err.message}`);