@yoonion/mimi-seed-mcp 0.6.6 → 0.8.0

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

@@ -2,36 +2,83 @@
 import { saveServiceAccountJson, getServiceAccountJson } from './playstore-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 — Google Play 서비스 계정 연결',
+    already: (email) => `  ✅ 이미 연결됨 (${email})`,
+    existingBroken: '  ⚠️  저장된 서비스 계정이 있지만 파싱 오류',
+    reconnect: '  다시 설정할래? (y/N): ',
+    needTitle: '  Google Play 서비스 계정 키 JSON 파일이 필요해:',
+    step1: '  1. Google Cloud Console → IAM & Admin → Service Accounts',
+    step2: '  2. 서비스 계정 선택 → Keys → Add Key → Create new key → JSON',
+    step3: '  3. 다운로드한 JSON 파일 경로를 입력해',
+    askPath: '  서비스 계정 JSON 파일 경로: ',
+    noFile: (p) => `  ❌ 파일 없음: ${p}`,
+    badJson: '  ❌ JSON 파싱 실패 — 올바른 서비스 계정 키 파일인지 확인해줘',
+    notServiceAccount: '  ❌ 서비스 계정 JSON 형식이 아니야.',
+    notServiceAccountFields: '  type="service_account", client_email, private_key 필드가 있어야 해.',
+    saved: (email) => `  ✅ 저장 완료! (${email})`,
+    nextTitle: '  이제 Claude Code 또는 Codex에서:',
+    nextExample1: '    "내 Play 스토어 앱 리스팅 보여줘"',
+    nextExample2: '    "Play 구독 상품 목록 보여줘"',
+    permWarn: '  ⚠️  Play Console 권한 확인:',
+    permStep1: '    Play Console → Users and permissions → 이 서비스 계정 추가',
+    permStep2: '    앱 권한에서 "View financial data" + "Manage store listing" 체크',
+};
+const en = {
+    title: '  🤖 Mimi Seed — Connect a Google Play service account',
+    already: (email) => `  ✅ Already connected (${email})`,
+    existingBroken: '  ⚠️  A service account is saved, but it failed to parse',
+    reconnect: '  Set it up again? (y/N): ',
+    needTitle: '  A Google Play service-account key JSON file is required:',
+    step1: '  1. Google Cloud Console → IAM & Admin → Service Accounts',
+    step2: '  2. Pick a service account → Keys → Add Key → Create new key → JSON',
+    step3: '  3. Enter the path to the downloaded JSON file',
+    askPath: '  Path to the service-account JSON file: ',
+    noFile: (p) => `  ❌ File not found: ${p}`,
+    badJson: '  ❌ Failed to parse JSON — check that this is a valid service-account key file',
+    notServiceAccount: '  ❌ This is not a service-account JSON.',
+    notServiceAccountFields: '  It must contain type="service_account", client_email and private_key fields.',
+    saved: (email) => `  ✅ Saved! (${email})`,
+    nextTitle: '  Now, in Claude Code or Codex:',
+    nextExample1: '    "Show my Play Store listing"',
+    nextExample2: '    "List my Play subscriptions"',
+    permWarn: '  ⚠️  Check the Play Console permissions:',
+    permStep1: '    Play Console → Users and permissions → invite this service account',
+    permStep2: '    In the app permissions, check "View financial data" + "Manage store listing"',
+};
+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 — Google Play 서비스 계정 연결');
+    console.log(M.title);
     console.log('');
     const existing = getServiceAccountJson();
     if (existing) {
         try {
             const parsed = JSON.parse(existing);
-            console.log(`  ✅ 이미 연결됨 (${parsed.client_email ?? '?'})`);
+            console.log(M.already(parsed.client_email ?? '?'));
         }
         catch {
-            console.log('  ⚠️  저장된 서비스 계정이 있지만 파싱 오류');
+            console.log(M.existingBroken);
         }
-        const answer = await ask('  다시 설정할래? (y/N): ');
+        const answer = await ask(M.reconnect);
         if (answer.toLowerCase() !== 'y') {
             rl.close();
             return;
         }
     }
