elanous 0.2.6 → 0.2.7

package/scripts/vflow-collect.ts

@@ -22,17 +22,30 @@ const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36';
 const OUT_DIR = process.env.VFLOW_OUT ?? join(homedir(), 'docs', 'ref', 'vflow');
 const NDJSON = join(OUT_DIR, 'prompts.ndjson');
 const URLS = join(OUT_DIR, 'urls.txt');
-const CONCURRENCY = 4;
-const GAP_MS = 120;
+// ⚠️ 2026-10-01 실측: 4병렬·120ms 로 전수를 돌리면 수백 건 뒤 사이트가 429 를 낸다(재수집 404건 중 158건).
+// 기본을 낮추고, 429 는 «없다»가 아니라 «기다려라»로 읽는다(Retry-After 를 따른다).
+const CONCURRENCY = Number(process.env.VFLOW_CONCURRENCY ?? 2);
+const GAP_MS = Number(process.env.VFLOW_GAP_MS ?? 400);
+const MAX_429_RETRIES = 5;
 
 const argv = process.argv.slice(2);
 const limitAt = argv.indexOf('--limit');
 const LIMIT = limitAt >= 0 ? Number(argv[limitAt + 1]) : Infinity;
 
+let throttled = 0;
 async function get(url: string): Promise<string> {
-  const r = await fetch(url, { headers: { 'User-Agent': UA } });
-  if (!r.ok) throw new Error(`HTTP ${r.status}`);
-  return r.text();
+  for (let attempt = 0; ; attempt++) {
+    const r = await fetch(url, { headers: { 'User-Agent': UA } });
+    if (r.status === 429 && attempt < MAX_429_RETRIES) {
+      throttled++;
+      const after = Number(r.headers.get('retry-after'));
+      const waitMs = Number.isFinite(after) && after > 0 ? after * 1000 : 5000 * 2 ** attempt;
+      await new Promise((res) => setTimeout(res, waitMs));
+      continue;
+    }
+    if (!r.ok) throw new Error(`HTTP ${r.status}`);
+    return r.text();
+  }
 }
 
 /** 사이트맵 전수 → 영문 `/prompts/` URL. ⛔ 번역판(`/{lang}/prompts/`)은 «같은 내용»이라 뺀다. */
@@ -166,14 +179,14 @@ async function main(): Promise<void> {
       catch { failed++; return null; }                  // ⛔ 「없다」가 아니라 «못 받았다»
     }));
     for (const r of rows) { if (r) { appendFileSync(NDJSON, JSON.stringify(r) + '\n'); ok++; } else noLd++; }
-    if ((i / CONCURRENCY) % 25 === 0) console.log(`  … ${ok + noLd}/${todo.length}  ok=${ok} 건너뜀=${noLd}`);
+    if ((i / CONCURRENCY) % 25 === 0) console.log(`  … ${ok + noLd}/${todo.length}  ok=${ok} 못받음=${failed} jsonld없음=${noLd - failed} 429대기=${throttled}`);
   }
   // ⛔ 수를 «도구가» 낸다 — 사람이 세지 않는다.
   writeFileSync(join(OUT_DIR, 'MANIFEST.txt'),
     [`source: https://vflow.live (robots: Allow: / · 2026-09-23 확인)`,
      `fetched: ${new Date().toISOString()}`,
      `urls_total: ${urls.length}`, `rows_ok: ${ok + done.size}`,
-     `skipped_no_jsonld: ${noLd - failed}`, `failed_fetch: ${failed}`,
+     `skipped_no_jsonld: ${noLd - failed}`, `failed_fetch: ${failed}`, `throttled_429_retries: ${throttled}`,
      `schema: url model category slug name description prompt keywords[] datePublished author authorUrl sourcePost thumb spec{duration,camera[],lighting[],mood[],difficulty,promptLanguage,includes[]} video{url,isoDuration,resolution,aspect}`,
      `refetch: bun scripts/vflow-collect.ts`, ''].join('\n'));
   console.log(`\n  ✅ ok ${ok} · 건너뜀 ${noLd - failed} · 못 받음 ${failed}  →  ${NDJSON}`);

package/scripts/vflow-search.ts

@@ -0,0 +1,73 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { searchVflowReferences, type VflowQuery } from '../src/video-pipeline/vflow-reference.js';
+
+const args = process.argv.slice(2);
+let file = join(homedir(), 'docs', 'ref', 'vflow', 'prompts.ndjson');
+const query: { -readonly [K in keyof VflowQuery]: VflowQuery[K] } = { limit: 5 };
+let json = false;
+const techniques: string[] = [];
+const terms: string[] = [];
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i]!;
+  if (arg === '--json') { json = true; continue; }
+  if (['--file', '--model', '--technique', '--category', '--limit', '--camera', '--lighting', '--mood', '--max-seconds'].includes(arg)) {
+    const value = args[++i];
+    if (!value || value.startsWith('--')) {
+      console.error(`값이 필요한 옵션: ${arg}`);
+      process.exit(1);
+    }
+    switch (arg) {
+      case '--file': file = value; break;
+      case '--model': query.model = value; break;
+      case '--technique': techniques.push(value); break;
+      case '--category': query.category = value; break;
+      case '--camera': query.camera = value; break;
+      case '--lighting': query.lighting = value; break;
+      case '--mood': query.mood = value; break;
+      case '--limit': {
+        const parsed = Number(value);
+        if (!Number.isSafeInteger(parsed) || parsed < 0) {
+          console.error(`--limit 은 0 이상의 정수여야 합니다: ${value}`);
+          process.exit(1);
+        }
+        query.limit = parsed;
+        break;
+      }
+      case '--max-seconds': {
+        const parsed = Number(value);
+        if (!Number.isFinite(parsed) || parsed < 0 || !value.trim()) {
+          console.error(`--max-seconds 은 0 이상의 숫자여야 합니다: ${value}`);
+          process.exit(1);
+        }
+        query.maxSeconds = parsed;
+        break;
+      }
+    }
+  } else if (arg.startsWith('--')) {
+    console.error(`알 수 없는 옵션: ${arg}`);
+    process.exit(1);
+  } else {
+    terms.push(arg);
+  }
+}
+query.terms = terms;
+query.techniques = techniques;
+const result = searchVflowReferences(file, query);
+if (!result.available) {
+  console.error(`입력 파일을 읽을 수 없습니다: ${file} (${result.reason})`);
+  process.exit(1);
+}
+if (json) {
+  console.log(JSON.stringify(result.rows.map(({ url, model, category, name, prompt, keywords, author, authorUrl, video }) =>
+    ({ url, model, category, name, prompt, keywords, author, authorUrl, video: video ?? null }))));
+  if (result.matches === 0) console.error(`일치 0 · 읽은 줄 ${result.read}`);
+} else if (result.matches === 0) {
+  console.log(`일치 0 · 읽은 줄 ${result.read}`);
+} else {
+  for (const row of result.rows) {
+    console.log(`${row.name} · ${row.model}\n${row.url}\n${row.author ?? ''}\n${row.prompt.slice(0, 240)}${row.video?.url ? `\n${row.video.url}` : ''}`);
+  }
+}
+if (result.skipped) console.error(`건너뛴 줄 ${result.skipped}`);

