reel-studio 0.2.1 → 0.2.3

package/desk/desk.css

@@ -0,0 +1,120 @@
+:root {
+  --bg: #f4f3ef; --surface: #ffffff; --sunk: #eceae4; --line: #dcd9d1; --ink: #1d1c1a; --muted: #6f6c65;
+  --accent: #d9481f; --accent-ink: #fff; --ok: #2f7d4f; --warn: #a86a00; --stage: #16161a;
+  --mono: ui-monospace, "SF Mono", Menlo, monospace;
+  color-scheme: light;
+}
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]) {
+    --bg: #121214; --surface: #1b1b1f; --sunk: #232328; --line: #303036; --ink: #ecebe8; --muted: #9a978f;
+    --accent: #ff6a3d; --accent-ink: #160a05; --ok: #59c184; --warn: #e0a640; --stage: #0a0a0c;
+    color-scheme: dark;
+  }
+}
+:root[data-theme="dark"] {
+  --bg: #121214; --surface: #1b1b1f; --sunk: #232328; --line: #303036; --ink: #ecebe8; --muted: #9a978f;
+  --accent: #ff6a3d; --accent-ink: #160a05; --ok: #59c184; --warn: #e0a640; --stage: #0a0a0c;
+  color-scheme: dark;
+}
+
+* { box-sizing: border-box; }
+[hidden] { display: none !important; }
+html, body { margin: 0; height: 100%; }
+body { background: var(--bg); color: var(--ink); font: 14px/1.45 system-ui, -apple-system, sans-serif; display: flex; flex-direction: column; }
+button, input, textarea { font: inherit; color: inherit; }
+button { background: var(--sunk); border: 1px solid var(--line); border-radius: 7px; padding: 6px 11px; cursor: pointer; }
+button:hover { border-color: var(--muted); }
+button:disabled { opacity: .5; cursor: default; }
+button.primary { background: var(--accent); color: var(--accent-ink); border-color: transparent; font-weight: 600; }
+button.wide { width: 100%; margin-top: 10px; }
+input, textarea { background: var(--surface); border: 1px solid var(--line); border-radius: 7px; padding: 7px 9px; width: 100%; }
+textarea { resize: vertical; }
+code, .mono { font-family: var(--mono); font-size: 12px; }
+.muted { color: var(--muted); }
+.small { font-size: 12px; }
+.row { display: flex; gap: 8px; align-items: center; margin: 8px 0; }
+.wrap { flex-wrap: wrap; }
+h4 { margin: 18px 0 6px; font-size: 12px; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); }
+
+.top { display: flex; align-items: center; gap: 18px; padding: 10px 16px; border-bottom: 1px solid var(--line); background: var(--surface); }
+.brand { font-weight: 700; white-space: nowrap; }
+.logo { color: var(--accent); }
+.crumb { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--muted); }
+.status { font-size: 12px; color: var(--muted); white-space: nowrap; }
+
+.shell { flex: 1; min-height: 0; display: grid; grid-template-columns: 250px 1fr 360px; }
+.side { border-right: 1px solid var(--line); padding: 12px; overflow: auto; }
+.filter { margin-bottom: 10px; }
+.plist { list-style: none; margin: 0; padding: 0; }
+.plist .brandname { font-size: 11px; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); margin: 12px 4px 4px; }
+.plist button { display: block; width: 100%; text-align: left; background: none; border: 1px solid transparent; padding: 7px 8px; }
+.plist button.on { background: var(--surface); border-color: var(--line); }
+.plist .t { display: block; font-weight: 600; font-size: 13px; }
+.plist .s { display: flex; gap: 6px; align-items: center; font-size: 11px; color: var(--muted); }
+.pill { font-size: 10px; padding: 1px 6px; border-radius: 99px; background: var(--sunk); color: var(--muted); }
+.pill.notes { background: var(--accent); color: var(--accent-ink); }
+.pill.ok { color: var(--ok); }
+
+.viewer { display: flex; flex-direction: column; min-width: 0; min-height: 0; background: var(--stage); }
+.stage-wrap { flex: 1; min-height: 0; position: relative; overflow: hidden; }
+.stage-wrap iframe { position: absolute; left: 50%; top: 50%; border: 0; transform-origin: 0 0; background: #000; box-shadow: 0 6px 30px rgba(0,0,0,.4); }
+.stage-wrap iframe.loading { visibility: hidden; }
+.empty { position: absolute; inset: 0; display: grid; place-content: center; text-align: center; color: #cfcdc7; padding: 24px; }
+.empty .muted { color: #8c8a84; }
+.transport { display: flex; align-items: center; gap: 8px; padding: 10px 14px; background: var(--surface); border-top: 1px solid var(--line); }
+.icon { width: 34px; padding: 6px 0; }
+.time { width: 110px; text-align: right; color: var(--muted); }
+.toggle { display: flex; gap: 4px; align-items: center; font-size: 12px; color: var(--muted); }
+.toggle input { width: auto; }
+.scrub { flex: 1; position: relative; height: 28px; cursor: pointer; touch-action: none; }
+.track { position: absolute; left: 0; right: 0; top: 12px; height: 4px; background: var(--sunk); border-radius: 2px; overflow: hidden; }
+.fill { height: 100%; background: var(--muted); width: 0; }
+.head { position: absolute; top: 5px; width: 2px; height: 18px; background: var(--ink); transform: translateX(-1px); pointer-events: none; }
+.marks .m { position: absolute; top: 2px; width: 9px; height: 9px; border-radius: 50%; background: var(--accent); transform: translateX(-4px); border: 2px solid var(--surface); }
+.marks .m.fixed { background: var(--ok); }
+
+.panel { border-left: 1px solid var(--line); display: flex; flex-direction: column; min-height: 0; background: var(--surface); }
+.tabs { display: flex; border-bottom: 1px solid var(--line); }
+.tabs button { flex: 1; background: none; border: 0; border-bottom: 2px solid transparent; border-radius: 0; padding: 10px 4px; color: var(--muted); }
+.tabs button.on { color: var(--ink); border-bottom-color: var(--accent); font-weight: 600; }
+.count { font-size: 10px; background: var(--accent); color: var(--accent-ink); border-radius: 99px; padding: 0 6px; }
+.count:empty { display: none; }
+.tab { padding: 12px; overflow: auto; flex: 1; }
+.noteform { display: grid; gap: 6px; }
+.at { color: var(--accent); }
+.seg { display: flex; margin: 12px 0 8px; }
+.seg button { flex: 1; border-radius: 0; font-size: 12px; padding: 4px; }
+.seg button:first-child { border-radius: 7px 0 0 7px; }
+.seg button:last-child { border-radius: 0 7px 7px 0; }
+.seg button.on { background: var(--ink); color: var(--surface); }
+.notes { list-style: none; margin: 0; padding: 0; display: grid; gap: 6px; }
+.note { border: 1px solid var(--line); border-radius: 8px; padding: 8px 10px; }
+.note .h { display: flex; gap: 6px; align-items: center; font-size: 11px; color: var(--muted); }
+.note .h a { color: var(--accent); cursor: pointer; font-family: var(--mono); }
+.note .h .sp { flex: 1; }
+.note .h button { padding: 1px 6px; font-size: 11px; }
+.note p { margin: 4px 0 0; }
+.note .reply { margin-top: 6px; padding-left: 8px; border-left: 2px solid var(--ok); color: var(--muted); font-size: 13px; }
+.note.fixed { border-color: color-mix(in srgb, var(--ok) 50%, var(--line)); }
+.note.closed { opacity: .6; }
+.log { background: var(--sunk); border-radius: 8px; padding: 10px; font: 11.5px/1.5 var(--mono); white-space: pre-wrap; word-break: break-word; max-height: 50vh; overflow: auto; margin: 10px 0 0; }
+.log:empty { display: none; }
+.renderout img { max-width: 100%; border-radius: 6px; margin-top: 8px; }
+.renderout video { max-width: 100%; margin-top: 8px; }
+.exports, .approvals { list-style: none; padding: 0; margin: 0; font-size: 13px; }
+.exports a { color: var(--accent); }
+.approvals li { color: var(--ok); }
+
+.md { font-size: 13px; }
+.md h1 { font-size: 17px; } .md h2 { font-size: 15px; margin-top: 18px; } .md h3 { font-size: 14px; }
+.md table { border-collapse: collapse; width: 100%; font-size: 12px; display: block; overflow-x: auto; }
+.md td, .md th { border: 1px solid var(--line); padding: 4px 6px; vertical-align: top; }
+.md blockquote { margin: 6px 0; padding-left: 10px; border-left: 3px solid var(--line); color: var(--muted); }
+.md pre { background: var(--sunk); padding: 8px; border-radius: 6px; overflow: auto; }
+
+@media (max-width: 1000px) {
+  .shell { grid-template-columns: 1fr; grid-template-rows: auto 60vh auto; }
+  .side { border-right: 0; border-bottom: 1px solid var(--line); max-height: 30vh; }
+  .panel { border-left: 0; border-top: 1px solid var(--line); }
+  .crumb { display: none; }
+}

package/desk/index.html

@@ -0,0 +1,102 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Reel Studio Desk</title>
+<link rel="stylesheet" href="/desk/desk.css">
+</head>
+<body>
+<header class="top">
+  <div class="brand"><span class="logo">●</span> Reel Studio <span class="muted">desk</span></div>
+  <div class="crumb" id="crumb">Pick a production</div>
+  <div class="status" id="status"></div>
+</header>
+
+<main class="shell">
+  <nav class="side">
+    <input id="filter" class="filter" placeholder="Filter productions" autocomplete="off">
+    <ul id="productions" class="plist"></ul>
+  </nav>
+
+  <section class="viewer">
+    <div class="stage-wrap" id="stageWrap">
+      <div class="empty" id="empty">Pick a production on the left.<br><span class="muted">Compositions play here, frame-exact, through the same clock the renderer uses.</span></div>
+      <iframe id="comp" title="Composition" hidden></iframe>
+    </div>
+    <div class="transport" id="transport" hidden>
+      <button id="play" class="icon" title="Play / pause (space)">▶</button>
+      <button id="prev" class="icon" title="Previous frame (←)">‹</button>
+      <button id="next" class="icon" title="Next frame (→)">›</button>
+      <div class="scrub" id="scrub">
+        <div class="track"><div class="fill" id="fill"></div></div>
+        <div class="marks" id="marks"></div>
+        <div class="head" id="head"></div>
+      </div>
+      <div class="time mono" id="time">0.00 s · f0</div>
+      <label class="toggle" title="Safe zones (S)"><input type="checkbox" id="safe"> Safe</label>
+    </div>
+  </section>
+
+  <aside class="panel" id="panel" hidden>
+    <div class="tabs" role="tablist">
+      <button role="tab" data-tab="notes" class="on">Notes <span class="count" id="noteCount"></span></button>
+      <button role="tab" data-tab="claude">Claude</button>
+      <button role="tab" data-tab="render">Render</button>
+      <button role="tab" data-tab="board">Storyboard</button>
+    </div>
+
+    <div class="tab" data-tab="notes">
+      <form id="noteForm" class="noteform">
+        <div class="at mono" id="noteAt">at 0.00 s</div>
+        <textarea id="noteText" rows="2" placeholder="What should change on this frame? (N)"></textarea>
+        <button class="primary">Pin note</button>
+      </form>
+      <div class="seg" id="noteFilter">
+        <button data-f="open" class="on">Open</button><button data-f="fixed">Fixed</button><button data-f="all">All</button>
+      </div>
+      <ul class="notes" id="notes"></ul>
+      <button class="primary wide" id="sendNotes">Send open notes to Claude</button>
+    </div>
+
+    <div class="tab" data-tab="claude" hidden>
+      <p class="muted small">Runs your local Claude Code (<code>claude -p</code>) on this production with your existing login, no API key.
+        It may read and edit files, render stills and run QA, nothing else. It keeps one session per production.</p>
+      <textarea id="ask" rows="3" placeholder="Ask for a change, e.g. “make the end card hold 0.5 s longer”"></textarea>
+      <label class="small"><input type="checkbox" id="withNotes" checked> Include open notes</label>
+      <div class="row">
+        <button class="primary" id="sendAsk">Send to Claude</button>
+        <button id="stopClaude" hidden>Stop</button>
+      </div>
+      <pre class="log" id="claudeLog"></pre>
+    </div>
+
+    <div class="tab" data-tab="render" hidden>
+      <p class="muted small">Desk renders go to <code>qa/desk/</code> so a delivered export is never overwritten.</p>
+      <div class="row wrap">
+        <button id="rStill">Still at this frame</button>
+        <button id="rVideo">Preview video</button>
+        <button id="rQa">QA the preview</button>
+      </div>
+      <div id="renderOut" class="renderout"></div>
+      <pre class="log" id="renderLog"></pre>
+      <h4>Exports</h4>
+      <ul class="exports" id="exports"></ul>
+      <h4>Approve</h4>
+      <p class="muted small">Approvals are yours alone. Claude can't record them.</p>
+      <input id="approver" placeholder="Your name" autocomplete="name">
+      <div class="row wrap">
+        <button id="okBoard">Approve storyboard</button>
+        <button id="okFinal">Approve final cut</button>
+      </div>
+      <ul class="approvals" id="approvals"></ul>
+    </div>
+
+    <div class="tab board" data-tab="board" hidden>
+      <div id="readme" class="md"></div>
+    </div>
+  </aside>
+</main>
+<script type="module" src="/desk/app.js"></script>
+</body>
+</html>

package/desk/lib.mjs

@@ -0,0 +1,190 @@
+// Shared by the desk server and the desk MCP server: productions, review notes, approvals, renders.
+// A production's review lives in productions/<brand>/<ID>/review.json:
+//   { "notes": [{ id, t, text, by: "human"|"claude", status: "open"|"fixed"|"closed", reply, at }],
+//     "approvals": [{ stage: "storyboard"|"final", by, at }],
+//     "claude": { "session": "<id of the last headless Claude run>" } }
+// Approvals are written by people only (the desk's buttons), never by Claude or the MCP server.
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, statSync } from "node:fs";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const ROOT = process.env.REEL_STUDIO_ROOT
+  ? path.resolve(process.env.REEL_STUDIO_ROOT)
+  : path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+export const STATE = path.join(ROOT, "desk", ".state.json");
+
+const today = () => new Date().toISOString().slice(0, 10);
+
+/** `brand/ID-slug` → absolute folder, refusing anything outside productions/. */
+export function prodDir(id) {
+  if (!/^[\w.-]+\/[\w.-]+$/.test(id || "") || id.startsWith("_")) throw new Error(`bad production id: ${id}`);
+  const dir = path.join(ROOT, "productions", id);
+  if (!existsSync(path.join(dir, "README.md"))) throw new Error(`no production ${id}`);
+  return dir;
+}
+
+function field(readme, name) {
+  const m = new RegExp(`^\\|\\s*${name}\\s*\\|\\s*(.*?)\\s*\\|\\s*$`, "mi").exec(readme);
+  return m ? m[1].replace(/`/g, "") : "";
+}
+
+export function listProductions() {
+  const base = path.join(ROOT, "productions");
+  const out = [];
+  for (const brand of existsSync(base) ? readdirSync(base).sort() : []) {
+    if (brand.startsWith("_") || brand.startsWith(".") || !statSync(path.join(base, brand)).isDirectory()) continue;
+    for (const name of readdirSync(path.join(base, brand)).sort()) {
+      const dir = path.join(base, brand, name);
+      if (!existsSync(path.join(dir, "README.md"))) continue;
+      const readme = readFileSync(path.join(dir, "README.md"), "utf8");
+      const comp = path.join(dir, "composition", "index.html");
+      const exportDir = path.join(dir, "export");
+      const review = readReview(`${brand}/${name}`);
+      out.push({
+        id: `${brand}/${name}`, brand,
+        title: (/^#\s+(.+)$/m.exec(readme)?.[1] || name).trim(),
+        status: field(readme, "Status"),
+        composition: existsSync(comp) ? `/productions/${brand}/${name}/composition/index.html` : null,
+        exports: existsSync(exportDir) ? readdirSync(exportDir).filter((f) => /\.(mp4|png|jpg)$/i.test(f))
+          .map((f) => `/productions/${brand}/${name}/export/${f}`) : [],
+        openNotes: review.notes.filter((n) => n.status === "open").length,
+        approvals: review.approvals,
+      });
+    }
+  }
+  return out;
+}
+
+export function readReview(id) {
+  const file = path.join(prodDir(id), "review.json");
+  const r = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")) : {};
+  return { notes: r.notes || [], approvals: r.approvals || [], claude: r.claude || {} };
+}
+
+export function writeReview(id, review) {
+  writeFileSync(path.join(prodDir(id), "review.json"), JSON.stringify(review, null, 2) + "\n");
+  return review;
+}
+
+export function addNote(id, { t, text, by = "human" }) {
+  if (!text?.trim()) throw new Error("note needs text");
+  const r = readReview(id);
+  const note = { id: Math.max(0, ...r.notes.map((n) => n.id)) + 1, t: +(+t || 0).toFixed(3), text: text.trim(), by,
+    status: "open", reply: "", at: new Date().toISOString() };
+  r.notes.push(note);
+  writeReview(id, r);
+  return note;
+}
+
+export function updateNote(id, noteId, patch) {
+  const r = readReview(id);
+  const note = r.notes.find((n) => n.id === +noteId);
+  if (!note) throw new Error(`no note ${noteId}`);
+  for (const k of ["status", "reply", "text"]) if (patch[k] !== undefined) note[k] = patch[k];
+  if (!["open", "fixed", "closed"].includes(note.status)) throw new Error(`bad status ${note.status}`);
+  writeReview(id, r);
+  return note;
+}
+
+export function deleteNote(id, noteId) {
+  const r = readReview(id);
+  r.notes = r.notes.filter((n) => n.id !== +noteId);
+  writeReview(id, r);
+}
+
+/** A person approves the storyboard (ticks the README box) or the final cut. */
+export function approve(id, stage, by) {
+  if (!["storyboard", "final"].includes(stage)) throw new Error(`bad stage ${stage}`);
+  if (!by?.trim()) throw new Error("approval needs a name");
+  const dir = prodDir(id);
+  const file = path.join(dir, "README.md");
+  let readme = readFileSync(file, "utf8");
+  const stamp = `${today()}, ${by.trim()}, in the desk`;
+  if (stage === "storyboard") {
+    readme = readme.replace(/^- \[ \] Storyboard approved\./m, `- [x] Storyboard approved (${stamp}).`);
+    readme = readme.replace(/^(\|\s*Approved by \/ date\s*\|)\s*\|\s*$/m, `$1 ${by.trim()}, ${today()} |`);
+  } else {
+    const line = `- [x] Final cut approved for delivery (${stamp}).`;
+    readme = /^- \[x\] Storyboard approved.*$/m.test(readme)
+      ? readme.replace(/^- \[x\] Storyboard approved.*$/m, (m) => `${m}\n${line}`)
+      : readme.trimEnd() + `\n\n${line}\n`;
+  }
+  writeFileSync(file, readme);
+  const r = readReview(id);
+  r.approvals.push({ stage, by: by.trim(), at: new Date().toISOString() });
+  writeReview(id, r);
+  return r.approvals;
+}
+
+/** What the person has open in the desk, for Claude (desk_state). */
+export function readState() {
+  return existsSync(STATE) ? JSON.parse(readFileSync(STATE, "utf8")) : {};
+}
+export function writeState(s) {
+  writeFileSync(STATE, JSON.stringify({ ...s, at: new Date().toISOString() }, null, 2) + "\n");
+}
+
+/** Render outputs from the desk go to qa/desk/ so a delivered export is never overwritten. */
+export function renderArgs(id, kind, t = 0, safe = false) {
+  const dir = prodDir(id);
+  const comp = path.join(dir, "composition", "index.html");
+  if (!existsSync(comp)) throw new Error(`${id} has no composition yet`);
+  const out = path.join(dir, "qa", "desk");
+  mkdirSync(out, { recursive: true });
+  const rel = (p) => path.relative(ROOT, p);
+  const sf = safe ? ["--safe"] : [];
+  if (kind === "still") {
+    const file = path.join(out, `still_t${(+t).toFixed(2)}${safe ? "_safe" : ""}.png`);
+    return { cmd: process.execPath, args: ["core/render.mjs", "still", rel(comp), rel(file), "--t", String(+t), ...sf], file: rel(file) };
+  }
+  if (kind === "video") {
+    const file = path.join(out, "preview.mp4");
+    return { cmd: process.execPath, args: ["core/render.mjs", "video", rel(comp), rel(file), ...sf], file: rel(file) };
+  }
+  if (kind === "qa") {
+    const video = path.join(out, "preview.mp4");
+    if (!existsSync(video)) throw new Error("render a preview video first");
+    return { cmd: "bash", args: ["scripts/qa-video.sh", rel(video), rel(path.join(out, "qa"))], file: rel(path.join(out, "qa", "report.md")) };
+  }
+  throw new Error(`bad render kind ${kind}`);
+}
+
+/** Run a command from the repo root; onLine gets each output line. `done` resolves to the exit code. */
+export function runLines(cmd, args, onLine) {
+  const p = spawn(cmd, args, { cwd: ROOT, env: process.env, stdio: ["ignore", "pipe", "pipe"] });
+  const done = new Promise((resolve) => {
+    let buf = "";
+    const feed = (d) => {
+      buf += d;
+      const parts = buf.split(/\r?\n|\r/);
+      buf = parts.pop();
+      for (const l of parts) if (l.trim()) onLine(l);
+    };
+    p.stdout.on("data", feed);
+    p.stderr.on("data", feed);
+    p.on("error", (e) => { onLine(String(e)); resolve(127); });
+    p.on("close", (code) => { if (buf.trim()) onLine(buf); resolve(code ?? 1); });
+  });
+  return { proc: p, done };
+}
+
+/** The prompt a headless Claude run gets from the desk's "Send to Claude". */
+export function claudePrompt(id, notes, extra = "") {
+  const lines = [
+    `You are working on the Reel Studio production productions/${id}/ (follow CLAUDE.md, STATUS.md and the make-video skill).`,
+    `The person reviewing it in the desk asked for this. Composition: productions/${id}/composition/index.html.`,
+  ];
+  if (notes.length) {
+    lines.push("", "Review notes pinned to frames (from review.json):");
+    for (const n of notes) lines.push(`- #${n.id} at ${n.t.toFixed(2)} s: ${n.text}`);
+    lines.push("", "For each note: change the composition, render a still at that time to check it " +
+      "(node core/render.mjs still ... --t <t>, or the reel-desk render_frame tool), then call the reel-desk tool " +
+      "resolve_note with a one-line reply saying what you changed. If a note needs a decision or a fact you do not have, " +
+      "leave it open and reply with the question.");
+  }
+  if (extra.trim()) lines.push("", "Request: " + extra.trim());
+  lines.push("", "Rules: never record or tick an approval (only the person does that in the desk); never invent product facts; " +
+    "do not render the final export, the person renders previews from the desk. End with a two-line summary.");
+  return lines.join("\n");
+}

package/desk/mcp.mjs

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/* reel-desk: an optional MCP server (stdio, zero dependencies) that lets Claude Code see the desk.
+ * Not registered by default. To add it to a project:
+ *   claude mcp add reel-desk --scope project -- node desk/mcp.mjs
+ * (The desk's own "Send to Claude" passes it with --mcp-config, so that works without registering.)
+ *
+ * Tools: desk_state (what the person has open), list_productions, list_notes, add_note (Claude's own QA findings),
+ * resolve_note (mark a note fixed with a reply; the person closes it after checking), render_frame (a still, returned
+ * as an image). There is deliberately no approval tool: approvals are made by people in the desk.
+ * Talks to no network service; renders run core/render.mjs locally.
+ */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import * as desk from "./lib.mjs";
+
+let VERSION = "0";
+try { VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version || VERSION; } catch {}
+const prod = { type: "string", description: "Production id, brand/ID-slug, e.g. bike-logger/REEL-002-engines" };
+
+const tools = {
+  desk_state: {
+    description: "What the person has open in the Reel Studio desk right now: production and time (s). Use it to resolve 'this frame' or 'here'.",
+    inputSchema: { type: "object", properties: {} },
+    run: () => {
+      const s = desk.readState();
+      return s.production ? s : { note: "The desk has not been opened yet (node desk/server.mjs)." };
+    },
+  },
+  list_productions: {
+    description: "Every production with its status, composition, exports, open note count and approvals.",
+    inputSchema: { type: "object", properties: {} },
+    run: () => desk.listProductions(),
+  },
+  list_notes: {
+    description: "Review notes pinned to frames of a production. Each has id, t (seconds), text, by, status (open|fixed|closed) and reply.",
+    inputSchema: { type: "object", properties: { production: prod, status: { type: "string", enum: ["open", "fixed", "closed", "all"] } }, required: ["production"] },
+    run: ({ production, status = "open" }) => desk.readReview(production).notes.filter((n) => status === "all" || n.status === status),
+  },
+  add_note: {
+    description: "Pin your own finding (e.g. from frame-by-frame QA) to a time so the person sees it on the desk timeline.",
+    inputSchema: { type: "object", properties: { production: prod, t: { type: "number" }, text: { type: "string" } }, required: ["production", "t", "text"] },
+    run: ({ production, t, text }) => desk.addNote(production, { t, text, by: "claude" }),
+  },
+  resolve_note: {
+    description: "After changing the composition for a note, mark it fixed with a one-line reply. To ask a question instead, keep status open and put the question in reply. Only the person closes notes.",
+    inputSchema: { type: "object", properties: { production: prod, id: { type: "number" }, reply: { type: "string" },
+      status: { type: "string", enum: ["fixed", "open"], default: "fixed" } }, required: ["production", "id", "reply"] },
+    run: ({ production, id, reply, status = "fixed" }) => desk.updateNote(production, id, { status, reply }),
+  },
+  render_frame: {
+    description: "Render one frame of a production's composition with the real renderer and return it as an image. Saved in qa/desk/.",
+    inputSchema: { type: "object", properties: { production: prod, t: { type: "number" }, safe: { type: "boolean", description: "Draw the safe zones" } }, required: ["production", "t"] },
+    run: async ({ production, t, safe = false }) => {
+      const { cmd, args, file } = desk.renderArgs(production, "still", t, safe);
+      const out = [];
+      const code = await desk.runLines(cmd, args, (l) => out.push(l)).done;
+      if (code !== 0) throw new Error(`render failed (exit ${code}):\n${out.join("\n")}`);
+      return { content: [
+        { type: "text", text: `${file} (t=${t}s)${out.length > 1 ? "\n" + out.slice(1).join("\n") : ""}` },
+        { type: "image", mimeType: "image/png", data: readFileSync(path.join(desk.ROOT, file)).toString("base64") },
+      ] };
+    },
+  },
+};
+
+const send = (msg) => process.stdout.write(JSON.stringify({ jsonrpc: "2.0", ...msg }) + "\n");
+
+async function handle(msg) {
+  const { id, method, params = {} } = msg;
+  if (id === undefined) return; // notifications (initialized, cancelled)
+  if (method === "initialize") {
+    return send({ id, result: { protocolVersion: params.protocolVersion || "2025-06-18", capabilities: { tools: {} },
+      serverInfo: { name: "reel-desk", version: VERSION },
+      instructions: "Reel Studio desk: review notes pinned to frames, and frame renders. Never approve on the person's behalf." } });
+  }
+  if (method === "ping") return send({ id, result: {} });
+  if (method === "tools/list") {
+    return send({ id, result: { tools: Object.entries(tools).map(([name, t]) => ({ name, description: t.description, inputSchema: t.inputSchema })) } });
+  }
+  if (method === "tools/call") {
+    const tool = tools[params.name];
+    if (!tool) return send({ id, error: { code: -32602, message: `unknown tool ${params.name}` } });
+    try {
+      const r = await tool.run(params.arguments || {});
+      return send({ id, result: r?.content ? r : { content: [{ type: "text", text: JSON.stringify(r, null, 2) }] } });
+    } catch (e) {
+      return send({ id, result: { isError: true, content: [{ type: "text", text: e.message }] } });
+    }
+  }
+  send({ id, error: { code: -32601, message: `method not found: ${method}` } });
+}
+
+createInterface({ input: process.stdin }).on("line", (line) => {
+  if (!line.trim()) return;
+  let msg;
+  try { msg = JSON.parse(line); } catch { return send({ id: null, error: { code: -32700, message: "parse error" } }); }
+  handle(msg);
+});