@spark-apps/quickpeek 1.2.0 → 1.2.1

package/dist/qp.js

@@ -59,7 +59,7 @@ function getErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
 function toTitleCase(text) {
-  return text.replace(/\w+/g, (word, index) => {
+  return text.replace(/\w+(?:'\w+)*/g, (word, index) => {
     if (index === 0) {
       return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
     }
@@ -125,6 +125,9 @@ var init_utils = __esm({
 });
 
 // src/lib/api-client.ts
+function apiKey() {
+  return process.env.SPARK_AI_KEY || "";
+}
 async function getOrRefreshDirectToken() {
   const now = Date.now();
   if (cachedDirectToken && cachedDirectToken.expiresAt > now + 3e5) {
@@ -133,7 +136,7 @@ async function getOrRefreshDirectToken() {
   try {
     const response = await fetch(SPARK_AI_TOKEN, {
       method: "POST",
-      headers: { "X-Api-Key": API_KEY }
+      headers: { "X-Api-Key": apiKey() }
     });
     if (!response.ok) {
       throw new Error(`Token exchange failed: ${response.status} ${response.statusText}`);
@@ -244,7 +247,7 @@ async function executeChat(chatUrl, bearerToken, systemPrompt, userPrompt, tier)
   return lastRateLimitError || { success: false, error: "Request failed after retries" };
 }
 async function callAI(systemPrompt, userPrompt, tier = "free") {
-  if (!API_KEY) {
+  if (!apiKey()) {
     return {
       success: false,
       error: "AI service is not configured. Please report this issue.",
@@ -304,7 +307,7 @@ function normalizeUrl(input) {
   url = url.replace(/^(https?:\/\/)?(www\.)?/i, "");
   return `https://${url}`;
 }
-var SPARK_AI_BASE, SPARK_AI_CHAT, SPARK_AI_TOKEN, RELAY_BASE, RELAY_TOKEN_URL, RELAY_CHAT_URL, API_KEY, cachedDirectToken, cachedRelayToken;
+var SPARK_AI_BASE, SPARK_AI_CHAT, SPARK_AI_TOKEN, RELAY_BASE, RELAY_TOKEN_URL, RELAY_CHAT_URL, cachedDirectToken, cachedRelayToken;
 var init_api_client = __esm({
   "src/lib/api-client.ts"() {
     "use strict";
@@ -315,7 +318,6 @@ var init_api_client = __esm({
     RELAY_BASE = process.env.QUICKPEEK_API_BASE || "https://quickpeek.co";
     RELAY_TOKEN_URL = `${RELAY_BASE}/api/cli/token`;
     RELAY_CHAT_URL = `${RELAY_BASE}/api/cli/ai`;
-    API_KEY = process.env.SPARK_AI_KEY || "";
     cachedDirectToken = null;
     cachedRelayToken = null;
   }
@@ -419,7 +421,7 @@ var VERSION, CONFIG_FILE, DEFAULT_CONFIG, DEFAULT_CAPTIONS;
 var init_config = __esm({
   "src/lib/config.ts"() {
     "use strict";
-    VERSION = "1.1.1";
+    VERSION = "1.2.1";
     CONFIG_FILE = "quickpeek.config.json";
     DEFAULT_CONFIG = {
       plan: { maxSteps: 8 },
@@ -586,20 +588,29 @@ function getActionForType(type) {
       return "type";
   }
 }
-async function crawlPage(url, task2 = noopTask, storageStatePath) {
-  const cached = crawlCache.get(url);
+async function crawlPage(url, task2 = noopTask, storageStatePath, viewport) {
+  const cacheKey = viewport ? `${url}@${viewport.width}x${viewport.height}` : url;
+  const cached = crawlCache.get(cacheKey);
   if (cached && Date.now() - cached.timestamp < CRAWL_CACHE_TTL_MS) {
     task2("Using cached crawl").succeed(`Found ${cached.elements.length} interactive elements (cached)`);
-    return { title: cached.title, elements: [...cached.elements] };
+    return { title: cached.title, elements: [...cached.elements], scrollable: cached.scrollable };
   }
   const browserTask = task2("Launching browser");
   const browser = await import_playwright.chromium.launch({ headless: true });
-  const context = await browser.newContext(storageStatePath ? { storageState: storageStatePath } : {});
+  const context = await browser.newContext({
+    ...storageStatePath ? { storageState: storageStatePath } : {},
+    // Crawl at the size we will record at, or the measurements below describe
+    // a page nobody will ever see.
+    ...viewport ? { viewport } : {}
+  });
   const page = await context.newPage();
   browserTask.succeed(storageStatePath ? "Browser launched (signed in)" : "Browser launched");
   const crawlTask = task2("Crawling page");
   await page.goto(url, { waitUntil: "networkidle", timeout: 3e4 });
   const title = await page.title();
+  const scrollable = await page.evaluate(
+    "Math.max(0, document.documentElement.scrollHeight - window.innerHeight)"
+  );
   const rawElements = await page.evaluate(`
     (() => {
       const items = [];
@@ -729,12 +740,12 @@ async function crawlPage(url, task2 = noopTask, storageStatePath) {
   });
   await browser.close();
   crawlTask.succeed(`Found ${elements.length} interactive elements`);
-  crawlCache.set(url, { timestamp: Date.now(), title, elements: [...elements] });
+  crawlCache.set(cacheKey, { timestamp: Date.now(), title, elements: [...elements], scrollable });
   if (crawlCache.size > CRAWL_CACHE_MAX_ENTRIES) {
     const oldest = crawlCache.keys().next().value;
     if (oldest !== void 0) crawlCache.delete(oldest);
   }
-  return { title, elements };
+  return { title, elements, scrollable };
 }
 var import_playwright, noopTask, CRAWL_CACHE_TTL_MS, CRAWL_CACHE_MAX_ENTRIES, crawlCache;
 var init_crawl = __esm({
@@ -1308,7 +1319,7 @@ EXAMPLES:
 \u2022 File upload: "target": "input[type=\\"file\\"]"
 \u2022 Slider: "target": "input[type=\\"range\\"]"`;
 }
-function buildUserPrompt(url, title, elements, langName, description, maxSteps) {
+function buildUserPrompt(url, title, elements, langName, description, maxSteps, scrollable) {
   const lang = langName ? `
 Language: Write ALL captions in ${langName}.` : "";
   const purpose = description ? `
@@ -1346,8 +1357,13 @@ ${selectables.map((e) => `\u2022 "${e.text}" \u2192 ${e.selector}`).join("\n")}`
 ${checkables.map((e) => `\u2022 "${e.text}" \u2192 ${e.selector}`).join("\n")}`);
   }
   const elementSummary = elementDict.length > 0 ? elementDict.join("\n\n") : "(no interactive elements found)";
+  const cannotScroll = scrollable !== void 0 && scrollable < MIN_USEFUL_SCROLL_PX;
+  const scrolling = cannotScroll ? `
+
+SCROLLING: this page has only ${scrollable}px of scroll travel at the recording size, so it does not scroll.` : "";
+  const scrollRule = cannotScroll ? "\n\u2022 NEVER use the scroll action: this page does not scroll, so the video would freeze. Use wait and click steps only" : "";
   return `URL: ${url}
-Title: ${title}${purpose}
+Title: ${title}${purpose}${scrolling}
 
 AVAILABLE ELEMENTS (grouped by action):
 ${elementSummary}
@@ -1357,7 +1373,7 @@ REQUIREMENTS:
 \u2022 Complete ONE user journey: input \u2192 process \u2192 output
 \u2022 For CLICK: use simplified text target like "extract frame" or "download"
 \u2022 For UPLOAD/DRAG/TYPE: use the CSS selector shown above
-\u2022 For buttons that appear after actions: use partial text like "extract" or "download"${lang}
+\u2022 For buttons that appear after actions: use partial text like "extract" or "download"${scrollRule}${lang}
 
 Return JSON:
 {
@@ -1380,10 +1396,12 @@ TARGET SYNTAX:
 \u2022 Sliders: input[type="range"]
 \u2022 Text inputs: Use selector from list above`;
 }
+var MIN_USEFUL_SCROLL_PX;
 var init_prompts = __esm({
   "src/lib/prompts.ts"() {
     "use strict";
     init_utils();
+    MIN_USEFUL_SCROLL_PX = 200;
   }
 });
 
@@ -2011,7 +2029,7 @@ var init_lib = __esm({
 
 // src/qp.ts
 var import_dotenv = __toESM(require("dotenv"));
-var import_chalk20 = __toESM(require("chalk"));
+var import_chalk21 = __toESM(require("chalk"));
 
 // src/commands/auth-cmd.ts
 var import_node_readline2 = require("readline");
@@ -2324,6 +2342,7 @@ async function showHelp() {
       "Use your own narration script"
     ],
     [`${cmd("qp capture")} ${arg("<url>")}`, `qp capture <url>`, "Record interactions manually"],
+    [`${cmd("qp edit")} ${arg("<url>")}`, `qp edit <url>`, "Edit the demo plan in the browser"],
     [`${cmd("qp login")}`, `qp login`, "Sign in with your Google account"],
     [`${cmd("qp logout")}`, `qp logout`, "Sign out"],
     [`${cmd("qp auth")} ${arg("<url>")}`, `qp auth <url>`, "Save a signed-in session for a site you demo"],
@@ -2414,7 +2433,7 @@ function promptInput(prompt2) {
 var _isWSL = process.platform === "linux" && process.env.WSL_DISTRO_NAME;
 function formatClickablePath(filePath) {
   const absolutePath = (0, import_node_path8.resolve)(filePath);
-  if (_isWSL) {
+  if (_isWSL || process.platform !== "win32") {
     return absolutePath;
   }
   let formatted = absolutePath;
@@ -2513,16 +2532,23 @@ init_lib();
 var import_node_http = require("http");
 var import_node_url = require("url");
 var import_chalk4 = __toESM(require("chalk"));
-init_SparkStripe_feature_gating();
-var TIMEOUT_MS = 12e4;
-async function openBrowser(url) {
-  const { exec: exec2 } = await import("child_process");
+
+// src/lib/browser-open.ts
+var import_node_child_process3 = require("child_process");
+function editorBaseUrl() {
+  return (process.env.QUICKPEEK_API_BASE || "https://quickpeek.co").replace(/\/$/, "");
+}
+function openInBrowser(url) {
   const isWSL2 = process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME);
   const command = isWSL2 ? `cmd.exe /c start "" "${url}"` : process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
   return new Promise((resolve9) => {
-    exec2(command, () => resolve9());
+    (0, import_node_child_process3.exec)(command, () => resolve9());
   });
 }
+
+// src/utils/browser-auth.ts
+init_SparkStripe_feature_gating();
+var TIMEOUT_MS = 12e4;
 async function browserLogin() {
   return new Promise((resolve9) => {
     let server;
@@ -2576,7 +2602,7 @@ async function browserLogin() {
       console.log(import_chalk4.default.dim(`  ${url}`));
       console.log();
       console.log(import_chalk4.default.dim("  Waiting for sign-in (press Ctrl+C to cancel)..."));
-      openBrowser(url);
+      void openInBrowser(url);
     });
     timer = setTimeout(() => {
       console.log();
@@ -2858,20 +2884,20 @@ function normalizeUrl2(url) {
 }
 
 // src/capture.ts
-var import_node_child_process4 = require("child_process");
+var import_node_child_process5 = require("child_process");
 var import_node_http3 = require("http");
 var import_node_readline4 = require("readline");
 var import_playwright4 = require("playwright");
 
 // src/browser/wsl.ts
-var import_node_child_process3 = require("child_process");
+var import_node_child_process4 = require("child_process");
 var import_node_fs5 = require("fs");
 var import_node_http2 = require("http");
 var import_playwright3 = require("playwright");
 function isWSL() {
   if (process.platform !== "linux") return false;
   try {
-    const r = (0, import_node_child_process3.execSync)("uname -r", { encoding: "utf-8" }).toLowerCase();
+    const r = (0, import_node_child_process4.execSync)("uname -r", { encoding: "utf-8" }).toLowerCase();
     return r.includes("microsoft") || r.includes("wsl");
   } catch {
     return false;
@@ -2889,7 +2915,7 @@ function wslToWindowsPath(wslPath) {
 function findExe(whereExeQuery, ...hardcoded) {
   for (const p of hardcoded) if ((0, import_node_fs5.existsSync)(p)) return p;
   try {
-    const line = (0, import_node_child_process3.execSync)(`where.exe ${whereExeQuery}`, { encoding: "utf-8", timeout: 3e3 }).split("\n")[0]?.trim();
+    const line = (0, import_node_child_process4.execSync)(`where.exe ${whereExeQuery}`, { encoding: "utf-8", timeout: 3e3 }).split("\n")[0]?.trim();
     if (line) return line.replace(/^([A-Za-z]):\\/, (_, d) => `/mnt/${d.toLowerCase()}/`).replace(/\\/g, "/");
   } catch {
   }
@@ -2903,7 +2929,7 @@ var findWindowsChrome = () => findExe(
 var findWindowsNode = () => findExe("node.exe");
 function getWindowsHostIP() {
   try {
-    const m = (0, import_node_child_process3.execSync)("ip route show default", { encoding: "utf-8", timeout: 2e3 }).match(
+    const m = (0, import_node_child_process4.execSync)("ip route show default", { encoding: "utf-8", timeout: 2e3 }).match(
       /default via (\d+\.\d+\.\d+\.\d+)/
     );
     if (m?.[1]) return m[1];
@@ -2919,7 +2945,7 @@ function getWindowsHostIP() {
 function startRelay(nodePath, windowsHost, targetPort) {
   const script = `var n=require('net'),s=n.createServer(function(c){var r=n.createConnection(${targetPort},'127.0.0.1');c.pipe(r);r.pipe(c);r.on('error',function(){c.destroy()});c.on('error',function(){r.destroy()});});s.listen(0,'${windowsHost}',function(){process.stdout.write('PORT:'+s.address().port+'\\n')});`;
   return new Promise((resolve9, reject) => {
-    const proc = (0, import_node_child_process3.spawn)(nodePath, ["-e", script], { stdio: ["ignore", "pipe", "ignore"], detached: true });
+    const proc = (0, import_node_child_process4.spawn)(nodePath, ["-e", script], { stdio: ["ignore", "pipe", "ignore"], detached: true });
     const timer = setTimeout(() => reject(new Error("relay startup timed out")), 6e3);
     let buf = "";
     proc.stdout.on("data", (d) => {
@@ -2966,7 +2992,7 @@ async function launchWindowsChrome(extensionPath, userDataDir, options = {}) {
   if (!nodePath) throw new Error("Windows Node.js not found. Install Node.js for Windows.");
   const winUserData = wslToWindowsPath(userDataDir);
   const winExtPath = extensionPath ? wslToWindowsPath(extensionPath) : "";
-  const chromeProc = (0, import_node_child_process3.spawn)(
+  const chromeProc = (0, import_node_child_process4.spawn)(
     chromePath,
     [
       `--remote-debugging-port=${debugPort}`,
@@ -3150,9 +3176,9 @@ async function launchCaptureChrome() {
     return { browser, relay: probe.proc };
   }
   probe.proc.kill();
-  const winTemp = (0, import_node_child_process4.execSync)("cmd.exe /c echo %TEMP%", { encoding: "utf-8" }).trim().replace(/\r$/, "");
+  const winTemp = (0, import_node_child_process5.execSync)("cmd.exe /c echo %TEMP%", { encoding: "utf-8" }).trim().replace(/\r$/, "");
   const userDataDir = `${winTemp}\\qp-capture`;
-  (0, import_node_child_process4.spawn)(
+  (0, import_node_child_process5.spawn)(
     chromePath,
     [
       `--remote-debugging-port=${debugPort}`,
@@ -3649,7 +3675,14 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir) {
         }
       } else {
         const amount = direction === "up" ? -PAGE_SCROLL_PX : PAGE_SCROLL_PX;
-        await page.evaluate((y) => window.scrollBy(0, y), amount);
+        const moved = await page.evaluate((y) => {
+          const before = window.scrollY;
+          window.scrollBy(0, y);
+          return window.scrollY - before;
+        }, amount);
+        if (moved === 0) {
+          throw new Error("scroll moved nothing: the page has no scroll headroom at this viewport");
+        }
       }
       break;
     }
@@ -4805,12 +4838,12 @@ async function parsePlanJson(content, task2, logError2, userEmail, tier = "free"
     }
   }
 }
-async function crawlAndAnalyze(url, lang, description, maxSteps, task2, logError2, userEmail, extensionPath, workDir, tier = "free") {
-  const { title, elements } = extensionPath && workDir ? await crawlExtension(url, extensionPath, workDir, task2) : await crawlPage(url, task2, findAuthState(url));
+async function crawlAndAnalyze(url, lang, description, maxSteps, task2, logError2, userEmail, extensionPath, workDir, tier = "free", viewport) {
+  const { title, elements, scrollable } = extensionPath && workDir ? { ...await crawlExtension(url, extensionPath, workDir, task2), scrollable: void 0 } : await crawlPage(url, task2, findAuthState(url), viewport);
   const aiTask = task2("Generating plan with AI");
   const langName = getLanguageName(lang);
   const systemPrompt = buildSystemPrompt(maxSteps);
-  const userPrompt = buildUserPrompt(url, title, elements, langName, description, maxSteps);
+  const userPrompt = buildUserPrompt(url, title, elements, langName, description, maxSteps, scrollable);
   try {
     const content = await callGroq(systemPrompt, userPrompt, logError2, userEmail, tier);
     const jsonMatch = content.match(/\{[\s\S]*\}/);
@@ -4839,7 +4872,7 @@ async function validateAndFixPlan(planPath, task2, logError2, userEmail, tier =
   }
   const renumberTask = task2("Validating plan structure");
   const originalCount = plan.steps.length;
-  const INVALID_TARGETS = [/\.png$/i, /\.jpg$/i, /\.gif$/i, /\.webp$/i, /\.svg$/i, /sprite_sheet/i, /downloaded/i];
+  const INVALID_TARGETS2 = [/\.png$/i, /\.jpg$/i, /\.gif$/i, /\.webp$/i, /\.svg$/i, /sprite_sheet/i, /downloaded/i];
   const isValidStep = (s) => {
     if (!s?.action) return false;
     if (s.action === "navigate") {
@@ -4848,7 +4881,7 @@ async function validateAndFixPlan(planPath, task2, logError2, userEmail, tier =
     }
     if (["click", "type", "select", "check", "upload", "drag"].includes(s.action)) {
       if (!s.target) return false;
-      if (INVALID_TARGETS.some((pattern) => pattern.test(s.target))) return false;
+      if (INVALID_TARGETS2.some((pattern) => pattern.test(s.target))) return false;
     }
     if (s.action === "upload") {
       if (!s.target?.includes("file") && !s.target?.includes("input")) return false;
@@ -5314,16 +5347,172 @@ async function captureCommand(url, lang) {
   console.log(import_chalk11.default.cyan(`  ${finalPath}`));
 }
 
-// src/commands/init-cmd.ts
+// src/commands/edit-cmd.ts
 var import_node_fs14 = require("fs");
-var import_promises14 = require("fs/promises");
 var import_node_path21 = require("path");
 var import_chalk12 = __toESM(require("chalk"));
+
+// src/lib/plan-validation.ts
+var INVALID_TARGETS = [
+  /\.png$/i,
+  /\.jpg$/i,
+  /\.gif$/i,
+  /\.webp$/i,
+  /\.svg$/i,
+  /sprite_sheet/i,
+  /downloaded/i
+];
+var ACTIONS_REQUIRING_TARGET = ["click", "type", "select", "check", "drag"];
+function isFilePath(value) {
+  if (!value) return false;
+  return /\.\w{2,5}$/.test(value) && (/[/\\]/.test(value) || /^[a-zA-Z]:/.test(value));
+}
+function isInvalidTarget(target) {
+  return INVALID_TARGETS.some((pattern) => pattern.test(target));
+}
+function validateStep(step) {
+  if (!step?.action) {
+    return "Missing action";
+  }
+  if (step.action === "navigate") {
+    if (!step.target) return "Navigate requires a URL target";
+    if (!step.target.startsWith("http://") && !step.target.startsWith("https://")) {
+      return "Navigate target must be a valid URL";
+    }
+  }
+  if (step.action === "media") {
+    if (!step.mediaFile && !isFilePath(step.value)) {
+      return "Media step requires a file (image or video)";
+    }
+  }
+  if (step.action === "upload") {
+    if (!step.mediaFile && !isFilePath(step.value)) {
+      return "Upload step requires a file";
+    }
+  }
+  if (ACTIONS_REQUIRING_TARGET.includes(step.action)) {
+    if (!step.target) return `${step.action} requires a target`;
+    if (isInvalidTarget(step.target)) return `Invalid target pattern: ${step.target}`;
+  }
+  return null;
+}
+
+// src/lib/plan-file.ts
+var MAX_HANDOFF_URL_CHARS = 32e3;
+function serializePlan(plan) {
+  return `${JSON.stringify(plan, null, 2)}
+`;
+}
+function parsePlanText(text) {
+  let raw;
+  try {
+    raw = JSON.parse(text);
+  } catch (e) {
+    return { ok: false, error: `Not valid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return { ok: false, error: "A plan must be a JSON object." };
+  }
+  const candidate = raw;
+  if (typeof candidate.url !== "string" || !candidate.url.trim()) {
+    return { ok: false, error: "A plan needs a `url` to record." };
+  }
+  if (!Array.isArray(candidate.steps) || candidate.steps.length === 0) {
+    return { ok: false, error: "A plan needs at least one step." };
+  }
+  const steps = [];
+  for (const [index, step] of candidate.steps.entries()) {
+    if (!step || typeof step !== "object" || Array.isArray(step)) {
+      return { ok: false, error: `Step ${index + 1} is not an object.` };
+    }
+    const typed = step;
+    if (typeof typed.action !== "string" || !typed.action.trim()) {
+      return { ok: false, error: `Step ${index + 1} has no action.` };
+    }
+    const failure = validateStep(typed);
+    if (failure) return { ok: false, error: `Step ${index + 1}: ${failure}` };
+    steps.push({ ...typed, id: typed.id ?? index + 1 });
+  }
+  return {
+    ok: true,
+    plan: {
+      url: candidate.url,
+      title: candidate.title ?? "",
+      description: candidate.description ?? "",
+      ...candidate.lang ? { lang: candidate.lang } : {},
+      steps
+    }
+  };
+}
+function toBase64Url(text) {
+  const bytes = new TextEncoder().encode(text);
+  const binary = Array.from(bytes, (b) => String.fromCharCode(b)).join("");
+  const base64 = typeof btoa === "function" ? btoa(binary) : Buffer.from(text, "utf8").toString("base64");
+  return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function encodePlan(plan) {
+  return toBase64Url(serializePlan(plan));
+}
+function planEditorUrl(baseUrl, plan) {
+  const url = `${baseUrl.replace(/\/$/, "")}/edit#plan=${encodePlan(plan)}`;
+  return url.length <= MAX_HANDOFF_URL_CHARS ? url : null;
+}
+
+// src/commands/edit-cmd.ts
+var PLAN_FILE = /^plan-([a-z]{2}(?:-[A-Z]{2})?)\.json$/;
+function findPlanFile(dir, lang) {
+  if (lang) {
+    const exact = (0, import_node_path21.join)(dir, `plan-${lang}.json`);
+    return (0, import_node_fs14.existsSync)(exact) ? exact : null;
+  }
+  if (!(0, import_node_fs14.existsSync)(dir)) return null;
+  const plans = (0, import_node_fs14.readdirSync)(dir).filter((f) => PLAN_FILE.test(f));
+  const preferred = plans.find((f) => f === "plan-en.json") ?? plans[0];
+  return preferred ? (0, import_node_path21.join)(dir, preferred) : null;
+}
+async function editCommand(url, lang) {
+  console.log();
+  showLogo();
+  const dir = getOutputDirFromUrl(url);
+  const planPath = findPlanFile(dir, lang);
+  if (!planPath) {
+    console.log(import_chalk12.default.red(`  No plan found in ${dir}`));
+    console.log(import_chalk12.default.dim(`  Record the demo first: `) + import_chalk12.default.cyan(`qp ${url}`));
+    console.log();
+    return;
+  }
+  const parsed = parsePlanText((0, import_node_fs14.readFileSync)(planPath, "utf8"));
+  if (!parsed.ok) {
+    console.log(import_chalk12.default.red(`  ${planPath} cannot be opened: ${parsed.error}`));
+    console.log();
+    return;
+  }
+  const base = editorBaseUrl();
+  const editorUrl = planEditorUrl(base, parsed.plan);
+  if (!editorUrl) {
+    console.log(import_chalk12.default.yellow("  This plan is too long to carry in a link."));
+    console.log(import_chalk12.default.dim(`  Open ${base}/edit and load `) + import_chalk12.default.cyan(formatClickablePath(planPath)));
+    console.log();
+    await openInBrowser(`${base}/edit`);
+    return;
+  }
+  await openInBrowser(editorUrl);
+  console.log(import_chalk12.default.green(`  \u2713 Opened ${parsed.plan.steps.length} steps in the editor`));
+  console.log(import_chalk12.default.dim(`  ${formatClickablePath(planPath)}`));
+  console.log(import_chalk12.default.dim("  Save from the editor over this file, then record again."));
+  console.log();
+}
+
+// src/commands/init-cmd.ts
+var import_node_fs15 = require("fs");
+var import_promises14 = require("fs/promises");
+var import_node_path22 = require("path");
+var import_chalk13 = __toESM(require("chalk"));
 init_lib();
 async function initCommand() {
-  const configPath = (0, import_node_path21.join)(process.cwd(), CONFIG_FILE);
-  if ((0, import_node_fs14.existsSync)(configPath)) {
-    console.log(import_chalk12.default.yellow(`  \u26A0 ${CONFIG_FILE} already exists`));
+  const configPath = (0, import_node_path22.join)(process.cwd(), CONFIG_FILE);
+  if ((0, import_node_fs15.existsSync)(configPath)) {
+    console.log(import_chalk13.default.yellow(`  \u26A0 ${CONFIG_FILE} already exists`));
     return;
   }
   const defaultConfig = {
@@ -5348,28 +5537,28 @@ async function initCommand() {
   };
   await (0, import_promises14.writeFile)(configPath, `${JSON.stringify(defaultConfig, null, 2)}
 `);
-  console.log(import_chalk12.default.green(`  \u2714 Created ${CONFIG_FILE}`));
-  console.log(import_chalk12.default.dim(`  Edit it or use: qp config <key> <value>`));
+  console.log(import_chalk13.default.green(`  \u2714 Created ${CONFIG_FILE}`));
+  console.log(import_chalk13.default.dim(`  Edit it or use: qp config <key> <value>`));
 }
 async function configCommand(key, value) {
-  const configPath = (0, import_node_path21.join)(process.cwd(), CONFIG_FILE);
+  const configPath = (0, import_node_path22.join)(process.cwd(), CONFIG_FILE);
   if (!key) {
-    if (!(0, import_node_fs14.existsSync)(configPath)) {
-      console.log(import_chalk12.default.yellow(`  No ${CONFIG_FILE} found. Run: qp init`));
+    if (!(0, import_node_fs15.existsSync)(configPath)) {
+      console.log(import_chalk13.default.yellow(`  No ${CONFIG_FILE} found. Run: qp init`));
       return;
     }
     const content = await (0, import_promises14.readFile)(configPath, "utf-8");
-    console.log(import_chalk12.default.cyan(`  ${CONFIG_FILE}:`));
+    console.log(import_chalk13.default.cyan(`  ${CONFIG_FILE}:`));
     console.log(content);
     return;
   }
   if (!value) {
-    console.log(import_chalk12.default.red(`  Missing value for ${key}`));
-    console.log(import_chalk12.default.dim(`  Usage: qp config ${key} <value>`));
+    console.log(import_chalk13.default.red(`  Missing value for ${key}`));
+    console.log(import_chalk13.default.dim(`  Usage: qp config ${key} <value>`));
     return;
   }
   let config = {};
-  if ((0, import_node_fs14.existsSync)(configPath)) {
+  if ((0, import_node_fs15.existsSync)(configPath)) {
     try {
       config = JSON.parse(await (0, import_promises14.readFile)(configPath, "utf-8"));
     } catch {
@@ -5395,40 +5584,40 @@ async function configCommand(key, value) {
   }
   await (0, import_promises14.writeFile)(configPath, `${JSON.stringify(config, null, 2)}
 `);
-  console.log(import_chalk12.default.green(`  \u2714 Set ${key} = ${value}`));
+  console.log(import_chalk13.default.green(`  \u2714 Set ${key} = ${value}`));
 }
 
 // src/commands/login-cmd.ts
-var import_chalk13 = __toESM(require("chalk"));
+var import_chalk14 = __toESM(require("chalk"));
 init_lib();
 async function loginCommand() {
   console.log();
   showLogo();
   const existing = await loadUserData();
   if (existing.email && existing.verified) {
-    console.log(import_chalk13.default.dim(`  Already signed in as ${existing.email}`));
-    console.log(import_chalk13.default.dim("  Run ") + import_chalk13.default.cyan("qp logout") + import_chalk13.default.dim(" first to switch accounts."));
+    console.log(import_chalk14.default.dim(`  Already signed in as ${existing.email}`));
+    console.log(import_chalk14.default.dim("  Run ") + import_chalk14.default.cyan("qp logout") + import_chalk14.default.dim(" first to switch accounts."));
     console.log();
     try {
       const status = await getStatusCached(existing.email);
       const tier2 = await getTierByEmail(existing.email);
-      const tierLabel2 = tier2 === "pro" ? import_chalk13.default.green("Pro") : "Free";
+      const tierLabel2 = tier2 === "pro" ? import_chalk14.default.green("Pro") : "Free";
       console.log(`  ${tierLabel2} plan`);
       for (const line of formatUsageLines(status, tier2)) {
-        console.log(import_chalk13.default.dim(`  ${line}`));
+        console.log(import_chalk14.default.dim(`  ${line}`));
       }
     } catch {
     }
     console.log();
     return;
   }
-  console.log(import_chalk13.default.white("  Sign in with your Google account to track usage"));
-  console.log(import_chalk13.default.white("  and unlock Pro features."));
+  console.log(import_chalk14.default.white("  Sign in with your Google account to track usage"));
+  console.log(import_chalk14.default.white("  and unlock Pro features."));
   const email = await browserLogin();
   if (!email) {
     console.log();
-    console.log(import_chalk13.default.yellow("  Sign-in cancelled or timed out."));
-    console.log(import_chalk13.default.dim("  Run ") + import_chalk13.default.cyan("qp login") + import_chalk13.default.dim(" to try again."));
+    console.log(import_chalk14.default.yellow("  Sign-in cancelled or timed out."));
+    console.log(import_chalk14.default.dim("  Run ") + import_chalk14.default.cyan("qp login") + import_chalk14.default.dim(" to try again."));
     console.log();
     return;
   }
@@ -5439,8 +5628,8 @@ async function loginCommand() {
   }
   await saveUserData({ email, verified: true, tier });
   console.log();
-  const tierLabel = tier === "pro" ? import_chalk13.default.green("Pro") : "Free";
-  console.log(import_chalk13.default.green(`  \u2713 Signed in as ${email}`));
+  const tierLabel = tier === "pro" ? import_chalk14.default.green("Pro") : "Free";
+  console.log(import_chalk14.default.green(`  \u2713 Signed in as ${email}`));
   console.log(`  ${tierLabel} plan`);
   console.log();
 }
@@ -5448,46 +5637,46 @@ async function logoutCommand() {
   console.log();
   const userData = await loadUserData();
   if (!userData.email) {
-    console.log(import_chalk13.default.dim("  Not signed in."));
+    console.log(import_chalk14.default.dim("  Not signed in."));
     console.log();
     return;
   }
   const email = userData.email;
   await saveUserData({ email: "", verified: false, tier: "free" });
-  console.log(import_chalk13.default.green(`  \u2713 Signed out (${email})`));
+  console.log(import_chalk14.default.green(`  \u2713 Signed out (${email})`));
   console.log();
 }
 
 // src/commands/record-cmd.ts
-var import_node_fs17 = require("fs");
+var import_node_fs18 = require("fs");
 var import_promises17 = require("fs/promises");
-var import_node_path24 = require("path");
-var import_chalk18 = __toESM(require("chalk"));
+var import_node_path25 = require("path");
+var import_chalk19 = __toESM(require("chalk"));
 init_lib();
 
 // src/commands/phases/auth-phase.ts
-var import_chalk15 = __toESM(require("chalk"));
+var import_chalk16 = __toESM(require("chalk"));
 init_lib();
 
 // src/commands/utils/auth-helpers.ts
-var import_chalk14 = __toESM(require("chalk"));
+var import_chalk15 = __toESM(require("chalk"));
 init_lib();
 async function handleRegistrationGate() {
   console.log();
-  console.log(import_chalk14.default.yellow("  \u{1F389} You've made 5 free videos!"));
-  console.log(import_chalk14.default.white("     Sign in to continue creating videos."));
+  console.log(import_chalk15.default.yellow("  \u{1F389} You've made 5 free videos!"));
+  console.log(import_chalk15.default.white("     Sign in to continue creating videos."));
   console.log();
-  console.log(import_chalk14.default.dim("  Benefits of signing in:"));
-  console.log(import_chalk14.default.dim("    \u2022 20 more videos per month"));
-  console.log(import_chalk14.default.dim("    \u2022 Keep your video history"));
-  console.log(import_chalk14.default.dim("    \u2022 Upgrade to Pro anytime"));
+  console.log(import_chalk15.default.dim("  Benefits of signing in:"));
+  console.log(import_chalk15.default.dim("    \u2022 20 more videos per month"));
+  console.log(import_chalk15.default.dim("    \u2022 Keep your video history"));
+  console.log(import_chalk15.default.dim("    \u2022 Upgrade to Pro anytime"));
   let email = await browserLogin();
   if (!email) {
     console.log();
     email = await promptInput("Email: ");
   }
   if (!email || !email.includes("@")) {
-    console.log(import_chalk14.default.red("  Invalid email. Run qp again to try again."));
+    console.log(import_chalk15.default.red("  Invalid email. Run qp again to try again."));
     return null;
   }
   const registerTask = task("Sending verification email");
@@ -5502,10 +5691,10 @@ async function handleRegistrationGate() {
   }
   registerTask.succeed("Check your email!");
   console.log();
-  console.log(import_chalk14.default.cyan("  \u{1F4E7} Verification email sent to:"));
-  console.log(import_chalk14.default.white(`     ${email}`));
+  console.log(import_chalk15.default.cyan("  \u{1F4E7} Verification email sent to:"));
+  console.log(import_chalk15.default.white(`     ${email}`));
   console.log();
-  console.log(import_chalk14.default.dim("  Click the link in the email, then press Enter to continue..."));
+  console.log(import_chalk15.default.dim("  Click the link in the email, then press Enter to continue..."));
   await promptInput("");
   const verifyTask = task("Checking verification");
   const verified = await isVerified(email);
@@ -5515,10 +5704,10 @@ async function handleRegistrationGate() {
   }
   verifyTask.fail("Not verified yet");
   console.log();
-  console.log(import_chalk14.default.yellow("  Email not verified. Check your inbox and spam folder."));
-  console.log(import_chalk14.default.dim("  Run qp again after clicking the verification link."));
+  console.log(import_chalk15.default.yellow("  Email not verified. Check your inbox and spam folder."));
+  console.log(import_chalk15.default.dim("  Run qp again after clicking the verification link."));
   console.log();
-  console.log(import_chalk14.default.cyan(`  Or register/upgrade at: ${getUpgradeUrl(email)}`));
+  console.log(import_chalk15.default.cyan(`  Or register/upgrade at: ${getUpgradeUrl(email)}`));
   console.log();
   return { email, verified: false };
 }
@@ -5546,7 +5735,7 @@ async function runAuthPhase(input) {
     } else {
       verifyTask.fail("Email not verified");
       console.log();
-      console.log(import_chalk15.default.yellow("  Check your inbox for the verification email."));
+      console.log(import_chalk16.default.yellow("  Check your inbox for the verification email."));
       console.log();
       const input2 = await promptInput(`New email or Enter to retry (${userEmail}): `);
       if (input2.toLowerCase() === "exit") {
@@ -5571,8 +5760,8 @@ async function runAuthPhase(input) {
           registerTask.succeed("Check your email!");
           await saveUserData({ email: newEmail, verified: false });
           console.log();
-          console.log(import_chalk15.default.cyan(`  \u{1F4E7} Verification sent to: ${newEmail}`));
-          console.log(import_chalk15.default.dim("  Click the link in the email, then run qp again."));
+          console.log(import_chalk16.default.cyan(`  \u{1F4E7} Verification sent to: ${newEmail}`));
+          console.log(import_chalk16.default.dim("  Click the link in the email, then run qp again."));
           console.log();
           gracefulExit();
           return null;
@@ -5588,7 +5777,7 @@ async function runAuthPhase(input) {
         } else {
           recheckTask.fail("Still not verified");
           console.log();
-          console.log(import_chalk15.default.cyan(`  Register/upgrade at: ${getUpgradeUrl(userEmail)}`));
+          console.log(import_chalk16.default.cyan(`  Register/upgrade at: ${getUpgradeUrl(userEmail)}`));
           console.log();
           gracefulExit();
           return null;
@@ -5615,8 +5804,8 @@ async function runAuthPhase(input) {
   } else {
     const remaining = FREE_VIDEO_LIMIT - localVideoCount;
     console.log();
-    console.log(import_chalk15.default.cyan(`  \u{1F3AC} Video ${localVideoCount + 1}/${FREE_VIDEO_LIMIT} free`));
-    console.log(import_chalk15.default.dim(`     ${remaining - 1} more after this \u2022 Sign up for unlimited`));
+    console.log(import_chalk16.default.cyan(`  \u{1F3AC} Video ${localVideoCount + 1}/${FREE_VIDEO_LIMIT} free`));
+    console.log(import_chalk16.default.dim(`     ${remaining - 1} more after this \u2022 Sign up for unlimited`));
     userEmail = await setupUserEmail();
     let registeredVerified = false;
     try {
@@ -5635,10 +5824,10 @@ async function runAuthPhase(input) {
 }
 
 // src/commands/phases/plan-phase.ts
-var import_node_fs15 = require("fs");
+var import_node_fs16 = require("fs");
 var import_promises15 = require("fs/promises");
-var import_node_path22 = require("path");
-var import_chalk16 = __toESM(require("chalk"));
+var import_node_path23 = require("path");
+var import_chalk17 = __toESM(require("chalk"));
 
 // src/ai/fix.ts
 init_lib();
@@ -5790,12 +5979,22 @@ Return ONLY JSON: {"description": "...", "captions": ["...", ...]}`;
 // src/commands/phases/plan-phase.ts
 var INDENT6 = "   ";
 async function runPlanPhase(params) {
-  const { url, config, userEmail, description, planPath, legacyPlanPath, targetLang, userTier = "free" } = params;
+  const {
+    url,
+    config,
+    userEmail,
+    description,
+    planPath,
+    legacyPlanPath,
+    targetLang,
+    userTier = "free",
+    fresh = false
+  } = params;
   const maxSteps = config.plan?.maxSteps ?? 8;
   const extensionPath = config.browser?.extension;
   let existingPlan = null;
   let existingPlanPath = null;
-  if ((0, import_node_fs15.existsSync)(planPath)) {
+  if ((0, import_node_fs16.existsSync)(planPath)) {
     try {
       const parsed = JSON.parse(await (0, import_promises15.readFile)(planPath, "utf-8"));
       if (parsed.url && parsed.steps?.length > 0) {
@@ -5807,10 +6006,10 @@ async function runPlanPhase(params) {
   }
   if (!existingPlan) {
     try {
-      const files = (0, import_node_fs15.readdirSync)(config.output.dir);
-      const planFiles = files.filter((f) => /^plan-[a-z]{2}(-[A-Z]{2})?\.json$/.test(f) && f !== (0, import_node_path22.basename)(planPath));
+      const files = (0, import_node_fs16.readdirSync)(config.output.dir);
+      const planFiles = files.filter((f) => /^plan-[a-z]{2}(-[A-Z]{2})?\.json$/.test(f) && f !== (0, import_node_path23.basename)(planPath));
       for (const file of planFiles) {
-        const filePath = (0, import_node_path22.join)(config.output.dir, file);
+        const filePath = (0, import_node_path23.join)(config.output.dir, file);
         try {
           const parsed = JSON.parse(await (0, import_promises15.readFile)(filePath, "utf-8"));
           if (parsed.url && parsed.steps?.length > 0) {
@@ -5824,7 +6023,7 @@ async function runPlanPhase(params) {
     } catch {
     }
   }
-  if (!existingPlan && (0, import_node_fs15.existsSync)(legacyPlanPath)) {
+  if (!existingPlan && (0, import_node_fs16.existsSync)(legacyPlanPath)) {
     try {
       const parsed = JSON.parse(await (0, import_promises15.readFile)(legacyPlanPath, "utf-8"));
       if (parsed.url && parsed.steps?.length > 0) {
@@ -5850,25 +6049,25 @@ async function runPlanPhase(params) {
       translateTask.fail(failMsg);
     }
   };
-  if (existingPlan && existingPlanPath) {
+  if (existingPlan && existingPlanPath && !fresh) {
     console.log();
-    console.log(import_chalk16.default.dim(`  Found existing plan: `) + import_chalk16.default.cyan(formatClickablePath(existingPlanPath)));
-    console.log(import_chalk16.default.dim(`  ${existingPlan.steps.length} steps for ${existingPlan.url}`));
+    console.log(import_chalk17.default.dim(`  Found existing plan: `) + import_chalk17.default.cyan(formatClickablePath(existingPlanPath)));
+    console.log(import_chalk17.default.dim(`  ${existingPlan.steps.length} steps for ${existingPlan.url}`));
     if (!urlMatches) {
-      console.log(import_chalk16.default.yellow(`  \u26A0 Plan URL differs from argument:`));
-      console.log(import_chalk16.default.yellow(`    Plan: ${existingPlan.url}`));
-      console.log(import_chalk16.default.yellow(`    Arg:  ${url}`));
+      console.log(import_chalk17.default.yellow(`  \u26A0 Plan URL differs from argument:`));
+      console.log(import_chalk17.default.yellow(`    Plan: ${existingPlan.url}`));
+      console.log(import_chalk17.default.yellow(`    Arg:  ${url}`));
     }
     const existingLang = existingPlan.lang || "en";
     if (existingLang !== targetLang) {
-      console.log(import_chalk16.default.yellow(`  \u26A0 Plan is in ${existingLang}, config is ${targetLang}`));
+      console.log(import_chalk17.default.yellow(`  \u26A0 Plan is in ${existingLang}, config is ${targetLang}`));
     }
     const reuse = await confirm(`${INDENT6}Use existing plan?`);
     if (reuse) {
       plan = await validateAndFixPlan(existingPlanPath, task, logError, userEmail, userTier);
       if (existingPlanPath !== planPath) {
         await savePlan(plan, planPath);
-        console.log(import_chalk16.default.dim(`  Migrated to: ${formatClickablePath(planPath)}`));
+        console.log(import_chalk17.default.dim(`  Migrated to: ${formatClickablePath(planPath)}`));
       }
       if (existingLang !== targetLang) {
         const translate = await confirm(`${INDENT6}Translate to ${targetLang}?`);
@@ -5886,7 +6085,8 @@ async function runPlanPhase(params) {
         userEmail,
         extensionPath,
         config.output.dir,
-        userTier
+        userTier,
+        { width: config.video.width, height: config.video.height }
       );
       displayRateLimitInfo();
       if (urlMatches) {
@@ -5903,7 +6103,7 @@ async function runPlanPhase(params) {
             uploadIdx++;
           }
         }
-        console.log(import_chalk16.default.dim(`  Preserved upload paths from previous plan`));
+        console.log(import_chalk17.default.dim(`  Preserved upload paths from previous plan`));
       }
       await savePlan(plan, planPath);
       plan = await validateAndFixPlan(planPath, task, logError, userEmail, userTier);
@@ -5919,7 +6119,9 @@ async function runPlanPhase(params) {
       logError,
       userEmail,
       extensionPath,
-      config.output.dir
+      config.output.dir,
+      void 0,
+      { width: config.video.width, height: config.video.height }
     );
     displayRateLimitInfo();
     await savePlan(plan, planPath);
@@ -5927,8 +6129,8 @@ async function runPlanPhase(params) {
   }
   displayPlanSummary(plan);
   console.log();
-  console.log(import_chalk16.default.dim(`  Plan: ${formatClickablePath(planPath)}`));
-  console.log(import_chalk16.default.dim(`  Enter a prompt to refine, or press Enter to continue.`));
+  console.log(import_chalk17.default.dim(`  Plan: ${formatClickablePath(planPath)}`));
+  console.log(import_chalk17.default.dim(`  Enter a prompt to refine, or press Enter to continue.`));
   const MAX_REFINEMENTS = 10;
   let refinementCount = 0;
   while (true) {
@@ -5946,15 +6148,15 @@ async function runPlanPhase(params) {
       refineTask.succeed("Plan refined");
       displayRateLimitInfo();
       if (plan.steps.length > maxSteps) {
-        console.log(import_chalk16.default.yellow(`  \u26A0 ${plan.steps.length} steps exceeds limit of ${maxSteps}`));
+        console.log(import_chalk17.default.yellow(`  \u26A0 ${plan.steps.length} steps exceeds limit of ${maxSteps}`));
       }
       displayPlanSummary(plan);
       console.log();
-      console.log(import_chalk16.default.dim(`  Plan: ${formatClickablePath(planPath)}`));
+      console.log(import_chalk17.default.dim(`  Plan: ${formatClickablePath(planPath)}`));
       if (refinementCount >= MAX_REFINEMENTS) {
         console.log();
-        console.log(import_chalk16.default.yellow(`  \u26A0 You've refined the plan ${MAX_REFINEMENTS} times.`));
-        console.log(import_chalk16.default.dim(`  Further refinements may incur additional costs.`));
+        console.log(import_chalk17.default.yellow(`  \u26A0 You've refined the plan ${MAX_REFINEMENTS} times.`));
+        console.log(import_chalk17.default.dim(`  Further refinements may incur additional costs.`));
         const continueRefining = await confirm(`${INDENT6}Continue refining?`);
         if (!continueRefining) break;
       }
@@ -5966,12 +6168,12 @@ async function runPlanPhase(params) {
   const planLang = plan.lang || "en";
   if (planLang !== targetLang) {
     let useExistingTranslation = false;
-    if ((0, import_node_fs15.existsSync)(planPath) && existingPlanPath !== planPath) {
+    if ((0, import_node_fs16.existsSync)(planPath) && existingPlanPath !== planPath) {
       try {
         const translatedPlan = JSON.parse(await (0, import_promises15.readFile)(planPath, "utf-8"));
         if (translatedPlan.steps?.length === plan.steps.length && translatedPlan.lang === targetLang) {
           console.log();
-          console.log(import_chalk16.default.dim(`  Found translated plan: ${formatClickablePath(planPath)}`));
+          console.log(import_chalk17.default.dim(`  Found translated plan: ${formatClickablePath(planPath)}`));
           const useTranslated = await confirm(`${INDENT6}Use ${targetLang} translation?`);
           if (useTranslated) {
             plan = translatedPlan;
@@ -5983,7 +6185,7 @@ async function runPlanPhase(params) {
     }
     if (!useExistingTranslation) {
       console.log();
-      console.log(import_chalk16.default.yellow(`  Plan is in ${planLang}, but voice is set to ${targetLang}`));
+      console.log(import_chalk17.default.yellow(`  Plan is in ${planLang}, but voice is set to ${targetLang}`));
       const translate = await confirm(`${INDENT6}Translate captions to ${targetLang}?`);
       if (translate) await doTranslate("Translation failed, using original");
     }
@@ -5993,7 +6195,7 @@ async function runPlanPhase(params) {
 
 // src/commands/phases/validation-phase.ts
 var import_promises16 = require("fs/promises");
-var import_chalk17 = __toESM(require("chalk"));
+var import_chalk18 = __toESM(require("chalk"));
 async function runValidationPhase(params) {
   let { plan } = params;
   const { config, planPath, isExtensionUrl, userEmail, userTier = "free" } = params;
@@ -6044,21 +6246,21 @@ async function runValidationPhase(params) {
     const stepNum = result.stepIndex + 1;
     const step = plan.steps[result.stepIndex];
     console.log();
-    console.log(import_chalk17.default.red(`  \u2717 Step ${stepNum}: ${step.action}`));
+    console.log(import_chalk18.default.red(`  \u2717 Step ${stepNum}: ${step.action}`));
     const caption = step.caption || "";
-    if (caption) console.log(import_chalk17.default.dim(`    Caption: ${caption.slice(0, 50)}${caption.length > 50 ? "..." : ""}`));
-    console.log(import_chalk17.default.dim(`    Target: ${step.target || "none"}`));
-    if (step.value) console.log(import_chalk17.default.dim(`    Value: ${step.value}`));
-    console.log(import_chalk17.default.dim(`    Error: ${result.error}`));
+    if (caption) console.log(import_chalk18.default.dim(`    Caption: ${caption.slice(0, 50)}${caption.length > 50 ? "..." : ""}`));
+    console.log(import_chalk18.default.dim(`    Target: ${step.target || "none"}`));
+    if (step.value) console.log(import_chalk18.default.dim(`    Value: ${step.value}`));
+    console.log(import_chalk18.default.dim(`    Error: ${result.error}`));
     if (result.suggestion) {
-      console.log(import_chalk17.default.yellow(`    Hint: ${result.suggestion}`));
+      console.log(import_chalk18.default.yellow(`    Hint: ${result.suggestion}`));
     }
     console.log();
     const isUploadMissingFile = step.action === "upload" && (!step.value || step.value.startsWith("[") || step.value.includes("example") || step.value.includes("/path/to"));
     if (isUploadMissingFile) {
       const filePath = await promptInput('Enter file path to upload (or "skip"): ');
       if (filePath.toLowerCase() === "skip") {
-        console.log(import_chalk17.default.yellow(`  Skipping step ${stepNum}`));
+        console.log(import_chalk18.default.yellow(`  Skipping step ${stepNum}`));
         continue;
       }
       if (filePath) {
@@ -6067,13 +6269,13 @@ async function runValidationPhase(params) {
         const revalidation2 = await validateStepsOnPage(plan, config, logError, config.output.dir);
         const newResult2 = revalidation2.results[result.stepIndex];
         if (newResult2?.success) {
-          console.log(import_chalk17.default.green(`  \u2713 Step ${stepNum} now passes`));
+          console.log(import_chalk18.default.green(`  \u2713 Step ${stepNum} now passes`));
           validationResult = revalidation2;
           continue;
         }
         result.error = newResult2?.error;
         result.suggestion = newResult2?.suggestion;
-        console.log(import_chalk17.default.red(`  Still failing: ${result.error}`));
+        console.log(import_chalk18.default.red(`  Still failing: ${result.error}`));
       }
     }
     const fixTask = task(`Fixing step ${stepNum} with AI`);
@@ -6095,8 +6297,8 @@ async function runValidationPhase(params) {
       await savePlan(plan, planPath);
       fixTask.succeed("AI suggested a fix");
       const fixedStep = plan.steps[result.stepIndex];
-      console.log(import_chalk17.default.dim(`    New target: ${fixedStep.target || "none"}`));
-      if (fixedStep.value) console.log(import_chalk17.default.dim(`    New value: ${fixedStep.value}`));
+      console.log(import_chalk18.default.dim(`    New target: ${fixedStep.target || "none"}`));
+      if (fixedStep.value) console.log(import_chalk18.default.dim(`    New value: ${fixedStep.value}`));
     } catch {
       fixTask.fail("AI could not fix automatically");
     }
@@ -6112,11 +6314,11 @@ async function runValidationPhase(params) {
     result.error = newResult?.error;
     result.suggestion = newResult?.suggestion;
     console.log();
-    console.log(import_chalk17.default.yellow(`  Edit step ${stepNum} in: `) + import_chalk17.default.cyan(formatClickablePath(planPath)));
+    console.log(import_chalk18.default.yellow(`  Edit step ${stepNum} in: `) + import_chalk18.default.cyan(formatClickablePath(planPath)));
     console.log();
     const choice = await promptInput('Press Enter after editing, or type "skip" to skip this step: ');
     if (choice.toLowerCase() === "skip") {
-      console.log(import_chalk17.default.yellow(`  Skipping step ${stepNum} - may fail during recording`));
+      console.log(import_chalk18.default.yellow(`  Skipping step ${stepNum} - may fail during recording`));
       continue;
     }
     plan = JSON.parse(await (0, import_promises16.readFile)(planPath, "utf-8"));
@@ -6143,31 +6345,31 @@ async function runValidationPhase(params) {
 }
 
 // src/commands/utils/chrome-extension.ts
-var import_node_fs16 = require("fs");
+var import_node_fs17 = require("fs");
 var import_node_os3 = require("os");
-var import_node_path23 = require("path");
+var import_node_path24 = require("path");
 function resolveChromeExtension(extensionId) {
   const platform = process.platform;
   const possibleDirs = [];
   const getChromeExtDirs = (userDataPath) => {
     const dirs = [];
     try {
-      const profiles = (0, import_node_fs16.readdirSync)(userDataPath).filter((p) => p === "Default" || p.startsWith("Profile "));
+      const profiles = (0, import_node_fs17.readdirSync)(userDataPath).filter((p) => p === "Default" || p.startsWith("Profile "));
       for (const profile of profiles) {
-        dirs.push((0, import_node_path23.join)(userDataPath, profile, "Extensions"));
+        dirs.push((0, import_node_path24.join)(userDataPath, profile, "Extensions"));
       }
     } catch {
-      dirs.push((0, import_node_path23.join)(userDataPath, "Default", "Extensions"));
+      dirs.push((0, import_node_path24.join)(userDataPath, "Default", "Extensions"));
     }
     return dirs;
   };
   if (platform === "win32") {
-    possibleDirs.push(...getChromeExtDirs((0, import_node_path23.join)((0, import_node_os3.homedir)(), "AppData", "Local", "Google", "Chrome", "User Data")));
+    possibleDirs.push(...getChromeExtDirs((0, import_node_path24.join)((0, import_node_os3.homedir)(), "AppData", "Local", "Google", "Chrome", "User Data")));
   } else if (platform === "darwin") {
-    possibleDirs.push(...getChromeExtDirs((0, import_node_path23.join)((0, import_node_os3.homedir)(), "Library", "Application Support", "Google", "Chrome")));
+    possibleDirs.push(...getChromeExtDirs((0, import_node_path24.join)((0, import_node_os3.homedir)(), "Library", "Application Support", "Google", "Chrome")));
   } else {
     try {
-      const windowsUsers = (0, import_node_fs16.readdirSync)("/mnt/c/Users").filter(
+      const windowsUsers = (0, import_node_fs17.readdirSync)("/mnt/c/Users").filter(
         (u) => !["All Users", "Default", "Default User", "Public", "desktop.ini"].includes(u)
       );
       for (const user of windowsUsers) {
@@ -6175,22 +6377,22 @@ function resolveChromeExtension(extensionId) {
       }
     } catch {
     }
-    possibleDirs.push(...getChromeExtDirs((0, import_node_path23.join)((0, import_node_os3.homedir)(), ".config", "google-chrome")));
+    possibleDirs.push(...getChromeExtDirs((0, import_node_path24.join)((0, import_node_os3.homedir)(), ".config", "google-chrome")));
   }
   for (const chromeExtDir of possibleDirs) {
-    const extDir = (0, import_node_path23.join)(chromeExtDir, extensionId);
-    if (!(0, import_node_fs16.existsSync)(extDir)) continue;
+    const extDir = (0, import_node_path24.join)(chromeExtDir, extensionId);
+    if (!(0, import_node_fs17.existsSync)(extDir)) continue;
     try {
-      const versions = (0, import_node_fs16.readdirSync)(extDir).filter((f) => !f.startsWith("."));
+      const versions = (0, import_node_fs17.readdirSync)(extDir).filter((f) => !f.startsWith("."));
       if (versions.length === 0) continue;
       const latestVersion = versions.sort().pop();
-      const extPath = (0, import_node_path23.join)(extDir, latestVersion);
+      const extPath = (0, import_node_path24.join)(extDir, latestVersion);
       let name = extensionId;
       let popupPath = "popup.html";
-      const manifestPath = (0, import_node_path23.join)(extPath, "manifest.json");
-      if ((0, import_node_fs16.existsSync)(manifestPath)) {
+      const manifestPath = (0, import_node_path24.join)(extPath, "manifest.json");
+      if ((0, import_node_fs17.existsSync)(manifestPath)) {
         try {
-          const manifest = JSON.parse((0, import_node_fs16.readFileSync)(manifestPath, "utf-8"));
+          const manifest = JSON.parse((0, import_node_fs17.readFileSync)(manifestPath, "utf-8"));
           if (manifest.name && !manifest.name.startsWith("__MSG_")) {
             name = manifest.name;
           }
@@ -6221,16 +6423,16 @@ async function recordCommand(url, options = {}) {
     const extensionId = url.slice(7);
     chromeExtension = resolveChromeExtension(extensionId);
     if (!chromeExtension) {
-      console.log(import_chalk18.default.red(`
+      console.log(import_chalk19.default.red(`
   \u2717 Chrome extension not found: ${extensionId}`));
-      console.log(import_chalk18.default.dim(`    Make sure the extension is installed in Chrome
+      console.log(import_chalk19.default.dim(`    Make sure the extension is installed in Chrome
 `));
       process.exit(1);
     }
     config.browser = { extension: chromeExtension.path };
     url = chromeExtension.popupUrl;
-    console.log(import_chalk18.default.dim(`  Extension: ${chromeExtension.name}`));
-    console.log(import_chalk18.default.dim(`  Path: ${chromeExtension.path}`));
+    console.log(import_chalk19.default.dim(`  Extension: ${chromeExtension.name}`));
+    console.log(import_chalk19.default.dim(`  Path: ${chromeExtension.path}`));
   }
   config.output.dir = chromeExtension ? `./${chromeExtension.name.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-demo` : getOutputDirFromUrl(url);
   const userData = await loadUserData();
@@ -6243,20 +6445,20 @@ async function recordCommand(url, options = {}) {
   if (!authResult) return;
   const { userEmail, userTier, localVideoCount } = authResult;
   if (configCreated) {
-    const configPath = (0, import_node_path24.join)(process.cwd(), CONFIG_FILE);
+    const configPath = (0, import_node_path25.join)(process.cwd(), CONFIG_FILE);
     console.log();
-    console.log(import_chalk18.default.green(`  \u2714 Created ${CONFIG_FILE}`));
-    console.log(import_chalk18.default.dim(`    ${configPath}`));
+    console.log(import_chalk19.default.green(`  \u2714 Created ${CONFIG_FILE}`));
+    console.log(import_chalk19.default.dim(`    ${configPath}`));
     console.log();
-    console.log(import_chalk18.default.cyan("  Review the config file to customize:"));
-    console.log(import_chalk18.default.dim("    \u2022 lang: Voice language (en, es, ar, zh...)"));
-    console.log(import_chalk18.default.dim("    \u2022 video: Resolution, quality, effects"));
-    console.log(import_chalk18.default.dim("    \u2022 music: Background music path and volume"));
-    console.log(import_chalk18.default.dim("    \u2022 output: Output directory"));
+    console.log(import_chalk19.default.cyan("  Review the config file to customize:"));
+    console.log(import_chalk19.default.dim("    \u2022 lang: Voice language (en, es, ar, zh...)"));
+    console.log(import_chalk19.default.dim("    \u2022 video: Resolution, quality, effects"));
+    console.log(import_chalk19.default.dim("    \u2022 music: Background music path and volume"));
+    console.log(import_chalk19.default.dim("    \u2022 output: Output directory"));
     console.log();
     const proceed = await confirm(`${INDENT3}Proceed with default settings?`);
     if (!proceed) {
-      console.log(import_chalk18.default.yellow(`
+      console.log(import_chalk19.default.yellow(`
   Edit ${CONFIG_FILE} and run again.
 `));
       process.exit(0);
@@ -6264,17 +6466,17 @@ async function recordCommand(url, options = {}) {
   }
   if (langOverride) config.lang = langOverride;
   if (config.music?.path) {
-    const musicPath = (0, import_node_path24.isAbsolute)(config.music.path) ? config.music.path : (0, import_node_path24.resolve)(config.output.dir, config.music.path);
-    if (!(0, import_node_fs17.existsSync)(musicPath)) {
+    const musicPath = (0, import_node_path25.isAbsolute)(config.music.path) ? config.music.path : (0, import_node_path25.resolve)(config.output.dir, config.music.path);
+    if (!(0, import_node_fs18.existsSync)(musicPath)) {
       console.log();
-      console.log(import_chalk18.default.yellow(`  \u26A0 Music file not found: ${config.music.path}`));
-      console.log(import_chalk18.default.dim(`    Config: ${(0, import_node_path24.join)(process.cwd(), CONFIG_FILE)}`));
+      console.log(import_chalk19.default.yellow(`  \u26A0 Music file not found: ${config.music.path}`));
+      console.log(import_chalk19.default.dim(`    Config: ${(0, import_node_path25.join)(process.cwd(), CONFIG_FILE)}`));
       console.log();
       const proceed = await confirm(`${INDENT3}Continue without background music?`);
       if (!proceed) {
-        console.log(import_chalk18.default.yellow(`
+        console.log(import_chalk19.default.yellow(`
   Edit music.path in config and run again.`));
-        console.log(import_chalk18.default.dim(`    ${(0, import_node_path24.join)(process.cwd(), CONFIG_FILE)}
+        console.log(import_chalk19.default.dim(`    ${(0, import_node_path25.join)(process.cwd(), CONFIG_FILE)}
 `));
         process.exit(0);
       }
@@ -6284,8 +6486,8 @@ async function recordCommand(url, options = {}) {
   const captions = await loadCaptions();
   const workDir = await prepareWorkDir();
   const targetLang = config.lang || "en";
-  const planPath = (0, import_node_path24.join)(config.output.dir, `plan-${targetLang}.json`);
-  const legacyPlanPath = (0, import_node_path24.join)(config.output.dir, "plan.json");
+  const planPath = (0, import_node_path25.join)(config.output.dir, `plan-${targetLang}.json`);
+  const legacyPlanPath = (0, import_node_path25.join)(config.output.dir, "plan.json");
   const isExtensionUrl = url.startsWith("chrome-extension://");
   await (0, import_promises17.mkdir)(config.output.dir, { recursive: true });
   await setLogFilePath(config.output.dir);
@@ -6298,7 +6500,8 @@ async function recordCommand(url, options = {}) {
       ...description !== void 0 && { description },
       planPath,
       legacyPlanPath,
-      targetLang
+      targetLang,
+      ...fresh !== void 0 && { fresh }
     });
     const validatedPlan = await runValidationPhase({
       plan,
@@ -6323,29 +6526,29 @@ async function recordCommand(url, options = {}) {
       await saveUserData({ localVideoCount: newCount });
       const remaining = FREE_VIDEO_LIMIT - newCount;
       if (remaining > 0) {
-        console.log(import_chalk18.default.dim(`  ${remaining} free video${remaining === 1 ? "" : "s"} remaining`));
+        console.log(import_chalk19.default.dim(`  ${remaining} free video${remaining === 1 ? "" : "s"} remaining`));
       }
     }
     console.log();
-    console.log(import_chalk18.default.bold.green("  \u2713 Done!"));
+    console.log(import_chalk19.default.bold.green("  \u2713 Done!"));
     console.log();
-    console.log(import_chalk18.default.cyan(`  ${formatClickablePath(finalPath)}`));
+    console.log(import_chalk19.default.cyan(`  ${formatClickablePath(finalPath)}`));
     console.log();
     return finalPath;
   } catch (err) {
     await logError("Record Command", err);
     if (rethrow) throw err;
     console.log();
-    console.log(import_chalk18.default.red(`  Error: ${err instanceof Error ? err.message : "Unknown error"}`));
-    console.log(import_chalk18.default.dim(`  See ${logFilePath} for details`));
+    console.log(import_chalk19.default.red(`  Error: ${err instanceof Error ? err.message : "Unknown error"}`));
+    console.log(import_chalk19.default.dim(`  See ${logFilePath} for details`));
     process.exit(1);
   }
 }
 
 // src/commands/script-cmd.ts
 var import_promises18 = require("fs/promises");
-var import_node_path25 = require("path");
-var import_chalk19 = __toESM(require("chalk"));
+var import_node_path26 = require("path");
+var import_chalk20 = __toESM(require("chalk"));
 init_lib();
 async function scriptCommand(url, scriptPath, lang) {
   const { config, workDir, captions } = await initCommandEnv(url, lang);
@@ -6353,7 +6556,7 @@ async function scriptCommand(url, scriptPath, lang) {
   const raw = await (0, import_promises18.readFile)(scriptPath, "utf-8");
   const lines = raw.split("\n").map((l) => l.trim()).filter((l) => l.length > 0 && !l.startsWith("#"));
   if (lines.length === 0) {
-    console.log(import_chalk19.default.red("  Script file is empty or has no non-comment lines"));
+    console.log(import_chalk20.default.red("  Script file is empty or has no non-comment lines"));
     process.exit(1);
   }
   info(`${lines.length} captions from script`);
@@ -6365,7 +6568,7 @@ async function scriptCommand(url, scriptPath, lang) {
   const planTask = task("Mapping script to UI actions");
   const appTitle = new URL(url).hostname.replace(/^www\./, "");
   const plan = await generatePlanFromScript(lines, url, appTitle, elementsText, lang, logError);
-  const planPath = (0, import_node_path25.join)(config.output.dir, `plan-${lang ?? "en"}.json`);
+  const planPath = (0, import_node_path26.join)(config.output.dir, `plan-${lang ?? "en"}.json`);
   await savePlan(plan, planPath);
   planTask.succeed(`${plan.steps.length} steps planned`);
   header("Voiceover");
@@ -6385,8 +6588,8 @@ async function scriptCommand(url, scriptPath, lang) {
   const assPath = await generateASS(plan, stepAudio, workDir, config, captions);
   const finalPath = await composeAndFinish(videoPath, voiceoverPath, assPath, config, "free");
   console.log();
-  console.log(import_chalk19.default.bold.green("  Done!"));
-  console.log(import_chalk19.default.cyan(`  ${finalPath}`));
+  console.log(import_chalk20.default.bold.green("  Done!"));
+  console.log(import_chalk20.default.cyan(`  ${finalPath}`));
 }
 
 // src/qp.ts
@@ -6456,6 +6659,20 @@ function parseArgs(args) {
   if (first === "record") {
     args = args.slice(1);
   }
+  if (first === "edit") {
+    const rest = args.slice(1);
+    let url2;
+    let lang2;
+    for (const arg2 of rest) {
+      if (arg2.startsWith("lang=")) {
+        lang2 = arg2.slice(5);
+      } else if (!arg2.startsWith("-") && !url2 && !arg2.includes("=")) {
+        url2 = normalizeUrl3(arg2);
+      }
+    }
+    if (!url2) return { ...base, command: "help" };
+    return { ...base, command: "edit", url: url2, lang: lang2 };
+  }
   if (first === "capture") {
     const rest = args.slice(1);
     let url2;
@@ -6523,8 +6740,8 @@ async function main() {
       break;
     case "auth":
       if (!parsed.url) {
-        console.log(import_chalk20.default.red("  Missing URL"));
-        console.log(import_chalk20.default.dim("  Run: qp auth <url>"));
+        console.log(import_chalk21.default.red("  Missing URL"));
+        console.log(import_chalk21.default.dim("  Run: qp auth <url>"));
         process.exit(1);
       }
       await authCommand(parsed.url);
@@ -6535,6 +6752,14 @@ async function main() {
     case "auth-list":
       await authListCommand();
       break;
+    case "edit":
+      if (!parsed.url) {
+        console.log(import_chalk21.default.red("  Missing URL"));
+        console.log(import_chalk21.default.dim("  Run: qp edit <url>"));
+        process.exit(1);
+      }
+      await editCommand(parsed.url, parsed.lang);
+      break;
     case "init":
       await initCommand();
       break;
@@ -6543,8 +6768,8 @@ async function main() {
       break;
     case "record":
       if (!parsed.url) {
-        console.log(import_chalk20.default.red("  Missing URL"));
-        console.log(import_chalk20.default.dim("  Run: qp --help"));
+        console.log(import_chalk21.default.red("  Missing URL"));
+        console.log(import_chalk21.default.dim("  Run: qp --help"));
         process.exit(1);
       }
       setAutoYes(parsed.yes);
@@ -6563,8 +6788,8 @@ async function main() {
       break;
     case "capture":
       if (!parsed.url) {
-        console.log(import_chalk20.default.red("  Missing URL"));
-        console.log(import_chalk20.default.dim("  Run: qp --help"));
+        console.log(import_chalk21.default.red("  Missing URL"));
+        console.log(import_chalk21.default.dim("  Run: qp --help"));
         process.exit(1);
       }
       console.log();