adyou 0.4.0 → 0.5.1

package/dist/core/creatives/render.js

@@ -9,7 +9,35 @@ import { HOME } from '../state.js';
 import { SIZES } from './specs.js';
 const FONT_CDN = 'https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard/dist/public/static';
 const WEIGHTS = [['Pretendard-ExtraBold', 800], ['Pretendard-Bold', 700], ['Pretendard-Medium', 500]];
-export async function loadFonts() {
+/** 언어별 글꼴 폴백 — Pretendard 는 한글·라틴만. 일본어=Pretendard JP(가나·한자) · 중국어=Noto Sans TC/SC · 태국어=Noto Sans Thai. 같은 family 이름으로 넣어 satori 가 빠진 글리프를 다음 글꼴에서 찾게 한다. */
+// 🔴 satori 는 같은 family 이름 안에서는 글리프 폴백을 안 한다(2026-09-16 실측 · 한자 tofu) → 언어별 글꼴은 다른 family 이름으로 넣고 fontFamily 목록으로 폴백
+const EXTRA_FONTS = {
+    ja: [['https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard-jp/dist/public/static/PretendardJP-ExtraBold.otf', 'PretendardJP-ExtraBold.otf', 800, 'PretendardJP'], ['https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard-jp/dist/public/static/PretendardJP-Bold.otf', 'PretendardJP-Bold.otf', 700, 'PretendardJP'], ['https://cdn.jsdelivr.net/gh/orioncactus/pretendard@v1.3.9/packages/pretendard-jp/dist/public/static/PretendardJP-Medium.otf', 'PretendardJP-Medium.otf', 500, 'PretendardJP']],
+    'zh-TW': [['https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/OTF/TraditionalChinese/NotoSansCJKtc-Bold.otf', 'NotoSansCJKtc-Bold.otf', 700, 'NotoCJKtc']],
+    zh: [['https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/OTF/SimplifiedChinese/NotoSansCJKsc-Bold.otf', 'NotoSansCJKsc-Bold.otf', 700, 'NotoCJKsc']],
+    th: [['https://cdn.jsdelivr.net/gh/notofonts/notofonts.github.io@main/fonts/NotoSansThai/full/ttf/NotoSansThai-Bold.ttf', 'NotoSansThai-Bold.ttf', 700, 'NotoThai']],
+};
+export const FONT_FAMILY = 'Pretendard, PretendardJP, NotoCJKtc, NotoCJKsc, NotoThai';
+const fontCache = new Map();
+async function fetchFont(dir, url, file) {
+    const p = path.join(dir, file);
+    if (!fs.existsSync(p)) {
+        try {
+            const res = await fetch(url, { signal: AbortSignal.timeout(90_000) });
+            if (!res.ok)
+                return null;
+            fs.writeFileSync(p, Buffer.from(await res.arrayBuffer()));
+        }
+        catch {
+            return null;
+        }
+    }
+    return fs.readFileSync(p);
+}
+export async function loadFonts(lang) {
+    const key = lang ? (EXTRA_FONTS[lang] ? lang : EXTRA_FONTS[lang.split('-')[0]] ? lang.split('-')[0] : '') : '';
+    if (fontCache.has(key))
+        return fontCache.get(key);
     const dir = path.join(HOME, 'fonts');
     fs.mkdirSync(dir, { recursive: true });
     const out = [];
@@ -26,6 +54,12 @@ export async function loadFonts() {
         const buf = fs.readFileSync(p);
         out.push({ name: 'Pretendard', data: buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength), weight: weight, style: 'normal' });
     }
+    for (const [url, file, weight, family] of EXTRA_FONTS[key] || []) {
+        const buf = await fetchFont(dir, url, file);
+        if (buf)
+            out.push({ name: family, data: buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength), weight: weight, style: 'normal' });
+    }
+    fontCache.set(key, out);
     return out;
 }
 /** 🔴 확장자가 아니라 바이트로 MIME 판별 — Gemini 이미지 API 는 .png 요청에도 JPEG 를 돌려준다(2026-09-16 실측 · 잘못된 MIME 이면 satori 가 배경을 조용히 버림) */
@@ -114,7 +148,7 @@ export function tree(size, concept, brief, bg, logo, ctaText) {
             banner ? h('div', {}, '') : h('div', { display: 'flex', justifyContent: 'space-between', fontSize: Math.round(headFs * 0.28), fontWeight: 500, color: sub }, [h('div', {}, brief.company), h('div', {}, domain)]),
         ]));
     }
