@yoonion/mimi-seed-mcp 0.3.40 → 0.5.0

package/dist/googleads/tools.js

@@ -84,20 +84,20 @@ export async function listAccessibleCustomers(auth, cfg) {
 }
 // ─── 캠페인 목록 ─────────────────────────────────────────────
 export async function listCampaigns(auth, cfg) {
-    const query = `
-    SELECT
-      campaign.id,
-      campaign.name,
-      campaign.status,
-      campaign.advertising_channel_type,
-      campaign.advertising_channel_sub_type,
-      campaign.start_date,
-      campaign.end_date,
-      campaign_budget.amount_micros
-    FROM campaign
-    WHERE campaign.status != 'REMOVED'
-    ORDER BY campaign.name ASC
-    LIMIT 200
+    const query = `
+    SELECT
+      campaign.id,
+      campaign.name,
+      campaign.status,
+      campaign.advertising_channel_type,
+      campaign.advertising_channel_sub_type,
+      campaign.start_date,
+      campaign.end_date,
+      campaign_budget.amount_micros
+    FROM campaign
+    WHERE campaign.status != 'REMOVED'
+    ORDER BY campaign.name ASC
+    LIMIT 200
   `;
     const rows = await search(auth, cfg, query);
     return rows.map((r) => ({
@@ -113,26 +113,26 @@ export async function listCampaigns(auth, cfg) {
 }
 // ─── 캠페인 성과 리포트 ────────────────────────────────────────
 export async function getCampaignReport(auth, cfg, range) {
-    const query = `
-    SELECT
-      campaign.id,
-      campaign.name,
-      campaign.status,
-      campaign.advertising_channel_type,
-      campaign.advertising_channel_sub_type,
-      metrics.clicks,
-      metrics.impressions,
-      metrics.cost_micros,
-      metrics.conversions,
-      metrics.conversions_value,
-      metrics.cost_per_conversion,
-      metrics.ctr,
-      metrics.average_cpc
-    FROM campaign
-    WHERE campaign.status != 'REMOVED'
-      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
-    ORDER BY metrics.cost_micros DESC
-    LIMIT 500
+    const query = `
+    SELECT
+      campaign.id,
+      campaign.name,
+      campaign.status,
+      campaign.advertising_channel_type,
+      campaign.advertising_channel_sub_type,
+      metrics.clicks,
+      metrics.impressions,
+      metrics.cost_micros,
+      metrics.conversions,
+      metrics.conversions_value,
+      metrics.cost_per_conversion,
+      metrics.ctr,
+      metrics.average_cpc
+    FROM campaign
+    WHERE campaign.status != 'REMOVED'
+      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
+    ORDER BY metrics.cost_micros DESC
+    LIMIT 500
   `;
     const rows = await search(auth, cfg, query);
     return rows.map((r) => ({
@@ -153,26 +153,26 @@ export async function getCampaignReport(auth, cfg, range) {
 }
 // ─── UAC(앱 캠페인) 리포트 ─────────────────────────────────────
 export async function getUacReport(auth, cfg, range) {
-    const query = `
-    SELECT
-      campaign.id,
-      campaign.name,
-      campaign.status,
-      campaign.advertising_channel_sub_type,
-      metrics.clicks,
-      metrics.impressions,
-      metrics.cost_micros,
-      metrics.conversions,
-      metrics.conversions_value,
-      metrics.cost_per_conversion,
-      metrics.ctr,
-      segments.date
-    FROM campaign
-    WHERE campaign.advertising_channel_type = 'MULTI_CHANNEL'
-      AND campaign.advertising_channel_sub_type IN ('APP_CAMPAIGN', 'APP_CAMPAIGN_FOR_ENGAGEMENT', 'APP_CAMPAIGN_FOR_PRE_REGISTRATION')
-      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
-    ORDER BY segments.date DESC, metrics.cost_micros DESC
-    LIMIT 500
+    const query = `
+    SELECT
+      campaign.id,
+      campaign.name,
+      campaign.status,
+      campaign.advertising_channel_sub_type,
+      metrics.clicks,
+      metrics.impressions,
+      metrics.cost_micros,
+      metrics.conversions,
+      metrics.conversions_value,
+      metrics.cost_per_conversion,
+      metrics.ctr,
+      segments.date
+    FROM campaign
+    WHERE campaign.advertising_channel_type = 'MULTI_CHANNEL'
+      AND campaign.advertising_channel_sub_type IN ('APP_CAMPAIGN', 'APP_CAMPAIGN_FOR_ENGAGEMENT', 'APP_CAMPAIGN_FOR_PRE_REGISTRATION')
+      AND segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'
+    ORDER BY segments.date DESC, metrics.cost_micros DESC
+    LIMIT 500
   `;
     const rows = await search(auth, cfg, query);
     const byId = new Map();

package/dist/helpers.d.ts

@@ -8,7 +8,7 @@ export { ensureFreshAccessToken };
  * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
  * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
  */
-export declare function requireAuth(): Promise<import("google-auth-library").OAuth2Client>;
+export declare function requireAuth(requiredScope?: string): Promise<import("google-auth-library").OAuth2Client>;
 export declare const PLAY_AUTH_HINT: string;
 export declare const APPSTORE_AUTH_HINT: string;
 /**

package/dist/helpers.js

@@ -1,4 +1,4 @@
-import { getAuthenticatedClient, ensureFreshAccessToken } from './auth/google-auth.js';
+import { getAuthenticatedClient, ensureFreshAccessToken, getStoredTokens } from './auth/google-auth.js';
 import { getServiceAccountClient, getServiceAccountJson } from './auth/playstore-auth.js';
 import { getAppStoreCredentials } from './appstore/auth.js';
 export { ensureFreshAccessToken };
@@ -22,7 +22,7 @@ function formatAuthError(p) {
  * 기존엔 만료 시 각 OAuth 도구(firebase/admob/iam/googleads/checks)가
  * googleapis GaxiosError 를 그대로 노출 → 사용자는 "재로그인하라"는 안내를 못 받았다.
  */
-export async function requireAuth() {
+export async function requireAuth(requiredScope) {
     const result = await ensureFreshAccessToken();
     if (result.status === 'unauthenticated' || result.status === 'expired_refresh_failed') {
         throw new Error(formatAuthError(result.error));
@@ -37,6 +37,22 @@ export async function requireAuth() {
             needsReauth: true,
         }));
     }
+    // 신규 스코프(GA4 analytics.edit 등)는 변경 전 발급된 토큰엔 없다. expiry 만 보는
+    // ensureFreshAccessToken 은 이를 못 걸러내므로(런타임 ACCESS_TOKEN_SCOPE_INSUFFICIENT),
+    // 저장된 scope 로 pre-flight 검사해 결정적인 재로그인 안내를 던진다.
+    // (scope 가 undefined 인 구 토큰은 미보유로 간주 → 재로그인 유도.)
+    if (requiredScope) {
+        const granted = (getStoredTokens()?.scope ?? '').split(' ').filter(Boolean);
+        if (!granted.includes(requiredScope)) {
+            throw new Error(formatAuthError({
+                code: 'INSUFFICIENT_SCOPE',
+                message: `이 도구는 추가 권한이 필요해 (${requiredScope}). 기존 로그인에 없어서 1회 재로그인이 필요해.`,
+                hint: 'mimi-seed-auth 로 재로그인하면 새 권한이 부여돼.',
+                retriable: false,
+                needsReauth: true,
+            }));
+        }
+    }
     return client;
 }
 export const PLAY_AUTH_HINT = [

package/dist/index.js

@@ -16,6 +16,7 @@ import { registerInstagramTools } from './registers/instagram.js';
 import { registerFacebookTools } from './registers/facebook.js';
 import { registerGoogleAdsTools } from './registers/googleads.js';
 import { registerGscTools } from './registers/gsc.js';
+import { registerGa4Tools } from './registers/ga4.js';
 import { registerJenkinsTools } from './registers/jenkins.js';
 import { registerAndroidTools } from './registers/android.js';
 import { registerPrompts } from './prompts.js';
@@ -41,6 +42,7 @@ registerInstagramTools(server);
 registerFacebookTools(server);
 registerGoogleAdsTools(server);
 registerGscTools(server);
+registerGa4Tools(server);
 registerJenkinsTools(server);
 registerAndroidTools(server);
 registerPrompts(server);
@@ -54,6 +56,9 @@ const SUBCOMMANDS = {
     'mimi-seed-playstore-auth': () => import('./auth/playstore-setup-cli.js'),
     'mimi-seed-appstore-auth': () => import('./appstore/setup-cli.js'),
     'mimi-seed-bigquery-auth': () => import('./auth/bigquery-setup-cli.js'),
+    'mimi-seed-firebase': () => import('./firebase/cli.js'),
+    'mimi-seed-admob': () => import('./admob/cli.js'),
+    'mimi-seed-ga4': () => import('./ga4/cli.js'),
 };
 async function main() {
     const sub = process.argv[2];

package/dist/lib/cli-args.d.ts

@@ -0,0 +1,31 @@
+export interface ParsedArgs {
+    /** 첫 위치 인자 — 서브커맨드 (예: 'create-property') */
+    command: string | undefined;
+    /** --name value 형태의 값 플래그 */
+    flags: Record<string, string>;
+    /** --force 형태의 불리언 플래그 */
+    bools: Set<string>;
+}
+/** process.argv.slice(2) 같은 토큰 배열을 파싱. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** 값 플래그 조회 — 없으면 fallback. */
+export declare function flag(p: ParsedArgs, name: string, fallback?: string): string | undefined;
+/** 필수 값 플래그 — 없으면 친절 에러 throw. */
+export declare function requireFlag(p: ParsedArgs, name: string): string;
+/** 쉼표 구분 값 → 배열 ('a, b ,c' → ['a','b','c']). 없으면 undefined. */
+export declare function flagList(p: ParsedArgs, name: string): string[] | undefined;
+/** 사용법 위반 — main()에서 잡아 도움말과 함께 exit 1. */
+export declare class CliUsageError extends Error {
+}
+/** 결과 JSON 을 stdout 으로 출력 (stderr 는 진행/안내용). */
+export declare function printJson(data: unknown): void;
+/**
+ * 도메인 sub-CLI 공통 러너. requireAuth → 핸들러 매핑 실행 → JSON 출력 → exit code.
+ * 핸들러는 ParsedArgs 를 받아 출력할 데이터를 반환한다.
+ */
+export declare function runDomainCli(opts: {
+    binName: string;
+    argv: string[];
+    help: string;
+    handlers: Record<string, (p: ParsedArgs) => Promise<unknown>>;
+}): Promise<void>;

package/dist/lib/cli-args.js

@@ -0,0 +1,96 @@
+// 도메인별 sub-CLI(mimi-seed-firebase / -admob / -ga4)가 공유하는 최소 argv 파서.
+// `mimi-seed <domain> <subcommand> [--flag value] [--bool]` 형태를 파싱한다.
+// 실제 사용자 진입점은 cli 패키지의 `mimi-seed <domain> ...` 이고, 그게 npx 로
+// 이 bin 들을 stdio 그대로 호출한다(auth.ts:runMcpBin 패턴과 동일).
+/** process.argv.slice(2) 같은 토큰 배열을 파싱. */
+export function parseArgs(argv) {
+    const flags = {};
+    const bools = new Set();
+    let command;
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (tok.startsWith('--')) {
+            const eq = tok.indexOf('=');
+            if (eq !== -1) {
+                // --key=value — 값이 '--'로 시작해도 안전하게 전달.
+                flags[tok.slice(2, eq)] = tok.slice(eq + 1);
+                continue;
+            }
+            const key = tok.slice(2);
+            const next = argv[i + 1];
+            // 다음 토큰이 또 다른 플래그(--)면 값으로 소비하지 않는다 → 값 누락을 bool 로 기록.
+            if (next !== undefined && !next.startsWith('--')) {
+                flags[key] = next;
+                i++;
+            }
+            else {
+                bools.add(key);
+            }
+        }
+        else if (command === undefined) {
+            command = tok;
+        }
+    }
+    return { command, flags, bools };
+}
+/** 값 플래그 조회 — 없으면 fallback. */
+export function flag(p, name, fallback) {
+    return p.flags[name] ?? fallback;
+}
+/** 필수 값 플래그 — 없으면 친절 에러 throw. */
+export function requireFlag(p, name) {
+    const v = p.flags[name];
+    if (v === undefined || v === '') {
+        if (p.bools.has(name)) {
+            throw new CliUsageError(`--${name} 에 값이 필요합니다 (값 없이 단독으로 쓰였습니다). 값이 '--'로 시작하면 --${name}=값 형태로 쓰세요.`);
+        }
+        throw new CliUsageError(`--${name} 가 필요합니다.`);
+    }
+    return v;
+}
+/** 쉼표 구분 값 → 배열 ('a, b ,c' → ['a','b','c']). 없으면 undefined. */
+export function flagList(p, name) {
+    const v = p.flags[name];
+    if (!v)
+        return undefined;
+    return v.split(',').map((s) => s.trim()).filter(Boolean);
+}
+/** 사용법 위반 — main()에서 잡아 도움말과 함께 exit 1. */
+export class CliUsageError extends Error {
+}
+/** 결과 JSON 을 stdout 으로 출력 (stderr 는 진행/안내용). */
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+/**
+ * 도메인 sub-CLI 공통 러너. requireAuth → 핸들러 매핑 실행 → JSON 출력 → exit code.
+ * 핸들러는 ParsedArgs 를 받아 출력할 데이터를 반환한다.
+ */
+export async function runDomainCli(opts) {
+    const p = parseArgs(opts.argv);
+    if (!p.command || p.command === 'help' || p.bools.has('help') || p.bools.has('h')) {
+        process.stderr.write(opts.help + '\n');
+        process.exit(p.command ? 0 : 1);
+    }
+    const handler = opts.handlers[p.command];
+    if (!handler) {
+        process.stderr.write(`❌ 알 수 없는 서브커맨드: ${p.command}\n\n` + opts.help + '\n');
+        process.exit(1);
+    }
+    try {
+        const result = await handler(p);
+        printJson(result);
+        process.exit(0);
+    }
+    catch (e) {
+        if (e instanceof CliUsageError) {
+            process.stderr.write(`❌ ${e.message}\n\n` + opts.help + '\n');
+        }
+        else {
+            process.stderr.write(`❌ ${e instanceof Error ? e.message : String(e)}\n`);
+            if (process.env.DEBUG && e instanceof Error)
+                process.stderr.write((e.stack ?? '') + '\n');
+        }
+        process.exit(1);
+    }
+}

package/dist/lib/google-errors.d.ts

@@ -1,5 +1,13 @@
 export declare function extractHttpStatus(e: unknown): number | undefined;
 export declare function rawMessage(e: unknown): string;
+/**
+ * Google API 에러에서 구조화된 실제 사유를 추출한다. GaxiosError는
+ * `response.data.error.{message,errors[].reason}` 에 진짜 원인을 담는데,
+ * 친절화 레이어가 이를 버리고 일반 메시지("권한 없음")로 덮으면, 권한이 멀쩡한데도
+ * 권한 문제로 오진하게 된다 (예: 같은 SA로 이미지 업로드는 되는데 listings.update만 403).
+ * 추출 실패 시 undefined.
+ */
+export declare function googleErrorDetail(e: unknown): string | undefined;
 /** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
 export declare function authReauthMessage(text: string): string | null;
 export declare function withCause(err: Error, cause: unknown): Error;

package/dist/lib/google-errors.js

@@ -26,6 +26,32 @@ export function rawMessage(e) {
         return String(e);
     }
 }
+/**
+ * Google API 에러에서 구조화된 실제 사유를 추출한다. GaxiosError는
+ * `response.data.error.{message,errors[].reason}` 에 진짜 원인을 담는데,
+ * 친절화 레이어가 이를 버리고 일반 메시지("권한 없음")로 덮으면, 권한이 멀쩡한데도
+ * 권한 문제로 오진하게 된다 (예: 같은 SA로 이미지 업로드는 되는데 listings.update만 403).
+ * 추출 실패 시 undefined.
+ */
+export function googleErrorDetail(e) {
+    if (!e || typeof e !== 'object')
+        return undefined;
+    const any = e;
+    const apiErr = any.response?.data?.error;
+    const parts = [];
+    if (apiErr?.message)
+        parts.push(String(apiErr.message));
+    const reasons = apiErr?.errors ?? any.errors;
+    if (Array.isArray(reasons)) {
+        for (const r of reasons) {
+            const bit = [r?.reason, r?.message].filter(Boolean).join(': ');
+            if (bit && !parts.some((p) => p.includes(bit)))
+                parts.push(bit);
+        }
+    }
+    const joined = parts.join(' | ').trim();
+    return joined.length ? joined : undefined;
+}
 /** invalid_grant / 만료 refresh_token / 부족 scope → 재로그인 안내 메시지. 아니면 null. */
 export function authReauthMessage(text) {
     if (/invalid_grant|invalid_rapt|rapt_required|unauthorized_client|ACCESS_TOKEN_SCOPE_INSUFFICIENT|insufficient.*scope/i.test(text)) {

package/dist/lib/project-manifest.d.ts

@@ -0,0 +1,36 @@
+export declare const MANIFEST_FILENAME = ".mimi-seed.json";
+/** 매니페스트가 인지하는 서비스 id. status 매칭 로직이 이 키를 기준으로 동작한다. */
+export type ManifestServiceId = 'oauth' | 'bigquery' | 'playstore' | 'appstore' | 'jenkins';
+export interface ManifestService {
+    /** 이 프로젝트에서 필수인지. false(선택)면 미설정이어도 ❌ 대신 정보 표기. */
+    required?: boolean;
+    /** 사람이 읽을 한 줄 설명. status 출력에 그대로 표시. */
+    note?: string;
+    projectId?: string;
+    dataset?: string;
+    packageName?: string;
+    keyId?: string;
+    issuerId?: string;
+    url?: string;
+    /** 이 서비스가 워크스페이스 공유 시크릿(provider)으로도 제공되는 경우 그 provider id. */
+    workspaceProvider?: string;
+}
+export interface ProjectManifest {
+    project?: string;
+    displayName?: string;
+    description?: string;
+    services?: Partial<Record<ManifestServiceId, ManifestService>>;
+}
+export interface LoadedManifest {
+    manifest: ProjectManifest;
+    /** 실제로 읽은 파일 절대 경로. */
+    filePath: string;
+}
+/**
+ * startDir 에서 위로 올라가며 첫 번째 `.mimi-seed.json` 을 찾는다.
+ * MCP stdio 서버의 cwd 는 보통 프로젝트 루트지만, 하위 폴더에서 실행돼도 잡히게 상향 탐색한다.
+ * maxDepth 로 홈 디렉터리 밖까지 무한 상승하는 것을 방지.
+ */
+export declare function findProjectManifest(startDir?: string, maxDepth?: number): LoadedManifest | null;
+/** 매니페스트 services 를 [id, service] 배열로. 없으면 빈 배열. */
+export declare function manifestServiceEntries(m: ProjectManifest): Array<[ManifestServiceId, ManifestService]>;

package/dist/lib/project-manifest.js

@@ -0,0 +1,52 @@
+// 프로젝트 매니페스트(.mimi-seed.json) 리더.
+//
+// 프로젝트 루트에 커밋된 `.mimi-seed.json` 이 "이 저장소를 mimi-seed 로 다루려면
+// 어떤 서비스 연결이 필요한가"를 선언한다. mimi_seed_status(MCP)와 mimi-seed doctor(CLI)가
+// 이 파일을 읽어, 범용 9종 스캔 대신 "이 프로젝트에서 너한테 빠진 것 + 정확한 셋업 명령"을 보여준다.
+//
+// 팀 온보딩 목적: 새 팀원이 clone → mimi_seed_status 호출 → 안내 따라가기 만으로
+// 자기 머신에 필요한 자격증명을 채울 수 있게 한다.
+import fs from 'node:fs';
+import path from 'node:path';
+export const MANIFEST_FILENAME = '.mimi-seed.json';
+/**
+ * startDir 에서 위로 올라가며 첫 번째 `.mimi-seed.json` 을 찾는다.
+ * MCP stdio 서버의 cwd 는 보통 프로젝트 루트지만, 하위 폴더에서 실행돼도 잡히게 상향 탐색한다.
+ * maxDepth 로 홈 디렉터리 밖까지 무한 상승하는 것을 방지.
+ */
+export function findProjectManifest(startDir = process.cwd(), maxDepth = 8) {
+    let dir = path.resolve(startDir);
+    for (let i = 0; i <= maxDepth; i++) {
+        const candidate = path.join(dir, MANIFEST_FILENAME);
+        if (fs.existsSync(candidate)) {
+            const parsed = safeParse(candidate);
+            if (parsed)
+                return { manifest: parsed, filePath: candidate };
+            return null; // 파일은 있으나 형식 오류 — 상위로 더 올라가지 않는다(의도 명확).
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break; // 루트 도달
+        dir = parent;
+    }
+    return null;
+}
+function safeParse(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const obj = JSON.parse(raw);
+        if (obj && typeof obj === 'object')
+            return obj;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 매니페스트 services 를 [id, service] 배열로. 없으면 빈 배열. */
+export function manifestServiceEntries(m) {
+    const svc = m.services ?? {};
+    return Object.keys(svc)
+        .filter((k) => svc[k] != null)
+        .map((k) => [k, svc[k]]);
+}

package/dist/playstore/errors.js

@@ -2,17 +2,23 @@
 // App Store 의 friendlyAppStoreError 와 대칭 — Play 쪽엔 없던 친절화 레이어.
 // 신규 사용자가 가장 자주 막히는 두 케이스(서비스 계정 권한 403, edit 세션 충돌)에
 // 구체적 복구 단계를 붙인다. 인식 못 한 에러(도메인 에러 포함)는 원본 보존.
-import { extractHttpStatus, authReauthMessage, withCause } from '../lib/google-errors.js';
-// playstore_verify_service_account 의 403 안내와 동일한 체크리스트.
-const PERMISSION_403 = [
-    '❌ Google Play 권한 부족 (403).',
-    '원인: 인증은 됐지만 Play Console에서 이 계정/서비스 계정에 권한이 없어요.',
-    '',
-    '1. Play Console → 사용자 및 권한(Users and permissions)',
-    '2. 이 Google 계정(또는 서비스 계정 이메일)을 초대 / 권한 부여',
-    '3. 앱 권한에 "앱 정보 관리" (재무 데이터 필요 시 "재무 데이터 보기") 부여',
-    '4. 권한 적용까지 ~5분 대기 후 재시도 (너무 빨리 시도하면 계속 403)',
-].join('\n');
+import { extractHttpStatus, authReauthMessage, withCause, googleErrorDetail } from '../lib/google-errors.js';
+// 403 안내. raw Google 사유를 먼저 보여주고, 권한이 멀쩡한데 특정 작업만 거부되는
+// 케이스(같은 SA로 이미지 업로드는 되는데 listings.update만 403 등)를 위해
+// "다른 쓰기가 되면 권한 문제가 아니다"라는 단서를 붙인다. detail 은 googleErrorDetail() 결과.
+function permission403Message(detail) {
+    return [
+        '❌ Google Play 403 — 요청이 거부됐어요.',
+        detail ? `Google 사유: ${detail}` : '',
+        '⚠️ 같은 계정/서비스 계정으로 다른 쓰기(예: 이미지 업로드)가 된다면 권한 문제가 아닐 수 있어요 — 위 Google 사유 또는 앱 상태·정책·작업별 제한을 먼저 확인하세요.',
+        '',
+        '정말 권한 문제라면:',
+        '1. Play Console → 사용자 및 권한(Users and permissions)',
+        '2. 이 Google 계정(또는 서비스 계정 이메일)을 초대 / 권한 부여',
+        '3. 앱 권한에 "앱 정보 관리"(Manage store presence) 부여',
+        '4. 권한 적용까지 ~5분 대기 후 재시도',
+    ].filter((l) => l !== '').join('\n');
+}
 export function friendlyPlayError(e, packageName) {
     const text = e instanceof Error ? e.message : String(e);
     const status = extractHttpStatus(e);
@@ -20,7 +26,7 @@ export function friendlyPlayError(e, packageName) {
     if (reauth)
         return withCause(new Error(reauth), e);
     if (status === 403 || /PERMISSION_DENIED|insufficient permission|forbidden/i.test(text)) {
-        return withCause(new Error(PERMISSION_403), e);
+        return withCause(new Error(permission403Message(googleErrorDetail(e))), e);
     }
     if (status === 404 || /NOT_FOUND|not found/i.test(text)) {
         return withCause(new Error(`❌ 패키지${packageName ? ` (${packageName})` : ''}를 이 개발자 계정에서 찾을 수 없어요.\n→ packageName 철자와 계정 권한을 확인하세요.`), e);

package/dist/registers/admob.js

@@ -35,14 +35,15 @@ export function registerAdmobTools(server) {
         const report = await admob.getNetworkReport(auth, accountId, { year: startYear, month: startMonth, day: startDay }, { year: endYear, month: endMonth, day: endDay });
         return { content: [{ type: 'text', text: JSON.stringify(report, null, 2) }] };
     });
-    server.tool('admob_create_app', 'AdMob에 새 앱 등록 (v1beta — Limited Access)', {
+    server.tool('admob_create_app', 'AdMob에 새 앱 등록 (v1beta — Limited Access). appStoreId 를 주면 스토어 게시 앱과 링크(Android=패키지명, iOS=App Store 숫자 ID), 없으면 manual(unlinked) 앱.', {
         accountId: z.string().describe('AdMob 계정 ID'),
         platform: z.enum(['ANDROID', 'IOS']).describe('플랫폼'),
         displayName: z.string().describe('앱 이름'),
-    }, async ({ accountId, platform, displayName }) => {
+        appStoreId: z.string().optional().describe('스토어 링크용 ID — Android는 패키지명(com.x.y), iOS는 App Store 숫자 ID'),
+    }, async ({ accountId, platform, displayName, appStoreId }) => {
         const auth = await requireAuth();
         try {
-            const result = await admob.createApp(auth, accountId, platform, displayName);
+            const result = await admob.createApp(auth, accountId, platform, displayName, appStoreId);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         }
         catch (err) {

package/dist/registers/auth.js

@@ -7,7 +7,8 @@ import { loadCiConfig } from '../ci/config.js';
 import { loadConfig as loadGoogleAdsConfig } from '../googleads/config.js';
 import { loadFacebookConfig } from '../facebook/config.js';
 import { loadInstagramConfig } from '../instagram/config.js';
-import { getBigQueryServiceAccountKey } from '../auth/bigquery-auth.js';
+import { resolveBigQueryAuth } from '../auth/bigquery-auth.js';
+import { findProjectManifest, manifestServiceEntries, } from '../lib/project-manifest.js';
 /**
  * tokens.json mtime → "Nd Hh ago" 형식 문자열 + 재인증 권고.
  * Google 정책: 7일 미사용 시 미인증 앱 refresh_token revoke 가능.
@@ -34,6 +35,54 @@ function formatLastRefreshHint(lastMs) {
     }
     return { label };
 }
+// 매니페스트 서비스별 셋업 명령. status/doctor 가 "정확한 다음 명령"으로 안내한다.
+const MANIFEST_FIX = {
+    oauth: () => 'mimi_seed_auth_start  (Google 로그인 — Firebase/AdMob/Play/GSC/GA4)',
+    bigquery: () => 'npx -y @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth  (서비스 계정 권장)',
+    playstore: (svc) => svc.packageName
+        ? `setup_playstore_connection(packageName="${svc.packageName}")`
+        : 'setup_playstore_connection(packageName=...)',
+    appstore: () => 'npx -y @yoonion/mimi-seed-mcp mimi-seed-appstore-auth',
+    jenkins: () => 'claude mcp add virgm-jenkins -s user  (개인 자격증명 — .mcp.json 금지)',
+};
+/** 서비스별 식별자를 한 줄 detail 로 (예: "ads-coffee / analytics_530080532"). */
+function manifestServiceDetail(id, svc) {
+    const parts = [];
+    if (id === 'bigquery') {
+        if (svc.projectId)
+            parts.push(svc.projectId);
+        if (svc.dataset)
+            parts.push(svc.dataset);
+    }
+    else if (id === 'playstore') {
+        if (svc.packageName)
+            parts.push(svc.packageName);
+    }
+    else if (id === 'appstore') {
+        if (svc.keyId)
+            parts.push(`keyId ${svc.keyId}`);
+    }
+    else if (id === 'jenkins') {
+        if (svc.url)
+            parts.push(svc.url);
+    }
+    return parts.join(' / ');
+}
+/** 매니페스트 한 서비스를 status 라인(들)으로 렌더. 미설정+필수면 명령 힌트를 붙인다. */
+function renderManifestLine(id, svc, connected, required) {
+    const label = id.padEnd(10);
+    const detail = manifestServiceDetail(id, svc);
+    const detailSuffix = detail ? ` (${detail})` : '';
+    if (connected)
+        return `✅ ${label} — 연결됨${detailSuffix}`;
+    if (!required) {
+        const note = svc.note ? ` — ${svc.note}` : '';
+        return `ℹ️  ${label} — (선택)${detailSuffix}${note}`;
+    }
+    const fix = MANIFEST_FIX[id](svc);
+    const noteLine = svc.note ? `\n     ${svc.note}` : '';
+    return `❌ ${label} — 미설정${detailSuffix}\n     → ${fix}${noteLine}`;
+}
 export function registerAuthTools(server) {
     // ── 전체 연결 상태 진단 ────────────────────────────────────────────────────
     server.tool('mimi_seed_status', [
@@ -114,10 +163,14 @@ export function registerAuthTools(server) {
         else {
             lines.push('❌ Instagram         — 미설정 → instagram_save_config  (선택)');
         }
-        // 9. BigQuery
-        const bq = getBigQueryServiceAccountKey();
-        if (bq) {
-            lines.push(`✅ BigQuery          — 서비스 계정 연결됨 (${bq.client_email ?? ''})`);
+        // 9. BigQuery — resolveBigQueryAuth 기준(서비스 계정 우선, OAuth fallback).
+        // 이전엔 SA 파일만 검사해 OAuth fallback 이 살아있어도 ❌ 로 오표기했다.
+        const bqAuth = resolveBigQueryAuth();
+        if (bqAuth?.source === 'service-account') {
+            lines.push(`✅ BigQuery          — 서비스 계정 연결됨 (${bqAuth.clientEmail ?? ''})`);
+        }
+        else if (bqAuth?.source === 'user-oauth') {
+            lines.push('⚠️  BigQuery          — OAuth fallback (Workspace 재인증 정책 시 끊길 수 있음 → 서비스 계정 권장: mimi-seed-bigquery-auth)');
         }
         else {
             lines.push('❌ BigQuery          — 미설정 → npx @yoonion/mimi-seed-mcp mimi-seed-bigquery-auth  (선택)');
@@ -139,6 +192,36 @@ export function registerAuthTools(server) {
         else {
             lines.push('', '✅ 필수 연결 모두 완료. 앱 출시 작업을 시작할 수 있습니다.');
         }
+        // ── 프로젝트 매니페스트(.mimi-seed.json) 기반 요구사항 ────────────────────
+        // 이 저장소가 "무엇을 필요로 하는가"를 선언해두면, 범용 스캔 대신
+        // "이 프로젝트에서 너한테 빠진 것 + 정확한 셋업 명령"을 팀원별로 보여준다.
+        const loaded = findProjectManifest();
+        if (loaded) {
+            const oauthOk = oauthResult.status === 'fresh' || oauthResult.status === 'refreshed';
+            const playstoreCovers = (pkg) => saCount > 0 &&
+                (!pkg || !!saInfo.default || saInfo.perPackage.some((p) => p.packageName === pkg));
+            const state = {
+                oauth: oauthOk,
+                bigquery: !!bqAuth,
+                playstore: playstoreCovers(),
+                appstore: !!asc,
+                jenkins: !!jenkins,
+            };
+            const projName = loaded.manifest.displayName ?? loaded.manifest.project ?? '이 프로젝트';
+            const reqLines = ['', `── ${projName} 요구사항 (.mimi-seed.json) ─────────`];
+            let anyMissing = false;
+            for (const [id, svc] of manifestServiceEntries(loaded.manifest)) {
+                const required = svc.required !== false;
+                const connected = id === 'playstore' ? playstoreCovers(svc.packageName) : state[id];
+                reqLines.push(renderManifestLine(id, svc, connected, required));
+                if (required && !connected)
+                    anyMissing = true;
+            }
+            if (anyMissing) {
+                reqLines.push('', 'ℹ️  팀 공유가 목표라면, 각자 로컬 자격증명을 채우는 대신', '   워크스페이스(https://mimi-seed.pryzm.gg) 초대 → PAT 발급 → 원격 MCP 연결도 가능.');
+            }
+            lines.push(...reqLines);
+        }
         return { content: [{ type: 'text', text: lines.join('\n') }] };
     });
     server.tool('mimi_seed_auth_start', [