-    console.log('  Google Play 서비스 계정 키 JSON 파일이 필요해:');
-    console.log('  1. Google Cloud Console → IAM & Admin → Service Accounts');
-    console.log('  2. 서비스 계정 선택 → Keys → Add Key → Create new key → JSON');
-    console.log('  3. 다운로드한 JSON 파일 경로를 입력해');
+    console.log(M.needTitle);
+    console.log(M.step1);
+    console.log(M.step2);
+    console.log(M.step3);
     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);
     }
@@ -41,27 +88,27 @@ async function main() {
         parsed = JSON.parse(json);
     }
     catch {
-        console.log('  ❌ JSON 파싱 실패 — 올바른 서비스 계정 키 파일인지 확인해줘');
+        console.log(M.badJson);
         rl.close();
         process.exit(1);
     }
     if (parsed.type !== 'service_account' || !parsed.client_email || !parsed.private_key) {
-        console.log('  ❌ 서비스 계정 JSON 형식이 아니야.');
-        console.log('  type="service_account", client_email, private_key 필드가 있어야 해.');
+        console.log(M.notServiceAccount);
+        console.log(M.notServiceAccountFields);
         rl.close();
         process.exit(1);
     }
     saveServiceAccountJson(json);
     console.log('');
-    console.log(`  ✅ 저장 완료! (${parsed.client_email})`);
+    console.log(M.saved(parsed.client_email));
     console.log('');
-    console.log('  이제 Claude Code 또는 Codex에서:');
-    console.log('    "내 Play 스토어 앱 리스팅 보여줘"');
-    console.log('    "Play 구독 상품 목록 보여줘"');
+    console.log(M.nextTitle);
+    console.log(M.nextExample1);
+    console.log(M.nextExample2);
     console.log('');
-    console.log('  ⚠️  Play Console 권한 확인:');
-    console.log('    Play Console → Users and permissions → 이 서비스 계정 추가');
-    console.log('    앱 권한에서 "View financial data" + "Manage store listing" 체크');
+    console.log(M.permWarn);
+    console.log(M.permStep1);
+    console.log(M.permStep2);
     console.log('');
     rl.close();
 }

package/dist/facebook/setup.d.ts

@@ -0,0 +1,6 @@
+export interface ConnectResult {
+    ok: boolean;
+    /** 사용자에게 그대로 보여줄 메시지 (MCP 는 content 로 감싸고, CLI 는 그대로 출력). */
+    text: string;
+}
+export declare function connectFacebook(pageAccessToken: string, pageId?: string): Promise<ConnectResult>;

package/dist/facebook/setup.js

