sales-frontend-gemini-cli 0.3.0 → 0.4.0

package/dist/pr-review/review.js

@@ -6,11 +6,11 @@ import readline from 'readline';
 import { fileURLToPath } from 'url';
 
 var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var rulesPath = path.resolve(__dirname, "../../src/pr-review/rules/review-rules.md");
-var namingRulesPath = path.resolve(__dirname, "../../src/pr-review/rules/naming-rule.md");
-var codingConventionRulesPath = path.resolve(__dirname, "../../src/pr-review/rules/coding-convention.md");
-var reviewFormPath = path.resolve(__dirname, "../../src/pr-review/form/review-form.md");
-path.resolve(__dirname, "../../src/pr-review/form/review-form-one-by-one.md");
+var rulesPath = path.resolve(__dirname, "../../src/common/rules/review-rules.md");
+var namingRulesPath = path.resolve(__dirname, "../../src/common/rules/naming-rule.md");
+var codingConventionRulesPath = path.resolve(__dirname, "../../src/common/rules/coding-convention.md");
+var reviewFormPath = path.resolve(__dirname, "../../src/common/form/review-form.md");
+path.resolve(__dirname, "../../src/common/form/review-form-one-by-one.md");
 var REPORT_DIR = ".review-report";
 var tempDiffPath = "temp_diff.txt";
 var AIServices = ["gemini", "claude", "codex"];
@@ -28,6 +28,18 @@ var ignoreList = [
   ".review-report/"
   // 생성되는 리포트 폴더도 제외
 ];
