@yoonion/mimi-seed-mcp 0.19.1 → 0.19.2

package/dist/appstore/analytics.d.ts

@@ -1,11 +1,33 @@
 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[];
@@ -34,7 +56,13 @@ export declare function buildWeeklyInsight(input: {
     insight: {
         area: string;
         changePercent: number | null;
+        trend: string;
         recommendation: string;
+    } | {
+        area: string;
+        changePercent: null;
+        recommendation: string;
+        trend?: undefined;
     };
     weeks?: undefined;
     recommendation?: undefined;
@@ -90,7 +118,13 @@ export declare function getWeeklyInsight(input: {
     insight: {
         area: string;
         changePercent: number | null;
+        trend: string;
+        recommendation: string;
+    } | {
+        area: string;
+        changePercent: null;
         recommendation: string;
+        trend?: undefined;
     };
     weeks?: undefined;
     recommendation?: undefined;

package/dist/appstore/analytics.js

@@ -4,7 +4,21 @@ 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)
@@ -39,35 +53,64 @@ async function downloadSegment(segment) {
     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}.`);
         }
     }
-    let text;
-    try {
-        text = zlib.gunzipSync(bytes).toString('utf8');
-    }
-    catch {
-        text = bytes.toString('utf8');
-    }
+    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, 2);
-    const allRows = [];
+        .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 ?? [])
-            allRows.push(...await downloadSegment(segment));
+            rows.push(...await downloadSegment(segment));
+        batches.push({ processingDate: instance.attributes.processingDate, rows });
     }
-    return allRows;
+    return selectLatestInstanceRows(batches);
 }
 function numberFrom(row, names) {
     for (const name of names) {
@@ -86,7 +129,14 @@ function dateOf(row) {
 function ensureWeek(map, date) {
     let week = map.get(date);
     if (!week) {
-        week = { date, impressions: 0, productPageViews: 0, downloads: 0, proceeds: 0 };
+        week = {
+            date,
+            impressions: 0,
+            productPageViews: 0,
+            downloads: 0,
+            proceeds: 0,
+            available: { engagement: false, downloads: false, purchases: false },
+        };
         map.set(date, week);
     }
     return week;
@@ -103,9 +153,10 @@ export function buildWeeklyInsight(input) {
         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, ['Counts', 'Count']);
+        const count = numberFrom(row, ['Unique Counts', 'Counts', 'Count']);
         if (event === 'impression')
             week.impressions += count;
         if (event === 'page view' && (pageType === 'product page' || !pageType))
@@ -115,20 +166,27 @@ export function buildWeeklyInsight(input) {
         const date = dateOf(row);
         if (!date)
             continue;
-        ensureWeek(weeks, date).downloads += numberFrom(row, ['Counts', 'Count', 'Downloads', 'Units']);
+        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;
-        ensureWeek(weeks, date).proceeds += numberFrom(row, [
+        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()].sort((a, b) => a.date.localeCompare(b.date));
+    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',
@@ -148,17 +206,22 @@ export function buildWeeklyInsight(input) {
         {
             area: 'product_page',
             changePercent: percentageChange(currentPageRate, previousPageRate),
-            recommendation: '제품 페이지 진입률이 하락했습니다. 아이콘·스크린샷 첫 장·부제 중 하나를 바꿔 Product Page Optimization 테스트를 시작하세요.',
+            declineRecommendation: '제품 페이지 진입률이 하락했습니다. 아이콘·스크린샷 첫 장·부제 중 하나를 바꿔 Product Page Optimization 테스트를 시작하세요.',
+            healthyRecommendation: '핵심 전환 지표의 주간 하락은 없습니다. 가장 개선 폭이 작은 제품 페이지 진입률을 다음 실험 대상으로 삼으세요.',
         },
         {
             area: 'acquisition',
             changePercent: percentageChange(currentDownloadRate, previousDownloadRate),
-            recommendation: '제품 페이지 조회 대비 다운로드 전환이 하락했습니다. 유입 소스별 전환을 나누고 가장 큰 하락 소스에 맞춘 커스텀 제품 페이지를 만드세요.',
+            declineRecommendation: '제품 페이지 조회 대비 다운로드 전환이 하락했습니다. 유입 소스별 전환을 나누고 가장 큰 하락 소스에 맞춘 커스텀 제품 페이지를 만드세요.',
+            healthyRecommendation: '핵심 전환 지표의 주간 하락은 없습니다. 가장 개선 폭이 작은 다운로드 전환을 유입 소스별로 나눠 다음 실험을 정하세요.',
         },
         {
             area: 'monetization',
-            changePercent: percentageChange(currentRevenuePerDownload, previousRevenuePerDownload),
-            recommendation: '다운로드당 수익이 하락했습니다. 구매 리포트에서 상품별 하락을 확인하고 가격·오퍼·구독 전환 중 한 가지를 실험하세요.',
+            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));
@@ -171,21 +234,28 @@ export function buildWeeklyInsight(input) {
             impressions: percentageChange(current.impressions, previous.impressions),
             productPageViews: percentageChange(current.productPageViews, previous.productPageViews),
             downloads: percentageChange(current.downloads, previous.downloads),
-            proceeds: percentageChange(current.proceeds, previous.proceeds),
+            proceeds: previous.available.purchases && current.available.purchases
+                ? percentageChange(current.proceeds, previous.proceeds)
+                : null,
             productPageRate: percentageChange(currentPageRate, previousPageRate),
             downloadRate: percentageChange(currentDownloadRate, previousDownloadRate),
-            revenuePerDownload: percentageChange(currentRevenuePerDownload, previousRevenuePerDownload),
+            revenuePerDownload: previous.available.purchases && current.available.purchases
+                ? percentageChange(currentRevenuePerDownload, previousRevenuePerDownload)
+                : null,
         },
         insight: selected
             ? {
                 area: selected.area,
                 changePercent: selected.changePercent,
-                recommendation: selected.recommendation,
+                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·Purchases 리포트가 생성되는지 확인하세요.',
+                recommendation: '비교 가능한 분모 데이터가 부족합니다. Engagement·주간 Downloads Detailed·Purchases 리포트가 생성되는지 확인하세요.',
             },
     };
 }
@@ -214,10 +284,7 @@ export async function getWeeklyInsight(input) {
         };
     }
     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 ?? ''));
+    const { engagement, downloads, purchases } = selectWeeklyAnalyticsReports(reports.data ?? []);
     if (!engagement && !downloads && !purchases) {
         return {
             status: 'collecting',

package/dist/checks/billing.d.ts

@@ -13,10 +13,16 @@ export interface BillingComplianceResult {
     detectedVersions: string[];
     evidence: BillingEvidence[];
     policy: {
-        minimumSupportedMajor: number;
+        minimumSupportedMajor: number | null;
         submissionDeadline: string;
         extensionDeadline: string;
         latestKnownMajor: number;
+        scheduleCurrent: boolean;
+        knownSchedule: Array<{
+            major: number;
+            submissionDeadline: string;
+            extensionDeadline: string;
+        }>;
         sourceUrl: string;
     };
     summary: string;

package/dist/checks/billing.js

@@ -4,6 +4,13 @@ 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 BILLING_SUPPORT_SCHEDULE = [
+    { major: 5, submissionDeadline: '2024-08-31', extensionDeadline: '2024-11-01' },
+    { major: 6, submissionDeadline: '2025-08-31', extensionDeadline: '2025-11-01' },
+    { major: 7, submissionDeadline: '2026-08-31', extensionDeadline: '2026-11-01' },
+    { major: 8, submissionDeadline: '2027-08-31', extensionDeadline: '2027-11-01' },
+    { major: 9, submissionDeadline: '2028-08-31', extensionDeadline: '2028-11-01' },
+];
 const SKIP_DIRS = new Set([
     '.git',
     '.gradle',
@@ -45,6 +52,7 @@ async function walk(root, maxDepth = 7) {
 function parseCatalog(text) {
     const versions = new Map();
     const libraries = new Map();
+    const bundles = new Map();
     let section = '';
     for (const rawLine of text.split(/\r?\n/)) {
         const line = rawLine.replace(/\s+#.*$/, '').trim();
@@ -61,18 +69,37 @@ function parseCatalog(text) {
                 versions.set(match[1], match[2]);
             continue;
         }
+        if (section === 'bundles') {
+            const match = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*\[([^\]]*)]/);
+            if (match) {
+                bundles.set(match[1], [...match[2].matchAll(/["']([^"']+)["']/g)].map((item) => item[1]));
+            }
+            continue;
+        }
         if (section !== 'libraries')
             continue;
+        const shorthand = line.match(/^([A-Za-z0-9_.-]+)\s*=\s*["']([^"']+)["']/);
+        if (shorthand) {
+            const coordinates = shorthand[2].split(':');
+            libraries.set(shorthand[1], {
+                module: coordinates.length >= 2 ? `${coordinates[0]}:${coordinates[1]}` : undefined,
+                version: coordinates.length >= 3 ? coordinates.slice(2).join(':') : undefined,
+            });
+            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 explicitModule = body.match(/module\s*=\s*["']([^"']+)["']/)?.[1];
+        const group = body.match(/group\s*=\s*["']([^"']+)["']/)?.[1];
+        const name = body.match(/name\s*=\s*["']([^"']+)["']/)?.[1];
+        const module = explicitModule ?? (group && name ? `${group}:${name}` : undefined);
         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 };
+    return { versions, libraries, bundles };
 }
 function collectVariables(text) {
     const result = new Map();
@@ -88,51 +115,72 @@ function majorOf(version) {
     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;
+    const deadlineEnd = (date) => new Date(`${date}T23:59:59.999Z`);
+    const next = BILLING_SUPPORT_SCHEDULE.find((row) => now <= deadlineEnd(row.submissionDeadline));
+    const lastExpired = [...BILLING_SUPPORT_SCHEDULE]
+        .filter((row) => now > deadlineEnd(row.submissionDeadline))
+        .at(-1);
     return {
-        minimumSupportedMajor,
-        submissionDeadline: `${unsupportedMajor + 2019}-08-31`,
-        extensionDeadline: `${unsupportedMajor + 2019}-11-01`,
-        latestKnownMajor: Math.max(9, minimumSupportedMajor + 1),
+        minimumSupportedMajor: next?.major ?? null,
+        submissionDeadline: lastExpired?.submissionDeadline ?? BILLING_SUPPORT_SCHEDULE[0].submissionDeadline,
+        extensionDeadline: lastExpired?.extensionDeadline ?? BILLING_SUPPORT_SCHEDULE[0].extensionDeadline,
+        latestKnownMajor: BILLING_SUPPORT_SCHEDULE.at(-1).major,
+        scheduleCurrent: Boolean(next),
+        knownSchedule: BILLING_SUPPORT_SCHEDULE.map((row) => ({ ...row })),
         sourceUrl: 'https://developer.android.com/google/play/billing/deprecation-faq',
     };
 }
+function scheduleForMajor(major) {
+    return BILLING_SUPPORT_SCHEDULE.find((row) => row.major === major);
+}
+function catalogScope(file) {
+    const parent = path.dirname(file);
+    return path.basename(parent) === 'gradle' ? path.dirname(parent) : parent;
+}
+function isWithin(scope, file) {
+    const relative = path.relative(scope, file);
+    return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
+}
 export async function checkBillingCompliance(projectPath, now = new Date()) {
     const root = path.resolve(projectPath);
+    let rootStat;
+    try {
+        rootStat = await fs.stat(root);
+    }
+    catch {
+        throw new Error(`Android project path does not exist or is not readable: ${root}`);
+    }
+    if (!rootStat.isDirectory())
+        throw new Error(`Android project path is not a directory: ${root}`);
     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();
+    const catalogs = files
+        .filter((file) => path.basename(file) === 'libs.versions.toml')
+        .map((file) => ({ file, scope: catalogScope(file), info: parseCatalog(texts.get(file) ?? '') }));
+    const variablesByFile = 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);
+        variablesByFile.set(file, collectVariables(text));
     }
+    const catalogFor = (file) => catalogs
+        .filter((entry) => isWithin(entry.scope, file))
+        .sort((left, right) => right.scope.length - left.scope.length)[0]?.info
+        ?? (catalogs.length === 1 ? catalogs[0].info : undefined);
+    const variableFor = (file, key) => [...variablesByFile.entries()]
+        .filter(([candidate]) => candidate === file || isWithin(path.dirname(candidate), file))
+        .sort(([left], [right]) => path.dirname(right).length - path.dirname(left).length)
+        .map(([, variables]) => variables.get(key))
+        .find((value) => value !== undefined);
     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;
         }
+        const catalog = catalogFor(file);
         for (const match of text.matchAll(LITERAL_DEPENDENCY)) {
             evidence.push({
                 file: relative,
@@ -142,7 +190,7 @@ export async function checkBillingCompliance(projectPath, now = new Date()) {
             });
         }
         for (const match of text.matchAll(VARIABLE_DEPENDENCY)) {
-            const version = allVariables.get(match[1]);
+            const version = variableFor(file, match[1]);
             evidence.push({
                 file: relative,
                 module: match[0].slice(0, match[0].lastIndexOf(':')),
@@ -151,12 +199,34 @@ export async function checkBillingCompliance(projectPath, now = new Date()) {
                 source: version ? 'variable' : 'unresolved',
             });
         }
+        for (const bundleMatch of text.matchAll(/\blibs\.bundles\.([A-Za-z0-9_.-]+)/g)) {
+            const bundleAlias = normalizeAlias(bundleMatch[1]);
+            const libraryAliases = catalog?.bundles.get(bundleAlias) ?? catalog?.bundles.get(bundleMatch[1]) ?? [];
+            for (const libraryAlias of libraryAliases) {
+                const normalizedLibraryAlias = normalizeAlias(libraryAlias);
+                const lib = catalog?.libraries.get(normalizedLibraryAlias) ?? catalog?.libraries.get(libraryAlias);
+                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 === bundleMatch[0] && row.module === lib.module)) {
+                    evidence.push({
+                        file: relative,
+                        module: lib.module,
+                        version,
+                        expression: bundleMatch[0],
+                        source: version ? 'version_catalog' : 'unresolved',
+                    });
+                }
+            }
+        }
         for (const aliasMatch of text.matchAll(/\blibs\.([A-Za-z0-9_.-]+)/g)) {
+            if (aliasMatch[1].startsWith('bundles.'))
+                continue;
             const alias = normalizeAlias(aliasMatch[1]);
-            const lib = catalog.libraries.get(alias) ?? catalog.libraries.get(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);
+            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,
@@ -187,11 +257,21 @@ export async function checkBillingCompliance(projectPath, now = new Date()) {
         status = 'not_used';
         summary = 'Google Play Billing dependency was not found in the scanned Gradle project.';
     }
+    else if (!policy.scheduleCurrent || policy.minimumSupportedMajor === null) {
+        status = 'unresolved';
+        summary = `The official schedule embedded in this release ends at Billing Library ${policy.latestKnownMajor}; current policy must be refreshed from the source.`;
+        actions.push('Check the official Billing deprecation table and update Mimi Seed before relying on this result.');
+    }
     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}.`);
+        for (const major of [...new Set(majors.filter((value) => value < policy.minimumSupportedMajor))].sort()) {
+            const schedule = scheduleForMajor(major);
+            actions.push(schedule
+                ? `Billing Library ${major}: standard deadline ${schedule.submissionDeadline}; extension deadline ${schedule.extensionDeadline} only if Google granted it in Play Console.`
+                : `Billing Library ${major}: its deadline predates the embedded official table; no active extension should be assumed.`);
+        }
     }
     else if (unresolved || majors.length === 0) {
         status = 'unresolved';
@@ -201,7 +281,9 @@ export async function checkBillingCompliance(projectPath, now = new Date()) {
     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.`);
+        const nextDeadline = scheduleForMajor(policy.minimumSupportedMajor);
+        if (nextDeadline)
+            actions.push(`Plan an upgrade before ${nextDeadline.submissionDeadline}.`);
     }
     else {
         status = 'pass';

package/dist/checks/risks.js

@@ -1,5 +1,6 @@
 import { publisher, withEdit } from '../playstore/tools.js';
 import { apiGet } from '../appstore/tools.js';
+import { isNotFound } from '../appstore/http.js';
 const APPSTORE_EDITABLE_STATES = 'PREPARE_FOR_SUBMISSION,DEVELOPER_REJECTED,METADATA_REJECTED,REJECTED';
 export async function checkPlayStoreRisks(auth, packageName, language = 'ko-KR') {
     const risks = [];
@@ -145,9 +146,19 @@ export async function checkAppStoreRisks(appId, expected = {}) {
                     'fields[appInfoLocalizations]': 'locale,privacyPolicyUrl,privacyPolicyText',
                     'limit': '200',
                 }), risks, 'PRIVACY', '개인정보 로컬라이제이션'),
-                safeGet(() => apiGet(`/appInfos/${editable.id}/ageRatingDeclaration`, {
-                    'fields[ageRatingDeclarations]': 'userGeneratedContent,socialMedia,socialMediaAgeRestricted',
-                }), risks, 'AGE_RATING_SOCIAL', '연령등급 소셜 미디어 응답'),
+                safeGet(async () => {
+                    try {
+                        return await apiGet(`/appInfos/${editable.id}/ageRatingDeclaration`, {
+                            'fields[ageRatingDeclarations]': 'userGeneratedContent,socialMedia,socialMediaAgeRestricted,ageAssurance',
+                        });
+                    }
+                    catch (error) {
+                        // A 404 means the declaration is genuinely absent, not that the check is unknown.
+                        if (isNotFound(error))
+                            return { data: null };
+                        throw error;
+                    }
+                }, risks, 'AGE_RATING_SOCIAL', '연령등급 소셜 미디어 응답'),
             ]);
             if (localizations) {
                 const locs = (localizations.data ?? []);
@@ -175,7 +186,18 @@ export async function checkAppStoreRisks(appId, expected = {}) {
                         detail: 'socialMediaAgeRestricted=true는 socialMedia=true인 앱에서만 의미가 있습니다.',
                     });
                 }
-                if (expected.socialMedia !== undefined && declaration.socialMedia !== expected.socialMedia) {
+                if (declaration.socialMediaAgeRestricted === true && declaration.ageAssurance !== true) {
+                    risks.push({
+                        level: 'blocker',
+                        code: 'SOCIAL_MEDIA_AGE_ASSURANCE_MISSING',
+                        title: '13세 미만 소셜 기능 제한에 연령 확인이 없음',
+                        detail: 'Apple은 socialMediaAgeRestricted=true인 경우 최소한 Declared Age Range API로 연령 범위를 확인하도록 요구합니다. ageAssurance 응답과 실제 구현을 확인하세요.',
+                        fixUrl: 'https://developer.apple.com/help/app-store-connect/reference/app-information/age-ratings-values-and-definitions',
+                    });
+                }
+                if (expected.socialMedia !== undefined
+                    && declaration.socialMedia !== undefined
+                    && declaration.socialMedia !== expected.socialMedia) {
                     risks.push({
                         level: 'blocker',
                         code: 'SOCIAL_MEDIA_CAPABILITY_MISMATCH',
@@ -184,6 +206,7 @@ export async function checkAppStoreRisks(appId, expected = {}) {
                     });
                 }
                 if (expected.socialMediaAgeRestricted !== undefined
+                    && declaration.socialMediaAgeRestricted !== undefined
                     && declaration.socialMediaAgeRestricted !== expected.socialMediaAgeRestricted) {
                     risks.push({
                         level: 'blocker',

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

@@ -18,26 +18,14 @@ interface RemoteConfigTemplate {
         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;
-    }>;
+interface PagedItems<T> {
+    items: T[];
+    pages: number;
+    truncated: boolean;
 }
+export declare function countStates(items: Array<{
+    state?: string;
+}>): Record<string, number>;
 export declare function estimateRemoteConfigDailyCost(fetches: number): number;
 export declare function remoteConfigUsageLevel(fetches: number): 'ok' | 'warning' | 'critical';
 export declare function getRemoteConfigOverview(auth: OAuth2Client, input: {
@@ -87,6 +75,13 @@ export declare function getRemoteConfigOverview(auth: OAuth2Client, input: {
             date: string;
             fetches: number;
         } | null;
+        peak: {
+            utilizationPercent: number;
+            level: "ok" | "warning" | "critical";
+            projectedStandardDailyCostUsd: number;
+            date: string;
+            fetches: number;
+        } | null;
     };
     template: OptionalResult<RemoteConfigTemplate> | {
         available: boolean;
@@ -103,29 +98,65 @@ export declare function getRemoteConfigOverview(auth: OAuth2Client, input: {
         parameterGroupCount: number;
         conditionCount: number;
     };
-    experiments: OptionalResult<ExperimentList> | {
+    experiments: OptionalResult<PagedItems<{
+        name?: string;
+        state?: string;
+        startTime?: string;
+        endTime?: string;
+        lastUpdateTime?: string;
+        definition?: unknown;
+    }>> | {
         available: boolean;
         total: number;
+        stateCounts: Record<string, number>;
         active: {
-            name?: string;
-            state?: string;
-            startTime?: string;
-            endTime?: string;
-            lastUpdateTime?: string;
-            definition?: unknown;
+            name: string | undefined;
+            displayName: string | undefined;
+            state: string | undefined;
+            startTime: string | undefined;
+            endTime: string | undefined;
+            lastUpdateTime: string | undefined;
         }[];
+        recent: {
+            name: string | undefined;
+            displayName: string | undefined;
+            state: string | undefined;
+            startTime: string | undefined;
+            endTime: string | undefined;
+            lastUpdateTime: string | undefined;
+        }[];
+        pages: number;
+        truncated: boolean;
     };
-    rollouts: OptionalResult<RolloutList> | {
+    rollouts: OptionalResult<PagedItems<{
+        name?: string;
+        state?: string;
+        startTime?: string;
+        endTime?: string;
+        lastUpdateTime?: string;
+        definition?: unknown;
+    }>> | {
         available: boolean;
         total: number;
+        stateCounts: Record<string, number>;
         active: {
-            name?: string;
-            state?: string;
-            startTime?: string;
-            endTime?: string;
-            lastUpdateTime?: string;
-            definition?: unknown;
+            name: string | undefined;
+            displayName: string | undefined;
+            state: string | undefined;
+            startTime: string | undefined;
+            endTime: string | undefined;
+            lastUpdateTime: string | undefined;
+        }[];
+        recent: {
+            name: string | undefined;
+            displayName: string | undefined;
+            state: string | undefined;
+            startTime: string | undefined;
+            endTime: string | undefined;
+            lastUpdateTime: string | undefined;
         }[];
+        pages: number;
+        truncated: boolean;
     };
     warnings: string[];
 }>;

package/dist/firebase/remote-config.js

@@ -3,6 +3,14 @@ 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';
+export function countStates(items) {
+    const counts = {};
+    for (const item of items) {
+        const state = item.state ?? 'UNSPECIFIED';
+        counts[state] = (counts[state] ?? 0) + 1;
+    }
+    return counts;
+}
 async function optionalRequest(auth, url) {
     try {
         const response = await auth.request({ url });
@@ -15,6 +23,31 @@ async function optionalRequest(auth, url) {
         };
     }
 }
+async function optionalPagedRequest(auth, url, field) {
+    try {
+        const items = [];
+        let pageToken;
+        let pages = 0;
+        do {
+            const requestUrl = new URL(url);
+            requestUrl.searchParams.set('pageSize', '100');
+            if (pageToken)
+                requestUrl.searchParams.set('pageToken', pageToken);
+            const response = await auth.request({ url: requestUrl.toString() });
+            const data = response.data;
+            items.push(...(data[field] ?? []));
+            pageToken = data.nextPageToken;
+            pages += 1;
+        } while (pageToken && pages < 10);
+        return { available: true, data: { items, pages, truncated: Boolean(pageToken) } };
+    }
+    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;
@@ -52,12 +85,17 @@ async function fetchDailyUsage(auth, projectId, days) {
             view: 'FULL',
             pageSize: Math.max(days + 2, 10),
         });
-        const rows = (response.data.timeSeries ?? [])
+        const points = (response.data.timeSeries ?? [])
             .flatMap((series) => series.points ?? [])
             .map((point) => ({
             date: (point.interval?.endTime ?? end.toISOString()).slice(0, 10),
             fetches: numericPoint(point),
-        }))
+        }));
+        const byDate = new Map();
+        for (const point of points)
+            byDate.set(point.date, (byDate.get(point.date) ?? 0) + point.fetches);
+        const rows = [...byDate.entries()]
+            .map(([date, fetches]) => ({ date, fetches }))
             .sort((a, b) => a.date.localeCompare(b.date));
         return { available: true, data: rows };
     }
@@ -76,8 +114,8 @@ export async function getRemoteConfigOverview(auth, input) {
     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`),
+        optionalPagedRequest(auth, `${parent}/experiments`, 'experiments'),
+        optionalPagedRequest(auth, `${parent}/rollouts`, 'rollouts'),
         fetchDailyUsage(auth, input.projectId, days),
         getBillingInfo(auth, input.projectId)
             .then((data) => ({ available: true, data }))
@@ -88,8 +126,45 @@ export async function getRemoteConfigOverview(auth, input) {
     ]);
     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 ?? '')) ?? [];
