@algolia/wizard 0.75.0 → 0.77.0

package/dist/main.js

@@ -4,9 +4,54 @@
 import { render } from "ink";
 
 // src/ui/App.tsx
-import { Box as Box20, Text as Text21, useApp, useInput as useInput9, useWindowSize as useWindowSize7 } from "ink";
+import { Box as Box21, Text as Text22, useApp as useApp2, useInput as useInput9, useWindowSize as useWindowSize8 } from "ink";
 import Spinner3 from "ink-spinner";
 
+// src/lib/terminalSize.ts
+var MIN_ROWS = 30;
+var MIN_COLUMNS = 100;
+var COMPACT_ROWS = 24;
+var COMPACT_COLUMNS = 80;
+var SIDEBAR_MIN_COLUMNS = 90;
+function isCompactTerminal(columns, rows) {
+  return rows < COMPACT_ROWS || columns < COMPACT_COLUMNS;
+}
+async function requestTerminalSize(stdout = process.stdout, {
+  rows = MIN_ROWS,
+  columns = MIN_COLUMNS,
+  timeoutMs = 150,
+  settleMs = 120
+} = {}) {
+  if (!stdout.isTTY) return;
+  const currentRows = stdout.rows ?? 0;
+  const currentColumns = stdout.columns ?? 0;
+  if (currentRows >= rows && currentColumns >= columns) return;
+  stdout.write(
+    `\x1B[8;${Math.max(currentRows, rows)};${Math.max(currentColumns, columns)}t`
+  );
+  const resized = await waitForResize(stdout, timeoutMs);
+  if (!resized) return;
+  await delay(settleMs);
+  stdout.write("\x1B[2J\x1B[H");
+}
+function waitForResize(stdout, timeoutMs) {
+  return new Promise((resolve6) => {
+    const finish = (didResize) => () => {
+      clearTimeout(timer);
+      stdout.off("resize", onResize);
+      resolve6(didResize);
+    };
+    const onResize = finish(true);
+    const timer = setTimeout(finish(false), timeoutMs);
+    stdout.once("resize", onResize);
+  });
+}
+function delay(ms) {
+  return new Promise((resolve6) => {
+    setTimeout(resolve6, ms);
+  });
+}
+
 // src/core/store.ts
 import { create } from "zustand";
 import { nanoid } from "nanoid";
