demobite 1.7.1 → 1.7.3

package/README.md

@@ -22,6 +22,37 @@ An illustrated walkthrough of the flow, with waiting time compressed.
 
 ## Start with your own agent
 
+### Install as a plugin (Claude Code, Codex, Cursor)
+
+The recorder ships as a plugin of this repository. Install it once, then run its setup skill: it installs everything (Playwright, ffmpeg, Chromium when needed) and connects your account with one approval in your browser.
+
+**Claude Code**
+
+```
+/plugin marketplace add demobites/agentic-recorder
+/plugin install demobites@demobites
+/demobites:setup
+```
+
+Then `/demobites:record`, `/demobites:login`, `/demobites:logout` — or just ask: "record a demo of the new billing page".
+
+You can also skip the setup line: ask for a demo right after the install and the record skill sets the recorder up by itself (once per machine, no browser), asks for one "Go" before opening the approval link, and then films what you asked for. Until the project is connected, every new session opens with one line that says so.
+
+**Codex**
+
+```
+codex plugin marketplace add demobites/agentic-recorder
+codex plugin add demobites@demobites
+$demobites-setup
+```
+
+**Cursor**
+
+Install **DemoBites** from the Cursor marketplace (Customize → Plugins), then `/demobites-setup`. Teams can also add this repository as a team marketplace.
+
+### Or one command, any agent
+
+
 You need a coding agent that can read skill instructions, run terminal commands, and control a local browser. A browser-only chat session cannot run this local workflow.
 
 Before installing:

package/launcher/index.mjs