@@ -0,0 +1,72 @@
+// Facebook 페이지 연결 — pageId 자동 조회 → 토큰 검증 → 검증 성공 시에만 저장.
+//
+// 이 로직은 MCP 도구(facebook_save_config)와 setup CLI(mimi-seed-social-auth)가 **공유**한다.
+// 둘 중 하나에만 검증이 있으면 "CLI 로 저장했는데 도구가 못 읽는" 류의 드리프트가 생긴다.
+import { saveFacebookConfig } from './config.js';
+import * as api from './api.js';
+const SIXTY_DAYS_MS = 60 * 24 * 60 * 60 * 1000;
+export async function connectFacebook(pageAccessToken, pageId) {
+    let resolvedPageId = pageId;
+    if (!resolvedPageId) {
+        try {
+            const pages = await api.listAccessiblePages(pageAccessToken);
+            if (pages.length === 0) {
+                // 이미 Page Access Token 인 경우 — /me 가 곧 페이지다.
+                const res = await fetch(`https://graph.facebook.com/v21.0/me?fields=id,name&access_token=${pageAccessToken}`);
+                const data = (await res.json());
+                if (data.error)
+                    throw new Error(`${data.error.message} (code ${data.error.code})`);
+                resolvedPageId = data.id;
+            }
+            else if (pages.length === 1) {
+                resolvedPageId = pages[0].id;
+            }
+            else {
+                const list = pages.map((p) => `  • ${p.name} (${p.id})`).join('\n');
+                return {
+                    ok: false,
+                    text: ['여러 페이지에 접근 가능합니다. pageId를 명시해주세요:', list].join('\n'),
+                };
+            }
+        }
+        catch (err) {
+            return { ok: false, text: `❌ pageId 자동 조회 실패: ${err.message}` };
+        }
+    }
+    try {
+        const page = await api.getPage({ pageAccessToken, pageId: resolvedPageId });
+        saveFacebookConfig({
+            pageAccessToken,
+            pageId: resolvedPageId,
+            pageName: page.name,
+            expiresAt: new Date(Date.now() + SIXTY_DAYS_MS).toISOString(),
+        });
+        return {
+            ok: true,
+            text: [
+                '✅ Facebook 페이지 연결 완료',
+                `   페이지: ${page.name}`,
+                `   ID: ${page.id}`,
+                page.category ? `   카테고리: ${page.category}` : '',
+                page.followers_count !== undefined
+                    ? `   팔로워: ${page.followers_count.toLocaleString()}`
+                    : '',
+                page.fan_count !== undefined ? `   좋아요: ${page.fan_count.toLocaleString()}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+        };
+    }
+    catch (err) {
+        // 검증 실패 → 저장하지 않는다.
+        return {
+            ok: false,
+            text: [
+                '❌ 토큰 검증 실패',
+                `   ${err.message}`,
+                '',
+                'Page Access Token을 다시 확인하거나 facebook_list_pages로 페이지 목록을 조회하세요.',
+            ].join('\n'),
+        };
+    }
+}

package/dist/googleads/setup-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/googleads/setup-cli.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+// mimi-seed-googleads-auth — Google Ads 연결 설정 (~/.mimi-seed/google-ads.json).
+//
+// Ads 는 Google OAuth 토큰의 `adwords` 스코프를 타므로, 개발자 토큰만 있어도 스코프가 없으면
+// 실패한다. 저장 후 listAccessibleCustomers 로 **실제 호출**해서 그 경우를 여기서 잡아낸다.
+import readline from 'node:readline';
+import { loadConfig, saveConfig, normalizeCustomerId } from './config.js';
+import { listAccessibleCustomers } from './tools.js';
+import { getAuthenticatedClient } from '../auth/google-auth.js';
+import { resolveLang } from '../lib/lang.js';
+// ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
+const ko = {
+    title: '  🤖 Mimi Seed — Google Ads 연결',
+    already: (customerId) => `  ✅ 이미 연결됨 (customerId: ${customerId})`,
+    reconnect: '  다시 설정할래? (y/N): ',
+    needTitle: '  필요한 것 2가지:',
+    needToken: '  1. Developer Token — Google Ads → 도구 및 설정 → 설정 → API 센터',
+    needTokenWarn: '     ⚠️  최초 발급은 "테스트" 등급이고, 실계정 조회는 **승인 심사**를 거쳐야 해.',
+    needCustomerId: '  2. Customer ID — Google Ads 우상단 계정 번호 (예: 123-456-7890)',
+    askToken: '  Developer Token: ',
+    askCustomerId: '  Customer ID (예: 123-456-7890): ',
+    askLoginCustomerId: '  MCC(관리자) 계정 ID (선택, 엔터 스킵): ',
+    required: '  ❌ Developer Token 과 Customer ID 는 필수야.',
+    noOauth: '  ❌ Google OAuth 토큰이 없어 검증할 수 없어. 저장하지 않았어.',
+    noOauthFix: '     먼저: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth',
+    probing: '  🔎 접근 가능한 고객 계정 조회 중...',
+    probeOk: (n) => `  ✅ 접근 OK — 계정 ${n}개`,
+    probeFail: (msg) => `  ❌ 검증 실패: ${msg}`,
+    hintScope: '  → OAuth 토큰에 `adwords` 스코프가 없을 가능성이 커.',
+    hintScopeFix: '     재인증: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth --force',
+    hintOther: '  → Developer Token 등급(테스트/승인)과 Customer ID 를 다시 확인해줘.',
+    notSaved: '  저장하지 않았어 (기존 설정이 있으면 그대로 유지된다).',
+    saved: '  ✅ 저장 완료 → ~/.mimi-seed/google-ads.json',
+};
+const en = {
+    title: '  🤖 Mimi Seed — Connect Google Ads',
+    already: (customerId) => `  ✅ Already connected (customerId: ${customerId})`,
+    reconnect: '  Set it up again? (y/N): ',
+    needTitle: '  Two things are needed:',
+    needToken: '  1. Developer Token — Google Ads → Tools and settings → Setup → API Center',
+    needTokenWarn: '     ⚠️  A new token starts at "Test" access level; querying real accounts requires **API-Center approval**.',
+    needCustomerId: '  2. Customer ID — the account number at the top right of Google Ads (e.g. 123-456-7890)',
+    askToken: '  Developer Token: ',
+    askCustomerId: '  Customer ID (e.g. 123-456-7890): ',
+    askLoginCustomerId: '  MCC (manager) account ID (optional, Enter to skip): ',
+    required: '  ❌ Developer Token and Customer ID are required.',
+    noOauth: '  ❌ No Google OAuth token, so this cannot be verified. Nothing was saved.',
+    noOauthFix: '     First run: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth',
+    probing: '  🔎 Listing accessible customer accounts...',
+    probeOk: (n) => `  ✅ Access OK — ${n} account(s)`,
+    probeFail: (msg) => `  ❌ Verification failed: ${msg}`,
+    hintScope: '  → Your OAuth token most likely lacks the `adwords` scope.',
+    hintScopeFix: '     Re-authenticate: npx -y @yoonion/mimi-seed-mcp mimi-seed-auth --force',
+    hintOther: '  → Double-check the Developer Token access level (test / approved) and the Customer ID.',
+    notSaved: '  Nothing was saved (an existing config is left untouched).',
+    saved: '  ✅ Saved → ~/.mimi-seed/google-ads.json',
+};
+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, (a) => r(a.trim())));
+async function main() {
+    console.log('');
+    console.log(M.title);
+    console.log('');
+    const existing = loadConfig();
+    if (existing) {
+        console.log(M.already(existing.customerId));
+        const answer = await ask(M.reconnect);
+        if (answer.toLowerCase() !== 'y') {
+            rl.close();
+            return;
+        }
+    }
+    console.log(M.needTitle);
+    console.log(M.needToken);
+    console.log(M.needTokenWarn);
+    console.log(M.needCustomerId);
+    console.log('');
+    const developerToken = await ask(M.askToken);
+    const customerId = await ask(M.askCustomerId);
+    const loginCustomerId = await ask(M.askLoginCustomerId);
+    if (!developerToken || !customerId) {
+        console.log(M.required);
+        rl.close();
+        process.exit(1);
+    }
+    const cfg = {
+        developerToken,
+        customerId: normalizeCustomerId(customerId),
+        loginCustomerId: loginCustomerId ? normalizeCustomerId(loginCustomerId) : undefined,
+    };
+    // 검증을 **저장보다 먼저** 한다 (jenkins/facebook/instagram 과 같은 규율).
+    // 먼저 저장해버리면 (a) 403 나는 설정인데 doctor 가 ✓ 로 표시하고,
+    // (b) 오타 한 번에 잘 되던 기존 설정이 백업 없이 덮여 날아간다.
+    const auth = getAuthenticatedClient();
+    if (!auth) {
+        console.log('');
+        console.log(M.noOauth);
+        console.log(M.noOauthFix);
+        rl.close();
+        process.exit(1);
+    }
+    console.log('');
+    console.log(M.probing);
+    try {
+        const customers = await listAccessibleCustomers(auth, cfg);
+        console.log(M.probeOk(customers.length));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.log(M.probeFail(msg));
+        console.log('');
+        if (/scope|insufficient|PERMISSION_DENIED/i.test(msg)) {
+            console.log(M.hintScope);
+            console.log(M.hintScopeFix);
+        }
+        else {
+            console.log(M.hintOther);
+        }
+        console.log('');
+        console.log(M.notSaved);
+        rl.close();
+        process.exit(1);
+    }
+    saveConfig(cfg);
+    console.log('');
+    console.log(M.saved);
+    console.log('');
+    rl.close();
+}
+main().catch((e) => {
+    console.error(`\n  ❌ ${e instanceof Error ? e.message : String(e)}\n`);
+    rl.close();
+    process.exit(1);
+});

package/dist/index.js

@@ -14,6 +14,9 @@ const SUBCOMMANDS = {
     'mimi-seed-playstore-auth': () => import('./auth/playstore-setup-cli.js'),
     'mimi-seed-appstore-auth': () => import('./appstore/setup-cli.js'),
     'mimi-seed-bigquery-auth': () => import('./auth/bigquery-setup-cli.js'),
+    'mimi-seed-jenkins-auth': () => import('./jenkins/setup-cli.js'),
+    'mimi-seed-googleads-auth': () => import('./googleads/setup-cli.js'),
+    'mimi-seed-social-auth': () => import('./social/setup-cli.js'),
     'mimi-seed-firebase': () => import('./firebase/cli.js'),
     'mimi-seed-admob': () => import('./admob/cli.js'),
     'mimi-seed-ga4': () => import('./ga4/cli.js'),

package/dist/instagram/setup.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectResult } from '../facebook/setup.js';
+/** IGAA… = Instagram Login(신규) · EAA… = Facebook Login(FB Page + IG Business 연결 필요) */
+export declare function detectApiType(accessToken: string): string;
+export declare function connectInstagram(accessToken: string, userId?: string, assumeIssuedNow?: boolean): Promise<ConnectResult>;

package/dist/instagram/setup.js

@@ -0,0 +1,70 @@
+// Instagram 연결 — userId 자동 조회 → 토큰 검증 → 검증 성공 시에만 저장.
+// MCP 도구(instagram_save_config)와 setup CLI(mimi-seed-social-auth)가 **공유**하는 구현.
+import { saveInstagramConfig } from './config.js';
+import * as api from './api.js';
+const SIXTY_DAYS_MS = 60 * 24 * 60 * 60 * 1000;
+/** IGAA… = Instagram Login(신규) · EAA… = Facebook Login(FB Page + IG Business 연결 필요) */
+export function detectApiType(accessToken) {
+    return accessToken.startsWith('IGAA') ? 'Instagram Login' : 'Facebook Login';
+}
+export async function connectInstagram(accessToken, userId, assumeIssuedNow = true) {
+    const apiType = detectApiType(accessToken);
+    let resolvedUserId = userId;
+    if (!resolvedUserId) {
+        try {
+            resolvedUserId = await api.fetchUserId(accessToken);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                text: [
+                    `❌ userId 자동 조회 실패 (${apiType})`,
+                    `   ${err.message}`,
+                    '',
+                    'userId를 명시적으로 전달하거나 토큰을 다시 확인하세요.',
+                ].join('\n'),
+            };
+        }
+    }
+    const expiresAt = assumeIssuedNow
+        ? new Date(Date.now() + SIXTY_DAYS_MS).toISOString()
+        : undefined;
+    try {
+        const account = await api.getAccount({ accessToken, userId: resolvedUserId });
+        saveInstagramConfig({
+            accessToken,
+            userId: resolvedUserId,
+            expiresAt,
+            username: account.username,
+        });
+        return {
+            ok: true,
+            text: [
+                `✅ Instagram 연결 확인 완료 (${apiType})`,
+                `   계정: @${account.username}${account.name ? ` (${account.name})` : ''}`,
+                `   ID: ${account.id}`,
+                account.account_type ? `   타입: ${account.account_type}` : '',
+                account.followers_count !== undefined
+                    ? `   팔로워: ${account.followers_count.toLocaleString()}`
+                    : '',
+                account.media_count !== undefined ? `   게시물: ${account.media_count}` : '',
+                expiresAt ? `   토큰 만료(추정): ${expiresAt.slice(0, 10)}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n'),
+        };
+    }
+    catch (err) {
+        // 검증 실패 → 저장하지 않는다.
+        return {
+            ok: false,
+            text: [
+                `❌ 토큰 검증 실패 (${apiType})`,
+                `   userId: ${resolvedUserId}`,
+                `   ${err.message}`,
+                '',
+                '토큰을 다시 발급받거나 userId를 직접 지정해보세요.',
+            ].join('\n'),
+        };
+    }
+}

package/dist/jenkins/config.d.ts

@@ -2,7 +2,17 @@ export interface JenkinsConfig {
     url: string;
     username: string;
     token: string;
+    jobAndroid?: string;
+    jobIos?: string;
 }
 export declare function loadJenkinsConfig(): JenkinsConfig | null;
-export declare function saveJenkinsConfig(config: JenkinsConfig): void;
+/**
+ * jenkins.json 저장 — **기존 값 위에 병합한다** (통째로 덮어쓰지 않는다).
+ *
+ * 이 파일에는 두 종류의 필드가 산다: 연결 정보(url/username/token)는 MCP 도구
+ * `jenkins_save_config` 가, 빌드 잡 이름(jobAndroid/jobIos)은 CLI 의 setup 이 쓴다.
+ * 통째로 덮어쓰면 한쪽이 다른 쪽 값을 지운다 — 예전에 Jenkins 설정이 config.json 과
+ * jenkins.json 으로 갈라졌던 것과 같은 종류의 사고다. undefined 인 필드는 건드리지 않는다.
+ */
+export declare function saveJenkinsConfig(config: Partial<JenkinsConfig> & Pick<JenkinsConfig, 'url' | 'username' | 'token'>): void;
 export declare function requireJenkinsConfig(): JenkinsConfig;

package/dist/jenkins/config.js

@@ -11,11 +11,24 @@ export function loadJenkinsConfig() {
         return null;
     }
 }
