@kadj-amoah/showrunner 1.1.6 → 1.1.8

package/dist/cli.js

@@ -76,7 +76,14 @@ import "zod";
 import { z } from "zod";
 var projectSchema = z.object({
   name: z.string().min(1),
-  product_model: z.string().optional()
+  product_model: z.string().optional(),
+  /**
+   * Path to the product's codebase, resolved relative to demo.yaml's directory.
+   * Used by `understand --agent` to anchor the agent's exploration.
+   * Defaults to `..` because the canonical scaffold layout places the
+   * Showrunner project inside or beside the product directory.
+   */
+  codebase_root: z.string().optional()
 });
 var comprehensionSourceSchema = z.object({
   type: z.enum(["prd", "readme", "codebase", "openapi", "changelog", "custom"]),
@@ -5928,6 +5935,29 @@ function sleep3(ms) {
 var SLUG_RE = /^[a-z0-9](?:[a-z0-9._-]*[a-z0-9])?$/i;
 async function runWizard(env) {
   intro("Showrunner setup");
+  note(
+    [
+      `Showrunner will scaffold a new project inside:`,
+      ``,
+      `  ${process.cwd()}`,
+      ``,
+      `That directory should be the root of the product you want to demo (the dir`,
+      `where your package.json / pyproject.toml / etc. lives). If you're somewhere`,
+      `else, cancel with Ctrl+C, \`cd\` to your product's root, and re-run`,
+      `\`showrunner init\` from there.`
+    ].join("\n"),
+    "Heads up \u2014 confirm your starting directory"
+  );
+  const proceedFromCwd = await ask(
+    confirm({
+      message: "Continue scaffolding from this directory?",
+      initialValue: true
+    })
+  );
+  if (proceedFromCwd === null || proceedFromCwd === false) {
+    cancel("Setup cancelled. Re-run `showrunner init` from your product root.");
+    return null;
+  }
   note(formatDetection(env), "Detected on this machine");
   const projectName = await ask(
     text({
@@ -6423,6 +6453,11 @@ function demoYamlTemplate(opts) {
 project:
   name: ${opts.name}
   # product_model: ./product_model.json   # uncomment to skip comprehension
+  # Where the product codebase lives, relative to this demo.yaml. Used by
+  # \`showrunner understand --agent\` to anchor the agent's exploration.
+  # Default \`..\` matches the canonical layout where the Showrunner scaffold
+  # sits inside (or beside) the product directory.
+  codebase_root: ..
 
 comprehension:
   mode: documents
@@ -7623,8 +7658,17 @@ async function generateProductModelViaAgent(opts) {
   const provider = new AgentBridgeLLMProvider({
     mode: "spawn",
     command: opts.command ?? "claude",
-    args: opts.args ?? ["-p", "--output-format", "json"],
-    timeoutMs: opts.timeoutMs ?? 18e4,
+    args: opts.args ?? [
+      "-p",
+      "--output-format",
+      "json",
+      // Explicitly allow read-only filesystem tools so claude doesn't stall on
+      // permission ambiguity in headless mode. Comma-separated per claude CLI syntax.
+      "--allowedTools",
+      "Read,Glob,Grep"
+    ],
+    // 90s cap — was 180s in v1.1.6, dropped here because failures should fail fast.
+    timeoutMs: opts.timeoutMs ?? 9e4,
     cwd: opts.projectDir
   });
   const userPrompt = [
@@ -7748,6 +7792,7 @@ async function understandCommand(opts) {
   let outputRel = opts.output ?? "./product_model.json";
   let sources = [];
   let llmConfig;
+  let loadedCodebaseRoot;
   if (opts.config) {
     let loaded;
     try {
@@ -7765,6 +7810,7 @@ async function understandCommand(opts) {
     }
     sources = loaded.config.comprehension.sources.map((s) => ({ path: s.path, type: s.type }));
     llmConfig = loaded.config.llm;
+    loadedCodebaseRoot = loaded.config.project.codebase_root;
     const envFile = resolve25(loaded.configDir, ".env");
     try {
       process.loadEnvFile(envFile);
@@ -7776,8 +7822,19 @@ async function understandCommand(opts) {
   let productModel;
   try {
     if (opts.agent) {
-      const projectDir = process.cwd();
-      logger.info("Generating product_model via local `claude` agent", { projectDir });
+      const projectDir = resolveAgentProjectDir({
+        flagOverride: opts.projectDir,
+        codebaseRoot: opts.config ? loadedCodebaseRoot : void 0,
+        configDir: opts.config ? configDir : void 0
+      });
+      logger.info("Generating product_model via local `claude` agent", {
+        projectDir,
+        source: resolveAgentProjectDirSource({
+          flagOverride: opts.projectDir,
+          codebaseRoot: opts.config ? loadedCodebaseRoot : void 0,
+          configDir: opts.config ? configDir : void 0
+        })
+      });
       productModel = await generateProductModelViaAgent({ projectDir });
     } else if (opts.interactive) {
       const answers = await runInteractiveQA();
@@ -7822,6 +7879,24 @@ async function understandCommand(opts) {
   await writeFile15(outputPath, JSON.stringify(productModel, null, 2) + "\n", "utf8");
   logger.info("Wrote product_model.json", { path: outputPath });
 }
+function resolveAgentProjectDir(input) {
+  if (input.flagOverride) {
+    return isAbsolute13(input.flagOverride) ? input.flagOverride : resolve25(process.cwd(), input.flagOverride);
+  }
+  if (input.codebaseRoot && input.configDir) {
+    return isAbsolute13(input.codebaseRoot) ? input.codebaseRoot : resolve25(input.configDir, input.codebaseRoot);
+  }
+  if (input.configDir) {
+    return resolve25(input.configDir, "..");
+  }
+  return process.cwd();
+}
+function resolveAgentProjectDirSource(input) {
+  if (input.flagOverride) return "--project-dir flag";
+  if (input.codebaseRoot && input.configDir) return "project.codebase_root in demo.yaml";
+  if (input.configDir) return "configDir/..  (default; set project.codebase_root to override)";
+  return "cwd (no -c flag)";
+}
 
 // src/commands/instrument.ts
 import { mkdir as mkdir16, readdir as readdir4, writeFile as writeFile16 } from "fs/promises";
@@ -8442,7 +8517,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.6").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.8").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);
@@ -8481,7 +8556,10 @@ program.command("doctor").description("Run preflight checks on the current confi
 program.command("validate").description("Validate a demo.yaml config file").requiredOption("-c, --config <path>", "path to demo.yaml").option("--strict", "exit nonzero on any warning (e.g. missing provider env var)").action(validateCommand);
 program.command("understand").description("Build product_model.json from documents, interactive Q&A, or agent-driven repo exploration").option("-c, --config <path>", "path to demo.yaml").option("--interactive", "use interactive Q&A mode (5 prompts, no LLM)").option(
   "--agent",
-  "delegate to the local `claude` CLI: it explores the current directory with its read tools and synthesizes the product model. Closes the type=codebase gap in demo.yaml sources."
+  "delegate to the local `claude` CLI: it explores the project with its read tools and synthesizes the product model. Closes the type=codebase gap in demo.yaml sources."
+).option(
+  "--project-dir <path>",
+  "directory the --agent run should explore. Overrides project.codebase_root from demo.yaml. Defaults to configDir/.. when -c is given, or cwd otherwise."
 ).option("--output <path>", "output path for product_model.json").action(understandCommand);
 program.command("instrument").description("Suggest data-testid attributes for a codebase").requiredOption("-c, --config <path>", "path to demo.yaml").requiredOption("--output <path>", "unified diff output path").option("--glob <pattern>", "override comprehension.sources with an ad-hoc glob (relative to configDir)").action(instrumentCommand);
 program.command("record-actions").description("Author manifest actions by demonstrating them in a live browser").requiredOption("-c, --config <path>", "path to demo.yaml").option("--segment <id>", "replace actions for an existing segment id").option("--output <path>", "manifest output path (default ./scripts/manifest.json)").action(recordActionsCommand);
@@ -8506,14 +8584,28 @@ async function printWelcome() {
     inProject = true;
   } catch {
   }
-  const browserMissing = await isChromiumMissing();
-  const lines = ["", `Showrunner v1.1.6`, ""];
-  if (browserMissing) {
-    lines.push(`Showrunner records using Chromium. You haven't installed it yet.`);
+  const missing = await detectMissingPrereqs();
+  const anyMissing = missing.ffmpeg || missing.ffprobe || missing.chromium;
+  const lines = ["", `Showrunner v1.1.8`, ""];
+  if (anyMissing) {
+    lines.push(`First-time setup. Showrunner needs these system tools:`);
     lines.push(``);
-    lines.push(`  showrunner install-browser`);
-    lines.push(``);
-    lines.push(`(~150 MB, one-off. Re-run \`showrunner\` after it finishes for the next step.)`);
+    if (missing.ffmpeg || missing.ffprobe) {
+      const which = missing.ffmpeg && missing.ffprobe ? "ffmpeg / ffprobe" : missing.ffmpeg ? "ffmpeg" : "ffprobe";
+      lines.push(`  ${which} \u2014 install via your OS package manager:`);
+      lines.push(`    Linux (apt):    sudo apt install ffmpeg`);
+      lines.push(`    Linux (pacman): sudo pacman -S ffmpeg`);
+      lines.push(`    Linux (dnf):    sudo dnf install ffmpeg`);
+      lines.push(`    macOS:          brew install ffmpeg`);
+      lines.push(`    Windows:        winget install Gyan.FFmpeg`);
+      lines.push(``);
+    }
+    if (missing.chromium) {
+      lines.push(`  chromium recording browser \u2014 install via:`);
+      lines.push(`    showrunner install-browser`);
+      lines.push(``);
+    }
+    lines.push(`Re-run \`showrunner\` once those are in place.`);
   } else if (inProject) {
     lines.push(`This is a Showrunner project (found demo.yaml).`);
     lines.push(``);
@@ -8524,22 +8616,60 @@ async function printWelcome() {
   } else {
     lines.push(`No Showrunner project in this directory. To create one:`);
     lines.push(``);
-    lines.push(`  showrunner init`);
+    lines.push(`  cd <your-product's-root-directory>   # the dir with package.json / etc.`);
+    lines.push(`  showrunner init                       # then run init from THERE`);
     lines.push(``);
-    lines.push(`\`init\` scaffolds the project and prints the next 4 commands tailored to your provider choice.`);
+    lines.push(`\`init\` scaffolds inside cwd, so cwd must be your product. The wizard will`);
+    lines.push(`confirm the path before doing anything destructive.`);
   }
   lines.push("");
   process.stdout.write(lines.join("\n"));
 }
-async function isChromiumMissing() {
+async function detectMissingPrereqs() {
+  const [ffmpegOk, ffprobeOk, chromiumOk] = await Promise.all([
+    binaryOnPath("ffmpeg"),
+    binaryOnPath("ffprobe"),
+    chromiumInstalled2()
+  ]);
+  return {
+    ffmpeg: !ffmpegOk,
+    ffprobe: !ffprobeOk,
+    chromium: !chromiumOk
+  };
+}
+async function binaryOnPath(name) {
+  const { spawn: spawn7 } = await import("child_process");
+  return new Promise((resolve28) => {
+    const useShell = process.platform === "win32";
+    const child = spawn7(name, ["-version"], {
+      stdio: ["ignore", "ignore", "ignore"],
+      shell: useShell
+    });
+    let settled = false;
+    const finish = (ok) => {
+      if (settled) return;
+      settled = true;
+      resolve28(ok);
+    };
+    child.on("error", () => finish(false));
+    child.on("exit", (code) => finish(code === 0));
+    setTimeout(() => {
+      if (!settled) {
+        child.kill("SIGKILL");
+        finish(false);
+      }
+    }, 3e3);
+  });
+}
+async function chromiumInstalled2() {
   try {
     const { chromium: chromium6 } = await import("playwright-core");
     const exec = chromium6.executablePath();
     const { stat: stat17 } = await import("fs/promises");
     await stat17(exec);
-    return false;
-  } catch {
     return true;
+  } catch {
+    return false;
   }
 }
 function parseStages(value) {