adyou 0.3.0

package/dist/cli.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+// adyou — ADYou(대행사 없이, 당신이 직접) CLI. 광고주가 AI와 자연어로 광고 전 과정을 직접 한다. 모든 명령은 core/ops를 부른다(MCP도 같은 함수).
+import { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { connectedMedia, connector } from './adapters/index.js';
+import { formatCheck, GOOGLE_GUIDE, META_GUIDE, runCheck } from './core/check.js';
+import { explainBrief } from './core/brief.js';
+import { fmtKrw } from './core/money.js';
+import { dateRange, opAudit, opBuild, opBrief, opChange, opCreatives, opLaunch, opOptimize, opPause, opPlan, opPreview, opReport, opStatus, opTrackSnippet } from './core/ops.js';
+import { tableOf } from './core/report.js';
+import { HOME, loadConfig, loadCredentials, resolveProject, saveConfig, saveCredentials, saveProject, listProjects } from './core/state.js';
+import { verifyLanding, idsOf } from './core/tracking.js';
+const log = (s) => console.log(s);
+const die = (e) => { const m = e instanceof Error ? e.message : String(e); const hint = e?.hint; console.error(`❌ ${m}${hint ? `\n   → ${hint}` : ''}`); process.exit(1); };
+const mediaOpt = (s) => s ? s.split(',').map((x) => x.trim()) : undefined;
+const goalOf = (s) => { const g = { traffic: 'traffic', visit: 'traffic', 방문: 'traffic', lead: 'lead', 문의: 'lead', signup: 'signup', 가입: 'signup', purchase: 'purchase', 구매: 'purchase', sales: 'purchase' }[s.toLowerCase()]; if (!g)
+    throw new Error('목표는 traffic(방문)·lead(문의)·signup(가입)·purchase(구매) 중 하나'); return g; };
+const budgetOf = (s) => { const n = Number(String(s).replace(/[^\d.]/g, '')) * (/만/.test(s) ? 10_000 : 1); if (!n)
+    throw new Error('예산은 숫자(원)로'); return Math.round(n); };
+const program = new Command().name('adyou').description('ADYou — 대행사 없이, 당신이 직접. 광고 대행사가 하던 전 과정을 AI와 직접 — 브리프 · 소재 · Meta/Google 집행(항상 PAUSED 생성) · 추적 · 최적화 · 보고').version('0.1.0').option('-p, --project <slug>', '프로젝트(기본: 마지막 사용)');
+program.command('init').description('처음 시작 — 자격 온보딩 가이드 + 검사기').action(async () => {
+    const media = connectedMedia();
+    log(`adyou 홈: ${HOME}\n연결된 매체: ${media.length ? media.join(', ') : '없음'}\n`);
+    if (!media.includes('meta'))
+        log(`■ Meta(페이스북·인스타그램) 연결 — 약 10분\n   ${META_GUIDE.join('\n   ')}\n`);
+    if (!media.includes('google'))
+        log(`■ Google Ads 연결 — 약 10분 + Explorer 승인\n   ${GOOGLE_GUIDE.join('\n   ')}\n`);
+    log('■ AI 키(선택 · 없으면 규칙 기반)\n   adyou config set llm.apiKey <Anthropic 또는 bizrouter 키>\n   adyou config set image.apiKey <OpenAI 키>   # 배경 이미지 생성\n');
+    log('그 다음: adyou check → adyou brief <사이트 주소> --budget 3000000 --goal signup → adyou creatives → adyou plan → adyou build → adyou preview → adyou launch');
+    if (media.length) {
+        const { items } = await runCheck(null);
+        log('\n현재 검사 결과\n' + formatCheck(items));
+    }
+});
+const connect = program.command('connect').description('매체 자격 저장(~/.adpilot/credentials.json · 0600) + 즉시 검사');
+connect.command('meta').option('--token <t>', '시스템 사용자 토큰').option('--account <act_id>', '광고 계정 id').option('--page <id>', '페이지 id').option('--instagram <id>', '인스타 비즈니스 계정 id').option('--pixel <id>', '픽셀 id').option('--from-env <file>', '오늘 키트의 meta.env를 그대로 읽기').action(async (o) => {
+    const c = loadCredentials();
+    const cur = c.meta || { accessToken: '', adAccountId: '' };
+    if (o.fromEnv) {
+        const kv = Object.fromEntries(fs.readFileSync(o.fromEnv, 'utf8').split('\n').filter((l) => /^[A-Z_]+=/.test(l)).map((l) => { const i = l.indexOf('='); return [l.slice(0, i), l.slice(i + 1).trim()]; }));
+        cur.accessToken = kv.ACCESS_TOKEN || cur.accessToken;
+        cur.adAccountId = kv.AD_ACCOUNT_ID || cur.adAccountId;
+        cur.pageId = kv.PAGE_ID || cur.pageId;
+        cur.instagramActorId = kv.INSTAGRAM_ACTOR_ID || cur.instagramActorId;
+        cur.pixelId = kv.PIXEL_ID || cur.pixelId;
+    }
+    if (o.token)
+        cur.accessToken = o.token;
+    if (o.account)
+        cur.adAccountId = o.account.startsWith('act_') ? o.account : `act_${o.account}`;
+    if (o.page)
+        cur.pageId = o.page;
+    if (o.instagram)
+        cur.instagramActorId = o.instagram;
+    if (o.pixel)
+        cur.pixelId = o.pixel;
+    if (!cur.accessToken || !cur.adAccountId)
+        die(new Error('--token과 --account는 필수예요'));
+    c.meta = cur;
+    saveCredentials(c);
+    log('저장했어요. 검사 중…');
+    const conn = connector('meta');
+    if (conn)
+        log(formatCheck(await conn.check()));
+});
+connect.command('google').option('--sa <file>', '서비스 계정 JSON 키 파일').option('--customer <id>', '10자리 고객 ID').option('--login-customer <id>', 'MCC 경유 시').action(async (o) => {
+    const c = loadCredentials();
+    const cur = c.google || { serviceAccountJson: '', customerId: '' };
+    if (o.sa)
+        cur.serviceAccountJson = path.resolve(o.sa);
+    if (o.customer)
+        cur.customerId = o.customer.replace(/-/g, '');
+    if (o.loginCustomer)
+        cur.loginCustomerId = o.loginCustomer.replace(/-/g, '');
+    if (!cur.serviceAccountJson || !cur.customerId)
+        die(new Error('--sa와 --customer는 필수예요'));
+    c.google = cur;
+    saveCredentials(c);
+    log('저장했어요. 검사 중…');
+    const conn = connector('google');
+    if (conn)
+        log(formatCheck(await conn.check()));
+});
+program.command('check').description('자격·계정·픽셀·랜딩 실측 검사 — 실패 항목마다 어느 화면에서 무엇을 누를지').option('--media <list>', 'meta,google').action(async (o) => {
+    let p = null;
+    try {
+        p = resolveProject(program.opts().project);
+    }
+    catch { /* 프로젝트 없이도 */ }
+    const { items } = await runCheck(p, { media: mediaOpt(o.media) });
+    log(formatCheck(items));
+    const fail = items.filter((i) => i.ok === false).length;
+    log(`\n${items.filter((i) => i.ok === true).length} 통과 · ${fail} 실패 · ${items.filter((i) => i.ok === null).length} 확인 불가`);
+    if (fail)
+        process.exit(2);
+});
+program.command('brief <url>').description('사이트 읽고 브리프 만들기 — 「이 회사는 ○○, 고객은 ○○」').requiredOption('--budget <krw>', '월 예산(원) 예 3000000 · 300만').option('--goal <g>', 'traffic|lead|signup|purchase', 'traffic').option('--markets <list>', '예 KR,US 또는 US:en,JP:ja (기본 사이트 언어로 추정)').option('--hints <text>', '브리프에 반영할 힌트(강조점·금지어)').option('--end <YYYY-MM-DD>', '종료일').action(async (url, o) => {
+    try {
+        const { project, explain } = await opBrief(url, { budget: budgetOf(o.budget), goal: goalOf(o.goal), markets: o.markets, hints: o.hints, endDate: o.end, log });
+        log(`\n${explain}\n\n프로젝트 「${project.slug}」 저장 · 월 ${fmtKrw(project.budget.monthlyKrw)} · 목표 ${project.budget.goal} · 시장 ${project.budget.markets.map((m) => m.country).join(',')}\n맞으면 다음: adyou creatives   (틀리면: adyou brief ${url} --hints "…" 로 다시)`);
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('creatives').description('컨셉·카피 + 이미지 생성 + 12규격 합성 + 규격 검사').option('--concepts <n>', '컨셉 수', '3').option('--feedback <text>', '자연어 수정(「더 고급스럽게」) — 전부 다시 만든다').option('--images <folder>', '직접 준비한 배경 이미지 폴더').option('--no-images', '이미지 생성 없이 브랜드 그래디언트').option('--force', '다시 만들기').action(async (o) => {
+    try {
+        const p = resolveProject(program.opts().project);
+        const { project, report } = await opCreatives(p, { count: Number(o.concepts), feedback: o.feedback, images: o.images, noImages: o.images === false, force: o.force, log });
+        log(`\n컨셉 ${project.concepts.length}개 · 소재 ${project.assets.filter((a) => a.concept !== '_logo').length}장`);
+        for (const c of project.concepts)
+            log(`  · ${c.name}(${c.key}) — ${c.headlines[0]}`);
+        if (report.length)
+            log(`규격 경고 ${report.length}건(빌드 때 자동 맞춤):\n  ${report.join('\n  ')}`);
+        log(`갤러리: ${path.join(HOME, 'projects', project.slug, 'creatives', 'index.html')}\n다음: adyou plan`);
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('plan').description('예산 분할·시장·컨셉 수·매체 구조를 사람 말로').option('--media <list>', 'meta,google').action(async (o) => {
+    try {
+        const p = await opPlan(resolveProject(program.opts().project), { media: mediaOpt(o.media), log });
+        log(p.plan.explain + '\n\n다음: adyou build   (검증만: adyou build --validate)');
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('build').description('매체에 전부 PAUSED로 생성(멱등 · 부분 실패 재실행 안전)').option('--media <list>', 'meta,google').option('--validate', '서버 검증만').action(async (o) => {
+    try {
+        const { project, warnings, errors } = await opBuild(resolveProject(program.opts().project), { media: mediaOpt(o.media), validate: o.validate, log });
+        for (const w of warnings)
+            log(`⚠ ${w}`);
+        for (const e of errors)
+            log(`❌ ${e}`);
+        log(`\n생성물 ${project.placements.length}개 (전부 대기 상태 · 노출 안 됨)`);
+        for (const x of project.placements)
+            log(`  ${x.medium} ${x.kind}${x.concept ? ` ${x.concept}` : ''} ${x.externalId}`);
+        log(errors.length ? '\n일부 실패 — 원인을 고친 뒤 같은 명령을 다시 실행하면 이어서 만들어요.' : '\n다음: adyou preview → adyou launch');
+        if (errors.length)
+            process.exit(2);
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('preview').description('매체 미리보기 HTML(메타 실제 렌더 · 구글 근사)').option('--open', '브라우저로 열기').action(async (o) => {
+    try {
+        const { file, count } = await opPreview(resolveProject(program.opts().project), { log });
+        log(`미리보기 ${count}개 → ${file}`);
+        if (o.open) {
+            const { exec } = await import('node:child_process');
+            exec(`${process.platform === 'darwin' ? 'open' : 'xdg-open'} "${file}"`);
+        }
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('launch').description('승인 → ACTIVE (예산 상한 재확인 · 매체 검수 뒤 노출)').option('--media <list>').option('-y, --yes', '확인 없이').action(async (o) => {
+    try {
+        const p = resolveProject(program.opts().project);
+        log(p.plan?.explain || '');
+        if (!o.yes) {
+            const rl = await import('node:readline/promises');
+            const r = rl.createInterface({ input: process.stdin, output: process.stdout });
+            const a = await r.question('\n이 조건으로 광고를 시작할까요? 시작하는 순간부터 하루 예산이 나가요. (yes/no) ');
+            r.close();
+            if (!/^y(es)?$/i.test(a.trim())) {
+                log('취소했어요.');
+                return;
+            }
+        }
+        const { launched, errors } = await opLaunch(p, { media: mediaOpt(o.media), log, yes: true });
+        for (const e of errors)
+            log(`❌ ${e}`);
+        log(launched.length ? `\n✅ ${launched.join(', ')} 켰어요. 메타 검수 24시간 이내 · 구글 1영업일. \`adyou status\` 로 확인.` : '켜진 매체가 없어요.');
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('pause').description('전부 끄기(즉시)').option('--media <list>').action(async (o) => { try {
+    const { paused, errors } = await opPause(resolveProject(program.opts().project), { media: mediaOpt(o.media), log });
+    for (const e of errors)
+        log(`❌ ${e}`);
+    log(paused.length ? `⏸ ${paused.join(', ')} 껐어요.` : '끈 매체가 없어요.');
+}
+catch (e) {
+    die(e);
+} });
+program.command('budget <krw>').description('월 예산 바꾸기(계획·매체 일 예산 즉시 반영)').action(async (krw) => { try {
+    const p = resolveProject(program.opts().project);
+    p.budget.monthlyKrw = budgetOf(krw);
+    saveProject(p);
+    if (p.plan) {
+        await opPlan(p, { log });
+        for (const pm of p.plan.media) {
+            const c = connector(pm.medium);
+            if (c && p.placements.length)
+                await c.updateBudget(p.placements, pm.dailyBudgetMinor);
+        }
+        log(p.plan.explain);
+    }
+    else
+        log(`월 예산 ${fmtKrw(p.budget.monthlyKrw)} 저장`);
+}
+catch (e) {
+    die(e);
+} });
+program.command('status').description('지표·검수 상태(최근 7일)').option('--days <n>', '기간', '7').action(async (o) => {
+    try {
+        const p = resolveProject(program.opts().project);
+        log(`프로젝트 ${p.slug} · 상태 ${p.status} · 월 ${fmtKrw(p.budget.monthlyKrw)} · 생성물 ${p.placements.length}`);
+        const st = await opStatus(p, { days: Number(o.days) });
+        for (const m of Object.keys(st.metrics)) {
+            log(`\n[${m}] ${st.range.since}~${st.range.until}`);
+            const t = tableOf(st.metrics[m]);
+            if (!t.length)
+                log('  지표 없음(검수 중·노출 전)');
+            for (const r of t)
+                log(`  ${String(r.concept).padEnd(12)} 쓴 돈 ${fmtKrw(r.spendKrw).padStart(10)} · 노출 ${String(r.impressions).padStart(7)} · 클릭 ${String(r.clicks).padStart(5)} · CTR ${(r.ctr * 100).toFixed(2)}% · 전환 ${r.conversions}`);
+            for (const pr of st.policy[m] || [])
+                log(`  검수 ${pr.name}: ${pr.status}${pr.issues.length ? ` — ${pr.issues.join('; ')}` : ''}`);
+        }
+    }
+    catch (e) {
+        die(e);
+    }
+});
+program.command('optimize').description('규칙 기반 제안(소재 끄기·예산 ±20%) · --apply로 실행').option('--apply').action(async (o) => { try {
+    const { proposals, applied } = await opOptimize(resolveProject(program.opts().project), { apply: o.apply, log });
+    for (const pr of proposals)
+        log(`${pr.kind === 'note' ? '·' : '→'} [${pr.medium}] ${pr.reason}`);
+    if (o.apply)
+        log(applied.length ? `\n적용: ${applied.join(' · ')}` : '\n적용할 것이 없었어요.');
+    else if (proposals.some((x) => x.kind !== 'note'))
+        log('\n실행하려면: adyou optimize --apply');
+}
+catch (e) {
+    die(e);
+} });
+program.command('report').description('사람 말 보고서(HTML·MD)').option('--days <n>', '7').option('--open').action(async (o) => { try {
+    const r = await opReport(resolveProject(program.opts().project), { days: Number(o.days || 7) });
+    log(r.text + `\n\n→ ${r.file}`);
+    if (o.open) {
+        const { exec } = await import('node:child_process');
+        exec(`open "${r.file}"`);
+    }
+}
+catch (e) {
+    die(e);
+} });
+program.command('audit').description('현재 계정의 모든 캠페인·광고 전수 조회 + 진단(BYO 인수)').option('--media <list>').action(async (o) => { try {
+    const r = await opAudit({ media: mediaOpt(o.media) });
+    for (const [m, v] of Object.entries(r)) {
+        log(`\n[${m}] 캠페인 ${v.rows.filter((x) => x.level === 'campaign').length} · 광고 ${v.rows.filter((x) => x.level === 'ad').length}`);
+        for (const c of v.rows.filter((x) => x.level === 'campaign'))
+            log(`  ${c.status.padEnd(8)} ${c.name.slice(0, 50).padEnd(50)} 30일 ${c.spend30d ?? 0} · 노출 ${c.impressions30d ?? 0} · 클릭 ${c.clicks30d ?? 0}`);
+        log(v.findings.length ? `  진단:\n  - ${v.findings.join('\n  - ')}` : '  진단: 특이사항 없음');
+    }
+}
+catch (e) {
+    die(e);
+} });
+program.command('change <request...>').description('자연어로 바꾸기 — "예산 200만원으로" "미국 빼" "더 고급스럽게"').action(async (words) => { try {
+    const { summary, steps } = await opChange(resolveProject(program.opts().project), words.join(' '), { log });
+    log(`${summary}\n${steps.map((s) => `  · ${s}`).join('\n')}`);
+}
+catch (e) {
+    die(e);
+} });
+const track = program.command('track').description('추적 스니펫 발급·랜딩 검증');
+track.command('install').option('--spa', 'SPA PageView 수동 전송 포함').option('--pixel <id>').option('--gtag <AW-id>').option('--label <l>').option('--ga4 <G-id>').action(async (o) => { try {
+    const p = resolveProject(program.opts().project);
+    p.tracking = { ...(p.tracking || {}), ...(o.pixel ? { pixelId: o.pixel } : {}), ...(o.gtag ? { gtagId: o.gtag } : {}), ...(o.label ? { gtagLabel: o.label } : {}), ...(o.ga4 ? { ga4Id: o.ga4 } : {}) };
+    saveProject(p);
+    const s = opTrackSnippet(p, { spa: o.spa });
+    log(`■ 모든 페이지 <head>\n${s.head}\n\n■ 목표 달성 화면\n${s.conversion}\n\n■ CSP를 쓰면 script-src·connect-src·img-src 에: ${s.csp.join(' ')}\n\n붙인 뒤: adyou track verify`);
+}
+catch (e) {
+    die(e);
+} });
+track.command('verify').action(async () => { try {
+    const p = resolveProject(program.opts().project);
+    const items = await verifyLanding(p.url, idsOf(p));
+    const meta = connector('meta');
+    if (meta && p.tracking?.pixelId && 'pixelTrafficPermission' in meta)
+        items.push(await meta.pixelTrafficPermission(p.url));
+    log(formatCheck(items));
+}
+catch (e) {
+    die(e);
+} });
+const config = program.command('config').description('설정 보기/바꾸기 (llm.apiKey · llm.baseUrl · llm.model · image.apiKey · fx.USD …)');
+config.command('set <key> <value>').action((k, v) => { const c = loadConfig(); const [a, b] = k.split('.'); if (!b)
+    die(new Error('키는 llm.apiKey처럼 두 단계')); const sec = (c[a] || {}); sec[b] = a === 'fx' ? Number(v) : v; c[a] = sec; saveConfig(c); log(`${k} 저장`); });
+config.command('get').action(() => { const c = loadConfig(); log(JSON.stringify({ ...c, llm: c.llm ? { ...c.llm, apiKey: c.llm.apiKey ? '••••' : undefined } : undefined, image: c.image ? { ...c.image, apiKey: c.image.apiKey ? '••••' : undefined } : undefined }, null, 2)); });
+program.command('projects').description('프로젝트 목록').action(() => { for (const s of listProjects())
+    log(`  ${s}${loadConfig().lastProject === s ? '  (현재)' : ''}`); });
+program.command('mcp').description('MCP 서버(stdio) — Claude Code·Cursor·bizcoder에서 같은 툴을 자연어로').action(async () => { const { startMcp } = await import('./mcp.js'); await startMcp(); });
+program.command('range').description('(내부) 최근 N일 범위').option('--days <n>', '7').action((o) => log(JSON.stringify(dateRange(Number(o.days)))));
+program.command('explain').description('현재 브리프·계획 다시 보기').action(() => { try {
+    const p = resolveProject(program.opts().project);
+    if (p.brief)
+        log(explainBrief(p.brief));
+    if (p.plan)
+        log('\n' + p.plan.explain);
+}
+catch (e) {
+    die(e);
+} });
+program.parseAsync(process.argv).catch(die);

package/dist/core/brief.d.ts

@@ -0,0 +1,12 @@
+import type { Brief, Goal, Market } from './state.js';
+import { type SiteSnapshot } from './site.js';
+export declare function detectSpecialCategory(text: string): string | null;
+export declare function buildBrief(url: string, opts: {
+    goal: Goal;
+    markets: Market[];
+    hints?: string;
+}): Promise<{
+    brief: Brief;
+    site: SiteSnapshot;
+}>;
+export declare function explainBrief(b: Brief): string;

package/dist/core/brief.js

@@ -0,0 +1,71 @@
+// 브리프 — 사이트 스냅샷 → 「이 회사는 ○○를 팔고 고객은 ○○로 보여요」. LLM이 있으면 LLM, 없으면 규칙으로 최소 브리프.
+import { z } from 'zod';
+import { aiAvailable, completeJson } from './llm.js';
+import { readSite } from './site.js';
+/** 특별 광고 카테고리(정치·금융·주택·고용·의료·도박 등)는 자동 심사 통과가 어려워 접수 거절 */
+const SPECIAL = [
+    [/대출|카드론|신용|투자|주식|코인|암호화폐|보험|loan|crypto|forex|insurance|invest/i, '금융(대출·투자·보험·암호화폐)'],
+    [/카지노|베팅|도박|casino|betting|gambl/i, '도박'],
+    [/정당|선거|후보|political|election/i, '정치·선거'],
+    [/처방|치료제|병원|의약|clinic|pharma|treatment/i, '의료·의약'],
+    [/담배|전자담배|vape|tobacco/i, '담배'],
+    [/성인|adult\s*content|19금/i, '성인'],
+];
+export function detectSpecialCategory(text) { for (const [r, n] of SPECIAL)
+    if (r.test(text))
+        return n; return null; }
+const BriefSchema = z.object({
+    company: z.string(), offer: z.string(), category: z.string(),
+    audience: z.array(z.string()).min(1).max(5), usp: z.array(z.string()).min(1).max(6), tone: z.string(),
+    language: z.string().default('ko'),
+    palette: z.object({ primary: z.string(), dark: z.string(), light: z.string() }),
+    specialCategory: z.string().nullable().default(null),
+    notes: z.string().default(''),
+});
+function pickPalette(s) {
+    const primary = (s.themeColor && /^#[0-9a-f]{6}$/i.test(s.themeColor) ? s.themeColor : s.colors.find((c) => !/^#([0-9a-f])\1{5}$/i.test(c) && !/^#(f[0-9a-f]f[0-9a-f]f[0-9a-f]|[0-2][0-9a-f]{5})$/i.test(c))) || '#3182f6';
+    return { primary: primary.toLowerCase(), dark: '#0b1526', light: '#f5f8fc' };
+}
+export async function buildBrief(url, opts) {
+    const site = await readSite(url);
+    if (site.status >= 400)
+        throw new Error(`사이트를 읽지 못했어요 (HTTP ${site.status}). 주소를 확인해 주세요.`);
+    const fallbackPalette = pickPalette(site);
+    const special = detectSpecialCategory(`${site.title} ${site.description} ${site.headings.join(' ')}`);
+    let brief;
+    if (aiAvailable()) {
+        const out = await completeJson({
+            schema: BriefSchema, maxTokens: 2000,
+            system: `너는 광고 기획자다. 사이트 내용을 읽고 광고 브리프를 만든다. 광고 용어 없이 사장님이 읽어도 바로 이해할 사람 말로 쓴다. 한국어 존댓말이 아닌 명사형·짧은 문장. 과장·추정 금지: 사이트에 없는 사실을 만들지 않는다.
+- company: 회사/브랜드 이름(사이트 표기 그대로)
+- offer: 무엇을 파는지 한 문장(누구에게 어떤 가치를)
+- category: 업종 한 단어~두 단어
+- audience: 핵심 고객 유형 2~4개(예 「마케터 없는 중소기업 대표」)
+- usp: 광고에 쓸 강점·증거 3~5개(사이트에 근거가 있는 것만)
+- tone: 브랜드 말투(예 「단정하고 실무적」)
+- language: 광고 카피 기본 언어 코드(사이트 언어 · 시장이 해외면 그 언어)
+- palette: 사이트에서 읽힌 대표색 hex(primary) · 어두운 배경색(dark) · 밝은 배경색(light). 못 읽으면 후보를 그대로.
+- specialCategory: 금융·의료·정치·도박·담배·성인 등 특별 광고 카테고리에 해당하면 그 이름, 아니면 null
+- notes: 광고 만들 때 주의할 점 한두 문장(가격 표기·금지어 등)`,
+            user: JSON.stringify({ url: site.finalUrl, title: site.title, description: site.description, lang: site.lang, headings: site.headings, prices: site.prices, colorsFound: site.colors.slice(0, 8), themeColor: site.themeColor, textExcerpt: site.text.slice(0, 3500), goal: opts.goal, markets: opts.markets, hints: opts.hints || '' }),
+        });
+        brief = { url: site.finalUrl, ...out, palette: { primary: /^#[0-9a-f]{6}$/i.test(out.palette.primary) ? out.palette.primary.toLowerCase() : fallbackPalette.primary, dark: /^#[0-9a-f]{6}$/i.test(out.palette.dark) ? out.palette.dark : fallbackPalette.dark, light: /^#[0-9a-f]{6}$/i.test(out.palette.light) ? out.palette.light : fallbackPalette.light }, logoUrl: site.logo, ogImage: site.ogImage, specialCategory: out.specialCategory || special };
+    }
+    else {
+        brief = { url: site.finalUrl, company: site.title.split(/[|·—\-–:]/)[0].trim() || new URL(site.finalUrl).hostname, offer: site.description || site.headings[0] || site.title, category: '', audience: ['사이트 방문자'], usp: site.headings.slice(0, 3), tone: '단정하고 명확', language: site.lang || 'ko', palette: fallbackPalette, logoUrl: site.logo, ogImage: site.ogImage, specialCategory: special, notes: 'LLM 키가 없어 규칙으로 만든 최소 브리프예요. `adpilot brief --edit` 로 다듬어 주세요.' };
+    }
+    return { brief, site };
+}
+export function explainBrief(b) {
+    const lines = [
+        `이 회사는 「${b.company}」 — ${b.offer}`,
+        `고객은 ${b.audience.join(' · ')} 로 보여요.`,
+        `광고에서 내세울 강점: ${b.usp.map((u) => `「${u}」`).join(' ')}`,
+        `말투는 ${b.tone} · 카피 언어 ${b.language} · 대표색 ${b.palette.primary}`,
+    ];
+    if (b.specialCategory)
+        lines.push(`⚠ 「${b.specialCategory}」 특별 광고 카테고리로 보여요 — 매체 정책상 자동 집행 대상이 아니어서 접수할 수 없어요.`);
+    if (b.notes)
+        lines.push(`메모: ${b.notes}`);
+    return lines.join('\n');
+}

package/dist/core/check.d.ts

@@ -0,0 +1,11 @@
+import type { CheckItem, Medium } from '../adapters/types.js';
+import type { Project } from './state.js';
+export declare const META_GUIDE: string[];
+export declare const GOOGLE_GUIDE: string[];
+export declare function runCheck(p: Project | null, opts?: {
+    media?: Medium[];
+}): Promise<{
+    items: CheckItem[];
+    media: Medium[];
+}>;
+export declare function formatCheck(items: CheckItem[]): string;

package/dist/core/check.js

@@ -0,0 +1,55 @@
+// 온보딩 검사기 — 매체 자격·계정·픽셀·랜딩을 실측 판정하고, 실패 항목마다 「어느 화면에서 무엇을 누르라」를 낸다.
+import { connectedMedia, connector } from '../adapters/index.js';
+import { aiAvailable } from './llm.js';
+import { imagesAvailable } from './creatives/images.js';
+import { idsOf, verifyLanding } from './tracking.js';
+export const META_GUIDE = [
+    '1. business.facebook.com에 비즈니스 포트폴리오·광고 계정·결제수단·페이지가 있는지 확인(없으면 만들기).',
+    '2. developers.facebook.com/apps › 앱 만들기(비즈니스) › 사용 사례 「Marketing API」 추가 › 상단 앱 모드를 **라이브**로(심사 불필요).',
+    '3. Business Suite › 설정 › 사용자 › 시스템 사용자 › 추가(관리자) › 자산 할당: 광고 계정·페이지·픽셀.',
+    '4. 앱 › 앱 역할 › 시스템 사용자를 관리자로 추가.',
+    '5. 시스템 사용자 › 토큰 생성 › 앱 선택 › 권한 ads_management · ads_read · business_management · pages_show_list · pages_read_engagement · pages_manage_ads › 토큰 복사.',
+    '6. `adpilot connect meta --token <토큰> --account act_… --page <페이지 id> [--pixel <픽셀 id>]`',
+    '7. 픽셀이 있으면 이벤트 관리자 › 픽셀 › 설정 › 트래픽 권한 허용 목록에 랜딩 도메인 추가.',
+];
+export const GOOGLE_GUIDE = [
+    '1. ads.google.com에 광고 계정(통화·결제수단)이 있는지 확인. 첫 캠페인 만들기 화면은 「전문가 모드」로 건너뛰기.',
+    '2. console.cloud.google.com › 새 프로젝트 › API 라이브러리에서 Google Ads API 사용 설정.',
+    '3. IAM › 서비스 계정 만들기 › 키(JSON) 내려받기.',
+    '4. 광고 계정 › 관리자 › 액세스 및 보안 › 사용자 + › 서비스 계정 이메일 · 권한 표준(이상) › 추가.',
+    '5. Cloud Console › Google Ads API 개요 › 액세스 수준 → **Explorer 신청**(자동 승인 · 프로젝트 소유 계정으로 로그인 · 조직 계정은 재인증 챌린지가 뜰 수 있음).',
+    '6. `adpilot connect google --sa <키.json> --customer <10자리 고객 ID> [--login-customer <MCC>]`',
+];
+export async function runCheck(p, opts = {}) {
+    const media = opts.media && opts.media.length ? opts.media : connectedMedia();
+    const items = [];
+    items.push({ key: 'ai.llm', ok: aiAvailable() ? true : null, title: 'AI(LLM) 키', detail: aiAvailable() ? '설정됨' : '없음 — 브리프·카피·보고서는 규칙 기반 최소 버전으로 만들어져요', fix: aiAvailable() ? undefined : '`adpilot config set llm.apiKey <키>` (Anthropic 또는 bizrouter 키)' });
+    items.push({ key: 'ai.image', ok: imagesAvailable() ? true : null, title: '이미지 생성 키', detail: imagesAvailable() ? '설정됨' : '없음 — 배경은 브랜드색 그래디언트로 만들어요', fix: imagesAvailable() ? undefined : '`adpilot config set image.apiKey <OpenAI 키>` 또는 `--images <폴더>` 로 직접 이미지 제공' });
+    for (const m of ['meta', 'google']) {
+        const c = connector(m);
+        if (!c) {
+            items.push({ key: `${m}.connected`, ok: false, title: `${m === 'meta' ? 'Meta' : 'Google'} 연결`, detail: '자격이 없어요', fix: (m === 'meta' ? META_GUIDE : GOOGLE_GUIDE).join('\n   ') });
+            continue;
+        }
+        if (!media.includes(m))
+            continue;
+        try {
+            items.push(...(await c.check(p?.url)));
+        }
+        catch (e) {
+            items.push({ key: `${m}.check`, ok: false, title: `${m} 검사 실패`, detail: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    if (p) {
+        try {
+            items.push(...(await verifyLanding(p.url, idsOf(p))));
+        }
+        catch (e) {
+            items.push({ key: 'landing', ok: false, title: '랜딩 검사', detail: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return { items, media };
+}
+export function formatCheck(items) {
+    return items.map((i) => `${i.ok === true ? '✅' : i.ok === false ? '❌' : '➖'} ${i.title} — ${i.detail}${i.fix ? `\n   → ${i.fix}` : ''}${i.link ? `\n   ${i.link}` : ''}`).join('\n');
+}

package/dist/core/creatives/copy.d.ts

@@ -0,0 +1,14 @@
+import type { Brief, Concept, Goal } from '../state.js';
+import { wlen } from './specs.js';
+export declare function generateConcepts(brief: Brief, opts: {
+    goal: Goal;
+    count: number;
+    feedback?: string;
+    previous?: Concept[];
+}): Promise<Concept[]>;
+/** 매체별 카피 규격 검사 요약 */
+export declare function validateConcepts(concepts: Concept[]): {
+    ok: boolean;
+    report: string[];
+};
+export { wlen };

package/dist/core/creatives/copy.js

@@ -0,0 +1,52 @@
+// 컨셉·카피 — 브리프 → 컨셉 3~5(혜택·증거·긴급·비교·감성) × 제목 5·본문 5·설명 2·CTA. 규격 검사(specs.checkCopy)를 통과할 때까지 다듬는다.
+import { z } from 'zod';
+import { aiAvailable, completeJson } from '../llm.js';
+import { checkCopy, ctaFor, fit, GOOGLE_LIMITS, wlen } from './specs.js';
+const ConceptSchema = z.object({
+    key: z.string().regex(/^[a-z][a-z0-9_]{1,19}$/), name: z.string(), angle: z.string(),
+    headlines: z.array(z.string()).min(3).max(6), bodies: z.array(z.string()).min(2).max(6), descriptions: z.array(z.string()).min(1).max(3),
+    imagePrompt: z.string(), theme: z.enum(['dark', 'light']).default('dark'),
+});
+export async function generateConcepts(brief, opts) {
+    const cta = ctaFor(opts.goal);
+    if (!aiAvailable())
+        return fallbackConcepts(brief, opts);
+    const out = await completeJson({
+        schema: z.object({ concepts: z.array(ConceptSchema).min(1) }), maxTokens: 6000, timeoutMs: 120_000,
+        system: `너는 퍼포먼스 광고 카피라이터이자 아트디렉터다. 브리프로 서로 다른 각도의 광고 컨셉 ${opts.count}개를 만든다(혜택·증거/사회적 증명·긴급/희소·비교/대안·감성 중에서 고르되 겹치지 않게).
+규칙:
+- 언어는 brief.language. 사실은 브리프(usp·offer)에 있는 것만. 과장·최상급(최고·1위·100%·보장·무조건)·클릭 유도 금지.
+- headlines: 짧은 제목 5개 — 각각 ${GOOGLE_LIMITS.headline}자(한글·전각은 2자로 셈 → 한글 15자) 이내. 첫 번째는 그 컨셉의 대표 문장.
+- bodies: 본문 5개 — 60~120자. 구체적 혜택·근거·누구를 위한 것인지. 존댓말(해요체).
+- descriptions: 설명 2개 — 각각 ${GOOGLE_LIMITS.description}자(한글 45자) 이내.
+- imagePrompt: 배경 비주얼 생성 프롬프트(영어). 글자·로고·UI 절대 없음. 헤드라인을 올릴 넉넉한 여백. 브랜드색 ${brief.palette.primary}. 실존 인물·타사 로고 금지.
+- theme: 어두운 배경(dark)이 어울리면 dark, 밝고 가벼우면 light.
+- key: 영문 소문자 짧은 식별자(예 benefit·proof·urgency).${opts.feedback ? `\n사용자 수정 요청: 「${opts.feedback}」 — 이 요청을 반영해 전부 다시 만든다.` : ''}`,
+        user: JSON.stringify({ brief, goal: opts.goal, cta, previous: opts.previous?.map((c) => ({ key: c.key, name: c.name, angle: c.angle, headline: c.headlines[0] })) }),
+    });
+    const concepts = out.concepts.slice(0, opts.count).map((c) => ({ ...c, cta: cta.meta, headlines: c.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean), descriptions: c.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean), bodies: c.bodies.map((b) => b.trim()).filter(Boolean) }));
+    return concepts;
+}
+function fallbackConcepts(brief, opts) {
+    const cta = ctaFor(opts.goal);
+    const base = brief.usp.length ? brief.usp : [brief.offer];
+    return base.slice(0, opts.count).map((u, i) => ({
+        key: ['benefit', 'proof', 'urgency', 'compare', 'emotion'][i] || `c${i}`, name: `컨셉 ${i + 1}`, angle: u, cta: cta.meta, theme: 'dark',
+        headlines: [fit(u, GOOGLE_LIMITS.headline), fit(brief.company, GOOGLE_LIMITS.headline), fit(brief.offer, GOOGLE_LIMITS.headline)].filter(Boolean),
+        bodies: [`${brief.offer} ${brief.company}에서 확인해 보세요.`, `${u}. ${brief.company}.`],
+        descriptions: [fit(brief.offer, GOOGLE_LIMITS.description)],
+        imagePrompt: `Abstract premium background in ${brief.palette.primary} and deep navy, soft gradients, no text, no logos, generous empty space`,
+    }));
+}
+/** 매체별 카피 규격 검사 요약 */
+export function validateConcepts(concepts) {
+    const report = [];
+    for (const c of concepts)
+        for (const m of ['meta', 'google']) {
+            const r = checkCopy(c, m);
+            for (const p of r.problems)
+                report.push(`[${c.key}/${m}] ${p}`);
+        }
+    return { ok: !report.length, report };
+}
+export { wlen };

package/dist/core/creatives/images.d.ts

@@ -0,0 +1,9 @@
+export declare function imageConfig(): {
+    key: string;
+    model: string;
+} | null;
+export declare function imagesAvailable(): boolean;
+/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). */
+export declare function generateBackgrounds(dir: string, conceptKey: string, prompt: string, ratios?: string[], log?: (s: string) => void): Promise<Record<string, string | null>>;
+/** 사용자 이미지 폴더 → 비율별 배경 매핑(가장 가까운 비율) */
+export declare function userBackgrounds(folder: string, conceptKey: string): Record<string, string | null>;

package/dist/core/creatives/images.js

@@ -0,0 +1,89 @@
+// 배경 이미지 — OpenAI Images(gpt-image)로 비율 4종 생성. 키가 없으면 null → 렌더러가 브랜드 그래디언트로 대신한다. 사용자가 준 이미지(--images 폴더)도 그대로 배경으로 쓴다.
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadConfig } from '../state.js';
+import { BG_RATIOS } from './specs.js';
+export function imageConfig() {
+    const c = loadConfig().image || {};
+    const key = process.env.ADPILOT_IMAGE_KEY || process.env.OPENAI_API_KEY || c.apiKey;
+    if (!key)
+        return null;
+    return { key, model: process.env.ADPILOT_IMAGE_MODEL || c.model || 'gpt-image-2.5-flare' };
+}
+export function imagesAvailable() { return imageConfig() !== null; }
+const STYLE = 'Premium advertising key visual, cinematic, editorial quality, photoreal render or refined abstract. ABSOLUTELY NO text, letters, numbers, logos, watermarks, UI, or real people\'s faces. Composition leaves large calm negative space for a headline overlay.';
+/** 컨셉 × 비율 배경 생성 → 파일 경로. 이미 있으면 건너뜀(재실행 안전). */
+export async function generateBackgrounds(dir, conceptKey, prompt, ratios = Object.keys(BG_RATIOS), log = () => { }) {
+    const cfg = imageConfig();
+    const out = {};
+    const one = async (r) => {
+        const file = path.join(dir, `bg_${conceptKey}_${r}.png`);
+        if (fs.existsSync(file)) {
+            out[r] = file;
+            return;
+        }
+        if (!cfg) {
+            out[r] = null;
+            return;
+        }
+        let size = BG_RATIOS[r].openai;
+        let model = cfg.model;
+        const FALLBACK = ['gpt-image-2.5-flare', 'gpt-image-2', 'gpt-image-1.5', 'gpt-image-1'];
+        for (let attempt = 0; attempt < 5; attempt++) {
+            try {
+                const res = await fetch('https://api.openai.com/v1/images/generations', { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model, prompt: `${prompt} ${STYLE}`, size, quality: 'high', n: 1 }), signal: AbortSignal.timeout(300_000) });
+                if (!res.ok) {
+                    const t = await res.text();
+                    if (res.status === 400 && /does not exist|model/i.test(t) && /model/i.test(t) && !/size/i.test(t)) {
+                        const next = FALLBACK.find((m) => m !== model && FALLBACK.indexOf(m) > FALLBACK.indexOf(model)) || FALLBACK.find((m) => m !== model);
+                        if (next) {
+                            log(`  ${conceptKey} ${r}: 모델 ${model} 없음 → ${next}`);
+                            model = next;
+                            continue;
+                        }
+                    }
+                    if (res.status === 400 && /size/i.test(t) && size !== '1024x1024') {
+                        log(`  ${conceptKey} ${r}: 이 모델은 ${size} 를 지원하지 않아요 → 1024x1024`);
+                        size = '1024x1024';
+                        continue;
+                    }
+                    if (res.status === 400 || res.status === 401 || res.status === 403)
+                        throw Object.assign(new Error(`${res.status} ${t.slice(0, 200)}`), { fatal: true });
+                    throw new Error(`${res.status} ${t.slice(0, 200)}`);
+                }
+                const d = (await res.json());
+                const b64 = d.data[0]?.b64_json;
+                if (b64)
+                    fs.writeFileSync(file, Buffer.from(b64, 'base64'));
+                else if (d.data[0]?.url)
+                    fs.writeFileSync(file, Buffer.from(await (await fetch(d.data[0].url)).arrayBuffer()));
+                else
+                    throw new Error('이미지 응답이 비었어요');
+                out[r] = file;
+                log(`  배경 ${conceptKey} ${r} ✓`);
+                return;
+            }
+            catch (e) {
+                if (e.fatal) {
+                    log(`  ${conceptKey} ${r}: 이미지 생성 실패 — ${e.message.slice(0, 160)} (브랜드 그래디언트로 대체)`);
+                    out[r] = null;
+                    return;
+                }
+                log(`  ${conceptKey} ${r}: 이미지 생성 재시도 (${e instanceof Error ? e.message.slice(0, 120) : e})`);
+                await new Promise((r2) => setTimeout(r2, 3000 * (attempt + 1)));
+            }
+        }
+        out[r] = null;
+    };
+    await Promise.all(ratios.map(one));
+    return out;
+}
+/** 사용자 이미지 폴더 → 비율별 배경 매핑(가장 가까운 비율) */
+export function userBackgrounds(folder, conceptKey) {
+    const files = fs.readdirSync(folder).filter((f) => /\.(png|jpe?g|webp)$/i.test(f)).map((f) => path.join(folder, f));
+    const out = {};
+    const pick = files.find((f) => path.basename(f).toLowerCase().includes(conceptKey)) || files[0] || null;
+    for (const r of Object.keys(BG_RATIOS))
+        out[r] = files.find((f) => path.basename(f).includes(r)) || pick;
+    return out;
+}