@jira-deploy/core 1.0.1 → 1.0.3

package/constants/environments.js

@@ -22,7 +22,7 @@ export const DEPT_CODES = {
 export const SUPPORTED_ENVS = {
   library: ['dev', 'stg', 'uat', 'prd'],
   ci: ['dev', 'stg'],
-  cd: ['stg', 'uat', 'prd/dr', 'prd', 'dr'],
+  cd: ['dev', 'stg', 'uat', 'prd/dr', 'prd', 'dr'],
   grayRelease: ['dev', 'stg', 'uat'],
 };
 

package/constants/field-ids.js

@@ -60,4 +60,7 @@ export const GRAY_RELEASE_FIELD_IDS = {
   grayReleaseVersion: 'customfield_14700',
   clusterList: 'customfield_14701',
   grayReleaseNotes: 'customfield_14511',
+  // Field names resolved to customfield IDs at runtime.
+  buildResult: 'CID_build_result',
+  deployResult: 'CID_deploy_result',
 };

package/dry-run.js

@@ -24,15 +24,19 @@
  *  node src/dry-run.js create_ci_ticket '{"systemCode":"IBK","relatesTo":["CID-1708"]}'
  *  node src/dry-run.js create_ci_ticket '{"systemCode":"IBK","relatesTo":["CID-1178","CID-1182"]}'
  *  node src/dry-run.js build_ticket '{"issueKey":"CID-1709"}' --live
+ *  node src/dry-run.js wait_to_dev '{"issueKey":"CID-1709"}' --live
  *  node src/dry-run.js wait_to_stg '{"issueKey":"CID-1709"}' --live
  *
  *  # CD 票
+ *  node src/dry-run.js create_cd_ticket '{"systemCode":"IBK","environment":"dev","ciTicket":"CID-1709"}'
  *  node src/dry-run.js create_cd_ticket '{"systemCode":"IBK","environment":"stg","ciTicket":"CID-1709"}'
  *  node src/dry-run.js create_cd_ticket '{"systemCode":"CWA","environment":"prd","ciTicket":"CID-1709","metaTest":true}'
  *  node src/dry-run.js create_cd_ticket '{"systemCode":"IBK","environment":"prd","ciTicket":"CID-1709","metaTest":true}' --live
+ *  node src/dry-run.js prepare_cd_deployment '{"issueKey":"CID-1710","environment":"dev"}' --live
  *  node src/dry-run.js prepare_cd_deployment '{"issueKey":"CID-1710","environment":"stg"}' --live
  *
  *  # Deployment sub-task 觸發（新）
+ *  node src/dry-run.js trigger_deployment '{"cdIssueKey":"CID-1710","environment":"dev"}' --live
  *  node src/dry-run.js trigger_deployment '{"cdIssueKey":"CID-1710","environment":"stg"}' --live
  *  node src/dry-run.js trigger_deployment '{"cdIssueKey":"CID-1713","environment":"uat"}' --live
  *  node src/dry-run.js trigger_deployment '{"cdIssueKey":"CID-1716","environment":"stg","applyForClose":true}' --live

package/jira-client.js

@@ -21,6 +21,7 @@ export class JiraClient {
       },
     });
     this.dryRun = DRY_RUN;
+    this.fieldIdByName = new Map();
   }
 
   // 建立 issue
@@ -93,6 +94,18 @@ export class JiraClient {
     return res.data.fields;
   }
 
+  async getFieldIdByName(fieldName) {
+    if (this.fieldIdByName.has(fieldName)) {
+      return this.fieldIdByName.get(fieldName);
+    }
+
+    const res = await this.http.get('/field');
+    const field = (res.data ?? []).find((item) => item.id === fieldName || item.name === fieldName);
+    const fieldId = field?.id ?? fieldName;
+    this.fieldIdByName.set(fieldName, fieldId);
+    return fieldId;
+  }
+
   // 依 ID 直接切換狀態（不查名稱，適合 race condition 處理）
   async transitionById(issueKey, transitionId) {
     if (this.dryRun) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jira-deploy/core",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "main": "./index.js",
   "repository": {

package/tools/cd.js

@@ -30,7 +30,7 @@ export function getCDToolDefinitions() {
       description: '建立 CD Deploy 上版單。專用工具，提前驗證必填欄位和叢集配置',
       inputSchema: {
         type: 'object',
-        required: ['systemCode', 'ciTicket'],
+        required: ['systemCode', 'environment'],
         properties: {
           systemCode: {
             type: 'string',
@@ -56,6 +56,26 @@ export function getCDToolDefinitions() {
             description:
               '關聯的 CI 單 issue key，例如 CID-1677。自動：① 取 release_version 填入 summary/CID_deploy_version ② 查 CI 所有 relates Library 單，各自取 CID_branch 找 LBPRJ 版本頁 → 加 Web Link',
           },
+          linkedCiKey: {
+            type: 'string',
+            description: '關聯的 CI 單 issue key；等同 ciTicket，保留給 agent/CLI workflow 使用',
+          },
+          clusterDeploy: {
+            type: 'string',
+            description: '(選填) 逗號分隔的 cluster 清單；不填時依 systemCode/environment 自動推導',
+          },
+          moduleChild: {
+            type: 'string',
+            description: '(選填) 模組 child 名稱；不填時預設同 systemCode 小寫',
+          },
+          restartOnly: {
+            type: 'boolean',
+            description: '(選填) 是否只重啟不部署',
+          },
+          extraVars: {
+            type: 'string',
+            description: '(選填) 自訂部署 extra vars JSON 字串；不填時依 system/module/env 自動生成',
+          },
           metaTest: {
             type: 'boolean',
             description:
@@ -254,7 +274,7 @@ export async function handleCreateCDTicket(args, {jira, notifier}) {
 
     await notifier.notify(
       issue.key,
-      `CD Deploy 單已建立。系統: ${args.systemCode}, 環境: ${args.environment}, Cluster: ${args.clusterDeploy}`,
+      `CD Deploy 單已建立。系統: ${normalizedArgs.systemCode}, 環境: ${normalizedArgs.environment}, Cluster: ${serverList.join(',')}`,
     );
     return ok({
       issueKey: issue.key,
@@ -263,6 +283,8 @@ export async function handleCreateCDTicket(args, {jira, notifier}) {
       type: 'CD Deploy',
       system: normalizedArgs.systemCode,
       environment: normalizedArgs.environment,
+      clusterDeploy: serverList,
+      isClusterDeploy: normalizedArgs.isClusterDeploy,
     });
   } catch (err) {
     return error(`無法建立 CD 單: ${err.message}`);