adyou 0.3.0

package/dist/core/site.d.ts

@@ -0,0 +1,30 @@
+export type SiteSnapshot = {
+    url: string;
+    finalUrl: string;
+    status: number;
+    title: string;
+    description: string;
+    lang: string;
+    ogImage: string | null;
+    logo: string | null;
+    themeColor: string | null;
+    colors: string[];
+    headings: string[];
+    prices: string[];
+    text: string;
+    hasFbq: boolean;
+    pixelIds: string[];
+    gtagIds: string[];
+    ga4Ids: string[];
+    csp: string | null;
+    utmPreserved: boolean | null;
+};
+export declare function fetchHtml(url: string, timeoutMs?: number): Promise<{
+    html: string;
+    status: number;
+    finalUrl: string;
+    headers: Headers;
+}>;
+export declare function decode(s: string): string;
+export declare function stripHtml(html: string): string;
+export declare function readSite(url: string): Promise<SiteSnapshot>;

package/dist/core/site.js

@@ -0,0 +1,80 @@
+const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0 Safari/537.36 adpilot/0.1';
+export async function fetchHtml(url, timeoutMs = 20_000) {
+    const res = await fetch(url, { headers: { 'user-agent': UA, accept: 'text/html,*/*' }, redirect: 'follow', signal: AbortSignal.timeout(timeoutMs) });
+    const html = await res.text();
+    return { html, status: res.status, finalUrl: res.url || url, headers: res.headers };
+}
+function attr(tag, name) { const m = tag.match(new RegExp(`\\s${name}\\s*=\\s*("([^"]*)"|'([^']*)'|([^\\s>]+))`, 'i')); return m ? (m[2] ?? m[3] ?? m[4] ?? '') : null; }
+function meta(html, key) {
+    const tags = html.match(/<meta\b[^>]*>/gi) || [];
+    for (const t of tags) {
+        const n = (attr(t, 'property') || attr(t, 'name') || '').toLowerCase();
+        if (n === key.toLowerCase())
+            return decode(attr(t, 'content') || '');
+    }
+    return null;
+}
+export function decode(s) { return s.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;|&apos;/g, "'").replace(/&nbsp;/g, ' ').replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d))); }
+function abs(base, href) { if (!href)
+    return null; try {
+    return new URL(href, base).toString();
+}
+catch {
+    return null;
+} }
+export function stripHtml(html) {
+    return decode(html.replace(/<script[\s\S]*?<\/script>/gi, ' ').replace(/<style[\s\S]*?<\/style>/gi, ' ').replace(/<noscript[\s\S]*?<\/noscript>/gi, ' ').replace(/<[^>]+>/g, ' ')).replace(/\s+/g, ' ').trim();
+}
+export async function readSite(url) {
+    const { html, status, finalUrl, headers } = await fetchHtml(url);
+    const title = decode((html.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1] || meta(html, 'og:title') || '').trim());
+    const description = meta(html, 'description') || meta(html, 'og:description') || '';
+    const lang = (html.match(/<html[^>]*\slang\s*=\s*["']?([a-zA-Z-]+)/i)?.[1] || meta(html, 'og:locale') || '').toLowerCase().slice(0, 2);
+    const ogImage = abs(finalUrl, meta(html, 'og:image'));
+    const links = html.match(/<link\b[^>]*>/gi) || [];
+    let logo = null;
+    for (const l of links) {
+        const rel = (attr(l, 'rel') || '').toLowerCase();
+        if (/apple-touch-icon/.test(rel)) {
+            logo = abs(finalUrl, attr(l, 'href'));
+            break;
+        }
+    }
+    if (!logo)
+        for (const l of links) {
+            const rel = (attr(l, 'rel') || '').toLowerCase();
+            if (/\bicon\b/.test(rel) && !/mask/.test(rel)) {
+                const h = attr(l, 'href');
+                if (h && !/\.ico(\?|$)/i.test(h)) {
+                    logo = abs(finalUrl, h);
+                    break;
+                }
+            }
+        }
+    if (!logo) {
+        const img = (html.match(/<img\b[^>]*>/gi) || []).find((t) => /logo/i.test(t));
+        if (img)
+            logo = abs(finalUrl, attr(img, 'src'));
+    }
+    const themeColor = meta(html, 'theme-color');
+    const colors = [...new Set([...(html.match(/#[0-9a-fA-F]{6}\b/g) || [])].map((c) => c.toLowerCase()).filter((c) => !/^#(fff|000|ffffff|000000)/.test(c)))].slice(0, 12);
+    const headings = [...new Set((html.match(/<h[1-3][^>]*>([\s\S]*?)<\/h[1-3]>/gi) || []).map((h) => stripHtml(h)).filter((h) => h.length > 1 && h.length < 120))].slice(0, 20);
+    const text = stripHtml(html).slice(0, 6000);
+    const prices = [...new Set((text.match(/(?:₩|\$|€|£|¥)\s?\d[\d,]*(?:\.\d+)?|\d[\d,]*\s?(?:원|달러|만원)/g) || []))].slice(0, 12);
+    const pixelIds = [...new Set([...html.matchAll(/fbq\(\s*['"]init['"]\s*,\s*['"](\d{8,20})['"]/g)].map((m) => m[1]))];
+    const gtagIds = [...new Set([...html.matchAll(/\b(AW-\d{6,12})\b/g)].map((m) => m[1]))];
+    const ga4Ids = [...new Set([...html.matchAll(/\b(G-[A-Z0-9]{6,12})\b/g)].map((m) => m[1]))];
+    const csp = headers.get('content-security-policy') || (html.match(/<meta[^>]*http-equiv\s*=\s*["']content-security-policy["'][^>]*content\s*=\s*["']([^"']+)/i)?.[1] ?? null);
+    // UTM 보존: utm을 붙여 요청했을 때 최종 URL에 utm이 남는가(301이 쿼리를 지우는지)
+    let utmPreserved = null;
+    try {
+        const u = new URL(url);
+        u.searchParams.set('utm_source', 'adpilot_check');
+        const r = await fetch(u, { headers: { 'user-agent': UA }, redirect: 'follow', signal: AbortSignal.timeout(15_000) });
+        utmPreserved = /utm_source=adpilot_check/.test(r.url);
+    }
+    catch {
+        utmPreserved = null;
+    }
+    return { url, finalUrl, status, title, description, lang: lang || 'ko', ogImage, logo, themeColor, colors, headings, prices, text, hasFbq: /fbq\(/.test(html), pixelIds, gtagIds, ga4Ids, csp, utmPreserved };
+}

package/dist/core/state.d.ts

@@ -0,0 +1,162 @@
+export declare const HOME: string;
+export declare const PROJECTS: string;
+export type MetaCreds = {
+    accessToken: string;
+    adAccountId: string;
+    pageId?: string;
+    instagramActorId?: string;
+    pixelId?: string;
+    appId?: string;
+};
+export type GoogleCreds = {
+    serviceAccountJson: string;
+    customerId: string;
+    loginCustomerId?: string;
+};
+export type Credentials = {
+    meta?: MetaCreds;
+    google?: GoogleCreds;
+};
+export type Config = {
+    llm?: {
+        baseUrl?: string;
+        apiKey?: string;
+        model?: string;
+    };
+    image?: {
+        provider?: 'openai';
+        apiKey?: string;
+        model?: string;
+    };
+    /** 원화 기준 환율 — 매체 계정 통화가 KRW가 아닐 때 예산 환산에 쓴다 */
+    fx?: Record<string, number>;
+    lastProject?: string;
+};
+export type Goal = 'traffic' | 'lead' | 'signup' | 'purchase';
+export type Market = {
+    country: string;
+    language: string;
+};
+export type Brief = {
+    url: string;
+    company: string;
+    offer: string;
+    category: string;
+    audience: string[];
+    usp: string[];
+    tone: string;
+    language: string;
+    palette: {
+        primary: string;
+        dark: string;
+        light: string;
+    };
+    logoUrl?: string | null;
+    ogImage?: string | null;
+    specialCategory?: string | null;
+    confirmed?: boolean;
+    notes?: string;
+};
+export type Concept = {
+    key: string;
+    name: string;
+    angle: string;
+    headlines: string[];
+    bodies: string[];
+    descriptions: string[];
+    cta: string;
+    imagePrompt: string;
+    theme: 'dark' | 'light';
+};
+export type CreativeAsset = {
+    concept: string;
+    w: number;
+    h: number;
+    ratio: string;
+    file: string;
+    medium: 'meta' | 'google' | 'both';
+};
+export type PlanMedium = {
+    medium: 'meta' | 'google';
+    share: number;
+    dailyBudgetKrw: number;
+    currency: string;
+    dailyBudgetMinor: number;
+    note: string;
+};
+export type Plan = {
+    monthlyKrw: number;
+    dailyKrw: number;
+    media: PlanMedium[];
+    concepts: string[];
+    markets: Market[];
+    goal: Goal;
+    endDate?: string;
+    explain: string;
+    createdAt: string;
+};
+export type Placement = {
+    medium: 'meta' | 'google';
+    kind: string;
+    concept?: string;
+    externalId: string;
+    name: string;
+    status: string;
+    createdAt: string;
+};
+export type ProjectStatus = 'draft' | 'briefed' | 'creatives' | 'planned' | 'built' | 'live' | 'paused' | 'ended';
+export type Project = {
+    slug: string;
+    url: string;
+    createdAt: string;
+    status: ProjectStatus;
+    budget: {
+        monthlyKrw: number;
+        goal: Goal;
+        markets: Market[];
+        endDate?: string;
+        autoApprove?: boolean;
+    };
+    brief?: Brief;
+    concepts?: Concept[];
+    assets?: CreativeAsset[];
+    plan?: Plan;
+    placements: Placement[];
+    tracking?: {
+        pixelId?: string;
+        gtagId?: string;
+        gtagLabel?: string;
+        ga4Id?: string;
+        conversionActionRn?: string;
+    };
+    approvedAt?: string;
+    launchedAt?: string;
+};
+export declare function loadConfig(): Config;
+export declare function saveConfig(c: Config): void;
+export declare function loadCredentials(): Credentials;
+export declare function saveCredentials(c: Credentials): void;
+/** 환경변수 > credentials.json. 오늘 키트의 ~/.config/adsctl/meta.env 변수명(ACCESS_TOKEN·AD_ACCOUNT_ID…)도 그대로 읽는다. */
+export declare function metaCreds(): MetaCreds | null;
+export declare function googleCreds(): GoogleCreds | null;
+export declare function slugOf(url: string): string;
+export declare function projectDir(slug: string): string;
+export declare function creativesDir(slug: string): string;
+export declare function listProjects(): string[];
+export declare function loadProject(slug: string): Project | null;
+export declare function saveProject(p: Project): void;
+/** 현재 프로젝트: --project > 현재 폴더 .adpilot.json > 마지막 사용 > 유일한 하나 */
+export declare function resolveProject(explicit?: string): Project;
+export declare function newProject(url: string, budget: Project['budget']): Project;
+export type Decision = {
+    at: string;
+    kind: string;
+    medium?: string;
+    target?: string;
+    action: string;
+    reason?: string;
+    by: 'user' | 'rule' | 'llm';
+    data?: unknown;
+};
+export declare function logDecision(slug: string, d: Omit<Decision, 'at'>): void;
+export declare function readDecisions(slug: string): Decision[];

package/dist/core/state.js

@@ -0,0 +1,110 @@
+// 로컬 상태 — 모든 것은 광고주 기기의 ~/.adpilot/ 아래에. 키는 credentials.json(0600), 프로젝트는 projects/<slug>/.
+//   ~/.adpilot/config.json          LLM·이미지 생성 키·기본값(환경변수가 우선)
+//   ~/.adpilot/credentials.json     매체 자격(meta·google) — 0600
+//   ~/.adpilot/projects/<slug>/project.json  브리프·예산·계획·매체 id·상태
+//   ~/.adpilot/projects/<slug>/creatives/    합성된 소재 PNG · copy.json
+//   ~/.adpilot/projects/<slug>/decisions.jsonl  모든 mutate·자동 조치 감사 로그
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+export const HOME = process.env.ADPILOT_HOME || path.join(os.homedir(), '.adpilot');
+export const PROJECTS = path.join(HOME, 'projects');
+function ensureDir(p) { fs.mkdirSync(p, { recursive: true, mode: 0o700 }); }
+function readJson(file, fallback) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+function writeJson(file, data, mode = 0o644) {
+    ensureDir(path.dirname(file));
+    const tmp = file + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify(data, null, 2), { mode });
+    fs.renameSync(tmp, file);
+}
+export function loadConfig() { return readJson(path.join(HOME, 'config.json'), {}); }
+export function saveConfig(c) { writeJson(path.join(HOME, 'config.json'), c, 0o600); }
+export function loadCredentials() { return readJson(path.join(HOME, 'credentials.json'), {}); }
+export function saveCredentials(c) { writeJson(path.join(HOME, 'credentials.json'), c, 0o600); }
+/** 환경변수 > credentials.json. 오늘 키트의 ~/.config/adsctl/meta.env 변수명(ACCESS_TOKEN·AD_ACCOUNT_ID…)도 그대로 읽는다. */
+export function metaCreds() {
+    const f = loadCredentials().meta;
+    const accessToken = process.env.META_ACCESS_TOKEN || process.env.ACCESS_TOKEN || f?.accessToken;
+    const adAccountId = process.env.META_AD_ACCOUNT_ID || process.env.AD_ACCOUNT_ID || f?.adAccountId;
+    if (!accessToken || !adAccountId)
+        return null;
+    return {
+        accessToken, adAccountId: adAccountId.startsWith('act_') ? adAccountId : `act_${adAccountId}`,
+        pageId: process.env.META_PAGE_ID || process.env.PAGE_ID || f?.pageId,
+        instagramActorId: process.env.META_INSTAGRAM_ACTOR_ID || process.env.INSTAGRAM_ACTOR_ID || f?.instagramActorId,
+        pixelId: process.env.META_PIXEL_ID || process.env.PIXEL_ID || f?.pixelId,
+        appId: process.env.META_APP_ID || f?.appId,
+    };
+}
+export function googleCreds() {
+    const f = loadCredentials().google;
+    const serviceAccountJson = process.env.GOOGLE_ADS_SA_JSON || f?.serviceAccountJson;
+    const customerId = (process.env.GOOGLE_ADS_CUSTOMER_ID || f?.customerId || '').replace(/-/g, '');
+    if (!serviceAccountJson || !customerId)
+        return null;
+    return { serviceAccountJson, customerId, loginCustomerId: (process.env.GOOGLE_ADS_LOGIN_CUSTOMER_ID || f?.loginCustomerId || '').replace(/-/g, '') || undefined };
+}
+export function slugOf(url) {
+    try {
+        const h = new URL(url).hostname.replace(/^www\./, '');
+        return h.replace(/[^a-z0-9]+/gi, '-').replace(/^-|-$/g, '').toLowerCase() || 'site';
+    }
+    catch {
+        return 'site';
+    }
+}
+export function projectDir(slug) { return path.join(PROJECTS, slug); }
+export function creativesDir(slug) { const d = path.join(projectDir(slug), 'creatives'); ensureDir(d); return d; }
+export function listProjects() {
+    try {
+        return fs.readdirSync(PROJECTS).filter((s) => fs.existsSync(path.join(PROJECTS, s, 'project.json')));
+    }
+    catch {
+        return [];
+    }
+}
+export function loadProject(slug) { return readJson(path.join(projectDir(slug), 'project.json'), null); }
+export function saveProject(p) {
+    writeJson(path.join(projectDir(p.slug), 'project.json'), p);
+    const c = loadConfig();
+    if (c.lastProject !== p.slug) {
+        c.lastProject = p.slug;
+        saveConfig(c);
+    }
+}
+/** 현재 프로젝트: --project > 현재 폴더 .adpilot.json > 마지막 사용 > 유일한 하나 */
+export function resolveProject(explicit) {
+    const local = readJson(path.join(process.cwd(), '.adpilot.json'), {});
+    const slug = explicit || process.env.ADPILOT_PROJECT || local.project || loadConfig().lastProject || (listProjects().length === 1 ? listProjects()[0] : undefined);
+    const p = slug ? loadProject(slug) : null;
+    if (!p)
+        throw new Error(slug ? `프로젝트 「${slug}」 가 없어요. \`adpilot brief <url>\` 로 먼저 만들어 주세요.` : '프로젝트가 없어요. `adpilot brief <url>` 로 먼저 만들어 주세요.');
+    return p;
+}
+export function newProject(url, budget) {
+    const slug = slugOf(url);
+    const existing = loadProject(slug);
+    const p = existing ? { ...existing, url, budget: { ...existing.budget, ...budget } } : { slug, url, createdAt: new Date().toISOString(), status: 'draft', budget, placements: [] };
+    saveProject(p);
+    return p;
+}
+export function logDecision(slug, d) {
+    const file = path.join(projectDir(slug), 'decisions.jsonl');
+    ensureDir(path.dirname(file));
+    fs.appendFileSync(file, JSON.stringify({ at: new Date().toISOString(), ...d }) + '\n');
+}
+export function readDecisions(slug) {
+    try {
+        return fs.readFileSync(path.join(projectDir(slug), 'decisions.jsonl'), 'utf8').split('\n').filter(Boolean).map((l) => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}

package/dist/core/tracking.d.ts

@@ -0,0 +1,19 @@
+import type { CheckItem } from '../adapters/types.js';
+import type { Project } from './state.js';
+export type TrackingIds = {
+    pixelId?: string;
+    gtagId?: string;
+    gtagLabel?: string;
+    ga4Id?: string;
+};
+export declare function snippet(ids: TrackingIds, opts?: {
+    goal: string;
+    spa?: boolean;
+}): {
+    head: string;
+    conversion: string;
+    csp: string[];
+};
+/** 랜딩 정적 검증 — 태그 존재·CSP·UTM 보존·SPA 여부 */
+export declare function verifyLanding(url: string, ids: TrackingIds): Promise<CheckItem[]>;
+export declare function idsOf(p: Project): TrackingIds;

package/dist/core/tracking.js

@@ -0,0 +1,45 @@
+import { readSite } from './site.js';
+export function snippet(ids, opts = { goal: 'traffic' }) {
+    const parts = ['<!-- adpilot tracking · 모든 페이지 <head> · 이 블록 하나면 픽셀·구글 태그·UTM 보존이 끝나요 -->', '<script>', `(function(){var q=location.search;if(/utm_/.test(q)){try{sessionStorage.setItem('adp_utm',q)}catch(e){}}window.__adpUtm=function(){try{return sessionStorage.getItem('adp_utm')||''}catch(e){return ''}};})();`, '</script>'];
+    if (ids.pixelId)
+        parts.push(`<script>!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){n.callMethod?n.callMethod.apply(n,arguments):n.queue.push(arguments)};if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';n.queue=[];t=b.createElement(e);t.async=!0;t.src=v;s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,document,'script','https://connect.facebook.net/en_US/fbevents.js');fbq('init','${ids.pixelId}');fbq('track','PageView');</script>`);
+    const gid = ids.gtagId || ids.ga4Id;
+    if (gid) {
+        parts.push(`<script async src="https://www.googletagmanager.com/gtag/js?id=${gid}"></script>`);
+        parts.push(`<script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments)}gtag('js',new Date());${ids.gtagId ? `gtag('config','${ids.gtagId}');` : ''}${ids.ga4Id ? `gtag('config','${ids.ga4Id}');` : ''}</script>`);
+    }
+    if (opts.spa)
+        parts.push(`<script>(function(){var p=history.pushState;history.pushState=function(){p.apply(this,arguments);window.fbq&&fbq('track','PageView');window.gtag&&gtag('event','page_view')};window.addEventListener('hashchange',function(){window.fbq&&fbq('track','PageView')})})();</script>`);
+    const ev = opts.goal === 'purchase' ? 'Purchase' : opts.goal === 'lead' ? 'Lead' : opts.goal === 'signup' ? 'CompleteRegistration' : 'ViewContent';
+    const conversion = [`<!-- 목표 달성 화면(${opts.goal === 'purchase' ? '결제 완료' : opts.goal === 'lead' ? '문의 접수 완료' : opts.goal === 'signup' ? '가입 완료' : '핵심 페이지'})에서 1회 · value·currency·orderId는 실제 값으로 -->`, `<script>(function(){var id=String(window.__adpOrderId||Date.now());try{if(localStorage.getItem('adp_conv_'+id))return;localStorage.setItem('adp_conv_'+id,'1')}catch(e){}`];
+    if (ids.pixelId)
+        conversion.push(`window.fbq&&fbq('track','${ev}',{value:window.__adpValue||0,currency:window.__adpCurrency||'KRW'},{eventID:id});`);
+    if (ids.gtagId && ids.gtagLabel)
+        conversion.push(`window.gtag&&gtag('event','conversion',{send_to:'${ids.gtagId}/${ids.gtagLabel}',value:window.__adpValue||0,currency:window.__adpCurrency||'KRW',transaction_id:id});`);
+    if (ids.ga4Id)
+        conversion.push(`window.gtag&&gtag('event','${opts.goal === 'purchase' ? 'purchase' : opts.goal === 'lead' ? 'generate_lead' : opts.goal === 'signup' ? 'sign_up' : 'view_item'}',{value:window.__adpValue||0,currency:window.__adpCurrency||'KRW',transaction_id:id});`);
+    conversion.push('})();</script>');
+    const csp = [...(ids.pixelId ? ['https://connect.facebook.net', 'https://www.facebook.com'] : []), ...(gid ? ['https://www.googletagmanager.com', 'https://www.googleadservices.com', 'https://googleads.g.doubleclick.net', 'https://www.google.com', 'https://www.google-analytics.com'] : [])];
+    return { head: parts.join('\n'), conversion: conversion.join('\n'), csp };
+}
+/** 랜딩 정적 검증 — 태그 존재·CSP·UTM 보존·SPA 여부 */
+export async function verifyLanding(url, ids) {
+    const s = await readSite(url);
+    const items = [];
+    items.push({ key: 'landing.reach', ok: s.status < 400, title: '랜딩 응답', detail: `HTTP ${s.status} · ${s.finalUrl}` });
+    if (ids.pixelId)
+        items.push({ key: 'landing.pixel', ok: s.pixelIds.includes(ids.pixelId), title: `메타 픽셀 ${ids.pixelId} 설치`, detail: s.pixelIds.length ? `발견된 픽셀: ${s.pixelIds.join(', ')}` : s.hasFbq ? 'fbq는 있지만 init 픽셀 id를 못 읽었어요(동적 로드일 수 있음)' : '픽셀 코드가 없어요', fix: s.pixelIds.includes(ids.pixelId) ? undefined : '`adpilot track install` 스니펫을 <head> 에 넣어 주세요.' });
+    if (ids.gtagId)
+        items.push({ key: 'landing.gtag', ok: s.gtagIds.includes(ids.gtagId), title: `구글 태그 ${ids.gtagId} 설치`, detail: s.gtagIds.length ? `발견: ${s.gtagIds.join(', ')}` : '구글 태그가 없어요', fix: s.gtagIds.includes(ids.gtagId) ? undefined : '`adpilot track install` 스니펫을 <head> 에 넣어 주세요.' });
+    if (ids.ga4Id)
+        items.push({ key: 'landing.ga4', ok: s.ga4Ids.includes(ids.ga4Id), title: `GA4 ${ids.ga4Id} 설치`, detail: s.ga4Ids.join(', ') || '없음' });
+    items.push({ key: 'landing.utm', ok: s.utmPreserved, title: 'UTM 보존(리다이렉트가 쿼리를 지우지 않음)', detail: s.utmPreserved === null ? '확인 실패' : s.utmPreserved ? '보존됨' : '최종 URL에서 utm이 사라졌어요', fix: s.utmPreserved === false ? '301/302 규칙과 `?ref=` 같은 자체 쿼리 처리 코드가 utm을 지우는지 확인해 주세요.' : undefined });
+    if (s.csp) {
+        const need = snippet(ids).csp.filter((d) => !s.csp.includes(new URL(d).hostname));
+        items.push({ key: 'landing.csp', ok: !need.length, title: 'CSP script-src에 매체 도메인', detail: need.length ? `빠짐: ${need.join(', ')}` : '허용됨', fix: need.length ? 'Content-Security-Policy의 script-src·connect-src·img-src에 위 도메인을 추가해 주세요.' : undefined });
+    }
+    const spa = /<div id="(root|app|__next)"/.test(s.text) || /__NEXT_DATA__|data-reactroot|ng-version/.test(s.text);
+    items.push({ key: 'landing.spa', ok: null, title: 'SPA 여부', detail: spa ? 'SPA로 보여요 — 경로가 바뀔 때 PageView를 수동으로 보내야 해요(스니펫의 --spa 옵션)' : '일반 페이지' });
+    return items;
+}
+export function idsOf(p) { return { pixelId: p.tracking?.pixelId, gtagId: p.tracking?.gtagId, gtagLabel: p.tracking?.gtagLabel, ga4Id: p.tracking?.ga4Id }; }

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './core/state.js';
+export * from './core/money.js';
+export * from './core/llm.js';
+export * from './core/site.js';
+export * from './core/brief.js';
+export { SIZES, BG_RATIOS, wlen, fit, GOOGLE_LIMITS, GOOGLE_CTA, META_CTA, ctaFor, policyIssues, checkCopy, type Size, type CopyCheck } from './core/creatives/specs.js';
+export * from './core/creatives/copy.js';
+export * from './core/creatives/images.js';
+export * from './core/creatives/render.js';
+export { computePlan, type PlanInput } from './core/plan.js';
+export * from './core/optimize.js';
+export * from './core/report.js';
+export * from './core/tracking.js';
+export * from './core/check.js';
+export * from './adapters/types.js';
+export { MetaConnector } from './adapters/meta.js';
+export { GoogleConnector, GEO, LANG } from './adapters/google.js';
+export { MockConnector } from './adapters/mock.js';

package/dist/index.js

@@ -0,0 +1,19 @@
+// 라이브러리 진입점 — 웹 SaaS 등이 코어를 재사용한다.
+export * from './core/state.js';
+export * from './core/money.js';
+export * from './core/llm.js';
+export * from './core/site.js';
+export * from './core/brief.js';
+export { SIZES, BG_RATIOS, wlen, fit, GOOGLE_LIMITS, GOOGLE_CTA, META_CTA, ctaFor, policyIssues, checkCopy } from './core/creatives/specs.js';
+export * from './core/creatives/copy.js';
+export * from './core/creatives/images.js';
+export * from './core/creatives/render.js';
+export { computePlan } from './core/plan.js';
+export * from './core/optimize.js';
+export * from './core/report.js';
+export * from './core/tracking.js';
+export * from './core/check.js';
+export * from './adapters/types.js';
+export { MetaConnector } from './adapters/meta.js';
+export { GoogleConnector, GEO, LANG } from './adapters/google.js';
+export { MockConnector } from './adapters/mock.js';

package/dist/mcp.d.ts

@@ -0,0 +1 @@
+export declare function startMcp(): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,130 @@
+// MCP 서버(stdio) — CLI와 같은 작업층을 툴로 노출. Claude Code: `claude mcp add adpilot -- npx adpilot-cli mcp`
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { connectedMedia } from './adapters/index.js';
+import { formatCheck, runCheck } from './core/check.js';
+import { fmtKrw } from './core/money.js';
+import { opAudit, opBrief, opBuild, opChange, opCreatives, opLaunch, opOptimize, opPause, opPlan, opPreview, opReport, opStatus, opTrackSnippet } from './core/ops.js';
+import { tableOf } from './core/report.js';
+import { listProjects, loadProject, resolveProject } from './core/state.js';
+import { idsOf, verifyLanding } from './core/tracking.js';
+const text = (s) => ({ content: [{ type: 'text', text: s }] });
+const err = (e) => ({ content: [{ type: 'text', text: `오류: ${e instanceof Error ? e.message : String(e)}${e?.hint ? `\n→ ${e.hint}` : ''}` }], isError: true });
+const proj = (slug) => resolveProject(slug);
+const mediaZ = z.array(z.enum(['meta', 'google'])).optional();
+export async function startMcp() {
+    const server = new McpServer({ name: 'adyou', version: '0.3.0' });
+    server.registerTool('adyou_check', { description: '매체 자격·계정·픽셀·랜딩을 실측 검사하고 실패 항목마다 어느 화면에서 무엇을 누를지 알려 준다. 처음 연결할 때·문제 생겼을 때.', inputSchema: { project: z.string().optional(), media: mediaZ } }, async (a) => { try {
+        let p = null;
+        try {
+            p = proj(a.project);
+        }
+        catch { /* none */ }
+        const { items } = await runCheck(p, { media: a.media });
+        return text(`연결된 매체: ${connectedMedia().join(', ') || '없음'}\n${formatCheck(items)}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_brief', { description: '사이트 주소와 월 예산(원)·목표로 광고 브리프를 만든다(프로젝트 생성). 결과 설명을 사용자에게 보여 주고 맞는지 확인받는다.', inputSchema: { url: z.string(), budgetKrw: z.number(), goal: z.enum(['traffic', 'lead', 'signup', 'purchase']).default('traffic'), markets: z.string().optional().describe('예 "KR" 또는 "US:en,JP:ja"'), hints: z.string().optional(), endDate: z.string().optional() } }, async (a) => { try {
+        const { project, explain } = await opBrief(a.url, { budget: a.budgetKrw, goal: a.goal, markets: a.markets, hints: a.hints, endDate: a.endDate });
+        return text(`${explain}\n\n프로젝트 slug: ${project.slug}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_creatives', { description: '컨셉·카피 생성 + 배경 이미지 + 12규격 소재 합성 + 규격 검사. feedback을 주면 그 방향으로 전부 다시 만든다.', inputSchema: { project: z.string().optional(), concepts: z.number().optional(), feedback: z.string().optional(), imagesFolder: z.string().optional(), noImages: z.boolean().optional() } }, async (a) => { try {
+        const logs = [];
+        const { project, report } = await opCreatives(proj(a.project), { count: a.concepts, feedback: a.feedback, images: a.imagesFolder, noImages: a.noImages, log: (s) => logs.push(s) });
+        return text(`컨셉 ${project.concepts.length} · 소재 ${project.assets.length}장\n${project.concepts.map((c) => `· ${c.name}(${c.key}) — ${c.headlines[0]} / ${c.bodies[0]}`).join('\n')}\n${report.length ? `규격 경고:\n${report.join('\n')}\n` : ''}갤러리: ~/.adpilot/projects/${project.slug}/creatives/index.html`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_plan', { description: '월 예산을 매체·시장·컨셉으로 나누고 사람 말로 설명한다.', inputSchema: { project: z.string().optional(), media: mediaZ } }, async (a) => { try {
+        const p = await opPlan(proj(a.project), { media: a.media });
+        return text(p.plan.explain);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_build', { description: '매체에 캠페인·광고를 전부 PAUSED(대기 상태)로 생성한다. 멱등 · 부분 실패 후 재실행 안전. validate=true 면 서버 검증만.', inputSchema: { project: z.string().optional(), media: mediaZ, validate: z.boolean().optional() } }, async (a) => { try {
+        const logs = [];
+        const { project, warnings, errors } = await opBuild(proj(a.project), { media: a.media, validate: a.validate, log: (s) => logs.push(s) });
+        return text(`${logs.join('\n')}\n${warnings.map((w) => `⚠ ${w}`).join('\n')}\n${errors.map((e) => `❌ ${e}`).join('\n')}\n생성물 ${project.placements.length}개(전부 PAUSED):\n${project.placements.map((x) => `${x.medium} ${x.kind} ${x.concept || ''} ${x.externalId}`).join('\n')}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_preview', { description: '미리보기 HTML 파일을 만든다(메타 실제 렌더 · 구글 근사).', inputSchema: { project: z.string().optional() } }, async (a) => { try {
+        const r = await opPreview(proj(a.project));
+        return text(`미리보기 ${r.count}개 → ${r.file}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_launch', { description: '광고를 시작한다(ACTIVE). 반드시 사용자의 명시적 승인을 받은 뒤에만 호출한다. 시작하는 순간부터 일 예산이 나간다.', inputSchema: { project: z.string().optional(), media: mediaZ, confirmed: z.literal(true).describe('사용자가 시작해도 된다고 명시적으로 말했을 때만 true') } }, async (a) => { try {
+        const { launched, errors } = await opLaunch(proj(a.project), { media: a.media, yes: true });
+        return text(`광고를 시작한 매체: ${launched.join(', ') || '없음'}${errors.length ? `\n${errors.join('\n')}` : ''}\n매체 검수(메타 24h · 구글 1영업일) 뒤 노출.`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_pause', { description: '광고를 즉시 전부 끈다.', inputSchema: { project: z.string().optional(), media: mediaZ } }, async (a) => { try {
+        const { paused, errors } = await opPause(proj(a.project), { media: a.media });
+        return text(`껐어요: ${paused.join(', ') || '없음'}${errors.length ? `\n${errors.join('\n')}` : ''}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_status', { description: '최근 N일 지표(소재별 쓴 돈·노출·클릭·전환)와 검수 상태.', inputSchema: { project: z.string().optional(), days: z.number().optional() } }, async (a) => { try {
+        const p = proj(a.project);
+        const st = await opStatus(p, { days: a.days });
+        return text(`상태 ${p.status} · ${st.range.since}~${st.range.until}\n${Object.entries(st.metrics).map(([m, rows]) => `[${m}]\n${tableOf(rows).map((r) => `  ${r.concept}: ${fmtKrw(r.spendKrw)} · 노출 ${r.impressions} · 클릭 ${r.clicks} · CTR ${(r.ctr * 100).toFixed(2)}% · 전환 ${r.conversions}`).join('\n') || '  지표 없음'}\n${(st.policy[m] || []).map((x) => `  검수 ${x.name}: ${x.status} ${x.issues.join('; ')}`).join('\n')}`).join('\n')}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_optimize', { description: '규칙 기반 최적화 제안(소재 끄기·예산 ±20% · 학습 단계 보호 · 월 상한 준수). apply=true 면 실행.', inputSchema: { project: z.string().optional(), apply: z.boolean().optional() } }, async (a) => { try {
+        const { proposals, applied } = await opOptimize(proj(a.project), { apply: a.apply });
+        return text(`${proposals.map((p) => `[${p.medium}] ${p.kind}: ${p.reason}`).join('\n')}${a.apply ? `\n적용: ${applied.join(' · ') || '없음'}` : ''}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_report', { description: '사람 말 보고서(주간 기본). HTML/MD 파일도 저장.', inputSchema: { project: z.string().optional(), days: z.number().optional() } }, async (a) => { try {
+        const r = await opReport(proj(a.project), { days: a.days });
+        return text(`${r.text}\n\n${r.markdown}\n\n파일: ${r.file}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_audit', { description: '연결된 광고 계정의 모든 캠페인·광고를 전수 조회하고 낭비·중복·정책 문제를 진단한다(기존 광고 인수).', inputSchema: { media: mediaZ } }, async (a) => { try {
+        const r = await opAudit({ media: a.media });
+        return text(Object.entries(r).map(([m, v]) => `[${m}] 캠페인 ${v.rows.filter((x) => x.level === 'campaign').length}\n${v.rows.filter((x) => x.level === 'campaign').map((c) => `  ${c.status} ${c.name} · 30일 ${c.spend30d} · 노출 ${c.impressions30d} · 클릭 ${c.clicks30d}`).join('\n')}\n진단: ${v.findings.join(' / ') || '특이사항 없음'}`).join('\n\n'));
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_change', { description: '자연어 수정 요청을 적용한다 — 예산·목표·시장·컨셉 제외·소재 방향·끄기/시작.', inputSchema: { project: z.string().optional(), request: z.string() } }, async (a) => { try {
+        const r = await opChange(proj(a.project), a.request);
+        return text(`${r.summary}\n${r.steps.join('\n')}`);
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_track', { description: '추적 스니펫 발급(install) 또는 랜딩 검증(verify).', inputSchema: { project: z.string().optional(), action: z.enum(['install', 'verify']), spa: z.boolean().optional() } }, async (a) => { try {
+        const p = proj(a.project);
+        if (a.action === 'install') {
+            const s = opTrackSnippet(p, { spa: a.spa });
+            return text(`■ <head>\n${s.head}\n\n■ 목표 달성 화면\n${s.conversion}\n\n■ CSP: ${s.csp.join(' ')}`);
+        }
+        return text(formatCheck(await verifyLanding(p.url, idsOf(p))));
+    }
+    catch (e) {
+        return err(e);
+    } });
+    server.registerTool('adyou_projects', { description: '프로젝트 목록과 상태.', inputSchema: {} }, async () => text(listProjects().map((s) => { const p = loadProject(s); return `${s} · ${p.status} · ${fmtKrw(p.budget.monthlyKrw)}/월 · ${p.budget.goal} · 생성물 ${p.placements.length}`; }).join('\n') || '없음'));
+    await server.connect(new StdioServerTransport());
+}