package/scripts/video-free-line-test-walker.ts

@@ -0,0 +1,36 @@
+import { readFileSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+import type { GraphSpecLike, WalkerApi } from '../src/video-pipeline/walk-line.js';
+
+interface TestGraph extends GraphSpecLike {
+  entry_node: string;
+  terminal_nodes: string[];
+  nodes: ({ node_id: string; recipe?: string; max_visits?: number })[];
+}
+
+export const readGraphSpec: WalkerApi['readGraphSpec'] = (path) => {
+  try { return { spec: parseYaml(readFileSync(path, 'utf8')) as TestGraph }; }
+  catch (e) { return { error: (e as Error).message }; }
+};
+
+export const walkGraph: WalkerApi['walkGraph'] = async (graph, step, opts) => {
+  const spec = graph as TestGraph;
+  const visits = new Map<string, number>();
+  const steps: { node: string; visit: number }[] = [];
+  let next = spec.entry_node;
+  while (steps.length < opts.maxSteps) {
+    const node = spec.nodes.find((n) => n.node_id === next);
+    if (!node) return { terminal: null, stopReason: 'no-node', steps };
+    const visit = (visits.get(next) ?? 0) + 1;
+    if (visit > (node.max_visits ?? 1)) return { terminal: null, stopReason: 'budget-exceeded', steps };
+    visits.set(next, visit);
+    steps.push({ node: next, visit });
+    if (spec.terminal_nodes.includes(next)) return { terminal: next, stopReason: 'terminal', steps };
+    const outcome = await step(node);
+    if (outcome === null) { next = opts.unobservedNode; continue; }
+    const edge = spec.edges.find((e) => e.from === next && (e.to !== undefined || e.map?.[outcome] !== undefined));
+    if (!edge) return { terminal: null, stopReason: 'no-edge', steps };
+    next = edge.to ?? edge.map![outcome]!;
+  }
+  return { terminal: null, stopReason: 'budget-exceeded', steps };
+};

package/scripts/video-pipeline.ts

@@ -998,9 +998,8 @@ async function plan() {
     return where.length ? `${u} → 구간을 «${where.join('/')}» 까지` : `${u} → ⛔ 스핀 결손`;
   });
 
