sales-frontend-gemini-cli 0.4.2 → 0.4.4

package/dist/pr-review/review.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 'use strict';
 
-var child_process = require('child_process');
 var fs = require('fs');
+var child_process = require('child_process');
 var path = require('path');
 var readline = require('readline');
 var url = require('url');
@@ -17,14 +17,52 @@ var readline__default = /*#__PURE__*/_interopDefault(readline);
 
 var __dirname$1 = path__default.default.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('review.cjs', document.baseURI).href))));
 var traceMessages = [];
-var rulesPath = path__default.default.resolve(__dirname$1, "../../src/common/rules/review-rules.md");
-var namingRulesPath = path__default.default.resolve(__dirname$1, "../../src/common/rules/naming-rule.md");
-var codingConventionRulesPath = path__default.default.resolve(__dirname$1, "../../src/common/rules/coding-convention.md");
-var reviewFormPath = path__default.default.resolve(__dirname$1, "../../src/common/form/review-form.md");
-path__default.default.resolve(__dirname$1, "../../src/common/form/review-form-one-by-one.md");
+var GEMINI_CLI_PACKAGE_NAME = "sales-frontend-gemini-cli";
+var cachedPackageRootPath = "";
+function isGeminiCliPackageRoot(directory) {
+  const packageJsonPath = path__default.default.join(directory, "package.json");
+  if (!fs__default.default.existsSync(packageJsonPath)) {
+    return false;
+  }
+  try {
+    const packageJson = JSON.parse(fs__default.default.readFileSync(packageJsonPath, "utf8"));
+    return packageJson.name === GEMINI_CLI_PACKAGE_NAME;
+  } catch {
+    return false;
+  }
+}
+function resolveGeminiCliPackageRoot(startDirectory = __dirname$1) {
+  if (cachedPackageRootPath) {
+    return cachedPackageRootPath;
+  }
+  let currentDirectory = startDirectory;
+  while (true) {
+    if (isGeminiCliPackageRoot(currentDirectory)) {
+      cachedPackageRootPath = currentDirectory;
+      return cachedPackageRootPath;
+    }
+    const parentDirectory = path__default.default.dirname(currentDirectory);
+    if (parentDirectory === currentDirectory) {
+      break;
+    }
+    currentDirectory = parentDirectory;
+  }
+  cachedPackageRootPath = path__default.default.resolve(startDirectory, "../..");
+  return cachedPackageRootPath;
+}
+function resolvePackageAssetPath(relativeFilePath) {
+  return path__default.default.resolve(resolveGeminiCliPackageRoot(), relativeFilePath);
+}
+var rulesPath = resolvePackageAssetPath("src/common/rules/review-rules.md");
+var namingRulesPath = resolvePackageAssetPath("src/common/rules/naming-rule.md");
+var codingConventionRulesPath = resolvePackageAssetPath("src/common/rules/coding-convention.md");
+var reviewFormPath = resolvePackageAssetPath("src/common/form/review-form.md");
+resolvePackageAssetPath("src/common/form/review-form-one-by-one.md");
 var REPORT_DIR = ".review-report";
 var tempDiffPath = "temp_diff.txt";
 var AIServices = ["gemini", "claude", "codex"];