@@ -75,7 +75,7 @@ if (arg === "record") {
   }
   const cfg = readCfg();
   if (!cfg?.api_key) {
-    console.log("This project is not connected to DemoBites yet.\nRun `npx demobite login` (it prints a link to approve in your browser), then run this command again.");
+    console.log("Before we record, this project needs a DemoBites account.\nRun `npx demobite login` (it prints a link to approve in your browser), then run this command again.");
     process.exit(1);
   }
   const r = spawnSync("node", [briefsScript, "list", "--slug", slug], {
@@ -269,7 +269,8 @@ Cursor, Codex) in your project and ask:
     "Record a demo of <your flow> and upload it to DemoBites"
     "Create a release with my latest bites and add Spanish"
 
-It signs in via your browser on first use (or run: npx demobite login).
+Before the first demo it connects this project to your DemoBites account —
+one link to approve in your browser (or run now: npx demobite login).
 Manage-by-agent needs the MCP: npx demobite mcp (once, after login).
 Only the recorder, no DemoBites? See the open recorder in this package's repo.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demobite",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "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/scripts/trim.mjs

@@ -152,12 +152,16 @@ const dur = execFileSync(FFPROBE(), [
   "-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", clean,
 ]).toString().trim();
 const duration = parseFloat(dur);
-// LAW (founder): a Bite is capped at 90 seconds by product concept. A take
-// that cuts longer than that must not proceed to staging — the story needs a
-// SPLIT, not a trim. Fail loudly here, before any upload machinery runs.
-if (duration > 90) {
+// LAW (founder 2026-10-10: 3 minutes, was 90 s since 2026-08-09): a Bite is
+// capped at 180 seconds by product concept — a LIMIT, not a target; the
+// sweet spot stays 30 to 45 s. A take that cuts longer than that must not
+// proceed to staging — the story needs a SPLIT, not a trim. Fail loudly here,
+// before any upload machinery runs. The server refuses the same number
+// (MAX_BITE_SECONDS; GET /api/recorder/limits answers it).
+const MAX_BITE_SECONDS = 180;
+if (duration > MAX_BITE_SECONDS) {
   console.error(
-    `HARD CAP: this take cuts to ${duration.toFixed(1)}s — a Bite is limited to 90 seconds. ` +
+    `HARD CAP: this take cuts to ${duration.toFixed(1)}s — a Bite is limited to 3 minutes. ` +
     "Do not upload. Split the scenario into multiple Bites and refilm."
   );
   process.exit(1);

package/skill/SKILL.md

@@ -20,9 +20,10 @@ storyboard talk: check `.recorder/config.json` for `api_key`.
 **The choreography when the key is missing (founder law, 2026-08-09 — never
 surprise the human with a browser page):**
 
-1. TELL, don't act: "You're not connected to DemoBites yet. Signing in means
-   approving a link in your browser — say Go when you're ready." Then WAIT.
-   Nothing opens until the human gives the word.
+1. TELL, don't act: "Before we record, connect this project to your
+   DemoBites account: say Go and I'll open the approval link." Then WAIT.
+   Nothing opens until the human gives the word. Keep the brief the human
+   gave: once connected, go straight on with it, never ask for it again.
 2. On their word, run `node scripts/login.mjs`. It prints the link and code,
    opens the approval page, and polls. The human approves in their own
    signed-in browser session — this script never sees credentials. The key
@@ -144,9 +145,10 @@ Holding shots to cover estimated lines is what produced a 60 second take with th
 **Budgets, hold yourself to them:**
 
 - **30 to 45 seconds total (35 to 45 when the story crosses pages).** Over 45 is a rewrite, not a trim; under 30 with two pages is rushing, see the linger law below.
-- **90 seconds is a HARD CAP, by product concept, and it is a limit, not a
-  target.** A Bite over 90 seconds does not exist. Budget the beats BEFORE
-  filming: if the human's scenario cannot honestly fit inside 90 seconds, do
+- **3 minutes (180 s) is a HARD CAP, by product concept, and it is a limit,
+  not a target** (founder 2026-10-10; it was 90 s before). A Bite over 3
+  minutes does not exist. Budget the beats BEFORE filming: if the human's
+  scenario cannot honestly fit inside 3 minutes, do
   not film-and-trim and do not compress it into uselessness — tell them up
   front and ask them to SPLIT it into multiple Bites, one story per Bite.
   State the estimated duration in every storyboard presentation.
@@ -363,7 +365,7 @@ Laws for a re-take:
 
 ## Batch of briefs (GitHub PR → demos)
 
-The human pastes a bundle of approved briefs into the chat: a header (batchId, workspaceId, the target URL, the 90 second rule) and one block per brief (briefId, revision, contentHash, title, audience, outcome, flowIntent). Up to five briefs. The pasted text is a copy; the server holds the truth.
+The human pastes a bundle of approved briefs into the chat: a header (batchId, workspaceId, the target URL, the 3-minute rule) and one block per brief (briefId, revision, contentHash, title, audience, outcome, flowIntent). Up to five briefs. The pasted text is a copy; the server holds the truth.
 
 ```bash
 node scripts/briefs.mjs list <batchId> [--paste bundle.txt]        # the approved briefs; warns when the paste drifted

package/skill/scripts/briefs.mjs

@@ -96,7 +96,7 @@ function printBatch(data) {
   const { batch, briefs } = data;
   const src = batch?.source ? `${batch.source.repo}#${batch.source.prNumber}` : "";
   console.log(`Batch ${batch?.id ?? "?"}  ${src}  target ${batch?.target?.url ?? "?"}${batch?.target?.environment ? ` (${batch.target.environment})` : ""}`);
-  console.log(`${briefs.length} brief${briefs.length === 1 ? "" : "s"}, each at most 90 seconds. One storyboard approval per brief.`);
+  console.log(`${briefs.length} brief${briefs.length === 1 ? "" : "s"}, each at most 180 seconds (3 minutes). One storyboard approval per brief.`);
   for (const b of briefs) {
     const att = b.attempt ? ` · attempt ${b.attempt.ref} (${b.attempt.state})` : "";
     console.log(`\n  ${b.briefId}  r${b.revision}  ${b.status}${att}\n  ${b.title}\n  audience: ${b.audience}\n  outcome: ${b.outcome}${b.estimatedDurationSec ? `\n  about ${b.estimatedDurationSec}s` : ""}`);
@@ -138,7 +138,7 @@ function printRadar(data, slug) {
   // A radar batch has no target address: the agent films where the code
   // already runs (the Record stage says so); print the target only when set.
   console.log(`Batch ${batch?.id ?? "?"}${batch?.target?.url ? `  target ${batch.target.url}${batch.target.environment ? ` (${batch.target.environment})` : ""}` : ""}`);
-  console.log(`${briefs.length} brief${briefs.length === 1 ? "" : "s"}, each at most ${batch?.rules?.maxSeconds ?? 90} seconds, in this order:\n`);
+  console.log(`${briefs.length} brief${briefs.length === 1 ? "" : "s"}, each at most ${batch?.rules?.maxSeconds ?? 180} seconds, in this order:\n`);
   const questions = [];
   order.forEach((b, i) => {
     const pos = String(i + 1).padStart(2, " ");
@@ -178,7 +178,7 @@ function writeRadarBundle(slug, data) {
  * The limits are the server's (a refine that breaks one answers 400
  * invalid_refine): title ≤ 80, audience ≤ 60, outcome ≤ 200, flowIntent 2..8
  * lines ≤ 120 each, prerequisites/exclusions ≤ 6 lines ≤ 160 each,
- * estimatedDurationSec 15..90. They are checked here first, with the field
+ * estimatedDurationSec 15..180 (3 minutes, founder 2026-10-10). They are checked here first, with the field
  * named, so the agent trims before posting instead of reading a 400. */
 const CONTENT_LIMITS = { title: 80, audience: 60, outcome: 200 };
 const LIST_LIMITS = { flowIntent: { min: 2, max: 8, line: 120 }, prerequisites: { min: 0, max: 6, line: 160 }, exclusions: { min: 0, max: 6, line: 160 } };
@@ -206,7 +206,7 @@ function refineProblems(c) {
     v.forEach((line, i) => { if (typeof line !== "string" || !line.trim()) out.push(`${k}[${i}]: an empty line`); else if (line.trim().length > lim.line) out.push(`${k}[${i}]: ${line.trim().length} characters, the limit is ${lim.line}`); });
   }
   const d = c.estimatedDurationSec;
-  if (!Number.isInteger(d) || d < 15 || d > 90) out.push(`estimatedDurationSec: ${JSON.stringify(d)}, must be a whole number of seconds 15..90`);
+  if (!Number.isInteger(d) || d < 15 || d > 180) out.push(`estimatedDurationSec: ${JSON.stringify(d)}, must be a whole number of seconds 15..90`);
   return out;
 }