hanseol-dev 5.0.2-dev.99 → 5.0.3-dev.2

package/dist/agents/office/powerpoint-create-agent.js

@@ -4,7 +4,7 @@ import { powerpointClient } from '../../tools/office/powerpoint-client.js';
 import { getSubAgentPhaseLogger, getSubAgentToolCallLogger } from '../common/sub-agent.js';
 import { logger } from '../../utils/logger.js';
 import { getPlatform } from '../../utils/platform-utils.js';
-import { PPT_CREATE_ENHANCEMENT_PROMPT, PPT_STRUCTURED_PLANNING_PROMPT, buildSlideHtmlPrompt, } from './powerpoint-create-prompts.js';
+import { PPT_DESIGN_PROMPT, buildDirectHtmlPrompt, validateSlideHtml, extractLayoutHint, buildContentFillJsonPrompt, parseContentFillJson, buildContentSlideHtml, } from './powerpoint-create-prompts.js';
 const DEFAULT_DESIGN = {
     primary_color: '#1B2A4A',
     accent_color: '#00D4AA',
@@ -17,6 +17,7 @@ const DEFAULT_DESIGN = {
     mood: 'modern-minimal',
     design_notes: 'Clean gradients, card-based layouts',
 };
+const MAX_CONCURRENT = 3;
 function extractContent(msg) {
     const content = msg['content'];
     if (content && content.trim())
@@ -26,6 +27,23 @@ function extractContent(msg) {
         return reasoning;
     return '';
 }
+function hasPlaceholderText(html) {
+    const placeholderPatterns = [
+        'Card title (2-5 words)',
+        'Detail with number/data',
+        'single emoji',
+        'Display value (e.g.',
+        'Category name',
+        '1-2 sentence key insight',
+        'Another detail',
+        'Third point',
+        'Fourth point',
+        'Brief context',
+        'Segment name',
+    ];
+    const lowerHtml = html.toLowerCase();
+    return placeholderPatterns.some(p => lowerHtml.includes(p.toLowerCase()));
+}
 function validateAndFixPlan(plan) {
     if (!plan.design)
         return 'Missing design object';
@@ -35,6 +53,9 @@ function validateAndFixPlan(plan) {
     if (!Array.isArray(plan.slides) || plan.slides.length < 3) {
         return 'slides array must have at least 3 entries';
     }
+    if (plan.slides.length < 10) {
+        return `Only ${plan.slides.length} slides — minimum 10 required (aim for 10-12). Add more content slides with specific data.`;
+    }
     if (plan.slides[0]?.type !== 'title') {
         logger.info('Auto-fixing: first slide type changed to "title"');
         plan.slides[0].type = 'title';
@@ -47,7 +68,23 @@ function validateAndFixPlan(plan) {
     for (let i = 0; i < plan.slides.length; i++) {
         if (!plan.slides[i].title) {
             plan.slides[i].title = `Slide ${i + 1}`;
-            logger.info(`Auto-fixing: slide ${i + 1} missing title, set placeholder`);
+        }
+    }
+    const layoutOnlyPatterns = [
+        /^(?:전체\s*배경|왼쪽에|오른쪽에|중앙에|상단에|하단에)/,
+        /#[0-9a-fA-F]{3,8}에서.*그라데이션/,
+        /(?:accent_light|primary|gradient_end)\s*(?:배경|글씨|색상)/,
+        /^(?:CSS|flexbox|grid|conic-gradient|linear-gradient)/i,
+    ];
+    for (let i = 0; i < plan.slides.length; i++) {
+        const slide = plan.slides[i];
+        if (slide.type === 'title' || slide.type === 'closing')
+            continue;
+        const cd = slide.content_direction || '';
+        const hasNumbers = /\d/.test(cd);
+        const isLayoutOnly = layoutOnlyPatterns.some(p => p.test(cd));
+        if (isLayoutOnly && !hasNumbers) {
+            return `Slide ${i + 1} "${slide.title}" content_direction contains layout instructions instead of actual data.`;
         }
     }
     return null;
@@ -130,19 +167,15 @@ function parseJsonPlan(raw) {
         cleaned = cleaned.replace(/^```(?:json|JSON)?\s*\n?/, '').replace(/\n?```\s*$/, '');
     }
     const firstBrace = cleaned.indexOf('{');
-    if (firstBrace > 0) {
+    if (firstBrace > 0)
         cleaned = cleaned.slice(firstBrace);
-    }
     const lastBrace = cleaned.lastIndexOf('}');
-    if (lastBrace >= 0 && lastBrace < cleaned.length - 1) {
+    if (lastBrace >= 0 && lastBrace < cleaned.length - 1)
         cleaned = cleaned.slice(0, lastBrace + 1);
-    }
     try {
         return JSON.parse(cleaned);
     }
-    catch (e) {
-        logger.debug('parseJsonPlan: direct parse failed', { error: String(e), length: cleaned.length });
-    }
+    catch { }
     const match = cleaned.match(/\{[\s\S]*\}/);
     if (!match)
         return null;
@@ -154,9 +187,7 @@ function parseJsonPlan(raw) {
     try {
         return JSON.parse(repaired);
     }
-    catch (e) {
-        logger.debug('parseJsonPlan: repaired parse failed', { error: String(e) });
-    }
+    catch { }
     try {
         let final = repaired;
         let braces = 0, brackets = 0;
@@ -187,9 +218,9 @@ function parseJsonPlan(raw) {
         }
         if (inStr)
             final += '"';
-        for (let i = 0; i < brackets; i++)
+        for (let x = 0; x < brackets; x++)
             final += ']';
-        for (let i = 0; i < braces; i++)
+        for (let x = 0; x < braces; x++)
             final += '}';
         return JSON.parse(final);
     }
@@ -199,69 +230,50 @@ function parseJsonPlan(raw) {
 }
 function extractHtml(raw) {
     const trimmed = raw.trim();
-    if (trimmed.startsWith('<!DOCTYPE') || trimmed.startsWith('<html')) {
+    if (trimmed.startsWith('<!DOCTYPE') || trimmed.startsWith('<html'))
         return trimmed;
-    }
     const fenceMatch = trimmed.match(/```(?:html)?\s*\n([\s\S]*?)\n```/);
-    if (fenceMatch?.[1]) {
+    if (fenceMatch?.[1])
         return fenceMatch[1].trim();
-    }
     const docMatch = trimmed.match(/(<!DOCTYPE[\s\S]*<\/html>)/i);
-    if (docMatch?.[1]) {
+    if (docMatch?.[1])
         return docMatch[1].trim();
-    }
     return null;
 }
-function injectViewportCss(html, backgroundColor) {
+function injectEdgeSizing(html, backgroundColor) {
     let result = html.replace(/<meta\s+name=["']viewport["'][^>]*>/gi, '');
     const bgColor = backgroundColor || '#000000';
-    const viewportMeta = `<meta name="viewport" content="width=2040">`;
-    const overrideCss = `<style>*{box-sizing:border-box;word-break:keep-all;overflow-wrap:break-word}html{width:2040px!important;height:1200px!important;overflow:hidden!important;margin:0!important;background-color:${bgColor}!important;zoom:1!important}body{width:1920px!important;height:1080px!important;min-width:1920px!important;min-height:1080px!important;overflow:hidden!important;margin:0!important;display:flex!important;flex-direction:column!important;zoom:1!important}body>div,body>main,body>section,body>article,body>header,body>footer{max-width:none!important;zoom:1!important}body>*>div,body>*>main,body>*>section,body>*>article{max-width:none!important;zoom:1!important}body>*:nth-child(2){flex:1!important;align-items:stretch!important;align-content:stretch!important;justify-content:center!important}</style>`;
-    const injection = viewportMeta + overrideCss;
+    const sizingCss = `<style id="edge-sizing">html{width:2040px!important;height:1200px!important;overflow:hidden!important;margin:0!important;background-color:${bgColor}!important;zoom:1!important}body{width:1920px!important;height:1080px!important;min-width:1920px!important;min-height:1080px!important;overflow:hidden!important;margin:0!important;zoom:1!important}</style>`;
     if (result.includes('</head>')) {
-        result = result.replace('</head>', `${injection}</head>`);
+        result = result.replace('</head>', `${sizingCss}</head>`);
     }
     else if (result.includes('<head>')) {
-        result = result.replace('<head>', `<head>${injection}`);
+        result = result.replace('<head>', `<head>${sizingCss}`);
     }
     else if (result.includes('<html')) {
-        result = result.replace(/<html[^>]*>/, (match) => `${match}<head>${injection}</head>`);
+        result = result.replace(/<html[^>]*>/, (m) => `${m}<head>${sizingCss}</head>`);
     }
     else {
-        result = injection + result;
+        result = sizingCss + result;
     }
     return result;
 }
-function enforceMinFontSize(html) {
-    let result = html.replace(/font-size:\s*(\d+(?:\.\d+)?)px/g, (_match, size) => {
-        const px = parseFloat(size);
-        return (px > 12 && px < 22) ? 'font-size:22px' : _match;
-    });
-    result = result.replace(/font-size:\s*(\d+(?:\.\d+)?)pt/g, (_match, size) => {
-        const pt = parseFloat(size);
-        const px = pt * 1.333;
-        return (px > 12 && px < 22) ? 'font-size:22px' : _match;
-    });
-    return result;
-}
-function ensureSafeBodyPadding(html) {
-    const safeStyle = `<style>body{padding-top:20px!important;padding-bottom:40px!important;min-height:auto!important}body>div:last-child,body>section:last-child{margin-bottom:0!important;padding-bottom:0!important}</style>`;
-    if (html.includes('</head>')) {
-        return html.replace('</head>', `${safeStyle}</head>`);
+function injectViewportCss(html, backgroundColor) {
+    let result = html.replace(/<meta\s+name=["']viewport["'][^>]*>/gi, '');
+    const bgColor = backgroundColor || '#000000';
+    const overrideCss = `<style>*{box-sizing:border-box;word-break:keep-all;overflow-wrap:break-word}html{width:2040px!important;height:1200px!important;overflow:hidden!important;margin:0!important;background-color:${bgColor}!important;zoom:1!important}body{width:1920px!important;height:1080px!important;min-width:1920px!important;min-height:1080px!important;overflow:hidden!important;margin:0!important;display:flex!important;flex-direction:column!important;zoom:1!important;font-size:26px!important}body>div,body>main,body>section,body>article,body>header,body>footer{max-width:none!important;zoom:1!important}body>*>div,body>*>main,body>*>section,body>*>article{max-width:none!important;zoom:1!important}body>*:only-child{display:flex!important;flex-direction:column!important;flex:1!important;min-height:1080px!important}body>*:only-child>*:nth-child(2),body>*:only-child>*:nth-child(3),body>*:only-child>*:last-child:not(:first-child){flex:1!important;display:flex!important;align-items:stretch!important}body>.content,body>*:nth-child(2),body>*:nth-child(3),body *>.content,body [class*=content]{flex:1!important;align-items:stretch!important;align-content:stretch!important;grid-auto-rows:1fr!important}[class*=card],[class*=item],[class*=step],[class*=milestone],[class*=feature]{justify-content:flex-start!important;gap:20px!important}</style>`;
+    if (result.includes('</head>')) {
+        result = result.replace('</head>', `${overrideCss}</head>`);
+    }
+    else if (result.includes('<head>')) {
+        result = result.replace('<head>', `<head>${overrideCss}`);
+    }
+    else if (result.includes('<html')) {
+        result = result.replace(/<html[^>]*>/, (m) => `${m}<head>${overrideCss}</head>`);
+    }
+    else {
+        result = overrideCss + result;
     }
-    return html;
-}
-function removeAbsolutePositioning(html) {
-    let result = html.replace(/style="([^"]*)position:\s*absolute([^"]*)"/gi, (match, before, after) => {
-        if (/(?:width|height):\s*[1-5]?\dpx/i.test(before + after) || /opacity:\s*0\.[0-4]/i.test(before + after)) {
-            return match;
-        }
-        return `style="${before}position:relative${after}"`;
-    });
-    result = result.replace(/(\.(?:title|heading|label|text|badge|stat|value|card|item|metric)[^{]*\{[^}]*)position:\s*absolute/gi, '$1position:relative');
-    result = result.replace(/transform:\s*scale\(\s*0\.\d+\s*\)/gi, 'transform:none');
-    result = result.replace(/transform:\s*scale\(\s*0\.\d+\s*,\s*0\.\d+\s*\)/gi, 'transform:none');
-    result = result.replace(/zoom:\s*0\.\d+/gi, 'zoom:1');
     return result;
 }
 function injectTitleContrastFix(html, designTextColor) {
@@ -290,40 +302,10 @@ function injectTitleContrastFix(html, designTextColor) {
     }
     return html + script;
 }
-function injectMeasureCss(html) {
-    let result = html.replace(/<meta\s+name=["']viewport["'][^>]*>/gi, '');
-    const viewportMeta = `<meta name="viewport" content="width=2040">`;
-    const measureCss = `<style>*{box-sizing:border-box;word-break:keep-all;overflow-wrap:break-word}html{width:2040px!important;margin:0!important}body{width:1920px!important;min-width:1920px!important;min-height:1080px!important;margin:0!important;display:flex!important;flex-direction:column!important}body>div,body>main,body>section,body>article,body>header,body>footer{max-width:none!important}</style>`;
-    const injection = viewportMeta + measureCss;
-    if (result.includes('</head>')) {
-        result = result.replace('</head>', `${injection}</head>`);
-    }
-    else if (result.includes('<head>')) {
-        result = result.replace('<head>', `<head>${injection}`);
-    }
-    else if (result.includes('<html')) {
-        result = result.replace(/<html[^>]*>/, (match) => `${match}<head>${injection}</head>`);
-    }
-    else {
-        result = injection + result;
-    }
-    const measureScript = `<script>document.title='SH:'+document.documentElement.scrollHeight</script>`;
-    if (result.includes('</body>')) {
-        result = result.replace('</body>', `${measureScript}</body>`);
-    }
-    else {
-        result += measureScript;
-    }
-    return result;
-}
 function escapeHtml(text) {
-    return text
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 }
-function buildTitleSlideHtml(design, mainTitle, subtitle, date, slideNum) {
+function buildTitleSlideHtml(design, mainTitle, subtitle, date, _slideNum) {
     return `<!DOCTYPE html>
 <html lang="ko">
 <head>
@@ -335,29 +317,21 @@ html, body { width: 1920px; height: 1080px; overflow: hidden; }
 body {
   background: linear-gradient(135deg, ${design.primary_color} 0%, ${design.gradient_end} 60%, ${design.primary_color} 100%);
   display: flex;
+  flex-direction: column;
   align-items: center;
   justify-content: center;
-  position: relative;
   font-family: "${design.font_title}", "Segoe UI", sans-serif;
 }
-.decor {
-  position: absolute;
-  border-radius: 50%;
-  background: rgba(255,255,255,0.03);
-  pointer-events: none;
-}
-.d1 { width: 700px; height: 700px; top: -250px; right: -150px; }
-.d2 { width: 500px; height: 500px; bottom: -180px; left: -120px; }
-.d3 { width: 250px; height: 250px; top: 40%; left: 8%; background: rgba(255,255,255,0.02); }
-.d4 { width: 180px; height: 180px; bottom: 15%; right: 12%; background: rgba(255,255,255,0.02); }
-.top-accent {
-  position: absolute;
-  top: 0; left: 0; width: 100%; height: 6px;
+body::before {
+  content: '';
+  display: block;
+  width: 100%;
+  height: 6px;
   background: linear-gradient(90deg, transparent, ${design.accent_color}, transparent);
+  flex-shrink: 0;
 }
-.content {
+.slide-content {
   text-align: center;
-  z-index: 1;
   max-width: 1400px;
   padding: 0 60px;
 }
@@ -391,32 +365,22 @@ body {
   color: rgba(255,255,255,0.55);
   font-family: "${design.font_body}", "Malgun Gothic", sans-serif;
 }
-.page-num {
-  position: absolute;
-  bottom: 24px; right: 44px;
-  font-size: 13px;
-  color: rgba(255,255,255,0.35);
-}
 </style>
 </head>
 <body>
-<div class="top-accent"></div>
-<div class="decor d1"></div>
-<div class="decor d2"></div>
-<div class="decor d3"></div>
-<div class="decor d4"></div>
-<div class="content">
+<div class="slide-content">
   <div class="main-title">${escapeHtml(mainTitle)}</div>
   <div class="accent-bar"></div>
   ${subtitle ? `<div class="subtitle">${escapeHtml(subtitle)}</div>` : ''}
   <div class="date-text">${escapeHtml(date)}</div>
 </div>
-<div class="page-num">${slideNum}</div>
+<style>body{align-items:center!important;justify-content:center!important}.slide-content{flex:unset!important;min-height:unset!important;display:flex!important;flex-direction:column!important;align-items:center!important;justify-content:center!important}.slide-content>*{flex:unset!important;min-height:unset!important}</style>
 </body>
 </html>`;
 }
-function buildClosingSlideHtml(design, companyName, slideNum, language) {
+function buildClosingSlideHtml(design, companyName, _slideNum, language, tagline) {
     const thankYou = language === 'ko' ? '감사합니다' : 'Thank You';
+    const taglineHtml = tagline ? `<div class="tagline">${escapeHtml(tagline)}</div>` : '';
     return `<!DOCTYPE html>
 <html lang="${language}">
 <head>
@@ -428,75 +392,77 @@ html, body { width: 1920px; height: 1080px; overflow: hidden; }
 body {
   background: linear-gradient(135deg, ${design.primary_color} 0%, ${design.gradient_end} 60%, ${design.primary_color} 100%);
   display: flex;
+  flex-direction: column;
   align-items: center;
   justify-content: center;
-  position: relative;
   font-family: "${design.font_title}", "Segoe UI", sans-serif;
 }
-.decor {
+body::before {
+  content: '';
   position: absolute;
-  border-radius: 50%;
-  background: rgba(255,255,255,0.03);
-  pointer-events: none;
+  top: 0; left: 0; right: 0;
+  height: 6px;
+  background: linear-gradient(90deg, transparent, ${design.accent_color}, transparent);
 }
-.d1 { width: 600px; height: 600px; top: -200px; left: -150px; }
-.d2 { width: 400px; height: 400px; bottom: -120px; right: -80px; }
-.bottom-accent {
+body::after {
+  content: '';
   position: absolute;
-  bottom: 0; left: 0; width: 100%; height: 6px;
+  bottom: 0; left: 0; right: 0;
+  height: 6px;
   background: linear-gradient(90deg, transparent, ${design.accent_color}, transparent);
 }
-.content {
+.slide-content {
   text-align: center;
-  z-index: 1;
+  max-width: 1200px;
 }
 .thank-you {
-  font-size: 96px;
+  font-size: 104px;
   font-weight: 800;
   color: #ffffff;
   letter-spacing: -1px;
   text-shadow: 0 6px 40px rgba(0,0,0,0.25);
-  margin-bottom: 32px;
+  margin-bottom: 36px;
 }
 .accent-bar {
-  width: 100px; height: 5px;
+  width: 120px; height: 5px;
   background: ${design.accent_color};
-  margin: 0 auto 32px;
+  margin: 0 auto 36px;
   border-radius: 3px;
   box-shadow: 0 0 20px ${design.accent_color}40;
 }
 .company {
-  font-size: 36px;
-  font-weight: 500;
-  color: rgba(255,255,255,0.80);
+  font-size: 44px;
+  font-weight: 600;
+  color: rgba(255,255,255,0.88);
   font-family: "${design.font_body}", "Malgun Gothic", sans-serif;
+  margin-bottom: 20px;
 }
-.page-num {
-  position: absolute;
-  bottom: 24px; right: 44px;
-  font-size: 13px;
-  color: rgba(255,255,255,0.35);
+.tagline {
+  font-size: 28px;
+  font-weight: 400;
+  color: rgba(255,255,255,0.60);
+  font-family: "${design.font_body}", "Malgun Gothic", sans-serif;
+  line-height: 1.6;
+  max-width: 900px;
+  margin: 0 auto;
 }
 </style>
 </head>
 <body>
-<div class="decor d1"></div>
-<div class="decor d2"></div>
-<div class="bottom-accent"></div>
-<div class="content">
+<div class="slide-content">
   <div class="thank-you">${escapeHtml(thankYou)}</div>
   <div class="accent-bar"></div>
   <div class="company">${escapeHtml(companyName)}</div>
+  ${taglineHtml}
 </div>
-<div class="page-num">${slideNum}</div>
+<style>body{align-items:center!important;justify-content:center!important}.slide-content{flex:unset!important;min-height:unset!important;display:flex!important;flex-direction:column!important;align-items:center!important;justify-content:center!important}.slide-content>*{flex:unset!important;min-height:unset!important}</style>
 </body>
 </html>`;
 }
 function isOverviewSlide(title, slideIndex) {
     if (slideIndex !== 1)
         return false;
-    const overviewKeywords = /개요|목차|overview|agenda|outline|순서|발표\s*구성|contents|목록/i;
-    return overviewKeywords.test(title);
+    return /개요|목차|overview|agenda|outline|순서|발표\s*구성|contents|목록/i.test(title);
 }
 function parseOverviewItems(contentDirection) {
     const items = [];
@@ -520,11 +486,8 @@ function parseOverviewItems(contentDirection) {
 }
 function buildOverviewSlideHtml(design, title, subtitle, items, slideNum) {
     const badgeColors = [
-        design.primary_color,
-        design.accent_color,
-        design.gradient_end,
-        design.primary_color,
-        design.accent_color,
+        design.primary_color, design.accent_color, design.gradient_end,
+        design.primary_color, design.accent_color,
     ];
     const itemCount = items.length;
     const topRow = itemCount <= 3 ? items : items.slice(0, Math.ceil(itemCount / 2));
@@ -584,7 +547,6 @@ body {
   display: flex; flex-direction: column;
   align-items: center; text-align: center;
   gap: 12px;
-  transition: none;
 }
 .badge {
   width: 44px; height: 44px;
@@ -653,73 +615,26 @@ function normalizeDesign(raw) {
         design_notes: raw['design_notes'] || DEFAULT_DESIGN.design_notes,
     };
 }
-async function runStructured(llmClient, instruction, explicitSavePath) {
-    const startTime = Date.now();
-    const phaseLogger = getSubAgentPhaseLogger();
-    const toolCallLogger = getSubAgentToolCallLogger();
-    let totalToolCalls = 0;
-    const timestamp = Date.now();
-    logger.enter('PPT-Create.runStructured');
-    const hasKorean = /[\uac00-\ud7af\u1100-\u11ff]/.test(instruction);
-    const language = hasKorean ? 'ko' : 'en';
-    if (phaseLogger)
-        phaseLogger('powerpoint-create', 'enhancement', 'Generating creative guidance...');
-    let guidance = '';
-    try {
-        const enhRes = await llmClient.chatCompletion({
-            messages: [
-                { role: 'system', content: PPT_CREATE_ENHANCEMENT_PROMPT },
-                { role: 'user', content: instruction },
-            ],
-            temperature: 0.7,
-            max_tokens: 2000,
-        });
-        const enhMsg = enhRes.choices[0]?.message;
-        guidance = enhMsg ? extractContent(enhMsg) : '';
-        if (guidance.length < 500) {
-            logger.warn('PPT enhancement too short, retrying', { length: guidance.length });
-            const retryEnhRes = await llmClient.chatCompletion({
-                messages: [
-                    { role: 'system', content: PPT_CREATE_ENHANCEMENT_PROMPT },
-                    { role: 'user', content: `${instruction}\n\nIMPORTANT: Produce a COMPLETE, DETAILED design system and content plan. Include ALL 7 sections: DOCUMENT_TYPE, AUDIENCE, MOOD, COLOR PALETTE (6 hex values), FONTS, SLIDE PLAN (10-15 slides), DESIGN NOTES. Do NOT stop early.` },
-                ],
-                temperature: 0.7,
-                max_tokens: 2000,
-            });
-            const retryMsg = retryEnhRes.choices[0]?.message;
-            const retryGuidance = retryMsg ? extractContent(retryMsg) : '';
-            if (retryGuidance.length > guidance.length) {
-                guidance = retryGuidance;
-            }
-        }
-        if (phaseLogger)
-            phaseLogger('powerpoint-create', 'enhancement', `Done (${guidance.length} chars)`);
-    }
-    catch (e) {
-        logger.warn('PPT enhancement failed, proceeding without', { error: String(e) });
-    }
-    const enhancedInstruction = guidance
-        ? `${instruction}\n\n═══ CREATIVE GUIDANCE ═══\n${guidance}\n═══ END GUIDANCE ═══`
-        : instruction;
+async function runDesignPhase(llmClient, instruction, phaseLogger) {
     if (phaseLogger)
-        phaseLogger('powerpoint-create', 'planning', 'Generating JSON plan...');
+        phaseLogger('powerpoint-create', 'design', 'Generating design system + slide plan...');
     let plan = null;
     try {
-        const planRes = await llmClient.chatCompletion({
+        const res = await llmClient.chatCompletion({
             messages: [
-                { role: 'system', content: PPT_STRUCTURED_PLANNING_PROMPT },
-                { role: 'user', content: enhancedInstruction },
+                { role: 'system', content: PPT_DESIGN_PROMPT },
+                { role: 'user', content: instruction },
             ],
-            temperature: 0.4,
+            temperature: 0.5,
             max_tokens: 8000,
         });
-        const planMsg = planRes.choices[0]?.message;
-        const finishReason = planRes.choices[0]?.finish_reason;
-        const rawPlan = planMsg ? extractContent(planMsg) : '';
+        const msg = res.choices[0]?.message;
+        const rawPlan = msg ? extractContent(msg) : '';
+        const finishReason = res.choices[0]?.finish_reason;
         if (finishReason === 'length') {
-            logger.warn('PPT planning response was truncated (finish_reason=length)');
+            logger.warn('PPT design response was truncated (finish_reason=length)');
         }
-        logger.debug('PPT planning raw response', { length: rawPlan.length, finishReason, first200: rawPlan.slice(0, 200) });
+        logger.debug('PPT design raw response', { length: rawPlan.length, finishReason, first200: rawPlan.slice(0, 200) });
         plan = rawPlan ? parseJsonPlan(rawPlan) : null;
         if (plan) {
             plan.design = normalizeDesign(plan.design);
@@ -727,13 +642,15 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
             if (validationError) {
                 logger.warn('PPT plan validation failed', { error: validationError });
                 if (phaseLogger)
-                    phaseLogger('powerpoint-create', 'planning', `Validation failed: ${validationError}. Retrying...`);
+                    phaseLogger('powerpoint-create', 'design', `Validation failed: ${validationError}. Retrying...`);
                 const retryRes = await llmClient.chatCompletion({
                     messages: [
-                        { role: 'system', content: PPT_STRUCTURED_PLANNING_PROMPT },
-                        { role: 'user', content: enhancedInstruction },
+                        { role: 'system', content: PPT_DESIGN_PROMPT },
+                        { role: 'user', content: instruction },
+                        { role: 'assistant', content: rawPlan },
+                        { role: 'user', content: `ERROR: ${validationError}\n\nFix the issues and output the corrected JSON. Remember: aim for 10-12 slides with REAL content data.` },
                     ],
-                    temperature: 0.2,
+                    temperature: 0.3,
                     max_tokens: 8000,
                 });
                 const retryMsg = retryRes.choices[0]?.message;
@@ -745,7 +662,7 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
                     if (!retryError) {
                         plan = retryPlan;
                         if (phaseLogger)
-                            phaseLogger('powerpoint-create', 'planning', `Retry succeeded (${plan.slides.length} slides)`);
+                            phaseLogger('powerpoint-create', 'design', `Retry succeeded (${plan.slides.length} slides)`);
                     }
                     else {
                         plan = null;
@@ -757,199 +674,187 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
             }
             else {
                 if (phaseLogger)
-                    phaseLogger('powerpoint-create', 'planning', `Done (${plan.slides.length} slides)`);
+                    phaseLogger('powerpoint-create', 'design', `Done (${plan.slides.length} slides, mood: ${plan.design.mood})`);
             }
         }
-        else {
-            logger.warn('PPT JSON plan parsing failed');
-            if (phaseLogger)
-                phaseLogger('powerpoint-create', 'planning', 'JSON parsing failed. Falling back.');
+    }
+    catch (e) {
+        logger.warn('PPT design failed', { error: String(e) });
+    }
+    return plan;
+}
+async function generateSingleSlideHtml(llmClient, slide, design, slideIndex, totalSlides, language) {
+    const cleanedDirection = (slide.content_direction || '').replace(/\s*Layout\s*:\s*[^\n]*/gi, '').trim();
+    const layoutType = extractLayoutHint(slide.content_direction || '');
+    const directPrompt = buildDirectHtmlPrompt(slide.title, cleanedDirection, design, slideIndex, totalSlides, language, layoutType);
+    try {
+        const res = await llmClient.chatCompletion({
+            messages: [
+                { role: 'system', content: directPrompt },
+                { role: 'user', content: 'Generate the HTML slide now.' },
+            ],
+            temperature: 0.4,
+            max_tokens: 6000,
+        });
+        const msg = res.choices[0]?.message;
+        const rawHtml = msg ? extractContent(msg) : '';
+        const html = extractHtml(rawHtml);
+        if (html) {
+            const validation = validateSlideHtml(html, layoutType);
+            if (validation.pass) {
+                return { html, isCodeTemplate: false };
+            }
+            logger.info(`Slide ${slideIndex + 1}: Direct HTML failed validation: ${validation.feedback}`);
         }
     }
     catch (e) {
-        logger.warn('PPT planning failed', { error: String(e) });
-        if (phaseLogger)
-            phaseLogger('powerpoint-create', 'planning', 'Planning error. Falling back.');
+        logger.warn(`Slide ${slideIndex + 1}: Direct HTML LLM call failed: ${e}`);
     }
-    if (!plan) {
-        logger.error('PPT planning failed after retries — cannot create presentation');
-        return {
-            success: false,
-            error: 'Failed to generate presentation plan. Please try again.',
-        };
+    logger.info(`Slide ${slideIndex + 1}: Falling back to code template "${layoutType}"`);
+    const jsonPrompt = buildContentFillJsonPrompt(slide.title, cleanedDirection, layoutType, language);
+    try {
+        const jsonRes = await llmClient.chatCompletion({
+            messages: [
+                { role: 'system', content: jsonPrompt },
+                { role: 'user', content: 'Output the JSON now.' },
+            ],
+            temperature: 0.3,
+            max_tokens: 2000,
+        });
+        const jsonMsg = jsonRes.choices[0]?.message;
+        const jsonRaw = jsonMsg ? extractContent(jsonMsg) : '';
+        let slideData = parseContentFillJson(jsonRaw, layoutType);
+        if (!slideData) {
+            const retryRes = await llmClient.chatCompletion({
+                messages: [
+                    { role: 'system', content: jsonPrompt },
+                    { role: 'user', content: 'Output ONLY valid JSON. No markdown fences, no explanation. Start with { and end with }.' },
+                ],
+                temperature: 0.2,
+                max_tokens: 2000,
+            });
+            const retryMsg = retryRes.choices[0]?.message;
+            const retryRaw = retryMsg ? extractContent(retryMsg) : '';
+            slideData = parseContentFillJson(retryRaw, layoutType);
+        }
+        if (slideData) {
+            const html = buildContentSlideHtml(design, slide.title, layoutType, slideData, slideIndex + 1, slideIndex);
+            return { html, isCodeTemplate: true };
+        }
     }
-    if (plan.slides.length > 15) {
-        logger.warn(`PPT plan has ${plan.slides.length} slides, capping to 15`);
-        const firstSlide = plan.slides[0];
-        const lastSlide = plan.slides[plan.slides.length - 1];
-        const contentSlides = plan.slides.slice(1, -1).slice(0, 13);
-        plan.slides = [firstSlide, ...contentSlides, lastSlide];
-        if (phaseLogger)
-            phaseLogger('powerpoint-create', 'planning', `Capped to ${plan.slides.length} slides`);
+    catch (e) {
+        logger.warn(`Slide ${slideIndex + 1}: Code template fallback failed: ${e}`);
     }
-    if (phaseLogger)
-        phaseLogger('powerpoint-create', 'execution', 'Starting HTML rendering pipeline...');
-    const { writePath: tempWritePath, winPath: tempWinPath } = getTempDir();
-    ensureTempDir(tempWritePath);
-    let savePath = explicitSavePath;
-    if (!savePath) {
-        const fullPathMatch = instruction.match(/([A-Za-z]:\\[^\s,]+\.pptx|\/[^\s,]+\.pptx)/i);
-        if (fullPathMatch) {
-            savePath = fullPathMatch[1];
+    return null;
+}
+async function generateAllHtml(llmClient, plan, companyName, titleSubtitle, kstDate, language, phaseLogger) {
+    const results = new Map();
+    for (let i = 0; i < plan.slides.length; i++) {
+        const slide = plan.slides[i];
+        if (slide.type === 'title') {
+            results.set(i, {
+                index: i,
+                html: buildTitleSlideHtml(plan.design, companyName, titleSubtitle, kstDate, i + 1),
+                isCodeTemplate: true,
+            });
         }
-        else {
-            const nameMatch = instruction.match(/([\w][\w\-_.]*\.pptx)/i);
-            if (nameMatch) {
-                savePath = `C:\\temp\\${nameMatch[1]}`;
+        else if (slide.type === 'closing') {
+            const closingTagline = (slide.content_direction || '').replace(/감사합니다|thank\s*you/gi, '').trim() || undefined;
+            results.set(i, {
+                index: i,
+                html: buildClosingSlideHtml(plan.design, companyName, i + 1, language, closingTagline),
+                isCodeTemplate: true,
+            });
+        }
+        else if (isOverviewSlide(slide.title, i)) {
+            const overviewItems = parseOverviewItems(slide.content_direction || '');
+            if (overviewItems.length >= 2) {
+                const firstLine = (slide.content_direction || '').split('\n')[0] || '';
+                const overviewSubtitle = /^\d/.test(firstLine.trim()) ? '' : firstLine.trim();
+                results.set(i, {
+                    index: i,
+                    html: buildOverviewSlideHtml(plan.design, slide.title, overviewSubtitle, overviewItems, i + 1),
+                    isCodeTemplate: true,
+                });
             }
         }
     }
-    const kstNow = new Date(Date.now() + 9 * 60 * 60 * 1000);
-    const kstDate = `${kstNow.getUTCFullYear()}년 ${kstNow.getUTCMonth() + 1}월`;
-    const titleSlidePlan = plan.slides.find(s => s.type === 'title');
-    const rawTitleText = titleSlidePlan?.title || '';
-    const titleSeps = [' - ', ' – ', ' — ', ': ', ' | '];
-    let companyName = rawTitleText;
-    let titleSubtitle = '';
-    for (const sep of titleSeps) {
-        const idx = rawTitleText.indexOf(sep);
-        if (idx > 0) {
-            companyName = rawTitleText.slice(0, idx).trim();
-            titleSubtitle = rawTitleText.slice(idx + sep.length).trim();
-            break;
+    const contentIndices = plan.slides
+        .map((s, i) => ({ slide: s, index: i }))
+        .filter(({ index }) => !results.has(index));
+    if (phaseLogger)
+        phaseLogger('powerpoint-create', 'html-generation', `Generating ${contentIndices.length} content slides in parallel (batch size ${MAX_CONCURRENT})...`);
+    for (let batch = 0; batch < contentIndices.length; batch += MAX_CONCURRENT) {
+        const chunk = contentIndices.slice(batch, batch + MAX_CONCURRENT);
+        const promises = chunk.map(({ slide, index }) => generateSingleSlideHtml(llmClient, slide, plan.design, index, plan.slides.length, language)
+            .then(result => ({ index, result }))
+            .catch(err => {
+            logger.warn(`Slide ${index + 1}: Generation error: ${err}`);
+            return { index, result: null };
+        }));
+        const chunkResults = await Promise.all(promises);
+        for (const { index, result } of chunkResults) {
+            if (result) {
+                results.set(index, { index, html: result.html, isCodeTemplate: result.isCodeTemplate });
+            }
         }
+        const done = Math.min(batch + MAX_CONCURRENT, contentIndices.length);
+        if (phaseLogger)
+            phaseLogger('powerpoint-create', 'html-generation', `Generated ${done}/${contentIndices.length} content slides`);
     }
-    if (!titleSubtitle && titleSlidePlan) {
-        titleSubtitle = ((titleSlidePlan.content_direction || '').split('\n')[0] || '').trim().slice(0, 120);
+    return results;
+}
+async function validateAndRegenerate(llmClient, htmlResults, plan, language, phaseLogger) {
+    const failedIndices = [];
+    for (const [index, result] of htmlResults) {
+        const slide = plan.slides[index];
+        if (slide.type === 'title' || slide.type === 'closing')
+            continue;
+        const layoutType = extractLayoutHint(slide.content_direction || '');
+        const validation = validateSlideHtml(result.html, layoutType);
+        if (!validation.pass) {
+            logger.info(`Slide ${index + 1}: Post-validation failed: ${validation.feedback}`);
+            failedIndices.push(index);
+        }
     }
-    if (/로고|슬로건|연락처|contact|logo|placeholder/i.test(titleSubtitle)) {
-        titleSubtitle = '';
+    if (failedIndices.length === 0) {
+        if (phaseLogger)
+            phaseLogger('powerpoint-create', 'validation', 'All slides passed validation');
+        return htmlResults;
     }
-    const createResult = await powerpointClient.powerpointCreate();
-    totalToolCalls++;
-    if (toolCallLogger)
-        toolCallLogger('powerpoint-create', 'powerpoint_create', {}, createResult.success ? 'Created' : createResult['error'] || '', createResult.success, 0, totalToolCalls);
-    if (!createResult.success) {
-        return { success: false, error: `Failed to create presentation: ${createResult['error']}` };
+    if (phaseLogger)
+        phaseLogger('powerpoint-create', 'validation', `${failedIndices.length} slides failed validation, regenerating...`);
+    for (const index of failedIndices) {
+        const slide = plan.slides[index];
+        const original = htmlResults.get(index);
+        const result = await generateSingleSlideHtml(llmClient, slide, plan.design, index, plan.slides.length, language);
+        if (result) {
+            const regenHasPlaceholder = hasPlaceholderText(result.html);
+            const origHasPlaceholder = hasPlaceholderText(original.html);
+            if (!regenHasPlaceholder || origHasPlaceholder) {
+                htmlResults.set(index, { index, html: result.html, isCodeTemplate: result.isCodeTemplate });
+            }
+        }
     }
+    return htmlResults;
+}
+async function assemblePresentation(htmlResults, plan, timestamp, savePath, phaseLogger, toolCallLogger) {
+    const { writePath: tempWritePath, winPath: tempWinPath } = getTempDir();
+    ensureTempDir(tempWritePath);
     const builtSlides = [];
     let failCount = 0;
+    let totalToolCalls = 0;
     const tempFiles = [];
-    for (let i = 0; i < plan.slides.length; i++) {
-        const slidePlan = plan.slides[i];
-        const slideNum = i + 1;
+    const sortedEntries = [...htmlResults.entries()].sort((a, b) => a[0] - b[0]);
+    for (const [index, result] of sortedEntries) {
+        const slidePlan = plan.slides[index];
+        const slideNum = builtSlides.length + 1;
         if (failCount >= 3) {
             logger.warn('Too many slide failures, stopping');
             break;
         }
         if (phaseLogger)
-            phaseLogger('powerpoint-create', 'execution', `Rendering slide ${slideNum}/${plan.slides.length}: ${slidePlan.title}`);
-        let html = null;
-        let htmlPrompt = null;
-        if (slidePlan.type === 'title') {
-            html = buildTitleSlideHtml(plan.design, companyName, titleSubtitle, kstDate, slideNum);
-        }
-        else if (slidePlan.type === 'closing') {
-            html = buildClosingSlideHtml(plan.design, companyName, slideNum, language);
-        }
-        else if (isOverviewSlide(slidePlan.title, i)) {
-            const overviewItems = parseOverviewItems(slidePlan.content_direction || '');
-            if (overviewItems.length >= 2) {
-                const firstLine = (slidePlan.content_direction || '').split('\n')[0] || '';
-                const overviewSubtitle = /^\d/.test(firstLine.trim()) ? '' : firstLine.trim();
-                html = buildOverviewSlideHtml(plan.design, slidePlan.title, overviewSubtitle, overviewItems, slideNum);
-                logger.info(`Slide ${slideNum}: Using code-generated overview template (${overviewItems.length} items)`);
-            }
-        }
-        if (!html && slidePlan.type !== 'title' && slidePlan.type !== 'closing') {
-            htmlPrompt = buildSlideHtmlPrompt(slidePlan.title, slidePlan.content_direction || '', plan.design, i, plan.slides.length, language);
-            try {
-                const htmlRes = await llmClient.chatCompletion({
-                    messages: [
-                        { role: 'system', content: htmlPrompt },
-                        { role: 'user', content: 'Generate the HTML slide now.' },
-                    ],
-                    temperature: 0.3,
-                    max_tokens: 8000,
-                });
-                const htmlMsg = htmlRes.choices[0]?.message;
-                const rawHtml = htmlMsg ? extractContent(htmlMsg) : '';
-                html = extractHtml(rawHtml);
-                if (!html && rawHtml.length > 100) {
-                    logger.warn(`Slide ${slideNum}: HTML extraction failed, retrying`);
-                    const retryRes = await llmClient.chatCompletion({
-                        messages: [
-                            { role: 'system', content: htmlPrompt },
-                            { role: 'user', content: 'Generate the complete HTML document. Start with <!DOCTYPE html> and end with </html>. No markdown fences.' },
-                        ],
-                        temperature: 0.2,
-                        max_tokens: 4000,
-                    });
-                    const retryMsg = retryRes.choices[0]?.message;
-                    const retryRaw = retryMsg ? extractContent(retryMsg) : '';
-                    html = extractHtml(retryRaw);
-                }
-            }
-            catch (e) {
-                logger.warn(`Slide ${slideNum}: LLM call failed: ${e}`);
-            }
-        }
-        if (!html) {
-            logger.warn(`Slide ${slideNum}: Failed to generate HTML, skipping`);
-            failCount++;
-            continue;
-        }
-        if (htmlPrompt) {
-            const MAX_REGEN_ATTEMPTS = 5;
-            for (let attempt = 0; attempt < MAX_REGEN_ATTEMPTS; attempt++) {
-                const measureFileName = `hanseol_measure_${slideNum}_${timestamp}_${attempt}.html`;
-                const measureWritePath = path.join(tempWritePath, measureFileName);
-                const measureWinPath = `${tempWinPath}\\${measureFileName}`;
-                try {
-                    fs.writeFileSync(measureWritePath, injectMeasureCss(html), 'utf-8');
-                    const contentHeight = await powerpointClient.measureHtmlHeight(measureWinPath);
-                    try {
-                        fs.unlinkSync(measureWritePath);
-                    }
-                    catch { }
-                    if (contentHeight <= 1050) {
-                        if (attempt > 0)
-                            logger.info(`Slide ${slideNum}: Fits after ${attempt} regeneration(s) (${contentHeight}px)`);
-                        break;
-                    }
-                    logger.warn(`Slide ${slideNum}: Content overflows (${contentHeight}px > 1050), attempt ${attempt + 1}/${MAX_REGEN_ATTEMPTS}`);
-                    if (phaseLogger)
-                        phaseLogger('powerpoint-create', 'execution', `Slide ${slideNum}: overflow (${contentHeight}px), regen ${attempt + 1}/${MAX_REGEN_ATTEMPTS}...`);
-                    try {
-                        const regenRes = await llmClient.chatCompletion({
-                            messages: [
-                                { role: 'system', content: htmlPrompt },
-                                { role: 'user', content: `Generate the HTML slide now. CRITICAL: Your previous version was ${contentHeight}px tall but the slide is only 1080px. Content was CLIPPED at the bottom.\n\nYou MUST:\n- Use FEWER items (max 3 cards, max 3 rows, max 3 metrics)\n- SHORTER text per item (1-2 lines max)\n- SIMPLER layout with generous padding\n- body padding: 60px 80px minimum\n- Do NOT exceed 3 content blocks total\n\nThis is attempt ${attempt + 1}. ${attempt >= 2 ? 'DRASTICALLY simplify — use only 2 main items with large text.' : ''}` },
-                            ],
-                            temperature: 0.2,
-                            max_tokens: 8000,
-                        });
-                        const regenMsg = regenRes.choices[0]?.message;
-                        const regenRaw = regenMsg ? extractContent(regenMsg) : '';
-                        const regenHtml = extractHtml(regenRaw);
-                        if (regenHtml) {
-                            html = regenHtml;
-                            logger.info(`Slide ${slideNum}: Regenerated HTML (attempt ${attempt + 1})`);
-                        }
-                        else {
-                            break;
-                        }
-                    }
-                    catch (e) {
-                        logger.warn(`Slide ${slideNum}: Overflow regeneration attempt ${attempt + 1} failed: ${e}`);
-                        break;
-                    }
-                }
-                catch {
-                    break;
-                }
-            }
-        }
+            phaseLogger('powerpoint-create', 'assembly', `Rendering slide ${slideNum}: ${slidePlan.title}`);
         const htmlFileName = `hanseol_slide_${slideNum}_${timestamp}.html`;
         const pngFileName = `hanseol_slide_${slideNum}_${timestamp}.png`;
         const htmlWritePath = path.join(tempWritePath, htmlFileName);
@@ -957,7 +862,10 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
         const htmlWinPath = `${tempWinPath}\\${htmlFileName}`;
         const pngWinPath = `${tempWinPath}\\${pngFileName}`;
         try {
-            const processed = injectTitleContrastFix(ensureSafeBodyPadding(removeAbsolutePositioning(enforceMinFontSize(injectViewportCss(html, plan.design.background_color)))), plan.design.text_color);
+            const viewportHtml = result.isCodeTemplate
+                ? injectEdgeSizing(result.html, plan.design.background_color)
+                : injectViewportCss(result.html, plan.design.background_color);
+            const processed = injectTitleContrastFix(viewportHtml, plan.design.text_color);
             fs.writeFileSync(htmlWritePath, processed, 'utf-8');
             tempFiles.push(htmlWritePath);
         }
@@ -990,6 +898,10 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
                 renderSuccess = false;
             }
         }
+        try {
+            fs.unlinkSync(htmlWritePath);
+        }
+        catch { }
         if (!renderSuccess) {
             logger.warn(`Slide ${slideNum}: Screenshot rendering failed, skipping`);
             failCount++;
@@ -1023,7 +935,7 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
         if (bgResult.success) {
             builtSlides.push(`Slide ${slideNum}: ${slidePlan.title} (${slidePlan.type})`);
             try {
-                await powerpointClient.powerpointAddNote(slideNum, html);
+                await powerpointClient.powerpointAddNote(slideNum, result.html);
             }
             catch { }
         }
@@ -1037,7 +949,6 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
             const slideCountResult = await powerpointClient.powerpointGetSlideCount();
             const totalSlidesInPpt = slideCountResult['slide_count'] || 0;
             if (totalSlidesInPpt > builtSlides.length) {
-                logger.warn(`PPT has ${totalSlidesInPpt} slides but only ${builtSlides.length} were rendered — deleting ${totalSlidesInPpt - builtSlides.length} trailing blanks`);
                 for (let d = totalSlidesInPpt; d > builtSlides.length; d--) {
                     await powerpointClient.powerpointDeleteSlide(d);
                     totalToolCalls++;
@@ -1049,6 +960,13 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
         }
     }
     if (builtSlides.length > 0) {
+        if (savePath) {
+            const wslSavePath = savePath.replace(/\\/g, '/').replace(/^([A-Za-z]):/, (_m, d) => `/mnt/${d.toLowerCase()}`);
+            try {
+                fs.unlinkSync(wslSavePath);
+            }
+            catch { }
+        }
         let saveResult = await powerpointClient.powerpointSave(savePath);
         totalToolCalls++;
         if (toolCallLogger)
@@ -1057,8 +975,6 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
             const fallbackPath = 'C:\\temp\\presentation.pptx';
             saveResult = await powerpointClient.powerpointSave(fallbackPath);
             totalToolCalls++;
-            if (toolCallLogger)
-                toolCallLogger('powerpoint-create', 'powerpoint_save', { path: fallbackPath }, saveResult.success ? (saveResult['path'] || 'OK') : (saveResult.error || 'Failed'), saveResult.success, 0, totalToolCalls);
         }
     }
     for (const tempFile of tempFiles) {
@@ -1067,9 +983,117 @@ async function runStructured(llmClient, instruction, explicitSavePath) {
         }
         catch { }
     }
+    return { builtSlides, totalToolCalls };
+}
+async function runStructured(llmClient, instruction, explicitSavePath) {
+    const startTime = Date.now();
+    const phaseLogger = getSubAgentPhaseLogger();
+    const toolCallLogger = getSubAgentToolCallLogger();
+    const timestamp = Date.now();
+    logger.enter('PPT-Create.runStructured.v2');
+    const hasKorean = /[\uac00-\ud7af\u1100-\u11ff]/.test(instruction);
+    const language = hasKorean ? 'ko' : 'en';
+    if (phaseLogger)
+        phaseLogger('powerpoint-create', 'init', 'Starting Design phase + opening PowerPoint...');
+    const [plan, createResult] = await Promise.all([
+        runDesignPhase(llmClient, instruction, phaseLogger),
+        powerpointClient.powerpointCreate(),
+    ]);
+    if (!createResult.success) {
+        return { success: false, error: `Failed to create presentation: ${createResult['error']}` };
+    }
+    if (!plan) {
+        logger.error('PPT planning failed after retries — cannot create presentation');
+        return { success: false, error: 'Failed to generate presentation plan. Please try again.' };
+    }
+    if (plan.slides.length > 20) {
+        const firstSlide = plan.slides[0];
+        const lastSlide = plan.slides[plan.slides.length - 1];
+        const contentSlides = plan.slides.slice(1, -1).slice(0, 18);
+        plan.slides = [firstSlide, ...contentSlides, lastSlide];
+    }
+    const userYearMatch = instruction.match(/(\d{4})년/);
+    if (userYearMatch) {
+        const userYear = userYearMatch[1];
+        for (const slide of plan.slides) {
+            if (slide.type === 'content' && slide.content_direction) {
+                if (!slide.content_direction.includes(`${userYear}년`)) {
+                    slide.content_direction += ` (Note: This report covers ${userYear}년 data.)`;
+                }
+            }
+        }
+    }
+    let savePath = explicitSavePath;
+    if (!savePath) {
+        const fullPathMatch = instruction.match(/([A-Za-z]:\\[^\s,]+\.pptx|\/[^\s,]+\.pptx)/i);
+        if (fullPathMatch) {
+            savePath = fullPathMatch[1];
+        }
+        else {
+            const nameMatch = instruction.match(/([\w][\w\-_.]*\.pptx)/i);
+            if (nameMatch) {
+                savePath = `C:\\temp\\${nameMatch[1]}`;
+            }
+        }
+    }
+    const titleSlidePlanForDate = plan.slides.find(s => s.type === 'title');
+    const dateSearchTexts = [instruction, titleSlidePlanForDate?.title || '', titleSlidePlanForDate?.content_direction || ''];
+    let kstDate = '';
+    for (const text of dateSearchTexts) {
+        const dateMatch = text.match(/(\d{4})년\s*(\d{1,2})\s*(월|분기)/);
+        if (dateMatch) {
+            kstDate = `${dateMatch[1]}년 ${dateMatch[2]}${dateMatch[3]}`;
+            break;
+        }
+    }
+    if (!kstDate) {
+        const kstNow = new Date(Date.now() + 9 * 60 * 60 * 1000);
+        kstDate = `${kstNow.getUTCFullYear()}년 ${kstNow.getUTCMonth() + 1}월`;
+    }
+    const titleSlidePlan = plan.slides.find(s => s.type === 'title');
+    const rawTitleText = titleSlidePlan?.title || '';
+    const titleSeps = [' - ', ' – ', ' — ', ': ', ' | '];
+    let companyName = rawTitleText;
+    let titleSubtitle = '';
+    for (const sep of titleSeps) {
+        const idx = rawTitleText.indexOf(sep);
+        if (idx > 0) {
+            companyName = rawTitleText.slice(0, idx).trim();
+            titleSubtitle = rawTitleText.slice(idx + sep.length).trim();
+            break;
+        }
+    }
+    if (!titleSubtitle && titleSlidePlan) {
+        titleSubtitle = ((titleSlidePlan.content_direction || '').split('\n')[0] || '').trim().slice(0, 120);
+    }
+    if (/로고|슬로건|연락처|contact|logo|placeholder/i.test(titleSubtitle)) {
+        titleSubtitle = '';
+    }
+    const companyMatch = instruction.match(/회사명\s*[:：]\s*([^\s,，、]+)/);
+    if (companyMatch && companyMatch[1]) {
+        const companyName_ = companyMatch[1];
+        if (titleSlidePlan && titleSlidePlan.title.trim() !== companyName_) {
+            const originalTitle = titleSlidePlan.title;
+            titleSlidePlan.title = companyName_;
+            companyName = companyName_;
+            if (!titleSlidePlan.content_direction?.includes(originalTitle)) {
+                const stripped = originalTitle.replace(companyName_, '').replace(/^\s*[-–—:|\s]+/, '').trim();
+                titleSubtitle = stripped || originalTitle;
+                titleSlidePlan.content_direction = titleSubtitle + (titleSlidePlan.content_direction ? '\n' + titleSlidePlan.content_direction : '');
+            }
+        }
+    }
+    if (phaseLogger)
+        phaseLogger('powerpoint-create', 'html-generation', 'Starting parallel HTML generation...');
+    const htmlResults = await generateAllHtml(llmClient, plan, companyName, titleSubtitle, kstDate, language, phaseLogger);
+    const validatedResults = await validateAndRegenerate(llmClient, htmlResults, plan, language, phaseLogger);
+    if (phaseLogger)
+        phaseLogger('powerpoint-create', 'assembly', `Assembling ${validatedResults.size} slides into PowerPoint...`);
+    const { builtSlides, totalToolCalls } = await assemblePresentation(validatedResults, plan, timestamp, savePath, phaseLogger, toolCallLogger);
     const duration = Date.now() - startTime;
-    const summary = `Presentation created with ${builtSlides.length} slides (HTML rendering, ${plan.design.mood}):\n${builtSlides.join('\n')}`;
-    logger.exit('PPT-Create.runStructured', { slideCount: builtSlides.length, totalToolCalls, duration });
+    const slideList = builtSlides.join('\n');
+    const summary = `Presentation COMPLETE — ${builtSlides.length} slides created and saved successfully.\nAll requested topics are covered across these slides. Do NOT add more slides or call powerpoint_modify_agent.\n\nSlides:\n${slideList}`;
+    logger.exit('PPT-Create.runStructured.v2', { slideCount: builtSlides.length, totalToolCalls, duration });
     return {
         success: builtSlides.length > 0,
         result: summary,