+var COMMIT_FETCH_LIMIT = 20;
+var COMMIT_SELECTION_WINDOW = 8;
 var ignoreList = [
   "package.json",
   "*.yml",
@@ -42,12 +80,224 @@ var ignoreList = [
 function isTestMode(args4 = process.argv.slice(2)) {
   return args4.includes("--test");
 }
+function shouldStreamAIOutput(args4 = process.argv.slice(2)) {
+  return args4.includes("--stream-output");
+}
 function clearTraceMessages() {
   traceMessages.length = 0;
 }
 function getTraceMessages() {
   return [...traceMessages];
 }
+var ANSI = {
+  bold: "\x1B[1m",
+  cyan: "\x1B[36m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  reset: "\x1B[0m",
+  yellow: "\x1B[33m"
+};
+var ANSI_PATTERN = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
+var COMBINING_MARK_PATTERN = /\p{Mark}/u;
+var GRAPHEME_SEGMENTER = typeof Intl !== "undefined" && "Segmenter" in Intl ? new Intl.Segmenter("ko", { granularity: "grapheme" }) : null;
+function getGitDiffPathspecs() {
+  return {
+    excludePatterns: ignoreList.map((item) => `:(exclude)${item}`),
+    includePatterns: ["*.ts", "*.tsx", "*.js", "*.jsx"]
+  };
+}
+function segmentGraphemes(value) {
+  if (!GRAPHEME_SEGMENTER) {
+    return [...value];
+  }
+  return [...GRAPHEME_SEGMENTER.segment(value)].map(({ segment }) => segment);
+}
+function isWideCodePoint(codePoint) {
+  return codePoint >= 4352 && (codePoint <= 4447 || codePoint === 9001 || codePoint === 9002 || codePoint >= 11904 && codePoint <= 12871 && codePoint !== 12351 || codePoint >= 12880 && codePoint <= 19903 || codePoint >= 19968 && codePoint <= 42182 || codePoint >= 43360 && codePoint <= 43388 || codePoint >= 44032 && codePoint <= 55203 || codePoint >= 63744 && codePoint <= 64255 || codePoint >= 65040 && codePoint <= 65049 || codePoint >= 65072 && codePoint <= 65131 || codePoint >= 65281 && codePoint <= 65376 || codePoint >= 65504 && codePoint <= 65510 || codePoint >= 127488 && codePoint <= 127569 || codePoint >= 131072 && codePoint <= 262141);
+}
+function isEmojiCodePoint(codePoint) {
+  return codePoint >= 127462 && codePoint <= 127487 || codePoint >= 127744 && codePoint <= 129791 || codePoint >= 9728 && codePoint <= 10175;
+}
+function getGraphemeWidth(grapheme) {
+  let width = 0;
+  for (const character of grapheme) {
+    const codePoint = character.codePointAt(0);
+    if (!codePoint || COMBINING_MARK_PATTERN.test(character) || codePoint === 8205) {
+      continue;
+    }
+    if (codePoint >= 65024 && codePoint <= 65039 || codePoint >= 917760 && codePoint <= 917999) {
+      continue;
+    }
+    if (isWideCodePoint(codePoint) || isEmojiCodePoint(codePoint)) {
+      width = Math.max(width, 2);
+      continue;
+    }
+    width = Math.max(width, 1);
+  }
+  return width;
+}
+function tokenizePlainText(value) {
+  return segmentGraphemes(value).map((segment) => ({
+    value: segment,
+    visibleWidth: getGraphemeWidth(segment)
+  }));
+}
+function tokenizeVisibleText(value) {
+  const tokens = [];
+  let lastIndex = 0;
+  for (const match of value.matchAll(ANSI_PATTERN)) {
+    const index = match.index ?? 0;
+    if (index > lastIndex) {
+      tokens.push(...tokenizePlainText(value.slice(lastIndex, index)));
+    }
+    tokens.push({
+      value: match[0],
+      visibleWidth: 0
+    });
+    lastIndex = index + match[0].length;
+  }
+  if (lastIndex < value.length) {
+    tokens.push(...tokenizePlainText(value.slice(lastIndex)));
+  }
+  return tokens;
+}
+function truncateLineForTerminal(value, maxWidth) {
+  if (maxWidth <= 0) {
+    return "";
+  }
+  const tokens = tokenizeVisibleText(value);
+  const totalWidth = tokens.reduce((sum, token) => sum + token.visibleWidth, 0);
+  if (totalWidth <= maxWidth) {
+    return value;
+  }
+  const ellipsis = "...";
+  const ellipsisWidth = 3;
+  const targetWidth = Math.max(0, maxWidth - ellipsisWidth);
+  let usedWidth = 0;
+  let result = "";
+  for (const token of tokens) {
+    if (token.visibleWidth === 0) {
+      result += token.value;
+      continue;
+    }
+    if (usedWidth + token.visibleWidth > targetWidth) {
+      break;
+    }
+    result += token.value;
+    usedWidth += token.visibleWidth;
+  }
+  return `${result}${ellipsis}${ANSI.reset}`;
+}
+function fitLinesToTerminal(lines) {
+  const maxWidth = Math.max(20, (process.stdout.columns || 120) - 1);
+  return lines.map((line) => truncateLineForTerminal(line, maxWidth));
+}
+function runGitCommand(args4, options = {}) {
+  const { allowFailure = false, trimOutput = true } = options;
+  try {
+    const output = child_process.execFileSync("git", args4, {
+      encoding: "utf8",
+      maxBuffer: 1024 * 1024 * 20,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    return trimOutput ? output.trim() : output;
+  } catch (error) {
+    helperTrace("git-command:failed", `${args4.join(" ")} | ${getErrorSummary(error)}`);
+    if (allowFailure) {
+      return "";
+    }
+    throw error;
+  }
+}
+async function executeShellCommandWithProgress(command, options = {}) {
+  const { progressIntervalMs = 1e4, progressMessage = "\u23F3 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uB294 \uC911\uC785\uB2C8\uB2E4...", streamOutput = false } = options;
+  const { spawn } = await import('child_process');
+  return new Promise((resolve, reject) => {
+    let stdout = "";
+    let stderr = "";
+    const startedAt = Date.now();
+    console.log(progressMessage);
+    const child = spawn("/bin/zsh", ["-lc", command], {
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const progressTimer = setInterval(() => {
+      const elapsedSeconds = Math.max(1, Math.floor((Date.now() - startedAt) / 1e3));
+      console.log(`${progressMessage} (${elapsedSeconds}s \uACBD\uACFC)`);
+    }, progressIntervalMs);
+    child.stdout.on("data", (chunk) => {
+      const text = chunk.toString();
+      stdout += text;
+      if (streamOutput) {
+        process.stdout.write(text);
+      }
+    });
+    child.stderr.on("data", (chunk) => {
+      const text = chunk.toString();
+      stderr += text;
+      if (streamOutput) {
+        process.stderr.write(text);
+      }
+    });
+    child.on("error", (error) => {
+      clearInterval(progressTimer);
+      reject(error);
+    });
+    child.on("close", (code, signal) => {
+      clearInterval(progressTimer);
+      if (code === 0) {
+        resolve({
+          stderr,
+          stdout
+        });
+        return;
+      }
+      const exitSummary = signal ? `signal=${signal}` : `code=${String(code ?? "unknown")}`;
+      const failureDetails = {
+        code,
+        command,
+        signal,
+        stderr,
+        stdout
+      };
+      reject(createShellCommandExecutionError(failureDetails, exitSummary));
+    });
+  });
+}
+function getShellCommandFailurePreview(failureDetails) {
+  const stderrText = failureDetails.stderr.trim();
+  const stdoutText = failureDetails.stdout.trim();
+  const combinedOutput = stderrText || stdoutText;
+  if (!combinedOutput) {
+    return "";
+  }
+  const MAX_PREVIEW_LENGTH = 4e3;
+  if (combinedOutput.length <= MAX_PREVIEW_LENGTH) {
+    return combinedOutput;
+  }
+  return combinedOutput.slice(-4e3);
+}
+function createShellCommandExecutionError(failureDetails, exitSummary) {
+  const failurePreview = getShellCommandFailurePreview(failureDetails);
+  const error = new Error(`\uC258 \uBA85\uB839 \uC2E4\uD589 \uC2E4\uD328 (${exitSummary})${failurePreview ? `
+${failurePreview}` : ""}`);
+  error.code = failureDetails.code;
+  error.signal = failureDetails.signal;
+  error.stdout = failureDetails.stdout;
+  error.stderr = failureDetails.stderr;
+  error.command = failureDetails.command;
+  return error;
+}
+function formatReviewTargetFiles(files, visibleCount = 5) {
+  if (files.length === 0) {
+    return "(\uC5C6\uC74C)";
+  }
+  const visibleFiles = files.slice(0, visibleCount);
+  const hiddenCount = Math.max(0, files.length - visibleFiles.length);
+  if (hiddenCount === 0) {
+    return visibleFiles.join(", ");
+  }
+  return `${visibleFiles.join(", ")} \uC678 ${hiddenCount}\uAC1C`;
+}
 function createTraceLogger(scope, args4 = process.argv.slice(2)) {
   const enabled = isTestMode(args4);
   return (step, detail) => {
@@ -109,7 +359,7 @@ function serializeError(error) {
   }
   if (error && typeof error === "object") {
     const errorLike = error;
-    const extraKeys = ["code", "errno", "syscall", "path", "cmd", "status", "signal", "spawnargs"];
+    const extraKeys = ["code", "errno", "syscall", "path", "cmd", "status", "signal", "spawnargs", "command"];
     extraKeys.forEach((key) => {
       if (errorLike[key] !== void 0) {
         serialized[key] = errorLike[key];
@@ -215,6 +465,87 @@ ${section.markdown}`).join("\n")}
     return "";
   }
 }
+function getExecutionLogSummary(status, title) {
+  if (title) {
+    return title;
+  }
+  switch (status) {
+    case "success":
+      return "\uB9AC\uBDF0 \uC2E4\uD589\uC774 \uC131\uACF5\uC801\uC73C\uB85C \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.";
+    case "failed":
+      return "\uB9AC\uBDF0 \uC2E4\uD589 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.";
+    case "partial_failure":
+      return "\uB9AC\uBDF0 \uC2E4\uD589\uC740 \uC644\uB8CC\uB418\uC5C8\uC9C0\uB9CC \uC77C\uBD80 \uB2E8\uACC4\uC5D0\uC11C \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.";
+    default:
+      return "\uB9AC\uBDF0 \uC2E4\uD589\uC774 \uCDE8\uC18C\uB418\uC5C8\uAC70\uB098 \uB9AC\uBDF0 \uB300\uC0C1\uC774 \uC5C6\uC5B4 \uC885\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.";
+  }
+}
+function formatExecutionDuration(startedAt, finishedAt) {
+  const durationMs = Math.max(0, finishedAt.getTime() - startedAt.getTime());
+  if (durationMs < 1e3) {
+    return `${durationMs}ms`;
+  }
+  const durationSeconds = durationMs / 1e3;
+  if (durationSeconds < 60) {
+    return `${durationSeconds.toFixed(1)}s`;
+  }
+  const minutes = Math.floor(durationSeconds / 60);
+  const seconds = Math.round(durationSeconds % 60);
+  return `${minutes}m ${seconds}s`;
+}
+function writeExecutionLog(options = {}) {
+  try {
+    const startedAt = options.startedAt ?? /* @__PURE__ */ new Date();
+    const finishedAt = options.finishedAt ?? /* @__PURE__ */ new Date();
+    const status = options.status ?? "success";
+    helperTrace("execution-log:write:start", options.scope || "unknown");
+    createReportDirectory();
+    const reportPath = getAvailableFilePath(REPORT_DIR, `${getNowString(finishedAt)}-execution-log`, ".md");
+    const traceSnapshot = options.traceMessages ?? getTraceMessages();
+    const extraSections = options.extraSections || [];
+    const serializedError = options.error ? serializeError(options.error) : null;
+    const report = `# Execution Log
+
+- \uC2DC\uC791 \uC2DC\uAC01: ${getHumanReadableNowString(startedAt)}
+- \uC885\uB8CC \uC2DC\uAC01: ${getHumanReadableNowString(finishedAt)}
+- \uC2E4\uD589 \uC2DC\uAC04: ${formatExecutionDuration(startedAt, finishedAt)}
+- \uC0C1\uD0DC: \`${status}\`
+- Scope: \`${options.scope || "unknown"}\`
+- \uC791\uC5C5 \uACBD\uB85C: \`${process.cwd()}\`
+- \uC2E4\uD589 \uC778\uC790: \`${JSON.stringify(options.args ?? process.argv.slice(2))}\`
+- \uC2E4\uD589 \uD658\uACBD: \`${process.platform} ${process.arch} / Node ${process.version}\`
+
+## Summary
+
+${getExecutionLogSummary(status, options.title)}
+${serializedError ? `
+
+## Error
+
+\`\`\`json
+${JSON.stringify(serializedError, null, 2)}
+\`\`\`` : ""}
+
+## Trace
+
+\`\`\`json
+${JSON.stringify(traceSnapshot, null, 2)}
+\`\`\`${extraSections.length ? `
+${extraSections.map((section) => `
+## ${section.heading}
+
+${section.markdown}`).join("\n")}
+` : "\n"}
+`;
+    fs__default.default.writeFileSync(reportPath, report);
+    helperTrace("execution-log:write:done", reportPath);
+    return reportPath;
+  } catch (writeError) {
+    console.error("\u26A0\uFE0F \uC2E4\uD589 \uB85C\uADF8 \uD30C\uC77C \uC0DD\uC131\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.");
+    console.error(writeError);
+    return "";
+  }
+}
 function exitWithError(message, options = {}) {
   const reportPath = writeErrorReport(options.error || new Error(message), {
     ...options,
@@ -259,13 +590,67 @@ ${JSON.stringify(AIServices, null, 2)}
     }
   );
 }
-function getGitDiffFilter() {
-  const includeExtensions = ["*.ts", "*.tsx", "*.js", "*.jsx"];
-  const excludePatterns = ignoreList.map((item) => `:(exclude)${item}`);
-  const quote = (pattern) => `"${pattern}"`;
-  const includeParams = includeExtensions.map(quote).join(" ");
-  const excludeParams = excludePatterns.map(quote).join(" ");
-  return { includeParams, excludeParams };
+function truncateCommitSubject(subject) {
+  if (subject.length <= 72) {
+    return subject;
+  }
+  return `${subject.slice(0, 69)}...`;
+}
+function getRecentCommitOptions() {
+  const output = runGitCommand(
+    ["log", `-${COMMIT_FETCH_LIMIT}`, "--date=relative", "--pretty=format:%h%x09%an%x09%ar%x09%s"],
+    { allowFailure: true }
+  );
+  if (!output) {
+    return [];
+  }
+  return output.split("\n").map((line) => {
+    const [hash = "", author = "", relativeDate = "", ...subjectParts] = line.split("	");
+    const subject = subjectParts.join("	").trim();
+    return {
+      author,
+      description: `${author} | ${relativeDate}`,
+      hash,
+      label: `${hash} | ${truncateCommitSubject(subject)}`,
+      relativeDate,
+      subject
+    };
+  });
+}
+function buildSelectedCommitSummary(commits) {
+  return commits.map((commit) => `- ${commit.hash} | ${commit.subject} | ${commit.author} | ${commit.relativeDate}`).join("\n");
+}
+function getReviewPathspecArgs() {
+  const { includePatterns, excludePatterns } = getGitDiffPathspecs();
+  return [...includePatterns, ...excludePatterns];
+}
+function buildSelectedCommitDiff(commits) {
+  const reviewPathspecArgs = getReviewPathspecArgs();
+  const sections = commits.map((commit) => {
+    const diff = runGitCommand(["show", "--stat", "--patch", "--format=", commit.hash, "--", ...reviewPathspecArgs], {
+      allowFailure: true,
+      trimOutput: false
+    }).trim();
+    if (!diff) {
+      return "";
+    }
+    return [`## ${commit.hash} ${commit.subject}`, diff].join("\n\n");
+  }).filter(Boolean).join("\n\n");
+  if (!sections) {
+    return "";
+  }
+  return ["# \uC120\uD0DD\uD55C \uCEE4\uBC0B", buildSelectedCommitSummary(commits), "", "# \uB9AC\uBDF0 \uB300\uC0C1 diff", sections].join("\n");
+}
+function getSelectedCommitFiles(commits) {
+  const reviewPathspecArgs = getReviewPathspecArgs();
+  const files = /* @__PURE__ */ new Set();
+  commits.forEach((commit) => {
+    const output = runGitCommand(["show", "--pretty=format:", "--name-only", commit.hash, "--", ...reviewPathspecArgs], {
+      allowFailure: true
+    });
+    output.split("\n").map((line) => line.trim()).filter(Boolean).forEach((filePath) => files.add(filePath));
+  });
+  return [...files];
 }
 function openReport(reportPath) {
   const resolvedPath = path__default.default.resolve(reportPath);
@@ -316,59 +701,166 @@ function openReport(reportPath) {
   helperTrace("open-report:unsupported-platform", platform);
   console.error(`\u26A0\uFE0F \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD50C\uB7AB\uD3FC\uC785\uB2C8\uB2E4: ${platform}`);
 }
-function getDiffArgs() {
-  const args4 = process.argv.slice(2);
-  const commitIndex = args4.indexOf("--commit");
-  const { includeParams, excludeParams } = getGitDiffFilter();
-  helperTrace("diff-args:resolve:start", `args=${JSON.stringify(args4)}`);
-  let diffArgs = "";
-  if (commitIndex !== -1) {
-    const commitHash = args4[commitIndex + 1];
-    if (!commitHash) {
-      helperTrace("diff-args:commit-hash-missing");
-      exitWithError("\u274C \uCEE4\uBC0B \uD574\uC2DC\uAC00 \uC81C\uACF5\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.", {
-        scope: "helper:getDiffArgs",
-        args: args4
-      });
+function ensureInteractiveSelectionAvailable(scope, message) {
+  if (process.stdin.isTTY && process.stdout.isTTY && typeof process.stdin.setRawMode === "function") {
+    return;
+  }
+  helperTrace(`${scope}:tty-missing`);
+  exitWithError(message, {
+    scope: `helper:${scope}`
+  });
+}
+function renderSelectionBlock(lines, previousLineCount) {
+  if (previousLineCount > 0) {
+    readline__default.default.moveCursor(process.stdout, 0, -previousLineCount);
+    readline__default.default.clearScreenDown(process.stdout);
+  }
+  const fittedLines = fitLinesToTerminal(lines);
+  process.stdout.write(`${fittedLines.join("\n")}
+`);
+  return fittedLines.length;
+}
+function getSelectionWindowRange(optionCount, selectedIndex, windowSize) {
+  if (optionCount <= windowSize) {
+    return {
+      end: optionCount,
+      start: 0
+    };
+  }
+  const halfWindow = Math.floor(windowSize / 2);
+  const maxStart = optionCount - windowSize;
+  const start = Math.max(0, Math.min(selectedIndex - halfWindow, maxStart));
+  return {
+    end: Math.min(optionCount, start + windowSize),
+    start
+  };
+}
+function buildMultiSelectLines(question, options, selectedIndex, toggled, windowSize) {
+  const { start, end } = getSelectionWindowRange(options.length, selectedIndex, windowSize);
+  const lines = [
+    `${ANSI.bold}${question}${ANSI.reset}`,
+    `${ANSI.dim}\u2191\u2193 \uC774\uB3D9 | Space \uC120\uD0DD/\uD574\uC81C | Enter \uC644\uB8CC | Esc \uCDE8\uC18C${ANSI.reset}`,
+    `${ANSI.dim}\uC120\uD0DD\uB428: ${toggled.size}\uAC1C / \uC804\uCCB4: ${options.length}\uAC1C${ANSI.reset}`
+  ];
+  for (let index = start; index < end; index += 1) {
+    const option = options[index];
+    if (!option) {
+      continue;
     }
-    const nextArg = args4[commitIndex + 2];
-    let n = 0;
-    if (nextArg && !nextArg.startsWith("--")) {
-      n = parseInt(nextArg, 10);
-      if (isNaN(n)) {
-        n = 0;
-      }
+    const cursor = index === selectedIndex ? `${ANSI.cyan}>${ANSI.reset}` : " ";
+    const checked = toggled.has(index) ? `${ANSI.green}\u2611${ANSI.reset}` : "\u2610";
+    const description = option.description ? ` ${ANSI.dim}${option.description}${ANSI.reset}` : "";
+    lines.push(`${cursor} ${checked} ${option.label}${description}`);
+  }
+  if (options.length > windowSize) {
+    lines.push(`${ANSI.dim}\uD45C\uC2DC \uBC94\uC704: ${start + 1}-${end} / ${options.length}${ANSI.reset}`);
+  }
+  return lines;
+}
+async function showMultiSelect(question, options, windowSize = COMMIT_SELECTION_WINDOW) {
+  ensureInteractiveSelectionAvailable("showMultiSelect", "\u274C \uCEE4\uBC0B \uC120\uD0DD \uBAA8\uB2EC\uC740 TTY \uD658\uACBD\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
+  let selectedIndex = 0;
+  let renderedLineCount = 0;
+  const toggled = /* @__PURE__ */ new Set();
+  const rl = readline__default.default.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: true
+  });
+  process.stdout.write("\x1B[?25l");
+  const cleanup = () => {
+    if (renderedLineCount > 0) {
+      readline__default.default.moveCursor(process.stdout, 0, -renderedLineCount);
+      readline__default.default.clearScreenDown(process.stdout);
+      renderedLineCount = 0;
     }
-    helperTrace("diff-args:commit-mode", `${commitHash}~${n + 1} ${commitHash}`);
-    console.log(`\u2139\uFE0F \uCEE4\uBC0B '${commitHash}' ${n > 0 ? ` \uD3EC\uD568 \uCD1D ${n + 1}\uAC1C\uC758 \uCEE4\uBC0B` : ""}\uC744 \uB9AC\uBDF0\uD569\uB2C8\uB2E4...`);
-    diffArgs = `${commitHash}~${n + 1} ${commitHash}`;
-  } else {
-    try {
-      helperTrace("diff-args:unstaged-check:start");
-      const check = child_process.execSync(`git diff --name-only -- ${includeParams} ${excludeParams}`).toString();
-      if (!check.trim()) {
-        helperTrace("diff-args:unstaged-check:empty", "use HEAD~1 HEAD");
-        console.log("\u2139\uFE0F Unstaged \uBCC0\uACBD\uC0AC\uD56D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uB9C8\uC9C0\uB9C9 \uCEE4\uBC0B(HEAD)\uC744 \uB9AC\uBDF0\uD569\uB2C8\uB2E4...");
-        diffArgs = "HEAD~1 HEAD";
-      } else {
-        helperTrace("diff-args:unstaged-check:has-changes", `length=${check.length}`);
+    process.stdin.removeListener("data", onData);
+    process.stdin.setRawMode(false);
+    process.stdin.pause();
+    rl.close();
+    process.stdout.write("\x1B[?25h");
+  };
+  const render = () => {
+    const lines = buildMultiSelectLines(question, options, selectedIndex, toggled, windowSize);
+    renderedLineCount = renderSelectionBlock(lines, renderedLineCount);
+  };
+  const confirmSelection = (resolve) => {
+    const values = [...toggled].sort((left, right) => left - right).map((index) => options[index]?.value).filter((value) => value !== void 0);
+    cleanup();
+    resolve(values);
+  };
+  const cancelSelection = (resolve) => {
+    cleanup();
+    resolve([]);
+  };
+  let onData = (_data) => {
+  };
+  render();
+  return new Promise((resolve) => {
+    onData = (data) => {
+      const key = data.toString();
+      if (key === "") {
+        cleanup();
+        process.exit(0);
       }
-    } catch (error) {
-      helperTrace("diff-args:unstaged-check:failed", getErrorSummary(error));
-    }
+      if (key === "\x1B") {
+        cancelSelection(resolve);
+        return;
+      }
+      if (key === "\x1B[A") {
+        selectedIndex = (selectedIndex - 1 + options.length) % options.length;
+        render();
+        return;
+      }
+      if (key === "\x1B[B") {
+        selectedIndex = (selectedIndex + 1) % options.length;
+        render();
+        return;
+      }
+      if (key === " ") {
+        if (toggled.has(selectedIndex)) {
+          toggled.delete(selectedIndex);
+        } else {
+          toggled.add(selectedIndex);
+        }
+        render();
+        return;
+      }
+      if (key === "\r" || key === "\n") {
+        confirmSelection(resolve);
+      }
+    };
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("data", onData);
+  });
+}
+async function selectReviewCommits() {
+  const commits = getRecentCommitOptions();
+  if (commits.length === 0) {
+    console.log("\u2139\uFE0F \uB9AC\uBDF0\uD560 \uCD5C\uADFC \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    return [];
   }
-  helperTrace("diff-args:resolve:done", diffArgs || "(default)");
-  return diffArgs;
+  return showMultiSelect(
+    "\uB9AC\uBDF0\uD560 \uCEE4\uBC0B\uC744 \uC120\uD0DD\uD574\uC8FC\uC138\uC694.",
+    commits.map((commit) => ({
+      description: commit.description,
+      label: commit.label,
+      value: commit
+    })),
+    COMMIT_SELECTION_WINDOW
+  );
 }
 async function showSelectionAIService() {
   const selectedServiceFromArgs = parseServiceFromArgs();
   if (selectedServiceFromArgs) {
     helperTrace("show-selection:from-args", selectedServiceFromArgs);
     console.log(`
-\u2705 \x1B[32m${selectedServiceFromArgs}\x1B[0m \uC11C\uBE44\uC2A4\uAC00 \uC120\uD0DD\uB418\uC5C8\uC2B5\uB2C8\uB2E4. (--service)
+\u2705 ${ANSI.green}${selectedServiceFromArgs}${ANSI.reset} \uC11C\uBE44\uC2A4\uAC00 \uC120\uD0DD\uB418\uC5C8\uC2B5\uB2C8\uB2E4. (--service)
 `);
     return selectedServiceFromArgs;
   }
+  ensureInteractiveSelectionAvailable("showSelectionAIService", "\u274C AI \uC11C\uBE44\uC2A4 \uC120\uD0DD UI\uB294 TTY \uD658\uACBD\uC5D0\uC11C\uB9CC \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.");
   helperTrace("show-selection:interactive:start");
   let selectedIndex = 0;
   const rl = readline__default.default.createInterface({
@@ -386,11 +878,12 @@ async function showSelectionAIService() {
     helperTrace("show-selection:interactive:render", AIServices[selectedIndex] || "unknown");
     readline__default.default.clearScreenDown(process.stdout);
     process.stdout.write(
-      "\u{1F916} AI \uC11C\uBE44\uC2A4\uB97C \uC120\uD0DD\uD574\uC8FC\uC138\uC694 (\x1B[33m\u2191\u2193 \uBC29\uD5A5\uD0A4\x1B[0m \uC774\uB3D9, \x1B[33mEnter\x1B[0m \uC120\uD0DD):\n"
+      `\u{1F916} AI \uC11C\uBE44\uC2A4\uB97C \uC120\uD0DD\uD574\uC8FC\uC138\uC694 (${ANSI.yellow}\u2191\u2193 \uBC29\uD5A5\uD0A4${ANSI.reset} \uC774\uB3D9, ${ANSI.yellow}Enter${ANSI.reset} \uC120\uD0DD):
+`
     );
     AIServices.forEach((service, index) => {
       if (index === selectedIndex) {
-        process.stdout.write(` \x1B[36m>\x1B[0m \x1B[36m\u25C9\x1B[0m \x1B[1m${service}\x1B[0m
+        process.stdout.write(` ${ANSI.cyan}>${ANSI.reset} ${ANSI.cyan}\u25C9${ANSI.reset} ${ANSI.bold}${service}${ANSI.reset}
 `);
       } else {
         process.stdout.write(`   \u25EF ${service}
@@ -420,7 +913,7 @@ async function showSelectionAIService() {
         rl.close();
         process.stdout.write("\x1B[?25h");
         console.log(`
-\u2705 \x1B[32m${AIServices[selectedIndex]}\x1B[0m \uC11C\uBE44\uC2A4\uAC00 \uC120\uD0DD\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
+\u2705 ${ANSI.green}${AIServices[selectedIndex]}${ANSI.reset} \uC11C\uBE44\uC2A4\uAC00 \uC120\uD0DD\uB418\uC5C8\uC2B5\uB2C8\uB2E4.
 `);
         const result = AIServices[selectedIndex];
         if (result) {
@@ -440,6 +933,13 @@ var ALLOWED_REASONING_EFFORTS = ["minimal", "low", "medium", "high"];
 function shellQuote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
+function toShellOptionToken(value) {
+  const SIMPLE_SHELL_TOKEN_PATTERN = /^[A-Za-z0-9._:/=-]+$/;
+  if (SIMPLE_SHELL_TOKEN_PATTERN.test(value)) {
+    return value;
+  }
+  return shellQuote(value);
+}
 function getArgValue(flag) {
   const index = args.indexOf(flag);
   if (index === -1 || !args[index + 1]) {
@@ -447,6 +947,11 @@ function getArgValue(flag) {
   }
   return args[index + 1];
 }
+function printNotice(message) {
+  if (args.includes("--test")) {
+    console.warn(message);
+  }
+}
 function toUnique(values) {
   const seen = /* @__PURE__ */ new Set();
   return values.filter((value) => {
@@ -470,11 +975,11 @@ function resolveReasoningEffort() {
       const normalized = normalizeEffort(customReasoningEffort);
       trace("reasoning:custom", `${customReasoningEffort} -> ${normalized}`);
       if (customReasoningEffort === "minimal") {
-        console.warn("\u26A0\uFE0F Claude\uB294 minimal\uC744 \uC9C1\uC811 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC544 low\uB85C \uB9E4\uD551\uD569\uB2C8\uB2E4.");
+        printNotice("\u26A0\uFE0F Claude\uB294 minimal\uC744 \uC9C1\uC811 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC544 low\uB85C \uB9E4\uD551\uD569\uB2C8\uB2E4.");
       }
       return normalized;
     }
-    console.warn(
+    printNotice(
       `\u26A0\uFE0F \uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 reasoning effort(${customReasoningEffort})\uC785\uB2C8\uB2E4. allowed: ${ALLOWED_REASONING_EFFORTS.join(
         ", "
       )}`
@@ -514,10 +1019,10 @@ function getAliasFallbacks(primaryAlias) {
 }
 function buildClaudeExecCommand(options) {
   const { tempDiffPath: tempDiffPath2, prompt, systemPromptFiles, effort, model, fallbackModel } = options;
-  const modelOption = model ? `--model ${shellQuote(model)}` : "";
-  const fallbackOption = model && fallbackModel ? `--fallback-model ${shellQuote(fallbackModel)}` : "";
-  const effortOption = `--effort ${shellQuote(effort)}`;
-  const appendedPromptFiles = systemPromptFiles.map((path2) => `--append-system-prompt-file ${shellQuote(path2)}`).join(" ");
+  const modelOption = model ? `--model ${toShellOptionToken(model)}` : "";
+  const fallbackOption = model && fallbackModel ? `--fallback-model ${toShellOptionToken(fallbackModel)}` : "";
+  const effortOption = `--effort ${toShellOptionToken(effort)}`;
+  const appendedPromptFiles = systemPromptFiles.map((path3) => `--append-system-prompt-file ${shellQuote(path3)}`).join(" ");
   return `cat ${shellQuote(tempDiffPath2)} | claude ${[
     modelOption,
     fallbackOption,
@@ -550,13 +1055,13 @@ var createClaudeCommand = (tempDiffPath2, reviewFormPath2) => {
   trace("model:candidates", modelCandidates.join(", "));
   trace("command:candidates:count", String(modelCandidates.length + 1));
   if (customModel) {
-    console.warn(
+    printNotice(
       `\u26A0\uFE0F \uCEE4\uC2A4\uD140 \uBAA8\uB378(${customModel})\uC744 \uC6B0\uC120 \uC2DC\uB3C4\uD558\uACE0 \uC2E4\uD328\uD558\uBA74 alias(${aliasFallbacks.join(
         " -> "
       )}) \uBC0F \uAE30\uBCF8 \uBAA8\uB378 \uC21C\uC73C\uB85C \uD3F4\uBC31\uD569\uB2C8\uB2E4.`
     );
   } else {
-    console.warn(
+    printNotice(
       `\u26A0\uFE0F \uBAA8\uB378\uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. alias(${aliasFallbacks.join(" -> ")})\uB97C \uC21C\uCC28 \uC2DC\uB3C4\uD558\uACE0 \uB9C8\uC9C0\uB9C9\uC5D0 \uAE30\uBCF8 \uBAA8\uB378\uB85C \uD3F4\uBC31\uD569\uB2C8\uB2E4.`
     );
   }
@@ -636,22 +1141,37 @@ function getArgValue2(flag) {
   }
   return args2[index + 1];
 }
+function printNotice2(message) {
+  if (args2.includes("--test")) {
+    console.warn(message);
+  }
+}
+function normalizeEffort2(level) {
+  if (level === "minimal") {
+    return "low";
+  }
+  return level;
+}
 function resolveReasoningEffort2() {
   const customReasoningEffort = getArgValue2("--reasoning-effort");
   if (customReasoningEffort) {
     if (ALLOWED_REASONING_EFFORTS2.includes(customReasoningEffort)) {
-      trace3("reasoning:custom", customReasoningEffort);
-      return customReasoningEffort;
+      const normalized = normalizeEffort2(customReasoningEffort);
+      trace3("reasoning:custom", `${customReasoningEffort} -> ${normalized}`);
+      if (customReasoningEffort === "minimal") {
+        printNotice2("\u26A0\uFE0F Codex\uB294 minimal\uC774 web_search \uB3C4\uAD6C\uC640 \uCDA9\uB3CC\uD560 \uC218 \uC788\uC5B4 low\uB85C \uB9E4\uD551\uD569\uB2C8\uB2E4.");
+      }
+      return normalized;
     }
-    console.warn(
+    printNotice2(
       `\u26A0\uFE0F \uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 reasoning effort(${customReasoningEffort})\uC785\uB2C8\uB2E4. allowed: ${ALLOWED_REASONING_EFFORTS2.join(
         ", "
       )}`
     );
   }
   if (args2.includes("--flash")) {
-    trace3("reasoning:flash-default", "minimal");
-    return "minimal";
+    trace3("reasoning:flash-default", "low");
+    return "low";
   }
   if (args2.includes("--review")) {
     trace3("reasoning:review-default", "high");
@@ -687,14 +1207,14 @@ ${reviewFormLine || "- (\uC5C6\uC74C)"}
   trace3("prompt:prepared", `length=${prompt.length}`);
   let command = "";
   if (customModel) {
-    console.warn("\u26A0\uFE0F \uC9C0\uC815\uD55C \uBAA8\uB378\uC774 \uC5C6\uB294 \uACBD\uC6B0, \uC5D0\uB7EC\uAC00 \uBC1C\uC0DD\uD558\uB2C8 \uC8FC\uC758\uD558\uC138\uC694.");
+    printNotice2("\u26A0\uFE0F \uC9C0\uC815\uD55C \uBAA8\uB378\uC774 \uC5C6\uB294 \uACBD\uC6B0, \uC5D0\uB7EC\uAC00 \uBC1C\uC0DD\uD558\uB2C8 \uC8FC\uC758\uD558\uC138\uC694.");
     trace3("model:custom", customModel);
     command = buildCodexExecCommand(prompt, reasoningEffort, customModel);
   } else {
     const preferredModelAlias = "gpt-5";
     const aliasCommand = buildCodexExecCommand(prompt, reasoningEffort, preferredModelAlias);
     const fallbackCommand = buildCodexExecCommand(prompt, reasoningEffort);
-    console.warn(
+    printNotice2(
       `\u26A0\uFE0F \uBAA8\uB378\uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. alias(${preferredModelAlias})\uB97C \uC6B0\uC120 \uC2DC\uB3C4\uD558\uACE0 \uC2E4\uD328\uD558\uBA74 \uACC4\uC815 \uAE30\uBCF8 \uBAA8\uB378\uB85C \uC790\uB3D9 \uD3F4\uBC31\uD569\uB2C8\uB2E4.`
     );
     trace3("model:alias-first", preferredModelAlias);
@@ -755,6 +1275,11 @@ function getArgValue3(flag) {
   }
   return args3[index + 1];
 }
+function printNotice3(message) {
+  if (args3.includes("--test")) {
+    console.warn(message);
+  }
+}
 function toUnique2(values) {
   const seen = /* @__PURE__ */ new Set();
   return values.filter((value) => {
@@ -772,7 +1297,7 @@ function resolveReasoningEffort3() {
       trace5("reasoning:custom", customReasoningEffort);
       return customReasoningEffort;
     }
-    console.warn(
+    printNotice3(
       `\u26A0\uFE0F \uC9C0\uC6D0\uB418\uC9C0 \uC54A\uB294 reasoning effort(${customReasoningEffort})\uC785\uB2C8\uB2E4. allowed: ${ALLOWED_REASONING_EFFORTS3.join(
         ", "
       )}`
@@ -834,38 +1359,57 @@ function buildGeminiExecCommand(prompt, model) {
   const modelOption = model ? `--model ${shellQuote3(model)}` : "";
   return `gemini ${[modelOption, "-p", shellQuote3(prompt)].filter(Boolean).join(" ")}`;
 }
+function toGeminiFileReference(filePath) {
+  return `@${filePath}`;
+}
+function buildGeminiFileReferenceSection(files) {
+  const existingFiles = files.filter((file) => fs__default.default.existsSync(file.path));
+  return {
+    count: existingFiles.length,
+    items: existingFiles.map((file) => `${file.display} ${toGeminiFileReference(file.path)}`)
+  };
+}
 var createGeminiCommand = (tempDiffPath2, reviewFormPath2) => {
   trace5("createGeminiCommand:start", `tempDiffPath=${tempDiffPath2}, reviewFormPath=${reviewFormPath2}`);
   const customModel = getArgValue3("--model");
   const reasoningEffort = resolveReasoningEffort3();
   const primaryAlias = resolvePrimaryAlias2(reasoningEffort);
   const aliasFallbacks = toUnique2(getAliasFallbacks2(primaryAlias));
+  const resolvedTempDiffPath = path__default.default.resolve(tempDiffPath2);
+  const resolvedReviewFormPath = path__default.default.resolve(reviewFormPath2);
   const rules = [
     { path: rulesPath, display: "\uB8F0\uC14B" },
     { path: namingRulesPath, display: "\uB124\uC774\uBC0D \uADDC\uCE59" },
     { path: codingConventionRulesPath, display: "\uCF54\uB529 \uCEE8\uBCA4\uC158" }
   ];
-  const validRules = rules.filter((rule) => fs__default.default.existsSync(rule.path)).map((rule) => `@${rule.path}`).join(", ");
-  const rulesCount = validRules ? validRules.split(",").length : 0;
-  trace5("rules:loaded", `count=${rulesCount}`);
-  const reviewFormRef = fs__default.default.existsSync(reviewFormPath2) ? `@${reviewFormPath2}` : "(\uC5C6\uC74C)";
-  trace5("reviewForm:status", reviewFormRef === "(\uC5C6\uC74C)" ? "missing" : "exists");
+  const ruleSection = buildGeminiFileReferenceSection(rules);
+  trace5("rules:loaded", `count=${ruleSection.count}`);
+  const reviewFormExists = fs__default.default.existsSync(resolvedReviewFormPath);
+  const reviewFormText = reviewFormExists ? `\uB9AC\uBDF0 \uC591\uC2DD ${toGeminiFileReference(resolvedReviewFormPath)}` : "\uB9AC\uBDF0 \uC591\uC2DD (\uC5C6\uC74C)";
+  trace5("reviewForm:status", reviewFormExists ? "exists" : "missing");
   const reasoningInstruction = getReasoningInstruction(reasoningEffort);
-  const prompt = `\uB2E4\uC74C \uADDC\uCE59\uB4E4\uC744 \uCC38\uACE0\uD574\uC11C(${validRules || "(\uC5C6\uC74C)"}) \uC774 diff(@${tempDiffPath2})\uB97C \uB9AC\uBDF0\uD574\uC918.
-\uB9AC\uBDF0 \uC591\uC2DD\uC740 ${reviewFormRef} \uC5D0 \uB9DE\uCDB0\uC11C \uC791\uC131\uD574\uC918.
-\uCD94\uB860 \uAC15\uB3C4 \uC9C0\uCE68: ${reasoningInstruction}`;
+  const ruleText = ruleSection.items.join(" ") || "(\uC5C6\uC74C)";
+  const diffText = `\uB9AC\uBDF0 \uB300\uC0C1 diff ${toGeminiFileReference(resolvedTempDiffPath)}`;
+  const prompt = [
+    "\uC544\uB798 \uD30C\uC77C\uB4E4\uC744 \uC21C\uC11C\uB300\uB85C \uC77D\uACE0 \uCF54\uB4DC \uB9AC\uBDF0\uB97C \uC9C4\uD589\uD574\uC918.",
+    `\uADDC\uCE59 \uD30C\uC77C: ${ruleText}`,
+    `\uB9AC\uBDF0 \uC591\uC2DD \uD30C\uC77C: ${reviewFormText}`,
+    `\uB9AC\uBDF0 \uB300\uC0C1 diff \uD30C\uC77C: ${diffText}`,
+    "\uBC18\uB4DC\uC2DC \uB9AC\uBDF0 \uC591\uC2DD\uC5D0 \uB9DE\uCDB0 \uC791\uC131\uD574\uC918.",
+    `\uCD94\uB860 \uAC15\uB3C4 \uC9C0\uCE68: ${reasoningInstruction}`
+  ].join(" ");
   trace5("prompt:prepared", `length=${prompt.length}`);
   const modelCandidates = toUnique2(customModel ? [customModel, ...aliasFallbacks] : aliasFallbacks);
   trace5("model:candidates", modelCandidates.join(", "));
   trace5("command:candidates:count", String(modelCandidates.length + 1));
   if (customModel) {
-    console.warn(
+    printNotice3(
       `\u26A0\uFE0F \uCEE4\uC2A4\uD140 \uBAA8\uB378(${customModel})\uC744 \uC6B0\uC120 \uC2DC\uB3C4\uD558\uACE0 \uC2E4\uD328\uD558\uBA74 alias(${aliasFallbacks.join(
         " -> "
       )}) \uBC0F \uAE30\uBCF8 \uBAA8\uB378 \uC21C\uC73C\uB85C \uD3F4\uBC31\uD569\uB2C8\uB2E4.`
     );
   } else {
-    console.warn(
+    printNotice3(
       `\u26A0\uFE0F \uBAA8\uB378\uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. alias(${aliasFallbacks.join(" -> ")})\uB97C \uC21C\uCC28 \uC2DC\uB3C4\uD558\uACE0 \uB9C8\uC9C0\uB9C9\uC5D0 \uAE30\uBCF8 \uBAA8\uB378\uB85C \uD3F4\uBC31\uD569\uB2C8\uB2E4.`
     );
   }
@@ -916,14 +1460,24 @@ function checkGeminiCliInstalled() {
 // src/pr-review/review.ts
 async function main() {
   const args4 = process.argv.slice(2);
+  const startedAt = /* @__PURE__ */ new Date();
   clearTraceMessages();
   const isTest = isTestMode(args4);
+  const shouldStreamOutput = shouldStreamAIOutput(args4);
   const trace7 = createTraceLogger("review", args4);
   trace7("main:start", `args=${JSON.stringify(args4)}`);
   let command = "";
   let savedDiffPath = "";
   let savedReportPath = "";
   let service = "";
+  let selectedCommitSummary = "";
+  let reviewTargetFiles = [];
+  let executionLogPath = "";
+  let executionStatus = "cancelled";
+  let executionTitle = "\uB9AC\uBDF0 \uC2E4\uD589\uC774 \uCDE8\uC18C\uB418\uC5C8\uAC70\uB098 \uB9AC\uBDF0 \uB300\uC0C1\uC774 \uC5C6\uC5B4 \uC885\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.";
+  let executionError = null;
+  let resultLength = 0;
+  let exitCode = 0;
   try {
     trace7("service-selection:start");
     service = await showSelectionAIService();
@@ -947,30 +1501,39 @@ async function main() {
     }
     trace7("review-flow:start");
     console.log("\u{1F680} AI Code Review\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4...");
-    const nowStr = getNowString();
-    trace7("timestamp:created", nowStr);
-    trace7("report-dir:create:start");
-    createReportDirectory();
-    trace7("report-dir:create:done");
-    trace7("diff-args:build:start");
-    const diffArgs = getDiffArgs();
-    trace7("diff-args:build:done", `diffArgs=${diffArgs || "(default)"}`);
-    let diff = "";
-    const { includeParams, excludeParams } = getGitDiffFilter();
-    trace7("diff-filter:loaded", `include=${includeParams} | exclude=${excludeParams}`);
-    try {
-      trace7("git-diff:run");
-      diff = child_process.execSync(`git diff ${diffArgs} -- ${includeParams} ${excludeParams}`).toString();
-      trace7("git-diff:done", `length=${diff.length}`);
-    } catch (error) {
-      trace7("git-diff:error", getErrorSummary(error));
+    if (shouldStreamOutput) {
+      console.log("\u2139\uFE0F AI \uC2E4\uC2DC\uAC04 \uC751\uB2F5 \uD45C\uC2DC \uBAA8\uB4DC\uAC00 \uD65C\uC131\uD654\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
     }
+    trace7("commit-selection:start");
+    const selectedCommits = await selectReviewCommits();
+    trace7("commit-selection:done", `count=${selectedCommits.length}`);
+    if (selectedCommits.length === 0) {
+      trace7("commit-selection:empty");
+      executionTitle = "\uC120\uD0DD\uB41C \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.";
+      console.log("\u2139\uFE0F \uC120\uD0DD\uB41C \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");
+      deleteTempDiff();
+      return;
+    }
+    selectedCommitSummary = buildSelectedCommitSummary(selectedCommits);
+    trace7("commit-summary:prepared", selectedCommitSummary);
+    reviewTargetFiles = getSelectedCommitFiles(selectedCommits);
+    console.log(`\u{1F4C2} \uB9AC\uBDF0 \uB300\uC0C1 \uD30C\uC77C(${reviewTargetFiles.length}\uAC1C): ${formatReviewTargetFiles(reviewTargetFiles)}`);
+    console.log("\u23F3 \uC120\uD0DD\uD55C \uCEE4\uBC0B diff\uB97C \uC815\uB9AC\uD558\uB294 \uC911\uC785\uB2C8\uB2E4...");
+    trace7("git-diff:build:start");
+    const diff = buildSelectedCommitDiff(selectedCommits);
+    trace7("git-diff:build:done", `length=${diff.length}`);
     if (!diff.trim() && !isTest) {
       trace7("empty-diff:exit");
-      console.log("\u2139\uFE0F \uB9AC\uBDF0\uD560 \uBCC0\uACBD \uC0AC\uD56D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (Unstaged Empty & HEAD Empty).");
+      executionTitle = "\uC120\uD0DD\uD55C \uCEE4\uBC0B\uC5D0\uC11C \uB9AC\uBDF0 \uB300\uC0C1 \uD30C\uC77C \uBCC0\uACBD\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.";
+      console.log("\u2139\uFE0F \uC120\uD0DD\uD55C \uCEE4\uBC0B\uC5D0\uC11C \uB9AC\uBDF0 \uB300\uC0C1 \uD30C\uC77C \uBCC0\uACBD\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4.");
       deleteTempDiff();
-      process.exit(0);
+      return;
     }
+    const nowStr = getNowString();
+    trace7("timestamp:created", nowStr);
+    trace7("report-dir:create:start");
+    createReportDirectory();
+    trace7("report-dir:create:done");
     trace7("temp-diff:write:start", tempDiffPath);
     fs__default.default.writeFileSync(tempDiffPath, diff);
     trace7("temp-diff:write:done");
@@ -992,9 +1555,12 @@ async function main() {
     }
     trace7("command:create:done");
     trace7("command:exec:start");
-    const result = child_process.execSync(command).toString();
+    const result = (await executeShellCommandWithProgress(command, {
+      progressMessage: `\u23F3 [\uB9AC\uBDF0 \uC9C4\uD589] ${service} | \uB300\uC0C1 ${reviewTargetFiles.length}\uAC1C \uD30C\uC77C`,
+      streamOutput: isTest || shouldStreamOutput
+    })).stdout;
+    resultLength = result.length;
     trace7("command:exec:done", `resultLength=${result.length}`);
-    console.log(result);
     trace7("report:write:start");
     savedReportPath = getNextFilePath(REPORT_DIR, nowStr, ".md");
     fs__default.default.writeFileSync(savedReportPath, result);
@@ -1019,9 +1585,15 @@ ${command}`);
     deleteTempDiff();
     trace7("cleanup-temp-diff:done");
     trace7("review-flow:end");
+    executionStatus = "success";
+    executionTitle = "\uB9AC\uBDF0\uAC00 \uC131\uACF5\uC801\uC73C\uB85C \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.";
   } catch (error) {
     trace7("review-flow:catch", getErrorSummary(error));
     let errorReportPath = "";
+    executionStatus = "failed";
+    executionTitle = "\uB9AC\uBDF0 \uC2E4\uD589 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.";
+    executionError = error;
+    exitCode = 1;
     trace7("cleanup-temp-diff:start(catch)");
     try {
       deleteTempDiff();
@@ -1042,6 +1614,8 @@ ${command}`);
 ${JSON.stringify(
             {
               service,
+              selectedCommitSummary: selectedCommitSummary || null,
+              reviewTargetFiles,
               command: command || null,
               tempDiffPath,
               savedDiffPath: savedDiffPath || null,
@@ -1059,7 +1633,50 @@ ${JSON.stringify(
     if (errorReportPath) {
       console.error(`\u{1F4C4} \uC5D0\uB7EC \uB85C\uADF8 \uC800\uC7A5 \uC704\uCE58: ${errorReportPath}`);
     }
-    process.exit(1);
+  } finally {
+    executionLogPath = writeExecutionLog({
+      scope: "review",
+      status: executionStatus,
+      title: executionTitle,
+      args: args4,
+      startedAt,
+      error: executionError,
+      extraSections: [
+        {
+          heading: "Execution Context",
+          markdown: `\`\`\`json
+${JSON.stringify(
+            {
+              service: service || null,
+              selectedCommitSummary: selectedCommitSummary || null,
+              reviewTargetFiles,
+              command: command || null,
+              tempDiffPath,
+              savedDiffPath: savedDiffPath || null,
+              savedReportPath: savedReportPath || null,
+              shouldStreamOutput,
+              resultLength
+            },
+            null,
+            2
+          )}
+\`\`\``
+        },
+        {
+          heading: "Generated Command",
+          markdown: command ? `\`\`\`sh
+${command}
+\`\`\`` : "(\uC5C6\uC74C)"
+        }
+      ]
+    });
+    if (executionLogPath) {
+      const writeLog = executionStatus === "failed" ? console.error : console.log;
+      writeLog(`\u{1F4DD} \uC2E4\uD589 \uB85C\uADF8 \uC800\uC7A5 \uC704\uCE58: ${executionLogPath}`);
+    }
+  }
+  if (exitCode !== 0) {
+    process.exit(exitCode);
   }
 }
 main();