@yoonion/mimi-seed-mcp 0.6.6 → 0.8.0

package/README.md

@@ -42,17 +42,29 @@ npx -y @yoonion/mimi-seed-mcp mimi-seed-auth
 
 브라우저가 열리면 Google 계정으로 로그인. 토큰은 `~/.mimi-seed/tokens.json`에 저장되고 자동 갱신됨.
 
-플랫폼별 추가 인증 (필요한 것만):
+나머지 계정은 **마법사 하나로** 연결하는 게 가장 빠릅니다 — 뭐가 빠졌는지 보여주고, 각 토큰을 어디서
+발급받는지도 알려줍니다:
 
 ```bash
-npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth    # App Store Connect (API Key)
-npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth   # Google Play 서비스 계정 JSON
-npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth    # BigQuery (Crashlytics export 등)
+npx mimi-seed setup
 ```
 
-- **App Store Connect**: Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json`
-- **Google Play**: Play Console 서비스 계정 JSON 경로 입력 (패키지별 등록)
-- **BigQuery**: Google OAuth 또는 서비스 계정으로 데이터셋 조회 권한 부여
+개별로 실행하고 싶다면 (전부 대화형):
+
+```bash
+npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth     # App Store Connect (API Key)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth    # Google Play 서비스 계정 JSON
+npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth     # BigQuery
+npx -y @yoonion/mimi-seed-mcp mimi-seed-jenkins-auth      # Jenkins (저장 전 서버 프로브)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-googleads-auth    # Google Ads (저장 전 실제 호출로 검증)
+npx -y @yoonion/mimi-seed-mcp mimi-seed-social-auth       # Facebook / Instagram
+```
+
+각 자격증명을 **어디서 어떻게 발급받는지**는 [`docs/credentials.md`](../../docs/credentials.md) 참고.
+
+- **App Store Connect**: Users and Access → Integrations에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력 → `~/.mimi-seed/appstore.json` (.p8은 **1회만** 다운로드됨)
+- **Google Play**: 서비스 계정은 **선택** — OAuth 토큰이 `androidpublisher` 스코프를 갖고 있어 로컬 작업은 그대로 됩니다. CI/헤드리스에서만 필요.
+- **BigQuery**: 선택 — OAuth로도 동작하며, Workspace 재인증 정책에 막힐 때만 서비스 계정이 필요합니다.
 
 AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
 
@@ -66,8 +78,8 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| App Store Connect | 33 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
-| Google Play | 28 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| App Store Connect | 34 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
+| Google Play | 29 | `playstore_submit_release` / `playstore_promote_release` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
 | Firebase | 20 | `firebase_create_project` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_create_ios_app` |
 | AdMob | 7 | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
 | CI/CD (GitHub Actions · GitLab) | 6 | `ci_trigger_build` / `ci_get_build_status` / `ci_list_workflows` / `ci_cancel_build` |

package/dist/appstore/setup-cli.js

@@ -2,34 +2,71 @@
 import { saveAppStoreCredentials, getAppStoreCredentials } from './auth.js';
 import readline from 'node:readline';
 import fs from 'node:fs';
