mimi-seed 0.2.9 → 0.2.10

package/dist/index.js

@@ -4,9 +4,9 @@ import {
 } from "./chunk-Q5YGYAFK.js";
 
 // src/index.ts
-import os5 from "os";
-import fs6 from "fs";
-import path6 from "path";
+import os6 from "os";
+import fs7 from "fs";
+import path7 from "path";
 import kleur9 from "kleur";
 import open from "open";
 
@@ -460,8 +460,25 @@ async function cmdCheck(argv) {
 `);
       process.stdout.write("\n");
     }
+    const base = `${cfg.webBase}/apps/${appId}`;
+    const nextSteps = [];
+    if (data.modules) {
+      if ((data.modules.integration ?? 25) < 25) nextSteps.push(`\uC5F0\uACB0 \uC9C4\uB2E8    ${base}/integration`);
+      if ((data.modules.copy ?? 25) < 25) nextSteps.push(`\uBB38\uAD6C \uBCF4\uAC15    mimi-seed notes  \uB610\uB294  ${base}/copy`);
+      if ((data.modules.screenshot ?? 25) < 25) nextSteps.push(`\uC2A4\uD06C\uB9B0\uC0F7     ${base}/screenshots`);
+      if ((data.modules.checklist ?? 25) < 25) nextSteps.push(`\uCCB4\uD06C\uB9AC\uC2A4\uD2B8   ${base}/launch`);
+    }
+    if (nextSteps.length) {
+      process.stdout.write(kleur2.bold("\u2192 \uB2E4\uC74C \uB2E8\uACC4:\n"));
+      for (const s of nextSteps) process.stdout.write(`  ${kleur2.cyan("\u2022")} ${s}
+`);
+      process.stdout.write(kleur2.dim(`  \uBBF8\uB9AC\uBCF4\uAE30: mimi-seed deploy --dry-run
+
+`));
+    }
     if (!hasBlocker) {
-      process.stdout.write(score >= 80 ? kleur2.green("\u2713 \uCD9C\uC2DC \uC900\uBE44 \uC644\uB8CC!\n") : kleur2.yellow("\uC810\uC218\uB97C \uB192\uC774\uB824\uBA74 \uB300\uC2DC\uBCF4\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.\n"));
+      process.stdout.write(score >= 80 ? kleur2.green("\u2713 \uCD9C\uC2DC \uC900\uBE44 \uC644\uB8CC!\n") : kleur2.yellow(`\uC544\uC9C1 ${score}/100 \u2014 \uC704 \uB2E4\uC74C \uB2E8\uACC4\uB97C \uC9C4\uD589\uD558\uC138\uC694.
+`));
     }
   } catch {
     for (const line of readinessResult.text.split("\n")) process.stdout.write("  " + line + "\n");
@@ -599,6 +616,7 @@ async function cmdNotes(argv) {
     return;
   }
   let selectedText = result.concise;
+  let userSelectedTone = false;
   if (shouldPrompt) {
     const choice = await promptUser("\uC801\uC6A9\uD560 \uBC84\uC804 [1=\uAC04\uACB0/2=\uC0C1\uC138/3=\uB9C8\uCF00\uD305/Enter=\uAC74\uB108\uB700]: ");
     if (!choice) {
@@ -607,6 +625,7 @@ async function cmdNotes(argv) {
     }
     if (choice === "2") selectedText = result.detailed;
     else if (choice === "3") selectedText = result.marketing;
+    userSelectedTone = true;
   }
   const appsResult = await mcpCall(cfg.endpoint, cfg.token, "list_apps", {});
   if (appsResult.isError) {
@@ -619,13 +638,17 @@ async function cmdNotes(argv) {
     process.stdout.write(kleur3.yellow("\uB4F1\uB85D\uB41C \uC571\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n"));
     return;
   }
+  if (userSelectedTone && args.locales.length > 1) {
+    process.stdout.write(kleur3.dim("\uC120\uD0DD\uD55C \uD1A4\uC744 \uBAA8\uB4E0 \uB85C\uCF00\uC77C\uC5D0 \uC801\uC6A9\uD569\uB2C8\uB2E4 (\uC790\uB3D9 \uBC88\uC5ED \uBBF8\uC801\uC6A9).\n"));
+  }
   process.stdout.write("Play Store\uC5D0 \uC801\uC6A9 \uC911...\n");
   for (const locale of args.locales) {
+    const text = userSelectedTone ? selectedText : result.localized[locale] ?? selectedText;
     const r = await mcpCall(cfg.endpoint, cfg.token, "apply_release_notes", {
       app_id: app.id,
       platform: "android",
       locale,
-      text: result.localized[locale] ?? selectedText
+      text
     });
     process.stdout.write(r.isError ? kleur3.red(`${locale} \uC801\uC6A9 \uC2E4\uD328: ${r.text}
 `) : kleur3.green(`\u2713 ${locale} \uC801\uC6A9\uB428
@@ -783,30 +806,42 @@ async function cmdReview(argv) {
 
 // src/auth.ts
 import { spawn } from "child_process";
+import fs3 from "fs";
+import os2 from "os";
+import path3 from "path";
 import kleur5 from "kleur";
 var MCP_PKG = "@yoonion/mimi-seed-mcp";
+var MIMI_DIR = path3.join(os2.homedir(), ".mimi-seed");
 function log(msg) {
   process.stdout.write(msg + "\n");
 }
 function printAuthHelp() {
-  log(`${kleur5.bold("mimi-seed auth")} \u2014 Google OAuth \uC778\uC99D (Firebase / AdMob / Play Store)
+  log(`${kleur5.bold("mimi-seed auth")} \u2014 \uB85C\uCEEC \uC790\uACA9\uC99D\uBA85 \uC778\uC99D/\uAD00\uB9AC
+
+${kleur5.bold("Google OAuth (Firebase / AdMob / Play):")}
+  ${kleur5.cyan("mimi-seed auth login")}      \uBE0C\uB77C\uC6B0\uC800\uB85C \uB85C\uADF8\uC778 (\uC774\uBBF8 \uC788\uC73C\uBA74 \uC790\uB3D9 refresh \uC2DC\uB3C4)
+  ${kleur5.cyan("mimi-seed auth status")}     \uD604\uC7AC OAuth \uD1A0\uD070 \uC0C1\uD0DC
+  ${kleur5.cyan("mimi-seed auth refresh")}    refresh_token\uC73C\uB85C \uAC31\uC2E0\uB9CC \uC2DC\uB3C4 (\uBE0C\uB77C\uC6B0\uC800 X)
+  ${kleur5.cyan("mimi-seed auth logout")}     OAuth \uD1A0\uD070 \uC0AD\uC81C
+
+${kleur5.bold("\uD50C\uB7AB\uD3FC\uBCC4 \uC790\uACA9\uC99D\uBA85:")}
+  ${kleur5.cyan("mimi-seed auth appstore")}   App Store Connect API \uD0A4 (appstore.json)
+  ${kleur5.cyan("mimi-seed auth playstore")}  Play \uC11C\uBE44\uC2A4 \uACC4\uC815 JSON \uB4F1\uB85D
+  ${kleur5.cyan("mimi-seed auth bigquery")}   BigQuery \uC11C\uBE44\uC2A4 \uACC4\uC815 (Crashlytics export \uB4F1)
 
-${kleur5.bold("\uC11C\uBE0C\uBA85\uB839:")}
-  ${kleur5.cyan("mimi-seed auth login")}     \uBE0C\uB77C\uC6B0\uC800\uB85C \uB85C\uADF8\uC778 (\uC774\uBBF8 \uC788\uC73C\uBA74 \uC790\uB3D9 refresh \uC2DC\uB3C4)
-  ${kleur5.cyan("mimi-seed auth status")}    \uD604\uC7AC \uD1A0\uD070 \uC0C1\uD0DC
-  ${kleur5.cyan("mimi-seed auth refresh")}   refresh_token\uC73C\uB85C \uAC31\uC2E0\uB9CC \uC2DC\uB3C4 (\uBE0C\uB77C\uC6B0\uC800 X)
-  ${kleur5.cyan("mimi-seed auth logout")}    \uD1A0\uD070 \uC0AD\uC81C
+${kleur5.bold("\uC804\uCCB4 \uC0C1\uD0DC:")}
+  ${kleur5.cyan("mimi-seed auth status --all")}  4\uAC1C \uC790\uACA9\uC99D\uBA85 \uBCF4\uC720 \uC5EC\uBD80 \uD55C\uB208\uC5D0
 
 ${kleur5.bold("login \uC635\uC158:")}
   --no-browser     URL \uC790\uB3D9 \uC624\uD508 \uC548 \uD568 (\uC9C1\uC811 \uBCF5\uBD99)
   --timeout <\uCD08>   \uCF5C\uBC31 \uB300\uAE30 \uC2DC\uAC04 (\uAE30\uBCF8 600)
   --force          \uAE30\uC874 \uD1A0\uD070 \uBB34\uC2DC\uD558\uACE0 \uAC15\uC81C \uC7AC\uB85C\uADF8\uC778
 
-${kleur5.dim(`\uB0B4\uBD80\uC801\uC73C\uB85C ${MCP_PKG} \uC758 mimi-seed-auth CLI\uB97C \uD638\uCD9C\uD569\uB2C8\uB2E4.`)}`);
+${kleur5.dim(`\uB0B4\uBD80\uC801\uC73C\uB85C ${MCP_PKG} \uC758 mimi-seed-*-auth CLI\uB97C \uD638\uCD9C\uD569\uB2C8\uB2E4.`)}`);
 }
-async function runMcpAuth(extraArgs) {
+async function runMcpBin(bin, extraArgs) {
   return new Promise((resolve) => {
-    const child = spawn("npx", ["-y", `${MCP_PKG}`, "mimi-seed-auth", ...extraArgs], {
+    const child = spawn("npx", ["-y", `${MCP_PKG}`, bin, ...extraArgs], {
       stdio: "inherit",
       shell: true
     });
@@ -819,6 +854,30 @@ async function runMcpAuth(extraArgs) {
     child.on("exit", (code) => resolve(code ?? 0));
   });
 }
+function fileExists(name) {
+  return fs3.existsSync(path3.join(MIMI_DIR, name));
+}
+function anyFileStarting(prefix) {
+  try {
+    return fs3.readdirSync(MIMI_DIR).some((f) => f.startsWith(prefix));
+  } catch {
+    return false;
+  }
+}
+function printAllCredStatus() {
+  log(kleur5.bold("\uB85C\uCEEC \uC790\uACA9\uC99D\uBA85 \uC0C1\uD0DC  ") + kleur5.dim("(~/.mimi-seed)"));
+  const rows = [
+    ["Google OAuth (Firebase/AdMob/Play)", fileExists("tokens.json"), "mimi-seed auth login"],
+    ["App Store Connect", fileExists("appstore.json"), "mimi-seed auth appstore"],
+    ["Play \uC11C\uBE44\uC2A4 \uACC4\uC815", anyFileStarting("play-service-account"), "mimi-seed auth playstore"],
+    ["BigQuery \uC11C\uBE44\uC2A4 \uACC4\uC815", anyFileStarting("bigquery"), "mimi-seed auth bigquery"]
+  ];
+  for (const [label, ok2, cmd] of rows) {
+    const mark = ok2 ? kleur5.green("\u2713") : kleur5.red("\u2717");
+    const hint = ok2 ? "" : kleur5.dim(`  \u2192 ${cmd}`);
+    log(`  ${mark} ${label}${hint}`);
+  }
+}
 async function cmdAuth(args) {
   const sub = args[0];
   const rest = args.slice(1);
@@ -826,6 +885,13 @@ async function cmdAuth(args) {
     printAuthHelp();
     return;
   }
+  if (sub === "status" && rest.includes("--all")) {
+    printAllCredStatus();
+    return;
+  }
+  if (sub === "appstore") return void exitWith(await runMcpBin("mimi-seed-appstore-auth", rest));
+  if (sub === "playstore") return void exitWith(await runMcpBin("mimi-seed-playstore-auth", rest));
+  if (sub === "bigquery") return void exitWith(await runMcpBin("mimi-seed-bigquery-auth", rest));
   let mcpArgs;
   switch (sub) {
     case void 0:
@@ -846,7 +912,9 @@ async function cmdAuth(args) {
       printAuthHelp();
       process.exit(1);
   }
-  const code = await runMcpAuth(mcpArgs);
+  exitWith(await runMcpBin("mimi-seed-auth", mcpArgs));
+}
+function exitWith(code) {
   if (code !== 0) process.exit(code);
 }
 
@@ -855,25 +923,25 @@ import kleur6 from "kleur";
 import * as readline from "readline";
 
 // src/ci-providers.ts
-import fs3 from "fs";
-import path3 from "path";
-import os2 from "os";
-var CI_CONFIG_PATH = path3.join(os2.homedir(), ".mimi-seed", "ci.json");
+import fs4 from "fs";
+import path4 from "path";
+import os3 from "os";
+var CI_CONFIG_PATH = path4.join(os3.homedir(), ".mimi-seed", "ci.json");
 function loadCiProviderConfig() {
   try {
-    return JSON.parse(fs3.readFileSync(CI_CONFIG_PATH, "utf-8"));
+    return JSON.parse(fs4.readFileSync(CI_CONFIG_PATH, "utf-8"));
   } catch {
     return null;
   }
 }
 function saveCiProviderConfig(cfg) {
-  const dir = path3.dirname(CI_CONFIG_PATH);
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true, mode: 448 });
+  const dir = path4.dirname(CI_CONFIG_PATH);
+  if (!fs4.existsSync(dir)) {
+    fs4.mkdirSync(dir, { recursive: true, mode: 448 });
   }
-  fs3.writeFileSync(CI_CONFIG_PATH, JSON.stringify(cfg, null, 2));
+  fs4.writeFileSync(CI_CONFIG_PATH, JSON.stringify(cfg, null, 2));
   if (process.platform !== "win32") {
-    fs3.chmodSync(CI_CONFIG_PATH, 384);
+    fs4.chmodSync(CI_CONFIG_PATH, 384);
   }
 }
 function ghBase(cfg) {
@@ -1110,6 +1178,7 @@ function parseArgs4(argv) {
     platform: "android",
     language: "ko-KR",
     dryRun: false,
+    yes: false,
     skipBuild: false,
     setupJenkins: false,
     setupGithub: false,
@@ -1125,6 +1194,7 @@ function parseArgs4(argv) {
     if (argv[i] === "--to" && argv[i + 1]) args.toRef = argv[++i];
     if (argv[i] === "--language" && argv[i + 1]) args.language = argv[++i];
     if (argv[i] === "--dry-run") args.dryRun = true;
+    if (argv[i] === "--yes" || argv[i] === "-y") args.yes = true;
     if (argv[i] === "--skip-build") args.skipBuild = true;
     if (argv[i] === "--ci" && argv[i + 1]) args.ci = argv[++i];
     if (argv[i] === "--workflow" && argv[i + 1]) args.workflow = argv[++i];
@@ -1336,6 +1406,21 @@ async function cmdDeploy(argv) {
     log2(kleur6.red("appId\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. --app <id> \uB85C \uC9C0\uC815\uD558\uAC70\uB098 `mimi-seed init` \uC73C\uB85C \uC571 \uB4F1\uB85D."));
     process.exit(1);
   }
+  const needsConfirm = !args.dryRun && !args.yes && process.stdout.isTTY && !process.env.MIMI_SEED_TOKEN;
+  if (needsConfirm) {
+    const target = args.platform === "ios" ? "App Store \uC2EC\uC0AC \uC81C\uCD9C" : "Play Store production \uD2B8\uB799";
+    log2("");
+    log2(kleur6.yellow(`\u26A0 \uC2E4\uC81C \uBC30\uD3EC: ${args.platform} \xB7 versionCode ${versionCode} \u2192 ${target}`));
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise(
+      (resolve) => rl.question(kleur6.bold("\uACC4\uC18D \uC9C4\uD589\uD560\uAE4C\uC694? [y/N]: "), (a) => resolve(a.trim().toLowerCase()))
+    );
+    rl.close();
+    if (answer !== "y" && answer !== "yes") {
+      log2(kleur6.dim("\uCDE8\uC18C\uB428. (--yes \uB85C \uD655\uC778 \uC0DD\uB7B5 \uAC00\uB2A5)"));
+      return;
+    }
+  }
   log2("");
   log2("\u{1F4E1} \uC11C\uBC84 \uBC30\uD3EC \uD30C\uC774\uD504\uB77C\uC778 \uC2DC\uC791...");
   log2("");
@@ -1357,17 +1442,17 @@ async function cmdDeploy(argv) {
 
 // src/mcp-restart.ts
 import { execSync as execSync2 } from "child_process";
-import fs4 from "fs";
-import os3 from "os";
-import path4 from "path";
+import fs5 from "fs";
+import os4 from "os";
+import path5 from "path";
 import kleur7 from "kleur";
 function log3(msg) {
   process.stdout.write(msg + "\n");
 }
 function readClaudeJson() {
-  const p = path4.join(os3.homedir(), ".claude.json");
+  const p = path5.join(os4.homedir(), ".claude.json");
   try {
-    return JSON.parse(fs4.readFileSync(p, "utf8"));
+    return JSON.parse(fs5.readFileSync(p, "utf8"));
   } catch {
     return {};
   }
@@ -1383,7 +1468,7 @@ function findProcessMarker(cfg) {
   return meaningful.at(-1) ?? null;
 }
 function killByMarker(marker) {
-  const isWin = os3.platform() === "win32";
+  const isWin = os4.platform() === "win32";
   if (isWin) {
     const escaped = marker.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
     let pids = [];
@@ -1454,9 +1539,9 @@ async function cmdRestart(args) {
 }
 
 // src/mcp-config.ts
-import fs5 from "fs/promises";
-import path5 from "path";
-import os4 from "os";
+import fs6 from "fs/promises";
+import path6 from "path";
+import os5 from "os";
 import kleur8 from "kleur";
 var SERVER_NAME = "mimi-seed";
 function tomlString(value) {
@@ -1496,17 +1581,17 @@ function printMcpSetup(cfg) {
   );
 }
 async function writeCodexMcpConfig(cfg) {
-  const configDir = path5.join(os4.homedir(), ".codex");
-  const configPath = path5.join(configDir, "config.toml");
-  await fs5.mkdir(configDir, { recursive: true });
+  const configDir = path6.join(os5.homedir(), ".codex");
+  const configPath = path6.join(configDir, "config.toml");
+  await fs6.mkdir(configDir, { recursive: true });
   let current = "";
   try {
-    current = await fs5.readFile(configPath, "utf8");
+    current = await fs6.readFile(configPath, "utf8");
   } catch {
     current = "";
   }
   const next = replaceTomlBlock(current, `mcp_servers.${SERVER_NAME}`, codexBlock(cfg));
-  await fs5.writeFile(configPath, next);
+  await fs6.writeFile(configPath, next);
   return configPath;
 }
 
@@ -1551,7 +1636,7 @@ async function cmdInit() {
     return;
   }
   log4("\u{1F510} \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB85C\uADF8\uC778 \uB300\uAE30...");
-  const hostName = os5.hostname().slice(0, 32);
+  const hostName = os6.hostname().slice(0, 32);
   const name = `cli-${hostName}`;
   const { port, promise } = await awaitHandshake(5 * 60 * 1e3);
   const callback = `http://127.0.0.1:${port}/cb`;
@@ -1617,16 +1702,16 @@ async function cmdInit() {
     "- `/mimi-seed:health` \u2014 \uC5F0\uACB0 \uC0C1\uD0DC \uBE60\uB978 \uD655\uC778",
     "- `/mimi-seed:review-inbox` \u2014 \uBBF8\uB2F5\uBCC0 \uB9AC\uBDF0 \uB2F5\uBCC0"
   ].join("\n");
-  const claudeDir = path6.join(cwd, ".claude");
-  const claudeAgentPath = path6.join(claudeDir, "mimi-seed.md");
-  if (!fs6.existsSync(claudeAgentPath)) {
-    fs6.mkdirSync(claudeDir, { recursive: true });
-    fs6.writeFileSync(claudeAgentPath, agentMd, { mode: 420 });
+  const claudeDir = path7.join(cwd, ".claude");
+  const claudeAgentPath = path7.join(claudeDir, "mimi-seed.md");
+  if (!fs7.existsSync(claudeAgentPath)) {
+    fs7.mkdirSync(claudeDir, { recursive: true });
+    fs7.writeFileSync(claudeAgentPath, agentMd, { mode: 420 });
     log4(kleur9.dim(`  Claude \uC5D0\uC774\uC804\uD2B8 \uC124\uC815: .claude/mimi-seed.md`));
   }
-  const codexAgentPath = path6.join(cwd, "AGENTS.md");
-  if (!fs6.existsSync(codexAgentPath)) {
-    fs6.writeFileSync(codexAgentPath, agentMd, { mode: 420 });
+  const codexAgentPath = path7.join(cwd, "AGENTS.md");
+  if (!fs7.existsSync(codexAgentPath)) {
+    fs7.writeFileSync(codexAgentPath, agentMd, { mode: 420 });
     log4(kleur9.dim(`  Codex \uC5D0\uC774\uC804\uD2B8 \uC124\uC815: AGENTS.md`));
   }
   log4(kleur9.bold("\u2713 \uC900\uBE44 \uC644\uB8CC."));
@@ -1675,6 +1760,7 @@ async function cmdMcp(args) {
       const configPath = await writeCodexMcpConfig(cfg);
       log4(kleur9.green("\u2713 Codex MCP \uC124\uC815 \uC644\uB8CC"));
       log4(kleur9.dim(`  ${configPath}`));
+      log4(kleur9.dim("  \u26A0 config.toml\uC5D0 \uC2E4\uC81C \uD1A0\uD070\uC774 \uD3C9\uBB38\uC73C\uB85C \uC800\uC7A5\uB429\uB2C8\uB2E4 (\uD30C\uC77C \uAD8C\uD55C \uD655\uC778 \uAD8C\uC7A5)."));
       log4("");
       log4("Codex\uB97C \uC0C8\uB85C \uC5F4\uACE0 `/mcp` \uB610\uB294 `codex mcp list`\uB85C \uD655\uC778\uD558\uC138\uC694.");
       return;
@@ -1699,35 +1785,34 @@ http_headers = { Authorization = "Bearer ${cfg.prefix}..." }`);
   }
   printMcpSetup(cfg);
 }
-function printHelp() {
-  log4(`${kleur9.bold("mimi-seed")} \u2014 Claude Code/Codex\uC5D0\uC11C \uC571 \uCD9C\uC2DC \uC6B4\uC601
+var CMD_USAGE = {
+  init: `${kleur9.bold("mimi-seed init")} \u2014 \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uB97C Mimi Seed\uC5D0 \uC5F0\uACB0
 
-${kleur9.bold("\uBA85\uB839\uC5B4:")}
-  ${kleur9.cyan("mimi-seed init")}        \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uB97C Mimi Seed\uC5D0 \uC5F0\uACB0
-  ${kleur9.cyan("mimi-seed status")}      \uC5F0\uACB0 \uC0C1\uD0DC + \uB4F1\uB85D \uC571 \uBAA9\uB85D
-  ${kleur9.cyan("mimi-seed auth")}        Google OAuth \uC778\uC99D (Firebase/AdMob/Play). 'mimi-seed auth --help'
-  ${kleur9.cyan("mimi-seed doctor")}      \uD658\uACBD \uC9C4\uB2E8 (\uD1A0\uD070\xB7Git\xB7\uD504\uB85C\uC81D\uD2B8\xB7CI \uCCB4\uD06C)
-  ${kleur9.cyan("mimi-seed check")}       \uCD9C\uC2DC \uC804 Readiness \uC810\uAC80
-  ${kleur9.cyan("mimi-seed notes")}       \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC0DD\uC131 (git log \u2192 AI \u2192 \uB9C8\uCF13 \uC801\uC6A9)
-  ${kleur9.cyan("mimi-seed review")}      \uB9AC\uBDF0 \uB2F5\uBCC0 AI \uCD08\uC548 \uC0DD\uC131 \uBC0F Play Store \uAC8C\uC2DC
-  ${kleur9.cyan("mimi-seed deploy")}      \uC571 \uC790\uB3D9 \uBC30\uD3EC (Jenkins \u2192 Play Store/App Store)
-  ${kleur9.cyan("mimi-seed mcp")}         Claude/Codex MCP \uC5F0\uACB0 \uC548\uB0B4 \uBC0F Codex \uC124\uC815 \uC4F0\uAE30
-  ${kleur9.cyan("mimi-seed restart")}     MCP \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC7AC\uC2DC\uC791 (\uAE30\uBCF8: mimi-seed)
-  ${kleur9.cyan("mimi-seed logout")}      \uB85C\uCEEC \uC124\uC815 \uC0AD\uC81C
+\uC571 \uC790\uB3D9 \uAC10\uC9C0(Expo/Gradle/Info.plist/pbxproj) \u2192 \uBE0C\uB77C\uC6B0\uC800 PAT \uBC1C\uAE09 \u2192 \uC571 \uB4F1\uB85D
++ .claude/mimi-seed.md, AGENTS.md \uC0DD\uC131. \uC635\uC158 \uC5C6\uC74C.`,
+  status: `${kleur9.bold("mimi-seed status")} \u2014 \uC5F0\uACB0 \uC0C1\uD0DC + \uB4F1\uB85D \uC571 \uBAA9\uB85D. \uC635\uC158 \uC5C6\uC74C.`,
+  doctor: `${kleur9.bold("mimi-seed doctor")} \u2014 \uD658\uACBD \uC9C4\uB2E8 (\uD1A0\uD070\xB7Node\xB7Git\xB7\uD504\uB85C\uC81D\uD2B8\xB7CI). \uC635\uC158 \uC5C6\uC74C.`,
+  logout: `${kleur9.bold("mimi-seed logout")} \u2014 \uB85C\uCEEC \uC124\uC815(config.json) \uC0AD\uC81C. \uC635\uC158 \uC5C6\uC74C.`,
+  restart: `${kleur9.bold("mimi-seed restart")} \u2014 MCP \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC7AC\uC2DC\uC791 (\uAE30\uBCF8: mimi-seed)
 
-${kleur9.bold("mimi-seed notes \uC635\uC158:")}
+  mimi-seed restart [server-name]`,
+  notes: `${kleur9.bold("mimi-seed notes")} \u2014 \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC0DD\uC131 (git log \u2192 AI \u2192 \uB9C8\uCF13 \uC801\uC6A9)
+
+\uC635\uC158:
   --from <ref>        \uC2DC\uC791 \uCEE4\uBC0B/\uD0DC\uADF8 (\uAE30\uBCF8: \uCD5C\uC2E0 \uD0DC\uADF8)
   --to <ref>          \uB05D \uCEE4\uBC0B (\uAE30\uBCF8: HEAD)
   --locale ko,en-US   \uB300\uC0C1 \uB85C\uCF00\uC77C (\uC27C\uD45C \uAD6C\uBD84)
   --apply             \uC0DD\uC131 \uD6C4 \uC2A4\uD1A0\uC5B4\uC5D0 \uBC14\uB85C \uC801\uC6A9
   --no-interactive    CI \uBAA8\uB4DC (\uD504\uB86C\uD504\uD2B8 \uC5C6\uC74C)
-  --limit <n>         \uCD5C\uB300 \uCEE4\uBC0B \uC218 (\uAE30\uBCF8: 30)
+  --limit <n>         \uCD5C\uB300 \uCEE4\uBC0B \uC218 (\uAE30\uBCF8: 30)`,
+  check: `${kleur9.bold("mimi-seed check")} \u2014 \uCD9C\uC2DC \uC804 Readiness \uC810\uAC80
 
-${kleur9.bold("mimi-seed check \uC635\uC158:")}
+\uC635\uC158:
   --app <id>          \uC571 ID \uC9C0\uC815
-  --fail-on-blocker   \uBE14\uB85C\uCEE4 \uC788\uC73C\uBA74 exit 1 (CI\uC6A9)
+  --fail-on-blocker   \uBE14\uB85C\uCEE4 \uC788\uC73C\uBA74 exit 1 (CI\uC6A9)`,
+  review: `${kleur9.bold("mimi-seed review")} \u2014 \uB9AC\uBDF0 \uB2F5\uBCC0 AI \uCD08\uC548 \uC0DD\uC131 \uBC0F Play Store \uAC8C\uC2DC
 
-${kleur9.bold("mimi-seed review \uC635\uC158:")}
+\uC635\uC158:
   --text <\uB0B4\uC6A9>       \uB9AC\uBDF0 \uC6D0\uBB38 (\uBBF8\uC785\uB825 \uC2DC \uB300\uD654\uD615 \uD504\uB86C\uD504\uD2B8)
   --rating <1-5>      \uBCC4\uC810
   --tone <tone>       friendly / professional / empathetic / brief (\uAE30\uBCF8: friendly)
@@ -1736,9 +1821,10 @@ ${kleur9.bold("mimi-seed review \uC635\uC158:")}
   --apply             \uB2F5\uBCC0\uC744 Play Store\uC5D0 \uAC8C\uC2DC
   --review-id <id>    \uB9AC\uBDF0 ID (--apply \uC2DC \uD544\uC694)
   --package-name <p>  \uD328\uD0A4\uC9C0\uBA85 (--apply \uC2DC \uD544\uC694)
-  --no-interactive    CI \uBAA8\uB4DC
+  --no-interactive    CI \uBAA8\uB4DC`,
+  deploy: `${kleur9.bold("mimi-seed deploy")} \u2014 \uC571 \uC790\uB3D9 \uBC30\uD3EC (CI \uBE4C\uB4DC \u2192 Play Store/App Store)
 
-${kleur9.bold("mimi-seed deploy \uC635\uC158:")}
+\uC635\uC158:
   --platform android|ios       \uBC30\uD3EC \uD50C\uB7AB\uD3FC (\uAE30\uBCF8: android)
   --app <id>                   \uC571 ID \uC9C0\uC815
   --version-code <n>           \uBE4C\uB4DC \uBC88\uD638 \uC9C1\uC811 \uC9C0\uC815 (--skip-build \uC640 \uD568\uAED8)
@@ -1746,13 +1832,43 @@ ${kleur9.bold("mimi-seed deploy \uC635\uC158:")}
   --to <ref>                   \uCEE4\uBC0B \uBC94\uC704 \uB05D (\uAE30\uBCF8: HEAD)
   --language <\uCF54\uB4DC>            \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC5B8\uC5B4 (\uAE30\uBCF8: ko-KR)
   --dry-run                    \uC2E4\uC81C \uBC30\uD3EC \uC5C6\uC774 \uD30C\uC774\uD504\uB77C\uC778 \uD14C\uC2A4\uD2B8
+  --yes, -y                    \uBC30\uD3EC \uD655\uC778 \uD504\uB86C\uD504\uD2B8 \uC0DD\uB7B5 (\uC2A4\uD06C\uB9BD\uD2B8/\uC790\uB3D9\uD654\uC6A9)
   --skip-build                 CI \uBE4C\uB4DC \uAC74\uB108\uB700 (--version-code \uD544\uC218)
   --ci jenkins|github|gitlab   CI \uAC15\uC81C \uC120\uD0DD (\uAE30\uBCF8: auto)
   --workflow <file>            GitHub workflow \uD30C\uC77C (\uC608: deploy.yml)
   --ref <branch|tag>           GitHub/GitLab \uBE0C\uB79C\uCE58/\uD0DC\uADF8 (\uAE30\uBCF8: main)
-  setup-jenkins                Jenkins \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
-  setup-github                 GitHub Actions \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
-  setup-gitlab                 GitLab CI \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
+  setup-jenkins / setup-github / setup-gitlab   CI \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D`,
+  mcp: `${kleur9.bold("mimi-seed mcp")} \u2014 Claude/Codex MCP \uC5F0\uACB0
+
+\uC11C\uBE0C\uBA85\uB839:
+  mimi-seed mcp                \uD604\uC7AC \uC124\uC815 + \uB4F1\uB85D \uC548\uB0B4
+  mimi-seed mcp claude         Claude Code \uB4F1\uB85D \uBA85\uB839 \uCD9C\uB825
+  mimi-seed mcp codex          Codex \uB4F1\uB85D \uC548\uB0B4
+  mimi-seed mcp codex --write  ~/.codex/config.toml\uC5D0 \uC9C1\uC811 \uAE30\uB85D (\u26A0 \uC2E4\uC81C \uD1A0\uD070 \uD3C9\uBB38 \uC800\uC7A5)`
+};
+function printCommandHelp(cmd) {
+  const usage = CMD_USAGE[cmd];
+  if (!usage) return false;
+  log4(usage);
+  return true;
+}
+function printHelp() {
+  log4(`${kleur9.bold("mimi-seed")} \u2014 Claude Code/Codex\uC5D0\uC11C \uC571 \uCD9C\uC2DC \uC6B4\uC601
+
+${kleur9.bold("\uBA85\uB839\uC5B4:")}
+  ${kleur9.cyan("mimi-seed init")}        \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uB97C Mimi Seed\uC5D0 \uC5F0\uACB0
+  ${kleur9.cyan("mimi-seed status")}      \uC5F0\uACB0 \uC0C1\uD0DC + \uB4F1\uB85D \uC571 \uBAA9\uB85D
+  ${kleur9.cyan("mimi-seed auth")}        \uB85C\uCEEC \uC778\uC99D (Google OAuth / App Store / Play / BigQuery)
+  ${kleur9.cyan("mimi-seed doctor")}      \uD658\uACBD \uC9C4\uB2E8 (\uD1A0\uD070\xB7Git\xB7\uD504\uB85C\uC81D\uD2B8\xB7CI \uCCB4\uD06C)
+  ${kleur9.cyan("mimi-seed check")}       \uCD9C\uC2DC \uC804 Readiness \uC810\uAC80
+  ${kleur9.cyan("mimi-seed notes")}       \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC0DD\uC131 (git log \u2192 AI \u2192 \uB9C8\uCF13 \uC801\uC6A9)
+  ${kleur9.cyan("mimi-seed review")}      \uB9AC\uBDF0 \uB2F5\uBCC0 AI \uCD08\uC548 \uC0DD\uC131 \uBC0F Play Store \uAC8C\uC2DC
+  ${kleur9.cyan("mimi-seed deploy")}      \uC571 \uC790\uB3D9 \uBC30\uD3EC (CI \u2192 Play Store/App Store)
+  ${kleur9.cyan("mimi-seed mcp")}         Claude/Codex MCP \uC5F0\uACB0 \uC548\uB0B4 \uBC0F Codex \uC124\uC815 \uC4F0\uAE30
+  ${kleur9.cyan("mimi-seed restart")}     MCP \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC7AC\uC2DC\uC791 (\uAE30\uBCF8: mimi-seed)
+  ${kleur9.cyan("mimi-seed logout")}      \uB85C\uCEEC \uC124\uC815 \uC0AD\uC81C
+
+${kleur9.dim("\uAC01 \uBA85\uB839 \uC0C1\uC138 \uC635\uC158:")} ${kleur9.cyan("mimi-seed <command> --help")}
 
 ${kleur9.bold("\uD658\uACBD\uBCC0\uC218:")}
   MIMI_SEED_TOKEN     PAT \uD1A0\uD070 (CI/CD \uBB34\uC778\uC99D \uBAA8\uB4DC)
@@ -1763,6 +1879,9 @@ ${kleur9.bold("\uD658\uACBD\uBCC0\uC218:")}
 async function main() {
   const cmd = process.argv[2];
   const restArgs = process.argv.slice(3);
+  if (cmd && cmd !== "auth" && (restArgs.includes("--help") || restArgs.includes("-h"))) {
+    if (printCommandHelp(cmd)) return;
+  }
   try {
     switch (cmd) {
       case "init":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mimi-seed",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "Mimi Seed CLI — Claude Code와 Codex에서 앱 출시 운영을 관리합니다.",
   "bin": {
     "mimi-seed": "dist/index.js"