-    return h('div', { width: w, height: hh, display: 'flex', position: 'relative', overflow: 'hidden', fontFamily: 'Pretendard', backgroundColor: dark ? brief.palette.dark : brief.palette.light, ...bgStyle }, children);
+    return h('div', { width: w, height: hh, display: 'flex', position: 'relative', overflow: 'hidden', fontFamily: FONT_FAMILY, backgroundColor: dark ? brief.palette.dark : brief.palette.light, ...bgStyle }, children);
 }
 export const CTA_LABEL = {
     ko: { LEARN_MORE: '자세히 보기', SIGN_UP: '지금 시작하기', SHOP_NOW: '지금 구매', CONTACT_US: '문의하기', DOWNLOAD: '내려받기', GET_OFFER: '혜택 받기', GET_QUOTE: '견적 받기', SUBSCRIBE: '구독하기', APPLY_NOW: '지금 신청', ORDER_NOW: '지금 주문', BUY_NOW: '지금 구매', BOOK_TRAVEL: '예약하기' },
@@ -124,7 +158,7 @@ export const CTA_LABEL = {
 export function ctaLabel(cta, lang) { return CTA_LABEL[lang]?.[cta] || CTA_LABEL.en[cta] || CTA_LABEL.en.LEARN_MORE; }
 /** 컨셉 하나를 12규격으로 렌더 → 파일 목록. 이미 있는 파일은 건너뜀(--force로 다시). */
 export async function renderConcept(dir, brief, concept, backgrounds, opts = {}) {
-    const fonts = await loadFonts();
+    const fonts = await loadFonts(brief.language);
     const logo = await fetchLogo(brief.logoUrl, dir);
     const out = [];
     const ctaText = ctaLabel(concept.cta, brief.language);
@@ -152,7 +186,7 @@ export async function renderLogo(dir, brief) {
     for (const [w, hh] of [[512, 512], [1200, 300]]) {
         const file = path.join(dir, `_logo_${w}x${hh}.png`);
         if (!fs.existsSync(file)) {
-            const el = h('div', { width: w, height: hh, display: 'flex', alignItems: 'center', justifyContent: 'center', backgroundColor: brief.palette.primary, fontFamily: 'Pretendard' }, [
+            const el = h('div', { width: w, height: hh, display: 'flex', alignItems: 'center', justifyContent: 'center', backgroundColor: brief.palette.primary, fontFamily: FONT_FAMILY }, [
                 logo ? h('img', { height: Math.round(hh * 0.5) }, undefined, { src: logo }) : h('div', { fontSize: Math.round(Math.min(w, hh) * (w === hh ? 0.16 : 0.42)), fontWeight: 800, color: '#fff', letterSpacing: -1, whiteSpace: 'nowrap' }, brief.company.slice(0, 16)),
             ]);
             const svg = await satori(el, { width: w, height: hh, fonts });
@@ -164,14 +198,37 @@ export async function renderLogo(dir, brief) {
 }
 /** 영상 자막 오버레이 — 투명 PNG(영상 크기) 에 하단 자막 알약 또는 CTA 버튼. ffmpeg drawtext(폰트 빌드 의존) 대신 satori 로 그린다. */
 export async function renderOverlay(file, w, hh, text, o) {
-    const fonts = await loadFonts();
+    const fonts = await loadFonts(o.lang);
     const base = Math.min(w, hh);
     const fs1 = Math.round(base * (o.kind === 'cta' ? 0.055 : 0.068));
     const pill = o.kind === 'cta'
         ? h('div', { display: 'flex', fontSize: fs1, fontWeight: 700, color: '#fff', backgroundColor: o.primary, borderRadius: 999, padding: `${Math.round(fs1 * 0.55)}px ${Math.round(fs1 * 1.3)}px`, boxShadow: `0 10px 30px ${hexA(o.primary, 0.45)}` }, text)
         : h('div', { display: 'flex', fontSize: fs1, fontWeight: 800, color: '#fff', backgroundColor: 'rgba(11,21,38,.62)', borderRadius: Math.round(fs1 * 0.4), padding: `${Math.round(fs1 * 0.35)}px ${Math.round(fs1 * 0.6)}px`, lineHeight: 1.25, letterSpacing: -1, textAlign: 'center', maxWidth: Math.round(w * 0.86), wordBreak: 'keep-all' }, text);
-    const el = h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-end', justifyContent: 'center', paddingBottom: Math.round(hh * (o.kind === 'cta' ? 0.09 : 0.17)), fontFamily: 'Pretendard' }, [pill]);
+    // 안전영역: 릴스·쇼츠 UI 가 하단 ~20%·우측 ~10% 를 가린다 → 자막은 상단 1/3(훅) 또는 하단 25~30% 선. 훅은 크고 브랜드색 하이라이트.
+    const hook = o.kind === 'hook';
+    const hookEl = h('div', { display: 'flex', fontSize: Math.round(base * 0.095), fontWeight: 800, color: '#fff', lineHeight: 1.12, letterSpacing: -1.5, textAlign: 'center', maxWidth: Math.round(w * 0.86), wordBreak: 'keep-all', textShadow: '0 4px 24px rgba(0,0,0,.65), 0 1px 2px rgba(0,0,0,.8)', backgroundColor: hexA(o.primary, 0.92), padding: `${Math.round(base * 0.035)}px ${Math.round(base * 0.05)}px`, borderRadius: Math.round(base * 0.03), transform: 'rotate(-2deg)' }, text);
+    const el = hook
+        ? (o.layout === 'lower'
+            ? h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-end', justifyContent: 'center', paddingBottom: Math.round(hh * 0.22), fontFamily: FONT_FAMILY }, [hookEl])
+            : h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-start', justifyContent: 'center', paddingTop: Math.round(hh * 0.14), fontFamily: FONT_FAMILY }, [hookEl]))
+        : h('div', { width: w, height: hh, display: 'flex', alignItems: 'flex-end', justifyContent: 'center', paddingBottom: Math.round(hh * (o.kind === 'cta' ? 0.12 : 0.24)), fontFamily: FONT_FAMILY }, [pill]);
     const svg = await satori(el, { width: w, height: hh, fonts });
     fs.writeFileSync(file, new Resvg(svg, { fitTo: { mode: 'width', value: w } }).render().asPng());
     return file;
 }
+/** UI 데모용 배경(브랜드 그래디언트 · 영상 크기) + 폰 프레임(투명 화면 영역) — ffmpeg 가 스크린샷을 그 사이에 끼운다 */
+export async function renderPhoneStage(dir, w, hh, primary, dark) {
+    const fonts = await loadFonts();
+    const sw = Math.round(w * 0.62);
+    const sh = Math.round(sw * 2.05);
+    const sx = Math.round((w - sw) / 2);
+    const sy = Math.round((hh - sh) / 2);
+    const bgSvg = await satori(h('div', { width: w, height: hh, display: 'flex', backgroundImage: `linear-gradient(160deg, ${dark} 0%, ${hexA(primary, 0.75)} 100%)`, fontFamily: FONT_FAMILY }, ''), { width: w, height: hh, fonts });
+    const bg = path.join(dir, `stage_bg_${w}x${hh}.png`);
+    fs.writeFileSync(bg, new Resvg(bgSvg).render().asPng());
+    const bezel = Math.round(sw * 0.045);
+    const frameSvg = `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${hh}"><defs><mask id="m"><rect width="${w}" height="${hh}" fill="#fff"/><rect x="${sx}" y="${sy}" width="${sw}" height="${sh}" rx="${Math.round(sw * 0.11)}" fill="#000"/></mask></defs><rect x="${sx - bezel}" y="${sy - bezel}" width="${sw + bezel * 2}" height="${sh + bezel * 2}" rx="${Math.round(sw * 0.14)}" fill="#0b0f18" mask="url(#m)"/><rect x="${sx - bezel}" y="${sy - bezel}" width="${sw + bezel * 2}" height="${sh + bezel * 2}" rx="${Math.round(sw * 0.14)}" fill="none" stroke="rgba(255,255,255,.18)" stroke-width="3"/><rect x="${sx + sw * 0.32}" y="${sy + bezel * 0.35}" width="${sw * 0.36}" height="${bezel * 0.9}" rx="${bezel * 0.45}" fill="#0b0f18"/></svg>`;
+    const frame = path.join(dir, `stage_frame_${w}x${hh}.png`);
+    fs.writeFileSync(frame, new Resvg(frameSvg).render().asPng());
+    return { bg, frame, screen: { x: sx, y: sy, w: sw, h: sh } };
+}

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

@@ -0,0 +1,9 @@
+export declare function chromeBin(): string | null;
+/** 모바일 폭(390) 긴 스크린샷 PNG. 실패하면 null(호출자가 이미지 폴백). */
+export declare function screenshotSite(url: string, file: string, o?: {
+    width?: number;
+    height?: number;
+    timeoutMs?: number;
+}): Promise<string | null>;
+/** 사이트 이미지 URL 들을 내려받아 유효한(≥300px 추정 · png/jpg/webp) 파일만 반환 */
+export declare function downloadSiteImages(urls: string[], dir: string, max?: number): Promise<string[]>;

package/dist/core/creatives/siteshots.js

@@ -0,0 +1,53 @@
+// 사이트 실제 화면·이미지 확보 — ui_demo 포맷과 참고 이미지(제품 일관성)에 쓴다.
+//   1) 헤드리스 크로미움 스크린샷(모바일 폭 · 긴 페이지) — 바이너리: CHROME_BIN > alpine chromium-browser/chromium > macOS Chrome. 없으면 건너뜀.
+//   2) 사이트 본문 이미지(og:image·큰 <img>) 내려받기 — 생성 이미지의 참고(/edits)로.
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { sniffMime } from './render.js';
+const execFileP = promisify(execFile);
+export function chromeBin() {
+    const cands = [process.env.CHROME_BIN, '/usr/bin/chromium-browser', '/usr/bin/chromium', '/usr/bin/google-chrome', '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome', '/Applications/Chromium.app/Contents/MacOS/Chromium'].filter(Boolean);
+    return cands.find((c) => fs.existsSync(c)) || null;
+}
+/** 모바일 폭(390) 긴 스크린샷 PNG. 실패하면 null(호출자가 이미지 폴백). */
+export async function screenshotSite(url, file, o = {}) {
+    const bin = chromeBin();
+    if (!bin)
+        return null;
+    const w = o.width || 390, h = o.height || 2200;
+    try {
+        await execFileP(bin, ['--headless=new', '--disable-gpu', '--no-sandbox', '--disable-dev-shm-usage', '--hide-scrollbars', '--force-device-scale-factor=2', `--window-size=${w},${h}`, '--virtual-time-budget=8000', `--screenshot=${file}`, url], { timeout: o.timeoutMs || 45_000, maxBuffer: 8 << 20 });
+        if (!fs.existsSync(file) || fs.statSync(file).size < 5000)
+            return null;
+        return file;
+    }
+    catch {
+        return null;
+    }
+}
+/** 사이트 이미지 URL 들을 내려받아 유효한(≥300px 추정 · png/jpg/webp) 파일만 반환 */
+export async function downloadSiteImages(urls, dir, max = 4) {
+    const out = [];
+    for (const u of urls) {
+        if (out.length >= max)
+            break;
+        try {
+            const r = await fetch(u, { signal: AbortSignal.timeout(15_000), headers: { 'user-agent': 'Mozilla/5.0 (compatible; ADYou/0.4)' } });
+            if (!r.ok)
+                continue;
+            const buf = Buffer.from(await r.arrayBuffer());
+            if (buf.length < 8_000 || buf.length > 15_000_000)
+                continue;
+            const mime = sniffMime(buf);
+            if (!/png|jpeg|webp/.test(mime))
+                continue;
+            const f = path.join(dir, `site_${out.length}.${mime.split('/')[1] === 'jpeg' ? 'jpg' : mime.split('/')[1]}`);
+            fs.writeFileSync(f, buf);
+            out.push(f);
+        }
+        catch { /* 다음 */ }
+    }
+    return out;
+}

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

@@ -0,0 +1,70 @@
+import type { Brief, Concept, Goal } from '../state.js';
+import { type Tone, type VideoFormat } from './playbook.js';
+export type Clip = {
+    sec: number;
+    kind: 'gen' | 'ui_demo';
+    prompt: string;
+    speech?: string;
+};
+export type Storyboard = {
+    id: string;
+    format: VideoFormat;
+    genre: string;
+    hook: string;
+    captions: string[];
+    voice?: string;
+    music: string;
+    cta: string;
+    durationSec: number;
+    clips: Clip[];
+    score?: number;
+    scoreNote?: string;
+    lang: string;
+};
+export type LocalizedBoard = {
+    hook: string;
+    captions: string[];
+    voice?: string;
+};
+export type LocalizedCopy = {
+    headlines: string[];
+    bodies: string[];
+    descriptions: string[];
+    boards?: Record<string, LocalizedBoard>;
+};
+export type I18n = Record<string, LocalizedCopy>;
+export declare const langName: (l: string) => string;
+/** 훅 길이 제한 — 한글·전각 12자(wlen 24) · 라틴은 단어 경계에서 자른다(잘린 단어 금지) */
+export declare function fitHook(t: string): string;
+/** 포맷별 클립 구성 규칙 — 8초: UGC 1×8(발화) · 시네마틱/라이프스타일 2×4(훅→보상) · ui_demo 4(훅 gen)+4(화면) · 제품 1×8 · text_hook 2×4. 15/30초는 1클립 다중 장면 */
+export declare function clipPlan(format: VideoFormat, durationSec: number, hasScreens: boolean): {
+    sec: number;
+    kind: 'gen' | 'ui_demo';
+}[];
+export declare function generateStoryboards(brief: Brief, concept: Concept, o: {
+    formats: VideoFormat[];
+    durationSec: number;
+    tone: Tone;
+    goal: Goal;
+    hasScreens: boolean;
+    lang?: string;
+}): Promise<Storyboard[]>;
+/** 채점 — 훅 강도·3초 명료성·정책 위험·브랜드 적합·타겟 적합(각 0~10) → 평균. 정책 위험은 규칙 검사(policyIssues)로 먼저 깎는다. */
+export declare function judgeStoryboards(brief: Brief, boards: Storyboard[]): Promise<Storyboard[]>;
+/** 콘티 생성 + 채점 + 약한 포맷 1회 재작성 → 점수순 */
+export declare function planStoryboards(brief: Brief, concept: Concept, o: {
+    formats: VideoFormat[];
+    durationSec: number;
+    tone: Tone;
+    goal: Goal;
+    hasScreens: boolean;
+    lang?: string;
+    log?: (s: string) => void;
+    minScore?: number;
+}): Promise<Storyboard[]>;
+/** 시장 언어별 문구·자막·훅·대사 번역 — 뜻·사실 유지 · 규격 맞춤 */
+export declare function translateCopy(brief: Brief, concept: Concept, boards: Storyboard[], langs: string[]): Promise<I18n>;
+/** 언어별 콘티 자막/훅 꺼내기(없으면 원문) */
+export declare function localizedBoard(b: Storyboard, i18n: I18n | undefined, lang: string): LocalizedBoard;
+/** 언어별 컨셉(문구 치환) — 이미지 렌더·매체 카피에 */
+export declare function localizedConcept(c: Concept, i18n: I18n | undefined, lang: string): Concept;

package/dist/core/creatives/storyboard.js

@@ -0,0 +1,149 @@
+// 콘티(스토리보드) — 컨셉 × 포맷마다 「훅(0~2초) → 증명/보상 → 행동」 3박자 대본을 LLM 이 쓰고, 채점(훅 강도·명료성·정책·브랜드 적합)으로 약한 것을 걸러낸다.
+// 영상 크레딧을 쓰기 전 텍스트 단계에서 품질을 올리는 것이 목적(비용 거의 0). 시장 언어별 번역(i18n)도 여기서.
+import { z } from 'zod';
+import { aiAvailable, completeJson } from '../llm.js';
+import { ctaLabel } from './render.js';
+import { FORMAT_DESC, genreStyle, playbookFor, TONE_WORDS } from './playbook.js';
+import { fit, GOOGLE_LIMITS, policyIssues, wlen } from './specs.js';
+const BoardSchema = z.object({
+    format: z.string(), genre: z.string().optional(), hook: z.string(), captions: z.array(z.string()).min(1).max(5), voice: z.string().optional().nullable(), music: z.string().optional(),
+    clips: z.array(z.object({ sec: z.number(), kind: z.enum(['gen', 'ui_demo']).default('gen'), prompt: z.string(), speech: z.string().optional().nullable() })).min(1).max(3),
+});
+const LANG_NAME = { ko: 'Korean', en: 'English', ja: 'Japanese', 'zh-TW': 'Traditional Chinese', zh: 'Chinese', de: 'German', fr: 'French', es: 'Spanish', vi: 'Vietnamese', th: 'Thai', id: 'Indonesian', pt: 'Portuguese', it: 'Italian', nl: 'Dutch' };
+export const langName = (l) => LANG_NAME[l] || LANG_NAME[l.split('-')[0]] || l;
+/** 훅 길이 제한 — 한글·전각 12자(wlen 24) · 라틴은 단어 경계에서 자른다(잘린 단어 금지) */
+export function fitHook(t) {
+    const s = t.trim().replace(/\s+/g, ' ');
+    if (wlen(s) <= 26)
+        return s;
+    if (/[\u3000-\u9fff\uac00-\ud7af]/.test(s))
+        return fit(s, 26);
+    const words = s.split(' ');
+    let out = '';
+    for (const w of words) {
+        if ((out + ' ' + w).trim().length > 34)
+            break;
+        out = (out + ' ' + w).trim();
+    }
+    return out || fit(s, 30);
+}
+/** 포맷별 클립 구성 규칙 — 8초: UGC 1×8(발화) · 시네마틱/라이프스타일 2×4(훅→보상) · ui_demo 4(훅 gen)+4(화면) · 제품 1×8 · text_hook 2×4. 15/30초는 1클립 다중 장면 */
+export function clipPlan(format, durationSec, hasScreens) {
+    if (durationSec > 8)
+        return [{ sec: durationSec, kind: 'gen' }];
+    if (format === 'ugc_selfie' || format === 'product_hero')
+        return [{ sec: 8, kind: 'gen' }];
+    if (format === 'ui_demo')
+        return hasScreens ? [{ sec: 4, kind: 'gen' }, { sec: 4, kind: 'ui_demo' }] : [{ sec: 8, kind: 'gen' }];
+    return [{ sec: 4, kind: 'gen' }, { sec: 4, kind: 'gen' }];
+}
+export async function generateStoryboards(brief, concept, o) {
+    const lang = o.lang || brief.language;
+    const cta = ctaLabel(concept.cta, lang);
+    const pb = playbookFor(brief.industry);
+    const genres = brief.visualGenres?.length ? brief.visualGenres : pb.genres;
+    const tone = TONE_WORDS[o.tone];
+    const plans = o.formats.map((f) => ({ format: f, clips: clipPlan(f, o.durationSec, o.hasScreens) }));
+    if (!aiAvailable())
+        return plans.map((p) => fallbackBoard(brief, concept, p.format, p.clips, genres[0], cta, lang, o.durationSec));
+    const out = await completeJson({
+        schema: z.object({ boards: z.array(BoardSchema).min(1) }), maxTokens: 7000, timeoutMs: 150_000,
+        system: `너는 퍼포먼스 광고 크리에이티브 디렉터다. 주어진 광고 컨셉을 포맷별 짧은 영상 콘티로 만든다. 목표: 첫 1~2초 안에 손가락을 멈추게 하고(훅), 3초 안에 무엇인지 보이고, 마지막에 행동을 시킨다.
+업종 플레이북(${pb.label}): 포맷 우선 ${pb.formats.join('·')} · 훅 패턴 ${pb.hooks.join(' / ')} · 꼭 보일 것 ${pb.musts.join('·')} · 피할 것 ${pb.avoid.join('·')}.
+비주얼 장르(우선순위): ${genres.join(' > ')} — ${genres.map((g) => `${g}=${genreStyle(g)}`).join(' | ')}. 애니(anime)는 브랜드가 애니·게임·웹툰일 때만 쓴다.
+톤: ${o.tone} → 카메라 「${tone.camera}」 · 음악 「${tone.music}」 · 자막 ${tone.caption}.
+포맷 정의: ${o.formats.map((f) => `${f}=${FORMAT_DESC[f]}`).join(' | ')}.
+클립 구성(포맷별 고정 · 초 수를 지켜라): ${plans.map((p) => `${p.format}: ${p.clips.map((c) => `${c.sec}s ${c.kind}`).join(' + ')}`).join(' / ')}.
+규칙:
+- boards 는 요청 포맷마다 정확히 1개. 각 board: format · genre(위 장르 중 하나) · hook(첫 프레임 큰 글자 · ${lang} · 6단어/12자 이내 · 질문/숫자/반전) · captions(화면 자막 3줄 · ${lang} · 각 18자 이내 · 훅→가치/증명→행동 순 · 마지막 줄은 행동 유도) · voice(선택 · ${lang} 한 문장 내레이션/대사) · music(영어 한 줄).
+- clips[].prompt 는 영어 영상 생성 프롬프트(80~160단어): 피사체·동작·카메라·조명·장르 스타일 토큰·첫 프레임에서 바로 움직임이 시작됨. 사람은 브리프 타겟(${JSON.stringify(brief.audienceProfile || {})})과 어울리는 가상의 인물로, 실존 인물·유명인·타사 로고·화면 글자·자막 금지("no on-screen text, no subtitles, no logos" 로 끝낸다). 소리 지시(음악·효과음) 한 줄 포함.
+- ugc_selfie 클립: 인물이 스마트폰 셀카로 카메라를 보며 ${langName(lang)} 로 speech 를 말한다 — speech 는 **짧은 한 문장(영어 ≤ 12단어 · 한국어/일본어 ≤ 22자 · 말하면 4~5초)** 이어야 8초 안에 여유 있게 끝난다(뚝 끊김 금지) · 프롬프트에 "speaking to camera in ${langName(lang)}: '<speech>'" 형태로 포함 · 립싱크 자연스럽게 · 실제 후기 톤(대본 읽는 느낌 금지).
+- ui_demo 클립(kind=ui_demo)은 prompt 대신 화면에 얹을 설명 한 줄(${lang})만 쓴다(실제 사이트 화면을 우리가 넣는다).
+- 사실은 브리프(usp·proofPoints·offer)에 있는 것만. 과장·최상급·보장·전후비교·개인 속성 지칭 금지. ${brief.notes ? `주의: ${brief.notes}` : ''}
+- 출력 JSON: {"boards":[{format,genre,hook,captions[],voice,music,clips:[{sec,kind,prompt,speech}]}]}`,
+        user: JSON.stringify({ brief: { company: brief.company, offer: brief.offer, category: brief.category, industry: brief.industry, audience: brief.audience, audienceProfile: brief.audienceProfile, usp: brief.usp, proofPoints: brief.proofPoints, tone: brief.tone, language: lang, palette: brief.palette }, concept: { key: concept.key, name: concept.name, angle: concept.angle, headline: concept.headlines[0], body: concept.bodies[0], imagePrompt: concept.imagePrompt }, goal: o.goal, cta, durationSec: o.durationSec, formats: o.formats }),
+    });
+    const boards = [];
+    for (const p of plans) {
+        const b = out.boards.find((x) => x.format === p.format) || out.boards[boards.length];
+        if (!b) {
+            boards.push(fallbackBoard(brief, concept, p.format, p.clips, genres[0], cta, lang, o.durationSec));
+            continue;
+        }
+        const clips = p.clips.map((pc, i) => { const src = b.clips[i] || b.clips[b.clips.length - 1]; return { sec: pc.sec, kind: pc.kind, prompt: (src?.prompt || '').trim(), speech: src?.speech || undefined }; });
+        boards.push({ id: `${concept.key}_${p.format}`, format: p.format, genre: p.format === 'ugc_selfie' ? 'ugc' : (b.genre && genres.includes(b.genre) ? b.genre : genres[0]) || 'photoreal', hook: fitHook(b.hook), captions: b.captions.map((c) => c.trim()).filter(Boolean).slice(0, 3), voice: b.voice || undefined, music: b.music || tone.music, cta, durationSec: o.durationSec, clips, lang });
+    }
+    return boards;
+}
+function fallbackBoard(brief, concept, format, plan, genre, cta, lang, durationSec) {
+    const style = genreStyle(genre);
+    const base = concept.videoPrompt || `A short advertisement scene inspired by: ${concept.imagePrompt}.`;
+    const clips = plan.map((p, i) => p.kind === 'ui_demo' ? { sec: p.sec, kind: 'ui_demo', prompt: concept.headlines[0] } : { sec: p.sec, kind: 'gen', prompt: `${i === 0 ? 'Opening hook shot with immediate motion: ' : 'Payoff shot: '}${base} ${style}. Upbeat modern music. No on-screen text, no subtitles, no logos.` });
+    return { id: `${concept.key}_${format}`, format, genre: format === 'ugc_selfie' ? 'ugc' : genre, hook: fitHook(concept.headlines[0] || brief.company), captions: (concept.videoLines?.length ? concept.videoLines : [concept.headlines[0], concept.bodies[0]?.slice(0, 18) || '', cta]).filter(Boolean).slice(0, 3), music: 'upbeat modern music', cta, durationSec, clips, lang };
+}
+/** 채점 — 훅 강도·3초 명료성·정책 위험·브랜드 적합·타겟 적합(각 0~10) → 평균. 정책 위험은 규칙 검사(policyIssues)로 먼저 깎는다. */
+export async function judgeStoryboards(brief, boards) {
+    const ruleHit = (b) => policyIssues([b.hook, ...b.captions, b.voice || ''].join(' ')).length;
+    if (!aiAvailable())
+        return boards.map((b) => ({ ...b, score: Math.max(0, 7 - ruleHit(b) * 3), scoreNote: ruleHit(b) ? '정책 표현 감지' : '규칙 채점' }));
+    const out = await completeJson({
+        schema: z.object({ scores: z.array(z.object({ id: z.string(), hook: z.number(), clarity: z.number(), policy: z.number(), fit: z.number(), target: z.number(), note: z.string().optional() })) }), maxTokens: 2500, timeoutMs: 90_000,
+        system: `너는 퍼포먼스 광고 심사관이다. 각 콘티를 0~10 으로 채점한다: hook(첫 1~2초에 멈추게 하나 · 질문/숫자/반전/움직임) · clarity(3초 안에 무엇을 파는지 보이나) · policy(10=안전 · 과장·보장·전후비교·개인속성 지칭·성인 암시가 있으면 크게 깎음) · fit(브랜드 톤·업종·장르 적합 · 애니 브랜드가 아닌데 애니면 깎음) · target(타겟(${JSON.stringify(brief.audienceProfile || brief.audience)})에게 말이 되나). note 는 20자 이내 한 줄. 출력 JSON {"scores":[{id,hook,clarity,policy,fit,target,note}]}`,
+        user: JSON.stringify({ brief: { company: brief.company, offer: brief.offer, industry: brief.industry, usp: brief.usp, tone: brief.tone }, boards: boards.map((b) => ({ id: b.id, format: b.format, genre: b.genre, hook: b.hook, captions: b.captions, voice: b.voice, clips: b.clips.map((c) => c.prompt.slice(0, 300)) })) }),
+    });
+    return boards.map((b) => { const s = out.scores.find((x) => x.id === b.id); const avg = s ? (s.hook + s.clarity + s.policy + s.fit + s.target) / 5 : 6; const pen = ruleHit(b) * 2; return { ...b, score: Math.round(Math.max(0, avg - pen) * 10) / 10, scoreNote: `${s?.note || ''}${pen ? ' · 정책 표현' : ''}`.trim() }; });
+}
+/** 콘티 생성 + 채점 + 약한 포맷 1회 재작성 → 점수순 */
+export async function planStoryboards(brief, concept, o) {
+    const min = o.minScore ?? 6.5;
+    let boards = await judgeStoryboards(brief, await generateStoryboards(brief, concept, o));
+    const weak = boards.filter((b) => (b.score ?? 0) < min);
+    if (weak.length && aiAvailable()) {
+        o.log?.(`  콘티 채점: ${boards.map((b) => `${b.format} ${b.score}`).join(' · ')} → 약한 ${weak.length}개 다시 씀`);
+        const redo = await judgeStoryboards(brief, await generateStoryboards(brief, concept, { ...o, formats: weak.map((w) => w.format) }));
+        boards = boards.map((b) => { const r = redo.find((x) => x.format === b.format); return r && (r.score ?? 0) > (b.score ?? 0) ? r : b; });
+    }
+    o.log?.(`  콘티: ${boards.map((b) => `${b.format}(${b.genre}) ${b.score}점 「${b.hook}」`).join(' · ')}`);
+    return boards.sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+}
+/** 시장 언어별 문구·자막·훅·대사 번역 — 뜻·사실 유지 · 규격 맞춤 */
+export async function translateCopy(brief, concept, boards, langs) {
+    const targets = [...new Set(langs.map((l) => l).filter((l) => l.split('-')[0] !== (brief.language || 'ko').split('-')[0]))];
+    const out = {};
+    if (!targets.length)
+        return out;
+    if (!aiAvailable()) {
+        for (const l of targets)
+            out[l] = { headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions };
+        return out;
+    }
+    const r = await completeJson({
+        schema: z.object({ translations: z.record(z.string(), z.object({ headlines: z.array(z.string()), bodies: z.array(z.string()), descriptions: z.array(z.string()), boards: z.array(z.object({ id: z.string(), hook: z.string(), captions: z.array(z.string()), voice: z.string().optional().nullable() })).optional() })) }), maxTokens: 6000, timeoutMs: 150_000,
+        system: `너는 광고 현지화 카피라이터다. 아래 문구·자막·훅·대사를 각 언어로 옮긴다. 직역이 아니라 그 시장 광고에서 자연스러운 표현으로, 뜻·사실·숫자는 그대로. 헤드라인 ≤ ${GOOGLE_LIMITS.headline}자(한글·전각 2자) · 설명 ≤ ${GOOGLE_LIMITS.description}자 · 자막 각 18자(영문 32자) 이내 · 훅 6단어 이내 · 대사(voice)는 말하면 4~5초 안에 끝나는 짧은 한 문장(영어 ≤ 12단어 · 일본어 ≤ 22자). 브랜드명(${brief.company})은 번역하지 않는다. 출력 JSON {"translations":{"<lang>":{headlines[],bodies[],descriptions[],boards:[{id,hook,captions[],voice}]}}}`,
+        user: JSON.stringify({ sourceLanguage: brief.language, targets: targets.map((t) => `${t} (${langName(t)})`), headlines: concept.headlines, bodies: concept.bodies, descriptions: concept.descriptions, boards: boards.map((b) => ({ id: b.id, hook: b.hook, captions: b.captions, voice: b.voice })) }),
+    });
+    for (const l of targets) {
+        const t = r.translations[l] || r.translations[l.split('-')[0]];
+        if (!t)
+            continue;
+        out[l] = { headlines: t.headlines.map((h) => fit(h.trim(), GOOGLE_LIMITS.headline)).filter(Boolean), bodies: t.bodies.map((b) => b.trim()).filter(Boolean), descriptions: t.descriptions.map((d) => fit(d.trim(), GOOGLE_LIMITS.description)).filter(Boolean) };
+        for (const b of boards) {
+            const tb = t.boards?.find((x) => x.id === b.id);
+            if (tb)
+                out[l].boards = { ...(out[l].boards || {}), [b.id]: { hook: fitHook(tb.hook), captions: tb.captions.slice(0, 3), voice: tb.voice || undefined } };
+        }
+    }
+    return out;
+}
+/** 언어별 콘티 자막/훅 꺼내기(없으면 원문) */
+export function localizedBoard(b, i18n, lang) {
+    const t = i18n?.[lang]?.boards?.[b.id];
+    return t ? { hook: t.hook, captions: t.captions, voice: t.voice } : { hook: b.hook, captions: b.captions, voice: b.voice };
+}
+/** 언어별 컨셉(문구 치환) — 이미지 렌더·매체 카피에 */
+export function localizedConcept(c, i18n, lang) {
+    const t = i18n?.[lang];
+    if (!t)
+        return c;
+    return { ...c, headlines: t.headlines.length ? t.headlines : c.headlines, bodies: t.bodies.length ? t.bodies : c.bodies, descriptions: t.descriptions.length ? t.descriptions : c.descriptions };
+}

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

@@ -18,7 +18,7 @@ export declare function burnCaptions(input: string, output: string, o: {
         end: number;
     }[];
 }): Promise<void>;
-/** 엔드카드(PNG · 같은 크기) 를 seconds 초 정지화면으로 뒤에 이어붙인다. 소리는 유지(엔드카드 구간은 무음). */
+/** 엔드카드(PNG · 같은 크기) 를 seconds 초 정지화면으로 뒤에 이어붙인다. 하드컷 대신 소리 페이드아웃(0.6초) + 0.35초 디졸브 — 대사가 끝나는 순간 「뚝」 끊기는 느낌을 줄인다. */
 export declare function appendEndCard(input: string, cardPng: string, output: string, seconds?: number): Promise<void>;
 /** 비율 파생 — 중앙 크롭 후 표준 크기로 스케일(9:16 → 4:5 · 1:1, 16:9 → 1:1) */
 export declare function deriveRatio(input: string, output: string, ratio: VideoRatio): Promise<void>;
@@ -26,3 +26,34 @@ export declare function deriveRatio(input: string, output: string, ratio: VideoR
 export declare function normalize(input: string, output: string, ratio: VideoRatio, maxSec?: number): Promise<Probe>;
 /** 대표 프레임(썸네일) — 1초 지점 JPEG */
 export declare function thumbnail(input: string, output: string, atSec?: number): Promise<void>;
+/** 클립 이어붙이기 — 코덱·fps·오디오 정규화 뒤 concat(무음 클립은 무음 트랙 추가) · 컷 사이 0.25초 크로스페이드 없음(빠른 컷이 광고 표준) */
+export declare function concatClips(inputs: string[], output: string, dims: {
+    w: number;
+    h: number;
+}): Promise<void>;
+/** UI 데모 클립 — 긴 스크린샷을 폰 프레임 안에서 아래로 스크롤(sec 초) · 배경 그래디언트 · 무음(뒤에서 음악 클립과 이어짐) */
+export declare function uiDemoClip(shot: string, output: string, o: {
+    sec: number;
+    stage: {
+        bg: string;
+        frame: string;
+        screen: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+    };
+    dims: {
+        w: number;
+        h: number;
+    };
+}): Promise<void>;
+/** 정지 이미지 → 켄번즈(줌인) 클립 · 무음 */
+export declare function kenBurnsClip(image: string, output: string, o: {
+    sec: number;
+    dims: {
+        w: number;
+        h: number;
+    };
+}): Promise<void>;

package/dist/core/creatives/videofx.js

@@ -54,19 +54,30 @@ export async function burnCaptions(input, output, o) {
     const args = ['-y', '-v', 'error', ...inputs, '-filter_complex', fc, '-map', '[v]', ...(p.hasAudio ? ['-map', '0:a', '-c:a', 'copy'] : []), '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-pix_fmt', 'yuv420p', '-movflags', '+faststart', output];
     await execFileP('ffmpeg', args, { maxBuffer: 8 << 20 });
 }
-/** 엔드카드(PNG · 같은 크기) 를 seconds 초 정지화면으로 뒤에 이어붙인다. 소리는 유지(엔드카드 구간은 무음). */
+/** 엔드카드(PNG · 같은 크기) 를 seconds 초 정지화면으로 뒤에 이어붙인다. 하드컷 대신 소리 페이드아웃(0.6초) + 0.35초 디졸브 — 대사가 끝나는 순간 「뚝」 끊기는 느낌을 줄인다. */
 export async function appendEndCard(input, cardPng, output, seconds = 2) {
     const p = await probe(input);
     const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'adp-end-'));
     const card = path.join(dir, 'card.mp4');
-    await execFileP('ffmpeg', ['-y', '-v', 'error', '-loop', '1', '-t', String(seconds), '-i', cardPng, '-f', 'lavfi', '-t', String(seconds), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', `scale=${p.w}:${p.h}:force_original_aspect_ratio=increase,crop=${p.w}:${p.h},format=yuv420p,fps=24`, '-c:v', 'libx264', '-preset', 'veryfast', '-c:a', 'aac', '-shortest', card]);
+    const xf = 0.35;
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-loop', '1', '-t', String(seconds + xf), '-i', cardPng, '-f', 'lavfi', '-t', String(seconds + xf), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', `scale=${p.w}:${p.h}:force_original_aspect_ratio=increase,crop=${p.w}:${p.h},format=yuv420p,fps=24`, '-c:v', 'libx264', '-preset', 'veryfast', '-c:a', 'aac', '-shortest', card]);
     const main = path.join(dir, 'main.mp4');
-    // 본편도 같은 코덱·프레임레이트·오디오로 정규화(무음이면 무음 트랙 추가) → concat 필터
+    // 본편 정규화(24fps · yuv420p · 48k 스테레오 · 무음이면 무음 트랙) + 끝 0.6초 소리 페이드아웃
+    const d = Math.max(0.5, p.durationSec);
+    const fadeSt = Math.max(0, d - 0.6).toFixed(2);
     const args = p.hasAudio
-        ? ['-y', '-v', 'error', '-i', input, '-vf', 'fps=24,format=yuv420p', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-ar', '48000', '-ac', '2', main]
-        : ['-y', '-v', 'error', '-i', input, '-f', 'lavfi', '-t', String(p.durationSec), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', 'fps=24,format=yuv420p', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-shortest', main];
+        ? ['-y', '-v', 'error', '-i', input, '-vf', 'fps=24,format=yuv420p', '-af', `afade=t=out:st=${fadeSt}:d=0.6`, '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-ar', '48000', '-ac', '2', main]
+        : ['-y', '-v', 'error', '-i', input, '-f', 'lavfi', '-t', String(d), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', 'fps=24,format=yuv420p', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-shortest', main];
     await execFileP('ffmpeg', args, { maxBuffer: 8 << 20 });
-    await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', main, '-i', card, '-filter_complex', '[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[v][a]', '-map', '[v]', '-map', '[a]', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+    const md = (await probe(main)).durationSec;
+    const offset = Math.max(0.1, md - xf).toFixed(2);
+    try {
+        await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', main, '-i', card, '-filter_complex', `[0:v][1:v]xfade=transition=fade:duration=${xf}:offset=${offset}[v];[0:a][1:a]acrossfade=d=${xf}[a]`, '-map', '[v]', '-map', '[a]', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+    }
+    catch {
+        // xfade 가 안 되는 입력(가변 fps 등)이면 하드컷 concat 로 폴백
+        await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', main, '-i', card, '-filter_complex', '[0:v][0:a][1:v][1:a]concat=n=2:v=1:a=1[v][a]', '-map', '[v]', '-map', '[a]', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+    }
     fs.rmSync(dir, { recursive: true, force: true });
 }
 /** 비율 파생 — 중앙 크롭 후 표준 크기로 스케일(9:16 → 4:5 · 1:1, 16:9 → 1:1) */
@@ -84,3 +95,42 @@ export async function normalize(input, output, ratio, maxSec = 60) {
 export async function thumbnail(input, output, atSec = 1) {
     await execFileP('ffmpeg', ['-y', '-v', 'error', '-ss', String(atSec), '-i', input, '-frames:v', '1', '-q:v', '3', output]);
 }
+/** 클립 이어붙이기 — 코덱·fps·오디오 정규화 뒤 concat(무음 클립은 무음 트랙 추가) · 컷 사이 0.25초 크로스페이드 없음(빠른 컷이 광고 표준) */
+export async function concatClips(inputs, output, dims) {
+    if (inputs.length === 1) {
+        fs.copyFileSync(inputs[0], output);
+        return;
+    }
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'adp-cat-'));
+    const norm = [];
+    for (const [i, f] of inputs.entries()) {
+        const p = await probe(f);
+        const out = path.join(dir, `n${i}.mp4`);
+        const base = ['-y', '-v', 'error', '-i', f, ...(p.hasAudio ? [] : ['-f', 'lavfi', '-t', String(Math.max(0.5, p.durationSec)), '-i', 'anullsrc=r=48000:cl=stereo']), '-vf', `scale=${dims.w}:${dims.h}:force_original_aspect_ratio=increase,crop=${dims.w}:${dims.h},fps=24,format=yuv420p`, '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-ar', '48000', '-ac', '2', ...(p.hasAudio ? [] : ['-shortest']), out];
+        await execFileP('ffmpeg', base, { maxBuffer: 8 << 20 });
+        norm.push(out);
+    }
+    const fc = norm.map((_, i) => `[${i}:v][${i}:a]`).join('') + `concat=n=${norm.length}:v=1:a=1[v][a]`;
+    await execFileP('ffmpeg', ['-y', '-v', 'error', ...norm.flatMap((f) => ['-i', f]), '-filter_complex', fc, '-map', '[v]', '-map', '[a]', '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+/** UI 데모 클립 — 긴 스크린샷을 폰 프레임 안에서 아래로 스크롤(sec 초) · 배경 그래디언트 · 무음(뒤에서 음악 클립과 이어짐) */
+export async function uiDemoClip(shot, output, o) {
+    const sc = o.stage.screen;
+    const fps = 24;
+    const frames = Math.round(o.sec * fps);
+    // 스크린샷을 화면 폭에 맞춰 스케일 → 시간에 따라 crop y 이동(끝에서 멈춤) → 배경 위 오버레이 → 프레임 오버레이
+    const fc = [
+        `[1:v]scale=${sc.w}:-2[ss]`,
+        `[ss]crop=${sc.w}:${sc.h}:0:'min(ih-${sc.h}, max(0, (ih-${sc.h})*min(1, t/${Math.max(1, o.sec - 1)})))'[scr]`,
+        `[0:v][scr]overlay=${sc.x}:${sc.y}[st]`,
+        `[st][2:v]overlay=0:0,format=yuv420p[v]`,
+    ].join(';');
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-loop', '1', '-framerate', String(fps), '-t', String(o.sec), '-i', o.stage.bg, '-loop', '1', '-framerate', String(fps), '-t', String(o.sec), '-i', shot, '-loop', '1', '-framerate', String(fps), '-t', String(o.sec), '-i', o.stage.frame, '-f', 'lavfi', '-t', String(o.sec), '-i', 'anullsrc=r=48000:cl=stereo', '-filter_complex', fc, '-map', '[v]', '-map', '3:a', '-frames:v', String(frames), '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-shortest', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+}
+/** 정지 이미지 → 켄번즈(줌인) 클립 · 무음 */
+export async function kenBurnsClip(image, output, o) {
+    const fps = 24;
+    const frames = Math.round(o.sec * fps);
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-loop', '1', '-framerate', String(fps), '-t', String(o.sec), '-i', image, '-f', 'lavfi', '-t', String(o.sec), '-i', 'anullsrc=r=48000:cl=stereo', '-vf', `scale=${o.dims.w * 2}:${o.dims.h * 2}:force_original_aspect_ratio=increase,crop=${o.dims.w * 2}:${o.dims.h * 2},zoompan=z='min(zoom+0.0009,1.12)':d=${frames}:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)':s=${o.dims.w}x${o.dims.h}:fps=${fps},format=yuv420p`, '-frames:v', String(frames), '-c:v', 'libx264', '-preset', 'veryfast', '-crf', '20', '-c:a', 'aac', '-shortest', '-movflags', '+faststart', output], { maxBuffer: 8 << 20 });
+}

package/dist/core/ops.js

@@ -7,6 +7,7 @@ import { generateConcepts, validateConcepts } from './creatives/copy.js';
 import { generateBackgrounds, userBackgrounds } from './creatives/images.js';
 import { chargeFor, resolveCreativePlan } from './creatives/media.js';
 import { produceConceptVideos } from './creatives/factory.js';
+import { downloadSiteImages, screenshotSite } from './creatives/siteshots.js';
 import { renderConcept, renderLogo } from './creatives/render.js';
 import { SIZES } from './creatives/specs.js';
 import { aiAvailable, completeJson } from './llm.js';
@@ -60,7 +61,7 @@ export async function opCreatives(p, o) {
         spec.video = { ...(spec.video || {}), count: 1 };
     if (o.videoSeconds)
         spec.video = { ...(spec.video || {}), durationSec: (o.videoSeconds <= 8 ? 8 : o.videoSeconds <= 15 ? 15 : 30) };
-    const cplan = resolveCreativePlan(spec, { monthlyKrw: p.budget.monthlyKrw, media: connectedMedia() });
+    const cplan = resolveCreativePlan(spec, { monthlyKrw: p.budget.monthlyKrw, media: connectedMedia(), industry: p.brief.industry, genres: p.brief.visualGenres, hasScreens: true });
     p.creative = spec;
     const count = o.count || cplan.concepts;
     const dir = creativesDir(p.slug);
@@ -85,6 +86,15 @@ export async function opCreatives(p, o) {
     assets.push(...(await renderLogo(dir, p.brief)));
     let costKrw = 0;
     const refs = o.images ? fs.readdirSync(o.images).filter((f) => /\.(png|jpe?g|webp)$/i.test(f)).map((f) => path.join(o.images, f)) : [];
+    // 사이트 실제 화면·이미지 — ui_demo 포맷과 참고 이미지(제품 일관성)
+    let siteShot = null;
+    let siteImages = [];
+    if (cplan.videos.perConcept.length) {
+        siteShot = await screenshotSite(p.url, path.join(dir, 'site_shot.png'));
+        siteImages = await downloadSiteImages(p.brief.siteImages || [], dir, 3);
+        log(`사이트 화면 ${siteShot ? '캡처 ✓' : '캡처 불가(크로미움 없음)'} · 사이트 이미지 ${siteImages.length}장`);
+    }
+    const langs = [...new Set(p.budget.markets.map((m) => m.language))];
     p.concepts.forEach((c, i) => { void i; });
     for (const [ci, c] of p.concepts.entries()) {
         let bgs;
@@ -94,12 +104,12 @@ export async function opCreatives(p, o) {
             bgs = {};
         else {
             log(`배경 이미지 생성 ${c.key}…`);
-            bgs = await generateBackgrounds(dir, c.key, c.imagePrompt, undefined, log, { model: cplan.images.model, refs: spec.source === 'guided' ? refs : undefined, onAsset: (a) => { costKrw += a.costKrw; } });
+            bgs = await generateBackgrounds(dir, c.key, c.imagePrompt, undefined, log, { model: cplan.images.model, refs: spec.source === 'guided' ? refs : siteImages.slice(0, 2), onAsset: (a) => { costKrw += a.costKrw; } });
         }
         log(`합성 ${c.key} × ${SIZES.length}규격…`);
         assets.push(...(await renderConcept(dir, p.brief, c, bgs, { force: o.force || !!o.feedback, log })));
         if (cplan.videos.perConcept.length && ci < cplan.videos.conceptsWithVideo) {
-            const vids = await produceConceptVideos({ dir, brief: p.brief, concept: c, jobs: cplan.videos.perConcept, backgrounds: bgs, refs, log, onAsset: (a) => { costKrw += a.costKrw; } });
+            const vids = await produceConceptVideos({ dir, brief: p.brief, concept: c, jobs: cplan.videos.perConcept, backgrounds: bgs, refs: refs.length ? refs : siteImages, siteShot, siteImages, langs, tone: cplan.tone, goal: p.budget.goal, log, onAsset: (a) => { costKrw += a.costKrw; } });
             assets.push(...vids.filter((v) => v.file));
         }
     }

package/dist/core/site.d.ts

@@ -9,6 +9,8 @@ export type SiteSnapshot = {
     logo: string | null;
     themeColor: string | null;
     colors: string[];
+    /** 사이트 본문의 큰 이미지(제품·화면·인물) — 소재 참고 이미지로 자동 사용 */
+    images: string[];
     headings: string[];
     prices: string[];
     text: string;