adyou 0.3.0

package/dist/core/ops.js

@@ -0,0 +1,407 @@
+// 작업층 — CLI와 MCP가 똑같이 부르는 함수들. 화면 출력은 log 콜백으로만.
+import fs from 'node:fs';
+import path from 'node:path';
+import { connectedMedia, connector } from '../adapters/index.js';
+import { buildBrief, explainBrief } from './brief.js';
+import { generateConcepts, validateConcepts } from './creatives/copy.js';
+import { generateBackgrounds, userBackgrounds } from './creatives/images.js';
+import { renderConcept, renderLogo } from './creatives/render.js';
+import { SIZES } from './creatives/specs.js';
+import { aiAvailable, completeJson } from './llm.js';
+import { fmtKrw } from './money.js';
+import { proposeFor, withinCap } from './optimize.js';
+import { makePlan } from './plan.js';
+import { makeReport } from './report.js';
+import { creativesDir, logDecision, newProject, projectDir, readDecisions, saveProject } from './state.js';
+import { idsOf, snippet } from './tracking.js';
+import { z } from 'zod';
+const noop = () => { };
+export function parseMarkets(s, siteLang = 'ko') {
+    if (!s)
+        return [{ country: 'KR', language: siteLang }];
+    const langOf = { KR: 'ko', US: 'en', GB: 'en', AU: 'en', CA: 'en', SG: 'en', JP: 'ja', TW: 'zh-TW', DE: 'de', FR: 'fr', ES: 'es', VN: 'vi', TH: 'th', ID: 'id', IN: 'en', HK: 'zh-TW', MY: 'en', PH: 'en', BR: 'pt', MX: 'es', IT: 'it', NL: 'nl' };
+    return s.split(',').map((x) => x.trim()).filter(Boolean).map((x) => { const [c, l] = x.split(':'); const cc = c.toUpperCase(); return { country: cc, language: l || langOf[cc] || 'en' }; });
+}
+export async function opBrief(url, o) {
+    const log = o.log || noop;
+    if (!Number.isFinite(o.budget) || o.budget < 100_000)
+        throw new Error('월 예산은 10만원 이상이어야 매체 최소 예산을 맞출 수 있어요.');
+    if (!/^https?:\/\//.test(url))
+        url = `https://${url}`;
+    log(`사이트 읽는 중… ${url}`);
+    const tmpMarkets = parseMarkets(o.markets);
+    const { brief, site } = await buildBrief(url, { goal: o.goal, markets: tmpMarkets, hints: o.hints });
+    const markets = o.markets ? tmpMarkets : [{ country: 'KR', language: site.lang || 'ko' }];
+    if (!o.markets && site.lang && site.lang !== 'ko')
+        markets[0] = { country: site.lang === 'en' ? 'US' : site.lang === 'ja' ? 'JP' : 'KR', language: site.lang };
+    if (site.lang !== brief.language && o.markets)
+        brief.language = markets[0].language;
+    const p = newProject(url, { monthlyKrw: o.budget, goal: o.goal, markets, endDate: o.endDate });
+    p.brief = brief;
+    p.status = 'briefed';
+    p.tracking = { ...(p.tracking || {}), pixelId: p.tracking?.pixelId || site.pixelIds[0], gtagId: p.tracking?.gtagId || site.gtagIds[0], ga4Id: p.tracking?.ga4Id || site.ga4Ids[0] };
+    saveProject(p);
+    logDecision(p.slug, { kind: 'brief', action: 'created', by: 'user', data: { budget: o.budget, goal: o.goal, markets } });
+    return { project: p, explain: explainBrief(brief) };
+}
+export async function opCreatives(p, o) {
+    const log = o.log || noop;
+    if (!p.brief)
+        throw new Error('브리프가 먼저 필요해요.');
+    if (p.brief.specialCategory)
+        throw new Error(`「${p.brief.specialCategory}」 특별 광고 카테고리는 접수할 수 없어요.`);
+    const count = o.count || 3;
+    const dir = creativesDir(p.slug);
+    if (o.force || o.feedback || !p.concepts?.length) {
+        log(`컨셉 ${count}개·카피 만드는 중…${o.feedback ? ` (수정 요청: ${o.feedback})` : ''}`);
+        p.concepts = await generateConcepts(p.brief, { goal: p.budget.goal, count, feedback: o.feedback, previous: p.concepts });
+        if (o.feedback || o.force)
+            for (const f of fs.readdirSync(dir))
+                if (/^(?!bg_).*\.png$/.test(f))
+                    fs.rmSync(path.join(dir, f));
+        if (o.feedback)
+            for (const f of fs.readdirSync(dir))
+                if (/^bg_/.test(f))
+                    fs.rmSync(path.join(dir, f));
+    }
+    const v = validateConcepts(p.concepts);
+    if (!v.ok)
+        log(`규격 검사 경고:\n  ${v.report.join('\n  ')}`);
+    const assets = [];
+    // 로고 자산(구글 RDA 용 1:1 · 4:1)
+    assets.push(...(await renderLogo(dir, p.brief)));
+    for (const c of p.concepts) {
+        let bgs;
+        if (o.images)
+            bgs = userBackgrounds(o.images, c.key);
+        else if (o.noImages)
+            bgs = {};
+        else {
+            log(`배경 이미지 생성 ${c.key}…`);
+            bgs = await generateBackgrounds(dir, c.key, c.imagePrompt, undefined, log);
+        }
+        log(`합성 ${c.key} × ${SIZES.length}규격…`);
+        assets.push(...(await renderConcept(dir, p.brief, c, bgs, { force: o.force || !!o.feedback, log })));
+    }
+    p.assets = assets;
+    p.status = 'creatives';
+    fs.writeFileSync(path.join(dir, 'copy.json'), JSON.stringify(p.concepts, null, 2));
+    fs.writeFileSync(path.join(dir, 'index.html'), galleryHtml(p));
+    saveProject(p);
+    logDecision(p.slug, { kind: 'creatives', action: o.feedback ? 'regenerated' : 'generated', by: 'user', reason: o.feedback, data: { concepts: p.concepts.map((c) => c.key), assets: assets.length } });
+    return { project: p, report: v.report };
+}
+export function galleryHtml(p) {
+    const esc = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;');
+    const groups = (p.concepts || []).map((c) => { const files = (p.assets || []).filter((a) => a.concept === c.key); return `<section><h2>${esc(c.name)} <small>${esc(c.key)} · ${esc(c.angle)}</small></h2><p><b>${esc(c.headlines[0] || '')}</b><br>${esc(c.bodies[0] || '')}</p><details><summary>카피 전부(제목 ${c.headlines.length} · 본문 ${c.bodies.length})</summary><ul>${[...c.headlines, ...c.bodies, ...c.descriptions].map((t) => `<li>${esc(t)}</li>`).join('')}</ul></details><div class="grid">${files.map((a) => `<figure><img src="${path.basename(a.file)}" style="width:${Math.min(360, a.w)}px"><figcaption>${a.w}×${a.h} · ${a.medium}</figcaption></figure>`).join('')}</div></section>`; }).join('');
+    return `<!doctype html><html lang="ko"><head><meta charset="utf-8"><title>${esc(p.brief?.company || p.slug)} 광고 소재</title><style>body{font-family:Pretendard,'Apple SD Gothic Neo',sans-serif;margin:0;padding:32px;color:#0b1526;background:#fff}h1{font-size:22px}h2{font-size:18px;margin:36px 0 6px}h2 small{color:#6b7a90;font-weight:500;font-size:13px}.grid{display:flex;flex-wrap:wrap;gap:14px;align-items:flex-start}figure{margin:0;background:#f4f7fb;border-radius:10px;padding:8px}img{display:block;border-radius:6px;box-shadow:0 6px 24px -10px rgba(0,0,0,.3)}figcaption{font-size:11px;color:#6b7a90;margin-top:6px}p{max-width:720px}</style></head><body><h1>${esc(p.brief?.company || p.slug)} 광고 소재 <small style="color:#6b7a90;font-size:13px">${new Date().toISOString().slice(0, 10)} · ${(p.assets || []).filter((a) => a.concept !== '_logo').length}장</small></h1>${groups}</body></html>`;
+}
+export async function opPlan(p, o = {}) {
+    p.plan = await makePlan(p, { media: o.media });
+    p.status = 'planned';
+    saveProject(p);
+    logDecision(p.slug, { kind: 'plan', action: 'created', by: 'user', data: { daily: p.plan.dailyKrw, media: p.plan.media.map((m) => `${m.medium}:${m.dailyBudgetKrw}`) } });
+    return p;
+}
+export async function opBuild(p, o = {}) {
+    const log = o.log || noop;
+    if (!p.brief || !p.concepts?.length || !p.assets?.length)
+        throw new Error('소재가 먼저 필요해요 (`adpilot creatives`).');
+    if (!p.plan)
+        await opPlan(p, { media: o.media });
+    const plan = p.plan;
+    const media = (o.media && o.media.length ? o.media : plan.media.map((m) => m.medium));
+    const warnings = [];
+    const errors = [];
+    const concepts = p.concepts.filter((c) => plan.concepts.includes(c.key));
+    for (const m of media) {
+        const c = connector(m);
+        const pm = plan.media.find((x) => x.medium === m);
+        if (!c || !pm) {
+            errors.push(`${m}: 연결·계획이 없어요`);
+            continue;
+        }
+        log(`${m}: ${o.validate ? '검증' : '생성'} 시작 (하루 ${fmtKrw(pm.dailyBudgetKrw)})`);
+        try {
+            let conversionActionRn;
+            if (m === 'google' && !o.validate && 'ensureConversionAction' in c) {
+                const ca = await c.ensureConversionAction(p.slug, p.budget.goal);
+                conversionActionRn = ca.resourceName;
+                p.tracking = { ...(p.tracking || {}), gtagId: ca.gtagId || p.tracking?.gtagId, gtagLabel: ca.label || p.tracking?.gtagLabel, conversionActionRn: ca.resourceName };
+                saveProject(p);
+                log(`  google 전환 액션 ${ca.gtagId}/${ca.label}`);
+            }
+            const r = await c.build({ slug: p.slug, brief: p.brief, concepts, assets: p.assets, goal: p.budget.goal, markets: plan.markets, dailyBudgetMinor: pm.dailyBudgetMinor, currency: pm.currency, endDate: plan.endDate, landingUrl: p.url, utmCampaign: `adpilot_${p.slug}`, pixelId: p.tracking?.pixelId, conversionActionRn, existing: p.placements, validateOnly: o.validate, log });
+            warnings.push(...r.warnings);
+            if (!o.validate) {
+                p.placements = mergePlacements(p.placements, r.placements);
+                saveProject(p);
+                logDecision(p.slug, { kind: 'build', medium: m, action: 'created_paused', by: 'user', data: r.placements.filter((x) => x.medium === m).map((x) => `${x.kind}:${x.externalId}`) });
+            }
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            const hint = e.hint;
+            errors.push(`${m}: ${msg}${hint ? `\n   → ${hint}` : ''}`);
+            log(`  ❌ ${m}: ${msg}`);
+            saveProject(p); // 부분 성공분 보존
+        }
+    }
+    if (!o.validate && p.placements.some((x) => x.kind === 'ad')) {
+        p.status = errors.length ? p.status : 'built';
+        saveProject(p);
+    }
+    return { project: p, warnings, errors };
+}
+function mergePlacements(a, b) { const m = new Map(a.map((x) => [`${x.medium}/${x.kind}/${x.concept || ''}`, x])); for (const x of b)
+    m.set(`${x.medium}/${x.kind}/${x.concept || ''}`, x); return [...m.values()]; }
+export async function opPreview(p, o = {}) {
+    const items = [];
+    for (const m of [...new Set(p.placements.map((x) => x.medium))]) {
+        const c = connector(m);
+        if (c)
+            try {
+                items.push(...(await c.preview(p.placements)));
+            }
+            catch (e) {
+                items.push({ name: `${m} 미리보기 실패`, html: `<p>${e instanceof Error ? e.message : e}</p>` });
+            }
+    }
+    const esc = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;');
+    const local = (concept) => { const c = p.concepts?.find((x) => x.key === concept); const img = p.assets?.find((a) => a.concept === concept && a.w === 1200 && a.h === 628); return c ? `<div class="rda"><img src="../creatives/${img ? path.basename(img.file) : ''}"><div class="t"><b>${esc(c.headlines[0])}</b><span>${esc(c.descriptions[0] || '')}</span><em>${esc(p.brief?.company || '')}</em></div></div>` : ''; };
+    const html = `<!doctype html><html lang="ko"><head><meta charset="utf-8"><title>${esc(p.brief?.company || p.slug)} 광고 미리보기</title><style>body{font-family:Pretendard,'Apple SD Gothic Neo',sans-serif;margin:0;padding:28px;background:#f2f4f8;color:#0b1526}h1{font-size:20px}.row{display:flex;flex-wrap:wrap;gap:20px}.card{background:#fff;border-radius:12px;padding:14px;box-shadow:0 8px 30px -18px rgba(0,0,0,.4)}.card h3{margin:0 0 10px;font-size:14px;color:#41506a}.rda{width:300px;border:1px solid #e3e8ef;border-radius:8px;overflow:hidden;font-size:13px}.rda img{width:100%;display:block}.rda .t{padding:10px;display:flex;flex-direction:column;gap:4px}.rda em{color:#6b7a90;font-style:normal;font-size:11px}iframe{border:0}.note{background:#fff;border-radius:12px;padding:14px 18px;margin-bottom:20px;font-size:14px;line-height:1.6}</style></head><body><h1>${esc(p.brief?.company || p.slug)} 광고 미리보기 <small style="color:#6b7a90;font-size:13px">${new Date().toISOString().slice(0, 16).replace('T', ' ')} · 전부 대기 상태(노출 안 됨)</small></h1><div class="note">${esc(p.plan?.explain || '').replace(/\n/g, '<br>')}</div><div class="row">${items.map((i) => `<div class="card"><h3>${esc(i.name)}</h3>${/gpreview/.test(i.html) ? local(i.concept) : i.html}</div>`).join('')}</div></body></html>`;
+    const dir = path.join(projectDir(p.slug), 'preview');
+    fs.mkdirSync(dir, { recursive: true });
+    const file = path.join(dir, 'index.html');
+    fs.writeFileSync(file, html);
+    if (p.status === 'built') {
+        p.status = 'built';
+    }
+    return { file, count: items.length };
+}
+export async function opLaunch(p, o = {}) {
+    const log = o.log || noop;
+    if (!p.plan)
+        throw new Error('계획이 없어요.');
+    if (!p.placements.some((x) => x.kind === 'ad'))
+        throw new Error('만들어진 광고가 없어요 (`adpilot build`).');
+    // 예산 상한 재확인
+    const daily = p.plan.media.reduce((n, m) => n + m.dailyBudgetKrw, 0);
+    if (daily > p.plan.dailyKrw * 1.02 + 2000)
+        throw new Error(`일 예산 합(${fmtKrw(daily)})이 계획 상한(${fmtKrw(p.plan.dailyKrw)})을 넘어 광고를 시작할 수 없어요.`);
+    const media = (o.media && o.media.length ? o.media : [...new Set(p.placements.map((x) => x.medium))]);
+    const launched = [];
+    const errors = [];
+    for (const m of media) {
+        const c = connector(m);
+        if (!c) {
+            errors.push(`${m}: 연결 없음`);
+            continue;
+        }
+        try {
+            await c.setStatus(p.placements, 'ACTIVE');
+            launched.push(m);
+            log(`${m}: 켰어요(매체 검수 뒤 노출 시작)`);
+            logDecision(p.slug, { kind: 'launch', medium: m, action: 'ACTIVE', by: 'user' });
+        }
+        catch (e) {
+            errors.push(`${m}: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    if (launched.length) {
+        p.status = 'live';
+        p.approvedAt = p.approvedAt || new Date().toISOString();
+        p.launchedAt = p.launchedAt || new Date().toISOString();
+    }
+    saveProject(p);
+    return { project: p, launched, errors };
+}
+export async function opPause(p, o = {}) {
+    const media = (o.media && o.media.length ? o.media : [...new Set(p.placements.map((x) => x.medium))]);
+    const paused = [];
+    const errors = [];
+    for (const m of media) {
+        const c = connector(m);
+        if (!c)
+            continue;
+        try {
+            await c.setStatus(p.placements, 'PAUSED');
+            paused.push(m);
+            logDecision(p.slug, { kind: 'pause', medium: m, action: 'PAUSED', by: 'user' });
+        }
+        catch (e) {
+            errors.push(`${m}: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    if (paused.length) {
+        p.status = 'paused';
+        saveProject(p);
+    }
+    return { paused, errors };
+}
+export function dateRange(days) { const until = new Date(); const since = new Date(Date.now() - (days - 1) * 86400_000); return { since: since.toISOString().slice(0, 10), until: until.toISOString().slice(0, 10) }; }
+export async function opStatus(p, o = {}) {
+    const range = dateRange(o.days || 7);
+    const metrics = {};
+    const policy = {};
+    for (const m of [...new Set(p.placements.map((x) => x.medium))]) {
+        const c = connector(m);
+        if (!c)
+            continue;
+        metrics[m] = await c.metrics(p.placements, range).catch(() => []);
+        policy[m] = await c.policy(p.placements).catch(() => []);
+    }
+    const mdir = path.join(projectDir(p.slug), 'metrics');
+    fs.mkdirSync(mdir, { recursive: true });
+    fs.writeFileSync(path.join(mdir, `${range.until}.json`), JSON.stringify({ range, metrics, policy }, null, 2));
+    return { metrics, policy, range };
+}
+export async function opOptimize(p, o = {}) {
+    const log = o.log || noop;
+    if (!p.plan)
+        throw new Error('계획이 없어요.');
+    const { metrics } = await opStatus(p, { days: 7 });
+    const proposals = [];
+    for (const m of Object.keys(metrics))
+        proposals.push(...proposeFor(m, metrics[m], p.plan, p.launchedAt));
+    const applied = [];
+    if (o.apply) {
+        const newDaily = {};
+        for (const pr of proposals)
+            if (pr.newDailyMinor) {
+                const pm = p.plan.media.find((x) => x.medium === pr.medium);
+                newDaily[pr.medium] = Math.round(pm.dailyBudgetKrw * (pr.newDailyMinor / pm.dailyBudgetMinor));
+            }
+        const capOk = withinCap(p.plan, newDaily);
+        for (const pr of proposals) {
+            const c = connector(pr.medium);
+            if (!c)
+                continue;
+            try {
+                if (pr.kind === 'pause_ad' && pr.target) {
+                    const ads = p.placements.filter((x) => x.medium === pr.medium && x.kind === 'ad');
+                    const active = ads.filter((x) => x.status !== 'PAUSED');
+                    if (active.length <= 1) {
+                        log(`  ${pr.medium}: 마지막 광고는 끄지 않아요`);
+                        continue;
+                    }
+                    const t = p.placements.find((x) => x.externalId === pr.target);
+                    if (!t)
+                        continue;
+                    await c.setStatus([t], 'PAUSED');
+                    applied.push(`${pr.medium} ${pr.concept} 광고 끔`);
+                    logDecision(p.slug, { kind: 'optimize', medium: pr.medium, target: pr.target, action: 'pause_ad', reason: pr.reason, by: 'rule' });
+                }
+                else if ((pr.kind === 'budget_up' || pr.kind === 'budget_down') && pr.newDailyMinor) {
+                    if (pr.kind === 'budget_up' && !capOk) {
+                        log(`  ${pr.medium}: 월 상한 때문에 예산을 올리지 않아요`);
+                        continue;
+                    }
+                    const pm = p.plan.media.find((x) => x.medium === pr.medium);
+                    await c.updateBudget(p.placements, pr.newDailyMinor);
+                    pm.dailyBudgetKrw = newDaily[pr.medium];
+                    pm.dailyBudgetMinor = pr.newDailyMinor;
+                    saveProject(p);
+                    applied.push(`${pr.medium} 일 예산 → ${fmtKrw(pm.dailyBudgetKrw)}`);
+                    logDecision(p.slug, { kind: 'optimize', medium: pr.medium, action: pr.kind, reason: pr.reason, by: 'rule', data: { newDailyMinor: pr.newDailyMinor } });
+                }
+            }
+            catch (e) {
+                log(`  ❌ ${pr.medium}: ${e instanceof Error ? e.message : e}`);
+            }
+        }
+    }
+    return { proposals, applied };
+}
+export async function opReport(p, o = {}) {
+    const st = await opStatus(p, { days: o.days || 7 });
+    const r = await makeReport({ project: p, range: st.range, rows: st.metrics, decisions: readDecisions(p.slug), policy: st.policy });
+    const dir = path.join(projectDir(p.slug), 'reports');
+    fs.mkdirSync(dir, { recursive: true });
+    const file = path.join(dir, `${st.range.until}.html`);
+    fs.writeFileSync(file, r.html);
+    fs.writeFileSync(file.replace(/\.html$/, '.md'), r.markdown);
+    return { ...r, file };
+}
+export async function opAudit(o = {}) {
+    const media = (o.media && o.media.length ? o.media : connectedMedia());
+    const out = {};
+    for (const m of media) {
+        const c = connector(m);
+        if (!c)
+            continue;
+        const rows = await c.inventory();
+        const findings = [];
+        const camps = rows.filter((r) => r.level === 'campaign');
+        for (const r of camps) {
+            if (/ACTIVE|ENABLED/.test(r.status) && (r.impressions30d || 0) === 0)
+                findings.push(`「${r.name}」 노출 중인데 30일 노출 0 — 검수 거절·예산 0·타겟 문제`);
+            if (/ACTIVE|ENABLED/.test(r.status) && r.spend30d && r.clicks30d === 0)
+                findings.push(`「${r.name}」 ${r.spend30d} 썼는데 클릭 0`);
+        }
+        const active = camps.filter((r) => /ACTIVE|ENABLED/.test(r.status));
+        const names = active.map((r) => `${r.name.replace(/\[adp:[^\]]+\]\s*/, '').split('·')[0].trim()}|${r.objective || ''}`);
+        const dup = names.filter((n, i) => names.indexOf(n) !== i);
+        if (dup.length)
+            findings.push(`같은 이름·같은 유형의 노출 중인 캠페인 중복: ${[...new Set(dup.map((d) => d.split('|')[0]))].join(', ')} — 서로 경매 경쟁`);
+        for (const r of rows.filter((r) => r.level === 'ad' && r.issues?.length))
+            findings.push(`광고 「${r.name}」: ${r.issues.join('; ')}`);
+        out[m] = { rows, findings };
+    }
+    return out;
+}
+export function opTrackSnippet(p, o = {}) { return snippet(idsOf(p), { goal: p.budget.goal, spa: o.spa }); }
+/** 자연어 수정 — 「예산 200만원으로」「미국 빼」「크레딧 컨셉 빼고 더 고급스럽게」 → 구조화된 변경 → 규칙 안에서 적용 */
+const ChangeSchema = z.object({ budgetKrw: z.number().nullable().default(null), goal: z.enum(['traffic', 'lead', 'signup', 'purchase']).nullable().default(null), markets: z.string().nullable().default(null), dropConcepts: z.array(z.string()).default([]), creativeFeedback: z.string().nullable().default(null), pause: z.boolean().default(false), resume: z.boolean().default(false), summary: z.string() });
+export async function opChange(p, request, o = {}) {
+    const log = o.log || noop;
+    if (!aiAvailable())
+        throw new Error('자연어 수정은 LLM 키가 필요해요. 대신 `adpilot budget <원>` · `adpilot creatives --feedback "…"` 를 써 주세요.');
+    const ch = await completeJson({ schema: ChangeSchema, maxTokens: 800, system: `광고주의 자연어 요청을 구조화한다. 현재 프로젝트 상태를 참고해 바꿀 값만 채우고 나머지는 null/빈 배열. markets는 "US:en,KR:ko" 형식. dropConcepts는 현재 컨셉 key 중 빼라는 것. creativeFeedback은 소재·카피 방향 수정 요청(있으면 소재를 다시 만든다). summary는 무엇을 바꾸는지 한 문장(존댓말).`, user: JSON.stringify({ request, current: { budgetKrw: p.budget.monthlyKrw, goal: p.budget.goal, markets: p.budget.markets, concepts: p.concepts?.map((c) => ({ key: c.key, name: c.name })), status: p.status } }) });
+    const steps = [];
+    if (ch.budgetKrw && ch.budgetKrw !== p.budget.monthlyKrw) {
+        p.budget.monthlyKrw = ch.budgetKrw;
+        steps.push(`월 예산 → ${fmtKrw(ch.budgetKrw)}`);
+    }
+    if (ch.goal && ch.goal !== p.budget.goal) {
+        p.budget.goal = ch.goal;
+        steps.push(`목표 → ${ch.goal}`);
+    }
+    if (ch.markets) {
+        p.budget.markets = parseMarkets(ch.markets);
+        steps.push(`시장 → ${ch.markets}`);
+    }
+    if (ch.dropConcepts.length && p.concepts) {
+        p.concepts = p.concepts.filter((c) => !ch.dropConcepts.includes(c.key));
+        p.assets = p.assets?.filter((a) => !ch.dropConcepts.includes(a.concept));
+        steps.push(`컨셉 제외 → ${ch.dropConcepts.join(', ')}`);
+    }
+    saveProject(p);
+    if (ch.creativeFeedback) {
+        steps.push(`소재 다시 만들기: ${ch.creativeFeedback}`);
+        await opCreatives(p, { feedback: ch.creativeFeedback, count: p.concepts?.length || 3, log });
+    }
+    if (p.plan && (ch.budgetKrw || ch.markets || ch.dropConcepts.length)) {
+        await opPlan(p, { log });
+        steps.push('계획 다시 계산');
+        if (p.placements.length) {
+            for (const pm of p.plan.media) {
+                const c = connector(pm.medium);
+                if (c)
+                    await c.updateBudget(p.placements, pm.dailyBudgetMinor).catch(() => { });
+            }
+            steps.push('매체 일 예산 반영');
+        }
+    }
+    if (ch.pause) {
+        await opPause(p, { log });
+        steps.push('전부 끔');
+    }
+    if (ch.resume && p.placements.length) {
+        await opLaunch(p, { log });
+        steps.push('다시 시작');
+    }
+    logDecision(p.slug, { kind: 'change', action: 'nl_change', by: 'llm', reason: request, data: ch });
+    return { summary: ch.summary, steps };
+}
+export async function opCheckSummary(items) { return { pass: items.filter((i) => i.ok === true).length, fail: items.filter((i) => i.ok === false).length, unknown: items.filter((i) => i.ok === null).length }; }

package/dist/core/optimize.d.ts

@@ -0,0 +1,27 @@
+import type { MetricRow } from '../adapters/types.js';
+import type { Plan } from './state.js';
+export type Proposal = {
+    medium: 'meta' | 'google';
+    kind: 'pause_ad' | 'budget_up' | 'budget_down' | 'note';
+    target?: string;
+    concept?: string;
+    reason: string;
+    newDailyMinor?: number;
+};
+export declare function summarize(rows: MetricRow[]): {
+    days: number;
+    ctr: number;
+    cpc: number;
+    cpa: number;
+    id: string;
+    name: string;
+    concept?: string;
+    spend: number;
+    impressions: number;
+    clicks: number;
+    conversions: number;
+    currency: string;
+}[];
+export declare function proposeFor(medium: 'meta' | 'google', rows: MetricRow[], plan: Plan, launchedAt?: string): Proposal[];
+/** 예산 재배분이 월 상한을 넘지 않는지 — 매체별 새 일 예산(원 환산) 합 ≤ 계획 일 예산 */
+export declare function withinCap(plan: Plan, newDailyKrwByMedium: Record<string, number>): boolean;

package/dist/core/optimize.js

@@ -0,0 +1,56 @@
+export function summarize(rows) {
+    const by = new Map();
+    for (const r of rows) {
+        const k = r.id;
+        const s = by.get(k) || { id: r.id, name: r.name, concept: r.concept, spend: 0, impressions: 0, clicks: 0, conversions: 0, currency: r.currency, days: new Set() };
+        s.spend += r.spend;
+        s.impressions += r.impressions;
+        s.clicks += r.clicks;
+        s.conversions += r.conversions;
+        if (r.date)
+            s.days.add(r.date);
+        by.set(k, s);
+    }
+    return [...by.values()].map((s) => ({ ...s, days: s.days.size, ctr: s.impressions ? s.clicks / s.impressions : 0, cpc: s.clicks ? s.spend / s.clicks : 0, cpa: s.conversions ? s.spend / s.conversions : 0 }));
+}
+export function proposeFor(medium, rows, plan, launchedAt) {
+    const ads = summarize(rows);
+    const out = [];
+    const hours = launchedAt ? (Date.now() - new Date(launchedAt).getTime()) / 3600_000 : 0;
+    const pm = plan.media.find((m) => m.medium === medium);
+    if (!ads.length)
+        return [{ medium, kind: 'note', reason: '아직 지표가 없어요(검수 중이거나 노출 전).' }];
+    if (hours < 48)
+        return [{ medium, kind: 'note', reason: `광고 시작 ${Math.floor(hours)}시간 뒤 — 학습 단계(48시간)라 소재를 건드리지 않아요.` }];
+    const eligible = ads.filter((a) => a.impressions >= 2000);
+    if (eligible.length < 2)
+        return [{ medium, kind: 'note', reason: '노출 2,000 이상인 소재가 2개 미만 — 비교하기엔 일러요.' }];
+    const useCpa = eligible.filter((a) => a.conversions > 0).length >= 2 && eligible.reduce((n, a) => n + a.conversions, 0) >= 20;
+    const score = (a) => (useCpa ? (a.conversions ? -a.cpa : -Infinity) : a.ctr);
+    const sorted = [...eligible].sort((a, b) => score(b) - score(a));
+    const best = sorted[0];
+    const worst = sorted[sorted.length - 1];
+    const ratio = useCpa ? (best.cpa && worst.cpa ? worst.cpa / best.cpa : 1) : best.ctr && worst.ctr ? best.ctr / worst.ctr : 1;
+    if (sorted.length >= 2 && ratio >= 1.8)
+        out.push({ medium, kind: 'pause_ad', target: worst.id, concept: worst.concept, reason: useCpa ? `「${worst.concept || worst.name}」 전환 단가가 1등의 ${ratio.toFixed(1)}배 — 끄고 예산을 잘 되는 쪽에 몰아요` : `「${worst.concept || worst.name}」 클릭률 ${(worst.ctr * 100).toFixed(2)}%가 1등(${(best.ctr * 100).toFixed(2)}%)의 1/${ratio.toFixed(1)} — 끄고 예산을 잘 되는 쪽에 몰아요` });
+    // 예산: 전체 평균 CTR이 1% 이상이고 예산 소진율이 높으면 +20% (상한 안에서), 소진율 낮으면 유지
+    if (pm) {
+        const days = Math.max(1, ...ads.map((a) => a.days));
+        const spendPerDay = ads.reduce((n, a) => n + a.spend, 0) / days;
+        const planMajor = pm.dailyBudgetMinor / (pm.currency === 'KRW' || pm.currency === 'JPY' ? 1 : 100);
+        const pacing = planMajor ? spendPerDay / planMajor : 0;
+        const avgCtr = eligible.reduce((n, a) => n + a.clicks, 0) / Math.max(1, eligible.reduce((n, a) => n + a.impressions, 0));
+        if (pacing > 0.9 && avgCtr >= 0.01)
+            out.push({ medium, kind: 'budget_up', reason: `예산을 ${Math.round(pacing * 100)}% 소진하고 클릭률 ${(avgCtr * 100).toFixed(2)}% — 이 매체에 +20% 제안(월 상한 안에서 다른 매체에서 옮김)`, newDailyMinor: Math.floor(pm.dailyBudgetMinor * 1.2) });
+        else if (pacing < 0.4)
+            out.push({ medium, kind: 'budget_down', reason: `예산의 ${Math.round(pacing * 100)}%만 쓰고 있어요 — 노출 경쟁이 약하거나 타겟이 좁아요. -20% 후 다른 매체로`, newDailyMinor: Math.floor(pm.dailyBudgetMinor * 0.8) });
+    }
+    if (!out.length)
+        out.push({ medium, kind: 'note', reason: `소재 간 차이가 크지 않아 그대로 둡니다 (1등 「${best.concept || best.name}」).` });
+    return out;
+}
+/** 예산 재배분이 월 상한을 넘지 않는지 — 매체별 새 일 예산(원 환산) 합 ≤ 계획 일 예산 */
+export function withinCap(plan, newDailyKrwByMedium) {
+    const total = plan.media.reduce((n, m) => n + (newDailyKrwByMedium[m.medium] ?? m.dailyBudgetKrw), 0);
+    return total <= plan.dailyKrw * 1.02 + 2000;
+}

package/dist/core/plan.d.ts

@@ -0,0 +1,22 @@
+import type { Medium } from '../adapters/types.js';
+import type { Goal, Market, Plan, Project } from './state.js';
+export type PlanInput = {
+    monthlyKrw: number;
+    goal: Goal;
+    markets: Market[];
+    conceptKeys: string[];
+    briefLanguage: string;
+    endDate?: string;
+    hasTracking: boolean;
+    media: {
+        medium: Medium;
+        currency: string;
+    }[];
+    shares?: Partial<Record<Medium, number>>;
+};
+/** 순수 계산 — 계정 통화만 있으면 어디서든(CLI·서버) 같은 계획을 만든다 */
+export declare function computePlan(i: PlanInput): Plan;
+export declare function makePlan(p: Project, opts?: {
+    media?: Medium[];
+    shares?: Partial<Record<Medium, number>>;
+}): Promise<Plan>;

package/dist/core/plan.js

@@ -0,0 +1,59 @@
+// 계획 — 월 예산을 매체·시장·컨셉으로 나누고(작은 예산은 분할 수를 줄임) 계정 통화 최소 단위로 환산한다. 사람 말 설명(explain) 포함. 예산 상한은 여기서만 계산된다.
+import { connectedMedia, connector } from '../adapters/index.js';
+import { fmtKrw, fmtMinor, krwToMinor, minDailyMinor, minorToKrw } from './money.js';
+const MEDIUM_LABEL = { meta: 'Meta(페이스북·인스타그램)', google: 'Google(디스플레이)' };
+/** 순수 계산 — 계정 통화만 있으면 어디서든(CLI·서버) 같은 계획을 만든다 */
+export function computePlan(i) {
+    if (!i.media.length)
+        throw new Error('연결된 매체가 없어요.');
+    const monthly = i.monthlyKrw;
+    if (!Number.isFinite(monthly) || monthly < 100_000)
+        throw new Error('월 예산은 10만원 이상이어야 매체 최소 예산을 맞출 수 있어요.');
+    const daily = Math.floor(monthly / 30.4);
+    const perMediumDaily = daily / i.media.length;
+    const maxConcepts = Math.max(1, Math.min(i.conceptKeys.length, Math.floor(perMediumDaily / 5000)));
+    const concepts = i.conceptKeys.slice(0, maxConcepts);
+    const base = { meta: 0.55, google: 0.45 };
+    let shares = i.media.map((m) => i.shares?.[m.medium] ?? base[m.medium]);
+    const sum = shares.reduce((a, b) => a + b, 0);
+    shares = shares.map((s) => s / sum);
+    const out = [];
+    i.media.forEach((m, idx) => {
+        const dailyKrw = Math.floor(daily * shares[idx]);
+        let minor = krwToMinor(dailyKrw, m.currency);
+        const min = minDailyMinor(m.medium, m.currency) * Math.max(1, m.medium === 'meta' ? concepts.length : 1);
+        let note = '';
+        if (minor < min) {
+            minor = min;
+            note = `매체 최소 예산(${fmtMinor(min, m.currency)})에 맞춰 올렸어요`;
+        }
+        out.push({ medium: m.medium, share: Math.round(shares[idx] * 100) / 100, dailyBudgetKrw: minorToKrw(minor, m.currency), currency: m.currency, dailyBudgetMinor: minor, note });
+    });
+    const total = out.reduce((n, m) => n + m.dailyBudgetKrw, 0);
+    if (total > daily * 1.02 + 2000)
+        throw new Error(`매체 최소 예산 합(${fmtKrw(total)}/일)이 월 예산(${fmtKrw(monthly)} → 하루 ${fmtKrw(daily)})을 넘어요. 예산을 올리거나 매체를 하나로 줄여 주세요.`);
+    const goalWord = { traffic: '사이트 방문', lead: '문의', signup: '가입', purchase: '구매' }[i.goal];
+    const explain = [
+        `한 달 ${fmtKrw(monthly)} 을 하루 약 ${fmtKrw(daily)} 으로 나눠 씁니다.`,
+        ...out.map((m) => `· ${MEDIUM_LABEL[m.medium]} 하루 ${fmtKrw(m.dailyBudgetKrw)}${m.currency !== 'KRW' ? ` (계정 통화 ${m.currency} → ${fmtMinor(m.dailyBudgetMinor, m.currency)})` : ''}${m.note ? ` — ${m.note}` : ''}`),
+        `보여 줄 사람: ${i.markets.map((m) => `${m.country}(${m.language})`).join(' · ')} · 18세 이상 · 매체가 관심사를 자동으로 찾아요(Advantage+ / 자동 타겟).`,
+        `광고 소재는 ${concepts.length}가지 방향(${concepts.join(', ')})으로 나눠서 어느 쪽이 잘 되는지 비교합니다${i.conceptKeys.length > concepts.length ? ` — 예산이 작아 ${i.conceptKeys.length - concepts.length}개는 뒤로 미뤘어요` : ''}.`,
+        `목표: ${goalWord}${i.hasTracking ? ' — 전환이 50건쯤 쌓이면 전환 최적화로 자동 전환' : ' — 추적 태그가 없어 방문 기준으로만 최적화돼요(추적 코드를 사이트에 넣어 주세요)'}.`,
+        ...(i.markets.some((m) => m.language.split('-')[0] !== (i.briefLanguage || 'ko').split('-')[0]) ? [`⚠ 카피 언어가 ${i.briefLanguage} 인데 시장에 다른 언어(${[...new Set(i.markets.map((m) => m.language))].join(', ')})가 있어요 — 언어별 소재를 따로 만들어 주세요.`] : []),
+        `만들어지는 광고는 전부 「대기 상태(PAUSED · 노출 안 됨)」이고, 광고 시작 전엔 1원도 나가지 않아요.${i.endDate ? ` 종료일 ${i.endDate}.` : ''}`,
+    ].join('\n');
+    return { monthlyKrw: monthly, dailyKrw: daily, media: out, concepts, markets: i.markets, goal: i.goal, endDate: i.endDate, explain, createdAt: new Date().toISOString() };
+}
+export async function makePlan(p, opts = {}) {
+    if (!p.brief)
+        throw new Error('브리프가 먼저 필요해요 (`adpilot brief <url>`).');
+    const media = (opts.media && opts.media.length ? opts.media : connectedMedia());
+    if (!media.length)
+        throw new Error('연결된 매체가 없어요. `adpilot connect meta …` 또는 `adpilot connect google …` 먼저.');
+    const accounts = [];
+    for (const m of media) {
+        const acc = await connector(m).account();
+        accounts.push({ medium: m, currency: acc.currency });
+    }
+    return computePlan({ monthlyKrw: p.budget.monthlyKrw, goal: p.budget.goal, markets: p.budget.markets, conceptKeys: (p.concepts || []).map((c) => c.key), briefLanguage: p.brief.language, endDate: p.budget.endDate, hasTracking: !!(p.tracking?.pixelId || p.tracking?.gtagId), media: accounts, shares: opts.shares });
+}

package/dist/core/report.d.ts

@@ -0,0 +1,30 @@
+import type { MetricRow } from '../adapters/types.js';
+import type { Project, Decision } from './state.js';
+export type ReportInput = {
+    project: Project;
+    range: {
+        since: string;
+        until: string;
+    };
+    rows: Record<string, MetricRow[]>;
+    decisions: Decision[];
+    policy: Record<string, {
+        name: string;
+        status: string;
+        issues: string[];
+    }[]>;
+};
+export declare function tableOf(rows: MetricRow[]): {
+    concept: string;
+    spendKrw: number;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+    conversions: number;
+    cpaKrw: number | null;
+}[];
+export declare function makeReport(inp: ReportInput): Promise<{
+    text: string;
+    markdown: string;
+    html: string;
+}>;

package/dist/core/report.js

@@ -0,0 +1,34 @@
+// 보고 — 지표를 사람 말로. LLM이 있으면 「이번 주 ○○만원 써서 방문 ○명…」 요약, 없으면 표 기반 문장.
+import { aiAvailable, complete } from './llm.js';
+import { fmtKrw, minorToKrw, minorUnitsPerMajor } from './money.js';
+import { summarize } from './optimize.js';
+export function tableOf(rows) {
+    const s = summarize(rows);
+    const krw = (v, cur) => minorToKrw(Math.round(v * minorUnitsPerMajor(cur)), cur);
+    return s.map((a) => ({ concept: a.concept || a.name, spendKrw: krw(a.spend, a.currency), impressions: a.impressions, clicks: a.clicks, ctr: a.ctr, conversions: a.conversions, cpaKrw: a.conversions ? krw(a.cpa, a.currency) : null }));
+}
+export async function makeReport(inp) {
+    const media = Object.keys(inp.rows);
+    const tables = Object.fromEntries(media.map((m) => [m, tableOf(inp.rows[m])]));
+    const totals = { spend: 0, imp: 0, clicks: 0, conv: 0 };
+    for (const t of Object.values(tables))
+        for (const r of t) {
+            totals.spend += r.spendKrw;
+            totals.imp += r.impressions;
+            totals.clicks += r.clicks;
+            totals.conv += r.conversions;
+        }
+    const goalWord = { traffic: '방문', lead: '문의', signup: '가입', purchase: '구매' }[inp.project.budget.goal];
+    const facts = { period: inp.range, conceptNames: Object.fromEntries((inp.project.concepts || []).map((c) => [c.key, `${c.name} — ${c.headlines[0]}`])), company: inp.project.brief?.company, goal: goalWord, totals, byMedium: tables, decisions: inp.decisions.slice(-20), policy: inp.policy, plan: inp.project.plan?.explain, status: inp.project.status };
+    let text;
+    if (aiAvailable()) {
+        text = await complete({ maxTokens: 1500, system: `너는 광고 운영 담당자다. 광고를 모르는 사장님께 이번 기간 결과를 한국어 존댓말(해요체)로 6~10문장 보고한다. 광고 용어(CTR·CPA·노출·DCO)는 쓰지 말고 사람 말(본 사람·클릭한 사람·1명 데려오는 데 든 돈)로 바꾼다. 숫자는 주어진 것만(만들지 않는다). 구성: ① 얼마 써서 무슨 결과 ② 어느 매체·어느 방향(컨셉)이 잘 됐고 무엇을 줄였는지 ③ 자동 조치가 있었으면 한 줄 ④ 검수·정책 문제가 있으면 한 줄 ⑤ 다음 주 계획 한 줄. 지표가 없으면 「아직 노출 전·검수 중」을 있는 그대로.`, user: JSON.stringify(facts) });
+    }
+    else {
+        text = [`${inp.range.since}~${inp.range.until} 동안 ${fmtKrw(totals.spend)} 을 써서 ${totals.imp.toLocaleString()}명에게 보였고 ${totals.clicks.toLocaleString()}명이 클릭했어요${totals.conv ? `. ${goalWord} ${totals.conv}건 (1건당 ${fmtKrw(totals.spend / totals.conv)})` : ''}.`, ...media.map((m) => { const best = [...tables[m]].sort((a, b) => b.ctr - a.ctr)[0]; return best ? `${m === 'meta' ? '메타' : '구글'}에선 「${best.concept}」 방향이 가장 반응이 좋았어요(클릭률 ${(best.ctr * 100).toFixed(2)}%).` : `${m}: 아직 지표가 없어요.`; })].join(' ');
+    }
+    const md = [`# ${inp.project.brief?.company || inp.project.slug} 광고 보고 (${inp.range.since} ~ ${inp.range.until})`, '', text, '', ...media.flatMap((m) => [`## ${m === 'meta' ? 'Meta' : 'Google'}`, '| 방향 | 쓴 돈 | 본 사람 | 클릭 | 클릭률 | ' + goalWord + ' | 1건당 |', '|---|---|---|---|---|---|---|', ...tables[m].map((r) => `| ${r.concept} | ${fmtKrw(r.spendKrw)} | ${r.impressions.toLocaleString()} | ${r.clicks.toLocaleString()} | ${(r.ctr * 100).toFixed(2)}% | ${r.conversions} | ${r.cpaKrw ? fmtKrw(r.cpaKrw) : '-'} |`), ''])].join('\n');
+    const esc = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;');
+    const html = `<!doctype html><html lang="ko"><head><meta charset="utf-8"><title>${esc(inp.project.brief?.company || inp.project.slug)} 광고 보고</title><style>body{font-family:Pretendard,'Apple SD Gothic Neo',sans-serif;max-width:820px;margin:40px auto;padding:0 20px;color:#0b1526;line-height:1.6}h1{font-size:24px}table{border-collapse:collapse;width:100%;font-size:14px}td,th{border-bottom:1px solid #e3e8ef;padding:8px 10px;text-align:right}th:first-child,td:first-child{text-align:left}.lead{font-size:17px;background:#f4f7fb;border-radius:12px;padding:18px 20px}</style></head><body><h1>${esc(inp.project.brief?.company || inp.project.slug)} 광고 보고 <small style="color:#6b7a90;font-size:14px">${inp.range.since} ~ ${inp.range.until}</small></h1><div class="lead">${esc(text).replace(/\n/g, '<br>')}</div>${media.map((m) => `<h2>${m === 'meta' ? 'Meta' : 'Google'}</h2><table><tr><th>방향</th><th>쓴 돈</th><th>본 사람</th><th>클릭</th><th>클릭률</th><th>${goalWord}</th><th>1건당</th></tr>${tables[m].map((r) => `<tr><td>${esc(String(r.concept))}</td><td>${fmtKrw(r.spendKrw)}</td><td>${r.impressions.toLocaleString()}</td><td>${r.clicks.toLocaleString()}</td><td>${(r.ctr * 100).toFixed(2)}%</td><td>${r.conversions}</td><td>${r.cpaKrw ? fmtKrw(r.cpaKrw) : '-'}</td></tr>`).join('')}</table>`).join('')}</body></html>`;
+    return { text, markdown: md, html };
+}