adyou 0.6.2 → 0.6.4

package/dist/core/creatives/factory.js

@@ -9,10 +9,10 @@ import { genreStyle, TONE_WORDS } from './playbook.js';
 import { ctaLabel, renderConcept, renderOverlay, renderPhoneStage } from './render.js';
 import { langName, localizedBoard, localizedConcept, planStoryboards, translateCopy } from './storyboard.js';
 import { generateVideo } from './video.js';
-import { appendEndCard, burnCaptions, concatClips, deriveRatio, hasFfmpeg, kenBurnsClip, mixVoiceover, pickHookBand, probe, refCanvas, tailLoudnessDb, uiDemoClip } from './videofx.js';
+import { appendEndCard, burnCaptions, concatClips, deriveRatio, hasFfmpeg, kenBurnsClip, lastFrame, mixVoiceover, motionScore, pickHookBand, probe, refCanvas, tailLoudnessDb, uiDemoClip } from './videofx.js';
 import { synthesizeSpeech, ttsAvailable } from './tts.js';
 import { isMockGen } from './images.js';
-import { checkFrames, checkProductMatch, checkSpeech } from './qa.js';
+import { checkArtifacts, checkFrames, checkProductMatch, checkSpeech } from './qa.js';
 /** 말하는 포맷의 음성 방식 — 영어만 Veo 네이티브 발화(실측 안정) · 그 외 언어는 TTS 내레이션(Veo 한국어·일본어 발화는 엉뚱한 대사 · 2026-09-16 사장님 검수) */
 export function speechModeFor(lang) { return lang.split('-')[0] === 'en' || hasSeedance() || !ttsAvailable() || isMockGen() ? 'native' : 'tts'; }
 /** 영상용 엔드카드 PNG — 해당 비율의 포스터를 영상 크기로 렌더(언어별 문구) */
@@ -74,6 +74,17 @@ export async function produceConceptVideos(o) {
         log(`  ${extra.map(langName).join('·')} 로 문구·자막 옮기는 중…`);
         c.i18n = { ...(c.i18n || {}), ...(await translateCopy(o.brief, c, c.storyboards, extra)) };
     }
