demobite 1.15.0 → 1.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demobite",
-  "version": "1.15.0",
+  "version": "1.16.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;
 };
 

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") {