@yoonion/mimi-seed-mcp 0.18.1 → 0.19.1

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,12 +94,12 @@ 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` |
 | AI (Claude) | 2 | `generate_release_notes_from_commits` / `generate_review_reply` |
-| 영상 제작·YouTube | 14 | `youtube_upload_video` / `youtube_get_video_status` / `youtube_update_video_privacy` / `video_plan_from_story` / `video_render` |
+| 영상 제작·YouTube | 15 | `youtube_upload_video` / `youtube_get_video_status` / `youtube_update_video_privacy` / `video_plan_from_story` / `video_render` |
 
 > 인앱 결제(IAP·구독) 도구는 위 Play Store·App Store 카운트에 포함됩니다 — `appstore_create_inapp_purchase` · `appstore_update_product_review_note` · `appstore_upload_product_review_screenshot` 등.
 > 전체 카탈로그(항상 최신): [`docs/domain/tool-catalog.md`](../../docs/domain/tool-catalog.md)

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` |
@@ -80,7 +83,7 @@ you can paste. Pick the row for the job; batching two rows in one `select:` call
 | CI (GitHub/GitLab) | `select:ci_save_config,ci_list_workflows,ci_trigger_build,ci_get_build_status,ci_list_recent_builds,ci_cancel_build` |
 | Android signing / keystore | `select:android_signing_setup,android_generate_keystore,jenkins_upload_keystore,jenkins_upload_playstore_sa` |
 | Service account end-to-end | `select:iam_list_service_accounts,iam_create_service_account,iam_list_keys,iam_create_key,iam_add_iam_policy_binding,setup_playstore_connection,playstore_register_service_account,playstore_verify_service_account,playstore_list_service_accounts,playstore_delete_service_account` |
-| Story → researched video | `select:video_plan_from_story,video_research_youtube,video_search_stock_assets,video_synthesize_research,video_download_stock_assets,video_generate_image,video_add_local_asset,video_build_timeline,video_render,video_job_status,video_validate` |
+| Story → researched video | `select:video_save_plan,video_plan_from_story,video_research_youtube,video_search_stock_assets,video_synthesize_research,video_download_stock_assets,video_generate_image,video_add_local_asset,video_build_timeline,video_render,video_job_status,video_validate` |
 | YouTube upload / publish | `select:youtube_upload_video,youtube_get_video_status,youtube_update_video_privacy,mimi_seed_auth_start` |
 
 ---
@@ -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,9 +192,9 @@ 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_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` |
+| **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` |
 
 ---
 
@@ -218,15 +221,16 @@ For visual production, use the bundled `video-create-publish` skill. It requires
 aspect-ratio-specific human-safe crops, video-native motion, an original-resolution frame review, and a saved
 contact sheet; codec validation alone is not a quality pass.
 
-1. `video_plan_from_story` — create the project and scene plan.
+1. `video_save_plan` — save an agent-authored storyboard (no API key; free-path default). `video_plan_from_story` is the metered alternative when `ANTHROPIC_API_KEY` is configured.
 2. `video_research_youtube` — collect reference-only metadata; never treat a result as a render asset.
 3. `video_search_stock_assets` — find licensed Pexels candidates.
 4. `video_synthesize_research` — combine metadata with any direct human/agent observations. Treat its output as
    metadata-bounded guidance, not proof that the source videos were watched.
 5. Preview then confirm `video_download_stock_assets`; use `video_generate_image(confirm=false)` before any paid
-   generation and call it again with `confirm=true` only after approval. User-owned media goes through
-   `video_add_local_asset` with its ownership/license basis.
-6. `video_build_timeline` — provenance-gated scene assignment.
+   generation and call it again with `confirm=true` only after approval. On the free path, generate scene images
+   with the local `codex` CLI (ChatGPT subscription) instead and register them — like all user-owned media —
+   through `video_add_local_asset` with the ownership/license basis.
+6. `video_build_timeline` — provenance-gated scene assignment. Captions burn in the shorts style (bold outline, `**keyword**` highlight); tune with `captionStyle`.
 7. Preview then confirm `video_render`; poll `video_job_status`, then run `video_validate` on the completed MP4.
 
 > **Mimi Seed does not compile app binaries.** It manages metadata, store releases, and

package/dist/appstore/analytics.d.ts

