@keepylabs/cutroom 0.7.0 → 0.8.0

package/README.md

@@ -15,11 +15,12 @@ Everything lives in the Cutroom folder in your home folder. Open Claude Code the
     Cutroom/
       CLAUDE.md          how your studio works: approvals, rules
       brand/             your colors, logo, frames you love
-      references/        reel breakdowns and creator teardowns
+      references/        your library: reel breakdowns and creator teardowns
       inbox/             drop new raw videos here
       videos/
         2026-11-01-topic/
           raw/           this video's footage
+          references/    what this video copies, with a why-it-works note
           script.md      what you say, word for word
           facts.md       every number on screen, with its source
           plan.md        the edit plan and its status

package/cutroom.mjs

@@ -8,7 +8,7 @@ var __export = (target, all) => {
 
 // src/community/local/server.ts
 import { homedir as homedir3 } from "node:os";
-import { delimiter, join as join6 } from "node:path";
+import { delimiter, join as join7 } from "node:path";
 
 // src/community/local/proc.ts
 import { spawnSync } from "node:child_process";
@@ -19201,8 +19201,8 @@ var require_formats = /* @__PURE__ */ __commonJSMin(((exports) => {
     if (!matches) return false;
     const year = +matches[1];
     const month = +matches[2];
-    const day3 = +matches[3];
-    return month >= 1 && month <= 12 && day3 >= 1 && day3 <= (month === 2 && isLeapYear(year) ? 29 : DAYS[month]);
+    const day4 = +matches[3];
+    return month >= 1 && month <= 12 && day4 >= 1 && day4 <= (month === 2 && isLeapYear(year) ? 29 : DAYS[month]);
   }
   function compareDate(d1, d2) {
     if (!(d1 && d2)) return void 0;
@@ -21559,13 +21559,13 @@ import { readFileSync as readFileSync6 } from "node:fs";
 
 // src/community/local/render.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { copyFileSync as copyFileSync2, existsSync as existsSync4, mkdirSync as mkdirSync5, mkdtempSync, readdirSync, readFileSync as readFileSync5, renameSync as renameSync2, rmSync as rmSync2, statSync, writeFileSync as writeFileSync4 } from "node:fs";
+import { copyFileSync as copyFileSync2, existsSync as existsSync5, mkdirSync as mkdirSync5, mkdtempSync, readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync as renameSync3, rmSync as rmSync3, statSync, writeFileSync as writeFileSync5 } from "node:fs";
 import { homedir as homedir2, tmpdir } from "node:os";
-import { basename as basename2, extname, join as join5, resolve as resolve3 } from "node:path";
+import { basename as basename2, extname, join as join6, resolve as resolve3 } from "node:path";
 
 // src/community/local/measure.ts
 import { execFileSync, spawnSync as spawnSync2 } from "node:child_process";
-import { mkdirSync, readFileSync } from "node:fs";
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 var ffmpegErr = (args) => spawnSync2("ffmpeg", ["-nostdin", "-hide_banner", ...args], { encoding: "utf8", maxBuffer: 64 * 1024 * 1024 }).stderr ?? "";
 function probe(file) {
@@ -21609,6 +21609,34 @@ function sampleFrames(file, dir, duration3, interval = 1, max = 40) {
   }
   return { frames: out, interval: step };
 }
+function sheetGrid(n) {
+  const cols = Math.max(1, Math.min(8, n));
+  return { cols, rows: Math.max(1, Math.ceil(n / cols)) };
+}
+function contactSheet(frames, out) {
+  if (!frames.length) return null;
+  const tmp = `${out}.parts`;
+  mkdirSync(tmp, { recursive: true });
+  try {
+    const parts = frames.map((f, i) => {
+      const part = join(tmp, `${String(i).padStart(3, "0")}.jpg`);
+      const label = `${Math.floor(f.t / 60)}\\:${(f.t % 60).toFixed(1).padStart(4, "0")}`;
+      const scale = "scale=200:-2";
+      const labelled = spawnSync2("ffmpeg", ["-v", "error", "-y", "-i", f.path, "-vf", `${scale},drawtext=text='${label}':x=8:y=8:fontsize=22:fontcolor=white:box=1:boxcolor=black@0.7:boxborderw=6`, part]);
+      if (labelled.status !== 0) execFileSync("ffmpeg", ["-v", "error", "-y", "-i", f.path, "-vf", scale, part]);
+      return part;
+    });
+    const list = join(tmp, "list.txt");
+    writeFileSync(list, parts.map((p) => `file '${p.replace(/'/g, "'\\''")}'`).join("\n"));
+    const { cols, rows } = sheetGrid(parts.length);
+    execFileSync("ffmpeg", ["-v", "error", "-y", "-f", "concat", "-safe", "0", "-i", list, "-vf", `tile=${cols}x${rows}:padding=4:color=black`, "-frames:v", "1", "-q:v", "4", out]);
+    return out;
+  } catch {
+    return null;
+  } finally {
+    rmSync(tmp, { recursive: true, force: true });
+  }
+}
 function parseSilences(log, duration3) {
   const out = [];
   let start = null;
@@ -21658,29 +21686,146 @@ function technicalChecks(file) {
 }
 
 // src/community/local/studio.ts
-import { appendFileSync, copyFileSync, existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync4, renameSync, writeFileSync as writeFileSync3 } from "node:fs";
-import { basename, isAbsolute, join as join4, relative, resolve as resolve2 } from "node:path";
+import { existsSync as existsSync4, renameSync as renameSync2 } from "node:fs";
+import { join as join5 } from "node:path";
+
+// src/studio-core.ts
+var studio_core_exports = {};
+__export(studio_core_exports, {
+  STATUSES: () => STATUSES,
+  addCheck: () => addCheck,
+  day: () => day,
+  ensureLayout: () => ensureLayout,
+  keepRender: () => keepRender,
+  layout: () => layout,
+  nextVersion: () => nextVersion,
+  setStatus: () => setStatus,
+  slug: () => slug,
+  startVideoNotes: () => startVideoNotes,
+  statusOf: () => statusOf,
+  takeRaw: () => takeRaw,
+  videoFolderOf: () => videoFolderOf,
+  videoPath: () => videoPath
+});
+import { appendFileSync, copyFileSync, existsSync, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { basename, dirname, isAbsolute, join as join2, relative, resolve } from "node:path";
+var STATUSES = ["footage ready", "plan ready", "preview", "final", "posted"];
+var day = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+var slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
+var layout = (home) => ({ home, brand: join2(home, "brand"), references: join2(home, "references"), inbox: join2(home, "inbox"), videos: join2(home, "videos") });
+function ensureLayout(home, claudeMd) {
+  const s = layout(home);
+  for (const d of [s.brand, s.references, s.inbox, s.videos]) mkdirSync2(d, { recursive: true });
+  const claude = join2(home, "CLAUDE.md");
+  if (!existsSync(claude)) writeFileSync2(claude, claudeMd);
+  return s;
+}
+function videoPath(home, topic, date4 = day()) {
+  const videos = layout(home).videos;
+  const t = slug(topic) || "video";
+  const existing = existsSync(videos) ? readdirSync(videos).filter((name) => /^\d{4}-\d{2}-\d{2}-/.test(name) && name.slice(11) === t).sort() : [];
+  return join2(videos, existing.at(-1) ?? `${date4}-${t}`);
+}
+function videoFolderOf(path) {
+  for (let p = resolve(path); p !== dirname(p); p = dirname(p)) {
+    if (basename(dirname(p)) === "videos" && existsSync(join2(p, "plan.md"))) return p;
+  }
+  return null;
+}
+var inside = (child, parent) => {
+  const r = relative(parent, child);
+  return !!r && !r.startsWith("..") && !isAbsolute(r);
+};
+function takeRaw(source, folder, inbox) {
+  const raw = join2(folder, "raw");
+  const file = resolve(source);
+  if (inside(file, raw)) return { file, how: "already here" };
+  mkdirSync2(raw, { recursive: true });
+  let target = join2(raw, basename(file));
+  for (let n = 2; existsSync(target); n++) target = join2(raw, basename(file).replace(/(\.[^.]*)?$/, `-${n}$1`));
+  if (inbox && inside(file, inbox)) {
+    try {
+      renameSync(file, target);
+      return { file: target, how: "moved from inbox" };
+    } catch {
+    }
+  }
+  copyFileSync(file, target);
+  return { file: target, how: "copied" };
+}
+function setStatus(folder, status, plan) {
+  const file = join2(folder, "plan.md");
+  const current = existsSync(file) ? readFileSync2(file, "utf8") : `# ${basename(folder)}
+
+status: 
+`;
+  const withStatus = /^status:.*$/m.test(current) ? current.replace(/^status:.*$/m, `status: ${status}`) : current.replace(/^(# .*\n)/, `$1
+status: ${status}
+`);
+  writeFileSync2(file, plan === void 0 ? withStatus : `${withStatus.split(/\n## Plan\n/)[0].trimEnd()}
+
+## Plan
+${plan}
+`);
+}
+var statusOf = (folder) => {
+  const file = join2(folder, "plan.md");
+  return existsSync(file) ? readFileSync2(file, "utf8").match(/^status: *(.*)$/m)?.[1].trim() ?? null : null;
+};
+var NO_SCRIPT = "(no script yet)";
+function startVideoNotes(folder, script, who = "is said", source = "from the footage; fix any misheard words here") {
+  const scriptFile = join2(folder, "script.md"), facts = join2(folder, "facts.md"), notes = join2(folder, "references", "notes.md");
+  mkdirSync2(join2(folder, "references"), { recursive: true });
+  if (!existsSync(notes)) writeFileSync2(notes, "# References for this video\n\nWhat this video copies and why it works, one line each.\n\n");
+  if (!existsSync(facts)) writeFileSync2(facts, "# Facts\n\nEvery number or claim that shows on screen, with where it comes from.\n\n| on screen | source |\n| - | - |\n");
+  const waiting = !existsSync(scriptFile) || script !== void 0 && readFileSync2(scriptFile, "utf8").includes(NO_SCRIPT);
+  if (waiting) writeFileSync2(scriptFile, `# Script
+
+What ${who}, word for word${script ? ` (${source})` : ""}.
+
+${script ?? NO_SCRIPT}
+`);
+}
+function addCheck(folder, entry) {
+  const file = join2(folder, "checks.md");
+  if (!existsSync(file)) writeFileSync2(file, "# Checks\n\nWhat QA found on each render, and what got fixed.\n");
+  appendFileSync(file, `
+${entry.trim()}
+`);
+}
+function nextVersion(base, ext, dirs) {
+  let n = 1;
+  while (dirs.some((d) => existsSync(join2(d, `${base}-v${n}${ext}`)))) n++;
+  return `${base}-v${n}${ext}`;
+}
+function keepRender(folder, file, name = basename(file)) {
+  mkdirSync2(join2(folder, "renders"), { recursive: true });
+  let target = join2(folder, "renders", name);
+  for (let n = 2; existsSync(target); n++) target = join2(folder, "renders", name.replace(/(\.[^.]*)?$/, `-${n}$1`));
+  copyFileSync(file, target);
+  return target;
+}
 
 // src/community/local/tools.ts
-import { createWriteStream, existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { createWriteStream, existsSync as existsSync3, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir } from "node:os";
-import { join as join3, resolve } from "node:path";
+import { join as join4, resolve as resolve2 } from "node:path";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
 
 // src/community/local/signin.ts
 import { spawn } from "node:child_process";
 import { createHash, randomBytes } from "node:crypto";
-import { chmodSync, existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, existsSync as existsSync2, mkdirSync as mkdirSync3, readFileSync as readFileSync3, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "node:fs";
 import { createServer } from "node:http";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 var WHOP_APP = "app_bFhJFdBJn9jZ0v";
 var PORTS = [53171, 53172, 53173];
 var WAIT_MS = 5 * 6e4;
-var keyFile = () => join2(HOME(), ".cutroom-key");
+var keyFile = () => join3(HOME(), ".cutroom-key");
 function currentKey() {
   try {
-    const k = readFileSync2(keyFile(), "utf8").trim();
+    const k = readFileSync3(keyFile(), "utf8").trim();
     if (k) return k;
   } catch {
   }
@@ -21688,14 +21833,14 @@ function currentKey() {
   return env && !env.includes("${") ? env : null;
 }
 function saveKey(key) {
-  mkdirSync2(HOME(), { recursive: true });
-  writeFileSync(keyFile(), key, { mode: 384 });
+  mkdirSync3(HOME(), { recursive: true });
+  writeFileSync3(keyFile(), key, { mode: 384 });
   try {
     chmodSync(keyFile(), 384);
   } catch {
   }
 }
-var forgetKey = () => rmSync(keyFile(), { force: true });
+var forgetKey = () => rmSync2(keyFile(), { force: true });
 function openBrowser(url2) {
   const [cmd, args] = process.platform === "darwin" ? ["open", [url2]] : process.platform === "win32" ? ["rundll32", ["url.dll,FileProtocolHandler", url2]] : ["xdg-open", [url2]];
   try {
@@ -21788,9 +21933,9 @@ ${authorize}
 }
 
 // src/community/local/tools.ts
-var VERSION = "0.7.0";
+var VERSION = "0.8.0";
 var GATEWAY = () => (process.env.CUTROOM_GATEWAY || "https://keepylabs.com/api/cutroom").replace(/\/$/, "");
-var HOME = () => process.env.CUTROOM_HOME || join3(homedir(), "Cutroom");
+var HOME = () => process.env.CUTROOM_HOME || join4(homedir(), "Cutroom");
 async function call(op, body = {}, fetchImpl = fetch) {
   const key = currentKey();
   if (!key) throw Object.assign(new Error("Not signed in to Cutroom yet. Run the setup check (cutroom_doctor): it opens the Whop sign-in."), { status: 401 });
@@ -21810,8 +21955,8 @@ async function call(op, body = {}, fetchImpl = fetch) {
   if (!res.ok) throw Object.assign(new Error(json?.error ?? `Cutroom error (HTTP ${res.status}).`), { status: res.status });
   return json;
 }
-var slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
-var day = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+var slug2 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
+var day2 = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 var fmt = (t) => `${Math.floor(t / 60)}:${(t % 60).toFixed(1).padStart(4, "0")}`;
 var pct = (n) => `${Math.round(n * 100)}%`;
 async function download(url2, target) {
@@ -21870,7 +22015,7 @@ function localWords(file, dir) {
   try {
     const meta2 = JSON.parse(r.stdout.trim().split("\n").pop() ?? "{}");
     if (r.status !== 0 || !meta2.ok) return null;
-    const raw = JSON.parse(readFileSync3(meta2.transcriptPath ?? join3(dir, "transcript.json"), "utf8"));
+    const raw = JSON.parse(readFileSync4(meta2.transcriptPath ?? join4(dir, "transcript.json"), "utf8"));
     const words = raw.map((w) => ({ t: Math.round(w.start * 100) / 100, e: Math.round(w.end * 100) / 100, w: w.text.trim() })).filter((w) => w.w);
     return words.length ? words : null;
   } catch {
@@ -21891,22 +22036,25 @@ async function breakdownReel(input) {
   let meta2 = null, transcript = null, file;
   const src = input.source.trim();
   if (/^https?:\/\//i.test(src)) {
-    const r = await call("reel", { url: src });
+    const r = await call("reel", { url: src }).catch((e) => {
+      throw new Error(`Couldn't fetch that Instagram link right now (${e instanceof Error ? e.message : e}). Save the reel to this computer and give me the file path instead: breakdown_reel works the same on a file.`);
+    });
     meta2 = r.meta;
     transcript = r.transcript;
-    const dir2 = join3(studio.references(), `${day()}-${slug(meta2.ownerUsername ?? "reel")}-${meta2.shortCode}`);
-    mkdirSync3(dir2, { recursive: true });
-    file = join3(dir2, "source.mp4");
-    if (!existsSync2(file)) await download(meta2.videoUrl, file);
+    const dir2 = join4(studio.references(), `${day2()}-${slug2(meta2.ownerUsername ?? "reel")}-${meta2.shortCode}`);
+    mkdirSync4(dir2, { recursive: true });
+    file = join4(dir2, "source.mp4");
+    if (!existsSync3(file)) await download(meta2.videoUrl, file);
   } else {
-    file = resolve(src.replace(/^~/, homedir()));
-    if (!existsSync2(file)) throw new Error(`No such file: ${file}`);
+    file = resolve2(src.replace(/^~/, homedir()));
+    if (!existsSync3(file)) throw new Error(`No such file: ${file}`);
   }
-  const dir = /^https?:/i.test(src) ? join3(file, "..") : join3(studio.references(), `${day()}-${slug(file.split(/[\\/]/).pop() ?? "video")}`);
-  mkdirSync3(dir, { recursive: true });
+  const dir = /^https?:/i.test(src) ? join4(file, "..") : join4(studio.references(), `${day2()}-${slug2(file.split(/[\\/]/).pop() ?? "video")}`);
+  mkdirSync4(dir, { recursive: true });
   const m = measure(file);
-  const { frames, interval } = sampleFrames(file, join3(dir, "frames"), m.duration, 1, 40);
+  const { frames, interval } = sampleFrames(file, join4(dir, "frames"), m.duration, 1, 40);
   const match = await call("match", { frames: frames.map(({ t, jpg_base64 }) => ({ t, jpg_base64 })), interval });
+  const sheet = contactSheet(frames, join4(dir, "sheet.jpg"));
   const timed = localWords(file, dir);
   const words = timed ?? approxWords(transcript, m.duration);
   const bs = beats(m, words, match.frames);
@@ -21929,6 +22077,7 @@ async function breakdownReel(input) {
     hook ? `- first line: "${hook}"` : "- no transcript (silent video or local file)",
     "",
     "## The look",
+    sheet ? "Every sampled frame, labelled with its time: sheet.jpg. The look below is the closest Cutroom parts; check it against the sheet." : "Sampled frames are in frames/. The look below is the closest Cutroom parts; check it against them.",
     "Layout, share of sampled frames:",
     ...Object.entries(s.layout_share).map(([k, v]) => `- ${k}: ${pct(v)}`),
     "Captions:",
@@ -21945,9 +22094,9 @@ async function breakdownReel(input) {
     transcript ?? "(none)",
     ""
   ].join("\n");
-  writeFileSync2(join3(dir, "breakdown.md"), md);
-  const out = { folder: dir, report: join3(dir, "breakdown.md"), hook, measure: m, look: s, beats: bs, words_timing: timed ? "measured" : transcript ? "approximate" : "none", transcript, meta: meta2, next: "Get the 'breakdown_writeup' method with get_method and follow it." };
-  writeFileSync2(join3(dir, "breakdown.json"), JSON.stringify(out, null, 2));
+  writeFileSync4(join4(dir, "breakdown.md"), md);
+  const out = { folder: dir, report: join4(dir, "breakdown.md"), sheet, hook, measure: m, look: s, beats: bs, words_timing: timed ? "measured" : transcript ? "approximate" : "none", transcript, meta: meta2, next: "Get the 'breakdown_writeup' method with get_method and follow it." };
+  writeFileSync4(join4(dir, "breakdown.json"), JSON.stringify(out, null, 2));
   return out;
 }
 function ctaKeyword(caption) {
@@ -21956,15 +22105,15 @@ function ctaKeyword(caption) {
 }
 async function teardownOne(handle, limit) {
   const { reels } = await call("reels", { handle, limit });
-  const dir = join3(studio.references(), `${day()}-${slug(handle)}-creator`);
-  mkdirSync3(join3(dir, "raw"), { recursive: true });
+  const dir = join4(studio.references(), `${day2()}-${slug2(handle)}-creator`);
+  mkdirSync4(join4(dir, "raw"), { recursive: true });
   const rows = [];
   for (const [i, r] of reels.entries()) {
     try {
-      const file = join3(dir, "raw", `${String(i + 1).padStart(2, "0")}-${r.shortCode}.mp4`);
-      if (!existsSync2(file)) await download(r.videoUrl, file);
+      const file = join4(dir, "raw", `${String(i + 1).padStart(2, "0")}-${r.shortCode}.mp4`);
+      if (!existsSync3(file)) await download(r.videoUrl, file);
       const m = measure(file);
-      const { frames, interval } = sampleFrames(file, join3(dir, "frames", r.shortCode), m.duration, 2, 20);
+      const { frames, interval } = sampleFrames(file, join4(dir, "frames", r.shortCode), m.duration, 2, 20);
       const [match, tr] = await Promise.all([call("match", { frames: frames.map(({ t, jpg_base64 }) => ({ t, jpg_base64 })), interval }), call("transcript", { url: r.url }).catch(() => ({ transcript: null }))]);
       const top = (o) => Object.keys(o)[0] ?? null;
       rows.push({ code: r.shortCode, url: r.url, posted: String(r.timestamp ?? "").slice(0, 10), plays: r.videoPlayCount ?? null, duration_s: Math.round(m.duration * 10) / 10, cuts_per_min: m.cuts_per_min, layout: top(match.summary.layout_share), caption: top(match.summary.caption_share), effects: match.summary.effects.filter((e) => e.share >= 0.1 || e.frames >= 2).map((e) => e.title), off_menu: match.summary.effects.filter((e) => e.in_menu === false).map((e) => e.title), hook: tr.transcript ? String(tr.transcript).split(/(?<=[.!?])\s/)[0] : null, cta: ctaKeyword(r.caption) });
@@ -22036,18 +22185,18 @@ async function creatorTeardown(input) {
     ...a.rows.map((x) => x.error ? `| ${x.posted} | ${x.plays ?? ""} | | | failed: ${String(x.error).slice(0, 60)} | | |` : `| [${x.posted}](${x.url}) | ${x.plays ?? ""} | ${x.duration_s} | ${x.cuts_per_min} | ${x.layout ?? ""} | ${x.effects.join(", ")} | ${(x.hook ?? "").replace(/\|/g, "/").slice(0, 90)} |`),
     ""
   ].join("\n");
-  writeFileSync2(join3(a.dir, "teardown.md"), md);
-  const out = { folder: a.dir, report: join3(a.dir, "teardown.md"), rollup: r, compare: cmp, rows: a.rows, next: "Get the 'teardown_writeup' method with get_method and follow it." };
-  writeFileSync2(join3(a.dir, "teardown.json"), JSON.stringify(out, null, 2));
+  writeFileSync4(join4(a.dir, "teardown.md"), md);
+  const out = { folder: a.dir, report: join4(a.dir, "teardown.md"), rollup: r, compare: cmp, rows: a.rows, next: "Get the 'teardown_writeup' method with get_method and follow it." };
+  writeFileSync4(join4(a.dir, "teardown.json"), JSON.stringify(out, null, 2));
   return out;
 }
 
 // src/community/local/studio.ts
 var studio = {
-  brand: () => join4(HOME(), "brand"),
-  references: () => join4(HOME(), "references"),
-  inbox: () => join4(HOME(), "inbox"),
-  videos: () => join4(HOME(), "videos")
+  brand: () => layout(HOME()).brand,
+  references: () => layout(HOME()).references,
+  inbox: () => layout(HOME()).inbox,
+  videos: () => layout(HOME()).videos
 };
 var CLAUDE_MD = `# My Cutroom studio
 
@@ -22057,13 +22206,14 @@ Everything for my videos lives in this folder. Open Claude Code here so it can s
 - inbox/: drop new raw videos here. When a video starts, its clip moves into that video's raw/ folder.
 - videos/<date>-<topic>/: one folder per video, with everything for it:
   - raw/: the footage
+  - references/: only what this video copies (Pinterest images, the reel it matches), each with a one-line "why it works" in references/notes.md
   - script.md: what I say, word for word
   - facts.md: every number or claim on screen, with its source
   - plan.md: the edit plan and a status line (footage ready, plan ready, preview, final, posted)
   - renders/: previews and the final export
   - checks.md: what QA found and what got fixed
 - brand/: my colors (brand.json), logo and a few frames I love.
-- references/: reels and creators I study, each with a breakdown of why it works.
+- references/: my library of reels and creators I study across videos, each with a breakdown of why it works.
 
 ## Rules
 - Three stops: I approve the script, then the plan, then the preview. Nothing final renders before that.
@@ -22074,78 +22224,25 @@ Everything for my videos lives in this folder. Open Claude Code here so it can s
 ## My rules
 `;
 function ensureStudio() {
-  for (const d of Object.values(studio)) mkdirSync4(d(), { recursive: true });
-  const claude = join4(HOME(), "CLAUDE.md");
-  if (!existsSync3(claude)) writeFileSync3(claude, CLAUDE_MD);
-  const oldBrand = join4(HOME(), "brand.json"), newBrand = join4(studio.brand(), "brand.json");
-  if (existsSync3(oldBrand) && !existsSync3(newBrand)) renameSync(oldBrand, newBrand);
+  ensureLayout(HOME(), CLAUDE_MD);
+  const oldBrand = join5(HOME(), "brand.json"), newBrand = join5(studio.brand(), "brand.json");
+  if (existsSync4(oldBrand) && !existsSync4(newBrand)) renameSync2(oldBrand, newBrand);
   return HOME();
 }
-var inside = (child, parent) => {
-  const r = relative(parent, child);
-  return !!r && !r.startsWith("..") && !isAbsolute(r);
-};
-function takeRaw(source, folder) {
-  const raw = join4(folder, "raw");
-  const file = resolve2(source);
-  if (inside(file, raw)) return { file, how: "already here" };
-  mkdirSync4(raw, { recursive: true });
-  let target = join4(raw, basename(file));
-  for (let n = 2; existsSync3(target); n++) target = join4(raw, basename(file).replace(/(\.[^.]*)?$/, `-${n}$1`));
-  if (inside(file, studio.inbox())) {
-    try {
-      renameSync(file, target);
-      return { file: target, how: "moved from inbox" };
-    } catch {
-    }
-  }
-  copyFileSync(file, target);
-  return { file: target, how: "copied" };
-}
-function setStatus(folder, status, plan) {
-  const file = join4(folder, "plan.md");
-  const name = basename(folder);
-  const current = existsSync3(file) ? readFileSync4(file, "utf8") : `# ${name}
-
-status: 
-`;
-  const withStatus = /^status:.*$/m.test(current) ? current.replace(/^status:.*$/m, `status: ${status}`) : current.replace(/^(# .*\n)/, `$1
-status: ${status}
-`);
-  writeFileSync3(file, plan === void 0 ? withStatus : `${withStatus.split(/\n## Plan\n/)[0].trimEnd()}
-
-## Plan
-${plan}
-`);
-}
-function startVideoNotes(folder, transcript) {
-  const script = join4(folder, "script.md"), facts = join4(folder, "facts.md");
-  if (!existsSync3(script)) writeFileSync3(script, `# Script
-
-What I say, word for word (from the footage; fix any misheard words here).
-
-${transcript}
-`);
-  if (!existsSync3(facts)) writeFileSync3(facts, "# Facts\n\nEvery number or claim that shows on screen, with where it comes from.\n\n| on screen | source |\n| - | - |\n");
-}
-function addCheck(folder, entry) {
-  const file = join4(folder, "checks.md");
-  if (!existsSync3(file)) writeFileSync3(file, "# Checks\n\nWhat QA found on each render, and what got fixed.\n");
-  appendFileSync(file, `
-${entry.trim()}
-`);
-}
+var takeRaw2 = (source, folder) => takeRaw(source, folder, studio.inbox());
+var startVideoNotes2 = (folder, transcript) => startVideoNotes(folder, transcript, "I say");
+var { setStatus: setStatus2, addCheck: addCheck2 } = studio_core_exports;
 
 // src/community/local/render.ts
 var HF = "hyperframes@0.8.99";
-var day2 = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-var slug2 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40) || "reel";
+var day3 = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+var slug3 = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40) || "reel";
 var sh = (cmd, args, cwd) => run(cmd, args, { cwd, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
 var tail = (s) => (s ?? "").trim().split("\n").slice(-6).join("\n");
-var projectFile = (folder) => join5(folder, ".cutroom", "project.json");
+var projectFile = (folder) => join6(folder, ".cutroom", "project.json");
 var resolveProject = (p) => {
   const folder = resolve3(p.replace(/^~/, homedir2()));
-  const file = [folder, join5(studio.videos(), p), join5(HOME(), "renders", p)].map(projectFile).find((f) => existsSync4(f)) ?? null;
+  const file = [folder, join6(studio.videos(), p), join6(HOME(), "renders", p)].map(projectFile).find((f) => existsSync5(f)) ?? null;
   if (!file) throw new Error(`No prepared footage at ${p}. Run prepare_footage first.`);
   return JSON.parse(readFileSync5(file, "utf8"));
 };
@@ -22163,19 +22260,19 @@ function looksLikeSpeech(words, duration3) {
 }
 async function prepareFootage(input) {
   const source = resolve3(input.video.replace(/^~/, homedir2()));
-  if (!existsSync4(source)) throw new Error(`No such file: ${source}`);
+  if (!existsSync5(source)) throw new Error(`No such file: ${source}`);
   const p = probe(source);
   if (!p.has_audio) throw new Error("That video has no sound. Cutroom finishing needs you talking to camera.");
   if (p.duration > 180) throw new Error("Keep it under 3 minutes for one reel.");
-  const name = slug2(input.name ?? basename2(source, extname(source)));
+  const name = slug3(input.name ?? basename2(source, extname(source)));
   ensureStudio();
-  const folder = join5(studio.videos(), `${day2()}-${name}`);
-  const work = join5(folder, ".cutroom");
+  const folder = join6(studio.videos(), `${day3()}-${name}`);
+  const work = join6(folder, ".cutroom");
   mkdirSync5(work, { recursive: true });
-  const clip = takeRaw(source, folder);
+  const clip = takeRaw2(source, folder);
   const segments = input.cut_pauses === false ? [[0, p.duration]] : keepSegments(p.duration, parseSilences(silenceLog(clip.file), p.duration));
   if (!segments.length) throw new Error("Couldn't find any speech in that video.");
-  const footage = join5(work, "footage.mp4");
+  const footage = join6(work, "footage.mp4");
   cutAndNormalize(clip.file, footage, segments);
   const duration3 = probe(footage).duration;
   const lang = (input.language ?? "en").toLowerCase().slice(0, 5);
@@ -22189,13 +22286,13 @@ async function prepareFootage(input) {
   })();
   if (t.status !== 0 || !meta2.ok) throw new Error(`Transcription failed. Run cutroom_doctor.
 ${meta2.error ?? tail(t.stderr)}`);
-  const raw = JSON.parse(readFileSync5(meta2.transcriptPath ?? join5(work, "transcript.json"), "utf8"));
+  const raw = JSON.parse(readFileSync5(meta2.transcriptPath ?? join6(work, "transcript.json"), "utf8"));
   const words = raw.map((w) => ({ t: Math.round(w.start * 100) / 100, e: Math.round(w.end * 100) / 100, w: w.text.trim() })).filter((w) => w.w);
   if (!looksLikeSpeech(words, duration3)) throw new Error(lang === "en" ? "I couldn't hear anyone talking in this video (it sounds like music or silence). Cutroom finishing needs you talking to camera. If you speak another language, tell me which one and I'll try again." : `I couldn't make out the speech in this video, even in that language. Check the sound is you talking to camera.`);
   const project = { name, folder, source: clip.file, footage, duration: Math.round(duration3 * 100) / 100, words, removed_s: Math.round((p.duration - duration3) * 10) / 10, segments };
-  writeFileSync4(projectFile(folder), JSON.stringify(project, null, 2));
-  startVideoNotes(folder, words.map((w) => w.w).join(" "));
-  setStatus(folder, "footage ready");
+  writeFileSync5(projectFile(folder), JSON.stringify(project, null, 2));
+  startVideoNotes2(folder, words.map((w) => w.w).join(" "));
+  setStatus2(folder, "footage ready");
   const landscape = (p.width ?? 0) > (p.height ?? 0) * 1.05;
   return {
     project: folder,
@@ -22204,19 +22301,19 @@ ${meta2.error ?? tail(t.stderr)}`);
     pauses_removed_s: project.removed_s,
     ...landscape ? { warning: "This video is landscape (wide). Cutroom crops the middle of it to make it vertical, so anything off-center gets cut, and an already-edited video (split screen, titles, captions burned in) will look wrong. Tell the user plainly and ask for the raw vertical take of them talking; continue only if they say this one is fine." } : {},
     transcript: words.map((w) => `${w.t.toFixed(2)} ${w.w}`).join("\n"),
-    next: "Check the transcript for misheard words (pass them as fixes). Then plan: list_styles, get_method('edit_plan') and follow it, then plan_reel to show the storyboard. Nothing renders until the user says go."
+    next: "Check the transcript for misheard words (pass them as fixes). References for this video go in its references/ folder. Then plan: list_styles, get_method('edit_plan') and follow it, then plan_reel to show the storyboard. Nothing renders until the user says go."
   };
 }
 async function ensureFonts(work) {
-  const cache = join5(HOME(), ".kit", "fonts");
+  const cache = join6(HOME(), ".kit", "fonts");
   const need = ["Inter-Regular.woff2", "Inter-SemiBold.woff2", "RobotoMono-Bold.ttf", "InstrumentSerif-Italic.ttf"];
-  if (!need.every((f) => existsSync4(join5(cache, f)))) {
+  if (!need.every((f) => existsSync5(join6(cache, f)))) {
     const { fonts } = await call("fonts");
     mkdirSync5(cache, { recursive: true });
-    for (const [f, b64] of Object.entries(fonts)) writeFileSync4(join5(cache, basename2(f)), Buffer.from(b64, "base64"));
+    for (const [f, b64] of Object.entries(fonts)) writeFileSync5(join6(cache, basename2(f)), Buffer.from(b64, "base64"));
   }
-  mkdirSync5(join5(work, "fonts"), { recursive: true });
-  for (const f of need) writeFileSync4(join5(work, "fonts", f), readFileSync5(join5(cache, f)));
+  mkdirSync5(join6(work, "fonts"), { recursive: true });
+  for (const f of need) writeFileSync5(join6(work, "fonts", f), readFileSync5(join6(cache, f)));
 }
 function applyFixes(words, fixes = []) {
   return words.map((w) => {
@@ -22224,9 +22321,9 @@ function applyFixes(words, fixes = []) {
     return f ? { ...w, w: f.to } : w;
   }).filter((w) => w.w);
 }
-var brandFile = () => join5(studio.brand(), "brand.json");
+var brandFile = () => join6(studio.brand(), "brand.json");
 function getBrand() {
-  for (const f of [brandFile(), join5(HOME(), "brand.json")]) {
+  for (const f of [brandFile(), join6(HOME(), "brand.json")]) {
     try {
       return JSON.parse(readFileSync5(f, "utf8"));
     } catch {
@@ -22236,14 +22333,14 @@ function getBrand() {
 }
 async function setBrand(input) {
   if (input.reset) {
-    rmSync2(brandFile(), { force: true });
+    rmSync3(brandFile(), { force: true });
     return { brand: null, saved: "Back to the default look." };
   }
   const { reset, ...fields } = input;
   const next = { ...getBrand() ?? {}, ...Object.fromEntries(Object.entries(fields).filter(([, v]) => v)) };
   await call("compose", { duration: 2, words: [], brand: next, check_only: true });
   ensureStudio();
-  writeFileSync4(brandFile(), JSON.stringify(next, null, 2));
+  writeFileSync5(brandFile(), JSON.stringify(next, null, 2));
   return { brand: next, saved: brandFile(), next: "Every render now uses these. Render a draft to see them." };
 }
 var PICTURE = /\.(jpe?g|png|webp)$/i;
@@ -22251,21 +22348,21 @@ function safeAssetName(file, i) {
   const m = basename2(file).match(PICTURE);
   if (!m) throw new Error(`Pictures must be jpg, png or webp: ${file}`);
   const ext = m[1].toLowerCase() === "jpeg" ? "jpg" : m[1].toLowerCase();
-  return `${i + 1}-${slug2(basename2(file, extname(file)))}.${ext}`;
+  return `${i + 1}-${slug3(basename2(file, extname(file)))}.${ext}`;
 }
 function localImages(work, layoutImages, effects) {
   const names = /* @__PURE__ */ new Map();
-  const dir = join5(work, "assets");
+  const dir = join6(work, "assets");
   const swap = (v) => {
     const raw = String(v ?? "").trim();
-    if (/^assets\/[\w.-]+$/.test(raw) && existsSync4(join5(work, raw))) return raw;
+    if (/^assets\/[\w.-]+$/.test(raw) && existsSync5(join6(work, raw))) return raw;
     const file = resolve3(raw.replace(/^~(?=$|\/)/, homedir2()));
     if (!names.has(file)) {
-      if (!existsSync4(file) || !statSync(file).isFile()) throw new Error(`Can't find the picture ${raw}. Use the full path of a jpg, png or webp file on this computer.`);
+      if (!existsSync5(file) || !statSync(file).isFile()) throw new Error(`Can't find the picture ${raw}. Use the full path of a jpg, png or webp file on this computer.`);
       if (names.size >= 8) throw new Error("8 pictures at most per reel.");
       const name = safeAssetName(file, names.size);
       mkdirSync5(dir, { recursive: true });
-      copyFileSync2(file, join5(dir, name));
+      copyFileSync2(file, join6(dir, name));
       names.set(file, `assets/${name}`);
     }
     return names.get(file);
@@ -22278,10 +22375,10 @@ function localImages(work, layoutImages, effects) {
   }));
   return { images, effects: fx, count: names.size };
 }
-async function wantsCutout(layout, effects) {
+async function wantsCutout(layout2, effects) {
   const styles = await call("styles");
   const slugs = new Set(effects.map((f) => String(f.slug)));
-  return [...styles.layouts.filter((l) => l.slug === (layout ?? "full-frame")), ...styles.effects.filter((e) => slugs.has(e.slug))].some((x) => x.needs?.includes("cutout"));
+  return [...styles.layouts.filter((l) => l.slug === (layout2 ?? "full-frame")), ...styles.effects.filter((e) => slugs.has(e.slug))].some((x) => x.needs?.includes("cutout"));
 }
 function headTop(work, duration3) {
   const tops = [];
@@ -22302,7 +22399,7 @@ function headTop(work, duration3) {
   return tops.length ? tops[Math.floor(tops.length / 2)] : void 0;
 }
 function ensureCutout(work, duration3) {
-  const footage = join5(work, "footage.mp4"), cut = join5(work, "cut.webm"), stamp = join5(work, "cut.json"), still = join5(work, "assets", "still.jpg");
+  const footage = join6(work, "footage.mp4"), cut = join6(work, "cut.webm"), stamp = join6(work, "cut.json"), still = join6(work, "assets", "still.jpg");
   const st = statSync(footage);
   const key = { size: st.size, mtime: Math.round(st.mtimeMs) };
   let cached2 = null;
@@ -22311,31 +22408,31 @@ function ensureCutout(work, duration3) {
   } catch {
   }
   let made_s = 0;
-  if (!(cached2 && cached2.size === key.size && cached2.mtime === key.mtime && existsSync4(cut))) {
+  if (!(cached2 && cached2.size === key.size && cached2.mtime === key.mtime && existsSync5(cut))) {
     const started = Date.now();
     const r = sh("npx", ["--yes", HF, "remove-background", "footage.mp4", "-o", "cut.webm", "--json"], work);
-    if (r.status !== 0 || !existsSync4(cut)) throw new Error(`Couldn't cut you out of the background. Run cutroom_doctor.
+    if (r.status !== 0 || !existsSync5(cut)) throw new Error(`Couldn't cut you out of the background. Run cutroom_doctor.
 ${tail(r.stderr) || tail(r.stdout)}`);
     made_s = Math.round((Date.now() - started) / 100) / 10;
     cached2 = { ...key, head: headTop(work, duration3), made_s };
-    writeFileSync4(stamp, JSON.stringify(cached2));
+    writeFileSync5(stamp, JSON.stringify(cached2));
   }
-  if (!existsSync4(still)) {
-    mkdirSync5(join5(work, "assets"), { recursive: true });
+  if (!existsSync5(still)) {
+    mkdirSync5(join6(work, "assets"), { recursive: true });
     sh("ffmpeg", ["-nostdin", "-v", "error", "-y", "-ss", (duration3 / 3).toFixed(2), "-i", "footage.mp4", "-frames:v", "1", "-q:v", "3", still], work);
   }
   return { head: cached2.head, made_s };
 }
-var planFile = (folder) => join5(folder, ".cutroom", "plan.json");
+var planFile = (folder) => join6(folder, ".cutroom", "plan.json");
 async function composition(input) {
   const pj = resolveProject(input.project);
-  const work = join5(pj.folder, ".cutroom");
+  const work = join6(pj.folder, ".cutroom");
   const words = applyFixes(pj.words, input.fixes);
   const local = localImages(work, input.images, input.effects ?? []);
   const cutout = await wantsCutout(input.layout, local.effects) ? ensureCutout(work, pj.duration) : null;
   const { html } = await call("compose", { duration: pj.duration, words, layout: input.layout, caption: input.caption, effects: local.effects, images: local.images, emphasis: input.emphasis, brand: getBrand() ?? void 0, ...cutout ? { cutout: true, head: cutout.head } : {} });
   await ensureFonts(work);
-  writeFileSync4(join5(work, "meta.json"), JSON.stringify({ id: pj.name, name: pj.name }));
+  writeFileSync5(join6(work, "meta.json"), JSON.stringify({ id: pj.name, name: pj.name }));
   return { pj, work, html, cutout, words };
 }
 var fmtT = (t) => `${t.toFixed(1)}s`;
@@ -22351,7 +22448,7 @@ async function planReel(input) {
   };
   const plainAt = !effects.length ? Math.min(1.2, pj.duration / 2) : Number(effects[0].start) > 2 ? 1.2 : null;
   const styles = await call("styles");
-  const title = (list, slug3) => (list.find((x) => x.slug === slug3)?.title ?? String(slug3)).replace(/\s*\(.*\)$/, "");
+  const title = (list, slug4) => (list.find((x) => x.slug === slug4)?.title ?? String(slug4)).replace(/\s*\(.*\)$/, "");
   const sentences = words.reduce((out, w, k) => {
     if (!out.length || /[.!?]["”']?$/.test(words[k - 1]?.w ?? "")) out.push({ t: w.t, text: [] });
     out[out.length - 1].text.push(w.w);
@@ -22385,31 +22482,31 @@ async function planReel(input) {
       return { t: Number(f.start), end: ends[k], what: `${name}${fxLine(f) ? `: ${fxLine(f)}` : ""}`, tag: name, at: peak(f) };
     })
   ];
-  const shots = join5(work, "storyboard");
-  rmSync2(shots, { recursive: true, force: true });
-  writeFileSync4(join5(work, "index.html"), html);
+  const shots = join6(work, "storyboard");
+  rmSync3(shots, { recursive: true, force: true });
+  writeFileSync5(join6(work, "index.html"), html);
   let r;
   try {
     r = sh("npx", ["--yes", HF, "snapshot", "--at", moments.map((m) => m.at.toFixed(2)).join(","), "--no-end", "--describe", "false", "-o", "storyboard", "."], work);
   } finally {
-    rmSync2(join5(work, "index.html"), { force: true });
+    rmSync3(join6(work, "index.html"), { force: true });
   }
-  const pngs = existsSync4(shots) ? readdirSync(shots).filter((f) => f.endsWith(".png")).sort() : [];
+  const pngs = existsSync5(shots) ? readdirSync2(shots).filter((f) => f.endsWith(".png")).sort() : [];
   if (r.status !== 0 || pngs.length < moments.length) throw new Error(`Couldn't make the storyboard. Run cutroom_doctor.
 ${tail(r.stderr) || tail(r.stdout)}`);
-  const board = join5(pj.folder, "storyboard.jpg");
+  const board = join6(pj.folder, "storyboard.jpg");
   const cols = Math.min(4, moments.length);
   const label = (s) => s.replace(/[\\':%,]/g, " ").slice(0, 42);
-  const inputs = pngs.slice(0, moments.length).flatMap((f) => ["-i", join5(shots, f)]);
+  const inputs = pngs.slice(0, moments.length).flatMap((f) => ["-i", join6(shots, f)]);
   const cells = moments.map((m, k) => `[${k}:v]scale=270:480,pad=270:540:0:0:#0A0A0A,drawtext=text='${label(`${fmtT(m.t)}  ${m.tag}`)}':x=10:y=496:fontsize=18:fontcolor=#F7F3E8[c${k}]`).join(";");
   const layoutXY = moments.map((_, k) => `${k % cols * 270}_${Math.floor(k / cols) * 540}`).join("|");
   const stack = moments.length === 1 ? `[c0]copy[out]` : `${moments.map((_, k) => `[c${k}]`).join("")}xstack=inputs=${moments.length}:layout=${layoutXY}:fill=#0A0A0A[out]`;
   const t = sh("ffmpeg", ["-nostdin", "-v", "error", "-y", ...inputs, "-filter_complex", `${cells};${stack}`, "-map", "[out]", "-frames:v", "1", "-q:v", "3", board]);
   if (t.status !== 0) throw new Error(`Couldn't tile the storyboard.
 ${tail(t.stderr)}`);
-  rmSync2(shots, { recursive: true, force: true });
+  rmSync3(shots, { recursive: true, force: true });
   const plan = { layout: input.layout ?? "full-frame", caption: input.caption ?? "two-tier", effects, images: input.images, emphasis: input.emphasis, fixes: input.fixes };
-  writeFileSync4(planFile(pj.folder), JSON.stringify(plan, null, 2));
+  writeFileSync5(planFile(pj.folder), JSON.stringify(plan, null, 2));
   const text = [
     `Plan for ${pj.name} (${pj.duration.toFixed(1)}s). Layout: ${title(styles.layouts, plan.layout)}. Captions: ${title(styles.captions, plan.caption)}.${cutout ? " You are cut out of the background for this one (done)." : ""}`,
     "",
@@ -22419,41 +22516,41 @@ ${tail(t.stderr)}`);
     "",
     `Storyboard: ${board}`
   ].join("\n");
-  setStatus(pj.folder, "plan ready (waiting for your go)", text.replace(board, "storyboard.jpg"));
+  setStatus2(pj.folder, "plan ready (waiting for your go)", text.replace(board, "storyboard.jpg"));
   return { text, storyboard: board, plan, words_used: words.length, next: "Show this table as it is (plain words, no effect codes) and the storyboard. On changes, plan_reel again with the new choice. On a go, render_reel with plan:true and draft:true." };
 }
 async function renderReel(input) {
   if (input.plan) {
     const folder = resolveProject(input.project).folder;
-    if (!existsSync4(planFile(folder))) throw new Error("No plan yet for this project. Make one with plan_reel first.");
+    if (!existsSync5(planFile(folder))) throw new Error("No plan yet for this project. Make one with plan_reel first.");
     input = { ...JSON.parse(readFileSync5(planFile(folder), "utf8")), project: input.project, draft: input.draft };
   }
   const { pj, work, html, cutout } = await composition(input);
-  mkdirSync5(join5(pj.folder, "renders"), { recursive: true });
-  const out = join5(pj.folder, "renders", `${pj.name}${input.draft ? "-draft" : ""}.mp4`);
-  const tmp = join5(work, "render.mp4");
-  writeFileSync4(join5(work, "index.html"), html);
+  mkdirSync5(join6(pj.folder, "renders"), { recursive: true });
+  const out = join6(pj.folder, "renders", `${pj.name}${input.draft ? "-draft" : ""}.mp4`);
+  const tmp = join6(work, "render.mp4");
+  writeFileSync5(join6(work, "index.html"), html);
   const started = Date.now();
   let r;
   try {
     r = sh("npx", ["--yes", HF, "render", "-q", input.draft ? "draft" : "delivery", "-o", "render.mp4", "."], work);
   } finally {
-    rmSync2(join5(work, "index.html"), { force: true });
+    rmSync3(join6(work, "index.html"), { force: true });
   }
-  if (r.status !== 0 || !existsSync4(tmp)) throw new Error(`Render failed. Run cutroom_doctor.
+  if (r.status !== 0 || !existsSync5(tmp)) throw new Error(`Render failed. Run cutroom_doctor.
 ${tail(r.stderr) || tail(r.stdout)}`);
-  renameSync2(tmp, out);
+  renameSync3(tmp, out);
   const render_s = Math.round((Date.now() - started) / 100) / 10;
   const { report: checks, ...qa } = await qaVideo({ video: out, layout: input.layout });
-  addCheck(pj.folder, checks);
-  setStatus(pj.folder, input.draft ? "preview" : "final");
+  addCheck2(pj.folder, checks);
+  setStatus2(pj.folder, input.draft ? "preview" : "final");
   return { video: out, render_s, ...cutout?.made_s ? { cutout_s: cutout.made_s } : {}, qa, next: qa.passed ? "Watch it once, then it's ready to post." : qa.technical?.length ? "Fix the technical issues listed, then render again." : "Look at each flagged spot yourself (grab the frame) and tell the user which are real problems, with the fix, and which are the design." };
 }
 async function qaVideo(input) {
   const file = resolve3(input.video.replace(/^~/, homedir2()));
-  if (!existsSync4(file)) throw new Error(`No such file: ${file}`);
+  if (!existsSync5(file)) throw new Error(`No such file: ${file}`);
   const tech = technicalChecks(file);
-  const dir = mkdtempSync(join5(tmpdir(), "cutroom-qa-"));
+  const dir = mkdtempSync(join6(tmpdir(), "cutroom-qa-"));
   const { frames } = sampleFrames(file, dir, tech.duration, Math.max(1, Math.round(tech.duration / 20 * 10) / 10), 20);
   let flags = [];
   let judged = 0, judge_error = null;
@@ -22464,7 +22561,7 @@ async function qaVideo(input) {
   } catch (e) {
     judge_error = e.message;
   }
-  rmSync2(dir, { recursive: true, force: true });
+  rmSync3(dir, { recursive: true, force: true });
   const look = flags.map((f) => `${f.t.toFixed(1)}s: ${f.text} (${Math.round(f.p_yes * 100)}%)`);
   const passed = !tech.issues.length && !flags.length && !judge_error;
   const report = {
@@ -22489,8 +22586,76 @@ async function qaVideo(input) {
   return { ...report, report: md };
 }
 
+// src/community/local/prompts.ts
+var say = (label, value) => value?.trim() ? ` ${label}: ${value.trim()}.` : "";
+var PROMPTS = [
+  {
+    name: "copy-reel",
+    title: "Copy a reel's format",
+    description: "Your version of a reel: its structure, pacing and look, with your topic and words.",
+    args: [{ name: "link", description: "The reel (Instagram link or a video file path)" }, { name: "topic", description: "Your topic (optional)" }],
+    ask: (a) => `Copy a reel's format for me: get_method('copy_reel') and follow it step by step.${say("Reel", a.link)}${say("My topic", a.topic)}${a.link ? "" : " Ask me for the reel first."}`
+  },
+  {
+    name: "finish-video",
+    title: "Finish a raw video",
+    description: "Turn a raw video of you talking into a finished reel: captions, effects, your brand.",
+    args: [{ name: "video", description: "The raw video file (optional: otherwise the newest in your inbox)" }],
+    ask: (a) => `Finish my raw video into a reel: get_method('finish_video') and follow it step by step.${say("Video", a.video)}${a.video ? "" : " Use the newest video in my studio's inbox/ and tell me which one you picked."}`
+  },
+  {
+    name: "breakdown",
+    title: "Break down a reel",
+    description: "Why a reel works: hook, beats, pacing and the look, with how you'd make your own.",
+    args: [{ name: "link", description: "The reel (Instagram link or a video file path)" }],
+    ask: (a) => `Break down this reel: breakdown_reel, then get_method('breakdown_writeup') and follow it.${say("Reel", a.link)}${a.link ? "" : " Ask me for the reel first."}`
+  },
+  {
+    name: "teardown",
+    title: "Tear down a creator",
+    description: "A creator's system from their latest reels, and the gap to yours.",
+    args: [{ name: "handle", description: "Their Instagram handle" }, { name: "compare_to", description: "Your handle (optional)" }],
+    ask: (a) => `Tear down this creator: creator_teardown, then get_method('teardown_writeup') and follow it.${say("Their handle", a.handle)}${say("Compare to my handle", a.compare_to)}${a.handle ? "" : " Ask me for their handle first."}`
+  },
+  {
+    name: "hooks",
+    title: "Write hooks",
+    description: "Hooks for your next video, scored and ranked.",
+    args: [{ name: "topic", description: "What the video is about" }],
+    ask: (a) => `Write hooks for my next video: get_method('hooks') and follow it.${say("Topic", a.topic)}${a.topic ? "" : " Ask me for the topic first."}`
+  },
+  {
+    name: "script",
+    title: "Write a short script",
+    description: "An 8-line short script for one idea, scored.",
+    args: [{ name: "topic", description: "The idea" }],
+    ask: (a) => `Write a short script: get_method('script') and follow it.${say("Idea", a.topic)}${a.topic ? "" : " Ask me for the idea first."}`
+  },
+  {
+    name: "caption",
+    title: "Write the post caption",
+    description: "The caption and comment-keyword CTA for a finished video.",
+    args: [{ name: "topic", description: "The video (optional)" }],
+    ask: (a) => `Write the post caption: get_method('caption') and follow it.${say("Video", a.topic)}`
+  },
+  {
+    name: "brand",
+    title: "Set your brand",
+    description: "See or change the colors and font every render uses.",
+    args: [],
+    ask: () => "Show my Cutroom brand kit with show_brand. If none is set, offer to set one with set_brand (from colors, a website or a logo), show me the colors, and save only on my yes."
+  },
+  {
+    name: "doctor",
+    title: "Check Cutroom setup",
+    description: "Check everything Cutroom needs on this computer and fix what's missing.",
+    args: [],
+    ask: () => "Check my Cutroom setup with cutroom_doctor and give me a short checklist with the fix for anything missing."
+  }
+];
+
 // src/community/local/server.ts
-process.env.PATH = (WIN ? [process.env.PATH, join6(process.env.LOCALAPPDATA ?? join6(homedir3(), "AppData", "Local"), "Microsoft", "WinGet", "Links"), "C:\\Program Files\\nodejs"] : [process.env.PATH, "/opt/homebrew/bin", "/usr/local/bin", join6(homedir3(), ".local", "bin")]).filter(Boolean).join(delimiter);
+process.env.PATH = (WIN ? [process.env.PATH, join7(process.env.LOCALAPPDATA ?? join7(homedir3(), "AppData", "Local"), "Microsoft", "WinGet", "Links"), "C:\\Program Files\\nodejs"] : [process.env.PATH, "/opt/homebrew/bin", "/usr/local/bin", join7(homedir3(), ".local", "bin")]).filter(Boolean).join(delimiter);
 var result = (value) => ({ content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }] });
 var failure2 = (error2) => ({ isError: true, content: [{ type: "text", text: error2 instanceof Error ? error2.message : String(error2) }] });
 var safe = (op) => Promise.resolve().then(op).then(result).catch(failure2);
@@ -22501,6 +22666,9 @@ Setup or any failure: cutroom_doctor, then a short checklist. If they aren't sig
 Finish a video (a raw video of them talking: edit it, captions, effects, make it a reel): get_method('finish_video') first and follow it step by step. Nothing renders until they approve the plan.
 
 Hooks, scripts, captions: get_method('hooks', 'script' or 'caption') and follow it.
+
+Copy a reel (their own version of a reel's format, on their topic): get_method('copy_reel') and follow it step by step. Nothing gets filmed or rendered until they approve the script.
+
 Break down a reel: breakdown_reel, then get_method('breakdown_writeup').
 Tear down a creator: creator_teardown (compare_to = their handle), then get_method('teardown_writeup').
 
@@ -22508,7 +22676,7 @@ Before a first render: show_brand; if none, offer set_brand (from colors, a webs
 
 QA flags are spots to check: look at each flagged frame yourself and say which are real problems (with the fix) and which are the design.
 
-Their studio is the Cutroom folder in their home folder (cutroom_doctor returns the path): inbox/ for new raw videos (look there first when they say "my video" without a path), videos/<date>-<topic>/ with everything for one video (raw/, script.md, facts.md, plan.md with its status line, renders/, checks.md), brand/, references/ for breakdowns and teardowns, and CLAUDE.md with their rules. Put every number shown on screen in that video's facts.md with its source; when QA finds a real mistake, offer to add a rule to their CLAUDE.md. To list videos or what's unfinished, read the status lines in videos/*/plan.md. Other creators' reels are for study only: never reuse their words, footage or branding.`;
+Their studio is the Cutroom folder in their home folder (cutroom_doctor returns the path): inbox/ for new raw videos (look there first when they say "my video" without a path), videos/<date>-<topic>/ with everything for one video (raw/, references/, script.md, facts.md, plan.md with its status line, renders/, checks.md), brand/, references/ as the library for breakdowns and teardowns, and CLAUDE.md with their rules. When they give a reference for one video (an image, a link, a reel to match), save it in that video's references/ and add a line to its references/notes.md saying what it is and why it works; pictures for plan_reel and render_reel can come from there. breakdown_reel and creator_teardown still go to the top-level references/ library. Put every number shown on screen in that video's facts.md with its source; when QA finds a real mistake, offer to add a rule to their CLAUDE.md. To list videos or what's unfinished, read the status lines in videos/*/plan.md. Other creators' reels are for study only: never reuse their words, footage or branding.`;
 await serveStdio(() => {
   const server = new McpServer({ name: "cutroom", version: VERSION }, { instructions: INSTRUCTIONS });
   server.registerTool("cutroom_doctor", {
@@ -22524,7 +22692,7 @@ await serveStdio(() => {
     inputSchema: object({})
   }, async () => safe(() => call("methods")));
   server.registerTool("get_method", {
-    description: "Get a Cutroom method and follow it step by step: 'hooks' for video hooks, 'script' for an 8-line short script, 'caption' for the post caption and comment CTA, 'breakdown_writeup' and 'teardown_writeup' after those tools. Always fetch the method fresh; it is updated on the server.",
+    description: "Get a Cutroom method and follow it step by step: 'hooks' for video hooks, 'script' for an 8-line short script, 'caption' for the post caption and comment CTA, 'copy_reel' to copy a reel's format onto their topic, 'breakdown_writeup' and 'teardown_writeup' after those tools. Always fetch the method fresh; it is updated on the server.",
     inputSchema: object({ name: string2().min(1) })
   }, async ({ name }) => safe(async () => {
     const m = await call("method", { name });
@@ -22615,7 +22783,13 @@ ${r.next}` }, { type: "image", data: readFileSync6(r.storyboard).toString("base6
   server.registerTool("qa_video", {
     description: "QA any finished vertical video: black or frozen picture, loudness, dead air, size, and every sampled frame judged for visual problems (cut-off text, covered face, empty frames). Returns passed plus the issues with timestamps.",
     inputSchema: object({ video: string2().min(1), layout: string2().optional().describe("The layout used, if it puts the face in a card (e.g. explainer-panel), so the card edge is not flagged.") })
-  }, async ({ video, layout }) => safe(() => qaVideo({ video, layout })));
+  }, async ({ video, layout: layout2 }) => safe(() => qaVideo({ video, layout: layout2 })));
+  for (const p of PROMPTS) {
+    const shape = Object.fromEntries(p.args.map((a) => [a.name, string2().optional().describe(a.description)]));
+    server.registerPrompt(p.name, { title: p.title, description: p.description, argsSchema: object(shape) }, (args) => ({
+      messages: [{ role: "user", content: { type: "text", text: p.ask(args ?? {}) } }]
+    }));
+  }
   return server;
 });
 /*! Bundled license information:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keepylabs/cutroom",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Cutroom for Claude Code: hooks and scripts with scoring, reel breakdowns, creator teardowns, and finishing your own videos with QA. Sign in with your Keepy Labs membership on Whop.",
   "type": "module",
   "bin": {