+/**
+ * jenkins.json 저장 — **기존 값 위에 병합한다** (통째로 덮어쓰지 않는다).
+ *
+ * 이 파일에는 두 종류의 필드가 산다: 연결 정보(url/username/token)는 MCP 도구
+ * `jenkins_save_config` 가, 빌드 잡 이름(jobAndroid/jobIos)은 CLI 의 setup 이 쓴다.
+ * 통째로 덮어쓰면 한쪽이 다른 쪽 값을 지운다 — 예전에 Jenkins 설정이 config.json 과
+ * jenkins.json 으로 갈라졌던 것과 같은 종류의 사고다. undefined 인 필드는 건드리지 않는다.
+ */
 export function saveJenkinsConfig(config) {
     if (!fs.existsSync(CONFIG_DIR)) {
         fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
     }
-    fs.writeFileSync(JENKINS_CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });
+    const existing = loadJenkinsConfig() ?? {};
+    const merged = { ...existing, ...stripUndefined(config) };
+    fs.writeFileSync(JENKINS_CONFIG_PATH, JSON.stringify(merged, null, 2), { mode: 0o600 });
+}
+function stripUndefined(o) {
+    return Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
 }
 export function requireJenkinsConfig() {
     const cfg = loadJenkinsConfig();

package/dist/jenkins/setup-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/jenkins/setup-cli.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+// mimi-seed-jenkins-auth — Jenkins 연결 설정 (~/.mimi-seed/jenkins.json).
+//
+// jenkins_save_config 도구와 달리 저장 **전에** 실제 서버를 프로브한다 (listCredentials).
+// 잘못된 URL/토큰이 조용히 저장돼서 deploy 때 터지는 걸 막는다.
+import readline from 'node:readline';
+import { loadJenkinsConfig, saveJenkinsConfig } from './config.js';
+import { listCredentials } from './credentials.js';
+import { resolveLang } from '../lib/lang.js';
+// ko 가 원본이고 en 은 `typeof ko` 를 만족해야 한다 — 키를 빠뜨리면 컴파일이 깨진다.
+const ko = {
+    title: '  🤖 Mimi Seed — Jenkins 연결',
+    already: (url) => `  ✅ 이미 연결됨 (${url})`,
+    reconnect: '  다시 설정할래? (y/N): ',
+    howToToken: '  API Token 발급: Jenkins → [사용자 이름] → 설정 → API Token → "Add new Token"',
+    remoteOk: '  로컬 Jenkins 가 없어도 회사·원격 서버 URL 을 그대로 쓰면 돼.',
+    askUrl: '  Jenkins URL (예: https://jenkins.company.com): ',
+    askUser: '  Jenkins 사용자 ID: ',
+    askToken: '  Jenkins API Token: ',
+    allRequired: '  ❌ URL / 사용자 ID / 토큰은 모두 필요해.',
+    probing: '  🔎 연결 확인 중...',
+    probeOk: (n) => `  ✅ 연결 OK — 크리덴셜 ${n}개 조회됨`,
+    probeFail: (msg) => `  ❌ 연결 실패: ${msg}`,
+    checkTitle: '  확인할 것:',
+    checkUrl: '   • URL 이 Jenkins 대시보드 주소와 같은지 (예: https://jenkins.company.com)',
+    checkToken: '   • 비밀번호가 아니라 **API Token** 을 넣었는지',
+    checkPerm: '   • 그 계정에 Credentials 조회 권한이 있는지',
+    notSaved: '  저장하지 않았어. 값을 확인하고 다시 실행해줘.',
+    keepCurrent: (cur) => ` (현재: ${cur}, 엔터=유지)`,
+    keepOptional: ' (선택, 엔터 스킵)',
+    askJobAndroid: (keep) => `  Android 빌드 Job 이름${keep}: `,
+    askJobIos: (keep) => `  iOS 빌드 Job 이름${keep}: `,
+    saved: '  ✅ 저장 완료 → ~/.mimi-seed/jenkins.json',
+    savedHint: '     확인: mimi-seed doctor  ·  빌드: mimi-seed deploy',
+};
+const en = {
+    title: '  🤖 Mimi Seed — Connect Jenkins',
+    already: (url) => `  ✅ Already connected (${url})`,
+    reconnect: '  Set it up again? (y/N): ',
+    howToToken: '  Get an API Token: Jenkins → [your user name] → Configure → API Token → "Add new Token"',
+    remoteOk: '  No local Jenkins needed — a company / remote server URL works just as well.',
+    askUrl: '  Jenkins URL (e.g. https://jenkins.company.com): ',
+    askUser: '  Jenkins user ID: ',
+    askToken: '  Jenkins API Token: ',
+    allRequired: '  ❌ URL, user ID and token are all required.',
+    probing: '  🔎 Checking the connection...',
+    probeOk: (n) => `  ✅ Connected — ${n} credential(s) listed`,
+    probeFail: (msg) => `  ❌ Connection failed: ${msg}`,
+    checkTitle: '  Things to check:',
+    checkUrl: '   • The URL matches your Jenkins dashboard address (e.g. https://jenkins.company.com)',
+    checkToken: '   • You entered an **API Token**, not your password',
+    checkPerm: '   • That account is allowed to read Credentials',
+    notSaved: '  Nothing was saved. Check the values and run this again.',
+    keepCurrent: (cur) => ` (current: ${cur}, Enter = keep)`,
+    keepOptional: ' (optional, Enter to skip)',
+    askJobAndroid: (keep) => `  Android build job name${keep}: `,
+    askJobIos: (keep) => `  iOS build job name${keep}: `,
+    saved: '  ✅ Saved → ~/.mimi-seed/jenkins.json',
+    savedHint: '     Check: mimi-seed doctor  ·  Build: mimi-seed deploy',
+};
+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, (a) => r(a.trim())));
+async function main() {
+    console.log('');
+    console.log(M.title);
+    console.log('');
+    const existing = loadJenkinsConfig();
+    if (existing) {
+        console.log(M.already(existing.url));
+        const answer = await ask(M.reconnect);
+        if (answer.toLowerCase() !== 'y') {
+            rl.close();
+            return;
+        }
+    }
+    console.log(M.howToToken);
+    console.log(M.remoteOk);
+    console.log('');
+    const url = await ask(M.askUrl);
+    const username = await ask(M.askUser);
+    const token = await ask(M.askToken);
+    if (!url || !username || !token) {
+        console.log(M.allRequired);
+        rl.close();
+        process.exit(1);
+    }
+    console.log('');
+    console.log(M.probing);
+    const cfg = { url: url.replace(/\/+$/, ''), username, token };
+    try {
+        const creds = await listCredentials(cfg);
+        console.log(M.probeOk(creds.length));
+    }
+    catch (e) {
+        console.log(M.probeFail(e instanceof Error ? e.message : String(e)));
+        console.log('');
+        console.log(M.checkTitle);
+        console.log(M.checkUrl);
+        console.log(M.checkToken);
+        console.log(M.checkPerm);
+        console.log('');
+        console.log(M.notSaved);
+        rl.close();
+        process.exit(1);
+    }
+    // deploy 가 트리거할 잡 이름 (선택) — 같은 파일에 함께 저장한다.
+    // 재설정(토큰 교체 등) 시 엔터로 넘기면 **기존 값을 유지한다** — 조용히 지워버리면
+    // 다음 `mimi-seed deploy` 가 "job 이 설정되지 않았습니다" 로 죽는다.
+    const keep = (cur) => (cur ? M.keepCurrent(cur) : M.keepOptional);
+    const jobAndroid = await ask(M.askJobAndroid(keep(existing?.jobAndroid)));
+    const jobIos = await ask(M.askJobIos(keep(existing?.jobIos)));
+    saveJenkinsConfig({
+        ...cfg,
+        jobAndroid: jobAndroid || existing?.jobAndroid,
+        jobIos: jobIos || existing?.jobIos,
+    });
+    console.log('');
+    console.log(M.saved);
+    console.log(M.savedHint);
+    console.log('');
+    rl.close();
+}
+main().catch((e) => {
+    console.error(`\n  ❌ ${e instanceof Error ? e.message : String(e)}\n`);
+    rl.close();
+    process.exit(1);
+});

