sales-frontend-gemini-cli 0.4.4 → 0.5.0

package/dist/pr-review/claude/claude-commander.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/common/helper.ts","../../../src/pr-review/claude/claude-commander.ts"],"names":["__dirname","path","fileURLToPath","fs","args","reviewFormPath"],"mappings":"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","file":"claude-commander.cjs","sourcesContent":["import { execFileSync, execSync } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\nimport readline from 'readline';\nimport { fileURLToPath } from 'url';\nimport { inspect } from 'util';\n\nimport { AIServiceType, CommitOption, MultiSelectOption } from './types';\n\ntype ErrorReportSection = {\n  heading: string;\n  markdown: string;\n};\n\ntype WriteErrorReportOptions = {\n  title?: string;\n  scope?: string;\n  args?: string[];\n  traceMessages?: string[];\n  extraSections?: ErrorReportSection[];\n};\n\ntype ExecutionLogStatus = 'cancelled' | 'failed' | 'partial_failure' | 'success';\n\ntype WriteExecutionLogOptions = {\n  title?: string;\n  scope?: string;\n  status?: ExecutionLogStatus;\n  args?: string[];\n  startedAt?: Date;\n  finishedAt?: Date;\n  traceMessages?: string[];\n  extraSections?: ErrorReportSection[];\n  error?: unknown;\n};\n\ntype GitCommandOptions = {\n  allowFailure?: boolean;\n  trimOutput?: boolean;\n};\n\ntype ShellCommandProgressOptions = {\n  progressIntervalMs?: number;\n  progressMessage?: string;\n  streamOutput?: boolean;\n};\n\ntype ShellCommandFailureDetails = {\n  code: number | null;\n  command: string;\n  signal: NodeJS.Signals | null;\n  stderr: string;\n  stdout: string;\n};\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\nconst traceMessages: string[] = [];\nconst GEMINI_CLI_PACKAGE_NAME = 'sales-frontend-gemini-cli';\nlet cachedPackageRootPath = '';\n\n/**\n * @description\n * 현재 디렉터리가 gemini-cli 패키지 루트인지 확인합니다.\n * 번들 결과물에서 helper 코드가 각 엔트리 파일로 인라인되면 `__dirname` 기준점이 달라지므로,\n * package.json 이름으로 실제 패키지 루트를 식별해야 규칙/양식 파일 경로가 깨지지 않습니다.\n * @param directory 검사할 디렉터리 경로\n * @returns 현재 디렉터리가 gemini-cli 패키지 루트이면 true\n */\nfunction isGeminiCliPackageRoot(directory: string) {\n  const packageJsonPath = path.join(directory, 'package.json');\n\n  if (!fs.existsSync(packageJsonPath)) {\n    return false;\n  }\n\n  try {\n    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { name?: string };\n\n    return packageJson.name === GEMINI_CLI_PACKAGE_NAME;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * @description\n * 현재 실행 중인 번들 엔트리 기준으로 gemini-cli 패키지 루트를 찾습니다.\n * `dist/pr-review/review.js`, `dist/pr-review/gemini/gemini-commander.js`처럼\n * 엔트리 위치가 달라도 상위 디렉터리를 순회하며 package root를 찾도록 설계합니다.\n * @param startDirectory 패키지 루트 탐색을 시작할 디렉터리\n * @returns 규칙/양식 파일이 존재하는 gemini-cli 패키지 루트 경로\n */\nfunction resolveGeminiCliPackageRoot(startDirectory: string = __dirname) {\n  if (cachedPackageRootPath) {\n    return cachedPackageRootPath;\n  }\n\n  let currentDirectory = startDirectory;\n\n  while (true) {\n    if (isGeminiCliPackageRoot(currentDirectory)) {\n      cachedPackageRootPath = currentDirectory;\n\n      return cachedPackageRootPath;\n    }\n\n    const parentDirectory = path.dirname(currentDirectory);\n\n    if (parentDirectory === currentDirectory) {\n      break;\n    }\n\n    currentDirectory = parentDirectory;\n  }\n\n  /**\n   * @description\n   * package.json 탐색이 실패해도 기존 설치 구조(dist/common -> package root)를 우선 fallback으로 사용합니다.\n   * 예상치 못한 배포 환경에서도 최대한 기존 동작을 유지하기 위한 보수적 안전장치입니다.\n   */\n  cachedPackageRootPath = path.resolve(startDirectory, '../..');\n\n  return cachedPackageRootPath;\n}\n\n/**\n * @description\n * gemini-cli 패키지 루트를 기준으로 정적 asset 파일의 절대 경로를 계산합니다.\n * 번들 과정에서 helper 코드가 다른 엔트리에 인라인되어도 항상 같은 실제 파일을 가리키게 합니다.\n * @param relativeFilePath 패키지 루트 기준 상대 경로\n * @returns asset 파일의 절대 경로\n */\nfunction resolvePackageAssetPath(relativeFilePath: string) {\n  return path.resolve(resolveGeminiCliPackageRoot(), relativeFilePath);\n}\n\nexport const rulesPath = resolvePackageAssetPath('src/common/rules/review-rules.md');\nexport const namingRulesPath = resolvePackageAssetPath('src/common/rules/naming-rule.md');\nexport const codingConventionRulesPath = resolvePackageAssetPath('src/common/rules/coding-convention.md');\nexport const reviewFormPath = resolvePackageAssetPath('src/common/form/review-form.md');\nexport const reviewFormOneByOnePath = resolvePackageAssetPath('src/common/form/review-form-one-by-one.md');\nexport const REPORT_DIR = '.review-report';\nexport const tempDiffPath = 'temp_diff.txt';\nexport const AIServices: AIServiceType[] = ['gemini', 'claude', 'codex'];\nexport const COMMIT_FETCH_LIMIT = 20;\nexport const COMMIT_SELECTION_WINDOW = 8;\nexport const ignoreList = [\n  'package.json',\n  '*.yml',\n  '*.md',\n  '*.lock',\n  'dist/',\n  'node_modules/',\n  'assets/',\n  'public/',\n  '*.json',\n  '*.yaml',\n  '.review-report/' // 생성되는 리포트 폴더도 제외\n];\n\nexport function isTestMode(args: string[] = process.argv.slice(2)) {\n  return args.includes('--test');\n}\n\n/**\n * @description\n * AI CLI의 중간 stdout/stderr를 실시간으로 터미널에 노출할지 여부를 판단합니다.\n * 기본 실행은 조용한 모드로 유지하고, 사용자가 명시적으로 플래그를 줄 때만\n * AI 응답을 그대로 스트리밍합니다.\n * @param args 현재 실행 인자 목록\n * @returns 실시간 AI 출력 노출 여부\n */\nexport function shouldStreamAIOutput(args: string[] = process.argv.slice(2)) {\n  return args.includes('--stream-output');\n}\n\nexport function clearTraceMessages() {\n  traceMessages.length = 0;\n}\n\nexport function getTraceMessages() {\n  return [...traceMessages];\n}\n\n/**\n * @description\n * 터미널 선택 UI에서 동일한 색상 토큰을 재사용할 수 있도록 ANSI escape code를 상수화합니다.\n * 서비스 선택과 커밋 선택이 같은 시각 언어를 사용하도록 helper 내부에서만 공유합니다.\n */\nconst ANSI = {\n  bold: '\\u001b[1m',\n  cyan: '\\u001b[36m',\n  dim: '\\u001b[2m',\n  green: '\\u001b[32m',\n  reset: '\\u001b[0m',\n  yellow: '\\u001b[33m'\n} as const;\nconst ANSI_PATTERN = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;]*m`, 'g');\nconst COMBINING_MARK_PATTERN = /\\p{Mark}/u;\nconst GRAPHEME_SEGMENTER =\n  typeof Intl !== 'undefined' && 'Segmenter' in Intl ? new Intl.Segmenter('ko', { granularity: 'grapheme' }) : null;\n\ntype VisibleToken = {\n  value: string;\n  visibleWidth: number;\n};\n\n/**\n * @description\n * 리뷰 대상 파일 필터를 pathspec 배열 형태로 정의합니다.\n * 문자열 커맨드와 argv 기반 git 실행이 모두 같은 기준을 공유하도록 원본 패턴은 배열로 유지합니다.\n */\nfunction getGitDiffPathspecs() {\n  return {\n    excludePatterns: ignoreList.map((item) => `:(exclude)${item}`),\n    includePatterns: ['*.ts', '*.tsx', '*.js', '*.jsx']\n  };\n}\n\nfunction segmentGraphemes(value: string) {\n  if (!GRAPHEME_SEGMENTER) {\n    return [...value];\n  }\n\n  return [...GRAPHEME_SEGMENTER.segment(value)].map(({ segment }) => segment);\n}\n\nfunction isWideCodePoint(codePoint: number) {\n  return (\n    codePoint >= 0x1100 &&\n    (codePoint <= 0x115f ||\n      codePoint === 0x2329 ||\n      codePoint === 0x232a ||\n      (codePoint >= 0x2e80 && codePoint <= 0x3247 && codePoint !== 0x303f) ||\n      (codePoint >= 0x3250 && codePoint <= 0x4dbf) ||\n      (codePoint >= 0x4e00 && codePoint <= 0xa4c6) ||\n      (codePoint >= 0xa960 && codePoint <= 0xa97c) ||\n      (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||\n      (codePoint >= 0xf900 && codePoint <= 0xfaff) ||\n      (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||\n      (codePoint >= 0xfe30 && codePoint <= 0xfe6b) ||\n      (codePoint >= 0xff01 && codePoint <= 0xff60) ||\n      (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||\n      (codePoint >= 0x1f200 && codePoint <= 0x1f251) ||\n      (codePoint >= 0x20000 && codePoint <= 0x3fffd))\n  );\n}\n\nfunction isEmojiCodePoint(codePoint: number) {\n  return (\n    (codePoint >= 0x1f1e6 && codePoint <= 0x1f1ff) ||\n    (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||\n    (codePoint >= 0x2600 && codePoint <= 0x27bf)\n  );\n}\n\nfunction getGraphemeWidth(grapheme: string) {\n  let width = 0;\n\n  for (const character of grapheme) {\n    const codePoint = character.codePointAt(0);\n\n    if (!codePoint || COMBINING_MARK_PATTERN.test(character) || codePoint === 0x200d) {\n      continue;\n    }\n\n    if ((codePoint >= 0xfe00 && codePoint <= 0xfe0f) || (codePoint >= 0xe0100 && codePoint <= 0xe01ef)) {\n      continue;\n    }\n\n    if (isWideCodePoint(codePoint) || isEmojiCodePoint(codePoint)) {\n      width = Math.max(width, 2);\n\n      continue;\n    }\n\n    width = Math.max(width, 1);\n  }\n\n  return width;\n}\n\nfunction tokenizePlainText(value: string) {\n  return segmentGraphemes(value).map((segment) => ({\n    value: segment,\n    visibleWidth: getGraphemeWidth(segment)\n  }));\n}\n\nfunction tokenizeVisibleText(value: string) {\n  const tokens: VisibleToken[] = [];\n  let lastIndex = 0;\n\n  for (const match of value.matchAll(ANSI_PATTERN)) {\n    const index = match.index ?? 0;\n\n    if (index > lastIndex) {\n      tokens.push(...tokenizePlainText(value.slice(lastIndex, index)));\n    }\n\n    tokens.push({\n      value: match[0],\n      visibleWidth: 0\n    });\n    lastIndex = index + match[0].length;\n  }\n\n  if (lastIndex < value.length) {\n    tokens.push(...tokenizePlainText(value.slice(lastIndex)));\n  }\n\n  return tokens;\n}\n\n/**\n * @description\n * 모달 각 줄이 터미널 실제 폭을 넘지 않도록 ANSI 코드를 보존한 채 잘라냅니다.\n * 줄바꿈이 발생하면 렌더 줄 수 계산이 어긋나므로, 모든 선택 줄을 1 physical line로 강제합니다.\n * @param value 렌더할 문자열\n * @param maxWidth 허용 최대 표시 폭\n * @returns 터미널 폭 안으로 정리된 문자열\n */\nfunction truncateLineForTerminal(value: string, maxWidth: number) {\n  if (maxWidth <= 0) {\n    return '';\n  }\n\n  const tokens = tokenizeVisibleText(value);\n  const totalWidth = tokens.reduce((sum, token) => sum + token.visibleWidth, 0);\n\n  if (totalWidth <= maxWidth) {\n    return value;\n  }\n\n  const ellipsis = '...';\n  const ellipsisWidth = 3;\n  const targetWidth = Math.max(0, maxWidth - ellipsisWidth);\n  let usedWidth = 0;\n  let result = '';\n\n  for (const token of tokens) {\n    if (token.visibleWidth === 0) {\n      result += token.value;\n\n      continue;\n    }\n\n    if (usedWidth + token.visibleWidth > targetWidth) {\n      break;\n    }\n\n    result += token.value;\n    usedWidth += token.visibleWidth;\n  }\n\n  return `${result}${ellipsis}${ANSI.reset}`;\n}\n\nfunction fitLinesToTerminal(lines: string[]) {\n  const maxWidth = Math.max(20, (process.stdout.columns || 120) - 1);\n\n  return lines.map((line) => truncateLineForTerminal(line, maxWidth));\n}\n\n/**\n * @description\n * git 서브프로세스를 argv 배열 기반으로 실행합니다.\n * 커밋 해시나 파일 경로에 공백이 섞여도 shell quoting 문제 없이 동일한 동작을 보장하기 위해 공통 helper로 분리합니다.\n * @param args git 인자 배열\n * @param options 실패 허용 여부와 출력 trim 여부\n * @returns git 표준출력 문자열\n */\nfunction runGitCommand(args: string[], options: GitCommandOptions = {}) {\n  const { allowFailure = false, trimOutput = true } = options;\n\n  try {\n    const output = execFileSync('git', args, {\n      encoding: 'utf8',\n      maxBuffer: 1024 * 1024 * 20,\n      stdio: ['ignore', 'pipe', 'pipe']\n    });\n\n    return trimOutput ? output.trim() : output;\n  } catch (error) {\n    helperTrace('git-command:failed', `${args.join(' ')} | ${getErrorSummary(error)}`);\n\n    if (allowFailure) {\n      return '';\n    }\n\n    throw error;\n  }\n}\n\n/**\n * @description\n * shell 명령을 비동기로 실행하면서 stdout/stderr를 그대로 흘려보내고, 장시간 작업에는 경과 시간을 주기적으로 출력합니다.\n * review 실행처럼 응답 생성까지 오래 걸리는 CLI를 버퍼링 없이 기다리게 해 사용자가 멈춤으로 오해하지 않도록 합니다.\n * @param command 실행할 shell command 문자열\n * @param options 진행 메시지와 출력 주기 옵션\n * @returns 최종 stdout/stderr 캡처 결과\n */\nexport async function executeShellCommandWithProgress(command: string, options: ShellCommandProgressOptions = {}) {\n  const { progressIntervalMs = 10000, progressMessage = '⏳ 명령을 실행하는 중입니다...', streamOutput = false } = options;\n  const { spawn } = await import('child_process');\n\n  return new Promise<{ stderr: string; stdout: string }>((resolve, reject) => {\n    let stdout = '';\n    let stderr = '';\n    const startedAt = Date.now();\n    console.log(progressMessage);\n\n    const child = spawn('/bin/zsh', ['-lc', command], {\n      stdio: ['ignore', 'pipe', 'pipe']\n    });\n\n    const progressTimer = setInterval(() => {\n      const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1000));\n      console.log(`${progressMessage} (${elapsedSeconds}s 경과)`);\n    }, progressIntervalMs);\n\n    child.stdout.on('data', (chunk: Buffer | string) => {\n      const text = chunk.toString();\n      stdout += text;\n\n      if (streamOutput) {\n        process.stdout.write(text);\n      }\n    });\n\n    child.stderr.on('data', (chunk: Buffer | string) => {\n      const text = chunk.toString();\n      stderr += text;\n\n      if (streamOutput) {\n        process.stderr.write(text);\n      }\n    });\n\n    child.on('error', (error) => {\n      clearInterval(progressTimer);\n      reject(error);\n    });\n\n    child.on('close', (code, signal) => {\n      clearInterval(progressTimer);\n\n      if (code === 0) {\n        resolve({\n          stderr,\n          stdout\n        });\n\n        return;\n      }\n\n      const exitSummary = signal ? `signal=${signal}` : `code=${String(code ?? 'unknown')}`;\n      const failureDetails: ShellCommandFailureDetails = {\n        code,\n        command,\n        signal,\n        stderr,\n        stdout\n      };\n\n      reject(createShellCommandExecutionError(failureDetails, exitSummary));\n    });\n  });\n}\n\n/**\n * @description\n * shell 명령 실패 시 에러 메시지에 포함할 출력 미리보기를 생성합니다.\n * 일부 CLI는 실패 사유를 stderr가 아니라 stdout으로만 출력하므로, 두 채널을 함께 확인해야\n * 원인 파악이 가능합니다. 너무 긴 응답이 그대로 에러 제목에 붙지 않도록 마지막 일부만 잘라냅니다.\n * @param failureDetails 실패한 shell 명령의 실행 결과\n * @returns 에러 메시지에 붙일 출력 요약 문자열\n */\nfunction getShellCommandFailurePreview(failureDetails: ShellCommandFailureDetails) {\n  const stderrText = failureDetails.stderr.trim();\n  const stdoutText = failureDetails.stdout.trim();\n  const combinedOutput = stderrText || stdoutText;\n\n  if (!combinedOutput) {\n    return '';\n  }\n\n  const MAX_PREVIEW_LENGTH = 4000;\n\n  if (combinedOutput.length <= MAX_PREVIEW_LENGTH) {\n    return combinedOutput;\n  }\n\n  return combinedOutput.slice(-MAX_PREVIEW_LENGTH);\n}\n\n/**\n * @description\n * shell 명령 실패 정보를 Error 객체로 승격합니다.\n * 에러 리포트에서 실제 실패 원인을 확인할 수 있도록 stdout/stderr/command/exit code를\n * Error 인스턴스에 직접 부착합니다.\n * @param failureDetails 실패한 shell 명령의 실행 결과\n * @param exitSummary 종료 코드 또는 시그널 요약\n * @returns 실행 컨텍스트가 부착된 Error 객체\n */\nfunction createShellCommandExecutionError(failureDetails: ShellCommandFailureDetails, exitSummary: string) {\n  const failurePreview = getShellCommandFailurePreview(failureDetails);\n  const error = new Error(`쉘 명령 실행 실패 (${exitSummary})${failurePreview ? `\\n${failurePreview}` : ''}`) as Error &\n    Record<string, unknown>;\n\n  error.code = failureDetails.code;\n  error.signal = failureDetails.signal;\n  error.stdout = failureDetails.stdout;\n  error.stderr = failureDetails.stderr;\n  error.command = failureDetails.command;\n\n  return error;\n}\n\n/**\n * @description\n * 리뷰 대상 파일 목록을 한 줄 요약 문자열로 변환합니다.\n * 파일이 많을 때는 일부만 노출하고 나머지는 개수로 축약해 터미널 출력이 과도하게 길어지지 않도록 합니다.\n * @param files 리뷰 대상 파일 목록\n * @param visibleCount 터미널에 직접 보여줄 최대 파일 수\n * @returns 화면 표시용 요약 문자열\n */\nexport function formatReviewTargetFiles(files: string[], visibleCount = 5) {\n  if (files.length === 0) {\n    return '(없음)';\n  }\n\n  const visibleFiles = files.slice(0, visibleCount);\n  const hiddenCount = Math.max(0, files.length - visibleFiles.length);\n\n  if (hiddenCount === 0) {\n    return visibleFiles.join(', ');\n  }\n\n  return `${visibleFiles.join(', ')} 외 ${hiddenCount}개`;\n}\n\nexport function createTraceLogger(scope: string, args: string[] = process.argv.slice(2)) {\n  const enabled = isTestMode(args);\n\n  return (step: string, detail?: string) => {\n    const timestamp = new Date().toISOString();\n    const message = `[${timestamp}][TRACE][${scope}] ${step}${detail ? ` | ${detail}` : ''}`;\n    traceMessages.push(message);\n\n    if (!enabled) {\n      return;\n    }\n\n    console.log(message);\n  };\n}\n\nconst helperTrace = createTraceLogger('helper');\n\nfunction getTimestampParts(now = new Date()) {\n  return {\n    YYYY: now.getFullYear(),\n    MM: String(now.getMonth() + 1).padStart(2, '0'),\n    DD: String(now.getDate()).padStart(2, '0'),\n    HH: String(now.getHours()).padStart(2, '0'),\n    mm: String(now.getMinutes()).padStart(2, '0'),\n    ss: String(now.getSeconds()).padStart(2, '0')\n  };\n}\n\nfunction getHumanReadableNowString(now = new Date()) {\n  const { YYYY, MM, DD, HH, mm, ss } = getTimestampParts(now);\n\n  return `${YYYY}-${MM}-${DD} ${HH}:${mm}:${ss}`;\n}\n\nfunction stringifyUnknown(value: unknown) {\n  if (value === undefined || value === null) {\n    return '';\n  }\n\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  if (Buffer.isBuffer(value)) {\n    return value.toString();\n  }\n\n  if (value instanceof Error) {\n    return value.stack || value.message;\n  }\n\n  return inspect(value, { depth: 5, breakLength: 120 });\n}\n\nexport function getErrorSummary(error: unknown) {\n  if (error instanceof Error) {\n    return `${error.name}: ${error.message}`;\n  }\n\n  return stringifyUnknown(error) || 'Unknown error';\n}\n\nfunction serializeError(error: unknown) {\n  const serialized: Record<string, unknown> = {\n    summary: getErrorSummary(error)\n  };\n\n  if (error instanceof Error) {\n    serialized.name = error.name;\n    serialized.message = error.message;\n    serialized.stack = error.stack;\n  } else {\n    serialized.value = stringifyUnknown(error);\n  }\n\n  if (error && typeof error === 'object') {\n    const errorLike = error as Record<string, unknown>;\n    const extraKeys = ['code', 'errno', 'syscall', 'path', 'cmd', 'status', 'signal', 'spawnargs', 'command'];\n\n    extraKeys.forEach((key) => {\n      if (errorLike[key] !== undefined) {\n        serialized[key] = errorLike[key];\n      }\n    });\n\n    const stdout = stringifyUnknown(errorLike.stdout);\n    if (stdout) {\n      serialized.stdout = stdout;\n    }\n\n    const stderr = stringifyUnknown(errorLike.stderr);\n    if (stderr) {\n      serialized.stderr = stderr;\n    }\n\n    const cause = stringifyUnknown(errorLike.cause);\n    if (cause) {\n      serialized.cause = cause;\n    }\n  }\n\n  return serialized;\n}\n\nexport function getNextFilePath(dir: string, baseName: string, extension: string) {\n  let counter = 1;\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const filePath = path.join(dir, `${baseName}-${counter}${extension}`);\n    if (!fs.existsSync(filePath)) {\n      return filePath;\n    }\n    counter++;\n  }\n}\n\nexport function getAvailableFilePath(dir: string, baseName: string, extension: string) {\n  const firstFilePath = path.join(dir, `${baseName}${extension}`);\n  if (!fs.existsSync(firstFilePath)) {\n    return firstFilePath;\n  }\n\n  return getNextFilePath(dir, baseName, extension);\n}\n\nexport function deleteFile(filePath: string) {\n  if (fs.existsSync(filePath)) {\n    fs.unlinkSync(filePath);\n  }\n}\n\n/**\n * 임시파일 삭제\n */\nexport function deleteTempDiff() {\n  deleteFile(tempDiffPath);\n}\n\n/**\n * 리뷰 결과 폴더 생성\n */\nexport function createReportDirectory() {\n  if (!fs.existsSync(REPORT_DIR)) {\n    fs.mkdirSync(REPORT_DIR, { recursive: true });\n  }\n}\n\n/**\n * 현재 시간 문자열 생성\n */\nexport function getNowString(now = new Date()) {\n  const { YYYY, MM, DD, HH, mm, ss } = getTimestampParts(now);\n\n  return `${YYYY}-${MM}-${DD}_${HH}-${mm}-${ss}`;\n}\n\nexport function getErrorLogTimestamp(now = new Date()) {\n  const { YYYY, MM, DD, HH, mm, ss } = getTimestampParts(now);\n\n  return `${YYYY}-${MM}-${DD}-${HH}시-${mm}분-${ss}초`;\n}\n\nexport function writeErrorReport(error: unknown, options: WriteErrorReportOptions = {}) {\n  try {\n    const now = new Date();\n    helperTrace('error-report:write:start', options.scope || 'unknown');\n    createReportDirectory();\n\n    const reportPath = getAvailableFilePath(REPORT_DIR, `error-log-${getErrorLogTimestamp(now)}`, '.md');\n    const serializedError = serializeError(error);\n    const traceSnapshot = options.traceMessages ?? getTraceMessages();\n    const extraSections = options.extraSections || [];\n\n    const report = `# Error Log\n\n- 발생 시각: ${getHumanReadableNowString(now)}\n- Scope: \\`${options.scope || 'unknown'}\\`\n- 작업 경로: \\`${process.cwd()}\\`\n- 실행 인자: \\`${JSON.stringify(options.args ?? process.argv.slice(2))}\\`\n- 실행 환경: \\`${process.platform} ${process.arch} / Node ${process.version}\\`\n\n## Summary\n\n${options.title || serializedError.summary || 'Unknown error'}\n\n## Error\n\n\\`\\`\\`json\n${JSON.stringify(serializedError, null, 2)}\n\\`\\`\\`\n\n## Trace\n\n\\`\\`\\`json\n${JSON.stringify(traceSnapshot, null, 2)}\n\\`\\`\\`${extraSections.length ? `\\n${extraSections.map((section) => `\\n## ${section.heading}\\n\\n${section.markdown}`).join('\\n')}\\n` : '\\n'}\n`;\n\n    fs.writeFileSync(reportPath, report);\n    helperTrace('error-report:write:done', reportPath);\n\n    return reportPath;\n  } catch (writeError) {\n    console.error('⚠️ 에러 로그 파일 생성에 실패했습니다.');\n    console.error(writeError);\n\n    return '';\n  }\n}\n\nfunction getExecutionLogSummary(status: ExecutionLogStatus, title?: string) {\n  if (title) {\n    return title;\n  }\n\n  switch (status) {\n    case 'success':\n      return '리뷰 실행이 성공적으로 완료되었습니다.';\n    case 'failed':\n      return '리뷰 실행 중 오류가 발생했습니다.';\n    case 'partial_failure':\n      return '리뷰 실행은 완료되었지만 일부 단계에서 오류가 발생했습니다.';\n    default:\n      return '리뷰 실행이 취소되었거나 리뷰 대상이 없어 종료되었습니다.';\n  }\n}\n\nfunction formatExecutionDuration(startedAt: Date, finishedAt: Date) {\n  const durationMs = Math.max(0, finishedAt.getTime() - startedAt.getTime());\n\n  if (durationMs < 1000) {\n    return `${durationMs}ms`;\n  }\n\n  const durationSeconds = durationMs / 1000;\n\n  if (durationSeconds < 60) {\n    return `${durationSeconds.toFixed(1)}s`;\n  }\n\n  const minutes = Math.floor(durationSeconds / 60);\n  const seconds = Math.round(durationSeconds % 60);\n\n  return `${minutes}m ${seconds}s`;\n}\n\n/**\n * @description\n * 성공/실패 여부와 무관하게 리뷰 실행 자체의 진단 로그를 `.review-report`에 남깁니다.\n * 에러 로그와 별도로 실행 맥락, 생성된 명령어, trace를 항상 보존하여 재현과 원인 분석에 활용합니다.\n * @param options 실행 상태, 시작/종료 시각, 에러, 추가 섹션 등 실행 로그 작성 옵션\n * @returns 생성된 실행 로그 파일 경로. 실패 시 빈 문자열\n */\nexport function writeExecutionLog(options: WriteExecutionLogOptions = {}) {\n  try {\n    const startedAt = options.startedAt ?? new Date();\n    const finishedAt = options.finishedAt ?? new Date();\n    const status = options.status ?? 'success';\n    helperTrace('execution-log:write:start', options.scope || 'unknown');\n    createReportDirectory();\n\n    const reportPath = getAvailableFilePath(REPORT_DIR, `${getNowString(finishedAt)}-execution-log`, '.md');\n    const traceSnapshot = options.traceMessages ?? getTraceMessages();\n    const extraSections = options.extraSections || [];\n    const serializedError = options.error ? serializeError(options.error) : null;\n\n    const report = `# Execution Log\n\n- 시작 시각: ${getHumanReadableNowString(startedAt)}\n- 종료 시각: ${getHumanReadableNowString(finishedAt)}\n- 실행 시간: ${formatExecutionDuration(startedAt, finishedAt)}\n- 상태: \\`${status}\\`\n- Scope: \\`${options.scope || 'unknown'}\\`\n- 작업 경로: \\`${process.cwd()}\\`\n- 실행 인자: \\`${JSON.stringify(options.args ?? process.argv.slice(2))}\\`\n- 실행 환경: \\`${process.platform} ${process.arch} / Node ${process.version}\\`\n\n## Summary\n\n${getExecutionLogSummary(status, options.title)}\n${serializedError ? `\\n\\n## Error\\n\\n\\`\\`\\`json\\n${JSON.stringify(serializedError, null, 2)}\\n\\`\\`\\`` : ''}\n\n## Trace\n\n\\`\\`\\`json\n${JSON.stringify(traceSnapshot, null, 2)}\n\\`\\`\\`${extraSections.length ? `\\n${extraSections.map((section) => `\\n## ${section.heading}\\n\\n${section.markdown}`).join('\\n')}\\n` : '\\n'}\n`;\n\n    fs.writeFileSync(reportPath, report);\n    helperTrace('execution-log:write:done', reportPath);\n\n    return reportPath;\n  } catch (writeError) {\n    console.error('⚠️ 실행 로그 파일 생성에 실패했습니다.');\n    console.error(writeError);\n\n    return '';\n  }\n}\n\nexport function exitWithError(\n  message: string,\n  options: Omit<WriteErrorReportOptions, 'title'> & { error?: unknown } = {}\n): never {\n  const reportPath = writeErrorReport(options.error || new Error(message), {\n    ...options,\n    title: message\n  });\n\n  console.error(message);\n\n  if (options.error) {\n    console.error(options.error);\n  }\n\n  if (reportPath) {\n    console.error(`📄 에러 로그 저장 위치: ${reportPath}`);\n  }\n\n  process.exit(1);\n}\n\nfunction parseServiceFromArgs(args: string[] = process.argv.slice(2)): AIServiceType | '' {\n  helperTrace('parse-service:start', `args=${JSON.stringify(args)}`);\n  const serviceIndex = args.indexOf('--service');\n  const rawService = serviceIndex !== -1 ? args[serviceIndex + 1] : '';\n\n  if (!rawService) {\n    helperTrace('parse-service:empty');\n\n    return '';\n  }\n\n  const normalizedService = rawService.toLowerCase();\n\n  if (AIServices.includes(normalizedService as AIServiceType)) {\n    helperTrace('parse-service:resolved', normalizedService);\n\n    return normalizedService as AIServiceType;\n  }\n\n  helperTrace('parse-service:invalid', rawService);\n  exitWithError(\n    `❌ 지원하지 않는 서비스입니다: ${rawService}. 사용 가능 값: ${AIServices.join(', ')} (예: --service codex)`,\n    {\n      scope: 'helper:parseServiceFromArgs',\n      args,\n      extraSections: [\n        {\n          heading: 'Allowed Services',\n          markdown: `\\`\\`\\`json\\n${JSON.stringify(AIServices, null, 2)}\\n\\`\\`\\``\n        }\n      ]\n    }\n  );\n}\n\nexport function getGitDiffFilter() {\n  const { includePatterns, excludePatterns } = getGitDiffPathspecs();\n  const quote = (pattern: string) => `\"${pattern}\"`;\n  const includeParams = includePatterns.map(quote).join(' ');\n  const excludeParams = excludePatterns.map(quote).join(' ');\n\n  return { includeParams, excludeParams };\n}\n\n/**\n * @description\n * 커밋 선택 목록에서 subject가 과하게 길어지는 것을 막기 위해 표시 길이를 제한합니다.\n * commit hash와 메타데이터는 별도 필드로 유지하므로 UI 가독성에 필요한 subject만 자릅니다.\n * @param subject 원본 커밋 제목\n * @returns 화면 표시용 제목\n */\nfunction truncateCommitSubject(subject: string) {\n  if (subject.length <= 72) {\n    return subject;\n  }\n\n  return `${subject.slice(0, 69)}...`;\n}\n\n/**\n * @description\n * 최근 커밋 목록을 리뷰 선택 UI에서 바로 사용할 수 있는 구조로 변환합니다.\n * git log 포맷을 한 곳에서 관리해 main review와 one-by-one review가 같은 커밋 메타데이터를 공유하게 합니다.\n * @returns 최근 커밋 옵션 목록\n */\nexport function getRecentCommitOptions(): CommitOption[] {\n  const output = runGitCommand(\n    ['log', `-${COMMIT_FETCH_LIMIT}`, '--date=relative', '--pretty=format:%h%x09%an%x09%ar%x09%s'],\n    { allowFailure: true }\n  );\n\n  if (!output) {\n    return [];\n  }\n\n  return output.split('\\n').map((line) => {\n    const [hash = '', author = '', relativeDate = '', ...subjectParts] = line.split('\\t');\n    const subject = subjectParts.join('\\t').trim();\n\n    return {\n      author,\n      description: `${author} | ${relativeDate}`,\n      hash,\n      label: `${hash} | ${truncateCommitSubject(subject)}`,\n      relativeDate,\n      subject\n    };\n  });\n}\n\n/**\n * @description\n * 선택된 커밋 목록을 리포트 및 diff 헤더에 재사용할 수 있는 markdown bullet 문자열로 정리합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @returns 커밋 요약 markdown\n */\nexport function buildSelectedCommitSummary(commits: CommitOption[]) {\n  return commits.map((commit) => `- ${commit.hash} | ${commit.subject} | ${commit.author} | ${commit.relativeDate}`).join('\\n');\n}\n\n/**\n * @description\n * 리뷰 대상 pathspec 배열을 git argv에 바로 붙일 수 있게 평탄화합니다.\n * 문자열 커맨드와 다른 경로 기반 helper도 같은 필터를 공유하도록 helper 함수로 분리합니다.\n * @returns include/exclude pathspec 배열\n */\nfunction getReviewPathspecArgs() {\n  const { includePatterns, excludePatterns } = getGitDiffPathspecs();\n\n  return [...includePatterns, ...excludePatterns];\n}\n\n/**\n * @description\n * 선택된 여러 커밋의 전체 diff를 한 파일에 합칩니다.\n * 각 커밋을 별도 섹션으로 감싸 AI가 커밋 경계를 잃지 않도록 하며, 기존 리뷰 대상 확장자 필터도 그대로 적용합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @returns 리뷰용 통합 diff 텍스트\n */\nexport function buildSelectedCommitDiff(commits: CommitOption[]) {\n  const reviewPathspecArgs = getReviewPathspecArgs();\n  const sections = commits\n    .map((commit) => {\n      const diff = runGitCommand(['show', '--stat', '--patch', '--format=', commit.hash, '--', ...reviewPathspecArgs], {\n        allowFailure: true,\n        trimOutput: false\n      }).trim();\n\n      if (!diff) {\n        return '';\n      }\n\n      return [`## ${commit.hash} ${commit.subject}`, diff].join('\\n\\n');\n    })\n    .filter(Boolean)\n    .join('\\n\\n');\n\n  if (!sections) {\n    return '';\n  }\n\n  return ['# 선택한 커밋', buildSelectedCommitSummary(commits), '', '# 리뷰 대상 diff', sections].join('\\n');\n}\n\n/**\n * @description\n * 선택된 커밋에서 실제 리뷰 대상 파일 목록만 추출합니다.\n * one-by-one 리뷰가 현재 선택된 커밋 집합에만 반응하도록 commit별 name-only 결과를 합집합으로 계산합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @returns 중복 제거된 파일 목록\n */\nexport function getSelectedCommitFiles(commits: CommitOption[]) {\n  const reviewPathspecArgs = getReviewPathspecArgs();\n  const files = new Set<string>();\n\n  commits.forEach((commit) => {\n    const output = runGitCommand(['show', '--pretty=format:', '--name-only', commit.hash, '--', ...reviewPathspecArgs], {\n      allowFailure: true\n    });\n\n    output\n      .split('\\n')\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .forEach((filePath) => files.add(filePath));\n  });\n\n  return [...files];\n}\n\n/**\n * @description\n * 특정 파일에 대한 선택 커밋들의 diff만 모아서 one-by-one 리뷰 입력으로 만듭니다.\n * 동일 파일이 여러 커밋에서 바뀐 경우 commit section을 나눠 보여줘 파일 리뷰 응답이 어느 변경을 다루는지 추적 가능하게 합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @param filePath 리뷰할 파일 경로\n * @returns 단일 파일 리뷰용 diff 텍스트\n */\nexport function buildSelectedFileDiff(commits: CommitOption[], filePath: string) {\n  const sections = commits\n    .map((commit) => {\n      const diff = runGitCommand(['show', '--stat', '--patch', '--format=', commit.hash, '--', filePath], {\n        allowFailure: true,\n        trimOutput: false\n      }).trim();\n\n      if (!diff) {\n        return '';\n      }\n\n      return [`## ${commit.hash} ${commit.subject}`, diff].join('\\n\\n');\n    })\n    .filter(Boolean)\n    .join('\\n\\n');\n\n  if (!sections) {\n    return '';\n  }\n\n  return ['# 선택한 커밋', buildSelectedCommitSummary(commits), '', `# 파일: ${filePath}`, sections].join('\\n\\n');\n}\n\n/**\n * openReport를 OS별로 동작하도록 변경\n * 우선순위:\n * 1. Chrome 시도\n *    - macOS: open -a \"Google Chrome\" \"<path>\"\n *    - Ubuntu/Linux: google-chrome \"<path>\"\n * 2. 실패 시 기본 브라우저로 폴백\n *    - macOS: open \"<path>\"\n *    - Ubuntu/Linux: xdg-open \"<path>\"\n * 3. 둘 다 실패하면 에러 출력\n * 4. 미지원 플랫폼이면 플랫폼 경고 출력\n */\nexport function openReport(reportPath: string) {\n  const resolvedPath = path.resolve(reportPath);\n  const { platform } = process;\n  helperTrace('open-report:start', resolvedPath);\n\n  const openWithChrome = () => {\n    if (platform === 'darwin') {\n      execSync(`open -a \"Google Chrome\" \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    if (platform === 'linux') {\n      execSync(`google-chrome \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    return false;\n  };\n\n  const openWithDefaultBrowser = () => {\n    if (platform === 'darwin') {\n      execSync(`open \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    if (platform === 'linux') {\n      execSync(`xdg-open \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    return false;\n  };\n\n  try {\n    if (openWithChrome()) {\n      helperTrace('open-report:chrome:success', platform);\n      console.log('🚀 Google Chrome에서 리포트를 열었습니다.');\n\n      return;\n    }\n  } catch (error) {\n    helperTrace('open-report:chrome:failed', getErrorSummary(error));\n    // Chrome 실행 실패 시 기본 브라우저로 폴백\n  }\n\n  try {\n    if (openWithDefaultBrowser()) {\n      helperTrace('open-report:default-browser:success', platform);\n      console.log('🚀 기본 브라우저에서 리포트를 열었습니다.');\n\n      return;\n    }\n  } catch (error) {\n    helperTrace('open-report:default-browser:failed', getErrorSummary(error));\n    console.error('⚠️ 브라우저 열기 실패:', error);\n\n    return;\n  }\n\n  helperTrace('open-report:unsupported-platform', platform);\n  console.error(`⚠️ 지원하지 않는 플랫폼입니다: ${platform}`);\n}\n\n/**\n * @description\n * raw mode 기반 선택 UI를 안전하게 열 수 있는 TTY 환경인지 검증합니다.\n * CI나 pipe 환경에서는 커서를 제어할 수 없으므로 즉시 에러 리포트를 남기고 종료합니다.\n * @param scope 에러 리포트 구분용 scope\n * @param message 사용자에게 보여줄 에러 메시지\n */\nfunction ensureInteractiveSelectionAvailable(scope: string, message: string) {\n  if (process.stdin.isTTY && process.stdout.isTTY && typeof process.stdin.setRawMode === 'function') {\n    return;\n  }\n\n  helperTrace(`${scope}:tty-missing`);\n  exitWithError(message, {\n    scope: `helper:${scope}`\n  });\n}\n\n/**\n * @description\n * 선택 모달을 현재 위치에서 다시 그립니다.\n * 각 줄은 미리 터미널 폭 안으로 잘라 physical line이 1줄로 유지되므로,\n * 직전 렌더 줄 수만큼 위로 이동한 뒤 clearScreenDown 해도 중복 없이 안정적으로 갱신됩니다.\n * @param lines 새로 렌더할 문자열 줄 목록\n * @param previousLineCount 직전 렌더 줄 수\n * @returns 현재 렌더 줄 수\n */\nfunction renderSelectionBlock(lines: string[], previousLineCount: number) {\n  if (previousLineCount > 0) {\n    readline.moveCursor(process.stdout, 0, -previousLineCount);\n    readline.clearScreenDown(process.stdout);\n  }\n\n  const fittedLines = fitLinesToTerminal(lines);\n  process.stdout.write(`${fittedLines.join('\\n')}\\n`);\n\n  return fittedLines.length;\n}\n\n/**\n * @description\n * 현재 커서 기준 visible window를 계산해 긴 커밋 목록도 고정 높이로 탐색할 수 있게 만듭니다.\n * @param optionCount 전체 옵션 개수\n * @param selectedIndex 현재 포커스 인덱스\n * @param windowSize 동시에 보여줄 최대 옵션 개수\n * @returns 시작/끝 인덱스\n */\nfunction getSelectionWindowRange(optionCount: number, selectedIndex: number, windowSize: number) {\n  if (optionCount <= windowSize) {\n    return {\n      end: optionCount,\n      start: 0\n    };\n  }\n\n  const halfWindow = Math.floor(windowSize / 2);\n  const maxStart = optionCount - windowSize;\n  const start = Math.max(0, Math.min(selectedIndex - halfWindow, maxStart));\n\n  return {\n    end: Math.min(optionCount, start + windowSize),\n    start\n  };\n}\n\n/**\n * @description\n * 공통 multi-select UI 렌더링에 필요한 문자열 목록을 구성합니다.\n * 설명 텍스트는 dim 처리해 subject와 author/date가 한 줄에서 구분되도록 합니다.\n * @param question 질문 헤더\n * @param options 표시할 옵션 목록\n * @param selectedIndex 현재 포커스 인덱스\n * @param toggled 선택된 인덱스 Set\n * @param windowSize 동시에 보여줄 최대 옵션 개수\n * @returns 출력 줄 목록\n */\nfunction buildMultiSelectLines<T>(\n  question: string,\n  options: MultiSelectOption<T>[],\n  selectedIndex: number,\n  toggled: Set<number>,\n  windowSize: number\n) {\n  const { start, end } = getSelectionWindowRange(options.length, selectedIndex, windowSize);\n  const lines = [\n    `${ANSI.bold}${question}${ANSI.reset}`,\n    `${ANSI.dim}↑↓ 이동 | Space 선택/해제 | Enter 완료 | Esc 취소${ANSI.reset}`,\n    `${ANSI.dim}선택됨: ${toggled.size}개 / 전체: ${options.length}개${ANSI.reset}`\n  ];\n\n  for (let index = start; index < end; index += 1) {\n    const option = options[index];\n\n    if (!option) {\n      continue;\n    }\n\n    const cursor = index === selectedIndex ? `${ANSI.cyan}>${ANSI.reset}` : ' ';\n    const checked = toggled.has(index) ? `${ANSI.green}☑${ANSI.reset}` : '☐';\n    const description = option.description ? ` ${ANSI.dim}${option.description}${ANSI.reset}` : '';\n    lines.push(`${cursor} ${checked} ${option.label}${description}`);\n  }\n\n  if (options.length > windowSize) {\n    lines.push(`${ANSI.dim}표시 범위: ${start + 1}-${end} / ${options.length}${ANSI.reset}`);\n  }\n\n  return lines;\n}\n\n/**\n * @description\n * 커밋 선택처럼 복수 선택이 필요한 터미널 모달을 공통으로 처리합니다.\n * raw mode를 직접 제어해 방향키, Space, Enter, Esc를 읽고 선택된 value 목록만 반환합니다.\n * @param question 사용자 안내 문구\n * @param options 선택 옵션 목록\n * @param windowSize 동시에 보여줄 최대 옵션 개수\n * @returns 사용자가 확정한 선택 값 배열\n */\nexport async function showMultiSelect<T>(question: string, options: MultiSelectOption<T>[], windowSize = COMMIT_SELECTION_WINDOW) {\n  ensureInteractiveSelectionAvailable('showMultiSelect', '❌ 커밋 선택 모달은 TTY 환경에서만 사용할 수 있습니다.');\n  let selectedIndex = 0;\n  let renderedLineCount = 0;\n  const toggled = new Set<number>();\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    terminal: true\n  });\n\n  process.stdout.write('\\u001b[?25l');\n\n  const cleanup = () => {\n    if (renderedLineCount > 0) {\n      readline.moveCursor(process.stdout, 0, -renderedLineCount);\n      readline.clearScreenDown(process.stdout);\n      renderedLineCount = 0;\n    }\n    process.stdin.removeListener('data', onData);\n    process.stdin.setRawMode(false);\n    process.stdin.pause();\n    rl.close();\n    process.stdout.write('\\u001b[?25h');\n  };\n\n  const render = () => {\n    const lines = buildMultiSelectLines(question, options, selectedIndex, toggled, windowSize);\n    renderedLineCount = renderSelectionBlock(lines, renderedLineCount);\n  };\n\n  const confirmSelection = (resolve: (value: T[]) => void) => {\n    const values = [...toggled]\n      .sort((left, right) => left - right)\n      .map((index) => options[index]?.value)\n      .filter((value): value is T => value !== undefined);\n\n    cleanup();\n    resolve(values);\n  };\n\n  const cancelSelection = (resolve: (value: T[]) => void) => {\n    cleanup();\n    resolve([]);\n  };\n\n  let onData = (_data: Buffer) => {\n    // 실제 구현은 Promise 생성 시점에 바인딩합니다.\n  };\n\n  render();\n\n  return new Promise<T[]>((resolve) => {\n    onData = (data: Buffer) => {\n      const key = data.toString();\n\n      if (key === '\\u0003') {\n        cleanup();\n        process.exit(0);\n      }\n\n      if (key === '\\u001b') {\n        cancelSelection(resolve);\n\n        return;\n      }\n\n      if (key === '\\x1b[A') {\n        selectedIndex = (selectedIndex - 1 + options.length) % options.length;\n        render();\n\n        return;\n      }\n\n      if (key === '\\x1b[B') {\n        selectedIndex = (selectedIndex + 1) % options.length;\n        render();\n\n        return;\n      }\n\n      if (key === ' ') {\n        if (toggled.has(selectedIndex)) {\n          toggled.delete(selectedIndex);\n        } else {\n          toggled.add(selectedIndex);\n        }\n        render();\n\n        return;\n      }\n\n      if (key === '\\r' || key === '\\n') {\n        confirmSelection(resolve);\n      }\n    };\n\n    process.stdin.setRawMode(true);\n    process.stdin.resume();\n    process.stdin.on('data', onData);\n  });\n}\n\n/**\n * @description\n * 최근 커밋 목록을 modal UI로 선택받아 review 엔트리포인트에서 바로 재사용할 수 있게 반환합니다.\n * @returns 사용자가 고른 커밋 목록\n */\nexport async function selectReviewCommits() {\n  const commits = getRecentCommitOptions();\n\n  if (commits.length === 0) {\n    console.log('ℹ️ 리뷰할 최근 커밋이 없습니다.');\n\n    return [];\n  }\n\n  return showMultiSelect<CommitOption>(\n    '리뷰할 커밋을 선택해주세요.',\n    commits.map((commit) => ({\n      description: commit.description,\n      label: commit.label,\n      value: commit\n    })),\n    COMMIT_SELECTION_WINDOW\n  );\n}\n\n/**\n * AI 서비스 선택\n */\nexport function selectAIService() {\n  const service = parseServiceFromArgs();\n\n  if (!service) {\n    helperTrace('select-service:missing');\n    exitWithError('❌ 서비스가 선택되지 않았습니다.', {\n      scope: 'helper:selectAIService'\n    });\n  }\n\n  helperTrace('select-service:done', service);\n\n  return service;\n}\n\n/**\n * 터미널에서 라디오 버튼 형태로 AI 서비스를 선택합니다.\n */\nexport async function showSelectionAIService(): Promise<AIServiceType> {\n  const selectedServiceFromArgs = parseServiceFromArgs();\n\n  if (selectedServiceFromArgs) {\n    helperTrace('show-selection:from-args', selectedServiceFromArgs);\n    console.log(`\\n✅ ${ANSI.green}${selectedServiceFromArgs}${ANSI.reset} 서비스가 선택되었습니다. (--service)\\n`);\n\n    return selectedServiceFromArgs;\n  }\n\n  ensureInteractiveSelectionAvailable('showSelectionAIService', '❌ AI 서비스 선택 UI는 TTY 환경에서만 사용할 수 있습니다.');\n  helperTrace('show-selection:interactive:start');\n  let selectedIndex = 0;\n\n  // Use readline to handle keypresses\n  // 키 입력을 처리하기 위해 readline 인터페이스 사용\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    terminal: true\n  });\n\n  let firstRender = true;\n\n  // Hide cursor\n  process.stdout.write('\\u001b[?25l');\n\n  const render = () => {\n    if (!firstRender) {\n      // Move cursor back to the starting line of the selection UI\n      // We print (1 question line + services.length lines)\n      // 선택 UI의 시작 라인으로 커서 이동 (질문 1줄 + 서비스 목록 N줄)\n      readline.moveCursor(process.stdout, 0, -(AIServices.length + 1));\n    }\n    firstRender = false;\n    helperTrace('show-selection:interactive:render', AIServices[selectedIndex] || 'unknown');\n\n    // Clear everything from cursor down to avoid ghosting/overlaps\n    // 잔상이나 겹침을 방지하기 위해 커서 위치부터 아래쪽 모두 지움\n    readline.clearScreenDown(process.stdout);\n\n    process.stdout.write(\n      `🤖 AI 서비스를 선택해주세요 (${ANSI.yellow}↑↓ 방향키${ANSI.reset} 이동, ${ANSI.yellow}Enter${ANSI.reset} 선택):\\n`\n    );\n    AIServices.forEach((service, index) => {\n      if (index === selectedIndex) {\n        process.stdout.write(` ${ANSI.cyan}>${ANSI.reset} ${ANSI.cyan}◉${ANSI.reset} ${ANSI.bold}${service}${ANSI.reset}\\n`);\n      } else {\n        process.stdout.write(`   ◯ ${service}\\n`);\n      }\n    });\n  };\n\n  render();\n\n  return new Promise((resolve) => {\n    const onData = (data: Buffer) => {\n      const key = data.toString();\n      if (key === '\\u0003') {\n        // Ctrl+C\n        helperTrace('show-selection:interactive:ctrl-c');\n        process.stdout.write('\\u001b[?25h'); // Show cursor\n        process.exit(0);\n      }\n      if (key === '\\x1b[A') {\n        // Up arrow\n        selectedIndex = (selectedIndex - 1 + AIServices.length) % AIServices.length;\n        render();\n      } else if (key === '\\x1b[B') {\n        // Down arrow\n        selectedIndex = (selectedIndex + 1) % AIServices.length;\n        render();\n      } else if (key === '\\r' || key === '\\n') {\n        // Enter\n        process.stdin.removeListener('data', onData);\n        process.stdin.setRawMode(false);\n        process.stdin.pause();\n        rl.close();\n\n        // Show cursor\n        process.stdout.write('\\u001b[?25h');\n\n        console.log(`\\n✅ ${ANSI.green}${AIServices[selectedIndex]}${ANSI.reset} 서비스가 선택되었습니다.\\n`);\n        const result = AIServices[selectedIndex];\n        if (result) {\n          helperTrace('show-selection:interactive:confirmed', result);\n          resolve(result);\n        }\n      }\n    };\n\n    process.stdin.setRawMode(true);\n    process.stdin.resume();\n    process.stdin.on('data', onData);\n  });\n}\n","import fs from 'fs';\n\nimport { codingConventionRulesPath, createTraceLogger, namingRulesPath, rulesPath } from '../../common/helper';\n\nconst args = process.argv.slice(2);\nconst trace = createTraceLogger('claude-commander', args);\nconst ALLOWED_REASONING_EFFORTS = ['minimal', 'low', 'medium', 'high'] as const;\n\ntype ReasoningEffort = (typeof ALLOWED_REASONING_EFFORTS)[number];\ntype ClaudeEffort = 'low' | 'medium' | 'high';\n\nfunction shellQuote(value: string) {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\n/**\n * @description\n * shell 옵션 값이 단순 토큰이면 따옴표 없이 그대로 사용하고,\n * 공백이나 shell 특수문자가 섞이면 안전하게 single quote로 감쌉니다.\n * Claude 모델명과 effort 값은 보통 단순 토큰이므로, 복붙 과정에서\n * 스마트 쿼트로 변형되어 발생하는 재현 오류를 줄이기 위해 분기합니다.\n * @param value shell 옵션에 전달할 값\n * @returns shell command에 삽입 가능한 안전한 토큰 문자열\n */\nfunction toShellOptionToken(value: string) {\n  const SIMPLE_SHELL_TOKEN_PATTERN = /^[A-Za-z0-9._:/=-]+$/;\n\n  if (SIMPLE_SHELL_TOKEN_PATTERN.test(value)) {\n    return value;\n  }\n\n  return shellQuote(value);\n}\n\nfunction getArgValue(flag: string) {\n  const index = args.indexOf(flag);\n\n  if (index === -1 || !args[index + 1]) {\n    return '';\n  }\n\n  return args[index + 1];\n}\n\nfunction printNotice(message: string) {\n  if (args.includes('--test')) {\n    console.warn(message);\n  }\n}\n\nfunction toUnique(values: string[]) {\n  const seen = new Set<string>();\n\n  return values.filter((value) => {\n    if (!value || seen.has(value)) {\n      return false;\n    }\n    seen.add(value);\n\n    return true;\n  });\n}\n\nfunction normalizeEffort(level: ReasoningEffort): ClaudeEffort {\n  if (level === 'minimal') {\n    return 'low';\n  }\n\n  return level;\n}\n\nfunction resolveReasoningEffort(): ClaudeEffort {\n  const customReasoningEffort = getArgValue('--reasoning-effort') || getArgValue('--effort');\n\n  if (customReasoningEffort) {\n    if (ALLOWED_REASONING_EFFORTS.includes(customReasoningEffort as ReasoningEffort)) {\n      const normalized = normalizeEffort(customReasoningEffort as ReasoningEffort);\n      trace('reasoning:custom', `${customReasoningEffort} -> ${normalized}`);\n\n      if (customReasoningEffort === 'minimal') {\n        printNotice('⚠️ Claude는 minimal을 직접 지원하지 않아 low로 매핑합니다.');\n      }\n\n      return normalized;\n    }\n\n    printNotice(\n      `⚠️ 지원되지 않는 reasoning effort(${customReasoningEffort})입니다. allowed: ${ALLOWED_REASONING_EFFORTS.join(\n        ', '\n      )}`\n    );\n  }\n\n  if (args.includes('--flash')) {\n    trace('reasoning:flash-default', 'low');\n\n    return 'low';\n  }\n\n  if (args.includes('--review')) {\n    trace('reasoning:review-default', 'high');\n\n    return 'high';\n  }\n\n  trace('reasoning:default', 'medium');\n\n  return 'medium';\n}\n\nfunction resolvePrimaryAlias() {\n  if (args.includes('--review')) {\n    trace('model:mode-alias', 'opus');\n\n    return 'opus';\n  }\n\n  if (args.includes('--flash')) {\n    trace('model:mode-alias', 'haiku');\n\n    return 'haiku';\n  }\n\n  trace('model:default-alias', 'sonnet');\n\n  return 'sonnet';\n}\n\nfunction getAliasFallbacks(primaryAlias: string) {\n  if (primaryAlias === 'opus') {\n    return ['opus', 'sonnet', 'haiku'];\n  }\n\n  if (primaryAlias === 'haiku') {\n    return ['haiku', 'sonnet'];\n  }\n\n  return [primaryAlias, 'sonnet', 'haiku'];\n}\n\nfunction buildClaudeExecCommand(options: {\n  tempDiffPath: string;\n  prompt: string;\n  systemPromptFiles: string[];\n  effort: ClaudeEffort;\n  model?: string;\n  fallbackModel?: string;\n}) {\n  const { tempDiffPath, prompt, systemPromptFiles, effort, model, fallbackModel } = options;\n  const modelOption = model ? `--model ${toShellOptionToken(model)}` : '';\n  const fallbackOption = model && fallbackModel ? `--fallback-model ${toShellOptionToken(fallbackModel)}` : '';\n  const effortOption = `--effort ${toShellOptionToken(effort)}`;\n\n  const appendedPromptFiles = systemPromptFiles\n    .map((path) => `--append-system-prompt-file ${shellQuote(path)}`)\n    .join(' ');\n\n  return `cat ${shellQuote(tempDiffPath)} | claude ${[\n    modelOption,\n    fallbackOption,\n    effortOption,\n    appendedPromptFiles,\n    '-p',\n    shellQuote(prompt)\n  ]\n    .filter(Boolean)\n    .join(' ')}`;\n}\n\n/**\n * @description\n * Claude Code CLI를 활용한 코드 리뷰 명령어를 생성합니다.\n *\n * 모델 전략:\n * 1) --model 커스텀 모델 우선 시도\n * 2) 서비스 alias 순차 폴백 (opus/sonnet/haiku 조합)\n * 3) 마지막에 --model 없이 계정/CLI 기본 모델로 폴백\n *\n * reasoning 전략:\n * - --effort(low|medium|high)를 사용\n * - --reasoning-effort(minimal|low|medium|high) 입력 시 Claude 호환 값으로 매핑\n */\nexport const createClaudeCommand = (tempDiffPath: string, reviewFormPath: string) => {\n  trace('createClaudeCommand:start', `tempDiffPath=${tempDiffPath}, reviewFormPath=${reviewFormPath}`);\n  const customModel = getArgValue('--model');\n  const effort = resolveReasoningEffort();\n  const primaryAlias = resolvePrimaryAlias();\n  const aliasFallbacks = toUnique(getAliasFallbacks(primaryAlias));\n\n  // 룰셋 파일들을 --append-system-prompt-file 로 시스템 프롬프트에 추가\n  // Claude가 \"지침/규칙\"으로 인식하도록 시스템 프롬프트 레벨에 주입\n  const rules = [\n    { path: rulesPath, display: '룰셋' },\n    { path: namingRulesPath, display: '네이밍 규칙' },\n    { path: codingConventionRulesPath, display: '코딩 컨벤션' }\n  ];\n  const existingRuleFiles = rules.filter((rule) => fs.existsSync(rule.path)).map((rule) => rule.path);\n\n  trace('rules:loaded', `count=${existingRuleFiles.length}`);\n\n  // 리뷰 양식도 시스템 프롬프트에 추가 (출력 포맷 지침)\n  const reviewFormExists = fs.existsSync(reviewFormPath);\n  trace('reviewForm:status', reviewFormExists ? 'exists' : 'missing');\n  const systemPromptFiles = reviewFormExists ? [...existingRuleFiles, reviewFormPath] : existingRuleFiles;\n\n  const prompt = '위 규칙들을 참고하여 이 diff를 코드리뷰해줘. 리뷰양식에 맞춰서 작성해줘.';\n  trace('prompt:prepared', `length=${prompt.length}`);\n  trace('system-prompt-files', `count=${systemPromptFiles.length}`);\n  const modelCandidates = toUnique(customModel ? [customModel, ...aliasFallbacks] : aliasFallbacks);\n  trace('model:candidates', modelCandidates.join(', '));\n  trace('command:candidates:count', String(modelCandidates.length + 1));\n\n  if (customModel) {\n    printNotice(\n      `⚠️ 커스텀 모델(${customModel})을 우선 시도하고 실패하면 alias(${aliasFallbacks.join(\n        ' -> '\n      )}) 및 기본 모델 순으로 폴백합니다.`\n    );\n  } else {\n    printNotice(\n      `⚠️ 모델이 지정되지 않았습니다. alias(${aliasFallbacks.join(' -> ')})를 순차 시도하고 마지막에 기본 모델로 폴백합니다.`\n    );\n  }\n\n  const commandCandidates = modelCandidates.map((model, index) => {\n    const fallbackModel = modelCandidates[index + 1];\n\n    return buildClaudeExecCommand({\n      tempDiffPath,\n      prompt,\n      systemPromptFiles,\n      effort,\n      model,\n      fallbackModel\n    });\n  });\n\n  const command = [\n    ...commandCandidates,\n    buildClaudeExecCommand({\n      tempDiffPath,\n      prompt,\n      systemPromptFiles,\n      effort\n    })\n  ].join(' || ');\n\n  trace('command:created');\n\n  // test mode\n  if (args.includes('--test')) {\n    const safeCommand = command.replace(/\"/g, '\\\\\"');\n    trace('test-mode:return-preview');\n\n    return `echo \"[TEST MODE] Claude 명령어가 실행되지 않았습니다.\\n\\n생성될 명령어 미리보기:\\n${safeCommand}\"`;\n  }\n\n  trace('command:mode', 'execute');\n  trace('createClaudeCommand:end');\n\n  return command;\n};\n"]}
+{"version":3,"sources":["../../../src/common/helper.ts","../../../src/pr-review/claude/claude-commander.ts"],"names":["__dirname","path","fileURLToPath","fs","args","reviewFormPath"],"mappings":"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","file":"claude-commander.cjs","sourcesContent":["import { execFileSync, execSync } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\nimport readline from 'readline';\nimport { fileURLToPath } from 'url';\nimport { inspect } from 'util';\n\nimport { AIServiceType, CommitOption, MultiSelectOption, ReviewTargetKind } from './types';\n\ntype ErrorReportSection = {\n  heading: string;\n  markdown: string;\n};\n\ntype WriteErrorReportOptions = {\n  title?: string;\n  scope?: string;\n  args?: string[];\n  traceMessages?: string[];\n  extraSections?: ErrorReportSection[];\n};\n\ntype ExecutionLogStatus = 'cancelled' | 'failed' | 'partial_failure' | 'success';\n\ntype WriteExecutionLogOptions = {\n  title?: string;\n  scope?: string;\n  status?: ExecutionLogStatus;\n  args?: string[];\n  startedAt?: Date;\n  finishedAt?: Date;\n  traceMessages?: string[];\n  extraSections?: ErrorReportSection[];\n  error?: unknown;\n};\n\ntype GitCommandOptions = {\n  allowFailure?: boolean;\n  trimOutput?: boolean;\n};\n\ntype ShellCommandProgressOptions = {\n  progressIntervalMs?: number;\n  progressMessage?: string;\n  streamOutput?: boolean;\n};\n\ntype ShellCommandFailureDetails = {\n  code: number | null;\n  command: string;\n  signal: NodeJS.Signals | null;\n  stderr: string;\n  stdout: string;\n};\n\ntype ShellLaunchConfig = {\n  executable: string;\n  shellArgs: string[];\n};\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\nconst traceMessages: string[] = [];\nconst GEMINI_CLI_PACKAGE_NAME = 'sales-frontend-gemini-cli';\nlet cachedPackageRootPath = '';\n\n/**\n * @description\n * 현재 디렉터리가 gemini-cli 패키지 루트인지 확인합니다.\n * 번들 결과물에서 helper 코드가 각 엔트리 파일로 인라인되면 `__dirname` 기준점이 달라지므로,\n * package.json 이름으로 실제 패키지 루트를 식별해야 규칙/양식 파일 경로가 깨지지 않습니다.\n * @param directory 검사할 디렉터리 경로\n * @returns 현재 디렉터리가 gemini-cli 패키지 루트이면 true\n */\nfunction isGeminiCliPackageRoot(directory: string) {\n  const packageJsonPath = path.join(directory, 'package.json');\n\n  if (!fs.existsSync(packageJsonPath)) {\n    return false;\n  }\n\n  try {\n    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as { name?: string };\n\n    return packageJson.name === GEMINI_CLI_PACKAGE_NAME;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * @description\n * 현재 실행 중인 번들 엔트리 기준으로 gemini-cli 패키지 루트를 찾습니다.\n * `dist/pr-review/review.js`, `dist/pr-review/gemini/gemini-commander.js`처럼\n * 엔트리 위치가 달라도 상위 디렉터리를 순회하며 package root를 찾도록 설계합니다.\n * @param startDirectory 패키지 루트 탐색을 시작할 디렉터리\n * @returns 규칙/양식 파일이 존재하는 gemini-cli 패키지 루트 경로\n */\nfunction resolveGeminiCliPackageRoot(startDirectory: string = __dirname) {\n  if (cachedPackageRootPath) {\n    return cachedPackageRootPath;\n  }\n\n  let currentDirectory = startDirectory;\n\n  while (true) {\n    if (isGeminiCliPackageRoot(currentDirectory)) {\n      cachedPackageRootPath = currentDirectory;\n\n      return cachedPackageRootPath;\n    }\n\n    const parentDirectory = path.dirname(currentDirectory);\n\n    if (parentDirectory === currentDirectory) {\n      break;\n    }\n\n    currentDirectory = parentDirectory;\n  }\n\n  /**\n   * @description\n   * package.json 탐색이 실패해도 기존 설치 구조(dist/common -> package root)를 우선 fallback으로 사용합니다.\n   * 예상치 못한 배포 환경에서도 최대한 기존 동작을 유지하기 위한 보수적 안전장치입니다.\n   */\n  cachedPackageRootPath = path.resolve(startDirectory, '../..');\n\n  return cachedPackageRootPath;\n}\n\n/**\n * @description\n * gemini-cli 패키지 루트를 기준으로 정적 asset 파일의 절대 경로를 계산합니다.\n * 번들 과정에서 helper 코드가 다른 엔트리에 인라인되어도 항상 같은 실제 파일을 가리키게 합니다.\n * @param relativeFilePath 패키지 루트 기준 상대 경로\n * @returns asset 파일의 절대 경로\n */\nfunction resolvePackageAssetPath(relativeFilePath: string) {\n  return path.resolve(resolveGeminiCliPackageRoot(), relativeFilePath);\n}\n\nexport const rulesPath = resolvePackageAssetPath('src/common/rules/review-rules.md');\nexport const namingRulesPath = resolvePackageAssetPath('src/common/rules/naming-rule.md');\nexport const codingConventionRulesPath = resolvePackageAssetPath('src/common/rules/coding-convention.md');\nexport const reviewFormPath = resolvePackageAssetPath('src/common/form/review-form.md');\nexport const reviewFormOneByOnePath = resolvePackageAssetPath('src/common/form/review-form-one-by-one.md');\nexport const REPORT_DIR = '.review-report';\nexport const tempDiffPath = 'temp_diff.txt';\nexport const AIServices: AIServiceType[] = ['gemini', 'claude', 'codex'];\nexport const COMMIT_FETCH_LIMIT = 20;\nexport const COMMIT_SELECTION_WINDOW = 8;\nexport const ignoreList = [\n  'package.json',\n  '*.yml',\n  '*.md',\n  '*.lock',\n  'dist/',\n  'node_modules/',\n  'assets/',\n  'public/',\n  '*.json',\n  '*.yaml',\n  '.review-report/' // 생성되는 리포트 폴더도 제외\n];\n\nexport function isTestMode(args: string[] = process.argv.slice(2)) {\n  return args.includes('--test');\n}\n\n/**\n * @description\n * AI CLI의 중간 stdout/stderr를 실시간으로 터미널에 노출할지 여부를 판단합니다.\n * 기본 실행은 조용한 모드로 유지하고, 사용자가 명시적으로 플래그를 줄 때만\n * AI 응답을 그대로 스트리밍합니다.\n * @param args 현재 실행 인자 목록\n * @returns 실시간 AI 출력 노출 여부\n */\nexport function shouldStreamAIOutput(args: string[] = process.argv.slice(2)) {\n  return args.includes('--stream-output');\n}\n\nexport function clearTraceMessages() {\n  traceMessages.length = 0;\n}\n\nexport function getTraceMessages() {\n  return [...traceMessages];\n}\n\n/**\n * @description\n * 터미널 선택 UI에서 동일한 색상 토큰을 재사용할 수 있도록 ANSI escape code를 상수화합니다.\n * 서비스 선택과 커밋 선택이 같은 시각 언어를 사용하도록 helper 내부에서만 공유합니다.\n */\nconst ANSI = {\n  bold: '\\u001b[1m',\n  cyan: '\\u001b[36m',\n  dim: '\\u001b[2m',\n  green: '\\u001b[32m',\n  reset: '\\u001b[0m',\n  yellow: '\\u001b[33m'\n} as const;\nconst ANSI_PATTERN = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;]*m`, 'g');\nconst COMBINING_MARK_PATTERN = /\\p{Mark}/u;\nconst GRAPHEME_SEGMENTER =\n  typeof Intl !== 'undefined' && 'Segmenter' in Intl ? new Intl.Segmenter('ko', { granularity: 'grapheme' }) : null;\n\ntype VisibleToken = {\n  value: string;\n  visibleWidth: number;\n};\n\n/**\n * @description\n * 리뷰 대상 파일 필터를 pathspec 배열 형태로 정의합니다.\n * 문자열 커맨드와 argv 기반 git 실행이 모두 같은 기준을 공유하도록 원본 패턴은 배열로 유지합니다.\n */\nfunction getGitDiffPathspecs() {\n  return {\n    excludePatterns: ignoreList.map((item) => `:(exclude)${item}`),\n    includePatterns: ['*.ts', '*.tsx', '*.js', '*.jsx']\n  };\n}\n\nfunction segmentGraphemes(value: string) {\n  if (!GRAPHEME_SEGMENTER) {\n    return [...value];\n  }\n\n  return [...GRAPHEME_SEGMENTER.segment(value)].map(({ segment }) => segment);\n}\n\nfunction isWideCodePoint(codePoint: number) {\n  return (\n    codePoint >= 0x1100 &&\n    (codePoint <= 0x115f ||\n      codePoint === 0x2329 ||\n      codePoint === 0x232a ||\n      (codePoint >= 0x2e80 && codePoint <= 0x3247 && codePoint !== 0x303f) ||\n      (codePoint >= 0x3250 && codePoint <= 0x4dbf) ||\n      (codePoint >= 0x4e00 && codePoint <= 0xa4c6) ||\n      (codePoint >= 0xa960 && codePoint <= 0xa97c) ||\n      (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||\n      (codePoint >= 0xf900 && codePoint <= 0xfaff) ||\n      (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||\n      (codePoint >= 0xfe30 && codePoint <= 0xfe6b) ||\n      (codePoint >= 0xff01 && codePoint <= 0xff60) ||\n      (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||\n      (codePoint >= 0x1f200 && codePoint <= 0x1f251) ||\n      (codePoint >= 0x20000 && codePoint <= 0x3fffd))\n  );\n}\n\nfunction isEmojiCodePoint(codePoint: number) {\n  return (\n    (codePoint >= 0x1f1e6 && codePoint <= 0x1f1ff) ||\n    (codePoint >= 0x1f300 && codePoint <= 0x1faff) ||\n    (codePoint >= 0x2600 && codePoint <= 0x27bf)\n  );\n}\n\nfunction getGraphemeWidth(grapheme: string) {\n  let width = 0;\n\n  for (const character of grapheme) {\n    const codePoint = character.codePointAt(0);\n\n    if (!codePoint || COMBINING_MARK_PATTERN.test(character) || codePoint === 0x200d) {\n      continue;\n    }\n\n    if ((codePoint >= 0xfe00 && codePoint <= 0xfe0f) || (codePoint >= 0xe0100 && codePoint <= 0xe01ef)) {\n      continue;\n    }\n\n    if (isWideCodePoint(codePoint) || isEmojiCodePoint(codePoint)) {\n      width = Math.max(width, 2);\n\n      continue;\n    }\n\n    width = Math.max(width, 1);\n  }\n\n  return width;\n}\n\nfunction tokenizePlainText(value: string) {\n  return segmentGraphemes(value).map((segment) => ({\n    value: segment,\n    visibleWidth: getGraphemeWidth(segment)\n  }));\n}\n\nfunction tokenizeVisibleText(value: string) {\n  const tokens: VisibleToken[] = [];\n  let lastIndex = 0;\n\n  for (const match of value.matchAll(ANSI_PATTERN)) {\n    const index = match.index ?? 0;\n\n    if (index > lastIndex) {\n      tokens.push(...tokenizePlainText(value.slice(lastIndex, index)));\n    }\n\n    tokens.push({\n      value: match[0],\n      visibleWidth: 0\n    });\n    lastIndex = index + match[0].length;\n  }\n\n  if (lastIndex < value.length) {\n    tokens.push(...tokenizePlainText(value.slice(lastIndex)));\n  }\n\n  return tokens;\n}\n\n/**\n * @description\n * 모달 각 줄이 터미널 실제 폭을 넘지 않도록 ANSI 코드를 보존한 채 잘라냅니다.\n * 줄바꿈이 발생하면 렌더 줄 수 계산이 어긋나므로, 모든 선택 줄을 1 physical line로 강제합니다.\n * @param value 렌더할 문자열\n * @param maxWidth 허용 최대 표시 폭\n * @returns 터미널 폭 안으로 정리된 문자열\n */\nfunction truncateLineForTerminal(value: string, maxWidth: number) {\n  if (maxWidth <= 0) {\n    return '';\n  }\n\n  const tokens = tokenizeVisibleText(value);\n  const totalWidth = tokens.reduce((sum, token) => sum + token.visibleWidth, 0);\n\n  if (totalWidth <= maxWidth) {\n    return value;\n  }\n\n  const ellipsis = '...';\n  const ellipsisWidth = 3;\n  const targetWidth = Math.max(0, maxWidth - ellipsisWidth);\n  let usedWidth = 0;\n  let result = '';\n\n  for (const token of tokens) {\n    if (token.visibleWidth === 0) {\n      result += token.value;\n\n      continue;\n    }\n\n    if (usedWidth + token.visibleWidth > targetWidth) {\n      break;\n    }\n\n    result += token.value;\n    usedWidth += token.visibleWidth;\n  }\n\n  return `${result}${ellipsis}${ANSI.reset}`;\n}\n\nfunction fitLinesToTerminal(lines: string[]) {\n  const maxWidth = Math.max(20, (process.stdout.columns || 120) - 1);\n\n  return lines.map((line) => truncateLineForTerminal(line, maxWidth));\n}\n\n/**\n * @description\n * git 서브프로세스를 argv 배열 기반으로 실행합니다.\n * 커밋 해시나 파일 경로에 공백이 섞여도 shell quoting 문제 없이 동일한 동작을 보장하기 위해 공통 helper로 분리합니다.\n * @param args git 인자 배열\n * @param options 실패 허용 여부와 출력 trim 여부\n * @returns git 표준출력 문자열\n */\nfunction runGitCommand(args: string[], options: GitCommandOptions = {}) {\n  const { allowFailure = false, trimOutput = true } = options;\n\n  try {\n    const output = execFileSync('git', args, {\n      encoding: 'utf8',\n      maxBuffer: 1024 * 1024 * 20,\n      stdio: ['ignore', 'pipe', 'pipe']\n    });\n\n    return trimOutput ? output.trim() : output;\n  } catch (error) {\n    helperTrace('git-command:failed', `${args.join(' ')} | ${getErrorSummary(error)}`);\n\n    if (allowFailure) {\n      return '';\n    }\n\n    throw error;\n  }\n}\n\n/**\n * @description\n * 현재 환경에서 실제로 실행 가능한 POSIX shell을 고릅니다.\n * 리뷰 명령은 `||`, pipe, single quote escaping을 포함한 shell 문법을 사용하므로\n * bash/zsh가 있으면 login shell로 실행하고, 없으면 sh로 안전하게 폴백합니다.\n * @returns spawn 실행에 사용할 shell 경로와 prefix 인자\n */\nfunction resolveShellLaunchConfig(): ShellLaunchConfig {\n  const candidates: ShellLaunchConfig[] = [];\n  const seen = new Set<string>();\n\n  /**\n   * @description\n   * 중복 없이 shell 후보를 등록합니다.\n   * 절대 경로 후보는 실제 파일이 존재할 때만 추가해 ENOENT를 사전에 차단합니다.\n   * @param executable shell 실행 파일 경로 또는 명령어\n   * @param shellArgs shell 앞단 인자\n   */\n  const appendCandidate = (executable: string | undefined, shellArgs: string[]) => {\n    const normalizedExecutable = executable?.trim();\n\n    if (!normalizedExecutable) {\n      return;\n    }\n\n    if (path.isAbsolute(normalizedExecutable) && !fs.existsSync(normalizedExecutable)) {\n      return;\n    }\n\n    const key = `${normalizedExecutable}::${shellArgs.join('\\u0000')}`;\n\n    if (seen.has(key)) {\n      return;\n    }\n\n    seen.add(key);\n    candidates.push({\n      executable: normalizedExecutable,\n      shellArgs\n    });\n  };\n\n  const shellFromEnv = process.env.SHELL?.trim();\n  const envShellName = shellFromEnv ? path.basename(shellFromEnv) : '';\n\n  if (['bash', 'zsh', 'ksh'].includes(envShellName)) {\n    appendCandidate(shellFromEnv, ['-lc']);\n  }\n\n  ['/bin/bash', '/usr/bin/bash', 'bash', '/bin/zsh', '/usr/bin/zsh', 'zsh'].forEach((shellPath) => {\n    appendCandidate(shellPath, ['-lc']);\n  });\n  ['/bin/sh', '/usr/bin/sh', 'sh'].forEach((shellPath) => {\n    appendCandidate(shellPath, ['-c']);\n  });\n\n  return candidates[0] || { executable: 'sh', shellArgs: ['-c'] };\n}\n\n/**\n * @description\n * shell 명령을 비동기로 실행하면서 stdout/stderr를 그대로 흘려보내고, 장시간 작업에는 경과 시간을 주기적으로 출력합니다.\n * review 실행처럼 응답 생성까지 오래 걸리는 CLI를 버퍼링 없이 기다리게 해 사용자가 멈춤으로 오해하지 않도록 합니다.\n * @param command 실행할 shell command 문자열\n * @param options 진행 메시지와 출력 주기 옵션\n * @returns 최종 stdout/stderr 캡처 결과\n */\nexport async function executeShellCommandWithProgress(command: string, options: ShellCommandProgressOptions = {}) {\n  const { progressIntervalMs = 10000, progressMessage = '⏳ 명령을 실행하는 중입니다...', streamOutput = false } = options;\n  const { spawn } = await import('child_process');\n  const shellLaunchConfig = resolveShellLaunchConfig();\n\n  return new Promise<{ stderr: string; stdout: string }>((resolve, reject) => {\n    let stdout = '';\n    let stderr = '';\n    const startedAt = Date.now();\n    console.log(progressMessage);\n    helperTrace('shell-command:launcher', `${shellLaunchConfig.executable} ${shellLaunchConfig.shellArgs.join(' ')}`);\n\n    const child = spawn(shellLaunchConfig.executable, [...shellLaunchConfig.shellArgs, command], {\n      stdio: ['ignore', 'pipe', 'pipe']\n    });\n\n    const progressTimer = setInterval(() => {\n      const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1000));\n      console.log(`${progressMessage} (${elapsedSeconds}s 경과)`);\n    }, progressIntervalMs);\n\n    child.stdout.on('data', (chunk: Buffer | string) => {\n      const text = chunk.toString();\n      stdout += text;\n\n      if (streamOutput) {\n        process.stdout.write(text);\n      }\n    });\n\n    child.stderr.on('data', (chunk: Buffer | string) => {\n      const text = chunk.toString();\n      stderr += text;\n\n      if (streamOutput) {\n        process.stderr.write(text);\n      }\n    });\n\n    child.on('error', (error) => {\n      clearInterval(progressTimer);\n      reject(error);\n    });\n\n    child.on('close', (code, signal) => {\n      clearInterval(progressTimer);\n\n      if (code === 0) {\n        resolve({\n          stderr,\n          stdout\n        });\n\n        return;\n      }\n\n      const exitSummary = signal ? `signal=${signal}` : `code=${String(code ?? 'unknown')}`;\n      const failureDetails: ShellCommandFailureDetails = {\n        code,\n        command,\n        signal,\n        stderr,\n        stdout\n      };\n\n      reject(createShellCommandExecutionError(failureDetails, exitSummary));\n    });\n  });\n}\n\n/**\n * @description\n * shell 명령 실패 시 에러 메시지에 포함할 출력 미리보기를 생성합니다.\n * 일부 CLI는 실패 사유를 stderr가 아니라 stdout으로만 출력하므로, 두 채널을 함께 확인해야\n * 원인 파악이 가능합니다. 너무 긴 응답이 그대로 에러 제목에 붙지 않도록 마지막 일부만 잘라냅니다.\n * @param failureDetails 실패한 shell 명령의 실행 결과\n * @returns 에러 메시지에 붙일 출력 요약 문자열\n */\nfunction getShellCommandFailurePreview(failureDetails: ShellCommandFailureDetails) {\n  const stderrText = failureDetails.stderr.trim();\n  const stdoutText = failureDetails.stdout.trim();\n  const combinedOutput = stderrText || stdoutText;\n\n  if (!combinedOutput) {\n    return '';\n  }\n\n  const MAX_PREVIEW_LENGTH = 4000;\n\n  if (combinedOutput.length <= MAX_PREVIEW_LENGTH) {\n    return combinedOutput;\n  }\n\n  return combinedOutput.slice(-MAX_PREVIEW_LENGTH);\n}\n\n/**\n * @description\n * shell 명령 실패 정보를 Error 객체로 승격합니다.\n * 에러 리포트에서 실제 실패 원인을 확인할 수 있도록 stdout/stderr/command/exit code를\n * Error 인스턴스에 직접 부착합니다.\n * @param failureDetails 실패한 shell 명령의 실행 결과\n * @param exitSummary 종료 코드 또는 시그널 요약\n * @returns 실행 컨텍스트가 부착된 Error 객체\n */\nfunction createShellCommandExecutionError(failureDetails: ShellCommandFailureDetails, exitSummary: string) {\n  const failurePreview = getShellCommandFailurePreview(failureDetails);\n  const error = new Error(`쉘 명령 실행 실패 (${exitSummary})${failurePreview ? `\\n${failurePreview}` : ''}`) as Error &\n    Record<string, unknown>;\n\n  error.code = failureDetails.code;\n  error.signal = failureDetails.signal;\n  error.stdout = failureDetails.stdout;\n  error.stderr = failureDetails.stderr;\n  error.command = failureDetails.command;\n\n  return error;\n}\n\n/**\n * @description\n * 리뷰 대상 파일 목록을 한 줄 요약 문자열로 변환합니다.\n * 파일이 많을 때는 일부만 노출하고 나머지는 개수로 축약해 터미널 출력이 과도하게 길어지지 않도록 합니다.\n * @param files 리뷰 대상 파일 목록\n * @param visibleCount 터미널에 직접 보여줄 최대 파일 수\n * @returns 화면 표시용 요약 문자열\n */\nexport function formatReviewTargetFiles(files: string[], visibleCount = 5) {\n  if (files.length === 0) {\n    return '(없음)';\n  }\n\n  const visibleFiles = files.slice(0, visibleCount);\n  const hiddenCount = Math.max(0, files.length - visibleFiles.length);\n\n  if (hiddenCount === 0) {\n    return visibleFiles.join(', ');\n  }\n\n  return `${visibleFiles.join(', ')} 외 ${hiddenCount}개`;\n}\n\nexport function createTraceLogger(scope: string, args: string[] = process.argv.slice(2)) {\n  const enabled = isTestMode(args);\n\n  return (step: string, detail?: string) => {\n    const timestamp = new Date().toISOString();\n    const message = `[${timestamp}][TRACE][${scope}] ${step}${detail ? ` | ${detail}` : ''}`;\n    traceMessages.push(message);\n\n    if (!enabled) {\n      return;\n    }\n\n    console.log(message);\n  };\n}\n\nconst helperTrace = createTraceLogger('helper');\n\nfunction getTimestampParts(now = new Date()) {\n  return {\n    YYYY: now.getFullYear(),\n    MM: String(now.getMonth() + 1).padStart(2, '0'),\n    DD: String(now.getDate()).padStart(2, '0'),\n    HH: String(now.getHours()).padStart(2, '0'),\n    mm: String(now.getMinutes()).padStart(2, '0'),\n    ss: String(now.getSeconds()).padStart(2, '0')\n  };\n}\n\nfunction getHumanReadableNowString(now = new Date()) {\n  const { YYYY, MM, DD, HH, mm, ss } = getTimestampParts(now);\n\n  return `${YYYY}-${MM}-${DD} ${HH}:${mm}:${ss}`;\n}\n\nfunction stringifyUnknown(value: unknown) {\n  if (value === undefined || value === null) {\n    return '';\n  }\n\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  if (Buffer.isBuffer(value)) {\n    return value.toString();\n  }\n\n  if (value instanceof Error) {\n    return value.stack || value.message;\n  }\n\n  return inspect(value, { depth: 5, breakLength: 120 });\n}\n\nexport function getErrorSummary(error: unknown) {\n  if (error instanceof Error) {\n    return `${error.name}: ${error.message}`;\n  }\n\n  return stringifyUnknown(error) || 'Unknown error';\n}\n\nfunction serializeError(error: unknown) {\n  const serialized: Record<string, unknown> = {\n    summary: getErrorSummary(error)\n  };\n\n  if (error instanceof Error) {\n    serialized.name = error.name;\n    serialized.message = error.message;\n    serialized.stack = error.stack;\n  } else {\n    serialized.value = stringifyUnknown(error);\n  }\n\n  if (error && typeof error === 'object') {\n    const errorLike = error as Record<string, unknown>;\n    const extraKeys = ['code', 'errno', 'syscall', 'path', 'cmd', 'status', 'signal', 'spawnargs', 'command'];\n\n    extraKeys.forEach((key) => {\n      if (errorLike[key] !== undefined) {\n        serialized[key] = errorLike[key];\n      }\n    });\n\n    const stdout = stringifyUnknown(errorLike.stdout);\n    if (stdout) {\n      serialized.stdout = stdout;\n    }\n\n    const stderr = stringifyUnknown(errorLike.stderr);\n    if (stderr) {\n      serialized.stderr = stderr;\n    }\n\n    const cause = stringifyUnknown(errorLike.cause);\n    if (cause) {\n      serialized.cause = cause;\n    }\n  }\n\n  return serialized;\n}\n\nexport function getNextFilePath(dir: string, baseName: string, extension: string) {\n  let counter = 1;\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    const filePath = path.join(dir, `${baseName}-${counter}${extension}`);\n    if (!fs.existsSync(filePath)) {\n      return filePath;\n    }\n    counter++;\n  }\n}\n\nexport function getAvailableFilePath(dir: string, baseName: string, extension: string) {\n  const firstFilePath = path.join(dir, `${baseName}${extension}`);\n  if (!fs.existsSync(firstFilePath)) {\n    return firstFilePath;\n  }\n\n  return getNextFilePath(dir, baseName, extension);\n}\n\nexport function deleteFile(filePath: string) {\n  if (fs.existsSync(filePath)) {\n    fs.unlinkSync(filePath);\n  }\n}\n\n/**\n * 임시파일 삭제\n */\nexport function deleteTempDiff() {\n  deleteFile(tempDiffPath);\n}\n\n/**\n * 리뷰 결과 폴더 생성\n */\nexport function createReportDirectory() {\n  if (!fs.existsSync(REPORT_DIR)) {\n    fs.mkdirSync(REPORT_DIR, { recursive: true });\n  }\n}\n\n/**\n * 현재 시간 문자열 생성\n */\nexport function getNowString(now = new Date()) {\n  const { YYYY, MM, DD, HH, mm, ss } = getTimestampParts(now);\n\n  return `${YYYY}-${MM}-${DD}_${HH}-${mm}-${ss}`;\n}\n\nexport function getErrorLogTimestamp(now = new Date()) {\n  const { YYYY, MM, DD, HH, mm, ss } = getTimestampParts(now);\n\n  return `${YYYY}-${MM}-${DD}-${HH}시-${mm}분-${ss}초`;\n}\n\nexport function writeErrorReport(error: unknown, options: WriteErrorReportOptions = {}) {\n  try {\n    const now = new Date();\n    helperTrace('error-report:write:start', options.scope || 'unknown');\n    createReportDirectory();\n\n    const reportPath = getAvailableFilePath(REPORT_DIR, `error-log-${getErrorLogTimestamp(now)}`, '.md');\n    const serializedError = serializeError(error);\n    const traceSnapshot = options.traceMessages ?? getTraceMessages();\n    const extraSections = options.extraSections || [];\n\n    const report = `# Error Log\n\n- 발생 시각: ${getHumanReadableNowString(now)}\n- Scope: \\`${options.scope || 'unknown'}\\`\n- 작업 경로: \\`${process.cwd()}\\`\n- 실행 인자: \\`${JSON.stringify(options.args ?? process.argv.slice(2))}\\`\n- 실행 환경: \\`${process.platform} ${process.arch} / Node ${process.version}\\`\n\n## Summary\n\n${options.title || serializedError.summary || 'Unknown error'}\n\n## Error\n\n\\`\\`\\`json\n${JSON.stringify(serializedError, null, 2)}\n\\`\\`\\`\n\n## Trace\n\n\\`\\`\\`json\n${JSON.stringify(traceSnapshot, null, 2)}\n\\`\\`\\`${extraSections.length ? `\\n${extraSections.map((section) => `\\n## ${section.heading}\\n\\n${section.markdown}`).join('\\n')}\\n` : '\\n'}\n`;\n\n    fs.writeFileSync(reportPath, report);\n    helperTrace('error-report:write:done', reportPath);\n\n    return reportPath;\n  } catch (writeError) {\n    console.error('⚠️ 에러 로그 파일 생성에 실패했습니다.');\n    console.error(writeError);\n\n    return '';\n  }\n}\n\nfunction getExecutionLogSummary(status: ExecutionLogStatus, title?: string) {\n  if (title) {\n    return title;\n  }\n\n  switch (status) {\n    case 'success':\n      return '리뷰 실행이 성공적으로 완료되었습니다.';\n    case 'failed':\n      return '리뷰 실행 중 오류가 발생했습니다.';\n    case 'partial_failure':\n      return '리뷰 실행은 완료되었지만 일부 단계에서 오류가 발생했습니다.';\n    default:\n      return '리뷰 실행이 취소되었거나 리뷰 대상이 없어 종료되었습니다.';\n  }\n}\n\nfunction formatExecutionDuration(startedAt: Date, finishedAt: Date) {\n  const durationMs = Math.max(0, finishedAt.getTime() - startedAt.getTime());\n\n  if (durationMs < 1000) {\n    return `${durationMs}ms`;\n  }\n\n  const durationSeconds = durationMs / 1000;\n\n  if (durationSeconds < 60) {\n    return `${durationSeconds.toFixed(1)}s`;\n  }\n\n  const minutes = Math.floor(durationSeconds / 60);\n  const seconds = Math.round(durationSeconds % 60);\n\n  return `${minutes}m ${seconds}s`;\n}\n\n/**\n * @description\n * 성공/실패 여부와 무관하게 리뷰 실행 자체의 진단 로그를 `.review-report`에 남깁니다.\n * 에러 로그와 별도로 실행 맥락, 생성된 명령어, trace를 항상 보존하여 재현과 원인 분석에 활용합니다.\n * @param options 실행 상태, 시작/종료 시각, 에러, 추가 섹션 등 실행 로그 작성 옵션\n * @returns 생성된 실행 로그 파일 경로. 실패 시 빈 문자열\n */\nexport function writeExecutionLog(options: WriteExecutionLogOptions = {}) {\n  try {\n    const startedAt = options.startedAt ?? new Date();\n    const finishedAt = options.finishedAt ?? new Date();\n    const status = options.status ?? 'success';\n    helperTrace('execution-log:write:start', options.scope || 'unknown');\n    createReportDirectory();\n\n    const reportPath = getAvailableFilePath(REPORT_DIR, `${getNowString(finishedAt)}-execution-log`, '.md');\n    const traceSnapshot = options.traceMessages ?? getTraceMessages();\n    const extraSections = options.extraSections || [];\n    const serializedError = options.error ? serializeError(options.error) : null;\n\n    const report = `# Execution Log\n\n- 시작 시각: ${getHumanReadableNowString(startedAt)}\n- 종료 시각: ${getHumanReadableNowString(finishedAt)}\n- 실행 시간: ${formatExecutionDuration(startedAt, finishedAt)}\n- 상태: \\`${status}\\`\n- Scope: \\`${options.scope || 'unknown'}\\`\n- 작업 경로: \\`${process.cwd()}\\`\n- 실행 인자: \\`${JSON.stringify(options.args ?? process.argv.slice(2))}\\`\n- 실행 환경: \\`${process.platform} ${process.arch} / Node ${process.version}\\`\n\n## Summary\n\n${getExecutionLogSummary(status, options.title)}\n${serializedError ? `\\n\\n## Error\\n\\n\\`\\`\\`json\\n${JSON.stringify(serializedError, null, 2)}\\n\\`\\`\\`` : ''}\n\n## Trace\n\n\\`\\`\\`json\n${JSON.stringify(traceSnapshot, null, 2)}\n\\`\\`\\`${extraSections.length ? `\\n${extraSections.map((section) => `\\n## ${section.heading}\\n\\n${section.markdown}`).join('\\n')}\\n` : '\\n'}\n`;\n\n    fs.writeFileSync(reportPath, report);\n    helperTrace('execution-log:write:done', reportPath);\n\n    return reportPath;\n  } catch (writeError) {\n    console.error('⚠️ 실행 로그 파일 생성에 실패했습니다.');\n    console.error(writeError);\n\n    return '';\n  }\n}\n\nexport function exitWithError(\n  message: string,\n  options: Omit<WriteErrorReportOptions, 'title'> & { error?: unknown } = {}\n): never {\n  const reportPath = writeErrorReport(options.error || new Error(message), {\n    ...options,\n    title: message\n  });\n\n  console.error(message);\n\n  if (options.error) {\n    console.error(options.error);\n  }\n\n  if (reportPath) {\n    console.error(`📄 에러 로그 저장 위치: ${reportPath}`);\n  }\n\n  process.exit(1);\n}\n\nfunction parseServiceFromArgs(args: string[] = process.argv.slice(2)): AIServiceType | '' {\n  helperTrace('parse-service:start', `args=${JSON.stringify(args)}`);\n  const serviceIndex = args.indexOf('--service');\n  const rawService = serviceIndex !== -1 ? args[serviceIndex + 1] : '';\n\n  if (!rawService) {\n    helperTrace('parse-service:empty');\n\n    return '';\n  }\n\n  const normalizedService = rawService.toLowerCase();\n\n  if (AIServices.includes(normalizedService as AIServiceType)) {\n    helperTrace('parse-service:resolved', normalizedService);\n\n    return normalizedService as AIServiceType;\n  }\n\n  helperTrace('parse-service:invalid', rawService);\n  exitWithError(\n    `❌ 지원하지 않는 서비스입니다: ${rawService}. 사용 가능 값: ${AIServices.join(', ')} (예: --service codex)`,\n    {\n      scope: 'helper:parseServiceFromArgs',\n      args,\n      extraSections: [\n        {\n          heading: 'Allowed Services',\n          markdown: `\\`\\`\\`json\\n${JSON.stringify(AIServices, null, 2)}\\n\\`\\`\\``\n        }\n      ]\n    }\n  );\n}\n\nexport function getGitDiffFilter() {\n  const { includePatterns, excludePatterns } = getGitDiffPathspecs();\n  const quote = (pattern: string) => `\"${pattern}\"`;\n  const includeParams = includePatterns.map(quote).join(' ');\n  const excludeParams = excludePatterns.map(quote).join(' ');\n\n  return { includeParams, excludeParams };\n}\n\n/**\n * @description\n * 커밋 선택 목록에서 subject가 과하게 길어지는 것을 막기 위해 표시 길이를 제한합니다.\n * commit hash와 메타데이터는 별도 필드로 유지하므로 UI 가독성에 필요한 subject만 자릅니다.\n * @param subject 원본 커밋 제목\n * @returns 화면 표시용 제목\n */\nfunction truncateCommitSubject(subject: string) {\n  if (subject.length <= 72) {\n    return subject;\n  }\n\n  return `${subject.slice(0, 69)}...`;\n}\n\nfunction formatReviewTargetFileCount(fileCount: number) {\n  return fileCount === 0 ? '변경 없음' : `${fileCount}개 파일`;\n}\n\nfunction buildReviewTargetSectionTitle(target: CommitOption) {\n  return target.kind === 'commit' ? `${target.hash} ${target.subject}` : `${target.hash} | ${target.subject}`;\n}\n\nfunction buildReviewTargetSummaryLine(target: CommitOption) {\n  if (target.kind === 'commit') {\n    return `- ${target.hash} | ${target.subject} | ${target.author} | ${target.relativeDate}`;\n  }\n\n  return `- ${target.hash} | ${target.subject}`;\n}\n\nfunction buildReviewTargetDiffArgs(target: CommitOption, filePath?: string) {\n  const reviewPathspecArgs = getReviewPathspecArgs();\n\n  if (target.kind === 'commit') {\n    return filePath\n      ? ['show', '--stat', '--patch', '--format=', target.hash, '--', filePath]\n      : ['show', '--stat', '--patch', '--format=', target.hash, '--', ...reviewPathspecArgs];\n  }\n\n  const diffArgs = ['diff'];\n\n  if (target.kind === 'staged') {\n    diffArgs.push('--cached');\n  }\n\n  diffArgs.push('--stat', '--patch', '--');\n\n  return filePath ? [...diffArgs, filePath] : [...diffArgs, ...reviewPathspecArgs];\n}\n\nfunction buildReviewTargetFileArgs(target: CommitOption) {\n  const reviewPathspecArgs = getReviewPathspecArgs();\n\n  if (target.kind === 'commit') {\n    return ['show', '--pretty=format:', '--name-only', target.hash, '--', ...reviewPathspecArgs];\n  }\n\n  const diffArgs = ['diff'];\n\n  if (target.kind === 'staged') {\n    diffArgs.push('--cached');\n  }\n\n  return [...diffArgs, '--name-only', '--', ...reviewPathspecArgs];\n}\n\nfunction getReviewTargetFiles(target: CommitOption) {\n  const output = runGitCommand(buildReviewTargetFileArgs(target), {\n    allowFailure: true\n  });\n\n  return output\n    .split('\\n')\n    .map((line) => line.trim())\n    .filter(Boolean);\n}\n\nfunction createWorkingTreeReviewOption(kind: Extract<ReviewTargetKind, 'staged' | 'unstaged'>): CommitOption {\n  const files = getReviewTargetFiles({\n    author: '',\n    description: '',\n    hash: kind,\n    kind,\n    label: kind,\n    relativeDate: '',\n    subject: ''\n  });\n  const subject = kind === 'unstaged' ? '아직 git add 하지 않은 변경사항' : 'git add 된 변경사항';\n\n  return {\n    author: '',\n    description: `${subject} | ${formatReviewTargetFileCount(files.length)}`,\n    hash: kind,\n    kind,\n    label: kind,\n    relativeDate: '',\n    subject\n  };\n}\n\n/**\n * @description\n * 최근 커밋 목록을 리뷰 선택 UI에서 바로 사용할 수 있는 구조로 변환합니다.\n * git log 포맷을 한 곳에서 관리해 main review와 one-by-one review가 같은 커밋 메타데이터를 공유하게 합니다.\n * @returns 최근 커밋 옵션 목록\n */\nexport function getRecentCommitOptions(): CommitOption[] {\n  const output = runGitCommand(\n    ['log', `-${COMMIT_FETCH_LIMIT}`, '--date=relative', '--pretty=format:%h%x09%an%x09%ar%x09%s'],\n    { allowFailure: true }\n  );\n\n  if (!output) {\n    return [];\n  }\n\n  return output.split('\\n').map((line) => {\n    const [hash = '', author = '', relativeDate = '', ...subjectParts] = line.split('\\t');\n    const subject = subjectParts.join('\\t').trim();\n\n    return {\n      author,\n      description: `${author} | ${relativeDate}`,\n      hash,\n      kind: 'commit',\n      label: `${hash} | ${truncateCommitSubject(subject)}`,\n      relativeDate,\n      subject\n    };\n  });\n}\n\nfunction getReviewTargetOptions() {\n  return [createWorkingTreeReviewOption('unstaged'), createWorkingTreeReviewOption('staged'), ...getRecentCommitOptions()];\n}\n\n/**\n * @description\n * 선택된 커밋 목록을 리포트 및 diff 헤더에 재사용할 수 있는 markdown bullet 문자열로 정리합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @returns 커밋 요약 markdown\n */\nexport function buildSelectedCommitSummary(commits: CommitOption[]) {\n  return commits.map((commit) => buildReviewTargetSummaryLine(commit)).join('\\n');\n}\n\n/**\n * @description\n * 리뷰 대상 pathspec 배열을 git argv에 바로 붙일 수 있게 평탄화합니다.\n * 문자열 커맨드와 다른 경로 기반 helper도 같은 필터를 공유하도록 helper 함수로 분리합니다.\n * @returns include/exclude pathspec 배열\n */\nfunction getReviewPathspecArgs() {\n  const { includePatterns, excludePatterns } = getGitDiffPathspecs();\n\n  return [...includePatterns, ...excludePatterns];\n}\n\n/**\n * @description\n * 선택된 여러 커밋의 전체 diff를 한 파일에 합칩니다.\n * 각 커밋을 별도 섹션으로 감싸 AI가 커밋 경계를 잃지 않도록 하며, 기존 리뷰 대상 확장자 필터도 그대로 적용합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @returns 리뷰용 통합 diff 텍스트\n */\nexport function buildSelectedCommitDiff(commits: CommitOption[]) {\n  const sections = commits\n    .map((commit) => {\n      const diff = runGitCommand(buildReviewTargetDiffArgs(commit), {\n        allowFailure: true,\n        trimOutput: false\n      }).trim();\n\n      if (!diff) {\n        return '';\n      }\n\n      return [`## ${buildReviewTargetSectionTitle(commit)}`, diff].join('\\n\\n');\n    })\n    .filter(Boolean)\n    .join('\\n\\n');\n\n  if (!sections) {\n    return '';\n  }\n\n  return ['# 선택한 리뷰 대상', buildSelectedCommitSummary(commits), '', '# 리뷰 대상 diff', sections].join('\\n');\n}\n\n/**\n * @description\n * 선택된 커밋에서 실제 리뷰 대상 파일 목록만 추출합니다.\n * one-by-one 리뷰가 현재 선택된 커밋 집합에만 반응하도록 commit별 name-only 결과를 합집합으로 계산합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @returns 중복 제거된 파일 목록\n */\nexport function getSelectedCommitFiles(commits: CommitOption[]) {\n  const files = new Set<string>();\n\n  commits.forEach((commit) => {\n    getReviewTargetFiles(commit).forEach((filePath) => files.add(filePath));\n  });\n\n  return [...files];\n}\n\n/**\n * @description\n * 특정 파일에 대한 선택 커밋들의 diff만 모아서 one-by-one 리뷰 입력으로 만듭니다.\n * 동일 파일이 여러 커밋에서 바뀐 경우 commit section을 나눠 보여줘 파일 리뷰 응답이 어느 변경을 다루는지 추적 가능하게 합니다.\n * @param commits 사용자가 고른 커밋 목록\n * @param filePath 리뷰할 파일 경로\n * @returns 단일 파일 리뷰용 diff 텍스트\n */\nexport function buildSelectedFileDiff(commits: CommitOption[], filePath: string) {\n  const sections = commits\n    .map((commit) => {\n      const diff = runGitCommand(buildReviewTargetDiffArgs(commit, filePath), {\n        allowFailure: true,\n        trimOutput: false\n      }).trim();\n\n      if (!diff) {\n        return '';\n      }\n\n      return [`## ${buildReviewTargetSectionTitle(commit)}`, diff].join('\\n\\n');\n    })\n    .filter(Boolean)\n    .join('\\n\\n');\n\n  if (!sections) {\n    return '';\n  }\n\n  return ['# 선택한 리뷰 대상', buildSelectedCommitSummary(commits), '', `# 파일: ${filePath}`, sections].join('\\n\\n');\n}\n\n/**\n * openReport를 OS별로 동작하도록 변경\n * 우선순위:\n * 1. Chrome 시도\n *    - macOS: open -a \"Google Chrome\" \"<path>\"\n *    - Ubuntu/Linux: google-chrome \"<path>\"\n * 2. 실패 시 기본 브라우저로 폴백\n *    - macOS: open \"<path>\"\n *    - Ubuntu/Linux: xdg-open \"<path>\"\n * 3. 둘 다 실패하면 에러 출력\n * 4. 미지원 플랫폼이면 플랫폼 경고 출력\n */\nexport function openReport(reportPath: string) {\n  const resolvedPath = path.resolve(reportPath);\n  const { platform } = process;\n  helperTrace('open-report:start', resolvedPath);\n\n  const openWithChrome = () => {\n    if (platform === 'darwin') {\n      execSync(`open -a \"Google Chrome\" \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    if (platform === 'linux') {\n      execSync(`google-chrome \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    return false;\n  };\n\n  const openWithDefaultBrowser = () => {\n    if (platform === 'darwin') {\n      execSync(`open \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    if (platform === 'linux') {\n      execSync(`xdg-open \"${resolvedPath}\"`, { stdio: 'ignore' });\n\n      return true;\n    }\n\n    return false;\n  };\n\n  try {\n    if (openWithChrome()) {\n      helperTrace('open-report:chrome:success', platform);\n      console.log('🚀 Google Chrome에서 리포트를 열었습니다.');\n\n      return;\n    }\n  } catch (error) {\n    helperTrace('open-report:chrome:failed', getErrorSummary(error));\n    // Chrome 실행 실패 시 기본 브라우저로 폴백\n  }\n\n  try {\n    if (openWithDefaultBrowser()) {\n      helperTrace('open-report:default-browser:success', platform);\n      console.log('🚀 기본 브라우저에서 리포트를 열었습니다.');\n\n      return;\n    }\n  } catch (error) {\n    helperTrace('open-report:default-browser:failed', getErrorSummary(error));\n    console.error('⚠️ 브라우저 열기 실패:', error);\n\n    return;\n  }\n\n  helperTrace('open-report:unsupported-platform', platform);\n  console.error(`⚠️ 지원하지 않는 플랫폼입니다: ${platform}`);\n}\n\n/**\n * @description\n * raw mode 기반 선택 UI를 안전하게 열 수 있는 TTY 환경인지 검증합니다.\n * CI나 pipe 환경에서는 커서를 제어할 수 없으므로 즉시 에러 리포트를 남기고 종료합니다.\n * @param scope 에러 리포트 구분용 scope\n * @param message 사용자에게 보여줄 에러 메시지\n */\nfunction ensureInteractiveSelectionAvailable(scope: string, message: string) {\n  if (process.stdin.isTTY && process.stdout.isTTY && typeof process.stdin.setRawMode === 'function') {\n    return;\n  }\n\n  helperTrace(`${scope}:tty-missing`);\n  exitWithError(message, {\n    scope: `helper:${scope}`\n  });\n}\n\n/**\n * @description\n * 선택 모달을 현재 위치에서 다시 그립니다.\n * 각 줄은 미리 터미널 폭 안으로 잘라 physical line이 1줄로 유지되므로,\n * 직전 렌더 줄 수만큼 위로 이동한 뒤 clearScreenDown 해도 중복 없이 안정적으로 갱신됩니다.\n * @param lines 새로 렌더할 문자열 줄 목록\n * @param previousLineCount 직전 렌더 줄 수\n * @returns 현재 렌더 줄 수\n */\nfunction renderSelectionBlock(lines: string[], previousLineCount: number) {\n  if (previousLineCount > 0) {\n    readline.moveCursor(process.stdout, 0, -previousLineCount);\n    readline.clearScreenDown(process.stdout);\n  }\n\n  const fittedLines = fitLinesToTerminal(lines);\n  process.stdout.write(`${fittedLines.join('\\n')}\\n`);\n\n  return fittedLines.length;\n}\n\n/**\n * @description\n * 현재 커서 기준 visible window를 계산해 긴 커밋 목록도 고정 높이로 탐색할 수 있게 만듭니다.\n * @param optionCount 전체 옵션 개수\n * @param selectedIndex 현재 포커스 인덱스\n * @param windowSize 동시에 보여줄 최대 옵션 개수\n * @returns 시작/끝 인덱스\n */\nfunction getSelectionWindowRange(optionCount: number, selectedIndex: number, windowSize: number) {\n  if (optionCount <= windowSize) {\n    return {\n      end: optionCount,\n      start: 0\n    };\n  }\n\n  const halfWindow = Math.floor(windowSize / 2);\n  const maxStart = optionCount - windowSize;\n  const start = Math.max(0, Math.min(selectedIndex - halfWindow, maxStart));\n\n  return {\n    end: Math.min(optionCount, start + windowSize),\n    start\n  };\n}\n\n/**\n * @description\n * 공통 multi-select UI 렌더링에 필요한 문자열 목록을 구성합니다.\n * 설명 텍스트는 dim 처리해 subject와 author/date가 한 줄에서 구분되도록 합니다.\n * @param question 질문 헤더\n * @param options 표시할 옵션 목록\n * @param selectedIndex 현재 포커스 인덱스\n * @param toggled 선택된 인덱스 Set\n * @param windowSize 동시에 보여줄 최대 옵션 개수\n * @returns 출력 줄 목록\n */\nfunction buildMultiSelectLines<T>(\n  question: string,\n  options: MultiSelectOption<T>[],\n  selectedIndex: number,\n  toggled: Set<number>,\n  windowSize: number\n) {\n  const { start, end } = getSelectionWindowRange(options.length, selectedIndex, windowSize);\n  const lines = [\n    `${ANSI.bold}${question}${ANSI.reset}`,\n    `${ANSI.dim}↑↓ 이동 | Space 선택/해제 | Enter 완료 | Esc 취소${ANSI.reset}`,\n    `${ANSI.dim}선택됨: ${toggled.size}개 / 전체: ${options.length}개${ANSI.reset}`\n  ];\n\n  for (let index = start; index < end; index += 1) {\n    const option = options[index];\n\n    if (!option) {\n      continue;\n    }\n\n    const cursor = index === selectedIndex ? `${ANSI.cyan}>${ANSI.reset}` : ' ';\n    const checked = toggled.has(index) ? `${ANSI.green}☑${ANSI.reset}` : '☐';\n    const description = option.description ? ` ${ANSI.dim}${option.description}${ANSI.reset}` : '';\n    lines.push(`${cursor} ${checked} ${option.label}${description}`);\n  }\n\n  if (options.length > windowSize) {\n    lines.push(`${ANSI.dim}표시 범위: ${start + 1}-${end} / ${options.length}${ANSI.reset}`);\n  }\n\n  return lines;\n}\n\n/**\n * @description\n * 커밋 선택처럼 복수 선택이 필요한 터미널 모달을 공통으로 처리합니다.\n * raw mode를 직접 제어해 방향키, Space, Enter, Esc를 읽고 선택된 value 목록만 반환합니다.\n * @param question 사용자 안내 문구\n * @param options 선택 옵션 목록\n * @param windowSize 동시에 보여줄 최대 옵션 개수\n * @returns 사용자가 확정한 선택 값 배열\n */\nexport async function showMultiSelect<T>(question: string, options: MultiSelectOption<T>[], windowSize = COMMIT_SELECTION_WINDOW) {\n  ensureInteractiveSelectionAvailable('showMultiSelect', '❌ 커밋 선택 모달은 TTY 환경에서만 사용할 수 있습니다.');\n  let selectedIndex = 0;\n  let renderedLineCount = 0;\n  const toggled = new Set<number>();\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    terminal: true\n  });\n\n  process.stdout.write('\\u001b[?25l');\n\n  const cleanup = () => {\n    if (renderedLineCount > 0) {\n      readline.moveCursor(process.stdout, 0, -renderedLineCount);\n      readline.clearScreenDown(process.stdout);\n      renderedLineCount = 0;\n    }\n    process.stdin.removeListener('data', onData);\n    process.stdin.setRawMode(false);\n    process.stdin.pause();\n    rl.close();\n    process.stdout.write('\\u001b[?25h');\n  };\n\n  const render = () => {\n    const lines = buildMultiSelectLines(question, options, selectedIndex, toggled, windowSize);\n    renderedLineCount = renderSelectionBlock(lines, renderedLineCount);\n  };\n\n  const confirmSelection = (resolve: (value: T[]) => void) => {\n    const values = [...toggled]\n      .sort((left, right) => left - right)\n      .map((index) => options[index]?.value)\n      .filter((value): value is T => value !== undefined);\n\n    cleanup();\n    resolve(values);\n  };\n\n  const cancelSelection = (resolve: (value: T[]) => void) => {\n    cleanup();\n    resolve([]);\n  };\n\n  let onData = (_data: Buffer) => {\n    // 실제 구현은 Promise 생성 시점에 바인딩합니다.\n  };\n\n  render();\n\n  return new Promise<T[]>((resolve) => {\n    onData = (data: Buffer) => {\n      const key = data.toString();\n\n      if (key === '\\u0003') {\n        cleanup();\n        process.exit(0);\n      }\n\n      if (key === '\\u001b') {\n        cancelSelection(resolve);\n\n        return;\n      }\n\n      if (key === '\\x1b[A') {\n        selectedIndex = (selectedIndex - 1 + options.length) % options.length;\n        render();\n\n        return;\n      }\n\n      if (key === '\\x1b[B') {\n        selectedIndex = (selectedIndex + 1) % options.length;\n        render();\n\n        return;\n      }\n\n      if (key === ' ') {\n        if (toggled.has(selectedIndex)) {\n          toggled.delete(selectedIndex);\n        } else {\n          toggled.add(selectedIndex);\n        }\n        render();\n\n        return;\n      }\n\n      if (key === '\\r' || key === '\\n') {\n        confirmSelection(resolve);\n      }\n    };\n\n    process.stdin.setRawMode(true);\n    process.stdin.resume();\n    process.stdin.on('data', onData);\n  });\n}\n\n/**\n * @description\n * 최근 커밋 목록을 modal UI로 선택받아 review 엔트리포인트에서 바로 재사용할 수 있게 반환합니다.\n * @returns 사용자가 고른 커밋 목록\n */\nexport async function selectReviewCommits() {\n  const commits = getReviewTargetOptions();\n\n  if (commits.length === 0) {\n    console.log('ℹ️ 리뷰할 대상이 없습니다.');\n\n    return [];\n  }\n\n  return showMultiSelect<CommitOption>(\n    '리뷰할 대상을 선택해주세요.',\n    commits.map((commit) => ({\n      description: commit.description,\n      label: commit.label,\n      value: commit\n    })),\n    COMMIT_SELECTION_WINDOW\n  );\n}\n\n/**\n * AI 서비스 선택\n */\nexport function selectAIService() {\n  const service = parseServiceFromArgs();\n\n  if (!service) {\n    helperTrace('select-service:missing');\n    exitWithError('❌ 서비스가 선택되지 않았습니다.', {\n      scope: 'helper:selectAIService'\n    });\n  }\n\n  helperTrace('select-service:done', service);\n\n  return service;\n}\n\n/**\n * 터미널에서 라디오 버튼 형태로 AI 서비스를 선택합니다.\n */\nexport async function showSelectionAIService(): Promise<AIServiceType> {\n  const selectedServiceFromArgs = parseServiceFromArgs();\n\n  if (selectedServiceFromArgs) {\n    helperTrace('show-selection:from-args', selectedServiceFromArgs);\n    console.log(`\\n✅ ${ANSI.green}${selectedServiceFromArgs}${ANSI.reset} 서비스가 선택되었습니다. (--service)\\n`);\n\n    return selectedServiceFromArgs;\n  }\n\n  ensureInteractiveSelectionAvailable('showSelectionAIService', '❌ AI 서비스 선택 UI는 TTY 환경에서만 사용할 수 있습니다.');\n  helperTrace('show-selection:interactive:start');\n  let selectedIndex = 0;\n\n  // Use readline to handle keypresses\n  // 키 입력을 처리하기 위해 readline 인터페이스 사용\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    terminal: true\n  });\n\n  let firstRender = true;\n\n  // Hide cursor\n  process.stdout.write('\\u001b[?25l');\n\n  const render = () => {\n    if (!firstRender) {\n      // Move cursor back to the starting line of the selection UI\n      // We print (1 question line + services.length lines)\n      // 선택 UI의 시작 라인으로 커서 이동 (질문 1줄 + 서비스 목록 N줄)\n      readline.moveCursor(process.stdout, 0, -(AIServices.length + 1));\n    }\n    firstRender = false;\n    helperTrace('show-selection:interactive:render', AIServices[selectedIndex] || 'unknown');\n\n    // Clear everything from cursor down to avoid ghosting/overlaps\n    // 잔상이나 겹침을 방지하기 위해 커서 위치부터 아래쪽 모두 지움\n    readline.clearScreenDown(process.stdout);\n\n    process.stdout.write(\n      `🤖 AI 서비스를 선택해주세요 (${ANSI.yellow}↑↓ 방향키${ANSI.reset} 이동, ${ANSI.yellow}Enter${ANSI.reset} 선택):\\n`\n    );\n    AIServices.forEach((service, index) => {\n      if (index === selectedIndex) {\n        process.stdout.write(` ${ANSI.cyan}>${ANSI.reset} ${ANSI.cyan}◉${ANSI.reset} ${ANSI.bold}${service}${ANSI.reset}\\n`);\n      } else {\n        process.stdout.write(`   ◯ ${service}\\n`);\n      }\n    });\n  };\n\n  render();\n\n  return new Promise((resolve) => {\n    const onData = (data: Buffer) => {\n      const key = data.toString();\n      if (key === '\\u0003') {\n        // Ctrl+C\n        helperTrace('show-selection:interactive:ctrl-c');\n        process.stdout.write('\\u001b[?25h'); // Show cursor\n        process.exit(0);\n      }\n      if (key === '\\x1b[A') {\n        // Up arrow\n        selectedIndex = (selectedIndex - 1 + AIServices.length) % AIServices.length;\n        render();\n      } else if (key === '\\x1b[B') {\n        // Down arrow\n        selectedIndex = (selectedIndex + 1) % AIServices.length;\n        render();\n      } else if (key === '\\r' || key === '\\n') {\n        // Enter\n        process.stdin.removeListener('data', onData);\n        process.stdin.setRawMode(false);\n        process.stdin.pause();\n        rl.close();\n\n        // Show cursor\n        process.stdout.write('\\u001b[?25h');\n\n        console.log(`\\n✅ ${ANSI.green}${AIServices[selectedIndex]}${ANSI.reset} 서비스가 선택되었습니다.\\n`);\n        const result = AIServices[selectedIndex];\n        if (result) {\n          helperTrace('show-selection:interactive:confirmed', result);\n          resolve(result);\n        }\n      }\n    };\n\n    process.stdin.setRawMode(true);\n    process.stdin.resume();\n    process.stdin.on('data', onData);\n  });\n}\n","import fs from 'fs';\n\nimport { codingConventionRulesPath, createTraceLogger, namingRulesPath, rulesPath } from '../../common/helper';\n\nconst args = process.argv.slice(2);\nconst trace = createTraceLogger('claude-commander', args);\nconst ALLOWED_REASONING_EFFORTS = ['minimal', 'low', 'medium', 'high'] as const;\n\ntype ReasoningEffort = (typeof ALLOWED_REASONING_EFFORTS)[number];\ntype ClaudeEffort = 'low' | 'medium' | 'high';\n\nfunction shellQuote(value: string) {\n  return `'${value.replace(/'/g, `'\\\\''`)}'`;\n}\n\n/**\n * @description\n * shell 옵션 값이 단순 토큰이면 따옴표 없이 그대로 사용하고,\n * 공백이나 shell 특수문자가 섞이면 안전하게 single quote로 감쌉니다.\n * Claude 모델명과 effort 값은 보통 단순 토큰이므로, 복붙 과정에서\n * 스마트 쿼트로 변형되어 발생하는 재현 오류를 줄이기 위해 분기합니다.\n * @param value shell 옵션에 전달할 값\n * @returns shell command에 삽입 가능한 안전한 토큰 문자열\n */\nfunction toShellOptionToken(value: string) {\n  const SIMPLE_SHELL_TOKEN_PATTERN = /^[A-Za-z0-9._:/=-]+$/;\n\n  if (SIMPLE_SHELL_TOKEN_PATTERN.test(value)) {\n    return value;\n  }\n\n  return shellQuote(value);\n}\n\nfunction getArgValue(flag: string) {\n  const index = args.indexOf(flag);\n\n  if (index === -1 || !args[index + 1]) {\n    return '';\n  }\n\n  return args[index + 1];\n}\n\nfunction printNotice(message: string) {\n  if (args.includes('--test')) {\n    console.warn(message);\n  }\n}\n\nfunction toUnique(values: string[]) {\n  const seen = new Set<string>();\n\n  return values.filter((value) => {\n    if (!value || seen.has(value)) {\n      return false;\n    }\n    seen.add(value);\n\n    return true;\n  });\n}\n\nfunction normalizeEffort(level: ReasoningEffort): ClaudeEffort {\n  if (level === 'minimal') {\n    return 'low';\n  }\n\n  return level;\n}\n\nfunction resolveReasoningEffort(): ClaudeEffort {\n  const customReasoningEffort = getArgValue('--reasoning-effort') || getArgValue('--effort');\n\n  if (customReasoningEffort) {\n    if (ALLOWED_REASONING_EFFORTS.includes(customReasoningEffort as ReasoningEffort)) {\n      const normalized = normalizeEffort(customReasoningEffort as ReasoningEffort);\n      trace('reasoning:custom', `${customReasoningEffort} -> ${normalized}`);\n\n      if (customReasoningEffort === 'minimal') {\n        printNotice('⚠️ Claude는 minimal을 직접 지원하지 않아 low로 매핑합니다.');\n      }\n\n      return normalized;\n    }\n\n    printNotice(\n      `⚠️ 지원되지 않는 reasoning effort(${customReasoningEffort})입니다. allowed: ${ALLOWED_REASONING_EFFORTS.join(\n        ', '\n      )}`\n    );\n  }\n\n  if (args.includes('--flash')) {\n    trace('reasoning:flash-default', 'low');\n\n    return 'low';\n  }\n\n  if (args.includes('--review')) {\n    trace('reasoning:review-default', 'high');\n\n    return 'high';\n  }\n\n  trace('reasoning:default', 'medium');\n\n  return 'medium';\n}\n\nfunction resolvePrimaryAlias() {\n  if (args.includes('--review')) {\n    trace('model:mode-alias', 'opus');\n\n    return 'opus';\n  }\n\n  if (args.includes('--flash')) {\n    trace('model:mode-alias', 'haiku');\n\n    return 'haiku';\n  }\n\n  trace('model:default-alias', 'sonnet');\n\n  return 'sonnet';\n}\n\nfunction getAliasFallbacks(primaryAlias: string) {\n  if (primaryAlias === 'opus') {\n    return ['opus', 'sonnet', 'haiku'];\n  }\n\n  if (primaryAlias === 'haiku') {\n    return ['haiku', 'sonnet'];\n  }\n\n  return [primaryAlias, 'sonnet', 'haiku'];\n}\n\nfunction buildClaudeExecCommand(options: {\n  tempDiffPath: string;\n  prompt: string;\n  systemPromptFiles: string[];\n  effort: ClaudeEffort;\n  model?: string;\n  fallbackModel?: string;\n}) {\n  const { tempDiffPath, prompt, systemPromptFiles, effort, model, fallbackModel } = options;\n  const modelOption = model ? `--model ${toShellOptionToken(model)}` : '';\n  const fallbackOption = model && fallbackModel ? `--fallback-model ${toShellOptionToken(fallbackModel)}` : '';\n  const effortOption = `--effort ${toShellOptionToken(effort)}`;\n\n  const appendedPromptFiles = systemPromptFiles\n    .map((path) => `--append-system-prompt-file ${shellQuote(path)}`)\n    .join(' ');\n\n  return `cat ${shellQuote(tempDiffPath)} | claude ${[\n    modelOption,\n    fallbackOption,\n    effortOption,\n    appendedPromptFiles,\n    '-p',\n    shellQuote(prompt)\n  ]\n    .filter(Boolean)\n    .join(' ')}`;\n}\n\n/**\n * @description\n * Claude Code CLI를 활용한 코드 리뷰 명령어를 생성합니다.\n *\n * 모델 전략:\n * 1) --model 커스텀 모델 우선 시도\n * 2) 서비스 alias 순차 폴백 (opus/sonnet/haiku 조합)\n * 3) 마지막에 --model 없이 계정/CLI 기본 모델로 폴백\n *\n * reasoning 전략:\n * - --effort(low|medium|high)를 사용\n * - --reasoning-effort(minimal|low|medium|high) 입력 시 Claude 호환 값으로 매핑\n */\nexport const createClaudeCommand = (tempDiffPath: string, reviewFormPath: string) => {\n  trace('createClaudeCommand:start', `tempDiffPath=${tempDiffPath}, reviewFormPath=${reviewFormPath}`);\n  const customModel = getArgValue('--model');\n  const effort = resolveReasoningEffort();\n  const primaryAlias = resolvePrimaryAlias();\n  const aliasFallbacks = toUnique(getAliasFallbacks(primaryAlias));\n\n  // 룰셋 파일들을 --append-system-prompt-file 로 시스템 프롬프트에 추가\n  // Claude가 \"지침/규칙\"으로 인식하도록 시스템 프롬프트 레벨에 주입\n  const rules = [\n    { path: rulesPath, display: '룰셋' },\n    { path: namingRulesPath, display: '네이밍 규칙' },\n    { path: codingConventionRulesPath, display: '코딩 컨벤션' }\n  ];\n  const existingRuleFiles = rules.filter((rule) => fs.existsSync(rule.path)).map((rule) => rule.path);\n\n  trace('rules:loaded', `count=${existingRuleFiles.length}`);\n\n  // 리뷰 양식도 시스템 프롬프트에 추가 (출력 포맷 지침)\n  const reviewFormExists = fs.existsSync(reviewFormPath);\n  trace('reviewForm:status', reviewFormExists ? 'exists' : 'missing');\n  const systemPromptFiles = reviewFormExists ? [...existingRuleFiles, reviewFormPath] : existingRuleFiles;\n\n  const prompt = '위 규칙들을 참고하여 이 diff를 코드리뷰해줘. 리뷰양식에 맞춰서 작성해줘.';\n  trace('prompt:prepared', `length=${prompt.length}`);\n  trace('system-prompt-files', `count=${systemPromptFiles.length}`);\n  const modelCandidates = toUnique(customModel ? [customModel, ...aliasFallbacks] : aliasFallbacks);\n  trace('model:candidates', modelCandidates.join(', '));\n  trace('command:candidates:count', String(modelCandidates.length + 1));\n\n  if (customModel) {\n    printNotice(\n      `⚠️ 커스텀 모델(${customModel})을 우선 시도하고 실패하면 alias(${aliasFallbacks.join(\n        ' -> '\n      )}) 및 기본 모델 순으로 폴백합니다.`\n    );\n  } else {\n    printNotice(\n      `⚠️ 모델이 지정되지 않았습니다. alias(${aliasFallbacks.join(' -> ')})를 순차 시도하고 마지막에 기본 모델로 폴백합니다.`\n    );\n  }\n\n  const commandCandidates = modelCandidates.map((model, index) => {\n    const fallbackModel = modelCandidates[index + 1];\n\n    return buildClaudeExecCommand({\n      tempDiffPath,\n      prompt,\n      systemPromptFiles,\n      effort,\n      model,\n      fallbackModel\n    });\n  });\n\n  const command = [\n    ...commandCandidates,\n    buildClaudeExecCommand({\n      tempDiffPath,\n      prompt,\n      systemPromptFiles,\n      effort\n    })\n  ].join(' || ');\n\n  trace('command:created');\n\n  // test mode\n  if (args.includes('--test')) {\n    const safeCommand = command.replace(/\"/g, '\\\\\"');\n    trace('test-mode:return-preview');\n\n    return `echo \"[TEST MODE] Claude 명령어가 실행되지 않았습니다.\\n\\n생성될 명령어 미리보기:\\n${safeCommand}\"`;\n  }\n\n  trace('command:mode', 'execute');\n  trace('createClaudeCommand:end');\n\n  return command;\n};\n"]}