+    // 제품 사진(광고주 업로드 또는 실물 제품으로 분류된 사이트 이미지)이 없으면 「제품 히어로」는 상상 제품이 되므로 라이프스타일로 대체(콘티도 그 포맷으로)
+    const hasProductPhoto = !!(o.refs && o.refs.length);
+    if (!hasProductPhoto && o.jobs.some((j) => j.format === 'product_hero')) {
+        for (const j of o.jobs)
+            if (j.format === 'product_hero')
+                j.format = o.jobs.some((x) => x.format === 'lifestyle') ? 'cinematic' : 'lifestyle';
+        log('  제품 사진이 없어 「제품 히어로」 대신 장면 포맷(라이프스타일/시네마틱)으로 바꿨어요');
+        const need = [...new Set(o.jobs.map((j) => j.format || 'cinematic'))];
+        if (need.some((f) => !c.storyboards.some((b) => b.format === f)))
+            c.storyboards = await planStoryboards(o.brief, c, { formats: need, durationSec: o.jobs[0]?.durationSec || 8, tone, goal: o.goal || 'traffic', hasScreens, log });
+    }
     for (const job of o.jobs) {
         const format = (job.format || 'cinematic');
         const board = c.storyboards.find((b) => b.format === format) || c.storyboards[0];
@@ -114,17 +125,26 @@ export async function produceConceptVideos(o) {
                         const mode = line ? speechModeFor(rl) : 'none';
                         // 대사는 클립 안에서 여유 있게 끝나야 한다 — 뚝 끊김 방지: 짧은 한 문장 · 마지막 1~1.5초는 말 없이 미소/끄덕임
                         const speech = line && mode === 'native' ? ` The person speaks to camera in ${langName(rl)} (spoken language must be ${langName(rl)}): "${line}". Natural lip sync, conversational, genuine, native-speaker accent. The line is short and finishes comfortably by second ${Math.max(3, clip.sec - 2)}; for the final 1.5 seconds the person is silent, smiling or nodding at the camera (no speech cut-off).` : line ? ` The person does NOT speak at all — lips stay closed or in a natural smile; they react to the camera (nod, raised eyebrows, showing the product or their phone screen, a small laugh) like a silent vlog moment; a narrator voice-over will be added later. Audio: light background music only, no speech, no dialogue, no humming.` : '';
-                        const prompt = `${clip.prompt}${speech} Style: ${genreStyle(board.genre)}. Camera: ${tw.camera}. Audio: ${job.audio ? `${board.music || tw.music}${person && mode === 'native' ? ', clear voice over the music' : ''}` : 'silent'}. No on-screen text, no subtitles, no captions, no logos, no watermark.`;
-                        // 첫 프레임: 참고(제품) 사진이 있으면 그 사진을 캔버스에 앉힌 프레임(실제 제품이 움직임) · 없으면 생성 배경 · 사람 포맷은 없음
-                        let firstFrame = !person && ci === 0 ? (o.backgrounds[job.ratio] || undefined) : undefined;
-                        const refImg = !person && o.refs?.[0];
+                        const castLine = board.cast ? ` Character (identical in every shot — same face, hair, skin tone, outfit): ${board.cast}.` : '';
+                        const prompt = `${clip.prompt}${castLine}${speech} Style: ${genreStyle(board.genre)}. Camera: ${tw.camera}. Audio: ${job.audio ? `${board.music || tw.music}${person && mode === 'native' ? ', clear voice over the music' : ''}` : 'silent'}. No on-screen text, no subtitles, no captions, no logos, no watermark.`;
+                        // 첫 프레임 규칙(2026-09-17 사장님 검수 「이미지 하나 붙여놓은 영상」) — 실물 제품 사진 + 제품 히어로 포맷일 때만 사진을 첫 프레임으로. 그 외는 프롬프트만으로 장면 생성(정적 배경 앵커 금지)
+                        let firstFrame;
+                        const refImg = format === 'product_hero' ? o.refs?.[0] : undefined;
                         if (refImg && ci === 0 && ff) {
                             try {
                                 const stage = await renderPhoneStage(o.dir, dims.w, dims.h, o.brief.palette.primary, o.brief.palette.dark);
                                 firstFrame = await refCanvas(refImg, stage.bg, path.join(o.dir, `${key}_${rl}_refframe.png`), dims);
-                                log('  첫 프레임 = 올린 제품 사진');
+                                log(`  첫 프레임 = 제품 사진(${path.basename(refImg)})`);
+                            }
+                            catch { /* 없이 진행 */ }
+                        }
+                        // 인물·장소가 이어지는 컷은 앞 컷의 마지막 프레임에서 시작(컷 사이 인물 바뀜 방지 · 2026-09-17 에어서울 실사고)
+                        if (!firstFrame && clip.continues && ci > 0 && ff && clipFiles[ci - 1] && fs.existsSync(clipFiles[ci - 1])) {
+                            try {
+                                firstFrame = await lastFrame(clipFiles[ci - 1], path.join(o.dir, `${key}_${rl}_c${ci}_from.png`));
+                                log('  앞 컷 마지막 프레임에서 이어서');
                             }
-                            catch { /* 생성 배경 유지 */ }
+                            catch { /* 없이 진행 */ }
                         }
                         // 말하는 클립의 모델 — 영어 아닌 언어는 Seedance 네이티브 발화(립싱크) · 영어는 Veo
                         const clipModel = line && mode === 'native' ? speechVideoModel(rl, job.model) : job.model;
@@ -178,6 +198,37 @@ export async function produceConceptVideos(o) {
                                 }
                             }
                         }
