agent-trellis 0.8.2 → 0.9.1

package/docs/video/generate-video-posters.mjs

@@ -1,204 +0,0 @@
-// Poster-motion demo video: our own posters + slow Ken Burns moves + caption
-// pills + MiniMax TTS. No AI video generation — zero API cost on reruns.
-// Run: node docs/video/generate-video-posters.mjs
-import { execFileSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const repoRoot = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
-const buildDir = join(repoRoot, "docs/video/build-posters");
-const audioDir = join(buildDir, "audio");
-const segDir = join(buildDir, "segments");
-const quickLookDir = "/tmp/trellis-video-posters-ql";
-const outputFile = join(repoRoot, "docs/video/trellis-demo-video.mp4");
-for (const dir of [audioDir, segDir, quickLookDir]) mkdirSync(dir, { recursive: true });
-
-const FRAME_W = 1920; // square canvas for qlmanage
-const CARD_W = 1080;
-const CARD_H = 1920;
-const INK = "#161c24";
-const PAPER = "#fafaf8";
-const MUTED = "#69727d";
-const ACCENT = "#3457d5";
-
-const poster = (slug) => join(repoRoot, `docs/assets/poster-series-v3/agent-trellis-poster-v3-${slug}-zh.png`);
-
-const scenes = [
-  {
-    id: "01-hook",
-    card: "opening",
-    caption: "谁懂啊！Code Agent 装了一堆\n配置全乱套",
-    narration: "家人们，谁懂啊！电脑里装了好几个 Code Agent，技能、插件、配置各管各的，乱到崩溃。今天分享一个开源小工具，Trellis。",
-    move: "out",
-  },
-  {
-    id: "02-pain",
-    image: poster("migrate"),
-    caption: "同一个技能\n要复制好几遍",
-    narration: "同一个技能想给所有 Agent 用，得复制好几遍；改个配置，得挨个文件去改，谁改谁知道。",
-    move: "out",
-  },
-  {
-    id: "03-solution",
-    image: poster("unified"),
-    caption: "改一处，全部生效",
-    narration: "Trellis 就把配置收拢到一个地方统一管，自动发给每个 Agent。改一处，全都生效。",
-    move: "in",
-  },
-  {
-    id: "04-how",
-    image: poster("switch"),
-    caption: "一条命令，直接开始",
-    narration: "用法也简单：安装就一行，onboard 一条命令直接开始，不用先做任何准备。",
-    move: "out",
-  },
-  {
-    id: "05-safe",
-    image: poster("memory"),
-    caption: "不满意？一键退回",
-    narration: "它会先问你两个问题，然后自动迁移、同步，每步先备份。不满意，rollback 一键退回。",
-    move: "in",
-  },
-  {
-    id: "06-closing",
-    card: "closing",
-    caption: "开源免费，链接在简介",
-    narration: "经常在多个 Code Agent 之间切换，或者想迁移到新 Agent 的朋友，希望这个工具能帮到你。链接在简介，冲。",
-    move: "out",
-  },
-];
-
-// ---------------------------------------------------------------------------
-// Brand cards (opening / closing) and caption pills, rendered via qlmanage.
-// ---------------------------------------------------------------------------
-
-const hatchLines = (x, y, w, h, spacing) => {
-  const lines = [];
-  const span = Math.ceil((w + h) / spacing) + 1;
-  for (let k = -span; k <= span; k += 1) {
-    const x0 = x + k * spacing;
-    lines.push(`<path d="M${x0} ${y + h} L${x0 + h} ${y}"/><path d="M${x0} ${y} L${x0 + h} ${y + h}"/>`);
-  }
-  return lines.join("");
-};
-
-const logoMark = (x, y, scale, color = INK) => `<g transform="translate(${x} ${y}) scale(${scale})" fill="none" stroke="${color}" stroke-linecap="round">
-  <defs><clipPath id="beam-${x}"><rect x="21" y="23" width="54" height="9" rx="4.5"/></clipPath></defs>
-  <rect x="16" y="18" width="64" height="18" rx="9" stroke-width="5.5"/>
-  <g stroke-width="2.6" clip-path="url(#beam-${x})">${hatchLines(25.5, 23, 54, 9, 18)}</g>
-  <path d="M48 36 V78" stroke-width="8"/>
-</g>`;
-
-const cardText = (value, x, y, options = {}) => {
-  const { size = 40, weight = 400, fill = INK, anchor = "start", family = "Helvetica Neue, PingFang SC, sans-serif", letterSpacing = 0 } = options;
-  return String(value).split("\n").map((line, i) =>
-    `<text x="${x}" y="${y + i * Math.round(size * 1.35)}" text-anchor="${anchor}" font-family="${family}" font-size="${size}" font-weight="${weight}" letter-spacing="${letterSpacing}" fill="${fill}">${line.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")}</text>`).join("");
-};
-
-const cardSvg = (kind) => {
-  const bg = `<rect width="${FRAME_W}" height="${FRAME_W}" fill="${PAPER}"/><g transform="translate(${(FRAME_W - CARD_W) / 2} 0)">`;
-  if (kind === "opening") return `${bg}
-    ${logoMark(444, 560, 2)}
-    ${cardText("Trellis", 540, 920, { size: 92, weight: 800, anchor: "middle", letterSpacing: -1 })}
-    ${cardText("一个 Runtime，统一所有 Code Agent", 540, 986, { size: 36, weight: 450, fill: MUTED, anchor: "middle" })}
-    <rect x="460" y="1030" width="160" height="5" fill="${ACCENT}"/>
-  </g>`;
-  return `${bg}
-    ${logoMark(444, 530, 2)}
-    ${cardText("开源 · MIT", 540, 890, { size: 72, weight: 800, anchor: "middle" })}
-    ${cardText("早期版本，欢迎试用，欢迎 Issue", 540, 958, { size: 34, fill: MUTED, anchor: "middle" })}
-    <rect x="150" y="1030" width="780" height="80" rx="14" fill="none" stroke="${INK}" stroke-width="3"/>
-    ${cardText("github.com/paul-leo/Trellis", 540, 1083, { size: 36, weight: 500, family: "Menlo, monospace", anchor: "middle" })}
-  </g>`;
-};
-
-const renderPng = (name, svgBody) => {
-  const svgPath = join(quickLookDir, `${name}.svg`);
-  writeFileSync(svgPath, `<svg xmlns="http://www.w3.org/2000/svg" width="${FRAME_W}" height="${FRAME_W}" viewBox="0 0 ${FRAME_W} ${FRAME_W}">${svgBody}</svg>`);
-  execFileSync("qlmanage", ["-t", "-s", "1920", "-o", quickLookDir, svgPath], { stdio: "ignore" });
-  const out = join(buildDir, `${name}.png`);
-  execFileSync("sips", ["--cropToHeightWidth", String(CARD_H), String(CARD_W), join(quickLookDir, `${name}.svg.png`), "--out", out], { stdio: "ignore" });
-  return out;
-};
-
-// Caption pill on a green key background (nothing else in the pill is green).
-const renderCaption = (scene) => {
-  const lines = scene.caption.split("\n");
-  const lineWidth = (s) => [...s].reduce((w, ch) => w + (/[^\x00-\xff]/.test(ch) ? 58 : 32), 0);
-  const pillW = Math.min(Math.max(...lines.map(lineWidth)) + 116, 1000);
-  const pillH = (lines.length - 1) * 68 + 100;
-  const text = lines.map((line, i) => `<text x="100" y="${160 + i * 68}" font-family="PingFang SC, sans-serif" font-size="56" font-weight="800" fill="${INK}">${line.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")}</text>`).join("");
-  return renderPng(`cap-${scene.id}`, `<rect width="${FRAME_W}" height="${FRAME_W}" fill="#00ff00"/><g transform="translate(${(FRAME_W - CARD_W) / 2} 0)"><rect x="44" y="88" width="${pillW}" height="${pillH}" rx="18" fill="#ffffff" opacity="0.94"/><rect x="64" y="112" width="10" height="${(lines.length - 1) * 68 + 52}" fill="${ACCENT}"/>${text}</g>`);
-};
-
-console.log("[1/3] rendering cards and captions...");
-for (const scene of scenes) {
-  scene.still = scene.card ? renderPng(`card-${scene.id}`, cardSvg(scene.card)) : scene.image;
-  scene.captionPng = renderCaption(scene);
-}
-
-// ---------------------------------------------------------------------------
-// TTS (MiniMax Speech; cached per scene id).
-// ---------------------------------------------------------------------------
-
-console.log("[2/3] synthesizing narration...");
-const apiKey = readFileSync(join(process.env.HOME, ".trellis/mcp/servers.local.env"), "utf-8").match(/^MINIMAX_API_KEY=(.+)$/m)?.[1]?.trim();
-const audioDuration = (file) => {
-  const info = execFileSync("afinfo", [file], { encoding: "utf-8" });
-  return Number(info.match(/estimated duration: ([\d.]+)/)?.[1] ?? 3);
-};
-for (const scene of scenes) {
-  scene.audio = join(audioDir, `${scene.id}.mp3`);
-  if (!existsSync(scene.audio)) {
-    if (!apiKey) throw new Error("MINIMAX_API_KEY not found");
-    const body = JSON.stringify({
-      model: "speech-2.6-hd",
-      text: scene.narration,
-      voice_setting: { voice_id: "male-qn-jingying", speed: 1.05, vol: 1, pitch: 0 },
-      audio_setting: { format: "mp3", sample_rate: 44100, channel: 1 },
-    });
-    const response = execFileSync("curl", ["-sS", "-X", "POST", "https://api.minimax.cn/v1/t2a_v2", "-H", `Authorization: Bearer ${apiKey}`, "-H", "Content-Type: application/json", "-d", body], { encoding: "utf-8", maxBuffer: 64 * 1024 * 1024, timeout: 120_000 });
-    const parsed = JSON.parse(response);
-    if (parsed.base_resp?.status_code !== 0 || !parsed.data?.audio) {
-      throw new Error(`TTS ${scene.id} failed: ${parsed.base_resp?.status_msg ?? response.slice(0, 300)}`);
-    }
-    writeFileSync(scene.audio, Buffer.from(parsed.data.audio, "hex"));
-  }
-  scene.ttsSeconds = audioDuration(scene.audio);
-  scene.duration = Math.max(scene.ttsSeconds + 1.2, 6);
-  console.log(`  ${scene.id}: ${scene.ttsSeconds.toFixed(1)}s narration, ${scene.duration.toFixed(1)}s segment`);
-}
-
-// ---------------------------------------------------------------------------
-// Segments: blur-fill 1080x1920 + slow zoompan + caption key overlay + TTS.
-// ---------------------------------------------------------------------------
-
-console.log("[3/3] assembling segments...");
-for (const scene of scenes) {
-  const frames = Math.ceil(scene.duration * 30);
-  const zoom = scene.move === "in"
-    ? `z='min(zoom+0.0006,1.16)':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'`
-    : `z='if(lte(on,1),1.16,max(pzoom-0.0006,1.0))':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'`;
-  const filter = [
-    "[0:v]split[va][vb]",
-    "[va]scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920,gblur=sigma=30[bg]",
-    "[vb]scale=1080:-2[fg]",
-    "[bg][fg]overlay=(W-w)/2:(H-h)/2[base]",
-    `[base]zoompan=${zoom}:d=${frames}:s=1080x1920:fps=30[moved]`,
-    "[1:v]colorkey=0x00ff00:0.22:0.15[capa]",
-    "[moved][capa]overlay=0:0[out]",
-  ].join(";");
-  execFileSync("ffmpeg", ["-y", "-loop", "1", "-framerate", "30", "-i", scene.still, "-loop", "1", "-framerate", "30", "-i", scene.captionPng, "-i", scene.audio,
-    "-filter_complex", filter, "-map", "[out]", "-map", "2:a",
-    "-c:v", "libx264", "-preset", "medium", "-crf", "20", "-pix_fmt", "yuv420p",
-    "-c:a", "aac", "-b:a", "160k", "-ar", "44100", "-t", String(scene.duration), join(segDir, `${scene.id}.mp4`)], { stdio: "ignore" });
-}
-
-const finalList = join(segDir, "final.txt");
-writeFileSync(finalList, scenes.map((scene) => `file '${join(segDir, `${scene.id}.mp4`)}'`).join("\n") + "\n");
-if (existsSync(outputFile)) rmSync(outputFile);
-execFileSync("ffmpeg", ["-y", "-f", "concat", "-safe", "0", "-i", finalList, "-c", "copy", "-movflags", "+faststart", outputFile], { stdio: "ignore" });
-
-console.log(`Done: ${outputFile}`);
-console.log(`Scenes: ${scenes.length}, total ~${scenes.reduce((sum, s) => sum + s.duration, 0).toFixed(0)}s`);

package/docs/video/generate-video.mjs

@@ -1,426 +0,0 @@
-// Generate the Trellis demo video locally (never published — docs/video is gitignored).
-// Pipeline: capture real CLI output in a sandbox HOME → TTS narration (macOS say)
-// → SVG frames via qlmanage → ffmpeg assembly. Run: node docs/video/generate-video.mjs
-import { execFileSync, execSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const repoRoot = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
-const buildDir = join(repoRoot, "docs/video/build");
-const framesDir = join(buildDir, "frames");
-const audioDir = join(buildDir, "audio");
-const segDir = join(buildDir, "segments");
-const quickLookDir = "/tmp/trellis-video-ql";
-const demoHome = "/tmp/trellis-demo-home";
-const outputFile = join(repoRoot, "docs/video/trellis-demo-video.mp4");
-
-for (const dir of [framesDir, audioDir, segDir, quickLookDir]) mkdirSync(dir, { recursive: true });
-
-const W = 1080; // frame width — 9:16 vertical video
-const H = 1920; // frame height
-const CANVAS = 1920; // qlmanage renders square canvases; content lives in a centered 1080x1920 band
-const OX = (CANVAS - W) / 2;
-const OY = (CANVAS - H) / 2;
-
-const trellisBin = (() => {
-  try {
-    return execSync("command -v trellis", { encoding: "utf-8", shell: "/bin/bash" }).trim();
-  } catch {
-    return null;
-  }
-})();
-const cli = trellisBin ? [trellisBin] : [process.execPath, join(repoRoot, "dist/cli.js")];
-const env = { ...process.env, HOME: demoHome };
-
-const run = (args) => {
-  try {
-    return execFileSync(cli[0], [...cli.slice(1), ...args], { encoding: "utf-8", env, timeout: 120_000 });
-  } catch (error) {
-    return String(error.stdout ?? "") + String(error.stderr ?? "");
-  }
-};
-const runShell = (command) => {
-  try {
-    return execSync(command, { encoding: "utf-8", env: { ...env, PATH: process.env.PATH }, shell: "/bin/bash", timeout: 60_000 });
-  } catch (error) {
-    return String(error.stdout ?? "") + String(error.stderr ?? "");
-  }
-};
-
-// ---------------------------------------------------------------------------
-// 1. Capture real output in a fresh sandbox.
-// ---------------------------------------------------------------------------
-
-console.log("[1/5] capturing real CLI output in sandbox...");
-execFileSync("bash", [join(repoRoot, "scripts/video-demo-setup.sh"), demoHome], { stdio: "ignore" });
-
-const capture = {
-  lsClaude: runShell(`ls "${demoHome}/.claude" && ls "${demoHome}/.claude/skills"`),
-  codexConfig: runShell(`cat "${demoHome}/.codex/config.toml"`),
-  npmLs: runShell(`npm ls -g agent-trellis --depth=0 2>/dev/null | tail -1`),
-  // Fresh sandbox, no init first — onboard chains init itself, which is
-  // exactly what the video narrates ("onboard 会自己把配置的家建好").
-  onboard: run(["onboard", "--agent", "claude-code", "--manage", "codex"]),
-  doctor: run(["doctor"]),
-  rollback: run(["rollback"]),
-};
-
-const shorten = (text) => text.split(demoHome).join("~").split("/private/tmp/trellis-demo-home").join("~").trim();
-
-// The demo shows the interactive `trellis onboard`; the captured run used
-// flags (a TTY picker can't be scripted), so its one telltale flag line is
-// filtered out of the displayed output.
-const displayOnboard = capture.onboard.split("\n").filter((line) => !line.includes("(--agent)")).join("\n");
-
-// Display curation for the demo's happy path: the embedded doctor's
-// cross-agent drift notes (expected — the migration source is deliberately
-// not managed), the unconfigured-memory notice, and the resulting exit-code
-// tail are trimmed so frames don't end on a red ❌ for by-design behavior.
-// Nothing is hidden that the demo itself acts on; every kept line is real.
-const NOISE = [
-  /^Cross-agent:/,
-  /resolves to different sources/,
-  /^verdict$/,
-  /blocking issue/,
-  /\[doctor\]/,
-  /\[memory sync\]/,
-  /^memory sync$/,
-  /no "memory" MCP server/,
-  /^exit code:/,
-  /did not block this run/,
-  /warnings only/,
-];
-const curate = (text) => text.split("\n").filter((line) => !NOISE.some((pattern) => pattern.test(line))).join("\n").replace(/\n{3,}/g, "\n\n");
-
-// Interactive pickers can't be driven by a script (raw-mode TTY), so the two
-// Q&A frames are typeset from the real prompt wording (src/commands/onboard.ts)
-// and real option labels/values from this exact sandbox state.
-const promptFrames = {
-  source: [
-    "选择迁移来源。推荐选择可迁移内容最多的 Agent；这只决定从哪里读取，不会自动托管它：",
-    "◆  请选择一个迁移来源",
-    "│  ● claude-code — Skills: 2, global instructions: yes, MCP: 2, Memory: empty （推荐：可迁移内容最多）",
-    "│  ○ codex — Skills: 0, global instructions: no, MCP: 1, Memory: empty",
-  ].join("\n"),
-  managed: [
-    "选择 Trellis 要托管的 Agent。推荐选择已安装的 Agent；选择未安装的 Agent 会先请求安装确认：",
-    "◆  请选择要启用的项目",
-    "│  ◻ claude-code — present, 2 skill(s)（推荐：已安装）",
-    "│  ■ codex — present, 0 skill(s)（推荐：已安装）",
-    "│  ◻ kiro — not installed",
-    "│  ◻ pi — not installed",
-    "│  ◻ kimi-code — not installed",
-  ].join("\n"),
-};
-
-// ---------------------------------------------------------------------------
-// 2. Narration blocks.
-// ---------------------------------------------------------------------------
-
-const blocks = [
-  {
-    id: "01-opening",
-    caption: "谁懂啊！Code Agent 装了一堆\n配置全乱套",
-    narration: "家人们，谁懂啊！电脑里装了好几个 Code Agent，技能、插件、配置各管各的，乱到崩溃。今天分享一个开源小工具，Trellis。",
-    frames: [{ card: "opening" }],
-  },
-  {
-    id: "02-pain",
-    caption: "同一个技能\n要复制好几遍",
-    narration: "同一个技能想给所有 Agent 用，得复制好几遍；改个配置，得挨个文件去改，谁改谁知道。",
-    frames: [
-      { term: { command: "ls ~/.claude ~/.claude/skills", output: capture.lsClaude } },
-      { term: { command: "cat ~/.codex/config.toml", output: capture.codexConfig } },
-    ],
-  },
-  {
-    id: "03-solution",
-    caption: "改一处，全部生效",
-    narration: "Trellis 就把配置收拢到一个地方统一管，自动发给每个 Agent。改一处，全都生效。",
-    frames: [{ card: "poster" }],
-  },
-  {
-    id: "04-setup",
-    caption: "一行装好，零准备",
-    narration: "安装一行搞定，也不用先准备什么，onboard 直接开始。",
-    frames: [{ term: { command: "npm install -g agent-trellis", output: capture.npmLs } }],
-  },
-  {
-    id: "05-interactive",
-    caption: "它先问你两个问题",
-    narration: "它会先问你两个问题：从哪个 Agent 搬配置，管理哪几个。选完就全自动。",
-    frames: [
-      { term: { command: "trellis onboard", output: promptFrames.source } },
-      { term: { command: "trellis onboard（接着选）", output: promptFrames.managed } },
-    ],
-  },
-  {
-    id: "06-run",
-    caption: "全程自动，每步先备份",
-    narration: "剩下的它自己做完：迁移、同步、检查。每改一个文件之前，都先自动备份。",
-    frames: [{ term: { command: "trellis onboard", output: curate(displayOnboard) } }],
-  },
-  {
-    id: "07-verify",
-    caption: "不满意？一键退回",
-    narration: "跑完 doctor 检查状态，不满意 rollback 一键退回。",
-    frames: [
-      { term: { command: "trellis doctor", output: curate(capture.doctor) } },
-      { term: { command: "trellis rollback", output: capture.rollback } },
-    ],
-  },
-  {
-    id: "08-closing",
-    caption: "开源免费，链接在简介",
-    narration: "和我一样总在几个 Code Agent 之间切换，或者想迁移到新 Agent 的朋友，希望这个工具能帮到你。链接在简介，冲。",
-    frames: [{ card: "closing" }],
-  },
-];
-
-// ---------------------------------------------------------------------------
-// 3. Frame rendering (SVG → qlmanage → crop to 1920x1080).
-// ---------------------------------------------------------------------------
-
-const palette = { paper: "#fafaf8", ink: "#161c24", muted: "#69727d", accent: "#3457d5" };
-const term = { bg: "#14171c", bar: "#1e222a", text: "#d6dde6", dim: "#7d8794", green: "#6fdd8b", yellow: "#e8c468", red: "#f0887a", blue: "#7aa2f7" };
-
-const escapeXml = (value) => String(value)
-  .replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")
-  .replaceAll('"', "&quot;").replaceAll("'", "&apos;");
-
-const hatchLines = (x, y, w, h, spacing) => {
-  const lines = [];
-  const span = Math.ceil((w + h) / spacing) + 1;
-  for (let k = -span; k <= span; k += 1) {
-    const x0 = x + k * spacing;
-    lines.push(`<path d="M${x0} ${y + h} L${x0 + h} ${y}"/><path d="M${x0} ${y} L${x0 + h} ${y + h}"/>`);
-  }
-  return lines.join("");
-};
-
-const logoMark = (x, y, scale, color = palette.ink) => `<g transform="translate(${x} ${y}) scale(${scale})" fill="none" stroke="${color}" stroke-linecap="round">
-  <defs><clipPath id="beam-${x}-${y}"><rect x="21" y="23" width="54" height="9" rx="4.5"/></clipPath></defs>
-  <rect x="16" y="18" width="64" height="18" rx="9" stroke-width="5.5"/>
-  <g stroke-width="2.6" clip-path="url(#beam-${x}-${y})">${hatchLines(25.5, 23, 54, 9, 18)}</g>
-  <path d="M48 36 V78" stroke-width="8"/>
-</g>`;
-
-const displayWidth = (value) => [...value].reduce((width, ch) => width + (/[^\x00-\xff]/.test(ch) ? 2 : 1), 0);
-
-const wrapLine = (line, maxUnits) => {
-  if (displayWidth(line) <= maxUnits) return [line];
-  const parts = [];
-  let current = "";
-  for (const ch of line) {
-    if (displayWidth(current + ch) > maxUnits) {
-      parts.push(current);
-      current = ch;
-    } else {
-      current += ch;
-    }
-  }
-  if (current) parts.push(current);
-  return parts;
-};
-
-const classify = (line) => {
-  if (line.includes("◆")) return "accent";
-  if (line.includes("●") || line.includes("■")) return "ok";
-  if (line.includes("❌")) return "err";
-  if (line.includes("⚠")) return "warn";
-  if (line.includes("✅")) return "ok";
-  if (/^\s*(verdict|\[dry run\])/u.test(line)) return "accent";
-  if (/^(migrate|sync|mcp sync|memory sync|secrets audit|health scan|Cross-agent)/u.test(line)) return "head";
-  if (/^\s*(—|\s*$)/u.test(line) && line.trim() === "") return "blank";
-  return "out";
-};
-
-const kindColor = { cmd: "#ffffff", out: term.text, dim: term.dim, ok: term.green, warn: term.yellow, err: term.red, accent: term.blue, head: "#ffffff", blank: term.text };
-
-const TERM = { x: 40, y: 300, w: 1000, h: 1500, barH: 56, padX: 32, padY: 32, font: 22, lh: 32, maxChars: 53, maxLines: 42 };
-
-const captionSvg = (caption, color) => {
-  if (!caption) return "";
-  const lines = caption.split("\n").length;
-  return `<g>
-  <rect x="64" y="92" width="10" height="${lines * 68}" fill="${palette.accent}"/>
-  ${cardText(caption, 100, 148, { size: 52, weight: 800, fill: color, lineHeight: 68 })}
-</g>`;
-};
-
-const terminalSvg = (command, output, pageLines, caption) => {
-  const allLines = [];
-  for (const raw of pageLines) {
-    for (const piece of wrapLine(raw, TERM.maxChars)) allLines.push(piece);
-  }
-  const rows = allLines.slice(0, TERM.maxLines).map((line, i) => {
-    const kind = classify(line);
-    const y = TERM.y + TERM.barH + TERM.padY + i * TERM.lh + TERM.font * 0.75;
-    const weight = kind === "head" || kind === "accent" ? 700 : 400;
-    return `<text x="${TERM.x + TERM.padX}" y="${y}" font-family="Menlo, monospace" font-size="${TERM.font}" font-weight="${weight}" fill="${kindColor[kind] ?? term.text}">${escapeXml(line) || " "}</text>`;
-  }).join("");
-  const promptY = TERM.y + TERM.barH + TERM.padY - 14;
-  return `<rect width="${CANVAS}" height="${CANVAS}" fill="#0e1013"/>
-  <g transform="translate(${OX} ${OY})">
-    <rect x="${TERM.x}" y="${TERM.y}" width="${TERM.w}" height="${TERM.h}" rx="18" fill="${term.bg}"/>
-    <rect x="${TERM.x}" y="${TERM.y}" width="${TERM.w}" height="${TERM.barH}" rx="18" fill="${term.bar}"/>
-    <rect x="${TERM.x}" y="${TERM.y + TERM.barH / 2}" width="${TERM.w}" height="${TERM.barH / 2}" fill="${term.bar}"/>
-    <circle cx="${TERM.x + 40}" cy="${TERM.y + 32}" r="9" fill="#ff5f57"/>
-    <circle cx="${TERM.x + 72}" cy="${TERM.y + 32}" r="9" fill="#febc2e"/>
-    <circle cx="${TERM.x + 104}" cy="${TERM.y + 32}" r="9" fill="#28c840"/>
-    <text x="${TERM.x + TERM.w / 2}" y="${TERM.y + 40}" text-anchor="middle" font-family="Menlo, monospace" font-size="22" fill="${term.dim}">trellis demo — zsh</text>
-    <text x="${TERM.x + TERM.padX}" y="${promptY + TERM.font * 0.75}" font-family="Menlo, monospace" font-size="${TERM.font}" fill="${term.green}">$ <tspan fill="#ffffff">${escapeXml(command)}</tspan></text>
-    <g transform="translate(0 ${TERM.lh})">${rows}</g>
-    ${captionSvg(caption, "#ffffff")}
-  </g>`;
-};
-
-const cardText = (value, x, y, options = {}) => {
-  const { size = 40, weight = 400, fill = palette.ink, anchor = "start", family = "Helvetica Neue, PingFang SC, sans-serif", letterSpacing = 0, lineHeight = Math.round(size * 1.35) } = options;
-  return String(value).split("\n").map((line, i) =>
-    `<text x="${x}" y="${y + i * lineHeight}" text-anchor="${anchor}" font-family="${family}" font-size="${size}" font-weight="${weight}" letter-spacing="${letterSpacing}" fill="${fill}">${escapeXml(line)}</text>`).join("");
-};
-
-const cardSvg = (kind, caption) => {
-  const bg = `<rect width="${CANVAS}" height="${CANVAS}" fill="${palette.paper}"/><g transform="translate(${OX} ${OY})">`;
-  const end = `${captionSvg(caption, palette.ink)}</g>`;
-  if (kind === "opening") return `${bg}
-    ${logoMark(444, 520, 2)}
-    ${cardText("Trellis", 540, 880, { size: 92, weight: 800, anchor: "middle", letterSpacing: -1 })}
-    ${cardText("一个 Runtime，统一所有 Code Agent", 540, 946, { size: 36, weight: 450, fill: palette.muted, anchor: "middle" })}
-    <rect x="460" y="990" width="160" height="5" fill="${palette.accent}"/>
-    ${cardText("使 用 分 享", 540, 1070, { size: 26, family: "Menlo, monospace", fill: palette.accent, anchor: "middle", letterSpacing: 6 })}
-  ${end}`;
-  if (kind === "poster") {
-    const poster = readFileSync(join(repoRoot, "docs/assets/poster-series-v3/agent-trellis-poster-v3-unified-zh.png")).toString("base64");
-    return `${bg}
-    <rect x="-8" y="272" width="1096" height="1456" fill="#e8e6e0"/>
-    <image href="data:image/png;base64,${poster}" x="0" y="280" width="1080" height="1440"/>
-  ${end}`;
-  }
-  if (kind === "principles") return `${bg}
-    ${logoMark(80, 200, 0.9)}
-    ${cardText("两个在意的设计", 80, 420, { size: 60, weight: 800, letterSpacing: -1 })}
-    <rect x="80" y="458" width="72" height="6" fill="${palette.accent}"/>
-    ${cardText("01", 80, 600, { size: 28, weight: 700, family: "Menlo, monospace", fill: palette.accent })}
-    ${cardText("密钥永远不明文写进配置", 80, 662, { size: 40, weight: 700 })}
-    ${cardText("只写个名字，有命令专门检查", 80, 716, { size: 28, fill: palette.muted })}
-    ${cardText("02", 80, 860, { size: 28, weight: 700, family: "Menlo, monospace", fill: palette.accent })}
-    ${cardText("功能都在隔离环境里实测过", 80, 922, { size: 40, weight: 700 })}
-    ${cardText("真实安装验证，不是看文档猜的", 80, 976, { size: 28, fill: palette.muted })}
-  ${end}`;
-  return `${bg}
-    ${logoMark(444, 490, 2)}
-    ${cardText("开源 · MIT", 540, 850, { size: 72, weight: 800, anchor: "middle" })}
-    ${cardText("早期版本，欢迎试用，欢迎 Issue", 540, 918, { size: 34, fill: palette.muted, anchor: "middle" })}
-    <rect x="150" y="990" width="780" height="80" rx="14" fill="none" stroke="${palette.ink}" stroke-width="3"/>
-    ${cardText("github.com/paul-leo/Trellis", 540, 1043, { size: 36, weight: 500, family: "Menlo, monospace", anchor: "middle" })}
-  ${end}`;
-};
-
-const renderFrame = (name, svgBody) => {
-  const svgPath = join(quickLookDir, `${name}.svg`);
-  writeFileSync(svgPath, `<svg xmlns="http://www.w3.org/2000/svg" width="${CANVAS}" height="${CANVAS}" viewBox="0 0 ${CANVAS} ${CANVAS}">${svgBody}</svg>`);
-  execFileSync("qlmanage", ["-t", "-s", "1920", "-o", quickLookDir, svgPath], { stdio: "ignore" });
-  execFileSync("sips", ["--cropToHeightWidth", String(H), String(W), join(quickLookDir, `${name}.svg.png`), "--out", join(framesDir, `${name}.png`)], { stdio: "ignore" });
-  return join(framesDir, `${name}.png`);
-};
-
-console.log("[2/5] rendering frames...");
-let frameIndex = 0;
-for (const block of blocks) {
-  block.images = [];
-  for (const frame of block.frames) {
-    if (frame.card) {
-      block.images.push(renderFrame(`${block.id}-${frameIndex++}`, cardSvg(frame.card, block.caption)));
-      continue;
-    }
-    const outputLines = shorten(frame.term.output).split("\n");
-    const budget = TERM.maxLines - 2;
-    if (outputLines.length <= budget) {
-      block.images.push(renderFrame(`${block.id}-${frameIndex++}`, terminalSvg(frame.term.command, null, outputLines, block.caption)));
-    } else {
-      for (let page = 0; page * budget < outputLines.length; page += 1) {
-        block.images.push(renderFrame(`${block.id}-${frameIndex++}`, terminalSvg(page === 0 ? frame.term.command : "(cont.)", null, outputLines.slice(page * budget, (page + 1) * budget), block.caption)));
-      }
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// 4. TTS narration + per-block assembly.
-// ---------------------------------------------------------------------------
-
-console.log("[3/5] generating narration audio...");
-const audioDuration = (file) => {
-  const info = execFileSync("afinfo", [file], { encoding: "utf-8" });
-  return Number(info.match(/estimated duration: ([\d.]+)/)?.[1] ?? 3);
-};
-
-// MiniMax Speech (speech-2.6-hd) when a key is configured in Trellis's local
-// secret file; falls back to macOS `say` otherwise. The key is read from
-// ~/.trellis/mcp/servers.local.env and never written anywhere else.
-const minimaxKey = (() => {
-  try {
-    const envFile = readFileSync(join(process.env.HOME, ".trellis/mcp/servers.local.env"), "utf-8");
-    return envFile.match(/^MINIMAX_API_KEY=(.+)$/m)?.[1]?.trim() || null;
-  } catch {
-    return null;
-  }
-})();
-console.log(`  narration voice: ${minimaxKey ? "MiniMax speech-2.6-hd" : "macOS say (no MINIMAX_API_KEY found)"}`);
-
-const synthesize = (text, outFile) => {
-  if (!minimaxKey) {
-    execFileSync("say", ["-v", "Ting-Ting (Enhanced)", "-r", "200", "-o", outFile, text]);
-    return;
-  }
-  const body = JSON.stringify({
-    model: "speech-2.6-hd",
-    text,
-    voice_setting: { voice_id: "male-qn-jingying", speed: 1.2, vol: 1, pitch: 0 },
-    audio_setting: { format: "mp3", sample_rate: 44100, channel: 1 },
-  });
-  const response = execFileSync("curl", ["-sS", "-X", "POST", "https://api.minimax.cn/v1/t2a_v2",
-    "-H", `Authorization: Bearer ${minimaxKey}`, "-H", "Content-Type: application/json",
-    "-d", body], { encoding: "utf-8", maxBuffer: 64 * 1024 * 1024, timeout: 120_000 });
-  const parsed = JSON.parse(response);
-  if (parsed.base_resp?.status_code !== 0 || !parsed.data?.audio) {
-    throw new Error(`MiniMax TTS failed: ${parsed.base_resp?.status_msg ?? response.slice(0, 300)}`);
-  }
-  writeFileSync(outFile, Buffer.from(parsed.data.audio, "hex"));
-};
-
-for (const block of blocks) {
-  block.audio = join(audioDir, `${block.id}.${minimaxKey ? "mp3" : "aiff"}`);
-  synthesize(block.narration, block.audio);
-  block.duration = audioDuration(block.audio);
-}
-
-console.log("[4/5] assembling segments...");
-execFileSync("ffmpeg", ["-version"], { stdio: "ignore" });
-
-for (const block of blocks) {
-  const images = block.images;
-  const total = block.duration + 0.5;
-  const first = images.length > 1 ? Math.min(2.4, total * 0.3) : total;
-  const rest = images.length > 1 ? (total - first) / (images.length - 1) : 0;
-  const listFile = join(segDir, `${block.id}.txt`);
-  const lines = images.map((image, i) => `file '${image}'\nduration ${(i === 0 ? first : rest).toFixed(3)}`);
-  lines.push(`file '${images[images.length - 1]}'`);
-  writeFileSync(listFile, lines.join("\n") + "\n");
-  execFileSync("ffmpeg", ["-y", "-f", "concat", "-safe", "0", "-i", listFile, "-i", block.audio,
-    "-vf", `scale=${W}:${H},fps=30,format=yuv420p`, "-c:v", "libx264", "-preset", "medium", "-crf", "20",
-    "-c:a", "aac", "-b:a", "160k", "-ar", "44100", "-shortest", join(segDir, `${block.id}.mp4`)], { stdio: "ignore" });
-}
-
-console.log("[5/5] final concat...");
-const finalList = join(segDir, "final.txt");
-writeFileSync(finalList, blocks.map((block) => `file '${join(segDir, `${block.id}.mp4`)}'`).join("\n") + "\n");
-if (existsSync(outputFile)) rmSync(outputFile);
-execFileSync("ffmpeg", ["-y", "-f", "concat", "-safe", "0", "-i", finalList, "-c", "copy", "-movflags", "+faststart", outputFile], { stdio: "ignore" });
-
-const total = blocks.reduce((sum, block) => sum + block.duration + 0.5, 0);
-console.log(`Done: ${outputFile}`);
-console.log(`Blocks: ${blocks.length}, estimated duration ~${total.toFixed(0)}s`);