@yoonion/mimi-seed-mcp 0.19.0 → 0.19.2

package/README.md

@@ -79,9 +79,9 @@ export ANTHROPIC_API_KEY=sk-ant-...
 
 | 영역 | 도구 수 | 주요 도구 |
 |------|---------|-----------|
-| App Store Connect | 63 | `appstore_submit_for_review` / `appstore_upload_screenshot` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
+| App Store Connect | 64 | `appstore_submit_for_review` / `appstore_get_weekly_insight` / `appstore_update_product_review_note` / `appstore_upload_product_review_screenshot` |
 | Google Play | 39 | `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` |
+| Firebase | 21 | `firebase_create_project` / `firebase_get_remote_config_overview` / `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` |
 | Jenkins (크리덴셜 + 잡) | 10 | `jenkins_create_credential` / `jenkins_upload_keystore` / `jenkins_create_job` / `jenkins_update_job` |
@@ -94,7 +94,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
 | BigQuery | 5 | `bigquery_run_query` / `bigquery_list_datasets` / `bigquery_get_table_schema` |
 | Threads | 7 | `threads_post` / `threads_post_video` / `threads_post_carousel` / `threads_refresh_token` |
 | TikTok Business | 7 | `tiktok_business_plan_video_post` / `tiktok_business_publish_video` / `tiktok_business_get_publish_status` |
-| 점검 / 위험 | 4 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `screenshot_validate` / `release_status` |
+| 점검 / 위험 | 5 | `playstore_check_submission_risks` / `appstore_check_submission_risks` / `android_check_billing_compliance` / `screenshot_validate` / `release_status` |
 | Instagram | 4 | `instagram_post_image` / `instagram_post_carousel` / `instagram_save_config` |
 | Android 서명 | 3 | `android_signing_setup` / `android_generate_keystore` / `jenkins_upload_playstore_sa` |
 | 인증 | 4 | `mimi_seed_status` / `mimi_seed_auth_start` / `mimi_seed_auth_status` / `mimi_seed_remote_sync_credentials` |

package/assets/agent-guide.md

@@ -49,6 +49,7 @@ you can paste. Pick the row for the job; batching two rows in one `select:` call
 |------|--------------------|
 | First contact / "what's connected?" | `select:mimi_seed_status,mimi_seed_auth_status,mimi_seed_auth_start,mimi_seed_remote_sync_credentials` |
 | Release readiness (either store) | `select:release_status,playstore_check_submission_risks,appstore_check_submission_risks,screenshot_validate` |
+| Android Billing compliance | `select:android_check_billing_compliance,playstore_check_submission_risks` |
 | 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` |
@@ -67,10 +68,12 @@ you can paste. Pick the row for the job; batching two rows in one `select:` call
 | 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_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` |
+| Remote Config usage + experiments | `select:firebase_get_remote_config_overview,gcp_get_billing_info` |
 | 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` |
 | GCP billing (Blaze 여부 · 비용 범위 · 예산) | `select:gcp_get_billing_info,gcp_list_billing_projects,gcp_list_budgets,gcp_create_budget` |
 | Real revenue (스토어 정산 원장 — sandbox·테스터가 섞이지 않는 유일한 창구) | `select:appstore_get_sales_report,appstore_get_finance_report,playstore_list_financial_reports,playstore_get_financial_report` |
+| App Store weekly growth insight | `select:appstore_get_weekly_insight,appstore_get_sales_report` |
 | 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` |
@@ -176,8 +179,8 @@ per-domain inventory is [`docs/domain/tool-catalog.md`](domain/tool-catalog.md).
 | Domain | Representative tools |
 |--------|----------------------|
 | **Google Play** | `playstore_get_app` · `playstore_get_listing` · `playstore_update_listing` · `playstore_list_tracks` · `playstore_update_latest_release_notes` · `playstore_promote_release` · `playstore_submit_release` · `playstore_upload_image` · `playstore_replace_images` · `playstore_check_submission_risks` · `playstore_get_statistics` · `playstore_reply_review` · `playstore_register_service_account` |
