@jira-deploy/core 1.0.1 → 1.0.3

package/tools/helpers.js

@@ -5,7 +5,10 @@ export function ok(data) {
 }
 
 export function error(msg) {
-  return {content: [{type: 'text', text: `❌ 錯誤: ${msg}`}]};
+  return {
+    content: [{type: 'text', text: `❌ 錯誤: ${msg}`}],
+    isError: true,
+  };
 }
 
 export function today() {

package/tools/index.js

@@ -17,6 +17,9 @@ import {
   getGrayReleaseToolDefinitions,
   handleCreateGrayReleaseTicket,
   handleLinkStgGrayRelease,
+  handleAutoGrayRelease,
+  handleGetGrayReleaseStatus,
+  handleContinueGrayRelease,
 } from './grayrelease.js';
 import {
   getReleaseToolDefinitions,
@@ -26,6 +29,36 @@ import {
   handleWaitForComment,
 } from './release.js';
 import {getJabberToolDefinitions, handleSendJabberMessage} from './jabber.js';
+import {
+  getWorkflowToolDefinitions,
+  handleRunLibToStgReleaseWorkflow,
+  handleRunStgFullReleaseWorkflow,
+} from './workflows.js';
+
+const READ_ONLY_TOOL_NAMES = new Set([
+  'get_issue_status',
+  'list_transitions',
+  'get_release_status',
+  'get_unreleased_versions',
+  'get_release_manager',
+  'wait_for_comment',
+  'get_grayrelease_status',
+]);
+
+function withToolAnnotations(tools) {
+  return tools.map((tool) => {
+    if (!READ_ONLY_TOOL_NAMES.has(tool.name)) {
+      return tool;
+    }
+    return {
+      ...tool,
+      annotations: {
+        ...tool.annotations,
+        readOnlyHint: true,
+      },
+    };
+  });
+}
 
 /**
  * 回傳所有 tool 定義（schema）給 MCP Server 註冊
@@ -40,13 +73,14 @@ import {getJabberToolDefinitions, handleSendJabberMessage} from './jabber.js';
  * - defaults.js: 預設值及範本
  */
 export function getToolDefinitions() {
-  return [
+  return withToolAnnotations([
     ...getLibraryToolDefinitions(),
     ...getCIToolDefinitions(),
     ...getCDToolDefinitions(),
     ...getGrayReleaseToolDefinitions(),
     ...getReleaseToolDefinitions(),
     ...getJabberToolDefinitions(),
+    ...getWorkflowToolDefinitions(),
     {
       name: 'transition_issue',
       description: '切換 Jira issue 狀態，用名稱指定（不需要知道 transition ID）',
@@ -155,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:
@@ -271,13 +320,14 @@ export function getToolDefinitions() {
         },
       },
     },
-  ];
+  ]);
 }
 
 /**
  * 執行 tool，回傳 { content: [{ type: 'text', text }] }
  */
-export async function executeTool(name, args, {jira, notifier}) {
+export async function executeTool(name, args, deps) {
+  const {jira, notifier} = deps;
   const poller = new Poller(jira);
 
   switch (name) {
@@ -346,6 +396,15 @@ export async function executeTool(name, args, {jira, notifier}) {
     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});
 
@@ -361,6 +420,22 @@ export async function executeTool(name, args, {jira, notifier}) {
     case 'send_jabber_message':
       return handleSendJabberMessage(args, {});
 
+    case 'run_stg_full_release':
+      return handleRunStgFullReleaseWorkflow(args, {
+        jira,
+        notifier,
+        executeToolImpl: deps.executeToolImpl ?? executeTool,
+        workflowWaitOptions: deps.workflowWaitOptions,
+      });
+
+    case 'run_lib_to_stg_release':
+      return handleRunLibToStgReleaseWorkflow(args, {
+        jira,
+        notifier,
+        executeToolImpl: deps.executeToolImpl ?? executeTool,
+        workflowWaitOptions: deps.workflowWaitOptions,
+      });
+
     case 'link_issues': {
       try {
         const linkType = args.linkType ?? 'Relates';
@@ -491,6 +566,48 @@ export async function executeTool(name, args, {jira, notifier}) {
       }
     }
 
+    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 = [];
@@ -669,7 +786,11 @@ export async function executeTool(name, args, {jira, notifier}) {
           if (!t) {
             const issue = await jira.getIssue(deploymentKey);
             const available = transitions.map((t) => t.name).join(', ');
-            // 若 transition 不存在但狀態已超前，跳過
+            if (['To AutoDeploy', 'Trigger AutoDeploy'].includes(step.name)) {
+              return error(
+                `找不到必要部署 transition「${step.name}」，目前狀態：${issue.fields.status.name}，可用：${available || '無'}`,
+              );
+            }
             log.push(
               `  ⚠️ 找不到「${step.name}」（目前狀態：${issue.fields.status.name}，可用：${available || '無'}），跳過`,
             );
@@ -739,19 +860,28 @@ export async function executeTool(name, args, {jira, notifier}) {
       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 名稱
@@ -788,6 +918,45 @@ export async function executeTool(name, args, {jira, notifier}) {
 
         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) {
@@ -807,6 +976,25 @@ export async function executeTool(name, args, {jira, notifier}) {
           }
         }
 
+        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);
@@ -820,21 +1008,37 @@ export async function executeTool(name, args, {jira, notifier}) {
 
         // 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) {
@@ -1115,5 +1319,6 @@ function ok(data) {
 function error(msg) {
   return {
     content: [{type: 'text', text: `❌ 錯誤: ${msg}`}],
+    isError: true,
   };
 }

package/tools/library.js

@@ -31,7 +31,7 @@ export function getLibraryToolDefinitions() {
         '建立 Library Release 上版單。專用工具，提前驗證必填欄位。當使用者說「幫我開 Lib」、「開 Library」時優先使用這個 tool',
       inputSchema: {
         type: 'object',
-        required: ['systemCode', 'module', 'gitBranch'],
+        required: ['systemCode', 'gitBranch'],
         properties: {
           systemCode: {
             type: 'string',
@@ -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}`);

package/tools/workflows.js

@@ -0,0 +1,239 @@
+import {getClusterList, ok, error} from './helpers.js';
+
+export function getWorkflowToolDefinitions() {
+  return [
+    {
+      name: 'run_stg_full_release',
+      description:
+        '執行標準 STG 全流程：建立 CI 單、Build、Wait To STG、建立 CD 單、Prepare CD Deployment，最後 trigger deployment 並 Apply for close。',
+      inputSchema: {
+        type: 'object',
+        required: ['systemCode'],
+        properties: {
+          systemCode: {
+            type: 'string',
+            description: '系統代碼，例如 IBK、CWA、EIB、EVT、NPM、BOF',
+          },
+          environment: {
+            type: 'string',
+            enum: ['stg'],
+            default: 'stg',
+            description: '固定為 stg；保留此參數讓自然語言 planner 可以映射使用者提到的 STG。',
+          },
+        },
+      },
+    },
+    {
+      name: 'run_lib_to_stg_release',
+      description:
+        '執行 Library 到 STG 的完整流程：建立 Library 單、Build library、等待 library build 狀態、建立關聯 CI、Build CI、Wait To STG、建立 CD、Prepare CD Deployment，最後 trigger deployment 並 Apply for close。',
+      inputSchema: {
+        type: 'object',
+        required: ['systemCode', 'gitBranch'],
+        properties: {
+          systemCode: {
+            type: 'string',
+            description: '系統代碼，例如 IBK、CWA、EIB、EVT、NPM、BOF',
+          },
+          module: {
+            type: 'string',
+            description: 'Library 模組；未提供時預設使用 systemCode 小寫，例如 IBK -> ibk。',
+          },
+          gitBranch: {
+            type: 'string',
+            description: 'Library release/hotfix/feature branch，例如 release/v1.5.2.0。',
+          },
+          environment: {
+            type: 'string',
+            enum: ['stg'],
+            default: 'stg',
+            description: '固定為 stg；保留此參數讓自然語言 planner 可以映射使用者提到的 STG。',
+          },
+        },
+      },
+    },
+  ];
+}
+
+function extractText(result) {
+  if (!result?.content?.length) {
+    return '';
+  }
+  return result.content
+    .filter((item) => item.type === 'text')
+    .map((item) => item.text)
+    .join('\n')
+    .trim();
+}
+
+function formatJson(value) {
+  return JSON.stringify(value, null, 2);
+}
+
+function parseToolJson(result) {
+  const text = extractText(result);
+  if (result?.isError || text.startsWith('❌')) {
+    throw new Error(text);
+  }
+  return JSON.parse(text);
+}
+
+async function runToolOrThrow(name, args, deps, workflowLog) {
+  workflowLog.push(`- ${name}: ${formatJson(args)}`);
+  const result = await deps.executeToolImpl(name, args, deps);
+  return parseToolJson(result);
+}
+
+async function waitForIssueStatus(issueKey, targetStatuses, deps, options = {}) {
+  const timeoutMs = options.timeoutMs ?? 10 * 60 * 1000;
+  const intervalMs = options.intervalMs ?? 5000;
+  const startedAt = Date.now();
+  const wanted = targetStatuses.map((status) => status.toLowerCase());
+
+  while (Date.now() - startedAt < timeoutMs) {
+    const issue = await deps.jira.getIssue(issueKey);
+    const current = issue.fields?.status?.name ?? '';
+    if (wanted.includes(current.toLowerCase())) {
+      return current;
+    }
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+
+  throw new Error(`等待 ${issueKey} 狀態 ${targetStatuses.join(' / ')} 超時`);
+}
+
+export async function handleRunStgFullReleaseWorkflow(args, deps) {
+  try {
+    const workflowLog = [];
+    const systemCode = String(args.systemCode ?? '').trim().toUpperCase();
+    const ciArgs = {systemCode, environment: 'stg'};
+    const ci = await runToolOrThrow('create_ci_ticket', ciArgs, deps, workflowLog);
+
+    const build = await runToolOrThrow('build_ticket', {issueKey: ci.issueKey}, deps, workflowLog);
+    const toStg = await runToolOrThrow('wait_to_stg', {issueKey: ci.issueKey}, deps, workflowLog);
+
+    const clusters = getClusterList(systemCode, 'stg');
+    if (!clusters.length) {
+      throw new Error(`找不到 ${systemCode} STG 的 cluster 設定`);
+    }
+
+    const cdArgs = {
+      systemCode,
+      environment: 'stg',
+      linkedCiKey: ci.issueKey,
+      clusterDeploy: clusters.join(','),
+      moduleChild: systemCode.toLowerCase(),
+    };
+    const cd = await runToolOrThrow('create_cd_ticket', cdArgs, deps, workflowLog);
+    const prepared = await runToolOrThrow(
+      'prepare_cd_deployment',
+      {issueKey: cd.issueKey, environment: 'stg'},
+      deps,
+      workflowLog,
+    );
+    const deployed = await runToolOrThrow(
+      'trigger_deployment',
+      {cdIssueKey: cd.issueKey, environment: 'stg', applyForClose: true},
+      deps,
+      workflowLog,
+    );
+
+    return ok({
+      type: 'STG Full Release',
+      systemCode,
+      ciIssueKey: ci.issueKey,
+      ciStatus: toStg.status ?? build.status,
+      cdIssueKey: cd.issueKey,
+      cdStatus: prepared.status,
+      deploymentStatus: deployed.status,
+      assumptions: [`CD cluster 自動帶入 ${systemCode} STG 全部 cluster`],
+      workflowLog,
+    });
+  } catch (err) {
+    return error(`run_stg_full_release 失敗: ${err.message}`);
+  }
+}
+
+export async function handleRunLibToStgReleaseWorkflow(args, deps) {
+  try {
+    const workflowLog = [];
+    const assumptions = [];
+    const systemCode = String(args.systemCode ?? '').trim().toUpperCase();
+    const module = args.module || systemCode.toLowerCase();
+
+    if (!args.module) {
+      assumptions.push(`未指定 module，已依 systemCode 帶入 ${module}`);
+    }
+
+    const libArgs = {
+      systemCode,
+      module,
+      gitBranch: args.gitBranch,
+      environment: 'stg',
+      jenkinsBranch: 'master',
+    };
+    const lib = await runToolOrThrow('create_library_ticket', libArgs, deps, workflowLog);
+    await runToolOrThrow('build_ticket', {issueKey: lib.issueKey}, deps, workflowLog);
+    const libFinalStatus = await waitForIssueStatus(
+      lib.issueKey,
+      ['Released'],
+      deps,
+      {timeoutMs: 10 * 60 * 1000, ...deps.workflowWaitOptions},
+    );
+    workflowLog.push(`- wait_library_status: ${lib.issueKey} -> ${libFinalStatus}`);
+
+    const ciArgs = {
+      systemCode,
+      environment: 'stg',
+      relatesTo: lib.issueKey,
+    };
+    const ci = await runToolOrThrow('create_ci_ticket', ciArgs, deps, workflowLog);
+    const build = await runToolOrThrow('build_ticket', {issueKey: ci.issueKey}, deps, workflowLog);
+    const toStg = await runToolOrThrow('wait_to_stg', {issueKey: ci.issueKey}, deps, workflowLog);
+
+    const clusters = getClusterList(systemCode, 'stg');
+    if (!clusters.length) {
+      throw new Error(`找不到 ${systemCode} STG 的 cluster 設定`);
+    }
+    assumptions.push(`CD cluster 自動帶入 ${systemCode} STG 全部 cluster`);
+
+    const cdArgs = {
+      systemCode,
+      environment: 'stg',
+      linkedCiKey: ci.issueKey,
+      clusterDeploy: clusters.join(','),
+      moduleChild: systemCode.toLowerCase(),
+    };
+    const cd = await runToolOrThrow('create_cd_ticket', cdArgs, deps, workflowLog);
+    const prepared = await runToolOrThrow(
+      'prepare_cd_deployment',
+      {issueKey: cd.issueKey, environment: 'stg'},
+      deps,
+      workflowLog,
+    );
+    const deployed = await runToolOrThrow(
+      'trigger_deployment',
+      {cdIssueKey: cd.issueKey, environment: 'stg', applyForClose: true},
+      deps,
+      workflowLog,
+    );
+
+    return ok({
+      type: 'Library To STG Full Release',
+      systemCode,
+      module,
+      gitBranch: args.gitBranch,
+      libraryIssueKey: lib.issueKey,
+      libraryStatus: libFinalStatus,
+      ciIssueKey: ci.issueKey,
+      ciStatus: toStg.status ?? build.status,
+      cdIssueKey: cd.issueKey,
+      cdStatus: prepared.status,
+      deploymentStatus: deployed.status,
+      assumptions,
+      workflowLog,
+    });
+  } catch (err) {
+    return error(`run_lib_to_stg_release 失敗: ${err.message}`);
+  }
+}