@jira-deploy/core 1.0.14 → 1.0.16

package/tools/workflows.js

@@ -1,53 +1,73 @@
-import {getClusterList, ok, error} from './helpers.js';
+import { error, getServerList, ok } from './helpers.js';
+import { CI_FIELD_IDS, LIBRARY_MODULE_IDS, SYSTEM_MODULES } from '../constants/index.js';
 
 export function getWorkflowToolDefinitions() {
   return [
     {
-      name: 'run_stg_full_release',
+      name: 'run_release_to_stg',
       description:
-        '執行標準 STG 全流程：建立 CI 單、Build、Wait To STG、建立 CD 單、Prepare CD Deployment，最後 trigger deployment 並 Apply for close。',
+        '執行正式 release branch 到 STG 的完整流程。支援：① 上這次 release 到 STG（用 get_unreleased_versions 找 module/branch）② 指定多個 module/branch 上到 STG ③ 重上 release 部分 module。完成後 STG CD/Deployment deploy pass，並將 CI 停在 Wait To UAT。',
       inputSchema: {
         type: 'object',
-        required: ['systemCode'],
+        required: [],
         properties: {
           systemCode: {
             type: 'string',
-            description: '系統代碼，例如 IBK、CWA、EIB、EVT、NPM、BOF',
+            description: '系統代碼，例如 IBK、CWA。上這次 release 或重上 release 時建議提供；未提供時會要求使用者確認 systemCode。',
           },
-          environment: {
+          mode: {
+            type: 'string',
+            enum: ['current_release', 'explicit_modules', 'rerun_release'],
+            description: '流程模式：current_release=上這次 release；explicit_modules=使用指定 module/branch；rerun_release=重上部分 module。未提供時依 modules/oldCiIssueKey 推論。',
+          },
+          modules: {
+            type: 'array',
+            description: '指定 module/branch 或 rerun module 清單。explicit_modules 需提供 gitBranch；rerun_release 可只提供 module。',
+            items: {
+              type: 'object',
+              required: ['module'],
+              properties: {
+                module: { type: 'string', description: '模組名稱，例如 ssr、wealth、a11y、ibk、cwa' },
+                gitBranch: { type: 'string', description: '要上版的 branch，例如 release/v1.5.2.0 或 release/abc-123' },
+                rerun: { type: 'boolean', description: '是否重開此 module 的 Library' },
+              },
+            },
+          },
+          oldCiIssueKey: {
             type: 'string',
-            enum: ['stg'],
-            default: 'stg',
-            description: '固定為 stg；保留此參數讓自然語言 planner 可以映射使用者提到的 STG。',
+            description: '重上 release 時的舊 CI key；不提供時會查該 systemCode 最新進行中的 CI。',
+          },
+          dryRun: {
+            type: 'boolean',
+            description: '只回傳計畫，不實際建立或切換 Jira 單。',
           },
         },
       },
     },
     {
-      name: 'run_lib_to_stg_release',
+      name: 'continue_release_to_cd_ready',
       description:
-        '執行 Library 到 STG 的完整流程：建立 Library 單、Build library、等待 library build 狀態、建立關聯 CI、Build CI、Wait To STG、建立 CD、Prepare CD Deployment，最後 trigger deployment 並 Apply for close。',
+        '從既有 CI 單繼續正式 release 到 UAT 或 PRD/DR 的 CD-ready 流程。UAT/PRD/DR 只會建立 CD 單並執行 prepare_cd_deployment 建立/準備 Deployment；不會呼叫 trigger_deployment。PRD/DR 會先執行 wait_to_prd_dr，完成 Upload To Pre-Release 並等待 CID_upload_result pass 後才開 CD。後續 Switch Execution Node / To AutoDeploy / Trigger AutoDeploy 需由資管人員執行。',
       inputSchema: {
         type: 'object',
-        required: ['systemCode', 'gitBranch'],
+        required: ['ciIssueKey', 'environment'],
         properties: {
-          systemCode: {
+          ciIssueKey: {
             type: 'string',
-            description: '系統代碼，例如 IBK、CWA、EIB、EVT、NPM、BOF',
+            description: '作為 continuation 起點的 CI 單 issue key，例如 CID-1234。找不到 CI 單時 planner 必須先詢問使用者，不可猜測。',
           },
-          module: {
+          environment: {
             type: 'string',
-            description: 'Library 模組；未提供時預設使用 systemCode 小寫，例如 IBK -> ibk。',
+            enum: ['uat', 'prd/dr', 'prd', 'dr'],
+            description: '要繼續開立 CD/Deployment 的目標環境。prd 或 dr 會正規化為 prd/dr。',
           },
-          gitBranch: {
+          systemCode: {
             type: 'string',
-            description: 'Library release/hotfix/feature branch，例如 release/v1.5.2.0。',
+            description: '系統代碼，例如 IBK、CWA。未提供時會嘗試從 CI 單 CID_system_code 推導；推不到會要求使用者補充。',
           },
-          environment: {
-            type: 'string',
-            enum: ['stg'],
-            default: 'stg',
-            description: '固定為 stg；保留此參數讓自然語言 planner 可以映射使用者提到的 STG。',
+          dryRun: {
+            type: 'boolean',
+            description: '只回傳計畫，不實際推進 CI、建立 CD 或準備 Deployment。',
           },
         },
       },
@@ -56,9 +76,7 @@ export function getWorkflowToolDefinitions() {
 }
 
 function extractText(result) {
-  if (!result?.content?.length) {
-    return '';
-  }
+  if (!result?.content?.length) return '';
   return result.content
     .filter((item) => item.type === 'text')
     .map((item) => item.text)
@@ -73,7 +91,7 @@ function formatJson(value) {
 function parseToolJson(result) {
   const text = extractText(result);
   if (result?.isError || text.startsWith('❌')) {
-    throw new Error(text);
+    throw new Error(text.replace(/^❌ 錯誤: /, ''));
   }
   return JSON.parse(text);
 }
@@ -84,7 +102,7 @@ async function runToolOrThrow(name, args, deps, workflowLog) {
     phase: 'action',
     title: `執行 workflow step: ${name}`,
     toolName: name,
-    issueKey: args.issueKey ?? args.cdIssueKey ?? args.linkedCiKey,
+    issueKey: args.issueKey ?? args.cdIssueKey ?? args.linkedCiKey ?? args.oldCiIssueKey,
   });
   const result = await deps.executeToolImpl(name, args, deps);
   return parseToolJson(result);
@@ -122,138 +140,398 @@ async function waitForIssueStatus(issueKey, targetStatuses, deps, options = {})
   throw new Error(`等待 ${issueKey} 狀態 ${targetStatuses.join(' / ')} 超時`);
 }
 
-export async function handleRunStgFullReleaseWorkflow(args, deps) {
+export async function handleRunReleaseToStgWorkflow(args, deps) {
   try {
     const workflowLog = [];
-    const systemCode = String(args.systemCode ?? '').trim().toUpperCase();
-    const ciArgs = {systemCode, environment: 'stg'};
-    const ci = await runToolOrThrow('create_ci_ticket', ciArgs, deps, workflowLog);
+    const assumptions = [];
+    const systemCode = normalizeSystemCode(args.systemCode);
+    const mode = resolveMode(args);
+
+    if (!systemCode) {
+      return ok({
+        needsSystemSelection: true,
+        message: '請指定要上版的 systemCode，例如 IBK 或 CWA。',
+        mode,
+      });
+    }
 
-    const build = await runToolOrThrow('build_ticket', {issueKey: ci.issueKey}, deps, workflowLog);
-    const toStg = await runToolOrThrow('wait_to_stg', {issueKey: ci.issueKey}, deps, workflowLog);
+    const releasePlan = await buildReleasePlan({ systemCode, mode, args, deps, workflowLog, assumptions });
+    if (args.dryRun) {
+      return ok({ dryRun: true, type: 'Release To STG', systemCode, mode, plan: releasePlan, assumptions });
+    }
 
-    const clusters = getClusterList(systemCode, 'stg');
+    const libraryRefs = await prepareLibraries({ systemCode, releasePlan, mode, deps, workflowLog });
+    const ciRelatesTo = [...libraryRefs.map((library) => library.issueKey)];
+    if (releasePlan.oldCiIssueKey) {
+      ciRelatesTo.unshift(releasePlan.oldCiIssueKey);
+    }
+
+    const ci = await runToolOrThrow('create_ci_ticket', {
+      systemCode,
+      environment: 'stg',
+      modules: releasePlan.modules.map((item) => item.module),
+      relatesTo: ciRelatesTo,
+    }, deps, workflowLog);
+
+    if (releasePlan.oldCiIssueKey) {
+      await runToolOrThrow('transition_issue', {
+        issueKey: releasePlan.oldCiIssueKey,
+        transitionName: 'Cancelled',
+      }, deps, workflowLog);
+    }
+
+    const build = await runToolOrThrow('build_ci', { issueKey: ci.issueKey }, deps, workflowLog);
+    const toStg = await runToolOrThrow('wait_to_stg', { issueKey: ci.issueKey }, deps, workflowLog);
+    const clusters = getServerList(systemCode, 'stg');
     if (!clusters.length) {
       throw new Error(`找不到 ${systemCode} STG 的 cluster 設定`);
     }
 
-    const cdArgs = {
+    assumptions.push(`CD cluster 自動帶入 ${systemCode} STG 全部 cluster`);
+    const cd = await runToolOrThrow('create_cd_ticket', {
       systemCode,
       environment: 'stg',
       linkedCiKey: ci.issueKey,
       clusterDeploy: clusters.join(','),
-      moduleChild: systemCode.toLowerCase(),
-    };
-    const cd = await runToolOrThrow('create_cd_ticket', cdArgs, deps, workflowLog);
+      moduleChild: releasePlan.modules.map((item) => item.module).join(','),
+    }, deps, workflowLog);
     const prepared = await runToolOrThrow(
       'prepare_cd_deployment',
-      {issueKey: cd.issueKey, environment: 'stg'},
+      { issueKey: cd.issueKey, environment: 'stg' },
       deps,
       workflowLog,
     );
     const deployed = await runToolOrThrow(
       'trigger_deployment',
-      {cdIssueKey: cd.issueKey, environment: 'stg', applyForClose: true},
+      { cdIssueKey: cd.issueKey, environment: 'stg' },
       deps,
       workflowLog,
     );
+    const toUat = await runToolOrThrow('wait_to_uat', { issueKey: ci.issueKey }, deps, workflowLog);
 
     return ok({
-      type: 'STG Full Release',
+      type: 'Release To STG',
       systemCode,
+      mode,
+      modules: releasePlan.modules,
+      libraryIssueKeys: libraryRefs.map((library) => library.issueKey),
+      reusedLibraryIssueKeys: libraryRefs.filter((library) => library.reused).map((library) => library.issueKey),
+      oldCiIssueKey: releasePlan.oldCiIssueKey,
+      oldCiCancelled: Boolean(releasePlan.oldCiIssueKey),
       ciIssueKey: ci.issueKey,
-      ciStatus: toStg.status ?? build.status,
+      ciStatus: toUat.status ?? toStg.status ?? build.status,
       cdIssueKey: cd.issueKey,
       cdStatus: prepared.status,
       deploymentStatus: deployed.status,
-      assumptions: [`CD cluster 自動帶入 ${systemCode} STG 全部 cluster`],
+      deploymentResult: deployed.deployResult,
+      stoppedAt: 'Wait To UAT',
+      assumptions,
       workflowLog,
     });
   } catch (err) {
-    return error(`run_stg_full_release 失敗: ${err.message}`);
+    return error(`run_release_to_stg 失敗: ${err.message}`);
   }
 }
 
-export async function handleRunLibToStgReleaseWorkflow(args, deps) {
+export async function handleContinueReleaseToCdReadyWorkflow(args, deps) {
   try {
     const workflowLog = [];
-    const assumptions = [];
-    const systemCode = String(args.systemCode ?? '').trim().toUpperCase();
-    const module = args.module || systemCode.toLowerCase();
+    const ciIssueKey = normalizeIssueKey(args.ciIssueKey);
+    const environment = normalizeContinuationEnvironment(args.environment);
+
+    if (!ciIssueKey) {
+      return ok({
+        needsCiIssueKey: true,
+        message: '請提供要繼續開立 UAT/PRD CD 的 CI 單號，例如 CID-1234。',
+      });
+    }
+
+    if (!environment) {
+      return ok({
+        needsEnvironmentSelection: true,
+        ciIssueKey,
+        message: '請指定要繼續開立的環境：UAT 或 PRD/DR。',
+      });
+    }
+
+    const systemCode = await resolveContinuationSystemCode(args.systemCode, ciIssueKey, deps);
+    if (!systemCode) {
+      return ok({
+        needsSystemSelection: true,
+        ciIssueKey,
+        environment,
+        message: `無法從 ${ciIssueKey} 推導 systemCode，請指定系統代碼，例如 IBK 或 CWA。`,
+      });
+    }
 
-    if (!args.module) {
-      assumptions.push(`未指定 module，已依 systemCode 帶入 ${module}`);
+    const plan = buildContinuationPlan({ ciIssueKey, environment, systemCode });
+    if (args.dryRun) {
+      return ok({
+        dryRun: true,
+        type: 'Release Continuation To CD Ready',
+        ...plan,
+      });
     }
 
-    const libArgs = {
+    const ciReady = isPrdDrEnvironment(environment)
+      ? await runToolOrThrow('wait_to_prd_dr', { issueKey: ciIssueKey }, deps, workflowLog)
+      : await runToolOrThrow('wait_to_uat', { issueKey: ciIssueKey }, deps, workflowLog);
+
+    const cd = await runToolOrThrow('create_cd_ticket', {
       systemCode,
-      module,
-      gitBranch: args.gitBranch,
-      environment: 'stg',
-      jenkinsBranch: 'master',
-    };
-    const lib = await runToolOrThrow('create_library_ticket', libArgs, deps, workflowLog);
-    await runToolOrThrow('build_ticket', {issueKey: lib.issueKey}, deps, workflowLog);
-    const libFinalStatus = await waitForIssueStatus(
-      lib.issueKey,
-      ['Released'],
-      deps,
-      {timeoutMs: 10 * 60 * 1000, ...deps.workflowWaitOptions},
-    );
-    workflowLog.push(`- wait_library_status: ${lib.issueKey} -> ${libFinalStatus}`);
+      environment,
+      linkedCiKey: ciIssueKey,
+    }, deps, workflowLog);
+
+    const prepared = await runToolOrThrow('prepare_cd_deployment', {
+      issueKey: cd.issueKey,
+      environment,
+    }, deps, workflowLog);
 
-    const ciArgs = {
+    return ok(buildContinuationResult({
+      ciIssueKey,
+      environment,
       systemCode,
-      environment: 'stg',
-      relatesTo: lib.issueKey,
-    };
-    const ci = await runToolOrThrow('create_ci_ticket', ciArgs, deps, workflowLog);
-    const build = await runToolOrThrow('build_ticket', {issueKey: ci.issueKey}, deps, workflowLog);
-    const toStg = await runToolOrThrow('wait_to_stg', {issueKey: ci.issueKey}, deps, workflowLog);
+      ciReady,
+      cd,
+      prepared,
+      workflowLog,
+    }));
+  } catch (err) {
+    return error(`continue_release_to_cd_ready 失敗: ${err.message}`);
+  }
+}
 
-    const clusters = getClusterList(systemCode, 'stg');
-    if (!clusters.length) {
-      throw new Error(`找不到 ${systemCode} STG 的 cluster 設定`);
+function buildContinuationPlan({ ciIssueKey, environment, systemCode }) {
+  const prdDr = isPrdDrEnvironment(environment);
+  return {
+    ciIssueKey,
+    environment,
+    systemCode,
+    type: 'Release Continuation To CD Ready',
+    steps: [
+      prdDr ? 'wait_to_prd_dr' : 'wait_to_uat',
+      'create_cd_ticket',
+      'prepare_cd_deployment',
+    ],
+    triggerDeploymentSkipped: true,
+    triggerDeploymentReason: 'UAT/PRD/DR deployment transitions require privileged operator execution',
+    handoffRequired: true,
+    handoffTo: '資管人員',
+  };
+}
+
+function buildContinuationResult({ ciIssueKey, environment, systemCode, ciReady, cd, prepared, workflowLog }) {
+  const prdDr = isPrdDrEnvironment(environment);
+  return {
+    type: 'Release Continuation To CD Ready',
+    environment,
+    systemCode,
+    ciIssueKey,
+    ciStatus: ciReady.status,
+    uploadResult: prdDr ? ciReady.uploadResult : undefined,
+    cdIssueKey: cd.issueKey,
+    cdStatus: prepared.status,
+    deploymentPrepared: true,
+    triggerDeploymentSkipped: true,
+    triggerDeploymentReason: 'UAT/PRD/DR deployment transitions require privileged operator execution',
+    handoffRequired: true,
+    handoffTo: '資管人員',
+    manualNextSteps: [
+      '請資管人員在 Deployment sub-task 執行 Switch Execution Node / To AutoDeploy / Trigger AutoDeploy。',
+      'Ares 不會自動執行 trigger_deployment，避免 UAT/PRD/DR 權限被擋。',
+    ],
+    message: prdDr
+      ? '已完成 PRD/DR upload pre-release、CD 開單與 Deployment 建立；後續部署 transitions 需由資管人員執行。'
+      : '已完成 UAT CD 開單與 Deployment 建立；後續部署 transitions 需由資管人員執行。',
+    workflowLog,
+  };
+}
+
+async function resolveContinuationSystemCode(inputSystemCode, ciIssueKey, deps) {
+  const explicit = normalizeSystemCode(inputSystemCode);
+  if (explicit) {
+    return explicit;
+  }
+
+  try {
+    const fields = await deps.jira.getIssueFields(ciIssueKey, [CI_FIELD_IDS.systemCode]);
+    return normalizeSystemCode(
+      fields?.[CI_FIELD_IDS.systemCode]?.value
+      ?? fields?.[CI_FIELD_IDS.systemCode],
+    );
+  } catch {
+    return '';
+  }
+}
+
+function normalizeContinuationEnvironment(environment) {
+  const env = String(environment ?? '').trim().toLowerCase().replace('&', '/');
+  if (env === 'prd' || env === 'dr' || env === 'prd/dr') {
+    return 'prd/dr';
+  }
+  if (env === 'uat') {
+    return 'uat';
+  }
+  return '';
+}
+
+function isPrdDrEnvironment(environment) {
+  return normalizeContinuationEnvironment(environment) === 'prd/dr';
+}
+
+function normalizeIssueKey(issueKey) {
+  return String(issueKey ?? '').trim().toUpperCase();
+}
+
+async function buildReleasePlan({ systemCode, mode, args, deps, workflowLog, assumptions }) {
+  if (mode === 'explicit_modules') {
+    const modules = normalizeModuleSpecs(args.modules);
+    const missingBranch = modules.find((item) => !item.gitBranch);
+    if (missingBranch) {
+      throw new Error(`指定 module/branch 上版時，${missingBranch.module} 缺少 gitBranch`);
     }
-    assumptions.push(`CD cluster 自動帶入 ${systemCode} STG 全部 cluster`);
+    return { modules };
+  }
+
+  const releaseModules = await getCurrentReleaseModules(systemCode, deps, workflowLog);
+  if (mode === 'current_release') {
+    return { modules: releaseModules };
+  }
+
+  const rerunModules = new Set(normalizeModuleSpecs(args.modules).map((item) => item.module));
+  if (rerunModules.size === 0) {
+    throw new Error('重上 release 需指定至少一個 module，例如 ssr');
+  }
+
+  const oldCiIssueKey = args.oldCiIssueKey ?? await findLatestActiveCi(systemCode, deps);
+  const oldLibraries = await getOldCiLibrariesByModule(systemCode, oldCiIssueKey, deps);
+  const modules = releaseModules.map((item) => ({
+    ...item,
+    rerun: rerunModules.has(item.module),
+    reusedLibraryKey: rerunModules.has(item.module) ? null : oldLibraries.get(item.module)?.issueKey,
+  }));
+
+  const missingReuse = modules.find((item) => !item.rerun && !item.reusedLibraryKey);
+  if (missingReuse) {
+    assumptions.push(`找不到 ${missingReuse.module} 可沿用的舊 Library，將改為重開該 Library`);
+    missingReuse.rerun = true;
+  }
+
+  return { modules, oldCiIssueKey };
+}
 
-    const cdArgs = {
+async function getCurrentReleaseModules(systemCode, deps, workflowLog) {
+  const data = await runToolOrThrow('get_unreleased_versions', { systemCode }, deps, workflowLog);
+  const versions = data.versions ?? [];
+  if (versions.length === 0) {
+    throw new Error(`get_unreleased_versions 找不到 ${systemCode} 這次 release modules`);
+  }
+
+  return versions.map((version) => ({
+    module: String(version.module ?? '').trim(),
+    gitBranch: version.branch,
+    releaseVersionId: version.id,
+    releaseVersionName: version.name,
+  })).filter((item) => item.module && item.gitBranch);
+}
+
+async function prepareLibraries({ systemCode, releasePlan, mode, deps, workflowLog }) {
+  const refs = [];
+  for (const moduleSpec of releasePlan.modules) {
+    if (mode === 'rerun_release' && !moduleSpec.rerun && moduleSpec.reusedLibraryKey) {
+      refs.push({ module: moduleSpec.module, issueKey: moduleSpec.reusedLibraryKey, reused: true });
+      workflowLog.push(`- reuse_library: ${moduleSpec.module} -> ${moduleSpec.reusedLibraryKey}`);
+      continue;
+    }
+
+    const library = await runToolOrThrow('create_library_ticket', {
       systemCode,
+      module: moduleSpec.module,
+      gitBranch: moduleSpec.gitBranch,
       environment: 'stg',
-      linkedCiKey: ci.issueKey,
-      clusterDeploy: clusters.join(','),
-      moduleChild: systemCode.toLowerCase(),
-    };
-    const cd = await runToolOrThrow('create_cd_ticket', cdArgs, deps, workflowLog);
-    const prepared = await runToolOrThrow(
-      'prepare_cd_deployment',
-      {issueKey: cd.issueKey, environment: 'stg'},
-      deps,
-      workflowLog,
-    );
-    const deployed = await runToolOrThrow(
-      'trigger_deployment',
-      {cdIssueKey: cd.issueKey, environment: 'stg', applyForClose: true},
+      jenkinsBranch: 'master',
+    }, deps, workflowLog);
+    await runToolOrThrow('build_library', { issueKey: library.issueKey }, deps, workflowLog);
+    const libraryStatus = await waitForIssueStatus(
+      library.issueKey,
+      ['Released'],
       deps,
-      workflowLog,
+      { timeoutMs: 10 * 60 * 1000, ...deps.workflowWaitOptions },
     );
+    workflowLog.push(`- wait_library_status: ${library.issueKey} -> ${libraryStatus}`);
+    refs.push({ module: moduleSpec.module, issueKey: library.issueKey, reused: false });
+  }
+  return refs;
+}
 
-    return ok({
-      type: 'Library To STG Full Release',
-      systemCode,
-      module,
-      gitBranch: args.gitBranch,
-      libraryIssueKey: lib.issueKey,
-      libraryStatus: libFinalStatus,
-      ciIssueKey: ci.issueKey,
-      ciStatus: toStg.status ?? build.status,
-      cdIssueKey: cd.issueKey,
-      cdStatus: prepared.status,
-      deploymentStatus: deployed.status,
-      assumptions,
-      workflowLog,
-    });
-  } catch (err) {
-    return error(`run_lib_to_stg_release 失敗: ${err.message}`);
+async function findLatestActiveCi(systemCode, deps) {
+  const issues = await deps.jira.searchIssues(
+    `project = CID AND issuetype = CI AND cf[13443] = "${systemCode}" AND status NOT IN (Done, Cancelled) ORDER BY updated DESC`,
+    ['summary', 'status'],
+    1,
+  );
+  const issue = issues[0];
+  if (!issue?.key) {
+    throw new Error(`找不到 ${systemCode} 進行中的舊 CI 單，請指定 oldCiIssueKey`);
   }
+  return issue.key;
+}
+
+async function getOldCiLibrariesByModule(systemCode, ciIssueKey, deps) {
+  const fields = await deps.jira.getIssueFields(ciIssueKey, ['issuelinks']);
+  const links = fields.issuelinks ?? [];
+  const childIdToName = Object.fromEntries(
+    Object.entries(LIBRARY_MODULE_IDS[systemCode] ?? {}).map(([name, id]) => [id, name]),
+  );
+  const libraries = new Map();
+
+  for (const link of links) {
+    const linked = link.inwardIssue ?? link.outwardIssue;
+    if (linked?.fields?.issuetype?.name !== 'Library') continue;
+
+    const libFields = await deps.jira.getIssueFields(linked.key, ['customfield_13702', 'customfield_13431']).catch(() => ({}));
+    const childId = libFields?.customfield_13702?.child?.id;
+    const module = childIdToName[childId] ?? inferModuleFromSummary(systemCode, linked.fields?.summary);
+    if (module) {
+      libraries.set(module, {
+        issueKey: linked.key,
+        module,
+        gitBranch: libFields?.customfield_13431,
+      });
+    }
+  }
+
+  return libraries;
+}
+
+function inferModuleFromSummary(systemCode, summary = '') {
+  const modules = SYSTEM_MODULES[systemCode] ?? [];
+  const lower = String(summary).toLowerCase();
+  return modules.find((module) => lower.includes(module.toLowerCase())) ?? null;
+}
+
+function resolveMode(args) {
+  if (args.mode) return args.mode;
+  const modules = normalizeModuleSpecs(args.modules);
+  if (args.oldCiIssueKey || modules.some((item) => item.rerun || !item.gitBranch)) return 'rerun_release';
+  if (modules.length > 0) return 'explicit_modules';
+  return 'current_release';
+}
+
+function normalizeModuleSpecs(modules) {
+  if (!Array.isArray(modules)) return [];
+  return modules
+    .map((item) => typeof item === 'string' ? { module: item } : item)
+    .filter(Boolean)
+    .map((item) => ({
+      module: String(item.module ?? '').trim().toLowerCase(),
+      gitBranch: item.gitBranch,
+      rerun: item.rerun === true,
+    }))
+    .filter((item) => item.module);
+}
+
+function normalizeSystemCode(systemCode) {
+  return String(systemCode ?? '').trim().toUpperCase();
 }