@tempo-ai/visual-review 0.0.1 → 0.0.107-staging.2

package/dist/bin.js

@@ -6,11 +6,11 @@ async function main(argv = process.argv.slice(2)) {
   const [command, ...commandArgs] = argv;
   switch (command) {
     case "capture":
-      return await (await import("./cli-3HH2BY7Y.js")).main(commandArgs);
+      return await (await import("./cli-JCGZRFSY.js")).main(commandArgs);
     case "claim":
       return await (await import("./claim-WI2ZVIDS.js")).main(commandArgs);
     case "report":
-      return await (await import("./report-RCKB2CVS.js")).main(commandArgs);
+      return await (await import("./report-RD2OQ5TP.js")).main(commandArgs);
     case "install-browsers":
       return await (await import("./install-browsers-5RCJN3AK.js")).main(commandArgs);
     default:

package/dist/{chunk-HMPQK5ZG.js → chunk-4KKBAMNP.js}

@@ -7,6 +7,13 @@ import {
 import { execFileSync } from "child_process";
 var STICKY_MARKER = "<!-- tempo-visual-review -->";
 var STATUS_CONTEXT = "visual-review";
+function publisherDeliveryFailure(status) {
+  const publishError = status.lastPublishError;
+  if (publishError == null) return null;
+  if (publishError.revision < (status.lastPublish?.revision ?? 0)) return null;
+  if (status.statusPublishing !== false) return null;
+  return publishError;
+}
 function parseArgs(argv) {
   const args = {
     pollTimeoutS: 900,
@@ -34,7 +41,7 @@ function parseArgs(argv) {
   return args;
 }
 function gh(...ghArgs) {
-  return execFileSync("gh", ghArgs, { encoding: "utf-8" });
+  return execFileSync("gh", ghArgs, { encoding: "utf-8", windowsHide: true });
 }
 function postCommitStatus(repo, sha, state, description, targetUrl) {
   gh(
@@ -254,16 +261,15 @@ async function main(argv = process.argv.slice(2)) {
     await new Promise((resolve) => setTimeout(resolve, 5e3));
   }
   const verdict = describeGate(status.gate ?? {}, status.state);
-  const publishError = status.lastPublishError;
-  const publishFailing = publishError !== void 0 && publishError.revision >= (status.lastPublish?.revision ?? 0) && status.statusPublishing === false;
-  if (status.publisherConfigured && !publishFailing) {
+  const publishFailure = publisherDeliveryFailure(status);
+  if (status.publisherConfigured && publishFailure === null) {
     console.log(
       `verdict (${verdict.state}) owned by the Convex publisher \u2014 skipping CI status write`
     );
   } else {
-    if (publishFailing) {
+    if (publishFailure !== null) {
       console.log(
-        `Convex publisher reported a delivery failure (${publishError.error}) \u2014 writing the status from CI as a fallback`
+        `Convex publisher reported a delivery failure (${publishFailure.error}) \u2014 writing the status from CI as a fallback`
       );
     }
     postCommitStatus(
@@ -283,6 +289,7 @@ async function main(argv = process.argv.slice(2)) {
 }
 
 export {
+  publisherDeliveryFailure,
   main
 };
-//# sourceMappingURL=chunk-HMPQK5ZG.js.map
+//# sourceMappingURL=chunk-4KKBAMNP.js.map

package/dist/chunk-4KKBAMNP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/report.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\n\nimport { visualReviewPrDeclaration } from \"./github-actions\";\n\nconst STICKY_MARKER = \"<!-- tempo-visual-review -->\";\nconst STATUS_CONTEXT = \"visual-review\";\n\ntype ReportArgs = {\n  pollTimeoutS: number;\n  bypass: boolean;\n  noVisualChange: boolean;\n  fallbackFailure: boolean;\n  statusUrl?: string;\n  pr?: number;\n  sha?: string;\n};\n\ntype Gate = {\n  satisfied?: boolean;\n  required?: number;\n  approvalsNeeded?: number;\n  rejected?: number;\n  blockingErrors?: number;\n};\n\n/**\n * Shape of the `/visual-review/status` poll. Convex serialises absent\n * optional fields as `null`, not `undefined` — every optional here must be\n * read null-safely.\n */\nexport type ReportStatus = {\n  state?: \"complete\" | \"error\" | string;\n  reportUrl?: string;\n  trackedTotal?: number;\n  counts?: Record<string, number | undefined>;\n  gate?: Gate;\n  topChanged?: Array<{\n    name?: string;\n    storyboardId: string;\n    diffRatio?: number | null;\n    verdict: string;\n    error?: string;\n    baselineHash?: string;\n    candidateHash?: string;\n  }>;\n  blobUrlTemplate?: string;\n  approximateBase?: boolean;\n  freshEpoch?: boolean;\n  publisherConfigured?: boolean;\n  lastPublishError?: { revision: number; error: string } | null;\n  lastPublish?: { revision: number } | null;\n  statusPublishing?: boolean | null;\n};\n\n/**\n * `publisherConfigured` only means the GitHub App env is set GLOBALLY — it\n * does NOT mean the app can post on THIS repo (it may not be installed\n * there, or lack the permission). When the publisher has a TERMINAL\n * outstanding failure for the current revision, CI writes the status itself\n * so the check can't hang pending forever. Terminal means the error is\n * current (revision-compare, mirroring the portal's \"delivery failing\"\n * banner) AND no publish worker holds the singleflight claim\n * (`statusPublishing === false`). A transient failure mid-retry-ladder keeps\n * the claim, so falling back then would race the publisher's own retry and\n * could land a stale snapshot after a newer portal flip.\n *\n * Returns the terminal failure, or `null` when Convex still owns the verdict.\n */\nexport function publisherDeliveryFailure(\n  status: ReportStatus,\n): { revision: number; error: string } | null {\n  const publishError = status.lastPublishError;\n  // A healthy run reports `lastPublishError: null` (0.0.1 compared against\n  // `undefined` only and crashed on `.revision`).\n  if (publishError == null) return null;\n  if (publishError.revision < (status.lastPublish?.revision ?? 0)) return null;\n  if (status.statusPublishing !== false) return null;\n  return publishError;\n}\n\nfunction parseArgs(argv: string[]): ReportArgs {\n  const args: ReportArgs = {\n    pollTimeoutS: 900,\n    bypass: false,\n    noVisualChange: false,\n    fallbackFailure: false,\n  };\n  for (let index = 0; index < argv.length; index += 1) {\n    const flag = argv[index];\n    const next = () => {\n      const value = argv[++index];\n      if (value === undefined) throw new Error(`${flag} needs a value`);\n      return value;\n    };\n    if (flag === \"--status-url\") args.statusUrl = next();\n    else if (flag === \"--pr\") args.pr = Number(next());\n    else if (flag === \"--sha\") args.sha = next();\n    else if (flag === \"--poll-timeout-s\") args.pollTimeoutS = Number(next());\n    else if (flag === \"--bypass\") args.bypass = true;\n    else if (flag === \"--no-visual-change\") args.noVisualChange = true;\n    else if (flag === \"--fallback-failure\") args.fallbackFailure = true;\n    else throw new Error(`unknown flag ${flag}`);\n  }\n  if (!args.sha) throw new Error(\"--sha is required\");\n  return args;\n}\n\nfunction gh(...ghArgs: string[]): string {\n  return execFileSync(\"gh\", ghArgs, { encoding: \"utf-8\", windowsHide: true });\n}\n\nfunction postCommitStatus(\n  repo: string,\n  sha: string,\n  state: \"success\" | \"failure\" | \"pending\",\n  description: string,\n  targetUrl?: string,\n): void {\n  gh(\n    \"api\",\n    `repos/${repo}/statuses/${sha}`,\n    \"-f\",\n    `state=${state}`,\n    \"-f\",\n    `context=${STATUS_CONTEXT}`,\n    \"-f\",\n    `description=${description.slice(0, 140)}`,\n    ...(targetUrl ? [\"-f\", `target_url=${targetUrl}`] : []),\n  );\n}\n\nfunction upsertStickyComment(repo: string, pr: number, body: string): void {\n  const comments = (\n    JSON.parse(\n      gh(\"api\", `repos/${repo}/issues/${pr}/comments`, \"--paginate\", \"--slurp\"),\n    ) as Array<Array<{ id: number; body?: string }>>\n  ).flat();\n  const existing = comments.find(\n    (comment) =>\n      typeof comment.body === \"string\" && comment.body.includes(STICKY_MARKER),\n  );\n  if (existing) {\n    gh(\n      \"api\",\n      \"--method\",\n      \"PATCH\",\n      `repos/${repo}/issues/comments/${existing.id}`,\n      \"-f\",\n      `body=${body}`,\n    );\n  } else {\n    gh(\"api\", `repos/${repo}/issues/${pr}/comments`, \"-f\", `body=${body}`);\n  }\n}\n\nfunction describeGate(\n  gate: Gate,\n  state: ReportStatus[\"state\"],\n): { state: \"success\" | \"failure\" | \"pending\"; description: string } {\n  if (state === \"error\") {\n    return {\n      state: \"failure\",\n      description: \"visual review run failed — see report\",\n    };\n  }\n  if (state !== \"complete\") {\n    return {\n      state: \"pending\",\n      description: \"capturing & comparing storyboards…\",\n    };\n  }\n  if (gate.satisfied) {\n    return {\n      state: \"success\",\n      description:\n        gate.required === 0\n          ? \"no visual changes\"\n          : `${gate.required} visual change${gate.required === 1 ? \"\" : \"s\"} approved`,\n    };\n  }\n  const parts: string[] = [];\n  if ((gate.approvalsNeeded ?? 0) > 0) {\n    parts.push(`${gate.approvalsNeeded} of ${gate.required} need approval`);\n  }\n  if ((gate.rejected ?? 0) > 0) parts.push(`${gate.rejected} rejected`);\n  if ((gate.blockingErrors ?? 0) > 0) {\n    parts.push(\n      `${gate.blockingErrors} render error${gate.blockingErrors === 1 ? \"\" : \"s\"}`,\n    );\n  }\n  return {\n    state: \"failure\",\n    description: `visual review: ${parts.join(\", \")} — see report`,\n  };\n}\n\nfunction buildCommentBody(status: ReportStatus): string {\n  const counts = status.counts ?? {};\n  const gateLine = status.gate?.satisfied\n    ? \"✅ **Check passing** — every visual change is approved.\"\n    : `🔴 **Check failing** — ${status.gate?.approvalsNeeded ?? \"?\"} of ${status.gate?.required ?? \"?\"} storyboards need approval${status.gate?.blockingErrors ? `, ${status.gate.blockingErrors} render error(s)` : \"\"}${status.gate?.rejected ? `, ${status.gate.rejected} rejected` : \"\"}. Approving in the report flips the check instantly — no CI re-run.`;\n  const summary = `| tracked | changed | new | removed | render errors | unchanged |\n| --- | --- | --- | --- | --- | --- |\n| ${status.trackedTotal ?? 0} | ${counts.changed ?? 0} | ${counts.added ?? 0} | ${counts.removed ?? 0} | ${counts.errors ?? 0} | ${counts.unchanged ?? 0} |`;\n\n  const thumbs = (status.topChanged ?? [])\n    .slice(0, 6)\n    .map((board) => {\n      const title = board.name ?? board.storyboardId;\n      const meta =\n        board.diffRatio !== undefined && board.diffRatio !== null\n          ? ` · ${(board.diffRatio * 100).toFixed(2)}%`\n          : \"\";\n      if (board.verdict === \"render-error\") {\n        return `**${title}** — render error${board.error ? `: \\`${board.error.slice(0, 120)}\\`` : \"\"}`;\n      }\n      const cell = (hash: string | undefined, label: string) =>\n        hash && status.blobUrlTemplate\n          ? `<img src=\"${status.blobUrlTemplate}${hash}\" alt=\"${label}\" width=\"360\" />`\n          : \"—\";\n      return `<details><summary><b>${title}</b> — ${board.verdict}${meta}</summary>\n\n| baseline | candidate |\n| --- | --- |\n| ${cell(board.baselineHash, \"baseline\")} | ${cell(board.candidateHash, \"candidate\")} |\n\n</details>`;\n    })\n    .join(\"\\n\");\n\n  const notes: string[] = [];\n  if (status.approximateBase) {\n    notes.push(\n      \"⚠ exact merge-base had no visual run — compared against the nearest captured ancestor.\",\n    );\n  }\n  if (status.freshEpoch) {\n    notes.push(\n      \"ℹ fresh baseline epoch (capture environment changed) — everything reports as new.\",\n    );\n  }\n\n  return `${STICKY_MARKER}\n## 👁 Visual review\n\n${gateLine}\n\n${summary}\n\n${notes.length > 0 ? `${notes.join(\"\\n\")}\\n` : \"\"}${thumbs}\n\n📷 **[Open the visual review report](${status.reportUrl})** — side-by-side, onion-skin and diff views; approve, reject, and comment there.`;\n}\n\nfunction buildNoVisualChangeComment(): string {\n  return `${STICKY_MARKER}\n## 👁 Visual review\n\n✅ **Not applicable — no storyboard changes expected.** Storyboard capture was skipped from the PR declaration.`;\n}\n\nfunction latestContextState(repo: string, sha: string): string | null {\n  const statuses = (\n    JSON.parse(\n      gh(\n        \"api\",\n        `repos/${repo}/commits/${sha}/statuses`,\n        \"--paginate\",\n        \"--slurp\",\n      ),\n    ) as Array<Array<{ context?: string; state?: string }>>\n  ).flat();\n  return (\n    statuses.find((status) => status.context === STATUS_CONTEXT)?.state ?? null\n  );\n}\n\nfunction isPermanentError(error: unknown): boolean {\n  return (\n    error instanceof Error && \"permanent\" in error && error.permanent === true\n  );\n}\n\nexport async function main(argv = process.argv.slice(2)): Promise<number> {\n  const args = parseArgs(argv);\n  const repo = process.env.GITHUB_REPOSITORY;\n  if (!repo) throw new Error(\"GITHUB_REPOSITORY is not set\");\n  const sha = args.sha;\n  if (!sha) throw new Error(\"--sha is required\");\n  const declaration = visualReviewPrDeclaration();\n\n  if (args.bypass || declaration.bypass) {\n    postCommitStatus(\n      repo,\n      sha,\n      \"success\",\n      \"bypassed via visual-review:bypass label\",\n    );\n    console.log(\"bypass label present — posted success and skipped the report\");\n    return 0;\n  }\n\n  if (args.noVisualChange || declaration.noVisualChange) {\n    postCommitStatus(\n      repo,\n      sha,\n      \"success\",\n      \"not applicable — no storyboard changes expected\",\n    );\n    if (args.pr)\n      upsertStickyComment(repo, args.pr, buildNoVisualChangeComment());\n    console.log(\n      \"no-visual-change declaration present — posted success and skipped capture\",\n    );\n    return 0;\n  }\n\n  if (args.fallbackFailure) {\n    const current = latestContextState(repo, sha);\n    if (current === null || current === \"pending\") {\n      postCommitStatus(\n        repo,\n        sha,\n        \"failure\",\n        \"visual review reporting failed — see workflow logs\",\n      );\n      console.log(\n        `reporting fallback: latest state was ${current ?? \"absent\"} — posted failure`,\n      );\n    } else {\n      console.log(\n        `reporting fallback: latest '${STATUS_CONTEXT}' state is '${current}' — leaving it`,\n      );\n    }\n    return 0;\n  }\n\n  const statusUrl = args.statusUrl;\n  if (!statusUrl) throw new Error(\"--status-url is required\");\n  const deadline = Date.now() + args.pollTimeoutS * 1_000;\n  let status: ReportStatus | undefined;\n  for (;;) {\n    try {\n      const response = await fetch(statusUrl);\n      if (response.status === 404) {\n        const error = new Error(\"status poll 404 — wrong report key\");\n        Object.assign(error, { permanent: true });\n        throw error;\n      }\n      if (!response.ok)\n        throw new Error(`status poll failed: ${response.status}`);\n      status = (await response.json()) as ReportStatus;\n    } catch (error) {\n      if (isPermanentError(error)) throw error;\n      console.warn(\n        `transient status poll failure, retrying: ${error instanceof Error ? error.message : error}`,\n      );\n    }\n    if (status && (status.state === \"complete\" || status.state === \"error\")) {\n      break;\n    }\n    if (Date.now() > deadline) {\n      postCommitStatus(\n        repo,\n        sha,\n        \"failure\",\n        \"visual review timed out waiting for compare — see report\",\n        status?.reportUrl,\n      );\n      throw new Error(\"timed out waiting for the run to complete\");\n    }\n    await new Promise((resolve) => setTimeout(resolve, 5_000));\n  }\n\n  const verdict = describeGate(status.gate ?? {}, status.state);\n  const publishFailure = publisherDeliveryFailure(status);\n  if (status.publisherConfigured && publishFailure === null) {\n    console.log(\n      `verdict (${verdict.state}) owned by the Convex publisher — skipping CI status write`,\n    );\n  } else {\n    if (publishFailure !== null) {\n      console.log(\n        `Convex publisher reported a delivery failure (${publishFailure.error}) — writing the status from CI as a fallback`,\n      );\n    }\n    postCommitStatus(\n      repo,\n      sha,\n      verdict.state,\n      verdict.description,\n      status.reportUrl,\n    );\n    console.log(`commit status: ${verdict.state} — ${verdict.description}`);\n  }\n\n  if (args.pr) {\n    upsertStickyComment(repo, args.pr, buildCommentBody(status));\n    console.log(`sticky comment upserted on #${args.pr}`);\n  }\n  return 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-4QAZFBC3.js → chunk-MW6S36CX.js}

@@ -534,6 +534,9 @@ function installRenderProfileInPage() {
   const renderers = /* @__PURE__ */ new Map();
   profileWindow.__REACT_DEVTOOLS_GLOBAL_HOOK__ = {
     supportsFiber: true,
+    // Consumers that also load `modules/iframe-projection` see this window
+    // property through its global `DevToolsHook` augmentation, where
+    // `renderers` is typed by ReactRenderer; this stub only counts them.
     renderers,
     inject(renderer) {
       profile.reactInjectedMs ??= performance.now() - profile.startedAtMs;
@@ -4603,7 +4606,7 @@ async function parcelEventToFileEvent(event, rootInfo) {
 // ../tempo-sdk/package.json
 var package_default = {
   name: "tempo-sdk",
-  version: "0.0.38",
+  version: "0.0.40",
   type: "module",
   description: "Tempo SDK \u2014 Vite, Next.js, and Expo plugins for JSX annotation and shared page/storyboard types",
   repository: {
@@ -8009,7 +8012,7 @@ ${output}` : "";
         this.notifyExitListeners(code, signal, "launcher-finished", false);
         return;
       }
-      this.lastExitCrashed = !this.intentionalStop && (code !== 0 || signal != null) && !isWindowsTeardownExitCode(code);
+      this.lastExitCrashed = !this.intentionalStop && !isWindowsTeardownExitCode(code) && (code !== 0 || signal != null || this.readinessConfirmed);
       if (cleanLauncherExit) {
         this.launcherStopRequired = true;
       }
@@ -8051,11 +8054,17 @@ ${output}` : "";
   onExit(listener) {
     if (this.launcherFinished && !this.terminalExitNotified) {
       this.exitListeners.push(listener);
-      listener(0, null, false, "launcher-finished");
+      listener(0, null, false, "launcher-finished", false);
       return;
     }
     if (this.stopped) {
-      listener(null, null, this.lastExitCrashed, "process-exit");
+      listener(
+        null,
+        null,
+        this.lastExitCrashed,
+        "process-exit",
+        this.intentionalStop
+      );
       return;
     }
     this.exitListeners.push(listener);
@@ -8178,6 +8187,19 @@ Hint: ${current.hint}` : "";
     this.lastExitCrashed = true;
     this.notifyExitListeners(null, null, "probe-death");
   }
+  /**
+   * The supervisor's liveness check found this child gone without an `exit`
+   * event having reached us (a lost SIGCHLD). Deliver the one terminal exit
+   * its consumers are owed, so the adapter and pool release the host instead
+   * of keeping a dead incarnation `running`; an `exit` event that arrives
+   * late is then a no-op (`terminalExitNotified`).
+   */
+  reportObservedChildDeath() {
+    if (this.stopped || this.terminalExitNotified) return;
+    this.stopped = true;
+    this.lastExitCrashed = !this.intentionalStop;
+    this.notifyExitListeners(null, null, "process-exit");
+  }
   /** Whether the most recent exit looked like an unexpected crash. */
   didLastExitCrash() {
     return this.lastExitCrashed;
@@ -8434,7 +8456,13 @@ Hint: ${current.hint}` : "";
     }
     for (const listener of listeners) {
       try {
-        listener(code, signal, this.lastExitCrashed, reason);
+        listener(
+          code,
+          signal,
+          this.lastExitCrashed,
+          reason,
+          this.intentionalStop
+        );
       } catch {
       }
     }
@@ -8811,13 +8839,13 @@ var TempoDevServer = class _TempoDevServer {
     const hintListeners = [];
     const exitListeners = [];
     const attachProcessListeners = (activeProcess) => {
-      activeProcess.onExit((code, signal, crashed, reason) => {
+      activeProcess.onExit((code, signal, crashed, reason, intentional) => {
         if (reason === "launcher-finished") {
           devLog("supervisor:launcher_finished", {
             pid: activeProcess.getPid()
           });
           for (const listener of exitListeners) {
-            listener(code, signal, crashed, reason);
+            listener(code, signal, crashed, reason, intentional);
           }
           return;
         }
@@ -8850,7 +8878,7 @@ var TempoDevServer = class _TempoDevServer {
         this.persistStatus().catch(() => {
         });
         for (const listener of exitListeners) {
-          listener(code, signal, crashed, reason);
+          listener(code, signal, crashed, reason, intentional);
         }
       });
       for (const listener of outputListeners) {
@@ -8911,6 +8939,14 @@ var TempoDevServer = class _TempoDevServer {
       this.devserverLaunchPid = activeProcess.getPid();
       this.devserverLaunchProcessStartedAt = this.devserverLaunchPid ? await readProcessStartedAt(this.devserverLaunchPid) : null;
       attachProcessListeners(activeProcess);
+      try {
+        options?.onProcessSpawned?.();
+      } catch (error) {
+        devLog("supervisor:on_process_spawned_threw", {
+          pid: activeProcess.getPid(),
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
       await this.writeProcessMarker(activeProcess.getPid()).catch(() => {
       });
       if (options?.signal?.aborted) {
@@ -8987,7 +9023,7 @@ var TempoDevServer = class _TempoDevServer {
       onExit(listener) {
         exitListeners.push(listener);
         if (process2.getLivenessSource() === "probe") {
-          listener(0, null, false, "launcher-finished");
+          listener(0, null, false, "launcher-finished", false);
         }
       },
       onOutput(listener) {
@@ -9833,6 +9869,7 @@ var TempoDevServer = class _TempoDevServer {
       this.stopUrlHealthProbe();
       return;
     }
+    this.activeHostProcess?.reportObservedChildDeath();
     this.state.devserverUrl = null;
     this.state.urlUnreachableSince = null;
     this.idleProcessStatus = "exited";
@@ -12199,6 +12236,44 @@ async function readTempoDevserverConfig(tempoConfigPath) {
     tempoHostUrl: config.urls?.tempoHost ?? null
   };
 }
+function projectRootForTempoDir(tempoDir) {
+  const resolved = path14.resolve(tempoDir);
+  return path14.basename(resolved) === "tempo" ? path14.dirname(resolved) : resolved;
+}
+async function resolveCanvasHostLayout(options) {
+  const repoRoot = path14.resolve(options.repoRoot);
+  const candidates = options.tempoDir ? [path14.join(path14.resolve(options.tempoDir), "tempo.config.json")] : [
+    path14.join(repoRoot, "tempo", "tempo.config.json"),
+    path14.join(repoRoot, "tempo.config.json")
+  ];
+  for (const configPath of candidates) {
+    let parsed;
+    try {
+      parsed = JSON.parse(await readFile10(configPath, "utf-8"));
+    } catch {
+      continue;
+    }
+    if (typeof parsed !== "object" || parsed === null || !("scripts" in parsed)) {
+      continue;
+    }
+    const tempoDir2 = path14.dirname(configPath);
+    const paths = parsed.paths;
+    const canvases = typeof paths?.canvases === "string" && paths.canvases.trim().length > 0 ? paths.canvases.trim().split("\\").join("/") : "designs";
+    return {
+      tempoDir: tempoDir2,
+      projectRoot: projectRootForTempoDir(tempoDir2),
+      pagesDir: path14.resolve(tempoDir2, canvases),
+      configPath
+    };
+  }
+  const tempoDir = options.tempoDir ? path14.resolve(options.tempoDir) : path14.join(repoRoot, "tempo");
+  return {
+    tempoDir,
+    projectRoot: projectRootForTempoDir(tempoDir),
+    pagesDir: path14.join(tempoDir, "designs"),
+    configPath: null
+  };
+}
 function resolveTempoDir(options) {
   if (options.tempoConfigPath) return path14.dirname(options.tempoConfigPath);
   if (options.tempoDir) return options.tempoDir;
@@ -12283,7 +12358,7 @@ async function startDevserverSession(options) {
     scripts: config.scripts
   });
   await devServer.initialize();
-  const projectRoot = path14.dirname(tempoDir);
+  const projectRoot = projectRootForTempoDir(tempoDir);
   for (const hostCanvasPath of hostCanvasPaths) {
     await devServer.ensureCanvasRegistered(
       path14.join(projectRoot, hostCanvasPath)
@@ -12359,14 +12434,14 @@ async function startDevserverSession(options) {
 }
 
 // ../canvas-capture-headless/src/enumerate.ts
-import { readFile as readFile11 } from "fs/promises";
+import { access as access4, readFile as readFile11 } from "fs/promises";
 import path15 from "path";
 function toPosixPath2(value) {
   return value.split(path15.sep).join("/");
 }
 async function enumerateCanvasStoryboards(options) {
   const pagesDir = options.pagesDir ?? path15.join(options.tempoDir, "designs");
-  const projectRoot = path15.dirname(options.tempoDir);
+  const projectRoot = projectRootForTempoDir(options.tempoDir);
   const canvasFiles = await scanCanvasFiles(pagesDir);
   const storyboards = [];
   const structuralErrors = [];
@@ -12431,6 +12506,61 @@ async function enumerateCanvasStoryboards(options) {
     vrtConfigErrors
   };
 }
+async function enumerateTrackedStoryboards(options) {
+  try {
+    await access4(options.tempoDir);
+  } catch {
+    return {
+      tracked: [],
+      paused: [],
+      totalStoryboards: 0,
+      totalCanvases: 0,
+      errors: []
+    };
+  }
+  const enumeration = await enumerateCanvasStoryboards(options);
+  const tracked = [];
+  const paused = [];
+  const errors = [
+    ...enumeration.structuralErrors,
+    ...enumeration.vrtConfigErrors
+  ];
+  for (const storyboard of enumeration.storyboards) {
+    if (!storyboard.vrt) continue;
+    const board = {
+      canvasPath: storyboard.canvasPath,
+      hostCanvasPath: storyboard.hostCanvasPath,
+      storyboardId: storyboard.storyboardId,
+      name: storyboard.name,
+      layout: storyboard.layout,
+      threshold: storyboard.vrt.threshold,
+      ignore: storyboard.vrt.ignore
+    };
+    const maskedArea = (storyboard.vrt.ignore ?? []).reduce(
+      (total, region) => total + Math.max(0, Math.min(region.w, board.layout.width)) * Math.max(0, Math.min(region.h, board.layout.height)),
+      0
+    );
+    if (maskedArea >= 0.9 * board.layout.width * board.layout.height) {
+      errors.push({
+        filePath: storyboard.filePath,
+        message: `<Storyboard id="${storyboard.storyboardId}"> vrt.ignore masks \u226590% of the board \u2014 untrack it instead`
+      });
+      continue;
+    }
+    if (storyboard.vrt.skip) {
+      paused.push(board);
+      continue;
+    }
+    tracked.push(board);
+  }
+  return {
+    tracked,
+    paused,
+    totalStoryboards: enumeration.totalStoryboards,
+    totalCanvases: enumeration.totalCanvases,
+    errors
+  };
+}
 
 // ../canvas-capture-headless/src/timing.ts
 function percentile(sortedValues, p) {
@@ -12510,64 +12640,8 @@ var TimingReport = class {
 };
 
 // src/enumerate.ts
-import { access as access4 } from "fs/promises";
-async function enumerateTrackedStoryboards(options) {
-  try {
-    await access4(options.tempoDir);
-  } catch {
-    return {
-      tracked: [],
-      paused: [],
-      totalStoryboards: 0,
-      totalCanvases: 0,
-      errors: []
-    };
-  }
-  const enumeration = await enumerateCanvasStoryboards({
-    tempoDir: options.tempoDir,
-    pagesDir: options.pagesDir
-  });
-  const tracked = [];
-  const paused = [];
-  const errors = [
-    ...enumeration.structuralErrors,
-    ...enumeration.vrtConfigErrors
-  ];
-  for (const storyboard of enumeration.storyboards) {
-    if (!storyboard.vrt) continue;
-    const board = {
-      canvasPath: storyboard.canvasPath,
-      hostCanvasPath: storyboard.hostCanvasPath,
-      storyboardId: storyboard.storyboardId,
-      name: storyboard.name,
-      layout: storyboard.layout,
-      threshold: storyboard.vrt.threshold,
-      ignore: storyboard.vrt.ignore
-    };
-    const maskedArea = (storyboard.vrt.ignore ?? []).reduce(
-      (total, region) => total + Math.max(0, Math.min(region.w, board.layout.width)) * Math.max(0, Math.min(region.h, board.layout.height)),
-      0
-    );
-    if (maskedArea >= 0.9 * board.layout.width * board.layout.height) {
-      errors.push({
-        filePath: storyboard.filePath,
-        message: `<Storyboard id="${storyboard.storyboardId}"> vrt.ignore masks \u226590% of the board \u2014 untrack it instead`
-      });
-      continue;
-    }
-    if (storyboard.vrt.skip) {
-      paused.push(board);
-      continue;
-    }
-    tracked.push(board);
-  }
-  return {
-    tracked,
-    paused,
-    totalStoryboards: enumeration.totalStoryboards,
-    totalCanvases: enumeration.totalCanvases,
-    errors
-  };
+async function enumerateTrackedStoryboards2(options) {
+  return await enumerateTrackedStoryboards(options);
 }
 
 // src/fingerprint.ts
@@ -12790,6 +12864,7 @@ function parseArgs(argv) {
   const args = {
     repoRoot: inferRepoRoot(),
     tempoDir: "",
+    tempoDirExplicit: false,
     // The published CLI is intentionally near-argumentless in Actions. Local
     // capture remains Convex-free unless --upload is explicit.
     upload: process.env.GITHUB_ACTIONS === "true" && inferredTrigger !== "manual",
@@ -12820,6 +12895,7 @@ function parseArgs(argv) {
         break;
       case "--tempo-dir":
         args.tempoDir = path16.resolve(next());
+        args.tempoDirExplicit = true;
         break;
       case "--out":
         args.out = path16.resolve(next());
@@ -13012,6 +13088,12 @@ function startClaimHeartbeat(options) {
     }
   };
 }
+function explicitTempoDirRelative(args) {
+  if (!args.tempoDirExplicit) return void 0;
+  const relative2 = path16.relative(args.repoRoot, args.tempoDir);
+  if (relative2.startsWith("..") || path16.isAbsolute(relative2)) return void 0;
+  return relative2;
+}
 function buildBaselineCaptureArgs(input) {
   const args = [
     "capture",
@@ -13033,6 +13115,12 @@ function buildBaselineCaptureArgs(input) {
   ];
   if (input.url) args.push("--url", input.url);
   if (input.githubRepo) args.push("--github-repo", input.githubRepo);
+  if (input.tempoDirRelative !== void 0) {
+    args.push(
+      "--tempo-dir",
+      path16.join(input.worktreeRoot, input.tempoDirRelative || ".")
+    );
+  }
   if (input.repoKey) args.push("--repo-key", input.repoKey);
   if (input.settleTimeoutMs !== void 0) {
     args.push("--settle-timeout", String(input.settleTimeoutMs));
@@ -13067,7 +13155,8 @@ async function runBaselineCaptureInWorktree(options) {
         url: options.args.url,
         githubRepo: options.args.githubRepo,
         repoKey: options.args.repoKey,
-        settleTimeoutMs: options.args.settleTimeoutMs
+        settleTimeoutMs: options.args.settleTimeoutMs,
+        tempoDirRelative: explicitTempoDirRelative(options.args)
       })
     ];
     await new Promise((resolve2, reject) => {
@@ -13118,10 +13207,15 @@ async function main(argv = process.argv.slice(2)) {
   if (args.trigger === "pr" && baseCandidates.length === 0) {
     throw new Error("--trigger pr requires --base <merge-base sha>");
   }
-  const pagesDir = path16.join(args.tempoDir, "designs");
+  const layout = await resolveCanvasHostLayout({
+    repoRoot: args.repoRoot,
+    tempoDir: args.tempoDirExplicit ? args.tempoDir : void 0
+  });
+  args.tempoDir = layout.tempoDir;
+  const pagesDir = layout.pagesDir;
   const enumeration = await timing.phase(
     "enumerate",
-    () => enumerateTrackedStoryboards({ tempoDir: args.tempoDir, pagesDir })
+    () => enumerateTrackedStoryboards2({ tempoDir: args.tempoDir, pagesDir })
   );
   if (enumeration.errors.length > 0) {
     for (const error of enumeration.errors) {
@@ -13574,13 +13668,14 @@ export {
   percentile,
   summarize,
   TimingReport,
-  enumerateTrackedStoryboards,
+  enumerateTrackedStoryboards2 as enumerateTrackedStoryboards,
   scaleIgnoreRegionsToDevicePx,
   VisualReviewHttpError,
   VisualReviewIngestClient,
   resolveOrClaimBaseline,
+  explicitTempoDirRelative,
   buildBaselineCaptureArgs,
   main,
   VISUAL_REVIEW_OIDC_AUDIENCE
 };
-//# sourceMappingURL=chunk-4QAZFBC3.js.map
+//# sourceMappingURL=chunk-MW6S36CX.js.map