-| **App Store Connect** | `appstore_list_apps` · `appstore_list_versions` · `appstore_create_version` · `appstore_update_whats_new` · `appstore_update_localization` · `appstore_list_builds` · `appstore_attach_latest_build` · `appstore_upload_screenshot` · `appstore_submit_for_review` · `appstore_cancel_review` · `appstore_list_beta_groups` · `appstore_reply_review` |
-| **Firebase** | `firebase_create_project` · `firebase_create_android_app` · `firebase_create_ios_app` · `firebase_get_android_config` · `firebase_enable_service` · `firebase_enable_common_services` · `firebase_list_*_apps` |
+| **App Store Connect** | `appstore_list_apps` · `appstore_list_versions` · `appstore_create_version` · `appstore_update_whats_new` · `appstore_update_localization` · `appstore_list_builds` · `appstore_attach_latest_build` · `appstore_upload_screenshot` · `appstore_submit_for_review` · `appstore_cancel_review` · `appstore_list_beta_groups` · `appstore_reply_review` · `appstore_get_weekly_insight` |
+| **Firebase** | `firebase_create_project` · `firebase_create_android_app` · `firebase_create_ios_app` · `firebase_get_android_config` · `firebase_enable_service` · `firebase_enable_common_services` · `firebase_get_remote_config_overview` · `firebase_list_*_apps` |
 | **AdMob** | `admob_create_app` · `admob_create_ad_unit` · `admob_list_ad_units` · `admob_get_today_earnings` · `admob_get_report` |
 | **CI/CD** | `ci_trigger_build` · `ci_get_build_status` · `ci_list_workflows` (**GitHub Actions / GitLab only**) |
 | **Jenkins** (credentials + jobs) | `jenkins_status` · `jenkins_save_config` · `jenkins_create_credential` · `jenkins_upload_keystore` · `jenkins_upload_playstore_sa` · `jenkins_create_job` · `jenkins_update_job` |
@@ -189,7 +192,7 @@ per-domain inventory is [`docs/domain/tool-catalog.md`](domain/tool-catalog.md).
 | **Android signing** | `android_signing_setup` · `android_generate_keystore` · `jenkins_upload_playstore_sa` |
 | **Facebook / Instagram / Threads** | `facebook_post_photo` · `instagram_post_carousel` · `threads_post` · `threads_post_video` · `threads_refresh_token` |
 | **TikTok Business** | `tiktok_business_auth_status` · `tiktok_business_plan_video_post` · `tiktok_business_publish_video` · `tiktok_business_get_publish_status` |
-| **Checks** | `playstore_check_submission_risks` · `appstore_check_submission_risks` · `screenshot_validate` · `release_status` |
+| **Checks** | `playstore_check_submission_risks` · `appstore_check_submission_risks` · `android_check_billing_compliance` · `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` |
 | **Video production** | `youtube_upload_video` · `youtube_get_video_status` · `youtube_update_video_privacy` · `video_save_plan` · `video_plan_from_story` · `video_research_youtube` · `video_search_stock_assets` · `video_synthesize_research` · `video_generate_image` · `video_build_timeline` · `video_render` · `video_job_status` · `video_validate` |
 

package/dist/appstore/analytics.d.ts

