@jira-deploy/core 1.0.0

package/dry-run.js

@@ -0,0 +1,691 @@
+/**
+ * Dry-run / Debug 腳本
+ *
+ * 模式 1 — Mock（預設）：全部 API 呼叫改用假資料
+ *   node src/dry-run.js <tool> '<args_json>'
+ *
+ * 模式 2 — Live（真實 Jira，讀取不寫入）：
+ *   node src/dry-run.js <tool> '<args_json>' --live
+ *   需要 .env 有 JIRA_BASE_URL / JIRA_API_TOKEN
+ *
+ * 附加 Node.js debugger：
+ *   node --inspect-brk src/dry-run.js <tool> '<args_json>' [--live]
+ *   → 開 Chrome chrome://inspect 連上後下斷點
+ *
+ * ── 常用指令範例 ──────────────────────────────────────────────────────
+ *
+ *  # Library 票
+ *  node src/dry-run.js create_library_ticket '{"systemCode":"CWA","moduleChild":"cwa","gitBranch":"release/v1.5.2.0"}'
+ *  node src/dry-run.js build_ticket '{"issueKey":"CID-1708"}' --live
+ *
+ *  # CI 票
+ *  node src/dry-run.js get_next_ci_version '{"systemCode":"IBK","branch":"master"}'
+ *  node src/dry-run.js get_next_ci_version '{"systemCode":"CWA","branch":"master"}' --live
+ *  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_stg '{"issueKey":"CID-1709"}' --live
+ *
+ *  # CD 票
+ *  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":"stg"}' --live
+ *
+ *  # Deployment sub-task 觸發（新）
+ *  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
+ *
+ *  # CD 開單 → 建立 Deployment → 部署 全流程 mock 測試
+ *  node src/dry-run.js prepare_cd_deployment '{"issueKey":"CID-1716","environment":"stg"}'
+ *  node src/dry-run.js trigger_deployment '{"cdIssueKey":"CID-1716","environment":"stg","applyForClose":true}'
+ *
+ *  # Assignee 切換
+ *  node src/dry-run.js update_assignee '{"issueKey":"CID-1718","displayName":"Solar"}'
+ *  node src/dry-run.js update_assignee '{"issueKey":"CID-1718","accountId":"BK00129"}' --live
+ *
+ *  # 計算下一個 Library Release 版號流水號
+ *  node src/dry-run.js get_next_lib_version '{"moduleChild":"ibk","branch":"release/v1.5.2.0","fixVersion":"v1.5.2.0"}'
+ *  node src/dry-run.js get_next_lib_version '{"moduleChild":"cwa","branch":"release/v1.5.2.0","fixVersion":"v1.5.2.0"}' --live
+ *
+ *  # 狀態查詢 / transitions
+ *  node src/dry-run.js list_transitions '{"issueKey":"CID-1710"}' --live
+ *  node src/dry-run.js get_issue_status '{"issueKey":"CID-1709"}' --live
+ *
+ *  # Release 現況查詢
+ *  node src/dry-run.js get_release_status '{"systemCode":"IBK"}' --live
+ *  node src/dry-run.js get_release_status '{"systemCode":"IBK"}'
+ *
+ *  # Release Reroll — cancel CI 並取得 Library 模組清單
+ *  node src/dry-run.js cancel_release '{"systemCode":"IBK"}' --live
+ *  node src/dry-run.js cancel_release '{"systemCode":"IBK","ciIssueKey":"CID-1799"}' --live
+ *  node src/dry-run.js cancel_release '{"systemCode":"IBK"}'
+ * ──────────────────────────────────────────────────────────────────────
+ */
+import 'dotenv/config';
+import { executeTool } from './tools/index.js';
+
+const TOOL = process.argv[2] || 'create_library_ticket';
+const ARGS = JSON.parse(process.argv[3] || '{}');
+const LIVE = process.argv.includes('--live');
+
+process.env.JIRA_BASE_URL = process.env.JIRA_BASE_URL || 'https://jira.example.com';
+const BASE_URL = `${process.env.JIRA_BASE_URL}/rest/api/2`;
+
+// ── 彩色 log helpers ──────────────────────────────────────────────
+const c = {
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  gray: (s) => `\x1b[90m${s}\x1b[0m`,
+};
+
+function printCall(method, path, body) {
+  console.log('\n' + '═'.repeat(70));
+  console.log(c.cyan(`${method.toUpperCase()}  ${BASE_URL}${path}`));
+  if (body !== undefined) {
+    console.log(c.gray('Body:'));
+    console.log(JSON.stringify(body, null, 2));
+  }
+  console.log('═'.repeat(70));
+}
+
+function printRead(key, fieldNames, result) {
+  console.log(c.gray(`  ← GET /issue/${key}?fields=${fieldNames.join(',')}`));
+  console.log(c.gray('    Response: ' + JSON.stringify(result)));
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Mock Jira（模式 1）
+// ─────────────────────────────────────────────────────────────────
+const mockJira = {
+  createIssue: async (fields) => {
+    printCall('POST', '/issue', { fields });
+    return { id: 'DRY-RUN', key: 'CID-DRYRUN', self: `${BASE_URL}/issue/CID-DRYRUN` };
+  },
+  getIssueFields: async (key, fieldNames) => {
+    console.log(c.gray(`  [MOCK] GET /issue/${key}?fields=${fieldNames.join(',')}`));
+    // CI 單：issuelinks（關聯 Library + 關聯 CI）
+    if (fieldNames.includes('issuelinks')) {
+      return {
+        summary: '[MOCK] IBK CI',
+        status: { name: 'Wait To STG' },
+        customfield_13438: '{"ibk_ap_version":"0.0.18"}',
+        issuelinks: [
+          {
+            type: {name: 'Relates', inward: 'relates to', outward: 'relates to'},
+            outwardIssue: {
+              key: 'CID-LIB-IBK-MOCK',
+              fields: {
+                summary: '[STG][Lib] IBK_IBK_MOCK',
+                status: {name: 'Released'},
+                issuetype: {name: 'Library'},
+              },
+            },
+          },
+          {
+            type: {name: 'Relates', inward: 'relates to', outward: 'relates to'},
+            outwardIssue: {
+              key: 'CID-LIB-SSR-MOCK',
+              fields: {
+                summary: '[STG][Lib] IBK_SSR_MOCK',
+                status: {name: 'Released'},
+                issuetype: {name: 'Library'},
+              },
+            },
+          },
+          {
+            type: {name: 'Relates', inward: 'relates to', outward: 'relates to'},
+            outwardIssue: {
+              key: 'CID-CI-OLD-MOCK',
+              fields: {
+                summary: '[MOCK] IBK Old CI',
+                status: {name: 'Done'},
+                issuetype: {name: 'CI'},
+              },
+            },
+          },
+        ],
+      };
+    }
+    // CI 單 release_version
+    if (fieldNames.includes('customfield_13438')) {
+      return {customfield_13438: '{"ibk_ap_version":"0.0.18"}'};
+    }
+    // Library 單：gitBranch + systemModule
+    if (fieldNames.includes('customfield_13431')) {
+      const moduleMap = {
+        'CID-LIB-IBK-MOCK': {customfield_13431: 'release/v1.5.2.0', customfield_13444: {value: 'ibk'}},
+        'CID-LIB-SSR-MOCK': {customfield_13431: 'release/v1.3.1.0', customfield_13444: {value: 'ssr'}},
+      };
+      return moduleMap[key] ?? {customfield_13431: 'release/v1.0.0.0', customfield_13444: {value: 'unknown'}};
+    }
+    // systemCode (customfield_13443)
+    if (fieldNames.includes('customfield_13443')) {
+      return {customfield_13443: {value: 'IBK'}};
+    }
+    return {};
+  },
+  updateIssue: async (key, fields) => {
+    printCall('PUT', `/issue/${key}`, { fields });
+    return {};
+  },
+  linkIssue: async (inward, outward, type) => {
+    printCall('POST', '/issueLink', {
+      type: { name: type },
+      inwardIssue: { key: inward },
+      outwardIssue: { key: outward },
+    });
+    return {};
+  },
+  addRemoteLink: async (issueKey, url, title) => {
+    printCall('POST', `/issue/${issueKey}/remotelink`, { object: { url, title } });
+    return {};
+  },
+  getIssue: async (key) => ({ fields: { status: { name: 'To Do' }, summary: `[MOCK] ${key}` } }),
+  // stateful mock：模擬 CD 單逐步推進的 transition 清單
+  _cdTransitionStep: 0,
+  getTransitions: async function (key) {
+    // Deployment sub-task mock
+    if (key === 'CID-DEPLOY-MOCK') {
+      const mockTrans = [
+        {id: '11', name: 'To AutoDeploy', to: {name: 'Pre Auto Deploy'}},
+        {id: '12', name: 'Trigger AutoDeploy', to: {name: 'Auto Deploy'}},
+      ];
+      console.log(c.gray(`  [MOCK] getTransitions(${key}) → [${mockTrans.map((t) => t.name).join(', ')}]`));
+      return mockTrans;
+    }
+    // CI 單 mock：包含 Cancelled transition（供 cancel_release 使用）
+    if (key === 'CID-CI-MOCK' || key.startsWith('CID-CI')) {
+      const trans = [{id: '71', name: 'Cancelled', to: {name: 'Cancelled'}}];
+      console.log(c.gray(`  [MOCK] getTransitions(${key}) → [${trans.map((t) => t.name).join(', ')}]`));
+      return trans;
+    }
+    // CD 單 mock：依呼叫次數模擬流程推進
+    // step 0-1: TO DO → Accept 可用
+    // step 2-3: Wait For Send Notice Email → Prepare to create deployment ticket 可用
+    // step 4-5: Prepare For Deploy → Apply for approval 可用
+    // step 6+: Wait Approval → Apply for close 可用
+    const CD_STEP_TRANSITIONS = [
+      [{ id: '10', name: 'Accept', to: { name: 'Wait For Send Notice Email' } }],
+      [{ id: '10', name: 'Accept', to: { name: 'Wait For Send Notice Email' } }],
+      [
+        {
+          id: '71',
+          name: 'Prepare to create deployment ticket',
+          to: { name: 'Prepare For Deploy' },
+        },
+      ],
+      [
+        {
+          id: '71',
+          name: 'Prepare to create deployment ticket',
+          to: { name: 'Prepare For Deploy' },
+        },
+      ],
+      [{ id: '21', name: 'Apply for approval', to: { name: 'Wait Approval' } }],
+      [{ id: '21', name: 'Apply for approval', to: { name: 'Wait Approval' } }],
+      [{ id: '99', name: 'Apply for close', to: { name: 'Wait For Close Approval' } }],
+    ];
+    const step = Math.min(this._cdTransitionStep++, CD_STEP_TRANSITIONS.length - 1);
+    const trans = CD_STEP_TRANSITIONS[step];
+    console.log(
+      c.gray(
+        `  [MOCK] getTransitions(${key}) step=${step} → [${trans.map((t) => t.name).join(', ')}]`,
+      ),
+    );
+    return trans;
+  },
+  transitionById: async (key, id) => {
+    console.log(c.gray(`  [MOCK] transitionById(${key}, ${id})`));
+  },
+  transitionByName: async () => ({ transitioned: 'Done', toStatus: 'Done' }),
+  addComment: async (key, body) => {
+    printCall('POST', `/issue/${key}/comment`, { body });
+    return {};
+  },
+  searchIssues: async (jql, fields, max) => {
+    console.log(c.gray(`  [MOCK] searchIssues(${jql.slice(0, 80)}...)`));
+    // cancel_release / get_release_status 查 CI 單
+    if (jql.includes('issuetype = CI')) {
+      return [{
+        key: 'CID-CI-MOCK',
+        fields: {
+          summary: '[IBK][CI] Mock CI 單',
+          status: {name: 'Wait To STG'},
+          customfield_13438: '{"ibk_ap_version":"0.0.18"}',
+          updated: new Date().toISOString(),
+          issuelinks: [
+            {
+              type: {name: 'Relates', inward: 'relates to', outward: 'relates to'},
+              outwardIssue: {
+                key: 'CID-LIB-IBK-MOCK',
+                fields: {
+                  summary: '[STG][Lib] IBK_IBK_MOCK',
+                  status: {name: 'Released'},
+                  issuetype: {name: 'Library'},
+                },
+              },
+            },
+            {
+              type: {name: 'Relates', inward: 'relates to', outward: 'relates to'},
+              outwardIssue: {
+                key: 'CID-LIB-SSR-MOCK',
+                fields: {
+                  summary: '[STG][Lib] IBK_SSR_MOCK',
+                  status: {name: 'Released'},
+                  issuetype: {name: 'Library'},
+                },
+              },
+            },
+          ],
+        },
+      }];
+    }
+    // get_release_status 查 CD 單
+    if (jql.includes('issuetype = CD')) {
+      return [{
+        key: 'CID-CD-STG-MOCK',
+        fields: {
+          summary: '[IBK][STG] CD MOCK',
+          status: {name: 'Wait Deploy'},
+          customfield_13436: {value: 'stg'},
+          customfield_14101: '{"ibk_ap_version":"0.0.18"}',
+          updated: new Date().toISOString(),
+        },
+      }];
+    }
+    return [];
+  },
+  getBitbucketTags: async () => [],
+  getBitbucketBranches: async () => [],
+  getBitbucketFileContent: async (project, repo, filePath, branch) => {
+    console.log(
+      c.gray(`  [MOCK] getBitbucketFileContent(${project}/${repo}/${filePath}@${branch})`),
+    );
+    // pom.xml → CI Golden Image 格式
+    if (filePath === 'pom.xml') {
+      return `<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    
+    <parent>
+        <groupId>com.line.bank</groupId>
+        <artifactId>assembly.parent</artifactId>
+        <version>0.0.1</version>
+    </parent>
+    
+    <groupId>com.line.bank</groupId>
+    <artifactId>ch014.ibk.assembly</artifactId>
+    <version>0.0.12-SNAPSHOT</version>
+    <packaging>pom</packaging>
+
+    <name>ch014.ibk.assembly</name>
+    <description>IBK Golden Image</description>
+    
+    <scm>
+        <connection>scm:git:https://bitbucket.linebank.com.tw/scm/lbtwgol/ch014.ibk.assembly.git</connection>
+        <developerConnection>scm:git:https://bitbucket.linebank.com.tw/scm/lbtwgol/ch014.ibk.assembly.git</developerConnection>
+        <url>https://bitbucket.linebank.com.tw/scm/lbtwgol/ch014.ibk.assembly</url>
+        <tag>HEAD</tag>
+    </scm>
+    
+    <properties>
+        <ssr.version>release-v1.3.1.0-0.0.1</ssr.version>
+        <wealth.version>release-v1.1.0.0-0.0.1</wealth.version>
+        <ibk.version>release-v1.5.2.0-0.0.1</ibk.version>
+        <a11y.version>release-v1.5.1.0-0.0.4</a11y.version>
+    </properties>
+    
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-resources-plugin</artifactId>
+                <version>3.3.1</version>
+                <executions>
+                    <execution>
+                        <id>copy-dependency-libs</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>copy-resources</goal>
+                        </goals>
+                        <configuration>
+                            <overwrite>true</overwrite>
+                            <includeEmptyDirs>true</includeEmptyDirs>
+                            <outputDirectory>../../target/checkout/libs</outputDirectory>
+                            <resources>
+                                <resource>
+                                    <directory>../../libs</directory>
+                                </resource>
+                            </resources>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>copy-wealth</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>copy-resources</goal>
+                        </goals>
+                        <configuration>
+                            <overwrite>true</overwrite>
+                            <includeEmptyDirs>true</includeEmptyDirs>
+                            <outputDirectory>./target/wealth</outputDirectory>
+                            <resources>
+                                <resource>
+                                    <directory>libs/wealth</directory>
+                                </resource>
+                            </resources>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>copy-ssr</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>copy-resources</goal>
+                        </goals>
+                        <configuration>
+                            <overwrite>true</overwrite>
+                            <includeEmptyDirs>true</includeEmptyDirs>
+                            <outputDirectory>./target/ssr</outputDirectory>
+                            <resources>
+                                <resource>
+                                    <directory>libs/ssr</directory>
+                                </resource>
+                            </resources>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>copy-ibk</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>copy-resources</goal>
+                        </goals>
+                        <configuration>
+                            <overwrite>true</overwrite>
+                            <includeEmptyDirs>true</includeEmptyDirs>
+                            <outputDirectory>./target/ibk</outputDirectory>
+                            <resources>
+                                <resource>
+                                    <directory>libs/ibk</directory>
+                                </resource>
+                            </resources>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>copy-a11y</id>
+                        <phase>process-resources</phase>
+                        <goals>
+                            <goal>copy-resources</goal>
+                        </goals>
+                        <configuration>
+                            <overwrite>true</overwrite>
+                            <includeEmptyDirs>true</includeEmptyDirs>
+                            <outputDirectory>./target/a11y</outputDirectory>
+                            <resources>
+                                <resource>
+                                    <directory>libs/a11y</directory>
+                                </resource>
+                            </resources>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>    
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <version>3.6.0</version>
+                <executions>
+                    <execution>
+                        <id>create-wealth</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <appendAssemblyId>true</appendAssemblyId>
+                            <descriptors>
+                                <descriptor>src/main/resources/build-wealth.xml</descriptor>
+                            </descriptors>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>create-ssr</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <appendAssemblyId>true</appendAssemblyId>
+                            <descriptors>
+                                <descriptor>src/main/resources/build-ssr.xml</descriptor>
+                            </descriptors>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>create-ibk</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <appendAssemblyId>true</appendAssemblyId>
+                            <descriptors>
+                                <descriptor>src/main/resources/build-ibk.xml</descriptor>
+                            </descriptors>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>create-a11y</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                        <configuration>
+                            <appendAssemblyId>true</appendAssemblyId>
+                            <descriptors>
+                                <descriptor>src/main/resources/build-a11y.xml</descriptor>
+                            </descriptors>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+    
+    
+</project>`;
+    }
+    // *.xml → Library Release 格式（假設現版 = release-v1.5.1.1-0.0.2）
+    return `<?xml version="1.0"?>\n<root>\n  <version>release-v1.5.1.1-0.0.2-SNAPSHOT</version>\n</root>`;
+  },
+  getProjectVersions: async (projectKey, { name } = {}) => {
+    console.log(
+      c.gray(
+        `  [MOCK] getProjectVersions(${projectKey}, {name=${name}}) → null (mock：模擬找不到版本)`,
+      ),
+    );
+    return null;
+  },
+  // trigger_deployment 用：回傳 mock sub-task
+  getSubTasks: async (key) => {
+    const mockSubTasks = [
+      {
+        id: 'MOCK-1',
+        key: 'CID-DEPLOY-MOCK',
+        fields: {
+          summary: `[STG] Deployment for ${key}`,
+          status: { name: 'Open' },
+          issuetype: { name: 'Deployment' },
+        },
+      },
+    ];
+    console.log(
+      c.gray(`  [MOCK] getSubTasks(${key}) → ${mockSubTasks.map((t) => t.key).join(', ')}`),
+    );
+    return mockSubTasks;
+  },
+  updateAssignee: async (issueKey, accountId) => {
+    printCall('PUT', `/issue/${issueKey}/assignee`, { name: accountId });
+    return { issueKey, accountId };
+  },
+  getUnreleasedVersionsList: async (projectKey) => {
+    console.log(c.gray(`  [MOCK] getUnreleasedVersionsList(${projectKey})`));
+    return [
+      { id: '10001', name: 'IBK_1.5.2.0', released: false, archived: false },
+      { id: '10002', name: 'IBK_ssr_1.3.1.0', released: false, archived: false },
+      { id: '10003', name: 'IBK_wealth_1.1.0.0', released: false, archived: false },
+      { id: '10004', name: 'IBK_accessibility_1.5.1.0', released: false, archived: false },
+      { id: '10005', name: 'CWA_1.5.4.0', released: false, archived: false },
+    ];
+  },
+  getComments: async (issueKey) => {
+    console.log(c.gray(`  [MOCK] getComments(${issueKey})`));
+    return [
+      {
+        author: { name: 'BK00178', displayName: 'James Yu' },
+        body: 'Approved',
+        created: new Date().toISOString(),
+      },
+    ];
+  },
+};
+
+// ─────────────────────────────────────────────────────────────────
+// Live Jira（模式 2）：讀取用真實 API，寫入全攔截
+// ─────────────────────────────────────────────────────────────────
+async function buildLiveJira() {
+  const { JiraClient } = await import('./jira-client.js');
+  const real = new JiraClient();
+
+  return {
+    // ── 讀取：直接呼叫真實 API，印出 response ──
+    getIssueFields: async (key, fieldNames) => {
+      const result = await real.getIssueFields(key, fieldNames);
+      printRead(key, fieldNames, result);
+      return result;
+    },
+    getIssue: async (key) => {
+      const result = await real.getIssue(key);
+      console.log(c.gray(`  ← getIssue(${key}) status=${result.fields?.status?.name}`));
+      return result;
+    },
+    getTransitions: async (key) => {
+      const result = await real.getTransitions(key);
+      console.log(c.gray(`  ← getTransitions(${key}) [${result.map((t) => t.name).join(', ')}]`));
+      return result;
+    },
+    getSubTasks: async (key) => {
+      const result = await real.getSubTasks(key);
+      console.log(
+        c.gray(
+          `  ← getSubTasks(${key}) → [${result.map((t) => `${t.key}(${t.fields?.summary?.slice(0, 30)})`).join(', ')}]`,
+        ),
+      );
+      return result;
+    },
+    searchIssues: async (jql, fields, max) => {
+      const result = await real.searchIssues(jql, fields, max);
+      console.log(c.gray(`  ← searchIssues(${jql.slice(0, 60)}...) → ${result.length} results`));
+      return result;
+    },
+    getBitbucketTags: async (project, repo, opts) => {
+      const result = await real.getBitbucketTags(project, repo, opts);
+      console.log(
+        c.gray(`  ← getBitbucketTags(${repo}) → [${result.map((t) => t.displayId).join(', ')}]`),
+      );
+      return result;
+    },
+    getBitbucketBranches: async (project, repo, opts) => {
+      const result = await real.getBitbucketBranches(project, repo, opts);
+      console.log(
+        c.gray(
+          `  ← getBitbucketBranches(${repo}) → [${result.map((b) => b.displayId).join(', ')}]`,
+        ),
+      );
+      return result;
+    },
+    getBitbucketFileContent: async (project, repo, filePath, branch) => {
+      const result = await real.getBitbucketFileContent(project, repo, filePath, branch);
+      console.log(
+        c.gray(
+          `  ← getBitbucketFileContent(${repo}/${filePath}@${branch}) → ${result.slice(0, 80)}...`,
+        ),
+      );
+      return result;
+    },
+    getProjectVersions: async (projectKey, opts = {}) => {
+      const result = await real.getProjectVersions(projectKey, opts);
+      console.log(
+        c.gray(`  ← getProjectVersions(${projectKey}, {name=${opts.name}}) → ${result ?? 'null'}`),
+      );
+      return result;
+    },
+    getUnreleasedVersionsList: async (projectKey) => {
+      const result = await real.getUnreleasedVersionsList(projectKey);
+      console.log(
+        c.gray(`  ← getUnreleasedVersionsList(${projectKey}) → ${result.length} versions`),
+      );
+      return result;
+    },
+    getComments: async (issueKey) => {
+      const result = await real.getComments(issueKey);
+      console.log(c.gray(`  ← getComments(${issueKey}) → ${result.length} comments`));
+      return result;
+    },
+
+    // ── 寫入：全部攔截，只印出不執行 ──
+    createIssue: async (fields) => {
+      printCall('POST [INTERCEPTED]', '/issue', { fields });
+      return { id: 'DRY-RUN', key: 'CID-DRYRUN', self: '' };
+    },
+    updateIssue: async (key, fields) => {
+      printCall('PUT [INTERCEPTED]', `/issue/${key}`, { fields });
+      return {};
+    },
+    linkIssue: async (inward, outward, type) => {
+      printCall('POST [INTERCEPTED]', '/issueLink', {
+        type: { name: type },
+        inwardIssue: { key: inward },
+        outwardIssue: { key: outward },
+      });
+      return {};
+    },
+    addRemoteLink: async (issueKey, url, title) => {
+      printCall('POST [INTERCEPTED]', `/issue/${issueKey}/remotelink`, { object: { url, title } });
+      return {};
+    },
+    transitionById: async (key, id) => {
+      printCall('POST [INTERCEPTED]', `/issue/${key}/transitions`, { transition: { id } });
+      return {};
+    },
+    transitionByName: async (key, name) => {
+      printCall('POST [INTERCEPTED]', `/issue/${key}/transitions`, { transition: { name } });
+      return { transitioned: name, toStatus: name };
+    },
+    addComment: async (key, body) => {
+      printCall('POST [INTERCEPTED]', `/issue/${key}/comment`, { body });
+      return {};
+    },
+    updateAssignee: async (issueKey, accountId) => {
+      printCall('PUT [INTERCEPTED]', `/issue/${issueKey}/assignee`, { name: accountId });
+      return { issueKey, accountId };
+    },
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Main
+// ─────────────────────────────────────────────────────────────────
+const mockNotifier = { notify: async () => [] };
+
+console.log(c.yellow(`\n🔍 Dry-run [${LIVE ? 'LIVE' : 'MOCK'}]: ${TOOL}`));
+console.log('Args:', JSON.stringify(ARGS, null, 2));
+if (LIVE) console.log(c.yellow('⚠️  Live mode: 讀取用真實 Jira，寫入全部攔截不執行'));
+
+const jira = LIVE ? await buildLiveJira() : mockJira;
+
+const result = await executeTool(TOOL, ARGS, { jira, notifier: mockNotifier });
+console.log(c.green('\n✅ Tool result:'));
+console.log(result.content[0].text);