@yoonion/mimi-seed-mcp 0.2.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 **Mimi Seed** — Firebase · AdMob · Google Play · App Store Connect를 AI 콘솔에서 관리. Claude Code / Cursor / 기타 MCP 클라이언트에서 한 줄 등록으로 사용.
 
-> 이 패키지는 Mimi Seed의 **MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg> — 향후 `@yoonion/mimi-seed`로 별도 배포 예정.
+> 이 패키지는 Mimi Seed의 **로컬 MCP 서버**만 포함합니다. 웹 콘솔(Next.js 앱)은 <https://mimi-seed.pryzm.gg>.
 
 ## 설치
 
@@ -41,16 +41,100 @@ npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth
 
 (App Store Connect → Users and Access → Keys에서 API Key 생성 후 Issuer ID / Key ID / .p8 경로 입력)
 
-## 제공 도구 (약 40개)
+AI 기능(릴리즈 노트 생성, 리뷰 답변)을 쓰려면:
 
-| 영역 | 도구 예시 |
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+---
+
+## 제공 도구 (65+개)
+
+| 영역 | 주요 도구 |
 |------|---------|
 | Firebase | `firebase_list_projects` / `firebase_create_android_app` / `firebase_get_android_config` / `firebase_enable_service` |
 | AdMob | `admob_list_apps` / `admob_create_ad_unit` / `admob_get_today_earnings` / `admob_get_report` |
-| Google Play | `playstore_list_tracks` / `playstore_list_subscriptions` / `playstore_reply_review` / **`playstore_verify_service_account`** |
-| Google Cloud IAM | `iam_list_service_accounts` / `iam_create_service_account` / `iam_list_keys` / **`iam_create_key`** / `iam_add_iam_policy_binding` |
-| App Store Connect | `appstore_list_apps` / `appstore_list_builds` / `appstore_list_beta_groups` |
-| 상태 | `mimi_seed_auth_status` |
+| Google Play | `playstore_list_tracks` / `playstore_update_listing` / `playstore_replace_images` / `playstore_reply_review` / `playstore_verify_service_account` |
+| Google Cloud IAM | `iam_list_service_accounts` / `iam_create_service_account` / `iam_list_keys` / `iam_create_key` / `iam_add_iam_policy_binding` |
+| App Store Connect | `appstore_list_apps` / `appstore_list_builds` / `appstore_upload_screenshot` / `appstore_update_whats_new` |
+| 제출 위험 점검 | `playstore_check_submission_risks` / `appstore_check_submission_risks` |
+| 스크린샷 검증 | `screenshot_validate` |
+| AI (Claude) | `generate_release_notes_from_commits` / `generate_review_reply` |
+| 인증 | `mimi_seed_auth_status` / `mimi_seed_auth_start` |
+
+---
+
+## 주요 기능
+
+### 제출 위험 점검
+
+출시 전 블로커와 경고를 자동으로 점검합니다.
+
+```
+"내 앱 출시 전 위험 요소 확인해줘"
+→ playstore_check_submission_risks("com.example.myapp")
+→ appstore_check_submission_risks("1234567890")
+```
+
+**점검 항목:**
+- Google Play: 리스팅 완성도(제목/설명/짧은설명), 스크린샷 수, 아이콘, 내부 빌드 존재, 연락처
+- App Store: What's New, 설명/키워드, 스크린샷 커버리지, TestFlight 빌드, 개인정보처리방침 URL
+
+---
+
+### 스크린샷 해상도 검증
+
+업로드 전 로컬 파일을 스토어 규격과 비교합니다.
+
+```
+"이 스크린샷들이 App Store 규격에 맞는지 확인해줘"
+→ screenshot_validate(["/path/to/screen1.png", "/path/to/screen2.png"], platform="ios", displayType="APP_IPHONE_69")
+```
+
+iOS displayType 예시: `APP_IPHONE_69`, `APP_IPHONE_67`, `APP_IPHONE_65`, `APP_IPAD_PRO_3GEN_129`  
+Android imageType 예시: `phoneScreenshots`, `sevenInchScreenshots`, `featureGraphic`
+
+---
+
+### AI 릴리즈 노트 생성 (ANTHROPIC_API_KEY 필요)
+
+git 커밋 내역을 Claude가 사용자 친화적인 릴리즈 노트로 변환합니다.
+
+```
+"최근 커밋으로 릴리즈 노트 만들어줘"
+→ generate_release_notes_from_commits(
+     commits=[{message: "feat: 다크모드 추가"}, ...],
+     appName="MyApp",
+     locales=["ko", "en-US", "ja"]
+   )
+```
+
+3가지 톤(간결/상세/마케팅) + 다국어를 한 번에 생성. 이후 `playstore_update_release_notes` 또는 `appstore_update_whats_new`로 바로 적용.
+
+---
+
+### AI 리뷰 답변 생성 (ANTHROPIC_API_KEY 필요)
+
+스토어 리뷰에 대한 AI 답변 초안을 생성합니다.
+
+```
+"이 리뷰에 답변 작성해줘"
+→ generate_review_reply(
+     reviewText="앱이 자꾸 튕겨요",
+     rating=2,
+     appName="MyApp",
+     tone="empathetic",
+     language="ko"
+   )
+```
+
+tone 옵션: `friendly`(친근) / `professional`(정중) / `empathetic`(공감) / `brief`(간결)
+
+> ⚠ AI 생성 답변은 초안입니다. 게시 전 반드시 검토하세요.  
+> 답변 게시는 `playstore_reply_to_review` 도구를 사용하세요.
+
+---
 
 ## End-to-end: 서비스 계정 → JSON 키 → Play Console 권한
 