+import { resolveLang } from '../lib/lang.js';
+// ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
+const ko = {
+    title: '  🍎 Mimi Seed — App Store Connect 연결',
+    already: (keyId) => `  ✅ 이미 연결됨 (Key ID: ${keyId})`,
+    reconnect: '  다시 설정할래? (y/N): ',
+    needTitle: '  App Store Connect에서 API Key를 만들어야 해:',
+    step1: '  1. "키 생성" 클릭',
+    step2: '  2. 이름: Mimi Seed, 역할: Admin',
+    step3: '  3. .p8 파일 다운로드 (1회만 가능!)',
+    askIssuerId: '  Issuer ID: ',
+    askKeyId: '  Key ID: ',
+    askP8Path: '  .p8 파일 경로: ',
+    noFile: (p) => `  ❌ 파일 없음: ${p}`,
+    done: '  ✅ 연결 완료!',
+    nextTitle: '  이제 Claude Code 또는 Codex에서:',
+    nextExample1: '    "내 앱스토어 앱 목록 보여줘"',
+    nextExample2: '    "TestFlight 빌드 목록 보여줘"',
+};
+const en = {
+    title: '  🍎 Mimi Seed — Connect App Store Connect',
+    already: (keyId) => `  ✅ Already connected (Key ID: ${keyId})`,
+    reconnect: '  Set it up again? (y/N): ',
+    needTitle: '  You need to create an API Key in App Store Connect:',
+    step1: '  1. Click "Generate API Key"',
+    step2: '  2. Name: Mimi Seed, Access: Admin',
+    step3: '  3. Download the .p8 file (you can only download it ONCE!)',
+    askIssuerId: '  Issuer ID: ',
+    askKeyId: '  Key ID: ',
+    askP8Path: '  Path to the .p8 file: ',
+    noFile: (p) => `  ❌ File not found: ${p}`,
+    done: '  ✅ Connected!',
+    nextTitle: '  Now, in Claude Code or Codex:',
+    nextExample1: '    "Show my App Store apps"',
+    nextExample2: '    "List the TestFlight builds"',
+};
+const M = resolveLang() === 'en' ? en : ko;
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 const ask = (q) => new Promise((r) => rl.question(q, r));
 async function main() {
     console.log('');
-    console.log('  🍎 Mimi Seed — App Store Connect 연결');
+    console.log(M.title);
     console.log('');
     const existing = getAppStoreCredentials();
     if (existing) {
-        console.log(`  ✅ 이미 연결됨 (Key ID: ${existing.keyId})`);
-        const answer = await ask('  다시 설정할래? (y/N): ');
+        console.log(M.already(existing.keyId));
+        const answer = await ask(M.reconnect);
         if (answer.toLowerCase() !== 'y') {
             rl.close();
             return;
         }
     }
-    console.log('  App Store Connect에서 API Key를 만들어야 해:');
+    console.log(M.needTitle);
     console.log('  https://appstoreconnect.apple.com/access/integrations/api');
     console.log('');
-    console.log('  1. "키 생성" 클릭');
-    console.log('  2. 이름: Mimi Seed, 역할: Admin');
-    console.log('  3. .p8 파일 다운로드 (1회만 가능!)');
+    console.log(M.step1);
+    console.log(M.step2);
+    console.log(M.step3);
     console.log('');
-    const issuerId = await ask('  Issuer ID: ');
-    const keyId = await ask('  Key ID: ');
-    const p8Path = await ask('  .p8 파일 경로: ');
+    const issuerId = await ask(M.askIssuerId);
+    const keyId = await ask(M.askKeyId);
+    const p8Path = await ask(M.askP8Path);
     const trimmedPath = p8Path.trim().replace(/^["']|["']$/g, '');
     if (!fs.existsSync(trimmedPath)) {
-        console.log(`  ❌ 파일 없음: ${trimmedPath}`);
+        console.log(M.noFile(trimmedPath));
         rl.close();
         process.exit(1);
     }
@@ -40,11 +77,11 @@ async function main() {
         privateKey,
     });
     console.log('');
-    console.log('  ✅ 연결 완료!');
+    console.log(M.done);
     console.log('');
-    console.log('  이제 Claude Code 또는 Codex에서:');
-    console.log('    "내 앱스토어 앱 목록 보여줘"');
-    console.log('    "TestFlight 빌드 목록 보여줘"');
+    console.log(M.nextTitle);
+    console.log(M.nextExample1);
+    console.log(M.nextExample2);
     console.log('');
     rl.close();
 }

package/dist/auth/bigquery-setup-cli.js

@@ -4,36 +4,89 @@ import fs from 'node:fs';
 import { saveBigQueryServiceAccountJson, getBigQueryServiceAccountKey, } from './bigquery-auth.js';
 import * as bigquery from '../bigquery/tools.js';
 import { JWT } from 'google-auth-library';
+import { resolveLang } from '../lib/lang.js';
+// ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
+const ko = {
+    title: '  🤖 Mimi Seed — BigQuery 서비스 계정 연결',
+    whySa1: '  서비스 계정 인증은 Google Workspace 의 재인증(reauth) 정책에서',
+    whySa2: '  면제되므로, OAuth 가 invalid_rapt 로 막히는 환경에서도 동작해.',
+    already: (email) => `  ✅ 이미 연결됨 (${email})`,
+    reconnect: '  다시 설정할래? (y/N): ',
+    needTitle: '  BigQuery 를 읽을 수 있는 서비스 계정 키 JSON 이 필요해:',
+    step1: '  1. GCP Console → IAM & Admin → Service Accounts',
+    step2: '  2. 서비스 계정 선택(또는 생성) → Keys → Add Key → JSON',
+    step3: '  3. 그 서비스 계정에 프로젝트 IAM 역할 부여:',
+    roleJobUser: '     • roles/bigquery.jobUser    (쿼리 작업 생성)',
+    roleDataViewer: '     • roles/bigquery.dataViewer (데이터셋 읽기)',
+    step4: '  4. 다운로드한 JSON 파일 경로를 입력해',
+    askPath: '  서비스 계정 JSON 파일 경로: ',
+    noFile: (p) => `  ❌ 파일 없음: ${p}`,
+    saved: (email) => `  ✅ 저장 완료! (${email})`,
+    saProject: (p) => `     서비스 계정 프로젝트: ${p}`,
+    askTestProject: (fallback) => `  연결 테스트할 GCP 프로젝트 ID (엔터 시 건너뜀${fallback ? `, 기본 ${fallback}` : ''}): `,
+    probing: (projectId) => `  🔎 ${projectId} 데이터셋 조회 중...`,
+    probeOk: (n) => `  ✅ 접근 OK — 데이터셋 ${n}개`,
+    probeFail: (msg) => `  ⚠️  접근 실패: ${msg}`,
+    grantHint: '  IAM 역할이 없으면 아래를 실행해 (프로젝트 소유자 계정에서):',
+    nextTitle: '  이제 Claude Code 또는 Codex에서:',
+    nextExample: '    "BigQuery 로 GA4 트래픽 분석해줘"',
+};
+const en = {
+    title: '  🤖 Mimi Seed — Connect a BigQuery service account',
+    whySa1: '  Service-account auth is exempt from the Google Workspace reauth policy,',
+    whySa2: '  so it still works in environments where OAuth is blocked by invalid_rapt.',
+    already: (email) => `  ✅ Already connected (${email})`,
+    reconnect: '  Set it up again? (y/N): ',
+    needTitle: '  A service-account key JSON that can read BigQuery is required:',
+    step1: '  1. GCP Console → IAM & Admin → Service Accounts',
+    step2: '  2. Pick (or create) a service account → Keys → Add Key → JSON',
+    step3: '  3. Grant that service account these project IAM roles yourself:',
+    roleJobUser: '     • roles/bigquery.jobUser    (create query jobs)',
+    roleDataViewer: '     • roles/bigquery.dataViewer (read datasets)',
+    step4: '  4. Enter the path to the downloaded JSON file',
+    askPath: '  Path to the service-account JSON file: ',
+    noFile: (p) => `  ❌ File not found: ${p}`,
+    saved: (email) => `  ✅ Saved! (${email})`,
+    saProject: (p) => `     Service-account project: ${p}`,
+    askTestProject: (fallback) => `  GCP project ID to test against (Enter to skip${fallback ? `, default ${fallback}` : ''}): `,
+    probing: (projectId) => `  🔎 Listing datasets in ${projectId}...`,
+    probeOk: (n) => `  ✅ Access OK — ${n} dataset(s)`,
+    probeFail: (msg) => `  ⚠️  Access failed: ${msg}`,
+    grantHint: '  If the IAM roles are missing, run this (as a project owner):',
+    nextTitle: '  Now, in Claude Code or Codex:',
+    nextExample: '    "Analyze GA4 traffic with BigQuery"',
+};
+const M = resolveLang() === 'en' ? en : ko;
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 const ask = (q) => new Promise((r) => rl.question(q, r));
 async function main() {
     console.log('');
-    console.log('  🤖 Mimi Seed — BigQuery 서비스 계정 연결');
+    console.log(M.title);
     console.log('');
-    console.log('  서비스 계정 인증은 Google Workspace 의 재인증(reauth) 정책에서');
-    console.log('  면제되므로, OAuth 가 invalid_rapt 로 막히는 환경에서도 동작해.');
+    console.log(M.whySa1);
+    console.log(M.whySa2);
     console.log('');
     const existing = getBigQueryServiceAccountKey();
     if (existing) {
-        console.log(`  ✅ 이미 연결됨 (${existing.client_email})`);
-        const answer = await ask('  다시 설정할래? (y/N): ');
+        console.log(M.already(existing.client_email));
+        const answer = await ask(M.reconnect);
         if (answer.toLowerCase() !== 'y') {
             rl.close();
             return;
         }
     }
-    console.log('  BigQuery 를 읽을 수 있는 서비스 계정 키 JSON 이 필요해:');
-    console.log('  1. GCP Console → IAM & Admin → Service Accounts');
-    console.log('  2. 서비스 계정 선택(또는 생성) → Keys → Add Key → JSON');
-    console.log('  3. 그 서비스 계정에 프로젝트 IAM 역할 부여:');
-    console.log('     • roles/bigquery.jobUser    (쿼리 작업 생성)');
-    console.log('     • roles/bigquery.dataViewer (데이터셋 읽기)');
-    console.log('  4. 다운로드한 JSON 파일 경로를 입력해');
+    console.log(M.needTitle);
+    console.log(M.step1);
+    console.log(M.step2);
+    console.log(M.step3);
+    console.log(M.roleJobUser);
+    console.log(M.roleDataViewer);
+    console.log(M.step4);
     console.log('');
-    const jsonPath = await ask('  서비스 계정 JSON 파일 경로: ');
+    const jsonPath = await ask(M.askPath);
     const trimmedPath = jsonPath.trim().replace(/^["']|["']$/g, '');
     if (!fs.existsSync(trimmedPath)) {
-        console.log(`  ❌ 파일 없음: ${trimmedPath}`);
+        console.log(M.noFile(trimmedPath));
         rl.close();
         process.exit(1);
     }
@@ -48,15 +101,15 @@ async function main() {
         process.exit(1);
     }
     console.log('');
-    console.log(`  ✅ 저장 완료! (${parsed.client_email})`);
+    console.log(M.saved(parsed.client_email));
     if (parsed.project_id)
-        console.log(`     서비스 계정 프로젝트: ${parsed.project_id}`);
+        console.log(M.saProject(parsed.project_id));
     console.log('');
     // 선택적 연결 테스트 — projectId 를 입력하면 datasets.list 로 권한 확인.
-    const testProject = await ask(`  연결 테스트할 GCP 프로젝트 ID (엔터 시 건너뜀${parsed.project_id ? `, 기본 ${parsed.project_id}` : ''}): `);
+    const testProject = await ask(M.askTestProject(parsed.project_id ?? ''));
     const projectId = testProject.trim() || parsed.project_id || '';
     if (projectId) {
-        console.log(`  🔎 ${projectId} 데이터셋 조회 중...`);
+        console.log(M.probing(projectId));
         try {
             const jwt = new JWT({
                 email: parsed.client_email,
@@ -67,15 +120,15 @@ async function main() {
                 ],
             });
             const datasets = await bigquery.listDatasets(jwt, projectId);
-            console.log(`  ✅ 접근 OK — 데이터셋 ${datasets.length}개`);
+            console.log(M.probeOk(datasets.length));
             for (const d of datasets.slice(0, 10))
                 console.log(`     • ${d.datasetId} (${d.location})`);
         }
         catch (e) {
             const msg = e instanceof Error ? e.message : String(e);
-            console.log(`  ⚠️  접근 실패: ${msg}`);
+            console.log(M.probeFail(msg));
             console.log('');
-            console.log('  IAM 역할이 없으면 아래를 실행해 (프로젝트 소유자 계정에서):');
+            console.log(M.grantHint);
             console.log(`    gcloud projects add-iam-policy-binding ${projectId} \\`);
             console.log(`      --member="serviceAccount:${parsed.client_email}" --role="roles/bigquery.jobUser"`);
             console.log(`    gcloud projects add-iam-policy-binding ${projectId} \\`);
@@ -83,8 +136,8 @@ async function main() {
         }
     }
     console.log('');
-    console.log('  이제 Claude Code 또는 Codex에서:');
-    console.log('    "BigQuery 로 GA4 트래픽 분석해줘"');
+    console.log(M.nextTitle);
+    console.log(M.nextExample);
     console.log('');
     rl.close();
 }

package/dist/auth/cli.js

@@ -4,20 +4,12 @@ import open from 'open';
 import { startAuth, getStoredTokens, ensureFreshAccessToken, } from './google-auth.js';
 import { AuthError, classifyError } from './errors.js';
 import { getMcpOAuthClient } from './constants.js';
-const args = process.argv.slice(2);
-const hasFlag = (name) => args.includes(`--${name}`);
-const flagValue = (name) => {
-    const i = args.indexOf(`--${name}`);
-    if (i < 0)
-        return undefined;
-    const v = args[i + 1];
-    return v && !v.startsWith('--') ? v : undefined;
-};
-function err(msg) {
-    process.stderr.write(msg + '\n');
-}
-function printHelp() {
-    err(`
+import { resolveLang } from '../lib/lang.js';
+// ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
+// 여기 있는 건 전부 **터미널에 찍히는 사람용 문자열**이다. errors.ts 가 만드는
+// code/message/hint 는 라이브러리 텍스트라 그대로 출력한다.
+const ko = {
+    help: `
   ☕ mimi-seed-auth — Google OAuth 인증 CLI
 
   사용법:
@@ -31,21 +23,132 @@ function printHelp() {
     --timeout <초>   콜백 대기 시간 (기본 600)
     --force          기존 토큰 무시하고 강제 재로그인
     --help           이 도움말
-`);
+`,
+    expired: '만료됨',
+    minsLeft: (n) => `${n}분 남음`,
+    hoursLeft: (n) => `${n}시간 남음`,
+    daysLeft: (n) => `${n}일 남음`,
+    errCode: (code) => `     코드: ${code}`,
+    statusTitle: '  ☕ Mimi Seed — 인증 상태',
+    statusFresh: (left) => `  ✅ 연결됨 — 토큰 유효 (${left})`,
+    statusRefreshed: (left) => `  ✅ 연결됨 — refresh_token으로 갱신 (${left})`,
+    statusExpired: '  ⚠️  토큰 만료 + 자동 갱신 실패',
+    statusNone: '  ❌ 연결된 계정 없음.',
+    refreshTrying: '  🔄 refresh_token으로 갱신 시도 중...',
+    refreshNotNeeded: (left) => `  ✅ 토큰 유효 — 갱신 불필요 (${left})`,
+    refreshDone: (left) => `  ✅ 갱신 완료 (${left})`,
+    refreshFailed: '  ❌ refresh 실패',
+    refreshNoToken: '  ❌ 저장된 토큰 없음.',
+    logoutDone: '  ✅ 토큰 삭제 완료.',
+    logoutAlready: '  (이미 삭제된 상태)',
+    loginTitle: '  ☕ Mimi Seed — Google 계정 연결',
+    loginChecking: '  🔍 기존 토큰 검사 중...',
+    loginValid: '유효함',
+    loginRefreshed: 'refresh_token으로 갱신 완료',
+    loginAlready: (label, left) => `  ✅ 이미 연결됨 (${label}, ${left}).`,
+    loginAgain: '  다시 로그인할래? (y/N): ',
+    loginExpiredRelogin: (code) => `  ⚠️  토큰 만료 + 자동 갱신 실패 [${code}] — 재로그인 진행.`,
+    serverStart: '  🌐 OAuth 콜백 서버 시작: http://localhost:9876/callback',
+    serverFail: '  ❌ 콜백 서버 시작 실패',
+    pasteUrl: '  📋 아래 URL을 브라우저에 직접 붙여넣으세요:',
+    openingBrowser: '  🌐 기본 브라우저 자동 열기...',
+    openingHint: '     (실패 시 --no-browser 로 URL 직접 받기)',
+    openFail: (msg) => `  ⚠️  브라우저 자동 열기 실패: ${msg}`,
+    openManually: '  📋 직접 열어주세요:',
+    waiting: (sec) => `  ⏳ Google 승인 대기 중... (timeout ${sec}s)`,
+    authFailed: '  ❌ 인증 실패',
+    done: '  ✅ 연결 완료!',
+    nextTitle: '  이제 Claude Code 또는 Codex에서 이렇게 쓸 수 있어:',
+    nextExample1: '    "내 Firebase 프로젝트 보여줘"',
+    nextExample2: '    "새 Android 앱 등록해줘"',
+    nextExample3: '    "google-services.json 다운로드해줘"',
+    fatal: (msg) => `  ❌ 예외: ${msg}`,
+};
+const en = {
+    help: `
+  ☕ mimi-seed-auth — Google OAuth CLI
+
+  Usage:
+    mimi-seed-auth                  # log in (tries a silent refresh if a token exists)
+    mimi-seed-auth --refresh        # only refresh with refresh_token (no browser)
+    mimi-seed-auth --status         # print the current token status
+    mimi-seed-auth --logout         # delete the token
+
+  Options:
+    --no-browser     Do not open the URL automatically (copy-paste it yourself)
+    --timeout <sec>  How long to wait for the callback (default 600)
+    --force          Ignore the existing token and force a re-login
+    --help           This help
+`,
+    expired: 'expired',
+    minsLeft: (n) => `${n} min left`,
+    hoursLeft: (n) => `${n} hr left`,
+    daysLeft: (n) => `${n} days left`,
+    errCode: (code) => `     code: ${code}`,
+    statusTitle: '  ☕ Mimi Seed — Auth status',
+    statusFresh: (left) => `  ✅ Connected — token valid (${left})`,
+    statusRefreshed: (left) => `  ✅ Connected — refreshed with refresh_token (${left})`,
+    statusExpired: '  ⚠️  Token expired + automatic refresh failed',
+    statusNone: '  ❌ No connected account.',
+    refreshTrying: '  🔄 Trying to refresh with refresh_token...',
+    refreshNotNeeded: (left) => `  ✅ Token still valid — no refresh needed (${left})`,
+    refreshDone: (left) => `  ✅ Refreshed (${left})`,
+    refreshFailed: '  ❌ Refresh failed',
+    refreshNoToken: '  ❌ No stored token.',
+    logoutDone: '  ✅ Token deleted.',
+    logoutAlready: '  (already deleted)',
+    loginTitle: '  ☕ Mimi Seed — Connect your Google account',
+    loginChecking: '  🔍 Checking the existing token...',
+    loginValid: 'valid',
+    loginRefreshed: 'refreshed with refresh_token',
+    loginAlready: (label, left) => `  ✅ Already connected (${label}, ${left}).`,
+    loginAgain: '  Log in again? (y/N): ',
+    loginExpiredRelogin: (code) => `  ⚠️  Token expired + automatic refresh failed [${code}] — re-logging in.`,
+    serverStart: '  🌐 Starting the OAuth callback server: http://localhost:9876/callback',
+    serverFail: '  ❌ Failed to start the callback server',
+    pasteUrl: '  📋 Paste this URL into your browser:',
+    openingBrowser: '  🌐 Opening your default browser...',
+    openingHint: '     (if that fails, use --no-browser to get the URL)',
+    openFail: (msg) => `  ⚠️  Could not open the browser: ${msg}`,
+    openManually: '  📋 Please open it yourself:',
+    waiting: (sec) => `  ⏳ Waiting for Google approval... (timeout ${sec}s)`,
+    authFailed: '  ❌ Authentication failed',
+    done: '  ✅ Connected!',
+    nextTitle: '  Now you can say things like this in Claude Code or Codex:',
+    nextExample1: '    "Show my Firebase projects"',
+    nextExample2: '    "Register a new Android app"',
+    nextExample3: '    "Download google-services.json"',
+    fatal: (msg) => `  ❌ Exception: ${msg}`,
+};
+const M = resolveLang() === 'en' ? en : ko;
+const args = process.argv.slice(2);
+const hasFlag = (name) => args.includes(`--${name}`);
+const flagValue = (name) => {
+    const i = args.indexOf(`--${name}`);
+    if (i < 0)
+        return undefined;
+    const v = args[i + 1];
+    return v && !v.startsWith('--') ? v : undefined;
+};
+function err(msg) {
+    process.stderr.write(msg + '\n');
+}
+function printHelp() {
+    err(M.help);
 }
 function fmtRemaining(ms) {
     if (ms <= 0)
-        return '만료됨';
+        return M.expired;
     const min = Math.round(ms / 60000);
     if (min < 60)
-        return `${min}분 남음`;
+        return M.minsLeft(min);
     const hr = Math.round(min / 60);
     if (hr < 48)
-        return `${hr}시간 남음`;
-    return `${Math.round(hr / 24)}일 남음`;
+        return M.hoursLeft(hr);
+    return M.daysLeft(Math.round(hr / 24));
 }
 function printAuthError(p) {
-    err(`     코드: ${p.code}`);
+    err(M.errCode(p.code));
     err(`     ${p.message}`);
     if (p.hint)
         err(`     → ${p.hint}`);
@@ -54,25 +157,25 @@ function printAuthError(p) {
 }
 async function cmdStatus() {
     err('');
-    err('  ☕ Mimi Seed — 인증 상태');
+    err(M.statusTitle);
     err('');
     const r = await ensureFreshAccessToken();
     switch (r.status) {
         case 'fresh':
-            err(`  ✅ 연결됨 — 토큰 유효 (${fmtRemaining(r.msUntilExpiry)})`);
+            err(M.statusFresh(fmtRemaining(r.msUntilExpiry)));
             err('');
             return 0;
         case 'refreshed':
-            err(`  ✅ 연결됨 — refresh_token으로 갱신 (${fmtRemaining(r.msUntilExpiry)})`);
+            err(M.statusRefreshed(fmtRemaining(r.msUntilExpiry)));
             err('');
             return 0;
         case 'expired_refresh_failed':
-            err('  ⚠️  토큰 만료 + 자동 갱신 실패');
+            err(M.statusExpired);
             printAuthError(r.error);
             err('');
             return 2;
         case 'unauthenticated':
-            err('  ❌ 연결된 계정 없음.');
+            err(M.statusNone);
             printAuthError(r.error);
             err('');
             return 1;
@@ -80,25 +183,25 @@ async function cmdStatus() {
 }
 async function cmdRefresh() {
     err('');
-    err('  🔄 refresh_token으로 갱신 시도 중...');
+    err(M.refreshTrying);
     err('');
     const r = await ensureFreshAccessToken(0); // 무조건 갱신 시도
     switch (r.status) {
         case 'fresh':
-            err(`  ✅ 토큰 유효 — 갱신 불필요 (${fmtRemaining(r.msUntilExpiry)})`);
+            err(M.refreshNotNeeded(fmtRemaining(r.msUntilExpiry)));
             err('');
             return 0;
         case 'refreshed':
-            err(`  ✅ 갱신 완료 (${fmtRemaining(r.msUntilExpiry)})`);
+            err(M.refreshDone(fmtRemaining(r.msUntilExpiry)));
             err('');
             return 0;
         case 'expired_refresh_failed':
-            err('  ❌ refresh 실패');
+            err(M.refreshFailed);
             printAuthError(r.error);
             err('');
             return 2;
         case 'unauthenticated':
-            err('  ❌ 저장된 토큰 없음.');
+            err(M.refreshNoToken);
             printAuthError(r.error);
             err('');
             return 1;
@@ -112,10 +215,10 @@ async function cmdLogout() {
     err('');
     if (fs.existsSync(tokenPath)) {
         fs.rmSync(tokenPath, { force: true });
-        err('  ✅ 토큰 삭제 완료.');
+        err(M.logoutDone);
     }
     else {
-        err('  (이미 삭제된 상태)');
+        err(M.logoutAlready);
     }
     err('');
     return 0;
@@ -125,20 +228,20 @@ async function cmdLogin() {
     const force = hasFlag('force');
     const timeoutSec = parseInt(flagValue('timeout') ?? '600', 10);
     err('');
-    err('  ☕ Mimi Seed — Google 계정 연결');
+    err(M.loginTitle);
     err('');
     // 1) 기존 토큰이 있으면 silent refresh 먼저 시도
     if (!force) {
         const existing = getStoredTokens();
         if (existing) {
-            err('  🔍 기존 토큰 검사 중...');
+            err(M.loginChecking);
             const r = await ensureFreshAccessToken();
             if (r.status === 'fresh' || r.status === 'refreshed') {
-                const label = r.status === 'fresh' ? '유효함' : 'refresh_token으로 갱신 완료';
-                err(`  ✅ 이미 연결됨 (${label}, ${fmtRemaining(r.msUntilExpiry)}).`);
+                const label = r.status === 'fresh' ? M.loginValid : M.loginRefreshed;
+                err(M.loginAlready(label, fmtRemaining(r.msUntilExpiry)));
                 err('');
                 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-                const answer = await new Promise((res) => rl.question('  다시 로그인할래? (y/N): ', res));
+                const answer = await new Promise((res) => rl.question(M.loginAgain, res));
                 rl.close();
                 if (answer.toLowerCase() !== 'y') {
                     err('');
@@ -146,7 +249,7 @@ async function cmdLogin() {
                 }
             }
             else if (r.status === 'expired_refresh_failed') {
-                err(`  ⚠️  토큰 만료 + 자동 갱신 실패 [${r.error.code}] — 재로그인 진행.`);
+                err(M.loginExpiredRelogin(r.error.code));
                 if (r.error.cause && process.env.DEBUG)
                     err(`     cause: ${r.error.cause}`);
             }
@@ -154,7 +257,7 @@ async function cmdLogin() {
     }
     // 2) OAuth 콜백 서버 + URL 발급
     err('');
-    err('  🌐 OAuth 콜백 서버 시작: http://localhost:9876/callback');
+    err(M.serverStart);
     let url;
     let wait;
     try {
@@ -166,7 +269,7 @@ async function cmdLogin() {
         wait = r.wait;
     }
     catch (e) {
-        err('  ❌ 콜백 서버 시작 실패');
+        err(M.serverFail);
         printAuthError(classifyError(e, { phase: 'login' }));
         err('');
         return 1;
@@ -174,25 +277,25 @@ async function cmdLogin() {
     // 3) 브라우저 열기 (or URL 출력)
     if (noBrowser) {
         err('');
-        err('  📋 아래 URL을 브라우저에 직접 붙여넣으세요:');
+        err(M.pasteUrl);
         err('');
         err('     ' + url);
         err('');
     }
     else {
-        err('  🌐 기본 브라우저 자동 열기...');
+        err(M.openingBrowser);
         try {
             await open(url);
-            err('     (실패 시 --no-browser 로 URL 직접 받기)');
+            err(M.openingHint);
         }
         catch (e) {
-            err('  ⚠️  브라우저 자동 열기 실패: ' + (e instanceof Error ? e.message : String(e)));
-            err('  📋 직접 열어주세요:');
+            err(M.openFail(e instanceof Error ? e.message : String(e)));
+            err(M.openManually);
             err('     ' + url);
         }
     }
     // 4) 콜백 대기
-    err(`  ⏳ Google 승인 대기 중... (timeout ${timeoutSec}s)`);
+    err(M.waiting(timeoutSec));
     // 진행 표시기 — 사용자에게 살아있다는 신호 전달
     const ticker = setInterval(() => process.stderr.write('.'), 5000);
     try {
@@ -201,7 +304,7 @@ async function cmdLogin() {
     catch (e) {
         clearInterval(ticker);
         err('');
-        err('  ❌ 인증 실패');
+        err(M.authFailed);
         if (e instanceof AuthError) {
             printAuthError(e.payload);
         }
@@ -214,12 +317,12 @@ async function cmdLogin() {
     clearInterval(ticker);
     err('');
     err('');
-    err('  ✅ 연결 완료!');
+    err(M.done);
     err('');
-    err('  이제 Claude Code 또는 Codex에서 이렇게 쓸 수 있어:');
-    err('    "내 Firebase 프로젝트 보여줘"');
-    err('    "새 Android 앱 등록해줘"');
-    err('    "google-services.json 다운로드해줘"');
+    err(M.nextTitle);
+    err(M.nextExample1);
+    err(M.nextExample2);
+    err(M.nextExample3);
     err('');
     return 0;
 }
@@ -241,7 +344,7 @@ async function main() {
 }
 main().catch((e) => {
     err('');
-    err('  ❌ 예외: ' + (e instanceof Error ? e.message : String(e)));
+    err(M.fatal(e instanceof Error ? e.message : String(e)));
     err('');
     process.exit(1);
 });