+                        // QA ①-b 비주얼 결함(중복 물체·손가락·얼굴 왜곡·불가능한 제품 형태) → 1회 재생성
+                        if (ff && !isMockGen()) {
+                            const art = await checkArtifacts(cf);
+                            log(`  ${art.note}`);
+                            if (!art.ok) {
+                                try {
+                                    const r4 = await generateVideo({ file: cf, prompt: `${prompt} Physically plausible and clean: exactly one of each object, correct anatomy (five fingers), no duplicated or overlapping items, no melting or warped shapes.`, ratio: job.ratio, durationSec: clip.sec, model: clipModel, resolution: job.resolution, audio: job.audio, firstFrame, negative: 'duplicated objects, double image, extra fingers, extra limbs, deformed hands, warped face, melting, floating parts, text, subtitles, watermark, logo', log });
+                                    costKrw += r4.costKrw;
+                                    const art2 = await checkArtifacts(cf);
+                                    log(`  다시 만든 컷 ${art2.note}`);
+                                }
+                                catch (e) {
+                                    log(`  ⚠ 재생성 실패(첫 테이크 사용): ${e instanceof Error ? e.message.slice(0, 100) : e}`);
+                                }
+                            }
+                        }
+                        // QA ②-0 움직임: 사실상 정지 화면이면 첫 프레임 없이 「역동적 카메라」로 1회 재생성(원가 추가)
+                        if (ff && !isMockGen()) {
+                            const mo = await motionScore(cf);
+                            if (mo < 3) {
+                                log(`  움직임이 거의 없어요(점수 ${mo.toFixed(1)}) → 장면을 다시 만들어요`);
+                                try {
+                                    const r3 = await generateVideo({ file: cf, prompt: `${prompt} IMPORTANT: continuous visible motion throughout — moving subject, camera push-in or pan, changing light; never a static image.`, ratio: job.ratio, durationSec: clip.sec, model: clipModel, resolution: job.resolution, audio: job.audio, negative: 'static image, still frame, slideshow, text, subtitles, watermark, logo', log });
+                                    costKrw += r3.costKrw;
+                                    log(`  다시 만든 컷 움직임 ${(await motionScore(cf)).toFixed(1)}`);
+                                }
+                                catch (e) {
+                                    log(`  ⚠ 재생성 실패(원본 사용): ${e instanceof Error ? e.message.slice(0, 100) : e}`);
+                                }
+                            }
+                        }
                         // QA ② 참고 제품 사진이 있으면 프레임의 제품이 같은지 → 다르면 사진 켄번즈(생성 위험 0)로 교체
                         if (refImg && ff && !isMockGen()) {
                             const q = await checkProductMatch(cf, refImg);
@@ -223,16 +274,17 @@ export async function produceConceptVideos(o) {
                 log(`  ⚠ 이어붙이기 실패(첫 컷만 사용): ${e instanceof Error ? e.message.slice(0, 120) : e}`);
                 fs.copyFileSync(clipFiles[0], rawFile);
             }
-            // TTS 내레이션(영어 외 시장의 말하는 포맷) — 번역된 대사를 그 언어 음성으로 얹는다
-            const ttsLine = board.clips.find((cl) => cl.kind === 'gen' && cl.speech) ? (rl === board.lang ? board.clips.find((cl) => cl.speech).speech : lb0.speech || lb0.voice) : undefined;
-            if (ttsLine && speechModeFor(rl) === 'tts' && ff) {
+            // 내레이션 — ① 말하는 포맷인데 TTS 모드(Seedance 없음) ② 사람 없는 포맷(제품·시네마틱·라이프스타일·글자 훅)은 콘티 voice 를 TTS 로(무음·음악만인 영상 방지 · 2026-09-17)
+            const speakingBoard = board.clips.some((cl) => cl.kind === 'gen' && cl.speech);
+            const ttsLine = speakingBoard ? (speechModeFor(rl) === 'tts' ? (rl === board.lang ? board.clips.find((cl) => cl.speech).speech : lb0.speech || lb0.voice) : undefined) : (lb0.voice || board.voice);
+            if (ttsLine && ttsAvailable() && ff && !isMockGen()) {
                 try {
                     // 🔴 Veo 는 「대사 없이」 라고 해도 웅얼거리는 말을 넣는다(2026-09-16 실측 · TTS 와 겹쳐 들림) → 원본에 말소리가 있으면 원본 소리를 버리고 TTS 만, 음악만이면 낮춰서 깐다
                     const sp = await checkSpeech(rawFile, { lang: rl, expected: '' });
                     const hasSpeech = !sp.skipped && sp.data?.lang !== 'none';
                     const v = await synthesizeSpeech({ text: ttsLine, lang: rl, file: path.join(o.dir, `${key}_${rl}_vo.mp3`), tone, persona: o.brief.audienceProfile?.persona });
                     const mixed = rawFile.replace(/\.raw\.mp4$/, '.vo.raw.mp4');
-                    await mixVoiceover(rawFile, v.file, mixed, { duck: hasSpeech ? 0 : 0.3 });
+                    await mixVoiceover(rawFile, v.file, mixed, { duck: hasSpeech ? 0 : speakingBoard ? 0.3 : 0.4 });
                     fs.copyFileSync(mixed, rawFile);
                     costByLang[rl] = (costByLang[rl] || 0) + v.costKrw;
                     log(`  ${langName(rl)} 내레이션(TTS) ${v.durationSec.toFixed(1)}초 얹음 ✓${hasSpeech ? ' (원본 말소리 감지 → 원본 소리 제거)' : ' (원본 음악 유지)'}`);

package/dist/core/creatives/playbook.js

@@ -55,7 +55,8 @@ export const GENRE_STYLE = {
     anime: 'high-quality Japanese anime style, clean linework, vivid cel shading, dramatic sky and light, studio-quality animation',
     '3d': 'stylized 3D render, soft global illumination, Pixar-like character appeal, clean materials',
     illustration: 'flat editorial illustration, bold shapes, limited palette, tasteful texture',
-    motion_graphics: 'kinetic typography and motion graphics, clean vector shapes, brand colors, smooth easing',
+    // 🔴 AI 가 그리는 글자·숫자는 깨진다(SaaS 글자 훅에 의미 없는 숫자 · 2026-09-17) → 모션그래픽은 추상 도형만, 글자는 우리 자막이 담당
+    motion_graphics: 'abstract motion graphics with clean vector shapes, flowing lines and brand-color gradients, smooth easing — strictly NO letters, NO numbers, NO words, NO UI, NO charts with labels',
     product_shot: 'studio product photography, macro detail, controlled lighting, clean backdrop',
 };
 export const genreStyle = (g) => GENRE_STYLE[g || ''] || GENRE_STYLE.photoreal;

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

@@ -16,7 +16,14 @@ export declare function checkSpeech(video: string, o: {
 export declare function checkProductMatch(video: string, refImage: string): Promise<QaResult>;
 /** 프레임 위생 — 길이·크기·검은 화면 비율 */
 export declare function checkFrames(video: string, minSec?: number): Promise<QaResult>;
-/** 사진에 실존 인물(얼굴)이 있나 — 사이트에서 자동으로 가져온 이미지는 연예인·모델 사진일 수 있어 참고 이미지로 쓰면 초상권 위험(2026-09-16 실측: 뷰티 사이트 대표 이미지가 아이돌) → 사람 없는 제품 사진만 통과 */
+/** 사이트 자동 수집 이미지 분류 — 실물 제품 사진만 참고로 쓴다. 사람(초상권) · 로고/배너/글자 그래픽(2026-09-16 실사고: og:image 빨간 로고 상자가 첫 프레임이 됨) 제외 */
+export declare function classifyRefImage(image: string): Promise<{
+    person: boolean;
+    product: boolean;
+    graphic: boolean;
+} | null>;
 export declare function containsPerson(image: string): Promise<boolean | null>;
-/** 자동 수집 이미지 중 사람 없는 것만(판정 불가면 제외 — 보수적) */
+/** 자동 수집 이미지 중 「사람 없음 · 실물 제품 · 그래픽 아님」만(판정 불가면 제외 — 보수적) */
 export declare function filterProductRefs(files: string[], log?: (s: string) => void): Promise<string[]>;
+/** 비주얼 결함 — 3프레임을 qwen 비전에: 중복/이중 물체 · 손가락·팔 이상 · 얼굴 왜곡 · 물리적으로 불가능한 제품(쿠션에서 마스카라 브러시) · 깨진 글자. 실패면 재생성 대상 */
+export declare function checkArtifacts(video: string): Promise<QaResult>;

package/dist/core/creatives/qa.js

@@ -120,29 +120,67 @@ export async function checkFrames(video, minSec = 2) {
         return { ok: true, skipped: true, note: `프레임 검사 건너뜀(${e instanceof Error ? e.message.slice(0, 60) : e})` };
     }
 }
-/** 사진에 실존 인물(얼굴)이 있나 — 사이트에서 자동으로 가져온 이미지는 연예인·모델 사진일 수 있어 참고 이미지로 쓰면 초상권 위험(2026-09-16 실측: 뷰티 사이트 대표 이미지가 아이돌) → 사람 없는 제품 사진만 통과 */
-export async function containsPerson(image) {
+/** 사이트 자동 수집 이미지 분류 — 실물 제품 사진만 참고로 쓴다. 사람(초상권) · 로고/배너/글자 그래픽(2026-09-16 실사고: og:image 빨간 로고 상자가 첫 프레임이 됨) 제외 */
+export async function classifyRefImage(image) {
     const cfg = imageConfig();
     if (!cfg || cfg.provider !== 'bizrouter')
         return null;
     try {
-        const res = await fetch(`${cfg.base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model: 'bizrouter/qwen-3.8-flash', max_tokens: 20, messages: [{ role: 'user', content: [{ type: 'text', text: 'Does this image contain a real human person or face (photo or realistic render)? Answer exactly "yes" or "no".' }, { type: 'image_url', image_url: { url: dataUrl(image) } }] }] }), signal: AbortSignal.timeout(60_000) });
+        const res = await fetch(`${cfg.base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model: 'bizrouter/qwen-3.8-flash', max_tokens: 80, messages: [{ role: 'user', content: [{ type: 'text', text: 'Classify this image for use as an ad reference. Answer JSON only: {"person": true if a real human person/face is visible, "product": true if a physical product/item (packaging, device, food, garment, vehicle, building, etc.) is clearly visible as the main subject, "graphic": true if it is mainly a logo, wordmark, text banner, icon, screenshot or flat brand graphic}' }, { type: 'image_url', image_url: { url: dataUrl(image) } }] }] }), signal: AbortSignal.timeout(60_000) });
         const j = (await res.json());
-        return /yes/i.test(j.choices?.[0]?.message?.content || '');
+        const m = /\{[\s\S]*\}/.exec(j.choices?.[0]?.message?.content || '');
+        const d = JSON.parse(m ? m[0] : '{}');
+        return { person: !!d.person, product: !!d.product, graphic: !!d.graphic };
     }
     catch {
         return null;
     }
 }
-/** 자동 수집 이미지 중 사람 없는 것만(판정 불가면 제외 — 보수적) */
+export async function containsPerson(image) { const c = await classifyRefImage(image); return c ? c.person : null; }
+/** 자동 수집 이미지 중 「사람 없음 · 실물 제품 · 그래픽 아님」만(판정 불가면 제외 — 보수적) */
 export async function filterProductRefs(files, log) {
     const out = [];
     for (const f of files) {
-        const p = await containsPerson(f);
-        if (p === false)
-            out.push(f);
+        const c = await classifyRefImage(f);
+        const name = f.split('/').pop();
+        if (!c) {
+            log?.(`  사이트 이미지 ${name} 판정 불가 → 제외`);
+            continue;
+        }
+        if (c.person)
+            log?.(`  사이트 이미지 ${name} 은 사람이 있어 제외(초상권)`);
+        else if (c.graphic || !c.product)
+            log?.(`  사이트 이미지 ${name} 은 로고·배너·그래픽이라 제외`);
         else
-            log?.(`  사이트 이미지 ${f.split('/').pop()} 은 사람이 있어 참고에서 제외(초상권)`);
+            out.push(f);
     }
     return out;
 }
+/** 비주얼 결함 — 3프레임을 qwen 비전에: 중복/이중 물체 · 손가락·팔 이상 · 얼굴 왜곡 · 물리적으로 불가능한 제품(쿠션에서 마스카라 브러시) · 깨진 글자. 실패면 재생성 대상 */
+export async function checkArtifacts(video) {
+    const cfg = imageConfig();
+    if (!cfg || cfg.provider !== 'bizrouter')
+        return { ok: true, skipped: true, note: '결함 검사 건너뜀(키 없음)' };
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'adp-qa-'));
+    try {
+        const p = await probe(video);
+        const frames = [];
+        for (const t of [0.6, p.durationSec / 2, Math.max(0.8, p.durationSec - 0.6)]) {
+            const f = path.join(dir, `f${frames.length}.jpg`);
+            await execFileP('ffmpeg', ['-y', '-v', 'error', '-ss', t.toFixed(2), '-i', video, '-frames:v', '1', '-vf', 'scale=540:-1', '-q:v', '4', f]);
+            frames.push(f);
+        }
+        const res = await fetch(`${cfg.base}/v1/chat/completions`, { method: 'POST', headers: { 'content-type': 'application/json', authorization: `Bearer ${cfg.key}` }, body: JSON.stringify({ model: 'bizrouter/qwen-3.8-flash', max_tokens: 220, messages: [{ role: 'user', content: [{ type: 'text', text: 'These are 3 frames from an AI-generated short ad. Look for visual defects a viewer would notice: duplicated or doubled objects (e.g. two overlapping products/wands), extra or malformed fingers/limbs, warped or melting faces, physically impossible product forms (a mascara wand coming out of a compact, a bottle merging into a hand), floating parts, garbled letters. Ignore intentional stylization. Answer JSON only: {"defects": true|false, "severity": 0-3, "issues": ["<8 words each"]}' }, ...frames.map((f) => ({ type: 'image_url', image_url: { url: dataUrl(f) } }))] }] }), signal: AbortSignal.timeout(90_000) });
+        const j = (await res.json());
+        const m = /\{[\s\S]*\}/.exec(j.choices?.[0]?.message?.content || '');
+        const d = JSON.parse(m ? m[0] : '{}');
+        const bad = d.defects === true && (d.severity ?? 3) >= 2;
+        return { ok: !bad, note: bad ? `비주얼 결함: ${(d.issues || []).slice(0, 3).join(' · ')}` : `비주얼 검사 ✓${d.defects ? ` (경미: ${(d.issues || [])[0] || ''})` : ''}`, data: d };
+    }
+    catch (e) {
+        return { ok: true, skipped: true, note: `결함 검사 건너뜀(${e instanceof Error ? e.message.slice(0, 60) : e})` };
+    }
+    finally {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+}

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

@@ -17,6 +17,8 @@ type El = {
 };
 /** 밝은 브랜드색(베이지·노랑·민트) 위엔 어두운 글자 — 상대 명도로 판정 */
 export declare function onColor(hex: string): string;
+/** 어절 단위 줄바꿈 — satori 는 숫자·라틴과 한글 사이에서 줄을 바꾼다(「300명도」→「300 / 명도」 · 2026-09-17 사장님 지적). 공백으로 나눈 어절을 nowrap 조각으로 감싸고 flex-wrap 으로 흐르게 한다. */
+export declare function wordsEl(text: string, style: Record<string, unknown>, align?: 'left' | 'center'): El;
 /** 한 규격의 트리 */
 export declare function tree(size: Size, concept: Concept, brief: Brief, bg: string | null, logo: string | null, ctaText: string): El;
 export declare const CTA_LABEL: Record<string, Record<string, string>>;

package/dist/core/creatives/render.js

@@ -97,6 +97,12 @@ async function fetchLogo(url, dir) {
 const h = (type, style, children, extra = {}) => ({ type, props: { style, ...extra, ...(children === undefined ? {} : { children }) } });
 /** 밝은 브랜드색(베이지·노랑·민트) 위엔 어두운 글자 — 상대 명도로 판정 */
 export function onColor(hex) { const m = hex.replace('#', ''); const n = parseInt(m.length === 3 ? m.split('').map((c) => c + c).join('') : m, 16); const r = (n >> 16) & 255, g = (n >> 8) & 255, b = n & 255; const L = (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255; return L > 0.62 ? '#0b1526' : '#ffffff'; }
+/** 어절 단위 줄바꿈 — satori 는 숫자·라틴과 한글 사이에서 줄을 바꾼다(「300명도」→「300 / 명도」 · 2026-09-17 사장님 지적). 공백으로 나눈 어절을 nowrap 조각으로 감싸고 flex-wrap 으로 흐르게 한다. */
+export function wordsEl(text, style, align = 'left') {
+    const words = String(text || '').split(/\s+/).filter(Boolean);
+    const gap = Math.round(Number(style.fontSize || 16) * 0.26);
+    return h('div', { display: 'flex', flexWrap: 'wrap', justifyContent: align === 'center' ? 'center' : 'flex-start', columnGap: gap, rowGap: 0, ...style, whiteSpace: 'nowrap' }, words.map((w) => h('span', { whiteSpace: 'nowrap' }, w)));
+}
 function hexA(hex, a) { const m = hex.replace('#', ''); const n = parseInt(m.length === 3 ? m.split('').map((c) => c + c).join('') : m, 16); return `rgba(${(n >> 16) & 255},${(n >> 8) & 255},${n & 255},${a})`; }
 /** 한 규격의 트리 */
 export function tree(size, concept, brief, bg, logo, ctaText) {
@@ -140,15 +146,15 @@ export function tree(size, concept, brief, bg, logo, ctaText) {
         children.push(h('div', { position: 'absolute', top: 0, left: 0, width: w, height: hh, display: 'flex', alignItems: 'center', justifyContent: 'space-between', padding: `0 ${pad}px`, gap: pad }, [brandRow, h('div', { flex: 1, fontSize: headFs, fontWeight: 800, color: fg, letterSpacing: -1, lineHeight: 1.1, whiteSpace: 'nowrap', overflow: 'hidden' }, head), ctaPill]));
     }
     else if (narrow) {
-        children.push(h('div', { position: 'absolute', top: 0, left: 0, width: w, height: hh, display: 'flex', flexDirection: 'column', justifyContent: 'space-between', padding: pad }, [brandRow, h('div', { display: 'flex', flexDirection: 'column', gap: Math.round(pad * 0.6) }, [h('div', { fontSize: headFs, fontWeight: 800, color: fg, lineHeight: 1.15, letterSpacing: -0.8, wordBreak: 'keep-all' }, head), h('div', { fontSize: bodyFs, fontWeight: 500, color: sub, lineHeight: 1.4, wordBreak: 'keep-all' }, body.slice(0, 60))]), ctaPill]));
+        children.push(h('div', { position: 'absolute', top: 0, left: 0, width: w, height: hh, display: 'flex', flexDirection: 'column', justifyContent: 'space-between', padding: pad }, [brandRow, h('div', { display: 'flex', flexDirection: 'column', gap: Math.round(pad * 0.6) }, [wordsEl(head, { fontSize: headFs, fontWeight: 800, color: fg, lineHeight: 1.15, letterSpacing: -0.8 }), wordsEl(body.slice(0, 60), { fontSize: bodyFs, fontWeight: 500, color: sub, lineHeight: 1.4 })]), ctaPill]));
     }
     else {
         const isWide = w / hh > 1.6;
         children.push(h('div', { position: 'absolute', top: 0, left: 0, width: w, height: hh, display: 'flex', flexDirection: 'column', justifyContent: 'space-between', padding: pad }, [
             h('div', { display: 'flex', justifyContent: 'space-between', alignItems: 'center' }, [brandRow, domain && !banner ? h('div', { fontSize: Math.round(headFs * 0.3), fontWeight: 500, color: sub }, domain) : h('div', {}, '')]),
             h('div', { display: 'flex', flexDirection: 'column', gap: Math.round(pad * (banner ? 0.35 : 0.5)), maxWidth: isWide ? Math.round(w * 0.72) : w - pad * 2 }, [
-                h('div', { fontSize: headFs, fontWeight: 800, color: fg, lineHeight: 1.12, letterSpacing: -1.5, wordBreak: 'keep-all' }, head),
-                (banner && bodyFs < 14) || bodyFs === 0 ? h('div', {}, '') : h('div', { fontSize: bodyFs, fontWeight: 500, color: sub, lineHeight: 1.45, wordBreak: 'keep-all' }, banner ? body.slice(0, 70) : googleLight ? body.slice(0, 48) : body),
+                wordsEl(head, { fontSize: headFs, fontWeight: 800, color: fg, lineHeight: 1.12, letterSpacing: -1.5 }),
+                (banner && bodyFs < 14) || bodyFs === 0 ? h('div', {}, '') : wordsEl(banner ? body.slice(0, 70) : googleLight ? body.slice(0, 48) : body, { fontSize: bodyFs, fontWeight: 500, color: sub, lineHeight: 1.45 }),
                 h('div', { display: 'flex', marginTop: Math.round(pad * 0.3) }, [ctaPill]),
             ]),
             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)]),
@@ -209,10 +215,10 @@ export async function renderOverlay(file, w, hh, text, o) {
     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: onColor(o.primary), 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);
+        : h('div', { display: 'flex', 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`, maxWidth: Math.round(w * 0.86) }, [wordsEl(text, { fontSize: fs1, fontWeight: 800, color: '#fff', lineHeight: 1.25, letterSpacing: -1 }, 'center')]);
     // 안전영역: 릴스·쇼츠 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: onColor(o.primary), 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 hookEl = h('div', { display: 'flex', maxWidth: Math.round(w * 0.86), 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)' }, [wordsEl(text, { fontSize: Math.round(base * 0.095), fontWeight: 800, color: onColor(o.primary), lineHeight: 1.12, letterSpacing: -1.5, textShadow: '0 4px 24px rgba(0,0,0,.65), 0 1px 2px rgba(0,0,0,.8)' }, 'center')]);
     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])

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

@@ -4,7 +4,8 @@ export type Clip = {
     sec: number;
     kind: 'gen' | 'ui_demo';
     prompt: string;
-    speech?: string;
+    speech?: string; /** 앞 컷과 같은 인물·장소가 이어짐 → 앞 컷 마지막 프레임을 첫 프레임으로 */
+    continues?: boolean;
 };
 export type Storyboard = {
     id: string;
@@ -20,6 +21,8 @@ export type Storyboard = {
     score?: number;
     scoreNote?: string;
     lang: string;
+    /** 인물 외형 고정 문장(영어 · 모든 컷 프롬프트에 붙임 · 컷 사이 인물 바뀜 방지) */
+    cast?: string;
 };
 export type LocalizedBoard = {
     hook: string;

package/dist/core/creatives/storyboard.js

@@ -7,7 +7,8 @@ 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),
+    clips: z.array(z.object({ sec: z.number(), kind: z.enum(['gen', 'ui_demo']).default('gen'), prompt: z.string(), speech: z.string().optional().nullable(), continues: z.boolean().optional().nullable() })).min(1).max(3),
+    cast: z.string().optional().nullable(),
 });
 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;
@@ -59,8 +60,11 @@ export async function generateStoryboards(brief, concept, o) {
 - 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})만 쓴다(실제 사이트 화면을 우리가 넣는다).
+- text_hook 포맷의 clips[].prompt 는 「자막 뒤에 깔릴 배경 장면」이다 — 타겟이 일하는/사용하는 실사 장면(사람 뒷모습·손·사무실·제품 사용) 또는 추상 도형. 화면 안에 글자·숫자·차트 라벨·UI 를 그리지 말 것(우리 자막이 글자를 담당 · AI 글자는 깨진다).
+- 사람이 나오는 board 는 cast 에 인물 외형 고정 문장(영어 1문장 · 성별/나이대/인종·피부톤/머리/옷/소품 · 브리프 타겟에 맞게)을 쓰고, 그 인물이 이어지는 컷은 clips[].continues=true(앞 컷의 마지막 프레임에서 이어짐 · 인물·장소 동일). 인물 없는 컷은 continues=false.
+- 제품은 물리적으로 말이 되게 — 실제 제품 종류 하나만(쿠션에서 마스카라 브러시가 나오는 식 금지) · 한 컷에 한 제품 · 손과 제품 비율 자연스럽게.
 - 사실은 브리프(usp·proofPoints·offer)에 있는 것만. 과장·최상급·보장·전후비교·개인 속성 지칭 금지. ${brief.notes ? `주의: ${brief.notes}` : ''}
-- 출력 JSON: {"boards":[{format,genre,hook,captions[],voice,music,clips:[{sec,kind,prompt,speech}]}]}`,
+- 출력 JSON: {"boards":[{format,genre,hook,captions[],voice,music,cast,clips:[{sec,kind,prompt,speech,continues}]}]}`,
         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 = [];
@@ -70,8 +74,8 @@ export async function generateStoryboards(brief, concept, o) {
             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 });
+        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, continues: i > 0 ? !!src?.continues : false }; });
+        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, cast: b.cast || undefined });
     }
     return boards;
 }

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

@@ -74,3 +74,7 @@ export declare function refCanvas(ref: string, bgPng: string, output: string, di
     w: number;
     h: number;
 }): Promise<string>;
+/** 움직임 점수 — 1초·중간·끝 프레임(작게) 사이 평균 픽셀 차. 0~255 · 3 미만이면 사실상 정지 화면(「이미지 하나 붙여놓은 영상」) */
+export declare function motionScore(video: string): Promise<number>;
+/** 마지막 프레임 PNG — 다음 컷 첫 프레임(인물·장소 연속) */
+export declare function lastFrame(video: string, output: string): Promise<string>;

package/dist/core/creatives/videofx.js

@@ -190,3 +190,23 @@ export async function refCanvas(ref, bgPng, output, dims) {
     await execFileP('ffmpeg', ['-y', '-v', 'error', '-i', bgPng, '-i', ref, '-filter_complex', `[1:v]scale=${w}:-1:force_original_aspect_ratio=decrease,scale='min(iw,${w})':'min(ih,${Math.round(dims.h * 0.7)})':force_original_aspect_ratio=decrease[p];[0:v]scale=${dims.w}:${dims.h}[b];[b][p]overlay=(W-w)/2:(H-h)/2,format=rgb24`, '-frames:v', '1', output]);
     return output;
 }
+/** 움직임 점수 — 1초·중간·끝 프레임(작게) 사이 평균 픽셀 차. 0~255 · 3 미만이면 사실상 정지 화면(「이미지 하나 붙여놓은 영상」) */
+export async function motionScore(video) {
+    try {
+        const p = await probe(video);
+        const W = 48, H = 84;
+        const grab = async (t) => { const { stdout } = await execFileP('ffmpeg', ['-v', 'error', '-ss', t.toFixed(2), '-i', video, '-frames:v', '1', '-vf', `scale=${W}:${H}`, '-pix_fmt', 'gray', '-f', 'rawvideo', '-'], { encoding: 'buffer', maxBuffer: 1 << 20 }); return stdout; };
+        const a = await grab(Math.min(0.8, p.durationSec * 0.1)), b = await grab(p.durationSec * 0.5), c = await grab(Math.max(0.5, p.durationSec - 0.6));
+        const diff = (x, y) => { let d = 0; const n = Math.min(x.length, y.length); for (let i = 0; i < n; i++)
+            d += Math.abs(x[i] - y[i]); return n ? d / n : 0; };
+        return Math.max(diff(a, b), diff(b, c));
+    }
+    catch {
+        return 99;
+    }
+}
+/** 마지막 프레임 PNG — 다음 컷 첫 프레임(인물·장소 연속) */
+export async function lastFrame(video, output) {
+    await execFileP('ffmpeg', ['-y', '-v', 'error', '-sseof', '-0.15', '-i', video, '-frames:v', '1', '-update', '1', output]);
+    return output;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adyou",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "description": "ADYou — 대행사 없이, 당신이 직접. 사이트 주소 하나로 광고 소재·매체 등록·자동 운영·보고까지: AI 광고 자율주행 CLI + MCP 서버(Meta·Google · 생성은 항상 PAUSED · 승인 뒤 시작)",
   "type": "module",
   "license": "MIT",