@@ -76,22 +160,15 @@ Claude가 연쇄 호출:
 
 > Cloud IAM 역할과 Play Console 권한은 다릅니다. `iam_add_iam_policy_binding`은 Cloud IAM 역할(예: `roles/iam.serviceAccountTokenCreator`)만 부여 — Play Console의 "View financial data"는 별도.
 
-## `playstore_verify_service_account` — 서비스 계정 JSON 검증
-
-[onesub](https://github.com/jeonghwanko/onesub) 같은 서버가 Google Play 영수증을 백그라운드로 검증하려면 OAuth가 아니라 **서비스 계정 JSON**이 필요. 이 도구는 JSON을 붙여넣으면 단계별로 확인:
+---
 
-1. **parse** — JSON 구조 + 필수 필드 (`type`, `client_email`, `private_key`, `project_id`)
-2. **auth** — 실제로 Google에서 OAuth 토큰 받을 수 있는지 (private_key 유효성)
-3. **api** — 'View financial data' 권한 있는지 (`monetization.subscriptions.list` 실 호출)
+## 환경변수
 
-실패 단계별로 해결 순서까지 안내. 통과하면 한 줄 JSON으로 변환해서 서버 환경변수에 쓸 수 있음.
+| 변수 | 설명 |
+|------|------|
+| `ANTHROPIC_API_KEY` | AI 릴리즈 노트 생성 / 리뷰 답변 활성화 (선택) |
 
-예:
-
-> (Claude에게) 이 서비스 계정 JSON이 `com.yourapp.id`에 대해 작동하는지 확인해줘:
-> ```json
-> {"type":"service_account", "project_id":"...", ...}
-> ```
+---
 
 ## 레거시 호환성
 
@@ -103,8 +180,11 @@ Claude가 연쇄 호출:
 
 새로 쓰는 건 `~/.mimi-seed/`.
 
+---
+
 ## Links
 
+- CLI 패키지: [`mimi-seed`](https://www.npmjs.com/package/mimi-seed)
 - 웹 콘솔: https://mimi-seed.pryzm.gg
 - 저장소: https://github.com/jeonghwanko/app-gen
 

package/dist/ai/client.d.ts

@@ -0,0 +1,4 @@
+import Anthropic from '@anthropic-ai/sdk';
+export declare const LOCALE_NAMES: Record<string, string>;
+export declare function requireApiKey(): Anthropic;
+export declare function parseJsonResponse<T>(text: string): T;

package/dist/ai/client.js

@@ -0,0 +1,30 @@
+import Anthropic from '@anthropic-ai/sdk';
+export const LOCALE_NAMES = {
+    'ko': '한국어', 'ko-KR': '한국어',
+    'en': '영어', 'en-US': '영어', 'en-GB': '영어',
+    'ja': '일본어', 'ja-JP': '일본어',
+    'zh': '중국어 (간체)', 'zh-CN': '중국어 (간체)', 'zh-TW': '중국어 (번체)',
+    'es': '스페인어', 'fr': '프랑스어', 'de': '독일어',
+    'pt': '포르투갈어', 'pt-BR': '포르투갈어 (브라질)',
+};
+export function requireApiKey() {
+    const key = process.env.ANTHROPIC_API_KEY;
+    if (!key) {
+        throw new Error([
+            '❌ ANTHROPIC_API_KEY 환경변수가 필요합니다.',
+            '',
+            '설정 방법:',
+            '  export ANTHROPIC_API_KEY=sk-ant-...',
+            '',
+            '또는 Claude Desktop MCP 설정에서:',
+            '  "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }',
+        ].join('\n'));
+    }
+    return new Anthropic({ apiKey: key });
+}
+export function parseJsonResponse(text) {
+    const match = text.match(/\{[\s\S]*\}/);
+    if (!match)
+        throw new Error('AI 응답 파싱 실패. 다시 시도하세요.');
+    return JSON.parse(match[0]);
+}

package/dist/ai/notes.d.ts

@@ -0,0 +1,22 @@
+export interface CommitEntry {
+    hash?: string;
+    message: string;
+    author?: string;
+    date?: string;
+}
+export interface ReleaseNotesTone {
+    name: string;
+    text: string;
+}
+export interface GeneratedReleaseNotes {
+    tones: ReleaseNotesTone[];
+    localized: Record<string, string>;
+    rawCommitsUsed: number;
+}
+export declare function generateReleaseNotesFromCommits(commits: CommitEntry[], opts?: {
+    appName?: string;
+    tones?: string[];
+    locales?: string[];
+    maxTokens?: number;
+}): Promise<GeneratedReleaseNotes>;
+export declare function formatGeneratedNotes(result: GeneratedReleaseNotes): string;

package/dist/ai/notes.js

@@ -0,0 +1,67 @@
+import { requireApiKey, parseJsonResponse, LOCALE_NAMES } from './client.js';
+const TONE_DESCRIPTIONS = {
+    concise: '간결한 버전 (3줄 이내, 불릿 포인트, 사용자 혜택 중심)',
+    detailed: '상세 버전 (주요 변경사항 5~8개, 불릿 포인트, 구체적 기능 설명)',
+    marketing: '마케팅 버전 (감탄사 포함, 가치 제안 강조, 업데이트를 기대하게 만드는 톤)',
+};
+function commitsToText(commits) {
+    return commits
+        .map((c) => {
+        const meta = [c.author, c.date?.slice(0, 10)].filter(Boolean).join(', ');
+        return `- ${c.message}${meta ? ` (${meta})` : ''}`;
+    })
+        .join('\n');
+}
+export async function generateReleaseNotesFromCommits(commits, opts = {}) {
+    const client = requireApiKey();
+    const { appName = '앱', tones = ['concise', 'detailed', 'marketing'], locales = [], maxTokens = 2000 } = opts;
+    const commitsText = commitsToText(commits.slice(0, 50));
+    const localeList = locales.length > 0
+        ? locales.map((l) => `"${l}": "${LOCALE_NAMES[l] ?? l}로 번역된 간결한 버전"`).join(',\n    ')
+        : '';
+    const prompt = `다음은 "${appName}" 앱의 git 커밋 내역입니다.
+사용자 친화적인 릴리즈 노트를 작성해주세요. 기술 용어 대신 사용자 경험 위주로 서술하세요.
+
+커밋 내역:
+${commitsText}
+
+다음 JSON 형식으로 응답하세요 (한국어 기본):
+{
+  "tones": [
+    ${tones.map((t) => `{ "name": "${t}", "text": "${TONE_DESCRIPTIONS[t] ?? t}" }`).join(',\n    ')}
+  ]${localeList ? `,\n  "localized": {\n    ${localeList}\n  }` : ''}
+}
+
+각 tone의 "text" 필드에 실제 릴리즈 노트 내용을 채워주세요.`;
+    const response = await client.messages.create({
+        model: 'claude-haiku-4-5-20251001',
+        max_tokens: maxTokens,
+        system: '앱 스토어 릴리즈 노트 전문 카피라이터입니다. 커밋 내역을 사용자 친화적인 언어로 변환합니다. 항상 유효한 JSON으로만 응답하세요.',
+        messages: [{ role: 'user', content: prompt }],
+    });
+    const text = response.content[0].type === 'text' ? response.content[0].text : '';
+    const parsed = parseJsonResponse(text);
+    return {
+        tones: parsed.tones ?? [],
+        localized: parsed.localized ?? {},
+        rawCommitsUsed: commits.length,
+    };
+}
+export function formatGeneratedNotes(result) {
+    const toneLabels = { concise: '간결한 버전', detailed: '상세 버전', marketing: '마케팅 버전' };
+    const lines = [`🤖 AI 릴리즈 노트 생성 완료 (커밋 ${result.rawCommitsUsed}개 분석)\n`];
+    for (const tone of result.tones) {
+        lines.push(`─── ${toneLabels[tone.name] ?? tone.name} ───`);
+        lines.push(tone.text);
+        lines.push('');
+    }
+    if (Object.keys(result.localized).length > 0) {
+        lines.push('─── 다국어 ───');
+        for (const [locale, text] of Object.entries(result.localized)) {
+            lines.push(`[${locale}]`);
+            lines.push(text);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}

package/dist/ai/review.d.ts

@@ -0,0 +1,15 @@
+export interface ReviewReplyResult {
+    suggested: string;
+    tone: string;
+    language: string;
+    note: string;
+}
+export declare function generateReviewReply(opts: {
+    reviewText: string;
+    rating?: number;
+    appName?: string;
+    tone?: string;
+    language?: string;
+    developerName?: string;
+}): Promise<ReviewReplyResult>;
+export declare function formatReviewReply(result: ReviewReplyResult): string;

package/dist/ai/review.js

@@ -0,0 +1,60 @@
+import { requireApiKey, parseJsonResponse, LOCALE_NAMES } from './client.js';
+const TONE_GUIDES = {
+    friendly: '친근하고 따뜻하게. 이모지 1~2개 사용. 감사 인사로 시작.',
+    professional: '정중하고 공식적으로. 문제를 인정하고 해결책을 제시.',
+    empathetic: '공감을 먼저 표현. 불편을 충분히 인정한 후 해결 의지를 보여줌.',
+    brief: '2~3문장으로 간결하게. 핵심 응답만.',
+};
+const SENTIMENT_PROMPTS = {
+    positive: '긍정적인 리뷰입니다. 감사 인사와 함께 앞으로도 좋은 경험을 제공하겠다는 의지를 표현하세요.',
+    negative: '부정적인 리뷰입니다. 먼저 불편을 사과하고, 문제 해결 의지를 보여주세요. 가능하면 지원 채널로 유도하세요.',
+    neutral: '중립적인 리뷰입니다. 피드백에 감사하고 개선 노력을 약속하세요.',
+    bug_report: '버그 리포트입니다. 문제를 확인했음을 알리고, 수정 예정임을 전달하세요.',
+    feature_request: '기능 요청입니다. 피드백에 감사하고, 검토하겠다고 약속하세요.',
+};
+function detectSentiment(text) {
+    const lower = text.toLowerCase();
+    if (['버그', '오류', '안됨', 'crash', 'bug', 'error', 'broken'].some((w) => lower.includes(w)))
+        return 'bug_report';
+    if (['추가', '원해', '있으면', 'wish', 'feature', 'add', 'would like'].some((w) => lower.includes(w)))
+        return 'feature_request';
+    if (['별로', '실망', '짜증', 'terrible', 'worst', 'awful'].some((w) => lower.includes(w)))
+        return 'negative';
+    if (['좋아', '최고', '훌륭', 'great', 'excellent', 'love', 'perfect'].some((w) => lower.includes(w)))
+        return 'positive';
+    return 'neutral';
+}
+export async function generateReviewReply(opts) {
+    const client = requireApiKey();
+    const { reviewText, rating, appName = '앱', tone = 'friendly', language = 'ko', developerName } = opts;
+    const sentiment = detectSentiment(reviewText);
+    const langName = LOCALE_NAMES[language] ?? language;
+    const response = await client.messages.create({
+        model: 'claude-haiku-4-5-20251001',
+        max_tokens: 500,
+        system: `앱 개발자를 대신해 스토어 리뷰에 답변하는 전문가입니다. ${langName}로 150자 이내로 답변하세요. ${TONE_GUIDES[tone] ?? TONE_GUIDES.friendly} 개발자 이름: ${developerName ?? '개발팀'}`,
+        messages: [{
+                role: 'user',
+                content: `앱: ${appName}\n${rating !== undefined ? `별점: ${'★'.repeat(rating)}${'☆'.repeat(5 - rating)} (${rating}/5)\n` : ''}리뷰: "${reviewText}"\n\n지침: ${SENTIMENT_PROMPTS[sentiment] ?? SENTIMENT_PROMPTS.neutral}\n\nJSON으로만 응답: { "reply": "답변 텍스트" }`,
+            }],
+    });
+    const text = response.content[0].type === 'text' ? response.content[0].text : '';
+    const parsed = parseJsonResponse(text);
+    return {
+        suggested: parsed.reply,
+        tone,
+        language,
+        note: '이 답변은 AI가 생성한 초안입니다. 게시 전 반드시 검토하세요.',
+    };
+}
+export function formatReviewReply(result) {
+    return [
+        '💬 AI 리뷰 답변 초안\n',
+        `─── 제안 답변 (${result.tone} / ${result.language}) ───`,
+        result.suggested,
+        '',
+        `⚠ ${result.note}`,
+        '',
+        '이 답변이 마음에 들면 playstore_reply_to_review 도구로 게시하세요.',
+    ].join('\n');
+}

package/dist/appstore/screenshots.d.ts

@@ -0,0 +1,15 @@
+export declare function listScreenshotSets(localizationId: string): Promise<any>;
+export declare function uploadScreenshot(localizationId: string, displayType: string, filePath: string): Promise<{
+    id: string;
+    fileName: string;
+    fileSize: number;
+    displayType: string;
+}>;
+export declare function deleteScreenshot(screenshotId: string): Promise<{
+    ok: boolean;
+    id: string;
+}>;
+export declare function deleteScreenshotSet(setId: string): Promise<{
+    ok: boolean;
+    id: string;
+}>;

package/dist/appstore/screenshots.js

@@ -0,0 +1,163 @@
+import { getAuthHeaders } from './auth.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+/**
+ * App Store Connect API — Screenshot upload
+ *
+ * 4-step process per Apple docs:
+ *   1. ensureScreenshotSet(localizationId, displayType)
+ *      → POST /appScreenshotSets  (없으면)
+ *   2. reserve — POST /appScreenshots
+ *      → response contains uploadOperations[]
+ *   3. upload — PUT each operation URL (slice of bytes by offset/length)
+ *   4. commit — PATCH /appScreenshots/{id}  { uploaded: true, sourceFileChecksum }
+ */
+const BASE = 'https://api.appstoreconnect.apple.com/v1';
+function authHeadersOrThrow() {
+    const headers = getAuthHeaders();
+    if (!headers) {
+        throw new Error([
+            '❌ App Store Connect 인증이 필요해.',
+            '',
+            '터미널에서 실행:',
+            '  cd c:/users/turbo08/app-gen/packages/mcp-server',
+            '  npx tsx src/appstore/setup-cli.ts',
+        ].join('\n'));
+    }
+    return headers;
+}
+async function req(pathOrUrl, init = {}) {
+    const headers = authHeadersOrThrow();
+    const url = pathOrUrl.startsWith('http') ? pathOrUrl : `${BASE}${pathOrUrl}`;
+    const res = await fetch(url, {
+        ...init,
+        headers: { ...headers, ...(init.headers ?? {}) },
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`App Store API ${res.status} ${init.method ?? 'GET'} ${pathOrUrl}: ${body}`);
+    }
+    const text = await res.text();
+    return (text ? JSON.parse(text) : null);
+}
+// ─── 조회 ───
+export async function listScreenshotSets(localizationId) {
+    const data = await req(`/appStoreVersionLocalizations/${localizationId}/appScreenshotSets` +
+        `?include=appScreenshots` +
+        `&fields[appScreenshotSets]=screenshotDisplayType,appScreenshots` +
+        `&fields[appScreenshots]=fileName,fileSize,assetDeliveryState,imageAsset`);
+    const included = data?.included ?? [];
+    return (data?.data ?? []).map((s) => ({
+        id: s.id,
+        displayType: s.attributes?.screenshotDisplayType,
+        screenshots: (s.relationships?.appScreenshots?.data ?? []).map((ref) => {
+            const inc = included.find((i) => i.type === 'appScreenshots' && i.id === ref.id);
+            return {
+                id: ref.id,
+                fileName: inc?.attributes?.fileName,
+                fileSize: inc?.attributes?.fileSize,
+                state: inc?.attributes?.assetDeliveryState?.state,
+                imageAsset: inc?.attributes?.imageAsset,
+            };
+        }),
+    }));
+}
+// ─── 셋 확보 (존재하면 재사용, 없으면 생성) ───
+async function ensureScreenshotSet(localizationId, displayType) {
+    const existing = await listScreenshotSets(localizationId);
+    const match = existing.find((s) => s.displayType === displayType);
+    if (match)
+        return match.id;
+    const body = {
+        data: {
+            type: 'appScreenshotSets',
+            attributes: { screenshotDisplayType: displayType },
+            relationships: {
+                appStoreVersionLocalization: {
+                    data: { type: 'appStoreVersionLocalizations', id: localizationId },
+                },
+            },
+        },
+    };
+    const created = await req('/appScreenshotSets', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    return created.data.id;
+}
+// ─── 청크 업로드 ───
+async function uploadChunks(filePath, ops) {
+    const buf = fs.readFileSync(filePath);
+    for (const op of ops) {
+        const slice = buf.subarray(op.offset, op.offset + op.length);
+        const headers = {};
+        for (const h of op.requestHeaders)
+            headers[h.name] = h.value;
+        const res = await fetch(op.url, {
+            method: op.method,
+            headers,
+            body: slice,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`청크 업로드 실패 (offset=${op.offset}, length=${op.length}): ${res.status} ${text}`);
+        }
+    }
+}
+// ─── 메인: 업로드 ───
+export async function uploadScreenshot(localizationId, displayType, filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`파일이 존재하지 않아: ${filePath}`);
+    }
+    const absPath = path.resolve(filePath);
+    const buf = fs.readFileSync(absPath);
+    const fileName = path.basename(absPath);
+    const fileSize = buf.length;
+    const md5 = crypto.createHash('md5').update(buf).digest('hex');
+    const screenshotSetId = await ensureScreenshotSet(localizationId, displayType);
+    // reserve
+    const reserved = await req('/appScreenshots', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            data: {
+                type: 'appScreenshots',
+                attributes: { fileName, fileSize },
+                relationships: {
+                    appScreenshotSet: { data: { type: 'appScreenshotSets', id: screenshotSetId } },
+                },
+            },
+        }),
+    });
+    const screenshotId = reserved.data.id;
+    const ops = reserved.data.attributes?.uploadOperations ?? [];
+    if (ops.length === 0) {
+        throw new Error('uploadOperations가 비어있음 — Apple API 응답 형식 확인 필요.');
+    }
+    // upload
+    await uploadChunks(absPath, ops);
+    // commit
+    await req(`/appScreenshots/${screenshotId}`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            data: {
+                type: 'appScreenshots',
+                id: screenshotId,
+                attributes: { uploaded: true, sourceFileChecksum: md5 },
+            },
+        }),
+    });
+    return { id: screenshotId, fileName, fileSize, displayType };
+}
+// ─── 삭제 ───
+export async function deleteScreenshot(screenshotId) {
+    await req(`/appScreenshots/${screenshotId}`, { method: 'DELETE' });
+    return { ok: true, id: screenshotId };
+}
+export async function deleteScreenshotSet(setId) {
+    await req(`/appScreenshotSets/${setId}`, { method: 'DELETE' });
+    return { ok: true, id: setId };
+}

