@yoonion/mimi-seed-mcp 0.13.6 → 0.13.8

package/dist/appstore/errors.js

@@ -18,8 +18,17 @@ const CODE_HINTS = {
     // 버전 상태가 편집 불가 (READY_FOR_SALE / WAITING_FOR_REVIEW 등)
     ENTITY_STATE_INVALID: '버전 상태가 편집 가능 단계가 아니에요 (이미 심사중/출시됨). 새 versionString 으로 appstore_create_version 필요할 수 있어요.',
     // 필수 필드 누락
+    // ⚠️ Apple 이 실제로 보내는 코드는 점 표기다 (ENTITY_ERROR.ATTRIBUTE.REQUIRED).
+    // 아래 언더스코어 키들은 오래 매칭된 적이 없었다 — 점 표기를 정본으로 두고
+    // 언더스코어 변형은 혹시 모를 옛 응답용으로 남긴다 (2026-07-21 실측으로 발견).
+    'ENTITY_ERROR.ATTRIBUTE.REQUIRED': '필수 필드가 빠졌어요 — source.pointer 위치 확인.',
     ENTITY_ERROR_ATTRIBUTE_REQUIRED: '필수 필드가 빠졌어요 — source.pointer 위치 확인.',
-    // 길이 / 형식 위반
+    // 길이 초과 — detail 에 실제 상한이 숫자로 들어온다 ("Max number of characters is (55)").
+    'ENTITY_ERROR.ATTRIBUTE.INVALID.TOO_LONG': '길이 초과 — detail 의 괄호 숫자가 Apple 이 강제하는 실제 상한이에요. 그 값에 맞춰 줄이세요.',
+    // 심사 중이라 필드가 잠김. 상품이 WAITING_FOR_REVIEW/IN_REVIEW 면 현지화를 못 고친다.
+    'ENTITY_ERROR.ATTRIBUTE.INVALID.UNMODIFIABLE': '지금 상태에선 못 고치는 필드예요 — 상품이 심사 중이면 현지화가 잠깁니다. '
+        + '심사 결과를 기다리거나 appstore_cancel_review 로 철회한 뒤 수정하세요.',
+    'ENTITY_ERROR.ATTRIBUTE.INVALID': '필드 값이 정책 위반(길이/형식). source.pointer 위치 확인.',
     ENTITY_ERROR_ATTRIBUTE_INVALID: '필드 값이 정책 위반(길이/형식). source.pointer 위치 확인.',
     // 빌드 attach 시 빌드를 못 찾음
     NOT_FOUND: '대상 리소스를 찾을 수 없어요 — id/versionId/buildId 가 유효한지, 동일 앱 소속인지 확인.',
@@ -45,12 +54,30 @@ function parseAppleErrorBody(body) {
         return null;
     }
 }
