@yoonion/mimi-seed-mcp 0.13.13 → 0.13.15

package/README.md

@@ -78,8 +78,8 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| 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` |
+| App Store Connect | 41 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
+| Google Play | 32 | `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/assets/agent-guide.md

@@ -16,7 +16,7 @@ and which actions are irreversible.
 
 ## 0. The one thing that trips every agent: deferred tools
 
-Mimi Seed exposes **150+ MCP tools** across 19 domains (full inventory:
+Mimi Seed exposes **150+ MCP tools** across every store, cloud, CI, social, and video domain (full inventory:
 [`docs/domain/tool-catalog.md`](domain/tool-catalog.md)). Harnesses that lazy-load large tool catalogs —
 **Claude Code most notably** — register these tools as **deferred**: the tool *names*
 are visible (in a system reminder), but the **input schemas are not loaded**. If you
@@ -42,20 +42,36 @@ tools directly — but the *call order* and *safety rules* below still apply.
 
 ### Ready-made `select:` batches
 
+Every registered tool appears in at least one batch below (test-enforced), so a task you can name is a batch
+you can paste. Pick the row for the job; batching two rows in one `select:` call is fine.
+
 | Goal | `ToolSearch` query |
 |------|--------------------|
 | First contact / "what's connected?" | `select:mimi_seed_status,mimi_seed_auth_status,mimi_seed_auth_start,mimi_seed_remote_sync_credentials` |
-| Play Store release | `select:playstore_get_app,playstore_list_tracks,playstore_update_latest_release_notes,playstore_promote_release,playstore_submit_release,playstore_check_submission_risks,playstore_plan_release` |
-| Play Store listing + images | `select:playstore_get_listing,playstore_update_listing,playstore_upload_image,playstore_list_images,playstore_replace_images,playstore_delete_all_images` |
-| App Store / TestFlight | `select:appstore_list_apps,appstore_list_versions,appstore_create_version,appstore_get_metadata,appstore_update_whats_new,appstore_list_builds,appstore_attach_latest_build,appstore_submit_for_review,appstore_check_submission_risks,appstore_plan_release` |
-| App Store screenshots | `select:appstore_list_app_info_localizations,appstore_get_metadata,appstore_list_screenshots,appstore_upload_screenshot,appstore_delete_screenshot_set,screenshot_validate` |
-| App Store IAP review metadata | `select:appstore_list_apps,appstore_list_products,appstore_update_product_review_note,appstore_upload_product_review_screenshot` |
+| Release readiness (either store) | `select:release_status,playstore_check_submission_risks,appstore_check_submission_risks,screenshot_validate` |
+| Play Store release | `select:playstore_get_app,playstore_list_tracks,playstore_update_release_notes,playstore_update_latest_release_notes,playstore_promote_release,playstore_submit_release,playstore_check_submission_risks,playstore_plan_release` |
+| Play Store listing + images | `select:playstore_get_listing,playstore_update_listing,playstore_update_details,playstore_upload_image,playstore_list_images,playstore_replace_images,playstore_delete_all_images` |
+| Play Store reviews + stats | `select:playstore_list_reviews,playstore_reply_review,playstore_get_statistics,generate_review_reply` |
+| Play Store IAP / subscriptions | `select:playstore_list_products,playstore_list_inapp_products,playstore_list_subscriptions,playstore_create_onetime_product,playstore_create_subscription,playstore_update_product,playstore_update_product_listing,playstore_update_subscription_listing,playstore_update_product_state,playstore_delete_product` |
+| App Store / TestFlight | `select:appstore_list_apps,appstore_verify_credentials,appstore_get_app,appstore_list_versions,appstore_create_version,appstore_get_metadata,appstore_update_whats_new,appstore_list_builds,appstore_attach_build,appstore_attach_latest_build,appstore_list_beta_groups,appstore_submit_for_review,appstore_check_submission_risks,appstore_plan_release` |
+| App Store review submission (the bundle) | `select:appstore_list_review_submissions,appstore_add_version_to_review_submission,appstore_remove_review_submission_item,appstore_update_version_string,appstore_cancel_review` |
+| App Store screenshots | `select:appstore_list_app_info_localizations,appstore_get_metadata,appstore_list_screenshots,appstore_upload_screenshot,appstore_delete_screenshot,appstore_delete_screenshot_set,screenshot_validate` |
+| App Store app info + review notes | `select:appstore_get_app_info,appstore_update_app_info_localization,appstore_create_app_info_localization,appstore_update_localization,appstore_get_review_notes,appstore_update_review_notes` |
+| App Store reviews | `select:appstore_list_reviews,appstore_reply_review,generate_review_reply` |
+| App Store IAP (products + review metadata) | `select:appstore_list_products,appstore_create_inapp_purchase,appstore_create_subscription,appstore_update_product,appstore_list_product_localizations,appstore_update_product_localization,appstore_update_product_review_note,appstore_upload_product_review_screenshot,appstore_add_product_to_review,appstore_delete_product` |
 | Release notes from commits | `select:generate_release_notes_from_commits,playstore_update_release_notes,appstore_update_whats_new` |
-| Firebase setup | `select:firebase_list_projects,firebase_get_project,firebase_create_project,firebase_create_android_app,firebase_create_ios_app,firebase_get_android_config,firebase_enable_common_services` |
-| AdMob | `select:admob_list_accounts,admob_list_apps,admob_create_ad_unit,admob_list_ad_units,admob_get_today_earnings,admob_get_report` |
-| Jenkins credentials + jobs | `select:jenkins_status,jenkins_save_config,jenkins_list_credentials,jenkins_create_credential,jenkins_upload_keystore,jenkins_upload_playstore_sa,jenkins_list_jobs,jenkins_get_job_config,jenkins_create_job,jenkins_update_job` |
-| CI (GitHub/GitLab) | `select:ci_save_config,ci_list_workflows,ci_trigger_build,ci_get_build_status,ci_list_recent_builds` |
-| Service account end-to-end | `select:iam_create_service_account,iam_create_key,iam_add_iam_policy_binding,playstore_register_service_account,playstore_verify_service_account` |
+| Firebase setup | `select:firebase_list_projects,firebase_get_project,firebase_create_project,firebase_create_android_app,firebase_create_ios_app,firebase_get_android_config,firebase_get_ios_config,firebase_enable_common_services` |
+| Firebase apps + services (incl. web) | `select:firebase_list_android_apps,firebase_list_ios_apps,firebase_list_web_apps,firebase_create_web_app,firebase_get_web_config,firebase_enable_service,firebase_list_enabled_services,firebase_delete_android_app,firebase_delete_ios_app,firebase_delete_web_app` |
+| Analytics wiring (Firebase ↔ GA4 ↔ BigQuery) | `select:firebase_link_analytics,firebase_get_analytics_details,ga4_list_account_summaries,ga4_list_properties,ga4_create_property,ga4_list_data_streams,ga4_create_data_stream,ga4_plan_bigquery_link,ga4_create_bigquery_link,ga4_run_report` |
+| BigQuery | `select:bigquery_auth_status,bigquery_list_datasets,bigquery_list_tables,bigquery_get_table_schema,bigquery_run_query` |
+| AdMob | `select:admob_list_accounts,admob_list_apps,admob_create_app,admob_create_ad_unit,admob_list_ad_units,admob_get_today_earnings,admob_get_report` |
+| Google Ads (UAC) | `select:googleads_config_status,googleads_save_config,googleads_list_accessible_customers,googleads_list_campaigns,googleads_get_campaign_report,googleads_get_uac_report` |
+| Search Console | `select:gsc_list_sites,gsc_list_sitemaps,gsc_get_sitemap,gsc_submit_sitemap,gsc_inspect_url,gsc_search_analytics` |
+| Social posting (Facebook / Instagram / Threads) | `select:facebook_current_config,facebook_save_config,facebook_list_pages,facebook_get_page,facebook_post_photo,facebook_post_multi_photo,instagram_save_config,instagram_get_account,instagram_post_image,instagram_post_carousel,threads_current_config,threads_save_config,threads_refresh_token,threads_get_account,threads_post,threads_post_carousel` |
+| Jenkins credentials + jobs | `select:jenkins_status,jenkins_save_config,jenkins_list_credentials,jenkins_create_credential,jenkins_delete_credential,jenkins_upload_keystore,jenkins_upload_playstore_sa,jenkins_list_jobs,jenkins_get_job_config,jenkins_create_job,jenkins_update_job` |
+| CI (GitHub/GitLab) | `select:ci_save_config,ci_list_workflows,ci_trigger_build,ci_get_build_status,ci_list_recent_builds,ci_cancel_build` |
+| Android signing / keystore | `select:android_signing_setup,android_generate_keystore,jenkins_upload_keystore,jenkins_upload_playstore_sa` |
+| Service account end-to-end | `select:iam_list_service_accounts,iam_create_service_account,iam_list_keys,iam_create_key,iam_add_iam_policy_binding,setup_playstore_connection,playstore_register_service_account,playstore_verify_service_account,playstore_list_service_accounts,playstore_delete_service_account` |
 | Story → researched video | `select:video_plan_from_story,video_research_youtube,video_search_stock_assets,video_synthesize_research,video_download_stock_assets,video_generate_image,video_add_local_asset,video_build_timeline,video_render,video_job_status,video_validate` |
 | YouTube upload / publish | `select:youtube_upload_video,youtube_get_video_status,youtube_update_video_privacy,mimi_seed_auth_start` |
 
@@ -156,7 +172,10 @@ per-domain inventory is [`docs/domain/tool-catalog.md`](domain/tool-catalog.md).
 | **Jenkins** (credentials + jobs) | `jenkins_status` · `jenkins_save_config` · `jenkins_create_credential` · `jenkins_upload_keystore` · `jenkins_upload_playstore_sa` · `jenkins_create_job` · `jenkins_update_job` |
 | **Google Cloud IAM** | `iam_create_service_account` · `iam_create_key` · `iam_add_iam_policy_binding` |
 | **BigQuery** | `bigquery_run_query` · `bigquery_list_datasets` · `bigquery_get_table_schema` |
+| **GA4** | `ga4_list_properties` · `ga4_create_property` · `ga4_create_data_stream` · `ga4_run_report` · `ga4_plan_bigquery_link` · `ga4_create_bigquery_link` |
+| **Google Ads (UAC)** | `googleads_list_campaigns` · `googleads_get_uac_report` · `googleads_get_campaign_report` · `googleads_config_status` |
 | **Search Console** | `gsc_inspect_url` · `gsc_search_analytics` · `gsc_submit_sitemap` |
+| **Android signing** | `android_signing_setup` · `android_generate_keystore` · `jenkins_upload_playstore_sa` |
 | **Facebook / Instagram / Threads** | `facebook_post_photo` · `instagram_post_carousel` · `threads_post` · `threads_refresh_token` |
 | **Checks** | `playstore_check_submission_risks` · `appstore_check_submission_risks` · `screenshot_validate` · `release_status` |
 | **AI / Auth** | `generate_release_notes_from_commits` · `generate_review_reply` · `mimi_seed_status` · `mimi_seed_auth_start` · `mimi_seed_auth_status` · `mimi_seed_remote_sync_credentials` |
@@ -183,6 +202,10 @@ per-domain inventory is [`docs/domain/tool-catalog.md`](domain/tool-catalog.md).
 `playstore_update_release_notes` / `appstore_update_whats_new`.
 
 ### Story → researched video
+For visual production, use the bundled `video-create-publish` skill. It requires an explicit typography system,
+aspect-ratio-specific human-safe crops, video-native motion, an original-resolution frame review, and a saved
+contact sheet; codec validation alone is not a quality pass.
+
 1. `video_plan_from_story` — create the project and scene plan.
 2. `video_research_youtube` — collect reference-only metadata; never treat a result as a render asset.
 3. `video_search_stock_assets` — find licensed Pexels candidates.

package/dist/appstore/product-review.d.ts

@@ -12,12 +12,15 @@ export declare function updateProductReviewNote(args: {
 }>;
 /**
  * 기존 IAP/구독 상품에 App Review 스크린샷을 reserve → upload → commit 한다.
- * App Store Connect API는 상품당 심사용 스크린샷 하나를 허용한다.
+ * App Store Connect API는 상품당 심사용 스크린샷 하나를 허용한다 —
+ * 이미 있으면 409 `MEDIA_ASSET_CREATION_NOT_ALLOWED: Screenshot already exists` 다.
+ * 갈아끼우려면 replace: true (기존 것을 지우고 올린다).
  */
 export declare function uploadProductReviewScreenshot(args: {
     internalId: string;
     productType: AppStoreProductType;
     filePath: string;
+    replace?: boolean;
 }): Promise<{
     id: string;
     internalId: string;
@@ -26,4 +29,5 @@ export declare function uploadProductReviewScreenshot(args: {
     fileSize: number;
     state?: string;
     verified: boolean;
+    replacedId?: string;
 }>;

package/dist/appstore/product-review.js

@@ -70,12 +70,31 @@ async function uploadChunks(buffer, operations) {
         }
     }
 }
+/**
+ * 상품에 이미 붙어 있는 심사 스크린샷 id 를 찾는다. 없으면 null.
+ *
+ * 조회 경로가 상품 종류마다 다르다 — 구독은 v1, IAP 는 **v2** 다.
+ * v1 으로 IAP 를 조회하면 스크린샷이 있어도 404 가 나서 "없음"으로 오독하기 쉽다
+ * (2026-07-25 실측: 404 를 믿고 업로드했다가 "Screenshot already exists" 409).
+ */
+async function findExistingReviewScreenshotId(internalId, productType, authHeaders) {
+    const product = productResource(productType);
+    try {
+        const res = await apiRequest(product.base, `${product.path}/${internalId}/appStoreReviewScreenshot`, authHeaders, { method: 'GET' });
+        return res?.data?.id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * 기존 IAP/구독 상품에 App Review 스크린샷을 reserve → upload → commit 한다.
- * App Store Connect API는 상품당 심사용 스크린샷 하나를 허용한다.
+ * App Store Connect API는 상품당 심사용 스크린샷 하나를 허용한다 —
+ * 이미 있으면 409 `MEDIA_ASSET_CREATION_NOT_ALLOWED: Screenshot already exists` 다.
+ * 갈아끼우려면 replace: true (기존 것을 지우고 올린다).
  */
 export async function uploadProductReviewScreenshot(args) {
-    const { internalId, productType, filePath } = args;
+    const { internalId, productType, filePath, replace = false } = args;
     if (!path.isAbsolute(filePath)) {
         throw new Error(`절대 경로가 필요해: ${filePath}`);
     }
@@ -94,6 +113,15 @@ export async function uploadProductReviewScreenshot(args) {
     const checksum = crypto.createHash('md5').update(buffer).digest('hex');
     const resource = reviewScreenshotResource(productType);
     const authHeaders = await authHeadersOrThrow();
+    // 상품당 1장이라 새로 올리려면 기존 것을 먼저 지워야 한다.
+    let replacedId;
+    if (replace) {
+        const existing = await findExistingReviewScreenshotId(internalId, productType, authHeaders);
+        if (existing) {
+            await apiRequest(V1_BASE, `${resource.path}/${existing}`, authHeaders, { method: 'DELETE' });
+            replacedId = existing;
+        }
+    }
     const reserved = await apiRequest(V1_BASE, resource.path, authHeaders, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -148,5 +176,5 @@ export async function uploadProductReviewScreenshot(args) {
     catch {
         // commit 성공 후 확인 GET만 실패하면 재업로드를 유도하지 않는다.
     }
-    return { id: screenshotId, internalId, productType, fileName, fileSize, state, verified };
+    return { id: screenshotId, internalId, productType, fileName, fileSize, state, verified, replacedId };
 }

package/dist/appstore/tools.d.ts

@@ -40,6 +40,23 @@ export declare function createVersion(input: CreateVersionInput): Promise<{
     releaseType: any;
     createdDate: any;
 }>;
+/**
+ * 기존 버전 레코드의 versionString 을 바꾼다 (예: 2.0.5 → 2.0.6).
+ *
+ * 왜 필요한가: ASC 는 편집 가능한 버전이 이미 있으면 새 버전 생성을 거부한다
+ *   409 ENTITY_ERROR.RELATIONSHIP.INVALID "You cannot create a new version of the App in the current state"
+ * 그래서 거절/철회된 버전으로 다음 릴리스를 내보내려면 **같은 레코드의 이름을 올려야** 한다.
+ * 빌드는 CFBundleShortVersionString 이 일치하는 버전에만 붙으므로, 2.0.6 빌드를 올렸다면
+ * 버전 레코드도 2.0.6 이어야 attach 가 된다.
+ *
+ * 편집 가능한 상태(PREPARE_FOR_SUBMISSION / DEVELOPER_REJECTED / REJECTED 등)에서만 통한다.
+ */
+export declare function updateVersionString(versionId: string, versionString: string): Promise<{
+    versionId: string;
+    versionString: any;
+    state: any;
+    platform: any;
+}>;
 export declare function attachBuildToVersion(versionId: string, buildId: string): Promise<{
     versionId: string;
     buildId: string;
@@ -212,6 +229,30 @@ export declare function removeReviewSubmissionItem(itemId: string): Promise<{
     state?: string;
     removed: boolean;
 }>;
+/**
+ * 이미 존재하는 묶음에 앱 버전을 항목으로 끼워 넣는다.
+ *
+ * 앱 첫 심사에서 반드시 필요하다. 웹에서 상품을 담으면 **상품만 든 묶음**이 새로 생기는데,
+ * 그대로 제출하면 Apple 이 막는다:
+ *   409 ENTITY_ERROR.RELATIONSHIP.REQUIRED
+ *   "must have an approved appStoreVersions ... or an appStoreVersions must be included
+ *    in this review submission"
+ * 즉 상품 묶음에는 앱 버전이 함께 있어야 한다. reviewSubmissionItems 는 상품 관계는
+ * 거부하지만 **appStoreVersion 관계는 받는다** — 그래서 버전만 이쪽으로 옮기면 된다.
+ *
+ * 버전이 다른 묶음에 이미 물려 있으면 그 묶음을 먼저 정리해야 한다:
+ *   - 미제출(READY_FOR_REVIEW) 묶음이면 appstore_remove_review_submission_item
+ *   - 제출된(WAITING_FOR_REVIEW) 묶음이면 항목 제거가 막히므로 appstore_cancel_review 로 묶음째 취소
+ */
+export declare function addVersionToReviewSubmission(args: {
+    submissionId: string;
+    versionId: string;
+}): Promise<{
+    itemId?: string;
+    submissionId: string;
+    versionId: string;
+    itemCount: number;
+}>;
 export declare function cancelVersionReview(versionId: string): Promise<{
     submissionId: string;
     previousState: string;

package/dist/appstore/tools.js

@@ -196,6 +196,33 @@ export async function createVersion(input) {
         createdDate: created?.data?.attributes?.createdDate,
     };
 }
+/**
+ * 기존 버전 레코드의 versionString 을 바꾼다 (예: 2.0.5 → 2.0.6).
+ *
+ * 왜 필요한가: ASC 는 편집 가능한 버전이 이미 있으면 새 버전 생성을 거부한다
+ *   409 ENTITY_ERROR.RELATIONSHIP.INVALID "You cannot create a new version of the App in the current state"
+ * 그래서 거절/철회된 버전으로 다음 릴리스를 내보내려면 **같은 레코드의 이름을 올려야** 한다.
+ * 빌드는 CFBundleShortVersionString 이 일치하는 버전에만 붙으므로, 2.0.6 빌드를 올렸다면
+ * 버전 레코드도 2.0.6 이어야 attach 가 된다.
+ *
+ * 편집 가능한 상태(PREPARE_FOR_SUBMISSION / DEVELOPER_REJECTED / REJECTED 등)에서만 통한다.
+ */
+export async function updateVersionString(versionId, versionString) {
+    const patched = await apiPatch(`/appStoreVersions/${versionId}`, {
+        data: {
+            type: 'appStoreVersions',
+            id: versionId,
+            attributes: { versionString },
+        },
+    });
+    const attrs = patched?.data?.attributes ?? {};
+    return {
+        versionId,
+        versionString: attrs.versionString ?? versionString,
+        state: attrs.appStoreState ?? attrs.appVersionState,
+        platform: attrs.platform,
+    };
+}
 export async function attachBuildToVersion(versionId, buildId) {
     // /relationships/build 엔드포인트는 204 No Content 반환
     await apiPatch(`/appStoreVersions/${versionId}/relationships/build`, {
@@ -838,6 +865,41 @@ export async function removeReviewSubmissionItem(itemId) {
         removed: patched?.data?.attributes?.removed ?? true,
     };
 }
+/**
+ * 이미 존재하는 묶음에 앱 버전을 항목으로 끼워 넣는다.
+ *
+ * 앱 첫 심사에서 반드시 필요하다. 웹에서 상품을 담으면 **상품만 든 묶음**이 새로 생기는데,
+ * 그대로 제출하면 Apple 이 막는다:
+ *   409 ENTITY_ERROR.RELATIONSHIP.REQUIRED
+ *   "must have an approved appStoreVersions ... or an appStoreVersions must be included
+ *    in this review submission"
+ * 즉 상품 묶음에는 앱 버전이 함께 있어야 한다. reviewSubmissionItems 는 상품 관계는
+ * 거부하지만 **appStoreVersion 관계는 받는다** — 그래서 버전만 이쪽으로 옮기면 된다.
+ *
+ * 버전이 다른 묶음에 이미 물려 있으면 그 묶음을 먼저 정리해야 한다:
+ *   - 미제출(READY_FOR_REVIEW) 묶음이면 appstore_remove_review_submission_item
+ *   - 제출된(WAITING_FOR_REVIEW) 묶음이면 항목 제거가 막히므로 appstore_cancel_review 로 묶음째 취소
+ */
+export async function addVersionToReviewSubmission(args) {
+    const { submissionId, versionId } = args;
+    const created = await apiPost('/reviewSubmissionItems', {
+        data: {
+            type: 'reviewSubmissionItems',
+            relationships: {
+                reviewSubmission: { data: { type: 'reviewSubmissions', id: submissionId } },
+                appStoreVersion: { data: { type: 'appStoreVersions', id: versionId } },
+            },
+        },
+    });
+    // 제출 전에 몇 개가 들어있는지 보여준다 — 첫 심사에서 "상품이 빠졌는지"를 눈으로 확인해야 한다.
+    const items = await apiGet(`/reviewSubmissions/${submissionId}/items`, { limit: '50' }).catch(() => null);
+    return {
+        itemId: created?.data?.id,
+        submissionId,
+        versionId,
+        itemCount: (items?.data ?? []).length,
+    };
+}
 /**
  * 버전을 물고 있는 낡은 묶음(UNRESOLVED_ISSUES)에서 해당 버전 항목을 removed=true 로
  * 풀어준다. 항목이 풀리면 Apple 이 옛 묶음을 COMPLETE 로 정리하고, 종종 새

package/dist/registers/appstore.js

@@ -554,12 +554,16 @@ export function registerAppstoreTools(server) {
                 }],
         };
     });
-    server.tool('appstore_upload_product_review_screenshot', '기존 App Store IAP/구독 상품의 심사용 스크린샷을 reserve → upload → commit. 상품당 1장, 절대 파일 경로 필요.', {
+    server.tool('appstore_upload_product_review_screenshot', [
+        '기존 App Store IAP/구독 상품의 심사용 스크린샷을 reserve → upload → commit. 상품당 1장, 절대 파일 경로 필요.',
+        '이미 있으면 409 "Screenshot already exists" — 갈아끼우려면 replace: true (기존 것을 지우고 올린다).',
+    ].join(' '), {
         appId: z.string().describe('App Store 앱 ID (숫자형, appstore_list_apps 결과)'),
         productId: z.string().describe('상품 ID (appstore_list_products 결과)'),
         productType: z.enum(['subscription', 'consumable', 'non_consumable']).describe('상품 유형'),
         filePath: z.string().describe('업로드할 PNG/JPG의 절대 파일 경로'),
-    }, async ({ appId, productId, productType, filePath }) => {
+        replace: z.boolean().optional().describe('이미 스크린샷이 있으면 지우고 새로 올린다 (기본 false)'),
+    }, async ({ appId, productId, productType, filePath, replace }) => {
         const creds = requireAppStoreCreds();
         const products = await listAppleProducts({
             appId, keyId: creds.keyId, issuerId: creds.issuerId, privateKey: creds.privateKey,
@@ -572,6 +576,7 @@ export function registerAppstoreTools(server) {
             internalId: product.internalId,
             productType,
             filePath,
+            replace,
         });
         return {
             content: [{
@@ -581,6 +586,7 @@ export function registerAppstoreTools(server) {
                         `productId: ${productId}`,
                         `internalId: ${result.internalId}`,
                         `screenshotId: ${result.id}`,
+                        result.replacedId ? `교체됨 (이전 screenshotId: ${result.replacedId})` : '',
                         `file: ${result.fileName} (${result.fileSize} bytes)`,
                         result.state ? `state: ${result.state}` : '',
                         result.verified ? '✓ commit 후 조회 확인' : '⚠ commit은 성공했지만 후속 조회는 확인하지 못함',
@@ -689,6 +695,53 @@ export function registerAppstoreTools(server) {
                 }],
         };
     });
+    server.tool('appstore_add_version_to_review_submission', '이미 존재하는 심사 묶음에 앱 버전을 항목으로 추가한다 (POST /reviewSubmissionItems). ' +
+        '⚠️ 앱 첫 심사 필수 절차 — 웹에서 IAP/구독을 담으면 "상품만 든 묶음"이 새로 생기는데, ' +
+        '그대로 제출하면 409 "an appStoreVersions must be included in this review submission" 로 막힌다. ' +
+        'reviewSubmissionItems 는 상품 관계는 거부하지만 appStoreVersion 관계는 받으므로, 버전을 이 묶음으로 옮기면 된다. ' +
+        '버전이 다른 묶음에 물려 있으면 먼저 풀 것: 미제출 묶음이면 appstore_remove_review_submission_item, ' +
+        '제출된 묶음이면 항목 제거가 막히므로 appstore_cancel_review 로 묶음째 취소. ' +
+        '추가 후 appstore_submit_for_review 로 제출하면 버전+상품이 한 묶음으로 나간다.', {
+        submissionId: z.string().describe('대상 reviewSubmission ID (appstore_list_review_submissions 결과)'),
+        versionId: z.string().describe('추가할 App Store 버전 ID (appstore_list_versions 결과)'),
+    }, async ({ submissionId, versionId }) => {
+        const result = await appstore.addVersionToReviewSubmission({ submissionId, versionId });
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✓ 묶음에 앱 버전 추가됨',
+                        `submissionId: ${result.submissionId}`,
+                        `versionId: ${result.versionId}`,
+                        result.itemId ? `itemId: ${result.itemId}` : '',
+                        `현재 묶음 항목 수: ${result.itemCount}개`,
+                        '제출 전 항목 수를 확인할 것 — 첫 심사라면 상품들이 함께 들어 있어야 한다.',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('appstore_update_version_string', '기존 App Store 버전 레코드의 versionString 을 변경 (예: 2.0.5 → 2.0.6). ' +
+        '⚠️ 편집 가능한 버전이 이미 있으면 appstore_create_version 이 409 "cannot create a new version in the current state" 로 막힌다 — ' +
+        '거절/철회된 버전으로 다음 릴리스를 내보내려면 새로 만들지 말고 이 도구로 **같은 레코드의 이름을 올린다**. ' +
+        '빌드는 CFBundleShortVersionString 이 같은 버전에만 붙으므로, 새 버전의 빌드를 attach 하려면 먼저 이걸 맞춰야 한다. ' +
+        'PREPARE_FOR_SUBMISSION / DEVELOPER_REJECTED 등 편집 가능 상태에서만 통한다.', {
+        versionId: z.string().describe('App Store 버전 ID (appstore_list_versions 결과)'),
+        versionString: z.string().describe('새 버전 문자열 (예: "2.0.6")'),
+    }, async ({ versionId, versionString }) => {
+        const result = await appstore.updateVersionString(versionId, versionString);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✓ 버전 문자열 변경 완료',
+                        `versionId: ${result.versionId}`,
+                        `versionString: ${result.versionString}`,
+                        result.state ? `state: ${result.state}` : '',
+                        '이제 같은 버전의 빌드를 attach 할 수 있다 (appstore_attach_latest_build).',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
     server.tool('appstore_update_product', 'App Store IAP 상품의 reference name 변경. productId / 유형은 변경 불가. ' +
         '스토어에 보이는 표시 이름·설명은 appstore_update_product_localization 을 쓴다.', {
         appId: z.string().optional().describe('App Store 앱 ID'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.13.13",
+  "version": "0.13.15",
   "description": "Mimi Seed MCP server — Firebase + AdMob + Google Play + App Store management for Claude Code / Codex / Cursor / any MCP client.",
   "type": "module",
   "bin": {

package/tool-manifest.json

@@ -1,6 +1,6 @@
 {
   "$comment": "등록된 MCP 도구 + 도메인 메타데이터(label·credential·summary)의 SSOT. src/__tests__/tool-manifest.test.ts 가 실제 서버 등록 목록과 diff 하고 메타데이터 정합성을 검사한다. 도구 추가/삭제/개명 시 이 파일을 함께 갱신할 것 — 산문 문서에는 정확한 개수를 쓰지 말고 이 파일을 가리킬 것. mimi-seed://tools/catalog 리소스가 이 파일을 그대로 서빙한다.",
-  "total": 187,
+  "total": 189,
   "domains": {
     "admob": {
       "label": "AdMob",
@@ -78,6 +78,8 @@
         "appstore_submit_for_review",
         "appstore_list_review_submissions",
         "appstore_remove_review_submission_item",
+        "appstore_add_version_to_review_submission",
+        "appstore_update_version_string",
         "appstore_cancel_review"
       ]
     },