package/dist/appstore/tools.d.ts

@@ -1,7 +1,22 @@
+export declare function apiGet(path: string, params?: Record<string, string>): Promise<any>;
 export declare function listApps(): Promise<any>;
 export declare function getApp(appId: string): Promise<any>;
 export declare function listVersions(appId: string): Promise<any>;
 export declare function getVersionLocalizations(versionId: string): Promise<any>;
+export interface LocalizationUpdateFields {
+    whatsNew?: string;
+    description?: string;
+    keywords?: string;
+    promotionalText?: string;
+    supportUrl?: string;
+    marketingUrl?: string;
+}
+export declare function updateVersionLocalization(localizationId: string, fields: LocalizationUpdateFields): Promise<any>;
+/**
+ * versionId + locale로 로컬라이제이션을 찾아서 PATCH.
+ * localizationId를 직접 모를 때 편의용.
+ */
+export declare function updateVersionWhatsNew(versionId: string, locale: string, fields: LocalizationUpdateFields): Promise<any>;
 export declare function listBuilds(appId: string): Promise<any>;
 export declare function listBetaGroups(appId: string): Promise<any>;
 export declare function getAppInfo(appId: string): Promise<any>;

package/dist/appstore/tools.js

@@ -4,7 +4,7 @@ import { getAuthHeaders } from './auth.js';
  * https://developer.apple.com/documentation/appstoreconnectapi
  */
 const BASE = 'https://api.appstoreconnect.apple.com/v1';
