@yoonion/mimi-seed-mcp 0.19.0 → 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,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,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>;

package/dist/checks/billing.js

@@ -0,0 +1,225 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const BILLING_MODULE = /com\.android\.billingclient:billing(?:-ktx)?/;
+const LITERAL_DEPENDENCY = /com\.android\.billingclient:billing(?:-ktx)?:([0-9]+(?:\.[0-9A-Za-z_-]+){0,3})/g;
+const VARIABLE_DEPENDENCY = /com\.android\.billingclient:billing(?:-ktx)?:\$\{?([A-Za-z_][A-Za-z0-9_.-]*)\}?/g;
+const VERSION_ASSIGNMENT = /(?:^|\s)([A-Za-z_][A-Za-z0-9_.-]*)\s*(?:=|:)\s*["']([0-9]+(?:\.[0-9A-Za-z_-]+){0,3})["']/gm;
+const SKIP_DIRS = new Set([
+    '.git',
+    '.gradle',
+    '.idea',
+    'build',
+    'dist',
+    'node_modules',
+    'Pods',
+    'DerivedData',
+]);
+async function walk(root, maxDepth = 7) {
+    const result = [];
+    async function visit(dir, depth) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name))
+                    await visit(path.join(dir, entry.name), depth + 1);
+            }
+            else if (entry.isFile()
+                && (entry.name === 'build.gradle'
+                    || entry.name === 'build.gradle.kts'
+                    || entry.name === 'libs.versions.toml')) {
+                result.push(path.join(dir, entry.name));
+            }
+        }
+    }
+    await visit(root, 0);
+    return result;
+}
+function parseCatalog(text) {
+    const versions = new Map();
+    const libraries = new Map();
+    let section = '';
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.replace(/\s+#.*$/, '').trim();
+        if (!line)
+            continue;
+        const sectionMatch = line.match(/^\[([^\]]+)]$/);
+        if (sectionMatch) {
+            section = sectionMatch[1];
+            continue;
+        }
+        if (section === 'versions') {
+            const match = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*["']([^"']+)["']/);
+            if (match)
+                versions.set(match[1], match[2]);
+            continue;
+        }
+        if (section !== 'libraries')
+            continue;
+        const match = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*\{(.+)}\s*$/);
+        if (!match)
+            continue;
+        const body = match[2];
+        const module = body.match(/module\s*=\s*["']([^"']+)["']/)?.[1];
+        const version = body.match(/(?:^|,)\s*version\s*=\s*["']([^"']+)["']/)?.[1];
+        const versionRef = body.match(/version\.ref\s*=\s*["']([^"']+)["']/)?.[1];
+        libraries.set(match[1], { module, version, versionRef });
+    }
+    return { versions, libraries };
+}
+function collectVariables(text) {
+    const result = new Map();
+    for (const match of text.matchAll(VERSION_ASSIGNMENT))
+        result.set(match[1], match[2]);
+    return result;
+}
+function normalizeAlias(alias) {
+    return alias.replace(/^libs\./, '').replace(/\./g, '-');
+}
+function majorOf(version) {
+    const major = Number.parseInt(version.split('.')[0], 10);
+    return Number.isFinite(major) ? major : null;
+}
+function policyAt(now) {
+    const currentYear = now.getUTCFullYear();
+    const deadlineThisYear = new Date(Date.UTC(currentYear, 7, 31, 23, 59, 59));
+    const minimumSupportedMajor = now > deadlineThisYear ? currentYear - 2018 : currentYear - 2019;
+    const unsupportedMajor = minimumSupportedMajor - 1;
+    return {
+        minimumSupportedMajor,
+        submissionDeadline: `${unsupportedMajor + 2019}-08-31`,
+        extensionDeadline: `${unsupportedMajor + 2019}-11-01`,
+        latestKnownMajor: Math.max(9, minimumSupportedMajor + 1),
+        sourceUrl: 'https://developer.android.com/google/play/billing/deprecation-faq',
+    };
+}
+export async function checkBillingCompliance(projectPath, now = new Date()) {
+    const root = path.resolve(projectPath);
+    const files = await walk(root);
+    const texts = new Map();
+    for (const file of files)
+        texts.set(file, await fs.readFile(file, 'utf8'));
+    const catalogFile = files.find((file) => path.basename(file) === 'libs.versions.toml');
+    const catalog = catalogFile ? parseCatalog(texts.get(catalogFile) ?? '') : { versions: new Map(), libraries: new Map() };
+    const allVariables = new Map();
+    for (const [file, text] of texts) {
+        if (path.basename(file) === 'libs.versions.toml')
+            continue;
+        for (const [key, value] of collectVariables(text))
+            allVariables.set(key, value);
+    }
+    const evidence = [];
+    for (const [file, text] of texts) {
+        const relative = path.relative(root, file).replace(/\\/g, '/');
+        if (path.basename(file) === 'libs.versions.toml') {
+            for (const [alias, lib] of catalog.libraries) {
+                if (!lib.module || !BILLING_MODULE.test(lib.module))
+                    continue;
+                const version = lib.version ?? (lib.versionRef ? catalog.versions.get(lib.versionRef) : undefined);
+                evidence.push({
+                    file: relative,
+                    module: lib.module,
+                    version,
+                    expression: `libs.${alias.replace(/-/g, '.')}`,
+                    source: version ? 'version_catalog' : 'unresolved',
+                });
+            }
+            continue;
+        }
+        for (const match of text.matchAll(LITERAL_DEPENDENCY)) {
+            evidence.push({
+                file: relative,
+                module: match[0].slice(0, match[0].lastIndexOf(':')),
+                version: match[1],
+                source: 'literal',
+            });
+        }
+        for (const match of text.matchAll(VARIABLE_DEPENDENCY)) {
+            const version = allVariables.get(match[1]);
+            evidence.push({
+                file: relative,
+                module: match[0].slice(0, match[0].lastIndexOf(':')),
+                version,
+                expression: match[1],
+                source: version ? 'variable' : 'unresolved',
+            });
+        }
+        for (const aliasMatch of text.matchAll(/\blibs\.([A-Za-z0-9_.-]+)/g)) {
+            const alias = normalizeAlias(aliasMatch[1]);
+            const lib = catalog.libraries.get(alias) ?? catalog.libraries.get(aliasMatch[1]);
+            if (!lib?.module || !BILLING_MODULE.test(lib.module))
+                continue;
+            const version = lib.version ?? (lib.versionRef ? catalog.versions.get(lib.versionRef) : undefined);
+            if (!evidence.some((row) => row.file === relative && row.expression === aliasMatch[0])) {
+                evidence.push({
+                    file: relative,
+                    module: lib.module,
+                    version,
+                    expression: aliasMatch[0],
+                    source: version ? 'version_catalog' : 'unresolved',
+                });
+            }
+        }
+        if (BILLING_MODULE.test(text) && !evidence.some((row) => row.file === relative)) {
+            evidence.push({
+                file: relative,
+                module: 'com.android.billingclient:billing',
+                expression: 'Billing dependency found but version could not be resolved',
+                source: 'unresolved',
+            });
+        }
+    }
+    const detectedVersions = [...new Set(evidence.flatMap((row) => row.version ? [row.version] : []))].sort();
+    const policy = policyAt(now);
+    const majors = detectedVersions.map(majorOf).filter((major) => major !== null);
+    const unresolved = evidence.some((row) => !row.version);
+    let status;
+    let summary;
+    const actions = [];
+    if (evidence.length === 0) {
+        status = 'not_used';
+        summary = 'Google Play Billing dependency was not found in the scanned Gradle project.';
+    }
+    else if (majors.some((major) => major < policy.minimumSupportedMajor)) {
+        status = 'blocker';
+        summary = `Billing Library ${detectedVersions.join(', ')} is below the submission minimum major ${policy.minimumSupportedMajor}.`;
+        actions.push(`Upgrade to a supported Billing Library before submitting a new app or update.`);
+        actions.push(`If Google granted an extension, verify it in Play Console; the listed extension deadline is ${policy.extensionDeadline}.`);
+    }
+    else if (unresolved || majors.length === 0) {
+        status = 'unresolved';
+        summary = 'A Billing dependency was found, but at least one version expression could not be resolved statically.';
+        actions.push('Resolve the reported Gradle variable or version catalog alias and run the check again.');
+    }
+    else if (majors.some((major) => major === policy.minimumSupportedMajor)) {
+        status = 'warning';
+        summary = `Billing Library ${detectedVersions.join(', ')} is currently supported but is the next major scheduled for deprecation.`;
+        actions.push(`Plan an upgrade before ${policy.minimumSupportedMajor + 2019}-08-31.`);
+    }
+    else {
+        status = 'pass';
+        summary = `Billing Library ${detectedVersions.join(', ')} satisfies the current submission policy.`;
+    }
+    return {
+        projectPath: root,
+        checkedAt: now.toISOString(),
+        status,
+        detectedVersions,
+        evidence,
+        policy,
+        summary,
+        actions,
+        upgrade: {
+            installCommand: 'android skills add play-billing-library-version-upgrade',
+            prompt: 'Help me upgrade my Play Billing Library implementation.',
+            automaticExecution: false,
+        },
+    };
+}