@@ -0,0 +1,140 @@
+import { type ReportRow } from './sales.js';
+interface JsonApiRow<T> {
+    id: string;
+    attributes?: T;
+}
+interface AnalyticsReportAttributes {
+    name?: string;
+    category?: 'APP_USAGE' | 'APP_STORE_ENGAGEMENT' | 'COMMERCE' | 'FRAMEWORK_USAGE' | 'PERFORMANCE';
+}
+export declare function selectWeeklyAnalyticsReports(reports: Array<JsonApiRow<AnalyticsReportAttributes>>): {
+    engagement: JsonApiRow<AnalyticsReportAttributes> | undefined;
+    downloads: JsonApiRow<AnalyticsReportAttributes> | undefined;
+    purchases: JsonApiRow<AnalyticsReportAttributes> | undefined;
+};
+interface WeeklyMetrics {
+    date: string;
+    impressions: number;
+    productPageViews: number;
+    downloads: number;
+    proceeds: number;
+    available: {
+        engagement: boolean;
+        downloads: boolean;
+        purchases: boolean;
+    };
+}
+export declare function selectLatestInstanceRows(batches: Array<{
+    processingDate: string;
+    rows: ReportRow[];
+}>): ReportRow[];
+export declare function buildWeeklyInsight(input: {
+    engagement: ReportRow[];
+    downloads: ReportRow[];
+    purchases: ReportRow[];
+}): {
+    status: string;
+    weeks: WeeklyMetrics[];
+    recommendation: string;
+    current?: undefined;
+    previous?: undefined;
+    changes?: undefined;
+    insight?: undefined;
+} | {
+    status: string;
+    current: WeeklyMetrics;
+    previous: WeeklyMetrics;
+    changes: {
+        impressions: number | null;
+        productPageViews: number | null;
+        downloads: number | null;
+        proceeds: number | null;
+        productPageRate: number | null;
+        downloadRate: number | null;
+        revenuePerDownload: number | null;
+    };
+    insight: {
+        area: string;
+        changePercent: number | null;
+        trend: string;
+        recommendation: string;
+    } | {
+        area: string;
+        changePercent: null;
+        recommendation: string;
+        trend?: undefined;
+    };
+    weeks?: undefined;
+    recommendation?: undefined;
+};
+export declare function getWeeklyInsight(input: {
+    appId: string;
+    createIfMissing?: boolean;
+    confirmCreate?: boolean;
+}): Promise<{
+    status: string;
+    message: string;
+    nextAction: string;
+    requestId?: undefined;
+} | {
+    status: string;
+    message: string;
+    nextAction?: undefined;
+    requestId?: undefined;
+} | {
+    status: string;
+    requestId: string;
+    message: string;
+    nextAction?: undefined;
+} | {
+    status: string;
+    weeks: WeeklyMetrics[];
+    recommendation: string;
+    current?: undefined;
+    previous?: undefined;
+    changes?: undefined;
+    insight?: undefined;
+    requestId: string;
+    reports: {
+        engagement: string | null;
+        downloads: string | null;
+        purchases: string | null;
+    };
+    message?: undefined;
+    nextAction?: undefined;
+} | {
+    status: string;
+    current: WeeklyMetrics;
+    previous: WeeklyMetrics;
+    changes: {
+        impressions: number | null;
+        productPageViews: number | null;
+        downloads: number | null;
+        proceeds: number | null;
+        productPageRate: number | null;
+        downloadRate: number | null;
+        revenuePerDownload: number | null;
+    };
+    insight: {
+        area: string;
+        changePercent: number | null;
+        trend: string;
+        recommendation: string;
+    } | {
+        area: string;
+        changePercent: null;
+        recommendation: string;
+        trend?: undefined;
+    };
+    weeks?: undefined;
+    recommendation?: undefined;
+    requestId: string;
+    reports: {
+        engagement: string | null;
+        downloads: string | null;
+        purchases: string | null;
+    };
+    message?: undefined;
+    nextAction?: undefined;
+}>;
+export {};

package/dist/appstore/analytics.js

