@kadj-amoah/showrunner 1.1.2 → 1.1.3

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to Showrunner are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); the project tracks loose semver — minor bumps for new capability, patch for fixes.
 
+## [1.1.3] — 2026-05-24
+
+UX polish on the post-install discovery path, prompted by author feedback during the CachyOS install smoke-test of v1.1.2 ("the entire welcome wagon needs to be worked on"). No functional change — pure copy + structure.
+
+### Changed
+
+- **Bare-command welcome rewritten to one-thing-at-a-time.** Each state (chromium missing, no project here, project here) now shows a single next command and a one-line description, instead of a 15-line wall that duplicated `init`'s footer and crammed multiple ideas per line. The outside-project branch now just points at `showrunner init` and defers all sequencing to `init`'s own output.
+- **`init` next-steps footer tightened.** The previous `cp .env.example .env       # then paste in: KEY_A, KEY_B` line conflated three things (file op, key list, no-keys alternative). Now split: step 2 is the `cp`, step 3 lists each required env var on its own line alongside the dashboard URL it's issued from, with the `agent_bridge` alternative as a single parenthetical at the end. Each step is exactly one observable action.
+
 ## [1.1.2] — 2026-05-24
 
 Hot-fix for a regression discovered while smoke-testing the v1.1.1 install on CachyOS.

package/dist/cli.js

@@ -5660,23 +5660,35 @@ function printNextSteps(projectName, resolved) {
   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}`);
+    lines.push(`  ${step++}. cp .env.example .env`);
+    lines.push(`  ${step++}. Edit .env to fill in:`);
+    for (const v of envVars) {
+      const dash = PROVIDER_DASHBOARDS[v];
+      lines.push(`       ${v}${dash ? `  (get it at ${dash})` : ""}`);
+    }
+    lines.push(
+      `     (No keys? Switch llm.default.provider to \`agent_bridge\` in demo.yaml \u2014 uses your local Claude CLI instead.)`
+    );
   } else {
     lines.push(
-      `  ${step++}. (no .env needed \u2014 agent_bridge LLM + ${resolved.tts} TTS don't require API keys)`
+      `  ${step++}. (.env not needed \u2014 agent_bridge LLM + ${resolved.tts} TTS don't use API keys.)`
     );
   }
-  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");
@@ -7603,7 +7615,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.3").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);
@@ -7664,34 +7676,26 @@ async function printWelcome() {
   } catch {
   }
   const browserMissing = await isChromiumMissing();
-  const lines = ["", `Showrunner v1.1.2 \u2014 automated product-demo recording & production`, ""];
+  const lines = ["", `Showrunner v1.1.3`, ""];
   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"));