-async function apiGet(path, params) {
+export async function apiGet(path, params) {
     const headers = getAuthHeaders();
     if (!headers)
         throw new Error([
@@ -29,6 +29,29 @@ async function apiGet(path, params) {
     }
     return res.json();
 }
+async function apiPatch(path, body) {
+    const headers = getAuthHeaders();
+    if (!headers)
+        throw new Error([
+            '❌ App Store Connect 인증이 필요해.',
+            '',
+            '터미널에서 실행:',
+            '  cd c:/users/turbo08/app-gen/packages/mcp-server',
+            '  npx tsx src/appstore/setup-cli.ts',
+        ].join('\n'));
+    const res = await fetch(`${BASE}${path}`, {
+        method: 'PATCH',
+        headers: { ...headers, 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`App Store API ${res.status}: ${text}`);
+    }
+    // 204 No Content 가능
+    const text = await res.text();
+    return text ? JSON.parse(text) : { ok: true };
+}
 // ─── 앱 ───
 export async function listApps() {
     const data = await apiGet('/apps', {
@@ -78,6 +101,30 @@ export async function getVersionLocalizations(versionId) {
         whatsNew: l.attributes?.whatsNew,
     }));
 }
+export async function updateVersionLocalization(localizationId, fields) {
+    const body = {
+        data: {
+            type: 'appStoreVersionLocalizations',
+            id: localizationId,
+            attributes: fields,
+        },
+    };
+    const res = await apiPatch(`/appStoreVersionLocalizations/${localizationId}`, body);
+    return res.data ?? res;
+}
+/**
+ * versionId + locale로 로컬라이제이션을 찾아서 PATCH.
+ * localizationId를 직접 모를 때 편의용.
+ */
+export async function updateVersionWhatsNew(versionId, locale, fields) {
+    const localizations = await getVersionLocalizations(versionId);
+    const target = localizations.find((l) => l.locale === locale);
+    if (!target) {
+        const available = localizations.map((l) => l.locale).join(', ') || '(없음)';
+        throw new Error(`로캘 "${locale}"을 버전 ${versionId}에서 찾을 수 없어. 가능한 로캘: ${available}`);
+    }
+    return updateVersionLocalization(target.id, fields);
+}
 // ─── 빌드 ───
 export async function listBuilds(appId) {
     const data = await apiGet(`/builds`, {

package/dist/auth/google-auth.d.ts

@@ -17,6 +17,20 @@ export declare function createOAuth2Client(clientId: string, clientSecret: strin
  */
 export declare function getAuthenticatedClient(): ReturnType<typeof createOAuth2Client> | null;
 /**
- * Interactive login — opens browser, waits for callback
+ * OAuth 플로우 시작.
+ * URL과 대기 Promise를 즉시 반환. localhost:9876 콜백 서버는 백그라운드로 실행.
+ * 호출자가 URL을 사용자에게 전달하거나 `open()`을 직접 호출.
+ * `wait` Promise: 토큰 저장 시 resolve, 타임아웃/에러 시 reject.
+ * 재호출 시 기존 세션 자동 정리.
+ */
+export declare function startAuth(clientId: string, clientSecret: string, options?: {
+    timeoutMs?: number;
+}): {
+    url: string;
+    wait: Promise<StoredTokens>;
+};
+/**
+ * Interactive login — opens browser, waits for callback.
+ * startAuth() 래퍼 — CLI에서 사용.
  */
 export declare function login(clientId: string, clientSecret: string): Promise<StoredTokens>;