@@ -0,0 +1,309 @@
+import crypto from 'node:crypto';
+import zlib from 'node:zlib';
+import { getReportsAuthHeaders } from './auth.js';
+import { V1_BASE, apiRequest, authHeadersOrThrow } from './http.js';
+import { fetchWithTimeout, HTTP_TRANSFER_TIMEOUT_MS } from '../lib/http.js';
+import { parseTsv } from './sales.js';
+export function selectWeeklyAnalyticsReports(reports) {
+    const standard = reports.filter((row) => !/Detailed/i.test(row.attributes?.name ?? ''));
+    const detailed = reports.filter((row) => /Detailed/i.test(row.attributes?.name ?? ''));
+    return {
+        engagement: standard.find((row) => /Discovery and Engagement/i.test(row.attributes?.name ?? '')),
+        // Apple only exposes weekly App Store Downloads as a detailed report. Selecting the
+        // standard report here silently yields no WEEKLY instances even when analytics is ready.
+        downloads: detailed.find((row) => /App Store Downloads/i.test(row.attributes?.name ?? ''))
+            ?? standard.find((row) => /App Store Downloads/i.test(row.attributes?.name ?? '')),
+        purchases: standard.find((row) => /App Store Purchases/i.test(row.attributes?.name ?? '')),
+    };
+}
+const MAX_SEGMENT_BYTES = 50 * 1024 * 1024;
+const MAX_DECOMPRESSED_BYTES = 100 * 1024 * 1024;
+const MAX_WEEKLY_INSTANCES = 8;
+async function reportHeaders() {
+    const auth = await getReportsAuthHeaders();
+    if (!auth)
+        throw new Error('App Store Connect reportsKey 또는 기본 API 키가 필요합니다.');
+    return auth.headers;
+}
+async function reportGet(path, params) {
+    const query = params ? `?${new URLSearchParams(params).toString()}` : '';
+    return apiRequest(V1_BASE, `${path}${query}`, await reportHeaders(), { method: 'GET' });
+}
+async function createOngoingRequest(appId) {
+    const response = await apiRequest(V1_BASE, '/analyticsReportRequests', await authHeadersOrThrow(), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            data: {
+                type: 'analyticsReportRequests',
+                attributes: { accessType: 'ONGOING' },
+                relationships: { app: { data: { type: 'apps', id: appId } } },
+            },
+        }),
+    });
+    return response.data;
+}
+async function downloadSegment(segment) {
+    const attributes = segment.attributes ?? {};
+    if (!attributes.url)
+        return [];
+    if ((attributes.sizeInBytes ?? 0) > MAX_SEGMENT_BYTES) {
+        throw new Error(`Analytics segment ${segment.id} is larger than the 50 MB safety limit.`);
+    }
+    const response = await fetchWithTimeout(attributes.url, {}, HTTP_TRANSFER_TIMEOUT_MS);
+    if (!response.ok)
+        throw new Error(`Analytics segment download failed (${response.status}).`);
+    const contentLength = Number(response.headers.get('content-length') ?? 0);
+    if (Number.isFinite(contentLength) && contentLength > MAX_SEGMENT_BYTES) {
+        throw new Error(`Analytics segment ${segment.id} response is larger than the 50 MB safety limit.`);
+    }
+    const bytes = Buffer.from(await response.arrayBuffer());
+    if (bytes.length > MAX_SEGMENT_BYTES) {
+        throw new Error(`Analytics segment ${segment.id} downloaded more than the 50 MB safety limit.`);
+    }
+    if (attributes.checksum) {
+        const actual = crypto.createHash('md5').update(bytes).digest('hex');
+        if (actual !== attributes.checksum.toLowerCase()) {
+            throw new Error(`Analytics segment checksum mismatch for ${segment.id}.`);
+        }
+    }
+    const isGzip = bytes[0] === 0x1f && bytes[1] === 0x8b;
+    const text = isGzip
+        ? zlib.gunzipSync(bytes, { maxOutputLength: MAX_DECOMPRESSED_BYTES }).toString('utf8')
+        : bytes.toString('utf8');
+    return parseTsv(text);
+}
+export function selectLatestInstanceRows(batches) {
+    const latestByDate = new Map();
+    for (const batch of batches) {
+        const rowsByDate = new Map();
+        for (const row of batch.rows) {
+            const date = dateOf(row);
+            if (!date)
+                continue;
+            const rows = rowsByDate.get(date) ?? [];
+            rows.push(row);
+            rowsByDate.set(date, rows);
+        }
+        for (const [date, rows] of rowsByDate) {
+            const current = latestByDate.get(date);
+            if (!current || batch.processingDate > current.processingDate) {
+                latestByDate.set(date, { processingDate: batch.processingDate, rows });
+            }
+        }
+    }
+    return [...latestByDate.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .flatMap(([, value]) => value.rows);
+}
+async function rowsForReport(reportId) {
+    const instances = await reportGet(`/analyticsReports/${reportId}/instances`, { 'filter[granularity]': 'WEEKLY', limit: '200' });
+    const latest = (instances.data ?? [])
+        .filter((row) => row.attributes?.processingDate)
+        .sort((a, b) => (b.attributes?.processingDate ?? '').localeCompare(a.attributes?.processingDate ?? ''))
+        .slice(0, MAX_WEEKLY_INSTANCES);
+    const batches = [];
+    for (const instance of latest) {
+        const segments = await reportGet(`/analyticsReportInstances/${instance.id}/segments`, { limit: '200' });
+        const rows = [];
+        for (const segment of segments.data ?? [])
+            rows.push(...await downloadSegment(segment));
+        batches.push({ processingDate: instance.attributes.processingDate, rows });
+    }
+    return selectLatestInstanceRows(batches);
+}
+function numberFrom(row, names) {
+    for (const name of names) {
+        const raw = row[name];
+        if (raw === undefined || raw === '')
+            continue;
+        const value = Number.parseFloat(raw.replace(/,/g, ''));
+        if (Number.isFinite(value))
+            return value;
+    }
+    return 0;
+}
+function dateOf(row) {
+    return row.Date || row['Start Date'] || row['Week Start Date'] || null;
+}
+function ensureWeek(map, date) {
+    let week = map.get(date);
+    if (!week) {
+        week = {
+            date,
+            impressions: 0,
+            productPageViews: 0,
+            downloads: 0,
+            proceeds: 0,
+            available: { engagement: false, downloads: false, purchases: false },
+        };
+        map.set(date, week);
+    }
+    return week;
+}
+function percentageChange(current, previous) {
+    if (previous <= 0)
+        return null;
+    return ((current - previous) / previous) * 100;
+}
+export function buildWeeklyInsight(input) {
+    const weeks = new Map();
+    for (const row of input.engagement) {
+        const date = dateOf(row);
+        if (!date)
+            continue;
+        const week = ensureWeek(weeks, date);
+        week.available.engagement = true;
+        const event = (row.Event ?? '').toLowerCase();
+        const pageType = (row['Page Type'] ?? '').toLowerCase();
+        const count = numberFrom(row, ['Unique Counts', 'Counts', 'Count']);
+        if (event === 'impression')
+            week.impressions += count;
+        if (event === 'page view' && (pageType === 'product page' || !pageType))
+            week.productPageViews += count;
+    }
+    for (const row of input.downloads) {
+        const date = dateOf(row);
+        if (!date)
+            continue;
+        const week = ensureWeek(weeks, date);
+        week.available.downloads = true;
+        week.downloads += numberFrom(row, ['Counts', 'Count', 'Downloads', 'Units']);
+    }
+    for (const row of input.purchases) {
+        const date = dateOf(row);
+        if (!date)
+            continue;
+        const week = ensureWeek(weeks, date);
+        week.available.purchases = true;
+        week.proceeds += numberFrom(row, [
+            'Proceeds in USD',
+            'Developer Proceeds',
+            'Proceeds',
+            'Estimated Proceeds',
+            'Sales',
+        ]);
+    }
+    const ordered = [...weeks.values()]
+        .filter((week) => week.available.engagement && week.available.downloads)
+        .sort((a, b) => a.date.localeCompare(b.date));
+    if (ordered.length < 2) {
+        return {
+            status: 'collecting',
+            weeks: ordered,
+            recommendation: 'Analytics 주간 데이터가 두 기간 이상 쌓인 뒤 다시 실행하세요.',
+        };
+    }
+    const previous = ordered.at(-2);
+    const current = ordered.at(-1);
+    const previousPageRate = previous.impressions > 0 ? previous.productPageViews / previous.impressions : 0;
+    const currentPageRate = current.impressions > 0 ? current.productPageViews / current.impressions : 0;
+    const previousDownloadRate = previous.productPageViews > 0 ? previous.downloads / previous.productPageViews : 0;
+    const currentDownloadRate = current.productPageViews > 0 ? current.downloads / current.productPageViews : 0;
+    const previousRevenuePerDownload = previous.downloads > 0 ? previous.proceeds / previous.downloads : 0;
+    const currentRevenuePerDownload = current.downloads > 0 ? current.proceeds / current.downloads : 0;
+    const candidates = [
+        {
+            area: 'product_page',
+            changePercent: percentageChange(currentPageRate, previousPageRate),
+            declineRecommendation: '제품 페이지 진입률이 하락했습니다. 아이콘·스크린샷 첫 장·부제 중 하나를 바꿔 Product Page Optimization 테스트를 시작하세요.',
+            healthyRecommendation: '핵심 전환 지표의 주간 하락은 없습니다. 가장 개선 폭이 작은 제품 페이지 진입률을 다음 실험 대상으로 삼으세요.',
+        },
+        {
+            area: 'acquisition',
+            changePercent: percentageChange(currentDownloadRate, previousDownloadRate),
+            declineRecommendation: '제품 페이지 조회 대비 다운로드 전환이 하락했습니다. 유입 소스별 전환을 나누고 가장 큰 하락 소스에 맞춘 커스텀 제품 페이지를 만드세요.',
+            healthyRecommendation: '핵심 전환 지표의 주간 하락은 없습니다. 가장 개선 폭이 작은 다운로드 전환을 유입 소스별로 나눠 다음 실험을 정하세요.',
+        },
+        {
+            area: 'monetization',
+            changePercent: previous.available.purchases && current.available.purchases
+                ? percentageChange(currentRevenuePerDownload, previousRevenuePerDownload)
+                : null,
+            declineRecommendation: '다운로드당 수익이 하락했습니다. 구매 리포트에서 상품별 하락을 확인하고 가격·오퍼·구독 전환 중 한 가지를 실험하세요.',
+            healthyRecommendation: '핵심 전환 지표의 주간 하락은 없습니다. 가장 개선 폭이 작은 다운로드당 수익을 상품별로 나눠 다음 가격·오퍼 실험을 정하세요.',
+        },
+    ].filter((candidate) => candidate.changePercent !== null)
+        .sort((a, b) => (a.changePercent ?? 0) - (b.changePercent ?? 0));
+    const selected = candidates[0];
+    return {
+        status: 'ready',
+        current,
+        previous,
+        changes: {
+            impressions: percentageChange(current.impressions, previous.impressions),
+            productPageViews: percentageChange(current.productPageViews, previous.productPageViews),
+            downloads: percentageChange(current.downloads, previous.downloads),
+            proceeds: previous.available.purchases && current.available.purchases
+                ? percentageChange(current.proceeds, previous.proceeds)
+                : null,
+            productPageRate: percentageChange(currentPageRate, previousPageRate),
+            downloadRate: percentageChange(currentDownloadRate, previousDownloadRate),
+            revenuePerDownload: previous.available.purchases && current.available.purchases
+                ? percentageChange(currentRevenuePerDownload, previousRevenuePerDownload)
+                : null,
+        },
+        insight: selected
+            ? {
+                area: selected.area,
+                changePercent: selected.changePercent,
+                trend: (selected.changePercent ?? 0) < 0 ? 'declining' : 'stable_or_improving',
+                recommendation: (selected.changePercent ?? 0) < 0
+                    ? selected.declineRecommendation
+                    : selected.healthyRecommendation,
+            }
+            : {
+                area: 'data_quality',
+                changePercent: null,
+                recommendation: '비교 가능한 분모 데이터가 부족합니다. Engagement·주간 Downloads Detailed·Purchases 리포트가 생성되는지 확인하세요.',
+            },
+    };
+}
+export async function getWeeklyInsight(input) {
+    const requests = await reportGet(`/apps/${input.appId}/analyticsReportRequests`, { 'filter[accessType]': 'ONGOING', limit: '10' });
+    const active = (requests.data ?? []).find((row) => !row.attributes?.stoppedDueToInactivity);
+    if (!active) {
+        if (!input.createIfMissing) {
+            return {
+                status: 'setup_required',
+                message: 'ONGOING Analytics report request가 없습니다.',
+                nextAction: 'createIfMissing=true와 confirmCreate=true로 다시 호출하세요.',
+            };
+        }
+        if (!input.confirmCreate) {
+            return {
+                status: 'confirmation_required',
+                message: 'Analytics report request 생성은 App Store Connect에 지속 리소스를 만듭니다.',
+            };
+        }
+        const created = await createOngoingRequest(input.appId);
+        return {
+            status: 'provisioning',
+            requestId: created.id,
+            message: 'ONGOING Analytics report request를 만들었습니다. 최초 데이터는 보통 24~48시간 뒤 생성됩니다.',
+        };
+    }
+    const reports = await reportGet(`/analyticsReportRequests/${active.id}/reports`, { limit: '200' });
+    const { engagement, downloads, purchases } = selectWeeklyAnalyticsReports(reports.data ?? []);
+    if (!engagement && !downloads && !purchases) {
+        return {
+            status: 'collecting',
+            requestId: active.id,
+            message: '요청은 활성 상태지만 주간 Engagement·Downloads·Purchases 리포트가 아직 생성되지 않았습니다.',
+        };
+    }
+    const [engagementRows, downloadRows, purchaseRows] = await Promise.all([
+        engagement ? rowsForReport(engagement.id) : [],
+        downloads ? rowsForReport(downloads.id) : [],
+        purchases ? rowsForReport(purchases.id) : [],
+    ]);
+    return {
+        requestId: active.id,
+        reports: {
+            engagement: engagement?.attributes?.name ?? null,
+            downloads: downloads?.attributes?.name ?? null,
+            purchases: purchases?.attributes?.name ?? null,
+        },
+        ...buildWeeklyInsight({ engagement: engagementRows, downloads: downloadRows, purchases: purchaseRows }),
+    };
+}

package/dist/checks/billing.d.ts

@@ -0,0 +1,36 @@
+export type BillingComplianceStatus = 'pass' | 'warning' | 'blocker' | 'unresolved' | 'not_used';
+export interface BillingEvidence {
+    file: string;
+    module: string;
+    version?: string;
+    expression?: string;
+    source: 'literal' | 'variable' | 'version_catalog' | 'unresolved';
+}
+export interface BillingComplianceResult {
+    projectPath: string;
+    checkedAt: string;
+    status: BillingComplianceStatus;
+    detectedVersions: string[];
+    evidence: BillingEvidence[];
+    policy: {
+        minimumSupportedMajor: number | null;
+        submissionDeadline: string;
+        extensionDeadline: string;
+        latestKnownMajor: number;
+        scheduleCurrent: boolean;
+        knownSchedule: Array<{
+            major: number;
+            submissionDeadline: string;
+            extensionDeadline: string;
+        }>;
+        sourceUrl: string;
+    };
+    summary: string;
+    actions: string[];
+    upgrade: {
+        installCommand: string;
+        prompt: string;
+        automaticExecution: false;
+    };
+}
+export declare function checkBillingCompliance(projectPath: string, now?: Date): Promise<BillingComplianceResult>;