@kadj-amoah/showrunner 1.1.2 → 1.1.4

package/dist/cli.js

@@ -1413,10 +1413,10 @@ function extractAndValidate(response, schema) {
   if (response.parsed_output !== void 0 && response.parsed_output !== null) {
     return schema.parse(response.parsed_output);
   }
-  const text = response.content.filter((b) => b.type === "text").map((b) => b.text).join("\n").trim();
+  const text2 = response.content.filter((b) => b.type === "text").map((b) => b.text).join("\n").trim();
   throw new LLMProviderError(
-    text.length > 0 ? `Anthropic returned no parseable structured output. Raw text:
-${text.slice(0, 2e3)}` : "Anthropic returned an empty response with no parseable output.",
+    text2.length > 0 ? `Anthropic returned no parseable structured output. Raw text:
+${text2.slice(0, 2e3)}` : "Anthropic returned an empty response with no parseable output.",
     "anthropic"
   );
 }
@@ -2351,20 +2351,20 @@ function isOriginsList(value) {
 function buildFormFill(auth) {
   return async (page) => {
     const email = process.env[auth.fields.email.env];
-    const password = process.env[auth.fields.password.env];
+    const password2 = process.env[auth.fields.password.env];
     if (!email) {
       throw new AuthError(
         `Form auth: env var ${auth.fields.email.env} is not set`
       );
     }
-    if (!password) {
+    if (!password2) {
       throw new AuthError(
         `Form auth: env var ${auth.fields.password.env} is not set`
       );
     }
     await page.goto(auth.login_url);
     await page.fill(auth.fields.email.selector, email);
-    await page.fill(auth.fields.password.selector, password);
+    await page.fill(auth.fields.password.selector, password2);
     await page.click(auth.submit_selector);
     try {
       await page.waitForURL(auth.success_url_pattern, { timeout: auth.timeout_ms });
@@ -2719,9 +2719,9 @@ async function recordDemo(opts) {
     const page = await context.newPage();
     if (recording.cursor_highlight) {
       page.on("console", (msg) => {
-        const text = msg.text();
-        if (text.startsWith("[showrunner-cursor]")) {
-          logger.debug(`browser: ${text}`);
+        const text2 = msg.text();
+        if (text2.startsWith("[showrunner-cursor]")) {
+          logger.debug(`browser: ${text2}`);
         }
       });
     }
@@ -4602,8 +4602,8 @@ async function fileExists7(path) {
     return false;
   }
 }
-function escapeFilterText(text) {
-  return text.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/:/g, "\\:").replace(/,/g, "\\,");
+function escapeFilterText(text2) {
+  return text2.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/:/g, "\\:").replace(/,/g, "\\,");
 }
 function escapeFilterPath(path) {
   return path.replace(/\\/g, "/").replace(/:/g, "\\\\:");
@@ -4680,14 +4680,14 @@ function chunkAlignmentToCues(alignment, segmentStartSec) {
   let lastBoundaryIdx = -1;
   let i = 0;
   const pushCue = (endIdx) => {
-    const text = cueChars.join("").replace(/\s+/g, " ").trim();
-    if (text.length === 0) return;
+    const text2 = cueChars.join("").replace(/\s+/g, " ").trim();
+    if (text2.length === 0) return;
     cues.push({
       index: 0,
       // assigned by caller
       startSec: segmentStartSec + cueStart,
       endSec: segmentStartSec + ends[endIdx],
-      text
+      text: text2
     });
   };
   while (i < chars.length) {
@@ -5595,8 +5595,294 @@ async function runCommand2(opts) {
 }
 
 // src/commands/init.ts
-import { mkdir as mkdir11, writeFile as writeFile12, access as access2 } from "fs/promises";
+import { mkdir as mkdir11, writeFile as writeFile12, access as access3 } from "fs/promises";
 import { dirname as dirname10, isAbsolute as isAbsolute8, join as join10, resolve as resolve15 } from "path";
+
+// src/setup/detect.ts
+import { spawn as spawn4 } from "child_process";
+import { access as access2, stat as stat10 } from "fs/promises";
+async function detectEnvironment() {
+  const [claudeCli, ffmpeg, ffprobe, chromium6] = await Promise.all([
+    isOnPath("claude"),
+    isOnPath("ffmpeg"),
+    isOnPath("ffprobe"),
+    chromiumInstalled()
+  ]);
+  return {
+    claudeCli,
+    ffmpeg,
+    ffprobe,
+    chromium: chromium6,
+    envVars: {
+      anthropic: Boolean(process.env["ANTHROPIC_API_KEY"]),
+      openai: Boolean(process.env["OPENAI_API_KEY"]),
+      elevenlabs: Boolean(process.env["ELEVENLABS_API_KEY"])
+    }
+  };
+}
+async function isOnPath(binary) {
+  return new Promise((resolve27) => {
+    const useShell = process.platform === "win32";
+    const child = spawn4(binary, ["--version"], {
+      stdio: ["ignore", "ignore", "ignore"],
+      shell: useShell
+    });
+    let settled = false;
+    const finish = (ok) => {
+      if (settled) return;
+      settled = true;
+      resolve27(ok);
+    };
+    child.on("error", () => finish(false));
+    child.on("exit", (code) => finish(code === 0));
+    setTimeout(() => {
+      if (!settled) {
+        child.kill("SIGKILL");
+        finish(false);
+      }
+    }, 4e3);
+  });
+}
+async function chromiumInstalled() {
+  try {
+    const { chromium: chromium6 } = await import("playwright-core");
+    const exec = chromium6.executablePath();
+    await stat10(exec);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/setup/wizard.ts
+import {
+  intro,
+  outro,
+  text,
+  password,
+  select,
+  confirm,
+  note,
+  spinner,
+  isCancel,
+  cancel
+} from "@clack/prompts";
+
+// src/setup/targetProbe.ts
+import { request as undiciRequest2 } from "undici";
+var DEFAULT_TIMEOUT_MS = 4e3;
+async function probeUrl(url, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  const start = Date.now();
+  try {
+    const res = await undiciRequest2(url, {
+      method: "HEAD",
+      bodyTimeout: timeoutMs,
+      headersTimeout: timeoutMs
+    });
+    const elapsedMs = Date.now() - start;
+    return {
+      url,
+      reachable: res.statusCode >= 200 && res.statusCode < 500,
+      statusCode: res.statusCode,
+      elapsedMs
+    };
+  } catch (err) {
+    return {
+      url,
+      reachable: false,
+      reason: err instanceof Error ? err.message : String(err),
+      elapsedMs: Date.now() - start
+    };
+  }
+}
+
+// src/setup/wizard.ts
+var SLUG_RE = /^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/i;
+async function runWizard(env) {
+  intro("Showrunner setup");
+  note(formatDetection(env), "Detected on this machine");
+  const projectName = await ask(
+    text({
+      message: "What's the project directory name?",
+      placeholder: "showrunner-demo",
+      defaultValue: "showrunner-demo",
+      validate: (v) => {
+        if (!v) return void 0;
+        if (!SLUG_RE.test(v)) {
+          return "Use letters/digits/dash/underscore/dot, starting & ending with alphanumeric.";
+        }
+        return void 0;
+      }
+    })
+  );
+  if (projectName === null) return null;
+  const resolutionPreset = await ask(
+    select({
+      message: "Recording resolution preset?",
+      options: [
+        { value: "low", label: "low  (854\xD7480) \u2014 draft / fast iteration" },
+        { value: "standard", label: "standard  (1280\xD7720) \u2014 recommended default" },
+        { value: "high", label: "high  (1920\xD71080)" },
+        { value: "extreme", label: "extreme  (3840\xD72160) \u2014 needs serious RAM" }
+      ],
+      initialValue: "standard"
+    })
+  );
+  if (resolutionPreset === null) return null;
+  if (!RESOLUTION_PRESETS.includes(resolutionPreset)) {
+    cancel("Invalid resolution preset.");
+    return null;
+  }
+  const llmDefault = env.claudeCli ? "agent_bridge" : "anthropic";
+  const llm = await ask(
+    select({
+      message: "Which LLM provider should drive comprehension + script?",
+      options: [
+        {
+          value: "agent_bridge",
+          label: env.claudeCli ? "agent_bridge \u2014 uses your local `claude` CLI (detected). No API key required." : "agent_bridge \u2014 uses a local headless agent CLI. No API key required."
+        },
+        {
+          value: "anthropic",
+          label: env.envVars.anthropic ? "anthropic \u2014 Claude via API (ANTHROPIC_API_KEY already in env)" : "anthropic \u2014 Claude via API (you'll paste an API key in a moment)"
+        },
+        {
+          value: "openai",
+          label: env.envVars.openai ? "openai \u2014 GPT via API (OPENAI_API_KEY already in env)" : "openai \u2014 GPT via API (you'll paste an API key in a moment)"
+        }
+      ],
+      initialValue: llmDefault
+    })
+  );
+  if (llm === null) return null;
+  const collectedKeys = {};
+  if (llm === "anthropic" && !env.envVars.anthropic) {
+    const key = await askKey("ANTHROPIC_API_KEY", "https://console.anthropic.com/settings/keys");
+    if (key === null) return null;
+    if (key.length > 0) collectedKeys["ANTHROPIC_API_KEY"] = key;
+  }
+  if (llm === "openai" && !env.envVars.openai) {
+    const key = await askKey("OPENAI_API_KEY", "https://platform.openai.com/api-keys");
+    if (key === null) return null;
+    if (key.length > 0) collectedKeys["OPENAI_API_KEY"] = key;
+  }
+  const ttsDefault = llm === "agent_bridge" && !env.envVars.openai && !env.envVars.elevenlabs ? "custom" : "elevenlabs";
+  const tts = await ask(
+    select({
+      message: "Which TTS provider for voiceover?",
+      options: [
+        {
+          value: "elevenlabs",
+          label: env.envVars.elevenlabs ? "elevenlabs \u2014 best alignment (ELEVENLABS_API_KEY already in env)" : "elevenlabs \u2014 best alignment (you'll paste an API key)"
+        },
+        {
+          value: "openai",
+          label: env.envVars.openai || llm === "openai" ? "openai \u2014 tts-1-hd (reuses your OpenAI key)" : "openai \u2014 tts-1-hd (you'll paste an API key)"
+        },
+        {
+          value: "custom",
+          label: "custom \u2014 plug in your own TTSProvider module. No API key required here."
+        }
+      ],
+      initialValue: ttsDefault
+    })
+  );
+  if (tts === null) return null;
+  if (tts === "elevenlabs" && !env.envVars.elevenlabs) {
+    const key = await askKey("ELEVENLABS_API_KEY", "https://elevenlabs.io/app/settings/api-keys");
+    if (key === null) return null;
+    if (key.length > 0) collectedKeys["ELEVENLABS_API_KEY"] = key;
+  }
+  if (tts === "openai" && !env.envVars.openai && !collectedKeys["OPENAI_API_KEY"]) {
+    const key = await askKey("OPENAI_API_KEY", "https://platform.openai.com/api-keys");
+    if (key === null) return null;
+    if (key.length > 0) collectedKeys["OPENAI_API_KEY"] = key;
+  }
+  const url = await ask(
+    text({
+      message: "What URL is your product dev server on?",
+      placeholder: "http://localhost:3000",
+      defaultValue: "http://localhost:3000",
+      validate: (v) => {
+        if (!v) return void 0;
+        try {
+          new URL(v);
+          return void 0;
+        } catch {
+          return "Must be a valid URL (e.g. http://localhost:3000).";
+        }
+      }
+    })
+  );
+  if (url === null) return null;
+  const probeSpinner = spinner();
+  probeSpinner.start(`Probing ${url} ...`);
+  const probe = await probeUrl(url);
+  if (probe.reachable) {
+    probeSpinner.stop(`${url} reachable (HTTP ${probe.statusCode}, ${probe.elapsedMs}ms).`);
+  } else {
+    probeSpinner.stop(`${url} not reachable yet.`);
+    note(
+      `That's fine \u2014 you can start your dev server later. When it's up, run:
+
+  showrunner set-target -c demo.yaml --url ${url}
+
+to re-probe and update the config.`,
+      "Heads up"
+    );
+  }
+  const proceed = await ask(
+    confirm({
+      message: `Scaffold ${projectName}/ with these choices?`,
+      initialValue: true
+    })
+  );
+  if (proceed === null || proceed === false) {
+    cancel("Setup cancelled. Nothing written.");
+    return null;
+  }
+  outro("Scaffolding now...");
+  return {
+    projectName,
+    url,
+    llm,
+    tts,
+    resolutionPreset,
+    collectedKeys
+  };
+}
+async function askKey(envVar, dashUrl) {
+  const value = await ask(
+    password({
+      message: `Paste your ${envVar} (or press enter to skip and fill .env later)`
+    })
+  );
+  if (value === null) return null;
+  return typeof value === "string" ? value.trim() : "";
+}
+async function ask(promptResult) {
+  const result = await promptResult;
+  if (isCancel(result)) {
+    cancel("Setup cancelled.");
+    return null;
+  }
+  return result;
+}
+function formatDetection(env) {
+  const lines = [];
+  lines.push(`claude CLI:    ${env.claudeCli ? "found" : "not found"}`);
+  lines.push(`ffmpeg:        ${env.ffmpeg ? "found" : "NOT found  \u2190 required for muxing"}`);
+  lines.push(`ffprobe:       ${env.ffprobe ? "found" : "NOT found  \u2190 required for muxing"}`);
+  lines.push(`chromium:      ${env.chromium ? "installed" : "NOT installed  \u2190 run `showrunner install-browser`"}`);
+  lines.push("");
+  lines.push("env vars:");
+  lines.push(`  ANTHROPIC_API_KEY:  ${env.envVars.anthropic ? "set" : "unset"}`);
+  lines.push(`  OPENAI_API_KEY:     ${env.envVars.openai ? "set" : "unset"}`);
+  lines.push(`  ELEVENLABS_API_KEY: ${env.envVars.elevenlabs ? "set" : "unset"}`);
+  return lines.join("\n");
+}
+
+// src/commands/init.ts
 var LLM_CHOICES = ["anthropic", "openai", "agent_bridge"];
 var TTS_CHOICES = ["elevenlabs", "openai", "custom"];
 var PLACEHOLDER_FILES = [
@@ -5608,22 +5894,52 @@ var PLACEHOLDER_FILES = [
   "output/.gitkeep"
 ];
 async function initCommand(opts) {
-  const resolutionPreset = validateChoice(
-    opts.resolution,
-    [...RESOLUTION_PRESETS],
-    "standard",
-    "--resolution"
-  );
-  const resolved = {
-    ...opts,
-    llm: validateChoice(opts.llmProvider, LLM_CHOICES, "anthropic", "--llm-provider"),
-    tts: validateChoice(opts.ttsProvider, TTS_CHOICES, "elevenlabs", "--tts-provider"),
-    resolutionPreset,
-    resolution: resolvePreset(resolutionPreset)
-  };
-  const parent = isAbsolute8(opts.dir) ? opts.dir : resolve15(process.cwd(), opts.dir);
-  const projectRoot = join10(parent, opts.name);
-  if (!opts.force && await pathExists(projectRoot)) {
+  const wantsInteractive = Boolean(process.stdout.isTTY) && !opts.yes;
+  let resolved;
+  let collectedKeys = {};
+  if (wantsInteractive) {
+    const env = await detectEnvironment();
+    const wiz = await runWizard(env);
+    if (!wiz) return;
+    resolved = {
+      name: wiz.projectName,
+      url: wiz.url,
+      dir: opts.dir,
+      force: opts.force,
+      llm: wiz.llm,
+      tts: wiz.tts,
+      resolutionPreset: wiz.resolutionPreset,
+      resolution: resolvePreset(wiz.resolutionPreset)
+    };
+    collectedKeys = wiz.collectedKeys;
+  } else {
+    const resolutionPreset = validateChoice(
+      opts.resolution,
+      [...RESOLUTION_PRESETS],
+      "standard",
+      "--resolution"
+    );
+    resolved = {
+      ...opts,
+      llm: validateChoice(
+        opts.llmProvider,
+        LLM_CHOICES,
+        "anthropic",
+        "--llm-provider"
+      ),
+      tts: validateChoice(
+        opts.ttsProvider,
+        TTS_CHOICES,
+        "elevenlabs",
+        "--tts-provider"
+      ),
+      resolutionPreset,
+      resolution: resolvePreset(resolutionPreset)
+    };
+  }
+  const parent = isAbsolute8(resolved.dir) ? resolved.dir : resolve15(process.cwd(), resolved.dir);
+  const projectRoot = join10(parent, resolved.name);
+  if (!resolved.force && await pathExists(projectRoot)) {
     logger.error(
       `Directory already exists: ${projectRoot}. Pass --force to overwrite, or choose a different --name/--dir.`
     );
@@ -5651,32 +5967,70 @@ async function initCommand(opts) {
     mode: 493
   });
   await writeFile12(join10(projectRoot, "README.md"), readmeTemplate(resolved), "utf8");
+  if (Object.keys(collectedKeys).length > 0) {
+    await writeFile12(join10(projectRoot, ".env"), buildEnvFile(collectedKeys, resolved), "utf8");
+  }
   logger.info(`Showrunner project scaffolded at ${projectRoot} (llm=${resolved.llm}, tts=${resolved.tts})`);
-  printNextSteps(opts.name, resolved);
+  printNextSteps(resolved.name, resolved, collectedKeys);
+}
+function buildEnvFile(keys, resolved) {
+  const lines = [`# Showrunner secrets \u2014 generated by \`showrunner init\`.`];
+  for (const [k, v] of Object.entries(keys)) {
+    lines.push(`${k}=${v}`);
+  }
+  lines.push("");
+  lines.push(`# Optional: form / setup-script auth.`);
+  lines.push(`DEMO_EMAIL=`);
+  lines.push(`DEMO_PASSWORD=`);
+  lines.push("");
+  lines.push(`# Optional log level: debug | info | warn | error`);
+  lines.push(`SHOWRUNNER_LOG_LEVEL=info`);
+  lines.push("");
+  if (resolved.llm === "openai" || resolved.tts === "openai") {
+  }
+  return lines.join("\n");
 }
-function printNextSteps(projectName, resolved) {
+function printNextSteps(projectName, resolved, collectedKeys) {
   const envVars = requiredEnvVars(resolved);
+  const keysProvidedByWizard = Object.keys(collectedKeys);
+  const remainingEnvVars = envVars.filter((v) => !keysProvidedByWizard.includes(v));
   const lines = ["", `Next:`, ""];
   let step = 1;
   lines.push(`  ${step++}. cd ${projectName}`);
-  if (envVars.length > 0) {
-    const keysList = envVars.join(", ");
-    lines.push(`  ${step++}. cp .env.example .env       # then paste in: ${keysList}`);
+  if (envVars.length === 0) {
+    lines.push(
+      `  ${step++}. (.env not needed \u2014 agent_bridge LLM + ${resolved.tts} TTS don't use API keys.)`
+    );
+  } else if (remainingEnvVars.length === 0) {
+    lines.push(`  ${step++}. .env is already populated with the keys you pasted.`);
   } else {
+    if (keysProvidedByWizard.length === 0) {
+      lines.push(`  ${step++}. cp .env.example .env`);
+    }
+    lines.push(`  ${step++}. Edit .env to fill in:`);
+    for (const v of remainingEnvVars) {
+      const dash = PROVIDER_DASHBOARDS[v];
+      lines.push(`       ${v}${dash ? `  (get it at ${dash})` : ""}`);
+    }
     lines.push(
-      `  ${step++}. (no .env needed \u2014 agent_bridge LLM + ${resolved.tts} TTS don't require API keys)`
+      `     (No keys? Switch llm.default.provider to \`agent_bridge\` in demo.yaml \u2014 uses your local Claude CLI instead.)`
     );
   }
-  lines.push(`  ${step++}. $EDITOR docs/PRD.md          # replace the stub with your product brief`);
+  lines.push(`  ${step++}. Edit docs/PRD.md (the stub explains what each section is for).`);
   lines.push(`  ${step++}. showrunner doctor -c demo.yaml`);
-  lines.push(`  ${step++}. showrunner run -c demo.yaml  # \u2192 output/demo_final.mp4`);
+  lines.push(`  ${step++}. showrunner run -c demo.yaml   # \u2192 output/demo_final.mp4`);
   lines.push("");
   lines.push(
-    `Optional: \`showrunner understand -c demo.yaml --interactive\` if you'd rather answer five questions than write the PRD upfront.`
+    `Don't want to write a PRD? Run \`showrunner understand -c demo.yaml --interactive\` instead \u2014 it asks 5 questions and builds the product model from your answers.`
   );
   lines.push("");
   process.stdout.write(lines.join("\n"));
 }
+var PROVIDER_DASHBOARDS = {
+  ANTHROPIC_API_KEY: "https://console.anthropic.com/settings/keys",
+  OPENAI_API_KEY: "https://platform.openai.com/api-keys",
+  ELEVENLABS_API_KEY: "https://elevenlabs.io/app/settings/api-keys"
+};
 function requiredEnvVars(resolved) {
   const vars = /* @__PURE__ */ new Set();
   if (resolved.llm === "anthropic") vars.add("ANTHROPIC_API_KEY");
@@ -5696,7 +6050,7 @@ function validateChoice(value, allowed, defaultValue, flagName) {
 }
 async function pathExists(p) {
   try {
-    await access2(p);
+    await access3(p);
     return true;
   } catch {
     return false;
@@ -6115,8 +6469,8 @@ and \`at_word\` actions degrade to \`at\`).
 }
 
 // src/commands/installBrowser.ts
-import { spawn as spawn4 } from "child_process";
-import { access as access3 } from "fs/promises";
+import { spawn as spawn5 } from "child_process";
+import { access as access4 } from "fs/promises";
 import { fileURLToPath } from "url";
 import { dirname as dirname11, join as join11 } from "path";
 var DEFAULT_BROWSER = "chromium";
@@ -6124,7 +6478,7 @@ async function installBrowserCommand(opts) {
   const browser = opts.browser ?? DEFAULT_BROWSER;
   const cli = await resolvePlaywrightCoreCli();
   logger.info(`installing Playwright ${browser} (via bundled playwright-core, no project required)`);
-  const child = spawn4(process.execPath, [cli, "install", browser], {
+  const child = spawn5(process.execPath, [cli, "install", browser], {
     stdio: "inherit",
     env: process.env
   });
@@ -6145,7 +6499,7 @@ async function resolvePlaywrightCoreCli() {
   while (dir && dir !== root) {
     const candidate = join11(dir, "node_modules", "playwright-core", "cli.js");
     try {
-      await access3(candidate);
+      await access4(candidate);
       return candidate;
     } catch {
     }
@@ -6159,7 +6513,7 @@ async function resolvePlaywrightCoreCli() {
 }
 
 // src/commands/validate.ts
-import { stat as stat10 } from "fs/promises";
+import { stat as stat11 } from "fs/promises";
 import { isAbsolute as isAbsolute9, resolve as resolve16 } from "path";
 async function validateCommand(opts) {
   try {
@@ -6197,7 +6551,7 @@ async function checkReferencedPaths(config, configDir) {
     if (!relPath) return;
     const abs = isAbsolute9(relPath) ? relPath : resolve16(configDir, relPath);
     try {
-      await stat10(abs);
+      await stat11(abs);
     } catch {
       warnings.push(`${label} not found: ${abs}`);
     }
@@ -6248,12 +6602,12 @@ async function printVoCommand(opts) {
     }
     throw err;
   }
-  const text = renderVoScript(manifest, { projectName: loaded.config.project.name });
-  process.stdout.write(text);
+  const text2 = renderVoScript(manifest, { projectName: loaded.config.project.name });
+  process.stdout.write(text2);
 }
 
 // src/commands/approveVo.ts
-import { rm as rm2, stat as stat11 } from "fs/promises";
+import { rm as rm2, stat as stat12 } from "fs/promises";
 import { resolve as resolve18 } from "path";
 async function approveVoCommand(opts) {
   let loaded;
@@ -6301,7 +6655,7 @@ async function approveVoCommand(opts) {
 }
 async function pathExists2(p) {
   try {
-    await stat11(p);
+    await stat12(p);
     return true;
   } catch {
     return false;
@@ -6519,9 +6873,9 @@ async function launchHeadedSession(opts) {
   const page = await context.newPage();
   if (opts.withCursor) {
     page.on("console", (msg) => {
-      const text = msg.text();
-      if (text.startsWith("[showrunner-cursor]")) {
-        logger.debug(`browser: ${text}`);
+      const text2 = msg.text();
+      if (text2.startsWith("[showrunner-cursor]")) {
+        logger.debug(`browser: ${text2}`);
       }
     });
   }
@@ -6595,7 +6949,7 @@ Then re-run \`showrunner run --config <demo.yaml>\`.
 }
 
 // src/commands/trace.ts
-import { readdir as readdir2, stat as stat12 } from "fs/promises";
+import { readdir as readdir2, stat as stat13 } from "fs/promises";
 import { isAbsolute as isAbsolute11, join as join13, resolve as resolve22 } from "path";
 async function traceCommand(opts) {
   let loaded;
@@ -6677,7 +7031,7 @@ async function listTraces(dir) {
 }
 async function fileExists8(path) {
   try {
-    await stat12(path);
+    await stat13(path);
     return true;
   } catch {
     return false;
@@ -6685,7 +7039,7 @@ async function fileExists8(path) {
 }
 
 // src/commands/preview.ts
-import { stat as stat13 } from "fs/promises";
+import { stat as stat14 } from "fs/promises";
 import { resolve as resolve23 } from "path";
 async function previewCommand(opts) {
   let loaded;
@@ -6724,7 +7078,7 @@ async function previewCommand(opts) {
 }
 async function fileExists9(path) {
   try {
-    await stat13(path);
+    await stat14(path);
     return true;
   } catch {
     return false;
@@ -6863,7 +7217,7 @@ var LineReader = class {
     });
   }
 };
-async function ask(reader, prompt) {
+async function ask2(reader, prompt) {
   process.stdout.write(prompt);
   return reader.read();
 }
@@ -6874,23 +7228,23 @@ async function runInteractiveQA() {
     process.stdout.write(
       "\nLet's build a product_model interactively. Answer each prompt with a short line.\n\n"
     );
-    const productName = (await ask(reader, "1. Product name: ")).trim();
+    const productName = (await ask2(reader, "1. Product name: ")).trim();
     if (!productName) throw new Error("product name is required");
-    const tagline = (await ask(reader, "2. One-sentence tagline: ")).trim();
-    const primaryUser = (await ask(reader, "3. Who is the primary user? ")).trim();
-    const featuresLine = (await ask(reader, "4. Top 3-6 features, comma-separated:\n   ")).trim();
+    const tagline = (await ask2(reader, "2. One-sentence tagline: ")).trim();
+    const primaryUser = (await ask2(reader, "3. Who is the primary user? ")).trim();
+    const featuresLine = (await ask2(reader, "4. Top 3-6 features, comma-separated:\n   ")).trim();
     const topFeatures = featuresLine.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-    const flowCountStr = (await ask(reader, "5. How many flows would you like to demo (2-4)? ")).trim();
+    const flowCountStr = (await ask2(reader, "5. How many flows would you like to demo (2-4)? ")).trim();
     const flowCount = clamp(parseInt(flowCountStr, 10) || 2, 2, 4);
     const topFlows = [];
     for (let i = 0; i < flowCount; i++) {
-      const name = (await ask(reader, `   Flow ${i + 1} name: `)).trim();
-      const stepsLine = (await ask(reader, `   Flow ${i + 1} steps, '|' separated:
+      const name = (await ask2(reader, `   Flow ${i + 1} name: `)).trim();
+      const stepsLine = (await ask2(reader, `   Flow ${i + 1} steps, '|' separated:
    `)).trim();
       const steps = stepsLine.split("|").map((s) => s.trim()).filter((s) => s.length > 0);
       topFlows.push({ name, steps });
     }
-    const durationStr = (await ask(reader, "6. Target demo duration in seconds (60-120, default 75): ")).trim();
+    const durationStr = (await ask2(reader, "6. Target demo duration in seconds (60-120, default 75): ")).trim();
     const suggestedDurationSeconds = clamp(parseInt(durationStr, 10) || 75, 30, 180);
     return {
       productName,
@@ -7280,7 +7634,7 @@ Apply with:  cd ${loaded.configDir} && git apply ${opts.output}
 // src/commands/recordActions.ts
 import { createInterface as createInterface3 } from "readline/promises";
 import { resolve as resolve26 } from "path";
-import { stat as stat14 } from "fs/promises";
+import { stat as stat15 } from "fs/promises";
 
 // src/recording/captureEvents.ts
 async function installCaptureBinding(context, onEvent) {
@@ -7594,7 +7948,7 @@ async function mergeIntoManifest(opts) {
 }
 async function fileExists10(path) {
   try {
-    await stat14(path);
+    await stat15(path);
     return true;
   } catch {
     return false;
@@ -7603,7 +7957,7 @@ async function fileExists10(path) {
 
 // src/cli.ts
 var program = new Command();
-program.name("showrunner").description("Automated product demo recording & production tool").version("1.1.2").option("--json", "emit structured JSON logs to stdout").option("--log-level <level>", "log level (debug|info|warn|error)").hook("preAction", (thisCmd) => {
+program.name("showrunner").description("Automated product demo recording & production tool").version("1.1.4").option("--json", "emit structured JSON logs to stdout").option("--log-level <level>", "log level (debug|info|warn|error)").hook("preAction", (thisCmd) => {
   const opts = thisCmd.opts();
   if (opts.json) logger.setJson(true);
   if (opts.logLevel) logger.setLevel(opts.logLevel);
@@ -7623,7 +7977,7 @@ program.command("run").description("Run the full Showrunner pipeline").requiredO
   "--resolution <preset>",
   "override resolution for this run: low (854x480), standard (720p), high (1080p), extreme (4K)"
 ).action(runCommand2);
-program.command("init").description("Scaffold a new Showrunner project").option("--name <name>", "project name", "showrunner-demo").option("--url <url>", "target URL of the product to demo", "http://localhost:3000").option("--dir <dir>", "parent directory in which to create the project", process.cwd()).option("--force", "overwrite an existing directory", false).option(
+program.command("init").description("Scaffold a new Showrunner project (interactive by default; use --yes to skip prompts)").option("--name <name>", "project name", "showrunner-demo").option("--url <url>", "target URL of the product to demo", "http://localhost:3000").option("--dir <dir>", "parent directory in which to create the project", process.cwd()).option("--force", "overwrite an existing directory", false).option("--yes", "skip interactive prompts and use defaults / passed flags", false).option(
   "--llm-provider <name>",
   "LLM provider for comprehension + script + instrument (anthropic | openai | agent_bridge)",
   "anthropic"
@@ -7654,44 +8008,36 @@ program.parseAsync(process.argv).catch((err) => {
   process.exit(1);
 });
 async function printWelcome() {
-  const { access: access4 } = await import("fs/promises");
+  const { access: access5 } = await import("fs/promises");
   const { resolve: resolve27 } = await import("path");
   const demoYaml = resolve27(process.cwd(), "demo.yaml");
   let inProject = false;
   try {
-    await access4(demoYaml);
+    await access5(demoYaml);
     inProject = true;
   } catch {
   }
   const browserMissing = await isChromiumMissing();
-  const lines = ["", `Showrunner v1.1.2 \u2014 automated product-demo recording & production`, ""];
+  const lines = ["", `Showrunner v1.1.4`, ""];
   if (browserMissing) {
-    lines.push(`First-time setup: install the recording browser (one-off, ~150 MB):`);
+    lines.push(`Showrunner records using Chromium. You haven't installed it yet.`);
     lines.push(``);
-    lines.push(`  showrunner install-browser            # wraps Playwright; no "install dependencies first" warning`);
+    lines.push(`  showrunner install-browser`);
     lines.push(``);
-  }
-  if (inProject) {
-    lines.push(`Detected demo.yaml in this directory. Likely next:`);
+    lines.push(`(~150 MB, one-off. Re-run \`showrunner\` after it finishes for the next step.)`);
+  } else if (inProject) {
+    lines.push(`This is a Showrunner project (found demo.yaml).`);
     lines.push(``);
-    lines.push(`  showrunner doctor -c demo.yaml      # preflight checks`);
-    lines.push(`  showrunner run -c demo.yaml         # run the full pipeline`);
+    lines.push(`  showrunner doctor -c demo.yaml     # check everything is wired correctly`);
+    lines.push(`  showrunner run -c demo.yaml        # then run the full pipeline`);
     lines.push(``);
-    lines.push(`Other commands: \`showrunner --help\``);
+    lines.push(`Full command list: \`showrunner --help\``);
   } else {
-    lines.push(`No demo.yaml here. To scaffold a new project:`);
-    lines.push(``);
-    lines.push(`  showrunner init --name my-demo --url http://localhost:3000`);
-    lines.push(``);
-    lines.push(`Then inside the new directory:`);
+    lines.push(`No Showrunner project in this directory. To create one:`);
     lines.push(``);
-    lines.push(`  cd my-demo`);
-    lines.push(`  cp .env.example .env                 # paste provider keys, or use agent_bridge (no keys)`);
-    lines.push(`  $EDITOR docs/PRD.md                  # write your product brief`);
-    lines.push(`  showrunner doctor -c demo.yaml       # preflight`);
-    lines.push(`  showrunner run -c demo.yaml          # full pipeline \u2192 output/demo_final.mp4`);
+    lines.push(`  showrunner init`);
     lines.push(``);
-    lines.push(`See all commands: \`showrunner --help\``);
+    lines.push(`\`init\` scaffolds the project and prints the next 4 commands tailored to your provider choice.`);
   }
   lines.push("");
   process.stdout.write(lines.join("\n"));
@@ -7700,8 +8046,8 @@ async function isChromiumMissing() {
   try {
     const { chromium: chromium6 } = await import("playwright-core");
     const exec = chromium6.executablePath();
-    const { stat: stat15 } = await import("fs/promises");
-    await stat15(exec);
+    const { stat: stat16 } = await import("fs/promises");
+    await stat16(exec);
     return false;
   } catch {
     return true;