+/**
+ * 코드 → hint. 정확히 일치하는 게 없으면 점 표기를 뒤에서부터 잘라 상위 코드로 폴백한다.
+ * Apple 은 `ENTITY_ERROR.ATTRIBUTE.INVALID.TOO_LONG` 처럼 세분화된 코드를 계속 늘리는데,
+ * 그때마다 키를 추가하지 않아도 `...INVALID` 수준의 안내는 나가야 한다.
+ */
+function resolveHint(code) {
+    if (!code)
+        return undefined;
+    if (CODE_HINTS[code])
+        return CODE_HINTS[code];
+    const parts = code.split('.');
+    for (let i = parts.length - 1; i > 0; i -= 1) {
+        const hint = CODE_HINTS[parts.slice(0, i).join('.')];
+        if (hint)
+            return hint;
+    }
+    return undefined;
+}
 /** 단일 Apple error → 한 줄 사람용 표기. */
 function formatAppleError(e) {
     const code = e.code ?? 'UNKNOWN';
     const detail = e.detail ?? e.title ?? '(no detail)';
     const pointer = e.source?.pointer ?? e.source?.parameter;
-    const hint = e.code ? CODE_HINTS[e.code] : undefined;
+    const hint = resolveHint(e.code);
     const parts = [`[${code}] ${detail}`];
     if (pointer)
         parts.push(`@ ${pointer}`);

package/dist/appstore/tools.d.ts

@@ -166,6 +166,7 @@ export declare function submitVersionForReview(versionId: string): Promise<{
     versionId: string;
     reusedSubmission: boolean;
     itemAttached: boolean;
+    recoveredFromStaleSubmission: boolean;
     state: any;
 }>;
 export declare function addProductToReviewSubmission(args: {

package/dist/appstore/tools.js

@@ -599,38 +599,73 @@ export async function buildSubmitForReviewPreview(versionId) {
         whatsNewByLocale,
     };
 }
+async function createReviewSubmission(appId, platform) {
+    const created = await apiPost('/reviewSubmissions', {
+        data: {
+            type: 'reviewSubmissions',
+            attributes: { platform },
+            relationships: {
+                app: { data: { type: 'apps', id: appId } },
+            },
+        },
+    });
+    const submissionId = created?.data?.id;
+    if (!submissionId) {
+        throw new Error(`reviewSubmission 생성 응답에 id가 없어: ${JSON.stringify(created)}`);
+    }
+    return submissionId;
+}
+function isItemAddRejected(error) {
+    const cause = error?.cause;
+    if (cause?.status !== 409)
+        return false;
+    return (cause.parsedErrors ?? []).some((e) => (e.code ?? '').startsWith('STATE_ERROR'));
+}
 export async function submitVersionForReview(versionId) {
     const { appId, platform } = await getVersionAppAndPlatform(versionId);
-    // 1. CREATED 상태의 reviewSubmission이 있으면 재사용, 없으면 새로 생성
+    // 1. 열린 reviewSubmission이 있으면 재사용, 없으면 새로 생성
     let submissionId = await findOpenReviewSubmission(appId, platform);
-    const reusedSubmission = Boolean(submissionId);
+    let reusedSubmission = Boolean(submissionId);
+    // findOpenReviewSubmission 은 WAITING_FOR_REVIEW 도 잡아온다. 그 상태의 실제 진행도는
+    // API 의 state 필드보다 앞서 있을 수 있어(실측: 이미 심사 큐를 탄 옛 제출), 항목 추가
+    // 자체를 거부당하는 경우가 있다 — 아래 recoveredFromStaleSubmission 이 그 케이스다.
+    let recoveredFromStaleSubmission = false;
     if (!submissionId) {
-        const created = await apiPost('/reviewSubmissions', {
-            data: {
-                type: 'reviewSubmissions',
-                attributes: { platform },
-                relationships: {
-                    app: { data: { type: 'apps', id: appId } },
-                },
-            },
-        });
-        submissionId = created?.data?.id;
-        if (!submissionId) {
-            throw new Error(`reviewSubmission 생성 응답에 id가 없어: ${JSON.stringify(created)}`);
-        }
+        submissionId = await createReviewSubmission(appId, platform);
+        reusedSubmission = false;
     }
     // 2. 버전을 reviewSubmissionItems로 attach (이미 붙어있으면 skip)
-    const alreadyAttached = reusedSubmission ? await isVersionAttached(submissionId, versionId) : false;
+    let alreadyAttached = reusedSubmission ? await isVersionAttached(submissionId, versionId) : false;
     if (!alreadyAttached) {
-        await apiPost('/reviewSubmissionItems', {
-            data: {
-                type: 'reviewSubmissionItems',
-                relationships: {
-                    reviewSubmission: { data: { type: 'reviewSubmissions', id: submissionId } },
-                    appStoreVersion: { data: { type: 'appStoreVersions', id: versionId } },
+        try {
+            await apiPost('/reviewSubmissionItems', {
+                data: {
+                    type: 'reviewSubmissionItems',
+                    relationships: {
+                        reviewSubmission: { data: { type: 'reviewSubmissions', id: submissionId } },
+                        appStoreVersion: { data: { type: 'appStoreVersions', id: versionId } },
+                    },
                 },
-            },
-        });
+            });
+        }
+        catch (error) {
+            if (!reusedSubmission || !isItemAddRejected(error))
+                throw error;
+            // 재사용하려던 묶음이 실제로는 잠겨 있었다 — 새 묶음을 만들어 한 번만 재시도한다.
+            submissionId = await createReviewSubmission(appId, platform);
+            reusedSubmission = false;
+            recoveredFromStaleSubmission = true;
+            alreadyAttached = false;
+            await apiPost('/reviewSubmissionItems', {
+                data: {
+                    type: 'reviewSubmissionItems',
+                    relationships: {
+                        reviewSubmission: { data: { type: 'reviewSubmissions', id: submissionId } },
+                        appStoreVersion: { data: { type: 'appStoreVersions', id: versionId } },
+                    },
+                },
+            });
+        }
     }
     // 3. PATCH submitted=true → state: CREATED → WAITING_FOR_REVIEW
     const submitted = await apiPatch(`/reviewSubmissions/${submissionId}`, {
@@ -647,6 +682,7 @@ export async function submitVersionForReview(versionId) {
         versionId,
         reusedSubmission,
         itemAttached: !alreadyAttached,
+        recoveredFromStaleSubmission,
         state: submitted?.data?.attributes?.state ?? 'WAITING_FOR_REVIEW',
     };
 }

package/dist/registers/appstore.js

@@ -511,13 +511,19 @@ export function registerAppstoreTools(server) {
     });
     server.tool('appstore_update_product_localization', 'App Store IAP/구독 상품의 현지화(표시 이름·설명)를 로케일 단위로 upsert — 있으면 수정, 없으면 생성. ' +
         '현지화가 비면 상품이 MISSING_METADATA 에서 안 풀려 심사에 넣을 수 없다 (리뷰 노트·스크린샷과는 별개 리소스). ' +
-        'locale 은 App Store 표기(ko, en-US, ja, zh-Hant)를 쓴다. name 30자 / description 45자 제한.', {
+        'locale 은 App Store 표기(ko, en-US, ja, zh-Hant)를 쓴다. ' +
+        '길이 상한은 리소스마다 다르고 Apple 이 강제한다 — 구독은 실측으로 name 35 / description 55 다. ' +
+        '초과하면 Apple 이 "Max number of characters is (N)" 으로 실제 상한을 알려주므로 그 값에 맞춰 줄이면 된다. ' +
+        '⚠️ 심사 중인 상품은 현지화가 잠겨 UNMODIFIABLE 로 거부된다 — 결과를 기다리거나 철회 후 수정한다.', {
         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('상품 유형'),
         locale: z.string().describe('로케일 (예: ko, en-US, ja, zh-Hant)'),
-        name: z.string().max(30).optional().describe('표시 이름 (30자 이하). 새 로케일 생성 시 필수'),
-        description: z.string().max(45).optional().describe('설명 (45자 이하). 생략하면 기존 값 유지'),
+        // 실제 상한은 Apple 이 리소스별로 강제한다(구독 name 35 / description 55 실측).
+        // 여기서 좁게 잡으면 정상 문구를 클라이언트가 먼저 거부한다 — 실제로 45로 잡아
+        // 55자짜리 정상 설명을 막았다. 오타 수준만 걸러내는 넉넉한 상한만 둔다.
+        name: z.string().max(200).optional().describe('표시 이름. 새 로케일 생성 시 필수 (구독 실측 상한 35자)'),
+        description: z.string().max(500).optional().describe('설명. 생략하면 기존 값 유지 (구독 실측 상한 55자)'),
     }, async ({ appId, productId, productType, locale, name, description }) => {
         const creds = requireAppStoreCreds();
         const products = await listAppleProducts({

package/package.json

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