@jira-deploy/core 1.0.0

package/tools.test.js

@@ -0,0 +1,1711 @@
+/**
+ * index.js fields 單元測試
+ * 執行：node --test src/tools.test.js
+ */
+import { test, describe } from 'node:test';
+import assert from 'node:assert/strict';
+import { executeTool } from './tools/index.js';
+
+process.env.JIRA_BASE_URL = 'https://jira.test';
+
+// ── Mock factories ──────────────────────────────────────────────────────────
+
+/**
+ * @param {{
+ *   releaseVersion?: string|null,
+ *   deployVersionJson?: string|null,
+ *   issueLinks?: object[],
+ *   libraryBranches?: Record<string, string>,
+ *   libraryModules?: Record<string, {parentId:string, childId:string}>,
+ *   projectVersions?: {id:string, name:string}[],
+ *   libraryComments?: Record<string, string>,
+ *   bitbucketLastTag?: string,
+ *   searchIssuesResult?: object[],  // 回傳給 findPrevLibraryDeployedToEnv 的前一張 Library 清單
+ *   ciFieldsMap?: Record<string, object>, // ciKey → { status, issuelinks }（給 findPrevLibraryDeployedToEnv 用）
+ *   ciSummary?: string|null,  // CI 單 summary（用於 ciReleaseVersion 3rd fallback 測試）
+ * }} opts
+ */
+function makeMockJira({
+  releaseVersion = null,
+  deployVersionJson = null,
+  issueLinks = [],
+  libraryBranches = {},
+  libraryModules = {},
+  projectVersions = [],
+  libraryComments = {},
+  bitbucketLastTag = null,
+  searchIssuesResult = [],
+  ciFieldsMap = {},
+  ciSummary = null,
+} = {}) {
+  const calls = {
+    createIssue: [],
+    linkIssue: [],
+    addRemoteLink: [],
+    getBitbucketTags: [],
+    getBitbucketBranches: [],
+    updateIssue: [],
+  };
+  return {
+    calls,
+    createIssue: async (fields) => {
+      calls.createIssue.push(fields);
+      return { id: '999', key: 'CID-9999', self: '' };
+    },
+    updateIssue: async (key, fields) => {
+      calls.updateIssue.push({ key, fields });
+      return {};
+    },
+    getIssueFields: async (key, fieldNames) => {
+      // ciFieldsMap 優先（供 findPrevLibraryDeployedToEnv 的 CI 查詢使用）
+      if (ciFieldsMap[key]) return ciFieldsMap[key];
+      const field = fieldNames[0];
+      if (field === 'issuelinks') return { issuelinks: issueLinks };
+      if (field === 'customfield_13431') {
+        const result = { customfield_13431: libraryBranches[key] ?? '' };
+        // 只在明確請求 'comment' 時才回傳（模擬真實 Jira API 只回傳請求的欄位）
+        if (fieldNames.includes('comment') && libraryComments[key]) {
+          result.comment = { comments: [{ body: libraryComments[key] }] };
+        }
+        return result;
+      }
+      // customfield_13702：Library 模組階層欄位（parentId + child.id，用於 extraVars 動態推導）
+      if (field === 'customfield_13702') {
+        const mod = libraryModules[key];
+        if (mod) return { customfield_13702: { id: mod.parentId, child: { id: mod.childId } } };
+        return { customfield_13702: null };
+      }
+      // customfield_13438 = CI_FIELD_IDS.deployVersion（CI 的 deploy version JSON）
+      if (field === 'customfield_13438') return { customfield_13438: deployVersionJson };
+      // summary field（用於 ciReleaseVersion 3rd fallback）
+      if (field === 'summary') return { summary: ciSummary };
+      return { [field]: releaseVersion };
+    },
+    searchIssues: async () => searchIssuesResult,
+    getBitbucketTags: async (project, repo, opts) => {
+      calls.getBitbucketTags.push({ project, repo, opts });
+      return bitbucketLastTag ? [{ displayId: bitbucketLastTag }] : [];
+    },
+    getBitbucketBranches: async (project, repo, opts) => {
+      calls.getBitbucketBranches.push({ project, repo, opts });
+      return bitbucketLastTag ? [{ displayId: bitbucketLastTag }] : [];
+    },
+    getProjectVersions: async (key, { name } = {}) => {
+      const v = projectVersions.find((v) => v.name === name);
+      return v?.id ?? null;
+    },
+    getBitbucketFileContent: async (project, repo, filePath, branch) => {
+      // 預設：回傳與 branch 對應的 mock XML（版本 = branch 去前綴後 + -0.0.1）
+      const fixVer = branch.replace(/^release[\/\-]/, '');
+      return `<root><version>${fixVer}-0.0.1</version></root>`;
+    },
+    linkIssue: async (inward, outward, type) => {
+      calls.linkIssue.push({ inward, outward, type });
+      return {};
+    },
+    addRemoteLink: async (issueKey, url, title) => {
+      calls.addRemoteLink.push({ issueKey, url, title });
+      return {};
+    },
+    getIssue: async () => ({ fields: { status: { name: 'TO DO' }, summary: 'test' } }),
+    getTransitions: async () => [],
+    transitionById: async () => {},
+    transitionByName: async () => ({ transitioned: 'Test', toStatus: 'Done' }),
+    addComment: async () => {},
+    getSubTasks: async () => [],
+  };
+}
+
+const mockNotifier = { notify: async () => [] };
+
+/** 執行 tool，回傳 createIssue 收到的 fields（合併 updateIssue 的欄位，或 throw 若 ❌） */
+async function getCreatedFields(toolName, args, jiraOpts = {}) {
+  const jira = makeMockJira(jiraOpts);
+  const result = await executeTool(toolName, args, { jira, notifier: mockNotifier });
+  const text = result.content[0].text;
+  if (text.startsWith('❌')) throw new Error(`Tool returned error: ${text}`);
+  const created = { ...jira.calls.createIssue[0] };
+  // 合併 updateIssue 的欄位（例如 description 是事後透過 updateIssue 寫入）
+  for (const update of jira.calls.updateIssue) {
+    Object.assign(created, update.fields);
+  }
+  return created;
+}
+
+/** 建立模擬 Library issue link（inward direction） */
+function makeLibraryLink(key) {
+  return {
+    type: { name: 'Relates', inward: 'is related to', outward: 'relates to' },
+    inwardIssue: {
+      key,
+      fields: { issuetype: { name: 'Library' }, summary: `[IBK][Lib] mock ${key}` },
+    },
+  };
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// create_library_ticket
+// ═══════════════════════════════════════════════════════════════════
+describe('create_library_ticket — fields', () => {
+  const BASE = { systemCode: 'IBK', moduleChild: 'ibk', repo: 'release/v1.5.2.0' };
+
+  test('project.key = CID', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.deepEqual(f.project, { key: 'CID' });
+  });
+  test('issuetype.id = 12501 (Library)', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.deepEqual(f.issuetype, { id: '12501' });
+  });
+  test('duedate = today (YYYY-MM-DD)', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.match(f.duedate, /^\d{4}-\d{2}-\d{2}$/);
+  });
+  test('summary 自動生成：[IBK][Lib] Release for v1.5.2.0-0.0.2（XML 現版 0.0.1 +1）', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.equal(f.summary, '[IBK][Lib] Release for v1.5.2.0-0.0.2');
+  });
+  test('summary 自訂覆蓋', async () => {
+    const f = await getCreatedFields('create_library_ticket', {
+      ...BASE,
+      summary: '[Custom] My Lib',
+    });
+    assert.equal(f.summary, '[Custom] My Lib');
+  });
+  test('customfield_13702 (libModuleParent) IBK parent=15600, ibk child=15601', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.deepEqual(f['customfield_13702'], { id: '15600', child: { id: '15601' } });
+  });
+  test('customfield_13702 CWA parent=15513, cwa child=15514', async () => {
+    const f = await getCreatedFields('create_library_ticket', {
+      systemCode: 'CWA',
+      moduleChild: 'cwa',
+      repo: 'release/v1.0.0',
+    });
+    assert.deepEqual(f['customfield_13702'], { id: '15513', child: { id: '15514' } });
+  });
+  test('customfield_13436 (env) stg → id 14356', async () => {
+    const f = await getCreatedFields('create_library_ticket', { ...BASE, environment: 'stg' });
+    assert.deepEqual(f['customfield_13436'], { id: '14356' });
+  });
+  test('customfield_13436 (env) uat → id 14357', async () => {
+    const f = await getCreatedFields('create_library_ticket', { ...BASE, environment: 'uat' });
+    assert.deepEqual(f['customfield_13436'], { id: '14357' });
+  });
+  test('customfield_13434 (deptCode) IBK → CH014 → id 14520', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.deepEqual(f['customfield_13434'], { id: '14520' });
+  });
+  test('customfield_13434 (deptCode) EVT → CH015 → id 14521', async () => {
+    const f = await getCreatedFields('create_library_ticket', {
+      systemCode: 'EVT',
+      moduleChild: 'evt007',
+      repo: 'release/v1.0.0',
+    });
+    assert.deepEqual(f['customfield_13434'], { id: '14521' });
+  });
+  test('customfield_13807 (fortifyScan) 預設 = scanned (14602)', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.deepEqual(f['customfield_13807'], { id: '14602' });
+  });
+  test('customfield_13807 (fortifyScan) fortifyScan=true → scanned (14602)', async () => {
+    const f = await getCreatedFields('create_library_ticket', { ...BASE, fortifyScan: true });
+    assert.deepEqual(f['customfield_13807'], { id: '14602' });
+  });
+  test('customfield_13807 (fortifyScan) fortifyScan=false → notScanned (14603)', async () => {
+    const f = await getCreatedFields('create_library_ticket', { ...BASE, fortifyScan: false });
+    assert.deepEqual(f['customfield_13807'], { id: '14603' });
+  });
+  test('customfield_14702 (jenkinsBranch) = master', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.equal(f['customfield_14702'], 'master');
+  });
+  test('customfield_13431 (gitBranch) = repo arg', async () => {
+    const f = await getCreatedFields('create_library_ticket', BASE);
+    assert.equal(f['customfield_13431'], 'release/v1.5.2.0');
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// create_ci_ticket
+// ═══════════════════════════════════════════════════════════════════
+describe('create_ci_ticket — fields', () => {
+  const BASE = { systemCode: 'IBK' };
+
+  test('project.key = CID', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.deepEqual(f.project, { key: 'CID' });
+  });
+  test('issuetype.id = 12305 (CI)', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.deepEqual(f.issuetype, { id: '12305' });
+  });
+  test('duedate = today (YYYY-MM-DD)', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.match(f.duedate, /^\d{4}-\d{2}-\d{2}$/);
+  });
+  test('summary with goldenImageVersion：[IBK][CI] IBK & WEALTH & SSR & A11Y for 0.0.1', async () => {
+    const f = await getCreatedFields('create_ci_ticket', { ...BASE, goldenImageVersion: '0.0.1' });
+    assert.equal(f.summary, '[IBK][CI] IBK & WEALTH & SSR & A11Y for 0.0.1');
+  });
+  test('summary without goldenImageVersion：[IBK][CI] IBK & WEALTH & SSR & A11Y', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.equal(f.summary, '[IBK][CI] IBK & WEALTH & SSR & A11Y');
+  });
+  test('summary CWA single module：[CWA][CI] CWA for 1.0.0', async () => {
+    const f = await getCreatedFields('create_ci_ticket', {
+      systemCode: 'CWA',
+      goldenImageVersion: '1.0.0',
+    });
+    assert.equal(f.summary, '[CWA][CI] CWA for 1.0.0');
+  });
+  test('summary 自訂覆蓋', async () => {
+    const f = await getCreatedFields('create_ci_ticket', { ...BASE, summary: '[Custom] CI' });
+    assert.equal(f.summary, '[Custom] CI');
+  });
+  test('customfield_13443 (systemCode) = { value: IBK }', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.deepEqual(f['customfield_13443'], { value: 'IBK' });
+  });
+  test('customfield_13436 (env) 預設 stg → id 14356', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.deepEqual(f['customfield_13436'], { id: '14356' });
+  });
+  test('customfield_13436 (env) uat → id 14357', async () => {
+    const f = await getCreatedFields('create_ci_ticket', { ...BASE, environment: 'uat' });
+    assert.deepEqual(f['customfield_13436'], { id: '14357' });
+  });
+  test('customfield_13434 (deptCode) IBK → CH014 → id 14520', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.deepEqual(f['customfield_13434'], { id: '14520' });
+  });
+  test('customfield_13434 (deptCode) BOF → CH015 → id 14521', async () => {
+    const f = await getCreatedFields('create_ci_ticket', { systemCode: 'BOF' });
+    assert.deepEqual(f['customfield_13434'], { id: '14521' });
+  });
+  test('customfield_13444 (systemModule) = assembly (id 14369)', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.deepEqual(f['customfield_13444'], { id: '14369' });
+  });
+  test('customfield_13431 (gitBranch) = master', async () => {
+    const f = await getCreatedFields('create_ci_ticket', BASE);
+    assert.equal(f['customfield_13431'], 'master');
+  });
+  test('relatesTo: 呼叫 linkIssue(ci, lib, Relates)', async () => {
+    const jira = makeMockJira();
+    await executeTool(
+      'create_ci_ticket',
+      { ...BASE, relatesTo: 'CID-1675' },
+      { jira, notifier: mockNotifier },
+    );
+    assert.equal(jira.calls.linkIssue.length, 1);
+    assert.equal(jira.calls.linkIssue[0].inward, 'CID-9999');
+    assert.equal(jira.calls.linkIssue[0].outward, 'CID-1675');
+    assert.equal(jira.calls.linkIssue[0].type, 'Relates');
+  });
+  test('沒有 relatesTo: 不呼叫 linkIssue', async () => {
+    const jira = makeMockJira();
+    await executeTool('create_ci_ticket', BASE, { jira, notifier: mockNotifier });
+    assert.equal(jira.calls.linkIssue.length, 0);
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// create_cd_ticket — fields
+// ═══════════════════════════════════════════════════════════════════
+describe('create_cd_ticket — fields', () => {
+  const BASE = {
+    systemCode: 'IBK',
+    environment: 'stg',
+    clusterDeploy: 'tvstg-ibk-web01,tvstg-ibk-web02',
+    linkedCiKey: 'CID-1677',
+  };
+
+  test('project.key = CID', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.deepEqual(f.project, { key: 'CID' });
+  });
+  test('issuetype.id = 12306 (CD)', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.deepEqual(f.issuetype, { id: '12306' });
+  });
+  test('summary 使用 CI release_version：包含版號且前綴 [IBK][STG]', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: '1.5.2.0' });
+    assert.ok(f.summary.startsWith('[IBK][STG]'), `prefix 錯誤: "${f.summary}"`);
+    assert.ok(f.summary.includes('1.5.2.0'), `版號缺失: "${f.summary}"`);
+  });
+  test('summary fallback to linkedCiKey when release_version 為空', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: null });
+    assert.ok(f.summary.includes('CID-1677'), `fallback 失敗: "${f.summary}"`);
+  });
+  test('summary 使用 CI deploy_version JSON：包含版號且前綴 [IBK][STG]', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, {
+      deployVersionJson: '{"ibk_ap_version":"1.5.2.0"}',
+    });
+    assert.ok(f.summary.startsWith('[IBK][STG]'), `prefix 錯誤: "${f.summary}"`);
+    assert.ok(f.summary.includes('1.5.2.0'), `版號缺失: "${f.summary}"`);
+  });
+  test('summary fallback to linkedCiKey when deploy_version 為空', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { deployVersionJson: null });
+    assert.ok(f.summary.includes('CID-1677'), `fallback 失敗: "${f.summary}"`);
+  });
+  test('summary prd env → displayEnv = PRD/DR', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'prd',
+      clusterDeploy: 'tvprd-ibk-web01',
+    });
+    assert.ok(f.summary.includes('[IBK][PRD/DR]'), `displayEnv 錯誤: "${f.summary}"`);
+  });
+  test('summary prd/dr env → displayEnv = PRD/DR', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'prd/dr',
+      clusterDeploy:
+        'tvprd-ibk-web01,tvprd-ibk-web02,tvprd-ibk-web03,tvprd-ibk-web04,tvprd-ibk-web05,lvprd-ibk-web01,lvprd-ibk-web02',
+    });
+    assert.ok(f.summary.includes('[IBK][PRD/DR]'), `prd/dr displayEnv 錯誤: "${f.summary}"`);
+  });
+  test('summary 自訂覆蓋', async () => {
+    const f = await getCreatedFields('create_cd_ticket', { ...BASE, summary: '[Custom] CD' });
+    assert.equal(f.summary, '[Custom] CD');
+  });
+  test('customfield_13436 (CID_env) stg → id 14356', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.deepEqual(f['customfield_13436'], { id: '14356' });
+  });
+  test('customfield_13436 (CID_env) uat → id 14357', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'uat',
+      clusterDeploy: 'tvuat-ibk-web01',
+    });
+    assert.deepEqual(f['customfield_13436'], { id: '14357' });
+  });
+  test('customfield_13434 (CID_dept_code) IBK → CH014 → id 14520', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.deepEqual(f['customfield_13434'], { id: '14520' });
+  });
+  test('customfield_13443 (CID_system_code) = { value: IBK }', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.deepEqual(f['customfield_13443'], { value: 'IBK' });
+  });
+  test('customfield_14704 (CID_cluster_deploy) STG → true (id 15506)', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.deepEqual(f['customfield_14704'], { id: '15506' });
+  });
+  test('customfield_14704 (CID_cluster_deploy) DEV → false (id 15505)', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'dev',
+      clusterDeploy: 'tvdev-ibk-web01',
+    });
+    assert.deepEqual(f['customfield_14704'], { id: '15505' });
+  });
+  test('customfield_14704 (CID_cluster_deploy) UAT → true (id 15506)', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'uat',
+      clusterDeploy: 'tvuat-ibk-web01',
+    });
+    assert.deepEqual(f['customfield_14704'], { id: '15506' });
+  });
+  test('customfield_14101 (CID_deploy_version) = CI deploy_version JSON（完整字串）', async () => {
+    const deployJson = '{"ibk_ap_version":"1.5.2.0"}';
+    const f = await getCreatedFields('create_cd_ticket', BASE, { deployVersionJson: deployJson });
+    assert.equal(f['customfield_14101'], deployJson);
+  });
+  test('customfield_14101 不設定 when deploy_version 為空', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { deployVersionJson: null });
+    assert.equal(f['customfield_14101'], undefined);
+  });
+  test('customfield_14101 (CID_deploy_version) = CI release_version', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: '1.5.2.0' });
+    assert.equal(f['customfield_14101'], '1.5.2.0');
+  });
+  test('customfield_14101 不設定 when release_version 為空', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: null });
+    assert.equal(f['customfield_14101'], undefined);
+  });
+  test('customfield_13436 (CID_env) prd/dr → id 14360', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'prd/dr',
+      clusterDeploy:
+        'tvprd-ibk-web01,tvprd-ibk-web02,tvprd-ibk-web03,tvprd-ibk-web04,tvprd-ibk-web05,lvprd-ibk-web01,lvprd-ibk-web02',
+    });
+    assert.deepEqual(f['customfield_13436'], { id: '14360' });
+  });
+  test('customfield_13442 (CID_server_list) = 換行分隔 cluster 清單', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.equal(f['customfield_13442'], 'tvstg-ibk-web01\ntvstg-ibk-web02');
+  });
+  test('customfield_13442 單台 cluster = 無換行', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'dev',
+      clusterDeploy: 'tvdev-ibk-web01',
+    });
+    assert.equal(f['customfield_13442'], 'tvdev-ibk-web01');
+  });
+  test('customfield_13437 (CID_extra_vars) IBK STG 自動生成', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    const ev = JSON.parse(f['customfield_13437']);
+    const serverMap = { 'tvstg-ibk-web01': true, 'tvstg-ibk-web02': true };
+    assert.deepEqual(ev, {
+      ibk_ibk_installation: serverMap,
+      ibk_wealth_installation: serverMap,
+      ibk_ssr_installation: serverMap,
+      ibk_a11y_installation: serverMap,
+    });
+  });
+  test('customfield_13437 CWA STG 自動生成', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'CWA',
+      environment: 'stg',
+      clusterDeploy: 'tvstg-cwa-web01,tvstg-cwa-web02',
+    });
+    const ev = JSON.parse(f['customfield_13437']);
+    assert.deepEqual(ev, {
+      cwa_cwa_installation: { 'tvstg-cwa-web01': true, 'tvstg-cwa-web02': true },
+    });
+  });
+  test('customfield_13437 extraVars 自訂覆蓋', async () => {
+    const custom = '{"ibk_ibk_installation":{"tvstg-ibk-web05":true}}';
+    const f = await getCreatedFields('create_cd_ticket', { ...BASE, extraVars: custom });
+    assert.equal(f['customfield_13437'], custom);
+  });
+
+  // ── extraVars 動態模組推導（從 CI 關聯 Library customfield_13702）────
+  test('extraVars 動態推導：IBK CI 關聯 ibk+ssr → 只含 ibk & ssr，不含 wealth/a11y', async () => {
+    // IBK_MODULE_IDS: ibk=15601, a11y=15602, landing=15603, ssr=15604, wealth=15605
+    const f = await getCreatedFields('create_cd_ticket', BASE, {
+      issueLinks: [makeLibraryLink('CID-1675'), makeLibraryLink('CID-1676')],
+      libraryModules: {
+        'CID-1675': { parentId: '15600', childId: '15601' }, // ibk
+        'CID-1676': { parentId: '15600', childId: '15604' }, // ssr
+      },
+    });
+    const ev = JSON.parse(f['customfield_13437']);
+    const serverMap = { 'tvstg-ibk-web01': true, 'tvstg-ibk-web02': true };
+    assert.deepEqual(
+      ev,
+      {
+        ibk_ibk_installation: serverMap,
+        ibk_ssr_installation: serverMap,
+      },
+      `extraVars 應只含 ibk+ssr: ${JSON.stringify(ev)}`,
+    );
+    assert.ok(!('ibk_wealth_installation' in ev), 'extraVars 不應含 wealth');
+    assert.ok(!('ibk_a11y_installation' in ev), 'extraVars 不應含 a11y');
+  });
+
+  test('extraVars 動態推導：CWA CI 關聯單一 Library → 只含 cwa', async () => {
+    // CWA_MODULE_IDS: cwa=15514, parent=15513
+    const f = await getCreatedFields(
+      'create_cd_ticket',
+      {
+        systemCode: 'CWA',
+        environment: 'stg',
+        clusterDeploy: 'tvstg-cwa-web01,tvstg-cwa-web02',
+        linkedCiKey: 'CID-1668',
+      },
+      {
+        issueLinks: [makeLibraryLink('CID-2000')],
+        libraryModules: { 'CID-2000': { parentId: '15513', childId: '15514' } }, // cwa
+      },
+    );
+    const ev = JSON.parse(f['customfield_13437']);
+    assert.deepEqual(
+      ev,
+      {
+        cwa_cwa_installation: { 'tvstg-cwa-web01': true, 'tvstg-cwa-web02': true },
+      },
+      `extraVars 應只含 cwa: ${JSON.stringify(ev)}`,
+    );
+  });
+
+  test('extraVars 動態推導：Library customfield_13702 為空 → fallback 到 SYSTEM_MODULES 全模組', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      // libraryModules 未設定 → customfield_13702 = null → detectedModules 空 → fallback
+    });
+    const ev = JSON.parse(f['customfield_13437']);
+    const serverMap = { 'tvstg-ibk-web01': true, 'tvstg-ibk-web02': true };
+    assert.deepEqual(
+      ev,
+      {
+        ibk_ibk_installation: serverMap,
+        ibk_wealth_installation: serverMap,
+        ibk_ssr_installation: serverMap,
+        ibk_a11y_installation: serverMap,
+      },
+      'fallback 應回退到全部 SYSTEM_MODULES',
+    );
+  });
+
+  test('extraVars 動態推導：無 Library 關聯（issueLinks 空）→ fallback 到 SYSTEM_MODULES', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { issueLinks: [] });
+    const ev = JSON.parse(f['customfield_13437']);
+    assert.ok('ibk_ibk_installation' in ev, 'fallback 應含 ibk');
+    assert.ok('ibk_wealth_installation' in ev, 'fallback 應含 wealth');
+    assert.ok('ibk_ssr_installation' in ev, 'fallback 應含 ssr');
+    assert.ok('ibk_a11y_installation' in ev, 'fallback 應含 a11y');
+  });
+
+  test('extraVars 動態推導：重複模組 ID 去重', async () => {
+    // 兩個 Library 都對應同一個 module（ibk）
+    const f = await getCreatedFields('create_cd_ticket', BASE, {
+      issueLinks: [makeLibraryLink('CID-1675'), makeLibraryLink('CID-1676')],
+      libraryModules: {
+        'CID-1675': { parentId: '15600', childId: '15601' }, // ibk
+        'CID-1676': { parentId: '15600', childId: '15601' }, // ibk（重複）
+      },
+    });
+    const ev = JSON.parse(f['customfield_13437']);
+    const keys = Object.keys(ev);
+    assert.equal(
+      keys.filter((k) => k === 'ibk_ibk_installation').length,
+      1,
+      '重複模組應去重為 1 筆',
+    );
+  });
+  test('customfield_14102 (CID_restart_only) true → id 14902', async () => {
+    const f = await getCreatedFields('create_cd_ticket', { ...BASE, restartOnly: true });
+    assert.deepEqual(f['customfield_14102'], { id: '14902' });
+  });
+  test('customfield_14102 (CID_restart_only) false → id 14901', async () => {
+    const f = await getCreatedFields('create_cd_ticket', { ...BASE, restartOnly: false });
+    assert.deepEqual(f['customfield_14102'], { id: '14901' });
+  });
+  test('customfield_14102 未傳 restartOnly → 不設定', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE);
+    assert.equal(f['customfield_14102'], undefined);
+  });
+
+  // ── CI ←→ CD linkIssue ───────────────────────────────────────
+  test('linkedCiKey: 呼叫 linkIssue(ci, cd, Hierarchy link (WBSGantt))', async () => {
+    const jira = makeMockJira();
+    await executeTool('create_cd_ticket', BASE, { jira, notifier: mockNotifier });
+    assert.equal(jira.calls.linkIssue.length, 1);
+    assert.equal(jira.calls.linkIssue[0].inward, 'CID-1677'); // CI key
+    assert.equal(jira.calls.linkIssue[0].outward, 'CID-9999'); // CD key
+    assert.equal(jira.calls.linkIssue[0].type, 'Hierarchy link (WBSGantt)');
+  });
+  test('沒有 linkedCiKey: 不呼叫 linkIssue', async () => {
+    const jira = makeMockJira();
+    await executeTool(
+      'create_cd_ticket',
+      {
+        systemCode: 'IBK',
+        environment: 'stg',
+        clusterDeploy: 'tvstg-ibk-web01',
+      },
+      { jira, notifier: mockNotifier },
+    );
+    assert.equal(jira.calls.linkIssue.length, 0);
+  });
+
+  // ── Remote Link：CI → Library 單 → LBPRJ version → Web Link ──
+  test('2 個 Library 單 → 2 筆 remote link，URL 含正確 version id', async () => {
+    const jira = makeMockJira({
+      issueLinks: [makeLibraryLink('CID-1675'), makeLibraryLink('CID-1676')],
+      libraryBranches: {
+        'CID-1675': 'release/IBK_ibk_1.5.2.0',
+        'CID-1676': 'release/IBK_ssr_1.3.1.0',
+      },
+      projectVersions: [
+        { id: '16157', name: 'IBK_ibk_1.5.2.0' },
+        { id: '16158', name: 'IBK_ssr_1.3.1.0' },
+      ],
+    });
+    await executeTool('create_cd_ticket', BASE, { jira, notifier: mockNotifier });
+
+    assert.equal(jira.calls.addRemoteLink.length, 2);
+    assert.equal(jira.calls.addRemoteLink[0].issueKey, 'CID-9999');
+    assert.equal(
+      jira.calls.addRemoteLink[0].url,
+      'https://jira.test/projects/LBPRJ/versions/16157',
+    );
+    assert.equal(jira.calls.addRemoteLink[0].title, 'IBK_ibk_1.5.2.0');
+    assert.equal(
+      jira.calls.addRemoteLink[1].url,
+      'https://jira.test/projects/LBPRJ/versions/16158',
+    );
+    assert.equal(jira.calls.addRemoteLink[1].title, 'IBK_ssr_1.3.1.0');
+  });
+
+  test('CID_branch 有 release/ 前綴 → 正確去除後比對版本', async () => {
+    const jira = makeMockJira({
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/IBK_ibk_1.5.2.0' }, // has release/ prefix
+      projectVersions: [{ id: '16157', name: 'IBK_ibk_1.5.2.0' }], // version without prefix
+    });
+    await executeTool('create_cd_ticket', BASE, { jira, notifier: mockNotifier });
+
+    assert.equal(jira.calls.addRemoteLink.length, 1);
+    assert.equal(jira.calls.addRemoteLink[0].title, 'IBK_ibk_1.5.2.0');
+  });
+
+  test('CI 關聯的非 Library 單不產生 remote link', async () => {
+    const jira = makeMockJira({
+      issueLinks: [
+        {
+          type: { name: 'Relates' },
+          inwardIssue: {
+            key: 'CID-1680',
+            fields: { issuetype: { name: 'CI' }, summary: 'CI ticket' },
+          },
+        },
+      ],
+      projectVersions: [{ id: '16157', name: 'IBK_ibk_1.5.2.0' }],
+    });
+    await executeTool('create_cd_ticket', BASE, { jira, notifier: mockNotifier });
+    assert.equal(jira.calls.addRemoteLink.length, 0);
+  });
+
+  test('LBPRJ 找不到對應版本 → 跳過不中斷，回傳成功', async () => {
+    const jira = makeMockJira({
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/IBK_ibk_1.5.2.0' },
+      projectVersions: [], // 空，找不到版本
+    });
+    const result = await executeTool('create_cd_ticket', BASE, { jira, notifier: mockNotifier });
+    assert.ok(!result.content[0].text.startsWith('❌'), '不應回傳錯誤');
+    assert.equal(jira.calls.addRemoteLink.length, 0);
+  });
+
+  test('CI issueLinks 空 → 不呼叫 addRemoteLink', async () => {
+    const jira = makeMockJira({ issueLinks: [], projectVersions: [] });
+    await executeTool('create_cd_ticket', BASE, { jira, notifier: mockNotifier });
+    assert.equal(jira.calls.addRemoteLink.length, 0);
+  });
+
+  test('沒有 linkedCiKey → 不呼叫 addRemoteLink', async () => {
+    const jira = makeMockJira();
+    await executeTool(
+      'create_cd_ticket',
+      {
+        systemCode: 'IBK',
+        environment: 'stg',
+        clusterDeploy: 'tvstg-ibk-web01',
+      },
+      { jira, notifier: mockNotifier },
+    );
+    assert.equal(jira.calls.addRemoteLink.length, 0);
+  });
+
+  // ── description 自動生成（generateCDDescription）────────────────
+  test('description 自動生成：開頭含「一般資訊作業申請單」', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: '0.0.11' });
+    assert.ok(
+      f.description.startsWith('||一般資訊作業申請單'),
+      `description 開頭錯誤: "${f.description.slice(0, 40)}"`,
+    );
+  });
+
+  test('description 自動生成：*上版版本號* = ciReleaseVersion (0.0.11)', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: '0.0.11' });
+    assert.ok(f.description.includes('|*上版版本號*|0.0.11|'), `缺少版本號: "${f.description}"`);
+  });
+
+  test('description 自動生成：包含所有必要欄位', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: '0.0.11' });
+    const requiredParts = [
+      '|*相關電子單號*|參照連結|',
+      '|*Purpose*|參照連結|',
+      '|*測試報告 (檢附前一環境 CD 單驗證結果並附上連結)*|參照連結|',
+      '|*SIT 測試涵蓋檢核表 (UAT 申請時需確認)*|參照連結|',
+      '|*UAT 黑箱掃描報告 (PRD 申請時需檢附，需白箱則請附上報告連結)*|不適用|',
+      '|*操作步驟說明*|Ansible 程式上版。|',
+      '|*簽核流程*|',
+    ];
+    for (const part of requiredParts) {
+      assert.ok(f.description.includes(part), `description 缺少: "${part}"`);
+    }
+  });
+
+  test('description 當 ciReleaseVersion 為空 → *上版版本號* 後接空值', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: null });
+    assert.ok(
+      f.description.includes('|*上版版本號*||'),
+      `應含空版本號行: "${f.description.slice(0, 80)}"`,
+    );
+  });
+
+  test('description args.description 附加在自動描述後（以 \\n\\n 分隔）', async () => {
+    const extra = 'release notes: https://bitbucket.example.com/diff';
+    const f = await getCreatedFields(
+      'create_cd_ticket',
+      { ...BASE, description: extra },
+      { releaseVersion: '0.0.11' },
+    );
+    assert.ok(f.description.includes('|*上版版本號*|0.0.11|'), '應含自動描述');
+    assert.ok(
+      f.description.endsWith(`\n\n${extra}`),
+      `應以 \\n\\n + extra 結尾: "${f.description.slice(-60)}"`,
+    );
+  });
+
+  test('description 沒有 args.description → 不含多餘換行', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, { releaseVersion: '0.0.11' });
+    assert.ok(!f.description.includes('\n\n\n'), '不應有三個以上連續換行');
+  });
+
+  // ── ciReleaseVersion 3rd fallback（從 CI summary 解析版號）─────
+  test('ciReleaseVersion 3rd fallback：CI summary "for 0.0.11" → 版本號填入 description 與 summary', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, {
+      releaseVersion: null,
+      deployVersionJson: null,
+      ciSummary: '[IBK][CI] SSR & IBK for 0.0.11',
+    });
+    assert.ok(f.summary.includes('0.0.11'), `3rd fallback summary 失敗: "${f.summary}"`);
+    assert.ok(f.description.includes('|*上版版本號*|0.0.11|'), `3rd fallback description 失敗`);
+    assert.equal(f['customfield_14101'], '0.0.11', '3rd fallback deploy_version 欄位應填入');
+  });
+
+  test('ciReleaseVersion 3rd fallback：CI summary 無版號 → 仍回傳成功（空版本）', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE, {
+      releaseVersion: null,
+      deployVersionJson: null,
+      ciSummary: '[IBK][CI] SSR & IBK', // 無 "for x.y.z"
+    });
+    assert.ok(f.description.includes('|*上版版本號*||'), '應含空版本號');
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// release notes 產生（generateReleaseNotes）
+// ═══════════════════════════════════════════════════════════════════
+describe('create_cd_ticket — release notes', () => {
+  const BASE_CD = {
+    systemCode: 'IBK',
+    environment: 'stg',
+    clusterDeploy: 'tvstg-ibk-web01',
+    linkedCiKey: 'CID-1677',
+  };
+
+  // Jenkins comment 格式：ch014.ibk.{module}-{branch}-{CID_version}
+  const IBK_COMMENT =
+    'Release version [ch014.ibk.ibk-release-v1.5.2.0-0.0.1|https://jenkins/job/1] pass in [Jenkins #1|url]';
+  const SSR_COMMENT =
+    'Release version [ch014.ibk.ssr-release-v1.3.1.0-0.0.1|https://jenkins/job/2] pass in [Jenkins #2|url]';
+  // CWA 格式：branch 已包含 CID_version 後綴（release-v1.5.2.0-0.0.1）
+  const CWA_COMMENT =
+    'Release version [ch014.cwa.cwa-release-v1.5.2.0-0.0.1|https://jenkins/job/3] pass in [Jenkins #3|url]';
+  // moduleKey 無法解析的 comment（無 -release- 結構）
+  const BAD_COMMENT = 'Release version [something-invalid-format|url] pass in [Jenkins #3|url]';
+
+  test('無 Library 單 → description 不含 release notes', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, { issueLinks: [] });
+    assert.ok(!f.description.includes('release notes:'), 'description 不應含 release notes');
+  });
+
+  test('Library 單缺少 Jenkins comment → 跳過，不含 release notes（mock 模擬真實 Jira：未請求 comment 時不回傳）', async () => {
+    // mock 只在 fieldNames.includes('comment') 時才回傳 comment，
+    // 確保 generateReleaseNotes 有明確請求 'comment' 欄位，否則無法解析 CID_version
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      // 沒有 libraryComments → CID_version/moduleKey 解析失敗 → 跳過
+    });
+    assert.ok(!f.description.includes('release notes:'), 'description 不應含 release notes');
+  });
+
+  test('Library Jenkins comment 無法解析 moduleKey → 跳過，不含 release notes', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': BAD_COMMENT },
+    });
+    assert.ok(!f.description.includes('release notes:'), 'description 不應含 release notes');
+  });
+
+  test('單模組 IBK（如果沒有）：description 含 release notes: + Bitbucket compare URL', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': IBK_COMMENT },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    assert.ok(f.description.includes('release notes:'), 'description 應含 release notes:');
+    assert.ok(f.description.includes('IBK:'), 'description 應含 IBK: label');
+    assert.ok(f.description.includes('tw-bank-web'), 'URL 應含 repo');
+    assert.ok(
+      f.description.includes('ci%2Frelease-v1.5.2.0-0.0.1'),
+      'URL 應含 sourceBranch（current tag）',
+    );
+    assert.ok(
+      f.description.includes('release%2Fv1.5.1.0'),
+      'URL 應含 targetBranch（last release/ tag）',
+    );
+    assert.ok(f.description.includes('targetRepoId=110'), 'URL 應含 repoId=110');
+  });
+
+  test('雙模組 IBK + SSR（如果沒有）：description 含兩個 compare URL', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675'), makeLibraryLink('CID-1676')],
+      libraryBranches: {
+        'CID-1675': 'release/v1.5.2.0',
+        'CID-1676': 'release/v1.3.1.0',
+      },
+      libraryComments: {
+        'CID-1675': IBK_COMMENT,
+        'CID-1676': SSR_COMMENT,
+      },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    assert.ok(f.description.includes('IBK:'), 'description 應含 IBK:');
+    assert.ok(f.description.includes('SSR:'), 'description 應含 SSR:');
+    assert.ok(f.description.includes('tw-bank-web-ssr'), 'URL 應含 SSR repo');
+    assert.ok(f.description.includes('ci%2Frelease-v1.3.1.0-0.0.1'), '應含 SSR current tag');
+    assert.ok(f.description.includes('targetRepoId=787'), '應含 SSR repoId=787');
+  });
+
+  test('release notes 在 description 末尾，以 \\n\\n 分隔基礎描述', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': IBK_COMMENT },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    const idx = f.description.indexOf('\n\nrelease notes:');
+    assert.ok(idx > 0, `release notes 應在基礎描述之後以 \\n\\n 分隔，idx=${idx}`);
+  });
+
+  test('Bitbucket API 查無 tag → 跳過該 module', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': IBK_COMMENT },
+      bitbucketLastTag: null,
+    });
+    assert.ok(!f.description.includes('release notes:'), '查無 tag → 跳過，不含 release notes');
+  });
+
+  test('getBitbucketBranches 呼叫時使用 release/ filterValue', async () => {
+    const jira = makeMockJira({
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': IBK_COMMENT },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    await executeTool('create_cd_ticket', BASE_CD, { jira, notifier: mockNotifier });
+    const branchCall = jira.calls.getBitbucketBranches[0];
+    assert.ok(branchCall, 'getBitbucketBranches 應被呼叫');
+    assert.equal(branchCall.project, 'CHANNEL');
+    assert.equal(branchCall.repo, 'tw-bank-web');
+    assert.ok(
+      branchCall.opts?.filterValue?.startsWith('release/'),
+      'filterValue 應以 release/ 開頭',
+    );
+  });
+
+  // ── moduleKey 解析 ────────────────────────────────────────────
+  test('SSR module → label=SSR, repo=tw-bank-web-ssr, repoId=787', async () => {
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1676')],
+      libraryBranches: { 'CID-1676': 'release/v1.3.1.0' },
+      libraryComments: { 'CID-1676': SSR_COMMENT },
+      bitbucketLastTag: 'release/v1.3.0.0',
+    });
+    assert.ok(f.description.includes('SSR:'), 'label 應為 SSR');
+    assert.ok(f.description.includes('tw-bank-web-ssr'), 'repo 應為 tw-bank-web-ssr');
+    assert.ok(f.description.includes('targetRepoId=787'), 'repoId 應為 787');
+  });
+
+  test('CWA module → label=CWA, repo=tw-bank-webapp, repoId=36', async () => {
+    const CWA_COMMENT = 'Release version [ch014.cwa.cwa-release-v1.5.0.0-0.0.1|url] pass';
+    const f = await getCreatedFields(
+      'create_cd_ticket',
+      {
+        ...BASE_CD,
+        systemCode: 'CWA',
+        environment: 'stg',
+        clusterDeploy: 'tvstg-cwa-web01',
+      },
+      {
+        issueLinks: [makeLibraryLink('CID-2000')],
+        libraryBranches: { 'CID-2000': 'release/v1.5.0.0' },
+        libraryComments: { 'CID-2000': CWA_COMMENT },
+        bitbucketLastTag: 'release/v1.4.0.0',
+      },
+    );
+    assert.ok(f.description.includes('CWA:'), 'label 應為 CWA');
+    assert.ok(f.description.includes('tw-bank-webapp'), 'repo 應為 tw-bank-webapp');
+    assert.ok(f.description.includes('targetRepoId=36'), 'repoId 應為 36');
+  });
+
+  test('lib_branch 中的 / 轉成 - 產生正確 ci/ tag', async () => {
+    // release/v1.5.2.0 → release-v1.5.2.0，ci tag = ci/release-v1.5.2.0-0.0.1
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': IBK_COMMENT },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    assert.ok(
+      f.description.includes('ci%2Frelease-v1.5.2.0-0.0.1'),
+      `sourceBranch 應含 ci%2Frelease-v1.5.2.0-0.0.1，實際: ${f.description.match(/sourceBranch=[^&]+/)?.[0]}`,
+    );
+  });
+
+  // ── CWA 格式：branch 已內含 CID_version 後綴（release-v1.5.2.0-0.0.1）──
+  test('CWA 格式 branch（release-{ver}-{CID_version}）：sourceBranch 不重複版本', async () => {
+    // CWA Library branch = 'release-v1.5.2.0-0.0.1'（已含 CID_version=0.0.1）
+    // 預期 sourceBranch = ci/release-v1.5.2.0-0.0.1（只出現一次）
+    const BASE_CWA = {
+      systemCode: 'CWA',
+      environment: 'stg',
+      clusterDeploy: 'tvstg-cwa-web01',
+      linkedCiKey: 'CID-1668',
+    };
+    const f = await getCreatedFields('create_cd_ticket', BASE_CWA, {
+      issueLinks: [makeLibraryLink('CID-1667')],
+      libraryBranches: { 'CID-1667': 'release-v1.5.2.0-0.0.1' },
+      libraryComments: { 'CID-1667': CWA_COMMENT },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    assert.ok(f.description.includes('release notes:'), 'description 應含 release notes:');
+    assert.ok(f.description.includes('CWA:'), 'label 應為 CWA');
+    // sourceBranch 應為 ci/release-v1.5.2.0-0.0.1（不是 ci/release-v1.5.2.0-0.0.1-0.0.1）
+    assert.ok(f.description.includes('ci%2Frelease-v1.5.2.0-0.0.1'), '應含正確 sourceBranch');
+    assert.ok(!f.description.includes('0.0.1-0.0.1'), '版本號不應重複出現');
+  });
+
+  test('CWA 格式 branch：Web Link LBPRJ 版本查找使用去除後綴後的 versionName', async () => {
+    // branch = 'release-v1.5.2.0-0.0.1' → branchBase = 'release-v1.5.2.0'
+    // → strip 'release-' → versionName = 'v1.5.2.0'
+    const BASE_CWA = {
+      systemCode: 'CWA',
+      environment: 'stg',
+      clusterDeploy: 'tvstg-cwa-web01',
+      linkedCiKey: 'CID-1668',
+    };
+    const jira = makeMockJira({
+      issueLinks: [makeLibraryLink('CID-1667')],
+      libraryBranches: { 'CID-1667': 'release-v1.5.2.0-0.0.1' },
+      libraryComments: { 'CID-1667': CWA_COMMENT },
+      projectVersions: [{ id: '20001', name: 'v1.5.2.0' }], // LBPRJ 版本
+    });
+    await executeTool('create_cd_ticket', BASE_CWA, { jira, notifier: mockNotifier });
+    assert.equal(jira.calls.addRemoteLink.length, 1, 'Web Link 應被加入');
+    assert.equal(jira.calls.addRemoteLink[0].title, 'v1.5.2.0', '版本名稱應為 v1.5.2.0');
+  });
+
+  // ── 「如果有」：N > 0.0.1，N-1 曾部署到相同 env ───────────────
+  test('「如果有」N=0.0.2 且 N-1 曾部署同 env → targetBranch = ci/{branch}-0.0.1，不查 Bitbucket tags', async () => {
+    const COMMENT_N2 = 'Release version [ch014.ibk.ibk-release-v1.5.2.0-0.0.2|url] pass';
+    const COMMENT_N1 = 'Release version [ch014.ibk.ibk-release-v1.5.2.0-0.0.1|url] pass';
+
+    // searchIssues 回傳前一張 Library（CID_version=0.0.1），其 CI 含有 STG CD
+    const prevLibrary = {
+      key: 'CID-1670',
+      fields: {
+        comment: { comments: [{ body: COMMENT_N1 }] },
+        status: { name: 'Released' },
+        issuelinks: [
+          {
+            inwardIssue: {
+              key: 'CID-1671',
+              fields: { issuetype: { name: 'CI' }, status: { name: 'Done' } },
+            },
+          },
+        ],
+      },
+    };
+    // CID-1671（CI）的 contains 有一張 STG CD
+    const ciFields = {
+      status: { name: 'Done' },
+      issuelinks: [
+        {
+          outwardIssue: {
+            key: 'CID-1672',
+            fields: {
+              issuetype: { name: 'CD' },
+              status: { name: 'Done' },
+              summary: '[IBK][STG] 程式上版作業申請單_20260301 (CD deployment with 0.0.3)',
+            },
+          },
+        },
+      ],
+    };
+
+    const jira = makeMockJira({
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': COMMENT_N2 },
+      searchIssuesResult: [prevLibrary],
+      ciFieldsMap: { 'CID-1671': ciFields },
+      // bitbucketLastTag 不設定（如果有 → 不應查 Bitbucket）
+    });
+    await executeTool('create_cd_ticket', BASE_CD, { jira, notifier: mockNotifier });
+    const description = jira.calls.updateIssue[0]?.fields?.description ?? '';
+
+    assert.ok(description.includes('ci%2Frelease-v1.5.2.0-0.0.2'), '應含 sourceBranch N=0.0.2');
+    assert.ok(description.includes('ci%2Frelease-v1.5.2.0-0.0.1'), '應含 targetBranch N-1=0.0.1');
+    assert.equal(jira.calls.getBitbucketBranches.length, 0, '如果有 → 不應查 Bitbucket branches');
+  });
+
+  test('「如果有」N=0.0.2 但 N-1 未部署同 env → fallback 到 Bitbucket 最後 release/ tag', async () => {
+    const COMMENT_N2 = 'Release version [ch014.ibk.ibk-release-v1.5.2.0-0.0.2|url] pass';
+    const COMMENT_N1 = 'Release version [ch014.ibk.ibk-release-v1.5.2.0-0.0.1|url] pass';
+
+    // searchIssues 回傳前一張 Library，但其 CI 只有 UAT CD（不是 STG）
+    const prevLibrary = {
+      key: 'CID-1670',
+      fields: {
+        comment: { comments: [{ body: COMMENT_N1 }] },
+        status: { name: 'Released' },
+        issuelinks: [
+          {
+            inwardIssue: {
+              key: 'CID-1671',
+              fields: { issuetype: { name: 'CI' }, status: { name: 'Done' } },
+            },
+          },
+        ],
+      },
+    };
+    // CI 只含 UAT CD（env 不同）
+    const ciFields = {
+      status: { name: 'Done' },
+      issuelinks: [
+        {
+          outwardIssue: {
+            key: 'CID-1673',
+            fields: {
+              issuetype: { name: 'CD' },
+              status: { name: 'Done' },
+              summary: '[IBK][UAT] 程式上版作業申請單_20260301', // UAT 不是 STG
+            },
+          },
+        },
+      ],
+    };
+
+    const f = await getCreatedFields('create_cd_ticket', BASE_CD, {
+      issueLinks: [makeLibraryLink('CID-1675')],
+      libraryBranches: { 'CID-1675': 'release/v1.5.2.0' },
+      libraryComments: { 'CID-1675': COMMENT_N2 },
+      searchIssuesResult: [prevLibrary],
+      ciFieldsMap: { 'CID-1671': ciFields },
+      bitbucketLastTag: 'release/v1.5.1.0',
+    });
+    assert.ok(
+      f.description.includes('release%2Fv1.5.1.0'),
+      '應 fallback 到 Bitbucket 最後 release/ tag',
+    );
+    assert.ok(
+      !f.description.includes('ci%2Frelease-v1.5.2.0-0.0.1'),
+      '不應含 ci N-1 tag（未部署同 env）',
+    );
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// create_grayrelease_ticket
+// ═══════════════════════════════════════════════════════════════════
+describe('create_grayrelease_ticket — fields', () => {
+  const BASE = { systemCode: 'CWA', grayVersion: 'feature/test-sdd', environment: 'stg' };
+
+  test('project.key = CID', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f.project, { key: 'CID' });
+  });
+  test('issuetype.id = 12601 (GrayRelease)', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f.issuetype, { id: '12601' });
+  });
+  test('duedate = today (YYYY-MM-DD)', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.match(f.duedate, /^\d{4}-\d{2}-\d{2}$/);
+  });
+  test('summary 自動生成格式：[STG][GrayRelease] CWA_CWA_YYYYMMDD 程式上版作業申請單', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.match(f.summary, /^\[STG\]\[GrayRelease\] CWA_CWA_\d{8} 程式上版作業申請單$/);
+  });
+  test('summary 自訂覆蓋', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', {
+      ...BASE,
+      summary: '[Custom] GR',
+    });
+    assert.equal(f.summary, '[Custom] GR');
+  });
+  test('customfield_13443 (systemCode) = { value: CWA }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f['customfield_13443'], { value: 'CWA' });
+  });
+  test('customfield_13431 (gitBranch) = 原始 grayVersion（含 /）', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.equal(f['customfield_13431'], 'feature/test-sdd');
+  });
+  test('customfield_14700 (grayReleaseVersion) / 替換為 -', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.equal(f['customfield_14700'], 'feature-test-sdd');
+  });
+  test('customfield_14700 純版號不含 / 不變', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', {
+      ...BASE,
+      grayVersion: '1.0.0',
+    });
+    assert.equal(f['customfield_14700'], '1.0.0');
+  });
+  test('customfield_13434 (deptCode) CWA → { value: CH014 }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f['customfield_13434'], { value: 'CH014' });
+  });
+  test('customfield_13436 (env) stg → { value: stg }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f['customfield_13436'], { value: 'stg' });
+  });
+  test('customfield_14704 (clusterDeploy) 永遠 true (id 15506)', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f['customfield_14704'], { id: '15506' });
+  });
+  test('customfield_14701 (clusterList) CWA STG = 換行分隔兩台', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.equal(f['customfield_14701'], 'tvstg-cwa-web01\ntvstg-cwa-web02');
+  });
+  test('customfield_13444 (systemModule) CWA = { id: 15515 }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', BASE);
+    assert.deepEqual(f['customfield_13444'], { id: '15515' });
+  });
+  test('IBK STG: clusterList = tvstg-ibk-web01\\ntvstg-ibk-web02', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', {
+      systemCode: 'IBK',
+      grayVersion: 'feature/x',
+      environment: 'stg',
+    });
+    assert.equal(f['customfield_14701'], 'tvstg-ibk-web01\ntvstg-ibk-web02');
+  });
+  test('IBK systemModule = { id: 15500 }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', {
+      systemCode: 'IBK',
+      grayVersion: 'feature/x',
+      environment: 'stg',
+    });
+    assert.deepEqual(f['customfield_13444'], { id: '15500' });
+  });
+  test('IBK deptCode → { value: CH014 }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', {
+      systemCode: 'IBK',
+      grayVersion: '1.0.0',
+      environment: 'stg',
+    });
+    assert.deepEqual(f['customfield_13434'], { value: 'CH014' });
+  });
+  test('EVT deptCode → { value: CH015 }', async () => {
+    const f = await getCreatedFields('create_grayrelease_ticket', {
+      systemCode: 'EVT',
+      grayVersion: '1.0.0',
+      environment: 'stg',
+    });
+    assert.deepEqual(f['customfield_13434'], { value: 'CH015' });
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// prepare_cd_deployment
+// ═══════════════════════════════════════════════════════════════════
+describe('prepare_cd_deployment', () => {
+  const DEPLOY_TRANS = {
+    id: '999',
+    name: 'Prepare to Create Deployment',
+    to: { name: 'Deploying' },
+  };
+
+  /** 建立含 updateIssue / transitionById / getIssue / getTransitions 的 mock */
+  function makeDeployMock({
+    transitionName = 'Prepare to Create Deployment',
+    resultStatus = 'Deploying',
+  } = {}) {
+    const calls = { updateIssue: [], transitionById: [] };
+    return {
+      calls,
+      updateIssue: async (key, fields) => {
+        calls.updateIssue.push({ key, fields });
+        return {};
+      },
+      getTransitions: async () => [{ id: '999', name: transitionName, to: { name: resultStatus } }],
+      transitionById: async (key, id) => {
+        calls.transitionById.push({ key, id });
+        return {};
+      },
+      getIssue: async () => ({ fields: { status: { name: resultStatus }, summary: 'CD test' } }),
+      addComment: async () => {},
+    };
+  }
+
+  test('stg：更新 customfield_13436 為 id 14356', async () => {
+    const jira = makeDeployMock();
+    await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.deepEqual(jira.calls.updateIssue[0].fields['customfield_13436'], { id: '14356' });
+  });
+
+  test('uat：更新 customfield_13436 為 id 14357', async () => {
+    const jira = makeDeployMock();
+    await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'uat' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.deepEqual(jira.calls.updateIssue[0].fields['customfield_13436'], { id: '14357' });
+  });
+
+  test('prd：更新 customfield_13436 為 id 14358', async () => {
+    const jira = makeDeployMock();
+    await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'prd' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.deepEqual(jira.calls.updateIssue[0].fields['customfield_13436'], { id: '14358' });
+  });
+
+  test('dr：更新 customfield_13436 為 id 14359', async () => {
+    const jira = makeDeployMock();
+    await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'dr' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.deepEqual(jira.calls.updateIssue[0].fields['customfield_13436'], { id: '14359' });
+  });
+
+  test('prd/dr：更新 customfield_13436 為 id 14360', async () => {
+    const jira = makeDeployMock();
+    await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'prd/dr' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.deepEqual(jira.calls.updateIssue[0].fields['customfield_13436'], { id: '14360' });
+  });
+
+  test('prd&dr 正規化為 prd/dr → id 14360', async () => {
+    const jira = makeDeployMock();
+    await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'prd&dr' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.deepEqual(jira.calls.updateIssue[0].fields['customfield_13436'], { id: '14360' });
+  });
+
+  test('觸發 "Prepare to Create Deployment" transition', async () => {
+    const jira = makeDeployMock();
+    const result = await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.equal(jira.calls.transitionById[0].key, 'CID-1697');
+    assert.equal(jira.calls.transitionById[0].id, '999');
+    const data = JSON.parse(result.content[0].text);
+    assert.equal(data.issueKey, 'CID-1697');
+    assert.equal(data.environment, 'stg');
+    assert.equal(data.status, 'Deploying');
+  });
+
+  test('fallback：transition 名稱為 "Deploy" 也能觸發', async () => {
+    const jira = makeDeployMock({ transitionName: 'Deploy' });
+    const result = await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'uat' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(!result.content[0].text.startsWith('❌'), '應成功觸發');
+    assert.equal(jira.calls.transitionById.length, 1);
+  });
+
+  test('找不到任何 deploy transition → 回傳錯誤', async () => {
+    const jira = {
+      updateIssue: async () => {},
+      getTransitions: async () => [
+        { id: '1', name: 'Some Other Transition', to: { name: 'Other' } },
+      ],
+      getIssue: async () => ({ fields: { status: { name: 'Approved' }, summary: 'CD test' } }),
+      addComment: async () => {},
+    };
+    const result = await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(result.content[0].text.startsWith('❌'), '應回傳錯誤');
+    assert.ok(result.content[0].text.includes('找不到部署 transition'), '應說明找不到 transition');
+  });
+
+  test('不合法的環境 → 回傳錯誤', async () => {
+    const jira = makeDeployMock();
+    const result = await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'invalid' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(result.content[0].text.startsWith('❌'));
+    assert.ok(result.content[0].text.includes('不支援的 CD 部署環境'));
+  });
+
+  test('pre-transition：Accept 後出現 Prepare to create deployment ticket → 觸發', async () => {
+    let callCount = 0;
+    const calls = { transitionById: [] };
+    const jira = {
+      updateIssue: async () => {},
+      getTransitions: async () => {
+        callCount++;
+        // findDeployTrans(1) → 無；pre-transition check(2) → Accept；findDeployTrans after Accept(3) → deploy
+        if (callCount <= 2)
+          return [{ id: '10', name: 'Accept', to: { name: 'Wait For Send Notice Email' } }];
+        return [
+          {
+            id: '71',
+            name: 'Prepare to create deployment ticket',
+            to: { name: 'Prepare For Deploy' },
+          },
+        ];
+      },
+      transitionById: async (key, id) => {
+        calls.transitionById.push({ key, id });
+        return {};
+      },
+      getIssue: async () => ({ fields: { status: { name: 'Prepare For Deploy' }, summary: 'CD' } }),
+      addComment: async () => {},
+    };
+    const result = await executeTool(
+      'prepare_cd_deployment',
+      { issueKey: 'CID-1697', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(!result.content[0].text.startsWith('❌'), '應成功觸發');
+    const data = JSON.parse(result.content[0].text);
+    assert.equal(data.status, 'Prepare For Deploy');
+    assert.equal(
+      calls.transitionById.length,
+      2,
+      '應觸發 Accept 與 Prepare to create deployment ticket 共 2 次',
+    );
+    assert.equal(calls.transitionById[0].id, '10', '第 1 次應觸發 Accept');
+    assert.equal(
+      calls.transitionById[1].id,
+      '71',
+      '第 2 次應觸發 Prepare to create deployment ticket',
+    );
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// trigger_deployment
+// ═══════════════════════════════════════════════════════════════════
+describe('trigger_deployment', () => {
+  /** 建立 sub-task mock helper */
+  function makeSubTask(key, summaryPrefix = '[STG]') {
+    return {
+      id: 'ST-001',
+      key,
+      fields: {
+        summary: `${summaryPrefix} Deployment`,
+        status: { name: 'Open' },
+        issuetype: { name: 'Deployment' },
+      },
+    };
+  }
+
+  /** mock jira for trigger_deployment */
+  function makeTriggerMock({
+    subTasks = [],
+    deployTrans = [],
+    cdTrans = [],
+    finalStatus = 'Auto Deploy',
+  } = {}) {
+    const calls = { transitionById: [], getTransitions: [] };
+    return {
+      calls,
+      getSubTasks: async () => subTasks,
+      getTransitions: async (key) => {
+        calls.getTransitions.push(key);
+        if (subTasks.some((t) => t.key === key)) return deployTrans;
+        return cdTrans;
+      },
+      transitionById: async (key, id) => {
+        calls.transitionById.push({ key, id });
+        return {};
+      },
+      getIssue: async (key) => ({
+        fields: { status: { name: finalStatus }, summary: `[MOCK] ${key}` },
+      }),
+      addComment: async () => {},
+    };
+  }
+
+  test('成功觸發：To AutoDeploy → Trigger AutoDeploy，回傳 deploymentKey', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]')],
+      deployTrans: [
+        { id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } },
+        { id: '12', name: 'Trigger AutoDeploy', to: { name: 'Auto Deploy' } },
+      ],
+    });
+    const result = await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(!result.content[0].text.startsWith('❌'), '不應回傳錯誤');
+    const data = JSON.parse(result.content[0].text);
+    assert.equal(data.deploymentKey, 'CID-9001');
+    assert.equal(data.environment, 'stg');
+    assert.ok(
+      data.steps.some((s) => s.includes('To AutoDeploy')),
+      '應記錄 To AutoDeploy',
+    );
+    assert.ok(
+      data.steps.some((s) => s.includes('Trigger AutoDeploy')),
+      '應記錄 Trigger AutoDeploy',
+    );
+  });
+
+  test('無 sub-task → 回傳錯誤', async () => {
+    const jira = makeTriggerMock({ subTasks: [] });
+    const result = await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(result.content[0].text.startsWith('❌'));
+    assert.ok(result.content[0].text.includes('Deployment sub-task'));
+  });
+
+  test('環境比對：[STG] summary 對應 stg → 選擇 STG sub-task，不選 UAT', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]'), makeSubTask('CID-9002', '[UAT]')],
+      deployTrans: [{ id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } }],
+    });
+    const result = await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    const data = JSON.parse(result.content[0].text);
+    assert.equal(data.deploymentKey, 'CID-9001', '應選 STG sub-task');
+  });
+
+  test('環境比對：[UAT] summary 對應 uat → 選擇 UAT sub-task', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]'), makeSubTask('CID-9002', '[UAT]')],
+      deployTrans: [{ id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } }],
+    });
+    const result = await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'uat' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    const data = JSON.parse(result.content[0].text);
+    assert.equal(data.deploymentKey, 'CID-9002', '應選 UAT sub-task');
+  });
+
+  test('無符合環境的 sub-task → fallback 取第一個', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[DEV]')],
+      deployTrans: [{ id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } }],
+    });
+    const result = await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    const data = JSON.parse(result.content[0].text);
+    assert.equal(data.deploymentKey, 'CID-9001', 'fallback 應取第一個');
+    assert.ok(
+      data.steps.some((s) => s.includes('⚠️') && s.includes('未找到明確符合')),
+      '應有 fallback 警告',
+    );
+  });
+
+  test('找不到 transition → 跳過，不中斷，仍回傳成功', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]')],
+      deployTrans: [], // 完全沒有 transitions
+    });
+    const result = await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    assert.ok(!result.content[0].text.startsWith('❌'), '應成功回傳（跳過所有 transition）');
+    const data = JSON.parse(result.content[0].text);
+    assert.ok(
+      data.steps.some((s) => s.includes('跳過')),
+      '應記錄跳過',
+    );
+  });
+
+  test('applyForClose=true → 觸發 CD 單的 Apply for close', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]')],
+      deployTrans: [
+        { id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } },
+        { id: '12', name: 'Trigger AutoDeploy', to: { name: 'Auto Deploy' } },
+      ],
+      cdTrans: [{ id: '99', name: 'Apply for close', to: { name: 'Wait For Close' } }],
+    });
+    await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg', applyForClose: true },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    const closeCall = jira.calls.transitionById.find((c) => c.key === 'CID-9000' && c.id === '99');
+    assert.ok(closeCall, 'applyForClose=true 應觸發 CD 單的 Apply for close（id 99）');
+  });
+
+  test('applyForClose 預設 false → 不觸發 CD 單 transition', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]')],
+      deployTrans: [{ id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } }],
+      cdTrans: [{ id: '99', name: 'Apply for close', to: { name: 'Wait For Close' } }],
+    });
+    await executeTool(
+      'trigger_deployment',
+      { cdIssueKey: 'CID-9000', environment: 'stg' },
+      {
+        jira,
+        notifier: mockNotifier,
+      },
+    );
+    const cdCall = jira.calls.transitionById.find((c) => c.key === 'CID-9000');
+    assert.ok(!cdCall, 'applyForClose 未設定 → 不應觸發 CD 單 transition');
+  });
+
+  test('applyForClose=true 但 CD 單找不到 Apply for close → 記錄警告不中斷', async () => {
+    const jira = makeTriggerMock({
+      subTasks: [makeSubTask('CID-9001', '[STG]')],
+      deployTrans: [{ id: '11', name: 'To AutoDeploy', to: { name: 'Pre Auto Deploy' } }],
+      cdTrans: [], // CD 單沒有 Apply for close
+    });
+    const result = await executeTool(
+      'trigger_deployment',
+      {
+        cdIssueKey: 'CID-9000',
+        environment: 'stg',
+        applyForClose: true,
+      },
+      { jira, notifier: mockNotifier },
+    );
+    assert.ok(!result.content[0].text.startsWith('❌'), '不應因找不到 Apply for close 而報錯');
+    const data = JSON.parse(result.content[0].text);
+    assert.ok(
+      data.steps.some((s) => s.includes('⚠️') && s.includes('Apply for close')),
+      '應有警告記錄',
+    );
+  });
+});
+
+// ═══════════════════════════════════════════════════════════════════
+// create_cd_ticket — moduleChild fallback
+// ═══════════════════════════════════════════════════════════════════
+describe('create_cd_ticket — moduleChild fallback', () => {
+  test('CWA 未傳 moduleChild → 預設 cwa (systemCode.toLowerCase())', async () => {
+    // 驗證 extraVars 產生正確（cwa 系統 → cwa_cwa_installation）
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'CWA',
+      environment: 'stg',
+      clusterDeploy: 'tvstg-cwa-web01,tvstg-cwa-web02',
+      // 不傳 moduleChild
+    });
+    const ev = JSON.parse(f['customfield_13437']);
+    assert.ok(
+      'cwa_cwa_installation' in ev,
+      'moduleChild fallback 為 cwa → 應有 cwa_cwa_installation',
+    );
+  });
+
+  test('IBK 未傳 moduleChild → 預設 ibk，extraVars 含全 IBK 模組', async () => {
+    const f = await getCreatedFields('create_cd_ticket', {
+      systemCode: 'IBK',
+      environment: 'stg',
+      clusterDeploy: 'tvstg-ibk-web01',
+      // 不傳 moduleChild
+    });
+    const ev = JSON.parse(f['customfield_13437']);
+    assert.ok('ibk_ibk_installation' in ev, 'IBK fallback → 應有 ibk_ibk_installation');
+  });
+
+  test('明確傳入 moduleChild 優先於 fallback', async () => {
+    // 若使用者明確傳 moduleChild='ssr'，不應被 fallback 覆蓋
+    const f = await getCreatedFields(
+      'create_cd_ticket',
+      {
+        systemCode: 'IBK',
+        environment: 'stg',
+        clusterDeploy: 'tvstg-ibk-web01',
+        moduleChild: 'ssr',
+        linkedCiKey: 'CID-1677',
+      },
+      {
+        issueLinks: [],
+      },
+    );
+    // extraVars 應仍走 fallback（無 Library 關聯），但 moduleChild 欄位已為 'ssr'
+    // 驗證票已正常建立（不因 moduleChild='ssr' 而失敗）
+    assert.ok(f.project, '票應正常建立');
+  });
+});