@@ -48,7 +93,7 @@ function runAlgoliaCli(args, { onOutput, redact } = {}) {
   const store = useWizard.getState();
   const command = mask(args.join(" "), redact);
   const logId = store.logStart("tool", `algolia ${command}`);
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const child = spawn("npx", npxArgs(args), { shell });
     let stdout = "";
     let stderr = "";
@@ -71,7 +116,7 @@ function runAlgoliaCli(args, { onOutput, redact } = {}) {
       splitters.stdout.flush();
       splitters.stderr.flush();
       if (code === 0) {
-        resolve5(stdout);
+        resolve6(stdout);
       } else {
         const failed = stderr.trim();
         let detail = "";
@@ -277,15 +322,15 @@ var useWizard = create((set, get) => ({
   ),
   openLearnMore: () => set({ homeScreen: "learnMore" }),
   backToHome: () => set({ homeScreen: "home" }),
-  waitForStart: () => new Promise((resolve5) => {
+  waitForStart: () => new Promise((resolve6) => {
     if (get().phase !== "idle") {
-      resolve5();
+      resolve6();
       return;
     }
     const unsubscribe = useWizard.subscribe((s) => {
       if (s.phase !== "idle") {
         unsubscribe();
-        resolve5();
+        resolve6();
       }
     });
   }),
@@ -392,11 +437,11 @@ var useWizard = create((set, get) => ({
       (t) => t.id === id ? { ...t, status, durationMs: Date.now() - t.startedAt } : t
     )
   })),
-  requestUserInput: (req) => new Promise((resolve5) => {
+  requestUserInput: (req) => new Promise((resolve6) => {
     set({
       phase: "awaitingInput",
       inputReq: req,
-      _resolve: resolve5,
+      _resolve: resolve6,
       loadingMessage: null
     });
   }),
@@ -2234,6 +2279,7 @@ async function promptForApplication(highlight) {
 }
 async function promptToChangeApplication(currentId) {
   const store = useWizard.getState();
+  store.clearNotices();
   store.setLoadingMessage("Loading applications\u2026");
   try {
     const env = await findEnvApplicationId();
@@ -2260,7 +2306,7 @@ async function ensureApplication(resumeAppId) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.75.0",
+  version: "0.77.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -3314,10 +3360,10 @@ var GIT_ENV_OVERRIDES = [
 function gitSucceeds(root, args) {
   const env = { ...process.env };
   for (const key of GIT_ENV_OVERRIDES) delete env[key];
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     execFile("git", ["-C", root, ...args], { env }, (err) => {
-      if (!err) return resolve5(true);
-      resolve5(
+      if (!err) return resolve6(true);
+      resolve6(
         err.code === 1 ? false : void 0
       );
     });
@@ -3603,7 +3649,7 @@ import { tool as tool8 } from "ai";
 import z15 from "zod";
 import { createHash as createHash2 } from "node:crypto";
 import { readFile as readFile8, stat as stat2 } from "node:fs/promises";
-import { relative as relative4 } from "node:path";
+import { basename as basename2, relative as relative4, resolve as resolve3 } from "node:path";
 
 // src/lib/tools/utils/prompt.ts
 var chain = Promise.resolve();
@@ -3623,11 +3669,92 @@ async function fileDigest(filePath) {
 function grantReviewedCommandApproval(ctx, approval) {
   reviewedCommandApprovals.set(ctx, approval);
 }
+function scriptOperandTokens(command) {
+  const tokens = [];
+  let token = "";
+  let quote = null;
+  let escaped = false;
+  let comment = false;
+  let skipNext = false;
+  let stop = false;
+  const windowsPaths = process.platform === "win32";
+  const finishToken = () => {
+    if (token) {
+      if (!stop) {
+        if (skipNext) skipNext = false;
+        else tokens.push(token);
+      }
+    }
+    token = "";
+  };
+  for (const character of command) {
+    if (stop) break;
+    if (comment) {
+      if (character === "\n") comment = false;
+      continue;
+    }
+    if (escaped) {
+      token += character;
+      escaped = false;
+      continue;
+    }
+    if (quote) {
+      if (character === quote) quote = null;
+      else if (quote === '"' && character === "\\") escaped = true;
+      else token += character;
+      continue;
+    }
+    if (character === "\\") {
+      if (windowsPaths) token += character;
+      else escaped = true;
+    } else if (character === '"' || character === "'") {
+      quote = character;
+    } else if (character === "#" && token === "") {
+      comment = true;
+    } else if (character === ">" || character === "<") {
+      finishToken();
+      skipNext = true;
+    } else if (character === "|" || character === "&" || character === ";") {
+      finishToken();
+      stop = true;
+    } else if (/\s/.test(character) || "()".includes(character)) {
+      finishToken();
+    } else {
+      token += character;
+    }
+  }
+  finishToken();
+  return tokens;
+}
+function tokenResolvesToScript(cwd, token, scriptPath) {
+  if (resolve3(cwd, token) === scriptPath) return true;
+  if (!token.includes("\\")) return false;
+  return resolve3(cwd, token.replaceAll("\\", "/")) === scriptPath;
+}
+function commandReferencesScript(command, scriptPath, cwd) {
+  return scriptOperandTokens(command).some(
+    (token) => tokenResolvesToScript(cwd, token, scriptPath)
+  );
+}
 function getReviewedCommandApproval(ctx, command, cwd) {
   const approval = reviewedCommandApprovals.get(ctx);
   if (approval?.command !== command || approval.cwd !== cwd) return void 0;
   return approval;
 }
+function commandDiffersFromReviewedScript(ctx, command, cwd) {
+  const approval = reviewedCommandApprovals.get(ctx);
+  if (approval === void 0) return false;
+  if (approval.command === command && approval.cwd === cwd) return false;
+  if (approval.command === command) return true;
+  const scriptReferences = [
+    basename2(approval.filePath),
+    relative4(ctx.root, approval.filePath),
+    ".algolia-wizard"
+  ];
+  return scriptReferences.some(
+    (reference) => reference !== "" && command.includes(reference)
+  );
+}
 function clearReviewedCommandApproval(ctx) {
   reviewedCommandApprovals.delete(ctx);
 }
@@ -3682,6 +3809,14 @@ function reviewScriptTool(ctx) {
         if (!isFile) {
           return `Refused: ${filePath} is not a file. Write the script first, then review the path you wrote.`;
         }
+        const relativeScriptPath = relative4(resolvedCwd.target, resolved2.target);
+        if (!commandReferencesScript(
+          command,
+          resolved2.target,
+          resolvedCwd.target
+        )) {
+          return `Refused: the command does not reference the reviewed script from its cwd. Use "${relativeScriptPath}" as the script path, then call reviewScript again.`;
+        }
         const reviewedDigest = await fileDigest(resolved2.target).catch(
           () => null
         );
@@ -3773,7 +3908,7 @@ var SIGKILL_DELAY_MS = 5e3;
 function runShell(command, opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_SHELL_TIMEOUT_MS;
   const startedAt = Date.now();
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let output = "";
     let timedOut = false;
     let settled = false;
@@ -3788,7 +3923,7 @@ function runShell(command, opts) {
       settled = true;
       clearTimeout(timer);
       clearTimeout(killTimer);
-      resolve5({
+      resolve6({
         exitCode,
         output: truncateText(output.trim()),
         timedOut,
@@ -4071,6 +4206,7 @@ async function classifyCommandSafety(createModel, command, cwd, explanation, app
       prompt: [
         "A coding agent wants to run this shell command in a user's project without asking for approval first. The command may be in any programming language or ecosystem.",
         "Judge it SAFE only if it cannot modify, delete, move, rename, or install anything the project cares about, cannot push/publish/deploy/commit anything, and cannot make a network request that changes remote state.",
+        "Never judge a command SAFE if it runs, imports, requires, or otherwise references an ingestion script or any path under `.algolia-wizard/`. This rule includes shell wrappers, inline code, variable indirection, and dry-run or check descriptions. Such a command always requires explicit user approval.",
         "Three broad categories are safe, and most commands you will see fall into one of them:",
         "(1) Reporting or listing existing state, with no side effect \u2014 e.g. `git status`, `npm ls`, `npm outdated`, `pip show`, `pip freeze`, `cargo tree`, `docker ps`, `docker images`, `kubectl get pods`, `terraform state list`. This includes a read-only GET-style query to a remote registry or API that only fetches public metadata and changes nothing remote (e.g. `npm view <package>`, `pip index versions <package>`, `curl` with no -X/--request other than GET and no -d/--data) \u2014 safe because nothing changes, not because it stays local.",
         '(2) A "preview" or "check" mode that reports what a change WOULD do, or reports a problem, without making the change. This is a general pattern, not a fixed list \u2014 ANY command that takes a dry-run/check/plan/validate/diff/list-only flag is safe when that flag is present, regardless of whether the same flag would normally appear on a "safe" kind of command: `terraform plan`, `terraform validate`, `terraform fmt -check`, `black --check`, `prettier --check`, `isort --check`, `gofmt -l` (list-only), `stylelint` with no `--fix`, and equally `git push --dry-run`, `npm publish --dry-run`, `kubectl apply --dry-run=client` \u2014 these last three are otherwise-unsafe operations (push, publish, cluster changes) that the dry-run flag turns into a report. The corresponding command WITHOUT that flag (e.g. `terraform apply`, `black .`, `gofmt -w`, `git push`) is a different, unsafe command \u2014 the flag is what makes the difference, for any tool, not just the ones named here. This cuts both ways, so do not assume a bare invocation is the safe one: `cargo fmt`, `black`, `prettier`, `isort`, `rustfmt`, and `terraform fmt` all REWRITE FILES by default and need an explicit check/diff/dry-run flag to become safe, while `gofmt`, `eslint`, `stylelint`, `rubocop`, and `ruff check` default to a safe check-only mode and need an explicit fix/write flag to become unsafe \u2014 the same-looking bare command is safe for one group and unsafe for the other, so judge each by what its own flags actually say, not by resemblance to a tool you already judged.',
@@ -4198,6 +4334,9 @@ function runShellTool(ctx, createModel = defaultCreateModel) {
         () => runReviewedCommand(ctx, command, resolved2.target)
       );
       if (reviewed !== void 0) return reviewed;
+      if (commandDiffersFromReviewedScript(ctx, command, resolved2.target)) {
+        return "Refused: this ingestion command differs from the reviewed command. Call reviewScript with this exact command and cwd before runShell.";
+      }
       const fast = fastPathSafety(command);
       let isSafe = fast;
       let usedStoredApproval = false;
@@ -5209,15 +5348,15 @@ ${formatCompletedSteps(ctx.completedSteps)}`,
 // src/actions/implement.ts
 import z28 from "zod";
 import { access, mkdir as mkdir5, readFile as readFile9 } from "node:fs/promises";
-import { dirname as dirname5, isAbsolute as isAbsolute3, join as join11, relative as relative6, resolve as resolve4, sep as sep2 } from "node:path";
+import { dirname as dirname5, isAbsolute as isAbsolute3, join as join11, relative as relative6, resolve as resolve5, sep as sep2 } from "node:path";
 
 // src/lib/git.ts
 import { execFile as execFile2 } from "node:child_process";
 import { copyFile, mkdir as mkdir4, stat as stat3 } from "node:fs/promises";
-import { basename as basename2, dirname as dirname3, isAbsolute as isAbsolute2, join as join9, resolve as resolve3 } from "node:path";
+import { basename as basename3, dirname as dirname3, isAbsolute as isAbsolute2, join as join9, resolve as resolve4 } from "node:path";
 var MAX_BUFFER = 32 * 1024 * 1024;
 function git(args) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     execFile2("git", args, { maxBuffer: MAX_BUFFER }, (err, stdout, stderr) => {
       if (err)
         return reject(
@@ -5225,7 +5364,7 @@ function git(args) {
             `git ${args.join(" ")} failed: ${stderr.toString().trim() || err.message}`
           )
         );
-      resolve5(stdout.toString());
+      resolve6(stdout.toString());
     });
   });
 }
@@ -5243,7 +5382,7 @@ async function copyUploadIntoProject(repoRoot, ingestDir, sourcePath) {
   if (!trimmed) {
     return { ok: false, reason: "no file path was provided" };
   }
-  const source = isAbsolute2(trimmed) ? trimmed : resolve3(repoRoot, trimmed);
+  const source = isAbsolute2(trimmed) ? trimmed : resolve4(repoRoot, trimmed);
   try {
     if (!(await stat3(source)).isFile()) {
       return { ok: false, reason: `"${sourcePath}" is not a file` };
@@ -5251,9 +5390,9 @@ async function copyUploadIntoProject(repoRoot, ingestDir, sourcePath) {
   } catch {
     return { ok: false, reason: `"${sourcePath}" does not exist` };
   }
-  const relPath = join9(ingestDir, basename2(source));
+  const relPath = join9(ingestDir, basename3(source));
   const dest = join9(repoRoot, relPath);
-  if (resolve3(source) === resolve3(dest)) {
+  if (resolve4(source) === resolve4(dest)) {
     return { ok: true, relPath };
   }
   try {
@@ -5477,8 +5616,16 @@ function ingestionInstructions(input) {
       ...algoliaClientDoc(input),
       "Install the Algolia client with the project's own package manager via runShell, declaring it in whatever manifest the project uses (e.g. package.json, requirements.txt, Gemfile, go.mod, composer.json) so the dependency is not just installed ad hoc.",
       `If the script loads its env vars from a file (e.g. via dotenv or an equivalent for its language) rather than the process environment directly, decide that up front and call writeCredentials on that file before you finish the script \u2014 do not wait to discover the need for it by having a writeFile call refused.`,
-      `When the script is finished, decide the exact command and cwd you will use to run it, then call reviewScript with that filePath, command, cwd, the exact selected entityName, and usesGeneratedRecords set to ${input.ingestionSource === "generated"}. Wait for the developer to review it because running it writes records to a live index. Do not run it before that call returns.`,
+      "Before reviewScript, only use a non-executing parse check such as `node --check <script>` or `python -m py_compile <script>`. Never import, require, run, or dry-run the ingestion script before reviewScript returns.",
+      "Check installed dependency presence at the manifest level, such as `npm ls <package>` or `pip show <package>`. Do not load the ingestion script to resolve dependencies.",
+      ...isJsProject(input.language) ? [
+        "For Node.js, module resolution starts from the script path, not the cwd."
+      ] : [],
+      `When the script is finished, decide the exact command and cwd you will use to run it. Make sure that the script path in the command resolves from that cwd to the filePath. Then call reviewScript with that filePath, command, cwd, the exact selected entityName, and usesGeneratedRecords set to ${input.ingestionSource === "generated"}. Wait for the developer to review it because running it writes records to a live index. Do not run it before that call returns. If you change the command or cwd after a failed run, call reviewScript again before runShell.`,
       'Then, without changing directories, run the script yourself via runShell using the exact same command and cwd. Report the command you ran as "ingestCommand" so the developer can re-run it. Its explanation must say that running it writes records to Algolia.',
+      "If external data access fails, do not run authentication commands, change accounts or machine configuration, or start proxies, containers, or services.",
+      "Do not troubleshoot unavailable external infrastructure. Preserve the script and command, report success, and let the developer prepare the data source.",
+      "If the script cannot access an external data source because credentials or a service are unavailable, do not report status=fail. Report status=success with the completed script, ingestCommand, and a concise failure summary. The wizard handles this run failure and tells the developer how to retry.",
       "The summary should be extremely concise.",
       ...sourceSpecificInstructions(input)
     ] : []
@@ -5630,15 +5777,30 @@ function parseIngestRecordCount(output) {
   const count = Number(match[1]);
   return Number.isFinite(count) ? count : void 0;
 }
-function ingestOutcome(executions, ingestCommand) {
+function relativeIngestCwd(execution, repoRoot) {
+  const cwd = relative6(repoRoot, execution.cwd);
+  return cwd && cwd !== "." ? cwd : ".";
+}
+function reportedCommandWithCwdNote(execution, repoRoot) {
+  const cwd = relativeIngestCwd(execution, repoRoot);
+  return cwd === "." ? execution.command : `${execution.command} (run from ${cwd})`;
+}
+function ingestOutcome(executions, repoRoot, ingestCommand) {
   const newestFirst = [...executions].reverse();
+  const matchesReportedCommand = (execution) => {
+    if (execution.command === ingestCommand) return true;
+    if (!ingestCommand) return false;
+    return ingestCommand === reportedCommandWithCwdNote(execution, repoRoot);
+  };
   const withCount = newestFirst.filter(
     (e) => parseIngestRecordCount(e.output ?? "") != null
   );
-  const succeeded = newestFirst.filter((e) => e.approved && e.exitCode === 0);
+  const succeeded = newestFirst.filter(
+    (e) => e.approved && e.exitCode === 0 && !e.timedOut
+  );
   return {
-    run: succeeded.find((e) => e.command === ingestCommand) ?? succeeded.find((e) => withCount.includes(e)),
-    attempt: ingestCommand ? newestFirst.find((e) => e.command === ingestCommand) : void 0,
+    run: succeeded.find(matchesReportedCommand) ?? succeeded.find((e) => withCount.includes(e)),
+    attempt: ingestCommand ? newestFirst.find(matchesReportedCommand) : void 0,
     recordCount: parseIngestRecordCount(withCount[0]?.output ?? "")
   };
 }
@@ -5732,7 +5894,7 @@ async function pathExists(path) {
 async function frontendHasPackageJson(repoRoot, searchLocation) {
   let directory = repoRoot;
   if (searchLocation) {
-    const candidate = dirname5(resolve4(repoRoot, searchLocation));
+    const candidate = dirname5(resolve5(repoRoot, searchLocation));
     const candidateRelative = relative6(repoRoot, candidate);
     const outsideRoot = candidateRelative === ".." || candidateRelative.startsWith(`..${sep2}`) || isAbsolute3(candidateRelative);
     if (!outsideRoot) directory = candidate;
@@ -5985,7 +6147,12 @@ async function implement(ctx, useCases = DEFAULT_IMPLEMENT_USE_CASES) {
       run: ingestRun,
       attempt: ingestAttempt,
       recordCount
-    } = ingestOutcome(executions, ingestCommand);
+    } = ingestOutcome(executions, repoRoot, ingestCommand);
+    let ingestCwd = ".";
+    if (ingestAttempt) {
+      ingestCommand = ingestAttempt.command;
+      ingestCwd = relativeIngestCwd(ingestAttempt, repoRoot);
+    }
     ingestScriptRan = ingestRun != null;
     ingestRecordCount = recordCount;
     ingestDurationMs = ingestRun?.durationMs;
@@ -6061,7 +6228,10 @@ ${detail}` : ""}`
         ]
       });
     } else {
-      const commandMessages = ingestCommand ? [`Ingestion command: ${ingestCommand}`] : [];
+      const commandMessages = ingestCommand ? [
+        `Ingestion command: ${ingestCommand}`,
+        ...ingestCwd !== "." ? [`Working directory: ${ingestCwd}`] : []
+      ] : [];
       await ctx.requestUserInput({
         prompt: "",
         promptType: "enterToContinue",
@@ -6314,6 +6484,9 @@ var defaultWorkflow = {
   ]
 };
 
+// src/workflows/playbook.ts
+import "zod";
+
 // src/actions/playbookSteps/selectPlaybook.ts
 import { z as z32 } from "zod";
 
@@ -6333,6 +6506,16 @@ var DashboardApiError = class extends Error {
     return isRecord(this.body) ? this.body : void 0;
   }
 };
+async function retryOnDashboardError(call, recover) {
+  for (; ; ) {
+    try {
+      return await call();
+    } catch (err) {
+      if (!(err instanceof DashboardApiError)) throw err;
+      await recover(err);
+    }
+  }
+}
 function isRecord(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -6435,6 +6618,21 @@ async function getPlaybooks() {
   );
   return data;
 }
+async function createPlaybookExecution(appId, slug, indexName, options) {
+  const { data } = await dashboardRequest(
+    `/api/1/playbook-integrations/applications/${appId}/playbooks/${slug}/executions`,
+    playbookExecutionCreateResponseSchema,
+    {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        index_name: indexName,
+        force_new: options?.forceNew ?? false
+      })
+    }
+  );
+  return data;
+}
 async function createSampleIndex(appId, playbookSlug) {
   const { data } = await dashboardRequest(
     `/api/1/playbook-integrations/applications/${appId}/playbooks/${playbookSlug}/sample_index`,
@@ -6443,6 +6641,20 @@ async function createSampleIndex(appId, playbookSlug) {
   );
   return data;
 }
+async function getPlaybookExecution(uuid) {
+  const { data } = await dashboardRequest(
+    `/api/1/playbook-integrations/playbooks/executions/${uuid}`,
+    playbookExecutionSchema
+  );
+  return data;
+}
+async function assessPlaybookExecution(uuid) {
+  await dashboardRequest(
+    `/api/1/playbook-integrations/playbooks/executions/${uuid}/assess`,
+    messageResponseSchema,
+    { method: "POST" }
+  );
+}
 
 // src/actions/playbookSteps/selectPlaybook.ts
 var selectPlaybookSchema = z32.object({
@@ -6477,45 +6689,15 @@ async function selectPlaybookStep(ctx, requestedSlug) {
   return persistSlug(ctx, selection);
 }
 
-// src/actions/playbookSteps/confirmPlaybook.ts
-import { z as z33 } from "zod";
-var confirmPlaybookSchema = z33.void();
-var CONTINUE_OPTION = "Looks good, continue";
-var GO_BACK_OPTION = "Go back";
-var SELECT_APP_OPTION = "Select app";
-async function confirmPlaybookStep(ctx) {
-  const { slug } = ctx.getStepOutput("select-playbook");
-  for (; ; ) {
-    const selection = await ctx.requestUserInput({
-      prompt: "Ready to continue?",
-      promptType: "multipleChoice",
-      options: [CONTINUE_OPTION, GO_BACK_OPTION, SELECT_APP_OPTION],
-      messages: [`Playbook: ${slug}`, `Application: ${ctx.appId}`],
-      helpText: "Going back re-opens the playbook catalogue. Select app opens the application catalogue \u2014 keep the current app to stay here, or pick another to restart the wizard."
-    });
-    if (typeof selection !== "string") {
-      throw new Error("confirm-playbook received an unexpected result");
-    }
-    if (selection === SELECT_APP_OPTION) {
-      await ctx.changeApplication();
-      continue;
-    }
-    if (selection === GO_BACK_OPTION) {
-      return ctx.returnToStep("select-playbook");
-    }
-    return;
-  }
-}
-
 // src/actions/playbookSteps/selectIndex.ts
-import { z as z34 } from "zod";
-var selectIndexSchema = z34.object({
-  indexName: z34.string(),
-  sampleIndex: z34.boolean()
+import { z as z33 } from "zod";
+var selectIndexSchema = z33.object({
+  indexName: z33.string(),
+  sampleIndex: z33.boolean()
 });
 var CREATE_SAMPLE_INDEX = "Create a sample index";
-var GO_BACK_OPTION2 = "Go back to playbook selection";
-var SELECT_APP_OPTION2 = "Select app";
+var GO_BACK_OPTION = "Go back to playbook selection";
+var SELECT_APP_OPTION = "Select app";
 var MIN_ENTRIES_FOR_SELECTION = 1;
 function formatIndexOption(index) {
   if (index.entries < MIN_ENTRIES_FOR_SELECTION) {
@@ -6541,8 +6723,8 @@ async function selectIndexStep2(ctx) {
   const options = [
     ...indexOptions,
     CREATE_SAMPLE_INDEX,
-    GO_BACK_OPTION2,
-    SELECT_APP_OPTION2
+    GO_BACK_OPTION,
+    SELECT_APP_OPTION
   ];
   const disabled = hasIndices ? [
     ...indices.map((idx) => !isIndexSelectable(idx)),
@@ -6571,11 +6753,11 @@ you can explore or switch to another application`;
         "selectIndex received an unexpected non-text result"
       );
     }
-    if (selection === GO_BACK_OPTION2) {
+    if (selection === GO_BACK_OPTION) {
       ctx.setUserInput("fetchedIndices", void 0);
       return ctx.returnToStep("select-playbook");
     }
-    if (selection === SELECT_APP_OPTION2) {
+    if (selection === SELECT_APP_OPTION) {
       await ctx.changeApplication();
       continue;
     }
@@ -6604,8 +6786,8 @@ you can explore or switch to another application`;
 // src/actions/playbookSteps/confirmIndex.ts
 import "zod";
 var confirmIndexSchema = playbookExecutionSchema.nullable();
-var CONTINUE_OPTION2 = "Looks good, continue";
-var GO_BACK_OPTION3 = "Go back";
+var CONTINUE_OPTION = "Looks good, continue";
+var GO_BACK_OPTION2 = "Go back";
 async function confirmIndexStep(ctx) {
   const { sampleIndex } = ctx.getStepOutput("select-index");
   if (!sampleIndex) {
@@ -6615,7 +6797,7 @@ async function confirmIndexStep(ctx) {
   const selection = await ctx.requestUserInput({
     prompt: "Ready to create sample index?",
     promptType: "multipleChoice",
-    options: [CONTINUE_OPTION2, GO_BACK_OPTION3],
+    options: [CONTINUE_OPTION, GO_BACK_OPTION2],
     messages: [
       `A new index called "algolia_playbooks_${slug}_sample_index" will be created with sample ${slug} data.`
     ],
@@ -6624,7 +6806,7 @@ async function confirmIndexStep(ctx) {
   if (typeof selection !== "string") {
     throw new Error("confirm-index received an unexpected result");
   }
-  if (selection === GO_BACK_OPTION3) {
+  if (selection === GO_BACK_OPTION2) {
     return ctx.returnToStep("select-index");
   }
   ctx.notify({
@@ -6654,6 +6836,227 @@ async function confirmIndexStep(ctx) {
   }
 }
 
+// src/actions/playbookSteps/dataAssessment.ts
+var CONTINUE_EXECUTION_OPTION = "Continue";
+var RESTART_OPTION = "Restart";
+var GO_BACK_OPTION3 = "Go back";
+var SWITCH_APPLICATION_OPTION = "Switch application";
+var SWITCH_INDEX_OPTION = "Switch index";
+var RETRY_OPTION = "Retry";
+var POLL_INTERVAL_MS = 5e3;
+var POLL_TIMEOUT_MS = 6e4;
+var ASSESSING_NOTICE_HOLD_MS = 2e4;
+var CREATING_EXECUTION_NOTICE = "creating playbook execution\u2026";
+var POLL_NOTICES = [
+  { message: "created playbook execution", holdMs: POLL_INTERVAL_MS },
+  { message: "sampled records", holdMs: POLL_INTERVAL_MS },
+  {
+    message: "assessing schema and readiness \u2014 this usually takes ~20s for indices under 1M records.",
+    holdMs: ASSESSING_NOTICE_HOLD_MS
+  },
+  { message: "detecting required fields\u2026" }
+];
+async function dataAssessmentStep(ctx) {
+  const { slug } = ctx.getStepOutput("select-playbook");
+  const { indexName, existingExecution } = indexForAssessment(ctx);
+  if (existingExecution) return existingExecution;
+  try {
+    showNotice(ctx, CREATING_EXECUTION_NOTICE);
+    const { id: appId } = await requireApplication();
+    const execution = await resolveExecution(ctx, appId, slug, indexName);
+    return await runAssessment(ctx, execution, indexName);
+  } finally {
+    ctx.clearNotices();
+  }
+}
+function indexForAssessment(ctx) {
+  const selected = ctx.getStepOutput("select-index");
+  if (!selected.sampleIndex) {
+    return { indexName: selected.indexName, existingExecution: null };
+  }
+  const created = ctx.getStepOutput("confirm-index");
+  if (!created) {
+    throw new Error(
+      "data-assessment expected confirm-index to create a sample index"
+    );
+  }
+  return {
+    indexName: created.source_index_name,
+    existingExecution: created
+  };
+}
+function showNotice(ctx, message) {
+  ctx.clearNotices();
+  ctx.notify({ messages: [message] });
+}
+function startPollNotices(ctx) {
+  let index = 0;
+  let timer;
+  const showCurrent = () => {
+    const notice = POLL_NOTICES[index];
+    showNotice(ctx, notice.message);
+    if (notice.holdMs == null) return;
+    timer = setTimeout(() => {
+      index += 1;
+      showCurrent();
+    }, notice.holdMs);
+  };
+  showCurrent();
+  return () => clearTimeout(timer);
+}
+async function runAssessment(ctx, execution, indexName) {
+  if (execution.step_status === "done") {
+    return execution;
+  }
+  if (execution.step_status === "not_started" || execution.step_status === "error") {
+    await assessExecution(ctx, execution.uuid, indexName);
+  } else if (execution.step_status !== "in_progress") {
+    throw unexpectedAssessmentStatus(execution.step_status);
+  }
+  for (; ; ) {
+    const assessed = await pollUntilAssessed(ctx, execution.uuid, indexName);
+    if (assessed.step_status === "done") {
+      return assessed;
+    }
+    if (assessed.step_status !== "error") {
+      throw unexpectedAssessmentStatus(assessed.step_status);
+    }
+    await promptAssessmentRecovery(
+      ctx,
+      assessmentFailureMessage(assessed),
+      assessed.status_reason === "index_empty"
+    );
+    await assessExecution(ctx, execution.uuid, indexName);
+  }
+}
+function unexpectedAssessmentStatus(status) {
+  return new Error(
+    `data-assessment received an unexpected assessment status: ${status}`
+  );
+}
+async function resolveExecution(ctx, appId, slug, indexName) {
+  const created = await createWithRecovery(ctx, appId, slug, indexName);
+  if (!created.resumed) return created;
+  const choice = await ctx.requestUserInput({
+    prompt: `${indexName} has a playbook in progress.`,
+    promptType: "multipleChoice",
+    options: [CONTINUE_EXECUTION_OPTION, RESTART_OPTION, GO_BACK_OPTION3],
+    secondary: [{ kind: "text", value: "resume Assessment" }]
+  });
+  if (choice === CONTINUE_EXECUTION_OPTION) return created;
+  if (choice === RESTART_OPTION) {
+    return createWithRecovery(ctx, appId, slug, indexName, { forceNew: true });
+  }
+  if (choice === GO_BACK_OPTION3) {
+    return ctx.returnToStep("select-index");
+  }
+  throw new Error("data-assessment received an unexpected execution choice");
+}
+async function createWithRecovery(ctx, appId, slug, indexName, options) {
+  return retryOnDashboardError(
+    () => {
+      showNotice(ctx, CREATING_EXECUTION_NOTICE);
+      return createPlaybookExecution(appId, slug, indexName, options);
+    },
+    onRequestFailure(ctx, indexName)
+  );
+}
+function onRequestFailure(ctx, indexName) {
+  return async (err) => {
+    await promptAssessmentRecovery(
+      ctx,
+      requestFailureMessage(indexName, err),
+      isEmptyIndexError(err)
+    );
+  };
+}
+function requestFailureMessage(indexName, err) {
+  if (isEmptyIndexError(err)) {
+    return `Index "${indexName}" has no records to assess.`;
+  }
+  const message = err.errorBody()?.message;
+  if (typeof message === "string" && message.trim()) return message;
+  return "Couldn't complete the request.";
+}
+function isEmptyIndexError(err) {
+  const body = err.errorBody();
+  return body?.status_reason === "index_empty" || body?.message === "index_empty";
+}
+async function pollUntilAssessed(ctx, uuid, indexName) {
+  const logId = ctx.logStart("Assessing index data");
+  const deadline = Date.now() + POLL_TIMEOUT_MS;
+  let logStatus = "error";
+  let stopNotices = startPollNotices(ctx);
+  try {
+    for (; ; ) {
+      const execution = await retryOnDashboardError(
+        () => getPlaybookExecution(uuid),
+        async (err) => {
+          stopNotices();
+          ctx.clearNotices();
+          await promptAssessmentRecovery(
+            ctx,
+            requestFailureMessage(indexName, err),
+            isEmptyIndexError(err)
+          );
+          stopNotices = startPollNotices(ctx);
+        }
+      );
+      if (execution.step_status === "done") {
+        logStatus = "success";
+        return execution;
+      }
+      if (execution.step_status === "error") {
+        ctx.clearNotices();
+        return execution;
+      }
+      if (Date.now() >= deadline) {
+        throw new Error("Timed out waiting for the data assessment to finish.");
+      }
+      await sleep(POLL_INTERVAL_MS);
+    }
+  } catch (err) {
+    ctx.clearNotices();
+    throw err;
+  } finally {
+    stopNotices();
+    ctx.logEnd(logId, logStatus);
+  }
+}
+var sleep = (ms) => new Promise((resolve6) => setTimeout(resolve6, ms));
+async function assessExecution(ctx, uuid, indexName) {
+  await retryOnDashboardError(
+    () => assessPlaybookExecution(uuid),
+    onRequestFailure(ctx, indexName)
+  );
+}
+async function promptAssessmentRecovery(ctx, message, retryDisabled) {
+  const choice = await ctx.requestUserInput({
+    prompt: "Data assessment failed.",
+    promptType: "multipleChoice",
+    options: [SWITCH_APPLICATION_OPTION, SWITCH_INDEX_OPTION, RETRY_OPTION],
+    messages: [message],
+    disabled: [false, false, retryDisabled],
+    helpText: "Retry re-runs assessment on this index. Switch index or application to pick a different target."
+  });
+  if (choice === SWITCH_APPLICATION_OPTION) {
+    return ctx.changeApplication();
+  }
+  if (choice === SWITCH_INDEX_OPTION) {
+    return ctx.returnToStep("select-index");
+  }
+  if (choice === RETRY_OPTION) {
+    return;
+  }
+  throw new Error("data-assessment received an unexpected recovery choice");
+}
+function assessmentFailureMessage(execution) {
+  if (execution.status_reason === "index_empty") {
+    return `Index "${execution.source_index_name}" has no records to assess.`;
+  }
+  return execution.status_reason ?? "Data assessment failed.";
+}
+
 // src/lib/cli.ts
 var USAGE = `Usage: wizard [workflow-id] [options]
        wizard playbook [playbook-slug] [options]
@@ -6721,13 +7124,6 @@ var playbookWorkflow = {
       outputSchema: selectPlaybookSchema,
       run: (ctx) => selectPlaybookStep(ctx, getPlaybookSlugArg())
     }),
-    defineStep({
-      id: "confirm-playbook",
-      title: "Confirm selections",
-      outputSchema: confirmPlaybookSchema,
-      visible: false,
-      run: (ctx) => confirmPlaybookStep(ctx)
-    }),
     defineStep({
       id: "select-index",
       title: "Select index",
@@ -6742,6 +7138,12 @@ var playbookWorkflow = {
       visible: false,
       tips: ["apps-and-indices", "records-are-json", "speed"],
       run: (ctx) => confirmIndexStep(ctx)
+    }),
+    defineStep({
+      id: "data-assessment",
+      title: "Assess index data",
+      outputSchema: playbookExecutionSchema,
+      run: (ctx) => dataAssessmentStep(ctx)
     })
   ]
 };
@@ -6759,7 +7161,19 @@ function getWorkflow(id) {
 import { dirname as dirname6, join as join12 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { useState as useState10 } from "react";
-import { Box as Box11, Spacer, Text as Text12, useInput as useInput6, useWindowSize as useWindowSize5 } from "ink";
+import { Box as Box12, Spacer, Text as Text13, useInput as useInput6, useWindowSize as useWindowSize6 } from "ink";
+
+// src/ui/ResizeNotice.tsx
+import { Box as Box11, Text as Text12, useWindowSize as useWindowSize5 } from "ink";
+import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
+function ResizeNotice() {
+  const { columns, rows } = useWindowSize5();
+  if (rows >= MIN_ROWS && columns >= MIN_COLUMNS) return null;
+  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx10(Text12, { color: COLORS.badge, children: `Terminal is ${columns}x${rows}. Recommended size is ${MIN_COLUMNS}x${MIN_ROWS}.` }),
+    /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: "Enlarge the pane for the full layout." })
+  ] });
+}
 
 // src/ui/copy/welcome.ts
 var sidebarItems = [
@@ -6787,7 +7201,7 @@ var sidebarItems = [
 
 // src/ui/Welcome.tsx
 import Image, { TerminalInfoContext, defaultTerminalInfo } from "ink-picture";
-import { jsx as jsx10, jsxs as jsxs11 } from "react/jsx-runtime";
+import { jsx as jsx11, jsxs as jsxs12 } from "react/jsx-runtime";
 var IMAGE_PATH = join12(dirname6(fileURLToPath2(import.meta.url)), "algolia.png");
 var TERMINAL_INFO = {
   ...defaultTerminalInfo,
@@ -6798,21 +7212,23 @@ function SidebarItem({
   title,
   description
 }) {
-  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs11(Box11, { gap: 1, children: [
-      /* @__PURE__ */ jsx10(Text12, { color: COLORS.success, children: "\u2192" }),
-      /* @__PURE__ */ jsx10(Text12, { color: COLORS.strong, bold: true, children: title })
+  return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs12(Box12, { gap: 1, children: [
+      /* @__PURE__ */ jsx11(Text13, { color: COLORS.success, children: "\u2192" }),
+      /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: title })
     ] }),
-    /* @__PURE__ */ jsxs11(Box11, { flexDirection: "row", gap: 2, children: [
-      /* @__PURE__ */ jsx10(Spacer, {}),
-      /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: description })
+    /* @__PURE__ */ jsxs12(Box12, { flexDirection: "row", gap: 2, children: [
+      /* @__PURE__ */ jsx11(Spacer, {}),
+      /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: description })
     ] })
   ] });
 }
 function Welcome() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const openLearnMore = useWizard((s) => s.openLearnMore);
-  const { rows } = useWindowSize5();
+  const { columns, rows } = useWindowSize6();
+  const showSidebar = !isCompactTerminal(columns, rows) && columns > SIDEBAR_MIN_COLUMNS;
+  const showLogo = showSidebar && rows >= MIN_ROWS && columns >= MIN_COLUMNS;
   const actions = [
     { label: "start wizard", run: confirmStart },
     { label: "learn more", run: openLearnMore }
@@ -6838,19 +7254,20 @@ function Welcome() {
     }
   };
   let layout = scales["large"];
-  if (rows < 30) {
+  if (rows < MIN_ROWS) {
     layout = scales["small"];
   }
-  return /* @__PURE__ */ jsxs11(Box11, { flexDirection: "row", justifyContent: "space-between", width: "100%", children: [
-    /* @__PURE__ */ jsx10(
-      Box11,
+  return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "row", justifyContent: "space-between", width: "100%", children: [
+    /* @__PURE__ */ jsx11(
+      Box12,
       {
         paddingY: layout.main.padding.y,
         paddingX: layout.main.padding.x,
         flexDirection: "column",
         justifyContent: "center",
-        children: /* @__PURE__ */ jsxs11(Box11, { flexDirection: "column", gap: 2, children: [
-          /* @__PURE__ */ jsx10(TerminalInfoContext.Provider, { value: TERMINAL_INFO, children: /* @__PURE__ */ jsx10(
+        children: /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", gap: 2, children: [
+          /* @__PURE__ */ jsx11(ResizeNotice, {}),
+          showLogo && /* @__PURE__ */ jsx11(TerminalInfoContext.Provider, { value: TERMINAL_INFO, children: /* @__PURE__ */ jsx11(
             Image,
             {
               src: IMAGE_PATH,
@@ -6861,8 +7278,8 @@ function Welcome() {
               protocol: "halfBlock"
             }
           ) }),
-          /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: "\u2726 From zero \u2192 working search in ~10 minutes" }),
-          /* @__PURE__ */ jsx10(Box11, { flexDirection: "column", children: actions.map((action, i) => /* @__PURE__ */ jsx10(
+          /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "\u2726 From zero \u2192 working search in ~10 minutes" }),
+          /* @__PURE__ */ jsx11(Box12, { flexDirection: "column", children: actions.map((action, i) => /* @__PURE__ */ jsx11(
             SelectRow,
             {
               highlighted: i === index,
@@ -6871,21 +7288,21 @@ function Welcome() {
             },
             action.label
           )) }),
-          /* @__PURE__ */ jsxs11(Box11, { gap: 2, children: [
-            /* @__PURE__ */ jsxs11(Text12, { children: [
-              /* @__PURE__ */ jsx10(Text12, { color: COLORS.primary, children: "[\u2191] [\u2193]" }),
-              /* @__PURE__ */ jsx10(Text12, { color: COLORS.dim, children: " move" })
+          /* @__PURE__ */ jsxs12(Box12, { gap: 2, children: [
+            /* @__PURE__ */ jsxs12(Text13, { children: [
+              /* @__PURE__ */ jsx11(Text13, { color: COLORS.primary, children: "[\u2191] [\u2193]" }),
+              /* @__PURE__ */ jsx11(Text13, { color: COLORS.dim, children: " move" })
             ] }),
-            /* @__PURE__ */ jsxs11(Text12, { children: [
-              /* @__PURE__ */ jsx10(Text12, { color: COLORS.primary, children: "[enter]" }),
-              /* @__PURE__ */ jsx10(Text12, { color: COLORS.dim, children: " confirm" })
+            /* @__PURE__ */ jsxs12(Text13, { children: [
+              /* @__PURE__ */ jsx11(Text13, { color: COLORS.primary, children: "[enter]" }),
+              /* @__PURE__ */ jsx11(Text13, { color: COLORS.dim, children: " confirm" })
             ] })
           ] })
         ] })
       }
     ),
-    /* @__PURE__ */ jsxs11(
-      Box11,
+    showSidebar && /* @__PURE__ */ jsxs12(
+      Box12,
       {
         backgroundColor: COLORS.bg.sidebar,
         width: 40,
@@ -6895,8 +7312,8 @@ function Welcome() {
         flexDirection: "column",
         justifyContent: "center",
         children: [
-          /* @__PURE__ */ jsx10(Text12, { color: COLORS.muted, children: "WHAT THIS WIZARD WILL DO" }),
-          sidebarItems.map((i, idx) => /* @__PURE__ */ jsx10(SidebarItem, { title: i.title, description: i.description }, idx))
+          /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "WHAT THIS WIZARD WILL DO" }),
+          sidebarItems.map((i, idx) => /* @__PURE__ */ jsx11(SidebarItem, { title: i.title, description: i.description }, idx))
         ]
       }
     )
@@ -6904,8 +7321,7 @@ function Welcome() {
 }
 
 // src/ui/LearnMore.tsx
-import { Fragment } from "react";
-import { Box as Box12, Text as Text13, useInput as useInput7, useWindowSize as useWindowSize6 } from "ink";
+import { Box as Box13, Text as Text14, useInput as useInput7, useWindowSize as useWindowSize7 } from "ink";
 
 // src/ui/copy/learn-more.ts
 var accessIntro = "Everything runs locally on your machine. Nothing is written or sent without an explicit yes from you.";
@@ -6947,7 +7363,7 @@ var policyLinks = [
 ];
 
 // src/ui/LearnMore.tsx
-import { jsx as jsx11, jsxs as jsxs12 } from "react/jsx-runtime";
+import { jsx as jsx12, jsxs as jsxs13 } from "react/jsx-runtime";
 var TAG_COLORS = {
   READ: COLORS.success,
   WRITE: COLORS.badge,
@@ -6958,92 +7374,156 @@ var TAG_COLORS = {
 var TAG_COLUMN_WIDTH = 10;
 var PADDING_X = 6;
 var NEVER_BOX_PAD_X = 2;
-function NeverLine({
-  width,
-  segments = []
-}) {
+var BLANK3 = { parts: [{ text: " ", color: COLORS.dim }] };
+function neverRow(width, segments = []) {
   const used = segments.reduce((n, s) => n + s.text.length, 0);
   const rightPad = Math.max(0, width - 2 - NEVER_BOX_PAD_X - used);
-  return /* @__PURE__ */ jsxs12(Text13, { color: COLORS.primary, children: [
-    /* @__PURE__ */ jsx11(Text13, { color: COLORS.danger, children: "\u2502" }),
-    " ".repeat(NEVER_BOX_PAD_X),
-    segments.map((s, i) => /* @__PURE__ */ jsx11(Text13, { color: s.color, bold: s.bold, children: s.text }, i)),
-    " ".repeat(rightPad),
-    /* @__PURE__ */ jsx11(Text13, { color: COLORS.danger, children: "\u2502" })
-  ] });
+  return {
+    parts: [
+      { text: "\u2502", color: COLORS.danger },
+      { text: " ".repeat(NEVER_BOX_PAD_X), color: COLORS.primary },
+      ...segments.map((s) => ({
+        text: s.text,
+        color: s.color ?? COLORS.primary,
+        bold: s.bold
+      })),
+      { text: " ".repeat(rightPad), color: COLORS.primary },
+      { text: "\u2502", color: COLORS.danger }
+    ]
+  };
+}
+function buildLearnMoreRows(contentWidth) {
+  const width = Math.max(contentWidth, 1);
+  const rows = [];
+  rows.push({
+    parts: [
+      {
+        text: "What algolia wizard accesses",
+        color: COLORS.strong,
+        bold: true
+      }
+    ]
+  });
+  for (const line of wrapText(accessIntro, width)) {
+    rows.push({ parts: [{ text: line, color: COLORS.muted }] });
+  }
+  for (const item of accessItems) {
+    rows.push({
+      parts: [{ text: "\u2500".repeat(width), color: COLORS.border }]
+    });
+    rows.push(BLANK3);
+    const tag = `[${item.tag}]`.padEnd(TAG_COLUMN_WIDTH);
+    const bodyWidth = Math.max(width - TAG_COLUMN_WIDTH, 1);
+    const body = wrapText(`${item.title}: ${item.description}`, bodyWidth);
+    body.forEach((line, i) => {
+      const titleEnd = i === 0 ? item.title.length : 0;
+      rows.push({
+        parts: [
+          {
+            text: i === 0 ? tag : " ".repeat(TAG_COLUMN_WIDTH),
+            color: TAG_COLORS[item.tag],
+            bold: i === 0
+          },
+          {
+            text: line.slice(0, titleEnd),
+            color: COLORS.strong,
+            bold: true
+          },
+          { text: line.slice(titleEnd), color: COLORS.muted }
+        ]
+      });
+    });
+  }
+  const inner = Math.max(width - 2, 0);
+  rows.push(BLANK3);
+  rows.push({
+    parts: [{ text: `\u256D${"\u2500".repeat(inner)}\u256E`, color: COLORS.danger }]
+  });
+  rows.push(neverRow(width));
+  rows.push(
+    neverRow(width, [{ text: "I NEVER", color: COLORS.danger, bold: true }])
+  );
+  for (const item of neverItems) {
+    rows.push(neverRow(width));
+    const marker = "\u2715 ";
+    const bodyWidth = Math.max(width - 2 - NEVER_BOX_PAD_X - marker.length, 1);
+    const lines = wrapText(item, bodyWidth);
+    lines.forEach((line, i) => {
+      rows.push(
+        neverRow(
+          width,
+          i === 0 ? [
+            { text: "\u2715", color: COLORS.danger },
+            { text: " " },
+            { text: line, color: COLORS.primary }
+          ] : [
+            { text: " ".repeat(marker.length) },
+            { text: line, color: COLORS.primary }
+          ]
+        )
+      );
+    });
+  }
+  rows.push(neverRow(width));
+  rows.push({
+    parts: [{ text: `\u2570${"\u2500".repeat(inner)}\u256F`, color: COLORS.danger }]
+  });
+  rows.push(BLANK3);
+  for (const link of policyLinks) {
+    const prefix = `${link.label}: `;
+    const urlLines = wrapText(link.url, Math.max(width - prefix.length, 1));
+    urlLines.forEach((line, i) => {
+      rows.push({
+        parts: i === 0 ? [
+          { text: prefix, color: COLORS.strong, bold: true },
+          { text: line, color: COLORS.accent }
+        ] : [{ text: `${" ".repeat(prefix.length)}${line}`, color: COLORS.accent }]
+      });
+    });
+  }
+  return rows;
 }
 function LearnMore() {
   const confirmStart = useWizard((s) => s.confirmStart);
   const backToHome = useWizard((s) => s.backToHome);
-  const { columns } = useWindowSize6();
-  const dividerWidth = Math.max(0, columns - PADDING_X * 2);
-  useInput7((_input, key) => {
+  const { columns } = useWindowSize7();
+  const contentWidth = Math.max(columns - PADDING_X * 2, 1);
+  const rows = buildLearnMoreRows(contentWidth);
+  const scroll = useScrollWindow({ itemCount: rows.length });
+  const scrollable = scroll.maxOffset > 0;
+  useInput7((input, key) => {
     if (key.escape) backToHome();
     else if (key.return) confirmStart();
+    else if (scrollable && (input === "k" || key.upArrow)) scroll.scrollBy(-1);
+    else if (scrollable && (input === "j" || key.downArrow)) scroll.scrollBy(1);
   });
-  return /* @__PURE__ */ jsxs12(
-    Box12,
+  const visible = rows.slice(scroll.offset, scroll.offset + scroll.capacity);
+  return /* @__PURE__ */ jsxs13(
+    Box13,
     {
       flexDirection: "column",
       paddingX: PADDING_X,
       paddingY: 2,
       width: "100%",
-      gap: 1,
+      flexGrow: 1,
       children: [
-        /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: "What algolia wizard accesses" }),
-        /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: accessIntro }),
-        /* @__PURE__ */ jsx11(Box12, { flexDirection: "column", children: accessItems.map((item) => /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", marginTop: 1, children: [
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.border, children: "\u2500".repeat(dividerWidth) }),
-          /* @__PURE__ */ jsxs12(Box12, { flexDirection: "row", gap: 1, marginTop: 1, children: [
-            /* @__PURE__ */ jsx11(Box12, { width: TAG_COLUMN_WIDTH, flexShrink: 0, children: /* @__PURE__ */ jsx11(Text13, { color: TAG_COLORS[item.tag], bold: true, children: `[${item.tag}]` }) }),
-            /* @__PURE__ */ jsx11(Box12, { flexDirection: "column", children: /* @__PURE__ */ jsxs12(Text13, { color: COLORS.primary, children: [
-              /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: item.title }),
-              /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: ` \u2014 ${item.description}` })
-            ] }) })
-          ] })
-        ] }, item.tag)) }),
-        /* @__PURE__ */ jsxs12(Box12, { marginTop: 1, flexDirection: "column", children: [
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.danger, children: `\u256D${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256E` }),
-          /* @__PURE__ */ jsx11(NeverLine, { width: dividerWidth }),
-          /* @__PURE__ */ jsx11(
-            NeverLine,
-            {
-              width: dividerWidth,
-              segments: [{ text: "I NEVER", color: COLORS.danger, bold: true }]
-            }
-          ),
-          neverItems.map((item) => /* @__PURE__ */ jsxs12(Fragment, { children: [
-            /* @__PURE__ */ jsx11(NeverLine, { width: dividerWidth }),
-            /* @__PURE__ */ jsx11(
-              NeverLine,
-              {
-                width: dividerWidth,
-                segments: [
-                  { text: "\u2715", color: COLORS.danger },
-                  { text: " " },
-                  { text: item, color: COLORS.primary }
-                ]
-              }
-            )
-          ] }, item)),
-          /* @__PURE__ */ jsx11(NeverLine, { width: dividerWidth }),
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.danger, children: `\u2570${"\u2500".repeat(Math.max(0, dividerWidth - 2))}\u256F` })
+        /* @__PURE__ */ jsx12(ResizeNotice, {}),
+        /* @__PURE__ */ jsx12(ScrollView, { scroll, children: visible.map((row, i) => /* @__PURE__ */ jsx12(Text14, { wrap: "truncate", children: row.parts.map((part, j) => /* @__PURE__ */ jsx12(Text14, { color: part.color, bold: part.bold, children: part.text }, j)) }, `learn-more-${scroll.offset}-${i}`)) }),
+        scrollable && /* @__PURE__ */ jsxs13(Text14, { children: [
+          /* @__PURE__ */ jsx12(Text14, { color: COLORS.primary, children: "[j] [k]" }),
+          /* @__PURE__ */ jsx12(Text14, { color: COLORS.dim, children: " scroll" })
         ] }),
-        /* @__PURE__ */ jsx11(Box12, { marginTop: 1, flexDirection: "column", children: policyLinks.map((link) => /* @__PURE__ */ jsxs12(Box12, { flexDirection: "row", gap: 1, children: [
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.strong, bold: true, children: `${link.label}:` }),
-          /* @__PURE__ */ jsx11(Text13, { color: COLORS.accent, children: link.url })
-        ] }, link.label)) }),
-        /* @__PURE__ */ jsxs12(Box12, { marginTop: 1, flexDirection: "row", gap: 3, children: [
-          /* @__PURE__ */ jsxs12(Box12, { flexDirection: "row", gap: 1, children: [
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "[" }),
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.primary, children: "esc" }),
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "] back" })
+        /* @__PURE__ */ jsxs13(Box13, { flexDirection: "row", gap: 3, children: [
+          /* @__PURE__ */ jsxs13(Box13, { flexDirection: "row", gap: 1, children: [
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: "[" }),
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.primary, children: "esc" }),
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: "] back" })
           ] }),
-          /* @__PURE__ */ jsxs12(Box12, { flexDirection: "row", gap: 1, children: [
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "[" }),
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.primary, children: "enter" }),
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.muted, children: "]" }),
-            /* @__PURE__ */ jsx11(Text13, { color: COLORS.success, bold: true, children: "start wizard" })
+          /* @__PURE__ */ jsxs13(Box13, { flexDirection: "row", gap: 1, children: [
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: "[" }),
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.primary, children: "enter" }),
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.muted, children: "]" }),
+            /* @__PURE__ */ jsx12(Text14, { color: COLORS.success, bold: true, children: "start wizard" })
           ] })
         ] })
       ]
@@ -7052,17 +7532,17 @@ function LearnMore() {
 }
 
 // src/ui/Sidebar.tsx
-import { Box as Box15, Text as Text16 } from "ink";
+import { Box as Box16, Text as Text17 } from "ink";
 
 // src/ui/Steps.tsx
-import { Box as Box13, Text as Text14 } from "ink";
+import { Box as Box14, Text as Text15 } from "ink";
 import Spinner2 from "ink-spinner";
-import { jsx as jsx12, jsxs as jsxs13 } from "react/jsx-runtime";
+import { jsx as jsx13, jsxs as jsxs14 } from "react/jsx-runtime";
 function Steps() {
   const { steps } = useWizard();
   const visibleSteps = steps.filter(isStepVisible);
-  return /* @__PURE__ */ jsx12(Box13, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx12(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsxs13(Text14, { color: COLORS.status[s.status], children: [
-    s.status === "running" ? /* @__PURE__ */ jsx12(Spinner2, { type: "dots" }) : MARKER[s.status],
+  return /* @__PURE__ */ jsx13(Box14, { flexDirection: "column", gap: 1, children: visibleSteps.map((s) => /* @__PURE__ */ jsx13(Box14, { flexDirection: "column", children: /* @__PURE__ */ jsxs14(Text15, { color: COLORS.status[s.status], children: [
+    s.status === "running" ? /* @__PURE__ */ jsx13(Spinner2, { type: "dots" }) : MARKER[s.status],
     " ",
     s.title
   ] }) }, s.id)) });
@@ -7071,27 +7551,27 @@ function CurrentStep() {
   const { steps } = useWizard();
   const currentStep = steps.filter(isStepVisible).find((s) => s.status === "running");
   if (!currentStep) return null;
-  return /* @__PURE__ */ jsxs13(Text14, { color: COLORS.status.running, children: [
-    /* @__PURE__ */ jsx12(Spinner2, { type: "dots" }),
+  return /* @__PURE__ */ jsxs14(Text15, { color: COLORS.status.running, children: [
+    /* @__PURE__ */ jsx13(Spinner2, { type: "dots" }),
     " ",
     ` ${currentStep.title}`
   ] });
 }
 
 // src/ui/Progress.tsx
-import { Box as Box14, Text as Text15 } from "ink";
-import { jsx as jsx13, jsxs as jsxs14 } from "react/jsx-runtime";
+import { Box as Box15, Text as Text16 } from "ink";
+import { jsx as jsx14, jsxs as jsxs15 } from "react/jsx-runtime";
 function Progress() {
   const { steps, currentStepIndex } = useWizard();
   const visibleSteps = steps.filter(isStepVisible);
   if (visibleSteps.length === 0) return null;
   const visibleCountThroughCurrent = steps.slice(0, currentStepIndex + 1).filter(isStepVisible).length;
   const activeStepNumber = Math.max(1, visibleCountThroughCurrent);
-  return /* @__PURE__ */ jsxs14(Box14, { flexDirection: "row", gap: 1, children: [
-    /* @__PURE__ */ jsx13(Text15, { color: COLORS.muted, children: "STEP" }),
-    /* @__PURE__ */ jsx13(Text15, { color: COLORS.strong, bold: true, children: activeStepNumber }),
-    /* @__PURE__ */ jsx13(Text15, { color: COLORS.strong, bold: true, children: "/" }),
-    /* @__PURE__ */ jsx13(Text15, { color: COLORS.strong, bold: true, children: visibleSteps.length })
+  return /* @__PURE__ */ jsxs15(Box15, { flexDirection: "row", gap: 1, children: [
+    /* @__PURE__ */ jsx14(Text16, { color: COLORS.muted, children: "STEP" }),
+    /* @__PURE__ */ jsx14(Text16, { color: COLORS.strong, bold: true, children: activeStepNumber }),
+    /* @__PURE__ */ jsx14(Text16, { color: COLORS.strong, bold: true, children: "/" }),
+    /* @__PURE__ */ jsx14(Text16, { color: COLORS.strong, bold: true, children: visibleSteps.length })
   ] });
 }
 
@@ -7102,10 +7582,10 @@ var sidebarCommands = [
 ];
 
 // src/ui/Sidebar.tsx
-import { jsx as jsx14, jsxs as jsxs15 } from "react/jsx-runtime";
+import { jsx as jsx15, jsxs as jsxs16 } from "react/jsx-runtime";
 function Sidebar() {
-  return /* @__PURE__ */ jsxs15(
-    Box15,
+  return /* @__PURE__ */ jsxs16(
+    Box16,
     {
       backgroundColor: "#14171E",
       width: 30,
@@ -7114,16 +7594,16 @@ function Sidebar() {
       flexDirection: "column",
       justifyContent: "space-between",
       children: [
-        /* @__PURE__ */ jsxs15(Box15, { flexDirection: "column", gap: 1, children: [
-          /* @__PURE__ */ jsx14(Text16, { color: COLORS.muted, children: "PROGRESS" }),
-          /* @__PURE__ */ jsx14(Steps, {})
+        /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", gap: 1, children: [
+          /* @__PURE__ */ jsx15(Text17, { color: COLORS.muted, children: "PROGRESS" }),
+          /* @__PURE__ */ jsx15(Steps, {})
         ] }),
-        /* @__PURE__ */ jsxs15(Box15, { flexDirection: "column", gap: 1, children: [
-          /* @__PURE__ */ jsx14(Progress, {}),
-          /* @__PURE__ */ jsx14(Box15, { flexDirection: "column", children: sidebarCommands.map((c) => {
-            return /* @__PURE__ */ jsxs15(Box15, { flexDirection: "row", gap: 1, children: [
-              /* @__PURE__ */ jsx14(Text16, { color: COLORS.primary, children: `[${c.keyHint}]` }),
-              /* @__PURE__ */ jsx14(Text16, { color: COLORS.muted, children: c.description })
+        /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", gap: 1, children: [
+          /* @__PURE__ */ jsx15(Progress, {}),
+          /* @__PURE__ */ jsx15(Box16, { flexDirection: "column", children: sidebarCommands.map((c) => {
+            return /* @__PURE__ */ jsxs16(Box16, { flexDirection: "row", gap: 1, children: [
+              /* @__PURE__ */ jsx15(Text17, { color: COLORS.primary, children: `[${c.keyHint}]` }),
+              /* @__PURE__ */ jsx15(Text17, { color: COLORS.muted, children: c.description })
             ] }, c.keyHint);
           }) })
         ] })
@@ -7133,12 +7613,12 @@ function Sidebar() {
 }
 
 // src/ui/Ribbon.tsx
-import { Box as Box16, Text as Text17 } from "ink";
-import { jsx as jsx15, jsxs as jsxs16 } from "react/jsx-runtime";
+import { Box as Box17, Text as Text18 } from "ink";
+import { jsx as jsx16, jsxs as jsxs17 } from "react/jsx-runtime";
 function Ribbon() {
   const firstCommand = sidebarCommands[0];
-  return /* @__PURE__ */ jsxs16(
-    Box16,
+  return /* @__PURE__ */ jsxs17(
+    Box17,
     {
       backgroundColor: "#14171E",
       flexDirection: "row",
@@ -7146,11 +7626,11 @@ function Ribbon() {
       paddingX: 2,
       paddingY: 1,
       children: [
-        /* @__PURE__ */ jsx15(Progress, {}),
-        /* @__PURE__ */ jsx15(CurrentStep, {}),
-        /* @__PURE__ */ jsxs16(Box16, { flexDirection: "row", gap: 1, children: [
-          /* @__PURE__ */ jsx15(Text17, { color: COLORS.primary, children: `[${firstCommand.keyHint}]` }),
-          /* @__PURE__ */ jsx15(Text17, { color: COLORS.muted, children: firstCommand.description })
+        /* @__PURE__ */ jsx16(Progress, {}),
+        /* @__PURE__ */ jsx16(CurrentStep, {}),
+        /* @__PURE__ */ jsxs17(Box17, { flexDirection: "row", gap: 1, children: [
+          /* @__PURE__ */ jsx16(Text18, { color: COLORS.primary, children: `[${firstCommand.keyHint}]` }),
+          /* @__PURE__ */ jsx16(Text18, { color: COLORS.muted, children: firstCommand.description })
         ] })
       ]
     }
@@ -7161,8 +7641,8 @@ function Ribbon() {
 import { useState as useState12 } from "react";
 
 // src/ui/Logs.tsx
-import { Box as Box17, Text as Text18, useInput as useInput8 } from "ink";
-import { jsx as jsx16, jsxs as jsxs17 } from "react/jsx-runtime";
+import { Box as Box18, Text as Text19, useInput as useInput8 } from "ink";
+import { jsx as jsx17, jsxs as jsxs18 } from "react/jsx-runtime";
 var KIND_COLOR = {
   tool: COLORS.primary,
   prompt: COLORS.badge
@@ -7198,9 +7678,9 @@ function Logs() {
     else if (input === "j" || key.downArrow) scroll.scrollBy(1);
   });
   const visible = logs.slice(scroll.offset, scroll.offset + scroll.capacity);
-  return /* @__PURE__ */ jsxs17(Box17, { flexDirection: "column", paddingX: 4, paddingY: 2, flexGrow: 1, children: [
-    logs.length === 0 && /* @__PURE__ */ jsx16(Text18, { color: COLORS.dim, children: "No logs yet." }),
-    /* @__PURE__ */ jsx16(ScrollView, { scroll, children: visible.map((entry) => {
+  return /* @__PURE__ */ jsxs18(Box18, { flexDirection: "column", paddingX: 4, paddingY: 2, flexGrow: 1, children: [
+    logs.length === 0 && /* @__PURE__ */ jsx17(Text19, { color: COLORS.dim, children: "No logs yet." }),
+    /* @__PURE__ */ jsx17(ScrollView, { scroll, children: visible.map((entry) => {
       const timestamp = `[${formatTimestamp(entry.startedAt)}]`;
       const durationText = entry.kind === "tool" && entry.durationMs !== void 0 ? `${entry.durationMs}ms` : "";
       const rawPreview = rawInputText(entry.input);
@@ -7210,28 +7690,28 @@ function Logs() {
       const name = truncate3(entry.name, budget);
       budget -= name.length;
       const preview = rawPreview ? truncate3(rawPreview, budget) : "";
-      return /* @__PURE__ */ jsxs17(Box17, { flexDirection: "row", gap: ROW_GAP, children: [
-        /* @__PURE__ */ jsx16(Text18, { color: COLORS.dim, children: timestamp }),
-        /* @__PURE__ */ jsx16(Text18, { color: logNameColor(entry), wrap: "truncate", children: name }),
-        preview && /* @__PURE__ */ jsx16(Text18, { color: COLORS.dim, wrap: "truncate", children: preview }),
-        durationText && /* @__PURE__ */ jsx16(Text18, { color: COLORS.dim, children: durationText })
+      return /* @__PURE__ */ jsxs18(Box18, { flexDirection: "row", gap: ROW_GAP, children: [
+        /* @__PURE__ */ jsx17(Text19, { color: COLORS.dim, children: timestamp }),
+        /* @__PURE__ */ jsx17(Text19, { color: logNameColor(entry), wrap: "truncate", children: name }),
+        preview && /* @__PURE__ */ jsx17(Text19, { color: COLORS.dim, wrap: "truncate", children: preview }),
+        durationText && /* @__PURE__ */ jsx17(Text19, { color: COLORS.dim, children: durationText })
       ] }, entry.id);
     }) }),
-    /* @__PURE__ */ jsxs17(Text18, { children: [
-      /* @__PURE__ */ jsx16(Text18, { color: COLORS.primary, children: "[j] [k]" }),
-      /* @__PURE__ */ jsx16(Text18, { color: COLORS.dim, children: " scroll" })
+    /* @__PURE__ */ jsxs18(Text19, { children: [
+      /* @__PURE__ */ jsx17(Text19, { color: COLORS.primary, children: "[j] [k]" }),
+      /* @__PURE__ */ jsx17(Text19, { color: COLORS.dim, children: " scroll" })
     ] })
   ] });
 }
 
 // src/ui/Tips.tsx
 import { useEffect as useEffect3, useRef as useRef4, useState as useState11 } from "react";
-import { Box as Box19, Text as Text20 } from "ink";
+import { Box as Box20, Text as Text21 } from "ink";
 import terminalLink from "terminal-link";
 
 // src/ui/Code.tsx
-import { Box as Box18, Text as Text19 } from "ink";
-import { jsx as jsx17 } from "react/jsx-runtime";
+import { Box as Box19, Text as Text20 } from "ink";
+import { jsx as jsx18 } from "react/jsx-runtime";
 var TOKEN_RE = /("(?:\\.|[^"\\])*"|\btrue\b|\bfalse\b|\bnull\b|-?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?|[{}[\]:,])/g;
 function highlightJson(json) {
   const parts = json.split(TOKEN_RE);
@@ -7240,22 +7720,22 @@ function highlightJson(json) {
     if (part[0] === '"') {
       const next = parts.slice(i + 1).find((p) => p.trim());
       const isKey = next?.trimStart().startsWith(":");
-      return /* @__PURE__ */ jsx17(Text19, { color: isKey ? "cyan" : "green", children: part }, i);
+      return /* @__PURE__ */ jsx18(Text20, { color: isKey ? "cyan" : "green", children: part }, i);
     }
     if (part === "true" || part === "false" || part === "null") {
-      return /* @__PURE__ */ jsx17(Text19, { color: "magenta", children: part }, i);
+      return /* @__PURE__ */ jsx18(Text20, { color: "magenta", children: part }, i);
     }
     if (/^-?\d/.test(part)) {
-      return /* @__PURE__ */ jsx17(Text19, { color: "yellow", children: part }, i);
+      return /* @__PURE__ */ jsx18(Text20, { color: "yellow", children: part }, i);
     }
     if (/^[{}[\]:,]$/.test(part)) {
-      return /* @__PURE__ */ jsx17(Text19, { color: COLORS.dim, children: part }, i);
+      return /* @__PURE__ */ jsx18(Text20, { color: COLORS.dim, children: part }, i);
     }
-    return /* @__PURE__ */ jsx17(Text19, { children: part }, i);
+    return /* @__PURE__ */ jsx18(Text20, { children: part }, i);
   });
 }
 function Code({ children }) {
-  return /* @__PURE__ */ jsx17(Box18, { children: /* @__PURE__ */ jsx17(Text19, { children: highlightJson(children) }) });
+  return /* @__PURE__ */ jsx18(Box19, { children: /* @__PURE__ */ jsx18(Text20, { children: highlightJson(children) }) });
 }
 
 // src/ui/copy/tips.ts
@@ -7469,26 +7949,26 @@ function tipsByIds(ids) {
 }
 
 // src/ui/Tips.tsx
-import { jsx as jsx18, jsxs as jsxs18 } from "react/jsx-runtime";
+import { jsx as jsx19, jsxs as jsxs19 } from "react/jsx-runtime";
 var TICK_MS = 16;
 var CHUNK_HOLD_MS = 2e3;
 var HOLD_MS = 12e3;
 function TipTitle({ children }) {
-  return /* @__PURE__ */ jsxs18(Box19, { gap: 1, children: [
-    /* @__PURE__ */ jsx18(Text20, { color: "cyan", children: "\u2726" }),
-    /* @__PURE__ */ jsx18(Text20, { color: "white", bold: true, children })
+  return /* @__PURE__ */ jsxs19(Box20, { gap: 1, children: [
+    /* @__PURE__ */ jsx19(Text21, { color: "cyan", children: "\u2726" }),
+    /* @__PURE__ */ jsx19(Text21, { color: "white", bold: true, children })
   ] });
 }
 function InlineSegment({ segment }) {
   switch (segment.type) {
     case "highlight":
-      return /* @__PURE__ */ jsx18(Text20, { color: COLORS.success, children: segment.value });
+      return /* @__PURE__ */ jsx19(Text21, { color: COLORS.success, children: segment.value });
     case "link":
-      return /* @__PURE__ */ jsx18(Text20, { color: "cyan", underline: true, children: segment.href ? terminalLink(segment.value, segment.href) : segment.value });
+      return /* @__PURE__ */ jsx19(Text21, { color: "cyan", underline: true, children: segment.href ? terminalLink(segment.value, segment.href) : segment.value });
     case "codeword":
-      return /* @__PURE__ */ jsx18(Text20, { color: COLORS.highlight.fg, backgroundColor: COLORS.highlight.bg, children: segment.value });
+      return /* @__PURE__ */ jsx19(Text21, { color: COLORS.highlight.fg, backgroundColor: COLORS.highlight.bg, children: segment.value });
     default:
-      return /* @__PURE__ */ jsx18(Text20, { color: COLORS.muted, children: segment.value });
+      return /* @__PURE__ */ jsx19(Text21, { color: COLORS.muted, children: segment.value });
   }
 }
 function TipContent({
@@ -7522,10 +8002,10 @@ function TipContent({
       blocks.push({ type: "inline", segments: [segment] });
     }
   }
-  return /* @__PURE__ */ jsx18(Box19, { flexDirection: "column", marginLeft: 2, gap: 1, children: blocks.map(
-    (block, i) => block.type === "code" ? /* @__PURE__ */ jsx18(Code, { children: block.segment.value }, i) : /* @__PURE__ */ jsx18(Text20, { children: block.segments.map((segment, j) => /* @__PURE__ */ jsxs18(Text20, { children: [
+  return /* @__PURE__ */ jsx19(Box20, { flexDirection: "column", marginLeft: 2, gap: 1, children: blocks.map(
+    (block, i) => block.type === "code" ? /* @__PURE__ */ jsx19(Code, { children: block.segment.value }, i) : /* @__PURE__ */ jsx19(Text21, { children: block.segments.map((segment, j) => /* @__PURE__ */ jsxs19(Text21, { children: [
       j > 0 && " ",
-      /* @__PURE__ */ jsx18(InlineSegment, { segment })
+      /* @__PURE__ */ jsx19(InlineSegment, { segment })
     ] }, j)) }, i)
   ) });
 }
@@ -7602,14 +8082,51 @@ function Tips({
   if (!tip) return null;
   const titleRevealed = tip.title.slice(0, revealed);
   const contentRevealed = Math.max(0, revealed - tip.title.length);
-  return /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", marginBottom: 1, gap: 1, children: [
-    /* @__PURE__ */ jsx18(TipTitle, { children: titleRevealed }),
-    /* @__PURE__ */ jsx18(TipContent, { chunks: tip.chunks, revealed: contentRevealed })
+  return /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", marginBottom: 1, gap: 1, children: [
+    /* @__PURE__ */ jsx19(TipTitle, { children: titleRevealed }),
+    /* @__PURE__ */ jsx19(TipContent, { chunks: tip.chunks, revealed: contentRevealed })
   ] });
 }
 
+// src/ui/useRepaintOnResize.ts
+import { useEffect as useEffect4 } from "react";
+import { useApp, useStdout } from "ink";
+var BEGIN_SYNC = "\x1B[?2026h";
+var END_SYNC = "\x1B[?2026l";
+var CLEAR_SCREEN_AND_SCROLLBACK = "\x1B[2J\x1B[3J\x1B[H";
+function useRepaintOnResize(debounceMs = 100) {
+  const { stdout } = useStdout();
+  const { suspendTerminal } = useApp();
+  useEffect4(() => {
+    if (!stdout.isTTY) return;
+    let timer;
+    let repaint = Promise.resolve();
+    const onResize = () => {
+      clearTimeout(timer);
+      timer = setTimeout(() => {
+        repaint = repaint.then(async () => {
+          stdout.write(BEGIN_SYNC);
+          try {
+            await suspendTerminal(() => {
+              stdout.write(CLEAR_SCREEN_AND_SCROLLBACK);
+            });
+          } finally {
+            stdout.write(END_SYNC);
+          }
+        }).catch(() => {
+        });
+      }, debounceMs);
+    };
+    stdout.on("resize", onResize);
+    return () => {
+      clearTimeout(timer);
+      stdout.off("resize", onResize);
+    };
+  }, [stdout, suspendTerminal, debounceMs]);
+}
+
 // src/ui/App.tsx
-import { jsx as jsx19, jsxs as jsxs19 } from "react/jsx-runtime";
+import { jsx as jsx20, jsxs as jsxs20 } from "react/jsx-runtime";
 function App() {
   const {
     phase,
@@ -7624,8 +8141,10 @@ function App() {
     loadingMessage,
     review: review2
   } = useWizard();
-  const { exit } = useApp();
-  const { columns, rows } = useWindowSize7();
+  const { exit } = useApp2();
+  const { columns, rows } = useWindowSize8();
+  useRepaintOnResize();
+  const compactRun = isCompactTerminal(columns, rows);
   const [showLogs, setShowLogs] = useState12(false);
   const [tipState, setTipState] = useState12("idle");
   const finished = phase === "done" || phase === "error";
@@ -7636,10 +8155,10 @@ function App() {
   const isAwaitingUserInput = phase === "awaitingInput" && !!inputReq;
   const isCommandApprovalPrompt = isAwaitingUserInput && inputReq?.promptType === "commandApproval";
   const promptPending = isAwaitingUserInput && !isCommandApprovalPrompt;
-  const holdForTip = stepHasTips && promptPending && tipState === "revealing";
-  const showTips = stepHasTips && (phase === "running" && currentStep?.status === "running" || isCommandApprovalPrompt || holdForTip);
+  const holdForTip = !compactRun && stepHasTips && promptPending && tipState === "revealing";
+  const showTips = !compactRun && stepHasTips && (phase === "running" && currentStep?.status === "running" && !loadingMessage && !settingUpAppId || isCommandApprovalPrompt);
   const showNoticesInMain = !stepHasTips;
-  const showNotices = (!isAwaitingUserInput || holdForTip) && !review2;
+  const showNotices = !compactRun && (!isAwaitingUserInput || holdForTip) && !review2;
   useInput9(
     (_input, key) => {
       if (key.return) {
@@ -7672,32 +8191,31 @@ function App() {
     }
   });
   const mainWindowVisible = phase === "authenticating" || phase === "preflight" || phase === "running" || phase === "awaitingInput" || phase === "error" || phase === "done";
-  const flexDirection = columns > 90 ? "row" : "column";
+  const flexDirection = columns > SIDEBAR_MIN_COLUMNS ? "row" : "column";
   const showSidebar = flexDirection === "row";
-  const scrollsPastViewport = phase === "idle" && homeScreen === "learnMore";
   return (
     /* Clamped to exactly the viewport: a taller frame makes Ink clear and repaint
-       the whole screen, and the scrolling throws off its cursor arithmetic —
-       flicker and leftover rows. */
-    /* @__PURE__ */ jsxs19(
-      Box20,
+       the whole screen, and the scrolling throws off its cursor arithmetic.
+       Flicker and leftover rows. */
+    /* @__PURE__ */ jsxs20(
+      Box21,
       {
         backgroundColor: COLORS.bg.main,
         flexDirection: "row",
         width: columns,
-        height: scrollsPastViewport ? void 0 : rows,
-        overflow: scrollsPastViewport ? "visible" : "hidden",
+        height: rows,
+        overflow: "hidden",
         children: [
-          mainWindowVisible && /* @__PURE__ */ jsxs19(
-            Box20,
+          mainWindowVisible && /* @__PURE__ */ jsxs20(
+            Box21,
             {
               flexDirection,
               width: "100%",
               maxHeight: rows,
               justifyContent: "space-between",
               children: [
-                showLogs ? /* @__PURE__ */ jsx19(Logs, {}) : /* @__PURE__ */ jsxs19(
-                  Box20,
+                showLogs ? /* @__PURE__ */ jsx20(Logs, {}) : /* @__PURE__ */ jsxs20(
+                  Box21,
                   {
                     flexDirection: "column",
                     paddingX: 4,
@@ -7706,35 +8224,35 @@ function App() {
                     flexGrow: 1,
                     gap: 1,
                     children: [
-                      /* @__PURE__ */ jsxs19(Box20, { flexGrow: 2, flexDirection: "column", children: [
-                        phase === "preflight" && !user && /* @__PURE__ */ jsx19(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs19(Text21, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx19(Spinner3, { type: "dots" }),
+                      /* @__PURE__ */ jsxs20(Box21, { flexGrow: 2, flexDirection: "column", children: [
+                        phase === "preflight" && !user && /* @__PURE__ */ jsx20(Box21, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs20(Text22, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx20(Spinner3, { type: "dots" }),
                           " Signing in to Algolia"
                         ] }) }),
-                        phase === "preflight" && user && /* @__PURE__ */ jsx19(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs19(Text21, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx19(Spinner3, { type: "dots" }),
+                        phase === "preflight" && user && /* @__PURE__ */ jsx20(Box21, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs20(Text22, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx20(Spinner3, { type: "dots" }),
                           " Getting things ready"
                         ] }) }),
-                        phase === "authenticating" && /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", marginBottom: 1, children: [
-                          /* @__PURE__ */ jsxs19(Text21, { color: COLORS.strong, bold: true, children: [
-                            /* @__PURE__ */ jsx19(Spinner3, { type: "dots" }),
+                        phase === "authenticating" && /* @__PURE__ */ jsxs20(Box21, { flexDirection: "column", marginBottom: 1, children: [
+                          /* @__PURE__ */ jsxs20(Text22, { color: COLORS.strong, bold: true, children: [
+                            /* @__PURE__ */ jsx20(Spinner3, { type: "dots" }),
                             " Signing in to Algolia"
                           ] }),
-                          /* @__PURE__ */ jsx19(Text21, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
+                          /* @__PURE__ */ jsx20(Text22, { color: COLORS.muted, children: "A browser window will open \u2014 complete sign-in there." })
                         ] }),
-                        settingUpAppId && /* @__PURE__ */ jsx19(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs19(Text21, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx19(Spinner3, { type: "dots" }),
+                        settingUpAppId && /* @__PURE__ */ jsx20(Box21, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs20(Text22, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx20(Spinner3, { type: "dots" }),
                           " Setting up Wizard using app",
                           " ",
                           settingUpAppId
                         ] }) }),
-                        phase === "running" && !settingUpAppId && loadingMessage && /* @__PURE__ */ jsx19(Box20, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs19(Text21, { color: COLORS.strong, bold: true, children: [
-                          /* @__PURE__ */ jsx19(Spinner3, { type: "dots" }),
+                        phase === "running" && !settingUpAppId && loadingMessage && /* @__PURE__ */ jsx20(Box21, { flexDirection: "column", marginBottom: 1, children: /* @__PURE__ */ jsxs20(Text22, { color: COLORS.strong, bold: true, children: [
+                          /* @__PURE__ */ jsx20(Spinner3, { type: "dots" }),
                           " ",
                           loadingMessage
                         ] }) }),
-                        /* @__PURE__ */ jsx19(CliOutput, {}),
-                        showTips && currentStep && /* @__PURE__ */ jsx19(
+                        /* @__PURE__ */ jsx20(CliOutput, {}),
+                        showTips && currentStep && /* @__PURE__ */ jsx20(
                           Tips,
                           {
                             stepId: currentStep.id,
@@ -7742,24 +8260,24 @@ function App() {
                             onRevealStateChange: setTipState
                           }
                         ),
-                        showNoticesInMain && showNotices && /* @__PURE__ */ jsx19(Notices, { showAll: true, border: false }),
-                        /* @__PURE__ */ jsx19(Review, {}),
-                        !showTips && /* @__PURE__ */ jsx19(PromptInput, {}),
-                        phase === "error" && error && /* @__PURE__ */ jsx19(Box20, { marginTop: 1, children: /* @__PURE__ */ jsxs19(Text21, { color: COLORS.status.error, children: [
+                        showNoticesInMain && showNotices && /* @__PURE__ */ jsx20(Notices, { showAll: true, border: false }),
+                        /* @__PURE__ */ jsx20(Review, {}),
+                        !showTips && /* @__PURE__ */ jsx20(PromptInput, {}),
+                        phase === "error" && error && /* @__PURE__ */ jsx20(Box21, { marginTop: 1, children: /* @__PURE__ */ jsxs20(Text22, { color: COLORS.status.error, children: [
                           "\u2716 ",
                           error
                         ] }) })
                       ] }),
-                      !showNoticesInMain && showNotices && /* @__PURE__ */ jsx19(Notices, {}),
-                      showTips && !holdForTip && /* @__PURE__ */ jsx19(PromptInput, {})
+                      !showNoticesInMain && showNotices && /* @__PURE__ */ jsx20(Notices, {}),
+                      showTips && !holdForTip && /* @__PURE__ */ jsx20(PromptInput, {})
                     ]
                   }
                 ),
-                showSidebar ? /* @__PURE__ */ jsx19(Sidebar, {}) : /* @__PURE__ */ jsx19(Ribbon, {})
+                showSidebar ? /* @__PURE__ */ jsx20(Sidebar, {}) : /* @__PURE__ */ jsx20(Ribbon, {})
               ]
             }
           ),
-          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx19(LearnMore, {}) : /* @__PURE__ */ jsx19(Welcome, {}))
+          phase === "idle" && (homeScreen === "learnMore" ? /* @__PURE__ */ jsx20(LearnMore, {}) : /* @__PURE__ */ jsx20(Welcome, {}))
         ]
       }
     )
@@ -7826,6 +8344,23 @@ var selectPlaybookIndex = {
   indexName: "wizard_seed_orders",
   sampleIndex: false
 };
+var dataAssessment = {
+  uuid: "seed-exec-uuid",
+  playbook_slug: selectPlaybook.slug,
+  application_id: "SEEDAPPID",
+  source_index_name: selectPlaybookIndex.indexName,
+  current_step: "assessment",
+  step_status: "done",
+  status_reason: null,
+  completed: true,
+  assessment_result: {
+    ready: true,
+    schema_comparison: [],
+    settings_recommendation: {}
+  },
+  settings_snapshot: null,
+  created_at: "2026-09-22T09:00:00.000Z"
+};
 var review = {
   summaryPoints: [
     "Ingested 25 generated Product records into wizard_seed_products.",
@@ -7847,9 +8382,9 @@ var SEEDS = {
   },
   playbook: {
     "select-playbook": selectPlaybook,
-    "confirm-playbook": void 0,
     "select-index": selectPlaybookIndex,
-    "confirm-index": null
+    "confirm-index": null,
+    "data-assessment": dataAssessment
   }
 };
 var SEED_ALGOLIA_STATE = {
@@ -7978,49 +8513,10 @@ async function resetProjectState() {
   return { dir, removed: targets };
 }
 
-// src/lib/terminalSize.ts
-var MIN_ROWS = 30;
-var MIN_COLUMNS = 100;
-async function requestTerminalSize(stdout = process.stdout, {
-  rows = MIN_ROWS,
-  columns = MIN_COLUMNS,
-  timeoutMs = 150,
-  settleMs = 120
-} = {}) {
-  if (!stdout.isTTY) return;
-  const currentRows = stdout.rows ?? 0;
-  const currentColumns = stdout.columns ?? 0;
-  if (currentRows >= rows && currentColumns >= columns) return;
-  stdout.write(
-    `\x1B[8;${Math.max(currentRows, rows)};${Math.max(currentColumns, columns)}t`
-  );
-  const resized = await waitForResize(stdout, timeoutMs);
-  if (!resized) return;
-  await delay(settleMs);
-  stdout.write("\x1B[2J\x1B[H");
-}
-function waitForResize(stdout, timeoutMs) {
-  return new Promise((resolve5) => {
-    const finish = (didResize) => () => {
-      clearTimeout(timer);
-      stdout.off("resize", onResize);
-      resolve5(didResize);
-    };
-    const onResize = finish(true);
-    const timer = setTimeout(finish(false), timeoutMs);
-    stdout.once("resize", onResize);
-  });
-}
-function delay(ms) {
-  return new Promise((resolve5) => {
-    setTimeout(resolve5, ms);
-  });
-}
-
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@algolia/wizard",
-  version: "0.75.0",
+  version: "0.77.0",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -8127,7 +8623,7 @@ async function checkVersion() {
 }
 
 // src/main.tsx
-import { jsx as jsx20 } from "react/jsx-runtime";
+import { jsx as jsx21 } from "react/jsx-runtime";
 var FAILURE_EXIT_CODE = 1;
 async function exitProcessWithError(store, instance, message) {
   store.setError(message);
@@ -8190,7 +8686,7 @@ ${formatStepList(workflow)}`);
 async function run(opts) {
   const { workflow, skipResumePrompt } = opts;
   const store = useWizard.getState();
-  const instance = render(/* @__PURE__ */ jsx20(App, {}), { incrementalRendering: true });
+  const instance = render(/* @__PURE__ */ jsx21(App, {}), { incrementalRendering: true });
   await store.waitForStart();
   store.syncSteps(
     workflow.steps.map((s) => ({