@@ -0,0 +1,106 @@
+import { type ReportRow } from './sales.js';
+interface WeeklyMetrics {
+    date: string;
+    impressions: number;
+    productPageViews: number;
+    downloads: number;
+    proceeds: number;
+}
+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;
+        recommendation: string;
+    };
+    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;
+        recommendation: string;
+    };
+    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,242 @@
+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';
+const MAX_SEGMENT_BYTES = 50 * 1024 * 1024;
+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 bytes = Buffer.from(await response.arrayBuffer());
+    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}.`);
+        }
+    }
+    let text;
+    try {
+        text = zlib.gunzipSync(bytes).toString('utf8');
+    }
+    catch {
+        text = bytes.toString('utf8');
+    }
+    return parseTsv(text);
+}
+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, 2);
+    const allRows = [];
+    for (const instance of latest) {
+        const segments = await reportGet(`/analyticsReportInstances/${instance.id}/segments`, { limit: '200' });
+        for (const segment of segments.data ?? [])
+            allRows.push(...await downloadSegment(segment));
+    }
+    return allRows;
+}
+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 };
+        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);
+        const event = (row.Event ?? '').toLowerCase();
+        const pageType = (row['Page Type'] ?? '').toLowerCase();
+        const count = numberFrom(row, ['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;
+        ensureWeek(weeks, date).downloads += numberFrom(row, ['Counts', 'Count', 'Downloads', 'Units']);
+    }
+    for (const row of input.purchases) {
+        const date = dateOf(row);
+        if (!date)
+            continue;
+        ensureWeek(weeks, date).proceeds += numberFrom(row, [
+            'Developer Proceeds',
+            'Proceeds',
+            'Estimated Proceeds',
+            'Sales',
+        ]);
+    }
+    const ordered = [...weeks.values()].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),
+            recommendation: '제품 페이지 진입률이 하락했습니다. 아이콘·스크린샷 첫 장·부제 중 하나를 바꿔 Product Page Optimization 테스트를 시작하세요.',
+        },
+        {
+            area: 'acquisition',
+            changePercent: percentageChange(currentDownloadRate, previousDownloadRate),
+            recommendation: '제품 페이지 조회 대비 다운로드 전환이 하락했습니다. 유입 소스별 전환을 나누고 가장 큰 하락 소스에 맞춘 커스텀 제품 페이지를 만드세요.',
+        },
+        {
+            area: 'monetization',
+            changePercent: percentageChange(currentRevenuePerDownload, previousRevenuePerDownload),
+            recommendation: '다운로드당 수익이 하락했습니다. 구매 리포트에서 상품별 하락을 확인하고 가격·오퍼·구독 전환 중 한 가지를 실험하세요.',
+        },
+    ].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: percentageChange(current.proceeds, previous.proceeds),
+            productPageRate: percentageChange(currentPageRate, previousPageRate),
+            downloadRate: percentageChange(currentDownloadRate, previousDownloadRate),
+            revenuePerDownload: percentageChange(currentRevenuePerDownload, previousRevenuePerDownload),
+        },
+        insight: selected
+            ? {
+                area: selected.area,
+                changePercent: selected.changePercent,
+                recommendation: selected.recommendation,
+            }
+            : {
+                area: 'data_quality',
+                changePercent: null,
+                recommendation: '비교 가능한 분모 데이터가 부족합니다. 표준 Engagement·Downloads·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 standard = (reports.data ?? []).filter((row) => !/Detailed/i.test(row.attributes?.name ?? ''));
+    const engagement = standard.find((row) => /Discovery and Engagement/i.test(row.attributes?.name ?? ''));
+    const downloads = standard.find((row) => /App Store Downloads/i.test(row.attributes?.name ?? ''));
+    const purchases = standard.find((row) => /App Store Purchases/i.test(row.attributes?.name ?? ''));
+    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,30 @@
+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;
+        submissionDeadline: string;
+        extensionDeadline: string;
+        latestKnownMajor: number;
+        sourceUrl: string;
+    };
+    summary: string;
+    actions: string[];
+    upgrade: {
+        installCommand: string;
+        prompt: string;
+        automaticExecution: false;
+    };
+}
+export declare function checkBillingCompliance(projectPath: string, now?: Date): Promise<BillingComplianceResult>;