@yoonion/mimi-seed-mcp 0.13.10 → 0.13.13

package/dist/admob/tools.d.ts

@@ -33,8 +33,8 @@ export declare function getNetworkReport(auth: OAuth2Client, accountId: string,
     year: number;
     month: number;
     day: number;
-}): Promise<import("googleapis").admob_v1.Schema$GenerateNetworkReportResponse>;
-export declare function getTodayEarnings(auth: OAuth2Client, accountId: string): Promise<import("googleapis").admob_v1.Schema$GenerateNetworkReportResponse>;
+}): Promise<import("googleapis/build/src/apis/admob/v1.js").admob_v1.Schema$GenerateNetworkReportResponse>;
+export declare function getTodayEarnings(auth: OAuth2Client, accountId: string): Promise<import("googleapis/build/src/apis/admob/v1.js").admob_v1.Schema$GenerateNetworkReportResponse>;
 export type AdFormat = 'BANNER' | 'INTERSTITIAL' | 'REWARDED' | 'REWARDED_INTERSTITIAL' | 'APP_OPEN' | 'NATIVE';
 /**
  * adFormat → adTypes 파생 (순수 함수 — 테스트 대상).

package/dist/admob/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 /**
  * AdMob API 래퍼
  * v1: 조회 (stable)

package/dist/appstore/errors.js

@@ -34,8 +34,11 @@ const CODE_HINTS = {
     NOT_FOUND: '대상 리소스를 찾을 수 없어요 — id/versionId/buildId 가 유효한지, 동일 앱 소속인지 확인.',
     // 권한 부족 (API Key role 문제)
     FORBIDDEN_ERROR: 'API Key 권한 부족 — App Store Connect > Users and Access 에서 키 role 확인.',
-    // submit 직후 cancel 시도 (큐 진입 후)
-    STATE_ERROR: '현재 상태에서 허용되지 않는 작업. cancel_review 라면 큐 진입 후라서 불가 — 새 versionString 으로 우회.',
+    // 상태 전이 거부. cancel 은 WAITING_FOR_REVIEW 까지 되고, IN_REVIEW 이후만 막힌다.
+    // (예전 문구는 "큐 진입 후라 불가"였는데, 그건 cancel 이 submitted:false 를 보내
+    //  항상 실패하던 버그의 증상을 상태 탓으로 오해한 것이었다 — 2026-07-25 정정.)
+    STATE_ERROR: '현재 상태에서 허용되지 않는 작업. 제출된 묶음은 항목 제거(removed)가 막히니 '
+        + 'appstore_cancel_review 로 묶음째 취소하세요. IN_REVIEW 이후면 그마저도 불가 — 심사 결과를 기다립니다.',
     // JWT 거부 — 잘못된 자격증명
     NOT_AUTHORIZED: 'API 키가 거부됐어요 — issuerId/keyId/.p8 조합 불일치 가능. appstore_verify_credentials 로 진단하고 mimi-seed auth appstore 로 재등록.',
 };

package/dist/appstore/tools.d.ts

@@ -137,9 +137,11 @@ export declare function createReviewResponse(reviewId: string, responseBody: str
 /**
  * submit_for_review dry-run 프리뷰 — 비가역 제출 직전 사용자 확인용.
  *
- * 1.4.x 배포 사고 누적: submit 직후 cancel_review 가 큐 진입으로 막혀 새 versionString
- * bump 으로 우회해야 하는 케이스가 반복됨 (reference_appstore_cancel_review_window).
- * 호출자가 의도한 그 버전·빌드인지 미리 보여줘서 잘못된 versionId 제출 차단.
+ * 1.4.x 배포 사고 누적: submit 직후 되돌리지 못해 새 versionString bump 으로 우회해야
+ * 하는 케이스가 반복됨 (reference_appstore_cancel_review_window). 그 원인이던
+ * cancel_review 버그(submitted:false → 항상 409)는 2026-07-25 에 canceled:true 로 고쳤고,
+ * 이제 WAITING_FOR_REVIEW 까지는 되돌릴 수 있다. 그래도 IN_REVIEW 이후는 못 되돌리니
+ * 호출자가 의도한 그 버전·빌드인지 미리 보여줘서 잘못된 versionId 제출을 차단한다.
  */
 export declare function buildSubmitForReviewPreview(versionId: string): Promise<{
     versionId: string;
@@ -170,18 +172,45 @@ export declare function submitVersionForReview(versionId: string): Promise<{
     state: any;
 }>;
 export declare function addProductToReviewSubmission(args: {
-    appId: string;
     internalId: string;
     productType: AppStoreProductType;
+}): Promise<{
+    internalId: string;
+    productType: AppStoreProductType;
+    endpoint: string;
+    submissionId?: string;
+}>;
+export interface ReviewSubmissionSummary {
+    id: string;
+    state?: string;
+    submittedDate: string | null;
+    items: Array<{
+        id: string;
+        state?: string;
+        targetType?: string;
+        targetId?: string;
+        versionString?: string;
+        appVersionState?: string;
+        /** IAP/구독/구독그룹 항목의 식별자 — productId 또는 referenceName. */
+        label?: string;
+        /** 대상 리소스 자체의 상태 (상품이면 READY_TO_SUBMIT / WAITING_FOR_REVIEW 등). */
+        targetState?: string;
+    }>;
+}
+export declare function listReviewSubmissions(args: {
+    appId: string;
     platform?: string;
+    limit?: number;
 }): Promise<{
-    submissionId: string;
     appId: string;
     platform: string;
-    internalId: string;
-    productType: AppStoreProductType;
-    reusedSubmission: boolean;
-    itemAttached: boolean;
+    submissions: ReviewSubmissionSummary[];
+}>;
+/** 묶음에서 항목 제거 (removed=true PATCH). ASC 웹 "재제출" 이 내부적으로 하는 그 동작. */
+export declare function removeReviewSubmissionItem(itemId: string): Promise<{
+    itemId: string;
+    state?: string;
+    removed: boolean;
 }>;
 export declare function cancelVersionReview(versionId: string): Promise<{
     submissionId: string;

package/dist/appstore/tools.js

@@ -556,9 +556,11 @@ async function isVersionAttached(submissionId, versionId) {
 /**
  * submit_for_review dry-run 프리뷰 — 비가역 제출 직전 사용자 확인용.
  *
- * 1.4.x 배포 사고 누적: submit 직후 cancel_review 가 큐 진입으로 막혀 새 versionString
- * bump 으로 우회해야 하는 케이스가 반복됨 (reference_appstore_cancel_review_window).
- * 호출자가 의도한 그 버전·빌드인지 미리 보여줘서 잘못된 versionId 제출 차단.
+ * 1.4.x 배포 사고 누적: submit 직후 되돌리지 못해 새 versionString bump 으로 우회해야
+ * 하는 케이스가 반복됨 (reference_appstore_cancel_review_window). 그 원인이던
+ * cancel_review 버그(submitted:false → 항상 409)는 2026-07-25 에 canceled:true 로 고쳤고,
+ * 이제 WAITING_FOR_REVIEW 까지는 되돌릴 수 있다. 그래도 IN_REVIEW 이후는 못 되돌리니
+ * 호출자가 의도한 그 버전·빌드인지 미리 보여줘서 잘못된 versionId 제출을 차단한다.
  */
 export async function buildSubmitForReviewPreview(versionId) {
     const { appId, platform } = await getVersionAppAndPlatform(versionId);
@@ -649,13 +651,23 @@ export async function submitVersionForReview(versionId) {
             });
         }
         catch (error) {
-            if (!reusedSubmission || !isItemAddRejected(error))
+            if (!isItemAddRejected(error))
+                throw error;
+            // 2026-07-24 실측 (PenguinRun 2.0.4 재제출): 버전은 PREPARE_FOR_SUBMISSION 인데도
+            // attach 가 "appStoreVersions ... is not in valid state" 로 거부되는 케이스의 진범은
+            // 거절된 옛 묶음(UNRESOLVED_ISSUES)이 이 버전을 REJECTED 항목으로 물고 있는 것.
+            // 항목을 removed=true 로 풀면 옛 묶음이 COMPLETE 로 정리되고 attach 가 뚫린다.
+            const released = await releaseVersionFromStaleSubmissions(appId, platform, versionId);
+            if (!released && !reusedSubmission)
                 throw error;
-            // 재사용하려던 묶음이 실제로는 잠겨 있었다 — 새 묶음을 만들어 한 번만 재시도한다.
-            submissionId = await createReviewSubmission(appId, platform);
-            reusedSubmission = false;
             recoveredFromStaleSubmission = true;
+            reusedSubmission = false;
             alreadyAttached = false;
+            // 항목 해제 뒤 Apple 이 READY_FOR_REVIEW 초안을 자동 생성하기도 한다 (실측) —
+            // 초안이 있는데 또 만들면 충돌하므로 재조회 후 없을 때만 생성한다.
+            submissionId =
+                (await findDraftReviewSubmission(appId, platform)) ??
+                    (await createReviewSubmission(appId, platform));
             await apiPost('/reviewSubmissionItems', {
                 data: {
                     type: 'reviewSubmissionItems',
@@ -686,29 +698,79 @@ export async function submitVersionForReview(versionId) {
         state: submitted?.data?.attributes?.state ?? 'WAITING_FOR_REVIEW',
     };
 }
-// ─── IAP/구독을 심사 제출 묶음에 추가 ───
+// ─── IAP/구독 상품 심사 제출 ───
 //
-// App Store Connect 웹의 "심사에 추가" 버튼과 같은 동작이다. 제출하지는 않는다 —
-// 항목만 담고, 실제 제출은 submitVersionForReview 가 한다.
+// ⚠️ 2026-07-24 실측 (PenguinRun 첫 출시): reviewSubmissionItems 는 appStoreVersion 계열
+// 관계만 받는다. inAppPurchaseV2 / inAppPurchase / subscription 관계는 전부
+// ENTITY_ERROR.RELATIONSHIP.UNKNOWN 으로 거부된다 — 즉 App Store Connect 웹의
+// "버전과 함께 제출할 상품 담기" 는 공개 API 에 존재하지 않는다.
 //
-// 이게 왜 별도로 필요한가: 어떤 앱의 **첫 소모성 IAP** 는 앱 버전과 같은 묶음으로만
-// 심사에 넣을 수 있다. IAP 만 담긴 초안은 "심사에 제출할 수 없음" 으로 막힌다.
-// 그래서 순서가 중요하다 — IAP 를 전부 담은 뒤 버전을 제출해야 한 번에 나간다.
-function productReviewItemRelationship(productType) {
-    if (productType === 'subscription') {
-        return { key: 'subscription', type: 'subscriptions' };
+// 공개 API 가 제공하는 것은 상품 **단독** 제출뿐이다:
+//   consumable / non_consumable → POST /v1/inAppPurchaseSubmissions (관계 inAppPurchaseV2)
+//   subscription                → POST /v1/subscriptionSubmissions  (관계 subscription)
+// 이 엔드포인트는 상품에 pending version 이 있어야 동작한다 — 한 번 승인된 뒤의 변경분
+// 제출용. 앱 **첫 심사** 에 상품을 끼워 넣는 것은 ASC 웹 버전 페이지에서만 가능하며,
+// 그 경우 Apple 이 409 "no pending version for submission" 을 반환한다 (실측 동일 문구).
+function isNoPendingVersionError(error) {
+    const cause = error?.cause;
+    if (cause?.status !== 409)
+        return false;
+    return (cause.parsedErrors ?? []).some((e) => (e.detail ?? '').toLowerCase().includes('no pending version'));
+}
+export async function addProductToReviewSubmission(args) {
+    const { internalId, productType } = args;
+    const isSubscription = productType === 'subscription';
+    const path = isSubscription ? '/subscriptionSubmissions' : '/inAppPurchaseSubmissions';
+    const body = isSubscription
+        ? {
+            data: {
+                type: 'subscriptionSubmissions',
+                relationships: { subscription: { data: { type: 'subscriptions', id: internalId } } },
+            },
+        }
+        : {
+            data: {
+                type: 'inAppPurchaseSubmissions',
+                relationships: { inAppPurchaseV2: { data: { type: 'inAppPurchases', id: internalId } } },
+            },
+        };
+    try {
+        const created = await apiPost(path, body);
+        return { internalId, productType, endpoint: path, submissionId: created?.data?.id };
+    }
+    catch (error) {
+        if (!isNoPendingVersionError(error))
+            throw error;
+        const enriched = new Error([
+            `상품 ${internalId} (${productType}) 은 API 로 심사 제출할 수 없는 상태야 — Apple 응답: "no pending version for submission".`,
+            '',
+            '**앱 첫 심사** 케이스다. 한 번도 승인된 적 없는 상품은 공개 API 로 심사에 못 넣는다.',
+            '앱 버전을 심사 대기로 만들어도 이 벽은 그대로다 (2026-07-25 재확인).',
+            '',
+            '실제로 통하는 순서 (PenguinRun 2.0.6 실측):',
+            '  1. appstore_submit_for_review 로 앱 버전을 먼저 제출한다.',
+            '     → 상품은 자동으로 안 딸려간다. 버전 1개짜리 묶음 A 가 생긴다. 이건 정상이다.',
+            '  2. 그래야 ASC 웹에 상품의 "심사 추가" UI 가 나타난다. 웹에서 상품을 담으면',
+            '     상품들만 든 **새 묶음 B** 가 READY_FOR_REVIEW(미제출)로 생성된다.',
+            '  3. B 를 그냥 제출하면 409: "an appStoreVersions must be included in this review submission".',
+            '     상품 묶음에는 앱 버전이 반드시 함께 있어야 한다.',
+            '  4. appstore_cancel_review 로 묶음 A 를 취소해 버전을 풀어준다.',
+            '  5. POST /reviewSubmissionItems 로 B 에 appStoreVersion 을 추가한다.',
+            '     (상품 관계는 거부되지만 **버전 관계는 받는다**.)',
+            '  6. B 를 submitted=true 로 PATCH → 버전+상품이 한 묶음으로 제출된다.',
+            '',
+            '이미 승인된 적 있는 상품이라면: 변경분(pending version)이 실제로 있는지 확인.',
+        ].join('\n'));
+        enriched.cause = error.cause;
+        throw enriched;
     }
-    return { key: 'inAppPurchaseV2', type: 'inAppPurchases' };
 }
 /**
  * **아직 제출 안 된** 묶음만 찾는다.
  *
  * findOpenReviewSubmission 을 그대로 쓰면 안 된다 — 그건 WAITING_FOR_REVIEW 까지
- * 잡아오는데, 그건 이미 Apple 큐에 들어간 묶음이다. 거기에 항목을 밀어 넣으면
- * 되든 안 되든 "추가됨" 이라고 보고하게 된다 (실측: 앱 하나에 WAITING_FOR_REVIEW
- * 묶음이 2개 떠 있는 상태가 정상적으로 존재한다).
- *
- * 콘솔의 "제출 초안" 은 READY_FOR_REVIEW 로 보인다. 그게 우리가 담을 대상이다.
+ * 잡아오는데, 그건 이미 Apple 큐에 들어간 묶음이다. 콘솔의 "제출 초안" 은
+ * READY_FOR_REVIEW 로 보인다. 그게 재사용 대상이다.
  */
 async function findDraftReviewSubmission(appId, platform) {
     const data = await apiGet('/reviewSubmissions', {
@@ -719,54 +781,93 @@ async function findDraftReviewSubmission(appId, platform) {
     });
     return data?.data?.[0]?.id ?? null;
 }
-export async function addProductToReviewSubmission(args) {
-    const { appId, internalId, productType } = args;
+export async function listReviewSubmissions(args) {
     const platform = args.platform ?? 'IOS';
-    const relationship = productReviewItemRelationship(productType);
-    let submissionId = await findDraftReviewSubmission(appId, platform);
-    const reusedSubmission = Boolean(submissionId);
-    if (!submissionId) {
-        const created = await apiPost('/reviewSubmissions', {
-            data: {
-                type: 'reviewSubmissions',
-                attributes: { platform },
-                relationships: { app: { data: { type: 'apps', id: appId } } },
-            },
+    const limit = Math.min(Math.max(args.limit ?? 5, 1), 20);
+    const data = await apiGet('/reviewSubmissions', {
+        'filter[app]': args.appId,
+        'filter[platform]': platform,
+        'limit': String(limit),
+    });
+    const submissions = (data?.data ?? []);
+    const result = [];
+    for (const sub of submissions) {
+        // 버전만 include 하면 IAP·구독·구독그룹 항목이 전부 "?" 로 남아, 정작 중요한
+        // "이 묶음에 상품이 들어갔나"를 이 도구로 판별할 수 없었다 (2026-07-25 실측).
+        const itemsData = await apiGet(`/reviewSubmissions/${sub.id}/items`, {
+            include: 'appStoreVersion,inAppPurchaseV2,subscription,subscriptionGroup',
+            'fields[appStoreVersions]': 'versionString,appVersionState',
+            'fields[inAppPurchases]': 'productId,name,state',
+            'fields[subscriptions]': 'productId,name,state',
+            'fields[subscriptionGroups]': 'referenceName',
+            limit: '50',
+        }).catch(() => null);
+        const included = new Map((itemsData?.included ?? []).map((inc) => [`${inc.type}:${inc.id}`, inc]));
+        const items = (itemsData?.data ?? []).map((item) => {
+            const target = Object.entries(item.relationships ?? {}).find(([key, rel]) => key !== 'reviewSubmission' && rel?.data?.id)?.[1]?.data;
+            const inc = target?.type && target.id ? included.get(`${target.type}:${target.id}`) : undefined;
+            const a = inc?.attributes;
+            return {
+                id: item.id,
+                state: item.attributes?.state,
+                targetType: target?.type,
+                targetId: target?.id,
+                versionString: a?.versionString,
+                appVersionState: a?.appVersionState,
+                label: a?.productId ?? a?.referenceName ?? a?.name,
+                targetState: a?.state,
+            };
         });
-        submissionId = created?.data?.id;
-        if (!submissionId) {
-            throw new Error(`reviewSubmission 생성 응답에 id가 없어: ${JSON.stringify(created)}`);
-        }
-    }
-    // 같은 상품을 두 번 담으면 Apple 이 409 를 준다. 재시도가 안전하도록 먼저 확인한다.
-    const items = await apiGet(`/reviewSubmissions/${submissionId}/items`, { limit: '50' });
-    const rows = (items?.data ?? []);
-    const alreadyAttached = rows.some((row) => row?.relationships?.[relationship.key]?.data?.id === internalId);
-    if (!alreadyAttached) {
-        await apiPost('/reviewSubmissionItems', {
-            data: {
-                type: 'reviewSubmissionItems',
-                relationships: {
-                    reviewSubmission: { data: { type: 'reviewSubmissions', id: submissionId } },
-                    [relationship.key]: { data: { type: relationship.type, id: internalId } },
-                },
-            },
+        result.push({
+            id: sub.id,
+            state: sub.attributes?.state,
+            submittedDate: sub.attributes?.submittedDate ?? null,
+            items,
         });
     }
+    return { appId: args.appId, platform, submissions: result };
+}
+/** 묶음에서 항목 제거 (removed=true PATCH). ASC 웹 "재제출" 이 내부적으로 하는 그 동작. */
+export async function removeReviewSubmissionItem(itemId) {
+    const patched = await apiPatch(`/reviewSubmissionItems/${encodeURIComponent(itemId)}`, {
+        data: { type: 'reviewSubmissionItems', id: itemId, attributes: { removed: true } },
+    });
     return {
-        submissionId,
-        appId,
-        platform,
-        internalId,
-        productType,
-        reusedSubmission,
-        itemAttached: !alreadyAttached,
+        itemId,
+        state: patched?.data?.attributes?.state,
+        removed: patched?.data?.attributes?.removed ?? true,
     };
 }
+/**
+ * 버전을 물고 있는 낡은 묶음(UNRESOLVED_ISSUES)에서 해당 버전 항목을 removed=true 로
+ * 풀어준다. 항목이 풀리면 Apple 이 옛 묶음을 COMPLETE 로 정리하고, 종종 새
+ * READY_FOR_REVIEW 초안을 자동 생성한다 (실측). 풀어준 항목 수를 반환.
+ */
+async function releaseVersionFromStaleSubmissions(appId, platform, versionId) {
+    const data = await apiGet('/reviewSubmissions', {
+        'filter[app]': appId,
+        'filter[platform]': platform,
+        'filter[state]': 'UNRESOLVED_ISSUES',
+        'limit': '5',
+    }).catch(() => null);
+    const stale = (data?.data ?? []);
+    let released = 0;
+    for (const sub of stale) {
+        const items = await apiGet(`/reviewSubmissions/${sub.id}/items`, { limit: '50' }).catch(() => null);
+        const rows = (items?.data ?? []);
+        for (const row of rows) {
+            if (row?.relationships?.appStoreVersion?.data?.id !== versionId)
+                continue;
+            await removeReviewSubmissionItem(row.id);
+            released += 1;
+        }
+    }
+    return released;
+}
 // ─── 심사 철회 (Cancel Review) ───
 // WAITING_FOR_REVIEW 상태의 reviewSubmission에만 적용 가능.
 // IN_REVIEW 진입 후에는 Apple API가 거부함 (409).
-// submitted=false PATCH → version이 PREPARE_FOR_SUBMISSION으로 복귀.
+// PATCH attributes.canceled=true → state CANCELING → COMPLETE, version 은 편집 가능 상태로 복귀.
 export async function cancelVersionReview(versionId) {
     const { appId, platform } = await getVersionAppAndPlatform(versionId);
     // 취소 가능한 상태(WAITING_FOR_REVIEW)의 submission 검색
@@ -786,15 +887,21 @@ export async function cancelVersionReview(versionId) {
     }
     const submissionId = submission.id;
     const previousState = submission.attributes?.state ?? 'WAITING_FOR_REVIEW';
-    // submitted=false → WAITING_FOR_REVIEW → READY_FOR_REVIEW (version은 PREPARE_FOR_SUBMISSION으로 복귀)
+    // 취소 속성은 canceled 다. submitted:false 는 Apple 이 거부한다:
+    //   409 ENTITY_ERROR.ATTRIBUTE.INVALID "submitted must be set to true if present"
+    // 예전 구현이 submitted:false 를 보내서 이 도구는 사실상 항상 실패했고, 그 탓에
+    // "큐 진입 후에는 웹에서만 취소 가능" 이라는 잘못된 통설이 굳어 있었다.
+    // 실제로는 WAITING_FOR_REVIEW 에서도 canceled:true 가 통한다 (2026-07-25 실측):
+    //   200 → state: CANCELING → (수십 초) → COMPLETE, 항목은 REMOVED, 버전은 편집 가능 복귀.
     const patched = await apiPatch(`/reviewSubmissions/${submissionId}`, {
         data: {
             type: 'reviewSubmissions',
             id: submissionId,
-            attributes: { submitted: false },
+            attributes: { canceled: true },
         },
     });
-    const newState = patched?.data?.attributes?.state ?? 'READY_FOR_REVIEW';
+    // CANCELING 은 비동기다 — 호출 직후엔 아직 COMPLETE 가 아니다.
+    const newState = patched?.data?.attributes?.state ?? 'CANCELING';
     return { submissionId, previousState, newState, versionId };
 }
 // ─── 인앱 구매 (IAP) 생성 ───

package/dist/auth/google-auth.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 import http from 'node:http';
 import fs from 'node:fs';
 import path from 'node:path';

package/dist/bigquery/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 const bq = () => google.bigquery('v2');
 // ─── 쿼리 실행 ───
 export async function runQuery(auth, projectId, query, maxResults = 1000) {

package/dist/firebase/tools.d.ts

@@ -8,7 +8,7 @@ export declare function listProjects(auth: OAuth2Client): Promise<{
     state: string | null | undefined;
     projectNumber: string | null | undefined;
 }[]>;
-export declare function getProject(auth: OAuth2Client, projectId: string): Promise<import("googleapis").firebase_v1beta1.Schema$FirebaseProject>;
+export declare function getProject(auth: OAuth2Client, projectId: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$FirebaseProject>;
 /** long-running Operation 하나의 완료 여부를 판정한다. 폴링 루프에서 재사용 + 단독 테스트 가능. */
 export declare function operationOutcome(op: {
     done?: boolean | null;
@@ -45,39 +45,39 @@ export declare function waitForOperation(getOperation: () => Promise<{
  */
 export declare function createProject(auth: OAuth2Client, projectId: string, displayName: string, opts?: {
     parent?: string;
-}): Promise<import("googleapis").firebase_v1beta1.Schema$FirebaseProject>;
+}): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$FirebaseProject>;
 export declare function listAndroidApps(auth: OAuth2Client, projectId: string): Promise<{
     appId: string | null | undefined;
     packageName: string | null | undefined;
     displayName: string | null | undefined;
     state: string | null | undefined;
 }[]>;
-export declare function createAndroidApp(auth: OAuth2Client, projectId: string, packageName: string, displayName: string): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+export declare function createAndroidApp(auth: OAuth2Client, projectId: string, packageName: string, displayName: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
 export declare function getAndroidConfig(auth: OAuth2Client, projectId: string, appId: string): Promise<{
     filename: string | null | undefined;
     content: string | null;
 }>;
-export declare function deleteAndroidApp(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+export declare function deleteAndroidApp(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
 export declare function listIosApps(auth: OAuth2Client, projectId: string): Promise<{
     appId: string | null | undefined;
     bundleId: string | null | undefined;
     displayName: string | null | undefined;
     state: string | null | undefined;
 }[]>;
-export declare function createIosApp(auth: OAuth2Client, projectId: string, bundleId: string, displayName: string): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+export declare function createIosApp(auth: OAuth2Client, projectId: string, bundleId: string, displayName: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
 export declare function getIosConfig(auth: OAuth2Client, projectId: string, appId: string): Promise<{
     filename: string | null | undefined;
     content: string | null;
 }>;
-export declare function deleteIosApp(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+export declare function deleteIosApp(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
 export declare function listWebApps(auth: OAuth2Client, projectId: string): Promise<{
     appId: string | null | undefined;
     displayName: string | null | undefined;
     state: string | null | undefined;
 }[]>;
-export declare function createWebApp(auth: OAuth2Client, projectId: string, displayName: string): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
-export declare function getWebConfig(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis").firebase_v1beta1.Schema$WebAppConfig>;
-export declare function deleteWebApp(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+export declare function createWebApp(auth: OAuth2Client, projectId: string, displayName: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
+export declare function getWebConfig(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$WebAppConfig>;
+export declare function deleteWebApp(auth: OAuth2Client, projectId: string, appId: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
 export declare function enableService(auth: OAuth2Client, projectId: string, serviceId: string): Promise<{
     service: string;
     state: string | null | undefined;
@@ -97,9 +97,9 @@ export declare function listEnabledServices(auth: OAuth2Client, projectId: strin
 export declare function linkAnalytics(auth: OAuth2Client, projectId: string, opts?: {
     analyticsAccountId?: string;
     analyticsPropertyId?: string;
-}): Promise<import("googleapis").firebase_v1beta1.Schema$Operation>;
+}): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$Operation>;
 /** 프로젝트의 GA4 링크 상세 — 연결된 analyticsProperty + 앱↔stream 매핑 조회. */
-export declare function getAnalyticsDetails(auth: OAuth2Client, projectId: string): Promise<import("googleapis").firebase_v1beta1.Schema$AnalyticsDetails>;
+export declare function getAnalyticsDetails(auth: OAuth2Client, projectId: string): Promise<import("googleapis/build/src/apis/firebase/v1beta1.js").firebase_v1beta1.Schema$AnalyticsDetails>;
 export declare function enableCommonServices(auth: OAuth2Client, projectId: string): Promise<({
     service: string;
     status: string;

package/dist/firebase/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 /**
  * Firebase Management API + Cloud Resource Manager 래퍼
  */

package/dist/ga4/tools.d.ts

@@ -115,15 +115,15 @@ export declare function flattenBigQueryLink(link: {
     includeAdvertisingId: boolean;
 };
 /** 접근 가능한 GA 계정 + 각 계정의 property 요약. accountId/propertyId 를 찾는 시작점. */
-export declare function listAccountSummaries(auth: Ga4Auth): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaAccountSummary[]>;
+export declare function listAccountSummaries(auth: Ga4Auth): Promise<import("googleapis/build/src/apis/analyticsadmin/v1beta.js").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaAccountSummary[]>;
 /** 계정 하위 GA4 property 목록. accountId: '123' 또는 'accounts/123'. */
-export declare function listProperties(auth: Ga4Auth, accountId: string): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaProperty[]>;
+export declare function listProperties(auth: Ga4Auth, accountId: string): Promise<import("googleapis/build/src/apis/analyticsadmin/v1beta.js").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaProperty[]>;
 export declare function createProperty(auth: Ga4Auth, opts: {
     accountId: string;
     displayName: string;
     timeZone?: string;
     currencyCode?: string;
-}): Promise<import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaProperty>;
+}): Promise<import("googleapis/build/src/apis/analyticsadmin/v1beta.js").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaProperty>;
 export declare function createDataStream(auth: Ga4Auth, propertyId: string, opts: {
     platform: DataStreamPlatform;
     displayName: string;
@@ -131,7 +131,7 @@ export declare function createDataStream(auth: Ga4Auth, propertyId: string, opts
     packageName?: string;
     bundleId?: string;
 }): Promise<{
-    raw: import("googleapis").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaDataStream;
+    raw: import("googleapis/build/src/apis/analyticsadmin/v1beta.js").analyticsadmin_v1beta.Schema$GoogleAnalyticsAdminV1betaDataStream;
     name: string | null;
     type: string | null;
     displayName: string | null;
@@ -228,4 +228,4 @@ export interface RunReportParams {
     dimensions?: string[];
     metrics?: string[];
 }
-export declare function runReport(auth: Ga4Auth, propertyId: string, params: RunReportParams): Promise<import("googleapis").analyticsdata_v1beta.Schema$RunReportResponse>;
+export declare function runReport(auth: Ga4Auth, propertyId: string, params: RunReportParams): Promise<import("googleapis/build/src/apis/analyticsdata/v1beta.js").analyticsdata_v1beta.Schema$RunReportResponse>;

package/dist/ga4/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 /**
  * Google Analytics 4 — Admin API(v1beta) + Data API(v1beta) 래퍼.
  *

package/dist/gsc/tools.d.ts

@@ -1,14 +1,14 @@
 import type { OAuth2Client } from 'google-auth-library';
 export type GscAuth = OAuth2Client;
-export declare function listSites(auth: GscAuth): Promise<import("googleapis").searchconsole_v1.Schema$WmxSite[]>;
-export declare function listSitemaps(auth: GscAuth, siteUrl: string, sitemapIndex?: string): Promise<import("googleapis").searchconsole_v1.Schema$WmxSitemap[]>;
-export declare function getSitemap(auth: GscAuth, siteUrl: string, feedpath: string): Promise<import("googleapis").searchconsole_v1.Schema$WmxSitemap>;
+export declare function listSites(auth: GscAuth): Promise<import("googleapis/build/src/apis/searchconsole/v1.js").searchconsole_v1.Schema$WmxSite[]>;
+export declare function listSitemaps(auth: GscAuth, siteUrl: string, sitemapIndex?: string): Promise<import("googleapis/build/src/apis/searchconsole/v1.js").searchconsole_v1.Schema$WmxSitemap[]>;
+export declare function getSitemap(auth: GscAuth, siteUrl: string, feedpath: string): Promise<import("googleapis/build/src/apis/searchconsole/v1.js").searchconsole_v1.Schema$WmxSitemap>;
 /** 사이트맵 제출 — webmasters(read-write) 스코프 필요. 응답 본문은 없음(204). */
 export declare function submitSitemap(auth: GscAuth, siteUrl: string, feedpath: string): Promise<{
     submitted: string;
     siteUrl: string;
 }>;
-export declare function inspectUrl(auth: GscAuth, siteUrl: string, inspectionUrl: string, languageCode?: string): Promise<import("googleapis").searchconsole_v1.Schema$UrlInspectionResult>;
+export declare function inspectUrl(auth: GscAuth, siteUrl: string, inspectionUrl: string, languageCode?: string): Promise<import("googleapis/build/src/apis/searchconsole/v1.js").searchconsole_v1.Schema$UrlInspectionResult>;
 export interface SearchAnalyticsParams {
     startDate: string;
     endDate: string;
@@ -17,7 +17,7 @@ export interface SearchAnalyticsParams {
     startRow?: number;
     type?: 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
 }
-export declare function searchAnalytics(auth: GscAuth, siteUrl: string, params: SearchAnalyticsParams): Promise<import("googleapis").searchconsole_v1.Schema$ApiDataRow[]>;
+export declare function searchAnalytics(auth: GscAuth, siteUrl: string, params: SearchAnalyticsParams): Promise<import("googleapis/build/src/apis/searchconsole/v1.js").searchconsole_v1.Schema$ApiDataRow[]>;
 export interface SearchAnalyticsRow {
     keys?: string[] | null;
     clicks?: number | null;

package/dist/gsc/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 /**
  * Google Search Console (Webmasters) API v1 래퍼.
  *

package/dist/iam/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 /**
  * Google Cloud IAM + Cloud Resource Manager 래퍼.
  *

package/dist/lib/googleapis-lite.d.ts

@@ -0,0 +1,39 @@
+/**
+ * googleapis 서브패스 로더 — MCP 서버 기동 시간 방어벽.
+ *
+ * `import { google } from 'googleapis'` 는 import 시점에 400여 개 API 클라이언트를
+ * 전부 로드해 그것만으로 ~19초를 쓴다. 그 결과 MCP 서버 기동(21~36초)이 Claude Code 의
+ * MCP 연결 타임아웃(30초)을 상습 초과해, 세션에서 mimi-seed 도구가 아예 등록되지 않는
+ * 사고가 났다 (2026-07-24). 실제 사용하는 API 만 서브패스로 로드하면 ~1초대다.
+ *
+ * - 새 Google API 가 필요하면 여기에 import 한 줄 + google 객체에 한 줄 추가한다.
+ * - 다른 파일에서 `from 'googleapis'` 값 import 는 금지 — 반드시 이 모듈을 거친다.
+ *   (googleapis 는 exports map 이 없어 서브패스 import 가 공식적으로 가능하다.)
+ * - `auth` 는 AuthPlus 인스턴스라 `google.auth.OAuth2` 등 기존 사용처가 그대로 동작한다.
+ */
+import { admob } from 'googleapis/build/src/apis/admob/index.js';
+import { analyticsadmin } from 'googleapis/build/src/apis/analyticsadmin/index.js';
+import { analyticsdata } from 'googleapis/build/src/apis/analyticsdata/index.js';
+import { androidpublisher } from 'googleapis/build/src/apis/androidpublisher/index.js';
+import { bigquery } from 'googleapis/build/src/apis/bigquery/index.js';
+import { cloudresourcemanager } from 'googleapis/build/src/apis/cloudresourcemanager/index.js';
+import { firebase } from 'googleapis/build/src/apis/firebase/index.js';
+import { iam } from 'googleapis/build/src/apis/iam/index.js';
+import { searchconsole } from 'googleapis/build/src/apis/searchconsole/index.js';
+import { serviceusage } from 'googleapis/build/src/apis/serviceusage/index.js';
+import { youtube } from 'googleapis/build/src/apis/youtube/index.js';
+export type { youtube_v3 } from 'googleapis/build/src/apis/youtube/index.js';
+export declare const google: {
+    auth: import("googleapis-common/build/src/authplus.js").AuthPlus;
+    admob: typeof admob;
+    analyticsadmin: typeof analyticsadmin;
+    analyticsdata: typeof analyticsdata;
+    androidpublisher: typeof androidpublisher;
+    bigquery: typeof bigquery;
+    cloudresourcemanager: typeof cloudresourcemanager;
+    firebase: typeof firebase;
+    iam: typeof iam;
+    searchconsole: typeof searchconsole;
+    serviceusage: typeof serviceusage;
+    youtube: typeof youtube;
+};

package/dist/lib/googleapis-lite.js

@@ -0,0 +1,38 @@
+/**
+ * googleapis 서브패스 로더 — MCP 서버 기동 시간 방어벽.
+ *
+ * `import { google } from 'googleapis'` 는 import 시점에 400여 개 API 클라이언트를
+ * 전부 로드해 그것만으로 ~19초를 쓴다. 그 결과 MCP 서버 기동(21~36초)이 Claude Code 의
+ * MCP 연결 타임아웃(30초)을 상습 초과해, 세션에서 mimi-seed 도구가 아예 등록되지 않는
+ * 사고가 났다 (2026-07-24). 실제 사용하는 API 만 서브패스로 로드하면 ~1초대다.
+ *
+ * - 새 Google API 가 필요하면 여기에 import 한 줄 + google 객체에 한 줄 추가한다.
+ * - 다른 파일에서 `from 'googleapis'` 값 import 는 금지 — 반드시 이 모듈을 거친다.
+ *   (googleapis 는 exports map 이 없어 서브패스 import 가 공식적으로 가능하다.)
+ * - `auth` 는 AuthPlus 인스턴스라 `google.auth.OAuth2` 등 기존 사용처가 그대로 동작한다.
+ */
+import { admob } from 'googleapis/build/src/apis/admob/index.js';
+import { analyticsadmin } from 'googleapis/build/src/apis/analyticsadmin/index.js';
+import { analyticsdata } from 'googleapis/build/src/apis/analyticsdata/index.js';
+import { androidpublisher } from 'googleapis/build/src/apis/androidpublisher/index.js';
+import { bigquery } from 'googleapis/build/src/apis/bigquery/index.js';
+import { cloudresourcemanager } from 'googleapis/build/src/apis/cloudresourcemanager/index.js';
+import { auth, firebase } from 'googleapis/build/src/apis/firebase/index.js';
+import { iam } from 'googleapis/build/src/apis/iam/index.js';
+import { searchconsole } from 'googleapis/build/src/apis/searchconsole/index.js';
+import { serviceusage } from 'googleapis/build/src/apis/serviceusage/index.js';
+import { youtube } from 'googleapis/build/src/apis/youtube/index.js';
+export const google = {
+    auth,
+    admob,
+    analyticsadmin,
+    analyticsdata,
+    androidpublisher,
+    bigquery,
+    cloudresourcemanager,
+    firebase,
+    iam,
+    searchconsole,
+    serviceusage,
+    youtube,
+};

package/dist/playstore/tools.d.ts

@@ -7,7 +7,7 @@ export type PlayImageType = 'featureGraphic' | 'icon' | 'phoneScreenshots' | 'pr
  * 주의: 최초 앱 생성은 API로 불가 (Play Console에서만).
  * 여기서는 기존 앱의 메타데이터, 빌드, 출시를 관리.
  */
-export declare const publisher: () => import("googleapis").androidpublisher_v3.Androidpublisher;
+export declare const publisher: () => import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Androidpublisher;
 export type PlayVitalsMetricSet = 'anrRate' | 'crashRate' | 'errorCount';
 export interface PlayStatisticsQuery {
     metricSet?: PlayVitalsMetricSet;
@@ -22,31 +22,35 @@ export interface PlayStatisticsQuery {
     userCohort?: 'OS_PUBLIC' | 'APP_TESTERS' | 'OS_BETA';
     timeZone?: string;
 }
-export declare function withEdit<T>(auth: OAuth2Client | JWT, packageName: string, fn: (editId: string) => Promise<T>, commit?: boolean): Promise<T>;
+export interface EditCommitInfo {
+    /** true 면 커밋은 됐지만 심사 전송은 Play Console 에서 사람이 눌러야 한다. */
+    changesNotSentForReview: boolean;
+}
+export declare function withEdit<T>(auth: OAuth2Client | JWT, packageName: string, fn: (editId: string) => Promise<T>, commit?: boolean, onCommit?: (info: EditCommitInfo) => void): Promise<T>;
 export declare function getStatistics(auth: OAuth2Client | JWT, packageName: string, query: PlayStatisticsQuery): Promise<unknown>;
-export declare function getAppDetails(auth: OAuth2Client | JWT, packageName: string): Promise<import("googleapis").androidpublisher_v3.Schema$AppDetails>;
+export declare function getAppDetails(auth: OAuth2Client | JWT, packageName: string): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$AppDetails>;
 export declare function updateAppDetails(auth: OAuth2Client | JWT, packageName: string, data: {
     contactEmail?: string;
     contactPhone?: string;
     contactWebsite?: string;
     defaultLanguage?: string;
-}): Promise<import("googleapis").androidpublisher_v3.Schema$AppDetails>;
-export declare function getListing(auth: OAuth2Client | JWT, packageName: string, language?: string): Promise<import("googleapis").androidpublisher_v3.Schema$Listing>;
+}): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$AppDetails>;
+export declare function getListing(auth: OAuth2Client | JWT, packageName: string, language?: string): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Listing>;
 export declare function updateListing(auth: OAuth2Client | JWT, packageName: string, language: string, data: {
     title?: string;
     shortDescription?: string;
     fullDescription?: string;
-}): Promise<import("googleapis").androidpublisher_v3.Schema$Listing>;
+}): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Listing>;
 export declare function listTracks(auth: OAuth2Client | JWT, packageName: string): Promise<{
     track: string | null | undefined;
     releases: {
         name: string | null | undefined;
         status: string | null | undefined;
         versionCodes: string[] | null | undefined;
-        releaseNotes: import("googleapis").androidpublisher_v3.Schema$LocalizedText[] | undefined;
+        releaseNotes: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$LocalizedText[] | undefined;
     }[];
 }[]>;
-export declare function updateReleaseNotes(auth: OAuth2Client | JWT, packageName: string, track: string, versionCode: string, language: string, text: string): Promise<import("googleapis").androidpublisher_v3.Schema$Track>;
+export declare function updateReleaseNotes(auth: OAuth2Client | JWT, packageName: string, track: string, versionCode: string, language: string, text: string): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Track>;
 /**
  * 최신 release (versionCode 최대값)의 releaseNotes[language]를 교체/추가.
  * versionCode를 모를 때 편의용.
@@ -54,11 +58,11 @@ export declare function updateReleaseNotes(auth: OAuth2Client | JWT, packageName
 export declare function updateLatestReleaseNotes(auth: OAuth2Client | JWT, packageName: string, track: string, language: string, text: string): Promise<{
     updatedVersionCodes: string[] | null | undefined;
     updatedReleaseName: string | null | undefined;
-    releases?: import("googleapis").androidpublisher_v3.Schema$TrackRelease[];
+    releases?: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$TrackRelease[];
     track?: string | null;
 }>;
-export declare function listImages(auth: OAuth2Client | JWT, packageName: string, language: string, imageType: PlayImageType): Promise<import("googleapis").androidpublisher_v3.Schema$Image[]>;
-export declare function uploadImage(auth: OAuth2Client | JWT, packageName: string, language: string, imageType: PlayImageType, filePath: string): Promise<import("googleapis").androidpublisher_v3.Schema$Image | undefined>;
+export declare function listImages(auth: OAuth2Client | JWT, packageName: string, language: string, imageType: PlayImageType): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Image[]>;
+export declare function uploadImage(auth: OAuth2Client | JWT, packageName: string, language: string, imageType: PlayImageType, filePath: string): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Image | undefined>;
 export declare function deleteAllImages(auth: OAuth2Client | JWT, packageName: string, language: string, imageType: PlayImageType): Promise<{
     ok: boolean;
     imageType: PlayImageType;
@@ -82,7 +86,7 @@ export declare function submitRelease(auth: OAuth2Client | JWT, packageName: str
     previousStatus: string | null | undefined;
     newStatus: "completed" | "draft" | "inProgress" | "halted";
     committed: boolean;
-    result: import("googleapis").androidpublisher_v3.Schema$Track;
+    result: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Track;
 }>;
 export interface PromoteReleaseOptions {
     status?: 'completed' | 'draft' | 'inProgress' | 'halted';
@@ -95,6 +99,9 @@ export interface PromoteReleaseOptions {
     copyReleaseNotes?: boolean;
 }
 export declare function promoteRelease(auth: OAuth2Client | JWT, packageName: string, fromTrack: string, toTrack: string, versionCode: string, options?: PromoteReleaseOptions): Promise<{
+    changesNotSentForReview: boolean;
+    nextAction: string | undefined;
+    warnings: string[] | undefined;
     packageName: string;
     fromTrack: string;
     toTrack: string;
@@ -104,7 +111,7 @@ export declare function promoteRelease(auth: OAuth2Client | JWT, packageName: st
     releaseName: string | null | undefined;
     releaseNotesLanguages: (string | null | undefined)[];
     committed: boolean;
-    result: import("googleapis").androidpublisher_v3.Schema$Track;
+    result: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$Track;
 }>;
 export declare function listReviews(auth: OAuth2Client | JWT, packageName: string): Promise<{
     reviewId: string | null | undefined;
@@ -116,7 +123,7 @@ export declare function listReviews(auth: OAuth2Client | JWT, packageName: strin
         deviceMetadata: string | null | undefined;
     }[] | undefined;
 }[]>;
-export declare function replyToReview(auth: OAuth2Client | JWT, packageName: string, reviewId: string, replyText: string): Promise<import("googleapis").androidpublisher_v3.Schema$ReviewsReplyResponse>;
+export declare function replyToReview(auth: OAuth2Client | JWT, packageName: string, reviewId: string, replyText: string): Promise<import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$ReviewsReplyResponse>;
 export declare function listInAppProducts(auth: OAuth2Client | JWT, packageName: string): Promise<{
     productId: any;
     listings: any;
@@ -124,8 +131,8 @@ export declare function listInAppProducts(auth: OAuth2Client | JWT, packageName:
 }[]>;
 export declare function listSubscriptions(auth: OAuth2Client | JWT, packageName: string): Promise<{
     productId: string | null | undefined;
-    basePlans: import("googleapis").androidpublisher_v3.Schema$BasePlan[] | undefined;
-    listings: import("googleapis").androidpublisher_v3.Schema$SubscriptionListing[] | undefined;
+    basePlans: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$BasePlan[] | undefined;
+    listings: import("googleapis/build/src/apis/androidpublisher/v3.js").androidpublisher_v3.Schema$SubscriptionListing[] | undefined;
 }[]>;
 export interface ProductListingInput {
     languageCode: string;

package/dist/playstore/tools.js

@@ -1,4 +1,4 @@
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 import { JWT } from 'google-auth-library';
 import fs from 'node:fs';
 import { extractHttpStatus } from '../lib/google-errors.js';
@@ -41,7 +41,26 @@ function dateToReportingDateTime(date, timeZone) {
         timeZone: { id: timeZone },
     };
 }
-export async function withEdit(auth, packageName, fn, commit = false) {
+// Play 는 앱/계정 상태에 따라 "커밋과 동시에 심사 전송"을 거부한다:
+//   Changes cannot be sent for review automatically.
+//   Please set the query parameter changesNotSentForReview to true.
+// 이 경우 그 파라미터를 붙여야만 커밋이 통과한다. 예전 구현은 파라미터를 노출하지도,
+// 폴백하지도 않아서 그런 앱에서는 promote/submit 계열이 **100% 실패**했다
+// (PenguinRun 2026-07-25 실측 — 결국 Android Publisher API 를 직접 쳐서 우회해야 했다).
+async function commitEdit(auth, packageName, editId) {
+    try {
+        await publisher().edits.commit({ auth, packageName, editId });
+        return { changesNotSentForReview: false };
+    }
+    catch (err) {
+        const msg = String(err?.message ?? err);
+        if (!/changesNotSentForReview/i.test(msg))
+            throw err;
+        await publisher().edits.commit({ auth, packageName, editId, changesNotSentForReview: true });
+        return { changesNotSentForReview: true };
+    }
+}
+export async function withEdit(auth, packageName, fn, commit = false, onCommit) {
     const res = await publisher().edits.insert({ auth, packageName });
     const editId = res.data.id;
     if (!editId)
@@ -49,7 +68,12 @@ export async function withEdit(auth, packageName, fn, commit = false) {
     try {
         const result = await fn(editId);
         if (commit) {
-            await publisher().edits.commit({ auth, packageName, editId });
+            // 반드시 먼저 커밋하고 나서 콜백에 넘긴다.
+            // onCommit?.(await commitEdit(...)) 로 쓰면 안 된다 — 옵셔널 호출은 수신자가
+            // nullish 일 때 인자 자체를 평가하지 않아서, onCommit 을 안 넘긴 호출자(대부분)에서
+            // 커밋이 통째로 사라진다. playstore-listing 테스트가 이걸 잡아냈다.
+            const info = await commitEdit(auth, packageName, editId);
+            onCommit?.(info);
         }
         return result;
     }
@@ -379,7 +403,9 @@ export async function promoteRelease(auth, packageName, fromTrack, toTrack, vers
     if (status === 'inProgress' && (userFraction == null || userFraction <= 0 || userFraction >= 1)) {
         throw new Error('status="inProgress"일 때 userFraction은 0과 1 사이 필수 (예: 0.1 → 10%).');
     }
-    return withEdit(auth, packageName, async (editId) => {
+    let commitInfo = { changesNotSentForReview: false };
+    const warnings = [];
+    const out = await withEdit(auth, packageName, async (editId) => {
         // 1. source 트랙에서 versionCode 매칭 release 찾기
         const fromData = await publisher().edits.tracks.get({
             auth, packageName, editId, track: fromTrack,
@@ -405,6 +431,20 @@ export async function promoteRelease(auth, packageName, fromTrack, toTrack, vers
         if (status === 'inProgress' && userFraction != null) {
             newRelease.userFraction = userFraction;
         }
+        // 2-b. 릴리스 노트 회귀 가드.
+        //   CI 가 internal 에 올릴 때 "v2.0.6 (70)" 같은 플레이스홀더를 한 언어만 넣어두는 경우가 흔한데,
+        //   copyReleaseNotes 기본값(true)으로 production 에 승격하면 살아 있던 다국어 노트가
+        //   그 플레이스홀더로 통째 덮인다 (PenguinRun 2026-07-25 에 실제로 밟을 뻔한 함정).
+        //   막지는 않되(의도적일 수 있으므로) 반드시 눈에 띄게 알린다.
+        if (!releaseNotes && copyReleaseNotes) {
+            const copied = sourceRelease.releaseNotes ?? [];
+            const placeholder = copied.filter((n) => /^\s*v?\d+(\.\d+)*\s*(\(\d+\))?\s*$/.test(n.text ?? ''));
+            if (placeholder.length > 0) {
+                warnings.push(`${fromTrack} 의 릴리스 노트가 버전 문자열뿐이라 플레이스홀더로 보인다 ` +
+                    `(${placeholder.map((n) => `${n.language}="${n.text}"`).join(', ')}). ` +
+                    `이대로 ${toTrack} 에 덮어쓰면 기존 노트가 사라진다 — releaseNotes 를 직접 넘기거나 copyReleaseNotes:false 를 고려할 것.`);
+            }
+        }
         // 3. target 트랙 현재 상태 조회 후 merge
         //    - 같은 versionCode가 이미 target에 있으면 그 항목을 새 release로 교체
         //    - status='completed'면 활성 release가 1개여야 하므로 [newRelease]로 통째 교체
@@ -442,7 +482,19 @@ export async function promoteRelease(auth, packageName, fromTrack, toTrack, vers
             committed: true,
             result: updated.data,
         };
-    }, true);
+    }, true, (info) => { commitInfo = info; });
+    if ((out.releaseNotesLanguages ?? []).length === 0) {
+        warnings.push(`${toTrack} 에 릴리스 노트 없이 승격됐다 — 스토어의 "새로운 기능"이 비어 보인다.`);
+    }
+    return {
+        ...out,
+        changesNotSentForReview: commitInfo.changesNotSentForReview,
+        // Play 가 자동 심사 전송을 거부한 경우, 사람이 콘솔에서 눌러야 실제 심사가 시작된다.
+        nextAction: commitInfo.changesNotSentForReview
+            ? 'Play Console 에서 "변경사항 검토 후 게시"(심사를 위해 전송)를 눌러야 심사가 시작된다.'
+            : undefined,
+        warnings: warnings.length ? warnings : undefined,
+    };
 }
 export async function listReviews(auth, packageName) {
     const res = await publisher().reviews.list({ auth, packageName });

package/dist/registers/appstore.js

@@ -588,16 +588,18 @@ export function registerAppstoreTools(server) {
                 }],
         };
     });
-    server.tool('appstore_add_product_to_review', 'App Store IAP/구독을 심사 제출 묶음에 담는다 — App Store Connect 웹의 "심사에 추가" 버튼과 같다. ' +
-        '담기만 하고 제출하지는 않는다 (제출은 appstore_submit_for_review). ' +
-        '⚠️ 그 앱의 첫 소모성 IAP 는 앱 버전과 같은 묶음으로만 심사에 넣을 수 있다 — IAP 를 전부 담은 뒤 버전을 제출해야 한 번에 나간다. ' +
+    server.tool('appstore_add_product_to_review', 'App Store IAP/구독 상품을 **단독으로** 심사에 제출한다 — consumable/non_consumable 은 ' +
+        'POST /v1/inAppPurchaseSubmissions, subscription 은 POST /v1/subscriptionSubmissions. ' +
+        '⚠️ 호출 즉시 제출된다 ("묶음에 담기"가 아니다 — 그런 공개 API 는 존재하지 않는다. ' +
+        'reviewSubmissionItems 는 appStoreVersion 계열 관계만 받는다, 2026-07 실측). ' +
+        '이미 승인된 적 있는 상품의 변경분 제출용. **앱 첫 심사** 상품은 Apple 이 ' +
+        '"no pending version" 409 로 거부한다 — 그 경우 ASC 웹 버전 페이지의 ' +
+        '"앱 내 구입 및 구독" 섹션에서 담아 버전과 함께 제출해야 한다 (도구가 에러에 안내 첨부). ' +
         '상품 상태가 READY_TO_SUBMIT 이어야 한다 (MISSING_METADATA 면 appstore_update_product_localization 먼저).', {
         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('상품 유형'),
-        platform: z.enum(['IOS', 'MAC_OS', 'TV_OS', 'VISION_OS']).default('IOS').optional()
-            .describe('플랫폼 (기본 IOS)'),
-    }, async ({ appId, productId, productType, platform }) => {
+    }, async ({ appId, productId, productType }) => {
         const creds = requireAppStoreCreds();
         const products = await listAppleProducts({
             appId, keyId: creds.keyId, issuerId: creds.issuerId, privateKey: creds.privateKey,
@@ -607,22 +609,83 @@ export function registerAppstoreTools(server) {
             return { content: [{ type: 'text', text: `상품을 찾을 수 없음: ${productId} (${productType})` }] };
         }
         const result = await appstore.addProductToReviewSubmission({
-            appId,
             internalId: product.internalId,
             productType,
-            platform,
         });
         return {
             content: [{
                     type: 'text',
                     text: [
-                        result.itemAttached ? '✓ 심사 묶음에 추가됨' : '이미 묶음에 들어 있음 (변경 없음)',
+                        '✓ 상품 심사 제출 완료 (Apple 심사 대기)',
                         `productId: ${productId}`,
-                        `submissionId: ${result.submissionId}`,
-                        `기존 묶음 재사용: ${result.reusedSubmission}`,
+                        `endpoint: ${result.endpoint}`,
+                        result.submissionId ? `submissionId: ${result.submissionId}` : '',
                         '',
-                        '제출은 아직 안 됐다. 담을 상품을 전부 담은 뒤 appstore_submit_for_review 로 버전과 함께 제출한다.',
-                    ].join('\n'),
+                        '앱 버전과는 별개의 단독 제출이다. 버전 제출은 appstore_submit_for_review.',
+                    ].filter(Boolean).join('\n'),
+                }],
+        };
+    });
+    server.tool('appstore_list_review_submissions', 'App Store 심사 제출 묶음(reviewSubmissions) + 내부 항목 조회 — 읽기 전용. ' +
+        '각 묶음의 state(READY_FOR_REVIEW=초안 / WAITING_FOR_REVIEW=큐 / UNRESOLVED_ISSUES=거절 미해결 / COMPLETE) 와 ' +
+        '항목별 state·연결 리소스(appStoreVersion 이면 versionString 포함)를 보여준다. ' +
+        '재제출이 "appStoreVersions ... is not in valid state" 로 막힐 때 첫 번째로 볼 것 — ' +
+        '진범은 대개 UNRESOLVED_ISSUES 묶음이 버전을 REJECTED 항목으로 물고 있는 것이다 ' +
+        '(버전 자체는 PREPARE_FOR_SUBMISSION 으로 멀쩡해 보인다, 2026-07 실측). ' +
+        '해제는 appstore_remove_review_submission_item.', {
+        appId: z.string().describe('App Store 앱 ID (숫자형, appstore_list_apps 결과)'),
+        platform: z.enum(['IOS', 'MAC_OS', 'TV_OS', 'VISION_OS']).default('IOS').optional()
+            .describe('플랫폼 (기본 IOS)'),
+        limit: z.number().int().min(1).max(20).optional().describe('조회할 묶음 수 (기본 5, 최신순)'),
+    }, async ({ appId, platform, limit }) => {
+        const result = await appstore.listReviewSubmissions({ appId, platform, limit });
+        const lines = [`심사 제출 묶음 ${result.submissions.length}건 (${result.platform})`];
+        for (const sub of result.submissions) {
+            lines.push('');
+            lines.push(`● ${sub.id}`);
+            lines.push(`  state: ${sub.state ?? '?'}  submitted: ${sub.submittedDate ?? '(미제출)'}`);
+            if (sub.items.length === 0) {
+                lines.push('  items: (없음)');
+            }
+            // 항목 종류별 요약. 상품이 몇 개 들어갔는지가 첫 심사에서 가장 중요한 정보다.
+            const kinds = new Map();
+            for (const item of sub.items) {
+                const k = item.targetType ?? 'unknown';
+                kinds.set(k, (kinds.get(k) ?? 0) + 1);
+            }
+            lines.push(`  항목 ${sub.items.length}개` +
+                (kinds.size ? ` — ${[...kinds].map(([k, n]) => `${k} ${n}`).join(', ')}` : ''));
+            if (sub.items.length === 0) {
+                lines.push('  items: (없음)');
+            }
+            for (const item of sub.items) {
+                const target = item.versionString
+                    ? `${item.targetType} ${item.versionString} (${item.appVersionState ?? '?'})`
+                    : item.label
+                        ? `${item.targetType} ${item.label}${item.targetState ? ` (${item.targetState})` : ''}`
+                        : `${item.targetType ?? '?'} ${item.targetId ?? ''}`;
+                lines.push(`  - item ${item.id}`);
+                lines.push(`    state: ${item.state ?? '?'} → ${target}`);
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    });
+    server.tool('appstore_remove_review_submission_item', '심사 제출 묶음에서 항목을 제거한다 (removed=true PATCH) — ASC 웹 "재제출" 버튼이 내부적으로 하는 동작. ' +
+        '거절된 옛 묶음(UNRESOLVED_ISSUES)이 버전을 물고 있어 재제출이 ENTITY_STATE_INVALID 로 막힐 때 해제용. ' +
+        '항목이 풀리면 옛 묶음은 COMPLETE 로 정리된다. itemId 는 appstore_list_review_submissions 결과. ' +
+        '(appstore_submit_for_review 는 이 해제를 자동으로 시도한다 — 수동 개입이 필요할 때만 직접 호출.)', {
+        itemId: z.string().describe('reviewSubmissionItem ID (appstore_list_review_submissions 결과)'),
+    }, async ({ itemId }) => {
+        const result = await appstore.removeReviewSubmissionItem(itemId);
+        return {
+            content: [{
+                    type: 'text',
+                    text: [
+                        '✓ 묶음에서 항목 제거됨',
+                        `itemId: ${result.itemId}`,
+                        result.state ? `state: ${result.state}` : '',
+                        '항목이 버전이었다면 이제 다른 묶음에 붙일 수 있다 (appstore_submit_for_review).',
+                    ].filter(Boolean).join('\n'),
                 }],
         };
     });
@@ -689,6 +752,7 @@ export function registerAppstoreTools(server) {
         '⚠️ 비가역 작업: 제출 후엔 Apple 심사가 시작되며, 메타데이터/스크린샷/빌드를 더 못 바꿈 (REJECTED/METADATA_REJECTED 시 다시 편집 가능).',
         '안전 가드: confirm 생략/false 시 dry-run preview 만 반환 (versionString·빌드·whatsNew 발췌). 실제 제출은 confirm: true 로 재호출.',
         '사전 조건: 버전이 PREPARE_FOR_SUBMISSION 또는 DEVELOPER_REJECTED 상태, 빌드 attached, 모든 필수 메타데이터 채워짐.',
+        '거절된 옛 묶음(UNRESOLVED_ISSUES)이 버전을 물고 있어 attach 가 막히면 자동으로 항목을 해제(removed=true)하고 재시도한다 — 진단은 appstore_list_review_submissions.',
         'appstore_check_submission_risks로 사전 점검 권장.',
     ].join(' '), {
         versionId: z.string().describe('App Store 버전 ID (appstore_list_versions 결과)'),
@@ -730,8 +794,10 @@ export function registerAppstoreTools(server) {
     });
     server.tool('appstore_cancel_review', [
         'App Store 심사 제출을 철회 — WAITING_FOR_REVIEW 상태에서만 가능.',
-        'submitted=false PATCH → reviewSubmission이 READY_FOR_REVIEW로 복귀, 버전은 PREPARE_FOR_SUBMISSION 상태로 돌아가 메타데이터/빌드 수정 가능.',
+        'PATCH attributes.canceled=true → state 가 CANCELING 으로 바뀌고 수십 초 뒤 COMPLETE(항목 REMOVED), 버전은 편집 가능 상태로 복귀해 메타데이터/빌드 수정 가능.',
+        'CANCELING 은 비동기라 호출 직후엔 아직 COMPLETE 가 아니다 — 이어서 작업하려면 상태를 폴링할 것.',
         '⚠️ IN_REVIEW 이상이면 Apple API가 409로 거부함 — 이 경우 App Store Connect 웹에서 직접 처리하거나 심사 결과를 기다려야 함.',
+        '제출된 묶음에서 항목만 빼내는 것(removed)은 막히므로, 버전을 다른 묶음으로 옮기려면 이 도구로 묶음째 취소한다.',
         '철회 후 수정 완료 시 appstore_submit_for_review로 재제출 가능.',
     ].join(' '), {
         versionId: z.string().describe('App Store 버전 ID (appstore_list_versions 결과)'),

package/dist/registers/playstore.js

@@ -563,6 +563,8 @@ export function registerPlaystoreTools(server) {
         'status="completed" + production 으로 전체 출시, status="inProgress" + userFraction 으로 단계 출시(예: 0.1 = 10%).',
         'target에 같은 versionCode가 이미 있으면 해당 항목을 교체. status="completed"면 target 활성 release를 통째로 새 것으로 대체.',
         '⚠️ status="completed"는 비가역에 가까움. playstore_check_submission_risks로 사전 점검 권장.',
+        'Play 가 자동 심사 전송을 거부하는 앱이면 changesNotSentForReview=true 로 자동 폴백해 커밋한다 — 이때 응답의 changesNotSentForReview=true 와 nextAction 을 사용자에게 전달할 것(콘솔에서 "심사를 위해 전송"을 눌러야 심사 시작).',
+        'source 트랙 노트가 버전 문자열뿐인 플레이스홀더면 warnings 로 알린다 — 그대로 승격하면 대상 트랙의 다국어 노트가 덮인다.',
     ].join(' '), {
         packageName: z.string().describe('패키지명 (예: gg.pryzm.coffee)'),
         fromTrack: z.enum(['production', 'beta', 'alpha', 'internal']).describe('출처 트랙 (예: internal)'),

package/dist/video/youtube-publish.d.ts

@@ -1,4 +1,4 @@
-import { type youtube_v3 } from 'googleapis';
+import { type youtube_v3 } from '../lib/googleapis-lite.js';
 import type { OAuth2Client } from 'google-auth-library';
 import { validateVideo } from './render.js';
 export declare const YOUTUBE_SCOPE = "https://www.googleapis.com/auth/youtube.force-ssl";

package/dist/video/youtube-publish.js

@@ -1,6 +1,6 @@
 import { createReadStream, existsSync, statSync } from 'node:fs';
 import path from 'node:path';
-import { google } from 'googleapis';
+import { google } from '../lib/googleapis-lite.js';
 import { friendlyGoogleError } from '../lib/google-errors.js';
 import { validateVideo } from './render.js';
 export const YOUTUBE_SCOPE = 'https://www.googleapis.com/auth/youtube.force-ssl';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.13.10",
+  "version": "0.13.13",
   "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": 185,
+  "total": 187,
   "domains": {
     "admob": {
       "label": "AdMob",
@@ -76,6 +76,8 @@
         "appstore_delete_product",
         "appstore_plan_release",
         "appstore_submit_for_review",
+        "appstore_list_review_submissions",
+        "appstore_remove_review_submission_item",
         "appstore_cancel_review"
       ]
     },