elanous 0.2.0 → 0.2.4

package/scripts/se-mission-prepare.ts

@@ -24,6 +24,7 @@ import { notifyMissionOrigin, notifyMissionHitl, notifyMissionDocument, resolveT
 import { proposalDraftPath } from '../src/autopilot/build/build-target.js';
 import { applyConfigDirFlagFromArgv } from '../src/cli/config-dir-flag.js';
 import { debug } from '../src/debug/log.js';
+import { inferPhaseTrack, loadTrackRegistry } from '../src/autopilot/mission-phase-track.js';
 import { reportDecomposeFailureHitl } from './se-mission-prepare-cause.js';
 
 // ★ 인스턴스 스코프 상속(ISO·2026-07-14) — 부모 데몬(mission-prepare-spawn)이 argv 로 넘긴
@@ -232,7 +233,13 @@ function collectDecompPhases(mid: string): { decompPhases: DecompPhase[]; phaseL
   const phases = new TaskStore();
   try {
     const t = phases.listTasks({ goalSlug: mid }).sort((a, b) => a.createdAt - b.createdAt);
-    const phaseLines = t.slice(0, 10).map((x, i) => `  ${i}. ${x.title}`).join('\n');
+    const registry = loadTrackRegistry();
+    const phaseLines = t.map((x, i) => {
+      const result = inferPhaseTrack(`${x.title}\n${x.surface.kind === 'subagent' ? x.surface.prompt : ''}`, registry);
+      try { debug.log('mission.prepare', 'phase-track', { missionId: mid, taskId: x.id, track: result.track, reason: result.reason, hits: result.hits }); } catch { /* fail-soft */ }
+      if (!registry.length) return `  ${i}. ${x.title}`;
+      return result.track ? `  ${i}. ${result.mark} ${x.title}` : `  ${i}. ❔ ${x.title} (트랙 미정 → 🅢)`;
+    }).slice(0, 10).join('\n');
     const decompPhases: DecompPhase[] = t.filter((x) => x.surface.kind === 'subagent').map((x) => ({
       id: x.id, title: x.title,
       prompt: x.surface.kind === 'subagent' ? x.surface.prompt : x.title,
@@ -423,20 +430,7 @@ const buildImpls: import('../src/autopilot/mission-build-orchestrate.js').StageI
     //   Opus 재분해). 실측: universal-content 분해가 sol 스키마 위반으로 실패했으나 Opus 면 성공 가능.
     const errStr = r.error ?? '';
     const transientFailed = !r.ok && !decomposeModelOverride && (isTransientLlmError(errStr) || /VALIDATION_FAILED|PARSE_FAILED|schema violation/i.test(errStr));
-    let phaseLines = '';
-    let decompPhases: { id: string; title: string; prompt: string; acceptance: string[]; dependsOn: string[] }[] = [];
-    const phases = new TaskStore();
-    try {
-      const t = phases.listTasks({ goalSlug: missionId }).sort((a, b) => a.createdAt - b.createdAt);
-      phaseLines = t.slice(0, 10).map((x, i) => `  ${i}. ${x.title}`).join('\n');
-      decompPhases = t.filter((x) => x.surface.kind === 'subagent').map((x) => ({
-        id: x.id, title: x.title,
-        prompt: x.surface.kind === 'subagent' ? x.surface.prompt : x.title,
-        acceptance: x.acceptance?.criteria ? [...x.acceptance.criteria] : [],
-        // ★ 사전정보(축③) — 비평기가 상류 계약 출처(dependsOn)를 알고 고립 판정 방지.
-        dependsOn: [...x.dependsOn],
-      }));
-    } finally { phases.close(); }
+    const { phaseLines, decompPhases } = collectDecompPhases(missionId);
     return { ok: r.ok, phaseCount, error: r.error ?? '', transientFailed, decompPhases, phaseLines };
   },
   // critique — D1 적대적 비평(heavy·decompPhases).

package/scripts/test-deterministic.ts

@@ -38,6 +38,7 @@ import { join } from 'node:path';
 // behind `import.meta.main` / `runDeterministicTests()`, but the filter stays
 // in the helper so an untested credential check cannot rot silently.
 import { isCredentialKey } from './lib/deterministic-env.js';
+import { envLiteral } from '../src/platform/env-literal.js';
 
 export const TEMP_ROOT_PREFIX = 'elanous-deterministic-test-';
 export const CHILD_EXIT_GRACE_MS = 2_000;
@@ -274,7 +275,7 @@ export function prepareIsolatedTestEnv(sourceEnv: NodeJS.ProcessEnv, testRoot: s
   // while guaranteeing nothing — a later test could branch on it believing it
   // means something. The tier work in PLAN-test-suite-diet introduces the
   // signal together with the code that honours it.
-  return env;
+  return envLiteral(env);
 }
 
 const defaultSpawn: SpawnDirectChild = (opts) => Bun.spawn({

package/scripts/uninstall.sh

@@ -3,7 +3,7 @@
 #   bash scripts/uninstall.sh [--prefix PATH] [--keep-path] [--dry-run]
 #   curl -fsSL https://github.com/ElanvitalAI/elanous/releases/latest/download/uninstall.sh | bash
 #
-# 지우는 것: 설치 폴더($PREFIX — versions/·current·bin/·install.json) ⊕ 설치기가 쓴 PATH 블록(마커 사이 · ~/.zshrc·~/.bashrc·~/.profile).
+# 지우는 것: 설치 폴더($PREFIX — versions/·current·bin/·install.json) ⊕ 설치기가 쓴 PATH 블록(마커 사이 · ~/.zshrc·~/.zshenv·~/.bashrc·~/.profile).
 # ⛔ 설치 폴더를 «통째로» 지우지 않는다 — 설치물 넷만 지우고, 그 밖의 것이 남으면 폴더를 지킨다.
 #    🩸 09-25: 기억 저장소 기본 위치가 ${XDG_DATA_HOME:-~/.local/share}/elanous/memory — 설치 폴더 «안»이라 `rm -rf $PREFIX` 가 사용자 기억을 지웠다.
 # ⛔ 지우지 «않는» 것: 상태 폴더 ~/.elanous(로그인·로그·원장·설정) — 되돌릴 수 없으니 사람이 직접 지운다(경로만 알려 준다).
@@ -47,7 +47,7 @@ fi
 MARKER_START='# >>> elanous installer PATH >>>'
 MARKER_END='# <<< elanous installer PATH <<<'
 STARTUPS=()
-for f in "${ELANOUS_SHELL_STARTUP:-}" "$HOME/.zshrc" "$HOME/.bashrc" "$HOME/.profile"; do
+for f in "${ELANOUS_SHELL_STARTUP:-}" "$HOME/.zshrc" "$HOME/.zshenv" "$HOME/.bashrc" "$HOME/.profile"; do
   [ -n "$f" ] && [ -f "$f" ] && grep -Fqx "$MARKER_START" "$f" && STARTUPS+=("$f")
 done
 
@@ -55,7 +55,14 @@ echo "remove: $PREFIX/{versions,current,bin,install.json}"
 if [ "$KEEP_PATH" -eq 0 ]; then for f in "${STARTUPS[@]+"${STARTUPS[@]}"}"; do echo "remove PATH block: $f"; done; fi
 if [ "$DRY" -eq 1 ]; then echo "(dry run — nothing changed)"; exit 0; fi
 
-for item in versions current bin install.json; do rm -rf -- "${PREFIX:?}/$item"; done
+rm -rf -- "${PREFIX:?}/versions" "$PREFIX/current" "$PREFIX/install.json"
+# bin may contain a different eln (or other user commands); remove only our marked alias.
+ELN="$PREFIX/bin/eln"
+if [ -f "$ELN" ] && [ ! -L "$ELN" ] && [ "$(sed -n '2p' "$ELN")" = '# elanous-wrapper' ]; then
+  rm -f -- "$ELN"
+fi
+rm -f -- "$PREFIX/bin/elanous" "$PREFIX/bin/bun"
+rmdir -- "$PREFIX/bin" 2>/dev/null || true
 KEPT=""
 if ! rmdir -- "$PREFIX" 2>/dev/null; then KEPT="$(ls -A -- "$PREFIX" 2>/dev/null | tr '\n' ' ')"; fi
 if [ "$KEEP_PATH" -eq 0 ]; then

package/scripts/video-broll-line.ts

@@ -0,0 +1,89 @@
+#!/usr/bin/env bun
+/** Walk the B-roll declaration with a per-slot authoring agent and a measured render. */
+import { existsSync, mkdirSync, readFileSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, parse, resolve } from 'node:path';
+import { registerStandaloneLogSink } from '../src/domains/standalone-log-sink.js';
+import { writeStdoutJson } from '../src/cli/stdout-json.js';
+import { createBrollAgent } from '../src/video-pipeline/broll-agent.js';
+import type { BrollAgent, BrollRun } from '../src/video-pipeline/recipes/broll.js';
+import { exitCodeOf, formatStep, loadWalker, walkLine } from '../src/video-pipeline/walk-line.js';
+import { parseArgv, type FlagKind } from './lib/argv.js';
+
+const FLAGS: Record<string, FlagKind> = {
+  '--video': 'value', '--audio': 'value', '--words': 'value', '--clips-dir': 'value',
+  '--density': 'value', '--agent': 'value', '--clip-timeout-sec': 'value', '--json': 'bool',
+};
+
+export interface BrollLineDeps {
+  loadWalker?: typeof loadWalker;
+  walk?: typeof walkLine;
+  createAgent?: typeof createBrollAgent;
+  run?: BrollRun;
+  registerLogSink?: typeof registerStandaloneLogSink;
+  writeJson?: (line: string) => Promise<void>;
+}
+
+export async function main(argv: readonly string[], deps: BrollLineDeps = {}): Promise<number> {
+  const parsed = parseArgv(argv, { known: FLAGS, label: 'video-broll-line' });
+  const { values, flags } = parsed;
+  const backend = values.agent ?? 'codex';
+  const density = Number(values.density ?? 5);
+  const timeoutSec = Number(values['clip-timeout-sec'] ?? 600);
+  const errors = [...parsed.errors];
+  if (!values.video) errors.push('--video <경로> 가 필요하다');
+  if (Boolean(values.audio) === Boolean(values.words)) errors.push('--audio <경로> 또는 --words <json> 중 하나가 필요하다');
+  if (!['codex', 'claude', 'elanous'].includes(backend)) errors.push('--agent 는 codex|claude|elanous 중 하나다');
+  if (!Number.isFinite(density) || density <= 0) errors.push('--density 는 양수다');
+  if (!Number.isFinite(timeoutSec) || timeoutSec <= 0) errors.push('--clip-timeout-sec 는 양수다');
+  for (const file of [values.video, values.audio, values.words]) {
+    if (file && !existsSync(resolve(file))) errors.push(`입력 파일을 찾을 수 없다: ${file}`);
+  }
+  let words: unknown;
+  if (values.words && existsSync(resolve(values.words))) {
+    try { words = JSON.parse(readFileSync(resolve(values.words), 'utf8')); }
+    catch { errors.push('--words JSON 을 읽을 수 없다'); }
+  }
+  if (errors.length) { for (const error of errors) console.error(`⛔ ${error}`); return 2; }
+
+  await (deps.registerLogSink ?? registerStandaloneLogSink)('video-broll-line');
+  const walker = await (deps.loadWalker ?? loadWalker)();
+  if (!walker) { console.error('➖ 워커를 못 찾았다 — GRAPH_WALKER 를 지정하라'); return 2; }
+  const { spec, error } = walker.readGraphSpec(join(import.meta.dir, '../graphs/video/broll-line.yaml'));
+  if (!spec) { console.error(`⛔ B-roll 선언을 못 읽었다: ${error}`); return 2; }
+
+  const video = realpathSync(resolve(values.video!));
+  const requestedDir = resolve(values['clips-dir'] ?? join(homedir(), 'Movies', 'monad', 'broll',
+    `${parse(video).name}-${new Date().toISOString().replace(/[:.]/g, '-')}`));
+  mkdirSync(requestedDir, { recursive: true });
+  // Recipes compare real paths; on macOS /var is a link to /private/var, so the work folder must be canonical.
+  const clipsDir = realpathSync(requestedDir);
+  const workdir = clipsDir;
+  const agent = (deps.createAgent ?? createBrollAgent)({
+    backend: backend as 'codex' | 'claude' | 'elanous', clipsDir,
+    skillDir: join(import.meta.dir, '../skills/motion-broll'),
+  });
+  const state: Record<string, unknown> = {
+    base_video: video,
+    ...(values.audio ? { audio_path: resolve(values.audio) } : { aligned_words: words }),
+    clips_dir: clipsDir,
+    density_target: density,
+    clip_timeout_ms: timeoutSec * 1000,
+    broll_agent: agent satisfies BrollAgent,
+    ...(deps.run ? { broll_run: deps.run } : {}),
+  };
+  const quiet = flags.has('json');
+  const result = await (deps.walk ?? walkLine)({ spec, walker, state, workdir,
+    onStep: (row) => { if (!quiet) console.log(formatStep(row, 11)); },
+  });
+  const summary = {
+    terminal: result.terminal,
+    clips: Array.isArray(state.broll_clips) ? state.broll_clips.length : 0,
+    skipped: Array.isArray(state.skipped_clips) ? state.skipped_clips.length : 0,
+    rendered_path: typeof state.rendered_path === 'string' ? state.rendered_path : null,
+  };
+  await (deps.writeJson ?? writeStdoutJson)(JSON.stringify(summary) + '\n');
+  return exitCodeOf(result.terminal);
+}
+
+if (import.meta.main) process.exitCode = await main(process.argv.slice(2));

package/scripts/waitlist-daily-digest.ts

@@ -0,0 +1,108 @@
+#!/usr/bin/env bun
+// ── elanous.ai 출시 알림 명단 — 하루 한 번 텔레그램 정리 (대표 2026-09-28) ─────────────────
+//
+// 명단 원천 = Resend 오디언스(사이트 `api/confirm.js` 가 «확인 링크를 누른» 주소만 올린다 · 더블 옵트인).
+// 자격 = Elanous 비밀 저장소 `resend-api-key` · `resend-audience-id`(값을 출력·로그하지 않는다).
+// 상태 = `<state>/conatus/waitlist_digest_state.json` — 지난 보고 때 본 연락처 id 목록(«새로 온 사람»을 가른다).
+//
+// 보고: 전체 명단 수 · 어제 보고 뒤 새로 확인된 주소(목록) · 구독 해지 수. 새 사람이 없어도 하루 한 번 수는 보낸다.
+// ⛔ 조회 실패도 알린다(«못 쟀다»를 조용히 넘기지 않는다).
+//
+// cron: 0 9 * * *  (KST 09:00 · `scripts/cron-run.ts` 로 감싼다)
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+export interface WaitlistContact { id: string; email: string; created_at?: string; unsubscribed?: boolean }
+
+export interface DigestDeps {
+  fetchContacts: () => Promise<WaitlistContact[]>;
+  readState: () => { seen: string[]; lastAt?: string } | null;
+  writeState: (s: { seen: string[]; lastAt: string }) => void;
+  send: (text: string) => boolean;
+  now?: () => Date;
+}
+
+export function formatDigest(contacts: readonly WaitlistContact[], seen: ReadonlySet<string>, firstRun: boolean): string {
+  const active = contacts.filter((c) => !c.unsubscribed);
+  const unsub = contacts.length - active.length;
+  const fresh = firstRun ? [] : active.filter((c) => !seen.has(c.id))
+    .sort((a, b) => (a.created_at ?? '').localeCompare(b.created_at ?? ''));
+  const lines = [
+    `📮 **elanous.ai 출시 알림 명단** — 전체 **${active.length}**명${unsub ? ` · 해지 ${unsub}` : ''}`,
+  ];
+  if (firstRun) lines.push('(첫 보고 — 지금까지의 명단을 기준으로 삼습니다. 내일부터 새로 온 분을 따로 보여 드립니다.)');
+  else if (fresh.length === 0) lines.push('어제 보고 뒤 새로 확인된 분: 없음');
+  else {
+    lines.push(`어제 보고 뒤 새로 확인된 분: **${fresh.length}**명`);
+    for (const c of fresh.slice(0, 30)) lines.push(`  • ${c.email}${c.created_at ? ` · ${kst(c.created_at)}` : ''}`);
+    if (fresh.length > 30) lines.push(`  … 외 ${fresh.length - 30}명`);
+  }
+  return lines.join('\n');
+}
+
+function kst(iso: string): string {
+  const d = new Date(iso.replace(' ', 'T').replace(/(\+00)?$/, iso.includes('+') || iso.endsWith('Z') ? '' : 'Z'));
+  if (Number.isNaN(d.getTime())) return iso.slice(0, 16);
+  return new Date(d.getTime() + 9 * 3_600_000).toISOString().slice(5, 16).replace('T', ' ') + ' KST';
+}
+
+export async function runWaitlistDigest(deps: DigestDeps): Promise<{ sent: boolean; total: number; fresh: number }> {
+  const now = (deps.now ?? (() => new Date()))();
+  let contacts: WaitlistContact[];
+  try {
+    contacts = await deps.fetchContacts();
+  } catch (err) {
+    const reason = err instanceof Error ? err.message.replace(/re_[A-Za-z0-9_]+/g, '***').slice(0, 160) : String(err).slice(0, 160);
+    deps.send(`⚠️ **elanous.ai 출시 알림 명단 조회 실패** — 오늘 정리를 못 보냅니다.\n사유: \`${reason}\``);
+    return { sent: false, total: 0, fresh: 0 };
+  }
+  const prev = deps.readState();
+  const seen = new Set(prev?.seen ?? []);
+  const text = formatDigest(contacts, seen, prev === null);
+  const freshCount = prev === null ? 0 : contacts.filter((c) => !c.unsubscribed && !seen.has(c.id)).length;
+  const sent = deps.send(text);
+  // 발송이 실패하면 상태를 전진시키지 않는다 — 다음 번에 같은 «새로 온 분»을 다시 보낸다.
+  if (sent) deps.writeState({ seen: contacts.map((c) => c.id), lastAt: now.toISOString() });
+  return { sent, total: contacts.filter((c) => !c.unsubscribed).length, fresh: freshCount };
+}
+
+async function resendContacts(apiKey: string, audienceId: string): Promise<WaitlistContact[]> {
+  const res = await fetch(`https://api.resend.com/audiences/${encodeURIComponent(audienceId)}/contacts`, {
+    headers: { Authorization: `Bearer ${apiKey}` },
+    signal: AbortSignal.timeout(20_000),
+  });
+  if (!res.ok) throw new Error(`Resend ${res.status}`);
+  const body = await res.json() as { data?: WaitlistContact[] };
+  return Array.isArray(body.data) ? body.data : [];
+}
+
+export async function main(): Promise<void> {
+  const { ensureCronNodePath } = await import('../src/domains/cron-path.js');
+  ensureCronNodePath();
+  const { registerStandaloneLogSink } = await import('../src/domains/standalone-log-sink.js');
+  try { await registerStandaloneLogSink('waitlist-daily-digest'); } catch { /* 관측 실패가 보고를 막지 않는다 */ }
+  const { getSecret } = await import('../src/nexus/config/secrets/index.js');
+  const { sendOutbound } = await import('../src/domains/outbound-alert.js');
+  const { elanousStateRoot } = await import('../src/autopilot/state-paths.js');
+  const { debug } = await import('../src/debug/log.js');
+  const statePath = join(elanousStateRoot(), 'conatus', 'waitlist_digest_state.json');
+  const apiKey = getSecret('resend-api-key');
+  const audienceId = getSecret('resend-audience-id');
+  const result = await runWaitlistDigest({
+    fetchContacts: () => {
+      if (!apiKey || !audienceId) return Promise.reject(new Error('비밀 저장소에 resend-api-key · resend-audience-id 가 없다'));
+      return resendContacts(apiKey, audienceId);
+    },
+    readState: () => {
+      if (!existsSync(statePath)) return null;
+      try { return JSON.parse(readFileSync(statePath, 'utf8')); } catch { return null; }
+    },
+    writeState: (s) => { mkdirSync(dirname(statePath), { recursive: true }); writeFileSync(statePath, JSON.stringify(s)); },
+    send: (text) => sendOutbound(text, 'report'),
+  });
+  debug.log('waitlist.digest', 'reported', result);
+  console.log(`[waitlist-daily-digest] sent=${result.sent} total=${result.total} fresh=${result.fresh}`);
+}
+
+if (import.meta.main) await main();

package/scripts/window-landings.sh

@@ -32,7 +32,7 @@ echo "📍 시점:  $(date -u '+%Y-%m-%dT%H:%M:%SZ')  (이 값은 «이 순간
 #   search API 가 「그날 이후 병합 총 수」를 «조건»으로 답하므로, 그 수 + 여유로 limit 를 «한 번에» 맞춘다.
 #   ⛔ search 자체는 headRefName 을 «안 준다» — 그래서 조회는 여전히 pr list 로 하고, search 는 «크기만» 답한다.
 DAY="${SINCE%%T*}"
-TOTAL="$(bun "$REPO_BIN" gh api "search/issues?q=repo:ElanvitalAI/monad+is:pr+is:merged+merged:>=$DAY&per_page=1" --jq '.total_count' 2>/dev/null | tail -1)"
+TOTAL="$(bun "$REPO_BIN" gh api "search/issues?q=repo:ElanvitalAI/elanous+is:pr+is:merged+merged:>=$DAY&per_page=1" --jq '.total_count' 2>/dev/null | tail -1)"
 if [ -n "${TOTAL:-}" ] && [ "$TOTAL" -gt 0 ] 2>/dev/null; then
   LIMIT=$(( TOTAL * 2 + 100 ))
   echo "📏 창 크기: search API ⇒ merged:>=$DAY 총 ${TOTAL}건 ⇒ 상한을 ${LIMIT} 로 «맞춘다»"

package/skills/motion-broll/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Bart
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The Geist and Geist Mono fonts in skills/motion-broll/engine/fonts are
+licensed separately under the SIL Open Font License 1.1 (see OFL-Geist.txt).
+Icon paths are adapted from Lucide (ISC License).

package/skills/motion-broll/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: motion-broll
+description: Turn a talking-head video and its transcript into motion-graphic B-roll timed to the speaker's words, in a continuous one-shape style (one element that morphs and never cuts, driven by a cursor, spring motion). Use when someone gives a video (and ideally a transcript) and asks for motion graphics, B-roll, animated cutaways or overlays.
+requires: []
+---
+
+# Motion B-roll
+
+You make motion-graphic clips for a creator's video. Every clip is **one shape that never cuts**: it morphs its size, corners and colour from state to state while its content swaps with a short blur. A cursor drives the changes with real clicks and drags, and every change lands on a spoken word.
+
+The output is a set of clips the creator drops into their editor. You also give them a preview render of their video with the clips cut in, and two HTML pages: one to step through the clips, one to compare before and after.
+
+Everything you need is in this skill folder:
+
+- `engine/`: the motion engine (`motion.js`), the page shell (`base.css`), `build.py` (clip → self-contained HTML), `render.js` (frame-by-frame render with motion blur), `beats.js` (contact sheets of stills), fonts (Geist, OFL).
+- `scripts/`: `setup.sh`, `inspect_video.py`, `words.py`, `composite.py`, `make_pages.py`.
+- `reference/engine-api.md`: how to write a clip. **Read it before writing your first clip.**
+- `examples/opus-aoe2/`: six finished clips for a real 54-second video. Use them as the quality bar and as starting points.
+
+Below, `$SKILL` means this skill's folder. Work in a `motion/` folder in the user's project.
+
+## 1. Set up (first run only)
+
+```bash
+bash $SKILL/scripts/setup.sh ./motion
+```
+
+This checks for Node, Python 3 and ffmpeg, and installs Playwright + Chromium into `motion/node_modules`. Run every engine script with `NODE_PATH=./motion/node_modules`.
+
+## 2. Interview
+
+Use the AskUserQuestion tool; keep it to one round. You need:
+
+- **The video.** A path. Copy or reference it as `motion/work/source.*`.
+- **The transcript.** An SRT or VTT with timestamps is best. With plain text only, get word timestamps from the audio (`pip install faster-whisper`) or ask for an SRT.
+- **Density:**
+  - Light: 2–4 clips per minute, only the strongest moments.
+  - Medium (default): 4–7 per minute.
+  - Heavy: most lines covered, with short gaps of face.
+- **Look:**
+  - The default palette: warm gray canvas, black and white components, one orange accent.
+  - Or their brand: colours, and optionally a font. Ask them to drop a logo, screenshots or brand colours into `motion/inputs/`, and read those.
+- **Anything to avoid or include.** Lines to leave on their face, real numbers or names to show, product screenshots to recreate.
+
+Skip any question the user already answered.
+
+## 3. Inspect the footage
+
+```bash
+python3 $SKILL/scripts/inspect_video.py motion/work/source.mp4 motion/work
+python3 $SKILL/scripts/words.py transcript.srt > motion/work/words.txt
+```
+
+Look at `motion/work/contact.png` yourself. `video.json` gives resolution, fps and layout sections:
+- **full:** the speaker fills the frame.
+- **pip:** the speaker is in a box and the rest is empty. It includes the box position and a warning if the box changes size or moves.
+
+Clips must match the video's resolution and fps. Word times from an SRT are estimates (±0.2s); treat them as such.
+
+## 4. Plan, and get approval before any code
+
+Show a table with one row per clip:
+
+| # | In–Out | The line it covers | What the shape does, on which words | Treatment | Why |
+
+**Creative direction: decide how much of the frame each clip takes.** This is the most important call; make it per clip and give the reason.
+
+- **Full-frame cutaway.** The frame is all speaker, and the line describes something to *see*: a product, a process, a comparison, a number, a chapter change.
+  - Cut away for the length of the idea (3–10s), then give the face back.
+  - Don't cut away in the first second of the hook or on personal, emotional or opinion lines.
+  - Leave at least ~2s of face between cutaways.
+- **Panel in the empty space.** The edit already leaves room: a PiP box, a split, a plain region.
+  - Render a transparent clip (`bg:null`) centred in the empty area, sized to stay clear of the speaker's box at every moment.
+  - It can run long (15s+) as one continuous morph, because the speaker stays on screen.
+  - If `inspect_video.py` reports the box changing, ask whether that's intended, then size for the largest box or split the panel at the change.
+- **Nothing.** The line is about the speaker, or it's too close to another clip.
+
+**Content rules:**
+- Show the subject's real objects: the folder, the terminal, the file, the product, the result. Pull them from the words. Map each idea onto an interaction from the vocabulary in `reference/engine-api.md` (pill + click, progress, check, status island, card with a drag, slider, toggle, tabs, chart + tooltip, search/filter, file drag-and-drop, terminal typing, side-by-side comparison, chapter card).
+- **Never invent numbers, quotes, prices or results.** Use relative bars, skeleton text lines or labels taken from the transcript, and list what is illustrative. Put real figures in only when the user gives them.
+- One idea per clip. A continuous stretch (a whole PiP section) can be one long clip with several states.
+- Pace to speech, not music: one change per spoken beat, about 0.4–1.2s apart.
+
+Wait for the user to approve or edit the plan.
+
+## 5. Build
+
+Write one fragment per clip in `motion/clips/NN-name.html`, following `reference/engine-api.md` and the examples. Then build:
+
+```bash
+python3 $SKILL/engine/build.py motion/dist motion/clips/*.html
+```
+
+Put each state change on its word: clip-local time = word time − clip in-point.
+
+## 6. Check stills on the key words
+
+```bash
+NODE_PATH=./motion/node_modules node $SKILL/engine/beats.js motion/dist/NN-name.html motion/work/NN.png 0.4 1.2 2.1 …
+```
+
+Pick the times where each state has settled and a couple of mid-morph moments. Look at every sheet yourself. Fix anything cramped, clipped, unreadable or off-word, or where the cursor leaves the frame. Then check once more. Panel clips render on black in the sheet so you can judge them.
+
+## 7. Render
+
+```bash
+NODE_PATH=./motion/node_modules node $SKILL/engine/render.js motion/dist/NN-name.html motion/out/NN-name_0m32s40.mp4 30000/1001
+```
+
+- Use the video's fps.
+- Panel clips (`bg:null`) must be written to `.mov`, which gives ProRes 4444 with alpha.
+- Name each file by its timeline in-point (`0m32s40` = 0:32.40).
+- Rendering takes 4 subframes per frame, so it is slower than real time. Run two clips in parallel on a multi-core machine.
+
+## 8. Deliver
+
+Write `motion/plan.json` (schema in `reference/engine-api.md`), then:
+
+```bash
+python3 $SKILL/scripts/composite.py motion/plan.json motion/out/preview.mp4
+python3 $SKILL/scripts/make_pages.py motion/plan.json motion/out/preview.mp4
+```
+
+The user gets, all in `motion/out/`:
+- the clips
+- `TIMING.md`: file, in, out, the line it covers, the treatment, and what is illustrative
+- `preview.mp4`: their video with the clips cut in, hard cuts, original audio
+- `viewer.html`: step through the clips
+- `compare.html`: original vs preview, synced, as side by side, stacked or wipe
+
+Say plainly that the preview is for review: for the final cut they place the clips in their own editor, where they can nudge timing, add transitions and mix audio.
+
+## Style defaults
+
+The user's brand overrides these.
+
+- **Colour:** canvas `#E9E7E2`, ink `#0B0B0B`, white components, one accent `#FF5A1F`. Panel clips on dark footage use light shapes (`#F4F2EE`).
+- **Type and icons:** Geist for UI text, Geist Mono for code, file names and terminals. One icon set with one stroke weight (`M.icon`).
+- **Motion:** springs with a tiny overshoot at most. Leading and trailing edges ride different springs so indicators stretch. The camera zooms so each state fills the frame.
+- **Banned:** bouncy easing, particles, glows, gradients on UI chrome, mixed icon strokes, dead time, anything that looks like a template, made-up data.
+
+## Gotchas
+
+- Never put `will-change` on anything the camera scales; text renders blurry.
+- Text swapping inside a morphing container needs its own enter and exit timing (`M.vis` din/lin/lout), or the old and new text overlap.
+- `mix-blend-mode: difference` labels must sit in a layer that has the blend mode itself. A filtered parent isolates them.
+- Items that slide under a highlight need `M.FAST` springs, or the highlight row sits empty for a moment.
+- Keep the cursor inside the frame at every camera zoom, including during morphs.
+- Word estimates from an SRT drift within a cue; put important changes on the first or last word of a cue when you can.
+- A clip ends by holding its last state; the composite holds the last frame if its slot is longer.

package/skills/motion-broll/SOURCE.md

@@ -0,0 +1,6 @@
+# 출처
+
+- 원천: https://github.com/Barty-Bart/motion-graphics (`skills/motion-broll/`) · 커밋 `e8d610adcf946367430c8b43a97aad8059befaad`(2026-09-25) · MIT(원문 = 이 폴더 `LICENSE` · Copyright (c) 2026 Bart)
+- 들인 날: 2026-09-28 · 용도: 공식 팩 elanous-media · video-broll 플러그인의 클립 저작
+- 원천과 달라진 것(고칠 때마다 한 줄):
+  - `SKILL.md` 머리에 `requires: []` 한 줄 — 저장소 스킬 경계 관문(자격·서비스 목록 · 이 스킬은 로컬 도구 Node·Python 3·ffmpeg 만 쓴다).

package/skills/motion-broll/engine/base.css

@@ -0,0 +1,19 @@
+@font-face{font-family:'Geist';src:url(data:font/woff2;base64,__GEIST__) format('woff2');font-weight:100 900}
+@font-face{font-family:'Geist Mono';src:url(data:font/woff2;base64,__GEISTMONO__) format('woff2');font-weight:100 900}
+html,body{margin:0;background:#E9E7E2;overflow:hidden}
+html.alpha,html.alpha body{background:transparent}
+body.preview{height:100vh;background:#1b1b1b}
+html:not(.alpha) body.preview{background:#E9E7E2}
+#wrap{position:relative;transform-origin:50% 50%}
+body.preview #wrap{position:fixed;left:50%;top:calc(50% - 10px)}
+#stage{position:relative;overflow:hidden;font-family:'Geist',system-ui,sans-serif;-webkit-font-smoothing:antialiased;color:#0B0B0B;font-feature-settings:"tnum" 1}
+#world{position:absolute;left:0;top:0;transform-origin:0 0}
+#shape{position:absolute;overflow:hidden;isolation:isolate;box-shadow:0 1px 2px rgba(20,18,14,.06),0 10px 30px -8px rgba(20,18,14,.16)}
+html.alpha #shape{box-shadow:none}
+.L{position:absolute;width:0;height:0;transform-origin:0 0}
+.a{position:absolute}
+.row{position:absolute;display:flex;align-items:center;white-space:nowrap}
+.blend{mix-blend-mode:difference}
+.mono{font-family:'Geist Mono',ui-monospace,monospace}
+svg{display:block;overflow:visible}
+#cursor{position:absolute;left:0;top:0;height:auto;transform-origin:3px 3px;filter:drop-shadow(0 2px 3px rgba(0,0,0,.25));z-index:10}

package/skills/motion-broll/engine/beats.js

@@ -0,0 +1,11 @@
+// NODE_PATH=motion/node_modules node beats.js dist/clip.html out/sheet.png t1 t2 ... -> contact sheet of stills at those times
+const {chromium}=require('playwright');const path=require('path');const {execSync}=require('child_process');const fs=require('fs');
+(async()=>{const [html,out,...ts]=process.argv.slice(2);
+ const b=await chromium.launch();const p=await b.newPage({viewport:{width:1920,height:1080}});const errs=[];p.on('pageerror',e=>errs.push(e.message));
+ await p.goto('file://'+path.resolve(html)+'?render');await p.evaluate(()=>document.fonts.ready);
+ const dir=fs.mkdtempSync('/tmp/bt');const alpha=await p.evaluate(()=>{const a=document.documentElement.classList.contains('alpha');if(a){document.documentElement.style.background='#000';document.body.style.background='#000';}return a;});
+ for(let i=0;i<ts.length;i++){await p.evaluate(t=>seek(t),+ts[i]);await p.screenshot({path:`${dir}/${String(i).padStart(3,'0')}.png`});}
+ await b.close();
+ const cols=Math.min(4,ts.length),rows=Math.ceil(ts.length/cols);
+ execSync(`ffmpeg -loglevel error -y -i ${dir}/%03d.png -vf "scale=640:-1,tile=${cols}x${rows}:padding=4:color=white" -frames:v 1 ${out}`);
+ if(errs.length) console.log('ERR',errs);})();

package/skills/motion-broll/engine/build.py

@@ -0,0 +1,21 @@
+"""Assemble clip fragments + engine + fonts into self-contained HTML files.
+usage: python3 build.py <out_dir> clips/01-name.html [clips/02-name.html ...]"""
+import base64, re, sys, pathlib
+E = pathlib.Path(__file__).resolve().parent
+b64 = lambda p: base64.b64encode(open(p, 'rb').read()).decode()
+CURSOR = '<svg id="cursor" viewBox="0 0 40 56"><path d="M3 3 L3 41 L12.5 32 L19 47 L25.5 44.2 L19.2 29.8 L32 29.8 Z" fill="#0B0B0B" stroke="#fff" stroke-width="2.6" stroke-linejoin="round"/></svg>'
+def build(src, dst):
+    frag = open(src, encoding='utf-8').read()
+    m = re.search(r'<title>(.*?)</title>', frag); title = m.group(1) if m else pathlib.Path(src).stem
+    css = ''.join(re.findall(r'<style>(.*?)</style>', frag, re.S))
+    slot = lambda n: (re.search(rf'<div data-slot="{n}">(.*?)</div><!--/{n}-->', frag, re.S) or [None, ''])[1]
+    js = ''.join(re.findall(r'<script>(.*?)</script>', frag, re.S))
+    base = open(E/'base.css').read().replace('__GEIST__', b64(E/'fonts/Geist-Variable.woff2')).replace('__GEISTMONO__', b64(E/'fonts/GeistMono-Medium.woff2'))
+    html = (f'<!doctype html><html><head><meta charset="utf-8"><title>{title}</title><style>{base}{css}</style></head><body>\n'
+            f'<div id="wrap"><div id="stage"><div id="world">{slot("world")}<div id="shape">{slot("shape")}</div>{slot("over")}</div>{CURSOR}</div></div>\n'
+            f'<script>{open(E/"motion.js").read()}</script><script>{js}</script></body></html>')
+    open(dst, 'w', encoding='utf-8').write(html)
+if __name__ == '__main__':
+    out = pathlib.Path(sys.argv[1]); out.mkdir(parents=True, exist_ok=True)
+    for s in sys.argv[2:]:
+        d = out/(pathlib.Path(s).stem + '.html'); build(s, d); print('built', d)