sns-auto-builder 1.0.0 → 1.0.1

package/index.html

@@ -194,6 +194,9 @@ button.go:focus-visible, button.quiet:focus-visible, .copy:focus-visible { outli
   border:1px solid var(--rule); border-radius:7px; background:transparent; color:var(--ink-2);
 }
 .out-row .acts a:hover, .out-row .acts button:hover { color:var(--accent); border-color:var(--accent); }
+.refnow { font-size:13.5px; color:var(--ink-2); margin:-4px 0 12px; }
+.linkbtn { font:inherit; font-size:13.5px; background:none; border:0; padding:0; cursor:pointer;
+           color:var(--accent); text-decoration:underline; }
 .outs .empty { color:var(--ink-2); font-size:14.5px; padding:8px 2px; }
 
 /* ── 참고자료 템플릿 ───────────────────────── */
@@ -350,6 +353,8 @@ button.go:focus-visible, button.quiet:focus-visible, .copy:focus-visible { outli
     </div>
     <div class="bar">
       <button class="quiet" id="brandOpen">⚙ 브랜드 컨셉 설정</button>
+      <a class="quiet dl" id="logDl" href="/logs" download
+         title="문제가 생기면 이 파일을 담당자에게 보내세요">🛟 문제 신고용 로그</a>
       <span class="fine" id="brandNow"></span>
     </div>
   </section>
@@ -447,6 +452,9 @@ button.go:focus-visible, button.quiet:focus-visible, .copy:focus-visible { outli
     </div>
 
     <label for="pick-file" id="refLabel">참고 자료 <span class="fine">선택 · 최대 6장</span></label>
+    <!-- 템플릿 선택은 화면을 옮겨도 유지된다. 안 보이면 "레퍼런스를 지웠다"고 착각하고
+         이전 참고자료가 그대로 들어간 결과물을 받게 된다. 여기서 항상 보이게 한다. -->
+    <p class="refnow" id="refNow" hidden></p>
     <div class="drop" id="drop" tabindex="0" role="button"
          aria-describedby="refHint" aria-label="참고 이미지 추가. 끌어다 놓거나 붙여넣거나 눌러서 고르세요">
       <p class="fine" id="refHint">끌어다 놓거나, <kbd>⌘/Ctrl + V</kbd>로 붙여넣거나, 눌러서 고르세요</p>
@@ -470,7 +478,13 @@ button.go:focus-visible, button.quiet:focus-visible, .copy:focus-visible { outli
     </div>
     <ol class="steps" id="steps" hidden aria-label="진행 단계"></ol>
     <div class="live" id="live" aria-live="polite" aria-busy="true"></div>
-    <div class="bar"><button class="quiet" id="stop">중단</button></div>
+    <div class="bar">
+      <button class="quiet" id="stop">중단</button>
+      <span id="runFail" hidden>
+        <button class="go" id="retry">다시 시도</button>
+        <button class="quiet" id="backToPlan">시나리오로</button>
+      </span>
+    </div>
   </section>
 
   <!-- 3.5 시나리오 확인 — 이미지에 시간·쿼터를 쓰기 전에 사람이 승인한다 -->
@@ -570,7 +584,7 @@ document.querySelectorAll('[data-engine]').forEach((b) => b.onclick = () => {
   engine = b.dataset.engine;
   toForm();
 });
-$('engineBack').onclick = () => show('pick');
+$('engineBack').onclick = () => { refs = []; refSet = null; renderThumbs(); show('pick'); };
 
 function renderSteps(active, status) {
   const host = $('steps');
@@ -790,6 +804,30 @@ async function addFiles(list) {
   renderThumbs();
 }
 
+// 지금 무엇이 참고자료로 들어가는지 한 줄로 못박아 보여준다.
+function renderRefNow(sets) {
+  const box = $('refNow');
+  box.textContent = '';
+  if (refSet) {
+    const s = (sets || []).find((x) => x.id === refSet);
+    const n = s ? s.files.length : '';
+    box.append(document.createTextNode(`저장된 템플릿 ${n}장이 이번 작업에 들어갑니다 · `));
+    const off = document.createElement('button');
+    off.type = 'button';
+    off.className = 'linkbtn';
+    off.textContent = '쓰지 않기';
+    off.onclick = () => { refSet = null; loadTemplates(); };
+    box.append(off);
+    box.hidden = false;
+  } else if (refs.length) {
+    box.textContent = `올린 이미지 ${refs.length}장이 이번 작업에 들어갑니다`;
+    box.hidden = false;
+  } else {
+    box.textContent = '참고자료 없이 만듭니다';
+    box.hidden = false;
+  }
+}
+
 function renderThumbs() {
   const host = $('thumbs');
   loadTemplates(); // 업로드/삭제로 refSet 이 풀렸을 수 있어 템플릿 강조를 다시 맞춘다
@@ -946,6 +984,7 @@ async function build() {
   if (!plan?.dir) return;
   raw = '';
   result = null;
+  $('runFail').hidden = true;
   $('live').textContent = '';
   $('steps').textContent = '';
   renderSteps();
@@ -968,9 +1007,12 @@ async function build() {
     runReview(plan.dir); // 결과를 먼저 띄우고 채점은 뒤에서 — 기다리게 하지 않는다
   } catch (e) {
     if (e.name === 'AbortError') { renderPlan(plan); return; }
-    $('err').textContent = e.message;
-    $('err').hidden = false;
-    show('form');
+    // 실패했다고 주제 입력 화면으로 되돌리면 안 된다. 사용자 눈에는
+    // "처음으로 돌아가서 새로 시작됐다" 로 보이고, 원인이 적힌 로그도 같이 사라진다.
+    // 실행 화면에 남겨 로그를 보여주고, 시나리오로 돌아가 재시도할 수 있게 한다.
+    $('runNote').textContent = `실패: ${e.message}`;
+    $('runFail').hidden = false;
+    show('run');
   } finally {
     clearInterval(tick);
     ctrl = null;
@@ -1028,6 +1070,7 @@ async function loadTemplates() {
 }
 
 function renderTemplates(sets) {
+  renderRefNow(sets);
   const host = $('tpls');
   host.textContent = '';
   $('tplBox').hidden = !sets.length;
@@ -1336,12 +1379,14 @@ loadBrand();
 
 $('go').onclick = generate;
 $('approve').onclick = build;
+$('retry').onclick = build;
+$('backToPlan').onclick = () => { $('runFail').hidden = true; renderPlan(plan); };
 $('redo').onclick = () => show('form');   // 장수를 바꿔 리서치부터 다시
 $('planCancel').onclick = () => show('pick');
 $('back').onclick = () => show('pick');
 $('again').onclick = () => show('form');
 $('back').onclick = () => show(mode === 'cardnews' ? 'engine' : 'pick');
-$('reset').onclick = () => show('pick');
+$('reset').onclick = () => { refs = []; refSet = null; renderThumbs(); show('pick'); };
 $('stop').onclick = () => ctrl?.abort();
 $('copyAll').onclick = (e) => copy(clean, e.currentTarget);
 $('topic').onkeydown = (e) => { if (e.key === 'Enter' && (e.metaKey || e.ctrlKey)) generate(); };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sns-auto-builder",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "인스타 카드뉴스 자동 제작 빌더. Claude Code + ChatGPT 웹을 그대로 써서 API 키 없이 돌아갑니다.",
   "type": "module",
   "bin": {

package/scripts/chatgpt-image-gen.js

@@ -125,14 +125,40 @@ async function waitForComposer(page) {
   // 로그인이 풀렸으면 여기서 프롬프트 창이 안 뜬다 — 위 waitForSelector 가 던진다.
 }
 
+// 레퍼런스 첨부. **실패하면 던진다.**
+//
+// 예전에는 썸네일 확인이 실패해도 경고만 찍고 그냥 보냈다. 그러면 레퍼런스 없이 만들어진
+// 결과물이 정상인 것처럼 나와서, 사용자는 "왜 레퍼런스가 반영이 안 되지" 로만 알게 된다.
+// 조용히 틀리느니 시끄럽게 멈추는 게 낫다.
 async function attachRef(page, refPaths) {
-  const input = await page.waitForSelector('input[type="file"]', { timeout: 30_000 });
-  await input.uploadFile(...refPaths); // 여러 장을 한 번에 올린다
-  // 업로드가 끝나기 전에 Enter 를 치면 첨부 없이 전송된다. 썸네일이 붙을 때까지 기다린다.
-  await page.waitForFunction(
-    () => !!document.querySelector('form img, form [data-testid*="attachment"]'),
-    { timeout: 120_000 },
-  ).catch(() => console.warn('  (경고) 첨부 썸네일을 확인하지 못했습니다. 그대로 진행합니다.'));
+  const want = refPaths.length;
+  // 파일 입력이 여러 개다. 컴포저(form) 안에 있는 것이 첨부용이다.
+  const pickInput = async () => {
+    const handles = await page.$$('input[type="file"]');
+    for (const h of handles) {
+      if (await h.evaluate((el) => !!el.closest('form'))) return h;
+    }
+    return handles[0] || null;
+  };
+
+  for (let attempt = 1; attempt <= 2; attempt++) {
+    const input = await pickInput();
+    if (!input) throw new Error('첨부용 파일 입력을 찾지 못했습니다 (ChatGPT 화면 구조가 바뀌었을 수 있음)');
+    await input.uploadFile(...refPaths);
+
+    // 한 장만 붙어도 통과시키면 안 된다. **올린 개수만큼** 붙을 때까지 기다린다.
+    const ok = await page
+      .waitForFunction((n) => document.querySelectorAll('form img').length >= n, { timeout: 60_000 }, want)
+      .then(() => true).catch(() => false);
+    if (ok) {
+      console.log(`  레퍼런스 ${want}장 첨부 확인`);
+      return;
+    }
+    const got = await page.evaluate(() => document.querySelectorAll('form img').length);
+    console.warn(`  (재시도 ${attempt}/2) 첨부가 ${got}/${want}장만 확인됨`);
+    await new Promise((r) => setTimeout(r, 3000));
+  }
+  throw new Error(`레퍼런스 ${want}장을 첨부하지 못했습니다. 레퍼런스 없이 만들면 디자인이 달라지므로 중단합니다.`);
 }
 
 async function sendPrompt(page, text) {
@@ -150,11 +176,37 @@ async function sendPrompt(page, text) {
 // 여러 장이 나왔으면 경고를 남긴다 — 프롬프트가 다장 생성을 유도했다는 신호다.
 const SETTLE_MS = 12_000; // 개수가 이만큼 안 늘면 그 턴은 끝난 것으로 본다
 
+// ChatGPT 가 생성에 실패하면 본문에 영어 안내가 뜨고 이미지는 안 나온다.
+// 그걸 못 읽으면 우리는 타임아웃까지 5분을 그냥 기다린 뒤 "안 나옴" 이라고만 말하게 된다.
+// 실제 문구를 그대로 사용자에게 전달해야 원인 파악이 된다.
+const CHATGPT_ERRORS = [
+  'Something went wrong while generating',
+  'I was unable to generate',
+  "I can't generate",
+  'content policy',
+  'rate limit',
+  'try again later',
+];
+const readPageError = (page) => page.evaluate((needles) => {
+  const main = document.querySelector('main');
+  const t = main ? main.innerText : '';
+  const tail = t.slice(-1500);
+  const hit = needles.find((n) => tail.toLowerCase().includes(n.toLowerCase()));
+  if (!hit) return null;
+  const line = tail.split('\n').reverse().find((l) => l.toLowerCase().includes(hit.toLowerCase()));
+  return (line || hit).trim().slice(0, 200);
+}, CHATGPT_ERRORS);
+
 async function waitForNewImage(page, before, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
   let fresh = [], lastChange = 0;
   while (Date.now() < deadline) {
     const now = (await fileIds(page)).filter((id) => !before.includes(id));
+    if (!now.length) {
+      // 이미지가 아직 없을 때만 본다. 이미 나왔으면 옛 대화의 문구를 오탐할 수 있다.
+      const err = await readPageError(page);
+      if (err) throw new Error(`ChatGPT 가 생성을 거부했습니다: ${err}`);
+    }
     if (now.length !== fresh.length) { fresh = now; lastChange = Date.now(); }
     else if (fresh.length && Date.now() - lastChange >= SETTLE_MS) {
       if (fresh.length > 1) {

package/server.mjs

@@ -4,7 +4,7 @@
 // 파이프라인 로직을 여기 복제하지 말 것 — CLAUDE.md 가 단일 출처다.
 import { createServer } from 'node:http';
 import { spawn } from 'node:child_process';
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { readFileSync, writeFileSync, appendFileSync, mkdirSync, existsSync, readdirSync, rmSync, statSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { relative, join, extname, sep } from 'node:path';
 
@@ -35,6 +35,28 @@ export function buildPrompt(mode, topic, refPaths = []) {
   ].join('\n\n---\n\n');
 }
 
+// ── 로그 ────────────────────────────────────────────────────────
+// 다른 PC 에서 난 문제를 여기서 볼 방법이 없으면 재현에만 매달리게 된다.
+// 실행 기록과 오류를 파일로 남겨, 사용자가 그 파일만 보내주면 분석할 수 있게 한다.
+// 개인정보가 섞이지 않도록 주제·경로 같은 작업 정보만 남기고 토큰·쿠키는 절대 안 쓴다.
+const LOG_DIR = new URL('./logs/', import.meta.url);
+const LOG_FILE = new URL('./logs/app.log', import.meta.url);
+const MAX_LOG = 2 * 1024 * 1024; // 2MB 넘으면 한 번 갈아끼운다 (무한정 커지면 보내기도 어렵다)
+
+export function log(...parts) {
+  const line = `[${new Date().toISOString()}] ${parts.map((p) =>
+    typeof p === 'string' ? p : JSON.stringify(p)).join(' ')}\n`;
+  try {
+    mkdirSync(LOG_DIR, { recursive: true });
+    try {
+      if (statSync(LOG_FILE).size > MAX_LOG) writeFileSync(new URL('./logs/app.prev.log', import.meta.url), readFileSync(LOG_FILE));
+      // 위에서 갈아끼웠으면 새로 시작
+      if (statSync(LOG_FILE).size > MAX_LOG) writeFileSync(LOG_FILE, '');
+    } catch { /* 파일이 아직 없으면 그냥 새로 만든다 */ }
+    appendFileSync(LOG_FILE, line);
+  } catch { /* 로그 실패가 기능을 막으면 안 된다 */ }
+}
+
 // ── 브랜드 설정 ─────────────────────────────────────────────────
 // 화면과 brand-facts.md 가 같은 스키마를 본다. 항목을 늘리려면 brand.schema.json 만 고치면 된다.
 // 값은 brand.json 에 저장하고, brand-facts.md 는 거기서 **생성**한다.
@@ -578,7 +600,7 @@ function run(prompt, tools, res, onLine, timeoutMs, onFinish) {
 
   p.stdout.setEncoding('utf8');
   p.stderr.setEncoding('utf8');
-  p.stderr.on('data', (d) => (err += d));
+  p.stderr.on('data', (d) => { err += d; log('stderr', String(d).slice(0, 500)); });
   p.stdout.on('data', (chunk) => {
     buf += chunk;
     const lines = buf.split('\n');
@@ -600,7 +622,8 @@ function run(prompt, tools, res, onLine, timeoutMs, onFinish) {
   p.on('error', (e) => (stop(), send({ error: e.message }), res.end()));
   p.on('close', (code) => {
     stop();
-    if (!got) send({ error: err.trim() || `claude 종료 코드 ${code}` });
+    if (!got) { log('pipeline 실패', { code, err: err.trim().slice(0, 800) }); send({ error: err.trim() || `claude 종료 코드 ${code}` }); }
+    else log('pipeline 종료', { code });
     onFinish?.(send); // 결과는 반드시 done/res.end() **전에** 흘린다
     send({ done: true });
     res.end();
@@ -622,12 +645,35 @@ const MIME = { '.png': 'image/png', '.jpg': 'image/jpeg', '.webp': 'image/webp',
 const server = createServer(async (req, res) => {
   const json = (code, obj) => res.writeHead(code, { 'content-type': 'application/json; charset=utf-8' }).end(JSON.stringify(obj));
   try {
+    // 문제 분석용 로그 내려받기. 사용자가 이 파일만 보내주면 원인을 볼 수 있다.
+    if (req.method === 'GET' && req.url.split('?')[0] === '/logs') {
+      const parts = [`# sns-auto-builder 로그`, `생성: ${new Date().toISOString()}`, ''];
+      try {
+        const pkg = JSON.parse(readFileSync(new URL('./package.json', import.meta.url), 'utf8'));
+        parts.push(`버전: ${pkg.version}`);
+      } catch { parts.push('버전: (알 수 없음)'); }
+      parts.push(`Node: ${process.version} / ${process.platform}`, `작업폴더: ${ROOT}`, '');
+      // 브랜드 값은 회사 정보라 넣지 않는다. 채워졌는지 여부만.
+      const b = readBrand();
+      parts.push(`브랜드 설정: ${Object.values(b).filter((v) => String(v).trim()).length}개 항목 채움`,
+        `로고: ${hasLogo() ? '있음' : '없음'}`, '', '─'.repeat(50), '');
+      for (const f of ['./logs/app.prev.log', './logs/app.log']) {
+        try { parts.push(readFileSync(new URL(f, import.meta.url), 'utf8')); } catch { /* 없을 수 있다 */ }
+      }
+      const body = Buffer.from(parts.join('\n'), 'utf8');
+      return res.writeHead(200, {
+        'content-type': 'text/plain; charset=utf-8',
+        'content-disposition': `attachment; filename="sns-auto-builder-log.txt"`,
+      }).end(body);
+    }
+
     if (req.method === 'POST' && req.url === '/gen') {
       const { mode, engine, topic, refs, today, count, refSet } = JSON.parse(await body(req));
       // 저장된 템플릿을 고르면 다시 업로드하지 않고 그 경로를 그대로 쓴다.
       const picked = refSet ? listRefSets().find((s) => s.id === safeRefId(refSet)) : null;
       if (refSet && !picked) throw new Error('고른 참고자료 템플릿을 찾을 수 없습니다');
       const paths = picked ? picked.files : saveRefs(refs, String(Date.now()));
+      log('gen 시작', { mode, engine, count, refs: paths.length, refSet: refSet || null, topic: String(topic||'').slice(0,60) });
 
       res.writeHead(200, { 'content-type': 'application/x-ndjson; charset=utf-8', 'cache-control': 'no-cache' });
 
@@ -664,7 +710,7 @@ const server = createServer(async (req, res) => {
       const { dir } = JSON.parse(await body(req));
       const abs = join(ROOT, String(dir || ''));
       if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(join(abs, 'gen.json'))) {
-        return json(400, { error: '이 폴더의 실행 정보를 찾을 수 없습니다' });
+        { log('거절', 400, req.url?.split('?')[0], '이 폴더의 실행 정보를 찾을 수 없습니다'); return json(400, { error: '이 폴더의 실행 정보를 찾을 수 없습니다' }); }
       }
       const meta = JSON.parse(readFileSync(join(abs, 'gen.json'), 'utf8'));
       const { engine, topic } = meta;
@@ -672,6 +718,7 @@ const server = createServer(async (req, res) => {
       const slideCount = clampCount(meta.count);
 
       res.writeHead(200, { 'content-type': 'application/x-ndjson; charset=utf-8', 'cache-control': 'no-cache' });
+      log('build 시작', { dir, engine, count: slideCount, refs: paths.length });
       const prompt = buildPipelinePrompt(engine, topic, dir, paths, slideCount);
 
       let tail = '', stopWatch = null;
@@ -700,7 +747,7 @@ const server = createServer(async (req, res) => {
 
     // 로고 미리보기용. HTML 슬라이드도 이 경로로 로고를 불러 쓴다.
     if (req.method === 'GET' && req.url.split('?')[0] === '/logo.svg') {
-      if (!hasLogo()) return json(404, { error: 'no logo' });
+      if (!hasLogo()) { log('거절', 404, req.url?.split('?')[0], 'no logo'); return json(404, { error: 'no logo' }); }
       return res.writeHead(200, { 'content-type': 'image/svg+xml; charset=utf-8', 'cache-control': 'no-cache' })
         .end(readFileSync(LOGO_SVG));
     }
@@ -722,14 +769,14 @@ const server = createServer(async (req, res) => {
         return json(200, { ok: true, logo: false });
       }
       const m = /^data:image\/svg\+xml(?:;charset=[^;,]+)?;base64,([A-Za-z0-9+/=]+)$/.exec(String(dataUrl ?? ''));
-      if (!m) return json(400, { error: 'SVG 파일만 올릴 수 있습니다' });
+      if (!m) { log('거절', 400, req.url?.split('?')[0], 'SVG 파일만 올릴 수 있습니다'); return json(400, { error: 'SVG 파일만 올릴 수 있습니다' }); }
       const svg = Buffer.from(m[1], 'base64');
-      if (svg.length > 2 * 1024 * 1024) return json(400, { error: 'SVG 가 2MB를 넘습니다' });
+      if (svg.length > 2 * 1024 * 1024) { log('거절', 400, req.url?.split('?')[0], 'SVG 가 2MB를 넘습니다'); return json(400, { error: 'SVG 가 2MB를 넘습니다' }); }
       const text = svg.toString('utf8');
-      if (!/<svg[\s>]/i.test(text)) return json(400, { error: 'SVG 내용이 아닙니다' });
+      if (!/<svg[\s>]/i.test(text)) { log('거절', 400, req.url?.split('?')[0], 'SVG 내용이 아닙니다'); return json(400, { error: 'SVG 내용이 아닙니다' }); }
       // SVG 안의 스크립트는 제거한다. 슬라이드 HTML 을 puppeteer 가 그대로 여는 구조라
       // 스크립트가 살아 있으면 그 안에서 실행된다.
-      if (/<script[\s>]|javascript:/i.test(text)) return json(400, { error: '스크립트가 든 SVG 는 쓸 수 없습니다' });
+      if (/<script[\s>]|javascript:/i.test(text)) { log('거절', 400, req.url?.split('?')[0], '스크립트가 든 SVG 는 쓸 수 없습니다'); return json(400, { error: '스크립트가 든 SVG 는 쓸 수 없습니다' }); }
       writeFileSync(LOGO_SVG, svg);
       return json(200, { ok: true, logo: true });
     }
@@ -743,9 +790,9 @@ const server = createServer(async (req, res) => {
     if (req.method === 'POST' && req.url === '/refs/delete') {
       const { id } = JSON.parse(await body(req));
       const safe = safeRefId(id);
-      if (!safe) return json(400, { error: '잘못된 id 입니다' });
+      if (!safe) { log('거절', 400, req.url?.split('?')[0], '잘못된 id 입니다'); return json(400, { error: '잘못된 id 입니다' }); }
       const dir = join(REFS_ROOT(), safe);
-      if (!dir.startsWith(REFS_ROOT()) || !existsSync(dir)) return json(404, { error: '없는 템플릿입니다' });
+      if (!dir.startsWith(REFS_ROOT()) || !existsSync(dir)) { log('거절', 404, req.url?.split('?')[0], '없는 템플릿입니다'); return json(404, { error: '없는 템플릿입니다' }); }
       rmSync(dir, { recursive: true, force: true });
       return json(200, { ok: true, sets: listRefSets() });
     }
@@ -755,7 +802,7 @@ const server = createServer(async (req, res) => {
       const { dir } = JSON.parse(await body(req));
       const abs = join(ROOT, String(dir || ''));
       if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(join(abs, 'gen.json'))) {
-        return json(400, { error: '이 폴더의 실행 정보를 찾을 수 없습니다' });
+        { log('거절', 400, req.url?.split('?')[0], '이 폴더의 실행 정보를 찾을 수 없습니다'); return json(400, { error: '이 폴더의 실행 정보를 찾을 수 없습니다' }); }
       }
       const meta = JSON.parse(readFileSync(join(abs, 'gen.json'), 'utf8'));
       res.writeHead(200, { 'content-type': 'application/x-ndjson; charset=utf-8', 'cache-control': 'no-cache' });
@@ -770,12 +817,12 @@ const server = createServer(async (req, res) => {
     if (req.method === 'POST' && req.url === '/regen') {
       const { dir, n } = JSON.parse(await body(req));
       const num = Number(n);
-      if (!Number.isInteger(num) || num < 1 || num > 99) return json(400, { error: '슬라이드 번호가 잘못됐습니다' });
+      if (!Number.isInteger(num) || num < 1 || num > 99) { log('거절', 400, req.url?.split('?')[0], '슬라이드 번호가 잘못됐습니다'); return json(400, { error: '슬라이드 번호가 잘못됐습니다' }); }
 
       // dir 은 클라이언트 값이다. output/ 밖으로 못 나가게 실제 경로로 검사한다.
       const abs = join(ROOT, String(dir || ''));
       if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(join(abs, 'gen.json'))) {
-        return json(400, { error: '재생성 정보를 찾을 수 없습니다' });
+        { log('거절', 400, req.url?.split('?')[0], '재생성 정보를 찾을 수 없습니다'); return json(400, { error: '재생성 정보를 찾을 수 없습니다' }); }
       }
       const meta = JSON.parse(readFileSync(join(abs, 'gen.json'), 'utf8'));
       if (!meta.slides || !existsSync(join(ROOT, meta.slides))) {
@@ -817,9 +864,9 @@ const server = createServer(async (req, res) => {
       const abs = join(ROOT, String(dir || ''));
       const base = join(ROOT, 'output');
       // output 자체나 _refs 같은 내부 폴더는 못 지운다
-      if (!abs.startsWith(base + sep) || abs === base) return json(400, { error: '지울 수 없는 경로입니다' });
-      if (/[\\/]_/.test(abs.slice(base.length))) return json(400, { error: '내부 폴더는 지울 수 없습니다' });
-      if (!existsSync(abs)) return json(404, { error: '없는 결과물입니다' });
+      if (!abs.startsWith(base + sep) || abs === base) { log('거절', 400, req.url?.split('?')[0], '지울 수 없는 경로입니다'); return json(400, { error: '지울 수 없는 경로입니다' }); }
+      if (/[\\/]_/.test(abs.slice(base.length))) { log('거절', 400, req.url?.split('?')[0], '내부 폴더는 지울 수 없습니다'); return json(400, { error: '내부 폴더는 지울 수 없습니다' }); }
+      if (!existsSync(abs)) { log('거절', 404, req.url?.split('?')[0], '없는 결과물입니다'); return json(404, { error: '없는 결과물입니다' }); }
       rmSync(abs, { recursive: true, force: true });
       return json(200, { ok: true, items: listOutputs() });
     }
@@ -828,17 +875,18 @@ const server = createServer(async (req, res) => {
     if (req.method === 'GET' && req.url.startsWith('/zip/')) {
       const rel = decodeURIComponent(req.url.slice(5).split('?')[0]);
       const abs = join(ROOT, 'output', rel);
-      if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(abs)) return json(404, { error: 'not found' });
+      if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(abs)) { log('거절', 404, req.url?.split('?')[0], 'not found'); return json(404, { error: 'not found' }); }
 
       const entries = readdirSync(abs)
         .filter((f) => /^slide-\d{2}\.png$/.test(f))
         .sort()
         .map((f) => ({ name: f, data: readFileSync(join(abs, f)) }));
-      if (!entries.length) return json(404, { error: '슬라이드가 없습니다' });
+      if (!entries.length) { log('거절', 404, req.url?.split('?')[0], '슬라이드가 없습니다'); return json(404, { error: '슬라이드가 없습니다' }); }
       for (const extra of ['caption.md', 'review.md']) {
         if (existsSync(join(abs, extra))) entries.push({ name: extra, data: readFileSync(join(abs, extra)) });
       }
 
+      log('zip 다운로드', { dir: rel, files: entries.length });
       const zip = makeZip(entries);
       // 폴더명이 한글이라 filename* (RFC 5987) 로 줘야 파일명이 안 깨진다.
       const base = rel.replace(/[\\/]+$/, '').split(/[\\/]/).pop() || 'carousel';
@@ -853,7 +901,7 @@ const server = createServer(async (req, res) => {
     if (req.method === 'GET' && req.url.startsWith('/out/')) {
       const rel = decodeURIComponent(req.url.slice(5).split('?')[0]);
       const abs = join(ROOT, 'output', rel);
-      if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(abs)) return json(404, { error: 'not found' });
+      if (!abs.startsWith(join(ROOT, 'output')) || !existsSync(abs)) { log('거절', 404, req.url?.split('?')[0], 'not found'); return json(404, { error: 'not found' }); }
       return res.writeHead(200, { 'content-type': MIME[extname(abs).toLowerCase()] || 'application/octet-stream' })
         .end(readFileSync(abs));
     }
@@ -864,6 +912,8 @@ const server = createServer(async (req, res) => {
     }
     json(404, { error: 'not found' });
   } catch (e) {
+    // 오류를 남기는 게 로그의 존재 이유다. 스택까지 넣어야 원인을 짚을 수 있다.
+    log('오류', req.method, req.url?.split('?')[0], e.message, (e.stack || '').split('\n')[1]?.trim() || '');
     if (!res.headersSent) json(400, { error: e.message });
     else res.end(JSON.stringify({ error: e.message }) + '\n');
   }
@@ -873,5 +923,5 @@ const server = createServer(async (req, res) => {
 if (process.argv[1] === fileURLToPath(import.meta.url)) {
   server.on('error', (e) => console.error(
     e.code === 'EADDRINUSE' ? `포트 ${PORT} 사용 중. PORT=8788 node server.mjs 로 바꿔 실행하세요.` : e));
-  server.listen(PORT, '127.0.0.1', () => console.log(`http://127.0.0.1:${PORT}`));
+  server.listen(PORT, '127.0.0.1', () => { log('서버 시작', { port: PORT, node: process.version, platform: process.platform }); console.log(`http://127.0.0.1:${PORT}`); });
 }