demobite 1.15.0 → 1.17.0

package/launcher/index.mjs

@@ -332,7 +332,7 @@ if (arg === "listen") {
       await event(job.id, "started", { machine: name });
       const takeDir = path.join(process.cwd(), ".recorder", "takes", job.id);
       fs.mkdirSync(takeDir, { recursive: true });
-      fs.writeFileSync(path.join(takeDir, "job.json"), JSON.stringify({ id: job.id, brief: job.brief, url: job.url ?? null, model, review_storyboard: job.review_storyboard !== false }, null, 2) + "\n");
+      fs.writeFileSync(path.join(takeDir, "job.json"), JSON.stringify({ id: job.id, brief: job.brief, url: job.url ?? null, model, review_storyboard: job.review_storyboard !== false, ...(job.retake_of ? { retake_of: job.retake_of, retake_note: job.retake_note ?? null, storyboard: job.storyboard ?? null } : {}) }, null, 2) + "\n");
       // Spawned async (1.14.1): a spawnSync here blocked the event loop, so the 5 s heartbeat never fired
       // during a take and the rail called the machine offline mid-recording (founder 2026-10-15 17:39).
       const child = (await import("node:child_process")).spawn("node", [path.join(dest, "scripts", "plan.mjs"), takeDir], { cwd: process.cwd(), stdio: "inherit", env: { ...process.env, RECORDER_JOB: job.id, RECORDER_BASE: base, RECORDER_LISTEN: "1" } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demobite",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "The DemoBites agentic recorder — you prompt, it films a real browser, and DemoBites turns the take into an editable demo bite.",
   "bin": {
     "demobite": "launcher/index.mjs"

package/skill/scripts/clock.mjs

@@ -0,0 +1,28 @@
+// THE CAMERA'S CLOCK (2026-10-15). What a storyboard step really costs on the camera, so the
+// planner's total is the take's total. Numbers from record.mjs: estimateSpeech = words / 2.6 + 0.4;
+// the hold is speech + 0.5 s breath measured from arrival; a click or hover spends ~1 s on cursor
+// flight and dwell before arrival; the first narrated beat carries STARTUP_LEAD_SLACK_S = 2.5;
+// the take closes on CLOSING_BEAT_MS = 2200. Keep the two in step.
+export const CLOSING_S = 2.2;
+const ms = (v, fallback) => (v == null ? fallback : v < 60 ? v * 1000 : v);
+const speech = (text) => { const n = String(text ?? "").trim().split(/\s+/).filter(Boolean).length; return n ? n / 2.6 + 0.4 + 0.5 : 0; };
+export const secondsOf = (s, firstNarrated) => {
+  const text = typeof s.narration === "string" ? s.narration : s.narration?.text ?? "";
+  const say = speech(text);
+  const slack = say && firstNarrated ? 2.5 : 0;
+  switch (s.action) {
+    case "goto": return 0.1;
+    case "settle": return Math.max(ms(s.ms, 1200) / 1000, say) + slack;
+    case "scroll": return Math.max(ms(s.ms, 1900) / 1000, say) + slack;
+    case "click":
+    case "hover": return 1.0 + Math.max(ms(s.after, 2000) / 1000, say) + slack;
+    case "type": return 1.0 + String(s.text ?? "").length * 0.05 + Math.max(ms(s.after, 1500) / 1000, say) + slack;
+    case "expect": return 0.3;
+    default: return 1 + say;
+  }
+};
+export const estimateTake = (steps) => {
+  let first = true, total = CLOSING_S;
+  for (const s of steps ?? []) { total += secondsOf(s, first); if (s.narration) first = false; }
+  return total;
+};

package/skill/scripts/manifest.mjs

@@ -347,6 +347,10 @@ const wire = {
   frame: { width: FW, height: FH },
   // BROWSER HEADER (2026-09-16): true by default; DemoBites adds the dark macOS bar on top at ingest. A workspace rule "No browser header" sets it false.
   ...(typeof man.browserHeader === "boolean" ? { browserHeader: man.browserHeader } : {}),
+  // APPROVED STORY (founder 2026-10-15, bite 1228: "the storyteller is blabbing"): the lines came from the
+  // director and the person said Film it to THESE lines. DemoBites keeps them verbatim and never writes
+  // a filler into a silence or a longer line into a longer beat.
+  narration_approved: true,
   duration,
   steps,
   camera,

package/skill/scripts/plan.mjs

@@ -18,6 +18,7 @@
 // reads is logged on the take (<takeDir>/code-shared.log) so the person can
 // see exactly what left the machine.
 import fs from "node:fs";
+import { estimateTake } from "./clock.mjs";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
@@ -150,6 +151,10 @@ const validate = (sb) => {
     if (s.frame !== undefined && s.frame !== "close" && s.frame !== "wide") return `${at}: frame must be close or wide`;
   }
   if (sb.steps.length > 14) return "more than 14 steps; 6 to 10 is the law";
+  // THE CAMERA'S CLOCK (founder 2026-10-15): the take may not run past 45 s. The estimate is the
+  // camera's own (clock.mjs); the model gets the number and the cure.
+  const est = estimateTake(sb.steps);
+  if (est > 45) return `the camera would run this take about ${Math.round(est)} s; the law is 30 to 45. Cut words (6 to 11 a line) or steps (5 to 8 narrated); never pad, never add.`;
   return null;
 };
 
@@ -192,7 +197,11 @@ const firstMessage = () => {
     `## The app's words on the starting screen\n${vocab}`,
     `## Workspace rules (version ${rules.version || 0})\n${rules.lines?.length ? rules.lines.map((l, i) => `${i + 1}. ${l}`).join("\n") : "(none)"}`,
     `## The project's files${codeOn ? " (this machine sits in the app's repository; read_file is on)" : " (no code here)"}\n${listFiles()}`,
-    codeOn ? `Write the storyboard, probe it, fix it, probe again, then submit_storyboard.` : `There is no code: explore first (explore from the starting address, looking_for = the brief's nouns), then write the storyboard, probe it, fix it, probe again, then submit_storyboard.`,
+    // A RETAKE (founder 2026-10-15): the same demo again, because the app changed under it. The previous
+    // storyboard is the base; the note says what to keep an eye on; the probe finds what moved.
+    job.retake_of && job.storyboard
+      ? `## This is a retake\nThe person wants the same demo filmed again, the same length and the same shots, because the app changed since. Their note: "${(job.retake_note || "no note").replace(/"/g, "'")}". ${job.storyboard.storyboard ? "Start from the previous storyboard below: keep its steps and its lines; probe it; fix only what no longer resolves or what the note names; then submit_storyboard. Never explore when the probe passes." : "Only the previous storyboard's lines survive (below): rebuild the same steps with the same lines, find the controls again, probe, then submit_storyboard."}\n\n## The previous storyboard\n${JSON.stringify(job.storyboard.storyboard ?? job.storyboard.steps ?? job.storyboard)}`
+      : codeOn ? `Write the storyboard, probe it, fix it, probe again, then submit_storyboard.` : `There is no code: explore first (explore from the starting address, looking_for = the brief's nouns), then write the storyboard, probe it, fix it, probe again, then submit_storyboard.`,
   ];
   return parts.join("\n\n");
 };

package/skill/scripts/storyboard.mjs

@@ -23,11 +23,13 @@ if (!mode || !file || !["print", "words", "await"].includes(mode)) {
 }
 const sb = JSON.parse(fs.readFileSync(file, "utf8"));
 const steps = Array.isArray(sb.steps) ? sb.steps : [];
-const FLOOR = { goto: 1.5, settle: 2, click: 2.5, hover: 2, type: 3, scroll: 2, expect: 1 };
-const secondsOf = (s) => {
-  const words = String(s.narration ?? "").trim().split(/\s+/).filter(Boolean).length;
-  return Math.max(typeof s.dwell === "number" ? s.dwell : 0, words / 2.5, FLOOR[s.action] ?? 2);
-};
+// THE CAMERA'S CLOCK (founder 2026-10-15, bite 1228 said 0:36 and ran 0:51): a beat is held until its
+// line would have finished (words / 2.6 s + 0.4 s, record.mjs estimateSpeech) plus half a second of
+// breath; a click or hover adds about a second of cursor flight and dwell; the first narrated settle
+// carries 2.5 s of startup slack; the take closes on a 2.2 s beat. Same numbers as record.mjs.
+import { secondsOf as cameraSeconds, CLOSING_S } from "./clock.mjs";
+let firstNarrated = true;
+const secondsOf = (s) => { const r = cameraSeconds(s, firstNarrated); if (s.narration) firstNarrated = false; return r; };
 const mmss = (sec) => `${Math.floor(sec / 60)}:${String(Math.round(sec % 60)).padStart(2, "0")}`;
 // A row per step that says or shows something; silent plumbing (a bare goto,
 // an expect) rides inside the previous row's time.
@@ -39,7 +41,7 @@ for (const s of steps) {
   if (text && !(s.action === "expect" && !s.narration)) rows.push({ at: clock, text: text.replace(/\s+/g, " "), pointed: s.pointed === true, step: s });
   clock += dur;
 }
-const total = clock;
+const total = clock + CLOSING_S;
 const title = (sb.title ?? sb.app ?? "Demo").toString().trim();
 
 if (mode === "words") {
@@ -61,7 +63,8 @@ if (mode === "await") {
   rows.forEach((r, i) => boxOut.push(`│ ${`${String(i + 1).padStart(2)}  ${mmss(r.at)}  ${cap2(r.text + (r.pointed ? " — pointed at, not pressed" : ""), W2 - 14)}`.padEnd(W2 - 2)} │`));
   boxOut.push(`│ ${"".padEnd(W2 - 2)} │`); boxOut.push(`└${"─".repeat(W2)}┘`);
   if (!listening) { console.log(boxOut.join("\n")); console.log("film"); process.exit(0); }
-  await postEvent("storyboard", { box: boxOut.join("\n"), total: mmss(total), steps: rows.map((r, i) => ({ n: i + 1, at: mmss(r.at), text: r.text, pointed: r.pointed })) });
+  // The whole storyboard rides along (1.17.0): a retake starts from it, selectors and all.
+  await postEvent("storyboard", { box: boxOut.join("\n"), total: mmss(total), steps: rows.map((r, i) => ({ n: i + 1, at: mmss(r.at), text: r.text, pointed: r.pointed })), storyboard: sb });
   const started = Date.now();
   while (Date.now() - started < 30 * 60 * 1000) {
     const st = await poll();