+    const peak = daily.reduce((current, point) => !current || point.fetches > current.fetches ? point : current, undefined);
+    const withUsageProjection = (point) => ({
+        ...point,
+        utilizationPercent: Number(((point.fetches / FREE_DAILY_FETCHES) * 100).toFixed(2)),
+        level: remoteConfigUsageLevel(point.fetches),
+        projectedStandardDailyCostUsd: Number(estimateRemoteConfigDailyCost(point.fetches).toFixed(4)),
+    });
+    const summarizeExperiment = (item) => ({
+        name: item.name,
+        displayName: item.definition?.displayName,
+        state: item.state,
+        startTime: item.startTime,
+        endTime: item.endTime,
+        lastUpdateTime: item.lastUpdateTime,
+    });
+    const summarizeRollout = (item) => ({
+        name: item.name,
+        displayName: item.definition?.displayName,
+        state: item.state,
+        startTime: item.startTime,
+        endTime: item.endTime,
+        lastUpdateTime: item.lastUpdateTime,
+    });
+    const activeExperiments = experiments.data?.items
+        .filter((item) => item.state === 'RUNNING')
+        .map(summarizeExperiment) ?? [];
+    const activeRollouts = rollouts.data?.items
+        .filter((item) => item.state === 'RUNNING')
+        .map(summarizeRollout) ?? [];
+    const recentExperiments = [...(experiments.data?.items ?? [])]
+        .sort((left, right) => (right.lastUpdateTime ?? right.endTime ?? right.startTime ?? '')
+        .localeCompare(left.lastUpdateTime ?? left.endTime ?? left.startTime ?? ''))
+        .slice(0, 20)
+        .map(summarizeExperiment);
+    const recentRollouts = [...(rollouts.data?.items ?? [])]
+        .sort((left, right) => (right.lastUpdateTime ?? right.endTime ?? right.startTime ?? '')
+        .localeCompare(left.lastUpdateTime ?? left.endTime ?? left.startTime ?? ''))
+        .slice(0, 20)
+        .map(summarizeRollout);
     return {
         projectId: input.projectId,
         namespace,
@@ -113,14 +188,8 @@ export async function getRemoteConfigOverview(auth, input) {
                 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,
+                latest: latest ? withUsageProjection(latest) : null,
+                peak: peak ? withUsageProjection(peak) : null,
             }
             : usage,
         template: template.available
@@ -135,26 +204,36 @@ export async function getRemoteConfigOverview(auth, input) {
         experiments: experiments.available
             ? {
                 available: true,
-                total: experiments.data?.experiments?.length ?? 0,
+                total: experiments.data?.items.length ?? 0,
+                stateCounts: countStates(experiments.data?.items ?? []),
                 active: activeExperiments,
+                recent: recentExperiments,
+                pages: experiments.data?.pages ?? 0,
+                truncated: experiments.data?.truncated ?? false,
             }
             : experiments,
         rollouts: rollouts.available
             ? {
                 available: true,
-                total: rollouts.data?.rollouts?.length ?? 0,
+                total: rollouts.data?.items.length ?? 0,
+                stateCounts: countStates(rollouts.data?.items ?? []),
                 active: activeRollouts,
+                recent: recentRollouts,
+                pages: rollouts.data?.pages ?? 0,
+                truncated: rollouts.data?.truncated ?? false,
             }
             : rollouts,
         warnings: [
-            ...(latest && remoteConfigUsageLevel(latest.fetches) !== 'ok'
-                ? [`Daily fetch usage is ${remoteConfigUsageLevel(latest.fetches)} at ${latest.fetches.toLocaleString()} requests.`]
+            ...(peak && remoteConfigUsageLevel(peak.fetches) !== 'ok'
+                ? [`Peak daily fetch usage is ${remoteConfigUsageLevel(peak.fetches)} at ${peak.fetches.toLocaleString()} requests on ${peak.date}.`]
                 : []),
-            ...(latest && latest.fetches >= FREE_DAILY_FETCHES && billing.available && !billing.data.billingEnabled
+            ...(peak && peak.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.'] : []),
+            ...(experiments.data?.truncated ? ['Experiment list exceeded 1,000 items and was truncated.'] : []),
+            ...(rollouts.data?.truncated ? ['Rollout list exceeded 1,000 items and was truncated.'] : []),
         ],
     };
 }

package/package.json

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