mimi-seed 0.2.5 → 0.2.7

package/dist/index.js

@@ -4,7 +4,9 @@ import {
 } from "./chunk-Q5YGYAFK.js";
 
 // src/index.ts
-import os3 from "os";
+import os4 from "os";
+import fs5 from "fs";
+import path5 from "path";
 import kleur8 from "kleur";
 import open from "open";
 
@@ -851,6 +853,145 @@ async function cmdAuth(args) {
 // src/deploy.ts
 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");
+function loadCiProviderConfig() {
+  try {
+    return JSON.parse(fs3.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 });
+  }
+  fs3.writeFileSync(CI_CONFIG_PATH, JSON.stringify(cfg, null, 2));
+  if (process.platform !== "win32") {
+    fs3.chmodSync(CI_CONFIG_PATH, 384);
+  }
+}
+function ghBase(cfg) {
+  if (cfg.host) return `${cfg.host.replace(/\/$/, "")}/api/v3`;
+  return "https://api.github.com";
+}
+function ghHeaders(token) {
+  return {
+    Authorization: `Bearer ${token}`,
+    Accept: "application/vnd.github+json",
+    "X-GitHub-Api-Version": "2022-11-28",
+    "Content-Type": "application/json"
+  };
+}
+async function ghTriggerWorkflow(cfg, workflow, ref, inputs = {}) {
+  const startTime = /* @__PURE__ */ new Date();
+  const wfId = /^\d+$/.test(workflow) ? Number(workflow) : workflow;
+  const dispatchRes = await fetch(
+    `${ghBase(cfg)}/repos/${cfg.owner}/${cfg.repo}/actions/workflows/${wfId}/dispatches`,
+    {
+      method: "POST",
+      headers: ghHeaders(cfg.token),
+      body: JSON.stringify({ ref, inputs })
+    }
+  );
+  if (!dispatchRes.ok) {
+    throw new Error(`GitHub dispatch ${dispatchRes.status}: ${await dispatchRes.text()}`);
+  }
+  await new Promise((r) => setTimeout(r, 3e3));
+  const runsRes = await fetch(
+    `${ghBase(cfg)}/repos/${cfg.owner}/${cfg.repo}/actions/workflows/${wfId}/runs?per_page=5`,
+    { headers: ghHeaders(cfg.token) }
+  );
+  if (!runsRes.ok) return null;
+  const data = await runsRes.json();
+  const run = data.workflow_runs.find((r) => new Date(r.created_at) >= startTime) ?? data.workflow_runs[0];
+  if (!run) return null;
+  return { runId: run.id, url: run.html_url };
+}
+async function ghPollRun(cfg, runId, onTick, timeoutMs = 30 * 60 * 1e3) {
+  const start = Date.now();
+  let consecutiveErrors = 0;
+  while (Date.now() - start < timeoutMs) {
+    await new Promise((r) => setTimeout(r, 15e3));
+    try {
+      const res = await fetch(
+        `${ghBase(cfg)}/repos/${cfg.owner}/${cfg.repo}/actions/runs/${runId}`,
+        { headers: ghHeaders(cfg.token) }
+      );
+      if (!res.ok) {
+        consecutiveErrors++;
+        if (consecutiveErrors >= 3) throw new Error("GitHub API \uC5F0\uC18D \uC624\uB958");
+        continue;
+      }
+      consecutiveErrors = 0;
+      const data = await res.json();
+      onTick?.(data.status);
+      if (data.status === "completed") {
+        if (data.conclusion === "success") return "success";
+        if (data.conclusion === "cancelled") return "cancelled";
+        return "failure";
+      }
+    } catch {
+      consecutiveErrors++;
+      if (consecutiveErrors >= 3) throw new Error("GitHub API \uC5F0\uC18D \uC624\uB958 3\uD68C");
+    }
+  }
+  return "timeout";
+}
+function glBase(cfg) {
+  return `${cfg.host ?? "https://gitlab.com"}/api/v4`;
+}
+function glProjectId(cfg) {
+  return encodeURIComponent(`${cfg.owner}/${cfg.repo}`);
+}
+async function glTriggerPipeline(cfg, ref, variables = {}) {
+  const vars = Object.entries(variables).map(([key, value]) => ({ key, value }));
+  const body = { ref };
+  if (vars.length > 0) body.variables = vars;
+  const res = await fetch(`${glBase(cfg)}/projects/${glProjectId(cfg)}/pipeline`, {
+    method: "POST",
+    headers: { "PRIVATE-TOKEN": cfg.token, "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) throw new Error(`GitLab trigger ${res.status}: ${await res.text()}`);
+  const data = await res.json();
+  return { pipelineId: data.id, url: data.web_url };
+}
+async function glPollPipeline(cfg, pipelineId, onTick, timeoutMs = 30 * 60 * 1e3) {
+  const start = Date.now();
+  let consecutiveErrors = 0;
+  while (Date.now() - start < timeoutMs) {
+    await new Promise((r) => setTimeout(r, 15e3));
+    try {
+      const res = await fetch(
+        `${glBase(cfg)}/projects/${glProjectId(cfg)}/pipelines/${pipelineId}`,
+        { headers: { "PRIVATE-TOKEN": cfg.token } }
+      );
+      if (!res.ok) {
+        consecutiveErrors++;
+        if (consecutiveErrors >= 3) throw new Error("GitLab API \uC5F0\uC18D \uC624\uB958");
+        continue;
+      }
+      consecutiveErrors = 0;
+      const data = await res.json();
+      onTick?.(data.status);
+      if (data.status === "success") return "success";
+      if (data.status === "failed") return "failure";
+      if (data.status === "canceled" || data.status === "skipped") return "cancelled";
+    } catch {
+      consecutiveErrors++;
+      if (consecutiveErrors >= 3) throw new Error("GitLab API \uC5F0\uC18D \uC624\uB958 3\uD68C");
+    }
+  }
+  return "timeout";
+}
+
+// src/deploy.ts
 var PHASE_ICON = {
   init: "\u{1F680}",
   verify: "\u{1F50D}",
@@ -961,7 +1102,17 @@ async function streamDeploy(webBase, token, body) {
   }
 }
 function parseArgs4(argv) {
-  const args = { platform: "android", language: "ko-KR", dryRun: false, skipBuild: false, setupJenkins: false };
+  const args = {
+    platform: "android",
+    language: "ko-KR",
+    dryRun: false,
+    skipBuild: false,
+    setupJenkins: false,
+    setupGithub: false,
+    setupGitlab: false,
+    ci: "auto",
+    ref: "main"
+  };
   for (let i = 0; i < argv.length; i++) {
     if ((argv[i] === "--platform" || argv[i] === "-p") && argv[i + 1]) args.platform = argv[++i];
     if (argv[i] === "--app" && argv[i + 1]) args.appId = argv[++i];
@@ -971,7 +1122,12 @@ function parseArgs4(argv) {
     if (argv[i] === "--language" && argv[i + 1]) args.language = argv[++i];
     if (argv[i] === "--dry-run") args.dryRun = 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];
+    if (argv[i] === "--ref" && argv[i + 1]) args.ref = argv[++i];
     if (argv[i] === "setup-jenkins") args.setupJenkins = true;
+    if (argv[i] === "setup-github") args.setupGithub = true;
+    if (argv[i] === "setup-gitlab") args.setupGitlab = true;
   }
   return args;
 }
@@ -987,6 +1143,78 @@ async function promptJenkinsSetup() {
   rl.close();
   return { url, user, token, jobAndroid: jobAndroid || void 0, jobIos: jobIos || void 0 };
 }
+async function promptGitProviderSetup(provider) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q) => new Promise((resolve) => rl.question(q, (a) => resolve(a.trim())));
+  const isGh = provider === "github";
+  log2(kleur6.bold(isGh ? "GitHub Actions \uC124\uC815" : "GitLab CI \uC124\uC815"));
+  const tokenLabel = isGh ? "  GitHub Personal Access Token (repo+workflow \uC2A4\uCF54\uD504): " : "  GitLab Personal Access Token: ";
+  const token = await ask(tokenLabel);
+  const owner = await ask(isGh ? "  Owner (org/user): " : "  Namespace/group: ");
+  const repo = await ask("  Repo \uC774\uB984 (\uACBD\uB85C \uC5C6\uC774): ");
+  const hostPrompt = isGh ? "  GitHub Enterprise host (\uC120\uD0DD, \uC5D4\uD130=github.com): " : "  GitLab self-hosted URL (\uC120\uD0DD, \uC5D4\uD130=gitlab.com): ";
+  const host = await ask(hostPrompt);
+  rl.close();
+  return {
+    provider,
+    token,
+    owner,
+    repo,
+    host: host || void 0
+  };
+}
+function resolveCi(ciOption, jenkins, ciProvider) {
+  if (ciOption !== "auto") return ciOption;
+  if (jenkins?.url && jenkins.token) return "jenkins";
+  if (ciProvider) return ciProvider.provider;
+  throw new Error(
+    "CI \uC124\uC815 \uC5C6\uC74C. \uB2E4\uC74C \uC911 \uD558\uB098 \uC2E4\uD589:\n  \u2022 mimi-seed deploy setup-jenkins\n  \u2022 mimi-seed deploy setup-github\n  \u2022 mimi-seed deploy setup-gitlab"
+  );
+}
+async function runGitProviderBuild(cfg, args) {
+  let runUrl = "";
+  let runId;
+  if (cfg.provider === "github") {
+    if (!args.workflow) {
+      throw new Error("--workflow \uD544\uC694 (\uC608: --workflow deploy.yml)");
+    }
+    log2(`\u{1F528} GitHub Actions \uD2B8\uB9AC\uAC70: ${kleur6.cyan(args.workflow)} @ ${args.ref}`);
+    const inputs = {};
+    if (args.appId) inputs.MIMI_APP_ID = args.appId;
+    inputs.PLATFORM = args.platform;
+    const result2 = await ghTriggerWorkflow(cfg, args.workflow, args.ref, inputs);
+    if (!result2) {
+      throw new Error("GitHub Actions run_id \uC870\uD68C \uC2E4\uD328. \uC7A0\uC2DC \uD6C4 ci_list_recent_builds \uB85C \uD655\uC778\uD558\uC138\uC694.");
+    }
+    runId = result2.runId;
+    runUrl = result2.url;
+    log2(kleur6.dim(`  Run ID: ${runId} \u2192 ${runUrl}`));
+  } else {
+    log2(`\u{1F528} GitLab Pipeline \uD2B8\uB9AC\uAC70: ${args.ref}`);
+    const variables = { PLATFORM: args.platform };
+    if (args.appId) variables.MIMI_APP_ID = args.appId;
+    const result2 = await glTriggerPipeline(cfg, args.ref, variables);
+    runId = result2.pipelineId;
+    runUrl = result2.url;
+    log2(kleur6.dim(`  Pipeline ID: ${runId} \u2192 ${runUrl}`));
+  }
+  log2("  \uC644\uB8CC \uB300\uAE30 \uC911...");
+  let dots = 0;
+  const onTick = (status) => {
+    dots = (dots + 1) % 4;
+    process.stdout.write(`\r  \u23F3 ${status}${".".repeat(dots + 1)}     `);
+  };
+  const result = cfg.provider === "github" ? await ghPollRun(cfg, runId, onTick) : await glPollPipeline(cfg, runId, onTick);
+  process.stdout.write("\n");
+  if (result === "success") {
+    log2(kleur6.green(`\u2705 \uBE4C\uB4DC #${runId} \uC131\uACF5`));
+    return runId;
+  }
+  log2(kleur6.red(`\uBE4C\uB4DC \uC885\uB8CC: ${result}`));
+  log2(kleur6.dim(`  ${runUrl}`));
+  log2(kleur6.dim(`  \uBE4C\uB4DC\uAC00 \uC774\uBBF8 \uC644\uB8CC\uB410\uB2E4\uBA74: mimi-seed deploy --skip-build --version-code <N> --platform ${args.platform}`));
+  process.exit(1);
+}
 async function cmdDeploy(argv) {
   const args = parseArgs4(argv);
   const cfg = await getEffectiveConfig();
@@ -1000,56 +1228,84 @@ async function cmdDeploy(argv) {
     log2(kleur6.green("\u2705 Jenkins \uC124\uC815 \uC800\uC7A5\uB428"));
     return;
   }
+  if (args.setupGithub) {
+    const ciCfg = await promptGitProviderSetup("github");
+    saveCiProviderConfig(ciCfg);
+    log2(kleur6.green(`\u2705 GitHub Actions \uC124\uC815 \uC800\uC7A5\uB428 \u2192 ~/.mimi-seed/ci.json`));
+    return;
+  }
+  if (args.setupGitlab) {
+    const ciCfg = await promptGitProviderSetup("gitlab");
+    saveCiProviderConfig(ciCfg);
+    log2(kleur6.green(`\u2705 GitLab CI \uC124\uC815 \uC800\uC7A5\uB428 \u2192 ~/.mimi-seed/ci.json`));
+    return;
+  }
   log2(kleur6.bold(`mimi-seed deploy \u2014 ${args.platform}`));
   if (args.dryRun) log2(kleur6.yellow("  [dry-run \uBAA8\uB4DC] \uC2E4\uC81C \uBC30\uD3EC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4"));
   log2("");
   let versionCode = args.versionCode;
   if (!args.skipBuild) {
-    if (!cfg.jenkins?.url || !cfg.jenkins?.token) {
-      log2(kleur6.yellow("Jenkins \uC124\uC815 \uC5C6\uC74C. `mimi-seed deploy setup-jenkins` \uB85C \uC124\uC815\uD558\uAC70\uB098 --skip-build \uC0AC\uC6A9."));
-      log2(kleur6.dim("  \uB610\uB294 \uC11C\uBC84 /workspace/integrations\uC5D0\uC11C jenkins \uD504\uB85C\uBC14\uC774\uB354 \uB4F1\uB85D \uD6C4 \uC11C\uBC84\uC0AC\uC774\uB4DC \uD2B8\uB9AC\uAC70 \uAC00\uB2A5."));
-      process.exit(1);
-    }
-    const jenkins = cfg.jenkins;
-    const jobName = args.platform === "android" ? jenkins.jobAndroid : jenkins.jobIos;
-    if (!jobName) {
-      log2(kleur6.red(`${args.platform} Jenkins job\uC774 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. setup-jenkins \uC2E4\uD589.`));
-      process.exit(1);
-    }
-    log2(`\u{1F528} Jenkins \uBE4C\uB4DC \uD2B8\uB9AC\uAC70: ${kleur6.cyan(jobName)}`);
-    const buildParams = {};
-    if (args.appId) buildParams.MIMI_APP_ID = args.appId;
-    const queueItemId = await triggerBuild(jenkins, jobName, buildParams);
-    if (!queueItemId) {
-      log2(kleur6.yellow("  \u26A0 Queue item ID\uB97C \uAC00\uC838\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uBE4C\uB4DC\uB294 \uC2DC\uC791\uB410\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4."));
+    const ciProvider = loadCiProviderConfig();
+    const kind = resolveCi(args.ci, cfg.jenkins, ciProvider);
+    log2(kleur6.dim(`  CI: ${kind}`));
+    if (kind === "jenkins") {
+      if (!cfg.jenkins?.url || !cfg.jenkins?.token) {
+        log2(kleur6.yellow("Jenkins \uC124\uC815 \uC5C6\uC74C. `mimi-seed deploy setup-jenkins` \uB85C \uC124\uC815\uD558\uAC70\uB098 --skip-build \uC0AC\uC6A9."));
+        process.exit(1);
+      }
+      const jenkins = cfg.jenkins;
+      const jobName = args.platform === "android" ? jenkins.jobAndroid : jenkins.jobIos;
+      if (!jobName) {
+        log2(kleur6.red(`${args.platform} Jenkins job\uC774 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. setup-jenkins \uC2E4\uD589.`));
+        process.exit(1);
+      }
+      log2(`\u{1F528} Jenkins \uBE4C\uB4DC \uD2B8\uB9AC\uAC70: ${kleur6.cyan(jobName)}`);
+      const buildParams = {};
+      if (args.appId) buildParams.MIMI_APP_ID = args.appId;
+      const queueItemId = await triggerBuild(jenkins, jobName, buildParams);
+      if (!queueItemId) {
+        log2(kleur6.yellow("  \u26A0 Queue item ID\uB97C \uAC00\uC838\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uBE4C\uB4DC\uB294 \uC2DC\uC791\uB410\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4."));
+      } else {
+        log2(kleur6.dim(`  Queue item: ${queueItemId}`));
+      }
+      let buildNumber = null;
+      if (queueItemId) {
+        log2("  \uBE4C\uB4DC \uBC88\uD638 \uB300\uAE30 \uC911...");
+        for (let i = 0; i < 6; i++) {
+          await new Promise((r) => setTimeout(r, 5e3));
+          buildNumber = await getQueueBuildNumber(jenkins, queueItemId).catch(() => null);
+          if (buildNumber) break;
+        }
+      }
+      if (!buildNumber) {
+        log2(kleur6.yellow("  \uBE4C\uB4DC \uBC88\uD638\uB97C \uAC00\uC838\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. --skip-build + --version-code \uB85C \uC7AC\uC2DC\uB3C4 \uAC00\uB2A5."));
+        process.exit(1);
+      }
+      log2(`  \uBE4C\uB4DC #${buildNumber} \uC2DC\uC791\uB428. \uC644\uB8CC \uB300\uAE30 \uC911...`);
+      const result = await pollBuildComplete(jenkins, jobName, buildNumber);
+      if (result !== "SUCCESS") {
+        log2(kleur6.red(`\uBE4C\uB4DC \uC2E4\uD328: ${result}`));
+        log2(kleur6.dim(`  Jenkins: ${jenkins.url}/job/${encodeURIComponent(jobName)}/${buildNumber}/`));
+        log2(kleur6.dim(`  \uBE4C\uB4DC\uAC00 \uC774\uBBF8 \uC644\uB8CC\uB410\uB2E4\uBA74: mimi-seed deploy --skip-build --version-code ${buildNumber} --platform ${args.platform}`));
+        process.exit(1);
+      }
+      log2(kleur6.green(`\u2705 \uBE4C\uB4DC #${buildNumber} \uC131\uACF5`));
+      if (!versionCode) {
+        versionCode = buildNumber;
+        log2(kleur6.dim(`  versionCode = buildNumber (${versionCode})`));
+      }
     } else {
-      log2(kleur6.dim(`  Queue item: ${queueItemId}`));
-    }
-    let buildNumber = null;
-    if (queueItemId) {
-      log2("  \uBE4C\uB4DC \uBC88\uD638 \uB300\uAE30 \uC911...");
-      for (let i = 0; i < 6; i++) {
-        await new Promise((r) => setTimeout(r, 5e3));
-        buildNumber = await getQueueBuildNumber(jenkins, queueItemId).catch(() => null);
-        if (buildNumber) break;
+      if (!ciProvider) {
+        log2(kleur6.red(`${kind} \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. setup-${kind} \uC2E4\uD589.`));
+        process.exit(1);
+      }
+      const buildId = await runGitProviderBuild(ciProvider, args);
+      if (!versionCode) {
+        versionCode = buildId;
+        log2(kleur6.dim(`  versionCode = build id (${versionCode})`));
+        log2(kleur6.dim(`  \uC8FC\uC758: GitHub run ID / GitLab pipeline ID\uB294 versionCode\uB85C \uC801\uD569\uD558\uC9C0 \uC54A\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`));
+        log2(kleur6.dim(`  --version-code <N> \uB85C \uBA85\uC2DC \uAD8C\uC7A5.`));
       }
-    }
-    if (!buildNumber) {
-      log2(kleur6.yellow("  \uBE4C\uB4DC \uBC88\uD638\uB97C \uAC00\uC838\uC624\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. --skip-build + --version-code \uB85C \uC7AC\uC2DC\uB3C4 \uAC00\uB2A5."));
-      process.exit(1);
-    }
-    log2(`  \uBE4C\uB4DC #${buildNumber} \uC2DC\uC791\uB428. \uC644\uB8CC \uB300\uAE30 \uC911...`);
-    const result = await pollBuildComplete(jenkins, jobName, buildNumber);
-    if (result !== "SUCCESS") {
-      log2(kleur6.red(`\uBE4C\uB4DC \uC2E4\uD328: ${result}`));
-      log2(kleur6.dim(`  Jenkins: ${jenkins.url}/job/${encodeURIComponent(jobName)}/${buildNumber}/`));
-      log2(kleur6.dim(`  \uBE4C\uB4DC\uAC00 \uC774\uBBF8 \uC644\uB8CC\uB410\uB2E4\uBA74: mimi-seed deploy --skip-build --version-code ${buildNumber} --platform ${args.platform}`));
-      process.exit(1);
-    }
-    log2(kleur6.green(`\u2705 \uBE4C\uB4DC #${buildNumber} \uC131\uACF5`));
-    if (!versionCode) {
-      versionCode = buildNumber;
-      log2(kleur6.dim(`  versionCode = buildNumber (${versionCode})`));
     }
   }
   if (!versionCode) {
@@ -1096,17 +1352,17 @@ async function cmdDeploy(argv) {
 
 // src/mcp-restart.ts
 import { execSync as execSync2 } from "child_process";
-import fs3 from "fs";
-import os2 from "os";
-import path3 from "path";
+import fs4 from "fs";
+import os3 from "os";
+import path4 from "path";
 import kleur7 from "kleur";
 function log3(msg) {
   process.stdout.write(msg + "\n");
 }
 function readClaudeJson() {
-  const p = path3.join(os2.homedir(), ".claude.json");
+  const p = path4.join(os3.homedir(), ".claude.json");
   try {
-    return JSON.parse(fs3.readFileSync(p, "utf8"));
+    return JSON.parse(fs4.readFileSync(p, "utf8"));
   } catch {
     return {};
   }
@@ -1122,7 +1378,7 @@ function findProcessMarker(cfg) {
   return meaningful.at(-1) ?? null;
 }
 function killByMarker(marker) {
-  const isWin = os2.platform() === "win32";
+  const isWin = os3.platform() === "win32";
   if (isWin) {
     const escaped = marker.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
     let pids = [];
@@ -1233,7 +1489,7 @@ async function cmdInit() {
     return;
   }
   log4("\u{1F510} \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB85C\uADF8\uC778 \uB300\uAE30...");
-  const hostName = os3.hostname().slice(0, 32);
+  const hostName = os4.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`;
@@ -1269,6 +1525,43 @@ async function cmdInit() {
     }
     log4("");
   }
+  const claudeDir = path5.join(cwd, ".claude");
+  const agentMdPath = path5.join(claudeDir, "mimi-seed.md");
+  if (!fs5.existsSync(agentMdPath)) {
+    fs5.mkdirSync(claudeDir, { recursive: true });
+    const appLines = hints.flatMap((h) => {
+      const parts = [
+        h.name && `  name: ${h.name}`,
+        h.packageName && `  packageName: ${h.packageName}`,
+        h.bundleId && `  bundleId: ${h.bundleId}`
+      ].filter(Boolean);
+      return parts;
+    });
+    const agentMd = [
+      "# Mimi Seed Agent",
+      "",
+      "Mimi Seed MCP\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.",
+      "Google Play \xB7 App Store \xB7 Firebase \xB7 AdMob\uC744 \uB3C4\uAD6C\uB85C \uC9C1\uC811 \uC81C\uC5B4\uD569\uB2C8\uB2E4.",
+      "",
+      "## \uCD9C\uC2DC \uC694\uCCAD \uCC98\uB9AC \uC21C\uC11C",
+      "",
+      "1. \uD56D\uC0C1 `playstore_check_submission_risks` / `appstore_check_submission_risks` \uB85C \uBE14\uB85C\uCEE4 \uBA3C\uC800 \uD655\uC778",
+      "2. \uB9B4\uB9AC\uC988 \uB178\uD2B8: `generate_release_notes_from_commits` \u2192 \uC0AC\uC6A9\uC790 \uD655\uC778 \uD6C4 \uC801\uC6A9",
+      "3. \uC2A4\uD1A0\uC5B4 **\uC4F0\uAE30** \uC791\uC5C5(submit, apply, reply)\uC740 \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790 \uBA85\uC2DC \uB3D9\uC758 \uD6C4 \uC2E4\uD589",
+      "4. \uC644\uB8CC \uD6C4 \uACB0\uACFC \uC694\uC57D \uC81C\uACF5",
+      "",
+      "## \uC571 \uC815\uBCF4",
+      ...appLines.length > 0 ? appLines : ["  (mimi-seed status \uB85C \uD655\uC778)"],
+      "",
+      "## \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC",
+      "",
+      "- `/mimi-seed:deploy` \u2014 \uC804\uCCB4 \uCD9C\uC2DC \uD30C\uC774\uD504\uB77C\uC778",
+      "- `/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");
+    fs5.writeFileSync(agentMdPath, agentMd, { mode: 420 });
+    log4(kleur8.dim(`  \uC5D0\uC774\uC804\uD2B8 \uC124\uC815: .claude/mimi-seed.md`));
+  }
   log4(kleur8.bold("\u2713 \uC900\uBE44 \uC644\uB8CC."));
   log4("");
   log4("Claude Code\uC5D0\uC11C \uC774\uB807\uAC8C \uBB3C\uC5B4\uBCF4\uC138\uC694:");
@@ -1348,15 +1641,20 @@ ${kleur8.bold("mimi-seed review \uC635\uC158:")}
   --no-interactive    CI \uBAA8\uB4DC
 
 ${kleur8.bold("mimi-seed deploy \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)
-  --from <ref>            \uCEE4\uBC0B \uBC94\uC704 \uC2DC\uC791 (\uB9B4\uB9AC\uC988 \uB178\uD2B8\uC6A9)
-  --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
-  --skip-build            Jenkins \uBE4C\uB4DC \uAC74\uB108\uB700 (--version-code \uD544\uC218)
-  setup-jenkins           Jenkins \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
+  --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)
+  --from <ref>                 \uCEE4\uBC0B \uBC94\uC704 \uC2DC\uC791 (\uB9B4\uB9AC\uC988 \uB178\uD2B8\uC6A9)
+  --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
+  --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
 
 ${kleur8.bold("\uD658\uACBD\uBCC0\uC218:")}
   MIMI_SEED_TOKEN     PAT \uD1A0\uD070 (CI/CD \uBB34\uC778\uC99D \uBAA8\uB4DC)

package/package.json

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