package/dist/lib/lang.d.ts

@@ -0,0 +1,5 @@
+export type Lang = 'ko' | 'en';
+export declare const DEFAULT_LANG: Lang;
+export declare function isLang(v: unknown): v is Lang;
+/** 우선순위: 환경변수 > ~/.mimi-seed/settings.json > 기본값(ko). 파일이 없거나 깨져도 ko 로 폴백. */
+export declare function resolveLang(home?: string): Lang;

package/dist/lib/lang.js

@@ -0,0 +1,33 @@
+// 인터랙티브 setup bin 의 출력 언어.
+//
+// CLI 쪽 `packages/cli/src/settings.ts` 의 resolveLang 과 **같은 규칙**이어야 한다:
+//   MIMI_SEED_LANG 환경변수 > ~/.mimi-seed/settings.json { lang } > 'ko'.
+//
+// 환경변수가 1순위인 이유: CLI 마법사가 이 패키지의 setup bin 을 spawn 할 때 MIMI_SEED_LANG 을
+// 물려준다. 마법사와 자식 프로세스의 언어가 어긋나면 온보딩 도중에 언어가 뒤섞인다.
+//
+// MCP 도구의 description / 도구 출력 텍스트는 여기 대상이 아니다 — 그건 사람이 아니라 LLM 이
+// 읽는 인터페이스다. 이 모듈은 **터미널에 찍히는 사람용 문자열**에만 쓴다.
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export const DEFAULT_LANG = 'ko';
+export function isLang(v) {
+    return v === 'ko' || v === 'en';
+}
+/** 우선순위: 환경변수 > ~/.mimi-seed/settings.json > 기본값(ko). 파일이 없거나 깨져도 ko 로 폴백. */
+export function resolveLang(home = os.homedir()) {
+    const env = process.env.MIMI_SEED_LANG?.toLowerCase();
+    if (isLang(env))
+        return env;
+    try {
+        const raw = fs.readFileSync(path.join(home, '.mimi-seed', 'settings.json'), 'utf-8');
+        const saved = JSON.parse(raw).lang;
+        if (isLang(saved))
+            return saved;
+    }
+    catch {
+        // 파일 없음 / 권한 없음 / JSON 깨짐 — 전부 기본값으로.
+    }
+    return DEFAULT_LANG;
+}