+function isTestMode(args4 = process.argv.slice(2)) {
+  return args4.includes("--test");
+}
+function createTraceLogger(scope, args4 = process.argv.slice(2)) {
+  const enabled = isTestMode(args4);
+  return (step, detail) => {
+    if (!enabled) {
+      return;
+    }
+    console.log(`[TRACE][${scope}] ${step}${detail ? ` | ${detail}` : ""}`);
+  };
+}
 function getNextFilePath(dir, baseName, extension) {
   let counter = 1;
   while (true) {
@@ -70,25 +82,60 @@ function getGitDiffFilter() {
   return { includeParams, excludeParams };
 }
 function openReport(reportPath) {
+  const resolvedPath = path.resolve(reportPath);
+  const { platform } = process;
+  const openWithChrome = () => {
+    if (platform === "darwin") {
+      execSync(`open -a "Google Chrome" "${resolvedPath}"`, { stdio: "ignore" });
+      return true;
+    }
+    if (platform === "linux") {
+      execSync(`google-chrome "${resolvedPath}"`, { stdio: "ignore" });
+      return true;
+    }
+    return false;
+  };
+  const openWithDefaultBrowser = () => {
+    if (platform === "darwin") {
+      execSync(`open "${resolvedPath}"`, { stdio: "ignore" });
+      return true;
+    }
+    if (platform === "linux") {
+      execSync(`xdg-open "${resolvedPath}"`, { stdio: "ignore" });
+      return true;
+    }
+    return false;
+  };
+  try {
+    if (openWithChrome()) {
+      console.log("\u{1F680} Google Chrome\uC5D0\uC11C \uB9AC\uD3EC\uD2B8\uB97C \uC5F4\uC5C8\uC2B5\uB2C8\uB2E4.");
+      return;
+    }
+  } catch {
+  }
   try {
-    execSync(`open -a "Google Chrome" "${path.resolve(reportPath)}"`);
-    console.log(`\u{1F680} \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB9AC\uD3EC\uD2B8\uB97C \uC5F4\uC5C8\uC2B5\uB2C8\uB2E4.`);
+    if (openWithDefaultBrowser()) {
+      console.log("\u{1F680} \uAE30\uBCF8 \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB9AC\uD3EC\uD2B8\uB97C \uC5F4\uC5C8\uC2B5\uB2C8\uB2E4.");
+      return;
+    }
   } catch (e) {
     console.error("\u26A0\uFE0F \uBE0C\uB77C\uC6B0\uC800 \uC5F4\uAE30 \uC2E4\uD328:", e);
+    return;
   }
+  console.error(`\u26A0\uFE0F \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD50C\uB7AB\uD3FC\uC785\uB2C8\uB2E4: ${platform}`);
 }
 function getDiffArgs() {
-  const args3 = process.argv.slice(2);
-  const commitIndex = args3.indexOf("--commit");
+  const args4 = process.argv.slice(2);
+  const commitIndex = args4.indexOf("--commit");
   const { includeParams, excludeParams } = getGitDiffFilter();
   let diffArgs = "";
   if (commitIndex !== -1) {
-    const commitHash = args3[commitIndex + 1];
+    const commitHash = args4[commitIndex + 1];
     if (!commitHash) {
       console.error("\u274C \uCEE4\uBC0B \uD574\uC2DC\uAC00 \uC81C\uACF5\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
       process.exit(1);
     }
-    const nextArg = args3[commitIndex + 2];
+    const nextArg = args4[commitIndex + 2];
     let n = 0;
     if (nextArg && !nextArg.startsWith("--")) {
       n = parseInt(nextArg, 10);
@@ -125,7 +172,9 @@ async function showSelectionAIService() {
     }
     firstRender = false;
     readline.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");
+    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"
+    );
     AIServices.forEach((service, index) => {
       if (index === selectedIndex) {
         process.stdout.write(` \x1B[36m>\x1B[0m \x1B[36m\u25C9\x1B[0m \x1B[1m${service}\x1B[0m
@@ -171,20 +220,26 @@ async function showSelectionAIService() {
   });
 }
 var args = process.argv.slice(2);
+var trace = createTraceLogger("claude-commander", args);
 var createClaudeCommand = (tempDiffPath2, reviewFormPath2) => {
+  trace("createClaudeCommand:start", `tempDiffPath=${tempDiffPath2}, reviewFormPath=${reviewFormPath2}`);
   let modelOption = "";
   if (args.includes("--review")) {
     modelOption = "--model opus";
+    trace("model:review", modelOption);
   } else if (args.includes("--flash")) {
     modelOption = "--model haiku";
+    trace("model:flash", modelOption);
   } else {
     const modelIndex = args.indexOf("--model");
     if (modelIndex !== -1 && args[modelIndex + 1]) {
       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.");
       modelOption = `--model ${args[modelIndex + 1]}`;
+      trace("model:custom", modelOption);
     } else {
       console.warn("\u26A0\uFE0F \uBAA8\uB378\uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uAE30\uBCF8 \uBAA8\uB378\uC778 sonnet\uC744 \uC0AC\uC6A9\uD569\uB2C8\uB2E4.");
       modelOption = "--model sonnet";
+      trace("model:default", modelOption);
     }
   }
   const rules = [
@@ -193,50 +248,151 @@ var createClaudeCommand = (tempDiffPath2, reviewFormPath2) => {
     { path: codingConventionRulesPath, display: "\uCF54\uB529 \uCEE8\uBCA4\uC158" }
   ];
   const systemPromptFiles = rules.filter((rule) => fs.existsSync(rule.path)).map((rule) => `--append-system-prompt-file ${rule.path}`).join(" ");
+  trace(
+    "rules:loaded",
+    `count=${systemPromptFiles ? systemPromptFiles.split("--append-system-prompt-file").length - 1 : 0}`
+  );
   const reviewFormOption = fs.existsSync(reviewFormPath2) ? `--append-system-prompt-file ${reviewFormPath2}` : "";
+  trace("reviewForm:status", reviewFormOption ? "exists" : "missing");
   const command = `cat ${tempDiffPath2} | claude ${modelOption} ${systemPromptFiles} ${reviewFormOption} -p "\uC704 \uADDC\uCE59\uB4E4\uC744 \uCC38\uACE0\uD558\uC5EC \uC774 diff\uB97C \uCF54\uB4DC\uB9AC\uBDF0\uD574\uC918. \uB9AC\uBDF0\uC591\uC2DD\uC5D0 \uB9DE\uCDB0\uC11C \uC791\uC131\uD574\uC918."`;
+  trace("command:created");
   if (args.includes("--test")) {
     const safeCommand = command.replace(/"/g, '\\"');
+    trace("test-mode:return-preview");
     return `echo "[TEST MODE] Claude \uBA85\uB839\uC5B4\uAC00 \uC2E4\uD589\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.
 
 \uC0DD\uC131\uB420 \uBA85\uB839\uC5B4 \uBBF8\uB9AC\uBCF4\uAE30:
 ${safeCommand}"`;
   }
+  trace("createClaudeCommand:end");
   return command;
 };
+var trace2 = createTraceLogger("installation-claude");
 function checkClaudeCliInstalled() {
+  trace2("checkClaudeCliInstalled:start");
   try {
+    trace2("version-check:run", "claude --version");
     execSync("claude --version", { stdio: "ignore" });
+    trace2("version-check:ok");
   } catch {
-    console.log("\u2139\uFE0F claude-cli\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4... npm install -g @anthropic-ai/claude-code");
+    trace2("version-check:failed", "install-start");
+    console.log(
+      "\u2139\uFE0F claude-cli\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4... npm install -g @anthropic-ai/claude-code"
+    );
     try {
       execSync("npm install -g @anthropic-ai/claude-code", { stdio: "inherit" });
+      trace2("install:ok", "exit(1) for login");
       console.log("\u2705 claude-cli \uC124\uCE58\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
       console.log("\u26A0\uFE0F  claude-cli \uC0AC\uC6A9\uC744 \uC704\uD574 \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.");
       console.log('   \uD130\uBBF8\uB110\uC5D0\uC11C "claude" \uB97C \uC785\uB825\uD558\uC5EC \uBE0C\uB77C\uC6B0\uC800 \uB85C\uADF8\uC778\uC744 \uC644\uB8CC\uD55C \uD6C4, \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694.');
       process.exit(1);
     } catch (installError) {
+      trace2("install:failed");
       console.error("\u274C claude-cli \uC124\uCE58 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. \uAD8C\uD55C \uBB38\uC81C\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4 (sudo \uD544\uC694).");
       console.error(installError);
       process.exit(1);
     }
   }
+  trace2("checkClaudeCliInstalled:end");
 }
 var args2 = process.argv.slice(2);
-var createGeminiCommand = (tempDiffPath2, reviewFormPath2) => {
+var trace3 = createTraceLogger("codex-commander", args2);
+var createCodexCommand = (tempDiffPath2, reviewFormPath2) => {
+  trace3("createCodexCommand:start", `tempDiffPath=${tempDiffPath2}, reviewFormPath=${reviewFormPath2}`);
   let modelOption = "";
   if (args2.includes("--review")) {
-    modelOption = "--model pro";
+    modelOption = "--model gpt-5";
+    trace3("model:review", modelOption);
   } else if (args2.includes("--flash")) {
-    modelOption = "--model flash";
+    modelOption = "--model gpt-5-mini";
+    trace3("model:flash", modelOption);
   } else {
     const modelIndex = args2.indexOf("--model");
     if (modelIndex !== -1 && args2[modelIndex + 1]) {
       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.");
       modelOption = `--model ${args2[modelIndex + 1]}`;
+      trace3("model:custom", modelOption);
+    } else {
+      console.warn("\u26A0\uFE0F \uBAA8\uB378\uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uAE30\uBCF8 \uBAA8\uB378\uC778 gpt-5-mini\uB97C \uC0AC\uC6A9\uD569\uB2C8\uB2E4.");
+      modelOption = "--model gpt-5-mini";
+      trace3("model:default", modelOption);
+    }
+  }
+  const rules = [rulesPath, namingRulesPath, codingConventionRulesPath].filter((filePath) => fs.existsSync(filePath)).map((filePath) => `- ${filePath}`).join("\n");
+  const rulesCount = rules ? rules.split("\n").length : 0;
+  trace3("rules:loaded", `count=${rulesCount}`);
+  const hasReviewForm = fs.existsSync(reviewFormPath2);
+  const reviewFormLine = hasReviewForm ? `- ${reviewFormPath2}` : "";
+  trace3("reviewForm:status", reviewFormLine ? "exists" : "missing");
+  const prompt = `\uC544\uB798 \uD30C\uC77C\uB4E4\uC744 \uCC38\uACE0\uD574\uC11C \uCF54\uB4DC \uB9AC\uBDF0\uB97C \uC9C4\uD589\uD574\uC918.
+\uADDC\uCE59 \uD30C\uC77C: 
+${rules || "- (\uC5C6\uC74C)"}
+\uB9AC\uBDF0 \uC591\uC2DD \uD30C\uC77C:
+${reviewFormLine || "- (\uC5C6\uC74C)"}
+\uB9AC\uBDF0 \uB300\uC0C1 diff \uD30C\uC77C:
+- ${tempDiffPath2}
+
+\uBC18\uB4DC\uC2DC \uB9AC\uBDF0 \uC591\uC2DD\uC5D0 \uB9DE\uCDB0 \uC791\uC131\uD574\uC918.`;
+  const command = `codex exec ${modelOption} "${prompt.replace(/"/g, '\\"')}"`;
+  trace3("command:created");
+  if (args2.includes("--test")) {
+    const safeCommand = command.replace(/"/g, '\\"');
+    trace3("test-mode:return-preview");
+    return `echo "[TEST MODE] Codex \uBA85\uB839\uC5B4\uAC00 \uC2E4\uD589\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.
+
+\uC0DD\uC131\uB420 \uBA85\uB839\uC5B4 \uBBF8\uB9AC\uBCF4\uAE30:
+${safeCommand}"`;
+  }
+  trace3("createCodexCommand:end");
+  return command;
+};
+var trace4 = createTraceLogger("installation-codex");
+function checkCodexCliInstalled() {
+  trace4("checkCodexCliInstalled:start");
+  try {
+    trace4("version-check:run", "codex --version");
+    execSync("codex --version", { stdio: "ignore" });
+    trace4("version-check:ok");
+  } catch {
+    trace4("version-check:failed", "install-start");
+    console.log("\u2139\uFE0F codex-cli\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4... npm install -g @openai/codex");
+    try {
+      execSync("npm install -g @openai/codex", { stdio: "inherit" });
+      trace4("install:ok", "exit(1) for login");
+      console.log("\u2705 codex-cli \uC124\uCE58\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+      console.log("\u26A0\uFE0F codex-cli \uC0AC\uC6A9\uC744 \uC704\uD574 \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.");
+      console.log('   \uD130\uBBF8\uB110\uC5D0\uC11C "codex login" \uC744 \uC785\uB825\uD558\uC5EC \uB85C\uADF8\uC778\uC744 \uC644\uB8CC\uD55C \uD6C4, \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694.');
+      process.exit(1);
+    } catch (installError) {
+      trace4("install:failed");
+      console.error("\u274C codex-cli \uC124\uCE58 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. \uAD8C\uD55C \uBB38\uC81C\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4 (sudo \uD544\uC694).");
+      console.error(installError);
+      process.exit(1);
+    }
+  }
+  trace4("checkCodexCliInstalled:end");
+}
+var args3 = process.argv.slice(2);
+var trace5 = createTraceLogger("gemini-commander", args3);
+var createGeminiCommand = (tempDiffPath2, reviewFormPath2) => {
+  trace5("createGeminiCommand:start", `tempDiffPath=${tempDiffPath2}, reviewFormPath=${reviewFormPath2}`);
+  let modelOption = "";
+  if (args3.includes("--review")) {
+    modelOption = "--model pro";
+    trace5("model:review", modelOption);
+  } else if (args3.includes("--flash")) {
+    modelOption = "--model flash";
+    trace5("model:flash", modelOption);
+  } else {
+    const modelIndex = args3.indexOf("--model");
+    if (modelIndex !== -1 && args3[modelIndex + 1]) {
+      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.");
+      modelOption = `--model ${args3[modelIndex + 1]}`;
+      trace5("model:custom", modelOption);
     } else {
       console.warn("\u26A0\uFE0F \uBAA8\uB378\uC774 \uC9C0\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uAE30\uBCF8 \uBAA8\uB378\uC778 gemini-flash\uB97C \uC0AC\uC6A9\uD569\uB2C8\uB2E4.");
       modelOption = "--model flash";
+      trace5("model:default", modelOption);
     }
   }
   const rules = [
@@ -245,68 +401,110 @@ var createGeminiCommand = (tempDiffPath2, reviewFormPath2) => {
     { path: codingConventionRulesPath, display: "\uCF54\uB529 \uCEE8\uBCA4\uC158" }
   ];
   const validRules = rules.filter((rule) => fs.existsSync(rule.path)).map((rule) => `@${rule.path}`).join(", ");
+  const rulesCount = validRules ? validRules.split(",").length : 0;
+  trace5("rules:loaded", `count=${rulesCount}`);
   const command = `gemini ${modelOption} -p "\uB2E4\uC74C \uADDC\uCE59\uB4E4\uC744 \uCC38\uACE0\uD574\uC11C(${validRules}) \uC774 diff(@${tempDiffPath2})\uB97C \uB9AC\uBDF0\uD574\uC918. \uB9AC\uBDF0\uC591\uC2DD\uC740 @${reviewFormPath2} \uC5D0 \uB9DE\uCDB0\uC11C \uC791\uC131\uD574\uC918. "`;
-  if (args2.includes("--test")) {
+  trace5("command:created");
+  if (args3.includes("--test")) {
     const safeCommand = command.replace(/"/g, '\\"');
+    trace5("test-mode:return-preview");
     return `echo "[TEST MODE] Gemini \uBA85\uB839\uC5B4\uAC00 \uC2E4\uD589\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.
 
 \uC0DD\uC131\uB420 \uBA85\uB839\uC5B4 \uBBF8\uB9AC\uBCF4\uAE30:
 ${safeCommand}"`;
   }
+  trace5("createGeminiCommand:end");
   return command;
 };
+var trace6 = createTraceLogger("installation-gemini");
 function checkGeminiCliInstalled() {
+  trace6("checkGeminiCliInstalled:start");
   try {
+    trace6("version-check:run", "gemini --version");
     execSync("gemini --version", { stdio: "ignore" });
+    trace6("version-check:ok");
   } catch {
+    trace6("version-check:failed", "install-start");
     console.log("\u2139\uFE0F gemini-cli\uAC00 \uC124\uCE58\uB418\uC5B4 \uC788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC124\uCE58\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4... npm install -g @google/gemini-cli");
     try {
       execSync("npm install -g @google/gemini-cli", { stdio: "inherit" });
+      trace6("install:ok", "exit(1) for login");
       console.log("\u2705 gemini-cli \uC124\uCE58\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
       console.log("\u26A0\uFE0F  Gemini API \uC0AC\uC6A9\uC744 \uC704\uD574 \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.");
       console.log('   \uD130\uBBF8\uB110\uC5D0\uC11C "gemini" \uB97C \uC785\uB825\uD558\uC5EC \uBE0C\uB77C\uC6B0\uC800 \uB85C\uADF8\uC778\uC744 \uC644\uB8CC\uD55C \uD6C4, \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694.');
       process.exit(1);
     } catch (installError) {
+      trace6("install:failed");
       console.error("\u274C gemini-cli \uC124\uCE58 \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. \uAD8C\uD55C \uBB38\uC81C\uC77C \uC218 \uC788\uC2B5\uB2C8\uB2E4 (sudo \uD544\uC694).");
       console.error(installError);
       process.exit(1);
     }
   }
+  trace6("checkGeminiCliInstalled:end");
 }
 
 // src/pr-review/review.ts
 async function main() {
-  const args3 = process.argv.slice(2);
-  const isTest = args3.includes("--test");
+  const args4 = process.argv.slice(2);
+  const isTest = isTestMode(args4);
+  const trace7 = createTraceLogger("review", args4);
+  trace7("main:start", `args=${JSON.stringify(args4)}`);
+  trace7("service-selection:start");
   const service = await showSelectionAIService();
+  trace7("service-selection:done", `service=${service}`);
   switch (service) {
     case "gemini":
+      trace7("install-check:start", "service=gemini");
       checkGeminiCliInstalled();
+      trace7("install-check:done", "service=gemini");
       break;
     case "claude":
+      trace7("install-check:start", "service=claude");
       checkClaudeCliInstalled();
+      trace7("install-check:done", "service=claude");
+      break;
+    case "codex":
+      trace7("install-check:start", "service=codex");
+      checkCodexCliInstalled();
+      trace7("install-check:done", "service=codex");
       break;
   }
   try {
+    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 = execSync(`git diff ${diffArgs} -- ${includeParams} ${excludeParams}`).toString();
+      trace7("git-diff:done", `length=${diff.length}`);
     } catch {
+      trace7("git-diff:error", "fallback-empty-diff");
     }
     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).");
       deleteTempDiff();
       process.exit(0);
     }
+    trace7("temp-diff:write:start", tempDiffPath);
     fs.writeFileSync(tempDiffPath, diff);
+    trace7("temp-diff:write:done");
+    trace7("saved-diff:copy:start");
     const savedDiffPath = getNextFilePath(REPORT_DIR, `${nowStr}-diff`, ".txt");
     fs.copyFileSync(tempDiffPath, savedDiffPath);
+    trace7("saved-diff:copy:done", savedDiffPath);
     let command = "";
+    trace7("command:create:start", `service=${service}`);
     switch (service) {
       case "gemini":
         command = createGeminiCommand(tempDiffPath, reviewFormPath);
@@ -315,29 +513,45 @@ async function main() {
         command = createClaudeCommand(tempDiffPath, reviewFormPath);
         break;
       case "codex":
+        command = createCodexCommand(tempDiffPath, reviewFormPath);
         break;
     }
+    trace7("command:create:done");
+    trace7("command:exec:start");
     const result = execSync(command).toString();
+    trace7("command:exec:done", `resultLength=${result.length}`);
     console.log(result);
+    trace7("report:write:start");
     const savedReportPath = getNextFilePath(REPORT_DIR, nowStr, ".md");
     fs.writeFileSync(savedReportPath, result);
+    trace7("report:write:done", savedReportPath);
     if (isTest) {
+      trace7("test-command:append:start");
       fs.appendFileSync(savedReportPath, `
 
 ## \uC0AC\uC6A9\uB41C \uBA85\uB839\uC5B4
 
 ${command}`);
+      trace7("test-command:append:done");
     }
     console.log(`
 \u2705 \uB9AC\uBDF0\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
     console.log(`\u{1F4C4} \uB9AC\uD3EC\uD2B8 \uC800\uC7A5 \uC704\uCE58: ${savedReportPath}`);
     console.log(`diff \uC800\uC7A5 \uC704\uCE58: ${savedDiffPath}`);
+    trace7("open-report:start");
     openReport(savedReportPath);
+    trace7("open-report:done");
+    trace7("cleanup-temp-diff:start");
     deleteTempDiff();
+    trace7("cleanup-temp-diff:done");
+    trace7("review-flow:end");
   } catch (error) {
+    trace7("review-flow:catch");
     console.error("\u274C \uB9AC\uBDF0 \uB3C4\uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.");
     console.error(error);
+    trace7("cleanup-temp-diff:start(catch)");
     deleteTempDiff();
+    trace7("cleanup-temp-diff:done(catch)");
     process.exit(1);
   }
 }