-  sayUnprobed();
-
   if (COMPACT) {
+    sayUnprobed();
     // ⛔ 노드별로 찍지 않는다 — encode 가 세 번 나온다. 능력 단위로 «접는다».
     const seen = new Map<string, { impl?: Impl; required: boolean }>();
     for (const o of out) for (const p of o.picks) {
@@ -1138,6 +1137,7 @@ async function plan() {
     return;
   }
 
+  sayUnprobed();
   console.log(`\n🧱 추천 스택 — 구간 ${nodes[0].id} → ${nodes[nodes.length - 1].id} · 선호 ${TIER_MARK[prefer]}`);
   console.log(`   설정: ${LOADED.source}${MACHINE ? ` · 기계 «${MACHINE_NAME}»` : ''}`);
   if (MISSING.size) console.log(`   ⚠️ 없다고 «가정»한 것: ${[...MISSING].join(', ')}`);

package/skills/explainer-video/SKILL.md

@@ -35,7 +35,7 @@ The grammar of a chapter (take it from the reference, don't improvise):
 
 The outro gives one line that sums everything up, then the CTA.
 
-⛔ Every claim must trace to a merged change or a measured run, listed in `sources`. Don't write «fully autonomous», dates you can't promise, or comparisons (`docs/marketing/GUIDE-launch-tone-and-banned-claims-*`).
+⛔ Every claim must trace to a merged change or a measured run, listed in `sources`. Don't write «fully autonomous», dates you can't promise, or comparisons with other products.
 
 ## 2. Voice — `bun $SKILL/engine/vo.ts <project>/script.json`
 
@@ -85,7 +85,7 @@ The reference supplies the **grammar** (components and staging), never its colou
 - **Text**: `#F2F1EE`.
 - **Motif**: the V6 «엘랑 소용돌이» mark (`engine/brand/`), used in three places — a slow, faint rotation behind the scene, the header, and the chapter cards.
 
-Why these choices, what the reference does, and what we can and cannot reproduce: `내부 문서 `RESEARCH-explainer-video-reference-decomposition-2026-09-30``.
+The reference is used only for its structure (header, chapter cards, a diagram that moves one step per line, keyword-timed captions). Its colours, artwork and voice are not reproduced.
 
 ## Field reel — photos from the venue → a vertical video in about a minute
 
@@ -95,13 +95,16 @@ zsh $SKILL/engine/reel.sh <folder> --title "마케터의 밤" --sub "2026.10.02
 
 - **Input**: a folder of phone photos (jpg · png · heic) and short clips (mp4 · mov). The default upload folder is `~/.elanous/field/<event>/`.
 - **Order**: by capture time (`mdls` creation date), then by file name.
-- **Captions**: optional `<folder>/captions.txt`, one line per item as `파일명 | 자막`. Items without a line get no caption.
+- **Captions**: optional `<folder>/captions.txt`, one line per item as `파일명 | 자막`. A photo without a line gets one line from a vision model (`codex exec -i`, all photos in parallel, 30 s cap each); if that fails it shows «현장 N». `FIELD_REEL_VISION=0` turns the vision step off.
+- **Title**: `--title`, or `title.txt` through the daemon. A slug-like title (`field-2026-10-01`) is replaced by a vision headline read from the first three photos (event or company names on screen first). The date line defaults to the first photo's capture date (KST).
+- **Music**: `FIELD_REEL_BGM=<file>` or `~/.cache/elanous-explainer/bgm/field.wav` — cut to length, faded in and out, leveled to about −16 LUFS. No file means no music. Use only licensed tracks (the default cache holds an Epidemic Sound download); the file is never committed.
 - **Output**:
-  - `<folder>/reel/reel-9x16.mp4` at 1080×1920, 30–60 s.
-  - A black title card, then each item: photos for 3.5 s with a slow zoom, clips for their first 5 s.
-  - One caption line per item, the V6 header, an Icarus Red progress bar, and an end card with elanous.ai.
-- **Fitting to length**: over 60 s drops items from the middle, keeping the first and last. Under 30 s stretches the photos.
-- **Measured**: 7 items → 31.2 s video in 56–83 s end to end (M-series Mac, `hyperframes render`).
+  - `<folder>/reel/reel-9x16.mp4` at 1080×1920, 24–60 s.
+  - An intro card (kicker, mark, title word by word, red rule, date), then each item: photos for about 4–6 s. A landscape photo is shown whole over a blurred fill of itself; a portrait photo fills the frame. Each move overlaps the next with a slide and a red wipe on the cut.
+  - Per item a counter (`01 / 03`), the caption rising word by word, and a red rule. The V6 header, an Icarus Red progress bar, and an end card with elanous.ai.
+  - `--part body` renders the photos only (no cards, no music) — for an instant version that stitches pre-rendered cards around it.
+- **Fitting to length**: over 60 s drops items from the middle, keeping the first and last. Under 24 s stretches the photos.
+- **Measured**: 3 photos → 24 s video in 28 s end to end, of which vision 8.7 s and render 15.9 s (M-series Mac, 10-01). Earlier: 7 items → 31.2 s video in 56–83 s.
 - **Before posting**: people's faces need their consent. Run the same 1 fps OCR check as any public video.
 
 ## Graph
@@ -114,4 +117,4 @@ zsh $SKILL/engine/reel.sh <folder> --title "마케터의 밤" --sub "2026.10.02
   - speech mismatch → vo;
   - bad script → script;
   - public release → needs-human.
-- **Not coded yet**: the `explainer-*` recipes. Until they are, you run these steps from this skill.
+- **Recipes**: the `explainer-*` recipes are in the elanous core, but `graph run` does not yet accept this graph's terminal nodes. The video-explainer plugin therefore ships the skill and nodes only; run these steps from this skill. The graph comes with plugin 0.2.0.

package/skills/explainer-video/engine/build.mjs

@@ -22,7 +22,7 @@ const W = 1920, H = 1080, FPS = 30;
 // ── palette (Elanvital CI · RCBC guide) ─────────────────────────────────────────
 const C = { deep: "#1D2751", deep2: "#141C3D", black: "#000000", ink: "#F2F1EE", red: "#E95047", muted: "rgba(242,241,238,0.62)", line: "rgba(242,241,238,0.86)", faint: "rgba(242,241,238,0.10)" };
 
-// ── mark (V6 «엘랑 소용돌이», docs/brand/icon) ───────────────────────────────────
+// ── mark (V6 «엘랑 소용돌이», engine/brand/) ─────────────────────────────────────
 const markSrc = readFileSync(process.env.ELANOUS_MARK ?? join(here, "brand", "elanous-mark-on-dark.svg"), "utf8");
 const markPaths = [...markSrc.matchAll(/<path d="([^"]*)"/g)].map((m) => m[1]);
 const mark = (size, blade = C.ink, dot = C.red, cls = "") =>

package/skills/explainer-video/engine/reel.mjs

@@ -1,22 +1,29 @@
-// Field reel — a folder of phone photos / short clips → one vertical 30–60 s HyperFrames composition (EV10).
-// Usage: node reel.mjs <folder> [--title "마케터의 밤"] [--sub "2026.10.02 · 서울"] [--max 60] [--min 30]
+// Field reel — a folder of phone photos / short clips → one vertical HyperFrames composition (EV10 · EV10b).
+// Usage: node reel.mjs <folder> [--title "마케터의 밤"] [--sub "2026.10.02 · 서울"] [--max 60] [--min 24] [--part full|body]
 //   <folder>/captions.txt (optional): one line per item — `파일명 | 자막` (a line without « | » is ignored).
+//   Photos without a caption get one line from a vision model (codex · parallel · FIELD_REEL_VISION=0 turns it off);
+//   if that fails the caption is «현장 N». A slug-like title (`field-2026-10-01`) is replaced by a vision headline.
+//   BGM: FIELD_REEL_BGM=<wav/mp3> or ~/.cache/elanous-explainer/bgm/field.wav — cut to length, faded and leveled here.
+//   --part body: photos only, no intro/end cards and no music (the instant version stitches cached cards around it).
 // Output: <folder>/reel/hf/ (HyperFrames project) ⊕ reel/timeline.json. Render: npx hyperframes render --fps 30 in reel/hf.
 // Look = Elanvital CI: Real Black ground · Icarus Red single accent · V6 mark · Pretendard. Order = capture time (then name).
 import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync, readdirSync, statSync } from "node:fs";
 import { join, dirname, resolve, extname, basename } from "node:path";
 import { homedir } from "node:os";
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 
 const here = dirname(fileURLToPath(import.meta.url));
 const argv = process.argv.slice(2);
 const opt = (k, d) => { const i = argv.indexOf(`--${k}`); return i >= 0 ? argv[i + 1] : d; };
 const folder = resolve(argv.find((a, i) => !a.startsWith("--") && !(i > 0 && argv[i - 1].startsWith("--"))) ?? ".");
-const TITLE = opt("title", "현장 스케치"), SUB = opt("sub", ""), MAX = Number(opt("max", 60)), MIN = Number(opt("min", 30));
-const W = 1080, H = 1920, INTRO = 2.2, END = 3.0, PHOTO = 3.5, CLIP_MAX = 5, XF = 0.35;
+const PART = opt("part", "full");
+const MAX = Number(opt("max", 60)), MIN = Number(opt("min", 24));
+const W = 1080, H = 1920, PHOTO = 4.2, CLIP_MAX = 5, XF = 0.5;
+const INTRO = PART === "body" ? 0 : 3.0, END = PART === "body" ? 0 : 3.4;
 const out = join(folder, "reel"), hf = join(out, "hf"), media = join(hf, "assets", "media");
 mkdirSync(media, { recursive: true }); mkdirSync(join(hf, "assets", "fonts"), { recursive: true });
+const T0 = Date.now(), lap = (s) => console.log(`reel: ${s} · ${((Date.now() - T0) / 1000).toFixed(1)}s`);
 
 // ── collect & order ────────────────────────────────────────────────────────────
 const IMG = [".jpg", ".jpeg", ".png", ".heic", ".webp"], VID = [".mp4", ".mov", ".m4v"];
@@ -41,9 +48,9 @@ if (!items.length) throw new Error(`no photos or clips in ${folder}`);
 for (const it of items) it.dur = it.video ? Math.min(CLIP_MAX, Math.max(1.5, probeDur(it.p))) : PHOTO;
 const body = () => items.reduce((a, it) => a + it.dur, 0);
 while (INTRO + body() + END > MAX && items.length > 1) items.splice(Math.floor(items.length / 2), 1); // drop from the middle, keep first & last
-if (INTRO + body() + END < MIN) { const photos = items.filter((i) => !i.video); const need = MIN - (INTRO + body() + END); for (const p of photos) p.dur += need / Math.max(1, photos.length); }
+if (PART !== "body" && INTRO + body() + END < MIN) { const photos = items.filter((i) => !i.video); const need = MIN - (INTRO + body() + END); for (const p of photos) p.dur += need / Math.max(1, photos.length); }
 
-// ── media prep: HEIC → jpg · big photos down to 2160 · clips re-encoded short & muted ──
+// ── media prep: HEIC → jpg · big photos down to 2160 · a small copy for the vision model · clips re-encoded short & muted ──
 let t = INTRO;
 items.forEach((it, i) => {
   it.start = +t.toFixed(3); t += it.dur;
@@ -55,10 +62,49 @@ items.forEach((it, i) => {
     it.src = `m${i}.jpg`;
     const r = run("sips", ["-s", "format", "jpeg", "-Z", "2160", it.p, "--out", join(media, it.src)]);
     if (r.status !== 0) throw new Error(`photo ${it.f}: ${r.stderr.slice(0, 200)}`);
+    const dim = run("sips", ["-g", "pixelWidth", "-g", "pixelHeight", join(media, it.src)]).stdout;
+    const pw = Number(/pixelWidth: (\d+)/.exec(dim)?.[1]), ph = Number(/pixelHeight: (\d+)/.exec(dim)?.[1]);
+    it.wide = pw > 0 && ph > 0 && pw / ph > 0.75; // anything wider than 3:4 is shown whole over a blurred fill
+    run("sips", ["-s", "format", "jpeg", "-Z", "1024", it.p, "--out", join(out, `v${i}.jpg`)]);
   }
-  it.cap = caps[it.f] ?? "";
 });
 const TOTAL = +(t + END).toFixed(3);
+lap(`${items.length} items prepared`);
+
+// ── vision: one caption line per photo, in parallel; a headline when the title is only a slug ──
+const CODEX = process.env.FIELD_REEL_CODEX_BIN || "codex";
+const VISION = process.env.FIELD_REEL_VISION !== "0";
+const ask = (prompt, images, ms = 30000) => new Promise((done) => {
+  const args = ["exec", "--skip-git-repo-check", "-c", "model_reasoning_effort=low", prompt, ...images.flatMap((im) => ["-i", im])];
+  let buf = "", settled = false;
+  const finish = (v) => { if (!settled) { settled = true; done(v); } };
+  let child;
+  try { child = spawn(CODEX, args, { stdio: ["ignore", "pipe", "ignore"] }); } catch { return finish(""); }
+  const timer = setTimeout(() => { child.kill("SIGKILL"); finish(""); }, ms);
+  child.stdout.on("data", (d) => { buf += d; });
+  child.on("error", () => { clearTimeout(timer); finish(""); });
+  child.on("close", (code) => { clearTimeout(timer); finish(code === 0 ? buf : ""); });
+});
+const oneLine = (s, max) => {
+  const line = s.split("\n").map((l) => l.trim().replace(/^["'«“]|["'»”]$/g, "")).filter(Boolean).pop() ?? "";
+  return line.length >= 2 && line.length <= max ? line.replace(/[.。]$/, "") : "";
+};
+const CAP_PROMPT = "행사 현장 사진이다. 세로 영상 자막으로 쓸 한국어 한 줄을 출력하라 — 18자 이내 · 마침표 없이 · 보이는 장면만 · 사람 이름·외모 묘사·추측 금지 · 화면 속 글자(행사명·회사명)는 읽히면 써도 된다. 그 한 줄만.";
+const HEAD_PROMPT = "같은 행사에서 찍은 사진들이다. 영상 첫 화면 제목으로 쓸 한국어 행사 이름 한 줄을 출력하라 — 16자 이내 · 화면 속 글자에서 읽히는 행사·회사 이름을 우선 · 읽히지 않으면 장면을 짧게(예: «상장 기념식 현장») · 추측 금지. 그 한 줄만.";
+const slugTitle = (s) => !s || /^[a-z0-9]+(?:-[a-z0-9]+)*$/i.test(s);
+let TITLE = opt("title", ""), SUB = opt("sub", "");
+const photos = items.filter((it) => !it.video);
+const VT0 = Date.now();
+const jobs = VISION ? [
+  ...photos.filter((it) => !caps[it.f]).map(async (it) => { it.vcap = oneLine(await ask(CAP_PROMPT, [join(out, `v${items.indexOf(it)}.jpg`)]), 22); }),
+  ...(PART !== "body" && slugTitle(TITLE) && photos.length ? [(async () => { TITLE = oneLine(await ask(HEAD_PROMPT, photos.slice(0, 3).map((it) => join(out, `v${items.indexOf(it)}.jpg`))), 20) || TITLE; })()] : []),
+] : [];
+await Promise.all(jobs);
+const visionMs = Date.now() - VT0;
+items.forEach((it, i) => { it.cap = caps[it.f] || it.vcap || (it.video ? "" : `현장 ${i + 1}`); });
+if (slugTitle(TITLE)) TITLE = "현장 스케치";
+if (!SUB) { const d = new Date(items[0].t + 9 * 3600e3); SUB = `${d.getUTCFullYear()}.${String(d.getUTCMonth() + 1).padStart(2, "0")}.${String(d.getUTCDate()).padStart(2, "0")}`; }
+lap(`vision ${jobs.length ? `${items.filter((i) => i.vcap).length}/${photos.filter((p) => !caps[p.f]).length} captions` : "off"} · title «${TITLE}»`);
 
 // ── assets (same cache as build.mjs) ───────────────────────────────────────────
 const CACHE = process.env.EXPLAINER_CACHE ?? join(homedir(), ".cache", "elanous-explainer");
@@ -69,54 +115,114 @@ for (const [rel, url] of Object.entries(ASSETS)) {
   if (!existsSync(c)) { const res = await fetch(url); if (!res.ok) throw new Error(`asset ${rel}: HTTP ${res.status}`); mkdirSync(dirname(c), { recursive: true }); writeFileSync(c, Buffer.from(await res.arrayBuffer())); }
   copyFileSync(c, join(hf, "assets", rel));
 }
+
+// ── music: cut to length · fade in/out · level to about -16 LUFS (the whole mix is music) ──
+const BGM = process.env.FIELD_REEL_BGM || join(CACHE, "bgm", "field.wav");
+let music = "";
+if (PART !== "body" && existsSync(BGM)) {
+  const r = run("ffmpeg", ["-v", "error", "-y", "-i", BGM, "-t", String(TOTAL), "-af", `afade=t=in:d=0.4,afade=t=out:st=${f(TOTAL - 1.6)}:d=1.6,loudnorm=I=-16:TP=-1.5:LRA=9`, "-ar", "48000", "-ac", "2", join(media, "bgm.wav")]);
+  if (r.status === 0) music = "bgm.wav"; else console.error(`reel: music skipped — ${r.stderr.slice(0, 160)}`);
+}
+function f(x) { return +x.toFixed(3); }
+
 const markPaths = [...readFileSync(join(here, "brand", "elanous-mark-on-dark.svg"), "utf8").matchAll(/<path d="([^"]*)"/g)].map((m) => m[1]);
 const mark = (s, cls = "") => `<svg class="${cls}" width="${s}" height="${s}" viewBox="150 150 724 724">${markPaths.map((d) => `<path d="${d}" fill="#F2F1EE"/>`).join("")}<circle cx="512" cy="512" r="76" fill="#E95047"/></svg>`;
 const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;");
-const f = (x) => +x.toFixed(3);
+const words = (s, cls) => s.split(/\s+/).filter(Boolean).map((w) => `<span class="${cls}">${esc(w)}</span>`).join(" ");
 
 // ── composition ────────────────────────────────────────────────────────────────
+// Each photo: blurred fill + the whole photo (wide) or a full-bleed crop (tall) · slow push · a cross-move into the next ·
+// a red wipe on the cut · counter «0N / 0M» · caption words rising one by one.
 const tw = [];
+const n = items.length;
 const clips = items.map((it, i) => {
-  const vis = it.video
-    ? `<video id="v${i}" class="clip med" src="assets/media/${it.src}" muted playsinline data-start="${f(it.start)}" data-duration="${f(it.dur)}" data-track-index="1"></video>`
-    : `<div class="clip med" data-start="${f(it.start)}" data-duration="${f(it.dur)}" data-track-index="1"><img class="kb k${i}" src="assets/media/${it.src}"/></div>`;
-  if (!it.video) tw.push(`tl.fromTo(".k${i}", {scale:1.0, x:0}, {scale:1.09, x:${i % 2 ? -24 : 24}, duration:${f(it.dur)}, ease:"none"}, ${f(it.start)});`);
-  const cap = it.cap ? `<div class="clip capw" data-start="${f(it.start)}" data-duration="${f(it.dur)}" data-track-index="3"><div class="cap c${i}">${esc(it.cap)}</div></div>` : "";
-  if (it.cap) tw.push(`tl.fromTo(".c${i}", {opacity:0, y:20}, {opacity:1, y:0, duration:0.4, ease:"power3.out"}, ${f(it.start + 0.15)});`);
+  const s = it.start, d = it.dur, last = i === n - 1;
+  const span = last ? d : d + XF; // overlap the next item so the move reads as one motion
+  let vis;
+  if (it.video) {
+    vis = `<video id="v${i}" class="clip med" src="assets/media/${it.src}" muted playsinline data-start="${f(s)}" data-duration="${f(d)}" data-track-index="1"></video>`;
+  } else if (it.wide) {
+    vis = `<div class="clip med" data-start="${f(s)}" data-duration="${f(span)}" data-track-index="${1 + (i % 2)}"><div class="g g${i}">`
+      + `<img class="fill" src="assets/media/${it.src}"/><div class="dim"></div>`
+      + `<div class="frame fr${i}"><img src="assets/media/${it.src}"/></div></div></div>`;
+    tw.push(`tl.fromTo(".fr${i}", {scale:1.0, x:${i % 2 ? 30 : -30}}, {scale:1.12, x:${i % 2 ? -30 : 30}, duration:${f(span)}, ease:"none"}, ${f(s)});`);
+    tw.push(`tl.fromTo(".g${i} .fill", {scale:1.25}, {scale:1.4, duration:${f(span)}, ease:"none"}, ${f(s)});`);
+  } else {
+    vis = `<div class="clip med" data-start="${f(s)}" data-duration="${f(span)}" data-track-index="${1 + (i % 2)}"><div class="g g${i}"><img class="kb k${i}" src="assets/media/${it.src}"/></div></div>`;
+    tw.push(`tl.fromTo(".k${i}", {scale:1.02, x:0}, {scale:1.12, x:${i % 2 ? -28 : 28}, duration:${f(span)}, ease:"none"}, ${f(s)});`);
+  }
+  if (!it.video && i > 0) tw.push(`tl.fromTo(".g${i}", {opacity:0, xPercent:${i % 2 ? 14 : -14}}, {opacity:1, xPercent:0, duration:${XF}, ease:"power3.out"}, ${f(s - XF)});`);
+  if (i > 0) tw.push(`tl.fromTo(".wipe", {scaleY:0, transformOrigin:"50% 100%"}, {scaleY:1, duration:${XF / 2}, ease:"power2.in", immediateRender:false}, ${f(s - XF / 2)});`
+    + `tl.to(".wipe", {scaleY:0, transformOrigin:"50% 0%", duration:${XF / 2}, ease:"power2.out"}, ${f(s)});`);
+  const no = `${String(i + 1).padStart(2, "0")} <i>/ ${String(n).padStart(2, "0")}</i>`;
+  const cap = it.cap ? `<div class="clip capw" data-start="${f(s)}" data-duration="${f(d)}" data-track-index="4"><div class="no n${i}">${no}</div><div class="cap c${i}">${words(it.cap, `w w${i}`)}</div><div class="rule r${i}"></div></div>` : "";
+  if (it.cap) {
+    tw.push(`tl.fromTo(".n${i}", {opacity:0, x:-24}, {opacity:1, x:0, duration:0.35, ease:"power3.out"}, ${f(s + 0.2)});`);
+    tw.push(`tl.fromTo(".r${i}", {scaleX:0}, {scaleX:1, duration:0.5, ease:"power3.out"}, ${f(s + 0.25)});`);
+    tw.push(`tl.fromTo(".w${i}", {opacity:0, y:46}, {opacity:1, y:0, duration:0.45, stagger:0.09, ease:"power3.out"}, ${f(s + 0.35)});`);
+    if (!last) tw.push(`tl.to(".c${i}, .n${i}, .r${i}", {opacity:0, duration:0.25}, ${f(s + d - 0.3)});`);
+  }
   return vis + cap;
 }).join("\n");
-tw.push(`tl.fromTo(".it", {opacity:0, y:30}, {opacity:1, y:0, duration:0.5, stagger:0.15, ease:"power3.out"}, 0.1);`);
-tw.push(`tl.fromTo(".im", {rotation:-160, scale:0.6}, {rotation:0, scale:1, duration:1.0, ease:"power3.out"}, 0.0);`);
-tw.push(`tl.fromTo(".em", {rotation:-200, scale:0.5}, {rotation:0, scale:1, duration:1.2, ease:"power3.out"}, ${f(t)});`);
-tw.push(`tl.fromTo(".et", {opacity:0, y:20}, {opacity:1, y:0, duration:0.5, stagger:0.12}, ${f(t + 0.5)});`);
+
+const intro = PART === "body" ? "" : `<section class="clip card" data-start="0" data-duration="${INTRO}" data-track-index="6">`
+  + `<div class="kick ik">현장 스케치</div>${mark(200, "im")}<h1>${words(TITLE, "it")}</h1><div class="line il"></div><p class="is">${esc(SUB)}</p></section>`;
+const end = PART === "body" ? "" : `<section class="clip card" data-start="${f(t)}" data-duration="${END}" data-track-index="6">`
+  + `${mark(230, "em")}<h1 class="et">Elanous</h1><p class="et">사진을 올리면, 영상이 됩니다</p><p class="et red">elanous.ai</p></section>`;
+if (PART !== "body") {
+  tw.push(`tl.fromTo(".ik", {opacity:0, letterSpacing:"0.6em"}, {opacity:1, letterSpacing:"0.28em", duration:0.8, ease:"power3.out"}, 0.1);`);
+  tw.push(`tl.fromTo(".im", {rotation:-160, scale:0.6, opacity:0}, {rotation:0, scale:1, opacity:1, duration:1.0, ease:"power3.out"}, 0.0);`);
+  tw.push(`tl.fromTo(".it", {opacity:0, y:50}, {opacity:1, y:0, duration:0.55, stagger:0.1, ease:"power3.out"}, 0.45);`);
+  tw.push(`tl.fromTo(".il", {scaleX:0}, {scaleX:1, duration:0.6, ease:"power3.inOut"}, 0.9);`);
+  tw.push(`tl.fromTo(".is", {opacity:0, y:16}, {opacity:1, y:0, duration:0.45, ease:"power3.out"}, 1.15);`);
+  tw.push(`tl.fromTo(".em", {rotation:-200, scale:0.5}, {rotation:0, scale:1, duration:1.2, ease:"power3.out"}, ${f(t)});`);
+  tw.push(`tl.fromTo(".et", {opacity:0, y:20}, {opacity:1, y:0, duration:0.5, stagger:0.14, ease:"power3.out"}, ${f(t + 0.5)});`);
+}
+tw.unshift(`tl.set(".wipe", {scaleY:0}, 0);`);
 tw.push(`tl.fromTo(".bar i", {scaleX:0}, {scaleX:1, duration:${TOTAL}, ease:"none"}, 0);`);
+const audio = music ? `<audio id="bgm" src="assets/media/${music}" data-start="0" data-duration="${TOTAL}" data-track-index="9"></audio>` : "";
 const html = `<!doctype html><html lang="ko"><head><meta charset="UTF-8"/><meta name="viewport" content="width=${W}, height=${H}"/><title>${esc(TITLE)}</title><script src="assets/gsap.min.js"></script><style>
 @font-face{font-family:"Pretendard";src:url("assets/fonts/Pretendard-Bold.woff2") format("woff2");font-weight:700}
 @font-face{font-family:"Pretendard";src:url("assets/fonts/Pretendard-ExtraBold.woff2") format("woff2");font-weight:800}
 @font-face{font-family:"Pretendard";src:url("assets/fonts/Pretendard-Black.woff2") format("woff2");font-weight:900}
 *{margin:0;padding:0;box-sizing:border-box}
 #root{position:relative;width:100%;height:100%;overflow:hidden;background:#000;font-family:"Pretendard",sans-serif;color:#F2F1EE;word-break:keep-all}
-.med{position:absolute;inset:0;width:100%;height:100%;object-fit:cover;overflow:hidden}
+.med{position:absolute;inset:0;width:100%;height:100%;overflow:hidden}
+.g{position:absolute;inset:0;overflow:hidden}
 .kb{width:100%;height:100%;object-fit:cover;display:block}
-.shade{z-index:2;position:absolute;left:0;right:0;bottom:0;height:46%;background:linear-gradient(to top,rgba(0,0,0,.78),rgba(0,0,0,0));pointer-events:none}
+.fill{position:absolute;inset:0;width:100%;height:100%;object-fit:cover;filter:blur(42px) saturate(1.2);opacity:.85}
+.dim{position:absolute;inset:0;background:rgba(0,0,0,.42)}
+.frame{position:absolute;left:0;right:0;top:420px;height:960px;overflow:hidden;box-shadow:0 30px 80px rgba(0,0,0,.55)}
+.frame img{width:100%;height:100%;object-fit:cover;display:block}
+.shade{z-index:3;position:absolute;left:0;right:0;bottom:0;height:42%;background:linear-gradient(to top,rgba(0,0,0,.82),rgba(0,0,0,0));pointer-events:none}
 .top{z-index:5;position:absolute;left:56px;right:56px;top:72px;display:flex;align-items:center;gap:18px;font-weight:800;font-size:34px;text-shadow:0 2px 12px rgba(0,0,0,.6)}
 .top b{color:#E95047;font-weight:800}
-.capw{z-index:4;position:absolute;left:64px;right:64px;bottom:250px}
-.cap{font-weight:800;font-size:64px;line-height:1.25;letter-spacing:-0.02em;text-shadow:0 3px 16px rgba(0,0,0,.7)}
-.card{z-index:6;position:absolute;inset:0;background:#000;display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;padding:0 80px}
-.card h1{margin-top:60px;font-weight:900;font-size:104px;line-height:1.1;letter-spacing:-0.03em}
-.card p{margin-top:28px;font-weight:700;font-size:40px;color:rgba(242,241,238,.62)}
+.capw{z-index:4;position:absolute;left:64px;right:64px;bottom:210px}
+.no{font-weight:800;font-size:34px;letter-spacing:.12em;color:#E95047}
+.no i{font-style:normal;color:rgba(242,241,238,.55)}
+.cap{margin-top:18px;font-weight:900;font-size:76px;line-height:1.18;letter-spacing:-0.03em;text-shadow:0 3px 18px rgba(0,0,0,.7)}
+.w{display:inline-block}
+.rule{margin-top:26px;width:120px;height:8px;background:#E95047;transform-origin:0 50%}
+.wipe{z-index:8;position:absolute;inset:0;background:#E95047}
+.card{z-index:7;position:absolute;inset:0;background:#000;display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;padding:0 80px}
+.kick{margin-bottom:56px;font-weight:800;font-size:32px;letter-spacing:.28em;color:#E95047}
+.card h1{margin-top:56px;font-weight:900;font-size:100px;line-height:1.12;letter-spacing:-0.03em}
+.card h1 span{display:inline-block}
+.line{margin-top:40px;width:160px;height:8px;background:#E95047}
+.card p{margin-top:28px;font-weight:700;font-size:42px;color:rgba(242,241,238,.66)}
 .card .red{color:#E95047}
-.bar{z-index:7;position:absolute;left:0;right:0;bottom:0;height:10px;background:rgba(242,241,238,.12)}
+.bar{z-index:9;position:absolute;left:0;right:0;bottom:0;height:10px;background:rgba(242,241,238,.12)}
 .bar i{position:absolute;inset:0;background:#E95047;transform-origin:0 50%;display:block}
 </style></head><body>
 <div id="root" data-composition-id="main" data-start="0" data-width="${W}" data-height="${H}" data-duration="${TOTAL}">
-<section class="clip card" data-start="0" data-duration="${INTRO}" data-track-index="5">${mark(220, "im")}<h1 class="it">${esc(TITLE)}</h1>${SUB ? `<p class="it">${esc(SUB)}</p>` : ""}</section>
+${intro}
 ${clips}
 <div class="shade"></div>
 <div class="top">${mark(60)}<span>Elanous <b>·</b> ${esc(TITLE)}</span></div>
-<section class="clip card" data-start="${f(t)}" data-duration="${END}" data-track-index="5">${mark(240, "em")}<h1 class="et">Elanous</h1><p class="et">현장에서 바로 만든 영상</p><p class="et red">elanous.ai</p></section>
+<div class="wipe"></div>
+${end}
 <div class="bar"><i></i></div>
+${audio}
 </div>
 <script>const tl = gsap.timeline({ paused: true });
 ${tw.join("\n")}
@@ -124,5 +230,6 @@ window.__timelines["main"] = tl;</script></body></html>`;
 writeFileSync(join(hf, "index.html"), html);
 writeFileSync(join(hf, "hyperframes.json"), JSON.stringify({ $schema: "https://hyperframes.heygen.com/schema/hyperframes.json", paths: { assets: "assets" }, media: { autoProxy: true } }, null, 2) + "\n");
 writeFileSync(join(hf, "meta.json"), JSON.stringify({ id: "reel", name: "reel" }, null, 2) + "\n");
-writeFileSync(join(out, "timeline.json"), JSON.stringify({ total: TOTAL, items: items.map(({ f: file, video, start, dur, cap }) => ({ file, video, start, dur: f(dur), cap })) }, null, 2));
-console.log(`reel: ${items.length} items · ${TOTAL}s · ${items.filter((i) => i.cap).length} captions → ${hf}`);
+writeFileSync(join(out, "timeline.json"), JSON.stringify({ total: TOTAL, part: PART, title: TITLE, sub: SUB, music: Boolean(music),
+  vision: { enabled: VISION, calls: jobs.length, captioned: items.filter((i) => i.vcap).length, fallback: items.filter((i) => !i.video && !caps[i.f] && !i.vcap).length, ms: visionMs }, items: items.map(({ f: file, video, start, dur, cap, vcap }) => ({ file, video, start, dur: f(dur), cap, vision: Boolean(vcap) })) }, null, 2));
+console.log(`reel: ${items.length} items · ${TOTAL}s · ${items.filter((i) => i.vcap).length} vision captions · music ${music ? "on" : "off"} → ${hf}`);

package/skills/explainer-video/engine/reel.sh

@@ -1,8 +1,9 @@
 #!/bin/zsh
 # Field reel in one command: folder of phone photos/clips → <folder>/reel/<name>-9x16.mp4 · prints the elapsed seconds.
+# The layout/contrast check is advisory: phone photos behind captions often miss 3:1, and a failed check must not stop the reel.
 # Usage: zsh reel.sh <folder> [--title "…"] [--sub "…"]   (captions: <folder>/captions.txt — `파일 | 자막`)
 E=${0:A:h}; F=${1:A}; shift
 [[ -d $F ]] || { print -u2 "reel: no folder $F"; exit 2 }
 T0=$(date +%s)
-rm -rf $F/reel && node $E/reel.mjs $F "$@" && (cd $F/reel/hf && npx -y hyperframes@${HYPERFRAMES_VERSION:-0.8.95} check >../render.log 2>&1 && npx -y hyperframes@${HYPERFRAMES_VERSION:-0.8.95} render --fps 30 --workers 4 --output ../reel-9x16.mp4 >>../render.log 2>&1) || { print -u2 "reel: FAILED — see $F/reel/render.log"; exit 1 }
+rm -rf $F/reel && node $E/reel.mjs $F "$@" && (cd $F/reel/hf && { npx -y hyperframes@${HYPERFRAMES_VERSION:-0.8.95} check >../render.log 2>&1 || print "reel: check reported issues (continuing — user photos vary; see above)" >>../render.log }; npx -y hyperframes@${HYPERFRAMES_VERSION:-0.8.95} render --fps 30 --workers 4 --output ../reel-9x16.mp4 >>../render.log 2>&1) || { print -u2 "reel: FAILED — see $F/reel/render.log"; exit 1 }
 print "reel: $F/reel/reel-9x16.mp4 · $(( $(date +%s) - T0 ))s"

package/skills/explainer-video/examples/elanous-0.2.5/script.json

@@ -5,7 +5,7 @@
     "name": "Seulki",
     "model": "eleven_v3"
   },
-  "sources": "docs/marketing (LAUNCH-0.2.5 초안) · PR #21849 #21887 #21878 #21855 #22054 #21908 #21995 #22001 — 전부 컷 e24cb6e 안 MERGED",
+  "sources": "elanous 0.2.5 release notes — https://github.com/ElanvitalAI/elanous/releases/tag/v0.2.5",
   "intro": {
     "beats": [
       {

package/skills/grill-me/SKILL.md

@@ -123,7 +123,7 @@ requires: []
 | 다음 | 언제 | 어떻게 |
 |---|---|---|
 | 🧹 **`first-principles`** | 요구가 많이 나왔을 때 | ⭐ ***캐낸 다음엔 «지운다»*** — 5단계 ①의심 ②삭제 가 순서상 여기다 |
-| 🎯 **골 문면** (`docs/goals/`) | 하니스가 구현할 일일 때 | 카드의 `S`·`C`·`Q` 가 그대로 ask 의 세 칸이 된다 |
+| 🎯 **골 문면** (골 파일) | 하니스가 구현할 일일 때 | 카드의 `S`·`C`·`Q` 가 그대로 ask 의 세 칸이 된다 |
 | 📄 **문서** (`docs/`) | 결정을 남길 일일 때 | `## ✅ 정해진 것` 표가 그대로 결정 기록이다 |
 | 🧑‍🤝‍🧑 **팀 짜기** | 일이 여럿으로 갈릴 때 | ⭐ 목표를 심은 뒤 *"이 일을 할 팀을 짜 보라"* — 인터뷰의 «응용»이다 |
 

package/skills/omni-digest/docs/diagrams/noncode-terminal-promotion-path-2026-08-13.mmd

@@ -14,7 +14,7 @@ flowchart TD
   H{nonCodeOutcome exists?}:::gate
   I[observe deploy-no-changes<br/>return { ok:false, kind:none }]:::fail
   J{Evidence is artifact-created?}:::gate
-  K{PR #8731 · 2026-08-13<br/>existsSync(resolve(cwd, ref))?}:::gate
+  K{2026-08-13<br/>existsSync(resolve(cwd, ref))?}:::gate
   L[observe deploy-noncode-blocked<br/>reason: artifact-created-ref-missing<br/>then deploy-no-changes]:::fail
   M[Do not treat ref as a file<br/>published-url / execution-completed]:::data
   N[observe deploy-noncode<br/>return terminal:<br/>published or executed]:::pass

package/src/a2a/server.ts

@@ -91,6 +91,8 @@ export function startA2AServer(opts: A2AServerOptions): Bun.Server<undefined> {
     history ??= new DaemonSessionHistory();
     const result = await (opts.runDaemonTurn ?? runDaemonPromptTurn)({
       history,
+      // A peer agent delegates work, not small talk: never drop its tools for a short message (#22430 fast path).
+      fastPathEnabled: false,
       request: {
         sessionId: contextId,
         userText: text,

package/src/acp/elanous-aware-peers.ts

@@ -0,0 +1,30 @@
+import type { ClientCapabilities } from '@agentclientprotocol/sdk';
+
+/** The server's sessionPeers registry remains the source of truth for which
+ * connections are attached to a session. Awareness belongs to the connection,
+ * not the session: a plain client can load an aware client's session. */
+export class ElanousAwarePeers<Peer extends object> {
+  private readonly aware = new WeakSet<Peer>();
+
+  constructor(private readonly sessionPeers: ReadonlyMap<string, ReadonlySet<Peer>>) {}
+
+  markPeer(connectionOrSessionId: Peer, clientCapabilities: ClientCapabilities | undefined | null): void {
+    const elanous = (clientCapabilities?._meta as Record<string, unknown> | undefined)?.elanous;
+    if (elanous !== null && typeof elanous === 'object' && !Array.isArray(elanous)) {
+      this.aware.add(connectionOrSessionId);
+    } else {
+      this.aware.delete(connectionOrSessionId);
+    }
+  }
+
+  isPeerAware(peer: Peer): boolean {
+    return this.aware.has(peer);
+  }
+
+  isElanousAware(sessionId: string): boolean {
+    for (const peer of this.sessionPeers.get(sessionId) ?? []) {
+      if (this.isPeerAware(peer)) return true;
+    }
+    return false;
+  }
+}