package/dist/checks/risks.d.ts

@@ -8,5 +8,8 @@ export interface SubmissionRisk {
     fixUrl?: string;
 }
 export declare function checkPlayStoreRisks(auth: OAuth2Client, packageName: string, language?: string): Promise<SubmissionRisk[]>;
-export declare function checkAppStoreRisks(appId: string): Promise<SubmissionRisk[]>;
+export declare function checkAppStoreRisks(appId: string, expected?: {
+    socialMedia?: boolean;
+    socialMediaAgeRestricted?: boolean;
+}): Promise<SubmissionRisk[]>;
 export declare function formatRisks(risks: SubmissionRisk[], platform: string): string;

package/dist/checks/risks.js

@@ -72,7 +72,7 @@ async function safeGet(call, risks, code, title) {
     }
 }
 const APP_INFO_LIVE_STATE = 'READY_FOR_DISTRIBUTION';
-export async function checkAppStoreRisks(appId) {
+export async function checkAppStoreRisks(appId, expected = {}) {
     const risks = [];
     const versions = await safeGet(() => apiGet(`/apps/${appId}/appStoreVersions`, {
         'filter[appStoreState]': APPSTORE_EDITABLE_STATES,
@@ -140,10 +140,15 @@ export async function checkAppStoreRisks(appId) {
         const stateOf = (i) => i.attributes?.state ?? i.attributes?.appStoreState ?? '';
         const editable = infos.find((i) => stateOf(i) !== APP_INFO_LIVE_STATE) ?? infos[0];
         if (editable) {
-            const localizations = await safeGet(() => apiGet(`/appInfos/${editable.id}/appInfoLocalizations`, {
-                'fields[appInfoLocalizations]': 'locale,privacyPolicyUrl,privacyPolicyText',
-                'limit': '200',
-            }), risks, 'PRIVACY', '개인정보 로컬라이제이션');
+            const [localizations, ageRating] = await Promise.all([
+                safeGet(() => apiGet(`/appInfos/${editable.id}/appInfoLocalizations`, {
+                    'fields[appInfoLocalizations]': 'locale,privacyPolicyUrl,privacyPolicyText',
+                    'limit': '200',
+                }), risks, 'PRIVACY', '개인정보 로컬라이제이션'),
+                safeGet(() => apiGet(`/appInfos/${editable.id}/ageRatingDeclaration`, {
+                    'fields[ageRatingDeclarations]': 'userGeneratedContent,socialMedia,socialMediaAgeRestricted',
+                }), risks, 'AGE_RATING_SOCIAL', '연령등급 소셜 미디어 응답'),
+            ]);
             if (localizations) {
                 const locs = (localizations.data ?? []);
                 const hasPrivacy = locs.some((l) => l.attributes?.privacyPolicyUrl || l.attributes?.privacyPolicyText);
@@ -151,6 +156,51 @@ export async function checkAppStoreRisks(appId) {
                     risks.push({ level: 'blocker', code: 'NO_PRIVACY', title: '개인정보처리방침 URL 없음', detail: 'App Store 가이드라인 5.1.1 — 필수 항목입니다. 모든 로컬라이제이션에서 privacyPolicyUrl 또는 privacyPolicyText 중 하나를 입력하세요.' });
                 }
             }
+            if (ageRating) {
+                const declaration = ageRating.data?.attributes ?? {};
+                if (declaration.socialMedia === undefined || declaration.socialMediaAgeRestricted === undefined) {
+                    risks.push({
+                        level: 'blocker',
+                        code: 'SOCIAL_MEDIA_ANSWERS_MISSING',
+                        title: '연령등급 소셜 미디어 질문 미응답',
+                        detail: '2026년 9월부터 신규 앱·업데이트 제출에 socialMedia와 socialMediaAgeRestricted 응답이 필요합니다.',
+                        fixUrl: 'https://developer.apple.com/news/?id=tlur8uvi',
+                    });
+                }
+                if (declaration.socialMediaAgeRestricted === true && declaration.socialMedia !== true) {
+                    risks.push({
+                        level: 'blocker',
+                        code: 'SOCIAL_MEDIA_AGE_RESTRICTION_MISMATCH',
+                        title: '13세 미만 제한 응답 불일치',
+                        detail: 'socialMediaAgeRestricted=true는 socialMedia=true인 앱에서만 의미가 있습니다.',
+                    });
+                }
+                if (expected.socialMedia !== undefined && declaration.socialMedia !== expected.socialMedia) {
+                    risks.push({
+                        level: 'blocker',
+                        code: 'SOCIAL_MEDIA_CAPABILITY_MISMATCH',
+                        title: '앱 기능과 App Store 소셜 미디어 응답 불일치',
+                        detail: `프로젝트 기능 선언은 socialMedia=${expected.socialMedia}이지만 App Store Connect는 ${String(declaration.socialMedia)}입니다.`,
+                    });
+                }
+                if (expected.socialMediaAgeRestricted !== undefined
+                    && declaration.socialMediaAgeRestricted !== expected.socialMediaAgeRestricted) {
+                    risks.push({
+                        level: 'blocker',
+                        code: 'SOCIAL_MEDIA_AGE_GATE_MISMATCH',
+                        title: '13세 미만 기능 제한과 App Store 응답 불일치',
+                        detail: `프로젝트 기능 선언은 socialMediaAgeRestricted=${expected.socialMediaAgeRestricted}이지만 App Store Connect는 ${String(declaration.socialMediaAgeRestricted)}입니다.`,
+                    });
+                }
+                if (declaration.userGeneratedContent && declaration.socialMedia === false) {
+                    risks.push({
+                        level: 'warning',
+                        code: 'UGC_WITHOUT_SOCIAL_MEDIA',
+                        title: 'UGC는 있으나 소셜 미디어 기능은 없음으로 응답',
+                        detail: '피드·좋아요·댓글·공유·발견 기능이 있다면 socialMedia 응답을 true로 바꿔야 합니다.',
+                    });
+                }
+            }
         }
     }
     return risks;

package/dist/firebase/remote-config.d.ts

@@ -0,0 +1,132 @@
+import type { OAuth2Client } from 'google-auth-library';
+interface OptionalResult<T> {
+    available: boolean;
+    data?: T;
+    error?: string;
+}
+interface RemoteConfigTemplate {
+    parameters?: Record<string, unknown>;
+    parameterGroups?: Record<string, unknown>;
+    conditions?: unknown[];
+    version?: {
+        versionNumber?: string;
+        updateTime?: string;
+        updateUser?: {
+            email?: string;
+        };
+        updateOrigin?: string;
+        updateType?: string;
+    };
+}
+interface ExperimentList {
+    experiments?: Array<{
+        name?: string;
+        state?: string;
+        startTime?: string;
+        endTime?: string;
+        lastUpdateTime?: string;
+        definition?: unknown;
+    }>;
+}
+interface RolloutList {
+    rollouts?: Array<{
+        name?: string;
+        state?: string;
+        startTime?: string;
+        endTime?: string;
+        lastUpdateTime?: string;
+        definition?: unknown;
+    }>;
+}
+export declare function estimateRemoteConfigDailyCost(fetches: number): number;
+export declare function remoteConfigUsageLevel(fetches: number): 'ok' | 'warning' | 'critical';
+export declare function getRemoteConfigOverview(auth: OAuth2Client, input: {
+    projectId: string;
+    namespace?: string;
+    days?: number;
+}): Promise<{
+    projectId: string;
+    namespace: string;
+    pricingPolicy: {
+        effectiveDate: string;
+        noCostDailyFetches: number;
+        firstPaidTier: {
+            from: number;
+            to: number;
+            usdPerRequest: number;
+        };
+        secondPaidTier: {
+            from: number;
+            usdPerRequest: number;
+        };
+        transitionNotice: string;
+        sourceUrl: string;
+    };
+    billing: {
+        readonly available: false;
+        readonly error: string;
+    } | {
+        available: boolean;
+        plan: string;
+        billingEnabled: boolean;
+    };
+    usage: OptionalResult<{
+        date: string;
+        fetches: number;
+    }[]> | {
+        available: boolean;
+        metric: string;
+        days: {
+            date: string;
+            fetches: number;
+        }[];
+        latest: {
+            utilizationPercent: number;
+            level: "ok" | "warning" | "critical";
+            projectedStandardDailyCostUsd: number;
+            date: string;
+            fetches: number;
+        } | null;
+    };
+    template: OptionalResult<RemoteConfigTemplate> | {
+        available: boolean;
+        version: {
+            versionNumber?: string;
+            updateTime?: string;
+            updateUser?: {
+                email?: string;
+            };
+            updateOrigin?: string;
+            updateType?: string;
+        } | null;
+        parameterCount: number;
+        parameterGroupCount: number;
+        conditionCount: number;
+    };
+    experiments: OptionalResult<ExperimentList> | {
+        available: boolean;
+        total: number;
+        active: {
+            name?: string;
+            state?: string;
+            startTime?: string;
+            endTime?: string;
+            lastUpdateTime?: string;
+            definition?: unknown;
+        }[];
+    };
+    rollouts: OptionalResult<RolloutList> | {
+        available: boolean;
+        total: number;
+        active: {
+            name?: string;
+            state?: string;
+            startTime?: string;
+            endTime?: string;
+            lastUpdateTime?: string;
+            definition?: unknown;
+        }[];
+    };
+    warnings: string[];
+}>;
+export {};

package/dist/firebase/remote-config.js

@@ -0,0 +1,160 @@
+import { google } from '../lib/googleapis-lite.js';
+import { getBillingInfo } from '../billing/tools.js';
+const FREE_DAILY_FETCHES = 100_000;
+const FIRST_PAID_TIER_END = 10_000_000;
+const REMOTE_CONFIG_BASE = 'https://firebaseremoteconfig.googleapis.com/v1';
+async function optionalRequest(auth, url) {
+    try {
+        const response = await auth.request({ url });
+        return { available: true, data: response.data };
+    }
+    catch (error) {
+        return {
+            available: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function numericPoint(point) {
+    const raw = point.value?.int64Value ?? point.value?.doubleValue ?? 0;
+    const value = typeof raw === 'string' ? Number.parseInt(raw, 10) : raw;
+    return Number.isFinite(value) ? value : 0;
+}
+export function estimateRemoteConfigDailyCost(fetches) {
+    if (fetches <= FREE_DAILY_FETCHES)
+        return 0;
+    const firstPaid = Math.min(fetches, FIRST_PAID_TIER_END) - FREE_DAILY_FETCHES;
+    const secondPaid = Math.max(0, fetches - FIRST_PAID_TIER_END);
+    return firstPaid * 0.000006 + secondPaid * 0.000001;
+}
+export function remoteConfigUsageLevel(fetches) {
+    const ratio = fetches / FREE_DAILY_FETCHES;
+    if (ratio >= 1)
+        return 'critical';
+    if (ratio >= 0.8)
+        return 'warning';
+    return 'ok';
+}
+async function fetchDailyUsage(auth, projectId, days) {
+    try {
+        const end = new Date();
+        const start = new Date(end.getTime() - days * 86_400_000);
+        const monitoring = google.monitoring('v3');
+        const response = await monitoring.projects.timeSeries.list({
+            auth,
+            name: `projects/${projectId}`,
+            filter: 'metric.type="firebaseremoteconfig.googleapis.com/project/fetch_request_count"',
+            'interval.startTime': start.toISOString(),
+            'interval.endTime': end.toISOString(),
+            'aggregation.alignmentPeriod': '86400s',
+            'aggregation.perSeriesAligner': 'ALIGN_SUM',
+            'aggregation.crossSeriesReducer': 'REDUCE_SUM',
+            view: 'FULL',
+            pageSize: Math.max(days + 2, 10),
+        });
+        const rows = (response.data.timeSeries ?? [])
+            .flatMap((series) => series.points ?? [])
+            .map((point) => ({
+            date: (point.interval?.endTime ?? end.toISOString()).slice(0, 10),
+            fetches: numericPoint(point),
+        }))
+            .sort((a, b) => a.date.localeCompare(b.date));
+        return { available: true, data: rows };
+    }
+    catch (error) {
+        return {
+            available: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function getRemoteConfigOverview(auth, input) {
+    const namespace = input.namespace ?? 'firebase';
+    const days = Math.min(Math.max(input.days ?? 7, 1), 30);
+    const encodedProject = encodeURIComponent(input.projectId);
+    const encodedNamespace = encodeURIComponent(namespace);
+    const parent = `${REMOTE_CONFIG_BASE}/projects/${encodedProject}/namespaces/${encodedNamespace}`;
+    const [template, experiments, rollouts, usage, billing] = await Promise.all([
+        optionalRequest(auth, `${parent}/remoteConfig`),
+        optionalRequest(auth, `${parent}/experiments`),
+        optionalRequest(auth, `${parent}/rollouts`),
+        fetchDailyUsage(auth, input.projectId, days),
+        getBillingInfo(auth, input.projectId)
+            .then((data) => ({ available: true, data }))
+            .catch((error) => ({
+            available: false,
+            error: error instanceof Error ? error.message : String(error),
+        })),
+    ]);
+    const daily = usage.data ?? [];
+    const latest = daily.at(-1);
+    const activeExperiments = experiments.data?.experiments?.filter((item) => ['RUNNING', 'ACTIVE', 'STARTED'].includes(item.state ?? '')) ?? [];
+    const activeRollouts = rollouts.data?.rollouts?.filter((item) => ['RUNNING', 'ACTIVE', 'STARTED', 'IN_PROGRESS'].includes(item.state ?? '')) ?? [];
+    return {
+        projectId: input.projectId,
+        namespace,
+        pricingPolicy: {
+            effectiveDate: '2026-09-01',
+            noCostDailyFetches: FREE_DAILY_FETCHES,
+            firstPaidTier: { from: 100_001, to: FIRST_PAID_TIER_END, usdPerRequest: 0.000006 },
+            secondPaidTier: { from: FIRST_PAID_TIER_END + 1, usdPerRequest: 0.000001 },
+            transitionNotice: 'Existing projects can have a plan-specific transition grace period; this tool reports projected standard pricing and does not infer whether a grace period applies.',
+            sourceUrl: 'https://firebase.google.com/docs/remote-config/pricing',
+        },
+        billing: billing.available
+            ? {
+                available: true,
+                plan: billing.data.billingEnabled ? 'blaze' : 'spark',
+                billingEnabled: billing.data.billingEnabled,
+            }
+            : billing,
+        usage: usage.available
+            ? {
+                available: true,
+                metric: 'firebaseremoteconfig.googleapis.com/project/fetch_request_count',
+                days: daily,
+                latest: latest
+                    ? {
+                        ...latest,
+                        utilizationPercent: Number(((latest.fetches / FREE_DAILY_FETCHES) * 100).toFixed(2)),
+                        level: remoteConfigUsageLevel(latest.fetches),
+                        projectedStandardDailyCostUsd: Number(estimateRemoteConfigDailyCost(latest.fetches).toFixed(4)),
+                    }
+                    : null,
+            }
+            : usage,
+        template: template.available
+            ? {
+                available: true,
+                version: template.data?.version ?? null,
+                parameterCount: Object.keys(template.data?.parameters ?? {}).length,
+                parameterGroupCount: Object.keys(template.data?.parameterGroups ?? {}).length,
+                conditionCount: template.data?.conditions?.length ?? 0,
+            }
+            : template,
+        experiments: experiments.available
+            ? {
+                available: true,
+                total: experiments.data?.experiments?.length ?? 0,
+                active: activeExperiments,
+            }
+            : experiments,
+        rollouts: rollouts.available
+            ? {
+                available: true,
+                total: rollouts.data?.rollouts?.length ?? 0,
+                active: activeRollouts,
+            }
+            : rollouts,
+        warnings: [
+            ...(latest && remoteConfigUsageLevel(latest.fetches) !== 'ok'
+                ? [`Daily fetch usage is ${remoteConfigUsageLevel(latest.fetches)} at ${latest.fetches.toLocaleString()} requests.`]
+                : []),
+            ...(latest && latest.fetches >= FREE_DAILY_FETCHES && billing.available && !billing.data.billingEnabled
+                ? ['Spark projects risk throttling above 100,000 daily fetches after the applicable grace period; upgrade to Blaze for uninterrupted overage.']
+                : []),
+            ...(!usage.available ? ['Cloud Monitoring usage is unavailable; no fetch count was estimated.'] : []),
+            ...(!billing.available ? ['Billing plan could not be verified; cost/throttling interpretation is incomplete.'] : []),
+        ],
+    };
+}

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

@@ -15,6 +15,7 @@ export declare const google: {
     readonly cloudresourcemanager: typeof import("googleapis/build/src/apis/cloudresourcemanager/index.js").cloudresourcemanager;
     readonly firebase: typeof import("googleapis/build/src/apis/firebase/index.js").firebase;
     readonly iam: typeof import("googleapis/build/src/apis/iam/index.js").iam;
+    readonly monitoring: typeof import("googleapis/build/src/apis/monitoring/index.js").monitoring;
     readonly searchconsole: typeof import("googleapis/build/src/apis/searchconsole/index.js").searchconsole;
     readonly serviceusage: typeof import("googleapis/build/src/apis/serviceusage/index.js").serviceusage;
     readonly youtube: typeof import("googleapis/build/src/apis/youtube/index.js").youtube;

package/dist/lib/googleapis-lite.js

@@ -79,6 +79,9 @@ export const google = {
     get iam() {
         return sub('iam').iam;
     },
+    get monitoring() {
+        return sub('monitoring').monitoring;
+    },
     get searchconsole() {
         return sub('searchconsole').searchconsole;
     },

package/dist/registers/appstore.js

@@ -8,6 +8,7 @@ import * as appstoreDeclarations from '../appstore/declarations.js';
 import * as testflight from '../appstore/testflight.js';
 import * as previews from '../appstore/previews.js';
 import * as appstoreSales from '../appstore/sales.js';
+import { getWeeklyInsight } from '../appstore/analytics.js';
 import { createAppleOneTimePurchase, createAppleSubscription, updateAppleProduct, deleteAppleProduct, listAppleProducts, } from '@onesub/providers';
 import { requireAppStoreCreds } from '../helpers.js';
 import { buildAppStoreReleasePlan } from '../checks/plan.js';
@@ -20,6 +21,15 @@ function stringifyAttr(value) {
     return typeof value === 'string' ? value : JSON.stringify(value);
 }
 export function registerAppstoreTools(server) {
+    server.tool('appstore_get_weekly_insight', [
+        'App Store Connect Analytics의 표준 주간 Engagement·Downloads·Purchases 리포트를 내려받아 지난 두 기간을 비교합니다.',
+        '제품 페이지·획득·수익화 중 가장 크게 악화된 한 영역과 근거 지표, 실행할 개선안 하나를 반환합니다.',
+        'ONGOING report request가 없으면 기본은 생성하지 않습니다. createIfMissing=true와 confirmCreate=true를 함께 줘야 생성하며 최초 데이터는 24~48시간 뒤 제공됩니다.',
+    ].join(' '), {
+        appId: z.string().describe('App Store 앱 ID'),
+        createIfMissing: z.boolean().optional().describe('ONGOING Analytics report request가 없을 때 생성 준비'),
+        confirmCreate: z.boolean().optional().describe('지속 Analytics report request 생성 명시 확인'),
+    }, async (args) => jsonResult(await getWeeklyInsight(args)));
     server.tool('appstore_list_apps', 'App Store Connect 앱 목록 조회', {}, async () => {
         const apps = await appstore.listApps();
         return jsonResult(apps);
@@ -1070,6 +1080,8 @@ export function registerAppstoreTools(server) {
         lootBox: z.boolean().optional().describe('확률형 아이템(루트박스) 포함 여부'),
         unrestrictedWebAccess: z.boolean().optional().describe('제한 없는 웹 접근'),
         userGeneratedContent: z.boolean().optional().describe('사용자 생성 콘텐츠'),
+        socialMedia: z.boolean().optional().describe('UGC를 피드·탐색 방식으로 재배포·확산·상호작용하는 소셜 미디어 기능'),
+        socialMediaAgeRestricted: z.boolean().optional().describe('소셜 미디어 기능을 13세 미만 사용자에게 비활성화'),
         messagingAndChat: z.boolean().optional().describe('메시지/채팅 기능'),
         advertising: z.boolean().optional().describe('광고 포함'),
         healthOrWellnessTopics: z.boolean().optional().describe('건강/웰니스 주제'),

package/dist/registers/checks.js

@@ -5,7 +5,15 @@ import { requireAuth, requirePlayStoreAuth } from '../helpers.js';
 import * as appstore from '../appstore/tools.js';
 import * as playstore from '../playstore/tools.js';
 import { jsonResult } from '../lib/mcp-response.js';
+import { checkBillingCompliance } from '../checks/billing.js';
 export function registerChecksTools(server) {
+    server.tool('android_check_billing_compliance', [
+        '로컬 Android 저장소의 Google Play Billing Library 버전을 읽기 전용으로 탐지하고 제출 정책 마감과 비교합니다.',
+        'build.gradle, build.gradle.kts, gradle/libs.versions.toml의 literal·변수·version catalog를 검사합니다.',
+        '코드를 자동 수정하지 않고 공식 Android CLI Skill 설치 명령과 업그레이드 프롬프트만 반환합니다.',
+    ].join(' '), {
+        projectPath: z.string().optional().describe('검사할 프로젝트 절대경로 (기본: MCP 프로세스 현재 디렉터리)'),
+    }, async ({ projectPath }) => jsonResult(await checkBillingCompliance(projectPath ?? process.cwd())));
     server.tool('playstore_check_submission_risks', [
         'Google Play 제출 전 위험 요소를 자동으로 점검합니다.',
         '블로커(반드시 수정)와 경고(권장 수정)로 분류하여 반환합니다.',
@@ -23,11 +31,17 @@ export function registerChecksTools(server) {
         'App Store 제출 전 위험 요소를 자동으로 점검합니다.',
         '블로커(반드시 수정)와 경고(권장 수정)로 분류하여 반환합니다.',
         '점검 항목: 메타데이터 완성도(설명/What\'s New/키워드), 스크린샷, TestFlight 빌드, 개인정보처리방침 URL.',
+        '2026년 9월 필수화된 소셜 미디어 연령등급 응답을 확인하고, 기대 기능 값을 주면 App Store Connect 응답과 비교합니다.',
         'App Store 인증이 필요합니다 (appstore_* 도구 사용 가능 상태여야 함).',
     ].join(' '), {
         appId: z.string().describe('App Store 앱 ID (appstore_list_apps 결과의 id 필드)'),
-    }, async ({ appId }) => {
-        const risks = await checkAppStoreRisks(appId);
+        socialMediaCapability: z.boolean().optional().describe('앱이 소셜 피드·UGC 확산 기능을 제공하는지에 대한 프로젝트 사실'),
+        socialMediaAgeRestricted: z.boolean().optional().describe('소셜 미디어 기능이 13세 미만에게 비활성화되는지에 대한 프로젝트 사실'),
+    }, async ({ appId, socialMediaCapability, socialMediaAgeRestricted }) => {
+        const risks = await checkAppStoreRisks(appId, {
+            socialMedia: socialMediaCapability,
+            socialMediaAgeRestricted,
+        });
         const text = formatRisks(risks, 'App Store');
         return { content: [{ type: 'text', text }] };
     });

package/dist/registers/firebase.js

@@ -4,6 +4,7 @@ import { requireAuth } from '../helpers.js';
 import { CLOUD_PLATFORM_SCOPE } from '../auth/scopes.js';
 import { friendlyGoogleError } from '../lib/google-errors.js';
 import { jsonResult, textResult } from '../lib/mcp-response.js';
+import { getRemoteConfigOverview } from '../firebase/remote-config.js';
 // 모든 firebase tools 호출을 친절 에러로 감싸는 프록시 — 17개 핸들러에 개별
 // try/catch 없이 raw GaxiosError(API 미활성화/프로젝트 없음/billing/권한)를
 // "다음에 뭘 할지" 메시지로 변환. 비-Promise 반환은 그대로 통과.
@@ -29,6 +30,18 @@ const firebase = new Proxy(firebaseRaw, {
     },
 });
 export function registerFirebaseTools(server) {
+    server.tool('firebase_get_remote_config_overview', [
+        'Firebase Remote Config의 일일 fetch 사용량, 과금 임계치, 현재 템플릿, A/B 실험과 rollout을 한 번에 조회합니다.',
+        '사용량은 Cloud Monitoring의 공식 fetch_request_count 메트릭을 사용하며, 조회 권한이 없으면 숫자를 추정하지 않고 unavailable로 반환합니다.',
+        '읽기 전용입니다. 10만 건 무료 구간 대비 80%부터 warning, 100%부터 critical로 표시합니다.',
+    ].join(' '), {
+        projectId: z.string().describe('Firebase / Google Cloud 프로젝트 ID'),
+        namespace: z.string().optional().describe('Remote Config namespace (기본: firebase)'),
+        days: z.number().int().min(1).max(30).optional().describe('사용량 조회 일수 (기본: 7, 최대: 30)'),
+    }, async ({ projectId, namespace, days }) => {
+        const auth = await requireAuth();
+        return jsonResult(await getRemoteConfigOverview(auth, { projectId, namespace, days }));
+    });
     server.tool('firebase_list_projects', '내 Firebase 프로젝트 목록 조회', {}, async () => {
         const auth = await requireAuth();
         const projects = await firebase.listProjects(auth);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoonion/mimi-seed-mcp",
-  "version": "0.19.0",
+  "version": "0.19.1",
   "description": "Mimi Seed MCP server \u2014 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": 231,
+  "total": 234,
   "domains": {
     "admob": {
       "label": "AdMob",
@@ -38,7 +38,7 @@
     "appstore": {
       "label": "App Store Connect",
       "credential": "ASC API 키 (mimi-seed auth appstore)",
-      "summary": "버전·빌드 attach·What's New·스크린샷·IAP 심사 메타데이터·심사 제출·매출/재무 리포트",
+      "summary": "버전·빌드 attach·What's New·스크린샷·IAP 심사 메타데이터·심사 제출·매출/재무·주간 인사이트",
       "tools": [
         "appstore_list_apps",
         "appstore_verify_credentials",
@@ -102,6 +102,7 @@
         "appstore_upload_preview",
         "appstore_delete_preview",
         "appstore_get_sales_report",
+        "appstore_get_weekly_insight",
         "appstore_get_finance_report"
       ]
     },
@@ -142,10 +143,11 @@
     "checks": {
       "label": "출시 점검",
       "credential": "점검 대상 스토어의 자격증명",
-      "summary": "제출 전 위험 점검·스크린샷 규격 검증·릴리스 상태",
+      "summary": "제출 전 위험·Billing 정책 점검·스크린샷 규격 검증·릴리스 상태",
       "tools": [
         "playstore_check_submission_risks",
         "appstore_check_submission_risks",
+        "android_check_billing_compliance",
         "screenshot_validate",
         "release_status"
       ]
@@ -179,7 +181,7 @@
     "firebase": {
       "label": "Firebase",
       "credential": "Google OAuth",
-      "summary": "프로젝트/앱 생성·설정 파일 다운로드·서비스 활성화",
+      "summary": "프로젝트/앱 생성·설정 파일 다운로드·서비스 활성화·Remote Config 운영 현황",
       "tools": [
         "firebase_list_projects",
         "firebase_get_project",
@@ -200,7 +202,8 @@
         "firebase_enable_common_services",
         "firebase_list_enabled_services",
         "firebase_link_analytics",
-        "firebase_get_analytics_details"
+        "firebase_get_analytics_details",
+        "firebase_get_remote_config_overview"
       ]
     },
     "ga4": {